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

package/types/viewer/index.d.ts

@@ -0,0 +1,225 @@
+/**
+ * Viewer Module TypeScript Definitions
+ * ViewerPortal, ViewerInputHandler, GalleryUI, CardBending,
+ * AudioReactivity, TradingCardExporter
+ */
+
+// ============================================================================
+// ViewerPortal
+// ============================================================================
+
+/** Portal display mode */
+export type PortalMode = 'card' | 'fullscreen' | 'embedded' | 'pip';
+
+/** Projection type for 4D→3D */
+export type ProjectionType = 'perspective' | 'stereographic' | 'orthographic';
+
+/** 6D rotation state */
+export interface RotationState {
+    XY: number;
+    XZ: number;
+    YZ: number;
+    XW: number;
+    YW: number;
+    ZW: number;
+}
+
+export interface ViewerPortalOptions {
+    mode?: PortalMode;
+    projection?: ProjectionType;
+    enableMouse?: boolean;
+    enableOrientation?: boolean;
+}
+
+/**
+ * Viewer portal for displaying 4D visualizations.
+ * Supports multiple display modes, input handling, and export.
+ */
+export declare class ViewerPortal {
+    mode: PortalMode;
+    projection: ProjectionType;
+    rotation: RotationState;
+
+    constructor(options?: ViewerPortalOptions);
+
+    /** Set display mode. */
+    setMode(mode: PortalMode): void;
+
+    /** Set projection type. */
+    setProjection(projection: ProjectionType): void;
+
+    /** Set rotation on a specific plane. */
+    setRotation(plane: string, angle: number): void;
+
+    /** Get all rotation values. */
+    getRotation(): RotationState;
+
+    /** Export current view as image data URL. */
+    exportImage(format?: string, quality?: number): string;
+
+    /** Destroy and clean up. */
+    destroy(): void;
+}
+
+// ============================================================================
+// ViewerInputHandler
+// ============================================================================
+
+/** Input source type */
+export type InputSource = 'keyboard' | 'mouse' | 'wheel' | 'touch' | 'orientation' | 'gamepad';
+
+/** Input preset */
+export type InputPreset = 'default' | 'gaming' | 'presentation' | 'accessibility';
+
+/**
+ * Universal input handler for viewer interactions.
+ * Supports keyboard, mouse, wheel, touch, orientation, and gamepad.
+ */
+export declare class ViewerInputHandler {
+    constructor(options?: { preset?: InputPreset });
+
+    /** Enable/disable an input source. */
+    setEnabled(source: InputSource, enabled: boolean): void;
+
+    /** Load an input preset. */
+    loadPreset(preset: InputPreset): void;
+
+    /** Get current input state. */
+    getState(): Record<string, any>;
+
+    /** Destroy all listeners. */
+    destroy(): void;
+}
+
+// ============================================================================
+// GalleryUI
+// ============================================================================
+
+/** Gallery view mode */
+export type GalleryViewMode = 'grid' | 'list' | 'carousel';
+
+/** Gallery sort option */
+export type GallerySortBy = 'date' | 'name' | 'system' | 'geometry';
+
+/**
+ * Gallery UI for browsing and managing saved visualizations.
+ * Supports 100 variation slots per system with search, sort, and filter.
+ */
+export declare class GalleryUI {
+    viewMode: GalleryViewMode;
+    sortBy: GallerySortBy;
+    searchQuery: string;
+    currentPage: number;
+
+    constructor(options?: { viewMode?: GalleryViewMode; sortBy?: GallerySortBy });
+
+    /** Set view mode. */
+    setViewMode(mode: GalleryViewMode): void;
+
+    /** Set sort order. */
+    setSortBy(sort: GallerySortBy): void;
+
+    /** Render the gallery. */
+    render(): void;
+
+    /** Destroy and clean up. */
+    destroy(): void;
+}
+
+// ============================================================================
+// CardBending
+// ============================================================================
+
+/** Bend preset name */
+export type BendPreset = 'flat' | 'gentle' | 'dramatic' | 'extreme' | 'wave' | 'twist';
+
+/**
+ * Card bending system mapping physical bend to 6D rotation.
+ * Supports orientation input and parallax layer effects.
+ */
+export declare class CardBending {
+    constructor();
+
+    /** Apply a bend preset. */
+    applyPreset(preset: BendPreset): void;
+
+    /** Get 6D rotation mapping from current bend state. */
+    getRotationMapping(): RotationState;
+
+    /** Serialize current state. */
+    serialize(): object;
+
+    /** Deserialize from saved state. */
+    deserialize(data: object): void;
+}
+
+// ============================================================================
+// AudioReactivity (viewer)
+// ============================================================================
+
+/** Audio frequency band */
+export type FrequencyBand = 'bass' | 'mid' | 'high' | 'sub' | 'presence';
+
+/**
+ * Audio reactivity system for viewer.
+ * Maps frequency bands to rotation and visual parameter changes.
+ */
+export declare class AudioReactivity {
+    constructor(options?: { bands?: FrequencyBand[] });
+
+    /** Get rotation mapping from audio data. */
+    getRotationMapping(): Partial<RotationState>;
+
+    /** Serialize configuration. */
+    serialize(): object;
+
+    /** Deserialize configuration. */
+    deserialize(data: object): void;
+}
+
+// ============================================================================
+// TradingCardExporter
+// ============================================================================
+
+/** Card size (5:7 aspect ratio) */
+export interface CardSize {
+    width: number;
+    height: number;
+    label: string;
+}
+
+/** Frame style for trading cards */
+export type FrameStyle = 'none' | 'simple' | 'ornate' | 'holographic' | 'neon';
+
+/** Rarity level */
+export type RarityLevel = 'common' | 'uncommon' | 'rare' | 'epic' | 'legendary' | 'mythic';
+
+/**
+ * Exports visualizations as trading card images.
+ * Supports multiple sizes, frame styles, rarity levels, and metadata.
+ */
+export declare class TradingCardExporter {
+    constructor();
+
+    /** Get available card sizes (all 5:7 ratio). */
+    getCardSizes(): CardSize[];
+
+    /** Get available frame styles. */
+    getFrameStyles(): FrameStyle[];
+
+    /** Get available rarity levels. */
+    getRarityLevels(): RarityLevel[];
+
+    /** Export a trading card image. */
+    exportCard(options: {
+        canvas: HTMLCanvasElement;
+        size?: CardSize;
+        frame?: FrameStyle;
+        rarity?: RarityLevel;
+        title?: string;
+        metadata?: Record<string, string>;
+    }): Promise<Blob | null>;
+
+    /** Serialize exporter configuration. */
+    serialize(): object;
+}

