任务:终审查出的真实值,和仓库检查加宽
依据:AGENTS.md:
- 不提交凭据、内部地址、真实业务数据和本机绝对路径;
- 样例地址用 192.0.2.0/24;
- 夹具照真实系统的结构做,不带真实内容。
集成者 10-23 的终审查出几处没守住的地方。文档里的已经由集成者改掉(e59a093),这一件只管代码、测试、运维脚本和仓库检查,不改任何行为语义。
- 分支和工作树:
hygiene-2,目录circle-hub-hygiene-2(依赖已装好) - 可以改的路径:下面点名的文件、
.github/checks/**。别的路径不动。 - 规则:同前(不推送、不建 PR、不发布、不部署;不碰 7420、钥匙串、环境配置文件和任何真实系统,包括文档主机;测试只用合成数据;
git commit -s)。每条一个提交。 - 验证:
npx tsc --noEmit;node --test --test-concurrency=1对改过的测试和.github/checks/**。
要做的
hub/server/units.test.ts230 行一带:栈追踪样例里有一个真实的本机主目录路径,换成合成路径。测试照过。scripts/real/gold/regression-doc.test.ts(137、175、185 行一带):标成合成的样例里,有一段取自真实文档的产品命令。换成编造的命令,保持“中文后面紧跟命令”的写法,测试要测的情形不变。packs/workflow/traceability/functions/ids.test.ts22 行:全角写法的一个真实编号。换成同形的合成编号,同文件别处已经换成了合成值,照它们来。-
文档主机上的同步脚本不在本仓库
- 仓库检查加宽(
.github/checks/docs-rules.ts、docs.test.ts):- 本机绝对路径的检查,从 docs、根目录的 md 和 .github 扩到代码、测试、ops。除了 macOS 的用户主目录前缀,也查
/root/、/var/和/home/下的个人目录;测试里允许的合成路径写成规则里的明确例外。 - 新加一条:比合成线(10.6 以后)早的真实版本线,它们的构建名形状不能出现在仓库里,
foundation/和references/除外。形状是Rel_或Beta_,加名称族,加主版本 10、次版本小于 6 的下划线写法。 - 两条规则各有正例和反例的测试。
- 加完在整个仓库上跑一遍,把还剩的命中列给我;不在这一件里改。
- 本机绝对路径的检查,从 docs、根目录的 md 和 .github 扩到代码、测试、ops。除了 macOS 的用户主目录前缀,也查
- 只报不改:
packs/product/famx/README.md和product.json里有真实版本线,例如min_line的默认值、哪几条线有自己的命令树。这些是产品包的约定,要不要挪进部署数据由所有者定。把出现的位置列给我。 packs/workflow/case-review-report/pack.json的标题还写着“评审终稿(合成示例)”,可它已经是在用的包,用户在任务包列表里看到的就是这个标题。- 改成“评审终稿”,包版本加一个补丁号(1.4.2),README 同步;
- 其他包的标题和描述里有没有同样过时的“示例”“合成”字样,一并查一遍,列给我;
- 发布由集成者做。
完成后在终端里回报:提交号、测试数量、第 5 条跑出来还剩的命中、第 6 条的位置。
第三轮(集成者 10-23 晚加)
比合成线(10.6 以后)早的版本线,包外还有约 60 处:拿真实版本线当例子的测试和注释、生成的 schema 说明,加上百分数、耗时这类误报和规则文字本身。
- 换掉下面这些,
packs/product/famx/**和tests/fixtures/case-index/corpus.ts除外(它们跟 FAMX 的默认值绑着,归 famx-deployment-conventions 第二步):- 测试和注释里当例子的版本线换成 10.6 以后的合成线,测的情形不变;openkm 和手册库两份
webdav.ts照它们的一致性测试一起改; contracts/src/product.ts说明里的例子换掉,照生成器重新生成 schema;- 百分数、耗时、包版本号这类误报改写,例如让测试算出别的百分数;
- 文档里提到这个范围的规则文字改说法,不写出具体的数,例如“比合成线早的版本线”。
- 测试和注释里当例子的版本线换成 10.6 以后的合成线,测的情形不变;openkm 和手册库两份
- 删掉
ops/knowledge-sync/(决定 35 知识库第 10 项:它和 Hub 无关,从仓库里移出去;文档主机上不动)。 - 检查命令:
git grep -nE '(^|[^0-9.])10[._][0-5]([._][0-9]+)*([^0-9]|$)' -- . ':!foundation/**' ':!references/**' ':!package-lock.json' ':!packs/product/famx/**' ':!tests/fixtures/case-index/corpus.ts'结果为零,写进回报。全仓检查本身由 famx-deployment-conventions 第二步加。