@vib3code/sdk 2.0.1 → 2.0.3-canary.0a63e71

package/DOCS/SCROLL_TIMELINE_v3.md

@@ -0,0 +1,271 @@
+Last reviewed: 2026-02-17
+
+# VIB3+ Landing Page — Complete Scroll Timeline v3
+
+## GPU-First Redesign: Real Visualizers Everywhere
+
+**Core principle**: Canvas2D (AmbientLattice) is ONLY for the cascade cards (small cards where GPU contexts would be wasted). Every section background, every dramatic moment uses REAL GPU systems — Quantum, Holographic, Faceted — in coordinated multi-system arrangements.
+
+**ContextPool budget**: Max 3 concurrent. Sections are sequential + pinned, so we acquire/release at boundaries.
+
+---
+
+## SCROLL MAP (Approximate vh positions)
+
+```
+Position    Section              GPU Contexts Active        Multi-System Events
+─────────── ──────────────────── ─────────────────────────── ─────────────────────────
+0-800vh     OPENING              1: Quantum (opening)        Solo: canvas → text mask → lattice
+~800vh      divider              0→1 swap                    Portal glow transition
+800-900vh   HERO                 1: Quantum (hero)           Solo: parameter arc builds energy
+~900vh      divider              1→1 swap                    Flash handoff hero→morph
+900-2100vh  MORPH (pinned)       1: Q→H→F rotating          System swap choreography
+~2100vh     divider              1→1                         Portal out
+2100-2400vh PLAYGROUND           1: user-controlled          Interactive — user drives
+~2400vh     divider              1→3 acquire                 Three-system awakening
+2400-2600vh TRIPTYCH             3: Q+H+F split-screen       ★ CLIP-PATH TERRITORY WAR
+~2600vh     divider              3→2 swap                    ★ TRIPTYCH→CASCADE HANDOFF
+2600-3000vh CASCADE (pinned)     2: Q+H background           ★ DUAL GPU BEHIND CARDS
+                                  + Canvas2D cards            GPU systems react to active card
+~3000vh     divider              2→2 swap                    ★ CASCADE→ENERGY HANDOFF
+3000-3250vh ENERGY (pinned)      2: Q bg + F card            ★ TWO-SYSTEM ENERGY EXCHANGE
+~3250vh     divider              2→1                         Drain → agent
+3250-3400vh AGENT                1: H background             GPU holographic behind code
+~3400vh     divider              1→2 acquire                 ★ FINALE BUILDS
+3400-3500vh CTA                  2: Q+F dueling              ★ DUAL SYSTEM FINALE
+~3500vh     footer               0                           Silence
+```
+
+---
+
+## SECTION-BY-SECTION CHOREOGRAPHY
+
+### 1. OPENING (0-800vh) — Solo Quantum
+
+**GPU**: 1 context (Quantum → `opening-canvas`)
+**Multi-system**: None (intentional — solo introduction)
+
+| Scroll %  | Phase                    | Parameters                          |
+|-----------|--------------------------|-------------------------------------|
+| 0-12%     | Dark canvas, subtle      | intensity: 0.3→0.5, geo: 11        |
+| 12-35%    | Text letters cascade in  | hue: 220→280, rot4dXW accelerates   |
+| 28-48%    | SVG mask: canvas through text | chaos: 0.05→0.4, speed rises    |
+| 45-75%    | Lattice parallax layers  | gridDensity oscillates, dimension drops |
+| 74-96%    | Text fades, lattice locks| speed settles, intensity peaks 0.85 |
+| 96-100%   | Everything fades out     | intensity→0                         |
+
+---
+
+### 2. HERO (800-900vh) — Solo Quantum
+
+**GPU**: 1 context (Quantum → `hero-canvas`)
+
+| Scroll %  | Phase                    | Parameters                          |
+|-----------|--------------------------|-------------------------------------|
+| 0-25%     | Calm lattice, badges in  | geo: 3, speed: 0.4, chaos: 0.05    |
+| 25-55%    | Geometry shift, energy builds | geo: 2→4, rot4dXW ramps, density↑ |
+| 55-80%    | Peak energy              | hue sweeps 210→290, chaos↑, morph peaks |
+| 80-100%   | Dramatic 4D rotation burst | rot4dZW spike, dimension drops     |
+
+Content: Badge → title chars → subtitle → system label → scroll indicator
+
+---
+
+### 3. MORPH (900-2100vh pinned) — Rotating Single System
+
+**GPU**: 1 context, swaps Q(stages 0-1) → H(stages 2-3) → F(stages 4-5)
+
+6 stages, each ~200vh:
+- **Emergence**: Low density, slow, Quantum
+- **Dimensional Shift**: rot4dXW ramps, Quantum
+- **Three Voices**: Voice labels appear, Holographic
+- **Convergence**: Card grows, density peaks, Holographic
+- **Spectral Rupture**: Card near-fullscreen, max chaos/speed, Faceted
+- **Resolution**: Card shrinks, calm, Faceted
+
+Card morphs: circle → rounded rect → holds → grows → near-fullscreen → medium
+
+---
+
+### 4. PLAYGROUND (2100-2400vh) — User-Controlled
+
+**GPU**: 1 context (user picks Q/H/F)
+No choreography — user drives all params via sliders.
+
+---
+
+### 5. TRIPTYCH (2400-2600vh) — ★ THREE-SYSTEM SPLIT-SCREEN
+
+**GPU**: 3 contexts (Quantum left, Holographic center, Faceted right)
+
+This is the first multi-system moment. All 3 visualization engines running simultaneously.
+
+| Scroll %  | Phase                        | Coordination Event                      |
+|-----------|------------------------------|-----------------------------------------|
+| 0-15%     | Columns slide in             | Left dominates (40% width), right small (26%) |
+| 15-30%    | Systems differentiate        | Triadic hue rotation, phase-locked 4D rotation at 120° offsets |
+| 30-50%    | ★ CONVERGENCE                | Columns equalize, shared heartbeat peaks, hues pull toward unity |
+| 50-70%    | Call & response              | Left chaos → center speed → right morph (chain reaction) |
+| 70-85%    | Right dominates              | Split lines shift: right takes 40%, left shrinks to 26% |
+| 85-100%   | ★ CRYSTALLIZATION BRIDGE     | All 3 systems: density↑↑, speed→0, chaos→0 (frozen moment) |
+
+**Coordination signals** (all running simultaneously):
+1. **Shared heartbeat**: `sin(p * PI * 2)` — pulse all 3 systems breathe to
+2. **Energy conservation**: total intensity ≈ 2.0 distributed across 3 systems
+3. **Triadic hue**: base rotates, each system 120° apart, converges at midpoint
+4. **Phase-locked 4D**: rot4dXW at 0°, 120°, 240° — a coordinated 4D dance
+5. **Density cross-feed**: left ramps up, right ramps down, center bridges
+6. **Call & response**: left chaos → center speed → right morphFactor chain
+7. **Mouse X shifts split lines**: cursor position moves column boundaries ±6%
+
+---
+
+### 6. CASCADE (2600-3000vh pinned) — ★ DUAL GPU + Canvas2D Cards
+
+**GPU**: 2 contexts (Quantum + Holographic as shared background)
+**Canvas2D**: AmbientLattice for individual card faces only
+
+**NEW**: Two real GPU systems render as a SPLIT-SCREEN BACKGROUND behind the scrolling cards. As the active card changes, the GPU backgrounds react — one mirrors the card's geometry, the other plays the complementary opposite. The card scroll position drives the split line between the two GPU backgrounds.
+
+| Scroll %  | Phase                         | GPU Background Behavior                |
+|-----------|-------------------------------|----------------------------------------|
+| 0-10%     | Cards enter with stagger      | Q+H backgrounds fade in, split 50/50   |
+| 10-30%    | Card 0 active (Tetra, 190°)   | Q mirrors: geo 0, hue 190. H opposes: geo 16, hue 10 |
+| 30-50%    | Card 1 active (HTorus, 300°)  | Q: geo 11, hue 300. H: geo 5, hue 120  |
+| 50-70%    | Card 2 active (HTetra, 35°)   | Q: geo 16, hue 35. H: geo 2, hue 215   |
+| 70-90%    | Card 3+ active                | Split line tracks card position         |
+| 90-100%   | Cards exit, GPUs crystallize  | Both systems converge to same params    |
+
+**Card-GPU coordination**:
+- Active card's AmbientLattice params echo into GPU backgrounds (dampened)
+- GPU backgrounds' rotation drives CSS `--q-xw` for card tilt effects
+- Split between Q and H follows mouse X position ±15% from center
+- When cards cross the GPU split line: flash transition, hue swap
+
+---
+
+### 7. ENERGY (3000-3250vh pinned) — ★ TWO-SYSTEM ENERGY EXCHANGE
+
+**GPU**: 2 contexts (Quantum background + Faceted card)
+
+Two real GPU systems that actively EXCHANGE energy through the GSAP timeline.
+
+| Scroll %  | Phase                         | Multi-System Event                      |
+|-----------|-------------------------------|-----------------------------------------|
+| 0-15%     | BG awakens, card enters       | Q bg: low intensity. F card: rising from below |
+| 15-30%    | Card overshoot + settle       | Q bg: responds to card motion — intensifies as card peaks |
+| 30-50%    | Hold — tilt interactive       | Q bg + F card: counter-rotation. Card chaos → bg brightness |
+| 50-60%    | ★ ENERGY DRAIN                | Card intensity drains TO background. Q bg: max intensity, hue shifts |
+| 60-75%    | ★ GEOMETRY MORPH              | Card & bg swap geometries — card gets bg's geo, bg gets card's |
+| 75-88%    | ★ ENERGY RETURN               | Background drains back TO card. Inverse of drain phase |
+| 88-100%   | Card spins out                | Q bg fades, card exits with rotation    |
+
+**"Energy Transfer" button**: Triggers full drain→morph→return cycle as a GSAP timeline independent of scroll:
+1. Card: intensity 0.6→0.05, density 30→4, chaos spikes
+2. Background: intensity 0.2→0.8, density 16→55, hue shifts 90°
+3. Both: geometry swap, rot4dXW = PI
+4. Reverse: everything smoothly returns over 2.5s
+
+---
+
+### 8. AGENT (3250-3400vh) — Single GPU Background
+
+**GPU**: 1 context (Holographic → `agent-canvas`)
+
+**NEW**: Replace Canvas2D with Holographic GPU system. The 5-layer glassmorphic holographic system is perfect behind glassmorphic agent cards — visual language matches.
+
+| Scroll %  | Phase                        | GPU Behavior                           |
+|-----------|------------------------------|----------------------------------------|
+| 0-20%     | Header reveals               | H: low intensity, geo 3, slow          |
+| 20-60%    | Agent cards stagger in       | H: each card reveal triggers a density pulse |
+| 60-80%    | Code block reveals           | H: hue shifts toward code-highlight colors |
+| 80-100%   | ★ CRESCENDO BUILD            | H: speed↑↑, chaos↑↑, density↑↑, vignette closes |
+
+**Speed crescendo** (pre-CTA dramatic tension):
+- 60% → 80%: All params accelerate exponentially
+- 80% → 88%: THE SILENCE — everything drops to zero, full black
+- 88% → 100%: Gentle rebirth — minimal intensity, slow speed, setting up CTA
+
+---
+
+### 9. CTA (3400-3500vh) — ★ DUAL SYSTEM FINALE
+
+**GPU**: 2 contexts (Quantum + Faceted as dueling finales)
+
+**NEW**: The final section gets TWO real GPU systems that DUEL — split screen, opposing parameters, converging at the end to create a unified "come together" moment.
+
+| Scroll %  | Phase                         | Multi-System Event                      |
+|-----------|-------------------------------|-----------------------------------------|
+| 0-20%     | Emerge from silence           | Q left, F right — both at intensity 0.1, slowly rising |
+| 20-40%    | Systems differentiate         | Q: cool hues, high density, slow. F: warm, low density, fast |
+| 40-60%    | ★ OPPOSITION                  | Q + F: opposing rotations, complementary hues, fighting |
+| 60-80%    | ★ CONVERGENCE                 | Systems pull toward matching params — hues merge, speed syncs |
+| 80-100%   | ★ UNITY                       | Both match: same hue, same rotation, same geometry — ONE SYSTEM |
+
+**Split line**: Diagonal (not vertical) — rotates from 45° to 0° (horizontal) to vertical during scroll.
+
+---
+
+## CROSS-SECTION COORDINATION EVENTS
+
+### A. Triptych → Cascade Handoff (~2600vh)
+1. Triptych's 3 GPUs crystallize (density max, speed zero, frozen)
+2. Release 1 GPU (Faceted), keep Quantum + acquire Holographic for cascade BG
+3. Flash transition on divider SVG
+4. Cascade cards stagger-appear with chaos burst
+
+### B. Cascade → Energy Handoff (~3000vh)
+1. Cascade's dual BG systems converge to identical params
+2. Release Holographic, swap Quantum to energy-bg, acquire Faceted for energy card
+3. Energy card enters from below through cascade's frozen background
+
+### C. Energy → Agent Handoff (~3250vh)
+1. Energy's dual GPUs drain (card spins out, background fades)
+2. Release both, acquire 1 Holographic for agent background
+3. Agent section fades in over holographic backdrop
+
+### D. Agent → CTA Handoff (~3400vh)
+1. Agent Holographic accelerates in speed crescendo
+2. THE SILENCE — everything drops to black
+3. Release Holographic, acquire Quantum + Faceted for CTA finale
+4. Dual systems emerge from darkness
+
+---
+
+## GPU CONTEXT LIFECYCLE (Max 3 Concurrent)
+
+```
+Section     | Slot 1          | Slot 2          | Slot 3
+─────────── | ─────────────── | ─────────────── | ───────────────
+Opening     | Quantum         |                 |
+Hero        | Quantum         |                 |
+Morph       | Q/H/F rotating  |                 |
+Playground  | Q/H/F user      |                 |
+Triptych    | Quantum         | Holographic     | Faceted
+Cascade     | Quantum         | Holographic     |
+Energy      | Quantum         | Faceted         |
+Agent       | Holographic     |                 |
+CTA         | Quantum         | Faceted         |
+```
+
+Peak usage: Triptych at 3/3. All other multi-system sections use 2/3.
+
+---
+
+## MOUSE/TOUCH REACTIVITY (Global)
+
+Every visible GPU system responds to mouse position:
+- **Triptych**: Mouse X shifts clip-path split lines (columns fight for space)
+- **Cascade**: Mouse X shifts GPU background split line
+- **Energy**: Mouse drives card tilt + background counter-rotation
+- **CTA**: Mouse shifts diagonal split line angle
+- **All sections**: Mouse Y drives subtle intensity modulation on visible GPU systems
+
+---
+
+## CANVAS2D (AmbientLattice) — MINIMAL USAGE
+
+AmbientLattice ONLY used for:
+1. **Cascade card faces** (4-6 small cards — GPU contexts would be wasted on small canvases)
+
+NOT used for: energy background, agent background, CTA background (all now GPU)

