@mneme-ai/core 2.19.32 → 2.19.33

package/dist/tool_browser/index.js

@@ -0,0 +1,218 @@
+/**
+ * v2.19.33 B3 fix — MNEME TOOL BROWSER (discoverability for 600+ tools)
+ *
+ *   User-audit diagnosis (2026-05-17):
+ *   "STARTER tier เล็กไป (13/594 = 2.2%) ... 97.8% hidden from default view.
+ *    ปัญหาแม่นยำคือ discoverability ไม่ใช่ catalog size.
+ *    Wisdom fix:
+ *      - expand STARTER ไป ~30-40 tools (~5-7%)
+ *      - เพิ่ม mneme browse — interactive TUI explorer ของ 594 tools
+ *      - เพิ่ม mneme suggest — repo-aware tool recommendations
+ *      - wisdom: discoverability = curated tour, not just curated subset"
+ *
+ *   v2.19.33 ships two pure-function helpers + 2 MCP wrappers:
+ *
+ *     browseCatalog({tier?, family?, query?, limit?, offset?})
+ *       → paginated list of tool descriptions filtered + sorted by tier
+ *       → caller (CLI / MCP) renders the page
+ *
+ *     suggestTools({recentActions?, repoSignals?, intent?, limit?})
+ *       → returns top-N tool recommendations based on:
+ *         - recent CLI activity (tail of .mneme/cli-activity.jsonl)
+ *         - repo signals (presence of package.json / Cargo.toml / git history)
+ *         - explicit intent string
+ *       → SCORED + sorted; deterministic given the same input
+ *
+ *   Both stay pure (no I/O). The caller supplies the catalog snapshot +
+ *   activity tail; this module ranks + filters.
+ *
+ * Composes onto:
+ *   - v2.19.24 TOOL TIER (consumes Tier classification)
+ *   - v2.19.32 HANDOFF SNAPSHOT (recentActivity format reused)
+ *
+ * Honest scope:
+ *   - PURE FUNCTION. Never throws. Caller supplies I/O.
+ *   - Deterministic ranking (no Math.random in scoring).
+ *   - 24/7 safe: 1000 random browse/suggest calls never crash.
+ */
+const PROTOCOL_VERSION = 1;
+/** Paginated catalog browse. Pure; no I/O. */
+export function browseCatalog(input) {
+    const limit = input.limit && input.limit > 0 ? Math.min(input.limit, 200) : 30;
+    const offset = input.offset && input.offset >= 0 ? input.offset : 0;
+    const cat = Array.isArray(input.catalog) ? input.catalog : [];
+    const q = (input.query ?? "").toLowerCase().trim();
+    const family = (input.family ?? "").toLowerCase().trim();
+    const filtered = cat.filter((e) => {
+        if (!e || typeof e.name !== "string")
+            return false;
+        if (input.tier && e.tier !== input.tier)
+            return false;
+        if (family) {
+            const parts = e.name.toLowerCase().split(".");
+            const fam = parts[1] ?? "";
+            if (fam !== family && !fam.startsWith(family))
+                return false;
+        }
+        if (q) {
+            const hay = [e.name, e.description ?? "", (e.triggers ?? []).join(" ")].join(" ").toLowerCase();
+            if (!hay.includes(q))
+                return false;
+        }
+        return true;
+    });
+    // Stable, deterministic sort: starter > explorer > deep > experimental, then alpha by name.
+    const tierRank = { starter: 0, explorer: 1, deep: 2, experimental: 3 };
+    filtered.sort((a, b) => {
+        const ra = tierRank[a.tier ?? "deep"] ?? 9;
+        const rb = tierRank[b.tier ?? "deep"] ?? 9;
+        if (ra !== rb)
+            return ra - rb;
+        return a.name.localeCompare(b.name);
+    });
+    const total = filtered.length;
+    const entries = filtered.slice(offset, offset + limit);
+    const pageNum = Math.floor(offset / limit) + 1;
+    const totalPages = Math.max(1, Math.ceil(total / limit));
+    const filterDesc = [
+        input.tier ? `tier=${input.tier}` : "",
+        family ? `family=${family}` : "",
+        q ? `query="${q}"` : "",
+    ].filter(Boolean).join(" ");
+    const pulseLine = `🔎 BROWSE ${entries.length}/${total} tools (page ${pageNum}/${totalPages})${filterDesc ? ` · ${filterDesc}` : ""}`;
+    return {
+        v: PROTOCOL_VERSION,
+        totalMatches: total,
+        pageOffset: offset,
+        pageLimit: limit,
+        entries,
+        pulseLine,
+    };
+}
+/**
+ * Suggest top-N tools for the caller's current context.
+ * Deterministic scoring: same inputs → same suggestions in same order.
+ */
+export function suggestTools(input) {
+    const cat = Array.isArray(input.catalog) ? input.catalog : [];
+    const limit = input.limit && input.limit > 0 ? Math.min(input.limit, 20) : 5;
+    const recent = Array.isArray(input.recentActions) ? input.recentActions : [];
+    const signals = input.repoSignals ?? {};
+    const intent = (input.intent ?? "").toLowerCase().trim();
+    // Build a "recently-used" map for cooldown (don't re-suggest tools the user just ran).
+    const recentNames = new Set();
+    for (const r of recent.slice(-50)) {
+        if (r && typeof r.action === "string")
+            recentNames.add(r.action.toLowerCase());
+    }
+    const scored = [];
+    for (const tool of cat) {
+        if (!tool || typeof tool.name !== "string")
+            continue;
+        let score = 0;
+        const reasons = [];
+        // +tier bias (starter gets a small first-run nudge)
+        if (tool.tier === "starter") {
+            score += 0.5;
+            reasons.push("starter tier");
+        }
+        else if (tool.tier === "explorer") {
+            score += 0.2;
+            reasons.push("explorer tier");
+        }
+        // -recency penalty (cool down recently-used tools)
+        if (recentNames.has(tool.name.toLowerCase())) {
+            score -= 1.5;
+            reasons.push("recently used (cooldown)");
+        }
+        // +intent match (substring across name/description/triggers)
+        if (intent) {
+            const hay = [tool.name, tool.description ?? "", (tool.triggers ?? []).join(" ")].join(" ").toLowerCase();
+            if (hay.includes(intent)) {
+                score += 2.0;
+                reasons.push(`matches intent "${intent}"`);
+            }
+            else {
+                // Token overlap for fuzzy intent matching
+                const intentTokens = intent.split(/\s+/).filter((t) => t.length > 2);
+                let hits = 0;
+                for (const t of intentTokens)
+                    if (hay.includes(t))
+                        hits++;
+                if (hits > 0) {
+                    score += 0.3 * hits;
+                    reasons.push(`partial intent match (${hits} tokens)`);
+                }
+            }
+        }
+        // +repo-signal nudges (deterministic; pure)
+        if (signals.hasPackageJson && /\b(?:antivirus|guard|truth)\b/.test(tool.name)) {
+            score += 0.4;
+            reasons.push("Node repo signal");
+        }
+        if (signals.hasUncommittedChanges && /\b(?:premortem|guard|antivirus|truth)\b/.test(tool.name)) {
+            score += 0.6;
+            reasons.push("uncommitted-changes signal");
+        }
+        if (signals.hasDotGit && /\b(?:who_knows|atrophy|why|stigmergy)\b/.test(tool.name)) {
+            score += 0.3;
+            reasons.push("git history signal");
+        }
+        if (signals.hasGithubActions && /\b(?:catalog|reachability|sentinel)\b/.test(tool.name)) {
+            score += 0.3;
+            reasons.push("CI signal");
+        }
+        if (signals.recentCommitCount && signals.recentCommitCount >= 3
+            && /\b(?:why|atrophy|premortem)\b/.test(tool.name)) {
+            score += 0.4;
+            reasons.push("active development signal");
+        }
+        if (score > 0)
+            scored.push({ tool, score: Math.round(score * 100) / 100, reasons });
+    }
+    // Sort: score desc, then alpha by name (deterministic tie-break).
+    scored.sort((a, b) => {
+        if (a.score !== b.score)
+            return b.score - a.score;
+        return a.tool.name.localeCompare(b.tool.name);
+    });
+    const top = scored.slice(0, limit);
+    const pulseLine = top.length === 0
+        ? "💡 SUGGEST · no signals — try mneme.browse to explore"
+        : `💡 SUGGEST · top ${top.length} tool(s) for current context (top score ${top[0].score})`;
+    return { v: PROTOCOL_VERSION, suggestions: top, pulseLine };
+}
+export function computeBrowseStats(catalog) {
+    let s = 0, e = 0, d = 0, x = 0;
+    for (const t of catalog) {
+        if (!t)
+            continue;
+        if (t.tier === "starter")
+            s++;
+        else if (t.tier === "explorer")
+            e++;
+        else if (t.tier === "experimental")
+            x++;
+        else
+            d++;
+    }
+    const total = catalog.length;
+    return {
+        starterCount: s,
+        explorerCount: e,
+        deepCount: d,
+        experimentalCount: x,
+        totalTools: total,
+        starterPct: total > 0 ? Math.round((s / total) * 1000) / 10 : 0,
+    };
+}
+export function formatBrowseStatsLine(s) {
+    return `🔎 CATALOG · ${s.totalTools} tools · ⭐⭐⭐${s.starterCount} (${s.starterPct}%) · ⭐⭐${s.explorerCount} · ⭐${s.deepCount} · 🔬${s.experimentalCount}`;
+}
+export const TOOL_BROWSER_TUNABLES = Object.freeze({
+    PROTOCOL_VERSION,
+    DEFAULT_PAGE_LIMIT: 30,
+    MAX_PAGE_LIMIT: 200,
+    DEFAULT_SUGGEST_LIMIT: 5,
+});
+//# sourceMappingURL=index.js.map

