argsbarg 7.0.8 → 7.0.10

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

@@ -30,7 +30,7 @@ Echo a message (MCP-friendly leaf).
 #### Subcommands
 
 - `version` — Print the program version.
-- `configure` — Set up agent skills and MCP config for this app (binary via Homebrew).
+- `configure` — Set up MCP config for this app (binary via Homebrew).
 - `docs` — Print bundled CLI documentation.
 - `mcp` — MCP server and bundle tools.
 - `http` — HTTP API server for tools.
@@ -41,7 +41,7 @@ Print the program version.
 
 #### `full-example-json echo configure`
 
-Set up agent skills and MCP config for this app (binary via Homebrew).
+Set up MCP config for this app (binary via Homebrew).
 
 > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
 > 
@@ -116,7 +116,6 @@ 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 install` to install an optimized copy.
 
 ##### `full-example-json echo docs readme`
 
@@ -178,16 +177,6 @@ Print the full command reference as markdown.
 | --- | --- | --- | --- | --- |
 | `--save` | flag | optional | — | Write documentation to ./docs/. |
 
-##### `full-example-json echo docs skill`
-
-Print a reference agent SKILL; run `configure install` to install an optimized copy.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
 #### `full-example-json echo mcp`
 
 MCP server and bundle tools.
@@ -258,7 +247,7 @@ Echo a JSON message (schema-first JSON leaf demo).
 #### Subcommands
 
 - `version` — Print the program version.
-- `configure` — Set up agent skills and MCP config for this app (binary via Homebrew).
+- `configure` — Set up MCP config for this app (binary via Homebrew).
 - `docs` — Print bundled CLI documentation.
 - `mcp` — MCP server and bundle tools.
 - `http` — HTTP API server for tools.
@@ -269,7 +258,7 @@ Print the program version.
 
 #### `full-example-json render-json configure`
 
-Set up agent skills and MCP config for this app (binary via Homebrew).
+Set up MCP config for this app (binary via Homebrew).
 
 > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
 > 
@@ -344,7 +333,6 @@ 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 install` to install an optimized copy.
 
 ##### `full-example-json render-json docs readme`
 
@@ -406,16 +394,6 @@ Print the full command reference as markdown.
 | --- | --- | --- | --- | --- |
 | `--save` | flag | optional | — | Write documentation to ./docs/. |
 
-##### `full-example-json render-json docs skill`
-
-Print a reference agent SKILL; run `configure install` to install an optimized copy.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
 #### `full-example-json render-json mcp`
 
 MCP server and bundle tools.
@@ -514,7 +492,7 @@ JSON Schema for output when/if handler emits JSON
 #### Subcommands
 
 - `version` — Print the program version.
-- `configure` — Set up agent skills and MCP config for this app (binary via Homebrew).
+- `configure` — Set up MCP config for this app (binary via Homebrew).
 - `docs` — Print bundled CLI documentation.
 - `mcp` — MCP server and bundle tools.
 - `http` — HTTP API server for tools.
@@ -525,7 +503,7 @@ Print the program version.
 
 #### `full-example-json status configure`
 
-Set up agent skills and MCP config for this app (binary via Homebrew).
+Set up MCP config for this app (binary via Homebrew).
 
 > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
 > 
@@ -600,7 +578,6 @@ 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 install` to install an optimized copy.
 
 ##### `full-example-json status docs readme`
 
@@ -662,16 +639,6 @@ Print the full command reference as markdown.
 | --- | --- | --- | --- | --- |
 | `--save` | flag | optional | — | Write documentation to ./docs/. |
 
-##### `full-example-json status docs skill`
-
-Print a reference agent SKILL; run `configure install` to install an optimized copy.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
 #### `full-example-json status mcp`
 
 MCP server and bundle tools.
@@ -752,7 +719,7 @@ List workspaces.
 #### Subcommands
 
 - `version` — Print the program version.
-- `configure` — Set up agent skills and MCP config for this app (binary via Homebrew).
+- `configure` — Set up MCP config for this app (binary via Homebrew).
 - `docs` — Print bundled CLI documentation.
 - `mcp` — MCP server and bundle tools.
 - `http` — HTTP API server for tools.
@@ -763,7 +730,7 @@ Print the program version.
 
 ##### `full-example-json workspaces get configure`
 
-Set up agent skills and MCP config for this app (binary via Homebrew).
+Set up MCP config for this app (binary via Homebrew).
 
 > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
 > 
@@ -838,7 +805,6 @@ 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 install` to install an optimized copy.
 
 ###### `full-example-json workspaces get docs readme`
 
