@luziyang2026/dsh-question-nav 0.3.0 → 0.4.0

package/lib/client.js

@@ -7,64 +7,70 @@ window.__ModuleLoader__.load({
 		let react = require("react");
 		let react_dom = require("react-dom");
 		let react_jsx_runtime = require("react/jsx-runtime");
-		//#region src/core/nodes.ts
-		/** Kinds counted as a user question (turn-opening and steering admissions). */
-		const QUESTION_KINDS = ["user", "steering"];
-		function userData(data) {
-			if (typeof data !== "object" || data === null) return void 0;
-			return data;
-		}
-		/** First text block of a user message; falls back to the raw first block. */
-		function messageText(content) {
-			if (content === void 0 || content.length === 0) return "";
-			const first = content[0];
-			if (typeof first?.text === "string") return first.text;
-			return "";
+		//#region src/core/turn-dots.ts
+		/** The conversation Definition kind whose key a user question node uses. */
+		const MESSAGE_DEFINITION_KIND = "input-message";
+		/**
+		* The engine-owned stable chat key for a user question — mirrors
+		* `conversationContextKey('input-message', String(id))` from the DSH runtime
+		* (verified against that formula in the unit test).
+		*/
+		function questionKey(id) {
+			return `13:${MESSAGE_DEFINITION_KIND}${String(id)}`;
 		}
-		/** Extract the user questions from a chat-node window, ordered by anchorSeq. */
-		function extractQuestions(nodes) {
-			const out = [];
-			for (const node of nodes) {
-				if (!QUESTION_KINDS.includes(node.kind)) continue;
-				const payload = userData(node.data);
-				out.push({
-					key: node.key,
-					anchorSeq: node.anchorSeq,
-					seq: payload?.seq ?? -1,
-					time: payload?.time ?? 0,
-					text: messageText(payload?.content)
+		/**
+		* Fold the projection's question list into one dot per turn. Entries arrive
+		* in event order; consecutive same-turn entries merge into a single dot whose
+		* anchor is the turn's first question.
+		*/
+		function groupQuestionsByTurn(entries) {
+			const sorted = [...entries].sort((a, b) => a.seq - b.seq);
+			const dots = [];
+			for (const entry of sorted) {
+				const key = questionKey(entry.id);
+				const last = dots.at(-1);
+				if (last !== void 0 && last.turn === entry.turn) {
+					dots[dots.length - 1] = {
+						...last,
+						texts: [...last.texts, entry.text],
+						memberKeys: [...last.memberKeys, key]
+					};
+					continue;
+				}
+				dots.push({
+					turn: entry.turn,
+					key,
+					anchorSeq: entry.seq,
+					time: entry.time,
+					texts: [entry.text],
+					memberKeys: [key]
 				});
 			}
-			out.sort((a, b) => a.anchorSeq - b.anchorSeq);
-			return out;
-		}
-		/** Nearest renderable row for a key that is absent or hidden (compaction, windowing). */
-		function nearestRenderable(nodes, excludeKey) {
-			let best = null;
-			for (const node of nodes) {
-				if (node.visibility === "hidden") continue;
-				if (node.key === excludeKey) continue;
-				if (best === null || node.anchorSeq < best.anchorSeq) best = {
-					key: node.key,
-					anchorSeq: node.anchorSeq
-				};
-			}
-			return best;
+			return dots;
 		}
 		/**
-		* Merge two question sets (full-history index + live loaded window) into one
-		* deduplicated, anchorSeq-ascending list. The window may hold questions that
-		* arrived after the index was built; the index may hold questions the window
-		* has not loaded yet — union on `key`, newest live copy wins per key.
+		* Merge live-window questions the projection has not recorded yet (the brief
+		* window before the session/projection push frame lands). A live question
+		* whose key is already folded into a dot is dropped (the projected copy
+		* wins); the rest become single-question dots with `turn: null`, inserted in
+		* anchor-seq order so the strip stays strictly chronological.
 		*/
-		function mergeQuestions(...sources) {
-			const byKey = /* @__PURE__ */ new Map();
-			for (const source of sources) for (const node of source) byKey.set(node.key, node);
-			return [...byKey.values()].sort((a, b) => a.anchorSeq - b.anchorSeq);
+		function mergeLiveQuestions(dots, live) {
+			const known = new Set(dots.flatMap((dot) => dot.memberKeys));
+			const extras = live.filter((question) => !known.has(question.key)).map((question) => ({
+				turn: null,
+				key: question.key,
+				anchorSeq: question.anchorSeq,
+				time: question.time,
+				texts: [question.text],
+				memberKeys: [question.key]
+			}));
+			if (extras.length === 0) return [...dots];
+			return [...dots, ...extras].sort((a, b) => a.anchorSeq - b.anchorSeq);
 		}
 		//#endregion
 		//#region \0dsh-css:dsh-question-nav/src/client/question-nav.module.css.mjs
-		const css = ".TWf_pa_rail{z-index:1;box-sizing:border-box;pointer-events:none;background:0 0;flex-direction:column;align-items:center;width:44px;display:flex;position:absolute;top:0;bottom:0;left:0}.TWf_pa_list{scrollbar-width:thin;flex-direction:column;flex:1;align-items:center;gap:6px;width:100%;min-height:0;padding:8px 0;display:flex;overflow:hidden auto}.TWf_pa_list>:first-child{margin-top:auto}.TWf_pa_list>:last-child{margin-bottom:auto}.TWf_pa_dot{pointer-events:auto;background:var(--dsw-alias-border-l3);cursor:pointer;border:none;border-radius:50%;flex:none;width:8px;height:8px;padding:0;transition:transform .12s,background .12s}.TWf_pa_dot:hover{background:var(--dsw-alias-brand-primary);transform:scale(2)}.TWf_pa_dot.TWf_pa_active{background:var(--dsw-alias-brand-primary);transform:scale(1.6)}.TWf_pa_moreDot{border:1px dashed var(--dsw-alias-border-l3);background:0 0}.TWf_pa_moreDot:hover{background:var(--dsw-alias-brand-primary);border-color:var(--dsw-alias-brand-primary)}.TWf_pa_count{color:var(--dsw-alias-label-tertiary);user-select:none;flex:none;font-size:10px;font-weight:600;line-height:1}.TWf_pa_countLoading{color:var(--dsw-alias-brand-primary);margin-left:2px;font-weight:400;animation:1.2s ease-in-out infinite TWf_pa_qnPulse}@keyframes TWf_pa_qnPulse{0%,to{opacity:.4}50%{opacity:1}}.TWf_pa_dots{flex-direction:column;align-items:center;gap:6px;display:flex}.TWf_pa_empty{color:var(--dsw-alias-label-tertiary);text-align:center;word-break:break-word;padding:10px 4px;font-size:11px}.TWf_pa_tooltip{z-index:20;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);max-width:420px;color:var(--dsw-alias-label-primary);white-space:normal;word-break:break-word;pointer-events:none;border-radius:8px;padding:8px 12px;font-size:13px;line-height:18px;position:fixed;box-shadow:0 4px 16px #0003}";
+		const css = ".TWf_pa_rail{z-index:1;box-sizing:border-box;pointer-events:none;background:0 0;flex-direction:column;align-items:center;width:44px;display:flex;position:absolute;top:0;bottom:0;left:0}.TWf_pa_list{scrollbar-width:thin;flex-direction:column;flex:1;align-items:center;gap:6px;width:100%;min-height:0;padding:8px 0;display:flex;overflow:hidden auto}.TWf_pa_list>:first-child{margin-top:auto}.TWf_pa_list>:last-child{margin-bottom:auto}.TWf_pa_dot{pointer-events:auto;background:var(--dsw-alias-border-l3);cursor:pointer;border:none;border-radius:50%;flex:none;width:8px;height:8px;padding:0;transition:transform .12s,background .12s}.TWf_pa_dot:hover{background:var(--dsw-alias-brand-primary);transform:scale(2)}.TWf_pa_dot.TWf_pa_active{background:var(--dsw-alias-brand-primary);transform:scale(1.6)}.TWf_pa_count{color:var(--dsw-alias-label-tertiary);user-select:none;flex:none;font-size:10px;font-weight:600;line-height:1}.TWf_pa_dots{flex-direction:column;align-items:center;gap:6px;display:flex}.TWf_pa_empty{color:var(--dsw-alias-label-tertiary);text-align:center;word-break:break-word;padding:10px 4px;font-size:11px}.TWf_pa_tooltip{z-index:20;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);max-width:420px;color:var(--dsw-alias-label-primary);white-space:normal;word-break:break-word;pointer-events:none;border-radius:8px;padding:8px 12px;font-size:13px;line-height:18px;position:fixed;box-shadow:0 4px 16px #0003}.TWf_pa_tooltipTitle{color:var(--dsw-alias-label-tertiary);margin-bottom:4px;font-size:11px;font-weight:600}.TWf_pa_tooltipLine+.TWf_pa_tooltipLine{border-top:1px solid var(--dsw-alias-border-l1);margin-top:6px;padding-top:6px}";
 		const tagId = "@luziyang2026/dsh-question-nav/question-nav.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");
@@ -76,39 +82,37 @@ window.__ModuleLoader__.load({
 		var question_nav_module_css_default = {
 			"active": "TWf_pa_active",
 			"count": "TWf_pa_count",
-			"countLoading": "TWf_pa_countLoading",
 			"dot": "TWf_pa_dot",
 			"dots": "TWf_pa_dots",
 			"empty": "TWf_pa_empty",
 			"list": "TWf_pa_list",
-			"moreDot": "TWf_pa_moreDot",
-			"qnPulse": "TWf_pa_qnPulse",
 			"rail": "TWf_pa_rail",
-			"tooltip": "TWf_pa_tooltip"
+			"tooltip": "TWf_pa_tooltip",
+			"tooltipLine": "TWf_pa_tooltipLine",
+			"tooltipTitle": "TWf_pa_tooltipTitle"
 		};
 		//#endregion
 		//#region src/client/QuestionNavStrip.tsx
 		/**
 		* Question-nav minimap. Renders a vertical column of small round dots overlaid
 		* on the LEFT edge of the conversation column (via the frame-wide
-		* `shell.overlay` floating layer), vertically centered: one dot per user
-		* question, enlarge on hover. The instant tooltip (a portal-rendered overlay,
-		* no native-title delay) shows the question's full text; clicking a dot scrolls
-		* the chat to that question.
+		* `shell.overlay` floating layer), vertically centered: one dot per turn that
+		* claimed at least one user question — strictly aligned with the Trajectory
+		* view's turn numbering (turns without a question produce no dot). Hover
+		* enlarges a dot and shows an instant tooltip (portal-rendered, no native
+		* delay) with the turn label and the turn's question text(s); clicking jumps
+		* the chat to that turn's first question.
 		*
-		* Index strategy (no render-window expansion): the dots cover the WHOLE
-		* session history. The index is built from the raw `session.history` RPC via
-		* the injected `fetchQuestionIndex` — the conversation's paged window is
-		* untouched, so DSH's memory economy is preserved. The loaded window's live
-		* questions are merged on top (for new messages arriving after the index was
-		* built). Clicking a dot jumps through the existing paging loop, which calls
-		* `loadOlder()` only until that specific page is in the window. If the index
-		* safety budget is exhausted, a dimmed dashed "load earlier" dot appears above
-		* the oldest question and continues the index on click.
+		* Data source: the host-folded `questionIndex` session projection (whole
+		* history, persisted host-side, pushed live through session/projection
+		* frames) read through the injected `questionProjection` face, plus the live
+		* chat window's questions merged on top for the brief window before a
+		* just-sent question lands in the projection. No render-window expansion, no
+		* client-side history paging.
 		*
-		* Data arrives through the four props shares: the framework `useSessions`
-		* hook (current session), the registrant inject face (read/subscribe/jump/
-		* fetch-index), and the bound locale translator.
+		* Data arrives through the props shares: the framework `useSessions` hook
+		* (current session), the registrant inject face (read/subscribe/project/
+		* jump), and the bound locale translator.
 		*/
 		const FAILURE_HINTS = {
 			VIEW_INACTIVE: "jump.inactive",
@@ -116,6 +120,12 @@ window.__ModuleLoader__.load({
 			NOT_FOUND: "jump.notfound",
 			TIMEOUT: "jump.timeout"
 		};
+		/** Read the projection face value as a question-entry list (structural guard). */
+		function projectionEntries(face) {
+			const value = face?.getSnapshot();
+			if (!Array.isArray(value)) return [];
+			return value.filter((item) => typeof item === "object" && item !== null && typeof item.id === "string" && typeof item.seq === "number" && typeof item.turn === "number");
+		}
 		function findConvRoot() {
 			return document.querySelector("[data-slot=\"conversation\"] > div[data-phase]");
 		}
@@ -123,22 +133,12 @@ window.__ModuleLoader__.load({
 			const current = props.useSessions((s) => s.current);
 			const summary = props.useSessions((s) => s.current === void 0 ? void 0 : s.byId[s.current]);
 			const visible = current !== void 0 && summary !== void 0 && summary.blank !== true;
-			const [questions, setQuestions] = (0, react.useState)([]);
+			const [dots, setDots] = (0, react.useState)([]);
 			const [jumpingKey, setJumpingKey] = (0, react.useState)(null);
 			const [hint, setHint] = (0, react.useState)(null);
 			const [tooltip, setTooltip] = (0, react.useState)(null);
-			const [loadingIndex, setLoadingIndex] = (0, react.useState)(false);
-			const [moreAvailable, setMoreAvailable] = (0, react.useState)(false);
 			const panelRef = (0, react.useRef)(null);
 			const hintTimerRef = (0, react.useRef)(null);
-			/** Full-history index from the raw RPC (per current session). */
-			const indexRef = (0, react.useRef)([]);
-			/** Next beforeSeq to resume from when the index budget was exhausted. */
-			const nextBeforeSeqRef = (0, react.useRef)(void 0);
-			/** Abort controller for the in-flight index build. */
-			const indexAbortRef = (0, react.useRef)(null);
-			/** Session whose index build is in flight, to avoid duplicate loops. */
-			const buildingSessionRef = (0, react.useRef)(null);
 			const showHint = (message) => {
 				setHint(message);
 				if (hintTimerRef.current !== null) window.clearTimeout(hintTimerRef.current);
@@ -146,53 +146,21 @@ window.__ModuleLoader__.load({
 			};
 			(0, react.useEffect)(() => {
 				if (!visible || current === void 0) {
-					indexRef.current = [];
-					nextBeforeSeqRef.current = void 0;
-					indexAbortRef.current?.abort();
-					indexAbortRef.current = null;
-					buildingSessionRef.current = null;
-					setQuestions([]);
-					setLoadingIndex(false);
-					setMoreAvailable(false);
+					setDots([]);
 					return;
 				}
 				const sessionId = current;
-				indexRef.current = [];
-				nextBeforeSeqRef.current = void 0;
+				const face = props.questionProjection(sessionId);
 				const refresh = () => {
-					const windowQuestions = props.readQuestions(sessionId);
-					setQuestions(mergeQuestions(indexRef.current, windowQuestions));
-				};
-				const startBuild = (options) => {
-					buildingSessionRef.current = sessionId;
-					const controller = new AbortController();
-					indexAbortRef.current = controller;
-					setLoadingIndex(true);
-					setMoreAvailable(false);
-					props.fetchQuestionIndex(sessionId, {
-						...options,
-						signal: controller.signal
-					}).then((result) => {
-						if (buildingSessionRef.current !== sessionId) return;
-						indexRef.current = mergeQuestions(result.questions, indexRef.current);
-						nextBeforeSeqRef.current = result.nextBeforeSeq;
-						setMoreAvailable(result.code === "BUDGET" && result.nextBeforeSeq !== void 0);
-						refresh();
-					}).finally(() => {
-						if (buildingSessionRef.current === sessionId) {
-							setLoadingIndex(false);
-							if (indexAbortRef.current === controller) indexAbortRef.current = null;
-							buildingSessionRef.current = null;
-						}
-					});
+					const grouped = groupQuestionsByTurn(projectionEntries(face));
+					setDots(mergeLiveQuestions(grouped, props.readQuestions(sessionId)));
 				};
 				refresh();
-				startBuild();
+				const unsubProjection = face?.subscribe(refresh) ?? (() => {});
 				const unsubContent = props.subscribeContent(sessionId, refresh);
 				const unsubList = props.subscribeList(refresh);
 				return () => {
-					indexAbortRef.current?.abort();
-					indexAbortRef.current = null;
+					unsubProjection();
 					unsubContent();
 					unsubList();
 				};
@@ -249,23 +217,20 @@ window.__ModuleLoader__.load({
 				if (hintTimerRef.current !== null) window.clearTimeout(hintTimerRef.current);
 			}, []);
 			if (!visible) return null;
-			const onJump = (node) => {
+			const onJump = (dot) => {
 				if (current === void 0) return;
-				setJumpingKey(node.key);
-				props.jump(current, node.key);
-				window.setTimeout(() => setJumpingKey((k) => k === node.key ? null : k), 600);
+				setJumpingKey(dot.key);
+				props.jump(current, dot.key);
+				window.setTimeout(() => setJumpingKey((k) => k === dot.key ? null : k), 600);
 			};
-			const onLoadMore = () => {
-				if (current === void 0 || nextBeforeSeqRef.current === void 0) return;
-				setMoreAvailable(false);
-				setLoadingIndex(true);
-				props.fetchQuestionIndex(current, { startBeforeSeq: nextBeforeSeqRef.current }).then((result) => {
-					if (current === void 0) return;
-					indexRef.current = mergeQuestions(result.questions, indexRef.current);
-					nextBeforeSeqRef.current = result.nextBeforeSeq;
-					setMoreAvailable(result.code === "BUDGET" && result.nextBeforeSeq !== void 0);
-					setQuestions(mergeQuestions(indexRef.current, props.readQuestions(current)));
-				}).finally(() => setLoadingIndex(false));
+			const openTooltip = (dot, target) => {
+				const r = target.getBoundingClientRect();
+				setTooltip({
+					title: dot.turn === null ? null : `Turn ${dot.turn}`,
+					lines: dot.texts,
+					left: r.right + 10,
+					top: r.top
+				});
 			};
 			const t = props.t;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -280,58 +245,36 @@ window.__ModuleLoader__.load({
 					}) : null,
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 						className: question_nav_module_css_default.list,
-						children: questions.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						children: dots.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 							className: question_nav_module_css_default.empty,
-							children: loadingIndex ? t("strip.loadingAll") : t("strip.empty")
+							children: t("strip.empty")
 						}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 							className: question_nav_module_css_default.dots,
-							children: [
-								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
-									className: question_nav_module_css_default.count,
-									children: [questions.length, loadingIndex ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-										className: question_nav_module_css_default.countLoading,
-										children: t("strip.loadingSuffix")
-									}) : null]
-								}),
-								moreAvailable && !loadingIndex ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-									className: `${question_nav_module_css_default.dot} ${question_nav_module_css_default.moreDot}`,
-									"aria-label": t("strip.loadEarlier"),
-									title: t("strip.loadEarlier"),
-									onMouseEnter: (e) => {
-										const r = e.currentTarget.getBoundingClientRect();
-										setTooltip({
-											text: t("strip.loadEarlier"),
-											left: r.right + 10,
-											top: r.top
-										});
-									},
-									onMouseLeave: () => setTooltip(null),
-									onClick: onLoadMore
-								}) : null,
-								questions.map((node) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-									className: jumpingKey === node.key ? `${question_nav_module_css_default.dot} ${question_nav_module_css_default.active}` : question_nav_module_css_default.dot,
-									"aria-label": node.text,
-									onMouseEnter: (e) => {
-										const r = e.currentTarget.getBoundingClientRect();
-										setTooltip({
-											text: node.text,
-											left: r.right + 10,
-											top: r.top
-										});
-									},
-									onMouseLeave: () => setTooltip(null),
-									onClick: () => onJump(node)
-								}, node.key))
-							]
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: question_nav_module_css_default.count,
+								children: dots.length
+							}), dots.map((dot) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								className: jumpingKey === dot.key ? `${question_nav_module_css_default.dot} ${question_nav_module_css_default.active}` : question_nav_module_css_default.dot,
+								"aria-label": dot.texts[0] ?? "",
+								onMouseEnter: (e) => openTooltip(dot, e.currentTarget),
+								onMouseLeave: () => setTooltip(null),
+								onClick: () => onJump(dot)
+							}, dot.key))]
 						})
 					}),
-					tooltip !== null ? (0, react_dom.createPortal)(/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					tooltip !== null ? (0, react_dom.createPortal)(/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: question_nav_module_css_default.tooltip,
 						style: {
 							left: tooltip.left,
 							top: tooltip.top
 						},
-						children: tooltip.text
+						children: [tooltip.title !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: question_nav_module_css_default.tooltipTitle,
+							children: tooltip.title
+						}) : null, tooltip.lines.map((line, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: question_nav_module_css_default.tooltipLine,
+							children: line
+						}, index))]
 					}), document.body) : null
 				]
 			});
