@zhuk/spego 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.9.0] - 2026-05-29
+
+### Changed
+- Refactored the CLI into shared runtime helpers and per-command registrars, reducing duplicated JSON/output/error/engine lifecycle code while preserving public command names and flags.
+- `spego update --json` now returns the artifact `frontmatter`, `body`, and `path` in addition to the existing `id` and `revision` fields, matching `spego read --json` for agent parsing.
+- Human output is more consistent across commands: `create`, `delete`, and `index rebuild` now use the same section-header style as the rest of the CLI.
+- JSON validation errors now always include `details: {}` and exit with code 2, matching other structured CLI failures.
+
+### Added
+- Shared body input handling for `spego create` and `spego update`, including stdin support through `--body-file -`.
+- End-to-end CLI coverage for `epics`, `tasks`, read selectors, revision reads, optimistic concurrency, view filters, body-file/stdin input, uninitialized status JSON, registry parity, and validation error envelopes.
+- OpenSpec change `2026-05-29-clean-cli-command-surface` documenting and validating the CLI cleanup.
+
+### Fixed
+- `npm run lint` now includes `test/cli-help-exit.test.ts` and the new CLI test files in ESLint project-service configuration.
+
 ## [0.8.0] - 2026-05-22
 
 ### Added

package/README.md

@@ -35,13 +35,17 @@ All commands accept `--cwd <dir>` to set the project root.
 
 Every spego command speaks two output modes:
 
-- **Human (default)** — pretty, scannable output for terminals. Section headers use a single emoji prefix (`📦 📄 🛠️ 🧭 📚 ✅`), summaries render as bordered boxes (`╭─ … ─╮`), lists render as aligned tables, and `view` separates artifacts with `────` dividers. Errors print as `⚠️  [CODE] message` to stderr.
-- **JSON (opt-in)** — pass the global `--json` flag to get deterministic, decoration-free JSON on stdout. Errors come back as `{ "error": { "code", "message", "details" } }` on stderr.
+- **Human (default)** — pretty, scannable output for terminals. Section headers use a single emoji prefix (`📦 📄 🛠️ 🧭 📚 ✅ ✨ 🗑`), summaries render as bordered boxes (`╭─ … ─╮`), lists render as aligned tables, and `view` separates artifacts with `────` dividers. Errors print as `⚠️  [CODE] message` to stderr.
+- **JSON (opt-in)** — pass the global `--json` flag to get deterministic, decoration-free JSON on stdout. Errors come back as `{ "error": { "code", "message", "details" } }` on stderr; `details` is always an object.
 
 Agents calling spego MUST pass `--json` so they get parseable output. Humans normally do not.
 
 The legacy `spego view --format markdown|json` flag is **deprecated** and will be removed in the next minor release. Use the global `--json` flag instead. The old flag still works during the deprecation window and prints a single `deprecated:` warning line to stderr.
 
+`spego read --json` and `spego update --json` both return artifact records with `frontmatter`, `body`, and `path`; `update` also keeps the compatibility fields `id` and `revision`.
+
+`spego create` and `spego update` accept body content through `--body`, `--body-file <path>`, or stdin via `--body-file -`.
+
 ## Architecture
 
 - Markdown files are the source of truth (`.spego/artifacts/<type>/<slug>.md`)

package/dist/cli/body-input.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Unified body-input resolution for `spego create` and `spego update`.
+ *
+ * Accepts either an inline `--body` string, a `--body-file <path>` reference,
+ * or stdin when `--body-file -`. Returns `undefined` when no body source was
+ * supplied so callers can leave the artifact body unchanged.
+ */
+export interface BodyInputOptions {
+    body?: string;
+    bodyFile?: string;
+}
+export declare function resolveBody(opts: BodyInputOptions): Promise<string | undefined>;

package/dist/cli/body-input.js

@@ -0,0 +1,27 @@
+/**
+ * Unified body-input resolution for `spego create` and `spego update`.
+ *
+ * Accepts either an inline `--body` string, a `--body-file <path>` reference,
+ * or stdin when `--body-file -`. Returns `undefined` when no body source was
+ * supplied so callers can leave the artifact body unchanged.
+ */
+import fs from 'node:fs/promises';
+async function readStdin() {
+    return new Promise((resolve, reject) => {
+        let buf = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', (chunk) => {
+            buf += chunk;
+        });
+        process.stdin.on('end', () => resolve(buf));
+        process.stdin.on('error', reject);
+    });
+}
+export async function resolveBody(opts) {
+    if (opts.bodyFile === '-')
+        return readStdin();
+    if (opts.bodyFile)
+        return fs.readFile(opts.bodyFile, 'utf8');
+    return opts.body;
+}
+//# sourceMappingURL=body-input.js.map

