docs(tooling): T-1253 — sweep the live references to retired tool paths

A script scanned every tracked doc, rule, skill, agent, hook and source file
for tooling/ paths that no longer exist, skipping historical records (sprints,
discussions, workshops, governance, generated wiki pages). It found 62. The
ones that tell a reader what to RUN now name the reach verb:

- The atlas skill still sent agents to tooling/atlas, atlas-verify,
  atlas-update-field and atlas-commit-and-sync — about forty lines, all
  retired in T-1285. They now name the `reach atlas` verbs, and the skill
  records that commit-and-sync STAGES by default (--commit to commit) and
  takes --corridor as an option.
- The clerk agent named tooling/clerk-review (now `reach dev clerk`). The Si
  and clerk briefings sent those agents to the retired tooling/db/decision
  and sqlite-query CLIs and to decisions/*.md paths that moved to
  governance/ in the pql migration. They now name pql.
- The ticket-cli rule documented `pql decisions read`, which does not exist;
  `show` already includes the body.
- The culture authoring guide and the RON sources name
  `reach validate ron`, with the same arguments as before.
- The 41 Blender payloads' usage lines ran the retired tooling/blender
  wrapper, and the docstrings still cited pre-carve-out paths. They now read
  `reach blender run <payload>`.
- Doc comments in server/, client/, wiki TOMLs and the domain modules.

What is left is deliberate: "Formerly …" provenance, dated plans and findings
docs, the retired-pipeline doc, and a build-artefact path.

project.yaml 0.4.14 (mirrored to the client). Comment-only, but four touched
files are in the canvas-version registry (trait_catalog_reader.rs, since
T-1289, canvas_sources.py itself, and two client files). The gate is
path-based and has no override. The previous push was rejected on exactly
this.

Three of the edits are stamped ledger sources, so systems.db is regenerated
and the stamp is fresh.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-09-23 20:13:58 +02:00
co-authored by Claude Opus 5.5
parent e3daf561d1
commit c597ec9131
69 changed files with 156 additions and 170 deletions
+2 -2
View File
@@ -3,7 +3,7 @@
//!
//! - **Star map** ([`StarMapRequest`]/[`StarMapResponse`]): a session-scoped,
//! non-per-body proxy over the static `client/data/star_map_data.json`
//! dataset (produced by `tooling/generate-star-map-data.py`). Reads the file
//! dataset (produced by `reach atlas map data`). Reads the file
//! fresh on every request — no caching, no staleness handling — because the
//! client only asks once per session when the Atlas star-map view opens.
//! The parsed JSON is passed through as an opaque `serde_json::Value` rather
@@ -79,7 +79,7 @@ pub enum StarMapStatus {
pub struct StarMapResponse {
pub status: StarMapStatus,
/// Verbatim parsed JSON (`_meta`, `nodes`, `edges` — see
/// `tooling/generate-star-map-data.py`), re-serialized as MessagePack.
/// `reach atlas map data`), re-serialized as MessagePack.
/// `None` unless `status == Ready`.
pub data: Option<serde_json::Value>,
}
+4 -4
View File
@@ -3,10 +3,10 @@
//! # Usage
//!
//! ```sh
//! # Via wrapper script (recommended):
//! tooling/atlas list-bodies --system "GJ 15A"
//! tooling/atlas list-bodies --type planet --inhabited
//! tooling/atlas show-system "GJ 15A"
//! # Via reach (recommended — builds the binary on demand):
//! reach atlas db list-bodies --system "GJ 15A"
//! reach atlas db list-bodies --type planet --inhabited
//! reach atlas db show-system "GJ 15A"
//! tooling/atlas show-body "GJ 15Ab"
//! tooling/atlas add-body --system "GJ 15A" --type planet --orbit 1 --id "GJ 15Ab"
//! tooling/atlas stats
+1 -1
View File
@@ -511,7 +511,7 @@ fn write_output(path: &PathBuf, products: &[BrandProduct], inputs: &[BrandInput]
let mut out = String::new();
out.push_str("# Generated Minor Brand Products — The Settled Reach\n");
out.push_str("# Auto-generated by generate_brands binary. Do not hand-edit.\n");
out.push_str("# Re-run: tooling/generate-brands\n");
out.push_str("# Re-run: reach generate brands\n");
out.push_str(&format!(
"# Total: {} brand_products, {} brand_inputs\n\n",
products.len(),
+1 -1
View File
@@ -9,7 +9,7 @@
//! `main.rs` — this directory is not a cargo bin target (no `main.rs`).
//!
//! NOTE: both binaries feed the systems.db meta stamp — this file is part of
//! the `import_economics` source set in `tooling/check-systems-db-stamp`
//! the `import_economics` source set checked by `reach check systems-db-stamp`
//! (GENERATOR_SOURCES). Changing any pool requires `make regen-db`.
//! Pool contents are surname data drawn from founding cultures in wiki canon;
//! ordering is load-bearing (index-based RNG draws), so never reorder.
+2 -2
View File
@@ -8,8 +8,8 @@
//!
//! ```sh
//! # Via wrapper script (recommended):
//! tooling/validate-ron server/content/global/zone-identity-spec.example.ron zone
//! tooling/validate-ron server/content/global/culture-van-maanens-star.example.ron culture
//! reach validate ron server/content/global/zone-identity-spec.example.ron zone
//! reach validate ron server/content/global/culture-van-maanens-star.example.ron culture
//!
//! # Direct:
//! cargo run --bin validate_ron -- <file.ron> <zone|culture>
+1 -1
View File
@@ -230,7 +230,7 @@ fn main() {
}
// Star-map dataset proxy (T-949a): resolve the repo-root-relative path to
// the client's pre-generated star_map_data.json (tooling/generate-star-map-data.py).
// the client's pre-generated star_map_data.json (`reach atlas map data`).
// Read fresh on every request — no caching, see atlas_data_proxy module doc.
let star_map_data_path = world_root.join("client/data/star_map_data.json");
if star_map_data_path.exists() {
+2 -2
View File
@@ -20,7 +20,7 @@
//! ## Format
//!
//! RON (Rusty Object Notation) — struct-aware, supports enums and comments.
//! Validate with: `tooling/validate-ron <file.ron> <zone_type|culture>`
//! Validate with: `reach validate ron <file.ron> <zone_type|culture>`
use rand::Rng;
use serde::{Deserialize, Serialize};
@@ -112,7 +112,7 @@ pub struct SocialSiteSpec {
/// NPCs per site) — that lives on `LocationSpec.social_sites`.
///
/// The Rust struct IS the schema. RON files must match this struct exactly.
/// Validate with: `tooling/validate-ron server/content/global/zone-types/<id>.ron zone_type`
/// Validate with: `reach validate ron server/content/global/zone-types/<id>.ron zone_type`
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ZoneTypeTemplate {
/// Canonical zone-type identifier (e.g. `"rural_agricultural"`).