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:
@@ -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>,
|
||||
}
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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(),
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -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
@@ -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() {
|
||||
|
||||
@@ -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"`).
|
||||
|
||||
Reference in New Issue
Block a user