@cleocode/cleo 2026.4.161 → 2026.5.0

package/dist/cli/commands/testing.js

@@ -0,0 +1,111 @@
+/**
+ * CLI testing command group — validate testing protocol compliance.
+ *
+ * Ported from scripts/testing.sh
+ *
+ * Commands:
+ *   cleo testing validate <taskId>         — validate testing protocol for a task
+ *   cleo testing check <manifestFile>      — validate from a manifest file
+ *   cleo testing status                    — show test suite status
+ *   cleo testing coverage                  — show test coverage
+ *   cleo testing run                       — run test suite
+ *
+ * @task T4551
+ * @epic T4545
+ */
+import { defineCommand, showUsage } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/** cleo testing validate — validate testing protocol compliance for a task */
+const validateCommand = defineCommand({
+    meta: { name: 'validate', description: 'Validate testing protocol compliance for a task' },
+    args: {
+        taskId: {
+            type: 'positional',
+            description: 'Task ID to validate testing protocol for',
+            required: true,
+        },
+        strict: {
+            type: 'boolean',
+            description: 'Exit with error code on violations',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'check', 'protocol', {
+            protocolType: 'testing',
+            mode: 'task',
+            taskId: args.taskId,
+            strict: !!args.strict,
+        }, { command: 'testing', operation: 'check.protocol' });
+    },
+});
+/** cleo testing check — validate testing protocol from a manifest file */
+const checkCommand = defineCommand({
+    meta: { name: 'check', description: 'Validate testing protocol from a manifest file' },
+    args: {
+        manifestFile: {
+            type: 'positional',
+            description: 'Path to the manifest file to validate',
+            required: true,
+        },
+        strict: {
+            type: 'boolean',
+            description: 'Exit with error code on violations',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'check', 'manifest', {
+            file: args.manifestFile,
+            strict: !!args.strict,
+            type: 'testing',
+        }, { command: 'testing', operation: 'check.manifest' });
+    },
+});
+/** cleo testing status — show test suite status */
+const statusCommand = defineCommand({
+    meta: { name: 'status', description: 'Show test suite status' },
+    async run() {
+        await dispatchFromCli('query', 'check', 'test', { format: 'status' }, { command: 'testing', operation: 'check.test' });
+    },
+});
+/** cleo testing coverage — show test coverage */
+const coverageCommand = defineCommand({
+    meta: { name: 'coverage', description: 'Show test coverage' },
+    async run() {
+        await dispatchFromCli('query', 'check', 'test', { format: 'coverage' }, { command: 'testing', operation: 'check.test' });
+    },
+});
+/** cleo testing run — run the test suite */
+const runCommand = defineCommand({
+    meta: { name: 'run', description: 'Run test suite' },
+    args: {
+        filter: {
+            type: 'string',
+            description: 'Filter tests by pattern',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'check', 'test.run', { filter: args.filter }, { command: 'testing', operation: 'check.test.run' });
+    },
+});
+/**
+ * Root testing command group — registers all testing subcommands.
+ *
+ * Dispatches to `check.*` registry operations.
+ */
+export const testingCommand = defineCommand({
+    meta: { name: 'testing', description: 'Validate testing protocol compliance' },
+    subCommands: {
+        validate: validateCommand,
+        check: checkCommand,
+        status: statusCommand,
+        coverage: coverageCommand,
+        run: runCommand,
+    },
+    async run({ cmd, rawArgs }) {
+        const firstArg = rawArgs?.find((a) => !a.startsWith('-'));
+        if (firstArg && cmd.subCommands && firstArg in cmd.subCommands)
+            return;
+        await showUsage(cmd);
+    },
+});
+//# sourceMappingURL=testing.js.map

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

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

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

@@ -0,0 +1,22 @@
+/**
+ * Central token telemetry command group.
+ *
+ * Commands:
+ *   cleo token summary   — summarize recorded token telemetry
+ *   cleo token list      — list recorded token telemetry records
+ *   cleo token show      — show a single token telemetry record
+ *   cleo token delete    — delete a token telemetry record
+ *   cleo token clear     — clear token telemetry records
+ *   cleo token estimate  — estimate request/response tokens
+ *
+ * @task T5618
+ * @why CLEO needs a provider-aware in-house token tool that works across CLI, tests, and telemetry workflows.
+ * @what Adds summary/list/show/delete/clear plus direct estimate/record support for token telemetry.
+ */
+/**
+ * Root token command group — registers all token telemetry subcommands.
+ *
+ * Dispatches to `admin.token` registry operations.
+ */
+export declare const tokenCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=token.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/token.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA0MH;;;;GAIG;AACH,eAAO,MAAM,YAAY,qDAmBvB,CAAC"}

