@afterxleep/doc-bot 1.15.0 → 1.16.0

package/AGENT_INTEGRATION_RULE.txt

@@ -67,8 +67,9 @@ Are you about to:
 
 If doc_bot is unavailable:
 1. STOP
-2. Tell user: "doc_bot MCP server is required but not available"
-3. DO NOT attempt to help without it
+2. Tell user: "The doc_bot Rules and Documentation server is not available"
+3. Ask the user if they want to continue without any rulesets applied.
+4. If the user agrees, continue the task your existing knowledge and available tools.
 
 ---
 Remember: You're not here to be creative. You're here to be CORRECT.

package/README.md

@@ -60,6 +60,9 @@ Add doc-bot to your AI assistant's configuration:
 - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 - Linux: `~/.config/Claude/claude_desktop_config.json`
 
+**For Cursor:**
+- Add an `mcp.json` file with the contents above to your `.cursor` folder
+
 ### 2. Create Your Documentation
 
 Create a `doc-bot` folder in your project root and add markdown files:
@@ -75,7 +78,11 @@ your-project/
 └── package.json
 ```
 
-### 3. Test It
+### 3. Add the custom Agent Rule
+
+Replace all rules and instructions for your Agent (cursor.mdc, CLAUDE.md, etc) with Doc Bot Core Rule [AGENT INTEGRATION RULE](https://github.com/afterxleep/doc-bot/blob/main/AGENT_INTEGRATION_RULE.txt).
+
+### 4. Test it!
 
 Ask your AI assistant: "What are the coding standards for this project?"
 
@@ -326,4 +333,4 @@ MIT - See [LICENSE](LICENSE) for details.
 
 ---
 
-Built with ❤️ in Spain
+Built with ❤️ in Spain

package/package.json

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

package/src/index.js

@@ -1062,7 +1062,65 @@ Try:
     let guidance = `# 🤖 DOC-BOT INTELLIGENT ASSISTANT\n\n`;
     guidance += `**Your Request**: ${task}\n\n`;
     
-    // Analyze the task and provide intelligent routing
+    // Check for administrative/management tasks first
+    const isDocsetManagement = /add.*docset|remove.*docset|list.*docset|install.*docset/i.test(task);
+    const isRuleManagement = /add.*rule|create.*rule|update.*rule|document.*pattern|capture.*pattern/i.test(task);
+    const isDocumentManagement = /refresh.*doc|reload.*doc|index.*doc|get.*index/i.test(task);
+    
+    // Handle administrative tasks directly
+    if (isDocsetManagement) {
+      guidance += `## 📦 DOCSET MANAGEMENT TASK DETECTED\n\n`;
+      guidance += `**Direct Actions Required**:\n`;
+      
+      if (/list/i.test(task)) {
+        guidance += `1. \`list_docsets()\` - Show all installed documentation sets\n\n`;
+      } else if (/add|install/i.test(task)) {
+        guidance += `1. \`add_docset(source: "path/to/docset or URL")\` - Install new docset\n\n`;
+        guidance += `📝 **Examples**:\n`;
+        guidance += `- Local: \`add_docset(source: "/Downloads/Swift.docset")\`\n`;
+        guidance += `- URL: \`add_docset(source: "https://example.com/React.docset.tgz")\`\n\n`;
+      } else if (/remove/i.test(task)) {
+        guidance += `1. \`list_docsets()\` - First, get the docset ID\n`;
+        guidance += `2. \`remove_docset(docsetId: "the-id-from-step-1")\` - Remove the docset\n\n`;
+      }
+      
+      guidance += `💡 **Note**: This is an administrative task - no documentation search needed.\n`;
+      return guidance;
+    }
+    
+    if (isRuleManagement) {
+      guidance += `## 📝 RULE/PATTERN MANAGEMENT TASK DETECTED\n\n`;
+      guidance += `**Direct Action Required**:\n`;
+      guidance += `1. \`create_or_update_rule(...)\` with these parameters:\n\n`;
+      guidance += `\`\`\`javascript\n`;
+      guidance += `{\n`;
+      guidance += `  fileName: "descriptive-name.md",\n`;
+      guidance += `  title: "Clear title for the rule/pattern",\n`;
+      guidance += `  content: "Full markdown documentation",\n`;
+      guidance += `  alwaysApply: true/false, // true = global, false = contextual\n`;
+      guidance += `  keywords: ["relevant", "search", "terms"],\n`;
+      guidance += `  description: "Brief summary" // optional\n`;
+      guidance += `}\n`;
+      guidance += `\`\`\`\n\n`;
+      guidance += `💡 **Note**: This captures project knowledge permanently - no search needed.\n`;
+      return guidance;
+    }
+    
+    if (isDocumentManagement) {
+      guidance += `## 🔄 DOCUMENTATION MANAGEMENT TASK DETECTED\n\n`;
+      guidance += `**Direct Action Required**:\n`;
+      
+      if (/refresh|reload/i.test(task)) {
+        guidance += `1. \`refresh_documentation()\` - Reload all docs from disk\n\n`;
+      } else {
+        guidance += `1. \`get_document_index()\` - List all available documentation\n\n`;
+      }
+      
+      guidance += `💡 **Note**: This is an administrative task - direct execution only.\n`;
+      return guidance;
+    }
+    
+    // Analyze the task and provide intelligent routing for non-administrative tasks
     if (taskLower.includes('create') || taskLower.includes('implement') || taskLower.includes('build') || 
         taskLower.includes('write') || taskLower.includes('add') || taskLower.includes('code') ||
         taskLower.includes('function') || taskLower.includes('class') || taskLower.includes('component')) {