Šķîþ ţö ḿàîñ çöñţéñţ

Ţéŕḿš ƃüñđļé (.terms.json)

À ţéŕḿš ƃüñđļé îš ţĥé þöŕţàƃļé, ļöššļéšš šéŕîàļîžàţîöñ öƒ à þŕöĵéçţ'š ţéŕḿîñöļöĝý: ţĥé çöñçéþţš à þŕöĵéçţ ĥàš àĝŕééđ öñ, ţĥéîŕ ţéŕḿš þéŕ ļöçàļé, àñđ ţĥé ŕéļàţîöñš ƃéţŵééñ ţĥéḿ.

À ţéŕḿš ƃüñđļé îš àñ àŕţîƒàçţ: ţĥé šĥàþé à þŕöĵéçţ'š ţéŕḿš ţàķé ŵĥéñ ţĥéý ļéàṽé ţĥé þŕöĵéçţ šţöŕé, àñđ ţĥé šĥàþé ţĥéý àŕé ŕéàđ ƃàçķ ƒŕöḿ. kapi terms export ŵŕîţéš öñé, kapi store import ŕéàđš öñé, àñđ ţĥé šţöŕé îš ŵĥàţ éṽéŕý ļööķüþ àñđ éṽéŕý ĝàţé àñšŵéŕš ƒŕöḿ.

Îḿþļéḿéñţéđ îñ Ĝö àţ terms/ktb.

Ŵĥéñ ķàþî ŵŕîţéš öñé​

  • kapi terms export --format bundle: ţĥé éẋþļîçîţ éẋþöŕţ.
  • kapi pack: àš ţĥé terms.json ḿéḿƃéŕ îñšîđé à .kpz.

kapi terms import àççéþţš csv, tsv, json, tbx, öŕ bundle. Öñļý bundle îš ļöššļéšš; ţĥé ŕéšţ àŕé çöṽéŕéđ üñđéŕ ŵĥàţ ţĥé öţĥéŕ ƒöŕḿàţš đŕöþ.

Ŵĥéŕé àñ îḿþöŕţ ļööķš ƒöŕ öñé​

À ƒļöŵ ţĥàţ ñééđš à þŕöĵéçţ'š ţéŕḿš ŕéàđš ţĥé þŕöĵéçţ'š ţéŕḿš šţöŕé; ñö ƒļöŵ öþéñš à ƃüñđļé. kapi store import ŕéàđš öñé, àñđ ŵîţĥ ñö þàţĥ îţ ļööķš àţ <project-root>/.kapi/terms.json, ţĥé çöñṽéñţîöñàļ þļàçé ƃéšîđé ţĥé ŕéšţ öƒ à þŕöĵéçţ'š çöñţéẋţ ƒîļéš. Ñàḿé à đîŕéçţöŕý, kapi store import context, ţö ŕéàđ ţĥé terms.json îñ îţ. À ŕéçîþé ĥàš ñö ķéý ƒöŕ à ţéŕḿš ƒîļé.

Çöñţéñţ ḿéḿöŕý ĥàš ñö šîñĝļé çöñṽéñţîöñàļ ƒîļé​

À þŕöĵéçţ ĥàš öñé ţéŕḿš ƃüñđļé, šö öñé çöñṽéñţîöñàļ ƒîļéñàḿé ŵöŕķš. À þŕöĵéçţ çàñ ĥöļđ šéṽéŕàļ çöñţéñţ-ḿéḿöŕý ƃüñđļéš; ţĥîš ŕéþöšîţöŕý'š öŵñ đöĝƒööđ ŕéçîþé ķééþš öñé þéŕ šüŕƒàçé. Àñ îḿþöŕţ ţĥéŕéƒöŕé ŕéàđš éṽéŕý ƃüñđļé îñ .kapi/memory/.

Éñṽéļöþé​

{
  "schemaVersion": "1.0",
  "kind": "kapi-terms",
  "created": "2026-07-26T09:12:04Z",
  "generator": { "id": "kapi", "version": "1.2.3" },
  "concepts": [],
  "relations": []
}
ƑîéļđŢýþéÑöţéš
schemaVersionšţŕîñĝMAJOR.MINOR. Üñķñöŵñ ḿàĵöŕ ŕéĵéçţéđ; üñķñöŵñ ḿîñöŕ öƒ à ķñöŵñ ḿàĵöŕ àççéþţéđ.
kindšţŕîñĝÀļŵàýš kapi-terms.
createdšţŕîñĝŔƑÇ 3339. Öþţîöñàļ.
generatoröƃĵéçţ{id, version}. Öþţîöñàļ.
conceptsàŕŕàýŢĥé çöñçéþţš. Àļŵàýš þŕéšéñţ.
relationsàŕŕàýŔéļàţîöñš ƃéţŵééñ çöñçéþţš. Öḿîţţéđ éñţîŕéļý ŵĥéñ ţĥéŕé àŕé ñöñé.

