archtracker-mcp 0.3.1 → 0.4.0

package/README.md

@@ -39,7 +39,7 @@ When AI agents modify code, they **miss cascading impacts**:
 
 ## Features
 
-- **Dependency Graph Analysis** — AST-based static analysis via [dependency-cruiser](https://github.com/sverweij/dependency-cruiser)
+- **Dependency Graph Analysis** — Regex-based static analysis for **13 languages** (JS/TS, Python, Rust, Go, Java, C/C++, C#, Ruby, PHP, Swift, Kotlin, Dart, Scala)
 - **Interactive Web Viewer** — Force-directed graph, hierarchy diagram, diff view with D3.js
 - **Impact Simulation** — Click any file to visualize transitive dependents (BFS traversal)
 - **Snapshot Diffing** — Save architecture snapshots and detect drift over time
@@ -156,6 +156,7 @@ archtracker ci-setup [options]   Generate GitHub Actions workflow
 Options:
   -t, --target <dir>       Target directory (default: "src")
   -r, --root <dir>         Project root (default: ".")
+  -l, --language <lang>    Target language (auto-detected if omitted)
   -p, --port <number>      Port for web viewer (default: 3000)
   -w, --watch              Watch for file changes and auto-reload
   -e, --exclude <pattern>  Exclude patterns (regex)
@@ -251,7 +252,8 @@ The web viewer also supports language switching via the settings panel.
 ## Requirements
 
 - **Node.js** >= 18.0.0
-- **TypeScript / JavaScript** project (for dependency analysis)
+
+Supported languages: JavaScript/TypeScript, Python, Rust, Go, Java, C/C++, C#, Ruby, PHP, Swift, Kotlin, Dart, Scala
 
 ## Contributing
 
@@ -287,7 +289,7 @@ AI エージェントがコードを修正する際、**波及的な影響を見
 
 ## 機能
 
-- **依存関係グラフ分析** — [dependency-cruiser](https://github.com/sverweij/dependency-cruiser) によるAST静的解析
+- **依存関係グラフ分析** — 正規表現ベースの静的解析、**13言語**対応（JS/TS, Python, Rust, Go, Java, C/C++, C#, Ruby, PHP, Swift, Kotlin, Dart, Scala）
 - **インタラクティブ Web ビューア** — D3.js による力学モデルグラフ、階層図、差分ビュー
 - **影響シミュレーション** — ファイルをクリックして推移的な被依存ファイルを可視化（BFS探索）
 - **スナップショット差分** — アーキテクチャスナップショットを保存し、ドリフトを検出
@@ -404,6 +406,7 @@ archtracker ci-setup [options]   GitHub Actions ワークフローを生成
 オプション:
   -t, --target <dir>       対象ディレクトリ（デフォルト: "src"）
   -r, --root <dir>         プロジェクトルート（デフォルト: "."）
+  -l, --language <lang>    対象言語（省略時は自動検出）
   -p, --port <number>      Web ビューアのポート（デフォルト: 3000）
   -w, --watch              ファイル変更の監視と自動リロード
   -e, --exclude <pattern>  除外パターン（正規表現）
@@ -479,7 +482,8 @@ Web ビューアでも設定パネルから言語を切り替え可能です。
 ## 動作要件
 
 - **Node.js** >= 18.0.0
-- **TypeScript / JavaScript** プロジェクト（依存関係分析用）
+
+対応言語: JavaScript/TypeScript, Python, Rust, Go, Java, C/C++, C#, Ruby, PHP, Swift, Kotlin, Dart, Scala
 
 ## コントリビュート
 

package/dist/cli/index.js

@@ -4,128 +4,15 @@
 import { Command } from "commander";
 import { watch } from "fs";
 import { writeFile as writeFile2, mkdir as mkdir2 } from "fs/promises";
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 
 // 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) {
@@ -683,7 +570,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 ?? [],
@@ -930,7 +817,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"],
@@ -1194,7 +1100,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;
@@ -1218,7 +1124,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;
@@ -1241,7 +1147,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;
@@ -1361,7 +1267,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;
   },
@@ -1425,9 +1331,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,
@@ -1447,12 +1391,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}`);
@@ -2981,11 +2931,30 @@ function startViewer(graph, options = {}) {
   };
 }
 
+// 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/cli/index.ts
+var VALID_LANGUAGES = LANGUAGE_IDS;
 var program = new Command();
 program.name("archtracker").description(
   "Architecture & Dependency Tracker \u2014 Prevent missed architecture changes in AI-driven development"
-).version("0.3.1").option("--lang <locale>", "Language (en/ja, auto-detected from LANG env)").hook("preAction", (thisCommand) => {
+).version(VERSION).option("--lang <locale>", "Language (en/ja, auto-detected from LANG env)").hook("preAction", (thisCommand) => {
   const lang = thisCommand.opts().lang;
   if (lang === "en" || lang === "ja") {
     setLocale(lang);
@@ -2994,11 +2963,13 @@ program.name("archtracker").description(
 program.command("init").description("Generate initial snapshot and save to .archtracker/").option("-t, --target <dir>", "Target directory", "src").option("-r, --root <dir>", "Project root", ".").option(
   "-e, --exclude <patterns...>",
   "Exclude patterns (regex)"
-).action(async (opts) => {
+).option("-l, --language <lang>", `Target language (${LANGUAGE_IDS.join(", ")})`).action(async (opts) => {
   try {
+    const language = validateLanguage(opts.language);
     console.log(t("cli.analyzing"));
     const graph = await analyzeProject(opts.target, {
-      exclude: opts.exclude
+      exclude: opts.exclude,
+      language
     });
     const snapshot = await saveSnapshot(opts.root, graph);
     console.log(t("cli.snapshotSaved"));
@@ -3027,11 +2998,13 @@ program.command("analyze").description(
 ).option("-t, --target <dir>", "Target directory", "src").option("-r, --root <dir>", "Project root", ".").option(
   "-e, --exclude <patterns...>",
   "Exclude patterns (regex)"
-).option("-n, --top <number>", "Number of top components to show", "10").option("--save", "Also save a snapshot after analysis").action(async (opts) => {
+).option("-n, --top <number>", "Number of top components to show", "10").option("--save", "Also save a snapshot after analysis").option("-l, --language <lang>", `Target language (${LANGUAGE_IDS.join(", ")})`).action(async (opts) => {
   try {
+    const language = validateLanguage(opts.language);
     console.log(t("cli.analyzing"));
     const graph = await analyzeProject(opts.target, {
-      exclude: opts.exclude
+      exclude: opts.exclude,
+      language
     });
     const report = formatAnalysisReport(graph, { topN: parseInt(opts.top, 10) });
     console.log(report);
@@ -3045,15 +3018,16 @@ program.command("analyze").description(
 });
 program.command("check").description(
   "Compare snapshot with current code and report change impacts"
-).option("-t, --target <dir>", "Target directory", "src").option("-r, --root <dir>", "Project root", ".").option("--ci", "CI mode: exit code 1 if affected files exist").action(async (opts) => {
+).option("-t, --target <dir>", "Target directory", "src").option("-r, --root <dir>", "Project root", ".").option("--ci", "CI mode: exit code 1 if affected files exist").option("-l, --language <lang>", `Target language (${LANGUAGE_IDS.join(", ")})`).action(async (opts) => {
   try {
+    const language = validateLanguage(opts.language);
     const existingSnapshot = await loadSnapshot(opts.root);
     if (!existingSnapshot) {
       console.log(t("cli.noSnapshot"));
       process.exit(1);
     }
     console.log(t("cli.analyzing"));
-    const currentGraph = await analyzeProject(opts.target);
+    const currentGraph = await analyzeProject(opts.target, { language });
     const diff = computeDiff(existingSnapshot.graph, currentGraph);
     const report = formatDiffReport(diff);
     console.log(report);
@@ -3067,12 +3041,13 @@ program.command("check").description(
 });
 program.command("context").description(
   "Display current architecture context (for AI session initialization)"
-).option("-t, --target <dir>", "Target directory", "src").option("-r, --root <dir>", "Project root", ".").option("--json", "Output in JSON format").action(async (opts) => {
+).option("-t, --target <dir>", "Target directory", "src").option("-r, --root <dir>", "Project root", ".").option("--json", "Output in JSON format").option("-l, --language <lang>", `Target language (${LANGUAGE_IDS.join(", ")})`).action(async (opts) => {
   try {
+    const language = validateLanguage(opts.language);
     let snapshot = await loadSnapshot(opts.root);
     if (!snapshot) {
       console.log(t("cli.autoGenerating"));
-      const graph2 = await analyzeProject(opts.target);
+      const graph2 = await analyzeProject(opts.target, { language });
       snapshot = await saveSnapshot(opts.root, graph2);
     }
     const graph = snapshot.graph;
@@ -3110,19 +3085,20 @@ program.command("serve").description(
 ).option("-t, --target <dir>", "Target directory", "src").option("-r, --root <dir>", "Project root", ".").option("-p, --port <number>", "Port number", "3000").option(
   "-e, --exclude <patterns...>",
   "Exclude patterns (regex)"
-).option("-w, --watch", "Watch for file changes and auto-reload").action(async (opts) => {
+).option("-w, --watch", "Watch for file changes and auto-reload").option("-l, --language <lang>", `Target language (${LANGUAGE_IDS.join(", ")})`).action(async (opts) => {
   try {
+    const language = validateLanguage(opts.language);
     console.log(t("web.starting"));
     console.log(t("cli.analyzing"));
     let graph;
     let diff = null;
     const snapshot = await loadSnapshot(opts.root);
     if (snapshot) {
-      const currentGraph = await analyzeProject(opts.target, { exclude: opts.exclude });
+      const currentGraph = await analyzeProject(opts.target, { exclude: opts.exclude, language });
       diff = computeDiff(snapshot.graph, currentGraph);
       graph = currentGraph;
     } else {
-      graph = await analyzeProject(opts.target, { exclude: opts.exclude });
+      graph = await analyzeProject(opts.target, { exclude: opts.exclude, language });
     }
     const port = parseInt(opts.port, 10);
     const viewer = startViewer(graph, { port, diff });
@@ -3136,7 +3112,7 @@ program.command("serve").description(
         debounce = setTimeout(async () => {
           try {
             console.log(t("web.reloading"));
-            const newGraph = await analyzeProject(opts.target, { exclude: opts.exclude });
+            const newGraph = await analyzeProject(opts.target, { exclude: opts.exclude, language });
             viewer.close();
             startViewer(newGraph, { port });
             console.log(t("web.reloaded"));
@@ -3170,15 +3146,22 @@ jobs:
       - run: npx archtracker check --target ${opts.target} --ci
 `;
   try {
-    const dir = join5(".github", "workflows");
+    const dir = join6(".github", "workflows");
     await mkdir2(dir, { recursive: true });
-    const path = join5(dir, "arch-check.yml");
+    const path = join6(dir, "arch-check.yml");
     await writeFile2(path, workflow, "utf-8");
     console.log(t("ci.generated", { path }));
   } catch (error) {
     handleError(error);
   }
 });
+function validateLanguage(lang) {
+  if (!lang) return void 0;
+  if (VALID_LANGUAGES.includes(lang)) return lang;
+  console.error(`Invalid language: ${lang}`);
+  console.error(`Valid languages: ${LANGUAGE_IDS.join(", ")}`);
+  process.exit(1);
+}
 function handleError(error) {
   if (error instanceof AnalyzerError) {
     console.error(t("error.cli.analyzer", { message: error.message }));