mcp-docs-service 0.2.0 → 0.2.1

package/dist/utils/path.js

@@ -0,0 +1,39 @@
+import path from "path";
+import os from "os";
+/**
+ * Normalizes a path consistently
+ */
+export function normalizePath(p) {
+    return path.normalize(p);
+}
+/**
+ * Expands the home directory tilde (~) in a path
+ */
+export function expandHome(filepath) {
+    if (filepath.startsWith("~/") || filepath === "~") {
+        return path.join(os.homedir(), filepath.slice(1));
+    }
+    return filepath;
+}
+/**
+ * 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) {
+    const normalizedPath = normalizePath(path.resolve(expandHome(p)));
+    // 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) {
+        throw new Error(`Access denied: ${p} is not within allowed directories`);
+    }
+    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;AAGpB;;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,QAAgB;IACzC,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;QAClD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,CAAS,EACT,kBAA4B;IAE5B,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAElE,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,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,oCAAoC,CAAC,CAAC;IAC3E,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.1",
   "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/bin.d.ts

@@ -1,6 +0,0 @@
-#!/usr/bin/env node
-/**
- * MCP Documentation Management Service CLI
- * This is the entry point for the CLI when run via npx
- */
-export {};

package/dist/cli/bin.js

@@ -1,49 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-/**
- * MCP Documentation Management Service CLI
- * This is the entry point for the CLI when run via npx
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-const index_js_1 = require("./index.js");
-// Parse command line arguments
-const args = process.argv.slice(2);
-const options = {
-    docsDir: "./docs",
-    createIfNotExists: false,
-    help: false,
-};
-// Process arguments
-for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (arg === "--docs-dir" && i + 1 < args.length) {
-        options.docsDir = args[++i];
-    }
-    else if (arg === "--create-dir") {
-        options.createIfNotExists = true;
-    }
-    else if (arg === "--help" || arg === "-h") {
-        options.help = true;
-    }
-}
-// Show help if requested
-if (options.help) {
-    console.log(`
-MCP Documentation Service
-
-Usage:
-  npx mcp-docs-service [options]
-
-Options:
-  --docs-dir <path>  Specify the docs directory (default: ./docs)
-  --create-dir       Create the docs directory if it doesn't exist
-  --help, -h         Show this help message
-  `);
-    process.exit(0);
-}
-// Start the main process
-(0, index_js_1.main)(options).catch((error) => {
-    console.error("Fatal error:", error);
-    process.exit(1);
-});
-//# sourceMappingURL=bin.js.map

package/dist/cli/bin.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":";;AAEA;;;GAGG;;AAEH,yCAAkC;AAElC,+BAA+B;AAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,OAAO,GAAG;IACd,OAAO,EAAE,QAAQ;IACjB,iBAAiB,EAAE,KAAK;IACxB,IAAI,EAAE,KAAK;CACZ,CAAC;AAEF,oBAAoB;AACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAEpB,IAAI,GAAG,KAAK,YAAY,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE;QAC/C,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;KAC7B;SAAM,IAAI,GAAG,KAAK,cAAc,EAAE;QACjC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;KAClC;SAAM,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE;QAC3C,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;KACrB;CACF;AAED,yBAAyB;AACzB,IAAI,OAAO,CAAC,IAAI,EAAE;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;GAUX,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;CACjB;AAED,yBAAyB;AACzB,IAAA,eAAI,EAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC5B,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

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":"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"}

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[]>;
-}

package/dist/core/docAnalyzer.js

@@ -1,118 +0,0 @@
-"use strict";
-/**
- * Document Analyzer for generating insights about documentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DocAnalyzer = void 0;
-class DocAnalyzer {
-    constructor(docManager) {
-        this.docManager = docManager;
-    }
-    /**
-     * Analyze the documentation and generate insights
-     */
-    async analyzeDocumentation(directory) {
-        const summaries = await this.docManager.getAllDocumentSummaries(directory);
-        // Count documents by status
-        const byStatus = {};
-        summaries.forEach((doc) => {
-            const status = doc.status || "undefined";
-            byStatus[status] = (byStatus[status] || 0) + 1;
-        });
-        // Count documents by directory
-        const byDirectory = {};
-        summaries.forEach((doc) => {
-            const dirPath = doc.path.split("/").slice(0, -1).join("/");
-            byDirectory[dirPath] = (byDirectory[dirPath] || 0) + 1;
-        });
-        // Find documents missing descriptions
-        const missingDescriptions = summaries.filter((doc) => !doc.description);
-        // Find recently updated documents (if lastUpdated is available)
-        let recentlyUpdated = [];
-        const docsWithDates = summaries.filter((doc) => doc.lastUpdated);
-        if (docsWithDates.length > 0) {
-            recentlyUpdated = docsWithDates
-                .sort((a, b) => {
-                const dateA = a.lastUpdated ? new Date(a.lastUpdated).getTime() : 0;
-                const dateB = b.lastUpdated ? new Date(b.lastUpdated).getTime() : 0;
-                return dateB - dateA;
-            })
-                .slice(0, 5); // Get the 5 most recently updated
-        }
-        return {
-            documentCount: summaries.length,
-            byStatus,
-            byDirectory,
-            recentlyUpdated,
-            missingDescriptions,
-        };
-    }
-    /**
-     * Find documentation gaps (directories with few or no documents)
-     */
-    async findDocumentationGaps() {
-        const directories = await this.docManager.listDirectories();
-        const gaps = {};
-        for (const dir of directories) {
-            const files = await this.docManager.listMarkdownFiles(dir);
-            if (files.length < 2) {
-                // Consider a directory with less than 2 docs as a gap
-                gaps[dir] = files.length;
-            }
-        }
-        return gaps;
-    }
-    /**
-     * Calculate overall documentation health score (0-100)
-     */
-    async calculateHealthScore() {
-        const summaries = await this.docManager.getAllDocumentSummaries();
-        if (summaries.length === 0) {
-            return 0; // No documents
-        }
-        // Calculate metrics
-        const withDescription = summaries.filter((doc) => doc.description).length;
-        const withTags = summaries.filter((doc) => doc.tags && doc.tags.length > 0).length;
-        const withStatus = summaries.filter((doc) => doc.status).length;
-        // Calculate score components (each worth up to 33.3 points)
-        const descriptionScore = (withDescription / summaries.length) * 33.3;
-        const tagsScore = (withTags / summaries.length) * 33.3;
-        const statusScore = (withStatus / summaries.length) * 33.3;
-        // Calculate the overall score
-        const healthScore = descriptionScore + tagsScore + statusScore;
-        return Math.round(healthScore);
-    }
-    /**
-     * Generate suggestions for improving documentation
-     */
-    async generateSuggestions() {
-        const analysis = await this.analyzeDocumentation();
-        const gaps = await this.findDocumentationGaps();
-        const healthScore = await this.calculateHealthScore();
-        const suggestions = [];
-        // Suggest adding descriptions to documents that lack them
-        if (analysis.missingDescriptions &&
-            analysis.missingDescriptions.length > 0) {
-            suggestions.push(`Add descriptions to ${analysis.missingDescriptions.length} documents that are missing them.`);
-        }
-        // Suggest creating documents in empty or sparse directories
-        if (Object.keys(gaps).length > 0) {
-            for (const [dir, count] of Object.entries(gaps)) {
-                suggestions.push(`Add more documentation to the ${dir} directory (currently has ${count} documents).`);
-            }
-        }
-        // General suggestions based on health score
-        if (healthScore < 50) {
-            suggestions.push("Improve overall documentation quality by adding proper metadata to existing documents.");
-        }
-        // Suggestion for adding status to documents
-        if (analysis.byStatus &&
-            analysis.byStatus["undefined"] &&
-            analysis.byStatus["undefined"] > 0) {
-            suggestions.push(`Add status (draft, review, or published) to ${analysis.byStatus["undefined"]} documents.`);
-        }
-        return suggestions;
-    }
-}
-exports.DocAnalyzer = DocAnalyzer;
-//# sourceMappingURL=docAnalyzer.js.map

