@cleocode/cleo 2026.4.158 → 2026.5.0

package/dist/cli/commands/compliance.js

@@ -0,0 +1,233 @@
+/**
+ * CLI command group: cleo compliance — compliance metrics and enforcement.
+ *
+ * Monitors and reports compliance metrics for orchestrator and agent outputs.
+ *
+ * Subcommands:
+ *   cleo compliance summary              — aggregate stats (default)
+ *   cleo compliance violations           — list violations
+ *   cleo compliance trend [days]         — show trend over N days
+ *   cleo compliance audit <taskId>       — check compliance for a task
+ *   cleo compliance sync                 — sync metrics to global aggregation
+ *   cleo compliance skills               — per-skill/agent reliability stats
+ *   cleo compliance value [days]         — VALUE PROOF: token savings and impact
+ *   cleo compliance record <taskId> <result> — record a check result
+ *
+ * @task T4535
+ * @task T476
+ * @epic T4454
+ */
+import { defineCommand, showUsage } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/** cleo compliance summary — aggregate compliance stats */
+const summaryCommand = defineCommand({
+    meta: { name: 'summary', description: 'Aggregate compliance stats (default)' },
+    args: {
+        since: {
+            type: 'string',
+            description: 'Filter metrics from this date (ISO 8601)',
+        },
+        agent: {
+            type: 'string',
+            description: 'Filter by agent/skill ID',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'check', 'compliance.summary', {
+            since: args.since,
+            agent: args.agent,
+        }, { command: 'compliance' });
+    },
+});
+/** cleo compliance violations — list compliance violations */
+const violationsCommand = defineCommand({
+    meta: { name: 'violations', description: 'List compliance violations' },
+    args: {
+        severity: {
+            type: 'string',
+            description: 'Filter by severity (low|medium|high|critical)',
+        },
+        since: {
+            type: 'string',
+            description: 'Filter from date',
+        },
+        agent: {
+            type: 'string',
+            description: 'Filter by agent ID',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'check', 'compliance.summary', {
+            detail: true,
+            severity: args.severity,
+            since: args.since,
+            agent: args.agent,
+        }, { command: 'compliance' });
+    },
+});
+/** cleo compliance trend — show compliance trend over N days */
+const trendCommand = defineCommand({
+    meta: { name: 'trend', description: 'Show compliance trend over N days' },
+    args: {
+        days: {
+            type: 'positional',
+            description: 'Number of days to include (default: 7)',
+            required: false,
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'check', 'compliance.summary', {
+            type: 'trend',
+            days: args.days !== undefined ? Number.parseInt(args.days, 10) : 7,
+        }, { command: 'compliance' });
+    },
+});
+/** cleo compliance audit — check compliance for a specific task and its subtasks */
+const auditCommand = defineCommand({
+    meta: {
+        name: 'audit',
+        description: 'Check compliance for a specific task and its subtasks',
+    },
+    args: {
+        taskId: {
+            type: 'positional',
+            description: 'Task ID to audit',
+            required: true,
+        },
+        since: {
+            type: 'string',
+            description: 'Filter from date',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'check', 'compliance.summary', {
+            type: 'audit',
+            taskId: args.taskId,
+            since: args.since,
+        }, { command: 'compliance' });
+    },
+});
+/** cleo compliance sync — sync project metrics to global aggregation */
+const syncCommand = defineCommand({
+    meta: { name: 'sync', description: 'Sync project metrics to global aggregation' },
+    args: {
+        force: {
+            type: 'boolean',
+            description: 'Force full sync',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'check', 'compliance.sync', {
+            force: args.force,
+        }, { command: 'compliance' });
+    },
+});
+/** cleo compliance skills — per-skill/agent reliability stats */
+const skillsCommand = defineCommand({
+    meta: { name: 'skills', description: 'Per-skill/agent reliability stats' },
+    args: {
+        global: {
+            type: 'boolean',
+            description: 'Use global metrics file',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'check', 'compliance.summary', {
+            type: 'skills',
+            global: args.global,
+        }, { command: 'compliance' });
+    },
+});
+/** cleo compliance value — VALUE PROOF: token savings and validation impact */
+const valueCommand = defineCommand({
+    meta: { name: 'value', description: 'VALUE PROOF: Token savings & validation impact' },
+    args: {
+        days: {
+            type: 'positional',
+            description: 'Number of days to include (default: 7)',
+            required: false,
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'check', 'compliance.summary', {
+            type: 'value',
+            days: args.days !== undefined ? Number.parseInt(args.days, 10) : 7,
+        }, { command: 'compliance' });
+    },
+});
+/** cleo compliance record — record a compliance check result for a task */
+const recordCommand = defineCommand({
+    meta: {
+        name: 'record',
+        description: 'Record a compliance check result for a task (pass|fail|warning)',
+    },
+    args: {
+        taskId: {
+            type: 'positional',
+            description: 'Task ID to record result for',
+            required: true,
+        },
+        result: {
+            type: 'positional',
+            description: 'Result value (pass|fail|warning)',
+            required: true,
+        },
+        protocol: {
+            type: 'string',
+            description: 'Protocol name the check applies to (e.g. implementation)',
+        },
+        violation: {
+            type: 'string',
+            description: 'Add a violation as "code:severity:message"',
+        },
+    },
+    async run({ args }) {
+        const rawViolation = args.violation;
+        const rawViolations = rawViolation !== undefined ? [rawViolation] : [];
+        const violations = rawViolations
+            .map((v) => {
+            const [code, severity, ...rest] = v.split(':');
+            return {
+                code: code ?? '',
+                severity: (severity === 'error' || severity === 'warning' ? severity : 'error'),
+                message: rest.join(':'),
+            };
+        })
+            .filter((v) => v.code);
+        await dispatchFromCli('mutate', 'check', 'compliance.record', {
+            taskId: args.taskId,
+            result: args.result,
+            protocol: args.protocol,
+            violations: violations.length > 0 ? violations : undefined,
+        }, { command: 'compliance', operation: 'check.compliance.record' });
+    },
+});
+/**
+ * Root compliance command group.
+ *
+ * Monitors and reports compliance metrics for orchestrator and agent outputs.
+ * Dispatches to `check.compliance.*` registry operations.
+ */
+export const complianceCommand = defineCommand({
+    meta: {
+        name: 'compliance',
+        description: 'Monitor and report compliance metrics for orchestrator and agent outputs',
+    },
+    subCommands: {
+        summary: summaryCommand,
+        violations: violationsCommand,
+        trend: trendCommand,
+        audit: auditCommand,
+        sync: syncCommand,
+        skills: skillsCommand,
+        value: valueCommand,
+        record: recordCommand,
+    },
+    async run({ cmd, rawArgs }) {
+        const firstArg = rawArgs?.find((a) => !a.startsWith('-'));
+        if (firstArg && cmd.subCommands && firstArg in cmd.subCommands)
+            return;
+        await showUsage(cmd);
+    },
+});
+//# sourceMappingURL=compliance.js.map

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

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

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

