pi-mega-compact 0.13.0 → 0.13.2

package/extensions/dashboard-client/dist/assets/{useSSE-ClbbcgIp.js → useSSE-BYOtv1-3.js}

@@ -1,2 +1,2 @@
-import{r as e}from"./index-D-lPLRWB.js";function R(i={}){const{maxEvents:c=500,maxReconnects:l=5}=i,[f,v]=e.useState([]),[E,n]=e.useState("connecting"),[S,p]=e.useState(0),[m,d]=e.useState(null),o=e.useRef(0),s=e.useRef(null),r=e.useCallback(()=>{s.current&&s.current.close(),n("connecting");const t=new EventSource("/api/events");s.current=t,t.onopen=()=>{n("connected"),o.current=0},t.onmessage=g=>{try{const x=JSON.parse(g.data);v(u=>{const a=[...u,x];return a.length>c?a.slice(-c):a}),p(u=>u+1),d(Date.now())}catch{}},t.onerror=()=>{t.close(),o.current<l?(o.current+=1,n("connecting"),setTimeout(r,1e3)):n("disconnected")}},[c,l]);return e.useEffect(()=>(r(),()=>{s.current?.close()}),[r]),{events:f,status:E,eventCount:S,lastEventAt:m}}export{R as u};
-//# sourceMappingURL=useSSE-ClbbcgIp.js.map
+import{r as e}from"./index-mOlljTFI.js";function R(i={}){const{maxEvents:c=500,maxReconnects:l=5}=i,[f,v]=e.useState([]),[E,n]=e.useState("connecting"),[S,p]=e.useState(0),[m,d]=e.useState(null),o=e.useRef(0),s=e.useRef(null),r=e.useCallback(()=>{s.current&&s.current.close(),n("connecting");const t=new EventSource("/api/events");s.current=t,t.onopen=()=>{n("connected"),o.current=0},t.onmessage=g=>{try{const x=JSON.parse(g.data);v(u=>{const a=[...u,x];return a.length>c?a.slice(-c):a}),p(u=>u+1),d(Date.now())}catch{}},t.onerror=()=>{t.close(),o.current<l?(o.current+=1,n("connecting"),setTimeout(r,1e3)):n("disconnected")}},[c,l]);return e.useEffect(()=>(r(),()=>{s.current?.close()}),[r]),{events:f,status:E,eventCount:S,lastEventAt:m}}export{R as u};
+//# sourceMappingURL=useSSE-BYOtv1-3.js.map

package/extensions/dashboard-client/dist/assets/{useSSE-ClbbcgIp.js.map → useSSE-BYOtv1-3.js.map}

