@agent-teams/engineering-foundation 0.7.0 → 0.9.0

package/dist/scaffolding/adapters/node/node-owner-document-resolver.js

@@ -0,0 +1,161 @@
+import { lstat, opendir, realpath } from "node:fs/promises";
+import { isAbsolute, relative, resolve, sep } from "node:path";
+import { sha256Json } from "../../kernel/canonical-json.js";
+import { ScaffoldError } from "../../scaffold-error.js";
+import { pathTraversesSymbolicLink } from "../../../filesystem-path-safety.js";
+import { assertRepositoryRelativePath, parseStrictYamlSource } from "../../../strict-yaml.js";
+import { readContainedRepositoryFile } from "./node-repository-file.js";
+import { ScaffoldAuthorityStaleError } from "./node-authority-error.js";
+const MAX_AUTHORITY_DOCUMENTS = 4096;
+const MAX_AUTHORITY_DOCUMENT_ENTRIES = 16_384;
+const MAX_AUTHORITY_DOCUMENT_DEPTH = 32;
+const MAX_AUTHORITY_METADATA_LENGTH = 160;
+const OWNER_DOCUMENT_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._/-]*$/u;
+const OWNER_DOCUMENT_STATUS_PATTERN = /^[a-z0-9][a-z0-9._/-]*$/u;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isContained(root, candidate) {
+    const relation = relative(root, candidate);
+    return (relation === "" ||
+        (!relation.startsWith(`..${sep}`) &&
+            relation !== ".." &&
+            !isAbsolute(relation)));
+}
+function compareStrings(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function parseOwnerFrontmatter(source) {
+    const normalized = source.replace(/\r\n?/gu, "\n");
+    if (!normalized.startsWith("---\n")) {
+        throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", "Authority documents must start with strict YAML frontmatter.");
+    }
+    const end = normalized.indexOf("\n---\n", 4);
+    if (end === -1) {
+        throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", "Authority document YAML frontmatter must have a closing delimiter.");
+    }
+    const parsed = parseStrictYamlSource(normalized.slice(4, end), "scaffold-owner-document");
+    if (!isRecord(parsed) ||
+        typeof parsed.id !== "string" ||
+        typeof parsed.status !== "string" ||
+        parsed.id.length > MAX_AUTHORITY_METADATA_LENGTH ||
+        parsed.status.length > MAX_AUTHORITY_METADATA_LENGTH ||
+        !OWNER_DOCUMENT_ID_PATTERN.test(parsed.id) ||
+        !OWNER_DOCUMENT_STATUS_PATTERN.test(parsed.status)) {
+        throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", "Authority document frontmatter must contain normalized id and status strings.");
+    }
+    return Object.freeze({ id: parsed.id, status: parsed.status });
+}
+async function listMarkdownFilesInRoot(options) {
+    assertRepositoryRelativePath(options.documentRoot, "scaffold-owner-document-root");
+    const absoluteRoot = resolve(options.canonicalConsumerRoot, options.documentRoot);
+    if ((await pathTraversesSymbolicLink(options.canonicalConsumerRoot, absoluteRoot)) ||
+        !isContained(options.canonicalConsumerRoot, await realpath(absoluteRoot)) ||
+        !(await lstat(absoluteRoot)).isDirectory()) {
+        throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Authority document root must be a contained regular directory: ${options.documentRoot}.`);
+    }
+    const paths = [];
+    const walk = async (absoluteDirectory, repositoryDirectory, depth) => {
+        if (depth > MAX_AUTHORITY_DOCUMENT_DEPTH) {
+            throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Authority document roots cannot exceed ${MAX_AUTHORITY_DOCUMENT_DEPTH} directory levels.`);
+        }
+        const entries = [];
+        const directory = await opendir(absoluteDirectory);
+        for await (const entry of directory) {
+            options.budget.entriesVisited += 1;
+            if (options.budget.entriesVisited > MAX_AUTHORITY_DOCUMENT_ENTRIES) {
+                throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Authority document roots cannot contain more than ${MAX_AUTHORITY_DOCUMENT_ENTRIES} entries.`);
+            }
+            entries.push(entry);
+        }
+        entries.sort((left, right) => compareStrings(left.name, right.name));
+        for (const entry of entries) {
+            const repositoryPath = `${repositoryDirectory}/${entry.name}`;
+            const absolutePath = resolve(absoluteDirectory, entry.name);
+            if (entry.isSymbolicLink()) {
+                throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Authority document roots cannot contain symbolic links: ${repositoryPath}.`);
+            }
+            if (entry.isDirectory()) {
+                await walk(absolutePath, repositoryPath, depth + 1);
+            }
+            else if (entry.isFile() && entry.name.endsWith(".md")) {
+                options.budget.documentsVisited += 1;
+                if (options.budget.documentsVisited > MAX_AUTHORITY_DOCUMENTS) {
+                    throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Authority document roots cannot contain more than ${MAX_AUTHORITY_DOCUMENTS} Markdown files.`);
+                }
+                paths.push(repositoryPath);
+            }
+            else if (!entry.isFile()) {
+                throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Authority document roots may contain only regular files and directories: ${repositoryPath}.`);
+            }
+        }
+    };
+    await walk(absoluteRoot, options.documentRoot, 0);
+    return Object.freeze(paths);
+}
+async function listAuthorityDocumentPaths(consumerRoot, documentRoots) {
+    try {
+        const normalizedRoots = documentRoots
+            .map((documentRoot) => documentRoot.toLowerCase())
+            .toSorted(compareStrings);
+        for (const [index, root] of normalizedRoots.entries()) {
+            for (const candidate of normalizedRoots.slice(index + 1)) {
+                if (root === candidate ||
+                    root.startsWith(`${candidate}/`) ||
+                    candidate.startsWith(`${root}/`)) {
+                    throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", "Authority document roots cannot overlap or differ only by case.");
+                }
+            }
+        }
+        const canonicalConsumerRoot = await realpath(consumerRoot);
+        const budget = { entriesVisited: 0, documentsVisited: 0 };
+        const paths = [];
+        for (const documentRoot of documentRoots.toSorted(compareStrings)) {
+            paths.push(...(await listMarkdownFilesInRoot({
+                canonicalConsumerRoot,
+                documentRoot,
+                budget
+            })));
+        }
+        paths.sort(compareStrings);
+        const exact = new Set(paths);
+        const caseFolded = new Set(paths.map((path) => path.toLowerCase()));
+        if (exact.size !== paths.length || caseFolded.size !== paths.length) {
+            throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", "Authority document roots overlap or contain case-folding path collisions.");
+        }
+        return Object.freeze(paths);
+    }
+    catch (error) {
+        if (error instanceof ScaffoldError) {
+            throw error;
+        }
+        throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", "Cannot index configured authority document roots.", [], { cause: error });
+    }
+}
+export async function resolveOwnerDocument(options) {
+    if (!OWNER_DOCUMENT_ID_PATTERN.test(options.ownerDocumentId)) {
+        throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", "Owner document ID must be a normalized authority identifier.");
+    }
+    const paths = await listAuthorityDocumentPaths(options.consumerRoot, options.documentRoots);
+    const index = [];
+    const matches = [];
+    for (const path of paths) {
+        const file = await readContainedRepositoryFile(options.consumerRoot, path, "scaffold-owner-document");
+        const metadata = parseOwnerFrontmatter(file.source);
+        index.push({ path: file.path, id: metadata.id, status: metadata.status });
+        if (metadata.id === options.ownerDocumentId) {
+            matches.push({ file, metadata });
+        }
+    }
+    if (matches.length !== 1) {
+        throw new ScaffoldAuthorityStaleError(`Owner document must resolve exactly once from configured roots: ${options.ownerDocumentId}.`);
+    }
+    const selected = matches[0];
+    const indexDigest = sha256Json(index);
+    return Object.freeze({
+        ...selected.metadata,
+        file: selected.file,
+        indexDigest
+    });
+}
+//# sourceMappingURL=node-owner-document-resolver.js.map

