docs: reconcile SPEC with turn-span, install modes, self-upgrade, and the journal#5
Merged
Merged
Conversation
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
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.
Summary
Dedicated spec-update session folding four changes of accumulated drift back into
SPEC.md, per the ADRs' SPEC-impact lists:Notificationas the seventh hook event withnotification_typein the line schema, the supervisor-loop pseudocode rewritten, andSTANDARD_TIMEOUT/COMMIT_TIMEOUT/GC_THRESHOLDreplaced bySAFETY_CAP/AWAITING_INPUT_GRACEin the constants list.install/uninstallCLI section (three install modes, atomic-rename replacement, the.disabledstand-down), and the self-upgrade and disable-flag exits added to "Self-exit & crash recovery" and the loop.daemon, the decision line and staleness verdict understatus,JOURNAL_*constants, andjournal.rsin the module list.hold_sincecounting battery time only, and the battery-cap-as-veto invariant.install.rs/journal.rs, the bash-hook migration section is marked completed (2026-07-11), the unit-test and scenario lists match the current suite, and ADR-0013/0014 SPEC-impact sections are marked applied.Test plan
main(94a458f): constants matchconfig.rs, the loop pseudocode matchesdaemon::run, the awaiting-input type set matchesevent.rsSTANDARD_TIMEOUT,COMMIT_TIMEOUT,GC_THRESHOLD, staleness-as-release, six-hook references): none remain