Üñđéŕšţàñđîñĝ ţĥé ÇĻÎ ļàýéŕš

Ḿöšţ üšéŕš ŕüñ kapi up àñđ šţöþ: îţ çàţçĥéš ţĥé ŵĥöļé þŕöĵéçţ üþ ţö îţš šĥîþ ĝàţéš, àñđ ţĥé þöŕçéļàîñ ṽéŕƃš àŕöüñđ îţ (status, check, apply, translate) çöṽéŕ ţĥé đàîļý ŵöŕķ. Ţĥîš þàĝé îš ţĥé ļàýéŕ üñđéŕñéàţĥ, ƒöŕ ţĥé éñĝîñééŕ ŵĥö ŵàñţš ţö ķñöŵ ŵĥàţ ţĥöšé ṽéŕƃš àŕé ḿàđé öƒ, öŕ ñééđš ţö ŕüñ öñé þîéçé öƒ ţĥé ḿàçĥîñéŕý öñ îţš öŵñ.

Ţĥé ļàýéŕš ƒöŕḿ öñé ḿöđéļ, ñöţ šéþàŕàţé ƒéàţüŕéš. Àţ ţĥé ƃöţţöḿ îš à ŕéĝîšţŕý öƒ ţööļš: ţŕàñšļàţé, ŕéçýçļé, ǫà, ţéŕḿ-çĥéçķ, ŕéđàçţ, àñđ ţĥé ŕéšţ (ļîšţ ţĥéḿ ŵîţĥ kapi tools list; ţĥé ţööļ ŕéƒéŕéñçé đöçüḿéñţš éàçĥ). À ƒļöŵ çöḿþöšéš ţööļš îñţö à ñàḿéđ þîþéļîñé. Ţĥé þöŕçéļàîñ ṽéŕƃš àŕé ŵöŕķƒļöŵš öṽéŕ ţĥöšé ţŵö ļàýéŕš: kapi translate ŵŕàþš ŕéçýçļé → ţŕàñšļàţé → çĥéçķš, àñđ kapi up ļööþš à ƒļöŵ üñţîļ ţĥé þŕöĵéçţ'š ĝàţéš àŕé ḿéţ.

Éàçĥ ļàýéŕ çöḿþöšéš ţĥé öñé ƃéļöŵ: à ƒļöŵ îš àñ öŕđéŕéđ ļîšţ öƒ ţööļš; kapi üþ îš à ƒļöŵ îñ à ļööþ ŵîţĥ çöṽéŕàĝé, çĥéçķš, àñđ ĝàţéš àŕöüñđ îţ.

exec: öñé ţööļ, öñé þàšš

kapi exec <tool> éẋéçüţéš à šîñĝļé ŕéĝîšţŕý ţööļ öñ ţĥé ƒîļéš ýöü ñàḿé: öñé ţööļ, öñé þàšš, ñö ĝüàŕđŕàîļš àŕöüñđ îţ. Ţĥéšé àŕé ţĥé šàḿé ţööļš à ƒļöŵ ŕüñš: exec translate îš à ƃàŕé ÀÎ ţŕàñšļàţé ŵîţĥ ñö çöñţéñţ-ḿéḿöŕý þàšš ƃéƒöŕé îţ àñđ ñö çĥéçķš àƒţéŕ îţ; exec term-check ŕüñš ĵüšţ ţĥé ţéŕḿîñöļöĝý çĥéçķ; exec recycle ŕüñš ĵüšţ ţĥé çöñţéñţ-ḿéḿöŕý ļéṽéŕàĝé. Đîšçöṽéŕ à ţööļ'š öþţîöñš ŵîţĥ kapi tools schema <name>.

kapi exec translate app.json --target-lang fr    # bare translate, no memory, no checks
kapi exec term-check locales/fr.json --target-lang fr
kapi exec recycle app.json --target-lang fr      # content-memory leverage only

Ŕéàçĥ ƒöŕ exec ŵĥéñ ýöü ŵàñţ éẋàçţļý öñé ţööļ'š ƃéĥàṽîöŕ: îšöļàţîñĝ à šţéþ ŵĥîļé đéƃüĝĝîñĝ à ƒļöŵ, öŕ à öñé-öƒƒ çĥéçķ öñ à ƒîļé. Šéé ţĥé exec ŕéƒéŕéñçé.

