Skip to content

docs: ADR-001 - out-of-process plugin transport via hashicorp/go-plugin + gRPC#100

Merged
mwaldheim merged 1 commit into
mainfrom
docs/88-adr-001-grpc-transport
May 23, 2026
Merged

docs: ADR-001 - out-of-process plugin transport via hashicorp/go-plugin + gRPC#100
mwaldheim merged 1 commit into
mainfrom
docs/88-adr-001-grpc-transport

Conversation

@mwaldheim
Copy link
Copy Markdown
Contributor

Summary

Adds the first Architecture Decision Record documenting the core architectural choice for the plugin system.

Closes #88

Changes

  • \docs/adr/README.md\ — ADR index
  • \docs/adr/ADR-000-template.md\ — reusable template for future ADRs
  • \docs/adr/ADR-001-grpc-plugin-transport.md\ — full ADR covering:
    • Architecture overview (host ↔ child process via UDS/Named Pipe)
    • Plugin categories (Provider, CICondition, CommitAnalyzer, ChangelogGenerator, FilesUpdater, Hooks)
    • Plugin discovery order (local .semrel dir → registry)
    • stdout/stderr contract
    • Versioning via proto package names
    • Alternatives rejected (Go plugin .so, in-process registry)

Checklist

…plugin + gRPC

Closes #88

- docs/adr/README.md: ADR index with link to ADR-001
- docs/adr/ADR-000-template.md: reusable template for future ADRs
- docs/adr/ADR-001-grpc-plugin-transport.md: full decision record covering
  architecture overview, plugin categories, discovery order, versioning,
  alternatives considered (go plugin .so, in-process registry)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: mwaldheim <mwaldheim@users.noreply.github.com>
@mwaldheim mwaldheim added area: plugin Plugin architecture priority: high High priority type: chore Maintenance / scaffolding area: architecture Core architectural decisions and ADRs labels May 22, 2026
Base automatically changed from feat/63-1-initial-scaffold-apache2 to main May 23, 2026 17:15
@mwaldheim mwaldheim merged commit 89fcfc2 into main May 23, 2026
@mwaldheim mwaldheim deleted the docs/88-adr-001-grpc-transport branch May 23, 2026 17:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: architecture Core architectural decisions and ADRs area: plugin Plugin architecture priority: high High priority type: chore Maintenance / scaffolding

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ADR-001: Out-of-process plugin transport via hashicorp/go-plugin + gRPC

1 participant