@cleocode/core 2026.6.15 → 2026.6.18

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.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAM1E,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGrE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACL,yBAAyB,EACzB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,YAAY,EACZ,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,cAAmB,GAAG,mBAAmB,EAAE,CAazF;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,cAAmB,GAAG,YAAY,CAEpF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAM1E,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGrE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACL,yBAAyB,EACzB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,YAAY,EACZ,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,cAAmB,GAAG,mBAAmB,EAAE,CAazF;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,cAAmB,GAAG,YAAY,CAEpF"}

package/dist/setup/index.js

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

package/dist/setup/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAuB,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,YAAY,EAA4B,MAAM,aAAa,CAAC;AAErE,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAuB,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACL,yBAAyB,GAE1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EAGpB,YAAY,GAKb,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAA0B,EAAE;IAChE,OAAO;QACL,gBAAgB,CAAC,OAAO,CAAC;QACzB,wBAAwB,EAAE;QAC1B,qBAAqB,EAAE;QACvB,qBAAqB,EAAE;QACvB,+BAA+B,EAAE;QACjC,oBAAoB,EAAE;QACtB,kBAAkB,EAAE;QACpB,yBAAyB,EAAE;QAC3B,sBAAsB,EAAE;QACxB,yBAAyB,EAAE;KAC5B,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CAAC,UAA0B,EAAE;IACpE,OAAO,IAAI,YAAY,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAuB,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,YAAY,EAA4B,MAAM,aAAa,CAAC;AAErE,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAuB,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACL,yBAAyB,GAE1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EAGpB,YAAY,GAKb,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAA0B,EAAE;IAChE,OAAO;QACL,gBAAgB,CAAC,OAAO,CAAC;QACzB,wBAAwB,EAAE;QAC1B,qBAAqB,EAAE;QACvB,qBAAqB,EAAE;QACvB,+BAA+B,EAAE;QACjC,oBAAoB,EAAE;QACtB,kBAAkB,EAAE;QACpB,yBAAyB,EAAE;QAC3B,sBAAsB,EAAE;QACxB,yBAAyB,EAAE;KAC5B,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CAAC,UAA0B,EAAE;IACpE,OAAO,IAAI,YAAY,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/setup/sections/models-roles.d.ts

@@ -29,7 +29,8 @@
  * @task T11726
  * @epic T11671 (E6-ONBOARDING-FRONT-DOOR)
  */
-import type { WizardSectionRunner } from '../wizard.js';
+import type { LocalModelFitEnvelope } from '../../llm/local-model-fit.js';
+import type { WizardIO, WizardSectionRunner } from '../wizard.js';
 /**
  * Build the `models-roles` section runner (T11726).
  *
@@ -37,4 +38,34 @@ import type { WizardSectionRunner } from '../wizard.js';
  * @task T11726
  */
 export declare function createModelsRolesSection(): WizardSectionRunner;
+/**
+ * Injectable dependency for the Ollama model picker — lets tests stub out
+ * `rankLocalModelFit` without reaching into the real OS/network layer.
+ *
+ * @internal
+ */
+export type LocalModelFitRanker = () => Promise<LocalModelFitEnvelope>;
+/**
+ * Interactive Ollama model picker driven by fit-gated recommendations (T11983).
+ *
+ * Behaviour:
+ * - Calls `rankLocalModelFit` to detect hardware + Ollama state.
+ * - Below the 4 GB floor → informs the user (cloud-only guidance) and returns
+ *   `null` (caller skips the binding).
+ * - Above the floor with recommendations → presents a ranked pick list of
+ *   2–3 candidates (never auto-selects, never auto-pulls — RECOMMEND-NEVER-KILL).
+ * - Already-pulled models are surfaced first with a `[pulled]` tag.
+ * - Free-text fallback offered as the last option so the user can type any tag.
+ * - Returns the chosen model tag, or `null` if the user skipped.
+ *
+ * The ranker is injectable so tests can supply a stub envelope without
+ * hitting the OS or network.
+ *
+ * @param io - Wizard I/O surface.
+ * @param ranker - Override the fit ranker for tests (defaults to the real one).
+ * @returns The chosen Ollama model tag, or `null` when the user skipped / below floor.
+ *
+ * @task T11983
+ */
+export declare function _pickOllamaModelInteractive(io: WizardIO, ranker?: LocalModelFitRanker): Promise<string | null>;
 //# sourceMappingURL=models-roles.d.ts.map

package/dist/setup/sections/models-roles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"models-roles.d.ts","sourceRoot":"","sources":["../../../src/setup/sections/models-roles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAUH,OAAO,KAAK,EAA2B,mBAAmB,EAAE,MAAM,cAAc,CAAC;AA8CjF;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,mBAAmB,CAwI9D"}
+{"version":3,"file":"models-roles.d.ts","sourceRoot":"","sources":["../../../src/setup/sections/models-roles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAUH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE1E,OAAO,KAAK,EAAE,QAAQ,EAAiB,mBAAmB,EAAE,MAAM,cAAc,CAAC;AA8CjF;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,mBAAmB,CAqJ9D;AAoCD;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAevE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,2BAA2B,CAC/C,EAAE,EAAE,QAAQ,EACZ,MAAM,GAAE,mBAAgD,GACvD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgExB"}