@vibe-agent-toolkit/cli 0.2.0-rc.1 → 0.2.0-rc.10

package/dist/commands/inventory.js

@@ -1,10 +1,13 @@
 import { existsSync } from 'node:fs';
 import { serializeInventory, serializeInventoryShallow, } from '@vibe-agent-toolkit/agent-skills';
-import { crawlSkillLinkRegistry, extractClaudeInstallInventory, extractClaudeMarketplaceInventory, extractClaudePluginInventory, extractClaudeSkillInventory, getClaudeUserPaths, } from '@vibe-agent-toolkit/claude-marketplace';
+import { buildInventoryPopulation, crawlSkillLinkRegistry, extractClaudeInstallInventory, extractClaudeMarketplaceInventory, extractClaudePluginInventory, extractClaudeSkillInventory, getClaudeUserPaths, projectionCrawlSelected, } from '@vibe-agent-toolkit/claude-marketplace';
+import { ExitCode } from '@vibe-agent-toolkit/schema';
 import { findProjectRoot, safePath } from '@vibe-agent-toolkit/utils';
 import { Command } from 'commander';
 import { handleCommandError } from '../utils/command-error.js';
 import { createLogger } from '../utils/logger.js';
+import { populationWiring } from '../utils/population-wiring.js';
+import { withPopulationCache } from '../utils/projection-store.js';
 import { gitTrackerForProjectRoot } from './audit/distributed-tree.js';
 /**
  * Create and configure the `vat inventory` command.
@@ -27,7 +30,6 @@ Description:
   detectors — pure structural enumeration.
 
 Output:
-  - schema: vat.inventory/v1alpha
   - kind: marketplace | plugin | skill | install
   - vendor: claude-code
   - declared / discovered / references / unexpected (per kind)
@@ -49,21 +51,40 @@ export async function inventoryCommand(pathArg, options) {
     const logger = createLogger(options.debug === true ? { debug: true } : {});
     const startTime = Date.now();
     try {
-        const inv = await routeInventory(pathArg, options);
+        const inv = await routeInventory(pathArg, options, logger);
         const format = options.format ?? 'yaml';
         const out = options.shallow === true
             ? serializeInventoryShallow(inv, format)
             : serializeInventory(inv, format);
         process.stdout.write(out);
-        process.exit(0);
+        process.exit(ExitCode.OK);
     }
     catch (error) {
-        handleCommandError(error, logger, startTime, 'Inventory');
+        handleCommandError(error, logger, startTime, 'Inventory', options.format);
     }
 }
-export async function routeInventory(pathArg, options) {
+/**
+ * Dispatch to the extractor the subject's shape calls for.
+ *
+ * @param pathArg - The path argument, or undefined under `--user` / `--system`
+ * @param options - The command's flags
+ * @param logger - Where diagnostics go. Defaults to a REPORTING logger, never a
+ *   silent one: the default has to be the loud behaviour, or a caller acquires
+ *   silence by leaving an argument off — which is the exact defect the blob
+ *   stage's refusal counts were lost to in the first place
+ * @returns The extracted inventory
+ */
+export async function routeInventory(pathArg, options, logger = createLogger()) {
     if (options.user === true) {
-        return extractClaudeInstallInventory(getClaudeUserPaths());
+        // The tracker source is REQUIRED here now, and this is the lane it matters
+        // most on: `--user` walks every cached plugin under ~/.claude/plugins/cache,
+        // and without it every one of those skills answers its gitignore
+        // questions with a `git check-ignore` spawn per link target (which is
+        // what happened while the obligation stopped at `extract-plugin.ts`).
+        return extractClaudeInstallInventory({
+            pathsOrRoot: getClaudeUserPaths(),
+            gitTrackerSource: gitTrackerForProjectRoot,
+        });
     }
     if (options.system === true) {
         throw new Error('--system inventory is not implemented in this version');
@@ -80,29 +101,112 @@ export async function routeInventory(pathArg, options) {
         //
         // A git-tracker source IS worth handing over even for one skill: the saving is per
         // LINK TARGET, not per skill. One `git ls-files` replaces one `git check-ignore`
-        // spawn for every distinct target this skill's link graph reaches.
-        return extractClaudeSkillInventory(absolute, undefined, gitTrackerForProjectRoot);
+        // spawn for every distinct target this skill's link graph reaches. It is also not
+        // optional to hand over: the extractor requires a source, so a lane that wanted
+        // none would have to say `NO_GIT_TRACKER` out loud.
+        return extractClaudeSkillInventory(absolute, { gitTrackerSource: gitTrackerForProjectRoot });
     }
     const claudePluginDir = safePath.join(absolute, '.claude-plugin');
-    // eslint-disable-next-line security/detect-non-literal-fs-filename -- absolute is caller-resolved, used for presence check only
     const hasMarketplace = existsSync(safePath.join(claudePluginDir, 'marketplace.json'));
-    // eslint-disable-next-line security/detect-non-literal-fs-filename -- absolute is caller-resolved, used for presence check only
     const hasPlugin = existsSync(safePath.join(claudePluginDir, 'plugin.json'));
     // A directory with marketplace.json but no plugin.json is a marketplace root.
     // When both are present, the plugin extractor takes precedence (plugin is installed,
     // marketplace.json is a cached metadata artifact alongside it).
     if (hasMarketplace && !hasPlugin) {
-        // No shared registry here: `extractClaudeMarketplaceInventory` (like
-        // `extractClaudeInstallInventory` above) takes no `sharedRegistry` parameter,
-        // so every plugin it fans out to still re-crawls. Threading one through those
-        // two extractors is a claude-marketplace change, not a CLI one.
-        return extractClaudeMarketplaceInventory(absolute);
+        // A tracker source but deliberately NO shared registry: that extractor accepts
+        // only the former, because a marketplace fans out to plugins that each sit in
+        // their own directory, so one registry matches none of their skills' project
+        // roots and was measured 1.5x SLOWER than the N+1 crawl. The tracker source is
+        // the opposite case — asked per skill about its own root, `undefined` where it
+        // cannot serve — so it costs nothing where it does not apply.
+        //
+        // ⚠️ NO shared POPULATION either, and that is the same decision rather than an
+        // oversight: a population is rooted, and `membersOf` refuses any root that is not
+        // the one the extractor derives per skill. Rooted at the marketplace it would
+        // match no skill and answer nothing; rooted per plugin it is not shared. So this
+        // subject shape keeps the walk, and **the flip is plugin-directory-only** — as are
+        // the `--user` and single-`SKILL.md` lanes above, for the same rootedness reason.
+        // Measured on three real marketplace roots (35/51/29 skills): both arms
+        // filed only the walker's `crawl` stratum, no `base`/`closure`, so their identical
+        // output is the two arms agreeing about ONE lane, not evidence about the flip.
+        return extractClaudeMarketplaceInventory(absolute, {
+            gitTrackerSource: gitTrackerForProjectRoot,
+        });
     }
     // Lazy, not eager: the extractor calls this only when it is about to walk its first
     // skill, so a plugin of commands/ and agents/ alone crawls nothing. The tracker source
     // is unconditional — it is asked per skill, about that skill's own root, and answers
     // `undefined` for any root it cannot serve.
-    return extractClaudePluginInventory(absolute, linkRegistryProviderFor(absolute), gitTrackerForProjectRoot);
+    const sharedRegistry = linkRegistryProviderFor(absolute);
+    // Root discovery at the CLI boundary, once, and then handed down — both the
+    // population provider and the store key are rooted, and deriving the root
+    // twice is how two rules drift into disagreeing about which corpus this is.
+    const projectRoot = findProjectRoot(absolute);
+    // The store scopes the whole extraction, not the provider call: the extractor
+    // MEMOIZES `sharedPopulation` and reaches it when it is about to walk its
+    // first skill, which is after this frame would otherwise have closed it.
+    return withPopulationCache({ root: projectRoot ?? absolute }, async (cache) => {
+        const sharedPopulation = populationProviderFor(projectRoot, cache, logger);
+        return extractClaudePluginInventory(absolute, {
+            ...(sharedRegistry !== undefined && { sharedRegistry }),
+            ...(sharedPopulation !== undefined && { sharedPopulation }),
+            gitTrackerSource: gitTrackerForProjectRoot,
+        });
+    });
+}
+/**
+ * The projection-backed membership lane — **now the default for this command** —
+ * or `undefined` to fall back to the incumbent link walk.
+ *
+ * Gated on two things, in this order:
+ *
+ * 1. **Not `VAT_INVENTORY_CRAWL=walker`.** The projection answers this command's
+ *    membership question unless a caller asks for the walk back. It shipped the
+ *    other way round, gated off, while it was a second implementation being
+ *    measured against the first; it is now the implementation, with the walk kept
+ *    reachable as an escape hatch and as the lab's B arm. ⚠️ It is ~5.3× slower on
+ *    a real adopter and that was a deliberate, accepted trade — see
+ *    {@link projectionCrawlSelected} for the measurement and for why neither half
+ *    of the cost can be trimmed without changing the answer.
+ * 2. **A discoverable project root**, exactly as {@link linkRegistryProviderFor}
+ *    requires and for the identical reason: membership is resolved relative to a
+ *    root, and where `findProjectRoot` finds none the extractor falls back to each
+ *    skill's OWN directory — so one population rooted at the plugin would answer a
+ *    different question for every skill. No root, no provider.
+ *
+ * Root discovery belongs at this CLI boundary; this function takes the root the
+ * caller already discovered rather than discovering a second one.
+ *
+ * The tracker is resolved here too, and its absence is not cosmetic: with no
+ * tracker `resource_realizations.gitignored` is `false` on every row, and the
+ * declaration correspondingly drops its gitignore refusal rather than claiming a
+ * branch that cannot run.
+ *
+ * @param projectRoot - The discovered project root, or `null` when there is none
+ * @param cache - The run's projection store, or `undefined` to re-derive. A
+ *   SEPARATE selector from the one above: which crawler answers membership and
+ *   whether the answer is cached are independent choices, and conflating them
+ *   would make the cache unmeasurable against the lane it is supposed to speed up
+ * @param logger - Where the blob stage's refusals are reported. stderr, never
+ *   stdout: this command's stdout is the YAML document a caller parses, and a
+ *   diagnostic in the middle of it would break every consumer
+ * @returns A population source, or `undefined` to use the walk
+ */
+function populationProviderFor(projectRoot, cache, logger) {
+    if (!projectionCrawlSelected())
+        return undefined;
+    if (projectRoot === null)
+        return undefined;
+    return async (skillMdPaths) => {
+        const gitTracker = await gitTrackerForProjectRoot(projectRoot);
+        return buildInventoryPopulation({
+            root: projectRoot,
+            skillMdPaths,
+            // The observer this lane went without — see `populationWiring` for why
+            // the reporting half is written once rather than per lane.
+            ...populationWiring(logger, gitTracker, cache, projectRoot),
+        });
+    };
 }
 /**
  * A way to obtain the ONE markdown registry every skill under `subjectDir` link-walks

package/dist/commands/inventory.js.map

@@ -1 +1 @@
-{"version":3,"file":"inventory.js","sourceRoot":"","sources":["../../src/commands/inventory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"inventory.js","sourceRoot":"","sources":["../../src/commands/inventory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EACN,kBAAkB,EAClB,yBAAyB,GAEzB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACN,wBAAwB,EACxB,sBAAsB,EACtB,6BAA6B,EAC7B,iCAAiC,EACjC,4BAA4B,EAC5B,2BAA2B,EAC3B,kBAAkB,EAClB,uBAAuB,GAEvB,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAe,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAUvE;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACrC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IACzC,OAAO;SACL,WAAW,CAAC,+EAA+E,CAAC;SAC5F,QAAQ,CAAC,QAAQ,EAAE,2CAA2C,CAAC;SAC/D,MAAM,CAAC,QAAQ,EAAE,6DAA6D,CAAC;SAC/E,MAAM,CAAC,UAAU,EAAE,2CAA2C,CAAC;SAC/D,MAAM,CAAC,sBAAsB,EAAE,eAAe,EAAE,MAAM,CAAC;SACvD,MAAM,CAAC,WAAW,EAAE,sCAAsC,CAAC;SAC3D,MAAM,CAAC,SAAS,EAAE,2BAA2B,CAAC;SAC9C,MAAM,CAAC,gBAAgB,CAAC;SACxB,WAAW,CAAC,OAAO,EAAE;;;;;;;;;;;;;;;;;;CAkBvB,CAAC,CAAC;IACF,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,OAA2B,EAC3B,OAAgC;IAEhC,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC;QACxC,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,KAAK,IAAI;YACnC,CAAC,CAAC,yBAAyB,CAAC,GAAG,EAAE,MAAM,CAAC;YACxC,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3E,CAAC;AACF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,OAA2B,EAC3B,OAAgC,EAChC,SAAiB,YAAY,EAAE;IAE/B,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAC3B,2EAA2E;QAC3E,6EAA6E;QAC7E,iEAAiE;QACjE,sEAAsE;QACtE,sEAAsE;QACtE,OAAO,6BAA6B,CAAC;YACpC,WAAW,EAAE,kBAAkB,EAAE;YACjC,gBAAgB,EAAE,wBAAwB;SAC1C,CAAC,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACpE,mFAAmF;QACnF,iFAAiF;QACjF,mFAAmF;QACnF,uBAAuB;QACvB,EAAE;QACF,mFAAmF;QACnF,iFAAiF;QACjF,kFAAkF;QAClF,gFAAgF;QAChF,oDAAoD;QACpD,OAAO,2BAA2B,CAAC,QAAQ,EAAE,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,MAAM,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IAClE,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACtF,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,CAAC;IAC5E,8EAA8E;IAC9E,qFAAqF;IACrF,gEAAgE;IAChE,IAAI,cAAc,IAAI,CAAC,SAAS,EAAE,CAAC;QAClC,+EAA+E;QAC/E,8EAA8E;QAC9E,6EAA6E;QAC7E,+EAA+E;QAC/E,+EAA+E;QAC/E,8DAA8D;QAC9D,EAAE;QACF,+EAA+E;QAC/E,kFAAkF;QAClF,8EAA8E;QAC9E,iFAAiF;QACjF,mFAAmF;QACnF,kFAAkF;QAClF,wEAAwE;QACxE,mFAAmF;QACnF,+EAA+E;QAC/E,OAAO,iCAAiC,CAAC,QAAQ,EAAE;YAClD,gBAAgB,EAAE,wBAAwB;SAC1C,CAAC,CAAC;IACJ,CAAC;IACD,oFAAoF;IACpF,uFAAuF;IACvF,qFAAqF;IACrF,4CAA4C;IAC5C,MAAM,cAAc,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IACzD,4EAA4E;IAC5E,0EAA0E;IAC1E,4EAA4E;IAC5E,MAAM,WAAW,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC9C,8EAA8E;IAC9E,0EAA0E;IAC1E,yEAAyE;IACzE,OAAO,mBAAmB,CAAC,EAAE,IAAI,EAAE,WAAW,IAAI,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAC7E,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAC3E,OAAO,4BAA4B,CAAC,QAAQ,EAAE;YAC7C,GAAG,CAAC,cAAc,KAAK,SAAS,IAAI,EAAE,cAAc,EAAE,CAAC;YACvD,GAAG,CAAC,gBAAgB,KAAK,SAAS,IAAI,EAAE,gBAAgB,EAAE,CAAC;YAC3D,gBAAgB,EAAE,wBAAwB;SAC1C,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,SAAS,qBAAqB,CAC7B,WAA0B,EAC1B,KAAkC,EAClC,MAAc;IAEd,IAAI,CAAC,uBAAuB,EAAE;QAAE,OAAO,SAAS,CAAC;IACjD,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,EAAE;QAC7B,MAAM,UAAU,GAAG,MAAM,wBAAwB,CAAC,WAAW,CAAC,CAAC;QAC/D,OAAO,wBAAwB,CAAC;YAC/B,IAAI,EAAE,WAAW;YACjB,YAAY;YACZ,uEAAuE;YACvE,2DAA2D;YAC3D,GAAG,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC;SAC3D,CAAC,CAAC;IACJ,CAAC,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAS,uBAAuB,CAC/B,UAAkB;IAElB,MAAM,WAAW,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAChD,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC3C,OAAO,GAAG,EAAE,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC;AAClD,CAAC"}

package/dist/commands/mcp/collections.d.ts

@@ -9,7 +9,7 @@
  * Phase 1: Dynamic loading from npm packages or file paths
  * Phase 2+: Global discovery registry
  */
-import type { Agent, OneShotAgentOutput } from '@vibe-agent-toolkit/agent-schema';
+import type { Agent, OneShotAgentOutput } from '@vibe-agent-toolkit/schema';
 export interface AgentRegistration {
     name: string;
     agent: Agent<unknown, OneShotAgentOutput<unknown, string>>;

package/dist/commands/mcp/collections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../../src/commands/mcp/collections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAElF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC9C,iBAAiB,CAAC,EAAE,eAAe,CAAC;IACpC,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CASvF;AA+HD;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAOhF"}
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../../src/commands/mcp/collections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAE5E,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC9C,iBAAiB,CAAC,EAAE,eAAe,CAAC;IACpC,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CASvF;AA+HD;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAOhF"}

package/dist/commands/mcp/list-collections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-collections.d.ts","sourceRoot":"","sources":["../../../src/commands/mcp/list-collections.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAqCf"}
+{"version":3,"file":"list-collections.d.ts","sourceRoot":"","sources":["../../../src/commands/mcp/list-collections.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAqCf"}

package/dist/commands/mcp/list-collections.js

@@ -1,6 +1,7 @@
 /**
  * MCP list-collections command - lists available agent collections
  */
+import { ExitCode } from '@vibe-agent-toolkit/schema';
 import { handleCommandError } from '../../utils/command-error.js';
 import { createLogger } from '../../utils/logger.js';
 import { writeYamlOutput } from '../../utils/output.js';
@@ -34,7 +35,7 @@ export async function listCollectionsCommand(options) {
         logger.info(`Examples:`);
         logger.info(`  vat mcp serve @vibe-agent-toolkit/vat-example-cat-agents`);
         logger.info(`  vat mcp serve ./packages/vat-example-cat-agents  # Local development\n`);
-        process.exit(0);
+        process.exit(ExitCode.OK);
     }
     catch (error) {
         handleCommandError(error, logger, startTime, 'MCPListCollections');

package/dist/commands/mcp/list-collections.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-collections.js","sourceRoot":"","sources":["../../../src/commands/mcp/list-collections.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAMrD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAA+B;IAE/B,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;QAErC,MAAM,MAAM,GAAG;YACb,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC7B,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;aAC3B,CAAC,CAAC;YACH,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,QAAQ,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,IAAI;SACxC,CAAC;QAEF,eAAe,CAAC,MAAM,CAAC,CAAC;QAExB,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACjD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;QAC5E,MAAM,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;QAExF,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QAC1E,MAAM,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;QAExF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC;IACrE,CAAC;AACH,CAAC"}
+{"version":3,"file":"list-collections.js","sourceRoot":"","sources":["../../../src/commands/mcp/list-collections.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAMrD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAA+B;IAE/B,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;QAErC,MAAM,MAAM,GAAG;YACb,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC7B,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;aAC3B,CAAC,CAAC;YACH,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,QAAQ,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,IAAI;SACxC,CAAC;QAEF,eAAe,CAAC,MAAM,CAAC,CAAC;QAExB,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACjD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;QAC5E,MAAM,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;QAExF,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QAC1E,MAAM,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;QAExF,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC;IACrE,CAAC;AACH,CAAC"}

package/dist/commands/mcp/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../src/commands/mcp/serve.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAmCD;;GAEG;AACH,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAwDf"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../src/commands/mcp/serve.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAmCD;;GAEG;AACH,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAwDf"}

package/dist/commands/mcp/serve.js

@@ -2,6 +2,7 @@
  * MCP serve command - exposes agent collections via MCP stdio transport
  */
 import { StdioMCPGateway, ConsoleLogger, NoOpObservabilityProvider, } from '@vibe-agent-toolkit/gateway-mcp';
+import { ExitCode } from '@vibe-agent-toolkit/schema';
 import { handleCommandError } from '../../utils/command-error.js';
 import { createLogger } from '../../utils/logger.js';
 import { resolveCollection } from './collections.js';
@@ -46,7 +47,7 @@ export async function serveCommand(packageOrPath, options) {
             logger.info('Add this to ~/.claude/config.json:\n');
             console.log(generateClaudeDesktopConfig(packageOrPath));
             logger.info('\nThen restart Claude Desktop to load the MCP server.');
-            process.exit(0);
+            process.exit(ExitCode.OK);
         }
         // Resolve collection from package name or file path
         logger.debug(`Resolving MCP collection from: ${packageOrPath}`);
@@ -67,7 +68,7 @@ export async function serveCommand(packageOrPath, options) {
         // Setup graceful shutdown
         process.on('SIGINT', () => {
             logger.info('Shutting down MCP gateway...');
-            process.exit(0);
+            process.exit(ExitCode.OK);
         });
         // Wait for stdin to close (stdio server lifetime = stdin lifetime)
         await new Promise((resolve) => {

package/dist/commands/mcp/serve.js.map

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

package/dist/commands/okf/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `vat okf` command group — Open Knowledge Format bundles.
+ *
+ * One verb today. The group exists rather than a flat `vat okf-validate`
+ * because OKF is a format with more than one producer-side question in it (a
+ * bundle's index files are generated artifacts, §8), and a group is cheaper to
+ * extend than a top-level verb is to deprecate.
+ */
+import { Command } from 'commander';
+export declare function createOkfCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/okf/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/okf/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAI5C,wBAAgB,gBAAgB,IAAI,OAAO,CAmH1C"}

package/dist/commands/okf/index.js

@@ -0,0 +1,114 @@
+/**
+ * `vat okf` command group — Open Knowledge Format bundles.
+ *
+ * One verb today. The group exists rather than a flat `vat okf-validate`
+ * because OKF is a format with more than one producer-side question in it (a
+ * bundle's index files are generated artifacts, §8), and a group is cheaper to
+ * extend than a top-level verb is to deprecate.
+ */
+import { Command, Option } from 'commander';
+import { okfValidateCommand } from './validate.js';
+export function createOkfCommand() {
+    const okf = new Command('okf');
+    okf
+        .description('Validate the Open Knowledge Format (OKF) bundles this project publishes')
+        .helpCommand(false)
+        .addHelpText('after', `
+Description:
+  An OKF bundle is a directory of markdown concept documents, one per file,
+  each carrying YAML frontmatter with a non-empty \`type\`. Bundles are declared
+  in vibe-agent-toolkit.config.yaml:
+
+    okf:
+      bundles:
+        knowledge:
+          root: ./knowledge          # required
+          severity: error            # optional; error is the default
+
+  The population is defined by the SPECIFICATION, not by a glob: every
+  non-reserved .md file anywhere beneath the root is a concept document, and
+  only index.md and log.md are reserved. There is deliberately no include or
+  exclude — a narrower population would let VAT report a clean bundle while a
+  file it never read broke conformance. If a subtree must not be part of a
+  bundle, it must not be under the bundle root.
+
+Example:
+  $ vat okf validate                   # Every declared bundle
+`);
+    okf
+        .command('validate')
+        .description('Check declared OKF bundles for conformance (§11)')
+        .argument('[bundle]', 'Validate only this declared bundle (default: all of them)')
+        .addOption(
+    // `.choices()`, not a bare `.option()`: an unrecognised value used to fall
+    // through to the YAML branch and exit 0, so `--format Json` in a pipeline
+    // failed downstream in `jq` instead of here, where the mistake is.
+    new Option('--format <format>', 'Output format: yaml (default) or json')
+        .choices(['yaml', 'json'])
+        .default('yaml'))
+        .option('--spec-version <version>', 'Cross-check a bundle-root index.md okf_version against this revision (e.g. 0.2). Omitted, a declaration is reported but not judged.')
+        .option('--debug', 'Verbose logging to stderr')
+        .action(async function (bundle) {
+        await okfValidateCommand(bundle, this.optsWithGlobals());
+    })
+        .addHelpText('after', `
+Description:
+  Checks each declared bundle against the OKF v0.2 conformance items VAT
+  implements:
+
+    §11.1  every non-reserved .md carries a parseable YAML frontmatter block
+    §11.2  every one of those blocks carries a non-empty \`type\`
+    §6.1   every markdown LINK and IMAGE — the [text](target) form — resolves
+           inside the bundle. A leading "/" resolves against the BUNDLE ROOT,
+           not the filesystem root, and EVERY path component is judged against
+           the bytes on disk, so a link that opens only because the author's
+           filesystem folds letter case or Unicode normalization form is
+           reported: the bundle is unpacked somewhere that does not fold.
+    §2     every .md under the root is a file whose bytes are under the root. A
+           symlink out of the bundle, or one pointing at nothing, is reported —
+           tar stores a symlink as a symlink, so it arrives dangling.
+    §8/§12 an index.md carries no frontmatter, except a bundle-root index.md,
+           which may carry okf_version and nothing else
+
+  NOT covered by the §6.1 check: wikilinks. \`[[other-concept]]\` is invisible to
+  the markdown parser, so a bundle written in that style gets no cross-link
+  checking at all, and a clean report says nothing about those links.
+
+  §11.3's structural rules for the BODY of index.md and log.md are not
+  implemented, so a clean report means §11.1 and §11.2 in full and §11.3 only
+  in part.
+
+  Unknown \`type\` values and unknown frontmatter keys are legal and are never
+  reported: §4.1 has no central registry and forbids rejecting extra keys.
+
+  The okf_version a bundle-root index.md declares is a CROSS-CHECK, never an
+  input. It is reported as data.bundles[].declaredOkfVersion; pass
+  --spec-version to have a disagreement reported as a finding.
+
+Output (the shared report envelope; schema: packages/cli/schemas/okf-validate.json):
+  status:    ok | findings | error
+  examined:  every document opened and judged, across every bundle. Zero with
+             a data.notice means nothing was checked: no okf.bundles declared,
+             or a declared root that holds no .md at all (a root one level too
+             deep reads exactly like this)
+  findings:  {code, severity, message, location, line?, link?} — location is
+             the project-relative path of the document to open
+  summary:   {errors, warnings, info}; exit 1 iff errors > 0
+  data.bundles[]: {bundle, root, conceptDocuments, reservedDocuments,
+             declaredOkfVersion?} — root as the config wrote it, never absolute
+
+Exit Codes:
+  0 - No error-severity findings
+  1 - At least one error-severity finding. Anything unreadable — the bundle
+      root, one subdirectory, or one document — is reported as a finding naming
+      exactly what could not be read, so the rest of that bundle and every other
+      bundle in the run are still checked and still reported
+  2 - System error (no config file, unknown bundle name)
+
+Example:
+  $ vat okf validate knowledge --format json
+  $ vat okf validate --spec-version 0.2
+`);
+    return okf;
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/okf/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/okf/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAA2B,MAAM,eAAe,CAAC;AAE5E,MAAM,UAAU,gBAAgB;IAC9B,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;IAE/B,GAAG;SACA,WAAW,CAAC,yEAAyE,CAAC;SACtF,WAAW,CAAC,KAAK,CAAC;SAClB,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;;;;;;;CAqBL,CACI,CAAC;IAEJ,GAAG;SACA,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,kDAAkD,CAAC;SAC/D,QAAQ,CAAC,UAAU,EAAE,2DAA2D,CAAC;SACjF,SAAS;IACR,2EAA2E;IAC3E,0EAA0E;IAC1E,mEAAmE;IACnE,IAAI,MAAM,CAAC,mBAAmB,EAAE,uCAAuC,CAAC;SACrE,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SACzB,OAAO,CAAC,MAAM,CAAC,CACnB;SACA,MAAM,CACL,0BAA0B,EAC1B,qIAAqI,CACtI;SACA,MAAM,CAAC,SAAS,EAAE,2BAA2B,CAAC;SAC9C,MAAM,CAAC,KAAK,WAA0B,MAA0B;QAC/D,MAAM,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAwB,CAAC,CAAC;IACjF,CAAC,CAAC;SACD,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDL,CACI,CAAC;IAEJ,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/commands/okf/validate.d.ts

@@ -0,0 +1,191 @@
+/**
+ * `vat okf validate [bundle]` — conformance for the OKF bundles a project declares.
+ *
+ * Producer-side, and the exit code says so: OKF §11 tells CONSUMERS not to
+ * reject a bundle over broken cross-links or unknown keys, but VAT is tooling
+ * for the publisher — the one party who can fix them — so a finding at `error`
+ * severity fails the command. An adopter who wants a softer gate lowers
+ * `okf.bundles.<name>.severity`; the finding is still reported either way.
+ */
+import { type OkfBundleReport } from '@vibe-agent-toolkit/resources';
+import { type Report } from '@vibe-agent-toolkit/schema';
+import { z } from 'zod';
+export interface OkfValidateOptions {
+    format?: 'yaml' | 'json';
+    specVersion?: string;
+    debug?: boolean;
+}
+/** One checked bundle's `data` row: what was read, never the findings (those are the envelope's). */
+export declare const OkfBundleSummarySchema: z.ZodObject<{
+    /** The `okf.bundles.<name>` key. */
+    bundle: z.ZodString;
+    /** The root as the config file wrote it — never the resolved absolute path. */
+    root: z.ZodString;
+    /** Every non-reserved `.md` beneath the root, bundle-relative and sorted. */
+    conceptDocuments: z.ZodArray<z.ZodString, "many">;
+    /** Every `index.md` / `log.md` beneath the root, bundle-relative and sorted. */
+    reservedDocuments: z.ZodArray<z.ZodString, "many">;
+    /** What the root `index.md` declares, when it declares a well-formed one. Reported, never obeyed. */
+    declaredOkfVersion: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    root: string;
+    bundle: string;
+    conceptDocuments: string[];
+    reservedDocuments: string[];
+    declaredOkfVersion?: string | undefined;
+}, {
+    root: string;
+    bundle: string;
+    conceptDocuments: string[];
+    reservedDocuments: string[];
+    declaredOkfVersion?: string | undefined;
+}>;
+export declare const OkfValidateDataSchema: z.ZodObject<{
+    bundles: z.ZodArray<z.ZodObject<{
+        /** The `okf.bundles.<name>` key. */
+        bundle: z.ZodString;
+        /** The root as the config file wrote it — never the resolved absolute path. */
+        root: z.ZodString;
+        /** Every non-reserved `.md` beneath the root, bundle-relative and sorted. */
+        conceptDocuments: z.ZodArray<z.ZodString, "many">;
+        /** Every `index.md` / `log.md` beneath the root, bundle-relative and sorted. */
+        reservedDocuments: z.ZodArray<z.ZodString, "many">;
+        /** What the root `index.md` declares, when it declares a well-formed one. Reported, never obeyed. */
+        declaredOkfVersion: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        root: string;
+        bundle: string;
+        conceptDocuments: string[];
+        reservedDocuments: string[];
+        declaredOkfVersion?: string | undefined;
+    }, {
+        root: string;
+        bundle: string;
+        conceptDocuments: string[];
+        reservedDocuments: string[];
+        declaredOkfVersion?: string | undefined;
+    }>, "many">;
+    /**
+     * Present only when there was nothing to check, and says what to declare or
+     * which root to look at.
+     *
+     * 🪤 The command used to print `status: passed`, `bundles: []`, exit 0 when a
+     * project declared no `okf.bundles` at all — a report indistinguishable from
+     * a bundle read in full and found conformant, so a mistyped key
+     * (`okf.bundle:`, `okf.Bundles:`) read as a clean bill of health. The
+     * envelope's REQUIRED `examined` now says `0` in that case, and this sentence
+     * says why. The exit code stays 0: nothing failed, and failing a build for a
+     * feature the project never opted into would be worse.
+     */
+    notice: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    bundles: {
+        root: string;
+        bundle: string;
+        conceptDocuments: string[];
+        reservedDocuments: string[];
+        declaredOkfVersion?: string | undefined;
+    }[];
+    notice?: string | undefined;
+}, {
+    bundles: {
+        root: string;
+        bundle: string;
+        conceptDocuments: string[];
+        reservedDocuments: string[];
+        declaredOkfVersion?: string | undefined;
+    }[];
+    notice?: string | undefined;
+}>;
+export type OkfBundleSummary = z.infer<typeof OkfBundleSummarySchema>;
+export type OkfValidateData = z.infer<typeof OkfValidateDataSchema>;
+/** The document this command publishes. */
+export declare const OKF_VALIDATE_REPORT_SCHEMA: import("@vibe-agent-toolkit/schema").ReportZodSchema<z.ZodObject<{
+    bundles: z.ZodArray<z.ZodObject<{
+        /** The `okf.bundles.<name>` key. */
+        bundle: z.ZodString;
+        /** The root as the config file wrote it — never the resolved absolute path. */
+        root: z.ZodString;
+        /** Every non-reserved `.md` beneath the root, bundle-relative and sorted. */
+        conceptDocuments: z.ZodArray<z.ZodString, "many">;
+        /** Every `index.md` / `log.md` beneath the root, bundle-relative and sorted. */
+        reservedDocuments: z.ZodArray<z.ZodString, "many">;
+        /** What the root `index.md` declares, when it declares a well-formed one. Reported, never obeyed. */
+        declaredOkfVersion: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        root: string;
+        bundle: string;
+        conceptDocuments: string[];
+        reservedDocuments: string[];
+        declaredOkfVersion?: string | undefined;
+    }, {
+        root: string;
+        bundle: string;
+        conceptDocuments: string[];
+        reservedDocuments: string[];
+        declaredOkfVersion?: string | undefined;
+    }>, "many">;
+    /**
+     * Present only when there was nothing to check, and says what to declare or
+     * which root to look at.
+     *
+     * 🪤 The command used to print `status: passed`, `bundles: []`, exit 0 when a
+     * project declared no `okf.bundles` at all — a report indistinguishable from
+     * a bundle read in full and found conformant, so a mistyped key
+     * (`okf.bundle:`, `okf.Bundles:`) read as a clean bill of health. The
+     * envelope's REQUIRED `examined` now says `0` in that case, and this sentence
+     * says why. The exit code stays 0: nothing failed, and failing a build for a
+     * feature the project never opted into would be worse.
+     */
+    notice: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    bundles: {
+        root: string;
+        bundle: string;
+        conceptDocuments: string[];
+        reservedDocuments: string[];
+        declaredOkfVersion?: string | undefined;
+    }[];
+    notice?: string | undefined;
+}, {
+    bundles: {
+        root: string;
+        bundle: string;
+        conceptDocuments: string[];
+        reservedDocuments: string[];
+        declaredOkfVersion?: string | undefined;
+    }[];
+    notice?: string | undefined;
+}>>;
+export type OkfValidateReport = Report<OkfValidateData>;
+/** One bundle's report beside the absolute root it was read from. */
+export interface CheckedOkfBundle {
+    readonly report: OkfBundleReport;
+    /** The resolved absolute root, so a finding can name a project-relative file. */
+    readonly root: string;
+}
+/**
+ * Assemble the report for a set of checked bundles. Pure, so the status rule
+ * and the denominator are unit-testable.
+ *
+ * `examined` counts every document that was opened and judged — concept and
+ * reserved alike — across every bundle. A declared-but-empty bundle and an
+ * empty declaration both examine zero, and the notice tells them apart.
+ *
+ * @param checked - One report per bundle that was actually checked, with its root
+ * @param projectRoot - What every finding's `location` is relative to
+ * @returns The report
+ */
+export declare function summarizeOkfBundles(checked: readonly CheckedOkfBundle[], projectRoot: string): OkfValidateReport;
+/**
+ * Check every selected bundle and assemble the report.
+ *
+ * Separate from the action so the shape is testable without a process exit.
+ *
+ * @param bundleArg - A single declared bundle name, or undefined for all of them
+ * @param options - Output format and the optional revision to cross-check against
+ */
+export declare function okfValidateReport(bundleArg: string | undefined, options: OkfValidateOptions): Promise<OkfValidateReport>;
+/** Action handler for `vat okf validate [bundle]`. */
+export declare function okfValidateCommand(bundleArg: string | undefined, options: OkfValidateOptions): Promise<void>;
+//# sourceMappingURL=validate.d.ts.map