mcp-code-context 2.1.3 → 2.2.0

package/dist/tests/test-backup-system.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tests for Centralized Backup System
+ * - Backup creation in project root
+ * - Folder structure preservation
+ * - clean_backups functionality
+ */
+export {};

package/dist/tests/test-backup-system.js

@@ -0,0 +1,152 @@
+/**
+ * Tests for Centralized Backup System
+ * - Backup creation in project root
+ * - Folder structure preservation
+ * - clean_backups functionality
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { createBackup, cleanAllBackups } from '../src/utils/backupManager.js';
+import { findProjectRoot } from '../src/utils/projectRoot.js';
+const TEST_DIR = path.join(process.cwd(), 'tests', 'fixtures', 'backup-test-project');
+const TEST_FILE = path.join(TEST_DIR, 'src', 'components', 'Button.tsx');
+function setupTestProject() {
+    // Create test project structure
+    if (fs.existsSync(TEST_DIR)) {
+        fs.rmSync(TEST_DIR, { recursive: true, force: true });
+    }
+    fs.mkdirSync(path.join(TEST_DIR, 'src', 'components'), { recursive: true });
+    fs.writeFileSync(TEST_FILE, 'export const Button = () => <button>Click</button>;');
+    // Create package.json to mark as project root
+    fs.writeFileSync(path.join(TEST_DIR, 'package.json'), JSON.stringify({ name: 'backup-test-project' }));
+}
+function cleanupTestProject() {
+    if (fs.existsSync(TEST_DIR)) {
+        fs.rmSync(TEST_DIR, { recursive: true, force: true });
+    }
+}
+function runTests() {
+    console.log('\n🧪 Testing Centralized Backup System...\n');
+    let passed = 0;
+    let failed = 0;
+    // Setup
+    setupTestProject();
+    try {
+        // Test 1: Find project root
+        console.log('Test 1: Find project root');
+        const projectRoot = findProjectRoot(TEST_FILE);
+        if (projectRoot === TEST_DIR) {
+            console.log('✅ PASS: Project root found correctly');
+            passed++;
+        }
+        else {
+            console.log(`❌ FAIL: Expected ${TEST_DIR}, got ${projectRoot}`);
+            failed++;
+        }
+        // Test 2: Create backup in centralized location
+        console.log('\nTest 2: Create backup in centralized location');
+        const backupPath = createBackup(TEST_FILE);
+        const expectedBackupDir = path.join(TEST_DIR, '.mcp-backups', 'src', 'components');
+        const backupExists = fs.existsSync(backupPath);
+        const inCorrectLocation = backupPath.startsWith(expectedBackupDir);
+        if (backupExists && inCorrectLocation) {
+            console.log('✅ PASS: Backup created in centralized location');
+            console.log(`   Location: ${backupPath}`);
+            passed++;
+        }
+        else {
+            console.log('❌ FAIL: Backup not in correct location');
+            console.log(`   Expected dir: ${expectedBackupDir}`);
+            console.log(`   Actual path: ${backupPath}`);
+            failed++;
+        }
+        // Test 3: Backup preserves folder structure
+        console.log('\nTest 3: Backup preserves folder structure');
+        const relativePath = path.relative(TEST_DIR, TEST_FILE);
+        const expectedStructure = path.join('.mcp-backups', relativePath);
+        const actualStructure = path.relative(TEST_DIR, backupPath.replace(/\.\d+\.backup$/, ''));
+        if (actualStructure.startsWith(expectedStructure)) {
+            console.log('✅ PASS: Folder structure preserved');
+            console.log(`   Structure: ${expectedStructure}`);
+            passed++;
+        }
+        else {
+            console.log('❌ FAIL: Folder structure not preserved');
+            console.log(`   Expected: ${expectedStructure}`);
+            console.log(`   Actual: ${actualStructure}`);
+            failed++;
+        }
+        // Test 4: Multiple backups in same location
+        console.log('\nTest 4: Multiple backups (rolling system)');
+        const backup2 = createBackup(TEST_FILE);
+        const backup3 = createBackup(TEST_FILE);
+        const allBackups = fs.readdirSync(expectedBackupDir)
+            .filter(f => f.startsWith('Button.tsx.') && f.endsWith('.backup'));
+        if (allBackups.length === 3) {
+            console.log('✅ PASS: Multiple backups created');
+            console.log(`   Backups: ${allBackups.join(', ')}`);
+            passed++;
+        }
+        else {
+            console.log(`❌ FAIL: Expected 3 backups, found ${allBackups.length}`);
+            failed++;
+        }
+        // Test 5: clean_backups removes all backups
+        console.log('\nTest 5: clean_backups removes all backups');
+        const result = cleanAllBackups(TEST_DIR);
+        const backupDirExists = fs.existsSync(path.join(TEST_DIR, '.mcp-backups'));
+        if (result && !backupDirExists) {
+            console.log('✅ PASS: All backups cleaned');
+            console.log(`   Backup directory removed successfully`);
+            passed++;
+        }
+        else {
+            console.log('❌ FAIL: Backups not cleaned properly');
+            console.log(`   Result: ${result}, Dir exists: ${backupDirExists}`);
+            failed++;
+        }
+        // Test 6: clean_backups on non-existent directory
+        console.log('\nTest 6: clean_backups on non-existent directory');
+        const result2 = cleanAllBackups(TEST_DIR);
+        if (!result2) {
+            console.log('✅ PASS: Returns false when backup directory not found');
+            passed++;
+        }
+        else {
+            console.log('❌ FAIL: Should return false when directory not found');
+            failed++;
+        }
+        // Test 7: Backup in nested project structure
+        console.log('\nTest 7: Backup in deeply nested file');
+        const deepFile = path.join(TEST_DIR, 'src', 'features', 'auth', 'components', 'LoginForm.tsx');
+        fs.mkdirSync(path.dirname(deepFile), { recursive: true });
+        fs.writeFileSync(deepFile, 'export const LoginForm = () => <form />;');
+        const deepBackup = createBackup(deepFile);
+        const expectedDeepDir = path.join(TEST_DIR, '.mcp-backups', 'src', 'features', 'auth', 'components');
+        if (deepBackup.startsWith(expectedDeepDir)) {
+            console.log('✅ PASS: Deep nesting preserved');
+            console.log(`   Path: ${path.relative(TEST_DIR, deepBackup)}`);
+            passed++;
+        }
+        else {
+            console.log('❌ FAIL: Deep nesting not preserved');
+            failed++;
+        }
+    }
+    catch (error) {
+        console.log(`❌ FAIL: Unexpected error: ${error}`);
+        failed++;
+    }
+    finally {
+        // Cleanup
+        cleanupTestProject();
+    }
+    console.log('\n══════════════════════════════════════════════════');
+    console.log(`📊 Results: ${passed} passed, ${failed} failed (${passed + failed} total)`);
+    console.log('══════════════════════════════════════════════════\n');
+    if (failed > 0) {
+        process.exit(1);
+    }
+}
+runTests();
+//# sourceMappingURL=test-backup-system.js.map

package/dist/tests/test-backup-system.js.map

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

package/dist/tests/test-new-tools.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Test suite for new tools: read_file_lines and search_code_pattern
+ */
+export {};