package/dist/cli/body-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-input.js","sourceRoot":"","sources":["../../src/cli/body-input.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAOlC,KAAK,UAAU,SAAS;IACtB,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC7C,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,GAAG,IAAI,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAsB;IACtD,IAAI,IAAI,CAAC,QAAQ,KAAK,GAAG;QAAE,OAAO,SAAS,EAAE,CAAC;IAC9C,IAAI,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * Artifact CRUD commands: `create`, `read`, `update`, `delete`, `list`.
+ *
+ * All five share the artifact-engine runtime helper so neither engine
+ * lifecycle nor `--json` resolution is duplicated per command.
+ */
+import type { Command } from 'commander';
+export declare function registerArtifact(program: Command): void;

package/dist/cli/commands/artifact.js

@@ -0,0 +1,171 @@
+/**
+ * Artifact CRUD commands: `create`, `read`, `update`, `delete`, `list`.
+ *
+ * All five share the artifact-engine runtime helper so neither engine
+ * lifecycle nor `--json` resolution is duplicated per command.
+ */
+import path from 'node:path';
+import { renderArtifactFile } from '../../artifacts/storage.js';
+import { SpegoError } from '../../errors.js';
+import { renderDivider, renderHeader, renderTable } from '../render.js';
+import { runEngineCommand } from '../runtime.js';
+import { resolveBody } from '../body-input.js';
+function renderArtifactHeader(fm) {
+    return `📄 ${fm.type}/${fm.slug}  rev ${fm.revision}  (${fm.id})`;
+}
+function renderRecordHuman(record) {
+    return `${renderArtifactHeader(record.frontmatter)}\n${renderDivider()}\n${record.body}`;
+}
+export function registerArtifact(program) {
+    program
+        .command('create')
+        .description('Create an artifact')
+        .requiredOption('--type <type>', 'artifact type, e.g. prd|api|architecture')
+        .requiredOption('--title <title>', 'artifact title')
+        .option('--slug <slug>', 'optional explicit slug')
+        .option('--body <text>', 'inline markdown body')
+        .option('--body-file <path>', 'read markdown body from a file (use - for stdin)')
+        .option('--meta <json>', 'JSON object of metadata', '{}')
+        .option('--cwd <dir>', 'project root')
+        .action(async (opts) => {
+        await runEngineCommand({ program, cwd: opts.cwd }, async (engine) => {
+            const body = (await resolveBody(opts)) ?? '';
+            const meta = JSON.parse(opts.meta);
+            const record = await engine.create({
+                type: opts.type,
+                title: opts.title,
+                slug: opts.slug,
+                body,
+                meta,
+            });
+            const payload = {
+                id: record.frontmatter.id,
+                type: record.frontmatter.type,
+                slug: record.frontmatter.slug,
+                revision: record.frontmatter.revision,
+                path: record.path,
+                markdown: renderArtifactFile(record.frontmatter, record.body),
+            };
+            const human = () => [
+                renderHeader('✨', `Created ${record.frontmatter.type}/${record.frontmatter.slug}  rev ${record.frontmatter.revision}`),
+                `   path: ${record.path}`,
+            ].join('\n');
+            return { payload, human };
+        });
+    });
+    program
+        .command('read')
+        .description('Read an artifact by id or type+slug')
+        .option('--id <id>', 'artifact id')
+        .option('--type <type>', 'artifact type (with --slug)')
+        .option('--slug <slug>', 'artifact slug (with --type)')
+        .option('--path <path>', 'read artifact by absolute file path')
+        .option('--revision <n>', 'specific revision number')
+        .option('--cwd <dir>', 'project root')
+        .action(async (opts) => {
+        await runEngineCommand({ program, cwd: opts.cwd }, async (engine) => {
+            let record;
+            if (opts.id) {
+                record =
+                    opts.revision !== undefined
+                        ? await engine.readRevision(opts.id, Number(opts.revision))
+                        : await engine.readById(opts.id);
+            }
+            else if (opts.type && opts.slug) {
+                record = await engine.readByTypeSlug(opts.type, opts.slug);
+            }
+            else if (opts.path) {
+                record = await engine.readByPath(path.resolve(opts.path));
+            }
+            else {
+                throw new SpegoError('VALIDATION_FAILED', 'Provide --id, --type and --slug, or --path');
+            }
+            return {
+                payload: { frontmatter: record.frontmatter, body: record.body, path: record.path },
+                human: () => renderRecordHuman(record),
+            };
+        });
+    });
+    program
+        .command('update')
+        .description('Update an artifact (requires id)')
+        .requiredOption('--id <id>', 'artifact id')
+        .option('--title <title>', 'new title')
+        .option('--body <text>', 'new markdown body')
+        .option('--body-file <path>', 'read body from file (use - for stdin)')
+        .option('--meta <json>', 'replace metadata (JSON object)')
+        .option('--expected-revision <n>', 'expected current revision (optimistic concurrency)')
+        .option('--cwd <dir>', 'project root')
+        .action(async (opts) => {
+        await runEngineCommand({ program, cwd: opts.cwd }, async (engine) => {
+            const body = await resolveBody(opts);
+            const patch = {};
+            if (opts.title !== undefined)
+                patch.title = opts.title;
+            if (body !== undefined)
+                patch.body = body;
+            if (opts.meta !== undefined)
+                patch.meta = JSON.parse(opts.meta);
+            if (opts.expectedRevision !== undefined)
+                patch.expectedRevision = Number(opts.expectedRevision);
+            const record = await engine.update(opts.id, patch);
+            return {
+                payload: {
+                    id: record.frontmatter.id,
+                    revision: record.frontmatter.revision,
+                    path: record.path,
+                    frontmatter: record.frontmatter,
+                    body: record.body,
+                },
+                human: () => renderRecordHuman(record),
+            };
+        });
+    });
+    program
+        .command('delete')
+        .description('Soft-delete an artifact')
+        .requiredOption('--id <id>', 'artifact id')
+        .option('--cwd <dir>', 'project root')
+        .action(async (opts) => {
+        await runEngineCommand({ program, cwd: opts.cwd }, async (engine) => {
+            const record = await engine.softDelete(opts.id);
+            return {
+                payload: {
+                    id: record.frontmatter.id,
+                    deletedAt: record.frontmatter.deletedAt,
+                    revision: record.frontmatter.revision,
+                },
+                human: () => [
+                    renderHeader('🗑', `Deleted ${record.frontmatter.id}`),
+                    `   at: ${record.frontmatter.deletedAt}`,
+                ].join('\n'),
+            };
+        });
+    });
+    program
+        .command('list')
+        .description('List artifacts')
+        .option('--type <type>', 'filter by type')
+        .option('--include-deleted', 'include soft-deleted artifacts', false)
+        .option('--cwd <dir>', 'project root')
+        .action(async (opts) => {
+        await runEngineCommand({ program, cwd: opts.cwd }, async (engine) => {
+            const items = engine.list({ type: opts.type, includeDeleted: opts.includeDeleted });
+            const human = () => {
+                if (items.length === 0)
+                    return 'No artifacts.';
+                const rows = items.map((a) => [
+                    `${a.type}/${a.slug}`,
+                    String(a.revision),
+                    a.deletedAt ? 'deleted' : 'active',
+                    a.title,
+                    a.id,
+                ]);
+                const table = renderTable(['type/slug', 'rev', 'status', 'title', 'id'], rows);
+                return `${renderHeader('📦', 'Artifacts')}\n${table}`;
+            };
+            return { payload: items, human };
+        });
+    });
+}
+//# sourceMappingURL=artifact.js.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * Delivery commands: read-only `epics` and `tasks` views over the configured
+ * delivery adapter (default: OpenSpec). Mutating actions are rejected with
+ * `DELIVERY_READ_ONLY` so users get a structured pointer to the right tool.
+ */
+import type { Command } from 'commander';
+export declare function registerDelivery(program: Command): void;

