[{"_1":2,"_320":-5,"_321":-5},"loaderData",{"_3":4,"_22":23,"_232":233},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"bot","id",22248096,"membership","referenceId","019a3c9b-43cc-72d8-8c00-496521d6e6ee","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_26":-5,"_27":28,"_29":41,"_148":149,"_231":135},"availableLocales",[],"githubUser","locale",{"_29":30,"_37":38,"_39":40},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","Automates Close-to-Shore methodology for Godot game development by creating tasks in Shrimp MCP from hop plans and generating interactive visualizations of signal architectures, dependencies, and project metrics.","displayName","CTS MCP Server","readme","# CTS MCP Server\n\n**Version**: 3.0.0 \n**Protocol**: Model Context Protocol 2024-11-05 \n**Status**: ✅ Production Ready\n\nModel Context Protocol server for Close-to-Shore (CTS) methodology automation, providing automated task creation in Shrimp MCP and interactive artifact visualization (signal maps, hop dashboards, dependency graphs) for Godot game development.\n\n## Features\n\n### Tier 3 Infrastructure (v3.0.0 - NEW!)\n\n- 🚀 **CI/CD Pipeline**: GitHub Actions with test, performance, quality, security jobs\n- 📦 **NPM Package**: Scoped `@broken-divinity/cts-mcp-server` ready for npm publish\n- 🐳 **Docker Support**: Multi-stage Alpine image (150-200MB), production-ready\n- 📊 **Observability**: Structured logging, metrics collection, Prometheus export\n- ⚡ **Performance**: All benchmarks passing (<2ms cache, <100ms config, <5ms sampling)\n- 🧪 **Test Coverage**: 772 tests passing (635+ from Tier 2C improvements)\n\n### Tier 2C Production Hardening (v3.0.0)\n\n- 💾 **Result Caching**: LRU cache with SHA-256 hashing (<2ms operations, 29/29 tests ✅)\n- ⚙️ **Hot-Reload Configuration**: JSON-based config with validation (28/28 tests ✅)\n- 📏 **Stratified Sampling**: Efficient large dataset handling (<5ms small, <100ms large, 18/18 tests ✅)\n- 🛡️ **Enhanced Error Handling**: Actionable CTSError types with recovery suggestions (10/10 tests ✅)\n- ✅ **Schema Validation**: Zod schemas for all 9 tools (16/16 tests ✅)\n- 🔧 **Tool Integration**: Consistent interface, cache support, metrics tracking (16/16 tests ✅)\n\n### Phase 2 Enhancements (v2.0.0)\n\n- 🎯 **AST-Level Parsing**: Tree-sitter-gdscript with 100% signal extraction accuracy\n- 🌐 **Clustered Signal Maps**: Community detection with convex hull visualization (150-300 signals)\n- 📊 **Dependency Graphs**: Cross-file signal connection tracking and visualization\n- 📈 **Performance Trends**: Time-series monitoring of parse time, signal count, memory usage\n- ⚡ **250x Faster Clustering**: 3ms for 150 nodes (greedy modularity optimization)\n- 🧬 **20x Faster Parsing**: 12.5ms for 1K LOC files (tree-sitter WASM)\n\n### Core Features\n\n- �🚀 **Automated Task Creation**: Convert hop plans to Shrimp tasks via stdio IPC (30min → 5min per hop)\n- 📊 **Signal Architecture Visualization**: D3.js force-directed graphs showing EventBus/SignalBus connections\n- 📈 **CTS Compliance Dashboard**: React-based hop status boards with real-time progress tracking\n- ⚡ **High Performance**: <50ms server startup, <400ms clustered map rendering\n- 🧪 **Well-Tested**: 188 tests (93.6% pass rate), comprehensive coverage\n- 🔒 **Secure**: Stdio transport, Zod validation, webview sandbox\n\n## Quick Start\n\n### Installation\n\n```bash\ncd cts_mcp\nnpm install\nnpm run build\n```\n\n**Note**: The server uses web-tree-sitter (WASM) for GDScript parsing. If the WASM file (`tree-sitter-gdscript.wasm`) is not available, the server will automatically fall back to a proven regex parser. See `docs/WASM_SETUP.md` for details.\n\n### Usage\n\nStart the MCP server (stdio transport):\n\n```bash\nnode build/index.js\n```\n\nThe server listens on stdin and writes to stdout using JSON-RPC 2.0 protocol.\n\n## Tools\n\n### 1. CTS_Export_to_Shrimp\n\nConvert hop plan JSON to Shrimp tasks automatically.\n\n**Input**:\n```json\n{\n \"hopPlanJson\": \"{\\\"phases\\\":[{\\\"name\\\":\\\"Phase 1\\\",\\\"hops\\\":[{\\\"id\\\":\\\"1.1\\\",\\\"name\\\":\\\"Setup\\\",\\\"description\\\":\\\"Initialize project\\\",\\\"estimatedLOC\\\":200,\\\"dependencies\\\":[]}]}]}\"\n}\n```\n\n**Output**:\n```json\n{\n \"success\": true,\n \"tasksCreated\": 1,\n \"taskIds\": [\"550e8400-e29b-41d4-a716-446655440000\"]\n}\n```\n\n**Example**:\n```bash\necho '{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"CTS_Export_to_Shrimp\",\n \"arguments\": {\n \"hopPlanJson\": \"{\\\"phases\\\":[{\\\"name\\\":\\\"Phase 1\\\",\\\"hops\\\":[{\\\"id\\\":\\\"1.1\\\",\\\"name\\\":\\\"Setup Infrastructure\\\",\\\"description\\\":\\\"Initialize TypeScript project\\\",\\\"estimatedLOC\\\":200,\\\"dependencies\\\":[]}]}]}\"\n }\n }\n}' | node build/index.js\n```\n\n### 2. CTS_Render_Artifact\n\nRender interactive visualizations (signal maps, hop dashboards, dependency graphs, performance trends).\n\n**Supported Artifact Types**:\n- `signal_map`: Basic force-directed signal graph\n- `signal_map_v2`: Clustered signal map with community detection (Phase 2)\n- `dependency_graph`: Hierarchical signal connection visualization (Phase 2)\n- `performance_trends`: Time-series performance monitoring (Phase 2)\n- `hop_dashboard`: CTS hop status board\n\n**Signal Map V2 (Clustered) Example**:\n```bash\ncat test_signal_map_v2.json | node build/index.js 2>/dev/null | jq '.result.content[0].text' -r | jq -r '.html' > clustered_map.html\n```\n\n**Features**:\n- Greedy modularity optimization clustering\n- Convex hull boundaries for clusters\n- Interactive legend (toggle cluster visibility)\n- Performance overlay (clustering + render time)\n- Supports 150-300 signals\n\n**Dependency Graph Example**:\n```bash\ncat test_dependency_graph.json | node build/index.js 2>/dev/null | jq '.result.content[0].text' -r | jq -r '.html' > dependencies.html\n```\n\n**Features**:\n- Hierarchical tree layout\n- Signal definitions (green) and connections (blue)\n- File grouping visualization\n- Cross-file tracking\n\n**Performance Trends Example**:\n```bash\ncat test_performance_trends.json | node build/index.js 2>/dev/null | jq '.result.content[0].text' -r | jq -r '.html' > trends.html\n```\n\n**Features**:\n- Multi-line time-series chart (D3.js)\n- Metric selection (dropdown)\n- Zoom/pan interaction\n- Threshold annotations\n\n**Hop Dashboard Example**:\n```bash\ncat test_hop_dashboard.json | node build/index.js 2>/dev/null | jq '.result.content[0].text' -r | jq -r '.html' > hop_dashboard.html\n```\n\n### 3. CTS_Scan_Project_Signals\n\nScan Godot project for signal definitions.\n\n**Input**:\n```json\n{\n \"projectPath\": \"/home/user/Godot/MyProject\",\n \"includeEventBusOnly\": true\n}\n```\n\n**Output**:\n```json\n{\n \"success\": true,\n \"signalsFound\": 55,\n \"data\": {\n \"signals\": [...],\n \"filters\": {}\n }\n}\n```\n\n## Examples\n\n### Example 1: Render Signal Map\n\n```bash\n# 1. Create test data\ncat > test_signals.json << 'EOF'\n{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"CTS_Render_Artifact\",\n \"arguments\": {\n \"artifactType\": \"signal_map\",\n \"data\": \"{\\\"signals\\\":[{\\\"name\\\":\\\"player_health_changed\\\",\\\"file\\\":\\\"autoload/EventBus.gd\\\",\\\"line\\\":5,\\\"connections\\\":[{\\\"file\\\":\\\"ui/HealthBar.gd\\\",\\\"line\\\":12},{\\\"file\\\":\\\"components/HealthComponent.gd\\\",\\\"line\\\":45}]},{\\\"name\\\":\\\"player_died\\\",\\\"file\\\":\\\"autoload/EventBus.gd\\\",\\\"line\\\":6,\\\"connections\\\":[{\\\"file\\\":\\\"scenes/GameManager.gd\\\",\\\"line\\\":78},{\\\"file\\\":\\\"ui/DeathScreen.gd\\\",\\\"line\\\":23}]}],\\\"filters\\\":{}}\"\n }\n }\n}\nEOF\n\n# 2. Render and save HTML\ncat test_signals.json | node build/index.js 2>/dev/null | jq '.result.content[0].text' -r | jq -r '.html' > signal_map.html\n\n# 3. Open in browser\nxdg-open signal_map.html\n```\n\n**Result**: Interactive D3.js force-directed graph with 2 signals and 4 connections.\n\n### Example 2: Render Hop Dashboard\n\n```bash\n# 1. Create test data\ncat > test_hops.json << 'EOF'\n{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"CTS_Render_Artifact\",\n \"arguments\": {\n \"artifactType\": \"hop_dashboard\",\n \"data\": \"{\\\"phases\\\":[{\\\"name\\\":\\\"Phase 1: Foundation\\\",\\\"hops\\\":[{\\\"id\\\":\\\"5.1a\\\",\\\"name\\\":\\\"MCP Core Infrastructure\\\",\\\"status\\\":\\\"completed\\\",\\\"estimatedLOC\\\":400,\\\"actualLOC\\\":421,\\\"ctsCompliant\\\":true,\\\"dependencies\\\":[],\\\"testCoverage\\\":85},{\\\"id\\\":\\\"5.1b\\\",\\\"name\\\":\\\"Artifact Visualizations\\\",\\\"status\\\":\\\"in_progress\\\",\\\"estimatedLOC\\\":350,\\\"actualLOC\\\":294,\\\"ctsCompliant\\\":true,\\\"dependencies\\\":[\\\"5.1a\\\"],\\\"testCoverage\\\":78}]}],\\\"statistics\\\":{\\\"totalLOC\\\":715,\\\"plannedLOC\\\":750,\\\"complianceRate\\\":100,\\\"completionRate\\\":50}}\"\n }\n }\n}\nEOF\n\n# 2. Render and save HTML\ncat test_hops.json | node build/index.js 2>/dev/null | jq '.result.content[0].text' -r | jq -r '.html' > hop_dashboard.html\n\n# 3. Open in browser\nxdg-open hop_dashboard.html\n```\n\n**Result**: Interactive React dashboard with 2 hops, status filtering, and statistics panel.\n\n### Example 3: Export to Shrimp (Requires Shrimp MCP Running)\n\n```bash\n# 1. Start Shrimp MCP server (in separate terminal)\n# (Follow Shrimp MCP setup instructions)\n\n# 2. Create hop plan\ncat > hop_plan.json << 'EOF'\n{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"CTS_Export_to_Shrimp\",\n \"arguments\": {\n \"hopPlanJson\": \"{\\\"phases\\\":[{\\\"name\\\":\\\"Phase 1: Setup\\\",\\\"hops\\\":[{\\\"id\\\":\\\"1.1\\\",\\\"name\\\":\\\"Initialize TypeScript Project\\\",\\\"description\\\":\\\"Create package.json, tsconfig.json, and src structure\\\",\\\"estimatedLOC\\\":200,\\\"dependencies\\\":[]},{\\\"id\\\":\\\"1.2\\\",\\\"name\\\":\\\"Implement MCP Server\\\",\\\"description\\\":\\\"Create server.ts with stdio transport and protocol handlers\\\",\\\"estimatedLOC\\\":300,\\\"dependencies\\\":[\\\"1.1\\\"]}]}]}\"\n }\n }\n}\nEOF\n\n# 3. Export to Shrimp\ncat hop_plan.json | node build/index.js\n\n# 4. Check Shrimp for created tasks\n# (Use Shrimp CLI or UI to view tasks)\n```\n\n**Result**: 2 tasks created in Shrimp with dependencies configured.\n\n## GDScript Integration\n\nThe CTS MCP server can be called from Godot GDScript using the `BDMCPClient` from the `bd_dev_tools` addon.\n\n### Prerequisites\n\n1. Install `bd_dev_tools` addon (contains `BDMCPClient`)\n2. Build the CTS MCP server: `npm run build`\n3. Ensure CTS MCP binary is accessible at `cts_mcp/build/index.js`\n\n### Quick Start\n\n```gdscript\nextends Node\n\nvar mcp_client: BDMCPClient\n\nfunc _ready() -> void:\n # Initialize MCP client\n mcp_client = BDMCPClient.new()\n add_child(mcp_client)\n \n # Register CTS MCP server\n var error := CTSMCPConfig.register_cts_server(mcp_client)\n if error != OK:\n push_error(\"Failed to register CTS MCP server: \", error)\n return\n \n # Connect to server (starts stdio subprocess)\n error = CTSMCPConfig.connect_to_cts_server(mcp_client)\n if error != OK:\n push_error(\"Failed to connect to CTS MCP server: \", error)\n return\n \n print(\"✅ CTS MCP server ready!\")\n \n # Example: Export hop plan to Shrimp\n _export_example_hop()\n\nfunc _export_example_hop() -> void:\n var hop_plan := {\n \"phases\": [{\n \"name\": \"Phase 1: Foundation\",\n \"hops\": [{\n \"id\": \"1.1\",\n \"name\": \"Setup TypeScript Project\",\n \"description\": \"Initialize npm project with TypeScript config\",\n \"estimatedLOC\": 200,\n \"dependencies\": []\n }]\n }]\n }\n \n var response := CTSMCPConfig.call_export_to_shrimp(\n mcp_client,\n hop_plan,\n \"append\", # updateMode: append, overwrite, selective, clearAllTasks\n true # generateSubTasks\n )\n \n if response.has(\"error\"):\n push_error(\"❌ Export failed: \", response.error.message)\n return\n \n print(\"✅ Tasks created: \", response.content.tasksCreated)\n print(\"📋 Task IDs: \", response.content.taskIds)\n```\n\n### API Reference\n\n#### CTSMCPConfig.register_cts_server(client: BDMCPClient) -> Error\n\nRegisters the CTS MCP server configuration with the MCP client.\n\n**Parameters**:\n- `client`: BDMCPClient instance\n\n**Returns**: `Error` enum (OK or error code)\n\n**Example**:\n```gdscript\nvar error := CTSMCPConfig.register_cts_server(mcp_client)\nif error != OK:\n push_error(\"Registration failed: \", error)\n```\n\n#### CTSMCPConfig.connect_to_cts_server(client: BDMCPClient) -> Error\n\nConnects to the CTS MCP server (starts stdio subprocess).\n\n**Parameters**:\n- `client`: BDMCPClient instance (must be registered first)\n\n**Returns**: `Error` enum (OK or error code)\n\n**Example**:\n```gdscript\nvar error := CTSMCPConfig.connect_to_cts_server(mcp_client)\nif error != OK:\n push_error(\"Connection failed: \", error)\n```\n\n#### CTSMCPConfig.call_export_to_shrimp(client: BDMCPClient, hop_plan: Dictionary, update_mode: String, generate_sub_tasks: bool) -> Dictionary\n\nExports a hop plan to Shrimp MCP as tasks.\n\n**Parameters**:\n- `client`: BDMCPClient instance (must be connected)\n- `hop_plan`: Hop plan dictionary (see schema below)\n- `update_mode`: Task update mode (`\"append\"`, `\"overwrite\"`, `\"selective\"`, `\"clearAllTasks\"`)\n- `generate_sub_tasks`: Whether to split hops into subtasks\n\n**Returns**: Dictionary with keys:\n- `content`: `{ tasksCreated: int, taskIds: Array, details: Array }`\n- `error`: `{ code: String, message: String }` (if failed)\n\n**Hop Plan Schema**:\n```gdscript\n{\n \"phases\": [\n {\n \"name\": \"Phase Name\",\n \"hops\": [\n {\n \"id\": \"1.1\",\n \"name\": \"Hop Name\",\n \"description\": \"Hop description\",\n \"estimatedLOC\": 200,\n \"dependencies\": [\"0.9\"] # Optional\n }\n ]\n }\n ]\n}\n```\n\n**Example**:\n```gdscript\nvar response := CTSMCPConfig.call_export_to_shrimp(\n mcp_client,\n {\"phases\": [...]},\n \"append\",\n true\n)\nprint(\"Tasks created: \", response.content.tasksCreated)\n```\n\n### Advanced Usage\n\n**Call other CTS tools directly:**\n\n```gdscript\n# CTS_Scan_Project_Signals\nvar scan_args := {\n \"projectPath\": \"/home/user/Godot/MyProject\",\n \"includeEventBusOnly\": true\n}\nvar scan_response := mcp_client.call_tool(\"cts_mcp\", \"CTS_Scan_Project_Signals\", scan_args)\nprint(\"Signals found: \", scan_response.content.signalsFound)\n\n# CTS_Render_Artifact (Signal Map V2)\nvar artifact_args := {\n \"artifactType\": \"signal_map_v2\",\n \"data\": JSON.stringify({\n \"signals\": scan_response.content.data.signals,\n \"filters\": {}\n })\n}\nvar artifact_response := mcp_client.call_tool(\"cts_mcp\", \"CTS_Render_Artifact\", artifact_args)\nprint(\"Artifact HTML saved to: \", artifact_response.content.filePath)\n```\n\n### Error Handling\n\n```gdscript\n# Check if CTS MCP server is available before calling\nvar error := CTSMCPConfig.register_cts_server(mcp_client)\nif error == ERR_FILE_NOT_FOUND:\n push_error(\"CTS MCP server not built. Run: cd cts_mcp && npm run build\")\n return\nelif error != OK:\n push_error(\"Failed to register CTS MCP server: \", error)\n return\n\n# Handle tool call errors\nvar response := mcp_client.call_tool(\"cts_mcp\", \"CTS_Export_to_Shrimp\", arguments)\nif response.has(\"error\"):\n push_error(\"Tool call failed: \", response.error.message)\n push_error(\"Error code: \", response.error.code)\n```\n\n### Debugging\n\nEnable debug logging in `BDMCPClient`:\n\n```gdscript\n# In autoload/EventBus.gd or your initialization script\nEventBus.mcp_debug_enabled = true\n\n# Now all MCP communication will be logged:\n# [MCP] Sending request: {\"jsonrpc\":\"2.0\",...}\n# [MCP] Received response: {\"result\":...}\n```\n\nCheck CTS MCP server logs:\n\n```bash\n# Run CTS MCP server manually to see logs\nnode build/index.js\n\n# Send test request\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}' | node build/index.js\n```\n\n### Testing\n\nThe CTS MCP integration is validated by GUT tests in `test/cts_mcp/test_cts_mcp_client.gd`.\n\n**Run tests via Godot Editor:**\n1. Open Godot Editor: `godot4 --path /home/eric/Godot/ProtoBd --editor`\n2. Navigate to: Bottom Panel → GUT → Run Tests\n3. Select `test/cts_mcp/test_cts_mcp_client.gd` in the test list\n4. Click \"Run\" button\n5. View results in GUT panel\n\n**Test Coverage:**\n- Server registration and connection\n- Tool list retrieval\n- CTS_Export_to_Shrimp calls with various hop plans\n- Error handling (invalid arguments, server unavailable)\n- Response validation (schema compliance)\n\n**Example test structure:**\n```gdscript\ngodot4 --path . --headless -s addons/gut/gut_cmdln.gd -gtest=res://test/cts_mcp/\n\n# Or use the GUT panel in Godot Editor\n# Navigate to: Bottom Panel -> GUT -> Select test/cts_mcp/test_cts_mcp_client.gd -> Run\n```\n\nExpected test results:\n- ✅ `test_cts_server_registration` - Registers server successfully\n- ✅ `test_cts_connection` - Connects to server\n- ✅ `test_list_cts_tools` - Lists 9+ tools (CTS_Export_to_Shrimp, CTS_Render_Artifact, etc.)\n- ✅ `test_call_export_to_shrimp` - Calls tool and receives response\n- ✅ `test_error_handling_missing_binary` - Handles missing binary gracefully\n- ✅ `test_connection_timeout` - Handles connection timeout\n- ✅ `test_server_lifecycle` - Full lifecycle (register, connect, disconnect)\n\n## Architecture\n\n### Technology Stack\n\n- **Runtime**: Node.js 20+\n- **Language**: TypeScript 5.0 (strict mode)\n- **Protocol**: Model Context Protocol (stdio transport)\n- **Validation**: Zod 3.22\n- **Visualization**: D3.js 7 (CDN), React 18 (CDN)\n- **Testing**: Jest 29.7\n\n### Project Structure\n\n```\ncts_mcp/\n├── src/\n│ ├── index.ts # Entry point (stdio transport)\n│ ├── server.ts # MCP server (protocol handlers)\n│ ├── types.ts # TypeScript interfaces\n│ ├── parser/\n│ │ ├── tree_sitter_bridge.ts # WASM tree-sitter integration (Phase 2)\n│ │ ├── signal_extractor.ts # AST signal extraction (Phase 2)\n│ │ └── parser_diagnostics.ts # Regression testing (Phase 2)\n│ ├── artifacts/\n│ │ ├── artifact_engine.ts # Renderer routing + caching\n│ │ ├── metadata.ts # Versioning system (Phase 2)\n│ │ ├── types.ts # Artifact schemas\n│ │ ├── clustering/\n│ │ │ └── community_detection.ts # Greedy modularity (Phase 2)\n│ │ ├── parsers/\n│ │ │ └── gdscript_parser.ts # Signal extraction (Phase 1)\n│ │ └── renderers/\n│ │ ├── d3_signal_map.ts # Basic force-directed (Phase 1)\n│ │ ├── d3_signal_map_v2.ts # Clustered map (Phase 2)\n│ │ ├── dependency_graph.ts # Connection tracking (Phase 2)\n│ │ ├── performance_trends.ts # Time-series (Phase 2)\n│ │ └── react_hop_dashboard.ts # React dashboard (Phase 1)\n│ ├── metrics/\n│ │ └── performance_pipeline.ts # Trend data collection (Phase 2)\n│ ├── tools/\n│ │ ├── cts_export_to_shrimp.ts # Shrimp integration\n│ │ ├── render_artifact.ts # Artifact tool\n│ │ └── scan_project_signals.ts # Signal scanner\n│ └── integrations/\n│ └── webview_manager_template.ts # VS Code webview\n├── test/\n│ ├── __tests__/ # Jest tests (188 total)\n│ │ ├── tree_sitter_bridge.test.ts (12 tests)\n│ │ ├── signal_extractor.test.ts (15 tests)\n│ │ ├── parser_diagnostics.test.ts (30 tests)\n│ │ ├── clustered_signal_map.test.ts (19 tests)\n│ │ └── ... (other test files)\n│ └── fixtures/\n│ ├── *.gd # GDScript test files (20 files)\n│ └── ground_truth/*.json # Expected extraction results\n├── docs/\n│ ├── signals/\n│ │ └── PHASE_2_SIGNAL_CONTRACTS.md\n│ ├── architecture/decisions/\n│ │ ├── ADR_TREE_SITTER_ADOPTION.md\n│ │ └── ADR_CLUSTERING_STRATEGY.md\n│ ├── guides/\n│ │ └── PHASE_2_MIGRATION.md\n│ └── PHASE_CTS_MCP_2_COMPLETION_REPORT.md\n├── scripts/\n│ └── benchmark_clustering.js # Performance benchmarks\n├── build/ # Compiled JavaScript\n├── package.json\n├── tsconfig.json\n└── jest.config.cjs\n```\n\n### Performance\n\n| Metric | Target | Actual (Phase 2) | Status |\n|--------|--------|------------------|--------|\n| Server Startup | <2s | 46ms | ✅ 97.7% faster |\n| Tool Routing | <100ms | 1-2ms | ✅ |\n| Signal Parsing (1K LOC) | <250ms | 12.5ms | ✅ 20x faster |\n| Signal Map (Basic, 50 nodes) | <500ms | 180ms | ✅ |\n| Signal Map (Clustered, 150 nodes) | <1000ms | 400ms | ✅ 2.5x faster |\n| Clustering (150 nodes) | <750ms | 3ms | ✅ 250x faster |\n| Dependency Graph (150 nodes) | <800ms | 300ms | ✅ |\n| Performance Trends (1K samples) | <500ms | 250ms | ✅ |\n| Cache Lookup | <10ms | <1ms | ✅ |\n\n## Development\n\n### Build\n\n```bash\nnpm run build # Compile TypeScript → JavaScript\nnpm run dev # Development mode (no build)\n```\n\n### Testing\n\n```bash\nnpm test # Run all tests\nnpm run test:coverage # Run with coverage report\nnpm run test:watch # Watch mode\n```\n\n**Test Results**:\n- ✅ 23/23 tests passing (100% pass rate)\n- ✅ 85% functional coverage\n- ✅ <2s test execution time\n\n### Code Quality\n\n```bash\ntsc --noEmit # Type checking\nnpm run build # Compilation (0 errors)\n```\n\n## Configuration\n\n### Environment Variables\n\n- `DEBUG=true` - Enable verbose logging\n- `SHRIMP_MCP_PATH=/path/to/shrimp/build/index.js` - Custom Shrimp path\n\n### Cache Configuration\n\nDefault cache settings in `src/artifacts/artifact_engine.ts`:\n\n```typescript\nprivate maxCacheSize = 50; // Max artifacts cached\nprivate maxCacheAge = 3600000; // 1 hour (unused, artifacts are immutable)\n```\n\n## Troubleshooting\n\n### Issue: \"Shrimp MCP not found\"\n\n**Cause**: CTS_Export_to_Shrimp cannot reach Shrimp MCP server\n\n**Solution**:\n1. Ensure Shrimp MCP server is running\n2. Check Shrimp path configuration\n3. Verify stdio IPC permissions\n\n### Issue: Artifact render timeout\n\n**Cause**: Large dataset (100+ signals) exceeds render budget\n\n**Solution**:\n1. Filter signals before rendering (use `includeEventBusOnly: true`)\n2. Increase timeout in VS Code extension\n3. Phase 2 will add graph clustering\n\n### Issue: TypeScript compilation errors\n\n**Cause**: Missing type definitions or syntax errors\n\n**Solution**:\n```bash\nnpm install # Ensure dependencies installed\nnpm run build # Check for specific errors\n```\n\n## Documentation\n\n### Guides\n- **[MCP Server Guide](docs/MCP_SERVER_GUIDE.md)** - Complete usage guide with installation, configuration, and all tool documentation\n- **[API Reference](docs/API_REFERENCE.md)** - Comprehensive API documentation with schemas, types, and examples\n- **[Troubleshooting Guide](docs/TROUBLESHOOTING.md)** - Common issues and solutions\n\n### Infrastructure\n- **[CI/CD Pipeline](docs/CI_CD_PIPELINE.md)** - GitHub Actions workflow, benchmarks, coverage\n- **[Packaging Guide](docs/PACKAGING.md)** - NPM publishing and Docker deployment procedures\n\n### Technical Details\n- **[Tier 2C Improvements](docs/TIER_2C_IMPROVEMENTS.md)** - Production hardening documentation (caching, config, sampling, errors, schemas)\n- **[Phase 2 Migration](docs/guides/PHASE_2_MIGRATION.md)** - Upgrade guide from v1.0 to v2.0\n- **[VS Code MCP Setup](docs/VSCODE_MCP_SETUP.md)** - VS Code integration configuration\n- **[WASM Setup](docs/WASM_SETUP.md)** - Tree-sitter WASM configuration\n\n### Architecture Decision Records\n- **[ADR: Tree-sitter Adoption](docs/architecture/decisions/ADR_TREE_SITTER_ADOPTION.md)**\n- **[ADR: Clustering Strategy](docs/architecture/decisions/ADR_CLUSTERING_STRATEGY.md)**\n- **[ADR: Sandpack Deferral](docs/architecture/decisions/ADR_SANDPACK_PHASE_3.md)**\n- **[ADR: D3.js Signal Map](docs/architecture/decisions/ADR_D3_SIGNAL_MAP.md)**\n\n### Project Documentation\n- **[Test Results](./TEST_RESULTS.md)** - Comprehensive test coverage report\n- **[CHANGELOG](./CHANGELOG.md)** - Version history and release notes\n\n## Contributing\n\nSee [CONTRIBUTING.md](../CONTRIBUTING.md) for development guidelines.\n\n## License\n\nMIT License - See [LICENSE.txt](../LICENSE.txt)\n\n## Changelog\n\n### v3.0.0 (October 31, 2025)\n\n**Tier 0 & Tier 1 Complete** ✅ - Template-First MCP Development\n\n- ✅ **New Tools**: Added 4 tools using template-first design:\n - CTS_Reasoning (template-driven iteration, 750 LOC)\n - CTS_Bughunter (search + heuristic scan, 720 LOC)\n - CTS_Cleanup (filesystem tidy, 740 LOC)\n - CTS_Audit_Project (compliance checks, 740 LOC)\n- ✅ **Tree-Sitter Fix**: Migrated to WASM (`web-tree-sitter`)\n - Unblocked 3 tools: scan_project_signals, analyze_project, suggest_refactoring\n - AST parsing with caching (<50ms per file, <1ms cached)\n - Headless CI/CD compatible (no native module compilation)\n- ✅ **MCP Tool Templates** (Tier 0):\n - TypeScript template: 460 lines, 5 sections (Zod, MCPError, logging, performance tracking)\n - Rust template: 483 lines, 5 sections (safe mutex, tracing, async/await)\n - Template compliance audit: 13 tools scored (avg 64/100, max 90/100)\n- ✅ **Architecture Enhancements**:\n - Signal contracts (Section 10): Cross-MCP data flow schemas\n - Performance budgets (Section 11): <100ms sync tools, <5s async tools\n - Integration topology (Section 12): Coordinator pattern documentation\n- ✅ **GDScript Integration**: MCPClient for CTS tool calling from Godot\n- ✅ **Breaking Changes**:\n - Requires Node.js 18+ (ESM modules, WASM support)\n - tree-sitter → web-tree-sitter (native bindings removed)\n - 9 total tools (5 existing + 4 new)\n\n**Metrics**:\n- Total Tools: 9 (5 existing + 4 new template-based)\n- Total LOC: ~4,500 (implementation) + ~1,200 (tests)\n- Performance: All tools meet <100ms sync / <5s async budgets\n- CTS Compliance: 100% (all files <500 lines)\n- Template Compliance: 90% (cts_export_to_shrimp reference implementation)\n\n### v1.0.0 (2025-10-30)\n\n**Phase CTS_MCP_1 Complete** ✅\n\n- ✅ MCP server with stdio transport\n- ✅ Shrimp integration (CTS_Export_to_Shrimp tool)\n- ✅ D3.js signal map renderer (force-directed graph)\n- ✅ React hop dashboard renderer (interactive filtering)\n- ✅ GDScript parser (signal extraction)\n- ✅ Artifact caching (SHA-256 + LRU)\n- ✅ 23 integration tests (100% pass rate)\n- ✅ 85% functional coverage\n\n**Metrics**:\n- Total LOC: 1,097 (implementation) + 450 (tests)\n- Performance: 97.7% faster than targets\n- CTS Compliance: 100% (all files <500 lines)\n\n## Roadmap\n\n### Phase 2 (Planned)\n- Dependency graph renderer (visualize hop dependencies)\n- Performance chart renderer (LOC over time)\n- Graph clustering (100+ signal support)\n- Tree-sitter GDScript parser (robust signal extraction)\n\n### Phase 3 (Future)\n- Sandpack integration (game visualizers)\n- Scene preview renderer\n- Interactive mechanic demos\n\n---\n\n**Maintained by**: Development Team \n**Questions?**: See [MCP_PROTOCOL.md](../docs/MCP_PROTOCOL.md) or open an issue\n","name","English","tag","en-US",{"_42":43,"_13":44,"_52":32,"_53":32,"_33":34,"_16":54,"_55":56,"_82":83,"_90":-5,"_91":-5,"_92":93,"_138":139,"_143":-5,"_63":126,"_144":130,"_66":145,"_146":147},"addedAt","2025-11-04T16:01:17.427582Z",[45,46,47,48,49,50,51],"category:developer-tools","category:project-management","category:code-analysis","environment:local","hosting:hybrid","language:html","license_grade:f","descriptionMarkdown","descriptionPlainText",13692,"integrations",[57,68,75],{"_58":59,"_31":65,"_66":67},"brand",{"_60":61,"_37":62,"_63":64},"logoSvgPath","M13.983 11.078h2.119a.186.186 0 00.186-.185V9.006a.186.186 0 00-.186-.186h-2.119a.185.185 0 00-.185.185v1.888c0 .102.083.185.185.185m-2.954-5.43h2.118a.186.186 0 00.186-.186V3.574a.186.186 0 00-.186-.185h-2.118a.185.185 0 00-.185.185v1.888c0 .102.082.185.185.185m0 2.716h2.118a.187.187 0 00.186-.186V6.29a.186.186 0 00-.186-.185h-2.118a.185.185 0 00-.185.185v1.887c0 .102.082.185.185.186m-2.93 0h2.12a.186.186 0 00.184-.186V6.29a.185.185 0 00-.185-.185H8.1a.185.185 0 00-.185.185v1.887c0 .102.083.185.185.186m-2.964 0h2.119a.186.186 0 00.185-.186V6.29a.185.185 0 00-.185-.185H5.136a.186.186 0 00-.186.185v1.887c0 .102.084.185.186.186m5.893 2.715h2.118a.186.186 0 00.186-.185V9.006a.186.186 0 00-.186-.186h-2.118a.185.185 0 00-.185.185v1.888c0 .102.082.185.185.185m-2.93 0h2.12a.185.185 0 00.184-.185V9.006a.185.185 0 00-.184-.186h-2.12a.185.185 0 00-.184.185v1.888c0 .102.083.185.185.185m-2.964 0h2.119a.185.185 0 00.185-.185V9.006a.185.185 0 00-.184-.186h-2.12a.186.186 0 00-.186.186v1.887c0 .102.084.185.186.185m-2.92 0h2.12a.185.185 0 00.184-.185V9.006a.185.185 0 00-.184-.186h-2.12a.185.185 0 00-.184.185v1.888c0 .102.082.185.185.185M23.763 9.89c-.065-.051-.672-.51-1.954-.51-.338.001-.676.03-1.01.087-.248-1.7-1.653-2.53-1.716-2.566l-.344-.199-.226.327c-.284.438-.49.922-.612 1.43-.23.97-.09 1.882.403 2.661-.595.332-1.55.413-1.744.42H.751a.751.751 0 00-.75.748 11.376 11.376 0 00.692 4.062c.545 1.428 1.355 2.48 2.41 3.124 1.18.723 3.1 1.137 5.275 1.137.983.003 1.963-.086 2.93-.266a12.248 12.248 0 003.823-1.389c.98-.567 1.86-1.288 2.61-2.136 1.252-1.418 1.998-2.997 2.553-4.4h.221c1.372 0 2.215-.549 2.68-1.009.309-.293.55-.65.707-1.046l.098-.288Z","Docker","slug","docker","Offers multi-stage Alpine image packaging (150-200MB) for containerized deployment of the CTS MCP server in production environments.","uid","dxxdriwcdj",{"_58":69,"_31":73,"_66":74},{"_60":70,"_37":71,"_63":72},"M10.984 13.836a.5.5 0 0 1-.353-.146l-.745-.743a.5.5 0 1 1 .706-.708l.392.391 1.181-1.18a.5.5 0 0 1 .708.707l-1.535 1.533a.504.504 0 0 1-.354.146zm9.353-.147l1.534-1.532a.5.5 0 0 0-.707-.707l-1.181 1.18-.392-.391a.5.5 0 1 0-.706.708l.746.743a.497.497 0 0 0 .706-.001zM4.527 7.452l2.557-1.585A1 1 0 0 0 7.09 4.17L4.533 2.56A1 1 0 0 0 3 3.406v3.196a1.001 1.001 0 0 0 1.527.85zm2.03-2.436L4 6.602V3.406l2.557 1.61zM24 12.5c0 1.93-1.57 3.5-3.5 3.5a3.503 3.503 0 0 1-3.46-3h-2.08a3.503 3.503 0 0 1-3.46 3 3.502 3.502 0 0 1-3.46-3h-.558c-.972 0-1.85-.399-2.482-1.042V17c0 1.654 1.346 3 3 3h.04c.244-1.693 1.7-3 3.46-3 1.93 0 3.5 1.57 3.5 3.5S13.43 24 11.5 24a3.502 3.502 0 0 1-3.46-3H8c-2.206 0-4-1.794-4-4V9.899A5.008 5.008 0 0 1 0 5c0-2.757 2.243-5 5-5s5 2.243 5 5a5.005 5.005 0 0 1-4.952 4.998A2.482 2.482 0 0 0 7.482 12h.558c.244-1.693 1.7-3 3.46-3a3.502 3.502 0 0 1 3.46 3h2.08a3.503 3.503 0 0 1 3.46-3c1.93 0 3.5 1.57 3.5 3.5zm-15 8c0 1.378 1.122 2.5 2.5 2.5s2.5-1.122 2.5-2.5-1.122-2.5-2.5-2.5S9 19.122 9 20.5zM5 9c2.206 0 4-1.794 4-4S7.206 1 5 1 1 2.794 1 5s1.794 4 4 4zm9 3.5c0-1.378-1.122-2.5-2.5-2.5S9 11.122 9 12.5s1.122 2.5 2.5 2.5 2.5-1.122 2.5-2.5zm9 0c0-1.378-1.122-2.5-2.5-2.5S18 11.122 18 12.5s1.122 2.5 2.5 2.5 2.5-1.122 2.5-2.5zm-13 8a.5.5 0 1 0 1 0 .5.5 0 0 0-1 0zm2 0a.5.5 0 1 0 1 0 .5.5 0 0 0-1 0zm12 0c0 1.93-1.57 3.5-3.5 3.5a3.503 3.503 0 0 1-3.46-3.002c-.007.001-.013.005-.021.005l-.506.017h-.017a.5.5 0 0 1-.016-.999l.506-.017c.018-.002.035.006.052.007A3.503 3.503 0 0 1 20.5 17c1.93 0 3.5 1.57 3.5 3.5zm-1 0c0-1.378-1.122-2.5-2.5-2.5S18 19.122 18 20.5s1.122 2.5 2.5 2.5 2.5-1.122 2.5-2.5z","GitHub Actions","github-actions","Provides CI/CD pipeline with automated test, performance, quality, and security jobs for validating CTS MCP server builds and deployments.","m81z7ka5yb",{"_58":76,"_31":80,"_66":81},{"_60":77,"_37":78,"_63":79},"M12 0C5.373 0 0 5.372 0 12c0 6.627 5.373 12 12 12s12-5.373 12-12c0-6.628-5.373-12-12-12zm0 22.46c-1.885 0-3.414-1.26-3.414-2.814h6.828c0 1.553-1.528 2.813-3.414 2.813zm5.64-3.745H6.36v-2.046h11.28v2.046zm-.04-3.098H6.391c-.037-.043-.075-.086-.111-.13-1.155-1.401-1.427-2.133-1.69-2.879-.005-.025 1.4.287 2.395.511 0 0 .513.119 1.262.255-.72-.843-1.147-1.915-1.147-3.01 0-2.406 1.845-4.508 1.18-6.207.648.053 1.34 1.367 1.387 3.422.689-.951.977-2.69.977-3.755 0-1.103.727-2.385 1.454-2.429-.648 1.069.168 1.984.894 4.256.272.854.237 2.29.447 3.201.07-1.892.395-4.652 1.595-5.605-.529 1.2.079 2.702.494 3.424.671 1.164 1.078 2.047 1.078 3.716a4.642 4.642 0 01-1.11 2.996c.792-.149 1.34-.283 1.34-.283l2.573-.502s-.374 1.538-1.81 3.019z","Prometheus","prometheus","Enables structured logging, metrics collection, and Prometheus export for observability of CTS MCP server operations and performance.","p30nzeltjg","namespace",{"_84":85,"_63":89},"owner",{"_86":87},"githubAccount",{"_88":89},"login","EricA1019","readmeMarkdown","redditPostExternalId","repository",{"_94":95,"_111":112,"_115":116,"_133":-5,"_134":135,"_136":-5,"_137":-5},"argumentsJsonSchema",{"_96":97,"_108":109,"_103":110},"properties",{"_98":99,"_105":106},"DEBUG",{"_100":101,"_31":102,"_103":104},"default","false","Enable verbose logging","type","string","SHRIMP_MCP_PATH",{"_31":107,"_103":104},"Custom path to Shrimp MCP server binary (e.g., /path/to/shrimp/build/index.js)","required",[],"object","githubProject",{"_35":36,"_113":114},"url","https://github.com/EricA1019/CTS_MCP","githubRepository",{"_117":118,"_119":120,"_121":122,"_16":123,"_124":125,"_37":126,"_84":127,"_129":130,"_131":-5,"_132":130},"defaultBranch","main","fullName","EricA1019/CTS_MCP","githubTreeId",2387839,33670,"language","HTML","CTS_MCP",{"_88":89,"_66":128},"u9t1ei4x1l","recentStargazers",0,"spdxLicense","stargazers","glamaJson","inspectable",false,"npmPackage","supportedPlatforms","scores",{"_140":130,"_141":-5,"_142":-5},"license","quality","security","simpleIcon","toolCount","91ia0rtgdo","updatedAt","2025-11-04T16:01:34.849491Z","meta",[150,153,155,162,165,167,170,173,176,179,182,184,187,190,192,194,196,198,200],{"_151":152},"title","CTS MCP Server | Glama",{"_154":32,"_37":31},"content",{"_156":157,"_158":159,"_160":161},"href","https://glama.ai/mcp/servers/@EricA1019/CTS_MCP","rel","canonical","tagName","link",{"_154":34,"_163":164},"property","og:title",{"_154":32,"_163":166},"og:description",{"_154":168,"_163":169},"https://glama.ai/logo.png","og:logo",{"_154":171,"_163":172},"https://glama.ai/mcp/servers/@EricA1019/CTS_MCP/og-image","og:image",{"_154":174,"_163":175},"630","og:image:height",{"_154":177,"_163":178},"1200","og:image:width",{"_154":180,"_163":181},"website","og:type",{"_154":157,"_163":183},"og:url",{"_154":185,"_163":186},"Glama – MCP Hosting Platform","og:site_name",{"_154":188,"_37":189},"summary_large_image","twitter:card",{"_154":185,"_37":191},"twitter:title",{"_154":32,"_37":193},"twitter:description",{"_154":171,"_37":195},"twitter:image",{"_154":174,"_37":197},"twitter:image:height",{"_154":177,"_37":199},"twitter:image:width",{"_201":202},"script:ld+json",{"_203":204,"_205":206},"@context","http://schema.org","@graph",[207],{"_203":208,"_209":210,"_211":212},"https://schema.org","@type","BreadcrumbList","itemListElement",[213,220,224,228],{"_209":214,"_215":216,"_37":217,"_218":219},"ListItem","item","/","Glama","position",1,{"_209":214,"_215":221,"_37":222,"_218":223},"/mcp","MCP",2,{"_209":214,"_215":225,"_37":226,"_218":227},"/mcp/servers","Servers",3,{"_209":214,"_215":229,"_37":34,"_218":230},"/mcp/servers/@EricA1019/CTS_MCP",4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_234":235,"_29":241,"_263":264,"_148":278,"_275":302,"_303":304},"blob",{"_154":236,"_237":238,"_239":240},"# expect\n\nThis package exports the `expect` function used in [Jest](https://jestjs.io/). You can find its documentation [on Jest's website](https://jestjs.io/docs/expect).\n","fileName","README.md","size",172,{"_42":43,"_13":242,"_52":32,"_53":32,"_33":34,"_16":54,"_55":243,"_82":250,"_90":-5,"_91":-5,"_92":253,"_138":262,"_143":-5,"_63":126,"_144":130,"_66":145,"_146":147},[45,46,47,48,49,50,51],[244,246,248],{"_58":245,"_31":65,"_66":67},{"_60":61,"_37":62,"_63":64},{"_58":247,"_31":73,"_66":74},{"_60":70,"_37":71,"_63":72},{"_58":249,"_31":80,"_66":81},{"_60":77,"_37":78,"_63":79},{"_84":251,"_63":89},{"_86":252},{"_88":89},{"_94":254,"_111":259,"_115":260,"_133":-5,"_134":135,"_136":-5,"_137":-5},{"_96":255,"_108":258,"_103":110},{"_98":256,"_105":257},{"_100":101,"_31":102,"_103":104},{"_31":107,"_103":104},[],{"_35":36,"_113":114},{"_117":118,"_119":120,"_121":122,"_16":123,"_124":125,"_37":126,"_84":261,"_129":130,"_131":-5,"_132":130},{"_88":89,"_66":128},{"_140":130,"_141":-5,"_142":-5},"member",{"_265":266,"_269":270,"_271":272,"_121":273,"_274":135,"_275":238,"_276":277,"_239":240,"_103":234},"commit",{"_267":268},"sha","b37d096d447a309e00c9b183cbd6ba6cea4e5bdb","contentStoredObjectPointerId",18202732,"fullPath","node_modules/expect/README.md",2365782,"indexable","path","safeToDisplayAsText",true,[279,281,283,285,287,288,289,291,292,293,294,295,296,297,298,299,300,301],{"_151":280},"README.md | CTS MCP Server | Glama",{"_154":282,"_37":31},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_156":284,"_158":159,"_160":161},"https://glama.ai/mcp/servers/@EricA1019/CTS_MCP/blob/b37d096d447a309e00c9b183cbd6ba6cea4e5bdb/node_modules/expect",{"_154":286,"_163":164},"README.md | CTS MCP Server",{"_154":282,"_163":166},{"_154":168,"_163":169},{"_154":290,"_163":172},"https://glama.ai/generated-images/og?title=README.md+%7C+CTS+MCP+Server",{"_154":174,"_163":175},{"_154":177,"_163":178},{"_154":180,"_163":181},{"_154":284,"_163":183},{"_154":185,"_163":186},{"_154":188,"_37":189},{"_154":185,"_37":191},{"_154":282,"_37":193},{"_154":290,"_37":195},{"_154":174,"_37":197},{"_154":177,"_37":199},"node_modules/expect","treeMembers",[305,310,314,318],{"_265":306,"_271":307,"_275":308,"_103":309},{"_267":268},"node_modules/expect/build","build","tree",{"_265":311,"_271":312,"_275":313,"_103":234},{"_267":268},"node_modules/expect/LICENSE","LICENSE",{"_265":315,"_271":316,"_275":317,"_103":234},{"_267":268},"node_modules/expect/package.json","package.json",{"_265":319,"_271":272,"_275":238,"_103":234},{"_267":268},"actionData","errors"]

MCP directory API