Skip to content

fix: preserve final Rust field receivers during resolution - #20

Merged
NianJiuZst merged 1 commit into
NianJiuZst:mainfrom
014-code:fix/rust-smart-pointer-fields
Nov 5, 2026
Merged

NianJiuZst merged 1 commit into
NianJiuZst:mainfrom
014-code:fix/rust-smart-pointer-fields

Conversation

@014-code

@014-code 014-code commented Nov 3, 2026

Copy link
Copy Markdown
Contributor

Summary

Fix two Rust field-resolution gaps on current main (11cbfd9):

  • Resolve w.plain.clone() against the final field when w is an Arc<Child>, Rc<Child> or Box<Child>. The pointer-method guard currently checks clone against the root pointer too early. Preserve the guard for direct w.clone() calls.
  • Include Rust field types and their owning type in resolver fact signatures, so type edits invalidate unchanged callers. Owner identity prevents swaps between same-named fields from cancelling out in the signature set.
  • Add focused regressions and bump the engine version from 10 to 11.

Related to #14; complements #19. This PR deliberately omits the general smart-pointer-field traversal fix already proposed in #19. Both added regressions fail on the unmodified upstream base independently of that work. If #19 lands first, the engine bump needs rebasing to 11 → 12.

Validation

Rust toolchains, Cargo dependencies and build artifacts stayed inside Docker.

  • cargo test --locked --workspace with CGR_SYNC_SEQUENCES=6 CGR_SYNC_STEPS=100: 389 passed, 0 failed, 1 existing ignored (Rust 1.89.0).
  • CI rustfmt package check: passed.
  • cargo +stable clippy --locked --workspace --exclude cg-kernel --all-targets -- -D warnings: passed (stable 1.99.1).
  • cargo build --locked -p cgr: passed.
  • CLI fixture: 5 source states compiled and executed, 4 delta edits, 7 strict/full-diff comparisons, identical 1/4-thread graphs.
  • The two added tests fail as expected on clean upstream main; an owner-free field-signature control also fails the swap regression.
  • Repository smoke script: passed using an LF-normalized temporary copy of the Windows-mounted script. No repository script changes.

Local validation covers Linux in Docker; hosted Windows/macOS and other CI jobs remain to be verified. Implemented and validated with OpenAI Codex assistance.

@014-code

014-code commented Nov 3, 2026

Copy link
Copy Markdown
Contributor Author

实现与验证说明 / Implementation notes

这份说明记录本 PR 的实际实现与验证过程。代码和检查由 OpenAI Codex 辅助完成;提交基于上游 11cbfd96023bf352d4282166741f45ff5ee8f8ed,本次修复提交为 339a502f6f805763cb38b26e718629360d00fcd7。

1. 范围:补上两个独立缺口

最初沿 #14 调查 Rust 智能指针字段调用。发布前检查发现 #19 已提出基础的 self.worker.execute() / worker: Arc<Worker> 字段遍历修复,所以本 PR 去掉了与它重复的实现,只保留两个在当前 main 上也能独立复现的问题:

  1. 根变量是智能指针,但最终方法属于后面的普通字段,例如 w: Arc<Child> 时的 w.plain.clone()。
  2. Rust 字段声明类型发生变化,修改文件内的调用更新了,另一个未修改文件中的调用仍保留旧目标。

本 PR 没有包含 #19 的 JS、Python、trait 方法优先级改动,也不以单独关闭 #14 的全部基础场景为目标。

2. 根指针的方法过滤发生得太早

相关调用链在 crates/cg-resolve/src/resolve.rs:

call_member → lookup_binding → binding_value → ValueType::method_receiver → member_call → field_type / rust_member。

旧逻辑在根绑定处直接调用 method_receiver(method)。ValueType 保留了标准容器 wrapper,method_receiver 会阻止将 Arc::clone / Rc::clone 错认成内部类型的同名方法;这项保护本身是必要的。

问题出在 w.plain.clone():字段路径还没有走完,就拿最终的 clone 去过滤根 Arc<Child>,因此在读取 plain: Worker 之前返回了无候选。实际上这个方法属于最后的 Worker 字段。

修复只调整根 receiver 的选择:

  • 字段路径为空:继续使用真实方法名,保留 w.clone() 的原有指针方法保护。
  • 字段路径非空:使用空方法名确定根 receiver,然后让原有 member_call 走完字段路径,并在最后的类型上查找真实方法。

没有删除 wrapper 信息,也没有把未知容器统一当作透明指针。通用的智能指针字段遍历仍交由 #19 处理。

