@mneme-ai/core 1.62.0 → 1.64.0

package/dist/cognitive/curiosity.js

@@ -0,0 +1,191 @@
+/**
+ * v1.64.0 -- COGNITIVE LAYER 3: CURIOSITY ENGINE.
+ *
+ * Daemon-idle gap detector. Scan the wisdom stack, find areas where
+ * Mneme has DATA but no DEFENSE (commits about X but no vaccines)
+ * or VICE VERSA. Generate test claims that probe the gap. Either:
+ *  - the claim grounds (Mneme adds it to its known-truths)
+ *  - the claim refutes (Mneme emits a new vaccine)
+ *
+ * Either way: a gap closes. Mneme gets smarter on its own.
+ *
+ * NO LLM. Heuristic gap scan over .mneme/squadron + .mneme/forecast +
+ * .mneme/whisper.
+ */
+import { existsSync, readFileSync, mkdirSync, appendFileSync } from "node:fs";
+import { join } from "node:path";
+const COGNITIVE_DIR = ".mneme/cognitive";
+function tokenize(s) {
+    return Array.from(new Set((s.toLowerCase().match(/[a-z][a-z0-9_-]+/g) ?? []).filter((t) => t.length >= 4)));
+}
+function readRecentCommitSubjects(repoRoot, max = 100) {
+    try {
+        const { execSync } = require("node:child_process");
+        const r = execSync(`git -C "${repoRoot}" log --max-count=${max} --pretty=format:%s`, {
+            encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], timeout: 3000,
+        });
+        return r.split("\n").filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+function readVaccineSamples(repoRoot) {
+    const p = join(repoRoot, ".mneme/squadron/lie-vaccines.jsonl");
+    if (!existsSync(p))
+        return [];
+    try {
+        return readFileSync(p, "utf8").split("\n").filter(Boolean).map((l) => {
+            try {
+                return JSON.parse(l).sample ?? "";
+            }
+            catch {
+                return "";
+            }
+        }).filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+function readForecastClaims(repoRoot) {
+    const p = join(repoRoot, ".mneme/forecast/forecasts.jsonl");
+    if (!existsSync(p))
+        return [];
+    try {
+        return readFileSync(p, "utf8").split("\n").filter(Boolean).map((l) => {
+            try {
+                return JSON.parse(l).claim ?? "";
+            }
+            catch {
+                return "";
+            }
+        }).filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+/** Find the top areas with many commits but no vaccines defending them. */
+function findCommitGaps(repoRoot) {
+    const subjects = readRecentCommitSubjects(repoRoot, 100);
+    const vaccines = readVaccineSamples(repoRoot);
+    const vaccineTokens = new Set();
+    for (const v of vaccines)
+        for (const t of tokenize(v))
+            vaccineTokens.add(t);
+    const commitTopics = new Map();
+    for (const subj of subjects) {
+        for (const t of tokenize(subj)) {
+            if (t.length < 5)
+                continue;
+            commitTopics.set(t, (commitTopics.get(t) ?? 0) + 1);
+        }
+    }
+    const gaps = [];
+    const sorted = [...commitTopics.entries()].sort((a, b) => b[1] - a[1]).slice(0, 5);
+    for (const [topic, count] of sorted) {
+        if (vaccineTokens.has(topic))
+            continue;
+        const priority = Math.min(1, count / 10);
+        gaps.push({
+            id: `gap-commit-${topic.slice(0, 16)}`,
+            description: `${count} recent commit(s) about "${topic}" but no vaccine defending against fab claims in this area`,
+            source: "commit-no-vaccine",
+            suggestedProbe: `is "${topic}" in this codebase implemented correctly`,
+            priority,
+        });
+    }
+    return gaps;
+}
+/** Find forecasts that have only ONE sample (no trend yet). */
+function findForecastGaps(repoRoot) {
+    const claims = readForecastClaims(repoRoot);
+    const counts = new Map();
+    for (const c of claims) {
+        const key = tokenize(c).slice(0, 3).join("-");
+        if (!key)
+            continue;
+        counts.set(key, (counts.get(key) ?? 0) + 1);
+    }
+    const gaps = [];
+    for (const [key, count] of counts) {
+        if (count >= 2)
+            continue;
+        gaps.push({
+            id: `gap-forecast-${key.slice(0, 16)}`,
+            description: `Only ${count} forecast(s) recorded for area "${key}"; cannot compute trend yet`,
+            source: "forecast-no-trend",
+            suggestedProbe: `run a second forecast on a claim mentioning "${key}"`,
+            priority: 0.3,
+        });
+    }
+    return gaps.slice(0, 5);
+}
+/** Detect stale areas: high commit-count topics with no recent forecasts. */
+function findStaleAreas(repoRoot) {
+    const subjects = readRecentCommitSubjects(repoRoot, 200);
+    const forecastClaims = readForecastClaims(repoRoot);
+    const forecastTokens = new Set();
+    for (const c of forecastClaims)
+        for (const t of tokenize(c))
+            forecastTokens.add(t);
+    const commitTopics = new Map();
+    for (const subj of subjects) {
+        for (const t of tokenize(subj)) {
+            if (t.length < 6)
+                continue;
+            commitTopics.set(t, (commitTopics.get(t) ?? 0) + 1);
+        }
+    }
+    const gaps = [];
+    const sorted = [...commitTopics.entries()].sort((a, b) => b[1] - a[1]).slice(0, 3);
+    for (const [topic, count] of sorted) {
+        if (forecastTokens.has(topic) || count < 3)
+            continue;
+        gaps.push({
+            id: `gap-stale-${topic.slice(0, 16)}`,
+            description: `Active area "${topic}" (${count} commits) has no forecast coverage`,
+            source: "stale-area",
+            suggestedProbe: `forecast regression risk for next change touching "${topic}"`,
+            priority: Math.min(1, count / 8),
+        });
+    }
+    return gaps;
+}
+/** Scan all wisdom layers for gaps. */
+export function scanGaps(repoRoot) {
+    const allGaps = [
+        ...findCommitGaps(repoRoot),
+        ...findForecastGaps(repoRoot),
+        ...findStaleAreas(repoRoot),
+    ];
+    // Dedup by id.
+    const seen = new Set();
+    const unique = allGaps.filter((g) => {
+        if (seen.has(g.id))
+            return false;
+        seen.add(g.id);
+        return true;
+    });
+    unique.sort((a, b) => b.priority - a.priority);
+    return {
+        gaps: unique,
+        scannedAt: new Date().toISOString(),
+        totalGaps: unique.length,
+        highPriority: unique.filter((g) => g.priority >= 0.6).length,
+    };
+}
+/** Log a probe that was actually executed in response to a gap. */
+export function logProbeExecution(repoRoot, gapId, outcome) {
+    try {
+        const dir = join(repoRoot, COGNITIVE_DIR, "curiosity");
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        appendFileSync(join(dir, "probes.jsonl"), JSON.stringify({
+            ts: new Date().toISOString(), gapId, outcome,
+        }) + "\n", "utf8");
+    }
+    catch { /* */ }
+}
+//# sourceMappingURL=curiosity.js.map

package/dist/cognitive/curiosity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curiosity.js","sourceRoot":"","sources":["../../src/cognitive/curiosity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,aAAa,GAAG,kBAAkB,CAAC;AAsBzC,SAAS,QAAQ,CAAC,CAAS;IACzB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CACvB,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAChF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,wBAAwB,CAAC,QAAgB,EAAE,GAAG,GAAG,GAAG;IAC3D,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAwC,CAAC;QAC1F,MAAM,CAAC,GAAG,QAAQ,CAAC,WAAW,QAAQ,qBAAqB,GAAG,qBAAqB,EAAE;YACnF,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI;SACrE,CAAC,CAAC;QACH,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC;IAAC,CAAC;AACxB,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,oCAAoC,CAAC,CAAC;IAC/D,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACnE,IAAI,CAAC;gBAAC,OAAQ,IAAI,CAAC,KAAK,CAAC,CAAC,CAAyB,CAAC,MAAM,IAAI,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO,EAAE,CAAC;YAAC,CAAC;QAC1F,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC;IAAC,CAAC;AACxB,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,iCAAiC,CAAC,CAAC;IAC5D,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACnE,IAAI,CAAC;gBAAC,OAAQ,IAAI,CAAC,KAAK,CAAC,CAAC,CAAwB,CAAC,KAAK,IAAI,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO,EAAE,CAAC;YAAC,CAAC;QACxF,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC;IAAC,CAAC;AACxB,CAAC;AAED,2EAA2E;AAC3E,SAAS,cAAc,CAAC,QAAgB;IACtC,MAAM,QAAQ,GAAG,wBAAwB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;YAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5E,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;gBAAE,SAAS;YAC3B,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAmB,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,CAAC,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnF,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACpC,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC;YACR,EAAE,EAAE,cAAc,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;YACtC,WAAW,EAAE,GAAG,KAAK,4BAA4B,KAAK,4DAA4D;YAClH,MAAM,EAAE,mBAAmB;YAC3B,cAAc,EAAE,OAAO,KAAK,0CAA0C;YACtE,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+DAA+D;AAC/D,SAAS,gBAAgB,CAAC,QAAgB;IACxC,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,IAAI,GAAmB,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QAClC,IAAI,KAAK,IAAI,CAAC;YAAE,SAAS;QACzB,IAAI,CAAC,IAAI,CAAC;YACR,EAAE,EAAE,gBAAgB,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;YACtC,WAAW,EAAE,QAAQ,KAAK,mCAAmC,GAAG,6BAA6B;YAC7F,MAAM,EAAE,mBAAmB;YAC3B,cAAc,EAAE,gDAAgD,GAAG,GAAG;YACtE,QAAQ,EAAE,GAAG;SACd,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1B,CAAC;AAED,6EAA6E;AAC7E,SAAS,cAAc,CAAC,QAAgB;IACtC,MAAM,QAAQ,GAAG,wBAAwB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACzD,MAAM,cAAc,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,cAAc;QAAE,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;YAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;gBAAE,SAAS;YAC3B,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAmB,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,CAAC,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnF,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACpC,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;YAAE,SAAS;QACrD,IAAI,CAAC,IAAI,CAAC;YACR,EAAE,EAAE,aAAa,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;YACrC,WAAW,EAAE,gBAAgB,KAAK,MAAM,KAAK,oCAAoC;YACjF,MAAM,EAAE,YAAY;YACpB,cAAc,EAAE,sDAAsD,KAAK,GAAG;YAC9E,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC;SACjC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,MAAM,OAAO,GAAG;QACd,GAAG,cAAc,CAAC,QAAQ,CAAC;QAC3B,GAAG,gBAAgB,CAAC,QAAQ,CAAC;QAC7B,GAAG,cAAc,CAAC,QAAQ,CAAC;KAC5B,CAAC;IACF,eAAe;IACf,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAClC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;QACjC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,SAAS,EAAE,MAAM,CAAC,MAAM;QACxB,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC,MAAM;KAC7D,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,KAAa,EAAE,OAAyC;IAC1G,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;QACvD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC;YACvD,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO;SAC7C,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC"}

package/dist/cognitive/debate.d.ts

@@ -0,0 +1,48 @@
+/**
+ * v1.64.0 -- COGNITIVE LAYER 6: INTERNAL DEBATE.
+ *
+ * Before Mneme commits to a verdict, three internal voices argue:
+ *
+ *   SKEPTIC    -- assumes the worst-case interpretation. Flags hidden
+ *                 assumptions, missing data, fab-shaped claims.
+ *                 (Anchored on vaccine bank + ACGV history.)
+ *
+ *   OPTIMIST   -- assumes the best-case interpretation. Flags upside
+ *                 scenarios, growth-event triggers, why-not-just-ship.
+ *                 (Anchored on positive lessons + recent successes.)
+ *
+ *   REALIST    -- weighs both sides + the actual evidence. Cites
+ *                 reactor cost estimate + game-theory fairness + the
+ *                 forecast trend. Issues the synthesis verdict.
+ *
+ * Each voice gets a turn, then the realist arbitrates with a vote
+ * count of "skeptic-points" vs "optimist-points" actually grounded
+ * in evidence. The arbiter's verdict has a confidence score.
+ *
+ * NO LLM. Heuristics over claim text + repo state. Deterministic.
+ * The point isn't to simulate humans -- it's to force Mneme to
+ * spend tokens on the OPPOSITE side before committing.
+ */
+export type Voice = "skeptic" | "optimist" | "realist";
+export interface DebateTurn {
+    voice: Voice;
+    /** What the voice said. */
+    argument: string;
+    /** Specific evidence cited (file paths, commit subjects, vaccine ids, etc.). */
+    evidence: string[];
+    /** Confidence the voice has in its own argument 0..1. */
+    selfConfidence: number;
+}
+export interface DebateResult {
+    claim: string;
+    turns: DebateTurn[];
+    verdict: "AGREE" | "DISAGREE" | "INCONCLUSIVE";
+    /** Confidence of the realist's synthesis in [0, 1]. */
+    arbiterConfidence: number;
+    /** Plain-English explanation of the synthesis. */
+    reasoning: string;
+}
+export declare function debate(repoRoot: string, claim: string, opts?: {
+    persist?: boolean;
+}): DebateResult;
+//# sourceMappingURL=debate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debate.d.ts","sourceRoot":"","sources":["../../src/cognitive/debate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAOH,MAAM,MAAM,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAEvD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;IAC/C,uDAAuD;IACvD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;CACnB;AAsKD,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,YAAY,CA2BlG"}

package/dist/cognitive/debate.js

@@ -0,0 +1,223 @@
+/**
+ * v1.64.0 -- COGNITIVE LAYER 6: INTERNAL DEBATE.
+ *
+ * Before Mneme commits to a verdict, three internal voices argue:
+ *
+ *   SKEPTIC    -- assumes the worst-case interpretation. Flags hidden
+ *                 assumptions, missing data, fab-shaped claims.
+ *                 (Anchored on vaccine bank + ACGV history.)
+ *
+ *   OPTIMIST   -- assumes the best-case interpretation. Flags upside
+ *                 scenarios, growth-event triggers, why-not-just-ship.
+ *                 (Anchored on positive lessons + recent successes.)
+ *
+ *   REALIST    -- weighs both sides + the actual evidence. Cites
+ *                 reactor cost estimate + game-theory fairness + the
+ *                 forecast trend. Issues the synthesis verdict.
+ *
+ * Each voice gets a turn, then the realist arbitrates with a vote
+ * count of "skeptic-points" vs "optimist-points" actually grounded
+ * in evidence. The arbiter's verdict has a confidence score.
+ *
+ * NO LLM. Heuristics over claim text + repo state. Deterministic.
+ * The point isn't to simulate humans -- it's to force Mneme to
+ * spend tokens on the OPPOSITE side before committing.
+ */
+import { existsSync, mkdirSync, appendFileSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+const COGNITIVE_DIR = ".mneme/cognitive";
+function readSignals(repoRoot) {
+    const out = { vaccines: [], lessons: [], recentSubjects: [], forecastClaims: [] };
+    // Vaccines
+    const vp = join(repoRoot, ".mneme/squadron/lie-vaccines.jsonl");
+    if (existsSync(vp)) {
+        try {
+            out.vaccines = readFileSync(vp, "utf8").split("\n").filter(Boolean).map((l) => {
+                try {
+                    return JSON.parse(l).sample ?? "";
+                }
+                catch {
+                    return "";
+                }
+            }).filter(Boolean);
+        }
+        catch { /* */ }
+    }
+    // Lessons
+    const np = join(repoRoot, ".mneme/nucleus.json");
+    if (existsSync(np)) {
+        try {
+            const j = JSON.parse(readFileSync(np, "utf8"));
+            out.lessons = (j.lessons ?? []).map((l) => l.text ?? "").filter(Boolean);
+        }
+        catch { /* */ }
+    }
+    // Forecasts
+    const fp = join(repoRoot, ".mneme/forecast/forecasts.jsonl");
+    if (existsSync(fp)) {
+        try {
+            out.forecastClaims = readFileSync(fp, "utf8").split("\n").filter(Boolean).map((l) => {
+                try {
+                    return JSON.parse(l).claim ?? "";
+                }
+                catch {
+                    return "";
+                }
+            }).filter(Boolean);
+        }
+        catch { /* */ }
+    }
+    // Recent commit subjects
+    try {
+        const { execSync } = require("node:child_process");
+        const r = execSync(`git -C "${repoRoot}" log --max-count=30 --pretty=format:%s`, {
+            encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], timeout: 3000,
+        });
+        out.recentSubjects = r.split("\n").filter(Boolean);
+    }
+    catch { /* */ }
+    return out;
+}
+function tokenize(s) {
+    return new Set((s.toLowerCase().match(/[a-z][a-z0-9_-]+/g) ?? []).filter((t) => t.length >= 4));
+}
+function overlapCount(a, b) {
+    let n = 0;
+    for (const t of a)
+        if (b.has(t))
+            n += 1;
+    return n;
+}
+function runSkeptic(claim, sig) {
+    const claimTokens = tokenize(claim);
+    const evidence = [];
+    let points = 0;
+    // Vaccine matches = lies previously refuted = strong skeptic ammo.
+    for (const v of sig.vaccines) {
+        const vTokens = tokenize(v);
+        const hits = overlapCount(claimTokens, vTokens);
+        if (hits >= 2) {
+            evidence.push(`vaccine-match: "${v.slice(0, 60)}" (${hits} shared tokens)`);
+            points += hits;
+        }
+    }
+    // Fab-shaped triggers in the claim itself.
+    for (const trigger of ["always", "never", "guaranteed", "100%", "all", "impossible"]) {
+        if (claim.toLowerCase().includes(trigger)) {
+            evidence.push(`absolute-claim: "${trigger}" -- absolutes rarely survive scrutiny`);
+            points += 1;
+        }
+    }
+    // No supporting evidence in lessons.
+    let supportingLessons = 0;
+    for (const l of sig.lessons) {
+        if (overlapCount(claimTokens, tokenize(l)) >= 2)
+            supportingLessons += 1;
+    }
+    if (supportingLessons === 0 && sig.lessons.length > 0) {
+        evidence.push(`absence-of-evidence: 0 of ${sig.lessons.length} known lessons reinforce this`);
+        points += 1;
+    }
+    const argument = points > 0
+        ? `Caution: ${points} signal(s) suggest this claim resembles previously-refuted patterns or lacks supporting evidence.`
+        : `No vaccine or absolute-claim triggers; mild skepticism only.`;
+    const selfConfidence = Math.min(1, points / 5);
+    return { voice: "skeptic", argument, evidence, selfConfidence };
+}
+function runOptimist(claim, sig) {
+    const claimTokens = tokenize(claim);
+    const evidence = [];
+    let points = 0;
+    // Lessons that overlap with the claim = positive corroboration.
+    for (const l of sig.lessons.slice(0, 50)) {
+        const hits = overlapCount(claimTokens, tokenize(l));
+        if (hits >= 2) {
+            evidence.push(`lesson-overlap: "${l.slice(0, 60)}" (${hits} shared tokens)`);
+            points += 1;
+        }
+    }
+    // Recent commits = active work in this area.
+    let recentHits = 0;
+    for (const s of sig.recentSubjects) {
+        if (overlapCount(claimTokens, tokenize(s)) >= 2)
+            recentHits += 1;
+    }
+    if (recentHits > 0) {
+        evidence.push(`recent-activity: ${recentHits} recent commits touch this area`);
+        points += Math.min(3, recentHits);
+    }
+    // Forecast claims previously made = the team has been thinking about this.
+    for (const fc of sig.forecastClaims.slice(0, 20)) {
+        const hits = overlapCount(claimTokens, tokenize(fc));
+        if (hits >= 2) {
+            evidence.push(`forecast-precedent: "${fc.slice(0, 60)}" (${hits} shared tokens)`);
+            points += 1;
+            break;
+        }
+    }
+    const argument = points > 0
+        ? `Encouragement: ${points} signal(s) suggest momentum, prior wins, or active focus in this area.`
+        : `Cold start, but absence of refutation is not refutation.`;
+    const selfConfidence = Math.min(1, points / 5);
+    return { voice: "optimist", argument, evidence, selfConfidence };
+}
+function runRealist(claim, sig, skeptic, optimist) {
+    const skepPts = skeptic.selfConfidence;
+    const optPts = optimist.selfConfidence;
+    let verdict;
+    let arbiterConfidence;
+    let argument;
+    const evidence = [];
+    if (skepPts > optPts + 0.2) {
+        verdict = "DISAGREE";
+        arbiterConfidence = Math.min(1, skepPts);
+        argument = `Skeptic wins on evidence (${skepPts.toFixed(2)} vs ${optPts.toFixed(2)}). Claim does not pass.`;
+        evidence.push(...skeptic.evidence.slice(0, 3));
+    }
+    else if (optPts > skepPts + 0.2) {
+        verdict = "AGREE";
+        arbiterConfidence = Math.min(1, optPts);
+        argument = `Optimist wins on evidence (${optPts.toFixed(2)} vs ${skepPts.toFixed(2)}). Claim is consistent with what we know.`;
+        evidence.push(...optimist.evidence.slice(0, 3));
+    }
+    else {
+        verdict = "INCONCLUSIVE";
+        arbiterConfidence = 0.3 + Math.min(0.2, (skepPts + optPts) / 4);
+        argument = `Neither side decisive (skeptic ${skepPts.toFixed(2)}, optimist ${optPts.toFixed(2)}). Need more evidence before acting.`;
+        evidence.push(...skeptic.evidence.slice(0, 2), ...optimist.evidence.slice(0, 2));
+    }
+    const reasoning = [
+        `Skeptic (${skepPts.toFixed(2)}): ${skeptic.argument}`,
+        `Optimist (${optPts.toFixed(2)}): ${optimist.argument}`,
+        `Realist verdict: ${verdict} (arbiter confidence ${arbiterConfidence.toFixed(2)}).`,
+        `Reason: ${argument}`,
+    ].join("\n");
+    return {
+        turn: { voice: "realist", argument, evidence, selfConfidence: arbiterConfidence },
+        verdict, arbiterConfidence, reasoning,
+    };
+}
+export function debate(repoRoot, claim, opts) {
+    const sig = readSignals(repoRoot);
+    const skeptic = runSkeptic(claim, sig);
+    const optimist = runOptimist(claim, sig);
+    const realistOut = runRealist(claim, sig, skeptic, optimist);
+    const result = {
+        claim,
+        turns: [skeptic, optimist, realistOut.turn],
+        verdict: realistOut.verdict,
+        arbiterConfidence: realistOut.arbiterConfidence,
+        reasoning: realistOut.reasoning,
+    };
+    if (opts?.persist) {
+        try {
+            const dir = join(repoRoot, COGNITIVE_DIR, "debate");
+            if (!existsSync(dir))
+                mkdirSync(dir, { recursive: true });
+            appendFileSync(join(dir, "debates.jsonl"), JSON.stringify({ ts: new Date().toISOString(), claim, verdict: result.verdict, arbiterConfidence: result.arbiterConfidence }) + "\n", "utf8");
+        }
+        catch { /* */ }
+    }
+    return result;
+}
+//# sourceMappingURL=debate.js.map

package/dist/cognitive/debate.js.map

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

package/dist/cognitive/decision_atom.d.ts

@@ -0,0 +1,119 @@
+/**
+ * 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 { type VendorProfile } from "./theory_of_mind.js";
+import { type ToTResult } from "./tree_of_thought.js";
+import { type CuriosityScan } from "./curiosity.js";
+import { type ConsolidationReport } from "./consolidation.js";
+import { type CounterfactualResult } from "./counterfactual.js";
+import { type DebateResult } from "./debate.js";
+export type AtomVerdict = "PROCEED" | "PROCEED-WITH-CARE" | "PAUSE-INVESTIGATE" | "ABORT-FOR-NOW";
+export interface DecisionAtomInput {
+    /** The decision in plain English (e.g. "refactor authentication"). */
+    intent: string;
+    /** Optional list of vendors to consider (e.g. ["claude", "cursor", "gemini"]). */
+    vendors?: string[];
+    /** Optional task profile for vendor recommendation. */
+    taskProfile?: {
+        domain?: string;
+        needsTerse?: boolean;
+        needsStable?: boolean;
+    };
+    /** Counterfactual baseline (the actual decision's risk/fair/cost). */
+    counterfactualBaseline?: {
+        actualRegressionP: number;
+        actualStakeholderFair: number;
+        actualTokenCost: number;
+    };
+}
+export interface DecisionAtom {
+    intent: string;
+    verdict: AtomVerdict;
+    /** Overall confidence in [0, 1]. */
+    confidence: number;
+    /** Per-layer sub-verdicts. */
+    layers: {
+        theoryOfMind: {
+            recommendedVendor: string | null;
+            vendorProfiles: number;
+        };
+        treeOfThought: {
+            bestPath: string[];
+            bestEv: number;
+            alternatives: number;
+        };
+        curiosity: {
+            totalGaps: number;
+            highPriority: number;
+            topGap: string | null;
+        };
+        consolidation: {
+            vaccinesMerged: number;
+            lessonsPruned: number;
+            lessonsPromoted: number;
+        };
+        counterfactual: {
+            topAlternative: string | null;
+            netRelief: number;
+            netRegret: number;
+        } | null;
+        debate: {
+            verdict: DebateResult["verdict"];
+            arbiterConfidence: number;
+        };
+    };
+    /** One-screen plain-English explanation. */
+    briefing: string;
+    /** Recommended next concrete action. */
+    recommendedAction: string;
+    /** Raw layer outputs for audit. */
+    raw: {
+        profiles: VendorProfile[];
+        tot: ToTResult;
+        curiosity: CuriosityScan;
+        consolidation: ConsolidationReport;
+        counterfactual: CounterfactualResult | null;
+        debate: DebateResult;
+    };
+    /** ISO timestamp. */
+    builtAt: string;
+}
+export declare function build(repoRoot: string, input: DecisionAtomInput): DecisionAtom;
+/** Roll up the atom history -- how often does Mneme tell us PROCEED vs PAUSE? */
+export interface AtomHistorySummary {
+    totalAtoms: number;
+    verdictCounts: Record<AtomVerdict, number>;
+    meanConfidence: number;
+    /** Most-recent atom's intent + verdict for quick recall. */
+    lastAtom: {
+        intent: string;
+        verdict: AtomVerdict;
+        ts: string;
+    } | null;
+}
+export declare function summarizeHistory(repoRoot: string): AtomHistorySummary;
+//# sourceMappingURL=decision_atom.d.ts.map

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

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