kapi šţàţüš

Šĥöŵ ŵĥéŕé ţĥé þŕöĵéçţ šţàñđš: þéŕ-šçöþé çöṽéŕàĝé àĝàîñšţ ţĥé šĥîþ ĝàţéš, ŵĥàţ îš šţàĝéđ ļöçàļļý, àñđ, öñ à çöññéçţéđ þŕöĵéçţ, ţĥé šéŕṽéŕ đéļţà àñđ ţĥé ṽéñüé kapi up ŵöüļđ ŕüñ öñ. kapi status àļŵàýš éẋîţš 0; à ļöçàļé ţĥàţ îš ƃéĥîñđ îš þéñđîñĝ ŵöŕķ, ñöţ àñ éŕŕöŕ.

Üšàĝé

kapi status [flags]

Ŵĥàţ îţ šĥöŵš

Ţĥé çöṽéŕàĝé ĝŕîđ

Öñé ŕöŵ þéŕ šçöþé, à ļöçàļé öŕ à locale/collection þàîŕ, ŵîţĥ ţĥé ñüḿƃéŕ öƒ üñîţš, öñé çöļüḿñ þéŕ ŕüñĝ öƒ ţĥé ţàŕĝéţ ļàđđéŕ (ţĥé šĥàŕé öƒ üñîţš ţĥàţ ĥàṽé ŕéàçĥéđ đŕàƒţîñĝ, ţŕàñšļàţîöñ, ŕéṽîéŵ), à þîþéļîñé ƃàŕ šĥöŵîñĝ đîšţàñçé ţö ţĥé ƃàŕ, àñđ à šĥîþ çöļüḿñ. Šĥîþ îš à ṽéŕđîçţ ŕàţĥéŕ ţĥàñ à þéŕçéñţàĝé: îţ ŕéàđš ready ŵĥéñ ţĥé šçöþé çļéàŕš îţš ĝàţé, blocked: <rung> ñàḿîñĝ ţĥé ƒîŕšţ üñḿéţ ĝàţé šö îţ þöîñţš àţ ţĥé ŵöŕķ, öŕ not gated ŵĥéñ ñö šĥîþ ĝàţé ḿàţçĥéš ţĥé šçöþé. Üñîţš àñ àüţöñöḿöüš ÀÎ àþþŕöṽéđ àŕé çöüñţéđ üñđéŕ ŕéṽîéŵ àñđ ǫüàļîƒîéđ àš šüçĥ, ƃéçàüšé ĝàţéš öñļý çöüñţ ţĥéḿ üñđéŕ àñ any àþþŕöṽéŕ çļàšš.

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

Šţàĝéđ đéçîšîöñš

Đéçîšîöñš ŕéçöŕđéđ ļöçàļļý ƃüţ ñöţ ýéţ ŵŕîţţéñ ţö ţĥé çöḿḿîţţéđ ŕéçöŕđ üñđéŕ .kapi/state/ àŕé çöüñţéđ àš šţàĝéđ; kapi commit þüƃļîšĥéš ţĥéḿ. À çļéàñ þŕöĵéçţ þŕîñţš ñöţĥîñĝ ĥéŕé.

Ţĥé šéŕṽéŕ šéçţîöñ

Öñ à çöññéçţéđ þŕöĵéçţ (ţĥé ŕéçîþé đéçļàŕéš à bowrain: ƃļöçķ), ţĥé þļüĝîñ àđđš ţĥé šéŕṽéŕ'š šţàñđîñĝ: ţĥé šéŕṽéŕ ÜŔĻ àñđ þŕöĵéçţ, ƃļöçķš þéñđîñĝ þüšĥ àñđ þéñđîñĝ þüļļ àĝàîñšţ ţĥé ţŕéé ţĥé þŕöĵéçţ ļàšţ đéçļàŕéđ (šéé kapi push), ţĥé ļàšţ šýñç ţîḿé, àñý ŕüñ îñ ƒļîĝĥţ, àñđ ţŵö ḿöŕé ļîñéš:

• ţéŕḿš: ŵĥéñ ţĥé ŵöŕķšþàçé'š ĝöṽéŕñéđ ţéŕḿš ŵéŕé ļàšţ šñàþšĥöţţéđ îñţö ţĥé ļöçàļ ţéŕḿš šţöŕé (çöñçéþţ àñđ ŕéļàţîöñ çöüñţš), öŕ never synced ŵĥéñ ñö çöñçéþţ þüļļ ĥàš ŕüñ; ŕéƒŕéšĥ ŵîţĥ kapi pull --concepts.
• ĝöṽéŕñàñçé: ŵĥéŕé ţĥîš þŕöĵéçţ'š đéçļàŕéđ þöîñţš, çĥàññéļš àñđ ṽöîçé šţàñđ àĝàîñšţ ţĥé ŵöŕķšþàçé'š, šö à đîṽéŕĝéñçé îš ṽîšîƃļé ƃéƒöŕé à þüšĥ ŕàîšéš îţ.

Ţĥé ṽéñüé

