project-graph-mcp 1.0.0 → 1.1.0

package/README.md

@@ -1,6 +1,6 @@
 # project-graph-mcp
 
-**MCP server for AI agents** — project graph, code quality analysis, and framework-specific lint rules.
+**MCP server for AI agents** — multi-language project graph, code quality analysis, and framework-specific lint rules.
 
 > Developed by [RND-PRO](https://rnd-pro.com)
 
@@ -14,6 +14,7 @@ AI agents struggle with large codebases:
 
 **Project Graph MCP solves this:**
 - 📦 **10-50x compression** — skeleton view fits in context window
+- 🌐 **Multi-language** — JavaScript, TypeScript, Python, Go
 - 🔍 **Code quality analysis** — dead code, complexity, duplicates
 - 🎯 **Framework-specific rules** — auto-detect and apply (React, Vue, Express, Node.js, Symbiote)
 - ✅ **Test checklists** — track @test/@expect annotations
@@ -26,6 +27,9 @@ AI agents struggle with large codebases:
 - `deps` — Dependency tree for any symbol
 - `usages` — Find all usages of a symbol
 - `get_focus_zone` — Auto-enriched context from git diff
+- `get_call_chain` — BFS call path analysis between symbols
+
+**Supported languages:** JavaScript (AST via Acorn), TypeScript/TSX, Python, Go — all with unified ParseResult API.
 
 ### 🧪 Test Checklists (Universal)
 - `get_pending_tests` — List tests from `@test/@expect` JSDoc annotations
@@ -79,12 +83,29 @@ Every tool response includes contextual coaching hints:
 - **Workspace Isolation** — MCP roots set workspace boundary, tools cannot escape it
 
 ### 🌐 MCP Ecosystem
-Works alongside [agent-pool-mcp](https://github.com/rnd-pro/agent-pool-mcp) for parallel agent orchestration:
+Best used together with [**agent-pool-mcp**](https://www.npmjs.com/package/agent-pool-mcp) — multi-agent task delegation via Gemini CLI:
 
 | Layer | project-graph-mcp | agent-pool-mcp |
 |-------|-------------------|----------------|
 | **Primary IDE agent** | Navigates codebase, runs analysis | Delegates tasks, consults peer |
-| **Gemini CLI workers** | Available as MCP tool inside Gemini CLI | Executes delegated tasks |
+| **Gemini CLI workers** | Available as MCP tool inside workers | Executes delegated tasks |
+
+Combined config for both:
+
+```json
+{
+  "mcpServers": {
+    "project-graph": {
+      "command": "npx",
+      "args": ["-y", "project-graph-mcp"]
+    },
+    "agent-pool": {
+      "command": "npx",
+      "args": ["-y", "agent-pool-mcp"]
+    }
+  }
+}
+```
 
 ## Installation
 
@@ -236,7 +257,11 @@ project-graph-mcp/
 │   ├── tool-defs.js          # MCP tool schemas
 │   ├── tools.js              # Graph tools (skeleton, expand, deps)
 │   ├── workspace.js          # Path resolution + traversal protection
-│   ├── parser.js             # AST parser (Acorn)
+│   ├── parser.js             # AST parser (Acorn) + language routing
+│   ├── lang-typescript.js    # TypeScript/TSX regex parser
+│   ├── lang-python.js        # Python regex parser
+│   ├── lang-go.js            # Go regex parser
+│   ├── lang-utils.js         # Shared: stripStringsAndComments
 │   ├── graph-builder.js      # Minified graph + legend
 │   ├── filters.js            # Exclude patterns, .gitignore
 │   ├── dead-code.js          # Unused code detection

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "project-graph-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "type": "module",
-  "description": "MCP server for AI agents — AST-based project graph, code quality analysis, and framework-specific lint rules. Zero dependencies.",
+  "description": "MCP server for AI agents — multi-language project graph (JS, TS, Python, Go), code quality analysis, and framework-specific lint rules. Zero dependencies.",
   "main": "src/server.js",
   "bin": {
     "project-graph-mcp": "src/server.js"
@@ -32,7 +32,11 @@
     "dead-code",
     "complexity",
     "lint",
-    "gemini"
+    "gemini",
+    "typescript",
+    "python",
+    "golang",
+    "multi-language"
   ],
   "repository": {
     "type": "git",
@@ -43,4 +47,4 @@
   "engines": {
     "node": ">=18.0.0"
   }
-}
+}

package/src/.project-graph-cache.json

@@ -0,0 +1 @@
+{"version":1,"path":"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src","mtimes":{"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/cli-handlers.js":1770656908396.6091,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/cli.js":1770402560025.795,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/complexity.js":1770659410318.8738,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/custom-rules.js":1772229894400.4248,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/dead-code.js":1771039661152.3376,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/filters.js":1773680641811.5923,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/framework-references.js":1772230204706.0527,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/full-analysis.js":1770398073907.7559,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/graph-builder.js":1773699507591.4272,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/instructions.js":1770399269998.5479,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/jsdoc-generator.js":1770659484514.0476,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/lang-go.js":1773698053155.2214,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/lang-python.js":1773699559544.998,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/lang-typescript.js":1773698053134.5566,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/lang-utils.js":1773697910333.1853,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/large-files.js":1770659415051.0068,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/mcp-server.js":1773680723694.6929,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/outdated-patterns.js":1770659431382.597,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/parser.js":1773683193338.3542,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/server.js":1773497829401.444,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/similar-functions.js":1770659421339.757,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/test-annotations.js":1772223332771.1304,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/tool-defs.js":1773680708907.4548,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/tools.js":1773699507598.5554,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/undocumented.js":1770659436429.1372,"/Users/v.matiyasevich/Documents/GitHub/project-graph-mcp/src/workspace.js":1773699468757.9526},"graph":{"v":1,"legend":{"getArg":"gA","getPath":"gP","printHelp":"pH","runCLI":"CLI","findJSFiles":"JSF","calculateComplexity":"cC","getRating":"gR","analyzeFile":"aF","getComplexity":"gC","parseGraphignore":"pG","isGraphignored":"iG","loadRuleSets":"RS","saveRuleSet":"RS1","findFiles":"fF","isExcluded":"iE","isInStringOrComment":"ISO","isWithinContext":"WC","checkFileAgainstRule":"FAR","getCustomRules":"CR","setCustomRule":"CR1","deleteCustomRule":"CR2","detectProjectRuleSets":"PRS","checkCustomRules":"CR3","findProjectRoot":"PR","analyzeFileLocals":"FL","getDeadCode":"DC","getFilters":"gF","setFilters":"sF","addExcludes":"aE","removeExcludes":"rE","resetFilters":"rF","parseGitignore":"pG1","shouldExcludeDir":"ED","shouldExcludeFile":"EF","matchWildcard":"mW","matchGitignorePattern":"GP","fetchReference":"fR","listAvailable":"lA","getFrameworkReference":"FR","calculateHealthScore":"HS","getFullAnalysis":"FA","minifyLegend":"mL","createShortName":"SN","buildGraph":"bG","createSkeleton":"cS","getInstructions":"gI","generateJSDoc":"JSD","buildJSDoc":"JSD1","extractParamName":"PN","inferParamType":"PT","generateJSDocFor":"JSD2","parseGo":"pG2","extractImports":"eI","getBody":"gB","extractCalls":"eC","parsePython":"pP","parseTypeScript":"TS","extractParams":"eP","stripStringsAndComments":"SAC","getLargeFiles":"LF","createServer":"cS1","startStdioServer":"SS","analyzeFilePatterns":"FP","analyzePackageJson":"PJ","getOutdatedPatterns":"OP","parseFile":"pF","parseProject":"pP1","parseFileByExtension":"FBE","isSourceFile":"SF","extractSignatures":"eS","buildSignature":"bS","hashBodyStructure":"BS","calculateSimilarity":"cS2","getSimilarFunctions":"SF1","parseAnnotations":"pA","getAllFeatures":"AF","getPendingTests":"PT1","markTestPassed":"TP","markTestFailed":"TF","getTestSummary":"TS1","resetTestState":"TS2","generateMarkdown":"gM","saveDiskCache":"DC1","loadDiskCache":"DC2","getGraph":"gG","detectChanges":"dC","snapshotMtimes":"sM","getSkeleton":"gS","getFocusZone":"FZ","expand":"ex","deps":"de","usages":"us","extractMethod":"eM","getCallChain":"CC","invalidateCache":"iC","extractComments":"eC1","findJSDocBefore":"JSD3","checkMissing":"cM","getUndocumented":"gU","getUndocumentedSummary":"US","setRoots":"sR","getWorkspaceRoot":"WR","resolvePath":"rP"},"reverseLegend":{"gA":"getArg","gP":"getPath","pH":"printHelp","CLI":"runCLI","JSF":"findJSFiles","cC":"calculateComplexity","gR":"getRating","aF":"analyzeFile","gC":"getComplexity","pG":"parseGraphignore","iG":"isGraphignored","RS":"loadRuleSets","RS1":"saveRuleSet","fF":"findFiles","iE":"isExcluded","ISO":"isInStringOrComment","WC":"isWithinContext","FAR":"checkFileAgainstRule","CR":"getCustomRules","CR1":"setCustomRule","CR2":"deleteCustomRule","PRS":"detectProjectRuleSets","CR3":"checkCustomRules","PR":"findProjectRoot","FL":"analyzeFileLocals","DC":"getDeadCode","gF":"getFilters","sF":"setFilters","aE":"addExcludes","rE":"removeExcludes","rF":"resetFilters","pG1":"parseGitignore","ED":"shouldExcludeDir","EF":"shouldExcludeFile","mW":"matchWildcard","GP":"matchGitignorePattern","fR":"fetchReference","lA":"listAvailable","FR":"getFrameworkReference","HS":"calculateHealthScore","FA":"getFullAnalysis","mL":"minifyLegend","SN":"createShortName","bG":"buildGraph","cS":"createSkeleton","gI":"getInstructions","JSD":"generateJSDoc","JSD1":"buildJSDoc","PN":"extractParamName","PT":"inferParamType","JSD2":"generateJSDocFor","pG2":"parseGo","eI":"extractImports","gB":"getBody","eC":"extractCalls","pP":"parsePython","TS":"parseTypeScript","eP":"extractParams","SAC":"stripStringsAndComments","LF":"getLargeFiles","cS1":"createServer","SS":"startStdioServer","FP":"analyzeFilePatterns","PJ":"analyzePackageJson","OP":"getOutdatedPatterns","pF":"parseFile","pP1":"parseProject","FBE":"parseFileByExtension","SF":"isSourceFile","eS":"extractSignatures","bS":"buildSignature","BS":"hashBodyStructure","cS2":"calculateSimilarity","SF1":"getSimilarFunctions","pA":"parseAnnotations","AF":"getAllFeatures","PT1":"getPendingTests","TP":"markTestPassed","TF":"markTestFailed","TS1":"getTestSummary","TS2":"resetTestState","gM":"generateMarkdown","DC1":"saveDiskCache","DC2":"loadDiskCache","gG":"getGraph","dC":"detectChanges","sM":"snapshotMtimes","gS":"getSkeleton","FZ":"getFocusZone","ex":"expand","de":"deps","us":"usages","eM":"extractMethod","CC":"getCallChain","iC":"invalidateCache","eC1":"extractComments","JSD3":"findJSDocBefore","cM":"checkMissing","gU":"getUndocumented","US":"getUndocumentedSummary","sR":"setRoots","WR":"getWorkspaceRoot","rP":"resolvePath"},"stats":{"files":26,"classes":0,"functions":115},"nodes":{"gA":{"t":"F","e":false,"f":"cli-handlers.js"},"gP":{"t":"F","e":false,"f":"cli-handlers.js"},"pH":{"t":"F","e":true,"f":"cli.js"},"CLI":{"t":"F","e":true,"f":"cli.js"},"JSF":{"t":"F","e":false,"f":"undocumented.js"},"cC":{"t":"F","e":false,"f":"complexity.js"},"gR":{"t":"F","e":false,"f":"complexity.js"},"aF":{"t":"F","e":false,"f":"large-files.js"},"gC":{"t":"F","e":true,"f":"complexity.js"},"pG":{"t":"F","e":false,"f":"custom-rules.js"},"iG":{"t":"F","e":false,"f":"custom-rules.js"},"RS":{"t":"F","e":false,"f":"custom-rules.js"},"RS1":{"t":"F","e":false,"f":"custom-rules.js"},"fF":{"t":"F","e":false,"f":"custom-rules.js"},"iE":{"t":"F","e":false,"f":"custom-rules.js"},"ISO":{"t":"F","e":false,"f":"custom-rules.js"},"WC":{"t":"F","e":false,"f":"custom-rules.js"},"FAR":{"t":"F","e":false,"f":"custom-rules.js"},"CR":{"t":"F","e":true,"f":"custom-rules.js"},"CR1":{"t":"F","e":true,"f":"custom-rules.js"},"CR2":{"t":"F","e":true,"f":"custom-rules.js"},"PRS":{"t":"F","e":true,"f":"custom-rules.js"},"CR3":{"t":"F","e":true,"f":"custom-rules.js"},"PR":{"t":"F","e":false,"f":"dead-code.js"},"FL":{"t":"F","e":false,"f":"dead-code.js"},"DC":{"t":"F","e":true,"f":"dead-code.js"},"gF":{"t":"F","e":true,"f":"filters.js"},"sF":{"t":"F","e":true,"f":"filters.js"},"aE":{"t":"F","e":true,"f":"filters.js"},"rE":{"t":"F","e":true,"f":"filters.js"},"rF":{"t":"F","e":true,"f":"filters.js"},"pG1":{"t":"F","e":true,"f":"filters.js"},"ED":{"t":"F","e":true,"f":"filters.js"},"EF":{"t":"F","e":true,"f":"filters.js"},"mW":{"t":"F","e":false,"f":"filters.js"},"GP":{"t":"F","e":false,"f":"filters.js"},"fR":{"t":"F","e":false,"f":"framework-references.js"},"lA":{"t":"F","e":false,"f":"framework-references.js"},"FR":{"t":"F","e":true,"f":"framework-references.js"},"HS":{"t":"F","e":false,"f":"full-analysis.js"},"FA":{"t":"F","e":true,"f":"full-analysis.js"},"mL":{"t":"F","e":true,"f":"graph-builder.js"},"SN":{"t":"F","e":false,"f":"graph-builder.js"},"bG":{"t":"F","e":true,"f":"graph-builder.js"},"cS":{"t":"F","e":true,"f":"graph-builder.js"},"gI":{"t":"F","e":true,"f":"instructions.js"},"JSD":{"t":"F","e":true,"f":"jsdoc-generator.js"},"JSD1":{"t":"F","e":false,"f":"jsdoc-generator.js"},"PN":{"t":"F","e":false,"f":"similar-functions.js"},"PT":{"t":"F","e":false,"f":"jsdoc-generator.js"},"JSD2":{"t":"F","e":true,"f":"jsdoc-generator.js"},"pG2":{"t":"F","e":true,"f":"lang-go.js"},"eI":{"t":"F","e":false,"f":"lang-go.js"},"gB":{"t":"F","e":false,"f":"lang-go.js"},"eC":{"t":"F","e":false,"f":"parser.js"},"pP":{"t":"F","e":true,"f":"lang-python.js"},"TS":{"t":"F","e":true,"f":"lang-typescript.js"},"eP":{"t":"F","e":false,"f":"lang-typescript.js"},"SAC":{"t":"F","e":true,"f":"lang-utils.js"},"LF":{"t":"F","e":true,"f":"large-files.js"},"cS1":{"t":"F","e":true,"f":"mcp-server.js"},"SS":{"t":"F","e":true,"f":"mcp-server.js"},"FP":{"t":"F","e":false,"f":"outdated-patterns.js"},"PJ":{"t":"F","e":false,"f":"outdated-patterns.js"},"OP":{"t":"F","e":true,"f":"outdated-patterns.js"},"pF":{"t":"F","e":false,"f":"undocumented.js"},"pP1":{"t":"F","e":true,"f":"parser.js"},"FBE":{"t":"F","e":false,"f":"parser.js"},"SF":{"t":"F","e":false,"f":"parser.js"},"eS":{"t":"F","e":false,"f":"similar-functions.js"},"bS":{"t":"F","e":false,"f":"similar-functions.js"},"BS":{"t":"F","e":false,"f":"similar-functions.js"},"cS2":{"t":"F","e":false,"f":"similar-functions.js"},"SF1":{"t":"F","e":true,"f":"similar-functions.js"},"pA":{"t":"F","e":true,"f":"test-annotations.js"},"AF":{"t":"F","e":true,"f":"test-annotations.js"},"PT1":{"t":"F","e":true,"f":"test-annotations.js"},"TP":{"t":"F","e":true,"f":"test-annotations.js"},"TF":{"t":"F","e":true,"f":"test-annotations.js"},"TS1":{"t":"F","e":true,"f":"test-annotations.js"},"TS2":{"t":"F","e":true,"f":"test-annotations.js"},"gM":{"t":"F","e":true,"f":"test-annotations.js"},"DC1":{"t":"F","e":false,"f":"tools.js"},"DC2":{"t":"F","e":false,"f":"tools.js"},"gG":{"t":"F","e":false,"f":"tools.js"},"dC":{"t":"F","e":false,"f":"tools.js"},"sM":{"t":"F","e":false,"f":"tools.js"},"gS":{"t":"F","e":true,"f":"tools.js"},"FZ":{"t":"F","e":true,"f":"tools.js"},"ex":{"t":"F","e":true,"f":"tools.js"},"de":{"t":"F","e":true,"f":"tools.js"},"us":{"t":"F","e":true,"f":"tools.js"},"eM":{"t":"F","e":false,"f":"tools.js"},"CC":{"t":"F","e":true,"f":"tools.js"},"iC":{"t":"F","e":true,"f":"tools.js"},"eC1":{"t":"F","e":false,"f":"undocumented.js"},"JSD3":{"t":"F","e":false,"f":"undocumented.js"},"cM":{"t":"F","e":false,"f":"undocumented.js"},"gU":{"t":"F","e":true,"f":"undocumented.js"},"US":{"t":"F","e":true,"f":"undocumented.js"},"sR":{"t":"F","e":true,"f":"workspace.js"},"WR":{"t":"F","e":true,"f":"workspace.js"},"rP":{"t":"F","e":true,"f":"workspace.js"}},"edges":[],"orphans":["getArg","getPath","findJSFiles","calculateComplexity","getRating","analyzeFile","parseGraphignore","isGraphignored","loadRuleSets","saveRuleSet","findFiles","isExcluded","isInStringOrComment","isWithinContext","checkFileAgainstRule","findProjectRoot","analyzeFileLocals","matchWildcard","matchGitignorePattern","fetchReference","listAvailable","calculateHealthScore","createShortName","buildJSDoc","extractParamName","inferParamType","extractImports","getBody","extractCalls","extractParams","analyzeFilePatterns","analyzePackageJson","parseFile","parseFileByExtension","isSourceFile","extractSignatures","buildSignature","hashBodyStructure","calculateSimilarity","saveDiskCache","loadDiskCache","getGraph","detectChanges","snapshotMtimes","extractMethod","extractComments","findJSDocBefore","checkMissing"],"duplicates":{},"files":["cli-handlers.js","cli.js","complexity.js","custom-rules.js","dead-code.js","filters.js","framework-references.js","full-analysis.js","graph-builder.js","instructions.js","jsdoc-generator.js","lang-go.js","lang-python.js","lang-typescript.js","lang-utils.js","large-files.js","mcp-server.js","outdated-patterns.js","parser.js","server.js","similar-functions.js","test-annotations.js","tool-defs.js","tools.js","undocumented.js","workspace.js"]}}

package/src/filters.js

@@ -32,6 +32,7 @@ const DEFAULT_EXCLUDE_PATTERNS = [
   '*.min.js',
   '*.bundle.js',
   '*.d.ts',
+  '.project-graph-cache.json',
 ];
 
 // Current filter configuration (mutable via MCP)

package/src/graph-builder.js

@@ -169,7 +169,7 @@ export function buildGraph(parsed) {
   }
 
   // Detect duplicates (same method name in multiple classes)
-  const methodLocations = {};
+  const methodLocations = Object.create(null);
   for (const cls of classes) {
     for (const method of cls.methods || []) {
       if (!methodLocations[method]) {

package/src/lang-go.js

@@ -0,0 +1,285 @@
+import { stripStringsAndComments } from './lang-utils.js';
+
+/**
+ * Parse Go file using regex-based structural extraction.
+ * @param {string} code - Go source code
+ * @param {string} filename - File path
+ * @returns {ParseResult}
+ */
+export function parseGo(code, filename) {
+  const result = {
+    file: filename,
+    classes: [],
+    functions: [],
+    imports: [],
+    exports: []
+  };
+
+  const { imports, packageNames } = extractImports(code);
+  result.imports = imports;
+
+  const cleanCode = stripStringsAndComments(code, {
+    singleQuote: false,
+    backtick: true,
+    templateInterpolation: false
+  });
+
+  const classesMap = new Map();
+
+  // Extract Structs (mapped to classes)
+  const structRegex = /^\s*type\s+([a-zA-Z_]\w*)\s+struct\s*\{/gm;
+  let match;
+  while ((match = structRegex.exec(cleanCode)) !== null) {
+    const name = match[1];
+    const start = match.index + match[0].length;
+    const body = getBody(cleanCode, start);
+    const line = code.substring(0, match.index).split('\n').length;
+
+    let extendsName = null;
+    const properties = [];
+
+    const lines = body.split('\n').map(l => l.trim()).filter(l => l);
+    for (const lineStr of lines) {
+      const parts = lineStr.split(/\s+/);
+      if (parts.length === 1) {
+        extendsName = parts[0].replace(/^\*/, ''); // Remove pointer if embedded
+      } else if (parts.length >= 2) {
+        const propName = parts[0].replace(/,$/, '');
+        properties.push(propName);
+      }
+    }
+
+    classesMap.set(name, {
+      name,
+      extends: extendsName,
+      methods: [],
+      properties,
+      calls: [],
+      file: filename,
+      line
+    });
+  }
+
+  // Extract Interfaces (mapped to classes)
+  const interfaceRegex = /^\s*type\s+([a-zA-Z_]\w*)\s+interface\s*\{/gm;
+  while ((match = interfaceRegex.exec(cleanCode)) !== null) {
+    const name = match[1];
+    const start = match.index + match[0].length;
+    const body = getBody(cleanCode, start);
+    const line = code.substring(0, match.index).split('\n').length;
+
+    let extendsName = null;
+    const methods = [];
+
+    const lines = body.split('\n').map(l => l.trim()).filter(l => l);
+    for (const lineStr of lines) {
+      const parenIndex = lineStr.indexOf('(');
+      if (parenIndex !== -1) {
+        const beforeParen = lineStr.substring(0, parenIndex).trim();
+        const parts = beforeParen.split(/\s+/);
+        const methodName = parts[parts.length - 1];
+        if (methodName) {
+          methods.push(methodName);
+        }
+      } else {
+        const parts = lineStr.split(/\s+/);
+        if (parts.length === 1) {
+          extendsName = parts[0];
+        }
+      }
+    }
+
+    classesMap.set(name, {
+      name,
+      extends: extendsName,
+      methods,
+      properties: [],
+      calls: [],
+      file: filename,
+      line
+    });
+  }
+
+  // Extract Methods
+  const methodRegex = /^\s*func\s+\(\s*[a-zA-Z_]\w*\s+\*?([a-zA-Z_]\w*)\s*\)\s+([a-zA-Z_]\w*)[^{]*\{/gm;
+  while ((match = methodRegex.exec(cleanCode)) !== null) {
+    const className = match[1];
+    const methodName = match[2];
+    const start = match.index + match[0].length;
+    const body = getBody(cleanCode, start);
+    const line = code.substring(0, match.index).split('\n').length;
+
+    const methodCalls = extractCalls(body, packageNames);
+
+    if (!classesMap.has(className)) {
+      classesMap.set(className, {
+        name: className,
+        extends: null,
+        methods: [],
+        properties: [],
+        calls: [],
+        file: filename,
+        line
+      });
+    }
+
+    const classInfo = classesMap.get(className);
+    classInfo.methods.push(methodName);
+    
+    for (const call of methodCalls) {
+      if (!classInfo.calls.includes(call)) {
+        classInfo.calls.push(call);
+      }
+    }
+  }
+
+  // Extract Functions (top-level)
+  const funcRegex = /^\s*func\s+([a-zA-Z_]\w*)\s*\(([^)]*)\)[^{]*\{/gm;
+  while ((match = funcRegex.exec(cleanCode)) !== null) {
+    const name = match[1];
+    const paramsStr = match[2];
+    const params = paramsStr.split(',')
+      .map(p => p.trim().split(/\s+/)[0])
+      .filter(p => p);
+
+    const exported = /^[A-Z]/.test(name);
+    const start = match.index + match[0].length;
+    const body = getBody(cleanCode, start);
+    const line = code.substring(0, match.index).split('\n').length;
+
+    const calls = extractCalls(body, packageNames);
+
+    result.functions.push({
+      name,
+      exported,
+      calls,
+      params,
+      file: filename,
+      line
+    });
+  }
+
+  result.classes = Array.from(classesMap.values());
+
+  // Extract Exports
+  for (const cls of result.classes) {
+    if (/^[A-Z]/.test(cls.name)) {
+      result.exports.push(cls.name);
+    }
+  }
+  for (const fn of result.functions) {
+    if (fn.exported) {
+      result.exports.push(fn.name);
+    }
+  }
+
+  return result;
+}
+
+function extractImports(text) {
+  const imports = [];
+  const packageNames = new Set();
+  
+  // Strip comments to avoid commented out imports
+  const noComments = text.replace(/\/\/.*/g, '').replace(/\/\*[\s\S]*?\*\//g, '');
+  
+  const importBlockRegex = /import\s*\(([\s\S]*?)\)/g;
+  let match;
+  while ((match = importBlockRegex.exec(noComments)) !== null) {
+    const block = match[1];
+    const lines = block.split('\n');
+    for (const line of lines) {
+      const lineMatch = line.match(/(?:([a-zA-Z_]\w*)\s+)?"([^"]+)"/);
+      if (lineMatch) {
+        const alias = lineMatch[1];
+        const pkgPath = lineMatch[2];
+        if (alias) {
+          if (!imports.includes(alias)) {
+            imports.push(alias);
+            packageNames.add(alias);
+          }
+        } else {
+          if (!imports.includes(pkgPath)) {
+            imports.push(pkgPath);
+            const parts = pkgPath.split('/');
+            packageNames.add(parts[parts.length - 1]);
+          }
+        }
+      }
+    }
+  }
+  
+  const singleImportRegex = /import\s+(?:([a-zA-Z_]\w*)\s+)?"([^"]+)"/g;
+  while ((match = singleImportRegex.exec(noComments)) !== null) {
+    const alias = match[1];
+    const pkgPath = match[2];
+    if (alias) {
+      if (!imports.includes(alias)) {
+        imports.push(alias);
+        packageNames.add(alias);
+      }
+    } else {
+      if (!imports.includes(pkgPath)) {
+        imports.push(pkgPath);
+        const parts = pkgPath.split('/');
+        packageNames.add(parts[parts.length - 1]);
+      }
+    }
+  }
+  
+  return { imports, packageNames };
+}
+
+/**
+ * Extract block body correctly handling nested braces.
+ * @param {string} code
+ * @param {number} startIndex
+ * @returns {string}
+ */
+function getBody(code, startIndex) {
+  let braces = 1;
+  let end = startIndex;
+  while (end < code.length && braces > 0) {
+    if (code[end] === '{') braces++;
+    else if (code[end] === '}') braces--;
+    end++;
+  }
+  return code.substring(startIndex, end - 1);
+}
+
+/**
+ * Extract method calls from a block of code, filtering out Go keywords.
+ * @param {string} body
+ * @param {Set<string>} packageNames
+ * @returns {string[]}
+ */
+function extractCalls(body, packageNames) {
+  const calls = [];
+  const callRegex = /([a-zA-Z_]\w*(?:\.[a-zA-Z_]\w*)?)\s*\(/g;
+  let match;
+  while ((match = callRegex.exec(body)) !== null) {
+    let callName = match[1];
+    
+    const keywords = [
+      'if', 'for', 'switch', 'func', 'panic', 'recover', 'len', 'cap', 
+      'make', 'new', 'append', 'copy', 'delete', 'close',
+      'int', 'string', 'bool', 'byte', 'rune', 'float32', 'float64', 
+      'int32', 'int64', 'uint32', 'uint64', 'complex64', 'complex128'
+    ];
+    if (keywords.includes(callName)) continue;
+
+    if (callName.includes('.')) {
+      const parts = callName.split('.');
+      // If the first part is a known package name, keep it (e.g., fmt.Println)
+      // Otherwise, assume it's a method call on a variable and strip it (e.g., s.Handle -> Handle)
+      if (!packageNames.has(parts[0])) {
+        callName = parts[1];
+      }
+    }
+
+    if (!calls.includes(callName)) {
+      calls.push(callName);
+    }
+  }
+  return calls;
+}

package/src/lang-python.js

@@ -0,0 +1,197 @@
+import { stripStringsAndComments } from './lang-utils.js';
+
+/**
+ * Parse Python file using regex-based structural extraction.
+ * @param {string} code - Python source code
+ * @param {string} filename - File path
+ * @returns {ParseResult}
+ */
+export function parsePython(code = '', filename = '') {
+  const result = {
+    file: filename,
+    classes: [],
+    functions: [],
+    imports: [],
+    exports: []
+  };
+
+  // Pre-process: remove docstrings, triple-quoted strings, and line comments
+  const cleanCode = stripStringsAndComments(code, {
+    singleQuote: true,
+    hashComment: true,
+    tripleQuote: true
+  });
+
+  const lines = cleanCode.split('\n');
+  
+  let currentClass = null;
+  let currentFunc = null;
+  let classIndent = -1;
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (!line.trim()) continue;
+
+    const indentMatch = line.match(/^([ \t]*)/);
+    const indent = indentMatch ? indentMatch[1].length : 0;
+
+    // Check if we exited a class scope
+    if (currentClass && indent <= classIndent) {
+      currentClass = null;
+      classIndent = -1;
+    }
+
+    // Check if we exited a function scope
+    if (currentFunc && indent === 0) {
+      currentFunc = null;
+    }
+
+    // Match Class (top-level)
+    const classMatch = line.match(/^class\s+([a-zA-Z_]\w*)(?:\s*\((.*?)\))?\s*:/);
+    if (classMatch) {
+      currentClass = {
+        name: classMatch[1],
+        extends: classMatch[2] ? classMatch[2].trim() : null,
+        methods: [],
+        properties: [],
+        calls: [],
+        file: filename,
+        line: i + 1
+      };
+      result.classes.push(currentClass);
+      classIndent = indent;
+      currentFunc = null;
+      continue;
+    }
+
+    // Match top-level function
+    const funcMatch = line.match(/^(?:async\s+)?def\s+([a-zA-Z_]\w*)\s*\(([^)]*)\)?/);
+    if (funcMatch) {
+      const paramsStr = funcMatch[2] || '';
+      const params = paramsStr.split(',')
+        .map(p => p.split(/[:=]/)[0].trim())
+        .filter(p => p && p !== 'self' && p !== 'cls');
+
+      currentFunc = {
+        name: funcMatch[1],
+        exported: true, // we'll adjust later if __all__ is present
+        calls: [],
+        params: params,
+        file: filename,
+        line: i + 1
+      };
+      result.functions.push(currentFunc);
+      currentClass = null;
+      continue;
+    }
+
+    // Match Method (inside class)
+    const methodMatch = line.match(/^[ \t]+(?:async\s+)?def\s+([a-zA-Z_]\w*)\s*\(/);
+    if (methodMatch && currentClass && indent > classIndent) {
+      const methodName = methodMatch[1];
+      if (methodName !== '__init__') {
+        currentClass.methods.push(methodName);
+      }
+      currentFunc = null; // not a top-level function
+      continue;
+    }
+
+    // Match Imports
+    const importMatch = line.match(/^\s*import\s+(.+)/);
+    if (importMatch) {
+      const parts = importMatch[1].split(',');
+      for (const part of parts) {
+        const p = part.trim();
+        const asMatch = p.match(/(?:.+)\s+as\s+([a-zA-Z_]\w*)/);
+        if (asMatch) {
+          result.imports.push(asMatch[1]);
+        } else {
+          result.imports.push(p.split('.')[0]); // take root module
+        }
+      }
+      continue;
+    }
+
+    const fromImportMatch = line.match(/^\s*from\s+([.\w]+)\s+import\s*(.*)/);
+    if (fromImportMatch) {
+      let imported = fromImportMatch[2];
+      if (imported.includes('(') && !imported.includes(')')) {
+        let j = i + 1;
+        while (j < lines.length) {
+          imported += ' ' + lines[j];
+          if (lines[j].includes(')')) {
+            i = j;
+            break;
+          }
+          j++;
+        }
+      }
+      imported = imported.replace(/[()]/g, '');
+      const parts = imported.split(',');
+      for (const part of parts) {
+        const p = part.trim();
+        if (!p) continue;
+        const asMatch = p.match(/(?:.+)\s+as\s+([a-zA-Z_]\w*)/);
+        if (asMatch) {
+          result.imports.push(asMatch[1]);
+        } else {
+          result.imports.push(p);
+        }
+      }
+      continue;
+    }
+
+    // Extract calls: look for func(...)
+    const callRegex = /([a-zA-Z_][\w.]*)\s*\(/g;
+    let match;
+    const keywords = new Set(['if', 'while', 'for', 'elif', 'return', 'yield', 'def', 'class', 'and', 'or', 'not', 'in', 'is', 'print']);
+    while ((match = callRegex.exec(line)) !== null) {
+      const callName = match[1];
+      if (keywords.has(callName)) continue;
+      
+      let cleanCallName = callName;
+      if (cleanCallName.startsWith('self.')) {
+        cleanCallName = cleanCallName.substring(5);
+      }
+      
+      if (currentFunc) {
+        if (!currentFunc.calls.includes(cleanCallName)) {
+          currentFunc.calls.push(cleanCallName);
+        }
+      } else if (currentClass) {
+        if (!currentClass.calls.includes(cleanCallName)) {
+          currentClass.calls.push(cleanCallName);
+        }
+      }
+    }
+  }
+
+  // Handle Exports (__all__)
+  const allMatch = code.match(/__all__\s*=\s*\[(.*?)\]/s);
+  if (allMatch) {
+    const exportsRaw = allMatch[1];
+    const exportRegex = /['"]([^'"]+)['"]/g;
+    let exMatch;
+    while ((exMatch = exportRegex.exec(exportsRaw)) !== null) {
+      result.exports.push(exMatch[1]);
+    }
+    // Update exported flags for functions
+    for (const fn of result.functions) {
+      fn.exported = result.exports.includes(fn.name);
+    }
+  } else {
+    // Implicit exports: all top-level functions and classes are exported
+    for (const cls of result.classes) {
+      result.exports.push(cls.name);
+    }
+    for (const fn of result.functions) {
+      result.exports.push(fn.name);
+      fn.exported = true;
+    }
+  }
+  
+  // Deduplicate imports
+  result.imports = [...new Set(result.imports)];
+
+  return result;
+}