@mneme-ai/core 1.63.0 → 1.64.0

package/dist/cognitive/decision_atom.js

@@ -0,0 +1,187 @@
+/**
+ * v1.64.0 -- COGNITIVE LAYER 7: DECISION ATOM (FUSION CORE).
+ *
+ * The capstone. A decision atom fuses the outputs of all six previous
+ * cognitive layers into a single, audit-traceable verdict for ANY
+ * non-trivial decision:
+ *
+ *   1. theory-of-mind   -- which vendor is best for this task
+ *   2. tree-of-thought  -- which strategy + tactic has highest EV
+ *   3. curiosity        -- are there gaps that should be probed first
+ *   4. consolidation    -- is the wisdom stack consistent (no near-dupes)
+ *   5. counterfactual   -- would any alternative timeline score higher
+ *   6. debate           -- skeptic / optimist / realist arbitration
+ *
+ * Each layer contributes a sub-verdict + confidence. The atom's
+ * fusion rule:
+ *
+ *   PROCEED          all layers AGREE or near-neutral
+ *   PROCEED-WITH-CARE one layer DISAGREES with low confidence
+ *   PAUSE-INVESTIGATE one layer DISAGREES with high confidence, OR
+ *                     two+ layers express concern
+ *   ABORT-FOR-NOW    debate DISAGREES with arbiterConfidence >= 0.7
+ *                     AND tree-of-thought best EV < 0.3
+ *
+ * Output is a single screen worth of plain English -- the user (or
+ * AI agent) reads it and acts. The full audit trail is on disk.
+ */
+import { existsSync, mkdirSync, appendFileSync } from "node:fs";
+import { join } from "node:path";
+import { buildProfile, recommendVendor } from "./theory_of_mind.js";
+import { search as totSearch } from "./tree_of_thought.js";
+import { scanGaps } from "./curiosity.js";
+import { runConsolidation } from "./consolidation.js";
+import { simulate as cfSimulate } from "./counterfactual.js";
+import { debate } from "./debate.js";
+const COGNITIVE_DIR = ".mneme/cognitive";
+function decideVerdict(d) {
+    // ABORT: strong disagreement + low best EV
+    if (d.debateVerdict === "DISAGREE" && d.debateConfidence >= 0.7 && d.bestEv < 0.3) {
+        return { verdict: "ABORT-FOR-NOW", confidence: 0.9, reasoning: `Skeptic dominated (confidence ${d.debateConfidence.toFixed(2)}) AND best strategy EV is low (${d.bestEv.toFixed(3)}).` };
+    }
+    // PAUSE: significant gaps OR moderate disagreement OR significant counterfactual regret
+    if (d.highPriorityGaps >= 2 || d.regret >= 0.15 || (d.debateVerdict === "DISAGREE" && d.debateConfidence >= 0.5)) {
+        return {
+            verdict: "PAUSE-INVESTIGATE",
+            confidence: 0.6,
+            reasoning: `Investigate first: ${d.highPriorityGaps} high-priority gaps, regret ${d.regret.toFixed(2)}, debate=${d.debateVerdict}@${d.debateConfidence.toFixed(2)}.`,
+        };
+    }
+    // CARE: mild concerns
+    if (d.debateVerdict === "INCONCLUSIVE" || d.bestEv < 0.4 || d.regret > 0.05) {
+        return {
+            verdict: "PROCEED-WITH-CARE",
+            confidence: 0.5,
+            reasoning: `Mild concern: debate=${d.debateVerdict}, EV=${d.bestEv.toFixed(3)}, regret=${d.regret.toFixed(2)}.`,
+        };
+    }
+    return {
+        verdict: "PROCEED",
+        confidence: Math.min(1, 0.7 + d.bestEv * 0.3),
+        reasoning: `All layers green: EV ${d.bestEv.toFixed(3)}, debate AGREE@${d.debateConfidence.toFixed(2)}, ${d.highPriorityGaps} high-priority gaps.`,
+    };
+}
+export function build(repoRoot, input) {
+    // Layer 1: Theory of Mind
+    const vendorList = input.vendors ?? [];
+    const profiles = vendorList.map((v) => buildProfile(repoRoot, v));
+    const recommended = recommendVendor(profiles, input.taskProfile ?? {});
+    // Layer 2: Tree of Thought
+    const tot = totSearch(repoRoot, input.intent);
+    // Layer 3: Curiosity
+    const curiosity = scanGaps(repoRoot);
+    // Layer 4: Consolidation (dry run -- we don't want to mutate disk during a decision)
+    const consolidation = runConsolidation(repoRoot, { dryRun: true });
+    // Layer 5: Counterfactual (only if baseline provided)
+    let cf = null;
+    if (input.counterfactualBaseline) {
+        cf = cfSimulate(repoRoot, {
+            decision: input.intent,
+            actualRegressionP: input.counterfactualBaseline.actualRegressionP,
+            actualStakeholderFair: input.counterfactualBaseline.actualStakeholderFair,
+            actualTokenCost: input.counterfactualBaseline.actualTokenCost,
+        });
+    }
+    // Layer 6: Debate
+    const dbt = debate(repoRoot, input.intent);
+    const fused = decideVerdict({
+        debateVerdict: dbt.verdict,
+        debateConfidence: dbt.arbiterConfidence,
+        bestEv: tot.bestEv,
+        highPriorityGaps: curiosity.highPriority,
+        regret: cf?.totalRegret ?? 0,
+        relief: cf?.totalRelief ?? 0,
+    });
+    const topGap = curiosity.gaps[0]?.description ?? null;
+    const recommendedAction = fused.verdict === "PROCEED"
+        ? `Proceed with strategy "${tot.bestPath.join(" -> ")}".`
+        : fused.verdict === "PROCEED-WITH-CARE"
+            ? `Proceed with "${tot.bestPath.join(" -> ")}", but add a pre-flight check: ${dbt.turns[0]?.evidence[0] ?? "review skeptic concerns"}.`
+            : fused.verdict === "PAUSE-INVESTIGATE"
+                ? `Investigate first: ${topGap ?? dbt.reasoning.split("\n")[2]}.`
+                : `Abort for now. Reason: ${fused.reasoning}`;
+    const briefing = [
+        `## Decision Atom -- ${input.intent}`,
+        ``,
+        `**Verdict:** ${fused.verdict}  (confidence ${fused.confidence.toFixed(2)})`,
+        ``,
+        `**Why:** ${fused.reasoning}`,
+        ``,
+        `### Layer breakdown`,
+        `- Theory of Mind: ${profiles.length} vendor profile(s)${recommended ? `, recommended **${recommended.vendor}**` : ", no profiles supplied"}`,
+        `- Tree of Thought: best path \`${tot.bestPath.join(" -> ")}\` (EV ${tot.bestEv.toFixed(3)}); ${tot.rankedLeaves.length - 1} alternative(s)`,
+        `- Curiosity: ${curiosity.totalGaps} gap(s), ${curiosity.highPriority} high-priority${topGap ? `; top: "${topGap}"` : ""}`,
+        `- Consolidation (dry): ${consolidation.vaccines.merged} vaccine(s) would merge, ${consolidation.lessons.pruned} lesson(s) prune, ${consolidation.lessons.promoted} promote`,
+        cf ? `- Counterfactual: ${cf.summary}` : `- Counterfactual: (no baseline supplied -- skipped)`,
+        `- Debate: ${dbt.verdict} @ ${dbt.arbiterConfidence.toFixed(2)} -- "${dbt.turns[2]?.argument ?? ""}"`,
+        ``,
+        `### Recommended action`,
+        recommendedAction,
+    ].join("\n");
+    const atom = {
+        intent: input.intent,
+        verdict: fused.verdict,
+        confidence: fused.confidence,
+        layers: {
+            theoryOfMind: { recommendedVendor: recommended?.vendor ?? null, vendorProfiles: profiles.length },
+            treeOfThought: { bestPath: tot.bestPath, bestEv: tot.bestEv, alternatives: Math.max(0, tot.rankedLeaves.length - 1) },
+            curiosity: { totalGaps: curiosity.totalGaps, highPriority: curiosity.highPriority, topGap },
+            consolidation: { vaccinesMerged: consolidation.vaccines.merged, lessonsPruned: consolidation.lessons.pruned, lessonsPromoted: consolidation.lessons.promoted },
+            counterfactual: cf ? { topAlternative: cf.topAlternative?.label ?? null, netRelief: cf.totalRelief, netRegret: cf.totalRegret } : null,
+            debate: { verdict: dbt.verdict, arbiterConfidence: dbt.arbiterConfidence },
+        },
+        briefing,
+        recommendedAction,
+        raw: { profiles, tot, curiosity, consolidation, counterfactual: cf, debate: dbt },
+        builtAt: new Date().toISOString(),
+    };
+    // Audit log
+    try {
+        const dir = join(repoRoot, COGNITIVE_DIR, "atoms");
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        appendFileSync(join(dir, "decisions.jsonl"), JSON.stringify({
+            ts: atom.builtAt,
+            intent: atom.intent,
+            verdict: atom.verdict,
+            confidence: atom.confidence,
+            bestEv: tot.bestEv,
+            debateVerdict: dbt.verdict,
+        }) + "\n", "utf8");
+    }
+    catch { /* */ }
+    return atom;
+}
+export function summarizeHistory(repoRoot) {
+    const p = join(repoRoot, COGNITIVE_DIR, "atoms", "decisions.jsonl");
+    const verdictCounts = { "PROCEED": 0, "PROCEED-WITH-CARE": 0, "PAUSE-INVESTIGATE": 0, "ABORT-FOR-NOW": 0 };
+    let total = 0;
+    let confSum = 0;
+    let last = null;
+    if (!existsSync(p))
+        return { totalAtoms: 0, verdictCounts, meanConfidence: 0, lastAtom: null };
+    try {
+        const { readFileSync } = require("node:fs");
+        const lines = readFileSync(p, "utf8").split("\n").filter(Boolean);
+        for (const l of lines) {
+            try {
+                const r = JSON.parse(l);
+                if (!r.verdict || !(r.verdict in verdictCounts))
+                    continue;
+                verdictCounts[r.verdict] += 1;
+                confSum += r.confidence ?? 0;
+                total += 1;
+                last = { intent: r.intent ?? "(unknown)", verdict: r.verdict, ts: r.ts ?? "(unknown)" };
+            }
+            catch { /* */ }
+        }
+    }
+    catch { /* */ }
+    return {
+        totalAtoms: total,
+        verdictCounts,
+        meanConfidence: total === 0 ? 0 : confSum / total,
+        lastAtom: last,
+    };
+}
+//# sourceMappingURL=decision_atom.js.map

