pi-mega-compact 0.13.2 → 0.13.4

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

@@ -1,2 +1,2 @@
-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
+import{r as e}from"./index-BEj1Zahy.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-p1pOI_-P.js.map

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

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

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

@@ -48,6 +48,9 @@ import type {
 	SetupConfigureResponse,
 	EmbedderHealthResponse,
 	RaptorTreeResponse,
+	RagSettingsResponse,
+	RagSettingsRequest,
+	RagSettingsResponsePost,
 } from "@contracts";
 
 /** Error thrown when a dashboard API response is not 2xx. */
@@ -323,3 +326,17 @@ export function fetchRaptorTree(sessionId?: string): Promise<RaptorTreeResponse>
 export function fetchEmbedderHealth(): Promise<EmbedderHealthResponse> {
 	return getJson<EmbedderHealthResponse>(ENDPOINTS.embedderHealth.path);
 }
+
+// ─── RAG Settings ─────────────────────────────────────────────────────
+
+/** GET /api/rag-settings — read the current state of all RAG feature flags. */
+export function fetchRagSettings(): Promise<RagSettingsResponse> {
+	return getJson<RagSettingsResponse>(ENDPOINTS.ragSettings.path);
+}
+
+/** POST /api/rag-settings — toggle RAG feature flags (writes _DISABLED env vars). */
+export function postRagSettings(
+	body: RagSettingsRequest,
+): Promise<RagSettingsResponsePost> {
+	return postJson<RagSettingsResponsePost>(ENDPOINTS.ragSettingsUpdate.path, body);
+}

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

@@ -13,6 +13,7 @@ import { useState, useEffect, useCallback } from "react";
 import type { SetupStatusResponse, SetupDetectResponse, SetupConfigureResponse } from "@contracts";
 import { fetchSetupStatus, fetchSetupDetect, configureEmbedder } from "../../api/client";
 import EmbedderHealthCard from "./EmbedderHealthCard";
