@akiojin/unity-mcp-server 2.41.0 → 2.41.2

package/README.md

@@ -357,6 +357,13 @@ npm install -g @akiojin/unity-mcp-server
 
 Full source code and documentation: <https://github.com/akiojin/unity-mcp-server>
 
+## Release Automation
+
+- Releases are generated by release-please on `main`; run `scripts/create-release-branch.sh` to open the `chore(release): x.y.z` PR (auto-merge after checks).
+- Required checks: Markdown, ESLint & Formatting / Commit Message Lint / Test & Coverage / Package.
+- Tags trigger `publish.yml` to push npm, OpenUPM (via tag), and csharp-lsp artifacts; Unity package version is kept in sync via release-please extra-files.
+- If OpenUPM lags, create a new release so the tag and Unity package version match.
+
 ## License
 
 MIT License - see LICENSE file for details.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akiojin/unity-mcp-server",
-  "version": "2.41.0",
+  "version": "2.41.2",
   "description": "MCP server and Unity Editor bridge — enables AI assistants to control Unity for AI-assisted workflows",
   "type": "module",
   "main": "src/core/server.js",
@@ -70,6 +70,7 @@
   "files": [
     "src/",
     "bin/",
+    "scripts/ensure-better-sqlite3.mjs",
     "prebuilt/",
     "README.md",
     "LICENSE"
@@ -81,11 +82,6 @@
   "devDependencies": {
     "@commitlint/cli": "^18.6.1",
     "@commitlint/config-conventional": "^18.6.3",
-    "@semantic-release/changelog": "^6.0.3",
-    "@semantic-release/commit-analyzer": "^11.1.0",
-    "@semantic-release/exec": "^6.0.3",
-    "@semantic-release/git": "^10.0.1",
-    "@semantic-release/release-notes-generator": "^12.1.0",
     "c8": "^10.1.3",
     "eslint": "^8.57.1",
     "eslint-config-standard": "^17.1.0",
@@ -95,7 +91,6 @@
     "husky": "^9.1.7",
     "markdownlint-cli": "^0.43.0",
     "nodemon": "^3.1.7",
-    "prettier": "^3.4.2",
-    "semantic-release": "^22.0.12"
+    "prettier": "^3.4.2"
   }
 }

package/prebuilt/better-sqlite3/manifest.json

@@ -1,3 +1,11 @@
 {
-  "artifacts": []
+  "artifacts": [
+    {
+      "platformKey": "linux-x64-node22",
+      "checksum": null,
+      "node": null,
+      "generatedAt": null,
+      "size": 2066648
+    }
+  ]
 }

