@agent-teams/engineering-foundation 0.4.1 → 0.6.0

package/dist/scaffolding/adapters/node/installed-foundation-version.js

@@ -0,0 +1,10 @@
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+export async function installedFoundationVersion() {
+    const manifest = JSON.parse(await readFile(fileURLToPath(new URL("../../../../package.json", import.meta.url)), "utf8"));
+    if (typeof manifest.version !== "string") {
+        throw new Error("Installed Foundation package version is unavailable.");
+    }
+    return manifest.version;
+}
+//# sourceMappingURL=installed-foundation-version.js.map

package/dist/scaffolding/adapters/node/installed-foundation-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installed-foundation-version.js","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/installed-foundation-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,0BAA0B;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB,MAAM,QAAQ,CACZ,aAAa,CAAC,IAAI,GAAG,CAAC,0BAA0B,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EACnE,MAAM,CACP,CACuB,CAAC;IAC3B,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC1B,CAAC"}

package/dist/scaffolding/adapters/node/node-input-loader.d.ts

@@ -0,0 +1,17 @@
+import type { ScaffoldCompilationInput, ScaffoldPlanV1, ScaffoldReadAssertionV1 } from "../../contract/types.js";
+export declare const MAX_SCAFFOLD_PLAN_BYTES: number;
+export declare function loadScaffoldCompilationInput(options: {
+    readonly consumerRoot: string;
+    readonly configPath: string;
+    readonly intentPath: string;
+    readonly foundationVersion: string;
+}): Promise<ScaffoldCompilationInput>;
+export declare function loadScaffoldCompilationInputFromIntent(options: {
+    readonly consumerRoot: string;
+    readonly configPath: string;
+    readonly foundationVersion: string;
+    readonly intent: unknown;
+}): Promise<ScaffoldCompilationInput>;
+export declare function readScaffoldPlanFile(consumerRoot: string, planPath: string): Promise<ScaffoldPlanV1>;
+export declare function inspectAuthorityReadSet(consumerRoot: string, readSet: readonly ScaffoldReadAssertionV1[]): Promise<boolean>;
+//# sourceMappingURL=node-input-loader.d.ts.map

package/dist/scaffolding/adapters/node/node-input-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-input-loader.d.ts","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/node-input-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,wBAAwB,EAExB,cAAc,EACd,uBAAuB,EAGxB,MAAM,yBAAyB,CAAC;AAYjC,eAAO,MAAM,uBAAuB,QAAmB,CAAC;AA+HxD,wBAAsB,4BAA4B,CAAC,OAAO,EAAE;IAC1D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA0BpC;AAoDD,wBAAsB,sCAAsC,CAAC,OAAO,EAAE;IACpE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAEpC;AAED,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CAYzB;AAED,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,SAAS,uBAAuB,EAAE,GAC1C,OAAO,CAAC,OAAO,CAAC,CAwBlB"}

package/dist/scaffolding/adapters/node/node-input-loader.js