package/DOCS/BLUEPRINT_EXECUTION_PLAN_2026-01-07.md

@@ -1,34 +0,0 @@
-# Blueprint execution plan (2026-01-07)
-
-This execution plan operationalizes the strategic blueprint and defines what each session should deliver. Each session should update `DOCS/SESSION_LOG_2026-01-07.md` with timestamped progress and keep the checklist current.
-
-## Session cadence
-- **Start of session**: review this plan and the strategic blueprint.
-- **During session**: implement the next unchecked items, keep scope tight.
-- **End of session**: update the session log with timestamped outcomes and any blockers.
-
-## Execution checklist
-### Phase 1 — Mathematical foundation
-- [x] Add rotor/matrix utilities for the six rotation planes.
-- [x] Implement stereographic + perspective projection helpers.
-- [x] Add rotation drift/stability tests.
-
-### Phase 2 — Rendering core consolidation
-- [x] Define renderer contracts and resource manager interfaces.
-- [ ] Unify visualization systems behind a shared scene graph.
-- [x] Document GPU disposal patterns and lifecycle hooks.
-
-### Phase 3 — Agentic integration
-- [x] Define MCP tools for create/apply/render workflows.
-- [x] Emit structured telemetry spans and error schemas.
-- [x] Implement CLI JSON output and non-interactive modes.
-
-### Phase 4 — Cross-platform execution
-- [x] Define WASM build target and shared math core strategy.
-- [x] Add Flutter bindings with a batched render command buffer.
-- [x] Prototype WebGPU backend behind feature flags.
-
-### Phase 5 — Production hardening
-- [x] Draft licensing tiers and activation workflow.
-- [x] Add export formats with golden snapshot tests.
-- [x] Document XR integration benchmarks and performance targets.

package/DOCS/DEV_TRACK_ANALYSIS.md

