Overview

Fixed shape, and every unbounded list in it is capped with its true total reported alongside.

Code example

curl -X GET "https://example.com/api/v1/diagnostics"

Response example

{  "meta": {    "sim_time_ns": 0,    "sim_seconds": 0.1,    "publish_seq": 0,    "age_ms": 0  },  "runtime": {    "apply_queue_depth": 0,    "sessions_connected": 0,    "server_mode": true  },  "status": "InProgress",  "topbar": {    "cash_dollars": 0.1,    "total_revenue_dollars": 0.1,    "total_recurring_revenue_dollars": 0.1,    "total_one_time_revenue_dollars": 0.1,    "total_cost_dollars": 0.1,    "last_hour_revenue_dollars": 0.1,    "reputation": 0.1,    "current_site_id": "string",    "current_site_name": "string",    "current_progression_step": 0,    "customer_count": 0,    "active_customer_count": 0,    "staff_count": 0,    "staff_unlocked": true,    "heat_load_w": 0,    "cooling_capacity_w": 0,    "public_ips_used": 0,    "public_ips_max": 0,    "uplink_egress_gbps": 0.1,    "uplink_capacity_total_gbps": 0.1,    "active_ddos_mbps": 0,    "facility_egress_drop_p": 0.1,    "backbone_drop_p": 0.1,    "appliance_fabric_drop_p": 0.1,    "wan_effective_gbps": 0.1,    "wan_lines_gbps": 0.1,    "wan_gateway_fabric_gbps": 0.1,    "wan_inline_appliance_gbps": 0.1,    "wan_binding": "string"  },  "capacity": {    "free_rack_u": 0,    "used_rack_u": 0,    "total_rack_u": 0,    "free_power_w": 0,    "free_public_ips": 0,    "free_uplink_capacity_gbps": 0.1,    "largest_free_vcpu_milli": 0,    "largest_free_mem_mb": 0,    "largest_free_ssd_gb": 0,    "unplaceable_unit_count": 0,    "total_vcpu_milli": 0,    "free_vcpu_milli": 0,    "total_mem_mb": 0,    "free_mem_mb": 0,    "total_ssd_gb": 0,    "free_ssd_gb": 0,    "service_reserved_vcpu_milli": 0,    "service_reserved_mem_mb": 0,    "total_vgpu_slices": 0,    "free_vgpu_slices": 0,    "largest_free_vgpu_slices": 0,    "total_gpu_mem_mb": 0,    "free_gpu_mem_mb": 0,    "largest_free_gpu_mem_mb": 0,    "monthly_burn_dollars": 0.1,    "monthly_revenue_dollars": 0.1,    "months_until_cash_out": 0.1,    "cash_minute": [      0    ],    "revenue_minute": [      0    ],    "cost_minute": [      0    ]  },  "customers_summary": {    "active": 0,    "at_risk": 0,    "prospects": 0,    "mrr_total_cents": 0,    "filter_counts": {      "everyone": 0,      "at_risk": 0,      "top": 0,      "prospects": 0    },    "attributed_cost_dollars": 0.1,    "unattributed_cost_dollars": 0.1,    "overhead_dollars": 0.1,    "total_cost_dollars": 0.1  },  "active_incidents": [    {      "id": 0,      "root_kind": "string",      "root_entity_id": 0,      "rack_id": 0,      "root_msg_key": "string",      "root_msg_args": [        {          "key": "string",          "text": "string",          "number": 0.1,          "is_number": true        }      ],      "symptom_kind": "string",      "symptom_msg_key": "string",      "symptom_msg_args": [        {          "key": "string",          "text": "string",          "number": 0.1,          "is_number": true        }      ],      "symptom_customer_id": 0,      "confirmed": true,      "causes": [        {          "root_kind": "string",          "entity_id": 0,          "rack_id": 0,          "msg_key": "string",          "msg_args": [            {              "key": "string",              "text": "string",              "number": 0.1,              "is_number": true            }          ],          "confidence": 0,          "confirmed": true,          "cleared": true,          "articles": [            {              "id": "string",              "title": "string",              "title_plain": "string"            }          ]        }      ],      "started_at_ns": 0,      "last_changed_at_ns": 0,      "resolved_at_ns": 0,      "affected_customer_ids": [        0      ],      "affected_host_ids": [        0      ],      "affected_host_total": 0,      "revenue_at_risk_per_hour_dollars": 0.1,      "max_sla_tier": "string",      "compliance_at_risk": "string",      "redundancy_promise_broken": true,      "band": "string",      "timeline": [        {          "at_ns": 0,          "kind": "string",          "detail": "string"        }      ],      "work_order_ids": [        0      ],      "channel_thread_id": 0,      "articles": [        {          "id": "string",          "title": "string",          "title_plain": "string"        }      ],      "hint_tier": 0,      "hint": "string",      "evidence": [        {          "label": "string",          "label_plain": "string",          "value": "string",          "value_plain": "string",          "detail": "string",          "detail_plain": "string",          "leading": true        }      ]    }  ],  "active_incidents_total": 0,  "incidents_truncated": true,  "recent_resolved_incidents": [    {      "id": 0,      "root_kind": "string",      "root_entity_id": 0,      "rack_id": 0,      "root_msg_key": "string",      "root_msg_args": [        {          "key": "string",          "text": "string",          "number": 0.1,          "is_number": true        }      ],      "symptom_kind": "string",      "symptom_msg_key": "string",      "symptom_msg_args": [        {          "key": "string",          "text": "string",          "number": 0.1,          "is_number": true        }      ],      "symptom_customer_id": 0,      "confirmed": true,      "causes": [        {          "root_kind": "string",          "entity_id": 0,          "rack_id": 0,          "msg_key": "string",          "msg_args": [            {              "key": "string",              "text": "string",              "number": 0.1,              "is_number": true            }          ],          "confidence": 0,          "confirmed": true,          "cleared": true,          "articles": [            {              "id": "string",              "title": "string",              "title_plain": "string"            }          ]        }      ],      "started_at_ns": 0,      "last_changed_at_ns": 0,      "resolved_at_ns": 0,      "affected_customer_ids": [        0      ],      "affected_host_ids": [        0      ],      "affected_host_total": 0,      "revenue_at_risk_per_hour_dollars": 0.1,      "max_sla_tier": "string",      "compliance_at_risk": "string",      "redundancy_promise_broken": true,      "band": "string",      "timeline": [        {          "at_ns": 0,          "kind": "string",          "detail": "string"        }      ],      "work_order_ids": [        0      ],      "channel_thread_id": 0,      "articles": [        {          "id": "string",          "title": "string",          "title_plain": "string"        }      ],      "hint_tier": 0,      "hint": "string",      "evidence": [        {          "label": "string",          "label_plain": "string",          "value": "string",          "value_plain": "string",          "detail": "string",          "detail_plain": "string",          "leading": true        }      ]    }  ],  "active_work_orders": [    {      "id": 0,      "kind": "string",      "kind_label": "string",      "actor": "string",      "actor_staff_id": 0,      "started_at_ns": 0,      "last_progress_at_ns": 0,      "resolved_at_ns": 0,      "current_step": 0,      "steps": [        {          "kind": "string",          "detail": "string",          "started_at_ns": 0,          "completed_at_ns": 0,          "estimated_duration_ns": 0,          "actual_duration_ns": 0        }      ],      "blocking": "string",      "incident_id": 0    }  ],  "active_attack": {    "active": true,    "summary": "string",    "components": [      {        "vector": "string",        "magnitude": 0.1,        "unit": "string"      }    ],    "per_class": [      {        "class": "string",        "label": "string",        "label_eng": "string",        "blurb": "string",        "incoming": 0.1,        "mitigated": 0.1,        "residual": 0.1,        "mitigated_at_gateway": 0.1,        "mitigated_at_appliance": 0.1,        "edge_defensible": true,        "unit": "string"      }    ]  },  "active_macro_events": [    {      "id": 0,      "kind": "string",      "display_name": "string",      "started_at_ns": 0,      "ends_at_ns": 0,      "price_multipliers": [        {          "category": "string",          "multiplier": 0.1        }      ],      "lead_time_multiplier": 0.1,      "egress_cost_multiplier": 0.1,      "power_cost_multiplier": 0.1,      "customer_acquisition_multiplier": 0.1,      "forces_multi_region": true,      "broadband_churn_risk": true    }  ],  "degraded_control_planes": [    "string"  ],  "stranded_vms": [    {      "vm_id": 0,      "customer_id": 0,      "customer_name": "string",      "host_id": 0,      "host_display_name": "string",      "az_id": 0,      "vcpu": 0,      "memory_mb": 0,      "block_gb": 0,      "block_iops": 0    }  ],  "service_gates": [    {      "class_tag": "string",      "label": "string",      "label_eng": "string",      "enabled": true,      "unlock_cost_dollars": 0.1,      "affordable": true    }  ],  "service_planes": [    {      "class_tag": "string",      "label": "string",      "label_eng": "string",      "control_plane_host_ids": [        0      ],      "replicas_configured": 0,      "replicas_floor": 0,      "shards": 0,      "serving_hosts": 0,      "healthy": true,      "degraded": true,      "overloaded": true,      "need_vcpu_milli": 0,      "need_mem_mb": 0,      "agent_vcpu_milli": 0,      "agent_mem_mb": 0    }  ],  "pending_growth_requests": [    {      "id": 0,      "customer_id": 0,      "customer_name": "string",      "at_ns": 0,      "class_tag": "string",      "additional_units": 0,      "additional_vcpu_milli": 0,      "additional_mem_mb": 0,      "resize_add_vcpu": 0,      "resize_add_memory_mb": 0,      "viral": true,      "resolution": "string",      "fit_vcpu_after_pct": 0.1,      "fit_can_serve_now": true,      "fit_oversubscribed": true,      "fit_recommendation": "string",      "segment_name": "string",      "segment_vni": 0,      "segment_dedicated_hosts": 0,      "segment_free_vcpu_milli": 0,      "segment_total_vcpu_milli": 0,      "segment_free_mem_mb": 0,      "segment_total_mem_mb": 0    }  ],  "pending_customer_requests": [    {      "id": 0,      "customer_id": 0,      "customer_name": "string",      "kind": "string",      "summary": "string",      "accept_label": "string",      "decline_label": "string",      "opened_at_ns": 0,      "expires_at_ns": 0,      "resolution": "string"    }  ],  "pending_bond_requests": [    {      "id": 0,      "cable_ids": [        0      ],      "owner_pair_label": "string",      "posted_at_ns": 0,      "expires_at_ns": 0,      "resolution": "string"    }  ],  "proposed_bond_groups": [    {      "cable_ids": [        0      ],      "owner_pair_label": "string"    }  ],  "cost_breakdown": {    "host_capex_dollars": 0.1,    "switch_capex_dollars": 0.1,    "appliance_capex_dollars": 0.1,    "patch_panel_capex_dollars": 0.1,    "edd_capex_dollars": 0.1,    "gateway_capex_dollars": 0.1,    "rack_capex_dollars": 0.1,    "cable_capex_dollars": 0.1,    "region_capex_dollars": 0.1,    "az_capex_dollars": 0.1,    "peering_capex_dollars": 0.1,    "facility_upgrade_capex_dollars": 0.1,    "staff_signing_dollars": 0.1,    "component_capex_dollars": 0.1,    "uplink_activation_capex_dollars": 0.1,    "service_unlock_dollars": 0.1,    "staff_severance_dollars": 0.1,    "host_hourly_dollars": 0.1,    "switch_hourly_dollars": 0.1,    "power_bill_dollars": 0.1,    "facility_rent_dollars": 0.1,    "uplink_monthly_dollars": 0.1,    "cable_opex_dollars": 0.1,    "peering_monthly_dollars": 0.1,    "staff_salary_dollars": 0.1,    "egress_cost_dollars": 0.1,    "service_debt_dollars": 0.1,    "churn_penalty_dollars": 0.1,    "sla_credits_dollars": 0.1,    "eviction_fee_dollars": 0.1,    "asset_disposal_dollars": 0.1,    "total_recurring_dollars": 0.1,    "total_capex_dollars": 0.1,    "total_asset_disposal_dollars": 0.1,    "total_depreciation_dollars": 0.1  },  "cost_rates": {    "host_hourly_dollars": 0.1,    "switch_hourly_dollars": 0.1,    "power_bill_dollars": 0.1,    "facility_rent_dollars": 0.1,    "uplink_monthly_dollars": 0.1,    "cable_opex_dollars": 0.1,    "peering_monthly_dollars": 0.1,    "staff_salary_dollars": 0.1,    "service_debt_dollars": 0.1,    "transit_egress_dollars": 0.1,    "total_dollars": 0.1,    "depreciation_dollars": 0.1,    "elapsed_months": 0.1,    "avg_egress_cost_dollars": 0.1,    "avg_sla_credits_dollars": 0.1,    "avg_churn_penalty_dollars": 0.1,    "avg_eviction_fee_dollars": 0.1  },  "revenue_breakdown": {    "functions_dollars": 0.1,    "vms_dollars": 0.1,    "object_store_dollars": 0.1,    "load_balancer_dollars": 0.1,    "managed_db_dollars": 0.1,    "cdn_dollars": 0.1,    "k8s_dollars": 0.1,    "platform_fee": 0.1,    "signup_bonuses_dollars": 0.1,    "reservation_prepay_dollars": 0.1  },  "financing_breakdown": {    "quest_rewards_dollars": 0.1,    "bailout_injection_dollars": 0.1,    "relocation_grant_dollars": 0.1,    "total_financing_dollars": 0.1  },  "spares": {    "on_hand": [      {        "kind": "string",        "count": 0      }    ],    "pending_orders": [      {        "kind": "string",        "sku_name": "string",        "spec_label": "string",        "ordered_at_ns": 0,        "arrives_at_ns": 0,        "paid_dollars": 0.1      }    ],    "catalog": [      {        "kind": "string",        "kind_label": "string",        "sku_name": "string",        "spec_label": "string",        "effective_capex_dollars": 0.1,        "baseline_lead_hours": 0,        "effective_lead_hours": 0      }    ]  },  "migration": {    "active": true,    "seconds_left": 0.1,    "window_seconds": 0.1,    "tenants_remaining": 0,    "site_display_name": "string"  },  "relocation": {    "available": true,    "next_site_id": "string",    "next_site_display_name": "string",    "ready": true,    "gates": [      {        "label": "string",        "current": "string",        "target": "string",        "met": true      }    ],    "funding_grant_dollars": 0.1,    "estimated_liquidation_dollars": 0.1,    "projected_new_capital_dollars": 0.1,    "windows": [      {        "key": "string",        "label": "string",        "hours": 0      }    ],    "tenants": [      {        "customer_id": 0,        "name": "string",        "tier": "string",        "monthly_dollars": 0.1,        "patience_hours": 0      }    ]  },  "guidance": {    "active": true,    "target": "string",    "target_id": 0,    "target_kind": "string",    "shop_section": "string",    "label": "string",    "quest_id": 0  },  "loop_stats": {    "prospects_arrived": 0,    "prospects_accepted": 0,    "prospects_rejected": 0,    "prospects_expired": 0,    "customers_churned": 0,    "sla_breaches": 0,    "host_failures": 0,    "rep_milestones_up": 0,    "rep_milestones_down": 0,    "customer_praises": 0,    "services_invested": 0,    "requests_raised": 0,    "requests_accepted": 0,    "requests_declined": 0,    "requests_lapsed": 0,    "reputation": 0.1,    "reputation_min": 0.1,    "reputation_max": 0.1,    "avg_satisfaction": 0.1,    "active_customers": 0  },  "siem_logs": {    "active": true,    "log_volume": 0.1,    "retention_window": "string",    "source_count": 0,    "storage_capacity_tb": 0.1,    "storage_used_tb": 0.1,    "daily_burn_tb": 0.1,    "retention_days": 0.1,    "events_recent": [      {        "summary": "string",        "at_ns": 0,        "severity": "string",        "source": "string"      }    ],    "records": [      {        "at_ns": 0,        "severity": "string",        "facility": "string",        "template": "string",        "rule_id": "string",        "action": "string",        "source": "string",        "source_kind": "string",        "source_id": 0,        "customer_id": 0,        "customer_name": "string",        "src": "string",        "dst": "string",        "src_internal": true,        "dst_internal": true,        "proto": "string",        "count": 0,        "msg_key": "string",        "msg_args": [          {            "key": "string",            "text": "string",            "number": 0.1,            "is_number": true          }        ]      }    ],    "facets_severity": [      {        "key": "string",        "count": 0      }    ],    "facets_facility": [      {        "key": "string",        "count": 0      }    ],    "sources": [      {        "kind": "string",        "id": 0,        "label": "string",        "records": 0,        "last_seen_ns": 0      }    ]  },  "connection_health": null,  "recent_events": [    {      "at_ns": 0,      "kind": "string",      "msg_key": "string",      "msg_args": [        {          "key": "string",          "text": "string",          "number": 0.1,          "is_number": true        }      ],      "severity": "string",      "entity_kind": "string",      "entity_id": 0    }  ],  "log_tail": [    {      "at_ns": 0,      "msg": "string"    }  ]}

