dsh-rewind-plugin 0.11.0-alpha.1 → 0.11.0

package/README.en.md

@@ -35,8 +35,11 @@ Every user message carries a **↶ rewind** button in its action row. Clicking i
 
 ## Install
 
+Check your local DSH version, then find the matching plugin version in
+[Releases](https://github.com/SiriLee/dsh-rewind/releases).
+
 ```sh
-dsh plugin --profile web add dsh-rewind-plugin
+dsh plugin --profile web add dsh-rewind-plugin@<version>
 ```
 
 > ⚠️ The npm name `dsh-rewind` belongs to another author's package — install with `dsh-rewind-plugin`.
@@ -77,6 +80,20 @@ cleanup** panel (the auto-cleanup switch and the idle-day cutoff), or use the
 
 <img src="assets/screenshots/cleanup-setting.png" alt="Snapshot cleanup settings: auto-cleanup and idle days" width="600">
 
+## Uninstall
+
+```sh
+# Uninstall the plugin
+dsh plugin --profile web remove dsh-rewind-plugin
+
+# To also delete local data
+rm -rf <dsh home>/rewind-snapshots
+rm <dsh home>/snapshot-cleanup-last-sweep.json
+```
+
+The plugin's auto-cleanup settings live in the settings document
+(`<dsh home>/settings.yaml`). To remove them completely, delete the key manually.
+
 ## Why it stands out
 
 Compared with the common approaches, here is the trade-off this plugin makes on "rewind":

package/README.md

@@ -35,8 +35,10 @@ DeepSeek Harness 插件：**一键就地回退对话到任意更早的用户消
 
 ## 安装
 
+确认本机 DSH 版本后，在 [Release](https://github.com/SiriLee/dsh-rewind/releases) 找到适配的插件版本。
+
 ```sh
-dsh plugin --profile web add dsh-rewind-plugin
+dsh plugin --profile web add dsh-rewind-plugin@<版本>
 ```
 
 > ⚠️ npm 上的 `dsh-rewind` 属于其他作者，请用 `dsh-rewind-plugin` 安装。
@@ -67,6 +69,19 @@ dsh plugin --profile web add dsh-rewind-plugin
 
 <img src="assets/screenshots/cleanup-setting.png" alt="快照清理设置：自动清理与失活天数" width="600">
 
+## 卸载
+
+```sh
+# 卸载插件
+dsh plugin --profile web remove dsh-rewind-plugin
+
+# 如需同时删除本地数据
+rm -rf <dsh home>/rewind-snapshots
+rm <dsh home>/snapshot-cleanup-last-sweep.json
+```
+
+插件的自动清理设置保存在设置文档（`<dsh home>/settings.yaml`）中。如需彻底清理，可手动删除对应键。
+
 ## 本插件的优势
 
 和常见的几种做法相比，本插件在"回退"这件事上的取舍：

package/docs/compat/audit.md

@@ -7,27 +7,28 @@
 > compatibility invariants. A probe failure is a finding; it enters the
 > fix/pin/record loop.
 >
-> Targeted version: npm `@deepseek-ai/*@0.1.2-rc.1` (matches `package-lock.json`).
+> Targeted version: npm `@deepseek-ai/*@0.1.5-rc.1` (the range the peers and `dsh.engines.dsh` declare).
 > Source reference: the upstream [github.com/deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness).
 >
 > Version alignment: `peerDependencies` use one tuple per DSH line
 > (e.g. `^0.1.2-rc.1`). npm's prerelease matching rules require a candidate to
 > share the range comparator's `[major, minor, patch]` tuple, so a new DSH tuple
-> replaces the peer tuple (single-line model); any prerelease within the SAME
-> tuple is a no-op. Signal: `npm view @deepseek-ai/dsh version`;
+> replaces the peer tuple (single-line model). The range is conservative — it
+> declares only what was verified, so a release already inside it changes
+> nothing. Signal: `npm view @deepseek-ai/dsh dist-tags`;
 > flow: `scripts/check-dsh-version.mjs` (it reads the `latest` dist-tag only; a
 > prerelease published under another tag is a manual pre-release check).
 >
-> The plugin targets a single DSH version line (`0.1.2-rc.1`); compatibility
-> with earlier lines is not kept.
+> The plugin targets a single DSH version line; compatibility with earlier
+> lines is not kept.
 
-### Single channel (`0.1.2-rc.1`)
+### Single channel
 
-The plugin targets one DSH channel. Each seam below reads the 0.1.2-rc.1 shape
-only (no `Session.events` / `[data-time-hover-root]` / `<textarea>` / face-`chat`
-legacy branch).
+The plugin targets one DSH channel. Each seam below reads the targeted
+version's shape only (no `Session.events` / `[data-time-hover-root]` /
+`<textarea>` / face-`chat` legacy branch).
 
-| Seam | 0.1.2-rc.1 implementation |
+| Seam | Implementation at the targeted version |
 | --- | --- |
 | Host session log | `session.snapshotEvents()` |
 | Client chat snapshot | `uiConversation` `chat` view (`chatSnapshotOf`) |
@@ -66,7 +67,7 @@ legacy branch).
 - **session-stats / session-telemetry fold the full log**: post-rewind stats do **not** rewind — `turns`/`steps`/`llmMs` still include withdrawn content; the `user/message` marker is folded as a present user turn (it adds no step). This is the intended "fold the full log" semantics, pinned by probe.
 - **token-meter usage anchor stays stable** (G3): the `user/message` marker carries no usage, but because it is not an `assistant/message`, the baseline anchor does not drop to a heuristic estimate — it stays `usage` across a rewind. Pinned by `compat-gaps` G3.
 - **marker content is the constant `(empty message)` placeholder**: never empty, because the session log is immutable but the model serving a session may change later — a strict OpenAI-compatible gateway rejects an empty user message (HTTP 400, Issue #21). The marker is a small visible user turn in derived history. Pin: `verify-host` (`marker is a user/message with the dsh-rewind plugin source and the (empty message) placeholder`).
-- **marker shape (v3)**: the replace `surfaceOp` is `{ op: 'replace', startSeq, endSeq }` (renamed from `start`/`end` in session-format v3), and the dsh-rewind source now carries `targetSeq`; the `user/message` + `sourceEventSeqs` shape and the `(empty message)` content are unchanged.
+- **marker shape (v3)**: the replace `surfaceOp` is `{ op: 'replace', startSeq, endSeq }` (renamed from `start`/`end` in session-format v3); the dsh-rewind source is the plain CLOSED third-party plugin shape `{ kind: 'plugin', plugin: 'dsh-rewind' }` (no private field — the released-format source validator rejects any member outside `kind`/`plugin` + the context-injection `form`/`sections`/`summary`, and a plugin extends the source map by adding a `kind`, not fields); the `user/message` + `sourceEventSeqs` shape and the `(empty message)` content are unchanged.
 - **Withdrawn content stays searchable/exportable**: session-query full-text and `/export` read the raw log; a rewind cuts only the surface, so withdrawn messages remain (declared in the README).
 - **Session title auto-regeneration**: the title derives from the surface, so an automatically-derived title may change after a rewind.
 - **Files written but uncommitted in a cancelled turn**: a `both` rewind cannot restore them (tool side-effect timing; same as Claude Code).

package/docs/release/release.md

@@ -73,28 +73,28 @@ Each release is `git push <branch>` followed by `git push <branch> --tags`.
 
 DSH is still in rc; npm's prerelease matching rules require a peer range to
 share the host version's `[major, minor, patch]` tuple. So `peerDependencies`
-uses one peer tuple per DSH line (e.g. `^0.1.2-rc.1`), replaced (never
-appended) when DSH releases a new tuple.
-
-- **When to update**: only when DSH releases a new tuple (`0.1.2 → 0.1.3 →
-  0.2.x`); rc rolling within a tuple (`0.1.2-rc.1 → rc.2`) needs nothing. All
-  `@deepseek-ai/*` packages release together; `npm view @deepseek-ai/dsh version`
-  is the authoritative signal.
+uses one peer tuple per DSH line (e.g. `^0.1.2-rc.1`). The range is
+conservative: it declares only what was verified, and guarantees nothing
+outside it.
+
+- **When to update**: when the verified range changes — a new DSH tuple, or a
+  deliberate narrowing (e.g. dropping the internal `alpha` series); a release
+  already inside the range changes nothing. All `@deepseek-ai/*` packages
+  release together; `npm view @deepseek-ai/dsh dist-tags` is the signal.
 - **Published-tuple check (optional)**: `node scripts/check-dsh-version.mjs`
   compares the `latest` dist-tag version against the tuple the peers cover
   (exit 0 = nothing to do, exit 1 = update). It reads the `latest` tag only; a
   pre-release published under another tag or bundled without
   going to npm is a manual pre-release check — see the "Before bumping" step above.
-- **Update steps**: replace every `@deepseek-ai/dsh-*` peer's tuple with
-  `^<latest>` → bump devDependencies to the latest → `npm install` →
-  `npm run check` → release.
+- **Update steps**: point every `@deepseek-ai/dsh-*` peer and devDependency at
+  the verified range → `npm install` → `npm run check` → release.
 - **After DSH goes final**: final releases are not bound by the prerelease
   tuple rule, so the peers can converge to a single stable range (e.g.
   `^0.1.x`); this section can then be deleted.
 - **Declared minimum (`dsh.engines.dsh`)**: alongside the peer tuple, each
   release declares the DSH runtime floor under `dsh.engines.dsh` (e.g.
   `>=0.1.2-rc.1`), consumed by the plugin-manager update guard. Bump it in
-  the same release that raises the peer tuple; never leave code raised while
+  the same release that changes the peer range; never leave code raised while
   the declared floor stays behind. Only the `>=X.Y.Z[-pre]` form is
   supported (`^`/`~`/multi-range are treated as "cannot verify" and
   fail closed).

package/docs/release/release.zh.md

@@ -66,22 +66,22 @@ npm publish --access public
 
 DSH 仍在 rc 阶段，npm 的 prerelease 匹配规则要求 peer 范围与宿主版本
 **同 `[major, minor, patch]` 元组**才能匹配。因此 peerDependencies 采用
-**每一条 DSH 线一个 peer 元组**（如 `^0.1.2-rc.1`），DSH 发新元组时**替换**而非追加。
+**每一条 DSH 线一个 peer 元组**（如 `^0.1.2-rc.1`）；范围是保守的，只声明实际验证过的内容。
 
-- **何时需要更新**：仅当 DSH 发布新元组（`0.1.2 → 0.1.3 → 0.2.x`）时；
-  同元组内 rc 滚动（`0.1.2-rc.1 → rc.2`）无需动作。DSH 所有包同版本发布，
-  `npm view @deepseek-ai/dsh version` 即权威信号。
+- **何时需要更新**：**已验证范围**变化时——DSH 发新元组，或主动收窄（例如不再
+  声明内测的 DSH `alpha` 系列）；落在已声明范围内的发布不改变任何东西。DSH 所有包
+  同版本发布；信号是 `npm view @deepseek-ai/dsh dist-tags`。
 - **已发布元组检查（可选）**：`node scripts/check-dsh-version.mjs` 用 npm `latest`
   dist-tag 版本对比 peer 覆盖的元组（exit 0 无需动作，exit 1 需要）。它**只读
   `latest` tag**；发布在其它 tag 的 pre-release 走**手动发布前检查**
   ——见上文"升版前手动确认"。
-- **更新步骤**：把每个 `@deepseek-ai/dsh-*` peer 的元组**替换**为 `^<最新版>`
-  → devDependencies 同步升到最新 → `npm install` → `npm run check` → 发版。
+- **更新步骤**：把每个 `@deepseek-ai/dsh-*` peer 与 devDependency 指向已验证
+  范围 → `npm install` → `npm run check` → 发版。
 - **正式版后收敛**：DSH 发布 final 版本后，正式版不受 prerelease 元组规则
   限制，peer 可收敛为稳定的 `^0.1.x` 单范围，此节即可删除。
 - **声明的最低运行时（`dsh.engines.dsh`）**：与 peer 元组一起，每个发布在
   `dsh.engines.dsh` 声明 DSH 运行时下限（如 `>=0.1.2-rc.1`），供插件管理器
-  更新守卫读取。**与 peer 元组持平的同一发布里一并 bump**；不可只升代码、
+  更新守卫读取。**与 peer 范围持平的同一发布里一并 bump**；不可只升代码、
   声明下限停留在旧值。仅支持 `>=X.Y.Z[-pre]` 形式（`^`/`~`/多范围会被视为
   「无法校验」而 fail-closed）。
 

package/lib/client.js

@@ -1345,7 +1345,7 @@ function createRewindBridge(deps) {
 }
 
 // src/client/build-info.ts
-var PLUGIN_VERSION = true ? "0.11.0-alpha.1" : "dev";
+var PLUGIN_VERSION = true ? "0.11.0" : "dev";
 var BUILD_HASH = true ? "d770983e" : "dev";
 
 // src/client/locales.ts

package/lib/index.js

@@ -119,10 +119,7 @@ var RewindError = class extends Error {
   }
   code;
 };
