Skip to content

deploy: ship the visual essay to GitHub Pages (base path, workflow, MIT license) - #3

Merged
Cubits11 merged 1 commit into
mainfrom
deploy/github-pages-phase-1
Oct 25, 2026
Merged

Cubits11 merged 1 commit into
mainfrom
deploy/github-pages-phase-1

Conversation

@Cubits11

@Cubits11 Cubits11 commented Oct 25, 2026 •

Copy link
Copy Markdown
Owner

What

Phase 1 of the plan in #2: ship the existing visual essay to GitHub Pages. Nothing else changes.

Change File
Vite base: "/ghost-visualizer/" vite.config.ts
Tests, copy lint, typecheck, build on every PR; deploy only on push to main; actions pinned by SHA .github/workflows/deploy.yml
MIT licence (same text as cc-framework, year 2026) LICENSE

Repository settings handled outside the diff: Pages enabled with build_type=workflow, homepage set to the live URL, eight topics.

Not in this PR, on purpose: no math, scene, copy, or README change. The site's claim GV-001 fails its registry run if README.md on this repo's default branch differs from bf8d87b, so a README live-demo link ships paired with the site's re-review (plan §6.1).

Evidence

Live URL: https://cubits11.github.io/ghost-visualizer/

Merged as 2ce5a96 (squash) on 2026-10-25 03:00 UTC. Deploy run: 40156629247, both jobs success. The PR's own CI run (40155832269) passed with the deploy job skipped.

Live verification log (2026-10-25, after deploy)

Acceptance tests P1-1 to P1-8 from docs/VISION-LEGACY-PLAN.md §5 (#2).

# Test Result Evidence
P1-1 Build uses base path Pass CI step "Built assets use the Pages base path" passed; served HTML references only /ghost-visualizer/assets/…
P1-2 Workflow on main Pass Run 40156629247 success
P1-3 Root and assets Pass GET / 200 text/html; index-DXagehBe.js 200 application/javascript (304,146 B); index-B0goTY0_.css 200 text/css (38,863 B). /ghost-visualizer without slash: 301
P1-4 Evidence Mode Pass /?mode=evidence: H1 "Evidence Mode", H2 "Two-Guardrail OR Composition Evidence Receipt". The Receipt JSON link (download="sample-receipt.json", a data: URL) decodes to bytes that, plus one newline, equal the served file. SHA-256 of the decoded body without the newline: 8f6a5f9e2a96fffa3042408fa2ff33ca062a9fab5e319ea9cc12dd9785802b9d. Parsed harmful.n = 100; bounded claim "[90%, 100%] … pass-through risk … [0%, 10%]"
P1-5 Receipt file Pass GET /evidence/sample-receipt.json 200 application/json; SHA-256 6b56c1e9bf541e83439d8047fbf853307c0f4c8fed8c6b4c2e69f424d680c83a, equal to the committed file
P1-6 State restore Pass /?overlap=0, scene 3: slider aria-valuenow 0, "composed risk 0% / composed safety 100%". /?overlap=10: 10, "composed risk 10% / composed safety 90%"
P1-7 Console and network Pass, one caveat No console messages. Every request to cubits11.github.io returned 200 on all four pages. The one third-party request, fonts.googleapis.com, appears in resource timing with status 0 (cross-origin, opaque); I did not confirm it loaded. Recorded for Phase 2 in #2
P1-8 Repository metadata Pass homepage = the live URL; licence MIT (REST spdx_id: MIT; GraphQL licenseInfo lagged about a minute behind); 8 topics: ai-assurance, ai-safety, data-visualization, guardrails, llm-evaluation, react, remotion, vite

Method: HTTP status, content type, and SHA-256 from curl and shasum; the three deep links loaded in the built-in browser; scene 3 reached with the right-arrow key twice.

Not verified: behaviour in browsers other than the one used; any other query parameter; mobile layout beyond what the narrow viewport showed. ?recording=true was not exercised.

Local verification before merge

Local verification at the Pages base path (npm run preview, built from this branch):

  • npm test: 6 passed. npm run lint:vis001-copy: passed over 30 files. npm run build: passed.
  • Built JS and CSS are byte-identical to the build on main (index-DXagehBe.js, index-B0goTY0_.css); only the two URLs in dist/index.html move.
  • /ghost-visualizer/: 200; JS and CSS 200; H1 "What AI Guardrail Scores Cannot Tell You".
  • /ghost-visualizer/?mode=evidence: H1 "Evidence Mode"; the Receipt JSON link's decoded bytes plus a newline equal evidence/sample-receipt.json, SHA-256 6b56c1e9bf541e83439d8047fbf853307c0f4c8fed8c6b4c2e69f424d680c83a.
  • /ghost-visualizer/?overlap=0 and ?overlap=10, scene 3: slider aria-valuenow 0 and 10; "composed risk 0% / composed safety 100%" and "10% / 90%".
  • Console: no messages. Network: every local request 200.
  • npm run generate:evidence with the new base: receipt unchanged, git status clean.

One observation, not changed here: src/styles/tokens.css:1 imports fonts from fonts.googleapis.com, so a visitor's browser contacts Google when the page loads. Recorded for Phase 2 in #2.

🤖 Generated with Claude Code

…zer/

Phase 1 of docs/VISION-LEGACY-PLAN.md (PR #2).

- vite.config.ts: base "/ghost-visualizer/". Built JS and CSS bytes are
  unchanged (index-DXagehBe.js, index-B0goTY0_.css); only index.html URLs move.
- .github/workflows/deploy.yml: tests, copy lint, typecheck and build on every
  pull request; the build also asserts the Pages base path and that the
  receipt file in dist/ is byte-identical to public/evidence/. Deploy runs only
  on push to main. Actions are pinned by commit SHA.
- LICENSE: MIT, same text as cc-framework, year 2026.

README.md is deliberately untouched: the site's GV-001 fails its registry run
if README.md on the default branch differs from bf8d87b (plan section 6.1).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
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