Oko
Oko/Docs

Command reference

oko goals recompute

Recompute runs over the signed-in member's goal document. stage rebuilds a window (or classifies today's unclassified turns) through the goal-lifecycle model and materializes that window's prompt mappings from this machine's transcripts as part of the same run; list and show find and read runs; review records duplicate decisions in a new run; apply writes a reviewed run and rollback undoes it.

Invocation#

Command
oko goals recompute stage (--from YYYY-MM-DD --to YYYY-MM-DD [--window-only] | --unclassified) [--limit N] | list | show RUN | review RUN [--merge SURVIVOR_ID=OTHER_ID[,OTHER_ID...] ...] [--keep-duplicates GROUP_ID ...] | apply RUN | rollback RUN

Inputs and options#

  • stage takes ordered --from/--to days (or --unclassified) and an optional positive --limit; every other verb names the run id list prints.
  • Every run is the signed-in member's own row; there is no table, organization or user flag.

Output and state effect#

  • stage, review: write a run to ~/.oko/auto-goals/recompute and print its diff; Supabase is not modified. list: prints every run with its state, window and hashes, newest first, and any file that does not read as a run with why. show: prints the run's diff and state. apply, rollback: conditionally replace or restore the canonical snapshot and print the row hash.

Refusals and safe exits#

  • “oko goals recompute takes stage, list, show, review, apply or rollback”; “oko goals recompute: name the run id after the verb”; “<id> is not a recompute run id”; “the file of run <id> holds run <other>”; missing, invalid or reversed --from/--to; a nonpositive --limit; the shared database connection's actual refusal, without replacing its cause with a login instruction; unknown, incomplete or overlapping duplicate decisions; unreviewed, incomplete or stale runs, invalid transitions and concurrent row changes on apply or rollback.

CLI reference#