agent-bober 0.17.0 → 0.18.0

package/dist/orchestrator/memory/distill.d.ts

@@ -6,7 +6,7 @@
  * lessonId is a sha256 content-hash of category+tags+sourceEntryRefs — never derived from time.
  *
  * IMPORTANT — this distills from the data shapes the REAL pipeline actually produces, NOT
- * an invented vocabulary. The three signals are:
+ * an invented vocabulary. The four signals are:
  *   (a) recurring failed-criterion categories  — from eval results' criteriaResults[].result==="fail",
  *       grouped by the criterion's verificationMethod (resolved from the owning contract).
  *   (b) repeated failing eval strategies        — from eval results' strategyResults[].result==="fail",
@@ -14,6 +14,9 @@
  *   (c) sprints that needed rework              — from contract.iterationHistory entries whose
  *       result==="fail" (real shape: { iteration, evalId, result }), reinforced by history
  *       entries with phase==="rework" && event==="evaluation-failed".
+ *   (d) fail→pass contrast                     — from contract.iterationHistory where at least one
+ *       result==="fail" is FOLLOWED (in iteration order) by a result==="pass", capturing the
+ *       sprint provenance and which iterations flipped.
  *
  * The eval-result inputs are read LENIENTLY (see DistillableEval) because the on-disk
  * .bober/eval-results/*.json files and the compiled EvalResultSchema use different shapes;

package/dist/orchestrator/memory/distill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"distill.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/memory/distill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAezD;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,KAAK,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC,CAAC;IACH,eAAe,CAAC,EAAE,KAAK,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AA2CD;;;;;;;GAOG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,YAAY,EAAE,EACvB,SAAS,EAAE,cAAc,EAAE,EAC3B,WAAW,GAAE,eAAe,EAAO,GAClC,WAAW,EAAE,CAgIf"}
+{"version":3,"file":"distill.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/memory/distill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAezD;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,KAAK,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC,CAAC;IACH,eAAe,CAAC,EAAE,KAAK,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AA2CD;;;;;;;GAOG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,YAAY,EAAE,EACvB,SAAS,EAAE,cAAc,EAAE,EAC3B,WAAW,GAAE,eAAe,EAAO,GAClC,WAAW,EAAE,CAoKf"}

package/dist/orchestrator/memory/distill.js

@@ -6,7 +6,7 @@
  * lessonId is a sha256 content-hash of category+tags+sourceEntryRefs — never derived from time.
  *
  * IMPORTANT — this distills from the data shapes the REAL pipeline actually produces, NOT
- * an invented vocabulary. The three signals are:
+ * an invented vocabulary. The four signals are:
  *   (a) recurring failed-criterion categories  — from eval results' criteriaResults[].result==="fail",
  *       grouped by the criterion's verificationMethod (resolved from the owning contract).
  *   (b) repeated failing eval strategies        — from eval results' strategyResults[].result==="fail",
@@ -14,6 +14,9 @@
  *   (c) sprints that needed rework              — from contract.iterationHistory entries whose
  *       result==="fail" (real shape: { iteration, evalId, result }), reinforced by history
  *       entries with phase==="rework" && event==="evaluation-failed".
+ *   (d) fail→pass contrast                     — from contract.iterationHistory where at least one
+ *       result==="fail" is FOLLOWED (in iteration order) by a result==="pass", capturing the
+ *       sprint provenance and which iterations flipped.
  *
  * The eval-result inputs are read LENIENTLY (see DistillableEval) because the on-disk
  * .bober/eval-results/*.json files and the compiled EvalResultSchema use different shapes;
@@ -134,6 +137,43 @@ export function distill(history, contracts, evalResults = []) {
             }
         }
     }
+    // ── (d) fail→pass contrast (per contract iterationHistory) ─────────────
+    // Detects sprints that initially failed but eventually passed, capturing the
+    // transition as a 'fix-contrast' lesson. A transition requires at least one
+    // result==='fail' FOLLOWED (in array/iteration order) by a result==='pass'.
+    // A first-iteration pass, an all-fail history, or a pass-before-any-fail are NOT transitions.
+    for (const contract of contracts) {
+        const iters = Array.isArray(contract.iterationHistory)
+            ? contract.iterationHistory
+            : [];
+        let sawFail = false;
+        let flipped = false;
+        const failedRefs = [];
+        let passRef;
+        for (const it of iters) {
+            if (!isRecord(it))
+                continue;
+            const n = typeof it["iteration"] === "number" ? it["iteration"] : "?";
+            if (it["result"] === "fail") {
+                sawFail = true;
+                failedRefs.push(`${contract.contractId}:iteration-${n}`);
+            }
+            else if (it["result"] === "pass" && sawFail) {
+                flipped = true;
+                passRef = `${contract.contractId}:iteration-${n}`;
+                break; // first pass after a fail is the flip point
+            }
+        }
+        if (flipped && passRef !== undefined) {
+            const category = `fix-contrast:${contract.contractId}`;
+            const tags = ["phase:fix-contrast", `sprintId:${contract.contractId}`];
+            const summary = `Sprint '${contract.contractId}' flipped from fail to pass after ${failedRefs.length} iteration(s)`;
+            for (const ref of failedRefs) {
+                upsertGroup(category, tags, summary, ref);
+            }
+            upsertGroup(category, tags, summary, passRef);
+        }
+    }
     // ── (c, fallback) rework signal straight from history events ────────────
     // The real pipeline writes { event:"evaluation-failed", phase:"rework", sprintId, details:{iteration} }.
     // Only used for sprints not already accounted for via iterationHistory (avoids double-count).

package/dist/orchestrator/memory/distill.js.map

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

package/dist/orchestrator/memory/fact-detector.d.ts

@@ -0,0 +1,61 @@
+/**
+ * PURE deterministic project-fact detector.
+ *
+ * PURE — no fs reads, no Date.now(), no createClient, no network access, no side effects.
+ * Takes already-parsed manifests/config as inputs and returns FactDraft[] deterministically.
+ * The thin IO caller (seedProjectFacts) handles all fs reads and clock-stamping.
+ *
+ * Mirror of distill.ts: the pure fn is separate from the IO boundary.
+ */
+import type { FactInput } from "../../state/facts.js";
+/** Already-parsed manifests/config passed in by the thin IO caller. */
+export interface ProjectInputs {
+    /** Parsed package.json content (or null if absent). */
+    packageJson: Record<string, unknown> | null;
+    /** Parsed bober.config.json content (optional). */
+    boberConfig?: Record<string, unknown> | null;
+    /**
+     * Lockfile presence flags, computed by the caller (no fs in the pure fn).
+     * First truthy flag in order npm → yarn → pnpm determines packageManager.
+     */
+    lockfiles?: {
+        npm?: boolean;
+        yarn?: boolean;
+        pnpm?: boolean;
+    };
+}
+/**
+ * A fact draft — everything EXCEPT the injected timestamps, which the caller stamps.
+ * Mirrors the FactInput shape but without tValid and tCreated.
+ */
+export type FactDraft = Omit<FactInput, "tValid" | "tCreated">;
+/**
+ * PURE: map parsed manifests/config into project-fact drafts.
+ * NO fs read, NO Date.now(), NO LLM. Returns [] when nothing is detectable.
+ *
+ * Detection rules:
+ *   project/testCommand   ← packageJson.scripts.test (if truthy)
+ *   project/buildCommand  ← packageJson.scripts.build (if truthy)
+ *   project/packageManager ← first lockfile present: npm > yarn > pnpm
+ *   project/framework     ← first dep/devDep found: next > react > vue
+ *
+ * Scope convention: scope="" (default/programming team) per memoryDir mapping
+ * in src/state/memory.ts:27-32. Namespace is a SEPARATE axis (DB file location).
+ */
+export declare function detectProjectFacts(inputs: ProjectInputs, scope?: string): FactDraft[];
+/**
+ * Thin IO wrapper: reads manifests from disk, calls the PURE detectProjectFacts,
+ * then stamps wall-clock time and writes each draft through writeFact (idempotent).
+ *
+ * This is the ONLY function in this module that touches the filesystem or the clock.
+ * It is extracted here so both pipeline.ts and chat-session.ts can reuse one helper
+ * without duplicating the IO pattern.
+ *
+ * A missing package.json or bober.config.json is NORMAL — the detector returns a
+ * partial set of drafts. Never throws for missing files.
+ *
+ * @param projectRoot - Absolute path to the project root
+ * @param namespace   - Memory namespace (undefined → default .bober/memory/)
+ */
+export declare function seedProjectFacts(projectRoot: string, namespace?: string): Promise<void>;
+//# sourceMappingURL=fact-detector.d.ts.map

