@vibe-agent-toolkit/cli 0.2.0-rc.6 → 0.2.0-rc.8

package/README.md

@@ -85,7 +85,7 @@ vat doctor --verbose
 ```
 
 **What it checks:**
-- Node.js version (>=20 required)
+- Node.js version (>=22.13.0 required — the range comes from the CLI's own `engines.node`)
 - Git installation and repository
 - Configuration file exists and is valid
 - VAT version (checks for updates)
@@ -103,7 +103,7 @@ report and states how many it hid):
 Running diagnostic checks...
 
 ✅ Node.js version
-   v22.0.0 (meets requirement: >=20.0.0)
+   v22.13.0 (meets requirement: >=22.13.0)
 
 ✅ Git installed
    git version 2.43.0
@@ -131,8 +131,8 @@ If checks fail, doctor provides specific suggestions:
 
 ```
 ❌ Node.js version
-   v18.0.0 is too old. Node.js 20+ required.
-   💡 Upgrade Node.js: https://nodejs.org/ or use nvm
+   v22.4.0 does not satisfy the required range. Node.js >=22.13.0 required.
+   💡 Install a Node.js version in that range: https://nodejs.org/ or use nvm
 ```
 
 ### Configuration
@@ -140,7 +140,6 @@ If checks fail, doctor provides specific suggestions:
 Create `vibe-agent-toolkit.config.yaml` at project root:
 
 ```yaml
-version: 1
 resources:
   include:
     - "docs/**/*.md"

package/dist/bin/vat

@@ -19,7 +19,8 @@ import { existsSync, readFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { findNodeWorkspaceRoot, safePath, } from '@vibe-agent-toolkit/utils';
+import { ExitCode, installLastResortExit } from '@vibe-agent-toolkit/schema';
+import { findNodeWorkspaceRoot, isPathAbsentError, safePath, } from '@vibe-agent-toolkit/utils';
 import { describeStdioBlocking, makeStdioBlocking, } from '@vibe-agent-toolkit/utils/process';
 // Before ANY output. This file — not bin.ts — is what package.json maps `vat` to,
 // so it is the CLI entry point in every installed copy, and `makeStdioBlocking`
@@ -41,6 +42,8 @@ function reportStdioBlocking(debug) {
         console.error(`[vat debug] ${describeStdioBlocking(stdioBlocking)}`);
     }
 }