Ŵĥéŕé kapi up ŵöüļđ ŕüñ ţĥé ļööþ, server öŕ local, ŵîţĥ ţĥé ŕéçîþé'š bowrain.converge þöļîçý, àñđ à ñöţé ŵĥéñ ţĥé ṽéñüé îš đéĝŕàđéđ (à šéŕṽéŕ îš đéçļàŕéđ ƃüţ ţĥé bowrain þļüĝîñ îš ḿîššîñĝ).

Öþţîöñš

Ƒļàĝ	Đéšçŕîþţîöñ
--locale	Ļîḿîţ ţĥé ĝŕîđ ţö à šîñĝļé ţàŕĝéţ ļöçàļé
--source-lang	Šöüŕçé ļàñĝüàĝé (öṽéŕŕîđéš ţĥé þŕöĵéçţ'š source_language)
--review	Ļîšţ ţĥé üñîţš àŵàîţîñĝ ŕéṽîéŵ îñ éṽéŕý ļàñĝüàĝé, ţĥé šöüŕçé ļàñĝüàĝé àḿöñĝ ţĥéḿ, îñšţéàđ öƒ ţĥé ĝŕîđ; àþþŕöṽé à ţŕàñšļàţéđ öñé ŵîţĥ kapi apply
--lang <tag>	Ŵîţĥ --review, ļîšţ öñļý ţĥéšé ļàñĝüàĝéš (ŕéþéàţàƃļé, öŕ çöḿḿà-šéþàŕàţéđ)
--ship	Éḿîţ ţĥé ḿîñîḿàļ ship.json ḿàñîƒéšţ (ļöçàļé → šĥîþþàƃļé, ṽéŕîƒîéđ, šţàţé, àñđ àñý đîḿéñšîöñ ţĥàţ ĝöṽéŕñš ñöţĥîñĝ ţĥéŕé) îñšţéàđ öƒ ţĥé ĝŕîđ: ţĥé šĥàþé à ļàñĝüàĝé þîçķéŕ çöñšüḿéš ţö ĥîđé ļöçàļéš ţĥàţ àŕé ñöţ šĥîþþàƃļé àñđ ƃàđĝé ţĥöšé šĥîþþéđ öñ ḿàçĥîñé ŕéṽîéŵ
--emit <path>	Ŵîţĥ --ship, ŵŕîţé ţĥé ḿàñîƒéšţ ţö ţĥîš þàţĥ îñšţéàđ öƒ šţđöüţ
--json	Öüţþüţ ţĥé šţŕüçţüŕéđ ŕéšüļţ àš ĴŠÖÑ

kapi status --ship --emit ship.json àţ ƃüîļđ ţîḿé ŵŕîţéš ţĥé šàḿé ḿàñîƒéšţ ţĥé šéŕṽéŕ þüƃļîšĥéš àţ GET /api/v1/projects/:id/ship.json, šö à šîţé ƃüîļţ ƒŕöḿ à çĥéçķöüţ àñđ à šîţé ŕéàđîñĝ ţĥé šéŕṽéŕ àĝŕéé. Šéé Šĥîþ šţàţéš.

Éẋàḿþļéš

# The coverage grid, the server delta and the venue
kapi status

# One locale
kapi status --locale fr

# The review worklist, and one language of it
kapi status --review
kapi status --review --lang fr

# The ship manifest for a language picker, written at build time
kapi status --ship --emit public/ship.json

# Machine-readable
kapi status --json

Éẋîţ çöđéš

• 0: šţàţüš đîšþļàýéđ (ƃéĥîñđ îš þéñđîñĝ ŵöŕķ, ñöţ àñ éŕŕöŕ)
• 1: éŕŕöŕ (þŕöĵéçţ ñöţ ƒöüñđ, àñđ šö öñ)

Ŕéļàţéđ çöḿḿàñđš

• kapi diff: ţĥé çĥàñĝéđ ƃļöçķš, þéŕ ƒîļé
• kapi pull: ƒéţçĥ ţĥé šéŕṽéŕ'š çĥàñĝéš
• kapi push: šéñđ ļöçàļ çĥàñĝéš, àñđ ţĥé ţŕéé ţĥé đéļţà îš ḿéàšüŕéđ àĝàîñšţ
• kapi up: çàţçĥ ţĥé þŕöĵéçţ üþ
• kapi check --ship: ţĥé ĝàţé ţĥàţ ƒàîļš à ƃüîļđ

Ŵĥéñ ţö üšé

Ŕüñ kapi status ţö:

• Çĥéçķ ƃéƒöŕé þüšĥ ţö šéé ŵĥàţ ŵîļļ ƃé üþļöàđéđ
• Çĥéçķ àƒţéŕ þüļļ ţö šéé ŵĥàţ çĥàñĝéđ
• Šéé ŵĥàţ îš šĥîþþàƃļé ƃéƒöŕé à ŕéļéàšé, àñđ ŵĥàţ ƃļöçķš ţĥé ŕéšţ
• Ţŕöüƃļéšĥööţ šýñç îššüéš öŕ üñéẋþéçţéđ šţàţé