ops-jrz1/HANDOFF.md
Dan ae16db4898 Refresh musiclink integration docs and tooling
Use local musiclink flake input with Go 1.24.

Add matterbridge patch, routing docs, and deploy check script.
2026-01-21 22:52:39 -08:00

56 lines
2.2 KiB
Markdown

# Handoff Summary
**Goal:** Resolve MusicLink cross-room reposting and plan Matrix-native routing
**Timestamp:** 2026-01-21T17:41:35-08:00
## Current State
**MusicLink Bot Status:**
- Running as `@musiclink:clarun.xyz` (display name: "musiclink").
- Matterbridge patch applied for WebSocket payload size + link preview suppression.
- Matterbridge still running with `-debug` flag.
**Observed Issue:**
- Messages are reposted across rooms (including DM portal) because Matterbridge gateways are fan-out buses when multiple rooms share a gateway.
- Slack errors "Your message was not bridged: You're not logged in" were caused by missing relay user in portal room. Relay must be set per room with `!slack set-relay`.
**Rooms in Current Gateway:**
- `!whU7Geg7JPrBL5wHcW:clarun.xyz`
- `!dT40EUcemb8e6bPiig:clarun.xyz` (Dan/Vlad DM portal)
- `!DPQveBnfuDrbgOe6dm:clarun.xyz` (#music portal)
**Constraint:**
- Only one Slack app login/token is available (single Slack identity).
## Decisions & Direction
- Short-term isolation via one gateway per room is possible, but we decided to pursue a **Matrix-native MusicLink** implementation long-term to avoid Matterbridge fan-out entirely.
- Stakeholder summary and RFC created in ops-jrz1; design doc created in musiclink repo.
## Docs Added
- `docs/rfc-musiclink-room-routing.md` (ops-jrz1)
- `docs/musiclink-room-routing-stakeholder-summary.md` (ops-jrz1)
- `docs/design-matrix-native-routing.md` (musiclink repo)
## Next Steps
- [ ] Implement Matrix-native MusicLink in `/home/dan/proj/musiclink`:
- Choose SDK (mautrix-go vs matrix-nio).
- Add room allowlist config + sync state.
- Reply in same room/thread; ignore self messages.
- [ ] Plan migration: run Matrix-native mode in parallel, then disable Matterbridge.
- [ ] (Optional short-term) Remove DM portal from Matterbridge gateway to stop cross-posting.
- [ ] Remove `-debug` flag from `modules/musiclink.nix` once stable.
## Notes / References
- Relay login in mautrix-slack DB: `TSW76H2Q0-U01MYESTVSL` (Dan/Vlad). Portal `!DPQveBnfuDrbgOe6dm:clarun.xyz` had no relay set.
- `mautrix-slack` log showed errors: `Failed to get user login ... not logged in` for sender `@musiclink`.
## Repository Context
**Repo Root:** /home/dan/proj/ops-jrz1
**Branch:** main