Skip to content

docs(deploy): CORRECT §GH-DEPLOY-DELETES-GLASSBOWL — I over-stated it; the deploy is done and clean - #112

Merged
red1oon merged 1 commit into
masterfrom
docs/correct-glassbowl-landmine
Sep 18, 2026
Merged

red1oon merged 1 commit into
masterfrom
docs/correct-glassbowl-landmine

Conversation

@red1oon

@red1oon red1oon commented Sep 18, 2026

Copy link
Copy Markdown
Owner

The site is deployed. Nothing went offline. My earlier finding was over-stated and this corrects it.

What I missed

mkdocs copies from disk, not from git. docs/glassbowl_data.db is gitignored but sits on disk in the primary checkout. A deploy run from there — how deploys have always been run here — publishes it normally.

My test ran the guard from a fresh /tmp/wt-* worktree, which contains no gitignored files. The asset really was absent from that build and the guard correctly aborted. The abort was real; generalising it to "the next deploy from any branch deletes it" was not.

Deploy completed

§STEP4 GUARD: live=290 files, new=292 files, tol=5%
§GUARD result=PASS — new build is a superset. Safe to publish.
§STEP6 all canaries 200
§DEPLOY-DONE published + canaries checked

Verified live after:

check result
ModellerGuide "ANCHORED by default" 1 hit — #1706's change has finally reached users
ModellerGuide "ride, never distort" 0 hits — the stale text is gone
SpatialCompilationPaper, 4DGenerator 200
all five Glass Bowl files 200
glassbowl_data.db 200, 94,208 B, sha1 e1fb334d — byte-identical

The residual risk, restated honestly

Not "the next deploy breaks the demo." It is: that asset exists in exactly two places — one developer's disk and gh-pages — and in no source tree, bucket, or build script.

  • A deploy from a fresh clone/worktree/CI won't have it and will hit the guard's ABORT. That's the seatbelt working, but it will read as a mystery to whoever hits it.
  • If that disk is lost, the only copy is whatever gh-pages last published.

So the OCI route stays worth doing — for durability and reproducibility, not as an emergency. Lower urgency than I first wrote, and it blocks nothing.

🤖 Generated with Claude Code

…; the deploy is done and clean

Correcting my own two earlier sections rather than leaving a scarier finding on record
than the facts support.

What I missed: mkdocs copies from DISK, not from git. docs/glassbowl_data.db is
gitignored but present on disk in the primary checkout, so a deploy run from there — how
deploys have always been run — publishes it normally. That is why it never broke. My test
ran the guard from a fresh /tmp/wt-* worktree, which contains no gitignored files, so the
asset really was absent from THAT build and the guard correctly aborted. The abort was
real; generalising it to "the next deploy from any branch deletes it" was not.

Deploy completed via scripts/safe_gh_deploy.sh, guard PASS (live=290, new=292, superset),
all canaries 200. Verified live: ModellerGuide now reads "ANCHORED by default" (1) and no
longer "ride, never distort" (0) — #1706's behaviour change has reached users at last.
SpatialCompilationPaper and 4DGenerator still 200. All five Glass Bowl files still 200,
glassbowl_data.db byte-identical at sha1 e1fb334.

Residual risk restated honestly and smaller: the asset lives in exactly two places — one
developer's disk and gh-pages — and in no source tree, bucket or build script. A deploy
from a fresh clone/worktree/CI will hit the guard's ABORT and read as a mystery, and if
that disk is lost the only copy is whatever gh-pages last published. The OCI route stays
worth doing for durability and reproducibility, not as an emergency, and it blocks nothing.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UU4FmnF1izwj4c2tqp6H29
@red1oon
red1oon merged commit d2297b3 into master Sep 18, 2026
1 check failed
red1oon added a commit that referenced this pull request Sep 18, 2026
…SBOWL-OCI), correction first

Both branches appended to the end of LFS_QUOTA_AUDIT.md. Resolved the way CLAUDE.md's
concurrent-branch rule says to: keep both hunks, never drop the other session's. Ordered
so #112's correction of the original finding reads before §GLASSBOWL-OCI closes the
residual risk that correction restated.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UU4FmnF1izwj4c2tqp6H29
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