dsh-rewind-plugin 0.9.0-alpha.2 → 0.10.0-alpha.1

package/README.en.md

@@ -1,7 +1,7 @@
 # dsh-rewind
 
 > [!WARNING]
-> **Planning to use DSH `0.1.3`? Upgrade to the latest plugin (`>= 0.9.0-alpha.1`) as soon as possible and run `/dsh-rewind-fix` to update old rewind markers** ([update guide](docs/rewind-fix.md)).
+> **Planning to use DSH `0.1.3`? Install a `v0.9.x` release as soon as possible and run `/dsh-rewind-fix` to update old rewind markers** ([update guide](docs/rewind-fix.md)).
 
 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).
 
@@ -106,7 +106,7 @@ The whole design rests on two principles, simple but deliberate: **the conversat
 
 The file half follows Claude Code's checkpoint semantics — **partial tracking + before-write backup, plus a re-scan of tracked files at each message**, not a whole-tree snapshot. This trade-off saves space, and it's actually more complete:
 
-- **Before-write backup**: tracks only the write-class tools (`write`, `edit`, `str_replace_editor`) — backs up the original content before a write and records/tracks the files it touches; it never backs up the whole workspace, so it's lightweight.
+- **Before-write backup**: tracks only the write-class tools (`write`, `edit`) — backs up the original content before a write and records/tracks the files it touches; it never backs up the whole workspace, so it's lightweight.
 - **External changes count too**: at every user-message boundary the plugin re-checks all tracked files — external changes such as a command run or a manual edit are recorded as well and restored by a later rewind. "Lightweight" but not "incomplete".
 - **Unchanged-not-recorded, identical-content-as-link**: an entry is written only when something changed — at the message-boundary re-check, an unchanged file is never backed up (no record); at before-write time, when the new content matches the path's prior record, only a **link to it** (`ref`) is stored instead of a copy. Repeated writes cost almost nothing, and a link is materialized before its group is evicted — never left dangling.
 - **Reconcile against the real disk before restoring**: restore takes each path's **earliest** record, then reads the live file and compares — **only files that actually differ are touched**: modified files are written back to the earliest backup, files created after the target are deleted, already-matching files are skipped. Repeated rewinds are therefore **idempotent with zero side effects** and never produce "ghost impact".

package/README.md

@@ -1,7 +1,7 @@
 # dsh-rewind
 
 > [!WARNING]
-> **计划使用 DSH `0.1.3` 的用户：请尽早升级到最新插件（`>= 0.9.0-alpha.1`），并运行 `/dsh-rewind-fix` 更新旧回退标记**（[更新指南](docs/rewind-fix.zh.md)）。
+> **计划使用 DSH `0.1.3` 的用户：请尽早安装 `v0.9.x` 版本，并运行 `/dsh-rewind-fix` 更新旧回退标记**（[更新指南](docs/rewind-fix.zh.md)）。
 
 DeepSeek Harness 插件：**一键就地回退对话到任意更早的用户消息**——同窗口内完成，不新建分支、不换窗口，可一并还原工作区文件（完整 Claude Code `/rewind` 语义）。
 
@@ -96,7 +96,7 @@ dsh plugin --profile web add dsh-rewind-plugin
 
 文件部分对齐 Claude Code 的检查点语义——**局部追踪、写前备份 + 每条消息重扫已跟踪文件**，而不是整树快照。这项取舍既省空间，又更完整：
 
-- **写前备份**：只追踪写类工具（`write`、`edit`、`str_replace_editor`），写前**备份原内容**，并**记录、追踪**被处理的文件——从不备份整个工作区，因此轻量。
+- **写前备份**：只追踪写类工具（`write`、`edit`），写前**备份原内容**，并**记录、追踪**被处理的文件——从不备份整个工作区，因此轻量。
 - **外部变更也追**：每条用户消息边界，插件重新检查所有已跟踪文件——命令执行、手动修改等外部变更同样被记录，回退时一并还原。这让「轻量」却不「残缺」。
 - **不变不存、同内容存链接**：记录只在有变化时发生——消息边界重扫时无变更的不备份（不留记录）；写前备份时若与前一条记录一致，只存**指向它的链接**（`ref`）而非复制内容。重复写入几乎不占空间，链接也先落地、绝不悬空。
 - **还原时对照真实磁盘**：先取每条路径的**最早**记录，再实时读取文件当前内容与之比对——**只操作真正不一致的文件**：改过的写回最早期内容、目标之后新建的删除、已经一致的跳过。重复回退因此**零副作用、幂等**，不会出现「幽灵影响」。

