@cleocode/cleo 2026.4.161 → 2026.5.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"reorder.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/reorder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;EA+CzB,CAAC"}

package/dist/cli/commands/reorder.js

@@ -0,0 +1,57 @@
+/**
+ * CLI command for changing task position within a sibling group.
+ *
+ * @task T4454
+ */
+import { defineCommand } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/** Sentinel value for --bottom: moves task to end of sibling list. */
+const BOTTOM_POSITION = 999999;
+/**
+ * cleo reorder — change task position within sibling group.
+ *
+ * Supports `--top` (position 0), `--bottom` (position 999999), or
+ * explicit `--position <n>` for precise placement.
+ */
+export const reorderCommand = defineCommand({
+    meta: { name: 'reorder', description: 'Change task position within sibling group' },
+    args: {
+        'task-id': {
+            type: 'positional',
+            description: 'Task ID to reorder',
+            required: true,
+        },
+        position: {
+            type: 'string',
+            description: 'Move to specific zero-based position among siblings',
+        },
+        top: {
+            type: 'boolean',
+            description: 'Move to the top (position 0)',
+        },
+        bottom: {
+            type: 'boolean',
+            description: 'Move to the bottom',
+        },
+    },
+    async run({ args }) {
+        const taskId = args['task-id'];
+        let position;
+        if (args.top) {
+            position = 0;
+        }
+        else if (args.bottom) {
+            position = BOTTOM_POSITION;
+        }
+        else if (args.position !== undefined) {
+            position = Number.parseInt(args.position, 10);
+        }
+        if (position === undefined) {
+            console.error('Error: Must specify --position <n>, --top, or --bottom.');
+            process.exitCode = 2;
+            return;
+        }
+        await dispatchFromCli('mutate', 'tasks', 'reorder', { taskId, position }, { command: 'reorder' });
+    },
+});
+//# sourceMappingURL=reorder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reorder.js","sourceRoot":"","sources":["../../../src/cli/commands/reorder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,sEAAsE;AACtE,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;IAC1C,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,2CAA2C,EAAE;IACnF,IAAI,EAAE;QACJ,SAAS,EAAE;YACT,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,oBAAoB;YACjC,QAAQ,EAAE,IAAI;SACf;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,qDAAqD;SACnE;QACD,GAAG,EAAE;YACH,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,8BAA8B;SAC5C;QACD,MAAM,EAAE;YACN,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,oBAAoB;SAClC;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/B,IAAI,QAA4B,CAAC;QAEjC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,QAAQ,GAAG,CAAC,CAAC;QACf,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACvB,QAAQ,GAAG,eAAe,CAAC;QAC7B,CAAC;aAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACvC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;YACzE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,eAAe,CACnB,QAAQ,EACR,OAAO,EACP,SAAS,EACT,EAAE,MAAM,EAAE,QAAQ,EAAE,EACpB,EAAE,OAAO,EAAE,SAAS,EAAE,CACvB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * CLI reparent command - move a task to a different parent.
+ * Delegates to src/core/tasks/reparent.ts (canonical implementation).
+ *
+ * @task T4807
+ * @epic T4454
+ */
+/**
+ * Native citty command for `cleo reparent` — moves a task to a different parent
+ * in the task hierarchy, or makes it root-level when `--to ""` is passed.
+ *
+ * @task T4807
+ * @epic T487
+ */
+export declare const reparentCommand: import("citty").CommandDef<{
+    readonly taskId: {
+        readonly type: "positional";
+        readonly description: "ID of the task to reparent";
+        readonly required: true;
+    };
+    readonly to: {
+        readonly type: "string";
+        readonly description: "Target parent task ID (or \"\" to make root)";
+        readonly required: true;
+    };
+}>;
+//# sourceMappingURL=reparent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reparent.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/reparent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;EAwB1B,CAAC"}

package/dist/cli/commands/reparent.js

