@cleocode/cleo 2026.4.57 → 2026.4.59

package/dist/cli/commands/session.js

@@ -0,0 +1,219 @@
+/**
+ * CLI session command group.
+ * @task T4463
+ * @epic T4454
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { dispatchFromCli, dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+import { cliOutput } from '../renderers/index.js';
+/**
+ * Register the session command group.
+ * @task T4463
+ */
+export function registerSessionCommand(program) {
+    const session = program.command('session').description('Manage work sessions');
+    session
+        .command('start')
+        .description('Start a new session')
+        .requiredOption('--scope <scope>', 'Session scope (epic:T### or global)')
+        .requiredOption('--name <name>', 'Session name')
+        .option('--auto-start', 'Auto-start on first available task')
+        .option('--auto-focus', 'Auto-focus on first available task (alias for --auto-start)')
+        .option('--focus <taskId>', 'Set initial task to work on')
+        .option('--agent <agent>', 'Agent identifier')
+        .option('--grade', 'Enable full query+mutation audit logging for behavioral grading')
+        .action(async (opts) => {
+        await dispatchFromCli('mutate', 'session', 'start', {
+            scope: opts['scope'],
+            name: opts['name'],
+            autoStart: (opts['autoStart'] || opts['autoFocus']),
+            focus: opts['focus'],
+            grade: opts['grade'],
+        }, { command: 'session', operation: 'session.start' });
+    });
+    session
+        .command('end')
+        .alias('stop')
+        .description('End the current session')
+        .option('--session <id>', 'Specific session ID to stop')
+        .option('--note <note>', 'Stop note')
+        .option('--next-action <action>', 'Suggested next action')
+        .action(async (opts) => {
+        await dispatchFromCli('mutate', 'session', 'end', {
+            note: opts['note'],
+            nextAction: opts['nextAction'],
+        }, { command: 'session', operation: 'session.end' });
+    });
+    session
+        .command('handoff')
+        .description('Show handoff data from the most recent ended session')
+        .option('--scope <scope>', 'Filter by scope (epic:T### or global)')
+        .action(async (opts) => {
+        const scope = opts['scope'];
+        const response = await dispatchRaw('query', 'session', 'handoff.show', {
+            scope,
+        });
+        if (!response.success) {
+            handleRawError(response, { command: 'session handoff', operation: 'session.handoff.show' });
+        }
+        const data = response.data;
+        if (!data?.handoff) {
+            cliOutput({ handoff: null }, {
+                command: 'session handoff',
+                message: 'No handoff data available',
+                operation: 'session.handoff.show',
+            });
+            process.exit(ExitCode.NO_DATA);
+            return;
+        }
+        const { sessionId, handoff } = data;
+        // Format the handoff data for display
+        const formattedHandoff = {
+            sessionId,
+            lastTask: handoff.lastTask ?? 'None',
+            tasksCompleted: handoff.tasksCompleted ?? [],
+            tasksCreated: handoff.tasksCreated ?? [],
+            decisionsRecorded: handoff.decisionsRecorded ?? 0,
+            nextSuggested: handoff.nextSuggested ?? [],
+            openBlockers: handoff.openBlockers ?? [],
+            openBugs: handoff.openBugs ?? [],
+            ...(handoff.note ? { note: handoff.note } : {}),
+            ...(handoff.nextAction ? { nextAction: handoff.nextAction } : {}),
+        };
+        cliOutput({ handoff: formattedHandoff }, { command: 'session handoff', operation: 'session.handoff.show' });
+    });
+    session
+        .command('status')
+        .description('Show current session status')
+        .action(async () => {
+        const response = await dispatchRaw('query', 'session', 'status');
+        if (!response.success) {
+            handleRawError(response, { command: 'session', operation: 'session.status' });
+        }
+        const data = response.data;
+        if (!data || data['session'] === null || (data['session'] === undefined && !data['id'])) {
+            cliOutput({ session: null }, { command: 'session', message: 'No active session', operation: 'session.status' });
+            process.exit(ExitCode.NO_DATA);
+            return;
+        }
+        cliOutput({ session: data }, { command: 'session', operation: 'session.status' });
+    });
+    session
+        .command('resume <sessionId>')
+        .description('Resume an existing session')
+        .action(async (sessionId) => {
+        await dispatchFromCli('mutate', 'session', 'resume', {
+            sessionId,
+        }, { command: 'session', operation: 'session.resume' });
+    });
+    session
+        .command('find')
+        .description('Find sessions (lightweight discovery — minimal fields, low context cost)')
+        .option('--status <status>', 'Filter by status (active|ended|orphaned)')
+        .option('--scope <scope>', 'Filter by scope (e.g. "epic:T001" or "global")')
+        .option('--query <query>', 'Fuzzy match on session name or ID')
+        .option('--limit <n>', 'Max results', parseInt)
+        .action(async (opts) => {
+        await dispatchFromCli('query', 'session', 'find', {
+            status: opts['status'],
+            scope: opts['scope'],
+            query: opts['query'],
+            limit: opts['limit'],
+        }, { command: 'session', operation: 'session.find' });
+    });
+    session
+        .command('list')
+        .description('List sessions')
+        .option('--status <status>', 'Filter by status (active|ended|orphaned)')
+        .option('--limit <n>', 'Max results', parseInt)
+        .option('--offset <n>', 'Skip first n results', parseInt)
+        .action(async (opts) => {
+        await dispatchFromCli('query', 'session', 'list', {
+            status: opts['status'],
+            limit: opts['limit'],
+            offset: opts['offset'],
+        }, { command: 'session', operation: 'session.list' });
+    });
+    session
+        .command('gc')
+        .description('Garbage collect old sessions')
+        .option('--max-age <days>', 'Max age in days for active sessions', parseInt)
+        .action(async (opts) => {
+        await dispatchFromCli('mutate', 'session', 'gc', {
+            maxAgeDays: opts['maxAge'],
+        }, { command: 'session', operation: 'session.gc' });
+    });
+    session
+        .command('show <sessionId>')
+        .description('Show full details for a session (absorbs debrief.show via --include debrief)')
+        .option('--include <include>', 'Include extra data (debrief)')
+        .action(async (sessionId, opts) => {
+        await dispatchFromCli('query', 'session', 'show', {
+            sessionId,
+            include: opts['include'],
+        }, { command: 'session', operation: 'session.show' });
+    });
+    session
+        .command('context-drift')
+        .description('Detect context drift in the current or specified session')
+        .option('--session-id <sessionId>', 'Session ID to check (defaults to active session)')
+        .action(async (opts) => {
+        await dispatchFromCli('query', 'session', 'context.drift', {
+            sessionId: opts['sessionId'],
+        }, { command: 'session', operation: 'session.context.drift' });
+    });
+    session
+        .command('suspend <sessionId>')
+        .description('Suspend an active session (pause without ending)')
+        .option('--reason <reason>', 'Reason for suspension')
+        .action(async (sessionId, opts) => {
+        await dispatchFromCli('mutate', 'session', 'suspend', {
+            sessionId,
+            reason: opts['reason'],
+        }, { command: 'session', operation: 'session.suspend' });
+    });
+    session
+        .command('record-assumption')
+        .description('Record an assumption made during the current session')
+        .requiredOption('--assumption <assumption>', 'Assumption text')
+        .requiredOption('--confidence <confidence>', 'Confidence level (high|medium|low)')
+        .option('--session-id <sessionId>', 'Session ID (defaults to active session)')
+        .option('--task-id <taskId>', 'Task ID the assumption relates to')
+        .action(async (opts) => {
+        await dispatchFromCli('mutate', 'session', 'record.assumption', {
+            sessionId: opts['sessionId'],
+            taskId: opts['taskId'],
+            assumption: opts['assumption'],
+            confidence: opts['confidence'],
+        }, { command: 'session', operation: 'session.record.assumption' });
+    });
+    session
+        .command('record-decision')
+        .description('Record a decision made during the current session')
+        .option('--session-id <sessionId>', 'Session ID (defaults to active session)')
+        .requiredOption('--task-id <taskId>', 'Task ID the decision relates to')
+        .requiredOption('--decision <decision>', 'Decision text')
+        .requiredOption('--rationale <rationale>', 'Rationale for the decision')
+        .option('--alternatives <alternatives>', 'Alternatives considered')
+        .action(async (opts) => {
+        await dispatchFromCli('mutate', 'session', 'record.decision', {
+            sessionId: opts['sessionId'],
+            taskId: opts['taskId'],
+            decision: opts['decision'],
+            rationale: opts['rationale'],
+            alternatives: opts['alternatives'],
+        }, { command: 'session', operation: 'session.record.decision' });
+    });
+    session
+        .command('decision-log')
+        .description('Show decisions recorded in a session')
+        .option('--session-id <sessionId>', 'Session ID to filter by')
+        .option('--task-id <taskId>', 'Task ID to filter by')
+        .action(async (opts) => {
+        await dispatchFromCli('query', 'session', 'decision.log', {
+            sessionId: opts['sessionId'],
+            taskId: opts['taskId'],
+        }, { command: 'session', operation: 'session.decision.log' });
+    });
+}
+//# sourceMappingURL=session.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * CLI show command.
+ * @task T4460
+ * @epic T4454
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the show command.
+ * @task T4460
+ * @task T4666
+ */
+export declare function registerShowCommand(program: Command): void;
+//# sourceMappingURL=show.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/show.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAmBnE;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmB1D"}

package/dist/cli/commands/show.js

@@ -0,0 +1,40 @@
+/**
+ * CLI show command.
+ * @task T4460
+ * @epic T4454
+ */
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+import { applyParamDefsToCommand, buildOperationHelp } from '../help-generator.js';
+// ---------------------------------------------------------------------------
+// ParamDef array for tasks.show
+//
+// Mirrors STATIC_PARAMS_TABLE in packages/lafs/src/operation-gates.ts.
+// Will be upstreamed into registry.ts during the T4897 migration.
+// ---------------------------------------------------------------------------
+const SHOW_PARAMS = [
+    {
+        name: 'taskId',
+        type: 'string',
+        required: true,
+        description: 'ID of the task to retrieve',
+        cli: { positional: true },
+    },
+];
+/**
+ * Register the show command.
+ * @task T4460
+ * @task T4666
+ */
+export function registerShowCommand(program) {
+    const cmd = program
+        .command('show')
+        .description(buildOperationHelp('tasks.show', 'Show full task details by ID (returns complete task record with metadata, verification, lifecycle)', SHOW_PARAMS));
+    // Auto-generate the <taskId> positional arg from the ParamDef registry.
+    // Replaces the previous hard-coded 'show <taskId>' in the command name string
+    // and surfaces the task-exists gate in --help output.
+    applyParamDefsToCommand(cmd, SHOW_PARAMS, 'tasks.show');
+    cmd.action(async (taskId) => {
+        await dispatchFromCli('query', 'tasks', 'show', { taskId }, { command: 'show' });
+    });
+}
+//# sourceMappingURL=show.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../../src/cli/commands/show.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEnF,8EAA8E;AAC9E,gCAAgC;AAChC,EAAE;AACF,uEAAuE;AACvE,kEAAkE;AAClE,8EAA8E;AAC9E,MAAM,WAAW,GAAwB;IACvC;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,4BAA4B;QACzC,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;KAC1B;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,MAAM,GAAG,GAAG,OAAO;SAChB,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CACV,kBAAkB,CAChB,YAAY,EACZ,oGAAoG,EACpG,WAAW,CACZ,CACF,CAAC;IAEJ,wEAAwE;IACxE,8EAA8E;IAC9E,sDAAsD;IACtD,uBAAuB,CAAC,GAAG,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IAExD,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,EAAE;QAClC,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * CLI skills command - skill management: list, search, validate, info, install.
+ *
+ * @task T4555
+ * @epic T4545
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the skills command with all subcommands.
+ * @task T4555
+ */
+export declare function registerSkillsCommand(program: Command): void;
+//# sourceMappingURL=skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/skills.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgQ5D"}

