okstra 0.174.0 → 0.176.0

package/README.md

@@ -32,11 +32,15 @@ Role assignments are persisted separately from the host runtime, but the lead pr
 
 | Provider | Native host | CLI wrapper | Public roles |
 |---|---|---|---|
-| Claude | Claude Code | `okstra-claude-exec.sh` | lead, analysis, implementation, report writer |
-| Codex | Codex | `okstra-codex-exec.sh` | lead, analysis, implementation, report writer |
-| Antigravity | Antigravity CLI | `okstra-antigravity-exec.sh` | lead, analysis, and implementation |
-| Grok | Grok CLI | `okstra-grok-exec.sh` | lead, read-only analyser, and critic |
-| Kimi | Kimi CLI | `okstra-kimi-exec.sh` | lead, read-only analyser, and critic |
+| Claude | Claude Code | `okstra-claude-exec.sh` | leader, analyser, designer, planner, implementer, verifier, report-writer, translator |
+| Codex | Codex | `okstra-codex-exec.sh` | leader, analyser, designer, planner, implementer, verifier, report-writer, translator |
+| Antigravity | Antigravity CLI | `okstra-antigravity-exec.sh` | leader, analyser, critic, implementer, verifier |
+| Grok | Grok CLI | `okstra-grok-exec.sh` | leader, read-only analyser, and critic |
+| Kimi | Kimi CLI | `okstra-kimi-exec.sh` | leader, read-only analyser, and critic |
+
+Canonical role names are `leader`, `analyser`, `critic`, `designer`, `planner`, `implementer`, `verifier`, `report-writer`, and `translator`. `lead` is a compatibility alias for `leader`. `executor` is a compatibility alias for `implementer`. New records write only the canonical names.
+
+Role count becomes a `RoleInstance` ordinal. `ModelPool` selects one model per ordinal. A pinned model is kept only when the host can bind it exactly. The resulting `RoleExecution` owns `Invocation` and `Attempt` rows and the stored `executionLabel`. Pane titles use that label. `okstra model list` and `okstra doctor --json` report pool state without an inference call.
 
 Grok and Kimi can now lead through their registered host adapters. Their worker roles remain read-only analyser and critic; executor, verifier, and report-writer roles were not added. A real authenticated local invocation still depends on the corresponding CLI being installed and configured.
 
@@ -56,7 +60,8 @@ okstra is **not** a one-shot code review tool. It is for work that **spans multi
 okstra/                          npm package = repo root
 ├── package.json                 name: "okstra"
 ├── bin/okstra                   Node CLI entry point
-├── src/                         Node CLI command modules (install, wizard, config, render, token usage, ...)
+├── src/                         TypeScript Node CLI sources (`*.mts`)
+├── dist/                        compiled `.mjs` CLI artifacts used by `bin/okstra`
 ├── tools/build.mjs              runtime/ synchronization script (invoked by prepack)
 ├── runtime/                     gitignored install payload copied to ~/.okstra
 ├── scripts/                     Python + Bash runtime sources
