dsh-turn-navigator 0.4.3 → 0.4.4

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.4.4] - 2026-09-22
+
+### Fixed
+
+- **Live disable/reload no longer leaves the OFFICIAL rail hidden.** The plugin hides the built-in rail with a `tn-hide-official` class on `document.body`, but nothing removed that class when the plugin unloaded. dsh 0.1.6-alpha.2 enables the host `hmr` row by default for launcher-provided profiles, so the dsh Plugins page can now disable or reload a bundle **without a restart** — with the stale class the official rail stayed hidden after the plugin was gone, and only a page reload brought it back. The class is now applied inside `ctx.effect(...)` and removed by its dispose hook (`clearModeFromBody`), so unloading restores the built-in default — `src/client/index.ts`, `src/client/mode.ts`.
+
+- **The release gate no longer fails on proxied networks.** `release-check.mjs` probed the registry with Node's `fetch`, which ignores npm's `.npmrc` proxy settings — and the proxy variables plus `NODE_USE_ENV_PROXY` are sampled when the process starts (verified on Node 24.18: setting them inside the script changes nothing), so the probe went **direct**. On 2026-09-22 three probe timeouts blocked the 0.4.4 publish with `The operation was aborted due to timeout`, while `npm publish` itself (which does honor `.npmrc`) would have worked. The probe now runs `npm view` — the same registry, proxy and auth as the publish it guards. `post-publish-check.mjs` gets the same treatment for its curl fallbacks (registry probes and the tarball download), preferring npm's configured proxy over an inherited variable so the check actually verifies instead of degrading to "unreachable" — `scripts/release-check.mjs`, `scripts/post-publish-check.mjs`.
+
+### Changed
+
+- **Two stale `dsh.client.inject` entries removed** — `@deepseek-ai/dsh-client-runtime` and `@deepseek-ai/dsh-client-web-react`. Neither package exists in the current dsh client graph (the former was removed upstream in dsh 0.1.2, per the 0.4.2 entry below) and this plugin's source never imported either one; `inject` names package rows to order against, so listing absent rows was dead weight. The remaining six entries are unchanged.
+
+### Tests
+
+- **New `scripts/test-client-dispose.mjs`, wired into `pnpm test`.** It loads the real built `lib/client.js` in a minimal DOM + module-loader stub and asserts the observable contract: `apply()` hides the official rail through the body class, and the registered cordis effect's disposer restores it. Verified as a real gate by negative control — replacing the `ctx.effect(...)` wrapper with a bare `applyModeToBody()` makes it fail.
+
 ## [0.4.3] - 2026-09-06
 
 ### Changed

package/CONTRIBUTING.md

@@ -21,6 +21,16 @@ Every release must be done in one pass: code + bilingual README + CHANGELOG + ve
 7. `npm publish` (requires 2FA; the agent cannot do this step).
 8. `postpublish` runs `scripts/post-publish-check.mjs` automatically.
 
+## The release gates use npm's own transport
+
+`release-check.mjs` asks `npm view` whether the version is already published, and
+`post-publish-check.mjs` gives its curl fallbacks npm's configured proxy — both on
+purpose. Node's `fetch` cannot be proxied after startup (the proxy variables and
+`NODE_USE_ENV_PROXY` are sampled at process start) and ignores `.npmrc` entirely, so
+a fetch-based gate goes direct and blocks every release on a network where the
+registry is only reachable through the proxy in `.npmrc` — even though
+`npm publish` itself would work. Keep new registry access on the npm/curl path.
+
 ## npm publish is manual (2FA)
 
 npm accounts with two-factor authentication require an OTP that the agent cannot provide. The agent prepares everything to "one command to publish"; the human runs `npm login` → `npm publish`.

package/README.md

@@ -40,6 +40,7 @@ The official built-in `TurnNavigator` has **no off-switch** and is always render
 | Capability | DSH official rail (0.1.3-alpha.1) | Smoothly TN (v0.4.3) |
 |---|---|---|
 | Turns shown | **Every turn** — host `turnOutline` projection (0.1.3+) | Every persisted turn — **client-side** journal read |
+| Full-history robustness | Depends on the host `turnOutline` projection — **not driven** by browser-synthesized sessions (e.g. `?fixture`), where it falls back to the loaded window | Always full — reads the persisted journal directly, no host projection required (verified full on both real and fixture sessions) |
 | How full history is read | Host-side projection embedded in the snapshot | Client pages the persisted journal (`session/page`); older dsh falls back to `sessions.history` RPC — **zero host changes** |
 | Jump to a turn outside the window | ✅ (0.1.3+ unloaded anchor pages history by seq) | ✅ on-demand window extension + "Locating turn N…" pulse/bubble |
 | Long-session open performance | Reads the projection | **Zero prepend** — plain data, no flow re-render, no stall |