package/dist/cli/commands/delivery.js

@@ -0,0 +1,99 @@
+/**
+ * Delivery commands: read-only `epics` and `tasks` views over the configured
+ * delivery adapter (default: OpenSpec). Mutating actions are rejected with
+ * `DELIVERY_READ_ONLY` so users get a structured pointer to the right tool.
+ */
+import path from 'node:path';
+import { resolveWorkspacePaths } from '../../workspace/paths.js';
+import { readConfig } from '../../workspace/config.js';
+import { resolveAdapter } from '../../delivery/index.js';
+import { SpegoError } from '../../errors.js';
+import { renderHeader, renderTable } from '../render.js';
+import { runCommand } from '../runtime.js';
+const READ_ONLY_ACTIONS = new Set(['list', 'get']);
+function assertReadOnlyAction(action, surface) {
+    if (!action || READ_ONLY_ACTIONS.has(action))
+        return;
+    throw new SpegoError('DELIVERY_READ_ONLY', `Cannot '${action}' delivery ${surface} through spego. Use the OpenSpec CLI for delivery mutations.`, { attemptedAction: action, suggestedTool: 'openspec' });
+}
+function renderEpicRow(epic) {
+    const progress = epic.taskCount != null ? `${epic.tasksDone ?? 0}/${epic.taskCount}` : '—';
+    return [epic.externalId, epic.status, progress, epic.title];
+}
+function renderTaskRow(task) {
+    return [task.status === 'done' ? '[x]' : '[ ]', task.title];
+}
+export function registerDelivery(program) {
+    program
+        .command('epics')
+        .description('List epics or get a single epic')
+        .argument('[action]', 'list (default) or get')
+        .option('--change <name>', 'get a single epic by name')
+        .option('--cwd <dir>', 'project root')
+        .action(async (action, opts) => {
+        await runCommand({ program }, async () => {
+            assertReadOnlyAction(action, 'epics');
+            const projectRoot = path.resolve(opts.cwd ?? process.cwd());
+            const wsPaths = resolveWorkspacePaths(projectRoot);
+            const config = await readConfig(wsPaths.configPath);
+            const adapter = resolveAdapter(projectRoot, config);
+            if (opts.change) {
+                const epic = await adapter.getEpic(opts.change);
+                return {
+                    payload: epic,
+                    human: () => {
+                        const table = renderTable(['id', 'status', 'progress', 'title'], [renderEpicRow(epic)]);
+                        return `${renderHeader('📚', `Epic (${adapter.name})`)}\n${table}`;
+                    },
+                };
+            }
+            const epics = await adapter.listEpics();
+            return {
+                payload: epics,
+                human: () => {
+                    if (epics.length === 0)
+                        return 'No epics.';
+                    const table = renderTable(['id', 'status', 'progress', 'title'], epics.map(renderEpicRow));
+                    return `${renderHeader('📚', `Epics (${adapter.name})`)}\n${table}`;
+                },
+            };
+        });
+    });
+    program
+        .command('tasks')
+        .description('List tasks for a change or get a single task')
+        .argument('[action]', 'list (default) or get')
+        .requiredOption('--change <name>', 'the epic/change name')
+        .option('--task <id>', 'get a single task by id')
+        .option('--cwd <dir>', 'project root')
+        .action(async (action, opts) => {
+        await runCommand({ program }, async () => {
+            assertReadOnlyAction(action, 'tasks');
+            const projectRoot = path.resolve(opts.cwd ?? process.cwd());
+            const wsPaths = resolveWorkspacePaths(projectRoot);
+            const config = await readConfig(wsPaths.configPath);
+            const adapter = resolveAdapter(projectRoot, config);
+            if (opts.task) {
+                const task = await adapter.getTask(opts.change, opts.task);
+                return {
+                    payload: task,
+                    human: () => {
+                        const table = renderTable(['done', 'title'], [renderTaskRow(task)]);
+                        return `${renderHeader('✅', `Task: ${opts.change} (${adapter.name})`)}\n${table}`;
+                    },
+                };
+            }
+            const tasks = await adapter.listTasks(opts.change);
+            return {
+                payload: tasks,
+                human: () => {
+                    if (tasks.length === 0)
+                        return `No tasks for ${opts.change}.`;
+                    const table = renderTable(['done', 'title'], tasks.map(renderTaskRow));
+                    return `${renderHeader('✅', `Tasks: ${opts.change} (${adapter.name})`)}\n${table}`;
+                },
+            };
+        });
+    });
+}
+//# sourceMappingURL=delivery.js.map

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

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

