@mneme-ai/core 2.37.1 → 2.39.0

package/dist/zzzzz_probe/anti_entropy.js

@@ -0,0 +1,147 @@
+/**
+ * v2.39.0 — Anti-Entropy text/code analyzer.
+ *
+ * 4 measurable signals AI-generated text leaks (well-cited in
+ * Mitchell et al. 2023 "DetectGPT" and academic AI-text-detection
+ * literature). No GPU, no ML model, pure deterministic math.
+ *
+ *   1. Shannon entropy bits/char — AI text often clusters near
+ *      4.0-4.5 bits/char (natural English ~3.9-4.7).
+ *   2. Repetition rate — dominant n-gram frequency. AI repeats.
+ *   3. Sentence-variance ratio — sigma/mean of sentence length.
+ *      AI text often uniform (low ratio).
+ *   4. Zipf deviation — top-K word frequency vs Zipf's law (k/rank).
+ *      AI text under-represents stop-word power-law tail.
+ *
+ * Each signal contributes to a composite `anomalyScore` in [0, 1].
+ */
+// ── 1. Shannon entropy ────────────────────────────────────────────────
+export function shannonBitsPerChar(text) {
+    if (text.length === 0)
+        return 0;
+    const counts = new Map();
+    for (const ch of text)
+        counts.set(ch, (counts.get(ch) ?? 0) + 1);
+    const total = text.length;
+    let h = 0;
+    for (const c of counts.values()) {
+        const p = c / total;
+        h -= p * Math.log2(p);
+    }
+    return h;
+}
+// ── 2. Repetition rate ────────────────────────────────────────────────
+export function repetitionRate(text) {
+    const tokens = text.toLowerCase().split(/\s+/).filter(Boolean);
+    if (tokens.length === 0)
+        return 0;
+    const counts = new Map();
+    for (const t of tokens)
+        counts.set(t, (counts.get(t) ?? 0) + 1);
+    let maxCount = 0;
+    for (const c of counts.values())
+        if (c > maxCount)
+            maxCount = c;
+    return maxCount / tokens.length;
+}
+// ── 3. Sentence-length variance ratio ─────────────────────────────────
+export function sentenceVarianceRatio(text) {
+    // Sentences = runs separated by . ! ? + whitespace.
+    const sentences = text.split(/(?<=[.!?])\s+/).filter((s) => s.trim().length > 0);
+    if (sentences.length < 2)
+        return 0;
+    const lengths = sentences.map((s) => s.length);
+    const mean = lengths.reduce((a, b) => a + b, 0) / lengths.length;
+    if (mean === 0)
+        return 0;
+    const variance = lengths.reduce((a, n) => a + (n - mean) ** 2, 0) / lengths.length;
+    const stddev = Math.sqrt(variance);
+    return stddev / mean;
+}
+// ── 4. Zipf deviation ─────────────────────────────────────────────────
+export function zipfDeviation(text) {
+    const tokens = text.toLowerCase().match(/[a-z]+/g) ?? [];
+    if (tokens.length < 50)
+        return 0; // not enough sample
+    const counts = new Map();
+    for (const t of tokens)
+        counts.set(t, (counts.get(t) ?? 0) + 1);
+    const sorted = Array.from(counts.entries()).sort((a, b) => b[1] - a[1]).slice(0, 50);
+    if (sorted.length < 10)
+        return 0;
+    // Expected Zipf: freq(rank=r) ≈ freq(rank=1) / r
+    const top = sorted[0][1];
+    let deviationSum = 0;
+    let denom = 0;
+    for (let i = 1; i < sorted.length; i++) {
+        const expected = top / (i + 1);
+        const observed = sorted[i][1];
+        const ratio = observed / Math.max(1, expected);
+        // Penalty grows as ratio deviates from 1.0 (in EITHER direction).
+        deviationSum += Math.abs(Math.log(ratio));
+        denom++;
+    }
+    return denom === 0 ? 0 : deviationSum / denom;
+}
+// ── Composite ─────────────────────────────────────────────────────────
+/**
+ * Compute all 4 metrics + composite anomalyScore.
+ *
+ * Each signal is normalized to [0, 1] via these heuristics:
+ *   - Shannon: distance from natural-English range 3.9-4.7 bits/char
+ *   - Repetition: rate * 4 clamped (0.25 = 1.0 anomaly)
+ *   - Variance: distance from natural 0.3-0.6 range
+ *   - Zipf: deviation > 1.5 = 1.0 anomaly
+ *
+ * Composite = mean of 4 individual scores. > 0.55 = REFUTED;
+ * > 0.40 = PROBE_DRIFT; ≤ 0.40 = CRYSTAL_CLEAR.
+ */
+export function analyzeText(text) {
+    const shannon = shannonBitsPerChar(text);
+    const rep = repetitionRate(text);
+    const sentVar = sentenceVarianceRatio(text);
+    const zipf = zipfDeviation(text);
+    // Normalize each to [0, 1] anomaly contribution.
+    const shannonAnomaly = (() => {
+        if (text.length < 20)
+            return 0;
+        // Natural English is 3.9-4.7 bits/char. Distance outside this range = anomaly.
+        if (shannon >= 3.9 && shannon <= 4.7)
+            return 0;
+        if (shannon < 3.9)
+            return Math.min(1, (3.9 - shannon) / 2);
+        return Math.min(1, (shannon - 4.7) / 2);
+    })();
+    // Natural English has 15-20% dominant-token rate (the / a / of /
+    // and). Suspicious starts above 30%. Floor at 0.20 (no signal); ramp
+    // linearly to 1.0 at rep=1.0 (a single token = 100% of text).
+    const repAnomaly = Math.max(0, Math.min(1, (rep - 0.20) * 1.25));
+    const variAnomaly = (() => {
+        if (sentVar === 0)
+            return 0;
+        // Natural prose tends to 0.3-0.7 ratio. AI tends to be lower (uniform).
+        if (sentVar >= 0.3 && sentVar <= 0.7)
+            return 0;
+        if (sentVar < 0.3)
+            return Math.min(1, (0.3 - sentVar) / 0.3);
+        return Math.min(1, (sentVar - 0.7) / 0.7);
+    })();
+    const zipfAnomaly = Math.min(1, zipf / 1.5);
+    // Composite: average of the 4 signals, BUT if any single signal is
+    // maxed, boost the composite so a single-axis red flag still drives
+    // a refute. Otherwise high-repetition AI loops would land at composite
+    // 0.30 because the other 3 signals were quiet. Real AI hallucinations
+    // often light up just ONE axis hard — that signal alone should refute.
+    const plainComposite = (shannonAnomaly + repAnomaly + variAnomaly + zipfAnomaly) / 4;
+    const maxSingle = Math.max(shannonAnomaly, repAnomaly, variAnomaly, zipfAnomaly);
+    const composite = Math.max(plainComposite, maxSingle * 0.7);
+    return {
+        shannonBitsPerChar: round3(shannon),
+        repetitionRate: round3(rep),
+        sentenceVarianceRatio: round3(sentVar),
+        zipfDeviation: round3(zipf),
+        anomalyScore: round3(composite),
+    };
+}
+function round3(n) { return Number(n.toFixed(3)); }
+//# sourceMappingURL=anti_entropy.js.map