+import RagSettingsCard from "./RagSettingsCard";
 
 const styles: Record<string, React.CSSProperties> = {
 	container: {
@@ -463,6 +464,7 @@ export default function EmbedderSetup(): React.ReactElement {
 					</li>
 				</ul>
 			</div>
+			<RagSettingsCard />
 		</div>
 	);
 }

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

@@ -0,0 +1,160 @@
+/**
+ * SetupTab/RagSettingsCard.tsx — RAG feature flag toggles (S57 B1–B5).
+ *
+ * Shows each RAG flag as a checkbox toggle. Reads/writes the .mega-compact.env
+ * file via the /api/rag-settings endpoint. HyDE (B5) is greyed out when no
+ * LLM embedder (HttpEmbedder) is active — it requires an LLM to function.
+ *
+ * PREVENT-PI-004: all data comes from localhost dashboard API endpoints.
+ */
+import type React from "react";
+import { useState, useEffect, useCallback } from "react";
+import type { RagSettingsResponse } from "@contracts";
+import { fetchRagSettings, postRagSettings } from "../../api/client";
+
+const styles: Record<string, React.CSSProperties> = {
+	section: {
+		background: "#1a1a2e",
+		borderRadius: "8px",
+		padding: "1rem",
+		marginBottom: "1rem",
+		border: "1px solid #2a2a4e",
+	},
+	sectionTitle: {
+		fontSize: "1.1rem",
+		fontWeight: 700,
+		marginTop: 0,
+		marginBottom: "0.75rem",
+		color: "#e0e0e0",
+		borderBottom: "1px solid #333",
+		paddingBottom: "0.5rem",
+	},
+	flagRow: {
+		display: "flex",
+		alignItems: "flex-start",
+		gap: "0.5rem",
+		padding: "0.5rem 0",
+		borderBottom: "1px solid #2a2a4e",
+	},
+	checkbox: {
+		marginTop: "0.15rem",
+		cursor: "pointer",
+	},
+	label: {
+		fontWeight: 600,
+		color: "#e0e0e0",
+		fontSize: "0.9rem",
+	},
+	description: {
+		fontSize: "0.8rem",
+		color: "#a0a0c0",
+		marginTop: "0.15rem",
+	},
+	hint: {
+		fontSize: "0.75rem",
+		color: "#ff9800",
+		marginTop: "0.15rem",
+	},
+	banner: {
+		background: "#3a2a00",
+		border: "1px solid #665500",
+		borderRadius: "6px",
+		padding: "0.5rem 0.75rem",
+		marginTop: "0.5rem",
+		color: "#ffcc00",
+		fontSize: "0.8rem",
+	},
+};
+
+export default function RagSettingsCard(): React.ReactElement {
+	const [settings, setSettings] = useState<RagSettingsResponse | null>(null);
+	const [error, setError] = useState<string | null>(null);
+	const [saving, setSaving] = useState(false);
+	const [restartBanner, setRestartBanner] = useState(false);
+
+	const load = useCallback(() => {
+		fetchRagSettings()
+			.then(setSettings)
+			.catch((e: unknown) =>
+				setError(e instanceof Error ? e.message : String(e)),
+			);
+	}, []);
+
+	useEffect(() => {
+		load();
+	}, [load]);
+
+	useEffect(() => {
+		const id = setInterval(load, 30000);
+		return () => clearInterval(id);
+	}, [load]);
+
+	const toggle = useCallback(
+		(key: string, enabled: boolean) => {
+			if (!settings) return;
+			const flag = settings.flags.find((f) => f.key === key);
+			if (!flag || (flag.requiresLlm && !settings.llmActive)) return;
+			setSaving(true);
+			postRagSettings({ flags: { [key]: enabled } })
+				.then(() => {
+					setRestartBanner(true);
+					setSaving(false);
+					load();
+				})
+				.catch((e: unknown) => {
+					setError(e instanceof Error ? e.message : String(e));
+					setSaving(false);
+				});
+		},
+		[settings, load],
+	);
+
+	return (
+		<div style={styles.section}>
+			<h3 style={styles.sectionTitle}>RAG Settings</h3>
+			<p style={{ fontSize: "0.8rem", color: "#a0a0c0", marginTop: 0 }}>
+				Recall pipeline features. All default ON — toggle off to disable.
+				Changes take effect after restart.
+			</p>
+			{error && (
+				<p style={{ color: "#f44336", fontSize: "0.85rem" }}>Error: {error}</p>
+			)}
+			{settings?.flags.map((flag) => {
+				const locked = flag.requiresLlm && !settings.llmActive;
+				return (
+					<div key={flag.key} style={styles.flagRow}>
+						<input
+							type="checkbox"
+							style={{
+								...styles.checkbox,
+								opacity: locked ? 0.4 : 1,
+								cursor: locked ? "not-allowed" : "pointer",
+							}}
+							checked={flag.enabled && !locked}
+							disabled={locked || saving}
+							onChange={(e) => toggle(flag.key, e.currentTarget.checked)}
+						/>
+						<div>
+							<div style={styles.label}>{flag.label}</div>
+							<div style={styles.description}>{flag.description}</div>
+							{locked && (
+								<div style={styles.hint}>
+									Requires an LLM embedder (Ollama/HTTP). Configure one in
+									the Embedder section above first.
+								</div>
+							)}
+						</div>
+					</div>
+				);
+			})}
+			{!settings && !error && (
+				<p style={{ color: "#888", fontSize: "0.85rem" }}>Loading...</p>
+			)}
+			{restartBanner && (
+				<div style={styles.banner}>
+					Settings saved. <strong>Restart pi</strong> to apply changes.
+				</div>
+			)}
+		</div>
+	);
+}

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

@@ -19,6 +19,11 @@ import type { RaptorTreeResponse } from "../raptor.js";
 import type { MemoryStatusResponse } from "../memory.js";
 import type { SetupStatusResponse, SetupDetectResponse, SetupConfigureRequest, SetupConfigureResponse } from "../setup.js";
 import type { EmbedderHealthResponse } from "../embedder-health.js";
+import type {
+	RagSettingsResponse,
+	RagSettingsRequest,
+	RagSettingsResponsePost,
+} from "../rag-settings.js";
 import type {
 	TurnsResponse,
 	ConversationTurnsResponse,
@@ -357,4 +362,22 @@ export const ENDPOINTS = {
 		description:
 			"Probe the active embedder with a test embed and report status, latency, dimensions, and masked URL.",
 	} as const satisfies EndpointDef<"GET", undefined, EmbedderHealthResponse>,
+
+	// ─── RAG Settings (Sprint B6) ─────────────────────────────────────
+
+	/** GET /api/rag-settings — Read the state of all RAG feature flags. */
+	ragSettings: {
+		method: "GET",
+		path: "/api/rag-settings",
+		description:
+			"Read the current state of all RAG feature flags (enabled/disabled).",
+	} as const satisfies EndpointDef<"GET", undefined, RagSettingsResponse>,
+
+	/** POST /api/rag-settings — Update RAG feature flag states. */
+	ragSettingsUpdate: {
+		method: "POST",
+		path: "/api/rag-settings",
+		description:
+			"Update RAG feature flag states by writing _DISABLED env vars to .mega-compact.env.",
+	} as const satisfies EndpointDef<"POST", RagSettingsRequest, RagSettingsResponsePost>,
 } as const;

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

@@ -232,3 +232,11 @@ export type {
 	CacheHealthScore,
 	CacheStripesResponse,
 } from "./cache-stripes.js";
+
+// RAG Settings — feature flag toggles (B6)
+export type {
+	RagFlagState,
+	RagSettingsResponse,
+	RagSettingsRequest,
+	RagSettingsResponsePost,
+} from "./rag-settings.js";

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

@@ -0,0 +1,42 @@
+/**
+ * api-contracts/rag-settings.ts — RAG feature flag API response types.
+ *
+ * Types for the /api/rag-settings endpoint used by the dashboard RAG Settings
+ * panel to read and toggle the five RAG feature flags (B1–B5).
+ *
+ * PREVENT-PI-004: type definitions only, no network code.
+ * PREVENT-011: no `any` type — all types are explicit.
+ */
+
+/**单个 RAG feature flag state for the dashboard. */
+export interface RagFlagState {
+	/** Env var key without the _DISABLED suffix, e.g. "MEGACOMPACT_HYDE". */
+	readonly key: string;
+	/** Short human-readable label, e.g. "HyDE (Hypothetical Document Embeddings)". */
+	readonly label: string;
+	/** One-line description of what the flag does. */
+	readonly description: string;
+	/** Whether the flag is currently enabled (true = ON, false = disabled via _DISABLED). */
+	readonly enabled: boolean;
+	/** Whether this flag requires an LLM embedder (HttpEmbedder) to function. */
+	readonly requiresLlm: boolean;
+}
+
+/** Response for GET /api/rag-settings. */
+export interface RagSettingsResponse {
+	readonly flags: RagFlagState[];
+	/** Whether an HttpEmbedder (LLM) is currently active — gates HyDE toggle. */
+	readonly llmActive: boolean;
+}
+
+/** Request body for POST /api/rag-settings. */
+export interface RagSettingsRequest {
+	/** Map of flag key (e.g. "MEGACOMPACT_HYDE") to desired enabled state. */
+	readonly flags: Record<string, boolean>;
+}
+
+/** Response for POST /api/rag-settings. */
+export interface RagSettingsResponsePost {
+	readonly envPath: string;
+	readonly restartRequired: boolean;
+}

package/extensions/dashboard-server/routes-rag-settings.ts

@@ -0,0 +1,207 @@
+/**
+ * dashboard-server/routes-rag-settings.ts — RAG Settings route handler.
+ *
+ * GET /api/rag-settings  — Returns the state of all RAG feature flags (B1–B5).
+ * POST /api/rag-settings — Toggles flags by writing MEGACOMPACT_*_DISABLED
+ *                          lines to the per-repo .mega-compact.env file.
+ *
+ * Guardrails: PREVENT-PI-004 (loopback-only), PREVENT-001 (null-safe JSON),
+ * PREVENT-011 (no `any`). Each JSON write carries a guardrails-allow annotation.
+ */
+
+import { readFileSync, existsSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { RouteContext } from "./routes-core.js";
+import { detectCurrentEmbedder } from "./routes-setup.js";
+import type {
+	RagFlagState,
+	RagSettingsResponse,
+	RagSettingsRequest,
+	RagSettingsResponsePost,
+} from "./api-contracts/rag-settings.js";
+
+// ---------------------------------------------------------------------------
+// RAG_FLAGS — the five feature flags surfaced by this panel.
+// ---------------------------------------------------------------------------
+
+const RAG_FLAGS: {
+	key: string;
+	label: string;
+	description: string;
+	requiresLlm: boolean;
+}[] = [
+	{
+		key: "MEGACOMPACT_QUERY_REFORMULATION",
+		label: "Query Reformulation",
+		description:
+			"TF-IDF keyword expansion for vague recall queries (TrigramEmbedder path)",
+		requiresLlm: false,
+	},
+	{
+		key: "MEGACOMPACT_TIERED_ROUTER",
+		label: "Tiered Recall Router",
+		description:
+			"L0 cache → L1 FTS5 → L2 HNSW routing for faster recall",
+		requiresLlm: false,
+	},
+	{
+		key: "MEGACOMPACT_RECALL_METRICS",
+		label: "Recall Quality Metrics",
+		description:
+			"Precision/recall scoring and logging for recall evaluation",
+		requiresLlm: false,
+	},
+	{
+		key: "MEGACOMPACT_MEMORY_GRAPH",
+		label: "Memory Graph",
+		description:
+			"Dashboard-oriented memory graph traversal across sessions",
+		requiresLlm: false,
+	},
+	{
+		key: "MEGACOMPACT_HYDE",
+		label: "HyDE (Hypothetical Document Embeddings)",
+		description:
+			"Generate hypothetical answer via LLM, embed it, RRF-fuse with raw-query results",
+		requiresLlm: true,
+	},
+];
+
+/** Strip any MEGACOMPACT_*_DISABLED assignment lines from env file content. */
+const DISABLED_LINE = /^export\s+MEGACOMPACT_\w+_DISABLED=/;
+
+function isDisabled(key: string): boolean {
+	const v = process.env[key + "_DISABLED"];
+	return v === "true" || v === "1";
+}
+
+function readJsonBody(
+	req: IncomingMessage,
+	cb: (
+		result:
+			| { ok: true; value: Record<string, unknown> }
+			| { ok: false; error: string },
+	) => void,
+): void {
+	let body = "";
+	let tooBig = false;
+	req.on("data", (chunk: Buffer) => {
+		if (body.length > 65536) {
+			tooBig = true;
+			return;
+		}
+		body += chunk.toString();
+	});
+	req.on("end", () => {
+		if (tooBig) return cb({ ok: false, error: "body_too_large" });
+		try {
+			const v = body ? JSON.parse(body) : {}; // PREVENT-001: parsed value type-checked below
+			if (typeof v !== "object" || v === null || Array.isArray(v)) {
+				return cb({ ok: false, error: "invalid_object" });
+			}
+			cb({ ok: true, value: v as Record<string, unknown> });
+		} catch {
+			cb({ ok: false, error: "invalid_json" });
+		}
+	});
+	req.on("error", () => cb({ ok: false, error: "read_error" }));
+}
+
+// ---------------------------------------------------------------------------
+// handleRagSettings — "/api/rag-settings"
+// ---------------------------------------------------------------------------
+
+export function handleRagSettings(
+	req: IncomingMessage,
+	res: ServerResponse,
+	ctx: RouteContext,
+): boolean {
+	if (req.url !== "/api/rag-settings") return false;
+
+	if (req.method === "GET") {
+		const flags: RagFlagState[] = RAG_FLAGS.map((f) => ({
+			key: f.key,
+			label: f.label,
+			description: f.description,
+			enabled: !isDisabled(f.key),
+			requiresLlm: f.requiresLlm,
+		}));
+		const body: RagSettingsResponse = {
+			flags,
+			llmActive: detectCurrentEmbedder() === "http",
+		};
+		// guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
+		res.writeHead(200, { "Content-Type": "application/json" });
+		res.end(JSON.stringify(body));
+		return true;
+	}
+
+	if (req.method === "POST") {
+		readJsonBody(req, (parsed) => {
+			if (!parsed.ok) {
+				// guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
+				res.writeHead(400, { "Content-Type": "application/json" });
+				res.end(JSON.stringify({ error: parsed.error }));
+				return;
+			}
+			const body = parsed.value as unknown as RagSettingsRequest;
+			const desired = body.flags;
+			if (typeof desired !== "object" || desired === null || Array.isArray(desired)) {
+				// guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
+				res.writeHead(400, { "Content-Type": "application/json" });
+				res.end(JSON.stringify({ error: "invalid_flags" }));
+				return;
+			}
+			// Only accept known RAG flag keys.
+			const known = new Set(RAG_FLAGS.map((f) => f.key));
+			for (const key of Object.keys(desired)) {
+				if (!known.has(key)) {
+					// guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
+					res.writeHead(400, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({ error: `unknown_flag: ${key}` }));
+					return;
+				}
+			}
+
+			const envPath = join(ctx.stateDir, ".mega-compact.env");
+			let lines: string[] = [];
+			if (existsSync(envPath)) {
+				const content = readFileSync(envPath, "utf-8");
+				lines = content.split("\n").filter((line) => !DISABLED_LINE.test(line));
+			}
+			for (const key of Object.keys(desired)) {
+				if (desired[key] === false) {
+					lines.push(`export ${key}_DISABLED="true"`);
+				}
+			}
+			if (lines.length > 0 && lines[lines.length - 1] !== "") lines.push("");
+			try {
+				mkdirSync(ctx.stateDir, { recursive: true });
+				writeFileSync(envPath, lines.join("\n"), "utf-8");
+			} catch (e) {
+				// guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
+				res.writeHead(500, { "Content-Type": "application/json" });
+				res.end(
+					JSON.stringify({
+						error: `write_failed: ${e instanceof Error ? e.message : String(e)}`,
+					}),
+				);
+				return;
+			}
+			const resp: RagSettingsResponsePost = {
+				envPath,
+				restartRequired: true,
+			};
+			// guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
+			res.writeHead(200, { "Content-Type": "application/json" });
+			res.end(JSON.stringify(resp));
+		});
+		return true;
+	}
+
+	// guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
+	res.writeHead(405, { "Content-Type": "application/json" });
+	res.end(JSON.stringify({ error: "method_not_allowed" }));
+	return true;
+}

package/extensions/dashboard-server/routes.ts

@@ -27,3 +27,4 @@ export { handleRaptorTree } from "./routes-raptor.js";
 export { handleCacheStripes } from "./routes-cache.js";
 export { handleContextHealth, handleCachePoison, handleHealthSettings } from "./routes-health.js";
 export { handleEmbedderHealth } from "./routes-embedder-health.js";
+export { handleRagSettings } from "./routes-rag-settings.js";

package/extensions/dashboard-server/server.ts

@@ -49,6 +49,7 @@ import {
 	handleCachePoison,
 	handleHealthSettings,
 	handleEmbedderHealth,
+	handleRagSettings,
 	handleStatic,
 } from "./routes.js";
 
@@ -249,6 +250,7 @@ export async function launchDashboardServer(
 		if (handleCachePoison(req, res, ctx)) return;
 		if (handleHealthSettings(req, res, ctx)) return;
 		if (handleEmbedderHealth(req, res, ctx)) return;
+		if (handleRagSettings(req, res, ctx)) return;
 		handleStatic(req, res, ctx);
 	});
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-mega-compact",
-  "version": "0.13.2",
+  "version": "0.13.4",
   "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/config.ts

@@ -104,7 +104,9 @@ export function memoryReviewCadence(band: PressureBand, baseInterval: number): n
 }
 
 // ---------------------------------------------------------------------------
