@cleocode/core 2026.6.14 → 2026.6.17

package/dist/selfimprove/fix-gen.js

@@ -0,0 +1,346 @@
+/**
+ * Fix-generation stage for the self-improvement loop (T11889 · T11975).
+ *
+ * This is the missing autonomous link the v1 loop explicitly stubbed out
+ * ("NO autonomous fix-gen in v1", see {@link "./run-loop.js"}): given a detected
+ * regression (an open `selfimprove_dhq` + its envelope-diff) plus minimal repo
+ * context, it asks the LLM to PROPOSE a unified-diff patch and writes that patch
+ * to the path the draft-PR egress ({@link "./draft-pr.js".openDraftPr}) already
+ * `existsSync`-checks: `<cwd>/selfimprove-<scenario>.patch`. Once the patch is on
+ * disk the existing egress guard opens ONE DRAFT PR — closing the
+ * DHQ → fix → draft-PR pipeline end-to-end.
+ *
+ * ## Hard safety posture (unchanged from v1 — P5 spec §B.7)
+ *
+ *   - **LLM ONLY via the E9 chokepoint.** The real generator
+ *     ({@link createLlmFixGenerator}) resolves its model strictly through
+ *     {@link "../llm/system-resolver.js".resolveLLMForSystem} → {@link ModelRunner}
+ *     (Gate-13). It constructs NO raw provider client, reads NO `*_API_KEY` env,
+ *     and hardcodes no model id — the resolver/registry is the SSoT. The
+ *     plaintext token is materialized only at the wire boundary (E10).
+ *   - **Draft-PR-ONLY, never auto-merge.** This module produces a PATCH FILE only;
+ *     the egress that consumes it always opens a `--draft` PR against a feature
+ *     branch (never `main`). This module performs NO git/gh action.
+ *   - **Graceful degrade, never a rogue mutation.** Every failure (no credential,
+ *     LLM error, empty / non-unified-diff output) returns a typed
+ *     {@link FixGenResult} of kind `'skipped'` and writes NO patch file — so the
+ *     existing egress guard (`existsSync` on the patch path) simply skips the PR.
+ *     This function NEVER throws.
+ *   - **Injectable seam.** The LLM dependency is the {@link FixGenerator} port;
+ *     unit tests inject a deterministic fake that returns a canned patch, so NO
+ *     real LLM is reached in tests.
+ *
+ * CORE-first: this engine lives in `core` and owns the `FixGenerator` port TYPE.
+ * Import-time side-effect-free.
+ *
+ * @module @cleocode/core/selfimprove/fix-gen
+ * @epic T11889
+ * @task T11975
+ */
+import { writeFileSync } from 'node:fs';
+import { resolve as resolvePath } from 'node:path';
+import { cwd as processCwd } from 'node:process';
+import { redact } from '@cleocode/utils';
+import { loadFileContext, renderFileContextSection, } from './fix-gen-context.js';
+/**
+ * Maximum byte length of a model-reply excerpt stored in DHQ evidence or logs.
+ * Replies beyond this threshold are truncated with a marker so logs stay bounded
+ * while preserving enough context for diagnosis.
+ */
+const REPLY_EXCERPT_MAX_BYTES = 3072;
+/**
+ * The E9 system-of-use label the fix-generator resolves its model under. Maps to
+ * the `judgement` role (see `SYSTEM_ROLE_MAP`) — the closest standing role for
+ * "reason about a regression and propose a code change".
+ */
+const FIXGEN_SYSTEM = 'task-executor';
+/** A leading marker every unified-diff hunk header / file header carries. */
+const UNIFIED_DIFF_MARKERS = ['diff --git ', '--- ', '+++ ', '@@ '];
+/**
+ * Compute the patch path the draft-PR egress expects for a scenario:
+ * `<cwd>/selfimprove-<scenario>.patch`. The scenario is sanitized to a safe file
+ * stem so a hostile scenario name cannot escape the cwd.
+ *
+ * @param scenario - The scenario name.
+ * @param cwd - The working directory to resolve against (defaults to `process.cwd`).
+ * @returns The absolute patch path.
+ */
+export function fixPatchPath(scenario, cwd) {
+    const safeScenario = scenario.replace(/[^a-z0-9-]/gi, '-');
+    return resolvePath(cwd ?? processCwd(), `selfimprove-${safeScenario}.patch`);
+}
+/**
+ * Is `text` a plausible unified diff?
+ *
+ * A real `git apply`-able patch always carries at least one of the canonical
+ * unified-diff markers ({@link UNIFIED_DIFF_MARKERS}). An LLM that returns prose,
+ * an apology, or an empty string fails this guard, so the loop degrades to "no
+ * patch" rather than writing junk the egress would then fail to `git apply`.
+ *
+ * This is a cheap structural sniff, NOT a full parse — the authoritative
+ * applicability check is `git apply` inside the egress (which fails the PR cut on
+ * a bad patch, never `main`).
+ *
+ * @param text - Candidate patch text.
+ * @returns `true` when the text looks like a unified diff.
+ */
+export function looksLikeUnifiedDiff(text) {
+    if (text.trim().length === 0)
+        return false;
+    return UNIFIED_DIFF_MARKERS.some((marker) => text.includes(marker));
+}
+/**
+ * Build the system + user prompt the real generator sends to the LLM. Pure
+ * (no IO) so it is unit-testable in isolation when an explicit `fileContext` is
+ * passed; the default path calls {@link loadFileContext} to resolve the relevant
+ * source files for each regressing op-coordinate (IO-bearing path used in
+ * production).
+ *
+ * The prompt is deliberately strict: "respond with ONLY a unified diff" — anything
+ * else fails {@link looksLikeUnifiedDiff} downstream and degrades to "no patch".
+ * When file context is available it is embedded between the regression description
+ * and the "produce the diff" instruction so the model can locate the responsible
+ * code. When context is absent (unmapped op or budget exhausted) the model is
+ * explicitly told it may respond `NO_PATCH` — this keeps the prompt honest.
+ *
+ * @param request - The fix-generation request.
+ * @param fileContext - Optional pre-loaded file context (injected for pure unit
+ *   tests). When absent, {@link loadFileContext} is called with the request's
+ *   `repoContext.projectRoot` and the op-coordinates from `regressions`.
+ * @returns The `{ system, user }` prompt pair.
+ *
+ * @task T11988
+ */
+export function buildFixGenPrompt(request, fileContext) {
+    const system = 'You are an autonomous software-maintenance agent. You are given a detected ' +
+        'regression in a TypeScript monorepo (a divergence between a replayed scenario ' +
+        'and its golden expected output). Produce a MINIMAL fix as a single unified diff ' +
+        '(`git diff` format, with `diff --git`, `---`, `+++`, and `@@` hunk headers). ' +
+        'Respond with ONLY the unified diff and NOTHING else — no prose, no code fences, ' +
+        'no explanation. If you cannot propose a safe fix, respond with the single token ' +
+        'NO_PATCH.';
+    const lines = request.regressions.map((r) => `- op ${r.opCoord} (#${r.opIndex}) at path \`${r.path}\`: ` +
+        `actual=${JSON.stringify(r.actual)} expected=${JSON.stringify(r.expected)}`);
+    // Resolve file context: use the pre-loaded context (pure test path) or load it
+    // now from disk (production path). Either way we render the same section string.
+    const ctx = fileContext ??
+        loadFileContext({
+            projectRoot: request.repoContext.projectRoot,
+            opCoords: request.regressions.map((r) => r.opCoord),
+            ...request.repoContext.contextBudget,
+        });
+    const fileSection = renderFileContextSection(ctx);
+    const user = `Regression ${request.dhqId} in scenario \`${request.scenario}\` ` +
+        `(${request.regressions.length} diverging path(s)).\n` +
+        (request.repoContext.summary ? `Scenario summary: ${request.repoContext.summary}\n` : '') +
+        `Project root: ${request.repoContext.projectRoot}\n\n` +
+        `Diverging paths:\n${lines.join('\n')}\n` +
+        (fileSection
+            ? `\n${fileSection}\n`
+            : '\n[No source file context available — respond NO_PATCH if you cannot locate the fix.]\n') +
+        '\nProduce the unified diff that resolves these divergences.';
+    return { system, user };
+}
+/**
+ * Produce a credential-redacted, byte-bounded excerpt of a raw model reply for
+ * safe logging and DHQ evidence attachment.
+ *
+ * The excerpt is at most {@link REPLY_EXCERPT_MAX_BYTES} UTF-8 bytes. When the
+ * reply is longer a `…[truncated <N> bytes]` marker replaces the tail so the
+ * caller can distinguish a genuinely-short reply from a truncated one. The
+ * returned string is already passed through {@link redact} so no downstream
+ * scrubbing is needed.
+ *
+ * @param reply - The raw model reply text.
+ * @returns A scrubbed, bounded excerpt string.
+ */
+export function truncateReply(reply) {
+    const scrubbed = redact(reply);
+    const buf = Buffer.from(scrubbed, 'utf8');
+    if (buf.byteLength <= REPLY_EXCERPT_MAX_BYTES)
+        return scrubbed;
+    const truncated = buf.subarray(0, REPLY_EXCERPT_MAX_BYTES).toString('utf8');
+    const overflow = buf.byteLength - REPLY_EXCERPT_MAX_BYTES;
+    return `${truncated}…[truncated ${overflow} bytes]`;
+}
+/**
+ * Lazily-resolved module logger (import-time side-effect-free).
+ */
+let cachedLogger;
+async function getModuleLogger() {
+    if (cachedLogger === undefined) {
+        const { getLogger } = await import('../logger.js');
+        cachedLogger = getLogger('selfimprove-fix-gen');
+    }
+    return cachedLogger;
+}
+/**
+ * Run the fix-generation stage: ask the injected {@link FixGenerator} for a patch,
+ * validate it as a unified diff, and write it to the egress-expected patch path.
+ *
+ * This function NEVER throws and NEVER mutates anything but the single patch file.
+ * On ANY degrade path — generator returns `'none'`, the generator throws, or the
+ * returned text is not a unified diff — it writes NO file and returns
+ * `{ kind: 'skipped', reason }`, so the downstream `existsSync` egress guard
+ * simply skips the PR. The caller records the `reason` on the DHQ evidence.
+ *
+ * @param opts - See {@link GenerateFixPatchOptions}.
+ * @returns A {@link FixGenResult}.
+ *
+ * @example
+ * ```ts
+ * const res = await generateFixPatch({
+ *   request: { dhqId: 'DHQ-abcd1234', scenario, questionHash, regressions, repoContext },
+ *   generator: createLlmFixGenerator(),
+ *   cwd: projectRoot,
+ * });
+ * if (res.kind === 'written') { // openDraftPr will now find selfimprove-<scenario>.patch }
+ * ```
+ */
+export async function generateFixPatch(opts) {
+    const logger = opts.logger ?? (await getModuleLogger());
+    const { request, generator } = opts;
+    const patchPath = fixPatchPath(request.scenario, opts.cwd);
+    let output;
+    try {
+        output = await generator.propose(request);
+    }
+    catch (err) {
+        const reason = `fixgen-threw:${err instanceof Error ? err.message : String(err)}`;
+        logger.warn({ dhqId: request.dhqId, scenario: request.scenario, reason }, 'fix-gen degraded');
+        return { kind: 'skipped', reason };
+    }
+    if (output.kind === 'none') {
+        // For model-declined the generator already pre-sanitized the rawReply field;
+        // log it at debug so the reply is visible without noise on green runs.
+        const replyExcerpt = output.rawReply;
+        if (replyExcerpt !== undefined) {
+            logger.debug({ dhqId: request.dhqId, scenario: request.scenario, reason: output.reason, replyExcerpt }, 'fix-gen model declined — raw reply excerpt (redacted, truncated) attached to DHQ evidence');
+        }
+        else {
+            logger.info({ dhqId: request.dhqId, scenario: request.scenario, reason: output.reason }, 'fix-gen produced no patch (graceful skip — no PR)');
+        }
+        return {
+            kind: 'skipped',
+            reason: `fixgen-none:${output.reason}`,
+            ...(replyExcerpt !== undefined ? { replyExcerpt } : {}),
+        };
+    }
+    if (!looksLikeUnifiedDiff(output.diff)) {
+        // The model returned something but it is not a unified diff. Log the reply
+        // excerpt at warn (actionable — the model may need a prompt tweak) and
+        // attach it to the DHQ evidence row for the operator.
+        const replyExcerpt = truncateReply(output.diff);
+        logger.warn({ dhqId: request.dhqId, scenario: request.scenario, replyExcerpt }, 'fix-gen output is not a unified diff (graceful skip — no PR); raw reply attached to DHQ evidence');
+        return { kind: 'skipped', reason: 'fixgen-not-a-diff', replyExcerpt };
+    }
+    // Normalize a trailing newline so `git apply` accepts the hunk.
+    const diff = output.diff.endsWith('\n') ? output.diff : `${output.diff}\n`;
+    writeFileSync(patchPath, diff, 'utf8');
+    const bytes = Buffer.byteLength(diff, 'utf8');
+    logger.info({ dhqId: request.dhqId, scenario: request.scenario, patchPath, bytes, model: output.model }, 'fix-gen wrote candidate patch — egress will open a DRAFT PR');
+    return { kind: 'written', patchPath, bytes, model: output.model };
+}
+/**
+ * Construct the REAL fix generator — the one that drives the E9 LLM chokepoint.
+ *
+ * Resolution funnels through {@link resolveLLMForSystem}(`'task-executor'`) →
+ * {@link ModelRunner.build} → `session.send` (ONE non-streaming completion).
+ * It constructs NO raw provider client, reads NO API-key env, and hardcodes no
+ * model id (Gate-13). The plaintext credential is materialized ONLY at the
+ * `ModelRunner` wire boundary (E10) via the sealed handle. When no credential is
+ * reachable it returns `{ kind: 'none' }` — the loop degrades to "no patch", no
+ * PR. This function constructs nothing at call time (lazy dynamic imports keep the
+ * module import-time side-effect-free + the E9 deps off the hot import path).
+ *
+ * @param opts - Optional project root threaded into the resolver.
+ * @returns A {@link FixGenerator} backed by the E9 chokepoint.
+ *
+ * @example
+ * ```ts
+ * const gen = createLlmFixGenerator({ projectRoot });
+ * const out = await gen.propose(request); // resolves model via E9, never raw client
+ * ```
+ */
+export function createLlmFixGenerator(opts = {}) {
+    return {
+        async propose(request) {
+            const logger = await getModuleLogger();
+            // Lazy imports: keep E9 deps off the module import path + side-effect-free.
+            const { resolveLLMForSystem } = await import('../llm/system-resolver.js');
+            const { ModelRunner } = await import('../llm/model-runner.js');
+            // 1. E9 resolution chokepoint. Never throws (resolver contract).
+            const projectRoot = opts.projectRoot ?? request.repoContext.projectRoot;
+            const resolved = await resolveLLMForSystem(FIXGEN_SYSTEM, { projectRoot });
+            if (!resolved.sealedCredential && resolved.authType !== 'aws_sdk') {
+                return { kind: 'none', reason: 'no-credential-resolved' };
+            }
+            // 2. Materialize the plaintext ONLY at the wire boundary (E10), build a
+            //    clean descriptor, and construct the transport inside ModelRunner.
+            const apiKey = resolved.sealedCredential
+                ? (await resolved.sealedCredential.fetch()).value
+                : null;
+            const built = await ModelRunner.build({
+                provider: resolved.provider,
+                model: resolved.model,
+                credential: resolved.credential
+                    ? {
+                        provider: resolved.credential.provider,
+                        apiKey,
+                        source: resolved.credential.source,
+                        authType: resolved.credential.authType,
+                    }
+                    : null,
+                source: resolved.source,
+                ...(resolved.credentialLabel !== undefined
+                    ? { credentialLabel: resolved.credentialLabel }
+                    : {}),
+                apiMode: resolved.apiMode,
+                baseUrl: resolved.baseUrl,
+                authType: resolved.authType,
+                ...(resolved.capabilities !== undefined ? { capabilities: resolved.capabilities } : {}),
+            });
+            // 3. ONE non-streaming completion. The system prompt is threaded onto the
+            //    request via `systemSuffix` (ConcreteSession maps it to
+            //    `TransportRequest.system`); the user turn carries the regression detail.
+            const { system, user } = buildFixGenPrompt(request);
+            try {
+                const response = await built.session.send([{ role: 'user', content: user }], {
+                    systemSuffix: system,
+                });
+                const text = (response.content ?? '').trim();
+                if (text.length === 0 || text === 'NO_PATCH') {
+                    // Attach a redacted, bounded excerpt so the caller can log it onto
+                    // the DHQ evidence row without having to re-run. The empty-reply case
+                    // carries no useful excerpt; only the non-empty case (e.g. prose like
+                    // "I cannot fix this") is worth capturing.
+                    const rawReply = text.length > 0 ? truncateReply(text) : undefined;
+                    return {
+                        kind: 'none',
+                        reason: 'model-declined',
+                        ...(rawReply !== undefined ? { rawReply } : {}),
+                    };
+                }
+                return { kind: 'patch', diff: stripCodeFences(text), model: response.model };
+            }
+            catch (err) {
+                logger.warn({ system: FIXGEN_SYSTEM, err: err instanceof Error ? err.message : String(err) }, 'fix-gen LLM call failed — degrading to no-patch');
+                return { kind: 'none', reason: 'llm-call-failed' };
+            }
+        },
+    };
+}
+/**
+ * Strip a single surrounding markdown code fence (```diff … ```), if present, so a
+ * model that wraps its diff still yields an applyable patch. A bare diff passes
+ * through untouched.
+ *
+ * @param text - Candidate patch text (already trimmed).
+ * @returns The fence-stripped text.
+ */
+export function stripCodeFences(text) {
+    const fence = /^```[a-z]*\n([\s\S]*?)\n```$/i;
+    const m = text.match(fence);
+    return m?.[1] !== undefined ? m[1].trim() : text;
+}
+//# sourceMappingURL=fix-gen.js.map

