fix(release): trim codelldb assets for publish

Author: CI Bot

CHANGELOG.md

@@ -17,6 +17,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Improved
 - **Stepping UX** – every `step_*` response now embeds current source context so agents see the active file/line instead of generic “success” acknowledgements
 
+### Packaging
+- **CodeLLDB footprint** – CLI bundle ships the Linux x64 CodeLLDB runtime by default (other platforms can point `CODELLDB_PATH` to an installed binary or re-run the vendor script) to stay within npm size limits
+
 ## [0.16.0] - 2025-11-09
 
 ### Added

Dockerfile

@@ -52,7 +52,8 @@ COPY src ./src
 COPY scripts ./scripts/
 
 # 4) Build workspace packages and main project (root build runs build:packages); then bundle
-RUN CODELLDB_VENDOR_LOCAL_ONLY=true CODELLDB_VENDOR_ALL=false CODELLDB_PLATFORMS=linux-x64 pnpm run build --silent
+# Download Linux CodeLLDB artifacts during the container build if they are not already vendored.
+RUN CODELLDB_VENDOR_ALL=false CODELLDB_PLATFORMS=linux-x64 pnpm run build --silent
 RUN node scripts/bundle.js
 
 # Optional: quick diagnostics for bundle

README.md

@@ -40,6 +40,7 @@ mcp-debugger is a Model Context Protocol (MCP) server that provides debugging to
 - 🟨 **JavaScript (Node.js) debugging via js-debug** – VSCode's proven debugger (Alpha)
 - 🦀 **Rust debugging via CodeLLDB** – Debug Rust & Cargo projects (Alpha)
 > WARNING: On Windows, use the GNU toolchain for full variable inspection. Run `mcp-debugger check-rust-binary <path-to-exe>` to verify your build and see [Rust Debugging on Windows](docs/rust-debugging-windows.md) for detailed guidance.
+> NOTE: The published npm bundle ships the Linux x64 CodeLLDB runtime to stay under registry size limits. On macOS or Windows, point the `CODELLDB_PATH` environment variable at an existing CodeLLDB installation (for example from the VSCode extension) or clone the repo and run `pnpm --filter @debugmcp/adapter-rust run build:adapter` to vendor your platform binaries locally.
 
 ### Windows Rust Setup Script
 

docs/rust-debugging.md

@@ -19,7 +19,7 @@ npm run build:adapter  # Downloads and extracts CodeLLDB
 
 ## CodeLLDB Vendoring
 
-The Rust adapter bundles the CodeLLDB binaries into `packages/adapter-rust/vendor/codelldb`. Vendoring runs automatically when you install or build the workspace:
+The Rust adapter bundles the CodeLLDB binaries into `packages/adapter-rust/vendor/codelldb`. Vendoring runs automatically when you install or build the workspace. To keep the published npm package within registry limits, the pre-built CLI ships only the Linux x64 CodeLLDB runtime. If you are on macOS or Windows, set the `CODELLDB_PATH` environment variable to your local CodeLLDB installation (for example from the VSCode extension) or run `pnpm --filter @debugmcp/adapter-rust run build:adapter` from a cloned repository to download your platform binaries.
 
 - `pnpm install` (postinstall hook)
 - `pnpm vendor` or `pnpm vendor:adapters`

packages/mcp-debugger/scripts/bundle-cli.js

@@ -132,9 +132,35 @@ async function bundleCLI() {
 
   const rustVendorSrc = path.join(repoRoot, 'packages/adapter-rust/vendor/codelldb');
   if (fs.existsSync(rustVendorSrc)) {
-    const rustVendorDest = path.join(distDir, 'vendor/codelldb');
-    fs.cpSync(rustVendorSrc, rustVendorDest, { recursive: true });
-    console.log('Copied CodeLLDB adapter payload.');
+    const rawPlatforms = process.env.CODELLDB_PACKAGE_PLATFORMS ?? 'linux-x64';
+    const requestedPlatforms = rawPlatforms
+      .split(',')
+      .map((platform) => platform.trim())
+      .filter(Boolean);
+
+    if (requestedPlatforms.length === 0) {
+      console.log('Skipping CodeLLDB inclusion (CODELLDB_PACKAGE_PLATFORMS empty).');
+    } else {
+      const rustVendorDest = path.join(distDir, 'vendor/codelldb');
+      fs.mkdirSync(rustVendorDest, { recursive: true });
+
+      for (const platform of requestedPlatforms) {
+        if (platform.toLowerCase() === 'none') {
+          continue;
+        }
+
+        const srcDir = path.join(rustVendorSrc, platform);
+        if (!fs.existsSync(srcDir)) {
+          console.warn(`[CodeLLDB bundler] Requested platform "${platform}" not found in vendor directory.`);
+          console.warn('Run: pnpm -w -F @debugmcp/adapter-rust run build:adapter');
+          continue;
+        }
+
+        const destDir = path.join(rustVendorDest, platform);
+        fs.cpSync(srcDir, destDir, { recursive: true });
+        console.log(`Copied CodeLLDB payload for ${platform}.`);
+      }
+    }
   } else {
     console.warn('Warning: CodeLLDB vendor directory not found; Rust debugging may fail.');
     console.warn('Run: pnpm -w -F @debugmcp/adapter-rust run build:adapter');