archtracker-mcp 0.3.1 → 0.4.0

package/dist/mcp/index.js

@@ -4,125 +4,12 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { z as z2 } from "zod";
 
 // src/analyzer/analyze.ts
-import { resolve as resolve4 } from "path";
-
-// src/analyzer/engines/dependency-cruiser.ts
-import { resolve } from "path";
-import { cruise } from "dependency-cruiser";
-var DEFAULT_EXCLUDE = [
-  "node_modules",
-  "\\.d\\.ts$",
-  "dist",
-  "build",
-  "coverage",
-  "\\.archtracker"
-];
-var DependencyCruiserEngine = class {
-  async analyze(rootDir, options = {}) {
-    const {
-      exclude = [],
-      maxDepth = 0,
-      tsConfigPath,
-      includeTypeOnly = true
-    } = options;
-    const absRootDir = resolve(rootDir);
-    const allExclude = [...DEFAULT_EXCLUDE, ...exclude];
-    const excludePattern = allExclude.join("|");
-    const cruiseOptions = {
-      baseDir: absRootDir,
-      exclude: { path: excludePattern },
-      doNotFollow: { path: "node_modules" },
-      maxDepth,
-      tsPreCompilationDeps: includeTypeOnly ? true : false,
-      combinedDependencies: false
-    };
-    if (tsConfigPath) {
-      cruiseOptions.tsConfig = { fileName: tsConfigPath };
-    }
-    let result;
-    try {
-      result = await cruise(["."], cruiseOptions);
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      throw new Error(`dependency-cruiser failed: ${message}`, {
-        cause: error
-      });
-    }
-    if (result.exitCode !== 0 && !result.output) {
-      throw new Error(`Analysis exited with code ${result.exitCode}`);
-    }
-    const cruiseResult = result.output;
-    return this.buildGraph(absRootDir, cruiseResult);
-  }
-  buildGraph(rootDir, cruiseResult) {
-    const files = {};
-    const edges = [];
-    const circularSet = /* @__PURE__ */ new Set();
-    const circularDependencies = [];
-    for (const mod of cruiseResult.modules) {
-      if (this.isExternalModule(mod)) continue;
-      files[mod.source] = {
-        path: mod.source,
-        exists: !mod.couldNotResolve,
-        dependencies: [],
-        dependents: []
-      };
-    }
-    for (const mod of cruiseResult.modules) {
-      for (const dep of mod.dependencies) {
-        if (dep.couldNotResolve || dep.coreModule) continue;
-        if (!files[mod.source] || this.isExternalDep(dep)) continue;
-        const edgeType = dep.typeOnly ? "type-only" : dep.dynamic ? "dynamic" : "static";
-        edges.push({ source: mod.source, target: dep.resolved, type: edgeType });
-        if (files[mod.source]) {
-          files[mod.source].dependencies.push(dep.resolved);
-        }
-        if (files[dep.resolved]) {
-          files[dep.resolved].dependents.push(mod.source);
-        }
-        if (dep.circular && dep.cycle) {
-          const cyclePath = dep.cycle.map((c) => c.name);
-          const cycleKey = [...cyclePath].sort().join("\u2192");
-          if (!circularSet.has(cycleKey)) {
-            circularSet.add(cycleKey);
-            circularDependencies.push({ cycle: cyclePath });
-          }
-        }
-      }
-    }
-    return {
-      rootDir,
-      files,
-      edges,
-      circularDependencies,
-      totalFiles: Object.keys(files).length,
-      totalEdges: edges.length
-    };
-  }
-  isExternalModule(mod) {
-    if (mod.coreModule) return true;
-    const depTypes = mod.dependencyTypes ?? [];
-    if (depTypes.some((t2) => t2.startsWith("npm") || t2 === "core")) return true;
-    return isExternalPath(mod.source);
-  }
-  isExternalDep(dep) {
-    if (dep.coreModule) return true;
-    if (dep.dependencyTypes.some((t2) => t2.startsWith("npm") || t2 === "core"))
-      return true;
-    return isExternalPath(dep.resolved);
-  }
-};
-function isExternalPath(source) {
-  if (source.startsWith("@")) return true;
-  if (!source.includes("/") && !source.includes("\\") && !source.includes("."))
-    return true;
-  if (source.startsWith("node:")) return true;
-  return false;
-}
+import { resolve as resolve3 } from "path";
+import { stat as stat3 } from "fs/promises";
 
 // src/analyzer/engines/regex-engine.ts
 import { readdir, readFile } from "fs/promises";