@@ -0,0 +1,28 @@
+/**
+ * CLI command group for Conduit inter-agent messaging operations.
+ *
+ * Exposes the 8 conduit operations registered under the canonical `conduit`
+ * domain (T964 — supersedes ADR-042) as a native citty subcommand group:
+ *
+ *   cleo conduit status     — check agent connection + queue depth
+ *   cleo conduit peek       — one-shot poll without consuming messages
+ *   cleo conduit start      — start continuous polling daemon
+ *   cleo conduit stop       — stop the active polling loop
+ *   cleo conduit send       — send a message to an agent or conversation
+ *   cleo conduit publish    — publish a message to a topic (A2A, T1252)
+ *   cleo conduit subscribe  — subscribe agent to a topic (A2A, T1252)
+ *   cleo conduit listen     — one-shot poll for topic messages (A2A, T1252)
+ *
+ * All subcommands dispatch to the canonical `conduit.*` registry entries
+ * via dispatchFromCli.
+ *
+ * @task T469, T964, T1254
+ */
+/**
+ * Root conduit command group — registers all 8 conduit subcommands.
+ *
+ * Dispatches to canonical `conduit.*` registry operations (T964 supersedes ADR-042).
+ * Topic subcommands (publish/subscribe/listen) added per T1254.
+ */
+export declare const conduitCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=conduit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conduit.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/conduit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAmSH;;;;;GAKG;AACH,eAAO,MAAM,cAAc,qDAiBzB,CAAC"}