package/dist/orchestrator/memory/fact-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-detector.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/memory/fact-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAUtD,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5C,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7C;;;OAGG;IACH,SAAS,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC/D;AAED;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,UAAU,CAAC,CAAC;AAI/D;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,SAAK,GAAG,SAAS,EAAE,CAkDjF;AAsBD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAsDf"}

package/dist/orchestrator/memory/fact-detector.js

@@ -0,0 +1,153 @@
+/**
+ * PURE deterministic project-fact detector.
+ *
+ * PURE — no fs reads, no Date.now(), no createClient, no network access, no side effects.
+ * Takes already-parsed manifests/config as inputs and returns FactDraft[] deterministically.
+ * The thin IO caller (seedProjectFacts) handles all fs reads and clock-stamping.
+ *
+ * Mirror of distill.ts: the pure fn is separate from the IO boundary.
+ */
+import { readFile, access } from "node:fs/promises";
+import { join } from "node:path";
+import { FactStore, factsDbPath, ensureFactsDir, writeFact, } from "../../state/facts.js";
+// ── Pure detector ─────────────────────────────────────────────────────
+/**
+ * PURE: map parsed manifests/config into project-fact drafts.
+ * NO fs read, NO Date.now(), NO LLM. Returns [] when nothing is detectable.
+ *
+ * Detection rules:
+ *   project/testCommand   ← packageJson.scripts.test (if truthy)
+ *   project/buildCommand  ← packageJson.scripts.build (if truthy)
+ *   project/packageManager ← first lockfile present: npm > yarn > pnpm
+ *   project/framework     ← first dep/devDep found: next > react > vue
+ *
+ * Scope convention: scope="" (default/programming team) per memoryDir mapping
+ * in src/state/memory.ts:27-32. Namespace is a SEPARATE axis (DB file location).
+ */
+export function detectProjectFacts(inputs, scope = "") {
+    const drafts = [];
+    const pkg = inputs.packageJson;
+    // ── Scripts → testCommand / buildCommand ─────────────────────────
+    const scripts = pkg !== null && typeof pkg === "object" && pkg !== undefined
+        ? pkg.scripts
+        : undefined;
+    if (scripts !== undefined && scripts !== null) {
+        const testCmd = typeof scripts.test === "string" ? scripts.test : undefined;
+        if (testCmd) {
+            drafts.push(makeDraft(scope, "project", "project/testCommand", testCmd));
+        }
+        const buildCmd = typeof scripts.build === "string" ? scripts.build : undefined;
+        if (buildCmd) {
+            drafts.push(makeDraft(scope, "project", "project/buildCommand", buildCmd));
+        }
+    }
+    // ── Lockfile presence → packageManager ───────────────────────────
+    // bober: deterministic order: npm first, then yarn, then pnpm; first match wins
+    const lockfiles = inputs.lockfiles ?? {};
+    if (lockfiles.npm) {
+        drafts.push(makeDraft(scope, "project", "project/packageManager", "npm"));
+    }
+    else if (lockfiles.yarn) {
+        drafts.push(makeDraft(scope, "project", "project/packageManager", "yarn"));
+    }
+    else if (lockfiles.pnpm) {
+        drafts.push(makeDraft(scope, "project", "project/packageManager", "pnpm"));
+    }
+    // ── Dependencies → framework ──────────────────────────────────────
+    // Check deps + devDeps in fixed order: next before react (next implies react)
+    if (pkg !== null && pkg !== undefined) {
+        const deps = pkg.dependencies ?? {};
+        const devDeps = pkg.devDependencies ?? {};
+        const allDeps = { ...deps, ...devDeps };
+        if ("next" in allDeps) {
+            drafts.push(makeDraft(scope, "project", "project/framework", "next"));
+        }
+        else if ("react" in allDeps) {
+            drafts.push(makeDraft(scope, "project", "project/framework", "react"));
+        }
+        else if ("vue" in allDeps) {
+            drafts.push(makeDraft(scope, "project", "project/framework", "vue"));
+        }
+    }
+    return drafts;
+}
+// ── Helper ────────────────────────────────────────────────────────────
+function makeDraft(scope, subject, predicate, value) {
+    return {
+        scope,
+        subject,
+        predicate,
+        value,
+        confidence: 1,
+        sourceRunId: null,
+    };
+}
+// ── IO seed (thin caller) ─────────────────────────────────────────────
+/**
+ * Thin IO wrapper: reads manifests from disk, calls the PURE detectProjectFacts,
+ * then stamps wall-clock time and writes each draft through writeFact (idempotent).
+ *
+ * This is the ONLY function in this module that touches the filesystem or the clock.
+ * It is extracted here so both pipeline.ts and chat-session.ts can reuse one helper
+ * without duplicating the IO pattern.
+ *
+ * A missing package.json or bober.config.json is NORMAL — the detector returns a
+ * partial set of drafts. Never throws for missing files.
+ *
+ * @param projectRoot - Absolute path to the project root
+ * @param namespace   - Memory namespace (undefined → default .bober/memory/)
+ */
+export async function seedProjectFacts(projectRoot, namespace) {
+    // ── Read manifests (best-effort; missing files → null/false) ─────
+    let packageJson = null;
+    try {
+        const raw = await readFile(join(projectRoot, "package.json"), "utf-8");
+        const parsed = JSON.parse(raw);
+        packageJson = typeof parsed === "object" && parsed !== null
+            ? parsed
+            : null;
+    }
+    catch {
+        // Missing or unparseable package.json → leave null
+    }
+    let boberConfig = null;
+    try {
+        const raw = await readFile(join(projectRoot, "bober.config.json"), "utf-8");
+        const parsed = JSON.parse(raw);
+        boberConfig = typeof parsed === "object" && parsed !== null
+            ? parsed
+            : null;
+    }
+    catch {
+        // Missing or unparseable bober.config.json → leave null
+    }
+    // ── Detect lockfile presence (fs.access is synchronous-ish, but async) ──
+    const [npmExists, yarnExists, pnpmExists] = await Promise.all([
+        access(join(projectRoot, "package-lock.json")).then(() => true).catch(() => false),
+        access(join(projectRoot, "yarn.lock")).then(() => true).catch(() => false),
+        access(join(projectRoot, "pnpm-lock.yaml")).then(() => true).catch(() => false),
+    ]);
+    const inputs = {
+        packageJson,
+        boberConfig,
+        lockfiles: { npm: npmExists, yarn: yarnExists, pnpm: pnpmExists },
+    };
+    // ── Detect (PURE) ─────────────────────────────────────────────────
+    const drafts = detectProjectFacts(inputs);
+    if (drafts.length === 0)
+        return;
+    // ── Write through reconcile (idempotent — NOOP on unchanged) ─────
+    // Stamp wall-clock once at the IO boundary (NEVER inside the pure fn).
+    const now = new Date().toISOString();
+    await ensureFactsDir(projectRoot, namespace);
+    const store = new FactStore(factsDbPath(projectRoot, namespace));
+    try {
+        for (const draft of drafts) {
+            await writeFact(store, { ...draft, tValid: now, tCreated: now }, { now });
+        }
+    }
+    finally {
+        store.close();
+    }
+}
+//# sourceMappingURL=fact-detector.js.map

