@dzhechkov/harness-cli 0.7.4 → 0.7.5

package/dist/install-spec.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `dz install` argument resolution — feature install-spec-honesty (backlog 43a52cf2 + c999786b).
+ *
+ * cmdInstall used to splice the RAW argument into `join(projectRoot, 'node_modules', pkg)`.
+ * MEASURED, five broken forms: an absolute path (path.join CONCATENATES an absolute segment —
+ * `/proj/node_modules/home/dz/pkgs/...`); a versioned spec `@dzhechkov/health-advisor@1.9.0`
+ * (the WORST: `npm install` SUCCEEDS and mutates the project's package.json, then dz dies on an
+ * invented path with exit 1 — and the versioned form is exactly what the npm-lag README
+ * prescribes); a tarball `pack-1.0.0.tgz`; `github:user/repo`; an alias `ha@npm:...`.
+ *
+ * The cure is a PURE resolver that runs BEFORE any npm process: every accepted form yields the
+ * npm spec AND the node_modules directory name it will land under; everything else is a NAMED
+ * refusal carrying the working two-command form. A spec whose landing dir cannot be established
+ * must never reach npm — that is what made the versioned failure mutate state and then die.
+ */
+export interface InstallSpecProbe {
+    /** Does `path` exist as a regular file? */
+    readonly isFile: (path: string) => boolean;
+    /** Does `path` exist as a directory? */
+    readonly isDir: (path: string) => boolean;
+    /** `name` from `package/package.json` inside a tarball, or null (unreadable/absent). */
+    readonly readTarballName: (path: string) => string | null;
+    /** `name` from `<dir>/package.json`, or null. */
+    readonly readDirName: (path: string) => string | null;
+}
+export type InstallSpecResolution = {
+    readonly kind: 'name' | 'versioned' | 'alias' | 'tarball' | 'dir';
+    readonly npmSpec: string;
+    readonly dirName: string;
+} | {
+    readonly kind: 'refused';
+    readonly reason: string;
+    readonly hint: string;
+};
+export declare function resolveInstallSpec(raw: string, resolveAgainstCwd: (p: string) => string, probe: InstallSpecProbe): InstallSpecResolution;
+//# sourceMappingURL=install-spec.d.ts.map

package/dist/install-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-spec.d.ts","sourceRoot":"","sources":["../src/install-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,wFAAwF;IACxF,QAAQ,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC1D,iDAAiD;IACjD,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACvD;AAED,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzH;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AASjF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,qBAAqB,CA+CxI"}

package/dist/install-spec.js

