@agent-teams/engineering-foundation 0.15.0 → 0.16.0

package/dist/document-authoring/application/policies/classify-document-recovery.d.ts

@@ -0,0 +1,81 @@
+/**
+ * A closed, side-effect-free recovery decision for the document writer.
+ *
+ * `exact` describes byte equality. Identity relationships are separate so that
+ * byte equality can never accidentally grant ownership or recovery authority.
+ */
+export type DocumentRecoveryTemporaryObservation = {
+    readonly state: "absent";
+} | {
+    readonly state: "exact";
+    readonly identity: "nonzero";
+} | {
+    readonly state: "replaced";
+    readonly identity: "nonzero";
+} | {
+    readonly state: "zero-identity";
+} | {
+    readonly state: "unverifiable";
+};
+export type DocumentRecoveryDestinationObservation = {
+    readonly state: "absent";
+} | {
+    readonly state: "conflict";
+} | {
+    readonly state: "exact";
+    readonly identity: "unbound" | "bound-temporary" | "bound-publication" | "different" | "zero-identity";
+} | {
+    readonly state: "unverifiable";
+};
+type DocumentRecoveryJournalObservation = {
+    readonly version: "none";
+    readonly fileIdentity: "none";
+} | {
+    /** Released v1 evidence is read-only and never grants recovery authority. */
+    readonly version: "v1-legacy";
+    readonly fileIdentity: "nonzero" | "zero-identity" | "unverifiable";
+} | {
+    readonly version: "v2";
+    readonly fileIdentity: "nonzero" | "zero-identity" | "unverifiable";
+    readonly lifecycle: "PREPARED";
+    readonly preparedState: "pending" | "preexisting";
+    readonly boundIdentity: "none";
+} | {
+    readonly version: "v2";
+    readonly fileIdentity: "nonzero" | "zero-identity" | "unverifiable";
+    readonly lifecycle: "PUBLISHING";
+    readonly boundIdentity: "temporary" | "zero-identity" | "unverifiable";
+} | {
+    readonly version: "v2";
+    readonly fileIdentity: "nonzero" | "zero-identity" | "unverifiable";
+    readonly lifecycle: "PUBLISHED";
+    readonly boundIdentity: "publication" | "zero-identity" | "unverifiable";
+};
+export interface DocumentRecoveryObservation {
+    readonly journal: DocumentRecoveryJournalObservation;
+    readonly temporary: DocumentRecoveryTemporaryObservation;
+    readonly destination: DocumentRecoveryDestinationObservation;
+}
+type DocumentRecoveryManualReason = "destination-conflict" | "identity-drift" | "inconsistent-lifecycle" | "legacy-journal" | "orphan-temporary" | "publication-missing" | "temporary-missing" | "unverifiable-identity" | "zero-identity";
+export type DocumentRecoveryDecision = {
+    readonly action: "resume-prepare";
+} | {
+    readonly action: "resume-publish";
+} | {
+    readonly action: "complete-publication";
+} | {
+    readonly action: "finalize-checks";
+} | {
+    readonly action: "already-applied";
+    readonly cleanup: "none" | "owned-temporary";
+} | {
+    readonly action: "manual";
+    readonly reason: DocumentRecoveryManualReason;
+};
+/**
+ * Classifies a fully observed recovery snapshot. This function never mutates
+ * evidence and deliberately has no catch-all optimistic branch.
+ */
+export declare function classifyDocumentRecovery(observation: DocumentRecoveryObservation): DocumentRecoveryDecision;
+export {};
+//# sourceMappingURL=classify-document-recovery.d.ts.map

package/dist/document-authoring/application/policies/classify-document-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-document-recovery.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/policies/classify-document-recovery.ts"],"names":[],"mappings":"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"}

package/dist/document-authoring/application/policies/classify-document-recovery.js

