docs: 回写全仓库对契约套件的指向,以及 README、架构与 CHANGELOG

套件从 tests/contract/ 搬进 polyloop.testing 之后,全仓库 28 处引用要重新指过。修了 12 处,
其余在 design/(只增不改)与 scratch/(由人清理)里。

**CLAUDE.md 改了四处事实**:§0 权威表里行为契约的权威、§0 那句依赖规则的条数、§5 目录树与
模块数、§1.8 那句「谁断言公共 Protocol 的签名」。§1 的其余硬约束与 §2 的人类门一条没动。

**architecture.md**:分层图第 4 层加一格,装配层从三个变四个;代码地图加一行;第十节按代码
逐项重写——那笔「工具段渲染样式」的欠账**没有被数字对上盖掉**,加了 fingerprints 之后请求
的字段数恰好还是十一,而组成已经换过,所以那一节正面写着它仍然欠着;新增第十条依赖规则
(pytest 只在 testing 那个 extra 里,别处 import 它会让下游的生产环境一 import 本库就
ModuleNotFoundError),带静态与运行时两半;删掉「src/ 下一行代码都没有」那段过期状态说明;
决策索引补齐 0008 到 0016,其中四行原描述说的不是那份文档真正定的东西。

**migrations/dissect.md** 那笔「内存实现不存在」的欠账还掉了。

**压测那边**三条测试守的是一条已经撤销的公共契约,改名并写清它们现在守的是场景自己的选择。
AppWorld 那处刻意的偏离(不补三个反引号)留着不恢复——那条路径要模型输出被 stop 序列截断才
触发,而压测不配 stop 序列,恢复的收益不抵重跑一次压测的成本。但注释的理由改对了:它现在是
一笔有出处的欠账,不是一个决定。

CHANGELOG 攒在「未发布」段,版本号不提前写(§1.10)。
This commit is contained in:
2026-08-27 03:59:39 -04:00
parent 1fac387e75
commit c4e5732587
12 changed files with 246 additions and 80 deletions
+4 -3
View File
@@ -229,8 +229,9 @@ class LogRead:
"""一份 `.jsonl` 日志按行读回来的结果。
`torn` 说的是末尾有没有一段没被换行终结的字节。判据照存储那边的规矩:**看有没有被换行
终结,不看能不能解析**`polyloop.stores` 的 `_parse`)。那段字节对应的那次写从来没有被
确认过,按契约它就是没发生。
终结,不看能不能解析**`polyloop.stores` 那个逐行追加的实现,理由在
`research-wiki/design/0011-jsonl-run-store.md`)。那段字节对应的那次写从来没有被确认过,
按契约它就是没发生。
"""
payloads: tuple[Mapping[str, object], ...]
@@ -1423,7 +1424,7 @@ class AlwaysInvalidParser:
"""对任何模型输出都返回无效决策。解析失败连击那一类用它。
它不是「解析不出来」,是**声明这一步解释不了**——契约要求 `parse` 同步、不抛异常、解释
不出来时返回 `InvalidDecision``tests/contract/test_decision_parser.py`),这份实现照做。
不出来时返回 `InvalidDecision``polyloop.testing.DecisionParserContract`),这份实现照做。
"""
def parameters(self) -> Mapping[str, str]: