@agent-teams/engineering-foundation 0.4.1 → 0.6.0

package/dist/scaffolding/kernel/compiler.js

@@ -0,0 +1,297 @@
+import { ScaffoldError } from "../scaffold-error.js";
+import { canonicalJson, sha256Bytes, sha256Json, sha256Text } from "./canonical-json.js";
+import { ScaffoldDefinitionRegistry } from "./definition-registry.js";
+import { MAX_SCAFFOLD_FILE_BYTES, MAX_SCAFFOLD_ID_LENGTH, MAX_SCAFFOLD_OPERATIONS, MAX_SCAFFOLD_TOTAL_BYTES } from "./limits.js";
+function refKey(ref) {
+    return `${ref.id}@${ref.contractVersion}`;
+}
+function compareStrings(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function assertUnique(values, key, subject) {
+    const seen = new Set();
+    for (const value of values) {
+        const identity = key(value);
+        if (seen.has(identity)) {
+            throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Duplicate ${subject}: ${identity}.`);
+        }
+        seen.add(identity);
+    }
+}
+function findExactlyOne(values, predicate, missingMessage) {
+    const matches = values.filter(predicate);
+    if (matches.length !== 1) {
+        throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", missingMessage);
+    }
+    return matches[0];
+}
+function mergeRecipeParameters(composition, explicit) {
+    const fixed = composition.fixedRecipeParameters ?? {};
+    for (const [key, value] of Object.entries(explicit)) {
+        const fixedValue = fixed[key];
+        if (fixedValue !== undefined &&
+            canonicalJson(value) !== canonicalJson(fixedValue)) {
+            throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Recipe parameter ${key} is fixed by composition ${composition.id}.`);
+        }
+    }
+    return Object.freeze({
+        ...composition.recipe.parameters,
+        ...composition.defaultRecipeParameters,
+        ...explicit,
+        ...fixed
+    });
+}
+function collectPolicies(sources) {
+    const policies = new Map();
+    for (const source of sources) {
+        for (const configured of source) {
+            const key = refKey(configured.ref);
+            const existing = policies.get(key);
+            if (existing !== undefined &&
+                canonicalJson(existing.parameters ?? {}) !==
+                    canonicalJson(configured.parameters ?? {})) {
+                throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Required Policy parameters conflict: ${key}.`);
+            }
+            policies.set(key, configured);
+        }
+    }
+    return Object.freeze([...policies.values()].toSorted((left, right) => compareStrings(refKey(left.ref), refKey(right.ref))));
+}
+function selectFacets(registry, composition, explicit) {
+    const fixed = composition.facets?.fixed ?? [];
+    const selected = explicit ?? composition.facets?.default ?? [];
+    const allowed = new Set((composition.facets?.allowed ?? []).map((ref) => refKey(ref)));
+    assertUnique(composition.facets?.allowed ?? [], (ref) => refKey(ref), "allowed Facet");
+    assertUnique(fixed, ({ ref }) => refKey(ref), "fixed Facet");
+    assertUnique(selected, ({ ref }) => refKey(ref), "selected Facet");
+    const fixedKeys = new Set(fixed.map(({ ref }) => refKey(ref)));
+    for (const candidate of selected) {
+        const key = refKey(candidate.ref);
+        if (fixedKeys.has(key)) {
+            throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Fixed Facet cannot be selected again: ${key}.`);
+        }
+        if (!allowed.has(key)) {
+            throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Facet is not allowed by composition ${composition.id}: ${key}.`);
+        }
+    }
+    const resolved = [...fixed, ...selected]
+        .map((candidate) => {
+        const definition = registry.resolve(candidate.ref, "facet");
+        const parameters = candidate.parameters ?? {};
+        registry.validateParameters(definition, parameters);
+        return Object.freeze({ definition, parameters });
+    })
+        .toSorted((left, right) => compareStrings(refKey(left.definition.ref), refKey(right.definition.ref)));
+    const selectedKeys = new Set(resolved.map(({ definition }) => refKey(definition.ref)));
+    for (const { definition } of resolved) {
+        for (const required of definition.requires) {
+            if (!selectedKeys.has(refKey(required))) {
+                throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Facet ${refKey(definition.ref)} requires ${refKey(required)}.`);
+            }
+        }
+        for (const conflict of definition.conflicts) {
+            if (selectedKeys.has(refKey(conflict))) {
+                throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Facet ${refKey(definition.ref)} conflicts with ${refKey(conflict)}.`);
+            }
+        }
+    }
+    return Object.freeze(resolved);
+}
+function assertContributionPath(target, contribution) {
+    if (target.path.includes("\\") ||
+        target.path.split("/").some((segment) => segment === "" || segment === "." || segment === "..")) {
+        throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", `Target path must be normalized: ${target.path}.`);
+    }
+    const targetPrefix = `${target.path}/`;
+    if (!contribution.path.startsWith(targetPrefix) ||
+        contribution.path.includes("\\") ||
+        contribution.path.split("/").some((segment) => segment === "" || segment === "." || segment === "..")) {
+        throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", `Definition output escapes target ${target.id}: ${contribution.path}.`);
+    }
+}
+function operationsFromContributions(target, contributions) {
+    if (contributions.length === 0 ||
+        contributions.length > MAX_SCAFFOLD_OPERATIONS) {
+        throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", "A scaffolding Plan must contain a bounded non-empty operation set.");
+    }
+    assertUnique(contributions, ({ path }) => path, "output path");
+    let totalBytes = 0;
+    const operations = contributions.map((contribution) => {
+        assertContributionPath(target, contribution);
+        const bytes = Buffer.from(contribution.content, "utf8");
+        if (bytes.byteLength > MAX_SCAFFOLD_FILE_BYTES) {
+            throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", `Generated file exceeds ${MAX_SCAFFOLD_FILE_BYTES} bytes: ${contribution.path}.`);
+        }
+        totalBytes += bytes.byteLength;
+        const readableId = `materialize/${contribution.path}`;
+        return Object.freeze({
+            id: readableId.length <= MAX_SCAFFOLD_ID_LENGTH
+                ? readableId
+                : `materialize/${sha256Text(contribution.path).slice("sha256:".length)}`,
+            kind: "materialize-file",
+            path: contribution.path,
+            precondition: Object.freeze({ state: "absent" }),
+            after: Object.freeze({
+                digest: sha256Bytes(bytes),
+                size: bytes.byteLength,
+                mode: "0644",
+                mediaType: contribution.mediaType,
+                contentBase64: bytes.toString("base64")
+            }),
+            causes: Object.freeze([...contribution.causes].toSorted(compareStrings))
+        });
+    });
+    if (totalBytes > MAX_SCAFFOLD_TOTAL_BYTES) {
+        throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", `Generated output exceeds ${MAX_SCAFFOLD_TOTAL_BYTES} bytes.`);
+    }
+    return Object.freeze(operations.toSorted((left, right) => compareStrings(left.path, right.path)));
+}
+function definitionEvidence(registry, definitions) {
+    return Object.freeze(definitions
+        .map((definition) => Object.freeze({
+        kind: definition.kind,
+        ref: definition.ref,
+        contractDigest: registry.digest(definition)
+    }))
+        .toSorted((left, right) => {
+        const kindOrder = compareStrings(left.kind, right.kind);
+        return kindOrder === 0
+            ? compareStrings(refKey(left.ref), refKey(right.ref))
+            : 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}.`);
+    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}.`);
+    }
+    return { composition, target };
+}
+function assertFacetCompatibility(facets, recipeId) {
+    for (const { definition } of facets) {
+        if (!definition.allowedRecipeIds.includes(recipeId)) {
+            throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Facet ${refKey(definition.ref)} is incompatible with Recipe ${recipeId}.`);
+        }
+    }
+}
+export function compileScaffoldPlan(input, registry) {
+    const { composition, target } = resolveAuthoritySelection(input);
+    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)) {
+        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,
+        profileParameters,
+        recipeParameters,
+        facetParameters: Object.freeze({})
+    });
+    const policyConfigurations = collectPolicies([
+        profile.requiredPolicies,
+        recipe.requiredPolicies,
+        ...facets.map(({ definition }) => definition.requiredPolicies),
+        composition.policies
+    ]);
+    const policies = policyConfigurations.map((configured) => {
+        const definition = registry.resolve(configured.ref, "policy");
+        const parameters = configured.parameters ?? {};
+        registry.validateParameters(definition, parameters);
+        definition.evaluate(baseContext, parameters);
+        return definition;
+    });
+    const contributions = [
+        ...recipe.compile(baseContext)
+    ];
+    for (const facet of facets) {
+        contributions.push(...facet.definition.compile(Object.freeze({
+            ...baseContext,
+            facetParameters: facet.parameters
+        })));
+    }
+    const operations = operationsFromContributions(target, contributions);
+    const definitions = definitionEvidence(registry, [
+        profile,
+        recipe,
+        ...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,
+        targetRef: input.intent.targetRef,
+        ...(input.intent.recipeParameters === undefined
+            ? {}
+            : { recipeParameters: input.intent.recipeParameters }),
+        ...(input.intent.facets === undefined
+            ? {}
+            : {
+                facets: [...input.intent.facets].toSorted((left, right) => compareStrings(refKey(left.ref), refKey(right.ref)))
+            })
+    }));
+    const planBody = {
+        schemaVersion: 1,
+        protocolVersion: 1,
+        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,
+            recipe: recipe.ref,
+            facets: Object.freeze(facets.map(({ definition }) => definition.ref)),
+            policies: Object.freeze(policies.map(({ ref }) => ref))
+        }),
+        definitions,
+        resolved: Object.freeze({
+            profileParameters,
+            recipeParameters,
+            facets: Object.freeze(facets.map(({ definition, parameters }) => Object.freeze({ ref: definition.ref, parameters }))),
+            policies: Object.freeze(policyConfigurations.map((configured) => Object.freeze({
+                ref: configured.ref,
+                parameters: configured.parameters ?? {},
+                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

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

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

package/dist/scaffolding/kernel/definition-registry.d.ts

@@ -0,0 +1,50 @@
+import type { ConfiguredDefinition, DefinitionRef, JsonObject, JsonValue, ScaffoldFileContribution, ScaffoldTargetV1, Sha256Digest } from "../contract/types.js";
+export type ScaffoldDefinitionKind = "facet" | "policy" | "recipe" | "scaffold-profile";
+export interface ScaffoldDefinitionContext {
+    readonly target: ScaffoldTargetV1;
+    readonly profileParameters: JsonObject;
+    readonly recipeParameters: JsonObject;
+    readonly facetParameters: JsonObject;
+}
+interface BaseDefinition {
+    readonly kind: ScaffoldDefinitionKind;
+    readonly ref: DefinitionRef;
+    readonly descriptor: JsonValue;
+    readonly parameterSchema: object;
+}
+interface ScaffoldProfileDefinition extends BaseDefinition {
+    readonly kind: "scaffold-profile";
+    readonly allowedRecipeIds: readonly string[];
+    readonly requiredPolicies: readonly ConfiguredDefinition[];
+}
+interface ScaffoldRecipeDefinition extends BaseDefinition {
+    readonly kind: "recipe";
+    readonly allowedProfileIds: readonly string[];
+    readonly allowedTargetRoles: readonly string[];
+    readonly requiredPolicies: readonly ConfiguredDefinition[];
+    compile(context: ScaffoldDefinitionContext): readonly ScaffoldFileContribution[];
+}
+export interface ScaffoldFacetDefinition extends BaseDefinition {
+    readonly kind: "facet";
+    readonly allowedRecipeIds: readonly string[];
+    readonly requires: readonly DefinitionRef[];
+    readonly conflicts: readonly DefinitionRef[];
+    readonly requiredPolicies: readonly ConfiguredDefinition[];
+    compile(context: ScaffoldDefinitionContext): readonly ScaffoldFileContribution[];
+}
+interface ScaffoldPolicyDefinition extends BaseDefinition {
+    readonly kind: "policy";
+    evaluate(context: ScaffoldDefinitionContext, parameters: JsonObject): void;
+}
+export type ScaffoldDefinition = ScaffoldFacetDefinition | ScaffoldPolicyDefinition | ScaffoldProfileDefinition | ScaffoldRecipeDefinition;
+export declare class ScaffoldDefinitionRegistry {
+    #private;
+    constructor(definitions: readonly ScaffoldDefinition[]);
+    resolve<TKind extends ScaffoldDefinitionKind>(ref: DefinitionRef, expectedKind: TKind): Extract<ScaffoldDefinition, {
+        readonly kind: TKind;
+    }>;
+    validateParameters(definition: ScaffoldDefinition, parameters: JsonObject): void;
+    digest(definition: ScaffoldDefinition): Sha256Digest;
+}
+export {};
+//# sourceMappingURL=definition-registry.d.ts.map

package/dist/scaffolding/kernel/definition-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-registry.d.ts","sourceRoot":"","sources":["../../../src/scaffolding/kernel/definition-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,UAAU,EACV,SAAS,EACT,wBAAwB,EACxB,gBAAgB,EAChB,YAAY,EACb,MAAM,sBAAsB,CAAC;AAI9B,MAAM,MAAM,sBAAsB,GAC9B,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,kBAAkB,CAAC;AAEvB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,UAAU,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,UAAU,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC;CACtC;AAED,UAAU,cAAc;IACtB,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,UAAU,yBAA0B,SAAQ,cAAc;IACxD,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAC5D;AAED,UAAU,wBAAyB,SAAQ,cAAc;IACvD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3D,OAAO,CAAC,OAAO,EAAE,yBAAyB,GAAG,SAAS,wBAAwB,EAAE,CAAC;CAClF;AAED,MAAM,WAAW,uBAAwB,SAAQ,cAAc;IAC7D,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3D,OAAO,CAAC,OAAO,EAAE,yBAAyB,GAAG,SAAS,wBAAwB,EAAE,CAAC;CAClF;AAED,UAAU,wBAAyB,SAAQ,cAAc;IACvD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,yBAAyB,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;CAC5E;AAED,MAAM,MAAM,kBAAkB,GAC1B,uBAAuB,GACvB,wBAAwB,GACxB,yBAAyB,GACzB,wBAAwB,CAAC;AA0B7B,qBAAa,0BAA0B;;IAIrC,YAAY,WAAW,EAAE,SAAS,kBAAkB,EAAE,EAUrD;IAED,OAAO,CAAC,KAAK,SAAS,sBAAsB,EAC1C,GAAG,EAAE,aAAa,EAClB,YAAY,EAAE,KAAK,GAClB,OAAO,CAAC,kBAAkB,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;KAAE,CAAC,CASvD;IAED,kBAAkB,CAAC,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,CAc/E;IAED,MAAM,CAAC,UAAU,EAAE,kBAAkB,GAAG,YAAY,CAsCnD;CACF"}

package/dist/scaffolding/kernel/definition-registry.js

@@ -0,0 +1,92 @@
+import { Ajv2020 } from "ajv/dist/2020.js";
+import { ScaffoldError } from "../scaffold-error.js";
+import { sha256Json } from "./canonical-json.js";
+function definitionKey(ref) {
+    return `${ref.id}@${ref.contractVersion}`;
+}
+function compareDefinitionRefs(left, right) {
+    const leftKey = definitionKey(left);
+    const rightKey = definitionKey(right);
+    if (leftKey < rightKey) {
+        return -1;
+    }
+    if (leftKey > rightKey) {
+        return 1;
+    }
+    return 0;
+}
+function validationMessage(validate) {
+    return (validate.errors ?? [])
+        .slice(0, 8)
+        .map((error) => `${error.instancePath || "/"} ${error.message ?? "is invalid"}`)
+        .join("; ")
+        .slice(0, 1000);
+}
+export class ScaffoldDefinitionRegistry {
+    #definitions;
+    #validators = new Map();
+    constructor(definitions) {
+        const entries = new Map();
+        for (const definition of definitions) {
+            const key = definitionKey(definition.ref);
+            if (entries.has(key)) {
+                throw new Error(`Duplicate scaffolding definition: ${key}.`);
+            }
+            entries.set(key, Object.freeze(definition));
+        }
+        this.#definitions = entries;
+    }
+    resolve(ref, expectedKind) {
+        const definition = this.#definitions.get(definitionKey(ref));
+        if (definition === undefined || definition.kind !== expectedKind) {
+            throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Unknown ${expectedKind} definition: ${definitionKey(ref)}.`);
+        }
+        return definition;
+    }
+    validateParameters(definition, parameters) {
+        const key = definitionKey(definition.ref);
+        let validate = this.#validators.get(key);
+        if (validate === undefined) {
+            const ajv = new Ajv2020({ allErrors: true, strict: true });
+            validate = ajv.compile(definition.parameterSchema);
+            this.#validators.set(key, validate);
+        }
+        if (!validate(parameters)) {
+            throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Invalid parameters for ${key}: ${validationMessage(validate)}`);
+        }
+    }
+    digest(definition) {
+        const common = {
+            kind: definition.kind,
+            ref: definition.ref,
+            descriptor: definition.descriptor,
+            parameterSchema: definition.parameterSchema
+        };
+        switch (definition.kind) {
+            case "facet":
+                return sha256Json({
+                    ...common,
+                    allowedRecipeIds: definition.allowedRecipeIds.toSorted(),
+                    requires: definition.requires.toSorted(compareDefinitionRefs),
+                    conflicts: definition.conflicts.toSorted(compareDefinitionRefs),
+                    requiredPolicies: definition.requiredPolicies.toSorted((left, right) => compareDefinitionRefs(left.ref, right.ref))
+                });
+            case "policy":
+                return sha256Json(common);
+            case "recipe":
+                return sha256Json({
+                    ...common,
+                    allowedProfileIds: definition.allowedProfileIds.toSorted(),
+                    allowedTargetRoles: definition.allowedTargetRoles.toSorted(),
+                    requiredPolicies: definition.requiredPolicies.toSorted((left, right) => compareDefinitionRefs(left.ref, right.ref))
+                });
+            case "scaffold-profile":
+                return sha256Json({
+                    ...common,
+                    allowedRecipeIds: definition.allowedRecipeIds.toSorted(),
+                    requiredPolicies: definition.requiredPolicies.toSorted((left, right) => compareDefinitionRefs(left.ref, right.ref))
+                });
+        }
+    }
+}
+//# sourceMappingURL=definition-registry.js.map

package/dist/scaffolding/kernel/definition-registry.js.map

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

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

@@ -0,0 +1,5 @@
+export declare const MAX_SCAFFOLD_FILE_BYTES: number;
+export declare const MAX_SCAFFOLD_TOTAL_BYTES: number;
+export declare const MAX_SCAFFOLD_OPERATIONS = 4096;
+export declare const MAX_SCAFFOLD_ID_LENGTH = 214;
+//# sourceMappingURL=limits.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../../src/scaffolding/kernel/limits.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,QAAc,CAAC;AACnD,eAAO,MAAM,wBAAwB,QAAmB,CAAC;AACzD,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAC5C,eAAO,MAAM,sBAAsB,MAAM,CAAC"}

package/dist/scaffolding/kernel/limits.js

@@ -0,0 +1,5 @@
+export const MAX_SCAFFOLD_FILE_BYTES = 1024 * 1024;
+export const MAX_SCAFFOLD_TOTAL_BYTES = 16 * 1024 * 1024;
+export const MAX_SCAFFOLD_OPERATIONS = 4096;
+export const MAX_SCAFFOLD_ID_LENGTH = 214;
+//# sourceMappingURL=limits.js.map

package/dist/scaffolding/kernel/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../../src/scaffolding/kernel/limits.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,GAAG,IAAI,CAAC;AACnD,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AACzD,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAC5C,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC"}

package/dist/scaffolding/kernel/plan-validation.d.ts

@@ -0,0 +1,3 @@
+import type { ScaffoldPlanV1 } from "../contract/types.js";
+export declare function assertScaffoldPlanDigest(plan: ScaffoldPlanV1): void;
+//# sourceMappingURL=plan-validation.d.ts.map

package/dist/scaffolding/kernel/plan-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-validation.d.ts","sourceRoot":"","sources":["../../../src/scaffolding/kernel/plan-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQtE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAkEnE"}

package/dist/scaffolding/kernel/plan-validation.js

@@ -0,0 +1,44 @@
+import { ScaffoldError } from "../scaffold-error.js";
+import { sha256Bytes, sha256Json } from "./canonical-json.js";
+import { MAX_SCAFFOLD_OPERATIONS, MAX_SCAFFOLD_TOTAL_BYTES } from "./limits.js";
+export function assertScaffoldPlanDigest(plan) {
+    const { planDigest: _planDigest, ...body } = plan;
+    const expected = sha256Json(body);
+    if (plan.planDigest !== expected) {
+        throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", "Scaffolding Plan digest does not match its canonical content.");
+    }
+    if (plan.operations.length === 0 ||
+        plan.operations.length > MAX_SCAFFOLD_OPERATIONS) {
+        throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", "Scaffolding Plan must contain a bounded non-empty operation set.");
+    }
+    const adapterCapabilities = plan.requiredAdapterCapabilities;
+    if (adapterCapabilities.length !== 1 ||
+        adapterCapabilities[0] !== "materialize-file/v1") {
+        throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", "Scaffolding Plan requires unsupported adapter capabilities.");
+    }
+    const operationIds = new Set();
+    const operationPaths = new Set();
+    const targetPrefix = `${plan.target.path}/`;
+    let totalBytes = 0;
+    for (const operation of plan.operations) {
+        const bytes = Buffer.from(operation.after.contentBase64, "base64");
+        if (bytes.toString("base64") !== operation.after.contentBase64 ||
+            bytes.byteLength !== operation.after.size ||
+            sha256Bytes(bytes) !== operation.after.digest) {
+            throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", `Scaffolding operation content is invalid: ${operation.id}.`);
+        }
+        if (!operation.path.startsWith(targetPrefix)) {
+            throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", `Scaffolding operation escapes target ${plan.target.id}: ${operation.path}.`);
+        }
+        if (operationIds.has(operation.id) || operationPaths.has(operation.path)) {
+            throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", `Scaffolding operation identity or path is duplicated: ${operation.id}.`);
+        }
+        operationIds.add(operation.id);
+        operationPaths.add(operation.path);
+        totalBytes += bytes.byteLength;
+    }
+    if (totalBytes > MAX_SCAFFOLD_TOTAL_BYTES) {
+        throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", `Scaffolding Plan output exceeds ${MAX_SCAFFOLD_TOTAL_BYTES} bytes.`);
+    }
+}
+//# sourceMappingURL=plan-validation.js.map

package/dist/scaffolding/kernel/plan-validation.js.map

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

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

@@ -0,0 +1,35 @@
+import type { ScaffoldDiagnosticV1, ScaffoldOperationReceiptV1, ScaffoldPlanV1, ScaffoldReceiptOutcome, ScaffoldReceiptV1 } from "../contract/types.js";
+interface ScaffoldReceiptCandidateV1 {
+    readonly schemaVersion: number;
+    readonly protocolVersion: number;
+    readonly planDigest: string;
+    readonly adapter: {
+        readonly id: string;
+        readonly contractVersion: number;
+    };
+    readonly outcome: string;
+    readonly commit: {
+        readonly state: "committed" | "recovered" | "recovery-required" | "rejected";
+        readonly atomicity: "journaled-recoverable" | "memory-atomic";
+    };
+    readonly operations: readonly ScaffoldOperationReceiptV1[];
+    readonly diagnostics: readonly ScaffoldDiagnosticV1[];
+    readonly receiptDigest: string;
+}
+interface CreateScaffoldReceiptOptions {
+    readonly plan: ScaffoldPlanV1;
+    readonly adapterId: "foundation.filesystem/v1" | "foundation.memory/v1";
+    readonly outcome: ScaffoldReceiptOutcome;
+    readonly commitState: ScaffoldReceiptCandidateV1["commit"]["state"];
+    readonly atomicity: ScaffoldReceiptCandidateV1["commit"]["atomicity"];
+    readonly operations: readonly ScaffoldOperationReceiptV1[];
+    readonly diagnostics?: readonly ScaffoldDiagnosticV1[];
+}
+/**
+ * Verifies digest and semantic evidence for a schema-validated Receipt.
+ * Use `validateScaffoldReceipt` when the value comes from an untrusted source.
+ */
+export declare function assertScaffoldReceiptDigest(receipt: ScaffoldReceiptV1, plan?: ScaffoldPlanV1): void;
+export declare function createScaffoldReceipt(options: CreateScaffoldReceiptOptions): ScaffoldReceiptV1;
+export {};
+//# sourceMappingURL=receipt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"receipt.d.ts","sourceRoot":"","sources":["../../../src/scaffolding/kernel/receipt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,oBAAoB,EAEpB,0BAA0B,EAC1B,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAK9B,UAAU,0BAA0B;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;KAClC,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,KAAK,EACV,WAAW,GACX,WAAW,GACX,mBAAmB,GACnB,UAAU,CAAC;QACf,QAAQ,CAAC,SAAS,EAAE,uBAAuB,GAAG,eAAe,CAAC;KAC/D,CAAC;IACF,QAAQ,CAAC,UAAU,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAC3D,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACtD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,UAAU,4BAA4B;IACpC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,SAAS,EACd,0BAA0B,GAC1B,sBAAsB,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;IACpE,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,CAAC;IACtE,QAAQ,CAAC,UAAU,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAC3D,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACxD;AA8PD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,iBAAiB,EAC1B,IAAI,CAAC,EAAE,cAAc,GACpB,IAAI,CAEN;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,iBAAiB,CAuBnB"}