@starci/cli 1.0.1 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # Changelog
2
2
 
3
+ ## 1.1.0 - 2026-10-08
4
+
5
+ - Changed: the catalog, help and shell completions follow the runtime of 1.0.0-alpha.7 (the release cut refuses early on host prerequisites, `starci release env-test`, the plan of `starci release publish` names every blocker in its json result), and the package depends on `@starci/hfs` 4.1.0.
6
+
3
7
  ## 1.0.0
4
8
 
5
9
  - Introduce the catalog-driven `starci` dispatcher, generated help and shell completions.
@@ -34,7 +34,7 @@ _starci() {
34
34
  'workflow:workflow lifecycle — define a goal, start its kernel, status, stop'
35
35
  'help:show top-level help'
36
36
  'completion:print a shell completion script'
37
- 'explain:show a verb contract and the spellings it replaces'
37
+ 'explain:show a verb contract'
38
38
  )
39
39
  if (( CURRENT == 2 )); then
40
40
  _describe 'group' groups
@@ -43,9 +43,9 @@ _starci() {
43
43
  app) _values 'verbs' 'add[add one canonical backend capability and register its patterns]' 'check[judge the app tree, managed output, contracts, formatting and architecture]' 'emit[emit backend GraphQL, operation and event contract snapshots]' 'explain[explain which HFS slot owns one app-relative path]' 'hygiene[judge staged worktree metadata, stack files and plaintext secrets]' 'lint[lint both app sides and report repository, ESLint and stylelint findings together]' 'new[create a canonical service, unit spec or app image definition]' 'scaffold[create a full or lite StarCi app, including an empty unborn main Git repository]' 'secret[list, read, seal or generate an encrypted app secret]' 'stack[start, stop or inspect the shared local test-world infrastructure]' 'sync[compare or write every managed app file from its canonical template]' 'upgrade[upgrade a lite app to the full edition (--edition full); a full app is already current]' ;;
44
44
  check) _values 'verbs' 'run[run changed-scope checks or the full structural check set]' ;;
45
45
  connect) _values 'verbs' 'ask-gateway[operate the local owner-ask HTTP gateway]' 'telegram[deliver and maintain owner Telegram notifications]' 'telegram-media[deliver settled operation media through Telegram]' 'tunnel[operate the Cloudflare owner-ask tunnel]' ;;
46
- debug) _values 'verbs' 'pass[inspect core health and maintain diagnostic custody in the machine ledger]' 'run[run one allowlisted read-only runtime inspector]' ;;
46
+ debug) _values 'verbs' 'digest[print the read-only debug digest, with its problems ordered by blocked work]' 'run[run one allowlisted read-only runtime inspector]' ;;
47
47
  docker) _values 'verbs' 'build[build one declared application image from the application root]' 'down[remove only the labelled resources owned by one application stack]' 'ps[list StarCi-labelled containers with ports and health]' 'up[start one application stack and wait for its declared healthchecks]' ;;
48
- gate) _values 'verbs' 'canon-scan[measure canon conformance debt and plan its disjoint slices]' 'custody-exec[decrypt one custody document for a command or a bounded read]' 'env-health[inspect and manage the served environment used by verification]' 'hfs-sync[check an app'\''s generated files and custody trees for drift]' 'read[build the recorded READ digest for an operation]' 'reference-conventions[probe the installed backend reference rules of a reference root]' 'repo-presentation[check repository presentation rules for a product or runtime tree]' 'run[run the measured product or document gate]' 'sonar[inspect, provision and run the local Sonar quality gate]' 'starcistacks[check a repository'\''s stack declaration and custody layout]' 'test-world[run and judge one managed test-world project]' 'unit[run unit tests and judge per-subject coverage and test-kit use]' ;;
48
+ gate) _values 'verbs' 'canon-scan[measure canon conformance debt and plan its disjoint slices]' 'custody-exec[decrypt one custody document for a command or a bounded read]' 'env-health[inspect and manage the served environment used by verification]' 'hfs-sync[check an app'\''s generated files and custody trees for drift]' 'install-sandbox[prove the packed runtime tarball installs and runs in an empty home]' 'read[build the recorded READ digest for an operation]' 'reference-conventions[probe the installed backend reference rules of a reference root]' 'repo-presentation[check repository presentation rules for a product or runtime tree]' 'run[run the measured product or document gate]' 'runtime-artifact[describe the packed runtime archive and refuse forbidden material in it]' 'runtime-coverage[run the runtime spec suite under Node coverage and write coverage/lcov.info]' 'sonar[inspect, provision and run the local Sonar quality gate]' 'starcistacks[check a repository'\''s stack declaration and custody layout]' 'test-world[run and judge one managed test-world project]' 'unit[run unit tests and judge per-subject coverage and test-kit use]' ;;
49
49
  git) _values 'verbs' 'backup[push local branch tips only to dated backup refs]' 'commit[commit staged work with the message convention and trailers]' 'land[verify a lane and fast-forward it onto local main without pushing]' 'sync[merge local main into a clean lane with rerere enabled]' ;;
50
50
  guard) _values 'verbs' 'command[judge one shell PreToolUse request from JSON on stdin]' 'footprint-scan[scan for fresh cross-repository links and linked worktrees]' 'raw[apply command policy and run the real host tool behind a PATH wrapper]' 'seat-tools[deny tools forbidden for the bound seat from JSON on stdin]' 'verify-commit[verify a protected-branch update carries only worker-owned paths]' ;;
51
51
  harness) _values 'verbs' 'open[open the local harness URL in the default browser]' 'start[start the harness API and UI or its named tunnel]' 'status[report whether the harness health endpoint is up]' 'stop[stop only harness processes recorded by harness start]' ;;
@@ -54,20 +54,20 @@ _starci() {
54
54
  machine) _values 'verbs' 'decisions[inspect and act on runtime and Supervisor decision items]' 'kernel-watchdog[inspect or repair one running workflow Kernel seat]' 'lessons[inspect and update Supervisor learning records]' 'op-metrics[report operation health metrics across managed ledgers]' 'seam-policy[plan canon cuts or redispatch a blocked canon slice]' 'worktrees[inspect, collect or resume runtime worktrees]' 'worktrees-clean[remove clean lane worktrees already merged into local main]' ;;
55
55
  npm) _values 'verbs' 'ci[install a clean lockfile into this worktree under the host lock]' 'install[add exact dependencies from canon pins under the host lock]' ;;
56
56
  orca) _values 'verbs' 'terminal-read[read an Orca terminal screen and staged draft]' 'terminal-send[send text or Enter to an Orca terminal]' ;;
57
- reconciler) _values 'verbs' 'once[run one reconcile pass of the controllers in memory, shadow unless --apply]' 'restart[stop the reconciler engine and ensure a new leader]' 'start[ensure the reconciler engine has a healthy leader]' 'status[print reconciler leader, queue, mode and violation status]' 'stop[stop the current reconciler engine leader]' 'up[bring the runtime host services and live seats up and print one checklist]' ;;
58
- release) _values 'verbs' 'app-installs[verify a scaffolded app against fresh registry installs]' 'check[run the one read-only release readiness gate]' 'clean-test[test published packages from fresh isolated installs]' 'cut[cut the release, the only push of main with its annotated release tag]' 'images[build, run, health-check and tear down the shipped application images]' 'launch-smoke[prove live nested-agent launch paths on an Orca host]' 'proof[build the release proof attached before publish or deploy effects]' 'publish[plan or perform the owner-run package publication sequence]' 'sync-runtime[refresh or check package runtime copies and optionally prepare grammar]' ;;
57
+ reconciler) _values 'verbs' 'once[run one reconcile pass of the controllers in memory, shadow unless --apply]' 'restart[stop the reconciler engine and ensure a new leader]' 'start[ensure the reconciler engine has a healthy leader]' 'status[print reconciler leader, queue, mode and violation status]' 'stop[stop the current reconciler engine leader]' 'up[bring the host services and seats up, or check them read-only, and print the checklist]' ;;
58
+ release) _values 'verbs' 'app-installs[verify a scaffolded app against fresh registry installs]' 'check[run the one read-only release readiness gate]' 'clean-test[test published packages from fresh isolated installs]' 'cut[cut the release, the only way the runtime'\''s remote main and a release tag move]' 'env-test[run the runtime spec suite under the release cut'\''s own conditions]' 'images[build, run, health-check and tear down the shipped application images]' 'launch-smoke[prove live nested-agent launch paths on an Orca host]' 'notes[print or write the release notes of a tag, its CHANGELOG section]' 'proof[build the release proof attached before publish or deploy effects]' 'publish[plan or perform the owner-run package publication sequence]' 'sync-runtime[refresh or check package runtime copies and optionally prepare grammar]' ;;
59
59
  route) _values 'verbs' 'op[resolve the operation that serves a structured routing request]' ;;
