argsbarg 6.2.0 → 6.3.0

package/examples/full-example/AGENTS.md

@@ -0,0 +1,75 @@
+# full-example
+
+## Tooling
+
+- Bun only (`bun`, `bunx`, `bun test`). No Node/npm/pnpm.
+
+## Documentation
+
+- `README.md` — user-facing install/commands
+- `docs/architecture.md` — maintainer internals (create if missing)
+- Generated: `just docgen` → `docs/cli.md`, `docs/cli-schema.json`, `docs/skill.md`
+
+<!-- argsbarg:managed -->
+
+## Argsbarg schema
+
+When adding or changing argsbarg schema, leaf handlers, or MCP exposure:
+
+1. **Read** `node_modules/argsbarg/docs/cli-program.md` (required — authoritative guide).
+2. MCP tools, varargs → `node_modules/argsbarg/docs/mcp.md`.
+3. JSON stdout / `outputSchema` and `@sg` schemagen → `node_modules/argsbarg/docs/output-schema.md` and `examples/full-example-json/`.
+4. App config / `program.appConfig` → `node_modules/argsbarg/docs/config-schema.md`.
+5. `configure`, Homebrew distribution → `node_modules/argsbarg/docs/configure.md` and `distribution-homebrew.md`.
+6. Bundled `docs` built-in → `node_modules/argsbarg/docs/bundled-docs.md`.
+7. **Examples** (shipped under `node_modules/argsbarg/examples/`):
+   - **CLI copy template** (this repo) — builtins only, no schemagen
+   - **Schema-first copy template** — `@sg`, `inputSchema`/`outputSchema`, REST CRUD → `examples/full-example-json/`
+
+**Hard rules** (details and examples are in the docs above — do not contradict them):
+
+- Reserved root commands: `completion`, `configure`, `mcp`, `version`, `docs`.
+- `satisfies CliProgram` / `CliLeaf`; action-oriented `description` on root, commands, options, and positionals.
+- Omit `mcpTool` unless genuinely CLI-only (`enabled: false`) or an irreducible wire limit — fix schema and headless handlers first.
+- Interactive leaves: one headless path for MCP, non-TTY CLI, and `--yes` / `--dry-run` / `--json` (`shouldRunHeadless*`, `requireYesInNonTty`); not raw `isTTY`.
+- String options: `format` / `default` / `pattern` per `cli-program.md`.
+- Varargs (`argMax: 0`): CLI space-separated; MCP JSON array only — no comma-splitting positionals.
+
+## Code conventions
+
+### JSDoc
+
+Add doc comments for exported surfaces that are not obvious from the name alone. Skip comments on short test callbacks and pure re-export files.
+
+### Names
+
+Use names that describe the domain role, not generic placeholders like `data` or `handler`, except in very small scopes.
+
+### Structure
+
+After imports, put **exported** symbols first (alphabetical within each kind), then **module-private** helpers at the bottom. Use `~/…` only where you would otherwise use `../` (or deeper) to reach another module under `src/`. Same-directory (`./`) and child (`./foo/…`) imports stay relative. Use `.ts` extensions.
+
+### Module boundaries
+
+| Path | Owns | Must not |
+| --- | --- | --- |
+| `src/index.ts` | Thin entry: `new Cli(program).run()` | Inline leaf handlers, business logic |
+| `src/types/` | Global type declarations (e.g. `md.d.ts`) | Runtime logic |
+| `src/program.ts` | `CliProgram` assembly: `docs`, `commands: […]` | Inline leaf handlers, business logic |
+| `src/commands/<name>/` | One user-facing command: `command.ts` | Shared helpers unrelated to the command |
+| `scripts/` | Dev tooling (formula helpers) | Production command paths |
+
+When adding commands: `src/commands/<name>/command.ts`; register in `program.ts` **alphabetically by command key**.
+
+**Argsbarg schema:** see Argsbarg schema section above.
+
+### Execution
+
+- **CLI:** `bun ./src/index.ts …` or `just run …`
+- **Tests:** `just test` (after `just check`)
+
+<!-- /argsbarg:managed -->
+
+**full-example conventions:**
+
+Replace with app-specific bullets.