package/dist/cli/commands/index-rebuild.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Index maintenance: `spego index rebuild`.
+ */
+import type { Command } from 'commander';
+export declare function registerIndex(program: Command): void;

package/dist/cli/commands/index-rebuild.js

@@ -0,0 +1,31 @@
+/**
+ * Index maintenance: `spego index rebuild`.
+ */
+import { renderBox, renderHeader, renderTable } from '../render.js';
+import { runEngineCommand } from '../runtime.js';
+export function registerIndex(program) {
+    const indexCmd = program.command('index').description('Index maintenance');
+    indexCmd
+        .command('rebuild')
+        .description('Rebuild the SQLite index from markdown files')
+        .option('--cwd <dir>', 'project root')
+        .action(async (opts) => {
+        await runEngineCommand({ program, cwd: opts.cwd }, async (engine) => {
+            const report = await engine.rebuildIndex();
+            const human = () => {
+                const summary = renderBox('Index rebuild', [
+                    ['scanned', String(report.scannedFiles)],
+                    ['indexed', String(report.indexedArtifacts)],
+                    ['invalid', String(report.invalidFiles.length)],
+                ]);
+                const header = renderHeader('📦', 'Index rebuild');
+                if (report.invalidFiles.length === 0)
+                    return `${header}\n${summary}`;
+                const table = renderTable(['path', 'error'], report.invalidFiles.map((i) => [i.path, i.error]), { maxWidth: 80 });
+                return `${header}\n${summary}\n\nInvalid files:\n${table}`;
+            };
+            return { payload: report, human };
+        });
+    });
+}
+//# sourceMappingURL=index-rebuild.js.map

