@cleocode/core 2026.6.15 → 2026.6.17

package/dist/selfimprove/fix-gen.js

@@ -40,6 +40,14 @@
 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
@@ -83,14 +91,27 @@ export function looksLikeUnifiedDiff(text) {
 }
 /**
  * Build the system + user prompt the real generator sends to the LLM. Pure
- * (no IO) so it is unit-testable in isolation. The prompt is deliberately strict:
- * "respond with ONLY a unified diff" — anything else fails
- * {@link looksLikeUnifiedDiff} downstream and degrades to "no patch".
+ * (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) {
+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 ' +
@@ -100,14 +121,48 @@ export function buildFixGenPrompt(request) {
         '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\n` +
-        'Produce the unified diff that resolves these divergences.';
+        `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).
  */
@@ -156,12 +211,28 @@ export async function generateFixPatch(opts) {
         return { kind: 'skipped', reason };
     }
     if (output.kind === 'none') {
-        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}` };
+        // 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)) {
-        logger.warn({ dhqId: request.dhqId, scenario: request.scenario }, 'fix-gen output is not a unified diff (graceful skip — no PR)');
-        return { kind: 'skipped', reason: 'fixgen-not-a-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`;
@@ -239,7 +310,16 @@ export function createLlmFixGenerator(opts = {}) {
                 });
                 const text = (response.content ?? '').trim();
                 if (text.length === 0 || text === 'NO_PATCH') {
-                    return { kind: 'none', reason: 'model-declined' };
+                    // 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 };
             }

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