@@ -0,0 +1,36 @@
+/**
+ * CLI reparent command - move a task to a different parent.
+ * Delegates to src/core/tasks/reparent.ts (canonical implementation).
+ *
+ * @task T4807
+ * @epic T4454
+ */
+import { defineCommand } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/**
+ * Native citty command for `cleo reparent` — moves a task to a different parent
+ * in the task hierarchy, or makes it root-level when `--to ""` is passed.
+ *
+ * @task T4807
+ * @epic T487
+ */
+export const reparentCommand = defineCommand({
+    meta: { name: 'reparent', description: 'Move task to a different parent in hierarchy' },
+    args: {
+        taskId: {
+            type: 'positional',
+            description: 'ID of the task to reparent',
+            required: true,
+        },
+        to: {
+            type: 'string',
+            description: 'Target parent task ID (or "" to make root)',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        const newParentId = args.to || null;
+        await dispatchFromCli('mutate', 'tasks', 'reparent', { taskId: args.taskId, newParentId }, { command: 'reparent' });
+    },
+});
+//# sourceMappingURL=reparent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reparent.js","sourceRoot":"","sources":["../../../src/cli/commands/reparent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;IAC3C,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,8CAA8C,EAAE;IACvF,IAAI,EAAE;QACJ,MAAM,EAAE;YACN,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,4BAA4B;YACzC,QAAQ,EAAE,IAAI;SACf;QACD,EAAE,EAAE;YACF,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,4CAA4C;YACzD,QAAQ,EAAE,IAAI;SACf;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,WAAW,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC;QACpC,MAAM,eAAe,CACnB,QAAQ,EACR,OAAO,EACP,UAAU,EACV,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,EACpC,EAAE,OAAO,EAAE,UAAU,EAAE,CACxB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,37 @@
+/**
+ * CLI command group for REQ-ID-addressable acceptance gate management.
+ *
+ * Subcommands:
+ *   cleo req add <taskId> --gate '<json>'   — add a typed AcceptanceGate with a REQ-ID
+ *   cleo req list <taskId>                  — list all REQ-ID gates on a task
+ *   cleo req migrate <taskId> [--apply]     — heuristic migrator for free-text criteria
+ *
+ * All output is JSON-envelope compliant (success + data).
+ * Validation against the AcceptanceGate Zod schema happens server-side
+ * (in the dispatch layer) before any write is performed.
+ *
+ * @epic T760
+ * @task T782
+ */
+/**
+ * Root req command group — manages REQ-ID-addressable acceptance gates.
+ *
+ * Dispatches to `tasks.req.*` registry operations.
+ *
+ * @example
+ * ```bash
+ * # Add a test gate with REQ-ID TIMER-01
+ * cleo req add T42 --gate '{"kind":"test","command":"pnpm test","expect":"pass","description":"Tests pass","req":"TIMER-01"}'
+ *
+ * # List all REQ-ID gates on T42
+ * cleo req list T42
+ *
+ * # Preview migration proposals for T42 (dry-run)
+ * cleo req migrate T42
+ *
+ * # Apply migration (write typed gates back to the task)
+ * cleo req migrate T42 --apply
+ * ```
+ */
+export declare const reqCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=req.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"req.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/req.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA0FH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,UAAU,qDAYrB,CAAC"}

package/dist/cli/commands/req.js

