@nbiish/cognitive-tools-mcp 8.6.1 → 8.6.3

package/README.md

@@ -24,7 +24,30 @@
 
 ## ᐴ GASHKITOONAN ᔔ [CAPABILITIES] ◈──◆──◇──◆──◈
 
-Revolutionary **Enhanced Cognitive Processing MCP Server** - Automatically processes all 6 cognitive stages internally (Scientific Investigation, OOReD Analysis, Critical Thinking, Scientific Review, OOReD Review, Final Action) and returns comprehensive results. Integrates advanced prompting strategies for optimal cognitive enhancement.
+# ᐊᓂᔑᓈᐯ Cyberpunk Cognitive Deliberation MCP Server
+
+> **Interactive Multi-Phase Cognitive Processing MCP Server** - Forces LLMs through 3-input deliberation phases for comprehensive 6-stage cognitive enhancement. Prevents partial analysis and ensures thorough cognitive processing.
+
+## 🧠 Revolutionary Interactive Cognitive Framework
+
+This MCP server implements an **interactive session-based deliberation process** that forces LLMs through multiple required inputs to ensure comprehensive cognitive analysis. Unlike traditional single-call tools, this system **prevents partial analysis** by requiring LLMs to engage in iterative deliberation.
+
+### 🎯 Interactive Session Flow
+
+**CRITICAL:** This tool follows a mandatory 3-input deliberation process:
+
+1. **Initial Input** → Stages 1-2 processing → Request second input
+2. **Second Input** → Stages 3-6 processing → Request third input  
+3. **Third Input** → Final formatting → Return comprehensive result
+
+### 🚀 Key Features
+
+- **Forces Iterative Thinking:** Prevents LLMs from stopping after partial deliberation
+- **Session-Based Processing:** Maintains context across multiple inputs
+- **Comprehensive 6-Stage Framework:** Scientific Investigation + OOReD Analysis + Critical Thinking + Reviews + Final Action
+- **Tool Usage Tracking:** Returns actionable tool recommendations with usage counts
+- **Low-Context Model Friendly:** Optimal for models requiring guided interaction
+- **Advanced Prompting Integration:** CoT, ToT, Self-Consistency, Meta-Prompting, Role-Based strategies
 
 ### ⚡ INTERNAL 6-STAGE PROCESSING
 

package/build/index.js

@@ -25,8 +25,8 @@ import { z } from "zod";
 // --- Server Definition ---
 const serverInfo = {
     name: "gikendaasowin-aabajichiganan-mcp",
-    version: "8.6.0",
-    description: "Enhanced Cognitive Processing MCP Server - Automatically processes all 6 cognitive stages internally (Scientific Investigation, OOReD Analysis, Critical Thinking, Scientific Review, OOReD Review, Final Action) and returns comprehensive results. Integrates advanced prompting strategies for optimal cognitive enhancement."
+    version: "8.6.2",
+    description: "Interactive Multi-Phase Cognitive Processing MCP Server - Forces LLMs through 3-input deliberation phases for comprehensive 6-stage cognitive enhancement. Prevents partial analysis and ensures thorough cognitive processing."
 };
 const server = new McpServer(serverInfo);
 // --- Logging Helpers (Internal - No changes needed as per user comments) ---
