@cleocode/core 2026.5.134 → 2026.6.1

package/dist/shutdown.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Coordinated process-lifetime teardown for short-lived CLI invocations.
+ *
+ * ## Why this exists (T11568 — post-E6 process hang)
+ *
+ * The CLEO CLI's success path does NOT call `process.exit()` — it emits the
+ * LAFS envelope and returns, relying on the libuv event loop draining naturally
+ * so the process exits with code 0 (see `runMainWithLafsEnvelope` in
+ * `packages/cleo/src/cli/index.ts`). That contract only holds while every
+ * resource opened during the command is released by the time the handler
+ * resolves.
+ *
+ * Three process-lifetime singletons violate that contract because they own a
+ * `worker_threads.Worker` whose `MessagePort` keeps the event loop alive:
+ *
+ *   1. **The BRAIN single-writer worker** ({@link shutdownBrainWriter}). Every
+ *      hot-path write to `brain.db` (`cleo memory observe`, decisions, the
+ *      dialectic pipeline) is funneled through a `worker_threads.Worker`
+ *      (T10351). The worker is created lazily on first write and registered for
+ *      a `process.on('exit')` flush — but that exit handler can never fire
+ *      because the worker's `MessagePort` is itself what keeps the loop alive,
+ *      so a `cleo memory observe` printed its success envelope and then hung
+ *      (rc:124) until the shell timed it out.
+ *   2. **The embedding queue worker** ({@link resetEmbeddingQueue}). The
+ *      {@link EmbeddingQueue} singleton (T134/T137) lazily spawns a
+ *      `worker_threads.Worker` to batch transformers.js embeddings off the main
+ *      thread. Its live `MessagePort` keeps the loop alive exactly like the
+ *      brain writer — and the opportunistic dream in `cleo briefing` could feed
+ *      it (or, in the worker-unavailable fallback, run embeddings inline on the
+ *      main thread), the residual hang/spin path tracked in T11655.
+ *   3. **The pino-roll log transport** ({@link closeLogger}). `pino.transport()`
+ *      backs a worker thread too; its rotation timer + port keep the loop alive
+ *      in the same way once `initLogger` has run.
+ *
+ * Installed builds where the worker file was not resolvable fell back to the
+ * inline executor (no worker) and exited cleanly — masking the defect until the
+ * E6 build shipped a resolvable `brain-writer-worker.js`.
+ *
+ * {@link shutdownCliRuntime} is the single chokepoint the CLI calls from its
+ * success-path `finally` (after the envelope has been written to stdout) so the
+ * loop can drain and the process exits rc:0. It is best-effort and idempotent:
+ * every teardown is wrapped so one failure cannot mask another, and calling it
+ * twice is a no-op for already-closed handles.
+ *
+ * This is NOT a `process.exit()` band-aid: the established CLI exit contract is
+ * "drain the loop, then exit". Forcing teardown of the long-lived handles
+ * restores that contract instead of papering over it. Mid-operation handles
+ * (shared dual-scope `cleo.db`) are released here too, honoring the L4/L5
+ * shared-handle rule that they close at PROCESS EXIT, not mid-operation.
+ *
+ * @module
+ * @task T11568
+ */
+/**
+ * Tear down every process-lifetime resource that would otherwise keep the libuv
+ * event loop alive after a short-lived CLI command resolves.
+ *
+ * Call this from the CLI's success-path `finally`, AFTER the command's LAFS
+ * envelope has been emitted to stdout. The CLI does not `process.exit()` on
+ * success (ADR-039 / T9633), so without this the brain-writer worker thread
+ * (T10351) or the pino-roll transport worker can keep the process hanging at
+ * rc:124.
+ *
+ * Order:
+ *   1. {@link shutdownBrainWriter} — terminate the BRAIN single-writer worker
+ *      thread (the `MessagePort` proven to hang `cleo memory observe`).
+ *   2. {@link resetEmbeddingQueue} — flush + terminate the embedding queue
+ *      worker thread (T11655 — the second live `MessagePort` that can keep a
+ *      one-shot CLI command alive after its envelope is emitted).
+ *   3. {@link closeAllDatabases} — close the dual-scope `cleo.db` + brain/nexus
+ *      native handles (releases file locks; required on Windows).
+ *   4. {@link closeLogger} — flush + terminate the pino-roll transport worker.
+ *
+ * Every step is best-effort and idempotent — safe to call once per process at
+ * exit, and harmless if a given subsystem was never initialized.
+ *
+ * @returns A promise that resolves once all teardown steps have settled.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await runCommand(cmd, { rawArgs });
+ * } finally {
+ *   await shutdownCliRuntime();
+ * }
+ * ```
+ *
+ * @task T11568
+ */
+export declare function shutdownCliRuntime(): Promise<void>;
+//# sourceMappingURL=shutdown.d.ts.map

