@mneme-ai/core 1.65.0 → 1.66.0

package/dist/autarchy/mesh_as_cloud.js

@@ -0,0 +1,115 @@
+/**
+ * v1.66.0 -- AUTARCHY A1: MESH-AS-CLOUD.
+ *
+ * Wild idea: the cloud doesn't have to be central. When brain.mneme.dev
+ * is unreachable (e.g. the user destroyed their droplet), the FEDERATION
+ * MESH acts as the cloud surrogate. Mneme reports "cloud=online via
+ * N mesh peers" instead of "cloud=offline brain.mneme.dev unreachable".
+ *
+ * Sources of peer state (read-only):
+ *   .mneme/mesh-seen.jsonl          peers who've shipped us packets
+ *   .mneme/wisdom-inheritance.jsonl peers who've fed us wisdom packs
+ *   .mneme/whisper/inbox.jsonl      peers who've sent signed whispers
+ *
+ * Aggregates unique peer ids; treats >=1 reachable peer in the last
+ * 24h as "mesh-cloud online". The classic central-cloud probe still
+ * runs for compat; this layer adds a parallel surrogate.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+function readJsonl(path) {
+    if (!existsSync(path))
+        return [];
+    try {
+        return readFileSync(path, "utf8")
+            .split("\n").filter(Boolean)
+            .map((l) => { try {
+            return JSON.parse(l);
+        }
+        catch {
+            return null;
+        } })
+            .filter((x) => x !== null);
+    }
+    catch {
+        return [];
+    }
+}
+function readJsonlDir(dir) {
+    if (!existsSync(dir))
+        return [];
+    const out = [];
+    let entries = [];
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    for (const e of entries) {
+        const p = join(dir, e);
+        try {
+            const s = statSync(p);
+            if (s.isFile() && e.endsWith(".jsonl"))
+                out.push(...readJsonl(p));
+        }
+        catch { /* */ }
+    }
+    return out;
+}
+function isoToMs(s) {
+    if (typeof s !== "string")
+        return null;
+    const t = Date.parse(s);
+    return Number.isFinite(t) ? t : null;
+}
+export function meshCloudReport(repoRoot, opts) {
+    const lookbackHours = opts?.lookbackHours ?? 24;
+    const cutoffMs = Date.now() - lookbackHours * 3600 * 1000;
+    const mesh = readJsonl(join(repoRoot, ".mneme/mesh-seen.jsonl"));
+    const wisdom = readJsonl(join(repoRoot, ".mneme/wisdom-inheritance.jsonl"));
+    const whisper = readJsonlDir(join(repoRoot, ".mneme/whisper"));
+    const peers = new Set();
+    const sources = { meshGossip: 0, wisdomImports: 0, whisperInbox: 0 };
+    let lastPeerMs = -1;
+    const consume = (rows, label) => {
+        for (const r of rows) {
+            const id = (r["peer"] ?? r["from"] ?? r["instanceId"] ?? r["sender"]);
+            const tsRaw = r["ts"] ?? r["at"] ?? r["seenAt"] ?? r["observedAt"];
+            const tsMs = isoToMs(tsRaw);
+            if (typeof id !== "string" || !id)
+                continue;
+            if (tsMs !== null && tsMs < cutoffMs)
+                continue;
+            peers.add(id);
+            sources[label] += 1;
+            if (tsMs !== null && tsMs > lastPeerMs)
+                lastPeerMs = tsMs;
+        }
+    };
+    consume(mesh, "meshGossip");
+    consume(wisdom, "wisdomImports");
+    consume(whisper, "whisperInbox");
+    let state;
+    if (opts?.centralOnline)
+        state = "central-online";
+    else if (peers.size > 0)
+        state = "mesh-only";
+    else
+        state = "isolated";
+    const lastPeerSeen = lastPeerMs > 0 ? new Date(lastPeerMs).toISOString() : null;
+    const headline = state === "central-online"
+        ? `Cloud online (central brain.mneme.dev + ${peers.size} mesh peer(s) in last ${lookbackHours}h).`
+        : state === "mesh-only"
+            ? `Cloud online via mesh-as-cloud (${peers.size} peer(s) in last ${lookbackHours}h; central brain offline).`
+            : `Cloud isolated (no central + no mesh peers in last ${lookbackHours}h). Autarchy mode -- local-only.`;
+    return {
+        state,
+        uniquePeers: peers.size,
+        lastPeerSeen,
+        lookbackHours,
+        sources,
+        headline,
+    };
+}
+//# sourceMappingURL=mesh_as_cloud.js.map

