rackattack#
An agent-driven DCIM — a datacenter infrastructure-management source of truth. A gRPC-first Go service on CockroachDB models devices, cabling, power, and cooling as a typed infra graph; an MCP adapter lets an LLM agent drive it. There is no web GUI — every visualization is a generated artifact (SVG / interactive HTML), and visualization quality is the headline differentiator.
“A Go gRPC service on CockroachDB that models datacenter physical infra — cabling, power, and cooling — as a graph, with a fleet generator so the benchmarks are real, and you can point an agent at it over MCP to ask blast-radius questions and get back a diagram.”
Start here#
| Section | What it covers |
|---|---|
| Architecture | The service shape, four interfaces, cross-cutting layers, request lifecycle |
| Data model & schema | The 17-table infra graph, A/B power chain, transceivers, audit log |
| Rendering | Graphviz layout + the custom Go SVG painter |
| API surface | All 24 gRPC RPCs, REST (grpc-gateway), GraphQL, MCP |
| Configuration | Every environment variable, with defaults |
| Security & auth | OIDC/JWT validation + role-based authorization |
| Caching | Read-through cache (LRU/Redis) + invalidation |
| Audit & CDC | CHANGEFEED change-data-capture + audit history |
| Fleet generator & guided tour | The self-driving guided tour |
| Performance & scale | Hot-query benchmarks, index tuning, load harness |
| Deployment | Containers and Kubernetes |
| Observability | Prometheus metrics, alerts, Grafana, OpenTelemetry |
| Interaction model | Hover/select states in the interactive artifact |
| Contributing | Local setup and the build loop |
Canonical specs#
These docs are built from — and link back to — the specs checked into the repo:
README.md,
NARRATIVE.md,
TOOLS.md, and
assets/DESIGN.md.
The specs are the contract; this site is the navigable view.
The diagrams on this site are authored as Graphviz
.dotsources insite/diagrams/and compiled to SVG at build time — the same diagram engine the product uses for its renders.