@@ -0,0 +1,138 @@
+function manual(reason) {
+    return { action: "manual", reason };
+}
+function containsZeroIdentity(observation) {
+    if (observation.journal.fileIdentity === "zero-identity") {
+        return true;
+    }
+    if (observation.temporary.state === "zero-identity") {
+        return true;
+    }
+    if (observation.destination.state === "exact" &&
+        observation.destination.identity === "zero-identity") {
+        return true;
+    }
+    return observation.journal.version === "v2" &&
+        observation.journal.boundIdentity === "zero-identity";
+}
+function containsUnverifiableIdentity(observation) {
+    if (observation.journal.fileIdentity === "unverifiable") {
+        return true;
+    }
+    if (observation.temporary.state === "unverifiable") {
+        return true;
+    }
+    if (observation.destination.state === "unverifiable") {
+        return true;
+    }
+    return observation.journal.version === "v2" &&
+        observation.journal.boundIdentity === "unverifiable";
+}
+function classifyWithoutJournal(observation) {
+    if (observation.temporary.state !== "absent") {
+        return manual("orphan-temporary");
+    }
+    switch (observation.destination.state) {
+        case "absent":
+            return { action: "resume-prepare" };
+        case "conflict":
+            return manual("destination-conflict");
+        case "unverifiable":
+            return manual("unverifiable-identity");
+        case "exact":
+            return observation.destination.identity === "unbound"
+                ? { action: "already-applied", cleanup: "none" }
+                : manual("inconsistent-lifecycle");
+    }
+}
+function classifyPrepared(observation) {
+    if (observation.temporary.state !== "absent") {
+        return manual("orphan-temporary");
+    }
+    switch (observation.destination.state) {
+        case "absent":
+            return observation.journal.version === "v2" &&
+                observation.journal.lifecycle === "PREPARED" &&
+                observation.journal.preparedState === "pending"
+                ? { action: "resume-prepare" }
+                : manual("inconsistent-lifecycle");
+        case "conflict":
+            return manual("destination-conflict");
+        case "unverifiable":
+            return manual("unverifiable-identity");
+        case "exact":
+            return observation.journal.version === "v2" &&
+                observation.journal.lifecycle === "PREPARED" &&
+                observation.journal.preparedState === "preexisting"
+                ? { action: "already-applied", cleanup: "none" }
+                : manual("inconsistent-lifecycle");
+    }
+}
+function classifyPublishing(observation) {
+    switch (observation.destination.state) {
+        case "conflict":
+            return manual("destination-conflict");
+        case "unverifiable":
+            return manual("unverifiable-identity");
+        case "absent":
+            if (observation.temporary.state === "absent") {
+                return manual("temporary-missing");
+            }
+            return observation.temporary.state === "exact"
+                ? { action: "resume-publish" }
+                : manual("identity-drift");
+        case "exact":
+            if (observation.destination.identity === "bound-temporary") {
+                return observation.temporary.state === "absent" ||
+                    observation.temporary.state === "exact"
+                    ? { action: "complete-publication" }
+                    : manual("identity-drift");
+            }
+            return manual("identity-drift");
+    }
+}
+function classifyPublished(observation) {
+    if (observation.temporary.state !== "absent") {
+        return manual("orphan-temporary");
+    }
+    switch (observation.destination.state) {
+        case "absent":
+            return manual("publication-missing");
+        case "conflict":
+            return manual("destination-conflict");
+        case "unverifiable":
+            return manual("unverifiable-identity");
+        case "exact":
+            return observation.destination.identity === "bound-publication"
+                ? { action: "finalize-checks" }
+                : manual("identity-drift");
+    }
+}
+/**
+ * Classifies a fully observed recovery snapshot. This function never mutates
+ * evidence and deliberately has no catch-all optimistic branch.
+ */
+export function classifyDocumentRecovery(observation) {
+    if (containsZeroIdentity(observation)) {
+        return manual("zero-identity");
+    }
+    if (containsUnverifiableIdentity(observation)) {
+        return manual("unverifiable-identity");
+    }
+    switch (observation.journal.version) {
+        case "none":
+            return classifyWithoutJournal(observation);
+        case "v1-legacy":
+            return manual("legacy-journal");
+        case "v2":
+            switch (observation.journal.lifecycle) {
+                case "PREPARED":
+                    return classifyPrepared(observation);
+                case "PUBLISHING":
+                    return classifyPublishing(observation);
+                case "PUBLISHED":
+                    return classifyPublished(observation);
+            }
+    }
+}
+//# sourceMappingURL=classify-document-recovery.js.map

package/dist/document-authoring/application/policies/classify-document-recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-document-recovery.js","sourceRoot":"","sources":["../../../../src/document-authoring/application/policies/classify-document-recovery.ts"],"names":[],"mappings":"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"}

