@luziyang2026/dsh-question-nav 0.2.0 → 0.4.0

package/README.md

@@ -17,15 +17,18 @@ Package: **`@luziyang2026/dsh-question-nav`** ([npm][npm]).
 - **Left-edge dot minimap** (embedded, not reserving any width).
 - **Vertically centered** in the conversation column.
 - **One dot = one user question**, with a small count above the dot column.
-- **Full history**: on show, the strip auto-expands the session's older pages
-  (paging DSH's own "load older" window) so even questions that are still
-  collapsed behind the load-more button surface as dots. While expanding, the
-  count shows a "…" affordance; if the safety budget is exhausted a dimmed
-  dashed dot above the oldest question offers "load earlier" on click.
+- **Full history, no render-window expansion**: the index is built by paging
+  the raw `session.history` RPC (read-only), so every question in the session —
+  including ones still collapsed behind DSH's "load older" button — appears as
+  a dot without expanding the conversation's paged window (memory economy
+  preserved). While the index is building the count shows a "…"; if the safety
+  budget is exhausted a dimmed dashed dot above the oldest question offers
+  "load earlier" on click.
 - **Hover**: the dot enlarges and an instant tooltip (portal-rendered, no
   native-title delay) shows the question's **full text**.
-- **Click**: jumps to that question, paging older history when the target is
-  not yet in the loaded window (with a nearest-row fallback).
+- **Click**: jumps to that question. Only then does the jump loop page the
+  window (`loadOlder()`) to bring that specific page into view — never the
+  whole history up front.
 - Empty/left areas of the rail pass pointer events through to the conversation
   (it never blocks the chat).
 

package/README.zh.md

@@ -14,11 +14,14 @@
 - **左缘圆点迷你地图**：内嵌，**不占任何宽度**。
 - **垂直居中**在对话栏中。
 - **一个圆点 = 一个用户提问**，圆点列上方有提问数量。
-- **完整历史**：显示时自动向后翻页展开整个会话历史，连"加载更早"按钮后面
-  折叠隐藏的老提问也会变成圆点。展开过程中数量后显示 "…"；若超过安全预算，
-  最老提问上方会出现一个虚线圆点，点击可继续加载更早提问。
+- **完整历史、不展开渲染窗口**：索引通过分页读取原始 `session.history`
+  RPC（只读）构建，所以会话里的每一个提问——包括仍被 DSH"加载更早"按钮
+  折叠隐藏的老提问——都会变成圆点，**不会**展开对话的分页窗口（保留 DSH
+  的内存经济性）。构建索引期间数量后显示 "…"；若超过安全预算，最老提问
+  上方会出现一个虚线圆点，点击继续加载。
 - **悬停**：圆点放大 + 即时提示框（portal 渲染，无原生 `title` 延迟）显示**全文**。
-- **点击**：跳转到该提问，目标尚未加载时自动 `loadOlder` 扩窗（并落到最近可见行兜底）。
+- **点击**：跳转到该提问；只有这时跳转循环才 `loadOlder()` 扩窗，把**那一页**
+  带进视图——绝不会一次性展开整个历史。
 - 圆点列空白区域**点穿**到对话内容，不会挡住聊天。
 
 ## 环境要求

package/lib/client.js

