@starci/cli 1.0.1 → 1.2.0

package/completions/starci.fish

@@ -44,7 +44,7 @@ complete -c starci -n '__starci_needs_group' -a 'worker' -d 'start, inspect and
 complete -c starci -n '__starci_needs_group' -a 'workflow' -d 'workflow lifecycle — define a goal, start its kernel, status, stop'
 complete -c starci -n '__starci_needs_group' -a 'help' -d 'show top-level help'
 complete -c starci -n '__starci_needs_group' -a 'completion' -d 'print a shell completion script'
-complete -c starci -n '__starci_needs_group' -a 'explain' -d 'show a verb contract and the spellings it replaces'
+complete -c starci -n '__starci_needs_group' -a 'explain' -d 'show a verb contract'
 complete -c starci -n '__starci_needs_verb app' -a 'add' -d 'add one canonical backend capability and register its patterns'
 complete -c starci -n '__starci_needs_verb app' -a 'check' -d 'judge the app tree, managed output, contracts, formatting and architecture'
 complete -c starci -n '__starci_needs_verb app' -a 'emit' -d 'emit backend GraphQL, operation and event contract snapshots'
@@ -62,7 +62,7 @@ complete -c starci -n '__starci_needs_verb connect' -a 'ask-gateway' -d 'operate
 complete -c starci -n '__starci_needs_verb connect' -a 'telegram' -d 'deliver and maintain owner Telegram notifications'
 complete -c starci -n '__starci_needs_verb connect' -a 'telegram-media' -d 'deliver settled operation media through Telegram'
 complete -c starci -n '__starci_needs_verb connect' -a 'tunnel' -d 'operate the Cloudflare owner-ask tunnel'
-complete -c starci -n '__starci_needs_verb debug' -a 'pass' -d 'inspect core health and maintain diagnostic custody in the machine ledger'
+complete -c starci -n '__starci_needs_verb debug' -a 'digest' -d 'print the read-only debug digest with a verdict per role (no error, happy error, BUG)'
 complete -c starci -n '__starci_needs_verb debug' -a 'run' -d 'run one allowlisted read-only runtime inspector'
 complete -c starci -n '__starci_needs_verb docker' -a 'build' -d 'build one declared application image from the application root'
 complete -c starci -n '__starci_needs_verb docker' -a 'down' -d 'remove only the labelled resources owned by one application stack'
@@ -72,11 +72,14 @@ complete -c starci -n '__starci_needs_verb gate' -a 'canon-scan' -d 'measure can
 complete -c starci -n '__starci_needs_verb gate' -a 'custody-exec' -d 'decrypt one custody document for a command or a bounded read'
 complete -c starci -n '__starci_needs_verb gate' -a 'env-health' -d 'inspect and manage the served environment used by verification'
 complete -c starci -n '__starci_needs_verb gate' -a 'hfs-sync' -d 'check an app'\''s generated files and custody trees for drift'
+complete -c starci -n '__starci_needs_verb gate' -a 'install-sandbox' -d 'prove the packed runtime tarball installs and runs in an empty home'
 complete -c starci -n '__starci_needs_verb gate' -a 'read' -d 'build the recorded READ digest for an operation'
 complete -c starci -n '__starci_needs_verb gate' -a 'reference-conventions' -d 'probe the installed backend reference rules of a reference root'
 complete -c starci -n '__starci_needs_verb gate' -a 'repo-presentation' -d 'check repository presentation rules for a product or runtime tree'
 complete -c starci -n '__starci_needs_verb gate' -a 'run' -d 'run the measured product or document gate'
-complete -c starci -n '__starci_needs_verb gate' -a 'sonar' -d 'inspect, provision and run the local Sonar quality gate'
+complete -c starci -n '__starci_needs_verb gate' -a 'runtime-artifact' -d 'describe the packed runtime archive and refuse forbidden material in it'
+complete -c starci -n '__starci_needs_verb gate' -a 'runtime-coverage' -d 'run the runtime spec suite under Node coverage and write coverage/lcov.info'
+complete -c starci -n '__starci_needs_verb gate' -a 'sonar' -d 'inspect, provision, run and start the local Sonar quality gate'
 complete -c starci -n '__starci_needs_verb gate' -a 'starcistacks' -d 'check a repository'\''s stack declaration and custody layout'
 complete -c starci -n '__starci_needs_verb gate' -a 'test-world' -d 'run and judge one managed test-world project'
 complete -c starci -n '__starci_needs_verb gate' -a 'unit' -d 'run unit tests and judge per-subject coverage and test-kit use'
@@ -99,7 +102,7 @@ complete -c starci -n '__starci_needs_verb kernel' -a 'autopilot' -d 'show or dr
 complete -c starci -n '__starci_needs_verb kernel' -a 'consume-report' -d 'integrate the report a job filed; the Kernel must consume it before settle'
 complete -c starci -n '__starci_needs_verb kernel' -a 'coverage' -d 'show every FR, shape and proof case of the workflow'\''s scope as proven, stale or missing'
 complete -c starci -n '__starci_needs_verb kernel' -a 'cut-seam' -d 'publish a cut seam'\''s interface, release its siblings on a stub, or reconcile a stub sibling'
-complete -c starci -n '__starci_needs_verb kernel' -a 'decide' -d 'open, list or close an entry of the Kernel decision log (hypothesis, action, metric)'
+complete -c starci -n '__starci_needs_verb kernel' -a 'decide' -d 'answer one item of the Kernel menu with a typed choice, or keep the decision log'
 complete -c starci -n '__starci_needs_verb kernel' -a 'decisions' -d 'list, open, claim, resolve or escalate Decision Items; the Kernel reads them first every wake'
 complete -c starci -n '__starci_needs_verb kernel' -a 'dispatch' -d 'admit a routed job and launch its worker with --spawn; without it print the launch plan'
 complete -c starci -n '__starci_needs_verb kernel' -a 'dispatch-ready' -d 'route and dispatch queued-ready jobs up to the workflow allowed parallelism'
@@ -113,7 +116,7 @@ complete -c starci -n '__starci_needs_verb kernel' -a 'graph-edit' -d 'apply a l
 complete -c starci -n '__starci_needs_verb kernel' -a 'hierarchy' -d 'project the agent hierarchy (starci/agent-hierarchy@1) of a workflow'
 complete -c starci -n '__starci_needs_verb kernel' -a 'inbox' -d 'list the workflow'\''s pending inbox items, or acknowledge one with a disposition'
 complete -c starci -n '__starci_needs_verb kernel' -a 'incident' -d 'raise, resolve or attach typed release conditions to a workflow incident'
-complete -c starci -n '__starci_needs_verb kernel' -a 'kernel-ack-rev' -d 'project or attest the complete current Kernel READ manifest'
+complete -c starci -n '__starci_needs_verb kernel' -a 'kernel-ack-rev' -d 'project or attest the Kernel READ manifest (also spelled revision-ack)'
 complete -c starci -n '__starci_needs_verb kernel' -a 'kernel-proposal' -d 'file a tier-2 shared runtime change proposal for the Supervisor, or list proposals'
 complete -c starci -n '__starci_needs_verb kernel' -a 'lifecycle' -d 'pause, stop or resume a workflow; only the owner or supervisor resumes or stops'
 complete -c starci -n '__starci_needs_verb kernel' -a 'log' -d 'append one typed log row to the ledger'\''s logs table'
@@ -137,6 +140,7 @@ complete -c starci -n '__starci_needs_verb kernel' -a 'rename' -d 'set a workflo
 complete -c starci -n '__starci_needs_verb kernel' -a 'reply' -d 'answer a pending worker question, or route it to the owner with --to-owner'
 complete -c starci -n '__starci_needs_verb kernel' -a 'report' -d 'a worker files its job report (the durable op to kernel IPC)'
 complete -c starci -n '__starci_needs_verb kernel' -a 'retire-ask' -d 'close an ask the owner should no longer answer (ask-superseded)'
+complete -c starci -n '__starci_needs_verb kernel' -a 'revision-ack' -d 'the same verb as kernel-ack-rev: project or attest the Kernel READ manifest'
 complete -c starci -n '__starci_needs_verb kernel' -a 'route' -d 'resolve and persist the model decision of a job'
 complete -c starci -n '__starci_needs_verb kernel' -a 'run-deferred-tests' -d 're-queue the test legs the owner'\''s specs switch deferred (see status testsDeferred)'
 complete -c starci -n '__starci_needs_verb kernel' -a 'serve-ask' -d 'park an owner ask: Telegram notice first, the answer form served on demand'
@@ -160,38 +164,47 @@ complete -c starci -n '__starci_needs_verb npm' -a 'install' -d 'add exact depen
 complete -c starci -n '__starci_needs_verb orca' -a 'terminal-read' -d 'read an Orca terminal screen and staged draft'
 complete -c starci -n '__starci_needs_verb orca' -a 'terminal-send' -d 'send text or Enter to an Orca terminal'
 complete -c starci -n '__starci_needs_verb reconciler' -a 'once' -d 'run one reconcile pass of the controllers in memory, shadow unless --apply'
+complete -c starci -n '__starci_needs_verb reconciler' -a 'reopen' -d 'put a quarantined service or seat back to declared with a clean restart history'
 complete -c starci -n '__starci_needs_verb reconciler' -a 'restart' -d 'stop the reconciler engine and ensure a new leader'
 complete -c starci -n '__starci_needs_verb reconciler' -a 'start' -d 'ensure the reconciler engine has a healthy leader'
 complete -c starci -n '__starci_needs_verb reconciler' -a 'status' -d 'print reconciler leader, queue, mode and violation status'
 complete -c starci -n '__starci_needs_verb reconciler' -a 'stop' -d 'stop the current reconciler engine leader'