package/dist/document-authoring/application/policies/document-command-consumer-root.d.ts

@@ -0,0 +1,2 @@
+export declare function projectDocumentCommandConsumerRoot(consumerRoot: string): string;
+//# sourceMappingURL=document-command-consumer-root.d.ts.map

package/dist/document-authoring/application/policies/document-command-consumer-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-command-consumer-root.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/policies/document-command-consumer-root.ts"],"names":[],"mappings":"AAGA,wBAAgB,kCAAkC,CAChD,YAAY,EAAE,MAAM,GACnB,MAAM,CAeR"}

package/dist/document-authoring/application/policies/document-command-consumer-root.js

@@ -0,0 +1,15 @@
+const utf8 = new TextEncoder();
+const maximumConsumerRootBytes = 512;
+export function projectDocumentCommandConsumerRoot(consumerRoot) {
+    const isWindowsAbsolute = /^[A-Za-z]:\\/u.test(consumerRoot) ||
+        consumerRoot.startsWith("\\\\");
+    const projected = isWindowsAbsolute
+        ? consumerRoot.replaceAll("\\", "/")
+        : consumerRoot;
+    if (projected.length === 0 ||
+        utf8.encode(projected).byteLength > maximumConsumerRootBytes) {
+        throw new TypeError(`Document command consumer root must contain between 1 and ${maximumConsumerRootBytes} UTF-8 bytes.`);
+    }
+    return projected;
+}
+//# sourceMappingURL=document-command-consumer-root.js.map

package/dist/document-authoring/application/policies/document-command-consumer-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-command-consumer-root.js","sourceRoot":"","sources":["../../../../src/document-authoring/application/policies/document-command-consumer-root.ts"],"names":[],"mappings":"AAAA,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;AAC/B,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAErC,MAAM,UAAU,kCAAkC,CAChD,YAAoB;IAEpB,MAAM,iBAAiB,GAAG,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC;QAC1D,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,iBAAiB;QACjC,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC;QACpC,CAAC,CAAC,YAAY,CAAC;IACjB,IACE,SAAS,CAAC,MAAM,KAAK,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,UAAU,GAAG,wBAAwB,EAC5D,CAAC;QACD,MAAM,IAAI,SAAS,CACjB,6DAA6D,wBAAwB,eAAe,CACrG,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/document-authoring/application/policies/document-command-projection.d.ts

@@ -0,0 +1,20 @@
+import type { DocumentCommandDiagnostic, DocumentCommandExecution, DocumentCommandId, DocumentCommandOutcome } from "../model/document-command.js";
+import type { DocumentReceipt } from "../model/document-receipt.js";
+export declare function commandExecution<Result>(input: {
+    readonly command: DocumentCommandId;
+    readonly diagnostics?: readonly DocumentCommandDiagnostic[];
+    readonly outcome: DocumentCommandOutcome;
+    readonly result: Result;
+}): DocumentCommandExecution<Result>;
+export declare function receiptOutcome(receipt: DocumentReceipt): DocumentCommandOutcome;
+export declare function projectDocumentCommandFailure(input: {
+    readonly allowCancellation?: boolean;
+    readonly command: DocumentCommandId;
+    readonly error: unknown;
+    readonly phase: DocumentCommandDiagnostic["phase"];
+    readonly subject: string;
+}): {
+    readonly diagnostic: DocumentCommandDiagnostic;
+    readonly outcome: DocumentCommandOutcome;
+};
+//# sourceMappingURL=document-command-projection.d.ts.map

package/dist/document-authoring/application/policies/document-command-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-command-projection.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/policies/document-command-projection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAKpE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE;IAC9C,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC5D,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAWnC;AAiBD,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,sBAAsB,CAW/E;AAMD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GAAG;IACF,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;CAC1C,CA+CA"}

package/dist/document-authoring/application/policies/document-command-projection.js