package/examples/full-example/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

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

@@ -11,7 +11,7 @@ class FullExample < Formula
   end
 
   def post_install
-    system bin/"full-example", "configure", "--sync", "--yes"
+    system bin/"full-example", "configure", "--refresh", "--yes"
   end
 
   def uninstall

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

@@ -5,7 +5,7 @@ Reference template for argsbarg consumer docgen. Every builtin is enabled in `sr
 | If you are… | Read |
 | --- | --- |
 | **Using the CLI** | [../README.md](../README.md) |
-| **Authoring argsbarg schema** | `node_modules/argsbarg/docs/cli-program.md` — see `.cursor/rules/cli-program.mdc` |
+| **Authoring argsbarg schema** | `node_modules/argsbarg/docs/cli-program.md` — see [`AGENTS.md`](../AGENTS.md) |
 | **HTTP API / curl** | [http.md](http.md) — generated; or run `full-example docs http` |
 | **MCP tools** | [mcp.md](mcp.md) — generated; or run `full-example docs mcp` |
 | **Full command tree (markdown)** | [cli.md](cli.md) — generated |

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

@@ -21,10 +21,10 @@
         {
           "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 --sync --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.",
+          "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": [
             {
-              "name": "sync",
+              "name": "refresh",
               "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
               "kind": "presence"
             },
@@ -40,7 +40,7 @@
             },
             {
               "name": "yes",
-              "description": "Skip confirmation (required for --sync, --remove-all, --remove-config).",
+              "description": "Skip confirmation (required for --refresh, --remove-all, --remove-config).",
               "kind": "presence",
               "shortName": "y"
             },
@@ -261,10 +261,10 @@
         {
           "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 --sync --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.",
+          "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": [
             {
-              "name": "sync",
+              "name": "refresh",
               "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
               "kind": "presence"
             },
@@ -280,7 +280,7 @@
             },
             {
               "name": "yes",
-              "description": "Skip confirmation (required for --sync, --remove-all, --remove-config).",
+              "description": "Skip confirmation (required for --refresh, --remove-all, --remove-config).",
               "kind": "presence",
               "shortName": "y"
             },

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

@@ -44,7 +44,7 @@ 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 --sync --yes
+>   full-example configure --refresh --yes
 > 
 > Interactive setup (per target):
 >   full-example configure
@@ -72,10 +72,10 @@ Set up agent skills and MCP config for this app (binary via Homebrew).
 
 | Option | Type | Required | Format / default | Description |
 | --- | --- | --- | --- | --- |
-| `--sync` | flag | optional | — | Refresh installed skills and MCP. Used by Homebrew post_install. |
+| `--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 --sync, --remove-all, --remove-config). |
+| `--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. |
 
@@ -263,7 +263,7 @@ 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 --sync --yes
+>   full-example configure --refresh --yes
 > 
 > Interactive setup (per target):
 >   full-example configure
@@ -291,10 +291,10 @@ Set up agent skills and MCP config for this app (binary via Homebrew).
 
 | Option | Type | Required | Format / default | Description |
 | --- | --- | --- | --- | --- |
-| `--sync` | flag | optional | — | Refresh installed skills and MCP. Used by Homebrew post_install. |
+| `--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 --sync, --remove-all, --remove-config). |
+| `--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. |
 

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 --sync` merges this server into `~/.agents/mcp.json` per the [.agents protocol](https://dotagentsprotocol.com/).
+When `mcpServer.enabled` is set, `configure --refresh` 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 --sync --yes
+full-example configure --refresh --yes
 ```
 
 Writes or updates `~/.agents/mcp.json` with a `mcpServers` entry for this app.

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

@@ -34,9 +34,9 @@ For full detail, open `reference.md` in this skill directory (same as `full-exam
 
 ## Install location
 
-Install follows the [.agents protocol](https://dotagentsprotocol.com/):
+Install follows the https://dotagentsprotocol.com:
 
-- Auto-install: `full-example configure --sync --yes` when `skill.enabled` → `~/.agents/skills/full-example/`
+- Auto-install: `full-example configure --refresh --yes` 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

@@ -67,16 +67,16 @@ http:
 install: install-local
 
 # Refresh skills and MCP without reinstalling the formula
-sync-artifacts:
-    just run configure --sync --yes
+refresh-artifacts:
+    just run configure --refresh --yes
 
 # Dev install: build, stage dev formula, brew install, restore release formula
 install-local: build
-    @brew untap {{tap}} 2>/dev/null || true
+    @NONINTERACTIVE=1 brew untap {{tap}} 2>/dev/null || true
     mkdir -p {{tap_parent}}
     ln -sfn '{{justfile_directory()}}' {{tap_path}}
     bun scripts/dev-formula.ts install
-    brew install --formula {{tap}}/{{cli_key}}
+    brew install --force --formula {{tap}}/{{cli_key}}
     bun scripts/dev-formula.ts reset
     @echo ""
     @echo "Next: {{cli_key}} configure"
@@ -121,10 +121,10 @@ release *ARGS:
 
 # Install release formula from tap and run formula test
 test-release:
-    brew untap {{tap}} 2>/dev/null || true
+    NONINTERACTIVE=1 brew untap {{tap}} 2>/dev/null || true
     mkdir -p {{tap_parent}}
     ln -sfn '{{justfile_directory()}}' {{tap_path}}
-    brew uninstall --formula {{tap}}/{{cli_key}} 2>/dev/null || true
+    NONINTERACTIVE=1 brew uninstall --formula {{tap}}/{{cli_key}} 2>/dev/null || true
     brew install --formula {{tap}}/{{cli_key}}
     brew test {{cli_key}}
 
@@ -145,15 +145,15 @@ uninstall-config:
 
 # Remove formula and untap
 uninstall-formula:
-    @brew uninstall --formula {{tap}}/{{cli_key}} 2>/dev/null || true
-    @brew uninstall --formula {{tap}}/{{cli_key}}-local 2>/dev/null || true
-    @brew untap {{tap}} 2>/dev/null || true
+    @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:
-    @brew uninstall --formula {{tap}}/{{cli_key}} 2>/dev/null || true
+    @NONINTERACTIVE=1 brew uninstall --formula {{tap}}/{{cli_key}} 2>/dev/null || true
 
 # Remove release formula and untap
 uninstall-release-tap:
-    @brew uninstall --formula {{tap}}/{{cli_key}} 2>/dev/null || true
-    @brew untap {{tap}} 2>/dev/null || true
+    @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/scripts/formula-shared.ts

@@ -20,7 +20,7 @@ export const formulaInstallRuby = `def install
   end`;
 
 export const formulaPostInstallRuby = `def post_install
-    system bin/"${key}", "configure", "--sync", "--yes"
+    system bin/"${key}", "configure", "--refresh", "--yes"
   end`;
 
 export const formulaUninstallRuby = `def uninstall

package/examples/full-example-json/.cursor/hooks/run-tests-on-stop.ts

@@ -0,0 +1,56 @@
+#!/usr/bin/env bun
+/* Cursor stop hook: run `just test` on agent completion; follow up if it fails. */
+
+try {
+  const empty = () => {
+    console.log("{}");
+    process.exit(0);
+  };
+
+  const input = JSON.parse(await Bun.stdin.text()) as {
+    status?: string;
+    loop_count?: number;
+    workspace_roots?: string[];
+  };
+
+  if (input.status !== "completed") empty();
+
+  const cwd = input.workspace_roots?.[0] ?? process.cwd();
+  if (!(await Bun.file(`${cwd}/justfile`).exists())) empty();
+
+  const diff = Bun.spawnSync(["git", "diff", "--name-only", "HEAD"], { cwd, stdout: "pipe" });
+  const CODE_FILE = /\.(t|j)sx?$/i;
+  const SKIP_PREFIX = /^(node_modules|dist|\.cursor)\//;
+  const changed = new TextDecoder()
+    .decode(diff.stdout)
+    .split("\n")
+    .some(
+      (path) =>
+        path &&
+        (path === "justfile" || (CODE_FILE.test(path) && !SKIP_PREFIX.test(path))),
+    );
+  if (!changed) empty();
+
+  const proc = Bun.spawnSync(["just", "test"], {
+    cwd,
+    env: { ...process.env, FORCE_COLOR: "0" },
+    stderr: "pipe",
+    stdout: "pipe",
+  });
+  const output =
+    new TextDecoder().decode(proc.stdout) + new TextDecoder().decode(proc.stderr);
+
+  if (proc.exitCode === 0) empty();
+
+  const lines = output.trimEnd().split("\n");
+  const tail = lines.length > 80 ? lines.slice(-80).join("\n") : output.trimEnd();
+  const n = (input.loop_count ?? 0) + 1;
+
+  console.log(
+    JSON.stringify({
+      followup_message: `Tests failed (auto-retry ${n}/20). Fix and ensure \`just test\` passes.\n\n\`\`\`\n${tail}\n\`\`\``,
+    }),
+  );
+} catch {
+  console.log("{}");
+}

