argsbarg 2.0.1 → 2.1.1

package/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.1.1] - 2026-06-20
+
+### Changed
+
+- **`install` built-in** — no longer gated on compiled binaries; available whenever `install.enabled !== false` (default on). Removed `isCompiledExecutable()` and `src/install/compiled.ts`.
+
+## [2.1.0] - 2026-06-20
+
+
 ## [2.0.1] - 2026-06-20
 
 ### Removed
@@ -177,7 +186,9 @@ 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/v2.0.1...HEAD
+[Unreleased]: https://github.com/bdombro/bun-argsbarg/compare/v2.1.1...HEAD
+[2.1.1]: https://github.com/bdombro/bun-argsbarg/releases/tag/v2.1.1
+[2.1.0]: https://github.com/bdombro/bun-argsbarg/releases/tag/v2.1.0
 [2.0.1]: https://github.com/bdombro/bun-argsbarg/releases/tag/v2.0.1
 [2.0.0]: https://github.com/bdombro/bun-argsbarg/releases/tag/v2.0.0
 [1.5.0]: https://github.com/bdombro/bun-argsbarg/releases/tag/v1.5.0

package/README.md

@@ -97,7 +97,7 @@ Every app gets:
 - **`--schema`** at the program root — print the full command tree as JSON (for tooling and agents).
 - **`completion bash` / `completion zsh` / `completion fish`** — print shell completion scripts to stdout (injected by `cliRun`).
 - **`mcp`** — when `mcpServer` is set on the program root, run as an MCP stdio server (`myapp mcp`).
-- **`install`** — when running as a compiled binary (`bun build --compile`), install the binary, completions, skills, and MCP config to the user environment (`myapp install --all --yes`). See [docs/install.md](docs/install.md).
+- **`install`** — install the binary, completions, skills, and MCP config to the user environment (`myapp install --all --yes`). See [docs/install.md](docs/install.md).
 
 Do not declare a top-level command named **`completion`** or **`install`** — they are reserved.
 When **`mcpServer`** is set, do not declare a top-level command named **`mcp`** — it is reserved for the MCP built-in.
@@ -110,9 +110,9 @@ Opt in on the program root with `mcpServer: {}` (or `{ name, version, … }`), t
 
 See **[docs/mcp.md](docs/mcp.md)** for configuration, env bootstrapping, custom resources, Cursor setup, and protocol details.
 
-### Install (compiled binaries)
+### Install
 
-After `bun build --compile`, ship a self-contained binary and let users run:
+After `bun build --compile` (or when running via `bun`), ship your CLI and let users run:
 
 ```bash
 myapp install --all --yes
@@ -185,7 +185,7 @@ Add `CliPositional` entries to the command’s `positionals` list (separate from
 
 ### Capabilities (built-ins)
 
-`completion`, `install`, and `mcp` are not part of your schema — they are injected at runtime from program-level config (`mcpServer`, compiled binary + `install`). Reserved command names follow from that config: `completion` and `install` are always reserved; `mcp` is reserved when `mcpServer` is set.
+`completion`, `install`, and `mcp` are not part of your schema — they are injected at runtime from program-level config (`mcpServer`, `install`). Reserved command names follow from that config: `completion` and `install` are always reserved unless `install.enabled: false`; `mcp` is reserved when `mcpServer` is set.
 
 
 

package/docs/ai-skills.md

@@ -4,7 +4,7 @@ ArgsBarg can generate Cursor and Claude Code skill directories (`SKILL.md` + `re
 
 ## Install via `install` (recommended)
 
