@mneme-ai/core 1.68.0 → 1.69.0

package/dist/hyperscan/hyperscan.test.js

@@ -0,0 +1,191 @@
+/**
+ * v1.69.0 -- HYPERSCAN PROTOCOL test suite.
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, rmSync, mkdirSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { execSync } from "node:child_process";
+import { extractEntities, proseScan } from "./prose_shadow.js";
+import { parseTriples, crossCitationGround } from "./cross_citation.js";
+import { crossSourceAsk } from "./cross_source_qa.js";
+import { generateDust, computeCoverage, clusterDust, readAbstracts } from "./nucleus_dust_htc.js";
+import { buildMolecule, query } from "./hyperscan_molecule.js";
+function setup() { return mkdtempSync(join(tmpdir(), "mneme-hs-")); }
+function cleanup(r) { try {
+    rmSync(r, { recursive: true, force: true });
+}
+catch { /* */ } }
+function initGit(r, files, commits) {
+    execSync(`git init --quiet -b main`, { cwd: r, stdio: "ignore" });
+    execSync(`git config user.email "t@t.t"`, { cwd: r, stdio: "ignore" });
+    execSync(`git config user.name "t"`, { cwd: r, stdio: "ignore" });
+    execSync(`git config commit.gpgsign false`, { cwd: r, stdio: "ignore" });
+    for (const f of files) {
+        const dir = join(r, f.path, "..");
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(join(r, f.path), f.content, "utf8");
+    }
+    execSync(`git add -A`, { cwd: r, stdio: "ignore" });
+    for (const c of commits) {
+        writeFileSync(join(r, `m-${c.replace(/\W/g, "_")}.txt`), c, "utf8");
+        execSync(`git add -A`, { cwd: r, stdio: "ignore" });
+        execSync(`git commit -m "${c}" --no-gpg-sign --quiet`, { cwd: r, stdio: "ignore" });
+    }
+}
+// ─── H1 PROSE SHADOW SCAN ────────────────────────────────────────────
+describe("v1.69 Hyperscan H1 · Prose Shadow Scan", () => {
+    let r;
+    beforeEach(() => { r = setup(); writeFileSync(join(r, "package.json"), JSON.stringify({ name: "test", dependencies: { typescript: "5.0.0", react: "18.0.0" } }), "utf8"); });
+    afterEach(() => cleanup(r));
+    it("extracts title-cased + package-shaped + acronym entities", () => {
+        const ents = extractEntities("WraithMonitor handles tracing via wraith-utils-2099 with ACME-Lib 3.0");
+        const surfaces = ents.map((e) => e.surface);
+        expect(surfaces).toContain("WraithMonitor");
+        expect(surfaces.some((s) => s.startsWith("wraith-utils"))).toBe(true);
+    });
+    it("catches fake package-shape with digits + no citation", () => {
+        const r1 = proseScan(r, "wraith-utils-2099 is integrated for caching across services");
+        const wraith = r1.suspects.find((s) => s.entity.toLowerCase().includes("wraith"));
+        expect(wraith).toBeDefined();
+        expect(wraith.confidence).toBeGreaterThanOrEqual(0.8);
+    });
+    it("recognizes known-real services (whitelists them)", () => {
+        const r1 = proseScan(r, "We use Sentry for error tracking and Datadog for APM");
+        expect(r1.recognized.length).toBeGreaterThan(0);
+        expect(r1.suspects.find((s) => s.entity.toLowerCase() === "sentry")).toBeUndefined();
+    });
+    it("flags title-cased unknowns with no citation", () => {
+        const r1 = proseScan(r, "FakeyMcFakeFace is our production OAuth library");
+        expect(r1.suspects.find((s) => s.entity.includes("FakeyMcFake"))).toBeDefined();
+    });
+    it("does NOT flag real deps", () => {
+        const r1 = proseScan(r, "TypeScript handles our types and React renders the UI");
+        // Both are in KNOWN_REAL_NAMES; should be recognized not suspected.
+        expect(r1.suspects.length).toBe(0);
+    });
+});
+// ─── H2 CROSS-CITATION GROUND ────────────────────────────────────────
+describe("v1.69 Hyperscan H2 · Cross-Citation Ground", () => {
+    let r;
+    beforeEach(() => { r = setup(); });
+    afterEach(() => cleanup(r));
+    it("parses triples from prose", () => {
+        const tr = parseTriples("auth.ts handles login and billing.ts implements charging");
+        expect(tr.length).toBeGreaterThanOrEqual(2);
+        expect(tr[0]?.subject).toContain("auth");
+    });
+    it("flags citation gap when files don't exist", () => {
+        const r1 = crossCitationGround(r, "PhantomMonitor handles distributed tracing across services");
+        expect(r1.gaps).toBeGreaterThanOrEqual(0);
+        expect(r1.groundScore).toBeLessThanOrEqual(1);
+    });
+    it("grounds when subject + object co-occur in source", () => {
+        writeFileSync(join(r, "auth.ts"), "// auth login bcrypt handler\nexport function login() {}\n", "utf8");
+        const r1 = crossCitationGround(r, "auth.ts handles login routing for users");
+        expect(r1.groundScore).toBeGreaterThan(0);
+    });
+});
+// ─── H3 CROSS-SOURCE Q&A FUSION ──────────────────────────────────────
+describe("v1.69 Hyperscan H3 · Cross-Source Q&A Fusion", () => {
+    let r;
+    beforeEach(() => { r = setup(); });
+    afterEach(() => cleanup(r));
+    it("fuses retrieval across multiple sources", () => {
+        initGit(r, [
+            { path: "README.md", content: "# Project\n\nHTC compression cuts token spend by 100x via three-layer pre-compression of git history into LLM-consumable form.\n" },
+            { path: "CHANGELOG.md", content: "## [1.0.0]\n- Added HTC compression for git history\n" },
+            { path: "package.json", content: JSON.stringify({ name: "p", description: "HTC-powered memory layer." }) },
+            { path: "htc.ts", content: "/**\n * HTC: hierarchical token cache for compressing commit history.\n */\nexport const x = 1;\n" },
+        ], ["feat: add HTC compression"]);
+        const r1 = crossSourceAsk(r, "what is HTC compression and how does it work");
+        expect(r1.sourcesPresent.length).toBeGreaterThanOrEqual(2);
+        expect(["MEDIUM", "HIGH"]).toContain(r1.trustLabel);
+        expect(r1.fusedAnswer).toContain("HTC");
+    });
+    it("reports LOW trust when nothing matches", () => {
+        initGit(r, [{ path: "README.md", content: "Only generic stuff here." }], ["initial"]);
+        const r1 = crossSourceAsk(r, "what is fooBarBaz compression");
+        expect(r1.trustLabel).toBe("LOW");
+    });
+});
+// ─── H4 NUCLEUS DUST HTC ─────────────────────────────────────────────
+describe("v1.69 Hyperscan H4 · Nucleus Dust HTC", () => {
+    let r;
+    beforeEach(() => { r = setup(); });
+    afterEach(() => cleanup(r));
+    it("generates abstracts for commits + file docstrings", () => {
+        initGit(r, [
+            { path: "src/foo.ts", content: "/**\n * Foo module: does the foo thing.\n */\nexport const x = 1;\n" },
+            { path: "src/bar.ts", content: "/**\n * Bar module: handles bars.\n */\nexport const y = 2;\n" },
+        ], ["feat(foo): add foo", "feat(bar): add bar", "fix: tidy"]);
+        const { added } = generateDust(r);
+        expect(added).toBeGreaterThanOrEqual(2);
+        const abstracts = readAbstracts(r);
+        expect(abstracts.length).toBeGreaterThanOrEqual(2);
+    });
+    it("coverage increases after dust generation", () => {
+        initGit(r, [{ path: "src/foo.ts", content: "/** Foo. */\nexport const x = 1;\n" }], ["feat: foo"]);
+        const before = computeCoverage(r).coveragePct;
+        generateDust(r);
+        const after = computeCoverage(r).coveragePct;
+        expect(after).toBeGreaterThanOrEqual(before);
+        expect(after).toBeGreaterThan(0);
+    });
+    it("idempotent: re-running adds 0", () => {
+        initGit(r, [{ path: "src/foo.ts", content: "/** Foo. */\nexport const x = 1;\n" }], ["feat: foo"]);
+        generateDust(r);
+        const second = generateDust(r);
+        expect(second.added).toBe(0);
+    });
+    it("clusterDust groups similar abstracts", () => {
+        initGit(r, [], ["feat(auth): add login", "feat(auth): add logout", "fix(auth): retry", "feat(billing): stripe"]);
+        generateDust(r);
+        const clusters = clusterDust(r);
+        expect(clusters.length).toBeGreaterThan(0);
+    });
+});
+// ─── HYPERSCAN MOLECULE ──────────────────────────────────────────────
+describe("v1.69 Hyperscan · Shape-shifting Molecule", () => {
+    it("builds a molecule with 4 forms", () => {
+        const m = buildMolecule({
+            text: "function login() handles auth via bcrypt at src/auth.ts",
+            source: { kind: "commit", ref: "abc123" },
+            epoch: "2026-01-01T00:00:00Z",
+        });
+        expect(m.textForm).toContain("login");
+        expect(m.vectorForm.size).toBeGreaterThan(0);
+        expect(m.structuralForm.functions).toContain("login");
+        expect(m.structuralForm.paths.some((p) => p.endsWith(".ts"))).toBe(true);
+        expect(m.temporalForm.epoch).toBe("2026-01-01T00:00:00Z");
+    });
+    it("query with cosine ranks by vector similarity", () => {
+        const mA = buildMolecule({ text: "auth bcrypt login flow", source: { kind: "commit", ref: "a" } });
+        const mB = buildMolecule({ text: "billing stripe charge", source: { kind: "commit", ref: "b" } });
+        const result = query([mA, mB], "cosine", { text: "auth login" });
+        expect(result[0]?.molecule.id).toBe(mA.id);
+    });
+    it("query with structural ranks by AST shape overlap", () => {
+        const mA = buildMolecule({ text: "function login() at src/auth.ts", source: { kind: "commit", ref: "a" } });
+        const mB = buildMolecule({ text: "class Billing in billing.js", source: { kind: "commit", ref: "b" } });
+        const result = query([mA, mB], "structural", { text: "function login() at src/auth.ts" });
+        expect(result[0]?.molecule.id).toBe(mA.id);
+    });
+    it("query with hybrid fuses 4 algorithm scores", () => {
+        const m1 = buildMolecule({ text: "auth login bcrypt secure flow", source: { kind: "commit", ref: "a" } });
+        const m2 = buildMolecule({ text: "billing stripe payment processing", source: { kind: "commit", ref: "b" } });
+        const result = query([m1, m2], "hybrid", { text: "auth login bcrypt" });
+        expect(result[0]?.molecule.id).toBe(m1.id);
+        expect(result[0]?.scores.cosine).toBeDefined();
+        expect(result[0]?.scores.jaccard).toBeDefined();
+        expect(result[0]?.scores.structural).toBeDefined();
+    });
+    it("query with temporal ranks by epoch closeness", () => {
+        const target = "2026-05-12T00:00:00Z";
+        const close = buildMolecule({ text: "x", source: { kind: "c", ref: "1" }, epoch: "2026-05-11T00:00:00Z" });
+        const far = buildMolecule({ text: "x", source: { kind: "c", ref: "2" }, epoch: "2020-01-01T00:00:00Z" });
+        const result = query([close, far], "temporal", { epoch: target });
+        expect(result[0]?.molecule.id).toBe(close.id);
+    });
+});
+//# sourceMappingURL=hyperscan.test.js.map