60
- runtime) _values 'verbs' 'architecture[check one repository against the runtime architecture rules]' 'benchmark-snapshot[append one model-pool snapshot file under benchmark/snapshots]' 'check[judge the runtime tree — node --check, the runtime HFS check, the retained self-checks]' 'derived-fields[regenerate or check the derived fields of the knowledge pattern files]' 'doctor[verify installed payload, public entry custody and local runtime capabilities]' 'gen-catalog[write or check the generated CLI catalog outputs, docs and shell completions]' 'gen-ops[regenerate or check the generated operation registry]' 'housekeeping[inspect or apply the host housekeeping sweeps]' 'install[install the StarCi runtime — fetch the pinned package, then init or update <cwd>/.claude]' 'ledger-hygiene[report orphan ledgers and legacy repository-local ledger stores]' 'link[point the per-user StarCi launcher at a live runtime checkout]' 'machine-db[inspect or maintain the host machine database]' 'owner-claims-audit[audit owner-decision claims and owner-gates in runtime ledgers]' 'readme-blocks[regenerate or check the generated blocks of knowledge/hfs/README.md]' 'status[the runtime'\''s version, tree root and manifest drift — a read-only summary]' 'update[bring an installed .claude tree to this package'\''s payload version]' 'validate[read-only Work record/tree validation — structure, consistency, artifacts, schemas]' 'version[print the runtime package version]' ;;
60
+ runtime) _values 'verbs' 'architecture[check one repository against the runtime architecture rules]' 'benchmark-snapshot[append one model-pool snapshot file under benchmark/snapshots]' 'check[judge the runtime tree — node --check, the runtime HFS check, the retained self-checks]' 'derived-fields[regenerate or check the derived fields of the knowledge pattern files]' 'doctor[verify installed payload, public entry custody and local runtime capabilities]' 'gen-catalog[write or check the generated CLI catalog outputs, docs and shell completions]' 'gen-ops[regenerate or check the generated operation registry]' 'housekeeping[inspect or apply the host housekeeping sweeps]' 'install[install the StarCi runtime — fetch the pinned package, then init or update <cwd>/.claude]' 'ledger-hygiene[report orphan ledgers]' 'link[point the per-user StarCi launcher at a live runtime checkout]' 'machine-db[inspect or maintain the host machine database]' 'owner-claims-audit[audit owner-decision claims and owner-gates in runtime ledgers]' 'readme-blocks[regenerate or check the generated blocks of knowledge/hfs/README.md]' 'status[the runtime'\''s version, tree root and manifest drift — a read-only summary]' 'update[bring an installed .claude tree to this package'\''s payload version]' 'validate[read-only Work record/tree validation — structure, consistency, artifacts, schemas]' 'version[print the runtime package version]' ;;
61
61
  smoke) _values 'verbs' 'scaffold[scaffold and prove one full or lite app in an isolated scratch directory]' ;;
62
62
  supabase) _values 'verbs' 'start[start the app'\''s Supabase stack after enforcing its isolated port block]' 'status[show the app'\''s Supabase endpoints and key names without secret values]' 'stop[stop only the app'\''s configured Supabase project]' ;;
63
- supervisor) _values 'verbs' 'actions[list, record, or preview the Supervisor'\''s owed-action audit trail]' 'bridge[inspect and govern cross-workflow dependencies and shared ownership]' 'channel[register, inspect, and answer the Supervisor owner-message channel]' 'direct-commits[find runtime main commits that bypassed the exclusive land gate]' 'gate-stability[compare explicitly selected current gates against accepted work in live workflows]' 'gc[inspect or collect leftover workers, shells, lanes, temp data, leases, and logs]' 'land[run the in-runtime land gate; external land-to-main.sh remains external]' 'lesson-actions[land, revert, or propose changes from the Supervisor self-learning loop]' 'notify[deliver a durable Supervisor ruling to one workflow Kernel]' 'owed[inspect and acknowledge work that running workflows owe the Supervisor]' 'poll[stream or print a read-only Supervisor digest of workflow progress and blockers]' 'push[run full repository suites and push clean main branches]' 'push-mains[scan and push main for the runtime and configured product repositories]' 'ram-cap[inspect or override RAM-aware workflow dispatch priorities]' 'report[render or send the owner'\''s detailed workflow progress report]' 'start[enable and start the one long-lived Supervisor seat]' 'status[print whether the Supervisor seat is enabled and healthy]' 'stop[disable the Supervisor seat, stop its worker and release it]' 'telegram-bridge[start, run, inspect, or stop the Supervisor Telegram bridge]' 'tell[send a desktop message to the Supervisor or read its recent replies]' 'watchdog[run one reconciler-owned Supervisor seat liveness pass]' 'workers[create, launch, inspect, report, and clean up Supervisor repair workers]' ;;
63
+ supervisor) _values 'verbs' 'actions[list, record, or preview the Supervisor'\''s owed-action audit trail]' 'bridge[inspect and govern cross-workflow dependencies and shared ownership]' 'channel[register, inspect, and answer the Supervisor owner-message channel]' 'direct-commits[find runtime main commits that bypassed the exclusive land gate]' 'gate-stability[compare explicitly selected current gates against accepted work in live workflows]' 'gc[inspect or collect leftover workers, shells, lanes, temp data, leases, and logs]' 'land[run the in-runtime land gate; it fast-forwards local main and never pushes]' 'lesson-actions[land, revert, or propose changes from the Supervisor self-learning loop]' 'notify[deliver a durable Supervisor ruling to one workflow Kernel]' 'owed[inspect and acknowledge work that running workflows owe the Supervisor]' 'poll[stream or print a read-only Supervisor digest of workflow progress and blockers]' 'push[run full repository suites and push clean main branches]' 'push-mains[scan and push main for the configured product repositories (not the runtime)]' 'ram-cap[inspect or override RAM-aware workflow dispatch priorities]' 'report[render or send the owner'\''s detailed workflow progress report]' 'start[enable and start the one long-lived Supervisor seat]' 'status[print whether the Supervisor seat is enabled and healthy]' 'stop[disable the Supervisor seat, stop its worker and release it]' 'telegram-bridge[start, run, inspect, or stop the Supervisor Telegram bridge]' 'tell[send a desktop message to the Supervisor or read its recent replies]' 'watchdog[run one reconciler-owned Supervisor seat liveness pass]' 'workers[create, launch, inspect, report, and clean up Supervisor repair workers]' ;;
64
64
  task) _values 'verbs' 'list[list state, runs, results and actions for registered runtime tasks]' 'register[print or apply one runtime scheduled-task registration]' 'show[show state, runs, result and action for one runtime scheduled task]' ;;
65
65
  test) _values 'verbs' 'run[run the specs selected for one local ladder level]' ;;
66
66
  typecheck) _values 'verbs' 'run[check changed runtime modules or affected TypeScript projects]' ;;
67
67
  uat) _values 'verbs' 'assisted-runner[inspect and run a prepared assisted UAT request]' 'slots[inspect UAT slots or run a command while holding one]' ;;