package/dist/orchestrator/memory/fact-detector.js.map

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

package/dist/orchestrator/memory/fact-judge.d.ts

@@ -0,0 +1,19 @@
+import type { FactInput, FactRecord } from "../../state/facts.js";
+import type { ReconcileAction } from "./reconcile.js";
+/**
+ * Interface for resolving ambiguous fact collisions.
+ * The judge is consulted ONLY on a deterministic normalized-key collision
+ * where no exact (scope,subject,predicate) match exists.
+ */
+export interface FactJudge {
+    resolve(incoming: FactInput, candidate: FactRecord): Promise<ReconcileAction>;
+}
+/**
+ * Build an LLM-backed FactJudge.
+ * Mirrors the createClient pattern from src/orchestrator/architect-agent.ts:195-203.
+ * Honoring BOBER_TEST_DETERMINISTIC=1 automatically — createClient short-circuits
+ * to a DeterministicStubClient whose response is non-JSON, causing parseJudgeAction
+ * to return the FALLBACK "add".
+ */
+export declare function createLLMFactJudge(provider?: string | null, endpoint?: string | null, providerConfig?: Record<string, unknown>, model?: string): FactJudge;
+//# sourceMappingURL=fact-judge.d.ts.map

package/dist/orchestrator/memory/fact-judge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-judge.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/memory/fact-judge.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAItD;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC/E;AA6GD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,KAAK,CAAC,EAAE,MAAM,GACb,SAAS,CAUX"}