Response body

200Everything explaining the world's current health, in one consistent read

application/json

The whole diagnostic picture, in one consistent read.

meta*

Freshness envelope. Present on every response body, and mirrored onto the X-Sim-Age-Ms / X-Sim-Publish-Seq headers so a scraper can read it without parsing the body.

runtime*

Runner internals that no snapshot view carries. Read from lock-free atomics on the apply thread at publish time, never from Engine.

status*GameStatusView

Value in

"InProgress"
"Won"
"Lost"

topbar*

capacity*

Physical and compute headroom. The first thing to check when anything is unservable.

customers_summary*

Customers-lens pre-computed counters + filter pill counts. Folded from a single pass over the just-built customers Vec inside build_snapshot, so the renderer's customers grid doesn't re-walk the roster every 250 ms paint just to compute "ACTIVE / AT-RISK / PROSPECTS / MRR EST." + the per-pill counts. Ships engine-authoritative numbers — no chance of GDScript / engine drift on filter semantics.

MRR is in cents (u64) instead of dollars (f64) so the renderer's fingerprint-and-skip gate (_cust_summary_fp) is integer-exact — float jitter at the cent boundary won't defeat the gate. Renderer divides by 100.0 once at format time.

active_incidents*array<>

Capped at MAX_INCIDENTS; active_incidents_total is the true count.