68
- work) _values 'verbs' 'asset-slot[list or check asset slots in Work records]' 'brand[derive or verify the canonical brand Work record]' 'brand-direction[inspect, ask for, or apply owner review of a brand direction]' 'brand-palette[emit a brand palette prompt or check rendered images against it]' 'check-example-work[check the layout, ids, refs and evidence of every example Work tree]' 'compose-direction[place drawn content into its measured page or overlay shell]' 'draw-acceptance[verify that drawn assets are accepted render shapes]' 'draw-dna[compare a rendered drawing with grammar DNA]' 'draw-feedback[build, inspect, check, or classify drawing feedback]' 'draw-gates[run machine and owner gates for a drawn UI record]' 'draw-grammar[resolve the grammar package used by a drawing]' 'draw-layer[verify that drawings are isolated content layers]' 'draw-loop[render, score, inspect, finish, or verify an iterative drawing loop]' 'draw-rationale[verify the rationale bound to a rendered drawing]' 'draw-render[render HTML or a drawing component at declared viewports]' 'draw-review[inspect, ask for, or apply owner review of a drawing]' 'draw-source[validate a drawing source and its fixture bindings]' 'draw-taste[check a rendered drawing against visual taste rules]' 'evidence-binding[prove that every done leaf'\''s evidence still binds to the source it claims]' 'example-critique[derive example critique records from a Work tree]' 'example-derive[derive example catalog artifacts from a Work tree]' 'example-evidence[collect evidence for one example Work record]' 'example-verify[replay and verify evidence for one example Work record]' 'grammar-geometry[emit grammar geometry guidance or check captured geometry]' 'grammar-knowledge[compare or refresh measured grammar knowledge]' 'grammar-proposal[list or check grammar proposals in Work records]' 'grammar-registry-pin[check a frontend grammar dependency against the registry pin]' 'graph[inspect, validate, diff or propose a workflow work graph]' 'hygiene[parse, scope-validate and secret-check Work and stack files before they are committed]' 'layout-tree[scan, capture, plan, lock, or inspect a product layout tree]' 'render-proof[render a proof document for one Work record]' 'shell-conformance[check Work and implementation records against the measured frontend shell]' 'ui-proof-brief[emit a UI proof brief or score a rendered surface]' ;;
68
+ work) _values 'verbs' 'asset-slot[list or check asset slots in Work records]' 'brand[derive or verify the canonical brand Work record]' 'brand-direction[inspect, ask for, or apply owner review of a brand direction]' 'brand-palette[emit a brand palette prompt or check rendered images against it]' 'check-example-work[check the layout, ids, refs and evidence of every example Work tree]' 'compose-direction[place drawn content into its measured page or overlay shell]' 'draw-acceptance[verify that drawn assets are accepted render shapes]' 'draw-dna[compare a rendered drawing with grammar DNA]' 'draw-feedback[build, inspect, check, or classify drawing feedback]' 'draw-gates[run machine and owner gates for a drawn UI record]' 'draw-grammar[resolve the grammar package used by a drawing]' 'draw-layer[verify that drawings are isolated content layers]' 'draw-loop[render, score, inspect, finish, or verify an iterative drawing loop]' 'draw-rationale[verify the rationale bound to a rendered drawing]' 'draw-render[render HTML or a drawing component at declared viewports]' 'draw-review[inspect, ask for, or apply owner review of a drawing]' 'draw-source[validate a drawing source and its fixture bindings]' 'draw-taste[check a rendered drawing against visual taste rules]' 'evidence-binding[prove that every done leaf'\''s evidence still binds to the source it claims]' 'example-critique[derive example critique records from a Work tree]' 'example-derive[derive example catalog artifacts from a Work tree]' 'example-evidence[collect evidence for one example Work record]' 'example-verify[replay and verify evidence for one example Work record]' 'grammar-geometry[emit grammar geometry guidance or check captured geometry]' 'grammar-knowledge[compare or refresh measured grammar knowledge]' 'grammar-proposal[list or check grammar proposals in Work records]' 'grammar-registry-pin[check a frontend grammar dependency against the registry pin]' 'graph[inspect, validate, diff or propose a workflow work graph]' 'hygiene[parse, scope-validate and secret-check Work and stack files before they are committed]' 'imagegen[generate images headlessly on the imagegen call tier and write them with a receipt]' 'layout-tree[scan, capture, plan, lock, or inspect a product layout tree]' 'render-proof[render a proof document for one Work record]' 'shell-conformance[check Work and implementation records against the measured frontend shell]' 'ui-proof-brief[emit a UI proof brief or score a rendered surface]' ;;
69
69
  worker) _values 'verbs' 'close[release a worker, close its terminal and prove its process tree is gone]' 'list[list supervised workers or working-agent counts by worktree lane]' 'read[read a bounded tail of one supervised worker'\''s output]' 'release[release settled Orca worker accounting without claiming full cleanup]' 'show[show one supervised worker and Orca'\''s exact liveness observation]' 'start[start one supervised agent in a registered worktree in an Orca run]' 'stop[stop a supervised worker that Orca still reports as working]' ;;
70
- workflow) _values 'verbs' 'assess[cold-scan repositories for goal-definition evidence]' 'bias[normalize a routing bias or extract one from the owner'\''s text]' 'define[define a goal — assess the prompt, plan the op chain, queue it in the ledger inbox]' 'start[ensure the host and optional core maintenance, then claim an approved goal and boot its Kernel]' 'status[the workflow projection — phase, frontier, leases and pending owner asks]' 'stop[stop a workflow — archive it, drop open jobs and retire its asks (the owner stop)]' ;;
70
+ workflow) _values 'verbs' 'assess[cold-scan repositories for goal-definition evidence]' 'bias[normalize a routing bias or extract one from the owner'\''s text]' 'custody[show a workflow tree against its branch and preserved work; --apply moves it onto them]' 'define[define a goal — assess the prompt, plan the op chain, queue it in the ledger inbox]' 'start[ensure the host, then claim an approved goal and boot its Kernel]' 'status[the workflow projection — phase, frontier, leases and pending owner asks]' 'stop[stop a workflow — archive it, drop open jobs and retire its asks (the owner stop)]' ;;
71
71
  completion) _values 'shells' 'bash' 'zsh' 'fish' 'powershell' ;;
72
72
  help) return 0 ;;
73
73
  explain) _values 'groups' 'app' 'check' 'connect' 'debug' 'docker' 'gate' 'git' 'guard' 'harness' 'kernel' 'lint' 'machine' 'npm' 'orca' 'reconciler' 'release' 'route' 'runtime' 'smoke' 'supabase' 'supervisor' 'task' 'test' 'typecheck' 'uat' 'work' 'worker' 'workflow' ;;
@@ -116,14 +116,9 @@ _starci() {
116
116
  'connect:telegram-media:--verdict') _values 'values' 'pass' 'fail' 'blocked'; return 0 ;;
117
117
  'connect:telegram-media:--dispatch') return 0 ;;
118
118
  'connect:tunnel:--port') return 0 ;;
119
- 'debug:pass:--dispatch') return 0 ;;
120
- 'debug:pass:--snapshot') return 0 ;;
121
- 'debug:pass:--child-timeout') return 0 ;;
122
- 'debug:pass:--token-window') return 0 ;;
123
- 'debug:pass:--token-spike') return 0 ;;
124
- 'debug:pass:--key') return 0 ;;
125
- 'debug:pass:--lane') return 0 ;;
126
- 'debug:pass:--reason') return 0 ;;
119
+ 'debug:digest:--repo') return 0 ;;
120
+ 'debug:digest:--workflow') return 0 ;;
121
+ 'debug:digest:--child-timeout') return 0 ;;
127
122
  'debug:run:--repo') return 0 ;;
128
123
  'debug:run:--since-hours') return 0 ;;
129
124
  'debug:run:--child-timeout') return 0 ;;
@@ -150,6 +145,9 @@ _starci() {
150
145
  'gate:env-health:--service') return 0 ;;
151
146
  'gate:env-health:--url') return 0 ;;
152
147
  'gate:hfs-sync:--repo') return 0 ;;
148
+ 'gate:install-sandbox:--tarball') return 0 ;;
149
+ 'gate:install-sandbox:--tools') return 0 ;;
150
+ 'gate:install-sandbox:--out') return 0 ;;
153
151
  'gate:read:--root') return 0 ;;
154
152
  'gate:read:--touch') return 0 ;;
155
153
  'gate:read:--read') return 0 ;;
@@ -164,10 +162,15 @@ _starci() {
164
162
  'gate:run:--out') return 0 ;;
165
163
  'gate:run:--scope') _values 'values' 'code' 'docs'; return 0 ;;
166
164
  'gate:run:--tree') return 0 ;;
165
+ 'gate:runtime-artifact:--pack') return 0 ;;
166
+ 'gate:runtime-artifact:--dir') return 0 ;;
167
+ 'gate:runtime-artifact:--out') return 0 ;;
168
+ 'gate:runtime-artifact:--root') return 0 ;;
167
169
  'gate:sonar:--key') return 0 ;;
168
170
  'gate:sonar:--name') return 0 ;;
169
171
  'gate:sonar:--base') return 0 ;;
170
172
  'gate:sonar:--paths') return 0 ;;
173
+ 'gate:sonar:--branch') return 0 ;;
171
174
  'gate:sonar:--out') return 0 ;;
172
175
  'gate:sonar:--log') return 0 ;;
173
176
  'gate:sonar:--token-ref') return 0 ;;
@@ -357,6 +360,14 @@ _starci() {
357
360
  'kernel:incident:--detail') return 0 ;;
358
361
  'kernel:incident:--op') return 0 ;;
359
362
  'kernel:incident:--holds') return 0 ;;
363
+ 'kernel:incident:--cause') return 0 ;;
364
+ 'kernel:incident:--workaround') return 0 ;;
365
+ 'kernel:incident:--no-workaround') return 0 ;;
366
+ 'kernel:incident:--because') return 0 ;;
367
+ 'kernel:incident:--evidence') return 0 ;;
368
+ 'kernel:incident:--resolution') _values 'values' 'fixed' 'workaround' 'not-runtime-fault'; return 0 ;;
369
+ 'kernel:incident:--commit') return 0 ;;
370
+ 'kernel:incident:--route') return 0 ;;
360
371
  'kernel:incident:--peer') return 0 ;;
361
372
  'kernel:incident:--refs') return 0 ;;
