@nbiish/cognitive-tools-mcp 8.5.1 → 8.6.3

package/README.md

@@ -24,21 +24,48 @@
 
 ## ᐴ GASHKITOONAN ᔔ [CAPABILITIES] ◈──◆──◇──◆──◈
 
-Revolutionary **TWO-PHASE Mandatory Cognitive Progression Framework** - Enhanced MCP server requiring sequential processing through two phases for complete cognitive enhancement. Phase 1 processes stages 1-2, Phase 2 processes stages 3-6. Each phase builds upon previous results with progressive complexity, ensuring comprehensive analysis through Scientific Investigation, OOReD methodology, Critical Thinking, and parallel strategy evaluation optimized for iterative LLM cognitive improvement.
+# ᐊᓂᔑᓈᐯ Cyberpunk Cognitive Deliberation MCP Server
 
-### ⚡ MANDATORY TWO-PHASE PROGRESSION
+> **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.
 
-**BREAKING CHANGE v8.5.0**: Two phases are now **MANDATORY** and must be completed sequentially:
+## 🧠 Revolutionary Interactive Cognitive Framework
 
-**Phase 1: Foundation (Stages 1-2)**
-1. **Stage 1**: Scientific Investigation (Entry Point)
-2. **Stage 2**: Initial OOReD Analysis
+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.
 
-**Phase 2: Synthesis (Stages 3-6)**  
-3. **Stage 3**: Critical Thinking & Pre-Action Planning
-4. **Stage 4**: Scientific Review & Validation
-5. **Stage 5**: OOReD Review & Refinement
-6. **Stage 6**: Final Action & Recommendations
+### 🎯 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
+
+**NEW v8.6.0**: The MCP server now automatically processes all stages internally in a single tool call:
+
+**All Stages Processed Internally:**
+1. **Stage 1**: Scientific Investigation (Chain-of-Thought + Role-Based)
+2. **Stage 2**: Initial OOReD Analysis (Tree-of-Thoughts + Meta-Prompting)
+3. **Stage 3**: Critical Thinking & Pre-Action Planning (Self-Consistency + Meta-Prompting)
+4. **Stage 4**: Scientific Review & Validation (Chain-of-Thought + Self-Consistency)
+5. **Stage 5**: OOReD Review & Refinement (Tree-of-Thoughts + Role-Based)
+6. **Stage 6**: Final Action & Recommendations (All strategies integrated)
+
+**Benefits:**
+- ✅ Single tool call processes all stages
+- ✅ Comprehensive cognitive analysis
+- ✅ Advanced prompting strategies integrated
+- ✅ No manual phase progression required
 
 <div align="center">
 ◈──◆──◇───────────────────────────◇──◆──◈
