@nbiish/cognitive-tools-mcp 0.9.10 → 0.9.12

package/build/index.js

@@ -3,7 +3,7 @@
  * -----------------------------------------------------------------------------
  * Gikendaasowin Aabajichiganan - Core Cognitive Tools MCP Server
  *
- * Version: 0.9.8
+ * Version: 0.9.12
  *
  * Description: Provides a suite of cognitive tools for an AI Pair Programmer,
  *              enabling structured reasoning, planning, analysis, and iterative
@@ -36,12 +36,12 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
-export const version = "0.9.8";
+export const version = "0.9.12";
 // --- Server Definition ---
 const server = new McpServer({
     name: "gikendaasowin-aabajichiganan-mcp",
     version: version,
-    description: "ᑭᑫᓐᑖᓱᐎᓐ ᐋᐸᒋᒋᑲᓇᓐ - Core Cognitive Tools Suite v0.9.8: Enables structured, iterative reasoning (Chain of Thought/Draft), planning, and analysis for AI agents, focusing on the cognitive loop. MANDATORY `think` step integrates results."
+    description: "ᑭᑫᓐᑖᓱᐎᓐ ᐋᐸᒋᒋᑲᓇᓐ - Core Cognitive Tools Suite v0.9.12: Enables structured, iterative reasoning (Chain of Thought/Draft), planning, and analysis for AI agents, focusing on the cognitive loop. MANDATORY `think` step integrates results."
 });
 // --- Logging Helpers ---
 /**
@@ -78,7 +78,7 @@ function logToolError(toolName, error) {
     return {
         content: [{
                 type: "text",
-                text: `Error executing tool '${toolName}': ${errorMessage}. Please analyze this error in your next 'think' step and adjust your plan.`
+                text: `Error executing tool '${toolName}': ${errorMessage}.`
             }]
     };
 }
@@ -105,20 +105,13 @@ server.tool("assess_cuc_n_mode", "**Mandatory Pre-Deliberation Assessment.** Eva
         if (!cucnRegex.test(assessment_and_choice)) {
             throw new Error('Invalid assessment: String must include "CUC-N Ratings:".');
         }
-        /* // User request: Remove strict check for 'Recommended Initial Strategy:'
-        if (!strategyRegex.test(assessment_and_choice)) {
-            throw new Error('Invalid assessment: String must include "Recommended Initial Strategy:".');
-        }
-        */
         const modeMatch = assessment_and_choice.match(modeRegex);
         if (!modeMatch || !modeMatch[1]) {
             throw new Error('Invalid assessment: String must include explicit "Selected Mode: think" or "Selected Mode: quick_think".');
         }
         const selectedMode = modeMatch[1].toLowerCase();
-        logToolResult(toolName, true, `Selected mode: ${selectedMode} - Returning original assessment.`);
-        // Log the full assessment server-side for traceability
+        logToolResult(toolName, true, `Selected mode: ${selectedMode}`);
         console.error(`[${new Date().toISOString()}] [MCP Server] - ${toolName} Assessment Details:\n${assessment_and_choice}`);
