argsbarg 6.1.10 → 6.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (136) hide show
  1. package/CHANGELOG.md +22 -1
  2. package/README.md +49 -49
  3. package/docs/README.md +5 -4
  4. package/docs/ai-skills.md +36 -23
  5. package/docs/bundled-docs.md +1 -1
  6. package/docs/cli-program.md +19 -20
  7. package/docs/config-schema.md +3 -3
  8. package/docs/configure.md +12 -16
  9. package/docs/developing.md +9 -9
  10. package/docs/mcp.md +21 -57
  11. package/docs/output-schema.md +3 -3
  12. package/examples/formats.ts +5 -6
  13. package/examples/full-example/AGENTS.md +75 -0
  14. package/examples/full-example/CLAUDE.md +1 -0
  15. package/examples/full-example/README.md +7 -69
  16. package/examples/full-example/docs/README.md +1 -1
  17. package/examples/full-example/docs/cli-schema.json +1 -1659
  18. package/examples/full-example/docs/cli.md +2 -1538
  19. package/examples/full-example/docs/http.md +0 -7
  20. package/examples/full-example/docs/mcp.md +23 -59
  21. package/examples/full-example/docs/openapi.json +2 -782
  22. package/examples/full-example/docs/skill.md +18 -14
  23. package/examples/full-example/justfile +5 -17
  24. package/examples/full-example/scripts/create-identity.ts +2 -1
  25. package/examples/full-example/src/commands/status/command.test.ts +2 -2
  26. package/examples/full-example/src/commands/status/command.ts +7 -6
  27. package/examples/full-example/src/program.ts +4 -10
  28. package/examples/full-example-json/AGENTS.md +86 -0
  29. package/examples/full-example-json/CLAUDE.md +1 -0
  30. package/examples/full-example-json/Formula/.gitkeep +0 -0
  31. package/examples/full-example-json/Formula/full-example-json.rb +35 -0
  32. package/examples/full-example-json/README.md +27 -0
  33. package/examples/full-example-json/biome.json +22 -0
  34. package/examples/full-example-json/bun.lock +48 -0
  35. package/examples/full-example-json/docs/README.md +27 -0
  36. package/examples/full-example-json/docs/cli-schema.json +2145 -0
  37. package/examples/full-example-json/docs/cli.md +1990 -0
  38. package/examples/full-example-json/docs/http.md +92 -0
  39. package/examples/full-example-json/docs/mcp.md +116 -0
  40. package/examples/full-example-json/docs/openapi.json +1246 -0
  41. package/examples/full-example-json/docs/skill.md +57 -0
  42. package/examples/full-example-json/justfile +171 -0
  43. package/examples/full-example-json/package.json +22 -0
  44. package/examples/full-example-json/scripts/create-identity.ts +12 -0
  45. package/examples/full-example-json/scripts/dev-formula.ts +97 -0
  46. package/examples/full-example-json/scripts/formula-shared.test.ts +68 -0
  47. package/examples/full-example-json/scripts/formula-shared.ts +170 -0
  48. package/examples/full-example-json/scripts/print-identity.ts +28 -0
  49. package/examples/full-example-json/scripts/release.ts +212 -0
  50. package/examples/full-example-json/src/commands/echo/command.ts +26 -0
  51. package/examples/full-example-json/src/commands/status/command.test.ts +10 -0
  52. package/examples/full-example-json/src/commands/status/command.ts +28 -0
  53. package/examples/full-example-json/src/index.ts +10 -0
  54. package/examples/full-example-json/src/program.ts +33 -0
  55. package/examples/full-example-json/src/types/md.d.ts +4 -0
  56. package/examples/full-example-json/tsconfig.json +17 -0
  57. package/examples/minimal.ts +17 -17
  58. package/examples/nested.ts +10 -10
  59. package/examples/option-required.ts +13 -13
  60. package/examples/servers.ts +10 -10
  61. package/index.d.ts +17 -43
  62. package/package.json +1 -1
  63. package/src/cli-tool/create.test.ts +44 -68
  64. package/src/cli-tool/create.ts +81 -17
  65. package/src/cli-tool/full-example-capabilities.test.ts +33 -18
  66. package/src/cli-tool/post-create.ts +31 -17
  67. package/src/cli-tool/program.ts +16 -7
  68. package/src/cli-tool/prompt.ts +27 -0
  69. package/src/cli-tool/run-create.ts +19 -7
  70. package/src/cli-tool/schemagen/schemagen.test.ts +3 -3
  71. package/src/configure/artifacts/install-validate.test.ts +20 -33
  72. package/src/configure/artifacts/paths.ts +9 -53
  73. package/src/configure/artifacts/status.test.ts +13 -16
  74. package/src/configure/artifacts/status.ts +5 -22
  75. package/src/configure/artifacts/target-base.ts +6 -15
  76. package/src/configure/artifacts/target-effective.ts +16 -54
  77. package/src/configure/artifacts/target-mcp-json.ts +2 -5
  78. package/src/configure/artifacts/target-registry.ts +0 -7
  79. package/src/configure/artifacts/target-scope.ts +7 -17
  80. package/src/configure/artifacts/target-skill.ts +6 -15
  81. package/src/configure/artifacts/target-types.ts +6 -54
  82. package/src/configure/artifacts/targets/agents-mcp.ts +11 -0
  83. package/src/configure/artifacts/targets/configure.ts +1 -5
  84. package/src/configure/artifacts/targets/index.ts +4 -44
  85. package/src/configure/artifacts/targets/skill.ts +12 -0
  86. package/src/configure/artifacts/targets.test.ts +21 -59
  87. package/src/configure/configure.test.ts +35 -46
  88. package/src/configure/index.ts +19 -19
  89. package/src/configure/prompt.ts +2 -12
  90. package/src/core/parse.test.ts +21 -32
  91. package/src/core/types.ts +18 -44
  92. package/src/core/validate.ts +28 -45
  93. package/src/docs/docs.test.ts +4 -4
  94. package/src/docs/mcp-guide.ts +41 -71
  95. package/src/docs/resolve.ts +1 -1
  96. package/src/exports/cli.ts +1 -1
  97. package/src/index.ts +1 -1
  98. package/src/skill/generate.ts +26 -45
  99. package/src/skill/install.ts +18 -38
  100. package/src/skill/naming.ts +3 -27
  101. package/src/test/integration/config.test.ts +3 -3
  102. package/src/test/integration/mcp.test.ts +4 -4
  103. package/{examples/mcp-test.ts → src/test/mcp-integration-fixture.ts} +20 -22
  104. package/src/configure/artifacts/target-mcp-cli.ts +0 -127
  105. package/src/configure/artifacts/targets/chatgpt-mcp.ts +0 -12
  106. package/src/configure/artifacts/targets/claude-code-mcp.ts +0 -15
  107. package/src/configure/artifacts/targets/claude-desktop-mcp.ts +0 -12
  108. package/src/configure/artifacts/targets/claude-skill.ts +0 -16
  109. package/src/configure/artifacts/targets/codex-mcp.ts +0 -25
  110. package/src/configure/artifacts/targets/codex-skill.ts +0 -14
  111. package/src/configure/artifacts/targets/cursor-mcp.ts +0 -15
  112. package/src/configure/artifacts/targets/cursor-skill.ts +0 -16
  113. package/src/configure/artifacts/targets/openclaw-mcp.ts +0 -25
  114. package/src/configure/artifacts/targets/openclaw-skill.ts +0 -17
  115. package/src/configure/artifacts/targets/opencode-mcp.ts +0 -96
  116. package/src/configure/artifacts/targets/opencode-skill.ts +0 -15
  117. /package/examples/{full-example → full-example-json}/src/commands/render-json/__generated__/RenderJsonInputSchema.json +0 -0
  118. /package/examples/{full-example → full-example-json}/src/commands/render-json/__generated__/index.ts +0 -0
  119. /package/examples/{full-example → full-example-json}/src/commands/render-json/command.test.ts +0 -0
  120. /package/examples/{full-example → full-example-json}/src/commands/render-json/command.ts +0 -0
  121. /package/examples/{full-example → full-example-json}/src/commands/render-json/types.ts +0 -0
  122. /package/examples/{full-example → full-example-json}/src/commands/status/__generated__/StatusJsonOutputSchema.json +0 -0
  123. /package/examples/{full-example → full-example-json}/src/commands/status/__generated__/index.ts +0 -0
  124. /package/examples/{full-example → full-example-json}/src/commands/status/types.ts +0 -0
  125. /package/examples/{full-example → full-example-json}/src/commands/workspaces/__generated__/WorkspaceNameInputSchema.json +0 -0
  126. /package/examples/{full-example → full-example-json}/src/commands/workspaces/__generated__/index.ts +0 -0
  127. /package/examples/{full-example → full-example-json}/src/commands/workspaces/command.test.ts +0 -0
  128. /package/examples/{full-example → full-example-json}/src/commands/workspaces/command.ts +0 -0
  129. /package/examples/{full-example → full-example-json}/src/commands/workspaces/types.ts +0 -0
  130. /package/examples/{full-example → full-example-json}/src/db/index.test.ts +0 -0
  131. /package/examples/{full-example → full-example-json}/src/db/index.ts +0 -0
  132. /package/examples/{full-example → full-example-json}/src/db/migrate.test.ts +0 -0
  133. /package/examples/{full-example → full-example-json}/src/db/migrate.ts +0 -0
  134. /package/examples/{full-example → full-example-json}/src/db/migrations/001_workspaces.sql +0 -0
  135. /package/examples/{full-example → full-example-json}/src/db/tables/workspaces.ts +0 -0
  136. /package/examples/{full-example → full-example-json}/src/types/argsbarg.d.ts +0 -0