-import { join, relative, resolve as resolve2 } from "path";
+import { join, relative, resolve } from "path";
 
 // src/analyzer/engines/cycle.ts
 function detectCycles(edges) {
@@ -680,7 +567,7 @@ var RegexEngine = class {
     this.config = config;
   }
   async analyze(rootDir, options = {}) {
-    const absRootDir = resolve2(rootDir);
+    const absRootDir = resolve(rootDir);
     const excludePatterns = [
       ...this.config.defaultExclude ?? [],
       ...options.exclude ?? [],
@@ -927,7 +814,26 @@ async function scanExtensions(dir, counts, maxDepth, currentDepth) {
 
 // src/analyzer/engines/languages.ts
 import { readFileSync } from "fs";
-import { join as join3, dirname, resolve as resolve3 } from "path";
+import { join as join3, dirname, resolve as resolve2 } from "path";
+
+// src/analyzer/engines/types.ts
+var LANGUAGE_IDS = [
+  "javascript",
+  "python",
+  "rust",
+  "go",
+  "java",
+  "c-cpp",
+  "c-sharp",
+  "ruby",
+  "php",
+  "swift",
+  "kotlin",
+  "dart",
+  "scala"
+];
+
+// src/analyzer/engines/languages.ts
 var python = {
   id: "python",
   extensions: [".py"],
@@ -1191,7 +1097,7 @@ var cCpp = {
     { regex: /^#include\s+"([^"]+)"/gm }
   ],
   resolveImport(importPath, sourceFile, rootDir, projectFiles) {
-    const fromSource = resolve3(dirname(sourceFile), importPath);
+    const fromSource = resolve2(dirname(sourceFile), importPath);
     if (projectFiles.has(fromSource)) return fromSource;
     const fromRoot = join3(rootDir, importPath);
     if (projectFiles.has(fromRoot)) return fromRoot;
@@ -1215,7 +1121,7 @@ var ruby = {
   ],
   resolveImport(importPath, sourceFile, rootDir, projectFiles) {
     const withExt = importPath.endsWith(".rb") ? importPath : importPath + ".rb";
-    const fromSource = resolve3(dirname(sourceFile), withExt);
+    const fromSource = resolve2(dirname(sourceFile), withExt);
     if (projectFiles.has(fromSource)) return fromSource;
     const fromRoot = join3(rootDir, withExt);
     if (projectFiles.has(fromRoot)) return fromRoot;
@@ -1238,7 +1144,7 @@ var php = {
   resolveImport(importPath, sourceFile, rootDir, projectFiles) {
     if (importPath.includes("/") || importPath.endsWith(".php")) {
       const withExt = importPath.endsWith(".php") ? importPath : importPath + ".php";
-      const fromSource = resolve3(dirname(sourceFile), withExt);
+      const fromSource = resolve2(dirname(sourceFile), withExt);
       if (projectFiles.has(fromSource)) return fromSource;
       const fromRoot2 = join3(rootDir, withExt);
       if (projectFiles.has(fromRoot2)) return fromRoot2;
@@ -1358,7 +1264,7 @@ var dart = {
       if (projectFiles.has(full)) return full;
       return null;
     }
-    const resolved = resolve3(dirname(sourceFile), importPath);
+    const resolved = resolve2(dirname(sourceFile), importPath);
     if (projectFiles.has(resolved)) return resolved;
     return null;
   },
@@ -1422,9 +1328,47 @@ var scala = {
   },
   defaultExclude: ["target", "\\.bsp", "\\.metals", "\\.bloop"]
 };
+var javascript = {
+  id: "javascript",
+  extensions: [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"],
+  commentStyle: "c-style",
+  importPatterns: [
+    // ES6: import [type] [stuff from] "path"
+    { regex: /import\s+(?:type\s+)?(?:[\w*{}\s,]+\s+from\s+)?["']([^"']+)["']/g },
+    // Dynamic: import("path")
+    { regex: /\bimport\s*\(\s*["']([^"']+)["']\s*\)/g },
+    // Re-export: export [type] { stuff } from "path" / export * from "path"
+    { regex: /export\s+(?:type\s+)?(?:\{[^}]*\}|\*(?:\s+as\s+\w+)?)\s+from\s+["']([^"']+)["']/g },
+    // CommonJS: require("path")
+    { regex: /\brequire\s*\(\s*["']([^"']+)["']\s*\)/g }
+  ],
+  resolveImport(importPath, sourceFile, rootDir, projectFiles) {
+    if (importPath.startsWith("node:")) return null;
+    if (!importPath.startsWith(".")) return null;
+    const resolved = resolve2(dirname(sourceFile), importPath);
+    if (projectFiles.has(resolved)) return resolved;
+    if (resolved.endsWith(".js")) {
+      const tsPath = resolved.slice(0, -3) + ".ts";
+      if (projectFiles.has(tsPath)) return tsPath;
+      const tsxPath = resolved.slice(0, -3) + ".tsx";
+      if (projectFiles.has(tsxPath)) return tsxPath;
+    }
+    if (resolved.endsWith(".jsx")) {
+      const tsxPath = resolved.slice(0, -4) + ".tsx";
+      if (projectFiles.has(tsxPath)) return tsxPath;
+    }
+    for (const ext of [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]) {
+      if (projectFiles.has(resolved + ext)) return resolved + ext;
+    }
+    for (const idx of ["/index.ts", "/index.tsx", "/index.js", "/index.jsx"]) {
+      if (projectFiles.has(resolved + idx)) return resolved + idx;
+    }
+    return null;
+  },
+  defaultExclude: ["node_modules", "\\.d\\.ts$", "dist", "build", "coverage"]
+};
 var LANGUAGE_CONFIGS = {
-  javascript: null,
-  // handled by DependencyCruiserEngine
+  javascript,
   python,
   rust,
   go,
@@ -1444,12 +1388,18 @@ function getLanguageConfig(id) {
 
 // src/analyzer/analyze.ts
 async function analyzeProject(rootDir, options = {}) {
-  const absRootDir = resolve4(rootDir);
-  const language = options.language ?? await detectLanguage(absRootDir);
+  const absRootDir = resolve3(rootDir);
   try {
-    if (language === "javascript") {
-      return await new DependencyCruiserEngine().analyze(absRootDir, options);
+    const s = await stat3(absRootDir);
+    if (!s.isDirectory()) {
+      throw new AnalyzerError(`Not a directory: ${absRootDir}`);
     }
+  } catch (error) {
+    if (error instanceof AnalyzerError) throw error;
+    throw new AnalyzerError(`Directory not found: ${absRootDir}`, { cause: error });
+  }
+  const language = options.language ?? await detectLanguage(absRootDir);
+  try {
     const config = getLanguageConfig(language);
     if (!config) {
       throw new AnalyzerError(`No analyzer config for language: ${language}`);
@@ -1964,10 +1914,10 @@ function arraysEqual(a, b) {
 }
 
 // src/utils/path-guard.ts
-import { resolve as resolve5 } from "path";
+import { resolve as resolve4 } from "path";
 function validatePath(inputPath, boundary) {
-  const resolved = resolve5(inputPath);
-  const root = boundary ? resolve5(boundary) : process.cwd();
+  const resolved = resolve4(inputPath);
+  const root = boundary ? resolve4(boundary) : process.cwd();
   if (!resolved.startsWith(root)) {
     throw new PathTraversalError(
       t("pathGuard.traversal", { input: inputPath, resolved, boundary: root })
@@ -1982,19 +1932,44 @@ var PathTraversalError = class extends Error {
   }
 };
 
+// src/utils/version.ts
+import { readFileSync as readFileSync2 } from "fs";
+import { join as join5, dirname as dirname2 } from "path";
+import { fileURLToPath } from "url";
+function loadVersion() {
+  let dir = dirname2(fileURLToPath(import.meta.url));
+  for (let i = 0; i < 5; i++) {
+    try {
+      const pkg = JSON.parse(readFileSync2(join5(dir, "package.json"), "utf-8"));
+      return pkg.version;
+    } catch {
+      dir = dirname2(dir);
+    }
+  }
+  return "0.0.0";
+}
+var VERSION = loadVersion();
+
 // src/mcp/index.ts
 var server = new McpServer({
   name: "archtracker",
-  version: "0.3.1"
+  version: VERSION
 });
+var languageEnum = z2.enum(LANGUAGE_IDS);
+var LANG_DISPLAY = {
+  javascript: "JS/TS",
+  "c-cpp": "C/C++",
+  "c-sharp": "C#"
+};
+var languageList = LANGUAGE_IDS.map((id) => LANG_DISPLAY[id] ?? id.charAt(0).toUpperCase() + id.slice(1)).join(", ");
 server.tool(
   "generate_map",
-  "Analyze dependency graph of a directory and return file import/export structure as JSON. Supports JS/TS, Python, Rust, Go, Java, C/C++, C#, Ruby, PHP, Swift, Kotlin, Dart, Scala.",
+  `Analyze dependency graph of a directory and return file import/export structure as JSON. Supports ${languageList}.`,
   {
     targetDir: z2.string().default("src").describe("Target directory path (default: src)"),
     exclude: z2.array(z2.string()).optional().describe("Array of regex patterns to exclude (e.g. ['test', 'mock'])"),
     maxDepth: z2.number().int().min(0).optional().describe("Max analysis depth (0 = unlimited)"),
-    language: z2.enum(["javascript", "python", "rust", "go", "java", "c-cpp", "c-sharp", "ruby", "php", "swift", "kotlin", "dart", "scala"]).optional().describe("Target language (auto-detected if omitted)")
+    language: languageEnum.optional().describe("Target language (auto-detected if omitted)")
   },
   async ({ targetDir, exclude, maxDepth, language }) => {
     try {
@@ -2017,14 +1992,14 @@ server.tool(
 );
 server.tool(
   "analyze_existing_architecture",
-  "Comprehensive architecture analysis for existing projects. Shows critical components, circular dependencies, orphan files, coupling hotspots, and directory breakdown. Supports 13 languages.",
+  `Comprehensive architecture analysis for existing projects. Shows critical components, circular dependencies, orphan files, coupling hotspots, and directory breakdown. Supports ${LANGUAGE_IDS.length} languages.`,
   {
     targetDir: z2.string().default("src").describe("Target directory path (default: src)"),
     exclude: z2.array(z2.string()).optional().describe("Array of regex patterns to exclude"),
     topN: z2.number().int().min(1).max(50).optional().describe("Number of top items to show in each section (default: 10)"),
     saveSnapshot: z2.boolean().optional().describe("Also save a snapshot after analysis (default: false)"),
     projectRoot: z2.string().default(".").describe("Project root (needed only when saveSnapshot is true)"),
-    language: z2.enum(["javascript", "python", "rust", "go", "java", "c-cpp", "c-sharp", "ruby", "php", "swift", "kotlin", "dart", "scala"]).optional().describe("Target language (auto-detected if omitted)")
+    language: languageEnum.optional().describe("Target language (auto-detected if omitted)")
   },
   async ({ targetDir, exclude, topN, saveSnapshot: doSave, projectRoot, language }) => {
     try {
@@ -2051,7 +2026,7 @@ server.tool(
   {
     targetDir: z2.string().default("src").describe("Target directory path"),
     projectRoot: z2.string().default(".").describe("Project root (where .archtracker is placed)"),
-    language: z2.enum(["javascript", "python", "rust", "go", "java", "c-cpp", "c-sharp", "ruby", "php", "swift", "kotlin", "dart", "scala"]).optional().describe("Target language (auto-detected if omitted)")
+    language: languageEnum.optional().describe("Target language (auto-detected if omitted)")
   },
   async ({ targetDir, projectRoot, language }) => {
     try {
@@ -2081,7 +2056,7 @@ server.tool(
   {
     targetDir: z2.string().default("src").describe("Target directory path"),
     projectRoot: z2.string().default(".").describe("Project root (where .archtracker is placed)"),
-    language: z2.enum(["javascript", "python", "rust", "go", "java", "c-cpp", "c-sharp", "ruby", "php", "swift", "kotlin", "dart", "scala"]).optional().describe("Target language (auto-detected if omitted)")
+    language: languageEnum.optional().describe("Target language (auto-detected if omitted)")
   },
   async ({ targetDir, projectRoot, language }) => {
     try {
@@ -2119,7 +2094,7 @@ server.tool(
   {
     targetDir: z2.string().default("src").describe("Target directory path"),
     projectRoot: z2.string().default(".").describe("Project root"),
-    language: z2.enum(["javascript", "python", "rust", "go", "java", "c-cpp", "c-sharp", "ruby", "php", "swift", "kotlin", "dart", "scala"]).optional().describe("Target language (auto-detected if omitted)")
+    language: languageEnum.optional().describe("Target language (auto-detected if omitted)")
   },
   async ({ targetDir, projectRoot, language }) => {
     try {
@@ -2179,7 +2154,7 @@ server.tool(
     targetDir: z2.string().default("src").describe("Target directory path"),
     projectRoot: z2.string().default(".").describe("Project root"),
     limit: z2.number().int().min(1).max(50).optional().describe("Max results (default: 10)"),
-    language: z2.enum(["javascript", "python", "rust", "go", "java", "c-cpp", "c-sharp", "ruby", "php", "swift", "kotlin", "dart", "scala"]).optional().describe("Target language (auto-detected if omitted)")
+    language: languageEnum.optional().describe("Target language (auto-detected if omitted)")
   },
   async ({ query, mode, targetDir, projectRoot, limit, language }) => {
     try {