package/dist/core/docAnalyzer.js.map

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

package/dist/core/docManager.d.ts

@@ -1,48 +0,0 @@
-/**
- * Document Manager for handling file operations
- */
-import { DocContent, DocCreateParams, DocSummary, DocUpdateParams, SearchOptions } from "../types/index.js";
-export declare class DocManager {
-    private baseDir;
-    private options;
-    constructor(baseDir?: string, options?: {
-        createIfNotExists?: boolean;
-        fileExtensions?: string[];
-    });
-    /**
-     * Initialize the docs directory
-     */
-    private initializeDirectory;
-    /**
-     * List all markdown files in a directory recursively
-     */
-    listMarkdownFiles(dir?: string): Promise<string[]>;
-    /**
-     * Get document content and metadata
-     */
-    getDocument(filePath: string): Promise<DocContent | null>;
-    /**
-     * List directories in the docs folder
-     */
-    listDirectories(dir?: string): Promise<string[]>;
-    /**
-     * Create a new document
-     */
-    createDocument(params: DocCreateParams): Promise<boolean>;
-    /**
-     * Update an existing document
-     */
-    updateDocument(params: DocUpdateParams): Promise<boolean>;
-    /**
-     * Delete a document
-     */
-    deleteDocument(filePath: string): Promise<boolean>;
-    /**
-     * Basic search for documents matching query
-     */
-    searchDocuments(options: SearchOptions): Promise<DocSummary[]>;
-    /**
-     * Get all documents as summaries
-     */
-    getAllDocumentSummaries(directory?: string): Promise<DocSummary[]>;
-}