adr: gateway — Matrix (continuwuity) + mautrix-go, separate Go gateway process#34
Open
cyber-ayi wants to merge 1 commit into
Open
adr: gateway — Matrix (continuwuity) + mautrix-go, separate Go gateway process#34cyber-ayi wants to merge 1 commit into
cyber-ayi wants to merge 1 commit into
Conversation
…y process Resolve the operator↔agent channel decision (operator-acked 2026-06-25, multi-agent third-party gateway + SDK review). - decisions/adr-pending-37140cf6-gateway-matrix-mautrix-go.md — Matrix, self- hosted continuwuity, federation-off, plaintext, E2EE-off; SDK = mautrix-go pure client (not bridgev2) as a thin Go gateway process over the IPC seam. Python co-location downgraded to soft preference; polyglot 2→3 langs. Rejected: AstrBot (transport-not-brain), Telegram/Discord (adr-0005, non-E2EE cloud), Signal (pseudo-self-host), matrix-nio / mautrix-python (ailing SDKs). XMPP+slixmpp kept as swappable fallback. - exploration/gateway-selection.md — resolved → this ADR; supersedes the prior AstrBot-over-Discord lean. - ROADMAP.md — gateway gate + Open-explorations row updated. Session-Id: 019f02bb-6523-7115-a7b6-3fe0adfdda4c Agent: cc-rc-bot Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Resolves [
exploration/gateway-selection.md] and the ROADMAP gateway gate. Operator-acked 2026-06-25 across a multi-agent third-party gateway + SDK review (a WebFetch summarizer hallucinated mautrix-go's license as AGPL — corrected to MPL-2.0 via the GitHub API).Decision
Matrix (self-hosted continuwuity, federation-off, plaintext rooms, E2EE-off) + mautrix-go pure client (not
bridgev2) run as a separate thin Go gateway process talking to the Python L3 over the IPC seam.Python co-locationdowngraded to a soft preference; polyglot goes 2 → 3 languages.Privacy = self-hosting + federation-off (content stays on our box), so the E2EE×bot friction is sidestepped by not running E2EE.
Why this over the prior AstrBot-over-Discord lean
A later pass made Discord a soft constraint and added Matrix/XMPP/Signal/Telegram:
Eliminates gateway-selection's "one real risk" (bypassing AstrBot's cognition) — a pure protocol has none.
Caveats recorded in the ADR
bus-factor=1 (tulir; Go doesn't fix it — pin + fork-ready); default reconnect fixed 10s (customize
Syncer.OnFailedSync); continuwuity↔tuwunel fork-churn (conduwuit archived 2026-05-29) — recheck active branch; gateway must stay thin (pure send/recv, no cognition).Files
decisions/adr-pending-37140cf6-gateway-matrix-mautrix-go.md(numbered on merge)exploration/gateway-selection.md— resolved → this ADRROADMAP.md— gateway gate + Open-explorations rowDepends conceptually on the L2 harness ADR (#33) but touches disjoint files — no merge conflict.
🤖 Generated with Claude Code