@cleocode/cleo 2026.4.158 → 2026.5.0

package/dist/cli/commands/audit.js

@@ -0,0 +1,137 @@
+/**
+ * CLI audit command group — git-backed audit and lineage reconstruction.
+ *
+ * Subcommands:
+ *   cleo audit reconstruct <taskId>  — reconstruct git-log + release-tag
+ *                                      lineage for a task and its children
+ *
+ * The `reconstruct` subcommand is the CLI surface for the
+ * `reconstructLineage` SDK primitive in `packages/core/src/audit/reconstruct.ts`.
+ * It treats git as the immutable ledger (no parallel `.jsonl` emission) per
+ * the FP peer note and T1322 council verdict (2026-04-24).
+ *
+ * @task T1322
+ * @epic T1216
+ */
+import { getProjectRoot, reconstructLineage } from '@cleocode/core/internal';
+import { defineCommand, showUsage } from 'citty';
+/**
+ * cleo audit reconstruct <taskId> — reconstruct git-backed lineage for a task.
+ *
+ * Queries git log and release tags to produce a {@link ReconstructResult}
+ * for the given task ID and all inferred children. Output is printed as
+ * formatted JSON to stdout (LAFS-envelope-compatible via the `--json` flag).
+ *
+ * @example
+ * ```sh
+ * cleo audit reconstruct T991
+ * cleo audit reconstruct T991 --json
+ * ```
+ */
+const reconstructCommand = defineCommand({
+    meta: {
+        name: 'reconstruct',
+        description: 'Reconstruct git-backed lineage (commits + release tags) for a task',
+    },
+    args: {
+        taskId: {
+            type: 'positional',
+            description: 'Task ID to reconstruct (e.g. T991)',
+            required: true,
+        },
+        json: {
+            type: 'boolean',
+            description: 'Emit raw JSON output instead of formatted summary',
+            default: false,
+        },
+        'repo-root': {
+            type: 'string',
+            description: 'Path to the git repository root (defaults to current project root)',
+        },
+    },
+    async run({ args }) {
+        const taskId = args['taskId'];
+        if (!taskId || !/^T\d+$/i.test(taskId)) {
+            process.stderr.write(`Error: taskId must match /^T\\d+$/ (e.g. T991). Got: ${JSON.stringify(taskId)}\n`);
+            process.exit(1);
+        }
+        // Resolve repo root: explicit flag > project root detection > cwd
+        let repoRoot;
+        if (args['repo-root']) {
+            repoRoot = args['repo-root'];
+        }
+        else {
+            try {
+                repoRoot = getProjectRoot(process.cwd()) ?? process.cwd();
+            }
+            catch {
+                repoRoot = process.cwd();
+            }
+        }
+        const result = await reconstructLineage(taskId, repoRoot);
+        if (args['json']) {
+            process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+            return;
+        }
+        // Human-readable summary output
+        const lines = [
+            `Lineage for ${result.taskId}`,
+            `${'='.repeat(40)}`,
+            '',
+            `Direct commits: ${result.directCommits.length}`,
+        ];
+        for (const c of result.directCommits) {
+            lines.push(`  ${c.sha.slice(0, 10)}  ${c.subject}`);
+        }
+        lines.push('');
+        if (result.childIdRange) {
+            lines.push(`Inferred children: ${result.inferredChildren.join(', ')} (${result.childIdRange.min} → ${result.childIdRange.max})`);
+        }
+        else {
+            lines.push('Inferred children: none');
+        }
+        const childEntries = Object.entries(result.childCommits);
+        if (childEntries.length > 0) {
+            lines.push('');
+            lines.push('Child commits:');
+            for (const [childId, commits] of childEntries) {
+                lines.push(`  ${childId}: ${commits.length} commit(s)`);
+                for (const c of commits) {
+                    lines.push(`    ${c.sha.slice(0, 10)}  ${c.subject}`);
+                }
+            }
+        }
+        lines.push('');
+        if (result.releaseTags.length > 0) {
+            lines.push(`Release tags (${result.releaseTags.length}):`);
+            for (const t of result.releaseTags) {
+                lines.push(`  ${t.tag}  ${t.commitSha.slice(0, 10)}  ${t.subject}`);
+            }
+        }
+        else {
+            lines.push('Release tags: none found');
+        }
+        lines.push('');
+        lines.push(`First seen: ${result.firstSeenAt ?? 'n/a'}`);
+        lines.push(`Last seen:  ${result.lastSeenAt ?? 'n/a'}`);
+        process.stdout.write(`${lines.join('\n')}\n`);
+    },
+});
+/**
+ * Root `cleo audit` command group.
+ *
+ * Provides git-backed audit tooling for the T1216 audit epic.
+ */
+export const auditCommand = defineCommand({
+    meta: {
+        name: 'audit',
+        description: 'Git-backed audit tooling (lineage reconstruction, integrity checks)',
+    },
+    subCommands: {
+        reconstruct: reconstructCommand,
+    },
+    async run({ args: _args }) {
+        await showUsage(auditCommand);
+    },
+});
+//# sourceMappingURL=audit.js.map

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

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

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