@@ -0,0 +1,68 @@
+/**
+ * `dz install` argument resolution — feature install-spec-honesty (backlog 43a52cf2 + c999786b).
+ *
+ * cmdInstall used to splice the RAW argument into `join(projectRoot, 'node_modules', pkg)`.
+ * MEASURED, five broken forms: an absolute path (path.join CONCATENATES an absolute segment —
+ * `/proj/node_modules/home/dz/pkgs/...`); a versioned spec `@dzhechkov/health-advisor@1.9.0`
+ * (the WORST: `npm install` SUCCEEDS and mutates the project's package.json, then dz dies on an
+ * invented path with exit 1 — and the versioned form is exactly what the npm-lag README
+ * prescribes); a tarball `pack-1.0.0.tgz`; `github:user/repo`; an alias `ha@npm:...`.
+ *
+ * The cure is a PURE resolver that runs BEFORE any npm process: every accepted form yields the
+ * npm spec AND the node_modules directory name it will land under; everything else is a NAMED
+ * refusal carrying the working two-command form. A spec whose landing dir cannot be established
+ * must never reach npm — that is what made the versioned failure mutate state and then die.
+ */
+const BARE_NAME_RE = /^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/;
+/** The two-command fallback that always works, named in every refusal (43a52cf2's own ask). */
+function twoCommandHint(raw) {
+    return `working form: npm install ${raw} --save-dev && dz init --skills-dir node_modules/<installed-package-name>`;
+}
+export function resolveInstallSpec(raw, resolveAgainstCwd, probe) {
+    const spec = raw.trim();
+    if (spec === '')
+        return { kind: 'refused', reason: 'empty spec', hint: 'dz install <package|package@version|path/to.tgz|path/to/dir>' };
+    // Path forms first — a path is never an npm name. Absolute, explicit-relative, or an existing
+    // .tgz/.tar.gz/.dir anywhere: the OLD code spliced these into node_modules verbatim.
+    const looksPathy = spec.startsWith('/') || spec.startsWith('./') || spec.startsWith('../') || /\.(tgz|tar\.gz)$/.test(spec);
+    if (looksPathy) {
+        const abs = resolveAgainstCwd(spec);
+        if (/\.(tgz|tar\.gz)$/.test(spec)) {
+            if (!probe.isFile(abs))
+                return { kind: 'refused', reason: `tarball not found: ${abs}`, hint: twoCommandHint(spec) };
+            const name = probe.readTarballName(abs);
+            if (name === null)
+                return { kind: 'refused', reason: `cannot read package/package.json name from ${abs}`, hint: twoCommandHint(spec) };
+            return { kind: 'tarball', npmSpec: abs, dirName: name };
+        }
+        if (probe.isDir(abs)) {
+            const name = probe.readDirName(abs);
+            if (name === null)
+                return { kind: 'refused', reason: `${abs} has no readable package.json name`, hint: twoCommandHint(spec) };
+            return { kind: 'dir', npmSpec: abs, dirName: name };
+        }
+        return { kind: 'refused', reason: `path does not exist: ${abs}`, hint: twoCommandHint(spec) };
+    }
+    // git/github/url specs: the landing dir is not cheaply establishable — refuse with the cure.
+    if (/^(github:|git\+|git:|https?:\/\/)/.test(spec)) {
+        return { kind: 'refused', reason: `git/url specs are not resolvable to a node_modules dir up front (${spec})`, hint: twoCommandHint(spec) };
+    }
+    // alias@npm:real[@version] — installs under the ALIAS name.
+    const alias = /^([^@][^@]*|@[^/]+\/[^@]+)@npm:(.+)$/.exec(spec);
+    if (alias !== null) {
+        return { kind: 'alias', npmSpec: spec, dirName: alias[1] };
+    }
+    if (BARE_NAME_RE.test(spec))
+        return { kind: 'name', npmSpec: spec, dirName: spec };
+    // name@version / @scope/name@version — the dir is the name WITHOUT the version.
+    const at = spec.lastIndexOf('@');
+    if (at > 0) {
+        const name = spec.slice(0, at);
+        const version = spec.slice(at + 1);
+        if (BARE_NAME_RE.test(name) && version !== '' && !version.includes('/')) {
+            return { kind: 'versioned', npmSpec: spec, dirName: name };
+        }
+    }
+    return { kind: 'refused', reason: `unrecognized install spec: ${spec}`, hint: twoCommandHint(spec) };
+}
+//# sourceMappingURL=install-spec.js.map

package/dist/install-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-spec.js","sourceRoot":"","sources":["../src/install-spec.ts"],"names":[],"mappings":"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"}