@@ -1,77 +0,0 @@
-# Dev track analysis and next steps
-
-This document summarizes the current development track status, highlights gaps, and proposes the
-next execution steps. It should be updated after each multi-system delivery.
-
-**Last Updated:** 2026-01-30 (v2.0.0)
-
-## Current status snapshot
-- **Math foundation:** rotation utilities, projection clamping, and stability tests are in place.
-- **Renderer lifecycle:** unified contract and lifecycle manager are defined with adapters for the
-  core systems; resource tracking is centralized in the WebGL backend.
-- **Agentic tooling:** MCP/CLI response envelopes are standardized with schema validation.
-- **Docs/ops:** environment setup, CI testing, repo manifest, and project provisioning guides are
-  documented.
-- **WebGPU scaffold:** experimental backend initializes device/context and supports clear-pass render frames.
-- **WebGPU status/testing:** documented current WebGPU state and validation requirements.
-- **v2.0.0 Core Fixes (Phase A):** Quantum color restored, Faceted saturation + audio wired, clickIntensity bug fixed, shader sync tool added.
-- **v2.0.0 SpatialInputSystem:** Universal spatial input with 8 source types, 6 profiles, integrated into VIB3Engine. Decouples "card tilting" from device orientation.
-- **v2.0.0 Creative Tooling (Phase B):** Color presets (22), transitions (14 easings), post-processing (14 effects), parameter timeline (BPM sync).
-- **v2.0.0 Platform Integrations (Phase C):** React, Vue, Svelte component wrappers; Figma plugin; Three.js ShaderMaterial; TouchDesigner GLSL export; OBS mode.
-- **v2.0.0 Advanced Features (Phase D):** WebXR renderer, WebGPU compute shaders, MIDI controller, AI preset generator, OffscreenCanvas worker.
-
-## Completed phases
-| Phase | Status | Deliverables |
-|-------|--------|-------------|
-| Phase 1: Foundation | ✅ Complete | Math, geometry, parameters |
-| Phase 2: Rendering | ✅ Mostly Complete | Contracts, adapters, backends |
-| Phase 3: Agentic | ✅ Complete | MCP, CLI, Telemetry |
-| Phase 4: WebGPU | 🔄 In Progress | Scaffold exists |
-| Phase 5: Hardening | ✅ Complete | 694 tests, XSS prevention |
-| Phase A: Parity & Polish | ✅ Complete | Color/audio/saturation fixes |
-| Phase B: Creative Tooling | ✅ Complete | 4 modules, 3,837 lines |
-| Phase C: Platform Integrations | ✅ Complete | 7 modules, 4,693 lines |
-| Phase D: Advanced | ✅ Complete | 5 modules, 4,262 lines |
-| SpatialInputSystem | ✅ Complete | 1,783 lines, 8 sources, 6 profiles |
-
-## Key gaps to close
-1. **v2.0.0 module test coverage:**
-   - Creative, integrations, and advanced modules need unit/integration tests.
-   - SpatialInputSystem profiles need validation tests.
-2. **WebGPU prototype (Phase 4):**
-   - Confirm feature-flag gating and parity with WebGL backend entry points.
-   - Establish a minimal shader/material pipeline that mirrors the WebGL contract.
-3. **Platform integration validation:**
-   - Test React/Vue/Svelte components with actual framework projects.
-   - Validate Figma plugin with Figma Developer Console.
-   - Test TouchDesigner GLSL export in actual TD environment.
-4. **Cross-platform command buffers:**
-   - Document and validate the render command buffer format for Flutter/WASM integration.
-   - Ensure command buffer batching and lifecycle hooks align with `RendererContract`.
-5. **Telemetry export hardening:**
-   - Add validation for telemetry manifests and scene packs in CI.
-   - Produce golden snapshot tests for core geometries.
-
-## Recommended next steps
-1. **Test coverage for v2.0.0 modules:**
-   - Write Vitest unit tests for SpatialInputSystem (profile loading, input feeding, sensitivity).
-   - Write tests for creative tooling (preset application, transition interpolation, timeline playback).
-   - Add E2E tests for OBS mode and framework components.
-2. **NPM publish preparation:**
-   - Verify all package.json exports resolve correctly.
-   - Test tree-shaking with the creative/integrations/advanced imports.
-   - Run `npm pack --dry-run` to verify published file list.
-3. **WebGPU spike (Phase 4):**
-   - Build a feature-flagged WebGPU backend scaffold in `src/render/backends/`.
-   - Add a minimal triangle pipeline with uniform updates and buffer management.
-4. **Renderer diagnostics:**
-   - Expand `RenderResourceRegistry` stats to include peak usage and per-frame deltas.
-5. **Project automation:**
-   - Provide a scripted `make setup` (or `pnpm setup`) that runs env + project setup steps.
-
-## Risks and mitigation
-- **GPU resource churn:** ensure registry-based disposal is called during renderer swaps.
-- **Numerical drift:** keep normalization utilities and baseline tests running in CI.
-- **Cross-platform divergence:** ensure WebGL and WebGPU share material definitions.
-- **v2.0.0 module breadth:** 18 new files need test coverage before production use.
-- **Framework integration drift:** framework APIs evolve; pin versions in test fixtures.

