@cleocode/cleo 2026.4.161 → 2026.5.1

package/dist/cli/infer-files-via-gitnexus.d.ts

@@ -0,0 +1,12 @@
+/**
+ * File inference via GitNexus query — re-export shim.
+ *
+ * The canonical implementation has moved to `packages/core/src/tasks/infer-add-params.ts`
+ * (T1490). This module re-exports `inferFilesViaGitNexus` for backward
+ * compatibility with any existing consumers and tests that import from this path.
+ *
+ * @task T1330
+ * @task T1490
+ */
+export { inferFilesViaGitNexus } from '@cleocode/core';
+//# sourceMappingURL=infer-files-via-gitnexus.d.ts.map

package/dist/cli/infer-files-via-gitnexus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infer-files-via-gitnexus.d.ts","sourceRoot":"","sources":["../../src/cli/infer-files-via-gitnexus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/cli/infer-files-via-gitnexus.js

@@ -0,0 +1,12 @@
+/**
+ * File inference via GitNexus query — re-export shim.
+ *
+ * The canonical implementation has moved to `packages/core/src/tasks/infer-add-params.ts`
+ * (T1490). This module re-exports `inferFilesViaGitNexus` for backward
+ * compatibility with any existing consumers and tests that import from this path.
+ *
+ * @task T1330
+ * @task T1490
+ */
+export { inferFilesViaGitNexus } from '@cleocode/core';
+//# sourceMappingURL=infer-files-via-gitnexus.js.map