package/DOCS/SITE_REFACTOR_PLAN.md

@@ -0,0 +1,102 @@
+Last reviewed: 2026-02-17
+
+# VIB3+ Landing Page Refactor Plan
+
+**Date:** 2026-02-13
+**Status:** Phase 1 Complete (CSS extraction + redirect)
+
+---
+
+## Problem Statement
+
+The root `index.html` served by GitHub Pages was a bare SDK controls demo (sliders + canvas), not a landing page. The actual landing page at `site/index.html` existed but was:
+- **1,978 lines monolithic** — 1,318 lines of inline `<style>` + 660 lines of HTML
+- Not the default page visitors see
+- Hero section only mentioned "Three Systems / 24 Geometries / 6D Rotation" — ignored the C++ WASM core, WebGPU backend, TypeScript definitions, MCP server
+
+---
+
+## What Was Done (Phase 1)
+
+### 1. CSS Extraction: `site/index.html` (1978 → 659 lines)
+
+**Before:**
+```
+site/index.html           1978 lines (1318 CSS + 660 HTML)
+site/styles/overlay-accents.css   243 lines
+site/styles/reveal-layers.css     401 lines
+```
+
+**After:**
+```
+site/index.html           659 lines (pure HTML + semantic structure)
+site/styles/main.css      1318 lines (extracted from inline <style>)
+site/styles/overlay-accents.css   243 lines (unchanged)
+site/styles/reveal-layers.css     401 lines (unchanged)
+```
+
+All 1,318 lines of inline CSS moved to `site/styles/main.css`. The HTML now links:
+```html
+<link rel="stylesheet" href="./styles/main.css">
+<link rel="stylesheet" href="./styles/overlay-accents.css">
+<link rel="stylesheet" href="./styles/reveal-layers.css">
+```
+
+### 2. Root Redirect
+
+**Before:** Root `index.html` was the raw SDK controls demo.
+**After:** Root `index.html` is a meta-refresh redirect to `site/index.html`.
+
+The raw demo moved to `demo/index.html` (import paths adjusted from `./src/` to `../src/`).
+
+### 3. Content Updates
+
+| Location | Before | After |
+|----------|--------|-------|
+| Hero badge | `v2.0.1 — Three Systems · 24 Geometries · 6D Rotation` | `v2.0.3 — C++ WASM Core · WebGPU + WebGL · TypeScript` |
+| Hero subtitle | "The fourth dimension, rendered..." | "4D visualization SDK with a C++ Clifford algebra core compiled to WASM..." |
+| Hero system label | `Quantum Lattice Engine` | `C++ WASM · WebGPU · WebGL · MCP Agentic Control` |
+| Opening subtitle | `4D Visualization Engine` | `C++ WASM · WebGPU · WebGL · TypeScript · MCP` |
+| Triptych heading | `Three Systems. One Heartbeat.` | `Three Systems. One C++ Core.` |
+| Triptych stats | 24 Geometries / 6D Rotation / 3 Systems | C++ WASM Core / 24 Geometries / 6D Rotation / 19 MCP Tools |
+| CTA description | "WebGPU primary, WebGL fallback, C++ WASM math core" | Full architecture mention (Cl(4,0), dual backend, TS, MCP, framework integrations) |
+| CTA install | `npm install` | `pnpm add` |
+| Agent section | "Drop VIB3+ into any AI agent workflow" | "19-tool MCP server with JSON-RPC 2.0..." |
+
+---
+
+## File Structure After Refactor
+
+```
+/                           Root
+├── index.html              Redirect → site/index.html
+├── demo/
+│   └── index.html          SDK controls demo (moved from root)
+├── site/
+│   ├── index.html          Landing page (659 lines, HTML only)
+│   ├── styles/
+│   │   ├── main.css        Core landing page styles (1318 lines)
+│   │   ├── overlay-accents.css  Overlay accent effects (243 lines)
+│   │   └── reveal-layers.css   Reveal layer choreography (401 lines)
+│   └── js/
+│       ├── main.js         Boot script + GPU pool orchestrator (466 lines)
+│       ├── config.js       Section parameter presets (107 lines)
+│       ├── adapters.js     SDK system adapters (Quantum/Holographic/Faceted + AmbientLattice) (582 lines)
+│       ├── choreography.js GSAP scroll choreography (~1000+ lines)
+│       ├── ContextPool.js  WebGL context budget manager
+│       ├── CardTiltSystem.js  Mouse/touch → CSS 3D tilt + visualizer param mapping
+│       ├── overlay-choreography.js  Overlay layer scroll choreography
+│       └── reveal-choreography.js   Reveal layer scroll choreography
+├── docs/                   Gallery + exports + test hub
+└── src/                    SDK source (unchanged)
+```
+
+---
+
+## Phase 2 (Future)
+
+Potential further cleanup:
+- Extract remaining inline styles from `site/styles/main.css` into semantic sub-files (e.g., `hero.css`, `morph.css`, `playground.css`, `cascade.css`, etc.)
+- Consider a build step (even simple CSS concat) to reduce HTTP requests
+- Add proper `<nav>` component with links to Demo, Gallery, GitHub, npm
+- Add architecture diagram section showing the full stack (C++ → WASM → JS/TS → WebGPU/WebGL → Canvas)

