argsbarg 5.0.2 → 5.1.0

package/CHANGELOG.md

@@ -7,11 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [5.1.0] - 2026-07-04
+
+### Changed
+
+- **Breaking: `config get`/`set` → `configure get`/`set`** — top-level `config` removed; app config introspection lives under the `configure` built-in.
+
+## [5.0.3] - 2026-07-04
+
+### Changed
+
+- **JSDoc style** — short `test()` callbacks no longer carry redundant one-liners; `describe` blocks still documented. `requireYesInNonTty` uses per-parameter JSDoc instead of `@param`. Pure re-export barrels stay comment-free.
+
 ## [5.0.2] - 2026-07-04
 
 ### Changed
 
-- **JSDoc style** — every `describe` and `test` block in `src/**/*.test.ts` now has a human-readable JSDoc; `configure` modules brought in line with file headers and symbol docs.
+- **JSDoc style** — every `describe` block in `src/**/*.test.ts` now has a human-readable JSDoc; `configure` modules brought in line with file headers and symbol docs.
 
 ## [5.0.1] - 2026-07-04
 
@@ -573,7 +585,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/v5.0.2...HEAD
+[Unreleased]: https://github.com/bdombro/bun-argsbarg/compare/v5.1.0...HEAD
+[5.1.0]: https://github.com/bdombro/bun-argsbarg/releases/tag/v5.1.0
+[5.0.3]: https://github.com/bdombro/bun-argsbarg/releases/tag/v5.0.3
 [5.0.2]: https://github.com/bdombro/bun-argsbarg/releases/tag/v5.0.2
 [5.0.1]: https://github.com/bdombro/bun-argsbarg/releases/tag/v5.0.1
 [5.0.0]: https://github.com/bdombro/bun-argsbarg/releases/tag/v5.0.0

package/docs/cli-program.md

@@ -412,11 +412,11 @@ await cli.run();
 
 | Field | Default | Purpose |
 | --- | --- | --- |
-| `description` | *(required)* | Shown in prompts, `config get`, and bundle manifests |
+| `description` | *(required)* | Shown in prompts, `configure get`, and bundle manifests |
 | `title` | config key | Short label in interactive `configure` |
 | `default` | — | Used when `jsonSchema` omitted (all-string mode) |
 | `required` | `true` | When `false`, optional unless required by `jsonSchema` |
-| `sensitive` | name heuristic (`token`, `secret`, …) | Redact in prompts, `config get`, and status |
+| `sensitive` | name heuristic (`token`, `secret`, …) | Redact in prompts, `configure get`, and status |
 | `env` | — | When set: non-empty host env overrides file; consulted again after `resolve` when `resolve` returns `undefined`; exported to `process.env` after resolve |
 | `resolve` | — | Optional fallback after file; return `undefined` to fall back to `env` (if set) and defaults |
 
@@ -425,7 +425,7 @@ await cli.run();
 - Default: `$XDG_CONFIG_HOME/<sanitized-key>/config` or `%APPDATA%/<key>/config`.
 - JSON: flat object keyed by schema names — `{ "apiToken": "…", "maxRetries": 5 }`.
 - **Strict:** unknown keys rejected on load.
