@afterxleep/doc-bot 1.16.0 → 1.18.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@afterxleep/doc-bot",
-  "version": "1.16.0",
+  "version": "1.18.0",
   "description": "Generic MCP server for intelligent documentation access in any project",
   "type": "module",
   "main": "src/index.js",
@@ -12,9 +12,12 @@
     "start:watch": "node bin/doc-bot.js --verbose --watch",
     "start:examples": "node bin/doc-bot.js --docs ./samples --verbose",
     "dev": "node bin/doc-bot.js --verbose --watch",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest",
+    "test:watch": "NODE_OPTIONS=--experimental-vm-modules jest --watch",
+    "test:coverage": "NODE_OPTIONS=--experimental-vm-modules jest --coverage",
+    "test:e2e": "node test/fixtures/create-test-docs.js && NODE_OPTIONS=--experimental-vm-modules jest test/e2e.test.js",
+    "test:unit": "NODE_OPTIONS=--experimental-vm-modules jest src/services/__tests__",
+    "test:setup": "node test/fixtures/create-test-docs.js",
     "lint": "eslint src/ bin/ --ext .js",
     "lint:fix": "eslint src/ bin/ --ext .js --fix"
   },

package/src/__tests__/temp-docs-1756129972061/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756129972071/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756129972075/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756129972077/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756129972079/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756130189361/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756130189372/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756130189375/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756130189378/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756130189379/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756130271128/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756130271139/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756130271142/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756130271145/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756130271146/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756130687030/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756130687044/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756130687048/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756130687051/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756130687053/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756131694925/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756131694937/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756131694941/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756131694944/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756131694946/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756133998710/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756133998721/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756133998724/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756133998727/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756133998729/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756134345935/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756134345948/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756134345952/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756134345954/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docs-1756134345957/test.md

@@ -0,0 +1,5 @@
+---
+alwaysApply: true
+title: Test Doc
+---
+# Test

package/src/__tests__/temp-docsets-1756129972079/2e443167/Mock.docset/Contents/Info.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>Mock Documentation</string>
+  <key>CFBundleIdentifier</key>
+  <string>mock.documentation</string>
+</dict>
+</plist>

package/src/__tests__/temp-docsets-1756129972079/Mock.docset/Contents/Info.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>Mock Documentation</string>
+  <key>CFBundleIdentifier</key>
+  <string>mock.documentation</string>
+</dict>
+</plist>

package/src/__tests__/temp-docsets-1756129972079/docsets.json

@@ -0,0 +1,10 @@
+[
+  {
+    "id": "2e443167",
+    "name": "Mock Documentation",
+    "source": "/Users/afterxleep/Developer/doc-bot/src/__tests__/temp-docsets-1756129972079/Mock.docset",
+    "path": "/Users/afterxleep/Developer/doc-bot/src/__tests__/temp-docsets-1756129972079/2e443167/Mock.docset",
+    "downloadedAt": "2025-08-25T13:52:52.088Z",
+    "size": 8513
+  }
+]

package/src/__tests__/temp-docsets-1756130189379/Mock.docset/Contents/Info.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>Mock Documentation</string>
+  <key>CFBundleIdentifier</key>
+  <string>mock.documentation</string>
+</dict>
+</plist>

package/src/__tests__/temp-docsets-1756130189379/a4934c14/Mock.docset/Contents/Info.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>Mock Documentation</string>
+  <key>CFBundleIdentifier</key>
+  <string>mock.documentation</string>
+</dict>
+</plist>

package/src/__tests__/temp-docsets-1756130189379/docsets.json

@@ -0,0 +1,10 @@
+[
+  {
+    "id": "a4934c14",
+    "name": "Mock Documentation",
+    "source": "/Users/afterxleep/Developer/doc-bot/src/__tests__/temp-docsets-1756130189379/Mock.docset",
+    "path": "/Users/afterxleep/Developer/doc-bot/src/__tests__/temp-docsets-1756130189379/a4934c14/Mock.docset",
+    "downloadedAt": "2025-08-25T13:56:29.388Z",
+    "size": 8513
+  }
+]

package/src/__tests__/temp-docsets-1756130271146/3f8acbb2/Mock.docset/Contents/Info.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>Mock Documentation</string>
+  <key>CFBundleIdentifier</key>
+  <string>mock.documentation</string>
+</dict>
+</plist>

package/src/__tests__/temp-docsets-1756130271146/Mock.docset/Contents/Info.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>Mock Documentation</string>
+  <key>CFBundleIdentifier</key>
+  <string>mock.documentation</string>
+</dict>
+</plist>

package/src/__tests__/temp-docsets-1756130271146/docsets.json

@@ -0,0 +1,10 @@
+[
+  {
+    "id": "3f8acbb2",
+    "name": "Mock Documentation",
+    "source": "/Users/afterxleep/Developer/doc-bot/src/__tests__/temp-docsets-1756130271146/Mock.docset",
+    "path": "/Users/afterxleep/Developer/doc-bot/src/__tests__/temp-docsets-1756130271146/3f8acbb2/Mock.docset",
+    "downloadedAt": "2025-08-25T13:57:51.155Z",
+    "size": 8513
+  }
+]

package/src/__tests__/temp-docsets-1756130687053/6810e6bd/Mock.docset/Contents/Info.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>Mock Documentation</string>
+  <key>CFBundleIdentifier</key>
+  <string>mock.documentation</string>
+</dict>
+</plist>

package/src/__tests__/temp-docsets-1756130687053/Mock.docset/Contents/Info.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>Mock Documentation</string>
+  <key>CFBundleIdentifier</key>
+  <string>mock.documentation</string>
+</dict>
+</plist>

package/src/__tests__/temp-docsets-1756130687053/docsets.json

@@ -0,0 +1,10 @@
+[
+  {
+    "id": "6810e6bd",
+    "name": "Mock Documentation",
+    "source": "/Users/afterxleep/Developer/doc-bot/src/__tests__/temp-docsets-1756130687053/Mock.docset",
+    "path": "/Users/afterxleep/Developer/doc-bot/src/__tests__/temp-docsets-1756130687053/6810e6bd/Mock.docset",
+    "downloadedAt": "2025-08-25T14:04:47.063Z",
+    "size": 8513
+  }
+]

package/src/__tests__/temp-docsets-1756131694946/Mock.docset/Contents/Info.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>Mock Documentation</string>
+  <key>CFBundleIdentifier</key>
+  <string>mock.documentation</string>
+</dict>
+</plist>

package/src/__tests__/temp-docsets-1756131694946/dd703046/Mock.docset/Contents/Info.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>Mock Documentation</string>
+  <key>CFBundleIdentifier</key>
+  <string>mock.documentation</string>
+</dict>
+</plist>

package/src/__tests__/temp-docsets-1756131694946/docsets.json

@@ -0,0 +1,10 @@
+[
+  {
+    "id": "dd703046",
+    "name": "Mock Documentation",
+    "source": "/Users/afterxleep/Developer/doc-bot/src/__tests__/temp-docsets-1756131694946/Mock.docset",
+    "path": "/Users/afterxleep/Developer/doc-bot/src/__tests__/temp-docsets-1756131694946/dd703046/Mock.docset",
+    "downloadedAt": "2025-08-25T14:21:34.958Z",
+    "size": 8513
+  }
+]

package/src/__tests__/temp-docsets-1756133998729/9e061136/Mock.docset/Contents/Info.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>Mock Documentation</string>
+  <key>CFBundleIdentifier</key>
+  <string>mock.documentation</string>
+</dict>
+</plist>

package/src/__tests__/temp-docsets-1756133998729/Mock.docset/Contents/Info.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>Mock Documentation</string>
+  <key>CFBundleIdentifier</key>
+  <string>mock.documentation</string>
+</dict>
+</plist>

package/src/__tests__/temp-docsets-1756133998729/docsets.json

@@ -0,0 +1,10 @@
+[
+  {
+    "id": "9e061136",
+    "name": "Mock Documentation",
+    "source": "/Users/afterxleep/Developer/doc-bot/src/__tests__/temp-docsets-1756133998729/Mock.docset",
+    "path": "/Users/afterxleep/Developer/doc-bot/src/__tests__/temp-docsets-1756133998729/9e061136/Mock.docset",
+    "downloadedAt": "2025-08-25T14:59:58.738Z",
+    "size": 8513
+  }
+]

package/src/__tests__/temp-docsets-1756134345957/03e730af/Mock.docset/Contents/Info.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>Mock Documentation</string>
+  <key>CFBundleIdentifier</key>
+  <string>mock.documentation</string>
+</dict>
+</plist>

package/src/__tests__/temp-docsets-1756134345957/Mock.docset/Contents/Info.plist

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>Mock Documentation</string>
+  <key>CFBundleIdentifier</key>
+  <string>mock.documentation</string>
+</dict>
+</plist>

package/src/__tests__/temp-docsets-1756134345957/docsets.json

@@ -0,0 +1,10 @@
+[
+  {
+    "id": "03e730af",
+    "name": "Mock Documentation",
+    "source": "/Users/afterxleep/Developer/doc-bot/src/__tests__/temp-docsets-1756134345957/Mock.docset",
+    "path": "/Users/afterxleep/Developer/doc-bot/src/__tests__/temp-docsets-1756134345957/03e730af/Mock.docset",
+    "downloadedAt": "2025-08-25T15:05:45.967Z",
+    "size": 8513
+  }
+]

package/src/index.js

@@ -9,6 +9,7 @@ import { UnifiedSearchService } from './services/UnifiedSearchService.js';
 import chokidar from 'chokidar';
 import path from 'path';
 import { promises as fs } from 'fs';
+import fsExtra from 'fs-extra';
 import { fileURLToPath } from 'url';
 import os from 'os';
 
@@ -61,12 +62,21 @@ class DocsServer {
 
   async loadPromptTemplate(templateName) {
     if (!this.promptTemplates[templateName]) {
-      const templatePath = path.join(__dirname, '../prompts', `${templateName}.txt`);
+      // Try markdown first, fall back to txt for backward compatibility
+      const mdPath = path.join(__dirname, '../prompts', `${templateName}.md`);
+      const txtPath = path.join(__dirname, '../prompts', `${templateName}.txt`);
+      
       try {
-        this.promptTemplates[templateName] = await fs.readFile(templatePath, 'utf8');
-      } catch (error) {
-        console.error(`Failed to load prompt template ${templateName}:`, error);
-        return null;
+        // Try loading markdown version first
+        this.promptTemplates[templateName] = await fs.readFile(mdPath, 'utf8');
+      } catch (mdError) {
+        try {
+          // Fall back to txt version
+          this.promptTemplates[templateName] = await fs.readFile(txtPath, 'utf8');
+        } catch (txtError) {
+          console.error(`Failed to load prompt template ${templateName}:`, mdError.message);
+          return null;
+        }
       }
     }
     return this.promptTemplates[templateName];
@@ -1224,12 +1234,9 @@ Try:
   }
 
   async createOrUpdateRule({ fileName, title, description, keywords, alwaysApply, content }) {
-    const fs = require('fs-extra');
-    const path = require('path');
-    
     try {
       // Ensure the docs directory exists
-      await fs.ensureDir(this.options.docsPath);
+      await fsExtra.ensureDir(this.options.docsPath);
       
       // Create the full file path
       const filePath = path.join(this.options.docsPath, fileName);
@@ -1250,11 +1257,11 @@ Try:
       const fullContent = frontmatter + content;
       
       // Check if file exists to determine if this is create or update
-      const fileExists = await fs.pathExists(filePath);
+      const fileExists = await fsExtra.pathExists(filePath);
       const action = fileExists ? 'updated' : 'created';
       
       // Write the file
-      await fs.writeFile(filePath, fullContent, 'utf8');
+      await fsExtra.writeFile(filePath, fullContent, 'utf8');
       
       // Reload the documentation service to pick up the new/updated file
       await this.docService.reload();