package/dist/cli/commands/skills.js

@@ -0,0 +1,161 @@
+/**
+ * CLI skills command - skill management: list, search, validate, info, install.
+ *
+ * @task T4555
+ * @epic T4545
+ */
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/**
+ * Register the skills command with all subcommands.
+ * @task T4555
+ */
+export function registerSkillsCommand(program) {
+    const skillsCmd = program
+        .command('skills')
+        .description('Skill management: list, search, validate, info, install');
+    // Subcommand: list
+    skillsCmd
+        .command('list')
+        .description('List installed skills')
+        .option('--global', 'Use global skills directory')
+        .action(async (opts) => {
+        await dispatchFromCli('query', 'tools', 'skill.list', {
+            scope: opts['global'] ? 'global' : 'project',
+        }, { command: 'skills', operation: 'tools.skill.list' });
+    });
+    // Subcommand: search / find
+    skillsCmd
+        .command('search <query>')
+        .description('Search for skills')
+        .option('--mp', 'Search marketplace (agentskills.in)')
+        .option('--all', 'Search both local and marketplace')
+        .action(async (query, opts) => {
+        await dispatchFromCli('query', 'tools', 'skill.find', {
+            query,
+            source: opts['mp'] ? 'skillsmp' : opts['all'] ? 'all' : 'local',
+        }, { command: 'skills', operation: 'tools.skill.find' });
+    });
+    // Subcommand: validate
+    skillsCmd
+        .command('validate <skill-name>')
+        .description('Validate skill against protocol')
+        .action(async (skillName) => {
+        await dispatchFromCli('query', 'tools', 'skill.verify', {
+            name: skillName,
+        }, { command: 'skills', operation: 'tools.skill.verify' });
+    });
+    // Subcommand: info
+    skillsCmd
+        .command('info <skill-name>')
+        .description('Show skill details')
+        .action(async (skillName) => {
+        await dispatchFromCli('query', 'tools', 'skill.show', {
+            name: skillName,
+        }, { command: 'skills', operation: 'tools.skill.show' });
+    });
+    // Subcommand: install
+    skillsCmd
+        .command('install <skill-name>')
+        .description('Install skill to agent directory')
+        .option('--global', 'Install globally')
+        .action(async (skillName, opts) => {
+        await dispatchFromCli('mutate', 'tools', 'skill.install', {
+            name: skillName,
+            global: !!opts['global'],
+        }, { command: 'skills', operation: 'tools.skill.install' });
+    });
+    // Subcommand: uninstall
+    skillsCmd
+        .command('uninstall <skill-name>')
+        .description('Uninstall a skill')
+        .action(async (skillName) => {
+        await dispatchFromCli('mutate', 'tools', 'skill.uninstall', {
+            name: skillName,
+        }, { command: 'skills', operation: 'tools.skill.uninstall' });
+    });
+    // Subcommand: enable (alias for install — skill.enable was removed in T5615)
+    skillsCmd
+        .command('enable <skill-name>')
+        .description('Enable a skill (alias for install)')
+        .action(async (skillName) => {
+        await dispatchFromCli('mutate', 'tools', 'skill.install', {
+            name: skillName,
+        }, { command: 'skills', operation: 'tools.skill.install' });
+    });
+    // Subcommand: disable (alias for uninstall — skill.disable was removed in T5615)
+    skillsCmd
+        .command('disable <skill-name>')
+        .description('Disable a skill (alias for uninstall)')
+        .action(async (skillName) => {
+        await dispatchFromCli('mutate', 'tools', 'skill.uninstall', {
+            name: skillName,
+        }, { command: 'skills', operation: 'tools.skill.uninstall' });
+    });
+    // Subcommand: refresh
+    skillsCmd
+        .command('refresh')
+        .description('Refresh skills cache')
+        .action(async () => {
+        await dispatchFromCli('mutate', 'tools', 'skill.refresh', {}, {
+            command: 'skills',
+            operation: 'tools.skill.refresh',
+        });
+    });
+    // Subcommand: dispatch
+    skillsCmd
+        .command('dispatch <skill-name>')
+        .description('Resolve dispatch path for a skill')
+        .action(async (skillName) => {
+        await dispatchFromCli('query', 'tools', 'skill.dispatch', { name: skillName }, { command: 'skills', operation: 'tools.skill.dispatch' });
+    });
+    // Subcommand: catalog
+    skillsCmd
+        .command('catalog')
+        .description('Browse CAAMP skill catalog (protocols, profiles, resources, info)')
+        .option('--type <type>', 'Catalog type: protocols, profiles, resources, info (default: info)')
+        .option('--limit <n>', 'Maximum items to return')
+        .option('--offset <n>', 'Offset for pagination')
+        .action(async (opts) => {
+        await dispatchFromCli('query', 'tools', 'skill.catalog', {
+            type: opts['type'] ?? 'info',
+            limit: opts['limit'] ? Number(opts['limit']) : undefined,
+            offset: opts['offset'] ? Number(opts['offset']) : undefined,
+        }, { command: 'skills', operation: 'tools.skill.catalog' });
+    });
+    // Subcommand: precedence
+    skillsCmd
+        .command('precedence')
+        .description('Show or resolve skill provider precedence')
+        .option('--resolve <provider-id>', 'Resolve precedence for a specific provider')
+        .option('--scope <scope>', 'Scope: global or project (default: global)')
+        .action(async (opts) => {
+        const providerId = opts['resolve'];
+        await dispatchFromCli('query', 'tools', 'skill.precedence', {
+            action: providerId ? 'resolve' : 'show',
+            providerId,
+            scope: opts['scope'] ?? 'global',
+        }, { command: 'skills', operation: 'tools.skill.precedence' });
+    });
+    // Subcommand: dependencies
+    skillsCmd
+        .command('deps <skill-name>')
+        .description('Show skill dependency tree')
+        .action(async (skillName) => {
+        await dispatchFromCli('query', 'tools', 'skill.dependencies', { name: skillName }, { command: 'skills', operation: 'tools.skill.dependencies' });
+    });
+    // Subcommand: spawn-providers
+    skillsCmd
+        .command('spawn-providers')
+        .description('List providers capable of spawning subagents')
+        .option('--capability <cap>', 'Filter by capability: supportsSubagents, supportsProgrammaticSpawn, supportsInterAgentComms, supportsParallelSpawn')
+        .action(async (opts) => {
+        await dispatchFromCli('query', 'tools', 'skill.spawn.providers', { capability: opts['capability'] }, { command: 'skills', operation: 'tools.skill.spawn.providers' });
+    });
+    // Default action (no subcommand) - list
+    skillsCmd.action(async () => {
+        await dispatchFromCli('query', 'tools', 'skill.list', {
+            scope: 'project',
+        }, { command: 'skills', operation: 'tools.skill.list' });
+    });
+}
+//# 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":"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"}

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

