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

package/dist/commands/resources/validate-schema.d.ts

@@ -0,0 +1,326 @@
+/**
+ * The document `vat resources validate` publishes, apart from the command.
+ *
+ * A sibling module because the published-shape registry imports it and the
+ * command imports the writer that imports the registry: a schema declared in
+ * the command module itself would be an import cycle, read before it is
+ * initialised.
+ *
+ * 🔑 **One base, one meaning of `summary`.** `data.root` is the project root,
+ * stated once; every finding's `location` and every `data.files[].path` is
+ * relative to it. `summary` — on the envelope, on a collection, on a file row —
+ * always counts FINDINGS by severity; the number of resources validated is the
+ * envelope's `examined`.
+ */
+import { type Report } from '@vibe-agent-toolkit/schema';
+import { z } from 'zod';
+import type { ExaminedDeclaration } from '../../utils/run-integrity.js';
+/** What `examined` counts for `vat resources validate`, and the remedy when it is zero. */
+export declare const RESOURCES_VALIDATE_EXAMINED: ExaminedDeclaration;
+declare const ResourcesValidateDataSchema: z.ZodObject<{
+    /** The project root — the ONE base every finding `location` and file `path` is relative to. */
+    root: z.ZodString;
+    /** Every configured collection, keyed by id; `{}` when the project configures none. */
+    collections: z.ZodRecord<z.ZodString, z.ZodObject<{
+        /** Resources in the collection. */
+        resourceCount: z.ZodNumber;
+        /** Whether the collection declares a frontmatter schema. */
+        hasSchema: z.ZodBoolean;
+        /** How that schema is applied, when it declares one. */
+        validationMode: z.ZodOptional<z.ZodEnum<["strict", "permissive"]>>;
+        /** Files in the collection carrying at least one error-severity finding. */
+        filesWithErrors: z.ZodNumber;
+        /** The findings located in the collection's files, by severity. */
+        summary: z.ZodObject<{
+            errors: z.ZodNumber;
+            warnings: z.ZodNumber;
+            info: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            info: number;
+            errors: number;
+            warnings: number;
+        }, {
+            info: number;
+            errors: number;
+            warnings: number;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+        filesWithErrors: number;
+        resourceCount: number;
+        hasSchema: boolean;
+        validationMode?: "strict" | "permissive" | undefined;
+    }, {
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+        filesWithErrors: number;
+        resourceCount: number;
+        hasSchema: boolean;
+        validationMode?: "strict" | "permissive" | undefined;
+    }>>;
+    population: z.ZodNullable<z.ZodEnum<["store" | "derived", ...("store" | "derived")[]]>>;
+    /** Present only under `--verbose`: one row per resource validated. */
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Relative to `data.root`, forward slashes. */
+        path: z.ZodString;
+        status: z.ZodEnum<["ok", "findings"]>;
+        /** The findings located in this file, by severity. */
+        summary: z.ZodObject<{
+            errors: z.ZodNumber;
+            warnings: z.ZodNumber;
+            info: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            info: number;
+            errors: number;
+            warnings: number;
+        }, {
+            info: number;
+            errors: number;
+            warnings: number;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        status: "ok" | "findings";
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+    }, {
+        path: string;
+        status: "ok" | "findings";
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    root: string;
+    population: "store" | "derived" | null;
+    collections: Record<string, {
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+        filesWithErrors: number;
+        resourceCount: number;
+        hasSchema: boolean;
+        validationMode?: "strict" | "permissive" | undefined;
+    }>;
+    files?: {
+        path: string;
+        status: "ok" | "findings";
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+    }[] | undefined;
+}, {
+    root: string;
+    population: "store" | "derived" | null;
+    collections: Record<string, {
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+        filesWithErrors: number;
+        resourceCount: number;
+        hasSchema: boolean;
+        validationMode?: "strict" | "permissive" | undefined;
+    }>;
+    files?: {
+        path: string;
+        status: "ok" | "findings";
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+    }[] | undefined;
+}>;
+export type ResourcesValidateData = z.infer<typeof ResourcesValidateDataSchema>;
+/** The document this command publishes. */
+export declare const RESOURCES_VALIDATE_REPORT_SCHEMA: import("@vibe-agent-toolkit/schema").ReportZodSchema<z.ZodObject<{
+    /** The project root — the ONE base every finding `location` and file `path` is relative to. */
+    root: z.ZodString;
+    /** Every configured collection, keyed by id; `{}` when the project configures none. */
+    collections: z.ZodRecord<z.ZodString, z.ZodObject<{
+        /** Resources in the collection. */
+        resourceCount: z.ZodNumber;
+        /** Whether the collection declares a frontmatter schema. */
+        hasSchema: z.ZodBoolean;
+        /** How that schema is applied, when it declares one. */
+        validationMode: z.ZodOptional<z.ZodEnum<["strict", "permissive"]>>;
+        /** Files in the collection carrying at least one error-severity finding. */
+        filesWithErrors: z.ZodNumber;
+        /** The findings located in the collection's files, by severity. */
+        summary: z.ZodObject<{
+            errors: z.ZodNumber;
+            warnings: z.ZodNumber;
+            info: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            info: number;
+            errors: number;
+            warnings: number;
+        }, {
+            info: number;
+            errors: number;
+            warnings: number;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+        filesWithErrors: number;
+        resourceCount: number;
+        hasSchema: boolean;
+        validationMode?: "strict" | "permissive" | undefined;
+    }, {
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+        filesWithErrors: number;
+        resourceCount: number;
+        hasSchema: boolean;
+        validationMode?: "strict" | "permissive" | undefined;
+    }>>;
+    population: z.ZodNullable<z.ZodEnum<["store" | "derived", ...("store" | "derived")[]]>>;
+    /** Present only under `--verbose`: one row per resource validated. */
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Relative to `data.root`, forward slashes. */
+        path: z.ZodString;
+        status: z.ZodEnum<["ok", "findings"]>;
+        /** The findings located in this file, by severity. */
+        summary: z.ZodObject<{
+            errors: z.ZodNumber;
+            warnings: z.ZodNumber;
+            info: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            info: number;
+            errors: number;
+            warnings: number;
+        }, {
+            info: number;
+            errors: number;
+            warnings: number;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        status: "ok" | "findings";
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+    }, {
+        path: string;
+        status: "ok" | "findings";
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    root: string;
+    population: "store" | "derived" | null;
+    collections: Record<string, {
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+        filesWithErrors: number;
+        resourceCount: number;
+        hasSchema: boolean;
+        validationMode?: "strict" | "permissive" | undefined;
+    }>;
+    files?: {
+        path: string;
+        status: "ok" | "findings";
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+    }[] | undefined;
+}, {
+    root: string;
+    population: "store" | "derived" | null;
+    collections: Record<string, {
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+        filesWithErrors: number;
+        resourceCount: number;
+        hasSchema: boolean;
+        validationMode?: "strict" | "permissive" | undefined;
+    }>;
+    files?: {
+        path: string;
+        status: "ok" | "findings";
+        summary: {
+            info: number;
+            errors: number;
+            warnings: number;
+        };
+    }[] | undefined;
+}>, z.ZodObject<Omit<{
+    code: z.ZodString;
+    severity: z.ZodEnum<["error", "warning", "info", "ignore"]>;
+    message: z.ZodString;
+    location: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    line: z.ZodOptional<z.ZodNumber>;
+    field: z.ZodOptional<z.ZodString>;
+    link: z.ZodOptional<z.ZodString>;
+    fix: z.ZodOptional<z.ZodString>;
+    reference: z.ZodOptional<z.ZodString>;
+    suggestion: z.ZodOptional<z.ZodString>;
+}, "severity"> & {
+    severity: z.ZodEnum<["error", "warning", "info"]>;
+    column: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    code: string;
+    message: string;
+    severity: "error" | "warning" | "info";
+    fix?: string | undefined;
+    reference?: string | undefined;
+    location?: string | undefined;
+    line?: number | undefined;
+    field?: string | undefined;
+    link?: string | undefined;
+    suggestion?: string | undefined;
+    column?: number | undefined;
+}, {
+    code: string;
+    message: string;
+    severity: "error" | "warning" | "info";
+    fix?: string | undefined;
+    reference?: string | undefined;
+    location?: string | undefined;
+    line?: number | undefined;
+    field?: string | undefined;
+    link?: string | undefined;
+    suggestion?: string | undefined;
+    column?: number | undefined;
+}>>;
+export type ResourcesValidateReport = Report<ResourcesValidateData>;
+export {};
+//# sourceMappingURL=validate-schema.d.ts.map

package/dist/commands/resources/validate-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-schema.d.ts","sourceRoot":"","sources":["../../../src/commands/resources/validate-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAqD,KAAK,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAC5G,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,2FAA2F;AAC3F,eAAO,MAAM,2BAA2B,EAAE,mBAKzC,CAAC;AAyBF,QAAA,MAAM,2BAA2B;IAC/B,+FAA+F;;IAE/F,uFAAuF;;QAxBvF,mCAAmC;;QAEnC,4DAA4D;;QAE5D,wDAAwD;;QAExD,4EAA4E;;QAE5E,mEAAmE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwBnE,sEAAsE;;QAlBtE,gDAAgD;;;QAGhD,sDAAsD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiB7C,CAAC;AAEZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,2CAA2C;AAC3C,eAAO,MAAM,gCAAgC;IAjB3C,+FAA+F;;IAE/F,uFAAuF;;QAxBvF,mCAAmC;;QAEnC,4DAA4D;;QAE5D,wDAAwD;;QAExD,4EAA4E;;QAE5E,mEAAmE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwBnE,sEAAsE;;QAlBtE,gDAAgD;;;QAGhD,sDAAsD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsBgD,CAAC;AAEzG,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC"}

package/dist/commands/resources/validate-schema.js

@@ -0,0 +1,60 @@
+/**
+ * The document `vat resources validate` publishes, apart from the command.
+ *
+ * A sibling module because the published-shape registry imports it and the
+ * command imports the writer that imports the registry: a schema declared in
+ * the command module itself would be an import cycle, read before it is
+ * initialised.
+ *
+ * 🔑 **One base, one meaning of `summary`.** `data.root` is the project root,
+ * stated once; every finding's `location` and every `data.files[].path` is
+ * relative to it. `summary` — on the envelope, on a collection, on a file row —
+ * always counts FINDINGS by severity; the number of resources validated is the
+ * envelope's `examined`.
+ */
+import { POPULATION_ORIGINS } from '@vibe-agent-toolkit/resources';
+import { FindingSchema, reportSchema, SeverityCountsSchema } from '@vibe-agent-toolkit/schema';
+import { z } from 'zod';
+/** What `examined` counts for `vat resources validate`, and the remedy when it is zero. */
+export const RESOURCES_VALIDATE_EXAMINED = {
+    unit: 'resources',
+    whenZero: 'The path names no markdown, resources.include/resources.exclude enumerate nothing (a broad exclude, a'
+        + ' shallow or sparse checkout, a root that resolved somewhere else), or --collection names a collection'
+        + ' no file matched. `vat resources scan` over the same path lists what an enumeration finds.',
+};
+/** One configured collection, as this run saw it. */
+const CollectionSchema = z.object({
+    /** Resources in the collection. */
+    resourceCount: z.number().int().nonnegative(),
+    /** Whether the collection declares a frontmatter schema. */
+    hasSchema: z.boolean(),
+    /** How that schema is applied, when it declares one. */
+    validationMode: z.enum(['strict', 'permissive']).optional(),
+    /** Files in the collection carrying at least one error-severity finding. */
+    filesWithErrors: z.number().int().nonnegative(),
+    /** The findings located in the collection's files, by severity. */
+    summary: SeverityCountsSchema,
+}).strict();
+/** One validated resource — every one, clean or not — under `--verbose`. */
+const FileRowSchema = z.object({
+    /** Relative to `data.root`, forward slashes. */
+    path: z.string(),
+    status: z.enum(['ok', 'findings']),
+    /** The findings located in this file, by severity. */
+    summary: SeverityCountsSchema,
+}).strict();
+const ResourcesValidateDataSchema = z.object({
+    /** The project root — the ONE base every finding `location` and file `path` is relative to. */
+    root: z.string(),
+    /** Every configured collection, keyed by id; `{}` when the project configures none. */
+    collections: z.record(z.string(), CollectionSchema),
+    population: z.enum(POPULATION_ORIGINS).nullable().describe('Whether the membership was served from the projection store (`store`) or derived this run (`derived`).'
+        + ' `derived` too under `VAT_PROJECTION_STORE=0`, which skips only the store.'
+        + ' `null` only when no projection enumerated the membership: the walk lane ran'
+        + ' (`VAT_RESOURCES_CRAWL=walk`), or the crawl declined a projection bound to another root and walked.'),
+    /** Present only under `--verbose`: one row per resource validated. */
+    files: z.array(FileRowSchema).optional(),
+}).strict();
+/** The document this command publishes. */
+export const RESOURCES_VALIDATE_REPORT_SCHEMA = reportSchema(ResourcesValidateDataSchema, FindingSchema);
+//# sourceMappingURL=validate-schema.js.map

package/dist/commands/resources/validate-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-schema.js","sourceRoot":"","sources":["../../../src/commands/resources/validate-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,oBAAoB,EAAe,MAAM,4BAA4B,CAAC;AAC5G,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,2FAA2F;AAC3F,MAAM,CAAC,MAAM,2BAA2B,GAAwB;IAC9D,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,uGAAuG;UAC7G,uGAAuG;UACvG,4FAA4F;CACjG,CAAC;AAEF,qDAAqD;AACrD,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,mCAAmC;IACnC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC7C,4DAA4D;IAC5D,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,wDAAwD;IACxD,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3D,4EAA4E;IAC5E,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC/C,mEAAmE;IACnE,OAAO,EAAE,oBAAoB;CAC9B,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,4EAA4E;AAC5E,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,gDAAgD;IAChD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAClC,sDAAsD;IACtD,OAAO,EAAE,oBAAoB;CAC9B,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,+FAA+F;IAC/F,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,uFAAuF;IACvF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC;IACnD,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACxD,wGAAwG;UACtG,4EAA4E;UAC5E,8EAA8E;UAC9E,qGAAqG,CACxG;IACD,sEAAsE;IACtE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,2CAA2C;AAC3C,MAAM,CAAC,MAAM,gCAAgC,GAAG,YAAY,CAAC,2BAA2B,EAAE,aAAa,CAAC,CAAC"}

package/dist/commands/resources/validate.d.ts

@@ -1,159 +1,57 @@
 /**
  * Resources validate command - strict validation with error reporting
- */
-import { DeferredArtifacts, type CollectionStats, type ProjectConfig, type RegistryStats } from '@vibe-agent-toolkit/resources';
-import { calculateValidationStatus, type IssueSeverity, type SeverityCounts, type ValidationIssueCode } from '@vibe-agent-toolkit/schema';
-import { type FindingCountSummary } from '../../utils/issue-rendering.js';
-import { type PhaseOutcome } from '../phase-utils.js';
-/**
- * Collection statistics with error tracking.
- */
-interface CollectionStatWithErrors {
-    resourceCount: number;
-    hasSchema: boolean;
-    validationMode?: 'strict' | 'permissive';
-    filesWithErrors?: number;
-    errorCount?: number;
-}
-/**
- * Issues grouped by file — the `--verbose` row.
  *
- * Each entry carries the validation `code` and resolved `severity` so the
- * serialized output is honest about what fired and at what level. Warning- and
- * info-severity issues appear here too (so users see them); only error-severity
- * issues drive the exit code, which the library decides via `hasErrors`.
- *
- * This shape is optimized for `> file` then `grep`, not for reading.
+ * Publishes the `Report<T>` envelope (`validate-schema.ts`): every finding flat
+ * with its `location` relative to `data.root`, `examined` = resources validated.
+ * A run over zero resources is refused by the writer, from the registry's
+ * declared denominator — never by a check at this site.
  */
-interface FileIssues {
-    file: string;
-    issues: Array<{
-        line: number;
-        column: number;
-        code: string;
-        severity: IssueSeverity;
-        message: string;
-    }>;
+import { DeferredArtifacts, type CollectionStats, type ProjectConfig } from '@vibe-agent-toolkit/resources';
+import { type ValidationIssue } from '@vibe-agent-toolkit/schema';
+import type { DocumentFormat } from '../../report-schemas.js';
+import type { PhaseOutcome } from '../phase-utils.js';
+import type { ResourcesValidateData, ResourcesValidateReport } from './validate-schema.js';
+/** One resource this run validated: its absolute path and the collections it belongs to. */
+export interface ValidatedResource {
+    readonly filePath: string;
+    readonly collections?: readonly string[] | undefined;
 }
-/**
- * One file's DEFAULT row: which file has problems, how many, of what code — and
- * nothing else.
- *
- * The unit is the file because the file is what a reader opens to act. Zero
- * severity buckets are ABSENT keys rather than `0` (see {@link summarizeFindings}):
- * three zero columns per file is what makes a listing unreadable at corpus
- * scale, and `errors: 0` beside a red exit code reads as a contradiction.
- */
-type FileIssueSummary = FindingCountSummary & {
-    file: string;
-};
-/** A file's row in the reported listing — counts by default, detail under `--verbose`. */
-type FileIssueRow = FileIssues | FileIssueSummary;
-/**
- * The verdict vocabulary, taken from the shared collapse rather than restated —
- * so this command cannot drift into a private vocabulary again. Every other
- * validation lane answers "issues → status" with these same three values.
- */
-type ValidationStatus = ReturnType<typeof calculateValidationStatus>;
-/**
- * Output data structure for validation results.
- *
- * Naming contract, and it is load-bearing: a field named `error*` counts
- * ERROR-severity issues only — the ones that fail the run. A field named
- * `issue*` counts issues of every severity. Mixing the two is what made an
- * earlier shape of this object contradict itself (`status: success` beside
- * `filesWithErrors: 1` beside `errorsFound: 0`).
- */
-interface ValidationOutputData {
-    /** Worst ACTIONABLE severity over the reported issues; info-only is `success`. */
-    status: ValidationStatus;
-    filesScanned: number;
-    /** Files carrying at least one ERROR-severity issue. */
-    filesWithErrors?: number;
-    linksChecked?: number;
-    /** ERROR-severity issues only; this is what drives the exit code. */
-    errorsFound?: number;
-    /** Every issue, split by severity. Only `errors` is fatal. */
-    issueCounts?: SeverityCounts;
-    /** Count per validation code, ALL severities. */
-    issueSummary?: Record<string, number>;
-    validationMode: 'strict' | 'permissive';
-    frontmatterSchema?: string;
-    collections?: Record<string, CollectionStatWithErrors>;
-    /**
-     * Per-file rows, ALL severities. Counts-only by default; per-issue detail
-     * under `--verbose`. A file that emitted nothing has no row in either mode —
-     * `filesScanned` above stays the true denominator.
-     */
-    issues?: FileIssueRow[];
-    durationSecs: number;
+/** What {@link buildResourcesValidateReport} needs — the run's results, nothing it has to go and read. */
+export interface ResourcesValidateInput {
+    /** The project root: the ONE base every `location` and `path` is relative to. */
+    readonly root: string;
+    /** The resources in scope (the `--collection` ones when filtered) — `examined` is their count. */
+    readonly resources: readonly ValidatedResource[];
+    /** The library's severity-resolved issues over those resources; `ignore` is dropped here. */
+    readonly issues: readonly ValidationIssue[];
+    /** The configured collections, narrowed to the `--collection` one when filtered. */
+    readonly collectionStats: CollectionStats | undefined;
+    /** `--verbose`: publish one `data.files` row per resource validated. */
+    readonly verbose: boolean;
+    readonly durationMs: number;
+    /** Where the membership came from — {@link publishedPopulation} of the population the load returned. */
+    readonly population: ResourcesValidateData['population'];
 }
 /**
- * Issue data for a single validation issue, flattened for display.
+ * Build the report. Pure: no file system, no clock, no `process.exit`.
  *
- * - `file` is RELATIVE to projectRoot (matches `issue.location`), used for display.
- * - `absPath` is the ABSOLUTE resource path, used for registry/collection lookups.
- * - `code` / `severity` come straight from the unified `ValidationIssue`, and stay
- *   typed as such: that makes an `ErrorData` a structural `ValidationIssue`, so the
- *   shared `calculateValidationStatus`/`countBySeverity` consume this list directly
- *   instead of a local re-implementation counting severities its own way.
- */
-type ErrorData = {
-    file: string;
-    absPath: string;
-    line: number;
-    column: number;
-    code: ValidationIssueCode;
-    severity: IssueSeverity;
-    message: string;
-};
-/**
- * Output format options.
- */
-type OutputFormat = 'yaml' | 'json' | 'text';
-/**
- * Context for validation output.
- */
-interface ValidationContext {
-    stats: RegistryStats;
-    validationMetadata: Pick<ValidationOutputData, 'validationMode' | 'frontmatterSchema'>;
-    collectionStats: CollectionStats | undefined;
-    duration: number;
-    /**
-     * The `--collection` filter, when one was passed. Carried so the
-     * run-integrity refusal can name the filter that matched nothing — the builder
-     * asks the denominator, not the config, but the MESSAGE should say what the
-     * operator most likely typed wrong.
-     */
-    collection?: string;
-}
-/** The only thing the output layer needs from the registry: collection lookup by ABSOLUTE path. */
-type RegistryLookup = {
-    getResource: (path: string) => {
-        collections?: (string[] | undefined);
-    } | undefined;
-};
-/**
- * Build the structured (yaml/json) payload for a run that surfaced issues.
+ * `status` and `summary` are derived by `buildReport` from the findings, so an
+ * info-only run is `findings` with `summary.info` naming what was found — one
+ * vocabulary with every other report verb. The run-integrity refusal for a run
+ * over zero resources is NOT decided here; the writer adds it from the
+ * registry's declared denominator.
  *
- * Surfaces ALL severity-resolved issues (errors AND warnings/info) so users see
- * them; only the `error*`-named counts are error-severity. Exported so the
- * reported vocabulary is unit-testable without spawning the CLI.
- *
- * `verbose` picks the UNIT of the `issues` listing, not the content: one
- * counts-only row per file by default, one entry per issue when asked. Every
- * other field is a total about the run and is byte-identical in both modes.
- * It defaults to the summary, so a caller that has no opinion gets the readable
- * form rather than the 90-skill-scale one.
+ * @param input - The run's results
+ * @returns The report, before the writer's run-integrity pass
  */
-export declare function buildIssuesOutputData(issueData: ErrorData[], context: ValidationContext, registry: RegistryLookup, verbose?: boolean): ValidationOutputData;
+export declare function buildResourcesValidateReport(input: ResourcesValidateInput): ResourcesValidateReport;
 export interface ValidateOptions {
     debug?: boolean;
     /** Show all scanned resources, including those without issues (per-issue detail). */
     verbose?: boolean;
     frontmatterSchema?: string;
     validationMode?: 'strict' | 'permissive';
-    format?: OutputFormat;
+    format?: DocumentFormat;
     collection?: string;
     checkExternalUrls?: boolean;
     checkHtmlAnchors?: boolean;
@@ -192,37 +90,15 @@ export declare function resolveNoCache(options: Pick<ValidateOptions, 'cache'>):
  */
 export declare function computeDeferredArtifacts(config: ProjectConfig | undefined, projectRoot: string): Promise<DeferredArtifacts | undefined>;
 /**
- * Validate resources and hand back the document and exit code, printing the
- * document nowhere.
+ * Validate resources and hand back the report, printing it nowhere.
  *
- * The phase entry point for `vat validate` and `vat verify`. Everything that was
- * already streaming to stderr — progress, git-tracker stats, `--format text`
- * findings — still streams from here, because stderr was inherited by the child
- * process this replaces and so was free either way.
+ * The phase entry point for `vat validate` and `vat verify`, and the command's
+ * own. The report is the one BEFORE the writer's run-integrity pass: inside an
+ * orchestrator, `runPhase` applies the same pass to this phase's report, by the
+ * declaration this verb gives its own writer. A
+ * refusal is the envelope's error branch, its message already on stderr, and a
+ * site-specific run-integrity finding is warned here, where both lanes see it.
  */
 export declare function runResourcesValidatePhase(pathArg: string | undefined, options: ValidateOptions): Promise<PhaseOutcome>;
-/**
- * The exit code for a run, from the two verdicts that can each fail it.
- *
- * `hasErrors` is the library's, computed over the WHOLE project before any
- * `--collection` filter, so an error the filter hid from the document still
- * fails the run. The document's `status` is computed over what was REPORTED —
- * which is where the run-integrity refusal lands (see
- * {@link buildValidationDocument}), and it has no counterpart in `hasErrors`
- * because the library never sees the filter. Either alone lets one of those two
- * failures through; the run fails on both.
- */
-export declare function exitCodeForValidateRun(hasErrors: boolean, document: Pick<ValidationOutputData, 'status'>): 0 | 1;
 export declare function validateCommand(pathArg: string | undefined, options: ValidateOptions): Promise<void>;
-/**
- * THE document this command publishes, for either outcome.
- *
- * Built as a value and rendered separately, because the same document now has
- * two destinations: stdout for a command-line run, and `phases[].report` when
- * `vat validate` or `vat verify` runs this as one of its phases in their own
- * process. Deriving it twice — once to print, once to hand back — is how the two
- * lanes come to disagree about what this command reported.
- */
-export declare function buildValidationDocument(issueData: ErrorData[], context: ValidationContext, registry: RegistryLookup, verbose: boolean): ValidationOutputData;
-export {};
 //# sourceMappingURL=validate.d.ts.map

package/dist/commands/resources/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/commands/resources/validate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/commands/resources/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EACL,iBAAiB,EAGjB,KAAK,eAAe,EAEpB,KAAK,aAAa,EACnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAML,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAC;AAKpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAY9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAkE3F,4FAA4F;AAC5F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACtD;AAED,0GAA0G;AAC1G,MAAM,WAAW,sBAAsB;IACrC,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kGAAkG;IAClG,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACjD,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,oFAAoF;IACpF,QAAQ,CAAC,eAAe,EAAE,eAAe,GAAG,SAAS,CAAC;IACtD,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wGAAwG;IACxG,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAC;CAC1D;AAqCD;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,sBAAsB,GAAG,uBAAuB,CAsBnG;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;IACzC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,GAAG,OAAO,CAE/E;AAiBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAiDxC;AAqHD;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,YAAY,CAAC,CAWvB;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAMf"}