Merge pull request #11 from nova-rey/codex/migrate-to-eslint-flat-config-and-prettier

Author: nova-rey

.eslintrc.cjs

@@ -2,9 +2,9 @@ name: Build UI Bundle
 
 on:
   push:
-    branches: [ main ]
+    branches: [main]
   pull_request:
-    branches: [ main ]
+    branches: [main]
 
 jobs:
   build:

.github/workflows/build.yml

@@ -0,0 +1,4 @@
+dist
+node_modules
+coverage
+*.log

.prettierignore

@@ -0,0 +1,7 @@
+{
+  "printWidth": 100,
+  "singleQuote": false,
+  "trailingComma": "all",
+  "semi": true,
+  "arrowParens": "always"
+}

.prettierrc

@@ -1,7 +1,7 @@
 project: csc-webui
 current_phase: 2
-current_checkpoint: 6
-checkpoint_title: Spec Builder MVP complete
+current_checkpoint: 7
+checkpoint_title: ESLint Flat Config + Prettier + Builder Smoke Test
 allow_behavior_change: false
 docs_truth_source:
   - docs/WEBUI_SNAPSHOT.yaml

.prettierrc.json

@@ -3,17 +3,20 @@
 A modern, browser-based UI for **CrapsSim-Control (CSC)**.
 
 ## What it is
+
 - **Spec authoring & visualization** — build craps strategy specs via a visual editor.
 - **Run orchestration** — start and monitor runs (seeded, explain mode).
 - **Replay viewer** — inspect roll-by-roll events.
 - **History & artifacts** — browse prior runs, download CSVs, view summaries.
 
 ## Compatibility
+
 - UI **v0.3.x** targets **CSC API v1** (`/api/v1/...`).
 - Configure the API root with `VITE_CSC_BASE_URL` (e.g., `http://localhost:8080/api/v1`).
 
 ## Quickstart
-1. Copy `.env.example` → `.env.local`.  
+
+1. Copy `.env.example` → `.env.local`.
 2. Set:
    - `VITE_CSC_BASE_URL=http://localhost:8080/api/v1`
    - `VITE_CSC_TOKEN=` (optional)
@@ -22,6 +25,8 @@ A modern, browser-based UI for **CrapsSim-Control (CSC)**.
    ```bash
    npm ci
    npm run dev
+   ```
+
 ```
 
 4. Open:
@@ -52,3 +57,4 @@ A modern, browser-based UI for **CrapsSim-Control (CSC)**.
 
 See `docs/PHASE_CHECKLIST.md` for checkpoint tracking and `docs/WEBUI_SNAPSHOT.yaml` for current state.
 
+```

NOVA_AGENT_ENTRYPOINT.yaml

@@ -1,33 +1,40 @@
 # Architecture — csc-webui
 
 ## Overview
+
 - **Frontend only**: React + TypeScript (Vite).
 - **Design system**: minimal, accessible (Tailwind in P0·C1).
 - **Data layer**: small fetch/axios wrapper targeting `/api/v1/*`.
 - **Packaging**: `dist/` → `ui_static.tar.gz` for optional CSC embedding.
 
 ## Modules (planned)
+
 - `api/` — typed client for `spec/*`, `runs*`, `summarize`, `replay`.
 - `routes/` — `/builder`, `/runs`, `/replay`, `/about`.
 - `builder/` — MVP: hierarchical form; later: graph editor.
 - `replay/` — timeline renderer; playback throttle.
 - `components/` — small, composable UI primitives.
 
 ## Config
+
 - `VITE_CSC_BASE_URL` — API root (e.g., `http://localhost:8080/api/v1`).
 - `VITE_CSC_TOKEN` — optional bearer for endpoints requiring auth.
 
 ## Guardrails
+
 - No direct coupling to CSC internals; only the HTTP contract.
 - All calls go through the API client; no stray `fetch()` in components.
 - Semantic commits; version tags parallel to CSC.
 
 ## API Client (Phase 1)
+
 - All HTTP lives in `src/api/` with a small axios wrapper.
 - Env: `VITE_CSC_BASE_URL`, `VITE_CSC_TOKEN`, optional `VITE_CSC_USE_MOCK=true`.
 - Response shape is normalized to `{ ok, status, data }` or `{ ok:false, status, message }`.
 - Mock mode serves JSON from `/mock-data/*` when the API is unavailable.
+
 ## Spec Builder (Phase 2)
+
 - Authoring types in `src/spec/`.
 - Conversion `authoring → draft` via `src/spec/convert.ts`.
 - `/builder` provides navigator, editor forms, and an output panel with Normalize.

README.md

@@ -0,0 +1,5 @@
+# CSC Bible
+
+### Checkpoint 7 — ESLint Flat Config + Prettier + Builder Smoke Test
+
+Converted ESLint to the modern flat config (`eslint.config.js`), integrated Prettier with repo-wide scripts, and added a Vitest smoke test that mounts `Builder.tsx` under jsdom. This removes ESLint deprecation warnings and gives CI a minimal but real test.

docs/ARCHITECTURE.md

@@ -1,22 +1,27 @@
 # Dev Workflow — csc-webui
 
 ## Rhythm
-1) **Brief → No-flavor agent prompt → Agent run → Validation → Doc sync**  
-2) One checkpoint = one reversible commit (PR).
+
+1. **Brief → No-flavor agent prompt → Agent run → Validation → Doc sync**
+2. One checkpoint = one reversible commit (PR).
 
 ## Semantics
+
 - Commits use: `feat:`, `fix:`, `docs:`, `chore:`, `refactor:`, `build:`.
 - Versioning follows SemVer; UI starts at **v0.1.0**.
 
 ## Phase 0 Plan
+
 - **P0·C0** (Docs-only): establish scope and guardrails.
 - **P0·C1**: Vite+React+TS scaffold; Tailwind setup; basic scripts.
 - **P0·C2**: React Router routes; env wiring; API client stub.
 - **P0·C3**: `scripts/build_ui_bundle.sh` + GitHub Action to publish `ui_static.tar.gz`.
 
 ## Lint/Format (coming in P0·C1)
+
 - ESLint + Prettier with sensible defaults.
 - EditorConfig optional, but enforce via ESLint where possible.
 
 ## CI (seed in P0·C3)
+
 - Node LTS matrix build (install → build → upload artifact).