-// S57 RAG Suite feature flags — each maps to MEGACOMPACT_* env var, default OFF
+// S57 RAG Suite feature flags — all default ON with graceful fallback; opt OUT
+// via MEGACOMPACT_<NAME>_DISABLED=true. Every feature degrades to existing
+// behavior on error (non-fatal, best-effort).
 // ---------------------------------------------------------------------------
 
 function ragFlag(name: string): boolean {
@@ -113,22 +115,28 @@ function ragFlag(name: string): boolean {
   return v === "true" || v === "1";
 }
 
+function ragEnabled(name: string): boolean {
+  return !ragFlag(name + "_DISABLED");
+}
+
 /** B1: Query reformulation (keyword expansion via embedding neighbors). */
 export const RAG_QUERY_REFORMULATION = (): boolean =>
-  ragFlag("MEGACOMPACT_QUERY_REFORMULATION");
+  ragEnabled("MEGACOMPACT_QUERY_REFORMULATION");
 
 /** B2: Tiered recall router (L0 cache → L1 FTS5 → L2 HNSW). */
 export const RAG_TIERED_ROUTER = (): boolean =>
-  ragFlag("MEGACOMPACT_TIERED_ROUTER");
+  ragEnabled("MEGACOMPACT_TIERED_ROUTER");
 
 /** B3: Recall quality metrics (precision/recall scoring + logging). */
 export const RAG_RECALL_METRICS = (): boolean =>
-  ragFlag("MEGACOMPACT_RECALL_METRICS");
+  ragEnabled("MEGACOMPACT_RECALL_METRICS");
 
 /** B4: Memory graph traversal (dashboard-oriented). */
 export const RAG_MEMORY_GRAPH = (): boolean =>
-  ragFlag("MEGACOMPACT_MEMORY_GRAPH");
+  ragEnabled("MEGACOMPACT_MEMORY_GRAPH");
 
-/** B5: HyDE — generate a hypothetical answer doc via LLM (HttpEmbedder only). Default OFF. */
+/** B5: HyDE — generate a hypothetical answer doc via LLM. Auto-ON when an
+ * HttpEmbedder is active (the LLM is configured for indexing); opt OUT with
+ * MEGACOMPACT_HYDE_DISABLED=true. TrigramEmbedder path is unaffected. */
 export const RAG_HYDE_ENABLED = (): boolean =>
-  ragFlag("MEGACOMPACT_HYDE_ENABLED");
+  ragEnabled("MEGACOMPACT_HYDE");

package/src/httpEmbedder.ts

@@ -173,10 +173,19 @@ export function embeddingConfigFromEnv(): HttpEmbedderOptions | null {
   };
 }
 
