Skip to content

docs: update all docs and templates for converged single-Worker architecture - #19

Merged
tbjers merged 1 commit into
mainfrom
docs/update-for-converged-architecture
Jun 26, 2026
Merged

docs: update all docs and templates for converged single-Worker architecture#19
tbjers merged 1 commit into
mainfrom
docs/update-for-converged-architecture

Conversation

@tbjers

@tbjers tbjers commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Routes corrected: badge path /badge//api/badge/; ingest POST /ingest (EAV) → POST /api/ci/coverage (typed columns); baseline path updated
  • Cloudflare Access scope fixed: INSTALLATION.md Step 10 now says to protect dashboard paths only, with an explicit warning not to put an edge Access policy on /api/* (would break CI ingest and GitHub webhooks)
  • wrangler.example.jsonc rewritten: now shows assets, build.command, triggers.crons, nodejs_compat, and D1 database name coverage — matches actual production config shape
  • Step 14 replaced: removed separate Cloudflare Pages deploy instructions; dashboard now ships with the Worker via build.command
  • PROGRESS.md updated: Convergence Refactor section added, Layer 3 Worker tests marked complete, Phase 5 and Phase 8 items updated

Test plan

  • Read through docs/INSTALLATION.md Steps 3, 10, 11, 13, 14 and Next steps — verify no stale paths or config shapes
  • Confirm wrangler.example.jsonc validates against the wrangler schema (npx wrangler deploy --dry-run with the example filled in)
  • Search for /badge/ in docs — should only appear as /api/badge/
  • Search for POST /ingest in docs — should only appear in PROGRESS.md historical phase bullets
  • Confirm Step 10 Access warning block is present and correct

🤖 Generated with Claude Code

…tecture

README, INSTALLATION.md, PROGRESS.md, wrangler.example.jsonc, and both
.dev.vars.example files now reflect the post-convergence state: single Worker
serving the SvelteKit SPA via Workers Static Assets alongside all API routes
under /api/*. Key corrections:

- Badge path: /badge/ → /api/badge/
- Ingest: POST /ingest (EAV payload) → POST /api/ci/coverage (typed columns)
- Baseline: /api/projects/:owner/:repo/baseline → /api/baseline/:owner/:repo
- Cloudflare Access scope: no longer on /api or /admin; dashboard paths only
- wrangler.example.jsonc: assets block, build.command, triggers.crons, nodejs_compat
- Step 14 in INSTALLATION.md: separate Pages project removed; dashboard ships with Worker
- PROGRESS.md: Convergence Refactor section added; Layer 3 tests marked complete

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@tbjers
tbjers merged commit c8f2768 into main Jun 26, 2026
5 checks passed
@tbjers
tbjers deleted the docs/update-for-converged-architecture branch June 26, 2026 02:35
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