+// A throw nothing below caught ends on ExitCode.ERROR, never Node's default 1.
+installLastResortExit();
 const __dirname = dirname(fileURLToPath(import.meta.url));
 function spawnCli(binPath, context, contextPath) {
     const env = {
@@ -48,12 +51,14 @@ function spawnCli(binPath, context, contextPath) {
         VAT_CONTEXT: context,
         VAT_CONTEXT_PATH: contextPath,
     };
-    // eslint-disable-next-line sonarjs/no-os-command-from-path -- node is always in PATH for CLI usage
-    const result = spawnSync('node', [binPath, ...process.argv.slice(2)], {
+    // The node running this wrapper, never a PATH lookup: the child must be the
+    // same binary, and `node` by name is whatever PATH says first.
+    const result = spawnSync(process.execPath, [binPath, ...process.argv.slice(2)], {
         stdio: 'inherit',
         env,
     });
-    process.exit(result.status ?? 1);
+    // A child that died of a signal has no status; that is not a finding.
+    process.exit(result.status ?? ExitCode.ERROR);
 }
 /**
  * Check if we're in vibe-agent-toolkit repo (developer mode)
@@ -66,13 +71,10 @@ function getDevModeBinary(projectRoot) {
     const wrapperPath = safePath.join(projectRoot, 'packages/cli/dist/bin/vat.js');
     const binPath = safePath.join(projectRoot, 'packages/cli/dist/bin.js');
     if (process.env['VAT_DEBUG'] === '1') {
-        // eslint-disable-next-line security/detect-non-literal-fs-filename -- checking project structure files for debug
         console.error(`[vat debug] Dev check - wrapper: ${wrapperPath} (${existsSync(wrapperPath)})`);
-        // eslint-disable-next-line security/detect-non-literal-fs-filename -- checking project structure files for debug
         console.error(`[vat debug] Dev check - bin: ${binPath} (${existsSync(binPath)})`);
     }
     // Both files must exist to confirm we're in vibe-agent-toolkit repo
-    // eslint-disable-next-line security/detect-non-literal-fs-filename -- checking project structure files
     if (existsSync(wrapperPath) && existsSync(binPath)) {
         return binPath;
     }
@@ -84,7 +86,7 @@ function getDevModeBinary(projectRoot) {
  * Resolved through Node's OWN resolver rather than by probing a path, because the
  * path this used to probe —
  * `<dir>/node_modules/@vibe-agent-toolkit/cli/dist/bin.js` — assumes npm's flat
- * layout and **does not exist under pnpm** (issue #172). An adopter depending on
+ * layout and **does not exist under pnpm**. An adopter depending on
  * the umbrella `vibe-agent-toolkit` package gets no top-level
  * `node_modules/@vibe-agent-toolkit/` directory at all; the real CLI lives under
  * `node_modules/.pnpm/@vibe-agent-toolkit+cli@<ver>_<hash>/…`. So priority 3 never
@@ -110,7 +112,7 @@ function getDevModeBinary(projectRoot) {
  * `vibe-agent-toolkit` package — the documented way to adopt VAT — the CLI is a
  * TRANSITIVE dependency and is deliberately unreachable from the adopter root.
  * Resolving from the adopter alone would still miss it, which is the umbrella case
- * the issue actually describes. It IS reachable from the umbrella package's own
+ * adopters actually hit. It IS reachable from the umbrella package's own
  * directory, so that package is resolved first (it is a direct dependency, hence
  * visible) and used as the base for the second hop.
  *
@@ -131,7 +133,6 @@ function findLocalInstall(projectRoot) {
         // Still existence-checked: a dependency can be installed without having been
         // built (a fresh workspace checkout, a partial install), and spawning a
         // missing file would fail far from its cause.
-        // eslint-disable-next-line security/detect-non-literal-fs-filename -- checking for local install
         if (existsSync(localBin))
             return localBin;
     }
@@ -140,18 +141,29 @@ function findLocalInstall(projectRoot) {
 /**
  * `require.resolve` reduced to "found it, or didn't".
  *
- * A failure here is priority 3's ordinary "not applicable" answer — no local
+ * A NOT-FOUND is priority 3's ordinary "not applicable" answer — no local
  * install on this base — so it falls through to the next base and ultimately to
- * the global install rather than failing the run.
+ * the global install rather than failing the run. Two codes spell it: the
+ * package is not installed (`MODULE_NOT_FOUND`), or it is installed but too old
+ * to export its manifest (`ERR_PACKAGE_PATH_NOT_EXPORTED`) — either way no
+ * usable local install. Anything else (`ERR_INVALID_ARG_VALUE` from a bad
+ * `fromPath`, a loader fault) is not "absent" and stays loud.
  */
 function tryResolve(fromPath, specifier) {
     try {
         return createRequire(fromPath).resolve(specifier);
     }
-    catch {
-        return null;
+    catch (error) {
+        if (isResolutionNotFound(error))
+            return null;
+        throw error;
     }
 }
+/** The two `require.resolve` codes that mean "nothing usable here". */
+function isResolutionNotFound(error) {
+    const code = error?.code;
+    return code === 'MODULE_NOT_FOUND' || code === 'ERR_PACKAGE_PATH_NOT_EXPORTED';
+}
 /**
  * Read version from package.json
  * @param packageJsonPath - Path to package.json file
@@ -159,17 +171,21 @@ function tryResolve(fromPath, specifier) {
  */
 function readVersion(packageJsonPath) {
     try {
-        // eslint-disable-next-line security/detect-non-literal-fs-filename -- reading version from package.json
         if (!existsSync(packageJsonPath)) {
             return null;
         }
-        // eslint-disable-next-line security/detect-non-literal-fs-filename -- reading version from package.json
         const content = readFileSync(packageJsonPath, 'utf-8');
         const pkg = JSON.parse(content);
         return pkg.version ?? null;
     }
-    catch {
-        return null;
+    catch (error) {
+        // The existence check above is not atomic with the read: a manifest removed
+        // between the two is "not found". A manifest the OS refuses, or one that is
+        // not JSON, is not — this wrapper is about to dispatch to that very install,
+        // and a broken manifest is the first fact worth seeing.
+        if (isPathAbsentError(error))
+            return null;
+        throw error;
     }
 }
 /**
@@ -189,7 +205,6 @@ function main() {
     // Priority 1: Explicit override via VAT_ROOT_DIR
     if (process.env['VAT_ROOT_DIR']) {
         const binPath = safePath.join(process.env['VAT_ROOT_DIR'], 'packages/cli/dist/bin.js');
-        // eslint-disable-next-line security/detect-non-literal-fs-filename -- dynamic path from env is expected
         if (existsSync(binPath)) {
             if (debug) {
                 console.error('[vat debug] Using VAT_ROOT_DIR override');

package/dist/bin/vat.js

@@ -19,7 +19,8 @@ import { existsSync, readFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { findNodeWorkspaceRoot, safePath, } from '@vibe-agent-toolkit/utils';
+import { ExitCode, installLastResortExit } from '@vibe-agent-toolkit/schema';
+import { findNodeWorkspaceRoot, isPathAbsentError, safePath, } from '@vibe-agent-toolkit/utils';
 import { describeStdioBlocking, makeStdioBlocking, } from '@vibe-agent-toolkit/utils/process';
 // Before ANY output. This file — not bin.ts — is what package.json maps `vat` to,
 // so it is the CLI entry point in every installed copy, and `makeStdioBlocking`
@@ -41,6 +42,8 @@ function reportStdioBlocking(debug) {
         console.error(`[vat debug] ${describeStdioBlocking(stdioBlocking)}`);
     }
 }
+// A throw nothing below caught ends on ExitCode.ERROR, never Node's default 1.
+installLastResortExit();
 const __dirname = dirname(fileURLToPath(import.meta.url));
 function spawnCli(binPath, context, contextPath) {
     const env = {
@@ -48,12 +51,14 @@ function spawnCli(binPath, context, contextPath) {
         VAT_CONTEXT: context,
         VAT_CONTEXT_PATH: contextPath,
     };
-    // eslint-disable-next-line sonarjs/no-os-command-from-path -- node is always in PATH for CLI usage
-    const result = spawnSync('node', [binPath, ...process.argv.slice(2)], {
+    // The node running this wrapper, never a PATH lookup: the child must be the
+    // same binary, and `node` by name is whatever PATH says first.
+    const result = spawnSync(process.execPath, [binPath, ...process.argv.slice(2)], {
         stdio: 'inherit',
         env,
     });
-    process.exit(result.status ?? 1);
+    // A child that died of a signal has no status; that is not a finding.
+    process.exit(result.status ?? ExitCode.ERROR);
 }
 /**
  * Check if we're in vibe-agent-toolkit repo (developer mode)
@@ -66,13 +71,10 @@ function getDevModeBinary(projectRoot) {
     const wrapperPath = safePath.join(projectRoot, 'packages/cli/dist/bin/vat.js');
     const binPath = safePath.join(projectRoot, 'packages/cli/dist/bin.js');
     if (process.env['VAT_DEBUG'] === '1') {
-        // eslint-disable-next-line security/detect-non-literal-fs-filename -- checking project structure files for debug
         console.error(`[vat debug] Dev check - wrapper: ${wrapperPath} (${existsSync(wrapperPath)})`);
-        // eslint-disable-next-line security/detect-non-literal-fs-filename -- checking project structure files for debug
         console.error(`[vat debug] Dev check - bin: ${binPath} (${existsSync(binPath)})`);
     }
     // Both files must exist to confirm we're in vibe-agent-toolkit repo
-    // eslint-disable-next-line security/detect-non-literal-fs-filename -- checking project structure files
     if (existsSync(wrapperPath) && existsSync(binPath)) {
         return binPath;
     }
@@ -84,7 +86,7 @@ function getDevModeBinary(projectRoot) {
  * Resolved through Node's OWN resolver rather than by probing a path, because the
  * path this used to probe —
  * `<dir>/node_modules/@vibe-agent-toolkit/cli/dist/bin.js` — assumes npm's flat
- * layout and **does not exist under pnpm** (issue #172). An adopter depending on
+ * layout and **does not exist under pnpm**. An adopter depending on
  * the umbrella `vibe-agent-toolkit` package gets no top-level
  * `node_modules/@vibe-agent-toolkit/` directory at all; the real CLI lives under
  * `node_modules/.pnpm/@vibe-agent-toolkit+cli@<ver>_<hash>/…`. So priority 3 never
@@ -110,7 +112,7 @@ function getDevModeBinary(projectRoot) {
  * `vibe-agent-toolkit` package — the documented way to adopt VAT — the CLI is a
  * TRANSITIVE dependency and is deliberately unreachable from the adopter root.
  * Resolving from the adopter alone would still miss it, which is the umbrella case
- * the issue actually describes. It IS reachable from the umbrella package's own
+ * adopters actually hit. It IS reachable from the umbrella package's own
  * directory, so that package is resolved first (it is a direct dependency, hence
  * visible) and used as the base for the second hop.
  *
@@ -131,7 +133,6 @@ function findLocalInstall(projectRoot) {
         // Still existence-checked: a dependency can be installed without having been
         // built (a fresh workspace checkout, a partial install), and spawning a
         // missing file would fail far from its cause.
-        // eslint-disable-next-line security/detect-non-literal-fs-filename -- checking for local install
         if (existsSync(localBin))
             return localBin;
     }
@@ -140,18 +141,29 @@ function findLocalInstall(projectRoot) {
 /**
  * `require.resolve` reduced to "found it, or didn't".
  *
- * A failure here is priority 3's ordinary "not applicable" answer — no local
+ * A NOT-FOUND is priority 3's ordinary "not applicable" answer — no local
  * install on this base — so it falls through to the next base and ultimately to
- * the global install rather than failing the run.
+ * the global install rather than failing the run. Two codes spell it: the
+ * package is not installed (`MODULE_NOT_FOUND`), or it is installed but too old
+ * to export its manifest (`ERR_PACKAGE_PATH_NOT_EXPORTED`) — either way no
+ * usable local install. Anything else (`ERR_INVALID_ARG_VALUE` from a bad
+ * `fromPath`, a loader fault) is not "absent" and stays loud.
  */
 function tryResolve(fromPath, specifier) {
     try {
         return createRequire(fromPath).resolve(specifier);
     }
-    catch {
-        return null;
+    catch (error) {
+        if (isResolutionNotFound(error))
+            return null;
+        throw error;
     }
 }
+/** The two `require.resolve` codes that mean "nothing usable here". */
+function isResolutionNotFound(error) {
+    const code = error?.code;
+    return code === 'MODULE_NOT_FOUND' || code === 'ERR_PACKAGE_PATH_NOT_EXPORTED';
+}
 /**
  * Read version from package.json
  * @param packageJsonPath - Path to package.json file
@@ -159,17 +171,21 @@ function tryResolve(fromPath, specifier) {
  */
 function readVersion(packageJsonPath) {
     try {
-        // eslint-disable-next-line security/detect-non-literal-fs-filename -- reading version from package.json
         if (!existsSync(packageJsonPath)) {
             return null;
         }
-        // eslint-disable-next-line security/detect-non-literal-fs-filename -- reading version from package.json
         const content = readFileSync(packageJsonPath, 'utf-8');
         const pkg = JSON.parse(content);
         return pkg.version ?? null;
     }
-    catch {
-        return null;
+    catch (error) {
+        // The existence check above is not atomic with the read: a manifest removed
+        // between the two is "not found". A manifest the OS refuses, or one that is
+        // not JSON, is not — this wrapper is about to dispatch to that very install,
+        // and a broken manifest is the first fact worth seeing.
+        if (isPathAbsentError(error))
+            return null;
+        throw error;
     }
 }
 /**
@@ -189,7 +205,6 @@ function main() {
     // Priority 1: Explicit override via VAT_ROOT_DIR
     if (process.env['VAT_ROOT_DIR']) {
         const binPath = safePath.join(process.env['VAT_ROOT_DIR'], 'packages/cli/dist/bin.js');
-        // eslint-disable-next-line security/detect-non-literal-fs-filename -- dynamic path from env is expected
         if (existsSync(binPath)) {
             if (debug) {
                 console.error('[vat debug] Using VAT_ROOT_DIR override');

package/dist/bin/vat.js.map

@@ -1 +1 @@
-{"version":3,"file":"vat.js","sourceRoot":"","sources":["../../src/bin/vat.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vat.js","sourceRoot":"","sources":["../../src/bin/vat.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAG,OAAO,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,QAAQ,GACT,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,mCAAmC,CAAC;AAE3C,kFAAkF;AAClF,gFAAgF;AAChF,gFAAgF;AAChF,2EAA2E;AAC3E,mEAAmE;AACnE,0CAA0C;AAC1C,MAAM,aAAa,GAAG,iBAAiB,EAAE,CAAC;AAE1C;;;;;;;GAOG;AACH,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,eAAe,qBAAqB,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,qBAAqB,EAAE,CAAC;AAExB,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAI1D,SAAS,QAAQ,CAAC,OAAe,EAAE,OAAgB,EAAE,WAAoB;IACvE,MAAM,GAAG,GAAG;QACV,GAAG,OAAO,CAAC,GAAG;QACd,WAAW,EAAE,OAAO;QACpB,gBAAgB,EAAE,WAAW;KAC9B,CAAC;IAEF,4EAA4E;IAC5E,+DAA+D;IAC/D,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;QAC9E,KAAK,EAAE,SAAS;QAChB,GAAG;KACJ,CAAC,CAAC;IAEH,sEAAsE;IACtE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,WAAmB;IAC3C,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,8BAA8B,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,0BAA0B,CAAC,CAAC;IAEvE,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,GAAG,EAAE,CAAC;QACrC,OAAO,CAAC,KAAK,CAAC,oCAAoC,WAAW,KAAK,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC9F,OAAO,CAAC,KAAK,CAAC,gCAAgC,OAAO,KAAK,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpF,CAAC;IAED,oEAAoE;IACpE,IAAI,UAAU,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,SAAS,gBAAgB,CAAC,WAAmB;IAC3C,8EAA8E;IAC9E,0BAA0B;IAC1B,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC1D,MAAM,gBAAgB,GAAG,UAAU,CAAC,WAAW,EAAE,iCAAiC,CAAC,CAAC;IACpF,MAAM,KAAK,GAAG,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IAE1F,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,EAAE,sCAAsC,CAAC,CAAC;QAC9E,IAAI,YAAY,KAAK,IAAI;YAAE,SAAS;QACpC,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QACxE,6EAA6E;QAC7E,wEAAwE;QACxE,8CAA8C;QAC9C,IAAI,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,UAAU,CAAC,QAAgB,EAAE,SAAiB;IACrD,IAAI,CAAC;QACH,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,oBAAoB,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,SAAS,oBAAoB,CAAC,KAAc;IAC1C,MAAM,IAAI,GAAI,KAAmC,EAAE,IAAI,CAAC;IACxD,OAAO,IAAI,KAAK,kBAAkB,IAAI,IAAI,KAAK,+BAA+B,CAAC;AACjF,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,eAAuB;IAC1C,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,OAAO,GAAG,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAyB,CAAC;QACxD,OAAO,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,4EAA4E;QAC5E,4EAA4E;QAC5E,6EAA6E;QAC7E,wDAAwD;QACxD,IAAI,iBAAiB,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,IAAI;IACX,sEAAsE;IACtE,wEAAwE;IACxE,kDAAkD;IAClD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAClE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,GAAG,CAAC;IAE/C,6EAA6E;IAC7E,sDAAsD;IACtD,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAE3B,iDAAiD;IACjD,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,0BAA0B,CAAC,CAAC;QACvF,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;gBACzD,OAAO,CAAC,KAAK,CAAC,uBAAuB,OAAO,EAAE,CAAC,CAAC;YAClD,CAAC;YACD,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,wEAAwE;IACxE,gEAAgE;IAChE,MAAM,WAAW,GAAG,qBAAqB,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;IAEtD,IAAI,OAAe,CAAC;IACpB,IAAI,OAAgB,CAAC;IACrB,IAAI,MAAc,CAAC;IAEnB,wEAAwE;IACxE,MAAM,MAAM,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAC7C,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,GAAG,MAAM,CAAC;QACjB,OAAO,GAAG,KAAK,CAAC;QAChB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,oCAAoC;IACzE,CAAC;IACD,qDAAqD;SAChD,CAAC;QACJ,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,GAAG,QAAQ,CAAC;YACnB,OAAO,GAAG,OAAO,CAAC;YAClB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,oFAAoF;QAC3H,CAAC;QACD,0DAA0D;aACrD,CAAC;YACJ,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YACnD,OAAO,GAAG,QAAQ,CAAC;YACnB,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB;QAClD,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,yEAAyE;IACzE,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IACjF,MAAM,aAAa,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;IACjD,IAAI,YAAY,GAAkB,IAAI,CAAC;IACvC,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAC3D,YAAY,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;IAC3C,CAAC;IAED,eAAe;IACf,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,KAAK,CAAC,6BAA6B,WAAW,EAAE,CAAC,CAAC;QAC1D,OAAO,CAAC,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;QACjD,OAAO,CAAC,KAAK,CAAC,uBAAuB,OAAO,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,KAAK,CAAC,+BAA+B,aAAa,IAAI,SAAS,EAAE,CAAC,CAAC;QAC3E,OAAO,CAAC,KAAK,CAAC,8BAA8B,YAAY,IAAI,KAAK,EAAE,CAAC,CAAC;QACrE,OAAO,CAAC,KAAK,CAAC,qBAAqB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,sFAAsF;IACtF,MAAM,WAAW,GAAG,OAAO,KAAK,KAAK,IAAI,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACvF,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED,oBAAoB;AACpB,IAAI,EAAE,CAAC"}

package/dist/bin.js

@@ -3,6 +3,7 @@
  * Main entry point for vat CLI
  * Uses Commander.js for command structure
  */
+import { ExitCode, installLastResortExit } from '@vibe-agent-toolkit/schema';
 import { safePath } from '@vibe-agent-toolkit/utils';
 import { describeStdioBlocking, makeStdioBlocking } from '@vibe-agent-toolkit/utils/process';
 import { Command, CommanderError } from 'commander';
@@ -11,10 +12,13 @@ import { registerCacheControl } from './commands/cache/cache-control.js';
 import { exitCodeForCommanderEnding } from './utils/command-error.js';
 import { loadVerboseHelp, writeHelpSync } from './utils/help-loader.js';
 import { createLogger } from './utils/logger.js';
+import { createRootArgvGrammar } from './utils/root-argv.js';
 import { version, getVersionString } from './version.js';
 // Before ANY output: a piped stdio is non-blocking, and every command here exits
 // the moment it finishes, so unflushed bytes would be discarded. See output.ts.
 const stdioBlocking = makeStdioBlocking();
+// A throw nothing below caught ends on ExitCode.ERROR, never Node's default 1 — see `installLastResortExit`.
+installLastResortExit();
 // Reported by hand rather than through the parsed `--debug` option because this
 // has to run before Commander parses anything — the same reason the verbose-help
 // checks below read process.argv directly. Reaching through an internal Node
@@ -93,171 +97,53 @@ program.hook('preAction', () => {
         process.chdir(safePath.resolve(cwd));
     }
 });
-// Handle --help --verbose at root level before parsing
-// Manually check process.argv since --verbose is not a root-level option
-const hasHelp = process.argv.includes('--help') || process.argv.includes('-h');
-const hasVerbose = process.argv.includes('--verbose');
-const hasSubcommand = process.argv.slice(2).some(arg => !arg.startsWith('-'));
-if (hasHelp && hasVerbose && !hasSubcommand) {
-    // Root level: vat --help --verbose
-    showVerboseHelp();
-    process.exit(0);
-}
-// Special handling for "resources --verbose" before parsing
-if (process.argv.includes('resources') && process.argv.includes('--verbose')) {
-    const argv = process.argv.slice(2);
-    const resourcesIndex = argv.indexOf('resources');
-    // Check if there's no subcommand after 'resources'
-    const afterResources = argv.slice(resourcesIndex + 1);
-    const hasSubcommand = afterResources.some(arg => !arg.startsWith('-'));
-    if (!hasSubcommand) {
-        (await import('./commands/resources/index.js')).showResourcesVerboseHelp();
-        process.exit(0);
-    }
-}
-// Special handling for "rag --verbose" before parsing
-if (process.argv.includes('rag') && process.argv.includes('--verbose')) {
-    const argv = process.argv.slice(2);
-    const ragIndex = argv.indexOf('rag');
-    // Check if there's no subcommand after 'rag'
-    const afterRag = argv.slice(ragIndex + 1);
-    const hasSubcommand = afterRag.some(arg => !arg.startsWith('-'));
-    if (!hasSubcommand) {
-        (await import('./commands/rag/index.js')).showRagVerboseHelp();
-        process.exit(0);
-    }
-}
-// Special handling for "agent --verbose" before parsing
-if (process.argv.includes('agent') && process.argv.includes('--verbose')) {
-    const argv = process.argv.slice(2);
-    const agentIndex = argv.indexOf('agent');
-    // Check if there's no subcommand after 'agent'
-    const afterAgent = argv.slice(agentIndex + 1);
-    const hasSubcommand = afterAgent.some(arg => !arg.startsWith('-'));
-    if (!hasSubcommand) {
-        (await import('./commands/agent/index.js')).showAgentVerboseHelp();
-        process.exit(0);
-    }
-}
-/** Registers `doctor`, which attaches itself to the program rather than being added. */
-const loadDoctor = async () => (await import('./commands/doctor.js')).doctorCommand(program);
 /**
- * Every option token this program DECLARES, and the subset that consumes the
- * argv token after it.
- *
- * Read off commander's own declarations rather than hardcoded, because the
- * blast radius grows with every future root option. Today that is `--version`,
- * `--cwd <dir>`, `--debug` and `--no-cache`; only `--cwd` takes a value.
- *
- * ORDERING MATTERS: this must run AFTER `registerCacheControl(program)` above,
- * which is what puts `--no-cache` into `program.options`. Built before that
- * call, `--no-cache` would read as undeclared and every `vat --no-cache <verb>`
- * would silently give up the lazy load and register the whole tree — a quiet
- * perf regression with no failing test to announce it.
+ * The argv this program was given, and the grammar every pre-parse decision
+ * below reads it through.
  *
- * Note what is deliberately NOT synthesised here: a `--no-x` twin for boolean
- * options, and a positive `--cache` twin for `--no-cache`. Commander matches an
- * option by exact string (`Option.is()` is `short === arg || long === arg`), so
- * `--no-debug` and `--cache` are UNKNOWN options that end the parse in an
- * error. Accepting them here would re-create the very bug this scan exists to
- * avoid: a token commander rejects, treated by us as an ordinary flag to skip.
+ * ⚠️ Built HERE, and not earlier: `createRootArgvGrammar` reads
+ * `program.options`, which only holds `--no-cache` after
+ * `registerCacheControl(program)` above. See that function for what a
+ * prematurely-built grammar silently costs.
  */
-const declaredRootFlags = new Set(['-h', '--help']);
-const valueTakingRootFlags = new Set();
-const declareRootFlag = (flag, takesValue) => {
-    if (!flag)
-        return;
-    declaredRootFlags.add(flag);
-    if (takesValue)
-        valueTakingRootFlags.add(flag);
-};
-for (const option of program.options) {
-    const takesValue = Boolean(option.required || option.optional);
-    declareRootFlag(option.short, takesValue);
-    declareRootFlag(option.long, takesValue);
-}
-/**
- * Classify an option-shaped token against what this program declares.
- *
- * The `--flag=value` case is not just "strip the suffix": commander only
- * accepts the inline form for a VALUE-TAKING option — its `--foo=bar` branch
- * requires `option.required || option.optional` — so `--debug=1` is an unknown
- * option even though `--debug` is declared.
- *
- * Anything unrecognised is reported as `undeclared` rather than guessed at.
- * The cost of being wrong is asymmetric: a false `undeclared` only forfeits the
- * lazy-load saving, while a false "declared" ships a wrong help page at exit 0.
- */
-function classifyOptionToken(arg) {
-    const equalsIndex = arg.indexOf('=');
-    if (equalsIndex !== -1) {
-        return valueTakingRootFlags.has(arg.slice(0, equalsIndex)) ? 'self-contained' : 'undeclared';
-    }
-    if (!declaredRootFlags.has(arg))
-        return 'undeclared';
-    return valueTakingRootFlags.has(arg) ? 'consumes-next' : 'self-contained';
+const argv = process.argv.slice(2);
+const rootArgv = createRootArgvGrammar(program.options);
+// `--verbose` is not a commander option anywhere — it selects a hand-written
+// help page — so these four checks run before parsing.
+if (rootArgv.wantsRootVerboseHelp(argv)) {
+    showVerboseHelp();
+    process.exit(ExitCode.OK);
 }
 /**
- * The command the user actually asked for, or `undefined` when the whole tree
- * is needed (or nothing is).
- *
- * This must model commander's grammar, not just "the first token without a
- * dash". Two ways a naive scan got it wrong, both shipped and both verified:
- *
- * - **An option's VALUE is not a verb.** `--cwd <dir>` takes a value that does
- *   not start with `-`, so `vat --cwd skills validate` picked `skills`,
- *   registered only that, and left `validate` unregistered — while
- *   `vat --cwd skills validate --help` printed ROOT help and exited **0**.
- *   Only the space-separated form was affected; `--cwd=skills` carries its
- *   value inline. The advertised `vat --cwd <dir> build` also lost the entire
- *   startup saving, since a non-colliding directory matched no loader key and
- *   fell through to loading everything.
- * - **`--help` BEFORE the verb renders ROOT help**, which has to list every
- *   command. Loading only the named one made `vat --help audit` print a help
- *   page claiming the CLI has exactly one command, and exit 0. `vat audit
- *   --help` is the other order and returns on the verb before reaching the
- *   flag, so it still loads just `audit`.
- * - **An UNDECLARED option is not a flag to skip over.** `--help` is only the
- *   most visible member of that class — it is not in `program.options` either,
- *   which is exactly why the bail-out above works. Commander's `parseOptions`
- *   switches its destination to `unknown` at the FIRST unrecognised
- *   option-shaped token and never switches back, so the verb after it never
- *   reaches `operands`; the run ends in `unknownOption()` +
- *   `showHelpAfterError()`, i.e. ROOT help. `vat --verbose audit` therefore
- *   printed an error page listing exactly one command. Every undeclared option
- *   gets the `--help` treatment for that reason.
- * - **A lone `-` is an OPERAND, not an option.** Commander's `maybeOption`
- *   requires `arg.length > 1`, so `-` lands in `operands` and reaches the
- *   `command:*` handler as an unknown command — which again renders root help.
- *   Falling through to the operand return below hands `-` to the dispatcher,
- *   where it matches no loader key and the whole tree loads.
+ * The command groups whose `--verbose` help page is a hand-written document.
  *
- * `--` is option-shaped by the length test but declared by nobody, so it takes
- * the undeclared bail-out. That is the right answer: commander treats every
- * token after it as an operand, and loading the whole tree is always
- * behaviourally correct — the scan only ever trades away startup time.
+ * A table rather than three near-identical blocks: they diverged once already
+ * (see `wantsGroupVerboseHelp`), and the loader stays inside the arrow so the
+ * group's module is imported only when that group is the one being asked about.
  */
-function readRequestedCommand(argv) {
-    for (let index = 0; index < argv.length; index++) {
-        const arg = argv[index];
-        /* c8 ignore next -- index is bounded by argv.length */
-        if (arg === undefined)
-            continue;
-        if (arg === '--help' || arg === '-h')
-            return undefined;
-        if (arg.length > 1 && arg.startsWith('-')) {
-            const kind = classifyOptionToken(arg);
-            if (kind === 'undeclared')
-                return undefined;
-            if (kind === 'consumes-next')
-                index++;
-            continue;
-        }
-        return arg;
+const VERBOSE_HELP_GROUPS = [
+    {
+        group: 'resources',
+        show: async () => (await import('./commands/resources/index.js')).showResourcesVerboseHelp(),
+    },
+    {
+        group: 'rag',
+        show: async () => (await import('./commands/rag/index.js')).showRagVerboseHelp(),
+    },
+    {
+        group: 'agent',
+        show: async () => (await import('./commands/agent/index.js')).showAgentVerboseHelp(),
+    },
+];
+for (const { group, show } of VERBOSE_HELP_GROUPS) {
+    if (rootArgv.wantsGroupVerboseHelp(argv, group)) {
+        await show();
+        process.exit(ExitCode.OK);
     }
-    return undefined;
 }
-const requestedCommand = readRequestedCommand(process.argv.slice(2));
+/** Registers `doctor`, which attaches itself to the program rather than being added. */
+const loadDoctor = async () => (await import('./commands/doctor.js')).doctorCommand(program);
+const requestedCommand = rootArgv.requestedCommand(argv);
 /**
  * Whether this invocation is answerable without any command module.
  *
@@ -271,8 +157,8 @@ const requestedCommand = readRequestedCommand(process.argv.slice(2));
  * has no subcommands.
  */
 const versionOnly = requestedCommand === undefined
-    && process.argv.length > 2
-    && process.argv.slice(2).every(arg => arg === '--version');
+    && argv.length > 0
+    && argv.every(arg => arg === '--version');
 if (requestedCommand === 'doctor') {
     await loadDoctor();
 }

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAGH,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC7F,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAuB,MAAM,cAAc,CAAC;AAE9E,iFAAiF;AACjF,gFAAgF;AAChF,MAAM,aAAa,GAAG,iBAAiB,EAAE,CAAC;AAE1C,6GAA6G;AAC7G,qBAAqB,EAAE,CAAC;AAExB,gFAAgF;AAChF,iFAAiF;AACjF,6EAA6E;AAC7E,8EAA8E;AAC9E,2DAA2D;AAC3D,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;IACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,qBAAqB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,qCAAqC;AACrC,MAAM,OAAO,GAA0B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC/D,CAAC,CAAE;QACC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,CAA+B;QAC9D,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;KACnB;IACtB,CAAC,CAAC,IAAI,CAAC;AAET,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CAAC,gFAAgF,CAAC;IAC9F,4EAA4E;IAC5E,2EAA2E;IAC3E,2EAA2E;IAC3E,sEAAsE;IACtE,2EAA2E;IAC3E,+EAA+E;IAC/E,4EAA4E;IAC5E,2EAA2E;IAC3E,mEAAmE;IACnE,yEAAyE;KACxE,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,uBAAuB,CAAC;KACvG,MAAM,CAAC,aAAa,EAAE,qDAAqD,CAAC;KAC5E,MAAM,CAAC,SAAS,EAAE,sBAAsB,CAAC;KACzC,WAAW,CAAC,KAAK,CAAC,CAAC,uDAAuD;IAC3E,gFAAgF;IAChF,+EAA+E;IAC/E,+EAA+E;IAC/E,+EAA+E;IAC/E,8EAA8E;IAC9E,gFAAgF;IAChF,2EAA2E;IAC3E,EAAE;IACF,2EAA2E;IAC3E,+EAA+E;KAC9E,IAAI,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,aAAa,EAAE,EAAE;IAChD,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QACzC,aAAa,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC,CAAC;KACD,kBAAkB,EAAE;KACpB,eAAe,CAAC;IACf,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,iCAAiC;IAC/E,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,sBAAsB;CACrE,CAAC;KACD,WAAW,CACV,OAAO,EACP;;;;;;;;;;;CAWH,CACE,CAAC;AAEJ,+EAA+E;AAC/E,gEAAgE;AAChE,6EAA6E;AAC7E,+EAA+E;AAC/E,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAE9B,+EAA+E;AAC/E,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;IAC7B,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,EAAoB,CAAC;IACjD,IAAI,GAAG,EAAE,CAAC;QACR,gDAAgD;QAChD,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,CAAC;AACH,CAAC,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAExD,6EAA6E;AAC7E,uDAAuD;AACvD,IAAI,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;IACxC,eAAe,EAAE,CAAC;IAClB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,mBAAmB,GAA8E;IACrG;QACE,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC,CAAC,wBAAwB,EAAE;KAC7F;IACD;QACE,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,kBAAkB,EAAE;KACjF;IACD;QACE,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC,CAAC,oBAAoB,EAAE;KACrF;CACF,CAAC;AAEF,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,mBAAmB,EAAE,CAAC;IAClD,IAAI,QAAQ,CAAC,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,GAAG,KAAK,IAAmB,EAAE,CAC3C,CAAC,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AAEhE,MAAM,gBAAgB,GAAG,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,GACf,gBAAgB,KAAK,SAAS;OAC3B,IAAI,CAAC,MAAM,GAAG,CAAC;OACf,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,WAAW,CAAC,CAAC;AAE5C,IAAI,gBAAgB,KAAK,QAAQ,EAAE,CAAC;IAClC,MAAM,UAAU,EAAE,CAAC;AACrB,CAAC;KAAM,IAAI,gBAAgB,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,gBAAgB,CAAC,EAAE,CAAC;IAC9F,MAAM,IAAI,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAC;IAC/C,gFAAgF;IAChF,IAAI,IAAI;QAAE,OAAO,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC;KAAM,IAAI,CAAC,WAAW,EAAE,CAAC;IACxB,4EAA4E;IAC5E,wEAAwE;IACxE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC;QAAE,OAAO,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IACpF,MAAM,UAAU,EAAE,CAAC;AACrB,CAAC;AAED,0BAA0B;AAC1B,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,EAAE;IACnC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,CAAC,KAAK,CAAC,2BAA2B,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7E,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjB,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAChC,CAAC,CAAC,CAAC;AAEH;;;;;;;;;;;;;;GAcG;AACH,SAAS,sBAAsB,CAAC,OAAgB;IAC9C,OAAO,CAAC,YAAY,EAAE,CAAC;IACvB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,QAAQ;QAAE,sBAAsB,CAAC,GAAG,CAAC,CAAC;AAClE,CAAC;AACD,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAEhC,IAAI,CAAC;IACH,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,4EAA4E;IAC5E,sEAAsE;IACtE,4EAA4E;IAC5E,kDAAkD;IAClD,IAAI,CAAC,CAAC,KAAK,YAAY,cAAc,CAAC;QAAE,MAAM,KAAK,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,eAAe;IACtB,aAAa,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,wCAAwC;AAC5E,CAAC"}