 iomgaa
|
d833b7a4d9
|
chore(release): 定版 1.0.2
CHANGELOG 的「未发布」段落定成 1.0.2（2026-08-27），上面留一个空段给下一版接着攒；
两处版本号（pyproject.toml 与 polyloop/__init__.py）同步。
发之前跑了一轮完整压测，与 1.0.1 那次验收逐项可比：正常负载 197 次运行、1845 次真实模型
调用，十一条不变量全部通过零击穿；九类故障注入 58 条判据全部通过、零 failed。库本身没有被
压出 bug。产物在 tools/soak/runs/v1.0.2/（该目录在 gitignore 里）。
README 的三条安装命令不用改：约束是 polyloop==1.0.*，1.0.2 落在里面。这同时意味着钉了那个
约束的下游一次例行升级就会拿到这一版，而这一版有一处行为变化（参数快照里注入内容的键形状）
——眼下没有下游在用，所以实际影响为零，CHANGELOG 里那一节把失败形态写清楚了。
|
2026-08-27 05:29:28 -04:00 |
|
|
iomgaa
|
c4e5732587
|
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）。
|
2026-08-27 03:59:39 -04:00 |
|
|
iomgaa
|
303e4ebc1c
|
chore(release): 打包元数据补齐，版本定到 1.0.1
发布前置：readme 与 project.urls 从第一版就写全——缺 readme 的话 registry 包页面正文一片
空白，而 twine 只警告不阻塞上传，三步全绿产物却是坏的（PolyGateway 1.1.2 的教训）。
build 与 twine 钉进 dev extra 而不是靠人手装，PolyGateway 那边它们不在任何 extra 里，
于是发布指南得多写一条「记得先装」，那种步骤迟早有人漏。
README 里那条「项目还没有可用的功能、十个模块是空骨架」的横幅早就过期了，而打包会把当时的
README 固化进 sdist、发布后再改无效，所以在构建之前换成安装说明与现状。顺带修两处与事实
不符的：GovDoc-SaaS 的实现已经在 8 月 3 日整体清空，⑥ 对它的验收标准改成设计级验收。
新建 CHANGELOG.md，写清楚首个版本为什么是 1.0.1 而不是 0.x——「公共类型的字段只增不删不
改名」那条承诺从第一个下游装上它那天起就生效，而 0.x 意味着随时可以破坏兼容。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
2026-08-11 00:11:04 -04:00 |
|