mneme-ai 0.9.0 → 0.11.0

package/dist/commands/insights-cli.d.ts

@@ -47,4 +47,60 @@ export interface ChatOptions {
     noLlm?: boolean;
 }
 export declare function chatCommand(opts: ChatOptions): Promise<number>;
+export interface RegretOptions {
+    cwd: string;
+    windowDays?: number;
+    json?: boolean;
+}
+export declare function regretCommand(opts: RegretOptions): Promise<number>;
+export interface BusFactorOptions {
+    cwd: string;
+    topN?: number;
+    minTouches?: number;
+    json?: boolean;
+}
+export declare function busFactorCommand(opts: BusFactorOptions): Promise<number>;
+export interface ParadoxOptions {
+    cwd: string;
+    json?: boolean;
+}
+export declare function paradoxCommand(opts: ParadoxOptions): Promise<number>;
+export interface CommitCoachOptions {
+    cwd: string;
+    diffFile?: string;
+    fromStdin?: boolean;
+    json?: boolean;
+    noLlm?: boolean;
+}
+export declare function commitCoachCommand(opts: CommitCoachOptions): Promise<number>;
+export interface CrystalBallOptions {
+    cwd: string;
+    diffFile?: string;
+    fromStdin?: boolean;
+    windowDays?: number;
+    json?: boolean;
+}
+export declare function crystalBallCommand(opts: CrystalBallOptions): Promise<number>;
+export interface TimeMachineOptions {
+    cwd: string;
+    filePath: string;
+    plateauDays?: number;
+    json?: boolean;
+}
+export declare function timeMachineCommand(opts: TimeMachineOptions): Promise<number>;
+export interface PremortemOptions {
+    cwd: string;
+    intent: string;
+    similarityFloor?: number;
+    windowDays?: number;
+    json?: boolean;
+}
+export declare function premortemCommand(opts: PremortemOptions): Promise<number>;
+export interface GhostOptions {
+    cwd: string;
+    topN?: number;
+    staleDays?: number;
+    json?: boolean;
+}
+export declare function ghostCommand(opts: GhostOptions): Promise<number>;
 //# sourceMappingURL=insights-cli.d.ts.map