-complete -c starci -n '__starci_needs_verb reconciler' -a 'up' -d 'bring the runtime host services and live seats up and print one checklist'
+complete -c starci -n '__starci_needs_verb reconciler' -a 'up' -d 'bring the host services and seats up, or check them read-only, and print the checklist'
 complete -c starci -n '__starci_needs_verb release' -a 'app-installs' -d 'verify a scaffolded app against fresh registry installs'
 complete -c starci -n '__starci_needs_verb release' -a 'check' -d 'run the one read-only release readiness gate'
+complete -c starci -n '__starci_needs_verb release' -a 'ci-status' -d 'the verdict of the GitHub ci workflow, Codecov and Sonar for a release; red is recorded for Debug'
 complete -c starci -n '__starci_needs_verb release' -a 'clean-test' -d 'test published packages from fresh isolated installs'
-complete -c starci -n '__starci_needs_verb release' -a 'cut' -d 'cut the release, the only push of main with its annotated release tag'
+complete -c starci -n '__starci_needs_verb release' -a 'cut' -d 'cut the release, the only way the runtime'\''s remote main and a release tag move'
+complete -c starci -n '__starci_needs_verb release' -a 'env-test' -d 'run the runtime spec suite under the release cut'\''s own conditions'
 complete -c starci -n '__starci_needs_verb release' -a 'images' -d 'build, run, health-check and tear down the shipped application images'
 complete -c starci -n '__starci_needs_verb release' -a 'launch-smoke' -d 'prove live nested-agent launch paths on an Orca host'
+complete -c starci -n '__starci_needs_verb release' -a 'notes' -d 'print or write the release notes of a tag, its CHANGELOG section'
 complete -c starci -n '__starci_needs_verb release' -a 'proof' -d 'build the release proof attached before publish or deploy effects'
 complete -c starci -n '__starci_needs_verb release' -a 'publish' -d 'plan or perform the owner-run package publication sequence'
 complete -c starci -n '__starci_needs_verb release' -a 'sync-runtime' -d 'refresh or check package runtime copies and optionally prepare grammar'
 complete -c starci -n '__starci_needs_verb route' -a 'op' -d 'resolve the operation that serves a structured routing request'
 complete -c starci -n '__starci_needs_verb runtime' -a 'architecture' -d 'check one repository against the runtime architecture rules'
+complete -c starci -n '__starci_needs_verb runtime' -a 'artefacts' -d 'judge or migrate the artefacts the runtime installs outside its tree'
 complete -c starci -n '__starci_needs_verb runtime' -a 'benchmark-snapshot' -d 'append one model-pool snapshot file under benchmark/snapshots'
 complete -c starci -n '__starci_needs_verb runtime' -a 'check' -d 'judge the runtime tree — node --check, the runtime HFS check, the retained self-checks'
+complete -c starci -n '__starci_needs_verb runtime' -a 'deploy' -d 'carry a checked runtime revision onto the running host and verify the engine on it'
 complete -c starci -n '__starci_needs_verb runtime' -a 'derived-fields' -d 'regenerate or check the derived fields of the knowledge pattern files'
 complete -c starci -n '__starci_needs_verb runtime' -a 'doctor' -d 'verify installed payload, public entry custody and local runtime capabilities'
 complete -c starci -n '__starci_needs_verb runtime' -a 'gen-catalog' -d 'write or check the generated CLI catalog outputs, docs and shell completions'
 complete -c starci -n '__starci_needs_verb runtime' -a 'gen-ops' -d 'regenerate or check the generated operation registry'
 complete -c starci -n '__starci_needs_verb runtime' -a 'housekeeping' -d 'inspect or apply the host housekeeping sweeps'
+complete -c starci -n '__starci_needs_verb runtime' -a 'import-held-secret' -d 'move one sealed member of the old tracked custody from git history into secret.env'
 complete -c starci -n '__starci_needs_verb runtime' -a 'install' -d 'install the StarCi runtime — fetch the pinned package, then init or update <cwd>/.claude'
-complete -c starci -n '__starci_needs_verb runtime' -a 'ledger-hygiene' -d 'report orphan ledgers and legacy repository-local ledger stores'
+complete -c starci -n '__starci_needs_verb runtime' -a 'ledger-hygiene' -d 'report orphan ledgers'
 complete -c starci -n '__starci_needs_verb runtime' -a 'link' -d 'point the per-user StarCi launcher at a live runtime checkout'
 complete -c starci -n '__starci_needs_verb runtime' -a 'machine-db' -d 'inspect or maintain the host machine database'
 complete -c starci -n '__starci_needs_verb runtime' -a 'owner-claims-audit' -d 'audit owner-decision claims and owner-gates in runtime ledgers'
 complete -c starci -n '__starci_needs_verb runtime' -a 'readme-blocks' -d 'regenerate or check the generated blocks of knowledge/hfs/README.md'
+complete -c starci -n '__starci_needs_verb runtime' -a 'revision-scope' -d 'show what a deploy of the runtime tree asks of each role between two revisions'
 complete -c starci -n '__starci_needs_verb runtime' -a 'status' -d 'the runtime'\''s version, tree root and manifest drift — a read-only summary'
 complete -c starci -n '__starci_needs_verb runtime' -a 'update' -d 'bring an installed .claude tree to this package'\''s payload version'
 complete -c starci -n '__starci_needs_verb runtime' -a 'validate' -d 'read-only Work record/tree validation — structure, consistency, artifacts, schemas'
+complete -c starci -n '__starci_needs_verb runtime' -a 'verify' -d 'verify a committed revision - the check AND the affected specs on one commit, one receipt'
 complete -c starci -n '__starci_needs_verb runtime' -a 'version' -d 'print the runtime package version'
 complete -c starci -n '__starci_needs_verb smoke' -a 'scaffold' -d 'scaffold and prove one full or lite app in an isolated scratch directory'
 complete -c starci -n '__starci_needs_verb supabase' -a 'start' -d 'start the app'\''s Supabase stack after enforcing its isolated port block'
@@ -200,20 +213,22 @@ complete -c starci -n '__starci_needs_verb supabase' -a 'stop' -d 'stop only the
 complete -c starci -n '__starci_needs_verb supervisor' -a 'actions' -d 'list, record, or preview the Supervisor'\''s owed-action audit trail'
 complete -c starci -n '__starci_needs_verb supervisor' -a 'bridge' -d 'inspect and govern cross-workflow dependencies and shared ownership'
 complete -c starci -n '__starci_needs_verb supervisor' -a 'channel' -d 'register, inspect, and answer the Supervisor owner-message channel'
+complete -c starci -n '__starci_needs_verb supervisor' -a 'decide' -d 'answer one item of the Supervisor'\''s menu with one typed choice'
 complete -c starci -n '__starci_needs_verb supervisor' -a 'direct-commits' -d 'find runtime main commits that bypassed the exclusive land gate'
 complete -c starci -n '__starci_needs_verb supervisor' -a 'gate-stability' -d 'compare explicitly selected current gates against accepted work in live workflows'
 complete -c starci -n '__starci_needs_verb supervisor' -a 'gc' -d 'inspect or collect leftover workers, shells, lanes, temp data, leases, and logs'
-complete -c starci -n '__starci_needs_verb supervisor' -a 'land' -d 'run the in-runtime land gate; external land-to-main.sh remains external'
+complete -c starci -n '__starci_needs_verb supervisor' -a 'land' -d 'run the in-runtime land gate; it fast-forwards local main and never pushes'
 complete -c starci -n '__starci_needs_verb supervisor' -a 'lesson-actions' -d 'land, revert, or propose changes from the Supervisor self-learning loop'
 complete -c starci -n '__starci_needs_verb supervisor' -a 'notify' -d 'deliver a durable Supervisor ruling to one workflow Kernel'
 complete -c starci -n '__starci_needs_verb supervisor' -a 'owed' -d 'inspect and acknowledge work that running workflows owe the Supervisor'
 complete -c starci -n '__starci_needs_verb supervisor' -a 'poll' -d 'stream or print a read-only Supervisor digest of workflow progress and blockers'
 complete -c starci -n '__starci_needs_verb supervisor' -a 'push' -d 'run full repository suites and push clean main branches'
-complete -c starci -n '__starci_needs_verb supervisor' -a 'push-mains' -d 'scan and push main for the runtime and configured product repositories'
+complete -c starci -n '__starci_needs_verb supervisor' -a 'push-mains' -d 'scan and push main for the configured product repositories (not the runtime)'
 complete -c starci -n '__starci_needs_verb supervisor' -a 'ram-cap' -d 'inspect or override RAM-aware workflow dispatch priorities'
 complete -c starci -n '__starci_needs_verb supervisor' -a 'report' -d 'render or send the owner'\''s detailed workflow progress report'
+complete -c starci -n '__starci_needs_verb supervisor' -a 'revision-ack' -d 'read the files a runtime revision change sends to the Supervisor and attest them'
 complete -c starci -n '__starci_needs_verb supervisor' -a 'start' -d 'enable and start the one long-lived Supervisor seat'