@@ -0,0 +1,90 @@
+import { CapabilityInputError } from "../../../capability-runtime.js";
+import { FoundationError } from "../../../errors.js";
+import { DocumentPlanningError } from "../../document-planning-error.js";
+const MAXIMUM_DIAGNOSTICS = 256;
+export function commandExecution(input) {
+    return Object.freeze({
+        envelope: Object.freeze({
+            schemaVersion: 2,
+            command: input.command,
+            outcome: input.outcome,
+            diagnostics: Object.freeze((input.diagnostics ?? []).slice(0, MAXIMUM_DIAGNOSTICS)),
+            result: Object.freeze(input.result)
+        }),
+        exitCode: exitCodeForDocumentCommandOutcome(input.outcome)
+    });
+}
+function exitCodeForDocumentCommandOutcome(outcome) {
+    switch (outcome) {
+        case "success": return 0;
+        case "authority-stale":
+        case "conflict":
+        case "recovery-required":
+        case "violation": return 1;
+        case "invalid-input": return 2;
+        case "execution-failure": return 3;
+        case "cancelled": return 130;
+    }
+}
+export function receiptOutcome(receipt) {
+    switch (receipt.outcome) {
+        case "applied":
+        case "already-applied": return "success";
+        case "authority-stale": return "authority-stale";
+        case "rejected": return "conflict";
+        case "recovery-required":
+        case "manual-recovery-required": return "recovery-required";
+        case "failed-before-publication": return "execution-failure";
+        case "cancelled": return "cancelled";
+    }
+}
+function message(error) {
+    return (error instanceof Error ? error.message : String(error)).slice(0, 1_000);
+}
+export function projectDocumentCommandFailure(input) {
+    const { command, error, phase, subject } = input;
+    if (input.allowCancellation !== false && ((error instanceof CapabilityInputError &&
+        error.problem.code === "EXECUTION_CANCELLED") ||
+        (error instanceof Error && error.name === "AbortError"))) {
+        return {
+            diagnostic: {
+                ruleId: `${command}.cancelled`, severity: "error", phase,
+                subject, message: message(error)
+            },
+            outcome: "cancelled"
+        };
+    }
+    if (error instanceof DocumentPlanningError) {
+        const outcome = error.code === "DOCUMENT_PLANNING_AUTHORITY_CHANGED"
+            ? "authority-stale"
+            : error.code === "DOCUMENT_PLANNING_CONFLICT"
+                ? "conflict"
+                : "invalid-input";
+        return {
+            diagnostic: {
+                ruleId: `${command}.${outcome}`, severity: "error",
+                phase: outcome === "authority-stale" ? "authority" : phase,
+                subject, message: message(error)
+            },
+            outcome
+        };
+    }
+    if (error instanceof CapabilityInputError ||
+        (error instanceof FoundationError && error.code === "CONSUMER_INVALID")) {
+        return {
+            diagnostic: {
+                ruleId: `${command}.invalid-input`, severity: "error", phase: "input",
+                subject, message: message(error)
+            },
+            outcome: "invalid-input"
+        };
+    }
+    return {
+        diagnostic: {
+            ruleId: `${command}.execution-failure`, severity: "error", phase,
+            subject, message: message(error)
+        },
+        outcome: "execution-failure"
+    };
+}
+//# sourceMappingURL=document-command-projection.js.map

package/dist/document-authoring/application/policies/document-command-projection.js.map

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

package/dist/document-authoring/application/policies/document-receipt-policy.d.ts

@@ -0,0 +1,5 @@
+import type { DocumentReceipt, DocumentReceiptBody } from "../model/document-receipt.js";
+import type { DocumentPlan } from "../model/document-planning.js";
+export declare function createDocumentReceipt(body: DocumentReceiptBody, plan: DocumentPlan | undefined): Promise<DocumentReceipt>;
+export declare function assertDocumentReceipt(receipt: unknown, plan: DocumentPlan | undefined): Promise<DocumentReceipt>;
+//# sourceMappingURL=document-receipt-policy.d.ts.map

package/dist/document-authoring/application/policies/document-receipt-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-receipt-policy.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/policies/document-receipt-policy.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AA4ClE,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,mBAAmB,EACzB,IAAI,EAAE,YAAY,GAAG,SAAS,GAC7B,OAAO,CAAC,eAAe,CAAC,CAY1B;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,YAAY,GAAG,SAAS,GAC7B,OAAO,CAAC,eAAe,CAAC,CAQ1B"}

package/dist/document-authoring/application/policies/document-receipt-policy.js

