muonroi-cli 1.2.3 → 1.3.1

package/dist/src/ui/slash/ee.js

@@ -0,0 +1,271 @@
+/**
+ * src/ui/slash/ee.ts
+ *
+ * /ee slash command handler (P2 Knowledge Visibility).
+ * Surfaces EE knowledge management: stats, graph, timeline, gates, evolve, share/import.
+ *
+ * Self-registers on module import.
+ */
+import { getDefaultEEClient } from "../../ee/intercept.js";
+import { registerSlash } from "./registry.js";
+const UNREACHABLE = "**EE unreachable** — is the Experience Engine running on localhost:8082?";
+// ─── Formatters ──────────────────────────────────────────────────────────────
+function fmtStats(s) {
+    const lines = ["**EE Stats**", ""];
+    // Overview
+    lines.push("**Overview**");
+    lines.push(`  Intercepts: ${s.totalIntercepts}  |  Suggestions: ${s.suggestions}  |  Misses: ${s.misses}`);
+    if (s.mistakesDetected != null)
+        lines.push(`  Mistakes detected: ${s.mistakesDetected}`);
+    if (s.lessonsStored != null)
+        lines.push(`  Lessons stored: ${s.lessonsStored}`);
+    if (s.extractSessions != null)
+        lines.push(`  Extract sessions: ${s.extractSessions}`);
+    // Evolution
+    if (s.evolution) {
+        const e = s.evolution;
+        lines.push("");
+        lines.push("**Evolution**");
+        lines.push(`  Promoted: ${e.promoted}  |  Demoted: ${e.demoted}  |  Abstracted: ${e.abstracted}  |  Archived: ${e.archived}`);
+    }
+    // Per-project
+    if (s.perProject && Object.keys(s.perProject).length > 0) {
+        lines.push("");
+        lines.push("**Per Project**");
+        for (const [proj, data] of Object.entries(s.perProject)) {
+            lines.push(`  ${proj}: ${data.intercepts} intercepts, ${data.suggestions} suggestions`);
+        }
+    }
+    // Routing
+    if (s.routingStats) {
+        const r = s.routingStats;
+        lines.push("");
+        lines.push("**Routing**");
+        if (r.byTier && Object.keys(r.byTier).length > 0) {
+            lines.push(`  By tier: ${Object.entries(r.byTier)
+                .map(([k, v]) => `${k}=${v}`)
+                .join(", ")}`);
+        }
+        if (r.bySource && Object.keys(r.bySource).length > 0) {
+            lines.push(`  By source: ${Object.entries(r.bySource)
+                .map(([k, v]) => `${k}=${v}`)
+                .join(", ")}`);
+        }
+        if (r.outcomes && Object.keys(r.outcomes).length > 0) {
+            lines.push(`  Outcomes: ${Object.entries(r.outcomes)
+                .map(([k, v]) => `${k}=${v}`)
+                .join(", ")}`);
+        }
+    }
+    // Cost ledger
+    if (s.costLedger && s.costLedger.length > 0) {
+        lines.push("");
+        lines.push("**Cost Ledger** (recent)");
+        for (const row of s.costLedger.slice(-5)) {
+            const total = row.embed + row.brain + row.judge + row.extract;
+            lines.push(`  ${row.date}: $${total.toFixed(4)} (embed=$${row.embed.toFixed(4)} brain=$${row.brain.toFixed(4)} judge=$${row.judge.toFixed(4)} extract=$${row.extract.toFixed(4)})`);
+        }
+    }
+    return lines.join("\n");
+}
+function fmtTimeline(r) {
+    if (r.timeline.length === 0)
+        return `No timeline entries for topic "${r.topic}".`;
+    const lines = [`**Timeline: ${r.topic}** (${r.count} entries)`, ""];
+    for (const e of r.timeline) {
+        const tierBadge = `T${e.tier}`;
+        const superseded = e.superseded ? " ~~superseded~~" : "";
+        const confirms = e.confirmedAt.length;
+        lines.push(`- **[${tierBadge}]** ${e.trigger}${superseded}`);
+        lines.push(`  Solution: ${e.solution}`);
+        lines.push(`  Score: ${e.score} | Confirmed: ${confirms}x | ${e.createdAt}`);
+    }
+    return lines.join("\n");
+}
+function fmtGraph(r) {
+    if (r.edges.length === 0)
+        return `No graph edges for "${r.id}".`;
+    const lines = [`**Graph: ${r.id}** (${r.count} edges)`, ""];
+    for (const e of r.edges) {
+        const arrow = e.direction === "outgoing" ? "→" : "←";
+        lines.push(`  ${arrow} ${e.type} ${e.target} (weight: ${e.weight.toFixed(2)})`);
+    }
+    return lines.join("\n");
+}
+function fmtGates(r) {
+    const lines = ["**Quality Gates**", ""];
+    for (const g of r.gates) {
+        const icon = g.status === "pass" ? "✓" : g.status === "fail" ? "✗" : "●";
+        lines.push(`${icon} **${g.name}** — ${g.status}`);
+        for (const c of g.checks) {
+            const ci = c.ok ? "✓" : "✗";
+            lines.push(`  ${ci} ${c.label}${c.detail ? ` (${c.detail})` : ""}`);
+        }
+    }
+    return lines.join("\n");
+}
+function fmtEvolve(r) {
+    if (!r.success)
+        return "Evolve cycle failed.";
+    const lines = ["**Evolution cycle complete**"];
+    if (r.promoted != null)
+        lines.push(`  Promoted:   ${r.promoted}`);
+    if (r.demoted != null)
+        lines.push(`  Demoted:    ${r.demoted}`);
+    if (r.abstracted != null)
+        lines.push(`  Abstracted: ${r.abstracted}`);
+    if (r.archived != null)
+        lines.push(`  Archived:   ${r.archived}`);
+    return lines.join("\n");
+}
+function fmtShare(r) {
+    if (!r.success)
+        return "Share failed.";
+    return ["**Shared principle** (portable JSON):", "```json", JSON.stringify(r.shared, null, 2), "```"].join("\n");
+}
+function fmtRoute(r) {
+    const icon = r.confidence >= 0.7 ? "✓" : r.confidence >= 0.4 ? "●" : "?";
+    const lines = [
+        `**Task Route** ${icon} (confidence: ${(r.confidence * 100).toFixed(0)}%)`,
+        "",
+        `  Route: **${r.route ?? "needs clarification"}**`,
+        `  Reason: ${r.reason}`,
+        `  Source: ${r.source}`,
+    ];
+    if (r.needs_disambiguation && r.options.length > 0) {
+        lines.push("", "**Clarify before proceeding:**");
+        for (const opt of r.options) {
+            lines.push(`  - **${opt.label}** (\`${opt.route}\`): ${opt.description}`);
+        }
+    }
+    return lines.join("\n");
+}
+function fmtSearch(r) {
+    if (r.points.length === 0)
+        return "No results found.";
+    const lines = [`**Search Results** (${r.points.length} hits)`, ""];
+    for (const p of r.points) {
+        lines.push(`- **[${p.collection}]** (score: ${p.score.toFixed(3)})`);
+        lines.push(`  ${p.text.slice(0, 200)}${p.text.length > 200 ? "..." : ""}`);
+    }
+    return lines.join("\n");
+}
+const HELP = [
+    "**Experience Engine (/ee)**",
+    "",
+    "Usage:",
+    "  /ee stats [7d|30d|all]   — Knowledge base statistics",
+    "  /ee timeline <topic>     — Chronological principle evolution",
+    "  /ee graph <id>           — Principle relationship graph",
+    "  /ee gates                — Quality gate checklist",
+    "  /ee evolve               — Trigger evolution cycle",
+    "  /ee share <principleId>  — Export principle as portable JSON",
+    "  /ee import <json>        — Import a shared principle",
+    "  /ee route <task>         — Route task to workflow (discuss/execute/direct)",
+    "  /ee search <query>       — Semantic search across knowledge base",
+    "  /ee user                 — Current EE user identity",
+    "  /ee mode                 — Show detected client mode (thin/fat/disabled)",
+].join("\n");
+// ─── Handler ─────────────────────────────────────────────────────────────────
+export const handleEESlash = async (args, _ctx) => {
+    const sub = args[0]?.toLowerCase();
+    if (!sub)
+        return HELP;
+    const client = getDefaultEEClient();
+    switch (sub) {
+        case "stats": {
+            const since = args[1]; // "7d" | "30d" | "all" | undefined
+            const r = await client.stats(since);
+            return r ? fmtStats(r) : UNREACHABLE;
+        }
+        case "timeline": {
+            const topic = args.slice(1).join(" ");
+            if (!topic)
+                return "/ee timeline: please provide a topic — /ee timeline <topic>";
+            const r = await client.timeline(topic);
+            return r ? fmtTimeline(r) : UNREACHABLE;
+        }
+        case "graph": {
+            const id = args[1];
+            if (!id)
+                return "/ee graph: please provide an id — /ee graph <id>";
+            const r = await client.graph(id);
+            return r ? fmtGraph(r) : UNREACHABLE;
+        }
+        case "gates": {
+            const r = await client.gates();
+            return r ? fmtGates(r) : UNREACHABLE;
+        }
+        case "evolve": {
+            const r = await client.evolve();
+            return r ? fmtEvolve(r) : UNREACHABLE;
+        }
+        case "share": {
+            const pid = args[1];
+            if (!pid)
+                return "/ee share: please provide a principleId — /ee share <principleId>";
+            const r = await client.sharePrinciple(pid);
+            return r ? fmtShare(r) : UNREACHABLE;
+        }
+        case "import": {
+            const raw = args.slice(1).join(" ");
+            if (!raw)
+                return "/ee import: please provide JSON — /ee import <json>";
+            let parsed;
+            try {
+                parsed = JSON.parse(raw);
+            }
+            catch {
+                return "/ee import: invalid JSON.";
+            }
+            const r = await client.importPrinciple(parsed);
+            if (!r)
+                return UNREACHABLE;
+            return r.success ? "Principle imported successfully." : "Import failed.";
+        }
+        case "route": {
+            const task = args.slice(1).join(" ");
+            if (!task)
+                return "/ee route: please provide a task — /ee route <task description>";
+            const r = await client.routeTask({ task });
+            return r ? fmtRoute(r) : UNREACHABLE;
+        }
+        case "search": {
+            const query = args.slice(1).join(" ");
+            if (!query)
+                return "/ee search: please provide a query — /ee search <query>";
+            const r = await client.search(query);
+            return r ? fmtSearch(r) : UNREACHABLE;
+        }
+        case "user": {
+            const r = await client.user();
+            if (!r)
+                return UNREACHABLE;
+            return `**EE User:** ${r.user}`;
+        }
+        case "mode": {
+            const { detectEEClientMode, describeMode } = await import("../../ee/client-mode.js");
+            const info = await detectEEClientMode({ force: true });
+            const lines = [
+                `**EE Client Mode:** ${info.mode}`,
+                `  ${describeMode(info)}`,
+                "",
+                `  serverBaseUrl: ${info.serverBaseUrl ?? "(none)"}`,
+                `  hasAuthToken: ${info.hasAuthToken}`,
+                `  hasLocalCore: ${info.hasLocalCore}`,
+            ];
+            if (info.probeMs != null)
+                lines.push(`  /health probe: ${info.probeMs}ms`);
+            if (info.reason)
+                lines.push(`  reason: ${info.reason}`);
+            return lines.join("\n");
+        }
+        case "help":
+            return HELP;
+        default:
+            return `Unknown subcommand "${sub}".\n\n${HELP}`;
+    }
+};
+// Self-register on module import
+registerSlash("ee", handleEESlash);
+//# sourceMappingURL=ee.js.map

