@luziyang2026/dsh-question-nav 0.4.0 → 0.4.1

package/LICENSE

@@ -1,29 +1,21 @@
-BSD 3-Clause License
+MIT License
 
-Copyright (c) 2026, Abel Keith Sun. All rights reserved.
+Copyright (c) 2026 Abel Keith Sun
 
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-1. Redistributions of source code must retain the above copyright notice,
-   this list of conditions and the following disclaimer.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-2. Redistributions in binary form must reproduce the above copyright notice,
-   this list of conditions and the following disclaimer in the documentation
-   and/or other materials provided with the distribution.
-
-3. Neither the name of the copyright holder nor the names of its
-   contributors may be used to endorse or promote products derived from this
-   software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
-LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-POSSIBILITY OF SUCH DAMAGE.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -10,22 +10,26 @@ It is an external plugin bundle with zero runtime dependencies — the browser
 half (`lib/client.js`) externalizes everything to the DSH shell, so it adds
 only a small bundle to the GUI at load time.
 
-Package: **`@luziyang2026/dsh-question-nav`** ([npm][npm]).
+Package: **`@luziyang2026/dsh-question-nav`** ([npm][npm] · [GitHub][github]).
+
+## Preview
+
+![Left-edge dot minimap with a hover tooltip showing the turn label and full question text](https://raw.githubusercontent.com/AbelKeithsun/dsh-question-nav/main/docs/images/question-nav-preview.jpg)
 
 ## What it does
 
 - **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, 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.
+- **One dot = one turn that asked a question** (strictly aligned with the
+  Trajectory view's turn numbering), with a small count above the dot column.
+- **Full history, persisted, no render-window expansion**: the plugin's host
+  half registers a `questionIndex` session projection — the projection
+  registry folds the whole event log (read-only, the chat's paged window is
+  never touched), the official projection cache persists it across restarts,
+  and push frames deliver new questions live.
 - **Hover**: the dot enlarges and an instant tooltip (portal-rendered, no
-  native-title delay) shows the question's **full text**.
+  native-title delay) shows the **turn label** (`Turn N`) plus the turn's
+  **full question text** (all of them, when one turn batched several).
 - **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.
@@ -79,8 +83,9 @@ module table.
 
 ## License
 
-BSD-3-Clause.
+MIT.
 
 [dsh]: https://github.com/deepseek-harness/deepseek-harness
 [npm]: https://www.npmjs.com/package/@luziyang2026/dsh-question-nav
+[github]: https://github.com/AbelKeithsun/dsh-question-nav
 [bundle]: https://github.com/deepseek-harness/deepseek-harness

package/README.zh.md

@@ -7,19 +7,24 @@
 它是外部插件 bundle，**零运行时依赖** —— 浏览器半区（`lib/client.js`）把一切
 外部化给 DSH 外壳，加载时只往 GUI 里加一个很小的 bundle。
 
-包名：**`@luziyang2026/dsh-question-nav`**（[npm][npm]）。
+包名：**`@luziyang2026/dsh-question-nav`**（[npm][npm] · [GitHub][github]）。
+
+## 效果展示
+
+![左缘圆点迷你地图：竖排圆点，每个圆点对应一个用户提问，悬停显示 Turn 编号与全文](https://raw.githubusercontent.com/AbelKeithsun/dsh-question-nav/main/docs/images/question-nav-preview.jpg)
 
 ## 功能
 
 - **左缘圆点迷你地图**：内嵌，**不占任何宽度**。
 - **垂直居中**在对话栏中。
-- **一个圆点 = 一个用户提问**，圆点列上方有提问数量。
-- **完整历史、不展开渲染窗口**：索引通过分页读取原始 `session.history`
-  RPC（只读）构建，所以会话里的每一个提问——包括仍被 DSH"加载更早"按钮
-  折叠隐藏的老提问——都会变成圆点，**不会**展开对话的分页窗口（保留 DSH
-  的内存经济性）。构建索引期间数量后显示 "…"；若超过安全预算，最老提问
-  上方会出现一个虚线圆点，点击继续加载。
-- **悬停**：圆点放大 + 即时提示框（portal 渲染，无原生 `title` 延迟）显示**全文**。
+- **一个圆点 = 一个含提问的 turn**（与轨迹视图的 Turn 编号严格对齐），
+  圆点列上方有圆点数量。
+- **完整历史、持久化、不展开渲染窗口**：插件的 host 半面注册
+  `questionIndex` 会话投影——投影注册表折叠完整事件日志（只读，对话的
+  分页窗口完全不被动），官方 projection-cache 跨重启持久化，新提问通过
+  推送帧实时到达。
+- **悬停**：圆点放大 + 即时提示框（portal 渲染，无原生 `title` 延迟）显示
+  **Turn 编号**（`Turn N`）和该轮提问**全文**（一轮多条提问时全部列出）。
 - **点击**：跳转到该提问；只有这时跳转循环才 `loadOlder()` 扩窗，把**那一页**
   带进视图——绝不会一次性展开整个历史。
 - 圆点列空白区域**点穿**到对话内容，不会挡住聊天。
@@ -69,8 +74,9 @@ externals 经加载器模块表解析。
 
 ## License
 
-BSD-3-Clause。
+MIT。
 
 [dsh]: https://github.com/deepseek-harness/deepseek-harness
 [npm]: https://www.npmjs.com/package/@luziyang2026/dsh-question-nav
+[github]: https://github.com/AbelKeithsun/dsh-question-nav
 [bundle]: https://github.com/deepseek-harness/deepseek-harness

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@luziyang2026/dsh-question-nav",
   "description": "In-session question navigator for the DSH web GUI: a vertical minimap of round dots overlaid on the left edge of the conversation column, one dot per user question — hover enlarges and shows the full question text, click jumps to that message.",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "type": "module",
   "packageManager": "pnpm@11.7.0",
   "engines": {
@@ -69,7 +69,6 @@
     "react-dom": "^18.2.0",
     "tsdown": "^0.22.2",
     "typescript": "^6.0.3",
-    "vite-tsconfig-paths": "^6.1.1",
     "vitest": "^4.1.8"
   },
   "files": [
@@ -78,10 +77,9 @@
     "cordis.patch.yml",
     "LICENSE",
     "README.md",
-    "README.zh.md",
-    "README.i18n.yaml"
+    "README.zh.md"
   ],
-  "license": "BSD-3-Clause",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/AbelKeithsun/dsh-question-nav.git"

package/lib/types/core/history-index.d.ts

@@ -1,99 +0,0 @@
-/**
- * Question-index builder over the raw session history RPC.
- *
- * DSH pages the rendered conversation window on purpose (memory economy):
- * `chat.nodes` only ever holds the loaded window, and force-expanding it
- * (repeated `loadOlder()`) materializes + renders the whole log — the exact
- * cost DSH's paging exists to avoid. This module instead builds a lightweight
- * index of every user question by paging the RAW history RPC (`session.history`
- * with `beforeSeq`), which reads the host log without touching the render
- * window at all. Only `{key, seq, time, text}` per question is retained.
- *
- * The chat anchor key is derived deterministically from the event — it equals
- * `conversationContextKey('input-message', String(event.data.id))` — so the
- * dots can target rows that are not loaded yet, and a click then pages the
- * window on demand (see `jump.ts`).
- *
- * Pure-ish: takes injected ports (one raw history page read, clocks) so it is
- * unit-testable without a browser or a live session.
- */
-import type { QuestionNode } from './nodes.ts';
-/** Minimal shape of a raw history event (structural, not SDK-bound). */
-export interface RawEventLike {
-    type: string;
-    seq: number;
-    time: number;
-    surfaceOp?: unknown;
-    data?: {
-        id?: unknown;
-        source?: {
-            kind?: string;
-            plugin?: string;
-        };
-        content?: readonly {
-            type?: string;
-            text?: string;
-        }[];
-    };
-}
-/** The conversation Definition kind whose key a user question node uses. */
-export declare 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).
- */
-export declare function questionKey(id: unknown): string;
-/**
- * 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.
- */
-export declare function isQuestionEvent(event: RawEventLike): boolean;
-/** Map one raw question event to a strip question node, or null when not one. */
-export declare function questionFromEvent(event: RawEventLike): QuestionNode | null;
-export interface HistoryIndexPorts {
-    /**
-     * Read one raw history page. `beforeSeq` is exclusive (events with seq <
-     * beforeSeq); `undefined` reads the newest page. Resolves undefined when
-     * the page is unavailable (session gone / transport error).
-     */
-    history: (beforeSeq: number | undefined, maxMessages: number) => Promise<{
-        events: readonly {
-            event: RawEventLike;
-        }[];
-        hasMore: boolean;
-    } | undefined>;
-    /** Monotonic ms clock. */
-    now: () => number;
-}
-export interface HistoryIndexOptions {
-    /** Raw messages per page (default 100). */
-    maxMessages?: number;
-    /** Max pages before giving up (default 200 => 20k messages). */
-    maxPages?: number;
-    /** Total wall-clock budget (default 30s). */
-    totalTimeoutMs?: number;
-    /** Abort the build; checked every iteration. */
-    signal?: AbortSignal;
-    /** Resume from a previous `nextBeforeSeq` instead of the newest page. */
-    startBeforeSeq?: number;
-}
-export type HistoryIndexCode = 'COMPLETE' | 'BUDGET' | 'TIMEOUT' | 'UNAVAILABLE' | 'CANCELLED';
-export interface HistoryIndexResult {
-    ok: boolean;
-    code: HistoryIndexCode;
-    /** Questions collected so far, ascending by anchorSeq. */
-    questions: QuestionNode[];
-    /** Page count actually read. */
-    pages: number;
-    /** Where to continue (exclusive) when stopped early; undefined when COMPLETE. */
-    nextBeforeSeq: number | undefined;
-}
-/**
- * Page the raw session history backward, collecting every user question into a
- * lightweight index. Never touches the render window.
- */
-export declare function buildQuestionIndex(ports: HistoryIndexPorts, options?: HistoryIndexOptions): Promise<HistoryIndexResult>;

package/lib/types/core/load-all.d.ts

@@ -1,53 +0,0 @@
-/**
- * Load-all orchestration for the question-nav strip.
- *
- * DSH sessions page history in fixed-size chunks: `chat.nodes` only ever holds
- * the currently loaded window, and questions that still sit behind the "load
- * older" button are invisible to the strip until the window is expanded
- * backwards. This loop pages `loadOlder()` until `hasMore` is false (the whole
- * history is materialized), so every user question becomes a dot.
- *
- * Pure-ish: takes injected ports (snapshot read, one paged loadOlder, view
- * liveness, clocks) so it is unit-testable without a browser or session.
- */
-export interface LoadAllSnapshot {
-    openState: string;
-    hasMore: boolean;
-    loadingOlder: boolean;
-}
-export interface LoadAllPorts {
-    /** Read the current session snapshot; undefined when unavailable. */
-    snapshot: () => LoadAllSnapshot | undefined;
-    /** Expand the window backwards by one page (may preserve scroll). */
-    loadOlder: () => Promise<void>;
-    /** True while the chat view is active (a `[data-chat-flow]` is mounted). */
-    isViewActive: () => boolean;
-    /** Monotonic ms clock. */
-    now: () => number;
-    /** Async sleep. */
-    sleep: (ms: number) => Promise<void>;
-}
-export interface LoadAllOptions {
-    /** Max older pages to fetch before giving up (default 400). */
-    maxPages?: number;
-    /** Total wall-clock budget for the whole expansion (default 60s). */
-    totalTimeoutMs?: number;
-    /** Poll interval for open/loading transitions (default 60ms). */
-    pollMs?: number;
-    /** Abort the expansion; checked every iteration. */
-    signal?: AbortSignal;
-}
-export type LoadAllCode = 'COMPLETE' | 'VIEW_INACTIVE' | 'NOT_OPEN' | 'BUDGET' | 'TIMEOUT' | 'CANCELLED';
-export interface LoadAllResult {
-    ok: boolean;
-    code: LoadAllCode;
-    /** Number of `loadOlder` pages actually fetched. */
-    pages: number;
-}
-/**
- * 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`.
- */
-export declare function loadAllOlder(ports: LoadAllPorts, options?: LoadAllOptions): Promise<LoadAllResult>;