@mneme-ai/core 0.9.0 → 0.10.0

package/dist/insights/crystal-ball.js

@@ -0,0 +1,219 @@
+/**
+ * `mneme crystal-ball` — predict the probability that the staged change
+ * will fail CI, BEFORE you push.
+ *
+ * Approach (Bayesian-ish over historical signals):
+ *   1. Compute a fingerprint of the staged diff:
+ *        modules touched, file types, add/remove ratio, test changes Y/N.
+ *   2. Find historical commits with similar fingerprints.
+ *   3. Look at each one's fate within `windowDays`:
+ *        - revert / hotfix / fix follow-up = "trouble"
+ *        - else                            = "clean"
+ *   4. Output: prediction p(clean) = clean / total similar.
+ *
+ * Without integrated CI run history (which Mneme doesn't index by default),
+ * follow-up commits are our best proxy: a commit that needed a hotfix is
+ * indistinguishable from one that broke CI from the user's perspective.
+ *
+ * The output is honest about its limits: if `n` is small (< 5), we say
+ * "low signal" instead of pretending to be confident.
+ */
+import { parseDiff } from "./commit-coach.js";
+import { detectRegrets } from "./regret.js";
+export function fingerprint(diff) {
+    const exts = new Set();
+    for (const f of diff.files) {
+        const m = f.match(/\.([a-z0-9]+)$/i);
+        if (m)
+            exts.add(m[1].toLowerCase());
+    }
+    const totalLines = diff.added + diff.removed;
+    const size = totalLines < 20 ? "tiny" : totalLines < 100 ? "small" : totalLines < 500 ? "medium" : "large";
+    const hasTests = diff.files.some((f) => /(\.test\.|\.spec\.|\/tests?\/|\/specs?\/)/.test(f));
+    return {
+        modules: [...new Set(diff.modules)].sort(),
+        extensions: [...exts].sort(),
+        shape: diff.shape,
+        size,
+        hasTests,
+    };
+}
+/**
+ * Score similarity between two fingerprints. Returns 0..1.
+ *
+ * Each dimension contributes a weight; the score is a weighted average:
+ *   modules:    0.40  (Jaccard)
+ *   extensions: 0.20  (Jaccard)
+ *   shape:      0.20  (1.0 if equal, else 0.0)
+ *   size:       0.10  (linear distance over 4 buckets)
+ *   hasTests:   0.10  (1.0 if equal, else 0.0)
+ */
+export function similarity(a, b) {
+    const jaccard = (xs, ys) => {
+        if (xs.length === 0 && ys.length === 0)
+            return 1;
+        const A = new Set(xs);
+        const B = new Set(ys);
+        let inter = 0;
+        for (const x of A)
+            if (B.has(x))
+                inter += 1;
+        const union = A.size + B.size - inter;
+        return union === 0 ? 0 : inter / union;
+    };
+    const modules = jaccard(a.modules, b.modules);
+    const exts = jaccard(a.extensions, b.extensions);
+    const shape = a.shape === b.shape ? 1 : 0;
+    const sizes = ["tiny", "small", "medium", "large"];
+    const sizeDist = Math.abs(sizes.indexOf(a.size) - sizes.indexOf(b.size));
+    const size = 1 - sizeDist / 3;
+    const tests = a.hasTests === b.hasTests ? 1 : 0;
+    return 0.4 * modules + 0.2 * exts + 0.2 * shape + 0.1 * size + 0.1 * tests;
+}
+const SIMILARITY_THRESHOLD = 0.5;
+/**
+ * Predict CI/follow-up trouble probability for the given diff.
+ *
+ * @param store - the indexed store
+ * @param diffText - unified diff text (e.g. `git diff --staged` output)
+ * @param windowDays - how long after a past commit do we still count a
+ *                     follow-up as "trouble" (default 14)
+ */
+export function predict(store, diffText, windowDays = 14) {
+    const parsed = parseDiff(diffText);
+    const fp = fingerprint(parsed);
+    // Pull all commits from the store + their files.
+    // Only consider recent-enough commits (skip ancient history).
+    const commitRows = store.db
+        .prepare(`SELECT * FROM commits ORDER BY author_date DESC LIMIT 1000`)
+        .all();
+    if (commitRows.length === 0) {
+        return {
+            fingerprint: fp,
+            similarN: 0,
+            cleanN: 0,
+            pClean: 0,
+            verdict: "unknown",
+            recommendation: "Index the repo first (mneme index) — no historical signal yet.",
+        };
+    }
+    const commits = [];
+    for (const r of commitRows) {
+        const hash = String(r.hash);
+        const files = store.db.prepare("SELECT path FROM file_changes WHERE commit_hash = ?").all(hash).map((x) => x.path);
+        commits.push({
+            hash,
+            shortHash: String(r.short_hash),
+            authorName: String(r.author_name),
+            authorEmail: String(r.author_email),
+            authorDate: String(r.author_date),
+            committerDate: String(r.committer_date),
+            subject: String(r.subject),
+            body: String(r.body || ""),
+            parents: r.parents ? String(r.parents).split(/\s+/).filter(Boolean) : [],
+            files,
+        });
+    }
+    // Compute similarity for each historical commit.
+    const scored = [];
+    for (const c of commits) {
+        const cFp = fingerprintFromCommit(c);
+        const sim = similarity(fp, cFp);
+        if (sim >= SIMILARITY_THRESHOLD)
+            scored.push({ commit: c, sim, fp: cFp });
+    }
+    scored.sort((a, b) => b.sim - a.sim);
+    // Top 50 most-similar commits are our base.
+    const similar = scored.slice(0, 50);
+    const similarN = similar.length;
+    if (similarN === 0) {
+        return {
+            fingerprint: fp,
+            similarN: 0,
+            cleanN: 0,
+            pClean: 0,
+            verdict: "unknown",
+            recommendation: "No similar past changes in this repo. Treat as exploratory — small commits, careful review.",
+        };
+    }
+    // Detect regrets ONLY among the similar commits (constrain corpus).
+    // Use only strong regret signals (revert/hotfix/fix) — the weaker
+    // 'sameFiles' kind is too noisy for failure prediction.
+    const similarHashes = new Set(similar.map((s) => s.commit.hash));
+    const allRegrets = detectRegrets(commits, { windowDays });
+    const troubledHashes = new Set(allRegrets
+        .filter((r) => r.kind !== "sameFiles" && similarHashes.has(r.shipped.hash))
+        .map((r) => r.shipped.hash));
+    const cleanN = similarN - troubledHashes.size;
+    const pClean = cleanN / similarN;
+    // Find most-similar past commit (top of scored list) and its outcome.
+    const top = similar[0];
+    const mostSimilar = {
+        hash: top.commit.shortHash || top.commit.hash.slice(0, 7),
+        subject: top.commit.subject,
+        date: top.commit.authorDate.slice(0, 10),
+        outcome: troubledHashes.has(top.commit.hash) ? "trouble" : "clean",
+    };
+    const verdict = similarN < 5
+        ? "unknown"
+        : pClean >= 0.85
+            ? "clear"
+            : pClean >= 0.6
+                ? "moderate"
+                : "risky";
+    const recommendation = buildRecommendation(verdict, similarN, troubledHashes.size, pClean);
+    return {
+        fingerprint: fp,
+        similarN,
+        cleanN,
+        pClean,
+        verdict,
+        mostSimilar,
+        recommendation,
+    };
+}
+function fingerprintFromCommit(c) {
+    // Reconstruct a parsed-diff-like view from commit metadata.
+    const files = c.files ?? [];
+    const modules = [
+        ...new Set(files.map((f) => {
+            const parts = f.split("/");
+            return parts.length >= 2 ? `${parts[0]}/${parts[1]}` : parts[0];
+        })),
+    ].sort();
+    const exts = new Set();
+    for (const f of files) {
+        const m = f.match(/\.([a-z0-9]+)$/i);
+        if (m)
+            exts.add(m[1].toLowerCase());
+    }
+    // Shape from subject conventions.
+    const subjectLower = c.subject.toLowerCase();
+    const shape = /^fix|^hotfix|^bug/.test(subjectLower)
+        ? "fix"
+        : /^refactor/.test(subjectLower)
+            ? "refactor"
+            : /^docs?|^chore/.test(subjectLower)
+                ? "docs"
+                : /^test/.test(subjectLower)
+                    ? "test"
+                    : /^perf/.test(subjectLower)
+                        ? "perf"
+                        : "feat";
+    // We don't have line counts; treat as "small" by default.
+    const hasTests = files.some((f) => /(\.test\.|\.spec\.|\/tests?\/)/.test(f));
+    return { modules, extensions: [...exts].sort(), shape, size: "small", hasTests };
+}
+function buildRecommendation(verdict, similarN, troubledN, pClean) {
+    switch (verdict) {
+        case "unknown":
+            return `Only ${similarN} similar past change${similarN === 1 ? "" : "s"} in history — too thin to predict. Run tests locally before pushing.`;
+        case "clear":
+            return `${(pClean * 100).toFixed(0)}% of ${similarN} similar past changes shipped cleanly. Looks like a routine change.`;
+        case "moderate":
+            return `${troubledN} of ${similarN} similar past changes needed a follow-up fix. Run lint + tests locally first.`;
+        case "risky":
+            return `${troubledN} of ${similarN} similar past changes needed a follow-up fix (${(pClean * 100).toFixed(0)}% clean rate). Strongly consider splitting this commit + extra review.`;
+    }
+}
+//# sourceMappingURL=crystal-ball.js.map

