rdmsm4x guide HTMX frontend changelog — 2026-08-26 02:33 EDT

Migrated the isolated amagansett.app guide frontend to semantic HTML5 + HTMX 2 contracts while preserving truthful browser-local behavior and synchronized secondary mapping.

Scope

• Host: rdmsm4x
• Project worktree: /Users/richh/dev/_handoff/codex-out/amagansett-guide-htmx-ui-20260826
• Branch: codex/guide-htmx-ui-20260826
• Commit: 7ba2a28328f7cf4d80f156fb3cfa72600a2bfa8f
• No deploy or outward-facing publication.

Files touched

• /Users/richh/dev/_handoff/codex-out/amagansett-guide-htmx-ui-20260826/sites/guide/src/main.ts
• /Users/richh/dev/_handoff/codex-out/amagansett-guide-htmx-ui-20260826/sites/guide/src/main.tsx (removed)
• /Users/richh/dev/_handoff/codex-out/amagansett-guide-htmx-ui-20260826/sites/guide/src/site.css
• /Users/richh/dev/_handoff/codex-out/amagansett-guide-htmx-ui-20260826/sites/guide/index.html
• /Users/richh/dev/_handoff/codex-out/amagansett-guide-htmx-ui-20260826/sites/guide/vite.config.ts
• /Users/richh/dev/_handoff/codex-out/amagansett-guide-htmx-ui-20260826/package.json
• /Users/richh/dev/_handoff/codex-out/amagansett-guide-htmx-ui-20260826/package-lock.json
• /Users/richh/dev/_handoff/codex-out/amagansett-guide-htmx-ui-20260826/docs/GUIDE-HTMX-FRONTEND-RECEIPT-20260826.md
• /Users/richh/dev/_handoff/codex-out/amagansett-guide-htmx-ui-20260826/docs/qa/guide-htmx-{desktop,selected,mobile}.png

Commands and evidence

• npm install --save [email protected] — dependency added; audit reported zero vulnerabilities.
• npm run typecheck — passed.
• npm run build:guide — passed; expected upstream HTMX eval and bundle-size warnings only.
• npm test -- --run tests/unit/guide.test.ts — 1 file, 8 tests passed.
• zsh tests/integration/guide-wrangler-local-contract.zsh — passed.
• npx playwright test tests/e2e/guide.spec.ts --grep 'keeps the seeded|synchronizes keyboard|search/add review|reviews truthful|narrow screens' --reporter=line — 5 tests passed, including serious/critical Axe checks at 390px and 768px.
• Playwright fallback screenshots captured for desktop, selected/filter state, and mobile. In-app Browser was unavailable in this session.

Backup and undo

• Recoverable source is the isolated worktree and commit above; no canonical worktree was edited.
• Undo by removing or reverting commit 7ba2a28328f7cf4d80f156fb3cfa72600a2bfa8f in the integration worktree after lead review. Do not force-push or deploy from this lane.

Outstanding owner actions

• Project lead must review screenshots/receipt and integrate after backend confirms HTMX fragment responses and durable inventory/provider autocomplete contracts.
• Provider autocomplete, durable inventory writes, and Cloudflare Access remain disabled/unchanged.
• Apple Notes entry is pending because this headless session cannot send AppleEvents; run zsh ~/scripts/notes_changelog.zsh /Users/richh/dev/LLM/Claude/changelogs/rdmsm4x-changelog-20260826-0233-guide-htmx-frontend.md from an Aqua Terminal session on rdmsm4x.