@vib3code/sdk 2.0.3-canary.91a95f3 → 2.0.3-canary.ef8d292

package/DOCS/MASTER_PLAN_2026-01-31.md

@@ -19,10 +19,10 @@ The codebase is complete. The product isn't. You have 95,000+ lines of working e
 - Creative Tooling (color presets, transitions, post-processing, timeline) — complete
 - Platform Integrations (React, Vue, Svelte, Figma, Three.js, TouchDesigner, OBS) — code complete
 - Advanced Features (WebXR, WebGPU Compute, MIDI, AI Presets, OffscreenWorker) — code complete
-- MCP Agentic Control (14 tools) — working
+- MCP Agentic Control (36 tools — 14 core + 22 added in Phases 6.5-8) — working
 - C++ WASM Core with JS fallback — working
 - Export System (SVG, CSS, Lottie, Shader, Trading Cards, VIB3Package) — working
-- 693+ tests passing, 34 test files
+- 1762 tests passing, 77 test files (as of Feb 15, 2026)
 - 6 CI/CD workflows active
 
 **What's not done**: Everything below.

package/DOCS/SYSTEM_INVENTORY.md

@@ -31,7 +31,7 @@ The SDK provides 3 active visualization systems with shared 6D rotation mathemat
 | **Core Warp Types** | 3 (Base, Hypersphere, Hypertetrahedron) |
 | **Total Geometries** | 24 per system (8 base × 3 cores) |
 | **Canvas Layers** | 5 per system (background, shadow, content, highlight, accent) |
-| **MCP Tools** | 12 agent-accessible tools |
+| **MCP Tools** | 36 agent-accessible tools (14 core + 4 Phase 6.5 + 7 Phase 7 + 5 Phase 7.1 + 5 Phase 8 + 1 reactivity) |
 | **Spatial Input Sources** | 8 (deviceTilt, mouse, gyroscope, gamepad, perspective, programmatic, audio, MIDI) |
 | **Spatial Profiles** | 6 built-in (cardTilt, wearablePerspective, gameAsset, vjAudioSpatial, uiElement, immersiveXR) |
 | **Creative Effects** | 14 post-processing effects, 22 color presets, 14 easing functions |
@@ -245,7 +245,7 @@ All rotation parameters: `-6.28` to `6.28` (radians, ±2π)
 
 ## MCP Server & Agent Tools
 
-### Available Tools (12 total)
+### Available Tools (36 total — see CLAUDE.md for full breakdown by phase)
 
 | Tool | Description | Key Parameters |
 |------|-------------|----------------|

package/DOCS/WEBGPU_STATUS.md

