pi-mega-compact 0.12.0 → 0.12.2

package/extensions/dashboard-client/dist/assets/{useSSE-CWBB4Me7.js → useSSE-BMSSO9wB.js}

@@ -1,2 +1,2 @@
-import{r as e}from"./index-B8k19B9g.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-CWBB4Me7.js.map
+import{r as e}from"./index-BEeaI9uo.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-BMSSO9wB.js.map

package/extensions/dashboard-client/dist/assets/{useSSE-CWBB4Me7.js.map → useSSE-BMSSO9wB.js.map}

@@ -1 +1 @@
-{"version":3,"file":"useSSE-CWBB4Me7.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-BMSSO9wB.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-B8k19B9g.js"></script>
+    <script type="module" crossorigin src="./assets/index-BEeaI9uo.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-CUNn22iV.css">
   </head>
   <body>

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

@@ -62,3 +62,19 @@ export async function fetchCachePoison(): Promise<CachePoisonResponse> {
 	if (!r.ok) throw new Error(`cache-poison: ${r.status}`);
 	return r.json() as Promise<CachePoisonResponse>;
 }
+
+export async function fetchHealthSettings(): Promise<{ mitigate: boolean }> {
+	const r = await fetch("/api/context-health/settings");
+	if (!r.ok) throw new Error(`health-settings: ${r.status}`);
+	return r.json() as Promise<{ mitigate: boolean }>;
+}
+
+export async function setHealthMitigate(mitigate: boolean): Promise<{ mitigate: boolean }> {
+	const r = await fetch("/api/context-health/settings", {
+		method: "PUT",
+		headers: { "Content-Type": "application/json" },
+		body: JSON.stringify({ mitigate }),
+	});
+	if (!r.ok) throw new Error(`health-settings PUT: ${r.status}`);
+	return r.json() as Promise<{ mitigate: boolean }>;
+}

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

@@ -10,7 +10,7 @@
  */
 
 import type React from "react";
-import { useState, useCallback } from "react";
+import { useState, useCallback, useEffect } from "react";
 import type {
 	DbStatsResponse,
 	SchemaHealthResponse,
@@ -519,6 +519,95 @@ function DebugBundleCard(): React.ReactElement {
 	);
 }
 
+// ---------------------------------------------------------------------------
+// Health Mitigation card — toggle auto-mitigation for degraded context
+// ---------------------------------------------------------------------------
+
+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>
+	);
+}
+
 // ---------------------------------------------------------------------------
 // Main tab component
 // ---------------------------------------------------------------------------
@@ -554,6 +643,7 @@ export default function MaintenanceTab(): React.ReactElement {
 			</div>
 			<ActionsCard />
 			<DebugBundleCard />
+			<HealthMitigationCard />
 		</div>
 	);
 }

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

