kicad-mcp-pro 1.0.0

package/README.md

@@ -0,0 +1,14 @@
+# kicad-mcp-pro
+
+Thin npm launcher for the `kicad-mcp-pro` Python package.
+
+- npm package: `kicad-mcp-pro`
+- Python package: `kicad-mcp-pro`
+- MCP name: `io.github.oaslananka/kicad-mcp-pro`
+- Canonical repository: https://github.com/oaslananka/kicad-studio-kit/tree/main/packages/mcp-npm
+
+The wrapper resolves the Python package version from `KICAD_MCP_PRO_PYPI_VERSION` or from this package version.
+
+```bash
+npx kicad-mcp-pro@1.0.0 --help
+```

package/bin/kicad-mcp-pro.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("node:fs");
+const path = require("node:path");
+const { spawn } = require("node:child_process");
+const pkg = require("../package.json");
+
+function executableNames() {
+  return process.platform === "win32" ? ["uvx.cmd", "uvx.exe", "uvx"] : ["uvx"];
+}
+
+function findOnPath(commandNames) {
+  const rawPath = process.env.PATH || "";
+  const entries = rawPath.split(path.delimiter).filter(Boolean);
+  for (const entry of entries) {
+    for (const commandName of commandNames) {
+      const candidate = path.join(entry, commandName);
+      if (fs.existsSync(candidate)) {
+        return candidate;
+      }
+    }
+  }
+  return null;
+}
+
+const uvx = findOnPath(executableNames());
+if (!uvx) {
+  console.error(
+    [
+      "uvx was not found on PATH.",
+      "Install uv from https://docs.astral.sh/uv/getting-started/installation/ and retry.",
+      "This npm wrapper does not install the Python package during npm install.",
+    ].join("\n"),
+  );
+  process.exit(127);
+}
+
+const pythonPackageVersion = process.env.KICAD_MCP_PRO_PYPI_VERSION || pkg.version;
+const pythonPackage = `kicad-mcp-pro@${pythonPackageVersion}`;
+const child = spawn(uvx, [pythonPackage, ...process.argv.slice(2)], {
+  stdio: "inherit",
+  windowsHide: true,
+});
+
+child.on("error", (error) => {
+  console.error(`Failed to execute uvx: ${error.message}`);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+  if (code !== 0) {
+    console.error(
+      [
+        `${pythonPackage} exited with code ${code}.`,
+        "Publish the matching Python package before publishing this npm wrapper,",
+        "or set KICAD_MCP_PRO_PYPI_VERSION to an already-published compatible version.",
+      ].join("\n"),
+    );
+  }
+  process.exit(code === null ? 1 : code);
+});

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "kicad-mcp-pro",
+  "version": "1.0.0",
+  "description": "npm wrapper for the KiCad MCP Pro Python package.",
+  "license": "MIT",
+  "homepage": "https://oaslananka.github.io/kicad-studio-kit",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/oaslananka/kicad-studio-kit.git",
+    "directory": "packages/mcp-npm"
+  },
+  "bugs": {
+    "url": "https://github.com/oaslananka/kicad-studio-kit/issues"
+  },
+  "mcpName": "io.github.oaslananka/kicad-mcp-pro",
+  "bin": {
+    "kicad-mcp-pro": "bin/kicad-mcp-pro.js"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "check": "npm pack --dry-run",
+    "build": "node scripts/build-smoke.js"
+  }
+}

package/scripts/build-smoke.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+"use strict";
+
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+const packageRoot = path.resolve(__dirname, "..");
+const wrapperPath = path.join(packageRoot, "bin", "kicad-mcp-pro.js");
+
+const result = spawnSync(process.execPath, [wrapperPath, "--help"], {
+  cwd: packageRoot,
+  encoding: "utf8",
+  windowsHide: true,
+});
+
+if (result.stdout) {
+  process.stdout.write(result.stdout);
+}
+
+if (result.stderr) {
+  process.stderr.write(result.stderr);
+}
+
+if (result.error) {
+  console.error(`Failed to execute npm launcher smoke: ${result.error.message}`);
+  process.exit(1);
+}
+
+if (result.signal) {
+  console.error(`npm launcher smoke was interrupted by signal ${result.signal}.`);
+  process.exit(1);
+}
+
+if (result.status === 0) {
+  process.exit(0);
+}
+
+const knownPrepublishFailure =
+  result.stderr.includes("uvx was not found on PATH.") ||
+  result.stderr.includes("Publish the matching Python package before publishing this npm wrapper");
+
+if (!knownPrepublishFailure) {
+  console.error(`npm launcher smoke failed with unexpected exit code ${result.status ?? 1}.`);
+  process.exit(result.status ?? 1);
+}
+
+console.error(
+  [
+    "npm launcher smoke completed with a non-zero wrapper exit.",
+    "This is tolerated during repository builds because the matching Python package",
+    "may not be published yet. The wrapper itself still exits non-zero for users.",
+  ].join("\n"),
+);
+process.exit(0);