feat(cache-warming,surfaces,metrics,markdown): conversation-scoped surfaces, cache warming + retention, markdown

Consumes the backend cache-warming + cache-rate handoffs end-to-end and adds supporting infra:

- protocol/transport: conversation-scoped surfaces (conversationId on subscribe/invoke/surface + staleness routing); store auto-subscribes the catalog with the focused conversation and re-scopes on switch.
- surface-host: generic Number field renderer + custom rendererId dispatch (graceful skip on unknown).
- cache-warming feature: enabled toggle, min+sec interval, AUTHORITATIVE countdown from the surface's cache-warming-timer nextWarmAt, manual Warm now (POST /chat/warm), lastWarmAt-keyed history, cache-retention stat, expectedCacheRate headline.
- metrics: cross-turn expected-cache (retention) derivation + bubble badge; cache-rate fix needs no code change (inputTokens now total).
- markdown feature: marked + marked-highlight + highlight.js + dompurify, rendered in ChatView.
- fixes (gemini review): {#key activeConversationId} remount of CacheWarmingView to stop history/feedback leaking across tabs; guard NaN interval inputs from committing 0.
- docs/contracts: regenerated transport/ui-contract mirrors; backend-handoff updated (CR-3 resolved).

Verified: svelte-check 0 errors, biome clean, 494 tests pass, vite build OK.

1 files changed, 11 insertions, 2 deletions

diff --git a/src/core/metrics/place.ts b/src/core/metrics/place.ts
index fc30df0..afeb84b 100644
--- a/src/core/metrics/place.ts
+++ b/src/core/metrics/place.ts
@@ -79,11 +79,19 @@ export function interleaveTurnMetrics(
 	}
 
 	// Running cumulative usage across finalized turns (conversation total at each
-	// entry index), for the per-turn "chat total" cache rate.
+	// entry index), for the per-turn "chat total" cache rate. Alongside it, the
+	// previous finalized turn's usage at each index — the baseline for cross-turn
+	// retention (expected cache).
 	const cumulativeByEntry: Usage[] = [];
+	const prevUsageByEntry: (Usage | null)[] = [];
 	let runningUsage: Usage = { inputTokens: 0, outputTokens: 0 };
+	let lastFinalizedUsage: Usage | null = null;
 	for (const e of entries) {
-		if (e.total !== null) runningUsage = addUsage(runningUsage, e.total.usage);
+		prevUsageByEntry.push(lastFinalizedUsage);
+		if (e.total !== null) {
+			runningUsage = addUsage(runningUsage, e.total.usage);
+			lastFinalizedUsage = e.total.usage;
+		}
 		cumulativeByEntry.push(runningUsage);
 	}
 
@@ -170,6 +178,7 @@ export function interleaveTurnMetrics(
 				kind: "turn-metrics",
 				turn: entry.total,
 				cumulativeUsage: cumulativeByEntry[seg] ?? entry.total.usage,
+				prevTurnUsage: prevUsageByEntry[seg] ?? null,
 			});
 		}
 	}