@dzhechkov/harness-cli 0.7.3 → 0.7.5

package/sbom.json

@@ -25,7 +25,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "c58f8ba9168698b8b85767b8989c707a2f9cec3ebe28cc47061160f2f143e997"
+          "content": "bf6ac920e20f4e9978dbb7b1cca48790d97e44f245dc53088e189776b4a7616e"
         }
       ]
     },
@@ -69,6 +69,46 @@
         }
       ]
     },
+    {
+      "type": "file",
+      "name": "dist/boolean-flags.d.ts",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "014b309c8b7de90b6c0d87e4f4c6a15623fd9c261252282faa3567dd3b9d0d4d"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/boolean-flags.d.ts.map",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "a8309c4a78c90a1c9db9518a6d07c5fa800c4d39710941a379635a65012e208d"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/boolean-flags.js",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "8cf050f1bc0b69be1088e58cc5f88f034d2e847fba9ffc87f3cc01121d7d9d74"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/boolean-flags.js.map",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "442b8bbb2ec9f7701ddc2232fc8662956966097d6f46ee1fce49bd06c20db97f"
+        }
+      ]
+    },
     {
       "type": "file",
       "name": "dist/cli.d.ts",
@@ -85,7 +125,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "833c76f1fca3af7f1085862cb1239bb81a70e1261839fc34f8d2dc0d00752cc7"
+          "content": "6fc728a98d8a920a226a4ee2d8b045ee46e27246c7d7e8bdf15e6c7758f3efbc"
         }
       ]
     },
@@ -95,7 +135,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "130604723d58640d89186e5535201346eabba190a2f9542504235d28d323a761"
+          "content": "4bc5e7cb6563fd672fd7e2c38eac4ba55d54de46940c194b3d2cd5ea4519732a"
         }
       ]
     },
@@ -105,7 +145,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "a46fc71ca11f520e532956258cbce30e80736ce8315edbd2d2abab67c5affe6f"
+          "content": "560d103ce98af8095eb7ee86537aa80de7a914fffa693dc23fdf2440a4f76183"
         }
       ]
     },
@@ -189,6 +229,86 @@
         }
       ]
     },
+    {
+      "type": "file",
+      "name": "dist/install-spec.d.ts",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "f1a4d132eb06068e2c45ce7976f1b01482187c93021bbfaceb7f1dbe76c8c991"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/install-spec.d.ts.map",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "59a6d12466909c86aa06c272b237ca39473f106fd544725b1e6c707ca1c06a25"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/install-spec.js",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "354aae49a20a404eb9d0405ca6c7f6fa277e23b3e9f4988582f0c610486a2e6b"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/install-spec.js.map",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "3f8225df12c17826d5e8642f342a2fae21f4d1c32bb0969915570258a1ce6a76"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/known-flags.d.ts",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "40403ed4e24cdf95cb2757653485d7cb4650ef8496af96927ab503c2a189c598"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/known-flags.d.ts.map",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "23fa9b92489e2f39d99397a57f99a4c7566d41b75682d1bbde3f113c480acdcd"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/known-flags.js",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "f4ed9bddb45629484baf117a3b92eb4097932abda6e5a48227acbc7b5f23f561"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/known-flags.js.map",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "41bce9592c8192431f7f023271eaf3f548398e5c15441ea69a59e78633915cd9"
+        }
+      ]
+    },
     {
       "type": "file",
       "name": "keys/README.md",
@@ -215,7 +335,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "2aa110c79aca3b5874a166eed1d9bdecb2450cb389fbd28f689ede4e1e629532"
+          "content": "423120966d33fb4515177a7613f0ace5b392a576098987d0d9ca22aedea96716"
         }
       ]
     },
@@ -229,13 +349,23 @@
         }
       ]
     },
+    {
+      "type": "file",
+      "name": "src/boolean-flags.ts",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "c3ef929a729f53ca612ac67b1571d2e8da3681ac5060a1cd16e453e0bb1d4e00"
+        }
+      ]
+    },
     {
       "type": "file",
       "name": "src/cli.ts",
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "43cc0a4fb533c65076b9e0e5da37b836cdbae1fc2d285131bd27b9bde9c38899"
+          "content": "cae511b9b892c43e874ee06b439306290cd2c0a9e6b75cd0cd931d47adaef3f5"
         }
       ]
     },
