dsh-diff-approval 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wu Zhiwei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+# dsh-diff-approval
+
+English | [中文](README.zh.md)
+
+A DeepSeek Harness (DSH) plugin for pending-change review: it automatically tracks every successful `edit` / `write` tool call, folds all unhandled changes into one entry per file, and shows each file's diff with Keep/Revert in the sidebar — no git involved.
+
+## ✨ Features
+
+- **Diff view**: syntax-highlighted diff with +/− counts, change-block jump (previous/next diff), and drag-to-copy line references.
+- **Keep / Revert**: one decision per file. Keep accepts the changes; Revert writes the file back to its earliest basis (a created file is removed, a deleted tracked file is restored).
+- **Persistence**: pending state is stored per workspace at `<dshHome>/diff-approval/workspaces/<workspaceId>.json` and survives restarts.
+
+## 📦 Install
+
+```sh
+dsh plugin --profile web add dsh-diff-approval
+```
+
+or manually: add the package to your profile's `package.json` dependencies and insert this row into the profile's `cordis.patch.yml`:
+
+```yaml
+- insert:
+    - id: diff-approval
+      name: dsh-diff-approval
+      # Optional: relocate durable pending state (defaults to
+      # <dshHome>/diff-approval/workspaces).
+      # config:
+      #   storageDir: ~/dsh-pending
+```
+
+Then restart `dsh web`.
+
+## 🚀 Usage
+
+1. Work with the agent as usual — successful `edit` / `write` calls are recorded automatically.
+2. Click the **Pending changes** action at the sidebar footer (the badge shows the count).
+3. Click a file row to expand its full diff; use **Previous diff** / **Next diff** to jump between change blocks.
+4. **Keep** accepts the file's changes; **Revert** restores its earliest basis. The row then leaves the list.
+
+## 📝 Notes
+
+- Only `edit` and `write` are tracked. Deletions made outside these tools (e.g. shell `rm`) are sensed only for tracked files: the entry turns "File is gone" and its Revert restores the file.
+- Reverting a created file deletes it (the fs seam has no delete API).
+- Sessions with no workspace keep their entries memory-only; corrupt persistence files are rejected and can be deleted to reset.
+
+## 🛠 Development
+
+```sh
+corepack pnpm install
+pnpm run typecheck   # tsc over both faces
+pnpm run build       # emits lib/index.js and lib/client.js
+pnpm test
+```

package/README.zh.md

@@ -0,0 +1,53 @@
+# dsh-diff-approval
+
+[English](README.md) | 中文
+
+一个 DeepSeek Harness（DSH）待处理改动审核插件：自动跟踪每次成功的 `edit` / `write` 工具调用，把一个文件的全部未处理改动合并为一条待处理条目，在侧边栏展示每个文件的完整差异，支持保留 / 回退——全程不依赖 git。
+
+## ✨ 功能
+
+- **差异视图**：语法高亮与 +/− 统计，按差异块跳转（上一处 / 下一处），拖选即可复制行引用。
+- **保留 / 回退**：每个文件一次决定。保留即接受；回退把文件写回最早基准（新建文件则删除，已被删除的跟踪文件则恢复）。
+- **持久化**：待处理状态按 workspace 落盘至 `<dshHome>/diff-approval/workspaces/<workspaceId>.json`，跨重启保留。
+
+## 📦 安装
+
+```sh
+dsh plugin --profile web add dsh-diff-approval
+```
+
+或手动：把本包加入 profile 的 `package.json` 依赖，并在该 profile 的 `cordis.patch.yml` 中加入：
+
+```yaml
+- insert:
+    - id: diff-approval
+      name: dsh-diff-approval
+      # 可选：把落盘位置迁到别处（默认是
+      # <dshHome>/diff-approval/workspaces）。
+      # config:
+      #   storageDir: ~/dsh-pending
+```
+
+然后重启 `dsh web`。
+
+## 🚀 用法
+
+1. 照常和 agent 对话——成功的 `edit` / `write` 调用会自动记录。
+2. 点击侧边栏底部的 **待处理改动** 入口（角标显示数量）。
+3. 点击文件行展开该文件的完整差异，用 **上一处差异** / **下一处差异** 在差异块间跳转。
+4. **保留** 接受该文件的改动；**回退** 恢复其最早基准。处理后该行离开列表。
+
+## 📝 注意事项
+
+- 只跟踪 `edit` 与 `write`。通过这两个工具以外的删除（如 shell `rm`）只能对已跟踪的文件感知：条目显示"文件已不存在"，回退即恢复。
+- 回退新建文件会删除该文件（文件系统接缝没有删除 API）。
+- 没有 workspace 的会话条目仅存内存；损坏的落盘文件会被拒绝，删除即可重置。
+
+## 🛠 开发
+
+```sh
+corepack pnpm install
+pnpm run typecheck   # 两个编译面的 tsc
+pnpm run build       # 产出 lib/index.js 与 lib/client.js
+pnpm test
+```

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# dsh-diff-approval bundle patch: the row that mounts the pending-change
+# review plugin into every profile that lists this bundle. Applied as a
+# bundle layer (before the profile's own cordis.patch.yml).
+- insert:
+    - id: diff-approval
+      name: dsh-diff-approval