osmWorkflow/.trellis/spec/pipeline/native-road-package.md

Native Road Compiler Contract

The native-road package is maintained in the private road-compiler repository:

https://git.app.que01.top/que01/road-compiler

This host consumes the exact git tag recorded in package.json and lockfile. The host owns area configuration normalization and writes RoadCompilerInput; the compiler owns the native-road-package/v1 file contract and CLI. Production code must invoke the installed compiler CLI through scripts/lib/road-compiler-cli.js, not import compiler source files or read packages/road-compiler.

The completion marker is NATIVE_ROAD_COMPILE_DONE <json>. build-area.js validates the marker's count, JSON payload, area id, output path, process status, and signal before starting Blender.