-complete -c starci -n '__starci_needs_verb supervisor' -a 'status' -d 'print whether the Supervisor seat is enabled and healthy'
+complete -c starci -n '__starci_needs_verb supervisor' -a 'status' -d 'print the Supervisor seat status and its menu of open judgment points'
 complete -c starci -n '__starci_needs_verb supervisor' -a 'stop' -d 'disable the Supervisor seat, stop its worker and release it'
 complete -c starci -n '__starci_needs_verb supervisor' -a 'telegram-bridge' -d 'start, run, inspect, or stop the Supervisor Telegram bridge'
 complete -c starci -n '__starci_needs_verb supervisor' -a 'tell' -d 'send a desktop message to the Supervisor or read its recent replies'
@@ -222,16 +237,18 @@ complete -c starci -n '__starci_needs_verb supervisor' -a 'workers' -d 'create,
 complete -c starci -n '__starci_needs_verb task' -a 'list' -d 'list state, runs, results and actions for registered runtime tasks'
 complete -c starci -n '__starci_needs_verb task' -a 'register' -d 'print or apply one runtime scheduled-task registration'
 complete -c starci -n '__starci_needs_verb task' -a 'show' -d 'show state, runs, result and action for one runtime scheduled task'
+complete -c starci -n '__starci_needs_verb test' -a 'affected' -d 'the specs related to the changed functions (--by file: every importer); --run runs each once'
 complete -c starci -n '__starci_needs_verb test' -a 'run' -d 'run the specs selected for one local ladder level'
 complete -c starci -n '__starci_needs_verb typecheck' -a 'run' -d 'check changed runtime modules or affected TypeScript projects'
 complete -c starci -n '__starci_needs_verb uat' -a 'assisted-runner' -d 'inspect and run a prepared assisted UAT request'
-complete -c starci -n '__starci_needs_verb uat' -a 'slots' -d 'inspect UAT slots or run a command while holding one'
+complete -c starci -n '__starci_needs_verb uat' -a 'slots' -d 'inspect UAT slots, end the ones whose lessee is gone, or run a command while holding one'
 complete -c starci -n '__starci_needs_verb work' -a 'asset-slot' -d 'list or check asset slots in Work records'
 complete -c starci -n '__starci_needs_verb work' -a 'brand' -d 'derive or verify the canonical brand Work record'
 complete -c starci -n '__starci_needs_verb work' -a 'brand-direction' -d 'inspect, ask for, or apply owner review of a brand direction'
 complete -c starci -n '__starci_needs_verb work' -a 'brand-palette' -d 'emit a brand palette prompt or check rendered images against it'
 complete -c starci -n '__starci_needs_verb work' -a 'check-example-work' -d 'check the layout, ids, refs and evidence of every example Work tree'
 complete -c starci -n '__starci_needs_verb work' -a 'compose-direction' -d 'place drawn content into its measured page or overlay shell'
+complete -c starci -n '__starci_needs_verb work' -a 'decision-critic' -d 'judge a decision leg with the Critic and write a verdict (debug aid; settle ignores it)'
 complete -c starci -n '__starci_needs_verb work' -a 'draw-acceptance' -d 'verify that drawn assets are accepted render shapes'
 complete -c starci -n '__starci_needs_verb work' -a 'draw-dna' -d 'compare a rendered drawing with grammar DNA'
 complete -c starci -n '__starci_needs_verb work' -a 'draw-feedback' -d 'build, inspect, check, or classify drawing feedback'
@@ -255,6 +272,8 @@ complete -c starci -n '__starci_needs_verb work' -a 'grammar-proposal' -d 'list
 complete -c starci -n '__starci_needs_verb work' -a 'grammar-registry-pin' -d 'check a frontend grammar dependency against the registry pin'
 complete -c starci -n '__starci_needs_verb work' -a 'graph' -d 'inspect, validate, diff or propose a workflow work graph'
 complete -c starci -n '__starci_needs_verb work' -a 'hygiene' -d 'parse, scope-validate and secret-check Work and stack files before they are committed'
+complete -c starci -n '__starci_needs_verb work' -a 'imagegen' -d 'generate images headlessly on the imagegen call tier and write them with a receipt'
+complete -c starci -n '__starci_needs_verb work' -a 'layout-render' -d 'serve the product app and capture one layout in a real browser with its page slot keyed'
 complete -c starci -n '__starci_needs_verb work' -a 'layout-tree' -d 'scan, capture, plan, lock, or inspect a product layout tree'
 complete -c starci -n '__starci_needs_verb work' -a 'render-proof' -d 'render a proof document for one Work record'
 complete -c starci -n '__starci_needs_verb work' -a 'shell-conformance' -d 'check Work and implementation records against the measured frontend shell'
@@ -268,8 +287,10 @@ complete -c starci -n '__starci_needs_verb worker' -a 'start' -d 'start one supe
 complete -c starci -n '__starci_needs_verb worker' -a 'stop' -d 'stop a supervised worker that Orca still reports as working'
 complete -c starci -n '__starci_needs_verb workflow' -a 'assess' -d 'cold-scan repositories for goal-definition evidence'
 complete -c starci -n '__starci_needs_verb workflow' -a 'bias' -d 'normalize a routing bias or extract one from the owner'\''s text'
+complete -c starci -n '__starci_needs_verb workflow' -a 'custody' -d 'show a workflow tree against its branch and preserved work; --apply moves it onto them'
 complete -c starci -n '__starci_needs_verb workflow' -a 'define' -d 'define a goal — assess the prompt, plan the op chain, queue it in the ledger inbox'
-complete -c starci -n '__starci_needs_verb workflow' -a 'start' -d 'ensure the host and optional core maintenance, then claim an approved goal and boot its Kernel'
+complete -c starci -n '__starci_needs_verb workflow' -a 'purge' -d 'remove what an archived workflow left on the host (plan by default)'
+complete -c starci -n '__starci_needs_verb workflow' -a 'start' -d 'ensure the host, then claim an approved goal and boot its Kernel'
 complete -c starci -n '__starci_needs_verb workflow' -a 'status' -d 'the workflow projection — phase, frontier, leases and pending owner asks'
 complete -c starci -n '__starci_needs_verb workflow' -a 'stop' -d 'stop a workflow — archive it, drop open jobs and retire its asks (the owner stop)'
 complete -c starci -n '__starci_needs_verb completion' -a 'bash'
@@ -352,14 +373,10 @@ complete -c starci -n '__starci_using_command connect telegram-media' -l verdict
 complete -c starci -n '__starci_using_command connect telegram-media' -l dispatch -r -d 'dispatch id of the job attempt'
 complete -c starci -n '__starci_using_command connect tunnel' -l port -r -d 'gateway port the tunnel forwards to (default: connectors.gateway.port)'
 complete -c starci -n '__starci_using_command connect tunnel' -l fast -d 'status only - skip the process-table scan for extra tunnel managers'
-complete -c starci -n '__starci_using_command debug pass' -l dispatch -r -d 'immutable native maintenance Dispatch that fences a worker pass'
-complete -c starci -n '__starci_using_command debug pass' -l snapshot -r -d 'saved core-watch snapshot for a pass'
-complete -c starci -n '__starci_using_command debug pass' -l child-timeout -r -d 'child call timeout in seconds'
-complete -c starci -n '__starci_using_command debug pass' -l token-window -r -d 'token-spike window in minutes'
-complete -c starci -n '__starci_using_command debug pass' -l token-spike -r -d 'token count that raises an alert'
-complete -c starci -n '__starci_using_command debug pass' -l key -r -d 'debug alert key'
-complete -c starci -n '__starci_using_command debug pass' -l lane -r -d 'lane fixing the alert'
-complete -c starci -n '__starci_using_command debug pass' -l reason -r -d 'reason no core fix is owed'
+complete -c starci -n '__starci_using_command debug digest' -l repo -r -d 'ledger-owner repository path to include (default every active ledger)'
+complete -c starci -n '__starci_using_command debug digest' -l workflow -r -d 'workflow id to include (default every running workflow)'
+complete -c starci -n '__starci_using_command debug digest' -l questions -d 'list every debug question with its answer or the signal it still needs'
+complete -c starci -n '__starci_using_command debug digest' -l child-timeout -r -d 'timeout in seconds of each read verb the digest calls'
 complete -c starci -n '__starci_using_command debug run' -l repo -r -d 'product ledger owner path for model-scorecard'
 complete -c starci -n '__starci_using_command debug run' -l since-hours -r -d 'positive model-scorecard window in hours'
 complete -c starci -n '__starci_using_command debug run' -l child-timeout -r -d 'core-watch child call timeout in seconds'
@@ -394,6 +411,11 @@ complete -c starci -n '__starci_using_command gate env-health' -l ready-timeout-
 complete -c starci -n '__starci_using_command gate env-health' -l service -r -d 'service name to register and start'
 complete -c starci -n '__starci_using_command gate env-health' -l url -r -d 'health probe URL for the service'
 complete -c starci -n '__starci_using_command gate hfs-sync' -l repo -r -d 'product repository to check'