@@ -1 +1 @@
-{"version":3,"file":"useSSE-ClbbcgIp.js","sources":["../../src/hooks/useSSE.ts"],"sourcesContent":["/**\n * dashboard-client/src/hooks/useSSE.ts — Server-Sent Events hook.\n *\n * Connects to /api/events, provides real-time event stream.\n * SPRINT-B1: basic connection. SPRINT-D1: reconnect with backoff.\n */\n\nimport { useState, useEffect, useRef, useCallback } from 'react';\nimport type { SseEvent } from '../../../dashboard-server/api-contracts';\n\nexport type SseStatus = 'connecting' | 'connected' | 'disconnected' | 'error';\n\nexport interface UseSSEResult {\n  events: SseEvent[];\n  status: SseStatus;\n  eventCount: number;\n  lastEventAt: number | null;\n}\n\nexport interface UseSSEOptions {\n  /** Max events to keep in memory (ring buffer). */\n  maxEvents?: number;\n  /** Max reconnect attempts before giving up. */\n  maxReconnects?: number;\n}\n\n// SPRINT-D1-REMAINING: exponential backoff (1s → 2s → 4s → max 30s).\n// SPRINT-D1-REMAINING: after 5 failures, set status='disconnected'.\n\nexport function useSSE(options: UseSSEOptions = {}): UseSSEResult {\n  const { maxEvents = 500, maxReconnects = 5 } = options;\n  const [events, setEvents] = useState<SseEvent[]>([]);\n  const [status, setStatus] = useState<SseStatus>('connecting');\n  const [eventCount, setEventCount] = useState(0);\n  const [lastEventAt, setLastEventAt] = useState<number | null>(null);\n  const reconnectCount = useRef(0);\n  const sourceRef = useRef<EventSource | null>(null);\n\n  const connect = useCallback(() => {\n    if (sourceRef.current) {\n      sourceRef.current.close();\n    }\n    setStatus('connecting');\n    const source = new EventSource('/api/events');\n    sourceRef.current = source;\n\n    source.onopen = () => {\n      setStatus('connected');\n      reconnectCount.current = 0;\n    };\n\n    source.onmessage = (event) => {\n      try {\n        const parsed = JSON.parse(event.data) as SseEvent;\n        setEvents(prev => {\n          const next = [...prev, parsed];\n          return next.length > maxEvents ? next.slice(-maxEvents) : next;\n        });\n        setEventCount(c => c + 1);\n        setLastEventAt(Date.now());\n      } catch {\n        // non-fatal: skip malformed events\n      }\n    };\n\n    source.onerror = () => {\n      source.close();\n      if (reconnectCount.current < maxReconnects) {\n        reconnectCount.current += 1;\n        setStatus('connecting');\n        // SPRINT-D1: use exponential backoff instead of fixed delay\n        setTimeout(connect, 1000);\n      } else {\n        setStatus('disconnected');\n      }\n    };\n  }, [maxEvents, maxReconnects]);\n\n  useEffect(() => {\n    connect();\n    return () => {\n      sourceRef.current?.close();\n    };\n  }, [connect]);\n\n  return { events, status, eventCount, lastEventAt };\n}\n"],"names":["useSSE","options","maxEvents","maxReconnects","events","setEvents","useState","status","setStatus","eventCount","setEventCount","lastEventAt","setLastEventAt","reconnectCount","useRef","sourceRef","connect","useCallback","source","event","parsed","prev","next","c","useEffect"],"mappings":"wCA6BO,SAASA,EAAOC,EAAyB,GAAkB,CAChE,KAAM,CAAE,UAAAC,EAAY,IAAK,cAAAC,EAAgB,GAAMF,EACzC,CAACG,EAAQC,CAAS,EAAIC,EAAAA,SAAqB,CAAA,CAAE,EAC7C,CAACC,EAAQC,CAAS,EAAIF,EAAAA,SAAoB,YAAY,EACtD,CAACG,EAAYC,CAAa,EAAIJ,EAAAA,SAAS,CAAC,EACxC,CAACK,EAAaC,CAAc,EAAIN,EAAAA,SAAwB,IAAI,EAC5DO,EAAiBC,EAAAA,OAAO,CAAC,EACzBC,EAAYD,EAAAA,OAA2B,IAAI,EAE3CE,EAAUC,EAAAA,YAAY,IAAM,CAC5BF,EAAU,SACZA,EAAU,QAAQ,MAAA,EAEpBP,EAAU,YAAY,EACtB,MAAMU,EAAS,IAAI,YAAY,aAAa,EAC5CH,EAAU,QAAUG,EAEpBA,EAAO,OAAS,IAAM,CACpBV,EAAU,WAAW,EACrBK,EAAe,QAAU,CAC3B,EAEAK,EAAO,UAAaC,GAAU,CAC5B,GAAI,CACF,MAAMC,EAAS,KAAK,MAAMD,EAAM,IAAI,EACpCd,EAAUgB,GAAQ,CAChB,MAAMC,EAAO,CAAC,GAAGD,EAAMD,CAAM,EAC7B,OAAOE,EAAK,OAASpB,EAAYoB,EAAK,MAAM,CAACpB,CAAS,EAAIoB,CAC5D,CAAC,EACDZ,EAAca,GAAKA,EAAI,CAAC,EACxBX,EAAe,KAAK,KAAK,CAC3B,MAAQ,CAER,CACF,EAEAM,EAAO,QAAU,IAAM,CACrBA,EAAO,MAAA,EACHL,EAAe,QAAUV,GAC3BU,EAAe,SAAW,EAC1BL,EAAU,YAAY,EAEtB,WAAWQ,EAAS,GAAI,GAExBR,EAAU,cAAc,CAE5B,CACF,EAAG,CAACN,EAAWC,CAAa,CAAC,EAE7BqB,OAAAA,EAAAA,UAAU,KACRR,EAAA,EACO,IAAM,CACXD,EAAU,SAAS,MAAA,CACrB,GACC,CAACC,CAAO,CAAC,EAEL,CAAE,OAAAZ,EAAQ,OAAAG,EAAQ,WAAAE,EAAY,YAAAE,CAAA,CACvC"}
+{"version":3,"file":"useSSE-BYOtv1-3.js","sources":["../../src/hooks/useSSE.ts"],"sourcesContent":["/**\n * dashboard-client/src/hooks/useSSE.ts — Server-Sent Events hook.\n *\n * Connects to /api/events, provides real-time event stream.\n * SPRINT-B1: basic connection. SPRINT-D1: reconnect with backoff.\n */\n\nimport { useState, useEffect, useRef, useCallback } from 'react';\nimport type { SseEvent } from '../../../dashboard-server/api-contracts';\n\nexport type SseStatus = 'connecting' | 'connected' | 'disconnected' | 'error';\n\nexport interface UseSSEResult {\n  events: SseEvent[];\n  status: SseStatus;\n  eventCount: number;\n  lastEventAt: number | null;\n}\n\nexport interface UseSSEOptions {\n  /** Max events to keep in memory (ring buffer). */\n  maxEvents?: number;\n  /** Max reconnect attempts before giving up. */\n  maxReconnects?: number;\n}\n\n// SPRINT-D1-REMAINING: exponential backoff (1s → 2s → 4s → max 30s).\n// SPRINT-D1-REMAINING: after 5 failures, set status='disconnected'.\n\nexport function useSSE(options: UseSSEOptions = {}): UseSSEResult {\n  const { maxEvents = 500, maxReconnects = 5 } = options;\n  const [events, setEvents] = useState<SseEvent[]>([]);\n  const [status, setStatus] = useState<SseStatus>('connecting');\n  const [eventCount, setEventCount] = useState(0);\n  const [lastEventAt, setLastEventAt] = useState<number | null>(null);\n  const reconnectCount = useRef(0);\n  const sourceRef = useRef<EventSource | null>(null);\n\n  const connect = useCallback(() => {\n    if (sourceRef.current) {\n      sourceRef.current.close();\n    }\n    setStatus('connecting');\n    const source = new EventSource('/api/events');\n    sourceRef.current = source;\n\n    source.onopen = () => {\n      setStatus('connected');\n      reconnectCount.current = 0;\n    };\n\n    source.onmessage = (event) => {\n      try {\n        const parsed = JSON.parse(event.data) as SseEvent;\n        setEvents(prev => {\n          const next = [...prev, parsed];\n          return next.length > maxEvents ? next.slice(-maxEvents) : next;\n        });\n        setEventCount(c => c + 1);\n        setLastEventAt(Date.now());\n      } catch {\n        // non-fatal: skip malformed events\n      }\n    };\n\n    source.onerror = () => {\n      source.close();\n      if (reconnectCount.current < maxReconnects) {\n        reconnectCount.current += 1;\n        setStatus('connecting');\n        // SPRINT-D1: use exponential backoff instead of fixed delay\n        setTimeout(connect, 1000);\n      } else {\n        setStatus('disconnected');\n      }\n    };\n  }, [maxEvents, maxReconnects]);\n\n  useEffect(() => {\n    connect();\n    return () => {\n      sourceRef.current?.close();\n    };\n  }, [connect]);\n\n  return { events, status, eventCount, lastEventAt };\n}\n"],"names":["useSSE","options","maxEvents","maxReconnects","events","setEvents","useState","status","setStatus","eventCount","setEventCount","lastEventAt","setLastEventAt","reconnectCount","useRef","sourceRef","connect","useCallback","source","event","parsed","prev","next","c","useEffect"],"mappings":"wCA6BO,SAASA,EAAOC,EAAyB,GAAkB,CAChE,KAAM,CAAE,UAAAC,EAAY,IAAK,cAAAC,EAAgB,GAAMF,EACzC,CAACG,EAAQC,CAAS,EAAIC,EAAAA,SAAqB,CAAA,CAAE,EAC7C,CAACC,EAAQC,CAAS,EAAIF,EAAAA,SAAoB,YAAY,EACtD,CAACG,EAAYC,CAAa,EAAIJ,EAAAA,SAAS,CAAC,EACxC,CAACK,EAAaC,CAAc,EAAIN,EAAAA,SAAwB,IAAI,EAC5DO,EAAiBC,EAAAA,OAAO,CAAC,EACzBC,EAAYD,EAAAA,OAA2B,IAAI,EAE3CE,EAAUC,EAAAA,YAAY,IAAM,CAC5BF,EAAU,SACZA,EAAU,QAAQ,MAAA,EAEpBP,EAAU,YAAY,EACtB,MAAMU,EAAS,IAAI,YAAY,aAAa,EAC5CH,EAAU,QAAUG,EAEpBA,EAAO,OAAS,IAAM,CACpBV,EAAU,WAAW,EACrBK,EAAe,QAAU,CAC3B,EAEAK,EAAO,UAAaC,GAAU,CAC5B,GAAI,CACF,MAAMC,EAAS,KAAK,MAAMD,EAAM,IAAI,EACpCd,EAAUgB,GAAQ,CAChB,MAAMC,EAAO,CAAC,GAAGD,EAAMD,CAAM,EAC7B,OAAOE,EAAK,OAASpB,EAAYoB,EAAK,MAAM,CAACpB,CAAS,EAAIoB,CAC5D,CAAC,EACDZ,EAAca,GAAKA,EAAI,CAAC,EACxBX,EAAe,KAAK,KAAK,CAC3B,MAAQ,CAER,CACF,EAEAM,EAAO,QAAU,IAAM,CACrBA,EAAO,MAAA,EACHL,EAAe,QAAUV,GAC3BU,EAAe,SAAW,EAC1BL,EAAU,YAAY,EAEtB,WAAWQ,EAAS,GAAI,GAExBR,EAAU,cAAc,CAE5B,CACF,EAAG,CAACN,EAAWC,CAAa,CAAC,EAE7BqB,OAAAA,EAAAA,UAAU,KACRR,EAAA,EACO,IAAM,CACXD,EAAU,SAAS,MAAA,CACrB,GACC,CAACC,CAAO,CAAC,EAEL,CAAE,OAAAZ,EAAQ,OAAAG,EAAQ,WAAAE,EAAY,YAAAE,CAAA,CACvC"}