package/dist/zzzzz_probe/anti_entropy.js.map

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

package/dist/zzzzz_probe/engine.d.ts

@@ -0,0 +1,27 @@
+/**
+ * v2.39.0 — Zzzzz-PROBE orchestrator.
+ *
+ * Fuses anti-entropy + image-provenance + OS-polygraph signals into a
+ * single HMAC-signed ZzzzzReport. Composes with HGP: REFUTED /
+ * IMPOSSIBLE_REFUTE auto-emits an HGP-YYYY-NNNNN id (best-effort,
+ * lazy import to avoid cycles).
+ */
+import type { ProbeInput, ZzzzzReport } from "./types.js";
+export declare function __resetZzzzzChainForTest(): void;
+export declare function probeArtifact(input: ProbeInput, repoRoot: string): Promise<ZzzzzReport>;
+export declare function readLedger(repoRoot: string, limit?: number): ZzzzzReport[];
+export declare function verifyReport(r: ZzzzzReport, prev?: string): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+export interface ArmState {
+    armed: boolean;
+    at: string;
+    reason?: string;
+}
+export declare function arm(repoRoot: string, reason?: string): ArmState;
+export declare function disarm(repoRoot: string): ArmState;
+export declare function isArmed(repoRoot: string): boolean;
+//# sourceMappingURL=engine.d.ts.map

