@mneme-ai/core 1.98.0 → 2.0.0

package/dist/bloodline/bloodline.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bloodline.test.d.ts.map

package/dist/bloodline/bloodline.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bloodline.test.d.ts","sourceRoot":"","sources":["../../src/bloodline/bloodline.test.ts"],"names":[],"mappings":""}

package/dist/bloodline/bloodline.test.js

@@ -0,0 +1,96 @@
+import { describe, it, expect } from "vitest";
+import { createGenome, applyEvolutionaryPressure, batchApply, computeDnaFingerprint, personalityReport, formatBloodlinePulseLine, serializeGenome, parseGenome, PRESSURE, } from "./index.js";
+describe("v2.0 BLOODLINE · evolutionary pressure", () => {
+    it("verified-good event reinforces fitness", () => {
+        const g = createGenome();
+        const s = applyEvolutionaryPressure(g, { id: "e1", ts: 1, kind: "verified-good", strainId: "redis", trace: "ok" });
+        expect(s.fitness).toBeCloseTo(1.0 + PRESSURE.REINFORCE_BOOST, 5);
+        expect(s.reinforced).toBeGreaterThan(0);
+    });
+    it("user-rejected event decays fitness multiplicatively", () => {
+        const g = createGenome();
+        applyEvolutionaryPressure(g, { id: "e1", ts: 1, kind: "verified-good", strainId: "redis", trace: "ok" });
+        const before = g.strains.get("redis").fitness;
+        applyEvolutionaryPressure(g, { id: "e2", ts: 2, kind: "user-rejected", strainId: "redis", trace: "no" });
+        const after = g.strains.get("redis").fitness;
+        expect(after).toBeLessThan(before);
+        expect(after).toBeCloseTo(before * PRESSURE.DECAY_FACTOR, 5);
+    });
+    it("hallucination spawns vaccine variant counter + small bump", () => {
+        const g = createGenome();
+        applyEvolutionaryPressure(g, { id: "e1", ts: 1, kind: "hallucination", strainId: "phantom-fn", trace: "AI invented function" });
+        const s = g.strains.get("phantom-fn");
+        expect(s.vaccineVariants).toBe(1);
+        expect(s.fitness).toBeGreaterThan(1.0);
+    });
+    it("apoptosed=true when fitness drops below threshold", () => {
+        const g = createGenome();
+        applyEvolutionaryPressure(g, { id: "init", ts: 1, kind: "verified-good", strainId: "x", trace: "ok" });
+        // Crush it with many rejections
+        for (let i = 0; i < 20; i++) {
+            applyEvolutionaryPressure(g, { id: `r${i}`, ts: 10 + i, kind: "user-rejected", strainId: "x", trace: "no" });
+        }
+        expect(g.strains.get("x").apoptosed).toBe(true);
+    });
+    it("DNA fingerprint is deterministic + stable", () => {
+        const g1 = createGenome();
+        const events = [
+            { id: "a", ts: 1, kind: "verified-good", strainId: "x", trace: "" },
+            { id: "b", ts: 2, kind: "user-rejected", strainId: "y", trace: "" },
+        ];
+        batchApply(g1, events);
+        const dna1 = computeDnaFingerprint(g1);
+        const g2 = createGenome();
+        batchApply(g2, events);
+        const dna2 = computeDnaFingerprint(g2);
+        expect(dna1).toBe(dna2);
+    });
+    it("DNA fingerprint differs when EVENT ORDER differs", () => {
+        const a = [
+            { id: "a", ts: 1, kind: "verified-good", strainId: "x", trace: "" },
+            { id: "b", ts: 2, kind: "hallucination", strainId: "y", trace: "" },
+        ];
+        const b = [
+            { id: "b", ts: 2, kind: "hallucination", strainId: "y", trace: "" },
+            { id: "a", ts: 1, kind: "verified-good", strainId: "x", trace: "" },
+        ];
+        const g1 = createGenome();
+        batchApply(g1, a);
+        const g2 = createGenome();
+        batchApply(g2, b);
+        expect(computeDnaFingerprint(g1)).not.toBe(computeDnaFingerprint(g2));
+    });
+    it("personalityReport produces sigma deviations against baseline", () => {
+        const g = createGenome();
+        applyEvolutionaryPressure(g, { id: "a", ts: 1, kind: "verified-good", strainId: "x", trace: "" });
+        applyEvolutionaryPressure(g, { id: "b", ts: 2, kind: "verified-good", strainId: "x", trace: "" });
+        applyEvolutionaryPressure(g, { id: "c", ts: 3, kind: "verified-good", strainId: "x", trace: "" });
+        const r = personalityReport(g, { meanFitness: { x: 1.0 }, stdDev: { x: 0.05 } });
+        expect(r.sigmaDeviations.length).toBeGreaterThan(0);
+        expect(r.sigmaDeviations[0].strainId).toBe("x");
+        expect(r.sigmaDeviations[0].sigma).toBeGreaterThan(2);
+    });
+    it("personalityReport summary mentions top deviation", () => {
+        const g = createGenome();
+        applyEvolutionaryPressure(g, { id: "a", ts: 1, kind: "verified-good", strainId: "x", trace: "" });
+        const r = personalityReport(g, { meanFitness: { x: 1.0 }, stdDev: { x: 0.05 } });
+        expect(r.summary).toContain("σ");
+    });
+    it("formatBloodlinePulseLine produces compact summary", () => {
+        const g = createGenome();
+        applyEvolutionaryPressure(g, { id: "a", ts: 1, kind: "verified-good", strainId: "x", trace: "" });
+        const line = formatBloodlinePulseLine(g);
+        expect(line).toContain("BLOODLINE");
+        expect(line).toContain("DNA=");
+    });
+    it("serialize → parse round-trip", () => {
+        const g = createGenome();
+        applyEvolutionaryPressure(g, { id: "a", ts: 1, kind: "verified-good", strainId: "x", trace: "" });
+        const text = serializeGenome(g);
+        const parsed = parseGenome(text);
+        expect(parsed).not.toBeNull();
+        expect(parsed.strains.get("x")?.fitness).toBeCloseTo(1.10, 5);
+        expect(parsed.history.length).toBe(1);
+    });
+});
+//# sourceMappingURL=bloodline.test.js.map