package/dist/cli/infer-files-via-gitnexus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"infer-files-via-gitnexus.js","sourceRoot":"","sources":["../../src/cli/infer-files-via-gitnexus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/cli/lib/did-you-mean.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Levenshtein distance-based did-you-mean suggestions for CLI verbs
+ *
+ * Provides fuzzy matching for unknown commands with configurable
+ * distance threshold. Calculates edit distance (insertions, deletions,
+ * substitutions) to suggest similar known commands.
+ */
+/**
+ * Calculate the Levenshtein distance between two strings.
+ * Distance = minimum number of single-character edits (insert, delete, substitute)
+ * needed to change one string into another.
+ *
+ * @param input - The mistyped command
+ * @param candidate - A known command to compare against
+ * @returns Edit distance between the two strings
+ */
+export declare function levenshteinDistance(input: string, candidate: string): number;
+/**
+ * Find did-you-mean suggestions for a mistyped command.
+ *
+ * Returns candidates with edit distance <= maxDistance, sorted by distance
+ * ascending, then alphabetically. If no candidates match, returns empty array.
+ *
+ * @param input - The mistyped command
+ * @param candidates - Array of known command names to suggest from
+ * @param maxDistance - Maximum edit distance to consider (default: 2)
+ * @returns Array of suggested commands, sorted by relevance
+ */
+export declare function didYouMean(input: string, candidates: string[], maxDistance?: number): string[];
+//# sourceMappingURL=did-you-mean.d.ts.map

package/dist/cli/lib/did-you-mean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-you-mean.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/did-you-mean.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAuB5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,WAAW,SAAI,GAAG,MAAM,EAAE,CAiBzF"}

package/dist/cli/lib/did-you-mean.js

@@ -0,0 +1,63 @@
+/**
+ * Levenshtein distance-based did-you-mean suggestions for CLI verbs
+ *
+ * Provides fuzzy matching for unknown commands with configurable
+ * distance threshold. Calculates edit distance (insertions, deletions,
+ * substitutions) to suggest similar known commands.
+ */
+/**
+ * Calculate the Levenshtein distance between two strings.
+ * Distance = minimum number of single-character edits (insert, delete, substitute)
+ * needed to change one string into another.
+ *
+ * @param input - The mistyped command
+ * @param candidate - A known command to compare against
+ * @returns Edit distance between the two strings
+ */
+export function levenshteinDistance(input, candidate) {
+    const inputLen = input.length;
+    const candidateLen = candidate.length;
+    // Create a 2D array for dynamic programming
+    const matrix = Array.from({ length: inputLen + 1 }, (_, i) => [i]);
+    for (let j = 1; j <= candidateLen; j++) {
+        matrix[0][j] = j;
+    }
+    for (let i = 1; i <= inputLen; i++) {
+        for (let j = 1; j <= candidateLen; j++) {
+            const cost = input[i - 1] === candidate[j - 1] ? 0 : 1;
+            matrix[i][j] = Math.min(matrix[i - 1][j] + 1, // deletion
+            matrix[i][j - 1] + 1, // insertion
+            matrix[i - 1][j - 1] + cost);
+        }
+    }
+    return matrix[inputLen][candidateLen];
+}
+/**
+ * Find did-you-mean suggestions for a mistyped command.
+ *
+ * Returns candidates with edit distance <= maxDistance, sorted by distance
+ * ascending, then alphabetically. If no candidates match, returns empty array.
+ *
+ * @param input - The mistyped command
+ * @param candidates - Array of known command names to suggest from
+ * @param maxDistance - Maximum edit distance to consider (default: 2)
+ * @returns Array of suggested commands, sorted by relevance
+ */
+export function didYouMean(input, candidates, maxDistance = 2) {
+    const suggestions = candidates
+        .map((candidate) => ({
+        command: candidate,
+        distance: levenshteinDistance(input, candidate),
+    }))
+        .filter((item) => item.distance <= maxDistance)
+        .sort((a, b) => {
+        // Sort by distance first, then alphabetically
+        if (a.distance !== b.distance) {
+            return a.distance - b.distance;
+        }
+        return a.command.localeCompare(b.command);
+    })
+        .map((item) => item.command);
+    return suggestions;
+}
+//# sourceMappingURL=did-you-mean.js.map

package/dist/cli/lib/did-you-mean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-you-mean.js","sourceRoot":"","sources":["../../../src/cli/lib/did-you-mean.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,SAAiB;IAClE,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;IAC9B,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,CAAC;IAEtC,4CAA4C;IAC5C,MAAM,MAAM,GAAe,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvD,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CACtB,MAAM,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC,CAAE,GAAG,CAAC,EAAE,WAAW;YACnC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,CAAC,EAAE,YAAY;YACpC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,IAAI,CAC9B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,QAAQ,CAAE,CAAC,YAAY,CAAE,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,UAAoB,EAAE,WAAW,GAAG,CAAC;IAC7E,MAAM,WAAW,GAAG,UAAU;SAC3B,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACnB,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC;KAChD,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,WAAW,CAAC;SAC9C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,8CAA8C;QAC9C,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC9B,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;QACjC,CAAC;QACD,OAAO,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE/B,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/cli/lib/registry-args.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Registry-to-CLI args bridge.
+ *
+ * Provides helpers that CLI command files use to derive their citty `args`
+ * directly from the OPERATIONS registry rather than declaring inline duplicates.
+ *
+ * Usage in a command file:
+ * ```typescript
+ * import { getOperationParams, paramsToCittyArgs } from '../lib/registry-args.js';
+ *
+ * export const showCommand = defineCommand({
+ *   args: paramsToCittyArgs(getOperationParams('query', 'tasks', 'show')),
+ *   async run({ args }) { ... },
+ * });
+ * ```
+ *
+ * @module registry-args
+ */
+import type { CittyArgDef, ParamDef } from '@cleocode/contracts';
+import type { Gateway } from '../../dispatch/types.js';
+/**
+ * Retrieve the declared `params[]` for a specific operation from the registry.
+ *
+ * Returns an empty array when:
+ * - The operation is not found in the registry.
+ * - The operation exists but has no `params` array yet (legacy entry).
+ *
+ * @param gateway - The CQRS gateway: `'query'` or `'mutate'`.
+ * @param domain  - The canonical domain name (e.g. `'tasks'`, `'check'`).
+ * @param operation - The operation name (e.g. `'show'`, `'list'`).
+ * @returns The `ParamDef[]` from the registry, or `[]` if none declared.
+ */
+export declare function getOperationParams(gateway: Gateway, domain: string, operation: string): ParamDef[];
+export { paramsToCittyArgs } from '@cleocode/contracts';
+export type { CittyArgDef, ParamDef };
+//# sourceMappingURL=registry-args.d.ts.map

package/dist/cli/lib/registry-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-args.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/registry-args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,QAAQ,EAAE,CAKZ;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC"}

package/dist/cli/lib/registry-args.js

@@ -0,0 +1,37 @@
+/**
+ * Registry-to-CLI args bridge.
+ *
+ * Provides helpers that CLI command files use to derive their citty `args`
+ * directly from the OPERATIONS registry rather than declaring inline duplicates.
+ *
+ * Usage in a command file:
+ * ```typescript
+ * import { getOperationParams, paramsToCittyArgs } from '../lib/registry-args.js';
+ *
+ * export const showCommand = defineCommand({
+ *   args: paramsToCittyArgs(getOperationParams('query', 'tasks', 'show')),
+ *   async run({ args }) { ... },
+ * });
+ * ```
+ *
+ * @module registry-args
+ */
+import { OPERATIONS } from '../../dispatch/registry.js';
+/**
+ * Retrieve the declared `params[]` for a specific operation from the registry.
+ *
+ * Returns an empty array when:
+ * - The operation is not found in the registry.
+ * - The operation exists but has no `params` array yet (legacy entry).
+ *
+ * @param gateway - The CQRS gateway: `'query'` or `'mutate'`.
+ * @param domain  - The canonical domain name (e.g. `'tasks'`, `'check'`).
+ * @param operation - The operation name (e.g. `'show'`, `'list'`).
+ * @returns The `ParamDef[]` from the registry, or `[]` if none declared.
+ */
+export function getOperationParams(gateway, domain, operation) {
+    const def = OPERATIONS.find((o) => o.gateway === gateway && o.domain === domain && o.operation === operation);
+    return def?.params ?? [];
+}
+export { paramsToCittyArgs } from '@cleocode/contracts';
+//# sourceMappingURL=registry-args.js.map

package/dist/cli/lib/registry-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-args.js","sourceRoot":"","sources":["../../../src/cli/lib/registry-args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAGxD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAgB,EAChB,MAAc,EACd,SAAiB;IAEjB,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CACzB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,CACjF,CAAC;IACF,OAAO,GAAG,EAAE,MAAM,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/cli/lib/subcommand-guard.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Subcommand-dispatch guard for citty command groups.
+ *
+ * Citty's `runCommand` runs the matched subcommand AND THEN also invokes the
+ * parent command's `run()` — by design in citty@0.2.x. When the parent's
+ * `run()` emits output (default dispatch, help banner, status summary),
+ * every `cleo <group> <subcommand>` call double-writes to stdout:
+ *
+ * 1. The subcommand's intended JSON / text output
+ * 2. The parent's default behaviour appended on top
+ *
+ * This breaks programmatic consumers (python `json.load`, `jq`, pipelines)
+ * that expect one clean JSON document per line.
+ *
+ * The guard below returns `true` when a known subcommand token appears in
+ * `rawArgs` — callers detect this and early-return from the parent's `run()`
+ * so only the subcommand's output reaches stdout.
+ *
+ * @task T1187-followup · v2026.4.114
+ */
+import type { CommandDef } from 'citty';
+/**
+ * Inspect `rawArgs` to determine whether citty has already dispatched (or is
+ * about to dispatch) a recognised subcommand. When `true`, the parent
+ * command's `run()` MUST early-return to avoid double-writing to stdout.
+ *
+ * @param rawArgs      - Raw CLI tokens citty passed into the command context.
+ * @param subCommands  - The parent command's `subCommands` map.
+ * @returns `true` iff the first non-flag token names a registered subcommand.
+ *
+ * @example
+ * ```ts
+ * const myGroup = defineCommand({
+ *   meta: { name: 'my' },
+ *   subCommands: { list, show, add },
+ *   async run({ cmd, rawArgs }) {
+ *     if (isSubCommandDispatch(rawArgs, cmd.subCommands)) return;
+ *     // fallthrough: default behaviour (e.g. help banner or default op)
+ *     await showUsage(cmd);
+ *   },
+ * });
+ * ```
+ */
+export declare function isSubCommandDispatch(rawArgs: readonly string[] | undefined, subCommands: CommandDef['subCommands'] | undefined): boolean;
+//# sourceMappingURL=subcommand-guard.d.ts.map

package/dist/cli/lib/subcommand-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subcommand-guard.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/subcommand-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EACtC,WAAW,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,SAAS,GACjD,OAAO,CAQT"}

package/dist/cli/lib/subcommand-guard.js

@@ -0,0 +1,55 @@
+/**
+ * Subcommand-dispatch guard for citty command groups.
+ *
+ * Citty's `runCommand` runs the matched subcommand AND THEN also invokes the
+ * parent command's `run()` — by design in citty@0.2.x. When the parent's
+ * `run()` emits output (default dispatch, help banner, status summary),
+ * every `cleo <group> <subcommand>` call double-writes to stdout:
+ *
+ * 1. The subcommand's intended JSON / text output
+ * 2. The parent's default behaviour appended on top
+ *
+ * This breaks programmatic consumers (python `json.load`, `jq`, pipelines)
+ * that expect one clean JSON document per line.
+ *
+ * The guard below returns `true` when a known subcommand token appears in
+ * `rawArgs` — callers detect this and early-return from the parent's `run()`
+ * so only the subcommand's output reaches stdout.
+ *
+ * @task T1187-followup · v2026.4.114
+ */
+/**
+ * Inspect `rawArgs` to determine whether citty has already dispatched (or is
+ * about to dispatch) a recognised subcommand. When `true`, the parent
+ * command's `run()` MUST early-return to avoid double-writing to stdout.
+ *
+ * @param rawArgs      - Raw CLI tokens citty passed into the command context.
+ * @param subCommands  - The parent command's `subCommands` map.
+ * @returns `true` iff the first non-flag token names a registered subcommand.
+ *
+ * @example
+ * ```ts
+ * const myGroup = defineCommand({
+ *   meta: { name: 'my' },
+ *   subCommands: { list, show, add },
+ *   async run({ cmd, rawArgs }) {
+ *     if (isSubCommandDispatch(rawArgs, cmd.subCommands)) return;
+ *     // fallthrough: default behaviour (e.g. help banner or default op)
+ *     await showUsage(cmd);
+ *   },
+ * });
+ * ```
+ */
+export function isSubCommandDispatch(rawArgs, subCommands) {
+    if (!rawArgs || !subCommands)
+        return false;
+    const firstArg = rawArgs.find((a) => !a.startsWith('-'));
+    if (!firstArg)
+        return false;
+    // `subCommands` may be a static object, a promise, or a function in citty.
+    // We only need to inspect the static map case at dispatch time.
+    if (typeof subCommands !== 'object')
+        return false;
+    return firstArg in subCommands;
+}
+//# sourceMappingURL=subcommand-guard.js.map

package/dist/cli/lib/subcommand-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subcommand-guard.js","sourceRoot":"","sources":["../../../src/cli/lib/subcommand-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAsC,EACtC,WAAkD;IAElD,IAAI,CAAC,OAAO,IAAI,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,2EAA2E;IAC3E,gEAAgE;IAChE,IAAI,OAAO,WAAW,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,OAAO,QAAQ,IAAK,WAAuC,CAAC;AAC9D,CAAC"}

package/dist/cli/logger-bootstrap.d.ts

@@ -0,0 +1,6 @@
+import type { LoggerConfig } from '@cleocode/core';
+/**
+ * Initialize CLI logger with optional projectHash correlation context.
+ */
+export declare function initCliLogger(cwd: string, loggingConfig: LoggerConfig): void;
+//# sourceMappingURL=logger-bootstrap.d.ts.map

package/dist/cli/logger-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-bootstrap.d.ts","sourceRoot":"","sources":["../../src/cli/logger-bootstrap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,GAAG,IAAI,CAG5E"}

package/dist/cli/logger-bootstrap.js

@@ -0,0 +1,10 @@
+import { join } from 'node:path';
+import { getProjectInfoSync, initLogger } from '@cleocode/core';
+/**
+ * Initialize CLI logger with optional projectHash correlation context.
+ */
+export function initCliLogger(cwd, loggingConfig) {
+    const projectInfo = getProjectInfoSync(cwd);
+    initLogger(join(cwd, '.cleo'), loggingConfig, projectInfo?.projectHash);
+}
+//# sourceMappingURL=logger-bootstrap.js.map

package/dist/cli/logger-bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-bootstrap.js","sourceRoot":"","sources":["../../src/cli/logger-bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEhE;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,aAA2B;IACpE,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC5C,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AAC1E,CAAC"}

package/dist/cli/middleware/output-format.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared CLI middleware for resolving output format from --human/--json/--quiet flags.
+ *
+ * Delegates to LAFS protocol's resolveOutputFormat() for canonical flag resolution,
+ * and provides a Commander.js-compatible helper to extract flag values from opts.
+ *
+ * @task T4703
+ * @epic T4663
+ */
+import { type FlagResolution } from '@cleocode/lafs';
+export type { FlagResolution };
+/**
+ * Resolve output format from Commander.js option values.
+ *
+ * Reads --json, --human, and --quiet flags and delegates to
+ * the canonical LAFS resolveOutputFormat(). Project/user defaults
+ * can be passed via the optional `defaults` parameter.
+ *
+ * @param opts - Commander.js parsed options object
+ * @param defaults - Optional project/user defaults
+ * @returns Resolved format with source provenance
+ *
+ * @task T4703
+ * @epic T4663
+ */
+export declare function resolveFormat(opts: Record<string, unknown>, defaults?: {
+    projectDefault?: 'json' | 'human';
+    userDefault?: 'json' | 'human';
+}): FlagResolution;
+//# sourceMappingURL=output-format.d.ts.map

package/dist/cli/middleware/output-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format.d.ts","sourceRoot":"","sources":["../../../src/cli/middleware/output-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAkB,KAAK,cAAc,EAAuB,MAAM,gBAAgB,CAAC;AAE1F,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAC/E,cAAc,CAUhB"}

package/dist/cli/middleware/output-format.js

@@ -0,0 +1,35 @@
+/**
+ * Shared CLI middleware for resolving output format from --human/--json/--quiet flags.
+ *
+ * Delegates to LAFS protocol's resolveOutputFormat() for canonical flag resolution,
+ * and provides a Commander.js-compatible helper to extract flag values from opts.
+ *
+ * @task T4703
+ * @epic T4663
+ */
+import { resolveOutputFormat } from '@cleocode/lafs';
+/**
+ * Resolve output format from Commander.js option values.
+ *
+ * Reads --json, --human, and --quiet flags and delegates to
+ * the canonical LAFS resolveOutputFormat(). Project/user defaults
+ * can be passed via the optional `defaults` parameter.
+ *
+ * @param opts - Commander.js parsed options object
+ * @param defaults - Optional project/user defaults
+ * @returns Resolved format with source provenance
+ *
+ * @task T4703
+ * @epic T4663
+ */
+export function resolveFormat(opts, defaults) {
+    const input = {
+        jsonFlag: opts['json'] === true,
+        humanFlag: opts['human'] === true,
+        quiet: opts['quiet'] === true,
+        projectDefault: defaults?.projectDefault,
+        userDefault: defaults?.userDefault,
+    };
+    return resolveOutputFormat(input);
+}
+//# sourceMappingURL=output-format.js.map

package/dist/cli/middleware/output-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format.js","sourceRoot":"","sources":["../../../src/cli/middleware/output-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAuC,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAI1F;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAC3B,IAA6B,EAC7B,QAAgF;IAEhF,MAAM,KAAK,GAAc;QACvB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI;QAC/B,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI;QACjC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI;QAC7B,cAAc,EAAE,QAAQ,EAAE,cAAc;QACxC,WAAW,EAAE,QAAQ,EAAE,WAAW;KACnC,CAAC;IAEF,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/dist/cli/paths.d.ts

@@ -0,0 +1,85 @@
+/**
+ * CLI-level path constants for the CLEO CLI package.
+ *
+ * Centralizes all magic strings for:
+ *   - Database filenames (tasks.db, brain.db, conduit.db, nexus.db, signaldock.db)
+ *   - JSON config filenames (config.json, project-info.json, project-context.json)
+ *   - Project-local file lists used by backup / restore / doctor commands
+ *   - Internal subdirectory names under .cleo/
+ *   - CLI-level temporary/report filenames
+ *
+ * All path construction delegates to `@cleocode/core/internal` path helpers so
+ * that `CLEO_DIR`, `CLEO_ROOT`, and worktree-scope overrides are honoured. This
+ * file MUST NOT import from other files inside `packages/cleo/src/` to avoid
+ * circular-import risk (it is a pure constants/helpers leaf module).
+ *
+ * @task T090
+ */
+/** Name of the project-local CLEO data directory. */
+export declare const CLEO_DIR_NAME: ".cleo";
+/** Subdirectory under .cleo/ that stores internal-state files for context tracking. */
+export declare const CONTEXT_STATES_SUBDIR: "context-states";
+/** Subdirectory under .cleo/ that stores CANT agent definition files. */
+export declare const AGENTS_SUBDIR: "agents";
+/** Subdirectory under .cleo/ that stores CANT workflow files (legacy path). */
+export declare const CANT_AGENTS_SUBDIR: "cant/agents";
+/** Subdirectory under .cleo/ that stores CANT workflow definitions. */
+export declare const WORKFLOWS_SUBDIR: "workflows";
+/** Subdirectory under .cleo/ for metrics data (e.g. COMPLIANCE.jsonl). */
+export declare const METRICS_SUBDIR: "metrics";
+/** Subdirectory under .cleo/ for locally-installed template overrides. */
+export declare const TEMPLATES_SUBDIR: "templates";
+/** Subdirectory under .cleo/ for operational backups (legacy simple backups). */
+export declare const BACKUPS_OPERATIONAL_SUBDIR: "backups/operational";
+/** Subdirectory used during a backup import to stage restored JSON files. */
+export declare const RESTORE_IMPORTED_SUBDIR: "restore-imported";
+/** Project-local SQLite database for task data. */
+export declare const TASKS_DB_FILENAME: "tasks.db";
+/** Project-local SQLite database for cognitive memory (BRAIN). */
+export declare const BRAIN_DB_FILENAME: "brain.db";
+/** Project-local SQLite database for inter-agent messaging (CONDUIT). */
+export declare const CONDUIT_DB_FILENAME: "conduit.db";
+/** Global-tier SQLite database for code intelligence (NEXUS). */
+export declare const NEXUS_DB_FILENAME: "nexus.db";
+/** Global-tier SQLite database for agent identity (SIGNALDOCK). */
+export declare const SIGNALDOCK_DB_FILENAME: "signaldock.db";
+/** Project configuration file. */
+export declare const CONFIG_JSON: "config.json";
+/** Project identity metadata file. */
+export declare const PROJECT_INFO_JSON: "project-info.json";
+/** LLM-hint project context file (auto-detected). */
+export declare const PROJECT_CONTEXT_JSON: "project-context.json";
+/** Conflict report produced by `cleo backup import` for manual resolution. */
+export declare const RESTORE_CONFLICTS_MD: "restore-conflicts.md";
+/** State hash file written by the MEMORY.md migration process. */
+export declare const MIGRATE_MEMORY_HASHES_JSON: "migrate-memory-hashes.json";
+/** Compliance metrics append-only log. */
+export declare const COMPLIANCE_JSONL: "COMPLIANCE.jsonl";
+/** CLEO-INJECTION.md canonical template filename. */
+export declare const CLEO_INJECTION_MD: "CLEO-INJECTION.md";
+/**
+ * Project-relative paths for all files included in a project backup.
+ *
+ * These are the paths passed to `checkForExistingData` and `packBundle` when
+ * building or verifying a project-scoped backup bundle. Each entry is relative
+ * to the project root so that callers can join them with `path.join(root, f)`.
+ */
+export declare const CLI_PROJECT_BACKUP_FILES: readonly [".cleo/tasks.db", ".cleo/brain.db", ".cleo/conduit.db", ".cleo/config.json", ".cleo/project-info.json", ".cleo/project-context.json"];
+/**
+ * Filenames for global-tier databases included in a global backup.
+ *
+ * These are plain filenames resolved against `cleoHome` (not project root).
+ */
+export declare const CLI_GLOBAL_BACKUP_FILES: readonly ["nexus.db", "signaldock.db"];
+/**
+ * Set of JSON config filenames that are valid targets for `cleo restore backup`.
+ *
+ * Used by both the conflict-report parser and the restore command to validate
+ * caller-supplied filenames.
+ */
+export declare const RESTORE_VALID_JSON_FILENAMES: Set<string>;
+/**
+ * Default filename used when `cleo restore backup` is called without `--file`.
+ */
+export declare const RESTORE_DEFAULT_FILE: "tasks.db";
+//# sourceMappingURL=paths.d.ts.map

package/dist/cli/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/cli/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,qDAAqD;AACrD,eAAO,MAAM,aAAa,EAAG,OAAgB,CAAC;AAE9C,uFAAuF;AACvF,eAAO,MAAM,qBAAqB,EAAG,gBAAyB,CAAC;AAE/D,yEAAyE;AACzE,eAAO,MAAM,aAAa,EAAG,QAAiB,CAAC;AAE/C,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,EAAG,aAAsB,CAAC;AAEzD,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,EAAG,WAAoB,CAAC;AAErD,0EAA0E;AAC1E,eAAO,MAAM,cAAc,EAAG,SAAkB,CAAC;AAEjD,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,EAAG,WAAoB,CAAC;AAErD,iFAAiF;AACjF,eAAO,MAAM,0BAA0B,EAAG,qBAA8B,CAAC;AAEzE,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB,EAAG,kBAA2B,CAAC;AAMnE,mDAAmD;AACnD,eAAO,MAAM,iBAAiB,EAAG,UAAmB,CAAC;AAErD,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,EAAG,UAAmB,CAAC;AAErD,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,EAAG,YAAqB,CAAC;AAEzD,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,EAAG,UAAmB,CAAC;AAErD,mEAAmE;AACnE,eAAO,MAAM,sBAAsB,EAAG,eAAwB,CAAC;AAM/D,kCAAkC;AAClC,eAAO,MAAM,WAAW,EAAG,aAAsB,CAAC;AAElD,sCAAsC;AACtC,eAAO,MAAM,iBAAiB,EAAG,mBAA4B,CAAC;AAE9D,qDAAqD;AACrD,eAAO,MAAM,oBAAoB,EAAG,sBAA+B,CAAC;AAEpE,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,EAAG,sBAA+B,CAAC;AAEpE,kEAAkE;AAClE,eAAO,MAAM,0BAA0B,EAAG,4BAAqC,CAAC;AAEhF,0CAA0C;AAC1C,eAAO,MAAM,gBAAgB,EAAG,kBAA2B,CAAC;AAE5D,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,EAAG,mBAA4B,CAAC;AAM9D;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,iJAO3B,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,wCAAuD,CAAC;AAE5F;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,EAAE,GAAG,CAAC,MAAM,CAInD,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB,YAAoB,CAAC"}

package/dist/cli/paths.js

@@ -0,0 +1,108 @@
+/**
+ * CLI-level path constants for the CLEO CLI package.
+ *
+ * Centralizes all magic strings for:
+ *   - Database filenames (tasks.db, brain.db, conduit.db, nexus.db, signaldock.db)
+ *   - JSON config filenames (config.json, project-info.json, project-context.json)
+ *   - Project-local file lists used by backup / restore / doctor commands
+ *   - Internal subdirectory names under .cleo/
+ *   - CLI-level temporary/report filenames
+ *
+ * All path construction delegates to `@cleocode/core/internal` path helpers so
+ * that `CLEO_DIR`, `CLEO_ROOT`, and worktree-scope overrides are honoured. This
+ * file MUST NOT import from other files inside `packages/cleo/src/` to avoid
+ * circular-import risk (it is a pure constants/helpers leaf module).
+ *
+ * @task T090
+ */
+// ============================================================================
+// Directory names
+// ============================================================================
+/** Name of the project-local CLEO data directory. */
+export const CLEO_DIR_NAME = '.cleo';
+/** Subdirectory under .cleo/ that stores internal-state files for context tracking. */
+export const CONTEXT_STATES_SUBDIR = 'context-states';
+/** Subdirectory under .cleo/ that stores CANT agent definition files. */
+export const AGENTS_SUBDIR = 'agents';
+/** Subdirectory under .cleo/ that stores CANT workflow files (legacy path). */
+export const CANT_AGENTS_SUBDIR = 'cant/agents';
+/** Subdirectory under .cleo/ that stores CANT workflow definitions. */
+export const WORKFLOWS_SUBDIR = 'workflows';
+/** Subdirectory under .cleo/ for metrics data (e.g. COMPLIANCE.jsonl). */
+export const METRICS_SUBDIR = 'metrics';
+/** Subdirectory under .cleo/ for locally-installed template overrides. */
+export const TEMPLATES_SUBDIR = 'templates';
+/** Subdirectory under .cleo/ for operational backups (legacy simple backups). */
+export const BACKUPS_OPERATIONAL_SUBDIR = 'backups/operational';
+/** Subdirectory used during a backup import to stage restored JSON files. */
+export const RESTORE_IMPORTED_SUBDIR = 'restore-imported';
+// ============================================================================
+// Database filenames
+// ============================================================================
+/** Project-local SQLite database for task data. */
+export const TASKS_DB_FILENAME = 'tasks.db';
+/** Project-local SQLite database for cognitive memory (BRAIN). */
+export const BRAIN_DB_FILENAME = 'brain.db';
+/** Project-local SQLite database for inter-agent messaging (CONDUIT). */
+export const CONDUIT_DB_FILENAME = 'conduit.db';
+/** Global-tier SQLite database for code intelligence (NEXUS). */
+export const NEXUS_DB_FILENAME = 'nexus.db';
+/** Global-tier SQLite database for agent identity (SIGNALDOCK). */
+export const SIGNALDOCK_DB_FILENAME = 'signaldock.db';
+// ============================================================================
+// JSON / Markdown config filenames
+// ============================================================================
+/** Project configuration file. */
+export const CONFIG_JSON = 'config.json';
+/** Project identity metadata file. */
+export const PROJECT_INFO_JSON = 'project-info.json';
+/** LLM-hint project context file (auto-detected). */
+export const PROJECT_CONTEXT_JSON = 'project-context.json';
+/** Conflict report produced by `cleo backup import` for manual resolution. */
+export const RESTORE_CONFLICTS_MD = 'restore-conflicts.md';
+/** State hash file written by the MEMORY.md migration process. */
+export const MIGRATE_MEMORY_HASHES_JSON = 'migrate-memory-hashes.json';
+/** Compliance metrics append-only log. */
+export const COMPLIANCE_JSONL = 'COMPLIANCE.jsonl';
+/** CLEO-INJECTION.md canonical template filename. */
+export const CLEO_INJECTION_MD = 'CLEO-INJECTION.md';
+// ============================================================================
+// Backup / restore file lists
+// ============================================================================
+/**
+ * Project-relative paths for all files included in a project backup.
+ *
+ * These are the paths passed to `checkForExistingData` and `packBundle` when
+ * building or verifying a project-scoped backup bundle. Each entry is relative
+ * to the project root so that callers can join them with `path.join(root, f)`.
+ */
+export const CLI_PROJECT_BACKUP_FILES = [
+    `${CLEO_DIR_NAME}/${TASKS_DB_FILENAME}`,
+    `${CLEO_DIR_NAME}/${BRAIN_DB_FILENAME}`,
+    `${CLEO_DIR_NAME}/${CONDUIT_DB_FILENAME}`,
+    `${CLEO_DIR_NAME}/${CONFIG_JSON}`,
+    `${CLEO_DIR_NAME}/${PROJECT_INFO_JSON}`,
+    `${CLEO_DIR_NAME}/${PROJECT_CONTEXT_JSON}`,
+];
+/**
+ * Filenames for global-tier databases included in a global backup.
+ *
+ * These are plain filenames resolved against `cleoHome` (not project root).
+ */
+export const CLI_GLOBAL_BACKUP_FILES = [NEXUS_DB_FILENAME, SIGNALDOCK_DB_FILENAME];
+/**
+ * Set of JSON config filenames that are valid targets for `cleo restore backup`.
+ *
+ * Used by both the conflict-report parser and the restore command to validate
+ * caller-supplied filenames.
+ */
+export const RESTORE_VALID_JSON_FILENAMES = new Set([
+    CONFIG_JSON,
+    PROJECT_INFO_JSON,
+    PROJECT_CONTEXT_JSON,
+]);
+/**
+ * Default filename used when `cleo restore backup` is called without `--file`.
+ */
+export const RESTORE_DEFAULT_FILE = TASKS_DB_FILENAME;
+//# sourceMappingURL=paths.js.map

package/dist/cli/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/cli/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,qDAAqD;AACrD,MAAM,CAAC,MAAM,aAAa,GAAG,OAAgB,CAAC;AAE9C,uFAAuF;AACvF,MAAM,CAAC,MAAM,qBAAqB,GAAG,gBAAyB,CAAC;AAE/D,yEAAyE;AACzE,MAAM,CAAC,MAAM,aAAa,GAAG,QAAiB,CAAC;AAE/C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAsB,CAAC;AAEzD,uEAAuE;AACvE,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAoB,CAAC;AAErD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,cAAc,GAAG,SAAkB,CAAC;AAEjD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAoB,CAAC;AAErD,iFAAiF;AACjF,MAAM,CAAC,MAAM,0BAA0B,GAAG,qBAA8B,CAAC;AAEzE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,uBAAuB,GAAG,kBAA2B,CAAC;AAEnE,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,mDAAmD;AACnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAmB,CAAC;AAErD,kEAAkE;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAmB,CAAC;AAErD,yEAAyE;AACzE,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAqB,CAAC;AAEzD,iEAAiE;AACjE,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAmB,CAAC;AAErD,mEAAmE;AACnE,MAAM,CAAC,MAAM,sBAAsB,GAAG,eAAwB,CAAC;AAE/D,+EAA+E;AAC/E,mCAAmC;AACnC,+EAA+E;AAE/E,kCAAkC;AAClC,MAAM,CAAC,MAAM,WAAW,GAAG,aAAsB,CAAC;AAElD,sCAAsC;AACtC,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAA4B,CAAC;AAE9D,qDAAqD;AACrD,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAA+B,CAAC;AAEpE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAA+B,CAAC;AAEpE,kEAAkE;AAClE,MAAM,CAAC,MAAM,0BAA0B,GAAG,4BAAqC,CAAC;AAEhF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAA2B,CAAC;AAE5D,qDAAqD;AACrD,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAA4B,CAAC;AAE9D,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,GAAG,aAAa,IAAI,iBAAiB,EAAE;IACvC,GAAG,aAAa,IAAI,iBAAiB,EAAE;IACvC,GAAG,aAAa,IAAI,mBAAmB,EAAE;IACzC,GAAG,aAAa,IAAI,WAAW,EAAE;IACjC,GAAG,aAAa,IAAI,iBAAiB,EAAE;IACvC,GAAG,aAAa,IAAI,oBAAoB,EAAE;CAClC,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,iBAAiB,EAAE,sBAAsB,CAAU,CAAC;AAE5F;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAgB,IAAI,GAAG,CAAC;IAC/D,WAAW;IACX,iBAAiB;IACjB,oBAAoB;CACrB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC"}