docs/plans/2026-06-01-fix-ci.md
Objective:
Fix the failing GitHub PR CI check for PR #4981 by resolving the local bun check failures and proving the same command passes in /Users/zbeyens/git/plate.
Completion threshold:
bun check exits 0 locally after the CI-root formatting, lint, typecheck, and test failures are fixed.
Verification surface:
26766845587, identified the failing bun check stage.pnpm lint.bun check.http://localhost:3002/docs/footnote.Constraints:
Boundaries:
.github/workflows/ci.yml and PR #4981 check logs./docs/footnote.Blocked condition:
Blocked only if local bun check still fails after the CI log root cause is patched, or browser verification cannot reach the local docs app.
Start Gates:
| Gate | Applies | Evidence |
|---|---|---|
| CI source read | yes | Read PR #4981 check log and .github/workflows/ci.yml; PR path runs bun check. |
| Repo instructions read | yes | AGENTS.md instructions loaded in thread context. |
| Browser decision | yes | Browser smoke required because apps/www changed. |
| PR mutation decision | yes | No push/commit/PR mutation because user asked to fix, not publish. |
Completion Gates:
| Gate | Applies | Evidence |
|---|---|---|
| Formatting fixed | yes | pnpm exec biome check ... passed on focused files, then root lint passed Biome. |
| Lint fixed | yes | pnpm lint exited 0 with one existing warning only. |
| CI command fixed | yes | bun check exited 0. |
| Browser smoke | yes | Browser loaded /docs/footnote, found one Footnote H1, and logged no browser errors. |
Work Checklist:
.contentlayer output ignored by ESLint.bun check.Phase / pass table:
| Phase | Status | Evidence |
|---|---|---|
| Intake | complete | PR #4981 failing CI log inspected. |
| Implementation | complete | CI-blocking files patched and formatted. |
| Verification | complete | pnpm lint, bun check, and Browser smoke passed. |
| Handoff | complete | No publish action taken because not requested. |
Verification evidence:
pnpm exec biome check apps/www/source.config.ts 'apps/www/src/app/(view)/layout.tsx' apps/www/src/app/api/search/route.ts apps/www/src/components/block-viewer.tsx apps/www/src/components/command-menu.tsx docs/sync/shadcn/dashboard.json exited 0.pnpm lint exited 0; remaining sidebar hook dependency warning does not fail lint.bun check exited 0, including lint, package build/typecheck, test:all, and test:slowest.http://localhost:3002/docs/footnote, title Footnote - Plate, one Footnote H1, no console errors.Reboot status: Current thread has enough state to resume from this plan; final status is ready for handoff.
Open risks: Remote CI has not rerun because no commit/push was requested.