Files
settled-reach/tooling/archive/README.md
T
jpmschweitzerandClaude Opus 5.5 4537b71b92 refactor(tooling): T-1290 — the wiki domain, and the renderer that must not run
`reach wiki stats` and `reach wiki gttr-hook` replace tooling/db/wiki_sync.py
and populate_gttr_hook.py. Both are output-identical to the originals:
`stats` byte-for-byte, and all 301 extracted GTTR hooks line-for-line.

wiki_sync.py moved whole, but generate_wiki() and import_from_wiki() are NOT
verbs. Before porting, the old `--generate` was run against a clean tree to get
a parity baseline. It changed all 301 system pages, +940 / -10,761, and was
reverted at once. It deletes the Celestial Bodies / Stations blocks (owned by
the Rust atlas sync, which it does not know about), deletes the
Industries / Exports / Imports rows (nothing writes those any more), and
rewrites star types where systems.db and the pages disagree. D-262, CLAUDE.md
and the wiki skill all described it as the routine, prose-preserving render.
CLAUDE.md and the skill now say not to run it; D-262 needs amending — T-1292.

Provenance moves to tooling/archive/, with a README naming what each script
did and why it is not run:

- pql-migrate/ (the T-1271 ruling)
- wiki-bootstrap/: assign-astro-ids + its catalog, migrate-s-to-gj,
  patch-core-sector (hardcodes a dead path), fill-missing-globes,
  generate-stubs and find-stubs (finds 0 stubs — Phase 1 is done),
  backfill_cultural_corridor (a raw systems.db patch script, outside D-262),
  and process-wiki-system-changes, whose last step is the destructive render

Also:

- stats() printed "run import first" and exited 0 when a table was missing;
  it now fails with a remedy. generate_wiki() counted created pages after
  writing them, so `created` was always 0.
- tooling/godot-cold-parse and godot-parse-sweep were never retired after
  T-1283, and the pr-process skill still told agents to run them. Removed;
  the skill and parse_sweep.gd now name the reach verbs.
- systems.db re-stamped: schema comments changed, and the stamp records the
  schema file's SHA for tamper detection.

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

1.8 KiB

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)

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