package/DOCS/DEV_TRACK_PLAN_2026-01-07.md

@@ -1,42 +0,0 @@
-# Dev track plan (2026-01-07)
-
-This plan captures the staged work needed to deliver a production-ready agentic telemetry pipeline and export workflow. It is written as a living track plan so future sessions can append progress and maintain consistent architecture decisions.
-
-## North-star goals
-1. Agent-friendly CLI onboarding and help output.
-2. Deterministic telemetry manifest exports with previews and asset hashing.
-3. Clear documentation for automation, QA, and CI workflows.
-
-## Architecture anchors
-- **Telemetry pipeline**: `tools/telemetry/manifestPipeline.js` is the single source of truth for manifest normalization and hashing.
-- **Preview generation**: `js/core/telemetry-director.js` generates previews (renderer-backed or placeholders) and passes them into manifests.
-- **Docs hub**: `DOCS/` is the canonical location for workflow documentation (onboarding, telemetry, control references).
-
-## Planned track (phased)
-### Phase 1 — Onboarding + documentation hardening
-- Publish an agentic CLI onboarding guide with tool requirements, commands, and telemetry workflow steps.
-- Update README references so new onboarding docs are discoverable.
-- Extend telemetry docs with explicit CLI integration guidance and export flow notes.
-- Add a lightweight knowledge-check template that validates geometry/control comprehension without blocking execution.
-
-### Phase 2 — Agentic workflow hooks
-- Add CLI wrappers for telemetry export flows (pack selection, preview generation, manifest hashing).
-- Emit summaries designed for CI cache validation and diffing.
-- Provide optional validation hooks for manifest/preview consistency.
-
-### Phase 3 — Quality and verification
-- Add lint/test targets for telemetry outputs if applicable.
-- Document CI steps for telemetry export validation.
-- Add golden snapshot routines for preview images when the pipeline stabilizes.
-
-## Risks and mitigations
-- **Risk**: Hash drift due to unstable object serialization.  
-  **Mitigation**: Keep stable hashing in `manifestPipeline.js` and avoid non-deterministic fields.
-- **Risk**: Preview generation inconsistency across runtimes.  
-  **Mitigation**: Maintain browser-safe fallback encoding and ensure renderer contracts are documented.
-
-## Deliverables checklist
-- [ ] CLI onboarding doc is complete and linked in README.
-- [ ] Telemetry docs include export integration steps.
-- [ ] Agentic CLI support documented or implemented.
-- [ ] CI guidance includes telemetry hashes and preview artifacts.

package/DOCS/SESSION_014_PLAN.md

