argsbarg 7.1.2 → 7.1.4

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

@@ -180,7 +180,7 @@
           "commands": [
             {
               "key": "bundle",
-              "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>."
+              "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>."
             }
           ]
         },
@@ -411,7 +411,282 @@
           "commands": [
             {
               "key": "bundle",
-              "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>."
+              "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>."
+            }
+          ]
+        },
+        {
+          "key": "http",
+          "description": "HTTP API server for tools.",
+          "notes": "HTTP tool server on http://127.0.0.1:3000.\n\nEndpoints: GET /health/liveness, GET /health/readiness, GET /openapi.json, GET /swagger, /*\n\nConfigure app settings:\n\n  full-example-json configure\n\nFull setup guide: full-example-json docs http",
+          "options": [
+            {
+              "name": "host",
+              "description": "Listen host.",
+              "kind": "string"
+            },
+            {
+              "name": "port",
+              "description": "Listen port.",
+              "kind": "number"
+            },
+            {
+              "name": "trust-proxy",
+              "description": "Honor X-Forwarded-For for client IP.",
+              "kind": "presence"
+            },
+            {
+              "name": "obscure-errors",
+              "description": "Hide unexpected errors from clients.",
+              "kind": "presence"
+            },
+            {
+              "name": "log-format",
+              "description": "Log format: json (ECS Logging) or text.",
+              "kind": "enum",
+              "choices": [
+                "json",
+                "text"
+              ]
+            },
+            {
+              "name": "log-file",
+              "description": "Append logs to this file (relative → app config dir).",
+              "kind": "string"
+            },
+            {
+              "name": "no-access-log",
+              "description": "Disable HTTP access logs.",
+              "kind": "presence"
+            },
+            {
+              "name": "dev",
+              "description": "Print full stacks to stderr on errors.",
+              "kind": "presence"
+            }
+          ],
+          "fallbackCommand": "serve",
+          "fallbackMode": "missingOnly"
+        }
+      ]
+    },
+    {
+      "key": "shape-area",
+      "description": "Compute the area of a circle or rectangle (union-input JSON leaf demo).",
+      "inputSchema": {
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "anyOf": [
+          {
+            "$ref": "#/definitions/Circle"
+          },
+          {
+            "$ref": "#/definitions/Rect"
+          }
+        ],
+        "description": "Shape to measure: a circle or a rectangle.",
+        "definitions": {
+          "Circle": {
+            "type": "object",
+            "properties": {
+              "kind": {
+                "type": "string",
+                "const": "circle",
+                "description": "Shape discriminator."
+              },
+              "radius": {
+                "type": "number",
+                "description": "Circle radius."
+              }
+            },
+            "required": [
+              "kind",
+              "radius"
+            ],
+            "additionalProperties": false,
+            "description": "A circle, measured by radius."
+          },
+          "Rect": {
+            "type": "object",
+            "properties": {
+              "kind": {
+                "type": "string",
+                "const": "rect",
+                "description": "Shape discriminator."
+              },
+              "width": {
+                "type": "number",
+                "description": "Rectangle width."
+              },
+              "height": {
+                "type": "number",
+                "description": "Rectangle height."
+              }
+            },
+            "required": [
+              "kind",
+              "width",
+              "height"
+            ],
+            "additionalProperties": false,
+            "description": "A rectangle, measured by width and height."
+          }
+        }
+      },
+      "commands": [
+        {
+          "key": "version",
+          "description": "Print the program version."
+        },
+        {
+          "key": "configure",
+          "description": "Set up 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 installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n  full-example-json configure install\n\nUpgrade:\n  brew upgrade full-example-json\n  full-example-json configure install\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-json configure status\n\nUninstall:\n  full-example-json configure uninstall\n  brew uninstall <tap>/full-example-json\n\nUse `configure status --json` for machine-readable output.",
+          "commands": [
+            {
+              "key": "install",
+              "description": "Install agent artifacts and bootstrap app config."
+            },
+            {
+              "key": "uninstall",
+              "description": "Remove agent artifacts and app config.",
+              "options": [
+                {
+                  "name": "yes",
+                  "description": "Skip uninstall confirmation.",
+                  "kind": "presence",
+                  "shortName": "y"
+                }
+              ]
+            },
+            {
+              "key": "status",
+              "description": "Print what is currently installed (read-only).",
+              "options": [
+                {
+                  "name": "json",
+                  "description": "Print status JSON on stdout.",
+                  "kind": "presence"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "key": "docs",
+          "description": "Print bundled CLI documentation.",
+          "notes": "Topics print to stdout. Add --save to write files under ./docs/.",
+          "options": [
+            {
+              "name": "save",
+              "description": "Write documentation to ./docs/.",
+              "kind": "presence"
+            }
+          ],
+          "commands": [
+            {
+              "key": "readme",
+              "description": "Print README (user guide).",
+              "options": [
+                {
+                  "name": "save",
+                  "description": "Write documentation to ./docs/.",
+                  "kind": "presence"
+                }
+              ]
+            },
+            {
+              "key": "mcp",
+              "description": "Print MCP server setup and tool guidance.",
+              "options": [
+                {
+                  "name": "save",
+                  "description": "Write documentation to ./docs/.",
+                  "kind": "presence"
+                }
+              ]
+            },
+            {
+              "key": "http",
+              "description": "Print HTTP API setup and tool guidance.",
+              "options": [
+                {
+                  "name": "save",
+                  "description": "Write documentation to ./docs/.",
+                  "kind": "presence"
+                }
+              ]
+            },
+            {
+              "key": "openapi",
+              "description": "Print the HTTP OpenAPI 3.1 document as JSON.",
+              "options": [
+                {
+                  "name": "save",
+                  "description": "Write documentation to ./docs/.",
+                  "kind": "presence"
+                }
+              ]
+            },
+            {
+              "key": "cli-schema",
+              "description": "Print the full CLI command tree as JSON.",
+              "options": [
+                {
+                  "name": "save",
+                  "description": "Write documentation to ./docs/.",
+                  "kind": "presence"
+                }
+              ]
+            },
+            {
+              "key": "cli",
+              "description": "Print the full command reference as markdown.",
+              "options": [
+                {
+                  "name": "save",
+                  "description": "Write documentation to ./docs/.",
+                  "kind": "presence"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "key": "mcp",
+          "description": "MCP server and bundle tools.",
+          "notes": "Stdio MCP server. Add to Cursor, Claude Code, or Claude Desktop:\n\n  command: full-example-json\n  args: mcp\n\nOr:\n\n  full-example-json configure\n\nFull setup guide: full-example-json docs mcp",
+          "options": [
+            {
+              "name": "obscure-errors",
+              "description": "Hide unexpected errors from clients.",
+              "kind": "presence"
+            },
+            {
+              "name": "log-format",
+              "description": "Log format: json (ECS Logging) or text.",
+              "kind": "enum",
+              "choices": [
+                "json",
+                "text"
+              ]
+            },
+            {
+              "name": "log-file",
+              "description": "Append logs to this file (relative → app config dir).",
+              "kind": "string"
+            },
+            {
+              "name": "dev",
+              "description": "Print full stacks to stderr on errors.",
+              "kind": "presence"
+            }
+          ],
+          "fallbackCommand": "serve",
+          "fallbackMode": "missingOnly",
+          "commands": [
+            {
+              "key": "bundle",
+              "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>."
             }
           ]
         },
@@ -654,7 +929,7 @@
           "commands": [
             {
               "key": "bundle",
-              "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>."
+              "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>."
             }
           ]
         },
@@ -879,7 +1154,7 @@
               "commands": [
                 {
                   "key": "bundle",
-                  "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>."
+                  "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>."
                 }
               ]
             },
@@ -1110,7 +1385,7 @@
               "commands": [
                 {
                   "key": "bundle",
-                  "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>."
+                  "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>."
                 }
               ]
             },
@@ -1335,7 +1610,7 @@
                   "commands": [
                     {
                       "key": "bundle",
-                      "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>."
+                      "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>."
                     }
                   ]
                 },
@@ -1566,7 +1841,7 @@
                   "commands": [
                     {
                       "key": "bundle",
-                      "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>."
+                      "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>."
                     }
                   ]
                 },
@@ -1797,7 +2072,7 @@
                   "commands": [
                     {
                       "key": "bundle",
-                      "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>."
+                      "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>."
                     }
                   ]
                 },
@@ -2018,7 +2293,7 @@
                   "commands": [
                     {
                       "key": "bundle",
-                      "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>."
+                      "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip, Cursor plugin zip) from dist/<key>."
                     }
                   ]
                 },