argsbarg 7.0.0 → 7.0.3

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [7.0.3] - 2026-08-13
+
+### Fixed
+
+- **Partial config validation** — skip attaching empty `definitions` / `$defs` companion schemas (fixes `Duplicate schema URI "https://github.com/cfworker"` when schemagen emits `"definitions": {}`).
+
+## [7.0.2] - 2026-08-13
+
+
+## [7.0.1] - 2026-08-13
+
+### Fixed
+
+- **`configure install` / `uninstall` / `status`** — skip the global required-`appConfig` gate so these subcommands reach their handlers (e.g. `configure uninstall` when config is incomplete).
+
 ## [7.0.0] - 2026-08-13
 
 ### Changed
@@ -938,7 +953,10 @@ const cli = { ... } satisfies CliProgram;  // or : CliProgram
 - Migrate schemas: rename every `children` property to **`commands`**; move positional definitions to **`CliPositional`** objects on `positionals` and strip `positional` / `argMin` / `argMax` from flag definitions under `options` (flags only carry `name`, `description`, `kind`, and optional `shortName`).
 - Imports: use `CliPositional` where needed; replace `CliOptionDef` with `CliOption` or `CliPositional` as appropriate.
 
-[Unreleased]: https://github.com/bdombro/bun-argsbarg/compare/v7.0.0...HEAD
+[Unreleased]: https://github.com/bdombro/bun-argsbarg/compare/v7.0.3...HEAD
+[7.0.3]: https://github.com/bdombro/bun-argsbarg/releases/tag/v7.0.3
+[7.0.2]: https://github.com/bdombro/bun-argsbarg/releases/tag/v7.0.2
+[7.0.1]: https://github.com/bdombro/bun-argsbarg/releases/tag/v7.0.1
 [7.0.0]: https://github.com/bdombro/bun-argsbarg/releases/tag/v7.0.0
 [6.3.2]: https://github.com/bdombro/bun-argsbarg/releases/tag/v6.3.2
 [6.3.1]: https://github.com/bdombro/bun-argsbarg/releases/tag/v6.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argsbarg",
-  "version": "7.0.0",
+  "version": "7.0.3",
   "main": "./src/index.ts",
   "module": "./src/index.ts",
   "dependencies": {

package/src/config/validate.test.ts

@@ -3,7 +3,12 @@ Tests for config/validate module behavior.
 */
 
 import { describe, expect, test } from "bun:test";
-import { parseConfigSetValue, resolveSchemaDraft, validateConfigDocument } from "./validate.ts";
+import {
+  parseConfigSetValue,
+  resolveSchemaDraft,
+  validateConfigDocument,
+  validateConfigDocumentPartial,
+} from "./validate.ts";
 
 const rootSchema = {
   type: "object",
@@ -121,6 +126,21 @@ describe("config/validate", () => {
     expect(validateConfigDocument({}, schema).valid).toBe(false);
   });
 
+  test("validateConfigDocumentPartial accepts schemagen root with empty definitions", () => {
+    const schema = {
+      $schema: "http://json-schema.org/draft-07/schema#",
+      type: "object",
+      additionalProperties: false,
+      required: ["email"],
+      properties: {
+        email: { type: "string" },
+        services: { type: "array", items: { type: "string" } },
+      },
+      definitions: {},
+    };
+    expect(validateConfigDocumentPartial({ email: "a@example.com", services: ["a"] }, schema).valid).toBe(true);
+  });
+
   test("validates draft 2020-12 $defs refs", () => {
     const schema = {
       $schema: "https://json-schema.org/draft/2020-12/schema",

package/src/config/validate.ts

@@ -129,10 +129,20 @@ function attachRootCompanionSchemas(validator: Validator, root: JsonSchema, acti
     return;
   }
   const companion: Schema = {};
-  if (typeof root.definitions === "object" && root.definitions !== null && !Array.isArray(root.definitions)) {
+  if (
+    typeof root.definitions === "object" &&
+    root.definitions !== null &&
+    !Array.isArray(root.definitions) &&
+    Object.keys(root.definitions).length > 0
+  ) {
     companion.definitions = root.definitions;
   }
-  if (typeof root.$defs === "object" && root.$defs !== null && !Array.isArray(root.$defs)) {
+  if (
+    typeof root.$defs === "object" &&
+    root.$defs !== null &&
+    !Array.isArray(root.$defs) &&
+    Object.keys(root.$defs).length > 0
+  ) {
     companion.$defs = root.$defs;
   }
   if (Object.keys(companion).length > 0) {

package/src/docs/docs.test.ts

@@ -247,6 +247,9 @@ test("skipsRequiredAppConfigExit includes docs and config builtins", () => {
   const caps = resolveCapabilities(program);
   expect(skipsRequiredAppConfigExit(["docs", "cli"], caps)).toBe(true);
   expect(skipsRequiredAppConfigExit(["configure", "get"], caps)).toBe(true);
+  expect(skipsRequiredAppConfigExit(["configure", "install"], caps)).toBe(true);
+  expect(skipsRequiredAppConfigExit(["configure", "uninstall"], caps)).toBe(true);
+  expect(skipsRequiredAppConfigExit(["configure", "status"], caps)).toBe(true);
   expect(skipsRequiredAppConfigExit(["run"], caps)).toBe(false);
 });
 

package/src/runtime/capabilities.ts

@@ -50,12 +50,12 @@ export function reservedCommandNames(caps: CliCapabilities): string[] {
   return names;
 }
 
-/** Commands that may run without required appConfig values (read-only / config introspection). */
+/** Commands that may run without required appConfig values (read-only / config introspection / lifecycle). */
 export function skipsRequiredAppConfigExit(path: string[], caps: CliCapabilities): boolean {
   const root = path[0];
-  if (root === "configure" && caps.configCommands) {
+  if (root === "configure" && caps.configure) {
     const sub = path[1];
-    if (sub === "get" || sub === "set") {
+    if (!sub || sub === "get" || sub === "set" || sub === "install" || sub === "uninstall" || sub === "status") {
       return true;
     }
   }