@cleocode/core 2026.3.76 → 2026.4.2

package/dist/metrics/token-service.d.ts

@@ -1,19 +1,19 @@
 /**
  * Provider-aware token measurement and persistence.
  *
- * Central SSoT for CLI/MCP/tooling token estimation with a three-layer chain:
+ * Central SSoT for CLI/tooling token estimation with a three-layer chain:
  * 1) OTel/provider telemetry when available
  * 2) Exact tokenizer for supported models
  * 3) Heuristic fallback calibrated for JSON vs text payloads
  *
  * @task T5618
  * @why CLEO needs a provider-aware in-house token service instead of relying on a single external runtime.
- * @what Adds central token measurement, persistence, CRUD, and summary helpers for CLI, MCP, tests, and telemetry tooling.
+ * @what Adds central token measurement, persistence, CRUD, and summary helpers for CLI, tests, and telemetry tooling.
  */
 import { type TokenUsageRow } from '../store/tasks-schema.js';
 export type TokenMethod = 'otel' | 'provider_api' | 'tokenizer' | 'heuristic';
 export type TokenConfidence = 'real' | 'high' | 'estimated' | 'coarse';
-export type TokenTransport = 'cli' | 'mcp' | 'api' | 'agent' | 'unknown';
+export type TokenTransport = 'cli' | 'api' | 'agent' | 'unknown';
 export interface TokenExchangeInput {
     requestPayload?: unknown;
     responsePayload?: unknown;

package/dist/metrics/token-service.d.ts.map

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

package/dist/orchestration/hierarchy.d.ts

@@ -0,0 +1,32 @@
+/**
+ * OrchestrationHierarchyImpl — Concrete implementation of the 5-level hierarchy.
+ *
+ * Loads the agent matrix from agent-matrix.json (if available) or uses
+ * the built-in default matrix. Provides escalation chain resolution,
+ * authority checks, and project scoping.
+ *
+ * @see docs/specs/CLEO-ORCH-PLAN.md
+ * @task T217
+ */
+import type { AgentHierarchy, AgentHierarchyEntry, EscalationChain, OrchestrationHierarchyAPI } from '@cleocode/contracts';
+import { OrchestrationLevel } from '@cleocode/contracts';
+/** Concrete implementation of OrchestrationHierarchyAPI. */
+export declare class OrchestrationHierarchyImpl implements OrchestrationHierarchyAPI {
+    private hierarchy;
+    constructor(hierarchy?: AgentHierarchy);
+    /** Get the full hierarchy. */
+    getHierarchy(): AgentHierarchy;
+    /** Get a single agent's hierarchy entry. */
+    getAgent(agentId: string): AgentHierarchyEntry | null;
+    /** Get all agents at a specific level. */
+    getAgentsAtLevel(level: OrchestrationLevel): AgentHierarchyEntry[];
+    /** Get the escalation chain for an agent (nearest authority first). */
+    getEscalationChain(agentId: string): EscalationChain;
+    /** Get all agents directly managed by a specific agent. */
+    getDirectReports(agentId: string): AgentHierarchyEntry[];
+    /** Check if agent A has authority over agent B (A is in B's escalation chain). */
+    hasAuthority(agentIdA: string, agentIdB: string): boolean;
+    /** Get all agents scoped to a project. */
+    getProjectAgents(projectId: string): AgentHierarchyEntry[];
+}
+//# sourceMappingURL=hierarchy.d.ts.map

package/dist/orchestration/hierarchy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.d.ts","sourceRoot":"","sources":["../../src/orchestration/hierarchy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,yBAAyB,EAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AA4HzD,4DAA4D;AAC5D,qBAAa,0BAA2B,YAAW,yBAAyB;IAC1E,OAAO,CAAC,SAAS,CAAiB;gBAEtB,SAAS,CAAC,EAAE,cAAc;IAItC,8BAA8B;IAC9B,YAAY,IAAI,cAAc;IAI9B,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAIrD,0CAA0C;IAC1C,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,EAAE;IAIlE,uEAAuE;IACvE,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe;IAgBpD,2DAA2D;IAC3D,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,EAAE;IASxD,kFAAkF;IAClF,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKzD,0CAA0C;IAC1C,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,EAAE;CAG3D"}

package/dist/orchestration/index.d.ts

@@ -9,6 +9,7 @@ export type { CircularDependency, DependencyAnalysis, MissingDependency } from '
 export { analyzeDependencies, buildDependencyGraph, detectCircularDependencies, findMissingDependencies, } from './analyze.js';
 export type { ContextEstimation } from './context.js';
 export { countManifestEntries, estimateContext } from './context.js';
+export { OrchestrationHierarchyImpl } from './hierarchy.js';
 export type { EpicStatus, OverallStatus, ProgressMetrics, StartupSummary, StatusCounts, } from './status.js';
 export { computeEpicStatus, computeOverallStatus, computeProgress, computeStartupSummary, countByStatus, } from './status.js';
 /** Orchestrator session state. */

package/dist/orchestration/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/orchestration/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/orchestration/index.ts"],"names":[],"mappings":"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"}

package/dist/paths.d.ts

@@ -11,6 +11,20 @@
 /**
  * Check if a CLEO project is initialized at the given root.
  * Checks for tasks.db.
+ *
+ * @param projectRoot - Absolute path to check; defaults to the resolved project root
+ * @returns True if .cleo/ and tasks.db exist at the given root
+ *
+ * @remarks
+ * A project is considered initialized when both the .cleo/ directory and
+ * the tasks.db SQLite database file are present.
+ *
+ * @example
+ * ```typescript
+ * if (isProjectInitialized('/my/project')) {
+ *   console.log('CLEO project found');
+ * }
+ * ```
  */
 export declare function isProjectInitialized(projectRoot?: string): boolean;
 /**
@@ -18,37 +32,132 @@ export declare function isProjectInitialized(projectRoot?: string): boolean;
  * Respects CLEO_HOME env var; otherwise uses the OS-appropriate data path
  * via env-paths (XDG_DATA_HOME on Linux, Library/Application Support on macOS,
  * %LOCALAPPDATA% on Windows).
+ *
+ * @returns Absolute path to the global CLEO data directory
+ *
+ * @remarks
+ * Delegates to `getPlatformPaths().data` which uses the `env-paths` package
+ * for XDG-compliant path resolution across operating systems.
+ *
+ * @example
+ * ```typescript
+ * const home = getCleoHome(); // e.g. "/home/user/.local/share/cleo"
+ * ```
  */
 export declare function getCleoHome(): string;
 /**
  * Get the global CLEO templates directory.
+ *
+ * @returns Absolute path to the templates directory under CLEO home
+ *
+ * @remarks
+ * Returns `{cleoHome}/templates` where CLEO-INJECTION.md and other global
+ * templates are stored.
+ *
+ * @example
+ * ```typescript
+ * const dir = getCleoTemplatesDir(); // e.g. "/home/user/.local/share/cleo/templates"
+ * ```
  */
 export declare function getCleoTemplatesDir(): string;
 /**
  * Get the global CLEO schemas directory.
+ *
+ * @returns Absolute path to the schemas directory under CLEO home
+ *
+ * @remarks
+ * Returns `{cleoHome}/schemas`. Note that schemas are typically read at
+ * runtime from the npm package root, not this global directory.
+ *
+ * @example
+ * ```typescript
+ * const dir = getCleoSchemasDir();
+ * ```
  */
 export declare function getCleoSchemasDir(): string;
 /**
  * Get the global CLEO docs directory.
+ *
+ * @returns Absolute path to the docs directory under CLEO home
+ *
+ * @remarks
+ * Returns `{cleoHome}/docs` for global documentation storage.
+ *
+ * @example
+ * ```typescript
+ * const dir = getCleoDocsDir();
+ * ```
  */
 export declare function getCleoDocsDir(): string;
 /**
  * Get the project CLEO data directory (relative).
  * Respects CLEO_DIR env var, defaults to ".cleo".
+ *
+ * @param cwd - Optional working directory; when provided, returns absolute path
+ * @returns Relative or absolute path to the project's .cleo directory
+ *
+ * @remarks
+ * If `cwd` is provided, delegates to `getCleoDirAbsolute`. Otherwise returns
+ * the `CLEO_DIR` env var or the default ".cleo" relative path.
+ *
+ * @example
+ * ```typescript
+ * const rel = getCleoDir();           // ".cleo"
+ * const abs = getCleoDir('/project'); // "/project/.cleo"
+ * ```
  */
 export declare function getCleoDir(cwd?: string): string;
 /**
  * Get the absolute path to the project CLEO directory.
+ *
+ * @param cwd - Optional working directory to resolve against; defaults to process.cwd()
+ * @returns Absolute path to the project's .cleo directory
+ *
+ * @remarks
+ * If CLEO_DIR is already absolute, returns it directly. Otherwise resolves
+ * it relative to the provided cwd or process.cwd().
+ *
+ * @example
+ * ```typescript
+ * const dir = getCleoDirAbsolute('/my/project'); // "/my/project/.cleo"
+ * ```
  */
 export declare function getCleoDirAbsolute(cwd?: string): string;
 /**
  * Get the project root from the CLEO directory.
  * Respects CLEO_ROOT env var, then derives from CLEO_DIR.
  * If CLEO_DIR is ".cleo", the project root is its parent.
+ *
+ * @param cwd - Optional working directory hint
+ * @returns Absolute path to the project root
+ *
+ * @remarks
+ * Resolution order: CLEO_ROOT env var (if no cwd), parent of the resolved
+ * .cleo directory (if it ends with /.cleo), or the cwd/process.cwd() fallback.
+ *
+ * @example
+ * ```typescript
+ * const root = getProjectRoot(); // "/home/user/projects/myapp"
+ * ```
  */
 export declare function getProjectRoot(cwd?: string): string;
 /**
  * Resolve a project-relative path to an absolute path.
+ *
+ * @param relativePath - Path to resolve (relative, absolute, or tilde-prefixed)
+ * @param cwd - Optional working directory for project root resolution
+ * @returns Absolute resolved path
+ *
+ * @remarks
+ * Returns absolute paths unchanged. Expands leading tilde (`~/`) to the user's
+ * home directory. Resolves other relative paths against the project root.
+ *
+ * @example
+ * ```typescript
+ * resolveProjectPath('src/index.ts');     // "/project/src/index.ts"
+ * resolveProjectPath('~/notes.md');       // "/home/user/notes.md"
+ * resolveProjectPath('/absolute/path');   // "/absolute/path"
+ * ```
  */
 export declare function resolveProjectPath(relativePath: string, cwd?: string): string;
 /**
@@ -63,32 +172,109 @@ export declare function resolveProjectPath(relativePath: string, cwd?: string):
  *     // NEW (correct):
  *     const accessor = await getAccessor(cwd);
  *     const data = await accessor.queryTasks({});
+ *
+ * @param cwd - Optional working directory for path resolution
+ * @returns Absolute path to the tasks.db file
+ *
+ * @remarks
+ * Returns `{cleoDir}/tasks.db`. Prefer `getAccessor()` for actual data access.
+ *
+ * @example
+ * ```typescript
+ * const dbPath = getTaskPath('/project');
+ * ```
  */
 export declare function getTaskPath(cwd?: string): string;
 /**
  * Get the path to the project's config.json file.
+ *
+ * @param cwd - Optional working directory for path resolution
+ * @returns Absolute path to the project config.json
+ *
+ * @remarks
+ * Returns `{cleoDir}/config.json`.
+ *
+ * @example
+ * ```typescript
+ * const configPath = getConfigPath('/project');
+ * ```
  */
 export declare function getConfigPath(cwd?: string): string;
 /**
  * Get the path to the project's sessions.json file.
+ *
+ * @param cwd - Optional working directory for path resolution
+ * @returns Absolute path to the sessions.json file
+ *
+ * @remarks
+ * Returns `{cleoDir}/sessions.json`.
+ *
+ * @example
+ * ```typescript
+ * const sessionsPath = getSessionsPath('/project');
+ * ```
  */
 export declare function getSessionsPath(cwd?: string): string;
 /**
  * Get the path to the project's archive file.
+ *
+ * @param cwd - Optional working directory for path resolution
+ * @returns Absolute path to the tasks-archive.json file
+ *
+ * @remarks
+ * Returns `{cleoDir}/tasks-archive.json` where archived tasks are stored.
+ *
+ * @example
+ * ```typescript
+ * const archivePath = getArchivePath('/project');
+ * ```
  */
 export declare function getArchivePath(cwd?: string): string;
 /**
  * Get the path to the project's log file.
  * Canonical structured runtime log path (pino).
+ *
+ * @param cwd - Optional working directory for path resolution
+ * @returns Absolute path to the cleo.log file
+ *
+ * @remarks
+ * Returns `{cleoDir}/logs/cleo.log`. Used by pino for structured JSON logging.
+ *
+ * @example
+ * ```typescript
+ * const logPath = getLogPath('/project');
+ * ```
+ *
  * @task T4644
  */
 export declare function getLogPath(cwd?: string): string;
 /**
  * Get the backup directory for operational backups.
+ *
+ * @param cwd - Optional working directory for path resolution
+ * @returns Absolute path to the operational backups directory
+ *
+ * @remarks
+ * Returns `{cleoDir}/backups/operational`.
+ *
+ * @example
+ * ```typescript
+ * const backupDir = getBackupDir('/project');
+ * ```
  */
 export declare function getBackupDir(cwd?: string): string;
 /**
  * Get the global config file path.
+ *
+ * @returns Absolute path to the global config.json in CLEO home
+ *
+ * @remarks
+ * Returns `{cleoHome}/config.json` for global CLEO configuration.
+ *
+ * @example
+ * ```typescript
+ * const globalConfig = getGlobalConfigPath();
+ * ```
  */
 export declare function getGlobalConfigPath(): string;
 /**
@@ -100,11 +286,36 @@ export declare function getGlobalConfigPath(): string;
  *   3. config.directories.agentOutputs (deprecated)
  *   4. Default: '.cleo/agent-outputs'
  *
+ * @param cwd - Optional working directory for path resolution
+ * @returns Relative or absolute path to the agent outputs directory
+ *
+ * @remarks
+ * Checks config fields in priority order: `agentOutputs.directory`, `research.outputDir`,
+ * `directories.agentOutputs`. Falls back to `.cleo/agent-outputs`.
+ *
+ * @example
+ * ```typescript
+ * const dir = getAgentOutputsDir('/project');
+ * ```
+ *
  * @task T4700
  */
 export declare function getAgentOutputsDir(cwd?: string): string;
 /**
  * Get the absolute path to the agent outputs directory.
+ *
+ * @param cwd - Optional working directory for path resolution
+ * @returns Absolute path to the agent outputs directory
+ *
+ * @remarks
+ * Resolves the output of `getAgentOutputsDir()` against the project root
+ * if it is not already absolute.
+ *
+ * @example
+ * ```typescript
+ * const absDir = getAgentOutputsAbsolute('/project');
+ * ```
+ *
  * @task T4700
  */
 export declare function getAgentOutputsAbsolute(cwd?: string): string;
@@ -114,35 +325,113 @@ export declare function getAgentOutputsAbsolute(cwd?: string): string;
  * Checks config.agentOutputs.manifestFile for custom filename,
  * defaults to 'MANIFEST.jsonl'.
  *
+ * @param cwd - Optional working directory for path resolution
+ * @returns Absolute path to the MANIFEST.jsonl file
+ *
+ * @remarks
+ * Checks `config.agentOutputs.manifestFile` for a custom filename,
+ * defaults to `MANIFEST.jsonl` in the agent outputs directory.
+ *
+ * @example
+ * ```typescript
+ * const manifestPath = getManifestPath('/project');
+ * ```
+ *
  * @task T4700
  */
 export declare function getManifestPath(cwd?: string): string;
 /**
  * Get the absolute path to the MANIFEST.archive.jsonl file.
+ *
+ * @param cwd - Optional working directory for path resolution
+ * @returns Absolute path to the MANIFEST.archive.jsonl file
+ *
+ * @remarks
+ * Returns the archive manifest path in the agent outputs directory.
+ *
+ * @example
+ * ```typescript
+ * const archivePath = getManifestArchivePath('/project');
+ * ```
+ *
  * @task T4700
  */
 export declare function getManifestArchivePath(cwd?: string): string;
 /**
  * Check if a path is absolute (POSIX or Windows).
+ *
+ * @param path - Filesystem path to check
+ * @returns True if the path is absolute on any supported OS
+ *
+ * @remarks
+ * Recognizes POSIX absolute paths (`/...`), Windows drive letters (`C:\...`),
+ * and UNC paths (`\\...`).
+ *
+ * @example
+ * ```typescript
+ * isAbsolutePath('/usr/bin');    // true
+ * isAbsolutePath('C:\\Users');   // true
+ * isAbsolutePath('./relative'); // false
+ * ```
  */
 export declare function isAbsolutePath(path: string): boolean;
 /**
  * Get the OS log directory for CLEO global logs.
  * Linux: ~/.local/state/cleo | macOS: ~/Library/Logs/cleo | Windows: %LOCALAPPDATA%\cleo\Log
+ *
+ * @returns Absolute path to the OS-appropriate log directory
+ *
+ * @remarks
+ * Delegates to `getPlatformPaths().log` for XDG-compliant resolution.
+ *
+ * @example
+ * ```typescript
+ * const logDir = getCleoLogDir();
+ * ```
  */
 export declare function getCleoLogDir(): string;
 /**
  * Get the OS cache directory for CLEO.
  * Linux: ~/.cache/cleo | macOS: ~/Library/Caches/cleo | Windows: %LOCALAPPDATA%\cleo\Cache
+ *
+ * @returns Absolute path to the OS-appropriate cache directory
+ *
+ * @remarks
+ * Delegates to `getPlatformPaths().cache` for XDG-compliant resolution.
+ *
+ * @example
+ * ```typescript
+ * const cacheDir = getCleoCacheDir();
+ * ```
  */
 export declare function getCleoCacheDir(): string;
 /**
  * Get the OS temp directory for CLEO ephemeral files.
+ *
+ * @returns Absolute path to the OS-appropriate temp directory
+ *
+ * @remarks
+ * Delegates to `getPlatformPaths().temp` for platform-specific resolution.
+ *
+ * @example
+ * ```typescript
+ * const tempDir = getCleoTempDir();
+ * ```
  */
 export declare function getCleoTempDir(): string;
 /**
  * Get the OS config directory for CLEO.
  * Linux: ~/.config/cleo | macOS: ~/Library/Preferences/cleo | Windows: %APPDATA%\cleo\Config
+ *
+ * @returns Absolute path to the OS-appropriate config directory
+ *
+ * @remarks
+ * Delegates to `getPlatformPaths().config` for XDG-compliant resolution.
+ *
+ * @example
+ * ```typescript
+ * const configDir = getCleoConfigDir();
+ * ```
  */
 export declare function getCleoConfigDir(): string;
 /**
@@ -154,23 +443,67 @@ export declare function getCleoConfigDir(): string;
  * Linux:   ~/.local/share/cleo/templates
  * macOS:   ~/Library/Application Support/cleo/templates
  * Windows: ~/AppData/Local/cleo/Data/templates (approximate)
+ *
+ * @returns Tilde-prefixed path like "~/.local/share/cleo/templates"
+ *
+ * @remarks
+ * Returns the absolute path if the home directory is not a prefix
+ * (unlikely but handled). Always uses forward slashes after the tilde
+ * for cross-platform compatibility in `@`-reference resolution.
+ *
+ * @example
+ * ```typescript
+ * const tildePath = getCleoTemplatesTildePath();
+ * // "~/.local/share/cleo/templates"
+ * ```
  */
 export declare function getCleoTemplatesTildePath(): string;
 /**
  * Get the global agents hub directory.
  * Respects AGENTS_HOME env var, defaults to ~/.agents.
+ *
+ * @returns Absolute path to the agents hub directory
+ *
+ * @remarks
+ * Returns `AGENTS_HOME` env var if set, otherwise `~/.agents`.
+ *
+ * @example
+ * ```typescript
+ * const agentsHome = getAgentsHome(); // "/home/user/.agents"
+ * ```
  */
 export declare function getAgentsHome(): string;
 /**
  * Get the Claude Code agents directory (~/.claude/agents by default).
+ *
+ * @returns Absolute path to the Claude agents directory
+ *
+ * @remarks
+ * Respects `CLAUDE_HOME` env var for the parent directory.
+ *
+ * @example
+ * ```typescript
+ * const dir = getClaudeAgentsDir();
+ * ```
+ *
  * @deprecated Use AdapterPathProvider.getAgentInstallDir() from the active adapter instead.
  */
 export declare function getClaudeAgentsDir(): string;
 /**
  * Get the claude-mem SQLite database path.
- * @deprecated Use AdapterPathProvider.getMemoryDbPath() from the active adapter instead.
- * Respects CLAUDE_MEM_DB env var, defaults to ~/.claude-mem/claude-mem.db.
+ *
+ * @returns Absolute path to the claude-mem.db file
+ *
+ * @remarks
+ * Respects `CLAUDE_MEM_DB` env var, defaults to `~/.claude-mem/claude-mem.db`.
  * This is a third-party tool path; homedir() is correct here (no env-paths standard).
+ *
+ * @example
+ * ```typescript
+ * const dbPath = getClaudeMemDbPath();
+ * ```
+ *
+ * @deprecated Use AdapterPathProvider.getMemoryDbPath() from the active adapter instead.
  */
 export declare function getClaudeMemDbPath(): string;
 //# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAIlE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CASnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAS7E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAQD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAgCvD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAM5D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAmBpD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAI3D;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQpD;AAMD;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAOlD;AAMD;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"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"}

package/dist/routing/capability-matrix.d.ts

@@ -10,7 +10,6 @@
  * - hybrid: Can run either way (prefers CLI when available)
  *
  * preferredChannel encodes token-efficiency routing (from routing-table.ts):
- * - mcp: Lower overhead (no CLI startup), direct DB access, structured JSON
  * - cli: Human-readable output, shell integration, interactive prompts
  * - either: No significant difference or context-dependent
  *
@@ -29,9 +28,10 @@ export type ExecutionMode = 'native' | 'cli' | 'hybrid';
 export type GatewayType = 'query' | 'mutate';
 /**
  * Preferred communication channel for token efficiency.
- * Added for provider-agnostic skill routing (@task T5240).
+ * CLI is the only dispatch channel.
+ * @task T5240
  */
-export type PreferredChannel = 'mcp' | 'cli' | 'either';
+export type PreferredChannel = 'cli' | 'either';
 export interface OperationCapability {
     domain: string;
     operation: string;

package/dist/routing/capability-matrix.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capability-matrix.d.ts","sourceRoot":"","sources":["../../src/routing/capability-matrix.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,aAAa,CAAC;IACpB,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CACb,MAAM,EACN;QACE,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,GAAG,EAAE,MAAM,EAAE,CAAC;QACd,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CACF,CAAC;CACH;AAs9CD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,GACnB,aAAa,GAAG,SAAS,CAK3B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAG/F;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAG5F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAIzE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,gBAAgB,CAkB3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAAC,mBAAmB,CAAC,CAExE"}
+{"version":3,"file":"capability-matrix.d.ts","sourceRoot":"","sources":["../../src/routing/capability-matrix.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE7C;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEhD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,aAAa,CAAC;IACpB,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CACb,MAAM,EACN;QACE,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,GAAG,EAAE,MAAM,EAAE,CAAC;QACd,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CACF,CAAC;CACH;AAs9CD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,GACnB,aAAa,GAAG,SAAS,CAK3B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAG/F;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAG5F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAIzE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,gBAAgB,CAkB3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAAC,mBAAmB,CAAC,CAExE"}