@@ -1,38 +1,119 @@
-# WebGPU status and testing requirements
-
-This document records the current WebGPU backend state, what is implemented, and what is required
-to validate it in local development or CI.
-
-## Current status
-- **Backend scaffold:** `WebGPUBackend` initializes adapter/device, configures the canvas, manages
-  resize, and supports a clear-pass `renderFrame()` path.
-- **Async context creation:** `createRenderContextAsync()` can instantiate WebGPU contexts using
-  `{ backend: 'webgpu' }`.
-- **Resource tracking:** depth textures are registered in the shared `RenderResourceRegistry`.
-
-## What is still needed
-1. **Pipeline parity:** implement basic shader pipelines (vertex/fragment) and buffer binding that
-   match the WebGL backend command flow.
-2. **Command buffer bridge:** map existing render commands to WebGPU render passes.
-3. **Feature gating:** add host-app controls to toggle WebGPU via feature flags.
-4. **Diagnostics:** add per-frame stats and resource delta reporting for WebGPU.
-
-## Testing requirements
-### Local smoke test
-Prerequisites:
-- A browser with WebGPU enabled (Chrome/Edge with `chrome://flags/#enable-unsafe-webgpu`, or a
-  Chromium build with WebGPU support).
-- A device with WebGPU-capable GPU drivers.
-
-Suggested smoke flow:
-1. Create a canvas and call `createRenderContextAsync(canvas, { backend: 'webgpu' })`.
-2. Call `backend.renderFrame({ clearColor: [0.1, 0.1, 0.2, 1] })` and confirm the canvas clears.
-3. Resize the canvas and ensure the clear pass still succeeds.
-
-### CI validation
-- WebGPU cannot be reliably validated in headless CI without GPU support.
-- CI should instead run WebGL tests and lint/static checks; keep a manual WebGPU smoke checklist.
-
-## File locations
-- `src/render/backends/WebGPUBackend.js`
-- `src/render/index.js` (`createRenderContextAsync`)
+# WebGPU Backend Status
+
+**Last updated**: 2026-02-15
+
+> Previous version archived at `DOCS/archive/WEBGPU_STATUS_2026-02-15_STALE.md`.
+
+## Current State: Functional but Not Validated End-to-End
+
+The WebGPU backend is **architecturally complete** — real device init, shader compilation, pipeline creation, uniform buffers, render passes. It is not a stub. However, no end-to-end browser validation has confirmed correct pixel output through the WebGPU path.
+
+## What Is Implemented
+
+| Component | Status | File |
+|-----------|--------|------|
+| Device/adapter/context init | Done | `src/render/backends/WebGPUBackend.js` (1410 lines) |
+| Canvas configuration + resize | Done | WebGPUBackend.js |
+| WGSL shader module compilation | Done | WebGPUBackend.js `compileShader()` |
+| Fullscreen quad pipeline | Done | WebGPUBackend.js `createFullscreenPipeline()` |
+| Custom geometry pipeline | Done | WebGPUBackend.js `createPipeline()` |
+| Uniform buffer management | Done | WebGPUBackend.js `createCustomUniformBuffer()` / `updateCustomUniforms()` |
+| Fullscreen quad rendering | Done | WebGPUBackend.js `renderFullscreenQuad()` |
+| Geometry rendering | Done | WebGPUBackend.js `renderGeometry()` / `renderWithPipeline()` |
+| Manual render pass control | Done | WebGPUBackend.js `beginRenderPass()` / `endRenderPass()` |
+| Vertex/index buffer creation | Done | WebGPUBackend.js |
+| Texture + sampler creation | Done | WebGPUBackend.js |
+| Resource cleanup | Done | WebGPUBackend.js `dispose()` |
+| WebGL/WebGPU bridge abstraction | Done | `src/render/UnifiedRenderBridge.js` |
+| Uniform packing (JS → GPU) | Done | `packVIB3Uniforms()` in UnifiedRenderBridge.js |
+| FacetedSystem WebGPU path | Done | `src/faceted/FacetedSystem.js` `initWithBridge()` |
+
+## WGSL Shader Files
+
+All seven WGSL files are real, substantive shaders (not stubs):
+
+| File | Lines | Content |
+|------|-------|---------|
+| `src/shaders/common/fullscreen.vert.wgsl` | 18 | Fullscreen triangle vertex shader |
+| `src/shaders/common/uniforms.wgsl` | 49 | Canonical VIB3Uniforms struct definition |
+| `src/shaders/common/rotation4d.wgsl` | 87 | All six 4D rotation matrices + projection |
+| `src/shaders/common/geometry24.wgsl` | 55 | All 24 geometry SDFs |
+| `src/shaders/faceted/faceted.frag.wgsl` | 206 | Complete faceted fragment shader |
+| `src/shaders/quantum/quantum.frag.wgsl` | 362 | Complete quantum fragment shader |
+| `src/shaders/holographic/holographic.frag.wgsl` | 255 | Complete holographic fragment shader |
+
+## Canonical Uniform Struct Layout
+
+All WGSL uniform structs **must** match `packVIB3Uniforms()` in `UnifiedRenderBridge.js`. The canonical layout uses only `f32` scalars and one `vec2<f32>` to avoid WGSL alignment surprises:
+
+```wgsl
+struct VIB3Uniforms {
+    time: f32,              // index 0
+    _pad0: f32,             // index 1
+    resolution: vec2<f32>,  // index 2-3
+    geometry: f32,          // index 4
+    rot4dXY: f32,           // index 5
+    rot4dXZ: f32,           // index 6
+    rot4dYZ: f32,           // index 7
+    rot4dXW: f32,           // index 8
+    rot4dYW: f32,           // index 9
+    rot4dZW: f32,           // index 10
+    dimension: f32,         // index 11
+    gridDensity: f32,       // index 12
+    morphFactor: f32,       // index 13
+    chaos: f32,             // index 14
+    speed: f32,             // index 15
+    hue: f32,               // index 16
+    intensity: f32,         // index 17
+    saturation: f32,        // index 18
+    mouseIntensity: f32,    // index 19
+    clickIntensity: f32,    // index 20
+    bass: f32,              // index 21
+    mid: f32,               // index 22
+    high: f32,              // index 23
+    layerScale: f32,        // index 24
+    layerOpacity: f32,      // index 25
+    _pad1: f32,             // index 26
+    layerColorR: f32,       // index 27
+    layerColorG: f32,       // index 28
+    layerColorB: f32,       // index 29
+    densityMult: f32,       // index 30
+    speedMult: f32,         // index 31
+    breath: f32,            // index 32
+};
+```
+
+**Rule**: Do NOT use `vec3<f32>` for layerColor — it triggers 16-byte alignment padding that breaks the flat Float32Array packing. Always use three separate f32 fields.
+
+## System Integration
+
+| System | WebGPU Path | Notes |
+|--------|-------------|-------|
+| **Faceted** | Single-canvas via UnifiedRenderBridge | Inline WGSL matches canonical layout. Only system with a complete WebGPU path wired in the demo page. |
+| **Quantum** | Multi-canvas via MultiCanvasBridge | Requires 5 separate canvas DOM elements. Falls back to WebGL on `docs/webgpu-live.html` (single canvas). |
+| **Holographic** | Multi-canvas via MultiCanvasBridge | Same 5-canvas requirement. Falls back to WebGL on demo page. |
+
+## Remaining Work
+
+1. **End-to-end browser validation** — Run FacetedSystem through WebGPU in a Chrome/Edge browser with WebGPU enabled and confirm correct visual output matches WebGL.
+2. **Quantum/Holographic single-canvas path** — Either provide a single-canvas WebGPU fallback or create a demo page with the required 5-canvas DOM structure.
+3. **Automated smoke test** — A Playwright test (with WebGPU-capable browser) that initializes the bridge, renders one frame, and confirms no errors.
+4. **Shader sync verification** — Extend `tools/shader-sync-verify.js` to also verify WGSL struct layouts match `packVIB3Uniforms()`.
+
+## Demo Page
+
+`docs/webgpu-live.html` — Tries WebGPU for FacetedSystem, always WebGL for Quantum/Holographic. Shows green "WEBGPU" or yellow "WEBGL" badge.
+
+## Testing
+
+WebGPU cannot be validated in headless CI without GPU support. Strategy:
+- CI: Run WebGL tests + shader lint + struct layout checks
+- Manual: Smoke test in Chrome/Edge with `chrome://flags/#enable-unsafe-webgpu`
+
+## File Locations
+
+- Backend: `src/render/backends/WebGPUBackend.js`
+- Bridge: `src/render/UnifiedRenderBridge.js`
+- Packing: `packVIB3Uniforms()` in UnifiedRenderBridge.js
+- WGSL shaders: `src/shaders/`
+- Demo: `docs/webgpu-live.html`