package/dist/tests/test-new-tools.js

@@ -0,0 +1,147 @@
+/**
+ * Test suite for new tools: read_file_lines and search_code_pattern
+ */
+import { readFileLines } from "../src/tools/readFileLines.js";
+import { searchCodePattern } from "../src/tools/searchCodePattern.js";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Create test file
+const testDir = path.join(__dirname, "test-data");
+const testFile = path.join(testDir, "sample.ts");
+if (!fs.existsSync(testDir)) {
+    fs.mkdirSync(testDir, { recursive: true });
+}
+const testContent = `// Sample TypeScript file
+export class Calculator {
+  add(a: number, b: number): number {
+    return a + b;
+  }
+
+  subtract(a: number, b: number): number {
+    return a - b;
+  }
+
+  multiply(a: number, b: number): number {
+    return a * b;
+  }
+
+  divide(a: number, b: number): number {
+    if (b === 0) throw new Error("Division by zero");
+    return a / b;
+  }
+}
+
+export function greet(name: string): string {
+  return \`Hello, \${name}!\`;
+}
+`;
+fs.writeFileSync(testFile, testContent, "utf-8");
+console.log("🧪 Testing read_file_lines...\n");
+// Test 1: Read exact line range
+console.log("Test 1: Read lines 3-7");
+const result1 = readFileLines({
+    filePath: testFile,
+    startLine: 3,
+    endLine: 7,
+});
+if (result1.success && result1.content?.includes("add")) {
+    console.log("✅ PASS: Exact line range");
+}
+else {
+    console.error("❌ FAIL: Exact line range");
+    console.error(result1);
+}
+// Test 2: Read around pattern
+console.log("\nTest 2: Read around pattern 'multiply'");
+const result2 = readFileLines({
+    filePath: testFile,
+    aroundPattern: "multiply",
+    contextLines: 2,
+});
+if (result2.success && result2.content?.includes("multiply")) {
+    console.log("✅ PASS: Pattern search");
+}
+else {
+    console.error("❌ FAIL: Pattern search");
+    console.error(result2);
+}
+// Test 3: Invalid line range
+console.log("\nTest 3: Invalid line range (should fail)");
+const result3 = readFileLines({
+    filePath: testFile,
+    startLine: 100,
+    endLine: 200,
+});
+if (!result3.success && result3.error?.includes("Invalid line range")) {
+    console.log("✅ PASS: Error handling for invalid range");
+}
+else {
+    console.error("❌ FAIL: Should have failed with invalid range");
+}
+// Test 4: Pattern not found
+console.log("\nTest 4: Pattern not found (should fail)");
+const result4 = readFileLines({
+    filePath: testFile,
+    aroundPattern: "nonexistent_pattern_xyz",
+});
+if (!result4.success && result4.error?.includes("not found")) {
+    console.log("✅ PASS: Error handling for pattern not found");
+}
+else {
+    console.error("❌ FAIL: Should have failed with pattern not found");
+}
+console.log("\n🧪 Testing search_code_pattern...\n");
+// Test 5: Search for pattern
+console.log("Test 5: Search for 'Calculator'");
+const result5 = searchCodePattern({
+    rootDir: testDir,
+    pattern: "Calculator",
+    fileExtensions: [".ts"],
+    maxResults: 10,
+});
+if (result5.success && result5.matches && result5.matches.length > 0) {
+    console.log(`✅ PASS: Found ${result5.totalMatches} matches`);
+}
+else {
+    console.error("❌ FAIL: Should have found matches");
+    console.error(result5);
+}
+// Test 6: Search with no matches
+console.log("\nTest 6: Search for non-existent pattern");
+const result6 = searchCodePattern({
+    rootDir: testDir,
+    pattern: "NonExistentClass123",
+    fileExtensions: [".ts"],
+});
+if (result6.success && result6.totalMatches === 0) {
+    console.log("✅ PASS: No matches found (as expected)");
+}
+else {
+    console.error("❌ FAIL: Should have found no matches");
+}
+// Test 7: Search with context
+console.log("\nTest 7: Search with context lines");
+const result7 = searchCodePattern({
+    rootDir: testDir,
+    pattern: "divide",
+    fileExtensions: [".ts"],
+    showContext: true,
+    contextLines: 2,
+});
+if (result7.success &&
+    result7.matches &&
+    result7.matches[0]?.context &&
+    result7.matches[0].context.length > 0) {
+    console.log("✅ PASS: Context lines included");
+}
+else {
+    console.error("❌ FAIL: Context lines not included");
+    console.error(result7);
+}
+// Cleanup
+fs.rmSync(testDir, { recursive: true, force: true });
+console.log("\n✨ All tests completed!");
+//# sourceMappingURL=test-new-tools.js.map

