kapi up

$ kapi up

Hold prosjektet oppdatert: oppskriften erklærer språkene, flyten og portene som avgjør hva som kan leveres; kapi up kjører prosjektets standardflyt (defaults.flow) over hvert målspråk og looper til hvert portet omfang kan leveres eller er parkert for et menneske.

Uten defaults.flow kjører up den innebygde standardflyten, Memory-gjenbruk (recycle) etterfulgt av AI-oversettelse, slik at en oppskrift ikke trenger noen flyt-YAML i det hele tatt for å ta igjen. Å sette defaults.flow erstatter den innebygde standarden.

Før hvert pass re-synkroniserer up prosjektets blokkager med arbeidstreet: redigerte kildefiler, et lager skrevet av en annen kapi-versjon, eller et manglende lager utløser et re-uttrekk (samme delte sti bak skrivebordets Re-extract). --no-extract velger bort dette.

Hvert pass re-beregner dekning fra arbeidstreet, kjører flyten bare for de språkkodene som fortsatt er under grensen, og stopper når alt kan leveres, et pass gjør ingen fremgang (resten parkeres, fordi det trenger et menneske), eller passtaket er nådd. Etter hvert pass kjører prosjektets bundne kontroller over det som ble produsert: en enhet med feilende funn (droppede plasshodere, terminologibrudd) teller fortsatt som oversatt, noe den er, og holder sin språkkode ute av levering til funnet er fikset. 'kapi status' kjører de samme kontrollene og rapporterer den samme dommen. --no-checks velger bort dette.

Materialiseringspolicyen avgjør om kjøringen eier leveringen av målspråkfilene. Under 'defaults.materialize: on-converge' (eller --materialize-flagget) gjør den det, og leveringsporten holder den tilbake: hvert pass utkaster til et kjøringslokal tre, og bare en språkkode hvis portede omfang alle kan leveres får filene sine skrevet dit oppskriften peker, og en parkert språkkodes filer er fraværende, ikke bare ublåstemplet. Standarden ('manual') overlater levering til 'kapi merge' og krever ingen port.

Venue: i et servertilkoblet prosjekt (en oppskrift med en bowrain:-blokk, med bowrain-tillegget installert) kjører løkken på Bowrain-serveren som standard, på organisasjonens nøkler, mot organisasjonens delte Memory og terminologi, og denne kommandoen pusher lokale endringer, strømmer serverens live-fremgang og puller de produserte målene. --local holder løkken på denne maskinen og pusher deretter resultatene slik at serveren aldri blir foreldet; --server feiler heller enn å falle tilbake til en lokal kjøring. Den løste venue-en skrives ut først når oppskriften kobler til en server. Uten den blokken er up rent lokal.

--plan er en tørrkjøring i enhver venue: i stedet for å kjøre noe rapporterer up det ventende arbeidet per (samling, språkkode): enheter som mangler et mål, eksakt Memory-gjenbruk, det gjenværende AI-arbeidet og et grovt token-estimat, beregnet lokalt mot arbeidstreet, uten leverandørkall og uten skriving. Kombiner med --json for agenter.

up feiler aldri bygget på målspråkdrift: parkert, ventende målinnhold er normalt arbeid, rapportert heller enn kastet. Bruk 'kapi status' for å inspisere tilstanden uten å kjøre noe, og 'kapi check --ship' for å håndheve portene (f.eks. før en utgivelsesmerke).

--passes 1 kjører ett enkelt pass (oppførselen til den bare 'kapi run'); --passes N begrenser løkken til N pass.

Commandup

Groupwork

Try it

Runs in your browser against a small sample file. Edit the command before running, or press Run to execute it as shown.

$ kapi up # run the default flow; stop where a gate holds content back

Flags

