argsbarg 6.1.2 → 6.1.3

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

@@ -1,511 +0,0 @@
-<!-- Generated by full-example docs api --save; do not edit. -->
-
-# full-example — CLI API reference
-
-Argsbarg full example reference app
-
-Machine-readable export: `full-example docs cli-schema`
-
-## `full-example`
-
-Argsbarg full example reference app
-
-#### Subcommands
-
-- `echo` — Echo a message (MCP-friendly leaf).
-- `status` — Show resolved config and app version.
-
-### `full-example echo`
-
-Echo a message (MCP-friendly leaf).
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--message` | string | required | — | Text to print. |
-
-#### Subcommands
-
-- `version` — Print the program version.
-- `configure` — Set up agent skills, MCP config, and app config for this app (binary via Homebrew).
-- `docs` — Print bundled CLI documentation.
-- `mcp` — MCP server and bundle tools.
-- `api` — HTTP API server for tools.
-
-#### `full-example echo version`
-
-Print the program version.
-
-#### `full-example echo configure`
-
-Set up agent skills, MCP config, and app 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
-> 
-> Interactive setup (per target):
->   full-example configure
-> 
-> Upgrade:
->   brew upgrade full-example
-> 
-> Shell completions are installed by Homebrew during brew install.
-> See: https://docs.brew.sh/Shell-Completion
-> 
-> See what is installed:
->   full-example configure --status
-> 
-> Uninstall:
->   brew uninstall <tap>/full-example
-> 
-> The formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).
-> 
-> Remove app config only:
->   full-example configure --remove-config --yes
-> 
-> Use --dry to preview changes without writing files.
-> Use --json for machine-readable output.
-
-**Default subcommand:** `run` (`missingOnly`)
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--sync` | flag | optional | — | Refresh installed skills, MCP, and config. Used by Homebrew post_install. |
-| `--remove-all` | flag | optional | — | Remove all detected agent artifacts (skills and MCP). |
-| `--remove-config` | flag | optional | — | Remove the app config file only. |
-| `--status` | flag | optional | — | Print what is currently installed (read-only). |
-| `--yes` (`-y`) | flag | optional | — | Skip confirmation (required for --sync, --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. |
-
-#### Subcommands
-
-- `get` — Print resolved configuration value(s).
-- `set` — Write one configuration key to the config file.
-
-##### `full-example echo configure get`
-
-Print resolved configuration value(s).
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--json` | flag | optional | — | Emit JSON (compact). |
-| `--pretty` | flag | optional | — | Pretty-print JSON (requires --json). |
-
-##### `full-example echo configure set`
-
-Write one configuration key to the config file.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--json` | flag | optional | — | Emit JSON (compact). |
-| `--from-env` | flag | optional | — | Bind this key to its mapped environment variable (no literal value stored). |
-
-#### `full-example echo docs`
-
-Print bundled CLI documentation.
-
-> Topics print to stdout. Add --save to write files under ./docs/.
-
-**Default subcommand:** `readme` (`missingOnly`)
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
-#### Subcommands
-
-- `readme` — Print README (user guide).
-- `mcp` — Print MCP server setup and tool guidance.
-- `http` — Print HTTP API setup and tool guidance.
-- `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
-- `cli-schema` — Print the full CLI command tree as JSON.
-- `api` — Print the full command reference as markdown.
-- `skill` — Print a reference agent SKILL; run `configure` to install an optimized copy.
-
-##### `full-example echo docs readme`
-
-Print README (user guide).
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
-##### `full-example echo docs mcp`
-
-Print MCP server setup and tool guidance.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
-##### `full-example echo docs http`
-
-Print HTTP API setup and tool guidance.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
-##### `full-example echo docs openapi`
-
-Print the HTTP OpenAPI 3.1 document as JSON.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
-##### `full-example echo docs cli-schema`
-
-Print the full CLI command tree as JSON.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
-##### `full-example echo docs api`
-
-Print the full command reference as markdown.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
-##### `full-example echo docs skill`
-
-Print a reference agent SKILL; run `configure` to install an optimized copy.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
-#### `full-example echo mcp`
-
-MCP server and bundle tools.
-
-> Stdio MCP server. Add to Cursor, Claude Code, or Claude Desktop:
-> 
->   command: full-example
->   args: mcp
-> 
-> Or:
-> 
->   full-example configure
-> 
-> Full setup guide: full-example docs mcp
-
-**Default subcommand:** `serve` (`missingOnly`)
-
-#### Subcommands
-
-- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
-
-##### `full-example echo mcp bundle`
-
-Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
-
-#### `full-example echo api`
-
-HTTP API server for tools.
-
-> HTTP tool server on http://127.0.0.1:3000.
-> 
-> Endpoints: GET /health, GET /openapi.json, GET /openapi-browser, POST /tools/:name
-> 
-> Configure app settings:
-> 
->   full-example configure
-> 
-> Full setup guide: full-example docs http
-
-**Default subcommand:** `serve` (`missingOnly`)
-
-### `full-example status`
-
-Show resolved config and app version.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--json` | flag | optional | — | Emit JSON. |
-
-#### Output
-
-JSON Schema for output when/if handler emits JSON
-
-```json
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "properties": {
-    "defaultRegion": {
-      "type": "string",
-      "description": "Resolved AWS region."
-    },
-    "maxRetries": {
-      "type": "number",
-      "description": "Resolved retry count."
-    },
-    "apiTokenSet": {
-      "type": "boolean",
-      "description": "Whether apiToken is set (value never included)."
-    },
-    "version": {
-      "type": "string",
-      "description": "App version from program root."
-    }
-  },
-  "required": [
-    "apiTokenSet",
-    "version"
-  ],
-  "description": "JSON payload for `full-example status --json`.",
-  "definitions": {}
-}
-```
-
-#### Subcommands
-
-- `version` — Print the program version.
-- `configure` — Set up agent skills, MCP config, and app config for this app (binary via Homebrew).
-- `docs` — Print bundled CLI documentation.
-- `mcp` — MCP server and bundle tools.
-- `api` — HTTP API server for tools.
-
-#### `full-example status version`
-
-Print the program version.
-
-#### `full-example status configure`
-
-Set up agent skills, MCP config, and app 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
-> 
-> Interactive setup (per target):
->   full-example configure
-> 
-> Upgrade:
->   brew upgrade full-example
-> 
-> Shell completions are installed by Homebrew during brew install.
-> See: https://docs.brew.sh/Shell-Completion
-> 
-> See what is installed:
->   full-example configure --status
-> 
-> Uninstall:
->   brew uninstall <tap>/full-example
-> 
-> The formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).
-> 
-> Remove app config only:
->   full-example configure --remove-config --yes
-> 
-> Use --dry to preview changes without writing files.
-> Use --json for machine-readable output.
-
-**Default subcommand:** `run` (`missingOnly`)
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--sync` | flag | optional | — | Refresh installed skills, MCP, and config. Used by Homebrew post_install. |
-| `--remove-all` | flag | optional | — | Remove all detected agent artifacts (skills and MCP). |
-| `--remove-config` | flag | optional | — | Remove the app config file only. |
-| `--status` | flag | optional | — | Print what is currently installed (read-only). |
-| `--yes` (`-y`) | flag | optional | — | Skip confirmation (required for --sync, --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. |
-
-#### Subcommands
-
-- `get` — Print resolved configuration value(s).
-- `set` — Write one configuration key to the config file.
-
-##### `full-example status configure get`
-
-Print resolved configuration value(s).
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--json` | flag | optional | — | Emit JSON (compact). |
-| `--pretty` | flag | optional | — | Pretty-print JSON (requires --json). |
-
-##### `full-example status configure set`
-
-Write one configuration key to the config file.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--json` | flag | optional | — | Emit JSON (compact). |
-| `--from-env` | flag | optional | — | Bind this key to its mapped environment variable (no literal value stored). |
-
-#### `full-example status docs`
-
-Print bundled CLI documentation.
-
-> Topics print to stdout. Add --save to write files under ./docs/.
-
-**Default subcommand:** `readme` (`missingOnly`)
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
-#### Subcommands
-
-- `readme` — Print README (user guide).
-- `mcp` — Print MCP server setup and tool guidance.
-- `http` — Print HTTP API setup and tool guidance.
-- `openapi` — Print the HTTP OpenAPI 3.1 document as JSON.
-- `cli-schema` — Print the full CLI command tree as JSON.
-- `api` — Print the full command reference as markdown.
-- `skill` — Print a reference agent SKILL; run `configure` to install an optimized copy.
-
-##### `full-example status docs readme`
-
-Print README (user guide).
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
-##### `full-example status docs mcp`
-
-Print MCP server setup and tool guidance.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
-##### `full-example status docs http`
-
-Print HTTP API setup and tool guidance.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
-##### `full-example status docs openapi`
-
-Print the HTTP OpenAPI 3.1 document as JSON.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
-##### `full-example status docs cli-schema`
-
-Print the full CLI command tree as JSON.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
-##### `full-example status docs api`
-
-Print the full command reference as markdown.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
-##### `full-example status docs skill`
-
-Print a reference agent SKILL; run `configure` to install an optimized copy.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
-#### `full-example status mcp`
-
-MCP server and bundle tools.
-
-> Stdio MCP server. Add to Cursor, Claude Code, or Claude Desktop:
-> 
->   command: full-example
->   args: mcp
-> 
-> Or:
-> 
->   full-example configure
-> 
-> Full setup guide: full-example docs mcp
-
-**Default subcommand:** `serve` (`missingOnly`)
-
-#### Subcommands
-
-- `bundle` — Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
-
-##### `full-example status mcp bundle`
-
-Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>.
-
-#### `full-example status api`
-
-HTTP API server for tools.
-
-> HTTP tool server on http://127.0.0.1:3000.
-> 
-> Endpoints: GET /health, GET /openapi.json, GET /openapi-browser, POST /tools/:name
-> 
-> Configure app settings:
-> 
->   full-example configure
-> 
-> Full setup guide: full-example docs http
-
-**Default subcommand:** `serve` (`missingOnly`)

package/examples/full-example/src/commands/status/__generated__/outputSchema.json

@@ -1,28 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "properties": {
-    "defaultRegion": {
-      "type": "string",
-      "description": "Resolved AWS region."
-    },
-    "maxRetries": {
-      "type": "number",
-      "description": "Resolved retry count."
-    },
-    "apiTokenSet": {
-      "type": "boolean",
-      "description": "Whether apiToken is set (value never included)."
-    },
-    "version": {
-      "type": "string",
-      "description": "App version from program root."
-    }
-  },
-  "required": [
-    "apiTokenSet",
-    "version"
-  ],
-  "description": "JSON stdout for `full-example status --json`.",
-  "definitions": {}
-}

package/examples/full-example/src/config/__generated__/configSchema.json

@@ -1,40 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "properties": {
-    "apiToken": {
-      "type": "string",
-      "description": "API token from the provider dashboard."
-    },
-    "defaultRegion": {
-      "type": "string",
-      "description": "AWS region (default us-east-1).",
-      "default": "us-east-1"
-    },
-    "maxRetries": {
-      "type": "number",
-      "description": "HTTP retry count (default 3).",
-      "default": 3
-    },
-    "prefs": {
-      "type": "object",
-      "properties": {
-        "ttl": {
-          "type": "number"
-        }
-      },
-      "required": [
-        "ttl"
-      ],
-      "additionalProperties": false,
-      "description": "Local preferences (file-only; not mapped to process.env)."
-    }
-  },
-  "required": [
-    "apiToken",
-    "maxRetries"
-  ],
-  "additionalProperties": false,
-  "description": "Application settings for `full-example` (`program.appConfig`).",
-  "definitions": {}
-}

package/examples/full-example/src/config/__generated__/index.ts

@@ -1,5 +0,0 @@
-// Auto-generated by argsbarg schemagen — do not edit by hand.
-
-import configSchemaJson from "./configSchema.json";
-
-export const configSchema = configSchemaJson as Record<string, unknown>;

package/examples/full-example/src/config/types.ts

@@ -1,24 +0,0 @@
-/**
- * Application settings for `full-example` (`program.appConfig`).
- */
-export interface AppConfig {
-  /** API token from the provider dashboard. */
-  apiToken: string;
-  /**
-   * AWS region (default us-east-1).
-   * @default us-east-1
-   */
-  defaultRegion?: string;
-  /**
-   * HTTP retry count (default 3).
-   * @default 3
-   */
-  maxRetries: number;
-  /** Local preferences (file-only; not mapped to process.env). */
-  prefs?: {
-    ttl: number;
-  };
-}
-
-/** Schemagen root for program.appConfig.jsonSchema. */
-export type configType = AppConfig;