@cleocode/cleo 2026.4.57 → 2026.4.59

package/dist/cli/commands/add.js

@@ -0,0 +1,238 @@
+/**
+ * CLI add command.
+ * @task T4460
+ * @epic T4454
+ */
+import { dispatchRaw, handleRawError } from '../../dispatch/adapters/cli.js';
+import { applyParamDefsToCommand, buildOperationHelp } from '../help-generator.js';
+import { cliOutput } from '../renderers/index.js';
+// ---------------------------------------------------------------------------
+// ParamDef array for tasks.add
+//
+// This mirrors the STATIC_PARAMS_TABLE entry in packages/lafs/src/operation-gates.ts
+// and will be upstreamed into registry.ts when the T4897 migration reaches
+// tasks.add.  Until then, this is the authoritative CLI-visible param list.
+// ---------------------------------------------------------------------------
+const ADD_PARAMS = [
+    {
+        name: 'title',
+        type: 'string',
+        required: true,
+        description: 'Task title (3–500 characters)',
+        cli: { positional: true },
+    },
+    {
+        name: 'status',
+        type: 'string',
+        required: false,
+        description: 'Task status',
+        enum: ['pending', 'active', 'blocked', 'done'],
+        cli: { short: '-s', flag: 'status' },
+    },
+    {
+        name: 'priority',
+        type: 'string',
+        required: false,
+        description: 'Task priority',
+        enum: ['low', 'medium', 'high', 'critical'],
+        cli: { short: '-p', flag: 'priority' },
+    },
+    {
+        name: 'type',
+        type: 'string',
+        required: false,
+        description: 'Task type',
+        enum: ['epic', 'task', 'subtask', 'bug'],
+        cli: { short: '-t', flag: 'type' },
+    },
+    {
+        name: 'parent',
+        type: 'string',
+        required: false,
+        description: 'Parent task ID (makes this task a subtask)',
+        cli: { flag: 'parent' },
+    },
+    {
+        name: 'size',
+        type: 'string',
+        required: false,
+        description: 'Scope size estimate',
+        enum: ['small', 'medium', 'large'],
+        cli: { flag: 'size' },
+    },
+    {
+        name: 'phase',
+        type: 'string',
+        required: false,
+        description: 'Phase slug to assign the task to',
+        cli: { short: '-P', flag: 'phase' },
+    },
+    {
+        name: 'description',
+        type: 'string',
+        required: false,
+        description: 'Detailed task description (must differ meaningfully from title)',
+        cli: { short: '-d', flag: 'description' },
+    },
+    {
+        name: 'labels',
+        type: 'array',
+        required: false,
+        description: 'Comma-separated labels',
+        cli: { short: '-l', flag: 'labels' },
+    },
+    {
+        name: 'files',
+        type: 'array',
+        required: false,
+        description: 'Comma-separated file paths',
+        cli: { flag: 'files' },
+    },
+    {
+        name: 'acceptance',
+        type: 'array',
+        required: false,
+        description: 'Pipe-separated acceptance criteria (e.g. "AC1|AC2|AC3")',
+        cli: { flag: 'acceptance' },
+    },
+    {
+        name: 'depends',
+        type: 'array',
+        required: false,
+        description: 'Comma-separated dependency task IDs',
+        cli: { short: '-D', flag: 'depends' },
+    },
+    {
+        name: 'notes',
+        type: 'string',
+        required: false,
+        description: 'Initial note entry for the task',
+        cli: { flag: 'notes' },
+    },
+    {
+        name: 'position',
+        type: 'number',
+        required: false,
+        description: 'Position within sibling group',
+        cli: { flag: 'position', parse: parseInt },
+    },
+    {
+        name: 'parentSearch',
+        type: 'string',
+        required: false,
+        description: 'Resolve parent by title substring instead of exact ID (T090)',
+        cli: { flag: 'parent-search' },
+    },
+];
+/**
+ * Register the add command.
+ * @task T4460
+ */
+export function registerAddCommand(program) {
+    const cmd = program
+        .command('add')
+        .description(buildOperationHelp('tasks.add', 'Create a new task (requires active session)', ADD_PARAMS));
+    // Auto-generate options and the <title> positional arg from the ParamDef
+    // registry.  This replaces the previous hand-written .option() chain and
+    // registers enum values, required indicators, and gate docs in --help.
+    applyParamDefsToCommand(cmd, ADD_PARAMS, 'tasks.add');
+    // Hand-written options with no ParamDef entry (CLI-only surface, not in the
+    // dispatch registry).  These come AFTER applyParamDefsToCommand so they
+    // appear at the bottom of --help output.
+    cmd
+        .option('--add-phase', 'Create new phase if it does not exist')
+        .option('--desc <desc>', 'Task description (alias for --description)')
+        .option('--dry-run', 'Show what would be created without making changes')
+        .action(async (title, opts) => {
+        const params = { title };
+        if (opts['status'] !== undefined)
+            params['status'] = opts['status'];
+        if (opts['priority'] !== undefined)
+            params['priority'] = opts['priority'];
+        if (opts['type'] !== undefined)
+            params['type'] = opts['type'];
+        if (opts['parent'] !== undefined)
+            params['parent'] = opts['parent'];
+        if (opts['size'] !== undefined)
+            params['size'] = opts['size'];
+        if (opts['phase'] !== undefined)
+            params['phase'] = opts['phase'];
+        if (opts['addPhase'] !== undefined)
+            params['addPhase'] = opts['addPhase'];
+        if (opts['description'] !== undefined) {
+            params['description'] = opts['description'];
+        }
+        else if (opts['desc'] !== undefined) {
+            params['description'] = opts['desc'];
+        }
+        if (opts['labels'])
+            params['labels'] = opts['labels'].split(',').map((s) => s.trim());
+        if (opts['files'])
+            params['files'] = opts['files'].split(',').map((s) => s.trim());
+        if (opts['acceptance']) {
+            const raw = opts['acceptance'];
+            // Support JSON array format: --acceptance '["c1","c2","c3"]' (T090)
+            if (raw.trimStart().startsWith('[')) {
+                try {
+                    const parsed = JSON.parse(raw);
+                    params['acceptance'] = Array.isArray(parsed)
+                        ? parsed.map((s) => String(s).trim()).filter(Boolean)
+                        : [raw];
+                }
+                catch {
+                    // Not valid JSON — fall through to pipe-delimited parsing
+                    params['acceptance'] = raw
+                        .split('|')
+                        .map((s) => s.trim())
+                        .filter(Boolean);
+                }
+            }
+            else {
+                params['acceptance'] = raw
+                    .split('|')
+                    .map((s) => s.trim())
+                    .filter(Boolean);
+            }
+        }
+        if (opts['depends'])
+            params['depends'] = opts['depends'].split(',').map((s) => s.trim());
+        if (opts['notes'] !== undefined)
+            params['notes'] = opts['notes'];
+        if (opts['position'] !== undefined)
+            params['position'] = opts['position'];
+        if (opts['dryRun'] !== undefined)
+            params['dryRun'] = opts['dryRun'];
+        if (opts['parentSearch'] !== undefined)
+            params['parentSearch'] = opts['parentSearch'];
+        const response = await dispatchRaw('mutate', 'tasks', 'add', params);
+        if (!response.success) {
+            handleRawError(response, { command: 'add', operation: 'tasks.add' });
+        }
+        const data = response.data;
+        // Display advisory warnings (T089: orphan prevention, etc.)
+        const dataWarnings = data?.warnings;
+        if (dataWarnings?.length) {
+            for (const w of dataWarnings) {
+                process.stderr.write(`⚠ ${w}\n`);
+            }
+        }
+        if (data?.duplicate) {
+            cliOutput(data, {
+                command: 'add',
+                message: 'Task with identical title was created recently',
+                operation: 'tasks.add',
+            });
+        }
+        else if (data?.dryRun) {
+            cliOutput(data, {
+                command: 'add',
+                message: 'Dry run - no changes made',
+                operation: 'tasks.add',
+            });
+        }
+        else {
+            cliOutput(data, { command: 'add', operation: 'tasks.add' });
+        }
+    });
+}
+//# sourceMappingURL=add.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * CLI admin command group — dispatches to the admin domain.
+ *
+ * Provides CLI access to admin.version, admin.health, admin.stats,
+ * admin.runtime, admin.smoke, admin.paths, admin.scaffold-hub,
+ * admin.cleanup, admin.job, admin.job.cancel, admin.install.global,
+ * and admin.context.inject via `cleo admin <subcommand>`.
+ *
+ * @task T132
+ * @task T480 — add cleanup, job, job.cancel, install.global, context.inject subcommands.
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+/** Register the admin command group. */
+export declare function registerAdminCommand(program: Command): void;
+//# sourceMappingURL=admin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/admin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEnE,wCAAwC;AACxC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+M3D"}

