dsh-rewind-plugin 0.7.3 → 0.7.5

package/README.en.md

@@ -3,7 +3,7 @@
 Conversation rewind for DeepSeek Harness: **rewind the conversation to any earlier user message in one click, in the same window** — no new branch, no window switch, with optional workspace-file restore (full Claude Code `/rewind` semantics).
 
 [![npm version](https://img.shields.io/npm/v/dsh-rewind-plugin.svg)](https://www.npmjs.com/package/dsh-rewind-plugin)
-[![npm downloads](https://img.shields.io/npm/dm/dsh-rewind-plugin.svg)](https://www.npmjs.com/package/dsh-rewind-plugin)
+[![npm downloads](https://img.shields.io/npm/dt/dsh-rewind-plugin.svg)](https://www.npmjs.com/package/dsh-rewind-plugin)
 [![tests](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FSiriLee%2Fdb3b9260351c2b26eb3d201c2ed29df1%2Fraw%2Fbadge.json)](https://github.com/SiriLee/dsh-rewind/actions/workflows/ci.yml)
 
 > English | [中文](README.md)

package/README.md

@@ -3,7 +3,7 @@
 DeepSeek Harness 插件：**一键就地回退对话到任意更早的用户消息**——同窗口内完成，不新建分支、不换窗口，可一并还原工作区文件（完整 Claude Code `/rewind` 语义）。
 
 [![npm version](https://img.shields.io/npm/v/dsh-rewind-plugin.svg)](https://www.npmjs.com/package/dsh-rewind-plugin)
-[![npm downloads](https://img.shields.io/npm/dm/dsh-rewind-plugin.svg)](https://www.npmjs.com/package/dsh-rewind-plugin)
+[![npm downloads](https://img.shields.io/npm/dt/dsh-rewind-plugin.svg)](https://www.npmjs.com/package/dsh-rewind-plugin)
 [![tests](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2FSiriLee%2Fdb3b9260351c2b26eb3d201c2ed29df1%2Fraw%2Fbadge.json)](https://github.com/SiriLee/dsh-rewind/actions/workflows/ci.yml)
 
 > [English](README.en.md) | 中文

package/docs/compat/audit.md

@@ -7,30 +7,29 @@
 > compatibility invariants. A probe failure is a finding; it enters the
 > fix/pin/record loop.
 >
-> Targeted version: npm `@deepseek-ai/*@0.1.1-rc.2` (matches `package-lock.json`);
-> source reference: the `oss/deepseek-harness` local fork.
+> Targeted version: npm `@deepseek-ai/*@0.1.1-rc.2` (matches `package-lock.json`).
+> Source reference: the upstream [github.com/deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness).
 >
 > Version alignment: `peerDependencies` use an OR-union (e.g.
 > `^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2`) covering each published tuple series. npm's
 > prerelease matching rules require a candidate to share the range comparator's
-> `[major, minor, patch]` tuple, so each new tuple series (e.g. a future
-> `0.1.2-rc.x`, `0.2.x`) requires appending a union member; rc rolling within a
-> tuple (`0.1.1-rc.2 → rc.3`) is a no-op. Signal: `npm view @deepseek-ai/dsh version`;
+> `[major, minor, patch]` tuple, so appending is needed only for a genuinely new
+> tuple (e.g. a future `0.2.x`); any prerelease within the SAME tuple (alpha → rc)
+> is a no-op. Signal: `npm view @deepseek-ai/dsh version`;
 > flow: `scripts/check-dsh-version.mjs` (it reads the `latest` dist-tag only; a
 > `-alpha` prerelease published under another tag, e.g. `0.1.2-alpha.2` under
 > `alpha`, is a manual pre-release check).
 >
 > `0.1.2-alpha.1` was never published to npm, so the peer OR-union is declared only from `0.1.2-alpha.2`; the plugin code still supports the `alpha.1`+ client.
 >
-> `0.1.2-alpha.2` … `0.1.2-alpha.4` verified-compatible. Built/tested on the rc.2
-> baseline (the `latest` dist-tag); the same published build also drives the alpha
-> line, and `alpha.2`/`alpha.3`/`alpha.4` share the `0.1.2` tuple, so the single
-> `^0.1.2-alpha.2` peer member covers all three. `rc.2` (`latest`) remains the
-> primary baseline; four versions verified: rc.2, alpha.2, alpha.3, alpha.4.
+> `0.1.2-alpha.2` … `0.1.2-alpha.5` and `0.1.2-rc.1` verified-compatible; `rc.1` is
+> source-identical to `alpha.5`. They share the `0.1.2` tuple, so the single
+> `^0.1.2-alpha.2` peer member covers all six. `rc.2` (`latest`) stays the primary
+> baseline; verified: rc.2, alpha.2, alpha.3, alpha.4, alpha.5, rc.1.
 
 ### Channeled seams (version × channel)
 
-| Seam | rc.2 (`0.1.1-rc.2`) | alpha.2 / alpha.3 | alpha.4 |
+| Seam | rc.2 (`0.1.1-rc.2`) | alpha.2 / alpha.3 | alpha.4 / alpha.5 / rc.1 |
 | --- | --- | --- | --- |
 | Host session log (`eventsOf`) | `Session.events` | `Session.events` | `session.snapshotEvents()` |
 | Client chat snapshot (`chatSnapshotOf`) | session-face `chat` field | `uiConversation` `chat` view | `uiConversation` `chat` view |

package/docs/contract/client-contract.md

@@ -21,7 +21,7 @@ the plugin itself uses (it never reads the DOM or host copy):
 ```ts
 import { hiddenSeqsOf, type HiddenChat } from 'dsh-rewind-plugin/client'
 
-const chat = session.getSnapshot().chat // rc.2 source; 0.1.2-alpha.1+ uses the uiConversation "chat" view
+const chat = session.getSnapshot().chat // rc.2 source; 0.1.2-rc.1 uses the uiConversation "chat" view
 const hidden = hiddenSeqsOf(chat as HiddenChat) // Set<number> of anchor seqs
 ```
 

package/docs/contract/client-contract.zh.md

@@ -20,7 +20,7 @@
 ```ts
 import { hiddenSeqsOf, type HiddenChat } from 'dsh-rewind-plugin/client'
 
-const chat = session.getSnapshot().chat // rc.2 来源；0.1.2-alpha.1+ 用 uiConversation "chat" 视图
+const chat = session.getSnapshot().chat // rc.2 来源；0.1.2-rc.1 用 uiConversation "chat" 视图
 const hidden = hiddenSeqsOf(chat as HiddenChat) // 被隐藏的 anchor seq 集合
 ```
 

package/docs/harness-reference.md

@@ -1,8 +1,7 @@
 # DeepSeek Harness interface reference
 
 > Maintainer doc: the harness subsystems this plugin depends on, and the key
-> source files behind each interface. Local fork (if present):
-> `<workspace>/oss/deepseek-harness/` — official repo:
+> source files behind each interface. Official repo:
 > [github.com/deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness)
 
 ## Subsystem docs (`docs/subsystems/`)

package/docs/release/release.md

@@ -61,6 +61,9 @@ uses an OR-union covering every published tuple series
   (`0.1.1 → 0.1.2 → 0.2.x`); rc rolling within a tuple (`0.1.1-rc.2 → rc.3`)
   needs nothing. All `@deepseek-ai/*` packages release together;
   `npm view @deepseek-ai/dsh version` is the authoritative signal.
+- **Exception — `@deepseek-ai/dsh-client-runtime`**: it never published a
+  `0.1.2-alpha.*` (npm `next` is `0.1.1-rc.2`) and is imported `import type`
+  only, so keep it at `^0.1.0-rc.6 || ^0.1.1-rc.2` (no `0.1.2` member).
 - **Published-tuple check (optional)**: `node scripts/check-dsh-version.mjs`
   compares the `latest` dist-tag version against the tuples the peers cover
   (exit 0 = nothing to do, exit 1 = update). It reads the `latest` tag only; a

package/docs/release/release.zh.md

@@ -55,6 +55,9 @@ OR 并集覆盖 DSH 已发布的每个元组系列（如 `^0.1.0-rc.6 || ^0.1.1-
 - **何时需要更新**：仅当 DSH 发布新元组（`0.1.1 → 0.1.2 → 0.2.x`）时；
   同元组内 rc 滚动（`0.1.1-rc.2 → rc.3`）无需动作。DSH 所有包同版本发布，
   `npm view @deepseek-ai/dsh version` 即权威信号。
+- **例外 —— `@deepseek-ai/dsh-client-runtime`**：它从未发布 `0.1.2-alpha.*`
+  （npm `next` 为 `0.1.1-rc.2`）且仅被 `import type` 引用，保持
+  `^0.1.0-rc.6 || ^0.1.1-rc.2` 即可（无 `0.1.2` 元组项）。
 - **已发布元组检查（可选）**：`node scripts/check-dsh-version.mjs` 用 npm `latest`
   dist-tag 版本对比 peer 覆盖的元组（exit 0 无需动作，exit 1 需要）。它**只读
   `latest` tag**；发布在其它 tag（如 `alpha`）的 pre-release 走**手动发布前检查**

package/lib/client.js

@@ -35,6 +35,13 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/client/hidden.ts
+function resolveChatWatch(resolveView, resolveFace, sessionId, cb) {
+  const view = resolveView(sessionId);
+  if (view?.subscribe !== void 0) return view.subscribe(cb);
+  const face = resolveFace(sessionId);
+  return face?.subscribe(cb) ?? (() => {
+  });
+}
 function chatSnapshotOf(face, chatView) {
   const legacy = face?.getSnapshot().chat;
   if (legacy !== void 0) return legacy;
@@ -321,6 +328,12 @@ var STYLE = `
 }
 
 /* ---- Snapshot-cleanup settings card (mirrors the harness PluginCard look) ---- */
+/* Dual-channel note: the harness card corner/border drifted across versions \u2014
+   0.1.1-rc.2 uses border-radius 12px + 1px solid border-l2, while 0.1.2-rc.1
+   uses 16px + 0.5px border-l4 (and adds corner-shape: round). We intentionally
+   keep the 0.1.1-rc.2 values here for now; if the 0.1.2-rc.1 look is wanted,
+   switch these on the host version like the other dual-channel surfaces (see the
+   host-version probe in src/client/index.ts). */
 .dsh-rewind-cleanup-card {
   list-style: none;
   border: 1px solid var(--dsw-alias-border-l2);
@@ -619,7 +632,7 @@ function knownCommandSeqs(session, chatOf, match) {
   }
   return known;
 }
-function waitForCommand(session, chatOf, match, timeoutMs = 8e3) {
+function waitForCommand(session, chatOf, match, timeoutMs = 8e3, watch) {
   return new Promise((resolve) => {
     let settled = false;
     const settle = (value) => {
@@ -635,7 +648,7 @@ function waitForCommand(session, chatOf, match, timeoutMs = 8e3) {
         settle({ kind: node.outcome.kind, text: node.outcome.text });
       }
     };
-    const unsubscribe = session.subscribe(check);
+    const unsubscribe = (watch ?? ((cb) => session.subscribe(cb)))(check);
     const timer = setTimeout(() => settle(null), timeoutMs);
     check();
   });
@@ -644,11 +657,11 @@ function isPreviewFor(node, seq) {
   const args = node.args ?? "";
   return node.name === "rewind" && args.includes("preview") && new RegExp(`(?:^|\\s)@${seq}(?=\\s|$)`).test(args);
 }
-async function previewImpact(session, chatOf, seq) {
+async function previewImpact(session, chatOf, seq, watch) {
   const known = knownCommandSeqs(session, chatOf, (node) => isPreviewFor(node, seq));
   const result = await session.command(`/rewind preview @${seq} both`);
   if (!result.ok || result.value?.matched !== true) return null;
-  return waitForCommand(session, chatOf, (node) => isPreviewFor(node, seq) && !known.has(node.seq));
+  return waitForCommand(session, chatOf, (node) => isPreviewFor(node, seq) && !known.has(node.seq), 8e3, watch);
 }
 function el(tag2, className, text) {
   const node = document.createElement(tag2);
@@ -699,7 +712,7 @@ function renderImpactStep(root, opts, back, cached) {
   root.replaceChildren(impact, actions);
   focusFirst(root);
   void (async () => {
-    const outcome = cached ?? await previewImpact(session, opts.chatOf, seq);
+    const outcome = cached ?? await previewImpact(session, opts.chatOf, seq, (cb) => opts.watchChat(session.sessionId, cb));
     if (outcome === null) {
       impact.textContent = t("popover.impact.failed", { message: "preview command failed or timed out" });
       return;
@@ -821,7 +834,7 @@ function openPopover(opts) {
   const { session, seq, time, preview, anchor, t, chatOf } = opts;
   const onRewind = opts.onRewind;
   if (seq === void 0 || time === void 0 || onRewind === void 0) return;
-  const durableOpts = { session, seq, time, preview, anchor, t, chatOf, onRewind };
+  const durableOpts = { session, seq, time, preview, anchor, t, chatOf, watchChat: opts.watchChat, onRewind };
   const root = el("div", CLASS.popover);
   root.setAttribute("role", "dialog");
   root.setAttribute("aria-label", t("popover.title"));
@@ -891,7 +904,7 @@ function openPopover(opts) {
   popoverEl = root;
   disposeOutside = shell.dispose;
   void (async () => {
-    const outcome = await previewImpact(session, chatOf, seq);
+    const outcome = await previewImpact(session, chatOf, seq, (cb) => opts.watchChat(session.sessionId, cb));
     impactOutcome = outcome;
     if (outcome !== null && outcome.kind === "success") {
       bothState = { state: hasFileImpact(outcome.text) ? "hasChanges" : "noChanges" };
@@ -1025,7 +1038,7 @@ function userNodeOf(chat, key) {
   if (node === void 0 || node.kind !== "user" && node.kind !== "steering") return void 0;
   return node.data;
 }
-async function runRewindAndFill(session, seq, mode, currentSessionId, chatOf, setComposerText) {
+async function runRewindAndFill(session, seq, mode, currentSessionId, chatOf, watchChat, setComposerText) {
   const known = knownCommandSeqs(session, chatOf, (node) => isExecutedRewindCommand(node, seq));
   let result;
   try {
@@ -1039,7 +1052,7 @@ async function runRewindAndFill(session, seq, mode, currentSessionId, chatOf, se
   }
   let outcome;
   try {
-    outcome = await waitForCommand(session, chatOf, (node) => isExecutedRewindCommand(node, seq) && !known.has(node.seq), 2e4);
+    outcome = await waitForCommand(session, chatOf, (node) => isExecutedRewindCommand(node, seq) && !known.has(node.seq), 2e4, (cb) => watchChat(session.sessionId, cb));
   } catch (error) {
     rewindLog.warn("refill", `waiting for rewind @${seq} outcome threw`, error);
     return;
@@ -1103,8 +1116,9 @@ function actionsContainerOf(row) {
   const root = row?.matches(ACTIONS_ROOT_SELECTOR) ? row : row?.querySelector(ACTIONS_ROOT_SELECTOR);
   const actions = root?.lastElementChild;
   if (actions instanceof HTMLElement && actions.querySelector("button") !== null) return actions;
-  const copy = row?.querySelector("button");
-  const structural = copy?.parentElement;
+  const buttons = Array.from(row?.querySelectorAll("button") ?? []);
+  const lastButton = buttons.filter((button) => !button.classList.contains(CLASS.button)).at(-1);
+  const structural = lastButton?.parentElement;
   if (structural instanceof HTMLElement && structural.querySelector("button") !== null) return structural;
   return void 0;
 }
@@ -1169,7 +1183,7 @@ function sameTargets(left, right) {
     return other.kind === "pending" && target.itemId === other.itemId;
   });
 }
-function RewindPortals({ sessionId, sessionOf, chatOf, currentSessionId, t, subscribeLocale, setComposerText }) {
+function RewindPortals({ sessionId, sessionOf, chatOf, currentSessionId, watchChat, t, subscribeLocale, setComposerText }) {
   const [targets, setTargets] = (0, import_react.useState)([]);
   const hidden = (0, import_react.useRef)(/* @__PURE__ */ new WeakSet());
   const [, forceRender] = (0, import_react.useReducer)((count) => count + 1, 0);
@@ -1230,6 +1244,7 @@ function RewindPortals({ sessionId, sessionOf, chatOf, currentSessionId, t, subs
         sessionId,
         sessionOf,
         chatOf,
+        watchChat,
         setComposerText,
         t
       },
@@ -1241,6 +1256,7 @@ function RewindPortals({ sessionId, sessionOf, chatOf, currentSessionId, t, subs
         sessionId,
         sessionOf,
         chatOf,
+        watchChat,
         currentSessionId,
         setComposerText,
         t
@@ -1251,7 +1267,7 @@ function RewindPortals({ sessionId, sessionOf, chatOf, currentSessionId, t, subs
     target.key
   ));
 }
-function RewindButton({ target, sessionId, sessionOf, chatOf, currentSessionId, setComposerText, t }) {
+function RewindButton({ target, sessionId, sessionOf, chatOf, watchChat, currentSessionId, setComposerText, t }) {
   const onClick = (event) => {
     event.stopPropagation();
     const session = sessionOf(sessionId);
@@ -1264,13 +1280,14 @@ function RewindButton({ target, sessionId, sessionOf, chatOf, currentSessionId,
     openPopover({
       session,
       chatOf,
+      watchChat,
       seq: node.seq,
       time: node.time,
       preview: messagePreviewOf(node),
       anchor: event.currentTarget,
       t,
       onRewind: (mode) => {
-        void runRewindAndFill(session, node.seq, mode, currentSessionId, chatOf, setComposerText);
+        void runRewindAndFill(session, node.seq, mode, currentSessionId, chatOf, watchChat, setComposerText);
       }
     });
   };
@@ -1303,7 +1320,7 @@ async function retractPending(session, itemId, text, setComposerText) {
     setComposerText(session.sessionId, text);
   }
 }
-function RetractButton({ target, sessionId, sessionOf, chatOf, setComposerText, t }) {
+function RetractButton({ target, sessionId, sessionOf, chatOf, watchChat, setComposerText, t }) {
   const onClick = (event) => {
     event.stopPropagation();
     const session = sessionOf(sessionId);
@@ -1311,6 +1328,7 @@ function RetractButton({ target, sessionId, sessionOf, chatOf, setComposerText,
     openPopover({
       session,
       chatOf,
+      watchChat,
       preview: target.preview,
       anchor: event.currentTarget,
       t,
@@ -1339,8 +1357,8 @@ function createRewindBridge(deps) {
 }
 
 // src/client/build-info.ts
-var PLUGIN_VERSION = true ? "0.7.3" : "dev";
-var BUILD_HASH = true ? "0752e2ff" : "dev";
+var PLUGIN_VERSION = true ? "0.7.5" : "dev";
+var BUILD_HASH = true ? "25e8b3ca" : "dev";
 
 // src/client/locales.ts
 var zh = {
@@ -1641,6 +1659,18 @@ function apply(ctx) {
         return false;
       }
     };
+    const watchChat = (sessionId, cb) => resolveChatWatch(
+      (id) => {
+        try {
+          return uiConversation()?.binding(id).target(CHAT_VIEW);
+        } catch {
+          return void 0;
+        }
+      },
+      (id) => sessionOf(id),
+      sessionId,
+      cb
+    );
     const slots = ctx.slots;
     yield slots.inject(HEADER_ACTIONS_SLOT, () => slots.register(
       {
@@ -1650,7 +1680,7 @@ function apply(ctx) {
         id: "dsh-rewind-portals",
         order: 1e3
       },
-      createRewindBridge({ sessionOf, chatOf, currentSessionId, setComposerText, t, subscribeLocale })
+      createRewindBridge({ sessionOf, chatOf, currentSessionId, watchChat, setComposerText, t, subscribeLocale })
     ));
     const clientCtx = ctx;
     clientCtx.inject(["settingsScope"], (scoped) => {
@@ -1696,7 +1726,7 @@ function apply(ctx) {
       const known = knownCommandSeqs(face, chatOf2, (node) => isCandidateCommand(node));
       const result = await face.command("/rewind __candidates");
       if (!result.ok || result.value?.matched !== true) return void 0;
-      const outcome = await waitForCommand(face, chatOf2, (node) => isCandidateCommand(node) && !known.has(node.seq));
+      const outcome = await waitForCommand(face, chatOf2, (node) => isCandidateCommand(node) && !known.has(node.seq), 8e3, (cb) => watchChat(face.sessionId, cb));
       if (outcome === null || outcome.kind !== "success" || outcome.text === void 0) return void 0;
       return rewindCandidatesFromHostText(outcome.text);
     };
@@ -1731,13 +1761,14 @@ function apply(ctx) {
           openPopover({
             session: face,
             chatOf,
+            watchChat,
             seq: candidate.seq,
             time: candidate.time,
             preview: candidate.preview,
             anchor: composerAnchor(),
             t,
             onRewind: (mode) => {
-              void runRewindAndFill(face, candidate.seq, mode, currentSessionId, chatOf, setComposerText);
+              void runRewindAndFill(face, candidate.seq, mode, currentSessionId, chatOf, watchChat, setComposerText);
             }
           });
         }

package/lib/types/client/hidden.d.ts

@@ -14,11 +14,12 @@ export interface HiddenChat {
     };
 }
 /**
- * Reader for one session's live chat snapshot. The dual channel hides the
- * harness split behind SiriLee/dsh-rewind#7: rc.2 serves the chat from the
- * session face snapshot, while 0.1.2-alpha.1+ serves it from the
- * `uiConversation` service's named "chat" view (contributed by
- * dsh-client-ui-chat through the uiSession slot hook).
+ * Reader for one session's live chat snapshot. This is one of the plugin's
+ * "0.1.1-rc.2 ↔ 0.1.2-rc.1" dual channels: 0.1.1-rc.2 serves the chat from the
+ * session face snapshot, while 0.1.2-rc.1 (and the whole 0.1.2 line) serves it
+ * from the `uiConversation` service's named "chat" view (contributed by
+ * dsh-client-ui-chat through the uiSession slot hook). See
+ * SiriLee/dsh-rewind#7.
  */
 export type ChatOf = (session: {
     readonly sessionId: string;
@@ -26,13 +27,36 @@ export type ChatOf = (session: {
         chat?: unknown;
     };
 } | undefined) => HiddenChat | undefined;
+/**
+ * Subscribe to one session's live chat-update signal, for waiting on a chat
+ * snapshot change without polling. Dual-channel, mirroring `chatOf`: the
+ * 0.1.2-rc.1 `uiConversation` "chat" view when registered, else the session
+ * face (0.1.1-rc.2, whose snapshot still carries `chat`, so its own
+ * `subscribe` is the chat-update signal). `cb` fires whenever the chat
+ * snapshot invalidates.
+ */
+export type ChatWatch = (sessionId: string, cb: () => void) => () => void;
+/**
+ * Choose the chat-update subscription for `waitForCommand`: prefer the
+ * `uiConversation` "chat" view's own `subscribe` when available (0.1.2-rc.1,
+ * where the chat-update signal lives), else the session face's `subscribe`
+ * (0.1.1-rc.2, whose snapshot still carries the chat, so its own subscribe is
+ * the chat-update signal). Extracted as a pure channel-selection step so the
+ * "view vs face" branch is unit-testable; the resolvers are injected by the
+ * caller (see `watchChat` in index.ts). Never throws.
+ */
+export declare function resolveChatWatch(resolveView: (sessionId: string) => {
+    subscribe?(cb: () => void): () => void;
+} | undefined, resolveFace: (sessionId: string) => {
+    subscribe(cb: () => void): () => void;
+} | undefined, sessionId: string, cb: () => void): () => void;
 /**
  * Resolve the chat snapshot across the two harness channels: the session-face
- * snapshot first (rc.2 — on alpha.1+ the face no longer carries `chat`, so the
- * field reads `undefined`), then the `uiConversation` "chat" view. The view's
- * `getSnapshot()` returns undefined until the named view is registered, so
- * both channels missing degrades to `undefined` (no targets, no hiding —
- * never a crash).
+ * snapshot first (0.1.1-rc.2 — on 0.1.2-rc.1 the face no longer carries
+ * `chat`, so the field reads `undefined`), then the `uiConversation` "chat"
+ * view. The view's `getSnapshot()` returns undefined until the named view is
+ * registered, so both channels missing degrades to `undefined` (no targets, no
+ * hiding — never a crash).
  */
 export declare function chatSnapshotOf(face: {
     getSnapshot(): {

package/lib/types/client/popover.d.ts

@@ -15,7 +15,7 @@
  */
 import type { SessionFace } from '@deepseek-ai/dsh-client-runtime/client';
 import type { CommandNode } from '@deepseek-ai/dsh-client-runtime/client';
-import { type ChatOf } from './hidden.ts';
+import { type ChatOf, type ChatWatch } from './hidden.ts';
 import type { RewindKey } from './locales.ts';
 type Translate = (key: RewindKey, params?: Record<string, unknown>) => string;
 export interface PopoverOptions {
@@ -33,11 +33,18 @@ export interface PopoverOptions {
     readonly onRetract?: () => void;
     readonly preview: string;
     /**
-     * Dual-channel chat reader (rc.2 session face / alpha.1+ uiConversation
-     * view): the durable variant's command probes scan the chat through it.
-     * Unused by the pending-retract variant.
+     * Dual-channel chat reader (0.1.1-rc.2 session face / 0.1.2-rc.1
+     * uiConversation view): the durable variant's command probes scan the chat
+     * through it. Unused by the pending-retract variant.
      */
     readonly chatOf: ChatOf;
+    /**
+     * Subscribe to one session's live chat-update signal, so a probe waiting on
+     * a command's chat node can be woken when the chat snapshot changes (0.1.2-rc.1
+     * the session face no longer fires on a chat update). Passed straight through
+     * to `waitForCommand`.
+     */
+    readonly watchChat: ChatWatch;
     /** The button that opened the popover (outside-click ignore target). */
     readonly anchor: HTMLElement;
     readonly t: Translate;
@@ -63,7 +70,7 @@ export declare function knownCommandSeqs(session: SessionFace, chatOf: ChatOf, m
  * session snapshot (command/run + command/done land as one CommandNode).
  * @returns the outcome text-bearing node, or null on timeout.
  */
-export declare function waitForCommand(session: SessionFace, chatOf: ChatOf, match: (node: CommandNode) => boolean, timeoutMs?: number): Promise<{
+export declare function waitForCommand(session: SessionFace, chatOf: ChatOf, match: (node: CommandNode) => boolean, timeoutMs?: number, watch?: (cb: () => void) => () => void): Promise<{
     kind: 'success' | 'error';
     text?: string;
 } | null>;

package/lib/types/client/portals.d.ts

@@ -24,7 +24,7 @@
  */
 import { type ReactNode } from 'react';
 import type { SessionFace } from '@deepseek-ai/dsh-client-runtime/client';
-import { type ChatOf, type HiddenChat } from './hidden.ts';
+import { type ChatOf, type ChatWatch, type HiddenChat } from './hidden.ts';
 import type { RewindKey } from './locales.ts';
 type Translate = (key: RewindKey, params?: Record<string, unknown>) => string;
 /** One portal target: the actions row of a user/steering seat + its durable node. */
@@ -53,19 +53,26 @@ export type PortalTarget = {
 export interface RewindBridgeDeps {
     readonly sessionOf: (sessionId: string) => SessionFace | undefined;
     /**
-     * Dual-channel chat reader (rc.2 session face / alpha.1+ uiConversation
-     * "chat" view): every chat snapshot read goes through it. See
+     * Dual-channel chat reader (0.1.1-rc.2 session face / 0.1.2-rc.1
+     * uiConversation "chat" view): every chat snapshot read goes through it. See
      * `chatSnapshotOf` in hidden.ts for the channel precedence.
      */
     readonly chatOf: ChatOf;
+    /**
+     * Subscribe to one session's live chat-update signal, so the composer refill
+     * waiting on an executed rewind's chat node can be woken when the chat
+     * snapshot changes (0.1.2-rc.1 the session face no longer fires on a chat
+     * update). Passed through to `waitForCommand`.
+     */
+    readonly watchChat: ChatWatch;
     readonly currentSessionId: () => string | undefined;
     readonly t: Translate;
     readonly subscribeLocale: (cb: () => void) => () => void;
     /**
      * Session-aware dual-channel composer writer (see `writeComposer`): the
-     * alpha.1+ `conversation.input` facade `setDraft` when reachable, else the
-     * rc.2/alpha.1 DOM fill. Session-scoped so the refill only lands in the
-     * session that just rewound.
+     * 0.1.2-rc.1 `conversation.input` facade `setDraft` when reachable, else the
+     * 0.1.1-rc.2/0.1.2-rc.1 DOM fill. Session-scoped so the refill only lands in
+     * the session that just rewound.
      */
     readonly setComposerText: (sessionId: string, text: string) => boolean;
 }
@@ -83,7 +90,7 @@ export interface SlotsLike {
 }
 /** Join the text blocks of a user message into one plain preview. */
 /**
- * The alpha.1+ session input facade's write face (structural, so the plugin
+ * The 0.1.2-rc.1 session input facade's write face (structural, so the plugin
  * never imports the conversation UI package). `setDraft` replaces the whole
  * composer draft through the harness's own Lexical editor — the correct way
  * to restore the withdrawn text.
@@ -92,8 +99,8 @@ interface ComposerDraftWriter {
     setDraft(text: string): void;
 }
 /**
- * Fill the dsh composer with `text`. DOM dual-channel fallback: the rc.2
- * `<textarea>` path, then the alpha.1+ `contenteditable` path. Used by
+ * Fill the dsh composer with `text`. DOM dual-channel fallback: the 0.1.1-rc.2
+ * `<textarea>` path, then the 0.1.2-rc.1 `contenteditable` path. Used by
  * `setComposerText` (the harness-facade-aware writer) as the last-resort and
  * by `runRewindAndFill` to put the withdrawn target message back into the
  * composer after a rewind. Best-effort — no composer match means false,
@@ -102,12 +109,12 @@ interface ComposerDraftWriter {
 export declare function fillComposer(text: string): boolean;
 /**
  * Dual-channel composer write, mirroring `chatSnapshotOf`: prefer the harness
- * facade's `setDraft` (alpha.1+, correct whole-draft replace), then degrade
- * to the DOM `fillComposer` (rc.2 textarea / alpha.1 contenteditable). A
- * facade that throws (session teardown) is treated as absent so the DOM path
+ * facade's `setDraft` (0.1.2-rc.1, correct whole-draft replace), then degrade
+ * to the DOM `fillComposer` (0.1.1-rc.2 textarea / 0.1.2-rc.1 contenteditable).
+ * A facade that throws (session teardown) is treated as absent so the DOM path
  * still restores the text. Never throws.
  * @param text - the withdrawn target message text.
- * @param facade - the alpha.1+ session input draft writer, when reachable.
+ * @param facade - the 0.1.2-rc.1 session input draft writer, when reachable.
  * @returns whether a channel applied the text.
  */
 export declare function writeComposer(text: string, facade: ComposerDraftWriter | undefined): boolean;
@@ -124,22 +131,25 @@ export declare function writeComposer(text: string, facade: ComposerDraftWriter
  * the old baseline heuristic refilled withdrawn text into the composer
  * after switching sessions or restarting dsh.
  */
-export declare function runRewindAndFill(session: SessionFace, seq: number, mode: 'chat' | 'both', currentSessionId: () => string | undefined, chatOf: ChatOf, setComposerText: (sessionId: string, text: string) => boolean): Promise<void>;
+export declare function runRewindAndFill(session: SessionFace, seq: number, mode: 'chat' | 'both', currentSessionId: () => string | undefined, chatOf: ChatOf, watchChat: ChatWatch, setComposerText: (sessionId: string, text: string) => boolean): Promise<void>;
 /**
  * Locate the actions container of a user/steering seat row — the element the
  * ↶ button portals into (the copy/branch IconActions row).
  *
- * Dual channel:
- * - rc.2 (0.1.1-rc.2) / alpha.2+ (0.1.2-alpha.2): the hover-reveal root is
- *   attribute-marked (`[data-time-hover-root]` ≤ rc.x, `[data-actions-reveal]`
- *   alpha.2+) and mounts the actions row as its LAST child. A pending row IS
- *   that root; a durable row CONTAINS it as a descendant.
- * - alpha.4 (0.1.2-alpha.4): the marker was removed from user rows (it now
- *   lives only on the per-turn tail footer, `TurnTailNodeView`), and the user
- *   action row is revealed via CSS `:has()`. The container is instead located
- *   structurally: the direct holder of the copy `<button>` (the
- *   `MessageIconActions` container, which mounts that button as a direct
- *   child — `MessageIconActions.tsx:83,86`).
+ * @dualmode 0.1.1-rc.2 ↔ 0.1.2-rc.1
+ * - 0.1.1-rc.2: the hover-reveal root is attribute-marked
+ *   `[data-time-hover-root]` and mounts the actions row as its LAST child. A
+ *   pending row IS that root; a durable row CONTAINS it as a descendant.
+ * - 0.1.2-rc.1: the marker was removed from user rows (it now lives only on the
+ *   per-turn tail footer, `TurnTailNodeView`), and the user action row is
+ *   revealed via CSS `:has()`. The container is instead located structurally:
+ *   the direct holder of the copy `<button>` (the `MessageIconActions`
+ *   container, which mounts that button as a direct child —
+ *   `MessageIconActions.tsx:83,86`).
+ *
+ * The 0.1.2-alpha.2/3 `[data-actions-reveal]` attribute-marked rows (see
+ * `ACTIONS_ROOT_SELECTOR`) are an intermediate state absorbed by the
+ * attribute branch below; they are not needed by either endpoint.
  *
  * Returns undefined when no qualifying container is found; the caller refuses
  * to portal (never a crash, never a wrong attachment). Exported as a test seam
@@ -163,10 +173,11 @@ interface RewindPortalsProps extends RewindBridgeDeps {
  * skipped when the target set is unchanged), so the plugin never runs a
  * synchronous full-transcript scan inside a commit microtask.
  */
-export declare function RewindPortals({ sessionId, sessionOf, chatOf, currentSessionId, t, subscribeLocale, setComposerText }: RewindPortalsProps): ReactNode;
-/** The current composer draft, on whichever channel: rc.2 textarea `.value`,
- * alpha.1+ contenteditable `textContent`. Empty when the composer is absent.
- * Exported as a test seam (the empty-composer guard in `retractPending`). */
+export declare function RewindPortals({ sessionId, sessionOf, chatOf, currentSessionId, watchChat, t, subscribeLocale, setComposerText }: RewindPortalsProps): ReactNode;
+/** The current composer draft, on whichever channel: 0.1.1-rc.2 textarea
+ * `.value`, 0.1.2-rc.1 contenteditable `textContent`. Empty when the composer
+ * is absent. Exported as a test seam (the empty-composer guard in
+ * `retractPending`). */
 export declare function composerText(): string;
 /**
  * Build the slot-entry component for the plugin apply(): a tiny bridge that

package/lib/types/client/settings-card.d.ts

@@ -11,10 +11,11 @@
  * host schema enforces). "Discard changes" restores the last-read baseline.
  *
  * It neither imports the client settings typed contract nor depends on the
- * alpha-only `mutate` write API: it reads `getSnapshot().value` and writes via
- * the `set(field, value)` method present on both rc.2 and alpha, and the card
- * receives a tiny structural `CleanupCardApi` supplied by `src/client/index.ts`
- * so the component stays harness-agnostic and unit-testable in isolation.
+ * 0.1.2-rc.1-only `mutate` write API: it reads `getSnapshot().value` and writes
+ * via the `set(field, value)` method present on both 0.1.1-rc.2 and 0.1.2-rc.1,
+ * and the card receives a tiny structural `CleanupCardApi` supplied by
+ * `src/client/index.ts` so the component stays harness-agnostic and
+ * unit-testable in isolation.
  *
  * @module dsh-rewind/client/settings-card
  */

package/lib/types/client/styles.d.ts

@@ -23,4 +23,4 @@ export declare const CLASS: {
 /** The ↶ glyph, drawn inline so the bundle stays dependency-free. */
 export declare const REWIND_ICON_SVG: string;
 /** One injected stylesheet (scoped under `.dsh-rewind-*`). */
-export declare const STYLE = "\n.dsh-rewind-btn {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 28px;\n  height: 28px;\n  padding: 6px;\n  border: none;\n  border-radius: 28px;\n  background: transparent;\n  color: var(--dsw-alias-label-tertiary);\n  cursor: pointer;\n}\n.dsh-rewind-btn:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n  color: var(--dsw-alias-label-secondary);\n}\n\n.dsh-rewind-popover {\n  position: fixed;\n  z-index: 1000;\n  width: 288px;\n  padding: 12px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 12px;\n  background: var(--dsw-specific-menu, var(--dsw-alias-bg-layer-3));\n  box-shadow: var(--dsw-shadow-lv3);\n  font-size: 14px;\n  line-height: 20px;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-popover-title {\n  font-size: 14px;\n  font-weight: 600;\n  line-height: 20px;\n}\n.dsh-rewind-popover-target {\n  margin: 4px 0 10px;\n  font-size: 12px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-tertiary);\n  word-break: break-all;\n}\n.dsh-rewind-popover-option {\n  display: flex;\n  flex-direction: column;\n  gap: 2px;\n  width: 100%;\n  margin: 0 0 6px;\n  padding: 8px 10px;\n  border: 1px solid transparent;\n  border-radius: 8px;\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  text-align: left;\n  cursor: pointer;\n}\n.dsh-rewind-popover-option:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n.dsh-rewind-popover-option:disabled {\n  opacity: 0.5;\n  cursor: default;\n}\n.dsh-rewind-popover-option-label {\n  font-weight: 500;\n}\n.dsh-rewind-popover-option-hint {\n  font-size: 12px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-tertiary);\n}\n.dsh-rewind-popover-impact {\n  margin: 4px 0 10px;\n  padding: 8px 10px;\n  border-radius: 8px;\n  background: var(--dsw-alias-interactive-bg-hover);\n  font-size: 12px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-secondary);\n  white-space: pre-wrap;\n  max-height: 160px;\n  overflow: auto;\n}\n.dsh-rewind-popover-actions {\n  display: flex;\n  justify-content: flex-end;\n  gap: 8px;\n}\n.dsh-rewind-popover-primary,\n.dsh-rewind-popover-ghost {\n  padding: 5px 12px;\n  border: none;\n  border-radius: 8px;\n  font: inherit;\n  font-size: 13px;\n  line-height: 18px;\n  cursor: pointer;\n}\n.dsh-rewind-popover-primary {\n  background: var(--dsw-alias-button-primary-fill);\n  color: var(--dsw-alias-label-primary-foreground);\n}\n.dsh-rewind-popover-primary:hover:not(:disabled) {\n  background: var(--dsw-alias-button-primary-hover);\n}\n.dsh-rewind-popover-primary:disabled {\n  opacity: 0.5;\n  cursor: default;\n}\n.dsh-rewind-popover-ghost {\n  background: transparent;\n  color: var(--dsw-alias-label-secondary);\n}\n.dsh-rewind-popover-ghost:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.dsh-rewind-guard-hint {\n  position: fixed;\n  z-index: 1000;\n  max-width: min(440px, calc(100vw - 24px));\n  padding: 8px 12px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 10px;\n  background: var(--dsw-specific-menu, var(--dsw-alias-bg-layer-3));\n  box-shadow: var(--dsw-shadow-lv3);\n  font-size: 13px;\n  line-height: 18px;\n  color: var(--dsw-alias-label-primary);\n  pointer-events: none;\n}\n\n/* ---- Snapshot-cleanup settings card (mirrors the harness PluginCard look) ---- */\n.dsh-rewind-cleanup-card {\n  list-style: none;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 12px;\n  background: var(--dsw-alias-bg-layer-3);\n  transition: border-color .16s, background .16s;\n}\n.dsh-rewind-cleanup-card:hover {\n  border-color: var(--dsw-alias-label-dimmed);\n}\n.dsh-rewind-cleanup-card-open {\n  background: var(--dsw-alias-bg-layer-2);\n  border-color: var(--dsw-alias-label-dimmed);\n}\n.dsh-rewind-cleanup-header {\n  width: 100%;\n  appearance: none;\n  border: 0;\n  background: none;\n  font: inherit;\n  color: inherit;\n  text-align: left;\n  cursor: pointer;\n  display: flex;\n  align-items: center;\n  gap: 12px;\n  padding: 14px 16px;\n  border-radius: 12px;\n}\n.dsh-rewind-cleanup-header:focus-visible {\n  outline: 2px solid var(--dsw-alias-brand-primary);\n  outline-offset: -2px;\n}\n.dsh-rewind-cleanup-head-text {\n  flex: 1;\n  min-width: 0;\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n}\n.dsh-rewind-cleanup-name {\n  font-size: 15px;\n  font-weight: 600;\n  line-height: 1.4;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-cleanup-desc {\n  font-size: 13px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-tertiary);\n}\n.dsh-rewind-cleanup-chevron {\n  flex: none;\n  color: var(--dsw-alias-label-tertiary);\n  transition: transform .16s;\n}\n.dsh-rewind-cleanup-chevron-open {\n  transform: rotate(180deg);\n}\n.dsh-rewind-cleanup-pending {\n  flex: none;\n  border-radius: 999px;\n  padding: 1px 8px;\n  font-size: 11px;\n  line-height: 17px;\n  font-weight: 500;\n  white-space: nowrap;\n  background: var(--dsw-alias-bg-module-platform);\n  color: var(--dsw-alias-label-secondary);\n}\n.dsh-rewind-cleanup-body {\n  border-top: 1px solid var(--dsw-alias-border-l2);\n  margin: 0 16px;\n  padding: 4px 0 8px;\n}\n.dsh-rewind-cleanup-readonly {\n  margin: 12px 0 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-tertiary);\n}\n.dsh-rewind-cleanup-permission {\n  display: grid;\n  gap: 6px;\n  padding: 12px 0;\n}\n.dsh-rewind-cleanup-field {\n  display: flex;\n  flex-direction: column;\n  gap: 6px;\n  padding: 12px 0;\n}\n.dsh-rewind-cleanup-field + .dsh-rewind-cleanup-field {\n  border-top: 1px solid var(--dsw-alias-border-l2);\n}\n.dsh-rewind-cleanup-head {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n}\n.dsh-rewind-cleanup-label {\n  flex: 1;\n  min-width: 0;\n  font-size: 13px;\n  font-weight: 500;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-cleanup-hint {\n  margin: 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-tertiary);\n}\n.dsh-rewind-cleanup-error {\n  margin: 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-error);\n}\n/* Switch row: label left, role=switch button right, hint below (Subagent module). */\n.dsh-rewind-cleanup-toggle-row {\n  display: flex;\n  align-items: flex-start;\n  justify-content: space-between;\n  gap: 16px;\n  font-size: 13px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-cleanup-toggle-label {\n  flex: 1;\n  min-width: 0;\n}\n.dsh-rewind-cleanup-switch {\n  box-sizing: border-box;\n  position: relative;\n  flex: 0 0 auto;\n  width: 36px;\n  height: 20px;\n  padding: 2px;\n  border: 0;\n  border-radius: 10px;\n  background: var(--dsw-alias-border-l3);\n  cursor: pointer;\n}\n.dsh-rewind-cleanup-switch-on {\n  background: var(--dsw-alias-brand-primary);\n}\n.dsh-rewind-cleanup-switch:disabled {\n  cursor: default;\n  opacity: 0.5;\n}\n.dsh-rewind-cleanup-switch:focus-visible {\n  outline: 2px solid var(--dsw-alias-brand-primary);\n  outline-offset: 2px;\n}\n.dsh-rewind-cleanup-thumb {\n  display: block;\n  width: 16px;\n  height: 16px;\n  border-radius: 50%;\n  corner-shape: round;\n  background: var(--dsw-alias-label-primary-foreground);\n  transition: transform 120ms ease;\n}\n.dsh-rewind-cleanup-switch-on .dsh-rewind-cleanup-thumb {\n  transform: translateX(16px);\n}\n.dsh-rewind-cleanup-input {\n  box-sizing: border-box;\n  height: 34px;\n  padding: 0 12px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 8px;\n  background: var(--dsw-alias-bg-layer-3);\n  font: inherit;\n  font-size: 13px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-cleanup-input:focus-visible {\n  outline: none;\n  border-color: var(--dsw-alias-brand-primary);\n}\n.dsh-rewind-cleanup-input:disabled {\n  color: var(--dsw-alias-label-tertiary);\n  cursor: default;\n}\n.dsh-rewind-cleanup-input-invalid {\n  border-color: var(--dsw-alias-label-error);\n}\n.dsh-rewind-cleanup-footer {\n  display: flex;\n  align-items: center;\n  justify-content: flex-end;\n  gap: 8px;\n  padding: 12px 0 4px;\n  border-top: 1px solid var(--dsw-alias-border-l2);\n}\n.dsh-rewind-cleanup-failed {\n  flex: 1;\n  min-width: 0;\n  margin: 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-error);\n}\n.dsh-rewind-cleanup-discard,\n.dsh-rewind-cleanup-save {\n  appearance: none;\n  border: 1px solid transparent;\n  border-radius: 8px;\n  padding: 5px 14px;\n  font: inherit;\n  font-size: 13px;\n  line-height: 1.5;\n  cursor: pointer;\n}\n.dsh-rewind-cleanup-discard {\n  border-color: var(--dsw-alias-border-l2);\n  background: none;\n  color: var(--dsw-alias-label-secondary);\n}\n.dsh-rewind-cleanup-discard:hover:not(:disabled) {\n  color: var(--dsw-alias-label-primary);\n  border-color: var(--dsw-alias-label-dimmed);\n}\n.dsh-rewind-cleanup-save {\n  background: var(--dsw-alias-label-primary);\n  color: var(--dsw-alias-bg-layer-3);\n}\n.dsh-rewind-cleanup-discard:disabled,\n.dsh-rewind-cleanup-save:disabled {\n  opacity: 0.4;\n  cursor: default;\n}\n.dsh-rewind-cleanup-discard:focus-visible,\n.dsh-rewind-cleanup-save:focus-visible {\n  outline: 2px solid var(--dsw-alias-brand-primary);\n  outline-offset: 1px;\n}\n";
+export declare const STYLE = "\n.dsh-rewind-btn {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 28px;\n  height: 28px;\n  padding: 6px;\n  border: none;\n  border-radius: 28px;\n  background: transparent;\n  color: var(--dsw-alias-label-tertiary);\n  cursor: pointer;\n}\n.dsh-rewind-btn:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n  color: var(--dsw-alias-label-secondary);\n}\n\n.dsh-rewind-popover {\n  position: fixed;\n  z-index: 1000;\n  width: 288px;\n  padding: 12px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 12px;\n  background: var(--dsw-specific-menu, var(--dsw-alias-bg-layer-3));\n  box-shadow: var(--dsw-shadow-lv3);\n  font-size: 14px;\n  line-height: 20px;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-popover-title {\n  font-size: 14px;\n  font-weight: 600;\n  line-height: 20px;\n}\n.dsh-rewind-popover-target {\n  margin: 4px 0 10px;\n  font-size: 12px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-tertiary);\n  word-break: break-all;\n}\n.dsh-rewind-popover-option {\n  display: flex;\n  flex-direction: column;\n  gap: 2px;\n  width: 100%;\n  margin: 0 0 6px;\n  padding: 8px 10px;\n  border: 1px solid transparent;\n  border-radius: 8px;\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  text-align: left;\n  cursor: pointer;\n}\n.dsh-rewind-popover-option:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n.dsh-rewind-popover-option:disabled {\n  opacity: 0.5;\n  cursor: default;\n}\n.dsh-rewind-popover-option-label {\n  font-weight: 500;\n}\n.dsh-rewind-popover-option-hint {\n  font-size: 12px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-tertiary);\n}\n.dsh-rewind-popover-impact {\n  margin: 4px 0 10px;\n  padding: 8px 10px;\n  border-radius: 8px;\n  background: var(--dsw-alias-interactive-bg-hover);\n  font-size: 12px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-secondary);\n  white-space: pre-wrap;\n  max-height: 160px;\n  overflow: auto;\n}\n.dsh-rewind-popover-actions {\n  display: flex;\n  justify-content: flex-end;\n  gap: 8px;\n}\n.dsh-rewind-popover-primary,\n.dsh-rewind-popover-ghost {\n  padding: 5px 12px;\n  border: none;\n  border-radius: 8px;\n  font: inherit;\n  font-size: 13px;\n  line-height: 18px;\n  cursor: pointer;\n}\n.dsh-rewind-popover-primary {\n  background: var(--dsw-alias-button-primary-fill);\n  color: var(--dsw-alias-label-primary-foreground);\n}\n.dsh-rewind-popover-primary:hover:not(:disabled) {\n  background: var(--dsw-alias-button-primary-hover);\n}\n.dsh-rewind-popover-primary:disabled {\n  opacity: 0.5;\n  cursor: default;\n}\n.dsh-rewind-popover-ghost {\n  background: transparent;\n  color: var(--dsw-alias-label-secondary);\n}\n.dsh-rewind-popover-ghost:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.dsh-rewind-guard-hint {\n  position: fixed;\n  z-index: 1000;\n  max-width: min(440px, calc(100vw - 24px));\n  padding: 8px 12px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 10px;\n  background: var(--dsw-specific-menu, var(--dsw-alias-bg-layer-3));\n  box-shadow: var(--dsw-shadow-lv3);\n  font-size: 13px;\n  line-height: 18px;\n  color: var(--dsw-alias-label-primary);\n  pointer-events: none;\n}\n\n/* ---- Snapshot-cleanup settings card (mirrors the harness PluginCard look) ---- */\n/* Dual-channel note: the harness card corner/border drifted across versions \u2014\n   0.1.1-rc.2 uses border-radius 12px + 1px solid border-l2, while 0.1.2-rc.1\n   uses 16px + 0.5px border-l4 (and adds corner-shape: round). We intentionally\n   keep the 0.1.1-rc.2 values here for now; if the 0.1.2-rc.1 look is wanted,\n   switch these on the host version like the other dual-channel surfaces (see the\n   host-version probe in src/client/index.ts). */\n.dsh-rewind-cleanup-card {\n  list-style: none;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 12px;\n  background: var(--dsw-alias-bg-layer-3);\n  transition: border-color .16s, background .16s;\n}\n.dsh-rewind-cleanup-card:hover {\n  border-color: var(--dsw-alias-label-dimmed);\n}\n.dsh-rewind-cleanup-card-open {\n  background: var(--dsw-alias-bg-layer-2);\n  border-color: var(--dsw-alias-label-dimmed);\n}\n.dsh-rewind-cleanup-header {\n  width: 100%;\n  appearance: none;\n  border: 0;\n  background: none;\n  font: inherit;\n  color: inherit;\n  text-align: left;\n  cursor: pointer;\n  display: flex;\n  align-items: center;\n  gap: 12px;\n  padding: 14px 16px;\n  border-radius: 12px;\n}\n.dsh-rewind-cleanup-header:focus-visible {\n  outline: 2px solid var(--dsw-alias-brand-primary);\n  outline-offset: -2px;\n}\n.dsh-rewind-cleanup-head-text {\n  flex: 1;\n  min-width: 0;\n  display: flex;\n  flex-direction: column;\n  gap: 4px;\n}\n.dsh-rewind-cleanup-name {\n  font-size: 15px;\n  font-weight: 600;\n  line-height: 1.4;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-cleanup-desc {\n  font-size: 13px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-tertiary);\n}\n.dsh-rewind-cleanup-chevron {\n  flex: none;\n  color: var(--dsw-alias-label-tertiary);\n  transition: transform .16s;\n}\n.dsh-rewind-cleanup-chevron-open {\n  transform: rotate(180deg);\n}\n.dsh-rewind-cleanup-pending {\n  flex: none;\n  border-radius: 999px;\n  padding: 1px 8px;\n  font-size: 11px;\n  line-height: 17px;\n  font-weight: 500;\n  white-space: nowrap;\n  background: var(--dsw-alias-bg-module-platform);\n  color: var(--dsw-alias-label-secondary);\n}\n.dsh-rewind-cleanup-body {\n  border-top: 1px solid var(--dsw-alias-border-l2);\n  margin: 0 16px;\n  padding: 4px 0 8px;\n}\n.dsh-rewind-cleanup-readonly {\n  margin: 12px 0 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-tertiary);\n}\n.dsh-rewind-cleanup-permission {\n  display: grid;\n  gap: 6px;\n  padding: 12px 0;\n}\n.dsh-rewind-cleanup-field {\n  display: flex;\n  flex-direction: column;\n  gap: 6px;\n  padding: 12px 0;\n}\n.dsh-rewind-cleanup-field + .dsh-rewind-cleanup-field {\n  border-top: 1px solid var(--dsw-alias-border-l2);\n}\n.dsh-rewind-cleanup-head {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n}\n.dsh-rewind-cleanup-label {\n  flex: 1;\n  min-width: 0;\n  font-size: 13px;\n  font-weight: 500;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-cleanup-hint {\n  margin: 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-tertiary);\n}\n.dsh-rewind-cleanup-error {\n  margin: 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-error);\n}\n/* Switch row: label left, role=switch button right, hint below (Subagent module). */\n.dsh-rewind-cleanup-toggle-row {\n  display: flex;\n  align-items: flex-start;\n  justify-content: space-between;\n  gap: 16px;\n  font-size: 13px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-cleanup-toggle-label {\n  flex: 1;\n  min-width: 0;\n}\n.dsh-rewind-cleanup-switch {\n  box-sizing: border-box;\n  position: relative;\n  flex: 0 0 auto;\n  width: 36px;\n  height: 20px;\n  padding: 2px;\n  border: 0;\n  border-radius: 10px;\n  background: var(--dsw-alias-border-l3);\n  cursor: pointer;\n}\n.dsh-rewind-cleanup-switch-on {\n  background: var(--dsw-alias-brand-primary);\n}\n.dsh-rewind-cleanup-switch:disabled {\n  cursor: default;\n  opacity: 0.5;\n}\n.dsh-rewind-cleanup-switch:focus-visible {\n  outline: 2px solid var(--dsw-alias-brand-primary);\n  outline-offset: 2px;\n}\n.dsh-rewind-cleanup-thumb {\n  display: block;\n  width: 16px;\n  height: 16px;\n  border-radius: 50%;\n  corner-shape: round;\n  background: var(--dsw-alias-label-primary-foreground);\n  transition: transform 120ms ease;\n}\n.dsh-rewind-cleanup-switch-on .dsh-rewind-cleanup-thumb {\n  transform: translateX(16px);\n}\n.dsh-rewind-cleanup-input {\n  box-sizing: border-box;\n  height: 34px;\n  padding: 0 12px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 8px;\n  background: var(--dsw-alias-bg-layer-3);\n  font: inherit;\n  font-size: 13px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-cleanup-input:focus-visible {\n  outline: none;\n  border-color: var(--dsw-alias-brand-primary);\n}\n.dsh-rewind-cleanup-input:disabled {\n  color: var(--dsw-alias-label-tertiary);\n  cursor: default;\n}\n.dsh-rewind-cleanup-input-invalid {\n  border-color: var(--dsw-alias-label-error);\n}\n.dsh-rewind-cleanup-footer {\n  display: flex;\n  align-items: center;\n  justify-content: flex-end;\n  gap: 8px;\n  padding: 12px 0 4px;\n  border-top: 1px solid var(--dsw-alias-border-l2);\n}\n.dsh-rewind-cleanup-failed {\n  flex: 1;\n  min-width: 0;\n  margin: 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-error);\n}\n.dsh-rewind-cleanup-discard,\n.dsh-rewind-cleanup-save {\n  appearance: none;\n  border: 1px solid transparent;\n  border-radius: 8px;\n  padding: 5px 14px;\n  font: inherit;\n  font-size: 13px;\n  line-height: 1.5;\n  cursor: pointer;\n}\n.dsh-rewind-cleanup-discard {\n  border-color: var(--dsw-alias-border-l2);\n  background: none;\n  color: var(--dsw-alias-label-secondary);\n}\n.dsh-rewind-cleanup-discard:hover:not(:disabled) {\n  color: var(--dsw-alias-label-primary);\n  border-color: var(--dsw-alias-label-dimmed);\n}\n.dsh-rewind-cleanup-save {\n  background: var(--dsw-alias-label-primary);\n  color: var(--dsw-alias-bg-layer-3);\n}\n.dsh-rewind-cleanup-discard:disabled,\n.dsh-rewind-cleanup-save:disabled {\n  opacity: 0.4;\n  cursor: default;\n}\n.dsh-rewind-cleanup-discard:focus-visible,\n.dsh-rewind-cleanup-save:focus-visible {\n  outline: 2px solid var(--dsw-alias-brand-primary);\n  outline-offset: 1px;\n}\n";

package/lib/types/session-events.d.ts

@@ -1,16 +1,17 @@
 /**
  * Cross-channel session event-log reader.
  *
- * Harness 0.1.1-rc.2 exposes the full log as `Session.events`
- * (`get events(): readonly SessionEvent[]`), while 0.1.2-alpha.4 removed that
+ * This is a "0.1.1-rc.2 ↔ 0.1.2-rc.1" dual-channel reader. Harness 0.1.1-rc.2
+ * exposes the full log as `Session.events` (`get events(): readonly
+ * SessionEvent[]`); the 0.1.2 line (alpha.4+, now 0.1.2-rc.1) removed that
  * member and replaced it with the on-demand APIs `snapshotEvents(from?, to?)`
  * (half-open range, internally cached), `eventAt(seq)`, `ownEvents()` and
  * `seq`. This module reads the full log through whichever channel the host
- * exposes, so the plugin keeps one code path across both.
+ * exposes, so the plugin keeps one code path across both endpoints.
  *
  * `snapshotEvents()` is deliberately preferred over `ownEvents()`:
  * `snapshotEvents()` defaults to the whole log (including any fork-inherited
- * prefix), which is exactly what `Session.events` returned on rc.2 — the
+ * prefix), which is exactly what `Session.events` returned on 0.1.1-rc.2 — the
  * rewind semantics are preserved for fork-seeded sessions. `ownEvents()`
  * would drop the inherited prefix and change behaviour.
  *
@@ -20,15 +21,17 @@ import type { Session, SessionEvent } from '@deepseek-ai/dsh-session';
 /**
  * Read the full event log of a session, transparently across harness channels:
  * - 0.1.1-rc.2 (`Session.events`): the live immutable log array.
- * - 0.1.2-alpha.4 (`Session.snapshotEvents()`): a deep-frozen snapshot, cached
- *   by the session until the next append.
+ * - 0.1.2-rc.1 (`Session.snapshotEvents()`): a deep-frozen snapshot, cached
+ *   by the session until the next append. This is the single 0.1.2-line
+ *   channel (alpha.2/3 still exposed `events` and thus fall into the
+ *   0.1.1-rc.2 branch below).
  *
  * Falls back to an empty log when the session exposes neither member (a future
  * harness shape) rather than throwing — callers already treat the empty log as
  * "no candidates".
  *
  * @param session - the session to read.
- * @returns the full event log in log order (the same shape rc.2's `events`
+ * @returns the full event log in log order (the same shape 0.1.1-rc.2's `events`
  *   returned, so existing consumers are unchanged).
  */
 export declare function eventsOf(session: Session): readonly SessionEvent[];

package/lib/types/settings-locale.d.ts

@@ -1,12 +1,13 @@
 /**
  * Version-neutral settings-namespace reading for the host half.
  *
- * DSH rc.2 exposes a `settingsNamespace(value)` brand helper, and `settings.get`
- * is typed to require a branded `SettingsNamespace`. DSH 0.1.2-alpha.2 removed
+ * This is a "0.1.1-rc.2 ↔ 0.1.2-rc.1" dual channel. DSH 0.1.1-rc.2 exposes a
+ * `settingsNamespace(value)` brand helper, and `settings.get` is typed to
+ * require a branded `SettingsNamespace`. The 0.1.2 line (0.1.2-rc.1) removed
  * that helper (the `SettingsNamespace` *type* remains) and `settings.get`
  * accepts the raw namespace string. This module collapses both into one runtime
- * call: on rc.2 the brand is a compile-time marker erased at runtime (so
- * `settingsNamespace(ns)` returns `ns`), on 0.1.2-alpha.2 the brand helper is
+ * call: on 0.1.1-rc.2 the brand is a compile-time marker erased at runtime (so
+ * `settingsNamespace(ns)` returns `ns`), on 0.1.2-rc.1 the brand helper is
  * absent and the raw `ns` string is used directly. That is what lets a single
  * compiled host bundle link and run on both harness generations.
  *
@@ -16,17 +17,17 @@
 export interface SettingsProviderLike {
     /**
      * Read one registered settings section by namespace. Accepts whatever the
-     * running DSH generation passes: a branded `SettingsNamespace` (rc.2, brand
-     * erased) or the raw namespace string (0.1.2-alpha.2).
+     * running DSH generation passes: a branded `SettingsNamespace` (0.1.1-rc.2,
+     * brand erased) or the raw namespace string (0.1.2-rc.1).
      */
     get(ns: string): unknown;
 }
-/** The `settingsNamespace(ns)` brand helper, or `undefined` when removed (0.1.2-alpha.2). */
+/** The `settingsNamespace(ns)` brand helper, or `undefined` when removed (0.1.2-rc.1). */
 export type SettingsNamespaceBrand = ((value: string) => string) | undefined;
 /**
  * Read one settings section keyed by `ns`, tolerant of the settings-namespace
- * brand across DSH generations. Pass the brand helper when available (the rc.2
- * path); it is `undefined` on 0.1.2-alpha.2, where the raw `ns` string is used
- * directly. Never throws: an absent section simply returns `undefined`.
+ * brand across DSH generations. Pass the brand helper when available (the
+ * 0.1.1-rc.2 path); it is `undefined` on 0.1.2-rc.1, where the raw `ns` string
+ * is used directly. Never throws: an absent section simply returns `undefined`.
  */
 export declare function readSettingsSection(provider: SettingsProviderLike, ns: string, brand: SettingsNamespaceBrand): unknown;

package/lib/types/snapshot-cleanup.d.ts

@@ -46,9 +46,9 @@ export declare const CleanupConfigSchema: z<CleanupConfig>;
 /**
  * Structural face of the settings scope the host needs for the policy: a
  * resolved read and a validated write. Kept local (never imports the settings
- * contract) so the host bundle links on both rc.2 and alpha — the settings
- * API drift (alpha adds `mutate`, rd2 does not) is confined to the seam the
- * host passes in, never to this module.
+ * contract) so the host bundle links on both 0.1.1-rc.2 and 0.1.2-rc.1 — the
+ * settings API drift (0.1.2 adds `mutate`, 0.1.1 does not) is confined to the
+ * seam the host passes in, never to this module.
  */
 export interface CleanupSettingsScope {
     /** The resolved policy: schema defaults, then base, then the user layer. */

package/package.json

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