package/DOCS/STATUS.md

@@ -0,0 +1,26 @@
+Last reviewed: 2026-02-17
+
+# VIB3+ SDK Status
+
+This file is the single source of truth for high-level release status.
+
+## Release metadata
+
+| Field | Status |
+|---|---|
+| Current package version | `2.0.3` (from `package.json`) |
+| Release date | Unreleased in repository changelog (pending release entry for `2.0.3`) |
+| Supported platforms | Web browsers, Node.js CLI/MCP workflows, WASM runtime, Flutter integration, and framework wrappers (React/Vue/Svelte) |
+
+## Test status
+
+Test status is CI-linked (not hardcoded):
+
+- Follow the baseline test/CI workflow in [`DOCS/CI_TESTING.md`](./CI_TESTING.md).
+- Check your repository CI provider (GitHub Actions or equivalent pipeline) for live pass/fail state.
+
+## Update policy
+
+- Update this file whenever `package.json` version changes.
+- Keep test status summary link-based (CI), not hardcoded with static pass-count numbers.
+- If the version is unreleased, explicitly mark it as unreleased until changelog/release publication is completed.

package/DOCS/SYSTEM_INVENTORY.md

@@ -1,9 +1,13 @@
+Last reviewed: 2026-02-17
+
 # VIB3+ SDK System Inventory
 