@@ -0,0 +1,53 @@
+import { canonicalJson } from "../../../canonical-json.js";
+import { assertSchema } from "../../../schema-catalog.js";
+import { assertDocumentReceiptDigest, documentReceiptDigest } from "./document-contract-digests.js";
+function snapshotBody(body) {
+    return JSON.parse(canonicalJson(body));
+}
+function deepFreezeCanonical(value) {
+    const pending = [];
+    if (value !== null && typeof value === "object") {
+        pending.push(value);
+    }
+    while (pending.length > 0) {
+        const current = pending.pop();
+        if (current === undefined || Object.isFrozen(current)) {
+            continue;
+        }
+        for (const key of Reflect.ownKeys(current)) {
+            const descriptor = Object.getOwnPropertyDescriptor(current, key);
+            const child = descriptor !== undefined && "value" in descriptor
+                ? descriptor.value
+                : undefined;
+            if (typeof child === "object" && child !== null) {
+                pending.push(child);
+            }
+        }
+        Object.freeze(current);
+    }
+    return value;
+}
+function requireDocumentPlan(plan) {
+    if (plan === undefined) {
+        throw new TypeError("Document Receipt requires the exact referenced Plan.");
+    }
+}
+export async function createDocumentReceipt(body, plan) {
+    const snapshot = deepFreezeCanonical(snapshotBody(body));
+    const receipt = deepFreezeCanonical({
+        ...snapshot,
+        receiptDigest: documentReceiptDigest(snapshot)
+    });
+    await assertSchema("document-receipt/v1", receipt, "document-receipt");
+    requireDocumentPlan(plan);
+    assertDocumentReceiptDigest(receipt, plan);
+    return receipt;
+}
+export async function assertDocumentReceipt(receipt, plan) {
+    const snapshot = deepFreezeCanonical(JSON.parse(canonicalJson(receipt)));
+    await assertSchema("document-receipt/v1", snapshot, "document-receipt");
+    requireDocumentPlan(plan);
+    assertDocumentReceiptDigest(snapshot, plan);
+    return snapshot;
+}
+//# sourceMappingURL=document-receipt-policy.js.map

package/dist/document-authoring/application/policies/document-receipt-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-receipt-policy.js","sourceRoot":"","sources":["../../../../src/document-authoring/application/policies/document-receipt-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAEd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAM1D,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AAExC,SAAS,YAAY,CAAC,IAAyB;IAC7C,OAAO,IAAI,CAAC,KAAK,CACf,aAAa,CAAC,IAAqC,CAAC,CAC9B,CAAC;AAC3B,CAAC;AAED,SAAS,mBAAmB,CAAI,KAAQ;IACtC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC9B,IAAI,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACtD,SAAS;QACX,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACjE,MAAM,KAAK,GAAY,UAAU,KAAK,SAAS,IAAI,OAAO,IAAI,UAAU;gBACtE,CAAC,CAAC,UAAU,CAAC,KAAK;gBAClB,CAAC,CAAC,SAAS,CAAC;YACd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAChD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,mBAAmB,CAC1B,IAA8B;IAE9B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,SAAS,CAAC,sDAAsD,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAAyB,EACzB,IAA8B;IAE9B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,mBAAmB,CAAC;QAClC,GAAG,QAAQ;QACX,aAAa,EAAE,qBAAqB,CAClC,QAAmE,CACpE;KACF,CAAoB,CAAC;IACtB,MAAM,YAAY,CAAC,qBAAqB,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC;IACvE,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC1B,2BAA2B,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC3C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAgB,EAChB,IAA8B;IAE9B,MAAM,QAAQ,GAAG,mBAAmB,CAClC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,OAA6B,CAAC,CAAY,CACpE,CAAC;IACF,MAAM,YAAY,CAAC,qBAAqB,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IACxE,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC1B,2BAA2B,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC5C,OAAO,QAA2B,CAAC;AACrC,CAAC"}

package/dist/document-authoring/application/policies/document-transaction-digests.d.ts

@@ -0,0 +1,5 @@
+import type { DocumentAuthorityDigest } from "../model/document-catalog.js";
+import type { DocumentTransactionEnvelope, DocumentTransactionJournal } from "../model/document-transaction.js";
+export declare function documentTransactionPayloadDigest(journal: DocumentTransactionJournal): DocumentAuthorityDigest;
+export declare function documentTransactionEnvelopeDigest(envelope: DocumentTransactionEnvelope | Omit<DocumentTransactionEnvelope, "envelopeDigest">): DocumentAuthorityDigest;
+//# sourceMappingURL=document-transaction-digests.d.ts.map

