@agent-teams/docs-protocol 0.1.4 → 0.2.0

package/dist/qualification/qualification-runtime.js

@@ -0,0 +1,160 @@
+import { createHash } from "node:crypto";
+import { lstat, mkdir, readFile, realpath, symlink, writeFile } from "node:fs/promises";
+import { dirname, join, relative, resolve as resolvePath, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+import { planDocumentationDocumentV2 } from "@agent-teams/engineering-foundation/document-authoring";
+import { NodeDocsAdoptionInspector } from "../adapters/node-adoption-inspector.js";
+import { NodeCodeAnchorMatcher } from "../adapters/node-code-anchor-matcher.js";
+import { NodeFoundationDocsPort } from "../adapters/foundation-docs-port.js";
+import { NodeDocsProfileReader } from "../adapters/node-profile-reader.js";
+import { DocsProtocol } from "../application/docs-protocol.js";
+import { normalizeCodeAnchors, normalizeDocumentIds } from "../domain/document-semantics.js";
+import { crashAtDurablePublishing } from "./crash-driver.js";
+const MAX_QUALIFICATION_AUTHORITY_BYTES = 8 * 1024 * 1024;
+export function digest(value) {
+    return `sha256:${createHash("sha256").update(value).digest("hex")}`;
+}
+export async function readContainedBoundedFile(root, repositoryPath, label, maximumBytes = MAX_QUALIFICATION_AUTHORITY_BYTES) {
+    if (repositoryPath.startsWith("/") || repositoryPath.split("/").some((segment) => segment === "" || segment === "." || segment === "..")) {
+        throw new Error(`${label} must be one canonical repository-relative path.`);
+    }
+    const absolute = resolvePath(root, repositoryPath);
+    const relativePath = relative(root, absolute);
+    if (relativePath === ".." || relativePath.startsWith(`..${sep}`)) {
+        throw new Error(`${label} escapes the consumer root.`);
+    }
+    const metadata = await lstat(absolute);
+    if (!metadata.isFile() || metadata.isSymbolicLink() || metadata.size > maximumBytes) {
+        throw new Error(`${label} must be one bounded regular file.`);
+    }
+    const physical = await realpath(absolute);
+    if (physical !== absolute) {
+        throw new Error(`${label} must not traverse a symlink.`);
+    }
+    const bytes = await readFile(physical);
+    if (bytes.byteLength !== metadata.size || bytes.byteLength > maximumBytes) {
+        throw new Error(`${label} changed during its bounded read.`);
+    }
+    return Object.freeze({ bytes, digest: digest(bytes), path: repositoryPath });
+}
+export async function bootstrapQualificationInstallation(consumerRoot, rewriteManifest) {
+    const docsManifestPath = fileURLToPath(new URL("../../package.json", import.meta.url));
+    const foundationManifestPath = fileURLToPath(import.meta.resolve("@agent-teams/engineering-foundation/package.json"));
+    const [docsManifest, foundationManifest, consumerManifest] = await Promise.all([
+        readFile(docsManifestPath, "utf8").then((source) => JSON.parse(source)),
+        readFile(foundationManifestPath, "utf8").then((source) => JSON.parse(source)),
+        readFile(join(consumerRoot, "package.json"), "utf8").then((source) => JSON.parse(source))
+    ]);
+    if (rewriteManifest) {
+        await writeFile(join(consumerRoot, "package.json"), `${JSON.stringify({
+            ...consumerManifest,
+            devDependencies: {
+                ...((typeof consumerManifest["devDependencies"] === "object" && consumerManifest["devDependencies"] !== null)
+                    ? consumerManifest["devDependencies"]
+                    : {}),
+                "@agent-teams/docs-protocol": docsManifest.version,
+                "@agent-teams/engineering-foundation": foundationManifest.version
+            }
+        }, null, 2)}\n`, "utf8");
+    }
+    const scope = join(consumerRoot, "node_modules", "@agent-teams");
+    await mkdir(scope, { recursive: true });
+    await Promise.all([
+        symlink(dirname(docsManifestPath), join(scope, "docs-protocol"), process.platform === "win32" ? "junction" : "dir"),
+        symlink(dirname(foundationManifestPath), join(scope, "engineering-foundation"), process.platform === "win32" ? "junction" : "dir")
+    ]);
+    await writeFile(join(consumerRoot, ".agent-teams-document-authoring-qualification-fixture.json"), `${JSON.stringify({
+        schemaVersion: 1,
+        kind: "agent-teams-document-authoring-qualification-fixture",
+        consumerRoot: await realpath(consumerRoot)
+    })}\n`, "utf8");
+    return Object.freeze({ docsVersion: docsManifest.version, foundationVersion: foundationManifest.version });
+}
+export function requireSuccess(label, execution) {
+    if (execution.exitCode !== 0) {
+        throw new Error(`Docs Protocol qualification ${label} failed with exit code ${execution.exitCode}: ${JSON.stringify(execution.envelope ?? {})}.`);
+    }
+}
+export function documentResult(execution) {
+    requireSuccess("document", execution);
+    const result = execution.envelope.result;
+    if (typeof result["documentPath"] !== "string" || typeof result["planDigest"] !== "string" || !("reachability" in result)) {
+        throw new Error("Docs Protocol qualification expected a successful document result.");
+    }
+    return {
+        documentPath: result["documentPath"],
+        planDigest: result["planDigest"],
+        ...((typeof result["compiled"] === "object" && result["compiled"] !== null) ? { compiled: result["compiled"] } : {}),
+        ...(typeof result["receiptDigest"] === "string" ? { receiptDigest: result["receiptDigest"] } : {}),
+        reachability: result["reachability"]
+    };
+}
+export function createProtocol() {
+    return new DocsProtocol({
+        adoption: new NodeDocsAdoptionInspector(),
+        anchors: new NodeCodeAnchorMatcher(),
+        foundation: new NodeFoundationDocsPort(),
+        profiles: new NodeDocsProfileReader()
+    });
+}
+function qualificationMetadata(base, blockedBy, codeAnchors) {
+    return {
+        ...base.additionalMetadata,
+        ...(blockedBy.length === 0 ? {} : { blocked_by: blockedBy }),
+        ...(codeAnchors.length === 0
+            ? {}
+            : { code_anchors: codeAnchors.map(({ enforcement, pattern }) => ({ enforcement, pattern })) })
+    };
+}
+export function signalOption(signal) {
+    return signal === undefined ? {} : { signal };
+}
+export async function interruptAndRecover(input) {
+    const profile = await new NodeDocsProfileReader().read({
+        consumerRoot: input.consumerRoot,
+        profilePath: input.profilePath,
+        ...signalOption(input.base.signal)
+    });
+    const blockedBy = normalizeDocumentIds(input.base.blockedBy ?? [], "blocked_by");
+    const related = normalizeDocumentIds([...(input.base.related ?? []), ...blockedBy], "related");
+    const codeAnchors = normalizeCodeAnchors(input.base.codeAnchors ?? []);
+    const additionalMetadata = qualificationMetadata(input.base, blockedBy, codeAnchors);
+    const crashPlan = await planDocumentationDocumentV2({
+        consumerRoot: input.consumerRoot,
+        profilePath: profile.foundationProfile.path,
+        parentPolicy: "create-missing-real-directories",
+        intent: {
+            schemaVersion: 1,
+            ...input.base.intent,
+            ...(related.length === 0 ? {} : { related }),
+            ...(Object.keys(additionalMetadata).length === 0 ? {} : { additionalMetadata })
+        },
+        ...signalOption(input.base.signal)
+    });
+    if (crashPlan.destination !== input.previewResult.documentPath || crashPlan.planDigest !== input.previewResult.planDigest) {
+        throw new Error("Qualification crash Plan differs from the unified Docs Protocol preview.");
+    }
+    await crashAtDurablePublishing(input.consumerRoot, crashPlan, input.base.signal);
+    const interruptedDoctor = await input.protocol.doctorV2({
+        consumerRoot: input.consumerRoot,
+        profilePath: input.profilePath,
+        ...signalOption(input.base.signal)
+    });
+    if (interruptedDoctor.exitCode !== 1 || interruptedDoctor.envelope.outcome !== "recovery-required" ||
+        interruptedDoctor.envelope.result.transaction.state !== "recoverable") {
+        throw new Error("Qualification doctor did not observe its genuine interrupted transaction.");
+    }
+    const recovered = await input.protocol.recoverV2({
+        consumerRoot: input.consumerRoot,
+        profilePath: input.profilePath,
+        ...signalOption(input.base.signal)
+    });
+    requireSuccess("recover", recovered);
+    if (recovered.envelope.result.transactionState !== "recovered" || recovered.envelope.result.writeState !== "committed" ||
+        typeof recovered.envelope.result.receiptDigest !== "string" || recovered.envelope.result.receipt.outcome !== "applied" ||
+        recovered.envelope.result.receipt.commit.state !== "committed" || recovered.envelope.result.receipt.commit.publication !== "published") {
+        throw new Error("Qualification recovery did not return truthful committed Receipt evidence.");
+    }
+    return recovered.envelope.result;
+}
+//# sourceMappingURL=qualification-runtime.js.map

package/dist/qualification/qualification-runtime.js.map

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

package/dist/qualification/qualification-v2-runner.d.ts

@@ -0,0 +1,4 @@
+import type { DocsProtocolQualificationReceiptV2, DocsProtocolQualificationV2Request } from "./v2-contract.js";
+export declare function overlayLocalDevelopmentSkill(consumerRoot: string, skillPath: string, enabled: boolean): Promise<void>;
+export declare function runDocsProtocolQualificationV2(request: DocsProtocolQualificationV2Request): Promise<DocsProtocolQualificationReceiptV2>;
+//# sourceMappingURL=qualification-v2-runner.d.ts.map

package/dist/qualification/qualification-v2-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualification-v2-runner.d.ts","sourceRoot":"","sources":["../../src/qualification/qualification-v2-runner.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAEV,kCAAkC,EAElC,kCAAkC,EACnC,MAAM,kBAAkB,CAAC;AAgE1B,wBAAsB,4BAA4B,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B3H;AAoJD,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,kCAAkC,CAAC,CAyG7C"}

package/dist/qualification/qualification-v2-runner.js

@@ -0,0 +1,306 @@
+import { constants } from "node:fs";
+import { cp, lstat, mkdtemp, open, readFile, realpath, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join, relative, resolve as resolvePath, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+import { Ajv2020 } from "ajv/dist/2020.js";
+import { assertConsumerIntegrationProfileSchema } from "../consumer-integration/adapters/consumer-integration-schema-validator.js";
+import { checkConsumerIntegration } from "../consumer-integration/index.js";
+import { applyReachability, changedPaths, fileSnapshot, isQualificationEvidenceExcludedPath, qualificationEvidencePolicy, snapshot } from "./filesystem-evidence.js";
+import { bootstrapQualificationInstallation, createProtocol, digest, documentResult, interruptAndRecover, readContainedBoundedFile, requireSuccess, signalOption } from "./qualification-runtime.js";
+function canonicalJson(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map(canonicalJson).join(",")}]`;
+    }
+    if (value !== null && typeof value === "object") {
+        return `{${Object.entries(value).toSorted(([left], [right]) => Buffer.compare(Buffer.from(left), Buffer.from(right)))
+            .map(([key, entry]) => `${JSON.stringify(key)}:${canonicalJson(entry)}`).join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+async function readQualificationContractV2(root, path) {
+    const source = await readContainedBoundedFile(root, path, "Qualification contract");
+    const value = JSON.parse(source.bytes.toString("utf8"));
+    if (value.schemaVersion === 1) {
+        throw new Error("DOCS_QUALIFICATION_V1_MIGRATION_REQUIRED: replace fixtureRoot/tests/pins/paths/gate with schemaVersion 2 scenarios; managed integration owns package and route authority.");
+    }
+    const schema = JSON.parse(await readFile(new URL("../../schemas/docs-protocol-qualification/v2.schema.json", import.meta.url), "utf8"));
+    const validate = new Ajv2020({ allErrors: true, strict: true }).compile(schema);
+    if (!validate(value)) {
+        const details = (validate.errors ?? []).slice(0, 8).map(({ instancePath, message }) => `${instancePath || "/"} ${message ?? "is invalid"}`).join("; ");
+        throw new TypeError(`docs-protocol-qualification/v2 validation failed: ${details}`);
+    }
+    return Object.freeze({
+        contract: value,
+        evidence: Object.freeze({ path: source.path, digest: source.digest })
+    });
+}
+async function copyDisposableConsumer(sourceRoot, consumerRoot, policy) {
+    await cp(sourceRoot, consumerRoot, {
+        recursive: true,
+        errorOnExist: true,
+        force: false,
+        dereference: false,
+        async filter(source) {
+            const repositoryPath = relative(sourceRoot, source).split(sep).join("/");
+            if (repositoryPath === "") {
+                return true;
+            }
+            const metadata = await lstat(source);
+            const entryKind = metadata.isDirectory() ? "directory"
+                : metadata.isFile() ? "file"
+                    : metadata.isSymbolicLink() ? "symbolic-link"
+                        : "other";
+            return !await isQualificationEvidenceExcludedPath(sourceRoot, repositoryPath, policy, "source", entryKind);
+        }
+    });
+}
+export async function overlayLocalDevelopmentSkill(consumerRoot, skillPath, enabled) {
+    if (!enabled) {
+        return;
+    }
+    const target = join(consumerRoot, skillPath);
+    const canonicalSkill = await readFile(new URL("../../skills/docs/SKILL.md", import.meta.url));
+    let handle;
+    try {
+        handle = await open(target, constants.O_WRONLY |
+            (process.platform === "win32" ? 0 : constants.O_NOFOLLOW));
+        const [opened, named] = await Promise.all([
+            handle.stat({ bigint: true }),
+            lstat(target, { bigint: true })
+        ]);
+        if (!opened.isFile() || opened.nlink !== 1n || !named.isFile() || named.isSymbolicLink() ||
+            opened.dev !== named.dev || opened.ino !== named.ino || opened.birthtimeNs !== named.birthtimeNs) {
+            throw new Error("unsafe Skill target");
+        }
+        await handle.truncate(0);
+        await handle.writeFile(canonicalSkill);
+        const written = await handle.stat({ bigint: true });
+        if (!written.isFile() || written.nlink !== 1n || written.dev !== opened.dev || written.ino !== opened.ino ||
+            written.birthtimeNs !== opened.birthtimeNs || written.size !== BigInt(canonicalSkill.byteLength)) {
+            throw new Error("unstable Skill target");
+        }
+    }
+    catch (cause) {
+        throw new Error("Local-development qualification Skill target must be one stable, non-hardlinked regular file.", { cause });
+    }
+    finally {
+        await handle?.close();
+    }
+}
+function scenarioRequest(scenario, consumerRoot, profilePath, signal) {
+    return {
+        consumerRoot,
+        profilePath,
+        intent: {
+            type: scenario.type,
+            id: scenario.intent.id,
+            title: scenario.intent.title,
+            owner: scenario.intent.owner,
+            summary: scenario.intent.summary,
+            ...(scenario.intent.slug === undefined ? {} : { slug: scenario.intent.slug }),
+            ...(scenario.intent.destination === undefined ? {} : { destination: scenario.intent.destination })
+        },
+        ...(scenario.intent.related === undefined ? {} : { related: scenario.intent.related }),
+        ...(scenario.intent.blockedBy === undefined ? {} : { blockedBy: scenario.intent.blockedBy }),
+        ...(scenario.intent.codeAnchors === undefined ? {} : { codeAnchors: scenario.intent.codeAnchors }),
+        ...(scenario.intent.metadata === undefined ? {} : { additionalMetadata: scenario.intent.metadata }),
+        ...(signal === undefined ? {} : { signal })
+    };
+}
+function assertExpectedScenario(scenario, result) {
+    if (result.documentPath !== scenario.expected.documentPath) {
+        throw new Error(`Qualification scenario ${scenario.id} path mismatch: ${result.documentPath}.`);
+    }
+    if (canonicalJson(result.reachability) !== canonicalJson(scenario.expected.reachability)) {
+        throw new Error(`Qualification scenario ${scenario.id} reachability mismatch.`);
+    }
+    if (scenario.expected.goldenDigest !== undefined && result.compiled.document.digest !== scenario.expected.goldenDigest) {
+        throw new Error(`Qualification scenario ${scenario.id} golden digest mismatch.`);
+    }
+}
+function assertScenarioCoverage(contract, declaredTypes) {
+    const scenarioTypes = contract.scenarios.map(({ type }) => type);
+    if (new Set(contract.scenarios.map(({ id }) => id)).size !== contract.scenarios.length ||
+        new Set(scenarioTypes).size !== scenarioTypes.length || canonicalJson(scenarioTypes.toSorted()) !== canonicalJson(declaredTypes.toSorted())) {
+        throw new Error(`Qualification scenarios must cover every authorable type exactly once; expected ${declaredTypes.join(", ")}.`);
+    }
+}
+async function assertManagedIntegrationAuthority(integration) {
+    await assertConsumerIntegrationProfileSchema(integration);
+    if (integration.schemaVersion !== 2 || integration.qualification === undefined) {
+        throw new Error("DOCS_QUALIFICATION_V1_MIGRATION_REQUIRED: managed integration schemaVersion 2 with qualification authority is required.");
+    }
+}
+async function assertReleasedIntegrationCurrent(sourceRoot, integrationPath) {
+    const managed = await checkConsumerIntegration({
+        consumerRoot: sourceRoot,
+        integrationProfilePath: integrationPath
+    });
+    if (managed.outcome !== "current") {
+        throw new Error(`Released-cohort qualification requires a current exact managed integration: ${JSON.stringify(managed.issues)}.`);
+    }
+}
+async function qualifyScenarios(input) {
+    const receipts = [];
+    for (const [index, scenario] of input.contract.scenarios.entries()) {
+        const scenarioBase = scenarioRequest(scenario, input.base.consumerRoot, input.base.profilePath, input.base.signal);
+        const beforePreview = await fileSnapshot(input.base.consumerRoot, input.evidencePolicy);
+        const preview = await input.protocol.newDocumentV2({ ...scenarioBase, apply: false });
+        const previewResult = documentResult(preview);
+        if (changedPaths(beforePreview, await fileSnapshot(input.base.consumerRoot, input.evidencePolicy)).length !== 0) {
+            throw new Error(`Qualification scenario ${scenario.id} preview mutated the disposable consumer.`);
+        }
+        assertExpectedScenario(scenario, previewResult);
+        if (scenario.expected.goldenFile !== undefined) {
+            const golden = await readContainedBoundedFile(input.base.consumerRoot, scenario.expected.goldenFile, `Qualification scenario ${scenario.id} golden file`);
+            if (golden.bytes.toString("utf8") !== previewResult.compiled.document.content) {
+                throw new Error(`Qualification scenario ${scenario.id} golden file mismatch.`);
+            }
+        }
+        if (index === 0) {
+            await interruptAndRecover({
+                base: scenarioBase,
+                consumerRoot: input.base.consumerRoot,
+                previewResult,
+                profilePath: input.base.profilePath,
+                protocol: input.protocol
+            });
+        }
+        else {
+            const applied = await input.protocol.newDocumentV2({ ...scenarioBase, apply: true });
+            const appliedResult = documentResult(applied);
+            if (appliedResult.planDigest !== previewResult.planDigest || appliedResult.compiled.document.content !== previewResult.compiled.document.content) {
+                throw new Error(`Qualification scenario ${scenario.id} preview/apply parity mismatch.`);
+            }
+        }
+        const actual = await readFile(join(input.base.consumerRoot, previewResult.documentPath), "utf8");
+        if (actual !== previewResult.compiled.document.content) {
+            throw new Error(`Qualification scenario ${scenario.id} materialized bytes differ from preview.`);
+        }
+        await applyReachability(input.base.consumerRoot, previewResult.reachability);
+        requireSuccess(`check after ${scenario.id}`, await input.protocol.checkV2(input.base));
+        receipts.push({
+            id: scenario.id,
+            type: scenario.type,
+            documentPath: previewResult.documentPath,
+            outputDigest: previewResult.compiled.document.digest
+        });
+    }
+    return Object.freeze(receipts.map((receipt) => Object.freeze(receipt)));
+}
+async function collectEvidence(input) {
+    const [profile, skill, packageManifest, lockfile, executingModule] = await Promise.all([
+        readContainedBoundedFile(input.consumerRoot, input.integration.profilePath, "Docs Protocol profile"),
+        readContainedBoundedFile(input.consumerRoot, input.integration.skillPath, "Documentation Skill"),
+        readContainedBoundedFile(input.consumerRoot, "package.json", "Package manifest"),
+        readContainedBoundedFile(input.consumerRoot, "pnpm-lock.yaml", "pnpm lockfile", 64 * 1024 * 1024),
+        readFile(fileURLToPath(import.meta.url))
+    ]);
+    return {
+        executingModule,
+        lockfileDigest: lockfile.digest,
+        packageManifestDigest: packageManifest.digest,
+        profile: { path: profile.path, digest: profile.digest },
+        skill: { path: skill.path, digest: skill.digest }
+    };
+}
+export async function runDocsProtocolQualificationV2(request) {
+    const sourceRoot = await realpath(resolvePath(request.consumerRoot));
+    const integrationPath = request.integrationPath ?? "architecture/foundation/docs-consumer-integration.json";
+    const integrationFile = await readContainedBoundedFile(sourceRoot, integrationPath, "Managed integration profile");
+    const integration = JSON.parse(integrationFile.bytes.toString("utf8"));
+    await assertManagedIntegrationAuthority(integration);
+    const qualifiedIntegration = integration;
+    const evidencePolicy = qualificationEvidencePolicy(qualifiedIntegration.governedDocsRoots ?? []);
+    const before = await snapshot(sourceRoot, evidencePolicy);
+    const qualification = await readQualificationContractV2(sourceRoot, qualifiedIntegration.qualification.contractPath);
+    if (request.localDevelopment !== true) {
+        await assertReleasedIntegrationCurrent(sourceRoot, integrationPath);
+    }
+    const temporary = await realpath(await mkdtemp(join(tmpdir(), "atd-q2-")));
+    const consumerRoot = join(temporary, "consumer");
+    try {
+        request.signal?.throwIfAborted();
+        await copyDisposableConsumer(sourceRoot, consumerRoot, evidencePolicy);
+        const executingPackages = await bootstrapQualificationInstallation(consumerRoot, request.localDevelopment === true);
+        await overlayLocalDevelopmentSkill(consumerRoot, qualifiedIntegration.skillPath, request.localDevelopment === true);
+        const manifest = JSON.parse(await readFile(join(consumerRoot, "package.json"), "utf8"));
+        if (typeof manifest.scripts?.["docs:protocol:check"] !== "string") {
+            throw new Error(`Managed qualification gate ${qualifiedIntegration.qualification.gateCommand} must resolve to a package script; it is never executed by qualification.`);
+        }
+        const protocol = createProtocol();
+        const base = { consumerRoot, profilePath: qualifiedIntegration.profilePath, ...signalOption(request.signal) };
+        const info = await protocol.infoV2(base);
+        requireSuccess("info", info);
+        const infoResult = info.envelope.result;
+        assertScenarioCoverage(qualification.contract, infoResult.types.map(({ type }) => type));
+        requireSuccess("find", await protocol.findV2({ ...base, query: {} }));
+        requireSuccess("check", await protocol.checkV2(base));
+        const initialDoctor = await protocol.doctorV2(base);
+        requireSuccess("doctor", initialDoctor);
+        const idleRecovery = await protocol.recoverV2(base);
+        requireSuccess("recover", idleRecovery);
+        if (idleRecovery.envelope.result.transactionState !== "no-pending-transaction") {
+            throw new Error("Qualification recover did not prove the initial idle state.");
+        }
+        const receipts = await qualifyScenarios({ base, contract: qualification.contract, evidencePolicy, protocol });
+        requireSuccess("doctor", await protocol.doctorV2(base));
+        requireSuccess("recover", await protocol.recoverV2(base));
+        if (await snapshot(sourceRoot, evidencePolicy) !== before) {
+            throw new Error("Qualification modified its source consumer.");
+        }
+        const evidence = await collectEvidence({
+            consumerRoot,
+            integration: qualifiedIntegration
+        });
+        const environment = initialDoctor.envelope.result.environment;
+        if (request.localDevelopment !== true && (executingPackages.docsVersion !== qualifiedIntegration.cohort.packages.docsProtocol.version ||
+            executingPackages.foundationVersion !== qualifiedIntegration.cohort.packages.engineeringFoundation.version ||
+            environment.installedFoundationVersion !== qualifiedIntegration.cohort.packages.engineeringFoundation.version)) {
+            throw new Error("Released-cohort qualification execution identity does not match the exact cohort package versions.");
+        }
+        const hasGolden = qualification.contract.scenarios.some(({ expected }) => expected.goldenFile !== undefined || expected.goldenDigest !== undefined);
+        const body = Object.freeze({
+            schemaVersion: 2,
+            cohortAdmissible: request.localDevelopment !== true,
+            evidenceClass: request.localDevelopment === true ? "local-development" : "released-cohort",
+            projectId: infoResult.projectId,
+            scenarios: receipts,
+            checks: Object.freeze([
+                "info", "find", "check", "doctor", "recover", "preview", "apply", "path", "reachability",
+                ...(hasGolden ? ["golden"] : []),
+                "source-unchanged"
+            ]),
+            derived: Object.freeze({
+                contractPath: qualifiedIntegration.qualification.contractPath,
+                gateCommand: qualifiedIntegration.qualification.gateCommand,
+                packageVersions: Object.freeze({
+                    docsProtocol: qualifiedIntegration.cohort.packages.docsProtocol.version,
+                    engineeringFoundation: qualifiedIntegration.cohort.packages.engineeringFoundation.version
+                }),
+                profilePath: qualifiedIntegration.profilePath
+            }),
+            evidence: Object.freeze({
+                sourceDigest: before,
+                integration: Object.freeze({ path: integrationPath, digest: integrationFile.digest }),
+                contract: qualification.evidence,
+                profile: Object.freeze(evidence.profile),
+                skill: Object.freeze(evidence.skill),
+                packageManifestDigest: evidence.packageManifestDigest,
+                lockfileDigest: evidence.lockfileDigest,
+                executingDocsProtocol: Object.freeze({ version: executingPackages.docsVersion, buildDigest: digest(evidence.executingModule) }),
+                executingFoundation: Object.freeze({
+                    version: environment.installedFoundationVersion,
+                    buildIdentity: environment.installedFoundationBuildIdentity
+                }),
+                cohort: Object.freeze({ ...qualifiedIntegration.cohort })
+            })
+        });
+        return Object.freeze({ ...body, receiptDigest: digest(canonicalJson(body)) });
+    }
+    finally {
+        await rm(temporary, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=qualification-v2-runner.js.map

package/dist/qualification/qualification-v2-runner.js.map

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

package/dist/qualification/v2-contract.d.ts

@@ -0,0 +1,91 @@
+import type { DocumentJsonValue } from "@agent-teams/engineering-foundation/document-authoring";
+export interface DocsProtocolQualificationScenarioV2 {
+    readonly id: string;
+    readonly type: string;
+    readonly intent: {
+        readonly id: string;
+        readonly title: string;
+        readonly owner: string;
+        readonly summary: string;
+        readonly slug?: string;
+        readonly destination?: string;
+        readonly related?: readonly string[];
+        readonly blockedBy?: readonly string[];
+        readonly codeAnchors?: readonly {
+            readonly enforcement: "advisory" | "required";
+            readonly pattern: string;
+        }[];
+        readonly metadata?: Readonly<Record<string, DocumentJsonValue>>;
+    };
+    readonly expected: {
+        readonly documentPath: string;
+        readonly metadataStorage: "frontmatter";
+        readonly reachability: unknown;
+        readonly goldenFile?: string;
+        readonly goldenDigest?: `sha256:${string}`;
+    };
+}
+export interface DocsProtocolQualificationContractV2 {
+    readonly schemaVersion: 2;
+    readonly scenarios: readonly DocsProtocolQualificationScenarioV2[];
+}
+export interface DocsProtocolQualificationV2Request {
+    readonly consumerRoot: string;
+    readonly integrationPath?: string;
+    readonly localDevelopment?: boolean;
+    readonly signal?: AbortSignal;
+}
+export interface DocsProtocolQualificationReceiptV2 {
+    readonly schemaVersion: 2;
+    readonly receiptDigest: `sha256:${string}`;
+    readonly cohortAdmissible: boolean;
+    readonly evidenceClass: "local-development" | "released-cohort";
+    readonly projectId: string;
+    readonly scenarios: readonly {
+        readonly id: string;
+        readonly type: string;
+        readonly documentPath: string;
+        readonly outputDigest: string;
+    }[];
+    readonly checks: readonly ("info" | "find" | "check" | "doctor" | "recover" | "preview" | "apply" | "path" | "reachability" | "golden" | "source-unchanged")[];
+    readonly derived: {
+        readonly contractPath: string;
+        readonly gateCommand: string;
+        readonly packageVersions: {
+            readonly docsProtocol: string;
+            readonly engineeringFoundation: string;
+        };
+        readonly profilePath: string;
+    };
+    readonly evidence: {
+        readonly sourceDigest: `sha256:${string}`;
+        readonly integration: {
+            readonly path: string;
+            readonly digest: `sha256:${string}`;
+        };
+        readonly contract: {
+            readonly path: string;
+            readonly digest: `sha256:${string}`;
+        };
+        readonly profile: {
+            readonly path: string;
+            readonly digest: `sha256:${string}`;
+        };
+        readonly skill: {
+            readonly path: string;
+            readonly digest: `sha256:${string}`;
+        };
+        readonly packageManifestDigest: `sha256:${string}`;
+        readonly lockfileDigest: `sha256:${string}`;
+        readonly executingDocsProtocol: {
+            readonly version: string;
+            readonly buildDigest: `sha256:${string}`;
+        };
+        readonly executingFoundation: {
+            readonly version: string;
+            readonly buildIdentity: `sha256:${string}`;
+        };
+        readonly cohort: Readonly<Record<string, unknown>>;
+    };
+}
+//# sourceMappingURL=v2-contract.d.ts.map

package/dist/qualification/v2-contract.d.ts.map

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

package/dist/qualification/v2-contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=v2-contract.js.map

package/dist/qualification/v2-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2-contract.js","sourceRoot":"","sources":["../../src/qualification/v2-contract.ts"],"names":[],"mappings":""}