Skip to main content

Planning documents

contractAudited 2026-11-21

Save editable intent, derive a route and publish accepted calculations with map ownership.

Contract cardCurrent state
OwnerPlanning + PlanningNative
Version boundaryIntent 1.0; result, snapshot, draw and edit 1.1
Current consumersRust CLI / C ABI producer; Swift coordinator; independent Python readers
Sourcemodules/planning/schema/v1_1/README.md
Validator / acceptance entrymodules/planning/schema/v1_1/check.sh
Fixtures / specimenmodules/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.