package/dist/shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../src/shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAmBH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAgBxD"}

package/dist/shutdown.js

@@ -0,0 +1,120 @@
+/**
+ * Coordinated process-lifetime teardown for short-lived CLI invocations.
+ *
+ * ## Why this exists (T11568 — post-E6 process hang)
+ *
+ * The CLEO CLI's success path does NOT call `process.exit()` — it emits the
+ * LAFS envelope and returns, relying on the libuv event loop draining naturally
+ * so the process exits with code 0 (see `runMainWithLafsEnvelope` in
+ * `packages/cleo/src/cli/index.ts`). That contract only holds while every
+ * resource opened during the command is released by the time the handler
+ * resolves.
+ *
+ * Three process-lifetime singletons violate that contract because they own a
+ * `worker_threads.Worker` whose `MessagePort` keeps the event loop alive:
+ *
+ *   1. **The BRAIN single-writer worker** ({@link shutdownBrainWriter}). Every
+ *      hot-path write to `brain.db` (`cleo memory observe`, decisions, the
+ *      dialectic pipeline) is funneled through a `worker_threads.Worker`
+ *      (T10351). The worker is created lazily on first write and registered for
+ *      a `process.on('exit')` flush — but that exit handler can never fire
+ *      because the worker's `MessagePort` is itself what keeps the loop alive,
+ *      so a `cleo memory observe` printed its success envelope and then hung
+ *      (rc:124) until the shell timed it out.
+ *   2. **The embedding queue worker** ({@link resetEmbeddingQueue}). The
+ *      {@link EmbeddingQueue} singleton (T134/T137) lazily spawns a
+ *      `worker_threads.Worker` to batch transformers.js embeddings off the main
+ *      thread. Its live `MessagePort` keeps the loop alive exactly like the
+ *      brain writer — and the opportunistic dream in `cleo briefing` could feed
+ *      it (or, in the worker-unavailable fallback, run embeddings inline on the
+ *      main thread), the residual hang/spin path tracked in T11655.
+ *   3. **The pino-roll log transport** ({@link closeLogger}). `pino.transport()`
+ *      backs a worker thread too; its rotation timer + port keep the loop alive
+ *      in the same way once `initLogger` has run.
+ *
+ * Installed builds where the worker file was not resolvable fell back to the
+ * inline executor (no worker) and exited cleanly — masking the defect until the
+ * E6 build shipped a resolvable `brain-writer-worker.js`.
+ *
+ * {@link shutdownCliRuntime} is the single chokepoint the CLI calls from its
+ * success-path `finally` (after the envelope has been written to stdout) so the
+ * loop can drain and the process exits rc:0. It is best-effort and idempotent:
+ * every teardown is wrapped so one failure cannot mask another, and calling it
+ * twice is a no-op for already-closed handles.
+ *
+ * This is NOT a `process.exit()` band-aid: the established CLI exit contract is
+ * "drain the loop, then exit". Forcing teardown of the long-lived handles
+ * restores that contract instead of papering over it. Mid-operation handles
+ * (shared dual-scope `cleo.db`) are released here too, honoring the L4/L5
+ * shared-handle rule that they close at PROCESS EXIT, not mid-operation.
+ *
+ * @module
+ * @task T11568
+ */
+import { closeLogger } from './logger.js';
+import { shutdownBrainWriter } from './memory/brain-writer-thread.js';
+import { resetEmbeddingQueue } from './memory/embedding-queue.js';
+import { closeAllDatabases } from './store/sqlite.js';
+/**
+ * Run a teardown step, swallowing any error so a single failure cannot abort
+ * the remaining teardown steps. Best-effort by design.
+ */
+async function safely(step) {
+    try {
+        await step();
+    }
+    catch {
+        // Best-effort teardown — never let cleanup throw out of the CLI exit path.
+    }
+}
+/**
+ * Tear down every process-lifetime resource that would otherwise keep the libuv
+ * event loop alive after a short-lived CLI command resolves.
+ *
+ * Call this from the CLI's success-path `finally`, AFTER the command's LAFS
+ * envelope has been emitted to stdout. The CLI does not `process.exit()` on
+ * success (ADR-039 / T9633), so without this the brain-writer worker thread
+ * (T10351) or the pino-roll transport worker can keep the process hanging at
+ * rc:124.
+ *
+ * Order:
+ *   1. {@link shutdownBrainWriter} — terminate the BRAIN single-writer worker
+ *      thread (the `MessagePort` proven to hang `cleo memory observe`).
+ *   2. {@link resetEmbeddingQueue} — flush + terminate the embedding queue
+ *      worker thread (T11655 — the second live `MessagePort` that can keep a
+ *      one-shot CLI command alive after its envelope is emitted).
+ *   3. {@link closeAllDatabases} — close the dual-scope `cleo.db` + brain/nexus
+ *      native handles (releases file locks; required on Windows).
+ *   4. {@link closeLogger} — flush + terminate the pino-roll transport worker.
+ *
+ * Every step is best-effort and idempotent — safe to call once per process at
+ * exit, and harmless if a given subsystem was never initialized.
+ *
+ * @returns A promise that resolves once all teardown steps have settled.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await runCommand(cmd, { rawArgs });
+ * } finally {
+ *   await shutdownCliRuntime();
+ * }
+ * ```
+ *
+ * @task T11568
+ */
+export async function shutdownCliRuntime() {
+    // 1. BRAIN single-writer worker thread — the live MessagePort that hangs
+    //    `cleo memory observe` / `cleo docs add` / any brain.db write path.
+    await safely(() => shutdownBrainWriter());
+    // 2. Embedding queue worker thread (T11655) — the second live MessagePort.
+    //    Flushes in-flight batches then terminates the worker, so an opportunistic
+    //    embed enqueued during the command cannot keep the loop alive at exit.
+    await safely(() => resetEmbeddingQueue());
+    // 3. Close DB singletons (dual-scope cleo.db + brain/nexus native handles).
+    //    Releases SQLite file handles — required before tmpdir cleanup on Windows.
+    await safely(() => closeAllDatabases());
+    // 4. Flush + terminate the pino-roll transport worker thread.
+    await safely(() => closeLogger());
+}
+//# sourceMappingURL=shutdown.js.map