package/dist/src/ui/slash/ee.js.map

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

package/dist/src/ui/slash/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../../src/ui/slash/execute.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,CAAC,MAAM,kBAAkB,GAAiB,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IACnE,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAElD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,qCAAqC,CAAC;IAC/C,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAChD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,qBAAqB,WAAW,qBAAqB,CAAC;IAC/D,CAAC;IAED,4BAA4B;IAC5B,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3D,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;QACxB,OAAO,iCAAiC,CAAC;IAC3C,CAAC;IAED,6CAA6C;IAC7C,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC9C,MAAM,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IAEjE,OAAO,iBAAiB,WAAW,QAAQ,WAAW,EAAE,CAAC;AAC3D,CAAC,CAAC;AAEF,iCAAiC;AACjC,aAAa,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC"}

package/dist/src/ui/slash/expand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand.js","sourceRoot":"","sources":["../../../../src/ui/slash/expand.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,CAAC,MAAM,iBAAiB,GAAiB,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IAClE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;IAEhE,yBAAyB;IACzB,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,iDAAiD,CAAC;IAC3D,CAAC;IAED,4EAA4E;IAC5E,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEhE,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,iDAAiD,CAAC;IAC3D,CAAC;IAED,2BAA2B;IAC3B,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAEtD,iEAAiE;IACjE,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAE5B,0BAA0B;IAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IAEzC,qDAAqD;IACrD,OAAO,6BAA6B,UAAU,KAAK,KAAK,2CAA2C,OAAO,EAAE,CAAC;AAC/G,CAAC,CAAC;AAEF,iCAAiC;AACjC,aAAa,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC"}

