Quality pass: green baseline, tests, content validator (+42 content fixes), perf & a11y

.claude/launch.json

@@ -1,17 +1,17 @@
 {
-  "version": "0.0.1",
-  "configurations": [
-    {
-      "name": "dev",
-      "runtimeExecutable": "npm",
-      "runtimeArgs": ["run", "dev", "--", "--port", "5181", "--strictPort"],
-      "port": 5181
-    },
-    {
-      "name": "preview",
-      "runtimeExecutable": "npm",
-      "runtimeArgs": ["run", "preview"],
-      "port": 4173
-    }
-  ]
+	"version": "0.0.1",
+	"configurations": [
+		{
+			"name": "dev",
+			"runtimeExecutable": "npm",
+			"runtimeArgs": ["run", "dev", "--", "--port", "5181", "--strictPort"],
+			"port": 5181
+		},
+		{
+			"name": "preview",
+			"runtimeExecutable": "npm",
+			"runtimeArgs": ["run", "preview"],
+			"port": 4173
+		}
+	]
 }

.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches-ignore: [main] # main is covered by deploy.yml
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - run: npm ci
+
+      # Formatting + lint (prettier --check . && eslint .)
+      - run: npm run lint
+
+      # Type + Svelte diagnostics
+      - run: npm run check
+
+      # Content integrity: every cross-referenced id must resolve
+      - run: npm run validate
+
+      # Unit tests (vitest) + e2e (playwright builds + previews internally)
+      - run: npm run test:unit
+      - run: npx playwright install --with-deps chromium
+      - run: npm run test:e2e

.github/workflows/deploy.yml

@@ -26,6 +26,11 @@ jobs:
           cache: npm
 
       - run: npm ci
+
+      # Quality gates — never deploy a red baseline.
+      - run: npm run lint
+      - run: npm run check
+
       - run: npm run build
         env:
           BASE_PATH: '/${{ github.event.repository.name }}'

.prettierignore

@@ -7,3 +7,13 @@ bun.lockb
 
 # Miscellaneous
 /static/
+
+# Prose / content working docs — authored as freeform Markdown, not code.
+# Prettier's markdown reformatting is non-idempotent on this long-form content
+# and adds no value here, so keep them out of the format/check gate.
+/research/
+/podcast-blueprints/
+/deep-research-prompts.txt
+/outreach-emails.md
+/build/
+/.svelte-kit/

CLAUDE.md

@@ -12,36 +12,36 @@ In dev mode (`npm run dev`), a `window.__dev` object is exposed for agent and te
 
 **Available methods:**
 
-| Method | Description |
-|---|---|
-| `__dev.go(id, view?)` | Navigate to a protocol/category by ID. `view` is `'learn'` (default) or `'simulate'`. |
-| `__dev.step(n?)` | Click Step Forward `n` times (default 1). |
-| `__dev.play()` | Click the Play button to start the simulation. |
-| `__dev.scrollTo(text)` | Scroll to a heading containing `text` (e.g., `'Encapsulation'`). |
-| `__dev.ls()` | List all node IDs and types. |
-| `__dev.appState` | Direct access to the AppState instance (viewport, layoutMode, selectedNode, theme, etc.). |
-| `__dev.nodes` | Static array of GraphNode objects (for ID/metadata lookup, not live positions). |
-| `__dev.journey(id)` | Start a journey by ID. |
-| `__dev.journeyNext()` | Advance to the next journey step. |
-| `__dev.journeyPrev()` | Go back to the previous journey step. |
-| `__dev.journeyExit()` | Exit the current journey. |
+| Method                 | Description                                                                               |
+| ---------------------- | ----------------------------------------------------------------------------------------- |
+| `__dev.go(id, view?)`  | Navigate to a protocol/category by ID. `view` is `'learn'` (default) or `'simulate'`.     |
+| `__dev.step(n?)`       | Click Step Forward `n` times (default 1).                                                 |
+| `__dev.play()`         | Click the Play button to start the simulation.                                            |
+| `__dev.scrollTo(text)` | Scroll to a heading containing `text` (e.g., `'Encapsulation'`).                          |
+| `__dev.ls()`           | List all node IDs and types.                                                              |
+| `__dev.appState`       | Direct access to the AppState instance (viewport, layoutMode, selectedNode, theme, etc.). |
+| `__dev.nodes`          | Static array of GraphNode objects (for ID/metadata lookup, not live positions).           |
+| `__dev.journey(id)`    | Start a journey by ID.                                                                    |
+| `__dev.journeyNext()`  | Advance to the next journey step.                                                         |
+| `__dev.journeyPrev()`  | Go back to the previous journey step.                                                     |
+| `__dev.journeyExit()`  | Exit the current journey.                                                                 |
 
 **Changing layout mode:**
 
 ```js
-window.__dev.appState.layoutMode = 'radial';   // 'force', 'radial', or 'timeline'
+window.__dev.appState.layoutMode = 'radial'; // 'force', 'radial', or 'timeline'
 ```
 
 **Typical agent workflow for verifying a simulation:**
 
 ```js
 // 1. Wait for page load, then navigate
-new Promise(r => setTimeout(r, 2000)).then(() => {
-  window.__dev.go('tls', 'simulate');   // open TLS in simulate tab
+new Promise((r) => setTimeout(r, 2000)).then(() => {
+	window.__dev.go('tls', 'simulate'); // open TLS in simulate tab
 });
 
 // 2. Step through and inspect
-window.__dev.step(3);                   // advance 3 steps
+window.__dev.step(3); // advance 3 steps
 
 // 3. Scroll to see encapsulation cards
 window.__dev.scrollTo('Encapsulation');