sdl-mcp-native 0.7.2 → 0.8.0

package/index.d.ts

@@ -3,6 +3,36 @@
 
 /* auto-generated by NAPI-RS */
 
+export interface NativeClusterSymbol {
+  symbolId: string
+}
+export interface NativeClusterEdge {
+  fromSymbolId: string
+  toSymbolId: string
+}
+export interface NativeClusterAssignment {
+  symbolId: string
+  clusterId: string
+  membershipScore: number
+}
+export interface NativeProcessSymbol {
+  symbolId: string
+  name: string
+}
+export interface NativeProcessCallEdge {
+  callerId: string
+  calleeId: string
+}
+export interface NativeProcessStep {
+  symbolId: string
+  stepOrder: number
+}
+export interface NativeProcess {
+  processId: string
+  entrySymbolId: string
+  steps: Array<NativeProcessStep>
+  depth: number
+}
 /** Input file descriptor passed from TypeScript to Rust. */
 export interface NativeFileInput {
   /** Relative path from repo root (forward slashes). */
@@ -48,6 +78,10 @@ export interface NativeParsedSymbol {
   invariantsJson: string
   /** JSON-encoded side-effects array. */
   sideEffectsJson: string
+  /** JSON-encoded role tags inferred from name/path heuristics. */
+  roleTagsJson: string
+  /** Search-oriented text including identifier splits, summary, tags, and path hints. */
+  searchText: string
 }
 /** Extracted import statement. */
 export interface NativeParsedImport {
@@ -95,26 +129,8 @@ export interface NativeParsedFile {
   /** Parse error message, if any. */
   parseError?: string
 }
-/**
- * Parse and extract symbols/imports/calls from a batch of files.
- *
- * This is the primary entry point called from TypeScript.
- * Uses Rayon for parallel processing across files.
- *
- * Returns NativeParsedFile[] with per-file results.
- */
 export declare function parseFiles(files: Array<NativeFileInput>, threadCount: number): Array<NativeParsedFile>
-/**
- * SHA-256 hash of a string, returned as lowercase hex.
- *
- * Exact parity with TypeScript `hashContent()` in `util/hashing.ts`.
- * Exported for cross-validation in parity tests.
- */
 export declare function hashContentNative(content: string): string
-/**
- * Generate a stable symbol ID.
- *
- * Exact parity with TypeScript `generateSymbolId()` in `util/hashing.ts`.
- * Exported for cross-validation in parity tests.
- */
 export declare function generateSymbolIdNative(repoId: string, relPath: string, kind: string, name: string, fingerprint: string): string
+export declare function computeClusters(symbols: Array<NativeClusterSymbol>, edges: Array<NativeClusterEdge>, minClusterSize: number): Array<NativeClusterAssignment>
+export declare function traceProcesses(symbols: Array<NativeProcessSymbol>, callEdges: Array<NativeProcessCallEdge>, maxDepth: number, entryPatterns: Array<string>): Array<NativeProcess>

package/index.js

@@ -1,146 +1,146 @@
-/* eslint-disable */
-
-/**
- * Platform-detection loader for sdl-mcp-native.
- *
- * Standard napi-rs pattern: detects process.platform/process.arch and loads
- * the correct prebuilt binary from per-platform npm packages.
- */
-
-const { existsSync, readFileSync } = require("fs");
-const { join } = require("path");
-
-/**
- * Determine the platform package name based on current OS/arch/libc.
- * @returns {string | null}
- */
-function getPackageName() {
-  const platform = process.platform;
-  const arch = process.arch;
-
-  if (platform === "win32" && arch === "x64") {
-    return "sdl-mcp-native-win32-x64-msvc";
-  }
-  if (platform === "darwin" && arch === "x64") {
-    return "sdl-mcp-native-darwin-x64";
-  }
-  if (platform === "darwin" && arch === "arm64") {
-    return "sdl-mcp-native-darwin-arm64";
-  }
-  if (platform === "linux" && arch === "x64") {
-    // Detect musl vs glibc
-    if (isMusl()) {
-      return "sdl-mcp-native-linux-x64-musl";
-    }
-    return "sdl-mcp-native-linux-x64-gnu";
-  }
-  if (platform === "linux" && arch === "arm64") {
-    return "sdl-mcp-native-linux-arm64-gnu";
-  }
-
-  return null;
-}
-
-/**
- * Detect musl libc on Linux.
- * @returns {boolean}
- */
-function isMusl() {
-  // Check if we're running on Alpine or musl-based distro
-  try {
-    const output = readFileSync("/usr/bin/ldd", "utf8");
-    if (output.includes("musl")) return true;
-  } catch {
-    // ldd not readable
-  }
-
-  try {
-    if (existsSync("/etc/alpine-release")) return true;
-  } catch {
-    // not alpine
-  }
-
-  // Check the dynamic linker
-  try {
-    const maps = readFileSync("/proc/self/maps", "utf8");
-    if (maps.includes("musl")) return true;
-  } catch {
-    // /proc not available
-  }
-
-  return false;
-}
-
-/**
- * Map platform package names to their .node file suffix.
- */
-const PLATFORM_NODE_FILES = {
-  "sdl-mcp-native-win32-x64-msvc": "sdl-mcp-native.win32-x64-msvc.node",
-  "sdl-mcp-native-darwin-x64": "sdl-mcp-native.darwin-x64.node",
-  "sdl-mcp-native-darwin-arm64": "sdl-mcp-native.darwin-arm64.node",
-  "sdl-mcp-native-linux-x64-gnu": "sdl-mcp-native.linux-x64-gnu.node",
-  "sdl-mcp-native-linux-x64-musl": "sdl-mcp-native.linux-x64-musl.node",
-  "sdl-mcp-native-linux-arm64-gnu": "sdl-mcp-native.linux-arm64-gnu.node",
-};
-
-let nativeBinding = null;
-let loadError = null;
-
-const packageName = getPackageName();
-
-if (packageName) {
-  const nodeFileName = PLATFORM_NODE_FILES[packageName];
-
-  // 1. Try local platform-suffixed .node file (dev builds via napi artifacts)
-  const localPlatformPath = join(__dirname, nodeFileName);
-  if (existsSync(localPlatformPath)) {
-    try {
-      nativeBinding = require(localPlatformPath);
-    } catch (e) {
-      loadError = e;
-    }
-  }
-
-  // 2. Try per-platform npm package
-  if (!nativeBinding) {
-    try {
-      nativeBinding = require(packageName);
-    } catch (e) {
-      loadError = e;
-    }
-  }
-
-  // 3. Try legacy local files (backward compat with dev builds)
-  if (!nativeBinding) {
-    const legacyPaths = [
-      join(__dirname, "sdl-mcp-native.node"),
-      join(__dirname, "index.node"),
-    ];
-    for (const p of legacyPaths) {
-      if (existsSync(p)) {
-        try {
-          nativeBinding = require(p);
-          break;
-        } catch (e) {
-          loadError = e;
-        }
-      }
-    }
-  }
-} else {
-  loadError = new Error(
-    `Unsupported platform: ${process.platform}-${process.arch}. ` +
-    `sdl-mcp-native supports: win32-x64, darwin-x64, darwin-arm64, linux-x64, linux-arm64`
-  );
-}
-
-if (!nativeBinding) {
-  if (loadError) {
-    throw loadError;
-  }
-  throw new Error("Failed to load sdl-mcp-native native binding");
-}
-
-module.exports.parseFiles = nativeBinding.parseFiles;
-module.exports.hashContentNative = nativeBinding.hashContentNative;
-module.exports.generateSymbolIdNative = nativeBinding.generateSymbolIdNative;
+/* eslint-disable */
+
+/**
+ * Platform-detection loader for sdl-mcp-native.
+ *
+ * Standard napi-rs pattern: detects process.platform/process.arch and loads
+ * the correct prebuilt binary from per-platform npm packages.
+ */
+
+const { existsSync, readFileSync } = require("fs");
+const { join } = require("path");
+
+/**
+ * Determine the platform package name based on current OS/arch/libc.
+ * @returns {string | null}
+ */
+function getPackageName() {
+  const platform = process.platform;
+  const arch = process.arch;
+
+  if (platform === "win32" && arch === "x64") {
+    return "sdl-mcp-native-win32-x64-msvc";
+  }
+  if (platform === "darwin" && arch === "x64") {
+    return "sdl-mcp-native-darwin-x64";
+  }
+  if (platform === "darwin" && arch === "arm64") {
+    return "sdl-mcp-native-darwin-arm64";
+  }
+  if (platform === "linux" && arch === "x64") {
+    // Detect musl vs glibc
+    if (isMusl()) {
+      return "sdl-mcp-native-linux-x64-musl";
+    }
+    return "sdl-mcp-native-linux-x64-gnu";
+  }
+  if (platform === "linux" && arch === "arm64") {
+    return "sdl-mcp-native-linux-arm64-gnu";
+  }
+
+  return null;
+}
+
+/**
+ * Detect musl libc on Linux.
+ * @returns {boolean}
+ */
+function isMusl() {
+  // Check if we're running on Alpine or musl-based distro
+  try {
+    const output = readFileSync("/usr/bin/ldd", "utf8");
+    if (output.includes("musl")) return true;
+  } catch {
+    // ldd not readable
+  }
+
+  try {
+    if (existsSync("/etc/alpine-release")) return true;
+  } catch {
+    // not alpine
+  }
+
+  // Check the dynamic linker
+  try {
+    const maps = readFileSync("/proc/self/maps", "utf8");
+    if (maps.includes("musl")) return true;
+  } catch {
+    // /proc not available
+  }
+
+  return false;
+}
+
+/**
+ * Map platform package names to their .node file suffix.
+ */
+const PLATFORM_NODE_FILES = {
+  "sdl-mcp-native-win32-x64-msvc": "sdl-mcp-native.win32-x64-msvc.node",
+  "sdl-mcp-native-darwin-x64": "sdl-mcp-native.darwin-x64.node",
+  "sdl-mcp-native-darwin-arm64": "sdl-mcp-native.darwin-arm64.node",
+  "sdl-mcp-native-linux-x64-gnu": "sdl-mcp-native.linux-x64-gnu.node",
+  "sdl-mcp-native-linux-x64-musl": "sdl-mcp-native.linux-x64-musl.node",
+  "sdl-mcp-native-linux-arm64-gnu": "sdl-mcp-native.linux-arm64-gnu.node",
+};
+
+let nativeBinding = null;
+let loadError = null;
+
+const packageName = getPackageName();
+
+if (packageName) {
+  const nodeFileName = PLATFORM_NODE_FILES[packageName];
+
+  // 1. Try local platform-suffixed .node file (dev builds via napi artifacts)
+  const localPlatformPath = join(__dirname, nodeFileName);
+  if (existsSync(localPlatformPath)) {
+    try {
+      nativeBinding = require(localPlatformPath);
+    } catch (e) {
+      loadError = e;
+    }
+  }
+
+  // 2. Try per-platform npm package
+  if (!nativeBinding) {
+    try {
+      nativeBinding = require(packageName);
+    } catch (e) {
+      loadError = e;
+    }
+  }
+
+  // 3. Try legacy local files (backward compat with dev builds)
+  if (!nativeBinding) {
+    const legacyPaths = [
+      join(__dirname, "sdl-mcp-native.node"),
+      join(__dirname, "index.node"),
+    ];
+    for (const p of legacyPaths) {
+      if (existsSync(p)) {
+        try {
+          nativeBinding = require(p);
+          break;
+        } catch (e) {
+          loadError = e;
+        }
+      }
+    }
+  }
+} else {
+  loadError = new Error(
+    `Unsupported platform: ${process.platform}-${process.arch}. ` +
+    `sdl-mcp-native supports: win32-x64, darwin-x64, darwin-arm64, linux-x64, linux-arm64`
+  );
+}
+
+if (!nativeBinding) {
+  if (loadError) {
+    throw loadError;
+  }
+  throw new Error("Failed to load sdl-mcp-native native binding");
+}
+
+module.exports.parseFiles = nativeBinding.parseFiles;
+module.exports.hashContentNative = nativeBinding.hashContentNative;
+module.exports.generateSymbolIdNative = nativeBinding.generateSymbolIdNative;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdl-mcp-native",
-  "version": "0.7.2",
+  "version": "0.8.0",
   "description": "Native Rust indexer for SDL-MCP with tree-sitter parsing and Rayon parallelism",
   "license": "SEE LICENSE IN LICENSE",
   "main": "index.js",
@@ -29,12 +29,12 @@
     "version": "napi version"
   },
   "optionalDependencies": {
-    "sdl-mcp-native-win32-x64-msvc": "0.7.2",
-    "sdl-mcp-native-darwin-x64": "0.7.2",
-    "sdl-mcp-native-darwin-arm64": "0.7.2",
-    "sdl-mcp-native-linux-x64-gnu": "0.7.2",
-    "sdl-mcp-native-linux-x64-musl": "0.7.2",
-    "sdl-mcp-native-linux-arm64-gnu": "0.7.2"
+    "sdl-mcp-native-win32-x64-msvc": "0.8.0",
+    "sdl-mcp-native-darwin-x64": "0.8.0",
+    "sdl-mcp-native-darwin-arm64": "0.8.0",
+    "sdl-mcp-native-linux-x64-gnu": "0.8.0",
+    "sdl-mcp-native-linux-x64-musl": "0.8.0",
+    "sdl-mcp-native-linux-arm64-gnu": "0.8.0"
   },
   "repository": {
     "type": "git",