@zhuk/spego 0.8.0 → 0.10.1

package/dist/cli/commands/orchestrate.js

@@ -0,0 +1,51 @@
+/**
+ * `spego orchestrate` — run the multi-agent orchestration pipeline over an
+ * OpenSpec change and emit a structured verdict in human or `--json` mode.
+ */
+import path from 'node:path';
+import { orchestrateChange } from '../../orchestration/index.js';
+import { renderHeader, renderTable } from '../render.js';
+import { runCommand } from '../runtime.js';
+const VALID_MODES = new Set(['sequential', 'parallel', 'adaptive']);
+export function registerOrchestrate(program) {
+    program
+        .command('orchestrate')
+        .description('Run the multi-agent orchestration pipeline for an OpenSpec change')
+        .requiredOption('--change <name>', 'OpenSpec change name to orchestrate')
+        .option('--mode <mode>', 'sequential | parallel | adaptive (default: from breakdown)')
+        .option('--skip-verify', 'skip the verifier step', false)
+        .option('--cwd <dir>', 'project root')
+        .action(async (opts) => {
+        await runCommand({ program }, async () => {
+            const mode = opts.mode && VALID_MODES.has(opts.mode) ? opts.mode : undefined;
+            const outcome = await orchestrateChange({
+                projectRoot: path.resolve(opts.cwd ?? process.cwd()),
+                changeName: opts.change,
+                mode,
+                skipVerify: Boolean(opts.skipVerify),
+            });
+            return {
+                payload: outcome,
+                human: () => {
+                    const verdict = outcome.verdict.passed ? 'PASS' : 'FAIL';
+                    const rows = outcome.results.map((r) => [
+                        r.success ? '[x]' : '[ ]',
+                        r.subtaskId,
+                        r.error ?? '',
+                    ]);
+                    const table = renderTable(['ok', 'subtask', 'error'], rows);
+                    return [
+                        renderHeader('🧭', `Orchestrate: ${outcome.changeName}`),
+                        `goal     ${outcome.goal}`,
+                        `mode     ${outcome.executionMode}`,
+                        `tasks    ${outcome.tasksSucceeded}/${outcome.tasksTotal} succeeded`,
+                        `verdict  ${verdict}`,
+                        '',
+                        table,
+                    ].join('\n');
+                },
+            };
+        });
+    });
+}
+//# sourceMappingURL=orchestrate.js.map

package/dist/cli/commands/orchestrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrate.js","sourceRoot":"","sources":["../../../src/cli/commands/orchestrate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAgB,CAAC,YAAY,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AAEnF,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,mEAAmE,CAAC;SAChF,cAAc,CAAC,iBAAiB,EAAE,qCAAqC,CAAC;SACxE,MAAM,CAAC,eAAe,EAAE,4DAA4D,CAAC;SACrF,MAAM,CAAC,eAAe,EAAE,wBAAwB,EAAE,KAAK,CAAC;SACxD,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC;SACrC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,UAAU,CAAuB,EAAE,OAAO,EAAE,EAAE,KAAK,IAAI,EAAE;YAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,IAAsB,CAAC,CAAC,CAAC,SAAS,CAAC;YAChG,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC;gBACtC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBACpD,UAAU,EAAE,IAAI,CAAC,MAAM;gBACvB,IAAI;gBACJ,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;aACrC,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,GAAG,EAAE;oBACV,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;oBACzD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;wBACtC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;wBACzB,CAAC,CAAC,SAAS;wBACX,CAAC,CAAC,KAAK,IAAI,EAAE;qBACd,CAAC,CAAC;oBACH,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;oBAC5D,OAAO;wBACL,YAAY,CAAC,IAAI,EAAE,gBAAgB,OAAO,CAAC,UAAU,EAAE,CAAC;wBACxD,YAAY,OAAO,CAAC,IAAI,EAAE;wBAC1B,YAAY,OAAO,CAAC,aAAa,EAAE;wBACnC,YAAY,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,UAAU,YAAY;wBACpE,YAAY,OAAO,EAAE;wBACrB,EAAE;wBACF,KAAK;qBACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACf,CAAC;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/skills.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Skill regeneration: `spego skills` (and the hidden `regenerate` alias).
+ */
+import type { Command } from 'commander';
+export declare function registerSkills(program: Command): void;

