coaia-visualizer 1.5.9 → 1.6.0

package/direct-test.sh

@@ -1,180 +0,0 @@
-#!/bin/bash
-
-# Direct MCP Integration Test
-# Tests the MCP server and Next.js API without Docker complexity
-
-set -e
-
-echo "========================================="
-echo "Direct MCP Integration Test"
-echo "========================================="
-echo ""
-
-PROJECT_DIR="/workspace/repos/jgwill/coaia-visualizer-feat-4"
-cd "$PROJECT_DIR"
-
-# Start the Next.js app in the background
-echo "1. Starting Next.js application..."
-timeout 30 npm run dev > /tmp/nextjs.log 2>&1 &
-NEXTJS_PID=$!
-echo "   Process ID: $NEXTJS_PID"
-
-# Give the app time to start
-sleep 10
-
-# Check if the app is responding
-echo "2. Checking Next.js app health..."
-if curl -sf http://localhost:3000/api/charts > /dev/null; then
-    echo "   ✓ Next.js app is responding"
-else
-    echo "   ⚠ Warning: App not responding on port 3000, trying port 4321..."
-    if curl -sf http://localhost:4321/api/charts > /dev/null; then
-        echo "   ✓ Next.js app is responding on port 4321"
-    else
-        echo "   ✗ Failed to reach Next.js app"
-        kill $NEXTJS_PID 2>/dev/null || true
-        exit 1
-    fi
-fi
-
-API_PORT=3000
-if ! curl -sf http://localhost:3000/api/charts > /dev/null 2>&1; then
-    API_PORT=4321
-fi
-
-echo ""
-echo "3. Testing MCP API endpoints..."
-echo ""
-
-# Test 1: Create a chart
-echo "   Test 1: Creating a chart..."
-CHART_RESPONSE=$(curl -s -X POST "http://localhost:$API_PORT/api/charts" \
-    -H "Content-Type: application/json" \
-    -d '{
-    "desiredOutcome": "Test MCP Integration",
-    "currentReality": "Starting tests",
-    "dueDate": "2026-02-15"
-}')
-
-CHART_ID=$(echo "$CHART_RESPONSE" | jq -r '.chart.id' 2>/dev/null)
-
-if [ -n "$CHART_ID" ] && [ "$CHART_ID" != "null" ]; then
-    echo "   ✓ Chart created: $CHART_ID"
-else
-    echo "   ✗ Failed to create chart"
-    echo "   Response: $CHART_RESPONSE"
-    kill $NEXTJS_PID 2>/dev/null || true
-    exit 1
-fi
-
-# Test 2: Add action step
-echo ""
-echo "   Test 2: Adding action step..."
-ACTION_RESPONSE=$(curl -s -X POST "http://localhost:$API_PORT/api/charts/$CHART_ID" \
-    -H "Content-Type: application/json" \
-    -d '{
-    "addActionStep": {
-      "actionName": "Test Action 1",
-      "createAsTelescopedChart": false
-    }
-}')
-
-ACTION_UPDATES=$(echo "$ACTION_RESPONSE" | jq -r '.updates | length' 2>/dev/null || echo "0")
-
-if [ "$ACTION_UPDATES" -gt 0 ]; then
-    echo "   ✓ Action step added"
-else
-    echo "   ⚠ Could not verify action addition"
-fi
-
-# Test 3: Create telescoped chart
-echo ""
-echo "   Test 3: Creating telescoped chart..."
-TELESCOPE_RESPONSE=$(curl -s -X POST "http://localhost:$API_PORT/api/charts/$CHART_ID" \
-    -H "Content-Type: application/json" \
-    -d '{
-    "createTelescopedChart": {
-      "actionName": "action_Test Action 1"
-    }
-}')
-
-TELESCOPE_ID=$(echo "$TELESCOPE_RESPONSE" | jq -r '.chart.id' 2>/dev/null)
-
-if [ -n "$TELESCOPE_ID" ] && [ "$TELESCOPE_ID" != "null" ]; then
-    echo "   ✓ Telescoped chart created: $TELESCOPE_ID"
-else
-    echo "   ⚠ Telescope response: $(echo "$TELESCOPE_RESPONSE" | jq -c . 2>/dev/null || echo "$TELESCOPE_RESPONSE")"
-fi
-
-# Test 4: Retrieve parent chart
-echo ""
-echo "   Test 4: Retrieving parent chart with subCharts..."
-PARENT_RESPONSE=$(curl -s -X GET "http://localhost:$API_PORT/api/charts/$CHART_ID")
-
-SUBCHARTS_COUNT=$(echo "$PARENT_RESPONSE" | jq -r '.chart.subCharts | length' 2>/dev/null || echo "0")
-
-if [ "$SUBCHARTS_COUNT" -gt 0 ]; then
-    echo "   ✓ Parent chart has $SUBCHARTS_COUNT subCharts"
-else
-    echo "   ⚠ Parent chart subCharts count: $SUBCHARTS_COUNT"
-fi
-
-# Test 5: Test MCP server directly (if available)
-echo ""
-echo "4. Testing MCP Server..."
-
-if [ -f "$PROJECT_DIR/mcp/dist/index.js" ]; then
-    echo "   ✓ MCP server built"
-    echo ""
-    echo "   To test MCP server:"
-    echo "   1. Build: cd mcp && npm run build"
-    echo "   2. Run: node dist/index.js"
-    echo "   3. Configure in Claude Desktop"
-else
-    echo "   ⚠ MCP server not built yet"
-    echo "   Build with: cd mcp && npm run build"
-fi
-
-# Cleanup
-echo ""
-echo "5. Cleaning up..."
-kill $NEXTJS_PID 2>/dev/null || true
-sleep 1
-
-echo ""
-echo "========================================="
-echo "Test Results Summary"
-echo "========================================="
-echo "✓ Chart created"
-echo "✓ Action step added"
-if [ -n "$TELESCOPE_ID" ] && [ "$TELESCOPE_ID" != "null" ]; then
-    echo "✓ Telescoped chart created"
-fi
-if [ "$SUBCHARTS_COUNT" -gt 0 ]; then
-    echo "✓ Parent-child relationship established"
-fi
-echo ""
-echo "All basic tests passed!"
-echo "========================================="
-
-# Cleanup
-echo ""
-echo "5. Cleaning up..."
-kill $NEXTJS_PID 2>/dev/null || true
-sleep 1
-
-echo ""
-echo "========================================="
-echo "Test Results Summary"
-echo "========================================="
-echo "✓ Chart created"
-echo "✓ Action step added"
-if [ -n "$TELESCOPE_ID" ] && [ "$TELESCOPE_ID" != "null" ]; then
-    echo "✓ Telescoped chart created"
-fi
-if [ "$SUBCHARTS_COUNT" -gt 0 ]; then
-    echo "✓ Parent-child relationship established"
-fi
-echo ""
-echo "All basic tests passed!"
-echo "========================================="

package/docker-compose.test.yml

@@ -1,69 +0,0 @@
-version: '3.8'
-
-services:
-  # Next.js application server
-  visualizer-app:
-    build:
-      context: .
-      dockerfile: Dockerfile.app
-    ports:
-      - "4321:4321"
-    volumes:
-      - ./samples:/app/samples:ro
-      - ./test-data:/app/test-data
-    environment:
-      - NODE_ENV=production
-      - PORT=4321
-    networks:
-      - test-network
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:4321/api/charts"]
-      interval: 10s
-      timeout: 5s
-      retries: 5
-
-  # MCP Server
-  mcp-server:
-    build:
-      context: ./mcp
-      dockerfile: Dockerfile
-    environment:
-      - VISUALIZER_API_URL=http://visualizer-app:4321
-      - VISUALIZER_API_KEY=${VISUALIZER_API_KEY:-test-api-key}
-      - NODE_ENV=production
-    volumes:
-      - ./test-data:/data
-    networks:
-      - test-network
-    depends_on:
-      visualizer-app:
-        condition: service_healthy
-    stdin_open: true
-    tty: true
-
-  # Test runner using claude-code CLI or gemini-cli
-  test-runner:
-    build:
-      context: .
-      dockerfile: Dockerfile.test
-    environment:
-      - MCP_SERVER_HOST=mcp-server
-      - VISUALIZER_API_URL=http://visualizer-app:4321
-      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
-      - GOOGLE_API_KEY=${GOOGLE_API_KEY}
-    volumes:
-      - ./test-scripts:/test-scripts:ro
-      - ./test-results:/test-results
-      - ./test-data:/test-data
-    networks:
-      - test-network
-    depends_on:
-      visualizer-app:
-        condition: service_healthy
-      mcp-server:
-        condition: service_started
-    command: ["/test-scripts/run-all-tests.sh"]
-
-networks:
-  test-network:
-    driver: bridge

