# 发布前工程审计

审计日期：2026-11-21。该记录描述本地门禁，不将本地测试冒充远端 CI、发布或赛事验收。远端交付结果须以对应 SHA 的公开 CI、Release 和精确版本消费者核验为准。

## 代码计量

命令：`python tools/audit.py`。只统计根目录生产 `.mbt`，排除 `_test.mbt`、`_wbtest.mbt`、生成接口、tools 中生成 runner、examples、tests、文档、配置及第三方代码。物理行含空行；手工检查无注释墙、重复块、空函数、不可达填充和薄入口。总计2617行；进一步排除模型/配置/字形表 model.mbt、options.mbt、glyphs.mbt 后为2323行；不以静态类型或字形条目补足1500行。

|生产文件|物理行|非空非注释行|
|---|---:|---:|
|arguments.mbt|76|68|
|boundaries.mbt|55|52|
|font_macros.mbt|62|61|
|glyphs.mbt|77|73|
|inline.mbt|220|207|
|inspection.mbt|194|171|
|layout_macros.mbt|116|111|
|links.mbt|99|93|
|literal_macros.mbt|52|49|
|markdown.mbt|172|161|
|model.mbt|166|99|
|navigation.mbt|89|76|
|options.mbt|51|41|
|parser.mbt|405|378|
|plain.mbt|125|116|
|render.mbt|244|220|
|scanner.mbt|113|94|
|statistics.mbt|97|88|
|synopsis_macros.mbt|56|55|
|validation.mbt|148|142|

## 有效提交审查

下列23个非空提交逐项核对修改路径与保留到最终实现的行为。前22个计入保守有效数22；CI提交保留但在远端真实运行前不计入该保守下限。后续文档或发布修复也不用于满足20个最低要求。未按空提交、格式化、占位或重复微修补凑数。表中主题说明独立工程目的，路径来自实际 Git diff；验证采用相应命名测试、示例或参考对照在最终树的复验，并不声称逐个历史快照都有四后端 CI。