package/dist/tool_browser/index.js.map

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

package/dist/tool_browser/tool_browser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool_browser.test.d.ts.map

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

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

package/dist/tool_browser/tool_browser.test.js

@@ -0,0 +1,167 @@
+import { describe, it, expect } from "vitest";
+import { browseCatalog, suggestTools, computeBrowseStats, formatBrowseStatsLine, TOOL_BROWSER_TUNABLES, } from "./index.js";
+const SAMPLE_CATALOG = [
+    { name: "mneme.status", tier: "starter", description: "show status", triggers: ["status"] },
+    { name: "mneme.ask", tier: "starter", description: "semantic Q&A", triggers: ["ask"] },
+    { name: "mneme.truth.forensic", tier: "starter", description: "verify claim", triggers: ["verify", "truth"] },
+    { name: "mneme.synapse.sync_export", tier: "starter", description: "cross-device sync" },
+    { name: "mneme.handoff.snapshot", tier: "starter", description: "fresh context capture" },
+    { name: "mneme.arena.judge", tier: "explorer", description: "AI vendor showdown" },
+    { name: "mneme.soul.embalm", tier: "explorer", description: "agent state snapshot" },
+    { name: "mneme.fork.record", tier: "deep", description: "fork lineage" },
+    { name: "mneme.beacon.spawn", tier: "experimental", description: "QR transfer server" },
+    { name: "mneme.alien.template", tier: "experimental", description: "alien skill template" },
+];
+describe("v2.19.33 B3 — browseCatalog (pagination + filtering)", () => {
+    it("returns all entries when no filter", () => {
+        const r = browseCatalog({ catalog: SAMPLE_CATALOG });
+        expect(r.totalMatches).toBe(SAMPLE_CATALOG.length);
+        expect(r.entries.length).toBe(SAMPLE_CATALOG.length);
+    });
+    it("filters by tier=starter (5 of 10)", () => {
+        const r = browseCatalog({ catalog: SAMPLE_CATALOG, tier: "starter" });
+        expect(r.totalMatches).toBe(5);
+        expect(r.entries.every((e) => e.tier === "starter")).toBe(true);
+    });
+    it("filters by family prefix (synapse → 1)", () => {
+        const r = browseCatalog({ catalog: SAMPLE_CATALOG, family: "synapse" });
+        expect(r.totalMatches).toBe(1);
+        expect(r.entries[0].name).toBe("mneme.synapse.sync_export");
+    });
+    it("substring query across name/description/triggers", () => {
+        const r = browseCatalog({ catalog: SAMPLE_CATALOG, query: "verify" });
+        // truth.forensic has 'verify' in triggers
+        expect(r.totalMatches).toBe(1);
+        expect(r.entries[0].name).toBe("mneme.truth.forensic");
+    });
+    it("paginates: limit=3 offset=0 returns 3 of 10", () => {
+        const r = browseCatalog({ catalog: SAMPLE_CATALOG, limit: 3, offset: 0 });
+        expect(r.entries.length).toBe(3);
+        expect(r.totalMatches).toBe(10);
+    });
+    it("paginates: limit=3 offset=3 returns next 3", () => {
+        const a = browseCatalog({ catalog: SAMPLE_CATALOG, limit: 3, offset: 0 });
+        const b = browseCatalog({ catalog: SAMPLE_CATALOG, limit: 3, offset: 3 });
+        expect(a.entries[0].name).not.toBe(b.entries[0].name);
+    });
+    it("DETERMINISTIC sort: starter > explorer > deep > experimental, then alpha", () => {
+        const r = browseCatalog({ catalog: SAMPLE_CATALOG });
+        // First 5 should all be starter
+        expect(r.entries.slice(0, 5).every((e) => e.tier === "starter")).toBe(true);
+        // Next 2 should be explorer
+        expect(r.entries.slice(5, 7).every((e) => e.tier === "explorer")).toBe(true);
+    });
+    it("pulseLine shows progress", () => {
+        const r = browseCatalog({ catalog: SAMPLE_CATALOG, limit: 5 });
+        expect(r.pulseLine).toContain("BROWSE");
+        expect(r.pulseLine).toContain("page 1");
+    });
+    it("DEFENSIVE: empty catalog returns empty page (no throw)", () => {
+        const r = browseCatalog({ catalog: [] });
+        expect(r.totalMatches).toBe(0);
+        expect(r.entries).toEqual([]);
+    });
+    it("DEFENSIVE: malformed catalog entries dropped silently", () => {
+        const dirty = [...SAMPLE_CATALOG, null, { name: 123 }];
+        const r = browseCatalog({ catalog: dirty });
+        expect(r.totalMatches).toBe(SAMPLE_CATALOG.length);
+    });
+});
+describe("v2.19.33 B3 — suggestTools (repo-aware ranking)", () => {
+    it("intent matching dominates: 'verify claim' → truth.forensic top", () => {
+        const r = suggestTools({ catalog: SAMPLE_CATALOG, intent: "verify claim" });
+        expect(r.suggestions.length).toBeGreaterThan(0);
+        expect(r.suggestions[0].tool.name).toBe("mneme.truth.forensic");
+    });
+    it("starter tier bias when no other signals", () => {
+        const r = suggestTools({ catalog: SAMPLE_CATALOG });
+        // top suggestion should be a starter tool
+        expect(r.suggestions[0].tool.tier).toBe("starter");
+    });
+    it("recency cooldown: recently-used tools demoted", () => {
+        // Use two tools that both match the intent so cooldown actually swaps rank
+        const cat = [
+            { name: "mneme.truth.forensic", tier: "starter", description: "verify claim", triggers: ["verify"] },
+            { name: "mneme.fork.verify_ledger", tier: "deep", description: "verify ledger" },
+        ];
+        const noRecent = suggestTools({ catalog: cat, intent: "verify" });
+        const withRecent = suggestTools({ catalog: cat, intent: "verify", recentActions: [{ action: "mneme.truth.forensic", ts: Date.now() }] });
+        const noRecentTruthIdx = noRecent.suggestions.findIndex((s) => s.tool.name === "mneme.truth.forensic");
+        const withRecentTruthIdx = withRecent.suggestions.findIndex((s) => s.tool.name === "mneme.truth.forensic");
+        // truth.forensic should rank LOWER (higher index) when in cooldown
+        expect(withRecentTruthIdx).toBeGreaterThan(noRecentTruthIdx);
+    });
+    it("repo signal: uncommittedChanges boosts premortem/guard/truth", () => {
+        const truthOnly = SAMPLE_CATALOG.find((t) => t.name === "mneme.truth.forensic");
+        const r = suggestTools({ catalog: [truthOnly], repoSignals: { hasUncommittedChanges: true } });
+        expect(r.suggestions[0].reasons.some((x) => /uncommitted/.test(x))).toBe(true);
+    });
+    it("DETERMINISTIC: same input → same ranking", () => {
+        const a = suggestTools({ catalog: SAMPLE_CATALOG, intent: "verify" });
+        const b = suggestTools({ catalog: SAMPLE_CATALOG, intent: "verify" });
+        expect(a.suggestions.map((x) => x.tool.name)).toEqual(b.suggestions.map((x) => x.tool.name));
+        expect(a.suggestions.map((x) => x.score)).toEqual(b.suggestions.map((x) => x.score));
+    });
+    it("DEFAULT limit = 5", () => {
+        const r = suggestTools({ catalog: SAMPLE_CATALOG, intent: "tier mneme" });
+        expect(r.suggestions.length).toBeLessThanOrEqual(5);
+    });
+    it("custom limit honored", () => {
+        const r = suggestTools({ catalog: SAMPLE_CATALOG, intent: "mneme", limit: 3 });
+        expect(r.suggestions.length).toBeLessThanOrEqual(3);
+    });
+    it("DEFENSIVE: empty catalog returns empty suggestions", () => {
+        const r = suggestTools({ catalog: [], intent: "anything" });
+        expect(r.suggestions.length).toBe(0);
+        expect(r.pulseLine).toContain("no signals");
+    });
+});
+describe("v2.19.33 B3 — A/B before-vs-after STARTER expansion", () => {
+    // The user-audit complained 13/594 = 2.2% starter coverage.
+    // v2.19.33 expands the whitelist; this test pins the new floor.
+    it("expanded STARTER_WHITELIST is ≥30 entries (was 13 in audit)", async () => {
+        const tt = await import("../tool_tier/index.js");
+        expect(tt.STARTER_WHITELIST.size).toBeGreaterThanOrEqual(30);
+    });
+    it("expanded STARTER_WHITELIST includes new v2.19.31/32 headline tools", async () => {
+        const tt = await import("../tool_tier/index.js");
+        expect(tt.STARTER_WHITELIST.has("mneme.truth.forensic")).toBe(true);
+        expect(tt.STARTER_WHITELIST.has("mneme.truth.contradictions")).toBe(true);
+        expect(tt.STARTER_WHITELIST.has("mneme.handoff.snapshot")).toBe(true);
+        expect(tt.STARTER_WHITELIST.has("mneme.synapse.sync_export")).toBe(true);
+        expect(tt.STARTER_WHITELIST.has("mneme.browse")).toBe(true);
+        expect(tt.STARTER_WHITELIST.has("mneme.suggest")).toBe(true);
+    });
+    it("A/B DELTA: post-fix STARTER count ≥ 2× pre-fix audit baseline (13)", async () => {
+        const tt = await import("../tool_tier/index.js");
+        expect(tt.STARTER_WHITELIST.size).toBeGreaterThanOrEqual(26);
+    });
+});
+describe("v2.19.33 B3 — stats + resilience", () => {
+    it("computeBrowseStats reports counts + percentage", () => {
+        const s = computeBrowseStats(SAMPLE_CATALOG);
+        expect(s.starterCount).toBe(5);
+        expect(s.explorerCount).toBe(2);
+        expect(s.deepCount).toBe(1);
+        expect(s.experimentalCount).toBe(2);
+        expect(s.totalTools).toBe(10);
+        expect(s.starterPct).toBe(50);
+        expect(formatBrowseStatsLine(s)).toContain("CATALOG");
+    });
+    it("PROTOCOL_VERSION exposed", () => {
+        expect(TOOL_BROWSER_TUNABLES.PROTOCOL_VERSION).toBe(1);
+    });
+    it("1000 random browse/suggest calls never crash", () => {
+        const tiers = ["starter", "explorer", "deep", "experimental"];
+        for (let i = 0; i < 1000; i++) {
+            const tier = tiers[Math.floor(Math.random() * tiers.length)];
+            expect(() => browseCatalog({ catalog: SAMPLE_CATALOG, tier, limit: Math.floor(Math.random() * 50) })).not.toThrow();
+            expect(() => suggestTools({
+                catalog: SAMPLE_CATALOG,
+                intent: `random ${Math.random()}`,
+                recentActions: [{ action: `mneme.x${i}`, ts: i }],
+            })).not.toThrow();
+        }
+    });
+});
+//# sourceMappingURL=tool_browser.test.js.map