362
373
  'kernel:incident:--resolve') return 0 ;;
@@ -373,6 +384,9 @@ _starci() {
373
384
  'kernel:incident:--until-incident') return 0 ;;
374
385
  'kernel:incident:--until-foundation') return 0 ;;
375
386
  'kernel:incident:--until-landed') return 0 ;;
387
+ 'kernel:incident:--until-runtime-has') return 0 ;;
388
+ 'kernel:incident:--until-admission') return 0 ;;
389
+ 'kernel:incident:--until-check') return 0 ;;
376
390
  'kernel:kernel-ack-rev:--repo') return 0 ;;
377
391
  'kernel:kernel-ack-rev:--workflow') return 0 ;;
378
392
  'kernel:kernel-ack-rev:--rev') return 0 ;;
@@ -563,9 +577,6 @@ _starci() {
563
577
  'reconciler:once:--key') return 0 ;;
564
578
  'reconciler:up:--wait') return 0 ;;
565
579
  'reconciler:up:--set-profile') _values 'values' 'operational' 'observe'; return 0 ;;
566
- 'reconciler:up:--caller-agent') _values 'values' 'codex' 'claude' 'devin'; return 0 ;;
567
- 'reconciler:up:--caller-model') return 0 ;;
568
- 'reconciler:up:--caller-effort') return 0 ;;
569
580
  'release:check:--only') return 0 ;;
570
581
  'release:clean-test:--changed') return 0 ;;
571
582
  'release:clean-test:--base') return 0 ;;
@@ -582,6 +593,9 @@ _starci() {
582
593
  'release:launch-smoke:--timeout-ms') return 0 ;;
583
594
  'release:launch-smoke:--out') return 0 ;;
584
595
  'release:launch-smoke:--as') _values 'values' 'supervisor' 'worker' 'kernel' 'op' 'opFe' 'opFail' 'critic'; return 0 ;;
596
+ 'release:notes:--tag') return 0 ;;
597
+ 'release:notes:--repo') return 0 ;;
598
+ 'release:notes:--out') return 0 ;;
585
599
  'release:proof:--repo') return 0 ;;
586
600
  'release:proof:--base') return 0 ;;
587
601
  'release:proof:--main') return 0 ;;
@@ -854,6 +868,13 @@ _starci() {
854
868
  'work:graph:--reason') return 0 ;;
855
869
  'work:graph:--slice') return 0 ;;
856
870
  'work:hygiene:--repo') return 0 ;;
871
+ 'work:imagegen:--prompt') return 0 ;;
872
+ 'work:imagegen:--out') return 0 ;;
873
+ 'work:imagegen:--reference') return 0 ;;
874
+ 'work:imagegen:--count') return 0 ;;
875
+ 'work:imagegen:--size') return 0 ;;
876
+ 'work:imagegen:--name') return 0 ;;
877
+ 'work:imagegen:--stage') return 0 ;;
857
878
  'work:layout-tree:--work') return 0 ;;
858
879
  'work:layout-tree:--app-dir') return 0 ;;
859
880
  'work:layout-tree:--app') return 0 ;;
@@ -898,6 +919,8 @@ _starci() {
898
919
  'worker:stop:--dispatch') return 0 ;;
899
920
  'workflow:assess:--repo') return 0 ;;
900
921
  'workflow:bias:--normalize') return 0 ;;
922
+ 'workflow:custody:--repo') return 0 ;;
923
+ 'workflow:custody:--workflow') return 0 ;;
901
924
  'workflow:define:--repo') return 0 ;;
902
925
  'workflow:define:--project') return 0 ;;
903
926
  'workflow:define:--text') return 0 ;;
@@ -914,9 +937,6 @@ _starci() {
914
937
  'workflow:start:--repo') return 0 ;;
915
938
  'workflow:start:--goal') return 0 ;;
916
939
  'workflow:start:--agent') return 0 ;;
917
- 'workflow:start:--caller-agent') _values 'values' 'codex' 'claude' 'devin'; return 0 ;;
918
- 'workflow:start:--caller-model') return 0 ;;
919
- 'workflow:start:--caller-effort') return 0 ;;
920
940
  'workflow:start:--launched-by') _values 'values' 'watchdog' 'supervisor'; return 0 ;;
921
941
  'workflow:status:--repo') return 0 ;;
922
942
  'workflow:status:--workflow') return 0 ;;
@@ -943,7 +963,7 @@ _starci() {
943
963
  'connect:telegram') _values 'flags' '--discover-chat' '--ledger' '--repo' '--workflow' '--dispatch' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
944
964
  'connect:telegram-media') _values 'flags' '--ledger' '--repo' '--workflow' '--job' '--attempt' '--op' '--verdict' '--dispatch' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
945
965
  'connect:tunnel') _values 'flags' '--port' '--fast' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
946
- 'debug:pass') _values 'flags' '--dispatch' '--snapshot' '--child-timeout' '--token-window' '--token-spike' '--key' '--lane' '--reason' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
966
+ 'debug:digest') _values 'flags' '--repo' '--workflow' '--child-timeout' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
947
967
  'debug:run') _values 'flags' '--repo' '--since-hours' '--child-timeout' '--token-window' '--token-spike' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
948
968
  'docker:build') _values 'flags' '--tag' '--no-cache' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
949
969
  'docker:down') _values 'flags' '--env' '--volumes' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
@@ -953,11 +973,14 @@ _starci() {
953
973
  'gate:custody-exec') _values 'flags' '--get' '--keys' '--input-type' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
954
974
  'gate:env-health') _values 'flags' '--repo' '--env' '--paths' '--restart' '--probe-timeout-ms' '--ready-timeout-ms' '--service' '--url' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
955
975
  'gate:hfs-sync') _values 'flags' '--repo' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
976
+ 'gate:install-sandbox') _values 'flags' '--tarball' '--keep' '--docker' '--tools' '--out' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
956
977
  'gate:read') _values 'flags' '--root' '--touch' '--read' '--knowledge' '--out' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
957
978
  'gate:reference-conventions') _values 'flags' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
958
979
  'gate:repo-presentation') _values 'flags' '--root' '--runtime' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
959
980
  'gate:run') _values 'flags' '--root' '--base' '--main' '--changed' '--tests' '--out' '--scope' '--tree' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
960
- 'gate:sonar') _values 'flags' '--key' '--name' '--with-token' '--wait' '--base' '--paths' '--project-gate' '--out' '--blob' '--log' '--token-ref' '--no-ensure' '--timeout' '--wait-timeout' '--isolate' '--keep-slice-project' '--declaration' '--host' '--stack' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
981
+ 'gate:runtime-artifact') _values 'flags' '--pack' '--dir' '--out' '--root' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
982
+ 'gate:runtime-coverage') _values 'flags' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
983
+ 'gate:sonar') _values 'flags' '--key' '--name' '--with-token' '--wait' '--base' '--paths' '--project-gate' '--branch' '--out' '--blob' '--log' '--token-ref' '--no-ensure' '--timeout' '--wait-timeout' '--isolate' '--keep-slice-project' '--declaration' '--host' '--stack' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
961
984
  'gate:starcistacks') _values 'flags' '--new' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
962
985
  'gate:test-world') _values 'flags' '--root' '--project' '--tests' '--out' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
963
986
  'gate:unit') _values 'flags' '--root' '--out' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
@@ -993,7 +1016,7 @@ _starci() {
993
1016
  'kernel:graph-edit') _values 'flags' '--repo' '--workflow' '--edit' '--decision' '--jobs' '--job' '--add-paths' '--paths' '--op' '--before' '--after' '--parts' '--set' '--cut-id' '--from-scan' '--path-prefix' '--exclude' '--reason' '--undo' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
994
1017
  'kernel:hierarchy') _values 'flags' '--repo' '--workflow' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
995
1018
  'kernel:inbox') _values 'flags' '--repo' '--workflow' '--ack' '--disposition' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
996
- 'kernel:incident') _values 'flags' '--repo' '--workflow' '--kind' '--detail' '--op' '--holds' '--peer' '--refs' '--resolve' '--by' '--owner-answer' '--introduced-by' '--introducer' '--fix' '--attach' '--until-record' '--until-job' '--until-message' '--until-commit' '--until-incident' '--until-foundation' '--until-landed' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1019
+ 'kernel:incident') _values 'flags' '--repo' '--workflow' '--kind' '--detail' '--op' '--holds' '--cause' '--workaround' '--no-workaround' '--because' '--evidence' '--resolution' '--commit' '--route' '--peer' '--refs' '--resolve' '--by' '--owner-answer' '--introduced-by' '--introducer' '--fix' '--attach' '--until-record' '--until-job' '--until-message' '--until-commit' '--until-incident' '--until-foundation' '--until-landed' '--until-runtime-has' '--until-admission' '--until-check' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
997
1020
  'kernel:kernel-ack-rev') _values 'flags' '--repo' '--workflow' '--rev' '--plan' '--read-manifest' '--op' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