package/dist/zzzzz_probe/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/zzzzz_probe/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAgB,MAAM,YAAY,CAAC;AAQxE,wBAAgB,wBAAwB,IAAI,IAAI,CAAgC;AA0BhF,wBAAsB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAuE7F;AAqBD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,WAAW,EAAE,CAUvE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,GAAE,MAAmB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAQpH;AAKD,MAAM,WAAW,QAAQ;IAAG,KAAK,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAAE;AAE1E,wBAAgB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAK/D;AAED,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAKjD;AAED,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CASjD"}

package/dist/zzzzz_probe/engine.js

@@ -0,0 +1,203 @@
+/**
+ * v2.39.0 — Zzzzz-PROBE orchestrator.
+ *
+ * Fuses anti-entropy + image-provenance + OS-polygraph signals into a
+ * single HMAC-signed ZzzzzReport. Composes with HGP: REFUTED /
+ * IMPOSSIBLE_REFUTE auto-emits an HGP-YYYY-NNNNN id (best-effort,
+ * lazy import to avoid cycles).
+ */
+import { createHash, createHmac } from "node:crypto";
+import { existsSync, mkdirSync, appendFileSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { analyzeText } from "./anti_entropy.js";
+import { analyzeImage } from "./image_provenance.js";
+import { classifyOS } from "./os_polygraph.js";
+const HMAC_KEY = process.env["MNEME_ZZZZZ_KEY"] ?? "mneme-zzzzz-probe-v1";
+const CHAIN_SEED = "0".repeat(64);
+let lastChainLink = CHAIN_SEED;
+export function __resetZzzzzChainForTest() { lastChainLink = CHAIN_SEED; }
+function canon(v) {
+    if (v === null || typeof v !== "object")
+        return JSON.stringify(v);
+    if (Array.isArray(v))
+        return "[" + v.map(canon).join(",") + "]";
+    const keys = Object.keys(v).sort();
+    return "{" + keys.map((k) => JSON.stringify(k) + ":" + canon(v[k])).join(",") + "}";
+}
+function sha(s) { return createHash("sha256").update(s).digest("hex"); }
+function hmacOf(prev, payload) {
+    return createHmac("sha256", HMAC_KEY).update(prev + "|" + payload).digest("hex");
+}
+function classifyVerdict(score) {
+    // Honest threshold ladder (calibrated for false-positive avoidance on
+    // short text + natural images):
+    //   < 0.40  → CRYSTAL_CLEAR     (no signal)
+    //   < 0.55  → PROBE_DRIFT       (warn but don't refute)
+    //   < 0.75  → REFUTED           (clear anomaly)
+    //   ≥ 0.75  → IMPOSSIBLE_REFUTE (multi-axis stack — auto-HGP)
+    if (score >= 0.75)
+        return { verdict: "IMPOSSIBLE_REFUTE", confidence: 0.95 };
+    if (score >= 0.55)
+        return { verdict: "REFUTED", confidence: 0.80 };
+    if (score >= 0.40)
+        return { verdict: "PROBE_DRIFT", confidence: 0.60 };
+    return { verdict: "CRYSTAL_CLEAR", confidence: 0.95 };
+}
+export async function probeArtifact(input, repoRoot) {
+    const at = new Date().toISOString();
+    const os = await classifyOS();
+    const caveats = [];
+    let score = 0;
+    let textMetrics;
+    let imageProvenance;
+    if (input.modality === "text" || input.modality === "code") {
+        if (!input.text) {
+            caveats.push("ZZZZZ_EMPTY_TEXT");
+        }
+        else {
+            textMetrics = analyzeText(input.text);
+            score = textMetrics.anomalyScore;
+            if (textMetrics.anomalyScore >= 0.40)
+                caveats.push(`ZZZZZ_TEXT_ANOMALY:${textMetrics.anomalyScore}`);
+        }
+    }
+    else if (input.modality === "image") {
+        if (!input.imageBytes || input.imageBytes.length === 0) {
+            caveats.push("ZZZZZ_EMPTY_IMAGE");
+        }
+        else {
+            imageProvenance = analyzeImage(input.imageBytes);
+            score = imageProvenance.suspicionScore;
+            if (imageProvenance.suspicionScore >= 0.40)
+                caveats.push(`ZZZZZ_IMAGE_SUSPICION:${imageProvenance.suspicionScore}`);
+        }
+    }
+    const { verdict, confidence } = classifyVerdict(score);
+    const headline = verdictHeadline(verdict, score, input.modality);
+    // Best-effort HGP auto-record for REFUTED / IMPOSSIBLE_REFUTE.
+    let hgpId;
+    if (verdict === "REFUTED" || verdict === "IMPOSSIBLE_REFUTE") {
+        try {
+            // Lazy import to avoid cycle (hgp imports nothing from us).
+            const hgp = await import("../hgp/index.js");
+            const claimSummary = input.modality === "image"
+                ? `IMAGE_SUSPICION:${imageProvenance?.suspicionScore} pHash=${imageProvenance?.pHash} format=${imageProvenance?.format}`
+                : `TEXT_ANOMALY:${textMetrics?.anomalyScore} shannon=${textMetrics?.shannonBitsPerChar} rep=${textMetrics?.repetitionRate}`;
+            const record = hgp.recordHallucination(repoRoot, {
+                claim: claimSummary,
+                signature: `zzzzz_probe:${input.modality}:${verdict}`,
+                ...(input.vendor ? { vendor: input.vendor } : {}),
+            });
+            hgpId = record.hgpId;
+        }
+        catch { /* HGP unavailable — degrade gracefully */ }
+    }
+    const body = {
+        spec: { name: "MNEME-ZZZZZ-PROBE", version: "1.0" },
+        modality: input.modality,
+        verdict,
+        confidence,
+        headline,
+        ...(textMetrics ? { textMetrics } : {}),
+        ...(imageProvenance ? { imageProvenance } : {}),
+        os,
+        caveats,
+        ...(hgpId ? { hgpId } : {}),
+        at,
+    };
+    const bodyDigest = sha(canon(body));
+    lastChainLink = hmacOf(lastChainLink, bodyDigest);
+    const report = {
+        ...body,
+        hmac: lastChainLink,
+        seq: parseInt(lastChainLink.slice(0, 8), 16),
+        bodyDigest,
+    };
+    try {
+        persistReport(repoRoot, report);
+    }
+    catch { /* best-effort */ }
+    return report;
+}
+function verdictHeadline(v, score, modality) {
+    if (v === "CRYSTAL_CLEAR")
+        return `💎 CRYSTAL_CLEAR — ${modality} passes Zzzzz-PROBE (score ${(score * 100).toFixed(0)}%)`;
+    if (v === "PROBE_DRIFT")
+        return `🟡 PROBE_DRIFT — ${modality} shows mild anomaly (score ${(score * 100).toFixed(0)}%); not refuted but worth a second look`;
+    if (v === "REFUTED")
+        return `🔴 REFUTED — ${modality} shows clear AI-generation signal (score ${(score * 100).toFixed(0)}%)`;
+    return `💥 IMPOSSIBLE_REFUTE — ${modality} multi-axis anomaly stack (score ${(score * 100).toFixed(0)}%); HGP-ID auto-issued`;
+}
+// ── Persistence ───────────────────────────────────────────────────────
+function dirOf(repoRoot) {
+    const d = join(repoRoot, ".mneme", "zzzzz_probe");
+    if (!existsSync(d))
+        mkdirSync(d, { recursive: true });
+    return d;
+}
+function persistReport(repoRoot, r) {
+    appendFileSync(join(dirOf(repoRoot), "ledger.jsonl"), JSON.stringify(r) + "\n");
+}
+export function readLedger(repoRoot, limit = 100) {
+    const p = join(dirOf(repoRoot), "ledger.jsonl");
+    if (!existsSync(p))
+        return [];
+    try {
+        const out = [];
+        for (const ln of readFileSync(p, "utf8").split("\n").filter(Boolean).slice(-limit)) {
+            try {
+                out.push(JSON.parse(ln));
+            }
+            catch { /* skip */ }
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+export function verifyReport(r, prev = CHAIN_SEED) {
+    const { hmac, seq: _s, bodyDigest, ...body } = r;
+    void _s;
+    const recomputed = sha(canon(body));
+    if (recomputed !== bodyDigest)
+        return { ok: false, reason: "bodyDigest mismatch" };
+    const expected = hmacOf(prev, recomputed);
+    if (expected !== hmac)
+        return { ok: false, reason: "hmac mismatch" };
+    return { ok: true };
+}
+export function arm(repoRoot, reason) {
+    const state = { armed: true, at: new Date().toISOString(), ...(reason ? { reason } : {}) };
+    const p = join(dirOf(repoRoot), "armed.json");
+    try {
+        appendFileSync(p, JSON.stringify(state) + "\n");
+    }
+    catch { /* best-effort */ }
+    return state;
+}
+export function disarm(repoRoot) {
+    const state = { armed: false, at: new Date().toISOString() };
+    const p = join(dirOf(repoRoot), "armed.json");
+    try {
+        appendFileSync(p, JSON.stringify(state) + "\n");
+    }
+    catch { /* best-effort */ }
+    return state;
+}
+export function isArmed(repoRoot) {
+    const p = join(dirOf(repoRoot), "armed.json");
+    if (!existsSync(p))
+        return false;
+    try {
+        const lines = readFileSync(p, "utf8").split("\n").filter(Boolean);
+        if (lines.length === 0)
+            return false;
+        const last = JSON.parse(lines[lines.length - 1]);
+        return !!last.armed;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/zzzzz_probe/engine.js.map

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

package/dist/zzzzz_probe/image_provenance.d.ts

@@ -0,0 +1,34 @@
+/**
+ * v2.39.0 — Multi-Modal Image Provenance.
+ *
+ * Frequency-domain + perceptual signals for AI-generated image
+ * detection. No GPU, no ML model, no native deps — pure-Node.
+ *
+ * Signals (academically cited):
+ *   1. pHash (DCT-like 8x8 perceptual hash) for duplicate detection
+ *   2. Laplacian variance — AI images often unnaturally smooth (low var)
+ *   3. Color-histogram entropy — AI images cluster in narrow palettes
+ *   4. JPEG quantization-table fingerprint — distinct table per encoder
+ *   5. Distinct color count in 32×32 downsample — extra clustering signal
+ *
+ * Format detection via magic bytes (JPEG/PNG/WebP/GIF/BMP).
+ * Honest scope: we read SIZE + PIXEL DATA where format is supported
+ * (decoder-free for BMP/PNG; for JPEG/WebP/GIF we extract metadata
+ * + quantization tables but skip per-pixel decode — the heuristics
+ * still work on the header signals + downsampled pixel approximation).
+ */
+import type { ImageProvenance } from "./types.js";
+type Format = "jpeg" | "png" | "webp" | "gif" | "bmp" | "unknown";
+export declare function detectFormat(b: Uint8Array): Format;
+export declare function parseDimensions(b: Uint8Array, fmt: Format): {
+    width: number;
+    height: number;
+};
+export declare function perceptualHash(b: Uint8Array): string;
+export declare function colorHistogramEntropy(b: Uint8Array): number;
+export declare function laplacianVariance(b: Uint8Array): number;
+export declare function distinctColorCount32(b: Uint8Array): number;
+export declare function jpegQuantFingerprint(b: Uint8Array): string | null;
+export declare function analyzeImage(b: Uint8Array): ImageProvenance;
+export {};
+//# sourceMappingURL=image_provenance.d.ts.map

package/dist/zzzzz_probe/image_provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image_provenance.d.ts","sourceRoot":"","sources":["../../src/zzzzz_probe/image_provenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,KAAK,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;AAIlE,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAclD;AAID,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAgD7F;AAID,wBAAgB,cAAc,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAUpD;AAID,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAoB3D;AAID,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAWvD;AAID,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAU1D;AAID,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAkBjE;AAID,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,GAAG,eAAe,CAgC3D"}