dsh-rewind-plugin 0.7.2 → 0.7.3

package/README.en.md

@@ -158,6 +158,9 @@ withdrew should consume the stable, locale-independent helpers exported from
 4. **Rewinds from `≤ v0.3.3`** — compaction (`/compact`) is unavailable for those sessions. Newer versions are compatible; for affected old sessions, start a new session.
 5. **The turn-rail shows rewound turns** — the right-side rail added in DSH `v0.1.2-alpha.1` keeps ticks for withdrawn messages: clicking does not jump and hovering shows the withdrawn text. Only a display difference; no functional impact.
 
+> [!NOTE]
+> Browser diagnostics are available; see [Browser diagnostics](docs/compat/diagnostics.md).
+
 ## Security
 
 This plugin only appends rewind-marker events to the session log; it never deletes or rewrites logged history. Workspace files are written only when you choose "conversation and code"; backups are stored under `<dsh home>/rewind-snapshots/`; restores draw only from those backups. It never touches your git repository, makes no network requests, and accesses no credentials. Delete `~/.dsh/rewind-snapshots/` to wipe file backups only (chat rewinds are unaffected); the plugin rebuilds automatically. For sessions you've left inactive for a long time, a global auto-cleanup (off by default) can remove their snapshot directory in whole, leaving the active session and the chat log untouched. Full security model: [SECURITY.md](SECURITY.md).

package/README.md

@@ -146,8 +146,7 @@ dsh plugin --profile web add dsh-rewind-plugin
 5. **导轨显示已回退轮次**——DSH `v0.1.2-alpha.1` 新增的右侧导轨，会为已撤回消息保留刻度：点击不跳转、悬浮显示已撤回正文。仅显示差异，无功能影响。
 
 > [!NOTE]
-> 若使用中遇到问题，可开启详细诊断输出，复现后附上控制台 `[dsh-rewind]` 输出便于定位。详见
-> [浏览器诊断与详细输出开关](docs/compat/diagnostics.zh.md)。
+> 本插件提供浏览器端诊断输出；详见 [浏览器诊断](docs/compat/diagnostics.zh.md)。
 
 ## 安全
 

package/docs/README.md

@@ -15,7 +15,7 @@ index/navigation entry point.
 | `contract/client-contract.md` | Rewind visibility contract for third-party DOM plugins (`.zh` mirror) | integrators |
 | `compat/audit.md` | Compatibility audit: verified surfaces, recorded findings, probe matrix | maintainers |
 | `compat/troubleshooting.md` | Known issues & repair steps (`.zh` mirror) | users / maintainers |
-| `compat/diagnostics.md` | Browser diagnostics & the verbose output switch (`.zh` mirror) | users / maintainers |
+| `compat/diagnostics.md` | Browser diagnostics (anomaly alerts; verbose switch gates the startup identity line) (`.zh` mirror) | users / maintainers |
 | `release/release.md` | Release workflow & DSH peer-version alignment (`.zh` mirror) | maintainers |
 
 Repo-root docs outside `docs/`: `SECURITY.md` (security model) and

package/docs/compat/diagnostics.md

@@ -1,54 +1,57 @@
-# Browser diagnostics and the verbose switch
+# Browser diagnostics
 
 [简体中文](diagnostics.zh.md)
 
-Every browser-side diagnostic this plugin emits goes through one small
-channel, so a report can be captured with a single console filter and a
-verbose mode can be switched on without a plugin rebuild.
+Every browser-side diagnostic this plugin emits is routed through one small,
+level-filtered channel, so an anomaly surfaces under a single console filter.
+The channel is deliberately narrow: it records only genuine internal anomalies
+the plugin itself detects as off-contract — **not** the normal-path facts the
+user already sees on screen, which carry no attribution.
 
-## Scope-prefixed output
+## Always-on anomaly alerts
 
-Diagnostics are printed as `[dsh-rewind:<scope>] ...`. The scope names the
-subsystem, and is also what the verbose switch filters on:
+`error` and `warn` are always printed (no switch, no configuration) so a fault
+surfaces even for a user who never configured anything:
 
-| Scope | What it reports |
+| Level | Meaning |
 | --- | --- |
