Evidence-driven, replayable localization of the first regressing commit on a linear (first-parent) commit sequence
v0 … v(k-1) 正常 vk … v(n-1) 异常 0 ≤ k ≤ n-1| 构造子 | 含义 |
|---|---|
| NeedObservation | 建议某个尚可测试的位置,附候选区间与两个分支的收缩结果 |
| Located | 所有相容位置只剩一个 |
| Ambiguous | 仍有多个候选,且都不可再测,附每个候选被阻塞的原因 |
| Conflict | 返回导致矛盾的 good / bad 两条记录 |
| Insufficient | 缺少端点,不猜 |
| Budget | 达到注入的步数预算,未完成 |
# 发布到 Mooncakes 之后(当前尚未发布):
# moon add WENwenZU/faulttrail@0.1.0
# 从源码运行需要 MoonBit 工具链(本仓库验证于 moon 0.1.20261028 / moonc 0.10.18)
moon check --target js
moon test --target js
moon test --target wasm
moon run --target js examples/first_parent
moon run --target js cmd/faulttrail -- helpmoon run --target js examples/git_import# 方式一:显式提交列表,每行一个标识,从旧到新排列。
moon run --target js cmd/faulttrail -- start --sequence ids.txt --session s.session
# 方式二:从本地 Git 仓库只读导入一段 first-parent 区间(两端都包含)。
# start 会打印两个端点的完整标识,可直接用于下面的 record。
moon run --target js cmd/faulttrail -- start \
--repo ../some-repo --from v0 --to v7 --session s.session
# 记录端点、查询建议、跳过、撤销、查看、重放
moon run --target js cmd/faulttrail -- record --session s.session --commit <start-id> --probe passed
moon run --target js cmd/faulttrail -- record --session s.session --commit <end-id> --probe failed
moon run --target js cmd/faulttrail -- next --session s.session
moon run --target js cmd/faulttrail -- record --session s.session --commit <id> --probe skipped
moon run --target js cmd/faulttrail -- retract --session s.session --observation 2
moon run --target js cmd/faulttrail -- explain --session s.session
moon run --target js cmd/faulttrail -- replay --session s.session
moon run --target js cmd/faulttrail -- export --session s.session --out report.mdlet ids = ["v0", "v1", "v2", "v3", "v4", "v5", "v6", "v7"]
let sequence = @version.Sequence::from_ids(ids).unwrap()
let session = @session.Session::start(sequence).unwrap()
let _ = session.observe(0, @engine.Passed) // v0 正常
let _ = session.observe(7, @engine.Failed) // v7 异常
match session.outcome() {
@engine.NeedObservation(advice) =>
println("test v\{advice.index}: good -> \{advice.index + 1}..\{advice.span.hi}")
_ => ()
}let snapshot = session.snapshot()
let resumed = @session.Session::restore(snapshot, sequence).unwrap()
// 候选、终态、下一建议与原会话一致;换一个序列恢复会返回 SequenceMismatchInstall
Download zipEvidence-driven, replayable localization of the first regressing commit on a linear (first-parent) commit sequence