@cleocode/cleo 2026.4.161 → 2026.5.1

package/dist/cli/commands/lifecycle.js

@@ -0,0 +1,221 @@
+/**
+ * CLI command group for the RCASD-IVTR+C lifecycle pipeline.
+ *
+ * Exposes 10 subcommands:
+ *   cleo lifecycle show <epicId>           — show lifecycle state
+ *   cleo lifecycle start <epicId> <stage>  — start a stage
+ *   cleo lifecycle complete <epicId> <stage> — complete a stage
+ *   cleo lifecycle skip <epicId> <stage>   — skip a stage (--reason required)
+ *   cleo lifecycle gate <epicId> <stage>   — check lifecycle gate
+ *   cleo lifecycle guidance [stage]        — get stage-aware LLM prompt guidance
+ *   cleo lifecycle history <taskId>        — show full stage history
+ *   cleo lifecycle reset <epicId> <stage>  — reset a stage (--reason required)
+ *   cleo lifecycle gate-record pass ...    — record a gate as passed
+ *   cleo lifecycle gate-record fail ...    — record a gate as failed
+ *
+ * @task T4467
+ * @epic T4454
+ */
+import { defineCommand, showUsage } from 'citty';
+import { dispatchFromCli, dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+const VALID_STAGES = 'research|consensus|architecture_decision|specification|decomposition|implementation|validation|testing|release|contribution';
+/** cleo lifecycle show <epicId> — show lifecycle state for an epic */
+const showCommand = defineCommand({
+    meta: { name: 'show', description: 'Show lifecycle state for an epic' },
+    args: {
+        epicId: { type: 'positional', description: 'Epic ID', required: true },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'pipeline', 'stage.status', { epicId: args.epicId }, { command: 'lifecycle' });
+    },
+});
+/** cleo lifecycle start <epicId> <stage> — start a lifecycle stage */
+const startCommand = defineCommand({
+    meta: {
+        name: 'start',
+        description: `Start a lifecycle stage. Valid stages: ${VALID_STAGES}`,
+    },
+    args: {
+        epicId: { type: 'positional', description: 'Epic ID', required: true },
+        stage: { type: 'positional', description: 'Stage name', required: true },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'pipeline', 'stage.record', { taskId: args.epicId, stage: args.stage, status: 'in_progress' }, { command: 'lifecycle' });
+    },
+});
+/** cleo lifecycle complete <epicId> <stage> — complete a lifecycle stage */
+const completeCommand = defineCommand({
+    meta: {
+        name: 'complete',
+        description: `Complete a lifecycle stage. Valid stages: ${VALID_STAGES}`,
+    },
+    args: {
+        epicId: { type: 'positional', description: 'Epic ID', required: true },
+        stage: { type: 'positional', description: 'Stage name', required: true },
+        artifacts: { type: 'string', description: 'Comma-separated artifact paths' },
+        notes: { type: 'string', description: 'Completion notes' },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'pipeline', 'stage.record', {
+            taskId: args.epicId,
+            stage: args.stage,
+            status: 'completed',
+            notes: args.notes,
+        }, { command: 'lifecycle' });
+    },
+});
+/** cleo lifecycle skip <epicId> <stage> — skip a lifecycle stage */
+const skipCommand = defineCommand({
+    meta: {
+        name: 'skip',
+        description: `Skip a lifecycle stage. Valid stages: ${VALID_STAGES}`,
+    },
+    args: {
+        epicId: { type: 'positional', description: 'Epic ID', required: true },
+        stage: { type: 'positional', description: 'Stage name', required: true },
+        reason: { type: 'string', description: 'Reason for skipping', required: true },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'pipeline', 'stage.skip', { taskId: args.epicId, stage: args.stage, reason: args.reason }, { command: 'lifecycle' });
+    },
+});
+/** cleo lifecycle gate <epicId> <stage> — check lifecycle gate for a stage */
+const gateCommand = defineCommand({
+    meta: { name: 'gate', description: 'Check lifecycle gate for a stage' },
+    args: {
+        epicId: { type: 'positional', description: 'Epic ID', required: true },
+        stage: { type: 'positional', description: 'Stage name', required: true },
+    },
+    async run({ args }) {
+        const result = await dispatchRaw('query', 'pipeline', 'stage.validate', {
+            epicId: args.epicId,
+            targetStage: args.stage,
+        });
+        if (result.success) {
+            const { cliOutput } = await import('../renderers/index.js');
+            cliOutput(result.data, { command: 'lifecycle' });
+            const data = result.data;
+            if (data && !data['canProgress']) {
+                process.exit(80);
+            }
+        }
+        else {
+            handleRawError(result, { command: 'lifecycle', operation: 'pipeline.stage.validate' });
+        }
+    },
+});
+/** cleo lifecycle guidance [stage] — get stage-aware LLM prompt guidance */
+const guidanceCommand = defineCommand({
+    meta: {
+        name: 'guidance',
+        description: 'Get stage-aware LLM prompt guidance (Phase 2). Pi extensions shell out to this on before_agent_start.',
+    },
+    args: {
+        stage: { type: 'positional', description: 'Stage name (optional)', required: false },
+        epicId: {
+            type: 'string',
+            description: 'Resolve stage from current epic pipeline status if no stage arg',
+        },
+        format: { type: 'string', description: 'Output format: markdown | json', default: 'markdown' },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'pipeline', 'stage.guidance', {
+            stage: args.stage,
+            epicId: args.epicId,
+            format: args.format,
+        }, { command: 'lifecycle' });
+    },
+});
+/** cleo lifecycle history <taskId> — show full lifecycle stage history */
+const historyCommand = defineCommand({
+    meta: { name: 'history', description: 'Show full lifecycle stage history for a task or epic' },
+    args: {
+        taskId: { type: 'positional', description: 'Task or epic ID', required: true },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'pipeline', 'stage.history', { taskId: args.taskId }, { command: 'lifecycle' });
+    },
+});
+/** cleo lifecycle reset <epicId> <stage> — reset a lifecycle stage back to pending */
+const resetCommand = defineCommand({
+    meta: {
+        name: 'reset',
+        description: `Reset a lifecycle stage back to pending. Valid stages: ${VALID_STAGES}`,
+    },
+    args: {
+        epicId: { type: 'positional', description: 'Epic ID', required: true },
+        stage: { type: 'positional', description: 'Stage name', required: true },
+        reason: { type: 'string', description: 'Reason for resetting the stage', required: true },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'pipeline', 'stage.reset', { taskId: args.epicId, stage: args.stage, reason: args.reason }, { command: 'lifecycle' });
+    },
+});
+/** cleo lifecycle gate-record pass <epicId> <gateName> — record a gate as passed */
+const gateRecordPassCommand = defineCommand({
+    meta: { name: 'pass', description: 'Record a gate as passed for a lifecycle stage' },
+    args: {
+        epicId: { type: 'positional', description: 'Epic ID', required: true },
+        gateName: { type: 'positional', description: 'Gate name', required: true },
+        agent: { type: 'string', description: 'Agent that performed the gate check' },
+        notes: { type: 'string', description: 'Notes on gate outcome' },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'pipeline', 'stage.gate.pass', {
+            taskId: args.epicId,
+            gateName: args.gateName,
+            agent: args.agent,
+            notes: args.notes,
+        }, { command: 'lifecycle' });
+    },
+});
+/** cleo lifecycle gate-record fail <epicId> <gateName> — record a gate as failed */
+const gateRecordFailCommand = defineCommand({
+    meta: { name: 'fail', description: 'Record a gate as failed for a lifecycle stage' },
+    args: {
+        epicId: { type: 'positional', description: 'Epic ID', required: true },
+        gateName: { type: 'positional', description: 'Gate name', required: true },
+        reason: { type: 'string', description: 'Reason the gate failed' },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'pipeline', 'stage.gate.fail', {
+            taskId: args.epicId,
+            gateName: args.gateName,
+            reason: args.reason,
+        }, { command: 'lifecycle' });
+    },
+});
+/** cleo lifecycle gate-record — record a gate pass or fail for a lifecycle stage */
+const gateRecordCommand = defineCommand({
+    meta: { name: 'gate-record', description: 'Record a gate pass or fail for a lifecycle stage' },
+    subCommands: {
+        pass: gateRecordPassCommand,
+        fail: gateRecordFailCommand,
+    },
+});
+/**
+ * Root lifecycle command group — RCASD-IVTR+C lifecycle pipeline management.
+ *
+ * Dispatches all stage operations to the `pipeline` dispatch domain.
+ */
+export const lifecycleCommand = defineCommand({
+    meta: { name: 'lifecycle', description: 'RCASD-IVTR+C lifecycle pipeline management' },
+    subCommands: {
+        show: showCommand,
+        start: startCommand,
+        complete: completeCommand,
+        skip: skipCommand,
+        gate: gateCommand,
+        guidance: guidanceCommand,
+        history: historyCommand,
+        reset: resetCommand,
+        'gate-record': gateRecordCommand,
+    },
+    async run({ cmd, rawArgs }) {
+        const firstArg = rawArgs?.find((a) => !a.startsWith('-'));
+        if (firstArg && cmd.subCommands && firstArg in cmd.subCommands)
+            return;
+        await showUsage(cmd);
+    },
+});
+//# sourceMappingURL=lifecycle.js.map

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

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

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

@@ -0,0 +1,28 @@
+/**
+ * CLI list command — list tasks with optional filters.
+ *
+ * Dispatches to `tasks.list` via dispatchRaw and renders the result
+ * through cliOutput with pagination support.
+ *
+ * Args are derived from the registry via `paramsToCittyArgs` so that the
+ * CLI surface stays in sync with `tasks.list` params[] (T864 SSoT).
+ * CLI-only compatibility aliases are layered locally after registry arg
+ * derivation so dispatch still receives canonical task params.
+ *
+ * @task T4460
+ * @task T4668
+ * @task T864
+ * @epic T4454
+ */
+/**
+ * cleo list — list tasks with optional filters.
+ *
+ * Alias `ls` is wired in index.ts.
+ */
+export declare const listCommand: import("citty").CommandDef<{
+    readonly 'parent-id': {
+        readonly type: "string";
+        readonly description: "Alias for --parent (legacy parentId compatibility)";
+    };
+}>;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAiBH;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;EA2CtB,CAAC"}

package/dist/cli/commands/list.js

@@ -0,0 +1,81 @@
+/**
+ * CLI list command — list tasks with optional filters.
+ *
+ * Dispatches to `tasks.list` via dispatchRaw and renders the result
+ * through cliOutput with pagination support.
+ *
+ * Args are derived from the registry via `paramsToCittyArgs` so that the
+ * CLI surface stays in sync with `tasks.list` params[] (T864 SSoT).
+ * CLI-only compatibility aliases are layered locally after registry arg
+ * derivation so dispatch still receives canonical task params.
+ *
+ * @task T4460
+ * @task T4668
+ * @task T864
+ * @epic T4454
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { createPage } from '@cleocode/core';
+import { defineCommand } from 'citty';
+import { dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+import { getOperationParams, paramsToCittyArgs } from '../lib/registry-args.js';
+import { cliOutput } from '../renderers/index.js';
+const listArgs = {
+    ...paramsToCittyArgs(getOperationParams('query', 'tasks', 'list')),
+    'parent-id': {
+        type: 'string',
+        description: 'Alias for --parent (legacy parentId compatibility)',
+    },
+};
+/**
+ * cleo list — list tasks with optional filters.
+ *
+ * Alias `ls` is wired in index.ts.
+ */
+export const listCommand = defineCommand({
+    meta: { name: 'list', description: 'List tasks with optional filters' },
+    args: listArgs,
+    async run({ args }) {
+        const limit = args['limit'] !== undefined ? parseInt(args['limit'], 10) : undefined;
+        const offset = args['offset'] !== undefined ? parseInt(args['offset'], 10) : undefined;
+        const params = {};
+        if (args['status'] !== undefined)
+            params['status'] = args['status'];
+        if (args['priority'] !== undefined)
+            params['priority'] = args['priority'];
+        if (args['type'] !== undefined)
+            params['type'] = args['type'];
+        if (args['parent'] !== undefined)
+            params['parent'] = args['parent'];
+        if (args['parent-id'] !== undefined)
+            params['parent'] = params['parent'] ?? args['parent-id'];
+        if (args['phase'] !== undefined)
+            params['phase'] = args['phase'];
+        if (args['label'] !== undefined)
+            params['label'] = args['label'];
+        if (args['children'] !== undefined)
+            params['children'] = args['children'];
+        if (limit !== undefined)
+            params['limit'] = limit;
+        if (offset !== undefined)
+            params['offset'] = offset;
+        const response = await dispatchRaw('query', 'tasks', 'list', params);
+        if (!response.success) {
+            handleRawError(response, { command: 'list', operation: 'tasks.list' });
+        }
+        const rawData = response.data;
+        const data = (Array.isArray(rawData)
+            ? { tasks: rawData, total: rawData.length }
+            : rawData) ?? {};
+        const tasks = Array.isArray(data?.tasks) ? data.tasks : [];
+        if (tasks.length === 0) {
+            cliOutput(data, { command: 'list', message: 'No tasks found', operation: 'tasks.list' });
+            process.exit(ExitCode.NO_DATA);
+            return;
+        }
+        const filtered = data?.filtered ?? tasks.length;
+        const page = response.page ?? createPage({ total: filtered, limit, offset });
+        cliOutput(data, { command: 'list', operation: 'tasks.list', page });
+    },
+});
+//# sourceMappingURL=list.js.map

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

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

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

