mneme-ai 0.8.3

package/dist/meditations.js

@@ -0,0 +1,120 @@
+/**
+ * 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 const MEDITATIONS = [
+    {
+        id: "memory-vs-intelligence",
+        title: "On Memory and Intelligence",
+        body: "An intelligence without memory is just guessing in a loop. The Greeks knew this — they made μνήμη the mother of the muses, not their student.\n" +
+            "Every AI assistant you use today is a Mnemosyne with amnesia.",
+        aphorism: "Intelligence is the spark; memory is the fuel.",
+    },
+    {
+        id: "what-vs-why",
+        title: "On What and Why",
+        body: "A passing test never told anyone why it had to exist. A green check on CI does not explain the bug it was born to prevent.\n" +
+            "Source code tells the present. Git tells the past. Most engineering questions are really asking about the past.",
+        aphorism: "Code answers what. Git answers why. Hold both.",
+    },
+    {
+        id: "commits-as-gifts",
+        title: "On Commits as Gifts",
+        body: "Every commit message is a letter to the engineer who reads it six months from now. That engineer might be a colleague — and might be you.\n" +
+            "The cost of writing a good commit message is two minutes. The cost of decoding a bad one is two hours, multiplied by everyone who ever needs to.",
+        aphorism: "A commit message is the cheapest gift you can leave your future self.",
+    },
+    {
+        id: "hallucination",
+        title: "On Hallucination",
+        body: "When an AI assistant cannot see why a piece of code exists, it does not say so. It guesses. The guess sounds plausible because plausibility is what language models optimize.\n" +
+            "Hallucination is not a bug in the model. It is the absence of context, dressed up as confidence.",
+        aphorism: "An AI without memory is a confident liar by default.",
+    },
+    {
+        id: "two-stage-retrieval",
+        title: "On Two-Stage Retrieval",
+        body: "First-stage search casts a wide net. The right answer is somewhere in the top fifty. Then a reranker takes those fifty and finds the top three.\n" +
+            "Recall is not the same as precision. Casting wide and then choosing well beats trying to do both in one shot.",
+        aphorism: "Recall first. Precision second. Never both at once.",
+    },
+    {
+        id: "garbage-in",
+        title: "On Garbage In",
+        body: "If your commit history is `wip`, `update`, `fix`, `update again` — Mneme will tell you so, in the form of empty answers.\n" +
+            "We do not invent reasons. We surface what was recorded. Some teams discover, on first use, that their history says nothing. That itself is the lesson.",
+        aphorism: "A tool that refuses to lie is more useful than a tool that always answers.",
+    },
+    {
+        id: "bus-factor",
+        title: "On the Bus Factor",
+        body: "The bus factor is not really about people leaving. It is about knowledge that never made it into the repository in the first place.\n" +
+            "Mneme cannot save what was never written. But it can make legible everything that was — which is more than most teams realize.",
+        aphorism: "What is written can be read. What was never written is gone.",
+    },
+    {
+        id: "palimpsest",
+        title: "On the Palimpsest",
+        body: "A palimpsest is a manuscript scraped clean and written over, again and again. Every codebase is one. Each new decision is ink on top of an older decision, on top of an older one still.\n" +
+            "Your present file is the surface. Mneme reads every layer beneath.",
+        aphorism: "Every line of code stands on the bones of older lines.",
+    },
+    {
+        id: "speed",
+        title: "On Speed",
+        body: "Sub-second answers do not come from a smarter model. They come from giving the model less to read.\n" +
+            "When a question takes ten seconds to answer, nine of those seconds are usually noise the assistant was forced to scan.",
+        aphorism: "Speed is not a smarter model. It is less noise.",
+    },
+    {
+        id: "expensive-bug",
+        title: "On the Most Expensive Bug",
+        body: "The most expensive bug is the one you fix without remembering why it existed. The patch lands. The original constraint is forgotten. Six months later, someone undoes the fix because it looks like dead code, and the bug returns — now harder, because nobody remembers it ever was a bug.\n" +
+            "Mneme is not a debugger. It is a counterweight to that forgetting.",
+        aphorism: "A fix without context is a future bug with extra steps.",
+    },
+    {
+        id: "honest-no",
+        title: "On the Honest No",
+        body: "Most retrieval systems are pressured into answering. Even when they shouldn't. Even when the right answer is silence.\n" +
+            "Mneme tries hard to say `no relevant context found` when that is the truth. A tool that admits its limits is one you can trust at its claims.",
+        aphorism: "An honest no is worth a thousand confident maybes.",
+    },
+    {
+        id: "knowing-when-not",
+        title: "On Knowing When Not To Use This",
+        body: "Mneme is not a substitute for reading code. It is not a substitute for asking a colleague. It is not an oracle.\n" +
+            "It is a way to compress thirty minutes of git archaeology into thirty seconds — when the answer is in git. When it is not, the right move is to close the laptop and walk to a desk.",
+        aphorism: "The tool ends where the conversation begins.",
+    },
+    {
+        id: "convex-combination",
+        title: "On the Convex Combination",
+        body: "A correlation engine that saturates at 1.0 cannot rank anything that scores 1.0. The math forces a choice — keep the constraint, lose the signal, or weight the inputs so the sum stays in bounds.\n" +
+            "Most retrieval failures are math failures wearing the costume of intelligence.",
+        aphorism: "Choose your convex combinations. The shape of your math becomes the shape of your answers.",
+    },
+];
+/** Pick a meditation deterministically — same teaching all day, new one tomorrow. */
+export function meditationOfTheDay(now = new Date()) {
+    // Days since unix epoch (UTC) → stable index regardless of timezone.
+    const day = Math.floor(now.getTime() / (24 * 60 * 60 * 1000));
+    return MEDITATIONS[day % MEDITATIONS.length];
+}
+export function meditationByIndex(n) {
+    if (!Number.isFinite(n) || n < 1 || n > MEDITATIONS.length)
+        return undefined;
+    return MEDITATIONS[n - 1];
+}
+export function meditationById(id) {
+    return MEDITATIONS.find((m) => m.id === id);
+}
+//# sourceMappingURL=meditations.js.map