package/scripts/ensure-better-sqlite3.mjs

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+// Ensure better-sqlite3 native binding exists. Prefers bundled prebuilt binaries, otherwise
+// optionally attempts a native rebuild (opt-in to avoid first-time npx timeouts).
+import fs from 'fs';
+import path from 'path';
+import { spawnSync } from 'child_process';
+import { fileURLToPath } from 'url';
+
+const SCRIPT_PATH = fileURLToPath(import.meta.url);
+const PKG_ROOT = path.resolve(path.dirname(SCRIPT_PATH), '..');
+
+const DEFAULT_BINDING_PATH = process.env.UNITY_MCP_BINDING_PATH
+  ? path.resolve(process.env.UNITY_MCP_BINDING_PATH)
+  : path.join(
+      PKG_ROOT,
+      'node_modules',
+      'better-sqlite3',
+      'build',
+      'Release',
+      'better_sqlite3.node'
+    );
+
+const DEFAULT_PREBUILT_ROOT = process.env.UNITY_MCP_PREBUILT_DIR
+  ? path.resolve(process.env.UNITY_MCP_PREBUILT_DIR)
+  : path.join(PKG_ROOT, 'prebuilt', 'better-sqlite3');
+
+export function resolvePlatformKey(
+  nodeVersion = process.versions.node,
+  platform = process.platform,
+  arch = process.arch
+) {
+  const major = String(nodeVersion).split('.')[0];
+  return `${platform}-${arch}-node${major}`;
+}
+
+function copyPrebuiltBinding(prebuiltDir, bindingTarget, log) {
+  const platformKey = resolvePlatformKey();
+  const source = path.join(prebuiltDir, platformKey, 'better_sqlite3.node');
+  if (!fs.existsSync(source)) return false;
+  fs.mkdirSync(path.dirname(bindingTarget), { recursive: true });
+  fs.copyFileSync(source, bindingTarget);
+  if (log) log(`[postinstall] Installed better-sqlite3 prebuilt for ${platformKey}`);
+  return true;
+}
+
+function rebuildNative(bindingTarget, pkgRoot, log) {
+  log(
+    '[postinstall] No prebuilt available. Attempting native rebuild (npm rebuild better-sqlite3 --build-from-source)'
+  );
+  const result = spawnSync('npm', ['rebuild', 'better-sqlite3', '--build-from-source'], {
+    stdio: 'inherit',
+    shell: false,
+    cwd: pkgRoot
+  });
+  if (result.status !== 0) {
+    throw new Error(`better-sqlite3 rebuild failed with code ${result.status ?? 'null'}`);
+  }
+  if (!fs.existsSync(bindingTarget)) {
+    throw new Error('better-sqlite3 rebuild completed but binding was still not found');
+  }
+  return true;
+}
+
+export function ensureBetterSqlite3(options = {}) {
+  const {
+    bindingPath = DEFAULT_BINDING_PATH,
+    prebuiltRoot = DEFAULT_PREBUILT_ROOT,
+    pkgRoot = PKG_ROOT,
+    skipNative = process.env.UNITY_MCP_SKIP_NATIVE_BUILD !== '0',
+    forceNative = process.env.UNITY_MCP_FORCE_NATIVE === '1',
+    skipLegacyFlag = Boolean(process.env.SKIP_SQLITE_REBUILD),
+    log = console.log,
+    warn = console.warn
+  } = options;
+
+  if (skipLegacyFlag && !forceNative) {
+    warn('[postinstall] SKIP_SQLITE_REBUILD set, skipping better-sqlite3 check');
+    return { status: 'skipped' };
+  }
+
+  if (!forceNative && copyPrebuiltBinding(prebuiltRoot, bindingPath, log)) {
+    return { status: 'copied' };
+  }
+
+  if (skipNative && !forceNative) {
+    warn(
+      '[postinstall] UNITY_MCP_SKIP_NATIVE_BUILD=1 -> skipping native rebuild; sql.js fallback will be used'
+    );
+    return { status: 'skipped' };
+  }
+
+  if (forceNative) {
+    log('[postinstall] UNITY_MCP_FORCE_NATIVE=1 -> forcing better-sqlite3 rebuild');
+  } else if (fs.existsSync(bindingPath)) {
+    // Binding already exists and native rebuild not forced.
+    return { status: 'existing' };
+  }
+
+  rebuildNative(bindingPath, pkgRoot, log);
+  return { status: 'rebuilt' };
+}
+
+function isCliExecution() {
+  const invokedPath = process.argv[1] ? path.resolve(process.argv[1]) : '';
+  return invokedPath === SCRIPT_PATH;
+}
+
+async function main() {
+  try {
+    await ensureBetterSqlite3();
+  } catch (err) {
+    console.warn(`[postinstall] Warning: ${err.message}`);
+    // Do not hard fail install; runtime may still use sql.js fallback in codeIndex
+  }
+}
+
+if (isCliExecution()) {
+  main();
+}

package/src/core/sqliteFallback.js

@@ -1,10 +1,18 @@
 import fs from 'fs';
 import path from 'path';
+import { fileURLToPath } from 'url';
+import { createRequire } from 'module';
 import initSqlJs from 'sql.js';
 
 // Create a lightweight better-sqlite3 compatible surface using sql.js (WASM)
 export async function createSqliteFallback(dbPath) {
-  const wasmPath = path.resolve('node_modules/sql.js/dist/sql-wasm.wasm');
+  const require = createRequire(import.meta.url);
+  const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+  const pkgRoot = path.resolve(moduleDir, '..', '..');
+  const wasmPath = require.resolve('sql.js/dist/sql-wasm.wasm', {
+    // Resolve from package-local node_modules first, then workspace root
+    paths: [path.join(pkgRoot, 'node_modules'), path.join(pkgRoot, '..', 'node_modules')]
+  });
   const SQL = await initSqlJs({ locateFile: () => wasmPath });
 
   const loadDb = () => {

package/src/handlers/script/CodeIndexStatusToolHandler.js

@@ -32,6 +32,17 @@ export class CodeIndexStatusToolHandler extends BaseToolHandler {
 
     // Check whether the persistent index already exists or is being built in the background.
     const ready = await this.codeIndex.isReady();
+    if (this.codeIndex.disabled) {
+      return {
+        success: false,
+        error: 'code_index_unavailable',
+        message:
+          this.codeIndex.disableReason ||
+          'Code index is disabled because the SQLite driver could not be loaded. The server will continue without the symbol index.',
+        remediation:
+          'Install native build tools (python3, make, g++) in this environment and run "npm rebuild better-sqlite3 --build-from-source", then restart the server.'
+      };
+    }
     const buildInProgress = latestBuildJob?.status === 'running';
     if (!ready && !buildInProgress) {
       return {