package/DOCS/archive/WEBGPU_STATUS_2026-02-15_STALE.md

@@ -0,0 +1,38 @@
+# WebGPU status and testing requirements
+
+This document records the current WebGPU backend state, what is implemented, and what is required
+to validate it in local development or CI.
+
+## Current status
+- **Backend scaffold:** `WebGPUBackend` initializes adapter/device, configures the canvas, manages
+  resize, and supports a clear-pass `renderFrame()` path.
+- **Async context creation:** `createRenderContextAsync()` can instantiate WebGPU contexts using
+  `{ backend: 'webgpu' }`.
+- **Resource tracking:** depth textures are registered in the shared `RenderResourceRegistry`.
+
+## What is still needed
+1. **Pipeline parity:** implement basic shader pipelines (vertex/fragment) and buffer binding that
+   match the WebGL backend command flow.
+2. **Command buffer bridge:** map existing render commands to WebGPU render passes.
+3. **Feature gating:** add host-app controls to toggle WebGPU via feature flags.
+4. **Diagnostics:** add per-frame stats and resource delta reporting for WebGPU.
+
+## Testing requirements
+### Local smoke test
+Prerequisites:
+- A browser with WebGPU enabled (Chrome/Edge with `chrome://flags/#enable-unsafe-webgpu`, or a
+  Chromium build with WebGPU support).
+- A device with WebGPU-capable GPU drivers.
+
+Suggested smoke flow:
+1. Create a canvas and call `createRenderContextAsync(canvas, { backend: 'webgpu' })`.
+2. Call `backend.renderFrame({ clearColor: [0.1, 0.1, 0.2, 1] })` and confirm the canvas clears.
+3. Resize the canvas and ensure the clear pass still succeeds.
+
+### CI validation
+- WebGPU cannot be reliably validated in headless CI without GPU support.
+- CI should instead run WebGL tests and lint/static checks; keep a manual WebGPU smoke checklist.
+
+## File locations
+- `src/render/backends/WebGPUBackend.js`
+- `src/render/index.js` (`createRenderContextAsync`)

