coaia-visualizer 1.4.2 → 1.5.0

package/mcp/src/index.ts

@@ -102,7 +102,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         if (typedArgs.updateDesiredOutcome) updates.updateDesiredOutcome = typedArgs.updateDesiredOutcome
         if (typedArgs.addCurrentRealityObservation) updates.addCurrentRealityObservation = typedArgs.addCurrentRealityObservation
         if ('updateDueDate' in typedArgs) updates.updateDueDate = typedArgs.updateDueDate
-        
+
         const result = await client.updateChart(typedArgs.chartId, updates)
         return {
           content: [
@@ -223,6 +223,21 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         }
       }
 
+      case 'create_telescoped_chart': {
+        const result = await client.createTelescopedChart(
+          typedArgs.chartId,
+          typedArgs.actionName
+        )
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(result, null, 2),
+            },
+          ],
+        }
+      }
+
       case 'delete_chart': {
         const result = await client.deleteChart(typedArgs.chartId)
         return {
@@ -294,7 +309,7 @@ async function main() {
 
   const transport = new StdioServerTransport()
   await server.connect(transport)
-  
+
   console.error('✅ MCP Server running')
 }
 

package/mcp/src/tools/index.ts

@@ -245,6 +245,25 @@ export const DELETE_ACTION_STEP_TOOL: Tool = {
   },
 }
 
+export const CREATE_TELESCOPED_CHART_TOOL: Tool = {
+  name: 'create_telescoped_chart',
+  description: 'Create a telescoped chart from an EXISTING action step. This converts an action into a detailed sub-chart for drilling down into work. Different from add_action_step which creates a NEW action as a telescoped chart.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      chartId: {
+        type: 'string',
+        description: 'The parent chart ID containing the action',
+      },
+      actionName: {
+        type: 'string',
+        description: 'The action entity name to telescope (e.g., "chart_1_action_1")',
+      },
+    },
+    required: ['chartId', 'actionName'],
+  },
+}
+
 export const DELETE_CHART_TOOL: Tool = {
   name: 'delete_chart',
   description: 'Delete a chart and all its sub-charts, actions, and narrative beats',
@@ -310,10 +329,11 @@ export const ALL_TOOLS: Tool[] = [
   UPDATE_ACTION_STEP_TOOL,
   MARK_ACTION_COMPLETE_TOOL,
   UPDATE_ACTION_PROGRESS_TOOL,
+  UPDATE_CURRENT_REALITY_TOOL,
   TOGGLE_ACTION_COMPLETION_TOOL,
   DELETE_ACTION_STEP_TOOL,
+  CREATE_TELESCOPED_CHART_TOOL,
   DELETE_CHART_TOOL,
   SEARCH_CHARTS_TOOL,
   GET_CHART_PROGRESS_TOOL,
-  UPDATE_CURRENT_REALITY_TOOL,
 ]

package/mcp/test_mcp/.gemini/settings.json

@@ -0,0 +1,18 @@
+{
+  "mcpServers": {
+	   "chart-coaia-narrative-legacy-mcp": {
+         "command": "npx",
+         "args": ["-y", "${CNCV}", "--memory-path", "${memories}/trading-chart.coaia-narrative.jsonl" ]
+    },
+     "charts-mcp": {
+      "command": "node",
+      "args": [
+        "/workspace/repos/jgwill/coaia-visualizer-feat-4/mcp/dist/index.js"
+      ],
+      "env": {
+      "COAIAN_API_TOKEN":"123",
+      "COAIAV_API_URL":"http://localhost:4321"
+      }
+    }
+  }
+}

package/mcp-config.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "coaia-visualizer": {
+      "command": "node",
+      "args": [
+        "/app/dist/index.js"
+      ],
+      "env": {
+        "VISUALIZER_API_URL": "http://visualizer-app:4321",
+        "VISUALIZER_API_KEY": "test-api-key"
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coaia-visualizer",
-  "version": "1.4.2",
+  "version": "1.5.0",
   "private": false,
   "type": "module",
   "bin": {
@@ -82,4 +82,4 @@
     "tw-animate-css": "1.3.3",
     "typescript": "^5"
   }
-}
+}

package/run-mcp-tests.sh

@@ -0,0 +1,99 @@
+#!/bin/bash
+
+# MCP Integration Test Runner
+# This script builds and runs the complete Docker-based test environment
+
+set -e
+
+# Get the directory where the script is located
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+cd "$SCRIPT_DIR"
+
+echo "========================================="
+echo "COAIA Visualizer MCP Test Environment"
+echo "========================================="
+echo ""
+echo "Working directory: $(pwd)"
+echo ""
+
+# Check if .env.test exists
+if [ ! -f .env.test ]; then
+    echo "Creating .env.test file..."
+    cat > .env.test << EOF
+VISUALIZER_API_URL=http://visualizer-app:4321
+VISUALIZER_API_KEY=test-api-key
+TEST_MODE=true
+LOG_LEVEL=debug
+EOF
+fi
+
+# Check for API keys if using Claude or Gemini CLI
+if [ -z "$ANTHROPIC_API_KEY" ] && [ -z "$GOOGLE_API_KEY" ]; then
+    echo "⚠ Warning: No ANTHROPIC_API_KEY or GOOGLE_API_KEY found"
+    echo "  Tests will use direct HTTP calls instead of CLI clients"
+    echo ""
+fi
+
+# Clean up previous test results
+echo "Cleaning up previous test results..."
+rm -rf test-results/*
+mkdir -p test-results
+
+# Build and start services
+echo "Building Docker images..."
+docker-compose -f docker-compose.test.yml build
+
+echo ""
+echo "Starting services..."
+docker-compose -f docker-compose.test.yml up -d visualizer-app mcp-server
+
+echo ""
+echo "Waiting for services to be healthy..."
+sleep 10
+
+# Check if visualizer app is running
+if docker-compose -f docker-compose.test.yml ps | grep -q "visualizer-app.*Up"; then
+    echo "✓ Visualizer app is running"
+else
+    echo "✗ Visualizer app failed to start"
+    docker-compose -f docker-compose.test.yml logs visualizer-app
+    exit 1
+fi
+
+# Run tests
+echo ""
+echo "Running integration tests..."
+docker-compose -f docker-compose.test.yml run --rm test-runner
+
+# Capture exit code
+TEST_EXIT_CODE=$?
+
+# Show results
+echo ""
+echo "========================================="
+echo "Test Results"
+echo "========================================="
+
+if [ -f test-results/test-summary.txt ]; then
+    cat test-results/test-summary.txt
+fi
+
+if [ -f test-results/navigation-summary.txt ]; then
+    echo ""
+    cat test-results/navigation-summary.txt
+fi
+
+# Cleanup
+echo ""
+echo "Cleaning up..."
+docker-compose -f docker-compose.test.yml down
+
+echo ""
+if [ $TEST_EXIT_CODE -eq 0 ]; then
+    echo "✓ All tests PASSED"
+else
+    echo "✗ Tests FAILED"
+    echo "  Check test-results/ directory for details"
+fi
+
+exit $TEST_EXIT_CODE

package/samples/tradingchart.jsonl

@@ -0,0 +1,31 @@
+{"type":"entity","name":"chart_1767434421888_chart","entityType":"structural_tension_chart","observations":["Chart created on 2026-01-03T10:00:21.888Z"],"metadata":{"chartId":"chart_1767434421888","dueDate":"2026-01-10","level":0,"createdAt":"2026-01-03T10:00:21.888Z","updatedAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"entity","name":"chart_1767434421888_desired_outcome","entityType":"desired_outcome","observations":["Automated FX trading system generating $1,100-2,200/month profit through validated regime-aware signals with flowing data pipeline"],"metadata":{"chartId":"chart_1767434421888","dueDate":"2026-01-10","createdAt":"2026-01-03T10:00:21.888Z","updatedAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"entity","name":"chart_1767434421888_current_reality","entityType":"current_reality","observations":["Phase 1 complete with 61.9% win rate validated. 9 Python packages integrated. Monitor running (PID 2167008). Data pipeline stalled 9 days - jgtfxcon returning Dec 24 timestamps. TandT validation correctly blocks stale data trades."],"metadata":{"chartId":"chart_1767434421888","createdAt":"2026-01-03T10:00:21.888Z","updatedAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"entity","name":"chart_1767434421888_action_1","entityType":"action_step","observations":["Restore data pipeline flow from broker"],"metadata":{"chartId":"chart_1767434421888","dueDate":"2026-01-15T05:00:00.000Z","completionStatus":false,"createdAt":"2026-01-03T10:00:21.888Z","updatedAt":"2026-01-11T17:06:19.876Z"}}
+{"type":"entity","name":"chart_1767434421888_action_2","entityType":"action_step","observations":["Validate PDS→CDS→TTF end-to-end pipeline"],"metadata":{"chartId":"chart_1767434421888","dueDate":"2026-01-05T07:08:49.920Z","completionStatus":false,"createdAt":"2026-01-03T10:00:21.888Z","updatedAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"entity","name":"chart_1767434421888_action_3","entityType":"action_step","observations":["Achieve first live FDB signal detection"],"metadata":{"chartId":"chart_1767434421888","dueDate":"2026-01-06T05:43:03.936Z","completionStatus":false,"createdAt":"2026-01-03T10:00:21.888Z","updatedAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"entity","name":"chart_1767434421888_action_4","entityType":"action_step","observations":["Deploy container environment for parallel work"],"metadata":{"chartId":"chart_1767434421888","dueDate":"2026-01-07T04:17:17.952Z","completionStatus":false,"createdAt":"2026-01-03T10:00:21.888Z","updatedAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"entity","name":"chart_1767434421888_action_5","entityType":"action_step","observations":["Establish multi-instance coordination protocol"],"metadata":{"chartId":"chart_1767434421888","dueDate":"2026-01-08T02:51:31.968Z","completionStatus":false,"createdAt":"2026-01-03T10:00:21.888Z","updatedAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"entity","name":"chart_1767434421888_action_6","entityType":"action_step","observations":["Execute Phase 2 validation with first trades"],"metadata":{"chartId":"chart_1767434421888","dueDate":"2026-01-09T01:25:45.984Z","completionStatus":false,"createdAt":"2026-01-03T10:00:21.888Z","updatedAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"entity","name":"chart_1767434421888_beat_1767606309464","entityType":"narrative_beat","observations":["Act 1 Setup","Timestamp: 2026-01-05T09:45:09.464Z","Universe: engineer-world, ceremony-world, story-engine-world"],"metadata":{"chartId":"chart_1767434421888","act":1,"type_dramatic":"Setup","universes":["engineer-world","ceremony-world","story-engine-world"],"timestamp":"2026-01-05T09:45:09.464Z","createdAt":"2026-01-05T09:45:09.464Z","narrative":{"description":"Chart created Jan 3, 2026 capturing the creative tension between validated Phase 1 (61.9% WR) and desired Phase 2 ($1.1-2.2K/month)","prose":"The structural tension forms: desired outcome ($1,100-2,200/month through regime-aware signals) meets current reality (61.9% win rate validated, but data pipeline stalled 9 days). The tension is creative, not problematic—TandT correctly blocks stale data trades. Six action steps distribute across Jan 4-9, each a stepping stone toward the living system. The dream is named; the path is visible; the blocker is honest.","lessons":["Structural tension = creative force, not problem to solve","Phase 1 success (61.9% WR) validates the approach","jgtfxcon Dec 24 timestamp issue is the critical blocker","TandT validation working correctly—system protecting itself"]},"relationalAlignment":{"assessed":false,"score":null,"principles":[]},"fourDirections":{"north_vision":null,"east_intention":null,"south_emotion":null,"west_introspection":null}}}
+{"type":"entity","name":"chart_1767434421888_beat_1767606319012","entityType":"narrative_beat","observations":["Act 2 Discovery/Learning","Timestamp: 2026-01-05T09:45:19.012Z","Universe: engineer-world, ceremony-world, story-engine-world"],"metadata":{"chartId":"chart_1767434421888","act":2,"type_dramatic":"Discovery/Learning","universes":["engineer-world","ceremony-world","story-engine-world"],"timestamp":"2026-01-05T09:45:19.012Z","createdAt":"2026-01-05T09:45:19.012Z","narrative":{"description":"Commit e697d04 imports 19 files (+2252 lines) including jgtfxcon, Phase1 reports, and session launchers into git provenance","prose":"The scattered artifacts of Phase 1—jgtfxcon broker connections, implementation plans, progress reports—gather into a single repository. Like tools laid on a workbench before the craft begins, 2252 lines of code and documentation find their place in version control. The data pipeline blocker (Dec 24 timestamps) remains, but now the code to diagnose it lives in sacred git space where archaeology becomes possible.","lessons":["jgtfxcon package now accessible for pipeline debugging","Phase 1 documentation (61.9% WR) preserved for reference","Git provenance enables collaborative development","Blocker visible but unresolved: e697d04 is foundation, not fix"]},"relationalAlignment":{"assessed":false,"score":null,"principles":[]},"fourDirections":{"north_vision":null,"east_intention":null,"south_emotion":null,"west_introspection":null}}}
+{"type":"entity","name":"chart_1767434421888_beat_1767606330232","entityType":"narrative_beat","observations":["Act 3 Character Development","Timestamp: 2026-01-05T09:45:30.232Z","Universe: engineer-world, ceremony-world, story-engine-world"],"metadata":{"chartId":"chart_1767434421888","act":3,"type_dramatic":"Character Development","universes":["engineer-world","ceremony-world","story-engine-world"],"timestamp":"2026-01-05T09:45:30.232Z","createdAt":"2026-01-05T09:45:30.232Z","narrative":{"description":"Commit 3427a35 enhances LAUNCH script with EAST/NORTH directional framing (+101/-8 lines)","prose":"Before executing, we ground. The LAUNCH script receives ceremonial additions: EAST intention (new beginning, place-based thinking) and NORTH storytelling protocol (reflection, not logging). The shell script—mere syntax before—becomes ritual object. MCP tool integration points Claude Code toward trading-chart-coaia-narrative for narrative storage. The blocker remains acknowledged but this commit says: when we do fix it, we will know why.","lessons":["Epistemological framing precedes execution","EAST: Place-based intention grounds the work","NORTH: Storytelling transforms logs into medicine","Blocker acknowledged in script documentation"]},"relationalAlignment":{"assessed":false,"score":null,"principles":[]},"fourDirections":{"north_vision":null,"east_intention":null,"south_emotion":null,"west_introspection":null}}}
+{"type":"relation","from":"chart_1767434421888_chart","to":"chart_1767434421888_desired_outcome","relationType":"contains","metadata":{"createdAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"relation","from":"chart_1767434421888_chart","to":"chart_1767434421888_current_reality","relationType":"contains","metadata":{"createdAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"relation","from":"chart_1767434421888_current_reality","to":"chart_1767434421888_desired_outcome","relationType":"creates_tension_with","metadata":{"createdAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"relation","from":"chart_1767434421888_chart","to":"chart_1767434421888_action_1","relationType":"contains","metadata":{"createdAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"relation","from":"chart_1767434421888_action_1","to":"chart_1767434421888_desired_outcome","relationType":"advances_toward","metadata":{"createdAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"relation","from":"chart_1767434421888_chart","to":"chart_1767434421888_action_2","relationType":"contains","metadata":{"createdAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"relation","from":"chart_1767434421888_action_2","to":"chart_1767434421888_desired_outcome","relationType":"advances_toward","metadata":{"createdAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"relation","from":"chart_1767434421888_chart","to":"chart_1767434421888_action_3","relationType":"contains","metadata":{"createdAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"relation","from":"chart_1767434421888_action_3","to":"chart_1767434421888_desired_outcome","relationType":"advances_toward","metadata":{"createdAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"relation","from":"chart_1767434421888_chart","to":"chart_1767434421888_action_4","relationType":"contains","metadata":{"createdAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"relation","from":"chart_1767434421888_action_4","to":"chart_1767434421888_desired_outcome","relationType":"advances_toward","metadata":{"createdAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"relation","from":"chart_1767434421888_chart","to":"chart_1767434421888_action_5","relationType":"contains","metadata":{"createdAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"relation","from":"chart_1767434421888_action_5","to":"chart_1767434421888_desired_outcome","relationType":"advances_toward","metadata":{"createdAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"relation","from":"chart_1767434421888_chart","to":"chart_1767434421888_action_6","relationType":"contains","metadata":{"createdAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"relation","from":"chart_1767434421888_action_6","to":"chart_1767434421888_desired_outcome","relationType":"advances_toward","metadata":{"createdAt":"2026-01-03T10:00:21.888Z"}}
+{"type":"relation","from":"chart_1767434421888_beat_1767606309464","to":"chart_1767434421888_chart","relationType":"documents","metadata":{"createdAt":"2026-01-05T09:45:09.467Z","description":"Narrative beat documents chart progress"}}
+{"type":"relation","from":"chart_1767434421888_beat_1767606319012","to":"chart_1767434421888_chart","relationType":"documents","metadata":{"createdAt":"2026-01-05T09:45:19.014Z","description":"Narrative beat documents chart progress"}}
+{"type":"relation","from":"chart_1767434421888_beat_1767606330232","to":"chart_1767434421888_chart","relationType":"documents","metadata":{"createdAt":"2026-01-05T09:45:30.234Z","description":"Narrative beat documents chart progress"}}
+{"type":"relation","from":"chart_1767434421888","to":"chart_1767434421888_action_1","relationType":"contains","metadata":{}}

package/test-data/test-master.jsonl

@@ -0,0 +1,11 @@
+{"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

@@ -0,0 +1,101 @@
+=========================================
+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

@@ -0,0 +1,239 @@
+# 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 }}
+```

package/test-scripts/run-all-tests.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+set -e
+
+echo "========================================="
+echo "COAIA Visualizer MCP Integration Tests"
+echo "========================================="
+echo ""
+
+# Wait for services to be ready
+echo "Waiting for services to be ready..."
+sleep 5
+
+# Check if visualizer API is accessible
+echo "Testing Visualizer API connectivity..."
+if curl -f http://visualizer-app:4321/api/charts > /dev/null 2>&1; then
+    echo "✓ Visualizer API is accessible"
+else
+    echo "✗ Visualizer API is not accessible"
+    exit 1
+fi
+
+echo ""
+echo "Running MCP tool tests..."
+echo ""
+
+# Run individual test suites
+/test-scripts/test-01-basic-operations.sh
+/test-scripts/test-02-telescope-creation.sh
+/test-scripts/test-03-navigation.sh
+
+echo ""
+echo "========================================="
+echo "All tests completed!"
+echo "========================================="
+
+# Save results summary
+date > /test-results/test-summary.txt
+echo "All MCP integration tests passed" >> /test-results/test-summary.txt