@@ -1236,122 +1236,258 @@ function assessLogicalCoherence(stage1Result, stage3Result) {
 function assessMethodologicalRigor(stage1Result) {
     return "High rigor - systematic approach with appropriate controls";
 }
-// --- Enhanced 6-Stage Cognitive Framework Documentation (2025) ---
+// In-memory session storage (replace with persistent storage in production)
+const activeSessions = new Map();
+// Clean up old sessions (older than 1 hour)
+setInterval(() => {
+    const oneHourAgo = Date.now() - (60 * 60 * 1000);
+    for (const [sessionId, session] of activeSessions.entries()) {
+        if (session.createdAt < oneHourAgo) {
+            activeSessions.delete(sessionId);
+        }
+    }
+}, 10 * 60 * 1000); // Check every 10 minutes
+function generateSessionId() {
+    return `session_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+}
+// --- Interactive Session Handlers ---
+async function handlePhase1(session, userInput) {
+    // Process Stages 1-2 (Scientific Investigation + Initial OOReD)
+    const stage1 = await performScientificInvestigation(userInput, session.mode, session.context);
+    const stage2 = await performInitialOOReD(userInput, session.mode, session.context, stage1);
+    const stage1_2_results = `## STAGE 1: SCIENTIFIC INVESTIGATION
+${stage1}
+
+## STAGE 2: INITIAL OBSERVE-ORIENT-REASON-DECIDE
+${stage2}`;
+    session.stage1_2_results = stage1_2_results;
+    session.phase = "awaiting_input_2";
+    session.toolUsageCount += countToolsInStage(stage1) + countToolsInStage(stage2);
+    activeSessions.set(session.sessionId, session);
+    const promptForNextInput = `# 🧠 COGNITIVE ENHANCEMENT: Phase 1 Complete (Stages 1-2)
+
+${stage1_2_results}
+
+---
+
+**⚠️ CONTINUE DELIBERATION REQUIRED ⚠️**
+
+The cognitive framework requires your **SECOND INPUT** to complete stages 3-6. Please call this deliberation tool again with:
+
+- **Your refined perspective** based on the analysis above
+- **Additional context** you want to incorporate
+- **Specific focus areas** for deeper investigation
+
+**Required parameters for continuation:**
+\`\`\`json
+{
+  "input": "[Your second input based on the analysis above]",
+  "session_id": "${session.sessionId}"
+}
+\`\`\`
+
+**Progress:** 2 of 6 stages complete | **Continuing session:** \`${session.sessionId}\``;
+    logToolResult('deliberate', true, `Phase 1 complete, awaiting second input for session ${session.sessionId}`);
+    return {
+        content: [{
+                type: "text",
+                text: promptForNextInput
+            }]
+    };
+}
+async function handlePhase2(session, userInput) {
+    if (!session.stage1_2_results) {
+        throw new Error("Invalid session state: missing stage 1-2 results");
+    }
+    // Process Stages 3-6 using both original input and new refined input
+    const combinedInput = `${session.originalInput}\n\n[REFINED INPUT FROM PHASE 1]\n${userInput}`;
+    const combinedContext = session.context ? `${session.context}\n\n[CONTEXT FROM STAGES 1-2]\n${session.stage1_2_results}` : session.stage1_2_results;
+    const stage3 = await performCriticalThinkingPreAct(combinedInput, session.mode, combinedContext, "", "");
+    const stage4 = await performScientificReview(combinedInput, session.mode, combinedContext, "", stage3);
+    const stage5 = await performOOReViewReview(combinedInput, session.mode, combinedContext, "", stage4);
+    const stage6 = await performFinalAct(combinedInput, session.mode, combinedContext, stage3, stage5);
+    const stage3_6_results = `## STAGE 3: CRITICAL THINKING & PRE-ACTION PLANNING
+${stage3}
+
+## STAGE 4: SCIENTIFIC REVIEW & VALIDATION
+${stage4}
+
+## STAGE 5: OOReD REVIEW & REFINEMENT  
+${stage5}
+
+## STAGE 6: FACT-BASED ACTION & FINAL RECOMMENDATIONS
+${stage6}`;
+    session.stage3_6_results = stage3_6_results;
+    session.phase = "awaiting_input_3";
+    session.toolUsageCount += countToolsInStage(stage3) + countToolsInStage(stage4) + countToolsInStage(stage5) + countToolsInStage(stage6);
+    activeSessions.set(session.sessionId, session);
+    const promptForFinalInput = `# 🧠 COGNITIVE ENHANCEMENT: Phase 2 Complete (Stages 3-6)
+
+${stage3_6_results}
+
+---
+
+**⚠️ FINAL CONFIRMATION REQUIRED ⚠️**
+
+The 6-stage cognitive deliberation is complete. Please provide a **FINAL INPUT** to:
+
+- **Confirm** the recommendations are suitable
+- **Refine** any specific aspects
+- **Add** final considerations
+- **Proceed** with implementation planning
+
+**Required parameters for final output:**
+\`\`\`json
+{
+  "input": "[Your final confirmation/refinement]", 
+  "session_id": "${session.sessionId}"
+}
+\`\`\`
+
+**Progress:** 6 of 6 stages complete | **Final step:** \`${session.sessionId}\``;
+    logToolResult('deliberate', true, `Phase 2 complete, awaiting final input for session ${session.sessionId}`);
+    return {
+        content: [{
+                type: "text",
+                text: promptForFinalInput
+            }]
+    };
+}
+async function handlePhase3(session, userInput) {
+    if (!session.stage1_2_results || !session.stage3_6_results) {
+        throw new Error("Invalid session state: missing previous stage results");
+    }
+    // Final output with complete deliberation results
+    const finalOutput = `# 🎯 ENHANCED COGNITIVE DELIBERATION - COMPLETE ANALYSIS
+
+## COMPREHENSIVE 6-STAGE COGNITIVE FRAMEWORK RESULTS
+
+${session.stage1_2_results}
+
+${session.stage3_6_results}
+
+---
+
+## 🔧 IMPLEMENTATION ROADMAP
+
+Based on the comprehensive analysis, proceed with these **prioritized actions**:
+
+### Phase 1: Immediate Actions
+- **File Operations**: Use \`create_file\`, \`replace_string_in_file\`, \`read_file\` for implementation
+- **Research**: Leverage \`mcp_tavily-remote_tavily_search\`, \`vscode_websearchforcopilot_webSearch\` for validation
+- **Code Analysis**: Apply \`semantic_search\`, \`grep_search\`, \`list_code_usages\` for optimization
+
+### Phase 2: Development Execution  
+- **Terminal Operations**: Execute with \`run_in_terminal\`, \`create_and_run_task\`
+- **Quality Assurance**: Validate using \`get_errors\`, \`test_search\`
+- **Documentation**: Update with \`edit_notebook_file\`, \`create_directory\`
+
+### Phase 3: Validation & Refinement
+- **Testing**: Comprehensive testing protocols
+- **Review**: Peer review and expert consultation  
+- **Optimization**: Performance and efficiency improvements
+
+---
+
+**Final Confirmation:** ${userInput}
+
+\`\`\`tool use before re-deliberation: ${session.toolUsageCount}\`\`\`
+
+*Enhanced 6-Stage Cognitive Framework Complete | Processing Mode: ${session.mode} | Session: ${session.sessionId}*
+*Prompting Strategies Applied: CoT, ToT, Self-Consistency, Meta-Prompting, Role-Based*`;
+    // Mark session as complete and schedule cleanup
+    session.phase = "complete";
+    activeSessions.set(session.sessionId, session);
+    // Clean up completed session after 5 minutes
+    setTimeout(() => {
+        activeSessions.delete(session.sessionId);
+    }, 5 * 60 * 1000);
+    logToolResult('deliberate', true, `Complete deliberation session ${session.sessionId} with ${session.toolUsageCount} tool recommendations`);
+    return {
+        content: [{
+                type: "text",
+                text: finalOutput
+            }]
+    };
+}
+// --- MCP Tool Registration ---
 /**
- * 🚀 ENHANCED 6-STAGE COGNITIVE DELIBERATION FRAMEWORK - 2025 EDITION
+ * CRITICAL: Interactive Multi-Input Cognitive Deliberation Tool
  *
- * This implementation represents the evolution of cognitive processing, integrating:
- * - Scientific Investigation methodology for systematic hypothesis formation
- * - OOReD (Observe-Orient-Reason-Decide) framework for strategic analysis
- * - Critical Thinking 10-step framework for comprehensive evaluation
- * - Advanced prompting strategies distributed optimally across all stages
+ * This tool FORCES LLMs through a 3-input deliberation process:
+ * 1. Initial input → Stages 1-2 processing → Request second input
+ * 2. Second input → Stages 3-6 processing → Request third input
+ * 3. Third input → Final formatting → Return comprehensive result
  *
- * 📚 INTEGRATED PROMPTING STRATEGIES:
- *
- * **STAGE 1 - Scientific Investigation:** Chain-of-Thought + Role-Based Prompting
- *    - Systematic hypothesis formation using scientific method
- *    - Expert domain perspective integration
- *    - Step-by-step reasoning for complex problem decomposition
- *
- * **STAGE 2 - Initial OOReD:** Tree-of-Thoughts + Meta-Prompting
- *    - Multiple parallel reasoning paths exploration
- *    - Self-reflection on reasoning quality and consistency
- *    - Alternative solution pathway evaluation
- *
- * **STAGE 3 - Critical Thinking + Pre-Act:** Self-Consistency + Meta-Prompting
- *    - 10-step critical thinking framework application
- *    - Multiple validation approaches for reliability
- *    - Pre-action planning with tool identification
- *
- * **STAGE 4 - SCIENTIFIC REVIEW:** Chain-of-Thought + Self-Consistency
- *    - Systematic review of initial investigation findings
- *    - Cross-validation using multiple approaches
- *    - Enhanced evidence quality assessment
- *
- * **STAGE 5 - OOReD REVIEW:** Tree-of-Thoughts + Role-Based Prompting
- *    - Multi-path refinement of reasoning processes
- *    - Expert domain perspectives integration
- *    - Cross-stage consistency optimization
- *
- * **STAGE 6 - Final Action:** All Strategies Integrated
- *    - Comprehensive synthesis of all previous stages
- *    - Fact-based actionable recommendations
- *    - Complete quality assurance and validation
- *
- * 🎯 COGNITIVE ENHANCEMENT BENEFITS:
- *
- * **Enhanced Reliability:**
- *    - 6-stage validation process reduces errors by 45-60%
- *    - Cross-stage consistency checking improves reliability
- *    - Multiple prompting strategy integration enhances robustness
- *
- * **Improved Depth:**
- *    - Scientific methodology ensures systematic investigation
- *    - Critical thinking framework provides comprehensive analysis
- *    - Expert perspectives add domain-specific insights
- *
- * **Better Actionability:**
- *    - Pre-action planning identifies required tools and resources
- *    - Fact-based final recommendations with implementation roadmaps
- *    - Risk mitigation and contingency planning integrated
- *
- * 📊 PERFORMANCE METRICS:
- *    - Analysis Depth: 95% comprehensive coverage
- *    - Reasoning Consistency: 92% cross-stage alignment
- *    - Implementation Feasibility: 88% actionable recommendations
- *    - Quality Assurance: 94% validation success rate
- */
-/**
- * Tool: deliberate (Enhanced 6-Stage Cognitive Processing Engine - AUTOMATIC INTERNAL PROCESSING)
- *
- * AUTOMATIC INTERNAL PROCESSING:
- * - Internally processes all 6 stages automatically in a single call
- * - Stage 1: Scientific Investigation (Chain-of-Thought + Role-Based Prompting)
- * - Stage 2: Initial OOReD Analysis (Tree-of-Thoughts + Meta-Prompting)
- * - Stage 3: Critical Thinking & Pre-Action Planning (Self-Consistency + Meta-Prompting)
- * - Stage 4: Scientific Review & Validation (Chain-of-Thought + Self-Consistency)
- * - Stage 5: OOReD Review & Refinement (Tree-of-Thoughts + Role-Based)
- * - Stage 6: Final Action & Recommendations (All strategies integrated)
- * - Returns comprehensive final result with all cognitive enhancement completed
+ * REQUIRED FLOW:
+ * - Phase 1: LLM provides problem → Tool processes stages 1-2 → Asks for second input
+ * - Phase 2: LLM provides refinement → Tool processes stages 3-6 → Asks for final input
+ * - Phase 3: LLM provides confirmation → Tool returns final formatted output + tool count
  *
  * Benefits:
- * - 45-60% error reduction through multi-stage validation
- * - Enhanced reasoning quality through progressive complexity
- * - Optimal prompting strategy selection via parallel evaluation
- * - Comprehensive perspective integration with domain expertise
- * - Cross-stage validation with consistency checking
- * - Comprehensive action planning with risk mitigation
- * - Single call convenience - no manual phase management required
+ * - Forces iterative thinking for robust cognitive analysis
+ * - Prevents LLMs from stopping after partial deliberation
+ * - Ensures comprehensive 6-stage processing completion
+ * - Optimal for low-context models requiring guided interaction
+ * - Returns actionable tool recommendations with usage count
  */
 server.tool("deliberate", {
     input: z
         .string()
-        .describe("REQUIRED: The problem, question, decision, or situation requiring cognitive deliberation. Each unique input starts a new 6-stage progression session."),
+        .describe("Your problem, question, or situation for cognitive enhancement. This tool will guide you through MULTIPLE required inputs for thorough analysis."),
     mode: z
         .enum(["analyze", "decide", "synthesize", "evaluate"])
         .default("analyze")
-        .describe("Cognitive processing mode: 'analyze' for breakdown, 'decide' for decision making, 'synthesize' for integration, 'evaluate' for assessment"),
+        .describe("Cognitive processing mode for the deliberation session"),
     context: z
         .string()
         .optional()
-        .describe("Optional additional context, constraints, or background information")
-}, async ({ input, mode, context }) => {
+        .describe("Optional additional context, constraints, or background information"),
+    session_id: z
+        .string()
+        .optional()
+        .describe("Session ID for continuing multi-phase deliberation (provided by tool in previous responses)")
+}, async ({ input, mode, context, session_id }) => {
     const toolName = 'deliberate';
-    logToolCall(toolName, `Mode: ${mode}, Context: ${context ? 'Yes' : 'No'}`);
-    try {
-        // Process all 6 stages internally and automatically
-        const result = await performCognitiveDeliberation(input, mode, context);
-        logToolResult(toolName, true, `All 6 stages processed successfully`);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: result
-                }
-            ]
+    // Handle session continuation or start new session
+    let session;
+    if (session_id && activeSessions.has(session_id)) {
+        // Continue existing session
+        session = activeSessions.get(session_id);
+        logToolCall(toolName, `Continuing session ${session_id}, Phase: ${session.phase}`);
+    }
+    else {
+        // Start new session
+        const sessionId = generateSessionId();
+        session = {
+            sessionId,
+            originalInput: input,
+            mode,
+            context,
+            phase: "awaiting_input_1",
+            toolUsageCount: 0,
+            createdAt: Date.now()
         };
+        activeSessions.set(sessionId, session);
+        logToolCall(toolName, `New session ${sessionId}, Mode: ${mode}`);
+    }
+    try {
+        switch (session.phase) {
+            case "awaiting_input_1":
+                return await handlePhase1(session, input);
+            case "awaiting_input_2":
+                return await handlePhase2(session, input);
+            case "awaiting_input_3":
+                return await handlePhase3(session, input);
+            default:
+                throw new Error(`Invalid session phase: ${session.phase}`);
+        }
     }
     catch (error) {
+        // Clean up session on error
+        if (session_id) {
+            activeSessions.delete(session_id);
+        }
         return logToolError(toolName, error);
     }
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nbiish/cognitive-tools-mcp",
-  "version": "8.6.1",
-  "description": "Enhanced Cognitive Processing MCP Server - Automatically processes all 6 cognitive stages internally (Scientific Investigation, OOReD Analysis, Critical Thinking, Scientific Review, OOReD Review, Final Action) and returns comprehensive results. Integrates advanced prompting strategies for optimal cognitive enhancement.",
+  "version": "8.6.3",
+  "description": "Interactive Multi-Phase Cognitive Processing MCP Server - Forces LLMs through 3-input deliberation phases for comprehensive 6-stage cognitive enhancement. Prevents partial analysis and ensures thorough cognitive processing.",
   "private": false,
   "type": "module",
   "bin": {