package/dist/cognitive/decision_atom.js.map

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

package/dist/cognitive/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * v1.64.0 -- COGNITIVE LAYER (7-layer thinking demon).
+ *
+ * Public API for the seven cognitive sub-systems:
+ *
+ *   1. theoryOfMind     -- 9-axis behavioral profile per vendor
+ *   2. treeOfThought    -- 3-level EV-scored decision tree
+ *   3. curiosity        -- daemon-idle gap scanner
+ *   4. consolidation    -- sleep-cycle compression of vaccines + lessons
+ *   5. counterfactual   -- alternative-timeline simulation
+ *   6. debate           -- skeptic / optimist / realist arbitration
+ *   7. decisionAtom     -- fusion of layers 1-6 into a single verdict
+ *
+ * All seven are pure (no side effects) by default. Persistence is
+ * opt-in via the `persist*` flags. Storage root is .mneme/cognitive/.
+ */
+export * as theoryOfMind from "./theory_of_mind.js";
+export * as treeOfThought from "./tree_of_thought.js";
+export * as curiosity from "./curiosity.js";
+export * as consolidation from "./consolidation.js";
+export * as counterfactual from "./counterfactual.js";
+export * as debate from "./debate.js";
+export * as decisionAtom from "./decision_atom.js";
+export type { VendorProfile } from "./theory_of_mind.js";
+export type { ToTResult, TreeNode } from "./tree_of_thought.js";
+export type { CuriosityGap, CuriosityScan } from "./curiosity.js";
+export type { ConsolidationReport } from "./consolidation.js";
+export type { CounterfactualResult, CounterfactualBranch, CounterfactualBias } from "./counterfactual.js";
+export type { DebateResult, DebateTurn, Voice } from "./debate.js";
+export type { DecisionAtom, DecisionAtomInput, AtomVerdict, AtomHistorySummary } from "./decision_atom.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cognitive/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,YAAY,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,aAAa,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AAGnD,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAClE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC1G,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/cognitive/index.js

