mcp-docs-service 0.2.0 → 0.2.3

package/dist/utils/index.js

@@ -1,152 +1,3 @@
-"use strict";
-/**
- * Utility functions for the MCP Documentation Service
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateExcerpt = exports.calculateRelevance = exports.escapeRegex = exports.joinPaths = exports.getDirectoryName = exports.getFileName = exports.getFileExtension = exports.normalizePath = exports.isValidPath = void 0;
-/**
- * Check if a path is valid
- * @param path - Path to check
- * @returns True if the path is valid, false otherwise
- */
-function isValidPath(path) {
-    // Ensure path doesn't contain invalid characters or sequences
-    return !path.includes("..") && !path.includes("//") && !path.startsWith("/");
-}
-exports.isValidPath = isValidPath;
-/**
- * Normalize a path
- * @param path - Path to normalize
- * @returns Normalized path
- */
-function normalizePath(path) {
-    // Replace backslashes with forward slashes
-    path = path.replace(/\\/g, "/");
-    // Remove leading and trailing slashes
-    path = path.replace(/^\/+|\/+$/g, "");
-    // Replace multiple slashes with a single slash
-    path = path.replace(/\/+/g, "/");
-    return path;
-}
-exports.normalizePath = normalizePath;
-/**
- * Get file extension
- * @param path - Path to get extension from
- * @returns File extension
- */
-function getFileExtension(path) {
-    const match = path.match(/\.([^.]+)$/);
-    return match ? `.${match[1].toLowerCase()}` : "";
-}
-exports.getFileExtension = getFileExtension;
-/**
- * Get file name
- * @param path - Path to get name from
- * @returns File name
- */
-function getFileName(path) {
-    const match = path.match(/([^/]+)$/);
-    return match ? match[1] : "";
-}
-exports.getFileName = getFileName;
-/**
- * Get directory name
- * @param path - Path to get directory name from
- * @returns Directory name
- */
-function getDirectoryName(path) {
-    const match = path.match(/([^/]+)\/[^/]+$/);
-    return match ? match[1] : "";
-}
-exports.getDirectoryName = getDirectoryName;
-/**
- * Join paths
- * @param paths - Paths to join
- * @returns Joined path
- */
-function joinPaths(...paths) {
-    return normalizePath(paths.join("/"));
-}
-exports.joinPaths = joinPaths;
-/**
- * Escape regex special characters
- * @param str - String to escape
- * @returns Escaped string
- */
-function escapeRegex(str) {
-    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-exports.escapeRegex = escapeRegex;
-/**
- * Calculate relevance score
- * @param text - Text to search in
- * @param query - Query to search for
- * @returns Relevance score (0-1)
- */
-function calculateRelevance(text, query) {
-    if (!query || !text)
-        return 0;
-    // Convert to lowercase for case-insensitive matching
-    const lowerText = text.toLowerCase();
-    const lowerQuery = query.toLowerCase();
-    // Check if the query is in the text
-    if (!lowerText.includes(lowerQuery))
-        return 0;
-    // Calculate relevance based on frequency and position
-    const frequency = (lowerText.match(new RegExp(escapeRegex(lowerQuery), "g")) || []).length;
-    const position = lowerText.indexOf(lowerQuery);
-    const textLength = text.length;
-    // Higher relevance for:
-    // - More occurrences of the query
-    // - Earlier position of the query
-    // - Shorter text (query is more significant in shorter text)
-    const frequencyFactor = Math.min(frequency / 5, 1); // Cap at 1
-    const positionFactor = 1 - position / textLength;
-    const lengthFactor = 1 - Math.min(textLength / 1000, 0.9); // Cap at 0.9
-    return frequencyFactor * 0.4 + positionFactor * 0.4 + lengthFactor * 0.2;
-}
-exports.calculateRelevance = calculateRelevance;
-/**
- * Generate excerpt
- * @param text - Text to generate excerpt from
- * @param query - Query to highlight
- * @param length - Excerpt length
- * @returns Excerpt
- */
-function generateExcerpt(text, query, length = 150) {
-    if (!text)
-        return "";
-    if (!query)
-        return text.substring(0, length);
-    // Find the position of the query
-    const lowerText = text.toLowerCase();
-    const lowerQuery = query.toLowerCase();
-    const position = lowerText.indexOf(lowerQuery);
-    if (position === -1) {
-        // Query not found, return the beginning of the text
-        return text.substring(0, length) + (text.length > length ? "..." : "");
-    }
-    // Calculate start and end positions for the excerpt
-    const halfLength = Math.floor(length / 2);
-    let start = Math.max(0, position - halfLength);
-    let end = Math.min(text.length, position + query.length + halfLength);
-    // Adjust if the excerpt is shorter than the desired length
-    if (end - start < length) {
-        if (start === 0) {
-            end = Math.min(text.length, length);
-        }
-        else if (end === text.length) {
-            start = Math.max(0, text.length - length);
-        }
-    }
-    // Generate the excerpt
-    let excerpt = text.substring(start, end);
-    // Add ellipsis if needed
-    if (start > 0)
-        excerpt = "..." + excerpt;
-    if (end < text.length)
-        excerpt = excerpt + "...";
-    return excerpt;
-}
-exports.generateExcerpt = generateExcerpt;
+// Re-export all utility functions
+export * from "./path.js";
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,cAAc,WAAW,CAAC"}

package/dist/utils/path.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Normalizes a path consistently
+ */
+export declare function normalizePath(p: string): string;
+/**
+ * Expands the home directory in a path (e.g., ~/docs -> /home/user/docs)
+ */
+export declare function expandHome(p: string): string;
+/**
+ * Validates that a path is within allowed directories
+ * @param p The path to validate
+ * @param allowedDirectories Array of allowed directory paths
+ * @returns The normalized path if valid
+ * @throws Error if path is not within allowed directories
+ */
+export declare function validatePath(p: string, allowedDirectories: string[]): Promise<string>;

package/dist/utils/path.js

@@ -0,0 +1,70 @@
+import path from "path";
+import os from "os";
+import fs from "fs/promises";
+/**
+ * Normalizes a path consistently
+ */
+export function normalizePath(p) {
+    return path.normalize(p);
+}
+/**
+ * Expands the home directory in a path (e.g., ~/docs -> /home/user/docs)
+ */
+export function expandHome(p) {
+    if (!p)
+        return p;
+    if (p === "~" || p.startsWith("~/")) {
+        return p.replace(/^~/, os.homedir());
+    }
+    return p;
+}
+/**
+ * Validates that a path is within allowed directories
+ * @param p The path to validate
+ * @param allowedDirectories Array of allowed directory paths
+ * @returns The normalized path if valid
+ * @throws Error if path is not within allowed directories
+ */
+export async function validatePath(p, allowedDirectories) {
+    // Handle empty path by using the first allowed directory
+    if (!p) {
+        return allowedDirectories[0];
+    }
+    // Resolve the path
+    const normalizedPath = normalizePath(path.resolve(expandHome(p)));
+    // Check if the path is exactly an allowed directory
+    if (allowedDirectories.some((dir) => dir === normalizedPath)) {
+        return normalizedPath;
+    }
+    // Check if the path is within any of the allowed directories
+    const isAllowed = allowedDirectories.some((dir) => {
+        const relativePath = path.relative(dir, normalizedPath);
+        return (relativePath !== "" &&
+            !relativePath.startsWith("..") &&
+            !path.isAbsolute(relativePath));
+    });
+    if (!isAllowed) {
+        // Try to resolve the path relative to the allowed directories
+        for (const dir of allowedDirectories) {
+            const resolvedPath = path.resolve(dir, p);
+            try {
+                // Check if the path exists
+                await fs.access(resolvedPath);
+                // If it exists, check if it's within an allowed directory
+                const relativePath = path.relative(dir, resolvedPath);
+                if (relativePath !== "" &&
+                    !relativePath.startsWith("..") &&
+                    !path.isAbsolute(relativePath)) {
+                    return resolvedPath;
+                }
+            }
+            catch (error) {
+                // Path doesn't exist, continue to the next directory
+            }
+        }
+        // If we get here, the path is not allowed
+        throw new Error(`Access denied: ${p} is not within allowed directories. Allowed directories: ${allowedDirectories.join(", ")}`);
+    }
+    return normalizedPath;
+}
+//# sourceMappingURL=path.js.map

package/dist/utils/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,MAAM,aAAa,CAAC;AAE7B;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS;IACrC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,CAAS,EACT,kBAA4B;IAE5B,yDAAyD;IACzD,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,mBAAmB;IACnB,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAElE,oDAAoD;IACpD,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,cAAc,CAAC,EAAE,CAAC;QAC7D,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,6DAA6D;IAC7D,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;QAChD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACxD,OAAO,CACL,YAAY,KAAK,EAAE;YACnB,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC;YAC9B,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAC/B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,8DAA8D;QAC9D,KAAK,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACrC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAC1C,IAAI,CAAC;gBACH,2BAA2B;gBAC3B,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;gBAC9B,0DAA0D;gBAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;gBACtD,IACE,YAAY,KAAK,EAAE;oBACnB,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC;oBAC9B,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAC9B,CAAC;oBACD,OAAO,YAAY,CAAC;gBACtB,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,qDAAqD;YACvD,CAAC;QACH,CAAC;QAED,0CAA0C;QAC1C,MAAM,IAAI,KAAK,CACb,kBAAkB,CAAC,4DAA4D,kBAAkB,CAAC,IAAI,CACpG,IAAI,CACL,EAAE,CACJ,CAAC;IACJ,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "mcp-docs-service",
-  "version": "0.2.0",
+  "version": "0.2.3",
   "description": "MCP Documentation Management Service - A Model Context Protocol implementation for documentation management",
+  "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
@@ -9,9 +10,11 @@
   },
   "scripts": {
     "build": "tsc",
-    "prepublishOnly": "npm run build",
+    "prepare": "npm run build",
+    "watch": "tsc --watch",
     "test": "echo \"No tests yet\" && exit 0",
-    "start": "node dist/cli/bin.js"
+    "start": "node dist/cli/bin.js",
+    "prepare-publish": "node scripts/prepare-publish.js"
   },
   "keywords": [
     "mcp",
@@ -19,23 +22,32 @@
     "cursor",
     "claude",
     "markdown",
-    "model-context-protocol"
+    "model-context-protocol",
+    "knowledge-base",
+    "documentation-management",
+    "llm-context"
   ],
   "author": "Aleks Petrov",
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.6.1",
-    "googleapis": "^146.0.0",
-    "js-yaml": "^4.1.0"
+    "@modelcontextprotocol/sdk": "^0.5.0",
+    "diff": "^7.0.0",
+    "glob": "^11.0.1",
+    "js-yaml": "^4.1.0",
+    "minimatch": "^10.0.1",
+    "zod-to-json-schema": "^3.23.5"
   },
   "devDependencies": {
+    "@types/diff": "^7.0.1",
     "@types/js-yaml": "^4.0.5",
     "@types/node": "^18.0.0",
-    "typescript": "^4.9.0"
+    "shx": "^0.3.4",
+    "typescript": "^5.3.3"
   },
   "files": [
     "dist",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "engines": {

package/dist/cli/index.d.ts

@@ -1,16 +0,0 @@
-/**
- * CLI interface for the MCP Documentation Management Service
- *
- * This script is meant to be run from the command line to start the MCP server.
- * It reads queries from stdin, processes them, and writes results to stdout.
- *
- * Usage:
- *   npx mcp-docs-service [options]
- */
-/**
- * Main function to process stdin commands
- */
-export declare function main(options?: {
-    docsDir: string;
-    createIfNotExists: boolean;
-}): Promise<void>;

package/dist/cli/index.js

@@ -1,108 +0,0 @@
-"use strict";
-/**
- * CLI interface for the MCP Documentation Management Service
- *
- * This script is meant to be run from the command line to start the MCP server.
- * It reads queries from stdin, processes them, and writes results to stdout.
- *
- * Usage:
- *   npx mcp-docs-service [options]
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.main = void 0;
-const index_js_1 = require("../index.js");
-const readline = __importStar(require("readline"));
-const jsonrpc_js_1 = require("./jsonrpc.js");
-/**
- * Main function to process stdin commands
- */
-async function main(options = {
-    docsDir: "./docs",
-    createIfNotExists: false,
-}) {
-    console.error("MCP Documentation Management Service started.");
-    console.error(`Using docs directory: ${options.docsDir}`);
-    if (options.createIfNotExists) {
-        console.error("Will create directory if it doesn't exist");
-    }
-    console.error("Reading from stdin, writing results to stdout...");
-    // Create a custom query function that uses the specified docs directory
-    const query = (sql) => (0, index_js_1.query)(sql, {
-        docsDir: options.docsDir,
-        createIfNotExists: options.createIfNotExists,
-    });
-    // Create readline interface
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-        terminal: false,
-    });
-    // Handle process termination
-    process.on("SIGINT", () => {
-        console.error("\nMCP Documentation Management Service terminated.");
-        process.exit(0);
-    });
-    // Process lines from stdin
-    rl.on("line", async (line) => {
-        if (line.trim()) {
-            try {
-                // Check if the input is a JSON-RPC 2.0 request
-                if (line.trim().startsWith("{") && line.includes('"jsonrpc"')) {
-                    // Process as JSON-RPC 2.0 request
-                    const response = await (0, jsonrpc_js_1.processJsonRpcRequest)(line.trim(), {
-                        docsDir: options.docsDir,
-                        createIfNotExists: options.createIfNotExists,
-                    });
-                    console.log(JSON.stringify(response));
-                }
-                else {
-                    // Process as SQL-like query (legacy mode)
-                    const result = await query(line.trim());
-                    console.log(JSON.stringify(result));
-                }
-            }
-            catch (error) {
-                // Log errors to stderr and write error result to stdout
-                console.error(`Error processing command: ${error instanceof Error ? error.message : String(error)}`);
-                console.log(JSON.stringify({
-                    success: false,
-                    error: error instanceof Error ? error.message : String(error),
-                }));
-            }
-        }
-    });
-    // Handle end of input
-    rl.on("close", () => {
-        console.error("Input stream closed. Waiting for output to flush...");
-        // Add a delay before exiting to ensure all output is flushed
-        setTimeout(() => {
-            console.error("Exiting...");
-            process.exit(0);
-        }, 1000);
-    });
-}
-exports.main = main;
-//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/cli/jsonrpc.d.ts

@@ -1,29 +0,0 @@
-/**
- * JSON-RPC 2.0 handler for MCP Documentation Service
- *
- * This module adds JSON-RPC 2.0 support to the MCP Documentation Service,
- * allowing it to be used with Cursor and other MCP clients.
- */
-interface JsonRpcSuccessResponse {
-    jsonrpc: string;
-    result: any;
-    id: number | string | null;
-}
-interface JsonRpcErrorResponse {
-    jsonrpc: string;
-    error: {
-        code: number;
-        message: string;
-        data?: any;
-    };
-    id: number | string | null;
-}
-type JsonRpcResponse = JsonRpcSuccessResponse | JsonRpcErrorResponse;
-/**
- * Process a JSON-RPC 2.0 request and return a response
- */
-export declare function processJsonRpcRequest(requestStr: string, options: {
-    docsDir: string;
-    createIfNotExists: boolean;
-}): Promise<JsonRpcResponse>;
-export {};

package/dist/cli/jsonrpc.js

@@ -1,121 +0,0 @@
-"use strict";
-/**
- * JSON-RPC 2.0 handler for MCP Documentation Service
- *
- * This module adds JSON-RPC 2.0 support to the MCP Documentation Service,
- * allowing it to be used with Cursor and other MCP clients.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.processJsonRpcRequest = void 0;
-const index_js_1 = require("../index.js");
-/**
- * Process a JSON-RPC 2.0 request and return a response
- */
-async function processJsonRpcRequest(requestStr, options) {
-    try {
-        // Parse the JSON-RPC request
-        const request = JSON.parse(requestStr);
-        // Validate the request
-        if (request.jsonrpc !== "2.0") {
-            return createErrorResponse(request.id, -32600, "Invalid Request: Not a valid JSON-RPC 2.0 request");
-        }
-        // Handle special MCP methods
-        if (request.method === "list_allowed_directories") {
-            return createSuccessResponse(request.id, [options.docsDir]);
-        }
-        // Translate JSON-RPC method and params to SQL-like query
-        const sqlQuery = translateToSqlQuery(request.method, request.params);
-        if (!sqlQuery) {
-            return createErrorResponse(request.id, -32601, `Method not found: ${request.method}`);
-        }
-        // Execute the query
-        const result = await (0, index_js_1.query)(sqlQuery, options);
-        // Translate the result to JSON-RPC response
-        if (result.success) {
-            return createSuccessResponse(request.id, result.data);
-        }
-        else {
-            return createErrorResponse(request.id, -32000, result.error || "Unknown error");
-        }
-    }
-    catch (error) {
-        console.error("Error processing JSON-RPC request:", error);
-        return createErrorResponse(null, -32700, error instanceof Error ? error.message : String(error));
-    }
-}
-exports.processJsonRpcRequest = processJsonRpcRequest;
-/**
- * Translate a JSON-RPC method and params to a SQL-like query
- */
-function translateToSqlQuery(method, params) {
-    switch (method) {
-        case "list_files":
-            return "list_files()";
-        case "list_directories":
-            return "list_directories()";
-        case "get_document":
-            if (!params || !params.path) {
-                throw new Error("Invalid params: path is required");
-            }
-            return `get_document(path="${params.path}")`;
-        case "search_documents":
-            if (!params || !params.query) {
-                throw new Error("Invalid params: query is required");
-            }
-            return `search_documents(query="${params.query}")`;
-        case "create_document":
-            if (!params || !params.path || !params.content) {
-                throw new Error("Invalid params: path and content are required");
-            }
-            return `create_document(path="${params.path}", content="${escapeString(params.content)}")`;
-        case "update_document":
-            if (!params || !params.path || !params.content) {
-                throw new Error("Invalid params: path and content are required");
-            }
-            return `update_document(path="${params.path}", content="${escapeString(params.content)}")`;
-        case "delete_document":
-            if (!params || !params.path) {
-                throw new Error("Invalid params: path is required");
-            }
-            return `delete_document(path="${params.path}")`;
-        case "analyze_docs":
-            return "analyze_docs()";
-        case "get_health_score":
-            return "get_health_score()";
-        case "get_suggestions":
-            return "get_suggestions()";
-        default:
-            return null;
-    }
-}
-/**
- * Create a JSON-RPC 2.0 success response
- */
-function createSuccessResponse(id, result) {
-    return {
-        jsonrpc: "2.0",
-        result,
-        id,
-    };
-}
-/**
- * Create a JSON-RPC 2.0 error response
- */
-function createErrorResponse(id, code, message, data) {
-    return {
-        jsonrpc: "2.0",
-        error: {
-            code,
-            message,
-            data,
-        },
-        id,
-    };
-}
-/**
- * Escape special characters in a string
- */
-function escapeString(str) {
-    return str.replace(/"/g, '\\"').replace(/\n/g, "\\n");
-}
-//# sourceMappingURL=jsonrpc.js.map

package/dist/cli/jsonrpc.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"jsonrpc.js","sourceRoot":"","sources":["../../src/cli/jsonrpc.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,0CAAoC;AA8BpC;;GAEG;AACI,KAAK,UAAU,qBAAqB,CACzC,UAAkB,EAClB,OAGC;IAED,IAAI;QACF,6BAA6B;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAmB,CAAC;QAEzD,uBAAuB;QACvB,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,EAAE;YAC7B,OAAO,mBAAmB,CACxB,OAAO,CAAC,EAAE,EACV,CAAC,KAAK,EACN,mDAAmD,CACpD,CAAC;SACH;QAED,6BAA6B;QAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,0BAA0B,EAAE;YACjD,OAAO,qBAAqB,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;SAC7D;QAED,yDAAyD;QACzD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACrE,IAAI,CAAC,QAAQ,EAAE;YACb,OAAO,mBAAmB,CACxB,OAAO,CAAC,EAAE,EACV,CAAC,KAAK,EACN,qBAAqB,OAAO,CAAC,MAAM,EAAE,CACtC,CAAC;SACH;QAED,oBAAoB;QACpB,MAAM,MAAM,GAAG,MAAM,IAAA,gBAAK,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAE9C,4CAA4C;QAC5C,IAAI,MAAM,CAAC,OAAO,EAAE;YAClB,OAAO,qBAAqB,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;SACvD;aAAM;YACL,OAAO,mBAAmB,CACxB,OAAO,CAAC,EAAE,EACV,CAAC,KAAK,EACN,MAAM,CAAC,KAAK,IAAI,eAAe,CAChC,CAAC;SACH;KACF;IAAC,OAAO,KAAK,EAAE;QACd,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;QAC3D,OAAO,mBAAmB,CACxB,IAAI,EACJ,CAAC,KAAK,EACN,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;KACH;AACH,CAAC;AAxDD,sDAwDC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,MAAc,EAAE,MAAW;IACtD,QAAQ,MAAM,EAAE;QACd,KAAK,YAAY;YACf,OAAO,cAAc,CAAC;QAExB,KAAK,kBAAkB;YACrB,OAAO,oBAAoB,CAAC;QAE9B,KAAK,cAAc;YACjB,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;gBAC3B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;aACrD;YACD,OAAO,sBAAsB,MAAM,CAAC,IAAI,IAAI,CAAC;QAE/C,KAAK,kBAAkB;YACrB,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE;gBAC5B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;aACtD;YACD,OAAO,2BAA2B,MAAM,CAAC,KAAK,IAAI,CAAC;QAErD,KAAK,iBAAiB;YACpB,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;gBAC9C,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;aAClE;YACD,OAAO,yBAAyB,MAAM,CAAC,IAAI,eAAe,YAAY,CACpE,MAAM,CAAC,OAAO,CACf,IAAI,CAAC;QAER,KAAK,iBAAiB;YACpB,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;gBAC9C,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;aAClE;YACD,OAAO,yBAAyB,MAAM,CAAC,IAAI,eAAe,YAAY,CACpE,MAAM,CAAC,OAAO,CACf,IAAI,CAAC;QAER,KAAK,iBAAiB;YACpB,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;gBAC3B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;aACrD;YACD,OAAO,yBAAyB,MAAM,CAAC,IAAI,IAAI,CAAC;QAElD,KAAK,cAAc;YACjB,OAAO,gBAAgB,CAAC;QAE1B,KAAK,kBAAkB;YACrB,OAAO,oBAAoB,CAAC;QAE9B,KAAK,iBAAiB;YACpB,OAAO,mBAAmB,CAAC;QAE7B;YACE,OAAO,IAAI,CAAC;KACf;AACH,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAC5B,EAA0B,EAC1B,MAAW;IAEX,OAAO;QACL,OAAO,EAAE,KAAK;QACd,MAAM;QACN,EAAE;KACH,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAC1B,EAA0B,EAC1B,IAAY,EACZ,OAAe,EACf,IAAU;IAEV,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE;YACL,IAAI;YACJ,OAAO;YACP,IAAI;SACL;QACD,EAAE;KACH,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC"}

package/dist/core/docAnalyzer.d.ts

@@ -1,25 +0,0 @@
-/**
- * Document Analyzer for generating insights about documentation
- */
-import { DocAnalysisResult } from "../types/index.js";
-import { DocManager } from "./docManager.js";
-export declare class DocAnalyzer {
-    private docManager;
-    constructor(docManager: DocManager);
-    /**
-     * Analyze the documentation and generate insights
-     */
-    analyzeDocumentation(directory?: string): Promise<DocAnalysisResult>;
-    /**
-     * Find documentation gaps (directories with few or no documents)
-     */
-    findDocumentationGaps(): Promise<Record<string, number>>;
-    /**
-     * Calculate overall documentation health score (0-100)
-     */
-    calculateHealthScore(): Promise<number>;
-    /**
-     * Generate suggestions for improving documentation
-     */
-    generateSuggestions(): Promise<string[]>;
-}