mosaic/stack
1
0
Fork 0
Code Issues 10 Pull Requests Actions Packages Projects Releases 2 Wiki Activity

Documentation: Matrix bridge setup and architecture #386

New Issue
Closed
opened 2026-02-15 07:02:19 +00:00 by jason.woltje · 1 comment
jason.woltje commented 2026-02-15 07:02:19 +00:00
Owner
Copy Link

Summary

Document the Matrix bridge integration — setup guide, architecture decisions, and operational notes.

Content

README / Setup Guide

  • Prerequisites (Synapse homeserver, bot account)
  • Environment variables reference
  • Quick start with docker-compose (dev)
  • Production deployment with external Synapse
  • Bot account creation and access token generation

Architecture Documentation

  • How Matrix bridge fits alongside Discord bridge
  • IChatProvider abstraction
  • Workspace → Room mapping
  • Herald multi-bridge broadcasting
  • Command flow diagram
  • Thread handling for job updates

Operational Notes

  • Running both bridges simultaneously
  • Migrating from Discord-only to Matrix
  • Troubleshooting connection issues
  • Synapse maintenance (database growth, media cleanup)

Acceptance Criteria

  • Setup guide in docs/ or README section
  • Architecture diagram showing bridge relationship
  • Environment variable reference complete
  • Troubleshooting section

Refs

## Summary Document the Matrix bridge integration — setup guide, architecture decisions, and operational notes. ## Content ### README / Setup Guide - Prerequisites (Synapse homeserver, bot account) - Environment variables reference - Quick start with docker-compose (dev) - Production deployment with external Synapse - Bot account creation and access token generation ### Architecture Documentation - How Matrix bridge fits alongside Discord bridge - IChatProvider abstraction - Workspace → Room mapping - Herald multi-bridge broadcasting - Command flow diagram - Thread handling for job updates ### Operational Notes - Running both bridges simultaneously - Migrating from Discord-only to Matrix - Troubleshooting connection issues - Synapse maintenance (database growth, media cleanup) ## Acceptance Criteria - [ ] Setup guide in docs/ or README section - [ ] Architecture diagram showing bridge relationship - [ ] Environment variable reference complete - [ ] Troubleshooting section ## Refs - EPIC: #377 - Depends on: all other M12 issues
jason.woltje added the docs label 2026-02-15 07:02:19 +00:00
jason.woltje added this to the M12-MatrixBridge (0.0.12) milestone 2026-02-15 07:02:56 +00:00
jason.woltje commented 2026-02-15 08:41:03 +00:00
Author
Owner
Copy Link

Completed in commit 68808c0 on branch feature/m12-matrix-bridge.

  • Created docs/MATRIX-BRIDGE.md (537 lines)
  • Quick start guide for dev environment
  • Architecture overview with service responsibilities
  • Command reference with examples
  • Configuration reference
  • Streaming response architecture
  • Deployment considerations
Completed in commit 68808c0 on branch feature/m12-matrix-bridge. - Created docs/MATRIX-BRIDGE.md (537 lines) - Quick start guide for dev environment - Architecture overview with service responsibilities - Command reference with examples - Configuration reference - Streaming response architecture - Deployment considerations
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
ai
AI/LLM integration
 api
Backend/API work
 api
auth
Authentication
 database
database
Database/schema work
 devops
Docker/deployment
 docs
Documentation
 frontend
graph
knowledge-module
migration
Data migration
 orchestrator
Orchestrator service (apps/orchestrator/)
 p0
Critical priority
 p1
High priority
 p2
Medium priority
 p3
Low priority
 performance
Performance work
 phase-1
phase-2
phase-3
phase-4
phase-5
plugin
MoltBot plugin work
 search
security
Security-related
 setup
Initial setup
 testing
Testing/QA
 web
Frontend work
No Label docs
Milestone
No items
No Milestone M12-MatrixBridge (0.0.12)
Projects
Clear projects
No project
Assignees
Clear assignees
jason.woltje
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mosaic/stack#386
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?