@cleocode/cleo 2026.4.158 → 2026.5.0

package/dist/cli/commands/manifest.js

@@ -0,0 +1,334 @@
+/**
+ * CLI manifest command group for pipeline_manifest table operations.
+ *
+ * Subcommands:
+ *   cleo manifest show <id>                  — show a single manifest entry by ID
+ *   cleo manifest list [options]             — list manifest entries with filters
+ *   cleo manifest find <query>               — full-text search manifest entries
+ *   cleo manifest stats [options]            — aggregate statistics
+ *   cleo manifest append [options]           — append a new manifest entry
+ *   cleo manifest archive <id|--before>     — archive manifest entries
+ *
+ * Per spec: T1096 — Unified Manifest CLI Surface
+ */
+import { buildManifestEntryFromShorthand } from '@cleocode/core/memory/manifest-builder.js';
+import { defineCommand, showUsage } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+import { isSubCommandDispatch } from '../lib/subcommand-guard.js';
+// ---------------------------------------------------------------------------
+// Subcommands
+// ---------------------------------------------------------------------------
+/** cleo manifest show <id> — show a single manifest entry */
+const showCommand = defineCommand({
+    meta: {
+        name: 'show',
+        description: 'Show a manifest entry by ID',
+    },
+    args: {
+        id: {
+            type: 'positional',
+            description: 'Pipeline manifest entry ID',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'pipeline', 'manifest.show', { entryId: args.id }, { command: 'manifest show' });
+    },
+});
+/** cleo manifest list — list manifest entries with optional filters */
+const listCommand = defineCommand({
+    meta: {
+        name: 'list',
+        description: 'List manifest entries with optional filters',
+    },
+    args: {
+        filter: {
+            type: 'string',
+            description: 'Filter by status: active|archived|distilled|pending',
+        },
+        task: {
+            type: 'string',
+            description: 'Filter by task_id',
+        },
+        epic: {
+            type: 'string',
+            description: 'Filter by epic_id',
+        },
+        type: {
+            type: 'string',
+            description: 'Filter by entry type',
+        },
+        limit: {
+            type: 'string',
+            description: 'Maximum rows to return (default: 50, max: 500)',
+        },
+        offset: {
+            type: 'string',
+            description: 'Pagination offset (default: 0)',
+        },
+        json: {
+            type: 'boolean',
+            description: 'Output as JSON array (default: table)',
+            default: false,
+        },
+    },
+    async run({ args }) {
+        const limit = args.limit ? Number.parseInt(args.limit, 10) : 50;
+        const offset = args.offset ? Number.parseInt(args.offset, 10) : 0;
+        await dispatchFromCli('query', 'pipeline', 'manifest.list', {
+            filter: args.filter,
+            taskId: args.task,
+            epicId: args.epic,
+            type: args.type,
+            limit,
+            offset,
+            json: args.json,
+        }, { command: 'manifest list' });
+    },
+});
+/** cleo manifest find <query> — full-text search manifest entries */
+const findCommand = defineCommand({
+    meta: {
+        name: 'find',
+        description: 'Full-text search manifest entries',
+    },
+    args: {
+        query: {
+            type: 'positional',
+            description: 'Full-text search string',
+            required: true,
+        },
+        limit: {
+            type: 'string',
+            description: 'Maximum rows to return (default: 20)',
+        },
+        json: {
+            type: 'boolean',
+            description: 'Output as JSON array',
+            default: false,
+        },
+    },
+    async run({ args }) {
+        const limit = args.limit ? Number.parseInt(args.limit, 10) : 20;
+        await dispatchFromCli('query', 'pipeline', 'manifest.find', {
+            query: args.query,
+            limit,
+            json: args.json,
+        }, { command: 'manifest find' });
+    },
+});
+/** cleo manifest stats — aggregate statistics */
+const statsCommand = defineCommand({
+    meta: {
+        name: 'stats',
+        description: 'Aggregate manifest statistics',
+    },
+    args: {
+        json: {
+            type: 'boolean',
+            description: 'Output as JSON object',
+            default: false,
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'pipeline', 'manifest.stats', {
+            json: args.json,
+        }, { command: 'manifest stats' });
+    },
+});
+/** cleo manifest append — append a new manifest entry */
+const appendCommand = defineCommand({
+    meta: {
+        name: 'append',
+        description: 'Append a new manifest entry (pipeline_manifest table). Accepts either a full ' +
+            '--entry JSON blob / --file / stdin, OR the shorthand --task + --type + --content ' +
+            'flags which build a valid entry with sensible defaults for id/file/title/date/etc.',
+    },
+    args: {
+        entry: {
+            type: 'string',
+            description: 'JSON string of entry fields (full ManifestEntry shape)',
+        },
+        task: {
+            type: 'string',
+            description: 'Task ID to associate — becomes linked_tasks[0] + id prefix (shorthand)',
+        },
+        type: {
+            type: 'string',
+            description: 'Entry type — becomes agent_type (e.g. research, implementation, decomposition) (shorthand)',
+        },
+        content: {
+            type: 'string',
+            description: 'One-paragraph summary — becomes key_findings[0] and title (first line) (shorthand)',
+        },
+        title: {
+            type: 'string',
+            description: 'Explicit title override for shorthand mode',
+        },
+        status: {
+            type: 'string',
+            description: 'Entry status: completed (default) | partial | blocked (shorthand)',
+        },
+        file: {
+            type: 'string',
+            description: 'Path to JSON file containing entry',
+        },
+    },
+    async run({ args }) {
+        let entry;
+        const hasShorthand = Boolean(args.task || args.type || args.content);
+        if (args.entry) {
+            // Full entry JSON — parse, then allow shorthand to override individual fields.
+            try {
+                entry = JSON.parse(args.entry);
+            }
+            catch (_err) {
+                console.error('Error: --entry must be valid JSON');
+                process.exit(1);
+            }
+        }
+        else if (args.file) {
+            // Load entry from file
+            try {
+                const fs = await import('node:fs');
+                const fileContent = fs.readFileSync(args.file, 'utf-8');
+                entry = JSON.parse(fileContent);
+            }
+            catch (_err) {
+                console.error(`Error: failed to read or parse ${args.file}`);
+                process.exit(1);
+            }
+        }
+        else if (hasShorthand) {
+            // Shorthand-only: defer to the core SDK helper so the CLI stays a thin
+            // adapter (AGENTS.md package boundary / T1096). Keeps the defaulting
+            // logic reusable by Studio, VS Code extension, API server, and direct
+            // SDK callers.
+            entry = {
+                ...buildManifestEntryFromShorthand({
+                    task: args.task,
+                    type: args.type,
+                    content: args.content,
+                    title: args.title,
+                    status: args.status,
+                }),
+            };
+        }
+        else {
+            // Try to read from stdin
+            const stdinData = await readStdin();
+            if (!stdinData) {
+                console.error('Error: must provide --entry JSON, --file path, stdin, or shorthand ' +
+                    '(--task + --type + --content)');
+                process.exit(1);
+            }
+            try {
+                entry = JSON.parse(stdinData);
+            }
+            catch (_err) {
+                console.error('Error: stdin must be valid JSON');
+                process.exit(1);
+            }
+        }
+        // Shorthand overrides applied ONLY when user provided --entry / --file /
+        // stdin — let individual fields be surgically updated. (For pure shorthand
+        // mode the entry is already fully built above.)
+        if ((args.entry || args.file) && hasShorthand) {
+            if (args.task) {
+                entry.linked_tasks = Array.isArray(entry.linked_tasks)
+                    ? [args.task, ...entry.linked_tasks.filter((t) => t !== args.task)]
+                    : [args.task];
+            }
+            if (args.type) {
+                entry.agent_type = args.type;
+            }
+            if (args.content && !entry.key_findings) {
+                entry.key_findings = [args.content];
+            }
+            if (args.title) {
+                entry.title = args.title;
+            }
+            if (args.status) {
+                entry.status = args.status;
+            }
+        }
+        await dispatchFromCli('mutate', 'pipeline', 'manifest.append', { entry }, { command: 'manifest append' });
+    },
+});
+/** cleo manifest archive — archive manifest entries */
+const archiveCommand = defineCommand({
+    meta: {
+        name: 'archive',
+        description: 'Archive manifest entries',
+    },
+    args: {
+        id: {
+            type: 'positional',
+            description: 'Entry ID to archive',
+        },
+        'before-date': {
+            type: 'string',
+            description: 'Archive all active entries created before ISO date (YYYY-MM-DD)',
+        },
+    },
+    async run({ args }) {
+        // Ensure either id or before-date is provided
+        if (!args.id && !args['before-date']) {
+            console.error('Error: must provide either <id> positional argument or --before-date flag');
+            process.exit(1);
+        }
+        // Ensure id and before-date are not both provided
+        if (args.id && args['before-date']) {
+            console.error('Error: --before-date is mutually exclusive with <id> positional argument');
+            process.exit(1);
+        }
+        const dispatchPayload = args.id ? { id: args.id } : { beforeDate: args['before-date'] };
+        await dispatchFromCli('mutate', 'pipeline', 'manifest.archive', dispatchPayload, {
+            command: 'manifest archive',
+        });
+    },
+});
+// ---------------------------------------------------------------------------
+// Helper: read stdin
+// ---------------------------------------------------------------------------
+async function readStdin() {
+    if (process.stdin.isTTY) {
+        return '';
+    }
+    return new Promise((resolve, reject) => {
+        let data = '';
+        process.stdin.setEncoding('utf-8');
+        process.stdin.on('data', (chunk) => {
+            data += chunk;
+        });
+        process.stdin.on('end', () => {
+            resolve(data.trim());
+        });
+        process.stdin.on('error', reject);
+    });
+}
+// ---------------------------------------------------------------------------
+// Main manifest command group
+// ---------------------------------------------------------------------------
+export const manifestCommand = defineCommand({
+    meta: {
+        name: 'manifest',
+        description: 'Manifest operations (pipeline_manifest table)',
+    },
+    subCommands: {
+        show: showCommand,
+        list: listCommand,
+        find: findCommand,
+        stats: statsCommand,
+        append: appendCommand,
+        archive: archiveCommand,
+    },
+    async run({ cmd, rawArgs }) {
+        // Citty's `runCommand` runs the parent's `run()` AFTER the subcommand.
+        // Early-return when a subcommand has matched so stdout stays clean (T1187-followup).
+        if (isSubCommandDispatch(rawArgs, cmd.subCommands))
+            return;
+        await showUsage(cmd);
+    },
+});
+//# sourceMappingURL=manifest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../src/cli/commands/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,6DAA6D;AAC7D,MAAM,WAAW,GAAG,aAAa,CAAC;IAChC,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,6BAA6B;KAC3C;IACD,IAAI,EAAE;QACJ,EAAE,EAAE;YACF,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,4BAA4B;YACzC,QAAQ,EAAE,IAAI;SACf;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,eAAe,CACnB,OAAO,EACP,UAAU,EACV,eAAe,EACf,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,EACpB,EAAE,OAAO,EAAE,eAAe,EAAE,CAC7B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,uEAAuE;AACvE,MAAM,WAAW,GAAG,aAAa,CAAC;IAChC,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,6CAA6C;KAC3D;IACD,IAAI,EAAE;QACJ,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,qDAAqD;SACnE;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mBAAmB;SACjC;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mBAAmB;SACjC;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,sBAAsB;SACpC;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gDAAgD;SAC9D;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gCAAgC;SAC9C;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,uCAAuC;YACpD,OAAO,EAAE,KAAK;SACf;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAElE,MAAM,eAAe,CACnB,OAAO,EACP,UAAU,EACV,eAAe,EACf;YACE,MAAM,EAAE,IAAI,CAAC,MAA4B;YACzC,MAAM,EAAE,IAAI,CAAC,IAA0B;YACvC,MAAM,EAAE,IAAI,CAAC,IAA0B;YACvC,IAAI,EAAE,IAAI,CAAC,IAA0B;YACrC,KAAK;YACL,MAAM;YACN,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,EACD,EAAE,OAAO,EAAE,eAAe,EAAE,CAC7B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,qEAAqE;AACrE,MAAM,WAAW,GAAG,aAAa,CAAC;IAChC,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,mCAAmC;KACjD;IACD,IAAI,EAAE;QACJ,KAAK,EAAE;YACL,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,IAAI;SACf;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,sCAAsC;SACpD;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,sBAAsB;YACnC,OAAO,EAAE,KAAK;SACf;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAEhE,MAAM,eAAe,CACnB,OAAO,EACP,UAAU,EACV,eAAe,EACf;YACE,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,EACD,EAAE,OAAO,EAAE,eAAe,EAAE,CAC7B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,iDAAiD;AACjD,MAAM,YAAY,GAAG,aAAa,CAAC;IACjC,IAAI,EAAE;QACJ,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,+BAA+B;KAC7C;IACD,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,uBAAuB;YACpC,OAAO,EAAE,KAAK;SACf;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,eAAe,CACnB,OAAO,EACP,UAAU,EACV,gBAAgB,EAChB;YACE,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,EACD,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAC9B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,yDAAyD;AACzD,MAAM,aAAa,GAAG,aAAa,CAAC;IAClC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,+EAA+E;YAC/E,mFAAmF;YACnF,oFAAoF;KACvF;IACD,IAAI,EAAE;QACJ,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,wDAAwD;SACtE;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,wEAAwE;SACtF;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,4FAA4F;SAC/F;QACD,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,oFAAoF;SACvF;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,4CAA4C;SAC1D;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mEAAmE;SACjF;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,oCAAoC;SAClD;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,IAAI,KAA8B,CAAC;QACnC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;QAErE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,+EAA+E;YAC/E,IAAI,CAAC;gBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC;YAAC,OAAO,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;gBACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACrB,uBAAuB;YACvB,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;gBACnC,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBACxD,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAClC,CAAC;YAAC,OAAO,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,KAAK,CAAC,kCAAkC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;aAAM,IAAI,YAAY,EAAE,CAAC;YACxB,uEAAuE;YACvE,qEAAqE;YACrE,sEAAsE;YACtE,eAAe;YACf,KAAK,GAAG;gBACN,GAAG,+BAA+B,CAAC;oBACjC,IAAI,EAAE,IAAI,CAAC,IAA0B;oBACrC,IAAI,EAAE,IAAI,CAAC,IAA0B;oBACrC,OAAO,EAAE,IAAI,CAAC,OAA6B;oBAC3C,KAAK,EAAE,IAAI,CAAC,KAA2B;oBACvC,MAAM,EAAE,IAAI,CAAC,MAAyD;iBACvE,CAAC;aACH,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,yBAAyB;YACzB,MAAM,SAAS,GAAG,MAAM,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CACX,qEAAqE;oBACnE,+BAA+B,CAClC,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,IAAI,CAAC;gBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAChC,CAAC;YAAC,OAAO,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;gBACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QAED,yEAAyE;QACzE,2EAA2E;QAC3E,gDAAgD;QAChD,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,YAAY,EAAE,CAAC;YAC9C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;oBACpD,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;oBACnE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;YACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC;YAC/B,CAAC;YACD,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBACxC,KAAK,CAAC,YAAY,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtC,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YAC3B,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,MAAM,eAAe,CACnB,QAAQ,EACR,UAAU,EACV,iBAAiB,EACjB,EAAE,KAAK,EAAE,EACT,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAC/B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,uDAAuD;AACvD,MAAM,cAAc,GAAG,aAAa,CAAC;IACnC,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,0BAA0B;KACxC;IACD,IAAI,EAAE;QACJ,EAAE,EAAE;YACF,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,qBAAqB;SACnC;QACD,aAAa,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,iEAAiE;SAC/E;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,8CAA8C;QAC9C,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,KAAK,CAAC,2EAA2E,CAAC,CAAC;YAC3F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,kDAAkD;QAClD,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,KAAK,CAAC,0EAA0E,CAAC,CAAC;YAC1F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAExF,MAAM,eAAe,CAAC,QAAQ,EAAE,UAAU,EAAE,kBAAkB,EAAE,eAAe,EAAE;YAC/E,OAAO,EAAE,kBAAkB;SAC5B,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC;AAEH,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,KAAK,UAAU,SAAS;IACtB,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACjC,IAAI,IAAI,KAAK,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;IAC3C,IAAI,EAAE;QACJ,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,+CAA+C;KAC7D;IACD,WAAW,EAAE;QACX,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,cAAc;KACxB;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE;QACxB,uEAAuE;QACvE,qFAAqF;QACrF,IAAI,oBAAoB,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC;YAAE,OAAO;QAC3D,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * CLI map command - codebase analysis and mapping.
+ *
+ * Analyzes codebase structure and returns a structured mapping. Optionally
+ * stores findings to brain.db when `--store` is given.
+ *
+ * @epic cognitive-cleo
+ * @task T487
+ */
+/**
+ * cleo map — analyze codebase structure and return structured mapping.
+ *
+ * Dispatches to `admin.map` via the query (or mutate when `--store`) gateway.
+ */
+export declare const mapCommand: import("citty").CommandDef<{
+    readonly store: {
+        readonly type: "boolean";
+        readonly description: "Store findings to brain.db";
+    };
+    readonly focus: {
+        readonly type: "string";
+        readonly description: "Focus on one area: stack, architecture, structure, conventions, testing, integrations, concerns";
+    };
+}>;
+//# sourceMappingURL=map.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/map.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;;;;;;;EAmBrB,CAAC"}

