@arabold/docs-mcp-server 1.14.0 → 1.15.0

package/dist/FindVersionTool-Dfw5Lbql.js

@@ -1,140 +0,0 @@
-import { j as ScrapeMode, T as ToolError, k as HtmlPipeline, M as MarkdownPipeline, l as logger, m as ScraperError, V as VersionNotFoundError } from "./DocumentManagementService-BZ_ZZgPI.js";
-class FetchUrlTool {
-  /**
-   * Collection of fetchers that will be tried in order for a given URL.
-   */
-  fetchers;
-  constructor(httpFetcher, fileFetcher) {
-    this.fetchers = [httpFetcher, fileFetcher];
-  }
-  /**
-   * Fetches content from a URL and converts it to Markdown.
-   * Supports both HTTP/HTTPS URLs and local file URLs (file://).
-   * @returns The processed Markdown content
-   * @throws {ToolError} If fetching or processing fails
-   */
-  async execute(options) {
-    const { url, scrapeMode = ScrapeMode.Auto } = options;
-    const canFetchResults = this.fetchers.map((f) => f.canFetch(url));
-    const fetcherIndex = canFetchResults.findIndex((result) => result === true);
-    if (fetcherIndex === -1) {
-      throw new ToolError(
-        `Invalid URL: ${url}. Must be an HTTP/HTTPS URL or a file:// URL.`,
-        this.constructor.name
-      );
-    }
-    const fetcher = this.fetchers[fetcherIndex];
-    const htmlPipeline = new HtmlPipeline();
-    const markdownPipeline = new MarkdownPipeline();
-    const pipelines = [htmlPipeline, markdownPipeline];
-    try {
-      logger.info(`📡 Fetching ${url}...`);
-      const rawContent = await fetcher.fetch(url, {
-        followRedirects: options.followRedirects ?? true,
-        maxRetries: 3
-      });
-      logger.info("🔄 Processing content...");
-      let processed;
-      for (const pipeline of pipelines) {
-        if (pipeline.canProcess(rawContent)) {
-          processed = await pipeline.process(
-            rawContent,
-            {
-              url,
-              library: "",
-              version: "",
-              maxDepth: 0,
-              maxPages: 1,
-              maxConcurrency: 1,
-              scope: "subpages",
-              followRedirects: options.followRedirects ?? true,
-              excludeSelectors: void 0,
-              ignoreErrors: false,
-              scrapeMode
-            },
-            fetcher
-          );
-          break;
-        }
-      }
-      if (!processed) {
-        logger.warn(
-          `Unsupported content type "${rawContent.mimeType}" for ${url}. Returning raw content.`
-        );
-        const contentString = typeof rawContent.content === "string" ? rawContent.content : Buffer.from(rawContent.content).toString("utf-8");
-        return contentString;
-      }
-      for (const err of processed.errors) {
-        logger.warn(`Processing error for ${url}: ${err.message}`);
-      }
-      if (typeof processed.textContent !== "string" || !processed.textContent.trim()) {
-        throw new ToolError(
-          `Processing resulted in empty content for ${url}`,
-          this.constructor.name
-        );
-      }
-      logger.info(`✅ Successfully processed ${url}`);
-      return processed.textContent;
-    } catch (error) {
-      if (error instanceof ScraperError || error instanceof ToolError) {
-        throw new ToolError(
-          `Failed to fetch or process URL: ${error.message}`,
-          this.constructor.name
-        );
-      }
-      throw new ToolError(
-        `Failed to fetch or process URL: ${error instanceof Error ? error.message : String(error)}`,
-        this.constructor.name
-      );
-    } finally {
-      await htmlPipeline.close();
-      await markdownPipeline.close();
-    }
-  }
-}
-class FindVersionTool {
-  docService;
-  constructor(docService) {
-    this.docService = docService;
-  }
-  /**
-   * Executes the tool to find the best matching version and checks for unversioned docs.
-   * @returns A descriptive string indicating the best match and unversioned status, or an error message.
-   */
-  async execute(options) {
-    const { library, targetVersion } = options;
-    const targetVersionString = targetVersion ? `@${targetVersion}` : "";
-    try {
-      const { bestMatch, hasUnversioned } = await this.docService.findBestVersion(
-        library,
-        targetVersion
-      );
-      let message = "";
-      if (bestMatch) {
-        message = `Best match: ${bestMatch}.`;
-        if (hasUnversioned) {
-          message += " Unversioned docs also available.";
-        }
-      } else if (hasUnversioned) {
-        message = `No matching version found for ${library}${targetVersionString}, but unversioned docs exist.`;
-      } else {
-        message = `No matching version or unversioned documents found for ${library}${targetVersionString}.`;
-      }
-      return message;
-    } catch (error) {
-      if (error instanceof VersionNotFoundError) {
-        logger.info(`ℹ️ Version not found: ${error.message}`);
-        return `No matching version or unversioned documents found for ${library}${targetVersionString}. Available: ${error.availableVersions.length > 0 ? error.availableVersions.map((v) => v.version).join(", ") : "None"}.`;
-      }
-      logger.error(
-        `❌ Error finding version for ${library}${targetVersionString}: ${error instanceof Error ? error.message : error}`
-      );
-      throw error;
-    }
-  }
-}
-export {
-  FetchUrlTool as F,
-  FindVersionTool as a
-};
-//# sourceMappingURL=FindVersionTool-Dfw5Lbql.js.map