package/DOCS/dev-tracks/DEV_TRACK_SESSION_2026-02-13.md

@@ -76,6 +76,19 @@ Implementing the concrete runtime pieces described in `DOCS/AGENT_HARNESS_ARCHIT
 | `package.json` | Only if parallel work adds exports | Our changes don't touch package.json |
 | `src/creative/` | New files only | No conflict — `ChoreographyPlayer.js` and `AestheticMapper.js` are new |
 
+### Phase 3 — Tests, Skills Update, Example Choreographies (Commit 3)
+
+Completing the harness work with tests, skill updates, and example content:
+
+1. **Updated `.claude/commands/vib3-design.md`** — Added 4 new workflows: Natural Language Design (Workflow 1), Multi-Scene Choreography (Workflow 6), Agent Visual Feedback Loop (Workflow 7), re-numbered existing workflows; updated tool count (19→31), file references, "When User Says" table with new tool mappings
+2. **Updated `.claude/commands/vib3-dev.md`** — Added ChoreographyPlayer and AestheticMapper to creative tooling table, updated tool count (19→31), test count (4→6)
+3. **ChoreographyPlayer tests** (`tests/creative/ChoreographyPlayer.test.js`, 29 tests) — constructor, load, getState, seek, seekToPercent, scene transitions, stop, destroy, COLOR_PRESET_MAP
+4. **AestheticMapper tests** (`tests/creative/AestheticMapper.test.js`, 32 tests) — mapDescription, resolveToValues, getVocabulary, getVocabularyByCategory, VOCABULARY static, partial matching, real-world descriptions
+5. **MCP harness tool tests** (`tests/agent/MCPHarnessTools.test.js`, 25 tests) — designFromDescription, getAestheticVocabulary, captureScreenshot, createChoreography, playChoreographyTool, createTimeline, controlTimeline, describeVisualState
+6. **Example choreographies** (`examples/choreographies/`) — 3 ready-to-play specs: cosmic-journey (60s, 3 scenes), meditation-breath (30s loop), energy-burst (20s, 140 BPM)
+
+---
+
 ## Notes for Future Sessions
 
 - `ChoreographyPlayer` imports `ParameterTimeline` and `TransitionAnimator` from `src/creative/`

package/DOCS/dev-tracks/DEV_TRACK_SESSION_2026-02-15.md

@@ -0,0 +1,142 @@
+# Development Session — 2026-02-15
+
+**Session type**: Layer Architecture Redesign, Codebase Audit, Preset/Reactivity Expansion
+**Branch**: `claude/vib3-sdk-handoff-p00R8`
+**Operator**: Claude Code (Opus 4.6)
+**Parent work**: Builds on Feb 13 agent harness + Feb 6 RendererContract work
+
+---
+
+## Session Overview
+
+### Phase 1 — Layer Architecture Redesign
+
+The original 5-layer canvas system used static multipliers — every layer received identical parameters scaled by hardcoded opacity/density/speed factors. This produced "the same shader pasted 5 times with different opacity" instead of actual inter-layer dynamics.
+
+**Built**: `LayerRelationshipGraph` — a keystone-driven system where one layer drives and others derive their parameters through configurable relationship functions.
+
+6 preset relationship types:
+| Preset | Behavior |
+|--------|----------|
+| `echo` | Attenuated follower (same params, scaled down) |
+| `mirror` | Inverts rotation planes, shifts hue 180° |
+| `complement` | Color complement, density inverted around pivot |
+| `harmonic` | Density at integer multiples, hue at golden angle intervals |
+| `reactive` | Amplifies parameter deltas over time |
+| `chase` | Lerps toward keystone with configurable delay |
+
+5 named profiles that configure the full 5-layer graph:
+- `holographic` — content drives, echo/complement/harmonic/reactive
+- `symmetry` — mirror mode with chase accent
+- `chord` — all harmonic at musical intervals
+- `storm` — all reactive with increasing gain
+- `legacy` — replicates old static multiplier behavior exactly
+
+### Phase 2 — TypeScript Type Audit
+
+Found and fixed 4 type definition issues:
+1. Export name mismatch (RELATIONSHIP_PRESETS → PRESET_REGISTRY)
+2. Missing MultiCanvasBridge type definition
+3. Broken barrel file (types/render/index.d.ts)
+4. Incorrect exports in types/adaptive-sdk.d.ts
+
+### Phase 3 — Comprehensive Codebase Audit
+
+Found and fixed 7 critical issues across the SDK:
+
+| File | Problem | Fix |
+|------|---------|-----|
+| `src/math/index.js` | Top-level `await import()` breaks bundlers | Static imports |
+| `src/render/index.js` | `require()` in ESM package | Static ESM import |
+| `src/scene/index.js` | `require()` in `createSceneContext()` | Use already-imported classes |
+| `src/export/index.js` | 8 missing exports | Added ShaderExporter, VIB3PackageExporter, etc. |
+| `src/reactivity/index.js` | `console.log()` side effect in barrel | Removed |
+| `package.json` | Missing `./creative`, `./export`, `./variations` entry points | Added |
+| `types/` | Mismatched export names, missing barrel re-exports | Fixed all |
+
+### Phase 4 — CLAUDE.md Rewrite
+
+Rewrote CLAUDE.md from 224 → 366 lines:
+- Fixed MCP tool count (12 → 31) with full categorized table
+- Added LayerRelationshipGraph documentation
+- Added all new file references
+- Added recent session work section
+- Added 4 new gotchas (ESM only, 31 tools, layer defaults, initialize check)
+- Updated test count, status, documentation map with staleness notes
+
+### Phase 5 — LayerPresetManager + Reactivity Wiring + MCP Tools
+
+Built the preset management and reactivity-driven layer modulation system:
+
+**LayerPresetManager** (`src/render/LayerPresetManager.js`):
+- Save/load/delete/list user presets
+- Create presets from current graph state
+- Tune individual relationship parameters at runtime
+- Persist presets to localStorage
+- Import/export preset libraries as JSON
+
+**Reactivity-driven layer modulation** (`src/render/LayerReactivityBridge.js`):
+- Audio frequency bands modulate relationship parameters (e.g., bass → reactive gain)
+- Device tilt/gyroscope modulates relationship configs
+- Configurable modulation mappings per input source
+- Pre-built modulation profiles (audioStorm, tiltHarmonic, etc.)
+
+**MCP tools** (5 new layer control tools):
+- `set_layer_profile` — Load a named layer profile
+- `set_layer_relationship` — Set relationship for a specific layer
+- `set_layer_keystone` — Change the keystone layer
+- `get_layer_config` — Get current layer configuration
+- `tune_layer_relationship` — Adjust config on an active relationship
+
+---
+
+## Files Created
+
+| File | Purpose | ~Lines |
+|------|---------|--------|
+| `src/render/LayerRelationshipGraph.js` | Keystone-driven inter-layer parameter system | 610 |
+| `src/render/LayerPresetManager.js` | Preset save/load/tune for layer relationships | ~300 |
+| `src/render/LayerReactivityBridge.js` | Audio/tilt/input → layer relationship modulation | ~280 |
+| `types/render/LayerRelationshipGraph.d.ts` | Full TypeScript definitions | 120 |
+| `types/render/LayerPresetManager.d.ts` | TypeScript definitions for preset manager | ~60 |
+| `types/render/LayerReactivityBridge.d.ts` | TypeScript definitions for reactivity bridge | ~70 |
+| `tests/render/LayerRelationshipGraph.test.js` | 63 tests for relationship graph | 450 |
+| `tests/render/LayerPresetManager.test.js` | Tests for preset manager | ~200 |
+| `tests/render/LayerReactivityBridge.test.js` | Tests for reactivity bridge | ~200 |
+| `pages/layer-demo.html` | Visual demo for testing layer dynamics | ~300 |
+| `DOCS/dev-tracks/DEV_TRACK_SESSION_2026-02-15.md` | This file | — |
+
+## Files Modified
+
+| File | Change |
+|------|--------|
+| `src/render/MultiCanvasBridge.js` | Integrated LayerRelationshipGraph for per-layer parameter resolution |
+| `src/holograms/RealHolographicSystem.js` | Added layer graph integration, `loadRelationshipProfile()`, `setKeystone()`, `setLayerRelationship()` |
+| `src/render/index.js` | Fixed `require()` → ESM, added LayerRelationshipGraph + PresetManager + ReactivityBridge exports |
+| `src/math/index.js` | Fixed top-level `await import()` → static imports |
+| `src/scene/index.js` | Fixed `require()` → use imported classes |
+| `src/export/index.js` | Added 8 missing exports |
+| `src/reactivity/index.js` | Removed `console.log()` side effect |
+| `src/agent/mcp/tools.js` | Added 5 layer control tool definitions |
+| `src/agent/mcp/MCPServer.js` | Added 5 layer control handlers |
+| `package.json` | Added `./creative`, `./export`, `./variations` entry points |
+| `types/adaptive-sdk.d.ts` | Fixed export names, added layer system re-exports |
+| `types/render/index.d.ts` | Added LayerRelationshipGraph, PresetManager, ReactivityBridge re-exports |
+| `types/systems/index.d.ts` | Added layer relationship API to RealHolographicSystem |
+| `CLAUDE.md` | Comprehensive rewrite (224 → 366 lines) |
+
+## Test Results
+
+- **Before session**: 1430 tests, 70 files
+- **After session**: 1702+ tests, 75+ files
+- All passing
+
+## Commits
+
+| Hash | Message |
+|------|---------|
+| `59fb951` | feat(render): add LayerRelationshipGraph — keystone-driven inter-layer parameter system |
+| `bec4cad` | fix(types): correct export names and barrel re-exports for LayerRelationshipGraph |
+| `aeac38c` | fix: resolve 7 broken barrel files, require() in ESM, missing exports |
+| `4031700` | docs: comprehensive CLAUDE.md rewrite |
+| (pending) | feat: LayerPresetManager, LayerReactivityBridge, MCP layer tools, demo page |

package/DOCS/dev-tracks/DEV_TRACK_SESSION_2026-02-16.md

@@ -0,0 +1,108 @@
+# Development Session — 2026-02-16
+
+**Session type**: Architecture Bug Fixes, Shader Consistency, Documentation Sweep
+**Branch**: `claude/vib3-sdk-handoff-p00R8`
+**Operator**: Claude Code (Opus 4.6)
+**Parent work**: Continues from Feb 15 layer architecture + codebase audit
+
+---
+
+## Session Overview
+
+### Phase 1 — Bug Fixes & Geometry Differentiation (committed in `7debad8`)
+
+- Fixed QuantumVisualizer `canvasId` reference error — 6 sites used undefined variable, replaced with `this._canvasLabel`
+- Differentiated tetrahedron lattice (geometry 0) from hypercube (geometry 1) using tetrahedral symmetry planes in GLSL + WGSL
+- Updated CLAUDE.md geometry docs: "24 geometries" → "24 geometry variants (8 base shapes × 3 warp modes)"
+
+### Phase 2 — Shader Module Infrastructure (committed in `7debad8`)
+
+- Added `resolveIncludes()` and `loadAndResolve()` to `src/render/ShaderLoader.js` for `#include` / `// @include` directive resolution
+- Added warp functions (`warpHypersphereCore`, `warpHypertetraCore`, `applyCoreWarp`) to external `geometry24.glsl` and `geometry24.wgsl`
+
+### Phase 3.1 — Holographic Uniform Standardization (committed in `7debad8`)
+
+- Renamed shader uniforms: `u_density` → `u_gridDensity`, `u_morph` → `u_morphFactor`, `u_geometryType` → `u_geometry`
+- Updated JS uniform location lookups to match
+
+### Phase 3.3 — Quantum Layer Detection Bug Fix (committed in `5e1b4c5`)
+
+- **Bug**: Shader float comparison values didn't match JS `roleIntensities`. Only background (fallthrough) and content (1.0) worked; shadow, highlight, accent were broken.
+- **Fix**: Aligned shader values to match JS (0.6, 1.0, 1.3, 1.6), added epsilon comparison (`abs() < 0.05`), moved roleIntensities to module-scope `ROLE_INTENSITIES` constant.
+
+### Phase 3.2 — Remove mapParameterName() (committed in `9d73627`)
+
+- Renamed `generateVariantParams()` return keys: `geometryType`→`geometry`, `density`→`gridDensity`, `morph`→`morphFactor`
+- Renamed `geometryConfigs` object keys to match
+- Updated `generateRoleParams()` to use `vp.gridDensity`
+- Updated uniform location map keys to match SDK names directly
+- Consolidated duplicate geometry uniform set in render()
+- Deleted `mapParameterName()` method
+- Removed debug `console.log` from density scaling
+
+### Phase 2.3 — rotateXZ Sign Convention Alignment (committed in `3198645`)
+
+- **Discovery**: External shader files (ShaderLib, rotation4d.glsl/wgsl, WebGPUBackend, WebGPURenderer.ts) had opposite sign convention for `rotateXZ` compared to all 3 inline system shaders
+- **Fix**: Aligned all external/shared sources to match the inline (working) convention: `col0=(c,0,s,0)`, `col2=(-s,0,c,0)`
+- 7 files fixed: ShaderProgram.js, WebGPUBackend.js, rotation4d.glsl, rotation4d.wgsl, quantum.frag.wgsl, holographic.frag.wgsl, WebGPURenderer.ts
+
+### Phase 5 — Documentation Updates
+
+- SYSTEM_INVENTORY.md: "12 MCP tools" → "36 agent-accessible tools"
+- MASTER_PLAN: "14 tools" → "36 tools", "693+ tests" → "1762 tests"
+- CLAUDE.md: Updated doc map staleness notes, added Feb 16 shipped items, added session work section
+
+---
+
+## Files Modified
+
+| File | Changes |
+|---|---|
+| `src/quantum/QuantumVisualizer.js` | canvasId bug fix, layer detection epsilon fix, ROLE_INTENSITIES constant |
+| `src/faceted/FacetedSystem.js` | Tetrahedron lattice differentiation (GLSL + WGSL) |
+| `src/holograms/HolographicVisualizer.js` | Uniform rename, mapParameterName removal, variantParams key rename |
+| `src/render/ShaderLoader.js` | resolveIncludes(), loadAndResolve() |
+| `src/render/ShaderProgram.js` | ShaderLib rotateXZ sign fix |
+| `src/render/backends/WebGPUBackend.js` | rotateXZ sign fix |
+| `src/shaders/common/rotation4d.glsl` | rotateXZ sign fix |
+| `src/shaders/common/rotation4d.wgsl` | rotateXZ sign fix |
+| `src/shaders/common/geometry24.glsl` | Added warp functions |
+| `src/shaders/common/geometry24.wgsl` | Added warp functions |
+| `src/shaders/faceted/faceted.frag.wgsl` | Tetrahedron differentiation, struct fixes |
+| `src/shaders/quantum/quantum.frag.wgsl` | rotateXZ sign fix |
+| `src/shaders/holographic/holographic.frag.wgsl` | rotateXZ sign fix |
+| `src/ui/adaptive/renderers/webgpu/WebGPURenderer.ts` | rotateXZ sign fix |
+| `CLAUDE.md` | Geometry docs, shipped items, session work, doc map notes |
+| `DOCS/SYSTEM_INVENTORY.md` | Tool count 12 → 36 |
+| `DOCS/MASTER_PLAN_2026-01-31.md` | Tool count 14 → 36, test count 693 → 1762 |
+| `tools/shader-sync-verify.js` | Fixed stale Holographic uniforms (u_density→u_gridDensity, removed u_geometryType, u_morph→u_morphFactor), added missing Faceted uniforms (u_mouse, u_roleIntensity), updated comments |
+
+---
+
+## Commits
+
+| Hash | Message |
+|---|---|
+| `7debad8` | refactor: Phase 1-3 architecture fixes — bugs, shader modules, uniform standardization |
+| `5e1b4c5` | fix(quantum): align layer detection values with JS roleIntensities |
+| `9d73627` | refactor(holographic): remove mapParameterName() translation layer |
+| `3198645` | fix(shaders): align rotateXZ sign convention across all shader sources |
+| `2ce407d` | docs: update stale tool/test counts, add Feb 16 dev track |
+| (pending) | fix(tools): update stale embedded shaders in shader-sync-verify.js |
+
+---
+
+## Test Results
+
+- **Before**: 1762 tests, 77 files (all passing)
+- **After**: 1762 tests, 77 files (all passing)
+- No new tests added this session (bug fixes and refactoring of existing code)
+
+## Decisions Made
+
+1. **Keep per-system color personality** — Quantum's hue normalization (0-1 in JS) is intentional, not a bug
+2. **Keep role-intensity layer detection** — User wants layer relations to follow 4D rotation principles; used epsilon comparison instead of integer indices
+3. **Dropped GeometryPresets phase** — VariationManager already implements 100-slot preset system
+4. **Dropped FrameBudget phase** — Adaptive rendering infrastructure exists in `src/ui/adaptive/`
+5. **Dropped context loss recovery phase** — Already properly implemented in both QuantumVisualizer and HolographicVisualizer
+6. **rotateXZ convention** — Aligned all external files to match inline (working) convention rather than vice versa

