@cairn-tool/cairn 2.0.0

package/dist/agent/targets/schema.js

@@ -0,0 +1,179 @@
+/**
+ * Version of the target-profile shape itself. Hand-owned; unrelated to the
+ * semantic-release-managed package version. Bump only when the profile
+ * structure changes in a way consumers must react to.
+ */
+export const PROFILE_SCHEMA_VERSION = "2";
+export const PORTABLE_HOOK_EVENTS = [
+    "session-start",
+    "pre-tool-use",
+    "post-tool-use",
+    "stop",
+];
+export const FEATURE_KEYS = [
+    "skills",
+    "agents",
+    "rules",
+    "hooks",
+    "policies",
+    "mcp",
+    "assets",
+    "placeholders",
+    "native",
+];
+function segmentToSource(segment) {
+    if (segment === "**")
+        return "(?:.+)?";
+    let source = "";
+    for (let index = 0; index < segment.length;) {
+        const char = segment[index];
+        if (char === "{") {
+            const close = segment.indexOf("}", index);
+            if (close !== -1) {
+                source += "[^/]+";
+                index = close + 1;
+                continue;
+            }
+        }
+        if (char === "*") {
+            source += "[^/]*";
+            index++;
+            continue;
+        }
+        source += char.replace(/[.+^${}()|[\]\\?]/, "\\$&");
+        index++;
+    }
+    return source;
+}
+/**
+ * Compiles an {@link OutputPattern} into an anchored regular expression.
+ * `**` is only meaningful as a whole trailing segment.
+ */
+export function outputPatternToRegExp(pattern) {
+    const source = pattern
+        .split("/")
+        .map(segmentToSource)
+        .join("/")
+        // A trailing `/**` must also match the bare directory prefix.
+        .replace(/\/\(\?:\.\+\)\?$/, "(?:/.+)?");
+    return new RegExp(`^${source}$`);
+}
+/** True when `candidate` is described by one of the target's declared output patterns. */
+export function describesPath(profile, outputProfile, candidate) {
+    return (profile.outputs[outputProfile] ?? []).some((entry) => outputPatternToRegExp(entry.pattern).test(candidate));
+}
+export function parseSemver(value) {
+    const match = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/.exec(value.trim());
+    if (!match)
+        return null;
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3]),
+        prerelease: match[4] ?? null,
+    };
+}
+/**
+ * Compares two plain versions. Deliberately not a range grammar — profiles
+ * record single bounds, so ordering is all that is needed.
+ */
+export function compareSemver(a, b) {
+    const left = parseSemver(a);
+    const right = parseSemver(b);
+    if (!left || !right)
+        throw new Error(`Invalid version: ${left ? b : a}`);
+    for (const key of ["major", "minor", "patch"]) {
+        if (left[key] !== right[key])
+            return left[key] < right[key] ? -1 : 1;
+    }
+    if (left.prerelease === right.prerelease)
+        return 0;
+    // A prerelease sorts below the matching release.
+    if (left.prerelease === null)
+        return 1;
+    if (right.prerelease === null)
+        return -1;
+    return left.prerelease < right.prerelease ? -1 : 1;
+}
+/** Returns the reasons a profile is internally inconsistent; empty when valid. */
+export function validateProfile(profile) {
+    const problems = [];
+    if (profile.schemaVersion !== PROFILE_SCHEMA_VERSION)
+        problems.push(`schemaVersion is '${profile.schemaVersion}', expected '${PROFILE_SCHEMA_VERSION}'`);
+    if (!profile.profiles.length)
+        problems.push("declares no output profiles");
+    for (const key of FEATURE_KEYS) {
+        const feature = profile.features[key];
+        if (!feature) {
+            problems.push(`missing feature declaration '${key}'`);
+            continue;
+        }
+        if (!feature.summary.trim())
+            problems.push(`feature '${key}' has an empty summary`);
+        for (const code of feature.diagnostics)
+            if (!/^AB\d{3}$/.test(code))
+                problems.push(`feature '${key}' declares malformed diagnostic code '${code}'`);
+        for (const outputProfile of feature.profiles)
+            if (!profile.profiles.includes(outputProfile))
+                problems.push(`feature '${key}' names unsupported output profile '${outputProfile}'`);
+    }
+    for (const outputProfile of profile.profiles) {
+        const patterns = profile.outputs[outputProfile];
+        if (!patterns?.length) {
+            problems.push(`output profile '${outputProfile}' declares no output patterns`);
+            continue;
+        }
+        for (const entry of patterns) {
+            if (entry.pattern.startsWith("/") || entry.pattern.includes("\\"))
+                problems.push(`output pattern '${entry.pattern}' is not a POSIX relative path`);
+            if (entry.pattern.split("/").includes(".."))
+                problems.push(`output pattern '${entry.pattern}' escapes the target root`);
+        }
+    }
+    const policyForms = [
+        "claude-permissions",
+        "codex-prefix-rules",
+        "cursor-hooks",
+        "opencode-permission",
+    ];
+    if (profile.policies.form !== null && !policyForms.includes(profile.policies.form))
+        problems.push(`policies.form '${profile.policies.form}' is not a known form`);
+    const invocationForms = ["frontmatter-flag", "openai-yaml", "advisory"];
+    if (profile.skills.invocationPolicy !== null &&
+        !invocationForms.includes(profile.skills.invocationPolicy))
+        problems.push(`skills.invocationPolicy '${profile.skills.invocationPolicy}' is not a known form`);
+    for (const event of profile.hooks.matcherEvents)
+        if (!PORTABLE_HOOK_EVENTS.includes(event))
+            problems.push(`hooks.matcherEvents names unknown event '${event}'`);
+    if (profile.hooks.handlerShape === "nested-for-matcher-events" &&
+        !profile.hooks.matcherEvents.length)
+        problems.push("hooks.handlerShape is 'nested-for-matcher-events' but matcherEvents is empty");
+    for (const version of [profile.host.minimumVersion, profile.host.verifiedThrough])
+        if (version !== null && !parseSemver(version))
+            problems.push(`host version '${version}' is not a valid semantic version`);
+    if (profile.host.minimumVersion &&
+        profile.host.verifiedThrough &&
+        compareSemver(profile.host.minimumVersion, profile.host.verifiedThrough) > 0)
+        problems.push("host minimumVersion is greater than verifiedThrough");
+    if (profile.install) {
+        for (const scope of ["user", "project"]) {
+            const location = profile.install[scope];
+            if (!location)
+                continue;
+            if (!["plugin-dir", "merge", "marketplace"].includes(location.layout))
+                problems.push(`install.${scope}.layout '${location.layout}' is not a known layout`);
+            if (!profile.profiles.includes(location.profile))
+                problems.push(`install.${scope} names unsupported output profile '${location.profile}'`);
+            if (location.root.split(/[/\\]/).includes(".."))
+                problems.push(`install.${scope}.root escapes its scope`);
+            if (location.activation) {
+                if (location.activation.form !== "claude-enabled-plugins")
+                    problems.push(`install.${scope}.activation.form is unknown`);
+                if (!location.activation.file.trim())
+                    problems.push(`install.${scope}.activation.file is empty`);
+            }
+        }
+    }
+    return problems;
+}
+//# sourceMappingURL=schema.js.map

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

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

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