package/dist/FindVersionTool-Dfw5Lbql.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"FindVersionTool-Dfw5Lbql.js","sources":["../src/tools/FetchUrlTool.ts","../src/tools/FindVersionTool.ts"],"sourcesContent":["import type {\n  ContentFetcher,\n  FileFetcher,\n  HttpFetcher,\n  RawContent,\n} from \"../scraper/fetcher\";\nimport { HtmlPipeline } from \"../scraper/pipelines/HtmlPipeline\";\nimport { MarkdownPipeline } from \"../scraper/pipelines/MarkdownPipeline\";\nimport { ScrapeMode } from \"../scraper/types\";\nimport { ScraperError } from \"../utils/errors\";\nimport { logger } from \"../utils/logger\";\nimport { ToolError } from \"./errors\";\n\nexport interface FetchUrlToolOptions {\n  /**\n   * The URL to fetch and convert to markdown.\n   * Must be a valid HTTP/HTTPS URL or file:// URL.\n   */\n  url: string;\n\n  /**\n   * Whether to follow HTTP redirects.\n   * @default true\n   */\n  followRedirects?: boolean;\n\n  /**\n   * Determines the HTML processing strategy.\n   * - 'fetch': Use a simple DOM parser (faster, less JS support).\n   * - 'playwright': Use a headless browser (slower, full JS support).\n   * - 'auto': Automatically select the best strategy (currently defaults to 'playwright').\n   * @default ScrapeMode.Auto\n   */\n  scrapeMode?: ScrapeMode;\n}\n\n/**\n * Tool for fetching a single URL and converting its content to Markdown.\n * Unlike scrape_docs, this tool only processes one page without crawling\n * or storing the content.\n *\n * Supports both HTTP/HTTPS URLs and local file URLs (file://).\n */\nexport class FetchUrlTool {\n  /**\n   * Collection of fetchers that will be tried in order for a given URL.\n   */\n  private readonly fetchers: ContentFetcher[];\n\n  constructor(httpFetcher: HttpFetcher, fileFetcher: FileFetcher) {\n    this.fetchers = [httpFetcher, fileFetcher];\n  }\n\n  /**\n   * Fetches content from a URL and converts it to Markdown.\n   * Supports both HTTP/HTTPS URLs and local file URLs (file://).\n   * @returns The processed Markdown content\n   * @throws {ToolError} If fetching or processing fails\n   */\n  async execute(options: FetchUrlToolOptions): Promise<string> {\n    const { url, scrapeMode = ScrapeMode.Auto } = options;\n\n    const canFetchResults = this.fetchers.map((f) => f.canFetch(url));\n    const fetcherIndex = canFetchResults.findIndex((result) => result === true);\n    if (fetcherIndex === -1) {\n      throw new ToolError(\n        `Invalid URL: ${url}. Must be an HTTP/HTTPS URL or a file:// URL.`,\n        this.constructor.name,\n      );\n    }\n\n    const fetcher = this.fetchers[fetcherIndex];\n    const htmlPipeline = new HtmlPipeline();\n    const markdownPipeline = new MarkdownPipeline();\n    const pipelines = [htmlPipeline, markdownPipeline];\n\n    try {\n      logger.info(`📡 Fetching ${url}...`);\n      const rawContent: RawContent = await fetcher.fetch(url, {\n        followRedirects: options.followRedirects ?? true,\n        maxRetries: 3,\n      });\n\n      logger.info(\"🔄 Processing content...\");\n\n      let processed: Awaited<ReturnType<(typeof htmlPipeline)[\"process\"]>> | undefined;\n      for (const pipeline of pipelines) {\n        if (pipeline.canProcess(rawContent)) {\n          processed = await pipeline.process(\n            rawContent,\n            {\n              url,\n              library: \"\",\n              version: \"\",\n              maxDepth: 0,\n              maxPages: 1,\n              maxConcurrency: 1,\n              scope: \"subpages\",\n              followRedirects: options.followRedirects ?? true,\n              excludeSelectors: undefined,\n              ignoreErrors: false,\n              scrapeMode,\n            },\n            fetcher,\n          );\n          break;\n        }\n      }\n\n      if (!processed) {\n        logger.warn(\n          `Unsupported content type \"${rawContent.mimeType}\" for ${url}. Returning raw content.`,\n        );\n        const contentString =\n          typeof rawContent.content === \"string\"\n            ? rawContent.content\n            : Buffer.from(rawContent.content).toString(\"utf-8\");\n        return contentString;\n      }\n\n      for (const err of processed.errors) {\n        logger.warn(`Processing error for ${url}: ${err.message}`);\n      }\n\n      if (typeof processed.textContent !== \"string\" || !processed.textContent.trim()) {\n        throw new ToolError(\n          `Processing resulted in empty content for ${url}`,\n          this.constructor.name,\n        );\n      }\n\n      logger.info(`✅ Successfully processed ${url}`);\n      return processed.textContent;\n    } catch (error) {\n      if (error instanceof ScraperError || error instanceof ToolError) {\n        throw new ToolError(\n          `Failed to fetch or process URL: ${error.message}`,\n          this.constructor.name,\n        );\n      }\n      throw new ToolError(\n        `Failed to fetch or process URL: ${error instanceof Error ? error.message : String(error)}`,\n        this.constructor.name,\n      );\n    } finally {\n      await htmlPipeline.close();\n      await markdownPipeline.close();\n    }\n  }\n}\n","import type { DocumentManagementService } from \"../store\";\nimport { logger } from \"../utils/logger\";\nimport { VersionNotFoundError } from \"./errors\";\n\nexport interface FindVersionToolOptions {\n  library: string;\n  targetVersion?: string;\n}\n\n/**\n * Tool for finding the best matching version of a library in the store.\n * Supports exact version matches and X-Range patterns (e.g., '5.x', '5.2.x').\n */\nexport class FindVersionTool {\n  private docService: DocumentManagementService;\n\n  constructor(docService: DocumentManagementService) {\n    this.docService = docService;\n  }\n\n  /**\n   * Executes the tool to find the best matching version and checks for unversioned docs.\n   * @returns A descriptive string indicating the best match and unversioned status, or an error message.\n   */\n  async execute(options: FindVersionToolOptions): Promise<string> {\n    const { library, targetVersion } = options;\n    const targetVersionString = targetVersion ? `@${targetVersion}` : \"\";\n\n    try {\n      const { bestMatch, hasUnversioned } = await this.docService.findBestVersion(\n        library,\n        targetVersion,\n      );\n\n      let message = \"\";\n      if (bestMatch) {\n        message = `Best match: ${bestMatch}.`;\n        if (hasUnversioned) {\n          message += \" Unversioned docs also available.\";\n        }\n      } else if (hasUnversioned) {\n        message = `No matching version found for ${library}${targetVersionString}, but unversioned docs exist.`;\n      } else {\n        // This case should ideally be caught by VersionNotFoundError below,\n        // but added for completeness.\n        message = `No matching version or unversioned documents found for ${library}${targetVersionString}.`;\n      }\n      return message;\n    } catch (error) {\n      if (error instanceof VersionNotFoundError) {\n        // This error is thrown when no semver versions AND no unversioned docs exist.\n        logger.info(`ℹ️ Version not found: ${error.message}`);\n        return `No matching version or unversioned documents found for ${library}${targetVersionString}. Available: ${\n          error.availableVersions.length > 0\n            ? error.availableVersions.map((v) => v.version).join(\", \")\n            : \"None\"\n        }.`;\n      }\n      // Re-throw unexpected errors\n      logger.error(\n        `❌ Error finding version for ${library}${targetVersionString}: ${error instanceof Error ? error.message : error}`,\n      );\n      throw error;\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/RemoveTool-w8KGOaXw.js

@@ -1,65 +0,0 @@
-import { l as logger, T as ToolError } from "./DocumentManagementService-BZ_ZZgPI.js";
-class ListJobsTool {
-  manager;
-  // Change property name and type
-  /**
-   * Creates an instance of ListJobsTool.
-   * @param manager The PipelineManager instance.
-   */
-  constructor(manager) {
-    this.manager = manager;
-  }
-  /**
-   * Executes the tool to retrieve a list of pipeline jobs.
-   * @param input - The input parameters, optionally including a status filter.
-   * @returns A promise that resolves with the list of simplified job objects.
-   * @throws {PipelineStateError} If the pipeline manager is somehow unavailable.
-   */
-  async execute(input) {
-    const jobs = await this.manager.getJobs(input.status);
-    const simplifiedJobs = jobs.map(
-      (job) => ({
-        id: job.id,
-        library: job.library,
-        version: job.version,
-        status: job.status,
-        createdAt: job.createdAt.toISOString(),
-        startedAt: job.startedAt?.toISOString() ?? null,
-        finishedAt: job.finishedAt?.toISOString() ?? null,
-        error: job.error?.message ?? null
-      })
-    );
-    return { jobs: simplifiedJobs };
-  }
-}
-class RemoveTool {
-  constructor(documentManagementService) {
-    this.documentManagementService = documentManagementService;
-  }
-  /**
-   * Executes the tool to remove the specified library version documents.
-   * Assumes args have been validated by the caller (McpServer) against inputSchema.
-   * Returns a simple success message or throws an error.
-   */
-  async execute(args) {
-    const { library, version } = args;
-    logger.info(
-      `Removing library: ${library}${version ? `, version: ${version}` : " (unversioned)"}`
-    );
-    try {
-      await this.documentManagementService.removeAllDocuments(library, version);
-      const message = `Successfully removed documents for ${library}${version ? `@${version}` : " (unversioned)"}.`;
-      logger.info(message);
-      return { message };
-    } catch (error) {
-      const errorMessage = `Failed to remove documents for ${library}${version ? `@${version}` : " (unversioned)"}: ${error instanceof Error ? error.message : String(error)}`;
-      logger.error(`Error removing library: ${errorMessage}`);
-      throw new ToolError(errorMessage, this.constructor.name);
-    }
-  }
-}
-export {
-  ListJobsTool as L,
-  RemoveTool as R
-};
-//# sourceMappingURL=RemoveTool-w8KGOaXw.js.map

package/dist/RemoveTool-w8KGOaXw.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"RemoveTool-w8KGOaXw.js","sources":["../src/tools/ListJobsTool.ts","../src/tools/RemoveTool.ts"],"sourcesContent":["import type { PipelineManager } from \"../pipeline/PipelineManager\";\nimport type { PipelineJob, PipelineJobStatus } from \"../pipeline/types\";\nimport type { JobInfo } from \"./GetJobInfoTool\"; // Import JobInfo\n\n/**\n * Input parameters for the ListJobsTool.\n */\nexport interface ListJobsInput {\n  /** Optional status to filter jobs by. */\n  status?: PipelineJobStatus;\n}\n\n/**\n * Response structure for the ListJobsTool.\n */\nexport interface ListJobsToolResponse {\n  jobs: JobInfo[];\n}\n\n/**\n * Tool for listing pipeline jobs managed by the PipelineManager.\n * Allows filtering jobs by their status.\n */\nexport class ListJobsTool {\n  private manager: PipelineManager; // Change property name and type\n\n  /**\n   * Creates an instance of ListJobsTool.\n   * @param manager The PipelineManager instance.\n   */\n  constructor(manager: PipelineManager) {\n    // Change constructor parameter\n    this.manager = manager;\n  }\n\n  /**\n   * Executes the tool to retrieve a list of pipeline jobs.\n   * @param input - The input parameters, optionally including a status filter.\n   * @returns A promise that resolves with the list of simplified job objects.\n   * @throws {PipelineStateError} If the pipeline manager is somehow unavailable.\n   */\n  async execute(input: ListJobsInput): Promise<ListJobsToolResponse> {\n    const jobs = await this.manager.getJobs(input.status);\n\n    // Transform jobs into simplified objects\n    const simplifiedJobs: JobInfo[] = jobs.map(\n      (job: PipelineJob): JobInfo => ({\n        id: job.id,\n        library: job.library,\n        version: job.version,\n        status: job.status,\n        createdAt: job.createdAt.toISOString(),\n        startedAt: job.startedAt?.toISOString() ?? null,\n        finishedAt: job.finishedAt?.toISOString() ?? null,\n        error: job.error?.message ?? null,\n      }),\n    );\n\n    return { jobs: simplifiedJobs };\n  }\n}\n","import type { DocumentManagementService } from \"../store\";\nimport { logger } from \"../utils/logger\";\nimport { ToolError } from \"./errors\";\n\n/**\n * Represents the arguments for the remove_docs tool.\n * The MCP server should validate the input against RemoveToolInputSchema before calling execute.\n */\nexport interface RemoveToolArgs {\n  library: string;\n  version?: string;\n}\n\n/**\n * Tool to remove indexed documentation for a specific library version.\n * This class provides the core logic, intended to be called by the McpServer.\n */\nexport class RemoveTool {\n  constructor(private readonly documentManagementService: DocumentManagementService) {}\n\n  /**\n   * Executes the tool to remove the specified library version documents.\n   * Assumes args have been validated by the caller (McpServer) against inputSchema.\n   * Returns a simple success message or throws an error.\n   */\n  async execute(args: RemoveToolArgs): Promise<{ message: string }> {\n    const { library, version } = args;\n\n    logger.info(\n      `Removing library: ${library}${version ? `, version: ${version}` : \" (unversioned)\"}`,\n    );\n\n    try {\n      // Core logic: Call the document management service\n      await this.documentManagementService.removeAllDocuments(library, version);\n\n      const message = `Successfully removed documents for ${library}${version ? `@${version}` : \" (unversioned)\"}.`;\n      logger.info(message);\n      // Return a simple success object, the McpServer will format the final response\n      return { message };\n    } catch (error) {\n      const errorMessage = `Failed to remove documents for ${library}${version ? `@${version}` : \" (unversioned)\"}: ${error instanceof Error ? error.message : String(error)}`;\n      logger.error(`Error removing library: ${errorMessage}`);\n      // Re-throw the error for the McpServer to handle and format\n      throw new ToolError(errorMessage, this.constructor.name);\n    }\n  }\n}\n"],"names":[],"mappings":";AAuBO,MAAM,aAAa;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMR,YAAY,SAA0B;AAEpC,SAAK,UAAU;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASjB,MAAM,QAAQ,OAAqD;AACjE,UAAM,OAAO,MAAM,KAAK,QAAQ,QAAQ,MAAM,MAAM;AAGpD,UAAM,iBAA4B,KAAK;AAAA,MACrC,CAAC,SAA+B;AAAA,QAC9B,IAAI,IAAI;AAAA,QACR,SAAS,IAAI;AAAA,QACb,SAAS,IAAI;AAAA,QACb,QAAQ,IAAI;AAAA,QACZ,WAAW,IAAI,UAAU,YAAY;AAAA,QACrC,WAAW,IAAI,WAAW,YAAiB,KAAA;AAAA,QAC3C,YAAY,IAAI,YAAY,YAAiB,KAAA;AAAA,QAC7C,OAAO,IAAI,OAAO,WAAW;AAAA,MAC/B;AAAA,IACF;AAEO,WAAA,EAAE,MAAM,eAAe;AAAA,EAAA;AAElC;AC3CO,MAAM,WAAW;AAAA,EACtB,YAA6B,2BAAsD;AAAtD,SAAA,4BAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO7B,MAAM,QAAQ,MAAoD;AAC1D,UAAA,EAAE,SAAS,QAAA,IAAY;AAEtB,WAAA;AAAA,MACL,qBAAqB,OAAO,GAAG,UAAU,cAAc,OAAO,KAAK,gBAAgB;AAAA,IACrF;AAEI,QAAA;AAEF,YAAM,KAAK,0BAA0B,mBAAmB,SAAS,OAAO;AAElE,YAAA,UAAU,sCAAsC,OAAO,GAAG,UAAU,IAAI,OAAO,KAAK,gBAAgB;AAC1G,aAAO,KAAK,OAAO;AAEnB,aAAO,EAAE,QAAQ;AAAA,aACV,OAAO;AACd,YAAM,eAAe,kCAAkC,OAAO,GAAG,UAAU,IAAI,OAAO,KAAK,gBAAgB,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAC/J,aAAA,MAAM,2BAA2B,YAAY,EAAE;AAEtD,YAAM,IAAI,UAAU,cAAc,KAAK,YAAY,IAAI;AAAA,IAAA;AAAA,EACzD;AAEJ;"}

