dan/ops-jrz1
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity
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

2.2 KiB
Raw Blame History

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