@the-librarian/cli 1.16.1 → 1.17.0

package/dist/parse-args.d.ts

@@ -7,6 +7,14 @@ export interface ParsedArgs {
 export declare function parseArgs(args: string[]): ParsedArgs;
 /** Coerce a flag to a string, or undefined when it isn't a plain string. */
 export declare function flagString(value: FlagValue | undefined): string | undefined;
-/** True iff the flag was passed as a bare boolean (`--foo`) or set truthy. */
+/**
+ * True iff the flag reads as on: a bare `--foo`, or an inline `--foo=true`.
+ *
+ * The inline arm matters because this parser has no switch registry, so
+ * `--yes=true` arrives as the STRING "true" (spec 073). Comparing to `true`
+ * alone would read that as off and silently prompt anyway — the operator having
+ * plainly said otherwise. `flagBool` is the single reader of every switch here,
+ * so this is the one place the interpretation belongs.
+ */
 export declare function flagBool(value: FlagValue | undefined): boolean;
 //# sourceMappingURL=parse-args.d.ts.map

package/dist/parse-args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-args.d.ts","sourceRoot":"","sources":["../src/parse-args.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC;AACpD,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAiCpD;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE3E;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAE9D"}
+{"version":3,"file":"parse-args.d.ts","sourceRoot":"","sources":["../src/parse-args.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC;AACpD,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB;AAmBD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAqCpD;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAU9D"}

package/dist/parse-args.js

@@ -4,6 +4,25 @@
 // `parseArgs(argv)` splits a verb's arguments into `{ positionals, flags }`.
 // Bare `--foo` → `true`; `--no-foo` → `false`; `--foo bar` → `"bar"`;
 // repeated `--foo a --foo b` → `["a", "b"]`.
+/**
+ * Record a flag value, collecting repeats into an array. Shared by the spaced
+ * (`--tag a`) and inline (`--tag=a`) forms so the two cannot drift.
+ */
+function assignFlag(flags, key, value) {
+    const existing = flags[key];
+    if (existing === undefined) {
+        flags[key] = value;
+    }
+    else if (Array.isArray(existing)) {
+        existing.push(value);
+    }
+    else if (typeof existing === "string") {
+        flags[key] = [existing, value];
+    }
+    else {
+        flags[key] = value;
+    }
+}
 export function parseArgs(args) {
     const positionals = [];
     const flags = {};
@@ -11,30 +30,30 @@ export function parseArgs(args) {
         const arg = args[i];
         if (typeof arg !== "string")
             continue;
-        if (arg.startsWith("--no-")) {
-            flags[arg.slice("--no-".length)] = false;
-            continue;
-        }
         if (arg.startsWith("--")) {
-            const key = arg.slice(2);
+            // Split `--key=value` on the FIRST `=` (spec 073). Without this the whole
+            // `key=value` string became the flag NAME set to true, leaving the real
+            // flag unset — so `--data-dir=/srv/x` ran against the default without a
+            // word. Mirrors packages/cli/parse-flags.ts; the two must agree on what a
+            // flag looks like.
+            const body = arg.slice(2);
+            const equals = body.indexOf("=");
+            const key = equals === -1 ? body : body.slice(0, equals);
+            const inlineValue = equals === -1 ? null : body.slice(equals + 1);
+            if (key.startsWith("no-")) {
+                flags[key.slice("no-".length)] = false;
+                continue;
+            }
+            if (inlineValue !== null) {
+                assignFlag(flags, key, inlineValue);
+                continue;
+            }
             const next = args[i + 1];
             if (next === undefined || (typeof next === "string" && next.startsWith("--"))) {
                 flags[key] = true;
             }
             else {
-                const existing = flags[key];
-                if (existing === undefined) {
-                    flags[key] = next;
-                }
-                else if (Array.isArray(existing)) {
-                    existing.push(next);
-                }
-                else if (typeof existing === "string") {
-                    flags[key] = [existing, next];
-                }
-                else {
-                    flags[key] = next;
-                }
+                assignFlag(flags, key, next);
                 i += 1;
             }
             continue;
@@ -47,8 +66,24 @@ export function parseArgs(args) {
 export function flagString(value) {
     return typeof value === "string" ? value : undefined;
 }
-/** True iff the flag was passed as a bare boolean (`--foo`) or set truthy. */
+/**
+ * True iff the flag reads as on: a bare `--foo`, or an inline `--foo=true`.
+ *
+ * The inline arm matters because this parser has no switch registry, so
+ * `--yes=true` arrives as the STRING "true" (spec 073). Comparing to `true`
+ * alone would read that as off and silently prompt anyway — the operator having
+ * plainly said otherwise. `flagBool` is the single reader of every switch here,
+ * so this is the one place the interpretation belongs.
+ */
 export function flagBool(value) {
-    return value === true;
+    if (value === true)
+        return true;
+    if (typeof value !== "string")
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return !(normalized === "false" ||
+        normalized === "0" ||
+        normalized === "no" ||
+        normalized === "");
 }
 //# sourceMappingURL=parse-args.js.map

package/dist/parse-args.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse-args.js","sourceRoot":"","sources":["../src/parse-args.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,uDAAuD;AACvD,EAAE;AACF,6EAA6E;AAC7E,sEAAsE;AACtE,6CAA6C;AAU7C,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,KAAK,GAAY,EAAE,CAAC;IAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,SAAS;QACtC,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC;YACzC,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACzB,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBAC9E,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC5B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC3B,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;gBACpB,CAAC;qBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACnC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACtB,CAAC;qBAAM,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;oBACxC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBAChC,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;gBACpB,CAAC;gBACD,CAAC,IAAI,CAAC,CAAC;YACT,CAAC;YACD,SAAS;QACX,CAAC;QACD,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AAChC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,UAAU,CAAC,KAA4B;IACrD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,QAAQ,CAAC,KAA4B;IACnD,OAAO,KAAK,KAAK,IAAI,CAAC;AACxB,CAAC"}
+{"version":3,"file":"parse-args.js","sourceRoot":"","sources":["../src/parse-args.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-librarian/cli",
-  "version": "1.16.1",
+  "version": "1.17.0",
   "private": false,
   "publishConfig": {
     "access": "public"