@cleocode/cleo 2026.4.161 → 2026.5.0

package/dist/cli/commands/admin.js

@@ -0,0 +1,283 @@
+/**
+ * CLI command group for system administration and diagnostics.
+ *
+ * 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>`.
+ *
+ * The `job` subgroup uses an explicit parent `run()` that delegates to
+ * `job list` when no subcommand is given (citty has no `isDefault` concept).
+ *
+ * @task T132
+ * @task T480 — add cleanup, job, job.cancel, install.global, context.inject subcommands.
+ */
+import { defineCommand, showUsage } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/** cleo admin version — show CLEO version */
+const versionCommand = defineCommand({
+    meta: { name: 'version', description: 'Show CLEO version' },
+    async run() {
+        await dispatchFromCli('query', 'admin', 'version', {}, { command: 'admin' });
+    },
+});
+/** cleo admin health — run system health check */
+const healthCommand = defineCommand({
+    meta: { name: 'health', description: 'Run system health check' },
+    args: {
+        detailed: {
+            type: 'boolean',
+            description: 'Show detailed results',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'admin', 'health', { detailed: args.detailed }, { command: 'admin' });
+    },
+});
+/** cleo admin stats — show project statistics */
+const statsCommand = defineCommand({
+    meta: { name: 'stats', description: 'Show project statistics' },
+    args: {
+        period: {
+            type: 'string',
+            description: 'Time period in days',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'admin', 'stats', { period: args.period ? Number(args.period) : undefined }, { command: 'admin' });
+    },
+});
+/** cleo admin runtime — show runtime diagnostics */
+const runtimeCommand = defineCommand({
+    meta: { name: 'runtime', description: 'Show runtime diagnostics' },
+    args: {
+        detailed: {
+            type: 'boolean',
+            description: 'Show detailed runtime info',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'admin', 'runtime', { detailed: args.detailed }, { command: 'admin' });
+    },
+});
+/** cleo admin smoke — run operational smoke tests or probe ADR-049 invariants */
+const smokeCommand = defineCommand({
+    meta: {
+        name: 'smoke',
+        description: 'Run operational smoke tests across all domains, or probe ADR-049 invariants for a named provider (--provider)',
+    },
+    args: {
+        provider: {
+            type: 'string',
+            description: 'Probe harness sovereignty invariants for a specific provider adapter (ADR-049)',
+        },
+    },
+    async run({ args }) {
+        const provider = args.provider;
+        if (provider) {
+            await dispatchFromCli('query', 'admin', 'smoke.provider', { provider }, { command: 'admin smoke', operation: 'admin.smoke.provider' });
+        }
+        else {
+            await dispatchFromCli('query', 'admin', 'smoke', {}, { command: 'admin' });
+        }
+    },
+});
+/** cleo admin paths — report all CleoOS paths and scaffolding status */
+const pathsCommand = defineCommand({
+    meta: {
+        name: 'paths',
+        description: 'Report all CleoOS paths (project + global hub) and scaffolding status',
+    },
+    async run() {
+        await dispatchFromCli('query', 'admin', 'paths', {}, { command: 'admin' });
+    },
+});
+/** cleo admin scaffold-hub — create CleoOS Hub dirs and seed starter justfile */
+const scaffoldHubCommand = defineCommand({
+    meta: {
+        name: 'scaffold-hub',
+        description: 'Create CleoOS Hub dirs (global-recipes, pi-extensions, cant-workflows, agents) and seed starter justfile',
+    },
+    async run() {
+        await dispatchFromCli('mutate', 'admin', 'scaffold-hub', {}, { command: 'admin' });
+    },
+});
+/** cleo admin cleanup — purge stale CLEO data */
+const cleanupCommand = defineCommand({
+    meta: { name: 'cleanup', description: 'Purge stale CLEO data (backups, logs, archive entries)' },
+    args: {
+        target: {
+            type: 'string',
+            description: 'What to clean: backups | logs | archive | sessions',
+            required: true,
+        },
+        'older-than': {
+            type: 'string',
+            description: 'Remove entries older than this duration (e.g. 30d, 6m, 1y)',
+        },
+        'dry-run': {
+            type: 'boolean',
+            description: 'Preview what would be removed without making changes',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'admin', 'cleanup', {
+            target: args.target,
+            olderThan: args['older-than'],
+            dryRun: args['dry-run'] === true,
+        }, { command: 'admin cleanup', operation: 'admin.cleanup' });
+    },
+});
+/** cleo admin job list — list all background jobs */
+const jobListCommand = defineCommand({
+    meta: { name: 'list', description: 'List all background jobs (default)' },
+    args: {
+        status: {
+            type: 'string',
+            description: 'Filter by job status (pending, running, done, failed, cancelled)',
+        },
+        limit: {
+            type: 'string',
+            description: 'Maximum jobs to return',
+            default: '20',
+        },
+        offset: {
+            type: 'string',
+            description: 'Skip N jobs',
+            default: '0',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'admin', 'job', {
+            action: 'list',
+            status: args.status,
+            limit: args.limit ? Number(args.limit) : 20,
+            offset: args.offset ? Number(args.offset) : 0,
+        }, { command: 'admin job list', operation: 'admin.job' });
+    },
+});
+/** cleo admin job status — show status of a specific background job */
+const jobStatusCommand = defineCommand({
+    meta: { name: 'status', description: 'Show status of a specific background job' },
+    args: {
+        jobId: {
+            type: 'positional',
+            description: 'Job ID to inspect',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'admin', 'job', { action: 'status', jobId: args.jobId }, { command: 'admin job status', operation: 'admin.job' });
+    },
+});
+/** cleo admin job cancel — cancel a running background job */
+const jobCancelCommand = defineCommand({
+    meta: { name: 'cancel', description: 'Cancel a running background job' },
+    args: {
+        jobId: {
+            type: 'positional',
+            description: 'Job ID to cancel',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'admin', 'job.cancel', { jobId: args.jobId }, { command: 'admin job cancel', operation: 'admin.job.cancel' });
+    },
+});
+/**
+ * cleo admin job — inspect background jobs.
+ *
+ * Defaults to `job list` when no subcommand is provided (citty has no
+ * `isDefault` concept; the parent `run()` replicates that behaviour).
+ */
+const jobCommand = defineCommand({
+    meta: { name: 'job', description: 'Inspect background jobs managed by the job manager' },
+    subCommands: {
+        list: jobListCommand,
+        status: jobStatusCommand,
+        cancel: jobCancelCommand,
+    },
+    async run({ rawArgs }) {
+        // No subcommand given — delegate to job list (mirrors isDefault behaviour)
+        const hasSubCmd = rawArgs.some((a) => ['list', 'status', 'cancel'].includes(a));
+        if (!hasSubCmd) {
+            await dispatchFromCli('query', 'admin', 'job', { action: 'list', limit: 20, offset: 0 }, { command: 'admin job list', operation: 'admin.job' });
+        }
+    },
+});
+/** cleo admin install-global — refresh global CLEO setup */
+const installGlobalCommand = defineCommand({
+    meta: {
+        name: 'install-global',
+        description: 'Refresh global CLEO setup (provider files, configs, ~/.agents/AGENTS.md)',
+    },
+    async run() {
+        await dispatchFromCli('mutate', 'admin', 'install.global', {}, { command: 'admin install-global', operation: 'admin.install.global' });
+    },
+});
+/** cleo admin context-inject — inject protocol content into session context */
+const contextInjectCommand = defineCommand({
+    meta: {
+        name: 'context-inject',
+        description: 'Inject protocol content into session context (e.g. cleo-base, ct-orchestrator, ct-cleo)',
+    },
+    args: {
+        protocolType: {
+            type: 'positional',
+            description: 'Protocol type to inject',
+            required: true,
+        },
+        task: {
+            type: 'string',
+            description: 'Scope injection to a specific task ID',
+        },
+        variant: {
+            type: 'string',
+            description: 'Select a named protocol variant',
+        },
+    },
+    async run({ args }) {
+        const protocolType = args.protocolType;
+        if (!protocolType || 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: args.task,
+            variant: args.variant,
+        }, { command: 'admin context-inject', operation: 'admin.context.inject' });
+    },
+});
+/**
+ * Root admin command group — registers all admin subcommands.
+ *
+ * Dispatches to the `admin` domain registry operations.
+ *
+ * @task T132
+ * @task T480
+ */
+export const adminCommand = defineCommand({
+    meta: { name: 'admin', description: 'System administration and diagnostics' },
+    subCommands: {
+        version: versionCommand,
+        health: healthCommand,
+        stats: statsCommand,
+        runtime: runtimeCommand,
+        smoke: smokeCommand,
+        paths: pathsCommand,
+        'scaffold-hub': scaffoldHubCommand,
+        cleanup: cleanupCommand,
+        job: jobCommand,
+        'install-global': installGlobalCommand,
+        'context-inject': contextInjectCommand,
+    },
+    async run({ cmd, rawArgs }) {
+        const firstArg = rawArgs?.find((a) => !a.startsWith('-'));
+        if (firstArg && cmd.subCommands && firstArg in cmd.subCommands)
+            return;
+        await showUsage(cmd);
+    },
+});
+//# 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,33 @@
+/**
+ * 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:
+ *   cleo adr validate              — validate frontmatter on all .cleo/adrs/*.md
+ *   cleo adr list [--status]       — list ADRs with optional status filter
+ *   cleo adr show <id>             — show single ADR by ID (e.g., ADR-017)
+ *   cleo adr sync                  — sync .cleo/adrs/ into architecture_decisions DB
+ *   cleo 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
+ */
+/**
+ * Root adr command group — ADR validation, listing, sync, and search.
+ *
+ * Dispatches to `admin.adr.*` registry operations.
+ *
+ * @see ADR-017 §5.1 for canonical frontmatter spec
+ */
+export declare const adrCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# 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;AAsIH;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,qDAiBrB,CAAC"}

package/dist/cli/commands/adr.js

@@ -0,0 +1,147 @@
+/**
+ * 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:
+ *   cleo adr validate              — validate frontmatter on all .cleo/adrs/*.md
+ *   cleo adr list [--status]       — list ADRs with optional status filter
+ *   cleo adr show <id>             — show single ADR by ID (e.g., ADR-017)
+ *   cleo adr sync                  — sync .cleo/adrs/ into architecture_decisions DB
+ *   cleo 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 { defineCommand, showUsage } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/** cleo adr validate — validate frontmatter on all .cleo/adrs/*.md files */
+const validateCommand = defineCommand({
+    meta: {
+        name: 'validate',
+        description: 'Validate frontmatter on all .cleo/adrs/*.md files against ADR-017 schema',
+    },
+    async run() {
+        await dispatchFromCli('mutate', 'admin', 'adr.sync', { validate: true }, { command: 'adr validate', operation: 'admin.adr.sync' });
+    },
+});
+/** cleo adr list — list ADRs from .cleo/adrs/ with optional filtering */
+const listCommand = defineCommand({
+    meta: {
+        name: 'list',
+        description: 'List ADRs from .cleo/adrs/',
+    },
+    args: {
+        status: {
+            type: 'string',
+            description: 'Filter by status: proposed | accepted | superseded | deprecated',
+        },
+        since: {
+            type: 'string',
+            description: 'Filter to ADRs created on or after YYYY-MM-DD',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'admin', 'adr.find', {
+            status: args.status,
+            since: args.since,
+        }, { command: 'adr list', operation: 'admin.adr.find' });
+    },
+});
+/** cleo adr show <adrId> — show full details for a single ADR */
+const showCommand = defineCommand({
+    meta: {
+        name: 'show',
+        description: 'Show full details for a single ADR (e.g., cleo adr show ADR-017)',
+    },
+    args: {
+        adrId: {
+            type: 'positional',
+            description: 'ADR identifier (e.g., ADR-017)',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'admin', 'adr.show', { adrId: args.adrId }, { command: 'adr show', operation: 'admin.adr.show' });
+    },
+});
+/** cleo adr sync — sync .cleo/adrs/ markdown files into the DB */
+const syncCommand = defineCommand({
+    meta: {
+        name: 'sync',
+        description: 'Sync .cleo/adrs/ markdown files into the architecture_decisions DB table',
+    },
+    async run() {
+        await dispatchFromCli('mutate', 'admin', 'adr.sync', {}, { command: 'adr sync', operation: 'admin.adr.sync' });
+    },
+});
+/** cleo adr find <query> — fuzzy search ADRs by title, summary, keywords, and topics */
+const findCommand = defineCommand({
+    meta: {
+        name: 'find',
+        description: 'Fuzzy search ADRs by title, summary, keywords, and topics',
+    },
+    args: {
+        query: {
+            type: 'positional',
+            description: 'Search query string',
+            required: true,
+        },
+        topics: {
+            type: 'string',
+            description: 'Filter by topics (comma-separated domain tags)',
+        },
+        keywords: {
+            type: 'string',
+            description: 'Filter by keywords (comma-separated tags)',
+        },
+        status: {
+            type: 'string',
+            description: 'Filter by status: proposed | accepted | superseded | deprecated',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'admin', 'adr.find', {
+            query: args.query,
+            topics: args.topics,
+            keywords: args.keywords,
+            status: args.status,
+        }, { command: 'adr find', operation: 'admin.adr.find' });
+    },
+});
+/**
+ * Root adr command group — ADR validation, listing, sync, and search.
+ *
+ * Dispatches to `admin.adr.*` registry operations.
+ *
+ * @see ADR-017 §5.1 for canonical frontmatter spec
+ */
+export const adrCommand = defineCommand({
+    meta: {
+        name: 'adr',
+        description: 'Manage and validate Architecture Decision Records in .cleo/adrs/',
+    },
+    subCommands: {
+        validate: validateCommand,
+        list: listCommand,
+        show: showCommand,
+        sync: syncCommand,
+        find: findCommand,
+    },
+    async run({ cmd, rawArgs }) {
+        const firstArg = rawArgs?.find((a) => !a.startsWith('-'));
+        if (firstArg && cmd.subCommands && firstArg in cmd.subCommands)
+            return;
+        await showUsage(cmd);
+    },
+});
+//# 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":"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"}

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"}

package/dist/cli/commands/agent-profile-status.js

@@ -0,0 +1,71 @@
+/**
+ * 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
+ */
+/**
+ * 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 function computeProfileStatus(profile, validation) {
+    if (profile === null)
+        return 'none';
+    if (validation === null)
+        return 'loaded (unvalidated)';
+    if (validation.valid)
+        return 'validated';
+    return `invalid (${validation.errors.length} errors)`;
+}
+//# sourceMappingURL=agent-profile-status.js.map

package/dist/cli/commands/agent-profile-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-profile-status.js","sourceRoot":"","sources":["../../../src/cli/commands/agent-profile-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA2CH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAsB,EACtB,UAAoC;IAEpC,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACpC,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,sBAAsB,CAAC;IACvD,IAAI,UAAU,CAAC,KAAK;QAAE,OAAO,WAAW,CAAC;IACzC,OAAO,YAAY,UAAU,CAAC,MAAM,CAAC,MAAM,UAAU,CAAC;AACxD,CAAC"}