coaia-visualizer 1.5.3 → 1.5.4

package/.coaia/jgwill-coaia-visualizer.jsonl

@@ -0,0 +1,6 @@
+{"type":"entity","name":"chart_1770523106343_chart","entityType":"structural_tension_chart","observations":["Chart created for jgwill/coaia-visualizer on 2026-02-08T03:58:26.343Z"],"metadata":{"chartId":"chart_1770523106343","repository":"jgwill/coaia-visualizer","level":0,"createdAt":"2026-02-08T03:58:26.343Z","updatedAt":"2026-02-08T03:58:26.343Z"}}
+{"type":"entity","name":"chart_1770523106343_desired_outcome","entityType":"desired_outcome","observations":["Successful development and collaboration on jgwill/coaia-visualizer"],"metadata":{"chartId":"chart_1770523106343","createdAt":"2026-02-08T03:58:26.343Z","updatedAt":"2026-02-08T03:58:26.343Z"}}
+{"type":"entity","name":"chart_1770523106343_current_reality","entityType":"current_reality","observations":["Repository initialized with STC bot integration","[2026-02-08T03:58:26.404Z] @stcissue triggered: Issue #8 - LIVE_MODE_DESIGN.md (issues.opened)","[2026-02-08T04:38:12.548Z] @stcissue triggered: Issue #8 - Live Narrative Witness Mode (issues.edited)","[2026-02-12T04:05:37.474Z] @stcissue triggered: Issue #9 - file watching issue (issues.opened)","[2026-02-18T19:29:54.244Z] @stcissue triggered: Issue #10 - Containerization (issues.opened)"],"metadata":{"chartId":"chart_1770523106343","createdAt":"2026-02-08T03:58:26.343Z","updatedAt":"2026-02-18T19:29:54.244Z"}}
+{"type":"relation","from":"chart_1770523106343_chart","to":"chart_1770523106343_desired_outcome","relationType":"contains","metadata":{"createdAt":"2026-02-08T03:58:26.343Z"}}
+{"type":"relation","from":"chart_1770523106343_chart","to":"chart_1770523106343_current_reality","relationType":"contains","metadata":{"createdAt":"2026-02-08T03:58:26.343Z"}}
+{"type":"relation","from":"chart_1770523106343_current_reality","to":"chart_1770523106343_desired_outcome","relationType":"creates_tension_with","metadata":{"createdAt":"2026-02-08T03:58:26.343Z"}}

package/.github/workflows/docker.yml

@@ -0,0 +1,50 @@
+name: Docker Build & Push
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Docker tag (default: latest)'
+        required: false
+        default: 'latest'
+
+env:
+  IMAGE: jgwill/coaia:visualizer
+
+jobs:
+  build-push:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Docker meta
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: jgwill/coaia
+          tags: |
+            type=raw,value=visualizer
+            type=semver,pattern=visualizer-{{version}},event=tag
+            type=raw,value=visualizer-latest,enable={{is_default_branch}}
+
+      - name: Build and push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

package/Dockerfile

@@ -0,0 +1,61 @@
+# =============================================================================
+# COAIA Visualizer — Docker Image
+# jgwill/coaia:visualizer
+#
+# Usage:
+#   docker run --rm -p 4321:4321 \
+#     -v /abs/path/to/file.jsonl:/data/memory.jsonl \
+#     jgwill/coaia:visualizer
+# =============================================================================
+
+# ---- Build stage ----
+FROM node:22-alpine AS builder
+
+WORKDIR /app
+
+# Install pnpm
+RUN corepack enable && corepack prepare pnpm@latest --activate
+
+# Copy lockfile + manifests first (layer cache)
+COPY package.json pnpm-lock.yaml ./
+
+# Install all deps — skip prepare hook (cli.ts not copied yet)
+RUN pnpm install --no-frozen-lockfile --ignore-scripts
+
+# Copy source
+COPY . .
+
+# Build CLI + Next.js
+RUN pnpm run prepare && pnpm build
+
+# ---- Runner stage ----
+FROM node:22-alpine AS runner
+
+WORKDIR /app
+
+RUN corepack enable && corepack prepare pnpm@latest --activate
+
+# Copy manifests + node_modules from builder, then prune dev deps
+COPY package.json pnpm-lock.yaml ./
+COPY --from=builder /app/node_modules ./node_modules
+RUN pnpm prune --prod 2>/dev/null || true
+
+# Copy built assets from builder
+COPY --from=builder /app/.next            ./.next
+COPY --from=builder /app/public           ./public
+COPY --from=builder /app/next.config.mjs  ./next.config.mjs
+
+# Entrypoint script
+COPY docker-entrypoint.sh /usr/local/bin/docker-entrypoint.sh
+RUN chmod +x /usr/local/bin/docker-entrypoint.sh
+
+# Volume for user JSONL files
+VOLUME ["/data"]
+
+ENV NODE_ENV=production
+ENV PORT=4321
+ENV COAIAV_MEMORY_PATH=/data/memory.jsonl
+
+EXPOSE 4321
+
+ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"]