package/dist/scaffolding/adapters/node/node-owner-document-resolver.js.map

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

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

@@ -1,3 +1,15 @@
-import type { ScaffoldPlanV1 } from "../../contract/types.js";
-export declare function assertPlanMatchesConsumerAuthority(consumerRoot: string, plan: ScaffoldPlanV1): Promise<void>;
+import type { AuthorityScaffoldPlan } from "../../contract/types.js";
+import { type ScaffoldAuthorityInputFaultInjector } from "./node-authority-input-loader.js";
+export type ScaffoldAuthorityAssessment = {
+    readonly state: "current";
+} | {
+    readonly state: "stale";
+} | {
+    readonly state: "unverifiable";
+};
+/**
+ * A source-bound authority change is stale only when the closed compiler can prove it.
+ * Input, parser, and filesystem failures are deliberately kept unverifiable.
+ */
+export declare function assessScaffoldPlanAuthority(consumerRoot: string, plan: AuthorityScaffoldPlan, faultInjector?: ScaffoldAuthorityInputFaultInjector): Promise<ScaffoldAuthorityAssessment>;
 //# sourceMappingURL=node-plan-authority.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"node-plan-authority.d.ts","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/node-plan-authority.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAKrE,OAAO,EAEL,KAAK,mCAAmC,EACzC,MAAM,kCAAkC,CAAC;AAE1C,MAAM,MAAM,2BAA2B,GACnC;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AA2BvC;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,qBAAqB,EAC3B,aAAa,CAAC,EAAE,mCAAmC,GAClD,OAAO,CAAC,2BAA2B,CAAC,CAgBtC"}

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

