mneme-ai 0.8.3

package/dist/commands/teach.js

@@ -0,0 +1,237 @@
+/**
+ * `mneme teach` — explain a folder or file in plain language.
+ *
+ * Inspiration: tools like Understand-Anything turn codebases into "knowledge
+ * graphs" they then *teach*. Mneme already has the indexing primitives. The
+ * remaining piece was a small command that synthesizes a short, honest
+ * summary from the entities + git context — using the same LLM enricher
+ * shipped for `mneme heal`.
+ *
+ * Three passes (a small "agent pipeline" without ceremony):
+ *   1. CLASSIFY — assign each entity a layer (api / service / data / ui /
+ *      utility / unknown) using path heuristics.
+ *   2. AGGREGATE — count by layer + sample names.
+ *   3. SUMMARIZE — let the LLM write 3-5 sentences of plain prose.
+ *
+ * For a single file: the LLM gets the file's source + a short list of its
+ * entities and writes a paragraph. For a folder: the aggregate counts +
+ * 10 representative entity names and writes the summary.
+ */
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import kleur from "kleur";
+import { git, store } from "@mneme-ai/core";
+import { resolveEnricher } from "@mneme-ai/embeddings";
+import { dbPath } from "../paths.js";
+import { ui } from "../ui.js";
+// Order matters: more specific rules come first.
+// Tests checked first because `core/tests/foo.ts` is "first and foremost" a test,
+// even though it lives under a service-like folder.
+const LAYER_RULES = [
+    { layer: "test", pattern: /(^|\/)(tests?|__tests__|specs?)(\/|$)/ },
+    { layer: "config", pattern: /(\.config\.|^config\/|\/config\/)/ },
+    { layer: "api", pattern: /(^|\/)(api|routes?|controllers?|handlers?|endpoints?|server)(\/|$)/ },
+    { layer: "service", pattern: /(^|\/)(services?|business|domain|usecases?|core)(\/|$)/ },
+    { layer: "data", pattern: /(^|\/)(repositor(y|ies)|store|stores|db|database|models?|data)(\/|$)/ },
+    { layer: "ui", pattern: /(^|\/)(ui|components?|views?|pages?|screens?|app)(\/|$)/ },
+    { layer: "utility", pattern: /(^|\/)(util|utils|helpers?|lib|common|shared)(\/|$)/ },
+];
+function classifyLayer(filePath) {
+    const p = filePath.toLowerCase();
+    for (const r of LAYER_RULES) {
+        if (r.pattern.test(p))
+            return r.layer;
+    }
+    if (/\.(test|spec)\./.test(p))
+        return "test";
+    return "unknown";
+}
+export async function teachCommand(opts) {
+    if (!(await git.isGitRepo(opts.cwd))) {
+        ui.error("Not in a git repo. Run `mneme init` first.");
+        return 1;
+    }
+    const meta = await git.getRepoMeta(opts.cwd);
+    const targetPath = join(meta.rootPath, opts.target);
+    if (!existsSync(targetPath)) {
+        ui.error(`No such path: ${opts.target}`);
+        return 1;
+    }
+    const isDir = statSync(targetPath).isDirectory();
+    const s = new store.MnemeStore(dbPath(meta.rootPath));
+    ui.banner();
+    process.stdout.write(`${kleur.bold().cyan("Teach")}  ${opts.target} ${kleur.gray(`(${isDir ? "folder" : "file"})`)}\n\n`);
+    // 1. CLASSIFY — pull entities under this path and tag layers.
+    const allEntities = loadEntitiesUnder(s, opts.target);
+    const layered = allEntities.map((e) => ({ ...e, layer: classifyLayer(e.filePath) }));
+    // 2. AGGREGATE
+    const layerCounts = new Map();
+    for (const e of layered) {
+        layerCounts.set(e.layer, (layerCounts.get(e.layer) ?? 0) + 1);
+    }
+    const sortedLayers = Array.from(layerCounts.entries()).sort((a, b) => b[1] - a[1]);
+    process.stdout.write(`${kleur.bold().magenta("Layers")}\n`);
+    if (sortedLayers.length === 0) {
+        process.stdout.write(`  ${kleur.gray("(no entities indexed under this path — run `mneme entities`)")}\n`);
+    }
+    for (const [layer, n] of sortedLayers) {
+        process.stdout.write(`  ${kleur.gray("·")} ${kleur.bold(layer.padEnd(8))}  ${n}\n`);
+    }
+    process.stdout.write("\n");
+    // 3. SUMMARIZE — call the enricher.
+    let enricher;
+    try {
+        enricher = await resolveEnricher({
+            provider: opts.provider ?? "auto",
+            model: opts.model,
+        });
+    }
+    catch (err) {
+        ui.warn(`No enricher available: ${err.message}`);
+        ui.dim("Install Ollama (recommended): https://ollama.com");
+        ui.dim("Then pull a small chat model: ollama pull llama3.2:1b");
+        if (opts.json) {
+            process.stdout.write(JSON.stringify({ target: opts.target, layers: Object.fromEntries(layerCounts) }, null, 2) + "\n");
+        }
+        s.close();
+        return 0;
+    }
+    const prompt = isDir
+        ? buildFolderPrompt(opts.target, layered, sortedLayers)
+        : buildFilePrompt(opts.target, targetPath, layered);
+    ui.step("teaching", `${enricher.name} …`);
+    let summary = "";
+    try {
+        const out = await enricher.enrich({
+            system: TEACH_SYSTEM_PROMPT,
+            user: prompt,
+            temperature: 0.2,
+            maxTokens: 280,
+        });
+        summary = out.text;
+    }
+    catch (err) {
+        ui.warn(`Enricher failed: ${err.message}`);
+        s.close();
+        return 1;
+    }
+    if (opts.json) {
+        process.stdout.write(JSON.stringify({
+            target: opts.target,
+            isDir,
+            entityCount: layered.length,
+            layers: Object.fromEntries(layerCounts),
+            summary,
+        }, null, 2) + "\n");
+        s.close();
+        return 0;
+    }
+    process.stdout.write(`\n${kleur.bold().magenta("Summary")}\n`);
+    for (const line of wrap(summary, 78).split("\n")) {
+        process.stdout.write(`  ${line}\n`);
+    }
+    process.stdout.write("\n" +
+        kleur.gray(`  generated by ${enricher.name} · entities are layer-tagged via path heuristics`) +
+        "\n");
+    s.close();
+    return 0;
+}
+const TEACH_SYSTEM_PROMPT = `You are explaining a folder or file from a codebase to a new contributor.
+Write 3-5 sentences in plain prose. No bullet lists. No markdown.
+
+Rules:
+1. Refer ONLY to entities and signatures that the user provided. Do not invent names.
+2. Open with what the unit DOES (its purpose), not what it IS.
+3. Mention the dominant layer (api / service / data / ui / utility) if obvious.
+4. If you don't know enough to answer, say "Cannot determine purpose from the listed entities alone."
+5. Avoid filler ("This file...", "Here we have..."). Open with the inferred purpose.
+
+Output ONLY the summary. No preamble.`;
+function loadEntitiesUnder(s, target) {
+    const norm = target.replace(/\\/g, "/").replace(/^\.\//, "");
+    // Use both equality and prefix match for files vs dirs.
+    const rows = s.db
+        .prepare(`SELECT id, kind, name, file_path, start_line, end_line, signature, language
+       FROM entities
+       WHERE file_path = ? OR file_path LIKE ?
+       ORDER BY file_path ASC, start_line ASC`)
+        .all(norm, norm.endsWith("/") ? norm + "%" : norm + "/%");
+    return rows.map((r) => ({
+        id: String(r.id),
+        kind: r.kind,
+        name: String(r.name),
+        filePath: String(r.file_path),
+        startLine: Number(r.start_line),
+        endLine: Number(r.end_line),
+        signature: r.signature ? String(r.signature) : undefined,
+        language: String(r.language),
+    }));
+}
+function buildFolderPrompt(target, layered, layerCounts) {
+    const lines = [];
+    lines.push(`Folder: ${target}`);
+    lines.push(`Total entities: ${layered.length}`);
+    lines.push(`Layers: ${layerCounts.map(([l, n]) => `${l}=${n}`).join(", ")}`);
+    lines.push("");
+    lines.push("Sample entities (top 12 by alphabet):");
+    for (const e of layered.slice(0, 12)) {
+        const sig = e.signature ? ` — ${e.signature.slice(0, 80)}` : "";
+        lines.push(`  - [${e.kind}] ${e.name} (${e.filePath}:${e.startLine})${sig}`);
+    }
+    return lines.join("\n");
+}
+function buildFilePrompt(target, absPath, layered) {
+    const lines = [];
+    lines.push(`File: ${target}`);
+    let source = "";
+    try {
+        source = readFileSync(absPath, "utf8");
+    }
+    catch {
+        // ignore
+    }
+    if (source.length > 0 && source.length < 4000) {
+        lines.push("");
+        lines.push("Source:");
+        lines.push(source);
+    }
+    else if (source.length >= 4000) {
+        lines.push("");
+        lines.push("Source (first 4000 chars):");
+        lines.push(source.slice(0, 4000));
+        lines.push("…(truncated)");
+    }
+    if (layered.length) {
+        lines.push("");
+        lines.push("Indexed entities:");
+        for (const e of layered) {
+            const sig = e.signature ? ` — ${e.signature.slice(0, 80)}` : "";
+            lines.push(`  - [${e.kind}] ${e.name} (line ${e.startLine})${sig}`);
+        }
+    }
+    return lines.join("\n");
+}
+function wrap(s, width) {
+    const out = [];
+    for (const para of s.split(/\n+/)) {
+        let line = "";
+        for (const word of para.split(/\s+/)) {
+            if ((line + " " + word).trim().length > width && line) {
+                out.push(line);
+                line = word;
+            }
+            else {
+                line += (line ? " " : "") + word;
+            }
+        }
+        if (line.trim())
+            out.push(line);
+        out.push("");
+    }
+    return out.join("\n").trim();
+}
+/**
+ * Exported for testing — pure helper, no I/O.
+ */
+export const _classifyLayer = classifyLayer;
+//# sourceMappingURL=teach.js.map

package/dist/commands/teach.js.map

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

package/dist/commands/teach.test.d.ts

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

package/dist/commands/teach.test.d.ts.map

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

package/dist/commands/teach.test.js

@@ -0,0 +1,44 @@
+import { describe, it, expect } from "vitest";
+import { _classifyLayer } from "./teach.js";
+describe("classifyLayer", () => {
+    it("tags route/handler folders as 'api'", () => {
+        expect(_classifyLayer("src/api/users.ts")).toBe("api");
+        expect(_classifyLayer("server/routes/checkout.ts")).toBe("api");
+        expect(_classifyLayer("backend/handlers/webhook.ts")).toBe("api");
+        expect(_classifyLayer("src/controllers/order.ts")).toBe("api");
+    });
+    it("tags service/domain/usecase as 'service'", () => {
+        expect(_classifyLayer("src/services/payment.ts")).toBe("service");
+        expect(_classifyLayer("backend/domain/order.ts")).toBe("service");
+        expect(_classifyLayer("src/usecases/charge.ts")).toBe("service");
+    });
+    it("tags repos/db/models as 'data'", () => {
+        expect(_classifyLayer("src/repositories/user.ts")).toBe("data");
+        expect(_classifyLayer("backend/db/orders.ts")).toBe("data");
+        expect(_classifyLayer("src/models/cart.ts")).toBe("data");
+    });
+    it("tags components/views/screens as 'ui'", () => {
+        expect(_classifyLayer("src/ui/Button.tsx")).toBe("ui");
+        expect(_classifyLayer("src/components/Header.tsx")).toBe("ui");
+        expect(_classifyLayer("src/screens/Home.tsx")).toBe("ui");
+        expect(_classifyLayer("app/login.tsx")).toBe("ui");
+    });
+    it("tags utils/helpers/lib as 'utility'", () => {
+        expect(_classifyLayer("src/utils/format.ts")).toBe("utility");
+        expect(_classifyLayer("backend/lib/logger.ts")).toBe("utility");
+        expect(_classifyLayer("common/helpers.ts")).toBe("utility");
+    });
+    it("tags test paths as 'test'", () => {
+        expect(_classifyLayer("packages/core/tests/something.ts")).toBe("test");
+        expect(_classifyLayer("src/__tests__/foo.ts")).toBe("test");
+        expect(_classifyLayer("src/foo.test.ts")).toBe("test");
+    });
+    it("falls back to 'unknown' for unfamiliar paths", () => {
+        expect(_classifyLayer("random/foo.ts")).toBe("unknown");
+        expect(_classifyLayer("a/b/c.ts")).toBe("unknown");
+    });
+    it("is case-insensitive", () => {
+        expect(_classifyLayer("SRC/SERVICES/Foo.ts")).toBe("service");
+    });
+});
+//# sourceMappingURL=teach.test.js.map

package/dist/commands/teach.test.js.map

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

package/dist/commands/why.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `mneme why <file>[:<line>[-<line>]]`
+ *
+ * Combines blame + RAG to answer: "why does this code exist?"
+ */
+export interface WhyOptions {
+    cwd: string;
+    target: string;
+    topK?: number;
+}
+export declare function whyCommand(opts: WhyOptions): Promise<number>;
+//# sourceMappingURL=why.d.ts.map

package/dist/commands/why.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"why.d.ts","sourceRoot":"","sources":["../../src/commands/why.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA4ElE"}

package/dist/commands/why.js

@@ -0,0 +1,85 @@
+import { git, retrieve, store } from "@mneme-ai/core";
+import { resolveEmbedder } from "@mneme-ai/embeddings";
+import { dbPath } from "../paths.js";
+import { readConfig } from "../config.js";
+import { ui } from "../ui.js";
+import kleur from "kleur";
+export async function whyCommand(opts) {
+    if (!(await git.isGitRepo(opts.cwd))) {
+        ui.error("Not in a git repo. Run `mneme init` first.");
+        return 1;
+    }
+    const { file, startLine, endLine } = parseTarget(opts.target);
+    const meta = await git.getRepoMeta(opts.cwd);
+    const cfg = readConfig(meta.rootPath);
+    ui.banner();
+    process.stdout.write(`${kleur.bold().cyan("Why")} ${file}` + (startLine ? `:${startLine}${endLine ? `-${endLine}` : ""}` : "") + "\n\n");
+    const blamed = await git.blame(meta.rootPath, file, startLine, endLine);
+    if (!blamed.length) {
+        ui.warn("No blame data (file may be untracked or path wrong).");
+        return 1;
+    }
+    const tally = new Map();
+    for (const b of blamed) {
+        const cur = tally.get(b.commitHash);
+        if (cur)
+            cur.count++;
+        else
+            tally.set(b.commitHash, { count: 1, sample: b.content });
+    }
+    const ranked = Array.from(tally.entries())
+        .sort((a, b) => b[1].count - a[1].count)
+        .slice(0, 5);
+    process.stdout.write(`${kleur.bold().magenta("Originating commits")}\n`);
+    const s = new store.MnemeStore(dbPath(meta.rootPath));
+    for (const [hash, { count }] of ranked) {
+        const c = s.getCommit(hash);
+        if (!c) {
+            process.stdout.write(`  ${kleur.gray("●")} ${hash.slice(0, 8)}  ${kleur.gray("(not indexed)")}\n`);
+            continue;
+        }
+        const date = c.authorDate.slice(0, 10);
+        process.stdout.write(`  ${kleur.green("●")} ${kleur.bold(c.shortHash)} ${kleur.gray(`[${date} · ${c.authorName} · ${count} lines]`)}\n`);
+        process.stdout.write(`    ${c.subject}\n`);
+    }
+    if (s.countChunks() > 0) {
+        const embedder = await resolveEmbedder({
+            provider: cfg.embeddings.provider,
+            model: cfg.embeddings.model,
+            baseUrl: cfg.embeddings.baseUrl,
+        });
+        const seedQuery = ranked
+            .map(([h]) => s.getCommit(h)?.subject)
+            .filter(Boolean)
+            .join("\n");
+        if (seedQuery.trim()) {
+            const related = await retrieve.search(seedQuery, {
+                store: s,
+                embedder,
+                repo: meta,
+                topK: opts.topK ?? 5,
+            });
+            const filtered = related.filter((r) => !tally.has(r.commit.hash));
+            if (filtered.length) {
+                process.stdout.write(`\n${kleur.bold().magenta("Semantically related")}\n`);
+                for (const r of filtered.slice(0, 5)) {
+                    const c = r.commit;
+                    process.stdout.write(`  ${kleur.cyan("◆")} ${kleur.bold(c.shortHash)} ${kleur.gray(`[${c.authorDate.slice(0, 10)}]`)}  ${c.subject}\n`);
+                }
+            }
+        }
+    }
+    s.close();
+    return 0;
+}
+function parseTarget(s) {
+    const m = s.match(/^(.+?)(?::(\d+)(?:-(\d+))?)?$/);
+    if (!m)
+        return { file: s };
+    return {
+        file: m[1],
+        startLine: m[2] ? Number(m[2]) : undefined,
+        endLine: m[3] ? Number(m[3]) : m[2] ? Number(m[2]) : undefined,
+    };
+}
+//# sourceMappingURL=why.js.map

package/dist/commands/why.js.map

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

package/dist/commands/wild-features.d.ts

@@ -0,0 +1,42 @@
+export interface RunawayCommandOptions {
+    cwd: string;
+    topN?: number;
+    json?: boolean;
+}
+export declare function runawayCommand(opts: RunawayCommandOptions): Promise<number>;
+export interface MirrorCommandOptions {
+    cwd: string;
+    topPrs?: number;
+    topPeople?: number;
+    topIncidents?: number;
+    json?: boolean;
+}
+export declare function mirrorCommand(opts: MirrorCommandOptions): Promise<number>;
+export interface RumorCommandOptions {
+    cwd: string;
+    minMentions?: number;
+    json?: boolean;
+}
+export declare function rumorCommand(opts: RumorCommandOptions): Promise<number>;
+export interface FossilCommandOptions {
+    cwd: string;
+    topN?: number;
+    json?: boolean;
+}
+export declare function fossilCommand(opts: FossilCommandOptions): Promise<number>;
+export interface LedgerCommandOptions {
+    cwd: string;
+    since?: string;
+    until?: string;
+    format?: "json" | "csv";
+    out?: string;
+}
+/**
+ * `mneme ledger` — tamper-evident audit log derived from git history.
+ *
+ * For regulated industries (banks, exchanges, healthcare): every commit + author
+ * + linked ticket gets a hash-chained entry. Tampering with any entry breaks
+ * the chain — auditors can verify integrity in seconds.
+ */
+export declare function ledgerCommand(opts: LedgerCommandOptions): Promise<number>;
+//# sourceMappingURL=wild-features.d.ts.map

package/dist/commands/wild-features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wild-features.d.ts","sourceRoot":"","sources":["../../src/commands/wild-features.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkEjF;AAID,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqG/E;AAID,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwD7E;AAgFD,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0F/E;AAID,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAuBD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuH/E"}