RCA-2026-04-11-001: domus-captures Build Failure

Executive Summary

On 2026-04-11, domus-captures became unable to build locally or on Cloudflare Pages after ~5,000 scripture study pages were added to the repository. The Antora build process hung indefinitely — no error, no crash, silent stall. Cloudflare timed out at 21 minutes. Separately, the local branch diverged from remote twice: once from amending a pushed commit, once from committing on top of a push while a background agent also committed to the same branch. Resolution required removing all scripture pages, fixing 110+ pre-existing broken xrefs, escaping 15 attribute warnings, and rebasing to reconcile diverged history. Total disruption: ~4 hours.

Timeline

Time Event

2026-04-11 ~14:00

Scripture generation script creates 2,447 RV1909 + 2,447 KJV pages in domus-captures

~14:15

Tanakh (1,901 files) also generated. Total: 6,795 new files

~14:30

First make succeeds locally (long build, ~15 minutes)

~14:45

Commit 3b4eeb63 pushed to remote with all scripture pages

~15:00

User reports nav and language issues. git commit --amend used on pushed commit → branch divergence #1

~15:15

git reset --soft origin/main applied to reconcile. New commit created.

~15:30

Cloudflare Pages build times out at 21 minutes ("internal error")

~15:45

Tanakh removed (1,901 files) to reduce load. Commit pushed.

~16:00

Cloudflare build succeeds but shows ~100 pre-existing xref errors

~16:30

User requests all errors fixed. Background agent launched for xref fixes.

~16:35

Instead of waiting, same fixes made manually in main conversation — duplicate work

~17:00

User pushes clean build. Two more commits made locally without pulling → branch divergence #2

~17:30

Local make hangs indefinitely — RV1909 + KJV still too many files

~17:45

All scripture pages removed from domus-captures

~18:00

Build succeeds: zero errors, zero warnings

~18:15

git pull --rebase resolves divergence (duplicate commit skipped)

Problem Statement

Symptoms

  • Antora build hangs with no output after "Building Domus Captures…​"

  • Cloudflare Pages build times out at 21 minutes

  • Branch diverges from remote (twice)

  • ~100 pre-existing broken xrefs visible in build output

  • 15 attribute warnings from literal {attribute} in codex examples

Expected Behavior

  • Build completes in under 2 minutes with zero errors and zero warnings

  • Branch stays in sync with remote

  • All xrefs resolve to existing pages

Actual Behavior

  • Build hung indefinitely or timed out

  • Branch diverged twice requiring manual recovery

  • Build log contained 100+ errors that were being filtered and ignored

Metadata

Field Value

RCA ID

RCA-2026-04-11-001

Author

Evan Rosado

Date Created

2026-04-11

Status

Final

Severity

P2 — Build broken, deployment blocked, no data loss

Duration

~4 hours (14:00–18:15)

Systems Affected

domus-captures (Antora build), Cloudflare Pages deployment

Data Loss

None — all content preserved in git history and Principia