argsbarg 7.0.8 → 7.0.10

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 (30) hide show
  1. package/CHANGELOG.md +22 -3
  2. package/docs/cli-program.md +22 -7
  3. package/examples/full-example/docs/cli-schema.json +20 -24
  4. package/examples/full-example/docs/cli.md +4 -26
  5. package/examples/full-example/docs/openapi.json +3 -1
  6. package/examples/full-example-json/docs/cli-schema.json +102 -108
  7. package/examples/full-example-json/docs/cli.md +18 -117
  8. package/examples/full-example-json/docs/openapi.json +3 -1
  9. package/index.d.ts +36 -6
  10. package/package.json +1 -1
  11. package/src/builtins/export.ts +2 -0
  12. package/src/core/document-leaf.test.ts +208 -0
  13. package/src/core/json-leaf.test.ts +26 -0
  14. package/src/core/leaf-inputs.ts +70 -15
  15. package/src/core/parse.ts +7 -6
  16. package/src/core/schema.ts +2 -0
  17. package/src/core/types.ts +19 -7
  18. package/src/core/validate.ts +6 -5
  19. package/src/core/wire-schema.test.ts +256 -0
  20. package/src/core/wire-schema.ts +131 -0
  21. package/src/docs/cli-guide.test.ts +53 -0
  22. package/src/exports/cli.ts +2 -0
  23. package/src/help.test.ts +40 -0
  24. package/src/help.ts +19 -15
  25. package/src/http/openapi.ts +4 -40
  26. package/src/http/routes.ts +2 -2
  27. package/src/http/server.ts +9 -1
  28. package/src/index.ts +3 -0
  29. package/src/mcp/tools.ts +17 -106
  30. package/src/test/integration/http.test.ts +36 -0
package/examples/full-example-json/docs/cli-schema.json CHANGED
@@ -13,6 +13,19 @@
13
13
  "required": true
14
14
  }
15
15
  ],
16
+ "inputSchema": {
17
+ "type": "object",
18
+ "properties": {
19
+ "message": {
20
+ "type": "string",
21
+ "description": "Text to print."
22
+ }
23
+ },
24
+ "additionalProperties": false,
25
+ "required": [
26
+ "message"
27
+ ]
28
+ },
16
29
  "commands": [
17
30
  {
18
31
  "key": "version",
@@ -20,7 +33,7 @@
20
33
  },
21
34
  {
22
35
  "key": "configure",
23
- "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
36
+ "description": "Set up MCP config for this app (binary via Homebrew).",
24
37
  "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n full-example-json configure install\n\nUpgrade:\n brew upgrade full-example-json\n full-example-json configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure status\n\nUninstall:\n full-example-json configure uninstall\n brew uninstall <tap>/full-example-json\n\nUse `configure status --json` for machine-readable output.",
25
38
  "commands": [
26
39
  {
@@ -129,17 +142,6 @@
129
142
  "kind": "presence"
130
143
  }
131
144
  ]
132
- },
133
- {
134
- "key": "skill",
135
- "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
136
- "options": [
137
- {
138
- "name": "save",
139
- "description": "Write documentation to ./docs/.",
140
- "kind": "presence"
141
- }
142
- ]
143
145
  }
144
146
  ]
145
147
  },
