5.0 KiB
5.0 KiB
Marqdo 知识锚点与证明制品(2.8 → 2.9)
实现状态:PR #2 第一阶段。保持解释器和原有
[]()求值语义不变,复用 2.8.0prove与既有 SemanticProject。以下明确区分已经写入分支的功能和尚未完成的跨模块证明。
核心语义
- AST 内部步骤仍有原来的
#step-N序号,供旧查询、调试与执行日志使用。 - 在同一个函数内名称唯一的标记步骤,获得独立的
anchor_id = SymbolId#anchor-sha256(normalized_label);在前面插入其他步骤不会改变地址。 - 同函数重复的标记名称不产生公共锚点;必须重命名,不得静默采用首个。
definition_digest来自该语句源码位置的内容,与稳定身份分开;语句内容更改时身份保留、定义指纹改变。- 两种文档引用不执行目标:同函数的
[阅读依据](#@演算)和跨模块绝对地址[阅读依据](mq://...#anchor-<sha256>)。后者应从编译生成的 anchors.json 拿完整 ID,不应凭空手写。 - 2.8.0 定理表每条唯一声明生成稳定
ClaimId = SymbolId#claim-sha256(定理名称);正文[阅读定理](#@定理名称)可以定位声明,但不会读取或伪造证明状态;同一名称同时匹配知识步骤和定理声明时标记ambiguous_anchor,不猜测。\n- 普通[说明](https://...)仍为导航,原来表达式位置的[描述](payload)仍依照原 Marqdo 执行规则求值。 - 链接不意味着执行权:解析到知识锚点只生成引用边,不自动调用函数、加载插件或赋予权限。
制品
marqdo knowledge 所用的 SemanticProject 原子生成目录下新增:
| 路径 | 内容 |
|---|---|
steps.json / refs.json |
增量字段 anchor_id、definition_digest、link_target、target_anchor |
claims.json |
定理声明索引,初始状态固定为 declared_unverified,不等同于证明通过 |
graph/edges.json |
defines_anchor、references_anchor、知识步骤到已解析调用目标的 calls |
proof-index.json |
可用或过期的证明收据索引;它不是可执行授权,也不自动证明步骤 |
marqdo prove 在原本的证明目录附带 knowledge-links.json:
每个定理通过文件 + 函数全名唯一绑定到 SymbolId,稳定 claim_anchor_id 附带前提、结论、来源、函数的 interface/implementation/closure digest 与可用时的 Lean 证书摘要。
无法安全绑定时输出 unresolved,不匹配别的同名函数。
related_anchor_ids 仅是 defined_in_same_function_not_individually_proved 导航关系,绝不意味着 Lean 已分别证明这些内部锚点的性质。
证据有效性
- 离线
checked不能当作proved。 - 只有
ClaimReport显示真实 Lean 判定,且匹配当前报告的原始certificate.json、命题、文件、Lean 工具链与证明库,才可输出proved关联。 - 在知识编译时复核文件源码 SHA、函数接口、实现指纹、传递依赖 closure 指纹及证书字节摘要;失败 =>
stale/unverified,usable=false。 - 同一个声明出现多份可见报告时 =>
ambiguous,不能随意取旧证书或新证书。 - 当前证明文件是本地缓存收据,不是经过签名的远程授权凭证。对抗性环境必须在可信 CI 中再次用 Lean 验证,不能仅相信 JSON 内的
status。
下一阶段:跨模块 assume–guarantee
这是比单纯增加更多 Lean tactic 更重要的方向,但 本 PR 第一阶段尚未实现:
- 将函数可复用契约分成
requires / ensures / effects,全部有已解析 SymbolId 作为身份; - 在调用方生成 “调用前提满足” 的证明义务,并以被调者的已验证后置条件作为假设,明确记录假设链;
- 若被调者实现改变、但同一契约被重新证明支持,允许复用不受影响的调用方证明;
- 若契约失效、闭包改变或假设不能满足,所有受影响证明回退
stale,不能保持proved; - 对外部 ABI 插件调用,必须给出明确 effect 契约、来源和可信主体,不能把不透明调用宣告为纯函数;
- 保留 Lean 与解释器对 i64 溢出、除零/模零行为的差异护栏,在证明模型不等价时不给出无限定的成功保证。
验收指标
- 在任意步骤前插入不相关语句,公共锚点地址不漂移;旧内部编号可以变化。
- 只修改锚点表达式,定义 digest 必须变化,锚点地址保持;同名重复拒绝公开。
#@标签与完整mq://...必须精确解析;不存在锚点报告 unresolved,且不能变成 BoundCall。prove的函数证明只能关联函数知识,不能将所有带标记步骤标成 proved。- 更改源码、契约、传递依赖或证书后,知识索引拒绝使用过期证明。
- 与 2.8.0 原有 CLI / SemanticProject / Lean 测试保持兼容。