@@ -0,0 +1,46 @@
+import type { AgentDiagnostic, AgentProfile, AgentTarget, Artifact } from "../types.js";
+import type { CaseExpectations } from "./schema.js";
+/** Codes every run evaluates, in the order the checks apply. */
+export declare const TEST_CHECKS: string[];
+/** One unmet expectation, for one target and profile. */
+export interface TestFailure {
+    code: string;
+    /** Which expectation failed, e.g. `paths.present` or `files[0].includes`. */
+    assertion: string;
+    message: string;
+    expected: string;
+    actual: string;
+}
+/** A rendered `<target>/<profile>` tree, with the prefix already stripped. */
+export interface RenderedTree {
+    target: AgentTarget;
+    profile: AgentProfile;
+    /** Artifacts keyed by path relative to `<target>/<profile>/`. */
+    artifacts: Artifact[];
+    diagnostics: AgentDiagnostic[];
+}
+export declare function sha256(content: Buffer): string;
+/**
+ * Golden digest over a rendered tree.
+ *
+ * The serialization is part of the command's contract — authors paste the value
+ * into a test file — so it is spelled out here and in the documentation rather
+ * than left as "whatever the hash function was fed". Artifacts are ordered by
+ * byte comparison of path, never `localeCompare`, so the value cannot depend on
+ * the ICU build of the machine that produced it.
+ */
+export declare function treeDigest(artifacts: Artifact[]): string;
+/**
+ * Recursive containment.
+ *
+ * An object matches when every expected key is present and matches; an array
+ * matches when every expected element has a counterpart somewhere in the actual
+ * array, order-independent; anything else must be strictly equal. That is what
+ * `contains` means in a test file, and it is why asserting a manifest fragment
+ * does not require restating the whole document.
+ */
+export declare function contains(actual: unknown, expected: unknown): boolean;
+/** How many individual expectations a case states, for the assertion counts. */
+export declare function countAssertions(expect: CaseExpectations): number;
+/** Every expectation of a case, evaluated against one rendered tree. */
+export declare function evaluate(expect: CaseExpectations, tree: RenderedTree): TestFailure[];