package/dist/cli/commands/skills.js

@@ -0,0 +1,49 @@
+/**
+ * Skill regeneration: `spego skills` (and the hidden `regenerate` alias).
+ */
+import path from 'node:path';
+import { resolveWorkspacePaths } from '../../workspace/paths.js';
+import { readConfig } from '../../workspace/config.js';
+import { generateAll } from '../../generator/index.js';
+import { emitOrchestrationAssets } from '../../orchestration/emit.js';
+import { renderHeader } from '../render.js';
+import { deprecate } from '../output.js';
+import { runCommand } from '../runtime.js';
+async function runSkills(cwd, json) {
+    const projectRoot = path.resolve(cwd ?? process.cwd());
+    const wsPaths = resolveWorkspacePaths(projectRoot);
+    const config = await readConfig(wsPaths.configPath);
+    const reports = await generateAll(projectRoot, config.agents, { emitWarnings: !json });
+    reports.push(await emitOrchestrationAssets(projectRoot));
+    const human = () => {
+        const lines = [renderHeader('🛠️', 'Skill regeneration'), ''];
+        for (const r of reports) {
+            lines.push(`[${r.target}]`);
+            for (const f of r.files) {
+                lines.push(`  ${f.action}  ${f.path}`);
+            }
+        }
+        return lines.join('\n');
+    };
+    return { payload: reports, human };
+}
+export function registerSkills(program) {
+    program
+        .command('skills')
+        .description('Regenerate agent skill and command files')
+        .option('--cwd <dir>', 'project root')
+        .action(async (opts) => {
+        await runCommand({ program }, async (json) => runSkills(opts.cwd, json));
+    });
+    program
+        .command('regenerate', { hidden: true })
+        .description('Regenerate agent skill and command files')
+        .option('--cwd <dir>', 'project root')
+        .action(async (opts) => {
+        await runCommand({ program }, async (json) => {
+            deprecate(json, "'spego regenerate' is now 'spego skills'");
+            return runSkills(opts.cwd, json);
+        });
+    });
+}
+//# sourceMappingURL=skills.js.map

package/dist/cli/commands/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../src/cli/commands/skills.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,KAAK,UAAU,SAAS,CAAC,GAAuB,EAAE,IAAa;IAI7D,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IACvF,OAAO,CAAC,IAAI,CAAC,MAAM,uBAAuB,CAAC,WAAW,CAAC,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,GAAW,EAAE;QACzB,MAAM,KAAK,GAAa,CAAC,YAAY,CAAC,KAAK,EAAE,oBAAoB,CAAC,EAAE,EAAE,CAAC,CAAC;QACxE,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;YAC5B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,0CAA0C,CAAC;SACvD,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC;SACrC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;SACvC,WAAW,CAAC,0CAA0C,CAAC;SACvD,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC;SACrC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC3C,SAAS,CAAC,IAAI,EAAE,0CAA0C,CAAC,CAAC;YAC5D,OAAO,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/view.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Bundle export: `spego view`.
+ *
+ * Honors the deprecated `--format` flag during the deprecation window in
+ * addition to the global `--json` flag.
+ */
+import type { Command } from 'commander';
+export declare function registerView(program: Command): void;

package/dist/cli/commands/view.js

