@agent-teams/engineering-foundation 0.7.0 → 0.9.0

package/dist/scaffolding/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scaffolding/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,UAAU,EACV,aAAa,EACb,SAAS,EACT,0BAA0B,EAC1B,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,wBAAwB,EACxB,0BAA0B,EAC1B,cAAc,EACd,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,YAAY,EACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,EACrB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scaffolding/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,UAAU,EACV,aAAa,EACb,SAAS,EACT,cAAc,EACd,YAAY,EACb,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,wBAAwB,EACxB,+BAA+B,EAC/B,yBAAyB,EACzB,wBAAwB,EACxB,gCAAgC,EAChC,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,wBAAwB,EACxB,6BAA6B,EAC7B,wBAAwB,EACxB,wBAAwB,EACxB,4BAA4B,EAC5B,YAAY,EACZ,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,iCAAiC,EACjC,cAAc,EACd,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,uBAAuB,EACvB,qCAAqC,EACrC,wBAAwB,EACxB,2BAA2B,EAC3B,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/scaffolding/index.js

@@ -1,9 +1,4 @@
-export { applyFilesystemScaffold, recoverFilesystemScaffold } from "./adapters/node/filesystem-workspace.js";
-export { readScaffoldPlanFile } from "./adapters/node/node-input-loader.js";
-export { validateScaffoldReceipt } from "./adapters/node/node-receipt-validator.js";
-export { MemoryScaffoldWorkspace } from "./adapters/memory/memory-workspace.js";
-export { assertScaffoldPlanDigest } from "./kernel/plan-validation.js";
-export { assertScaffoldReceiptDigest } from "./kernel/receipt.js";
+export { applyFilesystemScaffold, assertScaffoldAuthorityEvidenceDigest, assertScaffoldPlanDigest, assertScaffoldReceiptDigest, planScaffoldFromFile, readScaffoldPlanFile, recoverFilesystemScaffold, validateScaffoldReceipt } from "./canonical-api.js";
 export { ScaffoldError } from "./scaffold-error.js";
-export { DEFAULT_SCAFFOLDING_CONFIG_PATH, planScaffoldFromFile } from "./service.js";
+export { DEFAULT_SCAFFOLDING_CONFIG_PATH } from "./scaffold-defaults.js";
 //# sourceMappingURL=index.js.map

package/dist/scaffolding/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scaffolding/index.ts"],"names":[],"mappings":"AAuBA,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,EACrB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scaffolding/index.ts"],"names":[],"mappings":"AAsCA,OAAO,EACL,uBAAuB,EACvB,qCAAqC,EACrC,wBAAwB,EACxB,2BAA2B,EAC3B,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/scaffolding/kernel/authority-compiler.d.ts

@@ -0,0 +1,4 @@
+import type { AuthorityScaffoldCompilationInput, AuthorityScaffoldPlan } from "../contract/types.js";
+import type { ScaffoldDefinitionRegistry } from "./definition-registry.js";
+export declare function compileAuthorityScaffoldPlan(input: AuthorityScaffoldCompilationInput, registry: ScaffoldDefinitionRegistry): AuthorityScaffoldPlan;
+//# sourceMappingURL=authority-compiler.d.ts.map

package/dist/scaffolding/kernel/authority-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authority-compiler.d.ts","sourceRoot":"","sources":["../../../src/scaffolding/kernel/authority-compiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,iCAAiC,EAGjC,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAS9B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAiF3E,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,iCAAiC,EACxC,QAAQ,EAAE,0BAA0B,GACnC,qBAAqB,CAwBvB"}

package/dist/scaffolding/kernel/authority-compiler.js

