Files
settled-reach/tooling/archive
jpmschweitzerandClaude Opus 5.5 59b3fc4caa refactor(tooling): T-1293 — atlas map, and the generator that must not run
The star-map family was the last unported part of the tree, and it never had
a ticket. Two of its scripts become `reach atlas map` verbs, nested under
atlas like planet (D-243: the Reach map is the ladder's top rung):

- `reach atlas map data [--check]` regenerates client/data/star_map_data.json.
  The regenerated file differs by one line: `_meta.note`, which named the
  old script's path.
- `reach atlas map svg` renders the concentric SVG (+ PNG), byte-identical
  to the old script's output on the same data.

make check-star-map and star-map-data stay as one-line delegates, because
pre-pr-client and pre-pr-validate depend on check-star-map.

generate-star-map.py, its seed, sculpt-star-map.py and tune-star-map-topology.py
are archived, not ported. The generator rewrites docs/design/star-map.json
unconditionally from an S-NNN-keyed seed, so re-running it would erase the GJ
migration and every hand edit since; sculpt and tune only understand S-NNN
edges. .claude/rules/diagrams.md was telling agents to "edit the generator
and re-run it". It now distinguishes the live concentric render, the seven
frozen S-keyed sector .d2 files (T-1294), and the two SVGs that never had a
generator in the repo.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-23 20:00:05 +02:00
..

tooling/archive — provenance, not tooling

Scripts kept because they record HOW something in the repo came to be, not because anything should run them again. None is a reach verb, none is importable (no __init__.py, excluded from package discovery and from the D-263 conformance scope), and several would do damage if run today. Deleting them would lose the provenance; keeping them live would imply they still work (tooling/DOMAINS.md, "pql-migrate/ is provenance, not tooling").

path what it did why it is here
pql-migrate/ the one-shot planning-store migration into pql completed migration (T-1271 ruling)
wiki-bootstrap/assign-astro-ids.py + gj-catalog-real.json gave the 300 S-NNN systems real Gliese-Jahreiss ids done; S- ids no longer exist
wiki-bootstrap/migrate-s-to-gj.py rewrote every S-NNN reference to its GJ id done
wiki-bootstrap/patch-core-sector.py added 17 hand-balanced core-sector gate edges done; hardcodes a planning/ path that no longer exists
wiki-bootstrap/generate-stubs.py, find-stubs created and then tracked the Phase-1 system stubs done; find-stubs --all-sectors 0 99 finds 0 stubs
wiki-bootstrap/fill-missing-globes.py copied donor globe.png files into bodies that lacked one self-described one-shot
wiki-bootstrap/backfill_cultural_corridor.py copied geographic_sector into cultural_corridor a raw systems.db patch script, the kind .claude/rules/asset-pipeline.md forbids; absent from the D-262 flow
wiki-bootstrap/process-wiki-system-changes wiki → systems.db → star-map.json → re-rendered system pages destructive today — its last step is wiki_sync.generate_wiki(), which no longer reproduces the committed pages (T-1290 finding, see the wiki domain's router)

| character-bootstrap/setup_clothing_metadata.py | wrote coverage.json + a placeholder mask for the first five clothing items | all five (coveralls_basic, jacket_utility, pants_cargo, shirt_henley, boots_work) are gone from today's 24-garment wardrobe; re-running would recreate them | | atlas-bootstrap/wipe-bodies.sh | DELETE FROM bodies; DELETE FROM stations; on systems.db | destructive — a raw DB patch of the kind .claude/rules/asset-pipeline.md forbids, against the atlas-CLI-owned bodies catalog |

| map-bootstrap/generate-star-map.py + star-map-seed.json | the 6-phase algorithm that produced docs/design/star-map.json and the 7 sector .d2 files | destructive today — it rewrites star-map.json unconditionally from an S-NNN-keyed seed, which would erase the GJ migration and every hand edit since (T-1293, T-1294) | | map-bootstrap/sculpt-star-map.py, tune-star-map-topology.py | reshaped the generated graph toward a target topology distribution | operate on S-NNN edges; today's map has none |

Archived in T-1250 / T-1290 / T-1293 (2026-09-23).