@@ -0,0 +1,9 @@
+/**
+ * CLI snapshot command - Export/import task state for multi-contributor sharing.
+ * Thin dispatch wrapper routing to admin.snapshot.export and admin.snapshot.import.
+ *
+ * @task T4882, T5323, T5328
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+export declare function registerSnapshotCommand(program: Command): void;
+//# sourceMappingURL=snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEnE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4D9D"}

package/dist/cli/commands/snapshot.js

@@ -0,0 +1,50 @@
+/**
+ * CLI snapshot command - Export/import task state for multi-contributor sharing.
+ * Thin dispatch wrapper routing to admin.snapshot.export and admin.snapshot.import.
+ *
+ * @task T4882, T5323, T5328
+ */
+import { dispatchFromCli, dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+export function registerSnapshotCommand(program) {
+    const snapshot = program
+        .command('snapshot')
+        .description('Export/import task state snapshots for multi-contributor sharing');
+    snapshot
+        .command('export')
+        .description('Export current task state to a portable JSON snapshot')
+        .option('-o, --output <file>', 'Output file path (default: .cleo/snapshots/snapshot-<timestamp>.json)')
+        .option('--stdout', 'Write snapshot to stdout instead of file')
+        .action(async (opts) => {
+        if (opts['stdout']) {
+            // Write snapshot JSON to stdout for piping
+            const response = await dispatchRaw('query', 'admin', 'export', { scope: 'snapshot' });
+            handleRawError(response, { command: 'snapshot', operation: 'admin.export' });
+            const data = response.data;
+            // Re-read the snapshot from the output path to write to stdout
+            if (data?.outputPath) {
+                const { readFile } = await import('node:fs/promises');
+                const content = await readFile(data.outputPath, 'utf-8');
+                process.stdout.write(content);
+                if (!content.endsWith('\n'))
+                    process.stdout.write('\n');
+            }
+            return;
+        }
+        await dispatchFromCli('query', 'admin', 'export', {
+            scope: 'snapshot',
+            output: opts['output'],
+        }, { command: 'snapshot' });
+    });
+    snapshot
+        .command('import <file>')
+        .description('Import a task state snapshot into the local database')
+        .option('--dry-run', 'Preview import without making changes')
+        .action(async (file, opts) => {
+        await dispatchFromCli('mutate', 'admin', 'import', {
+            scope: 'snapshot',
+            file,
+            dryRun: opts['dryRun'],
+        }, { command: 'snapshot' });
+    });
+}
+//# sourceMappingURL=snapshot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../../src/cli/commands/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAG9F,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,MAAM,QAAQ,GAAG,OAAO;SACrB,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,kEAAkE,CAAC,CAAC;IAEnF,QAAQ;SACL,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,uDAAuD,CAAC;SACpE,MAAM,CACL,qBAAqB,EACrB,uEAAuE,CACxE;SACA,MAAM,CAAC,UAAU,EAAE,0CAA0C,CAAC;SAC9D,MAAM,CAAC,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC9C,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnB,2CAA2C;YAC3C,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;YACtF,cAAc,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;YAC7E,MAAM,IAAI,GAAG,QAAQ,CAAC,IAET,CAAC;YACd,+DAA+D;YAC/D,IAAI,IAAI,EAAE,UAAU,EAAE,CAAC;gBACrB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;gBACtD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC9B,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1D,CAAC;YACD,OAAO;QACT,CAAC;QAED,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,QAAQ,EACR;YACE,KAAK,EAAE,UAAU;YACjB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;SACvB,EACD,EAAE,OAAO,EAAE,UAAU,EAAE,CACxB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,QAAQ;SACL,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,sDAAsD,CAAC;SACnE,MAAM,CAAC,WAAW,EAAE,uCAAuC,CAAC;SAC5D,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,IAA6B,EAAE,EAAE;QAC5D,MAAM,eAAe,CACnB,QAAQ,EACR,OAAO,EACP,QAAQ,EACR;YACE,KAAK,EAAE,UAAU;YACjB,IAAI;YACJ,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;SACvB,EACD,EAAE,OAAO,EAAE,UAAU,EAAE,CACxB,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * CLI specification command - specification protocol validation.
+ * Routes through dispatch layer to check.protocol.specification.
+ * @task T4537
+ * @epic T4454
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/**
+ * Register the specification command group.
+ * @task T4537
+ */
+export declare function registerSpecificationCommand(program: Command): void;
+//# sourceMappingURL=specification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"specification.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/specification.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgDnE"}

package/dist/cli/commands/specification.js

@@ -0,0 +1,45 @@
+/**
+ * CLI specification command - specification protocol validation.
+ * Routes through dispatch layer to check.protocol.specification.
+ * @task T4537
+ * @epic T4454
+ */
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/**
+ * Register the specification command group.
+ * @task T4537
+ */
+export function registerSpecificationCommand(program) {
+    const specification = program
+        .command('specification')
+        .description('Validate specification protocol compliance (alias for `cleo check protocol specification`)');
+    specification
+        .command('validate <taskId>')
+        .description('Validate specification protocol compliance for task')
+        .option('--strict', 'Exit with error code on violations')
+        .option('--spec-file <file>', 'Path to specification file')
+        .action(async (taskId, opts) => {
+        await dispatchFromCli('query', 'check', 'protocol', {
+            protocolType: 'specification',
+            mode: 'task',
+            taskId,
+            strict: opts['strict'],
+            specFile: opts['specFile'],
+        }, { command: 'specification' });
+    });
+    specification
+        .command('check <manifestFile>')
+        .description('Validate manifest entry directly')
+        .option('--strict', 'Exit with error code on violations')
+        .option('--spec-file <file>', 'Path to specification file')
+        .action(async (manifestFile, opts) => {
+        await dispatchFromCli('query', 'check', 'protocol', {
+            protocolType: 'specification',
+            mode: 'manifest',
+            manifestFile,
+            strict: opts['strict'],
+            specFile: opts['specFile'],
+        }, { command: 'specification' });
+    });
+}
+//# sourceMappingURL=specification.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"specification.js","sourceRoot":"","sources":["../../../src/cli/commands/specification.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAgB;IAC3D,MAAM,aAAa,GAAG,OAAO;SAC1B,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CACV,4FAA4F,CAC7F,CAAC;IAEJ,aAAa;SACV,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,qDAAqD,CAAC;SAClE,MAAM,CAAC,UAAU,EAAE,oCAAoC,CAAC;SACxD,MAAM,CAAC,oBAAoB,EAAE,4BAA4B,CAAC;SAC1D,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAA6B,EAAE,EAAE;QAC9D,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,UAAU,EACV;YACE,YAAY,EAAE,eAAe;YAC7B,IAAI,EAAE,MAAM;YACZ,MAAM;YACN,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAwB;YAC7C,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAuB;SACjD,EACD,EAAE,OAAO,EAAE,eAAe,EAAE,CAC7B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,aAAa;SACV,OAAO,CAAC,sBAAsB,CAAC;SAC/B,WAAW,CAAC,kCAAkC,CAAC;SAC/C,MAAM,CAAC,UAAU,EAAE,oCAAoC,CAAC;SACxD,MAAM,CAAC,oBAAoB,EAAE,4BAA4B,CAAC;SAC1D,MAAM,CAAC,KAAK,EAAE,YAAoB,EAAE,IAA6B,EAAE,EAAE;QACpE,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,UAAU,EACV;YACE,YAAY,EAAE,eAAe;YAC7B,IAAI,EAAE,UAAU;YAChB,YAAY;YACZ,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAwB;YAC7C,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAuB;SACjD,EACD,EAAE,OAAO,EAAE,eAAe,EAAE,CAC7B,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}