@unerr-ai/unerr 0.1.0 → 0.1.2

package/dist/components/ProgressBar.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Sub-character Unicode progress bar.
+ *
+ * Uses 9 block elements for smooth fill: ' ▏▎▍▌▋▊▉█'
+ * Used in health card, session summary, status displays.
+ */
+import { Box, Text } from "ink";
+import { useTheme } from "./Theme.js";
+const BLOCKS = [" ", "▏", "▎", "▍", "▌", "▋", "▊", "▉", "█"];
+export function ProgressBar({ value, width = 20, color, showLabel = false, }) {
+    const t = useTheme();
+    const clamped = Math.max(0, Math.min(1, value));
+    const fillWidth = clamped * width;
+    const fullBlocks = Math.floor(fillWidth);
+    const partialIndex = Math.round((fillWidth - fullBlocks) * (BLOCKS.length - 1));
+    const emptyBlocks = Math.max(0, width - fullBlocks - (partialIndex > 0 ? 1 : 0));
+    const bar = "█".repeat(fullBlocks) +
+        (partialIndex > 0 ? (BLOCKS[partialIndex] ?? "") : "") +
+        " ".repeat(emptyBlocks);
+    const barColor = color ?? t.info;
+    const pct = Math.round(clamped * 100);
+    return (_jsxs(Box, { children: [_jsx(Text, { color: barColor, children: bar }), showLabel && _jsxs(Text, { color: t.dim, children: [" ", pct, "%"] })] }));
+}
+/** Exported for testing */
+export { BLOCKS };

package/dist/components/Section.js

@@ -0,0 +1,16 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Section divider: ── Title ─────────────
+ *
+ * Used to separate visual sections in all displays.
+ */
+import { Box, Text } from "ink";
+import { useTheme } from "./Theme.js";
+export function Section({ title, width = 50, }) {
+    const t = useTheme();
+    const prefix = "── ";
+    const suffix = " ";
+    const remaining = Math.max(0, width - prefix.length - title.length - suffix.length);
+    const line = "─".repeat(remaining);
+    return (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: t.dim, children: [prefix, title, suffix, line] }) }));
+}

