@afterxleep/doc-bot 1.7.1 → 1.7.3

package/README.md

@@ -95,7 +95,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 +103,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 +115,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
@@ -308,9 +320,9 @@ doc-bot --config ./manifest.json
    ```json
    {
      "mcpServers": {
-       "docs": {
+       "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

@@ -9,7 +9,7 @@ program
   .name('doc-bot')
   .description('Generic MCP server for intelligent documentation access')
   .version('1.5.0')
-  .option('-d, --docs <path>', 'Path to docs folder', '.doc-bot')
+  .option('-d, --docs <path>', 'Path to docs folder', 'doc-bot')
   .option('-c, --config <path>', 'Path to manifest file')
   .option('-v, --verbose', 'Enable verbose logging')
   .option('-w, --watch', 'Watch for file changes')
@@ -34,14 +34,16 @@ async function main() {
     console.log('   alwaysApply: true   (for global rules)');
     console.log('   alwaysApply: false  (for contextual rules)');
     console.log('');
-    console.log('💡 Tip: By default, doc-bot looks for a .doc-bot folder.');
+    console.log('💡 Tip: By default, doc-bot looks for a doc-bot folder.');
     console.log('   Use --docs to specify a different folder.');
     process.exit(1);
   }
   
   // 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.1",
+  "version": "1.7.3",
   "description": "Generic MCP server for intelligent documentation access in any project",
   "main": "src/index.js",
   "bin": {

package/src/index.js

@@ -11,8 +11,8 @@ const fs = require('fs').promises;
 class DocsServer {
   constructor(options = {}) {
     this.options = {
-      docsPath: options.docsPath || './.doc-bot',
-      configPath: options.configPath || './.doc-bot/manifest.json', // Optional, for backward compatibility
+      docsPath: options.docsPath || './doc-bot',
+      configPath: options.configPath || './doc-bot/manifest.json', // Optional, for backward compatibility
       verbose: options.verbose || false,
       watch: options.watch || false,
       ...options
@@ -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
       }
     }