package/dist/known-flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"known-flags.d.ts","sourceRoot":"","sources":["../src/known-flags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EA+Q5C,CAAC"}
+{"version":3,"file":"known-flags.d.ts","sourceRoot":"","sources":["../src/known-flags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAuR5C,CAAC"}

package/dist/known-flags.js

@@ -38,6 +38,7 @@ export const KNOWN_CLI_FLAGS = [
     'candidates',
     'canonical',
     'category',
+    'channel',
     'check',
     'claim-check',
     'claude-bin',
@@ -52,6 +53,7 @@ export const KNOWN_CLI_FLAGS = [
     'confirmed',
     'context-only',
     'corroborate',
+    'count-project',
     'day',
     'deep',
     'default-family',
@@ -62,6 +64,7 @@ export const KNOWN_CLI_FLAGS = [
     'dir',
     'domain',
     'done',
+    'draft',
     'dry-run',
     'effect',
     'effort',
@@ -142,6 +145,7 @@ export const KNOWN_CLI_FLAGS = [
     'n',
     'name',
     'name-only',
+    'night',
     'no-audit',
     'no-decorate',
     'no-dry-run',
@@ -183,6 +187,7 @@ export const KNOWN_CLI_FLAGS = [
     'porcelain',
     'preset',
     'pretty',
+    'preview',
     'project',
     'promote',
     'proposal',
@@ -197,6 +202,7 @@ export const KNOWN_CLI_FLAGS = [
     'recalled',
     'reconcile',
     'record-provisional',
+    'refresh-publishes',
     'registry',
     'reinforce',
     'remove',
@@ -222,6 +228,7 @@ export const KNOWN_CLI_FLAGS = [
     'seed',
     'select',
     'semantic',
+    'send',
     'session',
     'sessions-dir',
     'short',
@@ -274,6 +281,7 @@ export const KNOWN_CLI_FLAGS = [
     'week',
     'weekly',
     'window-days',
+    'window',
     'with-pairs',
     'with-references',
     'work-order',

package/dist/known-flags.js.map

@@ -1 +1 @@
-{"version":3,"file":"known-flags.js","sourceRoot":"","sources":["../src/known-flags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,UAAU;IACV,KAAK;IACL,mBAAmB;IACnB,sBAAsB;IACtB,KAAK;IACL,QAAQ;IACR,OAAO;IACP,KAAK;IACL,UAAU;IACV,IAAI;IACJ,WAAW;IACX,QAAQ;IACR,MAAM;IACN,MAAM;IACN,UAAU;IACV,MAAM;IACN,MAAM;IACN,OAAO;IACP,KAAK;IACL,QAAQ;IACR,cAAc;IACd,WAAW;IACX,UAAU;IACV,WAAW;IACX,WAAW;IACX,YAAY;IACZ,WAAW;IACX,UAAU;IACV,OAAO;IACP,aAAa;IACb,YAAY;IACZ,KAAK;IACL,cAAc;IACd,YAAY;IACZ,SAAS;IACT,UAAU;IACV,QAAQ;IACR,SAAS;IACT,SAAS;IACT,WAAW;IACX,cAAc;IACd,aAAa;IACb,KAAK;IACL,MAAM;IACN,gBAAgB;IAChB,MAAM;IACN,aAAa;IACb,MAAM;IACN,aAAa;IACb,KAAK;IACL,QAAQ;IACR,MAAM;IACN,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,aAAa;IACb,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,iBAAiB;IACjB,QAAQ;IACR,WAAW;IACX,SAAS;IACT,oBAAoB;IACpB,QAAQ;IACR,aAAa;IACb,OAAO;IACP,QAAQ;IACR,UAAU;IACV,UAAU;IACV,MAAM;IACN,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,OAAO;IACP,WAAW;IACX,UAAU;IACV,WAAW;IACX,YAAY;IACZ,WAAW;IACX,MAAM;IACN,OAAO;IACP,YAAY;IACZ,MAAM;IACN,OAAO;IACP,QAAQ;IACR,WAAW;IACX,WAAW;IACX,MAAM;IACN,SAAS;IACT,MAAM;IACN,IAAI;IACJ,gBAAgB;IAChB,eAAe;IACf,MAAM;IACN,YAAY;IACZ,SAAS;IACT,gBAAgB;IAChB,cAAc;IACd,MAAM;IACN,YAAY;IACZ,MAAM;IACN,OAAO;IACP,GAAG;IACH,cAAc;IACd,KAAK;IACL,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,SAAS;IACT,OAAO;IACP,MAAM;IACN,cAAc;IACd,SAAS;IACT,YAAY;IACZ,UAAU;IACV,QAAQ;IACR,MAAM;IACN,KAAK;IACL,gBAAgB;IAChB,QAAQ;IACR,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,OAAO;IACP,GAAG;IACH,MAAM;IACN,WAAW;IACX,UAAU;IACV,aAAa;IACb,YAAY;IACZ,UAAU;IACV,YAAY;IACZ,SAAS;IACT,UAAU;IACV,UAAU;IACV,UAAU;IACV,UAAU;IACV,WAAW;IACX,WAAW;IACX,WAAW;IACX,eAAe;IACf,WAAW;IACX,aAAa;IACb,wBAAwB;IACxB,UAAU;IACV,WAAW;IACX,GAAG;IACH,MAAM;IACN,SAAS;IACT,MAAM;IACN,IAAI;IACJ,UAAU;IACV,KAAK;IACL,QAAQ;IACR,eAAe;IACf,UAAU;IACV,MAAM;IACN,kBAAkB;IAClB,SAAS;IACT,MAAM;IACN,SAAS;IACT,SAAS;IACT,MAAM;IACN,MAAM;IACN,YAAY;IACZ,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,SAAS;IACT,UAAU;IACV,YAAY;IACZ,aAAa;IACb,kBAAkB;IAClB,QAAQ;IACR,SAAS;IACT,SAAS;IACT,QAAQ;IACR,YAAY;IACZ,UAAU;IACV,WAAW;IACX,oBAAoB;IACpB,UAAU;IACV,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,cAAc;IACd,iBAAiB;IACjB,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,KAAK;IACL,KAAK;IACL,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,SAAS;IACT,UAAU;IACV,WAAW;IACX,aAAa;IACb,OAAO;IACP,MAAM;IACN,QAAQ;IACR,UAAU;IACV,SAAS;IACT,cAAc;IACd,OAAO;IACP,eAAe;IACf,UAAU;IACV,OAAO;IACP,OAAO;IACP,YAAY;IACZ,OAAO;IACP,MAAM;IACN,QAAQ;IACR,OAAO;IACP,OAAO;IACP,eAAe;IACf,aAAa;IACb,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,OAAO;IACP,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,mBAAmB;IACnB,WAAW;IACX,SAAS;IACT,KAAK;IACL,QAAQ;IACR,MAAM;IACN,OAAO;IACP,MAAM;IACN,UAAU;IACV,MAAM;IACN,WAAW;IACX,UAAU;IACV,MAAM;IACN,SAAS;IACT,OAAO;IACP,WAAW;IACX,OAAO;IACP,QAAQ;IACR,MAAM;IACN,OAAO;IACP,UAAU;IACV,SAAS;IACT,UAAU;IACV,QAAQ;IACR,SAAS;IACT,kBAAkB;IAClB,MAAM;IACN,MAAM;IACN,QAAQ;IACR,aAAa;IACb,YAAY;IACZ,iBAAiB;IACjB,YAAY;IACZ,OAAO;IACP,MAAM;IACN,KAAK;CACN,CAAC"}
+{"version":3,"file":"known-flags.js","sourceRoot":"","sources":["../src/known-flags.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/harness-cli",
-  "version": "0.7.4",
+  "version": "0.7.5",
   "description": "The dz CLI — install AI skills for Claude Code, Codex, OpenCode, Hermes, OpenClaude, GitHub Copilot. 67 commands, 14 presets, 10 platform targets.",
   "type": "module",
   "license": "MIT",
@@ -41,23 +41,23 @@
     "sbom.json"
   ],
   "dependencies": {
-    "@dzhechkov/harness-core": "^0.7.0",
-    "@dzhechkov/harness-presets": "^0.5.0",
-    "@dzhechkov/scout": "^0.8.0",
-    "@dzhechkov/skills-devops": "^0.3.0",
-    "@dzhechkov/skills-mcp": "^0.3.0",
-    "@dzhechkov/skills-web3": "^0.2.0",
-    "@dzhechkov/skills-qe": "^0.3.0",
-    "@dzhechkov/skills-meta": "^0.9.0",
-    "@dzhechkov/skills-academic": "^0.3.0",
-    "@dzhechkov/skills-ecc": "^0.1.0",
-    "@dzhechkov/skills-news": "^0.1.0",
-    "@dzhechkov/skills-pm": "^0.1.0",
-    "@dzhechkov/skills-taste": "^0.1.0",
-    "@dzhechkov/skills-idea2prd": "^0.1.0",
-    "@dzhechkov/skills-reverse-engineering": "^0.1.0",
-    "@dzhechkov/skills-presentation-storyteller": "^0.1.0",
-    "@dzhechkov/skills-website-cloner": "^0.1.0"
+    "@dzhechkov/harness-core": "^0.7.5",
+    "@dzhechkov/scout": "^0.8.7",
+    "@dzhechkov/harness-presets": "^0.5.14",
+    "@dzhechkov/skills-mcp": "^0.3.6",
+    "@dzhechkov/skills-devops": "^0.3.13",
+    "@dzhechkov/skills-web3": "^0.2.5",
+    "@dzhechkov/skills-qe": "^0.3.10",
+    "@dzhechkov/skills-news": "^0.1.12",
+    "@dzhechkov/skills-ecc": "^0.1.8",
+    "@dzhechkov/skills-meta": "^0.9.49",
+    "@dzhechkov/skills-pm": "^0.1.1",
+    "@dzhechkov/skills-academic": "^0.3.3",
+    "@dzhechkov/skills-taste": "^0.1.1",
+    "@dzhechkov/skills-reverse-engineering": "^0.1.9",
+    "@dzhechkov/skills-presentation-storyteller": "^0.1.10",
+    "@dzhechkov/skills-website-cloner": "^0.1.1",
+    "@dzhechkov/skills-idea2prd": "^0.1.11"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",

package/sbom.json

@@ -25,7 +25,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "1f117cb9a9e3ebf8e1ddd9fcd9227c64afa93c4dee354851befdfb1c6f1d1e98"
+          "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": "2adf5f4cd1cdb6f9300c50b67acf6031eb8dfa48eed9e44cceb0e87b705a3335"
+          "content": "6fc728a98d8a920a226a4ee2d8b045ee46e27246c7d7e8bdf15e6c7758f3efbc"
         }
       ]
     },
@@ -95,7 +135,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "86d6f102999ac1b5183775cd8d721b71050ac55b024113f23cca6be1fe494a6c"
+          "content": "4bc5e7cb6563fd672fd7e2c38eac4ba55d54de46940c194b3d2cd5ea4519732a"
         }
       ]
     },
@@ -105,7 +145,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "87e420d5db13a85a12cb185d9da2874c788bfdf26fd44a6400f3799a4b835ccc"
+          "content": "560d103ce98af8095eb7ee86537aa80de7a914fffa693dc23fdf2440a4f76183"
         }
       ]
     },
@@ -189,6 +229,46 @@
         }
       ]
     },