package/dist/document-authoring/application/policies/document-transaction-digests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-transaction-digests.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/policies/document-transaction-digests.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EACV,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,kCAAkC,CAAC;AAM1C,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,0BAA0B,GAClC,uBAAuB,CAEzB;AAED,wBAAgB,iCAAiC,CAC/C,QAAQ,EACJ,2BAA2B,GAC3B,IAAI,CAAC,2BAA2B,EAAE,gBAAgB,CAAC,GACtD,uBAAuB,CAMzB"}

package/dist/document-authoring/application/policies/document-transaction-digests.js

@@ -0,0 +1,12 @@
+import { canonicalJson, sha256Json } from "../../../canonical-json.js";
+function canonicalSnapshot(value) {
+    return JSON.parse(canonicalJson(value));
+}
+export function documentTransactionPayloadDigest(journal) {
+    return sha256Json(canonicalSnapshot(journal));
+}
+export function documentTransactionEnvelopeDigest(envelope) {
+    const { envelopeDigest: _ignored, ...body } = envelope;
+    return sha256Json(canonicalSnapshot(body));
+}
+//# sourceMappingURL=document-transaction-digests.js.map

package/dist/document-authoring/application/policies/document-transaction-digests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-transaction-digests.js","sourceRoot":"","sources":["../../../../src/document-authoring/application/policies/document-transaction-digests.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAEb,UAAU,EACX,MAAM,4BAA4B,CAAC;AAOpC,SAAS,iBAAiB,CAAI,KAAQ;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAsC,CAAC,CAAM,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,OAAmC;IAEnC,OAAO,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAkC,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,QAEuD;IAEvD,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GACzC,QAAuC,CAAC;IAC1C,OAAO,UAAU,CACf,iBAAiB,CAAC,IAAI,CAAkC,CACzD,CAAC;AACJ,CAAC"}

package/dist/document-authoring/application/policies/document-transaction-envelope-policy.d.ts

@@ -0,0 +1,4 @@
+import type { DocumentTransactionEnvelope, DocumentTransactionEnvelopeBody } from "../model/document-transaction.js";
+export declare function assertDocumentTransactionEnvelope(value: unknown): Promise<DocumentTransactionEnvelope>;
+export declare function createDocumentTransactionEnvelope(body: DocumentTransactionEnvelopeBody): Promise<DocumentTransactionEnvelope>;
+//# sourceMappingURL=document-transaction-envelope-policy.d.ts.map

package/dist/document-authoring/application/policies/document-transaction-envelope-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-transaction-envelope-policy.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/policies/document-transaction-envelope-policy.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,2BAA2B,EAC3B,+BAA+B,EAEhC,MAAM,kCAAkC,CAAC;AA0G1C,wBAAsB,iCAAiC,CACrD,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,2BAA2B,CAAC,CAkDtC;AAED,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,+BAA+B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CAWtC"}

package/dist/document-authoring/application/policies/document-transaction-envelope-policy.js

