argsbarg 7.1.3 → 7.1.4

package/examples/mcp-plugin/justfile

@@ -7,8 +7,12 @@ export PATH := justfile_directory() + "/node_modules/.bin:" + env_var("PATH")
 _:
     @just --list
 
-# Run schemagen, typecheck, and format
-check: schemagen format typecheck
+# Run schemagen, format, typecheck, and rebuild the committed Node bundle
+check: schemagen format typecheck build
+
+# Bundle the Node MCP server that plugins run (commit dist/mcp-plugin.mjs)
+build: schemagen
+    bun build ./src/index.ts --target=node --minify-whitespace --minify-syntax --outfile=./dist/mcp-plugin.mjs
 
 # demo the HTTP API
 demo-http:
@@ -53,12 +57,12 @@ lint:
     bun run biome check ./src ./scripts
 
 # Install the Claude Code plugin from this checkout (restart Claude Code afterwards)
-plugin-claude-install:
+plugin-claude-install: build
     claude plugin marketplace add "$(pwd)"
     claude plugin install mcp-plugin@mcp-plugin
 
 # Link plugin into ~/.cursor/plugins/local/mcp-plugin for local testing
-plugin-cursor-upsert:
+plugin-cursor-upsert: build
     mkdir -p ~/.cursor/plugins/local
     ln -sfn '{{justfile_directory()}}' ~/.cursor/plugins/local/mcp-plugin
     @echo "Linked MCP plugin to ~/.cursor/plugins/local/mcp-plugin"
@@ -81,7 +85,7 @@ setup:
 test: check
     bun test .
 
-# Bump version and publish a source-only release
+# Bump version, rebuild the bundle, and publish a release
 release *ARGS:
     bun scripts/release.ts {{ARGS}}
 

package/examples/mcp-plugin/package.json

