musiclink/docs/work/2026-01-21-matrix-native-routing.md

1.3 KiB

Work: Matrix-Native MusicLink Routing

The Checklist

  • W001: Add Matrix-native configuration fields (matrix enabled/server/access token/user id/rooms/state store path) and load them in config parsing.
    • Verification: go test ./...
  • W002: Introduce Matrix client module with sync loop, room allowlist filtering, and bot self-message filtering.
    • Verification: go test ./...
  • W003: Implement thread-aware reply posting (m.in_reply_to + thread rel when applicable) and link parsing integration.
    • Verification: go test ./...
  • W004: Add SQLite-backed state store for sync token and processed event IDs with TTL cleanup.
    • Verification: go test ./...
  • W005: Implement outbound queue with retry/backoff honoring Matrix rate-limit responses.
    • Verification: go test ./...
  • W006: Add shadow mode logging and metrics/health reporting for sync status and send failures.
    • Verification: go test ./...
  • W007: Document Matrix-native mode in README/config examples (including non-E2EE constraint and allowlist behavior).
    • Verification: go test ./...

The Audit Trail

  • [2026-01-21] Work plan created.
  • [2026-01-21] W001-W007 completed. Verified with go test ./....