argsbarg 7.0.9 → 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

@@ -864,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. */
@@ -933,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.9",
+  "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. */

package/src/core/schema.ts

@@ -6,6 +6,7 @@ import { type CliSchemaExport, exportPresentationBuiltins } from "../builtins/ex
 import { cliResolveNotes } from "../help.ts";
 import { isCliSchemaHidden, visibleOptions } from "../runtime/exposure.ts";
 import { type CliNode, type CliProgram, isCliLeaf, isCliRouter, leafOutputSchema } from "./types.ts";
+import { buildLeafInputSchema } from "./wire-schema.ts";
 
 const RESERVED = new Set(["http", "completion", "configure", "docs", "mcp", "version"]);
 
@@ -32,6 +33,7 @@ function exportCommand(cmd: CliNode, root: CliProgram): CliSchemaExport | null {
     if ((cmd.positionals ?? []).length > 0) {
       out.positionals = cmd.positionals;
     }
+    out.inputSchema = buildLeafInputSchema(cmd);
     const outputSchema = leafOutputSchema(cmd);
     if (outputSchema !== undefined) {
       out.outputSchema = outputSchema;