@@ -0,0 +1,56 @@
+/**
+ * CLI command: cleo backfill
+ *
+ * Retroactively adds acceptance criteria and verification metadata to
+ * existing tasks that were created before T058 (AC enforcement) and
+ * T061 (verification gate auto-init).
+ *
+ * Also supports retroactive embedding of existing brain observations
+ * via the --embeddings flag (T142).
+ *
+ * Usage:
+ *   cleo backfill            -- apply changes (defaults to dry-run prompt)
+ *   cleo backfill --dry-run  -- preview without modifying
+ *   cleo backfill --rollback -- revert a previous backfill
+ *   cleo backfill --embeddings -- backfill embeddings for brain observations
+ *
+ * @epic T056
+ * @task T066
+ * @task T142
+ */
+/**
+ * Native citty command for `cleo backfill`.
+ *
+ * @remarks
+ * Wires the backfill module from core into the CLI command tree.
+ * Supports both task AC/verification backfill and embedding backfill.
+ *
+ * @example
+ * ```ts
+ * // Registered in index.ts as:
+ * // backfill: backfillCommand
+ * // Adds: cleo backfill [--dry-run] [--rollback] [--embeddings]
+ * ```
+ */
+export declare const backfillCommand: import("citty").CommandDef<{
+    readonly 'dry-run': {
+        readonly type: "boolean";
+        readonly description: "Show what would be changed without modifying any tasks";
+        readonly default: false;
+    };
+    readonly rollback: {
+        readonly type: "boolean";
+        readonly description: "Revert a previous backfill (clear auto-generated AC and verification)";
+        readonly default: false;
+    };
+    readonly tasks: {
+        readonly type: "string";
+        readonly description: "Comma-separated list of task IDs to restrict backfill to (e.g. T001,T002)";
+    };
+    readonly embeddings: {
+        readonly type: "boolean";
+        readonly description: "Retroactively generate embeddings for brain observations that lack them";
+        readonly default: false;
+    };
+}>;
+//# sourceMappingURL=backfill.d.ts.map

package/dist/cli/commands/backfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backfill.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/backfill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;EAsJ1B,CAAC"}

package/dist/cli/commands/backfill.js