package/docs/webgpu-live.html

@@ -477,7 +477,7 @@
 
             // Render active system
             if (activeSystem === 'faceted' && faceted) {
-                faceted.renderFrame();
+                faceted.render();
             } else if (activeSystem === 'quantum' && quantum) {
                 quantum.render();
             } else if (activeSystem === 'holographic' && holographic) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vib3code/sdk",
-  "version": "2.0.3-canary.91a95f3",
+  "version": "2.0.3-canary.ef8d292",
   "description": "VIB3+ 4D Visualization SDK - Unified engine with 6D rotation, MCP agentic integration, and cross-platform support",
   "type": "module",
   "main": "src/core/VIB3Engine.js",
@@ -200,6 +200,9 @@
     "./reactivity/config": {
       "import": "./src/reactivity/ReactivityConfig.js"
     },
+    "./creative": {
+      "import": "./src/creative/index.js"
+    },
     "./creative/color-presets": {
       "import": "./src/creative/ColorPresetsSystem.js"
     },
@@ -212,6 +215,9 @@
     "./creative/timeline": {
       "import": "./src/creative/ParameterTimeline.js"
     },
+    "./export": {
+      "import": "./src/export/index.js"
+    },
     "./integrations/react": {
       "import": "./src/integrations/frameworks/Vib3React.js"
     },
@@ -248,6 +254,9 @@
     "./advanced/offscreen": {
       "import": "./src/advanced/OffscreenWorker.js"
     },
+    "./variations": {
+      "import": "./src/variations/VariationManager.js"
+    },
     "./tools/shader-sync": {
       "import": "./tools/shader-sync-verify.js"
     },

package/src/agent/index.js

@@ -68,6 +68,4 @@ export {
     createStreamingCLI
 } from './cli/index.js';
 
-// Default exports
-export { telemetry } from './telemetry/index.js';
-export { mcpServer } from './mcp/index.js';
+// telemetry and mcpServer already exported above