npm - argsbarg - Versions diffs - 6.1.10 → 6.2.0 - Mend

argsbarg 6.1.10 → 6.2.0

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 (130) hide show

package/CHANGELOG.md +10 -1
package/README.md +43 -41
package/docs/README.md +3 -2
package/docs/ai-skills.md +36 -23
package/docs/cli-program.md +12 -11
package/docs/config-schema.md +3 -3
package/docs/configure.md +12 -16
package/docs/developing.md +6 -6
package/docs/mcp.md +21 -57
package/docs/output-schema.md +2 -2
package/examples/formats.ts +5 -6
package/examples/full-example/README.md +7 -69
package/examples/full-example/docs/cli-schema.json +1 -1659
package/examples/full-example/docs/cli.md +2 -1538
package/examples/full-example/docs/http.md +0 -7
package/examples/full-example/docs/mcp.md +23 -59
package/examples/full-example/docs/openapi.json +2 -782
package/examples/full-example/docs/skill.md +18 -14
package/examples/full-example/justfile +5 -17
package/examples/full-example/scripts/create-identity.ts +2 -1
package/examples/full-example/src/commands/status/command.test.ts +2 -2
package/examples/full-example/src/commands/status/command.ts +7 -6
package/examples/full-example/src/program.ts +4 -10
package/examples/full-example-json/Formula/.gitkeep +0 -0
package/examples/full-example-json/Formula/full-example-json.rb +35 -0
package/examples/full-example-json/README.md +27 -0
package/examples/full-example-json/biome.json +22 -0
package/examples/full-example-json/bun.lock +48 -0
package/examples/full-example-json/docs/README.md +27 -0
package/examples/full-example-json/docs/cli-schema.json +2145 -0
package/examples/full-example-json/docs/cli.md +1990 -0
package/examples/full-example-json/docs/http.md +92 -0
package/examples/full-example-json/docs/mcp.md +116 -0
package/examples/full-example-json/docs/openapi.json +1246 -0
package/examples/full-example-json/docs/skill.md +57 -0
package/examples/full-example-json/justfile +171 -0
package/examples/full-example-json/package.json +22 -0
package/examples/full-example-json/scripts/create-identity.ts +12 -0
package/examples/full-example-json/scripts/dev-formula.ts +97 -0
package/examples/full-example-json/scripts/formula-shared.test.ts +68 -0
package/examples/full-example-json/scripts/formula-shared.ts +170 -0
package/examples/full-example-json/scripts/print-identity.ts +28 -0
package/examples/full-example-json/scripts/release.ts +212 -0
package/examples/full-example-json/src/commands/echo/command.ts +26 -0
package/examples/full-example-json/src/commands/status/command.test.ts +10 -0
package/examples/full-example-json/src/commands/status/command.ts +28 -0
package/examples/full-example-json/src/index.ts +10 -0
package/examples/full-example-json/src/program.ts +33 -0
package/examples/full-example-json/src/types/md.d.ts +4 -0
package/examples/full-example-json/tsconfig.json +17 -0
package/examples/minimal.ts +17 -17
package/examples/nested.ts +10 -10
package/examples/option-required.ts +13 -13
package/examples/servers.ts +10 -10
package/index.d.ts +17 -43
package/package.json +1 -1
package/src/cli-tool/create.test.ts +44 -68
package/src/cli-tool/create.ts +81 -17
package/src/cli-tool/full-example-capabilities.test.ts +33 -18
package/src/cli-tool/post-create.ts +31 -17
package/src/cli-tool/program.ts +16 -7
package/src/cli-tool/prompt.ts +27 -0
package/src/cli-tool/run-create.ts +19 -7
package/src/cli-tool/schemagen/schemagen.test.ts +3 -3
package/src/configure/artifacts/install-validate.test.ts +20 -33
package/src/configure/artifacts/paths.ts +9 -53
package/src/configure/artifacts/status.test.ts +13 -16
package/src/configure/artifacts/status.ts +5 -22
package/src/configure/artifacts/target-base.ts +6 -15
package/src/configure/artifacts/target-effective.ts +16 -54
package/src/configure/artifacts/target-mcp-json.ts +2 -5
package/src/configure/artifacts/target-registry.ts +0 -7
package/src/configure/artifacts/target-scope.ts +7 -17
package/src/configure/artifacts/target-skill.ts +6 -15
package/src/configure/artifacts/target-types.ts +6 -54
package/src/configure/artifacts/targets/agents-mcp.ts +11 -0
package/src/configure/artifacts/targets/configure.ts +1 -5
package/src/configure/artifacts/targets/index.ts +4 -44
package/src/configure/artifacts/targets/skill.ts +12 -0
package/src/configure/artifacts/targets.test.ts +21 -59
package/src/configure/configure.test.ts +35 -46
package/src/configure/index.ts +19 -19
package/src/configure/prompt.ts +2 -12
package/src/core/parse.test.ts +21 -32
package/src/core/types.ts +18 -44
package/src/core/validate.ts +28 -45
package/src/docs/docs.test.ts +4 -4
package/src/docs/mcp-guide.ts +41 -71
package/src/docs/resolve.ts +1 -1
package/src/exports/cli.ts +1 -1
package/src/index.ts +1 -1
package/src/skill/generate.ts +26 -45
package/src/skill/install.ts +18 -38
package/src/skill/naming.ts +3 -27
package/src/test/integration/config.test.ts +3 -3
package/src/test/integration/mcp.test.ts +4 -4
package/{examples/mcp-test.ts → src/test/mcp-integration-fixture.ts} +20 -22
package/src/configure/artifacts/target-mcp-cli.ts +0 -127
package/src/configure/artifacts/targets/chatgpt-mcp.ts +0 -12
package/src/configure/artifacts/targets/claude-code-mcp.ts +0 -15
package/src/configure/artifacts/targets/claude-desktop-mcp.ts +0 -12
package/src/configure/artifacts/targets/claude-skill.ts +0 -16
package/src/configure/artifacts/targets/codex-mcp.ts +0 -25
package/src/configure/artifacts/targets/codex-skill.ts +0 -14
package/src/configure/artifacts/targets/cursor-mcp.ts +0 -15
package/src/configure/artifacts/targets/cursor-skill.ts +0 -16
package/src/configure/artifacts/targets/openclaw-mcp.ts +0 -25
package/src/configure/artifacts/targets/openclaw-skill.ts +0 -17
package/src/configure/artifacts/targets/opencode-mcp.ts +0 -96
package/src/configure/artifacts/targets/opencode-skill.ts +0 -15
/package/examples/{full-example → full-example-json}/src/commands/render-json/__generated__/RenderJsonInputSchema.json +0 -0
/package/examples/{full-example → full-example-json}/src/commands/render-json/__generated__/index.ts +0 -0
/package/examples/{full-example → full-example-json}/src/commands/render-json/command.test.ts +0 -0
/package/examples/{full-example → full-example-json}/src/commands/render-json/command.ts +0 -0
/package/examples/{full-example → full-example-json}/src/commands/render-json/types.ts +0 -0
/package/examples/{full-example → full-example-json}/src/commands/status/__generated__/StatusJsonOutputSchema.json +0 -0
/package/examples/{full-example → full-example-json}/src/commands/status/__generated__/index.ts +0 -0
/package/examples/{full-example → full-example-json}/src/commands/status/types.ts +0 -0
/package/examples/{full-example → full-example-json}/src/commands/workspaces/__generated__/WorkspaceNameInputSchema.json +0 -0
/package/examples/{full-example → full-example-json}/src/commands/workspaces/__generated__/index.ts +0 -0
/package/examples/{full-example → full-example-json}/src/commands/workspaces/command.test.ts +0 -0
/package/examples/{full-example → full-example-json}/src/commands/workspaces/command.ts +0 -0
/package/examples/{full-example → full-example-json}/src/commands/workspaces/types.ts +0 -0
/package/examples/{full-example → full-example-json}/src/db/index.test.ts +0 -0
/package/examples/{full-example → full-example-json}/src/db/index.ts +0 -0
/package/examples/{full-example → full-example-json}/src/db/migrate.test.ts +0 -0
/package/examples/{full-example → full-example-json}/src/db/migrate.ts +0 -0
/package/examples/{full-example → full-example-json}/src/db/migrations/001_workspaces.sql +0 -0
/package/examples/{full-example → full-example-json}/src/db/tables/workspaces.ts +0 -0
/package/examples/{full-example → full-example-json}/src/types/argsbarg.d.ts +0 -0

