@intentset/verification 0.1.0

package/dist/placeholders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholders.js","sourceRoot":"","sources":["../src/placeholders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,OAAO,EAAiB,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAE,OAAO,EAAE,CAAC;AAEnB;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,0CAA0C,CAAC;AAOzE;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAI,OAAqB,EAAE,QAA6B;IACtF,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC5B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QAC1F,MAAM,IAAI,GAA4B,EAAE,GAAI,MAAkC,EAAE,CAAC;QACjF,IAAI,IAAI,CAAC,SAAS,KAAK,OAAO;YAAE,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;QACpE,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI;YAAE,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QACvF,OAAO,IAAS,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,cAAc,CAAC,OAAkE;IAC/F,IAAI,OAAO,EAAE,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACjF,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;AAChE,CAAC"}

package/dist/records.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Run records (Core §8): evidence is a separate record from the verification
+ * definition, because runs change more often than product semantics. This
+ * module is the record's shape and its reader; spec/evidence.schema.json is
+ * the same shape for other tools, and a test holds the two in agreement.
+ *
+ * The reader accepts the literal `@current` for `commit` and `graphHash`.
+ * That is the fixture placeholder (see placeholders.ts): it is bound to the
+ * snapshot before classification, and a record still carrying it classifies
+ * as unresolved, never as current.
+ */
+import { type Diagnostic } from "@intentset/core";
+export declare const RUN_RESULTS: readonly ["pass", "fail", "skip", "error"];
+export type RunResult = (typeof RUN_RESULTS)[number];
+/** The literal a fixture writes for "the snapshot's commit" or "the snapshot's graph hash". */
+export declare const CURRENT = "@current";
+export interface RunScope {
+    /** The product's artifact ID. */
+    product: string;
+    /** The exact release label; v0.1 matches release labels exactly (Core §7). */
+    release: string;
+}
+export interface RunTool {
+    name: string;
+    version: string;
+}
+/** One run of one verification, Core §8. Members in this order on output. */
+export interface RunRecord {
+    evidenceId: string;
+    verificationId: string;
+    commit: string;
+    /** Lowercase hex SHA-256 over the canonical graph (ADR 0005), or the `@current` fixture placeholder. */
+    graphHash: string;
+    environment: string;
+    scope: RunScope;
+    /** The tool and version that ran an automated check; null for a review performed by a person alone. */
+    tool: RunTool | null;
+    /** The reviewer's identity; set exactly when the record is a manual review, which then needs a rationale. */
+    reviewer: string | null;
+    /** UTC ISO 8601 with a `Z` suffix. */
+    startedAt: string;
+    finishedAt: string;
+    result: RunResult;
+    uri: string;
+    rationale?: string;
+    /** Namespaced extensions (`org.example/key`), preserved and never interpreted. */
+    extensions?: Record<string, unknown>;
+}
+/** True for a UTC timestamp `YYYY-MM-DDTHH:MM:SS[.fraction]Z` that names a real instant. */
+export declare function isUtcTimestamp(value: unknown): value is string;
+/**
+ * A key that orders UTC timestamps exactly, fraction included: the date and
+ * time, then the fraction padded to nanoseconds. Plain string comparison of
+ * the timestamps would put `10:00:00.5Z` before `10:00:00Z`.
+ */
+export declare function timeKey(timestamp: string): string;
+/**
+ * Record order everywhere in this package: finishedAt, then evidenceId. The
+ * last is the latest. Two records agreeing on both (a repeated evidence ID the
+ * reader would have refused) fall back to their canonical JSON, so the order
+ * never depends on input order.
+ */
+export declare function compareRecords(a: RunRecord, b: RunRecord): number;
+export interface ReadRunRecords {
+    /** The well-formed records, in input order; a malformed record is dropped and reported. */
+    records: RunRecord[];
+    /** EVID001 errors, sorted by core's order. */
+    diagnostics: Diagnostic[];
+}
+/**
+ * Read run records from parsed JSON (an array of objects). Every problem is
+ * one EVID001 error with a JSON pointer into the input as its field; a record
+ * with any problem is not returned, so it can never count as evidence. Of two
+ * records with one evidence ID the first is kept and the later ones reported.
+ */
+export declare function readRunRecords(json: unknown, path: string): ReadRunRecords;
+//# sourceMappingURL=records.d.ts.map