-| `hiding` | The row-hiding path (which rows a rewind cuts; the `rewind not hidden` anomaly) |
-| `refill` | The composer refill after a rewind (target seq, mode, used channel, write result) |
-| `portals` | Per-message button mount issues (e.g. no session binding) |
-| `settings` | The snapshot-cleanup settings card |
+| `error` | Unexpected/breaking failure (e.g. the settings card fails to register) |
+| `warn` | Recoverable anomaly guard (e.g. a rewind command/refill throws, a waited-on outcome never settles, an unmet session binding) |
 
-## Levels
+These cases are rare, cheap, and off-contract. Normal-path detail (which
+branch a refill took, whether a write matched, which rows a rewind cut) is
+deliberately **not** logged: it re-states what the user already sees and adds
+nothing to attribution.
 
-| Level | Default | Meaning |
-| --- | --- | --- |
-| `error` | on | Unexpected/breaking; always printed |
-| `warn` | on | Recoverable anomaly guard (`rewind not hidden`, `refill skipped/refused/threw`); always printed |
-| `info` | off | Event-level lifecycle (one line per rewind / refill) |
-| `debug` | off | Additional event-level detail behind the switch (the hide-set line, one per rewind) |
+## Scopes
 
-`error`/`warn` are always printed so an anomaly surfaces even for a user who
-never touched the switch; `info`/`debug` are gated so a normal user's console
-stays clean. Both gated levels emit once per relevant event (a rewind, a
-refill), never per streaming frame — so a rewound session does not flood the
-console even with verbose output switched on.
+Diagnostics are printed as `[dsh-rewind:<scope>] ...`. The scope names the
+subsystem an anomaly belongs to, so a report can be captured with a single
+console filter:
 
-## Enabling verbose output
+| Scope | What an anomaly here means |
+| --- | --- |
+| `boot` | Startup identity — `loaded v<version> (build <hash>)`, gated by the verbose switch (see below). Confirms the running bundle matches a fix. |
+| `refill` | The composer refill after a rewind (command/wait/refill throws, an outcome that never settles) |
+| `portals` | Per-message button mount issues (e.g. no session binding) |
+| `settings` | The snapshot-cleanup settings card |
+| `hiding` | **Reserved** — no active alert at present. If a future row-hiding diagnostic is added, it belongs in this region. |
 
-The switch lives in the **browser's** `localStorage` under the plugin's own
-key, so it can never enable another plugin/feature and nothing else can wake
-this one. Set it, reload the page, reproduce, then filter the console for
-`[dsh-rewind]`:
+## Verbose switch
 
-```js
-// Every dsh-rewind namespace.
-localStorage['dsh-rewind.debug'] = 'dsh-rewind*'
+The `info`/`debug` levels are gated by `localStorage['dsh-rewind.debug']`, read
+once per call and filtered by namespace. After the withdrawal of the restating
+verbose detail, exactly **one** verbose line remains: the `boot` scope's startup
+identity line. It is deliberately **off** by default (a normal user's console
+stays clean, and it is not an anomaly), so a reporter enables the scope to see
+it:
 
-// Or just the subsystem you care about (exact scope match).
-localStorage['dsh-rewind.debug'] = 'dsh-rewind:refill'
+```js
+// Just the startup identity line.
+localStorage['dsh-rewind.debug'] = 'dsh-rewind:boot'
 
-// Several at once (comma-separated).
-localStorage['dsh-rewind.debug'] = 'dsh-rewind:refill,dsh-rewind:hiding'
+// Or everything (avoids needing an exact scope).
+localStorage['dsh-rewind.debug'] = 'dsh-rewind*'
 ```
 
 Reload (`F5`) after setting it. To switch it off:
@@ -57,26 +60,26 @@ Reload (`F5`) after setting it. To switch it off:
 delete localStorage['dsh-rewind.debug']
 ```
 
+The `error`/`warn` anomaly alerts are **not** gated by this switch — they are
+always printed. The other verbose detail (used write channel, an empty
+hide-set, per-rewind lifecycle lines) has been withdrawn: it re-stated behavior
+the user already sees and carried no attribution.
+
 ## Capturing a report
 
-1. On the machine/browser page that reproduces the problem, enable the
-   relevant namespace (see above) and reload.
-2. Reproduce once.
-3. In DevTools, filter the Console for `[dsh-rewind]` and copy the output
+1. Reproduce once on the affected page.
+2. In DevTools, filter the Console for `[dsh-rewind]` and copy the output
    (with the plugin version and the DSH/kernel version).
 