@@ -0,0 +1,78 @@
+import { ScaffoldError } from "../scaffold-error.js";
+import { sha256Json } from "./canonical-json.js";
+import { assertAuthorityEvidenceSourceBindings } from "./authority-evidence.js";
+import { compileScaffoldRendering, resolveScaffoldRenderingSelection } from "./compiler.js";
+function assertVerifierAdmission(input, composition, target) {
+    const authorityVerifiers = composition.authorityVerifiers;
+    if (authorityVerifiers.length !== 1) {
+        throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", "The selected Composition must contain exactly one supported authority verifier.");
+    }
+    const admittedVerifier = authorityVerifiers[0];
+    if (admittedVerifier === undefined) {
+        throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", "The selected Composition must admit exactly one authority verifier.");
+    }
+    if (!admittedVerifier.parameters.allowedStatuses.includes(input.authorityEvidence.ownerDocument.status)) {
+        throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", "Owner document status is not allowed by the selected Composition.");
+    }
+    assertAuthorityEvidenceSourceBindings({
+        evidence: input.authorityEvidence,
+        target,
+        projectId: input.config.projectId,
+        targetRef: input.intent.targetRef,
+        configPath: input.configPath,
+        targetCatalogPath: input.config.targetCatalogPath,
+        authorityReadSet: input.authorityReadSet
+    });
+}
+function normalizeAuthorityPlan(input, rendering, composition, target) {
+    const authoritySnapshotDigest = sha256Json({
+        configPath: input.configPath,
+        projectId: input.config.projectId,
+        composition,
+        target,
+        authorityEvidence: input.authorityEvidence,
+        readSet: input.authorityReadSet
+    });
+    const planBody = {
+        schemaVersion: 1,
+        protocolVersion: 1,
+        ...rendering,
+        projectId: input.config.projectId,
+        authority: Object.freeze({
+            configPath: input.configPath,
+            targetCatalogPath: input.config.targetCatalogPath
+        }),
+        authorityEvidence: input.authorityEvidence,
+        authoritySnapshotDigest,
+        target,
+        readSet: Object.freeze([...input.authorityReadSet].toSorted((left, right) => left.path < right.path ? -1 : left.path > right.path ? 1 : 0)),
+        requiredAdapterCapabilities: ["materialize-file/v1"]
+    };
+    return Object.freeze({
+        ...planBody,
+        planDigest: sha256Json(planBody)
+    });
+}
+export function compileAuthorityScaffoldPlan(input, registry) {
+    const { composition, target } = resolveScaffoldRenderingSelection({
+        compositions: input.config.compositions,
+        targets: input.catalog.packages,
+        authorityReadPaths: input.authorityReadSet.map(({ path }) => path),
+        intent: input.intent
+    });
+    assertVerifierAdmission(input, composition, target);
+    const rendering = compileScaffoldRendering({
+        foundationVersion: input.foundationVersion,
+        intent: input.intent,
+        composition,
+        target: {
+            id: target.id,
+            role: target.role,
+            path: target.path,
+            packageName: target.packageName
+        },
+        verifiedOwnerDocumentId: target.ownerDocument.id
+    }, registry);
+    return normalizeAuthorityPlan(input, rendering, composition, target);
+}
+//# sourceMappingURL=authority-compiler.js.map

package/dist/scaffolding/kernel/authority-compiler.js.map

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

package/dist/scaffolding/kernel/authority-evidence.d.ts

@@ -0,0 +1,13 @@
+import type { ScaffoldAuthorityEvidenceV1, ScaffoldReadAssertionV1, AuthorityScaffoldTarget } from "../contract/types.js";
+export declare function createScaffoldAuthorityEvidence(evidence: Omit<ScaffoldAuthorityEvidenceV1, "evidenceDigest">): ScaffoldAuthorityEvidenceV1;
+export declare function assertScaffoldAuthorityEvidenceDigest(evidence: ScaffoldAuthorityEvidenceV1): void;
+export declare function assertAuthorityEvidenceSourceBindings(options: {
+    readonly evidence: ScaffoldAuthorityEvidenceV1;
+    readonly target: AuthorityScaffoldTarget;
+    readonly projectId: string;
+    readonly targetRef: string;
+    readonly configPath: string;
+    readonly targetCatalogPath: string;
+    readonly authorityReadSet: readonly ScaffoldReadAssertionV1[];
+}): void;
+//# sourceMappingURL=authority-evidence.d.ts.map