@@ -900,16 +866,6 @@ Print the full command reference as markdown.
 | --- | --- | --- | --- | --- |
 | `--save` | flag | optional | — | Write documentation to ./docs/. |
 
-###### `full-example-json workspaces get docs skill`
-
-Print a reference agent SKILL; run `configure install` to install an optimized copy.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
 ##### `full-example-json workspaces get mcp`
 
 MCP server and bundle tools.
@@ -980,7 +936,7 @@ Create a workspace.
 #### Subcommands
 
 - `version` — Print the program version.
-- `configure` — Set up agent skills and MCP config for this app (binary via Homebrew).
+- `configure` — Set up MCP config for this app (binary via Homebrew).
 - `docs` — Print bundled CLI documentation.
 - `mcp` — MCP server and bundle tools.
 - `http` — HTTP API server for tools.
@@ -991,7 +947,7 @@ Print the program version.
 
 ##### `full-example-json workspaces post configure`
 
-Set up agent skills and MCP config for this app (binary via Homebrew).
+Set up MCP config for this app (binary via Homebrew).
 
 > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
 > 
@@ -1066,7 +1022,6 @@ 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 install` to install an optimized copy.
 
 ###### `full-example-json workspaces post docs readme`
 
@@ -1128,16 +1083,6 @@ Print the full command reference as markdown.
 | --- | --- | --- | --- | --- |
 | `--save` | flag | optional | — | Write documentation to ./docs/. |
 
-###### `full-example-json workspaces post docs skill`
-
-Print a reference agent SKILL; run `configure install` to install an optimized copy.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
 ##### `full-example-json workspaces post mcp`
 
 MCP server and bundle tools.
@@ -1219,7 +1164,7 @@ Get one workspace.
 #### Subcommands
 
 - `version` — Print the program version.
-- `configure` — Set up agent skills and MCP config for this app (binary via Homebrew).
+- `configure` — Set up MCP config for this app (binary via Homebrew).
 - `docs` — Print bundled CLI documentation.
 - `mcp` — MCP server and bundle tools.
 - `http` — HTTP API server for tools.
@@ -1230,7 +1175,7 @@ Print the program version.
 
 ###### `full-example-json workspaces :id get configure`
 
-Set up agent skills and MCP config for this app (binary via Homebrew).
+Set up MCP config for this app (binary via Homebrew).
 
 > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
 > 
@@ -1305,7 +1250,6 @@ 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 install` to install an optimized copy.
 
 ###### `full-example-json workspaces :id get docs readme`
 
@@ -1367,16 +1311,6 @@ Print the full command reference as markdown.
 | --- | --- | --- | --- | --- |
 | `--save` | flag | optional | — | Write documentation to ./docs/. |
 
-###### `full-example-json workspaces :id get docs skill`
-
-Print a reference agent SKILL; run `configure install` to install an optimized copy.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
 ###### `full-example-json workspaces :id get mcp`
 
 MCP server and bundle tools.
@@ -1447,7 +1381,7 @@ Replace a workspace.
 #### Subcommands
 
 - `version` — Print the program version.
-- `configure` — Set up agent skills and MCP config for this app (binary via Homebrew).
+- `configure` — Set up MCP config for this app (binary via Homebrew).
 - `docs` — Print bundled CLI documentation.
 - `mcp` — MCP server and bundle tools.
 - `http` — HTTP API server for tools.
@@ -1458,7 +1392,7 @@ Print the program version.
 
 ###### `full-example-json workspaces :id put configure`
 
-Set up agent skills and MCP config for this app (binary via Homebrew).
+Set up MCP config for this app (binary via Homebrew).
 
 > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
 > 