package/dist/cli/commands/admin.js

@@ -0,0 +1,143 @@
+/**
+ * CLI admin command group — dispatches to the admin domain.
+ *
+ * Provides CLI access to admin.version, admin.health, admin.stats,
+ * admin.runtime, admin.smoke, admin.paths, admin.scaffold-hub,
+ * admin.cleanup, admin.job, admin.job.cancel, admin.install.global,
+ * and admin.context.inject via `cleo admin <subcommand>`.
+ *
+ * @task T132
+ * @task T480 — add cleanup, job, job.cancel, install.global, context.inject subcommands.
+ */
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/** Register the admin command group. */
+export function registerAdminCommand(program) {
+    const admin = program.command('admin').description('System administration and diagnostics');
+    admin
+        .command('version')
+        .description('Show CLEO version')
+        .action(async () => {
+        await dispatchFromCli('query', 'admin', 'version', {}, { command: 'admin' });
+    });
+    admin
+        .command('health')
+        .description('Run system health check')
+        .option('--detailed', 'Show detailed results')
+        .action(async (opts) => {
+        await dispatchFromCli('query', 'admin', 'health', { detailed: opts['detailed'] }, { command: 'admin' });
+    });
+    admin
+        .command('stats')
+        .description('Show project statistics')
+        .option('--period <days>', 'Time period in days')
+        .action(async (opts) => {
+        await dispatchFromCli('query', 'admin', 'stats', { period: opts['period'] ? Number(opts['period']) : undefined }, { command: 'admin' });
+    });
+    admin
+        .command('runtime')
+        .description('Show runtime diagnostics')
+        .option('--detailed', 'Show detailed runtime info')
+        .action(async (opts) => {
+        await dispatchFromCli('query', 'admin', 'runtime', { detailed: opts['detailed'] }, { command: 'admin' });
+    });
+    admin
+        .command('smoke')
+        .description('Run operational smoke tests across all domains')
+        .action(async () => {
+        await dispatchFromCli('query', 'admin', 'smoke', {}, { command: 'admin' });
+    });
+    admin
+        .command('paths')
+        .description('Report all CleoOS paths (project + global hub) and scaffolding status')
+        .action(async () => {
+        await dispatchFromCli('query', 'admin', 'paths', {}, { command: 'admin' });
+    });
+    admin
+        .command('scaffold-hub')
+        .description('Create CleoOS Hub dirs (global-recipes, pi-extensions, cant-workflows, agents) and seed starter justfile')
+        .action(async () => {
+        await dispatchFromCli('mutate', 'admin', 'scaffold-hub', {}, { command: 'admin' });
+    });
+    // ---------------------------------------------------------------------------
+    // cleanup — wraps mutate admin cleanup (T480)
+    // ---------------------------------------------------------------------------
+    admin
+        .command('cleanup')
+        .description('Purge stale CLEO data (backups, logs, archive entries)')
+        .requiredOption('--target <target>', 'What to clean: backups | logs | archive | sessions')
+        .option('--older-than <age>', 'Remove entries older than this duration (e.g. 30d, 6m, 1y)')
+        .option('--dry-run', 'Preview what would be removed without making changes')
+        .action(async (opts) => {
+        await dispatchFromCli('mutate', 'admin', 'cleanup', {
+            target: opts['target'],
+            olderThan: opts['olderThan'],
+            dryRun: opts['dryRun'] === true,
+        }, { command: 'admin cleanup', operation: 'admin.cleanup' });
+    });
+    // ---------------------------------------------------------------------------
+    // job — wraps query admin job (list / status) (T480)
+    // ---------------------------------------------------------------------------
+    const job = admin
+        .command('job')
+        .description('Inspect background jobs managed by the job manager');
+    job
+        .command('list', { isDefault: true })
+        .description('List all background jobs (default)')
+        .option('--status <status>', 'Filter by job status (pending, running, done, failed, cancelled)')
+        .option('--limit <n>', 'Maximum jobs to return', '20')
+        .option('--offset <n>', 'Skip N jobs', '0')
+        .action(async (opts) => {
+        await dispatchFromCli('query', 'admin', 'job', {
+            action: 'list',
+            status: opts['status'],
+            limit: opts['limit'] ? Number(opts['limit']) : 20,
+            offset: opts['offset'] ? Number(opts['offset']) : 0,
+        }, { command: 'admin job list', operation: 'admin.job' });
+    });
+    job
+        .command('status <jobId>')
+        .description('Show status of a specific background job')
+        .action(async (jobId) => {
+        await dispatchFromCli('query', 'admin', 'job', { action: 'status', jobId }, { command: 'admin job status', operation: 'admin.job' });
+    });
+    // ---------------------------------------------------------------------------
+    // job cancel — wraps mutate admin job.cancel (T480)
+    // ---------------------------------------------------------------------------
+    job
+        .command('cancel <jobId>')
+        .description('Cancel a running background job')
+        .action(async (jobId) => {
+        await dispatchFromCli('mutate', 'admin', 'job.cancel', { jobId }, { command: 'admin job cancel', operation: 'admin.job.cancel' });
+    });
+    // ---------------------------------------------------------------------------
+    // install-global — wraps mutate admin install.global (T480)
+    // ---------------------------------------------------------------------------
+    admin
+        .command('install-global')
+        .description('Refresh global CLEO setup (provider files, configs, ~/.agents/AGENTS.md)')
+        .action(async () => {
+        await dispatchFromCli('mutate', 'admin', 'install.global', {}, { command: 'admin install-global', operation: 'admin.install.global' });
+    });
+    // ---------------------------------------------------------------------------
+    // context-inject — wraps mutate admin context.inject (T480)
+    // Agent-facing but exposed via CLI for testing and manual use.
+    // ---------------------------------------------------------------------------
+    admin
+        .command('context-inject <protocolType>')
+        .description('Inject protocol content into session context (e.g. cleo-base, ct-orchestrator, ct-cleo)')
+        .option('--task <id>', 'Scope injection to a specific task ID')
+        .option('--variant <variant>', 'Select a named protocol variant')
+        .action(async (protocolType, opts) => {
+        if (!protocolType || typeof protocolType !== 'string' || protocolType.trim() === '') {
+            console.error('Error: missing required argument <protocolType>');
+            console.error('Usage: cleo admin context-inject <protocolType> [--task <id>] [--variant <variant>]');
+            process.exit(1);
+        }
+        await dispatchFromCli('mutate', 'admin', 'context.inject', {
+            protocolType,
+            taskId: opts['task'],
+            variant: opts['variant'],
+        }, { command: 'admin context-inject', operation: 'admin.context.inject' });
+    });
+}
+//# sourceMappingURL=admin.js.map

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

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

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