@@ -0,0 +1,59 @@
+/**
+ * Bundle export: `spego view`.
+ *
+ * Honors the deprecated `--format` flag during the deprecation window in
+ * addition to the global `--json` flag.
+ */
+import { ArtifactEngine } from '../../artifacts/engine.js';
+import { viewArtifacts } from '../../export/view.js';
+import { intersperseBundleDividers, renderHeader } from '../render.js';
+import { deprecate, emitJson } from '../output.js';
+import { fail } from '../errors.js';
+import { getJsonMode } from '../runtime.js';
+export function registerView(program) {
+    program
+        .command('view')
+        .description('Export artifact bundle as markdown (default) or JSON via --json')
+        .option('--type <type>', 'filter by type')
+        .option('--id <id>', 'limit to a single artifact')
+        .option('--revision <n>', 'specific revision (requires --id)')
+        .option('--include-deleted', 'include soft-deleted artifacts', false)
+        .option('--format <fmt>', '[deprecated] markdown | json — use the global --json flag instead')
+        .option('--cwd <dir>', 'project root')
+        .action(async (opts) => {
+        const globalJson = getJsonMode(program);
+        if (opts.format !== undefined) {
+            deprecate(globalJson, '--format is deprecated; use the global --json flag');
+        }
+        const wantJson = globalJson || opts.format === 'json';
+        let engine;
+        try {
+            engine = await ArtifactEngine.open({ projectRoot: opts.cwd });
+        }
+        catch (err) {
+            fail(err, wantJson);
+        }
+        try {
+            const view = await viewArtifacts(engine, {
+                type: opts.type,
+                id: opts.id,
+                revision: opts.revision !== undefined ? Number(opts.revision) : undefined,
+                includeDeleted: opts.includeDeleted,
+            });
+            if (wantJson) {
+                emitJson(view.json);
+            }
+            else {
+                const body = intersperseBundleDividers(view.markdown.content);
+                process.stdout.write(`${renderHeader('📦', 'Artifact bundle')}\n${body}`);
+            }
+        }
+        catch (err) {
+            fail(err, wantJson);
+        }
+        finally {
+            engine.close();
+        }
+    });
+}
+//# sourceMappingURL=view.js.map

package/dist/cli/commands/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../src/cli/commands/view.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,iEAAiE,CAAC;SAC9E,MAAM,CAAC,eAAe,EAAE,gBAAgB,CAAC;SACzC,MAAM,CAAC,WAAW,EAAE,4BAA4B,CAAC;SACjD,MAAM,CAAC,gBAAgB,EAAE,mCAAmC,CAAC;SAC7D,MAAM,CAAC,mBAAmB,EAAE,gCAAgC,EAAE,KAAK,CAAC;SACpE,MAAM,CAAC,gBAAgB,EAAE,mEAAmE,CAAC;SAC7F,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC;SACrC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,SAAS,CAAC,UAAU,EAAE,oDAAoD,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,QAAQ,GAAG,UAAU,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC;QAEtD,IAAI,MAAsB,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACtB,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE;gBACvC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,QAAQ,EAAE,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;gBACzE,cAAc,EAAE,IAAI,CAAC,cAAc;aACpC,CAAC,CAAC;YACH,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAG,yBAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,IAAI,EAAE,iBAAiB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/workspace.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Workspace lifecycle commands: `init` and `status`.
+ */
+import type { Command } from 'commander';
+export declare function registerWorkspace(program: Command): void;

package/dist/cli/commands/workspace.js

@@ -0,0 +1,61 @@
+/**
+ * Workspace lifecycle commands: `init` and `status`.
+ */
+import { initWorkspace, workspaceStatus } from '../../workspace/init.js';
+import { renderBox, renderHeader } from '../render.js';
+import { runCommand } from '../runtime.js';
+export function registerWorkspace(program) {
+    program
+        .command('init')
+        .description('Initialize a .spego/ workspace in the current project')
+        .option('--agents <list>', 'comma-separated list of agent toolchains', 'claude')
+        .option('--demo <bool>', 'seed demo artifacts (true|false)', 'false')
+        .option('--force', 'overwrite config (does not delete artifacts)', false)
+        .option('--cwd <dir>', 'project root (defaults to current directory)')
+        .action(async (opts) => {
+        await runCommand({ program }, async () => {
+            const summary = await initWorkspace({
+                projectRoot: opts.cwd,
+                agents: String(opts.agents).split(',').map((s) => s.trim()).filter(Boolean),
+                demo: opts.demo === 'true',
+                force: opts.force,
+            });
+            const human = () => {
+                const headerLabel = summary.alreadyInitialized
+                    ? 'Workspace already initialized'
+                    : 'Initialized spego workspace';
+                const box = renderBox('Workspace', [
+                    ['root', summary.workspaceRoot],
+                    ['config', summary.configPath],
+                    ['artifacts', summary.artifactsRoot],
+                    ['index', summary.indexPath],
+                    ['agents', summary.config.agents.join(', ')],
+                ]);
+                return `${renderHeader('📦', headerLabel)}\n${box}`;
+            };
+            return { payload: summary, human };
+        });
+    });
+    program
+        .command('status')
+        .description('Report workspace status')
+        .option('--cwd <dir>', 'project root')
+        .action(async (opts) => {
+        await runCommand({ program }, async () => {
+            const status = await workspaceStatus(opts.cwd);
+            const human = () => {
+                if (!status.initialized)
+                    return `No spego workspace; run: spego init`;
+                const box = renderBox('Workspace status', [
+                    ['root', status.workspaceRoot ?? ''],
+                    ['agents', status.agents?.join(', ') ?? '(none)'],
+                    ['artifacts', status.artifactsRoot ?? ''],
+                    ['index', status.indexPath ?? ''],
+                ]);
+                return `${renderHeader('📦', 'Workspace ready')}\n${box}`;
+            };
+            return { payload: status, human };
+        });
+    });
+}
+//# sourceMappingURL=workspace.js.map