package/dist/autarchy/mesh_as_cloud.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh_as_cloud.js","sourceRoot":"","sources":["../../src/autarchy/mesh_as_cloud.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAsBjC,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC;aAC9B,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;aAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC;YAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAA4B,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC,CAAC,CAAC,CAAC;aAC/F,MAAM,CAAC,CAAC,CAAC,EAAgC,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC;IAAC,CAAC;AACxB,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,GAAG,GAAmC,EAAE,CAAC;IAC/C,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC;QAAC,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC;IAAC,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,CAAC;QAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,OAAO,CAAC,CAAU;IACzB,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACxB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,IAA0D;IAC1G,MAAM,aAAa,GAAG,IAAI,EAAE,aAAa,IAAI,EAAE,CAAC;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,GAAG,IAAI,GAAG,IAAI,CAAC;IAE1D,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,wBAAwB,CAAC,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,iCAAiC,CAAC,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAE/D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,OAAO,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IACrE,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC;IAEpB,MAAM,OAAO,GAAG,CAAC,IAAoC,EAAE,KAA2B,EAAE,EAAE;QACpF,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAuB,CAAC;YAC5F,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC;YACnE,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5B,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,EAAE;gBAAE,SAAS;YAC5C,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,GAAG,QAAQ;gBAAE,SAAS;YAC/C,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACpB,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,GAAG,UAAU;gBAAE,UAAU,GAAG,IAAI,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC;IACF,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC5B,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACjC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAEjC,IAAI,KAAqB,CAAC;IAC1B,IAAI,IAAI,EAAE,aAAa;QAAE,KAAK,GAAG,gBAAgB,CAAC;SAC7C,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC;QAAE,KAAK,GAAG,WAAW,CAAC;;QACxC,KAAK,GAAG,UAAU,CAAC;IAExB,MAAM,YAAY,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAChF,MAAM,QAAQ,GACZ,KAAK,KAAK,gBAAgB;QACxB,CAAC,CAAC,2CAA2C,KAAK,CAAC,IAAI,yBAAyB,aAAa,KAAK;QAClG,CAAC,CAAC,KAAK,KAAK,WAAW;YACrB,CAAC,CAAC,mCAAmC,KAAK,CAAC,IAAI,oBAAoB,aAAa,4BAA4B;YAC5G,CAAC,CAAC,sDAAsD,aAAa,kCAAkC,CAAC;IAE9G,OAAO;QACL,KAAK;QACL,WAAW,EAAE,KAAK,CAAC,IAAI;QACvB,YAAY;QACZ,aAAa;QACb,OAAO;QACP,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/autarchy/schroedinger_embedder.d.ts

@@ -0,0 +1,54 @@
+/**
+ * v1.66.0 -- AUTARCHY A2: SCHROEDINGER EMBEDDER.
+ *
+ * Wild idea: don't pick ONE embedder at config time. Probe all four
+ * tiers concurrently at startup, write the AUTHORITATIVE winner to
+ * `.mneme/embedder-status.json`, and let the pulse + every other
+ * consumer read from THAT instead of guessing at runtime.
+ *
+ * This kills the "phantom WASM fallback" report once and for all:
+ * if WASM verified successfully, the status file says so -- no
+ * stale pulse text can override observed truth.
+ *
+ * Status file format:
+ *   {
+ *     ts: ISO,
+ *     winner: "openai"|"ollama"|"bundled"|"hash",
+ *     allTiers: [{ tier, available, verifyMs, reason? }, ...],
+ *     stableSince: ISO,
+ *     winnerChangedAt: ISO|null,
+ *   }
+ *
+ * Re-probed once per session via cooldownMs. Sub-second on warm path.
+ */
+import { type MemoryTierName } from "../memory_tier.js";
+export interface TierProbeResult {
+    tier: MemoryTierName;
+    available: boolean;
+    verifyMs: number;
+    reason?: string;
+}
+export interface EmbedderStatus {
+    ts: string;
+    winner: MemoryTierName;
+    allTiers: TierProbeResult[];
+    stableSince: string;
+    winnerChangedAt: string | null;
+    /** Plain-English. */
+    headline: string;
+}
+export interface ProbeOptions {
+    /** Re-probe even if a recent status exists. Default false. */
+    force?: boolean;
+    /** Skip Ollama probe (e.g. CI). */
+    skipOllama?: boolean;
+    /** Skip Bundled probe. */
+    skipBundled?: boolean;
+    /** Reprobe cooldown ms; if last probe is younger, reuse cached. */
+    cooldownMs?: number;
+}
+/** Run the parallel race. Always writes `.mneme/embedder-status.json`. */
+export declare function observeEmbedders(repoRoot: string, opts?: ProbeOptions): Promise<EmbedderStatus>;
+/** Read the persisted authoritative status. Returns null if not probed yet. */
+export declare function readEmbedderStatus(repoRoot: string): EmbedderStatus | null;
+//# sourceMappingURL=schroedinger_embedder.d.ts.map