@@ -70,7 +75,7 @@ okstra/                          npm package = repo root
 └── RELEASING.md, CHANGELOG.md, README.md
 ```
 
-During `prepack`, `tools/build.mjs` rebuilds `runtime/` from `scripts/`, `skills/`, `agents/`, `prompts/`, `schemas/`, `templates/`, and `validators/`. This is the install payload copied to `~/.okstra`; the npm package also ships the Node CLI (`bin/`, `src/`), documentation, and the README.
+The package requires Node.js 22 or newer. TypeScript sources under `src/` compile to `dist/**/*.mjs` before `tools/build.mjs` rebuilds `runtime/` from `scripts/`, `skills/`, `agents/`, `prompts/`, `schemas/`, `templates/`, and `validators/`. `bin/okstra` executes `dist/`; the npm package ships the compiled CLI, runtime payload, documentation, and README.
 
 <a id="user-machine-layout-after-install"></a>
 ### 2.2 User-machine layout after install
@@ -217,7 +222,9 @@ This starts a new `claude` process in the lead role. For the complete argument l
 
 Notable workflow flags:
 
-- `--executor claude|codex|antigravity` — selects the provider that may mutate files for `--task-type implementation`. The other two providers are dispatched as strict read-only verifiers in the same run ([`docs/cli.md`](docs/cli.md#--executor)).
+- `--role-count <role>=<N>` — sets the total instance count for one static role. `lead` is a compatibility alias for `leader`.
+- `--role-model <role>=<modelRef>` — pins `<provider>/<model>` onto role instances in ordinal order. Unknown models fail before any side effect.
+- `--executor claude|codex|antigravity` — compatibility input that selects the implementer provider for `--task-type implementation`. The other two providers are dispatched as strict read-only verifiers in the same run ([`docs/cli.md`](docs/cli.md#--executor)).
 - `--work-category bugfix|feature|refactor|ops|improvement` — directly classifies work when the lifecycle skips the `requirements-discovery` phase.
 - `--approve` — with `--approved-plan`, toggles the plan's YAML frontmatter `approved` field from `false` to `true`, replacing the removed `--ack-approved` alias and the former `[ ] Approved` checkbox marker.
 - `--selected-direction <selection-final-report.md>` — starts a new `implementation-planning` run from a validated `implementation-option-selection` report. Existing planning reruns continue through `--clarification-response`.
@@ -246,7 +253,9 @@ Major workflow changes added to `main` after 0.8.0:
 | Command | Purpose |
 |---|---|
 | `npx -y okstra@latest paths` | Print runtime paths (`--field <name>` or `--shell`) |
-| `npx -y okstra@latest doctor [--runtime claude-code\|codex\|antigravity\|external\|all] [--phase <phase>]` | Diagnose runtime, skills, and Python imports. `codex`, `antigravity`, and `external` exclude Claude skill checks; `--phase` adds readiness checks for implementation, final-verification, release-handoff, and improvement-discovery |
+| `npx -y okstra@latest doctor [--runtime claude-code\|codex\|antigravity\|external\|all] [--phase <phase>]` | Diagnose runtime, skills, Python imports, and model-pool state. `codex`, `antigravity`, and `external` exclude Claude skill checks; `--phase` adds readiness checks for implementation, final-verification, release-handoff, and improvement-discovery. JSON includes `modelPool` and never sends an inference call |
+| `npx -y okstra@latest model list [--role <role>] [--host <host>] [--json]` | List catalog models and exact-binding availability without an inference call |
+| `npx -y okstra@latest model default set\|unset <role> ... --scope project\|global` | Write or remove role model defaults in `.okstra/project.json` or `~/.okstra/config.json` |
 | `npx -y okstra@latest ensure-installed` | Run an idempotent check and automatically reinstall stale assets (skills call this internally) |
 | `npx -y okstra@latest setup --project-id <id>` | Register the current project in `.okstra/project.json` |
 | `npx -y okstra@latest check-project` | Verify that the current project was registered with `setup` |

package/bin/okstra

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
-import { getPackageVersion } from "../src/lib/version.mjs";
-import { COMMANDS, USAGE } from "../src/cli-registry.mjs";
+import { getPackageVersion } from "../dist/lib/version.mjs";
+import { COMMANDS, USAGE } from "../dist/cli-registry.mjs";
 
+/** @param {readonly string[]} argv */
 async function main(argv) {
   const args = argv.slice(2);
 
@@ -40,8 +41,11 @@ async function main(argv) {
     const exitCode = await run(rest);
     return typeof exitCode === "number" ? exitCode : 0;
   } catch (err) {
-    process.stderr.write(`error: ${err.message}\n`);
-    if (process.env.OKSTRA_DEBUG) process.stderr.write(`${err.stack}\n`);
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`error: ${message}\n`);
+    if (process.env.OKSTRA_DEBUG && err instanceof Error && err.stack) {
+      process.stderr.write(`${err.stack}\n`);
+    }
     return 1;
   }
 }

package/dist/cli-registry.d.mts

@@ -0,0 +1,16 @@
+import type { CommandRunner } from "./lib/types.mjs";
+export declare const COMMAND_REGISTRY: ({
+    name: string;
+    module: string;
+    export: string;
+    category: "admin";
+    summary: string[];
+} | {
+    name: string;
+    module: string;
+    export: string;
+    category: "introspection";
+    summary: string[];
+})[];
+export declare const COMMANDS: Map<string, () => Promise<CommandRunner>>;
+export declare const USAGE: string;

package/dist/cli-registry.mjs

@@ -0,0 +1,560 @@
+const SUMMARY_COLUMN = 25;
+export const COMMAND_REGISTRY = [
+    {
+        name: "install",
+        module: "./commands/lifecycle/install.mjs",
+        export: "runInstall",
+        category: "admin",
+        summary: ["Install runtime; seed skills into Agent and Claude homes"],
+    },
+    {
+        name: "ensure-installed",
+        module: "./commands/lifecycle/install.mjs",
+        export: "runEnsureInstalled",
+        category: "admin",
+        summary: ["Verify install is fresh; reinstall if stale (idempotent)"],
+    },
+    {
+        name: "uninstall",
+        module: "./commands/lifecycle/uninstall.mjs",
+        export: "runUninstall",
+        category: "admin",
+        summary: ["Remove runtime + skills (user data preserved by default)"],
+    },
+    {
+        name: "setup",
+        module: "./commands/lifecycle/setup.mjs",
+        export: "run",
+        category: "admin",
+        summary: ["Register the current project (.okstra/project.json)"],
+    },
+    {
+        name: "doctor",
+        module: "./commands/lifecycle/doctor.mjs",
+        export: "run",
+        category: "admin",
+        summary: [
+            "Diagnostic check; --runtime selects assets, --phase checks readiness",
+        ],
+    },
+    {
+        name: "check-project",
+        module: "./commands/lifecycle/check-project.mjs",
+        export: "run",
+        category: "admin",
+        summary: ["Verify the current project has been registered with setup"],
+    },
+    {
+        name: "preflight",
+        module: "./commands/lifecycle/preflight.mjs",
+        export: "run",
+        category: "admin",
+        summary: ["One-call skill preflight: ensure-installed + check-project (JSON)"],
+    },
+    {
+        name: "config",
+        module: "./commands/lifecycle/config.mjs",
+        export: "run",
+        category: "admin",
+        summary: ["Read / write okstra settings (e.g. PR template path)"],
+    },
+    {
+        name: "migrate",
+        module: "./commands/lifecycle/migrate.mjs",
+        export: "run",
+        category: "admin",
+        summary: ["Move legacy .project-docs/okstra/ to .okstra/ (one-shot)"],
+    },
+    {
+        name: "convergence",
+        module: "./commands/execute/convergence.mjs",
+        export: "run",
+        category: "admin",
+        summary: ["Advance and validate deterministic re-verification state"],
+    },
+    {
+        name: "plan-items",
+        module: "./commands/execute/plan-items.mjs",
+        export: "run",
+        category: "admin",
+        summary: ["Extract and validate deterministic plan-body items"],
+    },
+    {
+        name: "agent-prompt",
+        module: "./commands/execute/agent-prompt.mjs",
+        export: "run",
+        category: "admin",
+        summary: ["Materialize and verify auditable agent invocations"],
+    },
+    {
+        name: "pane-title",
+        module: "./commands/execute/pane-title.mjs",
+        export: "run",
+        category: "admin",
+        summary: ["Lease pane titles from stored execution labels"],
+    },
+    {
+        name: "model",
+        module: "./commands/lifecycle/model.mjs",
+        export: "run",
+        category: "admin",
+        summary: ["List models and set or unset role model defaults"],
+    },
+    {
+        name: "worker-dispatch",
+        module: "./commands/execute/worker-dispatch.mjs",
+        export: "run",
+        category: "admin",
+        summary: ["Dispatch verified CLI-backed worker assignments"],
+    },
+    {
+        name: "plan-verify",
+        module: "./commands/execute/plan-verify.mjs",
+        export: "run",
+        category: "admin",
+        summary: ["Score the §5.5.9 plan-body gate for one self-fix round"],
+    },
+    {
+        name: "worker-audit-check",
+        module: "./commands/execute/worker-audit-check.mjs",
+        export: "run",
+        category: "admin",
+        summary: [
+            "Check a run's worker audit sidecars while the workers",
+            "are still alive (the Phase 7 rules, run early)",
+        ],
+    },
+    {
+        name: "git-reconcile",
+        module: "./commands/execute/git-reconcile.mjs",
+        export: "run",
+        category: "admin",
+        summary: ["Reconcile stale stage SHAs after external git history changes"],
+    },
+    {
+        name: "handoff",
+        module: "./commands/execute/handoff.mjs",
+        export: "run",
+        category: "admin",
+        summary: ["Stage-group release-handoff helpers (eligible/assemble/record)"],
+    },
+    {
+        name: "integrate-stages",
+        module: "./commands/execute/integrate-stages.mjs",
+        export: "run",
+        category: "admin",
+        summary: ["stage 들을 task 브랜치에 통합 머지하고 stage worktree 를 정리"],
+    },
+    {
+        name: "paths",
+        module: "./commands/lifecycle/paths.mjs",
+        export: "run",
+        category: "admin",
+        summary: [
+            "Print runtime paths (workspace/agents/pythonpath/bin/home/version)",
+        ],
+    },
+    {
+        name: "task-list",
+        module: "./commands/inspect/task-list.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["List tasks registered in the current project"],
+    },
+    {
+        name: "task-show",
+        module: "./commands/inspect/task-show.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Summarize a task's manifest + workflow phase state"],
+    },
+    {
+        name: "stage-map",
+        module: "./commands/inspect/stage-map.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Dump a task's implementation-planning Stage Map + done stages"],
+    },
+    {
+        name: "context-cost",
+        module: "./commands/inspect/context-cost.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Estimate file/read context cost for a task bundle"],
+    },
+    {
+        name: "resolve-task-key",
+        module: "./commands/inspect/resolve-task-key.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Resolve a bare task-id to candidate task-keys from the catalog"],
+    },
+    {
+        name: "code-review",
+        module: "./commands/inspect/code-review.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Resolve a code review's diff range and result file path"],
+    },
+    {
+        name: "set-work-status",
+        module: "./commands/inspect/set-work-status.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Set a task's user-managed workStatus in task-manifest.json"],
+    },
+    {
+        name: "time-report",
+        module: "./commands/inspect/time-report.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Aggregate elapsed work time across a task's runs (raw ms)"],
+    },
+    {
+        name: "usage-report",
+        module: "./commands/inspect/usage-report.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Aggregate recent token, cost, and time usage by task type"],
+    },
+    {
+        name: "log-report",
+        module: "./commands/inspect/log-report.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Inventory wrapper sidecar logs by size and task (read-only)"],
+    },
+    {
+        name: "worker-liveness",
+        module: "./commands/inspect/worker-liveness.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Report whether pending workers are still alive (read-only)"],
+    },
+    {
+        name: "error-report",
+        module: "./commands/inspect/error-report.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Aggregate okstra-run error logs into a task-level report"],
+    },
+    {
+        name: "error-zip",
+        module: "./commands/inspect/error-zip.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Bundle cross-project okstra error logs into a zip"],
+    },
+    {
+        name: "run-audit",
+        module: "./commands/inspect/run-audit.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Check okstra run artifacts against progress invariants"],
+    },
+    {
+        name: "recap",
+        module: "./commands/inspect/recap.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Assemble a task's run-to-run phase recap or append a recap log entry"],
+    },
+    {
+        name: "user-response",
+        module: "./commands/inspect/user-response.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Answer a task's open clarification questions in-session and write the response sidecar"],
+    },
+    {
+        name: "design-prep",
+        module: "./commands/inspect/design-prep.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Review and record AI-prepared implementation design inputs"],
+    },
+    {
+        name: "rollup",
+        module: "./commands/inspect/rollup.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Roll up run results across a task-group's tasks (raw ms + tallies)"],
+    },
+    {
+        name: "container",
+        module: "./commands/inspect/container.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Manage the okstra container runtime (up/status/logs/stop-watcher/down)"],
+    },
+    {
+        name: "manager",
+        module: "./commands/manager.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Manage cross-project okstra tasks"],
+    },
+    {
+        name: "worktree-lookup",
+        module: "./commands/execute/worktree-lookup.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Look up registered worktree for a task-key"],
+    },
+    {
+        name: "worktree-status",
+        module: "./commands/execute/worktree-status.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Clean-worktree check that ignores okstra's own scaffolding"],
+    },
+    {
+        name: "plan-validate",
+        module: "./commands/execute/plan-validate.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Check an approved-plan file for the approval marker"],
+    },
+    {
+        name: "render-bundle",
+        module: "./commands/execute/render-bundle.mjs",
+        export: "run",
+        category: "introspection",
+        summary: [
+            "Preview prepare_task_bundle() output (forwards to",
+            "python3 -m okstra_ctl.run --render-only)",
+        ],
+    },
+    {
+        name: "profile",
+        module: "./commands/inspect/profile-show.mjs",
+        export: "run",
+        category: "introspection",
+        summary: [
+            "Print a phase profile with {{INCLUDE:}} expanded and its",
+            "lazy-read sidecars appended (read-only)",
+        ],
+    },
+    {
+        name: "run",
+        module: "./commands/execute/run.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Host-aware auto execution front door"],
+    },
+    {
+        name: "codex-run",
+        module: "./commands/execute/codex-run.mjs",
+        export: "run",
+        category: "introspection",
+        summary: [
+            "Prepare a render-only Codex lead task bundle",
+            "(--lead-runtime codex, no worker dispatch)",
+        ],
+    },
+    {
+        name: "codex-dispatch",
+        module: "./commands/execute/codex-dispatch.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Dispatch CLI-backed workers for a prepared Codex run"],
+    },
+    {
+        name: "worker-state",
+        module: "./commands/execute/worker-state.mjs",
+        export: "run",
+        category: "admin",
+        summary: ["Atomically transition persisted worker status"],
+    },
+    {
+        name: "team",
+        module: "./commands/execute/team.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Dispatch and await pane-backed workers for external leads"],
+    },
+    {
+        name: "wizard",
+        module: "./commands/execute/wizard.mjs",
+        export: "run",
+        category: "introspection",
+        summary: [
+            "Drive the okstra-run interactive input state machine",
+            "(init / step / render-args / confirmation)",
+        ],
+    },
+    {
+        name: "token-usage",
+        module: "./commands/execute/token-usage.mjs",
+        export: "run",
+        category: "introspection",
+        summary: [
+            "Collect token usage for a run (wraps the installed",
+            "okstra-token-usage.py so skills avoid emitting",
+            'python3 "$HOME/..." invocations).',
+        ],
+    },
+    {
+        name: "render-views",
+        module: "./commands/report/render-views.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Render slim AI + self-contained HTML views of a final report"],
+    },
+    {
+        name: "report-translate",
+        module: "./commands/report/translate.mjs",
+        export: "run",
+        category: "introspection",
+        summary: [
+            "Build and verify the translation sidecar the HTML",
+            "renderer overlays when the report language is not",
+            "English (extract | check).",
+        ],
+    },
+    {
+        name: "agent-activity",
+        module: "./commands/report/agent-activity.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Record and project structured lead activity into report data"],
+    },
+    {
+        name: "report-finalize",
+        module: "./commands/report/finalize.mjs",
+        export: "run",
+        category: "introspection",
+        summary: [
+            "Run the Phase 7 post-report sequence (token-usage,",
+            "render-views, spawn-followups, validate-run) in its",
+            "contractual order against one final report.",
+        ],
+    },
+    {
+        name: "render-final-report",
+        module: "./commands/report/render-final-report.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Render the markdown sibling of a final-report data.json"],
+    },
+    {
+        name: "inject-report-index",
+        module: "./commands/report/inject-report-index.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Add the top-of-report Index + scroll anchors to a report"],
+    },
+    {
+        name: "spawn-followups",
+        module: "./commands/execute/spawn-followups.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Create follow-up task bundles from a final report"],
+    },
+    {
+        name: "error-log",
+        module: "./commands/execute/error-log.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Append run error events to the run error log"],
+    },
+    {
+        name: "incremental-scope",
+        module: "./commands/execute/incremental-scope.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Decide re-verify vs carry-forward scope for a clarification re-run"],
+    },
+    {
+        name: "incremental-carry",
+        module: "./commands/execute/incremental-carry.mjs",
+        export: "run",
+        category: "introspection",
+        summary: ["Merge carried-forward plan-item verdicts into an incremental re-run"],
+    },
+    {
+        name: "memory",
+        module: "./commands/memory/memory.mjs",
+        export: "run",
+        category: "introspection",
+        summary: [
+            "Store and find user-home conversation memory under",
+            "~/.okstra/memory-book.",
+        ],
+    },
+    {
+        name: "pr",
+        module: "./commands/pr/pr.mjs",
+        export: "run",
+        category: "introspection",
+        summary: [
+            "Manage PR body templates and prepare PR generation",
+            "bundles under ~/.okstra/template/pr.",
+        ],
+    },
+];
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function isCommandRunner(value) {
+    return typeof value === "function";
+}
+async function loadCommand(definition) {
+    const moduleRecord = await import(definition.module);
+    if (!isRecord(moduleRecord)) {
+        throw new Error(`command module is not an object: ${definition.module}`);
+    }
+    const runner = moduleRecord[definition.export];
+    if (!isCommandRunner(runner)) {
+        throw new Error(`command export is not callable: ${definition.module}#${definition.export}`);
+    }
+    return runner;
+}
+export const COMMANDS = new Map(COMMAND_REGISTRY.map((c) => [
+    c.name,
+    () => loadCommand(c),
+]));
+const PREAMBLE = `okstra — host-aware multi-provider cross-verification orchestrator
+
+This CLI is the installer/admin tool. Day-to-day usage happens inside a
+supported agent host through installed skills (okstra-setup, okstra-run, ...).
+
+Quick start (CLI):
+  1. npx -y okstra@latest install                       # one-time, this machine
+  2. cd <your project>
+  3. npx -y okstra@latest setup --project-id <id>       # one-time, this project
+  4. open Claude Code, Codex, or Antigravity and run okstra-run  # start a task
+
+Inside a supported agent host you can replace step 3 with okstra-setup —
+both write the same <PROJECT_ROOT>/.okstra/project.json.
+
+Usage:
+  okstra <command> [options]
+`;
+const GLOBAL_OPTIONS = `  --version              Print okstra version and exit
+  --help                 Print this help`;
+const FOOTER = `
+
+Run 'okstra <command> --help' for command-specific options.
+Docs: https://github.com/Devonshin/okstra#readme
+`;
+function renderRow(command) {
+    const [first, ...rest] = command.summary;
+    const head = "  " + command.name.padEnd(SUMMARY_COLUMN - 2) + first;
+    const continuations = rest.map((line) => " ".repeat(SUMMARY_COLUMN) + line);
+    return [head, ...continuations].join("\n");
+}
+function renderRows(category) {
+    return COMMAND_REGISTRY.filter((c) => c.category === category)
+        .map(renderRow)
+        .join("\n");
+}
+export const USAGE = PREAMBLE +
+    "\nAdmin commands:\n" +
+    renderRows("admin") +
+    "\n\nIntrospection commands (JSON output, used by skills to avoid python heredocs):\n" +
+    renderRows("introspection") +
+    "\n\nGlobal options:\n" +
+    GLOBAL_OPTIONS +
+    FOOTER;
+//# sourceMappingURL=cli-registry.mjs.map