sdl-mcp-native 0.7.1

package/index.d.ts

@@ -0,0 +1,120 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+/** Input file descriptor passed from TypeScript to Rust. */
+export interface NativeFileInput {
+  /** Relative path from repo root (forward slashes). */
+  relPath: string
+  /** Absolute path on disk. */
+  absolutePath: string
+  /** Repository identifier. */
+  repoId: string
+  /** Language identifier (e.g., "ts", "tsx", "js", "py", "go"). */
+  language: string
+}
+/** Range within a source file (1-indexed lines, 0-indexed columns). */
+export interface NativeRange {
+  startLine: number
+  startCol: number
+  endLine: number
+  endCol: number
+}
+/** Extracted symbol from AST analysis. */
+export interface NativeParsedSymbol {
+  /** Stable symbol ID: sha256("{repoId}:{relPath}:{kind}:{name}:{astFingerprint}"). */
+  symbolId: string
+  /** AST fingerprint hash. */
+  astFingerprint: string
+  /**
+   * Symbol kind: "function", "class", "interface", "type_alias", "method",
+   * "constructor", "variable", "module", "enum", "property".
+   */
+  kind: string
+  /** Symbol name. */
+  name: string
+  /** Whether the symbol is exported. */
+  exported: boolean
+  /** Visibility: "public", "private", "protected", "internal", or empty. */
+  visibility: string
+  /** Source range. */
+  range: NativeRange
+  /** JSON-encoded signature object. */
+  signatureJson: string
+  /** One-line summary from JSDoc or auto-generated. */
+  summary: string
+  /** JSON-encoded invariants array. */
+  invariantsJson: string
+  /** JSON-encoded side-effects array. */
+  sideEffectsJson: string
+}
+/** Extracted import statement. */
+export interface NativeParsedImport {
+  /** Module specifier (e.g., "./utils.js", "lodash"). */
+  specifier: string
+  /** Whether the import is relative (starts with . or ..). */
+  isRelative: boolean
+  /** Whether the import is from an external package. */
+  isExternal: boolean
+  /** Named imports (e.g., ["foo", "bar"]). */
+  namedImports: Array<string>
+  /** Default import name, if any. */
+  defaultImport?: string
+  /** Namespace import name (e.g., "* as ns"), if any. */
+  namespaceImport?: string
+  /** Source range. */
+  range: NativeRange
+}
+/** Extracted call site. */
+export interface NativeParsedCall {
+  /** Node ID of the caller (enclosing symbol). */
+  callerName: string
+  /** Callee identifier (e.g., "foo", "this.bar", "ns.baz"). */
+  calleeIdentifier: string
+  /**
+   * Call type: "direct", "method", "constructor", "super", "tagged_template",
+   * "optional_chain", "computed".
+   */
+  callType: string
+  /** Source range. */
+  range: NativeRange
+}
+/** Complete parse result for a single file. */
+export interface NativeParsedFile {
+  /** Relative path (matches input). */
+  relPath: string
+  /** SHA-256 hex digest of file content. */
+  contentHash: string
+  /** Extracted symbols. */
+  symbols: Array<NativeParsedSymbol>
+  /** Extracted imports. */
+  imports: Array<NativeParsedImport>
+  /** Extracted calls. */
+  calls: Array<NativeParsedCall>
+  /** 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

package/index.js

@@ -0,0 +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;

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "sdl-mcp-native",
+  "version": "0.7.1",
+  "description": "Native Rust indexer for SDL-MCP with tree-sitter parsing and Rayon parallelism",
+  "license": "SEE LICENSE IN LICENSE",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": [
+    "index.js",
+    "index.d.ts"
+  ],
+  "napi": {
+    "name": "sdl-mcp-native",
+    "triples": {
+      "defaults": false,
+      "additional": [
+        "x86_64-pc-windows-msvc",
+        "x86_64-apple-darwin",
+        "aarch64-apple-darwin",
+        "x86_64-unknown-linux-gnu",
+        "x86_64-unknown-linux-musl",
+        "aarch64-unknown-linux-gnu"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "napi build --release --cargo-cwd . --config package.json .",
+    "artifacts": "napi artifacts",
+    "version": "napi version"
+  },
+  "optionalDependencies": {
+    "sdl-mcp-native-win32-x64-msvc": "0.7.1",
+    "sdl-mcp-native-darwin-x64": "0.7.1",
+    "sdl-mcp-native-darwin-arm64": "0.7.1",
+    "sdl-mcp-native-linux-x64-gnu": "0.7.1",
+    "sdl-mcp-native-linux-x64-musl": "0.7.1",
+    "sdl-mcp-native-linux-arm64-gnu": "0.7.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GlitterKill/sdl-mcp.git",
+    "directory": "native"
+  }
+}