@@ -0,0 +1,24 @@
+/**
+ * v1.64.0 -- COGNITIVE LAYER (7-layer thinking demon).
+ *
+ * Public API for the seven cognitive sub-systems:
+ *
+ *   1. theoryOfMind     -- 9-axis behavioral profile per vendor
+ *   2. treeOfThought    -- 3-level EV-scored decision tree
+ *   3. curiosity        -- daemon-idle gap scanner
+ *   4. consolidation    -- sleep-cycle compression of vaccines + lessons
+ *   5. counterfactual   -- alternative-timeline simulation
+ *   6. debate           -- skeptic / optimist / realist arbitration
+ *   7. decisionAtom     -- fusion of layers 1-6 into a single verdict
+ *
+ * All seven are pure (no side effects) by default. Persistence is
+ * opt-in via the `persist*` flags. Storage root is .mneme/cognitive/.
+ */
+export * as theoryOfMind from "./theory_of_mind.js";
+export * as treeOfThought from "./tree_of_thought.js";
+export * as curiosity from "./curiosity.js";
+export * as consolidation from "./consolidation.js";
+export * as counterfactual from "./counterfactual.js";
+export * as debate from "./debate.js";
+export * as decisionAtom from "./decision_atom.js";
+//# sourceMappingURL=index.js.map