package/dist/components/SessionSummaryCard.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Session summary card — Ink-rendered shutdown display.
+ *
+ * Shows tool calls, local rate with ProgressBar, token savings,
+ * latency, specific "Caught" events, and cumulative "This week" stats.
+ * The retention trigger — quantifies what unerr *prevented*.
+ */
+import { Box, Text } from "ink";
+import { computePercentiles, totalCaughtEvents, } from "../proxy/session-stats.js";
+import { KeyValue } from "./KeyValue.js";
+import { ProgressBar } from "./ProgressBar.js";
+import { Section } from "./Section.js";
+import { useTheme } from "./Theme.js";
+export { createSessionEvents } from "../proxy/session-stats.js";
+/** Average cost per 1k tokens (blended Claude Sonnet input/output). */
+const COST_PER_1K_TOKENS = 0.006;
+/** Renders the "Caught" section shared between Standard and Local Mode cards. */
+function CaughtSection({ ev, color, }) {
+    const caughtTotal = totalCaughtEvents(ev);
+    if (caughtTotal === 0)
+        return null;
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, marginLeft: 4, children: [_jsx(Text, { color: color, bold: true, children: "Caught:" }), ev.conventionViolationsCaught > 0 && (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: color, children: [ev.conventionViolationsCaught, " convention violation", ev.conventionViolationsCaught !== 1 ? "s" : "", " before commit"] }) })), ev.chokepointWarningsIssued > 0 && (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: color, children: [ev.chokepointWarningsIssued, " chokepoint modification", ev.chokepointWarningsIssued !== 1 ? "s" : "", " warned"] }) })), ev.circularDepsDetected > 0 && (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: color, children: [ev.circularDepsDetected, " circular dep", ev.circularDepsDetected !== 1 ? "s" : "", " prevented"] }) })), ev.signaturePreservations > 0 && (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: color, children: [ev.signaturePreservations, " signature", ev.signaturePreservations !== 1 ? "s" : "", " preserved"] }) })), ev.deadCodeReferences > 0 && (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: color, children: [ev.deadCodeReferences, " dead code reference", ev.deadCodeReferences !== 1 ? "s" : "", " flagged"] }) }))] }));
+}
+/** Local Mode session summary — all-local proof, value surfacing, no deep link. */
+function LocalModeCard({ stats, lm, ev, cumulativeLocal, scorecard, }) {
+    const t = useTheme();
+    const total = stats.toolCallsLocal;
+    const durationMs = Date.now() - stats.sessionStartedAt;
+    const durationMin = Math.round(durationMs / 60_000);
+    const caughtTotal = totalCaughtEvents(ev);
+    const localP = computePercentiles(stats.latency.localSamples, stats.latency.localTotalSamples);
+    // Short session (<=10 calls) — compact line
+    if (total <= 10 && total > 0) {
+        return (_jsx(Box, { flexDirection: "column", children: _jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: t.dim, children: ["unerr local session: ", total, " tool calls (all local) \u00B7", " ", durationMin > 0 ? `${durationMin}m` : "<1m", caughtTotal > 0 ? ` · ${caughtTotal} caught` : ""] }) }) }));
+    }
+    if (total === 0)
+        return _jsx(Box, {});
+    const tokensSavedK = (lm.tokensSavedByTruncation / 1000).toFixed(1);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Section, { title: `unerr session (${durationMin > 0 ? `${durationMin} min` : "<1 min"})` }), _jsx(KeyValue, { label: "Tool calls", value: `${total} (all local)` }), scorecard && (_jsxs(Box, { flexDirection: "column", marginLeft: 4, children: [_jsxs(Text, { color: t.dim, children: ["Tokens saved: ~", scorecard.tokensSaved, " (", scorecard.dollarsSaved, ") \u2014 efficiency: ", scorecard.efficiency] }), scorecard.counterfactual && (_jsx(Text, { color: t.dim, children: scorecard.counterfactual }))] })), _jsxs(Box, { marginLeft: 4, children: [_jsx(Text, { color: t.dim, children: "Local rate " }), _jsx(ProgressBar, { value: 1, width: 24, color: t.success, showLabel: true })] }), localP && (_jsx(Box, { marginLeft: 4, children: _jsxs(Text, { color: t.dim, children: ["Latency p50=", localP.p50.toFixed(1), "ms \u00B7 p95=", localP.p95.toFixed(1), "ms", lm.cumulativeLatencySavedMs > 0
+                            ? ` · ${(lm.cumulativeLatencySavedMs / 1000).toFixed(1)}s saved vs remote`
+                            : ""] }) })), _jsx(CaughtSection, { ev: ev, color: t.warning }), (lm.blastRadiusComputations > 0 ||
+                lm.communityContextsInjected > 0 ||
+                lm.correctionPatternsInjected > 0) && (_jsxs(Box, { flexDirection: "column", marginTop: 1, marginLeft: 4, children: [_jsx(Text, { bold: true, children: "Intelligence Applied:" }), lm.blastRadiusComputations > 0 && (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: t.dim, children: [lm.blastRadiusComputations, " blast radius computation", lm.blastRadiusComputations !== 1 ? "s" : ""] }) })), lm.communityContextsInjected > 0 && (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: t.dim, children: [lm.communityContextsInjected, " community context", lm.communityContextsInjected !== 1 ? "s" : "", " injected"] }) })), lm.correctionPatternsInjected > 0 && (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: t.dim, children: [lm.correctionPatternsInjected, " correction pattern", lm.correctionPatternsInjected !== 1 ? "s" : "", " applied"] }) }))] })), lm.tokensSavedByTruncation > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, marginLeft: 4, children: [_jsx(Text, { bold: true, children: "Token Discipline:" }), _jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: t.dim, children: ["~", tokensSavedK, "k tokens saved via smart truncation"] }) }), _jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: t.dim, children: [lm.truncatedResponses, " response", lm.truncatedResponses !== 1 ? "s" : "", " budget-trimmed"] }) })] })), lm.semanticSearches > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, marginLeft: 4, children: [_jsx(Text, { bold: true, children: "Semantic Intelligence:" }), _jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: t.dim, children: [lm.semanticSearches, " quer", lm.semanticSearches !== 1 ? "ies" : "y", " via local embeddings"] }) })] })), _jsxs(Box, { flexDirection: "column", marginTop: 1, marginLeft: 4, children: [_jsx(Text, { bold: true, children: "Network Isolation:" }), _jsx(Box, { marginLeft: 2, children: _jsx(Text, { color: t.success, children: "Outbound: 0 calls (firewall sealed)" }) }), _jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: t.dim, children: ["Blocked attempts: ", lm.firewallBlockedCount, lm.firewallBlockedCount === 0 ? " (clean)" : ""] }) })] }), cumulativeLocal && cumulativeLocal.totalSessions > 1 && (_jsx(Box, { marginLeft: 4, marginTop: 1, children: _jsxs(Text, { color: t.dim, children: ["This week: ", cumulativeLocal.totalSessions, " sessions \u00B7 ~", (cumulativeLocal.totalTokensSaved / 1000).toFixed(0), "k tokens saved \u00B7 ", cumulativeLocal.totalViolationsCaught, " caught"] }) }))] }));
+}
+export function SessionSummaryCard({ stats, events, deepLink, cumulative, cumulativeLocal, scorecard, }) {
+    const t = useTheme();
+    const total = stats.toolCallsLocal;
+    // Use events from stats if not provided separately
+    const ev = events ?? stats.events;
+    // ── Local Mode variant ──
+    if (stats.localMode) {
+        return (_jsx(LocalModeCard, { stats: stats, lm: stats.localMode, ev: ev, cumulativeLocal: cumulativeLocal, scorecard: scorecard }));
+    }
+    // ── Standard Mode ────────────────────────────────────────────────
+    const localPct = total > 0 ? Math.round((stats.toolCallsLocal / total) * 100) : 0;
+    const tokensSavedK = (stats.estimatedTokensSaved / 1000).toFixed(1);
+    const costSaved = ((stats.estimatedTokensSaved / 1000) *
+        COST_PER_1K_TOKENS).toFixed(2);
+    const durationMs = Date.now() - stats.sessionStartedAt;
+    const durationMin = Math.round(durationMs / 60_000);
+    const localP = computePercentiles(stats.latency.localSamples, stats.latency.localTotalSamples);
+    const caughtTotal = totalCaughtEvents(ev);
+    // Only show full summary for meaningful sessions (>10 tool calls)
+    const isShortSession = total <= 10;
+    if (isShortSession && total > 0) {
+        return (_jsx(Box, { flexDirection: "column", children: _jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: t.dim, children: ["unerr session: ", total, " tool calls \u00B7", " ", durationMin > 0 ? `${durationMin}m` : "<1m", caughtTotal > 0 ? ` · ${caughtTotal} caught` : ""] }) }) }));
+    }
+    if (total === 0) {
+        return _jsx(Box, {});
+    }
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Section, { title: `unerr session (${durationMin > 0 ? `${durationMin} min` : "<1 min"})` }), _jsx(KeyValue, { label: "Tool calls", value: `${total} (all local)` }), _jsxs(Box, { marginLeft: 4, children: [_jsx(Text, { color: t.dim, children: "Local rate " }), _jsx(ProgressBar, { value: localPct / 100, width: 24, color: t.success, showLabel: true })] }), localP && (_jsx(Box, { marginLeft: 4, children: _jsxs(Text, { color: t.dim, children: ["Latency p50=", localP.p50.toFixed(1), "ms \u00B7 p95=", localP.p95.toFixed(1), "ms"] }) })), _jsx(CaughtSection, { ev: ev, color: t.warning }), _jsx(Box, { marginLeft: 4, marginTop: 1, children: _jsxs(Text, { children: ["Saved: ~", tokensSavedK, "k tokens ($", costSaved, ")"] }) }), cumulative && cumulative.totalSessions > 1 && (_jsx(Box, { marginLeft: 4, children: _jsxs(Text, { color: t.dim, children: ["This week: ", cumulative.totalSessions, " sessions \u00B7 ~", (cumulative.totalTokensSaved / 1000).toFixed(0), "k tokens \u00B7 $", cumulative.totalDollarsSaved.toFixed(2)] }) })), deepLink && (_jsx(Box, { marginLeft: 4, marginTop: 1, children: _jsxs(Text, { color: t.dim, children: ["Session \u2192 ", deepLink] }) }))] }));
+}