998
1021
  'kernel:kernel-proposal') _values 'flags' '--repo' '--workflow' '--title' '--evidence' '--patch' '--files' '--decision' '--list' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
999
1022
  'kernel:lifecycle') _values 'flags' '--repo' '--workflow' '--pause' '--stop' '--resume' '--by' '--reason' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
@@ -1010,7 +1033,7 @@ _starci() {
1010
1033
  'kernel:provider-backoff') _values 'flags' '--repo' '--provider' '--open-circuit' '--kind' '--reason' '--by' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1011
1034
  'kernel:provider-health') _values 'flags' '--repo' '--provider' '--recover' '--reason' '--probe' '--quota-probe' '--force' '--workflow' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1012
1035
  'kernel:questions') _values 'flags' '--repo' '--workflow' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1013
- 'kernel:reconcile') _values 'flags' '--repo' '--job' '--drop' '--reason' '--dead-worker' '--settle-failed' '--no-salvage' '--release-worker' '--orphan-kernel-jobs' '--workflow' '--dry-run' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1036
+ 'kernel:reconcile') _values 'flags' '--repo' '--job' '--drop' '--reason' '--dead-worker' '--settle-failed' '--no-salvage' '--release-worker' '--route-failure' '--orphan-kernel-jobs' '--workflow' '--dry-run' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1014
1037
  'kernel:record-change') _values 'flags' '--repo' '--workflow' '--record' '--reach' '--reason' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1015
1038
  'kernel:record-checks') _values 'flags' '--repo' '--job' '--checks' '--checks-file' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1016
1039
  'kernel:redesign') _values 'flags' '--repo' '--workflow' '--op' '--paths' '--decision' '--brief' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
@@ -1045,13 +1068,15 @@ _starci() {
1045
1068
  'reconciler:start') _values 'flags' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1046
1069
  'reconciler:status') _values 'flags' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1047
1070
  'reconciler:stop') _values 'flags' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1048
- 'reconciler:up') _values 'flags' '--check' '--wait' '--no-build' '--retire-stale-ledgers' '--set-profile' '--caller-agent' '--caller-model' '--caller-effort' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1071
+ 'reconciler:up') _values 'flags' '--check' '--services' '--brief' '--wait' '--no-build' '--retire-stale-ledgers' '--set-profile' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1049
1072
  'release:app-installs') _values 'flags' '--keep' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1050
1073
  'release:check') _values 'flags' '--final' '--only' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1051
1074
  'release:clean-test') _values 'flags' '--changed' '--base' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1052
- 'release:cut') _values 'flags' '--repo' '--remote' '--branch' '--tag' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1075
+ 'release:cut') _values 'flags' '--repo' '--remote' '--branch' '--plan' '--tag' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1076
+ 'release:env-test') _values 'flags' '--lane' '--reuse-installs' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1053
1077
  'release:images') _values 'flags' '--app' '--sides' '--only' '--wait-seconds' '--remove-images' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1054
1078
  'release:launch-smoke') _values 'flags' '--app-repo' '--entry' '--timeout-ms' '--out' '--as' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1079
+ 'release:notes') _values 'flags' '--tag' '--repo' '--out' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1055
1080
  'release:proof') _values 'flags' '--repo' '--base' '--main' '--out' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1056
1081
  'release:publish') _values 'flags' '--publish' '--runtime-package' '--npm-user' '--poll-minutes' '--pre-land-ref' '--expect-sha' '--examples' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1057
1082
  'release:sync-runtime') _values 'flags' '--check' '--prepare-grammar' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
@@ -1084,7 +1109,7 @@ _starci() {
1084
1109
  'supervisor:direct-commits') _values 'flags' '--repo' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1085
1110
  'supervisor:gate-stability') _values 'flags' '--family' '--tree' '--base' '--head' '--ledger' '--gate' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1086
1111
  'supervisor:gc') _values 'flags' '--dry-run' '--apply' '--only' '--plan' '--holder' '--trigger' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1087
- 'supervisor:land') _values 'flags' '--job' '--commit' '--specs' '--reason' '--full-by-push-git' '--lane' '--no-push' '--notify' '--status' '--wait-ms' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1112
+ 'supervisor:land') _values 'flags' '--job' '--commit' '--specs' '--reason' '--full-by-push-git' '--lane' '--notify' '--status' '--wait-ms' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1088
1113
  'supervisor:lesson-actions') _values 'flags' '--signature' '--commit' '--lane' '--specs' '--wrongly-blocked' '--reason' '--wait-ms' '--experiment' '--apply' '--title' '--evidence' '--options' '--recommendation' '--send' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1089
1114
  'supervisor:notify') _values 'flags' '--repo' '--workflow' '--text' '--text-file' '--item' '--entity' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1090
1115
  'supervisor:owed') _values 'flags' '--repo' '--workflow' '--all' '--item' '--commits' '--reason' '--force' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
@@ -1136,6 +1161,7 @@ _starci() {
1136
1161
  'work:grammar-registry-pin') _values 'flags' '--repo' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1137
1162
  'work:graph') _values 'flags' '--repo' '--workflow' '--version' '--file' '--from' '--to' '--job' '--reason' '--slice' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1138
1163
  'work:hygiene') _values 'flags' '--repo' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1164
+ 'work:imagegen') _values 'flags' '--prompt' '--out' '--reference' '--count' '--size' '--name' '--stage' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1139
1165
  'work:layout-tree') _values 'flags' '--work' '--app-dir' '--write' '--app' '--repo-root' '--node' '--breakpoint' '--theme' '--file' '--url' '--provenance' '--destination' '--route' '--locale' '--from' '--rect' '--active-nav' '--design' '--files' '--key' '--tolerance' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1140
1166
  'work:render-proof') _values 'flags' '--work' '--record' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1141
1167
  'work:shell-conformance') _values 'flags' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
@@ -1149,8 +1175,9 @@ _starci() {
1149
1175
  'worker:stop') _values 'flags' '--dispatch' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1150
1176
  'workflow:assess') _values 'flags' '--repo' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1151
1177
  'workflow:bias') _values 'flags' '--normalize' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1178
+ 'workflow:custody') _values 'flags' '--repo' '--workflow' '--apply' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1152
1179
  'workflow:define') _values 'flags' '--repo' '--project' '--text' '--title' '--display-name' '--params' '--plan' '--revise' '--reason' '--approve-revision' '--defined-by' '--approved-by' '--bridge-id' '--routing-bias' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1153
- 'workflow:start') _values 'flags' '--repo' '--goal' '--agent' '--caller-agent' '--caller-model' '--caller-effort' '--launched-by' '--plan' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1180
+ 'workflow:start') _values 'flags' '--repo' '--goal' '--agent' '--launched-by' '--plan' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1154
1181
  'workflow:status') _values 'flags' '--repo' '--workflow' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1155
1182
  'workflow:stop') _values 'flags' '--repo' '--workflow' '--reason' '--by' '--json' '--cwd' '--quiet' '--help' '--edition' ;;
1156
1183
  esac
@@ -16,9 +16,9 @@ _starci() {
16
16
  app) COMPREPLY=( $(compgen -W "add check emit explain hygiene lint new scaffold secret stack sync upgrade" -- "$cur") );;
17
17
  check) COMPREPLY=( $(compgen -W "run" -- "$cur") );;
18
18
  connect) COMPREPLY=( $(compgen -W "ask-gateway telegram telegram-media tunnel" -- "$cur") );;
19
- debug) COMPREPLY=( $(compgen -W "pass run" -- "$cur") );;
19
+ debug) COMPREPLY=( $(compgen -W "digest run" -- "$cur") );;
20
20
  docker) COMPREPLY=( $(compgen -W "build down ps up" -- "$cur") );;
21
- gate) COMPREPLY=( $(compgen -W "canon-scan custody-exec env-health hfs-sync read reference-conventions repo-presentation run sonar starcistacks test-world unit" -- "$cur") );;
21
+ gate) COMPREPLY=( $(compgen -W "canon-scan custody-exec env-health hfs-sync install-sandbox read reference-conventions repo-presentation run runtime-artifact runtime-coverage sonar starcistacks test-world unit" -- "$cur") );;
22
22
  git) COMPREPLY=( $(compgen -W "backup commit land sync" -- "$cur") );;
23
23
  guard) COMPREPLY=( $(compgen -W "command footprint-scan raw seat-tools verify-commit" -- "$cur") );;
24
24
  harness) COMPREPLY=( $(compgen -W "open start status stop" -- "$cur") );;
@@ -28,7 +28,7 @@ _starci() {
28
28
  npm) COMPREPLY=( $(compgen -W "ci install" -- "$cur") );;