@@ -0,0 +1,27 @@
+/**
+ * CLI adr command group — ADR validation, listing, sync, and search.
+ *
+ * Thin CLI wrapper delegating to dispatch layer (admin domain).
+ * Core logic lives in src/core/adrs/.
+ *
+ * Commands:
+ *   ct adr validate              — validate frontmatter on all .cleo/adrs/*.md
+ *   ct adr list [--status]       — list ADRs with optional status filter
+ *   ct adr show <id>             — show single ADR by ID (e.g., ADR-017)
+ *   ct adr sync                  — sync .cleo/adrs/ into architecture_decisions DB
+ *   ct adr find <query>          — fuzzy search ADRs by title, summary, keywords, topics
+ *
+ * Dispatch equivalents:
+ *   mutate({domain:'admin', operation:'adr.validate'})
+ *   query({domain:'admin',  operation:'adr.list',  params:{status?}})
+ *   query({domain:'admin',  operation:'adr.show',  params:{adrId}})
+ *   mutate({domain:'admin', operation:'adr.sync'})
+ *   query({domain:'admin',  operation:'adr.find',  params:{query, topics?, keywords?, status?}})
+ *
+ * @see ADR-017 §5.1 for canonical frontmatter spec
+ * @see ADR-017 §5.4 for cognitive search spec
+ * @see schemas/adr-frontmatter.schema.json for validation schema
+ */
+import type { ShimCommand as Command } from '../commander-shim.js';
+export declare function registerAdrCommand(program: Command): void;
+//# sourceMappingURL=adr.d.ts.map

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

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