package/examples/full-example-json/.cursor/hooks.json

@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "hooks": {
+    "stop": [
+      {
+        "command": "bun .cursor/hooks/run-tests-on-stop.ts",
+        "loop_limit": 20,
+        "timeout": 180
+      }
+    ]
+  }
+}

package/examples/full-example-json/AGENTS.md

@@ -0,0 +1,86 @@
+# full-example-json
+
+## Tooling
+
+- Bun only (`bun`, `bunx`, `bun test`). No Node/npm/pnpm.
+
+## Documentation
+
+- `README.md` — user-facing install/commands
+- `docs/architecture.md` — maintainer internals (create if missing)
+- Generated: `just docgen` → `docs/cli.md`, `docs/cli-schema.json`, `docs/skill.md`
+
+<!-- argsbarg:managed -->
+
+## Argsbarg schema
+
+When adding or changing argsbarg schema, leaf handlers, or MCP exposure:
+
+1. **Read** `node_modules/argsbarg/docs/cli-program.md` (required — authoritative guide).
+2. MCP tools, varargs, `inputSchema` → also `node_modules/argsbarg/docs/mcp.md`.
+3. JSON stdout / `outputSchema` guide and codegen → `node_modules/argsbarg/docs/output-schema.md`.
+4. App config / `program.appConfig` guide and codegen → `node_modules/argsbarg/docs/config-schema.md`.
+5. `configure`, `configure.targets`, Homebrew distribution → `node_modules/argsbarg/docs/configure.md` and `distribution-homebrew.md`.
+6. Bundled `docs` built-in → `node_modules/argsbarg/docs/bundled-docs.md`.
+7. **Examples** (shipped under `node_modules/argsbarg/examples/`):
+   - **Copy template** (all builtins, `@sg` schemagen, Homebrew justfile, `outputSchema`) → `examples/full-example/`
+
+**Hard rules** (details and examples are in the docs above — do not contradict them):
+
+- Reserved root commands: `completion`, `configure`, `mcp`, `version`, `docs`.
+- `satisfies CliProgram` / `CliLeaf`; action-oriented `description` on root, commands, options, and positionals.
+- Omit `mcpTool` unless genuinely CLI-only (`enabled: false`) or an irreducible wire limit — fix schema and headless handlers first.
+- Interactive leaves: one headless path for MCP, non-TTY CLI, and `--yes` / `--dry-run` / `--json` (`shouldRunHeadless*`, `requireYesInNonTty`); not raw `isTTY`.
+- String options: `format` / `default` / `pattern` per `cli-program.md`; `readLeafInputs()` for multi-flag leaves.
+- Varargs (`argMax: 0`): CLI space-separated; MCP JSON array only — no comma-splitting positionals.
+- Multi-surface leaves (Ink + headless + MCP): one **`read*Flags(ctx)`** per command (or shared family helper + extensions); one **`resolve*Input(flags)`** for cross-field rules — handler reads ctx once, all paths share the struct.
+- JSON stdout: `import { StatusJsonOutputSchema } from "./__generated__"` — declare `/** @sg */` on the type in `types.ts`; handlers import types from the same module.
+- App config (optional): `import { AppConfigSchema } from "./config/__generated__"` — `/** @sg */` on `AppConfig` in `src/config/types.ts`.
+
+## Code conventions
+
+### JSDoc
+
+Add doc comments for exported surfaces that are not obvious from the name alone: JSON output schemas, public types, and non-trivial algorithms. Skip comments on short test callbacks and pure re-export files.
+
+### Names
+
+Use names that describe the domain role, not generic placeholders like `data` or `handler`, except in very small scopes.
+
+### Structure
+
+After imports, put **exported** symbols first (alphabetical within each kind), then **module-private** helpers at the bottom. Use `~/…` only where you would otherwise use `../` (or deeper) to reach another module under `src/`. Same-directory (`./`) and child (`./foo/…`) imports stay relative. Use `.ts` extensions.
+
+### Module boundaries
+
+| Path | Owns | Must not |
+| --- | --- | --- |
+| `src/index.ts` | Thin entry: `new Cli(program).run()` | Inline leaf handlers, business logic |
+| `src/types/` | Global type declarations and module augmentations (e.g. `argsbarg.d.ts`, `md.d.ts`) | Runtime logic, imports from outside `types/` |
+| `src/program.ts` | `CliProgram` assembly: `docs`, `commands: […]` | Inline leaf handlers, business logic |
+| `src/db/` | `AppDb` (SQLite connect, migrate, domain access), `migrate.ts`, `migrations/*.sql` | Command handlers |
+| `src/commands/<name>/` | One user-facing command: `command.ts`, optional `types.ts` with `/** @sg */` | Shared helpers (lift to `src/db/`) |
+| `src/**/__generated__/` | Generated JSON Schema + `index.ts` re-exports | Hand-edited generated files |
+| `scripts/` | Dev tooling (formula helpers) | Production command paths |
+
+When adding commands: `src/commands/<name>/command.ts` + `types.ts` when schemas are needed; register in `program.ts` **alphabetically by command key**.
+
+**Argsbarg schema:** see Argsbarg schema section above.
+
+### Execution
+
+- **Runtime:** Bun (`just test`, `just dev`).
+- **Tests:** colocate `*.test.ts` next to the module.
+- **Schemagen:** after changing `/** @sg */` types in `src/`, run `just schemagen` (`__generated__/` is gitignored).
+
+### Abstractions
+
+Avoid needless extraction: keep single-use helpers in the calling file by default. Split only when reused elsewhere, the caller is large or hard to follow, or extraction clarifies a substantial unit. Do not create tiny one-off helpers.
+- ❌ `utils/formatX.ts` — 60-line helper used by one command
+- ✅ inline helper in that command file
+
+<!-- /argsbarg:managed -->
+
+**full-example-json conventions:**
+
+Replace with app-specific bullets.

package/examples/full-example-json/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

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

@@ -11,7 +11,7 @@ class FullExampleJson < Formula
   end
 
   def post_install
-    system bin/"full-example-json", "configure", "--sync", "--yes"
+    system bin/"full-example-json", "configure", "--refresh", "--yes"
   end
 
   def uninstall

package/examples/full-example-json/docs/README.md

@@ -5,7 +5,7 @@ Reference template for argsbarg consumer docgen. Every builtin is enabled in `sr
 | If you are… | Read |
 | --- | --- |
 | **Using the CLI** | [../README.md](../README.md) |
-| **Authoring argsbarg schema** | `node_modules/argsbarg/docs/cli-program.md` — see `.cursor/rules/cli-program.mdc` |
+| **Authoring argsbarg schema** | `node_modules/argsbarg/docs/cli-program.md` — see [`AGENTS.md`](../AGENTS.md) |
 | **HTTP API / curl** | [http.md](http.md) — generated; or run `full-example docs http` |
 | **MCP tools** | [mcp.md](mcp.md) — generated; or run `full-example docs mcp` |
 | **Full command tree (markdown)** | [cli.md](cli.md) — generated |