@cairn-tool/cairn 2.0.0

package/dist/agent/test/index.js

@@ -0,0 +1,181 @@
+import fs from "node:fs";
+import path from "node:path";
+import { diagnostic } from "../types.js";
+import { renderBundle } from "../render.js";
+import { profileFor } from "../targets/index.js";
+import { TEST_CHECKS, countAssertions, evaluate } from "./assert.js";
+import { TEST_FILE_SCHEMA_VERSION, discoverTestFiles, parseTestFile } from "./schema.js";
+export * from "./assert.js";
+export * from "./schema.js";
+function posix(value) {
+    return value.split(path.sep).join("/");
+}
+function note(code, message, extra = {}) {
+    return diagnostic(code, message, "exact", extra);
+}
+function fail(code, message, extra = {}) {
+    return { ...diagnostic(code, message, "unsupported", extra), severity: "error" };
+}
+/**
+ * Renders each `<target>/<profile>` combination at most once.
+ *
+ * Cases overlap heavily — a bundle typically asserts several things about the
+ * same tree — and rendering is the expensive part, so the cache is what keeps a
+ * large test file from re-rendering the bundle per assertion.
+ */
+class RenderCache {
+    bundle;
+    trees = new Map();
+    constructor(bundle) {
+        this.bundle = bundle;
+    }
+    get(target, profile) {
+        const key = `${target}/${profile}`;
+        const cached = this.trees.get(key);
+        if (cached)
+            return cached;
+        const rendered = renderBundle(this.bundle, [target], [profile]);
+        const prefix = `${key}/`;
+        const artifacts = rendered.artifacts
+            .filter((artifact) => artifact.path.startsWith(prefix))
+            .map((artifact) => ({ ...artifact, path: artifact.path.slice(prefix.length) }));
+        const tree = { target, profile, artifacts, diagnostics: rendered.diagnostics };
+        this.trees.set(key, tree);
+        return tree;
+    }
+    /** Every parse and render diagnostic the evaluated trees reported. */
+    forwarded() {
+        return [...this.trees.values()].flatMap((tree) => tree.diagnostics);
+    }
+}
+function loadCases(bundle, override) {
+    const cases = [];
+    const diagnostics = [];
+    const files = [];
+    for (const file of discoverTestFiles(bundle.root, override)) {
+        const relative = posix(path.relative(bundle.root, file)) || posix(file);
+        files.push(relative);
+        const parsed = parseTestFile(fs.readFileSync(file, "utf8"), relative);
+        cases.push(...parsed.cases);
+        diagnostics.push(...parsed.diagnostics);
+    }
+    return { files, cases, diagnostics };
+}
+/** The target and profile pairs a case is evaluated against, after every filter. */
+function selection(testCase, options) {
+    const targets = options.targets.length
+        ? testCase.targets.filter((target) => options.targets.includes(target))
+        : testCase.targets;
+    const pairs = [];
+    for (const target of targets)
+        for (const profile of testCase.profiles) {
+            if (!options.profiles.includes(profile))
+                continue;
+            // A target that does not support an output profile emits nothing for it,
+            // so every path assertion would fail for a reason that is a property of
+            // the target rather than of the bundle.
+            if (!profileFor(target).profiles.includes(profile))
+                continue;
+            pairs.push({ target, profile });
+        }
+    return pairs;
+}
+/**
+ * Runs the contract tests stored with a bundle.
+ *
+ * Nothing here executes: every expectation is evaluated against the same
+ * in-memory render `agent convert` would write.
+ */
+export function runTests(bundle, options) {
+    const loaded = loadCases(bundle, options.tests);
+    const diagnostics = [...loaded.diagnostics];
+    if (options.cases.length) {
+        const known = new Set(loaded.cases.map((item) => item.name));
+        const unknown = options.cases.filter((name) => !known.has(name));
+        // A typo in CI must not read as "everything passed", so this is a usage
+        // error rather than a run that selects nothing.
+        if (unknown.length)
+            throw new Error(`Unknown --case name(s): ${unknown.join(", ")}`);
+    }
+    const cache = new RenderCache(bundle);
+    const results = [];
+    for (const testCase of loaded.cases) {
+        const selected = options.cases.length && !options.cases.includes(testCase.name);
+        const pairs = selected ? [] : selection(testCase, options);
+        if (!pairs.length) {
+            const reason = selected
+                ? "excluded by --case"
+                : "no selected target and profile combination applies";
+            results.push({
+                name: testCase.name,
+                file: testCase.file,
+                status: "skipped",
+                targets: [],
+                profiles: [],
+                // Zero rather than the declared count: nothing was evaluated, and
+                // counting a skipped case's expectations would make `counts.assertions`
+                // read as coverage the run never had.
+                assertions: { total: 0, passed: 0, failed: 0 },
+                failures: [],
+                reason,
+            });
+            diagnostics.push(note("AB720", `Case '${testCase.name}' was skipped: ${reason}`, {
+                path: testCase.file,
+                component: testCase.name,
+            }));
+            continue;
+        }
+        const failures = [];
+        for (const { target, profile } of pairs)
+            for (const failure of evaluate(testCase.expect, cache.get(target, profile)))
+                failures.push({ ...failure, target, profile });
+        const total = countAssertions(testCase.expect) * pairs.length;
+        results.push({
+            name: testCase.name,
+            file: testCase.file,
+            status: failures.length ? "failed" : "passed",
+            targets: [...new Set(pairs.map((pair) => pair.target))],
+            profiles: [...new Set(pairs.map((pair) => pair.profile))],
+            assertions: {
+                total,
+                // One expectation can yield more than one failure: a single
+                // `maxSeverity` ceiling reports every diagnostic above it. So the
+                // subtraction is clamped rather than allowed to go negative.
+                passed: Math.max(total - failures.length, 0),
+                failed: failures.length,
+            },
+            failures,
+        });
+        for (const failure of failures)
+            diagnostics.push(fail(failure.code, `${testCase.name} [${failure.assertion}]: ${failure.message}`, {
+                component: testCase.name,
+                path: testCase.file,
+                target: failure.target,
+                profile: failure.profile,
+                remediation: `Expected ${failure.expected}; found ${failure.actual}.`,
+            }));
+    }
+    if (!loaded.cases.length)
+        diagnostics.push({
+            ...diagnostic("AB701", "No test cases were found", "approximate", {
+                path: options.tests ?? "tests",
+                remediation: "Add tests/<name>.test.yaml to the bundle, or point --tests at the file that holds them.",
+            }),
+        });
+    const report = {
+        schemaVersion: TEST_FILE_SCHEMA_VERSION,
+        files: loaded.files,
+        checks: [...TEST_CHECKS],
+        counts: {
+            cases: results.length,
+            passed: results.filter((item) => item.status === "passed").length,
+            failed: results.filter((item) => item.status === "failed").length,
+            skipped: results.filter((item) => item.status === "skipped").length,
+            assertions: results.reduce((total, item) => total + item.assertions.total, 0),
+        },
+        cases: results,
+        native: [],
+    };
+    return { report, diagnostics, forwarded: cache.forwarded() };
+}
+//# sourceMappingURL=index.js.map

