6fffd19043
The real-map scout (ledger #6), A's half. Scope fence held: NO new plan features, NO golden moved (classic 0x3fa36874, gig 0xb1d48ea1, all three osm fixtures frozen). The scout proves the EXISTING ?plansrc=osm contract eats real geography. - The town-cache contract (published FIRST — E builds build_towns.py to it). plan_osm.js gains validateTownCache() (authoritative {ok,errors,warnings}), registerTownCache(), a generatePlanOSM(.., {cache}) seam, and TOWN_CACHE_SCHEMA/MIN_TOWN_SHOPS(6)/MAX_TOWN_SPAN_M(5km). Shape: {schema,key,town, source,license,attribution,center{lat,lon},shops[{id,name,type,lat,lon,suburb?}]}. Home declared: web/assets/towns/<key>.json (+ README.md full spec). Documented in CITY_SPEC v3.2 + LANE_A_NOTES R17. - plan_osm hardened: blank name -> registry label; the validator gates finite center/coords + a >=6-shop floor and warns on unknown-type(->opshop)/dup-id/span>5km. Proven vs thriftgod's real 2,828-shop city_source.json: boots a valid plan, 0 bad coords, 0 'undefined' names. - selfcheck: a committed synthetic-adversarial contract suite (valid-messy caches boot + pass structural/ gig; invalid reject; wide-spread warns; registry seam) + an auto-loader for web/assets/towns/*.json (validate -> suites -> pin per-town golden), empty and green until E lands caches. ALL GREEN 15277/15277. - v4 charter risk list (LANE_A_NOTES R17): the MEGA-STRIP (unbounded bbox -> 11.6 km strip; town selection is E's real lever, warned >5km); sparse compact towns (2 km inner-Canberra held 6 shops); osm facades clear (rows 54 m apart) so R16's bias is a no-op on real towns. E->A handshake: E drops a cache in web/assets/towns/, the selfcheck prints its golden, I pin it. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
57 lines
3.1 KiB
Markdown
57 lines
3.1 KiB
Markdown
# Real town caches — the home (`web/assets/towns/`)
|
|
|
|
**Lane A owns the contract; Lane E fills this directory** (ROUND17 ledger #6, the real-map scout).
|
|
|
|
Each real Australian town is one file, `<key>.json`, in the **town-cache contract** shape — the processed
|
|
output of `pipeline/build_towns.py` (Overpass → dedupe/suburb/parody-name/seeded-hours). `plan_osm.js`
|
|
marches it exactly like the checked-in fixtures in `web/js/citygen/osm_fixture.js`; the scout proves the
|
|
**existing** CityPlan contract eats real data — no new plan fields, no new geometry.
|
|
|
|
## The contract (authoritative: `validateTownCache()` in `web/js/citygen/plan_osm.js`)
|
|
|
|
```jsonc
|
|
{
|
|
"schema": "procity-town-cache/1",
|
|
"key": "katoomba_real", // matches the filename; distinct from the hand-made fixture key
|
|
"town": "Katoomba", // display name
|
|
"source": "osm",
|
|
"license": "ODbL 1.0", // REQUIRED — OSM is ODbL
|
|
"attribution": "© OpenStreetMap contributors",
|
|
"generator": "pipeline/build_towns.py", // optional provenance
|
|
"fetchedAt": "2026-07-16", // optional
|
|
"center": { "lat": -33.71, "lon": 150.31 },// REQUIRED — the equirectangular projection origin
|
|
"bbox": { "minLat": …, "minLon": …, "maxLat": …, "maxLon": … }, // optional metadata
|
|
"counts": { "raw": 512, "shops": 96 }, // optional metadata
|
|
"shops": [
|
|
{ "id": 318855426, "name": "Canty's Bookshop", "type": "book", "lat": -35.32, "lon": 149.18, "suburb": "Fyshwick" }
|
|
// …
|
|
]
|
|
}
|
|
```
|
|
|
|
**Hard requirements** (else the cache is rejected and does not boot):
|
|
- `center.{lat,lon}` finite numbers.
|
|
- `shops` an array of **≥ `MIN_TOWN_SHOPS` (6)** entries (up to 4 venues + the one openLate landmark + a spare).
|
|
- every shop has finite `lat`/`lon`.
|
|
|
|
**Absorbed as warnings** (still boots): a blank `name` defaults to the type label; an unknown `type` remaps
|
|
to `opshop`; duplicate ids; and — importantly — **a cache spanning > 5 km warns "likely more than one
|
|
town"**. A cache MUST be ONE compact town: an over-broad Overpass bbox marches into an unusable multi-km
|
|
strip (the R17 mega-strip risk — a whole region of 2,918 shops became an 11.6 km avenue). Bound the query.
|
|
|
|
`type` should be a registry `SHOP_TYPE` (`record`/`opshop`/`toy`/`book`/`video`/`pawn`/`milkbar`/`dept`/`stall`);
|
|
`build_towns.py` maps OSM `shop=*` tags to these (unknowns land on `opshop`).
|
|
|
|
## Provenance (Lane E)
|
|
|
|
OSM data is **ODbL**. Ship attribution with the data: this `README`, a `SOURCES.md` (E's licence table),
|
|
and the `license`/`attribution` fields on every cache. Cache the **raw** Overpass responses too so re-runs
|
|
never re-fetch.
|
|
|
|
## Wiring
|
|
|
|
- `plan_osm.generatePlanOSM(seed, key, { cache })` marches a cache directly; `registerTownCache(key, cache)`
|
|
adds it to the runtime registry so `osmTownKeys()` and `generatePlanFor(seed, 'osm', { town: key })` see it.
|
|
- `web/js/citygen/selfcheck.js` auto-loads every `*.json` here: validates it, runs the full structural +
|
|
gig suites across the hero seeds, and pins a per-town golden (unpinned → prints the value to paste).
|