pi-mega-compact 0.20.59 → 0.20.61

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

@@ -1,374 +1,17 @@
 /**
- * dashboard-client/src/tabs/TurnsTab.tsx — Turn-by-turn memory tracking + recall (S52).
+ * dashboard-client/src/tabs/TurnsTab.tsx — Turn-by-turn memory surface (S52).
  *
- * Fetches /api/turns (conversation list), expands the active conversation into
- * per-turn detail (/api/turns/conversation/:id), and renders:
- *   - Conversation summary list (turn count, recall total, epochs, last turn).
- *   - Per-turn rows: turn index, role, ctx tokens/percent + pressure band,
- *     epoch id, and the injected-checkpoint recall set (the memory recalled
- *     at each turn, with score + source).
- *   - Pending rewind intents (S52A) + Fork action (S50C primitive).
- *
- * Read-mostly via /api/turns; fork/intent/prune via POST. No absolute URLs
- * (PREVENT-PI-004: loopback-only, same-origin static bundle).
+ * DASH-0d consolidation: the sessions surface owns the turns body as a drill-
+ * down (`SessionsTab/TurnMemoryView.tsx`, re-homed VERBATIM in DASH-0b). This
+ * standalone top-level file is reduced to a thin shell re-exporting
+ * `TurnMemoryView`, so the flag-off pre-rollup 13-tab surface set still
+ * resolves `TurnsTab` (deep-link + lazy-import anchor) with no duplicated
+ * render body. The canonical home is `SessionsTab/TurnMemoryView.tsx`.
  */
 
 import type React from "react";