package/examples/full-example/docs/openapi.json CHANGED Viewed

@@ -3,7 +3,7 @@
   "info": {
     "title": "full-example",
     "version": "1.0.0",
-    "description": "Argsbarg full example reference app"
+    "description": "Argsbarg CLI copy template (MCP, HTTP, configure, skills; no schemagen)"
   },
   "tags": [
     {
@@ -14,17 +14,9 @@
       "name": "echo",
       "description": "Echo a message (MCP-friendly leaf)."
     },
-    {
-      "name": "render-json",
-      "description": "Echo a JSON message (schema-first JSON leaf demo)."
-    },
     {
       "name": "status",
       "description": "Show app version."
-    },
-    {
-      "name": "workspaces",
-      "description": "Workspace collection and CRUD."
     }
   ],
   "paths": {
@@ -361,120 +353,6 @@
         }
       }
     },
-    "/render-json": {
-      "post": {
-        "tags": [
-          "render-json"
-        ],
-        "operationId": "_render-json",
-        "summary": "Echo a JSON message (schema-first JSON leaf demo).",
-        "responses": {
-          "201": {
-            "description": "Successful invocation",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object"
-                }
-              }
-            }
-          },
-          "400": {
-            "description": "Invalid arguments or help requested",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "404": {
-            "description": "Not found",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "500": {
-            "description": "Handler error",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "503": {
-            "description": "Not ready or missing required config",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          }
-        },
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json; charset=utf-8": {
-              "schema": {
-                "$schema": "http://json-schema.org/draft-07/schema#",
-                "type": "object",
-                "properties": {
-                  "message": {
-                    "type": "string",
-                    "description": "Message to echo back."
-                  }
-                },
-                "required": [
-                  "message"
-                ],
-                "additionalProperties": false
-              }
-            }
-          }
-        }
-      }
-    },
     "/status": {
       "post": {
         "tags": [
@@ -488,18 +366,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$schema": "http://json-schema.org/draft-07/schema#",
-                  "type": "object",
-                  "properties": {
-                    "version": {
-                      "type": "string",
-                      "description": "App version from program root."
-                    }
-                  },
-                  "required": [
-                    "version"
-                  ],
-                  "additionalProperties": false
+                  "type": "object"
                 }
               }
             }