package/dist/autarchy/schroedinger_embedder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schroedinger_embedder.d.ts","sourceRoot":"","sources":["../../src/autarchy/schroedinger_embedder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,OAAO,EAAkC,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOxF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAsDD,MAAM,WAAW,YAAY;IAC3B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mCAAmC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,0EAA0E;AAC1E,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CA2BrG;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAE1E"}

package/dist/autarchy/schroedinger_embedder.js

@@ -0,0 +1,122 @@
+/**
+ * v1.66.0 -- AUTARCHY A2: SCHROEDINGER EMBEDDER.
+ *
+ * Wild idea: don't pick ONE embedder at config time. Probe all four
+ * tiers concurrently at startup, write the AUTHORITATIVE winner to
+ * `.mneme/embedder-status.json`, and let the pulse + every other
+ * consumer read from THAT instead of guessing at runtime.
+ *
+ * This kills the "phantom WASM fallback" report once and for all:
+ * if WASM verified successfully, the status file says so -- no
+ * stale pulse text can override observed truth.
+ *
+ * Status file format:
+ *   {
+ *     ts: ISO,
+ *     winner: "openai"|"ollama"|"bundled"|"hash",
+ *     allTiers: [{ tier, available, verifyMs, reason? }, ...],
+ *     stableSince: ISO,
+ *     winnerChangedAt: ISO|null,
+ *   }
+ *
+ * Re-probed once per session via cooldownMs. Sub-second on warm path.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { request } from "node:http";
+import { tierInfo } from "../memory_tier.js";
+const STATUS_FILE = ".mneme/embedder-status.json";
+const TIER_RANK = {
+    openai: 4, ollama: 3, bundled: 2, hash: 1, unknown: 0,
+};
+function probeOpenAI() {
+    const t0 = Date.now();
+    const ok = typeof process.env["OPENAI_API_KEY"] === "string" && process.env["OPENAI_API_KEY"].length >= 10;
+    return { tier: "openai", available: ok, verifyMs: Date.now() - t0, reason: ok ? undefined : "OPENAI_API_KEY not set" };
+}
+function probeOllama(timeoutMs = 500) {
+    return new Promise((resolve) => {
+        const t0 = Date.now();
+        const req = request({ host: "127.0.0.1", port: 11434, path: "/api/tags", method: "GET", timeout: timeoutMs }, (res) => {
+            res.resume();
+            resolve({ tier: "ollama", available: (res.statusCode ?? 0) < 500, verifyMs: Date.now() - t0 });
+        });
+        req.on("timeout", () => { req.destroy(); resolve({ tier: "ollama", available: false, verifyMs: Date.now() - t0, reason: "timeout" }); });
+        req.on("error", (e) => resolve({ tier: "ollama", available: false, verifyMs: Date.now() - t0, reason: e.message }));
+        req.end();
+    });
+}
+async function probeBundled() {
+    const t0 = Date.now();
+    try {
+        await import("@huggingface/transformers");
+        return { tier: "bundled", available: true, verifyMs: Date.now() - t0 };
+    }
+    catch (e) {
+        return { tier: "bundled", available: false, verifyMs: Date.now() - t0, reason: e.message };
+    }
+}
+function pickWinner(probes) {
+    let best = "hash";
+    let bestRank = TIER_RANK.hash;
+    for (const p of probes) {
+        if (!p.available)
+            continue;
+        const r = TIER_RANK[p.tier];
+        if (r > bestRank) {
+            best = p.tier;
+            bestRank = r;
+        }
+    }
+    return best;
+}
+function readPrior(repoRoot) {
+    const p = join(repoRoot, STATUS_FILE);
+    if (!existsSync(p))
+        return null;
+    try {
+        return JSON.parse(readFileSync(p, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+function persist(repoRoot, status) {
+    const dir = join(repoRoot, ".mneme");
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, "embedder-status.json"), JSON.stringify(status, null, 2) + "\n", "utf8");
+}
+/** Run the parallel race. Always writes `.mneme/embedder-status.json`. */
+export async function observeEmbedders(repoRoot, opts) {
+    const cooldownMs = opts?.cooldownMs ?? 60_000;
+    const prior = readPrior(repoRoot);
+    if (!opts?.force && prior) {
+        const age = Date.now() - Date.parse(prior.ts);
+        if (Number.isFinite(age) && age < cooldownMs)
+            return prior;
+    }
+    // Parallel race -- all probes fire at once.
+    const promises = [];
+    promises.push(Promise.resolve(probeOpenAI()));
+    if (!opts?.skipOllama)
+        promises.push(probeOllama());
+    if (!opts?.skipBundled)
+        promises.push(probeBundled());
+    promises.push(Promise.resolve({ tier: "hash", available: true, verifyMs: 0 }));
+    const allTiers = await Promise.all(promises);
+    const winner = pickWinner(allTiers);
+    const ts = new Date().toISOString();
+    const winnerChangedAt = prior && prior.winner !== winner ? ts : prior?.winnerChangedAt ?? null;
+    const stableSince = prior && prior.winner === winner ? prior.stableSince : ts;
+    const tierBadge = `${tierInfo(winner).display} ★${tierInfo(winner).stars}`;
+    const headline = `Schroedinger collapse: ${tierBadge}. Probed ${allTiers.length} tiers in parallel; ${allTiers.filter((t) => t.available).length} available.`;
+    const status = { ts, winner, allTiers, stableSince, winnerChangedAt, headline };
+    persist(repoRoot, status);
+    return status;
+}
+/** Read the persisted authoritative status. Returns null if not probed yet. */
+export function readEmbedderStatus(repoRoot) {
+    return readPrior(repoRoot);
+}
+//# sourceMappingURL=schroedinger_embedder.js.map

