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

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

@@ -16,7 +16,7 @@
  * a false alarm.
  */
 import type { PackageSkillResult } from '@vibe-agent-toolkit/agent-skills';
-import { type SeverityCounts, type ValidationIssue } from '@vibe-agent-toolkit/schema';
+import { type Finding, type SeverityCounts, type ValidationIssue } from '@vibe-agent-toolkit/schema';
 /** Render an issue's own severity as itself. */
 export declare function severityLabel(severity: ValidationIssue['severity']): string;
 /**
@@ -38,10 +38,14 @@ export declare function formatIssueSetHeading(issues: readonly ValidationIssue[]
 /**
  * Render one issue as its own lines, each prefixed with `indent`.
  *
+ * Takes a library `ValidationIssue` or a published `Finding` — the renderer
+ * reads only the fields the two share, so a lane holding a report's findings
+ * renders them as they are rather than casting them back to issues.
+ *
  * Returns an array rather than writing, so a caller can pick its own stream and
  * a unit test can assert over every line without capturing output.
  */
-export declare function formatIssueLines(issue: ValidationIssue, indent?: string): string[];
+export declare function formatIssueLines(issue: ValidationIssue | Finding, indent?: string): string[];
 /**
  * Render the run-level findings section — findings that belong to the whole
  * invocation rather than to any one skill (ALLOW_UNUSED is the only producer).
@@ -84,7 +88,7 @@ export declare function collectPostBuildIssues(result: PackageSkillResult): Vali
  * "this asset is not the one" it means. `exactOptionalPropertyTypes` is on, so
  * these are built by spread — assigning `undefined` would emit the key.
  */