@@ -1 +1 @@
-{"version":3,"file":"fix-gen.js","sourceRoot":"","sources":["../../src/selfimprove/fix-gen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,GAAG,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AAIjD;;;;GAIG;AACH,MAAM,aAAa,GAAG,eAAwB,CAAC;AAE/C,6EAA6E;AAC7E,MAAM,oBAAoB,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAU,CAAC;AAuG7E;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,GAAY;IACzD,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IAC3D,OAAO,WAAW,CAAC,GAAG,IAAI,UAAU,EAAE,EAAE,eAAe,YAAY,QAAQ,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAsB;IACtD,MAAM,MAAM,GACV,6EAA6E;QAC7E,gFAAgF;QAChF,kFAAkF;QAClF,+EAA+E;QAC/E,kFAAkF;QAClF,kFAAkF;QAClF,WAAW,CAAC;IACd,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CACnC,CAAC,CAAC,EAAE,EAAE,CACJ,QAAQ,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,OAAO,eAAe,CAAC,CAAC,IAAI,MAAM;QAC3D,UAAU,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAC9E,CAAC;IACF,MAAM,IAAI,GACR,cAAc,OAAO,CAAC,KAAK,kBAAkB,OAAO,CAAC,QAAQ,KAAK;QAClE,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,wBAAwB;QACtD,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,OAAO,CAAC,WAAW,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACzF,iBAAiB,OAAO,CAAC,WAAW,CAAC,WAAW,MAAM;QACtD,qBAAqB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM;QAC3C,2DAA2D,CAAC;IAC9D,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,IAAI,YAAgC,CAAC;AACrC,KAAK,UAAU,eAAe;IAC5B,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QACnD,YAAY,GAAG,SAAS,CAAC,qBAAqB,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAA6B;IAClE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,eAAe,EAAE,CAAC,CAAC;IACxD,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IACpC,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAE3D,IAAI,MAAoB,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,gBAAgB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAClF,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC;QAC9F,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACrC,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CACT,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAC3E,mDAAmD,CACpD,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;IACrE,CAAC;IAED,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,CACT,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,EACpD,8DAA8D,CAC/D,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC1D,CAAC;IAED,gEAAgE;IAChE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC;IAC3E,aAAa,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,CAAC,IAAI,CACT,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAC3F,6DAA6D,CAC9D,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;AACpE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAiC,EAAE;IACvE,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,OAAsB;YAClC,MAAM,MAAM,GAAG,MAAM,eAAe,EAAE,CAAC;YACvC,4EAA4E;YAC5E,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;YAC1E,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;YAE/D,iEAAiE;YACjE,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC;YACxE,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,aAAa,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;YAC3E,IAAI,CAAC,QAAQ,CAAC,gBAAgB,IAAI,QAAQ,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAClE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;YAC5D,CAAC;YAED,wEAAwE;YACxE,uEAAuE;YACvE,MAAM,MAAM,GAAG,QAAQ,CAAC,gBAAgB;gBACtC,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK;gBACjD,CAAC,CAAC,IAAI,CAAC;YACT,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC;gBACpC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,UAAU,EAAE,QAAQ,CAAC,UAAU;oBAC7B,CAAC,CAAC;wBACE,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ;wBACtC,MAAM;wBACN,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,MAAM;wBAClC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ;qBACvC;oBACH,CAAC,CAAC,IAAI;gBACR,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,GAAG,CAAC,QAAQ,CAAC,eAAe,KAAK,SAAS;oBACxC,CAAC,CAAC,EAAE,eAAe,EAAE,QAAQ,CAAC,eAAe,EAAE;oBAC/C,CAAC,CAAC,EAAE,CAAC;gBACP,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,GAAG,CAAC,QAAQ,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxF,CAAC,CAAC;YAEH,0EAA0E;YAC1E,4DAA4D;YAC5D,8EAA8E;YAC9E,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;YACpD,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE;oBAC3E,YAAY,EAAE,MAAM;iBACrB,CAAC,CAAC;gBACH,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC7C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;oBAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;gBACpD,CAAC;gBACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC/E,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CACT,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAChF,iDAAiD,CAClD,CAAC;gBACF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;YACrD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,KAAK,GAAG,+BAA+B,CAAC;IAC9C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACnD,CAAC"}
+{"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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"}

package/dist/selfimprove/probe-helper.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Self-improvement probe helper — selfimprove.probe op (T11988).
+ *
+ * This tiny module exists to give the seeded-code-regression scenario a
+ * **real, patchable code bug** for end-to-end fix-gen proof. The function
+ * {@link probeVersion} is supposed to return `1` (the canonical probe API
+ * version), but ships with an intentional off-by-one (`return 2`) so that a
+ * live replay of the `seeded-code-regression` scenario diverges from the
+ * golden (`version: 1`) and the LLM can produce a correct one-line unified
+ * diff to fix it.
+ *
+ * ### Why a dedicated file?
+ *
+ * The seeded bug must be:
+ *   1. **In a repo-relative path** the op-source-map can register under
+ *      `selfimprove.probe` so the fix-gen context loader includes it in the
+ *      LLM prompt.
+ *   2. **Minimal** — the simplest possible off-by-one so the model cannot
+ *      rationally refuse (`NO_PATCH`).
+ *   3. **Self-contained** — no live DB, no side effects; the probe op
+ *      never mutates.
+ *
+ * ### Fixing the bug
+ *
+ * Change `return 2` → `return 1` in {@link probeVersion}. This is the EXACT
+ * one-line fix the self-improvement loop's LLM fix-gen stage should propose
+ * when replaying the seeded scenario.
+ *
+ * @module @cleocode/core/selfimprove/probe-helper
+ * @task T11988
+ */
+/**
+ * Return the canonical probe API version.
+ *
+ * Expected value: `1`.
+ *
+ * @returns The probe version number.
+ *
+ * @example
+ * ```ts
+ * probeVersion(); // => 1 (expected)
+ * ```
+ *
+ * @bug SEEDED — currently returns `2` instead of `1` (T11988 intentional).
+ *   The seeded-code-regression scenario golden asserts `version: 1`; the
+ *   mismatch is the regression the fix-gen LLM prompt targets.
+ */
+export declare function probeVersion(): number;
+/**
+ * Build the `selfimprove.probe` response payload.
+ *
+ * Returns `{ probe: 'ok', version: <probeVersion()> }` — the envelope `data`
+ * block the `selfimprove.probe` query op emits.
+ *
+ * @returns The probe response payload.
+ */
+export declare function buildProbePayload(): {
+    probe: 'ok';
+    version: number;
+};
+//# sourceMappingURL=probe-helper.d.ts.map

package/dist/selfimprove/probe-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-helper.d.ts","sourceRoot":"","sources":["../../src/selfimprove/probe-helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAIrC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAEpE"}

package/dist/selfimprove/probe-helper.js

@@ -0,0 +1,64 @@
+/**
+ * Self-improvement probe helper — selfimprove.probe op (T11988).
+ *
+ * This tiny module exists to give the seeded-code-regression scenario a
+ * **real, patchable code bug** for end-to-end fix-gen proof. The function
+ * {@link probeVersion} is supposed to return `1` (the canonical probe API
+ * version), but ships with an intentional off-by-one (`return 2`) so that a
+ * live replay of the `seeded-code-regression` scenario diverges from the
+ * golden (`version: 1`) and the LLM can produce a correct one-line unified
+ * diff to fix it.
+ *
+ * ### Why a dedicated file?
+ *
+ * The seeded bug must be:
+ *   1. **In a repo-relative path** the op-source-map can register under
+ *      `selfimprove.probe` so the fix-gen context loader includes it in the
+ *      LLM prompt.
+ *   2. **Minimal** — the simplest possible off-by-one so the model cannot
+ *      rationally refuse (`NO_PATCH`).
+ *   3. **Self-contained** — no live DB, no side effects; the probe op
+ *      never mutates.
+ *
+ * ### Fixing the bug
+ *
+ * Change `return 2` → `return 1` in {@link probeVersion}. This is the EXACT
+ * one-line fix the self-improvement loop's LLM fix-gen stage should propose
+ * when replaying the seeded scenario.
+ *
+ * @module @cleocode/core/selfimprove/probe-helper
+ * @task T11988
+ */
+/**
+ * Return the canonical probe API version.
+ *
+ * Expected value: `1`.
+ *
+ * @returns The probe version number.
+ *
+ * @example
+ * ```ts
+ * probeVersion(); // => 1 (expected)
+ * ```
+ *
+ * @bug SEEDED — currently returns `2` instead of `1` (T11988 intentional).
+ *   The seeded-code-regression scenario golden asserts `version: 1`; the
+ *   mismatch is the regression the fix-gen LLM prompt targets.
+ */
+export function probeVersion() {
+    // SEEDED BUG (T11988): should be `return 1` — intentional off-by-one for
+    // the seeded-code-regression end-to-end fix-gen scenario.
+    return 2;
+}
+/**
+ * Build the `selfimprove.probe` response payload.
+ *
+ * Returns `{ probe: 'ok', version: <probeVersion()> }` — the envelope `data`
+ * block the `selfimprove.probe` query op emits.
+ *
+ * @returns The probe response payload.
+ */
+export function buildProbePayload() {
+    return { probe: 'ok', version: probeVersion() };
+}
+//# sourceMappingURL=probe-helper.js.map

package/dist/selfimprove/probe-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-helper.js","sourceRoot":"","sources":["../../src/selfimprove/probe-helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,YAAY;IAC1B,yEAAyE;IACzE,0DAA0D;IAC1D,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,CAAC;AAClD,CAAC"}

package/dist/selfimprove/scenarios/seeded-code-regression/golden.json

@@ -0,0 +1,18 @@
+{
+  "name": "seeded-code-regression",
+  "envelopes": [
+    {
+      "success": true,
+      "meta": {
+        "gateway": "query",
+        "domain": "selfimprove",
+        "operation": "probe",
+        "source": "rpc"
+      },
+      "data": {
+        "probe": "ok",
+        "version": 1
+      }
+    }
+  ]
+}

package/dist/selfimprove/scenarios/seeded-code-regression/scenario.json

@@ -0,0 +1,12 @@
+{
+  "name": "seeded-code-regression",
+  "description": "Seeded code-regression scenario for end-to-end fix-gen proof (T11988). A deliberately broken selfimprove helper returns the wrong value; the regression is detectable from the replay envelope and fixable by a targeted one-line code patch.",
+  "ops": [
+    {
+      "gateway": "query",
+      "domain": "selfimprove",
+      "operation": "probe",
+      "params": { "scenario": "seeded-code-regression" }
+    }
+  ]
+}

package/dist/setup/index.d.ts

@@ -27,6 +27,7 @@ export { createProjectConventionsSection } from './sections/project-conventions.
 export { createSentientSection } from './sections/sentient.js';
 export { createTelemetrySection } from './sections/telemetry.js';
 export { createVerificationSection, type VerificationCheck, } from './sections/verification.js';
+export { printWhoamiSummaryAndOfferTui } from './whoami-summary.js';
 export { StubWizardIO, WizardFatalError, WizardInterruptError, type WizardIO, type WizardOptions, WizardRunner, type WizardRunResult, type WizardSection, type WizardSectionResult, type WizardSectionRunner, } from './wizard.js';
 /**
  * Construct every built-in {@link WizardSectionRunner} in canonical order.