argsbarg 6.1.1 → 6.1.3

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

@@ -20,12 +20,12 @@
         },
         {
           "key": "configure",
-          "description": "Set up agent skills, MCP config, and app 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 post_install runs:\n  full-example configure --sync --yes\n\nInteractive setup (per target):\n  full-example configure\n\nUpgrade:\n  brew upgrade full-example\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 configure --status\n\nUninstall:\n  brew uninstall <tap>/full-example\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nRemove app config only:\n  full-example configure --remove-config --yes\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
+          "description": "Set up agent skills and 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 post_install runs:\n  full-example configure --sync --yes\n\nInteractive setup (per target):\n  full-example configure\n\nUpgrade:\n  brew upgrade full-example\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 configure --status\n\nUninstall:\n  brew uninstall <tap>/full-example\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
           "options": [
             {
               "name": "sync",
-              "description": "Refresh installed skills, MCP, and config. Used by Homebrew post_install.",
+              "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
               "kind": "presence"
             },
             {
@@ -33,11 +33,6 @@
               "description": "Remove all detected agent artifacts (skills and MCP).",
               "kind": "presence"
             },
-            {
-              "name": "remove-config",
-              "description": "Remove the app config file only.",
-              "kind": "presence"
-            },
             {
               "name": "status",
               "description": "Print what is currently installed (read-only).",
@@ -61,42 +56,241 @@
             }
           ],
           "fallbackCommand": "run",
-          "fallbackMode": "missingOnly",
+          "fallbackMode": "missingOnly"
+        },
+        {
+          "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": "get",
-              "description": "Print resolved configuration value(s).",
+              "key": "readme",
+              "description": "Print README (user guide).",
               "options": [
                 {
-                  "name": "json",
-                  "description": "Emit JSON (compact).",
+                  "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": "pretty",
-                  "description": "Pretty-print JSON (requires --json).",
+                  "name": "save",
+                  "description": "Write documentation to ./docs/.",
                   "kind": "presence"
                 }
               ]
             },
             {
-              "key": "set",
-              "description": "Write one configuration key to the config file.",
+              "key": "openapi",
+              "description": "Print the HTTP OpenAPI 3.1 document as JSON.",
               "options": [
                 {
-                  "name": "json",
-                  "description": "Emit JSON (compact).",
+                  "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": "skill",
+              "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
+              "options": [
                 {
-                  "name": "from-env",
-                  "description": "Bind this key to its mapped environment variable (no literal value stored).",
+                  "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\n  args: mcp\n\nOr:\n\n  full-example configure\n\nFull setup guide: full-example docs mcp",
+          "options": [
+            {
+              "name": "obscure-errors",
+              "description": "Hide unexpected errors from clients.",
+              "kind": "presence"
+            },
+            {
+              "name": "log-format",
+              "description": "Log format: json (ECS) 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) 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, GET /health/ready, GET /openapi.json, GET /openapi-browser, /api/*\n\nConfigure app settings:\n\n  full-example configure\n\nFull setup guide: full-example 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) 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": "render-json",
+      "description": "Echo a JSON message (schema-first JSON leaf demo).",
+      "commands": [
+        {
+          "key": "version",
+          "description": "Print the program version."
+        },
+        {
+          "key": "configure",
+          "description": "Set up agent skills and 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 post_install runs:\n  full-example configure --sync --yes\n\nInteractive setup (per target):\n  full-example configure\n\nUpgrade:\n  brew upgrade full-example\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 configure --status\n\nUninstall:\n  brew uninstall <tap>/full-example\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
+          "options": [
+            {
+              "name": "sync",
+              "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
+              "kind": "presence"
+            },
+            {
+              "name": "remove-all",
+              "description": "Remove all detected agent artifacts (skills and MCP).",
+              "kind": "presence"
+            },
+            {
+              "name": "status",
+              "description": "Print what is currently installed (read-only).",
+              "kind": "presence"
+            },
+            {
+              "name": "yes",
+              "description": "Skip confirmation (required for --sync, --remove-all, --remove-config).",
+              "kind": "presence",
+              "shortName": "y"
+            },
+            {
+              "name": "dry",
+              "description": "Show what would change without writing files.",
+              "kind": "presence"
+            },
+            {
+              "name": "json",
+              "description": "Print changed paths or status JSON on stdout.",
+              "kind": "presence"
+            }
+          ],
+          "fallbackCommand": "run",
+          "fallbackMode": "missingOnly"
+        },
         {
           "key": "docs",
           "description": "Print bundled CLI documentation.",
@@ -108,8 +302,6 @@
               "kind": "presence"
             }
           ],
-          "fallbackCommand": "readme",
-          "fallbackMode": "missingOnly",
           "commands": [
             {
               "key": "readme",
@@ -167,7 +359,7 @@
               ]
             },
             {
-              "key": "api",
+              "key": "cli",
               "description": "Print the full command reference as markdown.",
               "options": [
                 {
@@ -194,6 +386,32 @@
           "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\n  args: mcp\n\nOr:\n\n  full-example configure\n\nFull setup guide: full-example docs mcp",
+          "options": [
+            {
+              "name": "obscure-errors",
+              "description": "Hide unexpected errors from clients.",
+              "kind": "presence"
+            },
+            {
+              "name": "log-format",
+              "description": "Log format: json (ECS) 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": [
@@ -204,9 +422,55 @@
           ]
         },
         {
-          "key": "api",
+          "key": "http",
           "description": "HTTP API server for tools.",
-          "notes": "HTTP tool server on http://127.0.0.1:3000.\n\nEndpoints: GET /health, GET /openapi.json, GET /openapi-browser, POST /tools/:name\n\nConfigure app settings:\n\n  full-example configure\n\nFull setup guide: full-example docs http",
+          "notes": "HTTP tool server on http://127.0.0.1:3000.\n\nEndpoints: GET /health, GET /health/ready, GET /openapi.json, GET /openapi-browser, /api/*\n\nConfigure app settings:\n\n  full-example configure\n\nFull setup guide: full-example 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) 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"
         }
@@ -214,7 +478,7 @@
     },
     {
       "key": "status",
-      "description": "Show resolved config and app version.",
+      "description": "Show app version.",
       "options": [
         {
           "name": "json",
@@ -226,28 +490,15 @@
         "$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`.",
+        "additionalProperties": false,
         "definitions": {}
       },
       "commands": [
@@ -257,12 +508,12 @@
         },
         {
           "key": "configure",
-          "description": "Set up agent skills, MCP config, and app 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 post_install runs:\n  full-example configure --sync --yes\n\nInteractive setup (per target):\n  full-example configure\n\nUpgrade:\n  brew upgrade full-example\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 configure --status\n\nUninstall:\n  brew uninstall <tap>/full-example\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nRemove app config only:\n  full-example configure --remove-config --yes\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
+          "description": "Set up agent skills and 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 post_install runs:\n  full-example configure --sync --yes\n\nInteractive setup (per target):\n  full-example configure\n\nUpgrade:\n  brew upgrade full-example\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 configure --status\n\nUninstall:\n  brew uninstall <tap>/full-example\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
           "options": [
             {
               "name": "sync",
-              "description": "Refresh installed skills, MCP, and config. Used by Homebrew post_install.",
+              "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
               "kind": "presence"
             },
             {
@@ -270,11 +521,6 @@
               "description": "Remove all detected agent artifacts (skills and MCP).",
               "kind": "presence"
             },
-            {
-              "name": "remove-config",
-              "description": "Remove the app config file only.",
-              "kind": "presence"
-            },
             {
               "name": "status",
               "description": "Print what is currently installed (read-only).",
@@ -298,41 +544,7 @@
             }
           ],
           "fallbackCommand": "run",
-          "fallbackMode": "missingOnly",
-          "commands": [
-            {
-              "key": "get",
-              "description": "Print resolved configuration value(s).",
-              "options": [
-                {
-                  "name": "json",
-                  "description": "Emit JSON (compact).",
-                  "kind": "presence"
-                },
-                {
-                  "name": "pretty",
-                  "description": "Pretty-print JSON (requires --json).",
-                  "kind": "presence"
-                }
-              ]
-            },
-            {
-              "key": "set",
-              "description": "Write one configuration key to the config file.",
-              "options": [
-                {
-                  "name": "json",
-                  "description": "Emit JSON (compact).",
-                  "kind": "presence"
-                },
-                {
-                  "name": "from-env",
-                  "description": "Bind this key to its mapped environment variable (no literal value stored).",
-                  "kind": "presence"
-                }
-              ]
-            }
-          ]
+          "fallbackMode": "missingOnly"
         },
         {
           "key": "docs",
@@ -345,8 +557,6 @@
               "kind": "presence"
             }
           ],
-          "fallbackCommand": "readme",
-          "fallbackMode": "missingOnly",
           "commands": [
             {
               "key": "readme",
@@ -404,7 +614,7 @@
               ]
             },
             {
-              "key": "api",
+              "key": "cli",
               "description": "Print the full command reference as markdown.",
               "options": [
                 {
@@ -431,23 +641,1505 @@
           "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\n  args: mcp\n\nOr:\n\n  full-example configure\n\nFull setup guide: full-example docs mcp",
-          "fallbackCommand": "serve",
-          "fallbackMode": "missingOnly",
-          "commands": [
+          "options": [
             {
-              "key": "bundle",
-              "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>."
-            }
-          ]
+              "name": "obscure-errors",
+              "description": "Hide unexpected errors from clients.",
+              "kind": "presence"
+            },
+            {
+              "name": "log-format",
+              "description": "Log format: json (ECS) 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) from dist/<key>."
+            }
+          ]
         },
         {
-          "key": "api",
+          "key": "http",
           "description": "HTTP API server for tools.",
-          "notes": "HTTP tool server on http://127.0.0.1:3000.\n\nEndpoints: GET /health, GET /openapi.json, GET /openapi-browser, POST /tools/:name\n\nConfigure app settings:\n\n  full-example configure\n\nFull setup guide: full-example docs http",
+          "notes": "HTTP tool server on http://127.0.0.1:3000.\n\nEndpoints: GET /health, GET /health/ready, GET /openapi.json, GET /openapi-browser, /api/*\n\nConfigure app settings:\n\n  full-example configure\n\nFull setup guide: full-example 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) 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": "workspaces",
+      "description": "Workspace collection and CRUD.",
+      "commands": [
+        {
+          "key": "get",
+          "description": "List workspaces.",
+          "commands": [
+            {
+              "key": "version",
+              "description": "Print the program version."
+            },
+            {
+              "key": "configure",
+              "description": "Set up agent skills and 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 post_install runs:\n  full-example configure --sync --yes\n\nInteractive setup (per target):\n  full-example configure\n\nUpgrade:\n  brew upgrade full-example\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 configure --status\n\nUninstall:\n  brew uninstall <tap>/full-example\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
+              "options": [
+                {
+                  "name": "sync",
+                  "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
+                  "kind": "presence"
+                },
+                {
+                  "name": "remove-all",
+                  "description": "Remove all detected agent artifacts (skills and MCP).",
+                  "kind": "presence"
+                },
+                {
+                  "name": "status",
+                  "description": "Print what is currently installed (read-only).",
+                  "kind": "presence"
+                },
+                {
+                  "name": "yes",
+                  "description": "Skip confirmation (required for --sync, --remove-all, --remove-config).",
+                  "kind": "presence",
+                  "shortName": "y"
+                },
+                {
+                  "name": "dry",
+                  "description": "Show what would change without writing files.",
+                  "kind": "presence"
+                },
+                {
+                  "name": "json",
+                  "description": "Print changed paths or status JSON on stdout.",
+                  "kind": "presence"
+                }
+              ],
+              "fallbackCommand": "run",
+              "fallbackMode": "missingOnly"
+            },
+            {
+              "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": "skill",
+                  "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
+                  "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\n  args: mcp\n\nOr:\n\n  full-example configure\n\nFull setup guide: full-example docs mcp",
+              "options": [
+                {
+                  "name": "obscure-errors",
+                  "description": "Hide unexpected errors from clients.",
+                  "kind": "presence"
+                },
+                {
+                  "name": "log-format",
+                  "description": "Log format: json (ECS) 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) 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, GET /health/ready, GET /openapi.json, GET /openapi-browser, /api/*\n\nConfigure app settings:\n\n  full-example configure\n\nFull setup guide: full-example 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) 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": "post",
+          "description": "Create a workspace.",
+          "commands": [
+            {
+              "key": "version",
+              "description": "Print the program version."
+            },
+            {
+              "key": "configure",
+              "description": "Set up agent skills and 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 post_install runs:\n  full-example configure --sync --yes\n\nInteractive setup (per target):\n  full-example configure\n\nUpgrade:\n  brew upgrade full-example\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 configure --status\n\nUninstall:\n  brew uninstall <tap>/full-example\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
+              "options": [
+                {
+                  "name": "sync",
+                  "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
+                  "kind": "presence"
+                },
+                {
+                  "name": "remove-all",
+                  "description": "Remove all detected agent artifacts (skills and MCP).",
+                  "kind": "presence"
+                },
+                {
+                  "name": "status",
+                  "description": "Print what is currently installed (read-only).",
+                  "kind": "presence"
+                },
+                {
+                  "name": "yes",
+                  "description": "Skip confirmation (required for --sync, --remove-all, --remove-config).",
+                  "kind": "presence",
+                  "shortName": "y"
+                },
+                {
+                  "name": "dry",
+                  "description": "Show what would change without writing files.",
+                  "kind": "presence"
+                },
+                {
+                  "name": "json",
+                  "description": "Print changed paths or status JSON on stdout.",
+                  "kind": "presence"
+                }
+              ],
+              "fallbackCommand": "run",
+              "fallbackMode": "missingOnly"
+            },
+            {
+              "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": "skill",
+                  "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
+                  "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\n  args: mcp\n\nOr:\n\n  full-example configure\n\nFull setup guide: full-example docs mcp",
+              "options": [
+                {
+                  "name": "obscure-errors",
+                  "description": "Hide unexpected errors from clients.",
+                  "kind": "presence"
+                },
+                {
+                  "name": "log-format",
+                  "description": "Log format: json (ECS) 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) 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, GET /health/ready, GET /openapi.json, GET /openapi-browser, /api/*\n\nConfigure app settings:\n\n  full-example configure\n\nFull setup guide: full-example 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) 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": ":id",
+          "description": "One workspace by id.",
+          "commands": [
+            {
+              "key": "get",
+              "description": "Get one workspace.",
+              "commands": [
+                {
+                  "key": "version",
+                  "description": "Print the program version."
+                },
+                {
+                  "key": "configure",
+                  "description": "Set up agent skills and 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 post_install runs:\n  full-example configure --sync --yes\n\nInteractive setup (per target):\n  full-example configure\n\nUpgrade:\n  brew upgrade full-example\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 configure --status\n\nUninstall:\n  brew uninstall <tap>/full-example\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
+                  "options": [
+                    {
+                      "name": "sync",
+                      "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "remove-all",
+                      "description": "Remove all detected agent artifacts (skills and MCP).",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "status",
+                      "description": "Print what is currently installed (read-only).",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "yes",
+                      "description": "Skip confirmation (required for --sync, --remove-all, --remove-config).",
+                      "kind": "presence",
+                      "shortName": "y"
+                    },
+                    {
+                      "name": "dry",
+                      "description": "Show what would change without writing files.",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "json",
+                      "description": "Print changed paths or status JSON on stdout.",
+                      "kind": "presence"
+                    }
+                  ],
+                  "fallbackCommand": "run",
+                  "fallbackMode": "missingOnly"
+                },
+                {
+                  "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": "skill",
+                      "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
+                      "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\n  args: mcp\n\nOr:\n\n  full-example configure\n\nFull setup guide: full-example docs mcp",
+                  "options": [
+                    {
+                      "name": "obscure-errors",
+                      "description": "Hide unexpected errors from clients.",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "log-format",
+                      "description": "Log format: json (ECS) 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) 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, GET /health/ready, GET /openapi.json, GET /openapi-browser, /api/*\n\nConfigure app settings:\n\n  full-example configure\n\nFull setup guide: full-example 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) 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": "put",
+              "description": "Replace a workspace.",
+              "commands": [
+                {
+                  "key": "version",
+                  "description": "Print the program version."
+                },
+                {
+                  "key": "configure",
+                  "description": "Set up agent skills and 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 post_install runs:\n  full-example configure --sync --yes\n\nInteractive setup (per target):\n  full-example configure\n\nUpgrade:\n  brew upgrade full-example\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 configure --status\n\nUninstall:\n  brew uninstall <tap>/full-example\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
+                  "options": [
+                    {
+                      "name": "sync",
+                      "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "remove-all",
+                      "description": "Remove all detected agent artifacts (skills and MCP).",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "status",
+                      "description": "Print what is currently installed (read-only).",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "yes",
+                      "description": "Skip confirmation (required for --sync, --remove-all, --remove-config).",
+                      "kind": "presence",
+                      "shortName": "y"
+                    },
+                    {
+                      "name": "dry",
+                      "description": "Show what would change without writing files.",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "json",
+                      "description": "Print changed paths or status JSON on stdout.",
+                      "kind": "presence"
+                    }
+                  ],
+                  "fallbackCommand": "run",
+                  "fallbackMode": "missingOnly"
+                },
+                {
+                  "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": "skill",
+                      "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
+                      "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\n  args: mcp\n\nOr:\n\n  full-example configure\n\nFull setup guide: full-example docs mcp",
+                  "options": [
+                    {
+                      "name": "obscure-errors",
+                      "description": "Hide unexpected errors from clients.",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "log-format",
+                      "description": "Log format: json (ECS) 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) 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, GET /health/ready, GET /openapi.json, GET /openapi-browser, /api/*\n\nConfigure app settings:\n\n  full-example configure\n\nFull setup guide: full-example 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) 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": "patch",
+              "description": "Patch a workspace name.",
+              "commands": [
+                {
+                  "key": "version",
+                  "description": "Print the program version."
+                },
+                {
+                  "key": "configure",
+                  "description": "Set up agent skills and 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 post_install runs:\n  full-example configure --sync --yes\n\nInteractive setup (per target):\n  full-example configure\n\nUpgrade:\n  brew upgrade full-example\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 configure --status\n\nUninstall:\n  brew uninstall <tap>/full-example\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
+                  "options": [
+                    {
+                      "name": "sync",
+                      "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "remove-all",
+                      "description": "Remove all detected agent artifacts (skills and MCP).",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "status",
+                      "description": "Print what is currently installed (read-only).",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "yes",
+                      "description": "Skip confirmation (required for --sync, --remove-all, --remove-config).",
+                      "kind": "presence",
+                      "shortName": "y"
+                    },
+                    {
+                      "name": "dry",
+                      "description": "Show what would change without writing files.",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "json",
+                      "description": "Print changed paths or status JSON on stdout.",
+                      "kind": "presence"
+                    }
+                  ],
+                  "fallbackCommand": "run",
+                  "fallbackMode": "missingOnly"
+                },
+                {
+                  "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": "skill",
+                      "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
+                      "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\n  args: mcp\n\nOr:\n\n  full-example configure\n\nFull setup guide: full-example docs mcp",
+                  "options": [
+                    {
+                      "name": "obscure-errors",
+                      "description": "Hide unexpected errors from clients.",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "log-format",
+                      "description": "Log format: json (ECS) 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) 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, GET /health/ready, GET /openapi.json, GET /openapi-browser, /api/*\n\nConfigure app settings:\n\n  full-example configure\n\nFull setup guide: full-example 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) 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": "delete",
+              "description": "Delete a workspace.",
+              "commands": [
+                {
+                  "key": "version",
+                  "description": "Print the program version."
+                },
+                {
+                  "key": "configure",
+                  "description": "Set up agent skills and 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 post_install runs:\n  full-example configure --sync --yes\n\nInteractive setup (per target):\n  full-example configure\n\nUpgrade:\n  brew upgrade full-example\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 configure --status\n\nUninstall:\n  brew uninstall <tap>/full-example\n\nThe formula uninstall hook runs `configure --remove-all --yes` (skills, MCP, and app config).\n\nUse --dry to preview changes without writing files.\nUse --json for machine-readable output.",
+                  "options": [
+                    {
+                      "name": "sync",
+                      "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "remove-all",
+                      "description": "Remove all detected agent artifacts (skills and MCP).",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "status",
+                      "description": "Print what is currently installed (read-only).",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "yes",
+                      "description": "Skip confirmation (required for --sync, --remove-all, --remove-config).",
+                      "kind": "presence",
+                      "shortName": "y"
+                    },
+                    {
+                      "name": "dry",
+                      "description": "Show what would change without writing files.",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "json",
+                      "description": "Print changed paths or status JSON on stdout.",
+                      "kind": "presence"
+                    }
+                  ],
+                  "fallbackCommand": "run",
+                  "fallbackMode": "missingOnly"
+                },
+                {
+                  "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": "skill",
+                      "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
+                      "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\n  args: mcp\n\nOr:\n\n  full-example configure\n\nFull setup guide: full-example docs mcp",
+                  "options": [
+                    {
+                      "name": "obscure-errors",
+                      "description": "Hide unexpected errors from clients.",
+                      "kind": "presence"
+                    },
+                    {
+                      "name": "log-format",
+                      "description": "Log format: json (ECS) 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) 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, GET /health/ready, GET /openapi.json, GET /openapi-browser, /api/*\n\nConfigure app settings:\n\n  full-example configure\n\nFull setup guide: full-example 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) 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"
+                }
+              ]
+            }
+          ]
+        }
+      ]
     }
   ]
 }