coaia-visualizer 1.0.0

package/feat-2-webui-local-editing/api-route-jsonl.ts

@@ -0,0 +1,71 @@
+// app/api/jsonl/route.ts
+import { NextRequest, NextResponse } from 'next/server';
+import { promises as fs } from 'fs';
+import path from 'path';
+
+export async function GET(request: NextRequest) {
+  const memoryPath = process.env.COAIAV_MEMORY_PATH;
+
+  if (!memoryPath) {
+    return NextResponse.json(
+      { error: 'No memory file configured. Launch with --memory-path flag.' },
+      { status: 400 }
+    );
+  }
+
+  try {
+    const content = await fs.readFile(memoryPath, 'utf-8');
+    const filename = path.basename(memoryPath);
+    
+    return NextResponse.json({
+      content,
+      filename,
+      path: memoryPath
+    });
+  } catch (error: any) {
+    return NextResponse.json(
+      { error: `Failed to read memory file: ${error.message}` },
+      { status: 500 }
+    );
+  }
+}
+
+export async function POST(request: NextRequest) {
+  const memoryPath = process.env.COAIAV_MEMORY_PATH;
+
+  if (!memoryPath) {
+    return NextResponse.json(
+      { error: 'No memory file configured' },
+      { status: 400 }
+    );
+  }
+
+  try {
+    const { content } = await request.json();
+    
+    if (!content) {
+      return NextResponse.json(
+        { error: 'No content provided' },
+        { status: 400 }
+      );
+    }
+
+    // Backup original file
+    const backupPath = `${memoryPath}.backup-${Date.now()}`;
+    await fs.copyFile(memoryPath, backupPath);
+
+    // Write new content
+    await fs.writeFile(memoryPath, content, 'utf-8');
+
+    return NextResponse.json({
+      success: true,
+      backup: backupPath,
+      message: 'Memory file updated successfully'
+    });
+  } catch (error: any) {
+    return NextResponse.json(
+      { error: `Failed to write memory file: ${error.message}` },
+      { status: 500 }
+    );
+  }
+}

package/feat-2-webui-local-editing/cli.ts

