Package Journey — Overview

A developer installs openframe-core, wires it into a template, and serves a request. This section traces that journey end-to-end across four stages.

---

The Four Stages

flowchart LR
    TW["1. Template Wiring\ndeps.py assembles ports + adapters"]
    AL["2. Adapter Lifecycle\nconnect → health check → execute → close"]
    TF["3. Tracing Flow\nTracingProxy + TelemetryMiddleware produce spans"]
    EP["4. Error Propagation\nAdapterError → service → HTTP response"]

    TW --> AL --> TF --> EP

    style TW fill:#1a1a1a,color:#F0F0F0,stroke:#6DB33F
    style AL fill:#141414,color:#F0F0F0,stroke:#4E8A2A
    style TF fill:#141414,color:#F0F0F0,stroke:#4E8A2A
    style EP fill:#141414,color:#F0F0F0,stroke:#4E8A2A

Stage	Page	What it covers
Template Wiring	Template Wiring	How deps.py assembles settings, adapter, and TracingProxy
Adapter Lifecycle	Adapter Lifecycle	connect, is_ready(), execute, reconnect, close
Tracing Flow	Tracing Flow	How spans flow from middleware through proxy to adapter
Error Propagation	Error Propagation	How AdapterError becomes an HTTP response