Documentation

Leading documents for the engine. Single source of truth: ENGINE_SSOT.md; overview: DOC_INDEX.md. Click a document to see the full content, including Mermaid diagrams.

TopicDocument
Architecture

Current engine architecture — modules, dataflow, execution lifecycle.

ARCHITECTURE_ENGINE_CURRENT.md
Engine changelog

Technical changelog per subsystem.

CHANGELOG_ENGINE.md
DB architecture

State-first, partitioning, generation, stale-edge prevention.

DB_ARCHITECTURE_STALE_EDGE_SAFE.md
Document index

Which documents are leading and which are historical.

DOC_INDEX.md
Engine SSOT

Engine status, status matrix, runtime topology (incl. Mermaid diagram).

ENGINE_SSOT.md
Runbook

Operational runbook — ingest, execution attach, markers.

LIVE_RUNBOOK_CURRENT.md
Logging

Logging structure and markers.

LOGGING.md
Observability contract

Contract between the bot and the website (snapshots).

OBSERVABILITY_SNAPSHOT_CONTRACT.md
Systemd units

Service overview for ingest/execution/export and operational startup order.

SYSTEMD_README.md
Validation model

Bootstrap/attach/evaluation/lifecycle proof.

VALIDATION_MODEL_CURRENT.md
15-min validation

Proof-run with refresh/reset checks and expected outcomes.

VALIDATION_REPORT_REFRESH_15MIN_RESET.md