任务:终审查出的真实值,和仓库检查加宽

依据: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/**。

要做的

  1. hub/server/units.test.ts 230 行一带:栈追踪样例里有一个真实的本机主目录路径,换成合成路径。测试照过。
  2. scripts/real/gold/regression-doc.test.ts(137、175、185 行一带):标成合成的样例里,有一段取自真实文档的产品命令。换成编造的命令,保持“中文后面紧跟命令”的写法,测试要测的情形不变。
  3. packs/workflow/traceability/functions/ids.test.ts 22 行:全角写法的一个真实编号。换成同形的合成编号,同文件别处已经换成了合成值,照它们来。
  4. 文档主机上的同步脚本不在本仓库

  5. 仓库检查加宽(.github/checks/docs-rules.ts、docs.test.ts):
    • 本机绝对路径的检查,从 docs、根目录的 md 和 .github 扩到代码、测试、ops。除了 macOS 的用户主目录前缀,也查 /root/、/var/ 和 /home/ 下的个人目录;测试里允许的合成路径写成规则里的明确例外。
    • 新加一条:比合成线(10.6 以后)早的真实版本线,它们的构建名形状不能出现在仓库里,foundation/ 和 references/ 除外。形状是 Rel_ 或 Beta_,加名称族,加主版本 10、次版本小于 6 的下划线写法。
    • 两条规则各有正例和反例的测试。
    • 加完在整个仓库上跑一遍,把还剩的命中列给我;不在这一件里改。
  6. 只报不改:packs/product/famx/README.md 和 product.json 里有真实版本线,例如 min_line 的默认值、哪几条线有自己的命令树。这些是产品包的约定,要不要挪进部署数据由所有者定。把出现的位置列给我。
  7. packs/workflow/case-review-report/pack.json 的标题还写着“评审终稿(合成示例)”,可它已经是在用的包,用户在任务包列表里看到的就是这个标题。
    • 改成“评审终稿”,包版本加一个补丁号(1.4.2),README 同步;
    • 其他包的标题和描述里有没有同样过时的“示例”“合成”字样,一并查一遍,列给我;
    • 发布由集成者做。

完成后在终端里回报:提交号、测试数量、第 5 条跑出来还剩的命中、第 6 条的位置。

第三轮(集成者 10-23 晚加)

比合成线(10.6 以后)早的版本线,包外还有约 60 处:拿真实版本线当例子的测试和注释、生成的 schema 说明,加上百分数、耗时这类误报和规则文字本身。

  1. 换掉下面这些,packs/product/famx/** 和 tests/fixtures/case-index/corpus.ts 除外(它们跟 FAMX 的默认值绑着,归 famx-deployment-conventions 第二步):
    • 测试和注释里当例子的版本线换成 10.6 以后的合成线,测的情形不变;openkm 和手册库两份 webdav.ts 照它们的一致性测试一起改;
    • contracts/src/product.ts 说明里的例子换掉,照生成器重新生成 schema;
    • 百分数、耗时、包版本号这类误报改写,例如让测试算出别的百分数;
    • 文档里提到这个范围的规则文字改说法,不写出具体的数,例如“比合成线早的版本线”。
  2. 删掉 ops/knowledge-sync/(决定 35 知识库第 10 项:它和 Hub 无关,从仓库里移出去;文档主机上不动)。
  3. 检查命令: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 第二步加。