docs(runbooks): corrections from the 2026-06-10 update-loop run - #354
Merged
Conversation
- update-loop §1.7: tail the real signal sources (.err.log / monitor.log / heartbeat age) — the .out.log files are empty by design; note that §1.4 shutdown residue (KeyboardInterrupt / cancelled-connect TimeoutError) is expected and only post-start tracebacks matter. - update-loop §1.1: scan pulled commits touching scripts/services/ for deploy notes — installer edits don't reconfigure installed services. - troubleshooting §8.12: new gotcha for live SCM/NSSM config drifting from the installers (observed deploying ALP-945's sc.exe config step). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Self-correction PR from tonight's
/operate-prod updaterun (deploying3f10c8e3..ac2e6dc7).What diverged
update-loop § 1.7 tailed files that are always empty. The three
.out.logs are 0 bytes by design — every daemon logs to stderr. Rewritten to tailpipeline.err.log/monitor.log/command_center.err.log, check heartbeat age against the 150 s stall bound, and state what each healthy tail looks like. Also documents that § 1.4's own stop writesKeyboardInterrupt/ cancelled-connectTimeoutErrortracebacks into the tails — only post-start tracebacks matter, so the old "no traceback in the last 60 s" rule false-alarmed on a clean deploy.Installer-script changes don't reconfigure installed services. PR fix(execution): remove CC's SCM dependency edges so the monitor watchdog's restart isn't refused (ALP-945) #350 deleted the CC's
DependOnServiceedges from its installer, but the live SCM config kept both edges until the one-timesc.exe config AlphaMindCommandCenter depend= /from the commit's deploy note was applied. update-loop § 1.1 now says to scan pulled commits touchingscripts/services/for deploy notes; troubleshooting gains § 8.12 with the verified example.Docs-only; guard tests (
tests/docs/, incl.test_runbook_section_refs_resolve) pass locally.🤖 Generated with Claude Code