Architecture Decision Records (ADRs)¶

This index lists all significant architecture decisions for the pico-ioc project. Keep it sorted by ADR number.

ADR Index: - ADR-001: Native Asyncio Support — Accepted — ./adr-0001-async-native.md - ADR-002: Tree-Based Configuration — Accepted (Partially Superseded by ADR-010) — ./adr-0002-tree-based-configuration.md - ADR-003: Context-Aware Scopes — Accepted — ./adr-0003-context-aware-scopes.md - ADR-004: Observability Features — Accepted — ./adr-0004-observability.md - ADR-005: Aspect-Oriented Programming (AOP) — Accepted — ./adr-0005-aop.md - ADR-006: Eager Validation — Accepted — ./adr-0006-eager-validation.md - ADR-007: Built-in Asynchronous Event Bus — Accepted — ./adr-0007-event_bus.md - ADR-008: Explicit Handling of Circular Dependencies — Accepted — ./adr-0008-circular-dependencies.md - ADR-009: Flexible @provides for Static and Module-level Functions — Accepted — ./adr-0009-flexible-provides.md - ADR-010: Unified Configuration via @configured and ContextConfig — Accepted — ./adr-0010-unified-configuration.md - ADR-011: Extensible Component Scanning via Custom Scanners — Accepted — ./adr-0011-custom-scanners.md

Status legend: - Proposed: Under discussion, not yet binding. - Accepted: Approved and implemented or scheduled for implementation. - Superseded: Replaced by a newer ADR (referenced in both ADRs). - Partially Superseded: Some aspects are replaced by a newer ADR. - Deprecated: No longer recommended, kept for historical context. - Rejected: Explicitly not adopted.

Contributing a new ADR: - Use sequential numbering with 4 digits: adr-XXXX-slug.md (e.g., adr-0011-new-feature.md). - Place the file in this directory: ws/docs/adr/. - Keep the slug lowercase, words separated by hyphens. - Start with status Proposed; update to Accepted after approval. - If an ADR supersedes or deprecates another, clearly mark the relationship in both documents. - Update this README index with the new ADR, keeping the list sorted by number.

Recommended ADR content (minimal): - Title - Status - Date - Context - Decision - Consequences - References (optional)