@tng-sh/mcp-server 1.0.0 → 1.0.3

package/README.md

@@ -10,7 +10,8 @@ The [Model Context Protocol](https://modelcontextprotocol.io) allows AI assistan
 
 - *"Audit the `process_payment` method in `app/services/payment_processor.rb`"*
 - *"Generate comprehensive tests for the UserController#create method"*
-- *"What methods are defined in `app/models/user.rb`?"*
+- *"Run a regression check on `Order#checkout`"*
+- *"What can TNG do here?"*
 
 And the AI will use TNG automatically to provide detailed, actionable results.
 
@@ -18,11 +19,12 @@ And the AI will use TNG automatically to provide detailed, actionable results.
 
 -  **Method Auditing** - Deep analysis for bugs, security issues, and performance problems
 -  **Test Generation** - Automatic test creation for Ruby, Python, and JavaScript
--  **Method Listing** - Quick overview of all methods in a file
 -  **X-Ray Visualization** - Generate Mermaid flowcharts to visualize method logic
 -  **Symbolic Trace** - Execution path analysis for debugging and understanding code flow
+-  **Regression Check** - Blast radius check for changes to a method vs Git HEAD
 -  **Clone Detection** - Find duplicate code with token-based, structural, and fuzzy matching
 -  **Dead Code Detection** - Identify unused imports, variables, functions, and unreachable code
+-  **Capabilities Listing** - List available TNG MCP tools and when to use them
 -  **Multi-Language Support** - Works with Ruby, Python, JavaScript/TypeScript
 -  **Universal Integration** - Works with any MCP-compatible AI assistant
 
@@ -308,7 +310,7 @@ AI: I'll analyze that file for dead code.
 
 ## Available Tools
 
-The MCP server exposes six tools:
+The MCP server exposes seven tools:
 
 ### 1. `audit_method`
 
@@ -363,7 +365,21 @@ Generate symbolic trace execution path for a method.
 - Variable states at each step
 - Control flow analysis
 
-### 5. `detect_clones`
+### 5. `impact_method` (Regression Check)
+
+Analyze the impact (blast radius) of changes to a method vs its committed version (`HEAD`).
+
+**Parameters:**
+- `file_path` (required) - Path to the source file
+- `method_name` (required) - Name of the method
+- `class_name` (optional) - Class name (Python only)
+
+**Returns:**
+- Breaking changes detected
+- Informational changes
+- Impacted call sites (where this method is used)
+
+### 6. `detect_clones`
 
 Detect code duplication within a file.
 
@@ -376,18 +392,34 @@ Detect code duplication within a file.
 - Locations of duplicated code
 - Refactoring recommendations
 
-### 6. `detect_deadcode`
+### 7. `detect_deadcode`
 
-Detect dead code in a file.
+Detect dead code in a file or across the whole project.
 
 **Parameters:**
-- `file_path` (required) - Path to the source file
+- `file_path` (optional) - Path to the source file (omit when using `all=true`)
+- `all` (optional) - Set to true for a project-wide scan (uses CLI flag `--all`)
+- `project_root` (required when `all=true`) - Project root to run the scan from
 
 **Returns:**
 - Unused imports, variables, and functions
 - Unreachable code blocks
 - Cleanup recommendations
 
+### 8. `find_call_sites`
+
+Find in-repo call sites for a method/function.
+
+**Parameters:**
+- `file_path` (required) - Path to the source file containing the method
+- `method_name` (required) - Method/function name
+- `class_name` (optional) - Class/module name to disambiguate methods with the same name
+- `project_root` (optional) - Project root to resolve relative paths
+
+**Returns:**
+- Files and line numbers where the method is called
+- Snippet/context lines (when available)
+
 ## Development
 
 ### Building

package/dist/index.js

@@ -8,7 +8,11 @@ import { xrayMethod } from './tools/xray.js';
 import { traceMethod } from './tools/trace.js';
 import { detectClones } from './tools/clones.js';
 import { detectDeadCode } from './tools/deadcode.js';
+import { findCallSites } from './tools/call_sites.js';
+import { impactMethod } from './tools/impact.js';
 import { runInit } from './init.js';
+import { existsSync, readFileSync } from 'fs';
+import { resolveFilePath, findProjectRoot } from './tools/utils.js';
 const server = new McpServer({
     name: 'tng-mcp',
     version: '1.0.0',
@@ -17,165 +21,299 @@ if (process.argv.includes('init')) {
     const code = runInit();
     process.exit(code);
 }
+const auditSchema = {
+    file_path: z.string().describe('Relative or absolute path to the source file (e.g., "app/services/payment_processor.rb", "src/utils/validator.ts")'),
+    method_name: z.string().describe('Name of the method/function to audit (e.g., "process_payment", "validateUser", "handleSubmit")'),
+    class_name: z.string().optional().describe('Class or module name to disambiguate methods with the same name'),
+    test_type: z.string().optional().describe('Component type - REQUIRED for JavaScript/Python: "utility", "react_component", "express_handler", "django_view", etc. Ignored for Ruby/Rails.'),
+    response_format: z.string().optional().describe('Response format: "text" (default), "json", or "both".'),
+    raw_json: z.boolean().optional().describe('If true, return JSON envelope with raw tool output.'),
+};
+const generateSchema = {
+    file_path: z.string().describe('Relative or absolute path to the source file to generate tests for'),
+    method_name: z.string().describe('Name of the method/function to generate tests for'),
+    class_name: z.string().optional().describe('Class or module name to disambiguate methods with the same name'),
+    test_type: z.string().optional().describe('Component type or test framework hint - REQUIRED for JS/Python: "utility", "react_component", "express_handler", etc.'),
+    response_format: z.string().optional().describe('Response format: "text" (default), "json", or "both".'),
+    raw_json: z.boolean().optional().describe('If true, return JSON envelope with raw tool output.'),
+};
+const methodSchema = {
+    file_path: z.string().describe('Relative or absolute path to the source file'),
+    method_name: z.string().describe('Name of the method/function'),
+    class_name: z.string().optional().describe('Class or module name to disambiguate methods with the same name'),
+    response_format: z.string().optional().describe('Response format: "text" (default), "json", or "both".'),
+    raw_json: z.boolean().optional().describe('If true, return JSON envelope with raw tool output.'),
+};
+const impactSchema = {
+    file_path: z.string().describe('Relative or absolute path to the source file'),
+    method_name: z.string().describe('Name of the method/function'),
+    class_name: z.string().optional().describe('Class or module name to disambiguate methods with the same name'),
+    response_format: z.string().optional().describe('Response format: "text" (default), "json", or "both".'),
+    raw_json: z.boolean().optional().describe('If true, return JSON envelope with raw tool output.'),
+};
+const clonesSchema = {
+    file_path: z.string().describe('Relative or absolute path to the source file to analyze for duplication'),
+    level: z.string().optional().describe('Clone detection level: "1" (exact), "2" (structural), "3" (fuzzy/near-miss), or "all" (default - detects all types)'),
+    response_format: z.string().optional().describe('Response format: "text" (default), "json", or "both".'),
+    raw_json: z.boolean().optional().describe('If true, return JSON envelope with raw tool output.'),
+};
+const deadCodeSchema = {
+    file_path: z.string().optional().describe('Relative or absolute path to the source file to analyze for dead code (omit when using all=true)'),
+    project_root: z.string().optional().describe('Project root to resolve relative paths and run project-wide scans (recommended when all=true)'),
+    all: z.boolean().optional().describe('If true, analyze dead code across the entire project (passes --all).'),
+    response_format: z.string().optional().describe('Response format: "text" (default), "json", or "both".'),
+    raw_json: z.boolean().optional().describe('If true, return JSON envelope with raw tool output.'),
+};
+const callSitesSchema = {
+    file_path: z.string().describe('Relative or absolute path to the source file containing the method'),
+    method_name: z.string().describe('Name of the method/function'),
+    class_name: z.string().optional().describe('Class or module name to disambiguate methods with the same name'),
+    project_root: z.string().optional().describe('Project root to resolve relative paths'),
+    response_format: z.string().optional().describe('Response format: "text" (default), "json", or "both".'),
+    raw_json: z.boolean().optional().describe('If true, return JSON envelope with raw tool output.'),
+};
+const auditDescription = `Audit a specific method/function for security, bugs, performance, and code quality issues.
+Use when the user asks to audit, review, analyze, inspect, or check code.
+Returns findings with severity, line locations, and suggested fixes.
+Supports: Ruby, Python, JavaScript/TypeScript.
+Example: audit_method { file_path: "app/services/payment_processor.rb", method_name: "process_payment" }`;
+const generateDescription = `Generate tests for a specific method/function.
+Use when the user asks to write tests, create specs, or add coverage.
+Returns complete test code with suggested file path and command to run.
+Supports: Ruby, Python, JavaScript/TypeScript.
+Example: generate_test { file_path: "src/utils/validator.ts", method_name: "validateUser", test_type: "utility" }`;
+const xrayDescription = `Generate a Mermaid flowchart for a method/function (X-Ray).
+Use when the user asks for a diagram, flowchart, or visual explanation.
+Returns Mermaid code suitable for Markdown renderers.
+Example: xray_method { file_path: "lib/order.rb", method_name: "checkout" }`;
+const traceDescription = `Generate a symbolic execution trace for a method/function.
+Use when the user asks to trace, step through, or debug execution flow.
+Returns step-by-step trace output.
+Example: trace_method { file_path: "src/controllers/cart.ts", method_name: "addItem" }`;
+const impactDescription = `Run a regression check (blast radius analysis) on changes to a method vs Git HEAD.
+Use when the user asks about regressions, impact, breaking changes, or blast radius.
+Returns breaking/informational changes and impacted call sites.
+Example: impact_method { file_path: "app/models/user.rb", method_name: "full_name" }`;
+const clonesDescription = `Detect code duplication (clones) within a file.
+Use when the user asks to find duplicates or copy-paste code.
+Returns clone pairs with similarity and locations.
+Example: detect_clones { file_path: "src/services/order.ts", level: "2" }`;
+const deadcodeDescription = `Detect unused or unreachable code in a file or entire project.
+Use when the user asks to find dead code or unused imports/variables.
+Set all=true to scan the whole project (CLI flag: --all).
+Returns unused elements with locations and cleanup suggestions.
+Example: detect_deadcode { file_path: "src/api/auth.ts" }
+Example (project-wide): detect_deadcode { all: true }`;
+const callSitesDescription = `Find in-repo call sites for a method/function.
+Use when the user asks "who calls this?" or "where is this used?".
+Example: find_call_sites { file_path: "src/utils/auth.ts", method_name: "validateUser" }`;
 // 1. Audit Method - AI-Powered Code Analysis
-server.registerTool('audit_method', {
-    description: `Perform a comprehensive AI-powered audit of a specific method or function in your codebase. This tool analyzes code for:
-- **Security vulnerabilities**: SQL injection, XSS, authentication issues, insecure data handling
-- **Bugs and logic errors**: Edge cases, null pointer issues, race conditions, incorrect algorithms
-- **Performance problems**: Inefficient loops, N+1 queries, memory leaks, unnecessary computations
-- **Code quality issues**: Complexity, maintainability, anti-patterns, code smells
-- **Behavioral analysis**: Understanding what the code does, its dependencies, and side effects
-
-Use this when the user asks to "check", "analyze", "review", "audit", "find issues in", or "what's wrong with" code.
-
-Returns: Detailed findings with severity levels (Critical/High/Medium/Low), descriptions, exact line locations, reasoning, and suggested fixes. Also includes behavioral insights about what the method does.
-
-**How to use the results:**
-1. Summarize the most critical issues first (High/Critical severity)
-2. Explain each issue in plain language with context from the code
-3. Offer to show the suggested fixes or apply them directly to the file
-4. If no issues found, acknowledge the code quality and mention any positive behaviors observed
-5. Suggest follow-up actions: generate tests for edge cases, create documentation, or refactor for better maintainability
-
-Supports: Ruby (Rails), Python, JavaScript/TypeScript (React, Node.js, Express), and more.`,
-    inputSchema: {
-        file_path: z.string().describe('Relative or absolute path to the source file (e.g., "app/services/payment_processor.rb", "src/utils/validator.ts")'),
-        method_name: z.string().describe('Name of the method/function to audit (e.g., "process_payment", "validateUser", "handleSubmit")'),
-        test_type: z.string().optional().describe('Component type - REQUIRED for JavaScript/Python: "utility", "react_component", "express_handler", "django_view", etc. Ignored for Ruby/Rails.'),
-    }
-}, async (args) => await auditMethod(args));
+server.registerTool('audit_method', { description: auditDescription, inputSchema: auditSchema }, async (args) => await auditMethod(args));
+// Aliases for audit_method
+server.registerTool('review_method', { description: 'Alias of audit_method. Use for "review this method" or "code review".', inputSchema: auditSchema }, async (args) => await auditMethod(args));
+server.registerTool('analyze_method', { description: 'Alias of audit_method. Use for "analyze this method".', inputSchema: auditSchema }, async (args) => await auditMethod(args));
 // 2. Generate Test - AI Test Generation
-server.registerTool('generate_test', {
-    description: `Generate comprehensive, production-ready tests for a specific method or function using AI. This tool:
-- **Automatically detects** the appropriate test framework (RSpec, Jest, Pytest, Mocha, etc.)
-- **Creates complete test files** with proper imports, setup, teardown, and test structure
-- **Covers multiple scenarios**: Happy path, edge cases, error handling, boundary conditions
-- **Includes assertions** for return values, side effects, state changes, and error conditions
-- **Adds mocking/stubbing** for external dependencies, API calls, database queries
-- **Follows best practices** for the detected framework and language
-
-Use this when the user asks to "write tests", "generate tests", "create specs", "test this code", or "add test coverage".
-
-Returns: Complete test file code with test count, file path where it should be saved, and the command to run the tests.
-
-**How to use the results:**
-1. Show the generated test code in a code block with proper syntax highlighting
-2. Explain what scenarios the tests cover (happy path, edge cases, errors)
-3. Provide the file path where the test should be saved
-4. Show the command to run the tests (e.g., "npm test", "pytest", "rspec")
-5. Offer to save the test file directly or let the user review it first
-6. Suggest running the tests to verify they pass, or offer to fix any issues if they fail
-
-Supports: Ruby (RSpec, Minitest), JavaScript/TypeScript (Jest, Mocha, Vitest), Python (Pytest, unittest), and more.`,
-    inputSchema: {
-        file_path: z.string().describe('Relative or absolute path to the source file to generate tests for'),
-        method_name: z.string().describe('Name of the method/function to generate tests for'),
-        test_type: z.string().optional().describe('Component type or test framework hint - REQUIRED for JS/Python: "utility", "react_component", "express_handler", etc.'),
-    }
-}, async (args) => await generateTest(args));
+server.registerTool('generate_test', { description: generateDescription, inputSchema: generateSchema }, async (args) => await generateTest(args));
+// Aliases for generate_test
+server.registerTool('generate_tests', { description: 'Alias of generate_test. Use for "generate tests".', inputSchema: generateSchema }, async (args) => await generateTest(args));
+server.registerTool('write_tests', { description: 'Alias of generate_test. Use for "write tests".', inputSchema: generateSchema }, async (args) => await generateTest(args));
 // 3. X-Ray Visualization - Code Flow Diagrams
-server.registerTool('xray_method', {
-    description: `Generate a visual X-Ray diagram (Mermaid flowchart) that maps out the logic flow of a specific method or function. This tool:
-- **Creates flowcharts** showing decision points, loops, function calls, and control flow
-- **Visualizes complexity** making it easy to understand what the code does at a glance
-- **Identifies code paths** including conditional branches, error handling, and edge cases
-- **Shows relationships** between different parts of the method
-
-Use this when the user asks for a "diagram", "flowchart", "visual representation", "map out the logic", "show me how this works visually", or "xray".
-
-Returns: Mermaid diagram code that can be rendered in Markdown-compatible viewers (GitHub, VS Code, etc.).
-
-**How to use the results:**
-1. Display the Mermaid diagram code in a code block with \`\`\`mermaid syntax
-2. Explain the main flow and key decision points shown in the diagram
-3. Point out any complex branches or loops that might need attention
-4. Suggest using the diagram for documentation or code reviews
-5. If the diagram reveals high complexity, offer to audit the method for potential simplification
-
-Supports: All languages - Ruby, Python, JavaScript/TypeScript, Go, and more.`,
-    inputSchema: {
-        file_path: z.string().describe('Relative or absolute path to the source file'),
-        method_name: z.string().describe('Name of the method/function to visualize'),
-    }
-}, async (args) => await xrayMethod(args));
+server.registerTool('xray_method', { description: xrayDescription, inputSchema: methodSchema }, async (args) => await xrayMethod(args));
+// Aliases for xray_method
+server.registerTool('xray_diagram', { description: 'Alias of xray_method. Use for "diagram" or "flowchart".', inputSchema: methodSchema }, async (args) => await xrayMethod(args));
+server.registerTool('visualize_flow', { description: 'Alias of xray_method. Use for "visualize flow".', inputSchema: methodSchema }, async (args) => await xrayMethod(args));
 // 4. Trace Method - Symbolic Execution Analysis
-server.registerTool('trace_method', {
-    description: `Generate a symbolic trace showing the step-by-step execution path through a method or function. This tool:
-- **Simulates execution** with symbolic values to explore all possible code paths
-- **Shows variable states** and how they change throughout execution
-- **Identifies branches** and which conditions lead to which outcomes
-- **Reveals execution order** of statements, function calls, and side effects
-- **Helps debug** by showing exactly what happens when the code runs
-
-Use this when the user asks to "trace", "step through", "show execution", "debug flow", "walk through the code", or "see what happens when this runs".
-
-Returns: Detailed execution trace with line-by-line analysis, variable states, and decision points.
-
-**How to use the results:**
-1. Present the trace in a clear, step-by-step format
-2. Highlight key decision points and branch conditions
-3. Explain how variables change throughout execution
-4. Point out any unexpected behavior or potential issues discovered
-5. Use the trace to answer specific debugging questions or explain complex logic
-6. Suggest areas where the code might benefit from simplification or better error handling
-
-Supports: All languages - Ruby, Python, JavaScript/TypeScript, and more.`,
+server.registerTool('trace_method', { description: traceDescription, inputSchema: methodSchema }, async (args) => await traceMethod(args));
+// 4.5 Impact Method - Blast Radius Analysis
+server.registerTool('impact_method', { description: impactDescription, inputSchema: impactSchema }, async (args) => await impactMethod(args));
+// Aliases for impact_method
+server.registerTool('impact_analysis', { description: 'Alias of impact_method. Use for "impact analysis" or "blast radius".', inputSchema: impactSchema }, async (args) => await impactMethod(args));
+server.registerTool('impact_audit', { description: 'Alias of impact_method. Use for "regression check".', inputSchema: impactSchema }, async (args) => await impactMethod(args));
+server.registerTool('regression_check', { description: 'Alias of impact_method. Use for "regression check".', inputSchema: impactSchema }, async (args) => await impactMethod(args));
+server.registerTool('blast_radius', { description: 'Alias of impact_method. Use for "blast radius check".', inputSchema: impactSchema }, async (args) => await impactMethod(args));
+// Aliases for trace_method
+server.registerTool('trace_execution', { description: 'Alias of trace_method. Use for "trace execution".', inputSchema: methodSchema }, async (args) => await traceMethod(args));
+// 5. Detect Clones - Code Duplication Detection
+server.registerTool('detect_clones', { description: clonesDescription, inputSchema: clonesSchema }, async (args) => await detectClones(args));
+// Aliases for detect_clones
+server.registerTool('find_clones', { description: 'Alias of detect_clones. Use for "find duplicates".', inputSchema: clonesSchema }, async (args) => await detectClones(args));
+// 6. Detect Dead Code - Unused Code Detection
+server.registerTool('detect_deadcode', { description: deadcodeDescription, inputSchema: deadCodeSchema }, async (args) => await detectDeadCode(args));
+// Aliases for detect_deadcode
+server.registerTool('find_deadcode', { description: 'Alias of detect_deadcode. Use for "find unused code".', inputSchema: deadCodeSchema }, async (args) => await detectDeadCode(args));
+// 7. Find Call Sites - Usage Detection
+server.registerTool('find_call_sites', { description: callSitesDescription, inputSchema: callSitesSchema }, async (args) => await findCallSites(args));
+// Alias for find_call_sites
+server.registerTool('call_sites', { description: 'Alias of find_call_sites. Use for "find usages" or "where is this called".', inputSchema: callSitesSchema }, async (args) => await findCallSites(args));
+// 8. Capabilities - List Available Tools
+server.registerTool('list_capabilities', {
+    description: 'List available TNG MCP tools and when to use them.',
+    inputSchema: {},
+}, async () => ({
+    content: [
+        {
+            type: 'text',
+            text: [
+                'TNG MCP capabilities:',
+                '- audit_method: audit/review/analyze a method for issues',
+                '- generate_test: generate tests for a method',
+                '- xray_method: Mermaid flow diagram for a method',
+                '- trace_method: symbolic execution trace',
+                '- impact_method: run a regression check (blast radius) for a method',
+                '- detect_clones: find duplicate code in a file',
+                '- detect_deadcode: find unused/unreachable code in a file (or whole project with all=true)',
+                '- find_call_sites: locate in-repo call sites for a method/function',
+                '',
+                'Best practices:',
+                '- Prefer file paths relative to the project root.',
+                '- If the server runs outside the repo, pass project_root or use absolute file paths.',
+                '- For JS/Python, include test_type when generating tests or auditing.',
+                '',
+                'Aliases: review_method, analyze_method, generate_tests, write_tests, xray_diagram, visualize_flow, trace_execution, impact_analysis, impact_audit, regression_check, blast_radius, find_clones, find_deadcode.',
+            ].join('\n'),
+        },
+    ],
+}));
+// 7.5 Validate Request - Preflight check for file/method existence
+server.registerTool('validate_request', {
+    description: 'Validate file_path and optional method_name before running a TNG tool. Returns a checklist and recommendations.',
     inputSchema: {
         file_path: z.string().describe('Relative or absolute path to the source file'),
-        method_name: z.string().describe('Name of the method/function to trace'),
+        method_name: z.string().optional().describe('Name of the method/function (optional)'),
+        project_root: z.string().optional().describe('Project root to resolve relative paths (optional)'),
+    },
+}, async (args) => {
+    const filePath = String(args?.file_path || '');
+    const methodName = args?.method_name ? String(args.method_name) : '';
+    const projectRoot = args?.project_root ? String(args.project_root) : undefined;
+    const absoluteFilePath = resolveFilePath(filePath, projectRoot);
+    const exists = existsSync(absoluteFilePath);
+    let methodFound = false;
+    let methodCheckSkipped = false;
+    let methodCheckError = null;
+    if (exists && methodName) {
+        try {
+            const content = readFileSync(absoluteFilePath, 'utf8');
+            methodFound = content.includes(methodName);
+        }
+        catch (e) {
+            methodCheckError = e?.message || 'Unknown error reading file';
+        }
     }
-}, async (args) => await traceMethod(args));
-// 5. Detect Clones - Code Duplication Detection
-server.registerTool('detect_clones', {
-    description: `Detect code duplication (clones) within a file at multiple levels of similarity. This tool finds:
-- **Type 1 (Exact clones)**: Identical code except for whitespace and comments
-- **Type 2 (Renamed clones)**: Structurally identical code with different variable/function names
-- **Type 3 (Near-miss clones)**: Similar code with minor modifications (statements added/removed)
-
-Use this when the user asks to "find duplicates", "check for clones", "find repeated code", "detect copy-paste", or "find similar code".
-
-Returns: List of clone pairs with similarity scores, exact line locations, and the duplicated code snippets.
-
-**How to use the results:**
-1. Summarize the number and types of clones found
-2. Show the most significant duplications first (highest similarity or largest code blocks)
-3. Explain the impact of each duplication on maintainability
-4. Suggest refactoring strategies: extract to shared function, create a base class, use a loop, etc.
-5. Offer to help refactor the duplicated code into reusable components
-6. If no clones found, acknowledge good code organization
-
-Supports: All languages - Ruby, Python, JavaScript/TypeScript, and more.`,
-    inputSchema: {
-        file_path: z.string().describe('Relative or absolute path to the source file to analyze for duplication'),
-        level: z.string().optional().describe('Clone detection level: "1" (exact), "2" (structural), "3" (fuzzy/near-miss), or "all" (default - detects all types)'),
+    else if (!methodName) {
+        methodCheckSkipped = true;
     }
-}, async (args) => await detectClones(args));
-// 6. Detect Dead Code - Unused Code Detection
-server.registerTool('detect_deadcode', {
-    description: `Detect dead code and unused elements in a file, including:
-- **Unused imports/requires**: Modules imported but never used
-- **Unused variables**: Variables declared but never referenced
-- **Unused functions**: Private/local functions that are never called
-- **Unused parameters**: Function parameters that are never used in the function body
-- **Unreachable code**: Code that can never be executed (after return, in impossible conditions)
-
-Use this when the user asks to "find dead code", "find unused code", "check for unused imports", "clean up unused variables", or "find unreachable code".
-
-Returns: List of unused/dead code elements with exact locations, types (import/variable/function), and suggestions for cleanup.
-
-**How to use the results:**
-1. Categorize findings by type (unused imports, variables, functions, etc.)
-2. Explain why each element is considered unused
-3. Suggest safe removal of truly unused code
-4. Warn about potential false positives (e.g., variables used in eval, reflection, or external configs)
-5. Offer to remove the dead code automatically or show a cleaned-up version
-6. If the file is clean, acknowledge good code hygiene
-
-Supports: Python, JavaScript/TypeScript, Ruby (coming soon).`,
+    const projectRootDetected = exists ? (projectRoot || findProjectRoot(absoluteFilePath) || null) : null;
+    const response = {
+        ok: exists && (methodName ? methodFound : true) && !methodCheckError,
+        file: {
+            provided: filePath,
+            resolved: absoluteFilePath,
+            exists,
+        },
+        method: {
+            provided: methodName || null,
+            found: methodName ? methodFound : null,
+            skipped: methodCheckSkipped ? true : null,
+            error: methodCheckError,
+        },
+        project_root: {
+            provided: projectRoot || null,
+            detected: projectRootDetected,
+        },
+        recommendations: [
+            !exists ? 'Check file_path or provide project_root.' : null,
+            methodName && !methodFound ? 'Confirm method_name or use the exact symbol spelling.' : null,
+            methodCheckError ? `Failed to read file for method check: ${methodCheckError}` : null,
+        ].filter(Boolean),
+    };
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+    };
+});
+// 8. Request Router - Map Natural Language to a Tool
+server.registerTool('route_tng_request', {
+    description: 'Route a natural-language request to the best TNG tool and list required arguments.',
     inputSchema: {
-        file_path: z.string().describe('Relative or absolute path to the source file to analyze for dead code'),
+        request: z.string().describe('The user request to classify (e.g., "review this method", "generate tests for X")'),
+    },
+}, async (args) => {
+    const rawRequest = String(args?.request || '');
+    const request = rawRequest.toLowerCase();
+    const matchAny = (phrases) => phrases.some((p) => request.includes(p));
+    const toolOrder = [
+        { tool: 'generate_test', phrases: ['write test', 'write tests', 'generate test', 'generate tests', 'create specs', 'add test coverage', 'test coverage'] },
+        { tool: 'impact_method', phrases: ['regression', 'regression check', 'impact', 'blast radius', 'breaking change', 'breakage', 'what breaks', 'change impact'] },
+        { tool: 'audit_method', phrases: ['audit', 'review', 'analyze', 'inspect', 'check', 'security', 'vulnerab', 'bug', 'issue', 'code smell'] },
+        { tool: 'xray_method', phrases: ['diagram', 'flowchart', 'visual', 'mermaid', 'xray', 'x-ray', 'flow'] },
+        { tool: 'trace_method', phrases: ['trace', 'step through', 'step-by-step', 'execution', 'debug flow'] },
+        { tool: 'find_call_sites', phrases: ['call sites', 'callsite', 'usages', 'usage', 'where is this used', 'who calls', 'find references'] },
+        { tool: 'detect_clones', phrases: ['clone', 'duplicate', 'copy-paste', 'repeated code', 'similar code'] },
+        { tool: 'detect_deadcode', phrases: ['dead code', 'unused', 'unreachable', 'unused import', 'unused variable'] },
+    ];
+    const matched = toolOrder.find((entry) => matchAny(entry.phrases));
+    const tool = matched?.tool || null;
+    const backticks = [...rawRequest.matchAll(/`([^`]+)`/g)].map((m) => m[1]);
+    let file_path = null;
+    let method_name = null;
+    for (const token of backticks) {
+        if (token.includes('#')) {
+            const [left, right] = token.split('#');
+            if (left && (left.includes('/') || left.includes('.'))) {
+                file_path = left;
+            }
+            if (right) {
+                method_name = right;
+            }
+        }
+        else if (token.includes('/') || token.includes('.')) {
+            file_path = token;
+        }
+        else if (!method_name && /^[a-zA-Z_][a-zA-Z0-9_]*$/.test(token)) {
+            method_name = token;
+        }
     }
-}, async (args) => await detectDeadCode(args));
+    const required = [];
+    if (tool === 'audit_method' || tool === 'generate_test' || tool === 'xray_method' || tool === 'trace_method' || tool === 'impact_method' || tool === 'find_call_sites') {
+        required.push('file_path', 'method_name');
+    }
+    if (tool === 'detect_clones') {
+        required.push('file_path');
+    }
+    if (tool === 'detect_deadcode') {
+        const wantsAll = matchAny(['project', 'entire project', 'whole project', 'project-wide', 'all files', 'scan all', 'repository']);
+        if (!wantsAll) {
+            required.push('file_path');
+        }
+    }
+    const missing = required.filter((key) => (key === 'file_path' ? !file_path : !method_name));
+    const response = {
+        tool,
+        reason: tool ? `Matched keywords for ${tool}.` : 'No matching keywords found. Ask the user to clarify the intent.',
+        suggested_args: {
+            file_path,
+            method_name,
+            all: tool === 'detect_deadcode' && matchAny(['project', 'entire project', 'whole project', 'project-wide', 'all files', 'scan all', 'repository']),
+            note: tool === 'generate_test' || tool === 'audit_method'
+                ? 'For JS/Python, test_type may be required (e.g., utility, react_component, express_handler).'
+                : undefined,
+        },
+        missing_required_args: missing,
+    };
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+    };
+});
 // Start the MCP server
 async function main() {
     const transport = new StdioServerTransport();

package/dist/index.js.map

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

package/dist/tools/audit.d.ts

@@ -1,21 +1,18 @@
 interface AuditArgs {
     file_path: string;
     method_name: string;
+    class_name?: string;
     test_type?: string;
     project_root?: string;
+    response_format?: 'text' | 'json' | 'both';
+    raw_json?: boolean;
 }
 export declare function auditMethod(args: AuditArgs): Promise<{
     content: {
         type: "text";
         text: string;
     }[];
-    isError: boolean;
-} | {
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    isError?: undefined;
+    isError: boolean | undefined;
 }>;
 export {};
 //# sourceMappingURL=audit.d.ts.map