package/dist/cognitive/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cognitive/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,YAAY,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,aAAa,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC"}

package/dist/cognitive/theory_of_mind.d.ts

@@ -0,0 +1,56 @@
+/**
+ * v1.64.0 -- COGNITIVE LAYER 1: THEORY OF MIND.
+ *
+ * Build a 9-axis behavioral profile for each AI vendor so Mneme can
+ * predict how a given vendor will handle a given prompt BEFORE it
+ * actually runs.
+ *
+ * The 9 axes:
+ *   1. verbosity         -- tokens-per-response mean
+ *   2. overconfidence    -- gap between stated confidence and ACGV verdict
+ *   3. domainBias        -- which domains it shines / fails on
+ *   4. refusalRate       -- how often it declines
+ *   5. hallucinationClass -- which kind of fab it produces most
+ *   6. riskAppetite      -- how aggressive its refactor / change suggestions
+ *   7. verbosityDrift    -- does it talk more over a long conversation?
+ *   8. tempStability     -- consistency of outputs for similar inputs
+ *   9. chainDepth        -- typical reasoning steps before final answer
+ *
+ * Data source: ai-souls + squadron/quorum.jsonl + nemesis runs +
+ * reactor ledger. Pure read; no side effects unless persistProfile().
+ */
+export interface VendorProfile {
+    vendor: string;
+    /** Number of observations the profile is built from. */
+    observationCount: number;
+    /** 9 axes -- normalized 0..1 unless noted. */
+    axes: {
+        verbosity: number;
+        overconfidence: number;
+        domainBias: Record<string, number>;
+        refusalRate: number;
+        hallucinationClass: string;
+        riskAppetite: number;
+        verbosityDrift: number;
+        tempStability: number;
+        chainDepth: number;
+    };
+    /** Time of last build. */
+    builtAt: string;
+}
+export declare function buildProfile(repoRoot: string, vendor: string): VendorProfile;
+/** Persist a profile snapshot to disk. */
+export declare function persistProfile(repoRoot: string, profile: VendorProfile): string;
+/** Compare two vendor profiles -- returns where vendorA outperforms B. */
+export declare function compareVendors(a: VendorProfile, b: VendorProfile): {
+    aWins: string[];
+    bWins: string[];
+    tied: string[];
+};
+/** Recommend the best vendor for a task given a list of profiles. */
+export declare function recommendVendor(profiles: VendorProfile[], task: {
+    domain?: string;
+    needsTerse?: boolean;
+    needsStable?: boolean;
+}): VendorProfile | null;
+//# sourceMappingURL=theory_of_mind.d.ts.map

