deepthinking-mcp 3.0.0 → 3.0.2

package/README.md

@@ -1,10 +1,10 @@
-# DeepThinking MCP v2.5
+# DeepThinking MCP v3.0.2
 
-A comprehensive Model Context Protocol (MCP) server featuring **13 advanced reasoning modes** with intelligent mode recommendation and visual export capabilities for complex problem-solving, analysis, and decision-making.
+A comprehensive Model Context Protocol (MCP) server featuring **13 advanced reasoning modes** with intelligent mode recommendation, visual export capabilities, high-performance validation caching, comprehensive testing, and automated CI/CD for complex problem-solving, analysis, and decision-making.
 
 ## Overview
 
-DeepThinking MCP v2.5 provides a complete toolkit for structured reasoning with 13 specialized modes, an intelligent recommendation system, and powerful visual export capabilities:
+DeepThinking MCP v3.0 provides a complete toolkit for structured reasoning with 13 specialized modes, an intelligent recommendation system, powerful visual export capabilities, and optimized performance through validation caching:
 
 ### Core Modes
 - **Sequential**: Iterative refinement with revision capabilities
@@ -73,6 +73,23 @@ n#### Phase 3 Reasoning Modes (v2.3+)
 - **Problem Characteristics Analysis**: Analyzes domain, complexity, uncertainty, time-dependence, and more
 - **Ranked Recommendations**: Returns modes sorted by suitability score with detailed reasoning
 
+### Performance & Optimization (v3.0)
+- **Validation Caching**: LRU cache with content-based hashing for validation results
+  - **1.4-17x speedup** for repeated validations (typically 4-5x in realistic workloads)
+  - **O(1) lookup complexity** regardless of cache size
+  - **95%+ hit rates** in typical usage patterns
+  - Configurable cache size (default: 1000 entries)
+  - Automatic cache statistics tracking in session metrics
+- **Modular Validator Architecture**: Clean separation of concerns with mode-specific validators
+- **Session Metrics**: Comprehensive performance tracking including cache statistics
+
+### Configuration Options
+```javascript
+// Environment variables for performance tuning
+MCP_ENABLE_VALIDATION_CACHE=true     // Enable/disable caching (default: true)
+MCP_VALIDATION_CACHE_SIZE=1000        // Max cache entries (default: 1000)
+```
+
 ## Installation
 
 ```bash
@@ -618,6 +635,87 @@ npm test
 npm run typecheck
 ```
 
