@vib3code/sdk 2.0.3-canary.45332e3 → 2.0.3-canary.4e0dace

package/DOCS/AGENT_HARNESS_ARCHITECTURE.md

@@ -1,3 +1,5 @@
+Last reviewed: 2026-02-17
+
 # VIB3+ Agent Harness Architecture
 
 **Purpose**: Close the feedback loop between AI agents and VIB3+ visualization, enabling agents to design ultra-intricate reactive choreographed visuals that would be impractical via manual UI.

package/DOCS/ANDROID_DEPLOYMENT.md

@@ -0,0 +1,59 @@
+Last reviewed: 2026-02-17
+
+# Building VIB3+ Ultra for Android
+
+This guide explains how to build the "Crystal Labyrinth" demo as an Android APK using the existing Flutter integration.
+
+## Prerequisites
+
+- Flutter SDK installed
+- Android Studio / Android SDK installed
+- Connected Android device or emulator
+
+## Quick Build (GitHub Actions)
+
+The repository includes a workflow `.github/workflows/flutter-apk.yml` that automatically builds an APK on push to `examples/flutter_demo/`.
+
+To trigger a build for the Crystal Labyrinth demo:
+1.  Copy the built web assets to the Flutter assets directory (see Local Build below).
+2.  Push changes.
+3.  Download the artifact from the Actions tab.
+
+## Local Build Instructions
+
+1.  **Build the Web Demo**
+    Run the Vite build to bundle the Crystal Labyrinth demo:
+    ```bash
+    npm install
+    npm run build:web
+    ```
+    This will output optimized files to `dist/`.
+
+2.  **Prepare Flutter Assets**
+    Copy the build output to the Flutter project's asset folder:
+    ```bash
+    mkdir -p examples/flutter_demo/assets/vib3/
+    cp -r dist/* examples/flutter_demo/assets/vib3/
+    ```
+
+3.  **Configure Entry Point**
+    Open `examples/flutter_demo/lib/vib3_controller.dart` and ensure the WebView points to the local index file or the deployed GitHub Pages URL:
+    `https://<your-username>.github.io/vib3codeSDK/examples/dogfood/crystal_labyrinth.html`
+
+4.  **Build APK**
+    Navigate to the Flutter directory and build:
+    ```bash
+    cd examples/flutter_demo
+    flutter build apk --release
+    ```
+
+5.  **Install**
+    ```bash
+    flutter install
+    ```
+
+## VIB3Link Networking on Android
+
+For multi-user features (`VIB3Link`) to work on Android:
+- Ensure the device has internet access.
+- If using local dev server, use `adb reverse tcp:5173 tcp:5173` to forward ports.

package/DOCS/ARCHITECTURE.md

@@ -0,0 +1 @@
+Last reviewed: 2026-02-17

package/DOCS/CI_TESTING.md

@@ -1,3 +1,5 @@
+Last reviewed: 2026-02-17
+
 # CI and testing guide
 
 This guide outlines the baseline CI/test expectations for the project and a recommended set of

package/DOCS/CLI_ONBOARDING.md

@@ -1,3 +1,5 @@
+Last reviewed: 2026-02-17
+
 # Agentic CLI onboarding
 
 This guide aligns the current CLI surface (package scripts and telemetry helpers) with an agentic workflow. It is intentionally explicit so automation agents and humans can share the same runbook.

package/DOCS/CONTROL_REFERENCE.md

@@ -1,3 +1,5 @@
+Last reviewed: 2026-02-17
+
 # Control & API Reference
 
 This document walks through every control surface in `index.html` and the JavaScript entry points they call so you can quickly map UI inputs to runtime behavior.

package/DOCS/CROSS_SITE_DESIGN_PATTERNS.md

@@ -1,3 +1,5 @@
+Last reviewed: 2026-02-17
+
 # Cross-Site Design Pattern Synthesis
 
 **Based on actual visual analysis of 4 reference sites via Playwright screenshots**

package/DOCS/ENV_SETUP.md

@@ -1,3 +1,5 @@
+Last reviewed: 2026-02-17
+
 # Environment setup (Firebase, gcloud, Flutter, Android, GH CLI)
 
 This doc provides a **copy/paste** bootstrap script to install and configure:

package/DOCS/EPIC_SCROLL_EVENTS.md

@@ -1,3 +1,5 @@
+Last reviewed: 2026-02-17
+
 # EPIC SCROLL EVENTS — VIB3+ Landing Page Choreography Plan
 
 **20 scroll-driven events that combine GSAP, GPU visualizers, CSS effects, and masking layers