package/dist/cli/commands/adr.js

@@ -0,0 +1,79 @@
+/**
+ * CLI adr command group — ADR validation, listing, sync, and search.
+ *
+ * Thin CLI wrapper delegating to dispatch layer (admin domain).
+ * Core logic lives in src/core/adrs/.
+ *
+ * Commands:
+ *   ct adr validate              — validate frontmatter on all .cleo/adrs/*.md
+ *   ct adr list [--status]       — list ADRs with optional status filter
+ *   ct adr show <id>             — show single ADR by ID (e.g., ADR-017)
+ *   ct adr sync                  — sync .cleo/adrs/ into architecture_decisions DB
+ *   ct adr find <query>          — fuzzy search ADRs by title, summary, keywords, topics
+ *
+ * Dispatch equivalents:
+ *   mutate({domain:'admin', operation:'adr.validate'})
+ *   query({domain:'admin',  operation:'adr.list',  params:{status?}})
+ *   query({domain:'admin',  operation:'adr.show',  params:{adrId}})
+ *   mutate({domain:'admin', operation:'adr.sync'})
+ *   query({domain:'admin',  operation:'adr.find',  params:{query, topics?, keywords?, status?}})
+ *
+ * @see ADR-017 §5.1 for canonical frontmatter spec
+ * @see ADR-017 §5.4 for cognitive search spec
+ * @see schemas/adr-frontmatter.schema.json for validation schema
+ */
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+export function registerAdrCommand(program) {
+    const adr = program
+        .command('adr')
+        .description('Manage and validate Architecture Decision Records in .cleo/adrs/');
+    // ct adr validate
+    adr
+        .command('validate')
+        .description('Validate frontmatter on all .cleo/adrs/*.md files against ADR-017 schema')
+        .action(async () => {
+        await dispatchFromCli('mutate', 'admin', 'adr.sync', { validate: true }, { command: 'adr validate', operation: 'admin.adr.sync' });
+    });
+    // ct adr list
+    adr
+        .command('list')
+        .description('List ADRs from .cleo/adrs/')
+        .option('--status <status>', 'Filter by status: proposed | accepted | superseded | deprecated')
+        .option('--since <date>', 'Filter to ADRs created on or after YYYY-MM-DD')
+        .action(async (opts) => {
+        await dispatchFromCli('query', 'admin', 'adr.find', {
+            status: opts['status'],
+            since: opts['since'],
+        }, { command: 'adr list', operation: 'admin.adr.find' });
+    });
+    // ct adr show <id>
+    adr
+        .command('show <adrId>')
+        .description('Show full details for a single ADR (e.g., ct adr show ADR-017)')
+        .action(async (adrId) => {
+        await dispatchFromCli('query', 'admin', 'adr.show', { adrId }, { command: 'adr show', operation: 'admin.adr.show' });
+    });
+    // ct adr sync
+    adr
+        .command('sync')
+        .description('Sync .cleo/adrs/ markdown files into the architecture_decisions DB table')
+        .action(async () => {
+        await dispatchFromCli('mutate', 'admin', 'adr.sync', {}, { command: 'adr sync', operation: 'admin.adr.sync' });
+    });
+    // ct adr find <query>
+    adr
+        .command('find <query>')
+        .description('Fuzzy search ADRs by title, summary, keywords, and topics')
+        .option('--topics <topics>', 'Filter by topics (comma-separated domain tags)')
+        .option('--keywords <keywords>', 'Filter by keywords (comma-separated tags)')
+        .option('--status <status>', 'Filter by status: proposed | accepted | superseded | deprecated')
+        .action(async (query, opts) => {
+        await dispatchFromCli('query', 'admin', 'adr.find', {
+            query,
+            topics: opts['topics'],
+            keywords: opts['keywords'],
+            status: opts['status'],
+        }, { command: 'adr find', operation: 'admin.adr.find' });
+    });
+}
+//# sourceMappingURL=adr.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adr.js","sourceRoot":"","sources":["../../../src/cli/commands/adr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,MAAM,GAAG,GAAG,OAAO;SAChB,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,kEAAkE,CAAC,CAAC;IAEnF,kBAAkB;IAClB,GAAG;SACA,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,0EAA0E,CAAC;SACvF,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,eAAe,CACnB,QAAQ,EACR,OAAO,EACP,UAAU,EACV,EAAE,QAAQ,EAAE,IAAI,EAAE,EAClB,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,gBAAgB,EAAE,CACzD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,cAAc;IACd,GAAG;SACA,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,mBAAmB,EAAE,iEAAiE,CAAC;SAC9F,MAAM,CAAC,gBAAgB,EAAE,+CAA+C,CAAC;SACzE,MAAM,CAAC,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC9C,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,UAAU,EACV;YACE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAuB;YAC5C,KAAK,EAAE,IAAI,CAAC,OAAO,CAAuB;SAC3C,EACD,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,CACrD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,mBAAmB;IACnB,GAAG;SACA,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,gEAAgE,CAAC;SAC7E,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,EAAE;QAC9B,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,UAAU,EACV,EAAE,KAAK,EAAE,EACT,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,CACrD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,cAAc;IACd,GAAG;SACA,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,0EAA0E,CAAC;SACvF,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,eAAe,CACnB,QAAQ,EACR,OAAO,EACP,UAAU,EACV,EAAE,EACF,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,CACrD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,sBAAsB;IACtB,GAAG;SACA,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,2DAA2D,CAAC;SACxE,MAAM,CAAC,mBAAmB,EAAE,gDAAgD,CAAC;SAC7E,MAAM,CAAC,uBAAuB,EAAE,2CAA2C,CAAC;SAC5E,MAAM,CAAC,mBAAmB,EAAE,iEAAiE,CAAC;SAC9F,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,IAA6B,EAAE,EAAE;QAC7D,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,UAAU,EACV;YACE,KAAK;YACL,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAuB;YAC5C,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAuB;YAChD,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAuB;SAC7C,EACD,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,CACrD,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/agent-profile-status.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Pure helper for computing the human-readable `profile` status string
+ * surfaced by `cleo agent start`.
+ *
+ * Extracted from `agent.ts` so it can be unit-tested without spinning up
+ * the full daemon, the SignalDock registry, or the Pi runtime. The
+ * helper has zero side effects and accepts only plain inputs — that is
+ * the entire point of pulling it out.
+ *
+ * **Daemon vs. Pi session.** The status this helper produces describes
+ * what `cleo agent start` did with the on-disk `.cant` profile file. It
+ * is purely informational. The daemon NEVER interprets the profile —
+ * profile-driven workflow execution lives inside the Pi extension at
+ * `packages/cleo/templates/cleoos-hub/pi-extensions/cant-bridge.ts`,
+ * not inside the daemon process. See ADR-035 §D5 (Option Y addendum)
+ * for the rationale.
+ *
+ * @see ../commands/agent.ts
+ * @see .cleo/adrs/ADR-035-pi-v2-v3-harness.md §D5 + Addendum
+ *
+ * @packageDocumentation
+ */
+/**
+ * Outcome of validating a `.cant` profile via `@cleocode/cant`'s
+ * `validate()` function (when available in the current build).
+ *
+ * @public
+ */
+export interface ProfileValidation {
+    /** `true` when the parser produced zero diagnostics. */
+    readonly valid: boolean;
+    /** Diagnostic messages surfaced by the parser, in order. */
+    readonly errors: readonly string[];
+}
+/**
+ * Possible status values surfaced by `cleo agent start` for the
+ * profile-loading step.
+ *
+ * - `'none'` — no `.cant` file at the resolved path; the daemon starts
+ *   without a profile loaded.
+ * - `'loaded (unvalidated)'` — file existed and was read into memory,
+ *   but the optional `@cleocode/cant` validator was not available in
+ *   this build, so we cannot say whether it parses cleanly.
+ * - `'validated'` — file existed, the validator ran, and the parser
+ *   produced zero diagnostics.
+ * - `` `invalid (${N} errors)` `` — file existed, the validator ran,
+ *   and the parser surfaced N diagnostics. The N is the diagnostic
+ *   count, not a severity score.
+ *
+ * The status is purely informational. None of these branches change
+ * the daemon's behaviour — the daemon polls SignalDock either way.
+ * Profile-driven behaviour runs inside Pi sessions via the
+ * `cant-bridge.ts` Pi extension.
+ *
+ * @public
+ */
+export type ProfileStatus = 'none' | 'loaded (unvalidated)' | 'validated' | `invalid (${number} errors)`;
+/**
+ * Compute the human-readable profile status string for the
+ * `cleo agent start` command output.
+ *
+ * @remarks
+ * This is a pure function with three branches:
+ *
+ * 1. `profile === null` → `'none'` — no file existed at the resolved path.
+ * 2. `validation === null` → `'loaded (unvalidated)'` — file was read
+ *    but the optional validator was not available.
+ * 3. `validation.valid === true` → `'validated'`
+ * 4. `validation.valid === false` → `` `invalid (${N} errors)` ``
+ *    where N is `validation.errors.length`.
+ *
+ * The function NEVER consults `createRuntime`, the registry, or any
+ * other side-effecting subsystem. It exists exactly so the
+ * profile-status branch can be exercised in unit tests without booting
+ * the daemon.
+ *
+ * @param profile - The contents of the `.cant` file, or `null` when no
+ *   file was present at the resolved path.
+ * @param validation - The result of running `@cleocode/cant`'s
+ *   `validate()` against `profile`, or `null` when the validator was
+ *   not available in the current build.
+ * @returns A status string suitable for the `profile` field of the
+ *   `cleo agent start` LAFS envelope.
+ *
+ * @example
+ * ```typescript
+ * computeProfileStatus(null, null);                        // 'none'
+ * computeProfileStatus('agent foo:', null);                // 'loaded (unvalidated)'
+ * computeProfileStatus('agent foo:', { valid: true, errors: [] });
+ * // 'validated'
+ * computeProfileStatus('agent foo:', { valid: false, errors: ['e1', 'e2'] });
+ * // 'invalid (2 errors)'
+ * ```
+ *
+ * @public
+ */
+export declare function computeProfileStatus(profile: string | null, validation: ProfileValidation | null): ProfileStatus;
+//# sourceMappingURL=agent-profile-status.d.ts.map

package/dist/cli/commands/agent-profile-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-profile-status.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/agent-profile-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,sBAAsB,GACtB,WAAW,GACX,YAAY,MAAM,UAAU,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,UAAU,EAAE,iBAAiB,GAAG,IAAI,GACnC,aAAa,CAKf"}