package/dist/autarchy/schroedinger_embedder.js.map

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

package/dist/embedder_autodiagnose.d.ts

@@ -0,0 +1,64 @@
+/**
+ * v1.65.1 -- EMBEDDER AUTODIAGNOSE.
+ *
+ * Detects the GAP between the highest tier actually available on the
+ * machine and the tier the user's config selected. If the user is
+ * sitting on hash tier (★★) while bundled WASM or Ollama is reachable,
+ * the autodiagnose flags it AND offers a one-call upgrade.
+ *
+ * Probe priority (best -> worst):
+ *   1. openai  -- env OPENAI_API_KEY set
+ *   2. ollama  -- 127.0.0.1:11434 reachable
+ *   3. bundled -- @huggingface/transformers importable + cache writable
+ *   4. hash    -- always available
+ *
+ * Pure-read by default; persist=true rewrites .mneme/config.json so
+ * the next session picks the upgraded provider.
+ *
+ * No actual embed calls are made -- probe is cheap (<200ms). The
+ * actual model download still happens lazily on first `mneme index`.
+ */
+import { type MemoryTierInfo, type MemoryTierName } from "./memory_tier.js";
+export interface EmbedderProbe {
+    tier: MemoryTierName;
+    available: boolean;
+    /** Brief why-not when available=false. */
+    reason?: string;
+    /** Time spent in probe, ms. */
+    ms: number;
+}
+export interface AutodiagnoseReport {
+    /** Tier currently selected in .mneme/config.json (or default). */
+    currentTier: MemoryTierName;
+    /** Highest available tier on this machine. */
+    bestAvailable: MemoryTierName;
+    /** True iff bestAvailable is strictly above currentTier. */
+    hasUpgrade: boolean;
+    /** Probes for each candidate tier. */
+    probes: EmbedderProbe[];
+    /** Plain-English headline. */
+    headline: string;
+    /** Recommended action when hasUpgrade=true; null otherwise. */
+    recommendation: {
+        action: "switch-to";
+        tier: MemoryTierName;
+        rationale: string;
+    } | null;
+    /** When persist=true and recommendation acted on, the config path written. */
+    configPathWritten: string | null;
+    /** Total wall-time, ms. */
+    ms: number;
+}
+export interface AutodiagnoseOptions {
+    /** If true, rewrite .mneme/config.json to switch to bestAvailable. Default false. */
+    persist?: boolean;
+    /** Skip Ollama probe (e.g. test environments). Default false. */
+    skipOllama?: boolean;
+    /** Skip Bundled probe (e.g. CI without network). Default false. */
+    skipBundled?: boolean;
+}
+export declare function autodiagnose(repoRoot: string, opts?: AutodiagnoseOptions): Promise<AutodiagnoseReport>;
+/** Returns the resolved memory-tier info for the (possibly upgraded)
+ *  current config. Convenience for pulse/status surfaces. */
+export declare function currentTierInfo(repoRoot: string): MemoryTierInfo;
+//# sourceMappingURL=embedder_autodiagnose.d.ts.map

package/dist/embedder_autodiagnose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder_autodiagnose.d.ts","sourceRoot":"","sources":["../src/embedder_autodiagnose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,EAAkC,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE5G,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,WAAW,EAAE,cAAc,CAAC;IAC5B,8CAA8C;IAC9C,aAAa,EAAE,cAAc,CAAC;IAC9B,4DAA4D;IAC5D,UAAU,EAAE,OAAO,CAAC;IACpB,sCAAsC;IACtC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,cAAc,EAAE;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,cAAc,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACxF,8EAA8E;IAC9E,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;CACZ;AA+DD,MAAM,WAAW,mBAAmB;IAClC,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mEAAmE;IACnE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6D5G;AAED;6DAC6D;AAC7D,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAIhE"}

package/dist/embedder_autodiagnose.js

@@ -0,0 +1,153 @@
+/**
+ * v1.65.1 -- EMBEDDER AUTODIAGNOSE.
+ *
+ * Detects the GAP between the highest tier actually available on the
+ * machine and the tier the user's config selected. If the user is
+ * sitting on hash tier (★★) while bundled WASM or Ollama is reachable,
+ * the autodiagnose flags it AND offers a one-call upgrade.
+ *
+ * Probe priority (best -> worst):
+ *   1. openai  -- env OPENAI_API_KEY set
+ *   2. ollama  -- 127.0.0.1:11434 reachable
+ *   3. bundled -- @huggingface/transformers importable + cache writable
+ *   4. hash    -- always available
+ *
+ * Pure-read by default; persist=true rewrites .mneme/config.json so
+ * the next session picks the upgraded provider.
+ *
+ * No actual embed calls are made -- probe is cheap (<200ms). The
+ * actual model download still happens lazily on first `mneme index`.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { request } from "node:http";
+import { classifyEmbedderName, tierInfo } from "./memory_tier.js";
+const TIER_RANK = {
+    openai: 4, ollama: 3, bundled: 2, hash: 1, unknown: 0,
+};
+function readConfig(repoRoot) {
+    const p = join(repoRoot, ".mneme/config.json");
+    if (!existsSync(p))
+        return {};
+    try {
+        return JSON.parse(readFileSync(p, "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+function writeConfig(repoRoot, cfg) {
+    const dir = join(repoRoot, ".mneme");
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    const p = join(dir, "config.json");
+    writeFileSync(p, JSON.stringify(cfg, null, 2) + "\n", "utf8");
+    return p;
+}
+function probeOpenAI() {
+    const t0 = Date.now();
+    const hasKey = typeof process.env["OPENAI_API_KEY"] === "string" && process.env["OPENAI_API_KEY"].length >= 10;
+    return {
+        tier: "openai",
+        available: hasKey,
+        reason: hasKey ? undefined : "OPENAI_API_KEY not set",
+        ms: Date.now() - t0,
+    };
+}
+function probeOllama(timeoutMs = 500) {
+    return new Promise((resolve) => {
+        const t0 = Date.now();
+        const req = request({ host: "127.0.0.1", port: 11434, path: "/api/tags", method: "GET", timeout: timeoutMs }, (res) => {
+            res.resume();
+            resolve({ tier: "ollama", available: (res.statusCode ?? 0) < 500, ms: Date.now() - t0 });
+        });
+        req.on("timeout", () => {
+            req.destroy();
+            resolve({ tier: "ollama", available: false, reason: "Ollama 127.0.0.1:11434 timeout", ms: Date.now() - t0 });
+        });
+        req.on("error", (e) => resolve({ tier: "ollama", available: false, reason: `Ollama unreachable: ${e.message}`, ms: Date.now() - t0 }));
+        req.end();
+    });
+}
+async function probeBundled() {
+    const t0 = Date.now();
+    try {
+        // Just check that the package resolves; do NOT load model (kept cheap).
+        // The actual download happens lazily on first embed.
+        await import("@huggingface/transformers");
+        return { tier: "bundled", available: true, ms: Date.now() - t0 };
+    }
+    catch (e) {
+        return { tier: "bundled", available: false, reason: `@huggingface/transformers import failed: ${e.message}`, ms: Date.now() - t0 };
+    }
+}
+function probeHash() {
+    return { tier: "hash", available: true, ms: 0 };
+}
+export async function autodiagnose(repoRoot, opts) {
+    const t0 = Date.now();
+    const cfg = readConfig(repoRoot);
+    const currentName = cfg.embeddings?.provider ?? "unknown";
+    const currentTier = classifyEmbedderName(currentName);
+    const probes = [];
+    probes.push(probeOpenAI());
+    if (!opts?.skipOllama)
+        probes.push(await probeOllama());
+    if (!opts?.skipBundled)
+        probes.push(await probeBundled());
+    probes.push(probeHash());
+    // Pick best available.
+    let bestAvailable = "hash";
+    let bestRank = TIER_RANK.hash;
+    for (const p of probes) {
+        if (!p.available)
+            continue;
+        const r = TIER_RANK[p.tier];
+        if (r > bestRank) {
+            bestRank = r;
+            bestAvailable = p.tier;
+        }
+    }
+    const hasUpgrade = TIER_RANK[bestAvailable] > TIER_RANK[currentTier];
+    let configPathWritten = null;
+    if (opts?.persist && hasUpgrade) {
+        const next = { ...cfg, embeddings: { ...(cfg.embeddings ?? {}), provider: bestAvailable } };
+        configPathWritten = writeConfig(repoRoot, next);
+    }
+    const currentBadge = tierInfo(currentTier).display;
+    const bestBadge = tierInfo(bestAvailable).display;
+    const headline = hasUpgrade
+        ? `Upgrade available: currently on ${currentBadge} (★${tierInfo(currentTier).stars}), can upgrade to ${bestBadge} (★${tierInfo(bestAvailable).stars}).`
+        : `Already at best available tier: ${currentBadge} (★${tierInfo(currentTier).stars}).`;
+    const recommendation = hasUpgrade
+        ? {
+            action: "switch-to",
+            tier: bestAvailable,
+            rationale: bestAvailable === "openai"
+                ? "OPENAI_API_KEY detected; switch to ★★★★★ tier."
+                : bestAvailable === "ollama"
+                    ? "Ollama reachable locally; free ★★★★ semantic embeddings."
+                    : bestAvailable === "bundled"
+                        ? "Bundled WASM available; ★★★ semantic embeddings without external service."
+                        : "(no upgrade)",
+        }
+        : null;
+    return {
+        currentTier,
+        bestAvailable,
+        hasUpgrade,
+        probes,
+        headline,
+        recommendation,
+        configPathWritten,
+        ms: Date.now() - t0,
+    };
+}
+/** Returns the resolved memory-tier info for the (possibly upgraded)
+ *  current config. Convenience for pulse/status surfaces. */
+export function currentTierInfo(repoRoot) {
+    const cfg = readConfig(repoRoot);
+    const name = cfg.embeddings?.provider ?? "unknown";
+    return tierInfo(classifyEmbedderName(name));
+}
+//# sourceMappingURL=embedder_autodiagnose.js.map