package/dist/components/StartupDisplay.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * StartupDisplay — Three-Act proxy startup renderer.
+ *
+ * Act 1: Instant Competence (brand + fast checks ≤2s)
+ * Act 2: Revelation (Health Shock card after graph load)
+ * Act 3: Invitation (agent suggestion + deep link)
+ *
+ * Driven by StartupState — proxy updates state, component re-renders.
+ */
+import { Box, Text } from "ink";
+import { Banner } from "./Banner.js";
+import { HealthCard } from "./HealthCard.js";
+import { Section } from "./Section.js";
+import { StepLine } from "./StepLine.js";
+import { useTheme } from "./Theme.js";
+export function StartupDisplay({ state, }) {
+    const t = useTheme();
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Banner, {}), _jsx(Box, { flexDirection: "column", children: state.steps.map((step) => (_jsx(StepLine, { label: step.label, value: step.value, status: step.status }, step.label))) }), state.health && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: state.localMode ? (_jsxs(_Fragment, { children: [_jsx(Section, { title: "Health (locally computed)" }), _jsx(HealthCard, { health: state.health, compact: true })] })) : (_jsxs(_Fragment, { children: [_jsx(Section, { title: "First Look" }), _jsx(HealthCard, { health: state.health, compact: !state.firstBoot })] })) })), state.ready && state.localMode && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsxs(Box, { marginLeft: 2, children: [_jsxs(Text, { color: t.success, children: [state.toolCount ?? 0, " tools ready"] }), _jsx(Text, { color: t.dim, children: " \u00B7 fully local, offline-capable" })] }), _jsxs(Box, { marginLeft: 2, marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: t.dim, children: "Try asking your agent:" }), _jsx(Box, { marginLeft: 2, children: _jsx(Text, { color: t.info, children: state.invitationEntity
+                                        ? `"What depends on ${state.invitationEntity}?"`
+                                        : `"Show me the highest-impact functions in this codebase" (use unerr MCP tools & skills for best results)` }) })] })] })), state.ready && !state.localMode && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [state.invitationEntity && (_jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [_jsx(Text, { color: t.dim, children: "Your agent can now see the blast radius. Try asking:" }), _jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: t.info, children: ["\"What depends on ", state.invitationEntity, "?\""] }) })] })), _jsx(Box, { marginLeft: 2, marginTop: 1, children: _jsxs(Text, { children: ["Proxy ready. Serving MCP on stdio.", state.proxyMode && state.proxyMode !== "full"
+                                    ? ` (${state.proxyMode} mode)`
+                                    : ""] }) }), state.deepLink && (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: t.dim, children: ["Health details \u2192 ", state.deepLink] }) }))] }))] }));
+}

package/dist/components/StatusDashboard.js

@@ -0,0 +1,57 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * StatusDashboard — Ink-rendered `unerr status` display.
+ *
+ * Shows repo info, branch context, proxy state, graph stats,
+ * drift summary, health grade, and live latency.
+ * Every display includes a deep link (§0.7 Constraint #8).
+ */
+import { Box, Text } from "ink";
+import { DriftSummary } from "./DriftSummary.js";
+import { GradeBadge } from "./GradeBadge.js";
+import { KeyValue } from "./KeyValue.js";
+import { ProgressBar } from "./ProgressBar.js";
+import { Section } from "./Section.js";
+import { useTheme } from "./Theme.js";
+export function StatusDashboard({ data, }) {
+    const t = useTheme();
+    const totalCalls = data.liveToolCalls ? data.liveToolCalls.local : 0;
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Section, { title: "unerr status" }), _jsx(KeyValue, { label: "Repo", value: `${data.repoName}${data.repoId ? ` (${data.repoId})` : ""}` }), _jsx(KeyValue, { label: "Branch", value: data.branchDetail ?? data.branch }), _jsx(KeyValue, { label: "Proxy", value: data.proxyStatus, valueColor: data.proxyRunning ? t.success : t.dim }), data.localMode && (_jsx(KeyValue, { label: "Mode", value: data.localMode.mode === "local"
+                    ? "Local (offline)"
+                    : "Standard (connected)", valueColor: data.localMode.mode === "local" ? t.success : undefined })), _jsx(KeyValue, { label: "Graph", value: data.graphInfo }), data.healthGrade && (_jsxs(Box, { marginLeft: 4, children: [_jsx(Text, { color: t.dim, children: "Health " }), _jsx(GradeBadge, { grade: data.healthGrade, score: data.healthScore })] })), data.ruleHealth && data.ruleHealth.total > 0 && (_jsxs(Box, { marginLeft: 4, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: t.dim, children: "Rules: " }), _jsxs(Text, { children: [data.ruleHealth.total, " active"] }), _jsx(Text, { color: t.dim, children: " " }), _jsxs(Text, { color: t.success, children: ["\u25CF ", data.ruleHealth.healthy, " healthy"] }), _jsx(Text, { color: t.dim, children: " " }), _jsxs(Text, { color: t.warning, children: ["\u25CF ", data.ruleHealth.aging, " aging"] }), _jsx(Text, { color: t.dim, children: " " }), _jsxs(Text, { color: "red", children: ["\u25CF ", data.ruleHealth.decayed, " decayed"] }), _jsxs(Text, { color: t.dim, children: [" \u25CB ", data.ruleHealth.dormant, " dormant"] })] }), data.ruleHealth.warnings.map((w) => (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: t.warning, children: ["\u26A0 \"", w.key, "\" \u2014 override rate ", w.overrideRate, "%, decay score", " ", w.decayScore.toFixed(2)] }) }, w.key)))] })), data.drift && (_jsx(Box, { marginLeft: 4, marginTop: 1, children: _jsx(DriftSummary, { drift: data.drift }) })), data.liveToolCalls && totalCalls > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(KeyValue, { label: "Session", value: `${totalCalls} calls (all local)` }), _jsxs(Box, { marginLeft: 4, children: [_jsx(Text, { color: t.dim, children: "Local rate " }), _jsx(ProgressBar, { value: 1, width: 20, color: t.success, showLabel: true })] })] })), data.latency && (_jsx(Box, { marginLeft: 4, children: _jsxs(Text, { color: t.dim, children: ["Latency", data.latency.localP50 != null
+                            ? ` p50=${data.latency.localP50.toFixed(1)}ms p99=${(data.latency.localP99 ?? 0).toFixed(1)}ms`
+                            : "", data.latency.localBudgetExceeded ? " ⚠ >5ms" : ""] }) })), data.indexingStatus && (_jsx(KeyValue, { label: "Indexing", value: data.indexingStatus })), data.deepLink && (_jsx(Box, { marginLeft: 4, marginTop: 1, children: _jsxs(Text, { color: t.dim, children: ["Dashboard \u2192 ", data.deepLink] }) })), data.localMode?.mode === "local" && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(KeyValue, { label: "Firewall", value: data.localMode.firewallBlocked != null
+                            ? `${data.localMode.firewallStatus} (${data.localMode.firewallBlocked} blocked)`
+                            : data.localMode.firewallStatus, valueColor: t.success }), data.localMode.byoLlm && (_jsx(KeyValue, { label: "BYO-LLM", value: data.localMode.byoLlm, valueColor: data.localMode.byoLlmStatus === "connected"
+                            ? t.success
+                            : data.localMode.byoLlmStatus === "unreachable"
+                                ? "red"
+                                : t.dim })), data.localMode.lastIndexed && (_jsx(KeyValue, { label: "Indexed", value: data.localMode.lastIndexed })), data.localMode.communityCount != null &&
+                        data.localMode.communityCount > 0 && (_jsx(KeyValue, { label: "Communities", value: `${data.localMode.communityCount} clusters` })), data.localMode.conventionCount != null &&
+                        data.localMode.conventionCount > 0 && (_jsx(KeyValue, { label: "Conventions", value: `${data.localMode.conventionCount} detected` })), data.localMode.ruleCount != null && data.localMode.ruleCount > 0 && (_jsx(KeyValue, { label: "Rules", value: `${data.localMode.ruleCount} active` })), data.localMode.corrections != null &&
+                        data.localMode.corrections > 0 && (_jsx(KeyValue, { label: "Corrections", value: `${data.localMode.corrections} learned patterns` })), data.localMode.hookStatus && (_jsx(KeyValue, { label: "Hooks / MCP", value: data.localMode.hookStatus })), data.localMode.shellCompression && (_jsxs(Box, { flexDirection: "column", children: [_jsx(KeyValue, { label: "Shell compress", value: `${data.localMode.shellCompression.events} events · ~${data.localMode.shellCompression.tokensSavedApprox.toLocaleString()} tok saved · PreToolUse bash ${data.localMode.shellCompression.preBashHookConfigured ? "configured" : "not detected"}` }), data.localMode.shellCompression.recentEvents &&
+                                data.localMode.shellCompression.recentEvents.length > 0 && (_jsxs(Box, { marginLeft: 4, flexDirection: "column", children: [_jsx(Text, { color: t.dim, children: "Recent compressions:" }), data.localMode.shellCompression.recentEvents
+                                        .slice(0, 5)
+                                        .map((ev, i) => {
+                                        const cmdShort = ev.command.length > 30
+                                            ? `${ev.command.slice(0, 27)}...`
+                                            : ev.command;
+                                        return (_jsxs(Text, { color: t.dim, children: [" ", cmdShort, " \u2192 ", ev.category, " (", ev.savedPct, "% saved", ev.omniFallback ? ", omni" : "", ")"] }, `${ev.ts}-${i}`));
+                                    })] }))] })), data.localMode.recentFileReadEvents &&
+                        data.localMode.recentFileReadEvents.length > 0 && (_jsxs(Box, { flexDirection: "column", children: [_jsx(KeyValue, { label: "File reads", value: `${data.localMode.recentFileReadEvents.length} recent optimizations` }), _jsxs(Box, { marginLeft: 4, flexDirection: "column", children: [_jsx(Text, { color: t.dim, children: "Recent file reads:" }), data.localMode.recentFileReadEvents
+                                        .slice(0, 5)
+                                        .map((ev, i) => {
+                                        const fileShort = ev.file.length > 40
+                                            ? `...${ev.file.slice(-37)}`
+                                            : ev.file;
+                                        return (_jsxs(Text, { color: t.dim, children: [" ", fileShort, " \u2192 ", ev.mode, " (", ev.savedPct, "% saved)"] }, `${ev.ts}-${i}`));
+                                    })] })] })), data.localMode.skillCount != null && (_jsxs(Box, { flexDirection: "column", children: [_jsx(KeyValue, { label: "Skills", value: `${data.localMode.skillCount} installed` }), data.localMode.skillNames &&
+                                data.localMode.skillNames.length > 0 && (_jsx(Box, { marginLeft: 4, flexDirection: "column", children: data.localMode.skillNames.map((name) => (_jsxs(Text, { color: t.dim, children: [" ", name] }, name))) }))] })), data.localMode.ledgerEntryCount != null &&
+                        data.localMode.ledgerEntryCount > 0 && (_jsx(KeyValue, { label: "Ledger", value: `${data.localMode.ledgerEntryCount} entries` })), data.localMode.logPath && (_jsx(KeyValue, { label: "Logs", value: data.localMode.logPath })), !data.proxyRunning && data.localMode.lastSession && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Section, { title: `Last session (${data.localMode.lastSession.endedAt}, ${data.localMode.lastSession.durationMin} min)` }), _jsx(KeyValue, { label: "  Tool calls", value: `${data.localMode.lastSession.toolCalls} (all local)` }), data.localMode.lastSession.violationsCaught > 0 && (_jsx(KeyValue, { label: "  Violations", value: `${data.localMode.lastSession.violationsCaught} caught` })), data.localMode.lastSession.tokensSaved > 0 && (_jsx(KeyValue, { label: "  Tokens saved", value: `~${data.localMode.lastSession.tokensSaved.toLocaleString()}` }))] })), data.localMode.cumulative &&
+                        data.localMode.cumulative.sessions > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Section, { title: "This Week (Local Mode)" }), _jsx(KeyValue, { label: "  Sessions", value: String(data.localMode.cumulative.sessions) }), _jsx(KeyValue, { label: "  Tool calls", value: data.localMode.cumulative.toolCalls.toLocaleString() }), _jsx(KeyValue, { label: "  Tokens saved", value: `~${data.localMode.cumulative.tokensSaved.toLocaleString()}` }), _jsx(KeyValue, { label: "  Violations", value: `${data.localMode.cumulative.violations} caught` }), data.localMode.cumulative.corrections > 0 && (_jsx(KeyValue, { label: "  Corrections", value: `${data.localMode.cumulative.corrections} injected` }))] })), data.localMode.suggestions &&
+                        data.localMode.suggestions.length > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Section, { title: "Suggestions" }), data.localMode.suggestions.map((s) => (_jsxs(Text, { color: t.dim, children: [" ", "\u00B7 ", s] }, s)))] }))] })), data.tokenFlow && data.tokenFlow.tokensSaved > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Section, { title: "Token Flow (this session)" }), _jsx(KeyValue, { label: "Tokens saved", value: `${data.tokenFlow.tokensSaved.toLocaleString()}` }), _jsx(KeyValue, { label: "Tokens delivered", value: `${data.tokenFlow.tokensDelivered.toLocaleString()}` }), _jsx(KeyValue, { label: "Efficiency", value: `${data.tokenFlow.efficiencyPct}%` }), data.tokenFlow.byMechanism.length > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: t.dim, children: " By mechanism:" }), data.tokenFlow.byMechanism.map((m) => {
+                                const barLen = Math.max(1, Math.round(m.pctOfTotal / 5));
+                                const bar = "█".repeat(barLen) + "░".repeat(20 - barLen);
+                                return (_jsxs(Text, { color: t.dim, children: ["    ", _jsx(Text, { children: m.mechanism.padEnd(22) }), _jsx(Text, { color: t.success, children: m.tokensSaved.toLocaleString().padStart(8) }), "  ", _jsx(Text, { color: t.dim, children: `${m.pctOfTotal}%`.padStart(5) }), "  ", _jsx(Text, { color: t.success, children: bar })] }, m.mechanism));
+                            })] })), data.tokenFlow.topTurn && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: t.dim, children: ["  Most efficient: ", _jsx(Text, { bold: true, children: data.tokenFlow.topTurn.tool }), " → ", _jsx(Text, { color: t.success, children: data.tokenFlow.topTurn.tokensSaved.toLocaleString() }), " saved"] }) }))] }))] }));
+}