29
29
  orca) COMPREPLY=( $(compgen -W "terminal-read terminal-send" -- "$cur") );;
30
30
  reconciler) COMPREPLY=( $(compgen -W "once restart start status stop up" -- "$cur") );;
31
- release) COMPREPLY=( $(compgen -W "app-installs check clean-test cut images launch-smoke proof publish sync-runtime" -- "$cur") );;
31
+ release) COMPREPLY=( $(compgen -W "app-installs check clean-test cut env-test images launch-smoke notes proof publish sync-runtime" -- "$cur") );;
32
32
  route) COMPREPLY=( $(compgen -W "op" -- "$cur") );;
33
33
  runtime) COMPREPLY=( $(compgen -W "architecture benchmark-snapshot check derived-fields doctor gen-catalog gen-ops housekeeping install ledger-hygiene link machine-db owner-claims-audit readme-blocks status update validate version" -- "$cur") );;
34
34
  smoke) COMPREPLY=( $(compgen -W "scaffold" -- "$cur") );;
@@ -38,9 +38,9 @@ _starci() {
38
38
  test) COMPREPLY=( $(compgen -W "run" -- "$cur") );;
39
39
  typecheck) COMPREPLY=( $(compgen -W "run" -- "$cur") );;
40
40
  uat) COMPREPLY=( $(compgen -W "assisted-runner slots" -- "$cur") );;
41
- work) COMPREPLY=( $(compgen -W "asset-slot brand brand-direction brand-palette check-example-work compose-direction draw-acceptance draw-dna draw-feedback draw-gates draw-grammar draw-layer draw-loop draw-rationale draw-render draw-review draw-source draw-taste evidence-binding example-critique example-derive example-evidence example-verify grammar-geometry grammar-knowledge grammar-proposal grammar-registry-pin graph hygiene layout-tree render-proof shell-conformance ui-proof-brief" -- "$cur") );;
41
+ work) COMPREPLY=( $(compgen -W "asset-slot brand brand-direction brand-palette check-example-work compose-direction draw-acceptance draw-dna draw-feedback draw-gates draw-grammar draw-layer draw-loop draw-rationale draw-render draw-review draw-source draw-taste evidence-binding example-critique example-derive example-evidence example-verify grammar-geometry grammar-knowledge grammar-proposal grammar-registry-pin graph hygiene imagegen layout-tree render-proof shell-conformance ui-proof-brief" -- "$cur") );;
42
42
  worker) COMPREPLY=( $(compgen -W "close list read release show start stop" -- "$cur") );;
43
- workflow) COMPREPLY=( $(compgen -W "assess bias define start status stop" -- "$cur") );;
43
+ workflow) COMPREPLY=( $(compgen -W "assess bias custody define start status stop" -- "$cur") );;
44
44
  completion) COMPREPLY=( $(compgen -W "bash zsh fish powershell" -- "$cur") );;
45
45
  explain) COMPREPLY=( $(compgen -W "app check connect debug docker gate git guard harness kernel lint machine npm orca reconciler release route runtime smoke supabase supervisor task test typecheck uat work worker workflow" -- "$cur") );;
46
46
  *) COMPREPLY=();;
@@ -89,14 +89,9 @@ _starci() {
89
89
  connect:telegram-media:--verdict) COMPREPLY=( $(compgen -W "pass fail blocked" -- "$cur") ); return 0;;
90
90
  connect:telegram-media:--dispatch) return 0;;
91
91
  connect:tunnel:--port) return 0;;
92
- debug:pass:--dispatch) return 0;;
93
- debug:pass:--snapshot) return 0;;
94
- debug:pass:--child-timeout) return 0;;
95
- debug:pass:--token-window) return 0;;
96
- debug:pass:--token-spike) return 0;;
97
- debug:pass:--key) return 0;;
98
- debug:pass:--lane) return 0;;
99
- debug:pass:--reason) return 0;;
92
+ debug:digest:--repo) return 0;;
93
+ debug:digest:--workflow) return 0;;
94
+ debug:digest:--child-timeout) return 0;;
100
95
  debug:run:--repo) return 0;;
101
96
  debug:run:--since-hours) return 0;;
102
97
  debug:run:--child-timeout) return 0;;
@@ -123,6 +118,9 @@ _starci() {
123
118
  gate:env-health:--service) return 0;;
124
119
  gate:env-health:--url) return 0;;
125
120
  gate:hfs-sync:--repo) return 0;;
121
+ gate:install-sandbox:--tarball) return 0;;
122
+ gate:install-sandbox:--tools) return 0;;
123
+ gate:install-sandbox:--out) return 0;;
126
124
  gate:read:--root) return 0;;
127
125
  gate:read:--touch) return 0;;
128
126
  gate:read:--read) return 0;;
@@ -137,10 +135,15 @@ _starci() {
137
135
  gate:run:--out) return 0;;
138
136
  gate:run:--scope) COMPREPLY=( $(compgen -W "code docs" -- "$cur") ); return 0;;
139
137
  gate:run:--tree) return 0;;
138
+ gate:runtime-artifact:--pack) return 0;;
139
+ gate:runtime-artifact:--dir) return 0;;
140
+ gate:runtime-artifact:--out) return 0;;
141
+ gate:runtime-artifact:--root) return 0;;
140
142
  gate:sonar:--key) return 0;;
141
143
  gate:sonar:--name) return 0;;
142
144
  gate:sonar:--base) return 0;;
143
145
  gate:sonar:--paths) return 0;;
146
+ gate:sonar:--branch) return 0;;
144
147
  gate:sonar:--out) return 0;;
145
148
  gate:sonar:--log) return 0;;
146
149
  gate:sonar:--token-ref) return 0;;
@@ -330,6 +333,14 @@ _starci() {
330
333
  kernel:incident:--detail) return 0;;
331
334
  kernel:incident:--op) return 0;;
332
335
  kernel:incident:--holds) return 0;;
336
+ kernel:incident:--cause) return 0;;
337
+ kernel:incident:--workaround) return 0;;
338
+ kernel:incident:--no-workaround) return 0;;
339
+ kernel:incident:--because) return 0;;
340
+ kernel:incident:--evidence) return 0;;
341
+ kernel:incident:--resolution) COMPREPLY=( $(compgen -W "fixed workaround not-runtime-fault" -- "$cur") ); return 0;;
342
+ kernel:incident:--commit) return 0;;
343
+ kernel:incident:--route) return 0;;
333
344
  kernel:incident:--peer) return 0;;
334
345
  kernel:incident:--refs) return 0;;
335
346
  kernel:incident:--resolve) return 0;;
@@ -346,6 +357,9 @@ _starci() {
346
357
  kernel:incident:--until-incident) return 0;;
347
358
  kernel:incident:--until-foundation) return 0;;
348
359
  kernel:incident:--until-landed) return 0;;
360
+ kernel:incident:--until-runtime-has) return 0;;
361
+ kernel:incident:--until-admission) return 0;;
362
+ kernel:incident:--until-check) return 0;;
349
363
  kernel:kernel-ack-rev:--repo) return 0;;
350
364
  kernel:kernel-ack-rev:--workflow) return 0;;
351
365
  kernel:kernel-ack-rev:--rev) return 0;;
@@ -536,9 +550,6 @@ _starci() {
536
550
  reconciler:once:--key) return 0;;
537
551
  reconciler:up:--wait) return 0;;
538
552
  reconciler:up:--set-profile) COMPREPLY=( $(compgen -W "operational observe" -- "$cur") ); return 0;;
539
- reconciler:up:--caller-agent) COMPREPLY=( $(compgen -W "codex claude devin" -- "$cur") ); return 0;;
540
- reconciler:up:--caller-model) return 0;;
541
- reconciler:up:--caller-effort) return 0;;
542
553
  release:check:--only) return 0;;
543
554
  release:clean-test:--changed) return 0;;
544
555
  release:clean-test:--base) return 0;;
@@ -555,6 +566,9 @@ _starci() {
555
566
  release:launch-smoke:--timeout-ms) return 0;;
556
567
  release:launch-smoke:--out) return 0;;
557
568
  release:launch-smoke:--as) COMPREPLY=( $(compgen -W "supervisor worker kernel op opFe opFail critic" -- "$cur") ); return 0;;
569
+ release:notes:--tag) return 0;;
570
+ release:notes:--repo) return 0;;
571
+ release:notes:--out) return 0;;
558
572
  release:proof:--repo) return 0;;
559
573
  release:proof:--base) return 0;;
560
574
  release:proof:--main) return 0;;
@@ -827,6 +841,13 @@ _starci() {
827
841
  work:graph:--reason) return 0;;
828
842
  work:graph:--slice) return 0;;
829
843
  work:hygiene:--repo) return 0;;