@@ -1,195 +0,0 @@
-# VIB3+ SDK - Session 014 Plan & Status
-
-**Date:** 2026-01-25
-**Branch:** `claude/phase-5-hardening-a4Wzn`
-**Session:** 014
-
----
-
-## Executive Summary
-
-This session completed a comprehensive system review and implemented agent onboarding improvements. The VIB3+ SDK is a **general-purpose 4D rotation visualization SDK** for plugins, extensions, wearables, and agentic AI integration.
-
----
-
-## System Architecture (Verified)
-
-### Core Metrics
-| Component | Value |
-|-----------|-------|
-| **Active Systems** | 3 (Quantum, Faceted, Holographic) |
-| **Placeholder Systems** | 1 (Polychora - TBD) |
-| **Rotation Planes** | 6 (XY, XZ, YZ + XW, YW, ZW) |
-| **Base Geometries** | 8 |
-| **Core Warp Types** | 3 (Base, Hypersphere, Hypertetrahedron) |
-| **Total Geometries** | 24 (8 base × 3 cores) |
-| **Canvas Layers** | 5 per system |
-| **MCP Tools** | 14 |
-| **Tests Passing** | 693+ |
-
-### Geometry Encoding Formula
-```
-geometry_index = core_index * 8 + base_index
-
-Where:
-- core_index: 0 (Base), 1 (Hypersphere), 2 (Hypertetrahedron)
-- base_index: 0-7 (tetrahedron, hypercube, sphere, torus, klein, fractal, wave, crystal)
-```
-
----
-
-## Changes Made This Session
-
-### 1. UI: Full 24 Geometry Support
-**File:** `sdk/index.html`
-- Added Core Type dropdown (Base, Hypersphere, Hypertetrahedron)
-- Implemented proper geometry encoding: `coreType * 8 + baseGeometry`
-- Updated geometry display to show "Geometry X / 24"
-- Fixed geometry buttons to work with core type selector
-
-### 2. Documentation: System Inventory
-**File:** `DOCS/SYSTEM_INVENTORY.md`
-- Complete technical inventory
-- Architecture diagram
-- All 4 systems documented
-- 24 geometry encoding explained
-- 6D rotation system documented
-- MCP tools reference
-- Agent onboarding quiz
-
-### 3. MCP: Agent Onboarding Tools
-**Files:** `src/agent/mcp/tools.js`, `src/agent/mcp/MCPServer.js`
-
-New tools added:
-- `get_sdk_context` - Returns essential SDK context on first connection
-- `verify_knowledge` - Multiple choice quiz to verify understanding
-
-Quiz format (answers: c, b, c, a, b, b):
-```
-Q1: How many rotation planes? a)3 b)4 c)6 d)8
-Q2: Geometry formula? a)base*3+core b)core*8+base c)base+core d)core*base
-Q3: Canvas layers per system? a)3 b)4 c)5 d)6
-Q4: Which are the 3 ACTIVE systems? a)quantum,faceted,holographic b)quantum,faceted,polychora c)all four d)none
-Q5: How many base geometry types? a)6 b)8 c)10 d)24
-Q6: Core warp types? a)base,sphere,cube b)base,hypersphere,hypertetrahedron c)2D,3D,4D d)none
-```
-
-### 4. Polychora Marked as TBD
-- Polychora system marked as placeholder/TBD in MCP responses
-- Quiz updated to test knowledge that only 3 systems are ACTIVE
-- System exists but not production-ready
-
----
-
-## Phase Status
-
-| Phase | Status | Notes |
-|-------|--------|-------|
-| **Phase 1: Foundation** | ✅ Complete | Math, geometry, parameters |
-| **Phase 2: Rendering** | ✅ Mostly Complete | Contracts exist, 4 adapters |
-| **Phase 3: Agentic** | ✅ Complete | MCP, CLI, Telemetry |
-| **Phase 4: WebGPU** | 🔄 Scaffold | Needs shader pipeline |
-| **Phase 5: Hardening** | 🔄 In Progress | 693 tests passing |
-
----
-
-## Known Issues
-
-1. **Polychora not production-ready** - Keep as TBD placeholder
-2. **WebGPU backend incomplete** - Scaffold exists, needs shader pipeline
-3. **Timing test flaky** - `withTiming` test sometimes fails by <1ms
-4. **Playwright test config** - Browser tests don't run in vitest
-
----
-
-## Planned Future Work
-
-### Phase 2 Consolidation (Rendering)
-- [ ] Audit all 4 systems for RendererContract compliance
-- [ ] Extract shared scene graph code
-- [ ] Document lifecycle rules in code
-- [ ] Add contract compliance tests
-
-### Phase 4 (WebGPU)
-- [ ] Complete WebGPU shader pipeline
-- [ ] Port shaders from WebGL to WGSL
-- [ ] Benchmark WebGL vs WebGPU
-
-### Phase 5 (Hardening)
-- [ ] Fix flaky timing test
-- [ ] Separate Playwright tests from vitest
-- [ ] Add more integration tests
-- [ ] Browser rendering verification
-
-### Documentation
-- [ ] Consolidate scattered docs
-- [ ] Archive outdated docs
-- [ ] Create "Start Here" guide for new agents
-- [ ] Add code examples to SYSTEM_INVENTORY.md
-
----
-
-## File References
-
-### Primary Documentation
-| File | Purpose |
-|------|---------|
-| `DOCS/SYSTEM_INVENTORY.md` | Complete system reference |
-| `DOCS/CLI_ONBOARDING.md` | Agent CLI setup |
-| `DOCS/CONTROL_REFERENCE.md` | UI parameters |
-| `24-GEOMETRY-6D-ROTATION-SUMMARY.md` | Geometry encoding |
-
-### Core Source Files
-| File | Purpose |
-|------|---------|
-| `src/core/VIB3Engine.js` | Main unified engine |
-| `src/core/RendererContracts.js` | Shared interfaces |
-| `src/quantum/QuantumEngine.js` | Quantum system |
-| `src/faceted/FacetedSystem.js` | Faceted system |
-| `src/holograms/RealHolographicSystem.js` | Holographic system |
-| `src/core/PolychoraSystem.js` | Polychora (TBD) |
-| `src/agent/mcp/MCPServer.js` | MCP server |
-| `src/agent/mcp/tools.js` | MCP tool definitions |
-| `src/agent/cli/AgentCLI.js` | CLI interface |
-
----
-
-## Git Commits This Session
-
-1. `feat(ui): Add full 24 geometry support with core type selector`
-2. `docs(sdk): Add comprehensive system inventory and agent onboarding tools`
-3. (pending) `feat(mcp): Add multiple choice quiz and mark Polychora as TBD`
-
----
-
-## Testing Commands
-
-```bash
-# Run all tests
-npm test
-
-# Run specific test file
-npm test -- tests/agent/AgentCLI.test.js
-
-# Run with coverage
-npm test -- --coverage
-
-# Start dev server
-npm run dev:web
-```
-
----
-
-## Quiz Answers Reference
-
-For agent onboarding quiz (`verify_knowledge`):
-- Q1 (rotation planes): **c** (6)
-- Q2 (geometry formula): **b** (core*8+base)
-- Q3 (canvas layers): **c** (5)
-- Q4 (active systems): **a** (quantum, faceted, holographic)
-- Q5 (base geometries): **b** (8)
-- Q6 (core types): **b** (base, hypersphere, hypertetrahedron)
-
----
-
-*Document generated: Session 014, 2026-01-25*