package/dist/cli/commands/conduit.js

@@ -0,0 +1,279 @@
+/**
+ * CLI command group for Conduit inter-agent messaging operations.
+ *
+ * Exposes the 8 conduit operations registered under the canonical `conduit`
+ * domain (T964 — supersedes ADR-042) as a native citty subcommand group:
+ *
+ *   cleo conduit status     — check agent connection + queue depth
+ *   cleo conduit peek       — one-shot poll without consuming messages
+ *   cleo conduit start      — start continuous polling daemon
+ *   cleo conduit stop       — stop the active polling loop
+ *   cleo conduit send       — send a message to an agent or conversation
+ *   cleo conduit publish    — publish a message to a topic (A2A, T1252)
+ *   cleo conduit subscribe  — subscribe agent to a topic (A2A, T1252)
+ *   cleo conduit listen     — one-shot poll for topic messages (A2A, T1252)
+ *
+ * All subcommands dispatch to the canonical `conduit.*` registry entries
+ * via dispatchFromCli.
+ *
+ * @task T469, T964, T1254
+ */
+import { defineCommand, showUsage } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/** cleo conduit status — show conduit daemon health and queue depth */
+const statusCommand = defineCommand({
+    meta: { name: 'status', description: 'Show Conduit daemon health and message queue depth' },
+    args: {
+        'agent-id': {
+            type: 'string',
+            description: 'Agent ID to check (defaults to active agent)',
+            alias: 'a',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'conduit', 'status', {
+            agentId: args['agent-id'],
+        }, { command: 'conduit status' });
+    },
+});
+/** cleo conduit peek — preview queued messages without consuming them */
+const peekCommand = defineCommand({
+    meta: {
+        name: 'peek',
+        description: 'Preview queued Conduit messages without consuming',
+    },
+    args: {
+        'agent-id': {
+            type: 'string',
+            description: 'Agent ID to poll as (defaults to active agent)',
+            alias: 'a',
+        },
+        limit: {
+            type: 'string',
+            description: 'Max messages to show (default: 20)',
+            default: '20',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'conduit', 'peek', {
+            agentId: args['agent-id'],
+            limit: Number.parseInt(args.limit, 10),
+        }, { command: 'conduit peek' });
+    },
+});
+/** cleo conduit start — start or resume the Conduit polling daemon */
+const startCommand = defineCommand({
+    meta: { name: 'start', description: 'Start or resume the Conduit polling daemon' },
+    args: {
+        'agent-id': {
+            type: 'string',
+            description: 'Agent ID to poll as (defaults to active agent)',
+            alias: 'a',
+        },
+        interval: {
+            type: 'string',
+            description: 'Poll interval in milliseconds (default: 5000)',
+            default: '5000',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'conduit', 'start', {
+            agentId: args['agent-id'],
+            pollIntervalMs: Number.parseInt(args.interval, 10),
+        }, { command: 'conduit start' });
+    },
+});
+/** cleo conduit stop — stop the active Conduit polling loop */
+const stopCommand = defineCommand({
+    meta: { name: 'stop', description: 'Stop the active Conduit polling daemon' },
+    async run() {
+        await dispatchFromCli('mutate', 'conduit', 'stop', {}, {
+            command: 'conduit stop',
+        });
+    },
+});
+/** cleo conduit send — send a message via Conduit */
+const sendCommand = defineCommand({
+    meta: { name: 'send', description: 'Send a message via Conduit to an agent or conversation' },
+    args: {
+        to: {
+            type: 'string',
+            description: 'Target agent ID (required if --conversation-id not given)',
+        },
+        content: {
+            type: 'string',
+            description: 'Message content to send',
+            required: true,
+        },
+        'conversation-id': {
+            type: 'string',
+            description: 'Target conversation ID (required if --to not given)',
+        },
+        'agent-id': {
+            type: 'string',
+            description: 'Sending agent ID (defaults to active agent)',
+            alias: 'a',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'conduit', 'send', {
+            to: args.to,
+            content: args.content,
+            conversationId: args['conversation-id'],
+            agentId: args['agent-id'],
+        }, { command: 'conduit send' });
+    },
+});
+/**
+ * cleo conduit publish — publish a message to a named topic (A2A, T1252/T1254)
+ *
+ * Routes to the `conduit.publish` mutate operation in the dispatch domain.
+ */
+const publishCommand = defineCommand({
+    meta: {
+        name: 'publish',
+        description: 'Publish a message to a Conduit topic (A2A)',
+    },
+    args: {
+        topic: {
+            type: 'string',
+            description: 'Topic name to publish to (e.g. "epic-T1149.wave-T1253")',
+            required: true,
+        },
+        kind: {
+            type: 'string',
+            description: 'Message kind: message | request | notify | subscribe (default: message)',
+            default: 'message',
+        },
+        payload: {
+            type: 'string',
+            description: 'Structured JSON payload to attach (optional)',
+        },
+        content: {
+            type: 'string',
+            description: 'Message content (defaults to the payload JSON when omitted)',
+        },
+        'agent-id': {
+            type: 'string',
+            description: 'Publishing agent ID (defaults to active agent)',
+            alias: 'a',
+        },
+    },
+    async run({ args }) {
+        // When --content is omitted, fall back to --payload so the caller can
+        // supply just a JSON payload without duplicating it in --content.
+        const content = args.content ?? args.payload ?? '{}';
+        let parsedPayload;
+        if (args.payload) {
+            try {
+                parsedPayload = JSON.parse(args.payload);
+            }
+            catch {
+                // Treat unparseable --payload as a raw string in meta; content is still sent.
+                parsedPayload = { raw: args.payload };
+            }
+        }
+        await dispatchFromCli('mutate', 'conduit', 'publish', {
+            topicName: args.topic,
+            kind: args.kind,
+            content,
+            payload: parsedPayload,
+            agentId: args['agent-id'],
+        }, { command: 'conduit publish' });
+    },
+});
+/**
+ * cleo conduit subscribe — subscribe the active agent to a named topic (A2A, T1252/T1254)
+ *
+ * Routes to the `conduit.subscribe` mutate operation in the dispatch domain.
+ */
+const subscribeCommand = defineCommand({
+    meta: {
+        name: 'subscribe',
+        description: 'Subscribe agent to a Conduit topic (A2A)',
+    },
+    args: {
+        topic: {
+            type: 'string',
+            description: 'Topic name to subscribe to (e.g. "epic-T1149.coordination")',
+            required: true,
+        },
+        'agent-id': {
+            type: 'string',
+            description: 'Agent ID to subscribe (defaults to active agent)',
+            alias: 'a',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'conduit', 'subscribe', {
+            topicName: args.topic,
+            agentId: args['agent-id'],
+        }, { command: 'conduit subscribe' });
+    },
+});
+/**
+ * cleo conduit listen — one-shot poll for messages on a topic (A2A, T1252/T1254)
+ *
+ * Routes to the `conduit.listen` query operation in the dispatch domain.
+ */
+const listenCommand = defineCommand({
+    meta: {
+        name: 'listen',
+        description: 'One-shot poll for messages on a Conduit topic (A2A)',
+    },
+    args: {
+        topic: {
+            type: 'string',
+            description: 'Topic name to poll (e.g. "epic-T1149.wave-T1253")',
+            required: true,
+        },
+        limit: {
+            type: 'string',
+            description: 'Max messages to return (default: 50)',
+            default: '50',
+        },
+        since: {
+            type: 'string',
+            description: 'Return only messages after this ISO 8601 timestamp (optional)',
+        },
+        'agent-id': {
+            type: 'string',
+            description: 'Agent ID to poll as (defaults to active agent)',
+            alias: 'a',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'conduit', 'listen', {
+            topicName: args.topic,
+            limit: Number.parseInt(args.limit, 10),
+            since: args.since,
+            agentId: args['agent-id'],
+        }, { command: 'conduit listen' });
+    },
+});
+/**
+ * Root conduit command group — registers all 8 conduit subcommands.
+ *
+ * Dispatches to canonical `conduit.*` registry operations (T964 supersedes ADR-042).
+ * Topic subcommands (publish/subscribe/listen) added per T1254.
+ */
+export const conduitCommand = defineCommand({
+    meta: { name: 'conduit', description: 'Manage Conduit inter-agent messaging' },
+    subCommands: {
+        status: statusCommand,
+        peek: peekCommand,
+        start: startCommand,
+        stop: stopCommand,
+        send: sendCommand,
+        publish: publishCommand,
+        subscribe: subscribeCommand,
+        listen: listenCommand,
+    },
+    async run({ cmd, rawArgs }) {
+        const firstArg = rawArgs?.find((a) => !a.startsWith('-'));
+        if (firstArg && cmd.subCommands && firstArg in cmd.subCommands)
+            return;
+        await showUsage(cmd);
+    },
+});
+//# sourceMappingURL=conduit.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conduit.js","sourceRoot":"","sources":["../../../src/cli/commands/conduit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,uEAAuE;AACvE,MAAM,aAAa,GAAG,aAAa,CAAC;IAClC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oDAAoD,EAAE;IAC3F,IAAI,EAAE;QACJ,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8CAA8C;YAC3D,KAAK,EAAE,GAAG;SACX;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,eAAe,CACnB,OAAO,EACP,SAAS,EACT,QAAQ,EACR;YACE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAuB;SAChD,EACD,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAC9B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,yEAAyE;AACzE,MAAM,WAAW,GAAG,aAAa,CAAC;IAChC,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,mDAAmD;KACjE;IACD,IAAI,EAAE;QACJ,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gDAAgD;YAC7D,KAAK,EAAE,GAAG;SACX;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,oCAAoC;YACjD,OAAO,EAAE,IAAI;SACd;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,eAAe,CACnB,OAAO,EACP,SAAS,EACT,MAAM,EACN;YACE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAuB;YAC/C,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;SACvC,EACD,EAAE,OAAO,EAAE,cAAc,EAAE,CAC5B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,sEAAsE;AACtE,MAAM,YAAY,GAAG,aAAa,CAAC;IACjC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,4CAA4C,EAAE;IAClF,IAAI,EAAE;QACJ,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gDAAgD;YAC7D,KAAK,EAAE,GAAG;SACX;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+CAA+C;YAC5D,OAAO,EAAE,MAAM;SAChB;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,eAAe,CACnB,QAAQ,EACR,SAAS,EACT,OAAO,EACP;YACE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAuB;YAC/C,cAAc,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;SACnD,EACD,EAAE,OAAO,EAAE,eAAe,EAAE,CAC7B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,+DAA+D;AAC/D,MAAM,WAAW,GAAG,aAAa,CAAC;IAChC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,wCAAwC,EAAE;IAC7E,KAAK,CAAC,GAAG;QACP,MAAM,eAAe,CACnB,QAAQ,EACR,SAAS,EACT,MAAM,EACN,EAAE,EACF;YACE,OAAO,EAAE,cAAc;SACxB,CACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,qDAAqD;AACrD,MAAM,WAAW,GAAG,aAAa,CAAC;IAChC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,wDAAwD,EAAE;IAC7F,IAAI,EAAE;QACJ,EAAE,EAAE;YACF,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,2DAA2D;SACzE;QACD,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,IAAI;SACf;QACD,iBAAiB,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,qDAAqD;SACnE;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,6CAA6C;YAC1D,KAAK,EAAE,GAAG;SACX;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,eAAe,CACnB,QAAQ,EACR,SAAS,EACT,MAAM,EACN;YACE,EAAE,EAAE,IAAI,CAAC,EAAwB;YACjC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,cAAc,EAAE,IAAI,CAAC,iBAAiB,CAAuB;YAC7D,OAAO,EAAE,IAAI,CAAC,UAAU,CAAuB;SAChD,EACD,EAAE,OAAO,EAAE,cAAc,EAAE,CAC5B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,cAAc,GAAG,aAAa,CAAC;IACnC,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,4CAA4C;KAC1D;IACD,IAAI,EAAE;QACJ,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yDAAyD;YACtE,QAAQ,EAAE,IAAI;SACf;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yEAAyE;YACtF,OAAO,EAAE,SAAS;SACnB;QACD,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8CAA8C;SAC5D;QACD,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,6DAA6D;SAC3E;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gDAAgD;YAC7D,KAAK,EAAE,GAAG;SACX;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,sEAAsE;QACtE,kEAAkE;QAClE,MAAM,OAAO,GAAI,IAAI,CAAC,OAA8B,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;QAC7E,IAAI,aAAkD,CAAC;QACvD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAiB,CAA4B,CAAC;YAChF,CAAC;YAAC,MAAM,CAAC;gBACP,8EAA8E;gBAC9E,aAAa,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;YACxC,CAAC;QACH,CAAC;QACD,MAAM,eAAe,CACnB,QAAQ,EACR,SAAS,EACT,SAAS,EACT;YACE,SAAS,EAAE,IAAI,CAAC,KAAK;YACrB,IAAI,EAAE,IAAI,CAAC,IAAsD;YACjE,OAAO;YACP,OAAO,EAAE,aAAa;YACtB,OAAO,EAAE,IAAI,CAAC,UAAU,CAAuB;SAChD,EACD,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAC/B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,aAAa,CAAC;IACrC,IAAI,EAAE;QACJ,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,0CAA0C;KACxD;IACD,IAAI,EAAE;QACJ,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,6DAA6D;YAC1E,QAAQ,EAAE,IAAI;SACf;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,kDAAkD;YAC/D,KAAK,EAAE,GAAG;SACX;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,eAAe,CACnB,QAAQ,EACR,SAAS,EACT,WAAW,EACX;YACE,SAAS,EAAE,IAAI,CAAC,KAAK;YACrB,OAAO,EAAE,IAAI,CAAC,UAAU,CAAuB;SAChD,EACD,EAAE,OAAO,EAAE,mBAAmB,EAAE,CACjC,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,aAAa,GAAG,aAAa,CAAC;IAClC,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,qDAAqD;KACnE;IACD,IAAI,EAAE;QACJ,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mDAAmD;YAChE,QAAQ,EAAE,IAAI;SACf;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,sCAAsC;YACnD,OAAO,EAAE,IAAI;SACd;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+DAA+D;SAC7E;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gDAAgD;YAC7D,KAAK,EAAE,GAAG;SACX;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,eAAe,CACnB,OAAO,EACP,SAAS,EACT,QAAQ,EACR;YACE,SAAS,EAAE,IAAI,CAAC,KAAK;YACrB,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YACtC,KAAK,EAAE,IAAI,CAAC,KAA2B;YACvC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAuB;SAChD,EACD,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAC9B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;IAC1C,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sCAAsC,EAAE;IAC9E,WAAW,EAAE;QACX,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,YAAY;QACnB,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,aAAa;KACtB;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE;QACxB,MAAM,QAAQ,GAAG,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,IAAI,QAAQ,IAAI,GAAG,CAAC,WAAW,IAAI,QAAQ,IAAI,GAAG,CAAC,WAAW;YAAE,OAAO;QACvE,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * CLI command group: cleo config — configuration management.
+ *
+ * Delegates to core/config.ts for business logic. For the `list` subcommand
+ * the resolved config is read directly via `loadConfig()` (no dispatch op).
+ *
+ * Subcommands:
+ *   cleo config get <key>           — get a configuration value
+ *   cleo config set <key> <value>   — set a configuration value
+ *   cleo config set-preset <preset> — apply a strictness preset
+ *   cleo config presets             — list all available presets
+ *   cleo config list                — show all resolved configuration
+ *
+ * @task T4454
+ * @task T4795
+ * @task T067
+ */
+/**
+ * Root config command group.
+ *
+ * Configuration management — read, write, and apply presets for project
+ * and global CLEO configuration.
+ */
+export declare const configCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAsHH;;;;;GAKG;AACH,eAAO,MAAM,aAAa,qDAcxB,CAAC"}