package/test-data/test-master.jsonl

@@ -1,11 +0,0 @@
-{"type":"Entity","name":"chart_test_master_chart","entityType":"chart","observations":["Master test chart for MCP integration testing"],"metadata":{"createdAt":"2026-01-16T00:00:00.000Z","dueDate":"2026-02-15"}}
-{"type":"Entity","name":"action_Setup_test_environment","entityType":"action","observations":["Setup test environment"]}
-{"type":"Entity","name":"action_Test_basic_operations","entityType":"action","observations":["Test basic operations"]}
-{"type":"Entity","name":"action_Test_telescope_feature","entityType":"action","observations":["Test telescope feature"]}
-{"type":"Relation","from":"chart_test_master_chart","to":"action_Setup_test_environment","relationType":"hasAction"}
-{"type":"Relation","from":"chart_test_master_chart","to":"action_Test_basic_operations","relationType":"hasAction"}
-{"type":"Relation","from":"chart_test_master_chart","to":"action_Test_telescope_feature","relationType":"hasAction"}
-{"type":"Entity","name":"outcome_Complete_MCP_testing","entityType":"desiredOutcome","observations":["Complete MCP integration testing suite"]}
-{"type":"Relation","from":"chart_test_master_chart","to":"outcome_Complete_MCP_testing","relationType":"hasDesiredOutcome"}
-{"type":"Entity","name":"reality_Initial_state","entityType":"currentReality","observations":["Starting MCP test suite","No charts created yet","Need to validate all MCP tools"]}
-{"type":"Relation","from":"chart_test_master_chart","to":"reality_Initial_state","relationType":"hasCurrentReality"}

package/test-run.log

@@ -1,101 +0,0 @@
-=========================================
-COAIA Visualizer MCP Test Environment
-=========================================
-
-Working directory: /workspace/repos/jgwill/coaia-visualizer-feat-4
-
-⚠ Warning: No ANTHROPIC_API_KEY or GOOGLE_API_KEY found
-  Tests will use direct HTTP calls instead of CLI clients
-
-Cleaning up previous test results...
-Building Docker images...
-time="2026-01-16T09:09:43-05:00" level=warning msg="The \"ANTHROPIC_API_KEY\" variable is not set. Defaulting to a blank string."
-time="2026-01-16T09:09:43-05:00" level=warning msg="The \"GOOGLE_API_KEY\" variable is not set. Defaulting to a blank string."
-#0 building with "default" instance using docker driver
-
-#1 [visualizer-app internal] load build definition from Dockerfile.app
-#1 transferring dockerfile: 1.09kB done
-#1 DONE 0.0s
-
-#2 [visualizer-app internal] load metadata for docker.io/library/node:20-alpine
-#2 DONE 0.2s
-
-#3 [visualizer-app internal] load .dockerignore
-#3 transferring context: 121B done
-#3 DONE 0.0s
-
-#4 [visualizer-app builder 1/6] FROM docker.io/library/node:20-alpine@sha256:3960ed74dfe320a67bf8da9555b6bade25ebda2b22b6081d2f60fd7d5d430e9c
-#4 DONE 0.0s
-
-#5 [visualizer-app internal] load build context
-#5 transferring context: 82.91kB 0.2s done
-#5 DONE 0.2s
-
-#6 [visualizer-app builder 2/6] WORKDIR /app
-#6 CACHED
-
-#7 [visualizer-app runner  3/13] RUN npm install -g pnpm@latest
-#7 CACHED
-
-#8 [visualizer-app builder 3/6] COPY package.json pnpm-lock.yaml ./
-#8 CACHED
-
-#9 [visualizer-app runner  4/13] COPY package.json pnpm-lock.yaml ./
-#9 CACHED
-
-#10 [visualizer-app builder 4/6] RUN npm install -g pnpm@latest &&   pnpm install --frozen-lockfile
-#10 4.059 
-#10 4.059 added 1 package in 3s
-#10 4.059 
-#10 4.060 1 package is looking for funding
-#10 4.060   run `npm fund` for details
-#10 4.064 npm notice
-#10 4.064 npm notice New major version of npm available! 10.8.2 -> 11.7.0
-#10 4.064 npm notice Changelog: https://github.com/npm/cli/releases/tag/v11.7.0
-#10 4.064 npm notice To update run: npm install -g npm@11.7.0
-#10 4.064 npm notice
-#10 5.648 Lockfile is up to date, resolution step is skipped
-#10 5.842 Progress: resolved 1, reused 0, downloaded 0, added 0
-#10 6.386 Packages: +296
-#10 6.386 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-#10 6.846 Progress: resolved 296, reused 0, downloaded 0, added 0
-#10 9.510 Progress: resolved 296, reused 0, downloaded 1, added 0
-#10 ...
-
-#11 [visualizer-app runner  5/13] RUN pnpm install --prod --frozen-lockfile --ignore-scripts
-#11 1.835 Lockfile is up to date, resolution step is skipped
-#11 1.898 Progress: resolved 1, reused 0, downloaded 0, added 0
-#11 2.020 Packages: +267
-#11 2.020 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-#11 2.966 Progress: resolved 267, reused 0, downloaded 27, added 20
-#11 3.978 Progress: resolved 267, reused 0, downloaded 142, added 56
-#11 5.006 Progress: resolved 267, reused 0, downloaded 218, added 101
-#11 6.017 Progress: resolved 267, reused 0, downloaded 258, added 221
-#11 7.020 Progress: resolved 267, reused 0, downloaded 260, added 259
-#11 8.018 Progress: resolved 267, reused 0, downloaded 261, added 261
-#11 ...
-
-#10 [visualizer-app builder 4/6] RUN npm install -g pnpm@latest &&   pnpm install --frozen-lockfile
-#10 10.56 Progress: resolved 296, reused 0, downloaded 100, added 95
-#10 11.57 Progress: resolved 296, reused 0, downloaded 196, added 195
-#10 12.60 Progress: resolved 296, reused 0, downloaded 248, added 231
-#10 13.60 Progress: resolved 296, reused 0, downloaded 284, added 283
-#10 14.60 Progress: resolved 296, reused 0, downloaded 288, added 288
-#10 15.60 Progress: resolved 296, reused 0, downloaded 289, added 288
-#10 16.60 Progress: resolved 296, reused 0, downloaded 290, added 290
-#10 19.46 Progress: resolved 296, reused 0, downloaded 291, added 290
-#10 20.46 Progress: resolved 296, reused 0, downloaded 291, added 291
-#10 22.03 Progress: resolved 296, reused 0, downloaded 292, added 291
-#10 ...
-
-#11 [visualizer-app runner  5/13] RUN pnpm install --prod --frozen-lockfile --ignore-scripts
-#11 12.39 Progress: resolved 267, reused 0, downloaded 262, added 261
-#11 13.39 Progress: resolved 267, reused 0, downloaded 262, added 262
-#11 14.39 Progress: resolved 267, reused 0, downloaded 264, added 264
-#11 15.39 Progress: resolved 267, reused 0, downloaded 265, added 265
-#11 ...
-
-#10 [visualizer-app builder 4/6] RUN npm install -g pnpm@latest &&   pnpm install --frozen-lockfile
-#10 23.04 Progress: resolved 296, reused 0, downloaded 292, added 292
-#10 24.40 Progress: resolved 296, reused 0, downloaded 293, added 292
-#10 25.40 Progress: resolved 296, reused 0, downloaded 293, added 293

package/test-scripts/README.md

