coaia-visualizer 1.6.2 → 1.6.4

package/QUICK_START_MCP_TESTING.md

@@ -1,236 +0,0 @@
-# Quick Start: MCP Testing Environment
-
-## TL;DR - Run Tests in 3 Steps
-
-### 1. Navigate to Project
-```bash
-cd /workspace/repos/jgwill/coaia-visualizer-feat-4
-```
-
-### 2. Run All Tests
-```bash
-./run-mcp-tests.sh
-```
-
-### 3. Check Results
-```bash
-cat test-results/test-summary.txt
-```
-
-**Done!** ✅ All tests run automatically.
-
----
-
-## What This Does
-
-- ✅ Builds Docker images (visualizer app + MCP server + test runner)
-- ✅ Starts all services in isolated Docker network
-- ✅ Runs complete test suite non-interactively
-- ✅ Generates results in `test-results/` directory
-- ✅ Cleans up all containers
-
-## Test Results
-
-The suite validates:
-
-| Test        | What It Tests            | Validates                                  |
-| ----------- | ------------------------ | ------------------------------------------ |
-| **Test 01** | Chart creation & listing | API connectivity, CRUD operations          |
-| **Test 02** | Telescope functionality  | Sub-chart creation, both telescope methods |
-| **Test 03** | Navigation & hierarchy   | Parent-child relationships, search         |
-
-## Files Overview
-
-```
-Key Files Created:
-├── docker-compose.test.yml        # Docker orchestration
-├── Dockerfile.app                  # Next.js build
-├── Dockerfile.test                 # Test runner
-├── mcp/Dockerfile                  # MCP server build
-├── run-mcp-tests.sh                # Main test script
-├── test-scripts/                   # Individual tests
-│   ├── run-all-tests.sh
-│   ├── test-01-basic-operations.sh
-│   ├── test-02-telescope-creation.sh
-│   ├── test-03-navigation.sh
-│   └── README.md                   # Detailed guide
-├── test-data/                      # Test fixtures
-├── validate-mcp.sh                 # Quick validation
-└── MCP_TESTING_COMPLETE.md         # Full documentation
-```
-
-## Quick Commands
-
-### Run full test suite
-```bash
-./run-mcp-tests.sh
-```
-
-### Quick validation (no Docker)
-```bash
-bash validate-mcp.sh
-```
-
-### View test results
-```bash
-cat test-results/test-summary.txt
-```
-
-### See individual test output
-```bash
-cat test-results/test-02/telescope-existing-action.json | jq .
-```
-
-### Start services manually
-```bash
-docker-compose -f docker-compose.test.yml up -d visualizer-app mcp-server
-```
-
-### Run single test manually
-```bash
-docker-compose -f docker-compose.test.yml run --rm test-runner \
-  /test-scripts/test-02-telescope-creation.sh
-```
-
-### Stop services
-```bash
-docker-compose -f docker-compose.test.yml down
-```
-
-### View service logs
-```bash
-docker-compose -f docker-compose.test.yml logs visualizer-app
-docker-compose -f docker-compose.test.yml logs mcp-server
-```
-
-## MCP Tools Available
-
-After deployment with Claude Desktop, you can use:
-
-- `create_chart` - Create new structural tension chart
-- `update_chart` - Update existing chart
-- `delete_chart` - Remove chart
-- `search_charts` - Search charts
-- `add_action_step` - Add action (optionally telescoped)
-- `create_telescoped_chart` - **NEW** Telescope existing action
-
-## Using with Claude Desktop
-
-1. **Start visualizer:**
-   ```bash
-   npm run dev
-   ```
-
-2. **Configure Claude** with MCP server path
-
-3. **Restart Claude Desktop**
-
-4. **Use telescope tool in conversation:**
-   - "Create a sub-chart for action X"
-   - "Telescope this action"
-   - "Drill down into this step"
-
-## Troubleshooting
-
-| Issue              | Solution                                                     |
-| ------------------ | ------------------------------------------------------------ |
-| Docker build fails | `docker-compose -f docker-compose.test.yml build --no-cache` |
-| Tests don't run    | Check Docker is running: `docker ps`                         |
-| API not responding | Check logs: `docker-compose -f docker-compose.test.yml logs` |
-| Empty test results | Verify API endpoint: `curl http://localhost:4321/api/charts` |
-
-## Environment Notes
-
-### Optional API Keys
-- `ANTHROPIC_API_KEY` - For claude-code CLI testing
-- `GOOGLE_API_KEY` - For gemini-cli testing
-
-Tests work fine without these - they use direct HTTP calls instead.
-
-### System Requirements
-- Docker & Docker Compose
-- Node.js 20+
-- npm/pnpm
-- ~5GB disk space for Docker images
-- ~5-10 minutes for first run (builds images)
-
-## Test Results Locations
-
-```
-test-results/
-├── test-01/                        # Basic operations
-│   ├── create-response.json       # Chart creation response
-│   ├── list-response.json         # List charts response
-│   └── chart-id.txt               # ID for next test
-│
-├── test-02/                        # Telescope operations
-│   ├── telescope-existing-action.json
-│   ├── final-chart-state.json
-│   └── telescoped-chart-id.txt    # ID for test-03
-│
-├── test-03/                        # Navigation
-│   ├── parent-chart.json          # Parent chart state
-│   ├── navigation-summary.txt     # Navigation results
-│
-└── test-summary.txt               # Overall pass/fail
-```
-
-## Docker Network Details
-
-All services run in isolated Docker network:
-
-```
-Network: test-network
-├── visualizer-app:4321    (Next.js app)
-├── mcp-server             (stdin/stdout)
-└── test-runner            (bash/curl)
-
-Data Flow:
-Test Scripts --HTTP--> API:4321 <--HTTP--> MCP Server
-```
-
-## CI/CD Integration
-
-To add to your CI pipeline:
-
-```yaml
-# GitHub Actions example
-- name: Run MCP Tests
-  run: |
-    cd /workspace/repos/jgwill/coaia-visualizer-feat-4
-    chmod +x run-mcp-tests.sh
-    ./run-mcp-tests.sh
-```
-
-Results automatically saved to `test-results/` for review.
-
-## Architecture Overview
-
-```
-┌─────────────────────────────────┐
-│   run-mcp-tests.sh              │
-│   (Main Orchestrator)           │
-└──────────────┬──────────────────┘
-               │
-               ├─ Builds Docker images
-               ├─ Starts services
-               ├─ Runs test suite
-               ├─ Generates results
-               └─ Cleans up
-```
-
-## Full Documentation
-
-For detailed information, see:
-- `MCP_TESTING_COMPLETE.md` - Complete guide
-- `MCP_TESTING_SETUP.md` - Setup details
-- `test-scripts/README.md` - Test documentation
-- `MCP_TESTING_IMPLEMENTATION_SUMMARY.md` - Implementation details
-
----
-
-## Status
-
-✅ **Ready to Use**
-
-All infrastructure is in place. Run `./run-mcp-tests.sh` to test!

