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

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/dist/version.d.ts

@@ -7,7 +7,27 @@ export interface VersionContext {
     path?: string;
 }
 /**
- * Format version string with optional context
+ * Format the `--version` output: the version line, then the resolved path of
+ * the binary that produced it.
+ *
+ * **Why the binary path is unconditional.** The `-dev (<path>)` suffix is
+ * CWD-derived: `bin/vat.ts` computes its context from
+ * `findNodeWorkspaceRoot(process.cwd())`, so the *same* branch build invoked by
+ * absolute path from an adopter checkout resolves `Context: global` and printed
+ * a bare `0.1.41-rc.8` — byte-identical to what the released rc.8 prints. The
+ * only way to tell them apart was `VAT_DEBUG=1` plus knowing to look for the
+ * `Binary:` line. Every adopter delta test runs in exactly that directory, so
+ * the identity check the whole testing protocol depends on was unperformable
+ * where the tests actually run.
+ *
+ * `binaryPath` is a property of what ACTUALLY ran (derived from the entry
+ * module's own `import.meta.filename`, not from the cwd), which is why it can
+ * answer the question the context label cannot. It is a required parameter on
+ * purpose: a defaulted one would let a caller be added that silently ships the
+ * old, unidentifiable output.
+ *
+ * The version stays on line 1 so `--version` output still matches
+ * `/^\d+\.\d+\.\d+/`; the provenance is appended, never prepended.
  */
-export declare function getVersionString(ver: string, context: VersionContext | null): string;
+export declare function getVersionString(ver: string, context: VersionContext | null, binaryPath: string): string;
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,eAAO,MAAM,OAAO,EAAE,MAA4B,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,cAAc,GAAG,IAAI,GAC7B,MAAM,CAaR"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,eAAO,MAAM,OAAO,EAAE,MAA4B,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAuBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,cAAc,GAAG,IAAI,EAC9B,UAAU,EAAE,MAAM,GACjB,MAAM,CAER"}

package/dist/version.js

@@ -12,9 +12,12 @@ const packageJson = JSON.parse(
 readFileSync(safePath.resolve(__dirname, '../package.json'), 'utf-8'));
 export const version = packageJson.version;
 /**
- * Format version string with optional context
+ * The version line alone: `<ver>` plus whatever the cwd-derived context adds.
+ *
+ * Kept private because it is exactly the string that could not identify a
+ * binary — `global` and "no context" both collapse to a bare `<ver>`.
  */
-export function getVersionString(ver, context) {
+function formatVersionLine(ver, context) {
     if (!context) {
         return ver;
     }
@@ -27,4 +30,30 @@ export function getVersionString(ver, context) {
             return ver;
     }
 }
+/**
+ * Format the `--version` output: the version line, then the resolved path of
+ * the binary that produced it.
+ *
+ * **Why the binary path is unconditional.** The `-dev (<path>)` suffix is
+ * CWD-derived: `bin/vat.ts` computes its context from
+ * `findNodeWorkspaceRoot(process.cwd())`, so the *same* branch build invoked by
+ * absolute path from an adopter checkout resolves `Context: global` and printed
+ * a bare `0.1.41-rc.8` — byte-identical to what the released rc.8 prints. The
+ * only way to tell them apart was `VAT_DEBUG=1` plus knowing to look for the
+ * `Binary:` line. Every adopter delta test runs in exactly that directory, so
+ * the identity check the whole testing protocol depends on was unperformable
+ * where the tests actually run.
+ *
+ * `binaryPath` is a property of what ACTUALLY ran (derived from the entry
+ * module's own `import.meta.filename`, not from the cwd), which is why it can
+ * answer the question the context label cannot. It is a required parameter on
+ * purpose: a defaulted one would let a caller be added that silently ships the
+ * old, unidentifiable output.
+ *
+ * The version stays on line 1 so `--version` output still matches
+ * `/^\d+\.\d+\.\d+/`; the provenance is appended, never prepended.
+ */
+export function getVersionString(ver, context, binaryPath) {
+    return `${formatVersionLine(ver, context)}\n  binary: ${binaryPath}`;
+}
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAG,OAAO,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,+CAA+C;AAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK;AAC5B,wIAAwI;AACxI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CACtE,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAW,WAAW,CAAC,OAAO,CAAC;AAOnD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAW,EACX,OAA8B;IAE9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,CAAC;IACb,CAAC;IAED,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,KAAK;YACR,OAAO,GAAG,GAAG,SAAS,OAAO,CAAC,IAAI,IAAI,SAAS,GAAG,CAAC;QACrD,KAAK,OAAO;YACV,OAAO,GAAG,GAAG,YAAY,OAAO,CAAC,IAAI,IAAI,SAAS,GAAG,CAAC;QACxD,KAAK,QAAQ;YACX,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAG,OAAO,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,+CAA+C;AAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK;AAC5B,wIAAwI;AACxI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CACtE,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAW,WAAW,CAAC,OAAO,CAAC;AAOnD;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,GAAW,EAAE,OAA8B;IACpE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,CAAC;IACb,CAAC;IAED,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,KAAK;YACR,OAAO,GAAG,GAAG,SAAS,OAAO,CAAC,IAAI,IAAI,SAAS,GAAG,CAAC;QACrD,KAAK,OAAO;YACV,OAAO,GAAG,GAAG,YAAY,OAAO,CAAC,IAAI,IAAI,SAAS,GAAG,CAAC;QACxD,KAAK,QAAQ;YACX,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAW,EACX,OAA8B,EAC9B,UAAkB;IAElB,OAAO,GAAG,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,eAAe,UAAU,EAAE,CAAC;AACvE,CAAC"}

package/docs/index.md

@@ -360,6 +360,18 @@ The `vat` wrapper automatically detects your execution context:
 - Uses development build directly (no packaging)
 - Works from any subdirectory within the repo
 
+`vat --version` always prints a second line naming the binary that produced it:
+
+```
+0.1.0-rc.9-dev (/path/to/repo)
+  binary: /path/to/repo/packages/cli/dist/bin.js
+```
+
+The context label on the first line is derived from your current directory; the `binary:` line is
+derived from the file Node actually loaded. Run a checkout's build by absolute path from somewhere
+else and the label reads `global` — the `binary:` line is then the only thing that tells you which
+build you ran.
+
 **Local install** - Project has vibe-agent-toolkit in node_modules:
 - Uses locally installed version
 - Shown in version output: `0.1.0-rc.9 (local: /path/to/project)`

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)