Files
settled-reach/wiki/economics/corp_hq_placement.toml
T
jpmschweitzerandClaude Fable 5 a0ebdbe6b8 feat(db): corp-HQ placement boundary re-tune — Standalone only for industrial-complex HQs (T-1076 item 0, D-242)
95->11 Standalone / 60->144 CityTenant per Jeroen's boundary ruling: only extraction/mining/quarrying, heavy vehicle+shipyard, heavy energy, gate infrastructure keep their own settlements; craft/consumer manufacturing, agriculture offices, high-tech fabs flip to CityTenant. Cygni pin moved to Metropolis (its HQ settlement vanishes under the flip). Regen systems.db: 340 city rows, 129 tenant links, fixpoint stable.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-16 16:22:22 +02:00

206 lines
8.3 KiB
TOML

# ==========================================================================
# Settled Reach — Corp HQ Placement Map (D-242)
# Source of truth. Compiled into corporations.hq_placement by
# import_economics.py (populate_corp_specialization), and into the
# Standalone-HQ settlement rows atlas_city_names gains by
# populate_standalone_hq_settlements (both economy_import/corporations.py).
#
# D-242: a corporate headquarters is not a city. Each corp's HQ is either:
# CityTenant — a tenant of an EXISTING city; a corp -> city link
# (corporations.headquarters_city_id), NO new settlement.
# Many corps may tenant one city (a bank and a newspaper
# share a downtown).
# Standalone — its OWN settlement, emitted into the cascade settlement
# list with its own body + position (a mine or shipyard
# sits alone). Standalone stanzas carry a second field,
# standalone_economic_role, so the emitted atlas_city_names
# row has a real economic_role (the existing 10-value
# D-195/D-197 vocabulary). CityTenant stanzas do not carry
# this field — no settlement is emitted for them.
#
# THE BOUNDARY (Jeroen's ruling, T-1076 item 0 — supersedes the earlier
# bulk_class-derived default, which over-generalized: it mapped every
# physical-goods value Standalone and produced a winery and a leatherworks
# as standalone asteroid-belt settlements). Standalone applies ONLY where
# the HQ is ITSELF an industrial complex / company town:
#
# - extraction / mining / quarrying (the deposit IS the site)
# - heavy vehicle + shipyard manufacturing (the yard IS the site)
# - heavy energy: refinery / extraction complexes (the plant IS the site)
# - gate / orbital infrastructure fabrication (the works IS the site)
#
# EVERYTHING else is CityTenant — explicitly including craft/consumer
# manufacturing (distilleries, breweries, wineries, ceramics, textiles,
# furniture), agriculture of every scale (the estate/agribusiness OFFICE
# sits in a market town; the fields are not the HQ), and high-tech fabs.
# Jeroen's rendering note (recorded in D-242): CityTenant HQs often sit on
# a settlement's EDGE or in industrial clusters — that is rendering /
# district-placement color for later phases, NOT a third placement class.
#
# This file has exactly one stanza per corp_specialization value — the
# REUSED D-237 specialization_vocabulary id-space (see
# wiki/economics/specialization_vocabulary.toml): the original 27
# system-authored values plus 4 corp-only Services-extension values
# (trade_distribution, hospitality_hub, professional_services,
# licensed_clinical_services). Flipped stanzas below carry a one-line
# justification against the boundary.
#
# Decisions: D-242 (this map + the boundary), D-237 (the reused
# vocabulary). Tickets: T-1074 (map created), T-1076 item 0 (boundary
# correction). PR #177 review created the 4th extension value (M1).
# ==========================================================================
# -------------------------------------------------------------------------
# Agricultural — ALL CityTenant (T-1076 item 0). The land/terroir is the
# production site, but the HQ is the estate/agribusiness office, and offices
# sit in market towns. (Previously Standalone via the bulk_class shortcut.)
# -------------------------------------------------------------------------
[estate_farming]
hq_placement = "CityTenant"
# FLIPPED: estate agriculture — Jeroen's explicit example; the estate office
# sits in a market town, the manor grounds are not a corporate settlement.
[breadbasket]
hq_placement = "CityTenant"
# FLIPPED: industrial-scale agribusiness is still agriculture — the grain
# combine's HQ is an office in the region's market hub, not a company town
# on the fields.
[terroir_agriculture]
hq_placement = "CityTenant"
# FLIPPED: agriculture; the terroir lock is about the LAND, not the HQ.
[terroir_spirits]
hq_placement = "CityTenant"
# FLIPPED: distilleries are craft manufacturing — Jeroen's explicit example
# (Groot Karoo Cellars as a standalone belt settlement was the named
# failure mode this correction eliminates).
[terroir_organics]
hq_placement = "CityTenant"
# FLIPPED: herd/ecosystem-origin organics are agriculture; the fiber/dye
# house's HQ is a town office.
# -------------------------------------------------------------------------
# Energy — Standalone (heavy energy: the refinery/extraction complex IS the
# corporate site — explicitly inside Jeroen's boundary).
# -------------------------------------------------------------------------
[fuel_production]
hq_placement = "Standalone"
standalone_economic_role = "extraction"
[geothermal_hub]
hq_placement = "Standalone"
standalone_economic_role = "extraction"
# -------------------------------------------------------------------------
# Extraction — Standalone (mining/quarrying: the deposit IS the site; the
# company town is the archetype of the whole Standalone class).
# -------------------------------------------------------------------------
[ore_extraction]
hq_placement = "Standalone"
standalone_economic_role = "extraction"
[company_mining]
hq_placement = "Standalone"
standalone_economic_role = "extraction"
[marble_monopoly]
hq_placement = "Standalone"
standalone_economic_role = "extraction"
[rare_mineral_extraction]
hq_placement = "Standalone"
standalone_economic_role = "extraction"
[lattice_material_source]
hq_placement = "Standalone"
standalone_economic_role = "extraction"
# -------------------------------------------------------------------------
# Manufacturing — SPLIT by the boundary: heavy vehicle/shipyard/gate works
# stay Standalone; craft/consumer fabrication flips to CityTenant.
# -------------------------------------------------------------------------
[general_industrial]
hq_placement = "CityTenant"
# FLIPPED: this value is carried overwhelmingly by craft/consumer
# fabricators (leatherworks, furniture, ceramics, glassworks, apparel —
# Kalahari Leatherworks as a standalone belt settlement was a named failure
# mode). Not heavy vehicle/shipyard work. A future true steel-complex
# identity would need its own vocabulary value rather than re-coarsening
# this one.
[shipbuilding]
hq_placement = "Standalone"
standalone_economic_role = "manufacturing"
[vehicle_production]
hq_placement = "Standalone"
standalone_economic_role = "manufacturing"
[consumer_goods_bazaar]
hq_placement = "CityTenant"
# FLIPPED: consumer manufacturing, and literally an urban bazaar of small
# workshops (Lu Ban) — the epitome of in-city production.
[gate_fabrication]
hq_placement = "Standalone"
standalone_economic_role = "manufacturing"
[military_industrial]
hq_placement = "Standalone"
standalone_economic_role = "military"
# -------------------------------------------------------------------------
# High-tech — CityTenant (T-1076 item 0: "high-tech fabs" are explicitly
# on Jeroen's CityTenant side of the boundary).
# -------------------------------------------------------------------------
[precision_tech]
hq_placement = "CityTenant"
# FLIPPED: high-tech fabs — Jeroen's explicit example; a cleanroom campus
# is an urban-edge tenant, not a company town.
[marine_farming]
hq_placement = "CityTenant"
# FLIPPED: aquaculture is agriculture's marine twin — the operator's HQ
# sits in the harbor town, the kelp beds are not a settlement.
# -------------------------------------------------------------------------
# Services (all NonPhysical) — CityTenant (unchanged; an office, no plant).
# -------------------------------------------------------------------------
[financial_hub]
hq_placement = "CityTenant"
[governance_center]
hq_placement = "CityTenant"
[transit_hub]
hq_placement = "CityTenant"
[research_station]
hq_placement = "CityTenant"
[legal_archive]
hq_placement = "CityTenant"
[media_center]
hq_placement = "CityTenant"
[longevity_monopoly]
hq_placement = "CityTenant"
# -------------------------------------------------------------------------
# Services extension (4, all NonPhysical) — CityTenant (unchanged).
# -------------------------------------------------------------------------
[trade_distribution]
hq_placement = "CityTenant"
[hospitality_hub]
hq_placement = "CityTenant"
[professional_services]
hq_placement = "CityTenant"
[licensed_clinical_services]
hq_placement = "CityTenant"