package/dist/tests/test-new-tools.js.map

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

package/llms.txt

@@ -57,24 +57,79 @@ This MCP server solves two problems:
 
 **Best used when:** You're about to modify a file and need to understand the blast radius.
 
-#### 4. `rollback_file`
+#### 4. `read_file_lines`
+**Purpose:** Read specific line ranges from a file without loading the entire content.
+
+**Input:**
+- `filePath` (required): Absolute path to the source file.
+- `startLine` (optional): Starting line number (1-indexed).
+- `endLine` (optional): Ending line number (1-indexed).
+- `aroundPattern` (optional): Search pattern to find and return surrounding lines.
+- `contextLines` (optional): Number of lines before/after pattern (default: 5).
+
+**What it does:**
+- **Mode 1 (Exact Range)**: When `startLine` and `endLine` are provided, returns only those lines.
+- **Mode 2 (Pattern Search)**: When `aroundPattern` is provided, finds the first occurrence and returns surrounding lines with context.
+- Validates line ranges and provides clear error messages.
+- 90% token savings compared to reading full files for small fragments.
+
+**Best used when:** 
+- Debugging specific code blocks when you know the line numbers
+- Viewing context around error messages or logs
+- Extracting small fragments without AST parsing overhead
+
+**Example use cases:**
+- "Show me lines 120-135 of coordinator.dart"
+- "Show me the code around 'HeroBannerWidget' in hero_banner_widget.dart"
+
+#### 5. `search_code_pattern`
+**Purpose:** Search for code patterns across multiple files in a repository.
+
+**Input:**
+- `rootDir` (required): Absolute path to the repository root.
+- `pattern` (required): Regular expression pattern to search for.
+- `fileExtensions` (optional): Array of extensions to search (e.g., `[".ts", ".dart"]`). Defaults to common code extensions.
+- `excludeDirs` (optional): Directories to exclude (default: `["node_modules", "dist", "build"]`).
+- `showContext` (optional): Include surrounding lines (default: true).
+- `contextLines` (optional): Number of context lines before/after (default: 3).
+- `maxResults` (optional): Maximum matches to return (default: 50).
+
+**What it does:**
+- Walks the repository respecting `.gitignore` rules.
+- Searches for regex patterns across all matching files.
+- Returns structured results with file paths, line numbers, and optional context.
+- Highlights the matching line with a `>` marker in context output.
+- 85% more efficient than manual grep + analysis workflows.
+
+**Best used when:**
+- Finding all usages of a function or variable
+- Locating specific log statements or debug markers
+- Discovering patterns across the codebase
+- Understanding how a feature is implemented across files
+
+**Example use cases:**
+- "Find all occurrences of 'widget.height' in the Flutter project"
+- "Search for '🎯 \[BUILDER\]' logs in .dart files"
+- "Find all files that call 'HeroBannerWidget'"
+
+#### 6. `rollback_file`
 **Purpose:** Restores a file to a previous state from the automated backup system.
 **Input:**
 - `filePath` (required): Absolute path.
 - `steps` (optional): Number of versions to go back (1-5, default: 1).
 **What it does:** Reverts the file to the state it was in before the last 1-5 modifications.
 
