fraqtal/agentic-dev
Template
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
f77e6ea881a8a2a1c63a0aee897e110616e9fae1
agentic-dev/docs/decisions/adr-002-di-framework.md
Danijel Martinek f77e6ea881 chore(template): clean-slate template snapshot from bb4a0c7 
Curated, product-agnostic snapshot of the post-story-04 tree: demo
content deleted, auth-only reference feature, web-next shell, all gates
green. Product-specific docs, ADRs 027-029, PRDs/epics/archive, editor
library traces, and product naming are curated out; generic template
repairs (coverage provider devDeps, root test:coverage script, live
lint fixes, root-only release-please) are kept. See TEMPLATE.md for
provenance, curation list, and usage.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016j8z4VHjedXDTjEDNg7qHK
2026-07-12 20:40:54 +02:00

1.1 KiB
Raw Blame History

ADR-002: InversifyJS for Dependency Injection

Status: Accepted

Context

Need DI for clean architecture. Options: InversifyJS, tsyringe, manual composition root.

Decision

InversifyJS with symbol-based resolution + targeted agent documentation.

Rationale

  • Scales to 20+ services with automatic dependency chain resolution
  • Built-in singleton/transient/request scopes
  • Middleware support for logging/tracing (Sentry integration)
  • Matches the Clean Architecture reference implementation
  • Agent readability gap (4/10 → 7/10) mitigated by resolution tables and step-by-step recipes in di/AGENTS.md
  • Familiar to developers from Java/C# backgrounds

Trade-offs

  • Requires reflect-metadata + decorator config in tsconfig
  • Symbol indirection harder to trace than plain functions
  • Extra dependency (inversify + reflect-metadata)

Update (2026-05-04)

The vertical-feature refactor preserved InversifyJS but moved from a single shared container in packages/core/src/di/ to per-feature containers in each feature package (packages/<feature>/src/di/container.ts). See ADR-008.