package/extensions/dashboard-client/dist/index.html

@@ -4,7 +4,7 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>mega-compact dashboard</title>
-    <script type="module" crossorigin src="./assets/index-D-lPLRWB.js"></script>
+    <script type="module" crossorigin src="./assets/index-mOlljTFI.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-CUNn22iV.css">
   </head>
   <body>

package/extensions/dashboard-client/src/App.tsx

@@ -17,7 +17,6 @@ import type { SnapshotResponse } from "@contracts";
 const OverviewTab = React.lazy(() => import("./tabs/OverviewTab"));
 const ReposTab = React.lazy(() => import("./tabs/ReposTab"));
 const EventsTab = React.lazy(() => import("./tabs/EventsTab"));
-const ConfigTab = React.lazy(() => import("./tabs/ConfigTab"));
 const SetupTab = React.lazy(() => import("./tabs/SetupTab"));
 const MetricsTab = React.lazy(() => import("./tabs/MetricsTab"));
 const CacheTab = React.lazy(() => import("./tabs/CacheTab"));
@@ -32,7 +31,6 @@ export type TabId =
 	| "overview"
 	| "repos"
 	| "events"
-	| "config"
 	| "setup"
 	| "metrics"
 	| "cache"
@@ -56,7 +54,6 @@ const PRIMARY_TABS: TabDef[] = [
 const ADVANCED_TABS: TabDef[] = [
 	{ id: "repos", label: "Repos" },
 	{ id: "events", label: "Events" },
-	{ id: "config", label: "Config" },
 	{ id: "setup", label: "Setup" },
 	{ id: "metrics", label: "Metrics" },
 	{ id: "topics", label: "Topics" },
@@ -111,7 +108,6 @@ export default function App(): React.ReactElement {
 						)}
 						{activeTab === "repos" && <ReposTab />}
 						{activeTab === "events" && <EventsTab />}
-						{activeTab === "config" && <ConfigTab />}
 						{activeTab === "setup" && <SetupTab />}
 						{activeTab === "metrics" && <MetricsTab />}
 						{activeTab === "cache" && <CacheTab />}

package/extensions/dashboard-client/src/api/client.ts

@@ -46,6 +46,8 @@ import type {
 	SetupDetectResponse,
 	SetupConfigureRequest,
 	SetupConfigureResponse,
+	EmbedderHealthResponse,
+	RaptorTreeResponse,
 } from "@contracts";
 
 /** Error thrown when a dashboard API response is not 2xx. */
@@ -307,3 +309,17 @@ export function configureEmbedder(
 ): Promise<SetupConfigureResponse> {
 	return postJson<SetupConfigureResponse>(ENDPOINTS.setupConfigure.path, body);
 }
+
+// ─── RAPTOR tree (Part B) ─────────────────────────────────────────────
+
+/** GET /api/raptor-tree — tree for a session (defaults to latest with nodes). */
+export function fetchRaptorTree(sessionId?: string): Promise<RaptorTreeResponse> {
+	return getJson<RaptorTreeResponse>(
+		`${ENDPOINTS.raptorTree.path}${query({ sessionId })}`,
+	);
+}
+
+/** GET /api/embedder-health — round-trip a test embed through the active embedder. */
+export function fetchEmbedderHealth(): Promise<EmbedderHealthResponse> {
+	return getJson<EmbedderHealthResponse>(ENDPOINTS.embedderHealth.path);
+}

package/extensions/dashboard-client/src/tabs/MaintenanceTab/ActionsCard.tsx

@@ -0,0 +1,178 @@
+/**
+ * dashboard-client/src/tabs/MaintenanceTab/ActionsCard.tsx — Actions card.
+ *
+ * Extracted from MaintenanceTab.tsx (delegate-shell split). One-time
+ * maintenance operations (vacuum, checkpoint, reindex, prune, …) with a
+ * results history.
+ */
+import type React from "react";
+import { useState, useCallback } from "react";
+import type {
+	MaintenanceAction,
+	MaintenanceActionResult,
+} from "@contracts";
+import { postMaintenanceAction } from "../../api/client";
+
+// ---------------------------------------------------------------------------
+// Action config
+// ---------------------------------------------------------------------------
+
+interface ActionDef {
+	key: string;
+	label: string;
+	desc: string;
+	dangerous: boolean;
+	confirm?: string;
+	daysOld?: boolean;
+}
+
+const ACTIONS: ActionDef[] = [
+	{
+		key: "integrity-check",
+		label: "Integrity Check",
+		desc: "Run PRAGMA integrity_check",
+		dangerous: false,
+	},
+	{
+		key: "reconcile-dedup",
+		label: "Reconcile Dedup Mirror",
+		desc: "Fix orphan dedup rows + backfill refs",
+		dangerous: false,
+		confirm: "Reconcile dedup_mirror (safe read/write)?",
+	},
+	{
+		key: "checkpoint",
+		label: "WAL Checkpoint",
+		desc: "Merge WAL into main DB (read-only)",
+		dangerous: false,
+	},
+	{
+		key: "vacuum",
+		label: "VACUUM",
+		desc: "Rebuild DB reclaiming free pages",
+		dangerous: true,
+		confirm: "VACUUM rewrites the entire DB. Continue?",
+	},
+	{
+		key: "reindex",
+		label: "REINDEX",
+		desc: "Rebuild all indexes",
+		dangerous: true,
+		confirm: "REINDEX rebuilds indexes. Continue?",
+	},
+	{
+		key: "fts5-rebuild",
+		label: "FTS5 Rebuild",
+		desc: "Rebuild full-text search index",
+		dangerous: true,
+		confirm: "Rebuild FTS5 trigram index. Continue?",
+	},
+	{
+		key: "prune",
+		label: "Prune Old Rows",
+		desc: "Delete transcripts + epochs older than N days",
+		dangerous: true,
+		daysOld: true,
+		confirm: "Delete old raw_transcript rows. Continue?",
+	},
+];
+
+// ---------------------------------------------------------------------------
+// Actions card
+// ---------------------------------------------------------------------------
+
+export function ActionsCard(): React.ReactElement {
+	const [results, setResults] = useState<MaintenanceActionResult[]>([]);
+	const [running, setRunning] = useState<string | null>(null);
+	const [days, setDays] = useState("30");
+
+	const handleAction = useCallback(
+		async (def: ActionDef) => {
+			const action: MaintenanceAction = def.daysOld
+				? { action: "prune", daysOld: Number(days) }
+				: ({ action: def.key } as MaintenanceAction);
+
+			setRunning(def.key);
+			try {
+				const res = await postMaintenanceAction(action);
+				setResults((prev) =>
+					[{ ...res, timestamp: Date.now() }, ...prev].slice(0, 20),
+				);
+			} catch (err) {
+				setResults((prev) =>
+					[
+						{
+							operation: def.key,
+							success: false,
+							affected: 0,
+							reclaimedBytes: 0,
+							summary: err instanceof Error ? err.message : String(err),
+							timestamp: Date.now(),
+						},
+						...prev,
+					].slice(0, 20),
+				);
+			} finally {
+				setRunning(null);
+			}
+		},
+		[days],
+	);
+
+	return (
+		<div className="card">
+			<div className="card-header">Actions</div>
+			<div className="card-body">
+				<div className="action-grid">
+					{ACTIONS.map((def) => {
+						const isRunning = running === def.key;
+						const lastResult = results.find((r) => r.operation === def.key);
+						return (
+							<div key={def.key} className="action-item">
+								<div className="action-info">
+									<div className="action-label">
+										{def.label}
+										{def.dangerous && (
+											<span className="badge badge-warn">DESTRUCTIVE</span>
+										)}
+									</div>
+									<div className="action-desc">{def.desc}</div>
+									{lastResult && (
+										<div
+											className={`action-result ${lastResult.success ? "text-ok" : "text-error"}`}
+										>
+											{lastResult.summary}
+										</div>
+									)}
+								</div>
+								<div className="action-controls">
+									{def.daysOld && (
+										<input
+											type="number"
+											min={1}
+											max={365}
+											value={days}
+											onChange={(e) => setDays(e.target.value)}
+											className="days-input"
+											disabled={isRunning}
+										/>
+									)}
+									<button
+										className={`btn ${def.dangerous ? "btn-danger" : "btn-primary"}`}
+										disabled={running !== null}
+										onClick={() => {
+											if (def.confirm && !window.confirm(def.confirm)) return;
+											handleAction(def);
+										}}
+									>
+										{isRunning ? "Running…" : "Run"}
+									</button>
+								</div>
+							</div>
+						);
+					})}
+				</div>
+			</div>
+		</div>
+	);
+}

package/extensions/dashboard-client/src/tabs/MaintenanceTab/DbStatsCard.tsx

@@ -0,0 +1,140 @@
+/**
+ * dashboard-client/src/tabs/MaintenanceTab/DbStatsCard.tsx — DB Stats card.
+ *
+ * Extracted from MaintenanceTab.tsx (delegate-shell split). Renders file sizes
+ * and table row counts from GET /api/maintenance.
+ */
+import type React from "react";
+import type { DbStatsResponse } from "@contracts";
+
+// ---------------------------------------------------------------------------
+// Format helpers (local — matches html.ts fmtBytes)
+// ---------------------------------------------------------------------------
+
+export function fmtBytes(b: number): string {
+	if (b < 1024) return `${b} B`;
+	if (b < 1024 * 1024) return `${(b / 1024).toFixed(1)} KB`;
+	return `${(b / (1024 * 1024)).toFixed(1)} MB`;
+}
+
+// ---------------------------------------------------------------------------
+// DB Stats card
+// ---------------------------------------------------------------------------
+
+function FileSizesCard({
+	files,
+	pageSize,
+	pageCount,
+	freelistPages,
+}: {
+	files: DbStatsResponse["storage"]["files"];
+	pageSize: number;
+	pageCount: number;
+	freelistPages: number;
+}): React.ReactElement {
+	const total = files.dbBytes + files.walBytes + files.shmBytes;
+	return (
+		<div className="stat-section">
+			<div className="stat-label">File Sizes</div>
+			<table className="compact-table">
+				<tbody>
+					<tr>
+						<td>sqlite.db</td>
+						<td className="num">{fmtBytes(files.dbBytes)}</td>
+					</tr>
+					{files.walBytes > 0 && (
+						<tr>
+							<td>.wal</td>
+							<td className="num">{fmtBytes(files.walBytes)}</td>
+						</tr>
+					)}
+					{files.shmBytes > 0 && (
+						<tr>
+							<td>.shm</td>
+							<td className="num">{fmtBytes(files.shmBytes)}</td>
+						</tr>
+					)}
+					<tr>
+						<td>Total</td>
+						<td className="num">{fmtBytes(total)}</td>
+					</tr>
+					<tr>
+						<td>Page size</td>
+						<td className="num">{fmtBytes(pageSize)}</td>
+					</tr>
+					<tr>
+						<td>Pages</td>
+						<td className="num">
+							{pageCount.toLocaleString()} ({freelistPages.toLocaleString()}{" "}
+							free)
+						</td>
+					</tr>
+				</tbody>
+			</table>
+		</div>
+	);
+}
+
+function TableRowCountsCard({
+	tables,
+}: {
+	tables: DbStatsResponse["tables"];
+}): React.ReactElement {
+	const totalRows = tables.reduce((s, t) => s + Math.max(0, t.rowCount), 0);
+	return (
+		<div className="stat-section">
+			<div className="stat-label">
+				Table Row Counts ({totalRows.toLocaleString()} total)
+			</div>
+			<table className="compact-table">
+				<thead>
+					<tr>
+						<th>Table</th>
+						<th className="num">Rows</th>
+					</tr>
+				</thead>
+				<tbody>
+					{tables.map((t) => (
+						<tr key={t.table}>
+							<td>{t.table}</td>
+							<td className="num">
+								{t.rowCount >= 0 ? t.rowCount.toLocaleString() : "—"}
+							</td>
+						</tr>
+					))}
+				</tbody>
+			</table>
+		</div>
+	);
+}
+
+export function DbStatsCard({
+	data,
+	loading,
+	error,
+}: {
+	data: DbStatsResponse | null;
+	loading: boolean;
+	error: Error | null;
+}): React.ReactElement {
+	return (
+		<div className="card">
+			<div className="card-header">DB Stats</div>
+			<div className="card-body">
+				{loading && !data && <span className="text-muted">Loading…</span>}
+				{error && !data && <span className="text-error">{error.message}</span>}
+				{data && (
+					<>
+						<FileSizesCard
+							files={data.storage.files}
+							pageSize={data.storage.pageSize}
+							pageCount={data.storage.pageCount}
+							freelistPages={data.storage.freelistPages}
+						/>
+						<TableRowCountsCard tables={data.tables} />
+					</>
+				)}
+			</div>
+		</div>
+	);
+}

package/extensions/dashboard-client/src/tabs/MaintenanceTab/DebugBundleCard.tsx

@@ -0,0 +1,109 @@
+/**
+ * dashboard-client/src/tabs/MaintenanceTab/DebugBundleCard.tsx — Debug Bundle card.
+ *
+ * Extracted from MaintenanceTab.tsx (delegate-shell split). Gather a diagnostic
+ * bundle (events, config, schema health, store stats) and let the user copy or
+ * download it for bug reports.
+ */
+import type React from "react";
+import { useState, useCallback } from "react";
+import type { DebugBundleResponse } from "@contracts";
+import { fetchDebugBundle } from "../../api/client";
+
+// ---------------------------------------------------------------------------
+// Debug bundle card — gather diagnostic info for bug reports
+// ---------------------------------------------------------------------------
+
+export function DebugBundleCard(): React.ReactElement {
+	const [bundle, setBundle] = useState<DebugBundleResponse | null>(null);
+	const [loading, setLoading] = useState(false);
+	const [error, setError] = useState<string | null>(null);
+	const [showJson, setShowJson] = useState(false);
+
+	const gather = useCallback(async () => {
+		setLoading(true);
+		setError(null);
+		try {
+			const res = await fetchDebugBundle();
+			setBundle(res);
+			setShowJson(true);
+		} catch (err) {
+			setError(err instanceof Error ? err.message : String(err));
+		} finally {
+			setLoading(false);
+		}
+	}, []);
+
+	const copyToClipboard = useCallback(() => {
+		if (!bundle) return;
+		const text = JSON.stringify(bundle, null, 2);
+		void navigator.clipboard.writeText(text).catch(() => {});
+	}, [bundle]);
+
+	const downloadJson = useCallback(() => {
+		if (!bundle) return;
+		const text = JSON.stringify(bundle, null, 2);
+		const blob = new Blob([text], { type: "application/json" });
+		const url = URL.createObjectURL(blob);
+		const a = document.createElement("a");
+		a.href = url;
+		a.download = `mega-compact-debug-bundle-${bundle.builtAt}.json`;
+		a.click();
+		URL.revokeObjectURL(url);
+	}, [bundle]);
+
+	const criticalCount = bundle?.criticalEvents.length ?? 0;
+
+	return (
+		<div className="card">
+			<div className="card-header">
+				Debug Bundle
+				{criticalCount > 0 && (
+					<span className="text-warn" style={{ marginLeft: "1em" }}>
+						{criticalCount} critical event{criticalCount !== 1 ? "s" : ""} found
+					</span>
+				)}
+			</div>
+			<div className="card-body">
+				<p className="text-muted" style={{ marginBottom: "0.75em" }}>
+					Gather a diagnostic bundle (recent events, config flags, schema health,
+					store stats) to attach to a bug report. Critical/compaction events are
+					highlighted.
+				</p>
+				<button onClick={gather} disabled={loading} style={{ marginRight: "0.5em" }}>
+					{loading ? "Gathering…" : "Gather Debug Logs"}
+				</button>
+				{error && <div className="text-error">{error}</div>}
+				{bundle && showJson && (
+					<>
+						<div style={{ marginTop: "0.75em", marginBottom: "0.5em" }}>
+							<button onClick={copyToClipboard} style={{ marginRight: "0.5em" }}>
+								Copy to clipboard
+							</button>
+							<button onClick={downloadJson}>Download JSON</button>
+							<button
+								onClick={() => setShowJson((v) => !v)}
+								style={{ marginLeft: "0.5em" }}
+							>
+								{showJson ? "Hide" : "Show"}
+							</button>
+						</div>
+						{criticalCount > 0 && (
+							<div className="stat-section">
+								<div className="stat-label text-warn">
+									Critical events ({criticalCount})
+								</div>
+								<pre className="text-mono" style={{ maxHeight: "12em", overflow: "auto" }}>
+									{JSON.stringify(bundle.criticalEvents, null, 2)}
+								</pre>
+							</div>
+						)}
+						<pre className="text-mono" style={{ maxHeight: "24em", overflow: "auto" }}>
+							{JSON.stringify(bundle, null, 2)}
+						</pre>
+					</>
+				)}
+			</div>
+		</div>
+	);
+}

package/extensions/dashboard-client/src/tabs/MaintenanceTab/HealthMitigationCard.tsx

@@ -0,0 +1,98 @@
+/**
+ * dashboard-client/src/tabs/MaintenanceTab/HealthMitigationCard.tsx — Health
+ * Mitigation card.
+ *
+ * Extracted from MaintenanceTab.tsx (delegate-shell split). Toggles auto-
+ * mitigation for degraded context (forced compaction / prefix break).
+ */
+import type React from "react";
+import { useState, useCallback, useEffect } from "react";
+
+// ---------------------------------------------------------------------------
+// Health Mitigation card — toggle auto-mitigation for degraded context
+// ---------------------------------------------------------------------------
+
+export function HealthMitigationCard(): React.ReactElement {
+	const [mitigate, setMitigate] = useState(false);
+	const [loading, setLoading] = useState(true);
+	const [saving, setSaving] = useState(false);
+	const [error, setError] = useState<string | null>(null);
+
+	const load = useCallback(async () => {
+		try {
+			const { fetchHealthSettings } = await import("../../api/health");
+			const s = await fetchHealthSettings();
+			setMitigate(s.mitigate);
+		} catch (e) {
+			setError(e instanceof Error ? e.message : String(e));
+		} finally {
+			setLoading(false);
+		}
+	}, []);
+
+	useEffect(() => { void load(); }, [load]);
+
+	const toggle = useCallback(async () => {
+		setSaving(true);
+		setError(null);
+		try {
+			const { setHealthMitigate } = await import("../../api/health");
+			const next = !mitigate;
+			await setHealthMitigate(next);
+			setMitigate(next);
+		} catch (e) {
+			setError(e instanceof Error ? e.message : String(e));
+		} finally {
+			setSaving(false);
+		}
+	}, [mitigate]);
+
+	return (
+		<div className="stat-section maintenance-card">
+			<div className="stat-label">Context Health Mitigation</div>
+			{loading ? (
+				<p className="repo-none">Loading…</p>
+			) : (
+				<>
+					<div className="health-mitigate-row">
+						<label className="health-mitigate-toggle">
+							<input
+								type="checkbox"
+								checked={mitigate}
+								onChange={toggle}
+								disabled={saving}
+							/>
+							<span>Auto-mitigation {mitigate ? "ON" : "OFF"}</span>
+						</label>
+					</div>
+					<div className="health-mitigate-info">
+						<p>
+							When <strong>ON</strong>, the extension automatically intervenes when
+							context health degrades:
+						</p>
+						<ul>
+							<li><strong>Forced compaction</strong> — when the composite health score
+							drops below 0.4 (severe drift or garbled output), a compaction is
+							triggered to flush the degraded context and rebuild from clean
+							checkpoints, even if the context window isn&apos;t full.</li>
+							<li><strong>Prefix break</strong> — when KV cache poison is detected
+							(score &lt; 0.3), the cached prefix is invalidated to force a cache
+							miss on the next turn, bypassing the corrupted KV state.</li>
+						</ul>
+						<p className="health-mitigate-warning">
+							WARNING: both interventions have costs — forced compaction discards
+							live context, and prefix breaks kill cache savings. Only enable when
+							you&apos;re seeing degraded output (garbled text, hallucinations,
+							loss of coherence) and the Health tab confirms low scores.
+						</p>
+						<p>
+							Also settable via env var: <code>MEGACOMPACT_CONTEXT_HEALTH_MITIGATE=1</code>.
+							The dashboard toggle persists to the store and takes precedence.
+						</p>
+						{error && <p className="health-mitigate-error">Error: {error}</p>}
+					</div>
+				</>
+			)}
+		</div>
+	);
+}