@@ -344,9 +287,6 @@ window.__ModuleLoader__.load({
 		*/
 		const zh = {
 			"strip.empty": "本会话还没有提问",
-			"strip.loadingAll": "正在加载全部历史…",
-			"strip.loadingSuffix": "…",
-			"strip.loadEarlier": "加载更早的问题",
 			"jump.inactive": "聊天视图未激活",
 			"jump.hidden": "目标无独立气泡，已定位到邻近内容",
 			"jump.notfound": "目标未加载或不存在（可能已压缩）",
@@ -354,15 +294,57 @@ window.__ModuleLoader__.load({
 		};
 		const en = {
 			"strip.empty": "No questions in this session yet",
-			"strip.loadingAll": "Loading full history…",
-			"strip.loadingSuffix": "…",
-			"strip.loadEarlier": "Load earlier questions",
 			"jump.inactive": "Chat view is not active",
 			"jump.hidden": "No dedicated bubble; landed on nearby content",
 			"jump.notfound": "Target not loaded or missing (maybe compacted)",
 			"jump.timeout": "Timed out loading history; retry"
 		};
 		//#endregion
+		//#region src/core/nodes.ts
+		/** Kinds counted as a user question (turn-opening and steering admissions). */
+		const QUESTION_KINDS = ["user", "steering"];
+		function userData(data) {
+			if (typeof data !== "object" || data === null) return void 0;
+			return data;
+		}
+		/** First text block of a user message; falls back to the raw first block. */
+		function messageText(content) {
+			if (content === void 0 || content.length === 0) return "";
+			const first = content[0];
+			if (typeof first?.text === "string") return first.text;
+			return "";
+		}
+		/** Extract the user questions from a chat-node window, ordered by anchorSeq. */
+		function extractQuestions(nodes) {
+			const out = [];
+			for (const node of nodes) {
+				if (!QUESTION_KINDS.includes(node.kind)) continue;
+				const payload = userData(node.data);
+				out.push({
+					key: node.key,
+					anchorSeq: node.anchorSeq,
+					seq: payload?.seq ?? -1,
+					time: payload?.time ?? 0,
+					text: messageText(payload?.content)
+				});
+			}
+			out.sort((a, b) => a.anchorSeq - b.anchorSeq);
+			return out;
+		}
+		/** Nearest renderable row for a key that is absent or hidden (compaction, windowing). */
+		function nearestRenderable(nodes, excludeKey) {
+			let best = null;
+			for (const node of nodes) {
+				if (node.visibility === "hidden") continue;
+				if (node.key === excludeKey) continue;
+				if (best === null || node.anchorSeq < best.anchorSeq) best = {
+					key: node.key,
+					anchorSeq: node.anchorSeq
+				};
+			}
+			return best;
+		}
+		//#endregion
 		//#region src/core/jump.ts
 		/**
 		* Jump-to-question orchestration. Pure-ish: takes injected ports (snapshot
@@ -370,7 +352,7 @@ window.__ModuleLoader__.load({
 		* paging/timeout/fallback loop is unit-testable without a real browser or
 		* session. The browser half wires these ports to ctx.sessions + the DOM.
 		*/
-		const DEFAULTS$1 = {
+		const DEFAULTS = {
 			totalTimeoutMs: 15e3,
 			maxPages: 100,
 			rowWaitMs: 8e3,
@@ -399,7 +381,7 @@ window.__ModuleLoader__.load({
 		*/
 		async function jumpToQuestion(ports, key, options = {}) {
 			const cfg = {
-				...DEFAULTS$1,
+				...DEFAULTS,
 				...options
 			};
 			const fail = (code, fallback = false) => {
@@ -465,133 +447,6 @@ window.__ModuleLoader__.load({
 			return fail("TARGET_HIDDEN", false);
 		}
 		//#endregion
-		//#region src/core/history-index.ts
-		/** The conversation Definition kind whose key a user question node uses. */
-		const MESSAGE_DEFINITION_KIND = "input-message";
-		/**
-		* The engine-owned stable chat key for a user question event — mirrors
-		* `conversationContextKey('input-message', String(id))` from the DSH runtime
-		* (verified against it in the unit test).
-		*/
-		function questionKey(id) {
-			return `13:${MESSAGE_DEFINITION_KIND}${String(id)}`;
-		}
-		/**
-		* Whether a raw event is one user question the strip should index.
-		* Mirrors the DSH `messageDefinition` match + `start` classification:
-		* an append-origin `user/message` with a human (`user`) source. Replacement
-		* copies (compaction checkpoints, `source.kind === 'plugin'`) and injected
-		* context (`source.kind !== 'user'`) are excluded.
-		*/
-		function isQuestionEvent(event) {
-			if (event.type !== "user/message") return false;
-			if (event.surfaceOp !== "append") return false;
-			return event.data?.source?.kind === "user";
-		}
-		/** Map one raw question event to a strip question node, or null when not one. */
-		function questionFromEvent(event) {
-			if (!isQuestionEvent(event)) return null;
-			return {
-				key: questionKey(event.data?.id),
-				anchorSeq: event.seq,
-				seq: event.seq,
-				time: event.time,
-				text: messageText(event.data?.content)
-			};
-		}
-		const DEFAULTS = {
-			maxMessages: 100,
-			maxPages: 200,
-			totalTimeoutMs: 3e4
-		};
-		function minSeq(events) {
-			let min;
-			for (const { event } of events) if (min === void 0 || event.seq < min) min = event.seq;
-			return min;
-		}
-		/**
-		* Page the raw session history backward, collecting every user question into a
-		* lightweight index. Never touches the render window.
-		*/
-		async function buildQuestionIndex(ports, options = {}) {
-			const cfg = {
-				...DEFAULTS,
-				...options
-			};
-			const deadline = ports.now() + cfg.totalTimeoutMs;
-			const questions = [];
-			let beforeSeq = cfg.startBeforeSeq;
-			let pages = 0;
-			const cancelled = () => cfg.signal?.aborted === true;
-			while (true) {
-				if (cancelled()) return {
-					ok: false,
-					code: "CANCELLED",
-					questions,
-					pages,
-					nextBeforeSeq: beforeSeq
-				};
-				if (ports.now() > deadline) return {
-					ok: false,
-					code: "TIMEOUT",
-					questions,
-					pages,
-					nextBeforeSeq: beforeSeq
-				};
-				if (pages >= cfg.maxPages) return {
-					ok: false,
-					code: "BUDGET",
-					questions,
-					pages,
-					nextBeforeSeq: beforeSeq
-				};
-				const page = await ports.history(beforeSeq, cfg.maxMessages);
-				if (page === void 0) {
-					if (pages === 0) return {
-						ok: false,
-						code: "UNAVAILABLE",
-						questions,
-						pages,
-						nextBeforeSeq: beforeSeq
-					};
-					return {
-						ok: true,
-						code: "COMPLETE",
-						questions,
-						pages,
-						nextBeforeSeq: void 0
-					};
-				}
-				for (const { event } of page.events) {
-					const question = questionFromEvent(event);
-					if (question !== null) questions.push(question);
-				}
-				if (!page.hasMore) {
-					questions.sort((a, b) => a.anchorSeq - b.anchorSeq);
-					return {
-						ok: true,
-						code: "COMPLETE",
-						questions,
-						pages,
-						nextBeforeSeq: void 0
-					};
-				}
-				const next = minSeq(page.events);
-				if (next === void 0) {
-					questions.sort((a, b) => a.anchorSeq - b.anchorSeq);
-					return {
-						ok: true,
-						code: "COMPLETE",
-						questions,
-						pages,
-						nextBeforeSeq: void 0
-					};
-				}
-				beforeSeq = next;
-				pages += 1;
-			}
-		}
-		//#endregion
 		//#region src/client/index.ts
 		/** Locale namespace this plugin owns. */
 		const NS = "question-nav";
@@ -599,8 +454,7 @@ window.__ModuleLoader__.load({
 		const inject = [
 			"slots",
 			"locale",
-			"sessions",
-			"connection"
+			"sessions"
 		];
 		function claimApply() {
 			if (globalThis.__dshQuestionNavApplied === true) return false;
@@ -638,37 +492,19 @@ window.__ModuleLoader__.load({
 				sleep: (ms) => new Promise((resolve) => window.setTimeout(resolve, ms))
 			};
 		}
-		/** Resolve the connection handle (shared API client) as other DSH plugins do. */
-		function connectionOf(ctx) {
-			return ctx.get("connection");
-		}
 		/**
-		* One raw history page, mapped to the pure `buildQuestionIndex` port shape.
-		* `beforeSeq` is exclusive; `undefined` reads the newest page. Returns
-		* undefined when the page is unavailable so the builder stops cleanly. The
-		* SDK's `SessionEvent` is cast to the structural `RawEventLike` at this
-		* boundary (the index reader only touches type/seq/time/surfaceOp/data).
+		* The session's `questionIndex` projection face (getSnapshot + subscribe).
+		* Undefined when the session is not bound or the host unit is not registered
+		* (e.g. a headless composition) — the strip then shows live-window dots only.
 		*/
-		async function rawHistoryPage(ctx, sessionId, beforeSeq, maxMessages) {
-			const { api } = connectionOf(ctx);
-			const { result } = await api.sessions.history({
-				sessionId,
-				beforeSeq,
-				maxMessages
-			});
-			if (!result.ok) return void 0;
+		function questionProjectionOf(ctx, sessionId) {
+			const face = ctx.sessions.binding(sessionId)?.session.projections.faceOf("questionIndex");
+			if (face === void 0) return void 0;
 			return {
-				events: result.value.events.map((entry) => ({ event: entry.event })),
-				hasMore: result.value.hasMore
+				getSnapshot: () => face.getSnapshot(),
+				subscribe: (listener) => face.subscribe(listener)
 			};
 		}
-		/** Build the full-session question index from the raw history RPC (no render). */
-		function buildIndexFor(ctx, sessionId, options = {}) {
-			return buildQuestionIndex({
-				history: (beforeSeq, maxMessages) => rawHistoryPage(ctx, sessionId, beforeSeq, maxMessages),
-				now: () => Date.now()
-			}, options);
-		}
 		function createInject(ctx) {
 			return {
 				readQuestions: (sessionId) => {
@@ -682,14 +518,14 @@ window.__ModuleLoader__.load({
 					if (binding === void 0) return () => {};
 					return binding.session.subscribe(cb);
 				},
+				questionProjection: (sessionId) => questionProjectionOf(ctx, sessionId),
 				jump: (sessionId, key) => {
 					const ports = jumpPortsFor(ctx, sessionId);
 					ports.report = (code) => {
 						window.dispatchEvent(new CustomEvent("question-nav:jump-failed", { detail: code }));
 					};
 					jumpToQuestion(ports, key);
-				},
-				fetchQuestionIndex: (sessionId, options) => buildIndexFor(ctx, sessionId, options)
+				}
 			};
 		}
 		/**