@mneme-ai/core 0.8.4 → 0.9.0

package/dist/insights/dream.js

@@ -0,0 +1,235 @@
+/**
+ * `dream` — speculative ideas from your codebase patterns.
+ *
+ * The premise: every codebase has *latent shape*. Authentication, payments,
+ * logging, queue patterns repeat in similar idioms. Given the patterns you
+ * already use, an LLM can suggest features that would fit your codebase's
+ * style — citing the existing patterns it learned from.
+ *
+ * This is the most "AI from the future" command: instead of "what does X
+ * do?", it answers "what could you build next that fits your style?"
+ *
+ * Pure data extraction here (signal gathering); LLM call lives in the CLI.
+ */
+/**
+ * Gather signals from the indexed memory. Pure read-only — no LLM call.
+ * Designed to fit into one LLM prompt without truncation.
+ */
+export function gatherRepoSignals(store) {
+    const totalCommits = store.countCommits();
+    // Incident count via raw query — store doesn't expose a helper.
+    let totalIncidents = 0;
+    try {
+        const row = store.db.prepare("SELECT COUNT(*) AS n FROM incidents").get();
+        totalIncidents = row?.n ?? 0;
+    }
+    catch {
+        // table may not exist yet on older DBs — treat as zero
+    }
+    // Language distribution from entities table.
+    const langRows = store.db
+        .prepare(`SELECT language, COUNT(*) AS n FROM entities GROUP BY language ORDER BY n DESC LIMIT 10`)
+        .all();
+    const languages = langRows.map((r) => ({ name: r.language, count: r.n }));
+    const totalEntities = languages.reduce((s, l) => s + l.count, 0);
+    // Recent commit subjects.
+    const recentRows = store.db
+        .prepare(`SELECT subject FROM commits ORDER BY author_date DESC LIMIT 30`)
+        .all();
+    const recentSubjects = recentRows.map((r) => r.subject);
+    // Top modules — first two path segments of file_path.
+    const moduleRows = store.db
+        .prepare(`SELECT file_path FROM entities`)
+        .all();
+    const moduleCounts = new Map();
+    for (const r of moduleRows) {
+        const parts = r.file_path.split("/");
+        const key = parts.length >= 2 ? `${parts[0]}/${parts[1]}` : parts[0];
+        moduleCounts.set(key, (moduleCounts.get(key) ?? 0) + 1);
+    }
+    const topModules = [...moduleCounts.entries()]
+        .map(([name, count]) => ({ name, count }))
+        .sort((a, b) => b.count - a.count)
+        .slice(0, 10);
+    // Pattern suffixes — entity names ending in a CamelCase suffix tell us
+    // about architectural style ("Service", "Controller", "Adapter", etc.).
+    const nameRows = store.db
+        .prepare(`SELECT name FROM entities WHERE kind IN ('class','function','type')`)
+        .all();
+    const suffixCounts = new Map();
+    const SUFFIX_RE = /([A-Z][a-z]+)$/;
+    for (const r of nameRows) {
+        const m = SUFFIX_RE.exec(r.name);
+        if (!m)
+            continue;
+        const s = m[1];
+        if (s.length < 4 || s.length > 20)
+            continue;
+        suffixCounts.set(s, (suffixCounts.get(s) ?? 0) + 1);
+    }
+    const patternSuffixes = [...suffixCounts.entries()]
+        .filter(([, n]) => n >= 2)
+        .map(([suffix, count]) => ({ suffix, count }))
+        .sort((a, b) => b.count - a.count)
+        .slice(0, 10);
+    return {
+        totalCommits,
+        totalEntities,
+        languages,
+        recentSubjects,
+        topModules,
+        patternSuffixes,
+        totalIncidents,
+    };
+}
+/**
+ * Build the prompt for the dream LLM. Compact enough to fit a small Ollama
+ * model (llama3.2:3b) without truncation, but rich enough to ground the
+ * speculation in real signals.
+ */
+export function buildDreamPrompt(signals, n) {
+    const lines = [];
+    lines.push("Given the signals below from a real codebase, suggest exactly", String(n), "speculative");
+    lines.push("ideas for features that would fit this codebase's style. Each idea should");
+    lines.push("cite at least one existing pattern from the signals as a precedent.");
+    lines.push("");
+    lines.push(`Total commits indexed: ${signals.totalCommits}`);
+    lines.push(`Total entities indexed: ${signals.totalEntities}`);
+    lines.push(`Total incidents recorded: ${signals.totalIncidents}`);
+    lines.push("");
+    lines.push("Languages by entity count:");
+    for (const l of signals.languages)
+        lines.push(`  • ${l.name}: ${l.count}`);
+    lines.push("");
+    lines.push("Top modules:");
+    for (const m of signals.topModules.slice(0, 8))
+        lines.push(`  • ${m.name} (${m.count} entities)`);
+    lines.push("");
+    if (signals.patternSuffixes.length > 0) {
+        lines.push("Common architectural suffixes (entity names ending with):");
+        for (const s of signals.patternSuffixes.slice(0, 6))
+            lines.push(`  • ${s.suffix} (${s.count}×)`);
+        lines.push("");
+    }
+    lines.push("Recent commit subjects:");
+    for (const s of signals.recentSubjects.slice(0, 12))
+        lines.push(`  • ${s}`);
+    lines.push("");
+    lines.push("Output format: JSON array, each element has fields:");
+    lines.push("  title (string), pitch (2-3 sentences), precedents (array of pattern names),");
+    lines.push("  effort ('small'|'medium'|'large'), risk ('low'|'medium'|'high').");
+    lines.push("Output JSON only, no markdown, no preamble.");
+    return lines.join("\n");
+}
+/**
+ * Parse LLM JSON output into typed DreamIdea[] with permissive validation.
+ * Returns [] on parse failure rather than throwing — dream is best-effort.
+ */
+export function parseDreamIdeas(raw) {
+    // The LLM might wrap JSON in markdown fences or add prose before/after.
+    const jsonStart = raw.indexOf("[");
+    const jsonEnd = raw.lastIndexOf("]");
+    if (jsonStart < 0 || jsonEnd <= jsonStart)
+        return [];
+    const slice = raw.slice(jsonStart, jsonEnd + 1);
+    let parsed;
+    try {
+        parsed = JSON.parse(slice);
+    }
+    catch {
+        return [];
+    }
+    if (!Array.isArray(parsed))
+        return [];
+    const out = [];
+    for (const item of parsed) {
+        if (!item || typeof item !== "object")
+            continue;
+        const o = item;
+        const title = typeof o.title === "string" ? o.title : "";
+        const pitch = typeof o.pitch === "string" ? o.pitch : "";
+        if (!title || !pitch)
+            continue;
+        const precedents = Array.isArray(o.precedents)
+            ? o.precedents.filter((p) => typeof p === "string")
+            : [];
+        const effort = ["small", "medium", "large"].includes(o.effort)
+            ? o.effort
+            : "medium";
+        const risk = ["low", "medium", "high"].includes(o.risk)
+            ? o.risk
+            : "medium";
+        out.push({ title, pitch, precedents, effort, risk });
+    }
+    return out;
+}
+/**
+ * No-LLM fallback — generate ideas from heuristic patterns. Useful for
+ * deterministic mode and as a sanity-check baseline.
+ */
+export function heuristicDream(signals, n) {
+    const ideas = [];
+    // Idea 1 — incident-driven, if incidents exist.
+    if (signals.totalIncidents > 0) {
+        ideas.push({
+            title: "IncidentReplayHarness",
+            pitch: "You already have incident data indexed. A replay harness would let you re-run an incident's commit chain against the current code to see if the bug returned.",
+            precedents: ["correlate", "blast"],
+            effort: "medium",
+            risk: "low",
+        });
+    }
+    // Idea 2 — pattern-suffix-driven.
+    const topSuffix = signals.patternSuffixes[0];
+    if (topSuffix) {
+        ideas.push({
+            title: `${topSuffix.suffix}Registry`,
+            pitch: `You have ${topSuffix.count} entities ending in "${topSuffix.suffix}". A central registry would make discovery and DI cleaner; the pattern is already pervasive.`,
+            precedents: [`${topSuffix.suffix} entities (${topSuffix.count}×)`],
+            effort: "small",
+            risk: "low",
+        });
+    }
+    // Idea 3 — multi-language coverage.
+    if (signals.languages.length >= 2) {
+        const second = signals.languages[1];
+        ideas.push({
+            title: `${capitalize(second.name)}DeepDive`,
+            pitch: `Your repo has ${second.count} entities in ${second.name} but most tooling targets the dominant language. A focused parser/linter pass would surface tribal knowledge that's currently invisible.`,
+            precedents: [`${second.name} parser`],
+            effort: "medium",
+            risk: "medium",
+        });
+    }
+    // Idea 4 — module-driven.
+    const topMod = signals.topModules[0];
+    if (topMod) {
+        ideas.push({
+            title: `${moduleToPascal(topMod.name)}HealthCheck`,
+            pitch: `Your largest module (${topMod.name}, ${topMod.count} entities) has no central health check. A small module-level diagnostic would catch silent regressions early.`,
+            precedents: [topMod.name],
+            effort: "small",
+            risk: "low",
+        });
+    }
+    // Idea 5 — bus-factor.
+    ideas.push({
+        title: "BusFactorReport",
+        pitch: "You already track per-author commit history. A weekly bus-factor report (which files only one person has ever touched) is a tiny extension that compounds.",
+        precedents: ["mirror", "who-knows"],
+        effort: "small",
+        risk: "low",
+    });
+    return ideas.slice(0, n);
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+function moduleToPascal(modulePath) {
+    return modulePath
+        .split(/[/_-]/)
+        .filter(Boolean)
+        .map((p) => capitalize(p))
+        .join("");
+}
+//# sourceMappingURL=dream.js.map

package/dist/insights/dream.js.map

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

package/dist/insights/dream.test.d.ts

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

package/dist/insights/dream.test.d.ts.map

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

package/dist/insights/dream.test.js

@@ -0,0 +1,127 @@
+import { describe, it, expect } from "vitest";
+import { buildDreamPrompt, parseDreamIdeas, heuristicDream, } from "./dream.js";
+const sampleSignals = {
+    totalCommits: 100,
+    totalEntities: 500,
+    totalIncidents: 5,
+    languages: [
+        { name: "typescript", count: 400 },
+        { name: "python", count: 80 },
+        { name: "go", count: 20 },
+    ],
+    recentSubjects: [
+        "fix: stripe webhook on bigint",
+        "feat: add jwt rotation",
+        "refactor: extract OrderService",
+    ],
+    topModules: [
+        { name: "src/payment", count: 60 },
+        { name: "src/auth", count: 40 },
+        { name: "src/orders", count: 30 },
+    ],
+    patternSuffixes: [
+        { suffix: "Service", count: 12 },
+        { suffix: "Adapter", count: 8 },
+        { suffix: "Controller", count: 6 },
+    ],
+};
+describe("buildDreamPrompt", () => {
+    it("includes total counts and language distribution", () => {
+        const p = buildDreamPrompt(sampleSignals, 5);
+        expect(p).toContain("Total commits indexed: 100");
+        expect(p).toContain("Total entities indexed: 500");
+        expect(p).toContain("typescript: 400");
+        expect(p).toContain("python: 80");
+    });
+    it("includes top modules and pattern suffixes", () => {
+        const p = buildDreamPrompt(sampleSignals, 5);
+        expect(p).toContain("src/payment");
+        expect(p).toContain("Service (12×)");
+    });
+    it("includes recent commit subjects (capped)", () => {
+        const p = buildDreamPrompt(sampleSignals, 5);
+        expect(p).toContain("stripe webhook on bigint");
+    });
+    it("requests JSON output", () => {
+        const p = buildDreamPrompt(sampleSignals, 3);
+        expect(p.toLowerCase()).toContain("json");
+        expect(p).toContain("3");
+    });
+});
+describe("parseDreamIdeas", () => {
+    it("parses a clean JSON array", () => {
+        const raw = JSON.stringify([
+            {
+                title: "MultiCurrencyAdapter",
+                pitch: "You already abstract Stripe via PaymentAdapter. Extending to multi-currency is a small parallel.",
+                precedents: ["PaymentAdapter"],
+                effort: "small",
+                risk: "low",
+            },
+        ]);
+        const ideas = parseDreamIdeas(raw);
+        expect(ideas).toHaveLength(1);
+        expect(ideas[0].title).toBe("MultiCurrencyAdapter");
+        expect(ideas[0].effort).toBe("small");
+    });
+    it("strips markdown fences and prose around the JSON", () => {
+        const raw = "Here are some ideas:\n```json\n" +
+            JSON.stringify([{ title: "X", pitch: "Y", precedents: [], effort: "medium", risk: "low" }]) +
+            "\n```\nLet me know if you want more.";
+        expect(parseDreamIdeas(raw)).toHaveLength(1);
+    });
+    it("returns [] on malformed JSON instead of throwing", () => {
+        expect(parseDreamIdeas("this is not json at all")).toEqual([]);
+        expect(parseDreamIdeas("[invalid, json,]")).toEqual([]);
+    });
+    it("filters out items without title or pitch", () => {
+        const raw = JSON.stringify([
+            { title: "Good", pitch: "yes" },
+            { title: "BadNoOitch" }, // missing pitch
+            { pitch: "no title" }, // missing title
+        ]);
+        const ideas = parseDreamIdeas(raw);
+        expect(ideas).toHaveLength(1);
+        expect(ideas[0].title).toBe("Good");
+    });
+    it("normalizes invalid effort/risk to defaults", () => {
+        const raw = JSON.stringify([
+            { title: "X", pitch: "y", effort: "extreme", risk: "🚨" },
+        ]);
+        const ideas = parseDreamIdeas(raw);
+        expect(ideas[0].effort).toBe("medium");
+        expect(ideas[0].risk).toBe("medium");
+    });
+    it("handles non-array input gracefully", () => {
+        expect(parseDreamIdeas('{"not": "array"}')).toEqual([]);
+    });
+});
+describe("heuristicDream — deterministic no-LLM fallback", () => {
+    it("returns up to N ideas", () => {
+        expect(heuristicDream(sampleSignals, 3).length).toBeLessThanOrEqual(3);
+        expect(heuristicDream(sampleSignals, 5).length).toBeLessThanOrEqual(5);
+    });
+    it("includes IncidentReplayHarness when incidents > 0", () => {
+        const ideas = heuristicDream(sampleSignals, 5);
+        expect(ideas.find((i) => i.title === "IncidentReplayHarness")).toBeDefined();
+    });
+    it("omits IncidentReplayHarness when incidents = 0", () => {
+        const noIncidents = { ...sampleSignals, totalIncidents: 0 };
+        const ideas = heuristicDream(noIncidents, 5);
+        expect(ideas.find((i) => i.title === "IncidentReplayHarness")).toBeUndefined();
+    });
+    it("uses the top pattern suffix in idea naming", () => {
+        const ideas = heuristicDream(sampleSignals, 5);
+        expect(ideas.some((i) => i.title.includes("Service"))).toBe(true);
+    });
+    it("every idea has the required fields populated", () => {
+        const ideas = heuristicDream(sampleSignals, 5);
+        for (const idea of ideas) {
+            expect(idea.title.length).toBeGreaterThan(0);
+            expect(idea.pitch.length).toBeGreaterThan(20);
+            expect(["small", "medium", "large"]).toContain(idea.effort);
+            expect(["low", "medium", "high"]).toContain(idea.risk);
+        }
+    });
+});
+//# sourceMappingURL=dream.test.js.map

package/dist/insights/dream.test.js.map

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

package/dist/insights/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Insights — high-level analyses on top of the indexed memory.
+ *
+ *   who-knows    — surface human experts on a topic
+ *   decisions    — auto-extract architectural decisions from commit text
+ *   stack-trace  — parse an error and find historical context for each frame
+ *   story        — narrate the evolution of a topic across acts
+ */
+export * from "./who-knows.js";
+export * from "./decisions.js";
+export * from "./stack-trace.js";
+export * from "./story.js";
+export * from "./dream.js";
+export * from "./suggest.js";
+export * from "./obsidian.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/insights/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/insights/index.js

@@ -0,0 +1,16 @@
+/**
+ * Insights — high-level analyses on top of the indexed memory.
+ *
+ *   who-knows    — surface human experts on a topic
+ *   decisions    — auto-extract architectural decisions from commit text
+ *   stack-trace  — parse an error and find historical context for each frame
+ *   story        — narrate the evolution of a topic across acts
+ */
+export * from "./who-knows.js";
+export * from "./decisions.js";
+export * from "./stack-trace.js";
+export * from "./story.js";
+export * from "./dream.js";
+export * from "./suggest.js";
+export * from "./obsidian.js";
+//# sourceMappingURL=index.js.map

package/dist/insights/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/insights/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/insights/obsidian.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Obsidian export — turn Mneme insights into a wiki-linked Markdown vault
+ * compatible with Obsidian's [[wiki-links]] + YAML frontmatter conventions.
+ *
+ * Why this exists: the "LLM Wiki" / "second brain" approach (Karpathy, et al.)
+ * pairs personal notes with linked knowledge. Mneme already extracts decisions,
+ * stories, and expert maps from git history — exporting them as an Obsidian
+ * vault lets users keep their code memory next to their personal notes.
+ *
+ * Pure functions only. No I/O. The CLI does the file writes.
+ *
+ * Output shape:
+ *   vault/
+ *     index.md                    ← top-level table
+ *     decisions/<filename>.md     ← one note per decision
+ *     authors/<name>.md           ← per-author backlink hub
+ *     story/<topic>.md            ← per-topic story timeline
+ */
+import type { ExtractedDecision } from "./decisions.js";
+import type { Story } from "./story.js";
+import type { ExpertCandidate } from "./who-knows.js";
+/** A logical "note" — caller writes filename → content to disk. */
+export interface VaultFile {
+    /** Relative path inside the vault, e.g. "decisions/2024-08-12-switched.md". */
+    path: string;
+    /** Full Markdown content including frontmatter. */
+    content: string;
+}
+export declare function decisionsToVault(decisions: ExtractedDecision[]): VaultFile[];
+export declare function storyToVault(story: Story, llmActSummaries?: Map<number, string>): VaultFile[];
+export declare function expertsToVault(topic: string, experts: ExpertCandidate[]): VaultFile[];
+/**
+ * Filesystem- and Obsidian-friendly slug. Lowercases, removes non-alnum
+ * except `-`, collapses whitespace and dashes.
+ */
+export declare function slug(s: string): string;
+/**
+ * Minimal Markdown-escape — only escapes pipe (table separator) and the
+ * Obsidian wiki-link delimiters that would corrupt rendering.
+ */
+export declare function escapeMd(s: string): string;
+//# sourceMappingURL=obsidian.d.ts.map

package/dist/insights/obsidian.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obsidian.d.ts","sourceRoot":"","sources":["../../src/insights/obsidian.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAY,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,mEAAmE;AACnE,MAAM,WAAW,SAAS;IACxB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,iBAAiB,EAAE,GAAG,SAAS,EAAE,CAwC5E;AA+GD,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAAE,CAmD7F;AAID,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,SAAS,EAAE,CA8BrF;AAID;;;GAGG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAQtC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK1C"}