@@ -1,18 +1,37 @@
-import { createDefaultScaffoldRegistry } from "../../definitions/registry.js";
-import { compileScaffoldPlan } from "../../kernel/compiler.js";
-import { ScaffoldError } from "../../scaffold-error.js";
+import { createAuthorityScaffoldRegistry } from "../../definitions/registry.js";
+import { compileAuthorityScaffoldPlan } from "../../kernel/authority-compiler.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({
+import { ScaffoldAuthorityStaleError } from "./node-authority-error.js";
+import { loadAuthorityScaffoldCompilationInputFromIntent } from "./node-authority-input-loader.js";
+async function assertPlanMatchesConsumerAuthority(consumerRoot, plan, authorityFaultInjector) {
+    const input = await loadAuthorityScaffoldCompilationInputFromIntent({
         consumerRoot,
         configPath: plan.authority.configPath,
         foundationVersion: await installedFoundationVersion(),
-        intent: plan.intent
+        intent: plan.intent,
+        ...(authorityFaultInjector === undefined
+            ? {}
+            : { faultInjector: authorityFaultInjector })
     });
-    const expected = compileScaffoldPlan(input, createDefaultScaffoldRegistry());
+    const expected = compileAuthorityScaffoldPlan(input, createAuthorityScaffoldRegistry());
     if (expected.planDigest !== plan.planDigest) {
-        throw new ScaffoldError("SCAFFOLD_PLAN_INVALID", "Scaffolding Plan was not produced by the closed compiler from current consumer authority.");
+        throw new ScaffoldAuthorityStaleError("Scaffolding Plan was not produced by the closed compiler from current consumer authority.");
+    }
+}
+/**
+ * A source-bound authority change is stale only when the closed compiler can prove it.
+ * Input, parser, and filesystem failures are deliberately kept unverifiable.
+ */
+export async function assessScaffoldPlanAuthority(consumerRoot, plan, faultInjector) {
+    try {
+        await assertPlanMatchesConsumerAuthority(consumerRoot, plan, faultInjector);
+        return { state: "current" };
+    }
+    catch (error) {
+        if (error instanceof ScaffoldAuthorityStaleError) {
+            return { state: "stale" };
+        }
+        return { state: "unverifiable" };
     }
 }
 //# sourceMappingURL=node-plan-authority.js.map

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