active_incidents_total*integer

How many are actually open, regardless of how many are carried above.

Range0 <= value

incidents_truncated*boolean

True when active_incidents was truncated.

recent_resolved_incidents*array<>

Recently resolved, because "it keeps happening" is a different problem from "it is happening", and only the history distinguishes them.

active_work_orders*array<>

active_attack*

Fleet-wide live threat board (E5 — the security ops-lens reads this). One per snapshot. active is false when only the always-on ambient internet floor is present; per_class is still populated so the lens shows the baseline. Capnp-friendly: flat struct, per_class in fixed AttackClass::all() order.

active_macro_events*array<>

degraded_control_planes*array<string>

Named control planes running degraded. A common root cause of complaints that look unrelated to each other.

stranded_vms*array<>

VMs the engine could not place. Direct, specific, and invisible in every collection endpoint.

service_gates*array<>

service_planes*array<>

pending_growth_requests*array<>

pending_customer_requests*array<>

pending_bond_requests*array<>

proposed_bond_groups*array<>

cost_breakdown*

Lifetime spend ledger projected from Engine::cost_breakdown. All fields are running totals in dollars.

A purchase is not a cost, so this view describes TWO quantities

The asset ledger (cost-authority C3) took capital purchases out of Engine::total_cost: acquire_asset books capex to Engine::total_capex plus an asset row and never touches total_cost, and what a purchase contributes to the P&L is the CostKind::Depreciation charged off that ledger every billing tick.

