@nbiish/cognitive-tools-mcp 0.6.2 → 0.7.1

package/README.md

@@ -1,6 +1,24 @@
 # @nbiish/gikendaasowin-aabajichiganan-mcp
 
-ᑭᑫᓐᑖᓱᐎᓐ ᐋᐸᒋᒋᑲᓇᓐ - Gikendaasowin Aabajichiganan - (Cognitive Tools v0.6.1): Provides a suite of advanced internal reasoning tools to guide an LLM agent in sophisticated problem-solving, emphasizing structured thought, planning, and self-correction.
+<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://donate.stripe.com/3cs29La1j8UGfnObII">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>
+
+ᑭᑫᓐᑖᓱᐎᓐ ᐋᐸᒋᒋᑲᓇᓐ - Gikendaasowin Aabajichiganan - (Cognitive Tools v0.7.1): SOTA internal reasoning suite aligned with AI Pair Programmer Prompt v0.7.1+. Features advanced deliberation (`think`), rapid checks (`quick_think`), mandatory complexity assessment & strategy selection, context synthesis, confidence gauging, proactive planning, explicit reasoning (CoT), and reflection, designed for robust agentic workflows.
 
 Known as:
 - Anishinaabemowin: [`@nbiish/gikendaasowin-aabajichiganan-mcp`](https://www.npmjs.com/package/@nbiish/gikendaasowin-aabajichiganan-mcp)
@@ -189,6 +207,7 @@ Example Response:
 
 ## Version History
 
+- **0.7.1**: Updated to align with AI Pair Programmer Prompt v0.7.1+, renamed `assess_cuc_n_mode` to `assess_complexity_and_select_thought_mode`, enhanced cognitive tools for more explicit handling of tool needs
 - **0.6.1**: Fixed tool naming issue for technical length limitation
 - **0.3.9**: Updated tool descriptions and fixed error handling to improve reliability
 - **0.3.6**: Updated repository URLs to point to gikendaasowin-aabajichiganan-mcp
@@ -205,14 +224,16 @@ This work is licensed under the [COMPREHENSIVE RESTRICTED USE LICENSE FOR INDIGE
 
 ## Citation
 
+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)},
-  title/description = {ᑭᑫᓐᑖᓱᐎᓐ ᐋᐸᒋᒋᑲᓇᓐ - Gikendaasowin Aabajichiganan - (Cognitive Tools)},
+  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},
+  title/description = {gikendaasowin-aabajichiganan-mcp (Cognitive Tools MCP) - Advanced internal reasoning suite for LLM agents},
   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), an 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.}