package/dist/cli/commands/index-rebuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-rebuild.js","sourceRoot":"","sources":["../../../src/cli/commands/index-rebuild.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAE3E,QAAQ;SACL,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC;SACrC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,gBAAgB,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YAClE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,GAAW,EAAE;gBACzB,MAAM,OAAO,GAAG,SAAS,CAAC,eAAe,EAAE;oBACzC,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;oBACxC,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;oBAC5C,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;iBAChD,CAAC,CAAC;gBACH,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;gBACnD,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,GAAG,MAAM,KAAK,OAAO,EAAE,CAAC;gBACrE,MAAM,KAAK,GAAG,WAAW,CACvB,CAAC,MAAM,EAAE,OAAO,CAAC,EACjB,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EACjD,EAAE,QAAQ,EAAE,EAAE,EAAE,CACjB,CAAC;gBACF,OAAO,GAAG,MAAM,KAAK,OAAO,uBAAuB,KAAK,EAAE,CAAC;YAC7D,CAAC,CAAC;YACF,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * Metadata commands: `commands` and `workflows`.
+ * Both are read-only listings backed by static registries.
+ */
+import type { Command } from 'commander';
+export declare function registerMeta(program: Command): void;

package/dist/cli/commands/meta.js

@@ -0,0 +1,60 @@
+/**
+ * Metadata commands: `commands` and `workflows`.
+ * Both are read-only listings backed by static registries.
+ */
+import { COMMAND_REGISTRY } from '../../commands/registry.js';
+import { WORKFLOW_REGISTRY } from '../../workflows/registry.js';
+import { renderHeader, renderTable } from '../render.js';
+import { runCommand } from '../runtime.js';
+function renderCommandsHuman() {
+    const order = ['workspace', 'artifact', 'view', 'planning'];
+    const titles = {
+        workspace: 'Workspace',
+        artifact: 'Artifacts',
+        view: 'View',
+        planning: 'Planning',
+    };
+    const sections = order
+        .map((cat) => {
+        const items = COMMAND_REGISTRY.filter((c) => c.category === cat);
+        if (items.length === 0)
+            return '';
+        const table = renderTable(['name', 'description'], items.map((c) => [c.name, c.description]));
+        return `${titles[cat]}\n${table}`;
+    })
+        .filter((s) => s.length > 0);
+    return [renderHeader('🛠️', 'Commands'), '', sections.join('\n\n')].join('\n');
+}
+function renderWorkflowsHuman() {
+    const rows = WORKFLOW_REGISTRY.map((w) => [w.name, String(w.phases.length), w.description]);
+    const table = renderTable(['name', 'phases', 'description'], rows, { maxWidth: 80 });
+    return [renderHeader('🧭', 'Workflows'), '', table].join('\n');
+}
+export function registerMeta(program) {
+    program
+        .command('commands')
+        .description('List available spego commands with metadata')
+        .action(async () => {
+        await runCommand({ program }, async () => ({
+            payload: COMMAND_REGISTRY,
+            human: renderCommandsHuman,
+        }));
+    });
+    program
+        .command('workflows')
+        .description('List available workflow skills')
+        .action(async () => {
+        await runCommand({ program }, async () => {
+            const entries = WORKFLOW_REGISTRY.map((w) => ({
+                name: w.name,
+                description: w.description,
+                personas: w.personas,
+                phases: w.phases,
+                inputs: w.inputs,
+                outputs: w.outputs,
+            }));
+            return { payload: entries, human: renderWorkflowsHuman };
+        });
+    });
+}
+//# sourceMappingURL=meta.js.map

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

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

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,47 @@
+/**
+ * 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 { 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 });
+    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,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,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;