pi-mega-compact 0.11.1 → 0.11.2

package/extensions/dashboard-client/dist/assets/{useSSE-CXrQSbVY.js → useSSE-Cezlih5V.js}

@@ -1,2 +1,2 @@
-import{r as e}from"./index-CqLN7STl.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-CXrQSbVY.js.map
+import{r as e}from"./index-BcoSz-L4.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-Cezlih5V.js.map

package/extensions/dashboard-client/dist/assets/{useSSE-CXrQSbVY.js.map → useSSE-Cezlih5V.js.map}

@@ -1 +1 @@
-{"version":3,"file":"useSSE-CXrQSbVY.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-Cezlih5V.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-CqLN7STl.js"></script>
+    <script type="module" crossorigin src="./assets/index-BcoSz-L4.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-gn66lYD2.css">
   </head>
   <body>

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

@@ -25,6 +25,7 @@ const AchievementsTab = React.lazy(() => import("./tabs/AchievementsTab"));
 const SessionsTab = React.lazy(() => import("./tabs/SessionsTab"));
 const TopicsTab = React.lazy(() => import("./tabs/TopicsTab"));
 const TurnsTab = React.lazy(() => import("./tabs/TurnsTab"));
+const MaintenanceTab = React.lazy(() => import("./tabs/MaintenanceTab"));
 
 export type TabId =
 	| "overview"
@@ -37,7 +38,8 @@ export type TabId =
 	| "achievements"
 	| "sessions"
 	| "topics"
-	| "turns";
+	| "turns"
+	| "maintenance";
 
 const TABS: Array<{ id: TabId; label: string }> = [
 	{ id: "overview", label: "Overview" },
@@ -51,6 +53,7 @@ const TABS: Array<{ id: TabId; label: string }> = [
 	{ id: "sessions", label: "Sessions" },
 	{ id: "topics", label: "Topics" },
 	{ id: "turns", label: "Turns" },
+	{ id: "maintenance", label: "Maintenance" },
 ];
 
 export default function App(): React.ReactElement {
@@ -100,6 +103,7 @@ export default function App(): React.ReactElement {
 						{activeTab === "sessions" && <SessionsTab />}
 						{activeTab === "topics" && <TopicsTab />}
 						{activeTab === "turns" && <TurnsTab />}
+					{activeTab === "maintenance" && <MaintenanceTab />}
 					</React.Suspense>
 				</main>
 			</div>

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

@@ -35,6 +35,10 @@ import type {
 	ForkResponse,
 	PruneTurnsResponse,
 	TopicMemoriesResponse,
+	DbStatsResponse,
+	SchemaHealthResponse,
+	MaintenanceAction,
+	MaintenanceActionResult,
 } from "@contracts";
 
 /** Error thrown when a dashboard API response is not 2xx. */
@@ -244,3 +248,22 @@ export function fetchTopicMemories(
 		),
 	);
 }
+
+// ─── Maintenance (S49B) ─────────────────────────────────────────────────
+
+export function fetchDbStats(): Promise<DbStatsResponse> {
+	return getJson<DbStatsResponse>(ENDPOINTS.maintenanceStats.path);
+}
+
+export function fetchSchemaHealth(): Promise<SchemaHealthResponse> {
+	return getJson<SchemaHealthResponse>(ENDPOINTS.schemaHealth.path);
+}
+
+export function postMaintenanceAction(
+	action: MaintenanceAction,
+): Promise<MaintenanceActionResult> {
+	return postJson<MaintenanceActionResult>(
+		ENDPOINTS.maintenanceAction.path,
+		action,
+	);
+}

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

@@ -0,0 +1,293 @@
+/**
+ * dashboard-client/src/tabs/MaintenanceTab.tsx — Maintenance tab (S49B).
+ *
+ * Schema health audit + DB stats + maintenance action triggers.
+ * Polls schema-health every 10s and db-stats every 15s (stats are stable).
+ */
+
+import type React from "react";
+import { useState, useCallback } from "react";
+import type {
+	DbStatsResponse,
+	SchemaHealthResponse,
+	MaintenanceAction,
+	MaintenanceActionResult,
+	TableStats,
+	DbFiles,
+	SchemaHealthRow,
+} from "@contracts";
+import { useApi } from "../hooks/useApi";
+import { fetchDbStats, fetchSchemaHealth, postMaintenanceAction } from "../api/client";
+
+// ---------------------------------------------------------------------------
+// DB Stats Card
+// ---------------------------------------------------------------------------
+
+function DbStatsCard({ data, loading, error }: {
+	data: DbStatsResponse | null;
+	loading: boolean;
+	error: Error | null;
+}) {
+	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 && (
+					<>
+						<FileSizes files={data.storage.files} pageSize={data.storage.pageSize} pageCount={data.storage.pageCount} freelistPages={data.storage.freelistPages} />
+						<TableCounts tables={data.tables} />
+					</>
+				)}
+			</div>
+		</div>
+	);
+}
+
+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`;
+}
+
+function FileSizes({ files, pageSize, pageCount, freelistPages }: {
+	files: DbFiles;
+	pageSize: number;
+	pageCount: number;
+	freelistPages: number;
+}) {
+	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(files.dbBytes + files.walBytes + files.shmBytes)}</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 TableCounts({ tables }: { tables: TableStats[] }) {
+	const total = tables.reduce((sum, t) => sum + Math.max(0, t.rowCount), 0);
+	return (
+		<div className="stat-section">
+			<div className="stat-label">Table Row Counts ({total.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>
+	);
+}
+
+// ---------------------------------------------------------------------------
+// Schema Health Card
+// ---------------------------------------------------------------------------
+
+function SchemaHealthCard({ data, loading, error }: {
+	data: SchemaHealthResponse | null;
+	loading: boolean;
+	error: Error | null;
+}) {
+	return (
+		<div className="card">
+			<div className="card-header">
+				Schema Health
+				{data && (
+					<span className={`badge ${data.healthy ? "badge-ok" : "badge-bad"}`}>
+						{data.healthy ? "HEALTHY" : "DEGRADED"}
+					</span>
+				)}
+			</div>
+			<div className="card-body">
+				{loading && !data && <span className="text-muted">Loading…</span>}
+				{error && !data && <span className="text-error">{error.message}</span>}
+				{data && (
+					<>
+						<div className="stat-row"><span className="stat-label">Schema version</span><span className="num">{data.schemaVersion}</span></div>
+						<div className="stat-row"><span className="stat-label">Integrity</span><span className={data.integrity[0] === "ok" ? "text-ok" : "text-error"}>{data.integrity.join("; ")}</span></div>
+						<ColumnAudit columns={data.columns} />
+						{data.fkCheck.length > 0 && (
+							<div className="stat-section">
+								<div className="stat-label text-warn">FK Check ({data.fkCheck.length})</div>
+								{data.fkCheck.map((fk, i) => <div key={i} className="text-warn text-mono">{fk}</div>)}
+							</div>
+						)}
+					</>
+				)}
+			</div>
+		</div>
+	);
+}
+
+function ColumnAudit({ columns }: { columns: SchemaHealthRow[] }) {
+	const missing = columns.filter((c) => !c.present);
+	return (
+		<div className="stat-section">
+			<div className="stat-label">Column Audit ({columns.length} columns, {missing.length} missing)</div>
+			<table className="compact-table">
+				<thead>
+					<tr><th>Table</th><th>Column</th><th>Decl</th><th>Status</th></tr>
+				</thead>
+				<tbody>
+					{columns.map((c) => (
+						<tr key={`${c.table}.${c.column}`}>
+							<td>{c.table}</td>
+							<td>{c.column}</td>
+							<td className="text-mono">{c.expectedDecl}</td>
+							<td className={c.present ? "text-ok" : "text-error"}>{c.present ? "✓" : "MISSING"}</td>
+						</tr>
+					))}
+				</tbody>
+			</table>
+		</div>
+	);
+}
+
+// ---------------------------------------------------------------------------
+// Action Card
+// ---------------------------------------------------------------------------
+
+const ACTIONS: Array<{
+	key: string;
+	label: string;
+	desc: string;
+	dangerous: boolean;
+	confirm?: string;
+	daysOld?: boolean;
+}> = [
+	{ 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?" },
+];
+
+interface ActionResult extends MaintenanceActionResult {
+	timestamp: number;
+}
+
+function ActionsPanel() {
+	const [results, setResults] = useState<ActionResult[]>([]);
+	const [running, setRunning] = useState<string | null>(null);
+	const [days, setDays] = useState("30");
+
+	const run = useCallback(async (def: typeof ACTIONS[number], daysOverride?: string) => {
+		const payload: MaintenanceAction = (def.daysOld
+			? { action: "prune", daysOld: Number(daysOverride ?? days) }
+			: { action: def.key }) as MaintenanceAction;
+
+		setRunning(def.key);
+		try {
+			const res = await postMaintenanceAction(payload);
+			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 as Error).message,
+				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((a) => {
+						const isRunning = running === a.key;
+						const lastResult = results.find((r) => r.operation === a.key);
+						return (
+							<div key={a.key} className="action-item">
+								<div className="action-info">
+									<div className="action-label">
+										{a.label}
+										{a.dangerous && <span className="badge badge-warn">DESTRUCTIVE</span>}
+									</div>
+									<div className="action-desc">{a.desc}</div>
+									{lastResult && (
+										<div className={`action-result ${lastResult.success ? "text-ok" : "text-error"}`}>
+											{lastResult.summary}
+										</div>
+									)}
+								</div>
+								<div className="action-controls">
+									{a.daysOld && (
+										<input
+											type="number"
+											min="1"
+											max="365"
+											value={days}
+											onChange={(e) => setDays(e.target.value)}
+											className="days-input"
+											disabled={isRunning}
+										/>
+									)}
+									<button
+										className={`btn ${a.dangerous ? "btn-danger" : "btn-primary"}`}
+										disabled={isRunning !== null}
+										onClick={() => {
+											if (a.confirm && !window.confirm(a.confirm)) return;
+											run(a);
+										}}
+									>
+										{isRunning ? "Running…" : "Run"}
+									</button>
+								</div>
+							</div>
+						);
+					})}
+				</div>
+			</div>
+		</div>
+	);
+}
+
+// ---------------------------------------------------------------------------
+// Tab root
+// ---------------------------------------------------------------------------
+
+export default function MaintenanceTab(): React.ReactElement {
+	const { data: stats, loading: statsLoading, error: statsError } = useApi<DbStatsResponse>(
+		useCallback(() => fetchDbStats(), []),
+		{ pollInterval: 15000 },
+	);
+	const { data: schema, loading: schemaLoading, error: schemaError } = useApi<SchemaHealthResponse>(
+		useCallback(() => fetchSchemaHealth(), []),
+		{ pollInterval: 10000 },
+	);
+
+	return (
+		<div className="maintenance-tab">
+			<div className="card-grid">
+				<SchemaHealthCard data={schema} loading={schemaLoading} error={schemaError} />
+				<DbStatsCard data={stats} loading={statsLoading} error={statsError} />
+			</div>
+			<ActionsPanel />
+		</div>
+	);
+}

package/extensions/dashboard-server/api-contracts/endpoints.ts

@@ -56,6 +56,13 @@ export type {
 	TopicDetailResponse,
 } from "./game-types.js";
 
+import type {
+	DbStatsResponse,
+	MaintenanceActionResult,
+	MaintenanceAction,
+	SchemaHealthResponse,
+} from "./maintenance.js";
+
 // ─── New Response Types (inline) ───────────────────────────────────────────
 
 /**
@@ -553,4 +560,27 @@ export const ENDPOINTS = {
 		path: "/api/topics/:topicId/memories",
 		description: "Member memories assigned to a wiki topic (drill-down).",
 	} as const satisfies EndpointDef<"GET", undefined, TopicMemoriesResponse>,
+
+	// ─── S49B Maintenance Tab ─────────────────────────────────────────
+
+	/** GET /api/maintenance — DB stats (table row counts + storage). */
+	maintenanceStats: {
+		method: "GET",
+		path: "/api/maintenance",
+		description: "SQLite table row counts, storage stats, and DB file sizes.",
+	} as const satisfies EndpointDef<"GET", undefined, DbStatsResponse>,
+
+	/** GET /api/maintenance/schema-health — Schema version + integrity audit. */
+	schemaHealth: {
+		method: "GET",
+		path: "/api/maintenance/schema-health",
+		description: "SCHEMA_VERSION, PRAGMA integrity_check, FK check, and per-column audit.",
+	} as const satisfies EndpointDef<"GET", undefined, SchemaHealthResponse>,
+
+	/** POST /api/maintenance/action — Trigger a maintenance action. */
+	maintenanceAction: {
+		method: "POST",
+		path: "/api/maintenance/action",
+		description: "Run vacuum, checkpoint, reindex, fts5-rebuild, reconcile-dedup, prune, or integrity-check.",
+	} as const satisfies EndpointDef<"POST", MaintenanceAction, MaintenanceActionResult>,
 } as const;

package/extensions/dashboard-server/api-contracts/index.ts

@@ -171,6 +171,18 @@ export type SseEvent =
 	| SseGameRender
 	| SseSessionSample;
 
+// S49B — maintenance tab API
+export type {
+	TableStats,
+	DbFiles,
+	DbStorageStats,
+	DbStatsResponse,
+	MaintenanceActionResult,
+	SchemaHealthRow,
+	SchemaHealthResponse,
+	MaintenanceAction,
+} from "./maintenance.js";
+
 // S52 — turn-by-turn memory tracking + recall + rewind
 export type {
 	TurnRow,

package/extensions/dashboard-server/api-contracts/maintenance.ts

@@ -0,0 +1,84 @@
+/**
+ * api-contracts/maintenance.ts — Maintenance tab API contract (S49B).
+ *
+ * Types for the /api/maintenance and /api/maintenance/action endpoints.
+ * All pi-agnostic, all PREVENT-PI-004 compliant (type definitions only).
+ */
+
+/** Row count + size stats per SQLite table. */
+export interface TableStats {
+	/** Table name. */
+	table: string;
+	/** Row count (or -1 if FTS virtual table). */
+	rowCount: number;
+}
+
+/** DB file sizes on disk in bytes. */
+export interface DbFiles {
+	/** Main sqlite.db size. */
+	dbBytes: number;
+	/** WAL sidecar size (0 if absent). */
+	walBytes: number;
+	/** SHM sidecar size (0 if absent). */
+	shmBytes: number;
+}
+
+/** SQLite storage-level stats. */
+export interface DbStorageStats {
+	files: DbFiles;
+	pageSize: number;
+	pageCount: number;
+	freelistPages: number;
+}
+
+/** Full table + storage overview (GET /api/maintenance result). */
+export interface DbStatsResponse {
+	type: "db-stats";
+	/** Per-table row counts. */
+	tables: TableStats[];
+	/** Storage stats. */
+	storage: DbStorageStats;
+}
+
+/** Result of a single maintenance action. */
+export interface MaintenanceActionResult {
+	operation: string;
+	success: boolean;
+	affected: number;
+	reclaimedBytes: number;
+	summary: string;
+	detail?: string[];
+}
+
+/** Schema health check — per-column audit result. */
+export interface SchemaHealthRow {
+	table: string;
+	column: string;
+	present: boolean;
+	expectedDecl: string;
+}
+
+/** Schema health audit (GET /api/maintenance/schema-health). */
+export interface SchemaHealthResponse {
+	type: "schema-health";
+	/** SCHEMA_VERSION constant compiled in. */
+	schemaVersion: number;
+	/** PRAGMA integrity_check result lines. */
+	integrity: string[];
+	/** PRAGMA foreign_key_check result lines. */
+	fkCheck: string[];
+	/** Per-column audit of every ensureColumn migration column. */
+	columns: SchemaHealthRow[];
+	/** All present = healthy. */
+	healthy: boolean;
+}
+
+/** Maintenance actions the client can trigger (POST /api/maintenance/action). */
+export type MaintenanceAction =
+	| { action: "vacuum" }
+	| { action: "checkpoint" }
+	| { action: "reindex" }
+	| { action: "fts5-rebuild" }
+	| { action: "reconcile-dedup" }
+	| { action: "prune"; daysOld: number }
+	| { action: "integrity-check" };

package/extensions/dashboard-server/api-contracts.test.ts

@@ -162,7 +162,7 @@ void _c_achievements;
 // (Sprint 39 added /api/sessions + /api/sessions/timeseries.)
 
 const ENDPOINT_KEYS = Object.keys(ENDPOINTS) as (keyof typeof ENDPOINTS)[];
-const EXPECTED_ENDPOINT_COUNT = 23;
+const EXPECTED_ENDPOINT_COUNT = 26; // 23 base + 3 S49B maintenance
 
 /** All `/api/*` paths served by server.ts (extracted from the route handlers). */
 const SERVER_TS_PATHS: string[] = [

package/extensions/dashboard-server/api-contracts.ts

@@ -66,6 +66,15 @@ export type {
   MinHashBandState,
   // Composite
   SseEvent,
+  // S49B — maintenance tab
+  TableStats,
+  DbFiles,
+  DbStorageStats,
+  DbStatsResponse,
+  MaintenanceActionResult,
+  SchemaHealthRow,
+  SchemaHealthResponse,
+  MaintenanceAction,
   // Endpoints registry (Sprint A1)
   VersionResponse,
   IndexSummary,