@@ -0,0 +1,121 @@
+/**
+ * CLI command group for REQ-ID-addressable acceptance gate management.
+ *
+ * Subcommands:
+ *   cleo req add <taskId> --gate '<json>'   — add a typed AcceptanceGate with a REQ-ID
+ *   cleo req list <taskId>                  — list all REQ-ID gates on a task
+ *   cleo req migrate <taskId> [--apply]     — heuristic migrator for free-text criteria
+ *
+ * All output is JSON-envelope compliant (success + data).
+ * Validation against the AcceptanceGate Zod schema happens server-side
+ * (in the dispatch layer) before any write is performed.
+ *
+ * @epic T760
+ * @task T782
+ */
+import { defineCommand, showUsage } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/** cleo req add <task-id> — add a typed AcceptanceGate (with REQ-ID) to a task */
+const addCommand = defineCommand({
+    meta: {
+        name: 'add',
+        description: "Add a typed AcceptanceGate (with REQ-ID) to a task's acceptance array",
+    },
+    args: {
+        'task-id': {
+            type: 'positional',
+            description: 'Task ID to add the gate to',
+            required: true,
+        },
+        gate: {
+            type: 'string',
+            description: 'AcceptanceGate JSON string (must match the AcceptanceGate schema; include "req" for a REQ-ID)',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        const taskId = args['task-id'];
+        const gate = args.gate;
+        if (!gate) {
+            process.stderr.write('Error: --gate <json> is required.\n' +
+                'Example: cleo req add T42 --gate \'{"kind":"test","command":"pnpm test","expect":"pass","description":"Tests pass","req":"TIMER-01"}\'\n');
+            process.exit(6);
+        }
+        await dispatchFromCli('mutate', 'tasks', 'req.add', { taskId, gate }, { command: 'req add' });
+    },
+});
+/** cleo req list <task-id> — list all REQ-ID-addressed acceptance gates on a task */
+const listCommand = defineCommand({
+    meta: { name: 'list', description: 'List all REQ-ID-addressed acceptance gates on a task' },
+    args: {
+        'task-id': {
+            type: 'positional',
+            description: 'Task ID to list gates for',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        const taskId = args['task-id'];
+        await dispatchFromCli('query', 'tasks', 'req.list', { taskId }, { command: 'req list' });
+    },
+});
+/** cleo req migrate <task-id> — heuristic migrator for free-text acceptance criteria */
+const migrateCommand = defineCommand({
+    meta: {
+        name: 'migrate',
+        description: 'Heuristic migrator: propose (or apply) typed gate replacements for free-text acceptance strings. ' +
+            'Heuristics: "tests pass" → test gate, "<file> exists" → file gate, ' +
+            '"lint clean" → lint gate, "<cmd> returns 0" → command gate, otherwise → manual gate.',
+    },
+    args: {
+        'task-id': {
+            type: 'positional',
+            description: 'Task ID to migrate gates for',
+            required: true,
+        },
+        apply: {
+            type: 'boolean',
+            description: 'Write the proposed typed gates back to the task (default: dry-run, print proposals only)',
+        },
+    },
+    async run({ args }) {
+        const taskId = args['task-id'];
+        const apply = Boolean(args.apply);
+        await dispatchFromCli(apply ? 'mutate' : 'query', 'tasks', 'req.migrate', { taskId, apply }, { command: 'req migrate' });
+    },
+});
+/**
+ * Root req command group — manages REQ-ID-addressable acceptance gates.
+ *
+ * Dispatches to `tasks.req.*` registry operations.
+ *
+ * @example
+ * ```bash
+ * # Add a test gate with REQ-ID TIMER-01
+ * cleo req add T42 --gate '{"kind":"test","command":"pnpm test","expect":"pass","description":"Tests pass","req":"TIMER-01"}'
+ *
+ * # List all REQ-ID gates on T42
+ * cleo req list T42
+ *
+ * # Preview migration proposals for T42 (dry-run)
+ * cleo req migrate T42
+ *
+ * # Apply migration (write typed gates back to the task)
+ * cleo req migrate T42 --apply
+ * ```
+ */
+export const reqCommand = defineCommand({
+    meta: { name: 'req', description: 'Manage REQ-ID-addressable acceptance gates on tasks' },
+    subCommands: {
+        add: addCommand,
+        list: listCommand,
+        migrate: migrateCommand,
+    },
+    async run({ cmd, rawArgs }) {
+        const firstArg = rawArgs?.find((a) => !a.startsWith('-'));
+        if (firstArg && cmd.subCommands && firstArg in cmd.subCommands)
+            return;
+        await showUsage(cmd);
+    },
+});
+//# sourceMappingURL=req.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * CLI research command group for manifest operations.
+ *
+ * Subcommands:
+ *   cleo research add      — add a research entry to pipeline_manifest (via cleo manifest append)
+ *   cleo research show     — show a single research entry
+ *   cleo research list     — list research entries with optional filters
+ *   cleo research pending  — list pending entries
+ *   cleo research link     — link a research entry to a task
+ *   cleo research update   — update findings on an existing entry
+ *   cleo research stats    — show research statistics
+ *   cleo research links    — show entries linked to a task
+ *   cleo research archive  — archive completed entries
+ *   cleo research manifest — query pipeline_manifest entries directly
+ *
+ * @task T4465
+ * @epic T4454
+ */
+/**
+ * Root research command group — registers all research subcommands.
+ *
+ * Dispatches to `pipeline.manifest.*` registry operations.
+ */
+export declare const researchCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=research.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/research.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAuWH;;;;GAIG;AACH,eAAO,MAAM,eAAe,qDAmB1B,CAAC"}

package/dist/cli/commands/research.js

@@ -0,0 +1,327 @@
+/**
+ * CLI research command group for manifest operations.
+ *
+ * Subcommands:
+ *   cleo research add      — add a research entry to pipeline_manifest (via cleo manifest append)
+ *   cleo research show     — show a single research entry
+ *   cleo research list     — list research entries with optional filters
+ *   cleo research pending  — list pending entries
+ *   cleo research link     — link a research entry to a task
+ *   cleo research update   — update findings on an existing entry
+ *   cleo research stats    — show research statistics
+ *   cleo research links    — show entries linked to a task
+ *   cleo research archive  — archive completed entries
+ *   cleo research manifest — query pipeline_manifest entries directly
+ *
+ * @task T4465
+ * @epic T4454
+ */
+import { defineCommand, showUsage } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Build a unique research manifest entry ID.
+ *
+ * Uses a `res_` prefix and the current timestamp to avoid collisions
+ * with task or other entity IDs.
+ */
+function generateResearchId() {
+    return `res_${Date.now()}`;
+}
+// ---------------------------------------------------------------------------
+// Subcommands
+// ---------------------------------------------------------------------------
+/** cleo research add — add a new research entry to pipeline_manifest (ADR-027) */
+const addCommand = defineCommand({
+    meta: { name: 'add', description: 'Add a research entry' },
+    args: {
+        task: {
+            type: 'string',
+            description: 'Task ID to attach research to',
+            required: true,
+            alias: 't',
+        },
+        topic: {
+            type: 'string',
+            description: 'Research topic',
+            required: true,
+        },
+        findings: {
+            type: 'string',
+            description: 'Comma-separated findings',
+        },
+        sources: {
+            type: 'string',
+            description: 'Comma-separated sources',
+        },
+        'agent-type': {
+            type: 'string',
+            description: 'Agent type that produced this entry',
+            default: 'researcher',
+        },
+    },
+    async run({ args }) {
+        const topic = args.topic;
+        const findings = args.findings ? args.findings.split(',').map((s) => s.trim()) : [];
+        const taskId = args.task;
+        const agentType = args['agent-type'] ?? 'researcher';
+        await dispatchFromCli('mutate', 'pipeline', 'manifest.append', {
+            entry: {
+                id: generateResearchId(),
+                file: `research/${topic.replace(/\s+/g, '-').toLowerCase()}.md`,
+                title: topic,
+                date: new Date().toISOString().slice(0, 10),
+                status: 'partial',
+                agent_type: agentType,
+                topics: [topic],
+                key_findings: findings,
+                actionable: findings.length > 0,
+                needs_followup: [],
+                linked_tasks: [taskId],
+            },
+        }, { command: 'research', operation: 'pipeline.manifest.append' });
+    },
+});
+/** cleo research show — show a single research entry by ID */
+const showCommand = defineCommand({
+    meta: { name: 'show', description: 'Show a research entry' },
+    args: {
+        id: {
+            type: 'positional',
+            description: 'Research entry ID',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'pipeline', 'manifest.show', { entryId: args.id }, { command: 'research' });
+    },
+});
+/** cleo research list — list research entries with optional filters */
+const listCommand = defineCommand({
+    meta: { name: 'list', description: 'List research entries' },
+    args: {
+        task: {
+            type: 'string',
+            description: 'Filter by task ID',
+            alias: 't',
+        },
+        status: {
+            type: 'string',
+            description: 'Filter by status',
+            alias: 's',
+        },
+        limit: {
+            type: 'string',
+            description: 'Limit results',
+            alias: 'l',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'pipeline', 'manifest.list', {
+            taskId: args.task,
+            status: args.status,
+            limit: args.limit ? Number.parseInt(args.limit, 10) : undefined,
+        }, { command: 'research' });
+    },
+});
+/** cleo research pending — list all pending research entries */
+const pendingCommand = defineCommand({
+    meta: { name: 'pending', description: 'List pending research entries' },
+    async run() {
+        await dispatchFromCli('query', 'pipeline', 'manifest.list', { status: 'pending' }, { command: 'research' });
+    },
+});
+/** cleo research link — link an existing research entry to a task */
+const linkCommand = defineCommand({
+    meta: { name: 'link', description: 'Link a research entry to a task' },
+    args: {
+        researchId: {
+            type: 'positional',
+            description: 'Research entry ID',
+            required: true,
+        },
+        taskId: {
+            type: 'positional',
+            description: 'Task ID to link to',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        const researchId = args.researchId;
+        const taskId = args.taskId;
+        await dispatchFromCli('mutate', 'pipeline', 'manifest.append', {
+            entry: {
+                id: researchId,
+                file: `research/link-${researchId}.md`,
+                title: `Link: ${researchId} -> ${taskId}`,
+                date: new Date().toISOString().slice(0, 10),
+                status: 'partial',
+                agent_type: 'researcher',
+                topics: [],
+                key_findings: [],
+                actionable: false,
+                needs_followup: [],
+                linked_tasks: [taskId],
+            },
+        }, { command: 'research', operation: 'pipeline.manifest.append' });
+    },
+});
+/** cleo research update — update findings on an existing research entry */
+const updateCommand = defineCommand({
+    meta: { name: 'update', description: 'Update research findings' },
+    args: {
+        id: {
+            type: 'positional',
+            description: 'Research entry ID',
+            required: true,
+        },
+        findings: {
+            type: 'string',
+            description: 'Comma-separated findings',
+        },
+        sources: {
+            type: 'string',
+            description: 'Comma-separated sources',
+        },
+        status: {
+            type: 'string',
+            description: 'Set status (completed, partial, blocked)',
+            alias: 's',
+        },
+        topic: {
+            type: 'string',
+            description: 'Research topic (used as title)',
+        },
+    },
+    async run({ args }) {
+        const id = args.id;
+        const findings = args.findings ? args.findings.split(',').map((s) => s.trim()) : [];
+        const status = args.status ?? 'partial';
+        const topic = args.topic ?? `Updated research: ${id}`;
+        await dispatchFromCli('mutate', 'pipeline', 'manifest.append', {
+            entry: {
+                id,
+                file: `research/${id}.md`,
+                title: topic,
+                date: new Date().toISOString().slice(0, 10),
+                status,
+                agent_type: 'researcher',
+                topics: topic !== `Updated research: ${id}` ? [topic] : [],
+                key_findings: findings,
+                actionable: findings.length > 0,
+                needs_followup: [],
+                linked_tasks: [],
+            },
+        }, { command: 'research', operation: 'pipeline.manifest.append' });
+    },
+});
+/** cleo research stats — show research statistics */
+const statsCommand = defineCommand({
+    meta: { name: 'stats', description: 'Show research statistics' },
+    async run() {
+        await dispatchFromCli('query', 'pipeline', 'manifest.stats', {}, { command: 'research' });
+    },
+});
+/** cleo research links — show research entries linked to a task */
+const linksCommand = defineCommand({
+    meta: { name: 'links', description: 'Show research entries linked to a task' },
+    args: {
+        taskId: {
+            type: 'positional',
+            description: 'Task ID',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'pipeline', 'manifest.find', { taskId: args.taskId }, { command: 'research' });
+    },
+});
+/** cleo research archive — archive completed research entries */
+const archiveCommand = defineCommand({
+    meta: { name: 'archive', description: 'Archive completed research entries' },
+    args: {
+        'before-date': {
+            type: 'string',
+            description: 'Archive entries before this date (YYYY-MM-DD)',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'pipeline', 'manifest.archive', {
+            beforeDate: args['before-date'],
+        }, { command: 'research' });
+    },
+});
+/** cleo research manifest — query pipeline_manifest entries directly */
+const manifestCommand = defineCommand({
+    meta: { name: 'manifest', description: 'Query pipeline_manifest entries' },
+    args: {
+        status: {
+            type: 'string',
+            description: 'Filter by status',
+            alias: 's',
+        },
+        'agent-type': {
+            type: 'string',
+            description: 'Filter by agent type',
+            alias: 'a',
+        },
+        topic: {
+            type: 'string',
+            description: 'Filter by topic',
+        },
+        task: {
+            type: 'string',
+            description: 'Filter by linked task',
+            alias: 't',
+        },
+        limit: {
+            type: 'string',
+            description: 'Limit results',
+            alias: 'l',
+        },
+    },
+    async run({ args }) {
+        // Print deprecation warning to stderr before executing
+        console.error('DEPRECATED: `cleo research manifest` is deprecated and will be removed in v2026.6.x.\n' +
+            'Use `cleo manifest list` instead. See docs/specs/T1096-manifest-unification-spec.md');
+        await dispatchFromCli('query', 'pipeline', 'manifest.list', {
+            status: args.status,
+            agentType: args['agent-type'],
+            topic: args.topic,
+            taskId: args.task,
+            limit: args.limit ? Number.parseInt(args.limit, 10) : undefined,
+        }, { command: 'research' });
+    },
+});
+// ---------------------------------------------------------------------------
+// Root export
+// ---------------------------------------------------------------------------
+/**
+ * Root research command group — registers all research subcommands.
+ *
+ * Dispatches to `pipeline.manifest.*` registry operations.
+ */
+export const researchCommand = defineCommand({
+    meta: { name: 'research', description: 'Research commands and manifest operations' },
+    subCommands: {
+        add: addCommand,
+        show: showCommand,
+        list: listCommand,
+        pending: pendingCommand,
+        link: linkCommand,
+        update: updateCommand,
+        stats: statsCommand,
+        links: linksCommand,
+        archive: archiveCommand,
+        manifest: manifestCommand,
+    },
+    async run({ cmd, rawArgs }) {
+        const firstArg = rawArgs?.find((a) => !a.startsWith('-'));
+        if (firstArg && cmd.subCommands && firstArg in cmd.subCommands)
+            return;
+        await showUsage(cmd);
+    },
+});
+//# sourceMappingURL=research.js.map