dsh-rewind-plugin 0.7.1 → 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

@@ -145,6 +145,9 @@ dsh plugin --profile web add dsh-rewind-plugin
 4. **v0.3.3 及更早版本**回退过的会话，压缩对话（compact）不可用。新版本已兼容；受影响的旧会话建议新建会话。
 5. **导轨显示已回退轮次**——DSH `v0.1.2-alpha.1` 新增的右侧导轨，会为已撤回消息保留刻度：点击不跳转、悬浮显示已撤回正文。仅显示差异，无功能影响。
 
+> [!NOTE]
+> 本插件提供浏览器端诊断输出；详见 [浏览器诊断](docs/compat/diagnostics.zh.md)。
+
 ## 安全
 
 本插件只向会话日志追加回退标记事件，从不删除或改写已记录的历史。工作区文件仅在「回退对话和代码」时被改写，备份存储于 `~/.dsh/rewind-snapshots/`；还原以备份为唯一来源。不触碰你的 git 仓库，无网络请求，不访问任何凭据。对**长期不活跃**的会话，另有默认关闭的全局自动清理可整目录移除其快照，不影响活动会话与对话日志。完整安全模型：[SECURITY.md](SECURITY.md)。

package/docs/README.md

@@ -15,6 +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 (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

@@ -0,0 +1,85 @@
+# Browser diagnostics
+
+[简体中文](diagnostics.zh.md)
+
+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.
+
+## Always-on anomaly alerts
+
+`error` and `warn` are always printed (no switch, no configuration) so a fault
+surfaces even for a user who never configured anything:
+
+| Level | Meaning |
+| --- | --- |
+| `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) |
+
+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.
+
+## Scopes
+
+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:
+
+| 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. |
+
+## Verbose switch
+
+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:
+
+```js
+// Just the startup identity line.
+localStorage['dsh-rewind.debug'] = 'dsh-rewind:boot'
+
+// Or everything (avoids needing an exact scope).
+localStorage['dsh-rewind.debug'] = 'dsh-rewind*'
+```
+
+Reload (`F5`) after setting it. To switch it off:
+
+```js
+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. 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).
+
+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
+
+- 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

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

package/lib/client.js

@@ -650,8 +650,8 @@ async function previewImpact(session, chatOf, seq) {
   if (!result.ok || result.value?.matched !== true) return null;
   return waitForCommand(session, chatOf, (node) => isPreviewFor(node, seq) && !known.has(node.seq));
 }