package/dist/shutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.js","sourceRoot":"","sources":["../src/shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;GAGG;AACH,KAAK,UAAU,MAAM,CAAC,IAAgC;IACpD,IAAI,CAAC;QACH,MAAM,IAAI,EAAE,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;IAC7E,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,yEAAyE;IACzE,wEAAwE;IACxE,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAE1C,2EAA2E;IAC3E,+EAA+E;IAC/E,2EAA2E;IAC3E,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAE1C,4EAA4E;IAC5E,+EAA+E;IAC/E,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAExC,8DAA8D;IAC9D,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/dist/skills/index.d.ts

@@ -45,6 +45,8 @@ export { analyzeDependencies, generateHitlSummary, getContextState, getNextTask,
 export { validateManifestIntegrity, validateOrchestratorCompliance, validateSubagentOutput, verifyCompliance, } from './orchestrator/validator.js';
 export type { CommandRunner, ProposeCanonicalPatchArgs, ProposeCanonicalPatchDryRun, ProposeCanonicalPatchErrorCode, ProposeCanonicalPatchFailure, ProposeCanonicalPatchOk, ProposeCanonicalPatchResult, } from './propose-patch.js';
 export { proposeCanonicalPatch } from './propose-patch.js';
+export type { SkillExecutorAdapterOptions, SkillRunner, } from './skill-executor-adapter.js';
+export { defaultSkillRunner, SkillExecutorAdapter } from './skill-executor-adapter.js';
 export type { SkillSearchPath as MultiSourceSkillSearchPath, SkillSourceMode, SkillSourceType, } from './skill-paths.js';
 export { getSkillSearchPaths as getMultiSourceSkillPaths, getSkillSourceType, resolveProtocolPath, resolveSharedPath, resolveSkillPath, } from './skill-paths.js';
 export type { IsCanonicalOptions, SkillSourceType as SkillRootSourceType } from './skill-root.js';

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

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

package/dist/skills/index.js

@@ -41,6 +41,7 @@ export { buildPrompt, canParallelize, spawn, spawnBatch } from './orchestrator/s
 export { analyzeDependencies, generateHitlSummary, getContextState, getNextTask, getReadyTasks, getThresholds, sessionInit, shouldPause, } from './orchestrator/startup.js';
 export { validateManifestIntegrity, validateOrchestratorCompliance, validateSubagentOutput, verifyCompliance, } from './orchestrator/validator.js';
 export { proposeCanonicalPatch } from './propose-patch.js';
+export { defaultSkillRunner, SkillExecutorAdapter } from './skill-executor-adapter.js';
 // Skill paths (multi-source resolver)
 export { getSkillSearchPaths as getMultiSourceSkillPaths, getSkillSourceType, resolveProtocolPath, resolveSharedPath, resolveSkillPath, } from './skill-paths.js';
 export { AGENTS_SKILLS_BRIDGE_PATH, CLAUDE_SKILLS_AGENTS_SHARED_PATH, is_canonical, resolveSkillsRoot, } from './skill-root.js';

package/dist/skills/index.js.map

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

package/dist/skills/skill-executor-adapter.d.ts

@@ -0,0 +1,136 @@
+/**
+ * `SkillExecutorAdapter` — concrete in-process implementation of the
+ * Dependency-Inversion seam declared in
+ * `@cleocode/contracts/tools/skill-executor` ({@link SkillExecutor}).
+ *
+ * ## What it does (T11477 acceptance)
+ *
+ * - **AC1** — resolves a `ct-*` skill by id (via {@link findSkill}, the existing
+ *   in-process discovery mechanism) and runs it over the injected
+ *   {@link GuardedToolSurface}, returning a `{ status, output, error }` envelope.
+ * - **AC4** — the skill→tool joint is **in-process**: the adapter loads the skill
+ *   definition and exercises the guarded primitives directly. There is NO
+ *   process boundary between resolving the skill and touching the tools — the
+ *   subprocess-spawn path (`orchestrateSpawnExecute`) is reserved for isolation
+ *   nodes and is wired separately (see {@link createSkillNodeExecutor}).
+ *
+ * ## Why a DIP adapter (not a direct import)
+ *
+ * The skill dispatcher (`CoreAgentDispatcher`, a high-level orchestration
+ * concern) depends on the abstract {@link SkillExecutor} interface, NOT on this
+ * concrete class. This adapter is INJECTED as
+ * `CoreAgentDispatcherOptions.executor` so the dispatch policy and the execution
+ * mechanism both depend on the contract, not on each other — the classic
+ * Dependency-Inversion move (T11476 charter).
+ *
+ * ## Execution model + extension point
+ *
+ * `SkillExecutorAdapter.execute()` resolves the skill, validates it exists, and
+ * runs the supplied {@link SkillRunner} over the guarded tool surface. The
+ * default runner ({@link defaultSkillRunner}) loads the skill content
+ * in-process and records resolution metadata — a deterministic, side-effect-free
+ * baseline that wires the seam end-to-end without booting an LLM/GenKit flow.
+ * The actual model-driven execution (GenKit phase, P1) plugs in here by passing
+ * a richer {@link SkillRunner} — the seam, routing, and tool injection are all
+ * already in place.
+ *
+ * @epic T11391
+ * @task T11477
+ * @saga T11387
+ * @see ./skill-executor-adapter.ts — this file
+ * @see @cleocode/contracts/tools/skill-executor — the DIP abstraction
+ */
+import type { SkillExecuteInput, SkillExecuteResult, SkillExecutor } from '@cleocode/contracts/tools/skill-executor';
+import type { Skill } from './types.js';
+/**
+ * Pluggable strategy that performs the actual in-process work for a resolved
+ * skill over the guarded tool surface.
+ *
+ * The {@link SkillExecutorAdapter} owns resolution + the success/failure
+ * envelope; the runner owns "what running this skill means". This keeps the
+ * adapter open for extension (a future GenKit/LLM runner) and closed for
+ * modification (the DIP seam, routing, and tool injection never change) —
+ * Open/Closed Principle.
+ *
+ * @param skill - The resolved skill definition (frontmatter + content).
+ * @param input - The original execution envelope (skill id, context, tools).
+ * @returns The terminal {@link SkillExecuteResult} for this execution.
+ */
+export type SkillRunner = (skill: Skill, input: SkillExecuteInput) => Promise<SkillExecuteResult>;
+/**
+ * Default in-process skill runner.
+ *
+ * Loads the resolved skill in-process and returns a success envelope carrying
+ * resolution metadata (skill id, directory, frontmatter name/protocol). It is
+ * deterministic and performs no model inference — the baseline execution path
+ * that proves the skill→tool joint is in-process and lets callers (tests,
+ * dry-run playbook traversals) assert against a stable shape.
+ *
+ * It is the documented EXTENSION POINT: a model-driven runner (GenKit phase)
+ * sequences the atomic tool primitives via `input.tools` and returns its own
+ * `output` — without changing the adapter, the DIP seam, or the dispatcher
+ * wiring.
+ *
+ * @param skill - The resolved skill definition.
+ * @param input - The original execution envelope.
+ * @returns A success envelope with resolution metadata in `output`.
+ */
+export declare const defaultSkillRunner: SkillRunner;
+/**
+ * Options accepted by {@link SkillExecutorAdapter}.
+ *
+ * @task T11477
+ */
+export interface SkillExecutorAdapterOptions {
+    /**
+     * Working directory used to resolve the skill search paths (project-custom,
+     * agent-skills, marketplace). Defaults to the process cwd via {@link findSkill}.
+     */
+    readonly cwd?: string;
+    /**
+     * Strategy that performs the actual in-process execution of a resolved skill.
+     * Defaults to {@link defaultSkillRunner}. The GenKit-phase model runner is
+     * supplied here without touching the adapter or the DIP seam.
+     */
+    readonly runner?: SkillRunner;
+}
+/**
+ * Concrete in-process implementation of the {@link SkillExecutor} DIP seam.
+ *
+ * Resolves a `ct-*` skill by id and runs it over the injected
+ * {@link GuardedToolSurface} — no subprocess, no process boundary (AC4). The
+ * dispatcher depends on the {@link SkillExecutor} abstraction and receives this
+ * adapter by injection (AC2).
+ *
+ * @example
+ * ```ts
+ * const adapter = new SkillExecutorAdapter({ cwd: projectRoot });
+ * const tools = createToolGuard({ allowedRoots: [projectRoot] });
+ * const result = await adapter.execute({ skillId: 'ct-validator', context: {}, tools });
+ * // result.status === 'success' when the skill resolves in-process
+ * ```
+ *
+ * @task T11477
+ */
+export declare class SkillExecutorAdapter implements SkillExecutor {
+    private readonly cwd;
+    private readonly runner;
+    /**
+     * @param opts - Resolution cwd and an optional in-process runner strategy.
+     */
+    constructor(opts?: SkillExecutorAdapterOptions);
+    /**
+     * Resolve `input.skillId` to a `ct-*` skill and run it in-process over the
+     * injected guarded tool surface.
+     *
+     * Returns `status: 'failure'` (never throws) when the skill cannot be
+     * resolved or the runner rejects — mirroring the playbook runtime's
+     * non-throwing dispatch contract so retry / escalation semantics stay intact.
+     *
+     * @param input - Skill identity, accumulated context, and the guarded tool
+     *   surface the skill is permitted to use.
+     * @returns The terminal {@link SkillExecuteResult}.
+     */
+    execute(input: SkillExecuteInput): Promise<SkillExecuteResult>;
+}
+//# sourceMappingURL=skill-executor-adapter.d.ts.map

package/dist/skills/skill-executor-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-executor-adapter.d.ts","sourceRoot":"","sources":["../../src/skills/skill-executor-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,KAAK,EAEV,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACd,MAAM,0CAA0C,CAAC;AAGlD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAIxC;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAElG;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAgBhC,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IAErC;;OAEG;gBACS,IAAI,GAAE,2BAAgC;IAKlD;;;;;;;;;;;OAWG;IACU,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAgB5E"}

package/dist/skills/skill-executor-adapter.js

@@ -0,0 +1,137 @@
+/**
+ * `SkillExecutorAdapter` — concrete in-process implementation of the
+ * Dependency-Inversion seam declared in
+ * `@cleocode/contracts/tools/skill-executor` ({@link SkillExecutor}).
+ *
+ * ## What it does (T11477 acceptance)
+ *
+ * - **AC1** — resolves a `ct-*` skill by id (via {@link findSkill}, the existing
+ *   in-process discovery mechanism) and runs it over the injected
+ *   {@link GuardedToolSurface}, returning a `{ status, output, error }` envelope.
+ * - **AC4** — the skill→tool joint is **in-process**: the adapter loads the skill
+ *   definition and exercises the guarded primitives directly. There is NO
+ *   process boundary between resolving the skill and touching the tools — the
+ *   subprocess-spawn path (`orchestrateSpawnExecute`) is reserved for isolation
+ *   nodes and is wired separately (see {@link createSkillNodeExecutor}).
+ *
+ * ## Why a DIP adapter (not a direct import)
+ *
+ * The skill dispatcher (`CoreAgentDispatcher`, a high-level orchestration
+ * concern) depends on the abstract {@link SkillExecutor} interface, NOT on this
+ * concrete class. This adapter is INJECTED as
+ * `CoreAgentDispatcherOptions.executor` so the dispatch policy and the execution
+ * mechanism both depend on the contract, not on each other — the classic
+ * Dependency-Inversion move (T11476 charter).
+ *
+ * ## Execution model + extension point
+ *
+ * `SkillExecutorAdapter.execute()` resolves the skill, validates it exists, and
+ * runs the supplied {@link SkillRunner} over the guarded tool surface. The
+ * default runner ({@link defaultSkillRunner}) loads the skill content
+ * in-process and records resolution metadata — a deterministic, side-effect-free
+ * baseline that wires the seam end-to-end without booting an LLM/GenKit flow.
+ * The actual model-driven execution (GenKit phase, P1) plugs in here by passing
+ * a richer {@link SkillRunner} — the seam, routing, and tool injection are all
+ * already in place.
+ *
+ * @epic T11391
+ * @task T11477
+ * @saga T11387
+ * @see ./skill-executor-adapter.ts — this file
+ * @see @cleocode/contracts/tools/skill-executor — the DIP abstraction
+ */
+import { getLogger } from '../logger.js';
+import { findSkill } from './discovery.js';
+const log = getLogger('skill-executor-adapter');
+/**
+ * Default in-process skill runner.
+ *
+ * Loads the resolved skill in-process and returns a success envelope carrying
+ * resolution metadata (skill id, directory, frontmatter name/protocol). It is
+ * deterministic and performs no model inference — the baseline execution path
+ * that proves the skill→tool joint is in-process and lets callers (tests,
+ * dry-run playbook traversals) assert against a stable shape.
+ *
+ * It is the documented EXTENSION POINT: a model-driven runner (GenKit phase)
+ * sequences the atomic tool primitives via `input.tools` and returns its own
+ * `output` — without changing the adapter, the DIP seam, or the dispatcher
+ * wiring.
+ *
+ * @param skill - The resolved skill definition.
+ * @param input - The original execution envelope.
+ * @returns A success envelope with resolution metadata in `output`.
+ */
+export const defaultSkillRunner = async (skill, input) => {
+    // The guarded tool surface is in-process and ready; the baseline runner does
+    // not perform side effects, but the binding is asserted so the seam is real.
+    const _tools = input.tools;
+    void _tools;
+    return {
+        status: 'success',
+        output: {
+            skillId: input.skillId,
+            resolved: true,
+            dirName: skill.dirName,
+            skillName: skill.frontmatter.name,
+            ...(skill.frontmatter.protocol !== undefined ? { protocol: skill.frontmatter.protocol } : {}),
+        },
+    };
+};
+/**
+ * Concrete in-process implementation of the {@link SkillExecutor} DIP seam.
+ *
+ * Resolves a `ct-*` skill by id and runs it over the injected
+ * {@link GuardedToolSurface} — no subprocess, no process boundary (AC4). The
+ * dispatcher depends on the {@link SkillExecutor} abstraction and receives this
+ * adapter by injection (AC2).
+ *
+ * @example
+ * ```ts
+ * const adapter = new SkillExecutorAdapter({ cwd: projectRoot });
+ * const tools = createToolGuard({ allowedRoots: [projectRoot] });
+ * const result = await adapter.execute({ skillId: 'ct-validator', context: {}, tools });
+ * // result.status === 'success' when the skill resolves in-process
+ * ```
+ *
+ * @task T11477
+ */
+export class SkillExecutorAdapter {
+    cwd;
+    runner;
+    /**
+     * @param opts - Resolution cwd and an optional in-process runner strategy.
+     */
+    constructor(opts = {}) {
+        this.cwd = opts.cwd;
+        this.runner = opts.runner ?? defaultSkillRunner;
+    }
+    /**
+     * Resolve `input.skillId` to a `ct-*` skill and run it in-process over the
+     * injected guarded tool surface.
+     *
+     * Returns `status: 'failure'` (never throws) when the skill cannot be
+     * resolved or the runner rejects — mirroring the playbook runtime's
+     * non-throwing dispatch contract so retry / escalation semantics stay intact.
+     *
+     * @param input - Skill identity, accumulated context, and the guarded tool
+     *   surface the skill is permitted to use.
+     * @returns The terminal {@link SkillExecuteResult}.
+     */
+    async execute(input) {
+        const skill = findSkill(input.skillId, this.cwd);
+        if (skill === null) {
+            const error = `skill "${input.skillId}" not found in any skill search path`;
+            log.warn({ skillId: input.skillId }, error);
+            return { status: 'failure', output: {}, error };
+        }
+        try {
+            return await this.runner(skill, input);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err.message : String(err);
+            log.warn({ skillId: input.skillId, error }, 'skill runner threw');
+            return { status: 'failure', output: {}, error };
+        }
+    }
+}
+//# sourceMappingURL=skill-executor-adapter.js.map

package/dist/skills/skill-executor-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-executor-adapter.js","sourceRoot":"","sources":["../../src/skills/skill-executor-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAQH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,MAAM,GAAG,GAAG,SAAS,CAAC,wBAAwB,CAAC,CAAC;AAkBhD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAgB,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;IACpE,6EAA6E;IAC7E,6EAA6E;IAC7E,MAAM,MAAM,GAAuB,KAAK,CAAC,KAAK,CAAC;IAC/C,KAAK,MAAM,CAAC;IAEZ,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE;YACN,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI;YACjC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9F;KACF,CAAC;AACJ,CAAC,CAAC;AAqBF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,oBAAoB;IACd,GAAG,CAAqB;IACxB,MAAM,CAAc;IAErC;;OAEG;IACH,YAAY,OAAoC,EAAE;QAChD,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,kBAAkB,CAAC;IAClD,CAAC;IAED;;;;;;;;;;;OAWG;IACI,KAAK,CAAC,OAAO,CAAC,KAAwB;QAC3C,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,MAAM,KAAK,GAAG,UAAU,KAAK,CAAC,OAAO,sCAAsC,CAAC;YAC5E,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;YAC5C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QAClD,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC/D,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,oBAAoB,CAAC,CAAC;YAClE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;CACF"}

package/dist/skills/usage-recorder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage-recorder.d.ts","sourceRoot":"","sources":["../../src/skills/usage-recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,qFAAqF;IACrF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;CAChF;AASD;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAErE;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,IAAI,CAqBN"}
+{"version":3,"file":"usage-recorder.d.ts","sourceRoot":"","sources":["../../src/skills/usage-recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAgCH;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,qFAAqF;IACrF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;CAChF;AASD;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAErE;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,IAAI,CAwBN"}

package/dist/skills/usage-recorder.js

@@ -17,7 +17,34 @@
  * @saga T9560
  * @architecture docs/architecture/SG-CLEO-SKILLS-architecture-v3.md §5
  */
+import { resolveProjectByCwd } from '@cleocode/paths';
 import { enqueueSkillUsage } from '../store/skills-usage-queue.js';
+/**
+ * Best-effort resolution of the active project's canonical ID from `cwd`.
+ *
+ * Stamped onto every usage row (`project_id`) so cross-project skill-usage
+ * analytics can attribute usage to the project the skill was loaded under
+ * (T11544). Returns `null` whenever there is no resolvable CLEO project
+ * (global usage outside any repo, corrupt `project-info.json`, etc.) — the
+ * column is nullable by design, and telemetry MUST NOT throw on the hot path.
+ *
+ * The paths-package resolver is itself non-throwing (returns `null`), but the
+ * `try/catch` guards against any unexpected fs/parse error so the recorder
+ * contract (never break skill loading) holds unconditionally.
+ *
+ * @returns The canonical projectId, or `null` when no project context exists.
+ *
+ * @task T11544
+ */
+function resolveActiveProjectId() {
+    try {
+        return resolveProjectByCwd()?.projectId ?? null;
+    }
+    catch {
+        /* swallowed — telemetry MUST NOT block skill loading (architecture v3 §5) */
+        return null;
+    }
+}
 /**
  * Internal flag — set to `true` in tests via {@link __setSkillUsageRecorderEnabled}
  * so unit tests can verify the recorder fires without depending on global
@@ -76,6 +103,9 @@ export function recordSkillUsage(name, action, context) {
         skillName: name,
         eventKind: action,
         taskId: context?.taskId ?? null,
+        // T11544: attribute the usage event to the active project (null when
+        // running outside any resolvable CLEO project — global usage stays valid).
+        projectId: resolveActiveProjectId(),
         modelId: context?.modelId ?? null,
         metadata: JSON.stringify(metadataObj),
     };

package/dist/skills/usage-recorder.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage-recorder.js","sourceRoot":"","sources":["../../src/skills/usage-recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAiCnE;;;;GAIG;AACH,IAAI,QAAQ,GAAG,IAAI,CAAC;AAEpB;;;;;;;;;GASG;AACH,MAAM,UAAU,8BAA8B,CAAC,OAAgB;IAC7D,QAAQ,GAAG,OAAO,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,6BAA6B;IAC3C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,MAAwB,EACxB,OAA2B;IAE3B,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,IAAI,CAAC,IAAI;QAAE,OAAO;IAElB,MAAM,WAAW,GAAG,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;IAC5C,MAAM,GAAG,GAAqB;QAC5B,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,MAAM;QACjB,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,IAAI;QAC/B,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI;QACjC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;KACtC,CAAC;IAEF,oEAAoE;IACpE,wEAAwE;IACxE,sEAAsE;IACtE,IAAI,CAAC;QACH,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,6EAA6E;IAC/E,CAAC;AACH,CAAC"}
+{"version":3,"file":"usage-recorder.js","sourceRoot":"","sources":["../../src/skills/usage-recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAEnE;;;;;;;;;;;;;;;;GAgBG;AACH,SAAS,sBAAsB;IAC7B,IAAI,CAAC;QACH,OAAO,mBAAmB,EAAE,EAAE,SAAS,IAAI,IAAI,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,6EAA6E;QAC7E,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAiCD;;;;GAIG;AACH,IAAI,QAAQ,GAAG,IAAI,CAAC;AAEpB;;;;;;;;;GASG;AACH,MAAM,UAAU,8BAA8B,CAAC,OAAgB;IAC7D,QAAQ,GAAG,OAAO,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,6BAA6B;IAC3C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,MAAwB,EACxB,OAA2B;IAE3B,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,IAAI,CAAC,IAAI;QAAE,OAAO;IAElB,MAAM,WAAW,GAAG,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;IAC5C,MAAM,GAAG,GAAqB;QAC5B,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,MAAM;QACjB,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,IAAI;QAC/B,qEAAqE;QACrE,2EAA2E;QAC3E,SAAS,EAAE,sBAAsB,EAAE;QACnC,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI;QACjC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;KACtC,CAAC;IAEF,oEAAoE;IACpE,wEAAwE;IACxE,sEAAsE;IACtE,IAAI,CAAC;QACH,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,6EAA6E;IAC/E,CAAC;AACH,CAAC"}