Flag	Type	Default	Description
--api-key	string		API-nøkkel for AI-leverandøren
--batching	string		hvor mange blokker som deler ett LLM-kall: auto (standard), single
--concurrency , -j	int	0	antall filer som behandles samtidig (0 = automatisk)
--context	string		hva modellen får vite om en blokk utover selve blokken: none, key (standard), neighbours
--credential	string		navn på lagret legitimasjon som skal brukes (se 'kapi credentials list')
--encoding , -e	string		tegnkoding for inndatafil
--engine	string		format engine for detected files: native or a plugin name (default: native, then plugins)
--explain	bool	false	skriv ut de løste kilde → mål-bindingene og avslutt uten å kjøre
--fail-on-incomplete-watch	bool	false	server venue: mislykkes når kjøringens hendelsesstrøm avsluttes før kjøringen er ferdig, i stedet for å rapportere det og hente det som kom inn
--fail-on-unknown	bool	false	avslutt med feil hvis noen fil ikke kan behandles (standard: hopp over med en advarsel)
--format , -f	string		overstyr gjenkjenning av inngangsformat
--input , -i	stringSlice		inndatafilsti(er); gjenta for flere filer
--instruction	string		ekstra veiledning til modellen under oversettelse (f.eks. "uformelt register; behold produktnavn på engelsk")
--jobs	int	0	antall språk som behandles parallelt per runde (0 = oppskriftens defaults.jobs, ellers 4)
--json	bool	false	skriv ut det strukturerte resultatet som JSON
--local	bool	false	kjør løkken på denne maskinen selv om oppskriften angir en server (resultatene pushes slik at serveren holdes oppdatert)
--materialize	bool	false	etter løkken, skriv målspråkfiler fra prosjektlageret for alle leveringsklare språkkoder (tvinger defaults.materialize: on-converge)
--memory	string		navngitt memory for resirkuleringsflyt (løses opp fra KAPI_HOME)
--model	string		AI-modellnavn
--no-checks	bool	false	hopp over grensekontrollene i løkken (produserte enheter teller som oversatt selv om de ikke består sikringsreglene)
--no-extract	bool	false	hopp over kildedrift-kontrollen i forpasset og ny ekstraksjon fra blokklageret
--output , -o	string		utdatasti eller mal (f.eks. ./out/{name}_{lang}.{ext})
--pack	bool	false	når en .kpz transformeres, eject også resultatet til .kpz-filen (auto-pack)
--parallel-blocks	int	0	fordel blokkbehandling på N goroutiner (0 = av)
--passes	int	0	maksimalt antall avstemmingsrunder (0 = løkke til oppdatert eller parkert, maks 5; 1 = enkelt pass)
--plan	bool	false	tørrkjøring: rapporter ventende arbeid, gjenbruk fra innholdsminne og et tokenestimat per (samling, språkkode), uten leverandørkall og uten skriving
--print-ops	bool	false	write no file and print the change set the run would apply, for kapi apply
--project , -p	string		sti til en kapi.yaml-prosjektoppskrift eller dens katalog (oppdages automatisk fra gjeldende katalog hvis utelatt)
--provider	string	anthropic	AI-leverandør (anthropic, openai, ollama)
--server	bool	false	krev servertilkobling: avslutt med feil i stedet for å kjøre flyten lokalt når oppskriften mangler server eller serverinfrastrukturen ikke er tilgjengelig
--source-lang	string		kildespråk (f.eks. en, en-US; bruker prosjektets source_language som standard, ellers en)
--stats	bool	false	inkluder del-/blokkantall i utdata
--strict	bool	false	alias for --fail-on-unknown
--target-lang	string		målspråk (f.eks. fr, de-DE)
--termstore	string		navngitt termbase for termoppslag/håndhevelse (løses opp fra KAPI_HOME)
--timeout	duration	15m0s	server venue: maksimal ventetid på at server-kjøringen fullfører før tilgjengelige resultater hentes
--trace	string		skriv flyt-sporing som JSON til fil (for flytvisualisering)

More examples

$ kapi up --plan # dry run: pending work, content-memory leverage, and a token estimate per locale

$ kapi up --passes 1 # a single pass over every locale that needs work

$ kapi up --materialize # also write target-language files for the shippable locales

$ kapi up --local # connected project: run the loop on this machine, then push the results

$ kapi up -p kapi.yaml # bring an explicit project recipe up to date

← Back to the Command Reference