@mneme-ai/core 0.8.4 → 0.9.0

package/dist/insights/obsidian.js

@@ -0,0 +1,263 @@
+/**
+ * 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
+ */
+// ─── Decisions → Obsidian ───────────────────────────────────────────────
+export function decisionsToVault(decisions) {
+    if (decisions.length === 0) {
+        return [
+            {
+                path: "index.md",
+                content: indexHeader() + "\n_No decisions extracted yet._\n",
+            },
+        ];
+    }
+    const files = [];
+    // 1. One note per decision.
+    for (const d of decisions) {
+        files.push({
+            path: `decisions/${decisionFilename(d)}.md`,
+            content: decisionNoteContent(d),
+        });
+    }
+    // 2. Author hub notes — one per distinct author, with backlinks.
+    const byAuthor = new Map();
+    for (const d of decisions) {
+        if (!byAuthor.has(d.author))
+            byAuthor.set(d.author, []);
+        byAuthor.get(d.author).push(d);
+    }
+    for (const [author, list] of byAuthor) {
+        files.push({
+            path: `authors/${slug(author)}.md`,
+            content: authorHubContent(author, list),
+        });
+    }
+    // 3. Top-level index.
+    files.push({
+        path: "index.md",
+        content: decisionsIndexContent(decisions),
+    });
+    return files;
+}
+function indexHeader() {
+    return [
+        "---",
+        "type: mneme-vault",
+        `generated: ${new Date().toISOString()}`,
+        "---",
+        "",
+        "# Mneme Vault — Architecture Decisions",
+        "",
+    ].join("\n");
+}
+function decisionsIndexContent(decisions) {
+    const lines = [indexHeader()];
+    lines.push("This vault was auto-extracted from git history by [Mneme](https://github.com/patsa2561-art/mneme-ai).");
+    lines.push("");
+    lines.push(`**${decisions.length} decisions** across **${new Set(decisions.map((d) => d.author)).size} authors**.`);
+    lines.push("");
+    lines.push("## Recent decisions");
+    lines.push("");
+    lines.push("| Date | Decision | Source |");
+    lines.push("|---|---|---|");
+    for (const d of decisions.slice(0, 50)) {
+        const link = `[[decisions/${decisionFilename(d)}|${escapeMd(d.summary)}]]`;
+        const author = `[[authors/${slug(d.author)}|${escapeMd(d.author)}]]`;
+        lines.push(`| ${d.date} | ${link} | ${author} \\| \`${d.shortHash}\` |`);
+    }
+    lines.push("");
+    lines.push("## By author");
+    lines.push("");
+    const authors = new Map();
+    for (const d of decisions)
+        authors.set(d.author, (authors.get(d.author) ?? 0) + 1);
+    for (const [a, n] of [...authors.entries()].sort((x, y) => y[1] - x[1])) {
+        lines.push(`- [[authors/${slug(a)}|${escapeMd(a)}]] — ${n} decision${n === 1 ? "" : "s"}`);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+function decisionNoteContent(d) {
+    const tags = [`decisions/${d.kind}`, `author/${slug(d.author)}`].map((t) => `  - ${t}`).join("\n");
+    const lines = [
+        "---",
+        `date: ${d.date}`,
+        `author: ${escapeMd(d.author)}`,
+        `kind: ${d.kind}`,
+        `confidence: ${d.confidence}`,
+        `commit: ${d.shortHash}`,
+        "tags:",
+        tags,
+        "---",
+        "",
+        `# ${escapeMd(d.summary)}`,
+        "",
+    ];
+    if (d.rationale) {
+        lines.push(`> **Rationale:** ${escapeMd(d.rationale)}`);
+        lines.push("");
+    }
+    lines.push("## Source");
+    lines.push("");
+    lines.push(`- **Author:** [[authors/${slug(d.author)}|${escapeMd(d.author)}]]`);
+    lines.push(`- **Date:** ${d.date}`);
+    lines.push(`- **Commit:** \`${d.shortHash}\``);
+    lines.push(`- **Pattern:** \`${d.kind}\` (confidence ${d.confidence.toFixed(2)})`);
+    lines.push("");
+    lines.push("---");
+    lines.push("");
+    lines.push("← [[index|Back to index]]");
+    lines.push("");
+    return lines.join("\n");
+}
+function authorHubContent(author, decisions) {
+    const lines = [
+        "---",
+        `type: author`,
+        `name: ${escapeMd(author)}`,
+        `decisionCount: ${decisions.length}`,
+        "---",
+        "",
+        `# ${escapeMd(author)}`,
+        "",
+        `${decisions.length} architectural decision${decisions.length === 1 ? "" : "s"} attributed to ${escapeMd(author)} via git history.`,
+        "",
+        "## Decisions",
+        "",
+    ];
+    for (const d of decisions) {
+        lines.push(`- ${d.date} — [[decisions/${decisionFilename(d)}|${escapeMd(d.summary)}]] \`${d.shortHash}\``);
+    }
+    lines.push("");
+    lines.push("---");
+    lines.push("");
+    lines.push("← [[index|Back to index]]");
+    lines.push("");
+    return lines.join("\n");
+}
+function decisionFilename(d) {
+    // Obsidian-friendly: date-prefix + kind + slug of summary, kept short.
+    const summarySlug = slug(d.summary).slice(0, 60);
+    return `${d.date}-${d.kind}-${summarySlug}`;
+}
+// ─── Story → Obsidian ───────────────────────────────────────────────────
+export function storyToVault(story, llmActSummaries) {
+    if (story.acts.length === 0) {
+        return [
+            {
+                path: `story-${slug(story.topic)}.md`,
+                content: `---\ntype: mneme-story\ntopic: ${escapeMd(story.topic)}\n---\n\n# The ${escapeMd(story.topic)} Story\n\n_No commits matched this topic._\n`,
+            },
+        ];
+    }
+    const lines = [
+        "---",
+        "type: mneme-story",
+        `topic: ${escapeMd(story.topic)}`,
+        `acts: ${story.acts.length}`,
+        `commits: ${story.totalCommits}`,
+        `spanDays: ${story.spanDays}`,
+        `generated: ${new Date().toISOString()}`,
+        "tags:",
+        "  - mneme/story",
+        `  - topic/${slug(story.topic)}`,
+        "---",
+        "",
+        `# The ${escapeMd(story.topic)} Story`,
+        "",
+        `**${story.acts.length} acts · ${story.totalCommits} commits · ${story.spanDays} days**`,
+        "",
+    ];
+    story.acts.forEach((act, i) => {
+        lines.push(`## ${escapeMd(act.title)}`);
+        lines.push("");
+        lines.push(`_${act.fromDate} → ${act.toDate}_`);
+        lines.push("");
+        const summary = llmActSummaries?.get(i);
+        if (summary) {
+            lines.push(`> ${summary.replace(/\n/g, " ")}`);
+            lines.push("");
+        }
+        for (const c of act.commits) {
+            lines.push(`- ${c.authorDate.slice(0, 10)} — \`${c.shortHash || c.hash.slice(0, 7)}\` ${escapeMd(c.subject)} _(${escapeMd(c.authorName)})_`);
+        }
+        lines.push("");
+    });
+    lines.push("---");
+    lines.push("");
+    lines.push("_Generated by [Mneme](https://github.com/patsa2561-art/mneme-ai) — `mneme story " + story.topic + " --format obsidian`_");
+    lines.push("");
+    return [{ path: `story-${slug(story.topic)}.md`, content: lines.join("\n") }];
+}
+// ─── Experts (who-knows) → Obsidian ─────────────────────────────────────
+export function expertsToVault(topic, experts) {
+    if (experts.length === 0) {
+        return [
+            {
+                path: `experts-${slug(topic)}.md`,
+                content: `---\ntype: mneme-experts\ntopic: ${escapeMd(topic)}\n---\n\n# Experts on ${escapeMd(topic)}\n\n_No experts found._\n`,
+            },
+        ];
+    }
+    const lines = [
+        "---",
+        "type: mneme-experts",
+        `topic: ${escapeMd(topic)}`,
+        `count: ${experts.length}`,
+        `generated: ${new Date().toISOString()}`,
+        "tags:",
+        `  - mneme/experts`,
+        `  - topic/${slug(topic)}`,
+        "---",
+        "",
+        `# Top experts on ${escapeMd(topic)}`,
+        "",
+        "| Tier | Name | Commits | Files | Last touch |",
+        "|---|---|---|---|---|",
+    ];
+    for (const e of experts) {
+        lines.push(`| ${e.tier} | [[authors/${slug(e.name)}|${escapeMd(e.name)}]] | ${e.commitCount} | ${e.filesTouched} | ${e.lastTouch.slice(0, 10)} |`);
+    }
+    lines.push("");
+    return [{ path: `experts-${slug(topic)}.md`, content: lines.join("\n") }];
+}
+// ─── helpers ────────────────────────────────────────────────────────────
+/**
+ * Filesystem- and Obsidian-friendly slug. Lowercases, removes non-alnum
+ * except `-`, collapses whitespace and dashes.
+ */
+export function slug(s) {
+    return s
+        .toLowerCase()
+        .replace(/[^\w\s-]/g, "")
+        .replace(/\s+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "")
+        .slice(0, 80);
+}
+/**
+ * Minimal Markdown-escape — only escapes pipe (table separator) and the
+ * Obsidian wiki-link delimiters that would corrupt rendering.
+ */
+export function escapeMd(s) {
+    return s
+        .replace(/\|/g, "\\|")
+        .replace(/\[\[/g, "[ [")
+        .replace(/\]\]/g, "] ]");
+}
+//# sourceMappingURL=obsidian.js.map

package/dist/insights/obsidian.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"obsidian.js","sourceRoot":"","sources":["../../src/insights/obsidian.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAcH,2EAA2E;AAE3E,MAAM,UAAU,gBAAgB,CAAC,SAA8B;IAC7D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO;YACL;gBACE,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,WAAW,EAAE,GAAG,mCAAmC;aAC7D;SACF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,4BAA4B;IAC5B,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,aAAa,gBAAgB,CAAC,CAAC,CAAC,KAAK;YAC3C,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC;SAChC,CAAC,CAAC;IACL,CAAC;IAED,iEAAiE;IACjE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;YAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACxD,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,WAAW,IAAI,CAAC,MAAM,CAAC,KAAK;YAClC,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC;SACxC,CAAC,CAAC;IACL,CAAC;IAED,sBAAsB;IACtB,KAAK,CAAC,IAAI,CAAC;QACT,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,qBAAqB,CAAC,SAAS,CAAC;KAC1C,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW;IAClB,OAAO;QACL,KAAK;QACL,mBAAmB;QACnB,cAAc,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;QACxC,KAAK;QACL,EAAE;QACF,wCAAwC;QACxC,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,qBAAqB,CAAC,SAA8B;IAC3D,MAAM,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9B,KAAK,CAAC,IAAI,CAAC,uGAAuG,CAAC,CAAC;IACpH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,MAAM,yBAAyB,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC;IACpH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,eAAe,gBAAgB,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QAC3E,MAAM,MAAM,GAAG,aAAa,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,IAAI,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC;IAC3E,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,SAAS;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACnF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,mBAAmB,CAAC,CAAoB;IAC/C,MAAM,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,EAAE,UAAU,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnG,MAAM,KAAK,GAAG;QACZ,KAAK;QACL,SAAS,CAAC,CAAC,IAAI,EAAE;QACjB,WAAW,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;QAC/B,SAAS,CAAC,CAAC,IAAI,EAAE;QACjB,eAAe,CAAC,CAAC,UAAU,EAAE;QAC7B,WAAW,CAAC,CAAC,SAAS,EAAE;QACxB,OAAO;QACP,IAAI;QACJ,KAAK;QACL,EAAE;QACF,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE;QAC1B,EAAE;KACH,CAAC;IAEF,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,oBAAoB,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChF,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACnF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc,EAAE,SAA8B;IACtE,MAAM,KAAK,GAAG;QACZ,KAAK;QACL,cAAc;QACd,SAAS,QAAQ,CAAC,MAAM,CAAC,EAAE;QAC3B,kBAAkB,SAAS,CAAC,MAAM,EAAE;QACpC,KAAK;QACL,EAAE;QACF,KAAK,QAAQ,CAAC,MAAM,CAAC,EAAE;QACvB,EAAE;QACF,GAAG,SAAS,CAAC,MAAM,0BAA0B,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,kBAAkB,QAAQ,CAAC,MAAM,CAAC,mBAAmB;QACnI,EAAE;QACF,cAAc;QACd,EAAE;KACH,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,kBAAkB,gBAAgB,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;IAC7G,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,gBAAgB,CAAC,CAAoB;IAC5C,uEAAuE;IACvE,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjD,OAAO,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC;AAC9C,CAAC;AAED,2EAA2E;AAE3E,MAAM,UAAU,YAAY,CAAC,KAAY,EAAE,eAAqC;IAC9E,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL;gBACE,IAAI,EAAE,SAAS,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK;gBACrC,OAAO,EAAE,kCAAkC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,kBAAkB,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,8CAA8C;aACtJ;SACF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAa;QACtB,KAAK;QACL,mBAAmB;QACnB,UAAU,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QACjC,SAAS,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE;QAC5B,YAAY,KAAK,CAAC,YAAY,EAAE;QAChC,aAAa,KAAK,CAAC,QAAQ,EAAE;QAC7B,cAAc,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;QACxC,OAAO;QACP,iBAAiB;QACjB,aAAa,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;QAChC,KAAK;QACL,EAAE;QACF,SAAS,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ;QACtC,EAAE;QACF,KAAK,KAAK,CAAC,IAAI,CAAC,MAAM,WAAW,KAAK,CAAC,YAAY,cAAc,KAAK,CAAC,QAAQ,SAAS;QACxF,EAAE;KACH,CAAC;IAEF,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAC5B,KAAK,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,MAAM,OAAO,GAAG,eAAe,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QACxC,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/I,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kFAAkF,GAAG,KAAK,CAAC,KAAK,GAAG,sBAAsB,CAAC,CAAC;IACtI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,2EAA2E;AAE3E,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,OAA0B;IACtE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL;gBACE,IAAI,EAAE,WAAW,IAAI,CAAC,KAAK,CAAC,KAAK;gBACjC,OAAO,EAAE,oCAAoC,QAAQ,CAAC,KAAK,CAAC,yBAAyB,QAAQ,CAAC,KAAK,CAAC,2BAA2B;aAChI;SACF,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG;QACZ,KAAK;QACL,qBAAqB;QACrB,UAAU,QAAQ,CAAC,KAAK,CAAC,EAAE;QAC3B,UAAU,OAAO,CAAC,MAAM,EAAE;QAC1B,cAAc,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;QACxC,OAAO;QACP,mBAAmB;QACnB,aAAa,IAAI,CAAC,KAAK,CAAC,EAAE;QAC1B,KAAK;QACL,EAAE;QACF,oBAAoB,QAAQ,CAAC,KAAK,CAAC,EAAE;QACrC,EAAE;QACF,gDAAgD;QAChD,uBAAuB;KACxB,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,gBAAgB,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,MAAM,CAAC,CAAC,YAAY,MAAM,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IACrJ,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,2EAA2E;AAE3E;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,CAAS;IAC5B,OAAO,CAAC;SACL,WAAW,EAAE;SACb,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACxB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,CAAS;IAChC,OAAO,CAAC;SACL,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC;SACvB,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC7B,CAAC"}

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

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

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

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

package/dist/insights/obsidian.test.js

@@ -0,0 +1,241 @@
+import { describe, it, expect } from "vitest";
+import { decisionsToVault, storyToVault, expertsToVault, slug, escapeMd, } from "./obsidian.js";
+const decision = (overrides = {}) => ({
+    commitHash: "abcdef1234567890abcdef1234567890abcdef12",
+    shortHash: "abcdef1",
+    date: "2024-08-12",
+    author: "Alice",
+    summary: "switched from passport to JWT",
+    rationale: "compliance flagged session storage",
+    kind: "switched",
+    confidence: 0.9,
+    ...overrides,
+});
+describe("slug", () => {
+    it("lowercases and collapses whitespace", () => {
+        expect(slug("Hello World")).toBe("hello-world");
+    });
+    it("strips non-word characters", () => {
+        expect(slug("decided to use Map!")).toBe("decided-to-use-map");
+    });
+    it("collapses multiple dashes", () => {
+        expect(slug("foo - - bar")).toBe("foo-bar");
+    });
+    it("trims leading/trailing dashes", () => {
+        expect(slug("--hello--")).toBe("hello");
+    });
+    it("caps at 80 chars", () => {
+        expect(slug("a".repeat(200)).length).toBeLessThanOrEqual(80);
+    });
+});
+describe("escapeMd", () => {
+    it("escapes pipe characters (table separator)", () => {
+        expect(escapeMd("foo|bar")).toBe("foo\\|bar");
+    });
+    it("breaks wiki-link delimiters that would corrupt rendering", () => {
+        expect(escapeMd("see [[other]]")).not.toContain("[[");
+        expect(escapeMd("see [[other]]")).not.toContain("]]");
+    });
+    it("preserves normal text", () => {
+        expect(escapeMd("ordinary commit subject")).toBe("ordinary commit subject");
+    });
+});
+describe("decisionsToVault — empty case", () => {
+    it("returns a single index file when no decisions", () => {
+        const files = decisionsToVault([]);
+        expect(files).toHaveLength(1);
+        expect(files[0].path).toBe("index.md");
+        expect(files[0].content).toContain("No decisions extracted");
+    });
+});
+describe("decisionsToVault — full case", () => {
+    it("emits one note per decision plus authors plus index", () => {
+        const decisions = [
+            decision({ author: "Alice", summary: "A" }),
+            decision({ author: "Alice", summary: "B" }),
+            decision({ author: "Bob", summary: "C" }),
+        ];
+        const files = decisionsToVault(decisions);
+        const decisionFiles = files.filter((f) => f.path.startsWith("decisions/"));
+        const authorFiles = files.filter((f) => f.path.startsWith("authors/"));
+        const indexFiles = files.filter((f) => f.path === "index.md");
+        expect(decisionFiles).toHaveLength(3); // one per decision
+        expect(authorFiles).toHaveLength(2); // 2 distinct authors
+        expect(indexFiles).toHaveLength(1);
+    });
+    it("each decision note has YAML frontmatter with date, author, kind, confidence", () => {
+        const files = decisionsToVault([decision()]);
+        const note = files.find((f) => f.path.startsWith("decisions/"));
+        expect(note.content).toMatch(/^---\n/);
+        expect(note.content).toContain("date: 2024-08-12");
+        expect(note.content).toContain("author: Alice");
+        expect(note.content).toContain("kind: switched");
+        expect(note.content).toContain("confidence: 0.9");
+        expect(note.content).toContain("commit: abcdef1");
+    });
+    it("decision note links back to the author hub", () => {
+        const files = decisionsToVault([decision({ author: "Alice" })]);
+        const note = files.find((f) => f.path.startsWith("decisions/"));
+        expect(note.content).toContain("[[authors/alice|Alice]]");
+    });
+    it("decision note shows rationale when present", () => {
+        const files = decisionsToVault([decision({ rationale: "compliance reasons" })]);
+        const note = files.find((f) => f.path.startsWith("decisions/"));
+        expect(note.content).toContain("Rationale");
+        expect(note.content).toContain("compliance reasons");
+    });
+    it("author hub lists all decisions for that author", () => {
+        const decisions = [
+            decision({ author: "Alice", summary: "A1", date: "2024-01-01" }),
+            decision({ author: "Alice", summary: "A2", date: "2024-02-01" }),
+        ];
+        const files = decisionsToVault(decisions);
+        const hub = files.find((f) => f.path === "authors/alice.md");
+        expect(hub.content).toContain("A1");
+        expect(hub.content).toContain("A2");
+        expect(hub.content).toContain("decisionCount: 2");
+    });
+    it("index.md contains a wiki-linked table of recent decisions", () => {
+        const files = decisionsToVault([decision({ summary: "use Postgres" })]);
+        const index = files.find((f) => f.path === "index.md");
+        expect(index.content).toContain("[[decisions/");
+        expect(index.content).toContain("use Postgres");
+    });
+    it("filenames are filesystem- and Obsidian-safe", () => {
+        const tricky = decision({ summary: "decided to use C++ / Rust!" });
+        const files = decisionsToVault([tricky]);
+        for (const f of files) {
+            expect(f.path).not.toMatch(/[/\\:*?"<>|]/g.source.replace(/\//g, ""));
+            // No spaces in filenames (Obsidian works fine with them, but slugs are cleaner).
+            expect(f.path.split("/").pop()).not.toContain(" ");
+        }
+    });
+});
+describe("storyToVault", () => {
+    const sampleStory = {
+        topic: "authentication",
+        totalCommits: 3,
+        spanDays: 90,
+        acts: [
+            {
+                id: "initial",
+                title: "Act I — The Beginning",
+                fromDate: "2024-01-01",
+                toDate: "2024-01-01",
+                commits: [
+                    {
+                        hash: "a1",
+                        shortHash: "a1",
+                        authorName: "alice",
+                        authorEmail: "a@x",
+                        authorDate: "2024-01-01T00:00:00Z",
+                        committerDate: "2024-01-01T00:00:00Z",
+                        subject: "feat: passport",
+                        body: "",
+                        parents: [],
+                        files: [],
+                    },
+                ],
+            },
+            {
+                id: "refactor",
+                title: "Act II — The Refactor",
+                fromDate: "2024-02-01",
+                toDate: "2024-04-01",
+                commits: [
+                    {
+                        hash: "b1",
+                        shortHash: "b1",
+                        authorName: "alice",
+                        authorEmail: "a@x",
+                        authorDate: "2024-02-01T00:00:00Z",
+                        committerDate: "2024-02-01T00:00:00Z",
+                        subject: "refactor: replace passport",
+                        body: "",
+                        parents: [],
+                        files: [],
+                    },
+                ],
+            },
+        ],
+    };
+    it("returns a single .md file for a story", () => {
+        const files = storyToVault(sampleStory);
+        expect(files).toHaveLength(1);
+        expect(files[0].path).toBe("story-authentication.md");
+    });
+    it("includes frontmatter with topic, acts, commits, spanDays", () => {
+        const files = storyToVault(sampleStory);
+        const c = files[0].content;
+        expect(c).toContain("type: mneme-story");
+        expect(c).toContain("topic: authentication");
+        expect(c).toContain("acts: 2");
+        expect(c).toContain("commits: 3");
+        expect(c).toContain("spanDays: 90");
+    });
+    it("renders each act as a heading + commit list", () => {
+        const c = storyToVault(sampleStory)[0].content;
+        expect(c).toContain("## Act I");
+        expect(c).toContain("## Act II");
+        expect(c).toContain("feat: passport");
+        expect(c).toContain("refactor: replace passport");
+    });
+    it("includes LLM act summaries when provided", () => {
+        const summaries = new Map([
+            [0, "Started with passport.js OAuth"],
+            [1, "Replaced passport with custom JWT"],
+        ]);
+        const c = storyToVault(sampleStory, summaries)[0].content;
+        expect(c).toContain("Started with passport.js");
+        expect(c).toContain("Replaced passport");
+    });
+    it("falls back to a clean note when story has no acts", () => {
+        const empty = { topic: "x", totalCommits: 0, spanDays: 0, acts: [] };
+        const files = storyToVault(empty);
+        expect(files[0].content).toContain("No commits matched");
+    });
+});
+describe("expertsToVault", () => {
+    const sampleExperts = [
+        {
+            name: "Alice",
+            email: "a@x",
+            commitCount: 20,
+            filesTouched: 50,
+            lastTouch: "2026-04-01T00:00:00Z",
+            score: 4.0,
+            tier: "definitive",
+        },
+        {
+            name: "Bob",
+            email: "b@x",
+            commitCount: 5,
+            filesTouched: 12,
+            lastTouch: "2025-12-01T00:00:00Z",
+            score: 1.5,
+            tier: "stale",
+        },
+    ];
+    it("returns a single experts note", () => {
+        const files = expertsToVault("stripe", sampleExperts);
+        expect(files).toHaveLength(1);
+        expect(files[0].path).toBe("experts-stripe.md");
+    });
+    it("renders a markdown table with tier, name, counts, last touch", () => {
+        const c = expertsToVault("stripe", sampleExperts)[0].content;
+        expect(c).toContain("| Tier | Name | Commits | Files | Last touch |");
+        expect(c).toContain("definitive");
+        expect(c).toContain("Alice");
+        expect(c).toContain("20");
+    });
+    it("links each name to the author hub", () => {
+        const c = expertsToVault("stripe", sampleExperts)[0].content;
+        expect(c).toContain("[[authors/alice|Alice]]");
+        expect(c).toContain("[[authors/bob|Bob]]");
+    });
+    it("falls back to a friendly note when no experts found", () => {
+        const c = expertsToVault("nothing", [])[0].content;
+        expect(c).toContain("No experts found");
+    });
+});
+//# sourceMappingURL=obsidian.test.js.map

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

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

package/dist/insights/stack-trace.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `stack-trace` — given an error / stack trace, find the commits that
+ * touched each frame and any past incidents at the same locations.
+ *
+ * Why this exists: when a prod bug fires, the most useful question is
+ * "have we seen this here before?" Mneme already indexes git + incidents.
+ * Parsing a stack trace and querying both is a small composition of pieces
+ * we already have.
+ *
+ * Supported formats (frame parser):
+ *   - JS/TS:  "    at functionName (path/to/file.ts:42:15)"
+ *   - Python: "  File "path/to/file.py", line 42, in functionName"
+ *   - Go:     "goroutine 1 [running]: ... path/to/file.go:42 +0x..."
+ *   - Java:   "    at com.example.Foo.bar(Foo.java:42)"
+ *
+ * Pure parsing — no I/O. Composing with retrieval lives in the CLI command.
+ */
+export interface StackFrame {
+    /** File path as it appears in the trace. May be absolute, relative, or module-qualified. */
+    file: string;
+    /** Line number where the frame is. 0 when absent. */
+    line: number;
+    /** Function/method name when extractable; may be empty. */
+    function?: string;
+    /** Programming language detected from the frame format. */
+    language: "js" | "python" | "go" | "java" | "unknown";
+}
+/**
+ * Parse a multi-line stack trace into ordered frames. Frames are deduped
+ * when the same (file, line) appears consecutively. Languages that share
+ * patterns (e.g. .ts files might also match the python file regex if
+ * weirdly formatted) are disambiguated by extension first.
+ */
+export declare function parseStackTrace(text: string): StackFrame[];
+/**
+ * Heuristic: detect whether the trace appears to be from a particular
+ * language. Useful when displaying frame analysis ("Python traceback").
+ */
+export declare function detectLanguage(text: string): StackFrame["language"];
+//# sourceMappingURL=stack-trace.d.ts.map

package/dist/insights/stack-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-trace.d.ts","sourceRoot":"","sources":["../../src/insights/stack-trace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,UAAU;IACzB,4FAA4F;IAC5F,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,QAAQ,EAAE,IAAI,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;CACvD;AA2DD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAyB1D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CASnE"}