package/docs/architecture.md

@@ -17,12 +17,9 @@ credentials access.
 
 ```
 src/
-├── index.ts          host plugin: /rewind, /undo, /snapshot-auto-cleanup,
-│                     /dsh-rewind-fix commands + checkpoint pipeline
+├── index.ts          host plugin: /rewind, /undo, /snapshot-auto-cleanup
+│                     commands + checkpoint pipeline
 ├── rewind.ts         pure planning: target parsing, surface-range plan, candidate listing
-├── rewind-fix.ts     /dsh-rewind-fix orchestration (repair pipeline, locks, rollback)
-├── rewind-marker-repair.ts  pure legacy-marker transform (A/B → C)
-├── session-log-io.ts session-log zstd codec + lossless re-encoder (rewind-fix write-back)
 ├── snapshot.ts       checkpoint store: disk before-backups, journaled restore,
 │                     reconcile / continue / rollback, bounded prune
 ├── snapshot-cleanup.ts  cleanup policy + dsh-settings persistence + auto-sweep throttle
@@ -33,6 +30,11 @@ src/
                      pending interaction, locales, styles
 ```
 
+The old marker-update repair line (`/dsh-rewind-fix` and its `rewind-fix.ts` /
+`rewind-marker-repair.ts` / `session-log-io.ts` modules) was a **temporary
+migration tool** for the DSH `0.1.2-rc.1` → `0.1.3` transition: it shipped
+through the `0.9.x` line and is **removed in the `0.10.x` line**.
+
 Two dependency rules keep the design testable:
 
 1. **`rewind.ts` is pure** — no I/O, no `Session` dependency; everything
@@ -89,13 +91,15 @@ plugin versions wrote shapes a newer harness no longer accepts:
   inside a closed turn.
 
 A/B became unreadable once v2 reserved surface `replace` to a node that cites
-`sourceEventSeqs` (`assistant/message` can no longer carry them). `/dsh-rewind-fix`
-rewrites form A/B in closed sessions to form C so a newer harness accepts the log.
+`sourceEventSeqs` (`assistant/message` can no longer carry them). The
+`/dsh-rewind-fix` command rewrote form A/B in closed sessions to form C so a
+newer harness accepts the log — it was a **temporary migration tool** (kept on
+the `0.9.x` line) and is **removed in the `0.10.x` line**.
 
 ## Checkpoint pipeline (Claude Code before-backup model)
 
 ```
-tools/execute        captureBefore: for write / edit / str_replace_editor
+tools/execute        captureBefore: for write / edit
                      (mutating commands only), read the file's BEFORE state;
                      subagent edits are NOT tracked (Claude Code alignment).
 tools/post-execute   commitEntry: anchor = latest user/message seq; skip

package/docs/format.md

@@ -158,8 +158,7 @@ Old-format data is never silently re-interpreted.
 The snapshot auto-cleanup policy (the `enabled` switch and the `maxAgeDays`
 idle cutoff) is no longer a file: it lives in the **dsh-settings document** under
 the `dsh-rewind-snapshot-cleanup` namespace (validated by a schemastery schema;
-defaults are the `base` layer). On first run after this change, a legacy
-`<dsh home>/snapshot-cleanup.json` is imported into the document **once** and
-then deleted (an absent file is a no-op; an invalid file imports the safe
-default and is dropped). The last-sweep clock stays in its own
+defaults are the `base` layer). The policy was previously persisted in a legacy
+`<dsh home>/snapshot-cleanup.json` file; that file store and its one-time
+startup migration have been removed. The last-sweep clock stays in its own
 `<dsh home>/snapshot-cleanup-last-sweep.json` state file, which is unchanged.

package/docs/harness-reference.md

@@ -49,12 +49,9 @@ the canonical source; this block only adds the finer-grained client-side files
 and packaging entries.
 
 ```
-src/index.ts            host plugin: /rewind|/undo|/snapshot-auto-cleanup|/dsh-rewind-fix
+src/index.ts            host plugin: /rewind|/undo|/snapshot-auto-cleanup
                         + checkpoint pipeline (tools/execute|post-execute)
 src/rewind.ts           pure planning: target resolution, surface range, candidate listing