@@ -240,6 +242,21 @@
240
242
  {
241
243
  "key": "render-json",
242
244
  "description": "Echo a JSON message (schema-first JSON leaf demo).",
245
+ "inputSchema": {
246
+ "$schema": "http://json-schema.org/draft-07/schema#",
247
+ "type": "object",
248
+ "properties": {
249
+ "message": {
250
+ "type": "string",
251
+ "description": "Message to echo back."
252
+ }
253
+ },
254
+ "required": [
255
+ "message"
256
+ ],
257
+ "additionalProperties": false,
258
+ "definitions": {}
259
+ },
243
260
  "commands": [
244
261
  {
245
262
  "key": "version",
@@ -247,7 +264,7 @@
247
264
  },
248
265
  {
249
266
  "key": "configure",
250
- "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
267
+ "description": "Set up MCP config for this app (binary via Homebrew).",
251
268
  "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n full-example-json configure install\n\nUpgrade:\n brew upgrade full-example-json\n full-example-json configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure status\n\nUninstall:\n full-example-json configure uninstall\n brew uninstall <tap>/full-example-json\n\nUse `configure status --json` for machine-readable output.",
252
269
  "commands": [
253
270
  {
@@ -356,17 +373,6 @@
356
373
  "kind": "presence"
357
374
  }
358
375
  ]
359
- },
360
- {
361
- "key": "skill",
362
- "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
363
- "options": [
364
- {
365
- "name": "save",
366
- "description": "Write documentation to ./docs/.",
367
- "kind": "presence"
368
- }
369
- ]
370
376
  }
371
377
  ]
372
378
  },
@@ -474,6 +480,11 @@
474
480
  "kind": "presence"
475
481
  }
476
482
  ],
483
+ "inputSchema": {
484
+ "type": "object",
485
+ "properties": {},
486
+ "additionalProperties": false
487
+ },
477
488
  "outputSchema": {
478
489
  "$schema": "http://json-schema.org/draft-07/schema#",
479
490
  "type": "object",
@@ -496,7 +507,7 @@
496
507
  },
497
508
  {
498
509
  "key": "configure",
499
- "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
510
+ "description": "Set up MCP config for this app (binary via Homebrew).",
500
511
  "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n full-example-json configure install\n\nUpgrade:\n brew upgrade full-example-json\n full-example-json configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure status\n\nUninstall:\n full-example-json configure uninstall\n brew uninstall <tap>/full-example-json\n\nUse `configure status --json` for machine-readable output.",
501
512
  "commands": [
502
513
  {
@@ -605,17 +616,6 @@
605
616
  "kind": "presence"
606
617
  }
607
618
  ]
608
- },
609
- {
610
- "key": "skill",
611
- "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
612
- "options": [
613
- {
614
- "name": "save",
615
- "description": "Write documentation to ./docs/.",
616
- "kind": "presence"
617
- }
618
- ]
619
619
  }
620
620
  ]
621
621
  },
@@ -720,6 +720,11 @@
720
720
  {
721
721
  "key": "get",
722
722
  "description": "List workspaces.",
723
+ "inputSchema": {
724
+ "type": "object",
725
+ "properties": {},
726
+ "additionalProperties": false
727
+ },
723
728
  "commands": [
724
729
  {
725
730
  "key": "version",
@@ -727,7 +732,7 @@
727
732
  },
728
733
  {
729
734
  "key": "configure",
730
- "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
735
+ "description": "Set up MCP config for this app (binary via Homebrew).",
731
736
  "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n full-example-json configure install\n\nUpgrade:\n brew upgrade full-example-json\n full-example-json configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure status\n\nUninstall:\n full-example-json configure uninstall\n brew uninstall <tap>/full-example-json\n\nUse `configure status --json` for machine-readable output.",
732
737
  "commands": [
733
738
  {
@@ -836,17 +841,6 @@
836
841
  "kind": "presence"
837
842
  }
838
843
  ]
839
- },
840
- {
841
- "key": "skill",
842
- "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
843
- "options": [
844
- {
845
- "name": "save",
846
- "description": "Write documentation to ./docs/.",
847
- "kind": "presence"
848
- }
849
- ]
850
844
  }
851
845
  ]
852
846
  },
