docs: add M7-003 through M7-007 Matrix architecture sections #326

jason.woltje · 2026-03-23T01:25:53Z

jason.woltje commented

2026-03-23 01:25:53 +00:00

Summary

Extends with five new architecture sections covering the Matrix-specific design for Phase 10 implementation:

M7-003: Matrix integration design — Conduit homeserver, appservice registration, room↔conversation mapping, Space↔team mapping, agent ghost users, and power levels.
M7-004: Conversation multiplexing — gateway as single source of truth, Valkey pub/sub fanout to TUI/WebUI/Matrix simultaneously, conflict resolution rules.
M7-005: Remote auth bridging — token linking ( DM flow), OAuth bridge alternative, invite-based provisioning, persistent session lifecycle.
M7-006: Agent-to-agent communication via Matrix — dedicated agent pair rooms, structured JSON payloads in Matrix events, coordination patterns (request/response, broadcast, delegation), gateway mediation.
M7-007: Multi-user isolation — Space-per-team architecture, room visibility rules, encryption defaults per Space type, admin visibility boundaries, configurable data retention policy.

Test plan

Architecture document is prose-only; no code changes.

mosaic-stack@ format:check /home/jwoltje/src/mosaic-mono-v1
prettier --check "**/*.{ts,tsx,js,jsx,json,md}"

Checking formatting...
All matched files use Prettier code style! passes (verified).

Content reviewed against task requirements M7-003 through M7-007.

Closes: internal tasks M7-003, M7-004, M7-005, M7-006, M7-007

🤖 Generated with Claude Code

## Summary Extends with five new architecture sections covering the Matrix-specific design for Phase 10 implementation: - **M7-003**: Matrix integration design — Conduit homeserver, appservice registration, room↔conversation mapping, Space↔team mapping, agent ghost users, and power levels. - **M7-004**: Conversation multiplexing — gateway as single source of truth, Valkey pub/sub fanout to TUI/WebUI/Matrix simultaneously, conflict resolution rules. - **M7-005**: Remote auth bridging — token linking ( DM flow), OAuth bridge alternative, invite-based provisioning, persistent session lifecycle. - **M7-006**: Agent-to-agent communication via Matrix — dedicated agent pair rooms, structured JSON payloads in Matrix events, coordination patterns (request/response, broadcast, delegation), gateway mediation. - **M7-007**: Multi-user isolation — Space-per-team architecture, room visibility rules, encryption defaults per Space type, admin visibility boundaries, configurable data retention policy. ## Test plan - [ ] Architecture document is prose-only; no code changes. - [ ] > mosaic-stack@ format:check /home/jwoltje/src/mosaic-mono-v1 > prettier --check "**/*.{ts,tsx,js,jsx,json,md}" Checking formatting... All matched files use Prettier code style! passes (verified). - [ ] Content reviewed against task requirements M7-003 through M7-007. Closes: internal tasks M7-003, M7-004, M7-005, M7-006, M7-007 🤖 Generated with [Claude Code](https://claude.com/claude-code)

jason.woltje added 1 commit 2026-03-23 01:25:54 +00:00

docs: add M7-003 through M7-007 Matrix architecture sections to channel-protocol.md

ci/woodpecker/push/ci Pipeline failed

Details

ci/woodpecker/pr/ci Pipeline failed

Details

86fb4aa7cc

Extends the channel protocol architecture document with five new sections:
Matrix integration design (homeserver, appservice, room/space mapping, ghost
users, power levels), conversation multiplexing (gateway as source of truth,
real-time fanout, conflict resolution), remote auth bridging (token linking,
OAuth bridge, invite provisioning, session lifecycle), agent-to-agent
communication via Matrix (dedicated rooms, structured JSON payloads,
coordination patterns, gateway mediation), and multi-user isolation
(space-per-team, room visibility, encryption defaults, admin visibility,
data retention policy).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

jason.woltje merged commit dfaf5a52df into main

2026-03-23 01:26:17 +00:00

jason.woltje referenced this issue from a commit

2026-03-23 01:26:17 +00:00

docs: add M7-003 through M7-007 Matrix architecture sections (#326)

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: mosaicstack/stack#326