@nbiish/cognitive-tools-mcp 8.4.1 → 8.5.1

package/README.md

@@ -11,7 +11,7 @@
       <p><a href="https://raw.githubusercontent.com/nbiish/license-for-all-works/8e9b73b269add9161dc04bbdd79f818c40fca14e/qr-stripe-donation.png">Donate via Stripe</a></p>
     </div>
     <div style="display: flex; align-items: center;">
-      <a href="https://www.buymeacoffee.com/nbiish"><img src="https://img.buymeacoffee.com/button-api/?text=Buy me a coffee&emoji=&slug=nbiish&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff" /></a>
+      <a href="https://www.buymeacoffee.com/nbiish"><img src="buymeacoffee-button.svg" alt="Buy me a coffee" /></a>
     </div>
   </div>
   
@@ -24,18 +24,21 @@
 
 ## ᐴ GASHKITOONAN ᔔ [CAPABILITIES] ◈──◆──◇──◆──◈
 
-Revolutionary **6-Stage Mandatory Cognitive Progression Framework** - Enhanced MCP server requiring sequential processing through all 6 stages for complete cognitive enhancement. Each stage 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.
+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.
 
-### ⚡ MANDATORY STAGE PROGRESSION
+### ⚡ MANDATORY TWO-PHASE PROGRESSION
 
-**BREAKING CHANGE v8.3.1**: Stages are now **MANDATORY** and must be completed sequentially:
+**BREAKING CHANGE v8.5.0**: Two phases are now **MANDATORY** and must be completed sequentially:
 
+**Phase 1: Foundation (Stages 1-2)**
 1. **Stage 1**: Scientific Investigation (Entry Point)
-2. **Stage 2**: Orientation & Strategic Planning  
-3. **Stage 3**: Recursive Enhancement & Strategy Development
-4. **Stage 4**: Evaluation & Decision Framework
-5. **Stage 5**: Deep Analysis & Implementation  
-6. **Stage 6**: Action Planning & Synthesis
+2. **Stage 2**: Initial OOReD Analysis
+
+**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
 
 <div align="center">
 ◈──◆──◇───────────────────────────◇──◆──◈
@@ -49,14 +52,31 @@ npm install -g @nbiish/gikendaasowin-aabajichiganan-mcp
 npm install -g @nbiish/cognitive-tools-mcp
 ```
 
-### Ollama Integration
+### Ollama + PydanticAI Integration (Recommended)
+
+The modern way to use this MCP server is through our **PydanticAI + Ollama integration**:
+
 ```bash
-# Add to your MCP client configuration
+# Install dependencies
+pip install -r requirements.txt
+
+# Run interactive cognitive enhancement
+python cognitive_demo.py --interactive
+
+# Process a single question
+python cognitive_demo.py "Your question here"
+
+# Use a different Ollama model
+python cognitive_demo.py --model llama3.2:3b "Your question"
+```
+
+### Claude Desktop / MCP Client Configuration
+```json
 {
   "mcpServers": {
     "gikendaasowin": {
-      "command": "gikendaasowin-aabajichiganan-mcp",
-      "args": []
+      "command": "npx",
+      "args": ["-y", "@nbiish/gikendaasowin-aabajichiganan-mcp@latest"]
     }
   }
 }
@@ -68,6 +88,29 @@ npm install -g @nbiish/cognitive-tools-mcp
 
 ## ᐴ AABAJITOOWIN ᔔ [USAGE] ◈──◆──◇──◆──◈
 
+### 🚀 Quick Start with PydanticAI + Ollama
+
+The easiest way to experience the 6-stage cognitive enhancement:
+
+```bash
+# Install Python dependencies
+pip install -r requirements.txt
+
+# Run interactive mode (recommended for exploration)
+python cognitive_demo.py --interactive
+
+# Process a single question
+python cognitive_demo.py "How can AI help solve climate change?"
+```
+
+This will automatically:
+1. Connect to the published MCP server (`@nbiish/gikendaasowin-aabajichiganan-mcp`)
+2. Use your local Ollama installation with `granite3.3:2b` (or specify `--model`)
+3. Process your input through all 6 mandatory cognitive stages
+4. Display beautifully formatted results with real-time progress
+
+### Manual MCP Integration (Advanced)
+
 ### Mandatory Sequential Processing
 
 **Stage 1 (Entry Point):**
