INF-01: gen-* scripts + appendix + CI wiring (7-check style guard) - #18
Merged
Conversation
- 6 gen-* scripts (A/B/C/D/E/F) + 2 lint checks (check-source-commits, lint-no-fuzzy-quantifiers) - 6 appendix .md + .manifest.json generated - scripts/orphan-allowlist.txt for §6.2 expected-uncovered top dirs - CI: wire pnpm gen:appendix + pnpm check:docs into v2-style-guard.yml (7 checks: C-1/C-2/C-3/C-4 + check-source-commits + lint-no-fuzzy-quantifiers + gen-module-matrix --check-orphans) Co-authored-by: multica-agent <github@multica.ai>
- _lib.ts: remove generated_at field + nowIso(); add line-range helpers - gen-tool-table.ts: source_files use path:line-line (primary source + tools.ts anchors) - gen-agents-table.ts: rewrite per §7.5 two-segment (id/displayName/modelHint/defaultEnabled + feature_flags/entrypoint_gated/coordinator_required); resolve constant-ref agentType - gen-commands/tasktypes/module/hooks: drop generated_at from manifest + md header - regenerate all appendix outputs (deterministic, no timestamps) Co-authored-by: multica-agent <github@multica.ai>
…ailability gen:appendix and check:orphans both call getSourceCommit() which git -C into CLAUDE_CODE_SOURCE_PATH (default ~/work/code/awesome-project/claude-code-cli). That path only exists on author machines, so PR #18 failed on hosted runners with 'cannot change to /home/runner/work/code/awesome-project/claude-code-cli'. docs/appendix/ is the truth-of-record (committed manifests + .md). On runners without the source checkout, skip the regen / drift / orphan steps and emit a notice. C-1..C-4 + check:source-commits + check:no-fuzzy keep running and still gate every PR. Co-authored-by: multica-agent <github@multica.ai>
新增第 7 条（实为 check:docs 链路第 8 项，含 gen:appendix drift）lint，
防止内部修订代号 v1/v2 渗入读者侧 docs/ 正文。
- scripts/lint-no-revision-codenames.ts：扫 docs/**/*.md，按 frontmatter /
HTML 注释 / fence / V2-REVISION-SPEC.md 整体豁免；剔除 API 版本号形态
(api/v1/...、v2.1.8) 与 allowlist 行；其余命中 fail。
- scripts/revision-codename-allowlist.txt：白名单（path:line | path:regex:<re>）。
现存 2 条合理引用先入白名单：
* docs/appendix/F.md:42 —— 章名「架构模式总结 v2」（spec §5/§6.2）
* docs/20-API调用与错误恢复.md:619 —— 源码注释复述 v2.1.8 semver
- package.json: 增 check:no-revision-codenames，串入 check:docs 链路。
- .github/workflows/v2-style-guard.yml: 在 lint-no-fuzzy 之后新增一步。
首跑：33 md OK，0 命中。
Co-authored-by: multica-agent <github@multica.ai>
C34 chapter title contained 'v2' which leaked into docs/appendix/F.md via the generator and was being papered over by the allowlist. Rename title in scripts/gen-module-matrix.ts:117, regenerate F.md + manifest, and drop the stale allowlist entry. check:no-revision-codenames and check:docs both pass. Co-authored-by: multica-agent <github@multica.ai>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
INF-01 收尾
范围
基础设施工单：脚本 + 附录 + CI 接线，无正文章节改动。
改动
gen-tool-table/gen-commands-table/gen-hooks-table/gen-agents-table/gen-tasktypes-table/gen-module-matrixcheck-source-commits、lint-no-fuzzy-quantifiersdocs/appendix/{A..F}.md+{A..F}.manifest.jsonscripts/orphan-allowlist.txt（覆盖 §6.2 预期免覆盖目录）.github/workflows/v2-style-guard.yml增加gen:appendix（含漂移检查）+check:source-commits+lint-no-fuzzy-quantifiers+gen-module-matrix --check-orphansCI 7 项校验（与 spec §5 对齐）
附录生成 + 漂移检测作为独立步骤插在 C-4 之后、check-* 之前。
manifest 摘要
风格双亲（spec §5 R-1）
N/A · 基础设施
验证
bun run gen:appendix✅ 无漂移package.jsonscripts 对齐