argsbarg 6.3.1 → 6.3.2

package/CHANGELOG.md

@@ -7,6 +7,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [6.3.2] - 2026-08-07
+
+
 ## [6.3.1] - 2026-08-07
 
 
@@ -24,7 +27,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 
 - **Breaking: `configure --sync` → `configure --refresh`** — renames the non-interactive agent-artifact refresh flag (skills, MCP, config bootstrap). No `--sync` alias. Copy-template justfiles no longer ship a `refresh-artifacts` recipe; run `configure --refresh --yes` directly.
-- **Copy-template justfiles** — `install-local` uses `brew reinstall || brew install --force`; uninstall/untap recipes prefix `NONINTERACTIVE=1` so agents and CI skip Homebrew confirm prompts (including post-uninstall untap). `install-production` unchanged.
+- **Copy-template justfiles** — `install-local` depends on `uninstall` then `build` (`brew reinstall || brew install --force`). Dropped `uninstall-artifacts`, `uninstall-formula`, `uninstall-release`, and `uninstall-release-tap` (use `uninstall` + `uninstall-config`). Brew recipes prefix `HOMEBREW_NO_ASK=1`.
 
 ## [6.2.2] - 2026-08-07
 
@@ -922,7 +925,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/v6.3.1...HEAD
+[Unreleased]: https://github.com/bdombro/bun-argsbarg/compare/v6.3.2...HEAD
+[6.3.2]: https://github.com/bdombro/bun-argsbarg/releases/tag/v6.3.2
 [6.3.1]: https://github.com/bdombro/bun-argsbarg/releases/tag/v6.3.1
 [6.3.0]: https://github.com/bdombro/bun-argsbarg/releases/tag/v6.3.0
 [6.2.2]: https://github.com/bdombro/bun-argsbarg/releases/tag/v6.2.2

package/docs/configure.md

@@ -32,10 +32,10 @@ To remove app config only (keep skills/MCP), run `configure --remove-config --ye
 
 ```bash
 just build
-just install-local    # same formula as production; temporary file:// URL during brew install (`just install` is an alias)
+just install-local    # uninstall, then build + brew install (`just install` is an alias)
 ```
 
-Dev flow matches release: formula `install` copies the binary and generates completions; `post_install` runs `<key> configure --refresh --yes` for skills/MCP. Use `just reinstall-local` to swap the binary into Cellar during tight edit cycles (skips completions and `post_install`). Run `<key> configure --refresh --yes` (or `just run configure --refresh --yes`) to refresh agent artifacts without touching the binary.
+Dev flow matches release: `install-local` runs `uninstall` first (keg + untap; formula hook runs `configure --remove-all`), then stages the dev formula and installs. `post_install` runs `<key> configure --refresh --yes` for skills/MCP. Use `just reinstall-local` to swap the binary into Cellar during tight edit cycles (skips completions and `post_install`). Run `<key> configure --refresh --yes` (or `just run configure --refresh --yes`) to refresh agent artifacts without touching the binary.
 
 ## Quick reference
 

package/docs/distribution-homebrew.md

@@ -116,7 +116,7 @@ ArgsBarg provides an optimized workflow for developers to build, package, and te
 # 1. Build the local release binary
 just build
 
-# 2. Stage and install the formula locally (bypasses GitHub, uses file://)
+# 2. Uninstall any existing formula/tap, stage and install locally (bypasses GitHub, uses file://)
 just install-local
 
 # 3. Swap updated binaries quickly during tight edit cycles
@@ -130,9 +130,10 @@ just uninstall
 
 To ensure you test the exact formula that will be shipped to production, `just install-local` runs:
 
-1.  `bun scripts/dev-formula.ts install` — Safely backs up your production formula and writes a temporary local dev formula using a `file://` URL pointing to your build directory.
-2.  `brew install --formula <tap>/{key}` — Installs the package locally using Homebrew.
-3.  `bun scripts/dev-formula.ts reset` — Automatically restores your production formula on disk.
+1.  `just uninstall` — Remove any existing keg and untap (formula `uninstall` hook runs `configure --remove-all`).
+2.  `bun scripts/dev-formula.ts install` — Safely backs up your production formula and writes a temporary local dev formula using a `file://` URL pointing to your build directory.
+3.  `brew reinstall || brew install --force` — Installs the package locally using Homebrew.
+4.  `bun scripts/dev-formula.ts reset` — Automatically restores your production formula on disk.
 
 ---
 