+complete -c starci -n '__starci_using_command gate install-sandbox' -l tarball -r -d 'the npm pack tarball of the root package'
+complete -c starci -n '__starci_using_command gate install-sandbox' -l keep -d 'keep the sandbox directory after the run'
+complete -c starci -n '__starci_using_command gate install-sandbox' -l docker -d 'run the proof inside a throwaway Linux container'
+complete -c starci -n '__starci_using_command gate install-sandbox' -l tools -r -d 'directory holding a Linux age-keygen for the container run'
+complete -c starci -n '__starci_using_command gate install-sandbox' -l out -r -d 'write the JSON summary to this file'
 complete -c starci -n '__starci_using_command gate read' -l root -r -d 'application root'
 complete -c starci -n '__starci_using_command gate read' -l touch -r -d 'files the operation will touch'
 complete -c starci -n '__starci_using_command gate read' -l read -r -d 'additional application files read'
@@ -409,6 +431,10 @@ complete -c starci -n '__starci_using_command gate run' -l tests -r -d 'test pat
 complete -c starci -n '__starci_using_command gate run' -l out -r -d 'write the gate report to this file'
 complete -c starci -n '__starci_using_command gate run' -l scope -r -a 'code docs' -d 'gate scope'
 complete -c starci -n '__starci_using_command gate run' -l tree -r -d 'work tree read by the document profile'
+complete -c starci -n '__starci_using_command gate runtime-artifact' -l pack -r -d 'the npm pack --json output file'
+complete -c starci -n '__starci_using_command gate runtime-artifact' -l dir -r -d 'directory holding the tarball'
+complete -c starci -n '__starci_using_command gate runtime-artifact' -l out -r -d 'directory that receives the metadata, inventory and checksum files'
+complete -c starci -n '__starci_using_command gate runtime-artifact' -l root -r -d 'runtime root to read the package identity from'
 complete -c starci -n '__starci_using_command gate sonar' -l key -r -d 'Sonar project key'
 complete -c starci -n '__starci_using_command gate sonar' -l name -r -d 'Sonar project display name'
 complete -c starci -n '__starci_using_command gate sonar' -l with-token -d 'ensure the project token is in custody'
@@ -416,6 +442,7 @@ complete -c starci -n '__starci_using_command gate sonar' -l wait -d 'wait for t
 complete -c starci -n '__starci_using_command gate sonar' -l base -r -d 'base revision for changed-line analysis'
 complete -c starci -n '__starci_using_command gate sonar' -l paths -r -d 'repository paths in the slice'
 complete -c starci -n '__starci_using_command gate sonar' -l project-gate -d 'judge the whole-project quality gate'
+complete -c starci -n '__starci_using_command gate sonar' -l branch -r -d 'read the dashboard of this branch instead of the main branch'
 complete -c starci -n '__starci_using_command gate sonar' -l out -r -d 'write the summary to this file'
 complete -c starci -n '__starci_using_command gate sonar' -l blob -d 'store the summary as a blob'
 complete -c starci -n '__starci_using_command gate sonar' -l log -r -d 'write scanner output to this file'
@@ -428,6 +455,7 @@ complete -c starci -n '__starci_using_command gate sonar' -l keep-slice-project
 complete -c starci -n '__starci_using_command gate sonar' -l declaration -r -d 'stack declaration file'
 complete -c starci -n '__starci_using_command gate sonar' -l host -r -d 'Sonar server URL'
 complete -c starci -n '__starci_using_command gate sonar' -l stack -r -d 'custody stack directory'
+complete -c starci -n '__starci_using_command gate sonar' -l public -d 'up or stop: include the public Cloudflare tunnel (needs CLOUDFLARE_TUNNEL_TOKEN)'
 complete -c starci -n '__starci_using_command gate starcistacks' -l new -d 'check a repository being created by this leg'
 complete -c starci -n '__starci_using_command gate test-world' -l root -r -d 'application root'
 complete -c starci -n '__starci_using_command gate test-world' -l project -r -a 'e2e integration contract' -d 'test-world project'
@@ -450,6 +478,7 @@ complete -c starci -n '__starci_using_command git land' -l verified -r -d 'an ea
 complete -c starci -n '__starci_using_command git land' -l verified-log -r -d 'the earlier verification log whose prior-red specs must rerun'
 complete -c starci -n '__starci_using_command git land' -l dry-run -d 'run every verification step but stop before local main moves'
 complete -c starci -n '__starci_using_command git land' -l lane -r -d 'the workflow or lane id recorded in the human result'
+complete -c starci -n '__starci_using_command git land' -l kernel-note -r -d 'one line, what a Kernel must do differently after this land; the land record carries it and the runtime delivers it verbatim with the Kernels'\'' next wake (absent: no line)'
 complete -c starci -n '__starci_using_command git land' -l concurrency -r -d 'dependent spec file concurrency'
 complete -c starci -n '__starci_using_command git sync' -l main-ref -r -d 'the local main ref to merge'
 complete -c starci -n '__starci_using_command git sync' -l dry-run -d 'inspect the merge with merge-tree without changing the worktree'
@@ -516,6 +545,12 @@ complete -c starci -n '__starci_using_command kernel decide' -l close -r -d 'id
 complete -c starci -n '__starci_using_command kernel decide' -l result -r -a 'keep revert' -d 'verdict of the close (needs --observed)'
 complete -c starci -n '__starci_using_command kernel decide' -l observed -r -d 'what the metric showed (close)'
 complete -c starci -n '__starci_using_command kernel decide' -l list -d 'list the decisions of the workflow'
+complete -c starci -n '__starci_using_command kernel decide' -l item -r -d 'id of the menu item to answer (starci kernel status menu[].id)'
+complete -c starci -n '__starci_using_command kernel decide' -l choice -r -d 'the option of that item to take (menu[].options[].choice, or none-fits)'
+complete -c starci -n '__starci_using_command kernel decide' -l reason -r -d 'why this choice; recorded in the decision log (required with --item)'
+complete -c starci -n '__starci_using_command kernel decide' -l text -r -d 'the free-text input the chosen option names (its text field), e.g. the answer to a worker question'
+complete -c starci -n '__starci_using_command kernel decide' -l evidence -r -d 'comma list of refs (ledger rows, events, files) the choice rests on'
+complete -c starci -n '__starci_using_command kernel decisions' -l field -r -d 'comma list of dotted paths of the answer; prints only those fields as JSON'
 complete -c starci -n '__starci_using_command kernel decisions' -l repo -r -d 'managed repository whose .starciwork ledger the command uses'
 complete -c starci -n '__starci_using_command kernel decisions' -l workflow -r -d 'workflow id (required except for --claim, --resolve, --escalate)'
 complete -c starci -n '__starci_using_command kernel decisions' -l list -d 'list the live Decision Items (default)'
@@ -571,6 +606,7 @@ complete -c starci -n '__starci_using_command kernel enqueue' -l after -r -d 'co
 complete -c starci -n '__starci_using_command kernel enqueue' -l foundation -r -d 'shared foundation this unit builds'
 complete -c starci -n '__starci_using_command kernel enqueue' -l new-module -r -d 'comma list of module root dirs the grant creates'
 complete -c starci -n '__starci_using_command kernel enqueue' -l retry-of -r -d 'job this one retries'
+complete -c starci -n '__starci_using_command kernel enqueue' -l switch-agent -d 'with --retry-of, the agent pool of the attempt being retried is demoted for this retry (the route table runs it on another eligible pool); a Kernel'\''s choice to replace the agent'
 complete -c starci -n '__starci_using_command kernel enqueue' -l reopen -r -d 'reason a settled unit is reopened'
 complete -c starci -n '__starci_using_command kernel enqueue' -l derived-from -r -d 'comma list of job ids this unit derives from'
 complete -c starci -n '__starci_using_command kernel enqueue' -l canon-scan -r -d 'canon scan file of a canon slice'
@@ -632,6 +668,14 @@ complete -c starci -n '__starci_using_command kernel incident' -l kind -r -d 'in
 complete -c starci -n '__starci_using_command kernel incident' -l detail -r -d 'what happened (raise; optional on resolve and attach)'
 complete -c starci -n '__starci_using_command kernel incident' -l op -r -d 'op the incident concerns'
 complete -c starci -n '__starci_using_command kernel incident' -l holds -r -d 'comma list of op or job ids the incident holds'
+complete -c starci -n '__starci_using_command kernel incident' -l cause -r -d 'the cause class of a supervisor-gate (op-incident-policy gateCauses): no-eligible-agent, plan-divergence, runtime-defect, retry-cap or budget'
+complete -c starci -n '__starci_using_command kernel incident' -l workaround -r -d 'a supervisor-gate: the workaround of its cause class that you tried, and what came of it'
+complete -c starci -n '__starci_using_command kernel incident' -l no-workaround -r -d 'a supervisor-gate: the typed reason from the cause class'\''s list that there is no workaround (chain-spent, answer-not-reversible, no-route-avoids-defect, ...)'
+complete -c starci -n '__starci_using_command kernel incident' -l because -r -d 'a supervisor-gate: the evidence behind --no-workaround'
+complete -c starci -n '__starci_using_command kernel incident' -l evidence -r -d 'a supervisor-gate raised again for a cause the Supervisor answered not-runtime-fault: the new evidence'
+complete -c starci -n '__starci_using_command kernel incident' -l resolution -r -a 'fixed workaround not-runtime-fault' -d 'the Supervisor'\''s typed answer to a supervisor-gate with --resolve --by supervisor'
+complete -c starci -n '__starci_using_command kernel incident' -l commit -r -d '--resolution fixed: the runtime fix commit; the gate resolves when the live runtime contains it'
+complete -c starci -n '__starci_using_command kernel incident' -l route -r -d '--resolution workaround: the pool the Kernel dispatches the held job with'
 complete -c starci -n '__starci_using_command kernel incident' -l peer -r -d 'workflow waited on (--kind peer-wait)'
 complete -c starci -n '__starci_using_command kernel incident' -l refs -r -d 'comma list of refs of the wait (--kind peer-wait)'
 complete -c starci -n '__starci_using_command kernel incident' -l resolve -r -d 'id of the incident to resolve'
@@ -648,10 +692,14 @@ complete -c starci -n '__starci_using_command kernel incident' -l until-commit -
 complete -c starci -n '__starci_using_command kernel incident' -l until-incident -r -d 'release when the incident resolves: <id>[:resolved]'
 complete -c starci -n '__starci_using_command kernel incident' -l until-foundation -r -d 'release when the foundation lands: <name>'
 complete -c starci -n '__starci_using_command kernel incident' -l until-landed -r -d 'release when the workflow lands its product: <workflowId>@<repository>'
+complete -c starci -n '__starci_using_command kernel incident' -l until-runtime-has -r -d 'release when the live runtime contains the fix commit: <commit>'
+complete -c starci -n '__starci_using_command kernel incident' -l until-admission -r -d 'release when no provider receipt of the job'\''s attempt scope holds a slot: <jobId>'
+complete -c starci -n '__starci_using_command kernel incident' -l until-check -r -d 'release when the Kernel-recorded run of the check is green: <jobId>:<checkName>'
 complete -c starci -n '__starci_using_command kernel kernel-ack-rev' -l repo -r -d 'managed repository whose .starciwork ledger the command uses'
 complete -c starci -n '__starci_using_command kernel kernel-ack-rev' -l workflow -r -d 'workflow id'
 complete -c starci -n '__starci_using_command kernel kernel-ack-rev' -l rev -r -d 'exact current Git SHA or installed required-byte revision returned by --plan'
 complete -c starci -n '__starci_using_command kernel kernel-ack-rev' -l plan -d 'return the current server-derived required manifest without acknowledgement'
+complete -c starci -n '__starci_using_command kernel kernel-ack-rev' -l digest -r -d 'the readToken --plan returned, after every path it lists was read (no file needed)'
 complete -c starci -n '__starci_using_command kernel kernel-ack-rev' -l read-manifest -r -d 'regular JSON file containing the exact complete manifest read by this Kernel'
 complete -c starci -n '__starci_using_command kernel kernel-ack-rev' -l op -r -d 'include this declared upcoming op contract in the required READ set'
 complete -c starci -n '__starci_using_command kernel kernel-proposal' -l repo -r -d 'managed repository whose .starciwork ledger the command uses'
@@ -679,6 +727,7 @@ complete -c starci -n '__starci_using_command kernel log' -l refs -r -d 'comma l
 complete -c starci -n '__starci_using_command kernel log' -l level -r -a 'info warn error' -d 'row level (default by kind)'
 complete -c starci -n '__starci_using_command kernel log' -l node -r -d 'work-graph node the row is about'
 complete -c starci -n '__starci_using_command kernel log' -l actor -r -a 'kernel runtime check land' -d 'actor the row speaks for (an op always logs as op)'
+complete -c starci -n '__starci_using_command kernel logs' -l field -r -d 'comma list of dotted paths of the answer; prints only those fields as JSON'
 complete -c starci -n '__starci_using_command kernel logs' -l repo -r -d 'managed repository whose .starciwork ledger the command uses'
 complete -c starci -n '__starci_using_command kernel logs' -l workflow -r -d 'workflow id'
 complete -c starci -n '__starci_using_command kernel logs' -l job -r -d 'only this job'
@@ -744,6 +793,7 @@ complete -c starci -n '__starci_using_command kernel reconcile' -l dead-worker -
 complete -c starci -n '__starci_using_command kernel reconcile' -l settle-failed -d 'with --dead-worker, settle the job failed instead of requeueing it'
 complete -c starci -n '__starci_using_command kernel reconcile' -l no-salvage -d 'with --dead-worker, skip filing a report the dead worker wrote but never filed'
 complete -c starci -n '__starci_using_command kernel reconcile' -l release-worker -d 'release the worker of a job whose settle is held, keeping the job for its settle'
+complete -c starci -n '__starci_using_command kernel reconcile' -l route-failure -d 'take the next step of a failed or blocked job that nothing follows (the Job controller runs it)'
 complete -c starci -n '__starci_using_command kernel reconcile' -l orphan-kernel-jobs -d 'cancel the kernel jobs of finished or archived workflows'
 complete -c starci -n '__starci_using_command kernel reconcile' -l workflow -r -d 'with --orphan-kernel-jobs, limit to one workflow'
 complete -c starci -n '__starci_using_command kernel reconcile' -l dry-run -d 'with --orphan-kernel-jobs, list what would be cancelled without writing'
@@ -778,11 +828,18 @@ complete -c starci -n '__starci_using_command kernel report' -l job -r -d 'job t
 complete -c starci -n '__starci_using_command kernel report' -l report -r -d 'report JSON file inside the attempt'\''s scratch (starci/op-report@1)'
 complete -c starci -n '__starci_using_command kernel report' -l attach -r -d 'attachment file inside the scratch; repeat the flag for each file'
 complete -c starci -n '__starci_using_command kernel report' -l outcome -r -a 'done partial failed ask blocked' -d 'the outcome the report must carry; refused when the envelope says otherwise'
-complete -c starci -n '__starci_using_command kernel report' -l dispatch-capability -r -d 'the dispatch capability from the Orca preamble, authenticating the worker_done message'
+complete -c starci -n '__starci_using_command kernel report' -l dispatch-capability -r -d 'the dispatch capability of the Orca preamble when it carries one, forwarded with the worker_done message'
 complete -c starci -n '__starci_using_command kernel retire-ask' -l repo -r -d 'managed repository whose .starciwork ledger the command uses'
 complete -c starci -n '__starci_using_command kernel retire-ask' -l workflow -r -d 'workflow that owns the ask'
 complete -c starci -n '__starci_using_command kernel retire-ask' -l dispatch -r -d 'dispatch id of the ask report to retire'
 complete -c starci -n '__starci_using_command kernel retire-ask' -l reason -r -d 'why the owner should no longer answer it, recorded on the ask-superseded event'
+complete -c starci -n '__starci_using_command kernel revision-ack' -l repo -r -d 'managed repository whose .starciwork ledger the command uses'
+complete -c starci -n '__starci_using_command kernel revision-ack' -l workflow -r -d 'workflow id'
+complete -c starci -n '__starci_using_command kernel revision-ack' -l rev -r -d 'exact current Git SHA or installed required-byte revision returned by --plan'
+complete -c starci -n '__starci_using_command kernel revision-ack' -l plan -d 'return the current server-derived required manifest without acknowledgement'
+complete -c starci -n '__starci_using_command kernel revision-ack' -l digest -r -d 'the readToken --plan returned, after every path it lists was read (no file needed)'
+complete -c starci -n '__starci_using_command kernel revision-ack' -l read-manifest -r -d 'regular JSON file containing the exact complete manifest read by this Kernel'
+complete -c starci -n '__starci_using_command kernel revision-ack' -l op -r -d 'include this declared upcoming op contract in the required READ set'
 complete -c starci -n '__starci_using_command kernel route' -l repo -r -d 'managed repository whose .starciwork ledger the command uses'
 complete -c starci -n '__starci_using_command kernel route' -l job -r -d 'queued job to route'
 complete -c starci -n '__starci_using_command kernel route' -l difficulty -r -a 'easy medium hard insane' -d 'difficulty tier overriding the job'\''s own (medium when it carries none)'
@@ -804,8 +861,11 @@ complete -c starci -n '__starci_using_command kernel settle' -l report -r -d 'ig
 complete -c starci -n '__starci_using_command kernel settle' -l sync-tail -d 'run the settle tail inline instead of detached'
 complete -c starci -n '__starci_using_command kernel settle-tail' -l repo -r -d 'managed repository whose .starciwork ledger the command uses'
 complete -c starci -n '__starci_using_command kernel settle-tail' -l job -r -d 'settled job whose queued tail runs'
+complete -c starci -n '__starci_using_command kernel status' -l field -r -d 'comma list of dotted paths of the answer; prints only those fields as JSON'
+complete -c starci -n '__starci_using_command kernel status' -l full -d 'the whole text view (every section; the legs line tags each leg [judge:...] with who judges its product, the judge field of its op contract); the Kernel seat'\''s own call prints its one-line state and its Decide section by default'
 complete -c starci -n '__starci_using_command kernel status' -l repo -r -d 'managed repository whose .starciwork ledger the command uses'
 complete -c starci -n '__starci_using_command kernel status' -l workflow -r -d 'workflow to project'
+complete -c starci -n '__starci_using_command kernel survey' -l field -r -d 'comma list of dotted paths of the answer; prints only those fields as JSON'
 complete -c starci -n '__starci_using_command kernel survey' -l repo -r -d 'managed repository whose .starciwork ledger the command uses'
 complete -c starci -n '__starci_using_command kernel survey' -l workflow -r -d 'workflow to survey'
 complete -c starci -n '__starci_using_command kernel survey' -l deliveries -d 'add the settled jobs, pending credentials and handover asks'