@@ -0,0 +1,157 @@
+import { lstat, readFile, realpath } from "node:fs/promises";
+import { isAbsolute, relative, resolve, sep } from "node:path";
+import { sha256Bytes } from "../../kernel/canonical-json.js";
+import { assertScaffoldPlanDigest } from "../../kernel/plan-validation.js";
+import { ScaffoldError } from "../../scaffold-error.js";
+import { pathTraversesSymbolicLink } from "../../../filesystem-path-safety.js";
+import { assertSchema } from "../../../schema-catalog.js";
+import { assertRepositoryRelativePath, parseStrictYamlSource } from "../../../strict-yaml.js";
+const MAX_INPUT_BYTES = 1024 * 1024;
+export const MAX_SCAFFOLD_PLAN_BYTES = 32 * 1024 * 1024;
+function hasErrorCode(error, code) {
+    const visited = new Set();
+    let candidate = error;
+    while (candidate instanceof Error && !visited.has(candidate)) {
+        visited.add(candidate);
+        if ("code" in candidate &&
+            candidate.code === code) {
+            return true;
+        }
+        candidate = candidate.cause;
+    }
+    return false;
+}
+function isContained(root, candidate) {
+    const relation = relative(root, candidate);
+    return (relation === "" ||
+        (!relation.startsWith(`..${sep}`) && relation !== ".." && !isAbsolute(relation)));
+}
+async function readContainedRepositoryFile(consumerRoot, repositoryPath, phase, maxBytes = MAX_INPUT_BYTES) {
+    try {
+        assertRepositoryRelativePath(repositoryPath, phase);
+        const canonicalRoot = await realpath(consumerRoot);
+        const candidate = resolve(canonicalRoot, repositoryPath);
+        if (await pathTraversesSymbolicLink(canonicalRoot, candidate)) {
+            throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Scaffolding input cannot traverse a symbolic link: ${repositoryPath}.`);
+        }
+        const canonicalCandidate = await realpath(candidate);
+        if (!isContained(canonicalRoot, canonicalCandidate)) {
+            throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Scaffolding input escapes the consumer repository: ${repositoryPath}.`);
+        }
+        const metadata = await lstat(canonicalCandidate);
+        if (metadata.isSymbolicLink() ||
+            !metadata.isFile() ||
+            metadata.size > maxBytes) {
+            throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Scaffolding input must be a regular file no larger than ${maxBytes} bytes: ${repositoryPath}.`);
+        }
+        const bytes = await readFile(canonicalCandidate);
+        return {
+            path: repositoryPath,
+            bytes,
+            source: bytes.toString("utf8")
+        };
+    }
+    catch (error) {
+        if (error instanceof ScaffoldError) {
+            throw error;
+        }
+        throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Cannot read scaffolding input: ${repositoryPath}.`, [], { cause: error });
+    }
+}
+function assertion(file) {
+    const canonicalBytes = Buffer.from(file.source.replace(/\r\n?/gu, "\n"), "utf8");
+    return Object.freeze({
+        path: file.path,
+        state: "file",
+        digest: sha256Bytes(canonicalBytes),
+        size: canonicalBytes.byteLength
+    });
+}
+function mapCatalog(value) {
+    const raw = value;
+    return Object.freeze({
+        version: 1,
+        packages: Object.freeze(raw.packages.map((entry) => Object.freeze({
+            id: entry.id,
+            role: entry.role,
+            path: entry.path,
+            packageName: entry.package_name,
+            ...(entry.owner_document === undefined
+                ? {}
+                : { ownerDocument: entry.owner_document })
+        })))
+    });
+}
+export async function loadScaffoldCompilationInput(options) {
+    const [configFile, intentFile] = await Promise.all([
+        readContainedRepositoryFile(options.consumerRoot, options.configPath, "scaffolding-config"),
+        readContainedRepositoryFile(options.consumerRoot, options.intentPath, "scaffold-intent")
+    ]);
+    const configValue = parseStrictYamlSource(configFile.source, "scaffolding-config");
+    const intentValue = parseStrictYamlSource(intentFile.source, "scaffold-intent");
+    return loadScaffoldCompilationInputFromIntentInternal({
+        consumerRoot: options.consumerRoot,
+        configPath: options.configPath,
+        foundationVersion: options.foundationVersion,
+        intent: intentValue,
+        configFile,
+        configValue
+    });
+}
+async function loadScaffoldCompilationInputFromIntentInternal(options) {
+    const configFile = options.configFile ??
+        (await readContainedRepositoryFile(options.consumerRoot, options.configPath, "scaffolding-config"));
+    const configValue = options.configValue ??
+        parseStrictYamlSource(configFile.source, "scaffolding-config");
+    await Promise.all([
+        assertSchema("scaffolding-config/v1", configValue, "scaffolding-config"),
+        assertSchema("scaffold-intent/v1", options.intent, "scaffold-intent")
+    ]);
+    const config = configValue;
+    const catalogFile = await readContainedRepositoryFile(options.consumerRoot, config.targetCatalogPath, "scaffold-target-catalog");
+    const catalogValue = parseStrictYamlSource(catalogFile.source, "scaffold-target-catalog");
+    await assertSchema("scaffold-target-catalog/v1", catalogValue, "scaffold-target-catalog");
+    return Object.freeze({
+        foundationVersion: options.foundationVersion,
+        configPath: options.configPath,
+        config,
+        intent: options.intent,
+        catalog: mapCatalog(catalogValue),
+        authorityReadSet: Object.freeze([
+            assertion(configFile),
+            assertion(catalogFile)
+        ])
+    });
+}
+export async function loadScaffoldCompilationInputFromIntent(options) {
+    return loadScaffoldCompilationInputFromIntentInternal(options);
+}
+export async function readScaffoldPlanFile(consumerRoot, planPath) {
+    const planFile = await readContainedRepositoryFile(consumerRoot, planPath, "scaffold-plan", MAX_SCAFFOLD_PLAN_BYTES);
+    const value = parseStrictYamlSource(planFile.source, "scaffold-plan");
+    await assertSchema("scaffold-plan/v1", value, "scaffold-plan");
+    const plan = value;
+    assertScaffoldPlanDigest(plan);
+    return plan;
+}
+export async function inspectAuthorityReadSet(consumerRoot, readSet) {
+    for (const expected of readSet) {
+        let current;
+        try {
+            current = await readContainedRepositoryFile(consumerRoot, expected.path, "scaffold-apply-read-set");
+        }
+        catch (error) {
+            if (hasErrorCode(error, "ENOENT")) {
+                return false;
+            }
+            throw error;
+        }
+        const observed = assertion(current);
+        if (observed.size !== expected.size ||
+            observed.digest !== expected.digest) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=node-input-loader.js.map

package/dist/scaffolding/adapters/node/node-input-loader.js.map

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

package/dist/scaffolding/adapters/node/node-plan-authority.d.ts

@@ -0,0 +1,3 @@
+import type { ScaffoldPlanV1 } from "../../contract/types.js";
+export declare function assertPlanMatchesConsumerAuthority(consumerRoot: string, plan: ScaffoldPlanV1): Promise<void>;
+//# sourceMappingURL=node-plan-authority.d.ts.map

package/dist/scaffolding/adapters/node/node-plan-authority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-plan-authority.d.ts","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/node-plan-authority.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAO9D,wBAAsB,kCAAkC,CACtD,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/scaffolding/adapters/node/node-plan-authority.js

@@ -0,0 +1,18 @@
+import { createDefaultScaffoldRegistry } from "../../definitions/registry.js";
+import { compileScaffoldPlan } from "../../kernel/compiler.js";
+import { ScaffoldError } from "../../scaffold-error.js";
+import { installedFoundationVersion } from "./installed-foundation-version.js";
+import { loadScaffoldCompilationInputFromIntent } from "./node-input-loader.js";
+export async function assertPlanMatchesConsumerAuthority(consumerRoot, plan) {
+    const input = await loadScaffoldCompilationInputFromIntent({
+        consumerRoot,
+        configPath: plan.authority.configPath,
+        foundationVersion: await installedFoundationVersion(),
+        intent: plan.intent
+    });
+    const expected = compileScaffoldPlan(input, createDefaultScaffoldRegistry());
+    if (expected.planDigest !== plan.planDigest) {
+        throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", "Scaffolding Plan was not produced by the closed compiler from current consumer authority.");
+    }
+}
+//# sourceMappingURL=node-plan-authority.js.map

package/dist/scaffolding/adapters/node/node-plan-authority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-plan-authority.js","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/node-plan-authority.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,sCAAsC,EAAE,MAAM,wBAAwB,CAAC;AAEhF,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,YAAoB,EACpB,IAAoB;IAEpB,MAAM,KAAK,GAAG,MAAM,sCAAsC,CAAC;QACzD,YAAY;QACZ,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU;QACrC,iBAAiB,EAAE,MAAM,0BAA0B,EAAE;QACrD,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,EAAE,6BAA6B,EAAE,CAAC,CAAC;IAC7E,IAAI,QAAQ,CAAC,UAAU,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,IAAI,aAAa,CACrB,uBAAuB,EACvB,2FAA2F,CAC5F,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/scaffolding/adapters/node/node-receipt-validator.d.ts

@@ -0,0 +1,4 @@
+import type { ScaffoldPlanV1, ScaffoldReceiptV1 } from "../../contract/types.js";
+/** Validates an untrusted Receipt against its schema, digest, and optional Plan. */
+export declare function validateScaffoldReceipt(receipt: unknown, plan?: ScaffoldPlanV1): Promise<ScaffoldReceiptV1>;
+//# sourceMappingURL=node-receipt-validator.d.ts.map

package/dist/scaffolding/adapters/node/node-receipt-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-receipt-validator.d.ts","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/node-receipt-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AAIjC,oFAAoF;AACpF,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAK5B"}

package/dist/scaffolding/adapters/node/node-receipt-validator.js

@@ -0,0 +1,10 @@
+import { assertScaffoldReceiptDigest } from "../../kernel/receipt.js";
+import { assertSchema } from "../../../schema-catalog.js";
+/** Validates an untrusted Receipt against its schema, digest, and optional Plan. */
+export async function validateScaffoldReceipt(receipt, plan) {
+    await assertSchema("scaffold-receipt/v1", receipt, "scaffold-receipt");
+    const validated = receipt;
+    assertScaffoldReceiptDigest(validated, plan);
+    return validated;
+}
+//# sourceMappingURL=node-receipt-validator.js.map

package/dist/scaffolding/adapters/node/node-receipt-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-receipt-validator.js","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/node-receipt-validator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAgB,EAChB,IAAqB;IAErB,MAAM,YAAY,CAAC,qBAAqB,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,OAA4B,CAAC;IAC/C,2BAA2B,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC7C,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/scaffolding/cli-command.d.ts

@@ -0,0 +1,8 @@
+export interface ScaffoldCliArguments {
+    readonly command: string;
+    readonly positional: readonly string[];
+    readonly consumerRoot: string;
+    readonly configPath: string;
+}
+export declare function runScaffoldingCliCommand(parsed: ScaffoldCliArguments, json: boolean): Promise<boolean>;
+//# sourceMappingURL=cli-command.d.ts.map

package/dist/scaffolding/cli-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command.d.ts","sourceRoot":"","sources":["../../src/scaffolding/cli-command.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAkBD,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,OAAO,CAAC,CAuDlB"}

package/dist/scaffolding/cli-command.js

@@ -0,0 +1,60 @@
+import { applyFilesystemScaffold, readScaffoldPlanFile, recoverFilesystemScaffold } from "./index.js";
+import { ScaffoldError } from "./scaffold-error.js";
+import { planScaffoldFromFile } from "./service.js";
+function renderPlan(plan) {
+    return `Scaffold Plan: ${plan.planDigest}\nProject: ${plan.projectId}\nComposition: ${plan.composition.id}\nTarget: ${plan.target.id} -> ${plan.target.path}\nOperations: ${plan.operations.length}\n`;
+}
+function renderReceipt(receipt) {
+    return `Scaffold Receipt: ${receipt.receiptDigest}\nPlan: ${receipt.planDigest}\nOutcome: ${receipt.outcome}\nOperations: ${receipt.operations.length}\n`;
+}
+function exitCode(receipt) {
+    return receipt.outcome === "applied" ||
+        receipt.outcome === "already-applied" ||
+        receipt.outcome === "failed-recovered"
+        ? 0
+        : 1;
+}
+export async function runScaffoldingCliCommand(parsed, json) {
+    switch (parsed.command) {
+        case "scaffold-apply": {
+            const planPath = parsed.positional[0];
+            if (planPath === undefined) {
+                throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", "scaffold-apply requires a repository-relative Plan path.");
+            }
+            const plan = await readScaffoldPlanFile(parsed.consumerRoot, planPath);
+            const receipt = await applyFilesystemScaffold(parsed.consumerRoot, plan);
+            process.stdout.write(json ? `${JSON.stringify(receipt, null, 2)}\n` : renderReceipt(receipt));
+            process.exitCode = exitCode(receipt);
+            return true;
+        }
+        case "scaffold-plan": {
+            const intentPath = parsed.positional[0];
+            if (intentPath === undefined) {
+                throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", "scaffold-plan requires a repository-relative Intent path.");
+            }
+            const plan = await planScaffoldFromFile({
+                consumerRoot: parsed.consumerRoot,
+                intentPath,
+                configPath: parsed.configPath
+            });
+            process.stdout.write(json ? `${JSON.stringify(plan, null, 2)}\n` : renderPlan(plan));
+            return true;
+        }
+        case "scaffold-recover": {
+            const receipt = await recoverFilesystemScaffold(parsed.consumerRoot);
+            if (receipt === undefined) {
+                process.stdout.write(json
+                    ? `${JSON.stringify({ outcome: "no-pending-transaction" }, null, 2)}\n`
+                    : "No pending scaffolding transaction.\n");
+            }
+            else {
+                process.stdout.write(json ? `${JSON.stringify(receipt, null, 2)}\n` : renderReceipt(receipt));
+                process.exitCode = exitCode(receipt);
+            }
+            return true;
+        }
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=cli-command.js.map

package/dist/scaffolding/cli-command.js.map

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

package/dist/scaffolding/contract/types.d.ts

@@ -0,0 +1,296 @@
+export type JsonPrimitive = boolean | null | number | string;
+export type JsonValue = JsonPrimitive | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+export type JsonObject = {
+    readonly [key: string]: JsonValue;
+};
+export type Sha256Digest = `sha256:${string}`;
+export type RepositoryPath = string;
+export interface DefinitionRef {
+    readonly id: string;
+    readonly contractVersion: number;
+}
+export interface ConfiguredDefinition {
+    readonly ref: DefinitionRef;
+    readonly parameters?: JsonObject;
+}
+export interface ScaffoldCompositionV1 {
+    readonly id: string;
+    readonly scaffoldProfile: ConfiguredDefinition;
+    readonly recipe: ConfiguredDefinition;
+    readonly targetRoles: readonly string[];
+    readonly fixedRecipeParameters?: JsonObject;
+    readonly defaultRecipeParameters?: JsonObject;
+    readonly facets?: {
+        readonly fixed?: readonly ConfiguredDefinition[];
+        readonly default?: readonly ConfiguredDefinition[];
+        readonly allowed?: readonly DefinitionRef[];
+    };
+    readonly policies: readonly ConfiguredDefinition[];
+}
+export interface ScaffoldingConfigV1 {
+    readonly schemaVersion: 1;
+    readonly projectId: string;
+    readonly targetCatalogPath: RepositoryPath;
+    readonly compositions: readonly ScaffoldCompositionV1[];
+}
+export interface ScaffoldIntentV1 {
+    readonly schemaVersion: 1;
+    readonly compositionId: string;
+    readonly targetRef: string;
+    readonly recipeParameters?: JsonObject;
+    readonly facets?: readonly ConfiguredDefinition[];
+}
+export interface ScaffoldTargetV1 {
+    readonly id: string;
+    readonly role: string;
+    readonly path: RepositoryPath;
+    readonly packageName: string;
+    readonly ownerDocument?: string;
+}
+export interface ScaffoldTargetCatalogV1 {
+    readonly version: 1;
+    readonly packages: readonly ScaffoldTargetV1[];
+}
+export interface ScaffoldDiagnosticV1 {
+    readonly ruleId: string;
+    readonly severity: "error" | "info" | "warning";
+    readonly phase: "apply" | "composition" | "input" | "planning" | "policy" | "recovery";
+    readonly subject: string;
+    readonly message: string;
+    readonly remediation: string;
+}
+export interface ScaffoldReadAssertionV1 {
+    readonly path: RepositoryPath;
+    readonly state: "file";
+    readonly digest: Sha256Digest;
+    readonly size: number;
+}
+export interface MaterializeFileOperationV1 {
+    readonly id: string;
+    readonly kind: "materialize-file";
+    readonly path: RepositoryPath;
+    readonly precondition: {
+        readonly state: "absent";
+    };
+    readonly after: {
+        readonly digest: Sha256Digest;
+        readonly size: number;
+        readonly mode: "0644";
+        readonly mediaType: string;
+        readonly contentBase64: string;
+    };
+    readonly causes: readonly string[];
+}
+export interface ScaffoldPlanV1 {
+    readonly schemaVersion: 1;
+    readonly protocolVersion: 1;
+    readonly compiler: {
+        readonly id: "@agent-teams/engineering-foundation";
+        readonly version: string;
+    };
+    readonly projectId: string;
+    readonly authority: {
+        readonly configPath: RepositoryPath;
+        readonly targetCatalogPath: RepositoryPath;
+    };
+    readonly intent: ScaffoldIntentV1;
+    readonly intentDigest: Sha256Digest;
+    readonly authoritySnapshotDigest: Sha256Digest;
+    readonly composition: {
+        readonly id: string;
+        readonly scaffoldProfile: DefinitionRef;
+        readonly recipe: DefinitionRef;
+        readonly facets: readonly DefinitionRef[];
+        readonly policies: readonly DefinitionRef[];
+    };
+    readonly definitions: readonly {
+        readonly kind: "facet" | "policy" | "recipe" | "scaffold-profile";
+        readonly ref: DefinitionRef;
+        readonly contractDigest: Sha256Digest;
+    }[];
+    readonly resolved: {
+        readonly profileParameters: JsonObject;
+        readonly recipeParameters: JsonObject;
+        readonly facets: readonly {
+            readonly ref: DefinitionRef;
+            readonly parameters: JsonObject;
+        }[];
+        readonly policies: readonly {
+            readonly ref: DefinitionRef;
+            readonly parameters: JsonObject;
+            readonly outcome: "passed";
+        }[];
+    };
+    readonly target: ScaffoldTargetV1;
+    readonly readSet: readonly ScaffoldReadAssertionV1[];
+    readonly requiredAdapterCapabilities: readonly ["materialize-file/v1"];
+    readonly operations: readonly MaterializeFileOperationV1[];
+    readonly diagnostics: readonly ScaffoldDiagnosticV1[];
+    readonly planDigest: Sha256Digest;
+}
+export type ScaffoldOperationOutcome = "already-satisfied" | "applied" | "conflict" | "not-applied" | "recovered";
+export interface ScaffoldOperationReceiptV1 {
+    readonly operationId: string;
+    readonly path: RepositoryPath;
+    readonly outcome: ScaffoldOperationOutcome;
+    readonly resultDigest?: Sha256Digest;
+}
+export type ScaffoldReceiptOutcome = "already-applied" | "applied" | "failed-recovered" | "recovery-required" | "rejected";
+export interface ScaffoldReceiptCommonV1 {
+    readonly schemaVersion: 1;
+    readonly protocolVersion: 1;
+    readonly planDigest: Sha256Digest;
+    readonly diagnostics: readonly ScaffoldDiagnosticV1[];
+    readonly receiptDigest: Sha256Digest;
+}
+export type ScaffoldReceiptV1 = (ScaffoldReceiptCommonV1 & {
+    readonly outcome: "applied";
+    readonly operations: readonly [
+        ScaffoldOperationReceiptV1 & {
+            readonly outcome: "already-satisfied" | "applied";
+            readonly resultDigest: Sha256Digest;
+        },
+        ...(ScaffoldOperationReceiptV1 & {
+            readonly outcome: "already-satisfied" | "applied";
+            readonly resultDigest: Sha256Digest;
+        })[]
+    ];
+} & ({
+    readonly adapter: {
+        readonly id: "foundation.filesystem/v1";
+        readonly contractVersion: 1;
+    };
+    readonly commit: {
+        readonly state: "committed";
+        readonly atomicity: "journaled-recoverable";
+    };
+} | {
+    readonly adapter: {
+        readonly id: "foundation.memory/v1";
+        readonly contractVersion: 1;
+    };
+    readonly commit: {
+        readonly state: "committed";
+        readonly atomicity: "memory-atomic";
+    };
+})) | (ScaffoldReceiptCommonV1 & {
+    readonly outcome: "already-applied";
+    readonly operations: readonly [
+        ScaffoldOperationReceiptV1 & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        },
+        ...(ScaffoldOperationReceiptV1 & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        })[]
+    ];
+} & ({
+    readonly adapter: {
+        readonly id: "foundation.filesystem/v1";
+        readonly contractVersion: 1;
+    };
+    readonly commit: {
+        readonly state: "committed";
+        readonly atomicity: "journaled-recoverable";
+    };
+} | {
+    readonly adapter: {
+        readonly id: "foundation.memory/v1";
+        readonly contractVersion: 1;
+    };
+    readonly commit: {
+        readonly state: "committed";
+        readonly atomicity: "memory-atomic";
+    };
+})) | (ScaffoldReceiptCommonV1 & {
+    readonly adapter: {
+        readonly id: "foundation.filesystem/v1";
+        readonly contractVersion: 1;
+    };
+    readonly outcome: "failed-recovered";
+    readonly commit: {
+        readonly state: "recovered";
+        readonly atomicity: "journaled-recoverable";
+    };
+    readonly operations: readonly [
+        ScaffoldOperationReceiptV1 & {
+            readonly outcome: "already-satisfied" | "recovered";
+            readonly resultDigest: Sha256Digest;
+        },
+        ...(ScaffoldOperationReceiptV1 & {
+            readonly outcome: "already-satisfied" | "recovered";
+            readonly resultDigest: Sha256Digest;
+        })[]
+    ];
+}) | (ScaffoldReceiptCommonV1 & {
+    readonly adapter: {
+        readonly id: "foundation.filesystem/v1";
+        readonly contractVersion: 1;
+    };
+    readonly outcome: "recovery-required";
+    readonly commit: {
+        readonly state: "recovery-required";
+        readonly atomicity: "journaled-recoverable";
+    };
+    readonly operations: readonly [
+        (ScaffoldOperationReceiptV1 & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        }) | (ScaffoldOperationReceiptV1 & {
+            readonly outcome: "conflict" | "not-applied";
+            readonly resultDigest?: never;
+        }),
+        ...((ScaffoldOperationReceiptV1 & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        }) | (ScaffoldOperationReceiptV1 & {
+            readonly outcome: "conflict" | "not-applied";
+            readonly resultDigest?: never;
+        }))[]
+    ];
+}) | (ScaffoldReceiptCommonV1 & {
+    readonly outcome: "rejected";
+    readonly operations: readonly ((ScaffoldOperationReceiptV1 & {
+        readonly outcome: "already-satisfied";
+        readonly resultDigest: Sha256Digest;
+    }) | (ScaffoldOperationReceiptV1 & {
+        readonly outcome: "conflict" | "not-applied";
+        readonly resultDigest?: never;
+    }))[];
+} & ({
+    readonly adapter: {
+        readonly id: "foundation.filesystem/v1";
+        readonly contractVersion: 1;
+    };
+    readonly commit: {
+        readonly state: "rejected";
+        readonly atomicity: "journaled-recoverable";
+    };
+} | {
+    readonly adapter: {
+        readonly id: "foundation.memory/v1";
+        readonly contractVersion: 1;
+    };
+    readonly commit: {
+        readonly state: "rejected";
+        readonly atomicity: "memory-atomic";
+    };
+}));
+export interface ScaffoldCompilationInput {
+    readonly foundationVersion: string;
+    readonly configPath: RepositoryPath;
+    readonly config: ScaffoldingConfigV1;
+    readonly intent: ScaffoldIntentV1;
+    readonly catalog: ScaffoldTargetCatalogV1;
+    readonly authorityReadSet: readonly ScaffoldReadAssertionV1[];
+}
+export interface ScaffoldFileContribution {
+    readonly path: RepositoryPath;
+    readonly mediaType: string;
+    readonly content: string;
+    readonly causes: readonly string[];
+}
+//# sourceMappingURL=types.d.ts.map