package/examples/full-example/justfile

@@ -67,12 +67,11 @@ http:
 install: install-local
 
 # Dev install: build, stage dev formula, brew install, restore release formula
-install-local: build
-    @NONINTERACTIVE=1 brew untap {{tap}} 2>/dev/null || true
+install-local: uninstall build
     mkdir -p {{tap_parent}}
     ln -sfn '{{justfile_directory()}}' {{tap_path}}
     bun scripts/dev-formula.ts install
-    NONINTERACTIVE=1 brew reinstall --formula {{tap}}/{{cli_key}} || NONINTERACTIVE=1 brew install --force --formula {{tap}}/{{cli_key}}
+    HOMEBREW_NO_ASK=1 brew reinstall --formula {{tap}}/{{cli_key}} || HOMEBREW_NO_ASK=1 brew install --force --formula {{tap}}/{{cli_key}}
     bun scripts/dev-formula.ts reset
     @echo ""
     @echo "Next: {{cli_key}} configure"
@@ -117,10 +116,10 @@ release *ARGS:
 
 # Install release formula from tap and run formula test
 test-release:
-    NONINTERACTIVE=1 brew untap {{tap}} 2>/dev/null || true
+    HOMEBREW_NO_ASK=1 brew untap {{tap}} 2>/dev/null || true
     mkdir -p {{tap_parent}}
     ln -sfn '{{justfile_directory()}}' {{tap_path}}
-    NONINTERACTIVE=1 brew uninstall --formula {{tap}}/{{cli_key}} 2>/dev/null || true
+    HOMEBREW_NO_ASK=1 brew uninstall --formula {{tap}}/{{cli_key}} 2>/dev/null || true
     brew install --formula {{tap}}/{{cli_key}}
     brew test {{cli_key}}
 
@@ -128,28 +127,12 @@ test-release:
 typecheck:
     bun run tsc --noEmit
 
-# Undo just install-local: agent artifacts first, then formula
-uninstall: uninstall-artifacts uninstall-formula
-
-# Remove agent artifacts only (skills, MCP)
-uninstall-artifacts:
-    just run configure --remove-all --yes
+# Undo dev/Homebrew install (formula uninstall hook runs configure --remove-all)
+uninstall:
+    @HOMEBREW_NO_ASK=1 brew uninstall --formula {{tap}}/{{cli_key}} 2>/dev/null || true
+    @HOMEBREW_NO_ASK=1 brew uninstall --formula {{tap}}/{{cli_key}}-local 2>/dev/null || true
+    @HOMEBREW_NO_ASK=1 brew untap {{tap}} 2>/dev/null || true
 
 # Remove app config file only
 uninstall-config:
     just run configure --remove-config --yes
-
-# Remove formula and untap
-uninstall-formula:
-    @NONINTERACTIVE=1 brew uninstall --formula {{tap}}/{{cli_key}} 2>/dev/null || true
-    @NONINTERACTIVE=1 brew uninstall --formula {{tap}}/{{cli_key}}-local 2>/dev/null || true
-    @NONINTERACTIVE=1 brew untap {{tap}} 2>/dev/null || true
-
-# Remove release formula (does not untap)
-uninstall-release:
-    @NONINTERACTIVE=1 brew uninstall --formula {{tap}}/{{cli_key}} 2>/dev/null || true
-
-# Remove release formula and untap
-uninstall-release-tap:
-    @NONINTERACTIVE=1 brew uninstall --formula {{tap}}/{{cli_key}} 2>/dev/null || true
-    @NONINTERACTIVE=1 brew untap {{tap}} 2>/dev/null || true