-var REWIND_MARKER_BRAND = Object.freeze({ kind: "plugin", plugin: "dsh-rewind" });
-function rewindMarkerSource(targetSeq) {
-  return Object.freeze({ ...REWIND_MARKER_BRAND, targetSeq });
-}
+var REWIND_MARKER_SOURCE = Object.freeze({ kind: "plugin", plugin: "dsh-rewind" });
 var CANDIDATE_PREVIEW_CHARS = 80;
 var DEFAULT_CANDIDATE_LIMIT = 100;
 function isUserMessageEvent(event) {
@@ -1597,10 +1594,10 @@ async function commitEntry(store, pending, anchorCache, trackedBySession, exec,
   tracked.add(capture.path);
 }
 var REWIND_MARKER_CONTENT = [{ type: "text", text: "(empty message)" }];
-function buildMarker(targetSeq) {
+function buildMarker() {
   return createUserMessage({
     content: REWIND_MARKER_CONTENT,
-    source: rewindMarkerSource(targetSeq)
+    source: REWIND_MARKER_SOURCE
   });
 }
 function describeTarget(target) {
@@ -1712,7 +1709,7 @@ async function executeRewind(ctx, store, fs, invocation, rawTarget, mode, inflig
     } catch (error) {
       return rewindErrorResult(error);
     }
-    const marker = buildMarker(plan.targetSeq);
+    const marker = buildMarker();
     let event;
     try {
       event = agent.session.append("user/message", marker, {

package/lib/types/rewind.d.ts

@@ -75,14 +75,17 @@ export interface RewindPlan {
     readonly surfaceEnd: number;
 }
 /**
- * Create rewind-marker provenance correlated with one rewind target.
- * @param targetSeq - absolute log seq of the user message rewound to.
- * @returns immutable rewind-marker source.
+ * The rewind-marker source: the backend-independent identity carried by every
+ * marker the plugin appends. It is the plain third-party plugin source shape
+ * `{ kind: 'plugin', plugin: 'dsh-rewind' }` — no extra fields, because a
+ * plugin source is a CLOSED shape in the harness (only `kind`/`plugin`, plus
+ * the context-injection `form`/`sections`/`summary`; see `MessageSourceMap` and
+ * the released-format source validator). A plugin extends the source map by
+ * adding a new `kind`, never by hanging private fields off `plugin`.
  */
-export declare function rewindMarkerSource(targetSeq: number): Readonly<{
-    kind: 'plugin';
-    plugin: 'dsh-rewind';
-    targetSeq: number;
+export declare const REWIND_MARKER_SOURCE: Readonly<{
+    readonly kind: 'plugin';
+    readonly plugin: 'dsh-rewind';
 }>;
 /**
  * Test whether a persisted message source identifies a rewind marker.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-rewind-plugin",
-  "version": "0.11.0-alpha.1",
+  "version": "0.11.0",
   "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",
@@ -50,7 +50,7 @@
       "patch": "./cordis.patch.yml"
     },
     "engines": {
-      "dsh": ">=0.1.5-alpha.1"
+      "dsh": ">=0.1.5-rc.1"
     },
     "client": {
       "inject": [
@@ -76,18 +76,18 @@
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-ui-commands": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-commands": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-fs": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-home-paths": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-llm": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-sandbox": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-settings": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-tools": "^0.1.5-alpha.1"
+    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-commands": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-commands": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-fs": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-home-paths": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-sandbox": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.5-rc.1"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {
@@ -136,37 +136,37 @@
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@deepseek-ai/dsh-agent": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-attachment": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-connection": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-store": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-scope": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-user-questions": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-ui-commands": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-ui-input-trigger": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-command-compact": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-commands": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-compaction": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-compaction-basic": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-fs": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-goal": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-home-paths": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-llm": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-plan-mode": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-sandbox": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-projection": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-stats": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-title": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-settings": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-token-meter": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-tools": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-agent": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-attachment": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-scope": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-user-questions": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-commands": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-input-trigger": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-command-compact": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-commands": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-compaction": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-compaction-basic": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-fs": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-goal": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-home-paths": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-plan-mode": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-sandbox": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session-projection": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session-stats": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session-title": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-token-meter": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.5-rc.1",
     "@types/node": "^24.0.0",
     "@types/react": "^18.3.31",
     "@types/react-dom": "^18.3.7",