@@ -7,8 +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/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)}`;
+		}
+		/**
+		* 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]
+				});
+			}
+			return dots;
+		}
+		/**
+		* 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 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");
@@ -20,35 +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.
 		*
-		* Dots index the WHOLE session history, not just the currently loaded window:
-		* on show, the strip auto-expands older pages (`loadAllOlder`) so questions
-		* that still sit behind DSH's "load older" button are surfaced too. While the
-		* expansion is running the count shows a "…" affordance; if the safety budget
-		* is exhausted a dimmed "load earlier" dot appears above the oldest question.
+		* 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/
-		* load-all), 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",
@@ -56,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]");
 		}
@@ -63,18 +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 [loadingAll, setLoadingAll] = (0, react.useState)(false);
-			const [moreAvailable, setMoreAvailable] = (0, react.useState)(false);
 			const panelRef = (0, react.useRef)(null);
 			const hintTimerRef = (0, react.useRef)(null);
-			/** Abort controller for the in-flight expansion (cancelled on session change). */
-			const loadAllAbortRef = (0, react.useRef)(null);
-			/** Session whose expansion is already running, to avoid duplicate loops. */
-			const loadingAllSessionRef = (0, react.useRef)(null);
 			const showHint = (message) => {
 				setHint(message);
 				if (hintTimerRef.current !== null) window.clearTimeout(hintTimerRef.current);
@@ -82,14 +146,21 @@ window.__ModuleLoader__.load({
 			};
 			(0, react.useEffect)(() => {
 				if (!visible || current === void 0) {
-					setQuestions([]);
+					setDots([]);
 					return;
 				}
-				const refresh = () => setQuestions(props.readQuestions(current));
+				const sessionId = current;
+				const face = props.questionProjection(sessionId);
+				const refresh = () => {
+					const grouped = groupQuestionsByTurn(projectionEntries(face));
+					setDots(mergeLiveQuestions(grouped, props.readQuestions(sessionId)));
+				};
 				refresh();
-				const unsubContent = props.subscribeContent(current, refresh);
+				const unsubProjection = face?.subscribe(refresh) ?? (() => {});
+				const unsubContent = props.subscribeContent(sessionId, refresh);
 				const unsubList = props.subscribeList(refresh);
 				return () => {
+					unsubProjection();
 					unsubContent();
 					unsubList();
 				};
@@ -98,36 +169,6 @@ window.__ModuleLoader__.load({
 				current,
 				props
 			]);
-			(0, react.useEffect)(() => {
-				if (!visible || current === void 0) {
-					loadAllAbortRef.current?.abort();
-					loadAllAbortRef.current = null;
-					loadingAllSessionRef.current = null;
-					setLoadingAll(false);
-					setMoreAvailable(false);
-					return;
-				}
-				if (loadingAllSessionRef.current === current) return;
-				loadingAllSessionRef.current = current;
-				const controller = new AbortController();
-				loadAllAbortRef.current = controller;
-				setLoadingAll(true);
-				setMoreAvailable(false);
-				props.loadAllOlder(current, { signal: controller.signal }).then((result) => {
-					setMoreAvailable(result.code === "BUDGET" && !result.ok);
-				}).finally(() => {
-					setLoadingAll(false);
-					if (loadAllAbortRef.current === controller) loadAllAbortRef.current = null;
-					loadingAllSessionRef.current = null;
-				});
-				return () => {
-					controller.abort();
-				};
-			}, [
-				visible,
-				current,
-				props
-			]);
 			(0, react.useEffect)(() => {
 				const onJumpFailed = (event) => {
 					const code = event.detail;
@@ -176,19 +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) return;
-				setMoreAvailable(false);
-				setLoadingAll(true);
-				props.loadAllOlder(current).then((result) => {
-					setMoreAvailable(result.code === "BUDGET" && !result.ok);
-				}).finally(() => setLoadingAll(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", {
@@ -203,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: loadingAll ? 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, loadingAll ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-										className: question_nav_module_css_default.countLoading,
-										children: t("strip.loadingSuffix")
-									}) : null]
-								}),
-								moreAvailable && !loadingAll ? /* @__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
 				]
 			});
@@ -267,9 +287,6 @@ window.__ModuleLoader__.load({
 		*/
 		const zh = {
 			"strip.empty": "本会话还没有提问",
-			"strip.loadingAll": "正在加载全部历史…",
-			"strip.loadingSuffix": "…",
-			"strip.loadEarlier": "加载更早的问题",
 			"jump.inactive": "聊天视图未激活",
 			"jump.hidden": "目标无独立气泡，已定位到邻近内容",
 			"jump.notfound": "目标未加载或不存在（可能已压缩）",
@@ -277,9 +294,6 @@ 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)",
@@ -338,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,
@@ -367,7 +381,7 @@ window.__ModuleLoader__.load({
 		*/
 		async function jumpToQuestion(ports, key, options = {}) {
 			const cfg = {
-				...DEFAULTS$1,
+				...DEFAULTS,
 				...options
 			};
 			const fail = (code, fallback = false) => {
@@ -433,72 +447,6 @@ window.__ModuleLoader__.load({
 			return fail("TARGET_HIDDEN", false);
 		}
 		//#endregion
-		//#region src/core/load-all.ts
-		const DEFAULTS = {
-			maxPages: 400,
-			totalTimeoutMs: 6e4,
-			pollMs: 60
-		};
-		/**
-		* Expand the session window backwards until the earliest history is loaded.
-		* Waits while the session is still opening; aborts on cancellation, budget or
-		* timeout. Safe to re-enter: once `hasMore` is false the loop returns
-		* immediately with `COMPLETE`.
-		*/
-		async function loadAllOlder(ports, options = {}) {
-			const cfg = {
-				...DEFAULTS,
-				...options
-			};
-			const deadline = ports.now() + cfg.totalTimeoutMs;
-			let pages = 0;
-			const cancelled = () => cfg.signal?.aborted === true;
-			while (true) {
-				if (cancelled()) return {
-					ok: false,
-					code: "CANCELLED",
-					pages
-				};
-				if (!ports.isViewActive()) return {
-					ok: false,
-					code: "VIEW_INACTIVE",
-					pages
-				};
-				const snap = ports.snapshot();
-				if (snap === void 0) return {
-					ok: false,
-					code: "VIEW_INACTIVE",
-					pages
-				};
-				if (snap.openState === "error") return {
-					ok: false,
-					code: "NOT_OPEN",
-					pages
-				};
-				if (snap.hasMore !== true) return {
-					ok: true,
-					code: "COMPLETE",
-					pages
-				};
-				if (pages >= cfg.maxPages) return {
-					ok: false,
-					code: "BUDGET",
-					pages
-				};
-				if (ports.now() > deadline) return {
-					ok: false,
-					code: "TIMEOUT",
-					pages
-				};
-				if (snap.openState !== "open" || snap.loadingOlder) {
-					await ports.sleep(cfg.pollMs);
-					continue;
-				}
-				await ports.loadOlder();
-				pages += 1;
-			}
-		}
-		//#endregion
 		//#region src/client/index.ts
 		/** Locale namespace this plugin owns. */
 		const NS = "question-nav";
@@ -544,50 +492,19 @@ window.__ModuleLoader__.load({
 				sleep: (ms) => new Promise((resolve) => window.setTimeout(resolve, ms))
 			};
 		}
-		/** Resolve the active conversation scrollport (or null when not mounted). */
-		function scrollport() {
-			return document.querySelector("[data-conversation-scroll]");
-		}
 		/**
-		* One backward page that preserves the reader's scroll position. DSH's own
-		* "load older" button arms a paging anchor; a programmatic `loadOlder()` does
-		* not, so without this compensation prepended content would push the visible
-		* rows down. We restore by the exact growth of the scrollHeight.
+		* 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 pagedLoadOlder(ctx, sessionId) {
-			const binding = ctx.sessions.binding(sessionId);
-			if (binding === void 0) return;
-			const port = scrollport();
-			const beforeHeight = port?.scrollHeight ?? 0;
-			const beforeTop = port?.scrollTop ?? 0;
-			await binding.session.loadOlder();
-			if (port === null) return;
-			await new Promise((resolve) => requestAnimationFrame(() => requestAnimationFrame(() => resolve())));
-			const delta = port.scrollHeight - beforeHeight;
-			if (delta > 0) port.scrollTop = beforeTop + delta;
-		}
-		/** Map the session to the load-all port surface. */
-		function loadAllPortsFor(ctx, sessionId) {
+		function questionProjectionOf(ctx, sessionId) {
+			const face = ctx.sessions.binding(sessionId)?.session.projections.faceOf("questionIndex");
+			if (face === void 0) return void 0;
 			return {
-				snapshot: () => {
-					const snap = ctx.sessions.binding(sessionId)?.session.getSnapshot();
-					if (snap === void 0) return void 0;
-					return {
-						openState: snap.openState,
-						hasMore: snap.hasMore,
-						loadingOlder: snap.loadingOlder
-					};
-				},
-				loadOlder: () => pagedLoadOlder(ctx, sessionId),
-				isViewActive: () => document.querySelector("[data-chat-flow]") !== null,
-				now: () => Date.now(),
-				sleep: (ms) => new Promise((resolve) => window.setTimeout(resolve, ms))
+				getSnapshot: () => face.getSnapshot(),
+				subscribe: (listener) => face.subscribe(listener)
 			};
 		}
-		/** Expand the whole session history so every question becomes a dot. */
-		function loadAllFor(ctx, sessionId, options = {}) {
-			return loadAllOlder(loadAllPortsFor(ctx, sessionId), options);
-		}
 		function createInject(ctx) {
 			return {
 				readQuestions: (sessionId) => {
@@ -601,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);
-				},
-				loadAllOlder: (sessionId, options) => loadAllFor(ctx, sessionId, options)
+				}
 			};
 		}
 		/**