来源变化时标记依赖结论。
Provena 在图中记录结论、来源片段与结论依赖,并在被跟踪内容变化时传播 stale 状态。
结论可能在支撑它的文件片段变化后继续被使用。明确依赖边可以指出哪些结论需要重新检查。
- 明确来源关联 — 结论关联可检查来源对象。
- 传递失效标记 — 下游结论也会被标为待检查。
- 无需模型 — 哈希比较与图遍历具有确定性。
record_claim 在 ClaimDependencyGraph 中登记来源片段与边;CascadeEngine 比较当前和记录哈希,再沿反向结论依赖遍历,将受影响结论标为 stale。可选 UI 展示这些状态。
| 组件 | 职责 |
|---|---|
Source spans |
provena/core/source.py |
Claim graph |
provena/core/graph.py |
Mutation check |
provena/core/cascade.py |
Stale claims |
Local graph / UI |
使用仓库清单指定的运行时版本构建,并在仓库根目录运行示例。
git clone https://github.com/SuperMarioYL/provena.git
cd provena
uv venv .venv
uv pip install --python .venv/bin/python -e .
source .venv/bin/activate创建临时单行来源与两条依赖结论,将 limit=10 改为 limit=20,再检查传播状态。
.venv/bin/python examples/presentation-demo.pyChanging the source marks both limit and request claims stale.
before: {"limit": "fresh", "request": "fresh"}
flagged: ['limit', 'request']
after: {"limit": "stale", "request": "stale"}
完整命令与输出保存在 docs/demo-results.json. 输入和复现代码均随仓提供。
保留已有录制供参考;上方文字示例给出当前可复现的操作。
CLI 提供以下操作。示例之外的命令需要替换成你的文件路径或标识。
provena graph --json
provena check
# CI / pre-commit 阻断:有结论被标记失效时以退出码 1 结束
provena check --fail-on-stale
# Interactive local demo server:
provena demo
# 版本查询
provena --version使用 FileSpan.from_file(path, start, end) 捕获来源片段。record_claim 接受 grounded_on 来源对象或已登记 ID,以及 depends_on 结论 ID。集成方应负责图持久化及收到 stale 后的重新推导。
以下路径已有源码实现。按任务选择输入,并把生成的结果与项目一起保存。
| 路径 | 已实现职责 |
|---|---|
| FileSpan | Tracked file line ranges |
| Claim recording | Grounding and dependencies |
| Cascade callback | Application notification seam |
| JSON / local UI | Graph inspection |
- 引擎标记待检查结论,不会自动重新推导或纠正。
- 依赖由调用者提供,不证明来源确实支持结论。
- 编辑后文件行片段可能移动;来源选择与图完整性影响失效标记的作用。
自动重新推导和更多来源适配属于后续集成;当前核心负责记录与 stale 传播。
许可见 LICENSE. 反馈问题时请提供最小输入、执行命令和实际输出。
