POC (#68): git-backed handbook on Astro + Cloudflare — GitHub auth, review workflow, no CMS/DB - #72

Open

VibratingKoala wants to merge 94 commits into

mainfrom

i68-handbook-poc

Commits on Jun 30, 2026

Handbook POC: custom Astro + Cloudflare D1, hand-written Google OAuth

VibratingKoala
and
claude
committed
d93e3f7
Add collapsible sidebar/TOC, on-page edit button, nested [[TOC]] indent

VibratingKoala
and
claude
committed
1d6db1d
Add Back link and Delete button to the page editor

VibratingKoala
and
claude
committed
1e83907
Rework editor layout: top bar, collapsible settings, right-aligned actions

VibratingKoala
and
claude
committed
b7c363f
Style editor heading and add a delete confirmation modal

VibratingKoala
and
claude
committed
9086801
Make the body/preview row a single collapsible "Content" section

VibratingKoala
and
claude
committed
4f83b98
Remove the Leadership access group from the POC

VibratingKoala
and
claude
committed
4dddf48
Make the editor Save/Publish bar sticky to the viewport bottom

VibratingKoala
and
claude
committed
734fe02
Make editor Back return to the previous page

VibratingKoala
and
claude
committed
a32b349
Group admin Pages list by collapsible section; style its heading

VibratingKoala
and
claude
committed
59fd830
Promote "New page" to a top-right button on the Pages list

VibratingKoala
and
claude
committed
53af30f
Align Pages-list columns and add per-row Delete

VibratingKoala
and
claude
committed
8f95f6e
Remove Home link from the top navbar (logo already links home)

VibratingKoala
and
claude
committed
116f69b
Sidebar: reset section open-state on reload, keep it across navigation

VibratingKoala
and
claude
committed
8450504
Unify all buttons onto one .btn base with brand/alt/danger variants

VibratingKoala
and
claude
committed
904908a
Add "Back to handbook" link on the Pages list

VibratingKoala
and
claude
committed
dd14d1e
Move "Back to handbook" link below the Pages list

VibratingKoala
and
claude
committed
ce23ff2
Add visitor-scoped handbook search (titles + content)

VibratingKoala
and
claude
committed
dc16806
Rename the editor route /admin -> /edit-pages

VibratingKoala
and
claude
committed
10102c0
Edit by slug, and rename /edit-pages/new -> /edit-pages/create

VibratingKoala
and
claude
committed
f93870e
Move "Back to handbook" link directly under the Pages header

VibratingKoala
and
claude
committed
b3071fb
Replace native datalist with a themed Section combobox

VibratingKoala
and
claude
committed
4f4e93c

Commits on Jul 1, 2026

Clean up leftovers from iterative UI changes

VibratingKoala
and
claude
committed
c44d3c3
Rename editor "Slug" field to "Page URL" for non-technical staff

VibratingKoala
and
claude
committed
83ff216
Editor sections collapsed by default, restored on back-navigation

VibratingKoala
and
claude
committed
a7ee2ab
Extract duplicated back-link logic into a shared helper

VibratingKoala
and
claude
committed
518f2d7
Extract duplicated collapse-persistence into a shared component

VibratingKoala
and
claude
committed
1a792de
Phase 0: add git-backed content collection + frontmatter files

VibratingKoala
and
claude
committed
a00f1a1
Phase 1: DB-free content read layer + canRead ACL

VibratingKoala
and
claude
committed
d8b6e64
Phase 2: serve readers from the content collection

VibratingKoala
and
claude
committed
a35cdef
Phase 3: editor reads from git content; writes deferred (workerd)

VibratingKoala
and
claude
committed
f50aaed
Phase 4: remove D1 content tables + code; D1 is identity-only now

VibratingKoala
and
claude
committed
d509fcc
Update POC.md for the git-backed architecture

VibratingKoala
and
claude
committed
956e176
Enable in-browser editor locally via a Node content agent

VibratingKoala
and
claude
committed
200c087
Remove the database entirely — identity moves to a git config

VibratingKoala
and
claude
committed
ee470ac
Validate rename oldSlug before writing (content agent)

VibratingKoala
and
claude
committed
445011c
Purge stale D1/database references from comments + config

VibratingKoala
and
claude
committed
21cec9b
Fix dev:edit runner for the daemonizing astro dev

VibratingKoala
and
claude
committed
4d84450
Mark required editor fields (Title, Section) with red asterisks

VibratingKoala
and
claude
committed
bf23b82
Document migration/cutover from GitHub Pages (VitePress) to Cloudflare (SSR)

VibratingKoala
and
claude
committed
fe66da3
Harden markdown render: drop raw-HTML pass (stored-XSS fix)

VibratingKoala
and
claude
committed
30e9a39
Add DEV_USERS local override; harden identity resolution

VibratingKoala
and
claude
committed
9db0628
Cleanup: remove stale D1 comments, format (biome)

VibratingKoala
and
claude
committed
11c1127
CI: run-tests.yml targets the Astro app, not the removed VitePress build

VibratingKoala
and
claude
committed
8258880
Add tests: serializer round-trip, directory/DEV_USERS, origin/open-redirect

VibratingKoala
and
claude
committed
10bafa2
Fix post-login open redirect + validate rename source slug

VibratingKoala
and
claude
committed
29ccac3
Robustness fixes from code review (render fail-closed, agent commits)

VibratingKoala
and
claude
committed
9382125
Document review decisions: sidebar transparency + preview CSRF exemption

VibratingKoala
and
claude
committed
c2a0076

Commits on Jul 2, 2026

Rearchitect auth: GitHub OAuth + repo permissions ARE the access control

VibratingKoala
and
claude
committed
a113d52
Editor saves commit AS THE SIGNED-IN PERSON via the GitHub API (no bot)

VibratingKoala
and
claude
committed
9de4046
Editor saves become submit-for-review pull requests (main is PR-protected)

VibratingKoala
and
claude
committed
efddfa2
Admin review dashboard: approve & publish handbook edits in-app

VibratingKoala
and
claude
committed
e9bddb4
Guard: no personal emails in this public repo; pin pnpm

VibratingKoala
and
claude
committed
514c23e
One button system: variants + sizes + states, no one-off button CSS

VibratingKoala
and
claude
committed
3b89133
Fix all 8 findings from the PR-wide code review

VibratingKoala
and
claude
committed
ebd96bf
Pre-staging: CI trigger for review PRs, staging env, headers, 404 page

VibratingKoala
and
claude
committed
7ee1d6f
POC.md: production credentials must be org-owned, never personal

VibratingKoala
and
claude
committed
5471a13
Editor UX: live controls everywhere, styled popups, env ribbon

VibratingKoala
and
claude
committed
6f93e64
Overhaul: 2-tier ACL + git-native draft/publish workflow

VibratingKoala
and
claude
committed
014305a
Resume-from-draft + edit-state chips: unmerged work is never lost or hidden

VibratingKoala
and
claude
committed
effdbe5

Commits on Jul 3, 2026

POC.md: DNS cutover plan updated for the Route 53 reality

VibratingKoala
and
claude
committed
43d84ca
Roles collapse to editor/reader; explicit write gate; POC branch targeting; UI polish + cleanup

VibratingKoala
and
claude
committed
38512c7
Editing auto-enables when sign-in switches to the GitHub App

VibratingKoala
and
claude
committed
8ba4024
chore: trigger staging build from POC branch

VibratingKoala
and
claude
committed
71fb20f
Fix review findings: parallelize edit-page reads, correct stale ACL comments

VibratingKoala
and
claude
committed
891030a

Commits on Jul 6, 2026

Commits on Jul 8, 2026

Fix save/submit POSTing to a garbage URL (form.action clobbered by name="action" buttons)

VibratingKoala
and
claude
committed
d5b3ac3
Manage pages: sections collapsed by default everywhere; unify naming

VibratingKoala
and
claude
committed
5bb358f
Editor polish: drafts section stands out; one resume banner; drop required-legend

VibratingKoala
and
claude
committed
c410a31
Dedupe delete-confirm wiring into wireConfirmDelete; drop dead CSS

VibratingKoala
and
claude
committed
2f8e74e
Delete on a never-published page discards its draft branch

VibratingKoala
and
claude
committed
d161c27
Save/Submit UX: busy-state buttons; land back on the edit page

VibratingKoala
and
claude
committed
d199526

Commits on Jul 9, 2026

Dedupe PR-link building; busy-state for Approve/Reject; bfcache reset

VibratingKoala
and
claude
committed
225cb81
Internal review page: read & approve a pending change without leaving the handbook

VibratingKoala
and
claude
committed
f698a47
Environment ribbon: STAGING -> POC (honest label for the evaluation period)

VibratingKoala
and
claude
committed
3248667
Reviews: table -> flex-wrap list (mobile was scrolling sideways)

VibratingKoala
and
claude
committed
9c8bb4b
Add CLAUDE.md: standing code-quality + public-repo rules for AI sessions

VibratingKoala
and
claude
committed
55bdca2
Reviews polish: card rows; human titles instead of commit-speak

VibratingKoala
and
claude
committed
278837a
Deploy-on-push workflow (inert until CLOUDFLARE_API_TOKEN secret exists)

VibratingKoala
and
claude
committed
3ad8ce4
POC.md: deploy-on-push CI now exists (inert until repo secret added)

VibratingKoala
and
claude
committed
77935ce

Commits on Jul 10, 2026

Port the five style guides from PR #73 into handbook content

VibratingKoala
and
claude
committed
6d85cd8
Sidebar nesting via parent frontmatter (matches the original handbook tree)

VibratingKoala
and
claude
committed
434092d
Sidebar: parents with children are collapsible (chevron, active trail open)

VibratingKoala
and
claude
committed
70e6d73
Cap + center the doc shell at 1440px (ultrawide was scattering the columns)

VibratingKoala
and
claude
committed
bf596c3
POC.md: catch docs up — App live since 07-09, internal review page, parent nesting, discard-draft

VibratingKoala
and
claude
committed
0d57bea

Commits on Jul 13, 2026

Merge remote-tracking branch 'origin/main' into i68-handbook-poc
VibratingKoala
committed
c592fe8
Fix astro-check 1002: '<=' in a template expression parses as a fragment

VibratingKoala
and
claude
committed
c615f3f
Single source: the app reads doc/*.md directly — ported copies deleted

VibratingKoala
and
claude
committed
9009f0c
ACL-aware llms.txt / llms-full.txt / per-page .md endpoints

VibratingKoala
and
claude
committed
8ed029c

Commits on Jul 15, 2026