@@ -55,6 +56,8 @@ The official built-in `TurnNavigator` has **no off-switch** and is always render
 
 As of dsh 0.1.3 the built-in rail caught up on full-session scope and out-of-window jumps. What still sets Smoothly TN apart: you can **switch it off** (the official rail cannot), the tooltip carries the **timestamp + full summary**, there are **scroll buttons and wave hover**, and it remains an **external, read-only plugin with zero host changes**. And on dsh ≤ 0.1.2 the built-in rail is simpler still (loaded window only), so the gap Smoothly TN closes is even larger there.
 
+**Verified on dsh 0.1.3-alpha.1 (2026-09-06, Playwright against the live web UI)**: on a real 42-turn session both rails show all 42 turns (the official one via its host projection, ours via the journal); on a `?fixture` browser-synthesized session the official rail degrades to the loaded window (24/75) while Smoothly TN still shows all 75 — because our full history never depends on the host projection. Jumps, follow-scroll highlight, the mode switch, and the subtractive takeover of the official rail (`display: none` via the stylesheet override) all verified working.
+
 ## Version map
 
 Which Smoothly TN release matches which dsh:
@@ -65,6 +68,7 @@ Which Smoothly TN release matches which dsh:
 | v0.2.x – v0.4.1 | dsh 0.1.2+ | Adapted to the `ui-chat` refactor; full history via the journal `session/page` channel; v0.4.1 fixed true turn numbers and rail-viewport follow |
 | **v0.4.2** | dsh 0.1.2+, incl. **0.1.3-alpha.1** | Comparison/positioning updated against the 0.1.3 official rail (see above) |
 | **v0.4.3** | dsh 0.1.2+, incl. **0.1.3-alpha.1** | This release: brand naming standardized to **Smoothly**（思磨力）/ **Smoothly Turn Nav**（**Smoothly TN**）/ **思磨力轮次胶囊条** — technical IDs (npm package `dsh-turn-navigator`, plugin/slot IDs, locale namespace, CSS prefix, localStorage key) unchanged |
+| **v0.4.4** | dsh 0.1.2+, client contract re-checked against **0.1.6-alpha.2** | This release: the official-rail body class gained a dispose hook (disabling or reloading the bundle live from the dsh Plugins page restores the built-in rail), and two stale `inject` entries are gone |
 
 The official-rail comparison in this README targets **dsh 0.1.3-alpha.1**; on older dsh the official rail is simpler, so Smoothly TN's advantage is larger there.
 
@@ -106,14 +110,16 @@ The plugin registers **two additive slots** — **no DSH source code is modified
 
 ## Compatibility
 
-- DeepSeek Harness (dsh) with the web client (`dsh web`); developed and verified against dsh 0.1.2+ and reviewed against dsh 0.1.3-alpha.1.
+- DeepSeek Harness (dsh) with the web client (`dsh web`); developed and verified against dsh 0.1.2+ and **verified against dsh 0.1.3-alpha.1** (Playwright re-test, 2026-09-06: full-history rail, jumps, follow highlight, mode switch, and the official-rail stylesheet takeover all passing).
 - Requires the `conversation.session.header.utilities` and `settings.general.item` slot declarations (present in current DSH).
+- Client contract re-checked against **dsh 0.1.6-alpha.2** (2026-09-22): the `conversation.session.header.utilities`, `settings.general.item` and `shell.overlay` slot declarations, the `ui-primitives` exports the rail uses, and the `--dsw-alias-*` tokens it references all still exist. The interactive Playwright re-test was **not** re-run on 0.1.6 (the 2026-09-06 run remains the last interactive verification).
 - Default `Smoothly TN` mode hides the official rail (stylesheet override) and centers our rail in its place; `DSH official` mode shows the built-in rail instead; `Hide all` hides both. Both rails auto-hide below 900px width.
 - Coexists with full-screen plugin pages (e.g. the kanban board): the rail sits below their overlay layer.
 
 ## Development
 
-- `pnpm typecheck` / `pnpm test` — TypeScript check (tsdown does not typecheck).
+- `pnpm typecheck` — TypeScript check (tsdown does not typecheck).
+- `pnpm test` — typecheck plus `scripts/test-client-dispose.mjs`, which loads the built bundle in a DOM stub and asserts the apply/dispose contract of the official-rail body class.
 - `pnpm bundle` — build the module-table client bundle into `lib/`.
 - `scripts/verify-*.mjs` — Playwright acceptance scripts against a live `dsh web` (rail, full-history journal, mode switch, jump, feedback, overlay, sizing, UI).
 - `pnpm release:check` — release gates (version, tag, tree, build, registry).

