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:
@@ -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]:
|
||||
|
||||
Reference in New Issue
Block a user