package/dist/insights/crystal-ball.js.map

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

package/dist/insights/crystal-ball.test.d.ts

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

package/dist/insights/crystal-ball.test.d.ts.map

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

package/dist/insights/crystal-ball.test.js

@@ -0,0 +1,157 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { MnemeStore } from "../store/sqlite.js";
+import { fingerprint, similarity, predict } from "./crystal-ball.js";
+import { parseDiff } from "./commit-coach.js";
+let tmpDir;
+let store;
+beforeEach(() => {
+    tmpDir = mkdtempSync(join(tmpdir(), "mneme-cb-test-"));
+    store = new MnemeStore(join(tmpDir, "mneme.db"));
+});
+afterEach(() => {
+    store.close();
+    rmSync(tmpDir, { recursive: true, force: true });
+});
+const cmt = (hash, author, date, subject, files) => ({
+    hash,
+    shortHash: hash.slice(0, 7),
+    authorName: author,
+    authorEmail: `${author}@x`,
+    authorDate: `${date}T00:00:00Z`,
+    committerDate: `${date}T00:00:00Z`,
+    subject,
+    body: "",
+    parents: [],
+    files,
+});
+function seed(commits) {
+    store.upsertCommits(commits);
+    for (const c of commits) {
+        store.upsertFileChanges(c.files.map((f) => ({
+            commitHash: c.hash,
+            path: f,
+            changeKind: "M",
+            insertions: 1,
+            deletions: 0,
+        })));
+    }
+}
+describe("fingerprint", () => {
+    it("extracts modules, extensions, shape, size, hasTests", () => {
+        const diff = parseDiff(`diff --git a/src/auth/jwt.ts b/src/auth/jwt.ts
++const x = 1;`);
+        const fp = fingerprint(diff);
+        expect(fp.modules).toEqual(["src/auth"]);
+        expect(fp.extensions).toEqual(["ts"]);
+        expect(fp.size).toBe("tiny");
+        expect(fp.hasTests).toBe(false);
+    });
+    it("flags hasTests when *.test.ts present", () => {
+        const diff = parseDiff(`diff --git a/src/foo.test.ts b/src/foo.test.ts
++test('x', () => {});`);
+        expect(fingerprint(diff).hasTests).toBe(true);
+    });
+    it("size buckets are tiny/small/medium/large by line count", () => {
+        const tiny = fingerprint({ files: [], modules: [], added: 5, removed: 5, shape: "feat" });
+        const small = fingerprint({ files: [], modules: [], added: 50, removed: 30, shape: "feat" });
+        const medium = fingerprint({ files: [], modules: [], added: 200, removed: 200, shape: "feat" });
+        const large = fingerprint({ files: [], modules: [], added: 800, removed: 100, shape: "feat" });
+        expect(tiny.size).toBe("tiny");
+        expect(small.size).toBe("small");
+        expect(medium.size).toBe("medium");
+        expect(large.size).toBe("large");
+    });
+});
+describe("similarity", () => {
+    const fp = (overrides = {}) => ({
+        modules: ["src/auth"],
+        extensions: ["ts"],
+        shape: "feat",
+        size: "small",
+        hasTests: false,
+        ...overrides,
+    });
+    it("identical fingerprints score 1.0", () => {
+        expect(similarity(fp(), fp())).toBe(1);
+    });
+    it("module overlap dominates the score (40% weight)", () => {
+        const a = fp({ modules: ["src/auth"] });
+        const b = fp({ modules: ["src/payment"] });
+        // No module overlap → modules contributes 0
+        // Same exts (1.0 × 0.2), shape (0.2), size (0.1), tests (0.1) = 0.6
+        expect(similarity(a, b)).toBeCloseTo(0.6, 1);
+    });
+    it("size distance reduces score linearly", () => {
+        const a = fp({ size: "tiny" });
+        const b = fp({ size: "large" });
+        const s = similarity(a, b);
+        // Other dims identical (0.9 weight), size dim 0
+        expect(s).toBeCloseTo(0.9, 1);
+    });
+});
+describe("predict — empty repo edge case", () => {
+    it("returns 'unknown' verdict when repo is empty", () => {
+        const p = predict(store, "diff --git a/src/x.ts b/src/x.ts\n+const x = 1;");
+        expect(p.verdict).toBe("unknown");
+        expect(p.similarN).toBe(0);
+        expect(p.recommendation.toLowerCase()).toMatch(/index|signal/);
+    });
+});
+describe("predict — clean prediction", () => {
+    it("predicts 'clear' when most similar past changes shipped cleanly", () => {
+        const seedCommits = Array.from({ length: 20 }, (_, i) => cmt(`a${i}1234567`, "alice", `2024-08-${String((i % 28) + 1).padStart(2, "0")}`, `feat(auth): add thing ${i}`, ["src/auth/jwt.ts"]));
+        seed(seedCommits);
+        const p = predict(store, `diff --git a/src/auth/jwt.ts b/src/auth/jwt.ts
++const x = 1;`);
+        expect(p.similarN).toBeGreaterThan(0);
+        expect(p.verdict).toBe("clear");
+        expect(p.pClean).toBeGreaterThan(0.8);
+    });
+});
+describe("predict — risky prediction", () => {
+    it("predicts 'risky' when many similar past changes needed follow-up fixes", () => {
+        const commits = [];
+        // 10 pairs of (shipped, fix-2-days-later) on src/auth
+        for (let i = 0; i < 10; i++) {
+            const day = String(i * 3 + 1).padStart(2, "0");
+            const fixDay = String(i * 3 + 3).padStart(2, "0");
+            commits.push(cmt(`a${i}_____`, "alice", `2024-08-${day}`, `feat(auth): add thing ${i}`, ["src/auth/jwt.ts"]));
+            commits.push(cmt(`b${i}_____`, "alice", `2024-08-${fixDay}`, `fix: thing ${i} broke`, ["src/auth/jwt.ts"]));
+        }
+        seed(commits);
+        const p = predict(store, `diff --git a/src/auth/jwt.ts b/src/auth/jwt.ts
++const x = 1;`);
+        expect(p.similarN).toBeGreaterThanOrEqual(5);
+        expect(["risky", "moderate"]).toContain(p.verdict);
+        expect(p.pClean).toBeLessThan(0.7);
+    });
+});
+describe("predict — low signal verdict", () => {
+    it("returns 'unknown' when similar count is below 5", () => {
+        seed([
+            cmt("a1", "alice", "2024-08-01", "feat: thing", ["src/auth/jwt.ts"]),
+            cmt("a2", "alice", "2024-08-02", "feat: thing 2", ["src/auth/jwt.ts"]),
+        ]);
+        const p = predict(store, `diff --git a/src/auth/jwt.ts b/src/auth/jwt.ts
++const x = 1;`);
+        expect(["unknown", "clear"]).toContain(p.verdict);
+        if (p.similarN < 5)
+            expect(p.verdict).toBe("unknown");
+    });
+});
+describe("predict — most-similar reference", () => {
+    it("returns the most-similar past commit alongside the prediction", () => {
+        seed([
+            cmt("a1xxxxxx", "alice", "2024-08-01", "feat(auth): unique subject", ["src/auth/jwt.ts"]),
+            ...Array.from({ length: 10 }, (_, i) => cmt(`b${i}xxxxxx`, "alice", `2024-09-${String(i + 1).padStart(2, "0")}`, `feat: misc`, ["src/other/foo.ts"])),
+        ]);
+        const p = predict(store, `diff --git a/src/auth/jwt.ts b/src/auth/jwt.ts
++const x = 1;`);
+        expect(p.mostSimilar?.hash).toBeDefined();
+        expect(["clean", "trouble"]).toContain(p.mostSimilar?.outcome);
+    });
+});
+//# sourceMappingURL=crystal-ball.test.js.map