So the old invariant — "a naive sum over these fields equals topbar.total_cost_dollars" — is false and must not be reintroduced. The sum is total_cost + total_capex - total_asset_disposal. Which term a bucket lands in is decided once, in CostBreakdown::split, and the three results ride this view as total_recurring_dollars / total_capex_dollars / total_asset_disposal_dollars. A UI that wants "what have I spent operating the business" reads total_recurring_dollars; one that wants "what have I sunk into hardware" reads total_capex_dollars. Adding them together is a category error.

Backward-looking only. What next month COSTS is CostRatesView, a separate struct on purpose: deriving a rate from accumulated spend is exactly the bug that made facility rent — a config constant — drift on screen tick to tick.

One field per CostBreakdown bucket, no exceptions. build_cost_breakdown destructures the engine struct exhaustively, so a new bucket is a compile error until it lands here too.

cost_rates*

What the business costs to run for one more month, per category, at TODAY's state. The forward-looking twin of CostBreakdownView.

Projected straight from Engine::monthly_cost_rates, which prices one month's metered quantities through the same rate_cost the charge pass uses — so a rate here equals what the engine will actually bill, scalers (opex lever, macro power/egress events) included. The renderer does NO cost arithmetic of its own.

The avg_* fields are the exception, and are named to say so: those categories are DISCRETE EVENTS with no rate (a penalty is not a monthly bill), so they carry a trailing average over elapsed_months instead. A UI that shows them must label them as estimates.