+    {
+      "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",
@@ -205,7 +285,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "4ac14404f0c1d3c75c215fd7eb7b49c7b0b5d2e3f9fe9a22851117fc8944975b"
+          "content": "23fa9b92489e2f39d99397a57f99a4c7566d41b75682d1bbde3f113c480acdcd"
         }
       ]
     },
@@ -215,7 +295,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "a3a40afcc63df47a39512dfc243f989fdf5dabe205342d76ee9ca77e33646976"
+          "content": "f4ed9bddb45629484baf117a3b92eb4097932abda6e5a48227acbc7b5f23f561"
         }
       ]
     },
@@ -225,7 +305,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "8e9dadaf3a205827c7b5dec03a73b2ab15a6ea775e4d6fc58314065c2a43851b"
+          "content": "41bce9592c8192431f7f023271eaf3f548398e5c15441ea69a59e78633915cd9"
         }
       ]
     },
@@ -255,7 +335,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "95d92b6f95141dc44061f0d728d7df200d96518ee42f9ff9174cd0539263cc52"
+          "content": "423120966d33fb4515177a7613f0ace5b392a576098987d0d9ca22aedea96716"
         }
       ]
     },
@@ -269,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": "9564c17c05ac595a2db3eef3ea547b39db88837c84e6efe6c1716fb9f7e16018"
+          "content": "cae511b9b892c43e874ee06b439306290cd2c0a9e6b75cd0cd931d47adaef3f5"
         }
       ]
     },
@@ -299,13 +389,23 @@
         }
       ]
     },
+    {
+      "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": "59b255c1ba248365fe5e9432d7ec8933e73bfcb9cd2ce8e19cf8f85f96137163"
+          "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);
+}