@mneme-ai/core 2.62.0 → 2.64.0

package/dist/time_crystal/index.d.ts

@@ -0,0 +1,158 @@
+/**
+ * v2.63.0 — TIME-CRYSTAL: federated agent wisdom.
+ *
+ * User-roadmap (continuing from v2.60-v2.62): conscience + **memory** +
+ * diplomat + bodyguard + time machine. v2.63 ships the **memory**
+ * primitive.
+ *
+ * When agent A encounters problem P (e.g. "Cannot find module
+ * @types/node"), Mneme replies "342 agents saw this same problem in
+ * the last 7 days. 89% used `npm i -D @types/node` (304 trials, Wilson
+ * lower-bound 0.85). 11% tried `delete node_modules` (38 trials, but
+ * 17 failed on pnpm projects)."
+ *
+ * Pre-MIRROR data sources for AI tooling are static (Stack Overflow,
+ * GitHub Issues, docs). TIME-CRYSTAL aggregates **actual AI agent
+ * behavior** — every contribution = a real agent ran a real fix and
+ * got a real outcome. Every agent using Mneme MCP contributes back.
+ *
+ * 5 wild innovations:
+ *
+ *  1. CANONICAL PROBLEM FINGERPRINTING — entity slotting (`<PKG>`,
+ *     `<VER>`, `<PATH>`, `<HASH>`, `<TSERR>`) + stop-word filter +
+ *     token sort + SHA-256 = stable 16-hex cluster key. Two agents
+ *     typing "Cannot find module '@types/node'" and "TypeScript Error
+ *     TS2307: Cannot find module @types/node" cluster to ONE bucket.
+ *
+ *  2. WILSON LOWER-BOUND RANKING — small-sample approaches don't
+ *     dominate. 2/2 success looks great until Wilson LB says 0.20.
+ *     Surfaces statistically credible recommendations.
+ *
+ *  3. RECENCY DECAY — exponential half-life (30 days default).
+ *     Old wisdom may be stale (package versions move, framework
+ *     defaults change). Recent wins weigh more.
+ *
+ *  4. ENVIRONMENT-AWARE GROUNDING — caller passes current env
+ *     (`{ node: "22.13.0", pnpm: "10" }`); ranking boosts approaches
+ *     tested on matching env. Prevents "this works on Yarn but you're
+ *     on pnpm" mismatches.
+ *
+ *  5. GOTCHA AUTO-DETECTION — when an approach has mixed outcomes,
+ *     compute the env-key/value where failure-rate gain ≥ 30%.
+ *     Auto-extracts "X fails on Y" patterns without anyone writing them.
+ *     Plus folds free-text failure notes ("ฟังก์ชั่น break ถ้ามี
+ *     pnpm-lock.yaml").
+ *
+ * Plus HMAC-chained ledger (same convention as PASSPORT + MIRRAGE)
+ * for tamper-evident contribution history; opt-in cross-host gossip
+ * via CONSENT FABRIC (wire pending v2.64+).
+ *
+ * Pure ESM. Defensive — never throws.
+ */
+import { type ApproachGroup, type Outcome } from "./ranking.js";
+import { type Gotcha } from "./gotcha_detector.js";
+export interface ContributionInput {
+    /** Free-text problem description (will be fingerprinted). */
+    problem: string;
+    /** Free-text description of what the agent tried. */
+    approach: string;
+    /** Outcome — success/failure/partial. */
+    outcome: Outcome;
+    /** Reporting agent id (for distinct-contributor count). */
+    agent: string;
+    /** Optional environment map (node, pnpm, framework versions). */
+    env?: Record<string, string>;
+    /** Optional free-text gotcha hint. */
+    note?: string;
+    /** Working directory. */
+    cwd?: string;
+}
+export interface ContributionResult {
+    ok: boolean;
+    recordId: string;
+    problemFingerprint: string;
+    hmac: string;
+    hint: string;
+}
+export interface LookupInput {
+    problem: string;
+    /** Optional env to filter / boost ranking. */
+    env?: Record<string, string>;
+    /** Max approaches to return. */
+    topN?: number;
+    /** Working directory. */
+    cwd?: string;
+    /** Recency half-life override (ms). Default 30 days. */
+    halfLifeMs?: number;
+    /** Reference "now" for deterministic tests. */
+    now?: number;
+}
+export interface LookupResult {
+    problem: string;
+    problemFingerprint: string;
+    totalContributors: number;
+    distinctAgents: number;
+    approaches: ApproachGroup[];
+    gotchas: Gotcha[];
+    /** Similar (but not identical) problem fingerprints with cross-bucket overlap. */
+    related: Array<{
+        fingerprint: string;
+        canonical: string;
+        similarity: number;
+        sampleSize: number;
+    }>;
+    /** Plain-English summary suitable for an agent to read. */
+    summary: string;
+    at: string;
+    hmac: string;
+}
+interface LedgerEntry {
+    kind: "contribution";
+    at: string;
+    recordId: string;
+    agent: string;
+    problemFingerprint: string;
+    canonical: string;
+    approach: string;
+    outcome: Outcome;
+    env?: Record<string, string>;
+    note?: string;
+    prevHmac: string;
+    hmac: string;
+}
+export declare function readLedger(cwd: string): LedgerEntry[];
+export declare function verifyLedgerChain(cwd: string): {
+    ok: boolean;
+    rows: number;
+    brokenAt?: number;
+};
+export declare function contribute(input: ContributionInput): ContributionResult;
+export declare function lookupWisdom(input: LookupInput): LookupResult;
+export declare function verifyLookup(r: LookupResult): boolean;
+export interface ContributorStats {
+    totalContributions: number;
+    distinctAgents: number;
+    distinctProblems: number;
+    /** Top 10 agents by contribution count. */
+    topAgents: Array<{
+        agent: string;
+        count: number;
+    }>;
+    /** Top 10 most-discussed problem fingerprints. */
+    topProblems: Array<{
+        fingerprint: string;
+        canonical: string;
+        count: number;
+    }>;
+    /** Distribution of outcomes. */
+    outcomes: Record<Outcome, number>;
+}
+export declare function contributorStats(cwd: string): ContributorStats;
+export declare function renderLookupBanner(r: LookupResult): string;
+export { normalizeProblem, similarity } from "./problem_fingerprint.js";
+export type { NormalizationResult } from "./problem_fingerprint.js";
+export { rankApproaches, approachKey } from "./ranking.js";
+export type { WisdomRecord, ApproachGroup, RankOpts, Outcome } from "./ranking.js";
+export { detectGotchas } from "./gotcha_detector.js";
+export type { Gotcha } from "./gotcha_detector.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/time_crystal/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAOH,OAAO,EAAqC,KAAK,aAAa,EAAiB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAClH,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAQlE,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kFAAkF;IAClF,OAAO,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnG,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAmBD,UAAU,WAAW;IACnB,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAmBD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CAIrD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAY/F;AAID,wBAAgB,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,CA8BvE;AAID,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAqE7D;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,YAAY,GAAG,OAAO,CAIrD;AAID,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,kDAAkD;IAClD,WAAW,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9E,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAoB9D;AAID,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CA+B1D;AAID,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACxE,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/time_crystal/index.js

