@agent-teams/engineering-foundation 0.6.0 → 0.8.0

package/dist/scaffolding/contract/scaffold-contract.d.ts

@@ -0,0 +1,329 @@
+import type { ConfiguredDefinition, DefinitionRef, JsonObject, RepositoryPath, Sha256Digest } from "./types.js";
+export interface ScaffoldAuthorityVerifier {
+    readonly id: "foundation.markdown-yaml-owner";
+    readonly contractVersion: 1;
+    readonly parameters: {
+        readonly allowedStatuses: readonly string[];
+        readonly documentRoots: readonly RepositoryPath[];
+    };
+}
+export interface ScaffoldComposition {
+    readonly id: string;
+    readonly scaffoldProfile: ConfiguredDefinition;
+    readonly recipe: ConfiguredDefinition;
+    readonly targetRoles: readonly string[];
+    readonly authorityVerifiers: readonly [ScaffoldAuthorityVerifier];
+    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 ScaffoldingConfig {
+    readonly schemaVersion: 2;
+    readonly projectId: string;
+    readonly targetCatalogPath: RepositoryPath;
+    readonly compositions: readonly ScaffoldComposition[];
+}
+export interface ScaffoldIntent {
+    readonly schemaVersion: 1;
+    readonly compositionId: string;
+    readonly targetRef: string;
+    readonly recipeParameters?: JsonObject;
+    readonly facets?: readonly ConfiguredDefinition[];
+}
+export interface ScaffoldOwnerDocumentBinding {
+    readonly id: string;
+    readonly path: RepositoryPath;
+}
+export interface ScaffoldTarget {
+    readonly id: string;
+    readonly role: string;
+    readonly path: RepositoryPath;
+    readonly packageName: string;
+    readonly ownerDocument: ScaffoldOwnerDocumentBinding;
+}
+export interface ScaffoldTargetCatalog {
+    readonly version: 2;
+    readonly packages: readonly ScaffoldTargetCatalogEntry[];
+}
+export interface ScaffoldTargetCatalogEntry {
+    readonly id: string;
+    readonly role: string;
+    readonly path: RepositoryPath;
+    readonly package_name: string;
+    readonly owner_document: string;
+}
+export interface ScaffoldDiagnostic {
+    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 ScaffoldReadAssertion {
+    readonly path: RepositoryPath;
+    readonly state: "file";
+    readonly digest: Sha256Digest;
+    readonly size: number;
+}
+export type ScaffoldAuthorityReadSet = readonly [
+    ScaffoldReadAssertion,
+    ScaffoldReadAssertion,
+    ScaffoldReadAssertion
+];
+export type ScaffoldAuthoritySourceRole = "config" | "owner-document" | "target-catalog";
+export interface ScaffoldAuthoritySourceAssertion {
+    readonly role: ScaffoldAuthoritySourceRole;
+    readonly assertion: ScaffoldReadAssertion;
+}
+export interface ScaffoldAuthorityEvidence {
+    readonly schemaVersion: 1;
+    readonly verifier: {
+        readonly id: "foundation.markdown-yaml-owner";
+        readonly contractVersion: 1;
+    };
+    readonly projectId: string;
+    readonly targetRef: string;
+    readonly targetIdentityDigest: Sha256Digest;
+    readonly ownerDocument: {
+        readonly id: string;
+        readonly path: RepositoryPath;
+        readonly status: string;
+    };
+    readonly sources: readonly [
+        ScaffoldAuthoritySourceAssertion & {
+            readonly role: "config";
+        },
+        ScaffoldAuthoritySourceAssertion & {
+            readonly role: "owner-document";
+        },
+        ScaffoldAuthoritySourceAssertion & {
+            readonly role: "target-catalog";
+        }
+    ];
+    readonly evidenceDigest: Sha256Digest;
+}
+export interface MaterializeFileOperation {
+    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 ScaffoldPlan {
+    readonly schemaVersion: 2;
+    readonly protocolVersion: 2;
+    readonly compiler: {
+        readonly id: "@agent-teams/engineering-foundation";
+        readonly version: string;
+    };
+    readonly projectId: string;
+    readonly authority: {
+        readonly configPath: RepositoryPath;
+        readonly targetCatalogPath: RepositoryPath;
+    };
+    readonly authorityEvidence: ScaffoldAuthorityEvidence;
+    readonly intent: ScaffoldIntent;
+    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: ScaffoldTarget;
+    readonly readSet: ScaffoldAuthorityReadSet;
+    readonly requiredAdapterCapabilities: readonly ["materialize-file/v1"];
+    readonly operations: readonly MaterializeFileOperation[];
+    readonly diagnostics: readonly ScaffoldDiagnostic[];
+    readonly planDigest: Sha256Digest;
+}
+export type ScaffoldOperationOutcome = "already-satisfied" | "applied" | "conflict" | "not-applied" | "recovered" | "unobserved";
+export interface ScaffoldOperationReceipt {
+    readonly operationId: string;
+    readonly path: RepositoryPath;
+    readonly outcome: ScaffoldOperationOutcome;
+    readonly resultDigest?: Sha256Digest;
+}
+export type ScaffoldAppliedOperationReceipt = ScaffoldOperationReceipt & {
+    readonly outcome: "applied";
+    readonly resultDigest: Sha256Digest;
+};
+export type ScaffoldSatisfiedOperationReceipt = ScaffoldOperationReceipt & {
+    readonly outcome: "already-satisfied" | "applied";
+    readonly resultDigest: Sha256Digest;
+};
+export type ScaffoldReceiptOutcome = "already-applied" | "applied" | "authority-stale" | "failed-recovered" | "recovery-required" | "rejected";
+export interface ScaffoldReceiptCommon {
+    readonly schemaVersion: 2;
+    readonly protocolVersion: 2;
+    readonly planDigest: Sha256Digest;
+    readonly adapter: {
+        readonly id: "foundation.filesystem/v1";
+        readonly contractVersion: 1;
+    };
+    readonly diagnostics: readonly ScaffoldDiagnostic[];
+    readonly receiptDigest: Sha256Digest;
+}
+export type ScaffoldReceipt = (ScaffoldReceiptCommon & {
+    readonly outcome: "applied";
+    readonly commit: {
+        readonly state: "committed";
+        readonly atomicity: "journaled-recoverable";
+    };
+    readonly operations: readonly [
+        ScaffoldAppliedOperationReceipt,
+        ...ScaffoldSatisfiedOperationReceipt[]
+    ];
+}) | (ScaffoldReceiptCommon & {
+    readonly outcome: "already-applied";
+    readonly commit: {
+        readonly state: "committed";
+        readonly atomicity: "journaled-recoverable";
+    };
+    readonly operations: readonly [
+        ScaffoldOperationReceipt & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        },
+        ...(ScaffoldOperationReceipt & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        })[]
+    ];
+}) | (ScaffoldReceiptCommon & {
+    readonly outcome: "failed-recovered";
+    readonly commit: {
+        readonly state: "recovered";
+        readonly atomicity: "journaled-recoverable";
+    };
+    readonly operations: readonly [
+        ScaffoldOperationReceipt & {
+            readonly outcome: "already-satisfied" | "recovered";
+            readonly resultDigest: Sha256Digest;
+        },
+        ...(ScaffoldOperationReceipt & {
+            readonly outcome: "already-satisfied" | "recovered";
+            readonly resultDigest: Sha256Digest;
+        })[]
+    ];
+}) | (ScaffoldReceiptCommon & {
+    readonly outcome: "recovery-required";
+    readonly commit: {
+        readonly state: "recovery-required";
+        readonly atomicity: "journaled-recoverable";
+    };
+    readonly operations: readonly [
+        (ScaffoldOperationReceipt & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        }) | (ScaffoldOperationReceipt & {
+            readonly outcome: "conflict" | "not-applied" | "unobserved";
+            readonly resultDigest?: never;
+        }),
+        ...((ScaffoldOperationReceipt & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        }) | (ScaffoldOperationReceipt & {
+            readonly outcome: "conflict" | "not-applied" | "unobserved";
+            readonly resultDigest?: never;
+        }))[]
+    ];
+}) | (ScaffoldReceiptCommon & {
+    readonly outcome: "rejected";
+    readonly commit: {
+        readonly state: "rejected";
+        readonly atomicity: "journaled-recoverable";
+    };
+    readonly operations: readonly [
+        (ScaffoldOperationReceipt & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        }) | (ScaffoldOperationReceipt & {
+            readonly outcome: "conflict" | "not-applied";
+            readonly resultDigest?: never;
+        }),
+        ...((ScaffoldOperationReceipt & {
+            readonly outcome: "already-satisfied";
+            readonly resultDigest: Sha256Digest;
+        }) | (ScaffoldOperationReceipt & {
+            readonly outcome: "conflict" | "not-applied";
+            readonly resultDigest?: never;
+        }))[]
+    ];
+}) | (ScaffoldReceiptCommon & {
+    readonly outcome: "authority-stale";
+    readonly commit: {
+        readonly state: "rolled-back";
+        readonly atomicity: "journaled-recoverable";
+    };
+    readonly operations: readonly [
+        ScaffoldOperationReceipt & {
+            readonly outcome: "not-applied";
+            readonly resultDigest?: never;
+        },
+        ...(ScaffoldOperationReceipt & {
+            readonly outcome: "not-applied";
+            readonly resultDigest?: never;
+        })[]
+    ];
+});
+export type ScaffoldJournalOperationState = "pending" | "preexisting" | "published" | "publishing";
+export interface ScaffoldJournalOperation {
+    readonly operationId: string;
+    readonly path: RepositoryPath;
+    readonly state: ScaffoldJournalOperationState;
+}
+export interface ScaffoldJournal {
+    readonly schemaVersion: 2;
+    readonly state: "PREPARED";
+    readonly plan: ScaffoldPlan;
+    readonly operations: readonly ScaffoldJournalOperation[];
+}
+export interface ScaffoldCompilationInput {
+    readonly foundationVersion: string;
+    readonly configPath: RepositoryPath;
+    readonly config: ScaffoldingConfig;
+    readonly intent: ScaffoldIntent;
+    readonly catalog: {
+        readonly version: 2;
+        readonly packages: readonly ScaffoldTarget[];
+    };
+    readonly authorityEvidence: ScaffoldAuthorityEvidence;
+    readonly authorityReadSet: ScaffoldAuthorityReadSet;
+}
+//# sourceMappingURL=scaffold-contract.d.ts.map