-For a rewind that did not refill the composer, the `refill` scope is what
-matters: its `composer write` line reports whether the draft was restored
-through the harness facade (`facade`) or the DOM fallback (`dom`) and whether
-the write succeeded, which tells a plugin fault apart from a harness-side
-render desync.
+The `error`/`warn` anomaly alerts require no setup — they always print. To also
+capture the startup identity line (`boot`) — useful for ruling out a stale
+bundle / un-restarted host — enable the verbose switch first (see above), then
+reload.
 
 ## Notes
 
-- The switch is an aid for maintainers and cooperating reporters, **not** a
-  stable public interface; its exact keys and output may change without notice.
-- It is scoped to one browser origin and one browser; enable it where the
-  problem actually occurs.
-
-Related: [audit.md](audit.md) for the verified-compatibility matrix and
-[troubleshooting.md](troubleshooting.md) for the legacy repair steps.
+- This diagnostic surface is an aid for maintainers and cooperating reporters,
+  **not** a stable public interface; its exact keys and output may change
+  without notice.
+- It is scoped to one browser origin and one browser; capture where the problem
+  actually occurs.

package/docs/compat/diagnostics.zh.md

@@ -1,44 +1,42 @@
-# 浏览器诊断与详细输出开关
+# 浏览器诊断
 
 [English](diagnostics.md)
 
-本插件在浏览器端输出的所有诊断信息都经由同一条通道，这样可用一个控制台过滤器抓取报告，且无需重建插件即可开启详细输出模式。
+本插件在浏览器端输出的所有诊断信息都经由同一条分级通道，因此异常可在单个控制台过滤器下浮现。该通道**刻意收窄**：只记录插件自身检测到的、偏离预期契约的真实内部异常——**不记录**用户早已在屏幕上看到、且无归因价值的普通路径事实。
 
-## 按作用域前缀输出
+## 常开的异常告警
 
-诊断以 `[dsh-rewind:<scope>] ...` 形式打印。`scope` 标明子系统，同时也正是详细输出开关的过滤依据：
+`error` 与 `warn` **总是打印**（无需开关、无需配置），即使从未配置的用户也能看到故障：
 
-| scope | 报告内容 |
+| 级别 | 含义 |
 | --- | --- |
-| `hiding` | 行隐藏路径（回退切断哪些行；`rewind not hidden` 异常） |
-| `refill` | 回退后的输入框回填（目标 seq、模式、所用通道、写入结果） |
-| `portals` | 每条消息按钮的挂载问题（如无会话绑定） |
-| `settings` | 快照清理设置卡片 |
+| `error` | 意外/破坏性故障（如设置卡片注册失败） |
+| `warn` | 可恢复的异常护栏（如回退命令/回填抛出异常、等待的结果始终未落定、会话绑定缺失） |
 
-## 分级
+这些情形少见、廉价、且偏离契约。普通路径的细节（回填走了哪个分支、写入是否匹配、回退切断哪些行）则**刻意不记录**：它们重复用户已经看到的现象，对归因毫无增量。
 
-| 级别 | 默认 | 含义 |
-| --- | --- | --- |
-| `error` | 开 | 意外/破坏性；总是打印 |
-| `warn` | 开 | 可恢复的异常护栏（`rewind not hidden`、`refill skipped/refused/threw`）；总是打印 |
-| `info` | 关 | 事件级生命周期（每次回退/回填一行） |
-| `debug` | 关 | 开关控制下的追加事件级细节（隐藏集一行，每次回退一行） |
+## 作用域
 
-`error`/`warn` 总是打印，这样即使没碰过开关的用户，异常也会浮现；`info`/`debug` 则受开关控制，保持普通用户控制台干净。两个受控级别都按**相关事件触发一次**（一次回退、一次回填)，不会随流式逐帧打印——所以即使开了详细输出，回退后的会话也不会刷屏。
+诊断以 `[dsh-rewind:<scope>] ...` 形式打印。`scope` 标明异常所属子系统，因此可用单个控制台过滤器抓取报告：
 
-## 开启详细输出
+| scope | 这里的异常含义 |
+| --- | --- |
+| `boot` | 启动身份行——`loaded v<version> (build <hash>)`，由详细输出开关控制（见下）。用于确认运行中的 bundle 是否匹配某个修复。 |
+| `refill` | 回退后的输入框回填（命令/等待/回填抛出异常、等待的结果始终未落定） |
+| `portals` | 每条消息按钮的挂载问题（如无会话绑定） |
+| `settings` | 快照清理设置卡片 |
+| `hiding` | **保留区**——当前无活跃告警。若未来新增行隐藏诊断，应归属此区域。 |
 
