# Southwest R06 geometry handoff

**TEST ONLY. Ready for isolated local import and review. No regional placement or construction approval.**

This package turns the R03 first 5% connection experiment into explicit metric
geometry. It carries the ten R05 road traces in their original pixels and the
native historical Crown Key layouts as separate, unscaled context. It does not
choose a real W1/W2 connection, island size, coastline, shared water datum,
building parcel or accepted world transform. District 3 construction stays paused.

## Start

Read `AI_START_HERE.md`. `GEOMETRY_HANDOFF.json` is authoritative for this package.
`CONNECTION_SPEC.json` records the reconciled specimen basis; `GENERATOR_CHOICES.json`
records display closure and sampling choices. `SCHEMA.json` describes the structure;
the repository validator also enforces geometry, source and scope invariants.

## What is built

- Road: 1,020 m analytic profile plus two 100 m flat extensions; total 1,220 m plan run.
- West/east approaches: 460 m each, comprising 60 m entry transition, 340 m at 5%,
  and 60 m exit transition. Land top +2 m, bridge top +22 m, underside +20 m.
- Synthetic 100 m opening, high study water 0 m. The bare 20 m air gap has no extra
  engineering margin and is not vessel, waterbed or navigability acceptance.
- Two pedestrian folds: 8 runs each, 3 m clear width, 1 m gaps, 32 flights and
  24 rests per end, 7 level semicircular turns, 20 m rise. Reservation 63.4 × 31 m.
- Each fold is exactly 487.1822971502571 m in horizontal analytic centreline length,
  487.6819850402728 m in 3D. Sampled arcs are shorter and reported separately.
- Flat lower/upper connectors and upper crossing make a complete proposed walk route.
  Their endpoints use XYZ portals; an XY overlap never creates a graph connection.
- Two flat synthetic land patches. These are display volumes; no actual coastline,
  piers, foundations, rails, drains, road lanes, traffic design or structural support.

## Three independent coordinate layers

| Frame | Units / axes | Meaning |
|---|---|---|
| MASTER-PIXELS-20261010 | pixels, X right, Y down | Original concept master. No metric transform. |
| SW-CK-AUTHORING-R03 | metres, RH, X east, Y north, Z up | Historical native layouts re-expressed only as `(x-500,500-y)`; scale 1 per revision. |
| SW-R06-SPECIMEN-LOCAL-M | metres, RH, X east, Y north, Z up | Synthetic connection. Parent/world placement unresolved. |

Do not overlay these layers as if registered. Grid north is not geographic north.
Historical v01 and v02 remain separate alternatives and must not be rescaled to fit
one another. Footprints/heights are historical proxies, not selected shells or
current engine evidence. The 21 target records have no metric placements and are
not an order for 21 additive buildings.

## Files and previews

`SPECIMEN_AUTHORING.obj` / `.mtl` use original right-handed metre coordinates.
OBJ has no reliable embedded unit contract: use the JSON and axis controls.
The Blender script imports only test meshes; it never places historical buildings
or image traces. `clean-plan.svg`, `labelled-plan.svg`, `profile.svg`,
`switchback-detail.svg`, `isometric.svg`, `source-topology.svg` and
`historical-context.svg` are deterministic vectors made from the same JSON;
the isometric SVG embeds a depth-buffered orthographic mesh raster.
They are analytic package previews, not regional aerials or Unreal captures.
Existing R05 regional same-model capture count remains zero.

## Build and verify in the repository

```bash
python tools/sw_geometry/build.py
python tools/sw_geometry/build.py --check
python tools/sw_geometry/validate.py
python -m unittest discover -s tools/sw_geometry -p 'test_*.py'
```

Only the Python standard library is needed for build/validation. Blender is optional
and unavailable in the generating environment. The complete repository and its
pinned/new R06 sources are needed to rebuild; the portable package supports importer
preflight without the repository. All paths are relative and all source/artifact
bytes are hashed. The ZIP has fixed timestamps and deterministic member order.

## Validation scope

The report covers finite coordinates, unique IDs, ring topology, closed mesh edge
incidence/winding, analytic profile points, sampled maximum grades, exact seams,
air-clearance arithmetic, fold structure/length, native-scale preservation, source
hashes, absence of accepted placement and axis round trips. It is not a physical
collision sweep, Blender/Unreal execution, engineering review or accessibility
standard check. Construction, engine integration, streaming and server capacity
remain unverified.
