@davideasden/pi-undo 0.2.32 → 0.2.34

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -19,7 +19,7 @@ Each completed agent run creates a checkpoint that captures both the Pi session
19
19
 
20
20
  ## Requirements
21
21
 
22
- - Pi `0.86.1` 或更高版本(已在 0.86.1 上验证)。`0.84.4` 及更早版本不再受支持,也不在 CI 中测试:早期版本的会话树与扩展生命周期行为不同,不保证撤回语义正确。
22
+ - Pi `1.2.0` 或更高版本(已在 1.2.0 上验证,见 [Pi 1.2.0 兼容验证记录](docs/pi-1.2.0-validation.md))。`1.1.x` 及更早版本不再受支持,也不在 CI 中测试:早期版本的扩展生命周期行为不同(例如 `before_agent_start` 的触发范围与会话 busy 语义),不保证撤回语义正确。历史验证记录见 [Pi 0.86.1 撤回修复与验证记录](docs/pi-0.86.1-validation.md)。
23
23
  - Node.js `22.19.0` or later.
24
24
  - Git available on `PATH` (used internally for content-addressed snapshots).
25
25
 
@@ -167,7 +167,7 @@ recovery_required
167
167
 
168
168
  本机 macOS arm64 的三次 undo 中位数:3,000 包/1 文件从 1,976 ms 降至 924 ms,10,000 包/1 文件从 5,857 ms 降至 2,755 ms;100 文件的子目录撤销从 517 ms 降至 180 ms,混合撤销从 711 ms 降至 186 ms。测量方法和限制见 [原生性能验证记录](docs/native-performance.md)。
169
169
 
170
- 可通过真实 Pi 0.86.1 SDK 和离线 faux provider 运行大型工作区基准;它覆盖 3,000/10,000 个依赖包、修改 1/100 个文件,每组撤回三次并验证重做:
170
+ 可通过真实 Pi 1.2.0 SDK 和离线 faux provider 运行大型工作区基准;它覆盖 3,000/10,000 个依赖包、修改 1/100 个文件,每组撤回三次并验证重做:
171
171
 