package/dist/cli.js

@@ -1,236 +0,0 @@
-#!/usr/bin/env node
-import "dotenv/config";
-import { Command } from "commander";
-import { D as DocumentManagementService, a as PipelineManager, H as HttpFetcher, F as FileFetcher, S as SearchTool, e as ScrapeTool, f as ListLibrariesTool, c as DEFAULT_MAX_PAGES, b as DEFAULT_MAX_DEPTH, i as DEFAULT_MAX_CONCURRENCY, j as ScrapeMode, s as setLogLevel, d as LogLevel } from "./DocumentManagementService-BZ_ZZgPI.js";
-import "semver";
-import { F as FetchUrlTool, a as FindVersionTool } from "./FindVersionTool-Dfw5Lbql.js";
-const name = "@arabold/docs-mcp-server";
-const version = "1.13.0";
-const description = "MCP server for fetching and searching documentation";
-const type = "module";
-const bin = { "docs-server": "dist/server.js", "docs-cli": "dist/cli.js", "docs-web": "dist/web.js" };
-const license = "MIT";
-const repository = { "type": "git", "url": "git+https://github.com/arabold/docs-mcp-server.git" };
-const files = ["dist", "public", "db", "README.md", "LICENSE", "package.json"];
-const scripts = { "prepare": "husky || true", "build": "vite build --config vite.config.web.ts && vite build", "start": "node --enable-source-maps dist/server.js", "dev:cli": "vite build && node --enable-source-maps dist/cli.js", "dev:server": "vite-node --watch src/server.ts", "dev:server:stdio": "vite-node --watch src/server.ts -- --protocol stdio", "dev:server:http": "vite-node --watch src/server.ts -- --protocol http", "dev:web": "npm-run-all --parallel watch:web web", "watch:web": "vite build --config vite.config.web.ts --watch", "cli": "node --enable-source-maps dist/cli.js", "server": "vite-node --watch src/server.ts", "web": "vite-node --watch src/web.ts", "test": "vitest run", "test:watch": "vitest", "test:coverage": "vitest run --coverage", "lint": "biome check .", "format": "biome format . --write", "postinstall": "npx playwright install --no-shell --with-deps chromium" };
-const dependencies = { "@fastify/formbody": "^8.0.2", "@fastify/static": "^8.1.1", "@joplin/turndown-plugin-gfm": "^1.0.61", "@kitajs/html": "^4.2.7", "@kitajs/ts-html-plugin": "^4.1.1", "@langchain/aws": "^0.1.8", "@langchain/community": "^0.3.34", "@langchain/google-genai": "^0.2.3", "@langchain/google-vertexai": "^0.2.4", "@langchain/openai": "^0.5.0", "@modelcontextprotocol/sdk": "^1.10.2", "alpinejs": "^3.14.9", "axios": "^1.8.3", "axios-retry": "^4.5.0", "better-sqlite3": "^11.9.1", "cheerio": "^1.0.0", "commander": "^13.1.0", "dompurify": "^3.2.5", "dotenv": "^16.4.7", "env-paths": "^3.0.0", "fastify": "^5.3.0", "flowbite": "^3.1.2", "fuse.js": "^7.1.0", "header-generator": "^2.1.66", "htmx.org": "^1.9.12", "jsdom": "^26.0.0", "langchain": "0.3.19", "playwright": "^1.52.0", "psl": "^1.15.0", "remark": "^15.0.1", "remark-gfm": "^4.0.1", "remark-html": "^16.0.1", "semver": "^7.7.1", "sqlite-vec": "^0.1.7-alpha.2", "turndown": "^7.2.0", "zod": "^3.24.2" };
-const devDependencies = { "@biomejs/biome": "1.9.4", "@commitlint/cli": "^19.8.0", "@commitlint/config-conventional": "^19.8.0", "@semantic-release/changelog": "^6.0.3", "@semantic-release/git": "^10.0.1", "@semantic-release/github": "^11.0.1", "@semantic-release/npm": "^12.0.1", "@tailwindcss/postcss": "^4.1.4", "@tailwindcss/vite": "^4.1.4", "@types/alpinejs": "^3.13.11", "@types/better-sqlite3": "^7.6.12", "@types/jsdom": "~21.1.7", "@types/lint-staged": "~13.3.0", "@types/node": "^20.17.23", "@types/node-fetch": "^2.6.12", "@types/psl": "^1.1.3", "@types/semver": "^7.5.8", "@types/turndown": "^5.0.5", "autoprefixer": "^10.4.21", "flowbite-typography": "^1.0.5", "husky": "^9.1.7", "lint-staged": "^15.5.0", "memfs": "^4.17.0", "npm-run-all": "^4.1.5", "postcss": "^8.5.3", "semantic-release": "^24.2.3", "tailwindcss": "^4.1.4", "typescript": "^5.8.2", "vite": "^6.2.1", "vite-node": "^3.1.2", "vite-plugin-dts": "^4.5.3", "vitest": "^3.0.8" };
-const engines = { "node": ">=20.0.0" };
-const packageJson = {
-  name,
-  version,
-  description,
-  type,
-  bin,
-  license,
-  repository,
-  files,
-  scripts,
-  dependencies,
-  devDependencies,
-  engines,
-  "lint-staged": { "*.{js,ts,jsx,tsx,json,md}": ["biome check --apply --no-errors-on-unmatched", "biome format --write --no-errors-on-unmatched"] }
-};
-const formatOutput = (data) => JSON.stringify(data, null, 2);
-async function main() {
-  let docService;
-  let pipelineManager;
-  try {
-    docService = new DocumentManagementService();
-    await docService.initialize();
-    pipelineManager = new PipelineManager(docService);
-    await pipelineManager.start();
-    const tools = {
-      listLibraries: new ListLibrariesTool(docService),
-      findVersion: new FindVersionTool(docService),
-      scrape: new ScrapeTool(docService, pipelineManager),
-      // Pass manager
-      search: new SearchTool(docService),
-      fetchUrl: new FetchUrlTool(new HttpFetcher(), new FileFetcher())
-    };
-    const program = new Command();
-    process.on("SIGINT", async () => {
-      if (pipelineManager) await pipelineManager.stop();
-      if (docService) await docService.shutdown();
-      process.exit(0);
-    });
-    program.name("docs-mcp").description("CLI for managing documentation vector store").version(packageJson.version).option("--verbose", "Enable verbose (debug) logging", false).option("--silent", "Disable all logging except errors", false);
-    program.command("scrape <library> <url>").description("Scrape and index documentation from a URL").option("-v, --version <string>", "Version of the library (optional)").option(
-      "-p, --max-pages <number>",
-      "Maximum pages to scrape",
-      DEFAULT_MAX_PAGES.toString()
-    ).option(
-      "-d, --max-depth <number>",
-      "Maximum navigation depth",
-      DEFAULT_MAX_DEPTH.toString()
-    ).option(
-      "-c, --max-concurrency <number>",
-      "Maximum concurrent page requests",
-      DEFAULT_MAX_CONCURRENCY.toString()
-    ).option("--ignore-errors", "Ignore errors during scraping", true).option(
-      "--scope <scope>",
-      "Crawling boundary: 'subpages' (default), 'hostname', or 'domain'",
-      (value) => {
-        const validScopes = ["subpages", "hostname", "domain"];
-        if (!validScopes.includes(value)) {
-          console.warn(`Warning: Invalid scope '${value}'. Using default 'subpages'.`);
-          return "subpages";
-        }
-        return value;
-      },
-      "subpages"
-    ).option(
-      "--no-follow-redirects",
-      "Disable following HTTP redirects (default: follow redirects)"
-    ).option(
-      "--scrape-mode <mode>",
-      `HTML processing strategy: '${ScrapeMode.Fetch}', '${ScrapeMode.Playwright}', '${ScrapeMode.Auto}' (default)`,
-      (value) => {
-        const validModes = Object.values(ScrapeMode);
-        if (!validModes.includes(value)) {
-          console.warn(
-            `Warning: Invalid scrape mode '${value}'. Using default '${ScrapeMode.Auto}'.`
-          );
-          return ScrapeMode.Auto;
-        }
-        return value;
-      },
-      ScrapeMode.Auto
-      // Use enum default
-    ).action(async (library, url, options) => {
-      const result = await tools.scrape.execute({
-        url,
-        library,
-        version: options.version,
-        // Get version from options
-        options: {
-          maxPages: Number.parseInt(options.maxPages),
-          maxDepth: Number.parseInt(options.maxDepth),
-          maxConcurrency: Number.parseInt(options.maxConcurrency),
-          ignoreErrors: options.ignoreErrors,
-          scope: options.scope,
-          followRedirects: options.followRedirects,
-          // This will be `true` by default, or `false` if --no-follow-redirects is used
-          scrapeMode: options.scrapeMode
-          // Pass the new scrapeMode option
-        }
-        // CLI always waits for completion (default behavior)
-      });
-      if ("pagesScraped" in result) {
-        console.log(`✅ Successfully scraped ${result.pagesScraped} pages`);
-      } else {
-        console.log(`🚀 Scraping job started with ID: ${result.jobId}`);
-      }
-    });
-    program.command("search <library> <query>").description(
-      "Search documents in a library. Version matching examples:\n  - search react --version 18.0.0 'hooks' -> matches docs for React 18.0.0 or earlier versions\n  - search react --version 18.0.0 'hooks' --exact-match -> only matches React 18.0.0\n  - search typescript --version 5.x 'types' -> matches any TypeScript 5.x.x version\n  - search typescript --version 5.2.x 'types' -> matches any TypeScript 5.2.x version"
-    ).option(
-      "-v, --version <string>",
-      // Add optional version flag
-      "Version of the library (optional, supports ranges)"
-    ).option("-l, --limit <number>", "Maximum number of results", "5").option(
-      "-e, --exact-match",
-      "Only use exact version match (e.g., '18.0.0' matches only 18.0.0, not 17.x.x) (default: false)",
-      false
-    ).action(async (library, query, options) => {
-      const result = await tools.search.execute({
-        library,
-        version: options.version,
-        // Get version from options
-        query,
-        limit: Number.parseInt(options.limit),
-        exactMatch: options.exactMatch
-      });
-      console.log(formatOutput(result.results));
-    });
-    program.command("list").description("List all available libraries and their versions").action(async () => {
-      const result = await tools.listLibraries.execute();
-      console.log(formatOutput(result.libraries));
-    });
-    program.command("find-version <library>").description("Find the best matching version for a library").option(
-      "-v, --version <string>",
-      // Add optional version flag
-      "Pattern to match (optional, supports ranges)"
-    ).action(async (library, options) => {
-      const versionInfo = await tools.findVersion.execute({
-        library,
-        targetVersion: options.version
-        // Get version from options
-      });
-      if (!versionInfo) {
-        throw new Error("Failed to get version information");
-      }
-      console.log(versionInfo);
-    });
-    program.command("remove <library>").description("Remove documents for a specific library and version").option(
-      "-v, --version <string>",
-      "Version to remove (optional, removes unversioned if omitted)"
-    ).action(async (library, options) => {
-      if (!docService) {
-        throw new Error("Document service not initialized.");
-      }
-      const { version: version2 } = options;
-      try {
-        await docService.removeAllDocuments(library, version2);
-        console.log(
-          `✅ Successfully removed documents for ${library}${version2 ? `@${version2}` : " (unversioned)"}.`
-        );
-      } catch (error) {
-        console.error(
-          `❌ Failed to remove documents for ${library}${version2 ? `@${version2}` : " (unversioned)"}:`,
-          error instanceof Error ? error.message : String(error)
-        );
-        throw error;
-      }
-    });
-    program.command("fetch-url <url>").description("Fetch a URL and convert its content to Markdown").option(
-      "--no-follow-redirects",
-      "Disable following HTTP redirects (default: follow redirects)"
-    ).option(
-      "--scrape-mode <mode>",
-      `HTML processing strategy: '${ScrapeMode.Fetch}', '${ScrapeMode.Playwright}', '${ScrapeMode.Auto}' (default)`,
-      (value) => {
-        const validModes = Object.values(ScrapeMode);
-        if (!validModes.includes(value)) {
-          console.warn(
-            `Warning: Invalid scrape mode '${value}'. Using default '${ScrapeMode.Auto}'.`
-          );
-          return ScrapeMode.Auto;
-        }
-        return value;
-      },
-      ScrapeMode.Auto
-      // Use enum default
-    ).action(async (url, options) => {
-      const content = await tools.fetchUrl.execute({
-        url,
-        followRedirects: options.followRedirects,
-        scrapeMode: options.scrapeMode
-        // Pass the scrapeMode option
-      });
-      console.log(content);
-    });
-    program.hook("preAction", (thisCommand) => {
-      const options = thisCommand.opts();
-      if (options.silent) {
-        setLogLevel(LogLevel.ERROR);
-      } else if (options.verbose) {
-        setLogLevel(LogLevel.DEBUG);
-      }
-    });
-    await program.parseAsync();
-  } catch (error) {
-    console.error("Error:", error instanceof Error ? error.message : String(error));
-    if (pipelineManager) await pipelineManager.stop();
-    if (docService) await docService.shutdown();
-    process.exit(1);
-  }
-  if (pipelineManager) await pipelineManager.stop();
-  await docService.shutdown();
-  process.exit(0);
-}
-main().catch((error) => {
-  console.error("Fatal error:", error);
-  process.exit(1);
-});
-//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.js","sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport \"dotenv/config\";\nimport { Command } from \"commander\";\nimport packageJson from \"../package.json\";\nimport { PipelineManager } from \"./pipeline/PipelineManager\";\nimport { FileFetcher, HttpFetcher } from \"./scraper/fetcher\";\nimport { ScrapeMode } from \"./scraper/types\"; // Import ScrapeMode enum\nimport { DocumentManagementService } from \"./store/DocumentManagementService\";\nimport {\n  FetchUrlTool,\n  FindVersionTool,\n  ListLibrariesTool,\n  ScrapeTool,\n  SearchTool,\n} from \"./tools\";\nimport {\n  DEFAULT_MAX_CONCURRENCY,\n  DEFAULT_MAX_DEPTH,\n  DEFAULT_MAX_PAGES,\n} from \"./utils/config\";\nimport { LogLevel, setLogLevel } from \"./utils/logger\";\n\nconst formatOutput = (data: unknown) => JSON.stringify(data, null, 2);\n\nasync function main() {\n  let docService: DocumentManagementService | undefined;\n  let pipelineManager: PipelineManager | undefined;\n\n  try {\n    docService = new DocumentManagementService();\n    await docService.initialize();\n\n    // Instantiate PipelineManager for CLI use\n    pipelineManager = new PipelineManager(docService); // Assign inside try\n    // Start the manager for the CLI session\n    await pipelineManager.start();\n\n    const tools = {\n      listLibraries: new ListLibrariesTool(docService),\n      findVersion: new FindVersionTool(docService),\n      scrape: new ScrapeTool(docService, pipelineManager), // Pass manager\n      search: new SearchTool(docService),\n      fetchUrl: new FetchUrlTool(new HttpFetcher(), new FileFetcher()),\n    };\n\n    const program = new Command();\n\n    // Handle cleanup on SIGINT\n    process.on(\"SIGINT\", async () => {\n      if (pipelineManager) await pipelineManager.stop(); // Check before stopping\n      if (docService) await docService.shutdown(); // Check before stopping\n      process.exit(0);\n    });\n\n    program\n      .name(\"docs-mcp\")\n      .description(\"CLI for managing documentation vector store\")\n      .version(packageJson.version)\n      // Add global options for logging level\n      .option(\"--verbose\", \"Enable verbose (debug) logging\", false)\n      .option(\"--silent\", \"Disable all logging except errors\", false);\n\n    program\n      .command(\"scrape <library> <url>\") // Remove <version> as positional\n      .description(\"Scrape and index documentation from a URL\")\n      .option(\"-v, --version <string>\", \"Version of the library (optional)\") // Add optional version flag\n      .option(\n        \"-p, --max-pages <number>\",\n        \"Maximum pages to scrape\",\n        DEFAULT_MAX_PAGES.toString(),\n      )\n      .option(\n        \"-d, --max-depth <number>\",\n        \"Maximum navigation depth\",\n        DEFAULT_MAX_DEPTH.toString(),\n      )\n      .option(\n        \"-c, --max-concurrency <number>\",\n        \"Maximum concurrent page requests\",\n        DEFAULT_MAX_CONCURRENCY.toString(),\n      )\n      .option(\"--ignore-errors\", \"Ignore errors during scraping\", true)\n      .option(\n        \"--scope <scope>\",\n        \"Crawling boundary: 'subpages' (default), 'hostname', or 'domain'\",\n        (value) => {\n          const validScopes = [\"subpages\", \"hostname\", \"domain\"];\n          if (!validScopes.includes(value)) {\n            console.warn(`Warning: Invalid scope '${value}'. Using default 'subpages'.`);\n            return \"subpages\";\n          }\n          return value;\n        },\n        \"subpages\",\n      )\n      .option(\n        \"--no-follow-redirects\",\n        \"Disable following HTTP redirects (default: follow redirects)\",\n      )\n      .option(\n        \"--scrape-mode <mode>\",\n        `HTML processing strategy: '${ScrapeMode.Fetch}', '${ScrapeMode.Playwright}', '${ScrapeMode.Auto}' (default)`,\n        (value: string): ScrapeMode => {\n          const validModes = Object.values(ScrapeMode);\n          if (!validModes.includes(value as ScrapeMode)) {\n            console.warn(\n              `Warning: Invalid scrape mode '${value}'. Using default '${ScrapeMode.Auto}'.`,\n            );\n            return ScrapeMode.Auto;\n          }\n          return value as ScrapeMode; // Cast to enum type\n        },\n        ScrapeMode.Auto, // Use enum default\n      )\n      .action(async (library, url, options) => {\n        // Update action parameters\n        const result = await tools.scrape.execute({\n          url,\n          library,\n          version: options.version, // Get version from options\n          options: {\n            maxPages: Number.parseInt(options.maxPages),\n            maxDepth: Number.parseInt(options.maxDepth),\n            maxConcurrency: Number.parseInt(options.maxConcurrency),\n            ignoreErrors: options.ignoreErrors,\n            scope: options.scope,\n            followRedirects: options.followRedirects, // This will be `true` by default, or `false` if --no-follow-redirects is used\n            scrapeMode: options.scrapeMode, // Pass the new scrapeMode option\n          },\n          // CLI always waits for completion (default behavior)\n        });\n        // Type guard to satisfy TypeScript\n        if (\"pagesScraped\" in result) {\n          console.log(`✅ Successfully scraped ${result.pagesScraped} pages`);\n        } else {\n          // This branch should not be hit by the CLI\n          console.log(`🚀 Scraping job started with ID: ${result.jobId}`);\n        }\n      });\n\n    program\n      .command(\"search <library> <query>\") // Remove <version> as positional\n      .description(\n        \"Search documents in a library. Version matching examples:\\n\" +\n          \"  - search react --version 18.0.0 'hooks' -> matches docs for React 18.0.0 or earlier versions\\n\" +\n          \"  - search react --version 18.0.0 'hooks' --exact-match -> only matches React 18.0.0\\n\" +\n          \"  - search typescript --version 5.x 'types' -> matches any TypeScript 5.x.x version\\n\" +\n          \"  - search typescript --version 5.2.x 'types' -> matches any TypeScript 5.2.x version\",\n      )\n      .option(\n        \"-v, --version <string>\", // Add optional version flag\n        \"Version of the library (optional, supports ranges)\",\n      )\n      .option(\"-l, --limit <number>\", \"Maximum number of results\", \"5\")\n      .option(\n        \"-e, --exact-match\",\n        \"Only use exact version match (e.g., '18.0.0' matches only 18.0.0, not 17.x.x) (default: false)\",\n        false,\n      )\n      .action(async (library, query, options) => {\n        // Update action parameters\n        const result = await tools.search.execute({\n          library,\n          version: options.version, // Get version from options\n          query,\n          limit: Number.parseInt(options.limit),\n          exactMatch: options.exactMatch,\n        });\n        console.log(formatOutput(result.results));\n      });\n\n    program\n      .command(\"list\")\n      .description(\"List all available libraries and their versions\")\n      .action(async () => {\n        const result = await tools.listLibraries.execute();\n        console.log(formatOutput(result.libraries));\n      });\n\n    program\n      .command(\"find-version <library>\") // Remove [targetVersion] positional\n      .description(\"Find the best matching version for a library\")\n      .option(\n        \"-v, --version <string>\", // Add optional version flag\n        \"Pattern to match (optional, supports ranges)\",\n      )\n      .action(async (library, options) => {\n        // Update action parameters\n        const versionInfo = await tools.findVersion.execute({\n          library,\n          targetVersion: options.version, // Get version from options\n        });\n        // findVersion.execute now returns a string, handle potential error messages within it\n        if (!versionInfo) {\n          // Should not happen with current tool logic, but good practice\n          throw new Error(\"Failed to get version information\");\n        }\n        console.log(versionInfo); // Log the descriptive string from the tool\n      });\n\n    program\n      .command(\"remove <library>\") // Library as positional argument\n      .description(\"Remove documents for a specific library and version\")\n      .option(\n        \"-v, --version <string>\",\n        \"Version to remove (optional, removes unversioned if omitted)\",\n      )\n      .action(async (library, options) => {\n        // library is now the first arg\n        if (!docService) {\n          throw new Error(\"Document service not initialized.\");\n        }\n        const { version } = options; // Get version from options\n        try {\n          await docService.removeAllDocuments(library, version);\n          console.log(\n            `✅ Successfully removed documents for ${library}${version ? `@${version}` : \" (unversioned)\"}.`,\n          );\n        } catch (error) {\n          console.error(\n            `❌ Failed to remove documents for ${library}${version ? `@${version}` : \" (unversioned)\"}:`,\n            error instanceof Error ? error.message : String(error),\n          );\n          // Re-throw to trigger the main catch block for shutdown\n          throw error;\n        }\n      });\n\n    program\n      .command(\"fetch-url <url>\")\n      .description(\"Fetch a URL and convert its content to Markdown\")\n      .option(\n        \"--no-follow-redirects\",\n        \"Disable following HTTP redirects (default: follow redirects)\",\n      )\n      .option(\n        \"--scrape-mode <mode>\",\n        `HTML processing strategy: '${ScrapeMode.Fetch}', '${ScrapeMode.Playwright}', '${ScrapeMode.Auto}' (default)`,\n        (value: string): ScrapeMode => {\n          const validModes = Object.values(ScrapeMode);\n          if (!validModes.includes(value as ScrapeMode)) {\n            console.warn(\n              `Warning: Invalid scrape mode '${value}'. Using default '${ScrapeMode.Auto}'.`,\n            );\n            return ScrapeMode.Auto;\n          }\n          return value as ScrapeMode; // Cast to enum type\n        },\n        ScrapeMode.Auto, // Use enum default\n      )\n      .action(async (url, options) => {\n        const content = await tools.fetchUrl.execute({\n          url,\n          followRedirects: options.followRedirects,\n          scrapeMode: options.scrapeMode, // Pass the scrapeMode option\n        });\n        console.log(content);\n      });\n\n    // Hook to set log level after parsing global options but before executing command action\n    program.hook(\"preAction\", (thisCommand) => {\n      // Global options are attached to the program (thisCommand)\n      const options = thisCommand.opts();\n      if (options.silent) {\n        // If silent is true, it overrides verbose\n        setLogLevel(LogLevel.ERROR);\n      } else if (options.verbose) {\n        setLogLevel(LogLevel.DEBUG);\n      }\n      // Otherwise, the default LogLevel.INFO remains set from logger.ts\n    });\n\n    await program.parseAsync();\n  } catch (error) {\n    console.error(\"Error:\", error instanceof Error ? error.message : String(error));\n    if (pipelineManager) await pipelineManager.stop(); // Check before stopping\n    if (docService) await docService.shutdown();\n    process.exit(1);\n  }\n\n  // Clean shutdown after successful execution\n  if (pipelineManager) await pipelineManager.stop(); // Check before stopping\n  await docService.shutdown();\n  process.exit(0);\n}\n\nmain().catch((error) => {\n  console.error(\"Fatal error:\", error);\n  process.exit(1);\n});\n"],"names":["version"],"mappings":"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"}