@@ -0,0 +1,289 @@
+/**
+ * v2.63.0 — TIME-CRYSTAL: federated agent wisdom.
+ *
+ * User-roadmap (continuing from v2.60-v2.62): conscience + **memory** +
+ * diplomat + bodyguard + time machine. v2.63 ships the **memory**
+ * primitive.
+ *
+ * When agent A encounters problem P (e.g. "Cannot find module
+ * @types/node"), Mneme replies "342 agents saw this same problem in
+ * the last 7 days. 89% used `npm i -D @types/node` (304 trials, Wilson
+ * lower-bound 0.85). 11% tried `delete node_modules` (38 trials, but
+ * 17 failed on pnpm projects)."
+ *
+ * Pre-MIRROR data sources for AI tooling are static (Stack Overflow,
+ * GitHub Issues, docs). TIME-CRYSTAL aggregates **actual AI agent
+ * behavior** — every contribution = a real agent ran a real fix and
+ * got a real outcome. Every agent using Mneme MCP contributes back.
+ *
+ * 5 wild innovations:
+ *
+ *  1. CANONICAL PROBLEM FINGERPRINTING — entity slotting (`<PKG>`,
+ *     `<VER>`, `<PATH>`, `<HASH>`, `<TSERR>`) + stop-word filter +
+ *     token sort + SHA-256 = stable 16-hex cluster key. Two agents
+ *     typing "Cannot find module '@types/node'" and "TypeScript Error
+ *     TS2307: Cannot find module @types/node" cluster to ONE bucket.
+ *
+ *  2. WILSON LOWER-BOUND RANKING — small-sample approaches don't
+ *     dominate. 2/2 success looks great until Wilson LB says 0.20.
+ *     Surfaces statistically credible recommendations.
+ *
+ *  3. RECENCY DECAY — exponential half-life (30 days default).
+ *     Old wisdom may be stale (package versions move, framework
+ *     defaults change). Recent wins weigh more.
+ *
+ *  4. ENVIRONMENT-AWARE GROUNDING — caller passes current env
+ *     (`{ node: "22.13.0", pnpm: "10" }`); ranking boosts approaches
+ *     tested on matching env. Prevents "this works on Yarn but you're
+ *     on pnpm" mismatches.
+ *
+ *  5. GOTCHA AUTO-DETECTION — when an approach has mixed outcomes,
+ *     compute the env-key/value where failure-rate gain ≥ 30%.
+ *     Auto-extracts "X fails on Y" patterns without anyone writing them.
+ *     Plus folds free-text failure notes ("ฟังก์ชั่น break ถ้ามี
+ *     pnpm-lock.yaml").
+ *
+ * Plus HMAC-chained ledger (same convention as PASSPORT + MIRRAGE)
+ * for tamper-evident contribution history; opt-in cross-host gossip
+ * via CONSENT FABRIC (wire pending v2.64+).
+ *
+ * Pure ESM. Defensive — never throws.
+ */
+import { createHmac, randomBytes } from "node:crypto";
+import { appendFileSync, mkdirSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { normalizeProblem, similarity } from "./problem_fingerprint.js";
+import { rankApproaches } from "./ranking.js";
+import { detectGotchas } from "./gotcha_detector.js";
+const KEY_ENV = "MNEME_TIME_CRYSTAL_KEY";
+const DEFAULT_KEY = "mneme-time-crystal-v1";
+function keyOf() { return process.env[KEY_ENV] ?? DEFAULT_KEY; }
+/* ── Canonical JSON HMAC ────────────────────────────────────────── */
+function canonicalJson(o) {
+    if (o === undefined)
+        return "null";
+    if (o === null || typeof o !== "object")
+        return JSON.stringify(o);
+    if (Array.isArray(o))
+        return "[" + o.map((x) => canonicalJson(x === undefined ? null : x)).join(",") + "]";
+    const entries = Object.entries(o).filter(([, v]) => v !== undefined);
+    entries.sort(([a], [b]) => a.localeCompare(b));
+    return "{" + entries.map(([k, v]) => JSON.stringify(k) + ":" + canonicalJson(v)).join(",") + "}";
+}
+function signHmac(body) {
+    return createHmac("sha256", keyOf()).update(canonicalJson(body)).digest("hex");
+}
+function ledgerPath(cwd) {
+    return join(cwd, ".mneme", "time_crystal", "wisdom.jsonl");
+}
+function readLedgerLines(cwd) {
+    try {
+        return readFileSync(ledgerPath(cwd), "utf8").trim().split(/\n/).filter((l) => l.trim().length > 0);
+    }
+    catch {
+        return [];
+    }
+}
+function lastLedgerHmac(cwd) {
+    const lines = readLedgerLines(cwd);
+    if (lines.length === 0)
+        return "";
+    try {
+        return JSON.parse(lines[lines.length - 1]).hmac;
+    }
+    catch {
+        return "";
+    }
+}
+export function readLedger(cwd) {
+    return readLedgerLines(cwd).map((l) => {
+        try {
+            return JSON.parse(l);
+        }
+        catch {
+            return null;
+        }
+    }).filter((x) => x !== null);
+}
+export function verifyLedgerChain(cwd) {
+    const lines = readLedger(cwd);
+    let prevHmac = "";
+    for (let i = 0; i < lines.length; i++) {
+        const row = lines[i];
+        if (row.prevHmac !== prevHmac)
+            return { ok: false, rows: i, brokenAt: i };
+        const { hmac, ...body } = row;
+        const expected = createHmac("sha256", keyOf()).update(prevHmac).update(canonicalJson(body)).digest("hex");
+        if (expected !== hmac)
+            return { ok: false, rows: i, brokenAt: i };
+        prevHmac = hmac;
+    }
+    return { ok: true, rows: lines.length };
+}
+/* ── Contribute ─────────────────────────────────────────────────── */
+export function contribute(input) {
+    const cwd = input.cwd ?? process.cwd();
+    const norm = normalizeProblem(input.problem);
+    const recordId = randomBytes(8).toString("hex");
+    const at = new Date().toISOString();
+    const prevHmac = lastLedgerHmac(cwd);
+    const body = {
+        kind: "contribution",
+        at, recordId, agent: input.agent,
+        problemFingerprint: norm.fingerprint,
+        canonical: norm.canonical,
+        approach: input.approach,
+        outcome: input.outcome,
+        env: input.env,
+        note: input.note,
+        prevHmac,
+    };
+    const hmac = createHmac("sha256", keyOf()).update(prevHmac).update(canonicalJson(body)).digest("hex");
+    const entry = { ...body, hmac };
+    try {
+        mkdirSync(dirname(ledgerPath(cwd)), { recursive: true });
+        appendFileSync(ledgerPath(cwd), JSON.stringify(entry) + "\n");
+    }
+    catch { /* noop */ }
+    return {
+        ok: true,
+        recordId,
+        problemFingerprint: norm.fingerprint,
+        hmac,
+        hint: `contributed: agent=${input.agent} outcome=${input.outcome} fingerprint=${norm.fingerprint}`,
+    };
+}
+/* ── Lookup ─────────────────────────────────────────────────────── */
+export function lookupWisdom(input) {
+    const cwd = input.cwd ?? process.cwd();
+    const norm = normalizeProblem(input.problem);
+    const all = readLedger(cwd);
+    const exact = all.filter((e) => e.problemFingerprint === norm.fingerprint);
+    // Build records for ranking.
+    const records = exact.map((e) => ({
+        approach: e.approach,
+        outcome: e.outcome,
+        at: e.at,
+        env: e.env,
+        note: e.note,
+    }));
+    const approaches = rankApproaches(records, {
+        env: input.env,
+        halfLifeMs: input.halfLifeMs,
+        now: input.now,
+    }).slice(0, input.topN ?? 5);
+    const gotchas = detectGotchas(records);
+    // Related: distinct fingerprints with >0.30 token-set similarity.
+    const byFingerprint = new Map();
+    for (const e of all) {
+        if (e.problemFingerprint === norm.fingerprint)
+            continue;
+        const list = byFingerprint.get(e.problemFingerprint) ?? [];
+        list.push(e);
+        byFingerprint.set(e.problemFingerprint, list);
+    }
+    const related = [];
+    for (const [fp, list] of byFingerprint) {
+        const sim = similarity(norm.canonical, list[0].canonical);
+        if (sim >= 0.30) {
+            related.push({ fingerprint: fp, canonical: list[0].canonical, similarity: +sim.toFixed(3), sampleSize: list.length });
+        }
+    }
+    related.sort((a, b) => b.similarity - a.similarity);
+    const distinctAgents = new Set(exact.map((e) => e.agent)).size;
+    const at = new Date().toISOString();
+    // Plain-English summary suitable for the agent to read inline.
+    const summaryLines = [];
+    if (exact.length === 0) {
+        summaryLines.push(`No prior wisdom on this exact problem fingerprint (${norm.fingerprint}).`);
+        if (related.length > 0)
+            summaryLines.push(`But ${related.length} similar bucket(s) exist — top: "${related[0].canonical.slice(0, 80)}".`);
+    }
+    else {
+        summaryLines.push(`${exact.length} contribution(s) from ${distinctAgents} distinct agent(s) on this problem.`);
+        for (const a of approaches.slice(0, 3)) {
+            const pct = (a.successRate * 100).toFixed(0);
+            const lb = (a.wilsonLB * 100).toFixed(0);
+            summaryLines.push(`  • ${a.approach}: ${pct}% success (n=${a.sampleSize}, Wilson-LB ${lb}%)`);
+        }
+        if (gotchas.length > 0) {
+            summaryLines.push(`gotchas: ${gotchas.slice(0, 2).map((g) => g.approach + (g.triggerConditions.length > 0 ? ` (fails on ${g.triggerConditions[0].key}=${g.triggerConditions[0].value})` : "")).join("; ")}`);
+        }
+    }
+    const summary = summaryLines.join("\n");
+    const bodyForHmac = {
+        problem: input.problem,
+        problemFingerprint: norm.fingerprint,
+        totalContributors: exact.length,
+        distinctAgents,
+        approaches, gotchas, related, summary, at,
+    };
+    const hmac = signHmac(bodyForHmac);
+    return { ...bodyForHmac, hmac };
+}
+export function verifyLookup(r) {
+    if (!r || typeof r.hmac !== "string")
+        return false;
+    const { hmac, ...body } = r;
+    return signHmac(body) === hmac;
+}
+export function contributorStats(cwd) {
+    const rows = readLedger(cwd);
+    const agentCount = new Map();
+    const problemCount = new Map();
+    const outcomes = { success: 0, failure: 0, partial: 0 };
+    for (const r of rows) {
+        agentCount.set(r.agent, (agentCount.get(r.agent) ?? 0) + 1);
+        const p = problemCount.get(r.problemFingerprint) ?? { canonical: r.canonical, count: 0 };
+        p.count++;
+        problemCount.set(r.problemFingerprint, p);
+        outcomes[r.outcome]++;
+    }
+    return {
+        totalContributions: rows.length,
+        distinctAgents: agentCount.size,
+        distinctProblems: problemCount.size,
+        topAgents: Array.from(agentCount.entries()).sort((a, b) => b[1] - a[1]).slice(0, 10).map(([agent, count]) => ({ agent, count })),
+        topProblems: Array.from(problemCount.entries()).sort((a, b) => b[1].count - a[1].count).slice(0, 10).map(([fingerprint, { canonical, count }]) => ({ fingerprint, canonical, count })),
+        outcomes,
+    };
+}
+/* ── Render ─────────────────────────────────────────────────────── */
+export function renderLookupBanner(r) {
+    const lines = [
+        `🌌 TIME-CRYSTAL · fingerprint ${r.problemFingerprint}`,
+        `   ${r.totalContributors} contribution(s) · ${r.distinctAgents} distinct agent(s)`,
+        "",
+    ];
+    for (const a of r.approaches) {
+        const pct = (a.successRate * 100).toFixed(0);
+        const lb = (a.wilsonLB * 100).toFixed(0);
+        lines.push(`   ★ rank=${a.rankScore.toFixed(3)}  ${pct}% success  Wilson-LB ${lb}%  n=${a.sampleSize}`);
+        lines.push(`      ${a.approach}`);
+        if (a.notes.length > 0)
+            lines.push(`      note: ${a.notes[0]}`);
+    }
+    if (r.gotchas.length > 0) {
+        lines.push("");
+        lines.push(`   GOTCHAS (${r.gotchas.length}):`);
+        for (const g of r.gotchas.slice(0, 3)) {
+            const cond = g.triggerConditions.length > 0
+                ? `fails on ${g.triggerConditions.map((t) => `${t.key}=${t.value}`).join(", ")}`
+                : g.notes.join("; ");
+            lines.push(`     ⚠ ${g.approach} — ${cond} (severity ${(g.severity * 100).toFixed(0)}%)`);
+        }
+    }
+    if (r.related.length > 0) {
+        lines.push("");
+        lines.push(`   RELATED (${r.related.length}):`);
+        for (const rel of r.related.slice(0, 3)) {
+            lines.push(`     ~ ${(rel.similarity * 100).toFixed(0)}% match  ${rel.canonical.slice(0, 80)}  (n=${rel.sampleSize})`);
+        }
+    }
+    return lines.join("\n");
+}
+/* ── Re-exports ─────────────────────────────────────────────────── */
+export { normalizeProblem, similarity } from "./problem_fingerprint.js";
+export { rankApproaches, approachKey } from "./ranking.js";
+export { detectGotchas } from "./gotcha_detector.js";
+//# sourceMappingURL=index.js.map

package/dist/time_crystal/index.js.map

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

package/dist/time_crystal/problem_fingerprint.d.ts

@@ -0,0 +1,43 @@
+/**
+ * v2.63.0 — TIME-CRYSTAL problem fingerprinting.
+ *
+ * Two agents hitting the same problem will type it slightly differently:
+ *   "Cannot find module '@types/node'"
+ *   "TypeScript Error TS2307: Cannot find module @types/node"
+ *   "error: cannot find module @types/node when building"
+ *
+ * All three should cluster to ONE wisdom bucket. The fingerprint is a
+ * canonical hash of the SHAPE of the problem after normalization.
+ *
+ * Pipeline:
+ *  1. Lowercase
+ *  2. Strip stack-trace prefixes (file:line:col, "at Function.foo (path)")
+ *  3. Normalize entities to slot tokens:
+ *      "@types/node"     → "<PKG>"
+ *      "5.6.3"           → "<VER>"
+ *      "src/file.ts"     → "<PATH>"
+ *      "2026-05-26"      → "<DATE>"
+ *      "abc1234"         → "<HASH>"
+ *      numbers 3+ digits → "<N>"
+ *  4. Strip filler / TypeScript error codes (TS2307 etc.)
+ *  5. Tokenize, remove common stop-words, sort, join
+ *  6. SHA-256 → 16 hex char fingerprint
+ *
+ * The slot tokens are KEPT in the fingerprint (just normalized) so
+ * "Cannot find module @types/node" and "Cannot find module foo" share
+ * structure but NOT specifically — they collapse to the same shape.
+ *
+ * Pure deterministic.
+ */
+export interface NormalizationResult {
+    /** Canonical text after entity slotting + stop-word removal. */
+    canonical: string;
+    /** Stable 16-hex fingerprint hash. */
+    fingerprint: string;
+    /** Slot counts (informational). */
+    slots: Record<string, number>;
+}
+export declare function normalizeProblem(text: string): NormalizationResult;
+/** Jaccard similarity between two canonical-tokens sets. */
+export declare function similarity(a: string, b: string): number;
+//# sourceMappingURL=problem_fingerprint.d.ts.map

package/dist/time_crystal/problem_fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"problem_fingerprint.d.ts","sourceRoot":"","sources":["../../src/time_crystal/problem_fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AA2BH,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAkClE;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQvD"}

package/dist/time_crystal/problem_fingerprint.js

@@ -0,0 +1,101 @@
+/**
+ * v2.63.0 — TIME-CRYSTAL problem fingerprinting.
+ *
+ * Two agents hitting the same problem will type it slightly differently:
+ *   "Cannot find module '@types/node'"
+ *   "TypeScript Error TS2307: Cannot find module @types/node"
+ *   "error: cannot find module @types/node when building"
+ *
+ * All three should cluster to ONE wisdom bucket. The fingerprint is a
+ * canonical hash of the SHAPE of the problem after normalization.
+ *
+ * Pipeline:
+ *  1. Lowercase
+ *  2. Strip stack-trace prefixes (file:line:col, "at Function.foo (path)")
+ *  3. Normalize entities to slot tokens:
+ *      "@types/node"     → "<PKG>"
+ *      "5.6.3"           → "<VER>"
+ *      "src/file.ts"     → "<PATH>"
+ *      "2026-05-26"      → "<DATE>"
+ *      "abc1234"         → "<HASH>"
+ *      numbers 3+ digits → "<N>"
+ *  4. Strip filler / TypeScript error codes (TS2307 etc.)
+ *  5. Tokenize, remove common stop-words, sort, join
+ *  6. SHA-256 → 16 hex char fingerprint
+ *
+ * The slot tokens are KEPT in the fingerprint (just normalized) so
+ * "Cannot find module @types/node" and "Cannot find module foo" share
+ * structure but NOT specifically — they collapse to the same shape.
+ *
+ * Pure deterministic.
+ */
+import { createHash } from "node:crypto";
+const STOP_WORDS = new Set([
+    "a", "an", "the", "and", "or", "but", "of", "to", "in", "on", "at", "by",
+    "for", "with", "from", "is", "was", "are", "were", "be", "been", "being",
+    "do", "does", "did", "doing", "have", "has", "had", "having", "will",
+    "would", "should", "could", "may", "might", "must", "this", "that",
+    "these", "those", "it", "its", "as", "if", "then", "than", "so", "such",
+    "very", "just", "only", "also", "again", "ever", "still", "yet",
+    "error", "warning", "exception", "failure", "problem", "issue",
+]);
+const TS_ERROR_CODE = /\bTS\d{4,5}\b/g;
+const STACK_LINE = /^\s*at\s.+(\(.+\))?$/gm;
+const FILE_LINE_COL = /\b[A-Za-z_][A-Za-z0-9_./\\-]*:\d+(:\d+)?\b/g;
+const PKG_SCOPED = /@[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._-]*/gi;
+const PKG_BARE = /\b[a-z][a-z0-9_-]*(?:-[a-z0-9_-]+){0,3}\b(?=@\d)/gi; // pkg before @version
+const SEMVER = /\bv?\d+\.\d+(?:\.\d+)?(?:-[a-z0-9.]+)?(?:\+[a-z0-9.]+)?\b/gi;
+const PATH_RX = /\b[A-Za-z_][A-Za-z0-9_/\\.-]*\.(?:ts|tsx|js|jsx|cjs|mjs|py|rs|go|java|kt|swift|md|json|yaml|yml|toml|sh|sql|html|css|tex)\b/g;
+const ISO_DATE = /\b\d{4}-\d{2}-\d{2}(?:T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z?)?\b/g;
+const SHA_HASH = /\b[a-f0-9]{7,40}\b/g;
+const URL_RX = /https?:\/\/\S+/g;
+const BIG_NUM = /\b\d{3,}(?:,\d{3})*\b/g;
+const QUOTES = /[`'"]/g;
+export function normalizeProblem(text) {
+    if (typeof text !== "string" || text.length === 0) {
+        return { canonical: "", fingerprint: "0".repeat(16), slots: {} };
+    }
+    let s = text.toLowerCase();
+    // Strip stack-trace + file:line:col patterns first.
+    s = s.replace(STACK_LINE, " ");
+    s = s.replace(URL_RX, " <URL> ");
+    s = s.replace(ISO_DATE, " <DATE> ");
+    // Order matters: scoped packages BEFORE bare-pkg-before-version BEFORE semver.
+    s = s.replace(PKG_SCOPED, " <PKG> ");
+    s = s.replace(SEMVER, " <VER> ");
+    s = s.replace(PATH_RX, " <PATH> ");
+    s = s.replace(SHA_HASH, " <HASH> ");
+    s = s.replace(FILE_LINE_COL, " <LOC> ");
+    s = s.replace(TS_ERROR_CODE, " <TSERR> ");
+    s = s.replace(BIG_NUM, " <N> ");
+    s = s.replace(QUOTES, " ");
+    // Tokenize on non-word boundaries (but keep angle brackets for slots).
+    const tokens = s.split(/[^a-z0-9_<>]+/i).map((t) => t.trim()).filter((t) => t.length > 0);
+    const filtered = tokens.filter((t) => !STOP_WORDS.has(t) && t.length >= 2);
+    // Sort for canonical form so order doesn't matter.
+    filtered.sort();
+    const canonical = filtered.join(" ");
+    // Slot counts.
+    const slots = {};
+    for (const t of filtered) {
+        if (/^<.+>$/.test(t))
+            slots[t] = (slots[t] ?? 0) + 1;
+    }
+    const fingerprint = createHash("sha256").update(canonical).digest("hex").slice(0, 16);
+    return { canonical, fingerprint, slots };
+}
+/** Jaccard similarity between two canonical-tokens sets. */
+export function similarity(a, b) {
+    if (!a || !b)
+        return 0;
+    const sa = new Set(a.split(/\s+/).filter(Boolean));
+    const sb = new Set(b.split(/\s+/).filter(Boolean));
+    if (sa.size === 0 || sb.size === 0)
+        return 0;
+    let intersect = 0;
+    for (const t of sa)
+        if (sb.has(t))
+            intersect++;
+    return intersect / (sa.size + sb.size - intersect);
+}
+//# sourceMappingURL=problem_fingerprint.js.map

package/dist/time_crystal/problem_fingerprint.js.map

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