@@ -0,0 +1,161 @@
+/**
+ * CLI command: cleo backfill
+ *
+ * Retroactively adds acceptance criteria and verification metadata to
+ * existing tasks that were created before T058 (AC enforcement) and
+ * T061 (verification gate auto-init).
+ *
+ * Also supports retroactive embedding of existing brain observations
+ * via the --embeddings flag (T142).
+ *
+ * Usage:
+ *   cleo backfill            -- apply changes (defaults to dry-run prompt)
+ *   cleo backfill --dry-run  -- preview without modifying
+ *   cleo backfill --rollback -- revert a previous backfill
+ *   cleo backfill --embeddings -- backfill embeddings for brain observations
+ *
+ * @epic T056
+ * @task T066
+ * @task T142
+ */
+import { backfillTasks, getProjectRoot, populateEmbeddings } from '@cleocode/core/internal';
+import { defineCommand } from 'citty';
+import { cliError, cliOutput } from '../renderers/index.js';
+/**
+ * Native citty command for `cleo backfill`.
+ *
+ * @remarks
+ * Wires the backfill module from core into the CLI command tree.
+ * Supports both task AC/verification backfill and embedding backfill.
+ *
+ * @example
+ * ```ts
+ * // Registered in index.ts as:
+ * // backfill: backfillCommand
+ * // Adds: cleo backfill [--dry-run] [--rollback] [--embeddings]
+ * ```
+ */
+export const backfillCommand = defineCommand({
+    meta: {
+        name: 'backfill',
+        description: 'Retroactively add acceptance criteria and verification metadata to existing tasks',
+    },
+    args: {
+        'dry-run': {
+            type: 'boolean',
+            description: 'Show what would be changed without modifying any tasks',
+            default: false,
+        },
+        rollback: {
+            type: 'boolean',
+            description: 'Revert a previous backfill (clear auto-generated AC and verification)',
+            default: false,
+        },
+        tasks: {
+            type: 'string',
+            description: 'Comma-separated list of task IDs to restrict backfill to (e.g. T001,T002)',
+        },
+        embeddings: {
+            type: 'boolean',
+            description: 'Retroactively generate embeddings for brain observations that lack them',
+            default: false,
+        },
+    },
+    async run({ args }) {
+        const root = getProjectRoot();
+        // --embeddings mode: embedding backfill for brain observations
+        if (args.embeddings) {
+            try {
+                let lastLine = '';
+                const result = await populateEmbeddings(root, {
+                    onProgress: (current, total) => {
+                        // Overwrite current line for progress display
+                        if (process.stdout.isTTY) {
+                            process.stdout.clearLine(0);
+                            process.stdout.cursorTo(0);
+                            process.stdout.write(`Embedding ${current}/${total}...`);
+                        }
+                        else {
+                            const line = `Embedding ${current}/${total}...`;
+                            if (line !== lastLine) {
+                                console.log(line);
+                                lastLine = line;
+                            }
+                        }
+                    },
+                });
+                // Move to new line after inline progress
+                if (process.stdout.isTTY && result.processed + result.skipped + result.errors > 0) {
+                    process.stdout.write('\n');
+                }
+                if (result.processed === 0 && result.skipped === 0 && result.errors === 0) {
+                    cliOutput({
+                        processed: 0,
+                        skipped: 0,
+                        errors: 0,
+                        message: 'No observations to embed (provider unavailable or nothing to backfill).',
+                    }, { command: 'backfill', operation: 'admin.backfill', message: 'Nothing to embed' });
+                    return;
+                }
+                cliOutput({ processed: result.processed, skipped: result.skipped, errors: result.errors }, {
+                    command: 'backfill',
+                    operation: 'admin.backfill',
+                    message: `Processed ${result.processed}, skipped ${result.skipped}, errors ${result.errors}`,
+                });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                cliError(`Embedding backfill failed: ${message}`, 'E_INTERNAL', {
+                    name: 'E_INTERNAL',
+                }, { operation: 'admin.backfill' });
+                process.exit(1);
+            }
+            return;
+        }
+        // Default mode: task AC/verification backfill
+        const dryRun = !!args['dry-run'];
+        const rollback = !!args.rollback;
+        const taskIds = args.tasks?.trim()
+            ? args.tasks
+                .split(',')
+                .map((s) => s.trim())
+                .filter(Boolean)
+            : undefined;
+        // Safety: require --dry-run or explicit confirmation for destructive backfill
+        if (!dryRun && !rollback && !process.env['CLEO_NONINTERACTIVE']) {
+            process.stderr.write('Warning: Backfill will modify tasks in-place. Run with --dry-run first to preview changes.\n' +
+                '  Set CLEO_NONINTERACTIVE=1 or pass --dry-run to suppress this warning.\n\n');
+        }
+        try {
+            const result = await backfillTasks(root, { dryRun, rollback, taskIds });
+            const output = {
+                dryRun,
+                rollback,
+                tasksScanned: result.tasksScanned,
+                tasksChanged: result.tasksChanged,
+                changes: result.changes,
+            };
+            if (!rollback) {
+                output['acAdded'] = result.acAdded;
+                output['verificationAdded'] = result.verificationAdded;
+            }
+            const messagePrefix = dryRun ? '[dry run] ' : rollback ? '[rollback] ' : '';
+            const messageSuffix = result.changes.length === 0
+                ? 'Nothing to do — all tasks already have AC and verification metadata.'
+                : `Scanned ${result.tasksScanned}, changed ${result.tasksChanged} task(s).`;
+            cliOutput(output, {
+                command: 'backfill',
+                operation: 'admin.backfill',
+                message: `${messagePrefix}${messageSuffix}`,
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            cliError(`Backfill failed: ${message}`, 'E_INTERNAL', {
+                name: 'E_INTERNAL',
+            }, { operation: 'admin.backfill' });
+            process.exit(1);
+        }
+    },
+});
+//# sourceMappingURL=backfill.js.map

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

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

package/dist/cli/commands/backup-inspect.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `cleo backup inspect <bundle>` — manifest-only streaming read.
+ *
+ * Reads `manifest.json` from a `.cleobundle.tar.gz` (or encrypted
+ * `.enc.cleobundle.tar.gz`) without extracting any other files and without
+ * writing anything to disk.
+ *
+ * Spec: T311-backup-portability-spec.md §5.3
+ *
+ * @task T363
+ * @epic T311
+ * @module cli/commands/backup-inspect
+ */
+/**
+ * `cleo backup inspect <bundle>` subcommand definition for citty.
+ *
+ * Stream-reads `manifest.json` from a `.cleobundle.tar.gz` (or encrypted
+ * `.enc.cleobundle.tar.gz`) and prints a structured report without extracting
+ * or modifying anything on disk.
+ *
+ * Imported by `backup.ts` and mounted under `subCommands.inspect`.
+ *
+ * @task T363
+ * @epic T311
+ */
+export declare const backupInspectSubCommand: import("citty").CommandDef<{
+    readonly bundle: {
+        readonly type: "positional";
+        readonly description: "Path to the .cleobundle.tar.gz file";
+        readonly required: true;
+    };
+}>;
+//# sourceMappingURL=backup-inspect.d.ts.map

package/dist/cli/commands/backup-inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-inspect.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/backup-inspect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAudH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB;;;;;;EAelC,CAAC"}