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

package/dist/utils/output.js.map

@@ -1 +1 @@
-{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE;QACxC,MAAM,EAAE,CAAC;QACT,SAAS,EAAE,GAAG;QACd,qBAAqB,EAAE,KAAK;KAC7B,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,IAAI,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YACrC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,IAAY,EACZ,MAAc,EACd,QAAgB,EAChB,OAAe;IAEf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,IAAI,IAAI,MAAM,KAAK,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC;AAC/E,CAAC"}
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"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"}

package/dist/utils/relativize-paths.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Re-basing report `path` values onto the run's single stated root.
+ *
+ * A report states its coordinate system ONCE — `root:` — and every `path`
+ * beneath it is relative to that. Producers keep absolute paths internally on
+ * purpose: an absolute path is the identity every internal map keys on (compat
+ * results, visited-path de-duplication, registry caches), and unlike a
+ * `location` it is trivially recoverable, since an absolute path plus a known
+ * root yields the relative form. Re-basing therefore happens once, at the
+ * document boundary, and this module is that one place.
+ *
+ * Deliberately NOT a deep walk over every `path`-named property: re-basing is
+ * not idempotent (`relative(root, someRelativeValue)` resolves the value
+ * against the process cwd and produces nonsense), so a helper that guesses
+ * which values are absolute would silently corrupt an already-relative one.
+ * The caller names the nested carriers it owns instead.
+ */
+/** The minimum shape this module re-bases: anything carrying a `path`. */
+export interface PathEntry {
+    path: string;
+}
+/**
+ * Re-base one absolute path onto `root`, as a forward-slashed relative path.
+ *
+ * Pointing a report AT a single resource makes that resource the root, which
+ * relativizes to the empty string. That is spelled `.` — the POSIX name for
+ * "the root itself" — so no consumer has to special-case a blank value, and
+ * `join(root, path)` still resolves.
+ */
+export declare function relativizePath(absolutePath: string, root: string): string;
+/**
+ * Re-base the `path` of every entry — and of every entry inside the nested
+ * carriers named by `nestedKeys`, at any depth — onto `root`.
+ *
+ * Returns new objects; the input is never mutated.
+ *
+ * @param entries - Report entries carrying absolute `path` values.
+ * @param root - The single root the document states.
+ * @param nestedKeys - Names of array-valued properties whose elements also
+ *   carry an absolute `path` (audit passes `['linkedFiles']`). Omitting a
+ *   carrier leaves its paths absolute, which is how a document ends up in two
+ *   coordinate systems — so a producer that adds a carrier must name it here.
+ */
+export declare function relativizePathEntries<T extends PathEntry>(entries: readonly T[], root: string, nestedKeys?: readonly string[]): T[];
+//# sourceMappingURL=relativize-paths.d.ts.map

package/dist/utils/relativize-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relativize-paths.d.ts","sourceRoot":"","sources":["../../src/utils/relativize-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,0EAA0E;AAC1E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGzE;AA+BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,SAAS,EACvD,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,SAAS,MAAM,EAAO,GACjC,CAAC,EAAE,CAEL"}

package/dist/utils/relativize-paths.js

@@ -0,0 +1,67 @@
+/**
+ * Re-basing report `path` values onto the run's single stated root.
+ *
+ * A report states its coordinate system ONCE — `root:` — and every `path`
+ * beneath it is relative to that. Producers keep absolute paths internally on
+ * purpose: an absolute path is the identity every internal map keys on (compat
+ * results, visited-path de-duplication, registry caches), and unlike a
+ * `location` it is trivially recoverable, since an absolute path plus a known
+ * root yields the relative form. Re-basing therefore happens once, at the
+ * document boundary, and this module is that one place.
+ *
+ * Deliberately NOT a deep walk over every `path`-named property: re-basing is
+ * not idempotent (`relative(root, someRelativeValue)` resolves the value
+ * against the process cwd and produces nonsense), so a helper that guesses
+ * which values are absolute would silently corrupt an already-relative one.
+ * The caller names the nested carriers it owns instead.
+ */
+import { issueLocation } from '@vibe-agent-toolkit/utils';
+/**
+ * Re-base one absolute path onto `root`, as a forward-slashed relative path.
+ *
+ * Pointing a report AT a single resource makes that resource the root, which
+ * relativizes to the empty string. That is spelled `.` — the POSIX name for
+ * "the root itself" — so no consumer has to special-case a blank value, and
+ * `join(root, path)` still resolves.
+ */
+export function relativizePath(absolutePath, root) {
+    const relative = issueLocation(absolutePath, root);
+    return relative === '' ? '.' : relative;
+}
+/** Whether an unknown value is shaped like something this module can re-base. */
+function isPathEntry(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.path === 'string');
+}
+function relativizeEntry(entry, root, nestedKeys) {
+    const out = { ...entry, path: relativizePath(entry.path, root) };
+    // The nested carriers are named by the caller, so they are not on T's known
+    // keys; the bag view is the only way to reach them without demanding every
+    // caller widen its own result type.
+    const bag = out;
+    for (const key of nestedKeys) {
+        const nested = bag[key];
+        if (!Array.isArray(nested))
+            continue;
+        bag[key] = nested.map((item) => isPathEntry(item) ? relativizeEntry(item, root, nestedKeys) : item);
+    }
+    return out;
+}
+/**
+ * Re-base the `path` of every entry — and of every entry inside the nested
+ * carriers named by `nestedKeys`, at any depth — onto `root`.
+ *
+ * Returns new objects; the input is never mutated.
+ *
+ * @param entries - Report entries carrying absolute `path` values.
+ * @param root - The single root the document states.
+ * @param nestedKeys - Names of array-valued properties whose elements also
+ *   carry an absolute `path` (audit passes `['linkedFiles']`). Omitting a
+ *   carrier leaves its paths absolute, which is how a document ends up in two
+ *   coordinate systems — so a producer that adds a carrier must name it here.
+ */
+export function relativizePathEntries(entries, root, nestedKeys = []) {
+    return entries.map((entry) => relativizeEntry(entry, root, nestedKeys));
+}
+//# sourceMappingURL=relativize-paths.js.map

package/dist/utils/relativize-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relativize-paths.js","sourceRoot":"","sources":["../../src/utils/relativize-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAO1D;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,YAAoB,EAAE,IAAY;IAC/D,MAAM,QAAQ,GAAG,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACnD,OAAO,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC1C,CAAC;AAED,iFAAiF;AACjF,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ,CACvD,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,KAAQ,EACR,IAAY,EACZ,UAA6B;IAE7B,MAAM,GAAG,GAAG,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;IACjE,4EAA4E;IAC5E,2EAA2E;IAC3E,oCAAoC;IACpC,MAAM,GAAG,GAAG,GAAyC,CAAC;IACtD,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,SAAS;QACrC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAa,EAAE,EAAE,CACtC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CACnE,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAqB,EACrB,IAAY,EACZ,aAAgC,EAAE;IAElC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;AAC1E,CAAC"}

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

@@ -11,6 +11,18 @@ export interface ResourceLoadResult {
     registry: ResourceRegistry;
     gitTracker: GitTracker | undefined;
 }
+/**
+ * Scope resource include patterns to a subdirectory of the crawl base.
+ *
+ * Pure, and exported so the scoping rule is testable without a filesystem.
+ * `relDir` is base-relative with forward slashes; `''` means "the base itself",
+ * for which the patterns are already correctly scoped.
+ *
+ * The patterns in {@link DEFAULT_RESOURCE_INCLUDE} are all `**`-rooted, so
+ * prefixing is enough: picomatch's `**` matches zero segments, meaning
+ * `docs/**\/*.md` still matches `docs/a.md`.
+ */
+export declare function scopeIncludeToSubtree(include: readonly string[], relDir: string): string[];
 /**
  * Load resources from a path with config support
  *
@@ -20,8 +32,15 @@ export interface ResourceLoadResult {
  * 3. Create registry and crawl
  *
  * Behavior:
- * - When path argument provided: use as baseDir, ignore config patterns (use defaults)
- * - When no path argument: use project root as baseDir, apply config patterns
+ * - When no path argument: crawl the project root, applying the config's
+ *   `resources.include` and `resources.exclude` patterns.
+ * - When a path argument is provided: still crawl on the project-root basis (so
+ *   the config's root-relative globs remain meaningful), with `include` replaced
+ *   by the default resource patterns scoped to that subtree and the config's
+ *   `exclude` still applied. A path argument says WHICH tree to scan; it does
+ *   not license scanning files the project excluded.
+ * - When the path argument lies outside the project root, the config's patterns
+ *   describe a different tree: they are dropped, with a warning.
  *
  * Per CLI-boundary rule (spec §5): `projectRoot` MUST be resolved by the
  * caller using one of the policy helpers in `project-root-policy.ts`. This

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

@@ -1 +1 @@
-{"version":3,"file":"resource-loader.d.ts","sourceRoot":"","sources":["../../src/utils/resource-loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,KAAK,aAAa,EAEnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAGvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;IAClC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,kBAAkB,CAAC,CA2D7B"}
+{"version":3,"file":"resource-loader.d.ts","sourceRoot":"","sources":["../../src/utils/resource-loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAEL,gBAAgB,EAEhB,KAAK,aAAa,EAEnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAA4B,MAAM,2BAA2B,CAAC;AAGjF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;IAClC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;CACpC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAK1F;AAkED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,kBAAkB,CAAC,CAuD7B"}

package/dist/utils/resource-loader.js

@@ -1,9 +1,79 @@
 /**
  * Utilities for loading and crawling resources
  */