172
172
  ```bash
173
173
  PI_UNDO_LARGE_WORKSPACE=1 npx vitest run test/large-workspace.test.ts
@@ -0,0 +1,63 @@
1
+ # Pi 0.86.1 撤回修复与验证记录
2
+
3
+ 验证环境:macOS 26.5.2、arm64、Node.js 23.11.1、Pi SDK 0.86.1。原生路径使用仓库已有的 macOS arm64 helper;本次未修改 Rust 二进制协议。所有 SDK 场景使用离线 faux provider,不请求模型网络。
4
+
5
+ ## 支持范围与行为
6
+
7
+ - 最低支持版本调整为 Pi 0.86.1,开发依赖与测试夹具固定为 0.86.1,不再承诺 0.84.4 兼容。
8
+ - 撤回先停止当前运行,等待输入快照和本轮检查点完成,再选择目标并获取工作区锁。检查点失败会暂停历史,不会撤回上一轮来代替。
9
+ - `/undo-cancel` 请求停止当前撤回或重做。Git 默认 120 秒,操作默认 300 秒,分别通过 `PI_UNDO_GIT_TIMEOUT_MS`、`PI_UNDO_OPERATION_TIMEOUT_MS` 调整。
10
+ - 取消后等在途任务和并行分支收敛,未提交的操作使用独立预算恢复;cursor 已持久提交时继续完成持久化。不能确认子进程停止时保留隔离,拒绝重建 runtime。
11
+ - `/tree` 在适配层区分物理节点、逻辑目标和摘要后的实际逻辑叶。摘要错误或其他扩展取消时,即使缺少 `session_tree` 事件,也会在确认 Pi 导航结束后清理准备事务。
12
+ - runtime 重建及退出会等待旧任务与后台持久化。重建时排队文本恢复到编辑器;迟到的 settled 事件不再追加检查点。
13
+ - 普通文件原生恢复路径将完整拓扑扫描从 7 次降到 5 次,目录枚举采用有界并发。仍发现忽略目录中的嵌套仓库,保留枚举后与恢复后的复核。
14
+ - 沿用 schemaVersion 1 的会话记录、manifest、journal 与 WAL;旧记录仍可读取,不重建缺失或损坏的历史。
15
+
16
+ 长操作和错误的最近一次诊断写入 `<sessionDir>/.pi-undo/diagnostics/<sessionId>-latest.json`,只保留操作 ID、阶段、耗时、已知 Git 子命令名及退出结果,不记录提示词、文件内容、完整参数或进程输出。
17
+
18
+ ## 回归覆盖
19
+
20
+ 真实 SDK 回归包含普通 undo/redo、同一 JSONL 重启重建、第二轮 settled 未结束时撤回、用户节点与根目标导航、摘要导航、摘要失败、其他扩展取消导航。
21
+
22
+ 故障注入包含挂起 Git 和后台后代终止、外部信号终止后清理后代、native helper 取消、TypeScript 部分写入取消、native 写入后验证前取消、cursor 提交前后分流、不可中断任务结束前保留锁、未确认退出时拒绝 runtime 重建,以及丢失事件和排队输入的处理。
23
+
24
+ 验证命令:
25
+
26
+ ```bash
27
+ npm run typecheck
28
+ npm test
29
+ PI_UNDO_DISABLE_NATIVE=1 npm test
30
+ cargo test --manifest-path native/pi-undo-fs/Cargo.toml
31
+ npm run pack:dry-run
32
+ PI_UNDO_LARGE_WORKSPACE=1 PI_UNDO_BENCH_REPORT=/tmp/pi-undo-large-results.jsonl npx vitest run test/large-workspace.test.ts
33
+ ```
34
+
35
+ 验证结果:
36
+
37
+ | 检查 | 结果 |
38
+ | --- | --- |
39
+ | TypeScript 类型检查 | 通过 |
40
+ | 标准完整套件 | 593 项通过,4 个按需大型基准用例跳过 |
41
+ | 禁用 native helper 的完整套件 | 585 项通过,12 项按条件跳过 |
42
+ | Rust 原生测试 | 3 项通过 |
43
+ | 大型工作区真实 SDK 基准 | 4 组通过,每组三次撤回/重做 |
44
+ | npm 打包清单、Git 空白错误检查 | 通过 |
45
+
46
+ 标准套件包含 native helper 的专项测试;回退套件跳过依赖 native 能力的用例。大型基准单独显式开启并通过,不计入标准套件的通过数。
47
+
48
+ ## 大型工作区测量
49
+
50
+ 每组构建 3,000 或 10,000 个模拟依赖包,每包包含 `lib/index.js`,依赖目录由 `.gitignore` 忽略;工作区不初始化真实 Git 仓库。实际修改 1 或 100 个文件,使用真实 Pi SDK 执行三次 undo/redo,逐文件断言内容与历史状态。下面的耗时仅统计 undo。
51
+
52
+ | 依赖包数 | 修改文件数 | 三次撤回耗时(毫秒) | 中位数(毫秒) | 每次完整扫描 | 进程峰值 RSS(MiB) | 事件循环延迟 P99(毫秒) |
53
+ | ---: | ---: | --- | ---: | --- | ---: | ---: |
54
+ | 3,000 | 1 | 1743 / 1769 / 1978 | 1769 | 5 / 5 / 5 | 228 | 13 |
55
+ | 3,000 | 100 | 1811 / 1804 / 1800 | 1804 | 5 / 5 / 5 | 354 | 13 |
56
+ | 10,000 | 1 | 5366 / 6051 / 6276 | 6051 | 5 / 5 / 5 | 422 | 15 |
57
+ | 10,000 | 100 | 5730 / 5666 / 6138 | 5730 | 5 / 5 / 5 | 447 | 15 |
58
+
59
+ RSS 是同一测试进程连续执行各组时的观测峰值,包含 Pi SDK 和缓存,不是单次撤回的新增内存。事件循环延迟覆盖三轮撤回与重做,不等同于 TUI 的绘制耗时。墙钟数据受文件系统和机器负载影响,因此常规 CI 使用扫描次数和正确性断言,不设置固定耗时门槛。
60
+
61
+ ## 边界
62
+
63
+ 本次测试平台为 macOS arm64,未在 Windows 或 Linux 上重新执行整套验证。不可中断的底层磁盘 I/O 必须实际结束后才安全释放隔离,不能承诺任意磁盘故障都在固定秒数内解除锁。大型工作区仍需要完整扫描;本次没有增加 Rust 目录扫描协议或默认排除目录。
@@ -0,0 +1,31 @@
1
+ # Pi 1.2.0 兼容验证记录
2
+
3
+ 验证环境:macOS arm64、Node.js 23.11.1、Pi SDK 1.2.0(`~/.pi/agent/install/releases/1.2.0`)。所有 SDK 场景使用离线 faux provider,不请求模型网络。
4
+
5
+ ## 结论
6
+
7
+ pi-undo 0.2.32 在 Pi 1.2.0 上无需改动源码即可运行。最低支持版本由 0.86.1 提升到 1.2.0,开发依赖与测试夹具固定为 1.2.0。
8
+
9
+ ## 验证内容
10
+
11
+ | 检查 | 0.86.1 | 1.2.0 |
12
+ | --- | --- | --- |
13
+ | `npm run typecheck`(`src`/`extensions`/`test`) | 通过 | 通过 |
14
+ | `npm test` | 24 文件通过/1 跳过,635 项通过、4 项跳过 | 完全一致 |
15
+ | 真实加载器加载 `extensions/pi-undo.ts` | — | 0 错误,注册 `undo`/`redo`/`diff`/`undo-cancel`/`undo-recover` 与全部 8 个事件处理器 |
16
+
17
+ 加载器检查使用 1.2.0 的 `discoverAndLoadExtensions()`(与 Pi 启动时相同的 jiti 路径),在隔离目录中加载扩展文件,断言 `errors` 为空且命令与事件齐全。跳过项是需显式开启的大型工作区基准(`PI_UNDO_LARGE_WORKSPACE=1`)。
18
+
19
+ ## 1.1.0 → 1.2.0 破坏性变更核对
20
+
21
+ - `before_agent_start` 现在是联合类型,且对 `pi.sendMessage(..., { triggerTurn: true })` 触发的自定义消息 run 也会触发。pi-undo 的处理器不读取事件对象;自定义 run 没有 staged 输入,`beforeAgentStart()` 与 `agentSettled()` 都会提前返回,因此只多一次空调用。
22
+ - 会话在 run 启动期间(含 `before_agent_start` 处理器内)记为 busy,`pi.sendUserMessage()` 此时需要 `deliverAs`。pi-undo 只在撤回/重做完成且空闲后重放排队输入;即使出现竞态,运行时也会把错误作为扩展错误上报,不会中断 Pi。
23
+ - `agent_settled` 新增 `aborted` 字段,纯增量,pi-undo 不使用。
24
+
25
+ ## 版本解析
26
+
27
+ Pi 的 jiti 加载器通过虚拟模块把 `@earendil-works/pi-coding-agent`、`@earendil-works/pi-tui` 等映射到运行实例,因此扩展不会与本地 `node_modules` 中的旧版本混用。
28
+
29
+ ## 边界
30
+
31
+ 未在 Windows/Linux 上重复整套验证;未覆盖与其他扩展同时触发 `before_agent_start` 的交互式 TUI 场景。0.86.1 的历史记录见 [pi-0.86.1-validation.md](pi-0.86.1-validation.md)。
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@davideasden/pi-undo",
3
- "version": "0.2.32",
3
+ "version": "0.2.34",
4
4
  "description": "Persistent workspace undo and redo for Pi",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -35,7 +35,9 @@
35
35
  "src",
36
36
  "native/bin",
37
37
  "README.md",
38
- "docs/native-performance.md"
38
+ "docs/native-performance.md",
39
+ "docs/pi-0.86.1-validation.md",
40
+ "docs/pi-1.2.0-validation.md"
39
41
  ],
40
42
  "scripts": {
41
43
  "test": "vitest run",
@@ -47,16 +49,16 @@
47
49
  "pack:dry-run": "npm pack --dry-run"
48
50
  },
49
51
  "peerDependencies": {
50
- "@earendil-works/pi-coding-agent": ">=0.86.1",
51
- "@earendil-works/pi-tui": ">=0.86.1"
52
+ "@earendil-works/pi-coding-agent": ">=1.2.0",
53
+ "@earendil-works/pi-tui": ">=1.2.0"
52
54
  },
53
55
  "dependencies": {
54
56
  "proper-lockfile": "4.1.2"
55
57
  },
56
58
  "devDependencies": {
57
- "@earendil-works/pi-ai": "0.86.1",
58
- "@earendil-works/pi-coding-agent": "0.86.1",
59
- "@earendil-works/pi-tui": "0.86.1",
59
+ "@earendil-works/pi-ai": "1.2.0",
60
+ "@earendil-works/pi-coding-agent": "1.2.0",
61
+ "@earendil-works/pi-tui": "1.2.0",
60
62
  "@types/node": "24.12.4",
61
63
  "@types/proper-lockfile": "4.1.4",
62
64
  "typescript": "5.9.3",