package/dist/agent/test/assert.js

@@ -0,0 +1,288 @@
+import crypto from "node:crypto";
+import { outputPatternToRegExp } from "../targets/schema.js";
+import { SEVERITIES } from "./schema.js";
+/** Codes every run evaluates, in the order the checks apply. */
+export const TEST_CHECKS = ["AB710", "AB711", "AB712", "AB713", "AB714", "AB715"];
+export function sha256(content) {
+    return crypto.createHash("sha256").update(content).digest("hex");
+}
+function byPath(a, b) {
+    return a.path < b.path ? -1 : a.path > b.path ? 1 : 0;
+}
+function octal(mode) {
+    return `0${mode.toString(8)}`;
+}
+/**
+ * Golden digest over a rendered tree.
+ *
+ * The serialization is part of the command's contract — authors paste the value
+ * into a test file — so it is spelled out here and in the documentation rather
+ * than left as "whatever the hash function was fed". Artifacts are ordered by
+ * byte comparison of path, never `localeCompare`, so the value cannot depend on
+ * the ICU build of the machine that produced it.
+ */
+export function treeDigest(artifacts) {
+    const lines = [...artifacts]
+        .sort(byPath)
+        .map((artifact) => `${artifact.path}\n${octal(artifact.mode)}\n${sha256(artifact.content)}\n`);
+    return sha256(Buffer.from(lines.join(""), "utf8"));
+}
+function sameDigest(expected, actual) {
+    return expected.trim().toLowerCase() === actual.toLowerCase();
+}
+function find(tree, file) {
+    return tree.artifacts.find((artifact) => artifact.path === file);
+}
+function matching(tree, pattern) {
+    const expression = outputPatternToRegExp(pattern);
+    return tree.artifacts.filter((artifact) => expression.test(artifact.path)).map((a) => a.path);
+}
+/**
+ * Recursive containment.
+ *
+ * An object matches when every expected key is present and matches; an array
+ * matches when every expected element has a counterpart somewhere in the actual
+ * array, order-independent; anything else must be strictly equal. That is what
+ * `contains` means in a test file, and it is why asserting a manifest fragment
+ * does not require restating the whole document.
+ */
+export function contains(actual, expected) {
+    if (Array.isArray(expected))
+        return (Array.isArray(actual) &&
+            expected.every((item) => actual.some((candidate) => contains(candidate, item))));
+    if (expected && typeof expected === "object")
+        return (Boolean(actual) &&
+            typeof actual === "object" &&
+            !Array.isArray(actual) &&
+            Object.entries(expected).every(([key, value]) => contains(actual[key], value)));
+    return actual === expected;
+}
+function severityRank(severity) {
+    return SEVERITIES.indexOf(severity);
+}
+function checkPaths(expect, tree) {
+    const failures = [];
+    for (const pattern of expect.paths.present)
+        if (!matching(tree, pattern).length)
+            failures.push({
+                code: "AB710",
+                assertion: "paths.present",
+                message: `No rendered path matches '${pattern}'`,
+                expected: pattern,
+                actual: "no match",
+            });
+    for (const pattern of expect.paths.absent) {
+        const hits = matching(tree, pattern);
+        if (hits.length)
+            failures.push({
+                code: "AB711",
+                assertion: "paths.absent",
+                message: `Rendered path '${hits[0]}' matches '${pattern}', which was expected to be absent`,
+                expected: `no match for ${pattern}`,
+                actual: hits.join(", "),
+            });
+    }
+    return failures;
+}
+function checkFiles(expect, tree) {
+    const failures = [];
+    for (const [index, expectation] of expect.files.entries()) {
+        const label = `files[${index}]`;
+        const artifact = find(tree, expectation.path);
+        if (!artifact) {
+            failures.push({
+                code: "AB712",
+                assertion: `${label}.path`,
+                message: `'${expectation.path}' was not rendered`,
+                expected: expectation.path,
+                actual: "not rendered",
+            });
+            continue;
+        }
+        if (expectation.mode !== undefined && expectation.mode !== octal(artifact.mode))
+            failures.push({
+                code: "AB712",
+                assertion: `${label}.mode`,
+                message: `'${expectation.path}' has mode ${octal(artifact.mode)}`,
+                expected: expectation.mode,
+                actual: octal(artifact.mode),
+            });
+        const text = artifact.content.toString("utf8");
+        for (const needle of expectation.includes)
+            if (!text.includes(needle))
+                failures.push({
+                    code: "AB712",
+                    assertion: `${label}.includes`,
+                    message: `'${expectation.path}' does not contain the expected text`,
+                    expected: needle,
+                    actual: "absent",
+                });
+        for (const needle of expectation.excludes)
+            if (text.includes(needle))
+                failures.push({
+                    code: "AB712",
+                    assertion: `${label}.excludes`,
+                    message: `'${expectation.path}' contains text that was expected to be absent`,
+                    expected: `absent: ${needle}`,
+                    actual: needle,
+                });
+        for (const source of expectation.matches)
+            if (!new RegExp(source).test(text))
+                failures.push({
+                    code: "AB712",
+                    assertion: `${label}.matches`,
+                    message: `'${expectation.path}' does not match the expected pattern`,
+                    expected: source,
+                    actual: "no match",
+                });
+    }
+    return failures;
+}
+function checkJson(expect, tree) {
+    const failures = [];
+    for (const [index, expectation] of expect.json.entries()) {
+        const label = `json[${index}]`;
+        const artifact = find(tree, expectation.path);
+        if (!artifact) {
+            failures.push({
+                code: "AB713",
+                assertion: `${label}.path`,
+                message: `'${expectation.path}' was not rendered`,
+                expected: expectation.path,
+                actual: "not rendered",
+            });
+            continue;
+        }
+        let document;
+        try {
+            document = JSON.parse(artifact.content.toString("utf8"));
+        }
+        catch (error) {
+            failures.push({
+                code: "AB713",
+                assertion: `${label}.path`,
+                message: `'${expectation.path}' is not valid JSON: ${error.message}`,
+                expected: "valid JSON",
+                actual: "unparsable",
+            });
+            continue;
+        }
+        for (const [key, value] of Object.entries(expectation.contains))
+            if (!contains(document?.[key], value))
+                failures.push({
+                    code: "AB713",
+                    assertion: `${label}.contains.${key}`,
+                    message: `'${expectation.path}' does not contain the expected value at '${key}'`,
+                    expected: JSON.stringify(value),
+                    actual: JSON.stringify(document?.[key] ?? null),
+                });
+    }
+    return failures;
+}
+function checkDiagnostics(expect, tree) {
+    const expectation = expect.diagnostics;
+    if (!expectation)
+        return [];
+    const failures = [];
+    const codes = new Set(tree.diagnostics.map((item) => item.code));
+    for (const code of expectation.includes)
+        if (!codes.has(code))
+            failures.push({
+                code: "AB714",
+                assertion: "diagnostics.includes",
+                message: `Diagnostic ${code} was expected but not reported`,
+                expected: code,
+                actual: "not reported",
+            });
+    for (const code of expectation.excludes)
+        if (codes.has(code))
+            failures.push({
+                code: "AB714",
+                assertion: "diagnostics.excludes",
+                message: `Diagnostic ${code} was reported but was expected to be absent`,
+                expected: `absent: ${code}`,
+                actual: code,
+            });
+    if (expectation.maxSeverity) {
+        const ceiling = severityRank(expectation.maxSeverity);
+        for (const item of tree.diagnostics)
+            if (severityRank(item.severity) > ceiling)
+                failures.push({
+                    code: "AB714",
+                    assertion: "diagnostics.maxSeverity",
+                    message: `${item.code} is ${item.severity}, above the expected ceiling`,
+                    expected: expectation.maxSeverity,
+                    actual: `${item.severity} (${item.code})`,
+                });
+    }
+    return failures;
+}
+function checkDigests(expect, tree) {
+    const expectation = expect.digest;
+    if (!expectation)
+        return [];
+    const failures = [];
+    if (expectation.tree !== undefined) {
+        const actual = treeDigest(tree.artifacts);
+        if (!sameDigest(expectation.tree, actual))
+            failures.push({
+                code: "AB715",
+                assertion: "digest.tree",
+                message: `The rendered tree digest changed`,
+                expected: expectation.tree.trim(),
+                actual,
+            });
+    }
+    for (const [file, expected] of Object.entries(expectation.files)) {
+        const artifact = find(tree, file);
+        if (!artifact) {
+            failures.push({
+                code: "AB715",
+                assertion: `digest.files['${file}']`,
+                message: `'${file}' was not rendered`,
+                expected: expected.trim(),
+                actual: "not rendered",
+            });
+            continue;
+        }
+        const actual = sha256(artifact.content);
+        if (!sameDigest(expected, actual))
+            failures.push({
+                code: "AB715",
+                assertion: `digest.files['${file}']`,
+                message: `'${file}' changed`,
+                expected: expected.trim(),
+                actual,
+            });
+    }
+    return failures;
+}
+/** How many individual expectations a case states, for the assertion counts. */
+export function countAssertions(expect) {
+    const files = expect.files.reduce((total, item) => total +
+        (item.mode === undefined ? 0 : 1) +
+        item.includes.length +
+        item.excludes.length +
+        item.matches.length, 0);
+    const json = expect.json.reduce((total, item) => total + Object.keys(item.contains).length, 0);
+    const diagnostics = expect.diagnostics
+        ? expect.diagnostics.includes.length +
+            expect.diagnostics.excludes.length +
+            (expect.diagnostics.maxSeverity ? 1 : 0)
+        : 0;
+    const digest = expect.digest
+        ? (expect.digest.tree === undefined ? 0 : 1) + Object.keys(expect.digest.files).length
+        : 0;
+    return (expect.paths.present.length + expect.paths.absent.length + files + json + diagnostics + digest);
+}
+/** Every expectation of a case, evaluated against one rendered tree. */
+export function evaluate(expect, tree) {
+    return [
+        ...checkPaths(expect, tree),
+        ...checkFiles(expect, tree),
+        ...checkJson(expect, tree),
+        ...checkDiagnostics(expect, tree),
+        ...checkDigests(expect, tree),
+    ];
+}
+//# sourceMappingURL=assert.js.map

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

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

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