package/dist/records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../src/records.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAiB,KAAK,UAAU,EAA+B,MAAM,iBAAiB,CAAC;AAG9F,eAAO,MAAM,WAAW,YAAI,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AACtE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,+FAA+F;AAC/F,eAAO,MAAM,OAAO,aAAa,CAAC;AAElC,MAAM,WAAW,QAAQ;IACvB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6EAA6E;AAC7E,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,wGAAwG;IACxG,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,QAAQ,CAAC;IAChB,uGAAuG;IACvG,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACrB,6GAA6G;IAC7G,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAwBD,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAQ9D;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,MAAM,CAMjE;AAED,MAAM,WAAW,cAAc;IAC7B,2FAA2F;IAC3F,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,8CAA8C;IAC9C,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAwC1E"}

package/dist/records.js

@@ -0,0 +1,354 @@
+/**
+ * Run records (Core §8): evidence is a separate record from the verification
+ * definition, because runs change more often than product semantics. This
+ * module is the record's shape and its reader; spec/evidence.schema.json is
+ * the same shape for other tools, and a test holds the two in agreement.
+ *
+ * The reader accepts the literal `@current` for `commit` and `graphHash`.
+ * That is the fixture placeholder (see placeholders.ts): it is bound to the
+ * snapshot before classification, and a record still carrying it classifies
+ * as unresolved, never as current.
+ */
+import { canonicalJson, ID_PATTERN, sortDiagnostics } from "@intentset/core";
+import { compareStrings, evidenceDiagnostic, pointerToken } from "./diagnostic.js";
+export const RUN_RESULTS = ["pass", "fail", "skip", "error"];
+/** The literal a fixture writes for "the snapshot's commit" or "the snapshot's graph hash". */
+export const CURRENT = "@current";
+const REQUIRED = [
+    "evidenceId",
+    "verificationId",
+    "commit",
+    "graphHash",
+    "environment",
+    "scope",
+    "tool",
+    "reviewer",
+    "startedAt",
+    "finishedAt",
+    "result",
+    "uri",
+];
+const KNOWN = new Set([...REQUIRED, "rationale", "extensions"]);
+const TIMESTAMP = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.(\d{1,9}))?Z$/;
+const GRAPH_HASH = /^[0-9a-f]{64}$/;
+const NO_SPACE = /^\S+$/;
+const URI = /^[A-Za-z][A-Za-z0-9+.-]*:\S+$/;
+const EXTENSION_KEY = /^[^/]+\/.+$/;
+/** True for a UTC timestamp `YYYY-MM-DDTHH:MM:SS[.fraction]Z` that names a real instant. */
+export function isUtcTimestamp(value) {
+    if (typeof value !== "string")
+        return false;
+    const match = TIMESTAMP.exec(value);
+    if (match === null)
+        return false;
+    const [year, month, day, hour, minute, second] = match.slice(1, 7).map(Number);
+    if (month < 1 || month > 12 || hour > 23 || minute > 59 || second > 59)
+        return false;
+    const days = new Date(Date.UTC(year, month, 0)).getUTCDate();
+    return day >= 1 && day <= days;
+}
+/**
+ * A key that orders UTC timestamps exactly, fraction included: the date and
+ * time, then the fraction padded to nanoseconds. Plain string comparison of
+ * the timestamps would put `10:00:00.5Z` before `10:00:00Z`.
+ */
+export function timeKey(timestamp) {
+    const match = TIMESTAMP.exec(timestamp);
+    if (match === null)
+        return timestamp;
+    return `${timestamp.slice(0, 19)}.${(match[7] ?? "").padEnd(9, "0")}`;
+}
+/**
+ * Record order everywhere in this package: finishedAt, then evidenceId. The
+ * last is the latest. Two records agreeing on both (a repeated evidence ID the
+ * reader would have refused) fall back to their canonical JSON, so the order
+ * never depends on input order.
+ */
+export function compareRecords(a, b) {
+    return (compareStrings(timeKey(a.finishedAt), timeKey(b.finishedAt)) ||
+        compareStrings(a.evidenceId, b.evidenceId) ||
+        compareStrings(canonicalJson(a), canonicalJson(b)));
+}
+/**
+ * Read run records from parsed JSON (an array of objects). Every problem is
+ * one EVID001 error with a JSON pointer into the input as its field; a record
+ * with any problem is not returned, so it can never count as evidence. Of two
+ * records with one evidence ID the first is kept and the later ones reported.
+ */
+export function readRunRecords(json, path) {
+    const diagnostics = [];
+    if (!Array.isArray(json)) {
+        diagnostics.push(evidenceDiagnostic({
+            code: "EVID001",
+            artifact: null,
+            path,
+            field: "",
+            message: `The evidence in ${path} is ${describe(json)}, not an array of run records.`,
+            remediation: "Write the run records as a JSON array of objects, one per run (Core §8).",
+        }));
+        return { records: [], diagnostics };
+    }
+    const records = [];
+    const seen = new Map();
+    json.forEach((entry, index) => {
+        const problems = [];
+        const record = readRecord(entry, index, problems);
+        if (record !== null) {
+            const first = seen.get(record.evidenceId);
+            if (first !== undefined) {
+                problems.push({
+                    field: `/${index}/evidenceId`,
+                    message: `Evidence ID ${record.evidenceId} at entry ${index} repeats entry ${first}.`,
+                    remediation: "Give every run its own evidence ID; tools never merge two records into one.",
+                });
+            }
+            else {
+                seen.set(record.evidenceId, index);
+            }
+        }
+        const artifact = verificationOf(entry);
+        for (const problem of problems) {
+            diagnostics.push(evidenceDiagnostic({ code: "EVID001", artifact, path, ...problem }));
+        }
+        if (record !== null && problems.length === 0)
+            records.push(record);
+    });
+    return { records, diagnostics: sortDiagnostics(diagnostics) };
+}
+function verificationOf(entry) {
+    if (!isRecord(entry))
+        return null;
+    const id = entry.verificationId;
+    return typeof id === "string" && ID_PATTERN.test(id) ? id : null;
+}
+function readRecord(entry, index, problems) {
+    const at = (key) => `/${index}/${pointerToken(key)}`;
+    if (!isRecord(entry)) {
+        problems.push({
+            field: `/${index}`,
+            message: `Evidence entry ${index} is ${describe(entry)}, not a run record.`,
+            remediation: "Write each run as an object with the fields Core §8 lists.",
+        });
+        return null;
+    }
+    const problem = (key, message, remediation) => problems.push({ field: at(key), message, remediation });
+    for (const key of Object.keys(entry).sort(compareStrings)) {
+        if (!KNOWN.has(key)) {
+            problem(key, `Run record ${index} has the unknown key \`${key}\`.`, "Remove it, or move it under `extensions` with a namespaced key such as `org.example/build`.");
+        }
+    }
+    for (const key of REQUIRED) {
+        if (!Object.hasOwn(entry, key)) {
+            problem(key, `Run record ${index} has no \`${key}\`.`, `Add \`${key}\`; Core §8 requires it on every run record${key === "tool" || key === "reviewer" ? ", as null when it does not apply" : ""}.`);
+        }
+    }
+    const text = (key, pattern, what, remediation) => {
+        if (!Object.hasOwn(entry, key))
+            return undefined;
+        const value = entry[key];
+        if (typeof value === "string" && pattern.test(value))
+            return value;
+        problem(key, `\`${key}\` of run record ${index} must be ${what}, but it is ${describe(value)}.`, remediation);
+        return undefined;
+    };
+    const evidenceId = text("evidenceId", NO_SPACE, "a non-empty string without spaces", "Give the run a stable evidence ID, such as the one the adapter derives.");
+    const verificationId = text("verificationId", ID_PATTERN, "a verification artifact ID", "Name the verification this run executed, such as TEST-ASMT-SCHEDULE.");
+    const commit = text("commit", NO_SPACE, "a non-empty commit identifier", "Record the source commit the run executed against.");
+    const graphHash = readGraphHash(entry, problem, index);
+    const environment = text("environment", /\S/, "a non-empty string", "Name the environment the run executed in, such as ci or pilot.");
+    const uri = text("uri", URI, "a URI with a scheme", "Link the run's report, such as https://ci.example/runs/42.");
+    const scope = readScope(entry, at, problems, index);
+    const tool = readTool(entry, at, problems, index);
+    const reviewer = readReviewer(entry, problem, index);
+    const startedAt = readTime(entry, "startedAt", problem, index);
+    const finishedAt = readTime(entry, "finishedAt", problem, index);
+    let result;
+    if (Object.hasOwn(entry, "result")) {
+        if (RUN_RESULTS.includes(entry.result))
+            result = entry.result;
+        else
+            problem("result", `\`result\` of run record ${index} must be pass, fail, skip or error, but it is ${describe(entry.result)}.`, "Record one of the four results; anything else is not evidence (Core §8).");
+    }
+    let rationale;
+    if (Object.hasOwn(entry, "rationale")) {
+        if (typeof entry.rationale === "string" && /\S/.test(entry.rationale))
+            rationale = entry.rationale;
+        else
+            problem("rationale", `\`rationale\` of run record ${index} must be a non-empty string, but it is ${describe(entry.rationale)}.`, "Say what the reviewer examined and why it supports the result, or remove the key.");
+    }
+    let extensions;
+    if (Object.hasOwn(entry, "extensions")) {
+        const value = entry.extensions;
+        if (!isRecord(value)) {
+            problem("extensions", `\`extensions\` of run record ${index} must be a mapping.`, "Write namespaced keys under `extensions`.");
+        }
+        else {
+            for (const key of Object.keys(value).sort(compareStrings)) {
+                if (!EXTENSION_KEY.test(key)) {
+                    problems.push({
+                        field: `${at("extensions")}/${pointerToken(key)}`,
+                        message: `Extension key \`${key}\` of run record ${index} is not namespaced.`,
+                        remediation: "Prefix it with a namespace you control, such as `org.example/build`.",
+                    });
+                }
+            }
+            extensions = value;
+        }
+    }
+    if (reviewer === null && Object.hasOwn(entry, "tool") && entry.tool === null) {
+        problem("tool", `Run record ${index} names neither a tool nor a reviewer, so nothing identifies who or what produced it.`, "Record the tool and version for an automated run, or the reviewer and rationale for a manual review (Core §8).");
+    }
+    if (typeof reviewer === "string" && rationale === undefined && !Object.hasOwn(entry, "rationale")) {
+        problem("rationale", `Manual run record ${index} by ${reviewer} gives no rationale.`, "Add the review rationale; a manual record must identify its reviewer and why the result holds (Core §8).");
+    }
+    if (startedAt !== undefined &&
+        finishedAt !== undefined &&
+        compareStrings(timeKey(finishedAt), timeKey(startedAt)) < 0) {
+        problem("finishedAt", `Run record ${index} finished at ${finishedAt}, before it started at ${startedAt}.`, "Record the run's real start and end in UTC; the end cannot precede the start.");
+    }
+    if (problems.length > 0)
+        return null;
+    const record = {
+        evidenceId: evidenceId,
+        verificationId: verificationId,
+        commit: commit,
+        graphHash: graphHash,
+        environment: environment,
+        scope: scope,
+        tool: tool,
+        reviewer: reviewer,
+        startedAt: startedAt,
+        finishedAt: finishedAt,
+        result: result,
+        uri: uri,
+    };
+    if (rationale !== undefined)
+        record.rationale = rationale;
+    if (extensions !== undefined)
+        record.extensions = extensions;
+    return record;
+}
+function readGraphHash(entry, problem, index) {
+    if (!Object.hasOwn(entry, "graphHash"))
+        return undefined;
+    const value = entry.graphHash;
+    if (typeof value === "string" && (GRAPH_HASH.test(value) || value === CURRENT))
+        return value;
+    problem("graphHash", `\`graphHash\` of run record ${index} must be 64 lowercase hex characters, but it is ${describe(value)}.`, "Record the graph hash of the snapshot the run assessed, as `intentset export` reports it (ADR 0005).");
+    return undefined;
+}
+function readTime(entry, key, problem, index) {
+    if (!Object.hasOwn(entry, key))
+        return undefined;
+    const value = entry[key];
+    if (isUtcTimestamp(value))
+        return value;
+    problem(key, `\`${key}\` of run record ${index} must be a UTC timestamp such as 2026-10-02T09:30:00Z, but it is ${describe(value)}.`, "Write the instant in UTC with a Z suffix; local offsets are not accepted.");
+    return undefined;
+}
+function readReviewer(entry, problem, index) {
+    if (!Object.hasOwn(entry, "reviewer"))
+        return undefined;
+    const value = entry.reviewer;
+    if (value === null)
+        return null;
+    if (typeof value === "string" && /\S/.test(value))
+        return value;
+    problem("reviewer", `\`reviewer\` of run record ${index} must be a reviewer's identity or null, but it is ${describe(value)}.`, "Name the person who performed the review, or write null for an automated run.");
+    return undefined;
+}
+function readScope(entry, at, problems, index) {
+    if (!Object.hasOwn(entry, "scope"))
+        return undefined;
+    const value = entry.scope;
+    if (!isRecord(value)) {
+        problems.push({
+            field: at("scope"),
+            message: `\`scope\` of run record ${index} must be a mapping with product and release, but it is ${describe(value)}.`,
+            remediation: "Record the exact product and release the run assessed (Core §8).",
+        });
+        return undefined;
+    }
+    let ok = true;
+    for (const key of Object.keys(value).sort(compareStrings)) {
+        if (key !== "product" && key !== "release") {
+            problems.push({
+                field: `${at("scope")}/${pointerToken(key)}`,
+                message: `\`scope\` of run record ${index} has the unknown key \`${key}\`.`,
+                remediation: "A scope names a product and a release and nothing else.",
+            });
+            ok = false;
+        }
+    }
+    if (typeof value.product !== "string" || !ID_PATTERN.test(value.product)) {
+        problems.push({
+            field: `${at("scope")}/product`,
+            message: `\`scope.product\` of run record ${index} must be a product ID, but it is ${describe(value.product)}.`,
+            remediation: "Name the product artifact, such as PRD-LANTERN.",
+        });
+        ok = false;
+    }
+    if (typeof value.release !== "string" || !/\S/.test(value.release)) {
+        problems.push({
+            field: `${at("scope")}/release`,
+            message: `\`scope.release\` of run record ${index} must be a release label, but it is ${describe(value.release)}.`,
+            remediation: "Give the exact release label the run assessed, such as pilot-1.",
+        });
+        ok = false;
+    }
+    return ok ? { product: value.product, release: value.release } : undefined;
+}
+function readTool(entry, at, problems, index) {
+    if (!Object.hasOwn(entry, "tool"))
+        return undefined;
+    const value = entry.tool;
+    if (value === null)
+        return null;
+    if (!isRecord(value)) {
+        problems.push({
+            field: at("tool"),
+            message: `\`tool\` of run record ${index} must be a mapping with name and version, or null, but it is ${describe(value)}.`,
+            remediation: "Record the tool that ran the check and its version, such as node:test and v24.15.0.",
+        });
+        return undefined;
+    }
+    let ok = true;
+    for (const key of Object.keys(value).sort(compareStrings)) {
+        if (key !== "name" && key !== "version") {
+            problems.push({
+                field: `${at("tool")}/${pointerToken(key)}`,
+                message: `\`tool\` of run record ${index} has the unknown key \`${key}\`.`,
+                remediation: "A tool is a name and a version and nothing else.",
+            });
+            ok = false;
+        }
+    }
+    for (const key of ["name", "version"]) {
+        if (typeof value[key] !== "string" || !/\S/.test(value[key])) {
+            problems.push({
+                field: `${at("tool")}/${key}`,
+                message: `\`tool.${key}\` of run record ${index} must be a non-empty string, but it is ${describe(value[key])}.`,
+                remediation: `Record the tool's ${key}.`,
+            });
+            ok = false;
+        }
+    }
+    return ok ? { name: value.name, version: value.version } : undefined;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function describe(value) {
+    if (value === undefined)
+        return "absent";
+    if (value === null)
+        return "null";
+    if (Array.isArray(value))
+        return "an array";
+    if (typeof value === "string")
+        return value === "" ? "an empty string" : JSON.stringify(value.length > 40 ? `${value.slice(0, 40)}…` : value);
+    if (typeof value === "object")
+        return "a mapping";
+    return `the ${typeof value} ${String(value)}`;
+}
+//# sourceMappingURL=records.js.map

package/dist/records.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@intentset/verification",
+  "version": "0.1.0",
+  "description": "Run records, evidence freshness classification, and test-reporter adapters.",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=22.18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intentset/intentset.git",
+    "directory": "packages/verification"
+  },
+  "homepage": "https://intentset.org/",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "exports": {
+    ".": {
+      "intentset-source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@intentset/core": "^0.1.0"
+  }
+}

package/src/adapters/common.ts

@@ -0,0 +1,139 @@
+/**
+ * From a test runner's results to run records. A verification's `selector`
+ * is matched against each test's full title; no test API is invented for it
+ * (no `describe.behavior`). The parsers in node-test.ts and vitest.ts reduce
+ * their runner's output to `ParsedRun`, and `toRunRecords` does the rest.
+ */
+import { sha256Hex } from "@intentset/core";
+import { compareStrings } from "../diagnostic.ts";
+import { readRunRecords, type RunRecord, type RunResult, type RunScope, type RunTool } from "../records.ts";
+
+export interface ParsedTest {
+  /** Ancestor titles and the test's own, joined with " > " (Vitest's own `fullName` when it gives one). */
+  fullName: string;
+  result: RunResult;
+  durationMs: number | null;
+}
+
+export interface ParsedRun {
+  tests: ParsedTest[];
+  /** Failures the output reports but no test title carries, such as a file that failed to load. */
+  problems: string[];
+}
+
+export interface ToRunRecordsOptions {
+  /** Selector -> verification ID, from the graph's automated verifications. */
+  verifications: ReadonlyMap<string, string>;
+  commit: string;
+  graphHash: string;
+  environment: string;
+  scope: RunScope;
+  tool: RunTool;
+  /** UTC timestamps of the whole run. */
+  startedAt: string;
+  finishedAt: string;
+  /** Where the run's report lives; each record's uri is this plus `#` and the verification ID. */
+  uriBase: string;
+}
+
+export interface ConvertedRun {
+  /** One record per verification at least one test matched, by verification ID. */
+  records: RunRecord[];
+  /** Selectors no test matched, sorted: their verifications get no record from this run, and read as missing. */
+  unmatched: string[];
+}
+
+const SEVERITY: Record<RunResult, number> = { pass: 0, skip: 1, error: 2, fail: 3 };
+const WORD = /[A-Za-z0-9_-]/;
+
+/**
+ * A selector matches a title when it occurs in it as a whole token: the
+ * characters either side are not letters, digits, `_` or `-`. So
+ * `schedule-review-v1` matches `schedule [schedule-review-v1] accepts` and a
+ * title holding the bracketed tag, but `review-v1` does not match it.
+ */
+export function selectorMatches(selector: string, title: string): boolean {
+  if (selector === "") return false;
+  const startsWord = WORD.test(selector[0]);
+  const endsWord = WORD.test(selector[selector.length - 1]);
+  for (let at = title.indexOf(selector); at !== -1; at = title.indexOf(selector, at + 1)) {
+    const before = at === 0 ? "" : title[at - 1];
+    const after = title[at + selector.length] ?? "";
+    if ((!startsWord || before === "" || !WORD.test(before)) && (!endsWord || after === "" || !WORD.test(after))) {
+      return true;
+    }
+  }
+  return false;
+}
+
+/** `EV-` and the first 16 hex digits of SHA-256 over the verification ID, commit, graph hash and end time, newline-joined. */
+export function deriveEvidenceId(
+  verificationId: string,
+  commit: string,
+  graphHash: string,
+  finishedAt: string,
+): string {
+  return `EV-${sha256Hex([verificationId, commit, graphHash, finishedAt].join("\n")).slice(0, 16)}`;
+}
+
+/** The worse of two results: fail, then error, then skip, then pass. */
+export function worst(a: RunResult, b: RunResult): RunResult {
+  return SEVERITY[a] >= SEVERITY[b] ? a : b;
+}
+
+/**
+ * One run record per verification whose selector matched at least one test.
+ * Several matching tests make one record with the worst result and a
+ * rationale that counts them. Throws when the options would make a malformed
+ * record, since that is a caller's mistake rather than evidence.
+ */
+export function toRunRecords(parsed: ParsedRun, options: ToRunRecordsOptions): ConvertedRun {
+  const matched = new Map<string, { selectors: Set<string>; tests: Set<number> }>();
+  const unmatched: string[] = [];
+  for (const selector of [...options.verifications.keys()].sort(compareStrings)) {
+    const verificationId = options.verifications.get(selector) as string;
+    const hits = parsed.tests.flatMap((test, index) => (selectorMatches(selector, test.fullName) ? [index] : []));
+    if (hits.length === 0) {
+      unmatched.push(selector);
+      continue;
+    }
+    const entry = matched.get(verificationId) ?? { selectors: new Set<string>(), tests: new Set<number>() };
+    entry.selectors.add(selector);
+    for (const hit of hits) entry.tests.add(hit);
+    matched.set(verificationId, entry);
+  }
+
+  const records: RunRecord[] = [];
+  for (const verificationId of [...matched.keys()].sort(compareStrings)) {
+    const { selectors, tests } = matched.get(verificationId) as { selectors: Set<string>; tests: Set<number> };
+    const results = [...tests].sort((a, b) => a - b).map((index) => parsed.tests[index].result);
+    const result = results.reduce(worst, "pass" as RunResult);
+    const counts = (["pass", "fail", "error", "skip"] as const)
+      .map((r) => [r, results.filter((x) => x === r).length] as const)
+      .filter(([, n]) => n > 0)
+      .map(([r, n]) => `${n} ${r}`)
+      .join(", ");
+    const names = [...selectors].sort(compareStrings).join(", ");
+    records.push({
+      evidenceId: deriveEvidenceId(verificationId, options.commit, options.graphHash, options.finishedAt),
+      verificationId,
+      commit: options.commit,
+      graphHash: options.graphHash,
+      environment: options.environment,
+      scope: { product: options.scope.product, release: options.scope.release },
+      tool: { name: options.tool.name, version: options.tool.version },
+      reviewer: null,
+      startedAt: options.startedAt,
+      finishedAt: options.finishedAt,
+      result,
+      uri: `${options.uriBase}#${encodeURIComponent(verificationId)}`,
+      rationale: `${results.length} test${results.length === 1 ? "" : "s"} matched ${names}: ${counts}.`,
+    });
+  }
+
+  const check = readRunRecords(records, "adapter output");
+  if (check.diagnostics.length > 0) {
+    throw new Error(`toRunRecords was given options that make malformed records: ${check.diagnostics[0].message}`);
+  }
+  return { records, unmatched };
+}