docs: record what the first preview canary taught the release runbook

[immakermatty]

Status: ready for review

Proč

První ostrý průchod DEV-6633 (preview 0.0.44-preview.20260930.1 → canary → stable 0.0.44-lazurio.1) ukázal, že runbook tvrdil něco, co neplatí, a chyběly mu dva kroky, bez kterých canary shodí službu.

Co se mění (jen docs/operations/lazurio-fork-release.md)

• Canary: lokální t3 update nejde přes trial ani zálohu databáze launcheru (Canary: t3 update přes SSH obchází launcherův trial a snapshot DB a nevidí kanál služby #22), proto záloha SQLite před updatem. Opraveno chybné tvrzení, že lokální cesta dělá trial.
• Změna protokolu launcheru (2 → 3 mezi v0.0.42 a v0.0.44): update bez restartu a přepnutí novým t3 service install. Oprava služby, kterou starý CLI shodil (Přechod z 0.0.42-lazurio.1: launcher protokol 2 → 3 blokuje tlačítko Update a lokální update se starým CLI shodí službu #25).
• Tlačítko Update funguje jen pod launcherem se stejným protokolem, jaký vyžaduje nová verze; jinak preflight update bezpečně odmítne a Mašina potřebuje jednorázový lokální převod nebo zvýšený pin v Machines.
• Rollback: při downgradu přes nové migrace obnovit i zálohu databáze.
• Desktop: zapsaný výsledek Matějova testu (Vanilla desktop a mobil nabízejí serverům z forku upstream verzi, kterou náš kanál nemá #26).

Co se nemění

Žádný kód, workflow ani kontraktní test. Vydání 0.0.44-lazurio.1 zůstává ze source 0d7c12f4; tenhle PR nic nevydává.

Ověření

vp fmt --check na souboru, node --test scripts/lazurio-release-contract.test.mjs 11/11. Postupy jsou ověřené živě na Spectoda VM101 a personal-immakermatty (#20).

Mission Control: DEV-6633 M6.

🤖 Generated with Claude Code

Confidence Score: 4/5

The PR should not merge until the emergency downgrade procedure specifies how to restore the database before starting the older service.

Findings

1.  Rollback starts before database restoration ▶

Summary

The PR updates the release runbook with lessons from the first preview canary, including a manual SQLite backup, launcher-protocol handoff, Update-button prerequisites, rollback guidance, and a desktop test result.

• The emergency rollback instructions need a safe database-restoration order.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart TD
  A[Back up canary database] --> B[Install preview without restart if protocol changes]
  B --> C[Install service with new CLI]
  C --> D{Canary healthy?}
  D -- Yes --> E[Release stable]
  D -- No; migrations ran --> F[Stop service]
  F --> G[Restore database and handle WAL sidecars]
  G --> H[Start compatible older service]

Loading

_{Reviews (1) · Last reviewed commit: "docs: record what the first preview cana..."}

[agentrozjedemeai]

@immakermatty Approved on the exact head 40eab44. Scope is only docs/operations/lazurio-fork-release.md. Checked the local-update/no-trial distinction, consistent pre-update SQLite backup, protocol-2-to-3 handoff and recovery, guarded Update button, and emergency downgrade ordering against the CLI source and canary issues #22/#25/#26. Local release contract: 11/11; git diff --check: clean. Four required PR checks green, no unresolved threads. Emergency cross-migration rollback is explicitly not yet exercised live. This review does not dispatch a release.