package/dist/scaffolding/kernel/authority-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authority-evidence.d.ts","sourceRoot":"","sources":["../../../src/scaffolding/kernel/authority-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,2BAA2B,EAE3B,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,sBAAsB,CAAC;AAqC9B,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,IAAI,CAAC,2BAA2B,EAAE,gBAAgB,CAAC,GAC5D,2BAA2B,CAM7B;AAED,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,2BAA2B,GACpC,IAAI,CAWN;AAED,wBAAgB,qCAAqC,CAAC,OAAO,EAAE;IAC7D,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAC/D,GAAG,IAAI,CAgEP"}

package/dist/scaffolding/kernel/authority-evidence.js

@@ -0,0 +1,79 @@
+import { ScaffoldError } from "../scaffold-error.js";
+import { canonicalJson, sha256Json } from "./canonical-json.js";
+function canonicalSources(sources) {
+    const source = (role) => {
+        const matches = sources.filter((candidate) => candidate.role === role);
+        if (matches.length !== 1) {
+            throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", `Scaffolding Authority Evidence must contain exactly one ${role} source.`);
+        }
+        return matches[0];
+    };
+    return Object.freeze([
+        source("config"),
+        source("owner-document"),
+        source("target-catalog")
+    ]);
+}
+function canonicalEvidenceBody(evidence) {
+    return Object.freeze({
+        ...evidence,
+        sources: canonicalSources(evidence.sources)
+    });
+}
+export function createScaffoldAuthorityEvidence(evidence) {
+    const body = canonicalEvidenceBody(evidence);
+    return Object.freeze({
+        ...body,
+        evidenceDigest: sha256Json(body)
+    });
+}
+export function assertScaffoldAuthorityEvidenceDigest(evidence) {
+    const { evidenceDigest: _evidenceDigest, ...body } = evidence;
+    const expected = sha256Json(canonicalEvidenceBody(body));
+    if (evidence.evidenceDigest !== expected) {
+        throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", "Scaffolding Authority Evidence digest does not match its canonical content.");
+    }
+}
+export function assertAuthorityEvidenceSourceBindings(options) {
+    const { evidence, target } = options;
+    assertScaffoldAuthorityEvidenceDigest(evidence);
+    if (evidence.projectId !== options.projectId ||
+        evidence.targetRef !== options.targetRef ||
+        evidence.targetIdentityDigest !==
+            sha256Json(target) ||
+        evidence.ownerDocument.id !== target.ownerDocument.id ||
+        evidence.ownerDocument.path !== target.ownerDocument.path) {
+        throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", "Scaffolding Authority Evidence is not bound to the selected target.");
+    }
+    const expectedRoles = new Set(["config", "target-catalog", "owner-document"]);
+    const expectedPaths = new Map([
+        ["config", options.configPath],
+        ["target-catalog", options.targetCatalogPath],
+        ["owner-document", target.ownerDocument.path]
+    ]);
+    const evidencePaths = new Set();
+    for (const source of evidence.sources) {
+        if (!expectedRoles.delete(source.role) ||
+            evidencePaths.has(source.assertion.path) ||
+            expectedPaths.get(source.role) !== source.assertion.path) {
+            throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", "Scaffolding Authority Evidence source roles are not bound to canonical paths.");
+        }
+        evidencePaths.add(source.assertion.path);
+    }
+    if (expectedRoles.size !== 0) {
+        throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", "Scaffolding Authority Evidence does not contain every required source.");
+    }
+    const readSet = new Map(options.authorityReadSet.map((assertion) => [assertion.path, assertion]));
+    if (readSet.size !== options.authorityReadSet.length || readSet.size !== 3) {
+        throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", "Scaffolding source-bound must bind exactly three authority read sources.");
+    }
+    for (const source of evidence.sources) {
+        const assertion = readSet.get(source.assertion.path);
+        if (assertion === undefined ||
+            canonicalJson(assertion) !==
+                canonicalJson(source.assertion)) {
+            throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", "Scaffolding Authority Evidence and Plan read set disagree.");
+        }
+    }
+}
+//# sourceMappingURL=authority-evidence.js.map

package/dist/scaffolding/kernel/authority-evidence.js.map

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

package/dist/scaffolding/kernel/authority-receipt.d.ts

