pi-mega-compact 0.20.57 → 0.20.59

package/extensions/dashboard-client/src/dash-consolidation/plan.ts

@@ -0,0 +1,200 @@
+/**
+ * dash-consolidation/plan.ts — DASH-0a typed merge plan for the dashboard.
+ *
+ * Contract-planning only: this module records, as concrete data structures, the
+ * collapse of the 13 current dashboard TabIds onto the fixed 7 navigational
+ * surfaces (Overview, Sessions, Cache+Performance, Memory Graph, Diagnostics,
+ * Setup, Admin). The shell (App.tsx), the lazy list, and every tab/section
+ * component are untouched by this sprint — DASH-0b/0c consume this plan to
+ * move components, DASH-0d wires deep links + a11y hooks against it.
+ *
+ * All constants are `readonly`; no `any`. Imports only the TabId union (never
+ * redefined locally) so the plan can never drift from the live registry.
+ */
+import type { TabId } from "../tabs/registry";
+
+/** The fixed 7 dashboard navigation surfaces. */
+export type DASHSurface =
+  | "overview"
+  | "sessions"
+  | "cache-perf"
+  | "memory-graph"
+  | "diagnostics"
+  | "setup"
+  | "admin";
+
+/** A source TabId the plan records as kept-but-not-a-surface (legacy section). */
+export interface LegacySection {
+  id: TabId | "topics" | "achievements" | "game";
+  disposition: "keep_but_listed_under";
+  keep_but_listed_under: DASHSurface;
+}
+
+/** One row of the per-surface merge plan. */
+export interface DashSurfacePlan {
+  surface: DASHSurface;
+  label: string;
+  /** Current top-level TabIds folded into this surface. */
+  sources: readonly TabId[];
+  /** Delegate component/card ids that land on this surface. */
+  mergedCardIds: readonly string[];
+  /** Setup-only: the existent SetupTab SUB_TABS member ids (under setup, NOT admin). */
+  setup_subtabs?: readonly string[];
+}
+
+/** The 7-surface merge plan keyed by surface id. */
+export const DASH_TAB_PLAN: readonly DashSurfacePlan[] = [
+  {
+    surface: "overview",
+    label: "Overview",
+    sources: ["overview"],
+    mergedCardIds: [],
+  },
+  {
+    surface: "sessions",
+    label: "Sessions",
+    sources: ["sessions", "turns"],
+    mergedCardIds: [],
+  },
+  {
+    surface: "cache-perf",
+    label: "Cache + Performance",
+    sources: ["cache", "metrics"],
+    mergedCardIds: [],
+  },
+  {
+    surface: "memory-graph",
+    label: "Memory Graph",
+    sources: ["memory-map", "repos", "wiki"],
+    mergedCardIds: [
+      "MemoryMapView",
+      "RaptorTreeView",
+      "WikiPage",
+      "WikiPageControls",
+      "TopicTimeline",
+      "TopicEvolutionView",
+      "TopicEvolutionGraph",
+    ],
+  },
+  {
+    surface: "diagnostics",
+    label: "Diagnostics",
+    sources: ["vector-cortex", "events", "health"],
+    mergedCardIds: [
+      "VectorCortexDiagnosticsCard",
+      "VectorCortexClosureCard",
+      "VectorCortexCrystalsCard",
+      "VectorCortexEconomicsCard",
+      "VectorCortexLedgerCard",
+      "VectorCortexOutcomesCard",
+      "VectorCortexPlansCard",
+      "VectorCortexPlatformCard",
+      "VectorCortexPolicyCard",
+      "VectorCortexRenderCard",
+      "VectorCortexRepairCard",
+      "VectorCortexRestoreCard",
+      "VectorCortexRolloutCard",
+      "VectorCortexShardsCard",
+      "VectorCortexTopologyCard",
+    ],
+  },
+  {
+    surface: "setup",
+    label: "Setup",
+    sources: ["setup"],
+    mergedCardIds: [
+      "SettingsPanel",
+      "SettingsSection",
+      "ThresholdsPanel",
+      "CortexSetup",
+      "EmbedderSetup",
+      "CortexActionsCard",
+      "CortexBlockersCard",
+      "CortexEncoderCard",
+      "CortexRuntimeCard",
+      "EmbedderHealthCard",
+      "RagHealthCard",
+      "CustomEndpointSection",
+      "VectorCortexCosineFpCard",
+      "VectorCortexRepoCorpusCard",
+    ],
+    // The existent SetupTab SUB_TABS member — recorded under Setup, NOT admin.
+    setup_subtabs: ["config"],
+  },
+  {
+    surface: "admin",
+    label: "Admin",
+    sources: ["maintenance"],
+    mergedCardIds: [
+      "ActionsCard",
+      "DbStatsCard",
+      "DebugBundleCard",
+      "HealthMitigationCard",
+      "SchemaHealthCard",
+    ],
+  },
+];
+
+/** Exactly 7 fixed surfaces. */
+export const DASH_TAB_COUNT = 7;
+
+/**
+ * Legacy sections rendered today that are kept-but-folded under a surface.
+ * One explicit bucket per non-surface tab/section so the audit stays total.
+ */
+export const DASH_LEGACY_SECTIONS: readonly LegacySection[] = [
+  { id: "topics", disposition: "keep_but_listed_under", keep_but_listed_under: "admin" },
+  { id: "achievements", disposition: "keep_but_listed_under", keep_but_listed_under: "admin" },
+  { id: "game", disposition: "keep_but_listed_under", keep_but_listed_under: "admin" },
+];
+
+/** Old route -> new { surface, sub-tab hint } map, one entry per current TabId.
+ *  Feeds the DASH-0d hash router; does not change App.tsx routing this sprint. */
+export const DEEP_LINK_TARGETS: Readonly<Record<TabId, { surface: DASHSurface; subTabHint: string }>> = {
+  overview: { surface: "overview", subTabHint: "overview" },
+  sessions: { surface: "sessions", subTabHint: "session-list" },
+  turns: { surface: "sessions", subTabHint: "turn-list" },
+  cache: { surface: "cache-perf", subTabHint: "cache-cards" },
+  metrics: { surface: "cache-perf", subTabHint: "perf-cards" },
+  "memory-map": { surface: "memory-graph", subTabHint: "memory-map" },
+  repos: { surface: "memory-graph", subTabHint: "repo-list" },
+  wiki: { surface: "memory-graph", subTabHint: "wiki" },
+  "vector-cortex": { surface: "diagnostics", subTabHint: "cortex" },
+  events: { surface: "diagnostics", subTabHint: "event-log" },
+  health: { surface: "diagnostics", subTabHint: "health" },
+  setup: { surface: "setup", subTabHint: "settings" },
+  maintenance: { surface: "admin", subTabHint: "maintenance" },
+};
+
+/** One a11y landmark row per fixed surface (DASH-0d axe-hook contract).
+ *  No ARIA markup is emitted this sprint — this constant IS the contract. */
+export interface NavMapRow {
+  surface: DASHSurface;
+  navLabel: string;
+  subNavLabel: string | null;
+}
+
+export const DASH_NAV_MAP: readonly NavMapRow[] = [
+  { surface: "overview", navLabel: "Overview", subNavLabel: null },
+  { surface: "sessions", navLabel: "Session windows", subNavLabel: "Session turns" },
+  { surface: "cache-perf", navLabel: "Performance cards", subNavLabel: "Cache status" },
+  { surface: "memory-graph", navLabel: "Memory graph", subNavLabel: "Wiki + repos" },
+  { surface: "diagnostics", navLabel: "Diagnostics groups", subNavLabel: "Event + health" },
+  { surface: "setup", navLabel: "Setup", subNavLabel: "Sub-tabs" },
+  { surface: "admin", navLabel: "Admin", subNavLabel: "Maintenance" },
+];
+
+/** Per-surface responsive plan: column strategy + sub-tab toggle collapse.
+ *  All grids stay `grid-cols-1 md:grid-cols-3`, matching existent card grids;
+ *  below `sm` sub-tab toggles collapse to a horizontal scroll region. */
+export interface ResponsivePlan {
+  surface: DASHSurface;
+  grid: "grid-cols-1 md:grid-cols-3";
+  subTabCollapseBelow: "sm";
+}
+
+export const DASH_RESPONSIVE: readonly ResponsivePlan[] = DASH_TAB_PLAN.map((p) => ({
+  surface: p.surface,
+  grid: "grid-cols-1 md:grid-cols-3",
+  subTabCollapseBelow: "sm",
+}));

package/extensions/dashboard-client/src/tabs/SessionsTab/TurnMemoryView.tsx

@@ -0,0 +1,383 @@
+/**
+ * dashboard-client/src/tabs/SessionsTab/TurnMemoryView.tsx — Turn-by-turn memory
+ * tracking + recall (S52), moved VERBATIM from the top-level TurnsTab.tsx.
+ *
+ * DASH-0b: the Sessions surface absorbs the existent TurnsTab as a drill-down.
+ * This file holds the byte-preserved turns body (the `TurnMemoryView`
+ * component). The standalone `tabs/TurnsTab.tsx` is LEFT UNTOUCHED this sprint —
+ * its copy stays live for flag-off / pre-DASH parity. A DASH-0d cleanup deletes
+ * the standalone copy after a deep-link audit proves no live consumer points
+ * at it. Only the export name changed (TurnsTab → TurnMemoryView); the render
+ * body is otherwise identical.
+ *
+ * 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).
+ */
+
+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";
+}
+
+export function TurnMemoryView(): 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>
+	);
+}