package/dist/agent/test/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/test/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAQ7B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAErE,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEzF,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAsD5B,SAAS,KAAK,CAAC,KAAa;IAC1B,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,IAAI,CACX,IAAY,EACZ,OAAe,EACf,QAAkC,EAAE;IAEpC,OAAO,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,IAAI,CACX,IAAY,EACZ,OAAe,EACf,QAAkC,EAAE;IAEpC,OAAO,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AACnF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,WAAW;IAGc;IAFZ,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEzD,YAA6B,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAEpD,GAAG,CAAC,MAAmB,EAAE,OAAqB;QAC5C,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC;QACzB,MAAM,SAAS,GAAe,QAAQ,CAAC,SAAS;aAC7C,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;aACtD,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAClF,MAAM,IAAI,GAAiB,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC7F,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sEAAsE;IACtE,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtE,CAAC;CACF;AAED,SAAS,SAAS,CAChB,MAAmB,EACnB,QAA4B;IAE5B,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,MAAM,WAAW,GAAsB,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC5D,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC;QACxE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;QACtE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AACvC,CAAC;AAED,oFAAoF;AACpF,SAAS,SAAS,CAChB,QAAkB,EAClB,OAAwB;IAExB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM;QACpC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACvE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;IACrB,MAAM,KAAK,GAA0D,EAAE,CAAC;IACxE,KAAK,MAAM,MAAM,IAAI,OAAO;QAC1B,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACxC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,SAAS;YAClD,yEAAyE;YACzE,wEAAwE;YACxE,wCAAwC;YACxC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,SAAS;YAC7D,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAClC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACtB,MAAmB,EACnB,OAAwB;IAExB,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,WAAW,GAAsB,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAE/D,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACjE,wEAAwE;QACxE,gDAAgD;QAChD,IAAI,OAAO,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChF,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,QAAQ;gBACrB,CAAC,CAAC,oBAAoB;gBACtB,CAAC,CAAC,oDAAoD,CAAC;YACzD,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,EAAE;gBACZ,kEAAkE;gBAClE,wEAAwE;gBACxE,sCAAsC;gBACtC,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;gBAC9C,QAAQ,EAAE,EAAE;gBACZ,MAAM;aACP,CAAC,CAAC;YACH,WAAW,CAAC,IAAI,CACd,IAAI,CAAC,OAAO,EAAE,SAAS,QAAQ,CAAC,IAAI,kBAAkB,MAAM,EAAE,EAAE;gBAC9D,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,SAAS,EAAE,QAAQ,CAAC,IAAI;aACzB,CAAC,CACH,CAAC;YACF,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAsB,EAAE,CAAC;QACvC,KAAK,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,KAAK;YACrC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBACzE,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAEnD,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;QAC9D,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;YAC7C,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YACvD,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;YACzD,UAAU,EAAE;gBACV,KAAK;gBACL,4DAA4D;gBAC5D,kEAAkE;gBAClE,6DAA6D;gBAC7D,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC5C,MAAM,EAAE,QAAQ,CAAC,MAAM;aACxB;YACD,QAAQ;SACT,CAAC,CAAC;QACH,KAAK,MAAM,OAAO,IAAI,QAAQ;YAC5B,WAAW,CAAC,IAAI,CACd,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,SAAS,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE;gBAChF,SAAS,EAAE,QAAQ,CAAC,IAAI;gBACxB,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,WAAW,EAAE,YAAY,OAAO,CAAC,QAAQ,WAAW,OAAO,CAAC,MAAM,GAAG;aACtE,CAAC,CACH,CAAC;IACN,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM;QACtB,WAAW,CAAC,IAAI,CAAC;YACf,GAAG,UAAU,CAAC,OAAO,EAAE,0BAA0B,EAAE,aAAa,EAAE;gBAChE,IAAI,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO;gBAC9B,WAAW,EACT,yFAAyF;aAC5F,CAAC;SACH,CAAC,CAAC;IAEL,MAAM,MAAM,GAAe;QACzB,aAAa,EAAE,wBAAwB;QACvC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,CAAC,GAAG,WAAW,CAAC;QACxB,MAAM,EAAE;YACN,KAAK,EAAE,OAAO,CAAC,MAAM;YACrB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM;YACjE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM;YACjE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;YACnE,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;SAC9E;QACD,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,EAAE;KACX,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC;AAC/D,CAAC"}