844
+ work:imagegen:--prompt) return 0;;
845
+ work:imagegen:--out) return 0;;
846
+ work:imagegen:--reference) return 0;;
847
+ work:imagegen:--count) return 0;;
848
+ work:imagegen:--size) return 0;;
849
+ work:imagegen:--name) return 0;;
850
+ work:imagegen:--stage) return 0;;
830
851
  work:layout-tree:--work) return 0;;
831
852
  work:layout-tree:--app-dir) return 0;;
832
853
  work:layout-tree:--app) return 0;;
@@ -871,6 +892,8 @@ _starci() {
871
892
  worker:stop:--dispatch) return 0;;
872
893
  workflow:assess:--repo) return 0;;
873
894
  workflow:bias:--normalize) return 0;;
895
+ workflow:custody:--repo) return 0;;
896
+ workflow:custody:--workflow) return 0;;
874
897
  workflow:define:--repo) return 0;;
875
898
  workflow:define:--project) return 0;;
876
899
  workflow:define:--text) return 0;;
@@ -887,9 +910,6 @@ _starci() {
887
910
  workflow:start:--repo) return 0;;
888
911
  workflow:start:--goal) return 0;;
889
912
  workflow:start:--agent) return 0;;
890
- workflow:start:--caller-agent) COMPREPLY=( $(compgen -W "codex claude devin" -- "$cur") ); return 0;;
891
- workflow:start:--caller-model) return 0;;
892
- workflow:start:--caller-effort) return 0;;
893
913
  workflow:start:--launched-by) COMPREPLY=( $(compgen -W "watchdog supervisor" -- "$cur") ); return 0;;
894
914
  workflow:status:--repo) return 0;;
895
915
  workflow:status:--workflow) return 0;;
@@ -916,7 +936,7 @@ _starci() {
916
936
  connect:telegram) COMPREPLY=( $(compgen -W "--discover-chat --ledger --repo --workflow --dispatch --json --cwd --quiet --help --edition" -- "$cur") );;
917
937
  connect:telegram-media) COMPREPLY=( $(compgen -W "--ledger --repo --workflow --job --attempt --op --verdict --dispatch --json --cwd --quiet --help --edition" -- "$cur") );;
918
938
  connect:tunnel) COMPREPLY=( $(compgen -W "--port --fast --json --cwd --quiet --help --edition" -- "$cur") );;
919
- debug:pass) COMPREPLY=( $(compgen -W "--dispatch --snapshot --child-timeout --token-window --token-spike --key --lane --reason --json --cwd --quiet --help --edition" -- "$cur") );;
939
+ debug:digest) COMPREPLY=( $(compgen -W "--repo --workflow --child-timeout --json --cwd --quiet --help --edition" -- "$cur") );;
920
940
  debug:run) COMPREPLY=( $(compgen -W "--repo --since-hours --child-timeout --token-window --token-spike --json --cwd --quiet --help --edition" -- "$cur") );;
921
941
  docker:build) COMPREPLY=( $(compgen -W "--tag --no-cache --json --cwd --quiet --help --edition" -- "$cur") );;
922
942
  docker:down) COMPREPLY=( $(compgen -W "--env --volumes --json --cwd --quiet --help --edition" -- "$cur") );;
@@ -926,11 +946,14 @@ _starci() {
926
946
  gate:custody-exec) COMPREPLY=( $(compgen -W "--get --keys --input-type --json --cwd --quiet --help --edition" -- "$cur") );;
927
947
  gate:env-health) COMPREPLY=( $(compgen -W "--repo --env --paths --restart --probe-timeout-ms --ready-timeout-ms --service --url --json --cwd --quiet --help --edition" -- "$cur") );;
928
948
  gate:hfs-sync) COMPREPLY=( $(compgen -W "--repo --json --cwd --quiet --help --edition" -- "$cur") );;
949
+ gate:install-sandbox) COMPREPLY=( $(compgen -W "--tarball --keep --docker --tools --out --json --cwd --quiet --help --edition" -- "$cur") );;
929
950
  gate:read) COMPREPLY=( $(compgen -W "--root --touch --read --knowledge --out --json --cwd --quiet --help --edition" -- "$cur") );;
930
951
  gate:reference-conventions) COMPREPLY=( $(compgen -W "--json --cwd --quiet --help --edition" -- "$cur") );;
931
952
  gate:repo-presentation) COMPREPLY=( $(compgen -W "--root --runtime --json --cwd --quiet --help --edition" -- "$cur") );;
932
953
  gate:run) COMPREPLY=( $(compgen -W "--root --base --main --changed --tests --out --scope --tree --json --cwd --quiet --help --edition" -- "$cur") );;
933
- gate:sonar) COMPREPLY=( $(compgen -W "--key --name --with-token --wait --base --paths --project-gate --out --blob --log --token-ref --no-ensure --timeout --wait-timeout --isolate --keep-slice-project --declaration --host --stack --json --cwd --quiet --help --edition" -- "$cur") );;
954
+ gate:runtime-artifact) COMPREPLY=( $(compgen -W "--pack --dir --out --root --json --cwd --quiet --help --edition" -- "$cur") );;
955
+ gate:runtime-coverage) COMPREPLY=( $(compgen -W "--json --cwd --quiet --help --edition" -- "$cur") );;
956
+ gate:sonar) COMPREPLY=( $(compgen -W "--key --name --with-token --wait --base --paths --project-gate --branch --out --blob --log --token-ref --no-ensure --timeout --wait-timeout --isolate --keep-slice-project --declaration --host --stack --json --cwd --quiet --help --edition" -- "$cur") );;
934
957
  gate:starcistacks) COMPREPLY=( $(compgen -W "--new --json --cwd --quiet --help --edition" -- "$cur") );;
935
958
  gate:test-world) COMPREPLY=( $(compgen -W "--root --project --tests --out --json --cwd --quiet --help --edition" -- "$cur") );;
936
959
  gate:unit) COMPREPLY=( $(compgen -W "--root --out --json --cwd --quiet --help --edition" -- "$cur") );;
@@ -966,7 +989,7 @@ _starci() {
966
989
  kernel:graph-edit) COMPREPLY=( $(compgen -W "--repo --workflow --edit --decision --jobs --job --add-paths --paths --op --before --after --parts --set --cut-id --from-scan --path-prefix --exclude --reason --undo --json --cwd --quiet --help --edition" -- "$cur") );;
967
990
  kernel:hierarchy) COMPREPLY=( $(compgen -W "--repo --workflow --json --cwd --quiet --help --edition" -- "$cur") );;
968
991
  kernel:inbox) COMPREPLY=( $(compgen -W "--repo --workflow --ack --disposition --json --cwd --quiet --help --edition" -- "$cur") );;
969
- kernel:incident) COMPREPLY=( $(compgen -W "--repo --workflow --kind --detail --op --holds --peer --refs --resolve --by --owner-answer --introduced-by --introducer --fix --attach --until-record --until-job --until-message --until-commit --until-incident --until-foundation --until-landed --json --cwd --quiet --help --edition" -- "$cur") );;
992
+ kernel:incident) COMPREPLY=( $(compgen -W "--repo --workflow --kind --detail --op --holds --cause --workaround --no-workaround --because --evidence --resolution --commit --route --peer --refs --resolve --by --owner-answer --introduced-by --introducer --fix --attach --until-record --until-job --until-message --until-commit --until-incident --until-foundation --until-landed --until-runtime-has --until-admission --until-check --json --cwd --quiet --help --edition" -- "$cur") );;
970
993
  kernel:kernel-ack-rev) COMPREPLY=( $(compgen -W "--repo --workflow --rev --plan --read-manifest --op --json --cwd --quiet --help --edition" -- "$cur") );;
971
994
  kernel:kernel-proposal) COMPREPLY=( $(compgen -W "--repo --workflow --title --evidence --patch --files --decision --list --json --cwd --quiet --help --edition" -- "$cur") );;
972
995
  kernel:lifecycle) COMPREPLY=( $(compgen -W "--repo --workflow --pause --stop --resume --by --reason --json --cwd --quiet --help --edition" -- "$cur") );;
@@ -983,7 +1006,7 @@ _starci() {
983
1006
  kernel:provider-backoff) COMPREPLY=( $(compgen -W "--repo --provider --open-circuit --kind --reason --by --json --cwd --quiet --help --edition" -- "$cur") );;
984
1007
  kernel:provider-health) COMPREPLY=( $(compgen -W "--repo --provider --recover --reason --probe --quota-probe --force --workflow --json --cwd --quiet --help --edition" -- "$cur") );;
985
1008
  kernel:questions) COMPREPLY=( $(compgen -W "--repo --workflow --json --cwd --quiet --help --edition" -- "$cur") );;
