Ƒééđ çöñţéñţ ţö ýöüŕ ÀÎ

Ĝöàļ: ţüŕñ àñý đöçüḿéñţ (Ŵöŕđ, ÞĐƑ, ĴŠÖÑ, Ḿàŕķđöŵñ, ĤŢḾĻ) îñţö à šţŕéàḿ öƒ çļéàñ, àñçĥöŕéđ çöñţéñţ ƃļöçķš àñ ÀÎ àššîšţàñţ öŕ ŔÀĜ þîþéļîñé çàñ ŕéàđ ŵîţĥöüţ ķñöŵîñĝ àñýţĥîñĝ àƃöüţ ţĥé šöüŕçé ƒöŕḿàţ. Ñö ţŕàñšļàţîöñ îš îñṽöļṽéđ. Éṽéŕý ƃļöçķ çàŕŕîéš à šţàƃļé content_hash àñçĥöŕ (à ŕéţŕîéṽàļ ķéý đéŕîṽéđ ƒŕöḿ ţĥé ƃļöçķ'š ţéẋţ ŕàţĥéŕ ţĥàñ îţš þöšîţîöñ) šö àñ éđîţ þŕöđüçéđ ļàţéŕ çàñ ƃé ŵŕîţţéñ ƃàçķ ţö ţĥé šàḿé ƃļöçķ ŵîţĥ ţĥé šüŕŕöüñđîñĝ ḿàŕķüþ îñţàçţ. Çöñçéþţš: Çöñţéñţ ḿöđéļ, Çĥéçķš.

Đéšķţöþ

Îñĝéšţîöñ îš à þîþéļîñé ĵöƃ, šö ţĥé đéšķţöþ'š ŕöļé ĥéŕé îš îñšþéçţîöñ:

1. Šéé ŵĥàţ ýöüŕ ÀÎ ŵîļļ šéé. Öþéñ à ƒîļé îñ ýöüŕ þŕöĵéçţ: ţĥé Ƃļöçķš ṽîéŵ îš ţĥé šàḿé ŕéçöŕđ šţŕéàḿ kapi inspect éḿîţš: ţĥé ţéẋţ àñđ îţš šţŕüçţüŕàļ ŕöļé, ŵîţĥ ţĥé šüŕŕöüñđîñĝ ḿàŕķüþ šţŕîþþéđ àŵàý.
2. Ĵüđĝé ţĥé þàŕšé ƃéƒöŕé ýöü îñđéẋ. Þŕéṽîéŵ (þļüš Šţŕüçţüŕé àñđ Ļàýöüţ ŵĥéŕé ţĥé ƒöŕḿàţ çàŕŕîéš ţĥéḿ) šĥöŵš ŵĥéţĥéŕ ĥéàđîñĝš, ţàƃļéš, àñđ ŕéàđîñĝ öŕđéŕ çàḿé ţĥŕöüĝĥ; çĥéàþéŕ ţö çàţçĥ ĥéŕé ţĥàñ îñ ŕéţŕîéṽàļ ǫüàļîţý ļàţéŕ.
3. Ţĥéñ šţŕéàḿ. Ţĥé ƒééđ îţšéļƒ îš kapi inspect --jsonl (ÇĻÎ ţàƃ), öŕ à çöññéçţéđ àššîšţàñţ ŕéàđîñĝ ƃļöçķš đîŕéçţļý (Àĝéñţ ţàƃ).

Àĝéñţ (Çļàüđé)

À çöññéçţéđ àššîšţàñţ ñééđš ñö éẋþöŕţ šţéþ: ţĥé ḾÇÞ ţööļš àŕé ţĥé ƒééđ:

• extract_content šţŕéàḿš ţĥé àñçĥöŕéđ ƃļöçķš öƒ àñý ƒîļé îţ îš þöîñţéđ àţ;
• check_file ŕéţüŕñš ţĥé šţŕüçţüŕéđ kapi.check/v1 Ŕéþöŕţ, öñé ƒîñđîñĝ þéŕ ƃļöçķ;
• apply_edits ŵŕîţéš ŕéṽîšîöñš ƃàçķ ţĥŕöüĝĥ ţĥé ŕöüñđ-ţŕîþ, đŕîƒţ-ĝüàŕđéđ ƃý content_hash.

Ýöü đéšçŕîƃé ţĥé öüţçöḿé ("ŕéàđ ţĥé çöñţŕàçţ àñđ ƒļàĝ éṽéŕý çļàüšé ţĥàţ ḿéñţîöñš ļîàƃîļîţý") àñđ ţĥé àššîšţàñţ ŕéàđš ƃļöçķš ŕàţĥéŕ ţĥàñ ƃýţéš.

ÇĻÎ

Šüŕṽéý ƒîŕšţ. kapi stats šîžéš ţĥé ĵöƃ (ƃļöçķš, ŵöŕđš, çĥàŕàçţéŕš, à ƃŕéàķđöŵñ ƃý šţŕüçţüŕàļ ŕöļé) ţö éšţîḿàţé ţöķéñ ƃüđĝéţ àñđ đéçîđé ĥöŵ ţö çĥüñķ:

kapi stats --json report.docx docs/*.md | jq '.total.words'

Éẋţŕàçţ ƃļöçķš ŵîţĥ àñçĥöŕš. kapi inspect éḿîţš öñé ŕéçöŕđ þéŕ ƃļöçķ: ţĥé þļàîñ text, à šţàƃļé content_hash, ţĥé šţŕüçţüŕàļ role, ţĥé ñéšţîñĝ level. Ţĥé ƒöŕḿàţ çöļļàþšéš: à Ŵöŕđ đöçüḿéñţ, à ĴŠÖÑ çàţàļöĝ, àñđ à Ḿàŕķđöŵñ þàĝé àļļ ýîéļđ ţĥé šàḿé ŕéçöŕđ šĥàþé. --jsonl šţŕéàḿš öñé öƃĵéçţ þéŕ ļîñé ƒöŕ þîþéļîñéš; -f đéçļàŕéš ţĥé ƒöŕḿàţ ŵĥéñ đéţéçţîöñ îš àḿƃîĝüöüš:

kapi inspect --jsonl report.docx docs/*.md | \
  jq -c '{hash: .content_hash, role: .role, text: .text}'
cat page.html | kapi inspect -f html --jsonl

Ŵŕîţé ƃàçķ; çĥéçķ àñý ţîḿé. kapi apply ļàñđš àñ àššîšţàñţ'š éđîţš öñ ţĥé öŕîĝîñàļ ƃļöçķš ƃý àñçĥöŕ; kapi check ŕéţüŕñš ƒîñđîñĝš à þŕöĝŕàḿ çàñ àçţ öñ (éẋîţ 0 þàšš, 3 ĝàţé ţŕîþþéđ, --no-fail ƒöŕ ƒîẋ-ļööþš):

kapi apply edits.jsonl --diff             # review before writing
kapi check report.docx --max-chars 300 --forbid "TODO"

Àñ éđîţ ţĥàţ đŕîƒţéđ (ţĥé ƒîļé çĥàñĝéđ šîñçé ýöü ŕéàđ îţ) öŕ ŵöüļđ çöŕŕüþţ àñ îñļîñé çöđé îš ŕéĵéçţéđ ŕàţĥéŕ ţĥàñ ŵŕîţţéñ; Éđîţ çöñţéñţ đöçüḿéñţš ţĥé éñţŕý šĥàþé àñđ ţĥé ĝüàŕđš.

Îñ à þŕöĵéçţ

Îñ à kapi þŕöĵéçţ, kapi stats, kapi inspect, àñđ kapi check ŵîţĥ ñö ƒîļé àŕĝüḿéñţ šüŕṽéý éṽéŕý šöüŕçé ţĥé ŕéçîþé đéçļàŕéš, àñđ ţĥé šàḿé content_hash àñçĥöŕš šţàý šţàƃļé àçŕöšš ŕüñš, šö àñ àššîšţàñţ îñđéẋîñĝ ýöüŕ þŕöĵéçţ çàñ ŕéţŕîéṽé àñđ ŕéŵŕîţé ţĥé šàḿé ƃļöçķš öṽéŕ ţîḿé.

Ƒüŕţĥéŕ ŕéàđîñĝ

• Éđîţ çöñţéñţ: ţĥé îñšþéçţ → éđîţ → apply ļööþ àñđ ţĥé þŕéšéŕṽàţîöñ çöñţŕàçţ.
• ḾÇÞ šéŕṽéŕ: éṽéŕý šţŕüçţüŕéđ ţööļ ƃéĥîñđ ţĥé šàḿé ļööþ.
• Ŵĥàţ ĝéţš ţŕàñšļàţéđ: îƒ ýöüŕ ĝöàļ îš ţŕàñšļàţîöñ ŕàţĥéŕ ţĥàñ ÀÎ îñĝéšţîöñ.