package/dist/agent/test/schema.d.ts

@@ -0,0 +1,81 @@
+import type { AgentDiagnostic, AgentProfile, AgentTarget } from "../types.js";
+/**
+ * Version of the test-case file format itself.
+ *
+ * A fourth hand-owned version, alongside `CONTRACT_VERSION` (the command
+ * contract surface), `PROFILE_SCHEMA_VERSION` (the target profile structure),
+ * and the bundle `schemaVersion` (the manifest authors write). This one versions
+ * the *assertions* authors write. Semantic-release does not touch it; bump it
+ * only when an existing test file would mean something different.
+ */
+export declare const TEST_FILE_SCHEMA_VERSION = "1";
+/** The directory `agent test` looks in when `--tests` is not given. */
+export declare const DEFAULT_TESTS_ROOT = "tests";
+export declare const SEVERITIES: readonly ["notice", "warning", "error"];
+export type Severity = (typeof SEVERITIES)[number];
+export interface FileExpectation {
+    /** Rendered path, relative to `<target>/<profile>/`. */
+    path: string;
+    /** Octal file mode, spelled as in `artifacts[].mode`. */
+    mode?: string;
+    includes: string[];
+    excludes: string[];
+    /** JavaScript regular expression sources, tested against the whole file. */
+    matches: string[];
+}
+export interface JsonExpectation {
+    path: string;
+    /** Recursive subset match: every key here must be present with this value. */
+    contains: Record<string, unknown>;
+}
+export interface DiagnosticExpectation {
+    includes: string[];
+    excludes: string[];
+    /** The worst severity the render may report. Absent means unconstrained. */
+    maxSeverity?: Severity;
+}
+export interface DigestExpectation {
+    /** Golden digest over every rendered artifact for the target and profile. */
+    tree?: string;
+    /** Golden digest per rendered file, keyed by rendered path. */
+    files: Record<string, string>;
+}
+export interface CaseExpectations {
+    paths: {
+        present: string[];
+        absent: string[];
+    };
+    files: FileExpectation[];
+    json: JsonExpectation[];
+    diagnostics?: DiagnosticExpectation;
+    digest?: DigestExpectation;
+}
+export interface TestCase {
+    name: string;
+    /** Test file the case was read from, bundle-relative where possible. */
+    file: string;
+    targets: AgentTarget[];
+    profiles: AgentProfile[];
+    expect: CaseExpectations;
+}
+/**
+ * Parses one test file into cases.
+ *
+ * Structural problems become `AB700` findings rather than throws, so one
+ * malformed case does not hide every other case in the bundle — the same split
+ * `src/agent/parser.ts` makes between unreadable input and invalid content. A
+ * file whose YAML will not parse at all is the caller's error to raise.
+ */
+export declare function parseTestFile(content: string, file: string): {
+    cases: TestCase[];
+    diagnostics: AgentDiagnostic[];
+};
+/**
+ * Test files for a bundle, in a stable order.
+ *
+ * With no override this is `<bundle>/tests/**\/*.test.yaml`, a convention rather
+ * than a manifest key: that keeps schema 2 a strict superset of schema 1 and
+ * lets a v1 or legacy bundle carry tests too. An explicit `--tests` path that
+ * does not exist throws, because a typo there must not read as "no tests".
+ */
+export declare function discoverTestFiles(bundleRoot: string, override?: string): string[];