@@ -258,6 +388,26 @@
           "content": "d4258f3b183d03047aa07399ae96bdb2b3af83f0005127a24a39f8932982bf78"
         }
       ]
+    },
+    {
+      "type": "file",
+      "name": "src/install-spec.ts",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "4196fd89c6d2ab1f3ba107141c32635f2739dc38d978a9f4f41a8b0db0ddc5f9"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "src/known-flags.ts",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "aed996e8a3741b595eba31ef694ec5b2999dc0a73933a4289325cf6b9944e254"
+        }
+      ]
     }
   ]
 }

package/src/boolean-flags.ts

@@ -0,0 +1,118 @@
+/**
+ * Boolean flags DECLARED AS DATA — feature boolean-flags-declared (backlog 247ddcfa).
+ *
+ * Before this file, `parseArgs` had no concept of a boolean flag: ANY `--flag` greedily consumed
+ * the next token unless it began with `--`. MEASURED 2026-08-22 on 0.7.0: `dz sync --dry-run .`
+ * turned the safety flag into the option `dry-run=.` — `flags.has('dry-run')` was FALSE and the
+ * run WROTE, its only trace a missing label. The same class swallowed positionals
+ * (`dz recall --no-semantic "torque"` ate the query) across ~72 commands.
+ *
+ * GENERATED from a census of `cli.ts` reads — `test/boolean-flags.test.ts` re-derives the census
+ * on every run and fails on ANY divergence, in BOTH directions: a name here that gains a valued
+ * read, or a new flags.has-only name missing from here, each forces a conscious decision.
+ *
+ * Two names are declared beyond the mechanical census, both documented:
+ * - `json` — its one valued read (cli.ts, the `--json <path>` recovery in the mcp-scan family) IS
+ *   the hand-patch for this very defect; with the flag declared boolean the recovery goes
+ *   harmlessly dead and `--json <path>` parses as flag + positional, which that code also accepts.
+ * - `force` — valued ONLY under `dz guard` (`--force <reason>`, the audited override); boolean in
+ *   every other command. Encoded via {@link VALUED_FORCE_COMMANDS}.
+ */
+export const BOOLEAN_CLI_FLAGS: ReadonlySet<string> = new Set([
+  'affected',
+  'all',
+  'allow-same-family',
+  'allow-same-family-qe',
+  'any',
+  'apply',
+  'audit-dev',
+  'auto',
+  'books',
+  'bto',
+  'bump-only',
+  'by-stage',
+  'calibrate',
+  'check',
+  'confirm',
+  'context-only',
+  'deep',
+  'diff',
+  'done',
+  'dry-run',
+  'emit',
+  'enrich',
+  'fa-record',
+  'fail-on-undergrant',
+  'finalize',
+  'force',
+  'full',
+  'gates',
+  'guard',
+  'guards',
+  'harmonize',
+  'help',
+  'include-pairs',
+  'init',
+  'install',
+  'install-driver',
+  'install-hook',
+  'json',
+  'keep-scratch',
+  'legacy',
+  'lexical',
+  'list',
+  'live-content',
+  'mock',
+  'night',
+  'no-dry-run',
+  'no-evals',
+  'no-hooks',
+  'no-issue',
+  'no-memory',
+  'no-mirror',
+  'no-provenance',
+  'no-result',
+  'no-semantic',
+  'no-teach',
+  'no-verify',
+  'once',
+  'override',
+  'preview',
+  'provenance',
+  'prune-noise',
+  'prune-quarantine',
+  'publish',
+  'reconcile',
+  'record-provisional',
+  'refresh-publishes',
+  'remove',
+  'require-plan',
+  'require-signing',
+  'rerank',
+  'revise',
+  'scope-check',
+  'semantic',
+  'send',
+  'split',
+  'stages-json',
+  'static',
+  'stats',
+  'strict',
+  'tag',
+  'teach',
+  'usage',
+  'validate',
+  'weak',
+  'with-pairs',
+  'with-references',
+  'yes',
+]);
+
+/** Commands where `--force` takes a VALUE (`--force <reason>`, logged) and must stay greedy. */
+export const VALUED_FORCE_COMMANDS: readonly string[] = ['guard'];
+
+/** Is `--<name>` a boolean flag for this command — i.e. it must never swallow the next token? */
+export function isBooleanFlag(name: string, command: string): boolean {
+  if (name === 'force') return !VALUED_FORCE_COMMANDS.includes(command);
+  return BOOLEAN_CLI_FLAGS.has(name);
+}