Runtime architecture
Evidence stays separate from events and belief.
APR turns observations into provenance-bearing evidence, routes unmet perceptual needs through a finite budget, and blocks action until explicit gates are met.
Runtime lineEvidence → Need → Gate → Outcome → Recovery
Evidence, event, belief
An event says something may have changed. Evidence records what was observed and where it came from. Belief is the runtime's current bounded world state. APR does not silently collapse these layers.
Need graph and perceptual budget
Unknown, stale, conflicting, or action-critical facts become explicit needs. Dependencies determine what can be observed next; budget is spent only when an observation is made.
- Unknown Request evidence for an unresolved fact.
- Budgeted Choose depth and channel within available attention.
- Observed Preserve source, confidence, age, and cost.
Action, outcome, recovery
The action gate checks freshness, contradiction, independence, risk, and semantic preconditions. Execution creates a receipt, not a success claim. Fresh post-action evidence drives verification and bounded recovery.
Source evidence
Immutable links pinned to the candidate source reference.
- runtime_architecture
docs/runtime/ARCHITECTURE.md - event_runtime
docs/runtime/EVENT_NATIVE_RUNTIME.md - need_graph
docs/runtime/PERCEPTUAL_NEED_GRAPH.md - budget
apr_runtime/budget.py - action_gate
docs/runtime/ACTION_READINESS_GATES.md - outcome
docs/runtime/ACTION_OUTCOME_VERIFICATION.md - recovery
docs/runtime/CLOSED_LOOP_RECOVERY.md