# Simulation Theory Testing

Simulation theory probes are investigative blueprints designed to surface
glitches in the fabric of perceived reality. They combine quantum
instrumentation, citizen science reports, and guardian councils to detect
anomalies while maintaining narrative safety.

## Endpoints

- `GET /v1/consciousness/simulation-theory` — Lists active probes with
  diagnostic confidence scores, primary indicators, and known anomaly windows.
- `GET /v1/consciousness/simulation-theory/{slug}` — Returns a full anomaly
  protocol detailing detection layers, instrumentation, hypothesis matrices, and
  fail-safe procedures.

The BFF caches probe data to preserve fast responses (and tracing headers) when
the content service is degraded or offline.

## Probe Blueprint Structure

- **Anomaly Windows**: Signal patterns (e.g., sunset shimmer tears, timeline
  echoes) with instrumentation requirements and correlated incidents.
- **Detection Layers**: Multi-step verification pipelines that reduce false
  positives across quantum sensors, AR captures, and collective reports.
- **Instrumentation**: Quantum samplers, sensory arrays, perception audits, and
  environmental anchors that monitor reality integrity.
- **Fail-safe Protocols**: Rollback procedures, guardian escalation paths, and
  narrative continuity safeguards to mitigate observer distress.
- **Integration Practices**: Rituals and journaling prompts ensuring
  investigators ground insights and maintain collective coherence.

## SDK Usage

```ts
const client = new APIClient({ baseUrl, token });
const probes = await client.listSimulationProbes();
const detail = await client.getSimulationProbe(
  'reality-lattice-integrity-probe'
);
```

Both helpers propagate auth and tracing headers, bubbling structured error
payloads when probes are missing or anomaly data is unavailable.