@@ -117,7 +160,7 @@ npm install -g @nbiish/cognitive-tools-mcp
 
 ### Modern Prompting Integration
 
-This tool implements the **[OOReDAct cognitive cycle](latest.md)** for systematic reasoning and action, featuring:
+This tool implements the cognitive cycle described in our [latest.md](latest.md) for systematic reasoning and action, featuring:
 
 - **Context Engineering (2025 Best Practice)**: RAG-enhanced processing
 - **Parallel Strategy Evaluation**: 10 advanced prompting strategies
@@ -183,7 +226,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 6-Stage Mandatory Cognitive Progression Framework for Enhanced MCP Server Implementation},
+  title/description = {Revolutionary TWO-PHASE Mandatory Cognitive Progression Framework for Enhanced MCP Server Implementation},
   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

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
 /**
  * -----------------------------------------------------------------------------
- * Gikendaasowin Aabajichiganan - Enhanced 6-Stage Cognitive Deliberation MCP Server (v7.0.0)
+ * Gikendaasowin Aabajichiganan - Enhanced TWO-PHASE Cognitive Deliberation MCP Server (v8.0.0)
  *
  * Description: Revolutionary MCP server implementing the most advanced cognitive
- * processing engine available. Features a comprehensive 6-stage framework combining
+ * processing engine available. Features a comprehensive TWO-PHASE framework combining
  * Scientific Investigation, OOReD analysis, and Critical Thinking methodologies
  * with expertly distributed prompting strategies (CoT, ToT, Self-Consistency,
  * Meta-Prompting, Role-Based).
  *
- * v7.0.0 REVOLUTIONARY RELEASE - Enhanced 6-Stage Framework:
- * - Complete reimplementation with Scientific Investigation + OOReD + Critical Thinking
+ * v8.0.0 REVOLUTIONARY RELEASE - Enhanced Two-Phase Framework:
+ * - Complete reimplementation with TWO-PHASE processing (Phase 1: stages 1-2, Phase 2: stages 3-6)
  * - Strategic distribution of 5 advanced prompting strategies across 6 stages
  * - Enhanced reliability with 45-60% error reduction through multi-stage validation
  * - Comprehensive expert perspective integration with domain-specific analysis
@@ -25,8 +25,8 @@ import { z } from "zod";
 // --- Server Definition ---
 const serverInfo = {
     name: "gikendaasowin-aabajichiganan-mcp",
-    version: "8.4.0",
-    description: "MANDATORY 6-Stage Cognitive Progression Framework - Enhanced MCP server ENFORCING sequential processing through all 6 stages. Automatic stage progression prevents stage skipping and ensures complete cognitive enhancement through Scientific Investigation, OOReD methodology, Critical Thinking, and parallel strategy evaluation. Each input requires full 6-stage completion for optimal LLM cognitive improvement."
+    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."
 };
 const server = new McpServer(serverInfo);
 const activeSessions = new Map();
@@ -34,34 +34,35 @@ const activeSessions = new Map();
 function generateSessionId(input) {
     return Buffer.from(input).toString('base64').slice(0, 12);
 }
-// Validate and enforce mandatory progression
-function validateMandatoryProgression(input, stage, previous_results) {
+// Validate and enforce mandatory two-phase progression
+function validateMandatoryProgression(input, phase, previous_results) {
     const sessionId = generateSessionId(input);
-    const stageNum = parseInt(stage.replace('stage', ''));
-    if (stageNum === 1) {
+    const phaseNum = parseInt(phase.replace('phase', ''));
+    if (phaseNum === 1) {
         // Starting new session - always allowed
         const session = {
             sessionId,
-            currentStage: 1,
+            currentPhase: 1,
             originalInput: input,
-            stageResults: [],
+            phaseResults: [],
+            toolUsageCount: 0,
             startTime: Date.now()
         };
         activeSessions.set(sessionId, session);
-        return { sessionId, isValid: true, currentStage: 1 };
+        return { sessionId, isValid: true, currentPhase: 1 };
     }
     const existingSession = activeSessions.get(sessionId);
     if (!existingSession) {
-        throw new Error(`MANDATORY PROGRESSION VIOLATION: Stage ${stage} attempted without starting from Stage 1. You must begin with stage1 for this input to receive full cognitive enhancement.`);
+        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 expectedStage = existingSession.currentStage + 1;
-    if (stageNum !== expectedStage) {
-        throw new Error(`MANDATORY PROGRESSION VIOLATION: Expected stage${expectedStage}, but received ${stage}. Sequential progression required: stage1 → stage2 → stage3 → stage4 → stage5 → stage6`);
+    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(`Stage ${stage} requires previous_results parameter containing all accumulated results from stages 1-${stageNum - 1}.`);
+        throw new Error(`Phase ${phase} requires previous_results parameter containing all accumulated results from phase 1.`);
     }
-    return { sessionId, isValid: true, currentStage: stageNum };
+    return { sessionId, isValid: true, currentPhase: phaseNum };
 }
 // --- Logging Helpers (Internal - No changes needed as per user comments) ---
 /**
@@ -254,27 +255,30 @@ ${nextStepGuidance}
  * Tool usage counter for re-deliberation guidance
  * Counts potential external tool calls that might be recommended in each stage
  */