|SHA|目的/保留结果|实际路径|
|---|---|---|
|fbc0b583635885d2e41411b32098e3c52f90427e|feat(model): define located manual AST and resource contracts|.gitattributes, .gitignore, model.mbt, model_wbtest.mbt, moon.mod, moon.pkg, options.mbt, pkg.generated.mbti|
|09433c3f919e573d92456994a418ac8e15aab8e1|feat(scanner): bound source scanning and preserve request spans|pkg.generated.mbti, scanner.mbt, scanner_wbtest.mbt|
|27a4ad2b2864627f908ba9c46edaf7fc46d4bab0|feat(lexer): interpret quoted man macro arguments and comments|arguments.mbt, arguments_wbtest.mbt, pkg.generated.mbti|
|03c761b3b2d23a3536026743efdac7b61a65b219|feat(inline): decode font state and safe roff escapes|inline.mbt, inline_wbtest.mbt, pkg.generated.mbti|
|e75277e65dc2be4ea1b6b717d9759d5c1d3d2632|feat(escapes): resolve named glyphs and validate Unicode scalars|glyphs.mbt, glyphs_wbtest.mbt, inline.mbt|
|e7067a63e85a050ff8c4605296fd5dae46e759d6|feat(parser): build semantic metadata sections and paragraphs|parser.mbt, parser_wbtest.mbt, pkg.generated.mbti|
|1869164848b19638f7dfff6e930f87260f21c750|feat(macros): support alternating fonts and next-line styles|font_macros.mbt, font_macros_wbtest.mbt, parser.mbt|
|19060280aeb5bf80bacf653a3d61778b8604cf1d|feat(layout): associate tagged definitions and bounded indentation|layout_macros.mbt, layout_wbtest.mbt, model.mbt, parser.mbt, pkg.generated.mbti|
|ccd22a799a6bb614b3d12c2cbb545051169849f1|feat(literals): preserve examples no-fill text and blank lines|literal_macros.mbt, literal_wbtest.mbt, parser.mbt|
|307a0b66d0c815ba5cf8c54b9d29fc3856195027|feat(links): retain URI and mail labels with safe emission policy|links.mbt, links_wbtest.mbt, parser.mbt, pkg.generated.mbti|
|3b0ba2291ec1a22919054ab53bc3e3e0d4286b5c|feat(synopsis): model command names and optional arguments|parser.mbt, synopsis_macros.mbt, synopsis_wbtest.mbt|
|01dd139f54cabe62c8ce432ab41039e278b91d5e|feat(navigation): generate collision-free outlines and section slices|navigation.mbt, navigation_wbtest.mbt, pkg.generated.mbti|
|22b349d24d90d57cbc5f1bf1ec20872c2cd3c7a4|feat(inspection): inventory manual references links and editorial issues|inspection.mbt, inspection_wbtest.mbt, pkg.generated.mbti|
|58c089d96594a01c7f313b81076cfeab4303f180|feat(validation): reject malformed external ASTs and oversized text|pkg.generated.mbti, validation.mbt, validation_wbtest.mbt|
|45edf08114a0ba9ae21d08ed0df1a86e988a532a|feat(html): render semantic manuals with bounded escaped output|html_wbtest.mbt, pkg.generated.mbti, render.mbt|
|abafc4f4a92a7c8c290788652dea3007248d8068|feat(plain): wrap semantic blocks with bounded literal and margin output|pkg.generated.mbti, plain.mbt, plain_wbtest.mbt|
|cbc59be5ec0fa8784dca549687505a16bc016751|feat(markdown): escape prose links and collision-safe literal fences|markdown.mbt, markdown_wbtest.mbt, pkg.generated.mbti|
|4acb203ecbe58c7b3dea72286d34ee6e28ca6797|fix(parser): recover interrupted macros and preserve styled literal lines|boundaries.mbt, boundaries_wbtest.mbt, font_macros.mbt, parser.mbt|
|f45d6605ab104f9ed691329250944bc734f667a7|test(security): exercise malformed macro combinations and independent limits|robustness_wbtest.mbt|
|1d059831f9f1fc2bbd614a6eef939f27d6a0b75f|feat(examples): integrate manual preview publishing and untrusted input audits|examples/audit/main.mbt, examples/audit/moon.pkg, examples/audit/pkg.generated.mbti, examples/data/manual.mbt, examples/data/moon.pkg, examples/data/pkg.generated.mbti, examples/preview/main.mbt, examples/preview/moon.pkg, examples/preview/pkg.generated.mbti, examples/publish/main.mbt, examples/publish/moon.pkg, examples/publish/pkg.generated.mbti|
|00f5122acdd86f6be6041ccb151d642940c57ad2|test(groff): compare seven original manuals against independent GNU formatter|tests/fixtures/alternating.man, tests/fixtures/escapes.man, tests/fixtures/layout.man, tests/fixtures/nested.man, tests/fixtures/paragraphs.man, tests/fixtures/styles.man, tests/fixtures/synopsis.man, tools/groff_oracle.py, tools/oracle/main.mbt, tools/oracle/moon.pkg, tools/oracle/pkg.generated.mbti|
|e4e183ab9bac394fd9738f653218e7ae3e0545d0|feat(statistics): measure visible content structure links and diagnostics|pkg.generated.mbti, statistics.mbt, statistics_wbtest.mbt|
|a95472acfe25ca2ed5e07a3a3bcf1e1403a1cdea|ci: pin official compiler and verify four backends plus groff workflows|.github/workflows/ci.yml|

## 验证证据

- 固定编译器：moonc v0.10.18+6c83a7f62 (2026-10-28)，官方 Windows 与 Linux 包；CI URL 经 HTTP200 验证。
- Windows wasm-gc/wasm/js：每个目标 check/build/test --deny-warn 通过，43/43命名测试；每个目标运行 examples/preview、publish、audit 通过。
- 现有 WSL Ubuntu Linux native：同版本官方 Linux 编译器/core，check/build/test --deny-warn 通过，43/43；三个示例通过。Windows native 因缺少 MSVC/SDK 不宣称通过。
- 300组异常宏组合是单个命名测试的内部输入循环，不另冒充300项独立测试。验证确定性、可渲染及危险标签/协议不发射。
- GNU groff1.23.0独立对照7份原创夹具全部通过；按正文有序单词比较，忽略布局和标点；不声明完整 man 兼容率。
- moon info、moon fmt --check通过；公开接口复核：所有对外结构可构造、明确 Result/Option、无外部 I/O 或用户宏执行入口。错误与降级见 README 和 docs/semantics.md。
- 本次未运行性能基准、覆盖率统计或自然语言分词质量评测。

隐私门禁另运行 Skill 的 check_release_privacy.py，涵盖工作树、所有可达 Git 历史和实际发布ZIP；本公开审计不包含私人材料或机器身份凭据。
