Planning documents
Save editable intent, derive a route and publish accepted calculations with map ownership.
| Contract card | Current state |
|---|---|
| Owner | Planning + PlanningNative |
| Version boundary | Intent 1.0; result, snapshot, draw and edit 1.1 |
| Current consumers | Rust CLI / C ABI producer; Swift coordinator; independent Python readers |
| Source | modules/planning/schema/v1_1/README.md |
| Validator / acceptance entry | modules/planning/schema/v1_1/check.sh |
| Fixtures / specimen | modules/planning/examples/document-lifecycle/request.json |
Adopt this model
Validate drafts before taking ownership. Capture resource identities, negotiate planning-v1.1, and admit a matched snapshot/draw pair.
Identity, units and meaning
Document, commit, stop, leg and element occurrence IDs have different lifetimes. WGS84 coordinates; explicit scientific and display altitude datums.
Failure and partial states
A structurally valid draft may be incomplete. A usable path can have unavailable evaluation. Reject stale captures and unsupported versions.
Continue to the guide · Model conventions · Release notes
Source paths identify owners in the source checkout; they are not public repository links. A listed test is an acceptance entry, not a claim that every consumer has passed a shared corpus.