Waypoint→HexCell migration: restore schema ≡ code, empty the adherence DRIFT map

[IanMayo]

Closes the schema↔code drift that the ADR-0029 adherence guard surfaced (now merged to main via #13). The LinkML schema still modelled several persisted shapes as the square-grid Waypoint{x,y}, even though the app went hex (H3) at ADR-0016. This repoints them at the existing HexCell and fixes two non-hex drifts, so the schema describes the real runtime shapes (DEC-57's "schema ≡ code").

What changed (schema source → regenerated)

Shape	Was	Now
Asset.position, Constraint.cells	Waypoint{x,y}	HexCell {h3,lat?,lng?}
StartState, TrajectoryPoint	{x,y,…}	rebuilt on h3 (+lat/lng)
TideDecision	—	+rv_min (chosen route's RV arrival)
Stamp.appetites	Appetite[]	axis→setting map

The appetites call is the interesting one: Appetite.axis is made the LinkML identifier and Stamp.appetites inlined (not inlined_as_list), so gen-json-schema emits the compact-dict form that validates {tempo:'balanced', exposure:'balanced'} directly. This matches the runtime map without changing the kernel — chosen deliberately over emitting Appetite[], which would have altered the Stamp's canonical bytes and moved every golden plan id (NF3).

Payoff

• Deletes the documented interim cast — main.js's SteeringDelta write no longer casts hex cells as unknown as Waypoint[] (bugs.md); they're HexCells now.
• The adherence test drops its DRIFT/strip machinery and validates the ORBAT + Plan instances whole. The undeclared-field assertion still proves it catches new drift.

Verification

• ✅ Regenerate is idempotent + byte-reproducible (the regen-no-diff check passes).
• ✅ 32 unit tests green (adherence now strict, nothing stripped).
• ✅ Golden plan ids unchanged — the schema is validation-only; it never touches the runtime canonical form, so NF3 holds.
• ✅ 0 typecheck errors (the removed cast was the only app coupling).

Waypoint itself is retained (still the generic grid-location type) but is no longer referenced by these persisted shapes. Out of scope (unchanged): the broader "app imports the generated TS" migration (ADR-0012, its own spec).

Recorded as ADR-0030; bugs.md drift entries marked resolved; prose spine §6, key_facts.md + work-log updated.

https://claude.ai/code/session_01EhtBoKXg6bHnKdquacyknf

---

Generated by Claude Code

[github-actions]

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-06-16 20:37 UTC