package/cli.ts

@@ -17,6 +17,9 @@ import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
+const DOCKER_IMAGE = 'jgwill/coaia:visualizer';
+const CONTAINER_PORT = 4321;
+
 interface Config {
   memoryPath: string;
   port: number;
@@ -25,17 +28,23 @@ interface Config {
   pollInterval: number;
   autoPlay: boolean;
   audioDir: string;
+  useDocker: boolean;
+  dockerImage: string;
+  pullImage: boolean;
 }
 
 function loadConfig(args: minimist.ParsedArgs): Config {
   let config: Config = {
     memoryPath: path.join(process.cwd(), 'memory.jsonl'),
-    port: 3000,
+    port: 4321,
     noOpen: false,
     live: false,
     pollInterval: 2000,
     autoPlay: false,
-    audioDir: path.join(process.cwd(), 'audio')
+    audioDir: path.join(process.cwd(), 'audio'),
+    useDocker: false,
+    dockerImage: DOCKER_IMAGE,
+    pullImage: false,
   };
 
   // Load .env files
@@ -93,6 +102,16 @@ function loadConfig(args: minimist.ParsedArgs): Config {
   if (args['audio-dir']) {
     config.audioDir = args['audio-dir'];
   }
+  if (args['docker'] || args['d']) {
+    config.useDocker = true;
+  }
+  if (args['docker-image']) {
+    config.dockerImage = args['docker-image'];
+    config.useDocker = true;
+  }
+  if (args['pull']) {
+    config.pullImage = true;
+  }
 
   return config;
 }
@@ -114,7 +133,10 @@ USAGE:
 
 OPTIONS:
    --memory-path PATH, -M PATH    Path to memory.jsonl file (default: ./memory.jsonl)
-   --port PORT, -p PORT           Server port (default: 3000)
+   --port PORT, -p PORT           Server port (default: 4321)
+   --docker, -d                   Run in Docker container (recommended, no local deps needed)
+   --docker-image IMAGE           Docker image to use (default: ${DOCKER_IMAGE})
+   --pull                         Pull/update the Docker image before running
    --live                         Enable live monitoring mode
    --poll-interval MS             Polling interval in ms (default: 2000)
    --auto-play                    Auto-play audio for new beats
@@ -131,17 +153,20 @@ ENVIRONMENT VARIABLES:
    COAIAV_AUDIO_DIR               Audio directory path
 
 EXAMPLES:
-   # Launch with default memory.jsonl
-   coaia-visualizer
+   # Launch in Docker (recommended — no local dependency issues)
+   coaia-visualizer --docker -M ./charts.jsonl
+
+   # Launch with default memory.jsonl in Docker
+   coaia-visualizer -d
 
-   # Launch with specific memory file
-   coaia-visualizer --memory-path ./my-charts.jsonl
+   # Launch on custom port with Docker
+   coaia-visualizer --docker -M ./my-charts.jsonl --port 5555
 
-   # Launch on different port
-   coaia-visualizer --port 3001
+   # Launch with local Next.js (requires local node_modules)
+   coaia-visualizer -M ./my-charts.jsonl
 
    # Use environment variable
-   COAIAN_MF=./charts.jsonl coaia-visualizer
+   COAIAN_MF=./charts.jsonl coaia-visualizer --docker
 `);
     process.exit(0);
   }
@@ -157,7 +182,7 @@ EXAMPLES:
     process.exit(1);
   }
 
-  console.log(`🎨 COAIA Visualizer${config.live ? ' [LIVE MODE]' : ''}`);
+  console.log(`🎨 COAIA Visualizer${config.live ? ' [LIVE MODE]' : ''}${config.useDocker ? ' [DOCKER]' : ''}`);
   console.log(`📁 Memory file: ${config.memoryPath}`);
   console.log(`🌐 Port: ${config.port}`);
   if (config.live) {
@@ -167,6 +192,58 @@ EXAMPLES:
   }
   console.log();
 
+  // ── Docker mode ───────────────────────────────────────────────────────────
+  if (config.useDocker) {
+    const absMemoryPath = path.resolve(config.memoryPath);
+    const image = config.dockerImage;
+
+    // Optionally pull the latest image
+    if (config.pullImage) {
+      console.log(`⬇️  Pulling ${image}...`);
+      const pullProc = spawn('docker', ['pull', image], { stdio: 'inherit' });
+      await new Promise<void>((resolve, reject) => {
+        pullProc.on('exit', (code) => code === 0 ? resolve() : reject(new Error(`docker pull failed: ${code}`)));
+      });
+    }
+
+    const dockerArgs = [
+      'run', '--rm',
+      '-p', `${config.port}:${CONTAINER_PORT}`,
+      '-v', `${absMemoryPath}:/data/memory.jsonl`,
+      '-e', `COAIAV_MEMORY_PATH=/data/memory.jsonl`,
+      '-e', `PORT=${CONTAINER_PORT}`,
+      '-e', `NEXT_PUBLIC_LIVE_MODE=${config.live}`,
+      '-e', `NEXT_PUBLIC_POLL_INTERVAL=${config.pollInterval}`,
+      '-e', `NEXT_PUBLIC_AUTO_PLAY=${config.autoPlay}`,
+      image
+    ];
+
+    console.log(`🐳 docker ${dockerArgs.join(' ')}\n`);
+
+    const dockerProcess = spawn('docker', dockerArgs, { stdio: 'inherit' });
+
+    if (!config.noOpen) {
+      setTimeout(() => {
+        const url = `http://localhost:${config.port}`;
+        console.log(`\n🚀 Opening browser: ${url}\n`);
+        const openCmd = process.platform === 'darwin' ? 'open' :
+                        process.platform === 'win32' ? 'start' : 'xdg-open';
+        spawn(openCmd, [url], { detached: true, stdio: 'ignore' }).unref();
+      }, 4000);
+    }
+
+    process.on('SIGINT', () => {
+      console.log('\n👋 Shutting down visualizer...');
+      dockerProcess.kill();
+      process.exit(0);
+    });
+
+    dockerProcess.on('exit', (code) => { process.exit(code || 0); });
+    return;
+  }
+
+  // ── Local Next.js mode ────────────────────────────────────────────────────
+
   // Set environment variables for Next.js
   process.env.COAIAV_MEMORY_PATH = path.resolve(config.memoryPath);
   process.env.PORT = config.port.toString();
@@ -178,8 +255,6 @@ EXAMPLES:
   // Navigate to visualizer root
   const visualizerRoot = path.resolve(__dirname, '..');
   
-  // Launch Next.js dev server with explicit port flag
-  // Set TURBOPACK_PROJECT_DIR to prevent watching parent directories
   const nextProcess = spawn('npm', ['run', 'dev', '--', '-p', config.port.toString()], {
     cwd: visualizerRoot,
     stdio: 'inherit',
@@ -191,9 +266,7 @@ EXAMPLES:
       NEXT_PUBLIC_POLL_INTERVAL: config.pollInterval.toString(),
       NEXT_PUBLIC_AUTO_PLAY: config.autoPlay.toString(),
       COAIAV_AUDIO_DIR: path.resolve(config.audioDir),
-      // Constrain Turbopack to only watch the visualizer directory
       TURBOPACK_PROJECT_DIR: visualizerRoot,
-      // Disable excessive file watching
       WATCHPACK_POLLING: 'false'
     }
   });

package/dist/cli.js

@@ -13,15 +13,20 @@ import * as dotenv from 'dotenv';
 import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
+const DOCKER_IMAGE = 'jgwill/coaia:visualizer';
+const CONTAINER_PORT = 4321;
 function loadConfig(args) {
     let config = {
         memoryPath: path.join(process.cwd(), 'memory.jsonl'),
-        port: 3000,
+        port: 4321,
         noOpen: false,
         live: false,
         pollInterval: 2000,
         autoPlay: false,
-        audioDir: path.join(process.cwd(), 'audio')
+        audioDir: path.join(process.cwd(), 'audio'),
+        useDocker: false,
+        dockerImage: DOCKER_IMAGE,
+        pullImage: false,
     };
     // Load .env files
     const localEnvPath = path.join(process.cwd(), '.env');
@@ -76,6 +81,16 @@ function loadConfig(args) {
     if (args['audio-dir']) {
         config.audioDir = args['audio-dir'];
     }
+    if (args['docker'] || args['d']) {
+        config.useDocker = true;
+    }
+    if (args['docker-image']) {
+        config.dockerImage = args['docker-image'];
+        config.useDocker = true;
+    }
+    if (args['pull']) {
+        config.pullImage = true;
+    }
     return config;
 }
 async function main() {
@@ -94,7 +109,10 @@ USAGE:
 
 OPTIONS:
    --memory-path PATH, -M PATH    Path to memory.jsonl file (default: ./memory.jsonl)
-   --port PORT, -p PORT           Server port (default: 3000)
+   --port PORT, -p PORT           Server port (default: 4321)
+   --docker, -d                   Run in Docker container (recommended, no local deps needed)
+   --docker-image IMAGE           Docker image to use (default: ${DOCKER_IMAGE})
+   --pull                         Pull/update the Docker image before running
    --live                         Enable live monitoring mode
    --poll-interval MS             Polling interval in ms (default: 2000)
    --auto-play                    Auto-play audio for new beats
@@ -111,17 +129,20 @@ ENVIRONMENT VARIABLES:
    COAIAV_AUDIO_DIR               Audio directory path
 
 EXAMPLES:
-   # Launch with default memory.jsonl
-   coaia-visualizer
+   # Launch in Docker (recommended — no local dependency issues)
+   coaia-visualizer --docker -M ./charts.jsonl
+
+   # Launch with default memory.jsonl in Docker
+   coaia-visualizer -d
 
-   # Launch with specific memory file
-   coaia-visualizer --memory-path ./my-charts.jsonl
+   # Launch on custom port with Docker
+   coaia-visualizer --docker -M ./my-charts.jsonl --port 5555
 
-   # Launch on different port
-   coaia-visualizer --port 3001
+   # Launch with local Next.js (requires local node_modules)
+   coaia-visualizer -M ./my-charts.jsonl
 
    # Use environment variable
-   COAIAN_MF=./charts.jsonl coaia-visualizer
+   COAIAN_MF=./charts.jsonl coaia-visualizer --docker
 `);
         process.exit(0);
     }
@@ -135,7 +156,7 @@ EXAMPLES:
         console.error(`   Create a memory file or specify a different path with --memory-path`);
         process.exit(1);
     }
-    console.log(`🎨 COAIA Visualizer${config.live ? ' [LIVE MODE]' : ''}`);
+    console.log(`🎨 COAIA Visualizer${config.live ? ' [LIVE MODE]' : ''}${config.useDocker ? ' [DOCKER]' : ''}`);
     console.log(`📁 Memory file: ${config.memoryPath}`);
     console.log(`🌐 Port: ${config.port}`);
     if (config.live) {
@@ -144,6 +165,49 @@ EXAMPLES:
         console.log(`🔊 Auto-play: ${config.autoPlay ? 'enabled' : 'disabled'}`);
     }
     console.log();
+    // ── Docker mode ───────────────────────────────────────────────────────────
+    if (config.useDocker) {
+        const absMemoryPath = path.resolve(config.memoryPath);
+        const image = config.dockerImage;
+        // Optionally pull the latest image
+        if (config.pullImage) {
+            console.log(`⬇️  Pulling ${image}...`);
+            const pullProc = spawn('docker', ['pull', image], { stdio: 'inherit' });
+            await new Promise((resolve, reject) => {
+                pullProc.on('exit', (code) => code === 0 ? resolve() : reject(new Error(`docker pull failed: ${code}`)));
+            });
+        }
+        const dockerArgs = [
+            'run', '--rm',
+            '-p', `${config.port}:${CONTAINER_PORT}`,
+            '-v', `${absMemoryPath}:/data/memory.jsonl`,
+            '-e', `COAIAV_MEMORY_PATH=/data/memory.jsonl`,
+            '-e', `PORT=${CONTAINER_PORT}`,
+            '-e', `NEXT_PUBLIC_LIVE_MODE=${config.live}`,
+            '-e', `NEXT_PUBLIC_POLL_INTERVAL=${config.pollInterval}`,
+            '-e', `NEXT_PUBLIC_AUTO_PLAY=${config.autoPlay}`,
+            image
+        ];
+        console.log(`🐳 docker ${dockerArgs.join(' ')}\n`);
+        const dockerProcess = spawn('docker', dockerArgs, { stdio: 'inherit' });
+        if (!config.noOpen) {
+            setTimeout(() => {
+                const url = `http://localhost:${config.port}`;
+                console.log(`\n🚀 Opening browser: ${url}\n`);
+                const openCmd = process.platform === 'darwin' ? 'open' :
+                    process.platform === 'win32' ? 'start' : 'xdg-open';
+                spawn(openCmd, [url], { detached: true, stdio: 'ignore' }).unref();
+            }, 4000);
+        }
+        process.on('SIGINT', () => {
+            console.log('\n👋 Shutting down visualizer...');
+            dockerProcess.kill();
+            process.exit(0);
+        });
+        dockerProcess.on('exit', (code) => { process.exit(code || 0); });
+        return;
+    }
+    // ── Local Next.js mode ────────────────────────────────────────────────────
     // Set environment variables for Next.js
     process.env.COAIAV_MEMORY_PATH = path.resolve(config.memoryPath);
     process.env.PORT = config.port.toString();