concepts àñđ relations ŕéüšé ţĥé ţéŕḿš šţöŕé'š öŵñ ţýþéš đîŕéçţļý ŕàţĥéŕ ţĥàñ à þàŕàļļéļ ŵîŕé šţŕüçţ, šö ţĥé šéŕîàļîžàţîöñ çàññöţ đŕîƒţ ƒŕöḿ ţĥé ḿöđéļ îţ šéŕîàļîžéš.

Đéţéŕḿîñîšḿ​

Marshal þŕöđüçéš ƃýţé-šţàƃļé öüţþüţ: çöñçéþţš àñđ ŕéļàţîöñš šöŕţéđ ƃý îđ, ţéŕḿš ŵîţĥîñ à çöñçéþţ šöŕţéđ, ţîḿéšţàḿþš ñöŕḿàļîžéđ ţö ÜŢÇ, ĤŢḾĻ éšçàþîñĝ öƒƒ, ţŵö-šþàçé îñđéñţ, ţŕàîļîñĝ ñéŵļîñé. Ţŵö éẋþöŕţš öƒ ţĥé šàḿé šţöŕé àŕé ţĥé šàḿé ƃýţéš, šö à ƃüñđļé đš çļéàñļý àñđ çàñ ƃé ĥàšĥéđ àš à ŵĥöļé, ŵĥîçĥ îš ŵĥàţ ļéţš îţ šîţ îñšîđé à .kpz üñđéŕ ţĥé þàçķàĝé'š Ḿéŕķļé ŕööţ.

Ŵĥàţ ţĥé öţĥéŕ ƒöŕḿàţš đŕöþ​

kapi terms export àļšö éḿîţš csv, json, àñđ tbx (tsv îš àççéþţéđ öñ import only). All three are lossy, and the JSON one is the easiest to mistake ƒöŕ ţĥé ƃüñđļé ƃéçàüšé ƃöţĥ àŕé ĴŠÖÑ:

  • --format json ŵŕîţéš {name, version, concepts} àñđ ñöţĥîñĝ éļšé. Îţ çàŕŕîéš ñö ŕéļàţîöñš àţ àļļ, àñđ îţš éñṽéļöþé ĥàš ñö kind ḿàŕķéŕ, šö îţ çàññöţ ƃé šñéđ, àñđ à ŕéàđéŕ çàññöţ ţéļļ ŵĥîçĥ šçĥéḿà îţ îš ĥöļđîñĝ. Îţ îš à çöñṽéñîéñçé éẋþöŕţ ƒöŕ šþŕéàđšĥééţš àñđ šçŕîþţš.
  • --format tbx îš ţĥé îñđüšţŕý îñţéŕçĥàñĝé ƒöŕḿàţ. Îţ ĥàš ñö ŕéþŕéšéñţàţîöñ ƒöŕ ţĥé çŕöšš-ļîñķš ţĥàţ ḿàķé à ķàþî çöñçéþţ üšéƒüļ îñšîđé ķàþî, ḿöšţ ñöţàƃļý ţĥé éñţîţý çŕöšš-ŕéƒéŕéñçéš çöñţéñţ ḿéḿöŕý üšéš.
  • --format csv îš ƒļàţ: öñé ŕöŵ þéŕ ţéŕḿ, ñö çöñçéþţ šţŕüçţüŕé àñđ ñö ŕéļàţîöñš.

Ŕéàçĥ ƒöŕ bundle ŵĥéñéṽéŕ ţĥé ƒîļé îš šţàýîñĝ îñšîđé ķàþî.

Ŵĥàţ ţĥé ƃüñđļé ļéàṽéš öüţ​

  • Ţĥé šţöŕé'š öŵñ ţàƃļéš. À ƃüñđļé çàŕŕîéš ţĥé çöñçéþţš àñđ ŕéļàţîöñš; ţĥé ţéŕḿš ţàƃļéš îñ ţĥé þŕöĵéçţ šţöŕé àŕé ŵĥàţ àñ îḿþöŕţ ŵŕîţéš ţĥéḿ îñţö.
  • Ḿàţçĥ šţàţé. Ŵĥîçĥ ƃļöçķš à ţéŕḿ ŵàš ƒöüñđ îñ îš à çĥéçķ ŕéšüļţ; kapi terms occurrences ŕéàđš îţ ƒŕöḿ ţĥé þŕöĵéçţ'š ƃļöçķ çàçĥé.

Šéé àļšö​