dsh-rewind-plugin 0.7.5 → 0.8.0-alpha.1

package/README.en.md

@@ -156,7 +156,8 @@ withdrew should consume the stable, locale-independent helpers exported from
 2. **Lightweight file rewind has a cost** — in specific cases not all changes can be rewound. Consistent with Claude Code. See: [File-rewind tracking boundary](docs/compat/tracking-boundary.md).
 3. **Rewinds from `≤ v0.2.4`** — sessions rewound with these versions may **fail to load history** after more conversation. Install a v0.3.3-or-earlier release and use its bundled repair tool ([docs/compat/troubleshooting.md](docs/compat/troubleshooting.md)).
 4. **Rewinds from `≤ v0.3.3`** — compaction (`/compact`) is unavailable for those sessions. Newer versions are compatible; for affected old sessions, start a new session.
-5. **The turn-rail shows rewound turns** — the right-side rail added in DSH `v0.1.2-alpha.1` keeps ticks for withdrawn messages: clicking does not jump and hovering shows the withdrawn text. Only a display difference; no functional impact.
+5. **The turn-rail shows rewound turns** — the right-side rail added in DSH `v0.1.2` keeps ticks for withdrawn messages, and hovering shows the withdrawn text. Only a display difference; no functional impact.
+6. **The system prompt is re-displayed after a rewind** — in DSH `v0.1.2`, rewinding and resending a message shows the "System prompt" component again, just like `/compact`. Only a display difference; no functional impact.
 
 > [!NOTE]
 > Browser diagnostics are available; see [Browser diagnostics](docs/compat/diagnostics.md).

package/README.md

@@ -143,7 +143,8 @@ dsh plugin --profile web add dsh-rewind-plugin
 2. **轻量文件回退存在代价**——特定情况可能无法回退所有修改。行为与 Claude Code 一致。详见：[文件回退的追踪边界](docs/compat/tracking-boundary.zh.md)。
 3. **v0.2.4 及更早版本**回退过的会话，继续对话后可能加载历史失败。可安装 v0.3.3 及之前版本的随附修复工具处理（[完整步骤](docs/compat/troubleshooting.zh.md)）。
 4. **v0.3.3 及更早版本**回退过的会话，压缩对话（compact）不可用。新版本已兼容；受影响的旧会话建议新建会话。
-5. **导轨显示已回退轮次**——DSH `v0.1.2-alpha.1` 新增的右侧导轨，会为已撤回消息保留刻度：点击不跳转、悬浮显示已撤回正文。仅显示差异，无功能影响。
+5. **导轨显示已回退轮次**——DSH `v0.1.2` 新增右侧导轨，为已撤回消息保留刻度，悬浮显示已撤回正文。仅显示差异，无功能影响。
+6. **回退重显系统提示词**——DSH `v0.1.2` 回退重发消息时，与 `/compact` 一样重显“系统提示词”组件。仅显示差异，无功能影响。
 
 > [!NOTE]
 > 本插件提供浏览器端诊断输出；详见 [浏览器诊断](docs/compat/diagnostics.zh.md)。

package/docs/architecture.md

@@ -98,10 +98,11 @@ pruneStale            cross-session auto-cleanup (default off): whole
 
 ## Compatibility strategy
 
-- **Peer ranges as OR-union of DSH version tuples** (`^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2`):
-  npm's prerelease rules require the peer range to share the host's
-  `[major, minor, patch]` tuple; `scripts/check-dsh-version.mjs` detects when
-  a new tuple requires appending. See `docs/release/release.md`.
+- **Peer ranges as one tuple per DSH line** (`^0.1.2-rc.1`): npm's prerelease
+  rules require the peer range to share the host's `[major, minor, patch]`
+  tuple, so a new DSH tuple replaces the peer tuple (the single-line model);
+  `scripts/check-dsh-version.mjs` flags when a new tuple arrives. See
+  `docs/release/release.md`.
 - **Test-driven investigation**: `tests/compat-invariants.ts` /
   `compat-interop` / `compat-gaps` probe harness behavior and pin findings in
   `docs/compat/audit.md`; `scripts/verify-host.mjs` runs a real end-to-end

package/docs/compat/audit.md

@@ -7,35 +7,33 @@
 > 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`).
+> Targeted version: npm `@deepseek-ai/*@0.1.2-rc.1` (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 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`;
+> 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`;
 > 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).
+> prerelease published under another tag 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.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.
+> The plugin targets a single DSH version line (`0.1.2-rc.1`); compatibility
+> with earlier lines is not kept.
+
+### Single channel (`0.1.2-rc.1`)
 
-### Channeled seams (version × 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).
 
-| 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 |
-| Client composer refill (`writeComposer`) | `<textarea>` DOM write | `conversation.input.setDraft` | `conversation.input.setDraft` |
-| Client settings card | nested `ctx.inject(['settingsScope'])` | nested `ctx.inject(['settingsScope'])` | nested `ctx.inject(['settingsScope'])` |
-| Client seat-button DOM (`actionsContainerOf`) | `[data-time-hover-root]` | `[data-actions-reveal]` | structural locate of the copy-`<button>` container |
+| Seam | 0.1.2-rc.1 implementation |
+| --- | --- |
+| Host session log | `session.snapshotEvents()` |
+| Client chat snapshot | `uiConversation` `chat` view (`chatSnapshotOf`) |
+| Client composer refill | `conversation.input.setDraft` facade |
+| Client settings card | nested `ctx.inject(['settingsScope'])` |
+| Client seat-button DOM | structural locate of the copy-`<button>` container (`actionsContainerOf`) |
 
 ## Definition of "fully compatible" (invariants)
 
@@ -61,7 +59,7 @@
 - **rewind across a compact checkpoint**: `RewindError('not-on-surface')` refuses cleanly, no crash.
 - **plan-mode**: a marker reuses the last started turn (no phantom turn); a rewind never touches the log-only `plan/mode` state (plan mode stays active; the user leaves it with `/plan off`) and the log stays replayable (`compat-invariants` I1/I3 marker + `plan/mode` probe, `verify-host`).
 - **agent-loop cancellation**: `finally` guarantees step/turn closure; the rewind force-stop path leaves no dangling frame.
-- **settings-card cross-version reach**: the Snapshot cleanup card must be registered through a **nested** `ctx.inject(['settingsScope'], …)` — naming `settingsScope` in the module-level inject unmounts the whole client plugin on rc.2 (card and rewind button disappear). It uses only the rc.2↔alpha-common scope subset (`getSnapshot().value` + `set`), never the alpha-only `mutate`.
+- **settings-card registration**: the Snapshot cleanup card must be registered through a **nested** `ctx.inject(['settingsScope'], …)` — naming `settingsScope` in the module-level inject would keep the whole client plugin unmounted on a host without that service (card and rewind button would disappear). It reads `getSnapshot().value` + `set`, never the `mutate` write API.
 
 ## Known behavior boundaries (deterministic differences, non-crash, documented)
 
@@ -80,7 +78,7 @@ The plugin treats these as harness-side defects it does not compensate for. Each
 ### RU-I18N: host-side locale preference is not reliably readable at command registration (harness-side structural timing defect; plugin reads once, never retries)
 
 - **Root cause (harness-side)**: the plugin resolves `activeLocale` in an
-  `ctx.inject(['settings'])` callback that reads `settings.get(settingsNamespace('locale')).preference`
+  `ctx.inject(['settings'])` callback that reads `settings.get('locale').preference`
   **once, with no retry** (`src/index.ts`). `dsh-client-locale`'s host half
   registers that `locale` settings section **through its own `ctx.inject(['settings'])`**
   (`packages/client/locale/src/index.ts`). Both callbacks wait only on `settings` and are

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-rc.1 uses the uiConversation "chat" view
+const chat = uiConversation.binding(sessionId).target('chat')?.getSnapshot() // the 0.1.2-rc.1 "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-rc.1 用 uiConversation "chat" 视图
+const chat = uiConversation.binding(sessionId).target('chat')?.getSnapshot() // 0.1.2-rc.1 的 "chat" 视图
 const hidden = hiddenSeqsOf(chat as HiddenChat) // 被隐藏的 anchor seq 集合
 ```
 

package/docs/harness-reference.md

@@ -39,8 +39,8 @@ Also under `docs/` at the repo root: `persistence-catalog.md` (full
 | `tools/pre-execute` / `execute` / `post-execute` | [packages/core/tools/src/index.ts](https://github.com/deepseek-ai/deepseek-harness/blob/main/packages/core/tools/src/index.ts) |
 | Client DOM anchors (`data-chat-flow-kind` / `data-chat-anchor-key`) | [packages/client/ui-conversation/src/client/chat/ChatNodeSeat.tsx](https://github.com/deepseek-ai/deepseek-harness/blob/main/packages/client/ui-conversation/src/client/chat/ChatNodeSeat.tsx) |
 | User bubble rendering | [packages/client/ui-conversation/src/client/chat/MessageItem.tsx](https://github.com/deepseek-ai/deepseek-harness/blob/main/packages/client/ui-conversation/src/client/chat/MessageItem.tsx) |
-| Client `SessionFace` (`command` / `cancel`) | [packages/client/runtime/src/client/contract/session.ts](https://github.com/deepseek-ai/deepseek-harness/blob/main/packages/client/runtime/src/client/contract/session.ts) |
-| Client `PendingWait` (`respond`) | [packages/client/runtime/src/client/sessions/pending.ts](https://github.com/deepseek-ai/deepseek-harness/blob/main/packages/client/runtime/src/client/sessions/pending.ts) |
+| Client `SessionFace` (`command` / `cancel`) | [packages/api/session-controller/src/client/contract/session.ts](https://github.com/deepseek-ai/deepseek-harness/blob/main/packages/api/session-controller/src/client/contract/session.ts) |
+| Client pending interaction (SessionPendingInteraction) | [packages/client/ui-session/src/client/index.ts](https://github.com/deepseek-ai/deepseek-harness/blob/main/packages/client/ui-session/src/client/index.ts) |
 
 ## Plugin source layout
 

package/docs/release/release.md

@@ -33,45 +33,101 @@ Open `https://www.npmjs.com/package/dsh-rewind-plugin` → package **settings**
 
 ## Subsequent releases (CI, automatic)
 
-```sh
-npm version patch
-git push origin main --tags   # triggers .github/workflows/publish.yml
-```
+The release workflow is **version-driven**: it derives the npm dist-tag from the
+version in `package.json`, independent of branch. A stable version publishes to
+`latest`; a pre-release publishes to the dist-tag named by its pre-release
+identifier (e.g. `0.9.0-alpha.1` → `alpha`, `0.9.0-rc.1` → `rc`). The dist-tag is
+never passed by hand.
+
+The line being released determines the branch and the bump:
+
+| Release | Branch | Bump | dist-tag |
+| --- | --- | --- | --- |
+| Stable patch (current line) | `release/0.8.x` | `npm version patch` | `latest` |
+| Pre-release (next line) | `main` | `npm version prerelease --preid=alpha` | `alpha` |
+| Stable (next line) | `main` | `npm version 0.9.0` | `latest` |
 
+Each release is `git push <branch>` followed by `git push <branch> --tags`.
+
+- The tag is the **lightweight `npm version` tag** (on the `chore: release …`
+  commit). Push it as-is — **do not** create the tag or the release beforehand
+  with `gh release create <tag>`: that tags the remote's current `main` head, so
+  an unpushed version bump leaves the tag on the wrong commit and the
+  tag/version match check fails.
 - **Before bumping, manually confirm there is no newer DSH version the plugin
   has not been verified against** (a pre-release can ship in DSH Desktop
-  without being on npm, e.g. `0.1.2-alpha.1`; see docs/compat/audit.md).
+  without being on npm; see docs/compat/audit.md).
 - The workflow verifies the tag matches `package.json`, runs typecheck + tests +
-  a full build + artifact verification, publishes with `--provenance`
-  (Sigstore), and creates a GitHub Release. It is **idempotent** — an already
-  published version is skipped.
+  a full build + artifact verification, publishes with `--provenance` (Sigstore)
+  to the version-derived dist-tag, and creates a GitHub Release (a pre-release
+  is created as a GitHub pre-release, not `latest`). It is **idempotent** — an
+  already published version is skipped.
 - CI (`.github/workflows/ci.yml`) runs `npm run check` — typecheck + tests +
   build + artifact verification + a `npm pack --dry-run` — on every push / PR
   across both Node engines boundary versions; the tarball layout is guarded by
   `tests/package-layout.test.ts`.
+- The GitHub Release body is auto-created with `--generate-notes` as a
+  **placeholder** (`--latest` / `--prerelease` per version). After the publish
+  run succeeds, overwrite the body by hand in the repo's bilingual style
+  (Chinese first, then English) — never keep the auto text as the final note.
 
-## DSH version alignment (peer range maintenance)
+## DSH version alignment (single peer tuple)
 
 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 an OR-union covering every published tuple series
-(e.g. `^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2`), extended as DSH releases new tuples.
-
-- **When to update**: only when DSH releases a new tuple
-  (`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).
+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.
 - **Published-tuple check (optional)**: `node scripts/check-dsh-version.mjs`
-  compares the `latest` dist-tag version against the tuples the peers cover
+  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 (e.g. `alpha`) or bundled without
+  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**: append `|| ^<new-tuple>-rc.<n>` to every
-  `@deepseek-ai/dsh-*` peer → bump devDependencies to the latest → `npm
-  install` → `npm run check` → release.
+- **Update steps**: replace every `@deepseek-ai/dsh-*` peer's tuple with
+  `^<latest>` → bump devDependencies to the latest → `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.
+
+## Versioned-line release model
+
+**One release targets one DSH version line.** The plugin's own version is
+independent of the host; a release declares its DSH line through the peer
+constraint (a single companion tuple), never through the plugin version.
+
+| Plugin version | DSH line | Notes |
+| --- | --- | --- |
+| `0.7.x` | `0.1.1` + `0.1.2` (broad) | frozen / EOL |
+| `0.8.x` | `0.1.2-rc.1` (single) | current stable |
+| `0.9.x` | `0.1.3` (single) | next line |
+
+**Versioning.** A DSH version-line break is a MAJOR bump (incompatible with the
+prior DSH line). Within a line, MINOR/PATCH remain compatible.
+
+**Branching (trunk-based).** `main` is the single integration and release line
+and is always releasable. The currently-shipped stable is cut into a short-lived
+`release/<version>.x` maintenance branch from its release commit; that branch
+receives backported fixes while `main` advances to the next line. The prior
+(broad-compat) line is frozen as a tag, with no branch.
+
+**dist-tag routing.** The release workflow derives the npm dist-tag from the
+version: a stable version publishes to `latest`; a pre-release publishes to the
+dist-tag named by its pre-release identifier (`0.9.0-alpha.1` → `alpha`,
+`0.9.0-rc.1` → `rc`). A pre-release never occupies `latest`.
+
+**Support window / EOL.** A DSH line is supported within a declared window. By
+default the window runs until the next DSH line ships as `latest`; after that
+the line is EOL, frozen, and receives no further patches. Here `0.8.x`
+(`0.1.2-rc.1`) is supported until `0.9.x` (`0.1.3`) ships as `latest`.
+
+**Bug-fix flow (forward-fix then backport).** A fix affecting multiple supported
+lines is applied on `main` first, then backported to each still-supported
+release branch. A fix specific to one line is applied only on that line.
+
+The single-line model uses one peer tuple per release (see DSH version
+alignment above); the OR-union multi-line practice it replaced is not used.

package/docs/release/release.zh.md

@@ -32,37 +32,82 @@ npm publish --access public
 
 ## 后续发布（CI 自动）
 
-```sh
-npm version patch
-git push origin main --tags   # 触发 .github/workflows/publish.yml
-```
+发布 workflow 为**版本驱动**：npm dist-tag 由 `package.json` 中的版本号决定、与分支无关。
+稳定版发 `latest`；pre-release 发到与其 pre-release 标识符同名的 dist-tag
+（如 `0.9.0-alpha.1` → `alpha`、`0.9.0-rc.1` → `rc`）。dist-tag 无需手传。
+
+按要发布的版本线选择分支与版本步进：
+
+| 发布类型 | 分支 | 版本步进 | dist-tag |
+| --- | --- | --- | --- |
+| 当前线稳定补丁 | `release/0.8.x` | `npm version patch` | `latest` |
+| 下一线 pre-release | `main` | `npm version prerelease --preid=alpha` | `alpha` |
+| 下一线正式版 | `main` | `npm version 0.9.0` | `latest` |
 
-- **升版前手动确认**：确认无插件未针对其验证过的更新 DSH 版本（pre-release 可能只随 Desktop 捆绑、而不发到 npm，如 `0.1.2-alpha.1`；见 docs/compat/audit.md）。
+每次发布为 `git push <分支>`，再 `git push <分支> --tags`。
+
+- tag 即 `npm version` 生成的**轻量 tag**（落在 `chore: release …` 提交上）。
+  直接原样 push 即可——**不要**用 `gh release create <tag>` 事先建 tag 或
+  release：它会给远端当前 `main` 的 HEAD 打 tag，若版本 bump 尚未 push，tag
+  就会落在错误提交上，导致 tag/版本一致性校验失败。
+- **升版前手动确认**：确认无插件未针对其验证过的更新 DSH 版本（pre-release
+  可能只随 Desktop 捆绑、而不发到 npm；见 docs/compat/audit.md）。
 - workflow 校验 tag 与 `package.json` 版本一致，跑 typecheck + 测试 + 完整
-  构建 + 产物验证，以 `--provenance`（Sigstore）发布并创建 GitHub Release。
+  构建 + 产物验证，以 `--provenance`（Sigstore）发布到版本推导出的 dist-tag，
+  并创建 GitHub Release（pre-release 会建成 GitHub pre-release，而非 `latest`）。
   **幂等**——已发布的版本会跳过。
 - CI（`.github/workflows/ci.yml`）在每次 push / PR 跑 `npm run check`——
   typecheck + 测试 + 构建 + 产物验证 + `npm pack --dry-run`，且覆盖
   engines 两个边界版本；tarball 布局由 `tests/package-layout.test.ts` 守护。
+- GitHub Release 正文由 workflow 以 `--generate-notes` 自动生成，仅是**占位**
+  （按版本取 `--latest` / `--prerelease`）。发布运行成功后，请用**手写双语**
+  正文（中文在前、英文在后）覆盖——切勿把自动文本当作最终发布说明。
 
-## DSH 版本适配（peer 范围维护）
+## DSH 版本适配（单一 peer 元组）
 
 DSH 仍在 rc 阶段，npm 的 prerelease 匹配规则要求 peer 范围与宿主版本
 **同 `[major, minor, patch]` 元组**才能匹配。因此 peerDependencies 采用
-OR 并集覆盖 DSH 已发布的每个元组系列（如 `^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2`），
-并随 DSH 发版追加。
+**每一条 DSH 线一个 peer 元组**（如 `^0.1.2-rc.1`），DSH 发新元组时**替换**而非追加。
 
-- **何时需要更新**：仅当 DSH 发布新元组（`0.1.1 → 0.1.2 → 0.2.x`）时；
-  同元组内 rc 滚动（`0.1.1-rc.2 → rc.3`）无需动作。DSH 所有包同版本发布，
+- **何时需要更新**：仅当 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` 即权威信号。
-- **例外 —— `@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 走**手动发布前检查**
+  `latest` tag**；发布在其它 tag 的 pre-release 走**手动发布前检查**
   ——见上文"升版前手动确认"。
-- **更新步骤**：给每个 `@deepseek-ai/dsh-*` peer 追加 `|| ^<新元组>-rc.<n>`
+- **更新步骤**：把每个 `@deepseek-ai/dsh-*` peer 的元组**替换**为 `^<最新版>`
   → devDependencies 同步升到最新 → `npm install` → `npm run check` → 发版。
 - **正式版后收敛**：DSH 发布 final 版本后，正式版不受 prerelease 元组规则
   限制，peer 可收敛为稳定的 `^0.1.x` 单范围，此节即可删除。
+
+## 发布版本线模型
+
+**一个发布对准一条 DSH 版本线。** 插件自身版本号与宿主解耦；某发布所对准的
+DSH 线由 peer 约束（单一 companion 元组）声明，而非插件版本号。
+
+| 插件版本 | DSH 线 | 说明 |
+| --- | --- | --- |
+| `0.7.x` | `0.1.1` + `0.1.2`（广兼容） | 冻结 / EOL |
+| `0.8.x` | `0.1.2-rc.1`（单线） | 当前稳定 |
+| `0.9.x` | `0.1.3`（单线） | 下一线 |
+
+**版本号。** DSH 版本线破坏性变更 ＝ MAJOR 升版（与更早 DSH 线向后不兼容）。
+同一线内 MINOR/PATCH 保持向后兼容。
+
+**分支（主干开发）。** `main` 是唯一集成与发布线，始终可发版。当前已发布
+稳定版从发布提交点切出短命 `release/<版本>.x` 维护分支；该分支承接
+backport 修复，同时 `main` 前进到下一线。更早的（广兼容）线冻结成 tag，无分支。
+
+**dist-tag 路由。** 发布 workflow 按版本号取 npm dist-tag：稳定版发 `latest`；
+pre-release 发到与其 pre-release 标识符同名的 dist-tag（`0.9.0-alpha.1` →
+`alpha`、`0.9.0-rc.1` → `rc`）。pre-release 不占据 `latest`。
+
+**支持窗口 / EOL。** 一条 DSH 线仅在声明的窗口内受支持。默认窗口到下一
+DSH 线作为 `latest` 发布为止；此后该线 EOL、冻结、不再发补丁。此处 `0.8.x`
+（`0.1.2-rc.1`）支持到 `0.9.x`（`0.1.3`）作为 `latest` 发布为止。
+
+**Bug 修复流程（先向前修，再回迁）。** 跨多条支持线的修复，先在 `main` 上
+修复，再回迁到各仍受支持的 release 分支。仅特定线的修复，只在对应线修复。
+
+单线模型每个发布使用单一 peer 元组（见上文「DSH 版本适配」）；其取代的 OR 并集多线做法已不使用。

package/lib/client.js

@@ -35,16 +35,12 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/client/hidden.ts
-function resolveChatWatch(resolveView, resolveFace, sessionId, cb) {
+function resolveChatWatch(resolveView, sessionId, cb) {
   const view = resolveView(sessionId);
-  if (view?.subscribe !== void 0) return view.subscribe(cb);
-  const face = resolveFace(sessionId);
-  return face?.subscribe(cb) ?? (() => {
+  return view?.subscribe?.(cb) ?? (() => {
   });
 }
-function chatSnapshotOf(face, chatView) {
-  const legacy = face?.getSnapshot().chat;
-  if (legacy !== void 0) return legacy;
+function chatSnapshotOf(chatView) {
   return chatView?.getSnapshot() ?? void 0;
 }
 function messageTextAt(chat, seq) {
@@ -328,16 +324,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). */
+/* Standardized on the 0.1.2 harness card look (border-radius 16px + 0.5px
+   border-l4, 0.5px internal separators). */
 .dsh-rewind-cleanup-card {
   list-style: none;
-  border: 1px solid var(--dsw-alias-border-l2);
-  border-radius: 12px;
+  border: 0.5px solid var(--dsw-alias-border-l4);
+  border-radius: 16px;
   background: var(--dsw-alias-bg-layer-3);
   transition: border-color .16s, background .16s;
 }
