Skip to content

docs: seed architecture/ with capability pages and glossary#18

Merged
lesnik512 merged 1 commit into
mainfrom
docs/seed-architecture
Jun 26, 2026
Merged

docs: seed architecture/ with capability pages and glossary#18
lesnik512 merged 1 commit into
mainfrom
docs/seed-architecture

Conversation

@lesnik512

Copy link
Copy Markdown
Member

First content for the architecture/ truth home established in #16 — documents existing behavior, no code change.

Capability pages

  • container-lifecycle.mdsetup_di, fetch_di_container, the lifespan reopen/close-across-cycles behavior, and build_di_container's per-connection scoped child containers (the Request → REQUEST / WebSocket → SESSION scope mapping + context injection).
  • dependency-resolution.mdFromDI / Dependency: how a route or WebSocket handler declares a dependency and resolves it against the request-scoped container; provider-vs-type resolution, use_cache, and reaching ACTION scope.
  • glossary.md — ubiquitous language: root vs child container, connection, scope mapping, context provider, dependency marker.
  • README.md — capability index.

Notes

  • Two capability files (not six per-symbol, not one mega-page) — the natural seam is lifecycle/scope wiring vs endpoint resolution.
  • Documenting existing behavior, so per the convention this is a docs chore with no change bundle; future behavior changes promote into these files in the same PR.

just check-planningplanning: OK; eof/lint clean.

🤖 Generated with Claude Code

Document existing behavior into the truth home (no code change):

- container-lifecycle.md — setup_di, the lifespan reopen/close, and
  build_di_container's per-connection scoped child containers.
- dependency-resolution.md — FromDI / Dependency and how endpoints resolve
  against the request-scoped container.
- glossary.md — root vs child container, connection, scope mapping, context
  provider, dependency marker.
- README.md — capability index.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@lesnik512 lesnik512 merged commit d9766e0 into main Jun 26, 2026
6 checks passed
@lesnik512 lesnik512 deleted the docs/seed-architecture branch June 26, 2026 18:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant