@afterxleep/doc-bot 1.13.0 → 1.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@afterxleep/doc-bot",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "description": "Generic MCP server for intelligent documentation access in any project",
   "type": "module",
   "main": "src/index.js",

package/prompts/agent-optimized-system-prompt.txt

@@ -61,7 +61,11 @@ STEP 6: validation(response, project_rules)
 ### Fallback Response:
 1. **Context Check**: Verify if response requires project knowledge
 2. **Tool Selection**: Use search_documentation if uncertain
-3. **Generic Response**: Only if certain no project context needed
+3. **Search Limit**: If documentation search yields no results after 2-3 attempts, fall back to web search
+4. **Web Search Guidance**: When instructed to use web search after failed documentation searches:
+   - Use web search for official documentation, tutorials, and examples
+   - Combine project context with external knowledge when appropriate
+5. **Generic Response**: Only if certain no project context needed
 
 ## VALIDATION REQUIREMENTS:
 

package/prompts/cognitive-triggers.txt

@@ -37,4 +37,9 @@
 - **Mandatory**: Use MCP tools for any project-related query
 - **Precedence**: Tool responses override general knowledge
 - **Accuracy**: Verify information against documentation
-- **Completeness**: Don't add assumptions beyond tool output
+- **Completeness**: Don't add assumptions beyond tool output
+- **Search Limits**: If documentation searches yield no results after 2-3 attempts, follow web search fallback
+- **Fallback Protocol**: When instructed to use web search:
+  - Acknowledge the documentation search limitation
+  - Use web search for external resources
+  - Combine findings with any available project context

package/prompts/system-prompt.txt

@@ -62,6 +62,11 @@
 - **Accuracy**: Do not add information beyond tool output
 - **Completeness**: Use tools for all project-related queries
 - **Validation**: Verify code compliance with project rules
+- **Search Fallback**: If documentation searches fail after 2-3 attempts, the system will recommend web search
+- **Web Search Usage**: When instructed to use web search after failed documentation searches:
+  - Use web search for official documentation, community resources, and examples
+  - Combine external knowledge with project context appropriately
+  - Prioritize authoritative sources for technical information
 
 ## OPERATIONAL EXAMPLES:
 

package/src/index.js

@@ -27,6 +27,9 @@ class DocsServer {
     // Cache for prompt templates
     this.promptTemplates = {};
     
+    // Track search attempts per session/query pattern
+    this.searchAttempts = new Map();
+    
     this.server = new Server({
       name: 'doc-bot',
       version: '1.0.0',
@@ -618,8 +621,44 @@ class DocsServer {
   }
   
   async formatUnifiedSearchResults(results, query) {
+    // Track search attempts for this query pattern
+    const queryKey = query.toLowerCase().trim();
+    const attemptData = this.searchAttempts.get(queryKey) || { count: 0, timestamp: Date.now() };
+    attemptData.count += 1;
+    attemptData.timestamp = Date.now();
+    this.searchAttempts.set(queryKey, attemptData);
+    
     if (!results || results.length === 0) {
-      return `No documentation found for query: "${query}" in any source.`;
+      // Check if we've tried multiple times
+      if (attemptData.count >= 3) {
+        // Clear the counter after suggesting fallback
+        this.searchAttempts.delete(queryKey);
+        
+        return `No documentation found for query: "${query}" in any source after ${attemptData.count} attempts.
+
+## 🌐 Fallback Recommendation:
+Since the documentation search hasn't yielded results after multiple attempts, **consider using web search** to find information about "${query}". Web searches can provide:
+
+- Latest API documentation from official sources
+- Community tutorials and examples
+- Stack Overflow solutions
+- Blog posts and articles
+
+**Suggested action:** Use web search with queries like:
+- "${query} documentation"
+- "${query} API reference"
+- "${query} example code"
+- "${query} tutorial"
+
+This will help you find the most current information beyond the local documentation.`;
+      }
+      
+      return `No documentation found for query: "${query}" in any source.
+
+Try:
+- Using different search terms or keywords
+- Searching for related concepts
+- Checking if the correct docset is installed with \`list_docsets\``;
     }
     
     let output = `# Search Results for "${query}"\n\n`;
@@ -1266,6 +1305,17 @@ class DocsServer {
     await this.docService.initialize();
     await this.inferenceEngine.initialize();
     
+    // Set up periodic cleanup of search attempts (every 5 minutes)
+    this.searchCleanupInterval = setInterval(() => {
+      // Clear search attempts older than 10 minutes
+      const now = Date.now();
+      for (const [key, value] of this.searchAttempts.entries()) {
+        if (typeof value === 'object' && value.timestamp && (now - value.timestamp) > 600000) {
+          this.searchAttempts.delete(key);
+        }
+      }
+    }, 300000);
+    
     // Initialize docset services
     try {
       await this.docsetService.initialize();

package/src/services/docset/index.js

@@ -2,7 +2,7 @@ import fs from 'fs-extra';
 import path from 'path';
 import { createWriteStream } from 'fs';
 import axios from 'axios';
-import tar from 'tar';
+import * as tar from 'tar';
 import AdmZip from 'adm-zip';
 import plist from 'plist';
 import crypto from 'crypto';