-import { useCallback, useState } from "react";
-import { useApi } from "../hooks/useApi";
-import {
-	fetchTurns,
-	fetchConversationTurns,
-	fetchTurnIntents,
-	postFork,
-	postTurnIntent,
-} from "../api/client";
-import type {
-	TurnsResponse,
-	ConversationTurnsResponse,
-	RewindIntentsResponse,
-	TurnRow,
-	ConversationSummary,
-} from "@contracts";
-import { Card, CardContent, CardHeader, CardTitle } from "../components/ui/card";
-import { Badge } from "../components/ui/badge";
-import { Button } from "../components/ui/button";
-import { HydeDetailPanel } from "../components/HydeDetailPanel";
-
-function fmtTs(ms: number): string {
-	if (!ms) return "—";
-	return new Date(ms).toLocaleString();
-}
-
-function bandVariant(band: TurnRow["pressureBand"]): "success" | "warning" | "danger" | "default" {
-	if (band === "green") return "success";
-	if (band === "yellow") return "warning";
-	if (band === "red") return "danger";
-	return "default";
-}
-
-function sourceLabel(s: TurnRow["recall"][number]["source"]): string {
-	if (s === "checkpoint") return "ckpt";
-	if (s === "cluster_summary") return "raptor";
-	return "mem";
-}
+import { TurnMemoryView } from "./SessionsTab/TurnMemoryView";
 
 export default function TurnsTab(): React.ReactElement {
-	const {
-		data: turns,
-		loading,
-		error,
-	} = useApi<TurnsResponse>(
-		useCallback(() => fetchTurns(), []),
-		{
-			pollInterval: 10_000,
-		},
-	);
-	const { data: intents } = useApi<RewindIntentsResponse>(
-		useCallback(() => fetchTurnIntents(), []),
-		{ pollInterval: 5_000 },
-	);
-	const [expanded, setExpanded] = useState<string | null>(null);
-	const [detail, setDetail] = useState<ConversationTurnsResponse | null>(null);
-	const [detailLoading, setDetailLoading] = useState(false);
-	const [busy, setBusy] = useState<string | null>(null);
-	const [notice, setNotice] = useState<string | null>(null);
-
-	const expand = useCallback(
-		async (conversationId: string) => {
-			if (expanded === conversationId) {
-				setExpanded(null);
-				setDetail(null);
-				return;
-			}
-			setExpanded(conversationId);
-			setDetailLoading(true);
-			setDetail(null);
-			try {
-				const d = await fetchConversationTurns(conversationId);
-				setDetail(d);
-			} finally {
-				setDetailLoading(false);
-			}
-		},
-		[expanded],
-	);
-
-	const onFork = useCallback(
-		async (conversationId: string, turnIndex: number) => {
-			setBusy(`fork:${conversationId}:${turnIndex}`);
-			setNotice(null);
-			try {
-				const out = await postFork(conversationId, turnIndex);
-				setNotice(
-					`Forked → ${out.childConversationId} (${out.recalledCount} recalled)`,
-				);
-			} catch (e) {
-				setNotice(`Fork failed: ${(e as Error).message}`);
-			} finally {
-				setBusy(null);
-			}
-		},
-		[],
-	);
-
-	const onRewind = useCallback(
-		async (conversationId: string, turnIndex: number) => {
-			setBusy(`rewind:${conversationId}:${turnIndex}`);
-			setNotice(null);
-			try {
-				await postTurnIntent(conversationId, turnIndex);
-				setNotice(`Rewind intent queued for turn ${turnIndex}`);
-			} catch (e) {
-				setNotice(`Rewind failed: ${(e as Error).message}`);
-			} finally {
-				setBusy(null);
-			}
-		},
-		[],
-	);
-
-	if (error && !turns) {
-		return <div className="tab-stub">Error loading turns: {error.message}</div>;
-	}
-	if (loading && !turns) {
-		return <div className="tab-stub">Loading turns…</div>;
-	}
-	if (!turns || turns.conversations.length === 0) {
-		return (
-			<div className="tab-stub">
-				<h3>Turn-by-turn memory</h3>
-				<p>
-					No turns recorded yet. Per-turn tracking starts when{" "}
-					<code>MEGACOMPACT_TURNS_DB=1</code> and the session runs through a
-					compaction. Each turn records its context metrics + the checkpoints
-					recalled into it.
-				</p>
-			</div>
-		);
-	}
-
-	return (
-		<div className="flex flex-col gap-4">
-			<h3 className="font-heading text-lg font-semibold">
-				Turn-by-turn memory tracking + recall
-			</h3>
-			{notice && <Badge variant="warning">{notice}</Badge>}
-
-			{intents && intents.intents.length > 0 && (
-				<Card>
-					<CardHeader>
-						<CardTitle>
-							Pending rewind intents ({intents.intents.length})
-						</CardTitle>
-					</CardHeader>
-					<CardContent>
-						<ul className="list-disc space-y-1 pl-5">
-							{intents.intents.map((i) => (
-								<li key={i.id}>
-									{fmtTs(i.createdAt)} — rewind{" "}
-									<code>{i.conversationId}</code> to turn {i.targetTurnIndex}
-								</li>
-							))}
-						</ul>
-					</CardContent>
-				</Card>
-			)}
-
-			<Card>
-				<CardHeader>
-					<CardTitle>
-						Conversations ({turns.conversations.length})
-					</CardTitle>
-				</CardHeader>
-				<CardContent>
-					<table className="w-full border-collapse text-sm">
-						<thead>
-							<tr>
-								<th className="border-b border-border px-3 py-2 text-left font-medium text-muted-foreground">Conversation</th>
-								<th className="border-b border-border px-3 py-2 text-left font-medium text-muted-foreground">Turns</th>
-								<th className="border-b border-border px-3 py-2 text-left font-medium text-muted-foreground">Recall</th>
-								<th className="border-b border-border px-3 py-2 text-left font-medium text-muted-foreground">Epochs</th>
-								<th className="border-b border-border px-3 py-2 text-left font-medium text-muted-foreground">Avg ctx%</th>
-								<th className="border-b border-border px-3 py-2 text-left font-medium text-muted-foreground">Last turn</th>
-								<th className="border-b border-border px-3 py-2"></th>
-							</tr>
-						</thead>
-						<tbody>
-							{turns.conversations.map((c: ConversationSummary) => (
-								<ConversationRow
-									key={c.conversationId}
-									c={c}
-									active={turns.activeConversationId === c.conversationId}
-									expanded={expanded === c.conversationId}
-									onExpand={() => expand(c.conversationId)}
-								/>
-							))}
-						</tbody>
-					</table>
-				</CardContent>
-			</Card>
-
-			{expanded && (
-				<Card>
-					<CardHeader>
-						<CardTitle>
-							Turns in <code>{expanded}</code>
-						</CardTitle>
-					</CardHeader>
-					<CardContent>
-						{detailLoading ? (
-							<div className="text-sm text-muted-foreground">Loading turns…</div>
-						) : detail ? (
-							<TurnDetail
-								detail={detail}
-								busy={busy}
-								onFork={onFork}
-								onRewind={onRewind}
-							/>
-						) : (
-							<div className="text-sm text-muted-foreground">No detail.</div>
-						)}
-					</CardContent>
-				</Card>
-			)}
-		</div>
-	);
-}
-
-function ConversationRow({
-	c,
-	active,
-	expanded,
-	onExpand,
-}: {
-	c: ConversationSummary;
-	active: boolean;
-	expanded: boolean;
-	onExpand: () => void;
-}): React.ReactElement {
-	return (
-		<>
-			<tr
-				className={`border-b border-border/50 hover:bg-bg-elevated/40 ${
-					active ? "bg-primary/10" : ""
-				}`}
-				onClick={onExpand}
-				style={{ cursor: "pointer" }}
-			>
-				<td className="px-3 py-2">
-					{expanded ? "▾" : "▸"} <code>{c.conversationId}</code>
-					{active && <Badge variant="accent" className="ml-2">active</Badge>}
-				</td>
-				<td className="px-3 py-2 text-right">{c.turnCount}</td>
-				<td className="px-3 py-2 text-right">{c.totalRecall}</td>
-				<td className="px-3 py-2 text-right">{c.epochCount}</td>
-				<td className="px-3 py-2 text-right">{c.avgCtxPercent.toFixed(0)}%</td>
-				<td className="px-3 py-2">{fmtTs(c.lastTurnAt)}</td>
-				<td className="px-3 py-2" />
-			</tr>
-		</>
-	);
-}
-
-function TurnDetail({
-	detail,
-	busy,
-	onFork,
-	onRewind,
-}: {
-	detail: ConversationTurnsResponse;
-	busy: string | null;
-	onFork: (conversationId: string, turnIndex: number) => void;
-	onRewind: (conversationId: string, turnIndex: number) => void;
-}): React.ReactElement {
-	return (
-		<table className="w-full border-collapse text-sm">
-			<thead>
-				<tr>
-					<th className="border-b border-border px-3 py-2 text-left font-medium text-muted-foreground">#</th>
-					<th className="border-b border-border px-3 py-2 text-left font-medium text-muted-foreground">Role</th>
-					<th className="border-b border-border px-3 py-2 text-left font-medium text-muted-foreground">Ctx</th>
-					<th className="border-b border-border px-3 py-2 text-left font-medium text-muted-foreground">Band</th>
-					<th className="border-b border-border px-3 py-2 text-left font-medium text-muted-foreground">Epoch</th>
-					<th className="border-b border-border px-3 py-2 text-left font-medium text-muted-foreground">Recalled checkpoints (memory recall)</th>
-					<th className="border-b border-border px-3 py-2 text-left font-medium text-muted-foreground">HyDE</th>
-					<th className="border-b border-border px-3 py-2 text-left font-medium text-muted-foreground">Ended</th>
-					<th className="border-b border-border px-3 py-2 text-left font-medium text-muted-foreground">Actions</th>
-				</tr>
-			</thead>
-			<tbody>
-				{detail.turns.map((t) => (
-					<tr
-						key={`${t.conversationId}:${t.turnIndex}`}
-						className="border-b border-border/50 hover:bg-bg-elevated/40"
-					>
-						<td className="px-3 py-2 text-right">{t.turnIndex}</td>
-						<td className="px-3 py-2">{t.role}</td>
-						<td className="px-3 py-2">
-							{t.ctxTokens ?? "—"}
-							{t.ctxPercent != null && (
-								<span className="text-muted-foreground">
-									{" "}
-									· {t.ctxPercent.toFixed(0)}%
-								</span>
-							)}
-						</td>
-						<td className="px-3 py-2">
-							<Badge variant={bandVariant(t.pressureBand)}>
-								{t.pressureBand ?? "—"}
-							</Badge>
-						</td>
-						<td className="px-3 py-2">{t.epochId ? <code>{t.epochId.slice(0, 8)}</code> : "—"}</td>
-						<td className="px-3 py-2">
-							{t.recall.length === 0 ? (
-								<span className="text-muted-foreground">—</span>
-							) : (
-								<ul className="space-y-1">
-									{t.recall.map((r) => (
-										<li key={r.checkpointId}>
-											<code>{r.checkpointId.slice(0, 12)}</code>{" "}
-											<span className="text-muted-foreground">
-												{sourceLabel(r.source)} · {r.score.toFixed(2)}
-												{r.raptorLevel != null ? ` · L${r.raptorLevel}` : ""}
-											</span>
-										</li>
-									))}
-								</ul>
-							)}
-						</td>
-						<td className="px-3 py-2 align-top">
-							<HydeDetailPanel
-								conversationId={t.conversationId}
-								turnIndex={t.turnIndex}
-							/>
-						</td>
-						<td className="px-3 py-2">{fmtTs(t.endedAt)}</td>
-						<td className="px-3 py-2">
-							<div className="flex gap-2">
-								<Button
-									type="button"
-									variant="outline"
-									size="sm"
-									disabled={busy !== null}
-									onClick={() => onFork(t.conversationId, t.turnIndex)}
-								>
-									fork
-								</Button>
-								<Button
-									type="button"
-									variant="outline"
-									size="sm"
-									disabled={busy !== null}
-									onClick={() => onRewind(t.conversationId, t.turnIndex)}
-								>
-									rewind
-								</Button>
-							</div>
-						</td>
-					</tr>
-				))}
-			</tbody>
-		</table>
-	);
+	return <TurnMemoryView />;
 }