@@ -0,0 +1,36 @@
+/**
+ * CLI log command — view audit log entries.
+ *
+ * Dispatches to `admin.log` via dispatchFromCli.
+ *
+ * @task T4538
+ * @epic T4454
+ */
+/**
+ * cleo log — view audit log entries (operations, timestamps, changes).
+ */
+export declare const logCommand: import("citty").CommandDef<{
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Maximum entries to show";
+        readonly default: "20";
+    };
+    readonly offset: {
+        readonly type: "string";
+        readonly description: "Skip N entries";
+        readonly default: "0";
+    };
+    readonly operation: {
+        readonly type: "string";
+        readonly description: "Filter by operation type";
+    };
+    readonly task: {
+        readonly type: "string";
+        readonly description: "Filter by task ID";
+    };
+    readonly since: {
+        readonly type: "string";
+        readonly description: "Filter entries since date";
+    };
+}>;
+//# sourceMappingURL=log.d.ts.map

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

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

package/dist/cli/commands/log.js

@@ -0,0 +1,50 @@
+/**
+ * CLI log command — view audit log entries.
+ *
+ * Dispatches to `admin.log` via dispatchFromCli.
+ *
+ * @task T4538
+ * @epic T4454
+ */
+import { defineCommand } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/**
+ * cleo log — view audit log entries (operations, timestamps, changes).
+ */
+export const logCommand = defineCommand({
+    meta: { name: 'log', description: 'View audit log entries (operations, timestamps, changes)' },
+    args: {
+        limit: {
+            type: 'string',
+            description: 'Maximum entries to show',
+            default: '20',
+        },
+        offset: {
+            type: 'string',
+            description: 'Skip N entries',
+            default: '0',
+        },
+        operation: {
+            type: 'string',
+            description: 'Filter by operation type',
+        },
+        task: {
+            type: 'string',
+            description: 'Filter by task ID',
+        },
+        since: {
+            type: 'string',
+            description: 'Filter entries since date',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'admin', 'log', {
+            limit: args.limit ? Number(args.limit) : 20,
+            offset: args.offset ? Number(args.offset) : 0,
+            operation: args.operation,
+            taskId: args.task,
+            since: args.since,
+        }, { command: 'log', operation: 'admin.log' });
+    },
+});
+//# sourceMappingURL=log.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../../src/cli/commands/log.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;GAEG;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,QAAQ;YACd,WAAW,EAAE,yBAAyB;YACtC,OAAO,EAAE,IAAI;SACd;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gBAAgB;YAC7B,OAAO,EAAE,GAAG;SACb;QACD,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,0BAA0B;SACxC;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mBAAmB;SACjC;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,2BAA2B;SACzC;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,KAAK,EACL;YACE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;YAC3C,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7C,SAAS,EAAE,IAAI,CAAC,SAA+B;YAC/C,MAAM,EAAE,IAAI,CAAC,IAA0B;YACvC,KAAK,EAAE,IAAI,CAAC,KAA2B;SACxC,EACD,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,CAC3C,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * 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
+ */
+export declare const manifestCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=manifest.d.ts.map

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

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