package/dist/components/StatusLine.js

@@ -0,0 +1,8 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * StatusLine — shows token usage and cost at the bottom of the screen.
+ */
+import { Box, Text } from "ink";
+export function StatusLine({ usage }) {
+    return (_jsx(Box, { marginTop: 0, marginBottom: 1, children: _jsxs(Text, { color: "gray", dimColor: true, children: ["tokens: ", usage.inputTokens, " in / ", usage.outputTokens, " out", " · ", "$", usage.estimatedCost.toFixed(4)] }) }));
+}

package/dist/components/StepLine.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Step status line: ✓ Label    Value
+ *
+ * Used in startup sequence and status displays.
+ * Named StepLine to avoid conflict with existing StatusLine (REPL token display).
+ */
+import { Box, Text } from "ink";
+import { useTheme } from "./Theme.js";
+const ICONS = {
+    done: { char: "✓", colorKey: "success" },
+    active: { char: "●", colorKey: "info" },
+    pending: { char: "○", colorKey: "dim" },
+    error: { char: "✗", colorKey: "error" },
+};
+export function StepLine({ label, value, status, labelWidth = 22, }) {
+    const t = useTheme();
+    const icon = ICONS[status];
+    const color = t[icon.colorKey];
+    const padded = label.padEnd(labelWidth);
+    return (_jsxs(Box, { marginLeft: 2, children: [_jsx(Text, { color: color, children: icon.char }), _jsx(Text, { children: " " }), _jsx(Text, { color: status === "pending" ? t.dim : undefined, children: padded }), value && _jsx(Text, { children: value })] }));
+}

package/dist/components/Theme.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+export const theme = {
+    success: "green",
+    warning: "yellow",
+    error: "red",
+    info: "cyan",
+    accent: "magenta",
+    dim: "gray",
+    brand: "cyanBright",
+    grade: (g) => ({ A: "green", B: "cyan", C: "yellow", D: "red", F: "red" })[g[0] ?? ""] ??
+        "gray",
+};
+const ThemeContext = createContext(theme);
+export function useTheme() {
+    return useContext(ThemeContext);
+}
+export function ThemeProvider({ children, }) {
+    return (_jsx(ThemeContext.Provider, { value: theme, children: children }));
+}

package/dist/components/ToolProgress.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * ToolProgress — shows active tool calls with status indicators.
+ */
+import { Box, Text } from "ink";
+export function ToolProgress({ tools }) {
+    return (_jsx(Box, { flexDirection: "column", marginBottom: 1, children: tools.map((tool) => (_jsxs(Box, { children: [_jsx(Text, { color: tool.status === "running" ? "yellow" : "green", children: tool.status === "running" ? "⟳ " : "✓ " }), _jsx(Text, { color: tool.status === "running" ? "yellow" : "gray", children: tool.name })] }, `${tool.name}-${tool.status}`))) }));
+}

package/dist/components/ViolationList.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Rule violation list with severity indicators.
+ *
+ * Used in post-flight checks and pre-commit displays.
+ */
+import { Box, Text } from "ink";
+import { useTheme } from "./Theme.js";
+const SEVERITY_ICONS = {
+    error: "✗",
+    warning: "⚠",
+    info: "ℹ",
+};
+export function ViolationList({ violations, title, }) {
+    const t = useTheme();
+    if (violations.length === 0) {
+        return (_jsx(Box, { marginLeft: 4, children: _jsx(Text, { color: t.success, children: "\u2713 No violations" }) }));
+    }
+    const severityColor = (s) => ({ error: t.error, warning: t.warning, info: t.info })[s];
+    return (_jsxs(Box, { flexDirection: "column", children: [title && (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { bold: true, children: [violations.length, " violation", violations.length !== 1 ? "s" : ""] }) })), violations.map((v) => (_jsxs(Box, { flexDirection: "column", marginLeft: 4, children: [_jsxs(Box, { children: [_jsx(Text, { color: severityColor(v.severity), children: SEVERITY_ICONS[v.severity] }), _jsxs(Text, { children: [" ", v.message] }), v.file && _jsxs(Text, { color: t.dim, children: [" (", v.file, ")"] })] }), v.suggestion && (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { color: t.dim, children: ["\u2192 ", v.suggestion] }) }))] }, `${v.severity}-${v.message}`)))] }));
+}