package/examples/full-example-json/docs/cli-schema.json ADDED
@@ -0,0 +1,2145 @@
1
+ {
2
+ "key": "full-example-json",
3
+ "description": "Argsbarg schema-first copy template (@sg schemagen, JSON schemas, REST CRUD)",
4
+ "commands": [
5
+ {
6
+ "key": "echo",
7
+ "description": "Echo a message (MCP-friendly leaf).",
8
+ "options": [
9
+ {
10
+ "name": "message",
11
+ "description": "Text to print.",
12
+ "kind": "string",
13
+ "required": true
14
+ }
15
+ ],
16
+ "commands": [
17
+ {
18
+ "key": "version",
19
+ "description": "Print the program version."
20
+ },
21
+ {
22
+ "key": "configure",
23
+ "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
24
+ "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-json configure --sync --yes\n\nInteractive setup (per target):\n full-example-json configure\n\nUpgrade:\n brew upgrade full-example-json\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 brew uninstall <tap>/full-example-json\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.",
25
+ "options": [
26
+ {
27
+ "name": "sync",
28
+ "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
29
+ "kind": "presence"
30
+ },
31
+ {
32
+ "name": "remove-all",
33
+ "description": "Remove all detected agent artifacts (skills and MCP).",
34
+ "kind": "presence"
35
+ },
36
+ {
37
+ "name": "status",
38
+ "description": "Print what is currently installed (read-only).",
39
+ "kind": "presence"
40
+ },
41
+ {
42
+ "name": "yes",
43
+ "description": "Skip confirmation (required for --sync, --remove-all, --remove-config).",
44
+ "kind": "presence",
45
+ "shortName": "y"
46
+ },
47
+ {
48
+ "name": "dry",
49
+ "description": "Show what would change without writing files.",
50
+ "kind": "presence"
51
+ },
52
+ {
53
+ "name": "json",
54
+ "description": "Print changed paths or status JSON on stdout.",
55
+ "kind": "presence"
56
+ }
57
+ ],
58
+ "fallbackCommand": "run",
59
+ "fallbackMode": "missingOnly"
60
+ },
61
+ {
62
+ "key": "docs",
63
+ "description": "Print bundled CLI documentation.",
64
+ "notes": "Topics print to stdout. Add --save to write files under ./docs/.",
65
+ "options": [
66
+ {
67
+ "name": "save",
68
+ "description": "Write documentation to ./docs/.",
69
+ "kind": "presence"
70
+ }
71
+ ],
72
+ "commands": [
73
+ {
74
+ "key": "readme",
75
+ "description": "Print README (user guide).",
76
+ "options": [
77
+ {
78
+ "name": "save",
79
+ "description": "Write documentation to ./docs/.",
80
+ "kind": "presence"
81
+ }
82
+ ]
83
+ },
84
+ {
85
+ "key": "mcp",
86
+ "description": "Print MCP server setup and tool guidance.",
87
+ "options": [
88
+ {
89
+ "name": "save",
90
+ "description": "Write documentation to ./docs/.",
91
+ "kind": "presence"
92
+ }
93
+ ]
94
+ },
95
+ {
96
+ "key": "http",
97
+ "description": "Print HTTP API setup and tool guidance.",
98
+ "options": [
99
+ {
100
+ "name": "save",
101
+ "description": "Write documentation to ./docs/.",
102
+ "kind": "presence"
103
+ }
104
+ ]
105
+ },
106
+ {
107
+ "key": "openapi",
108
+ "description": "Print the HTTP OpenAPI 3.1 document as JSON.",
109
+ "options": [
110
+ {
111
+ "name": "save",
112
+ "description": "Write documentation to ./docs/.",
113
+ "kind": "presence"
114
+ }
115
+ ]
116
+ },
117
+ {
118
+ "key": "cli-schema",
119
+ "description": "Print the full CLI command tree as JSON.",
120
+ "options": [
121
+ {
122
+ "name": "save",
123
+ "description": "Write documentation to ./docs/.",
124
+ "kind": "presence"
125
+ }
126
+ ]
127
+ },
128
+ {
129
+ "key": "cli",
130
+ "description": "Print the full command reference as markdown.",
131
+ "options": [
132
+ {
133
+ "name": "save",
134
+ "description": "Write documentation to ./docs/.",
135
+ "kind": "presence"
136
+ }
137
+ ]
138
+ },
139
+ {
140
+ "key": "skill",
141
+ "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
142
+ "options": [
143
+ {
144
+ "name": "save",
145
+ "description": "Write documentation to ./docs/.",
146
+ "kind": "presence"
147
+ }
148
+ ]
149
+ }
150
+ ]
151
+ },
152
+ {
153
+ "key": "mcp",
154
+ "description": "MCP server and bundle tools.",
155
+ "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",
156
+ "options": [
157
+ {
158
+ "name": "obscure-errors",
159
+ "description": "Hide unexpected errors from clients.",
160
+ "kind": "presence"
161
+ },
162
+ {
163
+ "name": "log-format",
164
+ "description": "Log format: json (ECS Logging) or text.",
165
+ "kind": "enum",
166
+ "choices": [
167
+ "json",
168
+ "text"
169
+ ]
170
+ },
171
+ {
172
+ "name": "log-file",
173
+ "description": "Append logs to this file (relative → app config dir).",
174
+ "kind": "string"
175
+ },
176
+ {
177
+ "name": "dev",
178
+ "description": "Print full stacks to stderr on errors.",
179
+ "kind": "presence"
180
+ }
181
+ ],
182
+ "fallbackCommand": "serve",
183
+ "fallbackMode": "missingOnly",
184
+ "commands": [
185
+ {
186
+ "key": "bundle",
187
+ "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>."
188
+ }
189
+ ]
190
+ },
191
+ {
192
+ "key": "http",
193
+ "description": "HTTP API server for tools.",
194
+ "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",
195
+ "options": [
196
+ {
197
+ "name": "host",
198
+ "description": "Listen host.",
199
+ "kind": "string"
200
+ },
201
+ {
202
+ "name": "port",
203
+ "description": "Listen port.",
204
+ "kind": "number"
205
+ },
206
+ {
207
+ "name": "trust-proxy",
208
+ "description": "Honor X-Forwarded-For for client IP.",
209
+ "kind": "presence"
210
+ },
211
+ {
212
+ "name": "obscure-errors",
213
+ "description": "Hide unexpected errors from clients.",
214
+ "kind": "presence"
215
+ },
216
+ {
217
+ "name": "log-format",
218
+ "description": "Log format: json (ECS Logging) or text.",
219
+ "kind": "enum",
220
+ "choices": [
221
+ "json",
222
+ "text"
223
+ ]
224
+ },
225
+ {
226
+ "name": "log-file",
227
+ "description": "Append logs to this file (relative → app config dir).",
228
+ "kind": "string"
229
+ },
230
+ {
231
+ "name": "no-access-log",
232
+ "description": "Disable HTTP access logs.",
233
+ "kind": "presence"
234
+ },
235
+ {
236
+ "name": "dev",
237
+ "description": "Print full stacks to stderr on errors.",
238
+ "kind": "presence"
239
+ }
240
+ ],
241
+ "fallbackCommand": "serve",
242
+ "fallbackMode": "missingOnly"
243
+ }
244
+ ]
245
+ },
246
+ {
247
+ "key": "render-json",
248
+ "description": "Echo a JSON message (schema-first JSON leaf demo).",
249
+ "commands": [
250
+ {
251
+ "key": "version",
252
+ "description": "Print the program version."
253
+ },
254
+ {
255
+ "key": "configure",
256
+ "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
257
+ "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-json configure --sync --yes\n\nInteractive setup (per target):\n full-example-json configure\n\nUpgrade:\n brew upgrade full-example-json\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 brew uninstall <tap>/full-example-json\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.",
258
+ "options": [
259
+ {
260
+ "name": "sync",
261
+ "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
262
+ "kind": "presence"
263
+ },
264
+ {
265
+ "name": "remove-all",
266
+ "description": "Remove all detected agent artifacts (skills and MCP).",
267
+ "kind": "presence"
268
+ },
269
+ {
270
+ "name": "status",
271
+ "description": "Print what is currently installed (read-only).",
272
+ "kind": "presence"
273
+ },
274
+ {
275
+ "name": "yes",
276
+ "description": "Skip confirmation (required for --sync, --remove-all, --remove-config).",
277
+ "kind": "presence",
278
+ "shortName": "y"
279
+ },
280
+ {
281
+ "name": "dry",
282
+ "description": "Show what would change without writing files.",
283
+ "kind": "presence"
284
+ },
285
+ {
286
+ "name": "json",
287
+ "description": "Print changed paths or status JSON on stdout.",
288
+ "kind": "presence"
289
+ }
290
+ ],
291
+ "fallbackCommand": "run",
292
+ "fallbackMode": "missingOnly"
293
+ },
294
+ {
295
+ "key": "docs",
296
+ "description": "Print bundled CLI documentation.",
297
+ "notes": "Topics print to stdout. Add --save to write files under ./docs/.",
298
+ "options": [
299
+ {
300
+ "name": "save",
301
+ "description": "Write documentation to ./docs/.",
302
+ "kind": "presence"
303
+ }
304
+ ],
305
+ "commands": [
306
+ {
307
+ "key": "readme",
308
+ "description": "Print README (user guide).",
309
+ "options": [
310
+ {
311
+ "name": "save",
312
+ "description": "Write documentation to ./docs/.",
313
+ "kind": "presence"
314
+ }
315
+ ]
316
+ },
317
+ {
318
+ "key": "mcp",
319
+ "description": "Print MCP server setup and tool guidance.",
320
+ "options": [
321
+ {
322
+ "name": "save",
323
+ "description": "Write documentation to ./docs/.",
324
+ "kind": "presence"
325
+ }
326
+ ]
327
+ },
328
+ {
329
+ "key": "http",
330
+ "description": "Print HTTP API setup and tool guidance.",
331
+ "options": [
332
+ {
333
+ "name": "save",
334
+ "description": "Write documentation to ./docs/.",
335
+ "kind": "presence"
336
+ }
337
+ ]
338
+ },
339
+ {
340
+ "key": "openapi",
341
+ "description": "Print the HTTP OpenAPI 3.1 document as JSON.",
342
+ "options": [
343
+ {
344
+ "name": "save",
345
+ "description": "Write documentation to ./docs/.",
346
+ "kind": "presence"
347
+ }
348
+ ]
349
+ },
350
+ {
351
+ "key": "cli-schema",
352
+ "description": "Print the full CLI command tree as JSON.",
353
+ "options": [
354
+ {
355
+ "name": "save",
356
+ "description": "Write documentation to ./docs/.",
357
+ "kind": "presence"
358
+ }
359
+ ]
360
+ },
361
+ {
362
+ "key": "cli",
363
+ "description": "Print the full command reference as markdown.",
364
+ "options": [
365
+ {
366
+ "name": "save",
367
+ "description": "Write documentation to ./docs/.",
368
+ "kind": "presence"
369
+ }
370
+ ]
371
+ },
372
+ {
373
+ "key": "skill",
374
+ "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
375
+ "options": [
376
+ {
377
+ "name": "save",
378
+ "description": "Write documentation to ./docs/.",
379
+ "kind": "presence"
380
+ }
381
+ ]
382
+ }
383
+ ]
384
+ },
385
+ {
386
+ "key": "mcp",
387
+ "description": "MCP server and bundle tools.",
388
+ "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",
389
+ "options": [
390
+ {
391
+ "name": "obscure-errors",
392
+ "description": "Hide unexpected errors from clients.",
393
+ "kind": "presence"
394
+ },
395
+ {
396
+ "name": "log-format",
397
+ "description": "Log format: json (ECS Logging) or text.",
398
+ "kind": "enum",
399
+ "choices": [
400
+ "json",
401
+ "text"
402
+ ]
403
+ },
404
+ {
405
+ "name": "log-file",
406
+ "description": "Append logs to this file (relative → app config dir).",
407
+ "kind": "string"
408
+ },
409
+ {
410
+ "name": "dev",
411
+ "description": "Print full stacks to stderr on errors.",
412
+ "kind": "presence"
413
+ }
414
+ ],
415
+ "fallbackCommand": "serve",
416
+ "fallbackMode": "missingOnly",
417
+ "commands": [
418
+ {
419
+ "key": "bundle",
420
+ "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>."
421
+ }
422
+ ]
423
+ },
424
+ {
425
+ "key": "http",
426
+ "description": "HTTP API server for tools.",
427
+ "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",
428
+ "options": [
429
+ {
430
+ "name": "host",
431
+ "description": "Listen host.",
432
+ "kind": "string"
433
+ },
434
+ {
435
+ "name": "port",
436
+ "description": "Listen port.",
437
+ "kind": "number"
438
+ },
439
+ {
440
+ "name": "trust-proxy",
441
+ "description": "Honor X-Forwarded-For for client IP.",
442
+ "kind": "presence"
443
+ },
444
+ {
445
+ "name": "obscure-errors",
446
+ "description": "Hide unexpected errors from clients.",
447
+ "kind": "presence"
448
+ },
449
+ {
450
+ "name": "log-format",
451
+ "description": "Log format: json (ECS Logging) or text.",
452
+ "kind": "enum",
453
+ "choices": [
454
+ "json",
455
+ "text"
456
+ ]
457
+ },
458
+ {
459
+ "name": "log-file",
460
+ "description": "Append logs to this file (relative → app config dir).",
461
+ "kind": "string"
462
+ },
463
+ {
464
+ "name": "no-access-log",
465
+ "description": "Disable HTTP access logs.",
466
+ "kind": "presence"
467
+ },
468
+ {
469
+ "name": "dev",
470
+ "description": "Print full stacks to stderr on errors.",
471
+ "kind": "presence"
472
+ }
473
+ ],
474
+ "fallbackCommand": "serve",
475
+ "fallbackMode": "missingOnly"
476
+ }
477
+ ]
478
+ },
479
+ {
480
+ "key": "status",
481
+ "description": "Show app version.",
482
+ "options": [
483
+ {
484
+ "name": "json",
485
+ "description": "Emit JSON.",
486
+ "kind": "presence"
487
+ }
488
+ ],
489
+ "outputSchema": {
490
+ "$schema": "http://json-schema.org/draft-07/schema#",
491
+ "type": "object",
492
+ "properties": {
493
+ "version": {
494
+ "type": "string",
495
+ "description": "App version from program root."
496
+ }
497
+ },
498
+ "required": [
499
+ "version"
500
+ ],
501
+ "additionalProperties": false,
502
+ "definitions": {}
503
+ },
504
+ "commands": [
505
+ {
506
+ "key": "version",
507
+ "description": "Print the program version."
508
+ },
509
+ {
510
+ "key": "configure",
511
+ "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
512
+ "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-json configure --sync --yes\n\nInteractive setup (per target):\n full-example-json configure\n\nUpgrade:\n brew upgrade full-example-json\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 brew uninstall <tap>/full-example-json\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.",
513
+ "options": [
514
+ {
515
+ "name": "sync",
516
+ "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
517
+ "kind": "presence"
518
+ },
519
+ {
520
+ "name": "remove-all",
521
+ "description": "Remove all detected agent artifacts (skills and MCP).",
522
+ "kind": "presence"
523
+ },
524
+ {
525
+ "name": "status",
526
+ "description": "Print what is currently installed (read-only).",
527
+ "kind": "presence"
528
+ },
529
+ {
530
+ "name": "yes",
531
+ "description": "Skip confirmation (required for --sync, --remove-all, --remove-config).",
532
+ "kind": "presence",
533
+ "shortName": "y"
534
+ },
535
+ {
536
+ "name": "dry",
537
+ "description": "Show what would change without writing files.",
538
+ "kind": "presence"
539
+ },
540
+ {
541
+ "name": "json",
542
+ "description": "Print changed paths or status JSON on stdout.",
543
+ "kind": "presence"
544
+ }
545
+ ],
546
+ "fallbackCommand": "run",
547
+ "fallbackMode": "missingOnly"
548
+ },
549
+ {
550
+ "key": "docs",
551
+ "description": "Print bundled CLI documentation.",
552
+ "notes": "Topics print to stdout. Add --save to write files under ./docs/.",
553
+ "options": [
554
+ {
555
+ "name": "save",
556
+ "description": "Write documentation to ./docs/.",
557
+ "kind": "presence"
558
+ }
559
+ ],
560
+ "commands": [
561
+ {
562
+ "key": "readme",
563
+ "description": "Print README (user guide).",
564
+ "options": [
565
+ {
566
+ "name": "save",
567
+ "description": "Write documentation to ./docs/.",
568
+ "kind": "presence"
569
+ }
570
+ ]
571
+ },
572
+ {
573
+ "key": "mcp",
574
+ "description": "Print MCP server setup and tool guidance.",
575
+ "options": [
576
+ {
577
+ "name": "save",
578
+ "description": "Write documentation to ./docs/.",
579
+ "kind": "presence"
580
+ }
581
+ ]
582
+ },
583
+ {
584
+ "key": "http",
585
+ "description": "Print HTTP API setup and tool guidance.",
586
+ "options": [
587
+ {
588
+ "name": "save",
589
+ "description": "Write documentation to ./docs/.",
590
+ "kind": "presence"
591
+ }
592
+ ]
593
+ },
594
+ {
595
+ "key": "openapi",
596
+ "description": "Print the HTTP OpenAPI 3.1 document as JSON.",
597
+ "options": [
598
+ {
599
+ "name": "save",
600
+ "description": "Write documentation to ./docs/.",
601
+ "kind": "presence"
602
+ }
603
+ ]
604
+ },
605
+ {
606
+ "key": "cli-schema",
607
+ "description": "Print the full CLI command tree as JSON.",
608
+ "options": [
609
+ {
610
+ "name": "save",
611
+ "description": "Write documentation to ./docs/.",
612
+ "kind": "presence"
613
+ }
614
+ ]
615
+ },
616
+ {
617
+ "key": "cli",
618
+ "description": "Print the full command reference as markdown.",
619
+ "options": [
620
+ {
621
+ "name": "save",
622
+ "description": "Write documentation to ./docs/.",
623
+ "kind": "presence"
624
+ }
625
+ ]
626
+ },
627
+ {
628
+ "key": "skill",
629
+ "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
630
+ "options": [
631
+ {
632
+ "name": "save",
633
+ "description": "Write documentation to ./docs/.",
634
+ "kind": "presence"
635
+ }
636
+ ]
637
+ }
638
+ ]
639
+ },
640
+ {
641
+ "key": "mcp",
642
+ "description": "MCP server and bundle tools.",
643
+ "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",
644
+ "options": [
645
+ {
646
+ "name": "obscure-errors",
647
+ "description": "Hide unexpected errors from clients.",
648
+ "kind": "presence"
649
+ },
650
+ {
651
+ "name": "log-format",
652
+ "description": "Log format: json (ECS Logging) or text.",
653
+ "kind": "enum",
654
+ "choices": [
655
+ "json",
656
+ "text"
657
+ ]
658
+ },
659
+ {
660
+ "name": "log-file",
661
+ "description": "Append logs to this file (relative → app config dir).",
662
+ "kind": "string"
663
+ },
664
+ {
665
+ "name": "dev",
666
+ "description": "Print full stacks to stderr on errors.",
667
+ "kind": "presence"
668
+ }
669
+ ],
670
+ "fallbackCommand": "serve",
671
+ "fallbackMode": "missingOnly",
672
+ "commands": [
673
+ {
674
+ "key": "bundle",
675
+ "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>."
676
+ }
677
+ ]
678
+ },
679
+ {
680
+ "key": "http",
681
+ "description": "HTTP API server for tools.",
682
+ "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",
683
+ "options": [
684
+ {
685
+ "name": "host",
686
+ "description": "Listen host.",
687
+ "kind": "string"
688
+ },
689
+ {
690
+ "name": "port",
691
+ "description": "Listen port.",
692
+ "kind": "number"
693
+ },
694
+ {
695
+ "name": "trust-proxy",
696
+ "description": "Honor X-Forwarded-For for client IP.",
697
+ "kind": "presence"
698
+ },
699
+ {
700
+ "name": "obscure-errors",
701
+ "description": "Hide unexpected errors from clients.",
702
+ "kind": "presence"
703
+ },
704
+ {
705
+ "name": "log-format",
706
+ "description": "Log format: json (ECS Logging) or text.",
707
+ "kind": "enum",
708
+ "choices": [
709
+ "json",
710
+ "text"
711
+ ]
712
+ },
713
+ {
714
+ "name": "log-file",
715
+ "description": "Append logs to this file (relative → app config dir).",
716
+ "kind": "string"
717
+ },
718
+ {
719
+ "name": "no-access-log",
720
+ "description": "Disable HTTP access logs.",
721
+ "kind": "presence"
722
+ },
723
+ {
724
+ "name": "dev",
725
+ "description": "Print full stacks to stderr on errors.",
726
+ "kind": "presence"
727
+ }
728
+ ],
729
+ "fallbackCommand": "serve",
730
+ "fallbackMode": "missingOnly"
731
+ }
732
+ ]
733
+ },
734
+ {
735
+ "key": "workspaces",
736
+ "description": "Workspace collection and CRUD.",
737
+ "commands": [
738
+ {
739
+ "key": "get",
740
+ "description": "List workspaces.",
741
+ "commands": [
742
+ {
743
+ "key": "version",
744
+ "description": "Print the program version."
745
+ },
746
+ {
747
+ "key": "configure",
748
+ "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
749
+ "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-json configure --sync --yes\n\nInteractive setup (per target):\n full-example-json configure\n\nUpgrade:\n brew upgrade full-example-json\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 brew uninstall <tap>/full-example-json\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.",
750
+ "options": [
751
+ {
752
+ "name": "sync",
753
+ "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
754
+ "kind": "presence"
755
+ },
756
+ {
757
+ "name": "remove-all",
758
+ "description": "Remove all detected agent artifacts (skills and MCP).",
759
+ "kind": "presence"
760
+ },
761
+ {
762
+ "name": "status",
763
+ "description": "Print what is currently installed (read-only).",
764
+ "kind": "presence"
765
+ },
766
+ {
767
+ "name": "yes",
768
+ "description": "Skip confirmation (required for --sync, --remove-all, --remove-config).",
769
+ "kind": "presence",
770
+ "shortName": "y"
771
+ },
772
+ {
773
+ "name": "dry",
774
+ "description": "Show what would change without writing files.",
775
+ "kind": "presence"
776
+ },
777
+ {
778
+ "name": "json",
779
+ "description": "Print changed paths or status JSON on stdout.",
780
+ "kind": "presence"
781
+ }
782
+ ],
783
+ "fallbackCommand": "run",
784
+ "fallbackMode": "missingOnly"
785
+ },
786
+ {
787
+ "key": "docs",
788
+ "description": "Print bundled CLI documentation.",
789
+ "notes": "Topics print to stdout. Add --save to write files under ./docs/.",
790
+ "options": [
791
+ {
792
+ "name": "save",
793
+ "description": "Write documentation to ./docs/.",
794
+ "kind": "presence"
795
+ }
796
+ ],
797
+ "commands": [
798
+ {
799
+ "key": "readme",
800
+ "description": "Print README (user guide).",
801
+ "options": [
802
+ {
803
+ "name": "save",
804
+ "description": "Write documentation to ./docs/.",
805
+ "kind": "presence"
806
+ }
807
+ ]
808
+ },
809
+ {
810
+ "key": "mcp",
811
+ "description": "Print MCP server setup and tool guidance.",
812
+ "options": [
813
+ {
814
+ "name": "save",
815
+ "description": "Write documentation to ./docs/.",
816
+ "kind": "presence"
817
+ }
818
+ ]
819
+ },
820
+ {
821
+ "key": "http",
822
+ "description": "Print HTTP API setup and tool guidance.",
823
+ "options": [
824
+ {
825
+ "name": "save",
826
+ "description": "Write documentation to ./docs/.",
827
+ "kind": "presence"
828
+ }
829
+ ]
830
+ },
831
+ {
832
+ "key": "openapi",
833
+ "description": "Print the HTTP OpenAPI 3.1 document as JSON.",
834
+ "options": [
835
+ {
836
+ "name": "save",
837
+ "description": "Write documentation to ./docs/.",
838
+ "kind": "presence"
839
+ }
840
+ ]
841
+ },
842
+ {
843
+ "key": "cli-schema",
844
+ "description": "Print the full CLI command tree as JSON.",
845
+ "options": [
846
+ {
847
+ "name": "save",
848
+ "description": "Write documentation to ./docs/.",
849
+ "kind": "presence"
850
+ }
851
+ ]
852
+ },
853
+ {
854
+ "key": "cli",
855
+ "description": "Print the full command reference as markdown.",
856
+ "options": [
857
+ {
858
+ "name": "save",
859
+ "description": "Write documentation to ./docs/.",
860
+ "kind": "presence"
861
+ }
862
+ ]
863
+ },
864
+ {
865
+ "key": "skill",
866
+ "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
867
+ "options": [
868
+ {
869
+ "name": "save",
870
+ "description": "Write documentation to ./docs/.",
871
+ "kind": "presence"
872
+ }
873
+ ]
874
+ }
875
+ ]
876
+ },
877
+ {
878
+ "key": "mcp",
879
+ "description": "MCP server and bundle tools.",
880
+ "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",
881
+ "options": [
882
+ {
883
+ "name": "obscure-errors",
884
+ "description": "Hide unexpected errors from clients.",
885
+ "kind": "presence"
886
+ },
887
+ {
888
+ "name": "log-format",
889
+ "description": "Log format: json (ECS Logging) or text.",
890
+ "kind": "enum",
891
+ "choices": [
892
+ "json",
893
+ "text"
894
+ ]
895
+ },
896
+ {
897
+ "name": "log-file",
898
+ "description": "Append logs to this file (relative → app config dir).",
899
+ "kind": "string"
900
+ },
901
+ {
902
+ "name": "dev",
903
+ "description": "Print full stacks to stderr on errors.",
904
+ "kind": "presence"
905
+ }
906
+ ],
907
+ "fallbackCommand": "serve",
908
+ "fallbackMode": "missingOnly",
909
+ "commands": [
910
+ {
911
+ "key": "bundle",
912
+ "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>."
913
+ }
914
+ ]
915
+ },
916
+ {
917
+ "key": "http",
918
+ "description": "HTTP API server for tools.",
919
+ "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",
920
+ "options": [
921
+ {
922
+ "name": "host",
923
+ "description": "Listen host.",
924
+ "kind": "string"
925
+ },
926
+ {
927
+ "name": "port",
928
+ "description": "Listen port.",
929
+ "kind": "number"
930
+ },
931
+ {
932
+ "name": "trust-proxy",
933
+ "description": "Honor X-Forwarded-For for client IP.",
934
+ "kind": "presence"
935
+ },
936
+ {
937
+ "name": "obscure-errors",
938
+ "description": "Hide unexpected errors from clients.",
939
+ "kind": "presence"
940
+ },
941
+ {
942
+ "name": "log-format",
943
+ "description": "Log format: json (ECS Logging) or text.",
944
+ "kind": "enum",
945
+ "choices": [
946
+ "json",
947
+ "text"
948
+ ]
949
+ },
950
+ {
951
+ "name": "log-file",
952
+ "description": "Append logs to this file (relative → app config dir).",
953
+ "kind": "string"
954
+ },
955
+ {
956
+ "name": "no-access-log",
957
+ "description": "Disable HTTP access logs.",
958
+ "kind": "presence"
959
+ },
960
+ {
961
+ "name": "dev",
962
+ "description": "Print full stacks to stderr on errors.",
963
+ "kind": "presence"
964
+ }
965
+ ],
966
+ "fallbackCommand": "serve",
967
+ "fallbackMode": "missingOnly"
968
+ }
969
+ ]
970
+ },
971
+ {
972
+ "key": "post",
973
+ "description": "Create a workspace.",
974
+ "commands": [
975
+ {
976
+ "key": "version",
977
+ "description": "Print the program version."
978
+ },
979
+ {
980
+ "key": "configure",
981
+ "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
982
+ "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-json configure --sync --yes\n\nInteractive setup (per target):\n full-example-json configure\n\nUpgrade:\n brew upgrade full-example-json\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 brew uninstall <tap>/full-example-json\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.",
983
+ "options": [
984
+ {
985
+ "name": "sync",
986
+ "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
987
+ "kind": "presence"
988
+ },
989
+ {
990
+ "name": "remove-all",
991
+ "description": "Remove all detected agent artifacts (skills and MCP).",
992
+ "kind": "presence"
993
+ },
994
+ {
995
+ "name": "status",
996
+ "description": "Print what is currently installed (read-only).",
997
+ "kind": "presence"
998
+ },
999
+ {
1000
+ "name": "yes",
1001
+ "description": "Skip confirmation (required for --sync, --remove-all, --remove-config).",
1002
+ "kind": "presence",
1003
+ "shortName": "y"
1004
+ },
1005
+ {
1006
+ "name": "dry",
1007
+ "description": "Show what would change without writing files.",
1008
+ "kind": "presence"
1009
+ },
1010
+ {
1011
+ "name": "json",
1012
+ "description": "Print changed paths or status JSON on stdout.",
1013
+ "kind": "presence"
1014
+ }
1015
+ ],
1016
+ "fallbackCommand": "run",
1017
+ "fallbackMode": "missingOnly"
1018
+ },
1019
+ {
1020
+ "key": "docs",
1021
+ "description": "Print bundled CLI documentation.",
1022
+ "notes": "Topics print to stdout. Add --save to write files under ./docs/.",
1023
+ "options": [
1024
+ {
1025
+ "name": "save",
1026
+ "description": "Write documentation to ./docs/.",
1027
+ "kind": "presence"
1028
+ }
1029
+ ],
1030
+ "commands": [
1031
+ {
1032
+ "key": "readme",
1033
+ "description": "Print README (user guide).",
1034
+ "options": [
1035
+ {
1036
+ "name": "save",
1037
+ "description": "Write documentation to ./docs/.",
1038
+ "kind": "presence"
1039
+ }
1040
+ ]
1041
+ },
1042
+ {
1043
+ "key": "mcp",
1044
+ "description": "Print MCP server setup and tool guidance.",
1045
+ "options": [
1046
+ {
1047
+ "name": "save",
1048
+ "description": "Write documentation to ./docs/.",
1049
+ "kind": "presence"
1050
+ }
1051
+ ]
1052
+ },
1053
+ {
1054
+ "key": "http",
1055
+ "description": "Print HTTP API setup and tool guidance.",
1056
+ "options": [
1057
+ {
1058
+ "name": "save",
1059
+ "description": "Write documentation to ./docs/.",
1060
+ "kind": "presence"
1061
+ }
1062
+ ]
1063
+ },
1064
+ {
1065
+ "key": "openapi",
1066
+ "description": "Print the HTTP OpenAPI 3.1 document as JSON.",
1067
+ "options": [
1068
+ {
1069
+ "name": "save",
1070
+ "description": "Write documentation to ./docs/.",
1071
+ "kind": "presence"
1072
+ }
1073
+ ]
1074
+ },
1075
+ {
1076
+ "key": "cli-schema",
1077
+ "description": "Print the full CLI command tree as JSON.",
1078
+ "options": [
1079
+ {
1080
+ "name": "save",
1081
+ "description": "Write documentation to ./docs/.",
1082
+ "kind": "presence"
1083
+ }
1084
+ ]
1085
+ },
1086
+ {
1087
+ "key": "cli",
1088
+ "description": "Print the full command reference as markdown.",
1089
+ "options": [
1090
+ {
1091
+ "name": "save",
1092
+ "description": "Write documentation to ./docs/.",
1093
+ "kind": "presence"
1094
+ }
1095
+ ]
1096
+ },
1097
+ {
1098
+ "key": "skill",
1099
+ "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
1100
+ "options": [
1101
+ {
1102
+ "name": "save",
1103
+ "description": "Write documentation to ./docs/.",
1104
+ "kind": "presence"
1105
+ }
1106
+ ]
1107
+ }
1108
+ ]
1109
+ },
1110
+ {
1111
+ "key": "mcp",
1112
+ "description": "MCP server and bundle tools.",
1113
+ "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",
1114
+ "options": [
1115
+ {
1116
+ "name": "obscure-errors",
1117
+ "description": "Hide unexpected errors from clients.",
1118
+ "kind": "presence"
1119
+ },
1120
+ {
1121
+ "name": "log-format",
1122
+ "description": "Log format: json (ECS Logging) or text.",
1123
+ "kind": "enum",
1124
+ "choices": [
1125
+ "json",
1126
+ "text"
1127
+ ]
1128
+ },
1129
+ {
1130
+ "name": "log-file",
1131
+ "description": "Append logs to this file (relative → app config dir).",
1132
+ "kind": "string"
1133
+ },
1134
+ {
1135
+ "name": "dev",
1136
+ "description": "Print full stacks to stderr on errors.",
1137
+ "kind": "presence"
1138
+ }
1139
+ ],
1140
+ "fallbackCommand": "serve",
1141
+ "fallbackMode": "missingOnly",
1142
+ "commands": [
1143
+ {
1144
+ "key": "bundle",
1145
+ "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>."
1146
+ }
1147
+ ]
1148
+ },
1149
+ {
1150
+ "key": "http",
1151
+ "description": "HTTP API server for tools.",
1152
+ "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",
1153
+ "options": [
1154
+ {
1155
+ "name": "host",
1156
+ "description": "Listen host.",
1157
+ "kind": "string"
1158
+ },
1159
+ {
1160
+ "name": "port",
1161
+ "description": "Listen port.",
1162
+ "kind": "number"
1163
+ },
1164
+ {
1165
+ "name": "trust-proxy",
1166
+ "description": "Honor X-Forwarded-For for client IP.",
1167
+ "kind": "presence"
1168
+ },
1169
+ {
1170
+ "name": "obscure-errors",
1171
+ "description": "Hide unexpected errors from clients.",
1172
+ "kind": "presence"
1173
+ },
1174
+ {
1175
+ "name": "log-format",
1176
+ "description": "Log format: json (ECS Logging) or text.",
1177
+ "kind": "enum",
1178
+ "choices": [
1179
+ "json",
1180
+ "text"
1181
+ ]
1182
+ },
1183
+ {
1184
+ "name": "log-file",
1185
+ "description": "Append logs to this file (relative → app config dir).",
1186
+ "kind": "string"
1187
+ },
1188
+ {
1189
+ "name": "no-access-log",
1190
+ "description": "Disable HTTP access logs.",
1191
+ "kind": "presence"
1192
+ },
1193
+ {
1194
+ "name": "dev",
1195
+ "description": "Print full stacks to stderr on errors.",
1196
+ "kind": "presence"
1197
+ }
1198
+ ],
1199
+ "fallbackCommand": "serve",
1200
+ "fallbackMode": "missingOnly"
1201
+ }
1202
+ ]
1203
+ },
1204
+ {
1205
+ "key": ":id",
1206
+ "description": "One workspace by id.",
1207
+ "commands": [
1208
+ {
1209
+ "key": "get",
1210
+ "description": "Get one workspace.",
1211
+ "commands": [
1212
+ {
1213
+ "key": "version",
1214
+ "description": "Print the program version."
1215
+ },
1216
+ {
1217
+ "key": "configure",
1218
+ "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
1219
+ "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-json configure --sync --yes\n\nInteractive setup (per target):\n full-example-json configure\n\nUpgrade:\n brew upgrade full-example-json\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 brew uninstall <tap>/full-example-json\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.",
1220
+ "options": [
1221
+ {
1222
+ "name": "sync",
1223
+ "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
1224
+ "kind": "presence"
1225
+ },
1226
+ {
1227
+ "name": "remove-all",
1228
+ "description": "Remove all detected agent artifacts (skills and MCP).",
1229
+ "kind": "presence"
1230
+ },
1231
+ {
1232
+ "name": "status",
1233
+ "description": "Print what is currently installed (read-only).",
1234
+ "kind": "presence"
1235
+ },
1236
+ {
1237
+ "name": "yes",
1238
+ "description": "Skip confirmation (required for --sync, --remove-all, --remove-config).",
1239
+ "kind": "presence",
1240
+ "shortName": "y"
1241
+ },
1242
+ {
1243
+ "name": "dry",
1244
+ "description": "Show what would change without writing files.",
1245
+ "kind": "presence"
1246
+ },
1247
+ {
1248
+ "name": "json",
1249
+ "description": "Print changed paths or status JSON on stdout.",
1250
+ "kind": "presence"
1251
+ }
1252
+ ],
1253
+ "fallbackCommand": "run",
1254
+ "fallbackMode": "missingOnly"
1255
+ },
1256
+ {
1257
+ "key": "docs",
1258
+ "description": "Print bundled CLI documentation.",
1259
+ "notes": "Topics print to stdout. Add --save to write files under ./docs/.",
1260
+ "options": [
1261
+ {
1262
+ "name": "save",
1263
+ "description": "Write documentation to ./docs/.",
1264
+ "kind": "presence"
1265
+ }
1266
+ ],
1267
+ "commands": [
1268
+ {
1269
+ "key": "readme",
1270
+ "description": "Print README (user guide).",
1271
+ "options": [
1272
+ {
1273
+ "name": "save",
1274
+ "description": "Write documentation to ./docs/.",
1275
+ "kind": "presence"
1276
+ }
1277
+ ]
1278
+ },
1279
+ {
1280
+ "key": "mcp",
1281
+ "description": "Print MCP server setup and tool guidance.",
1282
+ "options": [
1283
+ {
1284
+ "name": "save",
1285
+ "description": "Write documentation to ./docs/.",
1286
+ "kind": "presence"
1287
+ }
1288
+ ]
1289
+ },
1290
+ {
1291
+ "key": "http",
1292
+ "description": "Print HTTP API setup and tool guidance.",
1293
+ "options": [
1294
+ {
1295
+ "name": "save",
1296
+ "description": "Write documentation to ./docs/.",
1297
+ "kind": "presence"
1298
+ }
1299
+ ]
1300
+ },
1301
+ {
1302
+ "key": "openapi",
1303
+ "description": "Print the HTTP OpenAPI 3.1 document as JSON.",
1304
+ "options": [
1305
+ {
1306
+ "name": "save",
1307
+ "description": "Write documentation to ./docs/.",
1308
+ "kind": "presence"
1309
+ }
1310
+ ]
1311
+ },
1312
+ {
1313
+ "key": "cli-schema",
1314
+ "description": "Print the full CLI command tree as JSON.",
1315
+ "options": [
1316
+ {
1317
+ "name": "save",
1318
+ "description": "Write documentation to ./docs/.",
1319
+ "kind": "presence"
1320
+ }
1321
+ ]
1322
+ },
1323
+ {
1324
+ "key": "cli",
1325
+ "description": "Print the full command reference as markdown.",
1326
+ "options": [
1327
+ {
1328
+ "name": "save",
1329
+ "description": "Write documentation to ./docs/.",
1330
+ "kind": "presence"
1331
+ }
1332
+ ]
1333
+ },
1334
+ {
1335
+ "key": "skill",
1336
+ "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
1337
+ "options": [
1338
+ {
1339
+ "name": "save",
1340
+ "description": "Write documentation to ./docs/.",
1341
+ "kind": "presence"
1342
+ }
1343
+ ]
1344
+ }
1345
+ ]
1346
+ },
1347
+ {
1348
+ "key": "mcp",
1349
+ "description": "MCP server and bundle tools.",
1350
+ "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",
1351
+ "options": [
1352
+ {
1353
+ "name": "obscure-errors",
1354
+ "description": "Hide unexpected errors from clients.",
1355
+ "kind": "presence"
1356
+ },
1357
+ {
1358
+ "name": "log-format",
1359
+ "description": "Log format: json (ECS Logging) or text.",
1360
+ "kind": "enum",
1361
+ "choices": [
1362
+ "json",
1363
+ "text"
1364
+ ]
1365
+ },
1366
+ {
1367
+ "name": "log-file",
1368
+ "description": "Append logs to this file (relative → app config dir).",
1369
+ "kind": "string"
1370
+ },
1371
+ {
1372
+ "name": "dev",
1373
+ "description": "Print full stacks to stderr on errors.",
1374
+ "kind": "presence"
1375
+ }
1376
+ ],
1377
+ "fallbackCommand": "serve",
1378
+ "fallbackMode": "missingOnly",
1379
+ "commands": [
1380
+ {
1381
+ "key": "bundle",
1382
+ "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>."
1383
+ }
1384
+ ]
1385
+ },
1386
+ {
1387
+ "key": "http",
1388
+ "description": "HTTP API server for tools.",
1389
+ "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",
1390
+ "options": [
1391
+ {
1392
+ "name": "host",
1393
+ "description": "Listen host.",
1394
+ "kind": "string"
1395
+ },
1396
+ {
1397
+ "name": "port",
1398
+ "description": "Listen port.",
1399
+ "kind": "number"
1400
+ },
1401
+ {
1402
+ "name": "trust-proxy",
1403
+ "description": "Honor X-Forwarded-For for client IP.",
1404
+ "kind": "presence"
1405
+ },
1406
+ {
1407
+ "name": "obscure-errors",
1408
+ "description": "Hide unexpected errors from clients.",
1409
+ "kind": "presence"
1410
+ },
1411
+ {
1412
+ "name": "log-format",
1413
+ "description": "Log format: json (ECS Logging) or text.",
1414
+ "kind": "enum",
1415
+ "choices": [
1416
+ "json",
1417
+ "text"
1418
+ ]
1419
+ },
1420
+ {
1421
+ "name": "log-file",
1422
+ "description": "Append logs to this file (relative → app config dir).",
1423
+ "kind": "string"
1424
+ },
1425
+ {
1426
+ "name": "no-access-log",
1427
+ "description": "Disable HTTP access logs.",
1428
+ "kind": "presence"
1429
+ },
1430
+ {
1431
+ "name": "dev",
1432
+ "description": "Print full stacks to stderr on errors.",
1433
+ "kind": "presence"
1434
+ }
1435
+ ],
1436
+ "fallbackCommand": "serve",
1437
+ "fallbackMode": "missingOnly"
1438
+ }
1439
+ ]
1440
+ },
1441
+ {
1442
+ "key": "put",
1443
+ "description": "Replace a workspace.",
1444
+ "commands": [
1445
+ {
1446
+ "key": "version",
1447
+ "description": "Print the program version."
1448
+ },
1449
+ {
1450
+ "key": "configure",
1451
+ "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
1452
+ "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-json configure --sync --yes\n\nInteractive setup (per target):\n full-example-json configure\n\nUpgrade:\n brew upgrade full-example-json\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 brew uninstall <tap>/full-example-json\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.",
1453
+ "options": [
1454
+ {
1455
+ "name": "sync",
1456
+ "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
1457
+ "kind": "presence"
1458
+ },
1459
+ {
1460
+ "name": "remove-all",
1461
+ "description": "Remove all detected agent artifacts (skills and MCP).",
1462
+ "kind": "presence"
1463
+ },
1464
+ {
1465
+ "name": "status",
1466
+ "description": "Print what is currently installed (read-only).",
1467
+ "kind": "presence"
1468
+ },
1469
+ {
1470
+ "name": "yes",
1471
+ "description": "Skip confirmation (required for --sync, --remove-all, --remove-config).",
1472
+ "kind": "presence",
1473
+ "shortName": "y"
1474
+ },
1475
+ {
1476
+ "name": "dry",
1477
+ "description": "Show what would change without writing files.",
1478
+ "kind": "presence"
1479
+ },
1480
+ {
1481
+ "name": "json",
1482
+ "description": "Print changed paths or status JSON on stdout.",
1483
+ "kind": "presence"
1484
+ }
1485
+ ],
1486
+ "fallbackCommand": "run",
1487
+ "fallbackMode": "missingOnly"
1488
+ },
1489
+ {
1490
+ "key": "docs",
1491
+ "description": "Print bundled CLI documentation.",
1492
+ "notes": "Topics print to stdout. Add --save to write files under ./docs/.",
1493
+ "options": [
1494
+ {
1495
+ "name": "save",
1496
+ "description": "Write documentation to ./docs/.",
1497
+ "kind": "presence"
1498
+ }
1499
+ ],
1500
+ "commands": [
1501
+ {
1502
+ "key": "readme",
1503
+ "description": "Print README (user guide).",
1504
+ "options": [
1505
+ {
1506
+ "name": "save",
1507
+ "description": "Write documentation to ./docs/.",
1508
+ "kind": "presence"
1509
+ }
1510
+ ]
1511
+ },
1512
+ {
1513
+ "key": "mcp",
1514
+ "description": "Print MCP server setup and tool guidance.",
1515
+ "options": [
1516
+ {
1517
+ "name": "save",
1518
+ "description": "Write documentation to ./docs/.",
1519
+ "kind": "presence"
1520
+ }
1521
+ ]
1522
+ },
1523
+ {
1524
+ "key": "http",
1525
+ "description": "Print HTTP API setup and tool guidance.",
1526
+ "options": [
1527
+ {
1528
+ "name": "save",
1529
+ "description": "Write documentation to ./docs/.",
1530
+ "kind": "presence"
1531
+ }
1532
+ ]
1533
+ },
1534
+ {
1535
+ "key": "openapi",
1536
+ "description": "Print the HTTP OpenAPI 3.1 document as JSON.",
1537
+ "options": [
1538
+ {
1539
+ "name": "save",
1540
+ "description": "Write documentation to ./docs/.",
1541
+ "kind": "presence"
1542
+ }
1543
+ ]
1544
+ },
1545
+ {
1546
+ "key": "cli-schema",
1547
+ "description": "Print the full CLI command tree as JSON.",
1548
+ "options": [
1549
+ {
1550
+ "name": "save",
1551
+ "description": "Write documentation to ./docs/.",
1552
+ "kind": "presence"
1553
+ }
1554
+ ]
1555
+ },
1556
+ {
1557
+ "key": "cli",
1558
+ "description": "Print the full command reference as markdown.",
1559
+ "options": [
1560
+ {
1561
+ "name": "save",
1562
+ "description": "Write documentation to ./docs/.",
1563
+ "kind": "presence"
1564
+ }
1565
+ ]
1566
+ },
1567
+ {
1568
+ "key": "skill",
1569
+ "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
1570
+ "options": [
1571
+ {
1572
+ "name": "save",
1573
+ "description": "Write documentation to ./docs/.",
1574
+ "kind": "presence"
1575
+ }
1576
+ ]
1577
+ }
1578
+ ]
1579
+ },
1580
+ {
1581
+ "key": "mcp",
1582
+ "description": "MCP server and bundle tools.",
1583
+ "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",
1584
+ "options": [
1585
+ {
1586
+ "name": "obscure-errors",
1587
+ "description": "Hide unexpected errors from clients.",
1588
+ "kind": "presence"
1589
+ },
1590
+ {
1591
+ "name": "log-format",
1592
+ "description": "Log format: json (ECS Logging) or text.",
1593
+ "kind": "enum",
1594
+ "choices": [
1595
+ "json",
1596
+ "text"
1597
+ ]
1598
+ },
1599
+ {
1600
+ "name": "log-file",
1601
+ "description": "Append logs to this file (relative → app config dir).",
1602
+ "kind": "string"
1603
+ },
1604
+ {
1605
+ "name": "dev",
1606
+ "description": "Print full stacks to stderr on errors.",
1607
+ "kind": "presence"
1608
+ }
1609
+ ],
1610
+ "fallbackCommand": "serve",
1611
+ "fallbackMode": "missingOnly",
1612
+ "commands": [
1613
+ {
1614
+ "key": "bundle",
1615
+ "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>."
1616
+ }
1617
+ ]
1618
+ },
1619
+ {
1620
+ "key": "http",
1621
+ "description": "HTTP API server for tools.",
1622
+ "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",
1623
+ "options": [
1624
+ {
1625
+ "name": "host",
1626
+ "description": "Listen host.",
1627
+ "kind": "string"
1628
+ },
1629
+ {
1630
+ "name": "port",
1631
+ "description": "Listen port.",
1632
+ "kind": "number"
1633
+ },
1634
+ {
1635
+ "name": "trust-proxy",
1636
+ "description": "Honor X-Forwarded-For for client IP.",
1637
+ "kind": "presence"
1638
+ },
1639
+ {
1640
+ "name": "obscure-errors",
1641
+ "description": "Hide unexpected errors from clients.",
1642
+ "kind": "presence"
1643
+ },
1644
+ {
1645
+ "name": "log-format",
1646
+ "description": "Log format: json (ECS Logging) or text.",
1647
+ "kind": "enum",
1648
+ "choices": [
1649
+ "json",
1650
+ "text"
1651
+ ]
1652
+ },
1653
+ {
1654
+ "name": "log-file",
1655
+ "description": "Append logs to this file (relative → app config dir).",
1656
+ "kind": "string"
1657
+ },
1658
+ {
1659
+ "name": "no-access-log",
1660
+ "description": "Disable HTTP access logs.",
1661
+ "kind": "presence"
1662
+ },
1663
+ {
1664
+ "name": "dev",
1665
+ "description": "Print full stacks to stderr on errors.",
1666
+ "kind": "presence"
1667
+ }
1668
+ ],
1669
+ "fallbackCommand": "serve",
1670
+ "fallbackMode": "missingOnly"
1671
+ }
1672
+ ]
1673
+ },
1674
+ {
1675
+ "key": "patch",
1676
+ "description": "Patch a workspace name.",
1677
+ "commands": [
1678
+ {
1679
+ "key": "version",
1680
+ "description": "Print the program version."
1681
+ },
1682
+ {
1683
+ "key": "configure",
1684
+ "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
1685
+ "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-json configure --sync --yes\n\nInteractive setup (per target):\n full-example-json configure\n\nUpgrade:\n brew upgrade full-example-json\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 brew uninstall <tap>/full-example-json\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.",
1686
+ "options": [
1687
+ {
1688
+ "name": "sync",
1689
+ "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
1690
+ "kind": "presence"
1691
+ },
1692
+ {
1693
+ "name": "remove-all",
1694
+ "description": "Remove all detected agent artifacts (skills and MCP).",
1695
+ "kind": "presence"
1696
+ },
1697
+ {
1698
+ "name": "status",
1699
+ "description": "Print what is currently installed (read-only).",
1700
+ "kind": "presence"
1701
+ },
1702
+ {
1703
+ "name": "yes",
1704
+ "description": "Skip confirmation (required for --sync, --remove-all, --remove-config).",
1705
+ "kind": "presence",
1706
+ "shortName": "y"
1707
+ },
1708
+ {
1709
+ "name": "dry",
1710
+ "description": "Show what would change without writing files.",
1711
+ "kind": "presence"
1712
+ },
1713
+ {
1714
+ "name": "json",
1715
+ "description": "Print changed paths or status JSON on stdout.",
1716
+ "kind": "presence"
1717
+ }
1718
+ ],
1719
+ "fallbackCommand": "run",
1720
+ "fallbackMode": "missingOnly"
1721
+ },
1722
+ {
1723
+ "key": "docs",
1724
+ "description": "Print bundled CLI documentation.",
1725
+ "notes": "Topics print to stdout. Add --save to write files under ./docs/.",
1726
+ "options": [
1727
+ {
1728
+ "name": "save",
1729
+ "description": "Write documentation to ./docs/.",
1730
+ "kind": "presence"
1731
+ }
1732
+ ],
1733
+ "commands": [
1734
+ {
1735
+ "key": "readme",
1736
+ "description": "Print README (user guide).",
1737
+ "options": [
1738
+ {
1739
+ "name": "save",
1740
+ "description": "Write documentation to ./docs/.",
1741
+ "kind": "presence"
1742
+ }
1743
+ ]
1744
+ },
1745
+ {
1746
+ "key": "mcp",
1747
+ "description": "Print MCP server setup and tool guidance.",
1748
+ "options": [
1749
+ {
1750
+ "name": "save",
1751
+ "description": "Write documentation to ./docs/.",
1752
+ "kind": "presence"
1753
+ }
1754
+ ]
1755
+ },
1756
+ {
1757
+ "key": "http",
1758
+ "description": "Print HTTP API setup and tool guidance.",
1759
+ "options": [
1760
+ {
1761
+ "name": "save",
1762
+ "description": "Write documentation to ./docs/.",
1763
+ "kind": "presence"
1764
+ }
1765
+ ]
1766
+ },
1767
+ {
1768
+ "key": "openapi",
1769
+ "description": "Print the HTTP OpenAPI 3.1 document as JSON.",
1770
+ "options": [
1771
+ {
1772
+ "name": "save",
1773
+ "description": "Write documentation to ./docs/.",
1774
+ "kind": "presence"
1775
+ }
1776
+ ]
1777
+ },
1778
+ {
1779
+ "key": "cli-schema",
1780
+ "description": "Print the full CLI command tree as JSON.",
1781
+ "options": [
1782
+ {
1783
+ "name": "save",
1784
+ "description": "Write documentation to ./docs/.",
1785
+ "kind": "presence"
1786
+ }
1787
+ ]
1788
+ },
1789
+ {
1790
+ "key": "cli",
1791
+ "description": "Print the full command reference as markdown.",
1792
+ "options": [
1793
+ {
1794
+ "name": "save",
1795
+ "description": "Write documentation to ./docs/.",
1796
+ "kind": "presence"
1797
+ }
1798
+ ]
1799
+ },
1800
+ {
1801
+ "key": "skill",
1802
+ "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
1803
+ "options": [
1804
+ {
1805
+ "name": "save",
1806
+ "description": "Write documentation to ./docs/.",
1807
+ "kind": "presence"
1808
+ }
1809
+ ]
1810
+ }
1811
+ ]
1812
+ },
1813
+ {
1814
+ "key": "mcp",
1815
+ "description": "MCP server and bundle tools.",
1816
+ "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",
1817
+ "options": [
1818
+ {
1819
+ "name": "obscure-errors",
1820
+ "description": "Hide unexpected errors from clients.",
1821
+ "kind": "presence"
1822
+ },
1823
+ {
1824
+ "name": "log-format",
1825
+ "description": "Log format: json (ECS Logging) or text.",
1826
+ "kind": "enum",
1827
+ "choices": [
1828
+ "json",
1829
+ "text"
1830
+ ]
1831
+ },
1832
+ {
1833
+ "name": "log-file",
1834
+ "description": "Append logs to this file (relative → app config dir).",
1835
+ "kind": "string"
1836
+ },
1837
+ {
1838
+ "name": "dev",
1839
+ "description": "Print full stacks to stderr on errors.",
1840
+ "kind": "presence"
1841
+ }
1842
+ ],
1843
+ "fallbackCommand": "serve",
1844
+ "fallbackMode": "missingOnly",
1845
+ "commands": [
1846
+ {
1847
+ "key": "bundle",
1848
+ "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>."
1849
+ }
1850
+ ]
1851
+ },
1852
+ {
1853
+ "key": "http",
1854
+ "description": "HTTP API server for tools.",
1855
+ "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",
1856
+ "options": [
1857
+ {
1858
+ "name": "host",
1859
+ "description": "Listen host.",
1860
+ "kind": "string"
1861
+ },
1862
+ {
1863
+ "name": "port",
1864
+ "description": "Listen port.",
1865
+ "kind": "number"
1866
+ },
1867
+ {
1868
+ "name": "trust-proxy",
1869
+ "description": "Honor X-Forwarded-For for client IP.",
1870
+ "kind": "presence"
1871
+ },
1872
+ {
1873
+ "name": "obscure-errors",
1874
+ "description": "Hide unexpected errors from clients.",
1875
+ "kind": "presence"
1876
+ },
1877
+ {
1878
+ "name": "log-format",
1879
+ "description": "Log format: json (ECS Logging) or text.",
1880
+ "kind": "enum",
1881
+ "choices": [
1882
+ "json",
1883
+ "text"
1884
+ ]
1885
+ },
1886
+ {
1887
+ "name": "log-file",
1888
+ "description": "Append logs to this file (relative → app config dir).",
1889
+ "kind": "string"
1890
+ },
1891
+ {
1892
+ "name": "no-access-log",
1893
+ "description": "Disable HTTP access logs.",
1894
+ "kind": "presence"
1895
+ },
1896
+ {
1897
+ "name": "dev",
1898
+ "description": "Print full stacks to stderr on errors.",
1899
+ "kind": "presence"
1900
+ }
1901
+ ],
1902
+ "fallbackCommand": "serve",
1903
+ "fallbackMode": "missingOnly"
1904
+ }
1905
+ ]
1906
+ },
1907
+ {
1908
+ "key": "delete",
1909
+ "description": "Delete a workspace.",
1910
+ "commands": [
1911
+ {
1912
+ "key": "version",
1913
+ "description": "Print the program version."
1914
+ },
1915
+ {
1916
+ "key": "configure",
1917
+ "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
1918
+ "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-json configure --sync --yes\n\nInteractive setup (per target):\n full-example-json configure\n\nUpgrade:\n brew upgrade full-example-json\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 brew uninstall <tap>/full-example-json\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.",
1919
+ "options": [
1920
+ {
1921
+ "name": "sync",
1922
+ "description": "Refresh installed skills and MCP. Used by Homebrew post_install.",
1923
+ "kind": "presence"
1924
+ },
1925
+ {
1926
+ "name": "remove-all",
1927
+ "description": "Remove all detected agent artifacts (skills and MCP).",
1928
+ "kind": "presence"
1929
+ },
1930
+ {
1931
+ "name": "status",
1932
+ "description": "Print what is currently installed (read-only).",
1933
+ "kind": "presence"
1934
+ },
1935
+ {
1936
+ "name": "yes",
1937
+ "description": "Skip confirmation (required for --sync, --remove-all, --remove-config).",
1938
+ "kind": "presence",
1939
+ "shortName": "y"
1940
+ },
1941
+ {
1942
+ "name": "dry",
1943
+ "description": "Show what would change without writing files.",
1944
+ "kind": "presence"
1945
+ },
1946
+ {
1947
+ "name": "json",
1948
+ "description": "Print changed paths or status JSON on stdout.",
1949
+ "kind": "presence"
1950
+ }
1951
+ ],
1952
+ "fallbackCommand": "run",
1953
+ "fallbackMode": "missingOnly"
1954
+ },
1955
+ {
1956
+ "key": "docs",
1957
+ "description": "Print bundled CLI documentation.",
1958
+ "notes": "Topics print to stdout. Add --save to write files under ./docs/.",
1959
+ "options": [
1960
+ {
1961
+ "name": "save",
1962
+ "description": "Write documentation to ./docs/.",
1963
+ "kind": "presence"
1964
+ }
1965
+ ],
1966
+ "commands": [
1967
+ {
1968
+ "key": "readme",
1969
+ "description": "Print README (user guide).",
1970
+ "options": [
1971
+ {
1972
+ "name": "save",
1973
+ "description": "Write documentation to ./docs/.",
1974
+ "kind": "presence"
1975
+ }
1976
+ ]
1977
+ },
1978
+ {
1979
+ "key": "mcp",
1980
+ "description": "Print MCP server setup and tool guidance.",
1981
+ "options": [
1982
+ {
1983
+ "name": "save",
1984
+ "description": "Write documentation to ./docs/.",
1985
+ "kind": "presence"
1986
+ }
1987
+ ]
1988
+ },
1989
+ {
1990
+ "key": "http",
1991
+ "description": "Print HTTP API setup and tool guidance.",
1992
+ "options": [
1993
+ {
1994
+ "name": "save",
1995
+ "description": "Write documentation to ./docs/.",
1996
+ "kind": "presence"
1997
+ }
1998
+ ]
1999
+ },
2000
+ {
2001
+ "key": "openapi",
2002
+ "description": "Print the HTTP OpenAPI 3.1 document as JSON.",
2003
+ "options": [
2004
+ {
2005
+ "name": "save",
2006
+ "description": "Write documentation to ./docs/.",
2007
+ "kind": "presence"
2008
+ }
2009
+ ]
2010
+ },
2011
+ {
2012
+ "key": "cli-schema",
2013
+ "description": "Print the full CLI command tree as JSON.",
2014
+ "options": [
2015
+ {
2016
+ "name": "save",
2017
+ "description": "Write documentation to ./docs/.",
2018
+ "kind": "presence"
2019
+ }
2020
+ ]
2021
+ },
2022
+ {
2023
+ "key": "cli",
2024
+ "description": "Print the full command reference as markdown.",
2025
+ "options": [
2026
+ {
2027
+ "name": "save",
2028
+ "description": "Write documentation to ./docs/.",
2029
+ "kind": "presence"
2030
+ }
2031
+ ]
2032
+ },
2033
+ {
2034
+ "key": "skill",
2035
+ "description": "Print a reference agent SKILL; run `configure` to install an optimized copy.",
2036
+ "options": [
2037
+ {
2038
+ "name": "save",
2039
+ "description": "Write documentation to ./docs/.",
2040
+ "kind": "presence"
2041
+ }
2042
+ ]
2043
+ }
2044
+ ]
2045
+ },
2046
+ {
2047
+ "key": "mcp",
2048
+ "description": "MCP server and bundle tools.",
2049
+ "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",
2050
+ "options": [
2051
+ {
2052
+ "name": "obscure-errors",
2053
+ "description": "Hide unexpected errors from clients.",
2054
+ "kind": "presence"
2055
+ },
2056
+ {
2057
+ "name": "log-format",
2058
+ "description": "Log format: json (ECS Logging) or text.",
2059
+ "kind": "enum",
2060
+ "choices": [
2061
+ "json",
2062
+ "text"
2063
+ ]
2064
+ },
2065
+ {
2066
+ "name": "log-file",
2067
+ "description": "Append logs to this file (relative → app config dir).",
2068
+ "kind": "string"
2069
+ },
2070
+ {
2071
+ "name": "dev",
2072
+ "description": "Print full stacks to stderr on errors.",
2073
+ "kind": "presence"
2074
+ }
2075
+ ],
2076
+ "fallbackCommand": "serve",
2077
+ "fallbackMode": "missingOnly",
2078
+ "commands": [
2079
+ {
2080
+ "key": "bundle",
2081
+ "description": "Pack dist MCP artifacts (`.mcpb`, Claude Code plugin zip) from dist/<key>."
2082
+ }
2083
+ ]
2084
+ },
2085
+ {
2086
+ "key": "http",
2087
+ "description": "HTTP API server for tools.",
2088
+ "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",
2089
+ "options": [
2090
+ {
2091
+ "name": "host",
2092
+ "description": "Listen host.",
2093
+ "kind": "string"
2094
+ },
2095
+ {
2096
+ "name": "port",
2097
+ "description": "Listen port.",
2098
+ "kind": "number"
2099
+ },
2100
+ {
2101
+ "name": "trust-proxy",
2102
+ "description": "Honor X-Forwarded-For for client IP.",
2103
+ "kind": "presence"
2104
+ },
2105
+ {
2106
+ "name": "obscure-errors",
2107
+ "description": "Hide unexpected errors from clients.",
2108
+ "kind": "presence"
2109
+ },
2110
+ {
2111
+ "name": "log-format",
2112
+ "description": "Log format: json (ECS Logging) or text.",
2113
+ "kind": "enum",
2114
+ "choices": [
2115
+ "json",
2116
+ "text"
2117
+ ]
2118
+ },
2119
+ {
2120
+ "name": "log-file",
2121
+ "description": "Append logs to this file (relative → app config dir).",
2122
+ "kind": "string"
2123
+ },
2124
+ {
2125
+ "name": "no-access-log",
2126
+ "description": "Disable HTTP access logs.",
2127
+ "kind": "presence"
2128
+ },
2129
+ {
2130
+ "name": "dev",
2131
+ "description": "Print full stacks to stderr on errors.",
2132
+ "kind": "presence"
2133
+ }
2134
+ ],
2135
+ "fallbackCommand": "serve",
2136
+ "fallbackMode": "missingOnly"
2137
+ }
2138
+ ]
2139
+ }
2140
+ ]
2141
+ }
2142
+ ]
2143
+ }
2144
+ ]
2145
+ }