@softerist/heuristic-mcp 3.0.17 → 3.2.0

package/features/package-version.js

@@ -1,11 +1,6 @@
-/**
- * Package Version Lookup Tool
- *
- * Fetches the latest version of packages from various registries.
- * Supports npm, PyPI, crates.io, Maven, Go, RubyGems, NuGet, Packagist, Hex, pub.dev, and more.
- */
 
-// Registry configurations with their API endpoints and response parsers
+
+
 const REGISTRIES = {
   npm: {
     name: 'npm',
@@ -20,7 +15,7 @@ const REGISTRIES = {
     pattern: /^(?:pip:|pypi:)(.+)$/,
     url: (pkg) => `https://pypi.org/pypi/${encodeURIComponent(pkg)}/json`,
     parse: (data) => data.info.version,
-    detect: () => false, // Requires explicit prefix
+    detect: () => false, 
   },
   crates: {
     name: 'crates.io',
@@ -59,7 +54,7 @@ const REGISTRIES = {
     parse: (data) => {
       const pkgName = Object.keys(data.packages)[0];
       const versions = data.packages[pkgName];
-      // Filter out dev versions and get latest stable
+      
       const stable = versions.find((v) => !v.version.includes('dev'));
       return stable ? stable.version : versions[0].version;
     },
@@ -86,7 +81,7 @@ const REGISTRIES = {
     name: 'Maven Central',
     pattern: /^(?:maven:|java:)(.+)$/,
     url: (pkg) => {
-      // Maven packages are in format group:artifact or group/artifact
+      
       const [group, artifact] = pkg.includes(':') ? pkg.split(':') : pkg.split('/');
       if (!artifact) return null;
       return `https://search.maven.org/solrsearch/select?q=g:${encodeURIComponent(group)}+AND+a:${encodeURIComponent(artifact)}&rows=1&wt=json`;
@@ -114,11 +109,9 @@ const REGISTRIES = {
   },
 };
 
-/**
- * Detect the registry for a package based on its name or prefix
- */
+
 function detectRegistry(packageName) {
-  // Check for explicit prefixes first
+  
   for (const [key, registry] of Object.entries(REGISTRIES)) {
     if (registry.pattern.test(packageName) && key !== 'npm') {
       const match = packageName.match(registry.pattern);
@@ -128,7 +121,7 @@ function detectRegistry(packageName) {
     }
   }
 
-  // Try to detect based on package name patterns
+  
   for (const registry of Object.values(REGISTRIES)) {
     if (registry.detect(packageName)) {
       const match = packageName.match(registry.pattern);
@@ -136,14 +129,12 @@ function detectRegistry(packageName) {
     }
   }
 
-  // Default to npm
+  
   const npmMatch = packageName.match(REGISTRIES.npm.pattern);
   return { registry: REGISTRIES.npm, cleanName: npmMatch ? npmMatch[1] : packageName };
 }
 
-/**
- * Fetch the latest version of a package from its registry
- */
+
 async function fetchPackageVersion(packageName, timeoutMs = 10000) {
   const { registry, cleanName } = detectRegistry(packageName);
 
@@ -220,9 +211,7 @@ async function fetchPackageVersion(packageName, timeoutMs = 10000) {
   }
 }
 
-/**
- * Get supported registries list for help text
- */
+
 function getSupportedRegistries() {
   return Object.entries(REGISTRIES).map(([key, reg]) => ({
     key,
@@ -231,7 +220,7 @@ function getSupportedRegistries() {
   }));
 }
 
-// MCP Tool definition
+
 export function getToolDefinition() {
   return {
     name: 'e_check_package_version',
@@ -253,12 +242,12 @@ export function getToolDefinition() {
       readOnlyHint: true,
       destructiveHint: false,
       idempotentHint: true,
-      openWorldHint: true, // Makes external network requests
+      openWorldHint: true, 
     },
   };
 }
 
-// Tool handler
+
 export async function handleToolCall(request) {
   const args = request.params?.arguments || {};
   const packageName = args.package;
@@ -298,5 +287,5 @@ export async function handleToolCall(request) {
   }
 }
 
-// Export for testing
+
 export { fetchPackageVersion, detectRegistry, getSupportedRegistries, REGISTRIES };

package/features/register.js

@@ -3,7 +3,6 @@ import { writeFileSync } from 'fs';
 
 import path from 'path';
 import os from 'os';
-import { fileURLToPath } from 'url';
 import {
   parseJsonc,
   upsertMcpServerEntryInText,
@@ -17,9 +16,9 @@ function getUserHomeDir() {
   return os.homedir();
 }
 
-// Detect which IDE is running the install
+
 function detectCurrentIDE() {
-  // Check environment variables to determine which IDE is running
+  
   if (process.env.ANTIGRAVITY_AGENT) {
     return 'Antigravity';
   }
@@ -47,18 +46,18 @@ function detectCurrentIDE() {
     return 'Windsurf';
   }
 
-  // Claude Desktop doesn't have a known env var.
+  
   return null;
 }
 
-// Known config paths for different IDEs
+
 function getConfigPaths() {
   const platform = process.platform;
   const home = getUserHomeDir();
   const currentIDE = detectCurrentIDE();
   const allPaths = [];
 
-  // Antigravity - dedicated mcp_config.json
+  
   allPaths.push({
     name: 'Antigravity',
     path: path.join(home, '.gemini', 'antigravity', 'mcp_config.json'),
@@ -66,7 +65,7 @@ function getConfigPaths() {
     canCreate: true,
   });
 
-  // Codex - dedicated config.toml
+  
   allPaths.push({
     name: 'Codex',
     path: path.join(home, '.codex', 'config.toml'),
@@ -74,7 +73,7 @@ function getConfigPaths() {
     canCreate: true,
   });
 
-  // Claude Desktop - dedicated config file
+  
   if (platform === 'darwin') {
     allPaths.push({
       name: 'Claude Desktop',
@@ -97,7 +96,7 @@ function getConfigPaths() {
     });
   }
 
-  // Cursor - settings.json with mcpServers key
+  
   if (platform === 'darwin') {
     allPaths.push({
       name: 'Cursor',
@@ -139,7 +138,7 @@ function getConfigPaths() {
     preferredContainerKey: 'mcpServers',
   });
 
-  // Warp MCP config
+  
   allPaths.push({
     name: 'Warp',
     path: path.join(home, '.warp', 'mcp_settings.json'),
@@ -157,7 +156,7 @@ function getConfigPaths() {
     });
   }
   
-  // VS Code MCP registry (mcp.json uses "servers" key)
+  
   if (platform === 'darwin') {
     allPaths.push({
       name: 'VS Code',
@@ -212,15 +211,15 @@ function getConfigPaths() {
     });
   }
 
-  // Keep updates broad so a single install can refresh dedicated configs (Codex + Antigravity)
-  // while still avoiding creation of shared IDE settings files unless they already exist.
+  
+  
   return allPaths.map((entry) => ({
     ...entry,
     canCreate: entry.canCreate || entry.name === currentIDE,
   }));
 }
 
-// Helper to force output to terminal, bypassing npm's silence
+
 function forceLog(message) {
   try {
     if (process.platform !== 'win32') {
@@ -240,7 +239,7 @@ function normalizeIdeName(name) {
     .replace(/[\s_-]+/g, '');
 }
 
-function ideMatchesFilter(name, filter) {
+function ideMatchesFilter(name, filter) {
   if (!filter) return true;
   const normalizedName = normalizeIdeName(name);
   const normalizedFilter = normalizeIdeName(filter);
@@ -261,27 +260,41 @@ function ideMatchesFilter(name, filter) {
     return normalizedName === 'vscode' || normalizedName === 'vscodeinsiders';
   }
 
-  return false;
-}
-
-export async function register(filter = null) {
-  const binaryPath = process.execPath; // The node binary
-  const scriptPath = fileURLToPath(new URL('../index.js', import.meta.url)); // Absolute path to index.js
-  const currentIDE = detectCurrentIDE();
-
-  // Build args array - add --expose-gc if enableExplicitGc is likely needed
-  // For workspace selection, rely on runtime auto-detection (env vars + cwd) so one config
-  // can be reused across projects without editing the installed path each day.
-  const args = ['--expose-gc', scriptPath];
-
-  const serverConfig = {
-    command: binaryPath,
-    args,
-    disabled: false,
-  };
-
-  const configPaths = getConfigPaths();
-  let registeredCount = 0;
+  return false;
+}
+
+function getServerConfigForIde(name) {
+  const normalizedName = normalizeIdeName(name);
+  const config = {
+    command: 'heuristic-mcp',
+    args: [],
+  };
+
+  if (normalizedName === 'antigravity') {
+    // Prefer explicit workspace forwarding in VS Code-compatible clients.
+    // If the variable is not expanded by the IDE, CLI parsing safely ignores it.
+    config.args = [
+      '--workspace',
+      '${workspaceFolder}',
+      '--workspace',
+      '${workspaceRoot}',
+      '--workspace',
+      '${workspace}',
+    ];
+    // Allow provider-specific workspace env discovery as a backup signal.
+    config.env = {
+      HEURISTIC_MCP_ENABLE_DYNAMIC_WORKSPACE_ENV: 'true',
+    };
+  }
+
+  return config;
+}
+
+export async function register(filter = null) {
+  const currentIDE = detectCurrentIDE();
+
+  const configPaths = getConfigPaths();
+  let registeredCount = 0;
 
   forceLog(`[Auto-Register] Detecting IDE configurations...`);
 
@@ -291,7 +304,7 @@ export async function register(filter = null) {
     }
 
     try {
-      // Check if file exists - create if canCreate is true for this IDE
+      
       let fileExists = true;
 
       try {
@@ -299,7 +312,7 @@ export async function register(filter = null) {
       } catch {
         fileExists = false;
 
-        // Only create config if this IDE allows it (has dedicated MCP config file)
+        
         if (canCreate) {
           try {
             await fs.mkdir(path.dirname(configPath), { recursive: true });
@@ -311,14 +324,14 @@ export async function register(filter = null) {
             continue;
           }
         } else {
-          // Skip IDEs that use shared settings files if they don't exist
+          
           continue;
         }
       }
 
-      let content = '';
-      if (fileExists) {
-        content = await fs.readFile(configPath, 'utf-8');
+      let content = '';
+      if (fileExists) {
+        content = await fs.readFile(configPath, 'utf-8');
         if (format === 'json' && content.trim()) {
           const parsed = parseJsonc(content);
           if (!parsed) {
@@ -327,12 +340,13 @@ export async function register(filter = null) {
             );
             continue;
           }
-        }
-      }
-
-      const updated =
-        format === 'toml'
-          ? upsertMcpServerEntryInToml(content, 'heuristic-mcp', serverConfig)
+        }
+      }
+
+      const serverConfig = getServerConfigForIde(name);
+      const updated =
+        format === 'toml'
+          ? upsertMcpServerEntryInToml(content, 'heuristic-mcp', serverConfig)
           : upsertMcpServerEntryInText(
               content,
               'heuristic-mcp',
@@ -346,7 +360,7 @@ export async function register(filter = null) {
         continue;
       }
 
-      // Write back synchronously to avoid race conditions
+      
       writeFileSync(configPath, updated);
 
       forceLog(`\x1b[32m[Auto-Register] ✅ Successfully registered with ${name}\x1b[0m`);
@@ -356,18 +370,22 @@ export async function register(filter = null) {
     }
   }
 
-  if (registeredCount === 0) {
-    forceLog(`[Auto-Register] No compatible IDE configurations found to update.`);
-    forceLog(
-      `[Auto-Register] Manual Config:\n${JSON.stringify({ mcpServers: { 'heuristic-mcp': serverConfig } }, null, 2)}`
-    );
-  } else {
-    // Friendly Banner (Using forceLog to bypass npm stdout suppression)
+  if (registeredCount === 0) {
+    const manualServerConfig = {
+      command: 'heuristic-mcp',
+      args: [],
+    };
+    forceLog(`[Auto-Register] No compatible IDE configurations found to update.`);
+    forceLog(
+      `[Auto-Register] Manual Config:\n${JSON.stringify({ mcpServers: { 'heuristic-mcp': manualServerConfig } }, null, 2)}`
+    );
+  } else {
+    
     forceLog('\n\x1b[36m' + '='.repeat(60));
     forceLog('   🚀 Heuristic MCP Installed & Configured!   ');
     forceLog('='.repeat(60) + '\x1b[0m');
 
-    // Show important paths
+    
     const home = getUserHomeDir();
     const cacheRoot =
       process.platform === 'win32'

package/features/resources.js

@@ -1,58 +1,41 @@
-/**
- * MCP Resources Feature
- *
- * Exposes workspace files as MCP resources for discovery and reading.
- */
+
 
 import fs from 'fs/promises';
 import path from 'path';
 import { fdir } from 'fdir';
 import { getMimeType } from '../lib/constants.js';
 
-/**
- * Convert a file path to a file:// URI.
- * @param {string} filePath - Absolute file path
- * @returns {string}
- */
+
 function pathToUri(filePath) {
-  // Normalize path separators and encode for URI
+  
   const normalized = filePath.replace(/\\/g, '/');
-  // On Windows, paths start with drive letter like C:/
+  
   if (/^[a-zA-Z]:/.test(normalized)) {
     return `file:///${normalized}`;
   }
   return `file://${normalized}`;
 }
 
-/**
- * Convert a file:// URI back to a file path.
- * @param {string} uri
- * @returns {string}
- */
+
 function uriToPath(uri) {
   if (!uri.startsWith('file://')) {
     throw new Error(`Invalid file URI: ${uri}`);
   }
-  let filePath = uri.slice(7); // Remove 'file://'
-  // Handle Windows paths (file:///C:/...)
+  let filePath = uri.slice(7); 
+  
   if (/^\/[a-zA-Z]:/.test(filePath)) {
-    filePath = filePath.slice(1); // Remove leading /
+    filePath = filePath.slice(1); 
   }
-  // Decode URI components
+  
   filePath = decodeURIComponent(filePath);
-  // Normalize to OS path separators
+  
   if (process.platform === 'win32') {
     filePath = filePath.replace(/\//g, '\\');
   }
   return filePath;
 }
 
-/**
- * Check if a path is within the workspace directory.
- * @param {string} filePath - Absolute file path
- * @param {string} workspaceDir - Workspace directory
- * @returns {boolean}
- */
+
 function isWithinWorkspace(filePath, workspaceDir) {
   const resolvedPath = path.resolve(filePath);
   const resolvedWorkspace = path.resolve(workspaceDir);
@@ -60,24 +43,20 @@ function isWithinWorkspace(filePath, workspaceDir) {
   return !relativePath.startsWith('..') && !path.isAbsolute(relativePath);
 }
 
-/**
- * List resources handler for MCP.
- * @param {object} config - Server configuration
- * @returns {Promise<{resources: Array}>}
- */
+
 export async function handleListResources(config) {
   const workspaceDir = config.searchDirectory;
-  const maxResults = 500; // Limit to avoid overwhelming clients
+  const maxResults = 500; 
 
-  // Build set of allowed extensions from config
+  
   const allowedExtensions = new Set(
     (config.fileExtensions || []).map(ext => `.${ext.toLowerCase()}`)
   );
 
-  // Extract directory names from exclude patterns (e.g., '**/node_modules/**' -> 'node_modules')
+  
   const excludedDirs = new Set();
   for (const pattern of config.excludePatterns || []) {
-    // Match patterns like '**/dirname/**' or 'dirname/**'
+    
     const match = pattern.match(/(?:\*\*\/)?([^/*]+)(?:\/\*\*)?$/);
     if (match && match[1] && !match[1].includes('*')) {
       excludedDirs.add(match[1]);
@@ -85,7 +64,7 @@ export async function handleListResources(config) {
   }
 
   try {
-    // Use fdir to scan workspace
+    
     const crawler = new fdir()
       .withBasePath()
       .withMaxDepth(10)
@@ -117,27 +96,22 @@ export async function handleListResources(config) {
   }
 }
 
-/**
- * Read resource handler for MCP.
- * @param {string} uri - Resource URI
- * @param {object} config - Server configuration
- * @returns {Promise<{contents: Array}>}
- */
+
 export async function handleReadResource(uri, config) {
   const workspaceDir = config.searchDirectory;
 
   try {
     const filePath = uriToPath(uri);
 
-    // Security check: ensure path is within workspace
+    
     if (!isWithinWorkspace(filePath, workspaceDir)) {
       throw new Error(`Access denied: ${uri} is outside workspace`);
     }
 
-    // Check file exists
+    
     await fs.access(filePath);
 
-    // Read file content
+    
     const content = await fs.readFile(filePath, 'utf-8');
 
     return {