PolyLoop

iomgaa/PolyLoop

Fork 0

Commit Graph

Author	SHA1	Message	Date
iomgaa	a14bf8d288	test(contract): 落成五个接缝的契约骨架，用它逼出七个设计洞第 ④ 阶段的核心交付物。这套测试不针对任何具体实现，写的是「不管你怎么实现都必须满足这些行为」，下游写完自己的实现接到 fixture 上跑一遍即可，是任何新适配器的准入标准（CLAUDE.md §0）。现在全部跳过，因为公共类型与 Protocol 还没落地。价值不在跑，在写：写一条契约要求把每次调用逐字写出来——方法叫什么、参数填什么、返回值怎么取，而散文里读着通顺的地方，落到这一步就露出来了。三轮文档评审没报出的七个洞，写这套测试时全部撞了出来：没有动作的步 result_id 填什么；三个 ActionStatus 取值的触发条件；动作被拒绝时观察的来源（执行器与 SyntheticObservations 两处都有）；解释器能不能抛异常；Event 没有字段所以事件出口的契约只写得出一半； read_log 读不存在的运行必须返回空日志而不是抛异常；以及原子性与前缀持久性这两条 0005 的承诺根本没有机器兜底—— 写这套测试之前我们默认它们会被契约测试接住。洞标成 xfail(strict=True) 而不是常驻 fail：一个永远红的套件会训练所有人忽略红。它们都不带 fixture，否则会被「实现还没有」那个跳过挡住，于是「答不上来」就伪装成了「还没轮到」。补上之后 XPASS 会报错，逼人回来删标记。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-08-09 23:37:13 -04:00
iomgaa	a2e94318b9	chore(repo): 建仓，落成协作规范与文档骨架协作方式以 CHSAnalyzer 为蓝本，按「库」这个身份改写： - CLAUDE.md §0 的权威表换成公共 API 契约、公共类型、下游迁移三条主线，数据库 schema / HTTP 契约 / alembic 迁移在本项目不存在，整体删去。 - §1 新增四条库特有的硬约束：字段只增不删不改名、持久化 schema 走显式版本、不反向 import 下游、发布必须走完整流程（PolyGateway 有两个版本只 bump 没上传，registry 长期停在旧版且无人发现）。 - §3 的四类 Codex 对抗审查按同一判据重定：公共签名、停止判定与预算结算、取消传播与 Session 隔离、schema 演进。共同点是错了不会当场炸。 - research-wiki 在常青层加第四类 migrations/，因为本项目的核心验收标准就是能否搬回 dissect、能否替代 GovDoc-SaaS 的 docagent-core/，塞进 guides/ 会让它看起来像可选工序。 reference/ 不入库：五个仓库各带一个 .git、合计约 96MB，提交进来会变成一堆不可用的嵌套仓库。它也不是任何事实的权威，agent-core.md 同理。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-08-07 07:02:09 -04:00

Author

SHA1

Message

Date

iomgaa

a14bf8d288

test(contract): 落成五个接缝的契约骨架，用它逼出七个设计洞

第 ④ 阶段的核心交付物。这套测试不针对任何具体实现，写的是「不管你怎么实现
都必须满足这些行为」，下游写完自己的实现接到 fixture 上跑一遍即可，
是任何新适配器的准入标准（CLAUDE.md §0）。

现在全部跳过，因为公共类型与 Protocol 还没落地。价值不在跑，在写：
写一条契约要求把每次调用逐字写出来——方法叫什么、参数填什么、返回值怎么取，
而散文里读着通顺的地方，落到这一步就露出来了。

三轮文档评审没报出的七个洞，写这套测试时全部撞了出来：
没有动作的步 result_id 填什么；三个 ActionStatus 取值的触发条件；
动作被拒绝时观察的来源（执行器与 SyntheticObservations 两处都有）；
解释器能不能抛异常；Event 没有字段所以事件出口的契约只写得出一半；
read_log 读不存在的运行必须返回空日志而不是抛异常；
以及原子性与前缀持久性这两条 0005 的承诺根本没有机器兜底——
写这套测试之前我们默认它们会被契约测试接住。

洞标成 xfail(strict=True) 而不是常驻 fail：一个永远红的套件会训练所有人忽略红。
它们都不带 fixture，否则会被「实现还没有」那个跳过挡住，
于是「答不上来」就伪装成了「还没轮到」。补上之后 XPASS 会报错，逼人回来删标记。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-08-09 23:37:13 -04:00

iomgaa

a2e94318b9

chore(repo): 建仓，落成协作规范与文档骨架

协作方式以 CHSAnalyzer 为蓝本，按「库」这个身份改写：

- CLAUDE.md §0 的权威表换成公共 API 契约、公共类型、下游迁移三条主线，
  数据库 schema / HTTP 契约 / alembic 迁移在本项目不存在，整体删去。
- §1 新增四条库特有的硬约束：字段只增不删不改名、持久化 schema 走显式版本、
  不反向 import 下游、发布必须走完整流程（PolyGateway 有两个版本只 bump
  没上传，registry 长期停在旧版且无人发现）。
- §3 的四类 Codex 对抗审查按同一判据重定：公共签名、停止判定与预算结算、
  取消传播与 Session 隔离、schema 演进。共同点是错了不会当场炸。
- research-wiki 在常青层加第四类 migrations/，因为本项目的核心验收标准就是
  能否搬回 dissect、能否替代 GovDoc-SaaS 的 docagent-core/，塞进 guides/
  会让它看起来像可选工序。

reference/ 不入库：五个仓库各带一个 .git、合计约 96MB，提交进来会变成一堆
不可用的嵌套仓库。它也不是任何事实的权威，agent-core.md 同理。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-08-07 07:02:09 -04:00

2 Commits