@@ -0,0 +1,11 @@
+import type { ScaffoldDiagnosticV1, AuthorityScaffoldOperationReceipt, AuthorityScaffoldPlan, AuthorityScaffoldReceiptOutcome, AuthorityScaffoldReceipt } from "../contract/types.js";
+export interface CreateAuthorityScaffoldReceiptOptions {
+    readonly plan: AuthorityScaffoldPlan;
+    readonly outcome: AuthorityScaffoldReceiptOutcome;
+    readonly commitState: "committed" | "recovered" | "recovery-required" | "rejected" | "rolled-back";
+    readonly operations: readonly AuthorityScaffoldOperationReceipt[];
+    readonly diagnostics?: readonly ScaffoldDiagnosticV1[];
+}
+export declare function assertAuthorityScaffoldReceiptDigest(receipt: AuthorityScaffoldReceipt, plan?: AuthorityScaffoldPlan): void;
+export declare function createAuthorityScaffoldReceipt(options: CreateAuthorityScaffoldReceiptOptions): AuthorityScaffoldReceipt;
+//# sourceMappingURL=authority-receipt.d.ts.map

package/dist/scaffolding/kernel/authority-receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authority-receipt.d.ts","sourceRoot":"","sources":["../../../src/scaffolding/kernel/authority-receipt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,oBAAoB,EAEpB,iCAAiC,EACjC,qBAAqB,EACrB,+BAA+B,EAC/B,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAuB9B,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,+BAA+B,CAAC;IAClD,QAAQ,CAAC,WAAW,EAChB,WAAW,GACX,WAAW,GACX,mBAAmB,GACnB,UAAU,GACV,aAAa,CAAC;IAClB,QAAQ,CAAC,UAAU,EAAE,SAAS,iCAAiC,EAAE,CAAC;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACxD;AA+JD,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,wBAAwB,EACjC,IAAI,CAAC,EAAE,qBAAqB,GAC3B,IAAI,CAgBN;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,qCAAqC,GAC7C,wBAAwB,CAmC1B"}

package/dist/scaffolding/kernel/authority-receipt.js

@@ -0,0 +1,189 @@
+import { ScaffoldError } from "../scaffold-error.js";
+import { sha256Json } from "./canonical-json.js";
+import { assertAuthorityScaffoldPlanDigest } from "./plan-validation.js";
+const SHA_256_DIGEST_PATTERN = /^sha256:[0-9a-f]{64}$/u;
+function invalidReceipt(message) {
+    throw new ScaffoldError("SCAFFOLD_RECEIPT_INVALID", message);
+}
+function hasObservedPostImage(outcome) {
+    return (outcome === "already-satisfied" ||
+        outcome === "applied" ||
+        outcome === "recovered");
+}
+function assertDigest(value, subject) {
+    if (value === undefined || !SHA_256_DIGEST_PATTERN.test(value)) {
+        invalidReceipt(`${subject} must be a SHA-256 digest.`);
+    }
+}
+function assertAdapterAndCommit(receipt) {
+    if (receipt.adapter.id !== "foundation.filesystem/v1") {
+        invalidReceipt("Scaffolding Receipt adapter is not supported by current scaffolding protocol.");
+    }
+    if (receipt.adapter.contractVersion !== 1) {
+        invalidReceipt("Scaffolding Receipt adapter contract version is not supported.");
+    }
+    if (receipt.commit.atomicity !== "journaled-recoverable") {
+        invalidReceipt("Scaffolding Receipt adapter and commit atomicity are incompatible.");
+    }
+    const expectedState = (() => {
+        switch (receipt.outcome) {
+            case "applied":
+            case "already-applied":
+                return "committed";
+            case "failed-recovered":
+                return "recovered";
+            case "recovery-required":
+                return "recovery-required";
+            case "rejected":
+                return "rejected";
+            case "authority-stale":
+                return "rolled-back";
+            default:
+                return invalidReceipt("Scaffolding Receipt outcome is not supported by current scaffolding protocol.");
+        }
+    })();
+    if (receipt.commit.state !== expectedState) {
+        invalidReceipt("Scaffolding Receipt outcome and commit state are incompatible.");
+    }
+}
+function assertOperations(receipt) {
+    const ids = new Set();
+    const paths = new Set();
+    for (const operation of receipt.operations) {
+        if (ids.has(operation.operationId) || paths.has(operation.path)) {
+            invalidReceipt(`Scaffolding Receipt operation evidence is duplicated: ${operation.operationId}.`);
+        }
+        ids.add(operation.operationId);
+        paths.add(operation.path);
+        if (hasObservedPostImage(operation.outcome)) {
+            assertDigest(operation.resultDigest, `Scaffolding Receipt operation ${operation.operationId} result`);
+        }
+        else if (operation.resultDigest !== undefined) {
+            invalidReceipt(`Scaffolding Receipt operation claims an unobserved result: ${operation.operationId}.`);
+        }
+    }
+}
+function assertOnly(operations, allowed, required) {
+    if (operations.some((operation) => !allowed.includes(operation.outcome))) {
+        invalidReceipt("Scaffolding Receipt operation outcome is incompatible with its Receipt outcome.");
+    }
+    if (required !== undefined &&
+        !operations.some((operation) => required.includes(operation.outcome))) {
+        invalidReceipt("Scaffolding Receipt does not contain the required operation evidence.");
+    }
+}
+function assertOutcome(receipt) {
+    switch (receipt.outcome) {
+        case "applied":
+            if (receipt.operations.length === 0) {
+                invalidReceipt("An applied Scaffolding Receipt requires operation evidence.");
+            }
+            if (receipt.operations[0]?.outcome !== "applied") {
+                invalidReceipt("An applied Scaffolding Receipt must place applied evidence first.");
+            }
+            assertOnly(receipt.operations, ["already-satisfied", "applied"], ["applied"]);
+            return;
+        case "already-applied":
+            if (receipt.operations.length === 0) {
+                invalidReceipt("An already-applied Scaffolding Receipt requires operation evidence.");
+            }
+            assertOnly(receipt.operations, ["already-satisfied"]);
+            return;
+        case "failed-recovered":
+            if (receipt.operations.length === 0) {
+                invalidReceipt("A failed-recovered Scaffolding Receipt requires operation evidence.");
+            }
+            assertOnly(receipt.operations, ["already-satisfied", "recovered"]);
+            return;
+        case "recovery-required":
+            if (receipt.operations.length === 0) {
+                invalidReceipt("A recovery-required Scaffolding Receipt requires operation evidence.");
+            }
+            assertOnly(receipt.operations, ["already-satisfied", "conflict", "not-applied", "unobserved"]);
+            return;
+        case "authority-stale":
+            if (receipt.operations.length === 0) {
+                invalidReceipt("An authority-stale Scaffolding Receipt requires operation evidence.");
+            }
+            assertOnly(receipt.operations, ["not-applied"]);
+            return;
+        case "rejected":
+            if (receipt.operations.length === 0) {
+                invalidReceipt("A rejected Scaffolding Receipt requires operation evidence.");
+            }
+            assertOnly(receipt.operations, ["already-satisfied", "conflict", "not-applied"]);
+            return;
+        default:
+            invalidReceipt("Scaffolding Receipt outcome is not supported by current scaffolding protocol.");
+    }
+}
+function assertPlanEvidence(receipt, plan) {
+    assertAuthorityScaffoldPlanDigest(plan);
+    if (receipt.planDigest !== plan.planDigest) {
+        invalidReceipt("Scaffolding Receipt references a different Plan digest.");
+    }
+    const operations = new Map(plan.operations.map((operation) => [operation.id, operation]));
+    for (const operation of receipt.operations) {
+        const planned = operations.get(operation.operationId);
+        if (planned === undefined || planned.path !== operation.path) {
+            invalidReceipt(`Scaffolding Receipt operation does not match its Plan evidence: ${operation.operationId}.`);
+        }
+        if (hasObservedPostImage(operation.outcome) && operation.resultDigest !== planned.after.digest) {
+            invalidReceipt(`Scaffolding Receipt result digest does not match its Plan evidence: ${operation.operationId}.`);
+        }
+    }
+    if (receipt.operations.length !== plan.operations.length) {
+        invalidReceipt("A plan-bound Scaffolding Receipt must provide evidence for every Plan operation.");
+    }
+}
+export function assertAuthorityScaffoldReceiptDigest(receipt, plan) {
+    const candidate = receipt;
+    if (candidate.schemaVersion !== 1 || candidate.protocolVersion !== 1) {
+        invalidReceipt("Scaffolding Receipt does not use current scaffolding protocol.");
+    }
+    assertDigest(candidate.planDigest, "Scaffolding Receipt Plan digest");
+    assertAdapterAndCommit(candidate);
+    assertOperations(candidate);
+    assertOutcome(candidate);
+    const { receiptDigest: _receiptDigest, ...body } = candidate;
+    if (candidate.receiptDigest !== sha256Json(body)) {
+        invalidReceipt("Scaffolding Receipt digest does not match its canonical content.");
+    }
+    if (plan !== undefined) {
+        assertPlanEvidence(candidate, plan);
+    }
+}
+export function createAuthorityScaffoldReceipt(options) {
+    const operations = options.outcome === "applied"
+        ? [...options.operations].toSorted((left, right) => left.outcome === "applied"
+            ? right.outcome === "applied"
+                ? 0
+                : -1
+            : right.outcome === "applied"
+                ? 1
+                : 0)
+        : [...options.operations];
+    const body = {
+        schemaVersion: 1,
+        protocolVersion: 1,
+        planDigest: options.plan.planDigest,
+        adapter: Object.freeze({
+            id: "foundation.filesystem/v1",
+            contractVersion: 1
+        }),
+        outcome: options.outcome,
+        commit: Object.freeze({
+            state: options.commitState,
+            atomicity: "journaled-recoverable"
+        }),
+        operations: Object.freeze(operations),
+        diagnostics: Object.freeze([...(options.diagnostics ?? [])])
+    };
+    const receipt = Object.freeze({
+        ...body,
+        receiptDigest: sha256Json(body)
+    });
+    assertAuthorityScaffoldReceiptDigest(receipt, options.plan);
+    return receipt;
+}
+//# sourceMappingURL=authority-receipt.js.map

package/dist/scaffolding/kernel/authority-receipt.js.map

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

package/dist/scaffolding/kernel/compiler.d.ts

@@ -1,4 +1,30 @@
-import type { ScaffoldCompilationInput, ScaffoldPlanV1 } from "../contract/types.js";
+import type { ScaffoldRenderingCompiler, ScaffoldRenderingComposition, ScaffoldRenderingCompositionSelection, ScaffoldRenderingDefinitionEvidence, ScaffoldRenderingDiagnostic, ScaffoldRenderingIntent, ScaffoldRenderingOperation, ScaffoldRenderingResolution, ScaffoldRenderingTarget, Sha256Digest } from "../contract/types.js";
 import { ScaffoldDefinitionRegistry } from "./definition-registry.js";
-export declare function compileScaffoldPlan(input: ScaffoldCompilationInput, registry: ScaffoldDefinitionRegistry): ScaffoldPlanV1;
+export declare function resolveScaffoldRenderingSelection<TComposition extends ScaffoldRenderingComposition, TTarget extends ScaffoldRenderingTarget>(input: {
+    readonly compositions: readonly TComposition[];
+    readonly targets: readonly TTarget[];
+    readonly authorityReadPaths: readonly string[];
+    readonly intent: ScaffoldRenderingIntent;
+}): {
+    readonly composition: TComposition;
+    readonly target: TTarget;
+};
+export interface ScaffoldRenderingInput {
+    readonly foundationVersion: string;
+    readonly intent: ScaffoldRenderingIntent;
+    readonly composition: ScaffoldRenderingComposition;
+    readonly target: ScaffoldRenderingTarget;
+    readonly verifiedOwnerDocumentId?: string;
+}
+export interface ScaffoldRenderingResult {
+    readonly compiler: ScaffoldRenderingCompiler;
+    readonly intent: ScaffoldRenderingIntent;
+    readonly intentDigest: Sha256Digest;
+    readonly composition: ScaffoldRenderingCompositionSelection;
+    readonly definitions: readonly ScaffoldRenderingDefinitionEvidence[];
+    readonly resolved: ScaffoldRenderingResolution;
+    readonly operations: readonly ScaffoldRenderingOperation[];
+    readonly diagnostics: readonly ScaffoldRenderingDiagnostic[];
+}
+export declare function compileScaffoldRendering(input: ScaffoldRenderingInput, registry: ScaffoldDefinitionRegistry): ScaffoldRenderingResult;
 //# sourceMappingURL=compiler.d.ts.map

