Skip to content

Startup Lifecycle and Dependency Bootstrap

Status: Implemented (See Dependency Injection) Date: 2026-03-07

Problem

The backend initializes external clients and service singletons at import time, which complicates startup behavior and test isolation.

Goal

Move client and service bootstrap behind an explicit application lifecycle with clear readiness and failure behavior.

Scope

  • App startup/bootstrap flow
  • Dependency provider boundaries
  • Readiness/failure semantics
  • Test import safety

Open Questions

  • Startup vs lazy provider split
  • Health/readiness behavior before dependency bootstrap completes