@afterxleep/doc-bot 1.7.2 → 1.7.4

package/README.md

@@ -79,12 +79,14 @@ Traditional AI assistants use static rule files (like Cursor Rules or Copilot's
 - AI doesn't know what documentation exists
 - Users must know to ask specific questions
 - No exploration or discovery capabilities
+- AI agents rely on basic grep searches through codebases to infer project patterns
 
 **MCP with doc-bot:**
 - AI can list all available documentation
 - Discovers relevant docs automatically
 - Suggests documentation based on context
-- Searchable knowledge base
+- Searchable knowledge base with intelligent ranking
+- No need for AI to grep through your codebase - dedicated search engine
 
 ## Installation
 
@@ -95,7 +97,7 @@ Traditional AI assistants use static rule files (like Cursor Rules or Copilot's
    ```json
    {
      "mcpServers": {
-       "docbot": {
+       "doc-bot": {
          "command": "npx",
          "args": ["@afterxleep/doc-bot"]
        }
@@ -103,11 +105,11 @@ Traditional AI assistants use static rule files (like Cursor Rules or Copilot's
    }
    ```
 
-   **Note:** By default, doc-bot looks for a `.doc-bot` folder. To use a different folder:
+   **Custom docs folder:**
    ```json
    {
      "mcpServers": {
-       "docbot": {
+       "doc-bot": {
          "command": "npx",
          "args": ["@afterxleep/doc-bot", "--docs", "./my-custom-docs"]
        }
@@ -115,6 +117,18 @@ Traditional AI assistants use static rule files (like Cursor Rules or Copilot's
    }
    ```
 
+   **With verbose logging (for debugging):**
+   ```json
+   {
+     "mcpServers": {
+       "doc-bot": {
+         "command": "npx",
+         "args": ["@afterxleep/doc-bot", "--verbose"]
+       }
+     }
+   }
+   ```
+
 3. **Restart your AI tool**
 
 ## How to organize your documentation
@@ -310,7 +324,7 @@ doc-bot --config ./manifest.json
      "mcpServers": {
        "doc-bot": {
          "command": "node",
-         "args": ["/path/to/doc-bot/bin/doc-bot.js", "--watch"]
+         "args": ["/path/to/doc-bot/bin/doc-bot.js", "--verbose", "--watch"]
        }
      }
    }

package/bin/doc-bot.js

@@ -41,7 +41,9 @@ async function main() {
   
   // Manifest is now optional - only create if explicitly requested
   if (options.config && !await fs.pathExists(configPath)) {
-    console.log('📝 Creating default manifest.json...');
+    if (options.verbose) {
+      console.error('📝 Creating default manifest.json...');
+    }
     const defaultManifest = {
       name: 'Project Documentation',
       version: '1.0.0',
@@ -58,33 +60,25 @@ async function main() {
     watch: options.watch
   });
   
-  console.log('🚀 Starting doc-bot...');
-  console.log(`📁 Documentation: ${docsPath}`);
-  if (await fs.pathExists(configPath)) {
-    console.log(`⚙️  Configuration: ${configPath}`);
-  } else {
-    console.log(`⚙️  Configuration: Auto-generated from frontmatter`);
-  }
-  
-  if (options.watch) {
-    console.log('👀 Watching for file changes...');
+  if (options.verbose) {
+    console.error('🚀 Starting doc-bot...');
+    console.error(`📁 Documentation: ${docsPath}`);
+    if (await fs.pathExists(configPath)) {
+      console.error(`⚙️  Configuration: ${configPath}`);
+    } else {
+      console.error(`⚙️  Configuration: Auto-generated from frontmatter`);
+    }
+    
+    if (options.watch) {
+      console.error('👀 Watching for file changes...');
+    }
   }
   
   await server.start();
-  console.log('✅ Server started successfully!');
-  console.log('');
-  console.log('📋 Add this to your Claude Code configuration:');
-  console.log('');
-  console.log('{');
-  console.log('  "mcpServers": {');
-  console.log('    "docs": {');
-  console.log(`      "command": "npx",`);
-  console.log(`      "args": ["doc-bot", "--docs", "${docsPath}"]`);
-  console.log('    }');
-  console.log('  }');
-  console.log('}');
-  console.log('');
-  console.log('🔄 Then restart Claude Code');
+  
+  if (options.verbose) {
+    console.error('✅ Server started successfully!');
+  }
 }
 
 main().catch(error => {

package/package.json

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

package/src/index.js

@@ -319,7 +319,7 @@ class DocsServer {
     
     watcher.on('change', async (filePath) => {
       if (this.options.verbose) {
-        console.log(`📄 Documentation updated: ${path.relative(process.cwd(), filePath)}`);
+        console.error(`📄 Documentation updated: ${path.relative(process.cwd(), filePath)}`);
       }
       
       // Reload manifest if config changed
@@ -757,11 +757,11 @@ class DocsServer {
     await this.server.connect(transport);
     
     if (this.options.verbose) {
-      console.log('🔧 Server initialized with MCP transport');
+      console.error('🔧 Server initialized with MCP transport');
       if (this.manifestLoader) {
-        console.log('📄 Using manifest.json for additional configuration');
+        console.error('📄 Using manifest.json for additional configuration');
       } else {
-        console.log('🚀 Using frontmatter-based configuration (no manifest needed)');
+        console.error('🚀 Using frontmatter-based configuration (no manifest needed)');
       }
     }
   }

package/src/services/DocumentationService.js

@@ -24,7 +24,7 @@ class DocumentationService {
   async loadDocuments() {
     try {
       if (!await fs.pathExists(this.docsPath)) {
-        console.warn(`Documentation path does not exist: ${this.docsPath}`);
+        // Silently return if path doesn't exist - this is normal for MCP servers
         return;
       }
       
@@ -75,7 +75,7 @@ class DocumentationService {
           content: match[2]
         };
       } catch (error) {
-        console.warn('Failed to parse frontmatter:', error);
+        // Silently skip files with invalid frontmatter
       }
     }