Skip to content

docs(electron): add upgrading-electron.md monthly bump process doc - #247

Merged
h4yfans merged 1 commit into
mainfrom
debt/phase-6-u5-electron-doc
Apr 16, 2026
Merged

docs(electron): add upgrading-electron.md monthly bump process doc#247
h4yfans merged 1 commit into
mainfrom
debt/phase-6-u5-electron-doc

Conversation

@h4yfans

@h4yfans h4yfans commented Apr 16, 2026

Copy link
Copy Markdown
Collaborator

Part of Phase 6 Tech Debt Remediation — see .claude/plans/tech-debt-remediation.md § 6.5.

Summary

New docs/upgrading-electron.md codifying the monthly Electron minor-bump process:

  • Current state (Electron 39.8.6, @electron/rebuild 4.0.3, etc.)
  • Cadence (first Tuesday after stable)
  • Pre-bump checklist (changelog, Chromium bump, breaking changes, compat)
  • Execution steps (bump → install → native rebuild → typecheck → test → build → e2e → manual smoke → auto-updater)
  • Rollback via revert (no force-push)
  • Known gotchas — better-sqlite3 ERR_DLOPEN_FAILED, autoOpenLastVault silent failure, .nvmrc enforcement

Why

Electron bumps are where security patches ship. No written process = tribal knowledge = deferred bumps. Risk vector.

Test plan

  • Doc-only PR, no code to verify.

Documents the monthly Electron minor-bump process: pre-bump checklist,
execution steps, rollback, and known gotchas (native module ABI
mismatch symptoms + dual-path rebuild). References pnpm check:native
from Phase 6 U1 once it lands.

Plan: .claude/plans/tech-debt-remediation.md § 6.5
@h4yfans
h4yfans merged commit cec2ee9 into main Apr 16, 2026
2 checks passed
@h4yfans
h4yfans deleted the debt/phase-6-u5-electron-doc branch April 16, 2026 22:21
h4yfans added a commit that referenced this pull request May 6, 2026
)

Documents the monthly Electron minor-bump process: pre-bump checklist,
execution steps, rollback, and known gotchas (native module ABI
mismatch symptoms + dual-path rebuild). References pnpm check:native
from Phase 6 U1 once it lands.

Plan: .claude/plans/tech-debt-remediation.md § 6.5
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant