argsbarg 7.1.3 → 7.1.4

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [7.1.4] - 2026-09-30
+
+### Changed
+
+- The MCP plugin example now ships a committed, self-contained Node bundle (`dist/mcp-plugin.mjs`) that both plugin manifests run with `node`, replacing source-only `bun start`. Plugin users need Node >=20 instead of Bun, and startup installs nothing. `just check` rebuilds the bundle, the release script rebuilds it after the version bump, and the optional `docs/node-distro.md` guide is removed.
+
 ## [7.1.3] - 2026-09-29
 
 ### Added
@@ -1083,7 +1089,8 @@ const cli = { ... } satisfies CliProgram;  // or : CliProgram
 - Migrate schemas: rename every `children` property to **`commands`**; move positional definitions to **`CliPositional`** objects on `positionals` and strip `positional` / `argMin` / `argMax` from flag definitions under `options` (flags only carry `name`, `description`, `kind`, and optional `shortName`).
 - Imports: use `CliPositional` where needed; replace `CliOptionDef` with `CliOption` or `CliPositional` as appropriate.
 
-[Unreleased]: https://github.com/bdombro/bun-argsbarg/compare/v7.1.3...HEAD
+[Unreleased]: https://github.com/bdombro/bun-argsbarg/compare/v7.1.4...HEAD
+[7.1.4]: https://github.com/bdombro/bun-argsbarg/releases/tag/v7.1.4
 [7.1.3]: https://github.com/bdombro/bun-argsbarg/releases/tag/v7.1.3
 [7.1.2]: https://github.com/bdombro/bun-argsbarg/releases/tag/v7.1.2
 [7.1.1]: https://github.com/bdombro/bun-argsbarg/releases/tag/v7.1.1

package/examples/mcp-plugin/.claude-plugin/plugin.json

@@ -9,8 +9,8 @@
   "repository": "https://github.com/bdombro/bun-argsbarg",
   "mcpServers": {
     "mcp-plugin": {
-      "command": "bun",
-      "args": ["--cwd", "${CLAUDE_PLUGIN_ROOT}", "start"]
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/dist/mcp-plugin.mjs", "mcp"]
     }
   }
 }

package/examples/mcp-plugin/.cursor-plugin/plugin.json

@@ -10,8 +10,8 @@
   "repository": "https://github.com/bdombro/bun-argsbarg",
   "mcpServers": {
     "mcp-plugin": {
-      "command": "bun",
-      "args": ["--cwd", "${CURSOR_PLUGIN_ROOT}", "start"]
+      "command": "node",
+      "args": ["${CURSOR_PLUGIN_ROOT}/dist/mcp-plugin.mjs", "mcp"]
     }
   }
 }

package/examples/mcp-plugin/AGENTS.md

@@ -76,10 +76,9 @@ Avoid needless extraction: keep single-use helpers in the calling file by defaul
 
 ## Tooling
 
-- Use Bun for development and the default plugin runtime (`bun`, `bun x`, `bun test`).
-- `bun start` installs locked dependencies, generates schemas, then starts MCP. Keep setup output on stderr; stdout is the MCP protocol.
-- Ship source, `bun.lock`, and inline plugin manifests. Do not ship `node_modules`, generated schemas, or a compiled bundle.
-- Node distribution is an explicit alternative documented in `docs/node-distro.md`; do not change the default runtime implicitly.
+- Use Bun for development, schemagen, tests, and bundling (`bun`, `bun x`, `bun test`).
+- Plugins run the committed Node bundle `dist/mcp-plugin.mjs` via inline manifest MCP configs. `just check` rebuilds it; commit it with its source and never hand-edit it.
+- Keep the MCP runtime Node-compatible: no Bun-only APIs (`Bun.serve`, `bun:sqlite`) on MCP paths. stdout is the MCP protocol.
 
 ## Testing Boundaries
 
@@ -93,7 +92,6 @@ Avoid needless extraction: keep single-use helpers in the calling file by defaul
 ## Documentation
 
 - `README.md` — user-facing install/commands