@@ -153,8 +217,6 @@ EXAMPLES:
     process.env.COAIAV_AUDIO_DIR = path.resolve(config.audioDir);
     // Navigate to visualizer root
     const visualizerRoot = path.resolve(__dirname, '..');
-    // Launch Next.js dev server with explicit port flag
-    // Set TURBOPACK_PROJECT_DIR to prevent watching parent directories
     const nextProcess = spawn('npm', ['run', 'dev', '--', '-p', config.port.toString()], {
         cwd: visualizerRoot,
         stdio: 'inherit',
@@ -166,9 +228,7 @@ EXAMPLES:
             NEXT_PUBLIC_POLL_INTERVAL: config.pollInterval.toString(),
             NEXT_PUBLIC_AUTO_PLAY: config.autoPlay.toString(),
             COAIAV_AUDIO_DIR: path.resolve(config.audioDir),
-            // Constrain Turbopack to only watch the visualizer directory
             TURBOPACK_PROJECT_DIR: visualizerRoot,
-            // Disable excessive file watching
             WATCHPACK_POLLING: 'false'
         }
     });

package/docker-build-push.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+# Build and push jgwill/coaia:visualizer to Docker Hub
+# Usage: ./docker-build-push.sh [tag]
+# Requires: docker login jgwill (or DOCKERHUB_TOKEN env)
+
+set -e
+
+TAG="${1:-visualizer}"
+IMAGE="jgwill/coaia:$TAG"
+
+echo "🐳 Building $IMAGE..."
+docker build -t "$IMAGE" .
+
+echo "📤 Pushing $IMAGE..."
+docker push "$IMAGE"
+
+echo "✅ Done: $IMAGE"
+echo ""
+echo "Run with:"
+echo "  docker run --rm -p 4321:4321 -v /abs/path/to/file.jsonl:/data/memory.jsonl $IMAGE"