@@ -1,325 +0,0 @@
-# COAIA Visualizer MCP Testing Guide
-
-## Overview
-
-This directory contains a complete Docker-based testing environment for the COAIA Visualizer MCP server. The test suite validates all MCP tools, including the telescope functionality.
-
-## Architecture
-
-```
-┌─────────────────────┐
-│   Test Runner       │
-│  (test-scripts/)    │
-└──────────┬──────────┘
-           │
-           ├─────────────┐
-           │             │
-    ┌──────▼──────┐  ┌──▼──────────────┐
-    │  MCP Server │  │  Next.js App    │
-    │   (stdio)   │  │  (HTTP:4321)    │
-    └─────────────┘  └─────────────────┘
-           │                 │
-           └────────┬────────┘
-                    │
-              ┌─────▼─────┐
-              │   Data    │
-              │ (JSONL)   │
-              └───────────┘
-```
-
-## Quick Start
-
-### 1. Set up environment variables (optional)
-
-```bash
-# For Claude CLI testing
-export ANTHROPIC_API_KEY="your_key_here"
-
-# For Gemini CLI testing
-export GOOGLE_API_KEY="your_key_here"
-```
-
-**Note:** API keys are optional. Tests will use direct HTTP calls if not provided.
-
-### 2. Run all tests
-
-```bash
-chmod +x run-mcp-tests.sh
-./run-mcp-tests.sh
-```
-
-This will:
-- Build Docker images for all services
-- Start the visualizer app and MCP server
-- Run the complete test suite
-- Generate test results
-- Clean up containers
-
-## Test Suite
-
-### Test 01: Basic Operations
-- Creates charts via API
-- Lists all charts
-- Verifies chart creation
-
-### Test 02: Telescope Creation
-- Adds action steps to charts
-- Creates telescoped charts from actions
-- Tests both `add_action_step` (with createAsTelescopedChart flag)
-- Tests `create_telescoped_chart` tool
-- Verifies sub-chart creation
-
-### Test 03: Navigation & Hierarchy
-- Retrieves parent charts
-- Retrieves telescoped child charts
-- Verifies parent-child relationships
-- Tests search functionality
-- Validates navigation metadata
-
-## Test Results
-
-After running tests, check:
-- `test-results/test-01/` - Basic operations results
-- `test-results/test-02/` - Telescope creation results
-- `test-results/test-03/` - Navigation results
-- `test-results/test-summary.txt` - Overall summary
-- `test-results/navigation-summary.txt` - Navigation summary
-
-## Manual Testing
-
-### Start services only
-
-```bash
-docker-compose -f docker-compose.test.yml up -d visualizer-app mcp-server
-```
-
-### Access the app
-
-```bash
-# Web UI
-http://localhost:4321
-
-# API endpoint
-curl http://localhost:4321/api/charts
-```
-
-### Run individual tests
-
-```bash
-docker-compose -f docker-compose.test.yml run --rm test-runner /test-scripts/test-01-basic-operations.sh
-```
-
-### Check logs
-
-```bash
-docker-compose -f docker-compose.test.yml logs visualizer-app
-docker-compose -f docker-compose.test.yml logs mcp-server
-```
-
-### Stop services
-
-```bash
-docker-compose -f docker-compose.test.yml down
-```
-
-## MCP Server Configuration
-
-The MCP server is configured via `mcp-config.json`:
-
-```json
-{
-  "mcpServers": {
-    "coaia-visualizer": {
-      "command": "node",
-      "args": ["/app/dist/index.js"],
-      "env": {
-        "VISUALIZER_API_URL": "http://visualizer-app:4321",
-        "VISUALIZER_API_KEY": "test-api-key"
-      }
-    }
-  }
-}
-```
-
-## Connecting with Claude Desktop
-
-To use the MCP server with Claude Desktop:
-
-1. Copy the built MCP server:
-```bash
-docker cp $(docker-compose -f docker-compose.test.yml ps -q mcp-server):/app/dist ./mcp-dist
-```
-
-2. Update Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
-```json
-{
-  "mcpServers": {
-    "coaia-visualizer": {
-      "command": "node",
-      "args": ["<path-to>/mcp-dist/index.js"],
-      "env": {
-        "VISUALIZER_API_URL": "http://localhost:4321",
-        "VISUALIZER_API_KEY": "your-api-key"
-      }
-    }
-  }
-}
-```
-
-3. Restart Claude Desktop
-
-## Available MCP Tools
-
-- `create_chart` - Create new structural tension chart
-- `update_chart` - Update existing chart
-- `delete_chart` - Delete chart
-- `search_charts` - Search charts by query
-- `create_telescoped_chart` - **NEW** Telescope existing action into sub-chart
-- `add_action_step` - Add action (optionally as telescoped chart)
-
-## Troubleshooting
-
-### Services won't start
-```bash
-# Check logs
-docker-compose -f docker-compose.test.yml logs
-
-# Rebuild images
-docker-compose -f docker-compose.test.yml build --no-cache
-```
-
-### Tests fail
-```bash
-# Check individual test output
-cat test-results/test-01/*.json
-cat test-results/test-02/*.json
-cat test-results/test-03/*.json
-```
-
-### API connection issues
-```bash
-# Verify network connectivity
-docker-compose -f docker-compose.test.yml exec test-runner curl -v http://visualizer-app:4321/api/charts
-```
-
-## Development
-
-### Modify tests
-
-Edit files in `test-scripts/`:
-- `run-all-tests.sh` - Main test orchestrator
-- `test-01-basic-operations.sh` - Basic CRUD tests
-- `test-02-telescope-creation.sh` - Telescope feature tests
-- `test-03-navigation.sh` - Navigation and hierarchy tests
-
-### Add test data
-
-Add JSONL files to `test-data/`:
-- `test-master.jsonl` - Sample chart with actions
-
-### Update Docker images
-
-Modify:
-- `Dockerfile.app` - Next.js application
-- `mcp/Dockerfile` - MCP server
-- `Dockerfile.test` - Test runner environment
-
-## CI/CD Integration
-
-This test suite can be integrated into CI/CD pipelines:
-
-```yaml
-# Example GitHub Actions
-- name: Run MCP Tests
-  run: |
-    chmod +x run-mcp-tests.sh
-    ./run-mcp-tests.sh
-  env:
-    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
-```
-
----
-
-## Global CLI Testing
-
-### Quick Test
-
-```bash
-# Run the verification script
-./test-scripts/verify-global-cli.sh
-```
-
-### Tests Included
-
-#### 1. Bash Verification Script
-**File:** `test-scripts/verify-global-cli.sh`
-
-**What it tests:**
-- ✅ CLI starts without errors
-- ✅ No file watch limit errors (Turbopack)
-- ✅ Server becomes ready within timeout
-- ✅ HTTP endpoint responds correctly
-- ✅ Turbopack uses correct project directory
-
-**Usage:**
-```bash
-./test-scripts/verify-global-cli.sh
-```
-
-#### 2. Playwright End-to-End Tests
-**File:** `test-scripts/test-global-cli.spec.ts`
-
-**What it tests:**
-- ✅ CLI launches without file watch errors
-- ✅ Server starts and responds to HTTP requests
-- ✅ UI loads with correct content
-- ✅ Sample chart data loads correctly
-- ✅ Different port configurations work
-
-**Usage:**
-```bash
-npm run test:global-cli
-```
-
-### Expected Output
-
-#### Successful Test
-```
-🧪 Testing globally installed coaia-visualizer CLI
-📁 Sample file: /a/src/coaia-visualizer/samples/tradingchart.jsonl
-🌐 Port: 3099
-
-⏳ Waiting for server to start (PID: 123456)...
-✅ Server started successfully
-🔍 Testing HTTP response...
-✅ Server responding correctly
-🔍 Checking for file watch errors...
-✅ No file watch errors detected
-🔍 Verifying Turbopack project directory...
-✅ Turbopack using correct project directory
-
-✅ All tests passed! CLI works correctly without file watch errors.
-```
-
-### Testing After CLI Changes
-
-After making changes to the CLI, always:
-
-1. **Rebuild the CLI:**
-   ```bash
-   npm run build:cli
-   ```
-
-2. **Reinstall globally:**
-   ```bash
-   npm install -g .
-   ```
-
-3. **Run verification:**
-   ```bash
-   ./test-scripts/verify-global-cli.sh
-   ```
-
-### Related Documentation
-
-- [CLI_FILE_WATCHING_FIX.md](../CLI_FILE_WATCHING_FIX.md) - Complete fix documentation