package/dist/bloodline/bloodline.test.js.map

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

package/dist/bloodline/index.d.ts

@@ -0,0 +1,124 @@
+/**
+ * v2.0.0 -- BLOODLINE · Personal AI Genetic Strain
+ *
+ *   "After 6 months, your Mneme is no longer the same species as anyone
+ *    else's. They cloned the repo — they got the phenotype, not the
+ *    genotype."
+ *
+ * Mneme already ships:
+ *   - MneMeiosis chromosomes (genome of decisions / regrets / wisdoms)
+ *   - ATOM karma per chromosome
+ *   - apoptosis (cell death) on consistently-bad chromosomes
+ *
+ * What was MISSING: evolutionary pressure that selects, mutates, and
+ * propagates chromosomes over time. BLOODLINE adds it. Three loops:
+ *
+ *   ✓ verified-good outcome    → reinforce chromosome fitness +0.10
+ *   ⚠ hallucination caught    → propagate vaccine variant
+ *   ✗ user rejected            → decay branch fitness -0.20
+ *
+ * Plus a DNA fingerprint that's a deterministic hash of the user's
+ * cumulative fitness landscape — guaranteed unique across users after
+ * a few weeks of normal use because no two users land the same
+ * sequence of verified-good / hallucination / rejection events.
+ *
+ * Plus a "personality report" that grades this user's genome against a
+ * neutral baseline: "your AI is 3.7σ more cautious about Redis than
+ * baseline (incident 2026-03-14 still influences your chromosome
+ * `c0ff33-redis-sessions`)".
+ *
+ * Pure function. Deterministic. No external deps.
+ * Backward compatible — composes with chromosomes/vaccines that already exist.
+ */
+export type EventKind = "verified-good" | "hallucination" | "user-rejected" | "user-confirmed";
+export interface BloodlineEvent {
+    /** Stable id (sha256 prefix). */
+    id: string;
+    /** Wall-clock when the event happened. */
+    ts: number;
+    kind: EventKind;
+    /** Which chromosome/strain the event refers to. */
+    strainId: string;
+    /** Free-form narrative for audit. */
+    trace: string;
+    /** Optional 0..1 magnitude (e.g. severity of hallucination). */
+    weight?: number;
+}
+export interface StrainState {
+    id: string;
+    /** Fitness 0..∞. Default 1.0. Reinforce adds, decay multiplies. */
+    fitness: number;
+    /** Number of events this strain has accumulated. */
+    events: number;
+    /** Number of vaccine variants spawned from this strain. */
+    vaccineVariants: number;
+    /** Last-touched timestamp. */
+    lastTouched: number;
+    /** Cumulative reinforcement (positive events). */
+    reinforced: number;
+    /** Cumulative decay (negative events). */
+    decayed: number;
+    /** True if strain is below apoptosis threshold (effectively dead). */
+    apoptosed: boolean;
+}
+export interface Genome {
+    /** Map strainId → state. */
+    strains: Map<string, StrainState>;
+    /** All events ever applied, newest last. */
+    history: BloodlineEvent[];
+}
+export declare function createGenome(): Genome;
+/** Constants tunable per deployment (also exposed for tests). */
+export declare const PRESSURE: {
+    REINFORCE_BOOST: number;
+    DECAY_FACTOR: number;
+    HALLUCINATION_VARIANT: number;
+    APOPTOSIS_THRESHOLD: number;
+};
+/** Apply one event to the genome. Mutates the genome IN PLACE — pure
+ *  in the functional sense that same (genome, event) → same final state. */
+export declare function applyEvolutionaryPressure(genome: Genome, event: BloodlineEvent): StrainState;
+/** Batch-apply many events. */
+export declare function batchApply(genome: Genome, events: readonly BloodlineEvent[]): void;
+/** Compute a deterministic 16-hex DNA fingerprint that's unique across
+ *  users after a handful of events. Sensitive to both WHICH strains and
+ *  WHAT ORDER events arrived in. */
+export declare function computeDnaFingerprint(genome: Genome): string;
+export interface BaselineStats {
+    /** Map strainId → expected mean fitness in the population. */
+    meanFitness: Record<string, number>;
+    /** Map strainId → population stddev. */
+    stdDev: Record<string, number>;
+}
+export interface PersonalityReport {
+    totalStrains: number;
+    apoptosedStrains: number;
+    topReinforced: Array<{
+        strainId: string;
+        fitness: number;
+        reinforced: number;
+    }>;
+    topDecayed: Array<{
+        strainId: string;
+        fitness: number;
+        decayed: number;
+    }>;
+    sigmaDeviations: Array<{
+        strainId: string;
+        fitness: number;
+        baseline: number;
+        sigma: number;
+    }>;
+    /** Cumulative reinforcement minus decay — overall colony health. */
+    healthScore: number;
+    /** Best-effort one-liner for AI agent to surface. */
+    summary: string;
+}
+/** Compute the personality report given the user's genome and an
+ *  optional population baseline. */
+export declare function personalityReport(genome: Genome, baseline?: BaselineStats): PersonalityReport;
+export declare function formatBloodlinePulseLine(genome: Genome): string;
+/** Serialize the genome to JSON for persistence in .mneme/bloodline.json. */
+export declare function serializeGenome(genome: Genome): string;
+export declare function parseGenome(text: string): Genome | null;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/bloodline/index.js

