argsbarg 3.3.6 → 3.3.8

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.3.8] - 2026-06-21
+
+### Changed
+
+- **`install --update`** — downloads the latest release and reinstalls installed artifacts when `install.updateGetLatest` is set. Replaces the top-level `update` command and the old `--update` alias for `--reinstall`.
+
+### Removed
+
+- **`update` built-in** — use `myapp install --update` instead.
+
+## [3.3.7] - 2026-06-21
+
+### Changed
+
+- **`docs mcp`** — intro copy is user-facing (`exposes an MCP server with features similar to the CLI`) instead of describing argsbarg internals.
+
 ## [3.3.6] - 2026-06-21
 
 ### Added
@@ -282,7 +298,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/v3.3.6...HEAD
+[Unreleased]: https://github.com/bdombro/bun-argsbarg/compare/v3.3.8...HEAD
+[3.3.8]: https://github.com/bdombro/bun-argsbarg/releases/tag/v3.3.8
+[3.3.7]: https://github.com/bdombro/bun-argsbarg/releases/tag/v3.3.7
 [3.3.6]: https://github.com/bdombro/bun-argsbarg/releases/tag/v3.3.6
 [3.3.5]: https://github.com/bdombro/bun-argsbarg/releases/tag/v3.3.5
 [3.3.4]: https://github.com/bdombro/bun-argsbarg/releases/tag/v3.3.4

package/README.md

@@ -122,7 +122,7 @@ myapp install --all --yes
 
 This copies the binary to `~/.local/bin`, installs shell completions (bash/zsh/fish when each shell is on PATH), writes Cursor/Claude skills when agent directories exist, and merges MCP server entries into Cursor and Claude config files.
 
-See **[docs/install.md](docs/install.md)** for `--reinstall`, `update`, `--status`, `--uninstall`, and flags.
+See **[docs/install.md](docs/install.md)** for `--reinstall`, `install --update`, `--status`, `--uninstall`, and flags.
 
 
 ### Shell completions