-开关位于**浏览器**的 `localStorage`、且使用插件专属键，因此它不会开启其它插件/功能，别的功能也无法唤醒本插件。设置后刷新页面、复现一次，再把控制台按 `[dsh-rewind]` 过滤即可：
+## 详细输出开关
 
-```js
-// 全部 dsh-rewind 命名空间。
-localStorage['dsh-rewind.debug'] = 'dsh-rewind*'
+`info`/`debug` 级别受 `localStorage['dsh-rewind.debug']` 控制，每次调用读取并按命名空间过滤。在撤下那些复述现象的详细输出后，**恰好剩一条** verbose 行：`boot` 作用域的启动身份行。它**默认关闭**（普通用户控制台保持干净，且它不是异常），排查者需先开启该作用域才能看到：
 
-// 或只开所关心的子系统（精确 scope 匹配）。
-localStorage['dsh-rewind.debug'] = 'dsh-rewind:refill'
+```js
+// 仅启动身份行。
+localStorage['dsh-rewind.debug'] = 'dsh-rewind:boot'
 
-// 同时开多个（逗号分隔）。
-localStorage['dsh-rewind.debug'] = 'dsh-rewind:refill,dsh-rewind:hiding'
+// 或全部开启（省去精确 scope）。
+localStorage['dsh-rewind.debug'] = 'dsh-rewind*'
 ```
 
 设置后刷新（`F5`）。关闭：
@@ -47,17 +45,16 @@ localStorage['dsh-rewind.debug'] = 'dsh-rewind:refill,dsh-rewind:hiding'
 delete localStorage['dsh-rewind.debug']
 ```
 
+`error`/`warn` 异常告警**不受**该开关控制——它们总是打印。其余详细输出（所用写入通道、空的隐藏集、每次回退的生命周期行）已撤下：它们重复用户已经看到的现象、无归因增量。
+
 ## 采集一段报告
 
-1. 在**复现问题的那台机器/那个浏览器页面**，开启相应命名空间（见上）并刷新。
-2. 复现一次。
-3. 在 DevTools 里把 Console 按 `[dsh-rewind]` 过滤，复制输出（连同插件版本、DSH/内核版本）。
+1. 在出问题的页面上复现一次。
+2. 在 DevTools 里把 Console 按 `[dsh-rewind]` 过滤，复制输出（连同插件版本、DSH/内核版本）。
 
-对「回退后没回填输入框」这类问题，重点是 `refill` 作用域：其 `composer write` 一行会报告草稿是通过 harness facade（`facade`）还是 DOM 回退（`dom`）恢复、写入是否成功，从而区分「插件没写入」与「harness 侧渲染不同步」。
+`error`/`warn` 异常告警无需任何设置——它们总是打印。若要同时采集启动身份行（`boot`，用于排除「旧 bundle / 宿主未重启」），请先开启详细输出开关（见上），再刷新。
 
 ## 备注
 
-- 该开关是维护者与配合排查者使用的工具，**不是**稳定公开接口；其具体键与输出可能不经通知而改变。
-- 它受单个浏览器 origin、单个浏览器限定；请在实际出问题的地方开启。
-
-相关：[audit.md](audit.md) 为已验证兼容矩阵，[troubleshooting.md](troubleshooting.md) 为历史修复步骤。
+- 该诊断表面是维护者与配合排查者使用的工具，**不是**稳定公开接口；其具体键与输出可能不经通知而改变。
+- 它受单个浏览器 origin、单个浏览器限定；请在实际出问题的地方采集。

package/lib/client.js

@@ -1035,7 +1035,6 @@ async function runRewindAndFill(session, seq, mode, currentSessionId, chatOf, se
     return;
   }
   if (!result.ok || result.value?.matched !== true) {
-    rewindLog.info("refill", `rewind @${seq} not matched, no refill`);
     return;
   }
   let outcome;
@@ -1050,25 +1049,10 @@ async function runRewindAndFill(session, seq, mode, currentSessionId, chatOf, se
     return;
   }
   if (outcome.kind !== "success") {
-    rewindLog.warn("refill", `rewind @${seq} refused`, outcome.text);
     showHint(outcome.text ?? "rewind failed");
     return;
   }