@@ -1533,7 +1467,6 @@ 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 install` to install an optimized copy.
 
 ###### `full-example-json workspaces :id put docs readme`
 
@@ -1595,16 +1528,6 @@ Print the full command reference as markdown.
 | --- | --- | --- | --- | --- |
 | `--save` | flag | optional | — | Write documentation to ./docs/. |
 
-###### `full-example-json workspaces :id put docs skill`
-
-Print a reference agent SKILL; run `configure install` to install an optimized copy.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
 ###### `full-example-json workspaces :id put mcp`
 
 MCP server and bundle tools.
@@ -1675,7 +1598,7 @@ Patch a workspace name.
 #### Subcommands
 
 - `version` — Print the program version.
-- `configure` — Set up agent skills and MCP config for this app (binary via Homebrew).
+- `configure` — Set up MCP config for this app (binary via Homebrew).
 - `docs` — Print bundled CLI documentation.
 - `mcp` — MCP server and bundle tools.
 - `http` — HTTP API server for tools.
@@ -1686,7 +1609,7 @@ Print the program version.
 
 ###### `full-example-json workspaces :id patch configure`
 
-Set up agent skills and MCP config for this app (binary via Homebrew).
+Set up MCP config for this app (binary via Homebrew).
 
 > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
 > 
@@ -1761,7 +1684,6 @@ 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 install` to install an optimized copy.
 
 ###### `full-example-json workspaces :id patch docs readme`
 
@@ -1823,16 +1745,6 @@ Print the full command reference as markdown.
 | --- | --- | --- | --- | --- |
 | `--save` | flag | optional | — | Write documentation to ./docs/. |
 
-###### `full-example-json workspaces :id patch docs skill`
-
-Print a reference agent SKILL; run `configure install` to install an optimized copy.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
 ###### `full-example-json workspaces :id patch mcp`
 
 MCP server and bundle tools.
@@ -1903,7 +1815,7 @@ Delete a workspace.
 #### Subcommands
 
 - `version` — Print the program version.
-- `configure` — Set up agent skills and MCP config for this app (binary via Homebrew).
+- `configure` — Set up MCP config for this app (binary via Homebrew).
 - `docs` — Print bundled CLI documentation.
 - `mcp` — MCP server and bundle tools.
 - `http` — HTTP API server for tools.
@@ -1914,7 +1826,7 @@ Print the program version.
 
 ###### `full-example-json workspaces :id delete configure`
 
-Set up agent skills and MCP config for this app (binary via Homebrew).
+Set up MCP config for this app (binary via Homebrew).
 
 > Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).
 > 