package/dist/components/render.js

@@ -0,0 +1,13 @@
+/**
+ * Stderr rendering for Ink components.
+ *
+ * Critical: MCP JSON-RPC owns stdout. All Ink output goes to stderr.
+ * This wrapper ensures no Ink component accidentally writes to stdout.
+ */
+import { render } from "ink";
+/**
+ * Render an Ink element to stderr, keeping stdout clean for MCP JSON-RPC.
+ */
+export function renderToStderr(element) {
+    return render(element, { stdout: process.stderr, stdin: process.stdin });
+}

package/dist/config/agent-registry.js

@@ -0,0 +1,237 @@
+/**
+ * Agent Registry — defines all supported AI coding agents and their MCP config locations.
+ *
+ * Data-driven approach: adding a new agent = adding an entry here, no new code needed.
+ * Each agent has detection rules (directory markers, env vars) and config path/format.
+ */
+/**
+ * Registry of all supported AI coding agents.
+ * Ordered by popularity/relevance.
+ */
+export const AGENT_REGISTRY = [
+    {
+        id: "cursor",
+        name: "Cursor",
+        projectConfigPath: ".cursor/mcp.json",
+        configFormat: "mcp-json",
+        dirMarkers: [".cursor"],
+        envVars: ["CURSOR_TRACE_ID"],
+        hookSupport: true,
+        description: "AI-native code editor (VS Code fork)",
+        instructionFilePath: ".cursor/rules/unerr-instructions.mdc",
+        instructionFormat: "mdc",
+    },
+    {
+        id: "claude-code",
+        name: "Claude Code",
+        projectConfigPath: ".mcp.json",
+        configFormat: "mcp-json",
+        dirMarkers: [".claude"],
+        envVars: ["CLAUDE_CODE"],
+        hookSupport: true,
+        description: "Anthropic's CLI coding agent",
+        instructionFilePath: "CLAUDE.md",
+        instructionFormat: "markdown",
+    },
+    {
+        id: "vscode",
+        name: "VS Code",
+        projectConfigPath: ".vscode/mcp.json",
+        configFormat: "mcp-json",
+        dirMarkers: [".vscode"],
+        envVars: [],
+        hookSupport: false,
+        description: "Visual Studio Code with Copilot Chat",
+        instructionFilePath: ".github/copilot-instructions.md",
+        instructionFormat: "markdown",
+    },
+    {
+        id: "windsurf",
+        name: "Windsurf",
+        projectConfigPath: ".codeium/windsurf/mcp_config.json",
+        configScope: "global",
+        configFormat: "mcp-json",
+        dirMarkers: [".windsurf"],
+        envVars: ["WINDSURF_EDITOR"],
+        hookSupport: true,
+        description: "Codeium's AI IDE (Cascade)",
+        instructionFilePath: ".windsurf/rules/unerr-instructions.md",
+        instructionFormat: "windsurf-rule",
+    },
+    {
+        id: "zed",
+        name: "Zed",
+        projectConfigPath: ".zed/mcp.json",
+        configFormat: "mcp-json",
+        dirMarkers: [".zed"],
+        envVars: ["ZED_TERM"],
+        hookSupport: false,
+        description: "High-performance multiplayer editor",
+        instructionFilePath: null,
+        instructionFormat: null,
+    },
+    {
+        id: "cline",
+        name: "Cline",
+        projectConfigPath: ".cline/mcp.json",
+        configFormat: "mcp-json",
+        dirMarkers: [".cline"],
+        envVars: [],
+        hookSupport: true,
+        description: "Autonomous AI coding agent (VS Code extension)",
+        instructionFilePath: ".clinerules",
+        instructionFormat: "markdown",
+    },
+    {
+        id: "kiro",
+        name: "Kiro",
+        projectConfigPath: ".kiro/mcp.json",
+        configFormat: "mcp-json",
+        dirMarkers: [".kiro"],
+        envVars: [],
+        hookSupport: false,
+        description: "AWS AI-powered IDE",
+        instructionFilePath: null,
+        instructionFormat: null,
+    },
+    {
+        id: "gemini-cli",
+        name: "Gemini CLI",
+        projectConfigPath: ".gemini/settings.json",
+        configFormat: "settings-json",
+        dirMarkers: [".gemini"],
+        envVars: ["GEMINI_API_KEY", "GEMINI_CLI"],
+        hookSupport: true,
+        description: "Google's CLI coding agent",
+        instructionFilePath: "GEMINI.md",
+        instructionFormat: "markdown",
+    },
+    {
+        id: "codex",
+        name: "Codex",
+        projectConfigPath: ".codex/mcp.json",
+        configFormat: "mcp-json",
+        dirMarkers: [".codex"],
+        envVars: [],
+        hookSupport: false,
+        description: "OpenAI's CLI coding agent",
+        instructionFilePath: "AGENTS.md",
+        instructionFormat: "markdown",
+    },
+    {
+        id: "aider",
+        name: "Aider",
+        projectConfigPath: ".aider/mcp.json",
+        configFormat: "mcp-json",
+        dirMarkers: [".aider"],
+        envVars: ["AIDER_MODEL"],
+        hookSupport: false,
+        description: "AI pair programming in your terminal",
+        instructionFilePath: null,
+        instructionFormat: null,
+    },
+    {
+        id: "opencode",
+        name: "OpenCode",
+        projectConfigPath: ".opencode/mcp.json",
+        configFormat: "mcp-json",
+        dirMarkers: [".opencode"],
+        envVars: [],
+        hookSupport: false,
+        description: "Open-source terminal coding agent",
+        instructionFilePath: null,
+        instructionFormat: null,
+    },
+    {
+        id: "trae",
+        name: "Trae",
+        projectConfigPath: ".trae/mcp.json",
+        configFormat: "mcp-json",
+        dirMarkers: [".trae"],
+        envVars: [],
+        hookSupport: false,
+        description: "ByteDance AI IDE",
+        instructionFilePath: null,
+        instructionFormat: null,
+    },
+    {
+        id: "augment",
+        name: "Augment",
+        projectConfigPath: ".augment/mcp.json",
+        configFormat: "mcp-json",
+        dirMarkers: [".augment"],
+        envVars: [],
+        hookSupport: false,
+        description: "AI code assistant with deep context",
+        instructionFilePath: null,
+        instructionFormat: null,
+    },
+    {
+        id: "github-copilot-cli",
+        name: "GitHub Copilot CLI",
+        projectConfigPath: ".copilot/mcp-config.json",
+        configFormat: "copilot-json",
+        dirMarkers: [".github", ".copilot"],
+        envVars: ["GITHUB_COPILOT_TOKEN"],
+        hookSupport: true,
+        description: "GitHub's CLI AI assistant",
+        instructionFilePath: ".github/copilot-instructions.md",
+        instructionFormat: "markdown",
+    },
+    {
+        id: "continue",
+        name: "Continue",
+        projectConfigPath: ".continue/config.json",
+        configFormat: "continue-config",
+        dirMarkers: [".continue"],
+        envVars: [],
+        hookSupport: false,
+        description: "Open-source AI code assistant (VS Code/JetBrains)",
+        instructionFilePath: null,
+        instructionFormat: null,
+    },
+    {
+        id: "antigravity",
+        name: "Google Antigravity",
+        projectConfigPath: ".antigravity/mcp_config.json",
+        configFormat: "mcp-json",
+        dirMarkers: [".antigravity", ".agents"],
+        envVars: ["ANTIGRAVITY_PROJECT_DIR", "ANTIGRAVITY_VERSION"],
+        hookSupport: false,
+        description: "Google's AI coding IDE (Gemini 3)",
+        instructionFilePath: ".agents/rules/unerr-instructions.md",
+        instructionFormat: "antigravity-rule",
+    },
+];
+/**
+ * Get an agent definition by its ID.
+ */
+export function getAgent(id) {
+    return AGENT_REGISTRY.find((a) => a.id === id);
+}
+/**
+ * Get all agents that can be auto-configured (have standard MCP config).
+ */
+export function getConfigurableAgents() {
+    return AGENT_REGISTRY.filter((a) => a.id !== "other" && a.id !== "unknown");
+}
+/**
+ * Normalize agent name aliases to canonical IdeType values.
+ * e.g. "claude" → "claude-code", "gemini" → "gemini-cli"
+ */
+export function normalizeAgentName(input) {
+    const aliases = {
+        claude: "claude-code",
+        "claude-desktop": "claude-code",
+        copilot: "github-copilot-cli",
+        "copilot-cli": "github-copilot-cli",
+        gemini: "gemini-cli",
+        code: "vscode",
+        vs: "vscode",
+        google: "antigravity",
+        "google-antigravity": "antigravity",
+        windsurf: "windsurf",
+        cascade: "windsurf",
+    };
+    return aliases[input.toLowerCase()] ?? input.toLowerCase();
+}