relay

Relay

Pass the baton to the next Sutando session. Where session-handoff.sh writes structured facts (recent commits, open PRs, pending Qs), /relay writes the narrative continuity — what you were just working on, what should be checked first, what might break and how to detect it.

Usage: /relay (writes a new relay file) or /relay --append (appends to the most recent unprocessed relay file rather than creating a new one).

Why this exists

src/session-handoff.sh pulls together the structured state for the next session — system status, recent commits, open PRs, pending questions, tasks, conversation tail, quota, repo stats — and writes it to session-state.md. But "I was about to land PR #X and Mini's review said Y matters most" isn't captured by git log, gh pr list, or src/pending_questions_reader.py list. The next session reads structured facts but has to RE-INFER the continuity, which costs context and frequently misses the load-bearing decision.

The relay note encodes intent + judgment — the thing only the LLM that lived through the session can write.

Folder layout

Mirrors Sutando's existing tasks/ and results/ convention:

workspace/relay/
├── relay-{YYYYMMDD}T{HHMMSS}Z.md  # pending relay notes (drained into session-state.md, then archived)
└── processed/
    └── relay-{YYYYMMDD}T{HHMMSS}Z.md # already drained; kept for audit

• File naming: relay-$(date -u +%Y%m%dT%H%M%SZ).md — UTC ISO basic form, e.g. relay-20260904T030402Z.md. Do not use the epoch form. session-handoff.sh drains with find ... -name 'relay-*.md' | sort, which is LEXICOGRAPHIC: every relay-17…/relay-18… epoch name sorts before every relay-2026… ISO name regardless of when it was written, so a single epoch-named note lands out of order among ISO ones. This file documented the epoch form while every note written since 2026-08-30 used ISO; the doc was the stale half.
• Multiple files allowed: /relay always creates a NEW file by default. --append appends to the LATEST unprocessed relay-*.md instead of creating a new one.
• Consumption: src/session-handoff.sh reads ALL unprocessed relay-*.md files in sorted order, appends them to session-state.md under ## Relay Notes (from prior sessions), then mvs each one to processed/ — but only after confirming its ### <basename> header landed in the written file, so an interrupt cannot retire an uncaptured note.
• Cleanup: kept indefinitely on local disk. Tiny files (~200-500 bytes each); a year of relay notes is < 1 MB. Sync via the workspace-sync engine (scripts/sync-workspace.sh) for fleet visibility — the legacy sync-memory.sh flow is deprecated in v0.3.0 and removed in v0.4.0.