-import { ResourceRegistry, } from '@vibe-agent-toolkit/resources';
-import { GitTracker } from '@vibe-agent-toolkit/utils';
+import { existsSync, statSync } from 'node:fs';
+import { DEFAULT_RESOURCE_INCLUDE, ResourceRegistry, } from '@vibe-agent-toolkit/resources';
+import { GitTracker, safePath, toForwardSlash } from '@vibe-agent-toolkit/utils';
 import { loadConfig } from './config-loader.js';
+/**
+ * Scope resource include patterns to a subdirectory of the crawl base.
+ *
+ * Pure, and exported so the scoping rule is testable without a filesystem.
+ * `relDir` is base-relative with forward slashes; `''` means "the base itself",
+ * for which the patterns are already correctly scoped.
+ *
+ * The patterns in {@link DEFAULT_RESOURCE_INCLUDE} are all `**`-rooted, so
+ * prefixing is enough: picomatch's `**` matches zero segments, meaning
+ * `docs/**\/*.md` still matches `docs/a.md`.
+ */
+export function scopeIncludeToSubtree(include, relDir) {
+    if (relDir === '') {
+        return [...include];
+    }
+    return include.map((pattern) => `${relDir}/${pattern}`);
+}
+/**
+ * Build the crawl options for an explicit path argument.
+ *
+ * The path argument RESTATES which tree to scan; it does not license scanning
+ * files the project has declared out of bounds. So `exclude` — a "never treat
+ * this as a resource" statement about node_modules, build output, vendored
+ * trees, and deliberately-broken test fixtures — is applied either way, while
+ * the path replaces `include`.
+ *
+ * That is only expressible by keeping `baseDir` at the project root: config
+ * globs are declared relative to the project root, so re-basing the crawl onto
+ * the path argument (the previous behavior) silently voided every one of them.
+ * Instead the path argument becomes an include PREFIX on the same basis.
+ */
+function crawlOptionsForPath(pathArg, projectRoot, config, logger) {
+    const resolved = safePath.resolve(pathArg);
+    // safePath.relative already normalizes, but toForwardSlash makes the
+    // separator assumption in the `../` test below explicit on Windows too.
+    const normalizedRelDir = toForwardSlash(safePath.relative(projectRoot, resolved));
+    if (normalizedRelDir === '..' || normalizedRelDir.startsWith('../')) {
+        // Outside the project root, so the config's root-relative globs describe a
+        // different tree and genuinely cannot apply. Say so rather than dropping
+        // them silently — silent dropping is the bug this function exists to fix.
+        logger.warn(`${resolved} is outside projectRoot ${projectRoot}; ` +
+            `resources include/exclude patterns from the config do not apply to it`);
+        return { baseDir: resolved };
+    }
+    assertCrawlableDirectory(resolved);
+    return {
+        baseDir: projectRoot,
+        include: scopeIncludeToSubtree(DEFAULT_RESOURCE_INCLUDE, normalizedRelDir),
+        ...(config?.resources?.exclude ? { exclude: config.resources.exclude } : {}),
+    };
+}
+/**
+ * Fail loudly on a path argument that cannot be crawled.
+ *
+ * The crawler used to perform this check itself, because it received the path
+ * argument as its `baseDir`. Now that `baseDir` is the project root, a bad path
+ * argument would otherwise degrade into a glob that matches nothing — a green
+ * run reporting `filesScanned: 0`.
+ */
+function assertCrawlableDirectory(resolved) {
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- CLI path argument, resolved above
+    if (!existsSync(resolved)) {
+        throw new Error(`Path does not exist: ${resolved}`);
+    }
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- CLI path argument, existence checked above
+    if (!statSync(resolved).isDirectory()) {
+        throw new Error(`Path is not a directory: ${resolved}`);
+    }
+}
 /**
  * Load resources from a path with config support
  *
@@ -13,8 +83,15 @@ import { loadConfig } from './config-loader.js';
  * 3. Create registry and crawl
  *
  * Behavior:
- * - When path argument provided: use as baseDir, ignore config patterns (use defaults)
- * - When no path argument: use project root as baseDir, apply config patterns
+ * - When no path argument: crawl the project root, applying the config's
+ *   `resources.include` and `resources.exclude` patterns.
+ * - When a path argument is provided: still crawl on the project-root basis (so
+ *   the config's root-relative globs remain meaningful), with `include` replaced
+ *   by the default resource patterns scoped to that subtree and the config's
+ *   `exclude` still applied. A path argument says WHICH tree to scan; it does
+ *   not license scanning files the project excluded.
+ * - When the path argument lies outside the project root, the config's patterns
+ *   describe a different tree: they are dropped, with a warning.
  *
  * Per CLI-boundary rule (spec §5): `projectRoot` MUST be resolved by the
  * caller using one of the policy helpers in `project-root-policy.ts`. This
@@ -48,14 +125,11 @@ export async function loadResourcesWithConfig(pathArg, projectRoot, logger) {
     const registry = new ResourceRegistry(registryOptions);
     let crawlOptions;
     if (pathArg) {
-        // Path argument provided: crawl from that directory with default patterns
-        // Ignore config patterns because they're relative to project root
+        // Path argument provided: narrow the scan to that subtree, but keep the
+        // project's exclude patterns — see crawlOptionsForPath.
         logger.debug(`Path argument provided: ${pathArg}`);
-        logger.debug('Using default patterns (ignoring config)');
-        crawlOptions = {
-            baseDir: pathArg,
-            // Use defaults from ResourceRegistry.crawl (will use **/*.md)
-        };
+        crawlOptions = crawlOptionsForPath(pathArg, projectRoot, config, logger);
+        logger.debug(`Crawling ${crawlOptions.baseDir} with include: ${JSON.stringify(crawlOptions.include)}`);
     }
     else {
         // No path argument: crawl from projectRoot with config patterns

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

@@ -1 +1 @@
-{"version":3,"file":"resource-loader.js","sourceRoot":"","sources":["../../src/utils/resource-loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,GAGjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAWhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAA2B,EAC3B,WAAmB,EACnB,MAAc;IAEd,yDAAyD;IACzD,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAEvC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,KAAK,CAAC,sBAAsB,WAAW,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,yEAAyE;IACzE,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC;IACpC,MAAM,CAAC,KAAK,CAAC,+BAA+B,KAAK,CAAC,SAAS,gBAAgB,CAAC,CAAC;IAE7E,4BAA4B;IAC5B,oEAAoE;IACpE,MAAM,eAAe,GAA4B;QAC/C,OAAO,EAAE,WAAW;QACpB,UAAU;KACX,CAAC;IACF,IAAI,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;QACnC,eAAe,CAAC,MAAM,GAAG,MAAM,CAAC;IAClC,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,eAAe,CAAC,CAAC;IAEvD,IAAI,YAAY,CAAC;IAEjB,IAAI,OAAO,EAAE,CAAC;QACZ,0EAA0E;QAC1E,kEAAkE;QAClE,MAAM,CAAC,KAAK,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAEzD,YAAY,GAAG;YACb,OAAO,EAAE,OAAO;YAChB,8DAA8D;SAC/D,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,gEAAgE;QAChE,MAAM,CAAC,KAAK,CAAC,4BAA4B,WAAW,EAAE,CAAC,CAAC;QAExD,YAAY,GAAG;YACb,OAAO,EAAE,WAAW;YACpB,oDAAoD;YACpD,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5E,oDAAoD;YACpD,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7E,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAEnC,OAAO;QACL,QAAQ,EAAE,OAAO,IAAI,WAAW;QAChC,WAAW;QACX,MAAM;QACN,QAAQ;QACR,UAAU;KACX,CAAC;AACJ,CAAC"}
+{"version":3,"file":"resource-loader.js","sourceRoot":"","sources":["../../src/utils/resource-loader.ts"],"names":[],"mappings":"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"}

package/dist/utils/skill-packaging-config.d.ts

@@ -9,7 +9,8 @@
  * Most fields are a shallow override: a per-skill value replaces the default
  * outright. `files:` is the exception — see below.
  */
-import { type SkillPackagingConfig } from '@vibe-agent-toolkit/agent-skills';
+import { type DeclaredEvalSuite, type SkillPackagingConfig } from '@vibe-agent-toolkit/agent-skills';
+import type { SkillsConfig } from '@vibe-agent-toolkit/resources';
 /**
  * Merge defaults with per-skill overrides, dropping undefined values.
  *
@@ -25,4 +26,24 @@ import { type SkillPackagingConfig } from '@vibe-agent-toolkit/agent-skills';
  * the build did — the exact class of divergence this module exists to prevent.
  */
 export declare function mergeSkillPackagingConfig(defaults: Record<string, unknown> | undefined, perSkillOverrides: Record<string, unknown> | undefined): SkillPackagingConfig;
+/**
+ * The PROJECT's declared eval suites: one {@link DeclaredEvalSuite} per discovered
+ * skill, from the same discovery + merge every lane already runs.
+ *
+ * Test input never ships, and that rule is project-wide rather than per-skill — a file
+ * ANY skill declares as its eval suite is an answer key, and no other skill's bundle may
+ * carry it. Every lane that packages or models a bundle therefore needs the whole
+ * project's declarations, not just the subject's.
+ *
+ * Build this ONCE per invocation, from the UNFILTERED discovery, and pass the same array
+ * down to every skill:
+ *   - unfiltered, because `--skill x` narrows what is BUILT, never what counts as test
+ *     input; a suite excluded from the run is still an answer key;
+ *   - once, because assembling it per skill would walk the project's whole skills config
+ *     inside a per-skill loop — a per-item cost against whole-corpus work.
+ */
+export declare function collectDeclaredEvalSuites(skillsConfig: SkillsConfig | undefined, discovered: ReadonlyArray<{
+    name: string;
+    sourcePath: string;
+}>): DeclaredEvalSuite[];
 //# sourceMappingURL=skill-packaging-config.d.ts.map

package/dist/utils/skill-packaging-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-packaging-config.d.ts","sourceRoot":"","sources":["../../src/utils/skill-packaging-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAoB,KAAK,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAE/F;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC7C,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACrD,oBAAoB,CAmBtB"}
+{"version":3,"file":"skill-packaging-config.d.ts","sourceRoot":"","sources":["../../src/utils/skill-packaging-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAoB,KAAK,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACvH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAGlE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC7C,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACrD,oBAAoB,CAmBtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,YAAY,GAAG,SAAS,EACtC,UAAU,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GAC9D,iBAAiB,EAAE,CAUrB"}

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

@@ -10,6 +10,7 @@
  * outright. `files:` is the exception — see below.
  */
 import { mergeFilesConfig } from '@vibe-agent-toolkit/agent-skills';
+import { safePath } from '@vibe-agent-toolkit/utils';
 /**
  * Merge defaults with per-skill overrides, dropping undefined values.
  *
@@ -42,4 +43,29 @@ export function mergeSkillPackagingConfig(defaults, perSkillOverrides) {
     }
     return packagingConfig;
 }
+/**
+ * The PROJECT's declared eval suites: one {@link DeclaredEvalSuite} per discovered
+ * skill, from the same discovery + merge every lane already runs.
+ *
+ * Test input never ships, and that rule is project-wide rather than per-skill — a file
+ * ANY skill declares as its eval suite is an answer key, and no other skill's bundle may
+ * carry it. Every lane that packages or models a bundle therefore needs the whole
+ * project's declarations, not just the subject's.
+ *
+ * Build this ONCE per invocation, from the UNFILTERED discovery, and pass the same array
+ * down to every skill:
+ *   - unfiltered, because `--skill x` narrows what is BUILT, never what counts as test
+ *     input; a suite excluded from the run is still an answer key;
+ *   - once, because assembling it per skill would walk the project's whole skills config
+ *     inside a per-skill loop — a per-item cost against whole-corpus work.
+ */
+export function collectDeclaredEvalSuites(skillsConfig, discovered) {
+    if (skillsConfig === undefined)
+        return [];
+    const { defaults, config: perSkillConfig } = skillsConfig;
+    return discovered.map((skill) => ({
+        skillDir: safePath.resolve(skill.sourcePath, '..'),
+        config: mergeSkillPackagingConfig(defaults, perSkillConfig?.[skill.name]),
+    }));
+}
 //# sourceMappingURL=skill-packaging-config.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"skill-packaging-config.js","sourceRoot":"","sources":["../../src/utils/skill-packaging-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,gBAAgB,EAA6B,MAAM,kCAAkC,CAAC;AAE/F;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAA6C,EAC7C,iBAAsD;IAEtD,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,iBAAiB,EAAE,CAAC;IACrD,MAAM,eAAe,GAAyB,EAAE,CAAC;IACjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACvB,eAA2C,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,QAAQ,EAAE,CAAC,OAAO,CAAkC,CAAC;IAC1E,MAAM,aAAa,GAAG,iBAAiB,EAAE,CAAC,OAAO,CAAkC,CAAC;IACpF,IAAI,YAAY,KAAK,SAAS,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAC9D,MAAM,WAAW,GAAG,gBAAgB,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;QAClE,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,eAAe,CAAC,KAAK,GAAG,WAAW,CAAC;QACtC,CAAC;IACH,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC"}
+{"version":3,"file":"skill-packaging-config.js","sourceRoot":"","sources":["../../src/utils/skill-packaging-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,gBAAgB,EAAqD,MAAM,kCAAkC,CAAC;AAEvH,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAA6C,EAC7C,iBAAsD;IAEtD,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,iBAAiB,EAAE,CAAC;IACrD,MAAM,eAAe,GAAyB,EAAE,CAAC;IACjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACvB,eAA2C,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,QAAQ,EAAE,CAAC,OAAO,CAAkC,CAAC;IAC1E,MAAM,aAAa,GAAG,iBAAiB,EAAE,CAAC,OAAO,CAAkC,CAAC;IACpF,IAAI,YAAY,KAAK,SAAS,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAC9D,MAAM,WAAW,GAAG,gBAAgB,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;QAClE,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,eAAe,CAAC,KAAK,GAAG,WAAW,CAAC;QACtC,CAAC;IACH,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,yBAAyB,CACvC,YAAsC,EACtC,UAA+D;IAE/D,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAC1C,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,YAAY,CAAC;IAC1D,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAChC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC;QAClD,MAAM,EAAE,yBAAyB,CAC/B,QAA+C,EAC/C,cAAc,EAAE,CAAC,KAAK,CAAC,IAAI,CAAwC,CACpE;KACF,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/utils/verdict-helpers.d.ts

@@ -41,9 +41,10 @@ export declare function computeConfigVerdicts(observations: readonly Observation
  * Mutate a PackagingValidationResult in place to include compat verdicts
  * derived from the result's observations and the configured targets.
  *
- * Verdict issues land in `allErrors` and the appropriate active bucket
- * based on resolved severity (warning → activeWarnings; info stays only
- * in allErrors). Verdicts are not allow-filterable.
+ * Verdict issues land in `allErrors`, which is the sole container for every
+ * emitted issue regardless of severity — callers derive the active partition
+ * with `activeErrorsOf` / `activeWarningsOf` rather than reading a second
+ * pre-filtered copy. Verdicts are not allow-filterable.
  */
 export declare function applyConfigVerdicts(result: PackagingValidationResult, configTargets: ReadonlyArray<Target> | undefined, skillSourcePath: string, locationRoot: string): void;
 //# sourceMappingURL=verdict-helpers.d.ts.map

package/dist/utils/verdict-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verdict-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/verdict-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACvF,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,yBAAyB,EAC/B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAGL,KAAK,MAAM,EACX,KAAK,OAAO,EACb,MAAM,wCAAwC,CAAC;AAGhD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAUlF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,SAAS,WAAW,EAAE,EACpC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,EAChD,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,GACnB,eAAe,EAAE,CAkBnB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,yBAAyB,EACjC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,EAChD,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,GACnB,IAAI,CAqBN"}
+{"version":3,"file":"verdict-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/verdict-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACvF,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,yBAAyB,EAC/B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAGL,KAAK,MAAM,EACX,KAAK,OAAO,EACb,MAAM,wCAAwC,CAAC;AAGhD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAUlF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,SAAS,WAAW,EAAE,EACpC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,EAChD,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,GACnB,eAAe,EAAE,CAkBnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,yBAAyB,EACjC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,EAChD,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,GACnB,IAAI,CAcN"}

package/dist/utils/verdict-helpers.js

@@ -66,25 +66,18 @@ export function computeConfigVerdicts(observations, configTargets, skillSourcePa
  * Mutate a PackagingValidationResult in place to include compat verdicts
  * derived from the result's observations and the configured targets.
  *
- * Verdict issues land in `allErrors` and the appropriate active bucket
- * based on resolved severity (warning → activeWarnings; info stays only
- * in allErrors). Verdicts are not allow-filterable.
+ * Verdict issues land in `allErrors`, which is the sole container for every
+ * emitted issue regardless of severity — callers derive the active partition
+ * with `activeErrorsOf` / `activeWarningsOf` rather than reading a second
+ * pre-filtered copy. Verdicts are not allow-filterable.
  */
 export function applyConfigVerdicts(result, configTargets, skillSourcePath, locationRoot) {
     const verdictIssues = computeConfigVerdicts(result.observations, configTargets, skillSourcePath, locationRoot);
     if (verdictIssues.length === 0) {
         return;
     }
-    for (const issue of verdictIssues) {
-        result.allErrors.push(issue);
-        if (issue.severity === 'error') {
-            result.activeErrors.push(issue);
-        }
-        else if (issue.severity === 'warning') {
-            result.activeWarnings.push(issue);
-        }
-    }
-    if (result.activeErrors.length > 0) {
+    result.allErrors.push(...verdictIssues);
+    if (result.allErrors.some(issue => issue.severity === 'error')) {
         result.status = 'error';
     }
 }

package/dist/utils/verdict-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"verdict-helpers.js","sourceRoot":"","sources":["../../src/utils/verdict-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,aAAa,EAAwB,MAAM,kCAAkC,CAAC;AAKvF,OAAO,EACL,eAAe,EACf,uBAAuB,GAGxB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB,EAAE,QAAgB;IAC/D,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,eAAe;QAC/B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ;QACR,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,qBAAqB,CACnC,YAAoC,EACpC,aAAgD,EAChD,eAAuB,EACvB,YAAoB;IAEpB,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;QAC/C,aAAa,EAAE,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC;QAC3E,aAAa,EAAE,SAAS;QACxB,kBAAkB,EAAE,SAAS;KAC9B,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,eAAe,CAAC;QAC/B,YAAY,EAAE,CAAC,GAAG,YAAY,CAAC;QAC/B,OAAO,EAAE,gBAAgB;KAC1B,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,aAAa,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;IAC9D,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAiC,EACjC,aAAgD,EAChD,eAAuB,EACvB,YAAoB;IAEpB,MAAM,aAAa,GAAG,qBAAqB,CACzC,MAAM,CAAC,YAAY,EACnB,aAAa,EACb,eAAe,EACf,YAAY,CACb,CAAC;IACF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO;IACT,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAC/B,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACxC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC;IAC1B,CAAC;AACH,CAAC"}
+{"version":3,"file":"verdict-helpers.js","sourceRoot":"","sources":["../../src/utils/verdict-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,aAAa,EAAwB,MAAM,kCAAkC,CAAC;AAKvF,OAAO,EACL,eAAe,EACf,uBAAuB,GAGxB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB,EAAE,QAAgB;IAC/D,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,eAAe;QAC/B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ;QACR,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,qBAAqB,CACnC,YAAoC,EACpC,aAAgD,EAChD,eAAuB,EACvB,YAAoB;IAEpB,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;QAC/C,aAAa,EAAE,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC;QAC3E,aAAa,EAAE,SAAS;QACxB,kBAAkB,EAAE,SAAS;KAC9B,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,eAAe,CAAC;QAC/B,YAAY,EAAE,CAAC,GAAG,YAAY,CAAC;QAC/B,OAAO,EAAE,gBAAgB;KAC1B,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,aAAa,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;IAC9D,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAiC,EACjC,aAAgD,EAChD,eAAuB,EACvB,YAAoB;IAEpB,MAAM,aAAa,GAAG,qBAAqB,CACzC,MAAM,CAAC,YAAY,EACnB,aAAa,EACb,eAAe,EACf,YAAY,CACb,CAAC;IACF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO;IACT,CAAC;IACD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,EAAE,CAAC;QAC/D,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/docs/rag.md

@@ -36,10 +36,15 @@ vat rag clear
 5. Supports incremental updates (skips files with unchanged content)
 
 **Path Argument Behavior:**
-- `[path]` specifies the **base directory** to start crawling from
-- Recursively finds all `*.md` files under that directory (default pattern: `**/*.md`)
-- When path is specified, **config patterns are ignored** (to avoid pattern conflicts)
-- To use config patterns, run without path argument: `vat rag index`
+- `[path]` restricts the crawl to that subtree of the project
+- Recursively finds all `*.md` / `*.html` files under that directory
+- The path **replaces** the config's `resources.include` patterns
+- The config's `resources.exclude` patterns **still apply**, so a path run never
+  indexes build output or vendored trees the project excluded
+- If the path lies outside the project root the config's patterns cannot apply;
+  they are dropped and a warning is printed
+- To index the project's full configured set, run without a path argument:
+  `vat rag index`
 
 **Options:**
 - `[path]` - Base directory to crawl (defaults to current directory)

package/docs/resources.md

@@ -18,14 +18,19 @@ including link integrity checking and anchor validation.
 4. Exits 0 always (informational only)
 
 **Path Argument:**
-- `[path]` specifies the **base directory** to start crawling from
-- Recursively finds all `*.md` files under that directory (default pattern: `**/*.md`)
-- When path is specified, **config patterns are ignored** (to avoid pattern conflicts)
-- To use config patterns, run without path argument: `vat resources scan`
+- `[path]` restricts the scan to that subtree of the project
+- Recursively finds all `*.md` / `*.html` files under that directory
+- The path **replaces** the config's `resources.include` patterns
+- The config's `resources.exclude` patterns **still apply** — a path run never
+  scans build output, vendored trees, or test fixtures the project excluded
+- To scan the project's full configured set, run without a path argument:
+  `vat resources scan`
 
 **Options:**
 - `[path]` - Base directory to crawl (defaults to current directory)
 - `--debug` - Enable debug logging
+- `--verbose` - Add a `files:` list with per-file link/anchor counts and checksums
+- `--collection <id>` - Only report files in the named collection (config mode — no path argument)
 
 **Exit Codes:**
 - `0` - Always (scan is informational)
@@ -33,23 +38,28 @@ including link integrity checking and anchor validation.
 
 **Output:** YAML on stdout, logs on stderr
 
+`root` is stated once and is the only absolute path in the document; every
+`path` beneath it is relative to it.
+
 **Example:**
 ```bash
 # Recursively scan all *.md files under docs/
-vat resources scan docs/
+vat resources scan docs/ --verbose
 # Equivalent to: find all files matching docs/**/*.md pattern
 
 # Output:
 # ---
 # status: success
+# root: /home/you/my-project
 # filesScanned: 12
 # linksFound: 47
 # anchorsFound: 23
+# durationSecs: 0.234
 # files:
 #   - path: docs/README.md
 #     links: 5
 #     anchors: 3
-# duration: 234ms
+#     checksum: 47dd7b50af765df240fe2514f029fc697c907fc37a3267e22060f2f9f611975c
 # ---
 ```
 
@@ -78,14 +88,21 @@ for the loud-cwd fallback policy and the projectRoot discovery ladder.
 4. Exits 0 if valid, 1 if errors found
 
 **Path Argument:**
-- `[path]` specifies the **base directory** to start crawling from
-- Recursively finds all `*.md` files under that directory (default pattern: `**/*.md`)
-- When path is specified, **config patterns are ignored** (to avoid pattern conflicts)
-- To use config patterns, run without path argument: `vat resources validate`
+- `[path]` restricts the scan to that subtree of the project
+- Recursively finds all `*.md` / `*.html` files under that directory
+- The path **replaces** the config's `resources.include` patterns
+- The config's `resources.exclude` patterns **still apply** — a path run never
+  scans build output, vendored trees, or test fixtures the project excluded
+- To scan the project's full configured set, run without a path argument:
+  `vat resources validate`
 
 **Options:**
 - `[path]` - Base directory to crawl (defaults to current directory)
 - `--debug` - Enable debug logging
+- `-v, --verbose` - Show all scanned resources, including those without issues. By
+  default `issues` carries one counts-only row per file with findings
+  (`{file, errors?, warnings?, info?, codes}`); `--verbose` replaces each row with
+  its per-issue detail. Every other output field is identical in both modes.
 - `--no-check-frontmatter-links` - Skip frontmatter URI-reference link validation across all collections (default: enabled)
 
 **Exit Codes:**
@@ -108,8 +125,7 @@ vat resources validate docs/
 # status: success
 # filesScanned: 12
 # linksChecked: 47
-# anchorsChecked: 23
-# duration: 456ms
+# durationSecs: 0.456
 # ---
 ```
 
@@ -123,7 +139,7 @@ vat resources validate docs/
 
 # stdout:
 # ---
-# status: failed
+# status: error
 # errorsFound: 2
 # filesWithErrors: 2
 # issueCounts: { errors: 2, warnings: 0, info: 0 }
@@ -136,7 +152,7 @@ vat resources validate docs/
 #         code: LINK_BROKEN_FILE
 #         severity: error
 #         message: Link target not found: ./missing.md
-# duration: 456ms
+# durationSecs: 0.456
 # ---
 ```
 

package/docs/skills.md

@@ -362,11 +362,14 @@ to override (single-skill sources only).
 | `windsurf` | `~/.codeium/windsurf/skills/` | `.windsurf/skills/` |
 | `agents` | `~/.agents/skills/` | `.agents/skills/` |
 
-These paths were last reviewed against vendor conventions on 2026-04-08 and are
-not verified at build or test time — the tests assert the table's shape, never
-that a path is where a platform actually looks. If a vendor moves its convention,
-installs land somewhere unread and every VAT check still passes. Re-check the
-vendor's documentation before relying on a non-`claude` target.
+These paths were last reviewed against each platform's own published docs on
+2026-07-30 (all fourteen unchanged) and are not verified at build or test time.
+The tests derive their expectations from the table and assert invariants of it —
+every target present, both scopes relative and forward-slash only, and that the
+resolver composes base + relative path. No test can check that a path is where a
+platform actually looks. If a vendor moves its convention, installs land
+somewhere unread and every VAT check still passes. Re-check the vendor's
+documentation before relying on a non-`claude` target.
 
 **Visibility:** VAT's own inspection commands are Claude-scoped — `vat skills
 list --user` and `vat audit --user` read `~/.claude` only. A skill installed to
@@ -495,6 +498,7 @@ only when the `SKILL.md` declares none.
 **Output Format:**
 ```yaml
 status: success
+root: /abs/path/to/project
 context: project | user
 skillsFound: 3
 skills: