Fleet generator & guided tour#

More than a seeder: a self-driving guided tour. A scale knob produces a synthetic datacenter, then the tour mines its own interesting scenarios, writes the prompts, runs them, and emits the diagrams — so any size of fleet produces its own narrated walkthrough. Use it to evaluate rackattack against realistic sample data before you wire in your own inventory.

*generate → mine → prompt → run → render*

Generate a fleet (tunable, deterministic)#

rackattack fleet new --sites 8 --racks-per-row 20 --oversub 3:1 \
  --redundancy ab --seed 42

Scales from one rack → row → site → multi-site.
Plausible topology: leaf-spine switching, structured cabling through patch panels, A/B power, realistic device mixes and power/heat profiles.
Deterministic from --seed — same seed reproduces the same fleet. Benchmarks, tests, and the example preset all depend on this.
Plants guaranteed-interesting scenarios: a single-point-of-failure feed, an over-budget thermal hotspot, a congested fabric uplink.

Run the guided tour (mine → prompt → run → render)#

rackattack example run --preset example --out example-out

Mine — biggest-blast-radius feed, hottest rack, longest cable path, most-congested link.
Prompt — template natural-language questions around them (optionally LLM-phrased for variety).
Run — map each prompt to its tool call and execute.
Render — emit the diagrams into a narrated gallery. At the example preset this reproduces NARRATIVE.md exactly.

In production the prompt → tool mapping is your own LLM agent over MCP; the guided tour is a scripted stand-in that proves the pipeline without a live agent.

Scale & load#

The same generator drives the benchmarks and a concurrent load harness — it produces deterministic fleets up to ~1.7M rows (~200k devices) and then hammers the hot recursive RPCs. See Performance & scale for the numbers and just loadtest for the harness.