OSM area preflight design

Boundaries

scripts/lib/area-diagnostics.js 保持 OSM 解析和预检分类的唯一事实源。新增 scripts/preflight-area.js 只负责 CLI 参数、报告和退出码；它不读取产物，也不调起外部工具。现有 diagnose-area.js、check-area.js 不复制预检逻辑。

Data Flow

area config + OSM XML
        -> analyzeOsmPreflight()/shared parseOsm()
        -> { summary, errors, warnings }
        -> preflight-area CLI report + exit code
        -> successful preflight.manifest.json
        -> diagnose/check manifest freshness reporting

预检 manifest 是一次成功验证的记录，不是输入所有权或构建依赖。它记录 config/OSM 文件摘要、错误/警告、统计和耗时；预检失败时不写入，也不删除旧 manifest，以保留最后一次成功记录。

Classification

Blocking error 仅限肯定会使场景几何或范围不可靠的 OSM 结构错误：无效 bounds、任意 way 的缺失 node 引用、破损的建筑 way / building multipolygon。没有 height / levels 不是错误（渲染已有默认值）；填写但不可解析的显式 height 是错误。building:levels 的非正值或不可解析值将作为 warning，除非现有 Blender 行为表明它会产生错误几何。

Compatibility

现有 diagnose:area 保持全量只读报告；它添加 preflight manifest 一行。check:area 仅在 manifest 存在时才要求其有效和 fresh，确保现有历史构建仍可通过。新命令的默认配置规则与其他 area CLI 一致。

Rollback

删除 preflight:area CLI、预检 manifest 定义和 diagnostics 展示即可回到当前行为。预检 manifest 是可再生文件，保留或删除均不影响构建。

1.7 KiB Raw Blame History Unescape Escape