package/dist/tool_browser/tool_browser.test.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tool_tier/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAIH,QAAA,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAEpC,MAAM,MAAM,IAAI,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,cAAc,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAqChD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAmBhD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAOpD,CAAC;AAEH,MAAM,WAAW,kBAAkB;IACjC,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAqBjE;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb;AAsBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAmB7F;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAGpE;AAED,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG,MAAM,EAAE,CAE/E;AAED,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAK3C,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAK3C,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAEtD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tool_tier/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAIH,QAAA,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAEpC,MAAM,MAAM,IAAI,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,cAAc,CAAC;AAEpE;;;GAGG;AAKH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAmDhD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAmBhD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAOpD,CAAC;AAEH,MAAM,WAAW,kBAAkB;IACjC,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAqBjE;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb;AAsBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAmB7F;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAGpE;AAED,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG,MAAM,EAAE,CAE/E;AAED,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAK3C,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAK3C,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAEtD"}

package/dist/tool_tier/index.js

@@ -38,6 +38,10 @@ const PROTOCOL_VERSION = 1;
  * Curated essentials — first-time users meet Mneme through these.
  * Hand-picked; small enough that beginners aren't overwhelmed.
  */
+// v2.19.33 B3 fix: expanded STARTER from 13 visible (2.2% of 594) → ~35
+// (~5.5% of 647) so first-time users see ONE representative tool per
+// major capability category, not a cherry-picked dozen. Each addition is
+// the "ask the AI to do X" entry point users actually need on day 1.
 export const STARTER_WHITELIST = new Set([
     // Core memory + retrieval
     "mneme.status",
@@ -61,20 +65,34 @@ export const STARTER_WHITELIST = new Set([
     // Embedder + tier health
     "mneme.embeddings.status",
     "mneme.embeddings.upgrade",
-    // Antivirus (the highest-impact daily-use tools)
+    // Antivirus (highest-impact daily-use tools)
     "mneme.antivirus.scan",
     "mneme.antivirus.cure",
-    // LIMBIC organism health (the new front door)
+    // LIMBIC organism health
     "mneme.limbic.health",
     "mneme.breath.stats",
-    // People diagnostics (high-value commit-history queries)
+    // People diagnostics
     "mneme.atrophy",
-    "mneme.who_knows",
     // Premortem (the answer to "is this safe to ship?")
     "mneme.premortem",
-    // Tier discovery (this very command)
+    // Tier discovery + B3 NEW discoverability commands
     "mneme.tier.classify",
     "mneme.tier.list_by_tier",
+    "mneme.browse", // v2.19.33 B3: interactive catalog tour
+    "mneme.suggest", // v2.19.33 B3: repo-aware tool recommendations
+    // v2.19.31 truth + contradictions (the "is this real?" entry point)
+    "mneme.truth.forensic",
+    "mneme.truth.contradictions",
+    "mneme.truth.init", // v2.19.33 B2: zero-config sensor stack
+    // v2.19.32 cross-device handoff (headline of the release)
+    "mneme.handoff.snapshot",
+    "mneme.handoff.pair_generate",
+    // v2.19.31 cross-device sync (the brain unification entry point)
+    "mneme.synapse.sync_export",
+    // Bug prophet — "what could go wrong if I ship this?"
+    "mneme.guard",
+    // Reflex — auto-cache (one of the v2.19.22 flagship features)
+    "mneme.reflex.observe",
 ]);
 /**
  * Families that ALWAYS land in EXPLORER (v2.18+ pentads + organs).

package/dist/tool_tier/index.js.map

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

package/dist/truth_sensor_pack/index.d.ts

@@ -0,0 +1,105 @@
+/**
+ * v2.19.33 B2 fix — MNEME TRUTH SENSOR PACK (zero-config defaults that work first-run)
+ *
+ *   User-audit diagnosis (2026-05-17):
+ *   "mneme truth check_multi sensors=0 (no active sensors).
+ *    verdict: INCONCLUSIVE · pTrue: 0.5 · sensors: 0.
+ *    Root cause: TRUTH KERNEL ออกแบบให้ register sensors แต่ default config มี 0 sensors active.
+ *    Wisdom: zero-config means good defaults — ไม่ใช่ 'empty until configured'"
+ *
+ *   v2.19.33 ships a CANONICAL DEFAULT STACK that any AI agent can wire
+ *   into `mneme.truth.check_multi` without having to invent the recipe.
+ *
+ *   The stack is intentionally PURE METADATA (not executable) because the
+ *   real sensors require I/O the kernel deliberately doesn't do:
+ *     - inverse_forensics needs the codebase + LLM call
+ *     - truth_forensic needs the live MCP catalog
+ *     - apoptosis needs file/symbol grep + git history
+ *     - bountyVendor needs vendor-API calls
+ *
+ *   So the recipe tells the CALLER:
+ *     1. Which sensors to invoke
+ *     2. What MCP tool to invoke each one through
+ *     3. What weight to apply
+ *     4. What to do if the sensor is unavailable
+ *
+ *   The CALLER (AI agent / daemon) wires the I/O; the kernel fuses the
+ *   results. This stays vendor-neutral + testable + offline-safe.
+ *
+ *   Plus: `proposeSensorPlan(claim)` filters the stack to the sensors most
+ *   relevant for the claim shape (e.g., file-existence claim → apoptosis +
+ *   truth_forensic; conceptual claim → inverse_forensics + bountyVendor).
+ *
+ * Composes onto:
+ *   - v2.6  TRUTH KERNEL (consumes Sensor list; fuses verdicts)
+ *   - v2.19.15 TRUTH FORENSIC (one of the canonical sensors)
+ *   - v2.19.3  INVERSE LLM (one of the canonical sensors)
+ *   - v1.65    APOPTOSIS (one of the canonical sensors)
+ *
+ * Honest scope:
+ *   - PURE FUNCTION metadata + planner. No I/O.
+ *   - The recipe is the canonical Mneme answer to "what sensors do I run by default?"
+ *   - Defensive: empty claim / weird input never throws; returns minimal plan.
+ *   - 24/7 safe: 1000 random plans never crash (measured in test suite).
+ */
+declare const PROTOCOL_VERSION: 1;
+export type ClaimShape = "file_existence" | "symbol_existence" | "version_claim" | "tool_capability" | "conceptual" | "narrative" | "unknown";
+export interface SensorRecipe {
+    /** Canonical sensor id used by truthKernel.checkTruth. */
+    id: string;
+    /** What MCP tool the CALLER should invoke to get this sensor's verdict. */
+    mcpTool: string;
+    /** Suggested weight for log-odds fusion (higher = more authoritative). */
+    weight: number;
+    /** One-sentence description for the AI agent / user. */
+    description: string;
+    /** What to feed the MCP tool; placeholder template. */
+    inputTemplate: Record<string, string>;
+    /** What to do if this sensor is unavailable (e.g., no network). */
+    fallbackBehaviour: "skip" | "treat_as_uncertain" | "treat_as_inapplicable";
+    /** Which claim shapes this sensor performs best on. */
+    bestFor: ClaimShape[];
+}
+export declare const DEFAULT_SENSOR_PACK: ReadonlyArray<SensorRecipe>;
+/**
+ * Detect the shape of a claim from its text. Pure heuristic; defensive.
+ * Returns "unknown" if no signal — caller may still use the full default pack.
+ */
+export declare function classifyClaimShape(claim: string): ClaimShape;
+export interface SensorPlan {
+    v: typeof PROTOCOL_VERSION;
+    claim: string;
+    shape: ClaimShape;
+    recommendedSensors: SensorRecipe[];
+    /** Sensors NOT in the recommendation but available if the caller wants the full stack. */
+    optionalSensors: SensorRecipe[];
+    /** Human-readable summary: "🛡 4 sensors recommended for file_existence claim". */
+    rationale: string;
+}
+/**
+ * Build a recommended sensor plan for a specific claim.
+ * If the claim shape is "unknown" or the caller wants the full stack, use
+ * `DEFAULT_SENSOR_PACK` directly. Otherwise this filters to high-relevance sensors.
+ */
+export declare function proposeSensorPlan(input: {
+    claim: string;
+    full?: boolean;
+}): SensorPlan;
+/**
+ * Render the recipe as the AI-agent-ingestible instruction text used by
+ * `mneme.truth.init`. Vendor-neutral; safe to display in clear text.
+ */
+export declare function explainDefaultStack(plan: SensorPlan): string;
+export interface SensorPackStats {
+    totalDefaults: number;
+    shapeSpecificMappings: number;
+    averageWeight: number;
+}
+export declare function computePackStats(pack?: ReadonlyArray<SensorRecipe>): SensorPackStats;
+export declare function formatPackLine(s: SensorPackStats): string;
+export declare const TRUTH_SENSOR_PACK_TUNABLES: Readonly<{
+    PROTOCOL_VERSION: 1;
+    DEFAULT_SENSOR_COUNT: number;
+}>;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/truth_sensor_pack/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,QAAA,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAEpC,MAAM,MAAM,UAAU,GAClB,gBAAgB,GAChB,kBAAkB,GAClB,eAAe,GACf,iBAAiB,GACjB,YAAY,GACZ,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,mEAAmE;IACnE,iBAAiB,EAAE,MAAM,GAAG,oBAAoB,GAAG,uBAAuB,CAAC;IAC3E,uDAAuD;IACvD,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAqDD,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,YAAY,CAAoC,CAAC;AAEjG;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAU5D;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,CAAC;IAClB,kBAAkB,EAAE,YAAY,EAAE,CAAC;IACnC,0FAA0F;IAC1F,eAAe,EAAE,YAAY,EAAE,CAAC;IAChC,mFAAmF;IACnF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,UAAU,CAuBtF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA0B5D;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,aAAa,CAAC,YAAY,CAAuB,GAAG,eAAe,CAazG;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAEzD;AAED,eAAO,MAAM,0BAA0B;;;EAGrC,CAAC"}