package/dist/insights/crystal-ball.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crystal-ball.test.js","sourceRoot":"","sources":["../../src/insights/crystal-ball.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,IAAI,MAAc,CAAC;AACnB,IAAI,KAAiB,CAAC;AAEtB,UAAU,CAAC,GAAG,EAAE;IACd,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACvD,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,MAAc,EAAE,IAAY,EAAE,OAAe,EAAE,KAAe,EAAU,EAAE,CAAC,CAAC;IACrG,IAAI;IACJ,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3B,UAAU,EAAE,MAAM;IAClB,WAAW,EAAE,GAAG,MAAM,IAAI;IAC1B,UAAU,EAAE,GAAG,IAAI,YAAY;IAC/B,aAAa,EAAE,GAAG,IAAI,YAAY;IAClC,OAAO;IACP,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,EAAE;IACX,KAAK;CACN,CAAC,CAAC;AAEH,SAAS,IAAI,CAAC,OAAiB;IAC7B,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,KAAK,CAAC,iBAAiB,CACrB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAClB,UAAU,EAAE,CAAC,CAAC,IAAI;YAClB,IAAI,EAAE,CAAC;YACP,UAAU,EAAE,GAAY;YACxB,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,CAAC;SACb,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC;AACH,CAAC;AAED,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,IAAI,GAAG,SAAS,CAAC;cACb,CAAC,CAAC;QACZ,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,IAAI,GAAG,SAAS,CAAC;sBACL,CAAC,CAAC;QACpB,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1F,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7F,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAChG,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/F,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,MAAM,EAAE,GAAG,CAAC,YAAqD,EAAE,EAAE,EAAE,CAAC,CAAC;QACvE,OAAO,EAAE,CAAC,UAAU,CAAC;QACrB,UAAU,EAAE,CAAC,IAAI,CAAC;QAClB,KAAK,EAAE,MAAe;QACtB,IAAI,EAAE,OAAgB;QACtB,QAAQ,EAAE,KAAK;QACf,GAAG,SAAS;KACb,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAC3C,4CAA4C;QAC5C,oEAAoE;QACpE,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/B,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAChC,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3B,gDAAgD;QAChD,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,iDAAiD,CAAC,CAAC;QAC5E,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACtD,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,yBAAyB,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CACpI,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,CAAC;QAClB,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE;cACf,CAAC,CAAC;QACZ,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,sDAAsD;QACtD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,EAAE,EAAE,yBAAyB,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;YAC9G,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,MAAM,EAAE,EAAE,cAAc,CAAC,QAAQ,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAC9G,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,CAAC;QACd,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE;cACf,CAAC,CAAC;QACZ,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,IAAI,CAAC;YACH,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC,iBAAiB,CAAC,CAAC;YACpE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC,iBAAiB,CAAC,CAAC;SACvE,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE;cACf,CAAC,CAAC;QACZ,MAAM,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC;YAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAChD,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,IAAI,CAAC;YACH,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,4BAA4B,EAAE,CAAC,iBAAiB,CAAC,CAAC;YACzF,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACrC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,YAAY,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAC7G;SACF,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE;cACf,CAAC,CAAC;QACZ,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/insights/index.d.ts

