@mneme-ai/core 1.67.1 → 1.69.0

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"}

package/dist/hyperscan/nucleus_dust_htc.js

@@ -0,0 +1,242 @@
+/**
+ * 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.
+ */
+import { existsSync, readFileSync, readdirSync, statSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { execSync } from "node:child_process";
+import { createHash } from "node:crypto";
+const DUST_DIR = ".mneme/hyperscan/htc-dust";
+const ABSTRACTS_FILE = ".mneme/hyperscan/htc-dust/abstracts.jsonl";
+const CLUSTERS_FILE = ".mneme/hyperscan/htc-dust/clusters.json";
+const COVERAGE_FILE = ".mneme/hyperscan/htc-dust/coverage.json";
+function ensureDir(repoRoot) {
+    const d = join(repoRoot, DUST_DIR);
+    if (!existsSync(d))
+        mkdirSync(d, { recursive: true });
+}
+function estTokenCount(s) {
+    return Math.max(1, Math.round(s.split(/\s+/).length * 1.3));
+}
+/** Heuristic Layer-1 abstract for a commit subject. */
+function abstractCommit(subject, body) {
+    // Conventional commit lines are already abstract-shaped.
+    if (/^[a-z]+(\([\w-]+\))?:/.test(subject)) {
+        return subject.split("\n")[0].slice(0, 140);
+    }
+    // Otherwise: take first sentence of subject + first line of body.
+    const firstSent = subject.split(/(?<=[.!?])\s+/)[0];
+    if (body) {
+        const firstBodyLine = body.split("\n").find((l) => l.trim().length > 0) ?? "";
+        return `${firstSent} (${firstBodyLine.slice(0, 80)})`.slice(0, 140);
+    }
+    return firstSent.slice(0, 140);
+}
+/** Heuristic Layer-1 abstract for a source-file docstring. */
+function abstractDocstring(path, doc) {
+    const fname = path.split(/[\\/]/).pop();
+    // Take the first non-empty meaningful line.
+    const firstLine = doc.split("\n").map((l) => l.trim()).find((l) => l && !l.startsWith("*") && !/^v\d/.test(l)) ?? doc.slice(0, 80);
+    return `${fname}: ${firstLine.slice(0, 100)}`.slice(0, 140);
+}
+function walkSourceFiles(repoRoot, max = 500) {
+    const out = [];
+    const skip = new Set(["node_modules", ".git", "dist", "build", ".mneme", "coverage"]);
+    const walk = (dir) => {
+        if (out.length >= max)
+            return;
+        let entries = [];
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (skip.has(e))
+                continue;
+            const p = join(dir, e);
+            try {
+                const s = statSync(p);
+                if (s.isDirectory())
+                    walk(p);
+                else if (/\.ts$/.test(e)) {
+                    try {
+                        out.push({ path: p, content: readFileSync(p, "utf8") });
+                    }
+                    catch { /* */ }
+                }
+            }
+            catch { /* */ }
+        }
+    };
+    walk(repoRoot);
+    return out;
+}
+function readCommits(repoRoot, max = 500) {
+    try {
+        const r = execSync(`git -C "${repoRoot}" log --max-count=${max} --pretty=format:%H%x09%s%x09%b%n---COMMIT---`, { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], timeout: 5000 });
+        return r.split(/\n---COMMIT---\n/).map((row) => {
+            const [hash, subject, ...rest] = row.split("\t");
+            if (!hash || !subject)
+                return null;
+            return { hash, subject, body: rest.join("\t") };
+        }).filter((x) => x !== null);
+    }
+    catch {
+        return [];
+    }
+}
+/** Idempotent: generates abstracts for everything not yet covered. */
+export function generateDust(repoRoot, opts) {
+    ensureDir(repoRoot);
+    const existing = readAbstracts(repoRoot);
+    const existingIds = new Set(existing.map((a) => a.id));
+    const newAbstracts = [];
+    const ts = new Date().toISOString();
+    for (const c of readCommits(repoRoot, opts?.maxCommits ?? 500)) {
+        const id = createHash("sha256").update(`commit|${c.hash}`).digest("hex").slice(0, 16);
+        if (existingIds.has(id))
+            continue;
+        const abs = abstractCommit(c.subject, c.body);
+        newAbstracts.push({
+            id,
+            source: { kind: "commit", ref: c.hash },
+            abstract: abs,
+            tokenCount: estTokenCount(abs),
+            generatedAt: ts,
+        });
+    }
+    for (const f of walkSourceFiles(repoRoot, opts?.maxFiles ?? 500)) {
+        const m = f.content.match(/^\s*\/\*\*([\s\S]*?)\*\//);
+        if (!m)
+            continue;
+        const id = createHash("sha256").update(`file|${f.path}`).digest("hex").slice(0, 16);
+        if (existingIds.has(id))
+            continue;
+        const abs = abstractDocstring(f.path, m[1]);
+        newAbstracts.push({
+            id,
+            source: { kind: "file-docstring", ref: f.path.replace(repoRoot, "").replace(/^[/\\]/, "") },
+            abstract: abs,
+            tokenCount: estTokenCount(abs),
+            generatedAt: ts,
+        });
+    }
+    if (newAbstracts.length > 0) {
+        const fs = require("node:fs");
+        fs.appendFileSync(join(repoRoot, ABSTRACTS_FILE), newAbstracts.map((a) => JSON.stringify(a)).join("\n") + "\n", "utf8");
+    }
+    return { added: newAbstracts.length, abstracts: newAbstracts };
+}
+export function readAbstracts(repoRoot) {
+    const p = join(repoRoot, ABSTRACTS_FILE);
+    if (!existsSync(p))
+        return [];
+    const out = [];
+    try {
+        for (const line of readFileSync(p, "utf8").split("\n")) {
+            if (!line.trim())
+                continue;
+            try {
+                out.push(JSON.parse(line));
+            }
+            catch { /* */ }
+        }
+    }
+    catch { /* */ }
+    return out;
+}
+/** Compute coverage = abstracts / (commits + source files). */
+export function computeCoverage(repoRoot) {
+    const commits = readCommits(repoRoot);
+    const files = walkSourceFiles(repoRoot);
+    const abstracts = readAbstracts(repoRoot);
+    const totalCommits = commits.length;
+    const totalFiles = files.filter((f) => /\/\*\*/.test(f.content.slice(0, 200))).length;
+    const denominator = Math.max(1, totalCommits + totalFiles);
+    const coveragePct = (abstracts.length / denominator) * 100;
+    const stats = {
+        totalCommits,
+        totalFiles,
+        abstractsGenerated: abstracts.length,
+        coveragePct,
+        updatedAt: new Date().toISOString(),
+    };
+    try {
+        ensureDir(repoRoot);
+        writeFileSync(join(repoRoot, COVERAGE_FILE), JSON.stringify(stats, null, 2) + "\n", "utf8");
+    }
+    catch { /* */ }
+    return stats;
+}
+/** Auto-cluster abstracts by token overlap. Lightweight; no LLM. */
+export function clusterDust(repoRoot, opts) {
+    const threshold = opts?.jaccardThreshold ?? 0.3;
+    const maxClusters = opts?.maxClusters ?? 50;
+    const abstracts = readAbstracts(repoRoot);
+    const remaining = new Set(abstracts.map((a) => a.id));
+    const idToTokens = new Map();
+    for (const a of abstracts) {
+        idToTokens.set(a.id, new Set((a.abstract.toLowerCase().match(/[a-z][a-z0-9_-]+/g) ?? []).filter((t) => t.length >= 4)));
+    }
+    const clusters = [];
+    for (const seed of abstracts) {
+        if (!remaining.has(seed.id) || clusters.length >= maxClusters)
+            continue;
+        const seedTokens = idToTokens.get(seed.id);
+        const members = [seed.id];
+        remaining.delete(seed.id);
+        for (const other of abstracts) {
+            if (!remaining.has(other.id))
+                continue;
+            const otherTokens = idToTokens.get(other.id);
+            const inter = [...seedTokens].filter((t) => otherTokens.has(t)).length;
+            const union = seedTokens.size + otherTokens.size - inter;
+            const jac = union === 0 ? 0 : inter / union;
+            if (jac >= threshold) {
+                members.push(other.id);
+                remaining.delete(other.id);
+            }
+        }
+        // Cluster label: most-frequent meaningful token across members.
+        const tokenFreq = new Map();
+        for (const id of members) {
+            for (const t of idToTokens.get(id) ?? [])
+                tokenFreq.set(t, (tokenFreq.get(t) ?? 0) + 1);
+        }
+        const label = [...tokenFreq.entries()].sort((a, b) => b[1] - a[1])[0]?.[0] ?? "general";
+        clusters.push({
+            clusterId: `cluster-${clusters.length}`,
+            label,
+            memberIds: members,
+            tokenCount: members.length * 5,
+        });
+    }
+    try {
+        ensureDir(repoRoot);
+        writeFileSync(join(repoRoot, CLUSTERS_FILE), JSON.stringify(clusters, null, 2) + "\n", "utf8");
+    }
+    catch { /* */ }
+    return clusters;
+}
+//# sourceMappingURL=nucleus_dust_htc.js.map

package/dist/hyperscan/nucleus_dust_htc.js.map

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

package/dist/hyperscan/prose_shadow.d.ts

@@ -0,0 +1,50 @@
+/**
+ * v1.69.0 -- HYPERSCAN H1: PROSE SHADOW SCAN.
+ *
+ * Wild idea: the v1.65 antivirus catches claims with syntax markers
+ * (parens, file-extensions, version strings). It MISSES prose like:
+ *
+ *   "wraith-utils-2099 is integrated for caching"   -- fake npm package
+ *   "Sentry catches our errors"                     -- general service name
+ *   "we use Datadog for APM"                        -- general service name
+ *   "RustCrypto's libcrypto powers our hash"        -- fake library claim
+ *
+ * Prose Shadow extracts ENTITY CANDIDATES from any text using three
+ * mixed algorithms (title-case detector + package-shape pattern +
+ * acronym matcher) and verifies each against:
+ *
+ *   1. Local citations    -- does this name appear in package.json,
+ *                            imports, env vars, or source files?
+ *   2. Domain authority   -- is it a known real service? (curated bank)
+ *   3. Negation triggers  -- does the prose attribute behavior to a
+ *                            name that fails grounding?
+ *
+ * Output: list of suspect ENTITIES (not just regex matches) with a
+ * confidence band. This is the missing class the user identified.
+ */
+export interface EntityCandidate {
+    surface: string;
+    kind: "title-cased" | "package-shape" | "acronym" | "domain-suffixed";
+    /** Position in original text. */
+    offset: number;
+}
+export interface ProseSuspect {
+    entity: string;
+    kind: EntityCandidate["kind"];
+    /** Why this entity is suspect (none-of-our-evidence-supports-it / not-in-deps / etc.). */
+    reason: string;
+    /** 0..1; higher = stronger suspicion. */
+    confidence: number;
+    /** Citation hits found (helps caller decide). */
+    citationsFound: string[];
+}
+export interface ProseScanReport {
+    entitiesExtracted: number;
+    suspects: ProseSuspect[];
+    /** Whitelisted "known-real" entities the prose mentions. */
+    recognized: string[];
+    ms: number;
+}
+export declare function extractEntities(text: string): EntityCandidate[];
+export declare function proseScan(repoRoot: string, claim: string): ProseScanReport;
+//# sourceMappingURL=prose_shadow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prose_shadow.d.ts","sourceRoot":"","sources":["../../src/hyperscan/prose_shadow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,GAAG,eAAe,GAAG,SAAS,GAAG,iBAAiB,CAAC;IACtE,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IAC9B,0FAA0F;IAC1F,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;CACZ;AA6CD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CAiB/D;AA4ED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAuC1E"}