@@ -0,0 +1,118 @@
+import { canonicalJson } from "../../../canonical-json.js";
+import { assertSchema } from "../../../schema-catalog.js";
+import { assertNonzeroDocumentPhysicalIdentity } from "../model/document-physical-identity.js";
+import { assertDocumentPlanDigests } from "./document-contract-digests.js";
+import { documentTemporaryPath } from "./document-temporary-path.js";
+import { documentTransactionEnvelopeDigest, documentTransactionPayloadDigest } from "./document-transaction-digests.js";
+class DocumentTransactionEnvelopeError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "DocumentTransactionEnvelopeError";
+    }
+}
+function canonicalSnapshot(value) {
+    try {
+        return JSON.parse(canonicalJson(value));
+    }
+    catch (error) {
+        throw new DocumentTransactionEnvelopeError("Document transaction envelope must use canonical JSON values.", { cause: error });
+    }
+}
+function deepFreezeCanonical(value) {
+    const pending = [];
+    if (value !== null && typeof value === "object") {
+        pending.push(value);
+    }
+    while (pending.length > 0) {
+        const current = pending.pop();
+        if (current === undefined || Object.isFrozen(current)) {
+            continue;
+        }
+        for (const key of Reflect.ownKeys(current)) {
+            const descriptor = Object.getOwnPropertyDescriptor(current, key);
+            const child = descriptor !== undefined && "value" in descriptor
+                ? descriptor.value
+                : undefined;
+            if (typeof child === "object" && child !== null) {
+                pending.push(child);
+            }
+        }
+        Object.freeze(current);
+    }
+    return value;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function hasOwnedTemporary(journal) {
+    return "ownedTemporary" in journal;
+}
+function assertLifecycleBindings(envelope) {
+    const { journal } = envelope;
+    const { destination } = journal;
+    if (destination.path !== journal.plan.destination ||
+        envelope.foundation.version !== journal.plan.compiler.version ||
+        envelope.foundation.buildIdentity !== journal.plan.compiler.buildIdentity) {
+        throw new DocumentTransactionEnvelopeError("Document transaction lifecycle does not bind the embedded Plan.");
+    }
+    if (hasOwnedTemporary(journal) &&
+        journal.ownedTemporary.digest !== journal.plan.output.digest) {
+        throw new DocumentTransactionEnvelopeError("Document transaction temporary does not bind the planned output.");
+    }
+    if (hasOwnedTemporary(journal)) {
+        assertNonzeroDocumentPhysicalIdentity(journal.ownedTemporary.identity);
+        if (journal.ownedTemporary.path !==
+            documentTemporaryPath(journal.plan.destination, journal.plan.planDigest)) {
+            throw new DocumentTransactionEnvelopeError("Document transaction temporary path does not bind the embedded Plan.");
+        }
+    }
+    if (envelope.state === "PUBLISHED") {
+        assertNonzeroDocumentPhysicalIdentity(envelope.journal.publicationIdentity);
+    }
+}
+export async function assertDocumentTransactionEnvelope(value) {
+    const candidate = deepFreezeCanonical(canonicalSnapshot(value));
+    if (!isRecord(candidate)) {
+        throw new DocumentTransactionEnvelopeError("Document transaction envelope must be an object.");
+    }
+    const handler = candidate["recoveryHandler"];
+    if (candidate["schemaVersion"] !== 3 ||
+        candidate["operationKind"] !== "document-authoring" ||
+        !isRecord(handler) ||
+        handler["id"] !== "foundation.document-authoring" ||
+        handler["contractVersion"] !== 2 ||
+        candidate["adapterContractVersion"] !== 1 ||
+        candidate["payloadKind"] !== "document-authoring-journal/v2" ||
+        !["PREPARED", "PUBLISHING", "PUBLISHED"].includes(String(candidate["state"]))) {
+        throw new DocumentTransactionEnvelopeError("Document transaction envelope constants are invalid.");
+    }
+    try {
+        await assertSchema("foundation-transaction-envelope/v3", candidate, "document-transaction-envelope");
+    }
+    catch (error) {
+        throw new DocumentTransactionEnvelopeError("Document transaction envelope does not match the closed v3 schema.", { cause: error });
+    }
+    const envelope = candidate;
+    assertDocumentPlanDigests(envelope.journal.plan);
+    assertLifecycleBindings(envelope);
+    if (envelope.payloadDigest !==
+        documentTransactionPayloadDigest(envelope.journal) ||
+        envelope.envelopeDigest !==
+            documentTransactionEnvelopeDigest(envelope)) {
+        throw new DocumentTransactionEnvelopeError("Document transaction envelope digest is invalid.");
+    }
+    return envelope;
+}
+export async function createDocumentTransactionEnvelope(body) {
+    const snapshot = deepFreezeCanonical(canonicalSnapshot(body));
+    const withPayload = {
+        ...snapshot,
+        payloadDigest: documentTransactionPayloadDigest(snapshot.journal)
+    };
+    const envelope = deepFreezeCanonical({
+        ...withPayload,
+        envelopeDigest: documentTransactionEnvelopeDigest(withPayload)
+    });
+    return assertDocumentTransactionEnvelope(envelope);
+}
+//# sourceMappingURL=document-transaction-envelope-policy.js.map

package/dist/document-authoring/application/policies/document-transaction-envelope-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-transaction-envelope-policy.js","sourceRoot":"","sources":["../../../../src/document-authoring/application/policies/document-transaction-envelope-policy.ts"],"names":[],"mappings":"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"}