This page traces the project’s decisions, incidents, and documentation migration.
📚 The two logs
| Log | What it holds |
|---|---|
| 🏛️ Decision Log | Dated choices and the reasoning behind them, newest first |
| 🔥 Incident Log | Real failures, their root causes, and the safeguards they produced |
They are worth reading together: most of the durable decisions in this project were forced by a specific outage, and the incident log names which one.
🕰️ Timeline at a glance
| Period | Theme |
|---|---|
| Early, undated | Foundations — configuration unification, dependency injection, Pydantic v2, async CPU-only adapters |
| 2025-07 to 2025-08 | Stabilization and the local-first turn; serialization correctness |
| 2025-09 | Artifact structure, crew expansion, the zombie-process crisis and the liveness rules it produced |
| 2025-10 | Observability built in response to an undiagnosable outage; total-failure incident from three missing imports |
| 2025-11 to 2025-12 | Optimization and verification; the image-generation bottleneck identified and still open |
| 2026-02 | SFX provider chain reworked; truth-first documentation policy adopted |
| 2026-07 | Documentation migrated out of the repository into this wiki |
| 2026-08 | This wiki rebuilt from source, and sixteen blockers verified against code — four of them found by the rebuild itself |
📦 The pre-migration archive
On 2026-07-14 a bulk migration ingested 498 documents from the repository, emptied its docs/ and vault directories, and produced this wiki’s first skeleton. Those originals still exist, unpublished:
| Location | Contents |
|---|---|
wikis/stmx/source-archive/2026-07-14/ | 305 archived originals, content-addressed by name and hash |
wikis/stmx/protected-backend/ | 32 protected sources plus their manifest |
wikis/stmx/source-registry.json | Maps all 498 inputs to their disposition and successor page |
content/90-evidence/migration-manifest.json | 641 entries tracking archived, active and protected state |
They are deliberately not published, for three reasons. They are stale — several assert behaviour the code contradicts. They are heavily duplicated, with the same decision log appearing five times across parallel copies. And publishing roughly 340 additional pages would drown the explorer, the graph and search for no gain in truth.
The originals remain readable on disk for anyone auditing provenance, and 🧾 Evidence & Provenance explains how to trace a given page back to its inputs. Everything of durable value in them has been distilled into the two logs above.
⚠️ What the old documents get wrong
Worth knowing before reading any archived original, or the repository’s remaining prose:
| Claim in older documents | Actual state |
|---|---|
| Output is written to a directory named for plural outputs | The configured default is out/ — see 🏃 Runbook |
| Various protocols and phases are “100% complete” | Sixteen blockers are open and no pipeline run completes on this checkout — see 🗺️ Roadmap |
| The suite sits at roughly 79.5% with two errors | Twelve errors, and a pass rate near 85% that varies by one flaky test — see 🧪 Testing |
| Configuration precedence is a simple four-tier override | The mechanism differs from the outcome — see ⚙️ Configuration |
This is not a criticism of the authors; it is the ordinary result of documentation written per-session and never reconciled. It is also precisely why this wiki cites code paths for every claim.
🔗 Related
- 🎬 SSOT — current status and the full contradictions table
- 🧾 Evidence & Provenance — how claims are tracked and verified
- ⚖️ Key Decisions — the architectural rules these decisions produced