@@ -1 +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"}
+{"version":3,"file":"node-plan-authority.js","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/node-plan-authority.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAClF,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EACL,+CAA+C,EAEhD,MAAM,kCAAkC,CAAC;AAO1C,KAAK,UAAU,kCAAkC,CAC/C,YAAoB,EACpB,IAA2B,EAC3B,sBAA4D;IAE5D,MAAM,KAAK,GAAG,MAAM,+CAA+C,CAAC;QAClE,YAAY;QACZ,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU;QACrC,iBAAiB,EAAE,MAAM,0BAA0B,EAAE;QACrD,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,CAAC,sBAAsB,KAAK,SAAS;YACtC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,aAAa,EAAE,sBAAsB,EAAE,CAAC;KAC/C,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,4BAA4B,CAC3C,KAAK,EACL,+BAA+B,EAAE,CAClC,CAAC;IACF,IAAI,QAAQ,CAAC,UAAU,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,IAAI,2BAA2B,CACnC,2FAA2F,CAC5F,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,YAAoB,EACpB,IAA2B,EAC3B,aAAmD;IAEnD,IAAI,CAAC;QACH,MAAM,kCAAkC,CACtC,YAAY,EACZ,IAAI,EACJ,aAAa,CACd,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IACE,KAAK,YAAY,2BAA2B,EAC5C,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAC5B,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IACnC,CAAC;AACH,CAAC"}

package/dist/scaffolding/adapters/node/node-repository-file.d.ts

@@ -0,0 +1,9 @@
+import type { ScaffoldReadAssertionV1 } from "../../contract/types.js";
+export interface LoadedRepositoryFile {
+    readonly path: string;
+    readonly bytes: Uint8Array;
+    readonly source: string;
+}
+export declare function readContainedRepositoryFile(consumerRoot: string, repositoryPath: string, phase: string, maxBytes?: number): Promise<LoadedRepositoryFile>;
+export declare function assertion(file: LoadedRepositoryFile): ScaffoldReadAssertionV1;
+//# sourceMappingURL=node-repository-file.d.ts.map

package/dist/scaffolding/adapters/node/node-repository-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-repository-file.d.ts","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/node-repository-file.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AASvE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAuBD,wBAAsB,2BAA2B,CAC/C,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,QAAQ,SAAkB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAmD/B;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,oBAAoB,GAAG,uBAAuB,CAW7E"}

package/dist/scaffolding/adapters/node/node-repository-file.js