-### Write Tools (v2.1.3 Mandatory Workflow)
+### Write Tools (v2.2.0 Mandatory Workflow)
 
 All write tools follow a **Two-Phase Workflow**:
 1. **Phase 1 (Preview)**: Call without a token to get a unified `diff` and a `confirmationToken`.
 2. **Phase 2 (Apply)**: Call with `confirmationToken` and `confirm: true` to apply the changes.
 
-**Important Notes (v2.1.3):**
+**Important Notes (v2.2.0):**
 - ✅ **Windows CRLF Support**: Fully resolved. All operations work correctly on Windows files with CRLF line endings.
 - ✅ **Parameter Brace Handling**: Methods with braces in parameters (e.g., `{int? cart}`) are now handled correctly.
 
-#### 5. `write_file_surgical`
+#### 7. `write_file_surgical`
 **Purpose:** Replace the full source code of a named symbol in a file.
 
 **Input:**
@@ -93,7 +148,7 @@ All write tools follow a **Two-Phase Workflow**:
 
 **Best used when:** You need to modify a specific function or method without touching the rest of the file.
 
-#### 5. `insert_symbol`
+#### 8. `insert_symbol`
 **Purpose:** Insert new code at a precise location relative to an existing symbol.
 
 **Input:**
@@ -110,7 +165,7 @@ All write tools follow a **Two-Phase Workflow**:
 
 **Best used when:** Adding new methods to a class or new functions to a module.
 
-#### 6. `rename_symbol`
+#### 9. `rename_symbol`
 **Purpose:** Rename a symbol across an entire repository.
 
 **Input:**
@@ -129,7 +184,7 @@ All write tools follow a **Two-Phase Workflow**:
 
 **Best used when:** Refactoring a class, function, or method name that is used across multiple files.
 
-#### 7. `remove_symbol`
+#### 10. `remove_symbol`
 **Purpose:** Safely remove a symbol from a file.
 
 **Input:**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-code-context",
-  "version": "2.1.3",
+  "version": "2.2.0",
   "description": "Powerful MCP server for LLM-ready semantic code context and surgical AST-aware editing. Supports TypeScript, JavaScript, PHP, Dart, and Python.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -11,7 +11,7 @@
     "build": "tsc",
     "start": "node dist/src/index.js",
     "dev": "tsc && node dist/src/index.js",
-    "test": "npm run build && node dist/tests/test-dart.js && node dist/tests/test-php.js && node dist/tests/writers/test-write-smoke.js",
+    "test": "npm run build && node dist/tests/test-dart.js && node dist/tests/test-php.js && node dist/tests/writers/test-write-smoke.js && node dist/tests/test-new-tools.js && node dist/tests/test-backup-system.js",
     "clean": "rimraf dist",
     "rebuild": "npm run clean && npm run build"
   },