# Southwest R07 proposed regional foundation

One complete authored metre hypothesis for isolated review: five land bodies,
actual land-subtracted water, roads and junction cores, W1/W2/E1, pedestrian
folds, 18 parcel reservations, 19 programmes and 21 view identities.

**PROPOSED / TEST ONLY. No regional acceptance or current-world integration.**
Actual engine import, collision, driving, walking, vessel use, accessibility,
structure, drainage, streaming and current-asset placement are `not_tested`.
District 3 construction remains paused.

Start with [AI_START_HERE.md](AI_START_HERE.md), the human
[DESIGN_REVIEW.md](DESIGN_REVIEW.md), and [REVIEW_GATES.json](REVIEW_GATES.json).
The controlling design is [FOUNDATION_CANDIDATE_CONTRACT.json](FOUNDATION_CANDIDATE_CONTRACT.json).
[DESIGN_CALCULATIONS.json](DESIGN_CALCULATIONS.json) distinguishes analytic lengths
from sampled paths. [REGIONAL_GEOMETRY.json](REGIONAL_GEOMETRY.json) contains the
actual physical meshes and logical routes. Its two partition records use required
checksum-bound sibling references to [SURFACE_PARTITIONS.json](SURFACE_PARTITIONS.json).
Keep both files together; the ZIP includes both. Reading the single canonical
JSON requires resolving its two checked references before using partition data.
[REGION_FORMAT.schema.json](REGION_FORMAT.schema.json)
describes format1.1.0; `region_io.load_region(package_directory)` resolves both
references without changing any numeric value. Partition data was externalized
only to fit the publication request limit; no geometry was rounded or simplified. [SOURCE_CONTEXT.json](SOURCE_CONTEXT.json)
contains unchanged source-pixel and historical geometry, always nonphysical.

## Portable verification and isolated import

```sh
python verify_package.py
python import_blender.py --validate-only
blender --factory-startup --python import_blender.py -- --package /absolute/path/SW-R07-FOUNDATION --include-reservations --include-cameras
# In the interactive app, use Save As with a NEW isolated .blend filename.
# Or save a new copy from a background run:
blender --factory-startup --background --python import_blender.py -- --package /absolute/path/SW-R07-FOUNDATION --include-reservations --include-cameras --save-blend /absolute/existing/directory/sw-r07-review.blend
```

Run these commands from the extracted package directory. The interactive command
keeps the app open; save the isolated scene before closing it. Background mode
requires `--save-blend NEW_PATH` to retain the result. It refuses an existing
output before scene mutation, saves a copy to a temporary sibling directory,
then atomically publishes a new file without overwriting any existing path.

Use a fresh scene whose `unit_settings.scale_length` is exactly 1 (one metre
per Blender unit). The importer checks this before creating anything, keeps raw
metre vertices and identity object scales, and creates only the isolated
`PROPOSED_SW_R07_DO_NOT_MERGE` collection. It does not modify scene units or the
current world. `--include-reservations` adds nonphysical parcel review curves.
`--include-cameras` creates the four saved orthographic cameras without changing
the active scene camera or render settings. Set each recorded required render
width/height and square pixels when capturing; the SVG header/footer is outside
the camera viewport. The W1 section SVG is an analytical triangle-plane slice
atY250; its imported camera alone projects the full scene. Reproducing the cut
requires an explicit review cut/view layer, not an automatic Boolean or scene
mutation by this importer. `--include-native-comparison` adds separate historical comparison outlines;
source pixels are never inserted into the metre scene. Importer rollback removes
new data on failure. No actual Blender run is claimed by these Python checks.

OBJ/MTL are optional exchange files using the same RH metre vertices. The JSON
is canonical; OBJ names/materials do not encode the full graph or review states.

## Representation

Land closes at -8m as a modeling convention, not bathymetry. Basal volumes end
at1.8m; disjoint closed caps1.8..2m are carved around actual flat paving.
Pavement replaces those cap tops. Water is the exact domain minus all five
land rings, represented by closed display prisms -0.2..0m. This is a compound
planning assembly with buried contact faces, not a production Boolean regional
solid. No automatic game collision is configured. Junction cores and cutbacks
avoid duplicate coplanar road tops. Shared pedestrian carrier bands reuse W1.
The upper walking connectors stop at the W1 north carrier edge with complete
3m chords. No separate upper pedestrian slab intersects the carrier volume.
Elevated walking slabs over water retain at least20m soffit.

Native Crown coast keeps scale1; its proposed translation is recorded. Eight
historical footprint proxies overlap actual candidate paving in plan. See
NATIVE_PROXY_IMPACTS.json; these are historical comparison conflicts, not an
assertion about current-engine actors. Southern-island access remains boat-only
plus an independent path; it has no road bridge.

## Rebuild in the repository

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

SOURCE_MANIFEST.json pins actual source bytes and tool hashes. ARTIFACT_MANIFEST.json
pins every portable file except itself and the containing deterministic ZIP.
The build is standard-library Python and has no temporary snapshot dependency.
Return actual evidence in QUIK_RETURN_TEMPLATE.json. All initial states are
`not_tested`; review controls before choosing any world rotation/translation.


## Current marina-water amendment
The marked marina is now cut out of LAND-WEST and its water exclusion. Five pedestrian nodes follow the north/east quay; vehicle roads and parcels are unchanged. Baseline notes above are historical where their coastline differs. Exact shore shape and docks remain proposed; no native/world acceptance.