-/** Extract a single embedding vector from a tolerant OpenAI-style response. */
+/** True if the URL is an Ollama /api/embeddings endpoint. */
+function isOllamaEndpoint(url: string): boolean {
+  return url.includes("/api/embeddings");
+}
+
+/** Extract a single embedding vector from a tolerant response.
+ *  Handles Ollama ({embedding:[...]}), OpenAI ({data:[{embedding:[...]}]}),
+ *  and simple ({data:[...]} / {embeddings:[...]}) shapes. */
 function parseEmbedding(body: unknown): number[] {
   if (body && typeof body === "object") {
     const b = body as Record<string, unknown>;
+    // Ollama: { embedding: [0.1, ...] }
+    if (Array.isArray(b.embedding)) return b.embedding as number[];
     if (Array.isArray(b.data) && b.data[0] && typeof b.data[0] === "object") {
       const first = b.data[0] as Record<string, unknown>;
       if (Array.isArray(first.embedding)) return first.embedding as number[];
@@ -227,7 +236,10 @@ export class HttpEmbedder implements Embedder {
   }
 
   embed(text: string): Vector {
-    const body = JSON.stringify({ input: [text] });
+    const ollama = isOllamaEndpoint(this.url);
+    const body = ollama
+      ? JSON.stringify({ model: process.env.MEGACOMPACT_OLLAMA_MODEL || "nomic-embed-text", prompt: text })
+      : JSON.stringify({ input: [text] });
     const headers: Record<string, string> = {
       "content-type": "application/json",
       ...this.headers,