revenue_breakdown*

Lifetime revenue ledger split by service kind, projected from Engine::revenue_breakdown. Sum of fields equals topbar.total_revenue_dollars. Drives the dashboard's Services drilldown — each service's row reads its bucket here, tier-locked services that haven't been sold yet render at $0.

financing_breakdown*

Cash IN that is neither revenue nor cost, projected from Engine::financing_breakdown.

Exists so the Finance tab can explain a cash balance that revenue minus cost does not account for. A quest payout is not business the player won, and a bailout is a loan, so neither may read as revenue — but they moved the cash, and a finance screen that cannot say where it came from is the reason the reconciliation drift went unnoticed for so long.

spares*

migration*

Live status of an in-progress relocation migration window — drives the HUD countdown bar while carried tenants re-home on the fresh floor after a move. active is false outside a migration (client hides the widget); it also flips false early once every tenant is back Active.

relocation*

The offer to relocate to the next site (the funded-relocation model). available is false when the scenario has no next progression step (final tier / no ladder) — the client hides the relocate affordance. ready = every gate met. The money math (funding_grant + estimated liquidation = new_capital) and the per-tenant tenants list power the switch screen; the client does the per-window churn preview client-side.

guidance*

Onboarding wayfinding hint — computed per tick from the frontier ("Next") quest + live deploy state (buy → staged → deployed). active false = no hint. Godot resolves target to a world object and draws a marker + the label; keyframe-only (rides the full snapshot like relocation/migration, so no capnp / delta / protocol change). See sim_core::guidance.

loop_stats*

Run-scale game-loop measurement (see docs/TUNING.md) — counters tallied over the whole run plus a few derived "right now" readings. The instrument for checking the loop is in balance: arrivals vs accepts vs churn, breach rate, request resolution mix, the reputation envelope.

siem_logs*

SIEM (audit recorder) log feed for the security ops-lens. Populated only when at least one ApplianceKind::Siem is racked and online; otherwise active is false and the lens shows its "no SIEM racked" empty-state. log_volume is an ingest RATE in events/s (not a cumulative count) — it tracks the live security-event rate the fleet is emitting.

connection_health?null|

recent_events*array<>

Recent events, already resolved to English.

log_tail*array<>

The engine's own diagnostic log tail. NOT an event stream — a separate, deliberately flat surface, and often the only place an odd failure leaves a trace.

One consistent read of everything needed to explain a sick world.

Overview

Try the endpoint

Code example

Response example

Response body

A purchase is not a cost, so this view describes TWO quantities

On this page

A purchase is not a cost, so this view describes TWO quantities