package/dist/hyperscan/hyperscan.test.js.map

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

package/dist/hyperscan/hyperscan_molecule.d.ts

@@ -0,0 +1,76 @@
+/**
+ * v1.69.0 -- HYPERSCAN MOLECULE (shape-shifting data structure).
+ *
+ * The wild bit: a single MOLECULE holds FOUR orthogonal forms of one
+ * piece of knowledge. The caller asks for whichever FORM best
+ * matches their query class -- the molecule "shape-shifts" without
+ * recomputation.
+ *
+ *   textForm        plain-English summary (~30 tokens)
+ *   vectorForm      bag-of-words vector for cosine retrieval
+ *   structuralForm  AST-shape signature (functions / paths / symbols)
+ *   temporalForm    commit-chain neighborhood (predecessor / successor SHAs)
+ *
+ * "Mix algorithm สุดโต่ง": at query time the caller picks ONE of N
+ * retrieval algorithms (Jaccard / cosine / structural-match /
+ * temporal-distance / hybrid-weighted) and the molecule emits the
+ * matching form. Different forms NEVER recomputed -- pre-built.
+ *
+ * This is the data structure the user asked for: "โมเลกุลใหม่
+ * มารองรับ" + "การสลับร่างแปลงร่าง" + "mix algorithm บ้าๆสุดโต่ง".
+ */
+export type MoleculeForm = "text" | "vector" | "structural" | "temporal";
+export interface HyperscanMolecule {
+    id: string;
+    /** Plain-English summary. */
+    textForm: string;
+    /** Bag-of-words vector: word -> count. */
+    vectorForm: Map<string, number>;
+    /** AST-shape signature: {functions, classes, paths, symbols}. */
+    structuralForm: {
+        functions: string[];
+        classes: string[];
+        paths: string[];
+        symbols: string[];
+    };
+    /** Temporal links to neighboring molecules. */
+    temporalForm: {
+        predecessors: string[];
+        successors: string[];
+        epoch: string;
+    };
+    /** Source provenance. */
+    source: {
+        kind: string;
+        ref: string;
+    };
+}
+export interface BuildMoleculeInput {
+    text: string;
+    source: {
+        kind: string;
+        ref: string;
+    };
+    epoch?: string;
+    predecessors?: string[];
+    successors?: string[];
+}
+/** Build a molecule from a text excerpt + provenance. */
+export declare function buildMolecule(input: BuildMoleculeInput): HyperscanMolecule;
+export type RetrievalAlgo = "jaccard" | "cosine" | "structural" | "temporal" | "hybrid";
+export interface QueryInput {
+    text?: string;
+    epoch?: string;
+}
+export interface MoleculeMatch {
+    molecule: HyperscanMolecule;
+    /** Per-algo scores; populated when caller asked for hybrid. */
+    scores: Partial<Record<RetrievalAlgo, number>>;
+    /** Final fused score the caller will rank by. */
+    finalScore: number;
+}
+/** Query a corpus of molecules using one of N retrieval algorithms.
+ *  "hybrid" fuses cosine + jaccard + structural + temporal via the
+ *  ALGO_WEIGHTS mix (the wild algorithm-mix the user requested). */
+export declare function query(molecules: HyperscanMolecule[], algo: RetrievalAlgo, q: QueryInput): MoleculeMatch[];
+//# sourceMappingURL=hyperscan_molecule.d.ts.map