@@ -879,22 +939,29 @@ complete -c starci -n '__starci_using_command reconciler once' -l controller -r
 complete -c starci -n '__starci_using_command reconciler once' -l key -r -d 'reconcile only this key'
 complete -c starci -n '__starci_using_command reconciler once' -l apply -d 'take the lead and apply the actions instead of planning them; refused while another leader is live'
 complete -c starci -n '__starci_using_command reconciler up' -l check -d 'run one read-only checklist pass'
+complete -c starci -n '__starci_using_command reconciler up' -l services -d 'heal only the no-quota host services (launcher shim, the three Windows tasks, UI build, engine, harness UI and tunnel, ask gateway and tunnel) and never launch an agent seat'
+complete -c starci -n '__starci_using_command reconciler up' -l brief -d 'print the compact status (one line per row that is not green, or one all-green line) instead of the full checklist'
 complete -c starci -n '__starci_using_command reconciler up' -l wait -r -d 'seconds to wait for the checklist to become green'
 complete -c starci -n '__starci_using_command reconciler up' -l no-build -d 'do not rebuild a stale harness UI'
 complete -c starci -n '__starci_using_command reconciler up' -l retire-stale-ledgers -d 'retire registered ledgers that point at temporary test paths'
 complete -c starci -n '__starci_using_command reconciler up' -l set-profile -r -a 'operational observe' -d 'update the reconciler profile before bringing services up'
-complete -c starci -n '__starci_using_command reconciler up' -l caller-agent -r -a 'codex claude devin' -d 'declared ingress agent for optional core maintenance; does not change the Supervisor pin'
-complete -c starci -n '__starci_using_command reconciler up' -l caller-model -r -d 'declared concrete ingress model for optional core maintenance; actual worker attestation is required'
-complete -c starci -n '__starci_using_command reconciler up' -l caller-effort -r -d 'declared ingress effort for optional core maintenance'
 complete -c starci -n '__starci_using_command release app-installs' -l keep -d 'keep and print the temporary application path'
 complete -c starci -n '__starci_using_command release check' -l final -d 'include final identity and main-branch proofs'
 complete -c starci -n '__starci_using_command release check' -l only -r -d 'comma-separated proof ids to run'
+complete -c starci -n '__starci_using_command release ci-status' -l repo -r -d 'the repository released (default is the current directory)'
+complete -c starci -n '__starci_using_command release ci-status' -l tag -r -d 'the release tag v* whose commit is read (default is the newest release tag merged in HEAD)'
+complete -c starci -n '__starci_using_command release ci-status' -l wait -d 'poll until the run ends (modules/supervisor/release-cut.yaml suite.ci pollSeconds, waitMinutes)'
 complete -c starci -n '__starci_using_command release clean-test' -l changed -r -d 'changed paths selecting affected packages (space-separated or repeated; no comma lists)'
 complete -c starci -n '__starci_using_command release clean-test' -l base -r -d 'revision whose changes select affected packages'
-complete -c starci -n '__starci_using_command release cut' -l repo -r -d 'the repository to release (default is the current directory)'
+complete -c starci -n '__starci_using_command release cut' -l repo -r -d 'the repository to release (default: the runtime this command runs from, not the directory it is started in)'
 complete -c starci -n '__starci_using_command release cut' -l remote -r -d 'the remote to push to (default origin)'
 complete -c starci -n '__starci_using_command release cut' -l branch -r -d 'the release branch (default main)'
+complete -c starci -n '__starci_using_command release cut' -l plan -d 'report what the cut would run and require, and stop; it runs nothing'
 complete -c starci -n '__starci_using_command release cut' -l tag -r -d 'the release tag v* to push (default is the one new annotated v* tag on HEAD)'
+complete -c starci -n '__starci_using_command release cut' -l rows -r -d 're-run only these rows (comma separated, names as --plan lists them) on the SAME commit and complete the record when every other row is already green on it; a row that is not green there refuses the cut'
+complete -c starci -n '__starci_using_command release cut' -l no-reuse -d 'run every row; stand in for none from an earlier commit or an earlier cut of this one'
+complete -c starci -n '__starci_using_command release env-test' -l lane -d 'a lane clone is no Orca terminal: leave out STARCI_REQUIRE_ORCA_LIVE and the host check, keep everything else of the cut'
+complete -c starci -n '__starci_using_command release env-test' -l reuse-installs -d 'keep an example app whose node_modules exists instead of a fresh npm ci'
 complete -c starci -n '__starci_using_command release images' -l app -r -d 'app root to prove (default is the current directory)'
 complete -c starci -n '__starci_using_command release images' -l sides -r -d 'selected sides, each be or fe (default both)'
 complete -c starci -n '__starci_using_command release images' -l only -r -d 'selected application names'
@@ -905,10 +972,14 @@ complete -c starci -n '__starci_using_command release launch-smoke' -l entry -r
 complete -c starci -n '__starci_using_command release launch-smoke' -l timeout-ms -r -d 'smoke deadline in milliseconds'
 complete -c starci -n '__starci_using_command release launch-smoke' -l out -r -d 'write the smoke result to this file'
 complete -c starci -n '__starci_using_command release launch-smoke' -l as -r -a 'supervisor worker kernel op opFe opFail critic' -d 'internal smoke role for stage or mark'
+complete -c starci -n '__starci_using_command release notes' -l tag -r -d 'the release tag v<version> whose CHANGELOG section is read'
+complete -c starci -n '__starci_using_command release notes' -l repo -r -d 'the repository holding CHANGELOG.md (default: the runtime this command runs from, not the directory it is started in)'
+complete -c starci -n '__starci_using_command release notes' -l out -r -d 'write the notes to this file instead of printing them'
 complete -c starci -n '__starci_using_command release proof' -l repo -r -d 'released repository'
 complete -c starci -n '__starci_using_command release proof' -l base -r -d 'first commit of the release range'
 complete -c starci -n '__starci_using_command release proof' -l main -r -d 'main reference used by the merge guard'
 complete -c starci -n '__starci_using_command release proof' -l out -r -d 'write the proof to this file'
+complete -c starci -n '__starci_using_command release publish' -l plan -d 'explicitly print the read-only publication plan (the default)'
 complete -c starci -n '__starci_using_command release publish' -l publish -d 'perform the plan instead of reading it'
 complete -c starci -n '__starci_using_command release publish' -l runtime-package -d 'publish the final root runtime after the package phase and committed binding refresh'
 complete -c starci -n '__starci_using_command release publish' -l npm-user -r -d 'required logged-in npm account for publication'
@@ -924,11 +995,14 @@ complete -c starci -n '__starci_using_command route op' -l phase -r -d 'workflow
 complete -c starci -n '__starci_using_command route op' -l intent -r -d 'intent term; comma list or repeatable'
 complete -c starci -n '__starci_using_command route op' -l ops-dir -r -d 'operation catalog directory (default is modules/ops)'
 complete -c starci -n '__starci_using_command runtime architecture' -l base -r -d 'first commit of the range to judge (default the whole tree)'
+complete -c starci -n '__starci_using_command runtime artefacts' -l migrate -d 'rewrite every stale artefact to the revision of this tree and verify the stamp'
 complete -c starci -n '__starci_using_command runtime benchmark-snapshot' -l since-hours -r -d 'positive scorecard window in hours'
 complete -c starci -n '__starci_using_command runtime benchmark-snapshot' -l repo -r -d 'product ledger owner path'
 complete -c starci -n '__starci_using_command runtime benchmark-snapshot' -l date -r -d 'snapshot date as YYYY-MM-DD'
 complete -c starci -n '__starci_using_command runtime benchmark-snapshot' -l dir -r -d 'snapshot output directory'
 complete -c starci -n '__starci_using_command runtime check' -l only -r -d 'run one named check; arguments after -- pass through unchanged'
+complete -c starci -n '__starci_using_command runtime deploy' -l from -r -d 'a clone directory (its HEAD is the revision) or a ref of the host repository'
+complete -c starci -n '__starci_using_command runtime deploy' -l plan -d 'print every step and every refusal without changing anything'
 complete -c starci -n '__starci_using_command runtime derived-fields' -l write -d 'rewrite the stale output in place'
 complete -c starci -n '__starci_using_command runtime derived-fields' -l check -d 'list the stale output (the default)'
 complete -c starci -n '__starci_using_command runtime doctor' -l quick -d 'check install integrity without runtime capability checks'
@@ -941,6 +1015,8 @@ complete -c starci -n '__starci_using_command runtime gen-ops' -l out -r -d 'reg
 complete -c starci -n '__starci_using_command runtime housekeeping' -l dry-run -d 'explicitly select the default non-mutating sweep'
 complete -c starci -n '__starci_using_command runtime housekeeping' -l apply -d 'apply archive moves and removals'
 complete -c starci -n '__starci_using_command runtime housekeeping' -l only -r -d 'comma-separated housekeeping area names'
+complete -c starci -n '__starci_using_command runtime import-held-secret' -l member -r -d 'the old tracked path of the member (the table of docs/host-secrets.md)'
+complete -c starci -n '__starci_using_command runtime import-held-secret' -l rev -r -d 'the revision that still holds the member; default the parent of the commit that deleted it'
 complete -c starci -n '__starci_using_command runtime install' -l force -d 'replace a .claude the installer did not write / take package versions over local edits'
 complete -c starci -n '__starci_using_command runtime install' -l hosts -r -d 'comma list of extra bootstrap files — claude,devin or all (AGENTS.md is always written)'
 complete -c starci -n '__starci_using_command runtime install' -l no-bootstrap -d 'leave the host AGENTS.md/.gitignore untouched'
