ReviewOS

also looking at this

stacks/drone

feat: add retained cargo fleet cancellation and recovery

#105
Merged chris wants to merge codex/cargo-fleet-operator-recovery into main
32 files +2496 -27
docs/api.mdmodified+16-0
Changes to docs/api.md
@@ -62,6 +62,22 @@ provides the separate [point-load intake prerequisite](cargo-delivery.md#point-l
6262It integrates real modeled mass/CG changes after one coincident inelastic point capture.
6363The caller still owns the parcel, finite station handling and captured fleet custody protocol.
6464
65`createCargoStationHandler(declaration)` in `cargo/station.ts` owns one existing point
66through ballistic capture, finite rail transport, cancellation braking and a single
67departure. See the [station model and integration limits](cargo-station.md). It does not
68grant vehicle authority or confirm custody.
69
70`simulateCargoFleet({ scenario? })` and `cargoFleetSummary(run)` in `cargo/fleet.ts`
71execute [two-carrier handover](cargo-fleet.md) through actual retained source and receiver
72runtimes, a consumed station parcel, current-authority intake and captured custody. The
73eleven bounded fault cases retain incomplete outcomes and actual mass separately from receipts.
74`createCargoFleetSession()` exposes exact-epoch `step`, detached `snapshot`/terminal `result`,
75scoped `decide` and idempotent `close`, with the exported `CargoFleetOperatorDecision` type.
76`simulateCargoFleetControl({ case? })` in `cargo/fleet-control.ts` supports four explicit
77transport cancellation/recovery cases. The [operator contract](cargo-fleet.md#retained-world-and-explicit-transport-decisions)
78retains current authority, a single physical point, original receive deadlines and
79attempted-intake uncertainty. It does not restore a failed vehicle session.
80
6581## Target sources
6682
6783`createGpsTargetSource({ targetId, origin, maxSpeedMps?, now? })` converts trusted phone or GNSS fixes