986
- kernel:reconcile) COMPREPLY=( $(compgen -W "--repo --job --drop --reason --dead-worker --settle-failed --no-salvage --release-worker --orphan-kernel-jobs --workflow --dry-run --json --cwd --quiet --help --edition" -- "$cur") );;
1009
+ kernel:reconcile) COMPREPLY=( $(compgen -W "--repo --job --drop --reason --dead-worker --settle-failed --no-salvage --release-worker --route-failure --orphan-kernel-jobs --workflow --dry-run --json --cwd --quiet --help --edition" -- "$cur") );;
987
1010
  kernel:record-change) COMPREPLY=( $(compgen -W "--repo --workflow --record --reach --reason --json --cwd --quiet --help --edition" -- "$cur") );;
988
1011
  kernel:record-checks) COMPREPLY=( $(compgen -W "--repo --job --checks --checks-file --json --cwd --quiet --help --edition" -- "$cur") );;
989
1012
  kernel:redesign) COMPREPLY=( $(compgen -W "--repo --workflow --op --paths --decision --brief --json --cwd --quiet --help --edition" -- "$cur") );;
@@ -1018,13 +1041,15 @@ _starci() {
1018
1041
  reconciler:start) COMPREPLY=( $(compgen -W "--json --cwd --quiet --help --edition" -- "$cur") );;
1019
1042
  reconciler:status) COMPREPLY=( $(compgen -W "--json --cwd --quiet --help --edition" -- "$cur") );;
1020
1043
  reconciler:stop) COMPREPLY=( $(compgen -W "--json --cwd --quiet --help --edition" -- "$cur") );;
1021
- reconciler:up) COMPREPLY=( $(compgen -W "--check --wait --no-build --retire-stale-ledgers --set-profile --caller-agent --caller-model --caller-effort --json --cwd --quiet --help --edition" -- "$cur") );;
1044
+ reconciler:up) COMPREPLY=( $(compgen -W "--check --services --brief --wait --no-build --retire-stale-ledgers --set-profile --json --cwd --quiet --help --edition" -- "$cur") );;
1022
1045
  release:app-installs) COMPREPLY=( $(compgen -W "--keep --json --cwd --quiet --help --edition" -- "$cur") );;
1023
1046
  release:check) COMPREPLY=( $(compgen -W "--final --only --json --cwd --quiet --help --edition" -- "$cur") );;
1024
1047
  release:clean-test) COMPREPLY=( $(compgen -W "--changed --base --json --cwd --quiet --help --edition" -- "$cur") );;
1025
- release:cut) COMPREPLY=( $(compgen -W "--repo --remote --branch --tag --json --cwd --quiet --help --edition" -- "$cur") );;
1048
+ release:cut) COMPREPLY=( $(compgen -W "--repo --remote --branch --plan --tag --json --cwd --quiet --help --edition" -- "$cur") );;
1049
+ release:env-test) COMPREPLY=( $(compgen -W "--lane --reuse-installs --json --cwd --quiet --help --edition" -- "$cur") );;
1026
1050
  release:images) COMPREPLY=( $(compgen -W "--app --sides --only --wait-seconds --remove-images --json --cwd --quiet --help --edition" -- "$cur") );;
1027
1051
  release:launch-smoke) COMPREPLY=( $(compgen -W "--app-repo --entry --timeout-ms --out --as --json --cwd --quiet --help --edition" -- "$cur") );;
1052
+ release:notes) COMPREPLY=( $(compgen -W "--tag --repo --out --json --cwd --quiet --help --edition" -- "$cur") );;
1028
1053
  release:proof) COMPREPLY=( $(compgen -W "--repo --base --main --out --json --cwd --quiet --help --edition" -- "$cur") );;
1029
1054
  release:publish) COMPREPLY=( $(compgen -W "--publish --runtime-package --npm-user --poll-minutes --pre-land-ref --expect-sha --examples --json --cwd --quiet --help --edition" -- "$cur") );;
1030
1055
  release:sync-runtime) COMPREPLY=( $(compgen -W "--check --prepare-grammar --json --cwd --quiet --help --edition" -- "$cur") );;
@@ -1057,7 +1082,7 @@ _starci() {
1057
1082
  supervisor:direct-commits) COMPREPLY=( $(compgen -W "--repo --json --cwd --quiet --help --edition" -- "$cur") );;
1058
1083
  supervisor:gate-stability) COMPREPLY=( $(compgen -W "--family --tree --base --head --ledger --gate --json --cwd --quiet --help --edition" -- "$cur") );;
1059
1084
  supervisor:gc) COMPREPLY=( $(compgen -W "--dry-run --apply --only --plan --holder --trigger --json --cwd --quiet --help --edition" -- "$cur") );;
1060
- supervisor:land) COMPREPLY=( $(compgen -W "--job --commit --specs --reason --full-by-push-git --lane --no-push --notify --status --wait-ms --json --cwd --quiet --help --edition" -- "$cur") );;
1085
+ supervisor:land) COMPREPLY=( $(compgen -W "--job --commit --specs --reason --full-by-push-git --lane --notify --status --wait-ms --json --cwd --quiet --help --edition" -- "$cur") );;
1061
1086
  supervisor:lesson-actions) COMPREPLY=( $(compgen -W "--signature --commit --lane --specs --wrongly-blocked --reason --wait-ms --experiment --apply --title --evidence --options --recommendation --send --json --cwd --quiet --help --edition" -- "$cur") );;
1062
1087
  supervisor:notify) COMPREPLY=( $(compgen -W "--repo --workflow --text --text-file --item --entity --json --cwd --quiet --help --edition" -- "$cur") );;
1063
1088
  supervisor:owed) COMPREPLY=( $(compgen -W "--repo --workflow --all --item --commits --reason --force --json --cwd --quiet --help --edition" -- "$cur") );;
@@ -1109,6 +1134,7 @@ _starci() {
1109
1134
  work:grammar-registry-pin) COMPREPLY=( $(compgen -W "--repo --json --cwd --quiet --help --edition" -- "$cur") );;
1110
1135
  work:graph) COMPREPLY=( $(compgen -W "--repo --workflow --version --file --from --to --job --reason --slice --json --cwd --quiet --help --edition" -- "$cur") );;
1111
1136
  work:hygiene) COMPREPLY=( $(compgen -W "--repo --json --cwd --quiet --help --edition" -- "$cur") );;
1137
+ work:imagegen) COMPREPLY=( $(compgen -W "--prompt --out --reference --count --size --name --stage --json --cwd --quiet --help --edition" -- "$cur") );;
1112
1138
  work:layout-tree) COMPREPLY=( $(compgen -W "--work --app-dir --write --app --repo-root --node --breakpoint --theme --file --url --provenance --destination --route --locale --from --rect --active-nav --design --files --key --tolerance --json --cwd --quiet --help --edition" -- "$cur") );;
1113
1139
  work:render-proof) COMPREPLY=( $(compgen -W "--work --record --json --cwd --quiet --help --edition" -- "$cur") );;
1114
1140
  work:shell-conformance) COMPREPLY=( $(compgen -W "--json --cwd --quiet --help --edition" -- "$cur") );;
@@ -1122,8 +1148,9 @@ _starci() {
1122
1148
  worker:stop) COMPREPLY=( $(compgen -W "--dispatch --json --cwd --quiet --help --edition" -- "$cur") );;
1123
1149
  workflow:assess) COMPREPLY=( $(compgen -W "--repo --json --cwd --quiet --help --edition" -- "$cur") );;
1124
1150
  workflow:bias) COMPREPLY=( $(compgen -W "--normalize --json --cwd --quiet --help --edition" -- "$cur") );;
1151
+ workflow:custody) COMPREPLY=( $(compgen -W "--repo --workflow --apply --json --cwd --quiet --help --edition" -- "$cur") );;
1125
1152
  workflow:define) COMPREPLY=( $(compgen -W "--repo --project --text --title --display-name --params --plan --revise --reason --approve-revision --defined-by --approved-by --bridge-id --routing-bias --json --cwd --quiet --help --edition" -- "$cur") );;
1126
- workflow:start) COMPREPLY=( $(compgen -W "--repo --goal --agent --caller-agent --caller-model --caller-effort --launched-by --plan --json --cwd --quiet --help --edition" -- "$cur") );;
1153
+ workflow:start) COMPREPLY=( $(compgen -W "--repo --goal --agent --launched-by --plan --json --cwd --quiet --help --edition" -- "$cur") );;
1127
1154
  workflow:status) COMPREPLY=( $(compgen -W "--repo --workflow --json --cwd --quiet --help --edition" -- "$cur") );;
1128
1155
  workflow:stop) COMPREPLY=( $(compgen -W "--repo --workflow --reason --by --json --cwd --quiet --help --edition" -- "$cur") );;
1129
1156
  *) COMPREPLY=();;