package/examples/full-example-json/justfile

@@ -77,12 +77,11 @@ http:
 install: install-local
 
 # Dev install: build, stage dev formula, brew install, restore release formula
-install-local: build
-    @NONINTERACTIVE=1 brew untap {{tap}} 2>/dev/null || true
+install-local: uninstall build
     mkdir -p {{tap_parent}}
     ln -sfn '{{justfile_directory()}}' {{tap_path}}
     bun scripts/dev-formula.ts install
-    NONINTERACTIVE=1 brew reinstall --formula {{tap}}/{{cli_key}} || NONINTERACTIVE=1 brew install --force --formula {{tap}}/{{cli_key}}
+    HOMEBREW_NO_ASK=1 brew reinstall --formula {{tap}}/{{cli_key}} || HOMEBREW_NO_ASK=1 brew install --force --formula {{tap}}/{{cli_key}}
     bun scripts/dev-formula.ts reset
     @echo ""
     @echo "Next: {{cli_key}} configure"
@@ -129,10 +128,10 @@ release *ARGS:
 
 # Install release formula from tap and run formula test
 test-release:
-    NONINTERACTIVE=1 brew untap {{tap}} 2>/dev/null || true
+    HOMEBREW_NO_ASK=1 brew untap {{tap}} 2>/dev/null || true
     mkdir -p {{tap_parent}}
     ln -sfn '{{justfile_directory()}}' {{tap_path}}
-    NONINTERACTIVE=1 brew uninstall --formula {{tap}}/{{cli_key}} 2>/dev/null || true
+    HOMEBREW_NO_ASK=1 brew uninstall --formula {{tap}}/{{cli_key}} 2>/dev/null || true
     brew install --formula {{tap}}/{{cli_key}}
     brew test {{cli_key}}
 
@@ -140,28 +139,12 @@ test-release:
 typecheck:
     bun run tsc --noEmit
 
-# Undo just install-local: agent artifacts first, then formula
-uninstall: uninstall-artifacts uninstall-formula
-
-# Remove agent artifacts only (skills, MCP)
-uninstall-artifacts:
-    just run configure --remove-all --yes
+# Undo dev/Homebrew install (formula uninstall hook runs configure --remove-all)
+uninstall:
+    @HOMEBREW_NO_ASK=1 brew uninstall --formula {{tap}}/{{cli_key}} 2>/dev/null || true
+    @HOMEBREW_NO_ASK=1 brew uninstall --formula {{tap}}/{{cli_key}}-local 2>/dev/null || true
+    @HOMEBREW_NO_ASK=1 brew untap {{tap}} 2>/dev/null || true
 
 # Remove app config file only
 uninstall-config:
     just run configure --remove-config --yes
-
-# Remove formula and untap
-uninstall-formula:
-    @NONINTERACTIVE=1 brew uninstall --formula {{tap}}/{{cli_key}} 2>/dev/null || true
-    @NONINTERACTIVE=1 brew uninstall --formula {{tap}}/{{cli_key}}-local 2>/dev/null || true
-    @NONINTERACTIVE=1 brew untap {{tap}} 2>/dev/null || true
-
-# Remove release formula (does not untap)
-uninstall-release:
-    @NONINTERACTIVE=1 brew uninstall --formula {{tap}}/{{cli_key}} 2>/dev/null || true
-
-# Remove release formula and untap
-uninstall-release-tap:
-    @NONINTERACTIVE=1 brew uninstall --formula {{tap}}/{{cli_key}} 2>/dev/null || true
-    @NONINTERACTIVE=1 brew untap {{tap}} 2>/dev/null || true

package/package.json

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