argsbarg 7.1.0 → 7.1.1

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [7.1.1] - 2026-09-25
+
+### Added
+
+- **`argsbarg create --template plugin`** — support `"plugin"` choice for scaffolding agent MCP plugins with in-repo Cursor and Claude manifests.
+
+### Changed
+
+- **AGENTS.md** — updated Memory section to use `thread-memory` MCP plugin (`recall`/`feedback`) backed by centralized SQLite store.
+
+### Fixed
+
+- Headless tool failures (MCP `tools/call` and HTTP JSON `{ "error" }`) now return the full error message (ANSI stripped, newlines preserved) instead of collapsing to the first line.
+- `packClaudePlugin`, `packCursorPlugin`, and `packMcpBundle` staged the compiled binary via `cpSync(src, dest, { mode: 0o755 })` — but `cpSync`'s `mode` option is a bitmask of copy-behavior flags (`COPYFILE_EXCL`/`FICLONE`/`FICLONE_FORCE`, valid range 0–7), not a POSIX file permission mode. `0o755` (493) was always out of range; a stricter Bun `fs.cpSync` validation now throws on it instead of silently ignoring it. Fixed by dropping the bogus `mode` option and calling `chmodSync(dest, 0o755)` after the copy, which is what the code actually intended.
+
 ## [7.1.0] - 2026-09-18
 
 ### Changed
@@ -1033,7 +1048,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.0...HEAD
+[Unreleased]: https://github.com/bdombro/bun-argsbarg/compare/v7.1.1...HEAD
+[7.1.1]: https://github.com/bdombro/bun-argsbarg/releases/tag/v7.1.1
 [7.1.0]: https://github.com/bdombro/bun-argsbarg/releases/tag/v7.1.0
 [7.0.11]: https://github.com/bdombro/bun-argsbarg/releases/tag/v7.0.11
 [7.0.10]: https://github.com/bdombro/bun-argsbarg/releases/tag/v7.0.10

package/docs/mcp.md

@@ -196,7 +196,7 @@ On success (`isError: false`):
 - **stderr** — when non-empty, a second `content` text block with trimmed stderr (no prefix). The block’s position signals stderr; hosts may label it themselves.
 - **structuredContent** — when trimmed stdout is valid JSON, the parsed value is also returned per the [MCP tools spec](https://modelcontextprotocol.io/specification/draft/server/tools). Objects and arrays from flags like `--json` are the common case. JSON **primitives** (`true`, `42`, `"hello"`) are parsed too — a handler that prints the literal string `true` as human text would get `structuredContent: true`. Prefer objects for machine-readable output.
 
-On failure (parse error, validation error, non-zero exit, thrown error), the message is returned as text content with `isError: true`. Handler stderr is included when present.
+On failure (parse error, validation error, non-zero exit, thrown error), the **full** error message is returned as text content with `isError: true` (ANSI stripped, newlines preserved). HTTP JSON `{ "error": "…" }` uses the same full text. Do not collapse headless errors to the first line.
 
 Help and `docs cli-schema` are not available through tool calls; use the schema resource or run the CLI directly for those.
 

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

@@ -0,0 +1,13 @@
+{
+  "name": "mcp-plugin",
+  "owner": {
+    "name": "Brian Dombrowski"
+  },
+  "plugins": [
+    {
+      "name": "mcp-plugin",
+      "source": ".",
+      "description": "Argsbarg MCP plugin template for Cursor and Claude Code marketplaces"
+    }
+  ]
+}

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

@@ -6,6 +6,5 @@
     "name": "Brian Dombrowski"
   },
   "homepage": "https://github.com/bdombro/bun-argsbarg",
-  "repository": "https://github.com/bdombro/bun-argsbarg",
-  "skills": ["skills/mcp-plugin"]
+  "repository": "https://github.com/bdombro/bun-argsbarg"
 }

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

@@ -7,6 +7,5 @@
     "name": "Brian Dombrowski"
   },
   "homepage": "https://github.com/bdombro/bun-argsbarg",
-  "repository": "https://github.com/bdombro/bun-argsbarg",
-  "skills": ["skills/mcp-plugin"]
+  "repository": "https://github.com/bdombro/bun-argsbarg"
 }

package/examples/mcp-plugin/README.md

@@ -11,22 +11,23 @@ Argsbarg MCP plugin template for Cursor and Claude Code marketplaces (@sg schema
 - **In-repo skills**: `skills/mcp-plugin/SKILL.md` discovered and loaded by agent platforms.
 - **Standalone runner**: `bun build --target=node src/index.ts --outfile scripts/mcp.mjs` creates an inlined, zero-npm-install script.
 
-## Development
+## Installation
 
-```bash
-# Install dependencies and generate schemas
-just setup
+### Cursor
 
-# Build standalone MCP bundle
-just build
+Recommended: import directly from GitHub — Cursor Dashboard → **Settings → Plugins → Team Marketplaces → Import**, then enter `https://github.com/bdombro/bun-argsbarg` (subdirectory `examples/mcp-plugin` once copied to its own repo). Once published to the [official marketplace](https://cursor.com/marketplace/publish), install via `/add-plugin mcp-plugin` or the Customize sidebar.
 
-# Test MCP server directly with node
-node ./scripts/mcp.mjs mcp
+### Claude Code
 
-# Link into local Cursor plugins for live testing
-just install-plugin-cursor
+Recommended: add the GitHub repo as a marketplace, then install:
+
+```bash
+/plugin marketplace add <owner>/<repo>
+/plugin install mcp-plugin@<repo>
 ```
 
+Once merged into [anthropics/claude-plugins-official](https://github.com/anthropics/claude-plugins-official), install via `/plugin install mcp-plugin@claude-plugins-official`.
+
 ## Commands
 
 - `mcp-plugin echo` — Echo text back to stdout or inspect flags.
@@ -42,23 +43,24 @@ just install-plugin-cursor
 - `mcp-plugin mcp` — Start the Model Context Protocol (stdio) server for AI coding agents.
 - `mcp-plugin version` — Display version information.
 
-## Distribution & Marketplaces
+## Contributing / Local Development
 
-### Cursor
+```bash
+git clone https://github.com/bdombro/bun-argsbarg.git
+cd bun-argsbarg/examples/mcp-plugin
 
-- **Local Development / Testing**: Run `just install-plugin-cursor` to link the repo into `~/.cursor/plugins/local/mcp-plugin`. Reload the Cursor window to activate.
-- **Team Marketplace**: In Cursor Dashboard → **Settings → Plugins → Team Marketplaces → Import**, enter your GitHub repository URL.
-- **Official Cursor Marketplace**: Submit your repository URL at [cursor.com/marketplace/publish](https://cursor.com/marketplace/publish). Once approved, users can install directly via `/add-plugin mcp-plugin` or from the Customize sidebar.
+# Install dependencies and generate schemas
+just setup
 
-### Claude Code
+# Build standalone MCP bundle
+just build
 
-- **Direct Git Install**: Users can add your repository without central registration:
-  ```bash
-  /plugin marketplace add <owner>/<repo>
-  /plugin install mcp-plugin
-  /reload-plugins
-  ```
-- **Official Directory**: Submit a pull request to [anthropics/claude-plugins-official](https://github.com/anthropics/claude-plugins-official) under `external_plugins/`. Once merged, users can install directly via `/plugin install mcp-plugin@claude-plugins-official`.
+# Test MCP server directly with node
+node ./scripts/mcp.mjs mcp
+
+# Link into local Cursor plugins for live testing
+just install-plugin-cursor
+```
 
 ## Documentation
 

package/package.json

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

package/src/cli-tool/program.ts

@@ -18,7 +18,7 @@ export const program = {
           name: "template",
           description: "Template: cli (default) or json (schema-first).",
           kind: CliOptionKind.Enum,
-          choices: ["cli", "json"],
+          choices: ["cli", "json", "plugin"],
         },
         { name: "key", description: "CLI binary name.", kind: CliOptionKind.String },
         {

package/src/headless/tool-call.test.ts

@@ -0,0 +1,32 @@
+/* Unit tests for shared headless error text (MCP and HTTP). */
+
+import { describe, expect, test } from "bun:test";
+import { type HeadlessToolCallFailure, headlessFailureMcpMessage, headlessFailureToHttpResponse } from "./tool-call.ts";
+
+/** Builds a failed headless result with the given error message. */
+function invokeFailure(
+  /** Full error text from the leaf. */
+  message: string,
+): HeadlessToolCallFailure {
+  return {
+    exitCode: 1,
+    kind: "invoke",
+    message,
+    ok: false,
+    stderr: "",
+    stdout: "",
+  };
+}
+
+describe("headless error text", () => {
+  const multiline =
+    'cannot copy tab "Spec" losslessly (1 smart chip(s): "Ada"). Use force: true.\n' +
+    '  • node h.x: contains 1 smart chip(s) ("Ada")\n\n' +
+    "Google Docs REST API has no native tab duplication endpoint.";
+
+  test("MCP and HTTP both keep the full multi-line error", async () => {
+    expect(headlessFailureMcpMessage(invokeFailure(multiline))).toBe(multiline);
+    const body = (await headlessFailureToHttpResponse(invokeFailure(multiline)).json()) as { error: string };
+    expect(body.error).toBe(multiline);
+  });
+});

package/src/headless/tool-call.ts

@@ -6,7 +6,7 @@ import { bootstrapAppConfig } from "../config/bootstrap.ts";
 import { formatMcpMissingConfigMessage, missingRequiredConfig } from "../config/resolve.ts";
 import type { CliInvocation, CliProgram, InvokeFailureKind } from "../core/types.ts";
 import { failureKindHttpStatus } from "../hooks/run.ts";
-import { apiErrorResponse, apiSuccessResponse, firstErrorLine } from "../http/result.ts";
+import { apiErrorResponse, apiSuccessResponse, stripAnsi } from "../http/result.ts";
 import { type HttpRouteDef, httpRequestToArgv } from "../http/routes.ts";
 import { obscureUnexpectedClientMessage } from "../log/emitter.ts";
 import { buildToolCallSuccessFromResponse } from "../mcp/result.ts";
@@ -188,11 +188,7 @@ export function headlessSuccessToHttpResponse(
 /** Maps a headless failure result to a JSON HTTP error Response. */
 export function headlessFailureToHttpResponse(result: HeadlessToolCallFailure, obscureUnexpected = false): Response {
   const status = resolveHttpErrorStatus(result);
-  let message = firstErrorLine(result.message);
-  if (obscureUnexpected && result.failureKind === "unexpected") {
-    message = obscureUnexpectedClientMessage();
-  }
-  return apiErrorResponse(status, { error: message });
+  return apiErrorResponse(status, { error: formatHeadlessError(result, obscureUnexpected) });
 }
 
 function resolveHttpErrorStatus(result: HeadlessToolCallFailure): number {
@@ -212,11 +208,26 @@ function resolveHttpErrorStatus(result: HeadlessToolCallFailure): number {
 }
 
 /** Maps invoke failure kind to MCP tools/call error text (respects obscureUnexpected). */
-export function headlessFailureMcpMessage(result: HeadlessToolCallFailure, obscureUnexpected = false): string {
+export function headlessFailureMcpMessage(
+  /** Failed headless tool invocation. */
+  result: HeadlessToolCallFailure,
+  /** When true, unexpected failures return a generic client message. */
+  obscureUnexpected = false,
+): string {
+  return formatHeadlessError(result, obscureUnexpected);
+}
+
+/** Formats a headless failure for MCP text content and HTTP JSON `error` (full message, ANSI stripped). */
+function formatHeadlessError(
+  /** Failed headless tool invocation. */
+  result: HeadlessToolCallFailure,
+  /** When true, unexpected failures return a generic client message. */
+  obscureUnexpected: boolean,
+): string {
   if (obscureUnexpected && result.failureKind === "unexpected") {
     return obscureUnexpectedClientMessage();
   }
-  return firstErrorLine(result.message);
+  return stripAnsi(result.message).trim();
 }
 
 /** Missing-config lookup failures as MCP/HTTP pre-invoke errors. */

package/src/mcp/bundle.ts

@@ -3,7 +3,7 @@ Packs a CLI program into an MCP Bundle (`.mcpb`) for Claude Desktop.
 Expects `dist/<program.key>` as the compiled binary input.
 */
 
-import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { chmodSync, cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { basename, join, resolve } from "node:path";
 import { buildProgramUserConfig } from "../config/manifest.ts";
@@ -119,7 +119,8 @@ export function packMcpBundle(program: CliProgram, opts: PackMcpBundleOpts = {})
   const staging = mkdtempSync(join(tmpdir(), "mcpb-"));
   try {
     const stagedBinary = join(staging, binaryName);
-    cpSync(binaryPath, stagedBinary, { mode: 0o755 });
+    cpSync(binaryPath, stagedBinary);
+    chmodSync(stagedBinary, 0o755);
 
     const manifest = generateMcpManifest(program, binaryName);
     const files: { name: string; data: Buffer }[] = [

package/src/mcp/claude.ts

@@ -3,7 +3,7 @@ Packs a Claude Code plugin zip from a compiled CLI binary.
 Internal module — not exported from index.ts.
 */
 
-import { cpSync, existsSync, mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { chmodSync, cpSync, existsSync, mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { basename, join, resolve } from "node:path";
 import { buildPluginMcpEnvMapping, buildProgramUserConfig } from "../config/manifest.ts";
@@ -104,7 +104,9 @@ function writePluginTree(
     join(pluginRoot, ".mcp.json"),
     `${JSON.stringify(generatePluginMcpJson(program, binaryName), null, 2)}\n`,
   );
-  cpSync(binaryPath, join(pluginRoot, "bin", binaryName), { mode: 0o755 });
+  const stagedBinary = join(pluginRoot, "bin", binaryName);
+  cpSync(binaryPath, stagedBinary);
+  chmodSync(stagedBinary, 0o755);
   stagePluginSkills(pluginRoot, program, cwd);
 }
 

package/src/mcp/cursor.ts

@@ -3,7 +3,7 @@ Packs a Cursor plugin zip from a compiled CLI binary.
 Internal module — not exported from index.ts.
 */
 
-import { cpSync, existsSync, mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { chmodSync, cpSync, existsSync, mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { basename, join, resolve } from "node:path";
 import { buildCursorPluginMcpEnvMapping, buildCursorPluginVariables } from "../config/manifest.ts";
@@ -117,7 +117,9 @@ function writePluginTree(
     join(pluginRoot, "mcp.json"),
     `${JSON.stringify(generateCursorPluginMcpJson(program, binaryName), null, 2)}\n`,
   );
-  cpSync(binaryPath, join(pluginRoot, "bin", binaryName), { mode: 0o755 });
+  const stagedBinary = join(pluginRoot, "bin", binaryName);
+  cpSync(binaryPath, stagedBinary);
+  chmodSync(stagedBinary, 0o755);
   stagePluginSkills(pluginRoot, program, cwd);
 }