回归测试 rust_pointer_roots_use_the_final_field_method 检查:

  • 普通字段及普通嵌套字段的既有调用仍正确。
  • Child、Arc<Child>、Rc<Child>、Box<Child>、Arc<Box<Child>> 根变量后的 plain.clone() 精确指向 Worker::clone。
  • 普通 Child.clone() 仍指向 Child::clone。
  • 直接 Arc<Child>.clone() / Rc<Child>.clone() 不会生成错误的 Child::clone 调用边。

3. 字段类型也必须参与增量失效

相关路径在 crates/cg-sync/src/sync.rs:

resolver_fact_sig → old_facts / new_facts 比较 → definitions_changed / export_changed → 既有 consumer invalidation → 重新解析调用者。

之前的 resolver fact 签名没有纳入 Rust Field binding。字段从 Worker 改为 Other 时,结构体及方法的声明身份可以保持不变;修改文件会重新解析,但未修改 importer 不一定被标记为受影响,留下指向旧 Worker::execute 的边。

本次把 Rust 字段的名字、声明类型和所属类型 qname 纳入现有签名,再复用已有的 importer 失效传播。其它语言的字段不在这次扩大范围之内。

为什么不能只加字段名和类型? 签名是集合。如果同一文件中:

Owner.worker: Worker   /   Decoy.worker: Other

交换为:

Owner.worker: Other    /   Decoy.worker: Worker

只保存 (worker, Worker) 和 (worker, Other) 的集合前后完全一样,仍检测不到变化。因此签名还包含语义上的 owner qname。实现用字段 scope 的起始位置找到 owner 节点,最终写入签名的是 qname,不是易受插行影响的绝对行号。

回归测试 rust_field_type_swaps_retarget_unchanged_callers_without_full_rebuild:

  • 创建跨文件 owner.rs / caller.rs / worker.rs fixture,添加 48 个无关文件,避免小项目的全量重建掩盖增量缺陷。
  • 在 Owner 和 Decoy 之间连续交换同名字段类型,共 4 次修改。
  • 每一步断言 full_rebuild.is_none(),并精确检查修改文件和未修改调用者的目标。
  • 每一步独立创建干净项目全量构建,比对整个 canonical graph,而不只检查一条边。

4. 回归必须证明修复前失败、修复后通过

使用干净的上游 main archive,只拷入这两条新测试,并使用独立的 CARGO_TARGET_DIR,避免复用修复版本的构建产物:

对照 实际结果
未修改 main + 根指针测试 失败:local_arc 缺少到 Worker::clone 的调用边
未修改 main + 字段交换测试 失败:未修改 caller.rs::call 仍指向 Worker::execute,预期为 Other::execute
增加 Field 签名但去掉 owner 的实验对照 同样失败,确认 owner 不是多余字段
本 PR 的完整修复 两项回归通过

另将 ENGINE_VERSION 从 10 升为 11,使旧索引按新解析规则重建。#19 也从当前 main 升至 11;如果它先合并,本 PR 需要 rebase 并改为 11 → 12,确保两套规则的索引不会共享同一 engine version。

5. Docker 验证和实际边界

Rust 工具链、Cargo 下载和构建缓存均放在 Docker 内;宿主只挂载源码,没有安装 Rust/Cargo。容器内默认工具链为 Rust 1.89.0,stable 为 1.99.1。

实际运行并通过:

CGR_SYNC_SEQUENCES=6 CGR_SYNC_STEPS=100 cargo test --locked --workspace
cargo +stable clippy --locked --workspace --exclude cg-kernel --all-targets -- -D warnings
cargo build --locked -p cgr

以及 CI 使用的 rustfmt package 列表检查。workspace 合计 389 passed、0 failed、1 个既有 ignored。

此外使用真实 cgr CLI 和可由 rustc 编译运行的 fixture:5 个源码状态全部运行时断言通过,4 次修改都走 delta;总共 7 组 status --verify --strict 与 debug diff 检查通过,CGR_THREADS=1 / 4 的图一致。这个 fixture 同时检查根指针字段 clone 的正例和直接指针 clone 的负例。

仓库 scripts/smoke.sh 在 Windows 源码挂载中为 CRLF,直接执行会因 pipefail 失败。仅在容器临时目录生成等价 LF 副本后执行,得到 SMOKE OK;未把无关的脚本换行变更放进 PR。该 smoke 覆盖 init、status、explore、callers、sync、full diff、MCP stdio、prompt hook 和 export 路径。

以上是 Linux Docker 的本地结果。Windows/macOS 原生运行、musl/zig 构建及其它 hosted CI job 以 PR checks 的实际结果为准;这里不把本地通过等同于远端 CI 已通过或 PR 已合并。

@NianJiuZst
NianJiuZst merged commit faf5dea into NianJiuZst:main Nov 5, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants