mneme-ai 0.8.3

package/dist/commands/wisdom.js

@@ -0,0 +1,94 @@
+import kleur from "kleur";
+import { ui } from "../ui.js";
+import { MEDITATIONS, meditationByIndex, meditationOfTheDay, } from "../meditations.js";
+export async function wisdomCommand(opts) {
+    if (opts.all) {
+        if (opts.json) {
+            process.stdout.write(JSON.stringify(MEDITATIONS, null, 2) + "\n");
+            return 0;
+        }
+        for (let i = 0; i < MEDITATIONS.length; i++) {
+            printMeditation(MEDITATIONS[i], i + 1);
+            process.stdout.write("\n");
+        }
+        return 0;
+    }
+    let chosen;
+    if (opts.index !== undefined) {
+        const m = meditationByIndex(opts.index);
+        if (!m) {
+            ui.error(`No meditation #${opts.index}. Range is 1..${MEDITATIONS.length}.`);
+            return 1;
+        }
+        chosen = m;
+    }
+    else {
+        chosen = meditationOfTheDay();
+    }
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(chosen, null, 2) + "\n");
+        return 0;
+    }
+    const idx = MEDITATIONS.findIndex((m) => m.id === chosen.id) + 1;
+    printMeditation(chosen, idx);
+    process.stdout.write("\n" +
+        kleur.gray(`  see also:  mneme wisdom --all     ·     mneme wisdom -n <1..${MEDITATIONS.length}>     ·     mneme manifesto`) +
+        "\n");
+    return 0;
+}
+function printMeditation(m, n) {
+    const total = MEDITATIONS.length;
+    const lines = [];
+    lines.push("");
+    lines.push(kleur.magenta("  ╭───────────────────────────────────────────╮"));
+    lines.push(kleur.magenta("  │  ") +
+        kleur.gray(`meditation ${n} of ${total}`).padEnd(50, " ") +
+        kleur.magenta("│"));
+    lines.push(kleur.magenta("  ╰───────────────────────────────────────────╯"));
+    lines.push("");
+    lines.push(kleur.bold().cyan(`  ${m.title}`));
+    lines.push("");
+    for (const para of m.body.split("\n")) {
+        lines.push(`  ${kleur.white(wrap(para, 68, "  "))}`);
+    }
+    lines.push("");
+    lines.push(kleur.italic().yellow(`  — ${m.aphorism}`));
+    process.stdout.write(lines.join("\n") + "\n");
+}
+function wrap(s, width, indent) {
+    if (s.length <= width)
+        return s;
+    const words = s.split(" ");
+    const out = [];
+    let line = "";
+    for (const w of words) {
+        if ((line + " " + w).trimStart().length > width) {
+            out.push(line.trimStart());
+            line = indent + w;
+        }
+        else {
+            line += (line ? " " : "") + w;
+        }
+    }
+    if (line.trim())
+        out.push(line.trimStart());
+    return out.join("\n  ");
+}
+export async function manifestoCommand(opts) {
+    if (opts.json) {
+        process.stdout.write(JSON.stringify({ meditations: MEDITATIONS }, null, 2) + "\n");
+        return 0;
+    }
+    ui.banner();
+    process.stdout.write(kleur.bold().cyan("  Mneme — A Manifesto in Meditations") + "\n");
+    process.stdout.write(kleur.gray("  μνήμη was the Greek personification of memory, mother of the muses.\n" +
+        "  These are the principles that shape the tool that bears her name.\n") + "\n");
+    for (let i = 0; i < MEDITATIONS.length; i++) {
+        printMeditation(MEDITATIONS[i], i + 1);
+        process.stdout.write("\n");
+    }
+    process.stdout.write(kleur.gray("  ──\n") +
+        kleur.italic().gray("  Read more in MEDITATIONS.md, or ask a single one with `mneme wisdom`.\n"));
+    return 0;
+}
+//# sourceMappingURL=wisdom.js.map

package/dist/commands/wisdom.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,26 @@
+export interface MnemeConfig {
+    schemaVersion: number;
+    embeddings: {
+        provider: "auto" | "ollama" | "openai" | "hash";
+        model?: string;
+        baseUrl?: string;
+    };
+    index: {
+        since?: string;
+        maxCount?: number;
+    };
+    incidents?: {
+        sentry?: {
+            orgSlug: string;
+            projectId: string;
+        };
+        datadog?: {
+            site: string;
+        };
+    };
+    webPort?: number;
+}
+export declare const DEFAULT_CONFIG: MnemeConfig;
+export declare function readConfig(repoRoot: string): MnemeConfig;
+export declare function writeConfig(repoRoot: string, cfg: MnemeConfig): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;QAChD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,SAAS,CAAC,EAAE;QACV,MAAM,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;QAChD,OAAO,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KAC5B,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,cAAc,EAAE,WAK5B,CAAC;AAEF,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CASxD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAKpE"}