@@ -958,11 +1034,16 @@ complete -c starci -n '__starci_using_command runtime owner-claims-audit' -l rep
 complete -c starci -n '__starci_using_command runtime owner-claims-audit' -l workflow -r -d 'workflow id to audit'
 complete -c starci -n '__starci_using_command runtime readme-blocks' -l write -d 'rewrite the stale output in place'
 complete -c starci -n '__starci_using_command runtime readme-blocks' -l check -d 'list the stale output (the default)'
+complete -c starci -n '__starci_using_command runtime revision-scope' -l from -r -d 'the revision the seats stand at'
+complete -c starci -n '__starci_using_command runtime revision-scope' -l to -r -d 'the revision to deploy; the HEAD of the runtime tree by default'
+complete -c starci -n '__starci_using_command runtime revision-scope' -l root -r -d 'the runtime tree to read'
 complete -c starci -n '__starci_using_command runtime update' -l force -d 'replace files changed locally with the package version'
 complete -c starci -n '__starci_using_command runtime update' -l hosts -r -d 'comma list of extra bootstrap files — claude,devin or all'
 complete -c starci -n '__starci_using_command runtime update' -l no-bootstrap -d 'leave the host AGENTS.md/.gitignore untouched'
 complete -c starci -n '__starci_using_command runtime validate' -l strict -d 'also compile every record against its named JSON schema'
 complete -c starci -n '__starci_using_command runtime validate' -l owned -r -d 'judge only this path slice; out-of-scope refusals move to outOfScope (repeatable)'
+complete -c starci -n '__starci_using_command runtime verify' -l base -r -d 'ref to diff against (default: the merge-base with main, else origin/main)'
+complete -c starci -n '__starci_using_command runtime verify' -l root -r -d 'repository root (default: the command cwd)'
 complete -c starci -n '__starci_using_command smoke scaffold' -l into -r -d 'parent directory for the isolated starci-smoke-* scratch root'
 complete -c starci -n '__starci_using_command smoke scaffold' -l keep -d 'retain the scratch root after the proof'
 complete -c starci -n '__starci_using_command supabase stop' -l no-backup -d 'stop without creating a local database backup'
@@ -1008,6 +1089,10 @@ complete -c starci -n '__starci_using_command supervisor channel' -l text -r -d
 complete -c starci -n '__starci_using_command supervisor channel' -l text-file -r -d 'file containing reply text'
 complete -c starci -n '__starci_using_command supervisor channel' -l to -r -d 'inbox message id to answer'
 complete -c starci -n '__starci_using_command supervisor channel' -l timeout-ms -r -d 'maximum inbox wait in milliseconds'
+complete -c starci -n '__starci_using_command supervisor decide' -l item -r -d 'id of the open menu item, as starci supervisor status prints it'
+complete -c starci -n '__starci_using_command supervisor decide' -l choice -r -d 'the choice of that item to take'
+complete -c starci -n '__starci_using_command supervisor decide' -l reason -r -d 'why this choice, with the evidence: it is the record and the notice'
+complete -c starci -n '__starci_using_command supervisor decide' -l text -r -d 'the input the choice names: a commit, a pool, a ruling, a workflow or a cause slug'
 complete -c starci -n '__starci_using_command supervisor direct-commits' -l repo -r -d 'runtime repository to inspect'
 complete -c starci -n '__starci_using_command supervisor gate-stability' -l family -r -d 'operation family to inspect'
 complete -c starci -n '__starci_using_command supervisor gate-stability' -l tree -r -d 'tree whose gates should run for one side'
@@ -1027,8 +1112,8 @@ complete -c starci -n '__starci_using_command supervisor land' -l specs -r -d 's
 complete -c starci -n '__starci_using_command supervisor land' -l reason -r -d 'reason required when no spec applies'
 complete -c starci -n '__starci_using_command supervisor land' -l full-by-push-git -d 'authorize the full suite from the push flow'
 complete -c starci -n '__starci_using_command supervisor land' -l lane -r -d 'source lane name'
-complete -c starci -n '__starci_using_command supervisor land' -l no-push -d 'leave landed main unpushed'
 complete -c starci -n '__starci_using_command supervisor land' -l notify -d 'file the land outcome in the Supervisor inbox'
+complete -c starci -n '__starci_using_command supervisor land' -l foreground -d 'wait for the land in this process; without it the land runs in a detached child that outlives the caller'\''s command window'
 complete -c starci -n '__starci_using_command supervisor land' -l status -d 'inspect the land queue without landing'
 complete -c starci -n '__starci_using_command supervisor land' -l wait-ms -r -d 'maximum land-queue wait in milliseconds'
 complete -c starci -n '__starci_using_command supervisor lesson-actions' -l signature -r -d 'learned rule signature to land'
@@ -1074,8 +1159,13 @@ complete -c starci -n '__starci_using_command supervisor ram-cap' -l weight -r -
 complete -c starci -n '__starci_using_command supervisor ram-cap' -l reserve -r -d 'dispatch slots reserved for the workflow'
 complete -c starci -n '__starci_using_command supervisor report' -l repo -r -d 'product ledger owner path'
 complete -c starci -n '__starci_using_command supervisor report' -l send -d 'send the report through the configured owner channel'
+complete -c starci -n '__starci_using_command supervisor revision-ack' -l plan -d 'return the files this revision change sends to the Supervisor, with their hashes, without acknowledging'
+complete -c starci -n '__starci_using_command supervisor revision-ack' -l rev -r -d 'exact current Git SHA of the runtime revision the plan names'
+complete -c starci -n '__starci_using_command supervisor revision-ack' -l digest -r -d 'the readToken --plan returned, after every file it lists was read (no file needed)'
+complete -c starci -n '__starci_using_command supervisor revision-ack' -l read-manifest -r -d 'regular JSON file holding the exact manifest --plan returned, after every file in it was read'
 complete -c starci -n '__starci_using_command supervisor start' -l plan -d 'prove the launch plan without starting the seat'
 complete -c starci -n '__starci_using_command supervisor start' -l reason -r -d 'owner reason recorded with the launch'
+complete -c starci -n '__starci_using_command supervisor status' -l menu -d 'print only the menu of open items and the spelling of the decision verb'
 complete -c starci -n '__starci_using_command supervisor tell' -l wait -d 'wait for the Supervisor'\''s reply'
 complete -c starci -n '__starci_using_command supervisor tell' -l timeout-ms -r -d 'reply wait timeout in milliseconds'
 complete -c starci -n '__starci_using_command supervisor tell' -l read -d 'read recent Supervisor replies'
@@ -1101,6 +1191,15 @@ complete -c starci -n '__starci_using_command supervisor workers' -l summary-fil
 complete -c starci -n '__starci_using_command supervisor workers' -l needs -r -d 'comma-separated follow-up needs'
 complete -c starci -n '__starci_using_command supervisor workers' -l reason -r -d 'cancellation or acknowledgement reason'
 complete -c starci -n '__starci_using_command task register' -l apply -d 'register or update the task after reviewing the default output'
+complete -c starci -n '__starci_using_command test affected' -l base -r -d 'ref to diff against (default: the merge-base with main, else origin/main)'
+complete -c starci -n '__starci_using_command test affected' -l changed -r -d 'explicit changed repository paths instead of the diff'
+complete -c starci -n '__starci_using_command test affected' -l by -r -d 'symbol (default: the specs related to the changed functions) or file (every spec importing a changed file)'
+complete -c starci -n '__starci_using_command test affected' -l run -d 'run the selected spec files, one per process, inside the time budget'
+complete -c starci -n '__starci_using_command test affected' -l plan -d 'print the selected files with the reason each is in the set; run nothing'
+complete -c starci -n '__starci_using_command test affected' -l receipt-file -r -d 'with --run, write the receipt to this file; the answer carries its path (a gate reads the file, not the output)'
+complete -c starci -n '__starci_using_command test affected' -l no-cache -d 'run every selected file; ignore the per-spec result cache'
+complete -c starci -n '__starci_using_command test affected' -l concurrency -r -d 'override automatic file concurrency with a positive integer'
+complete -c starci -n '__starci_using_command test affected' -l root -r -d 'repository root (default: the command cwd)'
 complete -c starci -n '__starci_using_command test run' -l level -r -a 'L1 L2 L3 L4' -d 'bounded local test level'
 complete -c starci -n '__starci_using_command test run' -l changed -r -d 'changed repository paths used for L1 selection'
 complete -c starci -n '__starci_using_command test run' -l against -r -d 'local main ref used for L2 and L3 selection'
@@ -1116,6 +1215,7 @@ complete -c starci -n '__starci_using_command uat assisted-runner' -l receipt -r
 complete -c starci -n '__starci_using_command uat assisted-runner' -l after -r -d 'wait until the session revision is past this number'
 complete -c starci -n '__starci_using_command uat assisted-runner' -l value -r -a 'ok fail cancel' -d 'signal to send to the waiting session'
 complete -c starci -n '__starci_using_command uat assisted-runner' -l actor -r -d 'who sends the signal (default is the user)'
+complete -c starci -n '__starci_using_command uat slots' -l dry-run -d 'collect only lists the slots it would end'
 complete -c starci -n '__starci_using_command uat slots' -l record-dir -r -d 'record directory the held slot is recorded in'
 complete -c starci -n '__starci_using_command work brand' -l source -r -d 'repository root of the product the brand colours are compared with'
 complete -c starci -n '__starci_using_command work brand' -l stage -r -a 'decide verify' -d 'brand check stage to run'