package/dist/meditations.js.map

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

package/dist/meditations.test.d.ts

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

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

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

package/dist/meditations.test.js

@@ -0,0 +1,70 @@
+import { describe, it, expect } from "vitest";
+import { MEDITATIONS, meditationOfTheDay, meditationByIndex, meditationById, } from "./meditations.js";
+describe("MEDITATIONS canon", () => {
+    it("has at least 10 meditations", () => {
+        expect(MEDITATIONS.length).toBeGreaterThanOrEqual(10);
+    });
+    it("every meditation has id, title, body, aphorism", () => {
+        for (const m of MEDITATIONS) {
+            expect(m.id).toBeTruthy();
+            expect(m.title).toBeTruthy();
+            expect(m.body.length).toBeGreaterThan(20);
+            expect(m.aphorism).toBeTruthy();
+        }
+    });
+    it("ids are unique", () => {
+        const ids = MEDITATIONS.map((m) => m.id);
+        expect(new Set(ids).size).toBe(ids.length);
+    });
+    it("aphorisms are all under 140 chars (tweetable)", () => {
+        for (const m of MEDITATIONS) {
+            expect(m.aphorism.length).toBeLessThanOrEqual(140);
+        }
+    });
+});
+describe("meditationOfTheDay", () => {
+    it("returns a meditation", () => {
+        const m = meditationOfTheDay();
+        expect(m).toBeDefined();
+        expect(m.title).toBeTruthy();
+    });
+    it("is deterministic — same day → same meditation", () => {
+        const d = new Date("2026-05-04T10:00:00Z");
+        expect(meditationOfTheDay(d).id).toBe(meditationOfTheDay(d).id);
+    });
+    it("changes day-to-day", () => {
+        // Find at least two consecutive days that produce different meditations.
+        const day1 = new Date("2026-05-04T00:00:00Z");
+        const seen = new Set();
+        for (let i = 0; i < MEDITATIONS.length + 1; i++) {
+            const d = new Date(day1.getTime() + i * 24 * 60 * 60 * 1000);
+            seen.add(meditationOfTheDay(d).id);
+        }
+        expect(seen.size).toBe(MEDITATIONS.length);
+    });
+    it("is timezone-stable for the same UTC day", () => {
+        const morning = new Date("2026-05-04T01:00:00Z");
+        const evening = new Date("2026-05-04T23:00:00Z");
+        expect(meditationOfTheDay(morning).id).toBe(meditationOfTheDay(evening).id);
+    });
+});
+describe("meditationByIndex", () => {
+    it("returns 1-indexed entries", () => {
+        expect(meditationByIndex(1)?.id).toBe(MEDITATIONS[0].id);
+        expect(meditationByIndex(MEDITATIONS.length)?.id).toBe(MEDITATIONS[MEDITATIONS.length - 1].id);
+    });
+    it("returns undefined for out-of-range", () => {
+        expect(meditationByIndex(0)).toBeUndefined();
+        expect(meditationByIndex(MEDITATIONS.length + 1)).toBeUndefined();
+        expect(meditationByIndex(NaN)).toBeUndefined();
+    });
+});
+describe("meditationById", () => {
+    it("finds by id", () => {
+        expect(meditationById("memory-vs-intelligence")?.title).toContain("Memory");
+    });
+    it("returns undefined for unknown id", () => {
+        expect(meditationById("nope")).toBeUndefined();
+    });
+});
+//# sourceMappingURL=meditations.test.js.map

package/dist/meditations.test.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,7 @@
+export declare const MNEME_DIR = ".mneme";
+export declare const DB_FILENAME = "mneme.db";
+export declare const CONFIG_FILENAME = "config.json";
+export declare function mnemeDir(repoRoot: string): string;
+export declare function dbPath(repoRoot: string): string;
+export declare function configPath(repoRoot: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,WAAW,CAAC;AAClC,eAAO,MAAM,WAAW,aAAa,CAAC;AACtC,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/paths.js

@@ -0,0 +1,14 @@
+import { join } from "node:path";
+export const MNEME_DIR = ".mneme";
+export const DB_FILENAME = "mneme.db";
+export const CONFIG_FILENAME = "config.json";
+export function mnemeDir(repoRoot) {
+    return join(repoRoot, MNEME_DIR);
+}
+export function dbPath(repoRoot) {
+    return join(mnemeDir(repoRoot), DB_FILENAME);
+}
+export function configPath(repoRoot) {
+    return join(mnemeDir(repoRoot), CONFIG_FILENAME);
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC;AAClC,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AACtC,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAE7C,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,OAAO,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,QAAgB;IACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC,CAAC;AACnD,CAAC"}

package/dist/ui.d.ts

@@ -0,0 +1,12 @@
+export declare const ui: {
+    banner: () => void;
+    info: (msg: string) => boolean;
+    success: (msg: string) => boolean;
+    warn: (msg: string) => boolean;
+    error: (msg: string) => boolean;
+    dim: (msg: string) => boolean;
+    step: (label: string, msg: string) => boolean;
+    raw: (msg: string) => boolean;
+};
+export declare function formatProgress(current: number, total: number, width?: number): string;
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,EAAE;;gBAYD,MAAM;mBACH,MAAM;gBACT,MAAM;iBACL,MAAM;eACR,MAAM;kBACH,MAAM,OAAO,MAAM;eAEtB,MAAM;CAClB,CAAC;AAEF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,CAMjF"}

package/dist/ui.js

@@ -0,0 +1,30 @@
+import kleur from "kleur";
+export const ui = {
+    banner: () => {
+        const lines = [
+            "",
+            kleur.magenta("  ╭──────────────────────────────────╮"),
+            kleur.magenta("  │") + kleur.bold().white("  μνήμη  ") + kleur.gray("·") + kleur.italic().cyan("  Mneme  ") + kleur.magenta("              │"),
+            kleur.magenta("  │") + kleur.gray("  the memory layer of your code   ") + kleur.magenta("│"),
+            kleur.magenta("  ╰──────────────────────────────────╯"),
+            "",
+        ];
+        process.stdout.write(lines.join("\n") + "\n");
+    },
+    info: (msg) => process.stdout.write(`${kleur.cyan("ℹ")} ${msg}\n`),
+    success: (msg) => process.stdout.write(`${kleur.green("✓")} ${msg}\n`),
+    warn: (msg) => process.stdout.write(`${kleur.yellow("!")} ${msg}\n`),
+    error: (msg) => process.stderr.write(`${kleur.red("✗")} ${msg}\n`),
+    dim: (msg) => process.stdout.write(kleur.gray(msg) + "\n"),
+    step: (label, msg) => process.stdout.write(`${kleur.gray("›")} ${kleur.bold(label)}  ${msg}\n`),
+    raw: (msg) => process.stdout.write(msg),
+};
+export function formatProgress(current, total, width = 24) {
+    if (total <= 0)
+        return "";
+    const ratio = Math.min(1, current / total);
+    const filled = Math.round(ratio * width);
+    const bar = kleur.cyan("█".repeat(filled)) + kleur.gray("░".repeat(width - filled));
+    return `${bar} ${kleur.bold(`${Math.round(ratio * 100)}%`)} ${kleur.gray(`(${current}/${total})`)}`;
+}
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "mneme-ai",
+  "version": "0.8.3",
+  "description": "Mneme — the memory layer for your codebase. Knows the WHY, the WHAT, the WHERE-IT-BREAKS.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "mneme": "./bin/mneme.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/patsa2561-art/mneme-ai.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/patsa2561-art/mneme-ai#readme",
+  "bugs": {
+    "url": "https://github.com/patsa2561-art/mneme-ai/issues"
+  },
+  "license": "MIT",
+  "files": ["dist", "bin", "README.md"],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean"
+  },
+  "dependencies": {
+    "@mneme-ai/core": "0.8.3",
+    "@mneme-ai/correlator": "0.8.3",
+    "@mneme-ai/embeddings": "0.8.3",
+    "@mneme-ai/mcp": "0.8.3",
+    "commander": "^12.1.0",
+    "kleur": "^4.1.5"
+  },
+  "keywords": [
+    "git",
+    "ai",
+    "rag",
+    "code-archaeology",
+    "mcp",
+    "vector-search",
+    "incident-correlation"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}