settled-reach/tooling/planet-gen/refine_log_849.md

Hand-Refine Log — Ticket #849

Core-world atlas cohesion pass (Sprint 36)

Analyst: paula Date: 2026-04-19

---

Analysis infrastructure

Created tooling/planet-gen/atlas_cohesion_audit.py — reusable SQL audit script for the atlas_* tables. Checks: empty/single-char names, generic/lazy outputs (% Fork, % Run, etc.), cardinal direction density, earth-echo concentration, same-body cross-feature stem duplicates, cross-body stem duplicates within a system. Accepts --system, --body, --db flags.

Created tooling/planet-gen/apply_name_fixes.py — applies curated name replacement tables to markers.json files (name fields only; geometry preserved). --dry-run supported. After running, caller must sync DB via generate_atlas.py --body <id>.

---

Bodies touched

GJ 144 — Ran system

GJ144d — Kallast (2B pop, urban_concentrated, ocean world)

Priority reason: Highest-population body in the Ran system; repeated player destination. Prior naming pass had done good Nordic groundwork (Rán's Landing, Seterfjellet, Rán's Run/Ranfall Beck cross-reference arc) but left residual generic oceans and one cross-system stem collision.

Changes:

Feature type	Old name	New name	Reason
river	Aldren Pass	Randalfoss	"Aldren" stem collides with Lendel (GJ380c) capital + river "The Aldren" — cross-system noise
ocean	Boulder Bluff	Keldmere	Generic; "Boulder Bluff" is a geographic descriptor for a landform, not a sea
ocean	High Mesa	Seterfjord	"High Mesa" is nonsensical for an ocean; renamed to cross-ref mountain "Seterfjellet"
poi	Summit Point	Kallast Gate Terminal	Generic; terminal should reference the capital city name

Cross-reference arcs post-fix:

• Rán-: Rán's Landing (city), Rán's Run (river), Randalfoss (river), Ranfall Beck (river), Rán Sea (ocean)
• Seter-: Seterfjellet (mountain), Seterfjord (ocean)
• Keld-: Keldmere (ocean), Timber Keld (river)

DB sync: generate_atlas.py --body GJ144d ✓

---

GJ144e — Vethis (1.2B pop, agricultural, dispersed_rural)

Priority reason: Second-most-populated Ran body; the rural agricultural contrast to Kallast. Prior naming pass was partial — extensive cardinals (West Bend), earth-echoes (Blue Ridge), overused stems (Ash-: 3 features; Iron-: 2 features), and many pure generics (Golden Valley, Broad Fork, Stone Point).

Changes:

Feature type	Old name	New name	Reason
river	West Bend	Greywash Fork	Cardinal → cross-refs Greywash river (shared Grey- stem arc)
river	Blue Ridge	Ashvale Beck	Earth-echo → cross-refs Ashvale city (shared Ash- stem arc)
river	Stone Point	Thornrun	Generic → cross-refs Thorncrests mountain (shared Thorn- arc)
river	Ironside Run	Kelside Run	Iron- overuse → cross-refs Kelbridge city (shared Kel- arc)
ocean	Ashbluff Sea	Veth Mere	Ash- overuse (3 Ash- names) → cross-refs Veth Delta river (shared Veth- arc)
mountain	Golden Valley	Greymoor Range	Generic → extends Grey- arc
mountain	Broad Fork	Keld Spur	Generic → Nordic compound (keld = spring/source)
mountain	Ashstone Ridge	Greystone Ridge	Ash- overuse → extends Grey- arc
poi	Ridge Crossing	Vethis Gate Terminal	Generic → terminal named for the planet

Cross-reference arcs post-fix:

• Grey-: Greywash (river), Greywash Fork (river), Greymoor Range (mountain), Greystone Ridge (mountain)
• Thorn-: Thorncrests (mountain), Thornrun (river)
• Kel-: Kelbridge (city), Kelside Run (river), Keld Spur (mountain)
• Veth-: Vethis (planet), Veth Delta (river), Veth Mere (ocean)
• Ash-: Ashvale (city), Ashvale Beck (river) ← 2 names, was 3 before fix

DB sync: generate_atlas.py --body GJ144e ✓

---

GJ 71 — Tau Ceti system

GJ71c — Threshold (600M pop, agricultural, urban_concentrated)

