Skip to content

briefings: mongodb-cluster still advertised the removed physical backup mode - #522

Merged
jacobecox merged 1 commit into
mainfrom
claude/briefing-mongo-physical
Aug 30, 2026
Merged

briefings: mongodb-cluster still advertised the removed physical backup mode#522
jacobecox merged 1 commit into
mainfrom
claude/briefing-mongo-physical

Conversation

@jacobecox

Copy link
Copy Markdown
Contributor

Documentation only — helm template output is byte-identical, so this is an in-place fix rather than a new version.

My error. While removing backup.mode: physical I edited the briefing from inside the worktree using a ../../briefings/ path, which resolves to the main worktree rather than the branch. The correction never reached the PR, so #521 merged with the briefing still:

  • describing "optional logical (mongodump) or physical (PBM) backups"
  • listing a {release}-mongo-physical-backup workload that no longer renders
  • carrying a trap that says the physical restore is "UNVERIFIED AND MAY BE ARCHITECTURALLY BLOCKED"

It is not unverified any more. It was measured and it cannot work: PBM's physical restore must execute mongod, and the pbm-agent image does not contain it — check mongod binary: run: exec: \"mongod\": executable file not found in \$PATH. The trap now states that, and notes the earlier hypothesis (the platform restarting mongod as PID 1) was wrong.

A briefing that goes stale is worse than none, since it is consulted precisely when someone is already confused — and this one would have told a reader to reach for a mode that no longer exists.

🤖 Generated with Claude Code

…up mode

My error, and a good illustration of the drift the briefing rule exists to
catch. While removing physical mode I edited the briefing from inside the
worktree using a `../../briefings/` path -- which resolves to the MAIN worktree,
not the branch. So the correction never reached the PR, and #521 merged with the
briefing still describing PBM physical backups as an available option, a
`-physical-backup` workload that no longer renders, and a trap warning that the
physical restore is "unverified and may be architecturally blocked".

It is not unverified any more: it was measured, it cannot work, and the mode is
gone. The trap now states the actual cause -- the pbm-agent image has no mongod
-- and notes that the earlier hypothesis about the platform restarting mongod as
PID 1 was wrong.

Documentation only; `helm template` output is byte-identical, so this is fixed in
place per the in-place rule rather than as a new version.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@jacobecox
jacobecox merged commit d7f9014 into main Aug 30, 2026
6 checks passed
@jacobecox
jacobecox deleted the claude/briefing-mongo-physical branch August 30, 2026 22:46
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