@@ -0,0 +1,170 @@
+#!/usr/bin/env node
+
+/**
+ * COAIA Visualizer CLI - Launch visualizer with local memory file
+ * 
+ * Launches Next.js dev server with pre-loaded memory file
+ * Works analogously to coaia-narrative/cli.ts
+ */
+
+import { spawn } from 'child_process';
+import { promises as fs } from 'fs';
+import path from 'path';
+import minimist from 'minimist';
+import * as dotenv from 'dotenv';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+interface Config {
+  memoryPath: string;
+  port: number;
+  noOpen: boolean;
+}
+
+function loadConfig(args: minimist.ParsedArgs): Config {
+  let config: Config = {
+    memoryPath: path.join(process.cwd(), 'memory.jsonl'),
+    port: 3000,
+    noOpen: false
+  };
+
+  // Load .env files
+  const localEnvPath = path.join(process.cwd(), '.env');
+  try {
+    dotenv.config({ path: localEnvPath });
+  } catch (error) {
+    // .env doesn't exist, that's okay
+  }
+
+  // Custom env file
+  if (args.env) {
+    dotenv.config({ path: args.env, override: true });
+  }
+
+  // Environment variables
+  if (process.env.COAIAN_MF) {
+    config.memoryPath = process.env.COAIAN_MF;
+  }
+  if (process.env.COAIAV_PORT) {
+    config.port = parseInt(process.env.COAIAV_PORT, 10);
+  }
+
+  // Command-line flags override everything
+  if (args['memory-path'] || args['M']) {
+    config.memoryPath = args['memory-path'] || args['M'];
+  }
+  if (args['port'] || args['p']) {
+    config.port = args['port'] || args['p'];
+  }
+  if (args['no-open']) {
+    config.noOpen = true;
+  }
+
+  return config;
+}
+
+async function main() {
+  const args = minimist(process.argv.slice(2));
+
+  if (args.help || args.h) {
+    console.log(`
+🎨 COAIA Visualizer - Interactive Chart Viewer
+
+DESCRIPTION:
+   Web-based visualizer for structural tension charts from coaia-narrative.
+   Launches a local web server to interactively explore your charts.
+
+USAGE:
+   coaia-visualizer [OPTIONS]
+   npx coaia-visualizer [OPTIONS]
+
+OPTIONS:
+   --memory-path PATH, -M PATH    Path to memory.jsonl file (default: ./memory.jsonl)
+   --port PORT, -p PORT           Server port (default: 3000)
+   --no-open                      Don't auto-open browser
+   --help, -h                     Show this help message
+
+ENVIRONMENT VARIABLES:
+   COAIAN_MF                      Default memory file path
+   COAIAV_PORT                    Default server port
+
+EXAMPLES:
+   # Launch with default memory.jsonl
+   coaia-visualizer
+
+   # Launch with specific memory file
+   coaia-visualizer --memory-path ./my-charts.jsonl
+
+   # Launch on different port
+   coaia-visualizer --port 3001
+
+   # Use environment variable
+   COAIAN_MF=./charts.jsonl coaia-visualizer
+`);
+    process.exit(0);
+  }
+
+  const config = loadConfig(args);
+
+  // Verify memory file exists
+  try {
+    await fs.access(config.memoryPath);
+  } catch (error) {
+    console.error(`❌ Memory file not found: ${config.memoryPath}`);
+    console.error(`   Create a memory file or specify a different path with --memory-path`);
+    process.exit(1);
+  }
+
+  console.log(`🎨 COAIA Visualizer`);
+  console.log(`📁 Memory file: ${config.memoryPath}`);
+  console.log(`🌐 Port: ${config.port}`);
+  console.log();
+
+  // Set environment variables for Next.js
+  process.env.COAIAV_MEMORY_PATH = path.resolve(config.memoryPath);
+  process.env.PORT = config.port.toString();
+
+  // Navigate to visualizer root
+  const visualizerRoot = path.resolve(__dirname, '..');
+  
+  // Launch Next.js dev server
+  const nextProcess = spawn('npm', ['run', 'dev'], {
+    cwd: visualizerRoot,
+    stdio: 'inherit',
+    env: {
+      ...process.env,
+      COAIAV_MEMORY_PATH: path.resolve(config.memoryPath),
+      PORT: config.port.toString()
+    }
+  });
+
+  // Open browser if not disabled
+  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();
+    }, 3000);
+  }
+
+  // Handle shutdown
+  process.on('SIGINT', () => {
+    console.log('\n👋 Shutting down visualizer...');
+    nextProcess.kill();
+    process.exit(0);
+  });
+
+  nextProcess.on('exit', (code) => {
+    process.exit(code || 0);
+  });
+}
+
+main().catch((error) => {
+  console.error('❌ Fatal error:', error);
+  process.exit(1);
+});

package/feat-2-webui-local-editing/demo.sh

@@ -0,0 +1,98 @@
+#!/bin/bash
+# Comprehensive test and demo of coaia-visualizer integration
+
+set -e
+
+echo "🎨 COAIA Visualizer - Full Integration Test"
+echo "==========================================="
+echo
+
+# Configuration
+TEST_FILE="../coaia-narrative/test-cli-memory.jsonl"
+PORT=3459
+
+# Clean up any existing processes
+echo "🧹 Cleaning up existing processes..."
+EXISTING_PID=$(ps aux | grep "node.*next dev" | grep visualizer | grep -v grep | awk '{print $2}' || true)
+if [ -n "$EXISTING_PID" ]; then
+    kill $EXISTING_PID 2>/dev/null || true
+    sleep 2
+fi
+
+# Test 1: Verify CLI exists and works
+echo "✓ Test 1: CLI Help"
+node dist/cli.js --help | head -5
+echo
+
+# Test 2: Start server with specific memory file
+echo "✓ Test 2: Starting server with memory file"
+echo "  File: $TEST_FILE"
+echo "  Port: $PORT"
+node dist/cli.js --memory-path "$TEST_FILE" --port $PORT --no-open > /tmp/viz-demo.log 2>&1 &
+SERVER_PID=$!
+echo "  PID: $SERVER_PID"
+echo
+
+# Wait for server
+echo "⏳ Waiting for server startup..."
+sleep 10
+
+# Test 3: API endpoint
+echo "✓ Test 3: API Endpoint Test"
+API_RESPONSE=$(curl -s http://localhost:$PORT/api/jsonl)
+FILENAME=$(echo "$API_RESPONSE" | jq -r '.filename')
+FILE_PATH=$(echo "$API_RESPONSE" | jq -r '.path')
+echo "  Filename: $FILENAME"
+echo "  Path: $FILE_PATH"
+echo
+
+# Test 4: Homepage
+echo "✓ Test 4: Homepage Test"
+HOME_STATUS=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:$PORT/)
+echo "  HTTP Status: $HOME_STATUS"
+if [ "$HOME_STATUS" = "200" ]; then
+    echo "  ✓ Homepage loads successfully"
+else
+    echo "  ✗ Homepage failed to load"
+    kill $SERVER_PID
+    exit 1
+fi
+echo
+
+# Test 5: Data parsing
+echo "✓ Test 5: JSONL Data Parsing"
+CONTENT=$(echo "$API_RESPONSE" | jq -r '.content')
+LINE_COUNT=$(echo "$CONTENT" | grep -c "^" || echo "0")
+echo "  Lines in file: $LINE_COUNT"
+ENTITY_COUNT=$(echo "$CONTENT" | grep -c '"type":"entity"' || echo "0")
+RELATION_COUNT=$(echo "$CONTENT" | grep -c '"type":"relation"' || echo "0")
+echo "  Entities: $ENTITY_COUNT"
+echo "  Relations: $RELATION_COUNT"
+echo
+
+# Summary
+echo "✅ All Tests Passed!"
+echo
+echo "📊 Integration Summary:"
+echo "  ✓ CLI launcher works with --memory-path and --port flags"
+echo "  ✓ API endpoint serves JSONL files from filesystem"
+echo "  ✓ Homepage renders correctly"
+echo "  ✓ Data parsing works (entities and relations)"
+echo
+echo "🚀 Server is running at: http://localhost:$PORT"
+echo "   Memory file: $TEST_FILE"
+echo "   PID: $SERVER_PID"
+echo
+echo "💡 To use:"
+echo "   1. Open browser to http://localhost:$PORT"
+echo "   2. Charts will auto-load from the memory file"
+echo "   3. Use 'Save Changes' to write back to file"
+echo "   4. Use 'Reload' to refresh from file"
+echo
+echo "🛑 To stop: kill $SERVER_PID"
+echo
+
+# Keep running or cleanup
+read -p "Press Enter to stop server, or Ctrl+C to keep running..." DUMMY
+kill $SERVER_PID
+echo "Server stopped."

package/feat-2-webui-local-editing/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@coaia/visualizer",
+  "version": "1.0.0",
+  "description": "Interactive web visualizer for COAIA Narrative structural tension charts",
+  "type": "module",
+  "bin": {
+    "coaia-visualizer": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "next build",
+    "dev": "next dev",
+    "start": "next start",
+    "lint": "eslint .",
+    "build:cli": "tsc cli.ts --outDir dist --module esnext --target es2022 --moduleResolution bundler --esModuleInterop --skipLibCheck",
+    "prepare": "npm run build:cli"
+  },
+  "dependencies": {
+    "@hookform/resolvers": "^3.10.0",
+    "@radix-ui/react-accordion": "1.2.2",
+    "@radix-ui/react-alert-dialog": "1.1.4",
+    "@radix-ui/react-aspect-ratio": "1.1.1",
+    "@radix-ui/react-avatar": "1.1.2",
+    "@radix-ui/react-checkbox": "1.1.3",
+    "@radix-ui/react-collapsible": "1.1.2",
+    "@radix-ui/react-context-menu": "2.2.4",
+    "@radix-ui/react-dialog": "1.1.4",
+    "@radix-ui/react-dropdown-menu": "2.1.4",
+    "@radix-ui/react-hover-card": "1.1.4",
+    "@radix-ui/react-label": "2.1.1",
+    "@radix-ui/react-menubar": "1.1.4",
+    "@radix-ui/react-navigation-menu": "1.2.3",
+    "@radix-ui/react-popover": "1.1.4",
+    "@radix-ui/react-progress": "1.1.1",
+    "@radix-ui/react-radio-group": "1.2.2",
+    "@radix-ui/react-scroll-area": "1.2.2",
+    "@radix-ui/react-select": "2.1.4",
+    "@radix-ui/react-separator": "1.1.1",
+    "@radix-ui/react-slider": "1.2.2",
+    "@radix-ui/react-slot": "1.1.1",
+    "@radix-ui/react-switch": "1.1.2",
+    "@radix-ui/react-tabs": "1.1.2",
+    "@radix-ui/react-toast": "1.2.4",
+    "@radix-ui/react-toggle": "1.1.1",
+    "@radix-ui/react-toggle-group": "1.1.1",
+    "@radix-ui/react-tooltip": "1.1.6",
+    "@vercel/analytics": "1.3.1",
+    "autoprefixer": "^10.4.20",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "cmdk": "1.0.4",
+    "date-fns": "4.1.0",
+    "dotenv": "^16.4.5",
+    "embla-carousel-react": "8.5.1",
+    "input-otp": "1.4.1",
+    "lucide-react": "^0.454.0",
+    "minimist": "^1.2.8",
+    "next": "16.0.10",
+    "next-themes": "^0.4.6",
+    "react": "19.2.0",
+    "react-day-picker": "9.8.0",
+    "react-dom": "19.2.0",
+    "react-hook-form": "^7.60.0",
+    "react-resizable-panels": "^2.1.7",
+    "recharts": "2.15.4",
+    "sonner": "^1.7.4",
+    "tailwind-merge": "^3.3.1",
+    "tailwindcss-animate": "^1.0.7",
+    "vaul": "^1.1.2",
+    "zod": "3.25.76"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4.1.9",
+    "@types/minimist": "^1.2.5",
+    "@types/node": "^22",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "postcss": "^8.5",
+    "tailwindcss": "^4.1.9",
+    "tw-animate-css": "1.3.3",
+    "typescript": "^5"
+  }
+}

package/feat-2-webui-local-editing/test-integration.sh

@@ -0,0 +1,93 @@
+#!/bin/bash
+# Test script for coaia-visualizer CLI integration
+
+set -e
+
+echo "🧪 Testing COAIA Visualizer CLI Integration"
+echo "==========================================="
+echo
+
+# Test 1: Help command
+echo "✓ Test 1: Help command"
+node dist/cli.js --help > /dev/null
+echo "  ✓ Help output works"
+echo
+
+# Test 2: Build CLI
+echo "✓ Test 2: Building CLI"
+npm run build:cli > /dev/null 2>&1
+echo "  ✓ CLI built successfully"
+echo
+
+# Test 3: Check executable
+echo "✓ Test 3: Checking CLI executable"
+if [ -x dist/cli.js ]; then
+    echo "  ✓ CLI is executable"
+else
+    chmod +x dist/cli.js
+    echo "  ✓ Made CLI executable"
+fi
+echo
+
+# Test 4: Verify test file exists
+TEST_FILE="../coaia-narrative/test-cli-memory.jsonl"
+echo "✓ Test 4: Checking test file"
+if [ -f "$TEST_FILE" ]; then
+    echo "  ✓ Test file exists: $TEST_FILE"
+else
+    echo "  ✗ Test file missing: $TEST_FILE"
+    exit 1
+fi
+echo
+
+# Test 5: Start server in background
+echo "✓ Test 5: Starting server (background mode)"
+PORT=3457 node dist/cli.js --memory-path "$TEST_FILE" --no-open > /tmp/visualizer-test.log 2>&1 &
+SERVER_PID=$!
+echo "  ✓ Server started with PID: $SERVER_PID"
+echo
+
+# Wait for server to start
+echo "⏳ Waiting for server to be ready..."
+sleep 8
+
+# Test 6: Test API endpoint
+echo "✓ Test 6: Testing API endpoint"
+RESPONSE=$(curl -s http://localhost:3457/api/jsonl)
+if echo "$RESPONSE" | grep -q "test-cli-memory.jsonl"; then
+    echo "  ✓ API returns correct filename"
+else
+    echo "  ✗ API test failed"
+    kill $SERVER_PID
+    exit 1
+fi
+echo
+
+# Test 7: Test homepage
+echo "✓ Test 7: Testing homepage"
+HOME_RESPONSE=$(curl -s http://localhost:3457/)
+if echo "$HOME_RESPONSE" | grep -q "COAIA Narrative Visualizer"; then
+    echo "  ✓ Homepage loads correctly"
+else
+    echo "  ✗ Homepage test failed"
+    kill $SERVER_PID
+    exit 1
+fi
+echo
+
+# Cleanup
+echo "🧹 Cleaning up..."
+kill $SERVER_PID
+sleep 2
+echo "  ✓ Server stopped"
+echo
+
+echo "✅ All tests passed!"
+echo
+echo "📦 Integration Summary:"
+echo "  • CLI launcher works with --memory-path flag"
+echo "  • API endpoint serves JSONL files"
+echo "  • Homepage renders correctly"
+echo "  • Auto-loading from filesystem works"
+echo
+echo "🚀 Ready for use!"