krites reset shoot¶
What krites reset shoot does¶
Return a whole shoot toward its post-ingest state. It has two modes: a full
reset (the default) and a soft reset (--keep-picks) that preserves
everything you decided by hand.
Both modes clear the analysis cache, so the next krites cull
re-decodes every frame and re-runs any configured model.
Usage¶
Flags¶
| Flag | Description | Default |
|---|---|---|
--shoot |
Shoot directory | the current directory |
--keep-picks |
Soft reset: keep the photographer's manual picks and edits | false |
Plus the global --output text|json.
What a full reset deletes¶
The default — no --keep-picks — deletes:
| Path | What goes with it |
|---|---|
.krites/verdicts.yaml |
every verdict, including ones you set by hand, and every star rating |
.krites/analysis.yaml |
the cached per-frame signals |
.krites/edits/ |
every straighten, crop and look on every frame |
.krites/removals/ |
every cached object-removal patch |
.krites/develop.yaml |
the shoot's develop config, including its look catalog |
The removal patches are not recoverable. Each one is the sole copy of a
generative fill; the edit record only points at it. A full reset therefore
permanently destroys work that no re-cull can rebuild. If the reason you are
resetting is "the cull came out wrong", use --keep-picks, or run
krites cull --reanalyze instead — that forces a fresh analysis pass
without deleting anything.
What --keep-picks preserves¶
A soft reset deletes the analysis cache and only those verdict entries the machine wrote and you never touched. It keeps:
- every verdict you set by hand, with its star rating, burst cluster, the machine's original proposal and the timestamp you decided it;
.krites/edits/in full — straighten, crop and look on every frame;.krites/removals/in full — the object-removal patches;.krites/develop.yaml, the shoot's look catalog.
A star rating rides on the verdict rather than surviving on its own. Rating a frame
is not itself an override, so a frame you only rated — without also setting its
verdict by hand — still counts as a machine verdict, and a soft reset clears the
entry with the rating in it. A re-cull does keep a rating on its own terms;
--keep-picks does not.
This is the mode for "re-cull this shoot cleanly without clobbering my keepers".
What neither mode touches¶
Your originals, .krites/shoot.yaml (the manifest), the export/ directory,
.krites/exports.yaml (the export ledger), .krites/reviews/ (saved AI
critiques), .krites/previews/ (the preview cache) and .krites/jobs/ (crash
breadcrumbs) all survive both modes.
The preview cache surviving is worth knowing: it is regenerable, nothing prunes it, and no reset clears it. Previews are keyed by the frame's edit state, so a stale entry is never served — but the directory grows and is only ever emptied by deleting it yourself.