package/dist/selfimprove/fix-gen.js.map

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

package/dist/selfimprove/op-source-map.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Static op-coordinate → source-file map for the self-improvement fix-gen stage.
+ *
+ * Given a regression's `opCoord` (the `domain.operation` string produced by
+ * {@link "../selfimprove/envelope-diff.js".DiffEntry.opCoord}, e.g. `tasks.show`),
+ * this module resolves the **repo-relative** paths of the CLI handler and the
+ * core module(s) most likely to contain the regression. The file list is fed into
+ * the fix-gen prompt builder ({@link "./fix-gen-context.js"}) so the LLM receives
+ * bounded, targeted code context rather than zero context or an unbounded repo
+ * dump.
+ *
+ * ## Design: static map, not a registry query
+ *
+ * The ops catalog (the `OPERATIONS` array in `@cleocode/contracts`) encodes
+ * `{ gateway, domain, operation }` but does NOT track source-file provenance.
+ * Runtime nexus queries (`cleo nexus query`) would work but introduce an
+ * in-process dependency on the nexus subsystem (an expensive side-effectful
+ * import in the fix-gen hot path). A **static map keyed by `domain.operation`**
+ * is the cost-free alternative: it is derived once (by reading the repo's known
+ * handler layout), is small enough to inline, and carries zero import-time cost.
+ *
+ * The map covers the common `tasks` domain operations exercised by the canonical
+ * scenarios. The entry for an unregistered `opCoord` returns an empty file list
+ * (`{ handlerFiles: [], coreFiles: [] }`) — the fix-gen stage degrades gracefully
+ * to "no context" (the model still receives the regression diff and may emit
+ * `NO_PATCH`, which is the honest outcome when context is absent).
+ *
+ * ## File path convention
+ *
+ * Every path is **repo-relative** (no leading `/`). The file content loader
+ * ({@link "./fix-gen-context.js"}) resolves them against `repoContext.projectRoot`
+ * before reading.
+ *
+ * Import-time side-effect-free: no IO, no dynamic imports.
+ *
+ * @module @cleocode/core/selfimprove/op-source-map
+ * @epic T11889
+ * @task T11988
+ */
+/**
+ * Resolved source files for one op-coordinate.
+ *
+ * - `handlerFiles`: the CLI dispatch handler(s) in `packages/cleo/src/dispatch/domains/`
+ * - `coreFiles`: the core-logic module(s) in `packages/core/src/` (the file most
+ *   likely to contain the regression for this operation)
+ *
+ * Both lists are repo-relative. Either may be empty when not applicable.
+ */
+export interface OpSourceEntry {
+    /** CLI dispatch handler files (repo-relative). */
+    readonly handlerFiles: readonly string[];
+    /** Core module files that implement the operation logic (repo-relative). */
+    readonly coreFiles: readonly string[];
+}
+/**
+ * Resolve the handler + core source files for a given op-coordinate.
+ *
+ * Returns the {@link OpSourceEntry} from the static map when the `opCoord` is
+ * registered, or {@link EMPTY_ENTRY} when it is not. NEVER throws. The returned
+ * lists contain repo-relative paths; callers resolve them against the project root
+ * before reading.
+ *
+ * @param opCoord - The op coordinate to resolve (e.g. `'tasks.show'`).
+ * @returns The resolved {@link OpSourceEntry} (may be empty for unknown ops).
+ *
+ * @example
+ * ```ts
+ * const { handlerFiles, coreFiles } = resolveOpSourceFiles('tasks.show');
+ * // handlerFiles: ['packages/cleo/src/dispatch/domains/tasks.ts']
+ * // coreFiles:    ['packages/core/src/tasks/show.ts']
+ * ```
+ */
+export declare function resolveOpSourceFiles(opCoord: string): OpSourceEntry;
+/**
+ * Collect the unique set of source files for a list of op-coordinates.
+ *
+ * Deduplicates across entries so a scenario with two ops from the same handler
+ * does not include the handler twice. Returns the merged `{ handlerFiles, coreFiles }`
+ * with order preserved (first-seen wins for dedup).
+ *
+ * @param opCoords - The op-coordinate strings to collect files for.
+ * @returns The merged, deduplicated {@link OpSourceEntry}.
+ *
+ * @example
+ * ```ts
+ * const entry = collectOpSourceFiles(['tasks.find', 'tasks.show']);
+ * // entry.handlerFiles: ['packages/cleo/src/dispatch/domains/tasks.ts']
+ * // entry.coreFiles:    ['packages/core/src/tasks/find.ts', 'packages/core/src/tasks/show.ts']
+ * ```
+ */
+export declare function collectOpSourceFiles(opCoords: readonly string[]): OpSourceEntry;
+//# sourceMappingURL=op-source-map.d.ts.map