@@ -947,6 +941,21 @@
947
941
  {
948
942
  "key": "post",
949
943
  "description": "Create a workspace.",
944
+ "inputSchema": {
945
+ "$schema": "http://json-schema.org/draft-07/schema#",
946
+ "type": "object",
947
+ "properties": {
948
+ "name": {
949
+ "type": "string",
950
+ "description": "Workspace display name."
951
+ }
952
+ },
953
+ "required": [
954
+ "name"
955
+ ],
956
+ "additionalProperties": false,
957
+ "definitions": {}
958
+ },
950
959
  "commands": [
951
960
  {
952
961
  "key": "version",
@@ -954,7 +963,7 @@
954
963
  },
955
964
  {
956
965
  "key": "configure",
957
- "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
966
+ "description": "Set up MCP config for this app (binary via Homebrew).",
958
967
  "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n full-example-json configure install\n\nUpgrade:\n brew upgrade full-example-json\n full-example-json configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure status\n\nUninstall:\n full-example-json configure uninstall\n brew uninstall <tap>/full-example-json\n\nUse `configure status --json` for machine-readable output.",
959
968
  "commands": [
960
969
  {
@@ -1063,17 +1072,6 @@
1063
1072
  "kind": "presence"
1064
1073
  }
1065
1074
  ]
1066
- },
1067
- {
1068
- "key": "skill",
1069
- "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
1070
- "options": [
1071
- {
1072
- "name": "save",
1073
- "description": "Write documentation to ./docs/.",
1074
- "kind": "presence"
1075
- }
1076
- ]
1077
1075
  }
1078
1076
  ]
1079
1077
  },
@@ -1178,6 +1176,11 @@
1178
1176
  {
1179
1177
  "key": "get",
1180
1178
  "description": "Get one workspace.",
1179
+ "inputSchema": {
1180
+ "type": "object",
1181
+ "properties": {},
1182
+ "additionalProperties": false
1183
+ },
1181
1184
  "commands": [
1182
1185
  {
1183
1186
  "key": "version",
@@ -1185,7 +1188,7 @@
1185
1188
  },
1186
1189
  {
1187
1190
  "key": "configure",
1188
- "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
1191
+ "description": "Set up MCP config for this app (binary via Homebrew).",
1189
1192
  "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n full-example-json configure install\n\nUpgrade:\n brew upgrade full-example-json\n full-example-json configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure status\n\nUninstall:\n full-example-json configure uninstall\n brew uninstall <tap>/full-example-json\n\nUse `configure status --json` for machine-readable output.",
1190
1193
  "commands": [
1191
1194
  {
@@ -1294,17 +1297,6 @@
1294
1297
  "kind": "presence"
1295
1298
  }
1296
1299
  ]
1297
- },
1298
- {
1299
- "key": "skill",
1300
- "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
1301
- "options": [
1302
- {
1303
- "name": "save",
1304
- "description": "Write documentation to ./docs/.",
1305
- "kind": "presence"
1306
- }
1307
- ]
1308
1300
  }
1309
1301
  ]
1310
1302
  },
@@ -1405,6 +1397,21 @@
1405
1397
  {
1406
1398
  "key": "put",
1407
1399
  "description": "Replace a workspace.",
1400
+ "inputSchema": {
1401
+ "$schema": "http://json-schema.org/draft-07/schema#",
1402
+ "type": "object",
1403
+ "properties": {
1404
+ "name": {
1405
+ "type": "string",
1406
+ "description": "Workspace display name."
1407
+ }
1408
+ },
1409
+ "required": [
1410
+ "name"
1411
+ ],
1412
+ "additionalProperties": false,
1413
+ "definitions": {}
1414
+ },
1408
1415
  "commands": [
1409
1416
  {
1410
1417
  "key": "version",
@@ -1412,7 +1419,7 @@
1412
1419
  },
1413
1420
  {
1414
1421
  "key": "configure",
1415
- "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
1422
+ "description": "Set up MCP config for this app (binary via Homebrew).",
1416
1423
  "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n full-example-json configure install\n\nUpgrade:\n brew upgrade full-example-json\n full-example-json configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure status\n\nUninstall:\n full-example-json configure uninstall\n brew uninstall <tap>/full-example-json\n\nUse `configure status --json` for machine-readable output.",
1417
1424
  "commands": [
1418
1425
  {
@@ -1521,17 +1528,6 @@
1521
1528
  "kind": "presence"
1522
1529
  }
1523
1530
  ]
1524
- },
1525
- {
1526
- "key": "skill",
1527
- "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
1528
- "options": [
1529
- {
1530
- "name": "save",
1531
- "description": "Write documentation to ./docs/.",
1532
- "kind": "presence"
1533
- }
1534
- ]
1535
1531
  }
1536
1532
  ]
1537
1533
  },