package/dist/orchestrator/memory/fact-judge.js

@@ -0,0 +1,121 @@
+// ── fact-judge.ts ──────────────────────────────────────────────────────
+//
+// LLM-backed FactJudge for resolving normalized-key ambiguity during
+// fact reconciliation. The ONLY place in the reconcile layer that imports
+// createClient or touches the network.
+//
+// On ANY parse failure or thrown error, resolve() returns "add" — never
+// lets the LLM corrupt the store.
+import { z } from "zod";
+import { createClient } from "../../providers/factory.js";
+import { resolveModel } from "../model-resolver.js";
+// ── Zod schema ─────────────────────────────────────────────────────────
+const JudgeResponseSchema = z.object({
+    action: z.enum(["add", "update", "delete", "noop"]),
+});
+const FALLBACK = "add";
+// ── Helpers (mirrored from turn-classifier.ts) ─────────────────────────
+/**
+ * Strip code fences (```json ... ``` or ``` ... ```) from a string.
+ */
+function stripCodeFences(text) {
+    return text.replace(/```(?:json)?\s*([\s\S]*?)```/g, "$1").trim();
+}
+/**
+ * Extract the first balanced {...} JSON object substring.
+ * Returns null if no balanced object found.
+ */
+function extractFirstObject(text) {
+    const start = text.indexOf("{");
+    if (start === -1)
+        return null;
+    let depth = 0;
+    for (let i = start; i < text.length; i++) {
+        if (text[i] === "{")
+            depth++;
+        else if (text[i] === "}") {
+            depth--;
+            if (depth === 0)
+                return text.slice(start, i + 1);
+        }
+    }
+    return null;
+}
+/**
+ * Defensively parse text into a ReconcileAction.
+ * Returns FALLBACK ("add") on any error.
+ */
+function parseJudgeAction(text) {
+    try {
+        const stripped = stripCodeFences(text);
+        const extracted = extractFirstObject(stripped) ?? stripped;
+        const parsed = JSON.parse(extracted);
+        const result = JudgeResponseSchema.safeParse(parsed);
+        if (result.success) {
+            return result.data.action;
+        }
+        return FALLBACK;
+    }
+    catch {
+        return FALLBACK;
+    }
+}
+// ── LLMFactJudge ──────────────────────────────────────────────────────
+class LLMFactJudge {
+    llm;
+    model;
+    constructor(llm, model) {
+        this.llm = llm;
+        this.model = model;
+    }
+    /**
+     * Resolve an ambiguous fact collision using an LLM judgment.
+     * Uses jsonObjectMode:true for provider parity.
+     * On ANY failure (network, parse error), returns "add" — never corrupts the store.
+     */
+    async resolve(incoming, candidate) {
+        const system = [
+            "You are a fact-reconciliation judge for a semantic knowledge store.",
+            "Given an INCOMING fact and a CANDIDATE active fact with the same normalized subject+predicate,",
+            "decide whether to add, update, delete, or ignore the incoming fact.",
+            "",
+            "Respond ONLY with a JSON object with an 'action' field:",
+            '  {"action":"add"}    — insert the incoming fact as a new active fact (both will coexist)',
+            '  {"action":"update"} — supersede the candidate with the incoming fact',
+            '  {"action":"delete"} — invalidate the candidate, do not insert incoming',
+            '  {"action":"noop"}   — discard the incoming fact, keep the candidate unchanged',
+            "",
+            "Return ONLY the JSON object, no other text.",
+        ].join("\n");
+        const userContent = [
+            `INCOMING: subject="${incoming.subject}", predicate="${incoming.predicate}", value="${incoming.value}"`,
+            `CANDIDATE: subject="${candidate.subject}", predicate="${candidate.predicate}", value="${candidate.value}"`,
+        ].join("\n");
+        try {
+            const response = await this.llm.chat({
+                model: this.model,
+                system,
+                messages: [{ role: "user", content: userContent }],
+                jsonObjectMode: true,
+            });
+            return parseJudgeAction(response.text);
+        }
+        catch {
+            return FALLBACK;
+        }
+    }
+}
+// ── Factory ────────────────────────────────────────────────────────────
+/**
+ * Build an LLM-backed FactJudge.
+ * Mirrors the createClient pattern from src/orchestrator/architect-agent.ts:195-203.
+ * Honoring BOBER_TEST_DETERMINISTIC=1 automatically — createClient short-circuits
+ * to a DeterministicStubClient whose response is non-JSON, causing parseJudgeAction
+ * to return the FALLBACK "add".
+ */
+export function createLLMFactJudge(provider, endpoint, providerConfig, model) {
+    const client = createClient(provider ?? null, endpoint ?? null, providerConfig, model, "FactJudge");
+    const resolvedModel = resolveModel(model ?? "sonnet");
+    return new LLMFactJudge(client, resolvedModel);
+}
+//# sourceMappingURL=fact-judge.js.map