+### Testing & CI/CD
+
+#### Comprehensive Test Suite (v3.0.2)
+
+DeepThinking MCP includes **397 tests** across **24 test files** with **100% pass rate**:
+
+- **Unit Tests**: Core functionality, validators, session management
+- **Integration Tests (94 tests)**: MCP protocol compliance, multi-session scenarios, error handling
+- **Benchmark Tests**: Performance validation (15x speedup with caching)
+- **Mode-Specific Tests**: All 13 reasoning modes thoroughly tested
+
+**Test Coverage:**
+```bash
+# Run full test suite
+npm test
+
+# Run with coverage report
+npm run test:coverage
+
+# Run specific test file
+npm test -- tests/integration/mcp-protocol.test.ts
+```
+
+**Test Results:**
+- Test Files: 24 passed
+- Tests: 397 passed
+- Duration: ~7-8 seconds
+- Pass Rate: 100%
+
+#### CI/CD Pipeline
+
+Automated workflows using GitHub Actions ensure code quality and reliability:
+
+**Test Workflow** (`.github/workflows/test.yml`):
+- Multi-OS testing: Ubuntu, Windows, macOS
+- Multi-Node version: 18.x, 20.x, 22.x
+- Runs: TypeScript checks, linter, formatter, full test suite
+- Test result artifacts with 30-day retention
+
+**Coverage Workflow** (`.github/workflows/coverage.yml`):
+- Generates detailed coverage reports
+- Codecov integration for coverage tracking
+- PR comments with coverage summary
+- Coverage badge generation
+- Threshold warnings (<60% triggers warning)
+
+**Release Workflow** (`.github/workflows/release.yml`):
+- Automated releases on version tags (v*.*.*)
+- Pre-release testing (type check + full test suite)
+- GitHub release creation with changelog
+- npm publishing (requires NPM_TOKEN)
+- Workflow dispatch for manual releases
+
+**Branch Protection:**
+See `.github/BRANCH_PROTECTION.md` for recommended settings:
+- Required status checks before merging
+- PR review requirements
+- Linear history enforcement
+- Force push protection
+
+#### Integration Tests
+
+**MCP Protocol Compliance** (43 tests):
+- Tool schema validation for all 13 modes
+- Required/optional field validation
+- MCP response format compliance
+- Error handling for invalid inputs
+
+**Multi-Session Scenarios** (18 tests):
+- Session isolation and concurrent operations
+- Resource management (50+ sessions)
+- State consistency verification
+- Concurrent error handling
+
+**Error Handling & Edge Cases** (36 tests):
+- Invalid session operations
+- Boundary conditions (0, 1, MAX_SAFE_INTEGER)
+- Large data handling (100 thoughts, 50 dependencies)
+- Unicode and special character support
+- Mode-specific edge cases
+
 ## Architecture
 
 ```
@@ -650,21 +748,38 @@ deepthinking-mcp/
 - ✅ Comprehensive test suite (77 tests)
 - ✅ Enhanced type safety
 
-### Phase 3 (In Progress)
+### Phase 3 (Completed - v3.0.2)
 - ✅ Temporal reasoning mode (v2.1)
 - ✅ Game theory mode (v2.2)
 - ✅ Evidential reasoning mode (v2.3)
 - ✅ Mode recommendation system (v2.4)
 - ✅ Visual exports - Mermaid, DOT, ASCII (v2.5)
 - ✅ Export to LaTeX/Jupyter/HTML (v2.5)
+- ✅ Performance optimization with validation caching (v3.0)
+- ✅ Integration tests & MCP compliance (v3.0.2)
+- ✅ CI/CD pipeline with GitHub Actions (v3.0.2)
+
+### Phase 4 (Planned)
 - [ ] Math-MCP integration
 - [ ] Persistence layer
 - [ ] Collaborative thinking sessions
 - [ ] Pattern learning from successful reasoning chains
+- [ ] Advanced visualization dashboard
+- [ ] Real-time reasoning collaboration
 
 ## Contributing
 
-Contributions welcome! Please read our contributing guidelines and submit PRs.
+Contributions welcome! Please ensure:
+
+1. **All tests pass**: Run `npm test` before submitting PRs
+2. **Type checking passes**: Run `npm run typecheck`
+3. **Code formatting**: Run `npm run format:check` or `npm run format`
+4. **Linting passes**: Run `npm run lint`
+5. **CI/CD workflows pass**: All GitHub Actions checks must pass
+6. **Test coverage**: Maintain or improve test coverage
+7. **Documentation**: Update README.md and CHANGELOG.md for new features
+
+See `.github/BRANCH_PROTECTION.md` for branch protection requirements and `.github/workflows/` for CI/CD pipeline details.
 
 ## License
 

package/dist/index.js

@@ -847,19 +847,15 @@ Choose the mode that best fits your problem type, or use recommend_mode to get i
   }
 };
 
-// src/types/modes/temporal.ts
+// src/types/core.ts
 function isTemporalThought(thought) {
-  return thought.mode === "temporal";
+  return thought.mode === "temporal" /* TEMPORAL */;
 }
-
-// src/types/modes/gametheory.ts
 function isGameTheoryThought(thought) {
-  return thought.mode === "gametheory";
+  return thought.mode === "gametheory" /* GAMETHEORY */;
 }
-
-// src/types/modes/evidential.ts
 function isEvidentialThought(thought) {
-  return thought.mode === "evidential";
+  return thought.mode === "evidential" /* EVIDENTIAL */;
 }
 
 // src/types/modes/recommendations.ts
@@ -1113,15 +1109,9 @@ var DeepThinkingError = class extends Error {
     };
   }
 };
-var SessionError = class extends DeepThinkingError {
-  constructor(message, context) {
-    super(message, "SESSION_ERROR", context);
-  }
-};
-var SessionNotFoundError = class extends SessionError {
+var SessionNotFoundError = class extends DeepThinkingError {
   constructor(sessionId) {
-    super(`Session not found: ${sessionId}`, { sessionId });
-    this.code = "SESSION_NOT_FOUND";
+    super(`Session not found: ${sessionId}`, "SESSION_NOT_FOUND", { sessionId });
   }
 };
 
@@ -1613,7 +1603,7 @@ var SessionManager = class {
     let session = this.activeSessions.get(sessionId);
     if (!session && this.storage) {
       try {
-        session = await this.storage.loadSession(sessionId);
+        session = await this.storage.loadSession(sessionId) ?? void 0;
         if (session) {
           this.activeSessions.set(sessionId, session);
           this.logger.debug("Session loaded from storage", { sessionId });
@@ -1911,7 +1901,7 @@ var SessionManager = class {
   updateMetrics(session, thought) {
     const metrics = session.metrics;
     metrics.totalThoughts = session.thoughts.length;
-    const thoughtType = thought.type || "unknown";
+    const thoughtType = thought.mode || "unknown";
     metrics.thoughtsByType[thoughtType] = (metrics.thoughtsByType[thoughtType] || 0) + 1;
     if (thought.isRevision) {
       metrics.revisionCount++;
@@ -1921,9 +1911,11 @@ var SessionManager = class {
       const uncertaintyValue = thought.uncertainty;
       const currentSum = metrics._uncertaintySum || 0;
       const currentCount = metrics._uncertaintyCount || 0;
-      metrics._uncertaintySum = currentSum + uncertaintyValue;
-      metrics._uncertaintyCount = currentCount + 1;
-      metrics.averageUncertainty = metrics._uncertaintySum / metrics._uncertaintyCount;
+      const newSum = currentSum + uncertaintyValue;
+      const newCount = currentCount + 1;
+      metrics._uncertaintySum = newSum;
+      metrics._uncertaintyCount = newCount;
+      metrics.averageUncertainty = newSum / newCount;
     }
     if ("dependencies" in thought && thought.dependencies) {
       const deps = thought.dependencies;
@@ -2269,7 +2261,7 @@ var VisualExporter = class {
     return ascii;
   }
   // ===== Game Theory Exporters =====
-  gameTreeToMermaid(thought, colorScheme, includeLabels, includeMetrics) {
+  gameTreeToMermaid(thought, _colorScheme, includeLabels, includeMetrics) {
     let mermaid = "graph TD\n";
     if (!thought.game) {
       return mermaid + "  root[No game defined]\n";
@@ -2277,8 +2269,8 @@ var VisualExporter = class {
     if (thought.gameTree && thought.gameTree.nodes) {
       for (const node of thought.gameTree.nodes) {
         const nodeId = this.sanitizeId(node.id);
-        const label = includeLabels ? node.name : nodeId;
-        const shape = node.isTerminal ? ["[[", "]]"] : ["[", "]"];
+        const label = includeLabels ? node.action || node.id : nodeId;
+        const shape = node.type === "terminal" ? ["[[", "]]"] : ["[", "]"];
         mermaid += `  ${nodeId}${shape[0]}${label}${shape[1]}
 `;
       }
@@ -2322,8 +2314,8 @@ var VisualExporter = class {
     if (thought.gameTree && thought.gameTree.nodes) {
       for (const node of thought.gameTree.nodes) {
         const nodeId = this.sanitizeId(node.id);
-        const label = includeLabels ? node.name : nodeId;
-        const shape = node.isTerminal ? "doublecircle" : "circle";
+        const label = includeLabels ? node.action || node.id : nodeId;
+        const shape = node.type === "terminal" ? "doublecircle" : "circle";
         dot += `  ${nodeId} [label="${label}", shape=${shape}];
 `;
       }
@@ -2355,13 +2347,14 @@ var VisualExporter = class {
     if (thought.strategies && thought.strategies.length > 0) {
       ascii += "Strategies:\n";
       for (const strategy of thought.strategies) {
-        ascii += `  \u2022 ${strategy.name} (${strategy.type})
+        const strategyType = strategy.isPure ? "Pure" : "Mixed";
+        ascii += `  \u2022 ${strategy.name} (${strategyType})
 `;
       }
     }