Priority reason: Tau Ceti's primary inhabited body; high player footfall. All six rivers were named after the original Commission survey team — a strong narrative hook ("Latin personal names = founding scientists"). "Aethelred" broke the pattern (Anglo-Saxon, wrong naming tradition).

Changes:

Feature type	Old name	New name	Reason
river	Aethelred	Gaius	Anglo-Saxon name breaks all-Latin river pattern (Octavius, Septimus, Quintus, Valeria, Marcus, Gaius)

DB sync: generate_atlas.py --body GJ71c ✓

---

GJ71d — Arden (500M pop, agricultural, dispersed_rural)

Priority reason: Tau Ceti's sister body; shares corridor with GJ71c, so cross-body stem duplicates matter most here. Two collisions found: exact POI name match + ocean/city stem match.

Changes:

Feature type	Old name	New name	Reason
city	Concordia Hall	The Praxis	"Concordia" = GJ71c ocean name; cross-body stem collision within same system/corridor
river	Basilica Nova	Via Principia	Exact name match with GJ71c POI "Basilica Nova"; direct duplicate across bodies

DB sync: generate_atlas.py --body GJ71d ✓

---

GJ71d-1 — Verantis (20M pop, transit moon)

No changes. Discovered that Verantis was already updated in a prior sprint pass — mountains renamed to unique Latin institutional names (The Lateranum, The Curia Magna, The Exedra, The Aedes Sacra, The Macellum, The Oracle, The Comitium, Moeribee), capital updated to "Praetorium". DB was stale relative to markers.json; synced only.

DB sync: generate_atlas.py --body GJ71d-1 ✓

---

Systems NOT yet touched

Sol (GJ 0) — BLOCKED

Body directories do not exist. wiki/star-systems/GJ-0/bodies/ has no subdirectories for Earth (GJ0d), Luna (GJ0d-1), Mars (GJ0e), or other inhabited bodies. sol_import.py must be run first to create body directories and initial markers.json from the real-world geographic data in tooling/planet-gen/sol_markers/. Flagged to team-lead.

Barnard's Star (GJ 699) — FLAGGED, not yet addressed

Audit revealed significant cross-body naming issues on Verada (1.9B pop), a hop-0 system:

• "Central District" appears as BOTH a GJ699b ocean and GJ699b-1 mountain (exact duplicate)
• "Capitol Heights" appears as GJ699b city and GJ699b-1 mountain
• "Liberty" stem hits 3 separate bodies
• "Meridian" stem hits 3 separate bodies
• "Zenith" stem hits 3 separate bodies
• Predominantly civic/Earth-style naming (Liberty Plaza, Meridian City, Zenith Station) without system-internal cross-referencing

Not addressed yet — flagged to team-lead to decide if within #849 scope or a separate ticket.

Proxima (GJ 551) — FLAGGED, not yet addressed

Cross-body stem duplicates found: Basilica, Pantheon, Senate appear on multiple Ancora sibling bodies. Not addressed — flagged to team-lead.

---

Audit metrics (before/after comparison)

Run python3 tooling/planet-gen/atlas_cohesion_audit.py --system "GJ 144" to verify Ran improvement. Run --system "GJ 71" for Tau Ceti. Baseline run captured issues above; post-fix re-run showed all named changes reflected in DB correctly.

Spot-check verification queries:

SR_DB_PATH="$(pwd)/server/data/systems.db" tooling/db/sqlite-query \
  "SELECT local_id, name FROM atlas_rivers WHERE body_id = 'GJ144d'"
# Should show "Randalfoss" not "Aldren Pass"

SR_DB_PATH="$(pwd)/server/data/systems.db" tooling/db/sqlite-query \
  "SELECT local_id, name FROM atlas_cities WHERE body_id = 'GJ71d'"
# Should show "The Praxis" not "Concordia Hall"

---

Files changed

• tooling/planet-gen/atlas_cohesion_audit.py (new)
• tooling/planet-gen/apply_name_fixes.py (new)
• tooling/planet-gen/refine_log_849.md (this file)
• wiki/star-systems/GJ-144/bodies/GJ144d/markers.json (4 name edits)
• wiki/star-systems/GJ-144/bodies/GJ144e/markers.json (9 name edits)
• wiki/star-systems/GJ-71/bodies/GJ71c/markers.json (1 name edit)
• wiki/star-systems/GJ-71/bodies/GJ71d/markers.json (2 name edits)
• server/data/systems.db (synced: GJ144d, GJ144e, GJ71c, GJ71d, GJ71d-1)