-  const hidSeqs = (() => {
-    const chat = chatOf(session);
-    return chat === void 0 ? /* @__PURE__ */ new Set() : hiddenSeqsOf(chat);
-  })();
-  if (hidSeqs.size === 0) {
-    rewindLog.warn("hiding", `rewind not hidden (target @${seq})`, { target: seq });
-  } else {
-    rewindLog.debug(
-      "hiding",
-      `rewind hides seqs [${[...hidSeqs].slice(0, 20).join(", ")}${hidSeqs.size > 20 ? "\u2026" : ""}]`,
-      { target: seq }
-    );
-  }
   if (currentSessionId() !== session.sessionId) {
-    rewindLog.info("refill", `skipped refill @${seq}: session switched during rewind`);
     return;
   }
   let text;
@@ -1079,21 +1063,17 @@ async function runRewindAndFill(session, seq, mode, currentSessionId, chatOf, se
     return;
   }
   if (text === void 0 || text === "") {
-    rewindLog.info("refill", `skipped refill @${seq}: no editable text`);
     return;
   }
   if (composerText().trim() !== "") {
-    rewindLog.info("refill", `skipped refill @${seq}: composer already has a draft`);
     return;
   }
-  let ok = false;
   try {
-    ok = setComposerText(session.sessionId, text);
+    setComposerText(session.sessionId, text);
   } catch (error) {
     rewindLog.warn("refill", `composer refill @${seq} threw`, error);
     return;
   }
-  rewindLog.info("refill", `rewound to @${seq} (${mode})`, { ok, text: text.slice(0, 80) });
 }
 function composerSurface() {
   return document.querySelector(COMPOSER_TEXTAREA_SELECTOR) ?? document.querySelector(COMPOSER_EDITABLE_SELECTOR);
@@ -1358,6 +1338,10 @@ function createRewindBridge(deps) {
   };
 }
 
+// src/client/build-info.ts
+var PLUGIN_VERSION = true ? "0.7.3" : "dev";
+var BUILD_HASH = true ? "0752e2ff" : "dev";
+
 // src/client/locales.ts
 var zh = {
   "button.aria": "\u56DE\u9000\u5230\u6B64\u6D88\u606F",
@@ -1617,6 +1601,7 @@ var HEADER_ACTIONS_SLOT = "conversation.session.header.actions";
 var COMPOSER_TEXTAREA_SELECTOR2 = "[data-input-scroll] textarea, textarea[data-phase]";
 var COMPOSER_EDITABLE_SELECTOR2 = "[data-composer-input]";
 function apply(ctx) {
+  rewindLog.info("boot", `loaded v${PLUGIN_VERSION} (build ${BUILD_HASH})`);
   ctx.effect(function* () {
     yield ctx.locale.register(NS2, { zh, en });
     const t = ctx.locale.bind(NS2);
@@ -1650,7 +1635,6 @@ function apply(ctx) {
             input.for(scope).setDraft(draft);
           } } : void 0
         );
-        rewindLog.info("refill", "composer write", { channel: facade ? "facade" : "dom", ok });
         return ok;
       } catch (error) {
         rewindLog.warn("refill", "composer write threw", error);

package/lib/types/client/build-info.d.ts

@@ -0,0 +1,19 @@
+/**
+ * dsh-rewind client build identity.
+ *
+ * Two constants are injected by `scripts/build.mjs` at esbuild time (see the
+ * `define` block there) and are NOT present in the source. They answer the
+ * "am I even running the fixed bundle?" question — the most common, cheapest
+ * root cause to rule in/out when a report lands:
+ *   - `__DSH_REWIND_VERSION__` — the plugin version from `package.json`.
+ *   - `__DSH_REWIND_BUILD__`   — a short content hash of the client source.
+ *
+ * They are read once at module load and surfaced (behind the existing
+ * `dsh-rewind.debug` switch, never a new key) by `apply` in `index.ts`.
+ *
+ * @module dsh-rewind/client/build-info
+ */
+/** Plugin version baked in at build time (from `package.json`). */
+export declare const PLUGIN_VERSION: string;
+/** Short content hash of the client source, for stale-bundle detection. */
+export declare const BUILD_HASH: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-rewind-plugin",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "DSH 插件：真正便捷无感的同窗口内对话回退，从不新建分支；自带轻量工作区备份，可一并还原文件（完整 Claude Code /rewind 语义）。 · DSH plugin: genuinely effortless in-window conversation rewind — never forking a new session; ships a lightweight workspace backup that restores files together with the rewind (full Claude Code /rewind semantics).",
   "keywords": [
     "deepseek-harness",