package/DOCS/SESSION_LOG_2026-01-07.md

@@ -1,56 +0,0 @@
-# Session log (2026-01-07)
-
-## 18:40:40
-- Logged required tooling and onboarding plan for agentic CLI workflows.
-- Created a dated dev track plan to anchor upcoming work.
-- Documented telemetry export flow in the onboarding guide.
-
-## 23:19:52
-- Added onboarding verification prompts to ensure agents can name geometry types and controls.
-
-## 23:34:16
-- Clarified the onboarding knowledge check to allow continuation while pointing to the correct reference docs.
-
-## 23:37:38
-- Added a copy/paste knowledge-check template and planned it in the dev track.
-
-## 02:07:46
-- Captured the unified SDK strategic blueprint and linked it from the README.
-
-## 02:10:12
-- Expanded the strategic blueprint into detailed actions and created an execution plan checklist.
-
-## 02:42:14
-- Added 4D rotation matrices, projection helpers, and stability tests; checked off Phase 1 math foundation items.
-
-## 02:42:36
-- Ran `pnpm test` to validate rotation and projection math helpers.
-
-## 02:46:57
-- Added renderer and resource manager contracts and checked off the Phase 2 interface definition.
-
-## 02:53:28
-- Implemented Phase 3 agentic integration: MCP tool definitions, telemetry spans/error schema, and agent CLI JSON/non-interactive export.
-
-## 02:53:50
-- Added CLI error handling for invalid pack JSON with structured telemetry errors.
-
-## 03:09:19
-- Completed Phase 4 cross-platform scaffolding: WASM target, Flutter render command buffer, and WebGPU feature flags.
-
-## 03:13:25
-- Completed Phase 5 deliverables: licensing tiers, export formats with golden snapshot coverage, and XR benchmark docs.
-
-## 03:13:48
-- Ran `pnpm test` to update export format snapshots and validate test coverage.
-
-## 13:19:14
-- Added scene graph scaffolding and documented GPU disposal patterns for Phase 2.
-
-## 2026-01-23 22:04 (Session 011)
-- Fixed rotation stability test precision tolerance (Float32Array drift over 2000 iterations).
-- Expanded LICENSING_TIERS.md with implementation details: key format, activation flow, token schema, offline validation, feature gating.
-- Expanded EXPORT_FORMATS.md with format specifications, golden snapshot test implementation, and CI integration.
-- Expanded XR_BENCHMARKS.md with metrics collection, benchmark runner, regression detection, and performance overlay.
-- Added CLI `validate` command for validating scene packs, manifests, and tool responses.
-- All 584 tests passing.