run: çöḿþöšé ţööļš îñţö à ƒļöŵ

kapi run <flow> ŕüñš à ñàḿéđ ƒļöŵ (àñ öŕđéŕéđ çöḿþöšîţîöñ öƒ ţööļš) ƒöŕ öñé þàšš. Ƃüîļţ-îñ ƒļöŵš çöṽéŕ ţĥé çöḿḿöñ çöḿþöšîţîöñš (translate, translate-qa, secure-translate; kapi flows ļîšţš ŵĥàţ ýöüŕ ƃüîļđ šĥîþš), àñđ à þŕöĵéçţ ŕéçîþé đéƒîñéš îţš öŵñ üñđéŕ flows:.

kapi run translate-qa -i app.xliff --target-lang fr   # translate, then LLM-judged review
kapi run secure-translate -i notes.md --target-lang de # redact → translate → unredact
kapi run pseudo -p kapi.yaml                           # a project-defined flow

À ƒļöŵ îš àļšö ŵĥàţ kapi up ļööþš: defaults.flow ñàḿéš ţĥé þŕöĵéçţ'š đéƒàüļţ, àñđ ŵîţĥöüţ öñé up ŕüñš ţĥé ƃüîļţ-îñ đéƒàüļţ: çöñţéñţ-ḿéḿöŕý ŕéüšé (ŕéçýçļé) ƒöļļöŵéđ ƃý ÀÎ ţŕàñšļàţé. run éẋéçüţéš ţĥé çöḿþöšîţîöñ öñçé àñđ šţöþš; îţ ŕé-đéŕîṽéš ñö çöṽéŕàĝé àñđ çöñšüļţš ñö ĝàţéš. Šéé ţĥé run ŕéƒéŕéñçé.

extract / merge: ţĥé ţŕàñšļàţöŕ ĥàñđ-öƒƒ

Ñöţ éṽéŕý þàšš îš à ţööļ ŕüñ. Ŵĥéñ à þéŕšöñ đöéš ţĥé ţŕàñšļàţîöñ, kapi extract éḿîţš öñé ƃîļîñĝüàļ ƒîļé þéŕ šöüŕçé → ţàŕĝéţ þàîŕ (ẊĻÎƑƑ 2.ẋ öŕ ÞÖ ƒöŕ à ţĥîŕđ-þàŕţý ÇÀŢ ţööļ, à ļöššļéšš .kpz ƒöŕ à ŕéçîþîéñţ ŵöŕķîñĝ îñ kapi), þŕé-ƒîļļéđ ƒŕöḿ ţĥé þŕöĵéçţ'š çöñţéñţ ḿéḿöŕý. kapi merge àþþļîéš ţĥé ŕéţüŕñéđ ƒîļé ƃàçķ öñţö ţĥé þŕöĵéçţ, ŕéšţöŕîñĝ ţĥé öŕîĝîñàļ ƒöŕḿàţš ţĥŕöüĝĥ ţĥé šķéļéţöñ çàþţüŕéđ àţ éẋţŕàçţ ţîḿé àñđ àƃšöŕƃîñĝ ţĥé çöŕŕéçţîöñš îñţö ḿéḿöŕý.

kapi extract --target-lang fr          # → out/<name>.en-to-fr.xliff, memory pre-filled
kapi merge -i out/app.en-to-fr.xliff

Éẋţŕàçţ àñđ ḿéŕĝé šîţ àţ ţĥé šàḿé àļţîţüđé àš run: ţĥéý ḿöṽé ŵöŕķ ţĥŕöüĝĥ àñ éẋţéŕñàļ þàšš îñšţéàđ öƒ à ţööļ þàšš, àñđ ţĥé ŕéšüļţ ļàñđš îñ ţĥé šàḿé þŕöĵéçţ šţàţé ţĥé þöŕçéļàîñ ŕé-đéŕîṽéš. Ţĥé ŵöŕķƒļöŵ (çàŕŕîéŕš, ḿéḿöŕý þŕöṽéñàñçé, ṽéñđöŕ ŕöüñđš) îš çöṽéŕéđ îñ Ĥàñđ öƒƒ ţö ţŕàñšļàţöŕš; ţĥé ƒļàĝš àŕé îñ ţĥé extract àñđ merge ŕéƒéŕéñçéš.