package/dist/src/ui/slash/export.d.ts

@@ -0,0 +1,20 @@
+/**
+ * src/ui/slash/export.ts
+ *
+ * /export slash command — exports the conversation to a .txt file.
+ *
+ * Two sources of truth:
+ *   1. DB (`buildChatEntries`) — what was persisted as ModelMessages. Council
+ *      streams content via StreamChunks that never land in `messages`, so this
+ *      can come back empty even when the TUI is full of output.
+ *   2. Live TUI scrollback (`ctx.getLiveEntries`) — what the user actually
+ *      saw, including streamed council/tool/assistant chunks.
+ *
+ * The export writes BOTH (clearly labelled) when they diverge, so the user
+ * can compare what was persisted vs what was shown. When they match (typical
+ * resumed-session case), only one block is written.
+ *
+ * Self-registers on module import.
+ */
+import type { SlashHandler } from "./registry.js";
+export declare const handleExportSlash: SlashHandler;

package/dist/src/ui/slash/export.js

@@ -0,0 +1,253 @@
+/**
+ * src/ui/slash/export.ts
+ *
+ * /export slash command — exports the conversation to a .txt file.
+ *
+ * Two sources of truth:
+ *   1. DB (`buildChatEntries`) — what was persisted as ModelMessages. Council
+ *      streams content via StreamChunks that never land in `messages`, so this
+ *      can come back empty even when the TUI is full of output.
+ *   2. Live TUI scrollback (`ctx.getLiveEntries`) — what the user actually
+ *      saw, including streamed council/tool/assistant chunks.
+ *
+ * The export writes BOTH (clearly labelled) when they diverge, so the user
+ * can compare what was persisted vs what was shown. When they match (typical
+ * resumed-session case), only one block is written.
+ *
+ * Self-registers on module import.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getDatabase } from "../../storage/db.js";
+import { buildChatEntries } from "../../storage/transcript.js";
+import { registerSlash } from "./registry.js";
+function selectInteractionTimeline(sessionId) {
+    try {
+        const db = getDatabase();
+        return db
+            .prepare(`SELECT event_type, event_subtype, metadata_json, created_at
+         FROM interaction_logs
+         WHERE session_id = ?
+           AND event_type IN ('ui_interaction', 'routing', 'council', 'ee_injection')
+         ORDER BY created_at ASC, id ASC`)
+            .all(sessionId);
+    }
+    catch {
+        return [];
+    }
+}
+function renderInteractionTimeline(rows) {
+    if (rows.length === 0)
+        return [];
+    const lines = ["── Interaction Timeline ──", ""];
+    for (const r of rows) {
+        const ts = formatTimestamp(r.created_at);
+        const label = r.event_subtype ? `${r.event_type}.${r.event_subtype}` : r.event_type;
+        let detail = "";
+        if (r.metadata_json) {
+            try {
+                const meta = JSON.parse(r.metadata_json);
+                const parts = [];
+                for (const [k, v] of Object.entries(meta)) {
+                    if (v === null || v === undefined)
+                        continue;
+                    // Error/diagnostic fields get a larger budget so root cause is
+                    // legible directly in the timeline. Other strings stay terse.
+                    const isLongField = k === "message" || k === "error" || k === "reason";
+                    const cap = isLongField ? 400 : 80;
+                    const vStr = typeof v === "string" ? (v.length > cap ? `${v.slice(0, cap - 3)}…` : v) : JSON.stringify(v);
+                    parts.push(`${k}=${vStr}`);
+                }
+                detail = parts.length > 0 ? ` ${parts.join(" ")}` : "";
+            }
+            catch {
+                // Leave detail empty on bad JSON
+            }
+        }
+        lines.push(`[${ts}] ${label}${detail}`);
+    }
+    lines.push("");
+    return lines;
+}
+function formatTimestamp(ts) {
+    if (!ts)
+        return "";
+    const d = typeof ts === "string" ? new Date(ts) : ts;
+    return d.toISOString().replace("T", " ").slice(0, 19);
+}
+function renderEntries(entries) {
+    const lines = [];
+    for (const entry of entries) {
+        const ts = formatTimestamp(entry.timestamp);
+        switch (entry.type) {
+            case "user":
+                lines.push(`[${ts}] You:`);
+                lines.push(entry.content);
+                lines.push("");
+                break;
+            case "assistant":
+                lines.push(`[${ts}] Assistant:`);
+                lines.push(entry.content);
+                lines.push("");
+                break;
+            case "tool_result": {
+                const toolName = entry.toolCall?.function?.name ?? "unknown";
+                lines.push(`[${ts}] Tool [${toolName}]:`);
+                lines.push(entry.content);
+                lines.push("");
+                break;
+            }
+            default:
+                lines.push(`[${ts}] ${entry.type}:`);
+                lines.push(entry.content);
+                lines.push("");
+                break;
+        }
+    }
+    return lines;
+}
+/**
+ * Quick structural signature so we can detect whether DB and live scrollback
+ * are telling the same story without doing a full content diff. We compare
+ * total entry count and the count of each kind — if those match, the two
+ * sources almost certainly agree and we can emit a single block.
+ */
+function signature(entries) {
+    const counts = {};
+    for (const e of entries)
+        counts[e.type] = (counts[e.type] ?? 0) + 1;
+    return (`n=${entries.length} ` +
+        Object.entries(counts)
+            .sort()
+            .map(([k, v]) => `${k}:${v}`)
+            .join(" "));
+}
+function formatExport(dbEntries, liveEntries, timeline) {
+    const timelineBlock = renderInteractionTimeline(timeline);
+    const dbSig = signature(dbEntries);
+    const liveSig = signature(liveEntries);
+    const header = [
+        "=".repeat(72),
+        "  muonroi-cli — Chat Export",
+        "  Exported: " + formatTimestamp(new Date()),
+        `  DB entries:    ${dbEntries.length}`,
+        `  Live entries:  ${liveEntries.length}`,
+        `  Timeline rows: ${timeline.length}`,
+        "=".repeat(72),
+        "",
+    ];
+    // Case 1: DB and live agree — single block, source=db (canonical).
+    if (dbSig === liveSig && dbEntries.length > 0) {
+        return {
+            text: [
+                ...header,
+                "(DB and TUI scrollback match — single rendering)",
+                "",
+                ...timelineBlock,
+                ...renderEntries(dbEntries),
+                "=".repeat(72),
+                "  End of export",
+                "=".repeat(72),
+            ].join("\n"),
+            mode: "synced",
+        };
+    }
+    // Case 2: DB empty, live has content — common for council-only sessions
+    // where stream chunks bypass persistence. Use live as the source of truth.
+    if (dbEntries.length === 0 && liveEntries.length > 0) {
+        return {
+            text: [
+                ...header,
+                `NOTE: Database has 0 entries but TUI scrollback has ${liveEntries.length}. This usually`,
+                `means the conversation consisted of streamed chunks (council debate, tool traces)`,
+                `that render to the TUI but are not persisted as ModelMessages. Showing TUI scrollback.`,
+                "",
+                ...timelineBlock,
+                "── TUI Scrollback (in-memory) ──",
+                "",
+                ...renderEntries(liveEntries),
+                "=".repeat(72),
+                "  End of export",
+                "=".repeat(72),
+            ].join("\n"),
+            mode: "live_only",
+        };
+    }
+    // Case 3: Live empty, DB has content — slash invoked without TUI context
+    // (e.g., a non-interactive caller). Just render DB.
+    if (liveEntries.length === 0 && dbEntries.length > 0) {
+        return {
+            text: [
+                ...header,
+                "(Live scrollback unavailable — showing DB only)",
+                "",
+                ...timelineBlock,
+                ...renderEntries(dbEntries),
+                "=".repeat(72),
+                "  End of export",
+                "=".repeat(72),
+            ].join("\n"),
+            mode: "db_only",
+        };
+    }
+    // Case 4: Both have content but they disagree — emit both, side by side,
+    // so the caller can diff. This is the most useful mode for debugging why
+    // a council session "looked full" but persisted little.
+    return {
+        text: [
+            ...header,
+            `WARNING: DB and TUI scrollback disagree.`,
+            `  DB signature:    ${dbSig}`,
+            `  Live signature:  ${liveSig}`,
+            `Both renderings are included below for comparison.`,
+            "",
+            ...timelineBlock,
+            "─".repeat(72),
+            "── Section A: Persisted (DB)",
+            "─".repeat(72),
+            "",
+            ...renderEntries(dbEntries),
+            "─".repeat(72),
+            "── Section B: Live TUI Scrollback",
+            "─".repeat(72),
+            "",
+            ...renderEntries(liveEntries),
+            "=".repeat(72),
+            "  End of export",
+            "=".repeat(72),
+        ].join("\n"),
+        mode: "merged",
+    };
+}
+export const handleExportSlash = async (_args, ctx) => {
+    const sessionId = ctx.sessionId;
+    if (!sessionId) {
+        return "No active session. Start a conversation first.";
+    }
+    const dbEntries = buildChatEntries(sessionId);
+    const liveEntries = ctx.getLiveEntries?.() ?? [];
+    const timeline = selectInteractionTimeline(sessionId);
+    if (dbEntries.length === 0 && liveEntries.length === 0 && timeline.length === 0) {
+        return "No messages in the current session to export (DB, TUI scrollback, and timeline are all empty).";
+    }
+    const { text, mode } = formatExport(dbEntries, liveEntries, timeline);
+    const fileName = `chat-export-${sessionId}.txt`;
+    const filePath = path.resolve(ctx.cwd, fileName);
+    try {
+        fs.writeFileSync(filePath, text, "utf-8");
+        const modeNote = mode === "synced"
+            ? "DB and TUI matched"
+            : mode === "db_only"
+                ? "DB only (no TUI scrollback)"
+                : mode === "live_only"
+                    ? `TUI scrollback only (DB had 0 entries; ${liveEntries.length} live)`
+                    : `DB and TUI diverged — both included (db=${dbEntries.length}, live=${liveEntries.length})`;
+        return `Exported to ${filePath} (${(text.length / 1024).toFixed(1)} KB) — ${modeNote}`;
+    }
+    catch (err) {
+        return `Failed to write export file: ${err instanceof Error ? err.message : String(err)}`;
+    }
+};
+// Self-register on module import
+registerSlash("export", handleExportSlash);
+//# sourceMappingURL=export.js.map

