Files
coe-mirror/notes.md
T
n0mad1k c322488869 Implement real Matrix notification for coe-mirror
Replace stub notify() with full Synapse integration targeting General room.
- Add _send_matrix(), _get_matrix_token(), _matrix_login() helpers
- Implement token cache with 30-min refresh threshold and 401 retry
- Fetch credentials via Infisical (MATRIX_USER, MATRIX_PASSWORD from matrix/)
- Add MATRIX_* env overrides for testing (homeserver, room, token cache path)
- Non-fatal failures: Matrix outage logs warning, does not break mirror run
- Add 5 comprehensive test cases covering success, failure, 401 refresh, env override, chmod 600
- All 18 tests passing
- Update README and notes.md with implementation details
2026-06-14 14:36:14 -04:00

1.8 KiB

coe-mirror notes

  • Created: 2026-06-11. Purpose: autonomous mirroring of Nightmare_Eclipse repos from Church of Malware to local pCloud storage.
  • Source API: Forgejo public REST at git.churchofmalware.org, no auth needed.
  • Owner being mirrored: Nightmare_Eclipse (8 active repos as of creation).
  • Destination: ~/pCloudDrive/Hacking/Nightmare_Eclipse/.
  • Schedule: 00:00 + 12:00 daily, catch-up on boot via Persistent timer + OnBootSec.
  • Design rationale:
    • FUSE-safe placement uses shutil.copy2 + size verify + unlink, not os.rename, to handle pCloud FUSE semantics.
    • pCloud daemon auto-start was rejected — no user unit exists; DISPLAY=:0 spawning is unreliable. Tool relies on Persistent timer + pending-flush for recovery.
    • commit.sha is NOT in the repo-list API response — two-call approach (list, then per-repo branch) is retained.
  • DevTrack: Not created at creation time (oraculo offline, Tailscale last seen 2d ago, carbon roaming off home LAN). Add a coe-mirror project + item retroactively when oraculo returns.
  • Matrix notification: Stub-only at creation time, Matrix server down. Real implementation deferred until home Matrix server is back.

2026-06-14 — Matrix notification swap

  • Replaced notify() stub with real Synapse send. Targets General room (!MBpPtYlQYMcngtpvJt:m.mealeyfamily.com).
  • Auth: password login via MATRIX_USER + MATRIX_PASSWORD from Infisical matrix/ at refresh time. Token cache at ~/.local/share/coe-mirror/matrix-token.json (chmod 0600), refreshed when <30 min left or on 401.
  • Non-fatal failures — Matrix outage does not break the mirror.
  • Env overrides: COE_MIRROR_MATRIX_ROOM, COE_MIRROR_MATRIX_HOMESERVER.
  • Pre-deploy step: invite @intel-bot:m.mealeyfamily.com to General once Synapse is back. Without joined membership, sends will 403.
  • DevTrack: #1172.