-        // Return original input string without reminder
         return { content: [{ type: "text", text: assessment_and_choice }] };
     }
     catch (error) {
@@ -142,40 +135,27 @@ server.tool("think", "**MANDATORY Central Hub for Analysis and Planning.** Calle
         }
         // Define required sections (more flexible now)
         const requiredSections = [
-            ["## Analysis:", "## Observe:", "## Observation:"], // Accept various observation formats
-            ["## Orient:", "## Orientation:"], // Optional but recognized
-            ["## Plan:", "## Decide:", "## Decision:"], // Decision-related sections
-            ["## Reason:", "## Reasoning:", "## Analysis:"], // Reasoning-related sections
-            ["## Act:", "## Action:", "## Execution:"], // Action-related sections
+            ["## Analysis:", "## Observe:", "## Observation:"],
+            ["## Orient:", "## Orientation:"],
+            ["## Plan:", "## Decide:", "## Decision:"],
+            ["## Reason:", "## Reasoning:", "## Analysis:"],
+            ["## Act:", "## Action:", "## Execution:"],
             ["## Verification:"],
             ["## Risk & Contingency:", "## Risks:", "## Challenges:"],
             ["## Learning & Adaptation:", "## Self-Correction:", "## Learning:"]
         ];
-        // Check if each required section group has at least one match
         const missingSections = requiredSections.filter(sectionGroup => !sectionGroup.some(section => thought.includes(section)));
-        // Build validation report
         let validationReport = [];
         if (missingSections.length > 0) {
             validationReport.push("WARNING: Some recommended sections might be missing. Consider including observation, orientation, decision, reasoning, action, verification, risks, and learning components in your thought process.");
         }
-        // Log validation results
         if (validationReport.length > 0) {
             console.warn(`[${new Date().toISOString()}] [CognitiveToolsServer] Think Tool Validation Report:\n${validationReport.join("\n")}`);
         }
-        // Enhanced logging with simplified format detection
         const format = thought.includes("## Observe:") ? "OODReAct-style" : "Traditional";
         logToolResult(toolName, true, `Thought logged (Style: ${format}, Length: ${thought.length})`);
-        // Return thought with metadata
         return {
-            content: [{
-                    type: "text",
-                    text: thought
-                }],
-            metadata: {
-                format,
-                validationReport,
-                timestamp: new Date().toISOString()
-            }
+            content: [{ type: "text", text: thought }]
         };
     }
     catch (error) {
@@ -198,7 +178,6 @@ server.tool("quick_think", "Cognitive Checkpoint for streamlined processing and
             throw new Error('Invalid brief_thought: Must be a non-empty string.');
         }
         logToolResult(toolName, true, `Logged: ${brief_thought.substring(0, 80)}...`);
-        // Returns the brief thought, similar to 'think', for grounding.
         return { content: [{ type: "text", text: brief_thought }] };
     }
     catch (error) {
@@ -226,11 +205,9 @@ server.tool("gauge_confidence", "Meta-Cognitive Checkpoint. Guides *internal sta
             throw new Error('Invalid confidence assessment: String must include "Confidence Level: High/Medium/Low" and justification.');
         }
         const level = match[1];
-        const emphasis = (level.toLowerCase() !== 'high') ? "CRITICAL: Analyze implications of non-High confidence." : "Proceed with analysis.";
-        const resultText = `Confidence Gauge Completed. Stated Level: ${level}. Assessment Text Logged. MANDATORY: Analyze this confidence level and justification in your next 'think' step. ${emphasis}`;
         logToolResult(toolName, true, `Level: ${level}`);
         console.error(`[${new Date().toISOString()}] [MCP Server] - ${toolName} Confidence Details:\n${assessment_and_confidence}`);
-        return { content: [{ type: "text", text: resultText }] };
+        return { content: [{ type: "text", text: assessment_and_confidence }] };
     }
     catch (error) {
         return logToolError(toolName, error);
@@ -252,14 +229,12 @@ server.tool("chain_of_thought", "Guides *internal generation* of **detailed, ste
         if (!generated_cot_text || typeof generated_cot_text !== 'string' || !problem_statement || typeof problem_statement !== 'string') {
             throw new Error('Both generated_cot_text and problem_statement must be non-empty strings.');
         }
-        // Validate CoT format - should have clear steps
         if (!generated_cot_text.match(/step|phase|:\s|^\d+[\.\)]/im)) {
             throw new Error('Invalid CoT format: Must contain clear reasoning steps (numbered, labeled as steps/phases, or with clear delineation).');
         }
-        const resultText = `Chain of Thought Completed. Problem: "${problem_statement.substring(0, 100)}..."\nReasoning Steps Logged. MANDATORY: Analyze this reasoning chain in your next 'think' step to extract insights, identify potential flaws/gaps, and plan concrete next actions.`;
         logToolResult(toolName, true, `Problem: ${problem_statement.substring(0, 50)}...`);
         console.error(`[${new Date().toISOString()}] [MCP Server] - ${toolName} Details:\nProblem: ${problem_statement}\nReasoning:\n${generated_cot_text}`);
-        return { content: [{ type: "text", text: resultText }] };
+        return { content: [{ type: "text", text: generated_cot_text }] };
     }
     catch (error) {
         return logToolError(toolName, error);
@@ -281,18 +256,15 @@ server.tool("plan_and_solve", "Guides *internal generation* of a **structured pl
         if (!generated_plan_text || typeof generated_plan_text !== 'string' || !task_objective || typeof task_objective !== 'string') {
             throw new Error('Both generated_plan_text and task_objective must be non-empty strings.');
         }
-        // Validate plan format - should have clear sections and structure
         if (!generated_plan_text.match(/phase|step|goal|objective|:\s|^\d+[\.\)]/im)) {
             throw new Error('Invalid plan format: Must contain clear sections (phases, steps, goals) with proper structure.');
         }
-        // Validate plan includes risk consideration
         if (!generated_plan_text.toLowerCase().includes('risk') && !generated_plan_text.toLowerCase().includes('challenge')) {
             throw new Error('Invalid plan format: Must include risk/challenge assessment.');
         }
-        const resultText = `Plan Generation Completed. Task: "${task_objective.substring(0, 100)}..."\nPlan Structure Logged. MANDATORY: Analyze this plan in your next 'think' step to verify feasibility, refine if needed, and confirm the first concrete action step.`;
         logToolResult(toolName, true, `Task: ${task_objective.substring(0, 50)}...`);
         console.error(`[${new Date().toISOString()}] [MCP Server] - ${toolName} Details:\nTask: ${task_objective}\nPlan:\n${generated_plan_text}`);
-        return { content: [{ type: "text", text: resultText }] };
+        return { content: [{ type: "text", text: generated_plan_text }] };
     }
     catch (error) {
         return logToolError(toolName, error);
@@ -318,29 +290,8 @@ server.tool("chain_of_draft", "Signals that one or more **internal drafts** have
         if (!draft_description || typeof draft_description !== 'string' || draft_description.trim().length === 0) {
             throw new Error('Invalid draft_description: Must provide a description.');
         }
-        // Format response in markdown with CoD guidance and next tool recommendation
-        const resultText = `### Chain of Draft Signal Received
-#### Draft Description
-${draft_description}
-
-#### Chain of Draft (CoD) Reminders
-- Keep steps concise (< 5 words)
-- Use equations/symbols when possible
-- Focus on essential information
-- End drafts with #### + conclusion
-
-#### Next Steps
-1. MANDATORY: Use \`think\` tool to analyze this draft:
-   - Evaluate correctness and completeness
-   - Check alignment with goals
-   - Plan concrete next actions
-2. Consider using \`reflection\` tool if deeper critique needed
-3. Use \`synthesize_prior_reasoning\` if context consolidation helpful
-
-#### Status
-Draft(s) ready for analysis. Proceed with mandatory \`think\` step.`;
         logToolResult(toolName, true);
-        return { content: [{ type: "text", text: resultText }] };
+        return { content: [{ type: "text", text: draft_description }] };
     }
     catch (error) {
         return logToolError(toolName, error);
@@ -366,8 +317,7 @@ server.tool("reflection", "Guides *internal generation* of a critical self-evalu
         if (!input_subject_description || typeof input_subject_description !== 'string' || input_subject_description.trim().length === 0) {
             throw new Error('Invalid input_subject_description: Must describe what was critiqued.');
         }
-        logToolResult(toolName, true, `Returned critique for analysis (length: ${generated_critique_text.length})`);
-        // Returns the actual critique text received. The AI must analyze this in the next 'think' step.
+        logToolResult(toolName, true, `Critique length: ${generated_critique_text.length}`);
         return { content: [{ type: "text", text: generated_critique_text }] };
     }
     catch (error) {
@@ -393,8 +343,7 @@ server.tool("synthesize_prior_reasoning", "Context Management Tool. Guides *inte
         if (!context_to_summarize_description || typeof context_to_summarize_description !== 'string' || context_to_summarize_description.trim().length === 0) {
             throw new Error('Invalid context_to_summarize_description: Must describe what was summarized.');
         }
-        logToolResult(toolName, true, `Returned summary for analysis (length: ${generated_summary_text.length})`);
-        // Returns the actual summary text received. The AI must analyze/use this in the next 'think' step.
+        logToolResult(toolName, true, `Summary length: ${generated_summary_text.length}`);
         return { content: [{ type: "text", text: generated_summary_text }] };
     }
     catch (error) {
@@ -441,7 +390,7 @@ async function main() {
         await server.connect(transport);
         const border = '-----------------------------------------------------';
         console.error(border);
-        console.error(` ᑭᑫᓐᑖᓱᐎᓐ ᐋᐸᒋᒋᑲᓇᓐ - Core Cognitive Tools Suite v0.9.8: Enables structured, iterative reasoning (Chain of Thought/Draft), planning, and analysis for AI agents, focusing on the cognitive loop. MANDATORY \`think\` step integrates results.`);
+        console.error(` ᑭᑫᓐᑖᓱᐎᓐ ᐋᐸᒋᒋᑲᓇᓐ - Core Cognitive Tools Suite v0.9.12: Enables structured, iterative reasoning (Chain of Thought/Draft), planning, and analysis for AI agents, focusing on the cognitive loop. MANDATORY \`think\` step integrates results.`);
         console.error(` Version: ${version}`);
         console.error(' Status: Running on stdio, awaiting MCP requests...');
         console.error(border);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nbiish/cognitive-tools-mcp",
-  "version": "0.9.10",
+  "version": "0.9.12",
   "description": "Cognitive Tools MCP: SOTA reasoning suite focused on iterative refinement and tool integration for AI Pair Programming. Enables structured, iterative problem-solving through Chain of Draft methodology, with tools for draft generation, analysis, and refinement. Features advanced deliberation (`think`), rapid checks (`quick_think`), mandatory complexity assessment & thought mode selection (`assess_cuc_n_mode`), context synthesis, confidence gauging, proactive planning, explicit reasoning (CoT), and reflection with content return. Alternative package name for gikendaasowin-aabajichiganan-mcp.",
   "private": false,
   "type": "module",