-**Document Version:** 2.0.0
-**Last Updated:** 2026-01-30
+**Document Version:** See `DOCS/STATUS.md`
+**Last Updated:** See `DOCS/STATUS.md`
 **Purpose:** Complete technical inventory for developers and AI agents
 
+> For canonical release metadata (version/date/platforms/test status), use [`DOCS/STATUS.md`](./STATUS.md) as the single source of release status.
+
 ---
 
 ## Executive Summary
@@ -22,20 +26,20 @@ The SDK provides 3 active visualization systems with shared 6D rotation mathemat
 
 | Metric | Value |
 |--------|-------|
-| **SDK Version** | 2.0.0 |
+| **SDK Version** | See `DOCS/STATUS.md` |
 | **Visualization Systems** | 3 active (Quantum, Faceted, Holographic) + 1 archived (Polychora - TBD) |
 | **Rotation Planes** | 6 (XY, XZ, YZ for 3D; XW, YW, ZW for 4D) |
 | **Base Geometries** | 8 per system |
 | **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 |
 | **Platform Integrations** | 7 (React, Vue, Svelte, Figma, Three.js, TouchDesigner, OBS) |
 | **Advanced Modules** | 5 (WebXR, WebGPU Compute, MIDI, AI Presets, OffscreenWorker) |