@@ -1141,6 +1241,13 @@ complete -c starci -n '__starci_using_command work compose-direction' -l scrim -
 complete -c starci -n '__starci_using_command work compose-direction' -l tool -r -d 'tool name recorded as the composite provenance'
 complete -c starci -n '__starci_using_command work compose-direction' -l prompt -r -d 'prompt text recorded with the composite'
 complete -c starci -n '__starci_using_command work compose-direction' -l out -r -d 'output PNG path (default is beside the content)'
+complete -c starci -n '__starci_using_command work decision-critic' -l kind -r -a 'scope.define business.decide architecture.decide' -d 'the decision leg whose records are judged'
+complete -c starci -n '__starci_using_command work decision-critic' -l root -r -d 'the work root (.starciwork) or the repository that holds it'
+complete -c starci -n '__starci_using_command work decision-critic' -l out -r -d 'the verdict file to write (for a person to read; the settle never reads it)'
+complete -c starci -n '__starci_using_command work decision-critic' -l records -r -d 'comma-separated decision record files or directories to judge; default every decision record of the kind under the work root'
+complete -c starci -n '__starci_using_command work decision-critic' -l input -r -d 'comma-separated extra input files the decision rests on, such as the goal or request text'
+complete -c starci -n '__starci_using_command work decision-critic' -l maker -r -d 'provider that made the records; default the provider of the op running this verb'
+complete -c starci -n '__starci_using_command work decision-critic' -l json -d 'print the outcome as JSON'
 complete -c starci -n '__starci_using_command work draw-acceptance' -l repo -r -d 'product repository root'
 complete -c starci -n '__starci_using_command work draw-acceptance' -l job -r -d 'job id whose report files and owned paths are judged'
 complete -c starci -n '__starci_using_command work draw-acceptance' -l files -r -d 'comma list of bound files to judge instead of a job'
@@ -1247,6 +1354,23 @@ complete -c starci -n '__starci_using_command work graph' -l job -r -d 'op job i
 complete -c starci -n '__starci_using_command work graph' -l reason -r -d 'why the graph changes; propose needs it'
 complete -c starci -n '__starci_using_command work graph' -l slice -r -d 'slice id a cutting job changes'
 complete -c starci -n '__starci_using_command work hygiene' -l repo -r -d 'the product repository (default is the current directory)'
+complete -c starci -n '__starci_using_command work imagegen' -l prompt -r -d 'file holding the image brief, sent verbatim'
+complete -c starci -n '__starci_using_command work imagegen' -l out -r -d 'output directory inside the op'\''s worktree (a record'\''s assets directory)'
+complete -c starci -n '__starci_using_command work imagegen' -l reference -r -d 'reference image (png, jpg or webp); repeatable'
+complete -c starci -n '__starci_using_command work imagegen' -l count -r -d 'number of images, 1 to the call'\''s maxImages (default 1)'
+complete -c starci -n '__starci_using_command work imagegen' -l size -r -d 'requested size WxH, a request the tool may not honour (the receipt records the real size)'
+complete -c starci -n '__starci_using_command work imagegen' -l name -r -d 'file stem of the images (default: the prompt file'\''s name); an existing target is refused'
+complete -c starci -n '__starci_using_command work imagegen' -l stage -r -d 'label of the receipt entries (default final)'
+complete -c starci -n '__starci_using_command work layout-render' -l work -r -d 'the .starciwork root that holds the shell record'
+complete -c starci -n '__starci_using_command work layout-render' -l node -r -d 'layout node id to render'
+complete -c starci -n '__starci_using_command work layout-render' -l breakpoint -r -d 'breakpoint of the capture'
+complete -c starci -n '__starci_using_command work layout-render' -l theme -r -d 'theme of the capture'
+complete -c starci -n '__starci_using_command work layout-render' -l app -r -d 'app name when the shell has several apps'
+complete -c starci -n '__starci_using_command work layout-render' -l route -r -d 'path to load; default the node'\''s url with the locale filled by the product locale'
+complete -c starci -n '__starci_using_command work layout-render' -l locale -r -d 'locale that fills the locale segment of the route'
+complete -c starci -n '__starci_using_command work layout-render' -l slot -r -d 'CSS selector of the page slot, exactly one match; default main'
+complete -c starci -n '__starci_using_command work layout-render' -l out -r -d 'directory for the capture and the server log; default a temp directory'
+complete -c starci -n '__starci_using_command work layout-render' -l write -d 'record the capture in the layout tree as layout-tree capture does'
 complete -c starci -n '__starci_using_command work layout-tree' -l work -r -d 'the .starciwork root that holds the shell record'
 complete -c starci -n '__starci_using_command work layout-tree' -l app-dir -r -d 'frontend app directory to scan; repeatable'
 complete -c starci -n '__starci_using_command work layout-tree' -l write -d 'write the record; without it the command only reports'
@@ -1295,7 +1419,10 @@ complete -c starci -n '__starci_using_command worker start' -l task-title -r -d
 complete -c starci -n '__starci_using_command worker start' -l run -r -d 'Orca Run id (default is the Run bound to this terminal)'
 complete -c starci -n '__starci_using_command worker stop' -l dispatch -r -d 'authoritative Orca Dispatch id'
 complete -c starci -n '__starci_using_command workflow assess' -l repo -r -d 'repository to scan; repeat for several (without --json at least one is required)'
-complete -c starci -n '__starci_using_command workflow bias' -l normalize -r -d 'owner bias JSON: prefer/avoid, role-scoped concrete require and explicit attempt reserveOverride; invalid hard constraints are refused'
+complete -c starci -n '__starci_using_command workflow bias' -l normalize -r -d 'owner bias JSON: prefer/avoid/only member lists (a pool, an agent or agent/model), roles and an explicit attempt reserveOverride; an only list that avoid empties is refused'
+complete -c starci -n '__starci_using_command workflow custody' -l repo -r -d 'repository whose registered project ledger holds the workflow (default: the working directory)'
+complete -c starci -n '__starci_using_command workflow custody' -l workflow -r -d 'the workflow_id'
+complete -c starci -n '__starci_using_command workflow custody' -l apply -d 'move a tree that is behind its branch onto it (its own work preserved), or make a missing one at the branch; refused while an op has a live worker; the admitted attempts whose tree path was lost are rebound to the tree or ended placement-lost'
 complete -c starci -n '__starci_using_command workflow define' -l repo -r -d 'repository whose .starciwork ledger owns the goal (default: the working directory)'
 complete -c starci -n '__starci_using_command workflow define' -l project -r -d 'registered project name; resolves the work.json binding (mutually exclusive with --repo)'
 complete -c starci -n '__starci_using_command workflow define' -l text -r -d 'the owner prompt the goal is defined from'
@@ -1310,12 +1437,15 @@ complete -c starci -n '__starci_using_command workflow define' -l defined-by -r
 complete -c starci -n '__starci_using_command workflow define' -l approved-by -r -a 'supervisor' -d 'supervisor provenance on a revision (bridge)'
 complete -c starci -n '__starci_using_command workflow define' -l bridge-id -r -d 'supervisor bridge key the provenance is bound to'
 complete -c starci -n '__starci_using_command workflow define' -l routing-bias -r -d 'JSON routing bias attached to the workflow payload'
+complete -c starci -n '__starci_using_command workflow purge' -l repo -r -d 'repository whose .starciwork ledger holds the workflow (default: the working directory)'
+complete -c starci -n '__starci_using_command workflow purge' -l workflow -r -d 'the workflow_id of an archived workflow'
+complete -c starci -n '__starci_using_command workflow purge' -l plan -d 'print what would be removed and change nothing (the default)'
+complete -c starci -n '__starci_using_command workflow purge' -l apply -d 'remove the planned set'
+complete -c starci -n '__starci_using_command workflow purge' -l ledger -d 'also archive the workflow'\''s ledger rows to a verified zip and drop them'
+complete -c starci -n '__starci_using_command workflow purge' -l expect -r -d 'with --apply, refuse unless the plan still starts with this sha (12 characters or more)'
 complete -c starci -n '__starci_using_command workflow start' -l repo -r -d 'repository whose registered project ledger holds the goal queue (default: the working directory)'
 complete -c starci -n '__starci_using_command workflow start' -l goal -r -d 'explicit workflow_id to boot instead of the oldest queued'
 complete -c starci -n '__starci_using_command workflow start' -l agent -r -d 'override the routed kernel agent'
-complete -c starci -n '__starci_using_command workflow start' -l caller-agent -r -a 'codex claude devin' -d 'declared ingress agent for core maintenance; separate from the Kernel agent override'
-complete -c starci -n '__starci_using_command workflow start' -l caller-model -r -d 'declared concrete ingress model for core maintenance; the actual worker must attest it'
-complete -c starci -n '__starci_using_command workflow start' -l caller-effort -r -d 'declared ingress effort for core maintenance; does not override Kernel effort'
 complete -c starci -n '__starci_using_command workflow start' -l launched-by -r -a 'watchdog supervisor' -d 'provenance of an automated start'
 complete -c starci -n '__starci_using_command workflow start' -l plan -d 'resolve and report the launch without starting anything'
 complete -c starci -n '__starci_using_command workflow status' -l repo -r -d 'repository whose .starciwork ledger holds the workflow (default: the working directory)'