-function el(tag, className, text) {
-  const node = document.createElement(tag);
+function el(tag2, className, text) {
+  const node = document.createElement(tag2);
   node.className = className;
   if (text !== void 0) node.textContent = text;
   return node;
@@ -931,6 +931,48 @@ function retractSpan(steering, targetId) {
   return steering.slice(index).map((item) => item.id);
 }
 
+// src/client/log.ts
+var NS = "dsh-rewind";
+var DEBUG_KEY = "dsh-rewind.debug";
+var ALWAYS_ON = /* @__PURE__ */ new Set(["error", "warn"]);
+function switchValue() {
+  try {
+    return window.localStorage.getItem(DEBUG_KEY) ?? "";
+  } catch {
+    return "";
+  }
+}
+function matches(value, ns) {
+  for (const entry of value.split(",")) {
+    const part = entry.trim();
+    if (part === "") continue;
+    if (part === "*" || part === `${NS}*`) return true;
+    if (part.endsWith("*")) {
+      if (ns.startsWith(part.slice(0, -1))) return true;
+    } else if (ns === part) {
+      return true;
+    }
+  }
+  return false;
+}
+function tag(scope) {
+  return `[${NS}:${scope}]`;
+}
+function log(level, scope, message, data) {
+  if (ALWAYS_ON.has(level)) {
+    console[level](tag(scope), message, data);
+    return;
+  }
+  if (!matches(switchValue(), `${NS}:${scope}`)) return;
+  console.info(tag(scope), message, data);
+}
+var rewindLog = {
+  error: (scope, message, data) => log("error", scope, message, data),
+  warn: (scope, message, data) => log("warn", scope, message, data),
+  info: (scope, message, data) => log("info", scope, message, data),
+  debug: (scope, message, data) => log("debug", scope, message, data)
+};
+
 // src/client/portals.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
 function fillComposerTextarea(text) {
@@ -985,18 +1027,53 @@ function userNodeOf(chat, key) {
 }
 async function runRewindAndFill(session, seq, mode, currentSessionId, chatOf, setComposerText) {
   const known = knownCommandSeqs(session, chatOf, (node) => isExecutedRewindCommand(node, seq));
-  const result = await session.command(`/rewind @${seq} ${mode}`);
-  if (!result.ok || result.value?.matched !== true) return;
-  const outcome = await waitForCommand(session, chatOf, (node) => isExecutedRewindCommand(node, seq) && !known.has(node.seq), 2e4);
-  if (outcome === null) return;
+  let result;
+  try {
+    result = await session.command(`/rewind @${seq} ${mode}`);
+  } catch (error) {
+    rewindLog.warn("refill", `rewind command threw, skipping refill @${seq}`, error);
+    return;
+  }
+  if (!result.ok || result.value?.matched !== true) {
+    return;
+  }
+  let outcome;
+  try {
+    outcome = await waitForCommand(session, chatOf, (node) => isExecutedRewindCommand(node, seq) && !known.has(node.seq), 2e4);
+  } catch (error) {
+    rewindLog.warn("refill", `waiting for rewind @${seq} outcome threw`, error);
+    return;
+  }
+  if (outcome === null) {
+    rewindLog.warn("refill", `rewind @${seq} never settled within timeout, no refill`);
+    return;
+  }
   if (outcome.kind !== "success") {
     showHint(outcome.text ?? "rewind failed");
     return;
   }
-  if (currentSessionId() !== session.sessionId) return;
-  const text = messageTextAt(chatOf(session), seq);
-  if (text === void 0 || text === "") return;
-  setComposerText(session.sessionId, text);
+  if (currentSessionId() !== session.sessionId) {
+    return;
+  }
+  let text;
+  try {
+    text = messageTextAt(chatOf(session), seq);
+  } catch (error) {
+    rewindLog.warn("refill", `reading target text for @${seq} threw`, error);
+    return;
+  }
+  if (text === void 0 || text === "") {
+    return;
+  }
+  if (composerText().trim() !== "") {
+    return;
+  }
+  try {
+    setComposerText(session.sessionId, text);
+  } catch (error) {
+    rewindLog.warn("refill", `composer refill @${seq} threw`, error);
+    return;
+  }
 }
 function composerSurface() {
   return document.querySelector(COMPOSER_TEXTAREA_SELECTOR) ?? document.querySelector(COMPOSER_EDITABLE_SELECTOR);
@@ -1092,40 +1169,6 @@ function sameTargets(left, right) {
     return other.kind === "pending" && target.itemId === other.itemId;
   });
 }
-function hasExecutedRewindCommand(chat) {
-  for (const key of chat.order) {
-    const node = chat.nodes.get(key);
-    if (node === void 0 || node.kind !== "command") continue;
-    const command = node.data;
-    if (command.name !== "rewind") continue;
-    const args = command.args ?? "";
-    if (args.includes("preview") || args.includes("__candidates")) continue;
-    return true;
-  }
-  return false;
-}
-function describeHiding(chat, hiddenSeqs) {
-  const commands = [];
-  for (const key of chat.order) {
-    const node = chat.nodes.get(key);
-    if (node === void 0 || node.kind !== "command") continue;
-    const c = node.data;
-    commands.push(`#${c.seq} name=${c.name} outcome=${c.outcome?.kind ?? "-"} marker=${c.outcome?.sourceEventSeq ?? "-"} args=${JSON.stringify(c.args)}`);
-  }
-  const scoped = hiddenSeqs.size > 0 ? `hidden=[${[...hiddenSeqs].slice(0, 20).join(",")}${hiddenSeqs.size > 20 ? "\u2026" : ""}]` : "";
-  let seats = 0;
-  let resolved = 0;
-  let inHidden = 0;
-  for (const seat of document.querySelectorAll(CHAT_SEAT_SELECTOR)) {
-    seats += 1;
-    const key = seat.dataset.chatAnchorKey;
-    const node = key === void 0 ? void 0 : chat.nodes.get(key);
-    if (node === void 0) continue;
-    resolved += 1;
-    if (hiddenSeqs.has(node.anchorSeq)) inHidden += 1;
-  }
-  return `commands=[${commands.join(" | ")}] ${scoped} seats=${seats} resolved=${resolved} inHidden=${inHidden}`;
-}
 function RewindPortals({ sessionId, sessionOf, chatOf, currentSessionId, t, subscribeLocale, setComposerText }) {
   const [targets, setTargets] = (0, import_react.useState)([]);
   const hidden = (0, import_react.useRef)(/* @__PURE__ */ new WeakSet());
@@ -1146,7 +1189,6 @@ function RewindPortals({ sessionId, sessionOf, chatOf, currentSessionId, t, subs
       const snapshot = session.getSnapshot();
       const chat = chatOf(session);
       const hiddenSeqs = chat === void 0 ? /* @__PURE__ */ new Set() : hiddenSeqsOf(chat);
-      let hiddenCount = 0;
       for (const seat of chat === void 0 ? [] : document.querySelectorAll(CHAT_SEAT_SELECTOR)) {
         const key = seat.dataset.chatAnchorKey;
         const anchor = key !== void 0 ? chat?.nodes.get(key)?.anchorSeq : void 0;
@@ -1154,21 +1196,12 @@ function RewindPortals({ sessionId, sessionOf, chatOf, currentSessionId, t, subs
           seat.style.display = "none";
           seat.dataset.dshRewindHidden = "true";
           hidden.current.add(seat);
-          hiddenCount += 1;
         } else if (hidden.current.has(seat)) {
           seat.style.display = "";
           delete seat.dataset.dshRewindHidden;
           hidden.current.delete(seat);
         }
       }
-      if (hiddenSeqs.size > 0 || hiddenCount > 0) {
-        console.info(
-          `[dsh-rewind] hiding: ${hiddenCount} rows, seqs [${[...hiddenSeqs].slice(0, 20).join(", ")}${hiddenSeqs.size > 20 ? "\u2026" : ""}]`
-        );
-      }
-      if (chat !== void 0 && hiddenCount === 0 && hasExecutedRewindCommand(chat)) {
-        console.warn(`[dsh-rewind] rewind not hidden: ${describeHiding(chat, hiddenSeqs)}`);
-      }
       const durable = chat === void 0 ? [] : collectTargets(chat, hiddenSeqs);
       const next = [...durable, ...collectPendingTargets(snapshot)];
       setTargets((current) => sameTargets(current, next) ? current : next);
@@ -1223,7 +1256,7 @@ function RewindButton({ target, sessionId, sessionOf, chatOf, currentSessionId,
     event.stopPropagation();
     const session = sessionOf(sessionId);
     if (session === void 0) {
-      console.warn("[dsh-rewind] rewind button clicked with no session binding");
+      rewindLog.warn("portals", "rewind button clicked with no session binding");
       return;
     }
     const node = userNodeOf(chatOf(session), target.key);
@@ -1305,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",
@@ -1559,14 +1596,15 @@ function SettingsCleanupCard({ api, t }) {
 // src/client/index.ts
 var name = "dsh-rewind";
 var inject = ["slots", "sessions", "locale", "commandUi"];
-var NS = "rewind";
+var NS2 = "rewind";
 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(NS, { zh, en });
-    const t = ctx.locale.bind(NS);
+    yield ctx.locale.register(NS2, { zh, en });
+    const t = ctx.locale.bind(NS2);
     const style = document.createElement("style");
     style.dataset.plugin = "dsh-rewind";
     style.textContent = STYLE;
@@ -1586,15 +1624,22 @@ function apply(ctx) {
       }
     };
     const setComposerText = (sessionId, text) => {
-      const conversation = ctx.get("conversation");
-      const input = conversation?.input;
-      const scope = ctx.sessions.scope?.(sessionId);
-      return writeComposer(
-        text,
-        input !== void 0 && scope !== void 0 ? { setDraft: (draft) => {
-          input.for(scope).setDraft(draft);
-        } } : void 0
-      );
+      try {
+        const conversation = ctx.get("conversation");
+        const input = conversation?.input;
+        const scope = ctx.sessions.scope?.(sessionId);
+        const facade = input !== void 0 && scope !== void 0;
+        const ok = writeComposer(
+          text,
+          facade ? { setDraft: (draft) => {
+            input.for(scope).setDraft(draft);
+          } } : void 0
+        );
+        return ok;
+      } catch (error) {
+        rewindLog.warn("refill", "composer write threw", error);
+        return false;
+      }
     };
     const slots = ctx.slots;
     yield slots.inject(HEADER_ACTIONS_SLOT, () => slots.register(
@@ -1632,13 +1677,13 @@ function apply(ctx) {
             // Match the official cards / dsh-market: locale + inject provide
             // the card its props through the slot renderer (the keyed card owns
             // its internals, but the page feeds it locale + the bound api).
-            locale: NS,
+            locale: NS2,
             inject: () => ({ t, api: cardApi })
           },
           SettingsCleanupCard
         ));
       } catch (error) {
-        console.error("[dsh-rewind] settings card register failed:", error);
+        rewindLog.error("settings", "settings card register failed", error);
       }
     });
     const commandUi = ctx.get("commandUi");

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/lib/types/client/log.d.ts

@@ -0,0 +1,43 @@
+/**
+ * dsh-rewind client logger: a single, namespaced, level-filtered logging
+ * channel for every browser-side diagnostic in this plugin.
+ *
+ * Design (industry-normal layering, kept dependency-free):
+ * - `error` / `warn` are ALWAYS emitted (they are the anomaly guard: rare,
+ *   cheap, and must surface even for a user who never touched the switch).
+ * - `info` / `debug` are gated by a DEBUG switch and further filtered by
+ *   namespace, so verbose detail never floods a normal user's console.
+ *
+ * The DEBUG switch is a runtime, per-origin knob read from
+ * `localStorage['dsh-rewind.debug']` — the convention-debug-scan pattern
+ * (namespace match, comma-separated, `*` wildcard), scoped to an
+ * exclusively-own key so it can never enable any other plugin/feature and no
+ * other feature can wake this one. Because it is read on every call (never
+ * cached), flipping it and reloading takes effect on any published build
+ * without a plugin rebuild.
+ *
+ * Values accepted by the switch (empty/unset = off):
+ * - `dsh-rewind*`  — every dsh-rewind namespace.
+ * - `dsh-rewind:refill` — just one subsystem (exact match).
+ * - `dsh-rewind:refill,dsh-rewind:hiding` — several (comma-separated).
+ *
+ * @module dsh-rewind/client/log
+ */
+export type LogLevel = 'error' | 'warn' | 'info' | 'debug';
+/**
+ * Emit one diagnostic line. `error`/`warn` always print; `info`/`debug` print
+ * only when the DEBUG switch selects the namespace. Both gated levels are
+ * routed to the always-visible `console.info` rather than `console.debug`,
+ * whose "Verbose" level Chrome filters out by default — otherwise a reporter
+ * who turns the switch on still would not see the line without also changing
+ * the DevTools level filter (mapped to `console.debug`). `data` is spread last
+ * so DevTools' structured view keeps it inspectable (never stringified).
+ */
+export declare function log(level: LogLevel, scope: string, message: string, data?: unknown): void;
+/** Convenience shorthands (typed so call sites read cleanly). */
+export declare const rewindLog: {
+    readonly error: (scope: string, message: string, data?: unknown) => void;
+    readonly warn: (scope: string, message: string, data?: unknown) => void;
+    readonly info: (scope: string, message: string, data?: unknown) => void;
+    readonly debug: (scope: string, message: string, data?: unknown) => void;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-rewind-plugin",
-  "version": "0.7.1",
+  "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",