package/dist/commands/insights-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"insights-cli.d.ts","sourceRoot":"","sources":["../../src/commands/insights-cli.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoDH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA6B5E;AA0BD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiE9E;AAID,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyFhF;AAgDD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAyGtE;AAID,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAgEtE;AAeD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CA4HpE"}
+{"version":3,"file":"insights-cli.d.ts","sourceRoot":"","sources":["../../src/commands/insights-cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/insights-cli.js

@@ -53,17 +53,40 @@ export async function whoKnowsCommand(opts) {
         return 0;
     }
     ui.banner();
-    process.stdout.write(`\n  ${kleur.bold().cyan("👤  Top experts on")}  ${kleur.bold(`"${opts.topic}"`)}\n\n`);
-    if (candidates.length === 0) {
+    const verdict = insights.whoKnowsVerdict(candidates);
+    if (opts.json) {
+        process.stdout.write(JSON.stringify({ topic: opts.topic, verdict, candidates }, null, 2) + "\n");
+        return 0;
+    }
+    // ─── Header ────────────────────────────────────────────────────────────
+    process.stdout.write(`\n  ${kleur.bold().cyan("👤  Who knows about")}  ${kleur.bold(`"${opts.topic}"`)}\n`);
+    process.stdout.write(`  ${kleur.gray("══════════════════════════════════════════════════════════")}\n\n`);
+    if (candidates.length === 0 || !verdict.topExpert) {
         process.stdout.write(`  ${kleur.gray(`No commits matched "${opts.topic}". Try a broader topic.`)}\n\n`);
         return 0;
     }
-    for (const c of candidates) {
-        const tier = renderTier(c.tier);
-        const lastTouchAge = daysAgoFromIso(c.lastTouch);
-        process.stdout.write(`  ${tier}  ${kleur.bold(c.name)}  ${kleur.gray(`<${c.email}>`)}\n`);
-        process.stdout.write(`      ${kleur.gray(`${c.commitCount} commits · ${c.filesTouched} files · last touch ${lastTouchAge} ago · score ${c.score.toFixed(2)}`)}\n\n`);
+    // ─── VERDICT (the answer the user is here for) ─────────────────────────
+    const top = verdict.topExpert;
+    process.stdout.write(`  ${kleur.bold().magenta("✦ Verdict")}\n\n`);
+    process.stdout.write(`    ${kleur.bold(top.name)}  ${kleur.gray(`<${top.email}>`)}\n`);
+    process.stdout.write(`    ${kleur.cyan(verdict.confidencePct + "%")} confidence — ${top.commitCount} of ${verdict.totalCommits} relevant commits\n`);
+    process.stdout.write(`    last touch ${kleur.bold(daysAgoFromIso(top.lastTouch))} ago · ${top.filesTouched} files · ${renderTier(top.tier)}\n`);
+    if (verdict.risk) {
+        process.stdout.write(`\n    ${kleur.yellow("⚠ ")}${kleur.yellow(verdict.risk)}\n`);
+    }
+    if (verdict.backup) {
+        process.stdout.write(`\n    ${kleur.gray("backup:")} ${kleur.bold(verdict.backup.name)} ${kleur.gray(`(${verdict.backup.commitCount} commits, last touch ${daysAgoFromIso(verdict.backup.lastTouch)} ago)`)}\n`);
+    }
+    // ─── All candidates ───────────────────────────────────────────────────
+    if (candidates.length > 1) {
+        process.stdout.write(`\n  ${kleur.bold().magenta("◆ All candidates")}  ${kleur.gray(`(${candidates.length})`)}\n\n`);
+        for (const c of candidates) {
+            const tier = renderTier(c.tier);
+            process.stdout.write(`    ${tier}  ${kleur.bold(c.name)}  ${kleur.gray(`<${c.email}>`)}\n`);
+            process.stdout.write(`        ${kleur.gray(`${c.commitCount} commits · ${c.filesTouched} files · last touch ${daysAgoFromIso(c.lastTouch)} ago · score ${c.score.toFixed(2)}`)}\n`);
+        }
     }
+    process.stdout.write("\n");
     return 0;
 }
 function renderTier(tier) {
@@ -541,6 +564,301 @@ export async function chatCommand(opts) {
     process.stdout.write(`\n  ${kleur.gray(`bye — ${transcript.length} turn(s) recorded`)}\n\n`);
     return 0;
 }
+// ─── divider helper — used across all insights output ─────────────────
+const DIV_WIDTH = 64;
+function divider(label = "") {
+    if (!label)
+        return kleur.gray("═".repeat(DIV_WIDTH));
+    const padded = `═══ ${label} `;
+    const tail = "═".repeat(Math.max(4, DIV_WIDTH - padded.length));
+    return kleur.gray(padded + tail);
+}
+export async function regretCommand(opts) {
+    const result = await withStore(opts.cwd, (s) => {
+        const commits = util.loadAllCommits(s);
+        const regrets = insights.detectRegrets(commits, { windowDays: opts.windowDays ?? 7 });
+        const summary = insights.summarizeRegrets(commits, regrets);
+        return { regrets, summary };
+    });
+    if (typeof result === "number")
+        return result;
+    const { regrets, summary } = result;
+    if (opts.json) {
+        process.stdout.write(JSON.stringify({ regrets, summary }, null, 2) + "\n");
+        return 0;
+    }
+    ui.banner();
+    process.stdout.write(`\n  ${kleur.bold().cyan("😬  Regrets — what we shipped and immediately fixed")}\n`);
+    process.stdout.write(`  ${divider()}\n\n`);
+    // Verdict
+    process.stdout.write(`  ${kleur.bold().magenta("✦ Summary")}\n\n`);
+    process.stdout.write(`    ${kleur.bold(String(summary.totalRegrets))} regrets across ${kleur.bold(String(summary.totalShipped))} shipped commits  ${kleur.gray(`(rate: ${(summary.regretRate * 100).toFixed(1)}%)`)}\n`);
+    if (summary.totalRegrets > 0) {
+        process.stdout.write(`    average days-to-fix: ${kleur.bold(summary.averageDaysToFix.toFixed(1))}\n`);
+        const breakdown = Object.entries(summary.byKind)
+            .filter(([, n]) => n > 0)
+            .map(([k, n]) => `${k}: ${n}`)
+            .join(" · ");
+        if (breakdown)
+            process.stdout.write(`    ${kleur.gray("breakdown: " + breakdown)}\n`);
+    }
+    if (regrets.length === 0) {
+        process.stdout.write(`\n  ${kleur.green("✓")} No regrets detected — clean shipping history.\n\n`);
+        return 0;
+    }
+    // Listing
+    process.stdout.write(`\n  ${kleur.bold().magenta("◆ Recent regrets")}  ${kleur.gray(`(showing ${Math.min(20, regrets.length)} of ${regrets.length})`)}\n\n`);
+    for (const r of regrets.slice(0, 20)) {
+        const kindBadge = renderRegretKind(r.kind);
+        const shippedHash = r.shipped.shortHash || r.shipped.hash.slice(0, 7);
+        const followupHash = r.followup.shortHash || r.followup.hash.slice(0, 7);
+        process.stdout.write(`    ${kindBadge}  shipped ${kleur.bold(r.shipped.authorDate.slice(0, 10))}  ${kleur.gray("→ fixed in " + r.daysToFix + "d")}\n`);
+        process.stdout.write(`        ${kleur.cyan(shippedHash)}  ${kleur.bold(r.shipped.subject)}\n`);
+        process.stdout.write(`        ${kleur.gray("↳ " + followupHash + "  " + r.followup.subject)}\n`);
+        if (r.lesson)
+            process.stdout.write(`        ${kleur.gray("lesson: " + r.lesson)}\n`);
+        process.stdout.write("\n");
+    }
+    return 0;
+}
+function renderRegretKind(kind) {
+    switch (kind) {
+        case "revert":
+            return kleur.red().bold("REVERT  ");
+        case "hotfix":
+            return kleur.yellow().bold("HOTFIX  ");
+        case "fix":
+            return kleur.cyan().bold("FIX     ");
+        default:
+            return kleur.gray().bold("similar ");
+    }
+}
+export async function busFactorCommand(opts) {
+    const result = await withStore(opts.cwd, (s) => {
+        return insights.busFactor(s, { topN: opts.topN ?? 20, minTouches: opts.minTouches ?? 3 });
+    });
+    if (typeof result === "number")
+        return result;
+    const risks = result;
+    if (opts.json) {
+        process.stdout.write(JSON.stringify({ risks }, null, 2) + "\n");
+        return 0;
+    }
+    ui.banner();
+    process.stdout.write(`\n  ${kleur.bold().cyan("🚨  Bus-factor risks — knowledge fragility")}\n`);
+    process.stdout.write(`  ${divider()}\n\n`);
+    if (risks.length === 0) {
+        process.stdout.write(`  ${kleur.green("✓")} No high-risk files detected — knowledge is well distributed.\n\n`);
+        return 0;
+    }
+    const counts = { critical: 0, high: 0, medium: 0, low: 0 };
+    for (const r of risks)
+        counts[r.tier] += 1;
+    process.stdout.write(`  ${kleur.bold().magenta("✦ Summary")}\n\n`);
+    process.stdout.write(`    ${kleur.red().bold(String(counts.critical))} critical  ·  ${kleur.yellow().bold(String(counts.high))} high  ·  ${kleur.cyan().bold(String(counts.medium))} medium  ·  ${kleur.gray(counts.low + " low")}\n\n`);
+    process.stdout.write(`  ${kleur.bold().magenta("◆ Files at risk")}  ${kleur.gray(`(top ${risks.length})`)}\n\n`);
+    for (const r of risks) {
+        const tier = renderBusFactorTier(r.tier);
+        process.stdout.write(`    ${tier}  ${kleur.bold(r.filePath)}\n`);
+        process.stdout.write(`        ${kleur.bold(r.topOwner.name)} ${kleur.gray(`<${r.topOwner.email}>`)}  ${kleur.cyan(r.topOwner.sharePct + "%")}  ${kleur.gray(`(${r.topOwner.touches} of ${r.totalTouches} commits)`)}\n`);
+        if (r.backup) {
+            process.stdout.write(`        ${kleur.gray(`backup: ${r.backup.name} (${r.backup.touches} commits)`)}\n`);
+        }
+        process.stdout.write(`        ${kleur.gray("→ " + r.recommendation)}\n\n`);
+    }
+    return 0;
+}
+function renderBusFactorTier(tier) {
+    switch (tier) {
+        case "critical":
+            return kleur.red().bold("CRITICAL");
+        case "high":
+            return kleur.yellow().bold("HIGH    ");
+        case "medium":
+            return kleur.cyan().bold("MEDIUM  ");
+        default:
+            return kleur.gray().bold("LOW     ");
+    }
+}
+export async function paradoxCommand(opts) {
+    const result = await withStore(opts.cwd, (s) => {
+        const commits = util.loadAllCommits(s);
+        const decisions = commits.flatMap(insights.extractDecisions);
+        return insights.detectParadoxes(decisions);
+    });
+    if (typeof result === "number")
+        return result;
+    const flipFlops = result;
+    if (opts.json) {
+        process.stdout.write(JSON.stringify({ flipFlops }, null, 2) + "\n");
+        return 0;
+    }
+    ui.banner();
+    process.stdout.write(`\n  ${kleur.bold().cyan("🌀  Paradoxes — architectural flip-flops")}\n`);
+    process.stdout.write(`  ${divider()}\n\n`);
+    if (flipFlops.length === 0) {
+        process.stdout.write(`  ${kleur.green("✓")} No flip-flops detected. Either the team is consistent, or commit messages are too thin to extract decisions.\n\n`);
+        return 0;
+    }
+    process.stdout.write(`  ${kleur.bold().magenta("✦ Summary")}\n\n`);
+    process.stdout.write(`    ${kleur.bold(String(flipFlops.length))} topic(s) flip-flopped over time\n\n`);
+    for (const f of flipFlops) {
+        process.stdout.write(`  ${divider("topic: " + f.topic)}\n`);
+        process.stdout.write(`    ${kleur.bold(String(f.flips))} reversal${f.flips === 1 ? "" : "s"}  ${kleur.gray(`over ${f.spanMonths} months · ${f.chain.length} decisions`)}\n\n`);
+        for (const d of f.chain) {
+            process.stdout.write(`    ${kleur.gray("●")} ${kleur.bold(d.date)}  ${kleur.cyan(d.shortHash)}  ${d.summary}  ${kleur.gray(`(${d.author})`)}\n`);
+        }
+        process.stdout.write(`\n    ${kleur.yellow("→ ")}${kleur.yellow(f.question)}\n\n`);
+    }
+    return 0;
+}
+export async function commitCoachCommand(opts) {
+    // Read the diff: from file, stdin, or `git diff --staged`.
+    let diffText = "";
+    if (opts.diffFile) {
+        try {
+            diffText = readFileSync(opts.diffFile, "utf8");
+        }
+        catch (err) {
+            ui.error(`Cannot read ${opts.diffFile}: ${err.message}`);
+            return 1;
+        }
+    }
+    else if (opts.fromStdin) {
+        diffText = await readStdin();
+    }
+    else {
+        // Default: shell out to git diff --staged
+        try {
+            const { spawnSync } = await import("node:child_process");
+            const r = spawnSync("git", ["diff", "--staged"], { cwd: opts.cwd, encoding: "utf8" });
+            if (r.status === 0)
+                diffText = r.stdout;
+        }
+        catch {
+            // git not available — let user know
+        }
+    }
+    if (!diffText.trim()) {
+        ui.error("No staged diff. Pass --from <file>, --stdin, or `git add` something first.");
+        return 1;
+    }
+    const result = await withStore(opts.cwd, (s) => insights.coach(s, diffText));
+    if (typeof result === "number")
+        return result;
+    const advice = result;
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(advice, null, 2) + "\n");
+        return 0;
+    }
+    ui.banner();
+    process.stdout.write(`\n  ${kleur.bold().cyan("🪶  Commit coach — pre-commit review")}\n`);
+    process.stdout.write(`  ${divider()}\n\n`);
+    // Diff section
+    process.stdout.write(`  ${kleur.bold().magenta("✦ Diff")}\n\n`);
+    process.stdout.write(`    ${kleur.bold(String(advice.diff.files.length))} file(s)  ·  ${kleur.green("+" + advice.diff.added)} ${kleur.red("-" + advice.diff.removed)}  ·  shape: ${kleur.cyan(advice.diff.shape)}\n`);
+    for (const m of advice.diff.modules.slice(0, 5))
+        process.stdout.write(`    ${kleur.gray("·")} ${m}\n`);
+    process.stdout.write("\n");
+    // Suggested message
+    process.stdout.write(`  ${kleur.bold().magenta("✦ Suggested commit message")}\n\n`);
+    process.stdout.write(`    ${kleur.bold(advice.suggestedSubject)}\n\n`);
+    // Reviewers
+    if (advice.reviewers.length > 0) {
+        process.stdout.write(`  ${kleur.bold().magenta("◆ Reviewers")}  ${kleur.gray("(top experts on touched files)")}\n\n`);
+        for (const r of advice.reviewers) {
+            process.stdout.write(`    ${kleur.cyan("●")} ${kleur.bold(r.name)} ${kleur.gray(`<${r.email}>`)}  ${kleur.cyan(r.ownership + "%")}  ${kleur.gray(`(${r.ownedFiles.length} owned files)`)}\n`);
+        }
+        process.stdout.write("\n");
+    }
+    // Scope
+    process.stdout.write(`  ${kleur.bold().magenta("◆ Scope")}\n\n`);
+    process.stdout.write(`    ${advice.scopeOK ? kleur.green("✓") : kleur.yellow("⚠")} ${advice.scopeMessage}\n\n`);
+    // Warnings
+    if (advice.warnings.length > 0) {
+        process.stdout.write(`  ${kleur.bold().magenta("⚠ Past warnings")}\n\n`);
+        for (const w of advice.warnings) {
+            process.stdout.write(`    ${kleur.yellow("⚠ ")}${kleur.yellow(w.pattern)}\n`);
+            process.stdout.write(`        ${kleur.gray(`${w.pastDate} · ${w.pastCommitHash} · ${w.outcome}`)}\n\n`);
+        }
+    }
+    else {
+        process.stdout.write(`  ${kleur.green("✓")} ${kleur.gray("No past-regret warnings for these files.")}\n\n`);
+    }
+    return 0;
+}
+export async function crystalBallCommand(opts) {
+    // Same diff-acquisition pattern as commit-coach.
+    let diffText = "";
+    if (opts.diffFile) {
+        try {
+            diffText = readFileSync(opts.diffFile, "utf8");
+        }
+        catch (err) {
+            ui.error(`Cannot read ${opts.diffFile}: ${err.message}`);
+            return 1;
+        }
+    }
+    else if (opts.fromStdin) {
+        diffText = await readStdin();
+    }
+    else {
+        try {
+            const { spawnSync } = await import("node:child_process");
+            const r = spawnSync("git", ["diff", "--staged"], { cwd: opts.cwd, encoding: "utf8" });
+            if (r.status === 0)
+                diffText = r.stdout;
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    if (!diffText.trim()) {
+        ui.error("No staged diff. Pass --from <file>, --stdin, or `git add` something first.");
+        return 1;
+    }
+    const result = await withStore(opts.cwd, (s) => insights.predict(s, diffText, opts.windowDays ?? 14));
+    if (typeof result === "number")
+        return result;
+    const p = result;
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(p, null, 2) + "\n");
+        return 0;
+    }
+    ui.banner();
+    process.stdout.write(`\n  ${kleur.bold().cyan("🔮  Crystal ball — CI / follow-up failure prediction")}\n`);
+    process.stdout.write(`  ${divider()}\n\n`);
+    // Verdict
+    process.stdout.write(`  ${kleur.bold().magenta("✦ Verdict")}\n\n`);
+    process.stdout.write(`    ${renderCrystalBallVerdict(p.verdict)}  ${kleur.cyan((p.pClean * 100).toFixed(0) + "%")} clean rate  ${kleur.gray(`(${p.cleanN}/${p.similarN} similar past changes)`)}\n\n`);
+    // Fingerprint
+    process.stdout.write(`  ${kleur.bold().magenta("◆ Diff fingerprint")}\n\n`);
+    process.stdout.write(`    modules:  ${p.fingerprint.modules.join(", ") || kleur.gray("(none)")}\n`);
+    process.stdout.write(`    extensions: ${p.fingerprint.extensions.join(", ") || kleur.gray("(none)")}\n`);
+    process.stdout.write(`    shape:    ${kleur.cyan(p.fingerprint.shape)} · ${p.fingerprint.size} · tests ${p.fingerprint.hasTests ? "yes" : "no"}\n\n`);
+    // Most-similar
+    if (p.mostSimilar) {
+        const outcome = p.mostSimilar.outcome === "clean" ? kleur.green("clean") : kleur.red("trouble");
+        process.stdout.write(`  ${kleur.bold().magenta("◆ Most similar past change")}\n\n`);
+        process.stdout.write(`    ${kleur.bold(p.mostSimilar.hash)}  ${kleur.gray(p.mostSimilar.date)}  ${p.mostSimilar.subject}\n`);
+        process.stdout.write(`    outcome: ${outcome}\n\n`);
+    }
+    process.stdout.write(`  ${kleur.bold().magenta("→ Recommendation")}\n\n`);
+    process.stdout.write(`    ${p.recommendation}\n\n`);
+    return 0;
+}
+function renderCrystalBallVerdict(v) {
+    switch (v) {
+        case "clear":
+            return kleur.green().bold("● CLEAR    ");
+        case "moderate":
+            return kleur.yellow().bold("● MODERATE ");
+        case "risky":
+            return kleur.red().bold("● RISKY    ");
+        default:
+            return kleur.gray().bold("○ UNKNOWN  ");
+    }
+}
 async function narrateAct(enricher, topic, commits) {
     if (commits.length === 0)
         return "";
@@ -576,4 +894,183 @@ function wrap(text, width, indent) {
         out.push(line);
     return out;
 }
+export async function timeMachineCommand(opts) {
+    const result = await withStore(opts.cwd, (s) => {
+        const allCommits = util.loadAllCommits(s);
+        // Filter to commits that touched the target file
+        const target = opts.filePath;
+        const filtered = allCommits.filter((c) => c.files.includes(target));
+        const fileChanges = util.loadFileChangesForPath(s, target);
+        const changeMap = new Map();
+        for (const ch of fileChanges)
+            changeMap.set(ch.commitHash, ch);
+        return insights.buildTimeMachine(target, filtered, changeMap, {
+            plateauDays: opts.plateauDays ?? 60,
+        });
+    });
+    if (typeof result === "number")
+        return result;
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+        return 0;
+    }
+    ui.banner();
+    process.stdout.write(`\n  ${kleur.bold().cyan("🕰  Time Machine — life of a file")}\n`);
+    process.stdout.write(`  ${divider()}\n\n`);
+    process.stdout.write(`  ${kleur.bold(opts.filePath)}\n`);
+    if (result.totalCommits === 0) {
+        process.stdout.write(`\n  ${kleur.yellow("✗")} No commits found for this path. Check the file exists in history.\n\n`);
+        return 0;
+    }
+    process.stdout.write(`  ${kleur.gray(String(result.totalCommits) + " commits across " + result.totalSpanDays + " days")}\n\n`);
+    // Health line
+    const h = result.health;
+    const pct = (n) => Math.round(n * 100);
+    process.stdout.write(`  ${kleur.bold().magenta("✦ Health")}\n\n`);
+    process.stdout.write(`    rewrite ${kleur.bold(pct(h.rewriteRatio) + "%")}  ·  firefight ${kleur.bold(pct(h.firefightRatio) + "%")}  ·  polish/plateau ${kleur.bold(pct(h.polishRatio) + "%")}\n\n`);
+    // Epochs timeline
+    process.stdout.write(`  ${kleur.bold().magenta("◆ Epochs")}\n\n`);
+    for (const e of result.epochs) {
+        const badge = renderEpochKind(e.kind);
+        const range = e.fromDate === e.toDate ? e.fromDate : `${e.fromDate} → ${e.toDate}`;
+        process.stdout.write(`    ${badge}  ${kleur.gray(range)}  ${kleur.gray(`(${e.spanDays}d)`)}\n`);
+        process.stdout.write(`        ${e.label}\n`);
+        if (e.commits.length > 0) {
+            const churn = e.insertions + e.deletions;
+            process.stdout.write(`        ${kleur.gray(`${e.commits.length} commits · +${e.insertions}/-${e.deletions} (${churn} lines)`)}\n`);
+        }
+        process.stdout.write("\n");
+    }
+    return 0;
+}
+function renderEpochKind(kind) {
+    switch (kind) {
+        case "birth":
+            return kleur.green().bold("BIRTH    ");
+        case "rewrite":
+            return kleur.magenta().bold("REWRITE  ");
+        case "evolution":
+            return kleur.cyan().bold("EVOLVE   ");
+        case "firefight":
+            return kleur.red().bold("FIREFIGHT");
+        case "polish":
+            return kleur.blue().bold("POLISH   ");
+        case "plateau":
+            return kleur.gray().bold("PLATEAU  ");
+        case "twilight":
+            return kleur.gray().bold("TWILIGHT ");
+        default:
+            return kleur.gray().bold(kind.padEnd(9));
+    }
+}
+export async function premortemCommand(opts) {
+    const result = await withStore(opts.cwd, (s) => {
+        const commits = util.loadAllCommits(s);
+        return insights.buildPremortem(opts.intent, commits, {
+            similarityFloor: opts.similarityFloor ?? 0.25,
+            windowDays: opts.windowDays ?? 14,
+        });
+    });
+    if (typeof result === "number")
+        return result;
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+        return 0;
+    }
+    ui.banner();
+    process.stdout.write(`\n  ${kleur.bold().cyan("🔮  Pre-mortem — what your repo's history says about this")}\n`);
+    process.stdout.write(`  ${divider()}\n\n`);
+    process.stdout.write(`  ${kleur.gray("intent:")}  ${kleur.bold(opts.intent)}\n\n`);
+    const verdictColor = (() => {
+        switch (result.verdict) {
+            case "very_high": return kleur.red().bold;
+            case "high": return kleur.yellow().bold;
+            case "medium": return kleur.cyan().bold;
+            case "low": return kleur.green().bold;
+        }
+    })();
+    process.stdout.write(`  ${kleur.bold().magenta("✦ Verdict")}\n\n`);
+    process.stdout.write(`    risk: ${verdictColor(result.verdict.toUpperCase().replace("_", " "))}  ${kleur.gray(`(P(regret) = ${(result.regretProbability * 100).toFixed(0)}%)`)}\n\n`);
+    for (const line of wrap(result.summary, 76, "    ")) {
+        process.stdout.write(line + "\n");
+    }
+    if (result.topRisks.length > 0) {
+        process.stdout.write(`\n  ${kleur.bold().magenta("◆ Top risks")}\n\n`);
+        for (const r of result.topRisks) {
+            process.stdout.write(`    ${kleur.bold("•")} ${r.label}\n`);
+            for (const ev of r.evidence.slice(0, 3)) {
+                const hash = ev.shortHash || ev.hash.slice(0, 7);
+                process.stdout.write(`      ${kleur.gray(hash + "  " + ev.subject)}\n`);
+            }
+        }
+    }
+    if (result.pastAttempts.length > 0) {
+        const sample = result.pastAttempts.slice(0, 5);
+        process.stdout.write(`\n  ${kleur.bold().magenta("◇ Similar past attempts")}  ${kleur.gray(`(${result.pastAttempts.length} found)`)}\n\n`);
+        for (const a of sample) {
+            const hash = a.attempt.shortHash || a.attempt.hash.slice(0, 7);
+            const status = a.riskKind === "none"
+                ? kleur.green("ok")
+                : kleur.red(a.riskKind);
+            process.stdout.write(`    ${kleur.gray(a.attempt.authorDate.slice(0, 10))}  ${kleur.cyan(hash)}  [${status}]  ${a.attempt.subject}\n`);
+        }
+    }
+    process.stdout.write("\n");
+    return 0;
+}
+export async function ghostCommand(opts) {
+    const result = await withStore(opts.cwd, (s) => {
+        const commits = util.loadAllCommits(s);
+        const changes = util.loadAllFileChanges(s);
+        return insights.buildGhostReport(commits, changes, {
+            staleDays: opts.staleDays ?? 180,
+            minGhostliness: 0.4,
+        });
+    });
+    if (typeof result === "number")
+        return result;
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+        return 0;
+    }
+    ui.banner();
+    process.stdout.write(`\n  ${kleur.bold().cyan("👻  Ghost Code — what's haunting your repo")}\n`);
+    process.stdout.write(`  ${divider()}\n\n`);
+    process.stdout.write(`  ${kleur.bold(String(result.totalFiles))} files analyzed  ·  ${kleur.bold(result.ghostFiles.length + " ghosts")} surfaced  ·  avg ghostliness ${kleur.bold((result.averageGhostliness * 100).toFixed(0) + "%")}\n\n`);
+    if (result.ghostFiles.length === 0) {
+        process.stdout.write(`  ${kleur.green("✓")} Repo looks active — no significant ghost code detected.\n\n`);
+        return 0;
+    }
+    process.stdout.write(`  ${kleur.bold().magenta("◆ Ghost files")}  ${kleur.gray(`(top ${Math.min(opts.topN ?? 10, result.ghostFiles.length)})`)}\n\n`);
+    for (const g of result.ghostFiles.slice(0, opts.topN ?? 10)) {
+        const score = (g.ghostliness * 100).toFixed(0) + "%";
+        const meter = renderMeter(g.ghostliness);
+        process.stdout.write(`    ${kleur.bold(g.path)}\n`);
+        process.stdout.write(`      ${meter}  ${kleur.bold(score)}  ${kleur.gray(g.reason)}\n`);
+        process.stdout.write(`      ${kleur.gray(`${g.totalCommits} commits · ${g.daysSinceLastTouch}d quiet · last: "${truncateOneLine(g.lastCommitSubject, 60)}"`)}\n\n`);
+    }
+    if (result.staleTodos.length > 0) {
+        process.stdout.write(`  ${kleur.bold().magenta("◇ Stale TODOs")}  ${kleur.gray(`(${result.staleTodos.length} ignored markers)`)}\n\n`);
+        for (const t of result.staleTodos.slice(0, 5)) {
+            process.stdout.write(`    ${kleur.bold(t.filePath)}\n`);
+            process.stdout.write(`      ${kleur.gray(`${t.ageDays}d old · ignored ${t.ignoredCount}× since`)}\n`);
+            process.stdout.write(`      ${kleur.gray("↳ " + truncateOneLine(t.hint, 70))}\n\n`);
+        }
+    }
+    return 0;
+}
+function renderMeter(value) {
+    const blocks = Math.round(value * 10);
+    const filled = "█".repeat(blocks);
+    const empty = "░".repeat(10 - blocks);
+    if (value >= 0.7)
+        return kleur.red(filled) + kleur.gray(empty);
+    if (value >= 0.4)
+        return kleur.yellow(filled) + kleur.gray(empty);
+    return kleur.green(filled) + kleur.gray(empty);
+}
+function truncateOneLine(s, n) {
+    const oneLine = s.replace(/\s+/g, " ").trim();
+    return oneLine.length <= n ? oneLine : oneLine.slice(0, n - 1).trimEnd() + "…";
+}
 //# sourceMappingURL=insights-cli.js.map