@@ -6,12 +6,8 @@
   "module": "src/index.ts",
   "description": "Argsbarg MCP plugin template for Cursor and Claude Code marketplaces.",
   "engines": {
-    "bun": ">=1.3"
-  },
-  "scripts": {
-    "biome": "biome",
-    "prestart": "bun install --frozen-lockfile 1>&2 && bun run argsbarg schemagen 1>&2",
-    "start": "bun src/index.ts mcp"
+    "bun": ">=1.3",
+    "node": ">=20"
   },
   "dependencies": {
     "argsbarg": "file:../.."

package/examples/mcp-plugin/scripts/release.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
 /*
-Bump version and publish a source-only Bun plugin release tag.
+Bump version, rebuild the committed Node bundle, and publish a plugin release tag.
 */
 
 import * as fs from "node:fs";
@@ -39,10 +39,7 @@ async function main(): Promise<void> {
 
 /** Prints usage and exits. */
 function usage(): never {
-  process.stderr.write(
-    "Usage:\n" +
-      "  bun scripts/release.ts <major|minor|patch> [--yes] [--dry-run]\n",
-  );
+  process.stderr.write("Usage:\n" + "  bun scripts/release.ts <major|minor|patch> [--yes] [--dry-run]\n");
   process.exit(1);
 }
 
@@ -80,7 +77,7 @@ async function runRelease(
   const newVersion = applyBump(currentVersion, bump);
   if (options.dryRun) {
     console.log(
-      `[dry-run] Would run checks, bump ${currentVersion} to ${newVersion}, update the changelog, regenerate docs, commit, tag v${newVersion}, push, and create a GitHub release.`,
+      `[dry-run] Would run checks, bump ${currentVersion} to ${newVersion}, update the changelog, regenerate docs, rebuild the bundle, commit, tag v${newVersion}, push, and create a GitHub release.`,
     );
     return;
   }
@@ -96,6 +93,9 @@ async function runRelease(
   const docgenResult = await $`just docgen`.nothrow();
   if (docgenResult.exitCode !== 0) process.exit(docgenResult.exitCode);
 
+  const buildResult = await $`just build`.nothrow();
+  if (buildResult.exitCode !== 0) process.exit(buildResult.exitCode);
+
   await commitAndTag(newVersion);
   await createGithubRelease(`v${newVersion}`);
 
@@ -153,31 +153,19 @@ function updateVersion(
 ): void {
   const pkgPath = "package.json";
   const pkgContent = fs.readFileSync(pkgPath, "utf-8");
-  fs.writeFileSync(
-    pkgPath,
-    pkgContent.replace(/"version":\s*"[^"]+"/, `"version": "${newVersion}"`),
-  );
+  fs.writeFileSync(pkgPath, pkgContent.replace(/"version":\s*"[^"]+"/, `"version": "${newVersion}"`));
 
   const progContent = fs.readFileSync(programPath, "utf-8");
-  fs.writeFileSync(
-    programPath,
-    progContent.replace(/version:\s*"[^"]+"/, `version: "${newVersion}"`),
-  );
+  fs.writeFileSync(programPath, progContent.replace(/version:\s*"[^"]+"/, `version: "${newVersion}"`));
 
   if (fs.existsSync(cursorManifestPath)) {
     const cursorContent = fs.readFileSync(cursorManifestPath, "utf-8");
-    fs.writeFileSync(
-      cursorManifestPath,
-      cursorContent.replace(/"version":\s*"[^"]+"/, `"version": "${newVersion}"`),
-    );
+    fs.writeFileSync(cursorManifestPath, cursorContent.replace(/"version":\s*"[^"]+"/, `"version": "${newVersion}"`));
   }
 
   if (fs.existsSync(claudeManifestPath)) {
     const claudeContent = fs.readFileSync(claudeManifestPath, "utf-8");
-    fs.writeFileSync(
-      claudeManifestPath,
-      claudeContent.replace(/"version":\s*"[^"]+"/, `"version": "${newVersion}"`),
-    );
+    fs.writeFileSync(claudeManifestPath, claudeContent.replace(/"version":\s*"[^"]+"/, `"version": "${newVersion}"`));
   }
 }
 

package/examples/mcp-plugin/src/index.ts

@@ -1,4 +1,3 @@
-#!/usr/bin/env bun
 /*
 Thin CLI entry — delegates to argsbarg runtime.
 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argsbarg",
-  "version": "7.1.3",
+  "version": "7.1.4",
   "main": "./src/index.ts",
   "module": "./src/index.ts",
   "dependencies": {

package/examples/mcp-plugin/bunfig.toml

@@ -1,7 +0,0 @@
-[install]
-# fetch package.json deps on first `bun src/index.ts` without manual `bun install`.
-auto = "fallback"
-
-[run]
-shell = "bun"
-silent = true

package/examples/mcp-plugin/docs/node-distro.md

@@ -1,97 +0,0 @@
-# Node Distribution
-
-The default plugin ships TypeScript and starts with Bun. To ship a standalone
-Node MCP server instead, follow the bundle-based distribution described below.
-Bun remains the development/build tool; plugin users need Node but do not need
-Bun, dependency installation, or schema generation at startup.
- Note: bundle distrobutions mean committing large bundled js files to the repo.
-## 1. Build The Bundle
-
-Add this recipe to `justfile`:
-
-```just
-# Generate schemas and bundle the standalone Node MCP server
-build: schemagen
-    bun build ./src/index.ts --target=node --outfile=./scripts/mcp.mjs
-```
-
-Run `just setup` and `just build` from the project root. Schemas must exist before
-bundling so their static imports are included in the output.
-
-Keep the MCP runtime compatible with Node. Bundling does not implement Bun-only
-APIs such as `Bun.serve` or `bun:sqlite`; port or exclude any such runtime paths.
-The HTTP server capability is separate from this Node MCP distribution.
-
-## 2. Change Startup
-
-Remove `prestart` from `package.json` and change `start` to:
-
-```json
-"start": "node scripts/mcp.mjs mcp"
-```
-
-Declare the supported Node version range under `engines.node` and document it in
-the README. Bun is still needed by maintainers for schema generation, tests, and
-bundling. The Bun shell settings in `bunfig.toml` can remain for development.
-
-## 3. Update Inline Plugin Configs
-
-Keep MCP configuration inside the plugin manifests; do not reintroduce separate
-root MCP config files. Replace the `mcpServers` field in
-`.claude-plugin/plugin.json` with:
-
-```json
-"mcpServers": {
-  "mcp-plugin": {
-    "command": "node",
-    "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/mcp.mjs", "mcp"]
-  }
-}
-```
-
-Use the corresponding field in `.cursor-plugin/plugin.json`:
-
-```json
-"mcpServers": {
-  "mcp-plugin": {
-    "command": "node",
-    "args": ["${CURSOR_PLUGIN_ROOT}/scripts/mcp.mjs", "mcp"]
-  }
-}
-```
-
-Launching Node directly avoids relying on a package manager on the user's
-machine. Keep each path as one argument so plugin roots containing spaces work.
-
-## 4. Package And Release
-
-- Add `build` as a dependency of `plugin-cursor-upsert` and
-  `plugin-claude-install` so local installs have a fresh bundle.
-- Restore `just build` in `scripts/release.ts` after version/documentation
-  updates and before committing or publishing. Fail the release if it fails.
-- Include `scripts/mcp.mjs` in the released plugin. For repository-based
-  installation, commit the generated bundle so a fresh clone is runnable.
-- Do not ship `node_modules` or generated schemas separately. Their runtime
-  contents should be bundled; inspect external imports and package any required
-  runtime assets explicitly.
-- Update the README and the project-specific tooling section of `AGENTS.md`
-  to describe Node as the plugin runtime and Bun as the development tool.
-
-## 5. Verify The Node Distribution
-
-After building, a basic stdio check is:
-
-```bash
-printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' \
-  | node scripts/mcp.mjs mcp
-```
-
-Only JSON-RPC responses should appear on stdout. Exercise `tools/list` and a
-representative tool call as well: successful initialization alone does not prove
-that every command's runtime dependencies are Node-compatible.
-
-Check both manifest commands from an unrelated working directory with the
-plugin-root placeholders expanded to the installed path. Verify a clean copy
-with no `node_modules` or generated schemas, using the declared minimum Node
-version and a current supported Node version. Keep transport/package checks at
-the integration level; agent E2E should measure real user-task outcomes.