viz: interactive D3 sunburst + heatmap site on GitHub Pages

Adds an interactive single-page visualization for the v1.0 classification,
hosted at https://quantbai.github.io/crypto-sectors/. Pure vanilla JS +
D3 v7 from jsdelivr CDN; no framework, no build step, no node_modules.

Components
- Hero sunburst (3 rings: class / sector / sub-sector) with drill-in to
  individual asset wedges; weighted by asset count with 1.5° minimum
  wedge floor; Overview ↔ Zoomed state machine with breadcrumb
- Asset detail card (sticky sidebar, slide-up sheet on mobile with
  44×44 close button)
- Chain × sector matrix heatmap with neutral luminance ramp via
  color-mix(in oklch); bidirectional highlight with sunburst
- Search with 120ms debounce, live sunburst dimming during typing,
  global / shortcut
- Validation KPI footer pulling from data/validation.json
  (sector spread, 19/19 rolling stability, E5 chain-vs-sector finding)

Design system
- DESIGN.md (635 lines) — canonical visual spec drafted by UX design
  lead, dual-reviewed by Linear-style designer + Bloomberg-style
  quant-viz engineer; all 8 dual-review P0s baked in
- Phosphor cyan hsl(186 70% 58%) accent (avoids class 40 sage collision)
- Geist Sans + Geist Mono variable woff2 (~140KB total)
- Dark mode only; light mode deferred to v1.1
- 4 class colors at 78° hue intervals, colorblind-safe
- WCAG AA throughout, AAA on main text (17:1 contrast)
- Focus ring: 2px outline + 4px halo per WCAG 2.4.13

Data pipeline
- scripts/build_viz_data.py compiles taxonomy.yaml + snapshot.csv +
  validation/numbers.json into docs/data/{taxonomy,validation}.json
- taxonomy.json: 9.7KB gzipped (well under 30KB budget)
- Total page weight: 221KB raw / 30KB gzipped excluding D3 CDN

Deployment
- .github/workflows/pages.yml auto-deploys on push to main; includes
  stale-data check (fails CI if docs/data/ not regenerated after
  snapshot/taxonomy/numbers change)

Multi-agent build process (1 lead + 6 specialist subagents)
- UX design lead: drafted DESIGN.md
- Linear-style designer + Bloomberg-style quant-viz engineer: dual
  reviewed DESIGN.md, produced DESIGN-AMENDMENTS.md (8 P0)
- QD-E (quant-infra-architect): built scripts/build_viz_data.py +
  docs/* + pages.yml from DESIGN.md + amendments + tech spec
- Visual designer + accessibility specialist: dual reviewed live
  rendering via gstack:browse, caught init crash showstopper
- QD-F (quant-infra-architect): fixed 4 P0 (D3 dead chain, init
  cascade, IIFE error fence, hero meta counters) + 6 P1 (dead anchor,
  scoped scroll-margin, aria pluralization, SVG focus, mobile bottom
  sheet, scrollIntoView guard); local verified 62 sunburst wedges,
  full 14×10 heatmap, zero console errors

Hero counter polish: shows n_active_sub_sectors (33) instead of
taxonomy total (44 includes deprecated_slots + extension reserves)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: quantbai

.github/workflows/pages.yml

@@ -0,0 +1,61 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'docs/**'
+      - 'taxonomy.yaml'
+      - 'classification/snapshot.csv'
+      - 'validation/numbers.json'
+      - 'scripts/build_viz_data.py'
+      - '.github/workflows/pages.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+
+      - name: Regenerate viz data
+        run: python scripts/build_viz_data.py
+
+      - name: Verify docs/data not stale
+        run: |
+          if [ -n "$(git status --porcelain docs/data/)" ]; then
+            echo "ERROR: docs/data/ is stale — run scripts/build_viz_data.py and commit."
+            git diff docs/data/
+            exit 1
+          fi
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -29,3 +29,4 @@ plans/
 # that consumers download directly without cloning + running scripts.
 # Re-generated on every release by scripts/build_matrices.py and
 # scripts/compute_validation.py; CI asserts they stay in sync.
+.gstack/

DESIGN.md

@@ -6,6 +6,8 @@
 [![License: MIT](https://img.shields.io/badge/Code-MIT-blue.svg)](LICENSE)
 [![License: CC BY 4.0](https://img.shields.io/badge/Data-CC%20BY%204.0-lightgrey.svg)](LICENSE-data)
 
+**[Live demo](https://quantbai.github.io/crypto-sectors/)** — interactive sunburst, search, asset cards
+
 A community-maintained, hierarchical industry classification for digital assets. Designed for cross-sectional risk decomposition, sector-neutral portfolio construction, and peer-group analysis. The hierarchy is informed by established institutional classification methodologies — see [methodology.md](methodology.md) for citations.
 
 ---