@@ -594,653 +461,6 @@
           }
         }
       }
-    },
-    "/workspaces": {
-      "get": {
-        "tags": [
-          "workspaces"
-        ],
-        "operationId": "_workspaces",
-        "summary": "List workspaces.",
-        "responses": {
-          "200": {
-            "description": "Successful invocation",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object"
-                }
-              }
-            }
-          },
-          "400": {
-            "description": "Invalid arguments or help requested",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "404": {
-            "description": "Not found",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "500": {
-            "description": "Handler error",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "503": {
-            "description": "Not ready or missing required config",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          }
-        },
-        "parameters": []
-      },
-      "post": {
-        "tags": [
-          "workspaces"
-        ],
-        "operationId": "_workspaces",
-        "summary": "Create a workspace.",
-        "responses": {
-          "201": {
-            "description": "Successful invocation",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object"
-                }
-              }
-            }
-          },
-          "400": {
-            "description": "Invalid arguments or help requested",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "404": {
-            "description": "Not found",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "500": {
-            "description": "Handler error",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "503": {
-            "description": "Not ready or missing required config",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          }
-        },
-        "requestBody": {
-          "required": false,
-          "content": {
-            "application/json; charset=utf-8": {
-              "schema": {
-                "$schema": "http://json-schema.org/draft-07/schema#",
-                "type": "object",
-                "properties": {
-                  "name": {
-                    "type": "string",
-                    "description": "Workspace display name."
-                  }
-                },
-                "required": [
-                  "name"
-                ],
-                "additionalProperties": false
-              }
-            }
-          }
-        }
-      }
-    },
-    "/workspaces/{id}": {
-      "get": {
-        "tags": [
-          "workspaces"
-        ],
-        "operationId": "_workspaces_id",
-        "summary": "Get one workspace.",
-        "responses": {
-          "200": {
-            "description": "Successful invocation",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object"
-                }
-              }
-            }
-          },
-          "400": {
-            "description": "Invalid arguments or help requested",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "404": {
-            "description": "Not found",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "500": {
-            "description": "Handler error",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "503": {
-            "description": "Not ready or missing required config",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          }
-        },
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          }
-        ]
-      },
-      "put": {
-        "tags": [
-          "workspaces"
-        ],
-        "operationId": "_workspaces_id",
-        "summary": "Replace a workspace.",
-        "responses": {
-          "200": {
-            "description": "Successful invocation",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object"
-                }
-              }
-            }
-          },
-          "400": {
-            "description": "Invalid arguments or help requested",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "404": {
-            "description": "Not found",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "500": {
-            "description": "Handler error",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "503": {
-            "description": "Not ready or missing required config",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          }
-        },
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "required": false,
-          "content": {
-            "application/json; charset=utf-8": {
-              "schema": {
-                "$schema": "http://json-schema.org/draft-07/schema#",
-                "type": "object",
-                "properties": {
-                  "name": {
-                    "type": "string",
-                    "description": "Workspace display name."
-                  }
-                },
-                "required": [
-                  "name"
-                ],
-                "additionalProperties": false
-              }
-            }
-          }
-        }
-      },
-      "patch": {
-        "tags": [
-          "workspaces"
-        ],
-        "operationId": "_workspaces_id",
-        "summary": "Patch a workspace name.",
-        "responses": {
-          "200": {
-            "description": "Successful invocation",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object"
-                }
-              }
-            }
-          },
-          "400": {
-            "description": "Invalid arguments or help requested",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "404": {
-            "description": "Not found",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "500": {
-            "description": "Handler error",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "503": {
-            "description": "Not ready or missing required config",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          }
-        },
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "required": false,
-          "content": {
-            "application/json; charset=utf-8": {
-              "schema": {
-                "$schema": "http://json-schema.org/draft-07/schema#",
-                "type": "object",
-                "properties": {
-                  "name": {
-                    "type": "string",
-                    "description": "Workspace display name."
-                  }
-                },
-                "required": [
-                  "name"
-                ],
-                "additionalProperties": false
-              }
-            }
-          }
-        }
-      },
-      "delete": {
-        "tags": [
-          "workspaces"
-        ],
-        "operationId": "_workspaces_id",
-        "summary": "Delete a workspace.",
-        "responses": {
-          "204": {
-            "description": "Successful invocation"
-          },
-          "400": {
-            "description": "Invalid arguments or help requested",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "404": {
-            "description": "Not found",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "500": {
-            "description": "Handler error",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "503": {
-            "description": "Not ready or missing required config",
-            "content": {
-              "application/json; charset=utf-8": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          }
-        },
-        "parameters": [
-          {
-            "name": "id",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          }
-        ]
-      }
     }
   }
 }