CI docs build memory

Status: done, opened 2026-08-24.
Issue: none filed; dispatched directly from the 2026-08-24 agenda as a same-day CI fix.
Launch plan: none, this is tooling.

What is this?

The Build (Docs) CI step had no Node heap ceiling at all, so it ran on Node's unbounded default and died near 2005MB.

No NODE_OPTIONS and no --max-old-space-size were set anywhere on that step before this fix. It was never a case of a 4096MB ceiling being exceeded; there was no ceiling, and Node's own default is what the process ran out of room under.

The fix sets an explicit heap ceiling on that one step instead of leaving it on Node's default.

Scoped to just the "Build documentation" step inside the "Build (Docs)" job in .github/workflows/ci.yml, so no other job's memory behavior changes.

What is the current state?

The fix landed as commit `67bf3882` on this branch and is already pushed.

Commit: 67bf3882
Branch: feat/admin-and-merchant-portals
Change: an env: block on the "Build documentation" step, setting NODE_OPTIONS: --max-old-space-size=3584.
Verify with grep -rn "max-old-space-size" .github/workflows/ci.yml.

The value shipped is 3584, not the 4096 the originating agenda block asked for.

3584MB lands at roughly half of the runner's 7GB (ubuntu-latest standard memory allocation); it was not raised to match the 4096MB ask.
Whether 3584 gives enough headroom, or should be reconciled to 4096, is open and not decided by this record.

#949: fix(admin): onboard admins with a portal password, and census every admin-role decision site (#941), the PR whose CI run surfaced the OOM failure this fix addresses.