@@ -0,0 +1,73 @@
+import type { AgentBundle, AgentDiagnostic, AgentProfile, AgentTarget } from "../types.js";
+import type { TestFailure } from "./assert.js";
+export * from "./assert.js";
+export * from "./schema.js";
+/** One unmet expectation, located in the tree it was evaluated against. */
+export interface TestCaseFailure extends TestFailure {
+    target: AgentTarget;
+    profile: AgentProfile;
+}
+export interface TestCaseResult {
+    name: string;
+    /** Test file the case came from, bundle-relative POSIX. */
+    file: string;
+    status: "passed" | "failed" | "skipped";
+    /** The target and profile selection actually evaluated, after every filter. */
+    targets: AgentTarget[];
+    profiles: AgentProfile[];
+    assertions: {
+        total: number;
+        passed: number;
+        failed: number;
+    };
+    failures: TestCaseFailure[];
+    /** Why a case was skipped. Present only on `skipped`. */
+    reason?: string;
+}
+export interface TestReport {
+    /** The test-file format this release reads. */
+    schemaVersion: string;
+    /** Test files loaded, bundle-relative POSIX. */
+    files: string[];
+    /**
+     * Assertion codes this run can report. Like `audit.checks`, this is what
+     * distinguishes "every expectation held" from "nothing was expected".
+     */
+    checks: string[];
+    counts: {
+        cases: number;
+        passed: number;
+        failed: number;
+        skipped: number;
+        assertions: number;
+    };
+    cases: TestCaseResult[];
+    /**
+     * Reserved for evidence from a host's own validator. Always empty: `agent
+     * test` never spawns a process, so its result does not depend on what happens
+     * to be installed. `agent specs` publishes the validator commands to run
+     * yourself.
+     */
+    native: never[];
+}
+export interface RunTestsOptions {
+    /** `--tests`: a file or directory, bundle-relative or absolute. */
+    tests?: string;
+    /** `--target`: intersected with each case's own selection. Empty means all. */
+    targets: AgentTarget[];
+    /** `--profile`: intersected with each case's own selection. */
+    profiles: AgentProfile[];
+    /** `--case`: exact names. Empty means every case. */
+    cases: string[];
+}
+/**
+ * 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 declare function runTests(bundle: AgentBundle, options: RunTestsOptions): {
+    report: TestReport;
+    diagnostics: AgentDiagnostic[];
+    forwarded: AgentDiagnostic[];
+};