[rickyrombo]

Updates cmd/genesis-writer/ROLLOUT.md now that the API's new-chain queue and flusher are retired in favour of the mirror (#605, #608, #610).

Step 11: Start the mirror (replaces "Enable flushing"):

• the docker run invocation;
• what each flag means, including -start-height = new_chain_flush_from_block from MANIFEST.json;
• what /status reports;
• how each kind of refusal is handled:
  • track audio claimed by another account → attested automatically (feat(mirror): attest a refused track's own upload and retry #610);
  • writes the old indexer also rejected → -skip-tx after checking the live state;
  • anything else → stays halted;
• observed throughput.

Step 12: Switch the indexer, a zero-downtime handover:

• the mirror is at the tip;
• stop the old indexer at X;
• take H from the new block that holds the last mirrored transaction at or below X. This is exact because the mirror never reads old block X+1 until X has committed;
• start the new indexer at H+1;
• clear the bounds.

Steps 13–15:

• play routing can be reverted any time after the switch;
• the write switch happens only while the mirror is at the tip;
• the mirror is stopped once the old chain halts.

Appendices:

• G (plays) and I (the indexer boundary) are rewritten for the mirror;
• the relay/rollback reference drops the queue, api#1018 and the cursor discussion;
• "merge these first" swaps api#1018 for the mirror PRs.

The MANIFEST.json field keeps its name. Its Go comment now describes it as the mirror's start height. The only code change is a comment.

🤖 Generated with Claude Code