diff --git a/docs/workshops/system-economic-specialization/heritage-rebalance-batch.md b/docs/workshops/system-economic-specialization/heritage-rebalance-batch.md new file mode 100644 index 000000000..7fa3ab100 --- /dev/null +++ b/docs/workshops/system-economic-specialization/heritage-rebalance-batch.md @@ -0,0 +1,348 @@ +# Heritage Rebalance — Conversion Batch (#1019) — ✅ SHIPPED 2026-06-01 + +> **STATUS: COMPLETE.** Executed as **5 conversions** (Helderoog dropped as +> load-bearing; **Carnarvon → Golestan / persian** added in its place per the +> maintainer). Final: afrikaans 15→**10**; arab=2 (Marib, Sawad), persian=2 +> (Akhgar, Golestan), turkic=1 (Sığınak). Footprint actually touched: +> systems.db (system+body+station proper_name, cultural_specialization, +> gttr_hook, atlas_city_names), 5 gttr.md, 5 index.md, 6 body index.md, +> 2 markers.json, system_specialization.toml, _CULTURAL_HERITAGE constant +> (+arab/persian/turkic), 8 atlas proposals, 4 brand-corps renamed +> (Sığınak Gas Skimming / Marib Biosphere / Marib Textile / Akhgar Fuel), +> ~18 cross-reference wiki files, client star_map_data.json. One pre-existing +> canon bug fixed in passing: Sawad (GJ 508A) no longer claims GJ 914A is +> "unsettled" (it is Marib, a 300-yr settlement). Carnarvon → Golestan detail: +> Mostert dynasty → Farahani; bodies Tulbagh→Pardis, Hermanus→Anzali; stations +> Elsenburg→Varamin, Yzerfontein→Now Shahr; "rose garden" naming for a +> single-family landed *dehqan* patrimony. Original 4-system plan follows. + +--- + +# Heritage Rebalance — Conversion Batch for Review (#1019) + +*4 thin afrikaans systems → arab/persian/turkic. Reduces afrikaans 15→11; seeds +the empty MENA/Central-Asian slots (arab=2, persian=1, turkic=1). Drafted +2026-06-01. NOTHING WRITTEN YET — approve, then I apply to db + index.md + gttr.md ++ atlas JSON + cultural value, and regen.* + +## Why these 4 (and not the others) + +KEPT afrikaans (load-bearing — untouched): Eerste Wacht (546) + Skemeraand (7547) +[500yr seven-surnames mystery], **Helderoog (111)** [Eerste Wacht daughter colony, +the genetic-protocol thread — I initially mis-listed this as thin; it is NOT], +Ouplaas (528A) [oldest Cairn anchor], Brandpunt (3943) [already a #784 subversion], +Oude Kraal (408)+Wagtoring (410) [wave_1, kraal architecture], Kaapse Baai (213) +[terroir economic lock], Breëvlei (661B) [already #784-enriched], Waterkant (183), +Carnarvon (680), Einde (407). + +CONVERTED (truly thin — modest farming/waypoint, distinctive thread is +heritage-agnostic and survives reframing): + +| GJ | old → new | heritage | distinctive thread (preserved) | +|---|---|---|---| +| 914A | Droëland → **Marib** | arab | multi-gen contingency-stores ritual | +| 508A | Stilwater → **Sawad** | arab | "Far Gate hours unaccounted" (→ Marib) | +| 1245B | Koeberg → **Akhgar** | persian | sealed founding-archive council vote | +| 722 | Skuilplek → **Sığınak** | turkic | flight-from-Commission-compliance | + +914A+508A are gate-adjacent → a coherent **Arab chain-migration pocket** (good +D-167 worldbuilding; keeps their cross-references internally consistent). + +## Per-system field changes (db + toml) + +### GJ 914A — Droëland → Marib (arab) +- `star_systems.proper_name`: Droëland → **Marib** +- `bodies.GJ914Ac.proper_name`: Calvinia → **Ghouta** +- `stations.GJ914A-oort-S1.proper_name`: "Droëland Horizon" → **"Marib Horizon"** +- `system_specialization.toml [GJ 914A]`: economic stays NULL (heuristic); **add `cultural_specialization = "arab"`**; faction stays NULL +- atlas JSON `docs/atlas/proposals/GJ914A.json` (if present): proper_name → Marib + +### GJ 508A — Stilwater → Sawad (arab) +- `proper_name`: Stilwater → **Sawad** +- `bodies.GJ508Ac.proper_name`: Uithoek → **Rusafa** +- `stations.GJ508A-oort-S1.proper_name`: "Stilwater Horizon" → **"Sawad Horizon"** +- toml `[GJ 508A]`: **`cultural_specialization = "arab"`** (econ NULL, faction NULL) + +### GJ 1245B — Koeberg → Akhgar (persian) +- `proper_name`: Koeberg → **Akhgar** +- `bodies.GJ1245Bb.proper_name`: Glimkop → **Kavir** +- `stations.GJ1245B-oort-S1.proper_name`: "Koeberg Horizon" → **"Akhgar Horizon"** +- toml `[GJ 1245B]`: **`cultural_specialization = "persian"`** (econ NULL, faction NULL) + +### GJ 722 — Skuilplek → Sığınak (turkic) +- `proper_name`: Skuilplek → **Sığınak** +- `bodies.GJ722c.proper_name`: Rietbron → **Pınar** +- `stations.GJ722-oort-S1.proper_name`: "Skuilplek Horizon" → **"Sığınak Horizon"** +- toml `[GJ 722]`: **`cultural_specialization = "turkic"`** (econ NULL, faction NULL) + +## Cross-reference fixes (other files mention the old names) + +These referencing files must update the old names → new, or the corridor breaks: +- `wiki/star-systems/GJ-722/gttr.md` (Skuilplek): "past Stilwater, past Droëland" → "past Sawad, past Marib" — BUT 722 itself becomes Sığınak; rewritten below. +- `wiki/star-systems/GJ-508A/gttr.md` (Stilwater→Sawad): "Far Gate" = GJ 914A = now Marib; "Breëvlei one gate back" stays (Breëvlei unchanged). Rewritten below. +- `wiki/star-systems/GJ-546` (Eerste Wacht), `GJ-528A` (Ouplaas), `GJ-661B` (Breëvlei), `GJ-914A`'s neighbors: grep for "Droëland/Stilwater/Skuilplek/Koeberg" and patch any mention. (I will grep the whole wiki + docs and fix every hit at apply time.) +- `client/data/star_map_data.json` regenerates from DB — no hand edit. +- Audit docs (`cultural-diversity-audit.md`, `cultural-stereotyping-audit.md`) mention old names historically — leave as historical record, do not edit. + +--- + +## REWRITTEN gttr.md files (full) + +### GJ 914A — Marib (was Droëland) + +```markdown +# THE DRIFTER'S GUIDE TO THE REACH — MARIB + +**MARIB** takes its name from an ancient Earth city whose people built a great +dam and made a dry land feed a civilization for a thousand years. The founding +families — Arab-heritage farmers who came three hundred years ago to work a +world with little water and a great deal of patience — chose the name knowing +exactly what they were promising themselves. + +## The Work + +Wave-3 settlement, hop 8, K-type primary in the Cairn pocket's deep north +corridor. Three centuries of worked soil, adapted crop varieties, and catchment +and channel irrigation built in the first century and maintained since — drawing +on a dryland-farming inheritance the founders carried from arid Earth latitudes, +where drawing grain from thin water was already an old and exact art. Marib feeds +itself and exports a modest grain and legume surplus back toward Sawad and the +inner corridor. The K-type star gives less light than Earth-standard and more +than the M-dwarfs further out, and the community has adapted cultivars to that +specific condition across generations with the patience that multi-generational +agricultural work allows and requires. + +There is no industrial sector. Equipment that fails is repaired by maintenance +cultures inner-reach technicians would find eccentric and that work. Replacement +parts come in through the gates slowly, at frontier freight rates, and the +community plans for long delays. The reserve against multi-year supply disruption +has been maintained since the founding cohort as a rational response to frontier +isolation that has become a communal discipline: replenished, rotated, inventoried +by every household, taught to children as a basic obligation. The figure has never +been shared with outside parties. The community does not volunteer it. + +## Not Defiance + +The Lattice Commission has a filed registration and a nominal compliance record. +No Commission personnel are resident. This is not defiance; it is geography and +the practical reality that nothing at Marib rises to the level of Commission +operational interest. The community's institutional reflexes align with Guardian +values without anyone having organized them that way — deep frontier agricultural +communities with minimal institutional contact tend to develop similar attitudes +independently, because the attitudes are a rational response to the structural +situation. + +## The Reserve + +Three hundred years of preparation, never fully tested. The specific scale of +Marib's stores is the community's private knowledge, and it is held as such with +the quiet satisfaction of people who solved a problem three centuries ago and have +not needed outside help since. The reserve is not a secret in any dramatic sense. +It is simply not a subject raised with outside visitors, because raising it would +require naming the figure, and naming the figure would invite opinions about it, +and the community does not need outside opinions about whether its preparedness for +the gates going dark is proportionate. + +## Practical Information + +Marib is eight hops from Gateway with two apertures connecting to Sawad and +GJ 722. Agricultural surplus is available. Communication relay infrastructure +receives significant maintenance attention. The community is hospitable to visitors +who come with a purpose and brief with those who don't. + +Adams of the Guide rates Marib: *Self-sufficient. Generously prepared for a +disaster that hasn't happened.* +``` + +### GJ 508A — Sawad (was Stilwater) + +```markdown +# THE DRIFTER'S GUIDE TO THE REACH — SAWAD + +**SAWAD** was the name old Earth gave to the black alluvial farmland between two +rivers — the settled land, as opposed to the desert beyond it. The founders chose +it for exactly what they wanted: a world that would hold still and let people farm +it. It has been doing that for two hundred years and shows no sign of stopping. + +## The Settled Land + +The name means the worked, watered ground — chosen by Arab-heritage settlers who +found the system's main habitable world unremarkable in all the right ways: no +violent weather, no unstable tectonics, no competing interests. The M2V primary is +dim and steady. At hop 7, Commission presence is nominal — a charter filing office, +a transit log, a medical station open two days a week. Everything else is +community-managed and has been for as long as anyone can remember. The original +wave_4 settlers were the grandparents of the oldest generation now living here, and +the institutional memory of "before we had all this" means something to them, even +if what they had before was less. + +The population is small and deliberately so. Land is plentiful, neighbors are +infrequent, and the stars at night include the glow of Breëvlei one gate back, +visible on clear nights as a reminder of the corridor they sit at the end of. +Supply runs from the corridor behind them are long and the delays are part of life. +The Landbou Raad cooperative network — a Cape-heritage institution from further up +the corridor — includes Sawad in its distribution agreements, informally and +occasionally slowly; the arrangement is older than anyone's preference about it. + +## The Far Gate + +Sawad is a through-route between Breëvlei and Marib (GJ 914A), which means there is +a gate in the other direction. The transit logs from vessels coming in from that +direction show a pattern of missing hours. The logs are not discussed. Asking about +them is not explicitly discouraged, but it does not come up, and when it does, the +conversation moves on. + +## Practical Information + +Sawad is seven hops from Gateway with two apertures connecting to Breëvlei inward +and Marib (GJ 914A) outward. Wave_4 settlement, which makes it older than most +hop-7 systems — the Cairn pocket's founding push reached deep before the Reach's +expansion slowed. The community council runs everything. Nobody is in a hurry. The +farming is good. + +Adams of the Guide rates Sawad: *Peaceful. Far Gate Hours Unaccounted.* +``` + +### GJ 1245B — Akhgar (was Koeberg) + +```markdown +# THE DRIFTER'S GUIDE TO THE REACH — AKHGAR + +**AKHGAR** means "ember" in Persian — a single glowing coal — which is what the +founders called their barely-burning star, without affection or resentment. It is +what it is. + +## The Ember + +The primary at GJ 1245B is classified with a lowercase `m`, an object at the +hydrogen-burning minimum-mass boundary — a star so small and cool the category is +doing its best. The habitable zone exists, close-in, and the community lives in +station habitats and hardened surface installations built for a primary that offers +minimal margin. The sky is dark even at noon and the stars are always visible — a +condition the Persian-heritage founders folded into the system's name and into the +cast of their evening life, where the constancy of the stars is treated less as a +hardship than as a fact one builds a calendar around. + +One gate connects Akhgar to GJ 54. One gate is all there is. The transit volume +through it is low, deliberately so — this is not a through-route for anything. The +isolation that comes with a dead-end topology and a barely-stellar primary has, +over two hundred years, ceased to be a constraint and become instead a description +of what Akhgar is. Residents tend toward a quality of self-possession that visitors +from junction systems find unsettling until they recognize it as the natural +consequence of knowing that the person across from you at dinner will still be your +neighbor in thirty years. + +## Why Here + +The wave 4 founders chose this system two hundred years ago from among +alternatives that were, by any objective measure, more hospitable. The community's +founding narrative emphasizes the voluntary, purposeful nature of that choice; the +subtext that some of the original settlers may have had limited alternatives is +present in the archive and is not the story told to children. What is true is that +the founding party arrived and chose to stay when they could have continued. The +specific reasons they stopped here, at a dead-end with a minimum-mass primary, are +preserved in the ward council archives behind a closed session whose minutes were +sealed by unanimous vote two hundred years ago. + +Governance is a seven-ward council with a rotating chair that advances through the +wards in sequence each year — a structure designed, the founders wrote explicitly, +to be predictable. The Assembly does not maintain permanent staff here. It does not +need to. The community has never asked for more involvement and the Assembly has +never found cause to provide it uninvited. + +## Practical Information + +Akhgar is four hops from Gateway with one gate aperture — dead end. Fifteen +thousand registered residents in a community that has had the same approximate +population for sixty years, having reached a size its infrastructure and social +fabric can sustain and apparently decided that was sufficient. The niche textile +tradition has found a small market in adjacent systems; the geological survey work +continues, minus the three seasons of survey data abruptly sealed away in that +closed council meeting and never revisited. The Founding Family Archive is a genuine +cultural institution, open to visitors with genealogical inquiries. + +Adams of the Guide rates Akhgar: *Quiet on Purpose.* +``` + +### GJ 722 — Sığınak (was Skuilplek) + +```markdown +# THE DRIFTER'S GUIDE TO THE REACH — SIĞINAK + +**SIĞINAK** means "refuge" in Turkish, and the founders chose it because they came +here to take shelter from the Lattice Commission's tightened imprint requirements, +and the name was an accurate description of the project. + +## The Flight from Compliance + +Two centuries ago, the Lattice Commission tightened its imprint requirements. A +cohort of Turkic-heritage families decided that compliance was less acceptable than +distance. They followed the Cairn pocket corridor outward — past Sawad, past +Marib — to the furthest point the corridor reached, filed a charter, and named what +they found after their intention. The Commission never followed. + +The Commission's records classify Sığınak under "legacy exemption status" — a +bureaucratic artifact of the post-founding regulatory period in which communities +that had relocated specifically to avoid the tightened requirements were given +reduced compliance schedules rather than forced compliance, because the alternative +was a confrontation the Commission did not have the enforcement capacity to win at +this distance. The exemption has never been formally revoked. It renews +automatically. No Commission agent has visited in living memory. The system's +operational existence is, from the Commission's perspective, a matter of record and +not of interest. + +## What Two Centuries Does to an Orthodoxy + +The founding narrative is clear: they came to operate without lattice compliance. +What that means two centuries later is more complex. Some families have never +integrated and never will — this is the orthodoxy, and it is genuinely held. Others +have acquired limited lattice capability for medical necessity or professional +function while maintaining formal non-compliance postures. The community does not +adjudicate this publicly. + +The Guardians of Autonomy cite Sığınak in their theoretical literature on +minimal-lattice community viability — not as a utopia but as an empirical case +study. Guardian field representatives visit occasionally and are received as +something closer to distant relatives than advocates. The distinction between what +the community officially is and what it currently practices is the kind of gap that +two centuries of practical accommodation produces, and which the community manages +by not presenting a detailed picture to anyone outside. + +## Practical Information + +Sığınak is nine hops from Gateway with two apertures connecting to Marib and +GJ 528A. The agricultural base is mature — seven or eight generations of M-dwarf +adaptation. The community is substantially self-sufficient in food and deliberately +low in lattice infrastructure dependency. Medical equipment and relay hardware +represent the critical external dependencies. Visitors should note that questions +about current lattice integration levels are met with responses accurate in the +founding-historical sense. + +Adams of the Guide rates Sığınak: *Two centuries of hiding. The Commission stopped +looking a long time ago.* +``` + +> Note GJ 722's old text said its two apertures connect to "Droëland and GJ 528A." +> Droëland is now Marib — corrected above to "Marib and GJ 528A." + +## index.md prose-section edits + +For each system, the index.md infobox/topology re-renders from the DB on +`wiki_sync` (name follows automatically). The **authored prose sections** +(Supply Dependency / Faction Notes / etc.) and any **body-name mentions** in them +need the same name/heritage swaps as the gttr. At apply time I will edit each +index.md prose section to match its rewritten gttr (same facts, new names/people), +and grep all 4 index.md files for residual "Droëland/Stilwater/Koeberg/Skuilplek/ +Calvinia/Uithoek/Glimkop/Rietbron/Afrikaans/Cape" and patch. + +## Apply-time checklist (after approval) + +1. `sqlite-exec` UPDATE proper_name on star_systems(4) + bodies(4) + stations(4). +2. Overwrite the 4 gttr.md with the rewrites above. +3. Edit the 4 index.md prose sections + body-name mentions to match. +4. Append `cultural_specialization` to the 4 toml stanzas (arab/arab/persian/turkic). +5. Update `docs/atlas/proposals/GJ{914A,508A,1245B,722}.json` proper_name (if present). +6. Grep whole `wiki/` + `docs/design` + `docs/briefings` for old names; patch live + cross-references (NOT the historical audit docs). +7. `make regen-db`; verify proper_names + cultural values + stamp; check star_map_data.json regenerated. +8. Commit + push.