package/dist/scaffolding/kernel/compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/scaffolding/kernel/compiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAMV,wBAAwB,EAIxB,cAAc,EAEf,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EACL,0BAA0B,EAI3B,MAAM,0BAA0B,CAAC;AA0UlC,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,wBAAwB,EAC/B,QAAQ,EAAE,0BAA0B,GACnC,cAAc,CAiJhB"}
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/scaffolding/kernel/compiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,yBAAyB,EACzB,4BAA4B,EAC5B,qCAAqC,EACrC,mCAAmC,EACnC,2BAA2B,EAC3B,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,uBAAuB,EAEvB,YAAY,EACb,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EACL,0BAA0B,EAI3B,MAAM,0BAA0B,CAAC;AAsRlC,wBAAgB,iCAAiC,CAC/C,YAAY,SAAS,4BAA4B,EACjD,OAAO,SAAS,uBAAuB,EACvC,KAAK,EAAE;IACP,QAAQ,CAAC,YAAY,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;CAC1C,GAAG;IACF,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B,CAiCA;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,4BAA4B,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAC3C;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,qCAAqC,CAAC;IAC5D,QAAQ,CAAC,WAAW,EAAE,SAAS,mCAAmC,EAAE,CAAC;IACrE,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;IAC/C,QAAQ,CAAC,UAAU,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAC3D,QAAQ,CAAC,WAAW,EAAE,SAAS,2BAA2B,EAAE,CAAC;CAC9D;AAgBD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,sBAAsB,EAC7B,QAAQ,EAAE,0BAA0B,GACnC,uBAAuB,CA+HzB"}

package/dist/scaffolding/kernel/compiler.js

@@ -160,15 +160,15 @@ function definitionEvidence(registry, definitions) {
             : kindOrder;
     }));
 }