package/dist/config.js

@@ -0,0 +1,28 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { configPath, mnemeDir } from "./paths.js";
+export const DEFAULT_CONFIG = {
+    schemaVersion: 1,
+    embeddings: { provider: "auto" },
+    index: { maxCount: 5000 },
+    webPort: 4711,
+};
+export function readConfig(repoRoot) {
+    const path = configPath(repoRoot);
+    if (!existsSync(path))
+        return DEFAULT_CONFIG;
+    try {
+        const raw = readFileSync(path, "utf8");
+        return { ...DEFAULT_CONFIG, ...JSON.parse(raw) };
+    }
+    catch {
+        return DEFAULT_CONFIG;
+    }
+}
+export function writeConfig(repoRoot, cfg) {
+    const path = configPath(repoRoot);
+    mkdirSync(dirname(path), { recursive: true });
+    mkdirSync(mnemeDir(repoRoot), { recursive: true });
+    writeFileSync(path, JSON.stringify(cfg, null, 2), "utf8");
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAoBlD,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,aAAa,EAAE,CAAC;IAChB,UAAU,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE;IAChC,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;IACzB,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,cAAc,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvC,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,cAAc,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,GAAgB;IAC5D,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAC5D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export declare function run(argv: string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiCA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyZvD"}

package/dist/index.js

@@ -0,0 +1,371 @@
+import { Command } from "commander";
+import { initCommand } from "./commands/init.js";
+import { indexCommand } from "./commands/index-cmd.js";
+import { askCommand } from "./commands/ask.js";
+import { whyCommand } from "./commands/why.js";
+import { statusCommand } from "./commands/status.js";
+import { correlateCommand } from "./commands/correlate.js";
+import { mcpCommand } from "./commands/mcp.js";
+import { wisdomCommand, manifestoCommand } from "./commands/wisdom.js";
+import { entitiesCommand, clonesCommand } from "./commands/clones.js";
+import { healCommand } from "./commands/heal.js";
+import { echoCommand } from "./commands/echo.js";
+import { palimpsestCommand } from "./commands/palimpsest.js";
+import { runawayCommand, mirrorCommand, rumorCommand, fossilCommand, ledgerCommand, } from "./commands/wild-features.js";
+import { oracleCommand, genomeCommand, dialogueCommand, tributeCommand, } from "./commands/wild-stubs.js";
+import { conscienceCommand } from "./commands/conscience.js";
+import { teachCommand } from "./commands/teach.js";
+import { blastCommand } from "./commands/blast.js";
+import { adaptCommand } from "./commands/adapt.js";
+import { geniusCommand } from "./commands/genius.js";
+import { ui } from "./ui.js";
+export async function run(argv) {
+    const program = new Command()
+        .name("mneme")
+        .description("μνήμη — the memory layer of your codebase. Knows the WHY, the WHAT, the WHERE-IT-BREAKS.")
+        .version("0.8.3");
+    program
+        .command("init")
+        .description("Initialize Mneme in the current repo")
+        .option("--force", "overwrite existing config", false)
+        .action(async (opts) => {
+        process.exit(await initCommand({ cwd: process.cwd(), force: opts.force }));
+    });
+    program
+        .command("index")
+        .description("Index commits, PRs, and embeddings")
+        .option("--since <date>", "only index commits since this date (e.g. 2024-01-01)")
+        .option("--max <n>", "maximum number of commits", (v) => Number(v))
+        .option("--embedder <kind>", "auto | ollama | openai | hash", "auto")
+        .option("--model <name>", "embedding model name override")
+        .action(async (opts) => {
+        process.exit(await indexCommand({
+            cwd: process.cwd(),
+            since: opts.since,
+            maxCount: opts.max,
+            embedder: opts.embedder,
+            model: opts.model,
+        }));
+    });
+    program
+        .command("ask <question...>")
+        .description("Ask the memory: \"why does payment.ts use try/catch?\"")
+        .option("-k, --top-k <n>", "number of results", (v) => Number(v), 8)
+        .option("--json", "machine-readable JSON output", false)
+        .action(async (qParts, opts) => {
+        process.exit(await askCommand({
+            cwd: process.cwd(),
+            question: qParts.join(" "),
+            topK: opts.topK,
+            json: opts.json,
+        }));
+    });
+    program
+        .command("why <target>")
+        .description("Why does this exist? Pass file:line, file:start-end, or just file")
+        .option("-k, --top-k <n>", "related commits to fetch", (v) => Number(v), 5)
+        .action(async (target, opts) => {
+        process.exit(await whyCommand({ cwd: process.cwd(), target, topK: opts.topK }));
+    });
+    program
+        .command("status")
+        .description("Show memory + repo status")
+        .action(async () => {
+        process.exit(await statusCommand({ cwd: process.cwd() }));
+    });
+    program
+        .command("correlate")
+        .description("Correlate incidents with commits (pager / manual JSON)")
+        .option("--source <kind>", "incident source: pager | manual")
+        .option("--org <slug>", "org slug (with --source pager)")
+        .option("--project <slug>", "project slug (with --source pager)")
+        .option("--base-url <url>", "base URL for self-hosted observability")
+        .option("--file <path>", "JSON file path (with --source manual)")
+        .option("--since <iso>", "only incidents/commits since this date")
+        .option("--until <iso>", "only incidents/commits until this date")
+        .option("--window-days <n>", "correlation window in days", (v) => Number(v), 7)
+        .option("--threshold <n>", "minimum confidence (0..1)", (v) => Number(v), 0.3)
+        .option("--top <n>", "top-N rows", (v) => Number(v), 20)
+        .option("--json", "machine-readable output", false)
+        .action(async (opts) => {
+        process.exit(await correlateCommand({
+            cwd: process.cwd(),
+            source: opts.source,
+            org: opts.org,
+            project: opts.project,
+            baseUrl: opts.baseUrl,
+            file: opts.file,
+            since: opts.since,
+            until: opts.until,
+            windowDays: opts.windowDays,
+            threshold: opts.threshold,
+            topN: opts.top,
+            json: opts.json,
+        }));
+    });
+    program
+        .command("mcp")
+        .description("Run as an MCP server (for Claude Code, Cursor, Continue, etc.)")
+        .action(async () => {
+        process.exit(await mcpCommand({ cwd: process.cwd() }));
+    });
+    program
+        .command("entities")
+        .description("Phase 2 — parse and embed every function/class/type in tracked TS/JS files")
+        .action(async () => {
+        process.exit(await entitiesCommand({ cwd: process.cwd() }));
+    });
+    program
+        .command("clones")
+        .description("Phase 2 — find semantic clones (functions doing the same thing)")
+        .option("-t, --threshold <n>", "cosine threshold (0..1), default 0.85", (v) => Number(v))
+        .option("-N, --top <n>", "show top-N clusters, default 20", (v) => Number(v), 20)
+        .option("--json", "machine-readable JSON output", false)
+        .action(async (opts) => {
+        process.exit(await clonesCommand({
+            cwd: process.cwd(),
+            threshold: opts.threshold,
+            topN: opts.top,
+            json: opts.json,
+        }));
+    });
+    program
+        .command("heal")
+        .description("Synthesize WHY notes for commits with poor messages (turns bad history into searchable memory)")
+        .option("--max <n>", "max commits to heal in this run", (v) => Number(v), 100)
+        .option("--subject-min-len <n>", "subjects shorter than this are candidates", (v) => Number(v), 20)
+        .option("--dry-run", "list candidates without calling the LLM", false)
+        .option("--provider <kind>", "auto | ollama | openai", "auto")
+        .option("--model <name>", "override model name (e.g. llama3.2:1b, gpt-4o-mini)")
+        .option("--force", "re-heal commits that already have a synthesized note", false)
+        .action(async (opts) => {
+        process.exit(await healCommand({
+            cwd: process.cwd(),
+            max: opts.max,
+            subjectMinLen: opts.subjectMinLen,
+            dryRun: opts.dryRun,
+            provider: opts.provider,
+            model: opts.model,
+            force: opts.force,
+        }));
+    });
+    program
+        .command("wisdom")
+        .description("Print a meditation from the Mneme manifesto (rotates daily)")
+        .option("-n, --num <n>", "show a specific meditation by number (1..13)", (v) => Number(v))
+        .option("--all", "print every meditation", false)
+        .option("--json", "machine-readable JSON output", false)
+        .action(async (opts) => {
+        process.exit(await wisdomCommand({ index: opts.num, all: opts.all, json: opts.json }));
+    });
+    program
+        .command("manifesto")
+        .description("Print the full Mneme manifesto — every meditation, in order")
+        .option("--json", "machine-readable JSON output", false)
+        .action(async (opts) => {
+        process.exit(await manifestoCommand(opts));
+    });
+    // ─── WILD ideas — see WILD_IDEAS.md ───
+    program
+        .command("echo")
+        .description("WILD #2 — find past incidents that resemble the current one")
+        .option("--id <id>", "stored incident id (e.g. \"sentry:12345\")")
+        .option("--query <text>", "freeform incident description")
+        .option("--top <n>", "top-N most similar", (v) => Number(v), 5)
+        .option("--json", "machine-readable output", false)
+        .action(async (opts) => {
+        process.exit(await echoCommand({
+            cwd: process.cwd(),
+            id: opts.id,
+            query: opts.query,
+            topK: opts.top,
+            json: opts.json,
+        }));
+    });
+    program
+        .command("palimpsest <target>")
+        .description("WILD #5 — render the causal chain of a single line of code")
+        .option("--max-depth <n>", "how deep to walk the chain", (v) => Number(v), 8)
+        .option("--json", "machine-readable output", false)
+        .action(async (target, opts) => {
+        process.exit(await palimpsestCommand({
+            cwd: process.cwd(),
+            target,
+            maxDepth: opts.maxDepth,
+            json: opts.json,
+        }));
+    });
+    program
+        .command("runaway")
+        .description("WILD #14 — files that have grown silently across many commits")
+        .option("--top <n>", "show top-N", (v) => Number(v), 15)
+        .option("--json", "machine-readable output", false)
+        .action(async (opts) => {
+        process.exit(await runawayCommand({ cwd: process.cwd(), topN: opts.top, json: opts.json }));
+    });
+    program
+        .command("mirror")
+        .description("WILD #13 — onboarding dossier (5 PRs, 3 people, 2 incidents)")
+        .option("--top-prs <n>", "top PRs", (v) => Number(v), 5)
+        .option("--top-people <n>", "top contributors", (v) => Number(v), 3)
+        .option("--top-incidents <n>", "top incidents", (v) => Number(v), 2)
+        .option("--json", "machine-readable output", false)
+        .action(async (opts) => {
+        process.exit(await mirrorCommand({
+            cwd: process.cwd(),
+            topPrs: opts.topPrs,
+            topPeople: opts.topPeople,
+            topIncidents: opts.topIncidents,
+            json: opts.json,
+        }));
+    });
+    program
+        .command("rumor")
+        .description("WILD #12 — tribal phrases mentioned in commits but no doc explains")
+        .option("--min-mentions <n>", "phrase must appear in this many commits", (v) => Number(v), 4)
+        .option("--json", "machine-readable output", false)
+        .action(async (opts) => {
+        process.exit(await rumorCommand({
+            cwd: process.cwd(),
+            minMentions: opts.minMentions,
+            json: opts.json,
+        }));
+    });
+    program
+        .command("fossil")
+        .description("WILD #10 — files deleted from HEAD but still alive in git history")
+        .option("--top <n>", "show top-N", (v) => Number(v), 20)
+        .option("--json", "machine-readable output", false)
+        .action(async (opts) => {
+        process.exit(await fossilCommand({ cwd: process.cwd(), topN: opts.top, json: opts.json }));
+    });
+    program
+        .command("ledger")
+        .description("WILD #3 — tamper-evident audit log for compliance (SOX/SOC2)")
+        .option("--since <iso>", "start date")
+        .option("--until <iso>", "end date")
+        .option("--format <kind>", "json | csv", "json")
+        .option("--out <path>", "write to file instead of stdout")
+        .action(async (opts) => {
+        process.exit(await ledgerCommand({
+            cwd: process.cwd(),
+            since: opts.since,
+            until: opts.until,
+            format: opts.format,
+            out: opts.out,
+        }));
+    });
+    // ─── Stubs (planned features — print design when invoked) ───
+    program
+        .command("oracle")
+        .description("WILD #4 — historical risk analysis on a snippet (planned)")
+        .action(async () => {
+        process.exit(await oracleCommand());
+    });
+    program
+        .command("conscience [files...]")
+        .description("WILD #6 — review co-pilot: risk-score a PR against your repo's own history")
+        .option("--diff-file <path>", "read a unified diff from this file")
+        .option("--stdin", "read a unified diff from stdin", false)
+        .option("--recency-days <n>", "consider commits within this window", (v) => Number(v), 365)
+        .option("--top <n>", "top-N similar past commits", (v) => Number(v), 8)
+        .option("--json", "machine-readable output", false)
+        .action(async (files, opts) => {
+        process.exit(await conscienceCommand({
+            cwd: process.cwd(),
+            files,
+            diffFile: opts.diffFile,
+            stdin: opts.stdin,
+            recencyDays: opts.recencyDays,
+            topN: opts.top,
+            json: opts.json,
+        }));
+    });
+    program
+        .command("blast <commit>")
+        .description("Predict incidents likely to follow shipping <commit> (blast radius)")
+        .option("--window-hours <n>", "post-deploy window for base rate", (v) => Number(v), 48)
+        .option("--json", "machine-readable output", false)
+        .action(async (commit, opts) => {
+        process.exit(await blastCommand({
+            cwd: process.cwd(),
+            commit,
+            windowHours: opts.windowHours,
+            json: opts.json,
+        }));
+    });
+    program
+        .command("adapt")
+        .description("Mutant mode — inspect this repo and recommend the next 1-3 commands")
+        .option("--json", "machine-readable output", false)
+        .action(async (opts) => {
+        process.exit(await adaptCommand({ cwd: process.cwd(), json: opts.json }));
+    });
+    program
+        .command("genius <question...>")
+        .description("AI agent — plans and runs multi-step Mneme workflows to answer hard questions")
+        .option("--max-steps <n>", "cap on tool steps in the plan", (v) => Number(v), 4)
+        .option("--provider <kind>", "auto | ollama | openai", "auto")
+        .option("--model <name>", "override LLM model name")
+        .option("--trace", "print raw tool outputs while running", false)
+        .option("--json", "machine-readable output", false)
+        .action(async (qParts, opts) => {
+        process.exit(await geniusCommand({
+            cwd: process.cwd(),
+            question: qParts.join(" "),
+            maxSteps: opts.maxSteps,
+            provider: opts.provider,
+            model: opts.model,
+            trace: opts.trace,
+            json: opts.json,
+        }));
+    });
+    program
+        .command("teach <target>")
+        .description("Explain a folder or file in plain language (layer classification + LLM summary)")
+        .option("--provider <kind>", "auto | ollama | openai", "auto")
+        .option("--model <name>", "override model name")
+        .option("--json", "machine-readable output", false)
+        .action(async (target, opts) => {
+        process.exit(await teachCommand({
+            cwd: process.cwd(),
+            target,
+            provider: opts.provider,
+            model: opts.model,
+            json: opts.json,
+        }));
+    });
+    program
+        .command("genome")
+        .description("WILD #9 — codebase fingerprint + ancestry (planned)")
+        .action(async () => {
+        process.exit(await genomeCommand());
+    });
+    program
+        .command("dialogue")
+        .description("WILD #11 — conversational chat over your repo (planned)")
+        .action(async () => {
+        process.exit(await dialogueCommand());
+    });
+    program
+        .command("tribute")
+        .description("WILD #15 — your codebase as a 60-sec movie (planned)")
+        .action(async () => {
+        process.exit(await tributeCommand());
+    });
+    program.exitOverride((err) => {
+        if (err.code === "commander.help" || err.code === "commander.helpDisplayed")
+            process.exit(0);
+        if (err.code === "commander.version")
+            process.exit(0);
+        process.exit(err.exitCode ?? 1);
+    });
+    try {
+        await program.parseAsync(argv);
+    }
+    catch (err) {
+        ui.error(err.message);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/meditations.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Meditations — short, quotable teachings about codebase memory.
+ *
+ * Each meditation has three parts:
+ *   - title:  one short phrase (the koan)
+ *   - body:   2-4 sentences of context
+ *   - aphorism: a single tweetable line (the takeaway)
+ *
+ * Meditations are addressed by index for `mneme wisdom --n <N>` and selected
+ * deterministically by date for `mneme wisdom` (one-per-day rhythm — different
+ * teaching each day, same teaching all day).
+ */
+export interface Meditation {
+    id: string;
+    title: string;
+    body: string;
+    aphorism: string;
+}
+export declare const MEDITATIONS: Meditation[];
+/** Pick a meditation deterministically — same teaching all day, new one tomorrow. */
+export declare function meditationOfTheDay(now?: Date): Meditation;
+export declare function meditationByIndex(n: number): Meditation | undefined;
+export declare function meditationById(id: string): Meditation | undefined;
+//# sourceMappingURL=meditations.d.ts.map

package/dist/meditations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meditations.d.ts","sourceRoot":"","sources":["../src/meditations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,WAAW,EAAE,UAAU,EAyGnC,CAAC;AAEF,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,IAAiB,GAAG,UAAU,CAIrE;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAGnE;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAEjE"}