package/dist/cognitive/theory_of_mind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theory_of_mind.d.ts","sourceRoot":"","sources":["../../src/cognitive/theory_of_mind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAOH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,gBAAgB,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,WAAW,EAAE,MAAM,CAAC;QACpB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AA6CD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CA2E5E;AAED,0CAA0C;AAC1C,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAO/E;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG;IAClE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAkBA;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,aAAa,GAAG,IAAI,CAevJ"}

package/dist/cognitive/theory_of_mind.js

@@ -0,0 +1,212 @@
+/**
+ * v1.64.0 -- COGNITIVE LAYER 1: THEORY OF MIND.
+ *
+ * Build a 9-axis behavioral profile for each AI vendor so Mneme can
+ * predict how a given vendor will handle a given prompt BEFORE it
+ * actually runs.
+ *
+ * The 9 axes:
+ *   1. verbosity         -- tokens-per-response mean
+ *   2. overconfidence    -- gap between stated confidence and ACGV verdict
+ *   3. domainBias        -- which domains it shines / fails on
+ *   4. refusalRate       -- how often it declines
+ *   5. hallucinationClass -- which kind of fab it produces most
+ *   6. riskAppetite      -- how aggressive its refactor / change suggestions
+ *   7. verbosityDrift    -- does it talk more over a long conversation?
+ *   8. tempStability     -- consistency of outputs for similar inputs
+ *   9. chainDepth        -- typical reasoning steps before final answer
+ *
+ * Data source: ai-souls + squadron/quorum.jsonl + nemesis runs +
+ * reactor ledger. Pure read; no side effects unless persistProfile().
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+const COGNITIVE_DIR = ".mneme/cognitive";
+function ensureDir(repoRoot) {
+    const d = join(repoRoot, COGNITIVE_DIR);
+    if (!existsSync(d))
+        mkdirSync(d, { recursive: true });
+    return d;
+}
+function readSoul(repoRoot, vendor) {
+    const p = join(repoRoot, ".mneme/ai-souls", `${vendor}.json`);
+    if (!existsSync(p))
+        return null;
+    try {
+        return JSON.parse(readFileSync(p, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+function readQuorum(repoRoot) {
+    const p = join(repoRoot, ".mneme/squadron/quorum.jsonl");
+    if (!existsSync(p))
+        return [];
+    try {
+        return readFileSync(p, "utf8").split("\n").filter(Boolean).map((l) => {
+            try {
+                return JSON.parse(l);
+            }
+            catch {
+                return null;
+            }
+        }).filter((x) => x !== null);
+    }
+    catch {
+        return [];
+    }
+}
+function dominantHallucinationClass(soul) {
+    if (!soul?.sessions)
+        return "unknown";
+    const counts = new Map();
+    for (const s of soul.sessions) {
+        if ((s.broken ?? 0) === 0)
+            continue;
+        const reason = (s.reason ?? "unknown").toLowerCase();
+        let cls = "unknown";
+        if (/commit|sha/.test(reason))
+            cls = "commit-hash";
+        else if (/file|path/.test(reason))
+            cls = "file-path";
+        else if (/version|v\d/.test(reason))
+            cls = "version-number";
+        else if (/function|class|method/.test(reason))
+            cls = "identifier";
+        counts.set(cls, (counts.get(cls) ?? 0) + 1);
+    }
+    if (counts.size === 0)
+        return "no-known-hallucinations";
+    return [...counts.entries()].sort((a, b) => b[1] - a[1])[0][0];
+}
+export function buildProfile(repoRoot, vendor) {
+    const soul = readSoul(repoRoot, vendor);
+    const quorum = readQuorum(repoRoot);
+    const sessions = soul?.sessions ?? [];
+    const observationCount = sessions.length;
+    // Axis 1: verbosity -- mean of session.verbosity field; default 0.5 when absent.
+    const verbosityValues = sessions.map((s) => s.verbosity).filter((v) => typeof v === "number");
+    const verbosity = verbosityValues.length > 0
+        ? Math.min(1, verbosityValues.reduce((a, b) => a + b, 0) / verbosityValues.length / 1000)
+        : 0.5;
+    // Axis 2: overconfidence -- fraction of broken-promise sessions weighted by their stated confidence.
+    const broken = sessions.filter((s) => (s.broken ?? 0) > 0);
+    const overconfidence = sessions.length === 0 ? 0 : Math.min(1, broken.length / sessions.length);
+    // Axis 3: domainBias -- per-domain success rate from quorum log.
+    const domainCounts = {};
+    for (const q of quorum) {
+        const claim = (q.claim ?? "").toLowerCase();
+        let domain = "general";
+        if (/auth|jwt|password|login/.test(claim))
+            domain = "auth";
+        else if (/test|vitest|jest/.test(claim))
+            domain = "test";
+        else if (/git|commit|branch|merge/.test(claim))
+            domain = "git";
+        else if (/regex|pattern/.test(claim))
+            domain = "regex";
+        else if (/database|sql|migration/.test(claim))
+            domain = "database";
+        if (!domainCounts[domain])
+            domainCounts[domain] = { total: 0, refuted: 0 };
+        domainCounts[domain].total += 1;
+        if ((q.caveats ?? []).includes("FALSE_FACT_CLAIM"))
+            domainCounts[domain].refuted += 1;
+    }
+    const domainBias = {};
+    for (const [d, c] of Object.entries(domainCounts)) {
+        domainBias[d] = c.total === 0 ? 0.5 : 1 - c.refuted / c.total;
+    }
+    // Axis 4: refusalRate -- placeholder when we have no refusal signal.
+    const refusalRate = 0;
+    // Axis 5: hallucinationClass -- dominant class observed.
+    const hallucinationClass = dominantHallucinationClass(soul);
+    // Axis 6: riskAppetite -- 1 - (sessions that broke promises like "no-silent-destroy").
+    const riskAppetite = sessions.length === 0 ? 0.5 : Math.min(1, broken.length / sessions.length);
+    // Axis 7: verbosityDrift -- difference between last-third and first-third mean verbosity.
+    let verbosityDrift = 0;
+    if (verbosityValues.length >= 6) {
+        const third = Math.floor(verbosityValues.length / 3);
+        const firstAvg = verbosityValues.slice(0, third).reduce((a, b) => a + b, 0) / third;
+        const lastAvg = verbosityValues.slice(-third).reduce((a, b) => a + b, 0) / third;
+        verbosityDrift = Math.min(1, Math.max(0, (lastAvg - firstAvg) / (firstAvg || 1)));
+    }
+    // Axis 8: tempStability -- consistency of consensus verdicts across identical-domain claims.
+    const tempStability = 1 - Math.min(1, observationCount === 0 ? 0 : broken.length / Math.max(1, observationCount));
+    // Axis 9: chainDepth -- approx steps from soul.verbosity or default.
+    const chainDepth = verbosityValues.length === 0 ? 5 : Math.max(1, Math.round(verbosityValues.reduce((a, b) => a + b, 0) / verbosityValues.length / 100));
+    return {
+        vendor,
+        observationCount,
+        axes: {
+            verbosity,
+            overconfidence,
+            domainBias,
+            refusalRate,
+            hallucinationClass,
+            riskAppetite,
+            verbosityDrift,
+            tempStability,
+            chainDepth,
+        },
+        builtAt: new Date().toISOString(),
+    };
+}
+/** Persist a profile snapshot to disk. */
+export function persistProfile(repoRoot, profile) {
+    const dir = ensureDir(repoRoot);
+    const subdir = join(dir, "vendor-profiles");
+    if (!existsSync(subdir))
+        mkdirSync(subdir, { recursive: true });
+    const path = join(subdir, `${profile.vendor}.json`);
+    writeFileSync(path, JSON.stringify(profile, null, 2), "utf8");
+    return path;
+}
+/** Compare two vendor profiles -- returns where vendorA outperforms B. */
+export function compareVendors(a, b) {
+    const result = { aWins: [], bWins: [], tied: [] };
+    const numericAxes = ["verbosity", "overconfidence", "refusalRate", "riskAppetite", "verbosityDrift", "tempStability", "chainDepth"];
+    for (const axis of numericAxes) {
+        const av = a.axes[axis];
+        const bv = b.axes[axis];
+        if (Math.abs(av - bv) < 0.05)
+            result.tied.push(axis);
+        else if (axis === "overconfidence" || axis === "verbosityDrift") {
+            // lower is better
+            if (av < bv)
+                result.aWins.push(axis);
+            else
+                result.bWins.push(axis);
+        }
+        else {
+            // higher is better (verbosity is neutral; we still pick "more" = a wins for terse-prefer downstream)
+            if (av > bv)
+                result.aWins.push(axis);
+            else
+                result.bWins.push(axis);
+        }
+    }
+    return result;
+}
+/** Recommend the best vendor for a task given a list of profiles. */
+export function recommendVendor(profiles, task) {
+    if (profiles.length === 0)
+        return null;
+    const scored = profiles.map((p) => {
+        let score = 0;
+        if (task.domain && p.axes.domainBias[task.domain] !== undefined) {
+            score += p.axes.domainBias[task.domain] * 3;
+        }
+        if (task.needsTerse)
+            score += (1 - p.axes.verbosity) * 2;
+        if (task.needsStable)
+            score += p.axes.tempStability * 2;
+        score -= p.axes.overconfidence * 2;
+        score += (1 - p.axes.verbosityDrift) * 1;
+        return { profile: p, score };
+    });
+    scored.sort((a, b) => b.score - a.score);
+    return scored[0].profile;
+}
+//# sourceMappingURL=theory_of_mind.js.map