package/dist/cli/commands/map.js

@@ -0,0 +1,37 @@
+/**
+ * CLI map command - codebase analysis and mapping.
+ *
+ * Analyzes codebase structure and returns a structured mapping. Optionally
+ * stores findings to brain.db when `--store` is given.
+ *
+ * @epic cognitive-cleo
+ * @task T487
+ */
+import { defineCommand } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/**
+ * cleo map — analyze codebase structure and return structured mapping.
+ *
+ * Dispatches to `admin.map` via the query (or mutate when `--store`) gateway.
+ */
+export const mapCommand = defineCommand({
+    meta: { name: 'map', description: 'Analyze codebase structure and return structured mapping' },
+    args: {
+        store: {
+            type: 'boolean',
+            description: 'Store findings to brain.db',
+        },
+        focus: {
+            type: 'string',
+            description: 'Focus on one area: stack, architecture, structure, conventions, testing, integrations, concerns',
+        },
+    },
+    async run({ args }) {
+        const gateway = args.store ? 'mutate' : 'query';
+        const params = {};
+        if (args.focus)
+            params.focus = args.focus;
+        await dispatchFromCli(gateway, 'admin', 'map', params, { command: 'map' });
+    },
+});
+//# sourceMappingURL=map.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../../src/cli/commands/map.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;IACtC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,0DAA0D,EAAE;IAC9F,IAAI,EAAE;QACJ,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,4BAA4B;SAC1C;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,iGAAiG;SACpG;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;QAChD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,KAAK;YAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAC1C,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,48 @@
+/**
+ * CLI memory commands for BRAIN pattern and learning memory.
+ *
+ * Subcommands:
+ *   cleo memory store       — store a pattern or learning
+ *   cleo memory find        — cross-table FTS5 search
+ *   cleo memory stats       — pattern + learning statistics
+ *   cleo memory observe     — save observation to brain.db
+ *   cleo memory timeline    — chronological context around anchor
+ *   cleo memory fetch       — full details for observation IDs
+ *   cleo memory decision-find   — search decisions
+ *   cleo memory decision-store  — store a decision
+ *   cleo memory link        — link a brain entry to a task
+ *   cleo memory trace       — BFS graph traversal
+ *   cleo memory related     — 1-hop graph neighbours
+ *   cleo memory context     — 360-degree node view
+ *   cleo memory graph-stats — graph aggregate counts
+ *   cleo memory graph-show  — get graph node + edges
+ *   cleo memory graph-neighbors — get neighbour nodes
+ *   cleo memory graph-add   — add node or edge
+ *   cleo memory graph-remove — remove node or edge
+ *   cleo memory reason-why  — causal trace through task deps
+ *   cleo memory reason-similar — semantically similar entries
+ *   cleo memory search-hybrid — hybrid FTS5/vector/graph search
+ *   cleo memory code-links  — code ↔ memory connections
+ *   cleo memory code-auto-link — auto-link brain to nexus
+ *   cleo memory code-memories-for-code — memories referencing symbol
+ *   cleo memory code-for-memory — code nodes for memory entry
+ *   cleo memory consolidate — full consolidation pipeline
+ *   cleo memory dream       — full dream cycle (STDP)
+ *   cleo memory reflect     — LLM Observer + Reflector pipeline
+ *   cleo memory dedup-scan  — report/merge duplicate entries
+ *   cleo memory import      — migrate MEMORY.md files to brain.db
+ *   cleo memory llm-status  — LLM backend resolution status
+ *   cleo memory verify      — promote entry to verified=true
+ *   cleo memory pending-verify — list unverified high-citation entries
+ *   cleo memory tier        — tier management (stats|promote|demote)
+ *
+ * @task T4770 T614 T629
+ * @epic T4763 T627
+ */
+/**
+ * Root memory command group — registers all BRAIN memory subcommands.
+ *
+ * Dispatches to `memory.*` registry operations.
+ */
+export declare const memoryCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AA2vFH;;;;GAIG;AACH,eAAO,MAAM,aAAa,qDAoDxB,CAAC"}