package/dist/orchestrator/memory/fact-judge.js.map

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

package/dist/orchestrator/memory/fact-retrieve.d.ts

@@ -0,0 +1,52 @@
+/**
+ * PURE deterministic, STORE-ONLY retrieval of relevant project facts for the planner.
+ *
+ * Opens the FactStore once, reads active facts for the requested scope, then
+ * performs all ranking in memory (pure). Mirrors the retrieve.ts pattern for lessons.
+ *
+ * PURE beyond the single store open/read/close — no network, no Date.now(), no LLM.
+ */
+import type { FactRecord } from "../../state/facts.js";
+/**
+ * Load and rank at most `topK` active facts from the store that are relevant
+ * to the given `keywords` and `scope`.
+ *
+ * ONE store open/read/close, then pure ranking. Scope isolation is enforced by
+ * the SQL WHERE clause in FactStore.getActiveFacts(scope) — facts in scope A
+ * NEVER surface when querying scope B.
+ *
+ * Scoring: deterministic token-overlap between lowercased keyword tokens and
+ * each record's subject + predicate + value tokens.
+ * Sort: score DESC, then id ASC (byte-stable tiebreak, mirrors retrieve.ts:103).
+ *
+ * Design note: when keywords is empty, keywordTokens.size === 0, scoreFact
+ * returns 0 for all records, and the score > 0 filter yields an empty result.
+ * This matches retrieve.ts behaviour. Project facts are few and always written
+ * with known predicates, so callers should pass relevant keywords (e.g. from
+ * the user prompt) to surface them.
+ *
+ * @param projectRoot - Absolute path to the project root containing .bober/
+ * @param scope       - Fact scope (e.g. "" for default/programming team)
+ * @param keywords    - Keywords to rank against (e.g. from the user prompt)
+ * @param options     - topK cap and optional namespace (selects DB file location)
+ */
+export declare function retrieveRelevantFacts(projectRoot: string, scope: string, keywords: string[], { topK, namespace, }?: {
+    topK?: number;
+    namespace?: string;
+}): Promise<FactRecord[]>;
+/**
+ * Render a compact planner context block from an array of FactRecord values.
+ *
+ * Mirrors serializeLessonsForPlanner (retrieve.ts:122-144):
+ *   - Empty input → ""
+ *   - Header line + one "- subject/predicate: value" line per fact
+ *   - Hard charBudget slice (output length is GUARANTEED ≤ charBudget)
+ *
+ * @param records    - Already-ranked records (from retrieveRelevantFacts)
+ * @param options    - charBudget: hard character limit (default DEFAULT_CHAR_BUDGET)
+ * @returns Compact string block, at most charBudget characters
+ */
+export declare function serializeFactsForContext(records: FactRecord[], { charBudget }?: {
+    charBudget?: number;
+}): string;
+//# sourceMappingURL=fact-retrieve.d.ts.map

package/dist/orchestrator/memory/fact-retrieve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-retrieve.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/memory/fact-retrieve.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAiDvD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAAE,EAClB,EACE,IAAoB,EACpB,SAAS,GACV,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5C,OAAO,CAAC,UAAU,EAAE,CAAC,CAuBvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,UAAU,EAAE,EACrB,EAAE,UAAgC,EAAE,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACjE,MAAM,CAgBR"}