# 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