Skip to content

Commit e0168b8

Browse files
committed
v0.41.76: HP-04 tree source primitives
Signed-off-by: Eli Ma <eli@patch.sh>
1 parent f26b281 commit e0168b8

7 files changed

Lines changed: 748 additions & 11 deletions

File tree

‎Cargo.lock‎

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎Cargo.toml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[package]
22
name = "mega2"
3-
version = "0.41.75"
3+
version = "0.41.76"
44
edition = "2024"
55
license = "MIT OR Apache-2.0"
66
description = "Monorepo engine and Git hosting server for AI agents: trunk-based storage, Git Smart HTTP, Git LFS, OCI registry, and Agent Session Capture"

‎docs/plan/plan-20261002.md‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -149,6 +149,7 @@
149149
| 2026-10-06 | HP-03 发布完成 | `v0.41.74` 承载提交 `0bad38b`、注释 tag 与 GitHub Release 已创建;rebase 后的 C 组在第六次完整套件通过,Docker D 组 run `37341422201` 成功。 | 无拆卡 | HP-03、计划状态、ER-04 C/D |
150150
| 2026-10-06 | HP-35 本地验收与 ER-05 复审 | 按固定 SHA `e6dfb95e45f64f3dcd20b0152847d70dbbaa1328` 复核 Josh 用例;Claude HP35-R1 的源侧 K 次序 P1 已关闭,R2–R7 PASS;Codex HP35-R8 PASS。两条定向验证、18 条视图单测、格式、Clippy、全量测试与构建门通过。 | 无拆卡 | HP-35、设计 §2.2/§6.5、Review log、ER-04 C/D |
151151
| 2026-10-06 | HP-35 发布完成 | `v0.41.75` 承载提交 `5635d7b`、注释 tag 与 GitHub Release 已创建;Docker D 组 run `37348697475` 成功。 | 无拆卡 | HP-35、计划状态、ER-04 C/D |
152+
| 2026-10-06 | HP-04 本地验收与 ER-05 复审 | Claude HP04-R3 PASS、Codex HP04-R4 PASS;六条定向验证、静态守卫、格式、Clippy、全量测试与构建门通过。`v0.41.76` 等待推送、tag、Release 与 Docker D 组。 | 无拆卡 | HP-04、设计 §4.1、Review log、ER-04 C/D |
152153

153154
## 已决议设计决策
154155

@@ -1128,7 +1129,7 @@
11281129

11291130
**Task type:** `implementation`
11301131

1131-
**Lifecycle / Acceptance:** `pending` / 空
1132+
**Lifecycle / Acceptance:** `in-progress` / `remote-pending`
11321133

11331134
**Description:** 实现 tree 的读取、路径定位与构造原语(设计 §4.1「缺对象不等于路径不存在」,以及「实现要点」中的建树与 EMPTY_TREE),作为过滤器求值与投影共用的底层。唯一的行为轴是纯计算:由 tree id 得到 tree 内容或路径定位结果,由条目列表得到新建 tree。本卡拆出 HP-27(过滤器在 tree 上的求值与空树规范)。范围:
11341135
- `MissingObject { tree_id, reason }`:即设计 §4.1「读取原语」中的 `MissingObject`,`tree_id` 为所请求的 id。原因有三种,变体名以实现为准:
@@ -5968,6 +5969,10 @@ Result 只允许 `PASS` 或 `FAIL`。`FAIL` 必须列出 P0/P1 条目,并在
59685969
| HP35-R2–R6 | HP-35 修订与 Claude Code 复审 | PASS | P0 0;P1 0 | 输出侧 K、两坐标相交顺序、性能预算与回归用例均已同步到设计和任务卡 | `target/tmp/hp35/review-r2.txt`…`review-r6.txt` |
59695970
| HP35-R7 | HP-35 当前差异,Claude Code 最终只读复审 | PASS | P0 0;P1 0 | P2:修正过期证据锚点与 HP-35 用例归属,随本地验收记录关闭 | `target/tmp/hp35/review-r7.txt` |
59705971
| HP35-R8 | HP-35 语义、K 次序、测试与范围,Codex 独立复审 | PASS | P0 0;P1 0;P2 0 | 两条 HP-35 Verification、视图单测、ER-04 本地质量门与发布记录 | 当前差异、设计 §2.2/§6.5、任务卡 |
5972+
| HP04-R1 | HP-04 初始实现,Claude Code 只读审查 | FAIL | P0 0;P1 1:六类读取失败未逐例断言 `MissingObject.tree_id`。以完整错误对象比较关闭 | P2:路径零段分支、建树错误变体与设计措辞在后续轮次处理 | `target/tmp/hp04/review-r1.txt` |
5973+
| HP04-R2 | HP-04 P1 修订,Claude Code 只读复审 | PASS | P0 0;P1 0 | P2:零段读取语义、建树错误变体与「未预取」措辞均在 HP04-R3 前补齐 | `target/tmp/hp04/review-r2.txt` |
5974+
| HP04-R3 | HP-04 最终实现,Claude Code 只读复审 | PASS | P0 0;P1 0 | P2 0:零段行为有注释和用例;建树错误类型有断言;设计文字补全;EMPTY_TREE 大写 hex 用例已通过 | `target/tmp/hp04/review-r3.txt` |
5975+
| HP04-R4 | HP-04 当前差异,Codex 独立复审 | PASS | P0 0;P1 0;P2 0 | 共享解析、显式 kind、读取边界、重名与 EMPTY_TREE 契约同卡片一致 | 六条 HP-04 Verification、模块测试、静态守卫与当前差异 |
59715976

59725977
## 非目标与延后项
59735978

‎docs/refactoring/history-projection.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -724,6 +724,7 @@ fn filter_tree(F, T) -> Result<TreeId, MissingObject>:
724724

725725
**缺对象不等于路径不存在【决策】。**
726726
- **读取原语。** `filter_tree`、`lookup_path`、`subtract_paths`、`overlay_disjoint` 与 4.3 的 `is_empty_root`,都只经由 `read_tree(id) -> Result<Tree, MissingObject>` 读 tree:先查 `mega_view_object`,其余查 `mega_tree`。行不存在、字节无法解析,都返回 `MissingObject { tree_id }`,告警中注明属于哪一种。解析用 `ObjectHash::from_hex_for_kind(kind, tree_id)?` 加 `<Tree as ObjectTrait>::from_bytes`:它出错时返回 Err,按 id 的 kind 切分条目(git-internal `tree.rs` 约 L408–411)。不用 `Tree::from_mega_model`,它会 panic,且依赖 thread-local kind(`converter.rs` 约 L857–863)。
727+
- **读取原语的细化(HP-04)。** 「未预取」是除「行不存在」「字节无法解析」外的第三种 `MissingObject` 原因,表示 TreeSource 没有加载该 id;读取同步且不访问数据库(ADR-HP-02),它不表示库中没有该行,不属于本节所说的缺对象,不进入缺失集合,调用方不得据此按 §4.4 把水位停在 s − 1。`read_tree(EMPTY_TREE)` 不经 TreeSource,直接返回空条目的 tree,即使没有对应行也不返回 `MissingObject`。本批缺失集合中的 id 是「行不存在」;id 长度与 kind 不符、`from_bytes` 失败或解析出的 tree 含同名条目(只按名字判定,不论 mode)都是「字节无法解析」,所有读取共用该解析函数,所以 `lookup_path` 与各算子对同名条目的结论相同。
727728
- **只有两种情形算路径不存在**,按 EMPTY_TREE 处理:路径上某一层的 tree 中确实没有该名字的条目;条目存在,但不是 tree(blob、symlink、gitlink)。条目存在且 mode 为 tree、它指向的 tree 却读不到时,返回 `MissingObject`,不得返回 EMPTY_TREE。根树 T 本身读不到,或者 Exclude、Compose 需要重写的祖先 tree 读不到,同样返回 `MissingObject`。`lookup_path` 因此返回 `Result<Tree(id) | Absent | NotTree, MissingObject>`。
728729
- **只检查计算需要读取的 tree。** 原样复用、不需要读取的子树在投影时不检查,与下文“原样复用的 L0 tree”一致。这类子树包括 Subdir 的结果 tree、Prefix 包住的 T,以及 Exclude/Compose 没有触及的子树;它们缺失时,由 6.3 在打包时报错。视图提交的哈希只依赖这些子树的 id,所以确定性不受影响。memo 不缓存 `MissingObject`。
729730
- **批量读取。** 本节要求新增的可失败批量读取,只在查询本身失败时返回 `Err`。查不到的 id 由调用方按“请求集减返回集”得出,存储层不判错。4.4 的按层预取把这些 id 记入本批的缺失集合,不让整批失败;`read_tree` 命中缺失集合时返回 `MissingObject`。6.3 的 ViewRepo 读取发现缺失集合非空即报错。

‎src/ceres/view/mod.rs‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
11
pub mod filter;
2+
pub mod tree_source;
23

34
pub const VIEW_URL_RESERVED_NAMES: [&str; 2] = [".view", ".filter"];

0 commit comments

Comments
 (0)