@@ -1989,7 +1901,6 @@ 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 install` to install an optimized copy.
 
 ###### `full-example-json workspaces :id delete docs readme`
 
@@ -2051,16 +1962,6 @@ Print the full command reference as markdown.
 | --- | --- | --- | --- | --- |
 | `--save` | flag | optional | — | Write documentation to ./docs/. |
 
-###### `full-example-json workspaces :id delete docs skill`
-
-Print a reference agent SKILL; run `configure install` to install an optimized copy.
-
-#### Options
-
-| Option | Type | Required | Format / default | Description |
-| --- | --- | --- | --- | --- |
-| `--save` | flag | optional | — | Write documentation to ./docs/. |
-
 ###### `full-example-json workspaces :id delete mcp`
 
 MCP server and bundle tools.

package/examples/full-example-json/docs/openapi.json

@@ -352,6 +352,7 @@
                     "description": "Text to print."
                   }
                 },
+                "additionalProperties": false,
                 "required": [
                   "message"
                 ]
@@ -583,7 +584,8 @@
             "application/json; charset=utf-8": {
               "schema": {
                 "type": "object",
-                "properties": {}
+                "properties": {},
+                "additionalProperties": false
               }
             }
           }

package/index.d.ts

@@ -618,15 +618,16 @@ export interface CliNodeBase {
 	/** Global or command-level flags/options. */
 	options?: CliOption[];
 }
-/** Leaf input mode: `json` = pure JSON body (no CLI flags). */
-export type CliLeafKind = "json";
+/** Leaf input mode: `document` (or legacy `json`) = structured JSON or YAML document body (no CLI flags). */
+export type CliLeafKind = "document" | "json";
 /**
  * A leaf command node with a handler and optional positionals.
  */
 export type CliLeaf = CliNodeBase & {
 	/**
-	 * When `"json"`, the leaf accepts a single JSON document (CLI positional or piped stdin;
-	 * MCP/HTTP tool args = body). Requires `inputSchema`; forbids `options` and `positionals`.
+	 * When `"document"` (or legacy `"json"`), the leaf accepts a single JSON or YAML document
+	 * (CLI positional or piped stdin; MCP/HTTP tool args = body). Requires `inputSchema`;
+	 * forbids `options` and `positionals`.
 	 */
 	kind?: CliLeafKind;
 	/** Handler function for leaf commands. */
@@ -814,8 +815,14 @@ export type CliProgram = CliNode & {
 	/** Program version (printed by the `version` built-in and MCP serverInfo). */
 	version: string;
 };
-/** True when the leaf accepts a pure JSON body (no CLI flags). */
-export declare function isJsonLeaf(leaf: CliLeaf): boolean;
+/** True when the leaf accepts a structured JSON or YAML document body (no CLI flags). */
+export declare function isDocumentLeaf(
+/** Leaf command node to inspect. */
+leaf: CliLeaf): boolean;
+/** True when the leaf accepts a structured document body (backward-compatible alias for `isDocumentLeaf`). */
+export declare function isJsonLeaf(
+/** Leaf command node to inspect. */
+leaf: CliLeaf): boolean;
 /**
  * Handler closure type for leaf commands.
  * Supports sync and async handlers; non-undefined return values become implicit JSON responses for headless invocations.
@@ -844,6 +851,12 @@ export declare function parseDateTime(s: string): string;
 export declare class LeafInputError extends Error {
 	constructor(message: string);
 }
+/** Parses a JSON or YAML string from a command argument or document body. */
+export declare function parseDocumentText(
+/** Raw text containing a JSON or YAML document. */
+raw: string, 
+/** Field or argument label for error reporting. */
+label: string): unknown;
 /** Resolves a Json option from argv, preloaded stdin, or toolArgs (flag wins). */
 export declare function readJsonOptionValue(ctx: CliContext, name: string): unknown | undefined;
 /**
@@ -851,6 +864,21 @@ export declare function readJsonOptionValue(ctx: CliContext, name: string): unkn
  * Call from {@link Cli.run} before constructing the handler context.
  */
 export declare function preloadPipableJson(program: CliProgram, commandPath: string[], opts: Record<string, string>, invocation: CliInvocation, args?: string[]): Promise<Record<string, unknown>>;
+/**
+ * Filters leaf-local options to only those exposed over wire protocols (MCP, OpenAPI, CLI schema export).
+ * Omits hidden options and framework-handled presence flags (`--json`, `--yes`, `--verbose`).
+ */
+export declare function leafWireOptions(
+/** Leaf command node to extract wire options from. */
+leaf: CliLeaf): CliOption[];
+/**
+ * Builds the canonical input JSON Schema for a leaf command.
+ * Returns `leaf.inputSchema` when explicitly defined (e.g. on document leaves or schemagen leaves);
+ * otherwise synthesizes a flat object schema from leaf-local wire options and positionals.
+ */
+export declare function buildLeafInputSchema(
+/** Leaf command node to build the input schema for. */
+leaf: CliLeaf): Record<string, unknown>;
 /** Minimal context for headless routing helpers. */
 export type HeadlessContext = Pick<CliContext, "invocation">;
 /** True when `--json` was passed or the handler was invoked headlessly over MCP/HTTP. */
@@ -920,6 +948,8 @@ export interface CliSchemaExport {
 	key: string;
 	description: string;
 	notes?: string;
+	/** JSON Schema for input arguments (options, positionals, or document body) when on a leaf. */
+	inputSchema?: Record<string, unknown>;
 	/** JSON Schema for structured stdout when set on the leaf. */
 	outputSchema?: Record<string, unknown>;
 	/** Default success Content-Type when `outputSchema` is omitted but `http.successContentType` is set. */

package/package.json

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

package/src/builtins/export.ts

@@ -9,6 +9,8 @@ export interface CliSchemaExport {
   key: string;
   description: string;
   notes?: string;
+  /** JSON Schema for input arguments (options, positionals, or document body) when on a leaf. */
+  inputSchema?: Record<string, unknown>;
   /** JSON Schema for structured stdout when set on the leaf. */
   outputSchema?: Record<string, unknown>;
   /** Default success Content-Type when `outputSchema` is omitted but `http.successContentType` is set. */