@vibe-agent-toolkit/cli 0.2.0-rc.6 → 0.2.0-rc.8

package/dist/commands/okf/index.js

@@ -0,0 +1,114 @@
+/**
+ * `vat okf` command group — Open Knowledge Format bundles.
+ *
+ * One verb today. The group exists rather than a flat `vat okf-validate`
+ * because OKF is a format with more than one producer-side question in it (a
+ * bundle's index files are generated artifacts, §8), and a group is cheaper to
+ * extend than a top-level verb is to deprecate.
+ */
+import { Command, Option } from 'commander';
+import { okfValidateCommand } from './validate.js';
+export function createOkfCommand() {
+    const okf = new Command('okf');
+    okf
+        .description('Validate the Open Knowledge Format (OKF) bundles this project publishes')
+        .helpCommand(false)
+        .addHelpText('after', `
+Description:
+  An OKF bundle is a directory of markdown concept documents, one per file,
+  each carrying YAML frontmatter with a non-empty \`type\`. Bundles are declared
+  in vibe-agent-toolkit.config.yaml:
+
+    okf:
+      bundles:
+        knowledge:
+          root: ./knowledge          # required
+          severity: error            # optional; error is the default
+
+  The population is defined by the SPECIFICATION, not by a glob: every
+  non-reserved .md file anywhere beneath the root is a concept document, and
+  only index.md and log.md are reserved. There is deliberately no include or
+  exclude — a narrower population would let VAT report a clean bundle while a
+  file it never read broke conformance. If a subtree must not be part of a
+  bundle, it must not be under the bundle root.
+
+Example:
+  $ vat okf validate                   # Every declared bundle
+`);
+    okf
+        .command('validate')
+        .description('Check declared OKF bundles for conformance (§11)')
+        .argument('[bundle]', 'Validate only this declared bundle (default: all of them)')
+        .addOption(
+    // `.choices()`, not a bare `.option()`: an unrecognised value used to fall
+    // through to the YAML branch and exit 0, so `--format Json` in a pipeline
+    // failed downstream in `jq` instead of here, where the mistake is.
+    new Option('--format <format>', 'Output format: yaml (default) or json')
+        .choices(['yaml', 'json'])
+        .default('yaml'))
+        .option('--spec-version <version>', 'Cross-check a bundle-root index.md okf_version against this revision (e.g. 0.2). Omitted, a declaration is reported but not judged.')
+        .option('--debug', 'Verbose logging to stderr')
+        .action(async function (bundle) {
+        await okfValidateCommand(bundle, this.optsWithGlobals());
+    })
+        .addHelpText('after', `
+Description:
+  Checks each declared bundle against the OKF v0.2 conformance items VAT
+  implements:
+
+    §11.1  every non-reserved .md carries a parseable YAML frontmatter block
+    §11.2  every one of those blocks carries a non-empty \`type\`
+    §6.1   every markdown LINK and IMAGE — the [text](target) form — resolves
+           inside the bundle. A leading "/" resolves against the BUNDLE ROOT,
+           not the filesystem root, and EVERY path component is judged against
+           the bytes on disk, so a link that opens only because the author's
+           filesystem folds letter case or Unicode normalization form is
+           reported: the bundle is unpacked somewhere that does not fold.
+    §2     every .md under the root is a file whose bytes are under the root. A
+           symlink out of the bundle, or one pointing at nothing, is reported —
+           tar stores a symlink as a symlink, so it arrives dangling.
+    §8/§12 an index.md carries no frontmatter, except a bundle-root index.md,
+           which may carry okf_version and nothing else
+
+  NOT covered by the §6.1 check: wikilinks. \`[[other-concept]]\` is invisible to
+  the markdown parser, so a bundle written in that style gets no cross-link
+  checking at all, and a clean report says nothing about those links.
+
+  §11.3's structural rules for the BODY of index.md and log.md are not
+  implemented, so a clean report means §11.1 and §11.2 in full and §11.3 only
+  in part.
+
+  Unknown \`type\` values and unknown frontmatter keys are legal and are never
+  reported: §4.1 has no central registry and forbids rejecting extra keys.
+
+  The okf_version a bundle-root index.md declares is a CROSS-CHECK, never an
+  input. It is reported as data.bundles[].declaredOkfVersion; pass
+  --spec-version to have a disagreement reported as a finding.
+
+Output (the shared report envelope; schema: packages/cli/schemas/okf-validate.json):
+  status:    ok | findings | error
+  examined:  every document opened and judged, across every bundle. Zero with
+             a data.notice means nothing was checked: no okf.bundles declared,
+             or a declared root that holds no .md at all (a root one level too
+             deep reads exactly like this)
+  findings:  {code, severity, message, location, line?, link?} — location is
+             the project-relative path of the document to open
+  summary:   {errors, warnings, info}; exit 1 iff errors > 0
+  data.bundles[]: {bundle, root, conceptDocuments, reservedDocuments,
+             declaredOkfVersion?} — root as the config wrote it, never absolute
+
+Exit Codes:
+  0 - No error-severity findings
+  1 - At least one error-severity finding. Anything unreadable — the bundle
+      root, one subdirectory, or one document — is reported as a finding naming
+      exactly what could not be read, so the rest of that bundle and every other
+      bundle in the run are still checked and still reported
+  2 - System error (no config file, unknown bundle name)
+
+Example:
+  $ vat okf validate knowledge --format json
+  $ vat okf validate --spec-version 0.2
+`);
+    return okf;
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/okf/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/okf/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAA2B,MAAM,eAAe,CAAC;AAE5E,MAAM,UAAU,gBAAgB;IAC9B,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;IAE/B,GAAG;SACA,WAAW,CAAC,yEAAyE,CAAC;SACtF,WAAW,CAAC,KAAK,CAAC;SAClB,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;;;;;;;CAqBL,CACI,CAAC;IAEJ,GAAG;SACA,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,kDAAkD,CAAC;SAC/D,QAAQ,CAAC,UAAU,EAAE,2DAA2D,CAAC;SACjF,SAAS;IACR,2EAA2E;IAC3E,0EAA0E;IAC1E,mEAAmE;IACnE,IAAI,MAAM,CAAC,mBAAmB,EAAE,uCAAuC,CAAC;SACrE,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SACzB,OAAO,CAAC,MAAM,CAAC,CACnB;SACA,MAAM,CACL,0BAA0B,EAC1B,qIAAqI,CACtI;SACA,MAAM,CAAC,SAAS,EAAE,2BAA2B,CAAC;SAC9C,MAAM,CAAC,KAAK,WAA0B,MAA0B;QAC/D,MAAM,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAwB,CAAC,CAAC;IACjF,CAAC,CAAC;SACD,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDL,CACI,CAAC;IAEJ,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -0,0 +1,191 @@
+/**
+ * `vat okf validate [bundle]` — conformance for the OKF bundles a project declares.
+ *
+ * Producer-side, and the exit code says so: OKF §11 tells CONSUMERS not to
+ * reject a bundle over broken cross-links or unknown keys, but VAT is tooling
+ * for the publisher — the one party who can fix them — so a finding at `error`
+ * severity fails the command. An adopter who wants a softer gate lowers
+ * `okf.bundles.<name>.severity`; the finding is still reported either way.
+ */
+import { type OkfBundleReport } from '@vibe-agent-toolkit/resources';
+import { type Report } from '@vibe-agent-toolkit/schema';
+import { z } from 'zod';
+export interface OkfValidateOptions {
+    format?: 'yaml' | 'json';
+    specVersion?: string;
+    debug?: boolean;
+}
+/** One checked bundle's `data` row: what was read, never the findings (those are the envelope's). */
+export declare const OkfBundleSummarySchema: z.ZodObject<{
+    /** The `okf.bundles.<name>` key. */
+    bundle: z.ZodString;
+    /** The root as the config file wrote it — never the resolved absolute path. */
+    root: z.ZodString;
+    /** Every non-reserved `.md` beneath the root, bundle-relative and sorted. */
+    conceptDocuments: z.ZodArray<z.ZodString, "many">;
+    /** Every `index.md` / `log.md` beneath the root, bundle-relative and sorted. */
+    reservedDocuments: z.ZodArray<z.ZodString, "many">;
+    /** What the root `index.md` declares, when it declares a well-formed one. Reported, never obeyed. */
+    declaredOkfVersion: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    root: string;
+    bundle: string;
+    conceptDocuments: string[];
+    reservedDocuments: string[];
+    declaredOkfVersion?: string | undefined;
+}, {
+    root: string;
+    bundle: string;
+    conceptDocuments: string[];
+    reservedDocuments: string[];
+    declaredOkfVersion?: string | undefined;
+}>;
+export declare const OkfValidateDataSchema: z.ZodObject<{
+    bundles: z.ZodArray<z.ZodObject<{
+        /** The `okf.bundles.<name>` key. */
+        bundle: z.ZodString;
+        /** The root as the config file wrote it — never the resolved absolute path. */
+        root: z.ZodString;
+        /** Every non-reserved `.md` beneath the root, bundle-relative and sorted. */
+        conceptDocuments: z.ZodArray<z.ZodString, "many">;
+        /** Every `index.md` / `log.md` beneath the root, bundle-relative and sorted. */
+        reservedDocuments: z.ZodArray<z.ZodString, "many">;
+        /** What the root `index.md` declares, when it declares a well-formed one. Reported, never obeyed. */
+        declaredOkfVersion: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        root: string;
+        bundle: string;
+        conceptDocuments: string[];
+        reservedDocuments: string[];
+        declaredOkfVersion?: string | undefined;
+    }, {
+        root: string;
+        bundle: string;
+        conceptDocuments: string[];
+        reservedDocuments: string[];
+        declaredOkfVersion?: string | undefined;
+    }>, "many">;
+    /**
+     * Present only when there was nothing to check, and says what to declare or
+     * which root to look at.
+     *
+     * 🪤 The command used to print `status: passed`, `bundles: []`, exit 0 when a
+     * project declared no `okf.bundles` at all — a report indistinguishable from
+     * a bundle read in full and found conformant, so a mistyped key
+     * (`okf.bundle:`, `okf.Bundles:`) read as a clean bill of health. The
+     * envelope's REQUIRED `examined` now says `0` in that case, and this sentence
+     * says why. The exit code stays 0: nothing failed, and failing a build for a
+     * feature the project never opted into would be worse.
+     */
+    notice: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    bundles: {
+        root: string;
+        bundle: string;
+        conceptDocuments: string[];
+        reservedDocuments: string[];
+        declaredOkfVersion?: string | undefined;
+    }[];
+    notice?: string | undefined;
+}, {
+    bundles: {
+        root: string;
+        bundle: string;
+        conceptDocuments: string[];
+        reservedDocuments: string[];
+        declaredOkfVersion?: string | undefined;
+    }[];
+    notice?: string | undefined;
+}>;
+export type OkfBundleSummary = z.infer<typeof OkfBundleSummarySchema>;
+export type OkfValidateData = z.infer<typeof OkfValidateDataSchema>;
+/** The document this command publishes. */
+export declare const OKF_VALIDATE_REPORT_SCHEMA: import("@vibe-agent-toolkit/schema").ReportZodSchema<z.ZodObject<{
+    bundles: z.ZodArray<z.ZodObject<{
+        /** The `okf.bundles.<name>` key. */
+        bundle: z.ZodString;
+        /** The root as the config file wrote it — never the resolved absolute path. */
+        root: z.ZodString;
+        /** Every non-reserved `.md` beneath the root, bundle-relative and sorted. */
+        conceptDocuments: z.ZodArray<z.ZodString, "many">;
+        /** Every `index.md` / `log.md` beneath the root, bundle-relative and sorted. */
+        reservedDocuments: z.ZodArray<z.ZodString, "many">;
+        /** What the root `index.md` declares, when it declares a well-formed one. Reported, never obeyed. */
+        declaredOkfVersion: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        root: string;
+        bundle: string;
+        conceptDocuments: string[];
+        reservedDocuments: string[];
+        declaredOkfVersion?: string | undefined;
+    }, {
+        root: string;
+        bundle: string;
+        conceptDocuments: string[];
+        reservedDocuments: string[];
+        declaredOkfVersion?: string | undefined;
+    }>, "many">;
+    /**
+     * Present only when there was nothing to check, and says what to declare or
+     * which root to look at.
+     *
+     * 🪤 The command used to print `status: passed`, `bundles: []`, exit 0 when a
+     * project declared no `okf.bundles` at all — a report indistinguishable from
+     * a bundle read in full and found conformant, so a mistyped key
+     * (`okf.bundle:`, `okf.Bundles:`) read as a clean bill of health. The
+     * envelope's REQUIRED `examined` now says `0` in that case, and this sentence
+     * says why. The exit code stays 0: nothing failed, and failing a build for a
+     * feature the project never opted into would be worse.
+     */
+    notice: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    bundles: {
+        root: string;
+        bundle: string;
+        conceptDocuments: string[];
+        reservedDocuments: string[];
+        declaredOkfVersion?: string | undefined;
+    }[];
+    notice?: string | undefined;
+}, {
+    bundles: {
+        root: string;
+        bundle: string;
+        conceptDocuments: string[];
+        reservedDocuments: string[];
+        declaredOkfVersion?: string | undefined;
+    }[];
+    notice?: string | undefined;
+}>>;
+export type OkfValidateReport = Report<OkfValidateData>;
+/** One bundle's report beside the absolute root it was read from. */
+export interface CheckedOkfBundle {
+    readonly report: OkfBundleReport;
+    /** The resolved absolute root, so a finding can name a project-relative file. */
+    readonly root: string;
+}
+/**
+ * Assemble the report for a set of checked bundles. Pure, so the status rule
+ * and the denominator are unit-testable.
+ *
+ * `examined` counts every document that was opened and judged — concept and
+ * reserved alike — across every bundle. A declared-but-empty bundle and an
+ * empty declaration both examine zero, and the notice tells them apart.
+ *
+ * @param checked - One report per bundle that was actually checked, with its root
+ * @param projectRoot - What every finding's `location` is relative to
+ * @returns The report
+ */
+export declare function summarizeOkfBundles(checked: readonly CheckedOkfBundle[], projectRoot: string): OkfValidateReport;
+/**
+ * Check every selected bundle and assemble the report.
+ *
+ * Separate from the action so the shape is testable without a process exit.
+ *
+ * @param bundleArg - A single declared bundle name, or undefined for all of them
+ * @param options - Output format and the optional revision to cross-check against
+ */
+export declare function okfValidateReport(bundleArg: string | undefined, options: OkfValidateOptions): Promise<OkfValidateReport>;
+/** Action handler for `vat okf validate [bundle]`. */
+export declare function okfValidateCommand(bundleArg: string | undefined, options: OkfValidateOptions): Promise<void>;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/commands/okf/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAsE,KAAK,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAE7H,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qGAAqG;AACrG,eAAO,MAAM,sBAAsB;IACjC,oCAAoC;;IAEpC,+EAA+E;;IAE/E,6EAA6E;;IAE7E,gFAAgF;;IAEhF,qGAAqG;;;;;;;;;;;;;;EAE5F,CAAC;AAEZ,eAAO,MAAM,qBAAqB;;QAZhC,oCAAoC;;QAEpC,+EAA+E;;QAE/E,6EAA6E;;QAE7E,gFAAgF;;QAEhF,qGAAqG;;;;;;;;;;;;;;;IAMrG;;;;;;;;;;;OAWG;;;;;;;;;;;;;;;;;;;;EAEM,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,2CAA2C;AAC3C,eAAO,MAAM,0BAA0B;;QAjCrC,oCAAoC;;QAEpC,+EAA+E;;QAE/E,6EAA6E;;QAE7E,gFAAgF;;QAEhF,qGAAqG;;;;;;;;;;;;;;;IAMrG;;;;;;;;;;;OAWG;;;;;;;;;;;;;;;;;;;;GAQwE,CAAC;AAE9E,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;AAExD,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AA8ED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAyBnB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAmB5B;AAED,sDAAsD;AACtD,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/commands/okf/validate.js

@@ -0,0 +1,190 @@
+/**
+ * `vat okf validate [bundle]` — conformance for the OKF bundles a project declares.
+ *
+ * Producer-side, and the exit code says so: OKF §11 tells CONSUMERS not to
+ * reject a bundle over broken cross-links or unknown keys, but VAT is tooling
+ * for the publisher — the one party who can fix them — so a finding at `error`
+ * severity fails the command. An adopter who wants a softer gate lowers
+ * `okf.bundles.<name>.severity`; the finding is still reported either way.
+ */
+import { dirname } from 'node:path';
+import { okfBundleRuns, parseConfigFile, validateOkfBundle, } from '@vibe-agent-toolkit/resources';
+import { buildReport, exitCodeForSeverityCounts, reportSchema } from '@vibe-agent-toolkit/schema';
+import { findConfigFile, issueLocation, safePath } from '@vibe-agent-toolkit/utils';
+import { z } from 'zod';
+import { handleReportCommandError } from '../../utils/command-error.js';
+import { createLogger } from '../../utils/logger.js';
+import { writeStructuredOutput } from '../../utils/output.js';
+/** One checked bundle's `data` row: what was read, never the findings (those are the envelope's). */
+export const OkfBundleSummarySchema = z.object({
+    /** The `okf.bundles.<name>` key. */
+    bundle: z.string(),
+    /** The root as the config file wrote it — never the resolved absolute path. */
+    root: z.string(),
+    /** Every non-reserved `.md` beneath the root, bundle-relative and sorted. */
+    conceptDocuments: z.array(z.string()),
+    /** Every `index.md` / `log.md` beneath the root, bundle-relative and sorted. */
+    reservedDocuments: z.array(z.string()),
+    /** What the root `index.md` declares, when it declares a well-formed one. Reported, never obeyed. */
+    declaredOkfVersion: z.string().optional(),
+}).strict();
+export const OkfValidateDataSchema = z.object({
+    bundles: z.array(OkfBundleSummarySchema),
+    /**
+     * Present only when there was nothing to check, and says what to declare or
+     * which root to look at.
+     *
+     * 🪤 The command used to print `status: passed`, `bundles: []`, exit 0 when a
+     * project declared no `okf.bundles` at all — a report indistinguishable from
+     * a bundle read in full and found conformant, so a mistyped key
+     * (`okf.bundle:`, `okf.Bundles:`) read as a clean bill of health. The
+     * envelope's REQUIRED `examined` now says `0` in that case, and this sentence
+     * says why. The exit code stays 0: nothing failed, and failing a build for a
+     * feature the project never opted into would be worse.
+     */
+    notice: z.string().optional(),
+}).strict();
+/** The document this command publishes. */
+export const OKF_VALIDATE_REPORT_SCHEMA = reportSchema(OkfValidateDataSchema);
+/**
+ * The bundles whose root was read successfully and held not one markdown file.
+ *
+ * 🪤 The same green-without-running shape the `notice` exists for, one level
+ * down. A `root:` typo that lands on a real-but-wrong directory, or a root
+ * written one level too deep, produces zero findings and an `examined` that
+ * only THIS bundle's rows explain — so the run says so in words too.
+ *
+ * A bundle carrying findings is excluded even when its document lists are empty:
+ * that is the unreadable-root case, which already says the truthful thing in its
+ * own finding, and "contains no .md files" would be a second, wronger sentence
+ * about a directory that does not exist.
+ *
+ * @param bundles - Every bundle report in the run
+ * @returns The names of the vacuous ones, in report order
+ */
+function vacuousBundles(bundles) {
+    return bundles
+        .filter((report) => report.findings.length === 0 &&
+        report.conceptDocuments.length === 0 &&
+        report.reservedDocuments.length === 0)
+        .map((report) => report.bundle);
+}
+/**
+ * The sentence a run with one or more vacuous bundles carries.
+ *
+ * @param vacuous - Names of the bundles whose root held no markdown at all
+ * @returns A notice naming each of them and the config key to check
+ */
+function vacuousNotice(vacuous) {
+    const named = vacuous.map((bundle) => `'${bundle}'`).join(', ');
+    const subject = vacuous.length === 1 ? 'it' : 'them';
+    return `${named} contains no .md files, so nothing was checked in ${subject}. A root pointing one level too deep, or at a real-but-wrong directory, reads exactly like this — check \`okf.bundles.<name>.root\`.`;
+}
+/**
+ * The sentence a run carries when it examined less than a reader would assume.
+ *
+ * @param bundles - Every bundle report in the run
+ * @returns The notice, or nothing when every declared bundle held documents
+ */
+function noticeFor(bundles) {
+    if (bundles.length === 0)
+        return NO_BUNDLES_NOTICE;
+    const vacuous = vacuousBundles(bundles);
+    return vacuous.length > 0 ? vacuousNotice(vacuous) : undefined;
+}
+const NO_BUNDLES_NOTICE = 'No OKF bundles are declared, so nothing was checked. Declare one under `okf.bundles.<name>.root` in vibe-agent-toolkit.config.yaml; every non-reserved .md beneath that root is then checked for frontmatter carrying a non-empty `type`.';
+/**
+ * A bundle's finding as the envelope publishes it: the same code, severity and
+ * message, with `location` the project-relative path of the document — the
+ * file you would open — rather than a bundle-relative `document` a reader had
+ * to join with the bundle's root by hand.
+ *
+ * @param finding - The lane's finding
+ * @param root - The bundle's absolute root
+ * @param projectRoot - What `location` is relative to
+ * @returns The published finding
+ */
+function toFinding(finding, root, projectRoot) {
+    return {
+        code: finding.code,
+        severity: finding.severity,
+        message: finding.message,
+        location: issueLocation(safePath.join(root, finding.document), projectRoot),
+        ...(finding.link === undefined ? {} : { link: finding.link }),
+        ...(finding.line === undefined ? {} : { line: finding.line }),
+    };
+}
+/**
+ * Assemble the report for a set of checked bundles. Pure, so the status rule
+ * and the denominator are unit-testable.
+ *
+ * `examined` counts every document that was opened and judged — concept and
+ * reserved alike — across every bundle. A declared-but-empty bundle and an
+ * empty declaration both examine zero, and the notice tells them apart.
+ *
+ * @param checked - One report per bundle that was actually checked, with its root
+ * @param projectRoot - What every finding's `location` is relative to
+ * @returns The report
+ */
+export function summarizeOkfBundles(checked, projectRoot) {
+    const bundles = checked.map((entry) => entry.report);
+    const findings = checked.flatMap((entry) => entry.report.findings.map((finding) => toFinding(finding, entry.root, projectRoot)));
+    const examined = bundles.reduce((sum, report) => sum + report.conceptDocuments.length + report.reservedDocuments.length, 0);
+    const notice = noticeFor(bundles);
+    return buildReport({
+        examined,
+        findings,
+        data: {
+            bundles: bundles.map((report) => ({
+                bundle: report.bundle,
+                root: report.root,
+                conceptDocuments: report.conceptDocuments,
+                reservedDocuments: report.reservedDocuments,
+                ...(report.declaredOkfVersion === undefined ? {} : { declaredOkfVersion: report.declaredOkfVersion }),
+            })),
+            ...(notice === undefined ? {} : { notice }),
+        },
+    });
+}
+/**
+ * Check every selected bundle and assemble the report.
+ *
+ * Separate from the action so the shape is testable without a process exit.
+ *
+ * @param bundleArg - A single declared bundle name, or undefined for all of them
+ * @param options - Output format and the optional revision to cross-check against
+ */
+export async function okfValidateReport(bundleArg, options) {
+    const configPath = findConfigFile(process.cwd());
+    if (!configPath) {
+        throw new Error('No vibe-agent-toolkit.config.yaml found. Run from a project directory.');
+    }
+    const config = await parseConfigFile(configPath);
+    const projectRoot = dirname(configPath);
+    const runs = okfBundleRuns(config.okf, projectRoot, {
+        ...(bundleArg !== undefined && { bundle: bundleArg }),
+        ...(options.specVersion !== undefined && { specVersion: options.specVersion }),
+    });
+    const checked = [];
+    for (const run of runs) {
+        checked.push({ report: await validateOkfBundle(run), root: run.root });
+    }
+    return summarizeOkfBundles(checked, projectRoot);
+}
+/** Action handler for `vat okf validate [bundle]`. */
+export async function okfValidateCommand(bundleArg, options) {
+    const logger = createLogger(options.debug === true ? { debug: true } : {});
+    const startTime = Date.now();
+    try {
+        const report = { ...(await okfValidateReport(bundleArg, options)), durationMs: Date.now() - startTime };
+        writeStructuredOutput(report, options.format);
+        // Read from the counts the report PUBLISHES, not from the status word: an
+        // adopter who promotes or lowers a bundle's severity then gates on exactly
+        // the number a reader can see.
+        process.exit(exitCodeForSeverityCounts(report.summary));
+    }
+    catch (error) {
+        handleReportCommandError(error, logger, startTime, 'OKF validate', options.format);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/okf/validate.js.map

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

package/dist/commands/phase-utils.d.ts

@@ -1,7 +1,7 @@
 /**
  * Shared utilities for top-level phase orchestration commands (vat build, vat verify, vat validate).
  */
-import { type SeverityCounts } from '@vibe-agent-toolkit/schema';
+import { type ExitCodeValue, type SeverityCounts } from '@vibe-agent-toolkit/schema';
 import { type Command } from 'commander';
 import { createLogger } from '../utils/logger.js';
 /**
@@ -23,7 +23,7 @@ import { createLogger } from '../utils/logger.js';
  */
 export interface PhaseOutcome {
     document: unknown;
-    exitCode: number;
+    exitCode: ExitCodeValue;
     /**
      * The phase failed UNEXPECTEDLY, so `document` is the shared error envelope
      * (`{status, error, duration}`) rather than the command's own report.
@@ -106,7 +106,7 @@ export interface PhaseResult {
     name: string;
     status: PhaseStatus;
     /** The exit code the phase claimed for itself. */
-    exitCode?: number;
+    exitCode?: ExitCodeValue;
     /** Why the phase could not run at all (it threw past its own error handling). */
     error?: string;
     /**
@@ -226,9 +226,10 @@ export declare function worseOf(a: PhaseStatus, b: PhaseStatus): PhaseStatus;
  *
  * | exit code             | phase status   | why                                     |
  * |-----------------------|----------------|-----------------------------------------|
- * | 0                     | `success`      | ran, found nothing actionable           |
- * | 1                     | `error`        | ran, found validation errors            |
- * | 2 (or any other)      | `system-error` | the phase itself reported a system error |
+ * | `OK` (0)              | `success`      | ran, found nothing actionable           |
+ * | `FINDINGS` (1)        | `error`        | ran, found validation errors            |
+ * | `ERROR` (2)           | `system-error` | the phase itself reported a system error |
+ * | anything else         | throws         | a defect in the phase, filed by `runPhase` as `system-error` |
  *
  * The exit code is then reconciled with the phase's OWN reported `status`,
  * worst-wins. An exit code has three values and cannot express `warning`:
@@ -252,15 +253,31 @@ export declare function phaseResultFromOutcome(name: string, outcome: PhaseOutco
  * `phases[].report` instead.
  *
  * Three cases, and the middle one is the one to get right:
- *   - an unexpected failure publishes the shared envelope through
- *     `writeYamlOutput`, matching `handleCommandError`;
+ *   - an unexpected failure publishes the shared envelope in the format the
+ *     operator asked for, matching `handleCommandError`;
  *   - a command's own report goes through the command's own `render`;
  *   - no document at all (an unconfigured run, a dry run) publishes nothing.
  *
+ * 🔑 **`format` is REQUIRED, and that is the whole point of it being a
+ * parameter.** This arm hardcoded `writeYamlOutput`, and it is `vat resources
+ * validate`'s ONLY error exit — so `--format json` silently produced YAML on the
+ * one path a scripted consumer most needs to parse. The sibling
+ * `handleCommandError` has the same parameter as an OPTIONAL one carrying a
+ * docstring that says a caller with a `--format` option must pass it, and two
+ * commands added in the same change dropped it anyway: a docstring is not a
+ * mechanism. Here the type system asks, so a new caller cannot forget. A command
+ * that offers no `--format` passes `undefined` and says so at its call site.
+ *
+ * ⚠️ It governs the FAILURE envelope only. A command's own report still goes
+ * through `render`, which is what a `--format text` lane needs.
+ *
  * @param outcome - What the phase produced
  * @param render - How this command publishes its OWN report shape
+ * @param format - What the operator asked for: `json`, or anything else (and
+ *   `undefined`) for YAML — the same two-branch switch `handleCommandError` and
+ *   every success path use
  */
-export declare function finishCommand(outcome: PhaseOutcome, render: (document: unknown) => void): never;
+export declare function finishCommand(outcome: PhaseOutcome, render: (document: unknown) => void, format: string | undefined): never;
 /**
  * Run a single phase in THIS process and fold its outcome into a result.
  *
@@ -311,9 +328,9 @@ export declare function phaseIssueCounts(result: PhaseResult): SeverityCounts;
 export declare function aggregatePhaseIssueCounts(results: readonly PhaseResult[]): SeverityCounts;
 /**
  * The process exit code for a set of phase outcomes, per the exit-code contract
- * every orchestrator's help text documents: 0 pass, 1 validation failure,
- * 2 system error. Warnings do not fail a run — they are published in the status
- * and counts instead.
+ * every orchestrator's help text documents: `OK` pass, `FINDINGS` validation
+ * failure, `ERROR` system error. Warnings do not fail a run — they are
+ * published in the status and counts instead.
  */
-export declare function exitCodeForPhases(results: readonly PhaseResult[]): 0 | 1 | 2;
+export declare function exitCodeForPhases(results: readonly PhaseResult[]): ExitCodeValue;
 //# sourceMappingURL=phase-utils.d.ts.map

package/dist/commands/phase-utils.d.ts.map

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