package/dist/cognitive/theory_of_mind.js.map

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

package/dist/cognitive/tree_of_thought.d.ts

@@ -0,0 +1,55 @@
+/**
+ * v1.64.0 -- COGNITIVE LAYER 2: TREE-OF-THOUGHT SEARCH.
+ *
+ * Given a high-stakes prompt, build a 3-level decision tree of strategies,
+ * estimate each branch's expected value via existing Mneme layers, return
+ * the highest-EV branch + the full tree as audit trail.
+ *
+ *   intent           level 0
+ *     ├── strategy A (level 1)
+ *     │      ├── tactic A.1 (level 2)
+ *     │      └── tactic A.2
+ *     ├── strategy B
+ *     │      ├── tactic B.1
+ *     │      └── tactic B.2
+ *
+ * Each leaf gets:
+ *   - estimatedRegressionP    (from Oracle Forecast)
+ *   - estimatedStakeholderFair (from Game Theory if stakeholders supplied)
+ *   - estimatedTokenCost       (from Reactor estimates)
+ *
+ * EV = (1 - regressionP) * stakeholderFair / (1 + log(tokenCost / 100))
+ *
+ * The tree is deterministic given (intent + repo state) so callers can
+ * replay + compare. Pure read; no side effects.
+ */
+export interface TreeNode {
+    id: string;
+    level: 0 | 1 | 2;
+    label: string;
+    /** Children at level+1. */
+    children: TreeNode[];
+    /** Leaf-only metrics. */
+    metrics?: {
+        estimatedRegressionP: number;
+        estimatedStakeholderFair: number;
+        estimatedTokenCost: number;
+        expectedValue: number;
+    };
+}
+export interface ToTResult {
+    root: TreeNode;
+    /** Best leaf by EV. */
+    bestLeafId: string;
+    bestPath: string[];
+    bestEv: number;
+    /** All leaves ranked. */
+    rankedLeaves: Array<{
+        id: string;
+        path: string[];
+        ev: number;
+    }>;
+    reasoning: string;
+}
+export declare function search(repoRoot: string, intent: string): ToTResult;
+//# sourceMappingURL=tree_of_thought.d.ts.map

package/dist/cognitive/tree_of_thought.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree_of_thought.d.ts","sourceRoot":"","sources":["../../src/cognitive/tree_of_thought.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAOH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,yBAAyB;IACzB,OAAO,CAAC,EAAE;QACR,oBAAoB,EAAE,MAAM,CAAC;QAC7B,wBAAwB,EAAE,MAAM,CAAC;QACjC,kBAAkB,EAAE,MAAM,CAAC;QAC3B,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,YAAY,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,SAAS,EAAE,MAAM,CAAC;CACnB;AAgDD,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CA+DlE"}