package/STC.md

@@ -1,24 +0,0 @@
-
-## Activity Log Entry (2026-04-17T18:59:43Z)
-- **Bot**: @stcissue
-- **Event**: issues.opened
-- **Issue**: #17
-
-
-## Activity Log Entry (2026-05-09T18:21:47Z)
-- **Bot**: @stcissue
-- **Event**: issues.opened
-- **Issue**: #18
-
-
-## Activity Log Entry (2026-05-13T08:33:56Z)
-- **Bot**: @stcissue
-- **Event**: issues.opened
-- **Issue**: #19
-
-
-## Activity Log Entry (2026-05-19T06:53:31Z)
-- **Bot**: @stcissue
-- **Event**: issues.opened
-- **Issue**: #20
-

package/STCISSUE.md

@@ -1,48 +0,0 @@
-
-## Issue #17 - Parent chart due date not applied before adding action steps
-
-- **Repository**: jgwill/coaia-visualizer
-- **State**: open
-- **Category**: technical
-- **Logged**: 2026-04-17T18:59:43Z
-- **GitHub Link**: https://github.com/jgwill/coaia-visualizer/issues/17
-
-### Current Reality
-Issue being tracked via @stcissue bot.
-
-
-## Issue #18 - Render GitHub Project runtime-memory provenance in a non-breaking way
-
-- **Repository**: jgwill/coaia-visualizer
-- **State**: open
-- **Category**: technical
-- **Logged**: 2026-05-09T18:21:47Z
-- **GitHub Link**: https://github.com/jgwill/coaia-visualizer/issues/18
-
-### Current Reality
-Issue being tracked via @stcissue bot.
-
-
-## Issue #19 - nightly release: coaia-visualizer-mcp@1.6.0
-
-- **Repository**: jgwill/coaia-visualizer
-- **State**: open
-- **Category**: technical
-- **Logged**: 2026-05-13T08:33:56Z
-- **GitHub Link**: https://github.com/jgwill/coaia-visualizer/issues/19
-
-### Current Reality
-Issue being tracked via @stcissue bot.
-
-
-## Issue #20 - Render rich COAIA JSONL metadata with chart/action/beat projections
-
-- **Repository**: jgwill/coaia-visualizer
-- **State**: open
-- **Category**: technical
-- **Logged**: 2026-05-19T06:53:31Z
-- **GitHub Link**: https://github.com/jgwill/coaia-visualizer/issues/20
-
-### Current Reality
-Issue being tracked via @stcissue bot.
-