@@ -1632,6 +1628,21 @@
1632
1628
  {
1633
1629
  "key": "patch",
1634
1630
  "description": "Patch a workspace name.",
1631
+ "inputSchema": {
1632
+ "$schema": "http://json-schema.org/draft-07/schema#",
1633
+ "type": "object",
1634
+ "properties": {
1635
+ "name": {
1636
+ "type": "string",
1637
+ "description": "Workspace display name."
1638
+ }
1639
+ },
1640
+ "required": [
1641
+ "name"
1642
+ ],
1643
+ "additionalProperties": false,
1644
+ "definitions": {}
1645
+ },
1635
1646
  "commands": [
1636
1647
  {
1637
1648
  "key": "version",
@@ -1639,7 +1650,7 @@
1639
1650
  },
1640
1651
  {
1641
1652
  "key": "configure",
1642
- "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
1653
+ "description": "Set up MCP config for this app (binary via Homebrew).",
1643
1654
  "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n full-example-json configure install\n\nUpgrade:\n brew upgrade full-example-json\n full-example-json configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure status\n\nUninstall:\n full-example-json configure uninstall\n brew uninstall <tap>/full-example-json\n\nUse `configure status --json` for machine-readable output.",
1644
1655
  "commands": [
1645
1656
  {
@@ -1748,17 +1759,6 @@
1748
1759
  "kind": "presence"
1749
1760
  }
1750
1761
  ]
1751
- },
1752
- {
1753
- "key": "skill",
1754
- "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
1755
- "options": [
1756
- {
1757
- "name": "save",
1758
- "description": "Write documentation to ./docs/.",
1759
- "kind": "presence"
1760
- }
1761
- ]
1762
1762
  }
1763
1763
  ]
1764
1764
  },
@@ -1859,6 +1859,11 @@
1859
1859
  {
1860
1860
  "key": "delete",
1861
1861
  "description": "Delete a workspace.",
1862
+ "inputSchema": {
1863
+ "type": "object",
1864
+ "properties": {},
1865
+ "additionalProperties": false
1866
+ },
1862
1867
  "commands": [
1863
1868
  {
1864
1869
  "key": "version",
@@ -1866,7 +1871,7 @@
1866
1871
  },
1867
1872
  {
1868
1873
  "key": "configure",
1869
- "description": "Set up agent skills and MCP config for this app (binary via Homebrew).",
1874
+ "description": "Set up MCP config for this app (binary via Homebrew).",
1870
1875
  "notes": "Set up agent artifacts after the binary is installed via Homebrew (see README for tap install).\n\nHomebrew installs the binary and shell completions only. Agent artifacts live under ~/.agents and are not written during brew install.\n\nAfter install or upgrade:\n full-example-json configure install\n\nUpgrade:\n brew upgrade full-example-json\n full-example-json configure install\n\nShell completions are installed by Homebrew during brew install.\nSee: https://docs.brew.sh/Shell-Completion\n\nSee what is installed:\n full-example-json configure status\n\nUninstall:\n full-example-json configure uninstall\n brew uninstall <tap>/full-example-json\n\nUse `configure status --json` for machine-readable output.",
1871
1876
  "commands": [
1872
1877
  {
@@ -1975,17 +1980,6 @@
1975
1980
  "kind": "presence"
1976
1981
  }
1977
1982
  ]
1978
- },
1979
- {
1980
- "key": "skill",
1981
- "description": "Print a reference agent SKILL; run `configure install` to install an optimized copy.",
1982
- "options": [
1983
- {
1984
- "name": "save",
1985
- "description": "Write documentation to ./docs/.",
1986
- "kind": "presence"
1987
- }
1988
- ]
1989
1983
  }
1990
1984
  ]
1991
1985
  },