-function resolveAuthoritySelection(input) {
-    assertUnique(input.config.compositions, ({ id }) => id, "Composition ID");
-    assertUnique(input.catalog.packages, ({ id }) => id, "target ID");
-    assertUnique(input.catalog.packages, ({ path }) => path, "target path");
-    assertUnique(input.catalog.packages, ({ path }) => path.toLowerCase(), "case-folded target path");
-    assertUnique(input.catalog.packages, ({ packageName }) => packageName, "target package name");
-    assertUnique(input.authorityReadSet, ({ path }) => path, "authority read path");
-    const composition = findExactlyOne(input.config.compositions, ({ id }) => id === input.intent.compositionId, `Composition must exist exactly once: ${input.intent.compositionId}.`);
-    const target = findExactlyOne(input.catalog.packages, ({ id }) => id === input.intent.targetRef, `Scaffold target must exist exactly once: ${input.intent.targetRef}.`);
+export function resolveScaffoldRenderingSelection(input) {
+    assertUnique(input.compositions, ({ id }) => id, "Composition ID");
+    assertUnique(input.targets, ({ id }) => id, "target ID");
+    assertUnique(input.targets, ({ path }) => path, "target path");
+    assertUnique(input.targets, ({ path }) => path.toLowerCase(), "case-folded target path");
+    assertUnique(input.targets, ({ packageName }) => packageName, "target package name");
+    assertUnique(input.authorityReadPaths, (path) => path, "authority read path");
+    const composition = findExactlyOne(input.compositions, ({ id }) => id === input.intent.compositionId, `Composition must exist exactly once: ${input.intent.compositionId}.`);
+    const target = findExactlyOne(input.targets, ({ id }) => id === input.intent.targetRef, `Scaffold target must exist exactly once: ${input.intent.targetRef}.`);
     assertUnique(composition.targetRoles, (role) => role, "target role");
     if (!composition.targetRoles.includes(target.role)) {
         throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Target role ${target.role} is not admitted by composition ${composition.id}.`);
@@ -182,27 +182,33 @@ function assertFacetCompatibility(facets, recipeId) {
         }
     }
 }
-export function compileScaffoldPlan(input, registry) {
-    const { composition, target } = resolveAuthoritySelection(input);
+export function compileScaffoldRendering(input, registry) {
+    const { composition, target } = input;
+    assertUnique(composition.targetRoles, (role) => role, "target role");
+    if (!composition.targetRoles.includes(target.role)) {
+        throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Target role ${target.role} is not admitted by composition ${composition.id}.`);
+    }
     const profile = registry.resolve(composition.scaffoldProfile.ref, "scaffold-profile");
     const recipe = registry.resolve(composition.recipe.ref, "recipe");
     const profileParameters = composition.scaffoldProfile.parameters ?? {};
     const recipeParameters = mergeRecipeParameters(composition, input.intent.recipeParameters ?? {});
     registry.validateParameters(profile, profileParameters);
     registry.validateParameters(recipe, recipeParameters);
-    if (!profile.allowedRecipeIds.includes(recipe.ref.id) ||
-        !recipe.allowedProfileIds.includes(profile.ref.id) ||
-        !recipe.allowedTargetRoles.includes(target.role)) {
+    if (!profile.allowedRecipeIds.includes(recipe.ref.id)) {
         throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Recipe ${refKey(recipe.ref)} is incompatible with the selected Profile or target role.`);
     }
     const facets = selectFacets(registry, composition, input.intent.facets);
     assertFacetCompatibility(facets, recipe.ref.id);
     const baseContext = Object.freeze({
         target,
+        ...(input.verifiedOwnerDocumentId === undefined
+            ? {}
+            : { verifiedOwnerDocumentId: input.verifiedOwnerDocumentId }),
         profileParameters,
         recipeParameters,
         facetParameters: Object.freeze({})
     });
+    registry.assertRecipeRequirements(recipe, profile.ref.id, baseContext);
     const policyConfigurations = collectPolicies([
         profile.requiredPolicies,
         recipe.requiredPolicies,
@@ -232,13 +238,6 @@ export function compileScaffoldPlan(input, registry) {
         ...facets.map(({ definition }) => definition),
         ...policies
     ]);
-    const authoritySnapshotDigest = sha256Json({
-        configPath: input.configPath,
-        projectId: input.config.projectId,
-        composition,
-        target,
-        readSet: input.authorityReadSet
-    });
     const normalizedIntent = JSON.parse(canonicalJson({
         schemaVersion: 1,
         compositionId: input.intent.compositionId,
@@ -252,21 +251,13 @@ export function compileScaffoldPlan(input, registry) {
                 facets: [...input.intent.facets].toSorted((left, right) => compareStrings(refKey(left.ref), refKey(right.ref)))
             })
     }));
-    const planBody = {
-        schemaVersion: 1,
-        protocolVersion: 1,
+    return Object.freeze({
         compiler: Object.freeze({
             id: "@agent-teams/engineering-foundation",
             version: input.foundationVersion
         }),
-        projectId: input.config.projectId,
-        authority: Object.freeze({
-            configPath: input.configPath,
-            targetCatalogPath: input.config.targetCatalogPath
-        }),
         intent: normalizedIntent,
         intentDigest: sha256Json(normalizedIntent),
-        authoritySnapshotDigest,
         composition: Object.freeze({
             id: composition.id,
             scaffoldProfile: profile.ref,
@@ -285,13 +276,8 @@ export function compileScaffoldPlan(input, registry) {
                 outcome: "passed"
             })))
         }),
-        target,
-        readSet: Object.freeze([...input.authorityReadSet].toSorted((left, right) => compareStrings(left.path, right.path))),
-        requiredAdapterCapabilities: ["materialize-file/v1"],
         operations,
         diagnostics: Object.freeze([])
-    };
-    const planDigest = sha256Json(planBody);
-    return Object.freeze({ ...planBody, planDigest });
+    });
 }
 //# sourceMappingURL=compiler.js.map