@@ -226,7 +253,7 @@ This project is licensed under the Comprehensive Restricted Use License for Indi
 ```bibtex
 @misc{gikendaasowin-aabajichiganan-mcp2025,
   author/creator/steward = {ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (Nbiish Waabanimikii-Kinawaabakizi), also known legally as JUSTIN PAUL KENWABIKISE, professionally documented as Nbiish-Justin Paul Kenwabikise, Anishinaabek Dodem (Anishinaabe Clan): Animikii (Thunder), descendant of Chief ᑭᓇᐙᐸᑭᓯ (Kinwaabakizi) of the Beaver Island Band and enrolled member of the sovereign Grand Traverse Band of Ottawa and Chippewa Indians},
-  title/description = {Revolutionary TWO-PHASE Mandatory Cognitive Progression Framework for Enhanced MCP Server Implementation},
+  title/description = {Enhanced Cognitive Processing MCP Server - Automatically processes all 6 cognitive stages internally with advanced prompting strategies},
   type_of_work = {Indigenous digital creation/software incorporating traditional knowledge and cultural expressions},
   year = {2025},
   publisher/source/event = {GitHub repository under tribal sovereignty protections},

package/build/index.js

@@ -25,45 +25,10 @@ import { z } from "zod";
 // --- Server Definition ---
 const serverInfo = {
     name: "gikendaasowin-aabajichiganan-mcp",
-    version: "8.5.0",
-    description: "MANDATORY TWO-PHASE Cognitive Progression Framework - Enhanced MCP server ENFORCING sequential processing through two phases. Phase 1 processes stages 1-2, Phase 2 processes stages 3-6. Automatic phase progression prevents skipping and ensures complete cognitive enhancement through Scientific Investigation, OOReD methodology, Critical Thinking, and parallel strategy evaluation. Each input requires full two-phase completion for optimal LLM cognitive improvement."
+    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);
-const activeSessions = new Map();
-// Generate session ID based on input hash
-function generateSessionId(input) {
-    return Buffer.from(input).toString('base64').slice(0, 12);
-}
-// Validate and enforce mandatory two-phase progression
-function validateMandatoryProgression(input, phase, previous_results) {
-    const sessionId = generateSessionId(input);
-    const phaseNum = parseInt(phase.replace('phase', ''));
-    if (phaseNum === 1) {
-        // Starting new session - always allowed
-        const session = {
-            sessionId,
-            currentPhase: 1,
-            originalInput: input,
-            phaseResults: [],
-            toolUsageCount: 0,
-            startTime: Date.now()
-        };
-        activeSessions.set(sessionId, session);
-        return { sessionId, isValid: true, currentPhase: 1 };
-    }
-    const existingSession = activeSessions.get(sessionId);
-    if (!existingSession) {
-        throw new Error(`MANDATORY PROGRESSION VIOLATION: Phase ${phase} attempted without starting from Phase 1. You must begin with phase1 for this input to receive full cognitive enhancement.`);
-    }
-    const expectedPhase = existingSession.currentPhase + 1;
-    if (phaseNum !== expectedPhase) {
-        throw new Error(`MANDATORY PROGRESSION VIOLATION: Expected phase${expectedPhase}, but received ${phase}. Sequential progression required: phase1 → phase2`);
-    }
-    if (!previous_results) {
-        throw new Error(`Phase ${phase} requires previous_results parameter containing all accumulated results from phase 1.`);
-    }
-    return { sessionId, isValid: true, currentPhase: phaseNum };
-}
 // --- Logging Helpers (Internal - No changes needed as per user comments) ---
 /**
  * Logs an incoming tool call to stderr.
@@ -1271,236 +1236,258 @@ function assessLogicalCoherence(stage1Result, stage3Result) {
 function assessMethodologicalRigor(stage1Result) {
     return "High rigor - systematic approach with appropriate controls";
 }
-// --- Enhanced 6-Stage Cognitive Framework Documentation (2025) ---
-/**
- * 🚀 ENHANCED 6-STAGE COGNITIVE DELIBERATION FRAMEWORK - 2025 EDITION
- *
- * 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
- *
- * 📚 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
- */
+// 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 ---
 /**
- * Tool: deliberate (Enhanced 6-Stage Cognitive Processing Engine - TWO-PHASE IMPLEMENTATION)
+ * CRITICAL: Interactive Multi-Input Cognitive Deliberation Tool
  *
- * MANDATORY TWO-PHASE PROGRESSION ENFORCEMENT:
- * - Phase 1: Processes stages 1-2 (Scientific Investigation + Initial OOReD)
- * - Phase 2: Processes stages 3-6 (Critical Thinking + Reviews + Final Action)
- * - Each phase requires separate input call from the LLM
- * - Final output includes tool usage count for re-deliberation guidance
+ * 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
  *
- * Revolutionary cognitive enhancement through:
- * - Phase 1: Stages 1-2 (Question→Hypothesis→Experiment→Analysis→Conclusion + Observe→Orient→Reason→Decide)
- * - Phase 2: Stages 3-6 (Critical Thinking + Scientific Review + OOReD Review + Final Action)
+ * 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
+ * - 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 2-phase 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"),
-    previous_results: z
+    session_id: z
         .string()
         .optional()
-        .describe("REQUIRED for Phase 2: Complete accumulated results from Phase 1. Include ONLY when continuing to Phase 2."),
-    phase: z
-        .enum(["phase1", "phase2"])
-        .default("phase1")
-        .describe("MANDATORY: Specify 'phase1' for stages 1-2 or 'phase2' for stages 3-6. Phase 1 must complete before Phase 2.")
-}, async ({ input, mode, context, previous_results, phase }) => {
+        .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, `Phase: ${phase}, Mode: ${mode}, Previous Results: ${previous_results ? 'Yes' : 'No'}`);
+    // 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 {
-        const sessionId = generateSessionId(input);
-        let session = activeSessions.get(sessionId);
-        let currentPhase;
-        let contextualInput = input;
-        let accumulatedResults = previous_results || "";
-        let phaseResult;
-        let toolUsageCount = 0;
-        if (!session || !previous_results) {
-            // Start a new session at Phase 1
-            if (phase !== "phase1") {
-                throw new Error(`MANDATORY PROGRESSION VIOLATION: Cannot start with ${phase}. You must begin with phase1 for this input to receive full cognitive enhancement.`);
-            }
-            currentPhase = 1;
-            session = {
-                sessionId,
-                currentPhase: 1,
-                originalInput: input,
-                phaseResults: [],
-                toolUsageCount: 0,
-                startTime: Date.now()
-            };
-            activeSessions.set(sessionId, session);
-            logToolCall(toolName, `New session started: ${sessionId}, Phase: 1`);
-            // Process Phase 1: Stages 1-2
-            const stage1Result = await performScientificInvestigation(input, mode, context);
-            const stage2Result = await performInitialOOReD(input, mode, context, stage1Result);
-            toolUsageCount = countToolsInStage(stage1Result) + countToolsInStage(stage2Result);
-            phaseResult = `# PHASE 1 COMPLETE: STAGES 1-2 PROCESSED
-
-## STAGE 1: SCIENTIFIC INVESTIGATION
-${stage1Result}
-
-## STAGE 2: INITIAL OBSERVE-ORIENT-REASON-DECIDE
-${stage2Result}
-
-**PHASE 1 SUMMARY:**
-- Scientific investigation completed with hypothesis formation
-- Initial OOReD analysis completed with strategic planning
-- Tool usage in Phase 1: ${toolUsageCount}
-
-**⚠️  MANDATORY NEXT STEP:**
-Continue to **Phase 2** for complete cognitive enhancement (Stages 3-6).
-
-**Required Phase 2 Call:**
-\`\`\`json
-{
-  "name": "deliberate",
-  "arguments": {
-    "input": "${input}",
-    "mode": "${mode}",
-    "phase": "phase2",
-    "previous_results": "[Copy this entire Phase 1 result as previous_results]"
-  }
-}
-\`\`\``;
+        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}`);
         }
-        else {
-            // Continue to Phase 2
-            if (phase !== "phase2") {
-                throw new Error(`MANDATORY PROGRESSION VIOLATION: Expected phase2, but received ${phase}. Phase 1 must complete before Phase 2.`);
-            }
-            session = activeSessions.get(sessionId);
-            if (!session) {
-                throw new Error(`SESSION NOT FOUND: No active session for this input. Start with phase1 first.`);
-            }
-            currentPhase = 2;
-            accumulatedResults = previous_results;
-            contextualInput = `${input}\n\n[COGNITIVE PROGRESSION CONTEXT - Phase 1 Results]\n${accumulatedResults}`;
-            logToolCall(toolName, `Continuing session: ${sessionId}, Processing Phase: 2`);
-            // Process Phase 2: Stages 3-6
-            const stage3Result = await performCriticalThinkingPreAct(contextualInput, mode, context, accumulatedResults, accumulatedResults);
-            const stage4Result = await performScientificReview(contextualInput, mode, context, accumulatedResults, stage3Result);
-            const stage5Result = await performOOReViewReview(contextualInput, mode, context, accumulatedResults, stage4Result);
-            const stage6Result = await performFinalAct(contextualInput, mode, context, stage3Result, stage5Result);
-            const phase2ToolUsage = countToolsInStage(stage3Result) + countToolsInStage(stage4Result) +
-                countToolsInStage(stage5Result) + countToolsInStage(stage6Result);
-            toolUsageCount = session.toolUsageCount + phase2ToolUsage;
-            phaseResult = `# PHASE 2 COMPLETE: STAGES 3-6 PROCESSED
-
-## STAGE 3: CRITICAL THINKING & PRE-ACTION PLANNING
-${stage3Result}
-
-## STAGE 4: SCIENTIFIC REVIEW & VALIDATION
-${stage4Result}
-
-## STAGE 5: OOReD REVIEW & REFINEMENT
-${stage5Result}
-
-## STAGE 6: FACT-BASED ACTION & FINAL RECOMMENDATIONS
-${stage6Result}
-
-**PHASE 2 SUMMARY:**
-- Critical thinking analysis completed with 10-step framework
-- Scientific review and validation completed
-- OOReD review and refinement completed
-- Final action planning with comprehensive recommendations
-- Tool usage in Phase 2: ${phase2ToolUsage}
-
-**🎯 COGNITIVE ENHANCEMENT COMPLETE**
-All 6 stages processed through mandatory two-phase progression.
-
-**FINAL SYNTHESIS:**
-${extractKeyInsights(stage3Result, stage5Result)}
-
-**RECOMMENDED NEXT STEPS:**
-${extractActionableRecommendations(stage3Result, stage5Result, mode)}
-
-\`\`\`tool use before re-deliberation: ${toolUsageCount}\`\`\``;
-        }
-        // Update session state
-        if (session) {
-            session.currentPhase = currentPhase;
-            session.phaseResults.push(phaseResult);
-            session.toolUsageCount = toolUsageCount;
-            activeSessions.set(sessionId, session);
-        }
-        logToolResult(toolName, true, `Phase ${currentPhase} completed`);
-        return { content: [{ type: "text", text: phaseResult }] };
     }
     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.5.1",
-  "description": "MANDATORY TWO-PHASE Cognitive Progression Framework - ENFORCES sequential processing through two phases. Phase 1 processes stages 1-2, Phase 2 processes stages 3-6. Automatic phase progression prevents skipping and ensures complete cognitive enhancement through Scientific Investigation, OOReD methodology, Critical Thinking with 10 expertly integrated prompting strategies.",
+  "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": {