-- **CLI:** missing required config exits 1 before the leaf handler (TTY prompt when interactive). Built-in `docs` and `config get`/`set` skip this exit.
+- **CLI:** missing required config exits 1 before the leaf handler (TTY prompt when interactive). Built-in `docs` and `configure get`/`set` skip this exit.
 - **MCP:** server stays up; missing config returns `isError: true` at `tools/call`.
 - **Configure:** interactive `configure` runs the app config wizard; **`configure --sync`** refreshes agent artifacts.
 - **Agent integration:** `configure.agentIntegration` (`mcp` | `skill` | `both`) sets default sync targets; see [configure.md](configure.md#configuretargets).
@@ -436,7 +436,7 @@ See [config-schema.md](config-schema.md) for codegen, [configure.md](configure.m
 
 ## Reserved names
 
-Do not declare user commands named `completion`, `configure`, `mcp`, `version`, `docs`, or `config` at the root — ArgsBarg injects these when configured.
+Do not declare user commands named `completion`, `configure`, `mcp`, `version`, or `docs` at the root — ArgsBarg injects these when configured. App config uses `configure get` / `configure set` subcommands (not a top-level `config` command).
 
 ## Cursor rule for consumer repos
 

package/docs/config-schema.md

@@ -40,7 +40,7 @@ await cli.run();
 | --- | --- |
 | Config file | Flat JSON keyed by schema names; strict load (unknown keys rejected) |
 | Interactive `configure` / `--status` | Auto-runs config wizard when `entries` is non-empty; `--status` for read-only inventory |
-| Built-in `config get` / `config set` | Read/write resolved values (opt-out via `commands: false`) |
+| Built-in `configure get` / `configure set` | Read/write resolved values (opt-out via `commands: false`) |
 | MCP bundle / Claude plugin | `userConfig` for entries with `env` set |
 | `ctx.appConfig` in handlers | `get`, `require`, `set`, `read`, `path`, `dir` — prefer over `process.env` |
 
@@ -48,7 +48,7 @@ await cli.run();
 
 **No public config I/O exports** — consumers use `program.appConfig` for authoring and `ctx.appConfig` in handlers.
 
-See [cli-program.md — Configuration](cli-program.md#configuration-programappconfig) for resolution order, bootstrap timing, and reserved `config` command.
+See [cli-program.md — Configuration](cli-program.md#configuration-programappconfig) for resolution order, bootstrap timing, and `configure get`/`set`.
 
 ## `CliAppConfig` and `CliAppConfigEntry`
 
@@ -191,26 +191,26 @@ appConfig: {
 
 All file values are strings. Defaults come from `entry.default`.
 
-## Built-in `config` command
+## Built-in `configure get` / `configure set`
 
 When `program.appConfig` is set and `commands !== false`:
 
 | Subcommand | Purpose |
 | --- | --- |
-| `config get [key]` | Resolved value(s); `--json`; `--json --pretty` |
-| `config set <key> <value>` | One key; full document re-validated after merge |
+| `configure get [key]` | Resolved value(s); `--json`; `--json --pretty` |
+| `configure set <key> <value>` | One key; full document re-validated after merge |
 
-`config get`/`set` skip required-config exit and TTY prompts. Sensitive values redact on `get` (`REDACTED` / `{ "set": true }` with `--json`).
+`configure get`/`set` skip required-config exit and TTY prompts. Sensitive values redact on `get` (`REDACTED` / `{ "set": true }` with `--json`).
 
-Object/array/`$ref` properties require `--json` on `config set`.
+Object/array/`$ref` properties require `--json` on `configure set`.
 
 ## Example in this repo
 
 | Example | Role |
 | --- | --- |
-| [`examples/full-example/`](../examples/full-example/) | **Copy template** — schemagen discovery, `APP_CONFIG_JSON_SCHEMA` bridge, `program.appConfig`, built-in `config get`/`set` |
+| [`examples/full-example/`](../examples/full-example/) | **Copy template** — schemagen discovery, `APP_CONFIG_JSON_SCHEMA` bridge, `program.appConfig`, built-in `configure get`/`set` |
 
 ```bash
 cd examples/full-example && just setup && just schemagen
-FULL_EXAMPLE_API_TOKEN=dev just run config get apiToken --json
+FULL_EXAMPLE_API_TOKEN=dev just run configure get apiToken --json
 ```

package/docs/configure.md

@@ -47,6 +47,10 @@ Dev flow matches release: formula `install` copies the binary and generates comp
 
 # Remove app config only (not skills/MCP)
 <key> configure --remove-config --yes
+
+# Read or write app config (non-interactive; when program.appConfig is set)
+<key> configure get [key] [--json] [--pretty]
+<key> configure set <key> <value> [--json]
 ```
 
 Non-interactive / CI: pass **`--yes`** (or **`--json`**, **`--sync`**, **`--remove-all`**, **`--remove-config`**) — see [Confirmation](#confirmation).

package/docs/mcp.md

@@ -327,7 +327,7 @@ At server start (`Cli.serveMcp()`), before the NDJSON loop:
 - Loaded at MCP startup; host `process.env` wins for mapped env vars already set.
 - Missing required config does **not** exit the MCP server — enforced at `tools/call` with a helpful error.
 - Configure interactively: `myapp configure` (see [configure.md](configure.md)).
-- Built-in `config get` / `config set` when `program.appConfig.commands` is enabled (default). Hosts inject `user_config` → env at spawn; they never write the argsbarg config file.
+- Built-in `configure get` / `configure set` when `program.appConfig.commands` is enabled (default). Hosts inject `user_config` → env at spawn; they never write the argsbarg config file.
 
 Example:
 

package/examples/full-example/README.md

@@ -6,7 +6,7 @@
 
 | Area | Files / wiring |
 | --- | --- |
-| All builtins | `completion`, `version`, `install`, `docs`, `mcp`, `config get`/`set` |
+| All builtins | `completion`, `version`, `configure`, `docs`, `mcp`, `configure get`/`set` |
 | `program.appConfig` | `src/types.ts` (`AppConfig`) → `schemas/configSchemas.ts` |
 | `outputSchema` | `src/commands/status/types.ts` (`StatusJsonOutput`) → `schemas/outputSchemas.ts` |
 | Schemagen | `scripts/schemagen.ts` + `scripts/schemagen/discover-schema-roots.ts` |
@@ -47,7 +47,7 @@ cd examples/full-example
 just setup
 just schemagen   # after changing src/**/types.ts
 FULL_EXAMPLE_API_TOKEN=dev just run status --json
-FULL_EXAMPLE_API_TOKEN=dev just run config get apiToken --json
+FULL_EXAMPLE_API_TOKEN=dev just run configure get apiToken --json
 FULL_EXAMPLE_API_TOKEN=dev just run docs readme
 ```
 

package/examples/full-example/src/program.ts

@@ -50,8 +50,5 @@ export const program = {
     mcpd: true,
     claudePlugin: true,
   },
-  configure: {
-    // Defaults: agentIntegration picks skill vs MCP for sync; app config is opt-in in interactive configure.
-  },
   commands: [echoCommand, statusCommand],
 } satisfies CliProgram;

package/index.d.ts

@@ -281,7 +281,7 @@ export interface CliAppConfigEntry {
 	/** When `false`, optional for bootstrap and MCP enforcement. Default: `true`. */
 	required?: boolean;
 	/**
-	 * Mask stdin during prompts and redact on `config get`.
+	 * Mask stdin during prompts and redact on `configure get`.
 	 * Default: `/key|token|secret|password/i.test(name)`.
 	 */
 	sensitive?: boolean;
@@ -297,7 +297,7 @@ export interface CliAppConfigEntry {
  * App configuration block on the program root ({@link CliProgram.appConfig}).
  */
 export interface CliAppConfig {
-	/** Built-in `config get` / `config set`. Default: enabled when `appConfig` is set. */
+	/** Built-in `configure get` / `configure set`. Default: enabled when `appConfig` is set. */
 	commands?: boolean | {
 		enabled?: boolean;
 		mcpSet?: boolean;
@@ -551,11 +551,16 @@ export declare function shouldRunHeadlessWithYes(ctx: HeadlessContext, opts: {
 	hasRequiredArgs: boolean;
 	dryRun?: boolean;
 }, interactive?: boolean): boolean;
-/**
- * Exits when non-interactive mode is used without `--yes`.
- * @param hint - Command-specific guidance appended to the error
- */
-export declare function requireYesInNonTty(yes: boolean, hint: string, dryRun?: boolean, interactive?: boolean): void;
+/** Exits when non-interactive mode is used without `--yes`. */
+export declare function requireYesInNonTty(
+/** True when `--yes` was passed on the command line. */
+yes: boolean, 
+/** Command-specific guidance appended to the error message. */
+hint: string, 
+/** When true, skip the check (dry-run preview). */
+dryRun?: boolean, 
+/** Injectable TTY probe for tests. */
+interactive?: boolean): void;
 /** Prefixes a success message when running in dry-run mode. */
 export declare function formatDryRunMessage(message: string, dryRun: boolean): string;
 /** Resolved paths for `mcp bundle`. */

package/package.json

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

package/src/builtins/builtins.test.ts

@@ -37,7 +37,6 @@ const noMcp: CliProgram = {
 
 /** Tests for builtins help copy. */
 describe("builtins help copy", () => {
-  /** Configure command includes Homebrew-oriented description. */
   test("configure command includes Homebrew-oriented description", () => {
     const configure = cliBuiltinConfigureCommand(fixture);
     expect(configure.description).toContain("agent skills");
@@ -51,7 +50,6 @@ describe("builtins help copy", () => {
     expect(yesOpt?.shortName).toBe("y");
   });
 
-  /** Configure copy omits MCP when mcpServer unset. */
   test("configure copy omits MCP when mcpServer unset", () => {
     const caps = resolveCapabilities(noMcp);
     expect(configureCommandDescription(noMcp, caps)).toBe(
@@ -79,7 +77,6 @@ describe("builtins help copy", () => {
     expect(configureBuiltinOptions(withConfig).map((o) => o.name)).toContain("remove-config");
   });
 
-  /** Configure -y parses as --yes. */
   test("configure -y parses as --yes", () => {
     const root = cliParseRoot(fixture);
     const pr = postParseValidate(root, parse(root, ["configure", "-y", "--sync"]));
@@ -90,7 +87,6 @@ describe("builtins help copy", () => {
     }
   });
 
-  /** Mcp builtin description is user-facing. */
   test("mcp builtin description is user-facing", () => {
     const withDocs: CliProgram = {
       ...fixture,
@@ -105,7 +101,6 @@ describe("builtins help copy", () => {
 
 /** Tests for presentation root. */
 describe("presentation root", () => {
-  /** Includes mcp and configure when enabled. */
   test("includes mcp and configure when enabled", () => {
     const root = cliPresentationRoot(fixture);
     const keys = root.commands?.map((c) => c.key) ?? [];
@@ -115,14 +110,12 @@ describe("presentation root", () => {
     expect(keys).not.toContain("install");
   });
 
-  /** Omits configure when configure.enabled is false. */
   test("omits configure when configure.enabled is false", () => {
     const disabled: CliProgram = { ...fixture, configure: { enabled: false } };
     const root = cliPresentationRoot(disabled);
     expect(root.commands?.map((c) => c.key)).not.toContain("configure");
   });
 
-  /** Includes version builtin. */
   test("includes version builtin", () => {
     const root = cliPresentationRoot(fixture);
     expect(root.commands?.map((c) => c.key)).toContain("version");
@@ -131,7 +124,6 @@ describe("presentation root", () => {
 
 /** Tests for completion emitters. */
 describe("completion emitters", () => {
-  /** Tests that fish script references app key and subcommands. */
   test("fish script references app key and subcommands", () => {
     const schema = cliPresentationRoot(fixture);
     const fish = completionFishScript(schema);
@@ -140,7 +132,6 @@ describe("completion emitters", () => {
     expect(fish).toContain("configure");
   });
 
-  /** Tests that bash script includes configure flags. */
   test("bash script includes configure flags", () => {
     const schema = cliPresentationRoot(fixture);
     const bash = completionBashScript(schema);
@@ -148,7 +139,6 @@ describe("completion emitters", () => {
     expect(bash).toContain("--sync");
   });
 
-  /** Tests that zsh script registers compdef. */
   test("zsh script registers compdef", () => {
     const schema = cliPresentationRoot({
       key: "zapp",
@@ -164,8 +154,8 @@ describe("completion emitters", () => {
 
 /** Tests for schema export builtins. */
 describe("schema export builtins", () => {
-  /** ExportPresentationBuiltins includes config when appConfig set. */
-  test("exportPresentationBuiltins includes config when appConfig set", () => {
+  /** ExportPresentationBuiltins nests configure get/set when appConfig set. */
+  test("exportPresentationBuiltins nests configure get/set when appConfig set", () => {
     const withConfig: CliProgram = {
       ...fixture,
       appConfig: {
@@ -175,11 +165,16 @@ describe("schema export builtins", () => {
       },
     };
     const builtins = exportPresentationBuiltins(withConfig);
-    expect(builtins.map((b) => b.key)).toContain("config");
     expect(builtins.map((b) => b.key)).toContain("configure");
+    expect(builtins.map((b) => b.key)).not.toContain("config");
+    const configureNode = builtins.find((b) => b.key === "configure");
+    expect(configureNode && "commands" in configureNode).toBe(true);
+    if (configureNode && "commands" in configureNode) {
+      const keys = configureNode.commands?.map((c) => c.key) ?? [];
+      expect(keys).toEqual(expect.arrayContaining(["get", "set"]));
+    }
   });
 
-  /** ExportPresentationBuiltins omits hidden completion. */
   test("exportPresentationBuiltins omits hidden completion", () => {
     const builtins = exportPresentationBuiltins(fixture);
     expect(builtins.map((b) => b.key)).not.toContain("completion");

package/src/builtins/config.test.ts

@@ -38,7 +38,7 @@ describe("builtins/config", () => {
       const configPath = resolveAppConfigPath(program);
       mkdirSync(dirname(configPath), { recursive: true });
       writeFileSync(configPath, `${JSON.stringify({ apiToken: "secret" })}\n`);
-      const result = await new Cli(program).invoke(["config", "get", "apiToken"]);
+      const result = await new Cli(program).invoke(["configure", "get", "apiToken"]);
       expect(result.exitCode).toBe(0);
       expect(result.stdout.trim()).toBe("REDACTED");
     } finally {
@@ -61,7 +61,7 @@ describe("builtins/config", () => {
       const configPath = resolveAppConfigPath(program);
       mkdirSync(dirname(configPath), { recursive: true });
       writeFileSync(configPath, `${JSON.stringify({ apiToken: "secret" })}\n`);
-      const result = await new Cli(program).invoke(["config", "get", "apiToken", "--json"]);
+      const result = await new Cli(program).invoke(["configure", "get", "apiToken", "--json"]);
       expect(result.exitCode).toBe(0);
       expect(JSON.parse(result.stdout)).toEqual({ set: true });
     } finally {
@@ -82,9 +82,9 @@ describe("builtins/config", () => {
     try {
       const program = configFixture();
       writeAppConfigFile(program, { apiToken: "seed" });
-      const result = await new Cli(program).invoke(["config", "set", "port", "9090"]);
+      const result = await new Cli(program).invoke(["configure", "set", "port", "9090"]);
       expect(result.exitCode).toBe(0);
-      const get = await new Cli(program).invoke(["config", "get", "port"]);
+      const get = await new Cli(program).invoke(["configure", "get", "port"]);
       expect(get.stdout.trim()).toBe("9090");
     } finally {
       if (prevHome === undefined) delete process.env.HOME;

package/src/builtins/config.ts

@@ -1,14 +1,19 @@
 /*
-Built-in `config get` / `config set` commands.
+Built-in `configure get` / `configure set` subcommands.
 */
 
 import { bootstrapAppConfig } from "../config/bootstrap.ts";
-import { configEntrySensitive, defaultConfigEntryTitle } from "../config/entry.ts";
+import {
+  configCommandsEnabled,
+  configEntrySensitive,
+  configMcpSetEnabled,
+  defaultConfigEntryTitle,
+} from "../config/entry.ts";
 import { writeAppConfigFile } from "../config/file.ts";
 import { captureMappedHostEnv, exportConfigToEnv, resolveAppConfig } from "../config/resolve.ts";
 import { configPropertySchema, effectiveJsonSchema } from "../config/schema.ts";
 import { parseConfigSetValue } from "../config/validate.ts";
-import type { CliLeaf, CliOption, CliProgram, CliRouter } from "../types.ts";
+import type { CliLeaf, CliOption, CliProgram } from "../types.ts";
 import { CliOptionKind } from "../types.ts";
 
 const JSON_OPTION: CliOption = {
@@ -182,16 +187,16 @@ function configSetLeaf(program: CliProgram, mcpSetEnabled: boolean): CliLeaf {
     handler: (ctx) => {
       const key = ctx.args[0];
       if (!key) {
-        process.stderr.write("config set requires a key.\n");
+        process.stderr.write("configure set requires a key.\n");
         process.exit(1);
       }
       const raw = ctx.args[1];
       if (raw === undefined || raw.length === 0) {
         if (!ctx.hasFlag("json")) {
-          process.stderr.write("config set requires a value (or --json).\n");
+          process.stderr.write("configure set requires a value (or --json).\n");
           process.exit(1);
         }
-        process.stderr.write("config set requires a value.\n");
+        process.stderr.write("configure set requires a value.\n");
         process.exit(1);
       }
       configSetRun(program, key, raw, ctx.hasFlag("json"));
@@ -199,23 +204,15 @@ function configSetLeaf(program: CliProgram, mcpSetEnabled: boolean): CliLeaf {
   };
 }
 
-import { configCommandsEnabled, configMcpSetEnabled } from "../config/entry.ts";
-
-/** Built-in `config` router when program.appConfig is set. */
-export function cliBuiltinConfigGroup(program: CliProgram): CliRouter {
+/** `configure get` / `configure set` leaves when app config commands are enabled. */
+export function configureConfigSubcommands(
+  program: CliProgram,
+  mcpSetEnabled = configMcpSetEnabled(program),
+): CliLeaf[] {
   if (!program.appConfig) {
-    throw new Error("config not enabled");
+    throw new Error("configure config subcommands require program.appConfig");
   }
-  return {
-    key: "config",
-    description: "Read or write app configuration.",
-    commands: [configGetLeaf(program), configSetLeaf(program, configMcpSetEnabled(program))],
-  };
+  return [configGetLeaf(program), configSetLeaf(program, mcpSetEnabled)];
 }
 
-export function cliBuiltinConfigGroupIfEnabled(program: CliProgram): CliRouter | undefined {
-  if (!configCommandsEnabled(program)) {
-    return undefined;
-  }
-  return cliBuiltinConfigGroup(program);
-}
+export { configCommandsEnabled };

package/src/builtins/configure.ts

@@ -1,11 +1,23 @@
 import { resolveCapabilities } from "../capabilities.ts";
-import { type CliLeaf, type CliOption, CliOptionKind, type CliProgram } from "../types.ts";
+import { configCommandsEnabled, configMcpSetEnabled } from "../config/entry.ts";
+import {
+  CliFallbackMode,
+  type CliLeaf,
+  type CliOption,
+  CliOptionKind,
+  type CliProgram,
+  type CliRouter,
+} from "../types.ts";
+import { configureConfigSubcommands } from "./config.ts";
 import {
   configureCommandDescription,
   configureCommandNotes,
   configureSyncOptionDescription,
 } from "./configure-copy.ts";
 
+/** Hidden fallback leaf for bare `configure` (interactive / flag modes). */
+export const CONFIGURE_RUN_KEY = "run";
+
 /** Configure command options. */
 export function configureBuiltinOptions(root: CliProgram): CliOption[] {
   const caps = resolveCapabilities(root);
@@ -57,14 +69,33 @@ export function configureBuiltinOptions(root: CliProgram): CliOption[] {
   return opts;
 }
 
-/** Builds the `configure` built-in command. */
-export function cliBuiltinConfigureCommand(root: CliProgram): CliLeaf {
+/** True when argv resolved to `configure get` or `configure set`. */
+export function isConfigureConfigPath(path: string[]): boolean {
+  return path.length >= 2 && (path[1] === "get" || path[1] === "set");
+}
+
+/** Builds the `configure` built-in router. */
+export function cliBuiltinConfigureCommand(root: CliProgram): CliRouter {
   const caps = resolveCapabilities(root);
+  const run: CliLeaf = {
+    key: CONFIGURE_RUN_KEY,
+    hidden: true,
+    description: "Interactive or flag-driven configure (skills, MCP, app config).",
+    handler: () => {},
+  };
+
+  const commands: CliLeaf[] = [run];
+  if (configCommandsEnabled(root)) {
+    commands.push(...configureConfigSubcommands(root, configMcpSetEnabled(root)));
+  }
+
   return {
     key: "configure",
     description: configureCommandDescription(root, caps),
     options: configureBuiltinOptions(root),
     notes: configureCommandNotes(root, caps),
-    handler: () => {},
+    fallbackCommand: CONFIGURE_RUN_KEY,
+    fallbackMode: CliFallbackMode.MissingOnly,
+    commands,
   };
 }

package/src/builtins/dispatch.ts

@@ -11,8 +11,11 @@ import { completionBashScript } from "./completion-bash.ts";
 import { completionFishScript } from "./completion-fish.ts";
 import { cliBuiltinCompletionGroup as completionGroup } from "./completion-group.ts";
 import { completionZshScript } from "./completion-zsh.ts";
-import { cliBuiltinConfigGroupIfEnabled } from "./config.ts";
-import { cliBuiltinConfigureCommand } from "./configure.ts";
+import {
+  CONFIGURE_RUN_KEY,
+  cliBuiltinConfigureCommand,
+  isConfigureConfigPath,
+} from "./configure.ts";
 import { cliBuiltinMcpCommand } from "./mcp.ts";
 import { cliPresentationRoot } from "./presentation.ts";
 import { cliBuiltinVersionCommand } from "./version.ts";
@@ -101,7 +104,11 @@ export async function dispatchBuiltin(
       process.stderr.write(capabilityDeniedMessage("configure"));
       process.exit(1);
     }
-    if (pr.path.length !== 1) {
+    if (isConfigureConfigPath(pr.path)) {
+      return;
+    }
+    const runSeg = pr.path[1];
+    if (pr.path.length > 2 || (pr.path.length === 2 && runSeg !== CONFIGURE_RUN_KEY)) {
       process.stderr.write(`Unknown subcommand: configure ${pr.path.slice(1).join(" ")}\n`);
       process.exit(1);
     }
@@ -177,17 +184,5 @@ export function builtinInterceptRoot(
     };
   }
 
-  const configGroup = cliBuiltinConfigGroupIfEnabled(program);
-  if (first === "config" && configGroup) {
-    return {
-      parseRoot: {
-        key: program.key,
-        description: program.description,
-        commands: [configGroup],
-      },
-      isLeafCompletionIntercept: false,
-    };
-  }
-
   return { parseRoot: program, isLeafCompletionIntercept: false };
 }

package/src/builtins/registry.ts

@@ -2,7 +2,6 @@ import type { CliCapabilities } from "../capabilities.ts";
 import { cliBuiltinDocsGroupIfEnabled } from "../docs/builtin.ts";
 import type { CliNode, CliProgram } from "../types.ts";
 import { cliBuiltinCompletionGroup } from "./completion-group.ts";
-import { cliBuiltinConfigGroupIfEnabled } from "./config.ts";
 import { cliBuiltinConfigureCommand } from "./configure.ts";
 import { cliBuiltinMcpCommand } from "./mcp.ts";
 import { cliBuiltinVersionCommand } from "./version.ts";
@@ -37,6 +36,5 @@ export function resolveBuiltins(program: CliProgram, caps: CliCapabilities): Cli
   if (caps.mcp) {
     pushBuiltin(builtins, program, (p) => cliBuiltinMcpCommand(p));
   }
-  pushBuiltin(builtins, program, (p) => cliBuiltinConfigGroupIfEnabled(p) ?? null);
   return builtins;
 }

package/src/capabilities.ts

@@ -42,17 +42,17 @@ export function reservedCommandNames(caps: CliCapabilities): string[] {
   if (caps.mcp) {
     names.push("mcp");
   }
-  if (caps.configCommands) {
-    names.push("config");
-  }
   return names;
 }
 
 /** Commands that may run without required appConfig values (read-only / config introspection). */
 export function skipsRequiredAppConfigExit(path: string[], caps: CliCapabilities): boolean {
   const root = path[0];
-  if (root === "config" && caps.configCommands) {
-    return true;
+  if (root === "configure" && caps.configCommands) {
+    const sub = path[1];
+    if (sub === "get" || sub === "set") {
+      return true;
+    }
   }
   if (root === "docs" && caps.docs) {
     return true;
@@ -60,7 +60,7 @@ export function skipsRequiredAppConfigExit(path: string[], caps: CliCapabilities
   return false;
 }
 
-export type CapabilityFeature = "mcp" | "configure" | "docs" | "config" | "completion";
+export type CapabilityFeature = "mcp" | "configure" | "docs" | "completion";
 
 /** Stderr message when a disabled built-in is invoked from the CLI. */
 export function capabilityDeniedMessage(feature: CapabilityFeature): string {
@@ -73,8 +73,6 @@ export function capabilityDeniedMessage(feature: CapabilityFeature): string {
       return "Configure is not available for this app.\n";
     case "docs":
       return "Documentation commands are not available for this app.\n";
-    case "config":
-      return "Configuration commands are not available for this app.\n";
   }
 }
 
@@ -100,8 +98,4 @@ export function assertBuiltinAllowed(argv: string[], caps: CliCapabilities): voi
     process.stderr.write(capabilityDeniedMessage("docs"));
     process.exit(1);
   }
-  if (first === "config" && !caps.configCommands) {
-    process.stderr.write(capabilityDeniedMessage("config"));
-    process.exit(1);
-  }
 }

package/src/cli-tool/cli-smoke.test.ts

@@ -10,14 +10,12 @@ const main = join(import.meta.dir, "main.ts");
 
 /** Tests for argsbarg cli-tool. */
 describe("argsbarg cli-tool", () => {
-  /** Tests that version subcommand prints version. */
   test("version subcommand prints version", () => {
     const proc = spawnSync("bun", [main, "version"], { encoding: "utf8" });
     expect(proc.status).toBe(0);
     expect(proc.stdout.trim().length).toBeGreaterThan(0);
   });
 
-  /** Tests that help lists create and version only (no install, completion, mcp). */
   test("help lists create and version only (no install, completion, mcp)", () => {
     const proc = spawnSync("bun", [main, "--help"], { encoding: "utf8" });
     expect(proc.status).toBe(0);
@@ -28,7 +26,6 @@ describe("argsbarg cli-tool", () => {
     expect(proc.stdout).not.toContain("mcp");
   });
 
-  /** Completion subcommand is disabled. */
   test("completion subcommand is disabled", () => {
     const proc = spawnSync("bun", [main, "completion", "bash"], { encoding: "utf8" });
     expect(proc.status).toBe(1);

package/src/cli-tool/create.test.ts

@@ -44,7 +44,6 @@ describe("argsbarg create", () => {
     expect(out).not.toContain("{key}");
   });
 
-  /** Tests that classNameFromKey. */
   test("classNameFromKey", () => {
     expect(classNameFromKey("sqsp-i18n")).toBe("SqspI18n");
     expect(classNameFromKey("at1")).toBe("At1");
@@ -67,7 +66,6 @@ describe("argsbarg create", () => {
     expect(opts.desc).toBe("At1 CLI");
   });
 
-  /** ResolveCreateOptions requires release repo. */
   test("resolveCreateOptions requires release repo", () => {
     expect(() => resolveCreateOptions({ key: "at1" })).toThrow(/release repo/i);
   });
@@ -146,7 +144,6 @@ describe("argsbarg create", () => {
     }
   });
 
-  /** Tests that --diff captures drift details. */
   test("--diff captures drift details", () => {
     const drifts = diffCreateDetails("/nonexistent", { key: "x", releaseRepo: "org/x" });
     expect(drifts.length).toBeGreaterThan(0);