@@ -207,6 +207,25 @@ export default function SetupTab(): React.ReactElement {
 								{embedderLabel(status.currentEmbedder)}
 							</span>
 						</div>
+						{"configuredEmbedder" in status && status.configuredEmbedder !== status.currentEmbedder && (
+							<div style={styles.warning}>
+								<strong>Configured but not active:</strong>{" "}
+								{embedderLabel(status.configuredEmbedder)} is configured in
+								.mega-compact.env but not yet loaded.{" "}
+								<strong>Restart pi</strong> to activate it.
+								{status.configuredUrl && (
+									<> ({status.configuredUrl})</>
+								)}
+							</div>
+						)}
+						{"restartRequired" in status && status.restartRequired && (
+							<div style={{ ...styles.row, color: "#ff9800" }}>
+								<span style={styles.label}>Status:</span>
+								<span style={styles.value}>
+									Restart required to activate the configured embedder
+								</span>
+							</div>
+						)}
 						<div style={styles.row}>
 							<span style={styles.label}>Embedding URL:</span>
 							<span style={styles.value}>

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

@@ -94,4 +94,5 @@ export interface DebugBundleResponse {
 	dashboardSnapshot: unknown | { error: string };
 	recentEvents: unknown[];
 	criticalEvents: unknown[];
+	dataSourceAudit?: Record<string, unknown> | { error: string };
 }

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

@@ -13,8 +13,14 @@
  * Returns the current embedder configuration read from the environment.
  */
 export interface SetupStatusResponse {
-  /** Which embedder implementation is currently active. */
+  /** Which embedder implementation is currently active in the running process. */
   readonly currentEmbedder: "trigram" | "http" | "minilm" | "unknown";
+  /** Which embedder was configured via the dashboard (from .mega-compact.env). */
+  readonly configuredEmbedder: "trigram" | "http" | "minilm";
+  /** The URL configured in .mega-compact.env, if any. */
+  readonly configuredUrl: string | null;
+  /** True when the configured embedder differs from the active one (restart needed). */
+  readonly restartRequired: boolean;
   /** The embedding URL if httpEmbedder is active, otherwise null. */
   readonly embeddingUrl: string | null;
   /** The MEGACOMPACT_EMBED_CACHE value (number as string), or null. */

package/extensions/dashboard-server/gather-debug.ts

@@ -44,6 +44,7 @@ export function sendGatherDebug(res: ServerResponse, ctx: RouteContext): void {
 		dashboardSnapshot: { error: "not fetched" },
 		recentEvents: [],
 		criticalEvents: [],
+		dataSourceAudit: {},
 	};
 
 	// 1. Config flags (no secrets — MEGACOMPACT_* only)
@@ -123,6 +124,68 @@ export function sendGatherDebug(res: ServerResponse, ctx: RouteContext): void {
 		result.recentEvents = [{ error: e instanceof Error ? e.message : String(e) }];
 	}
 
+	// 6. Data source audit — per-tab data population check
+	try {
+		const audit: Record<string, unknown> = {};
+		const db = openStoreDb(ctx);
+
+		// Main db tables
+		for (const table of ["context_chunks", "memories", "raw_transcript", "checkpoint_epochs", "dedup_mirror"]) {
+			try {
+				const row = db.prepare(`SELECT COUNT(*) AS c FROM ${table}`).get() as { c: number };
+				audit[`main.${table}`] = row.c;
+			} catch {
+				audit[`main.${table}`] = "table missing";
+			}
+		}
+
+		// context_health + cache_poison_events
+		for (const table of ["context_health", "cache_poison_events"]) {
+			try {
+				const row = db.prepare(`SELECT COUNT(*) AS c FROM ${table}`).get() as { c: number };
+				audit[`main.${table}`] = row.c;
+			} catch {
+				audit[`main.${table}`] = "table missing";
+			}
+		}
+
+		// turns.db tables
+		try {
+			const turnMod = require("../../src/store/turns/connection.js") as typeof import("../../src/store/turns/connection.js");
+			const tdb = turnMod.openTurnDb(ctx.stateDir);
+			for (const table of ["turns", "turn_recall", "session_conversations", "topics", "memory_topics"]) {
+				try {
+					const row = tdb.prepare(`SELECT COUNT(*) AS c FROM ${table}`).get() as { c: number };
+					audit[`turns.${table}`] = row.c;
+				} catch {
+					audit[`turns.${table}`] = "table missing";
+				}
+			}
+		} catch (e) {
+			audit["turns.db"] = `error: ${e instanceof Error ? e.message : String(e)}`;
+		}
+
+		// .mega-compact.env
+		try {
+			const envPath = ctx.stateDir + "/.mega-compact.env";
+			audit["mega-compact.env"] = existsSync(envPath) ? "exists" : "not found";
+		} catch {
+			audit["mega-compact.env"] = "check failed";
+		}
+
+		// dashboard.json
+		try {
+			const metricsPath = defaultMetricsPath(ctx.stateDir);
+			audit["dashboard.json"] = existsSync(metricsPath) ? "exists" : "not found";
+		} catch {
+			audit["dashboard.json"] = "check failed";
+		}
+
+		(result as { dataSourceAudit: Record<string, unknown> }).dataSourceAudit = audit;
+	} catch (e) {
+		(result as { dataSourceAudit: unknown }).dataSourceAudit = { error: e instanceof Error ? e.message : String(e) };
+	}
+
 	// Send (local helper to avoid importing sendJson from a non-exporting module)
 	try {
 		const body = JSON.stringify(result);

package/extensions/dashboard-server/routes-health.ts

@@ -102,3 +102,54 @@ export function handleCachePoison(
 	}
 	return true;
 }
+
+/** GET/PUT /api/context-health/settings — read or toggle mitigation. */
+export function handleHealthSettings(
+	req: IncomingMessage,
+	res: ServerResponse,
+	ctx: RouteContext,
+): boolean {
+	if (!req.url?.startsWith("/api/context-health/settings")) return false;
+	try {
+		const pfReq = createRequire(import.meta.url);
+		const { getHealthMitigate, setHealthMitigate } = pfReq(
+			"../../src/store/sqlite.js",
+		) as typeof import("../../src/store/sqlite.js");
+
+		if (req.method === "GET") {
+			const mitigate = getHealthMitigate(ctx.stateDir);
+			res.writeHead(200, { "Content-Type": "application/json" });
+			res.end(JSON.stringify({ mitigate }));
+			return true;
+		}
+
+		if (req.method === "PUT") {
+			let body = "";
+			req.on("data", (c) => (body += c));
+			req.on("end", () => {
+				try {
+					const parsed = JSON.parse(body) as { mitigate?: unknown };
+					if (typeof parsed.mitigate !== "boolean") {
+						res.writeHead(400, { "Content-Type": "application/json" });
+						res.end(JSON.stringify({ error: "mitigate must be boolean" }));
+						return;
+					}
+					setHealthMitigate(parsed.mitigate, ctx.stateDir);
+					res.writeHead(200, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({ mitigate: parsed.mitigate }));
+				} catch {
+					res.writeHead(400, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({ error: "invalid_json" }));
+				}
+			});
+			return true;
+		}
+
+		res.writeHead(405, { "Content-Type": "application/json" });
+		res.end(JSON.stringify({ error: "method_not_allowed" }));
+	} catch (e) {
+		res.writeHead(500, { "Content-Type": "application/json" });
+		res.end(JSON.stringify({ error: String(e) }));
+	}
+	return true;
+}

package/extensions/dashboard-server/routes-setup.ts

@@ -11,7 +11,7 @@
 
 import { spawnSync } from "node:child_process"; // guardrails-allow PREVENT-PI-004: local subprocess detection only
 import { createRequire } from "node:module";
-import { writeFileSync, mkdirSync } from "node:fs";
+import { writeFileSync, mkdirSync, readFileSync, existsSync } from "node:fs";
 import { join } from "node:path";
 import type { IncomingMessage, ServerResponse } from "node:http";
 import type { RouteContext } from "./routes-core.js";
@@ -37,10 +37,29 @@ function detectCurrentEmbedder(): SetupStatusResponse["currentEmbedder"] {
 	return "trigram";
 }
 
+/** Read the configured embedder from the .mega-compact.env file (written by
+ *  the configure endpoint). This shows what the user SELECTED even before pi
+ *  restarts and loads the env file into process.env. */
+function detectConfiguredEmbedder(stateDir: string): { embedder: "trigram" | "http" | "minilm"; url: string | null } {
+	try {
+		const envPath = join(stateDir, ".mega-compact.env");
+		if (!existsSync(envPath)) return { embedder: "trigram", url: null };
+		const content = readFileSync(envPath, "utf-8");
+		const urlMatch = content.match(/^export\s+MEGACOMPACT_EMBEDDING_URL="([^"]+)"/m);
+		if (urlMatch) return { embedder: "http", url: urlMatch[1] };
+		const minilmMatch = content.match(/^export\s+MEGACOMPACT_MINILM="?(.+?)"?\s*$/m);
+		if (minilmMatch && ["1", "true", "yes"].includes(minilmMatch[1].trim().toLowerCase()))
+			return { embedder: "minilm", url: null };
+		return { embedder: "trigram", url: null };
+	} catch {
+		return { embedder: "trigram", url: null };
+	}
+}
+
 export function handleSetupStatus(
 	req: IncomingMessage,
 	res: ServerResponse,
-	_ctx: RouteContext,
+	ctx: RouteContext,
 ): boolean {
 	if (req.url !== "/api/setup-status") return false;
 	if (req.method !== "GET") {
@@ -49,9 +68,14 @@ export function handleSetupStatus(
 		res.end(JSON.stringify({ error: "method_not_allowed" }));
 		return true;
 	}
+	const configured = detectConfiguredEmbedder(ctx.stateDir);
+	const active = detectCurrentEmbedder();
 	const body: SetupStatusResponse = {
-		currentEmbedder: detectCurrentEmbedder(),
-		embeddingUrl: process.env["MEGACOMPACT_EMBEDDING_URL"] ?? null,
+		currentEmbedder: active,
+		configuredEmbedder: configured.embedder,
+		configuredUrl: configured.url,
+		restartRequired: active !== configured.embedder,
+		embeddingUrl: process.env["MEGACOMPACT_EMBEDDING_URL"] ?? configured.url,
 		embedCache: process.env["MEGACOMPACT_EMBED_CACHE"] ?? null,
 		minilm: ["1", "true", "yes"].includes(
 			(process.env["MEGACOMPACT_MINILM"] ?? "").trim().toLowerCase(),

package/extensions/dashboard-server/routes.ts

@@ -24,4 +24,4 @@ export { handleMemoryStatus } from "./routes-memory.js";
 export { handleSetupStatus, handleSetupDetect, handleSetupConfigure } from "./routes-setup.js";
 export { handleMemoryMap } from "./routes-memory-map.js";
 export { handleCacheStripes } from "./routes-cache.js";
-export { handleContextHealth, handleCachePoison } from "./routes-health.js";
+export { handleContextHealth, handleCachePoison, handleHealthSettings } from "./routes-health.js";

package/extensions/dashboard-server/server.ts

@@ -46,6 +46,7 @@ import {
 	handleMemoryMap,
 	handleContextHealth,
 	handleCachePoison,
+	handleHealthSettings,
 	handleStatic,
 } from "./routes.js";
 
@@ -243,6 +244,7 @@ export async function launchDashboardServer(
 		if (handleMemoryMap(req, res, ctx)) return;
 		if (handleContextHealth(req, res, ctx)) return;
 		if (handleCachePoison(req, res, ctx)) return;
+		if (handleHealthSettings(req, res, ctx)) return;
 		handleStatic(req, res, ctx);
 	});
 

package/extensions/mega-events/agent-handlers.ts

@@ -865,6 +865,31 @@ export function registerAgentHandlers(
 		}
 
 		// v0.12: Context Health — compute + persist health score. Non-fatal.
-		handleTurnEndHealth(event, runtime, config);
+		// Mitigation signals are acted on here (ctx is in scope at turn_end).
+		const healthSignal = handleTurnEndHealth(event, runtime, config);
+		if (healthSignal.forceCompact) {
+			runtime.logger?.info("health_mitigate_compact", {
+				composite: healthSignal.composite,
+				turnIndex: event.turnIndex,
+			});
+			try {
+				// Force a compaction to flush degraded context. Same race-guarded
+				// deferred path as the critical-over escape hatch above.
+				if (!piCompactWouldNoop(ctx)) {
+					ctx.compact();
+				}
+			} catch {
+				/* non-fatal: mitigation never breaks the agent loop */
+			}
+		}
+		if (healthSignal.breakPrefix) {
+			runtime.logger?.info("health_mitigate_prefix_break", {
+				turnIndex: event.turnIndex,
+			});
+			// Invalidate the cached trim so the next context event regenerates
+			// from scratch — the prefix change forces a cache miss, bypassing
+			// the corrupted KV state.
+			runtime.trimCache = null;
+		}
 	});
 }

package/extensions/mega-events/health-handler.ts

@@ -32,6 +32,7 @@ import {
 import {
 	recordCachePoisonEvent,
 } from "../../src/store/sqlite/context-health.js";
+import { getHealthMitigate } from "../../src/store/sqlite/meta.js";
 
 const RING_MAX = 5;
 
@@ -64,13 +65,24 @@ interface TurnEvent {
 	message?: { role?: string; content?: unknown; stopReason?: string; usage?: { cacheRead?: number } };
 }
 
-/** Handle turn_end: compute + persist context health. Non-fatal. */
+export interface HealthMitigationSignal {
+	/** Force a compaction to flush degraded context (composite < 0.4). */
+	forceCompact: boolean;
+	/** Inject a prefix break to bypass corrupted KV cache (cachePoison < 0.3). */
+	breakPrefix: boolean;
+	/** The composite health score that triggered mitigation (if any). */
+	composite: number;
+}
+
+/** Handle turn_end: compute + persist context health. Non-fatal.
+ * Returns mitigation signals for the caller to act on (agent-handlers has ctx). */
 export function handleTurnEndHealth(
 	event: TurnEvent,
 	runtime: MegaRuntime,
 	config: MegaConfig,
-): void {
-	if (!config.contextHealth) return;
+): HealthMitigationSignal {
+	const noSignal: HealthMitigationSignal = { forceCompact: false, breakPrefix: false, composite: 1 };
+	if (!config.contextHealth) return noSignal;
 	try {
 		const text = extractAssistantText(event);
 		const embedder = defaultEmbedder();
@@ -173,6 +185,11 @@ export function handleTurnEndHealth(
 			turnIndex: event.turnIndex,
 		});
 
+		// Mitigation: check the runtime-toggleable flag (meta table), not just
+		// the env var. The dashboard Maintenance tab toggles this at runtime.
+		const mitigate = config.contextHealthMitigate ||
+			getHealthMitigate(runtime.currentStateDir);
+
 		// Update ring buffers
 		runtime.recentTurnEmbeddings.push(emb);
 		if (runtime.recentTurnEmbeddings.length > RING_MAX) {
@@ -182,9 +199,20 @@ export function handleTurnEndHealth(
 		if (runtime.recentErrorCategories.length > RING_MAX) {
 			runtime.recentErrorCategories.shift();
 		}
+
+		// Return mitigation signals so agent-handlers.ts (which has ctx) can act.
+		if (mitigate) {
+			return {
+				forceCompact: composite < 0.4,
+				breakPrefix: cachePoison < 0.3,
+				composite,
+			};
+		}
+		return { forceCompact: false, breakPrefix: false, composite };
 	} catch (e) {
 		runtime.logger?.error("context_health_failed", {
 			error: String(e instanceof Error ? e.message : e),
 		});
+		return noSignal;
 	}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-mega-compact",
-  "version": "0.12.0",
+  "version": "0.12.2",
   "description": "Layered, local, vector-backed context compressor for pi — supersede/collapse/cluster compaction with deduped inline recall.",
   "type": "module",
   "license": "BSD-3-Clause",

package/src/memoryGraph/sources.ts

@@ -206,7 +206,8 @@ export function buildTurnNodes(
 // ---------------------------------------------------------------------------
 
 export function buildTurnContentNodes(
-  db: DatabaseSync,
+  turnDb: DatabaseSync,
+  mainDb: DatabaseSync,
   sessionId: string,
   nodes: MemoryGraphNode[],
   edges: MemoryGraphEdge[],
@@ -216,25 +217,58 @@ export function buildTurnContentNodes(
   // (identity_merge) merges them with the richest nodeType winning. Using the
   // global nodes array here would skip every node (Source A already added them).
   const seen = new Set<string>();
-  const rows = sessionId
-    ? (db
+
+  // turns live in turns.db, raw_transcript in the main db — can't JOIN across
+  // databases, so query separately and merge in JS.
+  const turnRows = sessionId
+    ? (turnDb
         .prepare(
-          `SELECT t.turn_index, t.role, t.ended_at, r.content_bytes
-           FROM turns t
-           JOIN raw_transcript r ON r.session_id = t.session_id AND r.turn_index = t.turn_index
-           WHERE t.session_id = ?
-           ORDER BY t.turn_index ASC`,
+          `SELECT turn_index, role, ended_at
+           FROM turns
+           WHERE session_id = ?
+           ORDER BY turn_index ASC`,
         )
         .all(sessionId) as Array<Record<string, unknown>>)
-    : (db
+    : (turnDb
         .prepare(
-          `SELECT t.turn_index, t.role, t.ended_at, r.content_bytes
-           FROM turns t
-           JOIN raw_transcript r ON r.session_id = t.session_id AND r.turn_index = t.turn_index
-           ORDER BY t.turn_index ASC`,
+          `SELECT turn_index, role, ended_at
+           FROM turns
+           ORDER BY turn_index ASC`,
         )
         .all() as Array<Record<string, unknown>>);
 
+  // Build a map of (session_id, turn_index) → content from raw_transcript.
+  const contentMap = new Map<string, string>();
+  try {
+    const transcriptRows = sessionId
+      ? (mainDb
+          .prepare(
+            `SELECT turn_index, content_bytes FROM raw_transcript WHERE session_id = ?`,
+          )
+          .all(sessionId) as Array<Record<string, unknown>>)
+      : (mainDb
+          .prepare(
+            `SELECT turn_index, content_bytes FROM raw_transcript`,
+          )
+          .all() as Array<Record<string, unknown>>);
+    for (const r of transcriptRows) {
+      contentMap.set(String(r.turn_index), String(r.content_bytes ?? ""));
+    }
+  } catch {
+    // raw_transcript may not exist in the main db (dbMirror off) — return empty.
+    return;
+  }
+
+  // Merge: only produce nodes where both a turn row AND transcript content exist.
+  const rows = turnRows
+    .filter((t) => contentMap.has(String(t.turn_index)))
+    .map((t) => ({
+      turn_index: t.turn_index,
+      role: t.role,
+      ended_at: t.ended_at,
+      content_bytes: contentMap.get(String(t.turn_index)) ?? "",
+    }));
+
   if (rows.length === 0) return;
 
   const turnContentNodes: MemoryGraphNode[] = [];
@@ -269,7 +303,7 @@ export function buildTurnContentNodes(
   if (turnContentNodes.length > 1) {
     const embeddings = turnContentNodes.map((n) => {
       try {
-        return { id: n.id, vec: getOrComputeEmbedding(db, n.textSnippet) };
+        return { id: n.id, vec: getOrComputeEmbedding(mainDb, n.textSnippet) };
       } catch {
         return { id: n.id, vec: null as number[] | null };
       }
@@ -291,7 +325,7 @@ export function buildTurnContentNodes(
       }
     }
 
-    linkTurnToCheckpointEdges(db, sessionId, turnContentNodes, edges);
+    linkTurnToCheckpointEdges(mainDb, sessionId, turnContentNodes, edges);
   }
 
   nodes.push(...turnContentNodes);