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

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

package/dist/bin.js

@@ -11,6 +11,7 @@ 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.
@@ -93,171 +94,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.
+ * The argv this program was given, and the grammar every pre-parse decision
+ * below reads it through.
  *
- * 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.
- *
- * 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(0);
 }
 /**
- * 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(0);
     }
-    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 +154,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,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,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,CAAC,CAAC,CAAC;AAClB,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,CAAC,CAAC,CAAC;IAClB,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"}

package/dist/command-loaders.d.ts

@@ -5,12 +5,12 @@
  *
  * Each one transitively pulls `@vibe-agent-toolkit/resources` (~1.6s of module
  * load on Windows, dominated by the markdown toolchain), so importing all
- * fourteen made every invocation — `vat --version` included — pay for the whole
+ * sixteen made every invocation — `vat --version` included — pay for the whole
  * CLI surface. Only the command named on the command line is loaded.
  *
  * ## Why `doctor` is not in the table
  *
- * It is the fifteenth top-level command and the only one outside this table, on
+ * It is the seventeenth top-level command and the only one outside this table, on
  * purpose. `doctorCommand(program)` registers itself ONTO the program instead of
  * returning a `Command`, so it does not fit the `() => Promise<Command>` shape —
  * `bin.ts` special-cases it — and it is the command that READS this table, in

package/dist/command-loaders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-loaders.d.ts","sourceRoot":"","sources":["../src/command-loaders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAelE,CAAC"}
+{"version":3,"file":"command-loaders.d.ts","sourceRoot":"","sources":["../src/command-loaders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAiBlE,CAAC"}

package/dist/command-loaders.js

@@ -5,12 +5,12 @@
  *
  * Each one transitively pulls `@vibe-agent-toolkit/resources` (~1.6s of module
  * load on Windows, dominated by the markdown toolchain), so importing all
- * fourteen made every invocation — `vat --version` included — pay for the whole
+ * sixteen made every invocation — `vat --version` included — pay for the whole
  * CLI surface. Only the command named on the command line is loaded.
  *
  * ## Why `doctor` is not in the table
  *
- * It is the fifteenth top-level command and the only one outside this table, on
+ * It is the seventeenth top-level command and the only one outside this table, on
  * purpose. `doctorCommand(program)` registers itself ONTO the program instead of
  * returning a `Command`, so it does not fit the `() => Promise<Command>` shape —
  * `bin.ts` special-cases it — and it is the command that READS this table, in
@@ -54,5 +54,7 @@ export const COMMAND_LOADERS = {
     build: async () => (await import('./commands/build.js')).createBuildTopLevelCommand(),
     validate: async () => (await import('./commands/validate.js')).createValidateTopLevelCommand(),
     verify: async () => (await import('./commands/verify.js')).createVerifyTopLevelCommand(),
+    okf: async () => (await import('./commands/okf/index.js')).createOkfCommand(),
+    ard: async () => (await import('./commands/ard/index.js')).createArdCommand(),
 };
 //# sourceMappingURL=command-loaders.js.map

package/dist/command-loaders.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-loaders.js","sourceRoot":"","sources":["../src/command-loaders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,eAAe,GAA2C;IACrE,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,kBAAkB,EAAE;IAC7E,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC,CAAC,mBAAmB,EAAE;IACtF,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,sBAAsB,EAAE;IACzF,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC,CAAC,sBAAsB,EAAE;IAC/F,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,gBAAgB,EAAE;IAC7E,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC,CAAC,kBAAkB,EAAE;IACnF,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,gBAAgB,EAAE;IAC7E,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC,CAAC,mBAAmB,EAAE;IACtF,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC,CAAC,kBAAkB,EAAE;IACnF,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC,CAAC,mBAAmB,EAAE;IACtF,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC,CAAC,kBAAkB,EAAE;IACnF,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,0BAA0B,EAAE;IACrF,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC,CAAC,6BAA6B,EAAE;IAC9F,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,2BAA2B,EAAE;CACzF,CAAC"}
+{"version":3,"file":"command-loaders.js","sourceRoot":"","sources":["../src/command-loaders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,eAAe,GAA2C;IACrE,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,kBAAkB,EAAE;IAC7E,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC,CAAC,mBAAmB,EAAE;IACtF,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,sBAAsB,EAAE;IACzF,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC,CAAC,sBAAsB,EAAE;IAC/F,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,gBAAgB,EAAE;IAC7E,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC,CAAC,kBAAkB,EAAE;IACnF,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,gBAAgB,EAAE;IAC7E,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC,CAAC,mBAAmB,EAAE;IACtF,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC,CAAC,kBAAkB,EAAE;IACnF,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC,CAAC,mBAAmB,EAAE;IACtF,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC,CAAC,kBAAkB,EAAE;IACnF,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,0BAA0B,EAAE;IACrF,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC,CAAC,6BAA6B,EAAE;IAC9F,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,2BAA2B,EAAE;IACxF,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,gBAAgB,EAAE;IAC7E,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,gBAAgB,EAAE;CAC9E,CAAC"}

package/dist/commands/ard/emit.d.ts

@@ -0,0 +1,104 @@
+/**
+ * `vat ard emit` — write the project's `/.well-known/ard.json`.
+ *
+ * **Emit, never depend.** This command produces a document and stops. Nothing
+ * in VAT reads one back, and no VAT behaviour is derived from one — ARD is
+ * v0.91, status Proposal, and wiring internals to a moving shape is the cost
+ * this rule avoids.
+ */
+import { type ShadowedArdOverrideKey } from '@vibe-agent-toolkit/resources';
+import { type SkippedArdSurface } from './surfaces.js';
+/** Default destination, relative to the project root — the path ARD publishes at. */
+export declare const DEFAULT_ARD_OUTPUT = ".well-known/ard.json";
+/**
+ * Which of the three absences stopped the run.
+ *
+ * 🚨 `loadConfig` returns `undefined` for both "that directory does not exist"
+ * and "that directory has no config file", and the command used to report the
+ * third case for all of them: `--project-root /nope/nothing/here` answered "No
+ * `ard:` configuration found … Add an `ard:` block to
+ * vibe-agent-toolkit.config.yaml", prescribing an edit to a file in a directory
+ * that does not exist. Only a `stat` can tell them apart, so the command does
+ * one rather than inferring from a shared `undefined`.
+ *
+ * The distinction is also what the exit code reads: the first two are system
+ * errors (exit 2, as `vat okf validate` documents for the same conditions), the
+ * third is a project that never opted in (exit 1).
+ */
+export type ArdConfigAbsence = 'no-project-root' | 'no-config-file' | 'no-ard-block';
+/** No manifest could be built, and this says which absence caused it. */
+export declare class ArdConfigMissingError extends Error {
+    readonly projectRoot: string;
+    readonly absence: ArdConfigAbsence;
+    constructor(projectRoot: string, absence: ArdConfigAbsence);
+}
+export interface ArdEmitOptions {
+    /** Project root to read the config from (default: cwd). */
+    projectRoot?: string | undefined;
+    /** Destination path, absolute or relative to the project root. */
+    output?: string | undefined;
+    /**
+     * How the run reports itself: a human line (default) or {@link ArdEmitReport}.
+     *
+     * `text` is the default because it is what the command already wrote, and
+     * this lane's stdout is a published contract.
+     */
+    format?: 'text' | 'json' | undefined;
+    /** Fail the run when it advertises nothing, or skipped a configured surface. */
+    strict?: boolean | undefined;
+    debug?: boolean | undefined;
+}
+export interface ArdEmitResult {
+    readonly outputPath: string;
+    readonly entryCount: number;
+    readonly skipped: readonly SkippedArdSurface[];
+    /**
+     * Bare `ard.entries` keys a qualified key for the same surface outranked.
+     *
+     * Not a failure — the precedence is deterministic and documented — but the
+     * losing block is dead config, and an author cannot see that from the file.
+     */
+    readonly shadowed: readonly ShadowedArdOverrideKey[];
+}
+/**
+ * Build and write the manifest.
+ *
+ * @throws {ArdConfigMissingError} when no config, or no `ard:` block, is found.
+ * @throws {ArdDerivationError} when a surface cannot be turned into a
+ *   conformant entry — a missing `ard.baseUrl`, an unusable URN segment, or a
+ *   trust identity that does not align with the publisher.
+ */
+export declare function runArdEmit(options: ArdEmitOptions): Promise<ArdEmitResult>;
+/**
+ * Whether the manifest this run wrote advertises anything at all.
+ *
+ * `empty` is a separate word for the same reason `vat okf validate` spells
+ * `no-bundles` rather than `passed`: a run that wrote `{"entries":[]}` and one
+ * that wrote a full catalogue both ended at exit 0 with a cheerful line on
+ * stdout, and nothing a machine could read told them apart. A CI step that
+ * emits and publishes was therefore green over a discovery document advertising
+ * nothing.
+ */
+export type ArdEmitStatus = 'written' | 'empty';
+/** The document `--format json` publishes. */
+export interface ArdEmitReport {
+    readonly status: ArdEmitStatus;
+    readonly outputPath: string;
+    readonly entryCount: number;
+    /**
+     * Counts BESIDE the lists, as `vat okf validate` publishes `issueCounts`.
+     *
+     * The count is what a CI step gates on without a JSON path into an array;
+     * the list is what the human it pages then acts on. Publishing only one of
+     * them answers "how many" or "which", never both.
+     */
+    readonly skippedCount: number;
+    readonly shadowedCount: number;
+    readonly skipped: readonly SkippedArdSurface[];
+    readonly shadowed: readonly ShadowedArdOverrideKey[];
+}
+/** Pure: the report a result becomes, so the status rule is unit-testable. */
+export declare function buildArdEmitReport(result: ArdEmitResult): ArdEmitReport;
+/** Action handler for `vat ard emit`. */
+export declare function ardEmitCommand(options: ArdEmitOptions): Promise<void>;
+//# sourceMappingURL=emit.d.ts.map

package/dist/commands/ard/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../../src/commands/ard/emit.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAML,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAC;AASvC,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE3E,qFAAqF;AACrF,eAAO,MAAM,kBAAkB,yBAAyB,CAAC;AAKzD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAErF,yEAAyE;AACzE,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;gBAEvB,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB;CAM3D;AAcD,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACrC,gFAAgF;IAChF,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACtD;AA6BD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CA0ChF;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,CAAC;AAEhD,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACtD;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAUvE;AA2CD,yCAAyC;AACzC,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA4D3E"}