package/dist/cli/commands/token.js

@@ -0,0 +1,197 @@
+/**
+ * Central token telemetry command group.
+ *
+ * Commands:
+ *   cleo token summary   — summarize recorded token telemetry
+ *   cleo token list      — list recorded token telemetry records
+ *   cleo token show      — show a single token telemetry record
+ *   cleo token delete    — delete a token telemetry record
+ *   cleo token clear     — clear token telemetry records
+ *   cleo token estimate  — estimate request/response tokens
+ *
+ * @task T5618
+ * @why CLEO needs a provider-aware in-house token tool that works across CLI, tests, and telemetry workflows.
+ * @what Adds summary/list/show/delete/clear plus direct estimate/record support for token telemetry.
+ */
+import { readFileSync } from 'node:fs';
+import { getProjectRoot, measureTokenExchange, recordTokenExchange } from '@cleocode/core/internal';
+import { defineCommand, showUsage } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+import { cliOutput } from '../renderers/index.js';
+/**
+ * Read a text payload from inline text option or a file path option.
+ *
+ * @param args - Parsed citty args object.
+ * @param textKey - Key name for the inline text arg.
+ * @param fileKey - Key name for the file path arg.
+ * @returns The payload string, or undefined if neither arg was provided.
+ */
+function readPayload(args, textKey, fileKey) {
+    const text = args[textKey];
+    const file = args[fileKey];
+    if (file)
+        return readFileSync(file, 'utf-8');
+    return text;
+}
+/** Shared filter args reused across summary, list, and clear subcommands */
+const filterArgs = {
+    provider: { type: 'string', description: 'Filter by provider' },
+    transport: { type: 'string', description: 'Filter by transport' },
+    domain: { type: 'string', description: 'Filter by domain' },
+    operation: { type: 'string', description: 'Filter by operation name' },
+    session: { type: 'string', description: 'Filter by session ID' },
+    task: { type: 'string', description: 'Filter by task ID' },
+};
+/** cleo token summary — summarize recorded token telemetry */
+const summaryCommand = defineCommand({
+    meta: { name: 'summary', description: 'Summarize recorded token telemetry' },
+    args: { ...filterArgs },
+    async run({ args }) {
+        await dispatchFromCli('query', 'admin', 'token', {
+            action: 'summary',
+            provider: args.provider,
+            transport: args.transport,
+            domain: args.domain,
+            operationName: args.operation,
+            sessionId: args.session,
+            taskId: args.task,
+        }, { command: 'token', operation: 'admin.token' });
+    },
+});
+/** cleo token list — list recorded token telemetry records */
+const listCommand = defineCommand({
+    meta: { name: 'list', description: 'List recorded token telemetry' },
+    args: {
+        ...filterArgs,
+        limit: { type: 'string', description: 'Maximum records' },
+        offset: { type: 'string', description: 'Skip records' },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'admin', 'token', {
+            action: 'list',
+            provider: args.provider,
+            transport: args.transport,
+            domain: args.domain,
+            operationName: args.operation,
+            sessionId: args.session,
+            taskId: args.task,
+            limit: args.limit ? Number.parseInt(args.limit, 10) : undefined,
+            offset: args.offset ? Number.parseInt(args.offset, 10) : undefined,
+        }, { command: 'token', operation: 'admin.token' });
+    },
+});
+/** cleo token show — show a single token telemetry record */
+const showCommand = defineCommand({
+    meta: { name: 'show', description: 'Show a single token telemetry record' },
+    args: {
+        tokenId: {
+            type: 'positional',
+            description: 'Token telemetry record ID',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'admin', 'token', { action: 'show', tokenId: args.tokenId }, { command: 'token', operation: 'admin.token' });
+    },
+});
+/** cleo token delete — delete a token telemetry record */
+const deleteCommand = defineCommand({
+    meta: { name: 'delete', description: 'Delete a token telemetry record' },
+    args: {
+        tokenId: {
+            type: 'positional',
+            description: 'Token telemetry record ID to delete',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'admin', 'token', { action: 'delete', tokenId: args.tokenId }, { command: 'token', operation: 'admin.token' });
+    },
+});
+/** cleo token clear — clear token telemetry records (with optional filters) */
+const clearCommand = defineCommand({
+    meta: { name: 'clear', description: 'Clear token telemetry records' },
+    args: { ...filterArgs },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'admin', 'token', {
+            action: 'clear',
+            provider: args.provider,
+            transport: args.transport,
+            domain: args.domain,
+            operationName: args.operation,
+            sessionId: args.session,
+            taskId: args.task,
+        }, { command: 'token', operation: 'admin.token' });
+    },
+});
+/** cleo token estimate — estimate request/response tokens using the central token service */
+const estimateCommand = defineCommand({
+    meta: {
+        name: 'estimate',
+        description: 'Estimate request/response tokens using the central token service',
+    },
+    args: {
+        provider: { type: 'string', description: 'Provider name' },
+        model: { type: 'string', description: 'Model name' },
+        transport: {
+            type: 'string',
+            description: 'Transport (cli|api|agent|unknown)',
+            default: 'unknown',
+        },
+        gateway: { type: 'string', description: 'Gateway name' },
+        domain: { type: 'string', description: 'Domain name' },
+        operation: { type: 'string', description: 'Operation name' },
+        'request-text': { type: 'string', description: 'Inline request text' },
+        'response-text': { type: 'string', description: 'Inline response text' },
+        'request-file': { type: 'string', description: 'Read request payload from file' },
+        'response-file': { type: 'string', description: 'Read response payload from file' },
+        record: { type: 'boolean', description: 'Persist the measured exchange' },
+    },
+    async run({ args }) {
+        const requestPayload = readPayload(args, 'request-text', 'request-file');
+        const responsePayload = readPayload(args, 'response-text', 'response-file');
+        const input = {
+            requestPayload,
+            responsePayload,
+            provider: args.provider,
+            model: args.model,
+            transport: args.transport,
+            gateway: args.gateway,
+            domain: args.domain,
+            operation: args.operation,
+        };
+        const result = args.record
+            ? await recordTokenExchange(getProjectRoot(), input)
+            : await measureTokenExchange(input);
+        cliOutput(result, {
+            command: 'token',
+            operation: args.record ? 'admin.token.record' : 'token.estimate',
+        });
+    },
+});
+/**
+ * Root token command group — registers all token telemetry subcommands.
+ *
+ * Dispatches to `admin.token` registry operations.
+ */
+export const tokenCommand = defineCommand({
+    meta: {
+        name: 'token',
+        description: 'Provider-aware token telemetry from tasks.db (historical, per-operation tracking)',
+    },
+    subCommands: {
+        summary: summaryCommand,
+        list: listCommand,
+        show: showCommand,
+        delete: deleteCommand,
+        clear: clearCommand,
+        estimate: estimateCommand,
+    },
+    async run({ cmd, rawArgs }) {
+        const firstArg = rawArgs?.find((a) => !a.startsWith('-'));
+        if (firstArg && cmd.subCommands && firstArg in cmd.subCommands)
+            return;
+        await showUsage(cmd);
+    },
+});
+//# sourceMappingURL=token.js.map

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * CLI command group for transcript lifecycle management.
+ *
+ * Subcommands:
+ *   cleo transcript scan                           — inventory hot/warm sessions
+ *   cleo transcript scan --pending                 — list sessions queued for extraction (T732)
+ *   cleo transcript extract <session-id>           — run LLM extraction on one session (T730)
+ *   cleo transcript migrate                        — backfill existing sessions (T733)
+ *   cleo transcript prune --older-than <duration>  — prune old transcripts
+ *
+ * All commands respect LAFS envelope format (ADR-039).
+ *
+ * Storage layout scanned (memory-architecture-spec.md §6.2):
+ * ```
+ * ~/.claude/projects/<project-slug>/
+ *   <session-uuid>.jsonl              ← root-level session transcript
+ *   <session-uuid>/subagents/         ← subagent transcripts
+ *   <session-uuid>/tool-results/      ← raw tool results (pruned with session)
+ * ```
+ *
+ * @see packages/core/src/gc/transcript.ts for scan/prune logic
+ * @see docs/specs/memory-architecture-spec.md §6 and §9.1
+ * @task T728 T730 T732 T733
+ * @epic T726
+ */
+/**
+ * Root transcript command group — scan, extract, migrate, and prune session transcripts.
+ *
+ * Dispatches transcript lifecycle operations per memory-architecture-spec.md §6 and §9.1.
+ */
+export declare const transcriptCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=transcript.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/transcript.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AA4fH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,qDAgB5B,CAAC"}