package/dist/hyperscan/hyperscan_molecule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperscan_molecule.d.ts","sourceRoot":"","sources":["../../src/hyperscan/hyperscan_molecule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAC;AAEzE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,iEAAiE;IACjE,cAAc,EAAE;QACd,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,+CAA+C;IAC/C,YAAY,EAAE;QACZ,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,yBAAyB;IACzB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AA6BD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,iBAAiB,CAc1E;AAyCD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;AAExF,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,+DAA+D;IAC/D,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;CACpB;AAUD;;oEAEoE;AACpE,wBAAgB,KAAK,CACnB,SAAS,EAAE,iBAAiB,EAAE,EAC9B,IAAI,EAAE,aAAa,EACnB,CAAC,EAAE,UAAU,GACZ,aAAa,EAAE,CA0BjB"}

package/dist/hyperscan/hyperscan_molecule.js

@@ -0,0 +1,144 @@
+/**
+ * v1.69.0 -- HYPERSCAN MOLECULE (shape-shifting data structure).
+ *
+ * The wild bit: a single MOLECULE holds FOUR orthogonal forms of one
+ * piece of knowledge. The caller asks for whichever FORM best
+ * matches their query class -- the molecule "shape-shifts" without
+ * recomputation.
+ *
+ *   textForm        plain-English summary (~30 tokens)
+ *   vectorForm      bag-of-words vector for cosine retrieval
+ *   structuralForm  AST-shape signature (functions / paths / symbols)
+ *   temporalForm    commit-chain neighborhood (predecessor / successor SHAs)
+ *
+ * "Mix algorithm สุดโต่ง": at query time the caller picks ONE of N
+ * retrieval algorithms (Jaccard / cosine / structural-match /
+ * temporal-distance / hybrid-weighted) and the molecule emits the
+ * matching form. Different forms NEVER recomputed -- pre-built.
+ *
+ * This is the data structure the user asked for: "โมเลกุลใหม่
+ * มารองรับ" + "การสลับร่างแปลงร่าง" + "mix algorithm บ้าๆสุดโต่ง".
+ */
+import { createHash } from "node:crypto";
+const STOPWORDS = new Set([
+    "the", "and", "for", "with", "this", "that", "from", "into", "when",
+    "function", "const", "var", "let", "true", "false", "null", "return", "import", "export",
+]);
+function bagOfWords(text) {
+    const out = new Map();
+    for (const t of text.toLowerCase().replace(/[^a-z0-9_\s]/g, " ").split(/\s+/)) {
+        if (t.length < 3 || STOPWORDS.has(t))
+            continue;
+        out.set(t, (out.get(t) ?? 0) + 1);
+    }
+    return out;
+}
+function extractStructural(text) {
+    const functions = [...text.matchAll(/\b(?:function\s+)?(\w{3,})\s*\(/g)].map((m) => m[1]).filter((x) => !!x);
+    const classes = [...text.matchAll(/\bclass\s+(\w{2,})/g)].map((m) => m[1]);
+    const paths = [...text.matchAll(/[\w./_-]+\.(?:ts|tsx|js|mjs|cjs|jsx|json|md|sql|yml|yaml|py|rs|go)/g)].map((m) => m[0]);
+    const symbols = [...text.matchAll(/\b[A-Z][A-Z_]{2,}\b/g)].map((m) => m[0]);
+    return {
+        functions: [...new Set(functions)].slice(0, 10),
+        classes: [...new Set(classes)].slice(0, 10),
+        paths: [...new Set(paths)].slice(0, 10),
+        symbols: [...new Set(symbols)].slice(0, 10),
+    };
+}
+/** Build a molecule from a text excerpt + provenance. */
+export function buildMolecule(input) {
+    const id = createHash("sha256").update(`${input.source.kind}|${input.source.ref}|${input.text}`).digest("hex").slice(0, 16);
+    return {
+        id,
+        textForm: input.text.slice(0, 280),
+        vectorForm: bagOfWords(input.text),
+        structuralForm: extractStructural(input.text),
+        temporalForm: {
+            predecessors: input.predecessors ?? [],
+            successors: input.successors ?? [],
+            epoch: input.epoch ?? "",
+        },
+        source: input.source,
+    };
+}
+// ─── Retrieval algorithms (the "mix") ────────────────────────────────
+function cosine(a, b) {
+    let dot = 0, na = 0, nb = 0;
+    for (const [t, c] of a) {
+        na += c * c;
+        if (b.has(t))
+            dot += c * b.get(t);
+    }
+    for (const [, c] of b)
+        nb += c * c;
+    return (na === 0 || nb === 0) ? 0 : dot / Math.sqrt(na * nb);
+}
+function jaccard(a, b) {
+    if (a.size === 0 || b.size === 0)
+        return 0;
+    let inter = 0;
+    for (const x of a)
+        if (b.has(x))
+            inter += 1;
+    return inter / (a.size + b.size - inter);
+}
+function structuralMatch(query, mol) {
+    let total = 0, matched = 0;
+    for (const key of ["functions", "classes", "paths", "symbols"]) {
+        const q = new Set(query[key]);
+        const m = new Set(mol[key]);
+        total += Math.max(q.size, m.size);
+        matched += [...q].filter((x) => m.has(x)).length;
+    }
+    return total === 0 ? 0 : matched / total;
+}
+function temporalDistance(queryEpoch, mol) {
+    if (!queryEpoch || !mol.temporalForm.epoch)
+        return 0;
+    const dt = Math.abs(Date.parse(queryEpoch) - Date.parse(mol.temporalForm.epoch));
+    if (!Number.isFinite(dt))
+        return 0;
+    // Score: closer in time -> higher.
+    const days = dt / 86400000;
+    return 1 / (1 + days / 30); // half-life ~30 days
+}
+const ALGO_WEIGHTS = {
+    cosine: 0.35,
+    jaccard: 0.25,
+    structural: 0.25,
+    temporal: 0.15,
+    hybrid: 0, // not used; placeholder
+};
+/** Query a corpus of molecules using one of N retrieval algorithms.
+ *  "hybrid" fuses cosine + jaccard + structural + temporal via the
+ *  ALGO_WEIGHTS mix (the wild algorithm-mix the user requested). */
+export function query(molecules, algo, q) {
+    const queryVec = q.text ? bagOfWords(q.text) : new Map();
+    const queryTokens = new Set(queryVec.keys());
+    const queryStructural = q.text ? extractStructural(q.text) : { functions: [], classes: [], paths: [], symbols: [] };
+    const matches = molecules.map((mol) => {
+        const molTokens = new Set(mol.vectorForm.keys());
+        const scores = {};
+        if (algo === "cosine" || algo === "hybrid")
+            scores.cosine = cosine(queryVec, mol.vectorForm);
+        if (algo === "jaccard" || algo === "hybrid")
+            scores.jaccard = jaccard(queryTokens, molTokens);
+        if (algo === "structural" || algo === "hybrid")
+            scores.structural = structuralMatch(queryStructural, mol.structuralForm);
+        if (algo === "temporal" || algo === "hybrid")
+            scores.temporal = temporalDistance(q.epoch ?? "", mol);
+        let finalScore = 0;
+        if (algo === "hybrid") {
+            for (const a of ["cosine", "jaccard", "structural", "temporal"]) {
+                finalScore += (scores[a] ?? 0) * ALGO_WEIGHTS[a];
+            }
+        }
+        else {
+            finalScore = scores[algo] ?? 0;
+        }
+        return { molecule: mol, scores, finalScore };
+    });
+    matches.sort((a, b) => b.finalScore - a.finalScore);
+    return matches;
+}
+//# sourceMappingURL=hyperscan_molecule.js.map

package/dist/hyperscan/hyperscan_molecule.js.map

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

package/dist/hyperscan/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * v1.69.0 -- HYPERSCAN PROTOCOL.
+ *
+ * Four wild moves to close the prose-scan gap + Q&A trust gap +
+ * HTC coverage gap. Plus a shape-shifting molecule data structure
+ * that supports 5 mixed retrieval algorithms.
+ *
+ *   H1 prose shadow scan   entity extraction from prose claims
+ *   H2 cross-citation      every named entity needs codebase evidence
+ *   H3 cross-source Q&A    fuse retrieval across 5 source kinds
+ *   H4 nucleus dust HTC    auto-populate HTC coverage 0% -> ~100%
+ *   MOLECULE              text/vector/structural/temporal forms
+ */
+export * as proseShadow from "./prose_shadow.js";
+export * as crossCitation from "./cross_citation.js";
+export * as crossSourceQa from "./cross_source_qa.js";
+export * as nucleusDustHtc from "./nucleus_dust_htc.js";
+export * as hyperscanMolecule from "./hyperscan_molecule.js";
+export * as bench from "./bench.js";
+export { proseScan, extractEntities } from "./prose_shadow.js";
+export { crossCitationGround, parseTriples } from "./cross_citation.js";
+export { crossSourceAsk } from "./cross_source_qa.js";
+export { generateDust, computeCoverage, clusterDust, readAbstracts } from "./nucleus_dust_htc.js";
+export { buildMolecule, query, type HyperscanMolecule, type RetrievalAlgo, type MoleculeMatch } from "./hyperscan_molecule.js";
+export { runHyperscanBench, renderBench } from "./bench.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hyperscan/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,aAAa,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,cAAc,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,iBAAiB,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAEpC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAClG,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC/H,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/hyperscan/index.js

@@ -0,0 +1,26 @@
+/**
+ * v1.69.0 -- HYPERSCAN PROTOCOL.
+ *
+ * Four wild moves to close the prose-scan gap + Q&A trust gap +
+ * HTC coverage gap. Plus a shape-shifting molecule data structure
+ * that supports 5 mixed retrieval algorithms.
+ *
+ *   H1 prose shadow scan   entity extraction from prose claims
+ *   H2 cross-citation      every named entity needs codebase evidence
+ *   H3 cross-source Q&A    fuse retrieval across 5 source kinds
+ *   H4 nucleus dust HTC    auto-populate HTC coverage 0% -> ~100%
+ *   MOLECULE              text/vector/structural/temporal forms
+ */
+export * as proseShadow from "./prose_shadow.js";
+export * as crossCitation from "./cross_citation.js";
+export * as crossSourceQa from "./cross_source_qa.js";
+export * as nucleusDustHtc from "./nucleus_dust_htc.js";
+export * as hyperscanMolecule from "./hyperscan_molecule.js";
+export * as bench from "./bench.js";
+export { proseScan, extractEntities } from "./prose_shadow.js";
+export { crossCitationGround, parseTriples } from "./cross_citation.js";
+export { crossSourceAsk } from "./cross_source_qa.js";
+export { generateDust, computeCoverage, clusterDust, readAbstracts } from "./nucleus_dust_htc.js";
+export { buildMolecule, query } from "./hyperscan_molecule.js";
+export { runHyperscanBench, renderBench } from "./bench.js";
+//# sourceMappingURL=index.js.map

package/dist/hyperscan/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hyperscan/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,aAAa,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,cAAc,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,iBAAiB,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAEpC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAClG,OAAO,EAAE,aAAa,EAAE,KAAK,EAAkE,MAAM,yBAAyB,CAAC;AAC/H,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/hyperscan/nucleus_dust_htc.d.ts

@@ -0,0 +1,71 @@
+/**
+ * v1.69.0 -- HYPERSCAN H4: NUCLEUS DUST HTC.
+ *
+ * Wild idea: HTC's coverage is 0% on fresh repos because the user
+ * must manually run `htc-build populate Layer 1`. We make it automatic.
+ *
+ * "Nucleus dust" -- every observable artifact gets compressed into a
+ * tiny HTC molecule on the fly, NO manual step. The DUST accumulates
+ * silently as Mneme runs.
+ *
+ *   - Every commit subject -> Layer 1 abstract (heuristic, no LLM)
+ *   - Every file's top docstring -> Layer 1 abstract for the file
+ *   - Auto-cluster by token-similarity into Layer 2
+ *   - Concatenate Layer 2 into Layer 3 (memoir) on demand
+ *
+ * Layer 1 abstracts are HEURISTIC (no LLM call) -- "feat(area): summary"
+ * commits already carry their condensation. For prose commits we
+ * truncate to 30 tokens. This is a "free path" alternative to the
+ * LLM-driven layer.
+ *
+ * Coverage tracking: total abstracts / (total commits + total source
+ * files). Targets >= 80% on any healthy repo.
+ */
+export interface DustAbstract {
+    /** Stable id: hash of source. */
+    id: string;
+    /** What got compressed: commit hash, file path, etc. */
+    source: {
+        kind: "commit" | "file-docstring";
+        ref: string;
+    };
+    /** The abstract text (<=30 tokens). */
+    abstract: string;
+    /** Estimated token count. */
+    tokenCount: number;
+    /** ISO ts. */
+    generatedAt: string;
+}
+export interface DustCluster {
+    clusterId: string;
+    /** Topic label inferred from member abstracts. */
+    label: string;
+    /** Members. */
+    memberIds: string[];
+    /** Token count of the cluster summary. */
+    tokenCount: number;
+}
+export interface CoverageStats {
+    totalCommits: number;
+    totalFiles: number;
+    abstractsGenerated: number;
+    coveragePct: number;
+    updatedAt: string;
+}
+/** Idempotent: generates abstracts for everything not yet covered. */
+export declare function generateDust(repoRoot: string, opts?: {
+    maxCommits?: number;
+    maxFiles?: number;
+}): {
+    added: number;
+    abstracts: DustAbstract[];
+};
+export declare function readAbstracts(repoRoot: string): DustAbstract[];
+/** Compute coverage = abstracts / (commits + source files). */
+export declare function computeCoverage(repoRoot: string): CoverageStats;
+/** Auto-cluster abstracts by token overlap. Lightweight; no LLM. */
+export declare function clusterDust(repoRoot: string, opts?: {
+    jaccardThreshold?: number;
+    maxClusters?: number;
+}): DustCluster[];
+//# sourceMappingURL=nucleus_dust_htc.d.ts.map

package/dist/hyperscan/nucleus_dust_htc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nucleus_dust_htc.d.ts","sourceRoot":"","sources":["../../src/hyperscan/nucleus_dust_htc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAYH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,MAAM,EAAE;QAAE,IAAI,EAAE,QAAQ,GAAG,gBAAgB,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,eAAe;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAqED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,YAAY,EAAE,CAAA;CAAE,CAsC9I;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAW9D;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAoB/D;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,EAAE,CA4CvH"}