package/dist/src/ui/slash/export.js.map

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

package/dist/src/ui/slash/ideal.d.ts

@@ -0,0 +1,60 @@
+/**
+ * src/ui/slash/ideal.ts
+ *
+ * `/ideal` — Product Ideal Loop slash command (Phase 13).
+ *
+ * Subcommands:
+ *   /ideal "<idea>"          start a new product run (default)
+ *   /ideal status            list active runs
+ *   /ideal status <runId>    detail of one run
+ *   /ideal resume <runId>    resume halted/crashed run
+ *   /ideal abort  <runId>    hard kill
+ *   /ideal ship   <runId>    force user-approval gate (skip if Cond #1-#4 pass)
+ *
+ * Flags (all optional):
+ *   --max-cost       <usd>   default 50,  range 1..1000
+ *   --max-sprints    <n>     default 8,   range 1..20
+ *   --done-threshold <0..1>  default 0.9, range 0.7..1.0   (clamped, warning emitted)
+ *   --stack          <text>  free-form stack hint
+ *
+ * Internal-only env hatch (intentionally not registered with commander so it
+ * does not appear in --help):
+ *   MUONROI_DEV=1  -> enables --no-customer-debate at the done-gate.
+ *
+ * Wire format: returns the sentinel string `__PRODUCT_LOOP__\n<json>` which
+ * app.tsx parses and dispatches to orchestrator.runProductLoopV1, mirroring
+ * the existing __COUNCIL__ pattern in src/ui/slash/council.ts.
+ */
+import type { SlashHandler } from "./registry.js";
+export interface IdealFlags {
+    maxCost: number;
+    maxSprints: number;
+    doneThreshold: number;
+    stack?: string;
+    /** Set internally when MUONROI_DEV=1; never accepted as a CLI flag. */
+    noCustomerDebate?: boolean;
+    /** P5: --no-prior-context skips cross-run workspace memory injection. */
+    noPriorContext?: boolean;
+    /** P2.7: --force-council always runs full council debate even for low-complexity ideas. */
+    forceCouncil?: boolean;
+}
+export type IdealSubcommand = "start" | "status" | "resume" | "abort" | "ship" | "help";
+export interface IdealParseResult {
+    subcommand: IdealSubcommand;
+    idea?: string;
+    runId?: string;
+    flags: IdealFlags;
+    warnings: string[];
+}
+/**
+ * Pure parser — exported so tests can exercise it without wiring through the
+ * SlashHandler signature (which depends on a SlashContext).
+ */
+export declare function parseIdealArgs(args: string[]): IdealParseResult;
+/**
+ * Slash handler. Returns a sentinel string parseable by app.tsx, OR a help/error
+ * string when no orchestrator dispatch is appropriate.
+ */
+export declare const handleIdealSlash: SlashHandler;
+/** Returned for --help introspection in tests. */
+export declare function getIdealHelpText(): string;