-| **Test Coverage** | 694+ tests passing |
+| **Test Coverage** | CI-tracked status (see `DOCS/STATUS.md`) |
 
 ---
 
@@ -123,17 +127,17 @@ The SDK provides 3 active visualization systems with shared 6D rotation mathemat
 |----------|-------|
 | Canvas IDs | `background-canvas`, `shadow-canvas`, `content-canvas`, `highlight-canvas`, `accent-canvas` |
 | Geometries | 24 (8 base × 3 cores) |
-| Audio Reactive | Yes (bass/mid/high uniforms — wired in v2.0.0) |
-| Color Control | Full HSL (hue + saturation via `hsl2rgb()` — wired in v2.0.0) |
+| Audio Reactive | Yes (bass/mid/high uniforms — wired in current release series |
+| Color Control | Full HSL (hue + saturation via `hsl2rgb()` — wired in current release series |
 | Physics | No |
 
 **Core Features:**
 - Single WebGL context on `content-canvas`
 - Geometry functions in fragment shader
 - Core warp applied via `applyCoreWarp()` shader function
-- Full `hsl2rgb()` color pipeline with saturation control (v2.0.0)
-- Audio-reactive density/morph/hue shift (v2.0.0)
-- Click intensity boost (v2.0.0)
+- Full `hsl2rgb()` color pipeline with saturation control (current release series)
+- Audio-reactive density/morph/hue shift (current release series)
+- Click intensity boost (current release series)
 
 ### 3. Holographic System
 **File:** `src/holograms/RealHolographicSystem.js` (652 LOC)
@@ -243,7 +247,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 |
 |------|-------------|----------------|
@@ -341,10 +345,10 @@ class ResourceManagerContract {
 │   ├── agent/                    # MCP/CLI/Telemetry
 │   ├── export/                   # Export generators
 │   ├── wasm/                     # WASM loader
-│   ├── reactivity/               # Reactivity + SpatialInputSystem (v2.0.0)
-│   ├── creative/                 # Creative tooling (v2.0.0)
-│   ├── integrations/             # Platform integrations (v2.0.0)
-│   └── advanced/                 # Advanced features (v2.0.0)
+│   ├── reactivity/               # Reactivity + SpatialInputSystem (current release series)
+│   ├── creative/                 # Creative tooling (current release series)
+│   ├── integrations/             # Platform integrations (current release series)
+│   └── advanced/                 # Advanced features (current release series)
 ├── tools/                        # Tooling (+ shader-sync-verify.js)
 ├── cpp/                          # C++ math core (1,783 LOC)
 ├── js/                           # Client-side integration
@@ -394,14 +398,14 @@ Expected: `change_geometry`
 
 ## Current Development Status
 
-### Phase Status (as of v2.0.0, 2026-01-30)
+### Phase Status (historical baseline; current release status lives in `DOCS/STATUS.md`)
 | Phase | Status | Notes |
 |-------|--------|-------|
 | Phase 1: Foundation | ✅ Complete | Math, geometry, parameters |
 | Phase 2: Rendering | ✅ Mostly Complete | Contracts exist, adapters implemented |
 | Phase 3: Agentic | ✅ Complete | MCP, CLI, Telemetry working |
 | Phase 4: WebGPU | 🔄 In Progress | Scaffold exists, needs shader pipeline |
-| Phase 5: Hardening | ✅ Complete | 694 tests passing, XSS prevention, input validation |
+| Phase 5: Hardening | ✅ Complete | Security/input hardening completed; see `DOCS/STATUS.md` + CI for current test state |
 | **Phase A: Parity & Polish** | **✅ Complete** | Quantum color, Faceted saturation/audio, clickIntensity fix, shader sync tool |
 | **Phase B: Creative Tooling** | **✅ Complete** | Color presets, transitions, post-processing, timeline |
 | **Phase C: Platform Integrations** | **✅ Complete** | React, Vue, Svelte, Figma, Three.js, TouchDesigner, OBS |
@@ -417,7 +421,7 @@ Expected: `change_geometry`
 ### Remaining Gaps
 1. WebGPU backend needs full shader pipeline
 2. Some systems don't fully implement RendererContract
-3. New v2.0.0 modules need test coverage
+3. New current release-series modules need test coverage
 
 ---
 
@@ -429,18 +433,18 @@ Expected: `change_geometry`
 | WASM | ✅ Working | cpp/ → Emscripten → vib3.wasm |
 | Flutter | 🔄 Scaffold | src/platforms/flutter/ |
 | Node.js CLI | ✅ Working | src/agent/cli/ |
-| React | ✅ Component (v2.0.0) | src/integrations/frameworks/Vib3React.js |
-| Vue 3 | ✅ Component (v2.0.0) | src/integrations/frameworks/Vib3Vue.js |
-| Svelte | ✅ Component (v2.0.0) | src/integrations/frameworks/Vib3Svelte.js |
-| Three.js | ✅ ShaderMaterial (v2.0.0) | src/integrations/ThreeJsPackage.js |
-| Figma | ✅ Plugin (v2.0.0) | src/integrations/FigmaPlugin.js |
-| TouchDesigner | ✅ GLSL Export (v2.0.0) | src/integrations/TouchDesignerExport.js |
-| OBS Studio | ✅ Browser Source (v2.0.0) | src/integrations/OBSMode.js |
-| WebXR (VR/AR) | ✅ Renderer (v2.0.0) | src/advanced/WebXRRenderer.js |
+| React | ✅ Component (current release series) | src/integrations/frameworks/Vib3React.js |
+| Vue 3 | ✅ Component (current release series) | src/integrations/frameworks/Vib3Vue.js |
+| Svelte | ✅ Component (current release series) | src/integrations/frameworks/Vib3Svelte.js |
+| Three.js | ✅ ShaderMaterial (current release series) | src/integrations/ThreeJsPackage.js |
+| Figma | ✅ Plugin (current release series) | src/integrations/FigmaPlugin.js |
+| TouchDesigner | ✅ GLSL Export (current release series) | src/integrations/TouchDesignerExport.js |
+| OBS Studio | ✅ Browser Source (current release series) | src/integrations/OBSMode.js |
+| WebXR (VR/AR) | ✅ Renderer (current release series) | src/advanced/WebXRRenderer.js |
 
 ---
 
-## v2.0.0 New Systems
+## New Systems (current release series)
 
 ### SpatialInputSystem (`src/reactivity/SpatialInputSystem.js` — 1,783 lines)
 Universal spatial input that decouples "card tilting" from physical device orientation. Any input source maps through a normalized spatial state (pitch/yaw/roll/x/y/z/intensity/velocity) to any visualization parameter.
@@ -487,10 +491,10 @@ Verifies inline shaders match external shader files. Parses GLSL uniforms and WG
 ## Next Steps for Development
 
 ### Immediate Priorities
-1. Add test coverage for v2.0.0 modules (creative, integrations, advanced, SpatialInput)
+1. Add test coverage for current release-series modules (creative, integrations, advanced, SpatialInput)
 2. Complete WebGPU shader pipeline
 3. Production-harden platform integration wrappers
-4. Publish @vib3code/sdk v2.0.0 to NPM
+4. Publish current package version (see `DOCS/STATUS.md`) to NPM
 
 ### Consolidation Tasks
 - [ ] Audit RendererContract compliance for all 3 active systems
@@ -505,16 +509,17 @@ Verifies inline shaders match external shader files. Parses GLSL uniforms and WG
 
 | Document | Purpose |
 |----------|---------|
-| `CLAUDE.md` | Development instructions (v2.0.0 updated) |
+| `CLAUDE.md` | Development instructions |
 | `DEV_TRACK.md` | Session-by-session progress |
 | `DOCS/CLI_ONBOARDING.md` | Agent CLI setup |
 | `DOCS/CONTROL_REFERENCE.md` | UI control parameters |
 | `DOCS/RENDERER_LIFECYCLE.md` | Renderer architecture |
 | `DOCS/GPU_DISPOSAL_GUIDE.md` | Memory management |
-| `DOCS/SYSTEM_AUDIT_2026-01-30.md` | Full system audit (v2.0.0 updated) |
+| `DOCS/SYSTEM_AUDIT_2026-01-30.md` | Full system audit |
+| `DOCS/archive/SYSTEM_AUDIT_2026-01-30.md` | Full system audit (v2.0.0 updated, archived) |
 | `24-GEOMETRY-6D-ROTATION-SUMMARY.md` | Geometry encoding |
 
 ---
 
 *This document is the canonical system inventory. Update after significant changes.*
-*Last major update: v2.0.0 — 2026-01-30*
+*Last major inventory update: 2026-01-30. For current release metadata, see `DOCS/STATUS.md`.*

package/DOCS/TELEMETRY_EXPORTS.md

@@ -1,3 +1,5 @@
+Last reviewed: 2026-02-17
+
 # Telemetry export manifests
 
 The telemetry export pipeline standardizes manifest payloads for downstream automation, QA, and observability. Each manifest is designed to be cache-friendly with deterministic hashes so CI can diff outputs without ambiguity.