Skip to content

docs(adr): add ADR-0011 internal/api decomposition + fix ADR index drift - #449

Merged
krisarmstrong merged 2 commits into
mainfrom
docs/stem-adr0011-api-decomposition
Jun 16, 2026
Merged

docs(adr): add ADR-0011 internal/api decomposition + fix ADR index drift#449
krisarmstrong merged 2 commits into
mainfrom
docs/stem-adr0011-api-decomposition

Conversation

@krisarmstrong

@krisarmstrong krisarmstrong commented Jun 16, 2026

Copy link
Copy Markdown
Collaborator

Summary

Add ADR-0011 documenting the decision to decompose stem's flat internal/api into isolated leaf packages (ratelimit→sse→tls→handlers), mirroring niac ADR-0006 + seed's strangle. Also restore the missing 0009/0010 rows to the ADR index.

Linked Issue

Related to #450

Testing Evidence

Doc-only change (ADR + index). No code; test suite not run.

Security and Release Checklist

  • Documentation only — no code, no behavior change
  • No secrets; no new deps

Documents the decision to strangle stem's flat internal/api into isolated
leaf packages (ratelimit -> sse -> tls, then capability handlers), mirroring
seed's strangle + niac ADR-0006. Each leaf is stdlib+inward-only with a
CI-enforced api-<concern>-isolated depguard rule; snake_case filenames go
away as a consequence; port check-filename-policy.sh once they're gone.

Also restores the missing 0009 + 0010 rows to the ADR index (doc drift).
@krisarmstrong
krisarmstrong enabled auto-merge (squash) June 16, 2026 13:56
@github-actions

Copy link
Copy Markdown
Contributor

License Compliance Report

All dependencies pass license compliance checks

Go Dependencies

  • Unknown: 31 package(s)
  • MIT: 26 package(s)
  • BSD-3-Clause: 16 package(s)
  • Apache-2.0: 11 package(s)
  • BSD-2-Clause: 1 package(s)

npm Dependencies

See full report in workflow artifacts

Allowed Licenses: MIT, Apache-2.0, BSD-*, ISC, CC0-1.0, MPL-2.0
Forbidden: GPL, AGPL, SSPL (strong copyleft)

@github-actions

Copy link
Copy Markdown
Contributor

License Compliance Report

All dependencies pass license compliance checks

Go Dependencies

  • Unknown: 31 package(s)
  • MIT: 26 package(s)
  • BSD-3-Clause: 16 package(s)
  • Apache-2.0: 11 package(s)
  • BSD-2-Clause: 1 package(s)

npm Dependencies

See full report in workflow artifacts

Allowed Licenses: MIT, Apache-2.0, BSD-*, ISC, CC0-1.0, MPL-2.0
Forbidden: GPL, AGPL, SSPL (strong copyleft)

@krisarmstrong krisarmstrong changed the title docs(adr): ADR-0011 internal/api decomposition + fix ADR index drift docs(adr): add ADR-0011 internal/api decomposition + fix ADR index drift Jun 16, 2026
@krisarmstrong
krisarmstrong merged commit f7caee7 into main Jun 16, 2026
29 of 30 checks passed
@krisarmstrong
krisarmstrong deleted the docs/stem-adr0011-api-decomposition branch June 16, 2026 14:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant