# Synthetic Production Intelligence (SPI)

Evidence-backed orchestration for generative media production. Not a text-to-video wrapper: SPI
plans a production as structured state, renders it through swappable model backends, verifies
results with evidence-carrying metrics, and (planned) repairs only what failed.

## V0.1 status (Phase 1 — honest ledger)

| Component | Status |
|---|---|
| `ProjectState` (versioned, mutation log, transactional deltas) | **implemented** |
| Evidence schema (PASS/REPAIR/REGENERATE/REPLAN/REJECT/UNRESOLVED/BLOCKED, evidence mandatory) | **implemented** |
| `ProductionGraph` (DAG, topo sort, cycle rejection) | **implemented** |
| Scheduler (priority, deps, retries, timing, cache hits) | **implemented** (mock lane) |
| Mock renderers + GenerationCache (§58) | **implemented** |
| Level-1 deterministic verification + adaptive evaluator routing | **implemented** |
| EvidenceFusion + MasterArbiter | **implemented** |
| IntentEngine / IdeaEngine / ConceptEngine | **stubs** (deterministic, no LLM) — real versions Phase 5 |
| OutputCompiler | **stub** (draft manifest only) |
| Real video backend (Wan 2.2 primary, LTX-2 secondary) | **not started** — Phase 2 |
| WorldEngine, StoryGraph, CausalGraph, RepairEngine, DirectorSim/Bench, 4K, audio | **not started** |

See `docs/architecture.md` for the component map and `docs/research_report.md` for the Phase-2
backend decision (Wan 2.2, Apache-2.0; LTX-2 as fast secondary).

## Install & test

```bash
pip install -e ".[dev]"
pytest -q
```

Mock mode (`SPI_MODE=mock` equivalent: `SPIApi(mode="mock")`) needs no GPU.

## Minimal end-to-end (mock lane)

```python
from spi.api.server import SPIApi

api = SPIApi(mode="mock")
r = api.create_project("A cartographer returns to the lighthouse she haunted as a child; must: no dialogue")
pid = r["project_id"]
api.interpret_project(pid)                      # intent + constraints + idea budget
api.commit_concept(pid, "IDEA_001")
api.compile_production(pid)                     # scenes -> shots -> generation DAG
api.render_draft(pid)                           # mock renderer, cached
verdict = api.evaluate_draft(pid)               # level-1 checks -> fusion -> arbiter
assert verdict["status"] in ("PASS", "REPAIR")
print(verdict["status"], verdict["evidence"][:1])
```

## Operating modes

- `SPI_MODE=mock` — zero GPU, deterministic artifacts (current default)
- `SPI_MODE=small` — reserved for Wan 2.1-1.3B / LTX-Video-2B smoke tests (Phase 2)
- `SPI_MODE=production` — reserved for Wan 2.2 A14B (Phase 2+)

## Budget policy

This repo is developed under `SPI_INTERN_MODE=ultra_low`: mock-first, cached research
(`docs/model_registry.json`), no training without explicit justification, one smoke test only
when necessary. Usage is tracked in `artifacts/resource_ledger.json`.

## License

Code: Apache-2.0. Model backends carry their own licenses — see the registry.