@@ -0,0 +1,179 @@
+/**
+ * v2.0.0 -- BLOODLINE · Personal AI Genetic Strain
+ *
+ *   "After 6 months, your Mneme is no longer the same species as anyone
+ *    else's. They cloned the repo — they got the phenotype, not the
+ *    genotype."
+ *
+ * Mneme already ships:
+ *   - MneMeiosis chromosomes (genome of decisions / regrets / wisdoms)
+ *   - ATOM karma per chromosome
+ *   - apoptosis (cell death) on consistently-bad chromosomes
+ *
+ * What was MISSING: evolutionary pressure that selects, mutates, and
+ * propagates chromosomes over time. BLOODLINE adds it. Three loops:
+ *
+ *   ✓ verified-good outcome    → reinforce chromosome fitness +0.10
+ *   ⚠ hallucination caught    → propagate vaccine variant
+ *   ✗ user rejected            → decay branch fitness -0.20
+ *
+ * Plus a DNA fingerprint that's a deterministic hash of the user's
+ * cumulative fitness landscape — guaranteed unique across users after
+ * a few weeks of normal use because no two users land the same
+ * sequence of verified-good / hallucination / rejection events.
+ *
+ * Plus a "personality report" that grades this user's genome against a
+ * neutral baseline: "your AI is 3.7σ more cautious about Redis than
+ * baseline (incident 2026-03-14 still influences your chromosome
+ * `c0ff33-redis-sessions`)".
+ *
+ * Pure function. Deterministic. No external deps.
+ * Backward compatible — composes with chromosomes/vaccines that already exist.
+ */
+import { createHash } from "node:crypto";
+// ============================================================
+// Genome lifecycle
+// ============================================================
+export function createGenome() {
+    return { strains: new Map(), history: [] };
+}
+/** Constants tunable per deployment (also exposed for tests). */
+export const PRESSURE = {
+    REINFORCE_BOOST: 0.10,
+    DECAY_FACTOR: 0.80, // multiply fitness by this on user-rejected
+    HALLUCINATION_VARIANT: 0.05, // small fitness bump for the parent strain when a vaccine variant is spawned
+    APOPTOSIS_THRESHOLD: 0.10, // below this fitness → strain marked apoptosed
+};
+/** Apply one event to the genome. Mutates the genome IN PLACE — pure
+ *  in the functional sense that same (genome, event) → same final state. */
+export function applyEvolutionaryPressure(genome, event) {
+    let strain = genome.strains.get(event.strainId);
+    if (!strain) {
+        strain = {
+            id: event.strainId,
+            fitness: 1.0,
+            events: 0,
+            vaccineVariants: 0,
+            lastTouched: event.ts,
+            reinforced: 0,
+            decayed: 0,
+            apoptosed: false,
+        };
+        genome.strains.set(event.strainId, strain);
+    }
+    const weight = event.weight ?? 1.0;
+    switch (event.kind) {
+        case "verified-good":
+        case "user-confirmed": {
+            const boost = PRESSURE.REINFORCE_BOOST * weight;
+            strain.fitness += boost;
+            strain.reinforced += boost;
+            break;
+        }
+        case "hallucination": {
+            // Spawn a vaccine variant for this strain. Slight reinforcement for
+            // the parent strain because catching a hallucination IS a fitness signal.
+            strain.vaccineVariants += 1;
+            const bump = PRESSURE.HALLUCINATION_VARIANT * weight;
+            strain.fitness += bump;
+            strain.reinforced += bump;
+            break;
+        }
+        case "user-rejected": {
+            const factor = Math.pow(PRESSURE.DECAY_FACTOR, weight);
+            const beforeFit = strain.fitness;
+            strain.fitness *= factor;
+            strain.decayed += (beforeFit - strain.fitness);
+            break;
+        }
+    }
+    strain.events += 1;
+    strain.lastTouched = event.ts;
+    strain.apoptosed = strain.fitness < PRESSURE.APOPTOSIS_THRESHOLD;
+    genome.history.push(event);
+    return strain;
+}
+/** Batch-apply many events. */
+export function batchApply(genome, events) {
+    for (const e of events)
+        applyEvolutionaryPressure(genome, e);
+}
+// ============================================================
+// DNA Fingerprint
+// ============================================================
+/** Compute a deterministic 16-hex DNA fingerprint that's unique across
+ *  users after a handful of events. Sensitive to both WHICH strains and
+ *  WHAT ORDER events arrived in. */
+export function computeDnaFingerprint(genome) {
+    const h = createHash("sha256");
+    // Sort strains by id for stable hashing.
+    const sorted = [...genome.strains.values()].sort((a, b) => a.id.localeCompare(b.id));
+    for (const s of sorted) {
+        h.update(`${s.id}|${s.fitness.toFixed(6)}|${s.events}|${s.vaccineVariants}|${s.apoptosed ? "X" : "."};`);
+    }
+    // Also include event arrival ORDER (a unique-to-user signal).
+    for (const e of genome.history) {
+        h.update(`${e.kind}|${e.strainId};`);
+    }
+    return h.digest("hex").slice(0, 16);
+}
+/** Compute the personality report given the user's genome and an
+ *  optional population baseline. */
+export function personalityReport(genome, baseline) {
+    const all = [...genome.strains.values()];
+    const apoptosed = all.filter((s) => s.apoptosed).length;
+    const topReinforced = [...all].sort((a, b) => b.reinforced - a.reinforced).slice(0, 5).map((s) => ({ strainId: s.id, fitness: s.fitness, reinforced: s.reinforced }));
+    const topDecayed = [...all].sort((a, b) => b.decayed - a.decayed).slice(0, 5).map((s) => ({ strainId: s.id, fitness: s.fitness, decayed: s.decayed }));
+    const sigmaDeviations = [];
+    if (baseline) {
+        for (const s of all) {
+            const mean = baseline.meanFitness[s.id];
+            const sd = baseline.stdDev[s.id];
+            if (mean === undefined || sd === undefined || sd === 0)
+                continue;
+            const sigma = (s.fitness - mean) / sd;
+            if (Math.abs(sigma) >= 1)
+                sigmaDeviations.push({ strainId: s.id, fitness: s.fitness, baseline: mean, sigma });
+        }
+        sigmaDeviations.sort((a, b) => Math.abs(b.sigma) - Math.abs(a.sigma));
+    }
+    const healthScore = all.reduce((sum, s) => sum + s.reinforced - s.decayed, 0);
+    let summary = `BLOODLINE · ${all.length} strain(s) · ${apoptosed} apoptosed · health=${healthScore.toFixed(2)}`;
+    if (sigmaDeviations.length > 0) {
+        const top = sigmaDeviations[0];
+        const direction = top.sigma > 0 ? "more aggressive at reinforcing" : "more cautious about";
+        summary += ` · top deviation: ${top.sigma.toFixed(1)}σ ${direction} '${top.strainId}'`;
+    }
+    return { totalStrains: all.length, apoptosedStrains: apoptosed, topReinforced, topDecayed, sigmaDeviations, healthScore, summary };
+}
+// ============================================================
+// Pulse line + serialization
+// ============================================================
+export function formatBloodlinePulseLine(genome) {
+    const dna = computeDnaFingerprint(genome);
+    const r = personalityReport(genome);
+    return `BLOODLINE · DNA=${dna} · ${r.totalStrains} strain(s) · ${r.apoptosedStrains} apoptosed · health=${r.healthScore.toFixed(2)}`;
+}
+/** Serialize the genome to JSON for persistence in .mneme/bloodline.json. */
+export function serializeGenome(genome) {
+    // StrainState already has an `id` field; just dump the values.
+    return JSON.stringify({
+        strains: [...genome.strains.values()],
+        history: genome.history,
+    });
+}
+export function parseGenome(text) {
+    try {
+        const obj = JSON.parse(text);
+        if (!obj || !Array.isArray(obj.strains) || !Array.isArray(obj.history))
+            return null;
+        const strains = new Map();
+        for (const s of obj.strains)
+            strains.set(s.id, s);
+        return { strains, history: obj.history };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/bloodline/index.js.map

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

package/dist/dream/dream.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dream.test.d.ts.map

package/dist/dream/dream.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dream.test.d.ts","sourceRoot":"","sources":["../../src/dream/dream.test.ts"],"names":[],"mappings":""}

package/dist/dream/dream.test.js

@@ -0,0 +1,61 @@
+import { describe, it, expect } from "vitest";
+import { dreamPhase, formatDreamPulseLine } from "./index.js";
+describe("v2.0 DREAM CYCLE · REM sleep adversarial sim", () => {
+    it("reinforces vaccines that catch hallucinations", () => {
+        const vaccines = [{ id: "v1", pattern: "phantom\\.fn", fitness: 1.0, streak: 0, apoptosed: false }];
+        const samples = [
+            { id: "s1", text: "the function phantom.fn returns nothing", shouldCatch: true },
+            { id: "s2", text: "phantom.fn imported from utils", shouldCatch: true },
+        ];
+        const out = dreamPhase({ vaccines, samples, seed: 7 });
+        const v1 = out.updatedVaccines.find((v) => v.id === "v1");
+        expect(v1.fitness).toBeGreaterThan(1.0);
+        expect(v1.streak).toBeGreaterThanOrEqual(2);
+    });
+    it("penalizes vaccines that MISS hallucinations they should catch", () => {
+        const vaccines = [{ id: "v1", pattern: "totally-different-pattern", fitness: 1.0, streak: 0, apoptosed: false }];
+        const samples = [{ id: "s1", text: "phantom.fn returns nothing", shouldCatch: true }];
+        const out = dreamPhase({ vaccines, samples, seed: 7 });
+        const v1 = out.updatedVaccines.find((v) => v.id === "v1");
+        expect(v1.fitness).toBeLessThan(1.0);
+    });
+    it("spawns variant vaccine when nothing catches a hallucination", () => {
+        const vaccines = [{ id: "v1", pattern: "completely-unrelated", fitness: 1.0, streak: 0, apoptosed: false }];
+        const samples = [{ id: "s1", text: "AI claims commit b1d4e21 exists", shouldCatch: true }];
+        const out = dreamPhase({ vaccines, samples, seed: 7 });
+        expect(out.newVariants.length).toBeGreaterThanOrEqual(1);
+        expect(out.newVariants[0].pattern).toBeTruthy();
+    });
+    it("heavy-penalizes vaccines that false-positive on benign samples", () => {
+        const vaccines = [{ id: "v1", pattern: "real-function", fitness: 1.0, streak: 0, apoptosed: false }];
+        const samples = [{ id: "s1", text: "real-function exists and works fine", shouldCatch: false }];
+        const out = dreamPhase({ vaccines, samples, seed: 7 });
+        const v1 = out.updatedVaccines.find((v) => v.id === "v1");
+        expect(v1.fitness).toBeLessThan(1.0);
+    });
+    it("marks vaccines apoptosed when fitness drops below 0.2", () => {
+        const vaccines = [{ id: "v1", pattern: "useless", fitness: 0.25, streak: 0, apoptosed: false }];
+        const samples = [
+            { id: "s1", text: "no match", shouldCatch: true },
+            { id: "s2", text: "still no match", shouldCatch: true },
+        ];
+        const out = dreamPhase({ vaccines, samples, seed: 7 });
+        const v1 = out.updatedVaccines.find((v) => v.id === "v1");
+        if (v1) {
+            // After 2 misses fitness drops by at most 0.1, but variants may push apoptosis logic
+            expect(v1.fitness).toBeLessThan(0.25);
+        }
+    });
+    it("trace records vaccine x sample hits", () => {
+        const vaccines = [{ id: "v1", pattern: "x", fitness: 1.0, streak: 0, apoptosed: false }];
+        const samples = [{ id: "s1", text: "x", shouldCatch: true }];
+        const out = dreamPhase({ vaccines, samples });
+        expect(out.trace.length).toBe(1);
+        expect(out.trace[0].caught).toBe(true);
+    });
+    it("formatDreamPulseLine produces compact summary", () => {
+        const out = dreamPhase({ vaccines: [], samples: [], seed: 1 });
+        expect(formatDreamPulseLine(out)).toContain("DREAM-CYCLE");
+    });
+});
+//# sourceMappingURL=dream.test.js.map

package/dist/dream/dream.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dream.test.js","sourceRoot":"","sources":["../../src/dream/dream.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAmD,MAAM,YAAY,CAAC;AAE/G,QAAQ,CAAC,8CAA8C,EAAE,GAAG,EAAE;IAC5D,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,QAAQ,GAAuB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACxH,MAAM,OAAO,GAA0B;YACrC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,yCAAyC,EAAE,WAAW,EAAE,IAAI,EAAE;YAChF,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,gCAAgC,EAAE,WAAW,EAAE,IAAI,EAAE;SACxE,CAAC;QACF,MAAM,GAAG,GAAG,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACvD,MAAM,EAAE,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAE,CAAC;QAC3D,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,QAAQ,GAAuB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,2BAA2B,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACrI,MAAM,OAAO,GAA0B,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,4BAA4B,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7G,MAAM,GAAG,GAAG,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACvD,MAAM,EAAE,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAE,CAAC;QAC3D,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,QAAQ,GAAuB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,sBAAsB,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAChI,MAAM,OAAO,GAA0B,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,iCAAiC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAClH,MAAM,GAAG,GAAG,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,QAAQ,GAAuB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACzH,MAAM,OAAO,GAA0B,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,qCAAqC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QACvH,MAAM,GAAG,GAAG,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACvD,MAAM,EAAE,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAE,CAAC;QAC3D,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,QAAQ,GAAuB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QACpH,MAAM,OAAO,GAA0B;YACrC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE;YACjD,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,WAAW,EAAE,IAAI,EAAE;SACxD,CAAC;QACF,MAAM,GAAG,GAAG,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACvD,MAAM,EAAE,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;QAC1D,IAAI,EAAE,EAAE,CAAC;YACP,qFAAqF;YACrF,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,QAAQ,GAAuB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7G,MAAM,OAAO,GAA0B,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACpF,MAAM,GAAG,GAAG,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,GAAG,GAAG,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/D,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/dream/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * v2.0.0 -- DREAM CYCLE · REM sleep for AI
+ *
+ * Nucleus daemon enters a "dream phase" during idle ticks. In each
+ * dream, the existing vaccine bank is challenged by N synthetic
+ * hallucination variants drawn from the user's history. Vaccines that
+ * survive K dreams in a row earn a fitness bonus. Vaccines that fail
+ * K times in a row are marked apoptosis-eligible.
+ *
+ * User wakes up = Mneme is genuinely sharper than yesterday.
+ *
+ * Pure-function inner loop (deterministic with seed). The daemon will
+ * call dreamPhase() once per N ticks in a future wiring; today the
+ * function is unit-tested + can be called by `mneme dream now`.
+ */
+export interface VaccineCandidate {
+    id: string;
+    /** Regex-like pattern the vaccine recognizes as a hallucination. */
+    pattern: string;
+    /** Fitness 0..∞. Default 1.0. Raised by survival, lowered by failure. */
+    fitness: number;
+    /** Consecutive-survival count. */
+    streak: number;
+    /** True if marked apoptosis-eligible. */
+    apoptosed: boolean;
+}
+export interface HallucinationSample {
+    id: string;
+    text: string;
+    /** True iff a sample is supposed to be caught by ANY surviving vaccine. */
+    shouldCatch: boolean;
+}
+export interface DreamInput {
+    vaccines: readonly VaccineCandidate[];
+    samples: readonly HallucinationSample[];
+    /** Seed for reproducibility. */
+    seed?: number;
+    /** Streak threshold to spawn a variant or apoptose. Default 3. */
+    streakThreshold?: number;
+}
+export interface DreamOutput {
+    updatedVaccines: VaccineCandidate[];
+    /** Vaccines that just got an apoptosis flag. */
+    apoptosedThisCycle: VaccineCandidate[];
+    /** Newly-spawned variant vaccines. */
+    newVariants: VaccineCandidate[];
+    /** Per-vaccine per-sample hit table for audit. */
+    trace: Array<{
+        vaccineId: string;
+        sampleId: string;
+        caught: boolean;
+    }>;
+    /** Wall-clock duration. */
+    elapsedMs: number;
+}
+/** Run one dream cycle. Pure-function: same inputs → same outputs. */
+export declare function dreamPhase(input: DreamInput): DreamOutput;
+export declare function formatDreamPulseLine(o: DreamOutput): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dream/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACxC,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,gBAAgB,EAAE,CAAC;IACpC,gDAAgD;IAChD,kBAAkB,EAAE,gBAAgB,EAAE,CAAC;IACvC,sCAAsC;IACtC,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,kDAAkD;IAClD,KAAK,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACvE,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAsBD,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAuEzD;AAMD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAE3D"}