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

package/dist/utils/project-root-policy.d.ts

@@ -12,6 +12,8 @@
  * `.action(...)` callbacks). Inner library functions should take the resolved
  * root as a parameter — never call `findProjectRoot` themselves.
  */
+import { type Stats } from 'node:fs';
+import { type SideOfPath, type SourceOrigin } from '@vibe-agent-toolkit/utils';
 import type { Logger } from './logger.js';
 /**
  * `required` policy — refuse to run if no projectRoot can be discovered.
@@ -47,7 +49,78 @@ export declare function projectRootOrNull(startDir: string): string | null;
  *
  * @param pathArg - The argument as typed, relative to cwd or absolute
  * @returns The resolved absolute path
- * @throws When it does not exist or is not a directory
+ * @throws {CommandRefusalError} `USAGE_INVALID` when it is not a directory
+ * @throws {FsFaultError} a `source` fault named by an argument when the `stat` throws:
+ *   absent is the table's `USAGE_INVALID`, a refusal (an `EACCES` parent) `INPUT_UNREADABLE`
  */
 export declare function assertDirectoryArgument(pathArg: string): string;
+/**
+ * What an absent input means at its call site: who named it — the refusal table decides
+ * the code from that — and the sentence naming the remedy.
+ */
+interface AbsentInput {
+    readonly origin: SourceOrigin;
+    readonly message: string;
+}
+/**
+ * The refusal for an input the CONFIG, an earlier step or the command line names whose
+ * `stat` or read threw: classified as a `source` fault of the input's origin. An absence
+ * keeps the caller's sentence — a `files[].source` nothing built, a `publish.changelog`
+ * naming no file — under the refusal the table owes that origin, carrying the classified
+ * fault as its cause; anything else is the classified fault itself.
+ */
+export declare function classifyInputFault(resolved: string, error: unknown, absent: AbsentInput): unknown;
+/** A config key naming a file that is not there: the config's mistake. */
+export declare function configNamedFileAbsent(key: string, named: string): AbsentInput;
+/**
+ * Refuse unless `resolved` can be stat'ed.
+ *
+ * @param within - The tree `resolved` is read in, whose links are read before the kernel follows
+ *   them (a project root); `resolved` itself when it IS the operator's own argument
+ * @param sideOf - The side of each path the `stat` touches — `resolved`, and each component walked beneath
+ *   `within`: a refusal is charged to the side of the path the OS refused
+ * @returns What the `stat` found
+ * @throws {CommandRefusalError} `absent` when nothing is there (the refusal its origin owes)
+ * @throws {FsFaultError} when the OS refuses the `stat`, or the chain names a network or device path
+ */
+export declare function requireInputPath(resolved: string, within: string, absent: AbsentInput, sideOf: SideOfPath): Stats;
+/**
+ * Read a UTF-8 input file, refusing like {@link requireInputPath}.
+ *
+ * @throws {CommandRefusalError} `absent` when nothing is there (the refusal its origin owes)
+ * @throws {FsFaultError} when it cannot be read
+ */
+export declare function readInputFile(resolved: string, absent: AbsentInput): string;
+/**
+ * Why a DIRECTORY argument cannot be read, or `undefined` when it can be.
+ *
+ * A probe, not a listing: the verb's own walk owns enumeration; this only asks
+ * whether it can start. A directory the OS will not let the process list or
+ * enter is an input that exists and cannot be read — `INPUT_UNREADABLE`, never
+ * "not found" and never a finding about a tree nothing was read from.
+ *
+ * @param dir - The resolved argument, known to be a directory
+ * @returns The classified `source` fault (origin `argument`), or `undefined`
+ */
+export declare function unlistableDirectoryRefusal(dir: string): unknown;
+/**
+ * {@link assertDirectoryArgument}, plus the one more way a directory argument
+ * can leave nothing to examine: the OS will not let the process read it.
+ *
+ * @param pathArg - The argument as typed, relative to cwd or absolute
+ * @returns The resolved absolute path
+ * @throws {CommandRefusalError} `USAGE_INVALID` when it is not a directory
+ * @throws {FsFaultError} when it does not exist (`USAGE_INVALID`) or cannot be listed
+ */
+export declare function assertReadableDirectoryArgument(pathArg: string): string;
+/**
+ * Why `resolved` cannot be read as a directory — absent (a classified argument fault,
+ * `USAGE_INVALID`) or not a directory (`USAGE_INVALID`), or refused by the OS (a
+ * classified fault, `INPUT_UNREADABLE`) — or `undefined`. The one judgement behind
+ * {@link assertReadableDirectoryArgument} and the skills scope guard.
+ *
+ * @param resolved - The resolved argument
+ */
+export declare function readableDirectoryRefusal(resolved: string): unknown;
+export {};
 //# sourceMappingURL=project-root-policy.d.ts.map

package/dist/utils/project-root-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-root-policy.d.ts","sourceRoot":"","sources":["../../src/utils/project-root-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAShF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ7E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEjE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAS/D"}
+{"version":3,"file":"project-root-policy.d.ts","sourceRoot":"","sources":["../../src/utils/project-root-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAuC,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAG1E,OAAO,EAAwI,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGrN,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAUhF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ7E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEjE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAK/D;AAgBD;;;GAGG;AACH,UAAU,WAAW;IACnB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAEjG;AAcD,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAE7E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,KAAK,CAMjH;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAM3E;AAmBD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKvE;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAElE"}

package/dist/utils/project-root-policy.js

@@ -12,8 +12,10 @@
  * `.action(...)` callbacks). Inner library functions should take the resolved
  * root as a parameter — never call `findProjectRoot` themselves.
  */
-import { existsSync, statSync } from 'node:fs';
-import { findProjectRoot, safePath } from '@vibe-agent-toolkit/utils';
+import { accessSync, constants, readFileSync } from 'node:fs';
+import { fsFaultRefusal } from '@vibe-agent-toolkit/schema';
+import { classifyFsFault, findProjectRoot, isFsFaultError, refusedPathOf, requireFollowedStatSync, safePath } from '@vibe-agent-toolkit/utils';
+import { CommandRefusalError } from './command-refusal.js';
 /**
  * `required` policy — refuse to run if no projectRoot can be discovered.
  *
@@ -22,7 +24,7 @@ import { findProjectRoot, safePath } from '@vibe-agent-toolkit/utils';
 export function requireProjectRoot(startDir, commandName) {
     const root = findProjectRoot(startDir);
     if (root === null) {
-        throw new Error(`${commandName} requires a vibe-agent-toolkit.config.yaml or .git/ ancestor. ` +
+        throw new CommandRefusalError('USAGE_INVALID', `${commandName} requires a vibe-agent-toolkit.config.yaml or .git/ ancestor. ` +
             `Run from inside a VAT project or initialize one.`);
     }
     return root;
@@ -64,16 +66,152 @@ export function projectRootOrNull(startDir) {
  *
  * @param pathArg - The argument as typed, relative to cwd or absolute
  * @returns The resolved absolute path
- * @throws When it does not exist or is not a directory
+ * @throws {CommandRefusalError} `USAGE_INVALID` when it is not a directory
+ * @throws {FsFaultError} a `source` fault named by an argument when the `stat` throws:
+ *   absent is the table's `USAGE_INVALID`, a refusal (an `EACCES` parent) `INPUT_UNREADABLE`
  */
 export function assertDirectoryArgument(pathArg) {
     const resolved = safePath.resolve(pathArg);
-    if (!existsSync(resolved)) {
-        throw new Error(`Path does not exist: ${resolved}`);
+    const refusal = directoryRefusal(resolved);
+    if (refusal !== undefined)
+        throw refusal;
+    return resolved;
+}
+/**
+ * How a `stat`, `lstat` or read of a path the command line named is classified: a
+ * `source` fault of origin `argument`. Only an ABSENCE is the invocation's mistake (the
+ * table's `USAGE_INVALID`); any other error — an `EACCES` parent the process may not
+ * traverse, an `ELOOP` — means whether the path exists is unknown: the INPUT's refusal,
+ * never "does not exist" and never a scan that starts anyway. Never classify with
+ * `existsSync`: it answers `false` for both.
+ *
+ * @param path - The resolved path that was examined
+ */
+function argumentPath(path) {
+    return { side: 'source', origin: 'argument', action: 'read the path', path };
+}
+/**
+ * The refusal for an input the CONFIG, an earlier step or the command line names whose
+ * `stat` or read threw: classified as a `source` fault of the input's origin. An absence
+ * keeps the caller's sentence — a `files[].source` nothing built, a `publish.changelog`
+ * naming no file — under the refusal the table owes that origin, carrying the classified
+ * fault as its cause; anything else is the classified fault itself.
+ */
+export function classifyInputFault(resolved, error, absent) {
+    return classifyInputFaultOn('source', resolved, error, absent);
+}
+/**
+ * {@link classifyInputFault}, the refusal charged to `side`: the side of the path the OS refused, which for a
+ * walked input may be a directory above it on another side (`<project>/dist`, the tree a build writes), or the
+ * input itself when it is the run's own output (`dist/skills` under `vat build`). An absence keeps the caller's
+ * sentence, under the refusal the table owes THAT side: nothing is there to read, whoever's directory said so.
+ */
+function classifyInputFaultOn(side, resolved, error, absent) {
+    const fault = classifyFsFault(error, { side, origin: absent.origin, action: 'read the input', path: resolved });
+    if (!isFsFaultError(fault) || fault.faultClass !== 'absent')
+        return fault;
+    return new CommandRefusalError(fsFaultRefusal(side, 'absent', absent.origin).refusal, absent.message, { cause: fault });
+}
+/** A config key naming a file that is not there: the config's mistake. */
+export function configNamedFileAbsent(key, named) {
+    return { origin: 'config', message: `${key} names ${named}, which does not exist.` };
+}
+/**
+ * Refuse unless `resolved` can be stat'ed.
+ *
+ * @param within - The tree `resolved` is read in, whose links are read before the kernel follows
+ *   them (a project root); `resolved` itself when it IS the operator's own argument
+ * @param sideOf - The side of each path the `stat` touches — `resolved`, and each component walked beneath
+ *   `within`: a refusal is charged to the side of the path the OS refused
+ * @returns What the `stat` found
+ * @throws {CommandRefusalError} `absent` when nothing is there (the refusal its origin owes)
+ * @throws {FsFaultError} when the OS refuses the `stat`, or the chain names a network or device path
+ */
+export function requireInputPath(resolved, within, absent, sideOf) {
+    try {
+        return requireFollowedStatSync(resolved, within);
     }
-    if (!statSync(resolved).isDirectory()) {
-        throw new Error(`Path is not a directory: ${resolved}`);
+    catch (error) {
+        throw classifyInputFaultOn(sideOf(refusedPathOf(error, resolved)), resolved, error, absent);
     }
+}
+/**
+ * Read a UTF-8 input file, refusing like {@link requireInputPath}.
+ *
+ * @throws {CommandRefusalError} `absent` when nothing is there (the refusal its origin owes)
+ * @throws {FsFaultError} when it cannot be read
+ */
+export function readInputFile(resolved, absent) {
+    try {
+        return readFileSync(resolved, 'utf-8');
+    }
+    catch (error) {
+        throw classifyInputFault(resolved, error, absent);
+    }
+}
+/**
+ * Why `resolved` is not a usable directory, or `undefined` when it is one.
+ * A `stat` that throws is classified as the argument's fault ({@link classifyInputFault}):
+ * absent says so in the invocation's words.
+ */
+function directoryRefusal(resolved) {
+    let stats;
+    try {
+        // The operator's own argument: its own `within`.
+        stats = requireFollowedStatSync(resolved, resolved);
+    }
+    catch (error) {
+        return classifyInputFault(resolved, error, { origin: 'argument', message: `Path does not exist: ${resolved}` });
+    }
+    if (!stats.isDirectory())
+        return new CommandRefusalError('USAGE_INVALID', `Path is not a directory: ${resolved}`);
+    return undefined;
+}
+/**
+ * Why a DIRECTORY argument cannot be read, or `undefined` when it can be.
+ *
+ * A probe, not a listing: the verb's own walk owns enumeration; this only asks
+ * whether it can start. A directory the OS will not let the process list or
+ * enter is an input that exists and cannot be read — `INPUT_UNREADABLE`, never
+ * "not found" and never a finding about a tree nothing was read from.
+ *
+ * @param dir - The resolved argument, known to be a directory
+ * @returns The classified `source` fault (origin `argument`), or `undefined`
+ */
+export function unlistableDirectoryRefusal(dir) {
+    try {
+        accessSync(dir, constants.R_OK | constants.X_OK);
+        return undefined;
+    }
+    catch (error) {
+        return classifyFsFault(error, argumentPath(dir));
+    }
+}
+/**
+ * {@link assertDirectoryArgument}, plus the one more way a directory argument
+ * can leave nothing to examine: the OS will not let the process read it.
+ *
+ * @param pathArg - The argument as typed, relative to cwd or absolute
+ * @returns The resolved absolute path
+ * @throws {CommandRefusalError} `USAGE_INVALID` when it is not a directory
+ * @throws {FsFaultError} when it does not exist (`USAGE_INVALID`) or cannot be listed
+ */
+export function assertReadableDirectoryArgument(pathArg) {
+    const resolved = safePath.resolve(pathArg);
+    const refusal = readableDirectoryRefusal(resolved);
+    if (refusal !== undefined)
+        throw refusal;
     return resolved;
 }
+/**
+ * Why `resolved` cannot be read as a directory — absent (a classified argument fault,
+ * `USAGE_INVALID`) or not a directory (`USAGE_INVALID`), or refused by the OS (a
+ * classified fault, `INPUT_UNREADABLE`) — or `undefined`. The one judgement behind
+ * {@link assertReadableDirectoryArgument} and the skills scope guard.
+ *
+ * @param resolved - The resolved argument
+ */
+export function readableDirectoryRefusal(resolved) {
+    return directoryRefusal(resolved) ?? unlistableDirectoryRefusal(resolved);
+}
 //# sourceMappingURL=project-root-policy.js.map

package/dist/utils/project-root-policy.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-root-policy.js","sourceRoot":"","sources":["../../src/utils/project-root-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAItE;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,WAAmB;IACtE,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,GAAG,WAAW,gEAAgE;YAC5E,kDAAkD,CACrD,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,MAAc;IACnE,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,CAAC,IAAI,CACT,oEAAoE,GAAG,iBAAiB,CACzF,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"project-root-policy.js","sourceRoot":"","sources":["../../src/utils/project-root-policy.ts"],"names":[],"mappings":"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"}

package/dist/utils/projection-lenses.d.ts

@@ -12,7 +12,8 @@
  * `docs/architecture/zones.md` §2, "A lens is evaluated only when a statement
  * names one of its relations".
  */
-import { type DerivedTableName, type PopulationCache, type Projection } from '@vibe-agent-toolkit/resources';
+import { type DerivedTableName, type PopulationCache, type PopulationOutcome, type Projection } from '@vibe-agent-toolkit/resources';
+import type { LensPopulation } from './lens-population.js';
 import type { Logger } from './logger.js';
 /**
  * The rows one lens evaluation produced, keyed by `DERIVED_TABLES`' own keys.
@@ -24,16 +25,32 @@ import type { Logger } from './logger.js';
 export type LensRows = {
     readonly [Name in DerivedTableName]?: readonly Record<string, unknown>[];
 };
+/**
+ * What one lens evaluation produced: its rows, and where its OWN population came
+ * from — `null` for a lens that populated nothing (it read the run's projection).
+ * Required, so a lens that populates cannot leave its provenance unstated.
+ */
+export interface LensEvaluation {
+    readonly rows: LensRows;
+    readonly population: PopulationOutcome['population'] | null;
+}
+/**
+ * A run's {@link LensPopulation} from each evaluated lens's own population.
+ *
+ * @param populations - Each evaluated lens's `population`, in evaluation order
+ * @returns The run's lens provenance
+ */
+export declare function lensPopulationOf(populations: readonly LensEvaluation['population'][]): LensPopulation;
 /** Everything a lens may read while evaluating. */
 export interface LensEvaluationInput {
     /** The resources-lane projection the run already populated. */
     readonly projection: Projection;
     /** Absolute corpus root, for a lens that must populate a lane of its own. */
     readonly root: string;
-    /** Where a lens's own blob-stage refusals go — stderr. */
-    readonly logger: Logger;
     /** The run's projection store, so a lens's own population can hit it. */
     readonly cache: PopulationCache | undefined;
+    /** Where a lens that populates reports its own population's refused content. */
+    readonly logger: Logger;
 }
 /** One lens: the relations it owns, and how to produce their rows. */
 export interface ProjectionLens {
@@ -52,9 +69,10 @@ export interface ProjectionLens {
      *
      * @param input - The projection, the root, and the run's oracles
      * @returns Every relation this lens owns — all of them, every time, because
-     *   omitting one leaves its previous contents in place
+     *   omitting one leaves its previous contents in place — and where its own
+     *   population came from
      */
-    readonly evaluate: (input: LensEvaluationInput) => Promise<LensRows> | LensRows;
+    readonly evaluate: (input: LensEvaluationInput) => Promise<LensEvaluation> | LensEvaluation;
 }
 /** The authored-link lens: `lens_contexts`, `edges`, `edge_resolutions`. */
 export declare const AUTHORED_LINK_LENS: ProjectionLens;
@@ -91,8 +109,8 @@ export declare function lensesNamedBy(statements: readonly string[] | undefined)
  *
  * @param lens - The lens
  * @param input - What it may read
- * @returns Its rows
+ * @returns Its rows and its own population's provenance
  * @throws Error When the rows omit a declared relation or carry an undeclared one
  */
-export declare function evaluateLens(lens: ProjectionLens, input: LensEvaluationInput): Promise<LensRows>;
+export declare function evaluateLens(lens: ProjectionLens, input: LensEvaluationInput): Promise<LensEvaluation>;
 //# sourceMappingURL=projection-lenses.d.ts.map

package/dist/utils/projection-lenses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projection-lenses.d.ts","sourceRoot":"","sources":["../../src/utils/projection-lenses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAkB,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAI7H,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,EAAE,IAAI,IAAI,gBAAgB,CAAC,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;CACzE,CAAC;AAEF,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,CAAC;CAC7C;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAChD;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;CACjF;AAED,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,EAAE,cAIhC,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,EAAE,cAIjC,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,EAAE,SAAS,cAAc,EAGtD,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,MAAM,EAAE,CAEzE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,SAAS,cAAc,EAAE,CAMlG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,QAAQ,CAAC,CAYnB"}
+{"version":3,"file":"projection-lenses.d.ts","sourceRoot":"","sources":["../../src/utils/projection-lenses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EAChB,MAAM,+BAA+B,CAAC;AAIvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,EAAE,IAAI,IAAI,gBAAgB,CAAC,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;CACzE,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;CAC7D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,SAAS,cAAc,CAAC,YAAY,CAAC,EAAE,GAAG,cAAc,CAIrG;AAED,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,CAAC;IAC5C,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAChD;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAAC;CAC7F;AAED,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,EAAE,cAKhC,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,EAAE,cAIjC,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,EAAE,SAAS,cAAc,EAGtD,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,MAAM,EAAE,CAEzE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,SAAS,cAAc,EAAE,CAMlG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,cAAc,CAAC,CAazB"}

package/dist/utils/projection-lenses.js

@@ -12,20 +12,33 @@
  * `docs/architecture/zones.md` §2, "A lens is evaluated only when a statement
  * names one of its relations".
  */
-import { DERIVED_TABLES } from '@vibe-agent-toolkit/resources';
+import { DERIVED_TABLES, } from '@vibe-agent-toolkit/resources';
 import { evaluateClaudeContextLens } from './claude-context-lens.js';
 import { evaluateAuthoredLenses } from './edge-lens-evaluation.js';
+/**
+ * A run's {@link LensPopulation} from each evaluated lens's own population.
+ *
+ * @param populations - Each evaluated lens's `population`, in evaluation order
+ * @returns The run's lens provenance
+ */
+export function lensPopulationOf(populations) {
+    const populated = populations.filter((population) => population !== null);
+    if (populated.length === 0)
+        return 'none';
+    return populated.every((population) => population === 'store') ? 'store' : 'derived';
+}
 /** The authored-link lens: `lens_contexts`, `edges`, `edge_resolutions`. */
 export const AUTHORED_LINK_LENS = {
     name: 'authored-link',
     relations: ['lensContexts', 'edges', 'edgeResolutions'],
-    evaluate: ({ projection }) => evaluateAuthoredLenses(projection),
+    // Reads the run's projection, so it populates nothing of its own.
+    evaluate: ({ projection }) => ({ rows: evaluateAuthoredLenses(projection), population: null }),
 };
 /** The always-loaded context lens: `claude_context_chains`, `claude_context_loads`. */
 export const CLAUDE_CONTEXT_LENS = {
     name: 'claude-context',
     relations: ['claudeContextChains', 'claudeContextLoads'],
-    evaluate: ({ root, logger, cache }) => evaluateClaudeContextLens({ root, logger, cache }),
+    evaluate: ({ root, cache, logger }) => evaluateClaudeContextLens({ root, cache, logger }),
 };
 /** Every lens the query lane can evaluate, in evaluation order. */
 export const PROJECTION_LENSES = [
@@ -68,11 +81,12 @@ export function lensesNamedBy(statements) {
  *
  * @param lens - The lens
  * @param input - What it may read
- * @returns Its rows
+ * @returns Its rows and its own population's provenance
  * @throws Error When the rows omit a declared relation or carry an undeclared one
  */
 export async function evaluateLens(lens, input) {
-    const rows = await lens.evaluate(input);
+    const evaluation = await lens.evaluate(input);
+    const { rows } = evaluation;
     const declared = lens.relations;
     const missing = declared.filter((name) => !Object.hasOwn(rows, name));
     const undeclared = Object.keys(rows).filter((name) => !declared.includes(name));
@@ -80,7 +94,7 @@ export async function evaluateLens(lens, input) {
         throw new Error(`Lens "${lens.name}" must produce exactly [${declared.join(', ')}];`
             + ` missing [${missing.join(', ')}], undeclared [${undeclared.join(', ')}]`);
     }
-    return rows;
+    return evaluation;
 }
 /**
  * Blank out the parts of a statement that cannot name a table: line comments,

package/dist/utils/projection-lenses.js.map

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

package/dist/utils/projection-query.d.ts

@@ -45,10 +45,9 @@
  * closure also puts the legible-failure wrapper on the single path that can
  * throw, so no command can forget it.
  */
-import { type Projection } from '@vibe-agent-toolkit/resources';
+import { type PopulationOutcome, type Projection } from '@vibe-agent-toolkit/resources';
+import type { LensPopulation } from './lens-population.js';
 import type { Logger } from './logger.js';
-/** Where the POPULATION a statement ran against came from. */
-export type PopulationOrigin = 'derived' | 'store';
 /**
  * What a run's rows are, and where they came from.
  *
@@ -62,12 +61,17 @@ export interface ProjectionProvenance {
     /**
      * 🔑 The cache tell. Reported rather than inferred, because it CANNOT be
      * inferred: a correct store hit and a correct re-derivation produce identical
-     * rows. A hit short-circuits `populate()` before the builder exists, so no
-     * contributor timing is filed — an empty record list IS the hit.
+     * rows. It is `populate()`'s own outcome, never a count of what ran.
      *
      * It describes the POPULATION, which is the only thing the store now affects.
      */
-    readonly population: PopulationOrigin;
+    readonly population: PopulationOutcome['population'];
+    /**
+     * The same tell for the lenses' OWN populations — the claude-context lens
+     * populates a lane of its own. `'none'` when no evaluated lens populated
+     * anything; see {@link lensPopulationOf}.
+     */
+    readonly lensPopulation: LensPopulation;
     /**
      * 🔑 What that origin was WORTH. {@link population} says whether the
      * projection was served or re-derived; this says what the difference cost, so
@@ -201,9 +205,9 @@ export interface PopulationExtent {
      *
      * 🪤 Realizations rather than any other count, because every alternative
      * fails to reach zero on the case that matters: `roots` always holds exactly
-     * one row (the invariant thrown for below), so a total over all thirteen tables
+     * one row (the invariant thrown for below), so a total over every table
      * is never 0; `blobs` is content-keyed and deduped, so it counts parse REACH
-     * and already has its own guard in `onBlobPopulation`; and `resources` counts
+     * and already has its own report in `populateAndReport`; and `resources` counts
      * identities, which a corpus can legitimately have none of while enumerating
      * plenty. One row per enumerated path is non-zero exactly when something was
      * enumerated.
@@ -218,6 +222,8 @@ export interface PreflightStatement {
 }
 /** Run one read-only statement against the populated projection. */
 export type AskProjection = (sql: string, ...parameters: readonly string[]) => readonly Record<string, unknown>[];
+/** The result columns one statement would produce, in order, without running it. */
+type ColumnsOfStatement = (sql: string, ...parameters: readonly string[]) => readonly string[];
 /**
  * Compile every statement a run intends to ask, against the schema and NO rows,
  * before anything is populated.
@@ -266,8 +272,8 @@ export declare function assertQueriesCompile(statements: readonly PreflightState
  *
  * @param options - The run
  * @param options.root - Absolute corpus root
- * @param options.logger - Where blob-stage refusals are reported (stderr, so a
- *   parseable document on stdout stays parseable)
+ * @param options.logger - Where the population's refused content is reported
+ *   (stderr, so a parseable document on stdout stays parseable)
  * @param options.preflight - Every statement this run intends to ask, compiled
  *   against the empty schema BEFORE the population starts. See
  *   {@link assertQueriesCompile}
@@ -285,7 +291,7 @@ export declare function withQueriedProjection<T>(options: {
     logger: Logger;
     preflight?: readonly PreflightStatement[];
     statements?: readonly string[];
-}, work: (ask: AskProjection, provenance: ProjectionProvenance, extent: PopulationExtent, projection: Projection) => Promise<T> | T): Promise<T>;
+}, work: (ask: AskProjection, provenance: ProjectionProvenance, extent: PopulationExtent, projection: Projection, columnsOf: ColumnsOfStatement) => Promise<T> | T): Promise<T>;
 /**
  * Turn a rejected statement into a message that names the surface it missed.
  *
@@ -321,4 +327,5 @@ export declare function withQueriedProjection<T>(options: {
  *   failure was a name this projection does not have
  */
 export declare function describeQueryFailure(sql: string, message: string): string;
+export {};
 //# sourceMappingURL=projection-query.d.ts.map

package/dist/utils/projection-query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projection-query.d.ts","sourceRoot":"","sources":["../../src/utils/projection-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAIH,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,+BAA+B,CAAC;AAIvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAsB1C,8DAA8D;AAC9D,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0DG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAE5C;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,oEAAoE;AACpE,MAAM,MAAM,aAAa,GAAG,CAC1B,GAAG,EAAE,MAAM,EACX,GAAG,UAAU,EAAE,SAAS,MAAM,EAAE,KAC7B,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBnG;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,EAC3C,OAAO,EAAE;IACP,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC1C,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,EACD,IAAI,EAAE,CACJ,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,oBAAoB,EAChC,MAAM,EAAE,gBAAgB,EAQxB,UAAU,EAAE,UAAU,KACnB,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAClB,OAAO,CAAC,CAAC,CAAC,CAgIZ;AAqBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAsCzE"}
+{"version":3,"file":"projection-query.d.ts","sourceRoot":"","sources":["../../src/utils/projection-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAIH,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,UAAU,EAChB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA2B1C;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAErD;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0DG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAE5C;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,oEAAoE;AACpE,MAAM,MAAM,aAAa,GAAG,CAC1B,GAAG,EAAE,MAAM,EACX,GAAG,UAAU,EAAE,SAAS,MAAM,EAAE,KAC7B,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;AAExC,oFAAoF;AACpF,KAAK,kBAAkB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,EAAE,CAAC;AAqB/F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBnG;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,EAC3C,OAAO,EAAE;IACP,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC1C,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,EACD,IAAI,EAAE,CACJ,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,oBAAoB,EAChC,MAAM,EAAE,gBAAgB,EAQxB,UAAU,EAAE,UAAU,EAEtB,SAAS,EAAE,kBAAkB,KAC1B,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAClB,OAAO,CAAC,CAAC,CAAC,CAmIZ;AAqBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAsCzE"}