-- `docs/node-distro.md` — optional conversion from source-only Bun plugins to a bundled Node MCP distribution
 - `docs/architecture.md` — maintainer internals (create if missing)
 - Generated: `just docgen` → `docs/cli.md`, `docs/cli-schema.json`
 - `skills/mcp-plugin/SKILL.md` — agent skill router (scaffolded from template; customize as needed)

package/examples/mcp-plugin/README.md

@@ -6,14 +6,14 @@ Argsbarg MCP plugin template for Cursor and Claude Code marketplaces (@sg schema
 
 `mcp-plugin` packages an MCP server and agent skills directly for Cursor and Claude Code marketplaces:
 
-- **Cursor Plugin**: inline MCP configuration in `.cursor-plugin/plugin.json` runs `bun --cwd ${CURSOR_PLUGIN_ROOT} start`.
-- **Claude Code Plugin**: inline MCP configuration in `.claude-plugin/plugin.json` runs `bun --cwd ${CLAUDE_PLUGIN_ROOT} start`.
+- **Cursor Plugin**: inline MCP configuration in `.cursor-plugin/plugin.json` runs `node ${CURSOR_PLUGIN_ROOT}/dist/mcp-plugin.mjs mcp`.
+- **Claude Code Plugin**: inline MCP configuration in `.claude-plugin/plugin.json` runs `node ${CLAUDE_PLUGIN_ROOT}/dist/mcp-plugin.mjs mcp`.
 - **In-repo skills**: `skills/mcp-plugin/SKILL.md` discovered and loaded by agent platforms.
-- **Source-only distribution**: TypeScript and `bun.lock` are shipped; dependencies and generated schemas are prepared locally. No compiled bundle is shipped.
+- **Committed Node bundle**: `dist/mcp-plugin.mjs` is self-contained (dependencies and schemas bundled), so a fresh clone runs with no install step.
 
 ## Installation
 
-Requires Bun >=1.3 on the host's PATH, a writable plugin directory, and network access for uncached dependencies. `bun start` installs locked dependencies and generates schemas before starting MCP. Setup output goes to stderr; stdout contains only MCP messages. Startup stops if preparation fails.
+Requires Node >=20 on the host's PATH. Nothing is installed at startup; stdout contains only MCP messages. Maintainers need Bun to develop and rebuild the bundle (`just check`).
 
 The in-repo example retains its `argsbarg: file:../..` development dependency. Before distributing a standalone copy, resolve that dependency for the destination repository and regenerate its lockfile; the parent-checkout path is not portable.
 
@@ -58,8 +58,9 @@ cd bun-argsbarg/examples/mcp-plugin
 # Install dependencies and generate schemas
 just setup
 
-# Run the source-only MCP server
-bun start
+# Rebuild the committed Node bundle and run the MCP server from it
+just build
+node dist/mcp-plugin.mjs mcp
 
 # Link into local Cursor plugins for live testing
 just plugin-cursor-upsert
@@ -68,7 +69,7 @@ just plugin-cursor-upsert
 just plugin-claude-install
 ```
 
-Restart Claude Code after installing. Use `bun src/index.ts <command>` for CLI commands; `bun start` is specifically the MCP entry point. In-repo development uses `just setup` to repair the local dependency's CLI executable link.
+Restart Claude Code after installing. Use `bun src/index.ts <command>` for CLI commands from source. Commit `dist/mcp-plugin.mjs` whenever source changes; `just check` rebuilds it. In-repo development uses `just setup` to repair the local dependency's CLI executable link.
 
 ## Documentation
 
@@ -78,4 +79,3 @@ Restart Claude Code after installing. Use `bun src/index.ts <command>` for CLI c
 | MCP tools | [docs/mcp.md](docs/mcp.md) or `mcp-plugin docs mcp` |
 | HTTP API | [docs/http.md](docs/http.md) or `mcp-plugin docs http` |
 | OpenAPI 3.1 | [docs/openapi.json](docs/openapi.json) |
-| Optional Node distribution | [docs/node-distro.md](docs/node-distro.md) |