argsbarg 6.1.2 → 6.1.3

package/examples/formats.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
 /*
- * Value formats demo: duration, comma-list, date, default, and readLeafInputs().
+ * Value formats demo: duration, comma-list, date, default, and ctx.inputs.
  * Run: bun ./examples/formats.ts run --tags alpha,beta --on 2026-06-22
  * MCP: pass comma-list as string or array; varargs N/A on this leaf.
  */
@@ -12,19 +12,19 @@ import {
   CliOptionKind,
   type CliProgram,
   CliValueFormat,
-} from "../src/index.ts";
+} from "../src/index";
 
 const program = {
   key: "formats.ts",
   version: pkg.version,
-  description: "Value formats and readLeafInputs demo.",
+  description: "Value formats and ctx.inputs demo.",
   fallbackCommand: "run",
   fallbackMode: CliFallbackMode.MissingOnly,
   mcpServer: { enabled: true },
   commands: [
     {
       key: "run",
-      description: "Print coerced option values from readLeafInputs().",
+      description: "Print coerced option values from ctx.inputs.",
       options: [
         {
           name: "timeout",
@@ -53,9 +53,9 @@ const program = {
         },
       ],
       handler: (ctx) => {
-        const inputs = ctx.readLeafInputs();
+        const inputs = ctx.inputs;
         const out = {
-          readLeafInputs: inputs,
+          inputs,
           durationMs: ctx.durationOpt("timeout"),
           tags: ctx.commaListOpt("tags"),
           on: ctx.dateOpt("on"),

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

@@ -0,0 +1,35 @@
+class FullExample < Formula
+  desc "Argsbarg full example reference app"
+  homepage "https://github.com/bdombro/bun-argsbarg"
+  version "1.0.0"
+  sha256 "d6dbe3233152d2f51feca068b23e6fd133940232fb4bb7c3f08c2d1024c10c30"
+
+  def install
+    bin.install "full-example"
+    chmod 0755, bin/"full-example"
+    generate_completions_from_executable(bin/"full-example", "completion", base_name: "full-example")
+  end
+
+  def post_install
+    system bin/"full-example", "configure", "--sync", "--yes"
+  end
+
+  def uninstall
+    system bin/"full-example", "configure", "--remove-all", "--yes"
+  end
+
+  def caveats
+    <<~EOS
+      Run `full-example configure` to set up agent artifacts and app config (interactive).
+      Restart MCP chat apps (Cursor, Claude Desktop, etc.) after install or upgrade so they load the updated server.
+    EOS
+  end
+
+  test do
+    assert_match version.to_s, shell_output("#{bin}/full-example version")
+    assert_predicate bash_completion/"full-example", :exist?
+    assert_predicate zsh_completion/"_full-example", :exist?
+    assert_predicate fish_completion/"full-example.fish", :exist?
+  end
+url "file:///Users/briandombrowski/dev/bdombro/bun-argsbarg/examples/full-example/Formula/.staging/full-example"
+end

package/examples/full-example/README.md

@@ -1,6 +1,16 @@
 # full-example
 
-Argsbarg full example reference app
+Argsbarg copy template / reference app (not a kitchen-sink product).
+
+## What's in this app
+
+- **Builtins enabled:** CLI, shell completion, `docs`, MCP, HTTP API, `configure` (wizard available; no default `appConfig` in the template)
+- **Commands:**
+  - `echo` — simple flags/positionals
+  - `render-json` — `kind: "json"` leaf, schemagen `inputSchema`, `ctx.inputsAs`
+  - `status` — schemagen `outputSchema`, `--json`
+  - `workspaces` — REST CRUD, `:id` param routers, verb leaves, schemagen input schemas
+- **Tooling:** `@sg` schemagen, `just docgen`, Homebrew/just dev workflow
 
 ## Quick start
 
@@ -9,13 +19,11 @@ From a git checkout at this directory (requires [Homebrew](https://brew.sh), [ju
 ```bash
 brew install just bun
 just setup
-just schemagen   # after changing src/**/types.ts
+just schemagen   # after changing @sg types in src/
 just run status --json
 just run docs readme
 ```
 
-Run `full-example configure` when the app needs secrets or other app config (interactive wizard).
-
 ## Install
 
 Requires [Homebrew](https://brew.sh).
@@ -34,7 +42,6 @@ Install:
 ```bash
 brew tap bdombro/bun-argsbarg git@github.com:bdombro/bun-argsbarg.git
 brew install bdombro/bun-argsbarg/full-example
-full-example configure
 ```
 
 Upgrade:
@@ -58,17 +65,17 @@ just install-production   # remote tap install (requires gh auth login)
 just test-release
 ```
 
-Undo a local dev install: `just uninstall` (formula + agent artifacts; app config removed by formula `uninstall`), `just uninstall-config` (app config only, without uninstalling the formula).
+Undo a local dev install: `just uninstall` (formula + agent artifacts), `just uninstall-config` (app config only, without uninstalling the formula).
 
-## Schemagen roots
+## Schemagen (`@sg`)
 
-| Export in `types.ts` | Generated artifact | Import on leaf / program |
-| --- | --- | --- |
-| `export type configType = …` | `config/__generated__/configSchema.json` | `{ configSchema }` from `config/__generated__/index.ts` |
-| `export type outputType = …` | `__generated__/outputSchema.json` | `{ outputSchema }` from `__generated__/index.ts` |
-| `export type inputType = …` | `__generated__/inputSchema.json` | `{ inputSchema }` from `__generated__/index.ts` |
+Mark schema-facing types with `/** @sg */` immediately above the declaration (no blank line). Run `argsbarg schemagen` (via `just schemagen` or `just setup`).
 
-Type definitions and schemagen role exports live in `types.ts`. Run `argsbarg schemagen` (via `just schemagen` or `just setup`).
+| Type | Generated artifact | Import |
+| --- | --- | --- |
+| `RenderJsonInput` | `RenderJsonInputSchema.json` | `RenderJsonInputSchema` from `./__generated__` |
+| `StatusJsonOutput` | `StatusJsonOutputSchema.json` | `StatusJsonOutputSchema` from `./__generated__` |
+| `WorkspaceNameInput` | `WorkspaceNameInputSchema.json` | `WorkspaceNameInputSchema` from `./__generated__` |
 
 ## Consumer docs
 
@@ -77,11 +84,3 @@ Regenerate committed reference docs under `docs/` (see [docs/README.md](docs/REA
 ```bash
 just docgen
 ```
-
-## Environment
-
-Optional overrides for `program.appConfig` (the configure wizard is the usual path):
-
-| Variable | Purpose |
-| --- | --- |
-| `FULL_EXAMPLE_API_TOKEN` | Overrides `apiToken` when set in the shell |

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

@@ -8,7 +8,7 @@ Reference template for argsbarg consumer docgen. Every builtin is enabled in `sr
 | **Authoring argsbarg schema** | `node_modules/argsbarg/docs/cli-program.md` — see `.cursor/rules/cli-program.mdc` |
 | **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)** | [api.md](api.md) — generated |
+| **Full command tree (markdown)** | [cli.md](cli.md) — generated |
 | **Full command tree (JSON)** | [cli-schema.json](cli-schema.json) — generated |
 | **OpenAPI 3.1** | [openapi.json](openapi.json) — generated |
 | **Agent skill index** | [skill.md](skill.md) — generated |