+  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 (whose community faced violent dispersal resulting in descendants affiliating with LTBB, GTBOCI, and First Nations in Canada, as detailed in the Preamble), an 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.}
 }
 ```

package/build/index.js

@@ -5,160 +5,175 @@ import { z } from "zod";
 // Create the MCP server
 const server = new McpServer({
     name: "gikendaasowin-aabajichiganan-mcp",
-    // Version reflects novel tools and enhanced guidance
-    version: "0.6.0",
-    description: "ᑭᑫᓐᑖᓱᐎᓐ ᐋᐸᒋᒋᑲᓇᓐ - Gikendaasowin Aabajichiganan - (Cognitive Tools v0.6.0): SOTA internal reasoning suite for LLM agents. Features advanced deliberation (`think`), rapid checks (`quick_think`), explicit complexity assessment, context synthesis (`synthesize`), confidence gauging, planning, CoT, and reflection. Designed to maximize reliability, traceability, and performance on complex cognitive tasks, pushing beyond current research."
+    // Version reflects refined tool integration guidance
+    version: "0.7.1",
+    description: "ᑭᑫᓐᑖᓱᐎᓐ ᐋᐸᒋᒋᑲᓇᓐ - Gikendaasowin Aabajichiganan - (Cognitive Tools v0.7.1): SOTA internal reasoning suite aligned with AI Pair Programmer Prompt v0.7.1+. Features advanced deliberation (`think`), rapid checks (`quick_think`), mandatory complexity assessment & strategy selection, context synthesis, confidence gauging, proactive planning, explicit reasoning (CoT), and reflection, designed for robust agentic workflows including potential executable actions and dynamic tool discovery."
 });
 // --- Core Cognitive Deliberation Tools ---
 server.tool("think", 
 // Main Description: For High Cognitive Load situations.
-"MANDATORY Cognitive Hub for **High Complexity/Uncertainty/Consequence/Novelty**. Use for deep analysis, planning, verification, risk assessment, self-correction, and integrating complex outputs (CoT, Plans, Critiques, Syntheses, Low Confidence Gauges). Logs detailed reasoning.", {
+"MANDATORY Cognitive Hub for **High/Medium Complexity, Uncertainty, Consequence, or Novelty (CUC-N)** situations. Use for deep analysis, planning, verification, risk assessment, self-correction, and integrating complex outputs (CoT, Plans, Critiques, Syntheses, Confidence Gauges). Logs detailed reasoning.", {
     // Parameter Description: Must analyze inputs including novel tool outputs.
-    thought: z.string().describe("Your **detailed** internal monologue for complex situations. MUST explicitly analyze prior steps/generated text (CoT, Plans, Critiques, Synthesized summaries, Confidence justifications). Structure: ## Analysis, ## Plan, ## Verification, ## Risk Assessment, ## Self-Correction. Ensure depth and clear linkage.")
+    thought: z.string().describe("Your **detailed** internal monologue for complex situations, triggered after CUC-N assessment indicates 'think' mode. MUST explicitly analyze prior steps & generated text (e.g., CoT text, Plan text including Anticipated Challenges, Reflection critique text, Synthesized summary text, Confidence justification text). Structure MANDATORY: ## Analysis, ## Plan, ## Verification, ## Anticipated Challenges Analysis & Contingency, ## Risk Assessment, ## Lookahead, ## Self-Correction & Learning.")
 }, async ({ thought }) => {
     if (!thought || typeof thought !== 'string' || thought.trim().length === 0) {
-        throw new Error('Invalid thought: Must be non-empty.');
+        throw new Error('Invalid thought: Must be non-empty, structured reasoning.');
     }
     console.error(`[CognitiveToolsServer] Think Tool Logged: ${thought.substring(0, 100)}...`);
-    return { content: [{ type: "text", text: `Deep Thought Logged: ${thought}` }] };
+    // Output confirms deep thought logged, ready for next assessment or action.
+    return { content: [{ type: "text", text: `Deep Thought (structured analysis/plan/etc.) logged successfully.` }] };
 });
 server.tool("quick_think", 
 // Main Description: For Low Cognitive Load situations. Explicitly contrasted with 'think'.
-"Cognitive Checkpoint for **Low Complexity/Uncertainty/Consequence**. Use ONLY for simple confirmations, acknowledgements, minor step decisions, or sanity checks where deep analysis is clearly unnecessary. Logs brief thought.", {
-    brief_thought: z.string().describe("Your **concise** thought for simple situations (e.g., 'Acknowledged.', 'Proceeding with planned step X.', 'API call successful, extracting data.'). DO NOT use for analyzing complex outputs or making significant plans.")
+"Cognitive Checkpoint ONLY for situations explicitly assessed as **strictly Low CUC-N AND simple task nature** (e.g., confirmation, acknowledgement). Logs brief thought. **DO NOT USE** for analysis, planning, or after other cognitive tools.", {
+    // Parameter Description: Simpler input for brief thoughts.
+    brief_thought: z.string().describe("Your **concise** thought for strictly simple, low CUC-N situations (e.g., 'Acknowledged user input.', 'Proceeding with confirmed step 3.', 'Code execution successful.').")
 }, async ({ brief_thought }) => {
     if (!brief_thought || typeof brief_thought !== 'string' || brief_thought.trim().length === 0) {
         throw new Error('Invalid brief_thought: Must be non-empty.');
     }
     console.error(`[CognitiveToolsServer] QuickThink Tool Logged: ${brief_thought.substring(0, 100)}...`);
-    return { content: [{ type: "text", text: `Quick Thought Logged: ${brief_thought}` }] };
+    // Output confirms brief thought logged.
+    return { content: [{ type: "text", text: `Quick Thought logged successfully.` }] };
 });
 // --- Novel Meta-Cognitive & Context Management Tools ---
-server.tool("assess_cuc_n_mode", 
+server.tool("assess_complexity_and_select_thought_mode", 
 // Main Description: Forces explicit decision between think/quick_think.
-"**Mandatory Pre-Thought Assessment.** Guides the LLM to explicitly evaluate the upcoming cognitive step's complexity, uncertainty, consequence, and novelty, and *commit* to using either `think` or `quick_think` next. Enhances deliberate cognitive resource allocation.", {
+"**Mandatory Pre-Cognitive Assessment.** Must be called BEFORE every `think` or `quick_think`. Guides the LLM to explicitly evaluate CUC-N, recommend an initial strategy, and commit to the next thought mode (`think` or `quick_think`).", {
     // Parameter Description: LLM provides its assessment and chosen mode.
-    assessment_and_choice: z.string().describe("Input your assessment: 1) Briefly describe the situation/next step. 2) Rate Complexity (Low/Med/High), Uncertainty (L/M/H), Consequence (L/M/H), Novelty (L/M/H). 3) State your choice: 'Selected Mode: think' or 'Selected Mode: quick_think'. *You* (LLM) make this assessment *before* calling.")
+    assessment_and_choice: z.string().describe("Input your assessment *before* calling. MUST include: 1) Situation/Next Step Description. 2) CUC-N Ratings: Complexity(L/M/H), Uncertainty(L/M/H), Consequence(L/M/H), Novelty(L/M/H). 3) Recommended Initial Strategy (e.g., 'Start `think` analysis', 'Use `plan_and_solve`'). 4) Explicit Mode Selection: 'Selected Mode: think' or 'Selected Mode: quick_think'.")
 }, async ({ assessment_and_choice }) => {
-    if (!assessment_and_choice || typeof assessment_and_choice !== 'string' || (!assessment_and_choice.includes("Selected Mode: think") && !assessment_and_choice.includes("Selected Mode: quick_think"))) {
-        throw new Error('Invalid assessment: Must include complexity/uncertainty/consequence/novelty ratings and explicit mode selection ("Selected Mode: think" or "Selected Mode: quick_think").');
+    // Enhanced validation to check for key phrases expected from the prompt's instructions
+    const requiredPhrases = ["Complexity", "Uncertainty", "Consequence", "Novelty", "Recommended Initial Strategy", "Selected Mode:"];
+    const hasRequiredPhrases = requiredPhrases.every(phrase => assessment_and_choice.includes(phrase));
+    const hasModeSelection = assessment_and_choice.includes("Selected Mode: think") || assessment_and_choice.includes("Selected Mode: quick_think");
+    if (!assessment_and_choice || typeof assessment_and_choice !== 'string' || !hasRequiredPhrases || !hasModeSelection) {
+        throw new Error('Invalid assessment: String must include CUC-N ratings, Recommended Initial Strategy, and explicit Selected Mode ("think" or "quick_think").');
     }
     console.error(`[CognitiveToolsServer] AssessComplexity Tool Signaled: ${assessment_and_choice.substring(0, 150)}...`);
-    // Output confirms the assessment was made and which mode was selected.
     const mode = assessment_and_choice.includes("Selected Mode: think") ? "think" : "quick_think";
-    return { content: [{ type: "text", text: `Complexity Assessment Completed. Selected Next Mode: ${mode}. Assessment: ${assessment_and_choice}` }] };
+    // Output confirms the assessment was made and guides the next step.
+    return { content: [{ type: "text", text: `Cognitive Assessment Completed. Proceeding with selected mode: ${mode}. Full Assessment: ${assessment_and_choice}` }] };
 });
 server.tool("synthesize_prior_reasoning", 
 // Main Description: Manages context window and focuses reasoning.
-"Context Management Tool. Guides the LLM to **generate a concise summary text** of preceding lengthy reasoning chains (multiple `think` logs, CoT outputs). Used to manage context limits and refocus attention before major subsequent `think` steps.", {
-    // Parameter Description: LLM generates the summary internally first.
-    context_to_summarize_description: z.string().describe("Briefly describe the span of reasoning you are summarizing (e.g., 'Summary of planning phase', 'Key takeaways from debugging CoT'). *You* (LLM) must now *internally generate the concise summary text* before calling this tool. This signals the summary is ready.")
+"Context Management Tool. Guides the LLM to **internally generate a structured summary text** of preceding lengthy reasoning, focusing on **`Key Decisions Made`** and **`Open Questions/Uncertainties`**. Used to manage context and refocus attention.", {
+    // Parameter Description: Reminds LLM of the required internal summary structure.
+    context_to_summarize_description: z.string().describe("Describe the reasoning span being summarized. *You* (LLM) must now *internally generate the structured summary text (including Key Decisions, Open Questions)* before calling. This signals the summary is ready for `think` analysis.")
 }, async ({ context_to_summarize_description }) => {
     if (!context_to_summarize_description || typeof context_to_summarize_description !== 'string' || context_to_summarize_description.trim().length === 0) {
         throw new Error('Invalid context description: Must be non-empty.');
     }
     console.error(`[CognitiveToolsServer] SynthesizeReasoning Tool Signaled for: ${context_to_summarize_description}...`);
-    // Output confirms context and implies summary text is available internally
-    return { content: [{ type: "text", text: `Synthesis internally generated for context: '${context_to_summarize_description}'. Ready for 'think' analysis.` }] };
+    // Output implies structured summary is ready for analysis.
+    return { content: [{ type: "text", text: `Structured synthesis internally generated for context: '${context_to_summarize_description}'. Ready for detailed analysis in next 'think' step.` }] };
 });
 server.tool("gauge_confidence", 
 // Main Description: Explicit meta-cognition about certainty.
-"Meta-Cognitive Checkpoint. Guides the LLM to explicitly **state its confidence level (High/Medium/Low) and justification** regarding a specific plan, analysis, conclusion, or proposed action *before* proceeding. Low confidence may trigger Reflection or deeper Thinking.", {
-    // Parameter Description: LLM provides its confidence assessment.
-    assessment_and_confidence: z.string().describe("Input the item being assessed (e.g., 'Confidence in current plan', 'Confidence in generated code correctness'). Then state: 1) Confidence Level (High/Medium/Low). 2) Brief Justification for this level. *You* (LLM) make this assessment *before* calling.")
+"Meta-Cognitive Checkpoint. Guides the LLM to explicitly **state confidence (High/Medium/Low) and justification** regarding a specific item (plan, conclusion, action). Output MUST be analyzed in next `think` step; Low/Medium confidence requires specific action.", {
+    // Parameter Description: Matches prompt requirements.
+    assessment_and_confidence: z.string().describe("Input the item being assessed (e.g., 'Confidence in proposed refactoring plan'). Then *internally determine and state*: 1) Confidence Level (High/Medium/Low). 2) Justification for this level. Call this tool *after* making the assessment.")
 }, async ({ assessment_and_confidence }) => {
     const confidenceRegex = /Confidence Level: (High|Medium|Low)/i;
     if (!assessment_and_confidence || typeof assessment_and_confidence !== 'string' || !confidenceRegex.test(assessment_and_confidence)) {
-        throw new Error('Invalid confidence assessment: Must include "Confidence Level: High/Medium/Low" and justification.');
+        throw new Error('Invalid confidence assessment: String must include "Confidence Level: High/Medium/Low" and justification.');
     }
     const match = assessment_and_confidence.match(confidenceRegex);
     const level = match ? match[1] : "Unknown";
     console.error(`[CognitiveToolsServer] GaugeConfidence Tool Signaled: Level ${level}`);
-    // Output confirms assessment and level
-    return { content: [{ type: "text", text: `Confidence Gauge Completed. Level: ${level}. Assessment: ${assessment_and_confidence}` }] };
+    // Output confirms level and prepares for analysis.
+    return { content: [{ type: "text", text: `Confidence Gauge Completed. Level: ${level}. Assessment Text: ${assessment_and_confidence}. Ready for mandatory 'think' analysis (action required if Low/Medium).` }] };
 });
-// --- Supporting Cognitive Strategy Tools (Enhanced Descriptions) ---
+// --- Supporting Cognitive Strategy Tools ---
 server.tool("plan_and_solve", 
-// Main Description: Highlights role in structuring complex tasks and managing agentic workflows.
-"Guides the LLM to **generate a structured, multi-step plan text** for a complex objective. Outlines necessary phases, potential sub-tasks, and anticipated tool usage, improving manageability of multi-step agentic workflows. The generated plan MUST be validated and detailed via `think`, and can optionally be passed to `reflection` for critique.", {
-    // Parameter Description: Instructs LLM on plan generation.
-    task_objective: z.string().describe("Input the high-level objective. *You* (the LLM) must now *internally generate the structured plan text* before calling this tool. This signals the plan text is ready for analysis/critique.")
-}, 
-// Implementation: Signals Planning was performed.
-async ({ task_objective }) => {
+// Main Description: Emphasizes plan text structure and potential for other tools.
+"Guides the LLM to **internally generate structured plan text**, including **`Anticipated Challenges/Risks`**. The plan steps might logically suggest the need for other tools (known or discovered). The generated plan text MUST be validated/detailed via `think`.", {
+    // Parameter Description: Reminds LLM of required internal generation content and openness.
+    task_objective: z.string().describe("Input the objective. *You* (LLM) must now *internally generate the structured plan text, including Anticipated Challenges/Risks, and noting steps where other tools might be applicable,* before calling. Signals plan text is ready for `think` analysis.")
+}, async ({ task_objective }) => {
     if (!task_objective || typeof task_objective !== 'string' || task_objective.trim().length === 0) {
-        throw new Error('Invalid task objective: Must be a non-empty string.');
+        throw new Error('Invalid task objective.');
     }
     console.error(`[CognitiveToolsServer] PlanAndSolve Tool Signaled for: ${task_objective.substring(0, 100)}...`);
-    return { content: [{ type: "text", text: `Planning generation signaled for objective: ${task_objective}. Ready for 'think' analysis.` }] };
+    // Output implies plan text *with risks and potential tool needs* is ready.
+    return { content: [{ type: "text", text: `Structured plan (incl. Risks/Challenges, potential tool needs) internally generated for objective: ${task_objective}. Ready for mandatory 'think' analysis.` }] };
 });
 server.tool("chain_of_thought", 
-// Main Description: Emphasizes generating text for later analysis.
-"Guides the LLM to **generate detailed, step-by-step reasoning text**. Used for complex logic or explainability. The *generated CoT text* MUST then be analyzed in a subsequent `think` call.", {
-    // Parameter Description: Focus on the input problem.
-    problem_statement: z.string().describe("Input the problem requiring detailed step-by-step reasoning. *You* (the LLM) must now *internally generate the full CoT text* before calling this tool. This signals that CoT text is ready for analysis in the next `think` step.")
+// Main Description: Refined to explicitly mention potential for other tools within the reasoning.
+"Guides the LLM to **internally generate detailed, step-by-step reasoning text (CoT)**. Steps within the CoT might logically identify points requiring external data, computation, code execution, or checks for other available tools. The generated CoT text MUST be analyzed via `think`.", {
+    // Parameter Description: Explicitly guides internal generation to consider tool needs.
+    problem_statement: z.string().describe("Input the specific problem requiring detailed CoT. *You* (LLM) must now *internally generate the full CoT text*, structuring it clearly and explicitly noting any steps where other tools (e.g., code execution, file access, web search, list_tools) might be needed *after* this CoT is analyzed. Call this tool *after* generating the text.")
 }, 
-// Implementation: Signals CoT was performed for the given problem.
+// Implementation: Signals CoT was performed and is ready for analysis.
 async ({ problem_statement }) => {
     if (!problem_statement || typeof problem_statement !== 'string' || problem_statement.trim().length === 0) {
-        throw new Error('Invalid problem statement: Must be a non-empty string.');
+        throw new Error('Invalid problem statement.');
     }
     console.error(`[CognitiveToolsServer] ChainOfThought Tool Signaled for: ${problem_statement.substring(0, 100)}...`);
-    return { content: [{ type: "text", text: `Chain of Thought internally generated for problem: ${problem_statement}. Ready for 'think' analysis.` }] };
+    // Output implies CoT text *potentially identifying tool needs* is ready for analysis.
+    return { content: [{ type: "text", text: `Detailed CoT (potentially identifying needs for other tools) internally generated for problem: ${problem_statement}. Ready for mandatory 'think' analysis.` }] };
 });
 server.tool("chain_of_draft", 
-// Main Description: Positions for efficient exploration and hypothesis generation.
-"Guides the LLM to **generate concise, iterative reasoning draft texts** ('thought-sketches'). Useful for efficiently exploring multiple solution paths, brainstorming hypotheses, or outlining approaches when full CoT verbosity is premature. Drafts MUST be analyzed comparatively via `think`.", {
-    // Parameter Description: Instructs LLM on draft generation.
-    problem_statement: z.string().describe("Input the problem or question for exploration. *You* (the LLM) must now *internally generate brief, iterative draft texts* (key steps, pros/cons, core ideas) for potential approaches *before* calling this tool.")
+// Main Description: Positions for efficient exploration, results analyzed by 'think'.
+"Guides the LLM to **internally generate concise, iterative reasoning draft texts** ('thought-sketches'). Useful for efficiently exploring multiple solution paths or brainstorming hypotheses. Drafts MUST be analyzed comparatively via `think`.", {
+    // Parameter Description: Instructs LLM on internal draft generation.
+    problem_statement: z.string().describe("Input the problem or question for exploration. *You* (LLM) must now *internally generate brief, iterative draft texts* (e.g., key steps, pros/cons) for potential approaches before calling this tool. Signals drafts are ready for `think` analysis.")
 }, 
 // Implementation: Signals Drafting was performed.
 async ({ problem_statement }) => {
     if (!problem_statement || typeof problem_statement !== 'string' || problem_statement.trim().length === 0) {
-        throw new Error('Invalid problem statement: Must be a non-empty string.');
+        throw new Error('Invalid problem statement.');
     }
     console.error(`[CognitiveToolsServer] ChainOfDraft Tool Signaled for: ${problem_statement.substring(0, 100)}...`);
-    return { content: [{ type: "text", text: `Chain of Draft generation signaled for problem: ${problem_statement}. Ready for 'think' analysis.` }] };
+    // Output implies draft texts are ready for comparative analysis.
+    return { content: [{ type: "text", text: `Reasoning drafts internally generated for problem: ${problem_statement}. Ready for mandatory 'think' analysis.` }] };
 });
 server.tool("reflection", 
-// Main Description: Explicitly mentions taking prior text as input for critique.
+// Main Description: Explicitly mentions taking prior text as input for critique, results analyzed by 'think'.
 "Guides the LLM to perform critical self-evaluation on **previously generated text** (reasoning, plans, code concepts). Essential for iterative refinement and improving accuracy. The *generated critique text* MUST be analyzed via `think`.", {
-    // Parameter Description: Input is the text to be critiqued.
-    input_reasoning_or_plan: z.string().describe("Input the **exact text** (e.g., from a prior `think` log, or internally generated plan/CoT/code concept) that *you* (the LLM) must now *internally generate a critique for*. Your critique should identify flaws and suggest improvements.")
+    // Parameter Description: Input is the specific text to be critiqued internally.
+    input_reasoning_or_plan: z.string().describe("Input the **exact text** (e.g., from a prior `think` log, or internally generated plan/CoT/code concept) that *you* (the LLM) must now *internally generate a critique for*. Your critique should identify flaws and suggest improvements. Call this tool *after* generating the critique.")
 }, 
 // Implementation: Signals Reflection was performed.
 async ({ input_reasoning_or_plan }) => {
     if (!input_reasoning_or_plan || typeof input_reasoning_or_plan !== 'string' || input_reasoning_or_plan.trim().length === 0) {
-        throw new Error('Invalid input reasoning/plan: Must be a non-empty string.');
+        throw new Error('Invalid input reasoning/plan.');
     }
     console.error(`[CognitiveToolsServer] Reflection Tool Signaled for analysis.`);
-    return { content: [{ type: "text", text: `Reflection internally generated for input text: '${input_reasoning_or_plan.substring(0, 100)}...'. Ready for 'think' analysis.` }] };
+    // Output implies critique text is ready for analysis.
+    return { content: [{ type: "text", text: `Reflection critique internally generated for input text: '${input_reasoning_or_plan.substring(0, 100)}...'. Ready for mandatory 'think' analysis.` }] };
 });
 // --- Server Lifecycle and Error Handling ---
 process.on('SIGINT', async () => {
-    console.error('[CognitiveToolsServer] Received SIGINT, shutting down.');
+    console.error('\n[CognitiveToolsServer] Received SIGINT, shutting down gracefully.');
     await server.close();
     process.exit(0);
 });
 process.on('SIGTERM', async () => {
-    console.error('[CognitiveToolsServer] Received SIGTERM, shutting down.');
+    console.error('\n[CognitiveToolsServer] Received SIGTERM, shutting down gracefully.');
     await server.close();
     process.exit(0);
 });
 process.on('uncaughtException', (error) => {
-    console.error('[CognitiveToolsServer] Uncaught exception:', error);
-    // Depending on severity, you might want to gracefully shutdown or just log
+    console.error('[CognitiveToolsServer] FATAL: Uncaught Exception:', error);
+    // Attempt graceful shutdown, but prioritize process exit
+    server.close().catch(err => console.error('[CognitiveToolsServer] Error during shutdown on uncaughtException:', err)).finally(() => {
+        process.exit(1); // Exit on fatal error
+    });
 });
 process.on('unhandledRejection', (reason, promise) => {
-    console.error('[CognitiveToolsServer] Unhandled promise rejection:', reason);
-    // Depending on severity, you might want to gracefully shutdown or just log
+    console.error('[CognitiveToolsServer] FATAL: Unhandled Promise Rejection:', reason);
+    // Attempt graceful shutdown, but prioritize process exit
+    server.close().catch(err => console.error('[CognitiveToolsServer] Error during shutdown on unhandledRejection:', err)).finally(() => {
+        process.exit(1); // Exit on fatal error
+    });
 });
 // Start the server
 async function main() {
     try {
         const transport = new StdioServerTransport();
         await server.connect(transport);
-        console.error('ᑭᑫᓐᑖᓱᐎᓐ ᐋᐸᒋᒋᑲᓇᓐ - Gikendaasowin Aabajichiganan - (Cognitive Tools v0.6.0) MCP Server running on stdio');
+        console.error('ᑭᑫᓐᑖᓱᐎᓐ ᐋᐸᒋᒋᑲᓇᓐ - Gikendaasowin Aabajichiganan - (Cognitive Tools v0.7.1) MCP Server running on stdio');
     }
     catch (error) {
         console.error('[CognitiveToolsServer] Fatal error during startup:', error);

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@nbiish/cognitive-tools-mcp",
-  "version": "0.6.2",
-  "description": "ᑭᑫᓐᑖᓱᐎᓐ ᐋᐸᒋᒋᑲᓇᓐ - Gikendaasowin Aabajichiganan - (Cognitive Tools v0.6.2): SOTA internal reasoning suite for LLM agents. Features advanced deliberation (`think`), rapid checks (`quick_think`), explicit complexity assessment, context synthesis (`synthesize`), confidence gauging, planning, CoT, and reflection. Designed to maximize reliability, traceability, and performance on complex cognitive tasks.",
+  "version": "0.7.1",
+  "description": "ᑭᑫᓐᑖᓱᐎᓐ ᐋᐸᒋᒋᑲᓇᓐ - Gikendaasowin Aabajichiganan - (Cognitive Tools v0.7.1): SOTA internal reasoning suite aligned with AI Pair Programmer Prompt v0.7.1+. Features advanced deliberation (`think`), rapid checks (`quick_think`), mandatory complexity assessment & strategy selection (`assess_complexity_and_select_thought_mode`), context synthesis, confidence gauging, proactive planning, explicit reasoning (CoT), and reflection. Updated from v0.6.x series. Designed for robust agentic workflows including potential executable actions and dynamic tool discovery.",
   "private": false,
   "type": "module",
   "bin": {
-    "gikendaasowin-aabajichiganan-mcp": "build/index.js"
+    "cognitive-tools-mcp": "build/index.js"
   },
   "files": [
     "build"