# Aircontrol command witness and native comparison

The imported `surf_aircontrol_ksf` main course has a complete automated command witness from the shipped canonical spawn. It is a playability fixture, not a human leaderboard performance. The saved replay advances only through ordinary input commands and passes the server's strict `verifyReplay` checks.

## Sources and independent comparison

The BSP identity is SHA-1 `3c3b754ffb0f02b3d4a1506c8ffebdca5d18e902`. The public CSS 66t forward record is KSF's `replay_css_15_0_540902_1705101548.rec`, captured at [the public replay endpoint](https://ksf.surf/api/replays/replay_css_15_0_540902_1705101548.rec?game=66t). Its SHA-256 is `67d260c28d40c1cef166e9573011e49cf8a8571881f191c266a9d4b272b7b552`; the captured file has 114,448 bytes and 2,756 frames.

`tests/new-map-import.test.ts` reads this external binary directly and checks every next-frame movement through its finish bookmark: **2,534 comparisons pass a fixed 0.002-unit tolerance for both position and velocity**, including more than 100 surf contacts. The test reconstructs input from recorded button bits and the following sample's view angles, using the reviewed 10,000-unit component velocity cap. Contact and duck state are reconstructed because the recording does not include those flags. Each comparison starts from an independent recorded position and velocity; this test alone is not continuous traversal proof.

The separate canonical command replay supplies that continuous traversal proof. It uses the same public command sequence after a legal approach on the start deck, without position correction during the final run.

## Canonical approach and complete run

The recording begins airborne with downward velocity 288, so its first pose cannot be used as a stationary legal spawn and expected to follow the same trajectory. The planner instead waits for the browser spawn to land, walks on the start deck, uses small legal analog taps, and accelerates over three ground commands to join recorded frame 23.

At that join, position is exactly `(-2453.564453125,-9511.0087890625,14336.03125)` and velocity is exactly `(-37.67776870727539,-19.491683959960938,0)`. Both match the independent recording with zero error. The join occurs after 788 normal simulation ticks and before the timer starts. The native sample is an offline planning target; it is never assigned to the final session state.

The saved replay has 3,312 commands and finishes in **35.686688 seconds**. It has no reset, practice travel, or missed checkpoint. During the continuous portion, maximum position difference from the public native trajectory is 0.015163 units and maximum velocity difference is 0.003575 units. These accumulated continuous differences are separate from the stricter isolated next-frame tolerance.

| Event | Recorded frame at local crossing |
| --- | ---: |
| Start | 168 |
| Checkpoint 1 | 619 |
| Checkpoint 2 | 1075 |
| Checkpoint 3 | 1545 |
| Checkpoint 4 | 1903 |
| Checkpoint 5 | 2197 |
| Authored BSP finish | 2547 |

Start and all five checkpoint crossing frames match KSF's bookmarks. The BSP's authored `end_trigger` is reached **13 ticks after** KSF's finish bookmark at frame 2,534, a nominal 0.195 seconds at the recorded tick interval. KSF publishes a 35.488685-second record, whereas this browser fixture measures 35.686688 seconds; fractional timer placement also affects the difference. Private KSF finish-zone bounds are unavailable. The local finish is deliberately tied to the authored BSP trigger, and exact KSF timer parity is not claimed.

## Reproduction

Run `node --import tsx scripts/plan-aircontrol-witness.ts` to regenerate the command replay and report. Run `node --import tsx --test tests/new-map-import.test.ts` for the independent binary comparison and geometry/contact fixtures. Run `node --import tsx scripts/validate-new-maps.ts aircontrol` for full canonical replay verification and render-schedule determinism.

Artifacts:

- `public/replays/aircontrol-complete.json`: canonical initial state plus ordinary commands.
- `fixtures/aircontrol-canonical-witness-report.json`: exact join, source and geometry identity, route events, continuous deviations and server verification result.
- `fixtures/aircontrol-native.rec`: independent external native record.
- `fixtures/aircontrol-ksf-telemetry.json`: decoded source record for offline route planning.

The planner never changes the map geometry, movement rules, spawn, or server verifier to make the run succeed.