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

package/dist/skill-resolution/packaging-config.js

@@ -1,12 +1,49 @@
 import { findProjectRoot, safePath } from '@vibe-agent-toolkit/utils';
 import { discoverSkillsFromConfig } from '../commands/skills/skill-discovery.js';
 import { loadConfigCached } from '../utils/config-loader.js';
-import { mergeSkillPackagingConfig } from '../utils/skill-packaging-config.js';
+import { collectDeclaredEvalSuites, mergeSkillPackagingConfig } from '../utils/skill-packaging-config.js';
 /** configRoot → (abs SKILL.md path → declared skill name). One expansion per root. */
 const skillDiscoveryCache = new Map();
-/** Clear the per-root discovery cache (call when fixtures mutate between in-process runs). */
+/** configRoot → the project's declared eval suites. One discovery + merge per root. */
+const declaredEvalSuiteCache = new Map();
+/** Clear the per-root discovery caches (call when fixtures mutate between in-process runs). */
 export function resetSkillDiscoveryCache() {
     skillDiscoveryCache.clear();
+    declaredEvalSuiteCache.clear();
+}
+/**
+ * The project's declared eval suites for the config root governing `skillPath`.
+ *
+ * The single-skill counterpart to `collectDeclaredEvalSuites`: commands that resolve one
+ * SKILL.md at a time (`vat audit`, `vat skill review`, `vat skill test`) still need the
+ * WHOLE project's declarations, because test input is a project-wide rule — another
+ * skill's eval suite is an answer key no matter whose bundle is being built.
+ *
+ * Memoized per config root so a run over N skills under one root pays for discovery
+ * once, not N times. Returns `[]` when there is no governing config or no skills
+ * section — wild mode, where there is no project to enumerate.
+ */
+export async function resolveProjectDeclaredEvalSuites(skillPath) {
+    const projectRoot = findProjectRoot(safePath.resolve(safePath.join(skillPath, '..')));
+    if (projectRoot === null)
+        return [];
+    const cached = declaredEvalSuiteCache.get(projectRoot);
+    if (cached !== undefined)
+        return cached;
+    let suites = [];
+    try {
+        const config = loadConfigCached(projectRoot);
+        if (config?.skills !== undefined) {
+            suites = collectDeclaredEvalSuites(config.skills, await discoverSkillsFromConfig(config.skills, projectRoot));
+        }
+    }
+    catch {
+        // A broken or unreadable config is already reported by the caller's own config
+        // load; degrade to the subject's own declaration rather than aborting the run.
+        suites = [];
+    }
+    declaredEvalSuiteCache.set(projectRoot, suites);
+    return suites;
 }
 export async function getDiscoveredSkillsByPath(skillsSection, configRoot) {
     const cached = skillDiscoveryCache.get(configRoot);

package/dist/skill-resolution/packaging-config.js.map

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

package/dist/utils/command-error.d.ts

@@ -1,6 +1,12 @@
 /**
- * Shared command error handling utilities
+ * Shared command error handling utilities.
+ *
+ * THE single implementation of each failure exit. `commands/skills/` used to
+ * carry its own `handleCommandError` that logged to stderr and exited 2 having
+ * written nothing to stdout — same name, same signature, same documented
+ * contract, silently different behaviour. Every command family routes here.
  */
+import { type SeverityCounts, type ValidationIssue } from '@vibe-agent-toolkit/agent-schema';
 import type { Logger } from './logger.js';
 /**
  * Format duration for human readability
@@ -16,4 +22,31 @@ export declare function formatDuration(ms: number): string;
  * @param commandName - Name of the command (for error message)
  */
 export declare function handleCommandError(error: unknown, logger: Logger, startTime: number, commandName: string): never;
+/** The payload a command publishes when its own validation gate stops it. */
+export interface ValidationGateFailure {
+    status: 'error';
+    issueCounts: SeverityCounts;
+    /** What was being validated — a skill name or a path, whichever the lane has. */
+    skill: string;
+}
+/**
+ * Pure: the document {@link handleValidationGateFailure} writes.
+ *
+ * The per-severity distribution rides beside the status because `status: error`
+ * alone cannot say whether the run also carried warnings and info — and the
+ * findings themselves went to stderr, where a piped consumer never sees them.
+ */
+export declare function buildValidationGateFailure(subject: string, issues: readonly ValidationIssue[]): ValidationGateFailure;
+/**
+ * Publish the documented failure payload for a command stopped by its OWN
+ * validation gate, then exit 1.
+ *
+ * {@link handleCommandError} above covers the UNEXPECTED failure (exit 2). This
+ * covers the expected one, and `vat skills build` / `vat skills package` both
+ * exited it after writing zero bytes to stdout — while their `--help` texts
+ * document a YAML summary on stdout and reserve exit 1 for exactly this case.
+ * A consumer running `vat skills build | jq .status` got an empty document and
+ * a bare non-zero code.
+ */
+export declare function handleValidationGateFailure(subject: string, issues: readonly ValidationIssue[]): never;
 //# sourceMappingURL=command-error.d.ts.map

package/dist/utils/command-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-error.d.ts","sourceRoot":"","sources":["../../src/utils/command-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,KAAK,CAWP"}
+{"version":3,"file":"command-error.d.ts","sourceRoot":"","sources":["../../src/utils/command-error.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAmB,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAE9G,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,KAAK,CAWP;AAED,6EAA6E;AAC7E,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,cAAc,CAAC;IAC5B,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,eAAe,EAAE,GACjC,qBAAqB,CAEvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,eAAe,EAAE,GACjC,KAAK,CAGP"}

package/dist/utils/command-error.js

@@ -1,6 +1,12 @@
 /**
- * Shared command error handling utilities
+ * Shared command error handling utilities.
+ *
+ * THE single implementation of each failure exit. `commands/skills/` used to
+ * carry its own `handleCommandError` that logged to stderr and exited 2 having
+ * written nothing to stdout — same name, same signature, same documented
+ * contract, silently different behaviour. Every command family routes here.
  */
+import { countBySeverity } from '@vibe-agent-toolkit/agent-schema';
 import { writeYamlOutput } from './output.js';
 /**
  * Format duration for human readability
@@ -33,4 +39,29 @@ export function handleCommandError(error, logger, startTime, commandName) {
     });
     process.exit(2);
 }
+/**
+ * Pure: the document {@link handleValidationGateFailure} writes.
+ *
+ * The per-severity distribution rides beside the status because `status: error`
+ * alone cannot say whether the run also carried warnings and info — and the
+ * findings themselves went to stderr, where a piped consumer never sees them.
+ */
+export function buildValidationGateFailure(subject, issues) {
+    return { status: 'error', issueCounts: countBySeverity(issues), skill: subject };
+}
+/**
+ * Publish the documented failure payload for a command stopped by its OWN
+ * validation gate, then exit 1.
+ *
+ * {@link handleCommandError} above covers the UNEXPECTED failure (exit 2). This
+ * covers the expected one, and `vat skills build` / `vat skills package` both
+ * exited it after writing zero bytes to stdout — while their `--help` texts
+ * document a YAML summary on stdout and reserve exit 1 for exactly this case.
+ * A consumer running `vat skills build | jq .status` got an empty document and
+ * a bare non-zero code.
+ */
+export function handleValidationGateFailure(subject, issues) {
+    writeYamlOutput(buildValidationGateFailure(subject, issues));
+    process.exit(1);
+}
 //# sourceMappingURL=command-error.js.map

package/dist/utils/command-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-error.js","sourceRoot":"","sources":["../../src/utils/command-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;QACd,OAAO,GAAG,EAAE,IAAI,CAAC;IACnB,CAAC;IACD,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AACvC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAc,EACd,MAAc,EACd,SAAiB,EACjB,WAAmB;IAEnB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;IAEnG,eAAe,CAAC;QACd,MAAM,EAAE,OAAO;QACf,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;QAC/D,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC;KACnC,CAAC,CAAC;IAEH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}
+{"version":3,"file":"command-error.js","sourceRoot":"","sources":["../../src/utils/command-error.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAA6C,MAAM,kCAAkC,CAAC;AAG9G,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;QACd,OAAO,GAAG,EAAE,IAAI,CAAC;IACnB,CAAC;IACD,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AACvC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAc,EACd,MAAc,EACd,SAAiB,EACjB,WAAmB;IAEnB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;IAEnG,eAAe,CAAC;QACd,MAAM,EAAE,OAAO;QACf,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;QAC/D,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC;KACnC,CAAC,CAAC;IAEH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAUD;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAe,EACf,MAAkC;IAElC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACnF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAe,EACf,MAAkC;IAElC,eAAe,CAAC,0BAA0B,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/utils/config-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/utils/config-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAMxF;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBACjB,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAMhD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CA8BzE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvD;AAuBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAgB/E"}
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/utils/config-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAMxF;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBACjB,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAMhD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CA8BzE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvD;AAqBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAgB/E"}

package/dist/utils/config-loader.js

@@ -90,8 +90,6 @@ export function getConfigDir(configPath) {
  *
  * Tests that mutate fixtures between runs must call
  * {@link resetLoadedConfigCache} to invalidate this cache.
- *
- * See spec docs/superpowers/specs/2026-05-17-root-model-and-leading-slash-design.md §8.
  */
 const loadedConfigCache = new Map();
 /**

package/dist/utils/config-loader.js.map

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

package/dist/utils/help-loader.d.ts

@@ -21,8 +21,12 @@ export declare function loadVerboseHelp(section?: string): string;
  * That directly violates this package's own rule that help must survive piping.
  *
  * `writeSync` in a drain loop is the fix: it cannot return before the bytes are
- * handed to the pipe, so `process.exit` has nothing left to lose. The loop is
- * required because a single `writeSync` may accept fewer bytes than offered.
+ * handed to the pipe, so `process.exit` has nothing left to lose.
+ *
+ * The loop itself now lives in `output.ts` as `writeStdoutSync`, because the very
+ * same defect was later found in `writeYamlOutput` — every command's YAML summary
+ * was being truncated at one pipe buffer. Two copies of this reasoning is exactly
+ * how the second lane went unfixed for so long, so there is one.
  */
 export declare function writeHelpSync(content: string): void;
 //# sourceMappingURL=help-loader.d.ts.map

package/dist/utils/help-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help-loader.d.ts","sourceRoot":"","sources":["../../src/utils/help-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAyBxD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAYnD"}
+{"version":3,"file":"help-loader.d.ts","sourceRoot":"","sources":["../../src/utils/help-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAyBxD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEnD"}

package/dist/utils/help-loader.js

@@ -2,10 +2,11 @@
  * Help loader - reads verbose help from markdown files
  * Markdown docs are the source of truth for CLI help
  */
-import { readFileSync, writeSync } from 'node:fs';
+import { readFileSync } from 'node:fs';
 import { dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { safePath } from '@vibe-agent-toolkit/utils';
+import { writeStdoutSync } from './output.js';
 /**
  * Load verbose help from markdown files in packages/cli/docs/
  *
@@ -49,22 +50,14 @@ Please report this issue at: https://github.com/jdutton/vibe-agent-toolkit/issue
  * That directly violates this package's own rule that help must survive piping.
  *
  * `writeSync` in a drain loop is the fix: it cannot return before the bytes are
- * handed to the pipe, so `process.exit` has nothing left to lose. The loop is
- * required because a single `writeSync` may accept fewer bytes than offered.
+ * handed to the pipe, so `process.exit` has nothing left to lose.
+ *
+ * The loop itself now lives in `output.ts` as `writeStdoutSync`, because the very
+ * same defect was later found in `writeYamlOutput` — every command's YAML summary
+ * was being truncated at one pipe buffer. Two copies of this reasoning is exactly
+ * how the second lane went unfixed for so long, so there is one.
  */
 export function writeHelpSync(content) {
-    const buffer = Buffer.from(content.endsWith('\n') ? content : `${content}\n`, 'utf8');
-    let written = 0;
-    while (written < buffer.length) {
-        try {
-            written += writeSync(1, buffer, written, buffer.length - written);
-        }
-        catch (error) {
-            // A non-blocking pipe whose buffer is momentarily full raises EAGAIN; the
-            // reader will drain it, so retry. Anything else is a genuine write failure.
-            if (error.code !== 'EAGAIN')
-                throw error;
-        }
-    }
+    writeStdoutSync(content.endsWith('\n') ? content : `${content}\n`);
 }
 //# sourceMappingURL=help-loader.js.map

package/dist/utils/help-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"help-loader.js","sourceRoot":"","sources":["../../src/utils/help-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,mCAAmC;IACnC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAEtD,wCAAwC;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;IACxD,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAE9D,IAAI,CAAC;QACH,qHAAqH;QACrH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sCAAsC;QACtC,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,OAAO;;0BAEe,QAAQ;;EAEhC,YAAY;;;CAGb,CAAC;IACA,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,EAAE,MAAM,CAAC,CAAC;IACtF,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,OAAO,IAAI,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0EAA0E;YAC1E,4EAA4E;YAC5E,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;QACtE,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"help-loader.js","sourceRoot":"","sources":["../../src/utils/help-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,mCAAmC;IACnC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAEtD,wCAAwC;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;IACxD,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAE9D,IAAI,CAAC;QACH,qHAAqH;QACrH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sCAAsC;QACtC,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,OAAO;;0BAEe,QAAQ;;EAEhC,YAAY;;;CAGb,CAAC;IACA,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;AACrE,CAAC"}

package/dist/utils/issue-anchor.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Rendering for the four `ValidationIssue` anchors.
+ *
+ * `location` / `line` / `field` are independent fields on the issue (see the
+ * anchor contract on `ValidationIssue` in `@vibe-agent-toolkit/agent-schema`).
+ * Splitting them apart in the producers only pays off if the renderers put
+ * them back together — a `line` that no output surface prints is a `line` that,
+ * from the user's side, was deleted. This is the one place that join happens,
+ * so every command spells an anchor the same way.
+ */
+import type { ValidationIssue } from '@vibe-agent-toolkit/agent-schema';
+/**
+ * Render an issue's anchor as a single human/tool-readable string.
+ *
+ * - `docs/guide.md` — file only
+ * - `docs/guide.md:24` — file + line, the `file:line` convention every editor
+ *   and `grep -n` consumer already knows how to jump to
+ * - `SKILL.md (frontmatter.description)` — file + document-internal field
+ * - `(frontmatter.description)` — field with no known file (should not happen
+ *   for skills-lane issues, but the renderer must not silently drop it)
+ *
+ * Returns `undefined` when the issue carries no anchor at all, so callers can
+ * skip the line entirely rather than print an empty label.
+ */
+export declare function formatIssueAnchor(issue: ValidationIssue): string | undefined;
+//# sourceMappingURL=issue-anchor.d.ts.map

package/dist/utils/issue-anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-anchor.d.ts","sourceRoot":"","sources":["../../src/utils/issue-anchor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAe5E"}

package/dist/utils/issue-anchor.js

@@ -0,0 +1,39 @@
+/**
+ * Rendering for the four `ValidationIssue` anchors.
+ *
+ * `location` / `line` / `field` are independent fields on the issue (see the
+ * anchor contract on `ValidationIssue` in `@vibe-agent-toolkit/agent-schema`).
+ * Splitting them apart in the producers only pays off if the renderers put
+ * them back together — a `line` that no output surface prints is a `line` that,
+ * from the user's side, was deleted. This is the one place that join happens,
+ * so every command spells an anchor the same way.
+ */
+/**
+ * Render an issue's anchor as a single human/tool-readable string.
+ *
+ * - `docs/guide.md` — file only
+ * - `docs/guide.md:24` — file + line, the `file:line` convention every editor
+ *   and `grep -n` consumer already knows how to jump to
+ * - `SKILL.md (frontmatter.description)` — file + document-internal field
+ * - `(frontmatter.description)` — field with no known file (should not happen
+ *   for skills-lane issues, but the renderer must not silently drop it)
+ *
+ * Returns `undefined` when the issue carries no anchor at all, so callers can
+ * skip the line entirely rather than print an empty label.
+ */
+export function formatIssueAnchor(issue) {
+    const hasLocation = issue.location !== undefined && issue.location !== '';
+    const hasField = issue.field !== undefined && issue.field !== '';
+    if (!hasLocation && !hasField) {
+        return undefined;
+    }
+    let anchor = hasLocation ? issue.location : '';
+    if (issue.line !== undefined) {
+        anchor = `${anchor}:${String(issue.line)}`;
+    }
+    if (hasField) {
+        anchor = anchor === '' ? `(${issue.field})` : `${anchor} (${issue.field})`;
+    }
+    return anchor;
+}
+//# sourceMappingURL=issue-anchor.js.map

package/dist/utils/issue-anchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-anchor.js","sourceRoot":"","sources":["../../src/utils/issue-anchor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAsB;IACtD,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,EAAE,CAAC;IAC1E,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC;IACjE,IAAI,CAAC,WAAW,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,MAAM,GAAG,WAAW,CAAC,CAAC,CAAE,KAAK,CAAC,QAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;IAC7C,CAAC;IACD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,KAAe,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,KAAK,KAAK,CAAC,KAAe,GAAG,CAAC;IACjG,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/issue-rendering.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Rendering for SETS of `ValidationIssue`s — the severity label, the set's
+ * heading, and the per-issue block.
+ *
+ * `issue-anchor.ts` answers "where is this issue?"; this module answers "what
+ * severity is it, and what is in this set?". Both exist because the answer has
+ * to be spelled identically by every command: two renderers that each invent
+ * their own severity prefix is exactly how `info` findings came to be printed
+ * as `[WARNING]` in `vat skills build` AND `vat claude plugin build`, and how a
+ * mixed set came to be labelled "post-build error(s)" wholesale.
+ *
+ * The failure mode these helpers exist to prevent is directional: every
+ * hand-rolled severity collapse in this codebase mapped the case it could not
+ * represent onto the REASSURING one (info ⇒ "warning", warnings ⇒ "all
+ * passed"). That is why none of it was ever reported — it produces silence, not
+ * a false alarm.
+ */
+import { type SeverityCounts, type ValidationIssue } from '@vibe-agent-toolkit/agent-schema';
+import type { PackageSkillResult } from '@vibe-agent-toolkit/agent-skills';
+/** Render an issue's own severity as itself. */
+export declare function severityLabel(severity: ValidationIssue['severity']): string;
+/**
+ * The severity distribution in prose: `1 error, 2 warnings, 3 info`.
+ *
+ * Zero buckets are omitted so the phrase names only what is present. An
+ * all-zero set returns `no findings` rather than an empty string, because an
+ * empty string silently disappears into whatever sentence embeds it.
+ */
+export declare function formatSeverityBreakdown(counts: SeverityCounts): string;
+/**
+ * Heading for a set of issues: `3 post-build issues (1 error, 2 info)`.
+ *
+ * The breakdown is not decoration — it is the only part of the heading that
+ * cannot be wrong about a mixed set. `noun` qualifies the set ("post-build"),
+ * and is omitted entirely when empty.
+ */
+export declare function formatIssueSetHeading(issues: readonly ValidationIssue[], noun?: string): string;
+/**
+ * Render one issue as its own lines, each prefixed with `indent`.
+ *
+ * Returns an array rather than writing, so a caller can pick its own stream and
+ * a unit test can assert over every line without capturing output.
+ */
+export declare function formatIssueLines(issue: ValidationIssue, indent?: string): string[];
+/**
+ * Render the run-level findings section — findings that belong to the whole
+ * invocation rather than to any one skill (ALLOW_UNUSED is the only producer).
+ *
+ * Shared by `vat skills validate` and `vat skills build` so the two commands
+ * name the same concept the same way. Attributing these to a skill is the
+ * misreading the heading exists to prevent: `validation.allow` is declared once
+ * for the package, so an entry that matched nothing is a fact about the run.
+ *
+ * Returns `[]` for an empty set; callers own their surrounding blank lines.
+ */
+export declare function formatRunIssueLines(runIssues: readonly ValidationIssue[]): string[];
+/**
+ * Every post-build finding a `PackageSkillResult` carries, from BOTH channels.
+ *
+ * `hasErrors` is the OR of two independent sets — the packager's own framework
+ * run (`postBuildIssues`: link exclusions, unreferenced files, broken packaged
+ * links) and the full validation of the built tree (`postBuildValidation`). A
+ * renderer that walks only `postBuildIssues` therefore prints NOTHING for a
+ * build that failed purely on `postBuildValidation`: the user is told the build
+ * failed and shown no reason. Reading both is the whole point of this helper.
+ *
+ * `postBuildValidation.allErrors` is the full emitted set including `info`
+ * (see its doc comment — the name lies), so info findings survive here.
+ */
+export declare function collectPostBuildIssues(result: PackageSkillResult): ValidationIssue[];
+/**
+ * A compact count-only projection of one asset's findings, for summary output.
+ *
+ * Deliberately does NOT carry the asset's name: the three commands that publish
+ * these rows (`vat skills validate`, `vat claude marketplace validate`,
+ * `vat resources validate`) each key their row by a different identity — a skill
+ * name, a plugin name, a file path. A projection that named the asset would have
+ * to pick one, and the two lanes it did not fit would fork their own copy, which
+ * is how the severity collapse came to be spelled five different ways.
+ *
+ * A zero bucket is an ABSENT key, never `0`. Serialized as YAML, three zero
+ * columns per asset is what makes a summary unreadable at corpus scale, and
+ * `errors: 0` beside a red exit code reads as a contradiction rather than as the
+ * "this asset is not the one" it means. `exactOptionalPropertyTypes` is on, so
+ * these are built by spread — assigning `undefined` would emit the key.
+ */
+export interface FindingCountSummary {
+    errors?: number;
+    warnings?: number;
+    info?: number;
+    /** Per-code tally, ordered descending by count then by code name. */
+    codes: Record<string, number>;
+}
+/**
+ * Project a set of issues onto its counts: severity buckets plus a per-code tally.
+ *
+ * Severity counting delegates to `countBySeverity` — there must be exactly one
+ * severity collapse in this codebase (see this module's header). That delegation
+ * carries its rule with it: `ignore` findings land in NO severity bucket, because
+ * the adopter's `validation.allow` config silenced them.
+ *
+ * They do still appear in `codes`, because they were emitted — a code the adopter
+ * allow-listed would otherwise be invisible in every summary, which is the one
+ * place a reviewer would look to notice an allow-list that has quietly grown.
+ *
+ * `codes` is ordered descending by count, ties broken by code name ascending.
+ * Insertion order is the YAML serialization order, so the ordering is the feature:
+ * the first row names the dominant finding without the reader tallying anything.
+ */
+export declare function summarizeFindings(issues: readonly ValidationIssue[]): FindingCountSummary;
+/**
+ * The findings a human-facing report renders IN FULL at a given verbosity.
+ *
+ * One policy, spelled once, because the three verbs that report findings —
+ * `vat skills validate`, `vat skills build`, `vat audit` — each grew their own
+ * answer and landed on three different ones: validate collapsed every severity
+ * into a per-skill count line, while build and audit printed every occurrence.
+ * On a 90-skill adopter that read as 804 lines against 6,552 and 26,480, for
+ * the same corpus.
+ *
+ * The rule is asymmetric on purpose, and the asymmetry is the whole point:
+ *
+ * - **`error` is always rendered in full**, at every verbosity. An error is what
+ *   failed the run, there are few of them, and every one is actionable. Collapsing
+ *   an error into a count means the reader must re-run with a flag to learn what
+ *   broke — which is strictly worse than the verbosity it was meant to fix. This
+ *   is the direction the module header warns about: a collapse that hides the
+ *   thing you needed produces silence, not a false alarm.
+ * - **`warning` and `info` collapse into the caller's summary line** unless
+ *   `verbose`. These are the high-cardinality findings (one adopter skill carries
+ *   348 `LINK_DROPPED_BY_DEPTH` warnings alone), and a count plus a per-code tally
+ *   answers "what is going on here?" without the reader scrolling past 348 near-
+ *   identical blocks.
+ * - **`ignore` never renders**, at any verbosity: the adopter's `validation.allow`
+ *   config silenced it deliberately. It stays visible in `summarizeFindings`'
+ *   `codes` tally, which is where a quietly-growing allow-list is noticed.
+ *
+ * This decides only WHICH findings are rendered, never HOW. Each lane keeps its
+ * own heading and summary line — those legitimately differ — so this can be shared
+ * without forcing one layout onto three commands.
+ *
+ * The machine-readable document is NOT filtered by this. `vat audit`'s YAML and
+ * `vat skills build`'s `issueCounts` carry every finding at every verbosity;
+ * anything else would silently break consumers that parse them.
+ */
+export declare function issuesToRenderAtVerbosity(issues: readonly ValidationIssue[], verbose: boolean): readonly ValidationIssue[];
+/** Sum severity counts across lanes (per-skill → per-plugin → per-run). */
+export declare function sumSeverityCounts(counts: readonly SeverityCounts[]): SeverityCounts;
+//# sourceMappingURL=issue-rendering.d.ts.map

package/dist/utils/issue-rendering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-rendering.d.ts","sourceRoot":"","sources":["../../src/utils/issue-rendering.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAiB3E,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,GAAG,MAAM,CAE3E;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAYtE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,CAKR;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,SAAK,GAAG,MAAM,EAAE,CAY9E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,EAAE,CAUnF;AAcD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,EAAE,CAapF;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,mBAAmB,CAuBzF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,OAAO,EAAE,OAAO,GACf,SAAS,eAAe,EAAE,CAI5B;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG,cAAc,CASnF"}