package/README.zh.md

@@ -40,6 +40,7 @@
 | 能力 | DSH 官方胶囊条（0.1.3-alpha.1） | 思磨力轮次胶囊条（v0.4.3） |
 |---|---|---|
 | 显示的轮次 | **全部轮次**——宿主 `turnOutline` 投影（0.1.3+） | 全部持久化轮次——**客户端**读取 journal |
+| 全量历史的健壮性 | 依赖宿主 `turnOutline` 投影——**浏览器合成会话**（如 `?fixture`）不驱动投影，此时退回"仅加载窗口" | 始终全量——直接读持久化日志，无需宿主投影（真实会话与 fixture 会话均已实测全量） |
 | 全会话历史怎么读 | 宿主侧投影内嵌在会话快照里 | 客户端分页读持久化日志（`session/page`）；旧版 dsh 退回 `sessions.history` RPC——**零宿主改动** |
 | 跳转窗口外轮次 | ✅（0.1.3+ 未加载锚点按 seq 分页） | ✅ 按需扩展窗口 + "正在定位第 N 轮…"脉冲/气泡 |
 | 长会话打开性能 | 读投影 | **零 prepend**——纯数据、不重渲染会话流、不卡顿 |
@@ -55,6 +56,8 @@
 
 dsh 0.1.3 起官方胶囊条已在紧要的全会话范围与窗口外跳转上追平。**思磨力轮次胶囊条仍然独占的**：可以**关掉它**（官方关不掉）、Tooltip 带**时间戳与完整摘要**、**滚动按钮 + 波浪悬停**、以及它始终是**零宿主改动的外部只读插件**。在 dsh ≤ 0.1.2 上官方胶囊条更简单（仅加载窗口），思磨力轮次胶囊条填补的差距更大。
 
+**dsh 0.1.3-alpha.1 实测（2026-09-06，Playwright 直连在线 Web UI）**：真实 42 轮会话上两个胶囊条都显示全部 42 轮（官方走宿主投影、我们走 journal）；`?fixture` 浏览器合成会话上官方胶囊条退化为"仅加载窗口"（24/75），而思磨力轮次胶囊条仍显示全部 75——因为我们的全量历史从不依赖宿主投影。跳转、滚动跟随高亮、模式开关、以及减法接管官方胶囊条（样式覆盖 `display: none`）均实测通过。
+
 ## 版本对照
 
 我们的版本与 dsh 版本的对应关系：
@@ -65,6 +68,7 @@ dsh 0.1.3 起官方胶囊条已在紧要的全会话范围与窗口外跳转上
 | v0.2.x – v0.4.1 | dsh 0.1.2+ | 适配 `ui-chat` 重构；通过 journal `session/page` 通道读全量历史；v0.4.1 修复真实轮次号与胶囊条视口跟随 |
 | **v0.4.2** | dsh 0.1.2+（含 **0.1.3-alpha.1**） | 对照 dsh 0.1.3 官方胶囊条更新对比与定位（见上文） |
 | **v0.4.3** | dsh 0.1.2+（含 **0.1.3-alpha.1**） | 本版：品牌命名规范化为 **Smoothly**（思磨力）/ **Smoothly Turn Nav**（**Smoothly TN**）/ **思磨力轮次胶囊条**——技术标识符（npm 包名 `dsh-turn-navigator`、插件/slot ID、locale 命名空间、CSS 前缀、localStorage key）不变 |
+| **v0.4.4** | dsh 0.1.2+，客户端契约对照 **0.1.6-alpha.2** 复核 | 本版：官方胶囊条的 body class 补上 dispose（从 dsh 插件页在线停用/重载后会恢复内置胶囊条）；清掉两个陈旧 `inject` 条目 |
 
 本文 README 的对比对象为 **dsh 0.1.3-alpha.1**；在更旧的 dsh 上官方胶囊条更简单，思磨力轮次胶囊条的优势更大。
 
@@ -106,14 +110,16 @@ dsh web
 
 ## 兼容性
 
-- DeepSeek Harness (dsh) Web 客户端（`dsh web`）；基于 dsh 0.1.2+ 开发与实测，并对照 dsh 0.1.3-alpha.1 复核。
+- DeepSeek Harness (dsh) Web 客户端（`dsh web`）；基于 dsh 0.1.2+ 开发与实测，并在 **dsh 0.1.3-alpha.1 上复测通过**（Playwright 直连实测，2026-09-06：全量历史胶囊条、跳转、跟随高亮、模式开关、官方胶囊条样式接管全部通过）。
 - 需要 `conversation.session.header.utilities` 与 `settings.general.item` slot 声明（当前 DSH 已包含）。