package/dist/embedder_autodiagnose.js.map

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

package/dist/embedder_autodiagnose.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * v1.65.1 -- Embedder autodiagnose tests.
+ */
+export {};
+//# sourceMappingURL=embedder_autodiagnose.test.d.ts.map

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

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

package/dist/embedder_autodiagnose.test.js

@@ -0,0 +1,101 @@
+/**
+ * v1.65.1 -- Embedder autodiagnose tests.
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, rmSync, mkdirSync, writeFileSync, readFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { autodiagnose, currentTierInfo } from "./embedder_autodiagnose.js";
+function setup() { return mkdtempSync(join(tmpdir(), "mneme-autodiag-")); }
+function cleanup(r) { try {
+    rmSync(r, { recursive: true, force: true });
+}
+catch { /* */ } }
+function writeConfig(r, provider) {
+    mkdirSync(join(r, ".mneme"), { recursive: true });
+    writeFileSync(join(r, ".mneme/config.json"), JSON.stringify({
+        schemaVersion: 1,
+        embeddings: { provider, model: "Xenova/all-MiniLM-L6-v2" },
+    }, null, 2), "utf8");
+}
+describe("v1.65.1 EmbedderAutodiagnose", () => {
+    let r;
+    beforeEach(() => { r = setup(); });
+    afterEach(() => cleanup(r));
+    it("reports gap when config says hash but bundled is available", async () => {
+        writeConfig(r, "hash");
+        const report = await autodiagnose(r, { skipOllama: true });
+        expect(report.currentTier).toBe("hash");
+        // Bundled is reachable from this test environment (transformers installed).
+        expect(["bundled", "openai"]).toContain(report.bestAvailable);
+        expect(report.hasUpgrade).toBe(true);
+        expect(report.recommendation).not.toBeNull();
+        expect(report.recommendation?.action).toBe("switch-to");
+    });
+    it("reports no upgrade when already on best available", async () => {
+        writeConfig(r, "bundled");
+        const report = await autodiagnose(r, { skipOllama: true });
+        // If OPENAI_API_KEY is set in test env, bundled could be below best; allow either.
+        if (process.env["OPENAI_API_KEY"]) {
+            expect(report.hasUpgrade).toBe(true);
+        }
+        else {
+            expect(report.hasUpgrade).toBe(false);
+            expect(report.recommendation).toBeNull();
+        }
+    });
+    it("persist=true rewrites config to bestAvailable", async () => {
+        writeConfig(r, "hash");
+        const report = await autodiagnose(r, { skipOllama: true, persist: true });
+        expect(report.configPathWritten).toBeTruthy();
+        const updated = JSON.parse(readFileSync(join(r, ".mneme/config.json"), "utf8"));
+        expect(updated.embeddings?.provider).toBe(report.bestAvailable);
+    });
+    it("persist=false leaves config untouched even when upgrade exists", async () => {
+        writeConfig(r, "hash");
+        const report = await autodiagnose(r, { skipOllama: true, persist: false });
+        expect(report.configPathWritten).toBeNull();
+        const after = JSON.parse(readFileSync(join(r, ".mneme/config.json"), "utf8"));
+        expect(after.embeddings?.provider).toBe("hash");
+    });
+    it("skipBundled + skipOllama falls back to hash baseline", async () => {
+        writeConfig(r, "hash");
+        const report = await autodiagnose(r, { skipOllama: true, skipBundled: true });
+        if (!process.env["OPENAI_API_KEY"]) {
+            expect(report.bestAvailable).toBe("hash");
+            expect(report.hasUpgrade).toBe(false);
+        }
+    });
+    it("returns probes for each candidate tier", async () => {
+        writeConfig(r, "hash");
+        const report = await autodiagnose(r, { skipOllama: true });
+        const tiers = report.probes.map((p) => p.tier);
+        expect(tiers).toContain("openai");
+        expect(tiers).toContain("bundled");
+        expect(tiers).toContain("hash");
+    });
+    it("currentTierInfo reads from config", () => {
+        writeConfig(r, "bundled");
+        const info = currentTierInfo(r);
+        expect(info.name).toBe("bundled");
+        expect(info.semantic).toBe(true);
+    });
+    it("currentTierInfo returns unknown when no config", () => {
+        const info = currentTierInfo(r);
+        expect(info.name).toBe("unknown");
+    });
+    it("headline mentions upgrade when one exists", async () => {
+        writeConfig(r, "hash");
+        const report = await autodiagnose(r, { skipOllama: true });
+        if (report.hasUpgrade) {
+            expect(report.headline.toLowerCase()).toContain("upgrade");
+        }
+    });
+    it("hash tier always available as floor", async () => {
+        writeConfig(r, "hash");
+        const report = await autodiagnose(r, { skipOllama: true, skipBundled: true });
+        const hashProbe = report.probes.find((p) => p.tier === "hash");
+        expect(hashProbe?.available).toBe(true);
+    });
+});
+//# sourceMappingURL=embedder_autodiagnose.test.js.map