-In a **compiled binary**, install skills to the user environment:
+Install skills to the user environment:
 
 ```bash
 myapp install --skill --yes

package/docs/install.md

@@ -1,6 +1,6 @@
 # Install command
 
-The `install` built-in is available only in **compiled binaries** (`bun build --compile`). It is hidden from help, `--schema`, and shell completions when running via `bun run`.
+The `install` built-in installs the binary, shell completions, agent skills, and MCP config. Opt out with `install: { enabled: false }` on the program root.
 
 ## Quick start
 

package/index.d.ts

@@ -166,7 +166,7 @@ export interface CliMcpToolConfig {
 	requiresEnv?: string[];
 }
 /**
- * Opt-out and defaults for the `install` built-in (compiled binaries only; program root only).
+ * Opt-out and defaults for the `install` built-in (program root only).
  */
 export interface CliInstallConfig {
 	/** When `false`, hide/disable `install` (default: enabled). */
@@ -220,7 +220,7 @@ export type CliNode = CliLeaf | CliRouter;
 export type CliProgram = CliNode & {
 	/** When set, enables the `mcp` built-in subcommand. */
 	mcpServer?: CliMcpServerConfig;
-	/** Opt-out and defaults for `install` (compiled binaries only). */
+	/** Opt-out and defaults for `install`. */
 	install?: CliInstallConfig;
 };
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argsbarg",
-  "version": "2.0.1",
+  "version": "2.1.1",
   "type": "module",
   "scripts": {
     "//just": "echo this app uses justfile for development tasks"

package/src/builtins/builtins.test.ts

@@ -1,11 +1,10 @@
-import { describe, expect, test, afterEach } from "bun:test";
+import { describe, expect, test } from "bun:test";
 import { cliBuiltinInstallCommand, installBuiltinOptions } from "./install.ts";
 import { cliBuiltinMcpCommand } from "./mcp.ts";
 import { cliPresentationRoot } from "./presentation.ts";
 import { completionBashScript, completionFishScript, completionZshScript } from "./index.ts";
 import { exportPresentationBuiltins } from "./export.ts";
 import { CliProgram } from "../types.ts";
-import { setCompiledExecutableOverride } from "../install/compiled.ts";
 
 const fixture: CliProgram = {
   key: "myapp",
@@ -20,16 +19,11 @@ const fixture: CliProgram = {
   ],
 };
 
-afterEach(() => {
-  setCompiledExecutableOverride(null);
-});
-
 describe("builtins help copy", () => {
-  test("install command includes description and option text when compiled", () => {
-    setCompiledExecutableOverride(true);
+  test("install command includes description and option text", () => {
     const install = cliBuiltinInstallCommand(fixture);
     expect(install.description).toContain("Install the binary");
-    expect(install.notes).toContain("bun build --compile");
+    expect(install.notes).toContain("install --all");
     const names = installBuiltinOptions(fixture).map((o) => o.name);
     expect(names).toContain("all");
     expect(names).toContain("mcp");
@@ -37,7 +31,6 @@ describe("builtins help copy", () => {
   });
 
   test("install omits --mcp option when mcpServer unset", () => {
-    setCompiledExecutableOverride(true);
     const noMcp: CliProgram = { key: "x", description: "x", handler: () => {} };
     const names = installBuiltinOptions(noMcp).map((o) => o.name);
     expect(names).not.toContain("mcp");
@@ -51,23 +44,22 @@ describe("builtins help copy", () => {
 });
 
 describe("presentation root", () => {
-  test("includes mcp when mcpServer set", () => {
-    setCompiledExecutableOverride(false);
+  test("includes mcp and install when enabled", () => {
     const root = cliPresentationRoot(fixture);
-    expect(root.commands?.map((c) => c.key)).toContain("mcp");
-    expect(root.commands?.map((c) => c.key)).not.toContain("install");
+    const keys = root.commands?.map((c) => c.key) ?? [];
+    expect(keys).toContain("mcp");
+    expect(keys).toContain("install");
   });
 
-  test("includes install when compiled", () => {
-    setCompiledExecutableOverride(true);
-    const root = cliPresentationRoot(fixture);
-    expect(root.commands?.map((c) => c.key)).toContain("install");
+  test("omits install when install.enabled is false", () => {
+    const disabled: CliProgram = { ...fixture, install: { enabled: false } };
+    const root = cliPresentationRoot(disabled);
+    expect(root.commands?.map((c) => c.key)).not.toContain("install");
   });
 });
 
 describe("completion emitters", () => {
   test("fish script references app key and subcommands", () => {
-    setCompiledExecutableOverride(true);
     const schema = cliPresentationRoot(fixture);
     const fish = completionFishScript(schema);
     expect(fish).toContain("complete -c myapp");
@@ -75,8 +67,7 @@ describe("completion emitters", () => {
     expect(fish).toContain("install");
   });
 
-  test("bash script includes install flags when compiled", () => {
-    setCompiledExecutableOverride(true);
+  test("bash script includes install flags", () => {
     const schema = cliPresentationRoot(fixture);
     const bash = completionBashScript(schema);
     expect(bash).toContain("--all");
@@ -92,8 +83,7 @@ describe("completion emitters", () => {
 });
 
 describe("schema export builtins", () => {
-  test("exportPresentationBuiltins includes install options when compiled", () => {
-    setCompiledExecutableOverride(true);
+  test("exportPresentationBuiltins includes install options", () => {
     const builtins = exportPresentationBuiltins(fixture);
     const install = builtins.find((b) => b.key === "install");
     expect(install?.options?.find((o) => o.name === "all")?.description).toContain("binary");

package/src/builtins/dispatch.ts

@@ -10,7 +10,6 @@ import { cliBuiltinCompletionGroup as completionGroup } from "./completion-group
 import { cliPresentationRoot } from "./presentation.ts";
 import { cliMcpServeStdio } from "../mcp.ts";
 import { cliInstall } from "../install/index.ts";
-import { isCompiledExecutable } from "../install/compiled.ts";
 import type { ParseResult } from "../parse.ts";
 import { ParseKind } from "../parse.ts";
 
@@ -71,12 +70,6 @@ export async function dispatchBuiltin(
   }
 
   if (pr.path[0] === "install") {
-    if (!isCompiledExecutable()) {
-      process.stderr.write(
-        "install is only available in compiled binaries (bun build --compile).\n",
-      );
-      process.exit(1);
-    }
     if (!caps.install) {
       process.stderr.write("install is disabled. Remove install.enabled: false from the program root.\n");
       process.exit(1);

package/src/builtins/install.ts

@@ -77,13 +77,12 @@ export function installBuiltinOptions(root: CliProgram): CliOption[] {
   return opts;
 }
 
-/** Builds the `install` built-in command (compiled binaries only). */
+/** Builds the `install` built-in command. */
 export function cliBuiltinInstallCommand(root: CliProgram): CliLeaf {
   return {
     key: "install",
     description: "Install the binary, shell completions, agent skills, and MCP config to your user environment.",
     notes:
-      "Requires a compiled binary (bun build --compile).\n\n" +
       "First-time setup:\n" +
       `  {app} install --all --yes\n\n` +
       "Refresh after upgrading:\n" +

package/src/capabilities.ts

@@ -4,7 +4,6 @@ Not exported from the public package barrel.
 */
 
 import type { CliProgram } from "./types.ts";
-import { isCompiledExecutable } from "./install/compiled.ts";
 
 /** Platform builtins derived from program config and runtime. */
 export interface CliCapabilities {
@@ -18,13 +17,16 @@ export function resolveCapabilities(program: CliProgram): CliCapabilities {
   return {
     completion: true,
     mcp: program.mcpServer !== undefined,
-    install: isCompiledExecutable() && program.install?.enabled !== false,
+    install: program.install?.enabled !== false,
   };
 }
 
 /** Reserved top-level command names for the given capabilities. */
 export function reservedCommandNames(caps: CliCapabilities): string[] {
-  const names = ["completion", "install"];
+  const names = ["completion"];
+  if (caps.install) {
+    names.push("install");
+  }
   if (caps.mcp) {
     names.push("mcp");
   }

package/src/index.test.ts

@@ -519,7 +519,7 @@ test("--schema exports JSON for leaf roots", async () => {
   expect(schema.key).toBe("minimal.ts");
   expect(schema.positionals[0].name).toBe("name");
   expect(schema.options[0].name).toBe("verbose");
-  expect(schema.commands.map((c: { key: string }) => c.key)).toEqual(["completion"]);
+  expect(schema.commands.map((c: { key: string }) => c.key)).toEqual(["completion", "install"]);
 });
 
 test("leaf root help lists completion built-in", async () => {

package/src/runtime.ts

@@ -7,7 +7,6 @@ import { builtinInterceptRoot, dispatchBuiltin } from "./builtins/dispatch.ts";
 import { cliPresentationRoot } from "./builtins/presentation.ts";
 import type { CliRouter } from "./types.ts";
 import { type CliNode, type CliProgram, isCliLeaf, isCliRouter } from "./types.ts";
-import { isCompiledExecutable } from "./install/compiled.ts";
 import { CliContext } from "./context.ts";
 import { cliHelpRender } from "./help.ts";
 import { parse, postParseValidate, ParseKind } from "./parse.ts";
@@ -37,8 +36,8 @@ export async function cliRun(program: CliProgram, argv: string[] = process.argv.
     process.exit(1);
   }
 
-  if (argv.length >= 1 && argv[0] === "install" && !isCompiledExecutable()) {
-    process.stderr.write("install is only available in compiled binaries (bun build --compile).\n");
+  if (argv.length >= 1 && argv[0] === "install" && !caps.install) {
+    process.stderr.write("install is disabled. Remove install.enabled: false from the program root.\n");
     process.exit(1);
   }
 

package/src/types.ts

@@ -152,7 +152,7 @@ export interface CliMcpToolConfig {
 }
 
 /**
- * Opt-out and defaults for the `install` built-in (compiled binaries only; program root only).
+ * Opt-out and defaults for the `install` built-in (program root only).
  */
 export interface CliInstallConfig {
   /** When `false`, hide/disable `install` (default: enabled). */
@@ -211,7 +211,7 @@ export type CliNode = CliLeaf | CliRouter;
 export type CliProgram = CliNode & {
   /** When set, enables the `mcp` built-in subcommand. */
   mcpServer?: CliMcpServerConfig;
-  /** Opt-out and defaults for `install` (compiled binaries only). */
+  /** Opt-out and defaults for `install`. */
   install?: CliInstallConfig;
 };
 

package/src/install/compiled.ts

@@ -1,15 +0,0 @@
-/** Test override: when set, `isCompiledExecutable()` returns this value instead of checking Bun.embeddedFiles. */
-let compiledOverride: boolean | null = null;
-
-/** @internal For tests only. */
-export function setCompiledExecutableOverride(value: boolean | null): void {
-  compiledOverride = value;
-}
-
-/** True when running as a `bun build --compile` binary (embedded files present). */
-export function isCompiledExecutable(): boolean {
-  if (compiledOverride !== null) {
-    return compiledOverride;
-  }
-  return (Bun.embeddedFiles?.length ?? 0) > 0;
-}