package/dist/selfimprove/op-source-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"op-source-map.d.ts","sourceRoot":"","sources":["../../src/selfimprove/op-source-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AA2FD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAEnE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,CAuB/E"}

package/dist/selfimprove/op-source-map.js

@@ -0,0 +1,187 @@
+/**
+ * Static op-coordinate → source-file map for the self-improvement fix-gen stage.
+ *
+ * Given a regression's `opCoord` (the `domain.operation` string produced by
+ * {@link "../selfimprove/envelope-diff.js".DiffEntry.opCoord}, e.g. `tasks.show`),
+ * this module resolves the **repo-relative** paths of the CLI handler and the
+ * core module(s) most likely to contain the regression. The file list is fed into
+ * the fix-gen prompt builder ({@link "./fix-gen-context.js"}) so the LLM receives
+ * bounded, targeted code context rather than zero context or an unbounded repo
+ * dump.
+ *
+ * ## Design: static map, not a registry query
+ *
+ * The ops catalog (the `OPERATIONS` array in `@cleocode/contracts`) encodes
+ * `{ gateway, domain, operation }` but does NOT track source-file provenance.
+ * Runtime nexus queries (`cleo nexus query`) would work but introduce an
+ * in-process dependency on the nexus subsystem (an expensive side-effectful
+ * import in the fix-gen hot path). A **static map keyed by `domain.operation`**
+ * is the cost-free alternative: it is derived once (by reading the repo's known
+ * handler layout), is small enough to inline, and carries zero import-time cost.
+ *
+ * The map covers the common `tasks` domain operations exercised by the canonical
+ * scenarios. The entry for an unregistered `opCoord` returns an empty file list
+ * (`{ handlerFiles: [], coreFiles: [] }`) — the fix-gen stage degrades gracefully
+ * to "no context" (the model still receives the regression diff and may emit
+ * `NO_PATCH`, which is the honest outcome when context is absent).
+ *
+ * ## File path convention
+ *
+ * Every path is **repo-relative** (no leading `/`). The file content loader
+ * ({@link "./fix-gen-context.js"}) resolves them against `repoContext.projectRoot`
+ * before reading.
+ *
+ * Import-time side-effect-free: no IO, no dynamic imports.
+ *
+ * @module @cleocode/core/selfimprove/op-source-map
+ * @epic T11889
+ * @task T11988
+ */
+/**
+ * The static `opCoord → source files` map.
+ *
+ * Keys are `domain.operation` strings (lowercase, e.g. `'tasks.show'`). Values
+ * are {@link OpSourceEntry} objects with repo-relative paths.
+ *
+ * Coverage: the `tasks` domain operations exercised by the built-in scenarios
+ * (T11988: `seeded-code-regression`) plus the pre-existing `dhq-replay-find`
+ * scenario (`tasks.find`, `tasks.show`).
+ *
+ * @internal
+ */
+const OP_SOURCE_MAP = {
+    'tasks.show': {
+        handlerFiles: ['packages/cleo/src/dispatch/domains/tasks.ts'],
+        coreFiles: ['packages/core/src/tasks/show.ts'],
+    },
+    'tasks.find': {
+        handlerFiles: ['packages/cleo/src/dispatch/domains/tasks.ts'],
+        coreFiles: ['packages/core/src/tasks/find.ts'],
+    },
+    'tasks.list': {
+        handlerFiles: ['packages/cleo/src/dispatch/domains/tasks.ts'],
+        coreFiles: ['packages/core/src/tasks/list.ts'],
+    },
+    'tasks.add': {
+        handlerFiles: ['packages/cleo/src/dispatch/domains/tasks.ts'],
+        coreFiles: ['packages/core/src/tasks/add.ts'],
+    },
+    'tasks.update': {
+        handlerFiles: ['packages/cleo/src/dispatch/domains/tasks.ts'],
+        coreFiles: ['packages/core/src/tasks/update.ts'],
+    },
+    'tasks.complete': {
+        handlerFiles: ['packages/cleo/src/dispatch/domains/tasks.ts'],
+        coreFiles: ['packages/core/src/tasks/complete.ts'],
+    },
+    'tasks.delete': {
+        handlerFiles: ['packages/cleo/src/dispatch/domains/tasks.ts'],
+        coreFiles: ['packages/core/src/tasks/delete.ts'],
+    },
+    'tasks.next': {
+        handlerFiles: ['packages/cleo/src/dispatch/domains/tasks.ts'],
+        coreFiles: ['packages/core/src/tasks/next.ts'],
+    },
+    'tasks.current': {
+        handlerFiles: ['packages/cleo/src/dispatch/domains/tasks.ts'],
+        coreFiles: ['packages/core/src/tasks/current.ts'],
+    },
+    'tasks.tree': {
+        handlerFiles: ['packages/cleo/src/dispatch/domains/tasks.ts'],
+        coreFiles: ['packages/core/src/tasks/generic-tree.ts'],
+    },
+    'tasks.analyze': {
+        handlerFiles: ['packages/cleo/src/dispatch/domains/tasks.ts'],
+        coreFiles: ['packages/core/src/tasks/analyze.ts'],
+    },
+    'memory.find': {
+        handlerFiles: ['packages/cleo/src/dispatch/domains/memory.ts'],
+        coreFiles: [],
+    },
+    'memory.fetch': {
+        handlerFiles: ['packages/cleo/src/dispatch/domains/memory.ts'],
+        coreFiles: [],
+    },
+    'selfimprove.run': {
+        handlerFiles: ['packages/cleo/src/dispatch/domains/selfimprove.ts'],
+        coreFiles: ['packages/core/src/selfimprove/run-loop.ts'],
+    },
+    /**
+     * `selfimprove.probe` — the seeded-code-regression scenario target (T11988).
+     * The probe-helper is intentionally broken (`probeVersion()` returns `2`
+     * instead of `1`); the fix is a single-line change in this file.
+     */
+    'selfimprove.probe': {
+        handlerFiles: ['packages/cleo/src/dispatch/domains/selfimprove.ts'],
+        coreFiles: ['packages/core/src/selfimprove/probe-helper.ts'],
+    },
+};
+/**
+ * An empty source entry returned for unknown or unmapped op-coordinates.
+ *
+ * The fix-gen stage treats an empty file list as "no context available" and
+ * degrades the prompt to the regression-only view. The model may still produce
+ * a patch (or `NO_PATCH`) without file context.
+ */
+const EMPTY_ENTRY = { handlerFiles: [], coreFiles: [] };
+/**
+ * Resolve the handler + core source files for a given op-coordinate.
+ *
+ * Returns the {@link OpSourceEntry} from the static map when the `opCoord` is
+ * registered, or {@link EMPTY_ENTRY} when it is not. NEVER throws. The returned
+ * lists contain repo-relative paths; callers resolve them against the project root
+ * before reading.
+ *
+ * @param opCoord - The op coordinate to resolve (e.g. `'tasks.show'`).
+ * @returns The resolved {@link OpSourceEntry} (may be empty for unknown ops).
+ *
+ * @example
+ * ```ts
+ * const { handlerFiles, coreFiles } = resolveOpSourceFiles('tasks.show');
+ * // handlerFiles: ['packages/cleo/src/dispatch/domains/tasks.ts']
+ * // coreFiles:    ['packages/core/src/tasks/show.ts']
+ * ```
+ */
+export function resolveOpSourceFiles(opCoord) {
+    return OP_SOURCE_MAP[opCoord] ?? EMPTY_ENTRY;
+}
+/**
+ * Collect the unique set of source files for a list of op-coordinates.
+ *
+ * Deduplicates across entries so a scenario with two ops from the same handler
+ * does not include the handler twice. Returns the merged `{ handlerFiles, coreFiles }`
+ * with order preserved (first-seen wins for dedup).
+ *
+ * @param opCoords - The op-coordinate strings to collect files for.
+ * @returns The merged, deduplicated {@link OpSourceEntry}.
+ *
+ * @example
+ * ```ts
+ * const entry = collectOpSourceFiles(['tasks.find', 'tasks.show']);
+ * // entry.handlerFiles: ['packages/cleo/src/dispatch/domains/tasks.ts']
+ * // entry.coreFiles:    ['packages/core/src/tasks/find.ts', 'packages/core/src/tasks/show.ts']
+ * ```
+ */
+export function collectOpSourceFiles(opCoords) {
+    const seenHandler = new Set();
+    const seenCore = new Set();
+    const handlerFiles = [];
+    const coreFiles = [];
+    for (const coord of opCoords) {
+        const entry = resolveOpSourceFiles(coord);
+        for (const f of entry.handlerFiles) {
+            if (!seenHandler.has(f)) {
+                seenHandler.add(f);
+                handlerFiles.push(f);
+            }
+        }
+        for (const f of entry.coreFiles) {
+            if (!seenCore.has(f)) {
+                seenCore.add(f);
+                coreFiles.push(f);
+            }
+        }
+    }
+    return { handlerFiles, coreFiles };
+}
+//# sourceMappingURL=op-source-map.js.map

package/dist/selfimprove/op-source-map.js.map

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