diff options
| author | Craig Jennings <c@cjennings.net> | 2026-01-24 17:29:24 -0600 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-01-24 17:29:24 -0600 |
| commit | 5d35df670a6780a12634e6f0ccbb918f53f355eb (patch) | |
| tree | d95ae425a1eb5c0a18d38fd70f6fa2f488bebdd7 /docs | |
| parent | 33ab3dba2cdba0c94f8dde7b421a2a2b0ec8dae3 (diff) | |
| download | archangel-5d35df670a6780a12634e6f0ccbb918f53f355eb.tar.gz archangel-5d35df670a6780a12634e6f0ccbb918f53f355eb.zip | |
Fix LUKS encryption for btrfs (single and multi-disk)
- Use -d - flag for cryptsetup stdin key input (matches easy-arch)
- Change ((i++)) to ((++i)) to avoid set -e exit on 0 increment
- Add btrfs-mirror-luks test config
- Update status protocol with sound notifications
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/protocols.org | 44 |
1 files changed, 33 insertions, 11 deletions
diff --git a/docs/protocols.org b/docs/protocols.org index 9c8a9b2..4ddfdef 100644 --- a/docs/protocols.org +++ b/docs/protocols.org @@ -254,27 +254,49 @@ When Craig says this phrase: ** Long-Running Process Status Updates -When monitoring a long-running process (rsync, large downloads, builds, etc.), provide status updates every 5 minutes. +When monitoring a long-running process (rsync, large downloads, builds, VM tests, etc.), follow this protocol: + +***At Start:*** +1. Run =date= to get accurate time +2. Announce the task/job beginning +3. Provide best-guess ETA for completion + +#+begin_example +**14:30** - Starting ISO build. ETA: ~10 minutes. +#+end_example + +***Every 5 Minutes:*** +- Check progress and display status in format: =HH:MM= - terse description - ETA + +#+begin_example +**14:35** - ISO build: packages installed, creating squashfs. ETA: ~5 min. +**14:40** - ISO build: squashfs 95% complete. ETA: ~1 min. +#+end_example + +***At Completion:*** +1. Play notification sound three times: + #+begin_src bash + paplay /usr/share/sounds/freedesktop/stereo/complete.oga + paplay /usr/share/sounds/freedesktop/stereo/complete.oga + paplay /usr/share/sounds/freedesktop/stereo/complete.oga + #+end_src +2. Provide summary of success or failure -***Format:*** #+begin_example -**14:32** - Rsync in progress: 312GB of 640GB transferred (~49%), ETA ~25 min -**14:37** - Rsync continuing: 389GB of 640GB (~61%), ETA ~18 min +**14:42** - ISO build complete. Size: 2.0G. Ready for testing. #+end_example ***Guidelines:*** -- Check in approximately every 5 minutes -- Include current time (run =date= to get accurate time) -- Brief description of what's happening -- Progress indication (percentage, files transferred, etc.) -- ETA when possible (even a ballpark estimate is helpful) -- Format doesn't need to be strict - just be descriptive -- If ETA cannot be determined, omit it rather than guessing wildly +- Always run =date= for accurate timestamps +- Keep progress descriptions terse but informative +- Update ETA as job progresses +- If ETA cannot be determined, say "ETA unknown" rather than guessing wildly ***Why This Matters:*** - Craig may be working on other things while waiting - Status updates provide confidence the process is still running - ETAs help with planning (e.g., "I have time for coffee" vs "stay close") +- Sound notification alerts Craig when he's away from the screen - If something stalls, the updates make it obvious ** "Wrap it up" / "That's a wrap" / "Let's call it a wrap" |
