Stage 1: project foundation (strict TS, lint boundaries B-1..B-7, directory structure, CI, boundary tests)

- dedicated git repo at /home/avi/Projects/Lumen (main)
- TypeScript strict (target ES2022, bundler, exactOptionalPropertyTypes, noUncheckedIndexedAccess)
- ESLint 9 + typescript-eslint strictTypeChecked + eslint-plugin-boundaries for B-1..B-7, no-restricted-globals/syntax for B-1/B-7
- Prettier 3.5
- Structure per IMPLEMENTATION-CONTRACT.md §4 (src/platform/idb|cache|sw, storage, data, sync/{transport,verifier}, domain/{emergency,schedule,map,festival,readiness,clock,favorites}, ui/{components,views,router,render}, app, emergency-baseline, assets, public, content, pipeline, tests, scripts)
- CI: .github/workflows/ci.yml (typecheck + lint + format + test)
- Boundary tests: tests/unit/boundaries.test.ts (4 tests) + scripts/check-boundaries.ts
- No feature code, no PWA/IDB/sync/mesh/accounts per contract Stage 1

README.md

@@ -0,0 +1,27 @@
+# Lumen — offline-first festival PWA
+
+Stage 1 foundation only. No feature code per `IMPLEMENTATION-CONTRACT.md`.
+
+- **Validated architecture:** `ARCHITECTURE-VALIDATION.md` (SPIKE-01…08 reconciled)
+- **Contract:** `IMPLEMENTATION-CONTRACT.md` — single source for implementation rules, boundaries B-1…B-7, invariants I-1…I-17
+- **Stage 1 work:** dedicated git repo + TypeScript strict + lint/format + directory structure + import boundaries + CI + boundary tests
+- **No PWA / IDB / sync / mesh / accounts yet** — see contract Stages 2…19
+
+## Quick start (Stage 1)
+
+```bash
+npm install
+npm run typecheck   # tsc --noEmit strict
+npm run lint        # eslint with boundaries B-1…B-7
+npm run format      # prettier --check
+npm test            # vitest — boundary tests
+npm run ci          # typecheck + lint + format + test
+```
+
+## Project structure
+
+See `IMPLEMENTATION-CONTRACT.md §4` and per-directory `README.md`.
+
+## Branches
+
+- `main` — validated architecture + Stage 1 foundation (YELLOW device/content/ops gates tracked in `ARCHITECTURE-VALIDATION.md §7`).