@afterxleep/doc-bot 1.3.0 → 1.4.0

package/README.md

@@ -119,7 +119,9 @@ Doc-bot ensures your rules are **always considered** through multiple enforcemen
 - **Rule reminders**: Every tool response includes compliance warnings
 
 ### 🔄 Automatic Integration
-- **System prompt injection**: Global rules injected into agent's system context via `docs://system-prompt`
+- **Enhanced system prompt injection**: Comprehensive MCP usage protocol injected via `docs://system-prompt`
+- **Documentation discovery**: Available topics automatically extracted and presented to agent
+- **Tool usage instructions**: Explicit requirements for when and how to use each MCP tool
 - **Contextual rules**: Applied when working with matching files/patterns  
 - **Multiple touchpoints**: Rules enforced at every interaction level
 
@@ -131,6 +133,27 @@ All tool responses include explicit warnings that rules are:
 
 This multi-layered approach makes rule violations virtually impossible to ignore.
 
+## System Prompt Integration
+
+The `docs://system-prompt` resource automatically injects comprehensive instructions into the AI agent's system context:
+
+### 📋 MCP Usage Protocol
+- Explicit instructions to **ALWAYS** call `check_project_rules` before code generation
+- **NEVER generate code without checking documentation** requirement
+- Mandatory acknowledgment of rule compliance
+
+### 🏷️ Automatic Topic Discovery
+- Extracts available documentation topics from your project
+- Presents them to the agent for context awareness
+- Includes topics from metadata, filenames, and content analysis
+
+### 🛠️ Tool Usage Requirements
+- Specifies when and how to use each MCP tool
+- Maps tools to specific use cases (file-specific docs, search, etc.)
+- Ensures comprehensive documentation coverage
+
+The system prompt is regenerated on each request to reflect current documentation state.
+
 ## The manifest file
 
 The `doc-bot/manifest.json` file controls how your documentation works:

package/package.json

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

package/src/index.js

@@ -404,22 +404,114 @@ class DocsServer {
 
   async generateSystemPrompt() {
     const globalRules = await this.docService.getGlobalRules();
+    const allDocs = await this.docService.getAllDocuments();
+    
+    let prompt = '# CRITICAL: Project Documentation and MCP Server Integration\n\n';
+    
+    // Add MCP server usage instructions
+    prompt += '## 🔧 MANDATORY: MCP Server Usage Protocol\n\n';
+    prompt += 'You have access to a doc-bot MCP server with the following MANDATORY requirements:\n\n';
+    prompt += '### 🚨 BEFORE ANY CODE GENERATION:\n';
+    prompt += '1. **ALWAYS** call `check_project_rules` tool first to get critical project rules\n';
+    prompt += '2. **NEVER generate code without checking project documentation**\n';
+    prompt += '3. **REQUIRED** to acknowledge rule compliance before proceeding\n\n';
+    
+    prompt += '### 📚 Available Documentation Resources:\n';
+    if (allDocs && allDocs.length > 0) {
+      const docTopics = this.extractDocumentationTopics(allDocs);
+      prompt += 'This project has documentation covering:\n';
+      docTopics.forEach(topic => {
+        prompt += `- ${topic}\n`;
+      });
+      prompt += '\n';
+    }
     
-    if (!globalRules || globalRules.length === 0) {
-      return 'No global documentation rules defined.';
+    prompt += '### 🛠️ Required MCP Tool Usage:\n';
+    prompt += '- Use `check_project_rules` before ANY code generation\n';
+    prompt += '- Use `get_relevant_docs` when working with specific files/patterns\n';
+    prompt += '- Use `search_documentation` to find specific guidance\n';
+    prompt += '- Use `get_global_rules` for comprehensive rule review\n\n';
+    
+    // Add project-specific rules
+    if (globalRules && globalRules.length > 0) {
+      prompt += '## 📋 Project-Specific Rules (NON-NEGOTIABLE)\n\n';
+      prompt += 'IMPORTANT: You MUST follow these rules before generating ANY code:\n\n';
+      
+      globalRules.forEach((rule, index) => {
+        prompt += `### Rule ${index + 1}: ${rule.metadata?.title || rule.fileName}\n`;
+        prompt += `${rule.content}\n\n`;
+      });
     }
     
-    let prompt = '# CRITICAL: Project Documentation Rules\n\n';
-    prompt += 'IMPORTANT: You MUST follow these rules before generating ANY code:\n\n';
+    prompt += '---\n\n';
+    prompt += '⚠️ **CRITICAL COMPLIANCE REQUIREMENTS:**\n';
+    prompt += '- VIOLATION OF THESE RULES IS NOT ACCEPTABLE\n';
+    prompt += '- ALWAYS use MCP tools before coding\n';
+    prompt += '- ACKNOWLEDGE rule compliance before responding\n';
+    prompt += '- NEVER assume - always check documentation\n';
     
-    globalRules.forEach((rule, index) => {
-      prompt += `## Rule ${index + 1}: ${rule.metadata?.title || rule.fileName}\n`;
-      prompt += `${rule.content}\n\n`;
+    return prompt;
+  }
+
+  extractDocumentationTopics(docs) {
+    const topics = new Set();
+    
+    docs.forEach(doc => {
+      // Add topics from metadata
+      if (doc.metadata?.topics) {
+        doc.metadata.topics.forEach(topic => topics.add(topic));
+      }
+      
+      // Add topics from keywords
+      if (doc.metadata?.keywords) {
+        doc.metadata.keywords.forEach(keyword => topics.add(keyword));
+      }
+      
+      // Add filename-based topics
+      const fileName = doc.fileName.replace(/\.(md|txt)$/, '');
+      const fileTopics = fileName.split(/[-_]/).map(part => 
+        part.charAt(0).toUpperCase() + part.slice(1)
+      );
+      fileTopics.forEach(topic => topics.add(topic));
+      
+      // Add content-based topics (simple heuristic)
+      if (doc.content) {
+        const contentTopics = this.extractContentTopics(doc.content);
+        contentTopics.forEach(topic => topics.add(topic));
+      }
     });
     
-    prompt += '⚠️ VIOLATION OF THESE RULES IS NOT ACCEPTABLE. Always check compliance before responding.\n';
+    return Array.from(topics).slice(0, 10); // Limit to top 10 topics
+  }
+
+  extractContentTopics(content) {
+    const topics = new Set();
+    
+    // Extract from headers
+    const headers = content.match(/^#+\s+(.+)$/gm);
+    if (headers) {
+      headers.forEach(header => {
+        const topic = header.replace(/^#+\s+/, '').trim();
+        if (topic.length > 3 && topic.length < 50) {
+          topics.add(topic);
+        }
+      });
+    }
     
-    return prompt;
+    // Extract common programming topics
+    const programmingPatterns = [
+      'Swift', 'SwiftUI', 'iOS', 'macOS', 'Architecture', 'Testing',
+      'Performance', 'Security', 'Privacy', 'Patterns', 'Components',
+      'API', 'Database', 'UI', 'UX', 'Analytics', 'Configuration'
+    ];
+    
+    programmingPatterns.forEach(pattern => {
+      if (content.toLowerCase().includes(pattern.toLowerCase())) {
+        topics.add(pattern);
+      }
+    });
+    
+    return Array.from(topics);
   }
 
   async getMandatoryRules(task) {