CI / build-and-test (pull_request) Failing after 1m19s

Details

feat(ci,flags,ops): ship end-to-end CI, feature-flag framework, gated surfaces, and ops docs

CI (.gitea/workflows/ci.yaml): lint → typecheck → vitest w/ coverage → OpenNext build → preview smoke → bundle-size budgets; Node 20; npm ci; artifacts; safe env; D1 dry-run scaffold.

Budgets: add scripts/budgets.mjs; TOTAL_STATIC_MAX_BYTES and MAX_ASSET_BYTES thresholds; report top offenders; fail on breach; README CI section.

Flags: add lib/flags.ts with typed booleans and safe defaults (ADMIN_ENABLED, ARTISTS_MODULE_ENABLED, UPLOADS_ADMIN_ENABLED, BOOKING_ENABLED, PUBLIC_APPOINTMENT_REQUESTS_ENABLED, REFERENCE_UPLOADS_PUBLIC_ENABLED, DEPOSITS_ENABLED, PUBLIC_DB_ARTISTS_ENABLED, ADVANCED_NAV_SCROLL_ANIMATIONS_ENABLED, STRICT_CI_GATES_ENABLED, ISR_CACHE_R2_ENABLED); robust parsing; client provider; unit tests.

Wiring: gate Admin shell and admin write APIs (503 JSON on uploads and artists writes); disable booking submit and short-circuit booking mutations when off; render static Hero/Artists when advanced animations off; tests for UI and API guards.

Ops: expand docs/prd/rollback-strategy.md with “Feature Flags Operations,” Cloudflare Dashboard and wrangler.toml steps, preview simulation, incident playbook, and post-toggle smoke checklist.

Release: add docs/releases/2025-09-19-feature-flags-rollout.md with last-good commit, preview/production flag matrices, rollback notes, and smoke results; link from rollback doc.

Chore: fix TS issues (gift-cards boolean handling, Lenis options, tailwind darkMode), remove next-on-pages peer conflict, update package.json scripts, configure Gitea act_runner label, open draft PR to trigger CI.

Refs: CI-1, FF-1, FF-2, FF-3, OPS-1
Impact: defaults preserve current behavior; no runtime changes unless flags flipped

2025-09-19 21:33:09 -06:00

2.8 KiB

Raw Blame History

Feature Flags Rollout Release Notes

Version: 1.0 Date: 2025-09-19 Author: Product Manager (John)

Stories Included

FF-1: Feature Flags Library Implementation
FF-2: Feature Flags Wired to Admin/Booking/Public Surfaces
FF-3: Feature Flags Operations & Verification
OPS-1: Feature Flags Configuration, Preview QA, and Release Notes

Last-Good Commit

Commit hash: Placeholder for git rev-parse HEAD
Author/Date/Subject: Placeholder for git log -1 --pretty=format:"%h %ad %an %s"

Default Production Flag Matrix

ADMIN_ENABLED=true
ARTISTS_MODULE_ENABLED=true
UPLOADS_ADMIN_ENABLED=true
BOOKING_ENABLED=true
PUBLIC_APPOINTMENT_REQUESTS_ENABLED=false
REFERENCE_UPLOADS_PUBLIC_ENABLED=false
DEPOSITS_ENABLED=false
PUBLIC_DB_ARTISTS_ENABLED=false
ADVANCED_NAV_SCROLL_ANIMATIONS_ENABLED=true
STRICT_CI_GATES_ENABLED=true
ISR_CACHE_R2_ENABLED=true
R2_PUBLIC_URL=https://YOUR-PUBLIC-R2-DOMAIN

Preview Test Matrix

For QA validation, the following flag states were tested:

BOOKING_ENABLED=false
ADVANCED_NAV_SCROLL_ANIMATIONS_ENABLED=false
All other flags set to their default production values

Rollback Instructions

For partial rollback (specific feature):
- Flip specific flags via Cloudflare Dashboard → Pages → Project → Settings → Environment Variables
- Refer to the Feature Flags Catalog in docs/prd/rollback-strategy.md for flag purposes and effects
For full rollback:
- Cloudflare Pages Dashboard → Project → Deployments → Promote previous successful deployment to Production
- Alternatively, check out last-good commit locally and redeploy
For database rollback (if needed):
- Refer to DB-1 backup/down steps in the rollback strategy

Preview QA Smoke Test Results

Feature Area	Flag State	Expected Behavior	Actual Result	Status
Admin Dashboard	ADMIN_ENABLED=true	Admin dashboard loads, CRUD operations work	TBD	✅/❌
Admin Uploads	UPLOADS_ADMIN_ENABLED=false	Upload endpoints return 503	TBD	✅/❌
Booking Form	BOOKING_ENABLED=false	Submit disabled, fallback CTA shown	TBD	✅/❌
Public Animations	ADVANCED_NAV_SCROLL_ANIMATIONS_ENABLED=false	No parallax/scroll animations, layout intact	TBD	✅/❌
Booking Form	BOOKING_ENABLED=true	Submit enabled, normal flow works	TBD	✅/❌
Public Animations	ADVANCED_NAV_SCROLL_ANIMATIONS_ENABLED=true	Animations restored, no console errors	TBD	✅/❌

Notes

R2_PUBLIC_URL must be configured for both Preview and Production environments
Boolean values must be set as strings ("true"/"false") to match Workers environment semantics
Always stage toggles in Preview first and complete verification before applying to Production

2.8 KiB Raw Blame History