@@ -405,7 +397,7 @@ var STYLE = `
   color: var(--dsw-alias-label-secondary);
 }
 .dsh-rewind-cleanup-body {
-  border-top: 1px solid var(--dsw-alias-border-l2);
+  border-top: 0.5px solid var(--dsw-alias-border-l2);
   margin: 0 16px;
   padding: 4px 0 8px;
 }
@@ -427,7 +419,7 @@ var STYLE = `
   padding: 12px 0;
 }
 .dsh-rewind-cleanup-field + .dsh-rewind-cleanup-field {
-  border-top: 1px solid var(--dsw-alias-border-l2);
+  border-top: 0.5px solid var(--dsw-alias-border-l2);
 }
 .dsh-rewind-cleanup-head {
   display: flex;
@@ -648,7 +640,7 @@ function waitForCommand(session, chatOf, match, timeoutMs = 8e3, watch) {
         settle({ kind: node.outcome.kind, text: node.outcome.text });
       }
     };
-    const unsubscribe = (watch ?? ((cb) => session.subscribe(cb)))(check);
+    const unsubscribe = watch(check);
     const timer = setTimeout(() => settle(null), timeoutMs);
     check();
   });
@@ -988,15 +980,6 @@ var rewindLog = {
 
 // src/client/portals.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
-function fillComposerTextarea(text) {
-  const textarea = document.querySelector(COMPOSER_TEXTAREA_SELECTOR);
-  if (textarea === null) return false;
-  const setter = Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, "value")?.set;
-  setter?.call(textarea, text);
-  textarea.dispatchEvent(new Event("input", { bubbles: true }));
-  textarea.focus();
-  return true;
-}
 function fillComposerEditable(text) {
   const editable = document.querySelector(COMPOSER_EDITABLE_SELECTOR);
   if (editable === null) return false;
@@ -1020,7 +1003,6 @@ function fillComposerEditable(text) {
   return true;
 }
 function fillComposer(text) {
-  if (fillComposerTextarea(text)) return true;
   return fillComposerEditable(text);
 }
 function writeComposer(text, facade) {
@@ -1089,7 +1071,7 @@ async function runRewindAndFill(session, seq, mode, currentSessionId, chatOf, wa
   }
 }
 function composerSurface() {
-  return document.querySelector(COMPOSER_TEXTAREA_SELECTOR) ?? document.querySelector(COMPOSER_EDITABLE_SELECTOR);
+  return document.querySelector(COMPOSER_EDITABLE_SELECTOR);
 }
 function showHint(text) {
   const surface = composerSurface();
@@ -1106,16 +1088,11 @@ function showHint(text) {
   }
   window.setTimeout(() => hint.remove(), 3200);
 }
-var COMPOSER_TEXTAREA_SELECTOR = "[data-input-scroll] textarea, textarea[data-phase]";
 var COMPOSER_EDITABLE_SELECTOR = "[data-composer-input]";
 var USER_SEAT_SELECTOR = '[data-chat-flow-kind="user"][data-chat-anchor-key], [data-chat-flow-kind="steering"][data-chat-anchor-key]';
 var CHAT_SEAT_SELECTOR = "[data-chat-anchor-key]";
-var ACTIONS_ROOT_SELECTOR = "[data-time-hover-root], [data-actions-reveal]";
 var PENDING_SEAT_SELECTOR = "[data-pending-steering]";
 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 buttons = Array.from(row?.querySelectorAll("button") ?? []);
   const lastButton = buttons.filter((button) => !button.classList.contains(CLASS.button)).at(-1);
   const structural = lastButton?.parentElement;
@@ -1306,7 +1283,6 @@ function RewindButton({ target, sessionId, sessionOf, chatOf, watchChat, current
 function composerText() {
   const surface = composerSurface();
   if (surface === null) return "";
-  if (surface instanceof HTMLTextAreaElement) return surface.value;
   return surface.textContent ?? "";
 }
 async function retractPending(session, itemId, text, setComposerText) {
@@ -1357,8 +1333,8 @@ function createRewindBridge(deps) {
 }
 
 // src/client/build-info.ts
-var PLUGIN_VERSION = true ? "0.7.5" : "dev";
-var BUILD_HASH = true ? "25e8b3ca" : "dev";
+var PLUGIN_VERSION = true ? "0.8.0-alpha.1" : "dev";
+var BUILD_HASH = true ? "ca24fc4e" : "dev";
 
 // src/client/locales.ts
 var zh = {
@@ -1616,7 +1592,6 @@ var name = "dsh-rewind";
 var inject = ["slots", "sessions", "locale", "commandUi"];
 var NS2 = "rewind";
 var HEADER_ACTIONS_SLOT = "conversation.session.header.actions";
-var COMPOSER_TEXTAREA_SELECTOR2 = "[data-input-scroll] textarea, textarea[data-phase]";
 var COMPOSER_EDITABLE_SELECTOR2 = "[data-composer-input]";
 function apply(ctx) {
   rewindLog.info("boot", `loaded v${PLUGIN_VERSION} (build ${BUILD_HASH})`);
@@ -1636,7 +1611,7 @@ function apply(ctx) {
       if (session === void 0) return void 0;
       try {
         const view = uiConversation()?.binding(session.sessionId).target(CHAT_VIEW);
-        return chatSnapshotOf(session, view);
+        return chatSnapshotOf(view);
       } catch {
         return void 0;
       }
@@ -1667,7 +1642,6 @@ function apply(ctx) {
           return void 0;
         }
       },
-      (id) => sessionOf(id),
       sessionId,
       cb
     );
@@ -1777,7 +1751,7 @@ function apply(ctx) {
     for (const name2 of ["rewind", "undo"]) {
       yield commandUi.decorate({ name: name2, ...rewindPopupSpec });
     }
-    const composerSurface2 = () => document.querySelector(COMPOSER_TEXTAREA_SELECTOR2) ?? document.querySelector(COMPOSER_EDITABLE_SELECTOR2);
+    const composerSurface2 = () => document.querySelector(COMPOSER_EDITABLE_SELECTOR2);
     yield () => {
       style.remove();
     };

package/lib/index.js

@@ -1,7 +1,6 @@
 // src/index.ts
 import { createAssistantMessage } from "@deepseek-ai/dsh-llm";
 import { unlink as unlink2 } from "node:fs/promises";
-import * as dshSettings from "@deepseek-ai/dsh-settings";
 import "@deepseek-ai/schemastery";
 
 // src/locales.ts
@@ -111,20 +110,6 @@ function translate(lang, key, params = {}) {
   return text;
 }
 
-// src/session-events.ts
-function eventsOf(session) {
-  const s = session;
-  if (s.snapshotEvents !== void 0) return s.snapshotEvents();
-  if (s.events !== void 0) return s.events;
-  return [];
-}
-
-// src/settings-locale.ts
-function readSettingsSection(provider, ns, brand) {
-  const key = brand?.(ns) ?? ns;
-  return provider.get(key);
-}
-
 // src/rewind.ts
 var RewindError = class extends Error {
   constructor(code, message) {
@@ -1524,7 +1509,7 @@ function mutationPathOf(exec) {
   return void 0;
 }
 function anchorSeqOf(session, cache) {
-  const events = eventsOf(session);
+  const events = session.snapshotEvents();
   const cached = cache.get(session);
   if (cached !== void 0 && cached.eventsLength === events.length) return cached.anchor;
   let anchor = cached?.anchor;
@@ -1702,15 +1687,15 @@ async function executeRewind(ctx, store, fs, invocation, rawTarget, mode, inflig
     }
     let plan;
     try {
-      plan = resolveOrError(eventsOf(agent.session), agent.session.surface.nodes, rawTarget);
+      plan = resolveOrError(agent.session.snapshotEvents(), agent.session.surface.nodes, rawTarget);
     } catch (error) {
       return rewindErrorResult(error);
     }
     const marker = buildMarker();
     let event;
     try {
-      const turn = markerTurnOf(eventsOf(agent.session));
-      const step = markerStepOf(eventsOf(agent.session), turn);
+      const turn = markerTurnOf(agent.session.snapshotEvents());
+      const step = markerStepOf(agent.session.snapshotEvents(), turn);
       agent.session.append("step/start", { turn, step });
       try {
         event = agent.session.append("assistant/message", { turn, step, message: marker }, {
@@ -1764,7 +1749,7 @@ async function handleRewind(ctx, store, fs, invocation, inflight) {
   const session = invocation.agent.session;
   const input = invocation.rawInput.trim();
   if (input === "") {
-    const candidates = listRewindCandidates(eventsOf(session), session.surface.nodes, 1);
+    const candidates = listRewindCandidates(session.snapshotEvents(), session.surface.nodes, 1);
     if (candidates.length === 0) {
       return { kind: "error", text: t("noUserMessages") };
     }
@@ -1776,7 +1761,7 @@ async function handleRewind(ctx, store, fs, invocation, inflight) {
     if (target2 === void 0) return { kind: "error", text: usage() };
     let plan;
     try {
-      plan = resolveOrError(eventsOf(session), session.surface.nodes, target2);
+      plan = resolveOrError(session.snapshotEvents(), session.surface.nodes, target2);
     } catch (error) {
       return rewindErrorResult(error);
     }
@@ -1784,7 +1769,7 @@ async function handleRewind(ctx, store, fs, invocation, inflight) {
     return { kind: "success", text: formatPlan(plan, impacts) };
   }
   if (parts[0] === "__candidates") {
-    const candidates = listRewindCandidates(eventsOf(session), session.surface.nodes);
+    const candidates = listRewindCandidates(session.snapshotEvents(), session.surface.nodes);
     return { kind: "success", text: formatCandidateList(candidates) };
   }
   const target = parts[0];
@@ -1930,15 +1915,16 @@ function apply(ctx, config) {
   const trackedBySession = /* @__PURE__ */ new Map();
   let fsService;
   ctx.inject(["settings"], (settingsCtx) => {
-    const section = readSettingsSection(
-      settingsCtx.settings,
-      "locale",
-      dshSettings.settingsNamespace
-    );
+    const settings = settingsCtx;
+    const section = settings.settings.get("locale");
     if (section?.preference === "zh" || section?.preference === "en") {
       activeLocale = section.preference;
     }
-    const cleanupScope = settingsCtx.settings.register(CLEANUP_SETTINGS_NAMESPACE, CleanupConfigSchema, { base: DEFAULT_CLEANUP_CONFIG });
+    const cleanupScope = settings.settings.register(
+      CLEANUP_SETTINGS_NAMESPACE,
+      CleanupConfigSchema,
+      { base: DEFAULT_CLEANUP_CONFIG }
+    );
     cleanupStore = settingsCleanupStore(cleanupScope);
     void migrateLegacyCleanupConfig(
       resolveCleanupConfigPath(dshHome),

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

@@ -5,7 +5,17 @@
  *
  * @module dsh-rewind/client/hidden
  */
-import type { ChatConversationViewNode, CommandNode } from '@deepseek-ai/dsh-client-runtime/client';
+import type { CommandNode } from '@deepseek-ai/dsh-client-ui-conversation/client';
+/** A chat-snapshot view node as the hiding / composer-refill logic reads it.
+ * The harness's view node shape plus the `anchorSeq` the chat snapshot carries
+ * (the plugin reads `anchorSeq` off each node; it is not declared on the
+ * harness's `ConversationViewNode`). */
+export interface ChatConversationViewNode {
+    readonly key: string;
+    readonly kind?: string;
+    readonly data?: unknown;
+    readonly anchorSeq: number;
+}
 /** Minimal chat snapshot reader the hiding logic needs. */
 export interface HiddenChat {
     readonly order: readonly string[];
@@ -14,55 +24,36 @@ export interface HiddenChat {
     };
 }
 /**
- * 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.
+ * Reader for one session's live chat snapshot. On the 0.1.2-rc.1 line (the
+ * plugin's single baseline) the chat is served by the `uiConversation`
+ * service's named "chat" view (contributed by dsh-client-ui-chat through the
+ * uiSession slot hook).
  */
 export type ChatOf = (session: {
     readonly sessionId: string;
-    getSnapshot(): {
-        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.
+ * snapshot change without polling. The 0.1.2-rc.1 `uiConversation` "chat"
+ * view's 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.
+ * Choose the chat-update subscription for `waitForCommand`: the
+ * `uiConversation` "chat" view's own `subscribe`. Extracted as a pure
+ * channel-selection step so the resolver is unit-testable; the resolver is
+ * 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 (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).
+ * Resolve the chat snapshot from the `uiConversation` "chat" view. The view's
+ * `getSnapshot()` returns undefined until the named view is registered, which
+ * degrades to `undefined` (no targets, no hiding — never a crash).
  */
-export declare function chatSnapshotOf(face: {
-    getSnapshot(): {
-        chat?: unknown;
-    };
-} | undefined, chatView: {
+export declare function chatSnapshotOf(chatView: {
     getSnapshot(): unknown;
 } | undefined): HiddenChat | undefined;
 /**

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

@@ -26,9 +26,27 @@
  *
  * @module dsh-rewind/client
  */
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import type { ISessions } from '@deepseek-ai/dsh-api-session-controller/client';
 export declare const name = "dsh-rewind";
 export declare const inject: string[];
+/**
+ * The client plugin root context read by `apply(ctx)`. Local structural face:
+ * the harness client context is a cordis `Context` augmented by runtime
+ * services, so the plugin declares the subset it reads. `sessions` is the real
+ * `ISessions` from `@deepseek-ai/dsh-api-session-controller`.
+ */
+export interface ClientContext {
+    effect(execute: () => Iterable<unknown>, label?: string): unknown;
+    locale: {
+        register(namespace: string, messages: Record<string, Record<string, string>>): unknown;
+        bind(namespace: string): (key: string) => string;
+        subscribe(cb: () => void): () => void;
+    };
+    sessions: ISessions;
+    get(name: string): unknown;
+    slots: unknown;
+    commandUi: unknown;
+}
 /**
  * Client plugin body: command decoration + parameterized guard + locale + the
  * portal bridge.

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

@@ -13,8 +13,8 @@
  *
  * @module dsh-rewind/client/popover
  */
-import type { SessionFace } from '@deepseek-ai/dsh-client-runtime/client';
-import type { CommandNode } from '@deepseek-ai/dsh-client-runtime/client';
+import type { SessionFace } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { CommandNode } from '@deepseek-ai/dsh-client-ui-conversation/client';
 import { type ChatOf, type ChatWatch } from './hidden.ts';
 import type { RewindKey } from './locales.ts';
 type Translate = (key: RewindKey, params?: Record<string, unknown>) => string;
@@ -33,16 +33,15 @@ export interface PopoverOptions {
     readonly onRetract?: () => void;
     readonly preview: string;
     /**
-     * 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.
+     * Chat reader on the 0.1.2-rc.1 `uiConversation` "chat" 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`.
+     * a command's chat node can be woken when the chat snapshot changes. Passed
+     * straight through to `waitForCommand`.
      */
     readonly watchChat: ChatWatch;
     /** The button that opened the popover (outside-click ignore target). */
@@ -70,7 +69,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, watch?: (cb: () => void) => () => void): Promise<{
+export declare function waitForCommand(session: SessionFace, chatOf: ChatOf, match: (node: CommandNode) => boolean, timeoutMs: number | undefined, watch: (cb: () => void) => () => void): Promise<{
     kind: 'success' | 'error';
     text?: string;
 } | null>;

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

@@ -23,7 +23,7 @@
  * @module dsh-rewind/client/portals
  */
 import { type ReactNode } from 'react';
-import type { SessionFace } from '@deepseek-ai/dsh-client-runtime/client';
+import type { SessionFace } from '@deepseek-ai/dsh-api-session-controller/client';
 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;
@@ -53,26 +53,23 @@ export type PortalTarget = {
 export interface RewindBridgeDeps {
     readonly sessionOf: (sessionId: string) => SessionFace | undefined;
     /**
-     * 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.
+     * Chat reader on the 0.1.2-rc.1 `uiConversation` "chat" view: every chat
+     * snapshot read goes through it. See `chatSnapshotOf` in hidden.ts.
      */
     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`.
+     * snapshot changes. 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
-     * 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.
+     * Session-aware composer writer (see `writeComposer`): the 0.1.2-rc.1
+     * `conversation.input` facade `setDraft` when reachable, else the DOM fill.
+     * Session-scoped so the refill only lands in the session that just rewound.
      */
     readonly setComposerText: (sessionId: string, text: string) => boolean;
 }
@@ -99,20 +96,18 @@ interface ComposerDraftWriter {
     setDraft(text: string): void;
 }
 /**
- * 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,
- * never a throw.
+ * Fill the dsh composer with `text` through the 0.1.2-rc.1 `contenteditable`
+ * DOM 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, never a throw.
  */
 export declare function fillComposer(text: string): boolean;
 /**
- * Dual-channel composer write, mirroring `chatSnapshotOf`: prefer the harness
- * 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.
+ * Composer write: prefer the harness facade's `setDraft` (0.1.2-rc.1, correct
+ * whole-draft replace), then degrade to the DOM `fillComposer` (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 0.1.2-rc.1 session input draft writer, when reachable.
  * @returns whether a channel applied the text.
@@ -136,24 +131,15 @@ export declare function runRewindAndFill(session: SessionFace, seq: number, mode
  * Locate the actions container of a user/steering seat row — the element the
  * ↶ button portals into (the copy/branch IconActions row).
  *
- * @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.
+ * On the 0.1.2-rc.1 line the `data-time-hover-root` marker lives only on the
+ * per-turn tail footer (`TurnTailNodeView`), and the user action row is
+ * revealed via CSS `:has()`. The container is located structurally: the direct
+ * holder of the copy `<button>` (the `MessageIconActions` container, which
+ * mounts that button as a direct child — `MessageIconActions.tsx:83,86`).
  *
  * 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
- * (see `collectTargets`) so the dual-channel finder is exercised directly for
+ * (see `collectTargets`) so the row-shape finder is exercised directly for
  * both durable and pending row shapes without a full React portal render.
  */
 export declare function actionsContainerOf(row: HTMLElement | undefined): HTMLElement | undefined;
@@ -174,10 +160,9 @@ interface RewindPortalsProps extends RewindBridgeDeps {
  * synchronous full-transcript scan inside a commit microtask.
  */
 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`). */
+/** The current composer draft: the 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

@@ -12,10 +12,9 @@
  *
  * It neither imports the client settings typed contract nor depends on the
  * 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.
+ * via the `set(field, value)` method, 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/* 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";
+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/* Standardized on the 0.1.2 harness card look (border-radius 16px + 0.5px\n   border-l4, 0.5px internal separators). */\n.dsh-rewind-cleanup-card {\n  list-style: none;\n  border: 0.5px solid var(--dsw-alias-border-l4);\n  border-radius: 16px;\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: 0.5px 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: 0.5px 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/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 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.
+ * contract) so the host bundle does not type-couple on the client settings
+ * API (0.1.2 adds `mutate`; it is unused here), and the seam the host passes
+ * in isolates the drift 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.5",
+  "version": "0.8.0-alpha.1",
   "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",
@@ -52,7 +52,6 @@
     "client": {
       "inject": [
         "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-ui-commands",
         "@deepseek-ai/dsh-client-ui-conversation",
         "@deepseek-ai/dsh-client-ui-settings"
@@ -74,19 +73,18 @@
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6 || ^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-commands": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-commands": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-fs": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-home-paths": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-sandbox": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.8 || ^0.1.1-rc.2 || ^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-alpha.2"
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-commands": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-commands": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-fs": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-home-paths": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-sandbox": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.2-rc.1"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {
@@ -98,9 +96,6 @@
     "@deepseek-ai/dsh-client-locale": {
       "optional": true
     },
-    "@deepseek-ai/dsh-client-runtime": {
-      "optional": true
-    },
     "@deepseek-ai/dsh-client-ui-commands": {
       "optional": true
     },
@@ -138,29 +133,37 @@
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@deepseek-ai/dsh-agent": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-commands": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-input-trigger": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-command-compact": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-commands": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-compaction": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-compaction-basic": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-fs": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-goal": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-home-paths": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-plan-mode": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-sandbox": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-session-projection": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-session-stats": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-session-title": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-token-meter": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-tools": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-agent": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-attachment": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-scope": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-user-questions": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-commands": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-input-trigger": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-command-compact": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-commands": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-compaction": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-compaction-basic": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-fs": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-goal": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-home-paths": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-plan-mode": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-sandbox": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-session-projection": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-session-stats": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-session-title": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-token-meter": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.2-rc.1",
     "@types/node": "^24.0.0",
     "@types/react": "^18.3.31",
     "@types/react-dom": "^18.3.7",

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

@@ -1,37 +0,0 @@
-/**
- * Cross-channel session event-log reader.
- *
- * 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 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 0.1.1-rc.2 — the
- * rewind semantics are preserved for fork-seeded sessions. `ownEvents()`
- * would drop the inherited prefix and change behaviour.
- *
- * @module dsh-rewind/session-events
- */
-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-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 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,33 +0,0 @@
-/**
- * Version-neutral settings-namespace reading for the host half.
- *
- * 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 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.
- *
- * @module dsh-rewind/settings-locale
- */
-/** Minimal structural face of the settings provider the host reads from. */
-export interface SettingsProviderLike {
-    /**
-     * Read one registered settings section by namespace. Accepts whatever the
-     * 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-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
- * 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;