-function countToolsInStage(stageOutput) {
-    // Count mentions of common tool usage patterns
+/**
+ * Count tools used in a stage result (for re-deliberation guidance)
+ */
+function countToolsInStage(stageResult) {
+    // Count references to tools/websearch/file operations in the stage result
     const toolPatterns = [
-        /websearch/gi,
-        /file.*read/gi,
-        /file.*write/gi,
-        /code.*exec/gi,
-        /mcp.*server/gi,
-        /external.*tool/gi,
+        /websearch|web_search/gi,
+        /file.*tool|read_file|edit_file/gi,
+        /code.*tool|run_code|execute/gi,
+        /mcp.*server|external.*tool/gi,
         /api.*call/gi,
         /database.*query/gi,
         /search.*tool/gi,
         /knowledge.*base/gi
     ];
-    let count = 0;
+    let toolCount = 0;
     toolPatterns.forEach(pattern => {
-        const matches = stageOutput.match(pattern);
-        if (matches)
-            count += matches.length;
+        const matches = stageResult.match(pattern);
+        if (matches) {
+            toolCount += matches.length;
+        }
     });
-    return count;
+    // Base count on stage complexity (minimum 1 tool per stage)
+    return Math.max(1, toolCount);
 }
 /**
  * Evaluates all prompting strategies in parallel based on modern-prompting.mdc
@@ -1294,12 +1298,12 @@ function assessMethodologicalRigor(stage1Result) {
  *    - Multiple validation approaches for reliability
  *    - Pre-action planning with tool identification
  *
- * **STAGE 4 - Scientific Review:** Chain-of-Thought + Self-Consistency
+ * **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
+ * **STAGE 5 - OOReD REVIEW:** Tree-of-Thoughts + Role-Based Prompting
  *    - Multi-path refinement of reasoning processes
  *    - Expert domain perspectives integration
  *    - Cross-stage consistency optimization
@@ -1333,21 +1337,17 @@ function assessMethodologicalRigor(stage1Result) {
  *    - Quality Assurance: 94% validation success rate
  */
 /**
- * Tool: deliberate (Enhanced 6-Stage Cognitive Processing Engine)
+ * Tool: deliberate (Enhanced 6-Stage Cognitive Processing Engine - TWO-PHASE IMPLEMENTATION)
  *
- * MANDATORY PROGRESSION ENFORCEMENT:
- * - Stage 1: Always starts new session (Scientific Investigation)
- * - Stages 2-6: Require previous_results from all previous stages
- * - Sessions automatically track progression to prevent stage skipping
- * - Each input creates unique session requiring full 6-stage completion
+ * 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
  *
  * Revolutionary cognitive enhancement through:
- * - Stage 1: Scientific Investigation (Question→Hypothesis→Experiment→Analysis→Conclusion)
- * - Stage 2: OOReD Strategic Planning (Observe→Orient→Reason→Decide)
- * - Stage 3: Critical Thinking Pre-Act (10-step framework + prompting strategy selection)
- * - Stage 4: Scientific Review (Validation + refinement of findings)
- * - Stage 5: OOReD Deep Analysis (Implementation planning + risk assessment)
- * - Stage 6: Final Action Planning (Fact-based synthesis + tool recommendations)
+ * - 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)
  *
  * Benefits:
  * - 45-60% error reduction through multi-stage validation
@@ -1360,7 +1360,7 @@ function assessMethodologicalRigor(stage1Result) {
 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("REQUIRED: The problem, question, decision, or situation requiring cognitive deliberation. Each unique input starts a new 2-phase progression session."),
     mode: z
         .enum(["analyze", "decide", "synthesize", "evaluate"])
         .default("analyze")
@@ -1372,47 +1372,133 @@ server.tool("deliberate", {
     previous_results: z
         .string()
         .optional()
-        .describe("REQUIRED for continuing progression: Complete accumulated results from all previous stages. Include ONLY when continuing an existing session (stages 2-6).")
-}, async ({ input, mode, context, previous_results }) => {
+        .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 }) => {
     const toolName = 'deliberate';
-    // Determine current stage based on session state
-    let currentStage;
-    let sessionId;
-    if (!previous_results) {
-        // Starting new session with Stage 1
-        currentStage = 1;
-        sessionId = generateSessionId(input);
-        const session = {
-            sessionId,
-            currentStage: 1,
-            originalInput: input,
-            stageResults: [],
-            startTime: Date.now()
-        };
-        activeSessions.set(sessionId, session);
-    }
-    else {
-        // Continuing existing session
-        sessionId = generateSessionId(input);
-        const existingSession = activeSessions.get(sessionId);
-        if (!existingSession) {
-            throw new Error(`MANDATORY PROGRESSION VIOLATION: Cannot continue session for this input. You must start from Stage 1 first.`);
+    logToolCall(toolName, `Phase: ${phase}, Mode: ${mode}, Previous Results: ${previous_results ? 'Yes' : 'No'}`);
+    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]"
+  }
+}
+\`\`\``;
+        }
+        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}\`\`\``;
         }
-        currentStage = existingSession.currentStage + 1;
-        if (currentStage > 6) {
-            throw new Error(`PROGRESSION COMPLETE: All 6 stages already completed for this input. Session finished.`);
+        // Update session state
+        if (session) {
+            session.currentPhase = currentPhase;
+            session.phaseResults.push(phaseResult);
+            session.toolUsageCount = toolUsageCount;
+            activeSessions.set(sessionId, session);
         }
-        // Update session
-        existingSession.currentStage = currentStage;
-        existingSession.stageResults.push(previous_results);
-    }
-    const stageKey = `stage${currentStage}`;
-    logToolCall(toolName, `Auto-Stage: ${currentStage}, Previous: ${previous_results ? 'Yes' : 'No'}`);
-    try {
-        // Process the current stage with progressive cognitive enhancement
-        const stageResult = await processProgressiveStage(input, mode, context, stageKey, previous_results);
-        logToolResult(toolName, true, `Stage ${currentStage} completed - ${currentStage === 6 ? 'FULL COGNITIVE ENHANCEMENT COMPLETE' : 'Continue to next stage for full enhancement'}`);
-        return { content: [{ type: "text", text: stageResult }] };
+        logToolResult(toolName, true, `Phase ${currentPhase} completed`);
+        return { content: [{ type: "text", text: phaseResult }] };
     }
     catch (error) {
         return logToolError(toolName, error);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nbiish/cognitive-tools-mcp",
-  "version": "8.4.1",
-  "description": "MANDATORY 6-Stage Cognitive Progression Framework - ENFORCES sequential processing through all 6 stages. Automatic stage progression prevents stage skipping and ensures complete cognitive enhancement through Scientific Investigation, OOReD methodology, Critical Thinking with 10 expertly integrated prompting strategies.",
+  "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.",
   "private": false,
   "type": "module",
   "bin": {

package/README.md.backup

@@ -1,183 +0,0 @@
-# ◈──◆──◇ GIKENDAASOWIN AABAJICHIGANAN MCP SERVER / ENHANCED 6-STAGE COGNITIVE TOOLS v8.0.0 ◇──◆──◈
-
-<div align="center">
-  <hr width="50%">
-  
-  <h3>Support This Project</h3>
-  <div style="display: flex; justify-content: center; gap: 20px; margin: 20px 0;">
-    <div>
-      <h4>Stripe</h4>
-      <img src="qr-stripe-donation.png" alt="Scan to donate" width="180"/>
-      <p><a href="https://raw.githubusercontent.com/nbiish/license-for-all-works/8e9b73b269add9161dc04bbdd79f818c40fca14e/qr-stripe-donation.png">Donate via Stripe</a></p>
-    </div>
-    <div style="display: flex; align-items: center;">
-      <a href="https://www.buymeacoffee.com/nbiish"><img src="https://img.buymeacoffee.com/button-api/?text=Buy me a coffee&emoji=&slug=nbiish&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff" /></a>
-    </div>
-  </div>
-  
-  <hr width="50%">
-</div>
-
-<div align="center">
-◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
-</div>
-
-Revolutionary MCP server with Enhanced 6-Stage Cognitive Deliberation Framework & Parallel Strategy Evaluation System. The `deliberate` tool combines Scientific Investigation, OOReD analysis, and Critical Thinking methodologies with **10 expertly integrated prompting strategies** and intelligent **tool usage tracking** for optimal re-deliberation guidance. *(Integration guidelines in [`latest.md`](latest.md) are licensed under [LICENSE](LICENSE).)*
-
-Known as:
-- Anishinaabemowin: [`@nbiish/gikendaasowin-aabajichiganan-mcp`](https://www.npmjs.com/package/@nbiish/gikendaasowin-aabajichiganan-mcp)
-- English: [`@nbiish/cognitive-tools-mcp`](https://www.npmjs.com/package/@nbiish/cognitive-tools-mcp)
-
-Both packages are maintained in parallel and receive the same updates. You can use either package name in your projects - they provide identical functionality.
-
-**See the latest integration details in [`latest.md`](latest.md).**
-
-<div align="center">
-◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
-</div>
-
-## ᐴ GASHKITOONAN ᔔ [ENHANCED CAPABILITIES] ◈──◆──◇──◆──◈
-
-### 🚀 Revolutionary 6-Stage Cognitive Framework
-
-**Stage 1: Scientific Investigation** (Chain-of-Thought + Role-Based)
-- 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)
-- 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
-- **🚀 NEW: Tool usage tracking with re-deliberation count**
-
-### 🧠 Revolutionary Parallel Strategy Evaluation (v8.0.0)
-
-**During Orient Stage - Intelligent Strategy Selection:**
-
-- **10 Prompting Strategies Evaluated:** Cache-Augmented ReAct, Self-Consistency, PAL, Reflexion, ToT-lite, Progressive-Hint, CAG, Cognitive Scaffolding, IKS, KSP
-- **Dual Scoring System:** Solution Level (0.00-0.99) + Efficiency Level (0.00-0.99) 
-- **Automatic Strategy Ranking:** Based on combined scores for optimal strategy selection
-- **Dynamic Adaptation:** Intelligent strategy matching based on input complexity and requirements
-- **Re-deliberation Guidance:** Tracks tool usage and provides optimal return timing
-
-<div align="center">
-◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
-</div>
-
-## ᐴ APITENDAAGOZIJIG ᔔ [PERFORMANCE METRICS] ◈──◆──◇──◆──◈
-
-- **Enhanced Reliability:** 45-60% error reduction through 6-stage validation + parallel strategy selection
-- **Improved Depth:** 95% comprehensive coverage with scientific rigor + 10 integrated prompting strategies
-- **Better Actionability:** 88% actionable recommendations with implementation roadmaps + tool usage guidance
-- **Quality Assurance:** 94% validation success rate with cross-stage consistency
-- **🚀 NEW: Intelligent Strategy Selection:** 92% optimal strategy matching based on dual-scoring evaluation
-- **🚀 NEW: Re-deliberation Optimization:** 75% reduction in unnecessary tool usage through smart tracking
-
-<div align="center">
-◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
-</div>
-
-<div align="center">
-╭────────────[ ◈◆◇ DEVELOPMENT ◇◆◈ ]────────────╮
-</div>
-
-## ᐴ OZHITOON ᔔ [BUILDING] ◈──◆──◇──◆──◈
-
-```bash
-╭──────────────────────────────────────────────────────────────────────╮
-│  ᐴ BASH ᔔ [ SHELL COMMANDS ]                                         │
-╰──────────────────────────────────────────────────────────────────────╯
-# Install dependencies
-npm install
-
-# Build the package
-npm run build
-
-# Test locally with MCP Inspector
-npm run inspector
-
-# Publish both packages (maintainer only)
-npm run publish-both
-```
-
-<div align="center">
-◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
-</div>
-
-## ᐴ AABAJICHIGAN ᔔ [USAGE] ◈──◆──◇──◆──◈
-
-### Claude Desktop Integration
-
-Add to your `claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "gikendaasowin-aabajichiganan-mcp": {
-      "command": "npx",
-      "args": ["@nbiish/gikendaasowin-aabajichiganan-mcp"]
-    }
-  }
-}
-```
-
-### Available Tools
-
-**`deliberate`** - Enhanced 6-Stage Cognitive Processing Engine
-
-- **Modes:** analyze, decide, synthesize, evaluate
-- **Input:** Complex problems requiring comprehensive cognitive analysis
-- **Output:** Six-stage structured analysis with actionable recommendations
-
-<div align="center">
-╭────────────[ ◈◆◇ CITATION ◇◆◈ ]─────────────╮
-</div>
-
-## ᐴ MIŻIWEWIN ᔔ [CITATION/SHARING] ◈──◆──◇──◆──◈
-
-Please cite this project using the following BibTeX entry:
-
-```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 = {GIKENDAASOWIN AABAJICHIGANAN MCP SERVER / ENHANCED 6-STAGE COGNITIVE TOOLS MCP SERVER},
-  type_of_work = {Indigenous digital creation/software incorporating traditional knowledge and cultural expressions},
-  year = {2025},
-  publisher/source/event = {GitHub repository under tribal sovereignty protections},
-  howpublished = {\url{https://github.com/nbiish/gikendaasowin-aabajichiganan-mcp}},
-  note = {Authored and stewarded by ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (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. This work embodies Indigenous intellectual property, traditional knowledge systems (TK), traditional cultural expressions (TCEs), and associated data protected under tribal law, federal Indian law, treaty rights, Indigenous Data Sovereignty principles, and international indigenous rights frameworks including UNDRIP. All usage, benefit-sharing, and data governance are governed by the COMPREHENSIVE RESTRICTED USE LICENSE FOR INDIGENOUS CREATIONS WITH TRIBAL SOVEREIGNTY, DATA SOVEREIGNTY, AND WEALTH RECLAMATION PROTECTIONS.}
-}
-```
-
-<div align="center">
-◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
-</div>
-
-This project is licensed under the [COMPREHENSIVE RESTRICTED USE LICENSE FOR INDIGENOUS CREATIONS WITH TRIBAL SOVEREIGNTY, DATA SOVEREIGNTY, AND WEALTH RECLAMATION PROTECTIONS](LICENSE).
-
-<div align="center">
-◈──◆──◇─────────────────────────────────────────────────◇──◆──◈
-</div>
-
-Copyright © 2025 ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (Nbiish Waabanimikii-Kinawaabakizi), also known legally as JUSTIN PAUL KENWABIKISE, professionally documented as Nbiish-Justin Paul Kenwabikise, Anishinaabek Dodem (Anishinaabe Clan): Animikii (Thunder), a descendant of Chief ᑭᓇᐙᐸᑭᓯ (Kinwaabakizi) of the Beaver Island Band, and an enrolled member of the sovereign Grand Traverse Band of Ottawa and Chippewa Indians. This work embodies Traditional Knowledge and Traditional Cultural Expressions. All rights reserved.