-    if (thought.equilibria && thought.equilibria.length > 0) {
+    if (thought.nashEquilibria && thought.nashEquilibria.length > 0) {
       ascii += "\nEquilibria:\n";
-      for (const eq of thought.equilibria) {
+      for (const eq of thought.nashEquilibria) {
         ascii += `  \u2696 ${eq.type}: ${eq.strategyProfile.join(", ")}
 `;
         ascii += `    Payoffs: [${eq.payoffs.join(", ")}]
@@ -2371,7 +2364,7 @@ var VisualExporter = class {
     return ascii;
   }
   // ===== Bayesian Network Exporters =====
-  bayesianToMermaid(thought, colorScheme, includeLabels, includeMetrics) {
+  bayesianToMermaid(thought, colorScheme, _includeLabels, includeMetrics) {
     let mermaid = "graph LR\n";
     mermaid += `  H([Hypothesis])
 `;
@@ -2396,7 +2389,7 @@ var VisualExporter = class {
     }
     return mermaid;
   }
-  bayesianToDOT(thought, includeLabels, includeMetrics) {
+  bayesianToDOT(thought, _includeLabels, includeMetrics) {
     let dot = "digraph BayesianNetwork {\n";
     dot += "  rankdir=LR;\n";
     dot += "  node [shape=ellipse];\n\n";
@@ -2431,14 +2424,14 @@ var VisualExporter = class {
     if (thought.evidence && thought.evidence.length > 0) {
       ascii += "Evidence:\n";
       for (const ev of thought.evidence) {
-        ascii += `  \u2022 ${ev.observation}
+        ascii += `  \u2022 ${ev.description}
 `;
       }
       ascii += "\n";
     }
     ascii += `Posterior Probability: ${thought.posterior.probability.toFixed(3)}
 `;
-    ascii += `  Justification: ${thought.posterior.justification}
+    ascii += `  Calculation: ${thought.posterior.calculation}
 `;
     if (thought.bayesFactor !== void 0) {
       ascii += `