argsbarg 6.3.1 → 7.0.0

package/examples/full-example/docs/cli-schema.json

@@ -21,42 +21,36 @@
         {
           "key": "configure",
           "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
-          "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew post_install runs:\n  full-example configure --refresh --yes\n\nInteractive setup (per target):\n  full-example configure\n\nUpgrade:\n  brew upgrade full-example\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n  full-example configure --status\n\nUninstall:\n  brew uninstall <tap>/full-example\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
-          "options": [
+          "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n  full-example configure install\n\nUpgrade:\n  brew upgrade full-example\n  full-example configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n  full-example configure status\n\nUninstall:\n  full-example configure uninstall\n  brew uninstall <tap>/full-example\n\nUse `configure status --json` for machine-readable output.",
+          "commands": [
             {
-              "name": "refresh",
-              "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
-              "kind": "presence"
+              "key": "install",
+              "description": "Install agent artifacts and bootstrap app config."
             },
             {
-              "name": "remove-all",
-              "description": "Remove all detected agent artifacts (skills and MCP).",
-              "kind": "presence"
+              "key": "uninstall",
+              "description": "Remove agent artifacts and app config.",
+              "options": [
+                {
+                  "name": "yes",
+                  "description": "Skip uninstall confirmation.",
+                  "kind": "presence",
+                  "shortName": "y"
+                }
+              ]
             },
             {
-              "name": "status",
+              "key": "status",
               "description": "Print what is currently installed (read-only).",
-              "kind": "presence"
-            },
-            {
-              "name": "yes",
-              "description": "Skip confirmation (required for --refresh, --remove-all, --remove-config).",
-              "kind": "presence",
-              "shortName": "y"
-            },
-            {
-              "name": "dry",
-              "description": "Show what would change without writing files.",
-              "kind": "presence"
-            },
-            {
-              "name": "json",
-              "description": "Print changed paths or status JSON on stdout.",
-              "kind": "presence"
+              "options": [
+                {
+                  "name": "json",
+                  "description": "Print status JSON on stdout.",
+                  "kind": "presence"
+                }
+              ]
             }
-          ],
-          "fallbackCommand": "run",
-          "fallbackMode": "missingOnly"
+          ]
         },
         {
           "key": "docs",
@@ -138,7 +132,7 @@
             },
             {
               "key": "skill",
-              "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
+              "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
               "options": [
                 {
                   "name": "save",
@@ -261,42 +255,36 @@
         {
           "key": "configure",
           "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
-          "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew post_install runs:\n  full-example configure --refresh --yes\n\nInteractive setup (per target):\n  full-example configure\n\nUpgrade:\n  brew upgrade full-example\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n  full-example configure --status\n\nUninstall:\n  brew uninstall <tap>/full-example\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
-          "options": [
+          "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n  full-example configure install\n\nUpgrade:\n  brew upgrade full-example\n  full-example configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n  full-example configure status\n\nUninstall:\n  full-example configure uninstall\n  brew uninstall <tap>/full-example\n\nUse `configure status --json` for machine-readable output.",
+          "commands": [
             {
-              "name": "refresh",
-              "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
-              "kind": "presence"
+              "key": "install",
+              "description": "Install agent artifacts and bootstrap app config."
             },
             {
-              "name": "remove-all",
-              "description": "Remove all detected agent artifacts (skills and MCP).",
-              "kind": "presence"
+              "key": "uninstall",
+              "description": "Remove agent artifacts and app config.",
+              "options": [
+                {
+                  "name": "yes",
+                  "description": "Skip uninstall confirmation.",
+                  "kind": "presence",
+                  "shortName": "y"
+                }
+              ]
             },
             {
-              "name": "status",
+              "key": "status",
               "description": "Print what is currently installed (read-only).",
-              "kind": "presence"
-            },
-            {
-              "name": "yes",
-              "description": "Skip confirmation (required for --refresh, --remove-all, --remove-config).",
-              "kind": "presence",
-              "shortName": "y"
-            },
-            {
-              "name": "dry",
-              "description": "Show what would change without writing files.",
-              "kind": "presence"
-            },
-            {
-              "name": "json",
-              "description": "Print changed paths or status JSON on stdout.",
-              "kind": "presence"
+              "options": [
+                {
+                  "name": "json",
+                  "description": "Print status JSON on stdout.",
+                  "kind": "presence"
+                }
+              ]
             }
-          ],
-          "fallbackCommand": "run",
-          "fallbackMode": "missingOnly"
+          ]
         },
         {
           "key": "docs",
@@ -378,7 +366,7 @@
             },
             {
               "key": "skill",
-              "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
+              "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
               "options": [
                 {
                   "name": "save",

package/examples/full-example/docs/cli.md

@@ -43,41 +43,56 @@ Set up agent skills and MCP config for this app (binary via Homebrew).
 
 > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
 > 
-> Homebrew post_install runs:
->   full-example configure --refresh --yes
+> Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
 > 
-> Interactive setup (per target):
->   full-example configure
+> After install or upgrade:
+>   full-example configure install
 > 
 > Upgrade:
 >   brew upgrade full-example
+>   full-example configure install
 > 
 > Shell completions are installed by Homebrew during brew install.
 > See: https://docs.brew.sh/Shell-Completion
 > 
 > See what is installed:
->   full-example configure --status
+>   full-example configure status
 > 
 > Uninstall:
+>   full-example configure uninstall
 >   brew uninstall <tap>/full-example
 > 
-> The formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).
-> 
-> Use --dry to preview changes without writing files.
-> Use --json for machine-readable output.
+> Use `configure status --json` for machine-readable output.
+
+#### Subcommands
+
+- `install` — Install agent artifacts and bootstrap app config.
+- `uninstall` — Remove agent artifacts and app config.
+- `status` — Print what is currently installed (read-only).
+
+##### `full-example echo configure install`
+
+Install agent artifacts and bootstrap app config.
+
+##### `full-example echo configure uninstall`
+
+Remove agent artifacts and app config.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
+
+##### `full-example echo configure status`
 
-**Default subcommand:** `run` (`missingOnly`)
+Print what is currently installed (read-only).
 
 #### Options
 
 | Option | Type | Required | Format / default | Description |
 | --- | --- | --- | --- | --- |
-| `--refresh` | flag | optional | — | Refresh installed skills and MCP. Used by Homebrew post_install. |
-| `--remove-all` | flag | optional | — | Remove all detected agent artifacts (skills and MCP). |
-| `--status` | flag | optional | — | Print what is currently installed (read-only). |
-| `--yes` (`-y`) | flag | optional | — | Skip confirmation (required for --refresh, --remove-all, --remove-config). |
-| `--dry` | flag | optional | — | Show what would change without writing files. |
-| `--json` | flag | optional | — | Print changed paths or status JSON on stdout. |
+| `--json` | flag | optional | — | Print status JSON on stdout. |
 
 #### `full-example echo docs`
 
@@ -99,7 +114,7 @@ Print bundled CLI documentation.
 - `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
 - `cli-schema` — Print the full CLI command tree as JSON.
 - `cli` — Print the full command reference as markdown.
-- `skill` — Print a reference agent SKILL; run `configure` to install an optimized copy.
+- `skill` — Print a reference agent SKILL; run `configure install` to install an optimized copy.
 
 ##### `full-example echo docs readme`
 
@@ -163,7 +178,7 @@ Print the full command reference as markdown.
 
 ##### `full-example echo docs skill`
 
-Print a reference agent SKILL; run `configure` to install an optimized copy.
+Print a reference agent SKILL; run `configure install` to install an optimized copy.
 
 #### Options
 
@@ -262,41 +277,56 @@ Set up agent skills and MCP config for this app (binary via Homebrew).
 
 > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
 > 
-> Homebrew post_install runs:
->   full-example configure --refresh --yes
+> Homebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.
 > 
-> Interactive setup (per target):
->   full-example configure
+> After install or upgrade:
+>   full-example configure install
 > 
 > Upgrade:
 >   brew upgrade full-example
+>   full-example configure install
 > 
 > Shell completions are installed by Homebrew during brew install.
 > See: https://docs.brew.sh/Shell-Completion
 > 
 > See what is installed:
->   full-example configure --status
+>   full-example configure status
 > 
 > Uninstall:
+>   full-example configure uninstall
 >   brew uninstall <tap>/full-example
 > 
-> The formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).
-> 
-> Use --dry to preview changes without writing files.
-> Use --json for machine-readable output.
+> Use `configure status --json` for machine-readable output.
+
+#### Subcommands
+
+- `install` — Install agent artifacts and bootstrap app config.
+- `uninstall` — Remove agent artifacts and app config.
+- `status` — Print what is currently installed (read-only).
+
+##### `full-example status configure install`
+
+Install agent artifacts and bootstrap app config.
+
+##### `full-example status configure uninstall`
+
+Remove agent artifacts and app config.
+
+#### Options
+
+| Option | Type | Required | Format / default | Description |
+| --- | --- | --- | --- | --- |
+| `--yes` (`-y`) | flag | optional | — | Skip uninstall confirmation. |
+
+##### `full-example status configure status`
 
-**Default subcommand:** `run` (`missingOnly`)
+Print what is currently installed (read-only).
 
 #### Options
 
 | Option | Type | Required | Format / default | Description |
 | --- | --- | --- | --- | --- |
-| `--refresh` | flag | optional | — | Refresh installed skills and MCP. Used by Homebrew post_install. |
-| `--remove-all` | flag | optional | — | Remove all detected agent artifacts (skills and MCP). |
-| `--status` | flag | optional | — | Print what is currently installed (read-only). |
-| `--yes` (`-y`) | flag | optional | — | Skip confirmation (required for --refresh, --remove-all, --remove-config). |
-| `--dry` | flag | optional | — | Show what would change without writing files. |
-| `--json` | flag | optional | — | Print changed paths or status JSON on stdout. |
+| `--json` | flag | optional | — | Print status JSON on stdout. |
 
 #### `full-example status docs`
 
@@ -318,7 +348,7 @@ Print bundled CLI documentation.
 - `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
 - `cli-schema` — Print the full CLI command tree as JSON.
 - `cli` — Print the full command reference as markdown.
-- `skill` — Print a reference agent SKILL; run `configure` to install an optimized copy.
+- `skill` — Print a reference agent SKILL; run `configure install` to install an optimized copy.
 
 ##### `full-example status docs readme`
 
@@ -382,7 +412,7 @@ Print the full command reference as markdown.
 
 ##### `full-example status docs skill`
 
-Print a reference agent SKILL; run `configure` to install an optimized copy.
+Print a reference agent SKILL; run `configure install` to install an optimized copy.
 
 #### Options
 

package/examples/full-example/docs/mcp.md

@@ -8,12 +8,12 @@ full-example exposes an MCP server with features similar to the CLI.
 
 ### `.agents` auto-install
 
-When `mcpServer.enabled` is set, `configure --refresh` merges this server into `~/.agents/mcp.json` per the https://dotagentsprotocol.com.
+When `mcpServer.enabled` is set, `configure install` merges this server into `~/.agents/mcp.json` per the https://dotagentsprotocol.com.
 
 Install the CLI first so `full-example` is on your PATH (e.g. `brew install full-example`).
 
 ```bash
-full-example configure --refresh --yes
+full-example configure install
 ```
 
 Writes or updates `~/.agents/mcp.json` with a `mcpServers` entry for this app.

package/examples/full-example/docs/skill.md

@@ -36,7 +36,7 @@ For full detail, open `reference.md` in this skill directory (same as `full-exam
 
 Install follows the https://dotagentsprotocol.com:
 
-- Auto-install: `full-example configure --refresh --yes` when `skill.enabled` → `~/.agents/skills/full-example/`
+- Auto-install: `full-example configure install` when `skill.enabled` → `~/.agents/skills/full-example/`
 - Cursor and most coding agents read `~/.agents/skills/` natively
 
 **Claude Code (manual):** symlink or copy into Claude's skill directory:

package/examples/full-example/justfile

@@ -66,31 +66,32 @@ http:
 # Alias for backward compatibility
 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
+# Dev install: build, stage dev formula, brew install, refresh agent artifacts
+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"
+    {{cli_key}} configure install
 
 # Remove local dev install, then install from GitHub tap (requires gh auth login)
 install-production: uninstall
     brew tap {{release_repo}} {{tap_git_url}}
     brew install --formula {{release_repo}}/{{cli_key}}
-    @echo ""
-    @echo "Next: {{cli_key}} configure"
+    {{cli_key}} configure install
 
 # Alias for backward compatibility
 reinstall: reinstall-local
 
-# Rebuild binary and swap into Cellar (run install-local first)
+# Rebuild binary and swap into Cellar (run install-local first; run `just refresh` for skills/MCP)
 reinstall-local: build
     install -m 755 dist/{{cli_key}} "$(brew --prefix {{cli_key}})/bin/{{cli_key}}"
 
+# Refresh agent skills/MCP without reinstalling the binary
+refresh:
+    {{cli_key}} configure install
+
 # Lint sources without writing
 lint:
     bun run biome check ./src ./scripts
@@ -106,6 +107,7 @@ schemagen:
 # Install bun/npm dependencies
 setup:
     bun install
+    test -f node_modules/argsbarg/bin/argsbarg && ln -sf ../argsbarg/bin/argsbarg node_modules/.bin/argsbarg
 
 # Run unit tests (after check)
 test: check
@@ -117,10 +119,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 +130,9 @@ 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
-
-# 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
+# Undo dev/Homebrew install (remove agent artifacts, then keg + untap)
+uninstall:
+    @{{cli_key}} configure uninstall --yes 2>/dev/null || just run configure uninstall --yes
+    @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

package/examples/full-example/scripts/formula-shared.ts

@@ -19,17 +19,15 @@ export const formulaInstallRuby = `def install
     generate_completions_from_executable(bin/"${key}", "completion", base_name: "${key}")
   end`;
 
-export const formulaPostInstallRuby = `def post_install
-    system bin/"${key}", "configure", "--refresh", "--yes"
-  end`;
-
-export const formulaUninstallRuby = `def uninstall
-    system bin/"${key}", "configure", "--remove-all", "--yes"
-  end`;
-
 export const formulaCaveatsRuby = `def caveats
     <<~EOS
-      Run \`${key} configure\` to set up agent artifacts and app config (interactive).
+      After install or upgrade:
+        ${key} configure install
+
+      Before uninstall:
+        ${key} configure uninstall
+        brew uninstall <tap>/${key}
+
       Restart MCP chat apps (Cursor, Claude Desktop, etc.) after install or upgrade so they load the updated server.
     EOS
   end`;
@@ -136,10 +134,6 @@ export function renderFormula(coords: FormulaCoords): string {
 
   ${formulaInstallRuby}
 
-  ${formulaPostInstallRuby}
-
-  ${formulaUninstallRuby}
-
   ${formulaCaveatsRuby}
 
   ${formulaTestRuby}

package/examples/full-example-json/Formula/full-example-json.rb

@@ -10,17 +10,15 @@ class FullExampleJson < Formula
     generate_completions_from_executable(bin/"full-example-json", "completion", base_name: "full-example-json")
   end
 
-  def post_install
-    system bin/"full-example-json", "configure", "--refresh", "--yes"
-  end
-
-  def uninstall
-    system bin/"full-example-json", "configure", "--remove-all", "--yes"
-  end
-
   def caveats
     <<~EOS
-      Run `full-example-json configure` to set up agent artifacts and app config (interactive).
+      After install or upgrade:
+        full-example-json configure install
+
+      Before uninstall:
+        full-example-json configure uninstall
+        brew uninstall <tap>/full-example-json
+
       Restart MCP chat apps (Cursor, Claude Desktop, etc.) after install or upgrade so they load the updated server.
     EOS
   end