+- 客户端契约已对照 **dsh 0.1.6-alpha.2** 复核（2026-09-22）：`conversation.session.header.utilities`、`settings.general.item`、`shell.overlay` 的 slot 声明、胶囊条用到的 `ui-primitives` 导出、以及它引用的 `--dsw-alias-*` token 均仍存在。0.1.6 上的 Playwright 交互复测**未重跑**（2026-09-06 那次仍是最近一次交互验证）。
 - 默认 `思磨力轮次胶囊条` 模式以样式覆盖隐藏官方 rail，我们的 rail 居中接管；`DSH 官方` 模式显示内置 rail；`全部隐藏` 两者皆隐。900px 以下都自动隐藏。
 - 与全屏插件页面（如看板）共存：胶囊条层级位于全屏 overlay 之下。
 
 ## 开发
 
-- `pnpm typecheck` / `pnpm test` — TypeScript 检查（tsdown 只转译不检查）。
+- `pnpm typecheck` — TypeScript 检查（tsdown 只转译不检查）。
+- `pnpm test` — 类型检查 + `scripts/test-client-dispose.mjs`：在 DOM 桩里加载构建产物，断言官方胶囊条 body class 的 apply/dispose 契约。
 - `pnpm bundle` — 构建模块表 client bundle 到 `lib/`。
 - `scripts/verify-*.mjs` — 针对真实 `dsh web` 的 Playwright 验收脚本（rail、全量历史 journal、模式开关、跳转、反馈、overlay、尺寸、UI）。
 - `pnpm release:check` — 发布门禁（版本、tag、工作树、构建、registry）。

package/lib/client.js

@@ -371,6 +371,20 @@ window.__ModuleLoader__.load({
 			if (typeof document === "undefined") return;
 			document.body.classList.toggle("tn-hide-official", current !== "official");
 		}
+		/**
+		* Drop the `tn-hide-official` body class — the plugin's dispose hook.
+		*
+		* dsh 0.1.6+ enables the host `hmr` row by default for launcher-provided
+		* profiles, so this plugin can be disabled or reloaded LIVE (the dsh Plugins
+		* page toggles bundles without a restart). Without this teardown the class
+		* outlives the plugin and keeps hiding the OFFICIAL rail, and only a page
+		* reload brings it back. Removing the class is the correct "unloaded" state:
+		* the official rail is the built-in default whenever this plugin is not applied.
+		*/
+		function clearModeFromBody() {
+			if (typeof document === "undefined") return;
+			document.body.classList.remove("tn-hide-official");
+		}
 		//#endregion
 		//#region src/client/TurnNavRail.tsx
 		/**
@@ -1262,7 +1276,10 @@ body.tn-hide-official [data-conversation-scroll] nav {
 			}), "dsh-turn-navigator: copy dictionaries");
 			const t = ctx.locale.bind(NS);
 			const api = ctx.get("connection")?.api;
-			applyModeToBody();
+			ctx.effect(() => {
+				applyModeToBody();
+				return clearModeFromBody;
+			}, "dsh-turn-navigator: official-rail body class");
 			let journal;
 			let sessionAccess;
 			const resolveHandles = () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-turn-navigator",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "Smoothly Turn Nav (Smoothly TN): full-history piano-key turn rail for DeepSeek Harness (dsh) web conversations — see every turn at a glance, hover to preview, click to jump anywhere, and replace the official (non-disableable) turn rail.",
   "type": "module",
   "main": "lib/index.js",
@@ -32,11 +32,9 @@
       "inject": [
         "@deepseek-ai/dsh-client-connection",
         "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-ui-conversation",
         "@deepseek-ai/dsh-client-ui-layout",
         "@deepseek-ai/dsh-client-ui-slots",
-        "@deepseek-ai/dsh-client-web-react",
         "@deepseek-ai/dsh-api-remotes"
       ],
       "platform": "web"
@@ -46,7 +44,7 @@
     "bundle": "tsdown --config ./tsdown.config.ts",
     "prepare": "tsdown --config ./tsdown.config.ts",
     "typecheck": "tsc --noEmit",
-    "test": "tsc --noEmit",
+    "test": "tsc --noEmit && node scripts/test-client-dispose.mjs",
     "release:check": "node scripts/release-check.mjs",
     "prepack": "node scripts/release-check.mjs",
     "prepublishOnly": "node scripts/release-check.mjs && tsdown --config ./tsdown.config.ts",