-src/rewind-fix.ts       /dsh-rewind-fix orchestration (repair pipeline, locks, rollback)
-src/rewind-marker-repair.ts  pure legacy-marker transform (A/B → C)
-src/session-log-io.ts   session-log zstd codec + lossless re-encoder (rewind-fix write-back)
 src/snapshot.ts         checkpoint store (disk before-backups, restore/preview, bounded prune)
 src/snapshot-cleanup.ts cleanup policy + dsh-settings persistence + auto-sweep throttle
 src/session-cwd.ts      session-cwd resolution (fs-tools rule)

package/docs/rewind-fix.md

@@ -5,7 +5,7 @@
 ## Applies to
 
 - **DSH**: `0.1.2-rc.1`
-- **dsh-rewind**: `0.9.0-alpha.1`
+- **dsh-rewind**: `0.9.0-alpha.1`, `0.9.0-alpha.2`, `0.9.0`
 
 ## Background
 
@@ -40,7 +40,7 @@ The command rewrites session files and clears some snapshots, so a backup is a g
 cp -r ~/.dsh/sessions          ~/.dsh/sessions.backup
 cp -r ~/.dsh/rewind-snapshots  ~/.dsh/rewind-snapshots.backup
 ```
-Or copy them anywhere convenient.
+Or copy them anywhere convenient. You can also let the AI run the backup for you.
 
 ### Step 3 · Start a new session, or pick one that was never rewound
 
@@ -50,11 +50,11 @@ The command only handles **closed** sessions, and it can't run on itself. So:
 
 Then run the command **in this new session**, and it will update the old sessions that need it.
 
-> ⚠️ Don't run it in a session that itself needs updating and is currently open — the command skips this session, and any other currently-open/in-use session.
+> Don't run it in a session that itself needs updating and is currently open — the command skips this session, and any other currently-open/in-use session.
 
 ### Step 4 · Preview the update scope
 
-Type `/dsh-rewind-fix` in the composer and send it. It only scans, doesn't write — it reports how many sessions were scanned, how many will be updated, how many skipped, and how many failed. Confirm those are what you expect before moving on.
+Type `/dsh-rewind-fix` in the composer and send it. It only scans, doesn't write. The editor locks while it runs, which is normal. **Don't switch session windows midway.** When it finishes, it reports how many sessions were scanned, how many will be updated, how many skipped, and how many failed. Confirm those are what you expect before moving on.
 ```
 /dsh-rewind-fix
 ```
@@ -67,7 +67,7 @@ Once you're sure, re-enter the command with `--apply` to actually run it:
 ```
 This really rewrites the session logs and updates the old markers, and **may take a few minutes**. Please let it finish — **don't switch to another session window or close DSH** while it runs: a session you switch to is **safely skipped** (no corruption, but it won't be updated this pass and you'll need to re-run). A session that fails stays as it was, unharmed, and can be updated again later. Sessions that are updated also get their matching **snapshot backups cleared**, so file restore to earlier messages is no longer available for them.
 
-### Step 6 · Restart DSH and preview again (optional)
+### Step 6 · Restart DSH and preview again
 
 After the run, restart DSH, then **preview once more**:
 ```

package/docs/rewind-fix.zh.md

@@ -4,8 +4,8 @@
 
 ## 适配
 
-- **DSH**：`0.1.2-rc.1`
-- **dsh-rewind**：`0.9.0-alpha.1`
+- **DSH**: `0.1.2-rc.1`
+- **dsh-rewind**: `0.9.0-alpha.1`, `0.9.0-alpha.2`, `0.9.0`
 
 ## 背景
 
@@ -40,7 +40,7 @@
 cp -r ~/.dsh/sessions          ~/.dsh/sessions.backup
 cp -r ~/.dsh/rewind-snapshots  ~/.dsh/rewind-snapshots.backup
 ```
-或者复制到任意合适的位置。
+或者复制到任意合适的位置。你也可以直接让 AI 帮你完成数据的备份。
 
 ### 第三步 · 新建会话，或选一个从未回退过的会话
 
@@ -50,11 +50,11 @@ cp -r ~/.dsh/rewind-snapshots  ~/.dsh/rewind-snapshots.backup
 
 然后在**这个新会话窗口里**运行命令，去更新那些需要处理的旧会话。
 
