Skip to content

Commit 0ebf8bb

Browse files
genednaclaude
andcommitted
docs(plan): close FU-19 after v0.40.8 docker job success
FU-19 D group green: docker.yml run 36148786334, job docker, success on 0945f3d. The C group ran on a clean copy of the release tree against a fresh test database (lib 1796 passed; the 6 baseline cases plus one ephemeral-port readiness failure, 3/3 alone with its whole target 62/62). Mark FU-19 Lifecycle/Acceptance done/complete and tick its checklists. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Eli Ma <eli@patch.sh>
1 parent 0945f3d commit 0ebf8bb

1 file changed

Lines changed: 15 additions & 15 deletions

File tree

‎docs/plan/plan-20260923.md‎

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -2036,7 +2036,7 @@
20362036
20372037
**Task type:** `implementation`
20382038
2039-
**Lifecycle / Acceptance:** `in-progress` / `remote-pending`(A/B 按终态重跑:Verification 五条命令通过——`fu19_` 6 例、FU-18 栅栏与存储回归 26 例、`tag_router` 3 例、`integration_api_write_trunk` 的 `delete_entry_reject_import_repo_409` / `import_repo_edit_save_commit_strict_fsck` / `api_write_import_namespace_guard` 3 例与 `tag_` 8 例;末项文档锚点与人工核对通过;fmt、clippy rc=0,`cargo build` / `cargo build --tests` rc=0(仅基线同有的 `ld` `__eh_frame` 提示);ImportRepo / 推送队列 / 存储 / 错误 / API 库回归 436 通过,唯一失败 `jupiter::migration::tests::import_repo_cleanups_migration_applies` 系共享库 `public` 被 FU-18 原 smoke 配方污染(清理待用户确认);反向验证 26 组(每组只改一个生产缝、跑对应用例组,源文件逐字节还原)全部失败:R1 edit/save 预读去掉 `removed_or`、R2 `removed_or` 去掉 `[code:409]` 标记、R3 只比路径不比 id、R4 不做存活检查即改写、R5–R7 与 R24 默认分支 / commit / 子树 / 根树改回 `unwrap`、R8–R11 四个写事务去掉锁、R12 tag 预检去掉 `removed_or`、R13 `map_ceres_error` 去掉 409 分支、R14 锁改 `FOR UPDATE`、R15 锁在写事务之前取并释放、R16 `git_tag` 在连接池插入、R17 锁用规范化路径、R18 `save_entry` 批不取锁、R19 默认分支经连接池 `update_ref`(HEAD 写法,panic)、R20–R22 锁留在事务而 lightweight ref / `git_tag` 删除 / 默认分支写改走连接池、R23 生产 `save_file_edit` 的 ref 写改回连接池 `update_ref`、R25 tag 删除去掉仓库过滤、R26 edit/save 先写 ref 后写对象批;ER-05 独立评审 R1 FAIL(1×P1 + 13×P2)已处置、R2 PASS(11×P2:9 条落实、2 条有据不采纳),见修订历史;另注:R1 的评审输入 diff 曾在反向验证 R3 生效时生成,已按还原后的树重新生成;Codex R1 首次因用量上限未运行,重置后于 22:30 补跑:PASS(无发现);C 组在 bump 后的 `0.40.8` 树的干净副本上(HEAD + 本卡 9 个文件 + 版本号,其它会话的 11 个未提交文件按 HEAD 还原、未跟踪的 `scripts/drop_test_schemas.sh` 从副本删除),测试库为新建的空库 `mega2_fu19_gate`:fmt、clippy 0 警告、`cargo build` 0 警告、`cargo build --tests` 仅基线同有的 `ld` `__eh_frame` 提示;`cargo test --all --no-fail-fast` 18 个 target 全部运行,lib 阶段 1796 通过 / 0 失败 / 1 忽略,失败集为 6 个基线环境用例 + `integration_api_write_trunk::path_provision_rejects_policy_violations`(启动后第一条对本用例库的查询报 `relation "mega_refs" does not exist`:就绪判定只是向预留后释放的临时端口 TCP 连通,被测服务尚未完成迁移即被判定就绪,属临时端口类;与本卡改动无关);该用例在同一副本与门禁库上单独复跑 3/3 通过、整 target 62/62 通过,按「并发会话例外」口径接受;本次运行留下的 805 个测试 schema 都在门禁库内。待推送、tag、Release 与 D 组)
2039+
**Lifecycle / Acceptance:** `done` / `complete`(A/B 按终态重跑:Verification 五条命令通过——`fu19_` 6 例、FU-18 栅栏与存储回归 26 例、`tag_router` 3 例、`integration_api_write_trunk` 的 `delete_entry_reject_import_repo_409` / `import_repo_edit_save_commit_strict_fsck` / `api_write_import_namespace_guard` 3 例与 `tag_` 8 例;末项文档锚点与人工核对通过;fmt、clippy rc=0,`cargo build` / `cargo build --tests` rc=0(仅基线同有的 `ld` `__eh_frame` 提示);ImportRepo / 推送队列 / 存储 / 错误 / API 库回归 436 通过,唯一失败 `jupiter::migration::tests::import_repo_cleanups_migration_applies` 系共享库 `public` 被 FU-18 原 smoke 配方污染(清理待用户确认);反向验证 26 组(每组只改一个生产缝、跑对应用例组,源文件逐字节还原)全部失败:R1 edit/save 预读去掉 `removed_or`、R2 `removed_or` 去掉 `[code:409]` 标记、R3 只比路径不比 id、R4 不做存活检查即改写、R5–R7 与 R24 默认分支 / commit / 子树 / 根树改回 `unwrap`、R8–R11 四个写事务去掉锁、R12 tag 预检去掉 `removed_or`、R13 `map_ceres_error` 去掉 409 分支、R14 锁改 `FOR UPDATE`、R15 锁在写事务之前取并释放、R16 `git_tag` 在连接池插入、R17 锁用规范化路径、R18 `save_entry` 批不取锁、R19 默认分支经连接池 `update_ref`(HEAD 写法,panic)、R20–R22 锁留在事务而 lightweight ref / `git_tag` 删除 / 默认分支写改走连接池、R23 生产 `save_file_edit` 的 ref 写改回连接池 `update_ref`、R25 tag 删除去掉仓库过滤、R26 edit/save 先写 ref 后写对象批;ER-05 独立评审 R1 FAIL(1×P1 + 13×P2)已处置、R2 PASS(11×P2:9 条落实、2 条有据不采纳),见修订历史;另注:R1 的评审输入 diff 曾在反向验证 R3 生效时生成,已按还原后的树重新生成;Codex R1 首次因用量上限未运行,重置后于 22:30 补跑:PASS(无发现);C 组在 bump 后的 `0.40.8` 树的干净副本上(HEAD + 本卡 9 个文件 + 版本号,其它会话的 11 个未提交文件按 HEAD 还原、未跟踪的 `scripts/drop_test_schemas.sh` 从副本删除),测试库为新建的空库 `mega2_fu19_gate`:fmt、clippy 0 警告、`cargo build` 0 警告、`cargo build --tests` 仅基线同有的 `ld` `__eh_frame` 提示;`cargo test --all --no-fail-fast` 18 个 target 全部运行,lib 阶段 1796 通过 / 0 失败 / 1 忽略,失败集为 6 个基线环境用例 + `integration_api_write_trunk::path_provision_rejects_policy_violations`(启动后第一条对本用例库的查询报 `relation "mega_refs" does not exist`:就绪判定只是向预留后释放的临时端口 TCP 连通,被测服务尚未完成迁移即被判定就绪,属临时端口类;与本卡改动无关);该用例在同一副本与门禁库上单独复跑 3/3 通过、整 target 62/62 通过,按「并发会话例外」口径接受;本次运行留下的 805 个测试 schema 都在门禁库内。提交 `0945f3d`、tag `v0.40.8` 与 GitHub Release 已发布;D 组 `docker.yml` run `36148786334` 的 `docker` job 对 `0945f3d` 为 success)
20402040
20412041
**Description:** 按 ADR-FU-09 第 5 条,把 `ImportApiService` 的 `edit/save` 默认分支更新、tag 创建(`git_tag` 行 + ref)、tag 删除(ref + `git_tag` 行)改为单事务:先 `lock_live_import_repo`,再写 `import_refs` / `git_tag` 行;失败返回 `IMPORT_REPO_REMOVED`(该请求的对象行经 `save_entry`,已由 FU-18 在写入时栅栏)。edit/save 的对象行经 FU-18 `save_entry`、默认分支 ref 在其后自己的带锁事务里写;annotated tag 的 `git_tag` 行与 ref、lightweight tag 的 ref、tag 删除的 ref 与 `git_tag` 行各一事务;预读失败时再检存活(`removed_or`),仓库已被清理即 `IMPORT_REPO_REMOVED`;tag 路由的 `map_ceres_error` 映射 409。唯一行为轴是「产品 API 写路径对清理的互斥」。
20422042
@@ -2059,23 +2059,23 @@
20592059
20602060
**Acceptance criteria:**
20612061
2062-
- [ ] 具名用例 `fu19_edit_save_after_detach_rejected` 通过。
2063-
- [ ] 具名用例 `fu19_tag_create_after_detach_rejected` 通过。
2064-
- [ ] 具名用例 `fu19_tag_delete_after_detach_rejected` 通过。
2065-
- [ ] 具名用例 `fu19_api_lock_serializes_with_detach` 通过。
2066-
- [ ] 具名用例 `fu19_edit_save_after_detach_writes_no_rows` 通过(对象行与 ref 均零新增)。
2067-
- [ ] 具名用例 `fu19_tag_create_rolls_back_atomically` 通过(`git_tag` 行与 ref 同事务,失败时两者皆无)。
2068-
- [ ] `docs/refactoring/directory-entry-api.md` 登记 ImportRepo 产品写在清理期间返回 `IMPORT_REPO_REMOVED`。
2069-
- [ ] `docs/errors.md` 的 `IMPORT_REPO_REMOVED` 出现场景把 `edit/save`(预读与默认分支 ref 写)、tag 创建与 tag 删除三个 API 登记为 409。
2062+
- [x] 具名用例 `fu19_edit_save_after_detach_rejected` 通过。
2063+
- [x] 具名用例 `fu19_tag_create_after_detach_rejected` 通过。
2064+
- [x] 具名用例 `fu19_tag_delete_after_detach_rejected` 通过。
2065+
- [x] 具名用例 `fu19_api_lock_serializes_with_detach` 通过。
2066+
- [x] 具名用例 `fu19_edit_save_after_detach_writes_no_rows` 通过(对象行与 ref 均零新增)。
2067+
- [x] 具名用例 `fu19_tag_create_rolls_back_atomically` 通过(`git_tag` 行与 ref 同事务,失败时两者皆无)。
2068+
- [x] `docs/refactoring/directory-entry-api.md` 登记 ImportRepo 产品写在清理期间返回 `IMPORT_REPO_REMOVED`。
2069+
- [x] `docs/errors.md` 的 `IMPORT_REPO_REMOVED` 出现场景把 `edit/save`(预读与默认分支 ref 写)、tag 创建与 tag 删除三个 API 登记为 409。
20702070
20712071
**Verification:**
20722072
2073-
- [ ] `source .env.test && cargo test -p mega2 --lib 'ceres::api_service::import_api_service::tests::fu19_'`(`(new)` 六例:detach 后(未清扫 / 已清扫 / 同路径重新导入后)的陈旧处理器 `edit/save`、annotated 与 lightweight tag 创建、tag 删除(含不存在的名字)均 `IMPORT_REPO_REMOVED`(409)、不 panic、不写 `import_refs` / `git_tag` 行(被拒的删除保留既有 `git_tag` 行给清扫);存活仓库缺默认分支 / commit / 根 tree / 子 tree 为 404 而非 409;FU-15 别名行在规范行清理后仍可写;四个写事务(默认分支 ref、annotated tag、lightweight tag、tag 删除)各自以共享锁(`FOR UPDATE NOWAIT` 失败、`FOR SHARE NOWAIT` 成功)先持锁、提交前其写对其它连接不可见,detach 等待并随后删除其行;生产 `edit/save` 到达默认分支 ref 写时持有共享锁;detach 先持行时生产入口等待后 409、零行;`save_entry` 提交后、ref 写前被清理时 ref 写为 409;annotated tag 在 ref 写失败时 `git_tag` 行同时回滚、胜者的行不受影响)
2074-
- [ ] `source .env.test && cargo test -p mega2 --lib -- 'jupiter::service::import_service::tests::' 'jupiter::storage::git_db_storage::tests::'`(FU-18 栅栏与存储回归)
2075-
- [ ] `source .env.test && cargo test -p mega2 --lib 'api::router::tag_router::'`(tag 路由回归,`map_ceres_error` 改动)
2076-
- [ ] `source .env.test && cargo test -p mega2 --test integration_api_write_trunk -- --test-threads=1 --exact delete_entry_reject_import_repo_409 import_repo_edit_save_commit_strict_fsck api_write_import_namespace_guard`(既有:409 标记剥离;存活 ImportRepo 的 edit/save 仍 200 且严格 fsck;清理后分派为 400)
2077-
- [ ] `source .env.test && cargo test -p mega2 --test integration_api_write_trunk -- --test-threads=1 tag_`(Monorepo tag wire 不变)
2078-
- [ ] `test -f docs/refactoring/directory-entry-api.md && rg -n "IMPORT_REPO_REMOVED" docs/refactoring/directory-entry-api.md docs/errors.md docs/refactoring/trunk-push.md`(锚点定位用)+ 人工核对
2073+
- [x] `source .env.test && cargo test -p mega2 --lib 'ceres::api_service::import_api_service::tests::fu19_'`(`(new)` 六例:detach 后(未清扫 / 已清扫 / 同路径重新导入后)的陈旧处理器 `edit/save`、annotated 与 lightweight tag 创建、tag 删除(含不存在的名字)均 `IMPORT_REPO_REMOVED`(409)、不 panic、不写 `import_refs` / `git_tag` 行(被拒的删除保留既有 `git_tag` 行给清扫);存活仓库缺默认分支 / commit / 根 tree / 子 tree 为 404 而非 409;FU-15 别名行在规范行清理后仍可写;四个写事务(默认分支 ref、annotated tag、lightweight tag、tag 删除)各自以共享锁(`FOR UPDATE NOWAIT` 失败、`FOR SHARE NOWAIT` 成功)先持锁、提交前其写对其它连接不可见,detach 等待并随后删除其行;生产 `edit/save` 到达默认分支 ref 写时持有共享锁;detach 先持行时生产入口等待后 409、零行;`save_entry` 提交后、ref 写前被清理时 ref 写为 409;annotated tag 在 ref 写失败时 `git_tag` 行同时回滚、胜者的行不受影响)
2074+
- [x] `source .env.test && cargo test -p mega2 --lib -- 'jupiter::service::import_service::tests::' 'jupiter::storage::git_db_storage::tests::'`(FU-18 栅栏与存储回归)
2075+
- [x] `source .env.test && cargo test -p mega2 --lib 'api::router::tag_router::'`(tag 路由回归,`map_ceres_error` 改动)
2076+
- [x] `source .env.test && cargo test -p mega2 --test integration_api_write_trunk -- --test-threads=1 --exact delete_entry_reject_import_repo_409 import_repo_edit_save_commit_strict_fsck api_write_import_namespace_guard`(既有:409 标记剥离;存活 ImportRepo 的 edit/save 仍 200 且严格 fsck;清理后分派为 400)
2077+
- [x] `source .env.test && cargo test -p mega2 --test integration_api_write_trunk -- --test-threads=1 tag_`(Monorepo tag wire 不变)
2078+
- [x] `test -f docs/refactoring/directory-entry-api.md && rg -n "IMPORT_REPO_REMOVED" docs/refactoring/directory-entry-api.md docs/errors.md docs/refactoring/trunk-push.md`(锚点定位用)+ 人工核对
20792079
20802080
**Dependencies:** FU-18(栅栏原语与清扫接线)。
20812081

0 commit comments

Comments
 (0)