package/dist/cli/commands/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../src/cli/commands/workspace.ts"],"names":[],"mappings":"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"}

package/dist/cli/errors.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Centralized error formatting for the CLI.
+ *
+ * Every command and the program-level `exitOverride` route through this module
+ * so the human and JSON envelopes stay consistent and `error.details` is always
+ * an object — never undefined — so agents can branch on the shape safely.
+ */
+/** Format and write a `SpegoError`/`Error`/unknown error to stderr; never returns. */
+export declare function fail(err: unknown, json: boolean): never;
+/**
+ * Format and write a commander validation error; never returns.
+ *
+ * Validation errors always exit with code 2, matching `SpegoError`, so agents
+ * can branch on `exitCode === 2 ⇒ structured error` regardless of source.
+ * Commander's default `exitCode` (1 for unknown options) is intentionally
+ * overridden here.
+ */
+export declare function failValidation(err: {
+    message: string;
+}, json: boolean): never;

package/dist/cli/errors.js

@@ -0,0 +1,55 @@
+/**
+ * Centralized error formatting for the CLI.
+ *
+ * Every command and the program-level `exitOverride` route through this module
+ * so the human and JSON envelopes stay consistent and `error.details` is always
+ * an object — never undefined — so agents can branch on the shape safely.
+ */
+import { SpegoError } from '../errors.js';
+function spegoErrorEnvelope(err) {
+    return { error: { code: err.code, message: err.message, details: err.details ?? {} } };
+}
+function genericErrorEnvelope(message) {
+    return { error: { code: 'INTERNAL', message, details: {} } };
+}
+function validationEnvelope(message) {
+    return { error: { code: 'VALIDATION_FAILED', message, details: {} } };
+}
+/** Format and write a `SpegoError`/`Error`/unknown error to stderr; never returns. */
+export function fail(err, json) {
+    if (err instanceof SpegoError) {
+        if (json) {
+            process.stderr.write(`${JSON.stringify(spegoErrorEnvelope(err), null, 2)}\n`);
+        }
+        else {
+            process.stderr.write(`⚠️  [${err.code}] ${err.message}\n`);
+        }
+        process.exit(2);
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    if (json) {
+        process.stderr.write(`${JSON.stringify(genericErrorEnvelope(message), null, 2)}\n`);
+    }
+    else {
+        process.stderr.write(`⚠️  [INTERNAL] ${message}\n`);
+    }
+    process.exit(1);
+}
+/**
+ * Format and write a commander validation error; never returns.
+ *
+ * Validation errors always exit with code 2, matching `SpegoError`, so agents
+ * can branch on `exitCode === 2 ⇒ structured error` regardless of source.
+ * Commander's default `exitCode` (1 for unknown options) is intentionally
+ * overridden here.
+ */
+export function failValidation(err, json) {
+    if (json) {
+        process.stderr.write(`${JSON.stringify(validationEnvelope(err.message), null, 2)}\n`);
+    }
+    else {
+        process.stderr.write(`⚠️  [VALIDATION_FAILED] ${err.message}\n`);
+    }
+    process.exit(2);
+}
+//# sourceMappingURL=errors.js.map

package/dist/cli/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/cli/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM1C,SAAS,kBAAkB,CAAC,GAAe;IACzC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,EAAE,CAAC;AACzF,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAe;IAC3C,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC;AAC/D,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAe;IACzC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC;AACxE,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,IAAI,CAAC,GAAY,EAAE,IAAa;IAC9C,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;QAC9B,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAChF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACtF,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,OAAO,IAAI,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,GAAwB,EAAE,IAAa;IACpE,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACxF,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/cli/output.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Stdout/stderr output primitives for the CLI.
+ *
+ * Centralizes JSON vs human emission, deprecation warnings, and trailing-newline
+ * handling so individual command actions never branch on `--json` more than once.
+ */
+export declare function emitJson(payload: unknown): void;
+export declare function emitHuman(text: string): void;
+/** Emit `payload` as JSON when `json` is true, otherwise lazily render and emit human text. */
+export declare function output(json: boolean, payload: unknown, human: () => string): void;
+/** Write a single-line `deprecated: <message>` warning to stderr in human mode only. */
+export declare function deprecate(json: boolean, message: string): void;

package/dist/cli/output.js

@@ -0,0 +1,28 @@
+/**
+ * Stdout/stderr output primitives for the CLI.
+ *
+ * Centralizes JSON vs human emission, deprecation warnings, and trailing-newline
+ * handling so individual command actions never branch on `--json` more than once.
+ */
+export function emitJson(payload) {
+    process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+}
+export function emitHuman(text) {
+    process.stdout.write(text.endsWith('\n') ? text : `${text}\n`);
+}
+/** Emit `payload` as JSON when `json` is true, otherwise lazily render and emit human text. */
+export function output(json, payload, human) {
+    if (json) {
+        emitJson(payload);
+    }
+    else {
+        emitHuman(human());
+    }
+}
+/** Write a single-line `deprecated: <message>` warning to stderr in human mode only. */
+export function deprecate(json, message) {
+    if (!json) {
+        process.stderr.write(`deprecated: ${message}\n`);
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/cli/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,UAAU,QAAQ,CAAC,OAAgB;IACvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;AACjE,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,MAAM,CAAC,IAAa,EAAE,OAAgB,EAAE,KAAmB;IACzE,IAAI,IAAI,EAAE,CAAC;QACT,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,SAAS,CAAC,IAAa,EAAE,OAAe;IACtD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,OAAO,IAAI,CAAC,CAAC;IACnD,CAAC;AACH,CAAC"}

package/dist/cli/render.d.ts

@@ -42,3 +42,10 @@ export declare function renderTable(columns: string[], rows: string[][], opts?:
 export declare function renderHeader(emoji: string, label: string): string;
 /** Render a `─` divider of the given width (default 60). */
 export declare function renderDivider(width?: number): string;
+/**
+ * Insert `─` dividers between consecutive artifact sections in a markdown
+ * bundle. A section boundary is any line that starts with `## `; the first
+ * such line is left untouched, every subsequent boundary is preceded by
+ * `\n<divider>\n\n`.
+ */
+export declare function intersperseBundleDividers(markdown: string): string;

package/dist/cli/render.js

@@ -87,4 +87,26 @@ export function renderHeader(emoji, label) {
 export function renderDivider(width = 60) {
     return '─'.repeat(Math.max(1, width));
 }
+/**
+ * Insert `─` dividers between consecutive artifact sections in a markdown
+ * bundle. A section boundary is any line that starts with `## `; the first
+ * such line is left untouched, every subsequent boundary is preceded by
+ * `\n<divider>\n\n`.
+ */
+export function intersperseBundleDividers(markdown) {
+    const lines = markdown.split('\n');
+    const out = [];
+    let seenFirstSection = false;
+    const divider = renderDivider();
+    for (const line of lines) {
+        if (line.startsWith('## ')) {
+            if (seenFirstSection) {
+                out.push('', divider, '');
+            }
+            seenFirstSection = true;
+        }
+        out.push(line);
+    }
+    return out.join('\n');
+}
 //# sourceMappingURL=render.js.map

package/dist/cli/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/cli/render.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/cli/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAEnC,iFAAiF;AACjF,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,KAAa;IACnD,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1B,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC5B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;AACzC,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,KAAa;IACnD,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,IAA6B;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACvE,8CAA8C;IAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,GAAG,UAAU,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,+BAA+B;IAEpE,uEAAuE;IACvE,sEAAsE;IACtE,kEAAkE;IAClE,MAAM,SAAS,GAAG,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC7F,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC;IAE7C,MAAM,IAAI,GAAG,IAAI;SACd,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,GAAG,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,KAAK,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC;IAC/C,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,KAAK,IAAI,KAAK,MAAM,EAAE,CAAC;AAC5F,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CACzB,OAAiB,EACjB,IAAgB,EAChB,OAA8B,EAAE;IAEhC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,uBAAuB,CAAC;IAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,CAAC,KAAe,EAAU,EAAE,CAC5C,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IAEtF,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IACtE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5C,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,KAAK,OAAO,KAAK,IAAI,EAAE,CAAC;AACxF,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,KAAa;IACvD,OAAO,GAAG,KAAK,IAAI,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE;IAC9C,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACxD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAC7B,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,IAAI,gBAAgB,EAAE,CAAC;gBACrB,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;YAC5B,CAAC;YACD,gBAAgB,GAAG,IAAI,CAAC;QAC1B,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/cli/runtime.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared runtime for spego CLI command actions.
+ *
+ * Eliminates the per-command `try/catch/finally` boilerplate by routing every
+ * command through `runCommand` (no engine) or `runEngineCommand` (auto-managed
+ * `ArtifactEngine`). Each helper resolves the global `--json` flag, emits the
+ * success payload through `output`, and routes errors through `fail`, so the
+ * CLI surface stays small and uniform.
+ */
+import type { Command } from 'commander';
+import { ArtifactEngine } from '../artifacts/engine.js';
+export interface CommandResult<T> {
+    payload: T;
+    human: () => string;
+}
+interface RuntimeContext {
+    program: Command;
+}
+export declare function getJsonMode(program: Command): boolean;
+/** Run a command body that does not need an `ArtifactEngine`. */
+export declare function runCommand<T>(ctx: RuntimeContext, fn: (json: boolean) => Promise<CommandResult<T>>): Promise<void>;
+/** Run a command body that needs an `ArtifactEngine`; the engine is closed on every exit path. */
+export declare function runEngineCommand<T>(ctx: RuntimeContext & {
+    cwd?: string;
+}, fn: (engine: ArtifactEngine, json: boolean) => Promise<CommandResult<T>>): Promise<void>;
+export {};

package/dist/cli/runtime.js

@@ -0,0 +1,48 @@
+/**
+ * Shared runtime for spego CLI command actions.
+ *
+ * Eliminates the per-command `try/catch/finally` boilerplate by routing every
+ * command through `runCommand` (no engine) or `runEngineCommand` (auto-managed
+ * `ArtifactEngine`). Each helper resolves the global `--json` flag, emits the
+ * success payload through `output`, and routes errors through `fail`, so the
+ * CLI surface stays small and uniform.
+ */
+import { ArtifactEngine } from '../artifacts/engine.js';
+import { output } from './output.js';
+import { fail } from './errors.js';
+export function getJsonMode(program) {
+    return program.opts().json;
+}
+/** Run a command body that does not need an `ArtifactEngine`. */
+export async function runCommand(ctx, fn) {
+    const json = getJsonMode(ctx.program);
+    try {
+        const { payload, human } = await fn(json);
+        output(json, payload, human);
+    }
+    catch (err) {
+        fail(err, json);
+    }
+}
+/** Run a command body that needs an `ArtifactEngine`; the engine is closed on every exit path. */
+export async function runEngineCommand(ctx, fn) {
+    const json = getJsonMode(ctx.program);
+    let engine;
+    try {
+        engine = await ArtifactEngine.open({ projectRoot: ctx.cwd });
+    }
+    catch (err) {
+        fail(err, json);
+    }
+    try {
+        const { payload, human } = await fn(engine, json);
+        output(json, payload, human);
+    }
+    catch (err) {
+        fail(err, json);
+    }
+    finally {
+        engine.close();
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/cli/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/cli/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAWnC,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,IAAe,CAAC;AACxC,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAmB,EACnB,EAAgD;IAEhD,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,kGAAkG;AAClG,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAsC,EACtC,EAAwE;IAExE,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,MAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAClB,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/cli.d.ts

@@ -1,3 +1,11 @@
 #!/usr/bin/env node
+/**
+ * spego CLI orchestrator.
+ *
+ * `buildProgram` wires the global `--json` flag, the program-level help and
+ * version handling, and one registrar per command group. Every command body
+ * lives under `src/cli/commands/` and routes through the shared runtime helper
+ * in `src/cli/runtime.ts`. Error formatting is centralized in `src/cli/errors.ts`.
+ */
 import { Command } from 'commander';
 export declare function buildProgram(): Command;