@@ -0,0 +1,65 @@
+import { realpath } from "node:fs/promises";
+import { isAbsolute, relative, resolve, sep } from "node:path";
+import { sha256Bytes } from "../../kernel/canonical-json.js";
+import { ScaffoldError } from "../../scaffold-error.js";
+import { pathTraversesSymbolicLink } from "../../../filesystem-path-safety.js";
+import { assertRepositoryRelativePath } from "../../../strict-yaml.js";
+import { readBoundedRegularFile } from "./filesystem-file-identity.js";
+const MAX_INPUT_BYTES = 1024 * 1024;
+function isContained(root, candidate) {
+    const relation = relative(root, candidate);
+    return (relation === "" ||
+        (!relation.startsWith(`..${sep}`) && relation !== ".." && !isAbsolute(relation)));
+}
+function decodeUtf8(bytes, repositoryPath) {
+    try {
+        return new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(bytes);
+    }
+    catch (error) {
+        throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Scaffolding input must contain valid UTF-8: ${repositoryPath}.`, [], { cause: error });
+    }
+}
+export 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 result = await readBoundedRegularFile(canonicalCandidate, maxBytes);
+        if (result.outcome === "invalid") {
+            throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Scaffolding input must be a regular file no larger than ${maxBytes} bytes: ${repositoryPath}.`);
+        }
+        if (result.outcome === "changed" ||
+            (await realpath(candidate)) !== canonicalCandidate ||
+            (await pathTraversesSymbolicLink(canonicalRoot, candidate))) {
+            throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Scaffolding input changed while it was being read: ${repositoryPath}.`);
+        }
+        return {
+            path: repositoryPath,
+            bytes: result.bytes,
+            source: decodeUtf8(result.bytes, repositoryPath)
+        };
+    }
+    catch (error) {
+        if (error instanceof ScaffoldError) {
+            throw error;
+        }
+        throw new ScaffoldError("SCAFFOLD_INPUT_INVALID", `Cannot read scaffolding input: ${repositoryPath}.`, [], { cause: error });
+    }
+}
+export 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
+    });
+}
+//# sourceMappingURL=node-repository-file.js.map

package/dist/scaffolding/adapters/node/node-repository-file.js.map

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

package/dist/scaffolding/adapters/node/node-scaffold-limits.d.ts

@@ -0,0 +1,2 @@
+export declare const MAX_SCAFFOLD_PLAN_BYTES: number;
+//# sourceMappingURL=node-scaffold-limits.d.ts.map

package/dist/scaffolding/adapters/node/node-scaffold-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-scaffold-limits.d.ts","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/node-scaffold-limits.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,QAAmB,CAAC"}

package/dist/scaffolding/adapters/node/node-scaffold-limits.js

@@ -0,0 +1,2 @@
+export const MAX_SCAFFOLD_PLAN_BYTES = 32 * 1024 * 1024;
+//# sourceMappingURL=node-scaffold-limits.js.map

package/dist/scaffolding/adapters/node/node-scaffold-limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-scaffold-limits.js","sourceRoot":"","sources":["../../../../src/scaffolding/adapters/node/node-scaffold-limits.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC"}

package/dist/scaffolding/authority-service.d.ts

@@ -0,0 +1,7 @@
+import type { AuthorityScaffoldPlan } from "./contract/types.js";
+export declare function planAuthorityScaffoldFromFile(options: {
+    readonly consumerRoot: string;
+    readonly intentPath: string;
+    readonly configPath?: string;
+}): Promise<AuthorityScaffoldPlan>;
+//# sourceMappingURL=authority-service.d.ts.map

package/dist/scaffolding/authority-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authority-service.d.ts","sourceRoot":"","sources":["../../src/scaffolding/authority-service.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAKjE,wBAAsB,6BAA6B,CAAC,OAAO,EAAE;IAC3D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAQjC"}

package/dist/scaffolding/authority-service.js

@@ -0,0 +1,15 @@
+import { loadAuthorityScaffoldCompilationInputFromFile } from "./adapters/node/node-authority-input-loader.js";
+import { installedFoundationVersion } from "./adapters/node/installed-foundation-version.js";
+import { createAuthorityScaffoldRegistry } from "./definitions/registry.js";
+import { compileAuthorityScaffoldPlan } from "./kernel/authority-compiler.js";
+import { DEFAULT_SCAFFOLDING_CONFIG_PATH } from "./scaffold-defaults.js";
+export async function planAuthorityScaffoldFromFile(options) {
+    const input = await loadAuthorityScaffoldCompilationInputFromFile({
+        consumerRoot: options.consumerRoot,
+        configPath: options.configPath ?? DEFAULT_SCAFFOLDING_CONFIG_PATH,
+        intentPath: options.intentPath,
+        foundationVersion: await installedFoundationVersion()
+    });
+    return compileAuthorityScaffoldPlan(input, createAuthorityScaffoldRegistry());
+}
+//# sourceMappingURL=authority-service.js.map

package/dist/scaffolding/authority-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authority-service.js","sourceRoot":"","sources":["../../src/scaffolding/authority-service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6CAA6C,EAC9C,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAE7F,OAAO,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAEzE,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,OAInD;IACC,MAAM,KAAK,GAAG,MAAM,6CAA6C,CAAC;QAChE,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,+BAA+B;QACjE,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,iBAAiB,EAAE,MAAM,0BAA0B,EAAE;KACtD,CAAC,CAAC;IACH,OAAO,4BAA4B,CAAC,KAAK,EAAE,+BAA+B,EAAE,CAAC,CAAC;AAChF,CAAC"}

package/dist/scaffolding/canonical-api.d.ts

@@ -0,0 +1,14 @@
+import type { ScaffoldAuthorityEvidence, ScaffoldPlan, ScaffoldReceipt } from "./contract/scaffold-contract.js";
+export declare function planScaffoldFromFile(options: {
+    readonly consumerRoot: string;
+    readonly intentPath: string;
+    readonly configPath?: string;
+}): Promise<ScaffoldPlan>;
+export declare function applyFilesystemScaffold(consumerRoot: string, plan: ScaffoldPlan): Promise<ScaffoldReceipt>;
+export declare function recoverFilesystemScaffold(consumerRoot: string): Promise<ScaffoldReceipt | undefined>;
+export declare function readScaffoldPlanFile(consumerRoot: string, planPath: string): Promise<ScaffoldPlan>;
+export declare function validateScaffoldReceipt(receipt: unknown, plan?: ScaffoldPlan): Promise<ScaffoldReceipt>;
+export declare function assertScaffoldPlanDigest(plan: ScaffoldPlan): void;
+export declare function assertScaffoldReceiptDigest(receipt: ScaffoldReceipt, plan?: ScaffoldPlan): void;
+export declare function assertScaffoldAuthorityEvidenceDigest(evidence: ScaffoldAuthorityEvidence): void;
+//# sourceMappingURL=canonical-api.d.ts.map

package/dist/scaffolding/canonical-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-api.d.ts","sourceRoot":"","sources":["../../src/scaffolding/canonical-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,YAAY,EACZ,eAAe,EAChB,MAAM,iCAAiC,CAAC;AAczC,wBAAsB,oBAAoB,CAAC,OAAO,EAAE;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,GAAG,OAAO,CAAC,YAAY,CAAC,CAExB;AAED,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,eAAe,CAAC,CAE1B;AAED,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAEtC;AAED,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,eAAe,CAAC,CAE1B;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAEjE;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,eAAe,EACxB,IAAI,CAAC,EAAE,YAAY,GAClB,IAAI,CAEN;AAED,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,yBAAyB,GAClC,IAAI,CAEN"}

package/dist/scaffolding/canonical-api.js

@@ -0,0 +1,32 @@
+import { applyAuthorityFilesystemScaffold, recoverAuthorityFilesystemScaffold } from "./adapters/node/filesystem-authority-workspace.js";
+import { readAuthorityScaffoldPlanFile } from "./adapters/node/node-authority-input-loader.js";
+import { validateAuthorityScaffoldReceipt } from "./adapters/node/node-authority-receipt-validator.js";
+import { assertScaffoldAuthorityEvidenceDigest as assertAuthorityEvidenceDigest } from "./kernel/authority-evidence.js";
+import { assertAuthorityScaffoldPlanDigest } from "./kernel/plan-validation.js";
+import { assertAuthorityScaffoldReceiptDigest } from "./kernel/authority-receipt.js";
+import { planAuthorityScaffoldFromFile } from "./authority-service.js";
+export async function planScaffoldFromFile(options) {
+    return planAuthorityScaffoldFromFile(options);
+}
+export async function applyFilesystemScaffold(consumerRoot, plan) {
+    return applyAuthorityFilesystemScaffold(consumerRoot, plan);
+}
+export async function recoverFilesystemScaffold(consumerRoot) {
+    return recoverAuthorityFilesystemScaffold(consumerRoot);
+}
+export async function readScaffoldPlanFile(consumerRoot, planPath) {
+    return readAuthorityScaffoldPlanFile(consumerRoot, planPath);
+}
+export async function validateScaffoldReceipt(receipt, plan) {
+    return validateAuthorityScaffoldReceipt(receipt, plan);
+}
+export function assertScaffoldPlanDigest(plan) {
+    assertAuthorityScaffoldPlanDigest(plan);
+}
+export function assertScaffoldReceiptDigest(receipt, plan) {
+    assertAuthorityScaffoldReceiptDigest(receipt, plan);
+}
+export function assertScaffoldAuthorityEvidenceDigest(evidence) {
+    assertAuthorityEvidenceDigest(evidence);
+}
+//# sourceMappingURL=canonical-api.js.map

package/dist/scaffolding/canonical-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-api.js","sourceRoot":"","sources":["../../src/scaffolding/canonical-api.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,gCAAgC,EAChC,kCAAkC,EACnC,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,6BAA6B,EAAE,MAAM,gDAAgD,CAAC;AAC/F,OAAO,EAAE,gCAAgC,EAAE,MAAM,qDAAqD,CAAC;AACvG,OAAO,EACL,qCAAqC,IAAI,6BAA6B,EACvE,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,iCAAiC,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,EAAE,oCAAoC,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAEvE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAI1C;IACC,OAAO,6BAA6B,CAAC,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,YAAoB,EACpB,IAAkB;IAElB,OAAO,gCAAgC,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,YAAoB;IAEpB,OAAO,kCAAkC,CAAC,YAAY,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,YAAoB,EACpB,QAAgB;IAEhB,OAAO,6BAA6B,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAgB,EAChB,IAAmB;IAEnB,OAAO,gCAAgC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAkB;IACzD,iCAAiC,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,OAAwB,EACxB,IAAmB;IAEnB,oCAAoC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,QAAmC;IAEnC,6BAA6B,CAAC,QAAQ,CAAC,CAAC;AAC1C,CAAC"}

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

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

@@ -1,6 +1,5 @@
-import { applyFilesystemScaffold, readScaffoldPlanFile, recoverFilesystemScaffold } from "./index.js";
+import { applyFilesystemScaffold, planScaffoldFromFile, readScaffoldPlanFile, recoverFilesystemScaffold } from "./canonical-api.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`;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"cli-command.js","sourceRoot":"","sources":["../../src/scaffolding/cli-command.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AASpD,SAAS,UAAU,CAAC,IAAoB;IACtC,OAAO,kBAAkB,IAAI,CAAC,UAAU,cAAc,IAAI,CAAC,SAAS,kBAAkB,IAAI,CAAC,WAAW,CAAC,EAAE,aAAa,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,iBAAiB,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC;AACzM,CAAC;AAED,SAAS,aAAa,CAAC,OAA0B;IAC/C,OAAO,qBAAqB,OAAO,CAAC,aAAa,WAAW,OAAO,CAAC,UAAU,cAAc,OAAO,CAAC,OAAO,iBAAiB,OAAO,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC;AAC5J,CAAC;AAED,SAAS,QAAQ,CAAC,OAA0B;IAC1C,OAAO,OAAO,CAAC,OAAO,KAAK,SAAS;QAClC,OAAO,CAAC,OAAO,KAAK,iBAAiB;QACrC,OAAO,CAAC,OAAO,KAAK,kBAAkB;QACtC,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,CAAC,CAAC;AACR,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAA4B,EAC5B,IAAa;IAEb,QAAQ,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,KAAK,gBAAgB,EAAE,CAAC;YACtB,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,IAAI,aAAa,CACrB,wBAAwB,EACxB,0DAA0D,CAC3D,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;YACvE,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YACzE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CACxE,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,eAAe,EAAE,CAAC;YACrB,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACxC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,aAAa,CACrB,wBAAwB,EACxB,2DAA2D,CAC5D,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC;gBACtC,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,UAAU;gBACV,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC,CAAC;YACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAC/D,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,kBAAkB,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YACrE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI;oBACF,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,wBAAwB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI;oBACvE,CAAC,CAAC,uCAAuC,CAC5C,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CACxE,CAAC;gBACF,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;YACvC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC"}
+{"version":3,"file":"cli-command.js","sourceRoot":"","sources":["../../src/scaffolding/cli-command.ts"],"names":[],"mappings":"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"}

package/dist/scaffolding/contract/receipt-authority-types.d.ts

@@ -0,0 +1,125 @@
+import type { ScaffoldDiagnosticV1, AuthorityScaffoldOperationReceipt, Sha256Digest } from "./types.js";
+interface AuthorityScaffoldReceiptCommon {
+    readonly schemaVersion: 1;
+    readonly protocolVersion: 1;
+    readonly planDigest: Sha256Digest;
+    readonly adapter: {
+        readonly id: "foundation.filesystem/v1";
+        readonly contractVersion: 1;
+    };
+    readonly diagnostics: readonly ScaffoldDiagnosticV1[];
+    readonly receiptDigest: Sha256Digest;
+}
+type AuthorityAppliedOperationReceipt = AuthorityScaffoldOperationReceipt & {
+    readonly outcome: "applied";
+    readonly resultDigest: Sha256Digest;
+};
+type AuthoritySatisfiedOperationReceipt = AuthorityScaffoldOperationReceipt & {
+    readonly outcome: "already-satisfied" | "applied";
+    readonly resultDigest: Sha256Digest;
+};
+export type AuthorityScaffoldReceipt = (AuthorityScaffoldReceiptCommon & {
+    readonly outcome: "applied";
+    readonly commit: {
+        readonly state: "committed";
+        readonly atomicity: "journaled-recoverable";
+    };
+    readonly operations: readonly [
+        AuthorityAppliedOperationReceipt,
+        ...AuthoritySatisfiedOperationReceipt[]
+    ];
+}) | (AuthorityScaffoldReceiptCommon & {
+    readonly outcome: "already-applied";
+    readonly commit: {
+        readonly state: "committed";
+        readonly atomicity: "journaled-recoverable";
+    };
+    readonly operations: readonly [
+        AuthorityScaffoldOperationReceipt & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        },
+        ...(AuthorityScaffoldOperationReceipt & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        })[]
+    ];
+}) | (AuthorityScaffoldReceiptCommon & {
+    readonly outcome: "failed-recovered";
+    readonly commit: {
+        readonly state: "recovered";
+        readonly atomicity: "journaled-recoverable";
+    };
+    readonly operations: readonly [
+        AuthorityScaffoldOperationReceipt & {
+            readonly outcome: "already-satisfied" | "recovered";
+            readonly resultDigest: Sha256Digest;
+        },
+        ...(AuthorityScaffoldOperationReceipt & {
+            readonly outcome: "already-satisfied" | "recovered";
+            readonly resultDigest: Sha256Digest;
+        })[]
+    ];
+}) | (AuthorityScaffoldReceiptCommon & {
+    readonly outcome: "recovery-required";
+    readonly commit: {
+        readonly state: "recovery-required";
+        readonly atomicity: "journaled-recoverable";
+    };
+    readonly operations: readonly [
+        (AuthorityScaffoldOperationReceipt & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        }) | (AuthorityScaffoldOperationReceipt & {
+            readonly outcome: "conflict" | "not-applied" | "unobserved";
+            readonly resultDigest?: never;
+        }),
+        ...((AuthorityScaffoldOperationReceipt & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        }) | (AuthorityScaffoldOperationReceipt & {
+            readonly outcome: "conflict" | "not-applied" | "unobserved";
+            readonly resultDigest?: never;
+        }))[]
+    ];
+}) | (AuthorityScaffoldReceiptCommon & {
+    readonly outcome: "rejected";
+    readonly commit: {
+        readonly state: "rejected";
+        readonly atomicity: "journaled-recoverable";
+    };
+    readonly operations: readonly [
+        (AuthorityScaffoldOperationReceipt & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        }) | (AuthorityScaffoldOperationReceipt & {
+            readonly outcome: "conflict" | "not-applied";
+            readonly resultDigest?: never;
+        }),
+        ...((AuthorityScaffoldOperationReceipt & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        }) | (AuthorityScaffoldOperationReceipt & {
+            readonly outcome: "conflict" | "not-applied";
+            readonly resultDigest?: never;
+        }))[]
+    ];
+}) | (AuthorityScaffoldReceiptCommon & {
+    readonly outcome: "authority-stale";
+    readonly commit: {
+        readonly state: "rolled-back";
+        readonly atomicity: "journaled-recoverable";
+    };
+    readonly operations: readonly [
+        AuthorityScaffoldOperationReceipt & {
+            readonly outcome: "not-applied";
+            readonly resultDigest?: never;
+        },
+        ...(AuthorityScaffoldOperationReceipt & {
+            readonly outcome: "not-applied";
+            readonly resultDigest?: never;
+        })[]
+    ];
+});
+export {};
+//# sourceMappingURL=receipt-authority-types.d.ts.map

package/dist/scaffolding/contract/receipt-authority-types.d.ts.map

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