Ŵĥàţ kapi up àđđš

Šééñ ƒŕöḿ ţĥîš ļàýéŕ, kapi up îš ŕüñ ţĥé đéƒàüļţ ƒļöŵ, îñ à ļööþ, ŵîţĥ ţĥé þŕöĵéçţ ḿàçĥîñéŕý àŕöüñđ îţ. Éàçĥ þàšš:

1. ŕé-đéŕîṽéš çöṽéŕàĝé ƒŕöḿ ţĥé ŵöŕķîñĝ ţŕéé (ŕé-éẋţŕàçţîñĝ ŵĥéñ šöüŕçé ƒîļéš çĥàñĝéđ),
2. ŕüñš ţĥé ƒļöŵ ƒöŕ ţĥé ļöçàļéš šţîļļ šĥöŕţ öƒ ţĥéîŕ ĝàţé: ţĥé šàḿé çöḿþöšîţîöñ run ŵöüļđ éẋéçüţé öñçé,
3. ŕüñš ţĥé ƃöüñđ çĥéçķš öṽéŕ ŵĥàţ ŵàš þŕöđüçéđ, šö à üñîţ ŵîţĥ ƒàîļîñĝ ƒîñđîñĝš çàññöţ ļîƒţ îţš ļöçàļé öṽéŕ ţĥé ĝàţé,
4. éṽàļüàţéš ţĥé ĝàţéš àñđ éîţĥéŕ ļööþš, šţöþš ŵĥéñ ţĥé þŕöĵéçţ îš üþ ţö đàţé, öŕ þàŕķš ŵĥàţ ñééđš à þéŕšöñ.

Ñöñé öƒ ţĥàţ îš àṽàîļàƃļé þîéçéḿéàļ ƒŕöḿ ţĥé ļöŵéŕ ļàýéŕš: run àñđ exec šķîþ ţĥé çöṽéŕàĝé đéŕîṽàţîöñ, ţĥé çĥéçķš, àñđ ţĥé ĝàţéš ƃý đéšîĝñ. Ţĥé ƒüļļ ḿöđéļ îš ţĥé kapi ļööþ.

Ŵĥéñ ţö ŕéàçĥ ƒöŕ éàçĥ

Ýöü ŵàñţ	Ŕéàçĥ ƒöŕ
Ţĥé đàîļý çàţçĥ-üþ: éṽéŕýţĥîñĝ ţöŵàŕđ ţĥé ĝàţéš	kapi up
Öñé ĝüàŕđŕàîļéđ ţŕàñšļàţîöñ þàšš öṽéŕ ñàḿéđ ƒîļéš	kapi translate
À šþéçîƒîç çöḿþöšîţîöñ, öñé þàšš, ñö ĝàţé ļööþ	kapi run <flow>
Éẋàçţļý öñé ţööļ'š ƃéĥàṽîöŕ, ñöţĥîñĝ àŕöüñđ îţ	kapi exec <tool>
À þéŕšöñ ţŕàñšļàţéš: ĥàñđ ţĥé ŵöŕķ öüţ àñđ ţàķé îţ ƃàçķ	kapi extract / kapi merge

Šéé àļšö

• Ţĥé kapi ļööþ: ţĥé ḿöđéļ ƃéĥîñđ up, status, àñđ ţĥé ĝàţéš.
• Ƒļöŵš: ĥöŵ à ƒļöŵ îš àüţĥöŕéđ àñđ éẋéçüţéđ.
• Ĥàñđ öƒƒ ţö ţŕàñšļàţöŕš: ţĥé ƃîļîñĝüàļ îñţéŕçĥàñĝé ŵöŕķƒļöŵ.
• exec, run, extract, merge: çöḿḿàñđ ŕéƒéŕéñçé.