package/docker-entrypoint.sh

@@ -0,0 +1,27 @@
+#!/bin/sh
+set -e
+
+# COAIA Visualizer Docker Entrypoint
+# Serves the pre-built Next.js app with the user-supplied JSONL file.
+#
+# The JSONL file must be mounted into /data/ in the container.
+# COAIAV_MEMORY_PATH defaults to /data/memory.jsonl but can be overridden.
+
+MEMORY_PATH="${COAIAV_MEMORY_PATH:-/data/memory.jsonl}"
+PORT="${PORT:-4321}"
+
+# Validate that the memory file exists (warn but don't block — user may mount it later)
+if [ ! -f "$MEMORY_PATH" ]; then
+  echo "⚠️  Warning: memory file not found at $MEMORY_PATH"
+  echo "   Mount your JSONL file with: -v /your/file.jsonl:$MEMORY_PATH"
+fi
+
+echo "🎨 COAIA Visualizer"
+echo "📁 Memory file: $MEMORY_PATH"
+echo "🌐 http://localhost:$PORT"
+echo ""
+
+export COAIAV_MEMORY_PATH="$MEMORY_PATH"
+export PORT="$PORT"
+
+exec node_modules/.bin/next start -p "$PORT"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coaia-visualizer",
-  "version": "1.5.3",
+  "version": "1.5.4",
   "private": false,
   "type": "module",
   "main": "./index.tsx",
@@ -26,7 +26,11 @@
     "prepare": "npm run build:cli",
     "start": "next start",
     "test": "playwright test",
-    "test:global-cli": "playwright test test-scripts/test-global-cli.spec.ts"
+    "test:global-cli": "playwright test test-scripts/test-global-cli.spec.ts",
+    "docker:build": "docker build -t jgwill/coaia:visualizer .",
+    "docker:push": "docker push jgwill/coaia:visualizer",
+    "docker:build-push": "npm run docker:build && npm run docker:push",
+    "docker:run": "docker run --rm -p 4321:4321 -v \"$(pwd)/memory.jsonl:/data/memory.jsonl\" jgwill/coaia:visualizer"
   },
   "dependencies": {
     "@cfworker/json-schema": "latest",