From d4b545becf4dccd4fceb262c7913940c7725d6d9 Mon Sep 17 00:00:00 2001 From: inpac Date: Thu, 19 Nov 2026 10:56:54 +0100 Subject: [PATCH 1/3] docs: apply the R1 round-1 rulings to the spec texts (SR-1) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Change: SR-1(#216):按 REPO-AUDIT R1 第一轮裁定(#211 issuecomment-6991230132)修订规范与概览文本。 - threat-model §11 与 project-overview:101:把 #171 改坏的句子恢复为正向限定表述;待证命题与 REJECTED/SUPERSEDED 的语义分开,后者不附前提。 - verification-profile-schema:TimeRange 线上形式固定为 2 元数组;§3.2.1 注明数据模型视图;§17.5B 冻结恒等 wire-key 通则与 VersionRange 例外;§17.4 澄清对象 tag 与 encoding_profile_id 独立;修正 §29.1 并新增 §29.3 修订记录。 - protocol-spec §4 删除重复的 V1 列,改为引用 v1-profile;§12 分开终态与 CreateReceiptResult。 - R1-030/B2:terminology §8、task-lifecycle §9 与 :53、system-context:103 同步 ADR-0005 D-02(a)。 - R1-049:result-validation §2 删除重复清单,链接 schema §3.1/§3.5/§5/§6。 - R1-061:task-lifecycle §4 指向 protocol-spec §5。 - 复核补充:ADR-0009 与 current-status 的 proof-assisted 引用、故障归因状态、architecture-guide 许可与状态快照、project-overview 商标清查。 Problem / counterexample: #171(89ae3a8)把 threat-model §11 的“不得声称 [肯定命题]”改成“以下结论不属于安全主张:[否定命题]”,形成双重否定,并给已否决语义附加“证明义务完成前”的前提;project-overview:101 把“可以成为”改成“属于”。R1 复核 D 组与 #211 裁定 1 要求恢复原意。 Status before: 规范文本中 TimeRange 的 map/数组两种形式并存且 §29.1 声称已统一;wire-key 通则与整数键例外未冻结;§17.4 要求新增 tag 必须提升 encoding_profile_id;protocol-spec §4 复制 V1 列;终态集合多解;R1-049/061/064/066 与复核补充未同步。 Status after: TimeRange 唯一线上形式为 2 元数组,旧 map 向量保留为历史;恒等 wire-key 通则与 VersionRange 例外已写明;对象 tag 与编码 Profile 版本独立;终态与 CreateReceiptResult 分开,REJECTED_AT_CREATE/UNSUPPORTED 不在登记后进入;其余同步项按复核意见落实。未改代码、向量、摘要。 Affected objects/functions: TimeRange、VersionRange、CreateReceiptResult、Receipt 终态集合、RegistrySnapshot 引用。 Affected invariants: INV-01、INV-04、INV-07、INV-13、INV-14(仅文本同步,不改语义)。 Affected threats: TH-05、TH-24 与 §11 安全主张边界。 New assumptions: 无。 Compatibility/migration: 不新增编码规则,encoding_profile_id 仍为 acl.enc.p0-1@1;已发布摘要与向量不变;20 条 map 形式 TimeRange 向量保留为旧形式历史。 Tests or proofs: 纯文档改动,未运行 make test。执行见 PR 正文。 Residual risk: TimeRange 注册路径的代码与新数组向量按计划卡留给 B1;threat-model §11 的分组改写需审计逐句核对;未新增 v1-profile 的 proof-assisted 条目。 Documents updated: docs/00-overview/{architecture-guide,project-overview,system-context,terminology}.md docs/01-requirements/{invariants,threat-model}.md docs/02-architecture/task-lifecycle.md docs/03-protocol/{protocol-spec,result-validation,verification-profile-schema}.md docs/05-decisions/ADR-0009-proof-verified-computation-statements.md docs/07-roadmap/current-status.md --- docs/00-overview/architecture-guide.md | 12 ++-- docs/00-overview/project-overview.md | 4 +- docs/00-overview/system-context.md | 4 +- docs/00-overview/terminology.md | 8 ++- docs/01-requirements/invariants.md | 2 +- docs/01-requirements/threat-model.md | 49 +++++++------ docs/02-architecture/task-lifecycle.md | 8 ++- docs/03-protocol/protocol-spec.md | 68 ++++++++++--------- docs/03-protocol/result-validation.md | 15 +--- .../verification-profile-schema.md | 24 +++++-- ...9-proof-verified-computation-statements.md | 2 +- docs/07-roadmap/current-status.md | 3 +- 12 files changed, 108 insertions(+), 91 deletions(-) diff --git a/docs/00-overview/architecture-guide.md b/docs/00-overview/architecture-guide.md index 1fce41f..162b7ad 100644 --- a/docs/00-overview/architecture-guide.md +++ b/docs/00-overview/architecture-guide.md @@ -171,7 +171,7 @@ flowchart LR ACLt/ ├── README.md 项目总入口 ├── CONTRIBUTING.md 贡献流程、同步要求和审查标准 -├── LICENSE 仓库全部工件的许可证文本(Apache-2.0) +├── LICENSE 项目工件的许可证文本(Apache-2.0;第三方材料保留原许可) ├── docs/ │ ├── README.md 文档索引、权威范围、冲突处理 │ ├── 00-overview/ 为什么做、术语、系统边界 @@ -214,13 +214,13 @@ ACLt/ |---|---|---| | 协议文档与架构 | 已有 v0.5 文档骨架、职责边界和 16 条不变量 | 完整状态机或所有规范都已可执行。 | | 有限总体验证模型 | 有递推、闭式、全枚举、DP 对拍和精确有理数向量 | 真实无许可网络已满足部署前提。 | -| P0-1A | 状态文档记录 `PASS / CLOSED` | 整个 P0-1 或 G0 已关闭。 | -| P0-1B | `STARTED / NOT CLOSED`;有初始 Schema、种子、validator 和测试 | 所有规则、编码与摘要已实现。 | +| P0-1A | 状态见[当前状态](../07-roadmap/current-status.md) | 整个 P0-1 或 G0 已关闭。 | +| P0-1B | 状态与计数见[当前状态](../07-roadmap/current-status.md) | 所有规则、编码与摘要已实现。 | | 注册表种子 | 有 claim 模板、排除项和 disabled assurance 数据 | 已存在正式 ACTIVE 主网注册表。 | -| G0 | 进行中 | 已具备合格的 G2 参考实现。 | -| G1—G6 | 状态快照记录为未开始 | 仿真、网络、容灾或对抗验证已经验收。 | +| G0 | 状态见[当前状态](../07-roadmap/current-status.md) | 已具备合格的 G2 参考实现。 | +| G1—G6 | 状态见[当前状态](../07-roadmap/current-status.md) | 仿真、网络、容灾或对抗验证已经验收。 | -P0-1B 当前覆盖清单明确列出:L1b 的 SV-10、SV-11、SV-57、SV-76 已实现;部分 L1a 规则和 SV-54a 只部分覆盖;L2 尚未实现。canonical CBOR、18 个摘要、完整五相位对象、全量 Type A 规则以及第二语言对拍仍有缺口。参考 validator 的 `--production` 会主动拒绝,避免把局部检查当作完整生产校验。 +P0-1B 的覆盖计数、缺口与已实现规则以[当前状态](../07-roadmap/current-status.md)和[覆盖清单](../../schemas/verification-profile/coverage.json)为准。参考 validator 的 `--production` 会主动拒绝,避免把局部检查当作完整生产校验。 阅读状态时分清三个问题:`DECIDED` 表示设计已接受;V1 `CORE` 表示必须实现;测试通过表示某个检查有证据。三者不能互相替代。 diff --git a/docs/00-overview/project-overview.md b/docs/00-overview/project-overview.md index e503cbe..08b42e5 100644 --- a/docs/00-overview/project-overview.md +++ b/docs/00-overview/project-overview.md @@ -98,7 +98,7 @@ ACLt 的目标不是消灭这些不确定性,而是将它们转化为显式且 - V1 对跨 Provider 共享可变地址空间、分布式原子操作或隐藏 Host OS 状态的支持; - 以 Rust 源码、某个编译器输出或本机二进制本身作为协议规范语义。 -这些能力属于未来研究或适配方向;当前安全主张不包含它们。 +其中仍处于 `OPEN`、`CANDIDATE` 或 `DEFERRED` 的内容可以作为未来研究或适配方向;已被否决或取代的做法保持其否决或取代记录(见[术语表](terminology.md#10-废弃或禁止的旧术语语义)与相关 ADR)。上述内容均不得写入当前安全主张。 ## 6. 最小系统本体 @@ -192,7 +192,7 @@ ACLt 仍处于 **G0:协议规格化阶段**。目前已经形成完整候选 - 结算、退款、故障归因和资金耗尽语义; - 发布、密钥、撤销、升级和漏洞响应流程; - CauseSet/reducer conformance 与 MainnetAssuranceProfile 发布、撤销和网络隔离流程; -- 当前项目名称的商标、域名和包名清查。 +- 当前项目名称的域名和包名清查;商标部分已按 2026-11-16 决定关闭(见术语表 §11)。 ## 11. 可支持的当前结论 diff --git a/docs/00-overview/system-context.md b/docs/00-overview/system-context.md index 51fe144..9d41056 100644 --- a/docs/00-overview/system-context.md +++ b/docs/00-overview/system-context.md @@ -100,7 +100,7 @@ ACLt 不为下列职能建立固定特权角色。任何 Principal 都可以尝 |---|---|---|---| | 1. 选择版本与政策 | Requester 选择兼容的 ProtocolVersion、验证、资金、结算政策和适用的主网保障 Profile | 可解析的任务创建输入 | `REJECTED_AT_CREATE` | | 2. 登记任务 | Requester 规范化并签署包含 RIRVersion/Profile/Digest 的 ComputeReceipt | 不可变 ReceiptID | `REJECTED_AT_CREATE` / `UNSUPPORTED` | -| 3. Compile 与规划 | Lowering、Decomposition、Packing/Plan 形成并验证候选工件 | 规范 RIR、合法 WorkPlan / Assignment | `FAILED_PLANNING` / `UNSUPPORTED` | +| 3. Compile 与规划 | Lowering、Decomposition、Packing/Plan 形成并验证候选工件 | 规范 RIR、合法 WorkPlan / Assignment | `FAILED_PLANNING` | | 4. 准入与 Dispatch | Admit/Schedule 处理证据、能力、不确定度和限额 | ExposureDecision、Lease proposal | 排队、拒绝或 `EXPIRED` | | 5. 接受与执行 | Provider 显式接受 Lease;系统派生 ExecutionCapability;Dispatch 与 RPR 分别校验后执行 | active Lease、ExecutionCapability、Result、Checkpoint 或失败证据 | proposal 失效、能力校验失败、重租约、`FAILED`、`EXPIRED` | | 6. 冻结验证总体 | Sample 前建立 EligibilitySnapshot | 可审计总体、分层与随机承诺 | `UNRESOLVED` | @@ -109,6 +109,8 @@ ACLt 不为下列职能建立固定特权角色。任何 Principal 都可以尝 | 9. 结算 | Settle 应用 FundingPolicy 和 SettlementPolicy | 最多一次 Settlement | `FUNDING_EXHAUSTED` 或可重试实现失败 | | 10. 追加证据 | UpdateEvidence 记录可归责事件 | 新 PerformanceEvidence | 证据不足时暂缓能力更新 | +`REJECTED_AT_CREATE` 与 `UNSUPPORTED` 属于 `CreateReceiptResult`(阶段 1–2),不是终态;Receipt 登记后不得进入 `UNSUPPORTED`(ADR-0005 D-02(a))。 + ## 7. 外部依赖与适配器 | 外部能力 | ACLt 对其要求 | 失效时的协议响应 | diff --git a/docs/00-overview/terminology.md b/docs/00-overview/terminology.md index 1995ddc..f796b07 100644 --- a/docs/00-overview/terminology.md +++ b/docs/00-overview/terminology.md @@ -300,7 +300,9 @@ $$ `Nmax` 不具有默认的 51% 含义,也不单独证明验证安全。 -## 8. 终态 +## 8. 终态与创建结果 + +本节区分 Receipt 终态与创建结果。`REJECTED_AT_CREATE` 与 `UNSUPPORTED` 属于 `CreateReceiptResult`,不是 Receipt 终态,也不得在 Receipt 登记后进入(ADR-0005 D-02(a))。 ### `TRUSTED` @@ -328,11 +330,11 @@ $$ ### `REJECTED_AT_CREATE` -任务在创建阶段不满足协议、兼容性、安全或资金前置条件,因此不进入执行生命周期。 +任务在创建阶段不满足协议、兼容性、安全或资金前置条件,因此不进入执行生命周期。它是 `CreateReceiptResult`,不产生 ReceiptID,也不是 Receipt 终态。 ### `UNSUPPORTED` -当前 ProtocolVersion 没有为该任务语义提供符合要求的执行或验证类型。实现不得把它降级为普通多数投票。 +当前 ProtocolVersion 没有为该任务语义提供符合要求的执行或验证类型。它是 `CreateReceiptResult`,只在 Receipt 登记前产生;登记后不得进入,也不是 Receipt 终态。实现不得把它降级为普通多数投票。 ## 9. 实现与维护术语 diff --git a/docs/01-requirements/invariants.md b/docs/01-requirements/invariants.md index 9860e32..b1ecc7a 100644 --- a/docs/01-requirements/invariants.md +++ b/docs/01-requirements/invariants.md @@ -267,7 +267,7 @@ Committed + Settled + RefundReserved ### 未决事项 -终态—权利矩阵、故障归因、退款和外部通道失败语义仍为 `OPEN/P0`。 +终态—权利矩阵、退款和外部通道失败语义仍为 `OPEN/P0`。结算层的 `AttributionClass` 已由 [VerificationProfile Schema](../03-protocol/verification-profile-schema.md) §10.1 冻结;履约证据层的归因仍为 `OPEN`(OQ-10)。 ## 12. INV-08:旧 epoch 隔离 diff --git a/docs/01-requirements/threat-model.md b/docs/01-requirements/threat-model.md index 5217b03..8876beb 100644 --- a/docs/01-requirements/threat-model.md +++ b/docs/01-requirements/threat-model.md @@ -144,7 +144,7 @@ ACLt Protocol 不默认信任: | ID | 威胁 | 可能影响 | 必要控制 | 不变量 | 当前状态 | |---|---|---|---|---|---| -| TH-05 | 伪造、重放、刷取或错误归因 PerformanceEvidence | 错误能力估计、放大未来暴露 | 证据绑定任务族、环境、结果、来源、时间和因果引用;追加式更正 | INV-13、INV-14 | 证据 Schema 与归因仍为 `OPEN/P0` | +| TH-05 | 伪造、重放、刷取或错误归因 PerformanceEvidence | 错误能力估计、放大未来暴露 | 证据绑定任务族、环境、结果、来源、时间和因果引用;追加式更正 | INV-13、INV-14 | 证据 Schema 与履约证据层归因仍为 `OPEN/P0`;结算层 `AttributionClass` 已由 Profile Schema §10.1 冻结 | | TH-06 | 将平台、任务规范或验证器故障归罪于 Provider | 不公正限制、诱发策略性退出 | 显式故障来源;证据不足时不猜测;拒绝未接受任务不产生负面证据 | INV-13、INV-14 | 归因矩阵为 `OPEN/P0` | | TH-07 | Sybil 身份批量进入或多个标识由同一控制者协同 | 绕过新节点限制、提高验证影响、集中风险 | 不假定独立;相关集群上限;证据折减;每集群/Receipt/窗口硬暴露上限 | INV-10、INV-14 | 相关性算法为 `CANDIDATE/P0` | | TH-08 | 并发准入竞态、跨服务配额不同步或过期能力估计 | 实际暴露超过声明上限 | 原子额度预留;决策绑定证据版本、有效期和当前并发;失败回滚 | INV-10、INV-16 | 原子配额实现为 `OPEN/P0` | @@ -178,7 +178,7 @@ ACLt Protocol 不默认信任: |---|---|---|---|---|---| | TH-22 | 隐性借用、临时增发、跨资金桶挪用或虚假预算 | 掩盖真实成本、资不抵债、越权支付 | FundingPolicy 预声明来源与上限;资金桶分离;资金守恒 | INV-06 | 具体账务模型为 `OPEN/P0` | | TH-23 | 重放、并发或超时恢复造成重复结算 | 超额支付和权利分叉 | 唯一权利键、幂等 Settle、最多一次 Commit | INV-05、INV-07 | 事务与唯一键为 `OPEN/P0` | -| TH-24 | 没有有效终态仍结算,或终态与退款/费用映射被追溯修改 | 未授权支付、争议和激励扭曲 | SettlementPolicy 随 Receipt 冻结;结算验证终态和故障归因 | INV-01、INV-07、INV-12 | 退款与归因为 `OPEN/P0` | +| TH-24 | 没有有效终态仍结算,或终态与退款/费用映射被追溯修改 | 未授权支付、争议和激励扭曲 | SettlementPolicy 随 Receipt 冻结;结算验证终态和故障归因 | INV-01、INV-07、INV-12 | 退款与完整结算归因矩阵为 `OPEN/P0`;结算层 `AttributionClass` 已由 Profile Schema §10.1 冻结 | | TH-25 | 攻击收益来自外部头寸、竞争破坏、补贴或纯破坏动机 | “攻击不划算”假设失效 | 先限制最大损失;经济模型纳入外部收益并进行敏感性分析 | INV-06、INV-09、INV-10 | 经济参数为 `HYPOTHESIS/P1` | | TH-26 | 低成本身份反复进入、领取探索额度后退出 | 持续消耗探索预算和执行资源 | 每集群/窗口探索与损失上限;能力不确定度;异常证据分析 | INV-09、INV-10、INV-14 | 攻击仿真为 `OPEN/P1` | @@ -270,24 +270,29 @@ Sybil 与相关性控制可能需要观察所有权、资金、网络、设备 ## 11. 安全主张的边界 -在对应证明义务完成前,以下结论不属于安全主张: - -- ACLt Protocol 的整体鲁棒性尚未得到证明; -- 任意计算的低成本可靠验证尚未建立; -- 多个 Provider 不表示多个独立控制实体; -- ACLt Protocol 没有默认的 51% 安全阈值; -- Rank、信誉或历史履约不表示真理; -- `TRUSTED` 不表示绝对正确; -- 零抵押不消除 Sybil 或弃单风险; -- 攻击成本大于协议内收益不足以排除攻击; -- 临时发行不会使验证资金变为“免费”; -- 区块链或去中心化存储不会自动满足 ACLt Protocol 不变量; -- 官方主网 assurance、Foundation 报告或一次工程审计不构成绝对正确性证明; -- 官方主网的条件性保证不自动适用于 fork、私有部署、替换组件或主网外业务; -- 中心化参考实现尚不具备分布式容错; -- 未经证明的序贯方法,其 anytime-valid 误差控制尚未得到证明,不作为当前主张; -- Rust 的语言安全、RIR 的存在或单一参考 compiler 不自动保证结果正确、确定性、资源一致或分布式安全; -- V1 Profile 将 unsafe Rust、完整宿主 effects、原生执行、GPU/专用加速器或非确定性任务列为 `DEFERRED` 排除项;扩展由后续目标与对应准入条件决定。 +本节把安全主张的边界分成两组。第一组是尚待证明的命题:下列命题只有在对应证明义务完成之后才属于安全主张。 + +- ACLt Protocol 的整体鲁棒性已经得到证明; +- 任意计算能以低成本可靠验证; +- 攻击成本大于协议内收益即可排除攻击; +- 中心化参考实现具备分布式容错; +- 序贯方法保持 anytime-valid 误差控制。 + +第二组是已被否决、取代或明确排除的主张。这些边界无条件成立,不依赖任何证明义务的完成: + +- 多个 Provider 代表多个独立控制实体; +- 51% 是 ACLt Protocol 的默认安全阈值; +- Rank、信誉或历史履约代表真理; +- `TRUSTED` 表示绝对正确; +- 零抵押消除 Sybil 或弃单风险; +- 验证资金通过临时发行变为“免费”; +- 区块链或去中心化存储自动满足 ACLt Protocol 不变量; +- 官方主网 assurance、Foundation 报告或一次工程审计等于绝对正确性证明; +- 官方主网的条件性保证自动适用于 fork、私有部署、替换组件或主网外业务; +- Rust 的语言安全、RIR 的存在或单一参考 compiler 自动保证结果正确、确定性、资源一致或分布式安全; +- V1 支持 unsafe Rust、完整宿主 effects、原生执行、GPU/专用加速器或非确定性任务。 + +V1 Profile 将 unsafe Rust、完整宿主 effects、原生执行、GPU/专用加速器或非确定性任务列为 `DEFERRED` 排除项;扩展由后续目标与对应准入条件决定。 ## 12. G0 未决安全问题 @@ -305,12 +310,12 @@ Sybil 与相关性控制可能需要观察所有权、资金、网络、设备 | P0 | VerificationProfile、有限总体、能力上界 \(B\)、活性下界 \(Q\)、随机性、分层、e-process 和停止规则 | 条件定理、部署假设证据、精确 DP、对拍测试、反例与实现规范;Bayesian 仅作效率评估 | | P0 | 控制相关性、未知依赖处理和集群暴露 | 相关性模型、隐私边界、敏感性与攻击仿真 | | P0 | 最大尝试、任务价值、验证支出和可接受损失 | 按 Provider/集群/Receipt/窗口的硬参数与性质测试 | -| P0 | FundingPolicy、退款、故障归因、资不抵债和资金守恒 | 账务状态机、唯一键、故障与并发测试 | +| P0 | FundingPolicy、退款、完整故障归因矩阵(结算层 `AttributionClass` 已冻结)、资不抵债和资金守恒 | 账务状态机、唯一键、故障与并发测试 | | P0 | 分区、时钟、事务、幂等、备份恢复和适配器一致性 | 明确故障模型、RPO/RTO 演练、conformance suite | | P0 | 发布、撤销、升级、密钥和漏洞响应 | 维护权限模型、签名与撤销演练 | | P0 | 主网 assurance 与工程日志 | `MainnetAssuranceProfile` Schema、网络/组件限域、日志 contract、finality/inclusion/consistency、旁路和恢复测试 | | P0 | 多原因假设失效 | `CauseSet`、冻结 reducer、`EffectiveVerdict`、多原因组合向量和迁移规则 | -| P0 | ACLt 公共品牌清查 | 商标、域名和包名的独立结论;不影响协议安全语义 | +| P0 | ACLt 公共品牌清查 | 域名和包名的独立结论;商标部分已按 2026-11-16 决定关闭(OQ-01);不影响协议安全语义 | ## 13. 威胁模型更新规则 diff --git a/docs/02-architecture/task-lifecycle.md b/docs/02-architecture/task-lifecycle.md index 8111576..7c7ee4c 100644 --- a/docs/02-architecture/task-lifecycle.md +++ b/docs/02-architecture/task-lifecycle.md @@ -50,7 +50,7 @@ SourcePackage、Lowering 和候选 RIR 的准备发生在 `Proposed` 之前; | 4. 能力与暴露 | 估计任务族能力并原子预留额度 | 证据版本、资源和限额有效 | ExposureDecision | 排队/拒绝/EXPIRED | | 5. Provider Dispatch | Schedule 产生 Lease proposal,Provider 显式接受;Dispatch/RPR 校验 Lease 派生 capability | epoch、期限、scope 与暴露有效 | 生效 active Lease 与 ExecutionCapability | proposal 失效、释放额度 | | 6. 执行与恢复 | RPR Execute、heartbeat、checkpoint | 当前 active Lease | Result/Checkpoint/Failure | retry/FAILED/EXPIRED | -| 7. 验证快照 | 冻结总体、分层、相关性和随机性 | 有效候选结果与策略 | EligibilitySnapshot | UNSUPPORTED/UNRESOLVED | +| 7. 验证快照 | 冻结总体、分层、相关性和随机性 | 有效候选结果与策略 | EligibilitySnapshot | UNRESOLVED | | 8. 序贯验证 | Sample、Verify、Aggregate | Snapshot 未破坏 | ConfidenceState | 扩样/UNRESOLVED | | 9. 终态 | 原子提交唯一状态 | 停止或边界条件 | TerminalState | 事务重试 | | 10. 结算 | 计算权利并最多一次提交 | 终态、政策、资金有效 | Settlement | FUNDING_EXHAUSTED/暂停 | @@ -70,6 +70,8 @@ Receipt 登记前必须明确: - FundingPolicy、SettlementPolicy 和预算; - ProtocolVersion 与 canonical encoding。 +完整字段清单以 [`protocol-spec.md` §5](../03-protocol/protocol-spec.md) 为准;其中 Exposure、Availability 与 Deployment assurance 三组同样必须在登记前明确。 + 登记后任何实质变化必须生成新 ReceiptID。修正文书不能改变原任务义务。 Lowering 必须发生在 Receipt 冻结前,Receipt 绑定其 RIRVersion、RIR digest、FrontendProfileVersion 和 lowering provenance。Decomposition/Packing 可以在登记后由任意 Principal 提议,但只能产生受同一 Receipt 约束的合法 WorkPlan 和 Assignment。 @@ -147,12 +149,12 @@ N_{max}=\min(N_{population},N_{budget},N_{policy}) | `FAILED` | 执行或系统条件失败且不能继续 | 按故障归因 | 不适用 | | `EXPIRED` | 最终期限到达 | 按责任矩阵 | 不适用 | | `FUNDING_EXHAUSTED` | 授权资金阻止继续或结算 | 仅按剩余额度和政策 | 不适用 | -| `REJECTED_AT_CREATE` | 创建条件不合法 | 不进入执行服务 | 不适用 | | `FAILED_PLANNING` | 没有合法 WorkPlan | 仅按创建/规划政策 | 不适用 | -| `UNSUPPORTED` | 当前版本无合规验证或执行语义 | 不进入相关阶段 | 不适用 | 每个 Receipt 最多提交一个互斥协议终态。 +`REJECTED_AT_CREATE` 与 `UNSUPPORTED` 属于 `CreateReceiptResult`,不是 Receipt 终态,也不得在 Receipt 登记后进入(ADR-0005 D-02(a))。 + ## 10. 结算阶段 Settlement 必须引用:唯一终态、冻结 SettlementPolicy、合法故障归因、足够资金和未提交 EntitlementKey。 diff --git a/docs/03-protocol/protocol-spec.md b/docs/03-protocol/protocol-spec.md index 107ba49..9d2aac0 100644 --- a/docs/03-protocol/protocol-spec.md +++ b/docs/03-protocol/protocol-spec.md @@ -61,31 +61,33 @@ Logical Object MUST 通过显式引用进入 Task 输入。相同 digest 不得 ## 4. 核心对象 -| 对象 | 必需语义 | 冻结点 | SemanticStatus | V1 | -|---|---|---|---|---| -| `ProtocolVersion` | Schema、状态机、不变量、验证、资金和兼容规则 | 发布签名/摘要 | `OPEN`,Priority `P0` | `CORE` | -| `PrincipalRecord` | 公钥、状态、声明、控制关联引用 | 每次决策读取版本 | `OPEN`,Priority `P0` | `CORE` | -| `LogicalObject` | 类型、版本、canonical content、digest、因果和可用性 | 对象发布/引用 | 不可变接口 `DECIDED`;Schema `OPEN` | `CORE` | -| `ComputeReceipt` | ContractTuple、规范 RIR、Logical Object 输入、环境、资源、验证、期限、预算、政策 | ReceiptID 登记 | 接口 `INVARIANT`;Schema `OPEN` | `CORE` | -| `FundingPolicy` | 费用、储备、补贴、可选发行或混合及上限 | Receipt 登记 | 类型 `DECIDED`;细节 `OPEN` | `CORE` | -| `SettlementPolicy` | 各终态费用、退款、权利和故障归因 | Receipt 登记 | `OPEN`,Priority `P0` | `CORE` | -| `WorkPlan` / `Assignment` | 工作单元、依赖、合并、失败和验证上下文 | 合法性检查后发布 | 三阶段边界 `DECIDED`;Schema `OPEN` | `CORE` | -| `PerformanceEvidence` | 任务族、环境、结果、归责、来源、时间 | 追加时 | 接口 `DECIDED` | `CORE` | -| `CapabilityEstimate` | 条件能力分布/区间、不确定度、有效期 | 决策绑定证据版本 | `CANDIDATE`,Priority `P1` | `CORE` | -| `ExposureDecision` | 并发、价值、尝试、损失、集群和有效期 | Lease 前 | 接口 `DECIDED`;算法 `OPEN` | `CORE` | -| `Lease` | Assignment、Provider、epoch、期限、条件权利 | Provider 接受 | 握手边界 `DECIDED`;Schema `OPEN` | `CORE` | -| `ExecutionCapability` | active Lease 的 Receipt/epoch/execution tuple/scope/expiry 绑定 | Lease 生效时派生 | 边界 `DECIDED`;Schema `OPEN` | `CORE` | -| `Attempt` | 一次有界执行及其状态和原因 | 终止时 | `OPEN`,Priority `P0` | `CORE` | -| `Checkpoint` | 可恢复状态、摘要、格式和环境 | 接收时 | `OPEN`,Priority `P0` | `CORE` | -| `ResultSubmission` | 结果、摘要、epoch、证据、幂等键 | 校验接收 | `OPEN`,Priority `P0` | `CORE` | -| `EligibilitySnapshot` | 有限总体、排除、分层、相关性、随机承诺 | 首次 draw 前 | 接口 `INVARIANT`;Schema `OPEN` | `CORE` | -| `VerificationEvidence` | 方法、输入、输出、来源、成本、关联 | 接收时 | `OPEN`,Priority `P0` | `CORE` | -| `VerificationDecision` | TRUSTED/UNRESOLVED、策略和完整证据链 | 原子终态提交 | `OPEN`,Priority `P0` | `CORE` | -| `AssumptionEvaluation` | 完整 CauseSet、reducer 版本和派生 EffectiveVerdict | 判决求值时 | 分层 `DECIDED`;Schema `OPEN` | `CORE` | -| `VerificationProfile` | Claim、排除项、方法、参数、假设、失败与终态映射 | Receipt 创建前注册并绑定 | P0-1A `CLOSED`;P0-1B `STARTED` | `CORE` | -| `MainnetAssuranceProfile` | network、允许 Profile/组件、有效期、能力处置和损失预算 | 主网发布/Receipt 绑定前 | P0-1A `CLOSED`;部署实例 `CANDIDATE` | `CORE` | -| `Settlement` | 权利人、金额、来源、唯一键、状态 | Commit | `OPEN`,Priority `P0` | `CORE` | -| `EventRecord` | 状态变化、因果引用、版本、签名/摘要 | 追加时 | 接口 `INVARIANT`;Schema `OPEN` | `CORE` | +下表只描述对象的语义与冻结点。V1 的 `VersionDisposition` 只由 [`v1-profile.md`](v1-profile.md) 按 FeatureKey 登记,本表不复制 V1 处置。 + +| 对象 | 必需语义 | 冻结点 | SemanticStatus | +|---|---|---|---| +| `ProtocolVersion` | Schema、状态机、不变量、验证、资金和兼容规则 | 发布签名/摘要 | `OPEN`,Priority `P0` | +| `PrincipalRecord` | 公钥、状态、声明、控制关联引用 | 每次决策读取版本 | `OPEN`,Priority `P0` | +| `LogicalObject` | 类型、版本、canonical content、digest、因果和可用性 | 对象发布/引用 | 不可变接口 `DECIDED`;Schema `OPEN` | +| `ComputeReceipt` | ContractTuple、规范 RIR、Logical Object 输入、环境、资源、验证、期限、预算、政策 | ReceiptID 登记 | 接口 `INVARIANT`;Schema `OPEN` | +| `FundingPolicy` | 费用、储备、补贴、可选发行或混合及上限 | Receipt 登记 | 类型 `DECIDED`;细节 `OPEN` | +| `SettlementPolicy` | 各终态费用、退款、权利和故障归因 | Receipt 登记 | `OPEN`,Priority `P0` | +| `WorkPlan` / `Assignment` | 工作单元、依赖、合并、失败和验证上下文 | 合法性检查后发布 | 三阶段边界 `DECIDED`;Schema `OPEN` | +| `PerformanceEvidence` | 任务族、环境、结果、归责、来源、时间 | 追加时 | 接口 `DECIDED` | +| `CapabilityEstimate` | 条件能力分布/区间、不确定度、有效期 | 决策绑定证据版本 | `CANDIDATE`,Priority `P1` | +| `ExposureDecision` | 并发、价值、尝试、损失、集群和有效期 | Lease 前 | 接口 `DECIDED`;算法 `OPEN` | +| `Lease` | Assignment、Provider、epoch、期限、条件权利 | Provider 接受 | 握手边界 `DECIDED`;Schema `OPEN` | +| `ExecutionCapability` | active Lease 的 Receipt/epoch/execution tuple/scope/expiry 绑定 | Lease 生效时派生 | 边界 `DECIDED`;Schema `OPEN` | +| `Attempt` | 一次有界执行及其状态和原因 | 终止时 | `OPEN`,Priority `P0` | +| `Checkpoint` | 可恢复状态、摘要、格式和环境 | 接收时 | `OPEN`,Priority `P0` | +| `ResultSubmission` | 结果、摘要、epoch、证据、幂等键 | 校验接收 | `OPEN`,Priority `P0` | +| `EligibilitySnapshot` | 有限总体、排除、分层、相关性、随机承诺 | 首次 draw 前 | 接口 `INVARIANT`;Schema `OPEN` | +| `VerificationEvidence` | 方法、输入、输出、来源、成本、关联 | 接收时 | `OPEN`,Priority `P0` | +| `VerificationDecision` | TRUSTED/UNRESOLVED、策略和完整证据链 | 原子终态提交 | `OPEN`,Priority `P0` | +| `AssumptionEvaluation` | 完整 CauseSet、reducer 版本和派生 EffectiveVerdict | 判决求值时 | 分层 `DECIDED`;Schema `OPEN` | +| `VerificationProfile` | Claim、排除项、方法、参数、假设、失败与终态映射 | Receipt 创建前注册并绑定 | P0-1A `CLOSED`;P0-1B `STARTED` | +| `MainnetAssuranceProfile` | network、允许 Profile/组件、有效期、能力处置和损失预算 | 主网发布/Receipt 绑定前 | P0-1A `CLOSED`;部署实例 `CANDIDATE` | +| `Settlement` | 权利人、金额、来源、唯一键、状态 | Commit | `OPEN`,Priority `P0` | +| `EventRecord` | 状态变化、因果引用、版本、签名/摘要 | 追加时 | 接口 `INVARIANT`;Schema `OPEN` | 协议 MUST NOT 定义 `Rank`、`ReputationState`、`VerifierAuthority` 或 `FoundationDecision` 权威对象。 @@ -194,20 +196,24 @@ RPR MUST 在执行前 fail-closed 验证 RIR 与 Profile,并默认隐藏 Host Aggregate MUST 产生可复算证据链。多个假设同时失效时 MUST 保存规范 `CauseSet`,由冻结 reducer 派生唯一 `EffectiveVerdict`。满足预声明停止条件时 MAY 提交条件性 `TRUSTED`;否则在上限或假设失效时 MUST 提交 `UNRESOLVED` 或其他准确终态。 -## 12. 终态 +## 12. 终态与创建结果 -每个 Receipt MUST 最多提交一个互斥协议终态: +每个成功登记的 Receipt MUST 最多提交一个互斥协议终态: - `TRUSTED`; - `UNRESOLVED`; - `FAILED`; - `EXPIRED`; - `FUNDING_EXHAUSTED`; -- `REJECTED_AT_CREATE`; -- `FAILED_PLANNING`; -- `UNSUPPORTED`。 +- `FAILED_PLANNING`。 -终态集合和层级仍需状态机冻结。`TRUSTED` MUST 绑定 `network_id`、assurance 版本和 `ExcludedClaims`,MUST NOT 被解释为绝对正确或主网外保证。 +Receipt 登记前的结果是 `CreateReceiptResult`,不是 Receipt 终态,也不产生 ReceiptID: + +- `ACCEPTED(receipt_id)`; +- `REJECTED_AT_CREATE(reason)`; +- `UNSUPPORTED(reason)`。 + +`REJECTED_AT_CREATE` 与 `UNSUPPORTED` MUST NOT 在 Receipt 登记后进入,也 MUST NOT 出现在 `CanonicalTerminal` 或任何终态集合中。终态集合和层级仍需状态机冻结。`TRUSTED` MUST 绑定 `network_id`、assurance 版本和 `ExcludedClaims`,MUST NOT 被解释为绝对正确或主网外保证。 ## 13. 资金与结算 diff --git a/docs/03-protocol/result-validation.md b/docs/03-protocol/result-validation.md index 70bd1ec..968b8db 100644 --- a/docs/03-protocol/result-validation.md +++ b/docs/03-protocol/result-validation.md @@ -19,20 +19,7 @@ ## 2. 任务验证 Registry -每个 Receipt MUST 引用一个版本化 `VerificationProfile`;具体证据方法作为其 `VerificationType`。Registry 至少需要描述: - -Profile、Claim、ExcludedClaims、MainnetAssurance、五相位 validator 与 canonical encoding 的当前权威语义见 [`verification-profile-schema.md`](verification-profile-schema.md)。该文件已关闭 P0-1A;P0-1B 实现覆盖仍在进行。 - -- 适用任务族和输入/输出语义; -- 适用 RIRVersion、执行 Profile、runtime/effects 与规范结果表示; -- 结果等价或聚类规则; -- 验证器输入、输出和错误模型; -- 是否确定性、可重执行、可抽样或依赖证明; -- 资源、环境和独立故障来源; -- 允许的 Aggregation 与终态; -- `VerifiedClaim`、`ExcludedClaims` 与 Requester 可见确认; -- 安全参数、活性参数、成本接口和假设状态; -- 负例、已知盲点和升级规则。 +每个 Receipt MUST 引用一个版本化 `VerificationProfile`;具体证据方法作为其 `VerificationType`。Registry 的对象类型、快照结构与校验规则以 [`verification-profile-schema.md`](verification-profile-schema.md) 的 §3.1、§3.5、§5 与 §6 为权威;Profile、Claim、ExcludedClaims、MainnetAssurance、五相位 validator 与 canonical encoding 的当前权威语义见同一文件。该文件已关闭 P0-1A;P0-1B 实现覆盖仍在进行。 为避免与首个工程目标 `V1` 混淆,不再使用 `V0–V3` 作为验证类型占位编号。候选类别仅表示方法族,具体 Registry ID 尚未冻结: diff --git a/docs/03-protocol/verification-profile-schema.md b/docs/03-protocol/verification-profile-schema.md index 93cef0d..88ea9f7 100644 --- a/docs/03-protocol/verification-profile-schema.md +++ b/docs/03-protocol/verification-profile-schema.md @@ -360,8 +360,8 @@ P0-1B 不得从字段名猜测类型。以下标量与容器为本文件所有 | `Instant` | `int`,Unix epoch UTC 毫秒;只作为显式输入,不授权 validator 读取墙钟 | | `SemVer` | `[major:uint, minor:uint, patch:uint]`,恰好三项 | | `Rational` | `[numerator:int, denominator:uint]`,`denominator>0` 且既约 | -| `TimeRange` | `{start:Instant, end:Instant}`,半开区间且 `start` | 按 `acl.enc.p0-1@1` 编码字节升序、无重复的数组 | @@ -2941,7 +2941,7 @@ encoding_profile_id = "acl.enc.p0-1@1" | `SemVer` | 3 元数组 `[major: uint, minor: uint, patch: uint]` | P0-1 不含 pre-release / build metadata | | `VersionRange` | CBOR map,整数键:`{0: SemVer, 1: SemVer?}` | 键 0 = `min_inclusive`;键 1 = `max_exclusive`,**无上界时整个键省略**;在场时 `min_inclusive < max_exclusive` | | `Instant` | CBOR int | Unix epoch 起的毫秒数,UTC。**不使用 RFC3339 字符串**,以消除格式化歧义 | -| `TimeRange` | 2 元数组 `[start: Instant, end: Instant]` | 半开区间,`start < end` | +| `TimeRange` | 2 元数组 `[start: Instant, end: Instant]`(唯一线上形式) | 半开区间,`start < end` | | 集合 | CBOR array | 元素按其编码字节字典序升序;无重复 | | 有序 map | CBOR map | 键按编码字节字典序升序 | @@ -2982,7 +2982,7 @@ H_{\mathrm{tag}}(x)=\mathrm{SHA256}\big(\ \mathrm{u8}(|\mathrm{tag}|)\ \|\ \math SV-42 按 §13.2 **仅负责容器 canonicality**(map 键序、集合/规范 pair-array 排序去重、既约 `Rational`);primitive 禁令归 SV-25,整数范围、最短整数与 bignum 禁令归 SV-52,**不再声称覆盖全部摘要**;SV-41 收窄为「slot index 唯一、gate 按 slot 携带」,**不再检查 `policy_digest`**(该职责归 SV-53b);SV-54 拆为 SV-54a(结构覆盖,L1b)与 SV-54b(摘要重算,L2)。 -新增 tag MUST 提升 `encoding_profile_id` 的版本号。tag 复用 MUST NOT 发生。 +对象版本的 tag 与编码 Profile 版本彼此独立:新增对象版本的 tag 不要求提升 `encoding_profile_id`,只有编码规则变化时才 MUST 提升(例如 Profile v2 使用 `ACLt/P0-1/Profile/2`,`encoding_profile_id` 仍为 `acl.enc.p0-1@1`)。已发布摘要不变。tag 复用 MUST NOT 发生。 ### 17.5A bignum 禁令与运行时资本的职责分界 @@ -3019,13 +3019,15 @@ L1b 是 draft-4 遗漏的一层。它 MUST 是**确定性纯函数**:同一输 ToSchemaView(canonical_cbor, object_wire_key_table) -> JSONValue ``` -- 规范对象的 CBOR map key 必须先由该对象唯一的 wire-key 表映射为文本字段名;未知/重复/不可逆 key 在投影前拒绝; +- 规范对象的 CBOR map key 按下述 wire-key 通则映射为文本字段名;未知/重复/不可逆 key 在投影前拒绝; - `bstr` 映射为小写偶数位十六进制字符串; - `int/uint` 映射为规范十进制字符串,`-0`、前导零和 `+` 号禁止; - `Rational` 映射为两个规范十进制字符串组成的定长数组; - array 保持顺序;bool/string 保持 JSON 同类值;null、float、tag 与 indefinite-length 在 L2 拒绝,不进入 Schema View; - 必须满足 `FromSchemaView(ToSchemaView(x)) = x`;每个 VPCV 同时携带 `cbor_hex` 与 `schema_view`,两实现必须逐位一致。 +**wire-key 通则(2026-11-19 冻结)**:在 `acl.enc.p0-1@1` 下,规范对象 CBOR map 的字段键与字段名文本相同,即 `object_wire_key_table` 为恒等映射。现有整数键例外只有 `VersionRange` 的 0/1(§17.3)。该通则不提供逆映射所需的字段类型表:`FromSchemaView` 仍需要类型信息才能区分 bstr 十六进制、整数十进制与 `String`;该问题由 TG-8(#213)处理。 + L2 先验证原始 CBOR 可被安全、唯一地投影;L1a 再验证 Schema View;L1b 消费同一 Schema View 与显式 bundle。投影算法自身是 Type A/L2 owner,不得由不同 JSON Schema 实现自行定义。 规则(MUST): @@ -3835,7 +3837,7 @@ P0-1A 在完成本文件的独立入口审计后,可以判定 `READY FOR P0-1B | ADR-0005 已接受但正文仍写“未开始/待裁定” | ADR 增加 D-01—D-10 采纳矩阵,D-02 固定采用 (a),状态同步 | ADR-0005 §6;本文件 §0、§2 | | ADR-0005 要求保留多原因,draft-11 仍只保存单 verdict | 冻结 `CauseSet + versioned reducer -> EffectiveVerdict`;摘要同时绑定事实集与归约器 | §5.2、SV-54a/54b、SV-57、VPCV-R | | `ConformanceManifest` / `RegistrySnapshot` 的结构与 wire-shape 表冲突 | 两对象统一使用嵌套 `VersionedUVPHeader` | §3.3.2、§3.4、§3.5、SV-85 | -| `Rational`、`VersionRange`、`TimeRange` 有两套基础定义 | 统一 denominator 为 uint、范围为非空半开区间、字段名为 `min_inclusive` | §3.2.1、§17.3 | +| `Rational`、`VersionRange`、`TimeRange` 有两套基础定义 | `Rational` 与 `VersionRange` 的统一已在本轮完成(denominator 为 uint、范围为非空半开区间、字段名为 `min_inclusive`)。`TimeRange` 的语义当时已统一,线上形式仍未冻结;2026-11-19 的修订将唯一线上形式固定为 2 元数组,旧 map 向量保留为历史(§29.3) | §3.2.1、§17.3、§29.3 | | MAP 的“运行中减权”与注册对象不可变冲突 | 新 Receipt 通过新版本处置;既有 Receipt 通过所需假设撤销 fail closed | §3.6 MAP-3 | | Lease 继承只有文字要求,MAP 未绑定 capability contract | MAP 新增 `execution_capability_contract_ref`;冻结最小 payload、双点校验和 Type A/Type B 边界 | §3.6、§13.1A.1、SV-111 | | 运行时资本误写成 Profile `Rational` | 明确资本使用 `finite-population-boundary-lr-v1` 无位宽格式 | §17.5A、§17.8 | @@ -3855,3 +3857,13 @@ REEXEC_BOUNDED mainnet capability: DISABLED by default ``` 允许 P0-1B 使用固定、显式标注的测试参数实现 Schema、纯 validator、摘要和向量;生产部署只能由已绑定的 `MainnetAssuranceProfile` 在其有限条件内启用能力。 + +### 29.3 2026-11-19 R1 第一轮裁定修订 + +本节记录 [REPO-AUDIT R1 第一轮裁定](https://github.com/ZeroMatrixTech/ACLt/issues/211#issuecomment-6991230132)中属于本文件规范文本的事项(工作项 [#216](https://github.com/ZeroMatrixTech/ACLt/issues/216)): + +- **`TimeRange` 线上形式**(裁定 2):§17.3 的 2 元数组是唯一线上形式;§3.2.1 的命名键 map 是数据模型视图。注册路径只接受数组,原 20 条 map 形式向量保留为历史向量,标为旧形式,不覆盖,也不就地重算。本次冻结不改变 `encoding_profile_id`(仍为 `acl.enc.p0-1@1`),也不重算已发布摘要。§29.1 中“已统一”的说法按本节更正。 +- **wire-key 通则**(裁定 3):§17.5B 冻结恒等映射。本文件当前冻结的整数键例外只有 `VersionRange` 的 0/1(§17.3);仓库内候选切片与 FM 基础对象均使用恒等文本键(`schemas/verification-profile/claim-codec-slice.json`、`schemas/formal-migration/foundation.json`),未发现其他例外。逆映射所需的字段类型表由 TG-8(#213)处理。 +- **对象版本 tag 与编码 Profile 版本**(裁定 5):§17.4 澄清两者独立;新增对象版本的 tag 不要求提升 `encoding_profile_id`,只有编码规则变化才提升;已发布摘要不变。 + +本次修订不改动 §20—§28 的历史审计响应原文,也不改变任何已发布摘要、向量或代码。 diff --git a/docs/05-decisions/ADR-0009-proof-verified-computation-statements.md b/docs/05-decisions/ADR-0009-proof-verified-computation-statements.md index 903884d..097cf35 100644 --- a/docs/05-decisions/ADR-0009-proof-verified-computation-statements.md +++ b/docs/05-decisions/ADR-0009-proof-verified-computation-statements.md @@ -9,7 +9,7 @@ - **项目方向**:2026-11-11 维护者提出的方向:Provider 给出计算命题 F 的空前件逻辑后承陈述 `⊢ F`;验证对象是该陈述,而不是直接验证 F;用机械化的语义差分实现。本 ADR 把该方向落成可评审的接口。 - **候选条款**:§3—§9 由助手起草,SemanticStatus 为 `CANDIDATE`。按[审计程序](../08-governance/audit-procedure.md) §4,接受前属于未接受草案,不得作为实现或 conformance 的规范依据。 -- **版本处置不变**:[V1 Profile](../03-protocol/v1-profile.md) 中 `verification.proof-assisted` 保持 `DEFERRED`。改为 `CORE` 须另有证据、兼容性分析与 ADR(v1-profile §8)。本草案只为非主网测试路线提供候选实例。 +- **版本处置不变**:V1 Profile 尚未登记 `verification.proof-assisted`;[Profile Schema](../03-protocol/verification-profile-schema.md) §16.2 的非权威建议表把它列为 `DEFERRED`。改为 `CORE` 须另有证据、兼容性分析与 ADR(v1-profile §8)。本草案只为非主网测试路线提供候选实例。 - **不修改规范**:不修改协议规范、不变量、威胁模型、Gate 或主网资格。接受时的同步项见 §11。 ## 1. 背景 diff --git a/docs/07-roadmap/current-status.md b/docs/07-roadmap/current-status.md index e3e1bb4..4f944c1 100644 --- a/docs/07-roadmap/current-status.md +++ b/docs/07-roadmap/current-status.md @@ -30,7 +30,7 @@ | P0-1B Profile 注册 | [R1 正式摘要与判决](../testing/PROFILE-DIGEST-R1-20261107.md)及 [R2 嵌套类型/导入与注册上下文](../testing/PROFILE-REGISTRATION-R2-20261107.md):新增 RegistrySnapshot/事件快照摘要与六类注册条目检查,audit Phase R 显式接两个快照;[R3](../testing/PROFILE-REFERENCES-R3-20261108.md)补排除集/注册对象引用与两个摘要,并修正 TimeRange/ExternalTypedObject wire | [R4](../testing/PROFILE-RULES-R4-20261108.md)落实共同假设/撤销/scope/方法必需类与静态集合摘要;[R5](../testing/PROFILE-MATRICES-R5-20261108.md)补四方法参数/失败/条件矩阵;[R6](../testing/PROFILE-CREATION-R6-20261108.md)补固定 audit I/F 测试接线、三个摘要与 CC-1;[R7](../testing/PROFILE-SELECTION-R7-20261108.md)集中完成注册/选择/绑定 14 项,扩展 7 项仍 partial;[R8](../testing/PROFILE-COMMITMENTS-R8-20261108.md)集中完成 19 项 Claim/快照/承诺规则,18 个摘要公式/投影已有双语言实现;[R9](../testing/PROFILE-RUNTIME-R9-20261108.md)补七种 Phase B 的运行期绑定/冻结/阶段守卫,snapshot/population/randomness 仍限 TEST imports,SV-69/81 partial。[R10](../testing/PROFILE-DECISION-R10-20261109.md)加入 audit-only Phase D 测试重放,SV-115/121 partial。[R11](../testing/PROFILE-AUTHORITY-R11-20261109.md)接入 FM-S3 候选权威来源与结算对照,SV-119 partial;下一步评审候选输入胶囊的正式版本承诺、ENUM/sum wire,闭合 FailureReason、predicate/gate 和完整重放。其他方法 wire 缺口独立追踪,完整 Phase R 尚未验收 | | Phase I/F/B/D 候选接口 | [R14](../testing/PROFILE-PHASE-D-R14-20261111.md)验证历史 B/D 信封,[R15](../testing/PROFILE-PHASE-D-R15-20261111.md)实现创建时部署绑定并串联授权、判决与结算 | [R16](../testing/PROFILE-PHASE-D-R16-20261111.md)验证候选部署撤销;正式 FM-A08 仍依赖 Profile/来源审批、撤销传播和部署证据 | | 首次公开发布(research-preview-1) | [发布说明](../releases/PREVIEW-20261106.md)(文件名保留 `PREVIEW-20261106.md`)与[维护记录](../08-governance/audits/audit-20261106-01-repository-maintenance.md):README 已加统一成熟度声明与 #101 边界;源码包可重现、包内本地检查可运行 | 仓库已转为公开,公开仓库设置已落地并读回核对;DCO fork 实测([#181](https://github.com/ZeroMatrixTech/ACLt/pull/181))确认未签名提交被阻止、补签后通过;标签 `research-preview-1` 指向 [1533290](https://github.com/ZeroMatrixTech/ACLt/commit/1533290ed82347a5a5006e4d35a5092d02362780),[GitHub Release](https://github.com/ZeroMatrixTech/ACLt/releases/tag/research-preview-1) 于 2026-11-16 发布并记录发布 commit、源码包 SHA-256 与 CI 记录。发布名不是 ProtocolVersion、ConformanceTarget 或部署启用 | -| 证明验证路线 | [ADR-0009](../05-decisions/ADR-0009-proof-verified-computation-statements.md) `PROPOSED` 草案:以推导证书验证计算陈述,分陈述绑定、推导检查与语义充分性三层;`verification.proof-assisted` 仍为 V1 `DEFERRED` | 评审接口;首个实例依赖 RIR-0 形式语义(PO-11),在此之前只走非主网测试路线 | +| 证明验证路线 | [ADR-0009](../05-decisions/ADR-0009-proof-verified-computation-statements.md) `PROPOSED` 草案:以推导证书验证计算陈述,分陈述绑定、推导检查与语义充分性三层;`verification.proof-assisted` 尚未登记进 V1 Profile;[Profile Schema](../03-protocol/verification-profile-schema.md) §16.2 的非权威建议表列为 `DEFERRED` | 评审接口;首个实例依赖 RIR-0 形式语义(PO-11),在此之前只走非主网测试路线 | | 验收边界 | P0-1B 为 81/35/3,ADR-0006 仍 PROPOSED,Gate/OQ/主网资格不变 | 不将路线接受当成 conformance 或部署启用 | 当前依据:[ADR-0006 分层评审](../05-decisions/reviews/REVIEW-20261028-layered.md)、[三份机器摘要与校验](../testing/MIGRATION-EVIDENCE-20261028.md)、[FM-S3 audit 依赖](fm-s3-audit-dependencies.md)。以下带日期记录为历史,不覆盖本表优先级。 @@ -205,6 +205,7 @@ ACLt Protocol v0.5 已完成最小语义基线和文档骨架:两类不可约 | 日期 | 基线 | 变化 | 证据/文档 | 影响的 Gate | |---|---|---|---|---| +| 2026-11-19 | v0.5 | SR-1(#216):落实 REPO-AUDIT R1 第一轮裁定中的文本项——把 #171 改坏的 threat-model §11 引导句与 project-overview:101 恢复为正向限定表述;`TimeRange` 线上形式固定为 2 元数组,旧 map 向量保留为历史;冻结恒等 wire-key 通则与 `VersionRange` 例外;澄清对象 tag 与编码 Profile 版本独立;终态集合同步 ADR-0005 D-02(a);补齐 R1-049/061/064/066 与复核补充的文档同步。不改代码、向量、摘要 | 各规范与概览文档、#211、#216 | 不变 | | 2026-11-18 | v0.5 | A1:归档 #101 闭合后仓库假设专项审计(AUD-20261117-01)——报告按原字节入库,两份审计索引同步,结论为 BLOCKER 0、MAJOR 0、MINOR 1、NOTE 10,未发现把固定协调者、固定统计工件、固定 gas 推导或来宾级证据无条件提升为正式协议通用保证的实质性表述;唯一 MINOR(A-11)按报告建议修正“单节点交付容量对照”行的范围说明,写明排序任务族接入通用契约已完成来宾级验收并链接 M2,物理双机下的同一能力没有验收记录、是否要求待维护者确认;#101 不因此关闭 | [专项审计](../08-governance/audits/audit-20261117-01-post-closure-assumptions.md)、[审计索引](../08-governance/audits/README.md)、#101、#207 | 不变 | | 2026-11-18 | v0.5 | P1-q:`dco` 兼容 GitHub 的共同作者后缀——PR 中的提交有多位作者时,GitHub 在 squash 合并时把 `---------` 分隔行与 `Co-authored-by` 行追加到说明末尾,签名落到倒数第二段,于是 `main` 上的推送检查把它判成漏签(`ece86b5`);正文检查与推送检查共用同一个剥离函数,只在后缀恰为一整行 9 个 `-` 加若干 `Co-authored-by` 行、且该段位于最末尾时剥离,其他 `---` 行、名单校验与 fork 逐提交检查不变;`ece86b5` 的真实说明作为夹具覆盖,原失败记录保留 | `scripts/check-dco.py`、`tests/repository_hardening/test_check_dco.py`、`tests/repository_hardening/dco_pr_simulation.py`、`CONTRIBUTING.md` §11、[PARALLEL-1](../08-governance/parallel-workflow.md)、#204 | 不变 | | 2026-11-18 | v0.5 | P1-p:`dco` 只检查签名者——名单只登记 `signoff` 身份(`inpac ` 与新增的 `Ankar `),删除 `author` 角色与全部 `author` 行,出现未知角色仍然失败;本仓库分支的 PR 不再逐提交检查作者与签名,正文中签名者的签名统一确认整个 PR,fork PR 的逐提交检查与推送到 `main` 的兜底检查不变;签名按 DCO 1.1 为该贡献作确认,代理仍不得签名,合并仍由维护者执行。名单与检查脚本都只从目标分支的受信任检出读取,新名单在合并后才对 `dco` 生效 | `scripts/check-dco.py`、`.github/dco-maintainers.txt`、`.github/workflows/dco.yml`、`CONTRIBUTING.md` §11、[PARALLEL-1](../08-governance/parallel-workflow.md)、`README.md`、`CONTRIBUTORS.md`、[公开仓库设置](../08-governance/public-repository-settings.md)、`tests/repository_hardening/test_check_dco.py`、`tests/repository_hardening/dco_pr_simulation.py`、#202 | 不变 | From 2d95544e19d9ab6e17bc285acf9b3f746e59b40e Mon Sep 17 00:00:00 2001 From: inpac Date: Thu, 19 Nov 2026 10:58:40 +0100 Subject: [PATCH 2/3] docs: clarify the TimeRange historical-vector wording (SR-1) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Change: §29.3 的 `TimeRange` 条目区分规范行为与 B1 的实现/向量迁移:规范行为只接受 2 元数组;原 20 条 map 形式向量按裁定保留为历史,迁移时才标为旧形式,不覆盖、不就地重算。 Problem / counterexample: 首轮文本写成“保留为历史向量,标为旧形式”,会让读者以为本 PR 已经标记或迁移了向量文件;本 PR 的非目标明确不改向量。 Status before: §29.3 的措辞可能被读成本次已标记旧向量。 Status after: 规范行为与迁移责任分开;实现与向量迁移写明由 B1 处理。 Affected objects/functions: TimeRange。 Affected invariants: 无;仅 §29.3 修订记录措辞。 Affected threats: 无。 New assumptions: 无。 Compatibility/migration: 不改变 encoding_profile_id、已发布摘要或任何向量字节。 Tests or proofs: 纯文档改动;`check-repository-evidence.py`、`make check-profile-inventory`、`git diff --check` 均见 PR 正文的验证表。 Residual risk: 无新增;B1 仍需按裁定迁移注册路径与向量。 Documents updated: docs/03-protocol/verification-profile-schema.md --- docs/03-protocol/verification-profile-schema.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/03-protocol/verification-profile-schema.md b/docs/03-protocol/verification-profile-schema.md index 88ea9f7..af5f2d0 100644 --- a/docs/03-protocol/verification-profile-schema.md +++ b/docs/03-protocol/verification-profile-schema.md @@ -3862,7 +3862,7 @@ REEXEC_BOUNDED mainnet capability: DISABLED by default 本节记录 [REPO-AUDIT R1 第一轮裁定](https://github.com/ZeroMatrixTech/ACLt/issues/211#issuecomment-6991230132)中属于本文件规范文本的事项(工作项 [#216](https://github.com/ZeroMatrixTech/ACLt/issues/216)): -- **`TimeRange` 线上形式**(裁定 2):§17.3 的 2 元数组是唯一线上形式;§3.2.1 的命名键 map 是数据模型视图。注册路径只接受数组,原 20 条 map 形式向量保留为历史向量,标为旧形式,不覆盖,也不就地重算。本次冻结不改变 `encoding_profile_id`(仍为 `acl.enc.p0-1@1`),也不重算已发布摘要。§29.1 中“已统一”的说法按本节更正。 +- **`TimeRange` 线上形式**(裁定 2):§17.3 的 2 元数组是唯一线上形式;§3.2.1 的命名键 map 是数据模型视图。注册路径的规范行为是只接受数组,原 20 条 map 形式向量按裁定保留为历史向量;实现与向量迁移由 B1 处理,迁移时标为旧形式,不覆盖,也不就地重算。本次冻结不改变 `encoding_profile_id`(仍为 `acl.enc.p0-1@1`),也不重算已发布摘要。§29.1 中“已统一”的说法按本节更正。 - **wire-key 通则**(裁定 3):§17.5B 冻结恒等映射。本文件当前冻结的整数键例外只有 `VersionRange` 的 0/1(§17.3);仓库内候选切片与 FM 基础对象均使用恒等文本键(`schemas/verification-profile/claim-codec-slice.json`、`schemas/formal-migration/foundation.json`),未发现其他例外。逆映射所需的字段类型表由 TG-8(#213)处理。 - **对象版本 tag 与编码 Profile 版本**(裁定 5):§17.4 澄清两者独立;新增对象版本的 tag 不要求提升 `encoding_profile_id`,只有编码规则变化才提升;已发布摘要不变。 From 32b0b6851bd1eb44bbea5c8db80cd79052396c74 Mon Sep 17 00:00:00 2001 From: inpac Date: Thu, 19 Nov 2026 11:16:03 +0100 Subject: [PATCH 3/3] fix: address the SR-1 audit findings (PRA-217-01, PRA-217-02) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Change: - protocol-spec §12:`CreateReceiptResult` 是创建操作的返回类型;`ACCEPTED` 成功登记 Receipt 并返回 ReceiptID;只有 `REJECTED_AT_CREATE` 与 `UNSUPPORTED` 创建失败且不产生 ReceiptID。 - `fm-s3-audit-dependencies.json`/`.md`:核对 SR-1 的 §3/§17 文本修订未改变 SV 编号、119 项 Type A 计数、audit scope、四个 audit 终态或工作包划分;刷新 Profile Schema 的 `source_sha256`,并写明该核对结论。 - `SINGLEHOST-SHA256SUMS`:由 `make manifests` 重新生成。 Problem / counterexample: PRA-217-01:引导句把整个 `CreateReceiptResult` 描述为不产生 ReceiptID,与 `ACCEPTED(receipt_id)` 及 `verification-profile-schema.md` D-02(a) 的成功分支冲突。PRA-217-02:活依赖计划的 `source_sha256` 仍钉旧 Profile Schema,`tests/migration_evidence` 报 `stale normative dependency source`。 Status before: 创建结果引导句覆盖整个类型;依赖计划 pin 指向 `origin/main` 的旧字节。 Status after: 成功/失败分支分开;依赖计划 pin 与当前 HEAD 字节一致;定向测试与整个 `tests/migration_evidence` 模块通过,计划仍为 `PLANNED_NOT_RUN`。 Affected objects/functions: `CreateReceiptResult`、FM-S3 audit dependency plan。 Affected invariants: INV-01(仅澄清成功创建的 ReceiptID 语义,不改不变量)。 Affected threats: 无新增。 New assumptions: 无。 Compatibility/migration: 不新增规则;已发布摘要与向量不变;依赖计划覆盖计数仍为 81/35/3,工作包与 audit scope 不变。 Tests or proofs: 见 PR 正文;`tests/migration_evidence` 17 项通过。 Residual risk: PRA-217-01/02 修复待审计复核;无新增理论缺口。 Documents updated: docs/03-protocol/protocol-spec.md docs/07-roadmap/fm-s3-audit-dependencies.json docs/07-roadmap/fm-s3-audit-dependencies.md SINGLEHOST-SHA256SUMS --- SINGLEHOST-SHA256SUMS | 2 +- docs/03-protocol/protocol-spec.md | 8 ++++---- docs/07-roadmap/fm-s3-audit-dependencies.json | 2 +- docs/07-roadmap/fm-s3-audit-dependencies.md | 4 +++- 4 files changed, 9 insertions(+), 7 deletions(-) diff --git a/SINGLEHOST-SHA256SUMS b/SINGLEHOST-SHA256SUMS index 8d2e312..58cd265 100644 --- a/SINGLEHOST-SHA256SUMS +++ b/SINGLEHOST-SHA256SUMS @@ -10,7 +10,7 @@ d72675ebcd951cfc0621ca2f5ce4e45423d2e46cc7287f877e02225506b5383c DELIVERY-SCOPE 3ce34721d9ab45f4025d2a382c927fc729aa132c41381c21863780972e59c1a8 Makefile 38ae10897b8fc7065de31181e30c73bd33a85312e6b6dcff7da5c729b50485f4 REUSE.toml 3c31cdc131fc3e73a61231e185a5d7245f71565444c276cce62b7e8efad0361d WORKFLOW-SHA256SUMS -956eea079e0111d70c1ee32f3be69c70b3d9075e1f80a93ee564463c051e6b9c docs/07-roadmap/fm-s3-audit-dependencies.json +0322a918cab37c76d31a38b219bb6300553ab1c2ec620908ec1aa2410513e506 docs/07-roadmap/fm-s3-audit-dependencies.json 193fd2886ead940668e6e1e0314e5d08cf926923f28984d456a10c11e2cde265 docs/testing/AUDIT-FIXES-20261105.summary.json e1b4472bdcf13d122272c6d95412e5841f06866eaf0deea72ea94d1f0ad40f7d docs/testing/CI-GIT-SOURCE-FIX-20261105.summary.json 9438d3bdd18cc22fa6d4ad484cd15a144ab950c49617766548bb20dd6db1114a docs/testing/ENVIRONMENT.json diff --git a/docs/03-protocol/protocol-spec.md b/docs/03-protocol/protocol-spec.md index 9d2aac0..d643993 100644 --- a/docs/03-protocol/protocol-spec.md +++ b/docs/03-protocol/protocol-spec.md @@ -207,11 +207,11 @@ Aggregate MUST 产生可复算证据链。多个假设同时失效时 MUST 保 - `FUNDING_EXHAUSTED`; - `FAILED_PLANNING`。 -Receipt 登记前的结果是 `CreateReceiptResult`,不是 Receipt 终态,也不产生 ReceiptID: +`CreateReceiptResult` 是创建操作的返回类型,不是 Receipt 终态: -- `ACCEPTED(receipt_id)`; -- `REJECTED_AT_CREATE(reason)`; -- `UNSUPPORTED(reason)`。 +- `ACCEPTED(receipt_id)`:成功创建并登记 Receipt,返回 ReceiptID; +- `REJECTED_AT_CREATE(reason)`:创建失败,不产生 ReceiptID; +- `UNSUPPORTED(reason)`:当前版本不支持,创建失败,不产生 ReceiptID。 `REJECTED_AT_CREATE` 与 `UNSUPPORTED` MUST NOT 在 Receipt 登记后进入,也 MUST NOT 出现在 `CanonicalTerminal` 或任何终态集合中。终态集合和层级仍需状态机冻结。`TRUSTED` MUST 绑定 `network_id`、assurance 版本和 `ExcludedClaims`,MUST NOT 被解释为绝对正确或主网外保证。 diff --git a/docs/07-roadmap/fm-s3-audit-dependencies.json b/docs/07-roadmap/fm-s3-audit-dependencies.json index ebb590d..34ee8b7 100644 --- a/docs/07-roadmap/fm-s3-audit-dependencies.json +++ b/docs/07-roadmap/fm-s3-audit-dependencies.json @@ -6,7 +6,7 @@ "inventory": "schemas/verification-profile/inventory.json", "coverage": "schemas/verification-profile/coverage.json", "source_sha256": { - "docs/03-protocol/verification-profile-schema.md": "edab977989725b8f5129629d77fe3ddcffc403e36f746d3382dde594f086636a", + "docs/03-protocol/verification-profile-schema.md": "597ef56ca6f7d600766965a847e734bfc6774f7af6a05e6203fae8d22e4258fd", "schemas/verification-profile/inventory.json": "6f789a354e403a96c02a617d1a048cae0cc3e1884e21699dab5914af3529b2ef", "schemas/verification-profile/coverage.json": "0eaf19ce1cfc8427aa25bf31bd5086c7fa1262473a1646099bc893886fc2c853" }, diff --git a/docs/07-roadmap/fm-s3-audit-dependencies.md b/docs/07-roadmap/fm-s3-audit-dependencies.md index 1b80b1b..fd3ccd8 100644 --- a/docs/07-roadmap/fm-s3-audit-dependencies.md +++ b/docs/07-roadmap/fm-s3-audit-dependencies.md @@ -1,8 +1,10 @@ # FM-S3 的 audit-only 依赖入口 -日期:2026-10-28;2026-11-07 同步覆盖与来源清单。这是实施依赖清单,不是规则实现或规范状态升级。 +日期:2026-10-28;2026-11-07 同步覆盖与来源清单;2026-11-19 刷新 SR-1 后的规范源码 pin。这是实施依赖清单,不是规则实现或规范状态升级。 [机器清单](fm-s3-audit-dependencies.json)按现有 inventory 的全部编号逐项分类;要求、实现状态和原测试路径只引用原 inventory,不在此复制另一份权威。 +2026-11-19:SR-1(#216)对 `verification-profile-schema.md` 的 §3.2.1、§17.3、§17.4、§17.5B 文本修订已核对:SV 编号、119 项 Type A 计数、audit scope 与四个 audit 终态均未改变,工作包划分也不受影响。机器清单只把 `docs/03-protocol/verification-profile-schema.md` 的 `source_sha256` 更新到 `597ef56ca6f7d600766965a847e734bfc6774f7af6a05e6203fae8d22e4258fd`;另两个 pin 与全部 `acceptance` 仍为计划状态。 + ## 限定范围 只接一个明确固定的 REEXEC_AUDIT_ONLY Profile,不新增 selection/degradation/weakening 注册路径。Audit 不引用 ClaimTemplate、不产生 claim/ACCEPT/TRUSTED,不使用 B/Q、EligibilitySnapshot 或随机抽样;安全/活性参数为空。显式 AssumptionEvaluation 仍必需,AssumptionStateSnapshot 不是 EligibilitySnapshot。