@@ -187,7 +187,7 @@ Add `CliPositional` entries to the command’s `positionals` list (separate from
 
 ### Capabilities (built-ins)
 
-`completion`, `version`, `install`, `update`, and `mcp` are not part of your schema — they are injected at runtime from program-level config (`mcpServer`, `install`, `docs`). Reserved command names: `completion` and `version` always; `install` unless `install.enabled: false`; `update` when `install.updateGetLatest` is set; `mcp` when `mcpServer.enabled` is `true`; `docs` when `docs.enabled` is `true`.
+`completion`, `version`, `install`, and `mcp` are not part of your schema — they are injected at runtime from program-level config (`mcpServer`, `install`, `docs`). Reserved command names: `completion` and `version` always; `install` unless `install.enabled: false`; `mcp` when `mcpServer.enabled` is `true`; `docs` when `docs.enabled` is `true`. When `install.updateGetLatest` is set, `install --update` is available (not a separate command).
 
 
 

package/docs/cli-program.md

@@ -196,7 +196,7 @@ Basic synchronous handlers do not need this structure — only commands with an
 
 ## Reserved names
 
-Do not declare user commands named `completion`, `install`, `mcp`, `version`, `docs`, or `update` at the root — ArgsBarg injects these when configured.
+Do not declare user commands named `completion`, `install`, `mcp`, `version`, or `docs` at the root — ArgsBarg injects these when configured.
 
 ## Cursor rule for consumer repos
 

package/docs/install.md

@@ -12,7 +12,7 @@ myapp install --all --yes
 myapp install --reinstall
 
 # Download latest release (when install.updateGetLatest is configured)
-myapp update
+myapp install --update
 
 # See what is installed
 myapp install --status
@@ -54,7 +54,7 @@ install: {
 }
 ```
 
-When `updateGetLatest` is set, ArgsBarg also registers the **`update`** built-in (`myapp update`).
+When `updateGetLatest` is set, ArgsBarg adds **`install --update`** (download latest release and reinstall installed artifacts).
 
 ### GitHub releases (`ghReleaseUpdateGetLatest`)
 
@@ -105,12 +105,11 @@ Environment:
 | `--quiet` | Suppress summaries and per-step messages (requires `--yes`) |
 | `--prefix <dir>` | Override binary install directory |
 | `--reinstall` | Reinstall artifacts already on disk (implies `--bin` + `--yes`) |
+| `--update` | Download latest release and reinstall installed artifacts (requires `install.updateGetLatest`; implies `--yes`) |
 | `--from <path>` | Binary to copy with `--reinstall` (default: running executable) |
 | `--status` | Read-only inventory |
 | `--uninstall` | Remove artifacts in scope (`--all`, `--bin`, `--completions`, `--skill`, `--mcp`); skips targets not installed |
 
-`--update` is accepted as a deprecated alias for `--reinstall`.
-
 ## MCP merge behavior
 
 When `--mcp` runs, entries are merged into `mcpServers[<sanitized-key>]` with:

package/index.d.ts

@@ -175,7 +175,7 @@ export interface CliUpdateArtifact {
 	/** Called after reinstall completes (e.g. remove a temp download directory). */
 	cleanup?: () => void | Promise<void>;
 }
-/** Fetches the latest release binary for the `update` built-in. */
+/** Fetches the latest release binary for `install --update`. */
 export type CliUpdateGetLatest = (ctx: {
 	version: string;
 }) => Promise<CliUpdateArtifact>;
@@ -185,7 +185,7 @@ export interface CliInstallConfig {
 	/** Default bin directory (default: `~/.local/bin`). Overridden by `INSTALL_PREFIX` env and `--prefix`. */
 	prefix?: string;
 	/**
-	 * When set, enables the `update` built-in (`myapp update`).
+	 * When set, enables `install --update` on the program root.
 	 * Should download or locate the latest release binary and return its path.
 	 */
 	updateGetLatest?: CliUpdateGetLatest;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argsbarg",
-  "version": "3.3.6",
+  "version": "3.3.8",
   "type": "module",
   "engines": {
     "bun": ">=1.3"

package/src/builtins/dispatch.ts

@@ -6,14 +6,12 @@ import { completionFishScript } from "./completion-fish.ts";
 import { completionZshScript } from "./completion-zsh.ts";
 import { cliBuiltinInstallCommand } from "./install.ts";
 import { cliBuiltinMcpCommand } from "./mcp.ts";
-import { cliBuiltinUpdateCommand } from "./update.ts";
 import { cliBuiltinVersionCommand } from "./version.ts";
 import { cliBuiltinCompletionGroup as completionGroup } from "./completion-group.ts";
 import { cliPresentationRoot } from "./presentation.ts";
 import { cliBuiltinDocsGroupIfEnabled } from "../docs/builtin.ts";
 import { cliMcpServeStdio } from "../mcp.ts";
 import { cliInstall } from "../install/index.ts";
-import { cliUpdate } from "../install/update.ts";
 import type { ParseResult } from "../parse.ts";
 import { ParseKind } from "../parse.ts";
 
@@ -82,20 +80,6 @@ export async function dispatchBuiltin(
     process.exit(0);
   }
 
-  if (pr.path[0] === "update") {
-    if (!caps.update) {
-      process.stderr.write(
-        "update is not enabled. Set install.updateGetLatest on the program root.\n",
-      );
-      process.exit(1);
-    }
-    if (pr.path.length !== 1) {
-      process.stderr.write("Unknown subcommand: update " + pr.path.slice(1).join(" ") + "\n");
-      process.exit(1);
-    }
-    await cliUpdate(program);
-  }
-
   if (pr.path[0] === "install") {
     if (!caps.install) {
       process.stderr.write("install is disabled. Remove install.enabled: false from the program root.\n");
@@ -143,17 +127,6 @@ export function builtinInterceptRoot(
     };
   }
 
-  if (first === "update" && caps.update) {
-    return {
-      parseRoot: {
-        key: program.key,
-        description: program.description,
-        commands: [cliBuiltinUpdateCommand(program)],
-      },
-      isLeafCompletionIntercept: false,
-    };
-  }
-
   if (first === "mcp" && caps.mcp) {
     return {
       parseRoot: {

package/src/builtins/export.ts

@@ -3,7 +3,6 @@ import type { CliFallbackMode, CliOption, CliPositional, CliProgram } from "../t
 import { cliBuiltinCompletionGroup } from "./completion-group.ts";
 import { cliBuiltinInstallCommand } from "./install.ts";
 import { cliBuiltinMcpCommand } from "./mcp.ts";
-import { cliBuiltinUpdateCommand } from "./update.ts";
 import { cliBuiltinVersionCommand } from "./version.ts";
 import { cliBuiltinDocsGroupIfEnabled } from "../docs/builtin.ts";
 
@@ -52,9 +51,6 @@ export function exportPresentationBuiltins(program: CliProgram, caps?: CliCapabi
   if (resolved.install) {
     builtins.push(exportBuiltinNode(cliBuiltinInstallCommand(program)));
   }
-  if (resolved.update) {
-    builtins.push(exportBuiltinNode(cliBuiltinUpdateCommand(program)));
-  }
   const docsGroup = cliBuiltinDocsGroupIfEnabled(program);
   if (docsGroup) {
     builtins.push(exportBuiltinNode(docsGroup));

package/src/builtins/install.ts

@@ -80,6 +80,15 @@ export function installBuiltinOptions(root: CliProgram): CliOption[] {
     });
   }
 
+  if (resolveCapabilities(root).update) {
+    const statusIdx = opts.findIndex((o) => o.name === "status");
+    opts.splice(statusIdx, 0, {
+      name: "update",
+      description: "Download and install the latest release.",
+      kind: CliOptionKind.Presence,
+    });
+  }
+
   return opts;
 }
 
@@ -94,7 +103,7 @@ export function cliBuiltinInstallCommand(root: CliProgram): CliLeaf {
       `  ${app} install --all --yes\n\n` +
       "Refresh after upgrading:\n" +
       `  ${app} install --reinstall\n` +
-      `  ${app} update\n\n` +
+      `  ${app} install --update\n\n` +
       "See what is installed:\n" +
       `  ${app} install --status\n\n` +
       "Remove everything installed with --all:\n" +

package/src/builtins/presentation.ts

@@ -5,7 +5,6 @@ import { isCliLeaf, isCliRouter } from "../types.ts";
 import { cliBuiltinCompletionGroup } from "./completion-group.ts";
 import { cliBuiltinInstallCommand } from "./install.ts";
 import { cliBuiltinMcpCommand } from "./mcp.ts";
-import { cliBuiltinUpdateCommand } from "./update.ts";
 import { cliBuiltinVersionCommand } from "./version.ts";
 import { cliBuiltinDocsGroupIfEnabled } from "../docs/builtin.ts";
 
@@ -18,9 +17,6 @@ export function presentationBuiltins(program: CliProgram, caps: CliCapabilities)
   if (caps.install) {
     builtins.push(cliBuiltinInstallCommand(program));
   }
-  if (caps.update) {
-    builtins.push(cliBuiltinUpdateCommand(program));
-  }
   const docsGroup = cliBuiltinDocsGroupIfEnabled(program);
   if (docsGroup) {
     builtins.push(docsGroup);

package/src/capabilities.ts

@@ -32,9 +32,6 @@ export function reservedCommandNames(caps: CliCapabilities): string[] {
   if (caps.install) {
     names.push("install");
   }
-  if (caps.update) {
-    names.push("update");
-  }
   if (caps.docs) {
     names.push("docs");
   }

package/src/docs/mcp-guide.ts

@@ -29,7 +29,7 @@ export function generateMcpGuide(root: CliProgram): string {
   const lines: string[] = [
     `# MCP server (${root.key})`,
     "",
-    `${root.key} exposes an MCP server via argsbarg. Each exposed leaf command becomes an MCP tool.`,
+    `${root.key} exposes an MCP server with features similar to the CLI.`,
     "",
     "## Quick start",
     "",

package/src/install/gh-release-update.ts

@@ -101,7 +101,7 @@ export function createGhVersionCheck(config: GhVersionCheckConfig): {
       if (cached === null || isAlreadyCurrent(config.currentVersion, cached.latest)) {
         return null;
       }
-      return `Update available: v${cached.latest} (you have v${config.currentVersion}). Run \`${config.commandName} update\``;
+      return `Update available: v${cached.latest} (you have v${config.currentVersion}). Run \`${config.commandName} install --update\``;
     },
 
     refreshIfStale(): void {

package/src/install/index.ts

@@ -12,17 +12,18 @@ import {
 import { resolveInstallPaths } from "./paths.ts";
 import { installErr, installInfo, installOut, printInstallStatus } from "./status.ts";
 import { buildUninstallPlan, uninstallSkillDir, type UninstallAction } from "./uninstall.ts";
+import { cliUpdate } from "./update.ts";
 
 export function parseInstallOpts(raw: Record<string, string>): InstallOpts {
   const flag = (name: string) => raw[name] === "1";
-  const reinstall = flag("reinstall") || flag("update");
   return {
     all: flag("all"),
     bin: flag("bin"),
     completions: flag("completions"),
     skill: flag("skill"),
     mcp: flag("mcp"),
-    reinstall,
+    reinstall: flag("reinstall"),
+    update: flag("update"),
     from: raw.from,
     status: flag("status"),
     uninstall: flag("uninstall"),
@@ -38,8 +39,8 @@ export function validateInstallOpts(opts: InstallOpts): string | null {
   if (opts.quiet && opts.dry) {
     return "--quiet cannot be combined with --dry.";
   }
-  if (opts.quiet && !opts.yes && !opts.json && !opts.reinstall) {
-    return "--quiet requires --yes (or --json / --reinstall).";
+  if (opts.quiet && !opts.yes && !opts.json && !opts.reinstall && !opts.update) {
+    return "--quiet requires --yes (or --json / --reinstall / --update).";
   }
   if (opts.json) {
     opts.yes = true;
@@ -48,22 +49,31 @@ export function validateInstallOpts(opts: InstallOpts): string | null {
     opts.bin = true;
     opts.yes = true;
   }
+  if (opts.update) {
+    opts.yes = true;
+  }
 
   const mutationFlags =
-    opts.all || opts.bin || opts.completions || opts.skill || opts.mcp || opts.reinstall || opts.uninstall;
+    opts.all || opts.bin || opts.completions || opts.skill || opts.mcp || opts.reinstall || opts.update || opts.uninstall;
   if (opts.status && mutationFlags) {
     return "--status is mutually exclusive with install/reinstall/uninstall targets.";
   }
   if (
     opts.reinstall &&
-    (opts.all || opts.completions || opts.skill || opts.mcp || opts.uninstall || opts.status)
+    (opts.all || opts.completions || opts.skill || opts.mcp || opts.uninstall || opts.status || opts.update)
   ) {
     return "--reinstall cannot be combined with other target flags.";
   }
-  if (opts.uninstall && (opts.reinstall || opts.status)) {
-    return "--uninstall cannot be combined with --reinstall or --status.";
+  if (
+    opts.update &&
+    (opts.all || opts.bin || opts.completions || opts.skill || opts.mcp || opts.uninstall || opts.status || opts.reinstall)
+  ) {
+    return "--update cannot be combined with other target flags.";
+  }
+  if (opts.uninstall && (opts.reinstall || opts.update || opts.status)) {
+    return "--uninstall cannot be combined with --reinstall, --update, or --status.";
   }
-  if (!opts.status && !opts.reinstall) {
+  if (!opts.status && !opts.reinstall && !opts.update) {
     const hasTarget = opts.all || opts.bin || opts.completions || opts.skill || opts.mcp;
     if (!hasTarget) {
       return "Specify at least one target: --all, --bin, --completions, --skill, or --mcp.";
@@ -185,6 +195,21 @@ export async function runInstallMutation(
 
 /** Main install command orchestrator. */
 export async function cliInstall(root: CliProgram, rawOpts: Record<string, string>): Promise<never> {
+  const opts = parseInstallOpts(rawOpts);
+  const err = validateInstallOpts(opts);
+  if (err) {
+    installErr(err);
+    process.exit(1);
+  }
+
+  if (opts.update) {
+    if (!resolveCapabilities(root).update) {
+      installErr("install --update requires install.updateGetLatest on the program root.");
+      process.exit(1);
+    }
+    await cliUpdate(root);
+  }
+
   let result: Awaited<ReturnType<typeof runInstallMutation>>;
   try {
     result = await runInstallMutation(root, rawOpts);
@@ -193,26 +218,26 @@ export async function cliInstall(root: CliProgram, rawOpts: Record<string, strin
     process.exit(1);
   }
 
-  const { changed, opts, paths } = result;
+  const { changed, opts: mutationOpts, paths } = result;
 
-  if (opts.status) {
+  if (mutationOpts.status) {
     process.exit(0);
   }
 
-  if (opts.json) {
+  if (mutationOpts.json) {
     process.stdout.write(JSON.stringify(changed, null, 2) + "\n");
     process.exit(0);
   }
 
-  if (!opts.quiet && changed.length > 0) {
-    const verb = opts.uninstall ? "Removed" : opts.reinstall ? "Reinstalled" : "Installed";
-    installOut(`${verb} ${changed.length} file(s).`, opts);
+  if (!mutationOpts.quiet && changed.length > 0) {
+    const verb = mutationOpts.uninstall ? "Removed" : mutationOpts.reinstall ? "Reinstalled" : "Installed";
+    installOut(`${verb} ${changed.length} file(s).`, mutationOpts);
     if (
-      !opts.uninstall &&
-      (opts.all || opts.bin) &&
+      !mutationOpts.uninstall &&
+      (mutationOpts.all || mutationOpts.bin) &&
       changed.some((p) => p === paths.bashRc || p === paths.zshRc || p === paths.binaryPath)
     ) {
-      installOut("Open a new shell, or run: hash -r (bash) / rehash (zsh)", opts);
+      installOut("Open a new shell, or run: hash -r (bash) / rehash (zsh)", mutationOpts);
     }
   }
 

package/src/install/plan.ts

@@ -16,6 +16,7 @@ export interface InstallOpts {
   skill?: boolean;
   mcp?: boolean;
   reinstall?: boolean;
+  update?: boolean;
   from?: string;
   status?: boolean;
   uninstall?: boolean;

package/src/install/update.test.ts

@@ -36,23 +36,25 @@ function fixtureWithUpdate(hook: () => Promise<CliUpdateArtifact>): CliProgram {
   };
 }
 
-test("update reserved when updateGetLatest is set", () => {
+test("user update command is allowed when updateGetLatest is set", () => {
   const root: CliProgram = {
     ...fixtureWithUpdate(async () => ({ path: process.execPath })),
-    commands: [{ key: "update", description: "conflict", handler: () => {} }],
+    commands: [{ key: "update", description: "Custom update", handler: () => {} }],
   };
-  expect(() => cliValidateProgram(root)).toThrow(/Reserved command name: update/);
+  expect(() => cliValidateProgram(root)).not.toThrow();
 });
 
-test("presentation includes update builtin when hook is set", () => {
+test("presentation exposes install --update when hook is set", () => {
   const root = fixtureWithUpdate(async () => ({ path: process.execPath }));
   const presentation = cliPresentationRoot(root);
-  expect(presentation.commands.some((c) => c.key === "update")).toBe(true);
+  const install = presentation.commands.find((c) => c.key === "install");
+  expect(install?.options?.some((o) => o.name === "update")).toBe(true);
+  expect(presentation.commands.some((c) => c.key === "update")).toBe(false);
 });
 
-test("parseInstallOpts maps deprecated --update to reinstall", () => {
-  const opts = parseInstallOpts({ update: "1" });
-  expect(opts.reinstall).toBe(true);
+test("parseInstallOpts treats --update separately from --reinstall", () => {
+  expect(parseInstallOpts({ update: "1" }).update).toBe(true);
+  expect(parseInstallOpts({ update: "1" }).reinstall).toBe(false);
 });
 
 test("runInstallMutation honors --from for binary copy", async () => {
@@ -78,7 +80,7 @@ test("runInstallMutation honors --from for binary copy", async () => {
   expect(readFileSync(dest, "utf8")).toContain("echo hi");
 });
 
-test("cliInvoke update uses hook and reinstalls", async () => {
+test("cliInvoke install --update uses hook and reinstalls", async () => {
   const source = join(home, "new-binary");
   writeFileSync(source, "#!/bin/sh\necho hi\n", "utf8");
   chmodSync(source, 0o755);
@@ -88,19 +90,19 @@ test("cliInvoke update uses hook and reinstalls", async () => {
     version: "2.0.0",
   }));
 
-  const result = await cliInvoke(root, ["update"]);
+  const result = await cliInvoke(root, ["install", "--update"]);
   expect(result.exitCode).toBe(0);
   expect(result.stdout).toContain("Updated testapp 1.0.0 → 2.0.0");
   expect(existsSync(join(home, ".local", "bin", "testapp"))).toBe(true);
 });
 
-test("cliInvoke update reports already current", async () => {
+test("cliInvoke install --update reports already current", async () => {
   const root = fixtureWithUpdate(async () => ({
     path: process.execPath,
     version: "1.0.0",
   }));
 
-  const result = await cliInvoke(root, ["update"]);
+  const result = await cliInvoke(root, ["install", "--update"]);
   expect(result.exitCode).toBe(0);
   expect(result.stdout).toContain("Already at v1.0.0");
 });

package/src/install/update.ts

@@ -3,7 +3,7 @@ import type { CliProgram } from "../types.ts";
 import { runInstallMutation } from "./index.ts";
 import { installErr } from "./status.ts";
 
-/** Downloads the latest release and reinstalls installed artifacts (`myapp update`). */
+/** Downloads the latest release and reinstalls installed artifacts (`myapp install --update`). */
 export async function cliUpdate(root: CliProgram): Promise<never> {
   const hook = root.install?.updateGetLatest;
   if (!hook) {

package/src/invoke.ts

@@ -5,10 +5,10 @@ process.exit so MCP tool calls can run handlers repeatedly.
 */
 
 import { CliContext } from "./context.ts";
-import { builtinInterceptRoot } from "./builtins/dispatch.ts";
+import { builtinInterceptRoot, dispatchBuiltin } from "./builtins/dispatch.ts";
 import { cliPresentationRoot } from "./builtins/presentation.ts";
 import { parse, postParseValidate, ParseKind } from "./parse.ts";
-import { type CliNode, type CliProgram, isCliLeaf, isCliRouter } from "./types.ts";
+import { type CliNode, type CliProgram, type CliRouter, isCliLeaf, isCliRouter } from "./types.ts";
 import { format } from "node:util";
 
 /** Outcome of a non-exiting CLI invocation. */
@@ -52,10 +52,17 @@ function findChild(cmds: CliNode[], name: string): CliNode | undefined {
  */
 export async function cliInvoke(root: CliProgram, argv: string[]): Promise<CliInvokeResult> {
   let parseRoot: CliNode = root;
+  let completionParseRoot: CliRouter = cliPresentationRoot(root);
+  let isLeafCompletionIntercept = false;
+
   if (isCliLeaf(root)) {
     const intercept = builtinInterceptRoot(root, argv);
-    if (intercept.parseRoot !== root) {
+    if (intercept.isLeafCompletionIntercept || intercept.parseRoot !== root) {
       parseRoot = intercept.parseRoot;
+      completionParseRoot = isCliRouter(intercept.parseRoot)
+        ? intercept.parseRoot
+        : cliPresentationRoot(root);
+      isLeafCompletionIntercept = intercept.isLeafCompletionIntercept;
     }
   } else {
     parseRoot = cliPresentationRoot(root);
@@ -165,6 +172,10 @@ export async function cliInvoke(root: CliProgram, argv: string[]): Promise<CliIn
   };
 
   try {
+    if (pr.kind === ParseKind.Ok) {
+      await dispatchBuiltin(root, pr, { isLeafCompletionIntercept, parseRoot: completionParseRoot });
+    }
+
     await Promise.resolve(handler(ctx));
     return { kind: "ok", exitCode: 0, stdout, stderr };
   } catch (err) {

package/src/runtime.ts

@@ -40,13 +40,6 @@ export async function cliRun(program: CliProgram, argv: string[] = process.argv.
     process.exit(1);
   }
 
-  if (argv.length >= 1 && argv[0] === "update" && !caps.update) {
-    process.stderr.write(
-      "update is not enabled. Set install.updateGetLatest on the program root.\n",
-    );
-    process.exit(1);
-  }
-
   if (argv.length >= 1 && argv[0] === "docs" && !caps.docs) {
     process.stderr.write("docs is not enabled. Set docs: { enabled: true } on the program root.\n");
     process.exit(1);

package/src/schema.ts

@@ -6,7 +6,7 @@ import { type CliNode, type CliProgram, isCliLeaf, isCliRouter } from "./types.t
 import { exportPresentationBuiltins, type CliSchemaExport } from "./builtins/export.ts";
 import { cliResolveNotes } from "./help.ts";
 
-const RESERVED = new Set(["completion", "install", "docs", "mcp", "version", "update"]);
+const RESERVED = new Set(["completion", "install", "docs", "mcp", "version"]);
 
 function exportCommand(cmd: CliNode, root: CliProgram): CliSchemaExport {
   const out: CliSchemaExport = {

package/src/types.ts

@@ -162,7 +162,7 @@ export interface CliUpdateArtifact {
   cleanup?: () => void | Promise<void>;
 }
 
-/** Fetches the latest release binary for the `update` built-in. */
+/** Fetches the latest release binary for `install --update`. */
 export type CliUpdateGetLatest = (ctx: { version: string }) => Promise<CliUpdateArtifact>;
 
 export interface CliInstallConfig {
@@ -171,7 +171,7 @@ export interface CliInstallConfig {
   /** Default bin directory (default: `~/.local/bin`). Overridden by `INSTALL_PREFIX` env and `--prefix`. */
   prefix?: string;
   /**
-   * When set, enables the `update` built-in (`myapp update`).
+   * When set, enables `install --update` on the program root.
    * Should download or locate the latest release binary and return its path.
    */
   updateGetLatest?: CliUpdateGetLatest;

package/src/builtins/update.ts

@@ -1,14 +0,0 @@
-import type { CliLeaf, CliProgram } from "../types.ts";
-import { cliUpdate } from "../install/update.ts";
-
-/** Built-in `update` command (enabled when `install.updateGetLatest` is set). */
-export function cliBuiltinUpdateCommand(program: CliProgram): CliLeaf {
-  return {
-    key: "update",
-    description: "Download and install the latest release.",
-    mcpTool: { enabled: false },
-    handler: async () => {
-      await cliUpdate(program);
-    },
-  };
-}