package/dist/agent/test/schema.js

@@ -0,0 +1,235 @@
+import fs from "node:fs";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+import { diagnostic, TARGETS } from "../types.js";
+import { knownKeys, object, optionalString, strings } from "../../config-schema.js";
+/**
+ * Version of the test-case file format itself.
+ *
+ * A fourth hand-owned version, alongside `CONTRACT_VERSION` (the command
+ * contract surface), `PROFILE_SCHEMA_VERSION` (the target profile structure),
+ * and the bundle `schemaVersion` (the manifest authors write). This one versions
+ * the *assertions* authors write. Semantic-release does not touch it; bump it
+ * only when an existing test file would mean something different.
+ */
+export const TEST_FILE_SCHEMA_VERSION = "1";
+/** The directory `agent test` looks in when `--tests` is not given. */
+export const DEFAULT_TESTS_ROOT = "tests";
+/** Suffixes a discovered test file must carry. */
+const TEST_FILE_SUFFIXES = [".test.yaml", ".test.yml"];
+export const SEVERITIES = ["notice", "warning", "error"];
+const FILE_KEYS = new Set(["schemaVersion", "cases"]);
+const CASE_KEYS = new Set(["name", "targets", "profiles", "expect"]);
+const EXPECT_KEYS = new Set(["paths", "files", "json", "diagnostics", "digest"]);
+const PATHS_KEYS = new Set(["present", "absent"]);
+const FILE_EXPECT_KEYS = new Set(["path", "mode", "includes", "excludes", "matches"]);
+const JSON_EXPECT_KEYS = new Set(["path", "contains"]);
+const DIAGNOSTIC_KEYS = new Set(["includes", "excludes", "maxSeverity"]);
+const DIGEST_KEYS = new Set(["tree", "files"]);
+function invalid(message, file) {
+    return {
+        ...diagnostic("AB700", message, "unsupported", {
+            path: file,
+            remediation: `Correct the test file; see the format for schemaVersion ${TEST_FILE_SCHEMA_VERSION}.`,
+        }),
+        severity: "error",
+    };
+}
+function requiredString(value, name) {
+    const result = optionalString(value, name);
+    if (result === undefined || !result.trim())
+        throw new Error(`${name} is required`);
+    return result;
+}
+function parseTargets(value, name) {
+    const raw = strings(value, name, [...TARGETS]);
+    const unknown = raw.filter((item) => !TARGETS.includes(item));
+    if (unknown.length)
+        throw new Error(`Unknown ${name}: ${unknown.join(", ")}`);
+    return [...new Set(raw)];
+}
+function parseProfiles(value, name) {
+    const raw = strings(value, name, ["plugin", "project"]);
+    const unknown = raw.filter((item) => item !== "plugin" && item !== "project");
+    if (unknown.length)
+        throw new Error(`Unknown ${name}: ${unknown.join(", ")}`);
+    return [...new Set(raw)];
+}
+function parseFileExpectation(value, name) {
+    const entry = object(value, name);
+    knownKeys(entry, FILE_EXPECT_KEYS, name);
+    const mode = optionalString(entry.mode, `${name}.mode`);
+    if (mode !== undefined && !/^0[0-7]{3}$/.test(mode))
+        throw new Error(`${name}.mode must be a four-digit octal mode such as '0644'`);
+    const matches = strings(entry.matches, `${name}.matches`, []);
+    for (const source of matches) {
+        try {
+            new RegExp(source);
+        }
+        catch (error) {
+            throw new Error(`${name}.matches has an invalid pattern: ${error.message}`, {
+                cause: error,
+            });
+        }
+    }
+    return {
+        path: requiredString(entry.path, `${name}.path`),
+        ...(mode !== undefined ? { mode } : {}),
+        includes: strings(entry.includes, `${name}.includes`, []),
+        excludes: strings(entry.excludes, `${name}.excludes`, []),
+        matches,
+    };
+}
+function parseJsonExpectation(value, name) {
+    const entry = object(value, name);
+    knownKeys(entry, JSON_EXPECT_KEYS, name);
+    if (entry.contains === undefined)
+        throw new Error(`${name}.contains is required`);
+    return {
+        path: requiredString(entry.path, `${name}.path`),
+        contains: object(entry.contains, `${name}.contains`),
+    };
+}
+function parseDiagnosticExpectation(value, name) {
+    const entry = object(value, name);
+    knownKeys(entry, DIAGNOSTIC_KEYS, name);
+    const maxSeverity = optionalString(entry.maxSeverity, `${name}.maxSeverity`);
+    if (maxSeverity !== undefined && !SEVERITIES.includes(maxSeverity))
+        throw new Error(`${name}.maxSeverity must be one of: ${SEVERITIES.join(", ")}`);
+    return {
+        includes: strings(entry.includes, `${name}.includes`, []),
+        excludes: strings(entry.excludes, `${name}.excludes`, []),
+        ...(maxSeverity !== undefined ? { maxSeverity: maxSeverity } : {}),
+    };
+}
+function parseDigestExpectation(value, name) {
+    const entry = object(value, name);
+    knownKeys(entry, DIGEST_KEYS, name);
+    const files = object(entry.files, `${name}.files`);
+    const digests = {};
+    for (const [file, digest] of Object.entries(files))
+        digests[file] = requiredString(digest, `${name}.files['${file}']`);
+    return {
+        ...(entry.tree !== undefined ? { tree: requiredString(entry.tree, `${name}.tree`) } : {}),
+        files: digests,
+    };
+}
+function parseExpectations(value, name) {
+    const entry = object(value, name);
+    knownKeys(entry, EXPECT_KEYS, name);
+    const paths = object(entry.paths, `${name}.paths`);
+    knownKeys(paths, PATHS_KEYS, `${name}.paths`);
+    const files = entry.files === undefined ? [] : entry.files;
+    if (!Array.isArray(files))
+        throw new Error(`${name}.files must be a list`);
+    const json = entry.json === undefined ? [] : entry.json;
+    if (!Array.isArray(json))
+        throw new Error(`${name}.json must be a list`);
+    return {
+        paths: {
+            present: strings(paths.present, `${name}.paths.present`, []),
+            absent: strings(paths.absent, `${name}.paths.absent`, []),
+        },
+        files: files.map((item, index) => parseFileExpectation(item, `${name}.files[${index}]`)),
+        json: json.map((item, index) => parseJsonExpectation(item, `${name}.json[${index}]`)),
+        ...(entry.diagnostics !== undefined
+            ? { diagnostics: parseDiagnosticExpectation(entry.diagnostics, `${name}.diagnostics`) }
+            : {}),
+        ...(entry.digest !== undefined
+            ? { digest: parseDigestExpectation(entry.digest, `${name}.digest`) }
+            : {}),
+    };
+}
+/**
+ * Parses one test file into cases.
+ *
+ * Structural problems become `AB700` findings rather than throws, so one
+ * malformed case does not hide every other case in the bundle — the same split
+ * `src/agent/parser.ts` makes between unreadable input and invalid content. A
+ * file whose YAML will not parse at all is the caller's error to raise.
+ */
+export function parseTestFile(content, file) {
+    const diagnostics = [];
+    let document;
+    try {
+        document = object(parseYaml(content) ?? {}, "Test file");
+        knownKeys(document, FILE_KEYS, "test file");
+        const schemaVersion = optionalString(document.schemaVersion, "schemaVersion");
+        if (schemaVersion === undefined)
+            throw new Error("schemaVersion is required");
+        if (schemaVersion !== TEST_FILE_SCHEMA_VERSION)
+            throw new Error(`Unsupported test schemaVersion '${schemaVersion}'; this release reads '${TEST_FILE_SCHEMA_VERSION}'`);
+        if (document.cases !== undefined && !Array.isArray(document.cases))
+            throw new Error("cases must be a list");
+    }
+    catch (error) {
+        return { cases: [], diagnostics: [invalid(`${error.message}`, file)] };
+    }
+    const cases = [];
+    const seen = new Set();
+    for (const [index, item] of (document.cases ?? []).entries()) {
+        const label = `cases[${index}]`;
+        try {
+            const entry = object(item, label);
+            knownKeys(entry, CASE_KEYS, label);
+            const name = requiredString(entry.name, `${label}.name`);
+            // Names are how --case selects and how a failure is reported, so a
+            // duplicate inside one file would make both unaddressable.
+            if (seen.has(name))
+                throw new Error(`Duplicate case name '${name}'`);
+            seen.add(name);
+            cases.push({
+                name,
+                file,
+                targets: parseTargets(entry.targets, `${label}.targets`),
+                profiles: parseProfiles(entry.profiles, `${label}.profiles`),
+                expect: parseExpectations(entry.expect, `${label}.expect`),
+            });
+        }
+        catch (error) {
+            diagnostics.push(invalid(`${label}: ${error.message}`, file));
+        }
+    }
+    return { cases, diagnostics };
+}
+function isTestFile(name) {
+    return TEST_FILE_SUFFIXES.some((suffix) => name.endsWith(suffix));
+}
+function walk(directory, results) {
+    for (const entry of fs
+        .readdirSync(directory, { withFileTypes: true })
+        // Byte comparison rather than localeCompare: discovery order decides the
+        // order cases are reported in, and an ICU-dependent sort would reorder a
+        // payload between machines.
+        .sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0))) {
+        const full = path.join(directory, entry.name);
+        if (entry.isDirectory())
+            walk(full, results);
+        else if (entry.isFile() && isTestFile(entry.name))
+            results.push(full);
+    }
+}
+/**
+ * Test files for a bundle, in a stable order.
+ *
+ * With no override this is `<bundle>/tests/**\/*.test.yaml`, a convention rather
+ * than a manifest key: that keeps schema 2 a strict superset of schema 1 and
+ * lets a v1 or legacy bundle carry tests too. An explicit `--tests` path that
+ * does not exist throws, because a typo there must not read as "no tests".
+ */
+export function discoverTestFiles(bundleRoot, override) {
+    const root = override
+        ? path.resolve(bundleRoot, override)
+        : path.join(bundleRoot, DEFAULT_TESTS_ROOT);
+    if (!fs.existsSync(root)) {
+        if (override)
+            throw new Error(`Test path does not exist: ${root}`);
+        return [];
+    }
+    if (fs.statSync(root).isFile())
+        return [root];
+    const results = [];
+    walk(root, results);
+    return results;
+}
+//# sourceMappingURL=schema.js.map

package/dist/agent/test/schema.js.map

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