@@ -13,4 +13,9 @@ export * from "./story.js";
 export * from "./dream.js";
 export * from "./suggest.js";
 export * from "./obsidian.js";
+export * from "./regret.js";
+export * from "./bus-factor.js";
+export * from "./paradox.js";
+export * from "./commit-coach.js";
+export * from "./crystal-ball.js";
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/insights/index.js

@@ -13,4 +13,9 @@ export * from "./story.js";
 export * from "./dream.js";
 export * from "./suggest.js";
 export * from "./obsidian.js";
+export * from "./regret.js";
+export * from "./bus-factor.js";
+export * from "./paradox.js";
+export * from "./commit-coach.js";
+export * from "./crystal-ball.js";
 //# sourceMappingURL=index.js.map

package/dist/insights/index.js.map

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

package/dist/insights/paradox.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `mneme paradox` — find architectural flip-flops in commit history.
+ *
+ * A "flip-flop" is a chain of decisions on the same topic where the
+ * direction reverses: A → B → A. This usually means the team forgot
+ * (or never wrote down) WHY they made the original decision.
+ *
+ * Implementation: walk decisions chronologically, group by topic
+ * (heuristically clustered by key terms), and detect ABA-style
+ * chains. Conservative — only emit when confidence is high that
+ * the decisions are actually about the same thing.
+ *
+ * Pure data analysis. No LLM. The CLI renders.
+ */
+import type { ExtractedDecision } from "./decisions.js";
+export interface FlipFlop {
+    /** Topic label — extracted from the shared keyword(s). */
+    topic: string;
+    /** The chain of decisions, oldest first. */
+    chain: ExtractedDecision[];
+    /** How many direction reversals (0 = no flip, 1 = one flip, 2 = ABA). */
+    flips: number;
+    /** Months between first and last decision in the chain. */
+    spanMonths: number;
+    /** A 1-line interpretation. */
+    question: string;
+}
+/**
+ * Detect flip-flops across a list of decisions.
+ *
+ * Returns groups with ≥ 1 flip — the actual paradoxes worth investigating.
+ * Groups with 2+ decisions but no flips (just continuous progress) are
+ * suppressed.
+ */
+export declare function detectParadoxes(decisions: ExtractedDecision[]): FlipFlop[];
+//# sourceMappingURL=paradox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paradox.d.ts","sourceRoot":"","sources":["../../src/insights/paradox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,WAAW,QAAQ;IACvB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAqJD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,iBAAiB,EAAE,GAAG,QAAQ,EAAE,CA2B1E"}