-> ⚠️ 别在「本身就需要更新、且正开着」的会话里运行——命令会跳过本会话，以及任何正被打开/使用的会话。
+> 别在「本身就需要更新、且正开着」的会话里运行——命令会跳过本会话，以及任何正被打开/使用的会话。
 
 ### 第四步 · 预览更新范围
 
-在编辑区域输入 `/dsh-rewind-fix` 并发送。它只扫描、不写盘，会告诉你：扫描了几个会话、其中几个将被更新、几个跳过、几个失败。确认是你预期的那几项，再进下一步。
+在编辑区域输入 `/dsh-rewind-fix` 并发送。它只扫描、不写盘。执行时编辑区会正常锁定。**不要中途切换会话窗口。**完成后会告诉你：扫描了几个会话、其中几个将被更新、几个跳过、几个失败。确认是你预期的那几项，再进下一步。
 ```
 /dsh-rewind-fix
 ```
@@ -67,7 +67,7 @@ cp -r ~/.dsh/rewind-snapshots  ~/.dsh/rewind-snapshots.backup
 ```
 这一步会真的改动会话日志、把旧标记更新成新格式，**可能需要几分钟**。请耐心等它跑完，**不要中途切换会话窗口**或关闭 DSH——被切到的会话会被**安全地跳过**（不损坏，但这次不会更新，需重新执行）。更新失败的会话保持原状态不变、无破坏，可重新进行更新。被更新的会话会同时**清掉对应的文件快照备份**，更早消息回退时文件还原不可用。
 
-### 第六步 · 重启 DSH，再预览确认（可选）
+### 第六步 · 重启 DSH，再预览确认
 
 执行完后重启一下 DSH，然后**再跑一次预览**：
 ```

package/lib/client.js

@@ -446,7 +446,12 @@ var STYLE = `
   line-height: 1.5;
   color: var(--dsw-alias-label-error);
 }
-/* Switch row: label left, role=switch button right, hint below (Subagent module). */
+/* Switch row: label left, role=switch button right, hint below (Subagent module).
+ * The track mirrors the harness ui-primitives Switch (0.1.3-alpha.2 line): the
+ * on/off appearance keys off aria-checked rather than a parallel class, so the
+ * visual state cannot disagree with the state assistive technology reads, and
+ * corner-shape: round opts the capsule track out of the global superellipse
+ * (which would square the capsule ends off against the round thumb inside). */
 .dsh-rewind-cleanup-toggle-row {
   display: flex;
   align-items: flex-start;
@@ -469,10 +474,11 @@ var STYLE = `
   padding: 2px;
   border: 0;
   border-radius: 10px;
+  corner-shape: round;
   background: var(--dsw-alias-border-l3);
   cursor: pointer;
 }
-.dsh-rewind-cleanup-switch-on {
+.dsh-rewind-cleanup-switch[aria-checked='true'] {
   background: var(--dsw-alias-brand-primary);
 }
 .dsh-rewind-cleanup-switch:disabled {
@@ -492,7 +498,7 @@ var STYLE = `
   background: var(--dsw-alias-label-primary-foreground);
   transition: transform 120ms ease;
 }
-.dsh-rewind-cleanup-switch-on .dsh-rewind-cleanup-thumb {
+.dsh-rewind-cleanup-switch[aria-checked='true'] .dsh-rewind-cleanup-thumb {
   transform: translateX(16px);
 }
 .dsh-rewind-cleanup-input {
@@ -1333,8 +1339,8 @@ function createRewindBridge(deps) {
 }
 
 // src/client/build-info.ts
-var PLUGIN_VERSION = true ? "0.9.0-alpha.2" : "dev";
-var BUILD_HASH = true ? "ca24fc4e" : "dev";
+var PLUGIN_VERSION = true ? "0.10.0-alpha.1" : "dev";
+var BUILD_HASH = true ? "7022eaa4" : "dev";
 
 // src/client/locales.ts
 var zh = {
@@ -1531,7 +1537,7 @@ function SettingsCleanupCard({ api, t }) {
             {
               type: "button",
               role: "switch",
-              className: `dsh-rewind-cleanup-switch${draft.enabled ? " dsh-rewind-cleanup-switch-on" : ""}`,
+              className: "dsh-rewind-cleanup-switch",
               "aria-checked": draft.enabled,
               "aria-labelledby": "dsh-rewind-cleanup-enabled-label",
               disabled,