-export interface FindingCountSummary {
+interface FindingCountSummary {
     errors?: number;
     warnings?: number;
     info?: number;
@@ -188,4 +192,5 @@ export declare function formatCollapsedFindingsHint(collapsed: number, report: s
 export declare function formatPackagedFileCount(result: PackageSkillResult): string;
 /** Sum severity counts across lanes (per-skill → per-plugin → per-run). */
 export declare function sumSeverityCounts(counts: readonly SeverityCounts[]): SeverityCounts;
+export {};
 //# sourceMappingURL=issue-rendering.d.ts.map

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

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

package/dist/utils/issue-rendering.js

@@ -69,6 +69,10 @@ export function formatIssueSetHeading(issues, noun) {
 /**
  * Render one issue as its own lines, each prefixed with `indent`.
  *
+ * Takes a library `ValidationIssue` or a published `Finding` — the renderer
+ * reads only the fields the two share, so a lane holding a report's findings
+ * renders them as they are rather than casting them back to issues.
+ *
  * Returns an array rather than writing, so a caller can pick its own stream and
  * a unit test can assert over every line without capturing output.
  */

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

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

package/dist/utils/lens-population.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Where a run's LENS populations came from — the one vocabulary `vat resources
+ * query`, `check`, and `check`'s progress log all publish.
+ *
+ * Its own module, and a leaf, so a schema file can name it without importing
+ * the lens evaluators that compute it.
+ */
+/**
+ * Every lens provenance a run can publish: `'none'` when no evaluated lens
+ * populated anything, otherwise one of the population origins — derived from
+ * `POPULATION_ORIGINS`, so a new origin reaches every schema at once.
+ */
+export declare const LENS_POPULATIONS: readonly ["none", "store" | "derived", ...("store" | "derived")[]];
+/**
+ * Where the lenses' populations came from, as a run publishes it: `'none'` when
+ * no evaluated lens populated anything, `'store'` when every one that did was
+ * served from the store, otherwise `'derived'`.
+ */
+export type LensPopulation = (typeof LENS_POPULATIONS)[number];
+//# sourceMappingURL=lens-population.d.ts.map

package/dist/utils/lens-population.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens-population.d.ts","sourceRoot":"","sources":["../../src/utils/lens-population.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,oEAA2C,CAAC;AAEzE;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/utils/lens-population.js

@@ -0,0 +1,15 @@
+/**
+ * Where a run's LENS populations came from — the one vocabulary `vat resources
+ * query`, `check`, and `check`'s progress log all publish.
+ *
+ * Its own module, and a leaf, so a schema file can name it without importing
+ * the lens evaluators that compute it.
+ */
+import { POPULATION_ORIGINS } from '@vibe-agent-toolkit/resources';
+/**
+ * Every lens provenance a run can publish: `'none'` when no evaluated lens
+ * populated anything, otherwise one of the population origins — derived from
+ * `POPULATION_ORIGINS`, so a new origin reaches every schema at once.
+ */
+export const LENS_POPULATIONS = ['none', ...POPULATION_ORIGINS];
+//# sourceMappingURL=lens-population.js.map

package/dist/utils/lens-population.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens-population.js","sourceRoot":"","sources":["../../src/utils/lens-population.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,GAAG,kBAAkB,CAAU,CAAC"}

package/dist/utils/marketplace-io.d.ts

@@ -0,0 +1,63 @@
+/**
+ * The marketplace build's filesystem work, classified by the tree it touches.
+ *
+ * A copy reads one tree and writes another, and its errno cannot say which: `EACCES`
+ * is raised for an unreadable LICENSE and for a read-only `dist/` alike. So every read
+ * is classified on the side of the tree it reads (the build's INPUT is `source`; a tree
+ * the run itself wrote earlier is `destination`), and only a write is left to the
+ * marketplace tree's own boundary (a `destination` fault). The refusal table decides
+ * the code; neither is a defect in VAT. The tree written into is the marketplace's
+ * staged tree (see `buildMarketplace`): nothing here touches the built marketplace.
+ */
+import { type FsSide } from '@vibe-agent-toolkit/utils';
+/**
+ * One write into the marketplace tree this build owns (`dist/.claude/plugins/…`, staged): a
+ * raw fault the OS raises is a `destination` fault, naming what it was doing. An already
+ * classified fault (a refused read), a coded refusal, and a non-filesystem throw pass
+ * through untouched.
+ *
+ * @param what - Completes "Could not …", naming the path
+ */
+export declare function writingMarketplace<T>(what: string, write: () => Promise<T>): Promise<T>;
+/**
+ * Copy one file of the build's INPUT into the marketplace tree: the read is the
+ * source's (opened without blocking — a named pipe is refused, never waited on),
+ * the write the destination's.
+ *
+ * The tree already holds what earlier phases copied into it, links kept as links, so the
+ * copy is made the one way a file is made there (`copyRegularFile`): every directory on the
+ * way must be a real one, and the file is created exclusively. A regular file already at the
+ * name is replaced (a later `files[]` entry over an earlier one, a CHANGELOG over the
+ * tree-copied one); a link or a directory there — or a link where a directory goes — refuses
+ * the copy, as the input's layout, naming it.
+ *
+ * @param source - Absolute path the build reads
+ * @param target - Where it goes: `relative` (forward slashes) under `root`, a directory of the marketplace tree the build made
+ * @param sourceLabel - What a read refusal says the build was reading
+ * @param targetLabel - What a write refusal says the build was writing
+ */
+export declare function copyFileIntoMarketplace(source: string, target: {
+    readonly root: string;
+    readonly relative: string;
+}, sourceLabel: string, targetLabel: string): Promise<void>;
+/**
+ * Copy a directory tree into the marketplace tree: every file is proven
+ * readable first (`proveTreeReadable`), then the copy is written by the same walk,
+ * links kept as links. Both read the tree on its `side`.
+ *
+ * @param source - The directory the build reads, and the side of the run it is on
+ * @param target - Where it goes: `relative` (forward slashes) under `root`, a directory of the
+ *   marketplace tree the build made. The tree holds what earlier copies kept, links included, so
+ *   every directory between the two must be a real one: a link or a file there refuses the copy as
+ *   the input's layout, naming it — the copy is never made where a link points
+ * @param sourceLabel - What the build reads, for a write refusal's message
+ * @param targetLabel - What a write refusal says the build was writing
+ */
+export declare function copyTreeIntoMarketplace(source: {
+    readonly path: string;
+    readonly side: FsSide;
+}, target: {
+    readonly root: string;
+    readonly relative: string;
+}, sourceLabel: string, targetLabel: string): Promise<void>;
+//# sourceMappingURL=marketplace-io.d.ts.map

package/dist/utils/marketplace-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace-io.d.ts","sourceRoot":"","sources":["../../src/utils/marketplace-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAA6B,KAAK,MAAM,EAAkC,MAAM,2BAA2B,CAAC;AAEnH;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEvF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAC5D,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACxD,MAAM,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAC5D,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/utils/marketplace-io.js

@@ -0,0 +1,63 @@
+/**
+ * The marketplace build's filesystem work, classified by the tree it touches.
+ *
+ * A copy reads one tree and writes another, and its errno cannot say which: `EACCES`
+ * is raised for an unreadable LICENSE and for a read-only `dist/` alike. So every read
+ * is classified on the side of the tree it reads (the build's INPUT is `source`; a tree
+ * the run itself wrote earlier is `destination`), and only a write is left to the
+ * marketplace tree's own boundary (a `destination` fault). The refusal table decides
+ * the code; neither is a defect in VAT. The tree written into is the marketplace's
+ * staged tree (see `buildMarketplace`): nothing here touches the built marketplace.
+ */
+import { copyRegularFile, copyTree, proveTreeReadable, withFsFault } from '@vibe-agent-toolkit/utils';
+/**
+ * One write into the marketplace tree this build owns (`dist/.claude/plugins/…`, staged): a
+ * raw fault the OS raises is a `destination` fault, naming what it was doing. An already
+ * classified fault (a refused read), a coded refusal, and a non-filesystem throw pass
+ * through untouched.
+ *
+ * @param what - Completes "Could not …", naming the path
+ */
+export function writingMarketplace(what, write) {
+    return withFsFault({ side: 'destination', action: what }, write);
+}
+/**
+ * Copy one file of the build's INPUT into the marketplace tree: the read is the
+ * source's (opened without blocking — a named pipe is refused, never waited on),
+ * the write the destination's.
+ *
+ * The tree already holds what earlier phases copied into it, links kept as links, so the
+ * copy is made the one way a file is made there (`copyRegularFile`): every directory on the
+ * way must be a real one, and the file is created exclusively. A regular file already at the
+ * name is replaced (a later `files[]` entry over an earlier one, a CHANGELOG over the
+ * tree-copied one); a link or a directory there — or a link where a directory goes — refuses
+ * the copy, as the input's layout, naming it.
+ *
+ * @param source - Absolute path the build reads
+ * @param target - Where it goes: `relative` (forward slashes) under `root`, a directory of the marketplace tree the build made
+ * @param sourceLabel - What a read refusal says the build was reading
+ * @param targetLabel - What a write refusal says the build was writing
+ */
+export async function copyFileIntoMarketplace(source, target, sourceLabel, targetLabel) {
+    await writingMarketplace(`write ${targetLabel}`, () => copyRegularFile(source, target.root, target.relative, { side: 'source', reading: sourceLabel, existing: 'replace', writing: targetLabel }));
+}
+/**
+ * Copy a directory tree into the marketplace tree: every file is proven
+ * readable first (`proveTreeReadable`), then the copy is written by the same walk,
+ * links kept as links. Both read the tree on its `side`.
+ *
+ * @param source - The directory the build reads, and the side of the run it is on
+ * @param target - Where it goes: `relative` (forward slashes) under `root`, a directory of the
+ *   marketplace tree the build made. The tree holds what earlier copies kept, links included, so
+ *   every directory between the two must be a real one: a link or a file there refuses the copy as
+ *   the input's layout, naming it — the copy is never made where a link points
+ * @param sourceLabel - What the build reads, for a write refusal's message
+ * @param targetLabel - What a write refusal says the build was writing
+ */
+export async function copyTreeIntoMarketplace(source, target, sourceLabel, targetLabel) {
+    // Every file of it, links kept as links: a refusal names the entry the OS refused.
+    const walk = { links: 'preserve', side: source.side };
+    await proveTreeReadable(source.path, walk);
+    await writingMarketplace(`copy ${sourceLabel} into ${targetLabel}`, () => copyTree(source.path, target.root, target.relative, { ...walk, onto: 'fresh' }));
+}
+//# sourceMappingURL=marketplace-io.js.map

package/dist/utils/marketplace-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace-io.js","sourceRoot":"","sources":["../../src/utils/marketplace-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAe,iBAAiB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAEnH;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAI,IAAY,EAAE,KAAuB;IACzE,OAAO,WAAW,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAc,EACd,MAA4D,EAC5D,WAAmB,EACnB,WAAmB;IAEnB,MAAM,kBAAkB,CAAC,SAAS,WAAW,EAAE,EAAE,GAAG,EAAE,CACpD,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;AAChJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAwD,EACxD,MAA4D,EAC5D,WAAmB,EACnB,WAAmB;IAEnB,mFAAmF;IACnF,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAW,CAAC;IAC/D,MAAM,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC3C,MAAM,kBAAkB,CAAC,QAAQ,WAAW,SAAS,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;AAC7J,CAAC"}

package/dist/utils/operator-notices.d.ts

@@ -0,0 +1,97 @@
+/**
+ * The ONE route for a notice addressed to the operator — a config-loader warning, a projection-store
+ * notice — and the ONE predicate that says whether this process is a supervised checks child.
+ *
+ * ## 🔑 Each notice prints once per run, from the process that owes it
+ *
+ * `vat resources check` runs its checks in a supervised CHILD (`--supervised-by`), and `vat validate`
+ * runs that same child as its `checks` phase. The child reads the same config and keys the same
+ * store as the process that spawned it, and its stderr is inherited — so a notice both printed was
+ * printed twice for one run.
+ *
+ * Who owes what:
+ *
+ * - **A config warning** — the invoking process. It loads the config itself in both invocations
+ *   (`vat validate` to choose its phases, a standalone `vat resources check` to say whether the
+ *   project declares checks of its own), so a supervised child never prints one.
+ * - **The store notice** — whichever process keys the store first. `vat validate` opens its store
+ *   scope before any phase runs, so a child started as its phase stays quiet; a standalone
+ *   `vat resources check` opens no store at all — keying one is a git snapshot, unbounded work a
+ *   supervisor must not do before its watchdog exists — so the child it started prints it.
+ *
+ * The audience is decided ONCE, at the command's entry, from its explicit argv
+ * ({@link isSupervisedChild}), and entered as a scope ({@link withNoticeAudience}) the command's
+ * whole run sits inside. Nothing sets it as a side effect, and it ends with the scope — so a unit
+ * test, or a second command in one process, starts from "print everything".
+ *
+ * ## 🔑 "Once" belongs to the same scope
+ *
+ * A notice that would repeat — one config governing many skills, one unkeyable root asked about by
+ * every nested population scope — carries a `once` key, and the ledger that remembers it lives in
+ * the SAME scope as the audience: {@link withNoticeAudience} starts a fresh one, and so does the
+ * outermost population scope ({@link withNoticeLedger}) — starting from what was printed before it,
+ * so a config loaded both before and inside it warns once — so a second command in one process
+ * says it again. There is one ledger mechanism, not one per notice kind. Outside every scope (a config
+ * loaded before any population, a unit test) the ledger is the process's own, reset with the config
+ * cache ({@link resetUnscopedNoticeLedger}).
+ *
+ * ⚠️ Only NOTICES go through here: news that does not change what the run decides. A refusal's
+ * message, and anything that explains the document the child publishes, is the child's to print.
+ */
+/** What a notice is about — which decides which process owes it. */
+export type NoticeKind = 'config' | 'store';
+/** Which notices this process prints. Outside any scope, every one. */
+export type NoticeAudience = Readonly<Record<NoticeKind, boolean>>;
+/** Every notice — the audience of any process that is not a supervised child. */
+export declare const EVERY_NOTICE: NoticeAudience;
+/**
+ * Is this process the child a supervisor spawned to run the checks?
+ *
+ * 🔑 The ONE predicate, read from the explicit argv: `--supervised-by` is what a supervisor hands
+ * its child and nothing else passes (the child refuses it unless its parent is the supervisor the
+ * value names). Every decision that turns on "am I the child" asks this — which process runs the
+ * checks, which prints the "no checks of its own" warning, which notices it owes.
+ *
+ * @param argv - The command's parsed options
+ * @param argv.supervisedBy - The hidden `--supervised-by` value, or undefined
+ * @returns True in the supervised child
+ */
+export declare function isSupervisedChild<T extends {
+    readonly supervisedBy: string | undefined;
+}>(argv: T): argv is T & {
+    readonly supervisedBy: string;
+};
+/**
+ * Run `work` with `audience` deciding which notices this process prints, and a fresh `once` ledger.
+ *
+ * @param audience - Which notices to print
+ * @param work - The command's run
+ * @returns Whatever `work` returned
+ */
+export declare function withNoticeAudience<T>(audience: NoticeAudience, work: () => T): T;
+/**
+ * Run `work` inside a notice scope: the enclosing one when there is one, else a fresh scope that
+ * prints every notice — so `once` means once per command run, never once per process.
+ *
+ * 🚨 The fresh scope STARTS from what was already printed outside every scope, and copies it: a
+ * command loads its config before it opens its population scope (`vat validate`, to choose its
+ * phases) and again inside it, so a scope starting empty printed that config warning twice for one
+ * run. A copy, not the set itself, so what the scope prints stays its own and the next run says it
+ * again.
+ *
+ * @param work - The run
+ * @returns Whatever `work` returned
+ */
+export declare function withNoticeLedger<T>(work: () => T): T;
+/** Forget the `once` notices printed outside every scope — with the config cache they describe. */
+export declare function resetUnscopedNoticeLedger(): void;
+/**
+ * Write one notice to the operator's stderr — unless the enclosing scope says another process owes
+ * it, or it carries a `once` key this scope has already printed.
+ *
+ * @param kind - What the notice is about
+ * @param message - The notice, without a trailing newline
+ * @param once - When set, print this notice at most once per scope for this key
+ */
+export declare function noticeToOperator(kind: NoticeKind, message: string, once?: string): void;
+//# sourceMappingURL=operator-notices.d.ts.map

package/dist/utils/operator-notices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-notices.d.ts","sourceRoot":"","sources":["../../src/utils/operator-notices.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAIH,oEAAoE;AACpE,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE5C,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;AAEnE,iFAAiF;AACjF,eAAO,MAAM,YAAY,EAAE,cAA8C,CAAC;AAa1E;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EACvF,IAAI,EAAE,CAAC,GACN,IAAI,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAE/C;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAEhF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAIpD;AAED,mGAAmG;AACnG,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAUvF"}

package/dist/utils/operator-notices.js

@@ -0,0 +1,115 @@
+/**
+ * The ONE route for a notice addressed to the operator — a config-loader warning, a projection-store
+ * notice — and the ONE predicate that says whether this process is a supervised checks child.
+ *
+ * ## 🔑 Each notice prints once per run, from the process that owes it
+ *
+ * `vat resources check` runs its checks in a supervised CHILD (`--supervised-by`), and `vat validate`
+ * runs that same child as its `checks` phase. The child reads the same config and keys the same
+ * store as the process that spawned it, and its stderr is inherited — so a notice both printed was
+ * printed twice for one run.
+ *
+ * Who owes what:
+ *
+ * - **A config warning** — the invoking process. It loads the config itself in both invocations
+ *   (`vat validate` to choose its phases, a standalone `vat resources check` to say whether the
+ *   project declares checks of its own), so a supervised child never prints one.
+ * - **The store notice** — whichever process keys the store first. `vat validate` opens its store
+ *   scope before any phase runs, so a child started as its phase stays quiet; a standalone
+ *   `vat resources check` opens no store at all — keying one is a git snapshot, unbounded work a
+ *   supervisor must not do before its watchdog exists — so the child it started prints it.
+ *
+ * The audience is decided ONCE, at the command's entry, from its explicit argv
+ * ({@link isSupervisedChild}), and entered as a scope ({@link withNoticeAudience}) the command's
+ * whole run sits inside. Nothing sets it as a side effect, and it ends with the scope — so a unit
+ * test, or a second command in one process, starts from "print everything".
+ *
+ * ## 🔑 "Once" belongs to the same scope
+ *
+ * A notice that would repeat — one config governing many skills, one unkeyable root asked about by
+ * every nested population scope — carries a `once` key, and the ledger that remembers it lives in
+ * the SAME scope as the audience: {@link withNoticeAudience} starts a fresh one, and so does the
+ * outermost population scope ({@link withNoticeLedger}) — starting from what was printed before it,
+ * so a config loaded both before and inside it warns once — so a second command in one process
+ * says it again. There is one ledger mechanism, not one per notice kind. Outside every scope (a config
+ * loaded before any population, a unit test) the ledger is the process's own, reset with the config
+ * cache ({@link resetUnscopedNoticeLedger}).
+ *
+ * ⚠️ Only NOTICES go through here: news that does not change what the run decides. A refusal's
+ * message, and anything that explains the document the child publishes, is the child's to print.
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+/** Every notice — the audience of any process that is not a supervised child. */
+export const EVERY_NOTICE = { config: true, store: true };
+const noticeScope = new AsyncLocalStorage();
+/** The `once` ledger outside every scope. */
+const unscopedPrinted = new Set();
+/**
+ * Is this process the child a supervisor spawned to run the checks?
+ *
+ * 🔑 The ONE predicate, read from the explicit argv: `--supervised-by` is what a supervisor hands
+ * its child and nothing else passes (the child refuses it unless its parent is the supervisor the
+ * value names). Every decision that turns on "am I the child" asks this — which process runs the
+ * checks, which prints the "no checks of its own" warning, which notices it owes.
+ *
+ * @param argv - The command's parsed options
+ * @param argv.supervisedBy - The hidden `--supervised-by` value, or undefined
+ * @returns True in the supervised child
+ */
+export function isSupervisedChild(argv) {
+    return argv.supervisedBy !== undefined;
+}
+/**
+ * Run `work` with `audience` deciding which notices this process prints, and a fresh `once` ledger.
+ *
+ * @param audience - Which notices to print
+ * @param work - The command's run
+ * @returns Whatever `work` returned
+ */
+export function withNoticeAudience(audience, work) {
+    return noticeScope.run({ audience, printed: new Set() }, work);
+}
+/**
+ * Run `work` inside a notice scope: the enclosing one when there is one, else a fresh scope that
+ * prints every notice — so `once` means once per command run, never once per process.
+ *
+ * 🚨 The fresh scope STARTS from what was already printed outside every scope, and copies it: a
+ * command loads its config before it opens its population scope (`vat validate`, to choose its
+ * phases) and again inside it, so a scope starting empty printed that config warning twice for one
+ * run. A copy, not the set itself, so what the scope prints stays its own and the next run says it
+ * again.
+ *
+ * @param work - The run
+ * @returns Whatever `work` returned
+ */
+export function withNoticeLedger(work) {
+    return noticeScope.getStore() === undefined
+        ? noticeScope.run({ audience: EVERY_NOTICE, printed: new Set(unscopedPrinted) }, work)
+        : work();
+}
+/** Forget the `once` notices printed outside every scope — with the config cache they describe. */
+export function resetUnscopedNoticeLedger() {
+    unscopedPrinted.clear();
+}
+/**
+ * Write one notice to the operator's stderr — unless the enclosing scope says another process owes
+ * it, or it carries a `once` key this scope has already printed.
+ *
+ * @param kind - What the notice is about
+ * @param message - The notice, without a trailing newline
+ * @param once - When set, print this notice at most once per scope for this key
+ */
+export function noticeToOperator(kind, message, once) {
+    const scope = noticeScope.getStore();
+    if (!(scope?.audience ?? EVERY_NOTICE)[kind])
+        return;
+    if (once !== undefined) {
+        const printed = scope?.printed ?? unscopedPrinted;
+        const key = `${kind}:${once}`;
+        if (printed.has(key))
+            return;
+        printed.add(key);
+    }
+    process.stderr.write(`${message}\n`);
+}
+//# sourceMappingURL=operator-notices.js.map

package/dist/utils/operator-notices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-notices.js","sourceRoot":"","sources":["../../src/utils/operator-notices.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAQrD,iFAAiF;AACjF,MAAM,CAAC,MAAM,YAAY,GAAmB,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAQ1E,MAAM,WAAW,GAAG,IAAI,iBAAiB,EAAe,CAAC;AAEzD,6CAA6C;AAC7C,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;AAE1C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAO;IAEP,OAAO,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC;AACzC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAI,QAAwB,EAAE,IAAa;IAC3E,OAAO,WAAW,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;AACjE,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAI,IAAa;IAC/C,OAAO,WAAW,CAAC,QAAQ,EAAE,KAAK,SAAS;QACzC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,GAAG,CAAC,eAAe,CAAC,EAAE,EAAE,IAAI,CAAC;QACtF,CAAC,CAAC,IAAI,EAAE,CAAC;AACb,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,yBAAyB;IACvC,eAAe,CAAC,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAgB,EAAE,OAAe,EAAE,IAAa;IAC/E,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC;IACrC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,IAAI,YAAY,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO;IACrD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,KAAK,EAAE,OAAO,IAAI,eAAe,CAAC;QAClD,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;QAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO;QAC7B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/dist/utils/optional-backend.d.ts

@@ -21,6 +21,8 @@
  * error naming the package to install, and nothing more — the point is that
  * the failure is readable, not that it is survivable.
  */
+import type { ReportVerb } from '../report-schemas.js';
+import { CommandRefusalError } from './command-refusal.js';
 /**
  * Whether a thrown value is Node's "module not installed" error.
  *
@@ -32,23 +34,19 @@
  */
 export declare function isModuleMissing(error: unknown): boolean;
 /**
- * Report an uninstalled backend and exit, in the shape every other command
- * failure takes.
+ * The refusal for an uninstalled backend: `BACKEND_UNAVAILABLE`, exit **2** — a
+ * fact about the installation, not about the user's corpus, and a caller
+ * scripting `vat` must be able to tell those apart from the exit code alone.
  *
- * Exit code **2** — a system error, not a validation failure. An absent
- * optional package is a fact about the installation rather than about the
- * user's corpus, and a caller scripting `vat` must be able to tell those apart
- * from the exit code alone.
- *
- * Exported for the backends that are not selected by a Commander action —
- * {@link lazyAction} is the shape most take, but a store chosen by an
- * environment variable is loaded from inside a command rather than in place of
- * one, and it must fail the same way.
+ * Returned, not thrown and not written, so the verb that needed the backend
+ * publishes it in its own shape: {@link lazyAction} ends through the writer, and
+ * a store chosen from inside a command (the projection store) throws it into
+ * that command's catch.
  *
  * @param backend - What to name and how to install it
- * @returns Never; the process exits
+ * @returns The coded refusal; its message names the package and the install command
  */
-export declare function reportMissingBackend(backend: OptionalBackend): never;
+export declare function missingBackendError(backend: OptionalBackend): CommandRefusalError;
 /** One optional backend, as a user is told to install it. */
 export interface OptionalBackend {
     /** Human name used in the error message, e.g. `RAG`. */
@@ -65,14 +63,19 @@ export interface OptionalBackend {
  * stay eagerly available, which is exactly why the split is at the action
  * rather than at the command.
  *
+ * An absent backend ends the run through the writer as `verb`'s
+ * `BACKEND_UNAVAILABLE` refusal — every leaf behind this seam is a report verb
+ * with no `--format` and no `--strict`, so the document is YAML and the gate fixed.
+ *
+ * @param verb - The report verb the action is, for the refusal document
  * @param backend - What to name in the error when the import fails to resolve
  * @param load - Imports the module and returns the handler out of it
  * @returns A Commander action that loads, then delegates
  *
  * @example
  * ```typescript
- * .action(lazyAction(RAG_BACKEND, async () => (await import('./index-command.js')).indexCommand))
+ * .action(lazyAction('rag index', RAG_BACKEND, async () => (await import('./index-command.js')).indexCommand))
  * ```
  */
-export declare function lazyAction<Args extends readonly unknown[]>(backend: OptionalBackend, load: () => Promise<(...args: Args) => unknown>): (...args: Args) => Promise<void>;
+export declare function lazyAction<Args extends readonly unknown[]>(verb: ReportVerb, backend: OptionalBackend, load: () => Promise<(...args: Args) => unknown>): (...args: Args) => Promise<void>;
 //# sourceMappingURL=optional-backend.d.ts.map

package/dist/utils/optional-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"optional-backend.d.ts","sourceRoot":"","sources":["../../src/utils/optional-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAoBH;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOvD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,KAAK,CAcpE;AAED,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,IAAI,SAAS,SAAS,OAAO,EAAE,EACxD,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,GAC9C,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAalC"}
+{"version":3,"file":"optional-backend.d.ts","sourceRoot":"","sources":["../../src/utils/optional-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAa3D;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOvD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,mBAAmB,CAOjF;AAED,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CAAC,IAAI,SAAS,SAAS,OAAO,EAAE,EACxD,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,GAC9C,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAalC"}