Docs: fix operations-runbook drift — artifact-only updates, real release-workflow shape, cursor in preflight - #865
Merged
Conversation
…release-workflow shape, cursor in preflight - The update flow's build-from-source fallback was removed in #693; the runbook still described an artifact-first-with-fallback deploy. Now documents the artifact-only path and the corrupt-cache-retry behavior. - The release workflow section claimed a single 'pnpm run ci' pass and a tag created with the version-bump commit. Documented the actual pipeline: prepare (bump incl. browser-extension manifest, notes, push to main) -> verify (check/lint/unit tests) -> signed+notarized builds -> Linux+macOS smoke tests -> publish, where 'gh release create' is what mints the tag. - Preflight optional-dependency list was missing Cursor's 'agent' binary (#684). - Noted force:true also bypasses the 503 migration-evaluation gate. 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.
Nightly docs audit (deep-dive:
docs/10-operations-runbook.md, stalest surface since ~2026-06-12).Audited: service management (
bin/dispatch-server,bin/install-launchd, launchd commands), per-install state paths, release trigger flow (release-runtime.tsphases, admin gate), update flow gating + deploy (routes/release.ts,release-tarball-cache.ts), assisted-update flow (agent-type pick, phase axis, all fiverelease-checks.tscheck descriptions), diagnostics rotation constants (diagnostics.ts), config env-var table (config.ts), CI + release GitHub workflows, and the bin-scripts/file-locations tables.Fixed drift:
pnpm run cipass and a tag created with the version-bump commit. Replaced with the actual pipeline: prepare (bump incl. browser-extension manifest, notes, push to main) → verify (check/lint/unit tests) → signed+notarized builds → Linux+macOS smoke tests → publish, wheregh release createmints the tag.agentbinary (Add Cursor CLI to preflight check and setup docs #684).force: truealso bypasses the 503 migration-evaluation gate.Verified accurate (no change): dispatch-server subcommands, install-launchd steps (gh-download path is still correct there), all five assisted-update checks incl. post-#699
expected_runtime_artifact, 10 MB / 7-day / 14-day rotation claims, env-var defaults, restart commands (detached kickstart / systemctl --user), gitContext diagnostics.Deferred: docs-pane Notifications spot-check (sound-cue grid, Tips & Guidance) → next run.
🤖 Generated with Claude Code