package/dist/scaffolding/contract/scaffold-contract.d.ts.map

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

package/dist/scaffolding/contract/scaffold-contract.js

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

package/dist/scaffolding/contract/scaffold-contract.js.map

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

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

@@ -1,3 +1,4 @@
+export type { AuthorityScaffoldReceipt } from "./receipt-authority-types.js";
 export type JsonPrimitive = boolean | null | number | string;
 export type JsonValue = JsonPrimitive | readonly JsonValue[] | {
     readonly [key: string]: JsonValue;
@@ -15,7 +16,7 @@ export interface ConfiguredDefinition {
     readonly ref: DefinitionRef;
     readonly parameters?: JsonObject;
 }
-export interface ScaffoldCompositionV1 {
+export interface ScaffoldRenderingComposition {
     readonly id: string;
     readonly scaffoldProfile: ConfiguredDefinition;
     readonly recipe: ConfiguredDefinition;
@@ -29,31 +30,70 @@ export interface ScaffoldCompositionV1 {
     };
     readonly policies: readonly ConfiguredDefinition[];
 }
+interface ScaffoldCompositionV1 extends ScaffoldRenderingComposition {
+}
 export interface ScaffoldingConfigV1 {
     readonly schemaVersion: 1;
     readonly projectId: string;
     readonly targetCatalogPath: RepositoryPath;
     readonly compositions: readonly ScaffoldCompositionV1[];
 }
-export interface ScaffoldIntentV1 {
+/**
+ * A closed, Foundation-owned verifier selected by a consumer composition.
+ * Consumer input can constrain a verifier, but cannot provide executable
+ * verification behavior.
+ */
+export interface ScaffoldAuthorityVerifierV1 {
+    readonly id: "foundation.markdown-yaml-owner";
+    readonly contractVersion: 1;
+    readonly parameters: {
+        readonly allowedStatuses: readonly string[];
+        readonly documentRoots: readonly string[];
+    };
+}
+interface AuthorityScaffoldComposition extends ScaffoldRenderingComposition {
+    readonly authorityVerifiers: readonly [ScaffoldAuthorityVerifierV1];
+}
+export interface AuthorityScaffoldingConfig {
+    readonly schemaVersion: 2;
+    readonly projectId: string;
+    readonly targetCatalogPath: RepositoryPath;
+    readonly compositions: readonly AuthorityScaffoldComposition[];
+}
+export interface ScaffoldRenderingIntent {
     readonly schemaVersion: 1;
     readonly compositionId: string;
     readonly targetRef: string;
     readonly recipeParameters?: JsonObject;
     readonly facets?: readonly ConfiguredDefinition[];
 }
-export interface ScaffoldTargetV1 {
+export interface ScaffoldIntentV1 extends ScaffoldRenderingIntent {
+}
+export interface ScaffoldRenderingTarget {
     readonly id: string;
     readonly role: string;
     readonly path: RepositoryPath;
     readonly packageName: string;
+}
+interface ScaffoldTargetV1 extends ScaffoldRenderingTarget {
     readonly ownerDocument?: string;
 }
 export interface ScaffoldTargetCatalogV1 {
     readonly version: 1;
     readonly packages: readonly ScaffoldTargetV1[];
 }
-export interface ScaffoldDiagnosticV1 {
+interface AuthorityScaffoldOwnerDocumentBinding {
+    readonly id: string;
+    readonly path: RepositoryPath;
+}
+export interface AuthorityScaffoldTarget extends ScaffoldRenderingTarget {
+    readonly ownerDocument: AuthorityScaffoldOwnerDocumentBinding;
+}
+export interface AuthorityScaffoldTargetCatalog {
+    readonly version: 2;
+    readonly packages: readonly AuthorityScaffoldTarget[];
+}
+export interface ScaffoldRenderingDiagnostic {
     readonly ruleId: string;
     readonly severity: "error" | "info" | "warning";
     readonly phase: "apply" | "composition" | "input" | "planning" | "policy" | "recovery";
@@ -61,13 +101,56 @@ export interface ScaffoldDiagnosticV1 {
     readonly message: string;
     readonly remediation: string;
 }
+export interface ScaffoldDiagnosticV1 extends ScaffoldRenderingDiagnostic {
+}
 export interface ScaffoldReadAssertionV1 {
     readonly path: RepositoryPath;
     readonly state: "file";
     readonly digest: Sha256Digest;
     readonly size: number;
 }
-export interface MaterializeFileOperationV1 {
+export type AuthorityScaffoldReadSet = readonly [
+    ScaffoldReadAssertionV1,
+    ScaffoldReadAssertionV1,
+    ScaffoldReadAssertionV1
+];
+type ScaffoldAuthoritySourceRoleV1 = "config" | "owner-document" | "target-catalog";
+export interface ScaffoldAuthoritySourceAssertionV1 {
+    readonly role: ScaffoldAuthoritySourceRoleV1;
+    readonly assertion: ScaffoldReadAssertionV1;
+}
+/**
+ * Evidence is an immutable result of Foundation re-reading the consumer's
+ * canonical sources. It is not a consumer-produced approval assertion.
+ */
+export interface ScaffoldAuthorityEvidenceV1 {
+    readonly schemaVersion: 1;
+    readonly verifier: {
+        readonly id: "foundation.markdown-yaml-owner";
+        readonly contractVersion: 1;
+    };
+    readonly projectId: string;
+    readonly targetRef: string;
+    readonly targetIdentityDigest: Sha256Digest;
+    readonly ownerDocument: {
+        readonly id: string;
+        readonly path: RepositoryPath;
+        readonly status: string;
+    };
+    readonly sources: readonly [
+        ScaffoldAuthoritySourceAssertionV1 & {
+            readonly role: "config";
+        },
+        ScaffoldAuthoritySourceAssertionV1 & {
+            readonly role: "owner-document";
+        },
+        ScaffoldAuthoritySourceAssertionV1 & {
+            readonly role: "target-catalog";
+        }
+    ];
+    readonly evidenceDigest: Sha256Digest;
+}
+export interface ScaffoldRenderingOperation {
     readonly id: string;
     readonly kind: "materialize-file";
     readonly path: RepositoryPath;
@@ -83,13 +166,41 @@ export interface MaterializeFileOperationV1 {
     };
     readonly causes: readonly string[];
 }
+export interface MaterializeFileOperationV1 extends ScaffoldRenderingOperation {
+}
+export interface ScaffoldRenderingCompiler {
+    readonly id: "@agent-teams/engineering-foundation";
+    readonly version: string;
+}
+export interface ScaffoldRenderingCompositionSelection {
+    readonly id: string;
+    readonly scaffoldProfile: DefinitionRef;
+    readonly recipe: DefinitionRef;
+    readonly facets: readonly DefinitionRef[];
+    readonly policies: readonly DefinitionRef[];
+}
+export interface ScaffoldRenderingDefinitionEvidence {
+    readonly kind: "facet" | "policy" | "recipe" | "scaffold-profile";
+    readonly ref: DefinitionRef;
+    readonly contractDigest: Sha256Digest;
+}
+export interface ScaffoldRenderingResolution {
+    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";
+    }[];
+}
 export interface ScaffoldPlanV1 {
     readonly schemaVersion: 1;
     readonly protocolVersion: 1;
-    readonly compiler: {
-        readonly id: "@agent-teams/engineering-foundation";
-        readonly version: string;
-    };
+    readonly compiler: ScaffoldRenderingCompiler;
     readonly projectId: string;
     readonly authority: {
         readonly configPath: RepositoryPath;
@@ -98,31 +209,9 @@ export interface ScaffoldPlanV1 {
     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 composition: ScaffoldRenderingCompositionSelection;
+    readonly definitions: readonly ScaffoldRenderingDefinitionEvidence[];
+    readonly resolved: ScaffoldRenderingResolution;
     readonly target: ScaffoldTargetV1;
     readonly readSet: readonly ScaffoldReadAssertionV1[];
     readonly requiredAdapterCapabilities: readonly ["materialize-file/v1"];
@@ -130,15 +219,47 @@ export interface ScaffoldPlanV1 {
     readonly diagnostics: readonly ScaffoldDiagnosticV1[];
     readonly planDigest: Sha256Digest;
 }
+export interface AuthorityScaffoldPlan {
+    readonly schemaVersion: 2;
+    readonly protocolVersion: 2;
+    readonly compiler: ScaffoldRenderingCompiler;
+    readonly projectId: string;
+    readonly authority: {
+        readonly configPath: RepositoryPath;
+        readonly targetCatalogPath: RepositoryPath;
+    };
+    readonly authorityEvidence: ScaffoldAuthorityEvidenceV1;
+    readonly intent: ScaffoldRenderingIntent;
+    readonly intentDigest: Sha256Digest;
+    readonly authoritySnapshotDigest: Sha256Digest;
+    readonly composition: ScaffoldRenderingCompositionSelection;
+    readonly definitions: readonly ScaffoldRenderingDefinitionEvidence[];
+    readonly resolved: ScaffoldRenderingResolution;
+    readonly target: AuthorityScaffoldTarget;
+    readonly readSet: AuthorityScaffoldReadSet;
+    readonly requiredAdapterCapabilities: readonly ["materialize-file/v1"];
+    readonly operations: readonly ScaffoldRenderingOperation[];
+    readonly diagnostics: readonly ScaffoldRenderingDiagnostic[];
+    readonly planDigest: Sha256Digest;
+}
+export type ScaffoldPlan = ScaffoldPlanV1 | AuthorityScaffoldPlan;
 export type ScaffoldOperationOutcome = "already-satisfied" | "applied" | "conflict" | "not-applied" | "recovered";
+export type AuthorityScaffoldOperationOutcome = ScaffoldOperationOutcome | "unobserved";
 export interface ScaffoldOperationReceiptV1 {
     readonly operationId: string;
     readonly path: RepositoryPath;
     readonly outcome: ScaffoldOperationOutcome;
     readonly resultDigest?: Sha256Digest;
 }
+export interface AuthorityScaffoldOperationReceipt {
+    readonly operationId: string;
+    readonly path: RepositoryPath;
+    readonly outcome: AuthorityScaffoldOperationOutcome;
+    readonly resultDigest?: Sha256Digest;
+}
 export type ScaffoldReceiptOutcome = "already-applied" | "applied" | "failed-recovered" | "recovery-required" | "rejected";
-export interface ScaffoldReceiptCommonV1 {
+export type AuthorityScaffoldReceiptOutcome = ScaffoldReceiptOutcome | "authority-stale";
+interface ScaffoldReceiptCommonV1 {
     readonly schemaVersion: 1;
     readonly protocolVersion: 1;
     readonly planDigest: Sha256Digest;
@@ -279,6 +400,18 @@ export type ScaffoldReceiptV1 = (ScaffoldReceiptCommonV1 & {
         readonly atomicity: "memory-atomic";
     };
 }));
+type AuthorityScaffoldJournalOperationState = "pending" | "publishing" | "published" | "preexisting";
+export interface AuthorityScaffoldJournalOperation {
+    readonly operationId: string;
+    readonly path: RepositoryPath;
+    readonly state: AuthorityScaffoldJournalOperationState;
+}
+export interface AuthorityScaffoldJournal {
+    readonly schemaVersion: 2;
+    readonly state: "PREPARED";
+    readonly plan: AuthorityScaffoldPlan;
+    readonly operations: readonly AuthorityScaffoldJournalOperation[];
+}
 export interface ScaffoldCompilationInput {
     readonly foundationVersion: string;
     readonly configPath: RepositoryPath;
@@ -287,6 +420,15 @@ export interface ScaffoldCompilationInput {
     readonly catalog: ScaffoldTargetCatalogV1;
     readonly authorityReadSet: readonly ScaffoldReadAssertionV1[];
 }
+export interface AuthorityScaffoldCompilationInput {
+    readonly foundationVersion: string;
+    readonly configPath: RepositoryPath;
+    readonly config: AuthorityScaffoldingConfig;
+    readonly intent: ScaffoldRenderingIntent;
+    readonly catalog: AuthorityScaffoldTargetCatalog;
+    readonly authorityEvidence: ScaffoldAuthorityEvidenceV1;
+    readonly authorityReadSet: AuthorityScaffoldReadSet;
+}
 export interface ScaffoldFileContribution {
     readonly path: RepositoryPath;
     readonly mediaType: string;