package/extensions/dashboard-client/src/tabs/dashHashRouter.ts

@@ -0,0 +1,76 @@
+/**
+ * dashboard-client/src/tabs/dashHashRouter.ts — DASH-0d additive hash→surface
+ * deep-link router.
+ *
+ * The dashboard has historically had NO URL-routing (single `useState<TabId>
+ * ("overview")` in App.tsx). DASH-0d adds an ADDITIVE hash listener so every
+ * legacy deep link (e.g. `#turns`, `#metrics`, `#repos`) still lands on a live
+ * consolidated surface, and an empty hash keeps the current behavior (the
+ * caller's default tab). It does NOT replace the existing tab state — App.tsx
+ * keeps `useState` and this hook only *points* at a surface when the hash maps
+ * to one.
+ *
+ * Mapping (DASH-0a `DEEP_LINK_TARGETS` + the DASH-0d release set):
+ *   #sessions, #turns          → sessions
+ *   #cache, #metrics           → cache-perf
+ *   #repos, #wiki, #memory-map → memory-graph
+ *   #events, #health, #vector-cortex → diagnostics
+ *   #maintenance, #config      → admin
+ *   #setup, #overview          → themselves
+ *   (empty)                    → null (current behavior)
+ *
+ * PREVENT-PI-004: browser `location` + `hashchange` only — no network.
+ * PREVENT-011: no `any`. Pure client view concern; no endpoint reads added.
+ */
+
+import { useEffect, useState } from "react";
+import type { DashTabId } from "./registry";
+
+/**
+ * The consolidated surface a legacy hash resolves to. Every key is a legacy
+ * deep-link fragment mapped onto the fixed 7 surfaces. `config`/`setup`/
+ * `overview` are explicit release aliases so no old bookmark goes dead.
+ */
+export const HASH_TO_SURFACE: Readonly<Record<string, DashTabId>> = {
+  overview: "overview",
+  sessions: "sessions",
+  turns: "sessions",
+  cache: "cache-perf",
+  metrics: "cache-perf",
+  "memory-map": "memory-graph",
+  repos: "memory-graph",
+  wiki: "memory-graph",
+  "vector-cortex": "diagnostics",
+  events: "diagnostics",
+  health: "diagnostics",
+  setup: "setup",
+  config: "admin",
+  maintenance: "admin",
+};
+
+/** Resolve the current `location.hash` to a consolidated surface (null if empty). */
+export function resolveHashToSurface(hash: string): DashTabId | null {
+  const clean = hash.replace(/^#/, "").trim();
+  if (!clean) return null;
+  const surface = HASH_TO_SURFACE[clean];
+  return surface ?? null;
+}
+
+/**
+ * Additive hash listener. Returns the consolidated `DashTabId` the current
+ * `location.hash` maps to, or `null` when the hash is empty (current behavior)
+ * or unmapped. Re-syncs whenever the hash changes.
+ */
+export function useHashTab(): DashTabId | null {
+  const [surface, setSurface] = useState<DashTabId | null>(() =>
+    resolveHashToSurface(window.location.hash),
+  );
+
+  useEffect(() => {
+    const onHashChange = () => setSurface(resolveHashToSurface(window.location.hash));
+    window.addEventListener("hashchange", onHashChange);
+    return () => window.removeEventListener("hashchange", onHashChange);
+  }, []);
+
+  return surface;
+}

package/extensions/dashboard-client/src/tabs/index.ts

@@ -10,12 +10,13 @@
  * Host mapping (surface → component):
  *   - overview            → OverviewTab
  *   - sessions            → SessionsTab  (TurnsTab folded in via TurnMemoryView)
- *   - cache-perf          → CacheTab
+ *   - cache-perf          → CacheTab      (label "Cache+Performance"; MetricsTab
+ *                            folded in via CacheTab/MetricsCards)
  *   - memory-graph        → MemoryMapTab
  *   - diagnostics         → VectorCortexTab
- *   - setup               → SetupTab
- *   - admin               → AdminTab  (RESERVED alias — maps to the existent
- *                            MaintenanceTab; no standalone AdminTab.tsx yet)
+ *   - setup               → SetupTab      (config sub-tab hidden when DASH-0c ON)
+ *   - admin               → AdminTab      (DASH-0c: MaintenanceTab + ConfigTab
+ *                            combined via an AdminViews toggle)
  *
  * PREVENT-PI-004: imports only — no network. PREVENT-011: no `any`.
  */
@@ -26,5 +27,5 @@ export { default as CacheTab } from "./CacheTab";
 export { default as MemoryMapTab } from "./MemoryMapTab";
 export { default as VectorCortexTab } from "./VectorCortexTab";
 export { default as SetupTab } from "./SetupTab";
-/** Reserved admin-surface alias: maps to the existent MaintenanceTab host. */
-export { default as AdminTab } from "./MaintenanceTab";
+/** DASH-0c: the Admin surface combines MaintenanceTab + ConfigTab. */
+export { default as AdminTab } from "./AdminTab";

package/extensions/dashboard-client/src/tabs/registry.ts

@@ -66,7 +66,7 @@ export const ADVANCED_TAB_IDS: ReadonlySet<TabId> = new Set(
  * LEFT UNCHANGED (rollback-safe) — this constant documents the 7 surfaces the
  * DASH-0d rewire will navigate, and deliberately does NOT replace TabId.
  */
-export const DASH_SURFACE_IDS: readonly string[] = [
+export const DASH_SURFACE_IDS = [
   "overview",
   "sessions",
   "cache-perf",
@@ -75,3 +75,28 @@ export const DASH_SURFACE_IDS: readonly string[] = [
   "setup",
   "admin",
 ] as const;
+
+/** The fixed 7 consolidated navigational surface ids (DASH-0d navigation set).
+ *  Distinct from the legacy 13-tab `TabId` union, which is retained for the
+ *  flag-off (pre-rollup) surface set + the sidebar/AppShell nav types. */
+export type DashTabId = (typeof DASH_SURFACE_IDS)[number];
+
+/** Exactly 7 top-level navigational surfaces (DASH-0d tab-count contract). */
+export const DASH_TAB_COUNT: number = DASH_SURFACE_IDS.length;
+
+/**
+ * DASH-0c: labels for the consolidated surfaces. Additive — the 13-tab
+ * `PRIMARY_TABS`/`ADVANCED_TABS` labels above stay untouched (rollback-safe;
+ * the live 13-tab UI renders as today until the DASH-0d rewire). `cache-perf`
+ * takes the "Cache+Performance" label once MetricsTab folds in as a Performance
+ * section; `admin` hosts the combined Maintenance+Config AdminTab.
+ */
+export const DASH_SURFACE_LABELS: Readonly<Record<string, string>> = {
+  overview: "Overview",
+  sessions: "Sessions",
+  "cache-perf": "Cache+Performance",
+  "memory-graph": "Memory Graph",
+  diagnostics: "Diagnostics",
+  setup: "Setup",
+  admin: "Admin",
+} as const;

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

@@ -342,5 +342,17 @@ export const VECTOR_CORTEX_SETTINGS: SettingGroup = {
 			"DASH-0b dashboard consolidation execution: (1) the Sessions surface absorbs TurnsTab as a drill-down — a SessionsViews toggle renders the existent session summary/chart/table or the turns view (TurnMemoryView); (2) VectorCortexTab re-groups its flat 14-card layout under 4 <section aria-labelledby> headers (Cortex status / repair / cache / adaptive). OFF = SessionsTab renders only its own body (no toggle, no TurnMemoryView) and VectorCortexTab keeps its flat card layout (byte-identical predecessor).",
 			true,
 		),
+		boolDirect(
+			"MEGACOMPACT_DASH_0C",
+			"Dashboard Consolidation — Cache+Performance / Admin",
+			"DASH-0c dashboard consolidation execution: (1) the Cache surface absorbs MetricsTab as a Performance section (CacheTab label becomes 'Cache+Performance'); (2) MaintenanceTab + ConfigTab combine under a new AdminTab delegate-shell with an AdminViews toggle (maintenance/config), and SetupTab hides its Config sub-tab. OFF = CacheTab renders only its cache sections, MetricsTab/MaintenanceTab/ConfigTab render as standalone surfaces, SetupTab keeps its Config sub-tab (byte-identical predecessor).",
+			true,
+		),
+		boolDirect(
+			"MEGACOMPACT_DASH_0D",
+			"Dashboard Consolidation — Rollup / 7-surface",
+			"DASH-0d dashboard consolidation roll-up: App.tsx consolidates its lazy list + TabContent switch onto the 7 fixed navigational surfaces (Overview, Sessions, Cache+Performance, Memory Graph, Diagnostics, Setup, Admin) with an additive hash→surface deep-link router; the duplicate TurnsTab/MetricsTab indirection bodies are reconciled to their canonical homes. OFF = App.tsx reproduces the pre-rollup 13-tab surface set byte-identically (byte-identical DASH-0c predecessor).",
+			true,
+		),
 	],
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-mega-compact",
-  "version": "0.20.59",
+  "version": "0.20.61",
   "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/vector-cortex-dash-0c.ts

@@ -0,0 +1,25 @@
+/**
+ * config/vector-cortex-dash-0c.ts — DASH-0c dashboard consolidation execution flag.
+ *
+ * Extracted to this sibling (per the vector-cortex-dash-0a.ts precedent) so
+ * src/config/vector-cortex.ts stays under the 300-line soft limit. The flag is
+ * positive, defaults ON, and `MEGACOMPACT_DASH_0C=0` is byte-identical to the
+ * predecessor: CacheTab and MetricsTab render as two independent top-level
+ * surfaces, MaintenanceTab and ConfigTab render exactly as today, and SetupTab
+ * keeps its Config sub-tab. Registered as a visible VECTOR_CORTEX_SETTINGS
+ * boolDirect toggle, never EXCLUDED.
+ *
+ * Pi-agnostic, dependency-free (PREVENT-PI-004 / PREVENT-011).
+ */
+
+import { sprintFlag } from "./vector-cortex-flag.js";
+
+/**
+ * DASH-0c — second execution sprint of the DASH consolidation plan:
+ * (1) Cache+Performance — CacheTab absorbs MetricsTab as a Performance section
+ *     via MetricsCards; (2) Admin — MaintenanceTab + ConfigTab combine under a
+ *     new AdminTab delegate-shell with an AdminViews toggle, and SetupTab hides
+ *     its Config sub-tab. `MEGACOMPACT_DASH_0C=0` renders the predecessor
+ *     standalone surfaces — byte-identical.
+ */
+export const DASH_0C_ENABLED = (): boolean => sprintFlag("MEGACOMPACT_DASH_0C");

package/src/config/vector-cortex-dash-0d.ts

@@ -0,0 +1,28 @@
+/**
+ * config/vector-cortex-dash-0d.ts — DASH-0d dashboard consolidation roll-up flag.
+ *
+ * Extracted to this sibling (per the vector-cortex-dash-0c.ts precedent) so
+ * src/config/vector-cortex.ts stays under the 300-line soft limit. The flag is
+ * positive, defaults ON, and `MEGACOMPACT_DASH_0D=0` is byte-identical to the
+ * predecessor (DASH-0c): App.tsx renders the pre-rollup 13-tab surface set and
+ * the registry holds the 13-tab union; no indirection name is removed and no
+ * audit/verifier script is invoked by CI. Registered as a visible
+ * VECTOR_CORTEX_SETTINGS boolDirect toggle, never EXCLUDED.
+ *
+ * Pi-agnostic, dependency-free (PREVENT-PI-004 / PREVENT-011).
+ */
+
+import { sprintFlag } from "./vector-cortex-flag.js";
+
+/**
+ * DASH-0d — final DASH sprint, the roll-up that makes the 7-surface target
+ * externally provable: (1) App.tsx consolidates its lazy list to the 7 fixed
+ * navigational surfaces (Overview, Sessions, Cache+Performance, Memory Graph,
+ * Diagnostics, Setup, Admin) with an additive hash→surface router; (2) the
+ * duplicate TurnsTab/MetricsTab indirection bodies are reconciled to their
+ * canonical homes (TurnMemoryView / MetricsCards); (3) new dash-tab-count.mjs
+ * and dashboard-audit.mjs verifiers prove the consolidated surface count + a11y
+ * contract; (4) conformance fixtures DASH-0D-001..004 + evidence roll-up.
+ * `MEGACOMPACT_DASH_0D=0` renders the pre-rollup 13-surface set — byte-identical.
+ */
+export const DASH_0D_ENABLED = (): boolean => sprintFlag("MEGACOMPACT_DASH_0D");

package/src/config/vector-cortex.ts

@@ -73,6 +73,10 @@ export { REPO_CORPUS_ENABLED } from "./repo-corpus.js";
 export { DASH_0A_ENABLED } from "./vector-cortex-dash-0a.js";
 // DASH-0b dashboard consolidation execution flag extracted to vector-cortex-dash-0b.ts.
 export { DASH_0B_ENABLED } from "./vector-cortex-dash-0b.js";
+// DASH-0c dashboard consolidation execution flag extracted to vector-cortex-dash-0c.ts.
+export { DASH_0C_ENABLED } from "./vector-cortex-dash-0c.js";
+// DASH-0d dashboard consolidation roll-up flag extracted to vector-cortex-dash-0d.ts.
+export { DASH_0D_ENABLED } from "./vector-cortex-dash-0d.js";
 export { ENC_1A_ENABLED } from "./vector-cortex-enc1a.js";
 export {
   ENC_1B_ENABLED,

package/src/config.ts

@@ -207,6 +207,8 @@ export {
   REPO_CORPUS_ENABLED,
   DASH_0A_ENABLED,
   DASH_0B_ENABLED,
+  DASH_0C_ENABLED,
+  DASH_0D_ENABLED,
   BREAKER_WINDOW_MS,
   BREAKER_MIN_ATTEMPTS,
   BREAKER_PERF_FAILURES,

package/extensions/dashboard-client/dist/assets/CacheTab-BLM6_PQQ.js

@@ -1,2 +0,0 @@
-import{j as e,r as h,u as m,y as I,z as k,x as w,l as D}from"./index-Bjvv23bp.js";import{C as W,T as F}from"./TimeSavedCard-BkRzjyRm.js";import{b as u,c as v,d as _,e as O,f as x}from"./format-COjDIVGj.js";import{l as G}from"./pricing-DkYp8-vi.js";import{C as f,a as C,b as S,c as N}from"./card-Daf3pQIu.js";import{B}from"./button-Bynl3ONj.js";import{a as z}from"./client-extra-DqAYZBW1.js";function L(t){return t>=80?"ov-stat-value-green":t>=50?"ov-stat-value-yellow":"ov-stat-value-red"}function K(t){return t==null?"":t>=0?"ov-stat-value-green":"ov-stat-value-red"}function n({label:t,value:a,className:s,title:l}){return e.jsxs("div",{className:"flex items-baseline justify-between border-b border-border py-1 text-sm",children:[e.jsx("span",{className:"text-xs text-muted-foreground",title:l,children:t}),e.jsx("span",{className:`font-semibold${s?` ${s}`:""}`,children:a})]})}function U(t){return e.jsxs(f,{className:"electric-hover",children:[e.jsx(C,{children:e.jsx(S,{children:"Provider Prompt Cache"})}),e.jsxs(N,{children:[e.jsx(n,{label:"Cache Hit Rate",value:`${t.hitPct.toFixed(1)}%`,className:L(t.hitPct)}),e.jsx(n,{label:"Turns Recorded",value:String(t.turnCount)}),e.jsx(n,{label:"Cache Read Tokens",value:u(t.totalCacheRead)}),e.jsx(n,{label:"Cache Write Tokens",value:u(t.totalCacheWrite)}),e.jsx(n,{label:"Input Tokens",value:u(t.totalInput)}),e.jsx(n,{label:"$ Saved (reads)",value:v(t.cacheReadSaved)}),e.jsx(n,{label:"Write Investment",value:v(t.cacheWriteCost)}),e.jsx(n,{label:"Net Saved",value:v(t.netSaved),className:K(t.netSaved)}),e.jsx(n,{label:"Model",value:t.modelLabel??"—"}),e.jsx(n,{label:"Tracked Since",value:_(t.firstTurnAt)}),e.jsx(n,{label:"Last Updated",value:O(t.latestTurnAt)}),t.byModel.length>0&&e.jsxs(e.Fragment,{children:[e.jsx("div",{className:"mt-2 text-xs font-semibold text-muted-foreground",children:"Per Model"}),t.byModel.map(a=>{const s=G(a.model),l=s!=null?a.totalCacheRead/1e6*s:null,r=s!=null?a.totalCacheWrite/1e6*s:null;return e.jsxs("div",{className:"mt-2",children:[e.jsx(n,{label:"Model",value:a.model}),e.jsx(n,{label:"Hit Rate",value:`${a.hitPct.toFixed(1)}%`,className:L(a.hitPct)}),e.jsx(n,{label:"Cache Read",value:u(a.totalCacheRead)}),e.jsx(n,{label:"Cache Write",value:u(a.totalCacheWrite)}),e.jsx(n,{label:"Samples",value:String(a.sampleCount)}),e.jsx(n,{label:"$ Saved (reads)",value:l!=null?v(l):"—"}),e.jsx(n,{label:"Write Investment",value:r!=null?v(r):"—"})]},a.model)})]})]})]})}const V=["ov-bar-green","ov-bar-blue","ov-bar-teal","ov-bar-yellow","ov-bar-gray"],q=["Permanent","Epoch","Topic","Thread","Volatile"],J={good:"ov-text-green",fair:"ov-text-yellow",degraded:"ov-text-orange",poor:"ov-text-red"};function Q({data:t}){const a=Math.max(...t.buckets.map(l=>l.count),1),s=J[t.health.label]??"ov-text-gray";return e.jsxs("div",{className:"ov-card",children:[e.jsx("h3",{className:"ov-card-title",children:"Cache Stripe Distribution"}),e.jsxs("div",{className:"ov-stripe-health-summary",children:[e.jsx("span",{className:`ov-stripe-health-badge ${s}`,children:t.health.label}),e.jsx("span",{className:"ov-stripe-health-score",children:x(t.health.score)}),e.jsxs("span",{className:"ov-stripe-churn",children:["Churn: ",x(t.health.churnRate)]}),e.jsxs("span",{className:"ov-stripe-total",children:[t.totalChunks," total chunks"]})]}),e.jsx("div",{className:"ov-stripe-bars",children:t.buckets.map(l=>{const r=a>0?Math.max(0,Math.min(100,l.count/a*100)):0,i=V[l.stripe]??"ov-bar-gray",o=l.label||(q[l.stripe]??`Stripe ${l.stripe}`);return e.jsxs("div",{className:"ov-stripe-row",children:[e.jsx("span",{className:"ov-stripe-label",title:o,children:o}),e.jsx("div",{className:"ov-bar-track",children:e.jsx("div",{className:`ov-bar-fill ${i}`,style:{width:`${r}%`}})}),e.jsx("span",{className:"ov-stripe-count",children:l.count}),e.jsx("span",{className:"ov-stripe-stability",title:`min ${x(l.minStability)} / max ${x(l.maxStability)}`,children:x(l.avgStability)})]},l.stripe)})}),e.jsxs("div",{className:"ov-stripe-footer",children:["Epoch: ",t.epochId??"—","· Dominant tier: ",x(t.health.dominantTier)]})]})}function g(t){return`${t.toFixed(1)}%`}function X(t){return t>=80?"ov-bar-green":t>=60?"ov-bar-teal":t>=40?"ov-bar-yellow":t>=20?"ov-bar-orange":"ov-bar-red"}const Y=({perf:t})=>{const{cache_hit_pct:a}=t,s=a.samples&&a.samples.length>0?a.samples:[];return e.jsxs(f,{className:"electric-hover",children:[e.jsx(C,{children:e.jsx(S,{children:"Cache Hit-Rate Trend"})}),e.jsxs(N,{children:[e.jsxs("div",{className:"mb-3 flex gap-4 text-sm text-muted-foreground",children:[e.jsxs("div",{children:["Avg: ",e.jsx("strong",{className:"text-foreground",children:g(a.avg)})]}),e.jsxs("div",{children:["Latest: ",e.jsx("strong",{className:"text-foreground",children:g(a.latest)})]}),e.jsxs("div",{children:["Samples: ",e.jsx("strong",{className:"text-foreground",children:a.n})]})]}),s.length>0?e.jsxs(e.Fragment,{children:[e.jsx("div",{className:"ov-sparkline",role:"img","aria-label":`Cache hit rate trend: ${a.n} samples, average ${g(a.avg)}, latest ${g(a.latest)}`,children:s.map((l,r)=>{const i=Math.max(2,Math.round(l.pct*.6)),o=X(l.pct),c=r===s.length-1;return e.jsx("div",{className:`ov-sparkline-bar ${o}${c?" ov-bar-latest":""}`,style:{height:`${i}px`},title:`${g(l.pct)} at ${new Date(l.ts).toLocaleTimeString()}`},r)})}),e.jsxs("div",{className:"mt-1 text-xs text-muted-foreground",children:[s.length," sample",s.length!==1?"s":""," over"," ",s.length>1?`${Math.round((s[s.length-1].ts-s[0].ts)/1e3)}s`:"latest turn"]})]}):e.jsx("div",{className:"text-sm text-muted-foreground",children:"No cache-hit samples yet"})]})]})};function T(t){return`${(t*100).toFixed(1)}%`}function Z(t){const a=t*100;return a>=80?"ov-bar-green":a>=60?"ov-bar-teal":a>=40?"ov-bar-yellow":a>=20?"ov-bar-orange":"ov-bar-red"}const A={improving:"Improving",stable:"Stable",degrading:"Degrading"},ee=({data:t})=>{const{turns:a,avgRatio:s,trend:l}=t;return e.jsxs(f,{className:"electric-hover",children:[e.jsx(C,{children:e.jsx(S,{children:"Per-Turn Stable Prefix"})}),e.jsxs(N,{children:[e.jsxs("div",{className:"mb-3 flex gap-4 text-sm text-muted-foreground",children:[e.jsxs("div",{children:["Avg:"," ",e.jsx("strong",{className:"text-foreground",children:T(s)})]}),e.jsxs("div",{children:["Trend:"," ",e.jsx("strong",{className:"text-foreground",children:A[l]})]}),e.jsxs("div",{children:["Turns: ",e.jsx("strong",{className:"text-foreground",children:a.length})]})]}),a.length>0?e.jsxs(e.Fragment,{children:[e.jsx("div",{className:"ov-sparkline",role:"img","aria-label":`Per-turn stable-prefix ratio trend: ${a.length} turns, average ${T(s)}, trend ${A[l]}`,children:a.map((r,i)=>{const o=Math.max(2,Math.round(r.ratio*60)),c=Z(r.ratio),p=i===a.length-1;return e.jsx("div",{className:`ov-sparkline-bar ${c}${p?" ov-bar-latest":""}`,style:{height:`${o}px`},title:`Turn ${r.turnIndex}: ${T(r.ratio)} (${r.stablePrefix}/${r.totalMessages} msg) @ ${new Date(r.timestamp).toLocaleTimeString()}`},i)})}),e.jsx("div",{className:"mt-1 text-xs text-muted-foreground",children:"Shared prompt-cache prefix ratio per turn — higher is better."})]}):e.jsx("div",{className:"text-sm text-muted-foreground",children:"No stable-prefix samples yet"})]})]})};function oe(){const[t,a]=h.useState(!1),{data:s,loading:l,error:r}=m(h.useCallback(()=>I(),[]),{pollInterval:5e3}),{data:i,loading:o,error:c}=m(h.useCallback(()=>k(),[]),{pollInterval:15e3}),{data:p,loading:E,error:y}=m(h.useCallback(()=>w({minutes:30}),[]),{pollInterval:15e3}),{data:P,loading:M}=m(h.useCallback(()=>z(50),[]),{pollInterval:15e3}),{data:d,loading:H,error:$}=m(h.useCallback(()=>D(),[]),{pollInterval:5e3});return e.jsxs("div",{className:"flex flex-col gap-4",children:[e.jsxs("div",{children:[e.jsx(B,{type:"button",variant:"outline",onClick:()=>a(!t),children:t?"Hide Guidance":"Show Cache-Friendly Prompt Ordering Guidance"}),t&&e.jsxs(f,{className:"mt-3",children:[e.jsx(C,{children:e.jsx(S,{children:"Cache-Friendly Prompt Ordering"})}),e.jsxs(N,{children:[e.jsxs("ul",{className:"list-disc space-y-1 pl-5",children:[e.jsx("li",{children:"Keep system prompts and stable context at the top of your conversation — the provider caches the leading prefix."}),e.jsxs("li",{children:["Tool results and volatile content are automatically moved to the tail by message separation (",e.jsx("code",{children:"MEGACOMPACT_MESSAGE_SEPARATION"}),") so they don't invalidate the cache prefix."]}),e.jsxs("li",{children:["Cache striping (",e.jsx("code",{children:"MEGACOMPACT_CACHE_STRIPING"}),") further orders stable context by a stability score so the most durable chunks lead."]}),e.jsx("li",{children:"Avoid inserting new instructions mid-conversation — prepend them instead."})]}),d&&e.jsxs("div",{className:"mt-2 text-sm",children:[e.jsx("strong",{children:"Status:"})," ",d.config.auto?"Auto-compaction Enabled":"Auto-compaction Disabled"," |"," ","fast-gate ",d.config.fastGatePct,"% / threshold"," ",d.config.thresholdTokens.toLocaleString()," tokens"]})]})]})]}),e.jsx("h2",{className:"font-heading text-lg font-semibold",children:"Provider Prompt Cache"}),l?e.jsx("p",{className:"tab-stub",children:"Loading..."}):r?e.jsxs("p",{className:"tab-stub",children:["Provider cache unavailable: ",r.message]}):s?e.jsx(U,{hitPct:s.cache.avgHitPct,turnCount:s.cache.turnCount,totalCacheRead:s.cache.totalCacheRead,totalCacheWrite:s.cache.totalCacheWrite,totalInput:s.cache.totalInput,cacheReadSaved:s.savings?.cacheReadSaved??null,cacheWriteCost:s.savings?.cacheWriteCost??null,netSaved:s.savings?.netSaved??null,modelLabel:s.savings?.model??null,firstTurnAt:s.cache.firstTurnAt,latestTurnAt:s.cache.latestTurnAt,byModel:s.cache.byModel??[]}):null,e.jsx("h2",{className:"font-heading text-lg font-semibold",children:"Cache Stripe Distribution"}),o?e.jsx("p",{className:"tab-stub",children:"Loading..."}):c?e.jsxs("p",{className:"tab-stub",children:["Cache stripe data unavailable: ",c.message]}):i?e.jsx(Q,{data:i}):null,e.jsx("h2",{className:"font-heading text-lg font-semibold",children:"Cache Hit-Rate Trend"}),E?e.jsx("p",{className:"tab-stub",children:"Loading..."}):y?e.jsxs("p",{className:"tab-stub",children:["Hit-rate trend unavailable: ",y.message]}):p?e.jsx(Y,{perf:p}):null,P&&!M?e.jsxs("div",{children:[e.jsx("h2",{className:"font-heading text-lg font-semibold",children:"Per-Turn Stable Prefix"}),e.jsx(ee,{data:P})]}):null,e.jsx("h2",{className:"font-heading text-lg font-semibold",children:"Mega-Compact Dedup Cache"}),H?e.jsx("p",{className:"tab-stub",children:"Loading..."}):$?e.jsxs("p",{className:"tab-stub",children:["Snapshot unavailable: ",$.message]}):d&&(()=>{const{cacheHits:b,compacts:R,timeSaved:j}=d;return e.jsxs("div",{className:"grid grid-cols-1 gap-4 md:grid-cols-2 xl:grid-cols-3",children:[e.jsx(W,{cacheHitsSession:b.session,cacheHitsTotal:b.total,tokensSavedSession:b.sessionTokensSaved,tokensSavedTotal:b.totalTokensSaved,compactionsSession:R.session,compactionsTotal:R.total}),e.jsx(F,{compactSessionSec:j.compact.sessionSec,compactTotalSec:j.compact.totalSec,cacheHitSessionSec:j.cacheHit.sessionSec,cacheHitTotalSec:j.cacheHit.totalSec})]})})()]})}export{oe as default};
-//# sourceMappingURL=CacheTab-BLM6_PQQ.js.map