@agent-teams/document-authoring 0.0.0

package/dist/adapters/node/node-document-contract-validator.js

@@ -0,0 +1,306 @@
+import { isProxy } from "node:util/types";
+import { CapabilityInputError } from "../../capability-runtime.js";
+import { assertSchema } from "../../schema-catalog.js";
+import { DocumentPlanningError } from "../../document-planning-error.js";
+import { assertDocumentPlanDigests } from "../../application/policies/document-contract-digests.js";
+function invalidContract(kind, error) {
+    throw new DocumentPlanningError(kind === "Intent"
+        ? "DOCUMENT_PLANNING_INPUT_INVALID"
+        : "DOCUMENT_PLANNING_OUTPUT_INVALID", `Document ${kind} does not match its v1 contract: ${error.message.slice(0, 1000)}`, { cause: error });
+}
+const MAXIMUM_INTENT_DEPTH = 8;
+const MAXIMUM_INTENT_CONTAINER_ITEMS = 128;
+const MAXIMUM_DOCUMENT_OUTPUT_BYTES = 1024 * 1024;
+const MAXIMUM_PLAN_DEPTH = 12;
+const MAXIMUM_PLAN_JSON_BYTES = 4 * MAXIMUM_DOCUMENT_OUTPUT_BYTES;
+const MAXIMUM_PLAN_VALUES = MAXIMUM_DOCUMENT_OUTPUT_BYTES;
+const OUTPUT_INTENT_KEYS = new Set([
+    "additionalMetadata",
+    "id",
+    "owner",
+    "related",
+    "summary",
+    "title",
+    "type"
+]);
+const INTENT_ROOT_KEYS = new Set([
+    ...OUTPUT_INTENT_KEYS,
+    "destination",
+    "schemaVersion",
+    "slug"
+]);
+const STRING_INTENT_ROOT_KEYS = new Set([
+    "destination",
+    "id",
+    "owner",
+    "slug",
+    "summary",
+    "title",
+    "type"
+]);
+function addOutputLowerBound(budget, bytes) {
+    budget.outputLowerBoundBytes += bytes;
+    if (budget.outputLowerBoundBytes > MAXIMUM_DOCUMENT_OUTPUT_BYTES) {
+        throw new TypeError("Document Intent logically expands beyond the public document output byte limit.");
+    }
+}
+function isJsonScalar(value, contributesToOutput, budget) {
+    if (value === null || typeof value === "boolean" || typeof value === "string") {
+        if (contributesToOutput) {
+            addOutputLowerBound(budget, 1 + (typeof value === "string"
+                ? Buffer.byteLength(value.normalize("NFC"), "utf8")
+                : 1));
+        }
+        return true;
+    }
+    if (typeof value === "number") {
+        if (!Number.isSafeInteger(value) || Object.is(value, -0)) {
+            throw new TypeError("Document Intent numbers must be safe integers other than negative zero.");
+        }
+        if (contributesToOutput) {
+            addOutputLowerBound(budget, 1);
+        }
+        return true;
+    }
+    return false;
+}
+function inertContainerKeys(value) {
+    const keys = Reflect.ownKeys(value);
+    if (keys.some((key) => typeof key !== "string")) {
+        throw new TypeError("Document Intent must not contain symbol keys.");
+    }
+    const itemCount = Array.isArray(value) ? keys.length - 1 : keys.length;
+    if (itemCount > MAXIMUM_INTENT_CONTAINER_ITEMS) {
+        throw new TypeError("Document Intent container exceeds the item budget.");
+    }
+    if (Array.isArray(value) && keys.length !== value.length + 1) {
+        throw new TypeError("Document Intent arrays must be dense and contain no extra properties.");
+    }
+    return keys;
+}
+function assertIntrinsicJsonContainer(value) {
+    const prototype = Object.getPrototypeOf(value);
+    if ((Array.isArray(value) && prototype !== Array.prototype) ||
+        (!Array.isArray(value) && prototype !== Object.prototype && prototype !== null)) {
+        throw new TypeError("Document Intent containers must use intrinsic JSON prototypes.");
+    }
+}
+function assertIntentRootField(key, value) {
+    if (!INTENT_ROOT_KEYS.has(key)) {
+        throw new TypeError("Document Intent contains an unknown root field.");
+    }
+    if (STRING_INTENT_ROOT_KEYS.has(key) && typeof value !== "string") {
+        throw new TypeError(`Document Intent root field ${key} must be a string.`);
+    }
+    if (key === "schemaVersion" && value !== 1) {
+        throw new TypeError("Document Intent schemaVersion must equal 1.");
+    }
+}
+function assertInertJson(input) {
+    const pending = [
+        { action: "enter", contributesToOutput: false, depth: 0, value: input }
+    ];
+    const ancestors = new WeakSet();
+    const budget = { outputLowerBoundBytes: 0 };
+    while (pending.length > 0) {
+        const current = pending.pop();
+        if (current.action === "leave") {
+            ancestors.delete(current.value);
+            continue;
+        }
+        if (isJsonScalar(current.value, current.contributesToOutput, budget)) {
+            continue;
+        }
+        if (current.value === null || typeof current.value !== "object") {
+            throw new TypeError("Document Intent must use the closed JSON data model.");
+        }
+        if (isProxy(current.value)) {
+            throw new TypeError("Document Intent must not contain Proxy objects.");
+        }
+        if (current.depth > MAXIMUM_INTENT_DEPTH || ancestors.has(current.value)) {
+            throw new TypeError("Document Intent must be a bounded acyclic JSON tree.");
+        }
+        assertIntrinsicJsonContainer(current.value);
+        if (current.contributesToOutput) {
+            addOutputLowerBound(budget, 1);
+        }
+        ancestors.add(current.value);
+        pending.push({ action: "leave", value: current.value });
+        for (const key of inertContainerKeys(current.value)) {
+            if (key === "length" && Array.isArray(current.value)) {
+                continue;
+            }
+            const descriptor = Object.getOwnPropertyDescriptor(current.value, key);
+            if (descriptor === undefined ||
+                !("value" in descriptor) ||
+                descriptor.enumerable !== true) {
+                throw new TypeError("Document Intent must contain only enumerable own data properties.");
+            }
+            if (current.depth === 0) {
+                assertIntentRootField(key, descriptor.value);
+            }
+            pending.push({
+                action: "enter",
+                contributesToOutput: current.depth === 0
+                    ? OUTPUT_INTENT_KEYS.has(key)
+                    : current.contributesToOutput,
+                depth: current.depth + 1,
+                value: descriptor.value
+            });
+        }
+    }
+}
+function planContractTypeError(message) {
+    return new TypeError(`Document Plan ${message}`);
+}
+function defineSnapshotValue(target, key, value) {
+    Object.defineProperty(target, key, {
+        configurable: true,
+        enumerable: true,
+        value,
+        writable: true
+    });
+}
+function inspectPlanContainer(source) {
+    if (isProxy(source)) {
+        throw planContractTypeError("must not contain Proxy objects.");
+    }
+    const isArray = Array.isArray(source);
+    const prototype = Object.getPrototypeOf(source);
+    if ((isArray && prototype !== Array.prototype) ||
+        (!isArray && prototype !== Object.prototype && prototype !== null)) {
+        throw planContractTypeError("containers must use intrinsic JSON prototypes.");
+    }
+    const keys = Reflect.ownKeys(source);
+    if (keys.some((key) => typeof key !== "string")) {
+        throw planContractTypeError("must not contain symbol keys.");
+    }
+    if (isArray && keys.length !== source.length + 1) {
+        throw planContractTypeError("arrays must be dense and contain no extra properties.");
+    }
+    if (isArray &&
+        keys.some((key) => key !== "length" &&
+            (!/^(?:0|[1-9]\d*)$/u.test(String(key)) ||
+                Number(key) >= source.length ||
+                String(Number(key)) !== key))) {
+        throw planContractTypeError("arrays must be dense and contain no extra properties.");
+    }
+    return {
+        isArray,
+        keys: keys
+            .filter((key) => !(isArray && key === "length"))
+            .toSorted()
+    };
+}
+function planDataValue(source, key) {
+    const descriptor = Object.getOwnPropertyDescriptor(source, key);
+    if (descriptor === undefined ||
+        !("value" in descriptor) ||
+        descriptor.enumerable !== true) {
+        throw planContractTypeError("must contain only enumerable own data properties.");
+    }
+    return descriptor.value;
+}
+function accountPlanValue(budget, key, value) {
+    budget.values += 1;
+    budget.bytes += Buffer.byteLength(key, "utf8") + 1;
+    if (typeof value === "string") {
+        budget.bytes += Buffer.byteLength(value, "utf8") + 1;
+    }
+    else if (value === null || ["boolean", "number"].includes(typeof value)) {
+        budget.bytes += 1;
+    }
+    if (budget.values > MAXIMUM_PLAN_VALUES || budget.bytes > MAXIMUM_PLAN_JSON_BYTES) {
+        throw planContractTypeError("exceeds the bounded v1 contract input budget.");
+    }
+}
+function assertPlanScalar(value) {
+    if (value === null || typeof value === "boolean" || typeof value === "string") {
+        return true;
+    }
+    if (typeof value !== "number") {
+        return false;
+    }
+    if (!Number.isSafeInteger(value) || Object.is(value, -0)) {
+        throw planContractTypeError("numbers must be safe integers other than negative zero.");
+    }
+    return true;
+}
+function snapshotInertPlan(input) {
+    if (input === null || typeof input !== "object") {
+        throw planContractTypeError("must be a JSON object.");
+    }
+    if (isProxy(input) || Array.isArray(input)) {
+        throw planContractTypeError("must be an intrinsic, non-Proxy JSON object.");
+    }
+    const root = {};
+    const pending = [{ depth: 0, source: input, target: root }];
+    const observed = new WeakSet();
+    const budget = { bytes: 0, values: 0 };
+    while (pending.length > 0) {
+        const current = pending.pop();
+        if (observed.has(current.source)) {
+            throw planContractTypeError("must be an acyclic JSON tree without shared containers.");
+        }
+        observed.add(current.source);
+        if (current.depth > MAXIMUM_PLAN_DEPTH) {
+            throw planContractTypeError("exceeds the supported JSON depth.");
+        }
+        const { keys } = inspectPlanContainer(current.source);
+        for (const key of keys) {
+            const value = planDataValue(current.source, key);
+            accountPlanValue(budget, key, value);
+            if (assertPlanScalar(value)) {
+                defineSnapshotValue(current.target, key, value);
+                continue;
+            }
+            if (value === null || typeof value !== "object") {
+                throw planContractTypeError("must use the closed JSON data model.");
+            }
+            if (isProxy(value)) {
+                throw planContractTypeError("must not contain Proxy objects.");
+            }
+            const child = Array.isArray(value) ? [] : {};
+            defineSnapshotValue(current.target, key, child);
+            pending.push({ depth: current.depth + 1, source: value, target: child });
+        }
+        Object.freeze(current.target);
+    }
+    return root;
+}
+export class NodeDocumentContractValidator {
+    async validateIntent(input) {
+        try {
+            assertInertJson(input);
+            await assertSchema("document-intent/v1", input, "document-intent");
+            return input;
+        }
+        catch (error) {
+            if (error instanceof CapabilityInputError) {
+                invalidContract("Intent", error);
+            }
+            if (error instanceof TypeError) {
+                throw new DocumentPlanningError("DOCUMENT_PLANNING_INPUT_INVALID", `Document Intent must use inert canonical JSON data: ${error.message}`, { cause: error });
+            }
+            throw error;
+        }
+    }
+    async validatePlan(input) {
+        try {
+            const snapshot = snapshotInertPlan(input);
+            await assertSchema(snapshot.schemaVersion === 2 ? "document-plan/v2" : "document-plan/v1", snapshot, "document-plan");
+            assertDocumentPlanDigests(snapshot);
+            return snapshot;
+        }
+        catch (error) {
+            if (error instanceof CapabilityInputError) {
+                invalidContract("Plan", error);
+            }
+            if (error instanceof Error) {
+                throw new DocumentPlanningError("DOCUMENT_PLANNING_OUTPUT_INVALID", `Document Plan must use inert canonical JSON data and valid content bindings: ${error.message.slice(0, 1000)}`, { cause: error });
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=node-document-contract-validator.js.map

package/dist/adapters/node/node-document-contract-validator.js.map

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

package/dist/adapters/node/node-document-environment-inspector.d.ts

@@ -0,0 +1,17 @@
+import { lstat, realpath } from "node:fs/promises";
+import type { DocumentEnvironmentInspection, DocumentEnvironmentInspector } from "../../application/ports/document-environment-inspector.js";
+interface Dependencies {
+    readonly buildIdentity: () => Promise<string>;
+    readonly lstat: typeof lstat;
+    readonly platform: NodeJS.Platform;
+    readonly realpath: typeof realpath;
+    readonly version: () => Promise<string>;
+}
+type EnvironmentIdentityProviders = Pick<Dependencies, "buildIdentity" | "version">;
+export declare class NodeDocumentEnvironmentInspector implements DocumentEnvironmentInspector {
+    #private;
+    constructor(identity: EnvironmentIdentityProviders, filesystem?: Partial<Omit<Dependencies, "buildIdentity" | "version">>);
+    inspect(consumerRoot: string, signal?: AbortSignal): Promise<DocumentEnvironmentInspection>;
+}
+export {};
+//# sourceMappingURL=node-document-environment-inspector.d.ts.map

package/dist/adapters/node/node-document-environment-inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-environment-inspector.d.ts","sourceRoot":"","sources":["../../../src/adapters/node/node-document-environment-inspector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,KAAK,EACV,6BAA6B,EAC7B,4BAA4B,EAC7B,MAAM,2DAA2D,CAAC;AAEnE,UAAU,YAAY;IACpB,QAAQ,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,OAAO,QAAQ,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACzC;AAED,KAAK,4BAA4B,GAAG,IAAI,CAAC,YAAY,EAAE,eAAe,GAAG,SAAS,CAAC,CAAC;AAQpF,qBAAa,gCAAiC,YAAW,4BAA4B;;IAGnF,YACE,QAAQ,EAAE,4BAA4B,EACtC,UAAU,GAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,GAAG,SAAS,CAAC,CAAM,EAO1E;IAEK,OAAO,CACX,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,6BAA6B,CAAC,CAwCxC;CACF"}

package/dist/adapters/node/node-document-environment-inspector.js

@@ -0,0 +1,49 @@
+import { lstat, realpath } from "node:fs/promises";
+import { resolve } from "node:path";
+const nodeFilesystemDependencies = {
+    lstat,
+    platform: process.platform,
+    realpath
+};
+export class NodeDocumentEnvironmentInspector {
+    #dependencies;
+    constructor(identity, filesystem = {}) {
+        this.#dependencies = {
+            ...nodeFilesystemDependencies,
+            ...filesystem,
+            ...identity
+        };
+    }
+    async inspect(consumerRoot, signal) {
+        signal?.throwIfAborted();
+        const requestedRoot = resolve(consumerRoot);
+        const [metadata, canonicalRoot, installedVersion, installedBuildIdentity] = await Promise.all([
+            this.#dependencies.lstat(requestedRoot),
+            this.#dependencies.realpath(requestedRoot),
+            this.#dependencies.version(),
+            this.#dependencies.buildIdentity()
+        ]);
+        signal?.throwIfAborted();
+        if (metadata.isSymbolicLink() ||
+            !metadata.isDirectory()) {
+            throw new Error("Document doctor consumer root must be a canonical real directory.");
+        }
+        const canonicalMetadata = await this.#dependencies.lstat(canonicalRoot);
+        if (canonicalMetadata.isSymbolicLink() ||
+            !canonicalMetadata.isDirectory()) {
+            throw new Error("Document doctor consumer root must resolve to a real directory.");
+        }
+        signal?.throwIfAborted();
+        return Object.freeze({
+            installedFoundationVersion: installedVersion,
+            installedFoundationBuildIdentity: installedBuildIdentity,
+            filesystem: Object.freeze({
+                basis: "platform-contract",
+                strictDirectoryDurability: this.#dependencies.platform === "win32"
+                    ? "platform-unsupported"
+                    : "platform-supported"
+            })
+        });
+    }
+}
+//# sourceMappingURL=node-document-environment-inspector.js.map

package/dist/adapters/node/node-document-environment-inspector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-environment-inspector.js","sourceRoot":"","sources":["../../../src/adapters/node/node-document-environment-inspector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC,MAAM,0BAA0B,GAAoD;IAClF,KAAK;IACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;IAC1B,QAAQ;CACT,CAAC;AAEF,MAAM,OAAO,gCAAgC;IAClC,aAAa,CAAe;IAErC,YACE,QAAsC,EACtC,UAAU,GAA6D,EAAE;QAEzE,IAAI,CAAC,aAAa,GAAG;YACnB,GAAG,0BAA0B;YAC7B,GAAG,UAAU;YACb,GAAG,QAAQ;SACZ,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CACX,YAAoB,EACpB,MAAoB;QAEpB,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,MAAM,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,gBAAgB,EAAE,sBAAsB,CAAC,GACvE,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC;YACvC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC1C,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE;YAC5B,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE;SACnC,CAAC,CAAC;QACL,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,IACE,QAAQ,CAAC,cAAc,EAAE;YACzB,CAAC,QAAQ,CAAC,WAAW,EAAE,EACvB,CAAC;YACD,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;QACJ,CAAC;QACD,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACxE,IACE,iBAAiB,CAAC,cAAc,EAAE;YAClC,CAAC,iBAAiB,CAAC,WAAW,EAAE,EAChC,CAAC;YACD,MAAM,IAAI,KAAK,CACb,iEAAiE,CAClE,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,0BAA0B,EAAE,gBAAgB;YAC5C,gCAAgC,EAAE,sBAAsB;YACxD,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;gBACxB,KAAK,EAAE,mBAA4B;gBACnC,yBAAyB,EACvB,IAAI,CAAC,aAAa,CAAC,QAAQ,KAAK,OAAO;oBACrC,CAAC,CAAC,sBAA+B;oBACjC,CAAC,CAAC,oBAA6B;aACpC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/adapters/node/node-document-file-state.d.ts

@@ -0,0 +1,21 @@
+import type { DocumentOwnedTemporary } from "../../application/model/document-transaction.js";
+import type { DocumentPlanContract as DocumentPlan } from "../../application/model/document-planning.js";
+import type { DocumentDerivedTemporaryState, DocumentDestinationState, DocumentFileState, DocumentTemporaryState } from "../../application/ports/document-file-state.js";
+export declare class NodeDocumentFileState implements DocumentFileState {
+    classifyDerivedTemporary(request: {
+        readonly consumerRoot: string;
+        readonly plan: DocumentPlan;
+        readonly signal?: AbortSignal;
+    }): Promise<DocumentDerivedTemporaryState>;
+    classifyDestination(request: {
+        readonly consumerRoot: string;
+        readonly plan: DocumentPlan;
+        readonly signal?: AbortSignal;
+    }): Promise<DocumentDestinationState>;
+    classifyTemporary(request: {
+        readonly consumerRoot: string;
+        readonly signal?: AbortSignal;
+        readonly temporary: DocumentOwnedTemporary;
+    }): Promise<DocumentTemporaryState>;
+}
+//# sourceMappingURL=node-document-file-state.d.ts.map

package/dist/adapters/node/node-document-file-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-file-state.d.ts","sourceRoot":"","sources":["../../../src/adapters/node/node-document-file-state.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AAC9F,OAAO,KAAK,EAAE,oBAAoB,IAAI,YAAY,EAAE,MAAM,8CAA8C,CAAC;AACzG,OAAO,KAAK,EACV,6BAA6B,EAC7B,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,gDAAgD,CAAC;AA2FxD,qBAAa,qBAAsB,YAAW,iBAAiB;IACvD,wBAAwB,CAAC,OAAO,EAAE;QACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;QAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,6BAA6B,CAAC,CA+CzC;IAEK,mBAAmB,CAAC,OAAO,EAAE;QACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;QAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA8CpC;IAEK,iBAAiB,CAAC,OAAO,EAAE;QAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;QAC9B,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;KAC5C,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAiDlC;CACF"}

package/dist/adapters/node/node-document-file-state.js

@@ -0,0 +1,199 @@
+import { createHash } from "node:crypto";
+import { readBoundedRegularFile } from "@agent-teams/repository-mutation/node";
+import { assertNonzeroDocumentPhysicalIdentity } from "../../application/model/document-physical-identity.js";
+import { isDocumentRepositoryPath } from "../../application/policies/document-repository-path.js";
+import { documentTemporaryPath } from "../../application/policies/document-temporary-path.js";
+import { recaptureDocumentPublicationPaths, sameDocumentAncestry, sameDocumentPhysicalIdentity } from "./recapture-document-publication-paths.js";
+const MAXIMUM_DOCUMENT_BYTES = 1_048_576;
+function digest(bytes) {
+    return `sha256:${createHash("sha256").update(bytes).digest("hex")}`;
+}
+function identity(temporary) {
+    const value = temporary.identity;
+    try {
+        assertNonzeroDocumentPhysicalIdentity(value);
+    }
+    catch {
+        return undefined;
+    }
+    const result = {
+        dev: BigInt(value.dev),
+        ino: BigInt(value.ino),
+        birthtimeNs: BigInt(value.birthtimeNs)
+    };
+    return result;
+}
+function wireIdentity(identityValue) {
+    const result = {
+        adapter: "node-filesystem",
+        version: 1,
+        dev: identityValue.dev.toString(10),
+        ino: identityValue.ino.toString(10),
+        birthtimeNs: identityValue.birthtimeNs.toString(10)
+    };
+    assertNonzeroDocumentPhysicalIdentity(result);
+    return result;
+}
+function planPostimage(plan) {
+    return {
+        bytes: Buffer.from(plan.output.contentBase64, "base64"),
+        digest: plan.output.digest,
+        mode: 0o644,
+        size: plan.output.size
+    };
+}
+async function assertPublicationAncestryStable(consumerRoot, repositoryPath, before) {
+    const after = await recaptureDocumentPublicationPaths({
+        consumerRoot,
+        destination: repositoryPath
+    });
+    if (before.destinationPath !== after.destinationPath ||
+        !sameDocumentAncestry(before.ancestryIdentities, after.ancestryIdentities)) {
+        throw new Error("Document path ancestry changed while filesystem state was read.");
+    }
+}
+function conflict(error) {
+    return {
+        state: "conflict",
+        reason: typeof error === "string"
+            ? error
+            : error instanceof Error
+                ? error.message
+                : "Filesystem state is unverifiable."
+    };
+}
+function unverifiable(error) {
+    return {
+        state: "unverifiable",
+        reason: typeof error === "string"
+            ? error
+            : error instanceof Error
+                ? error.message
+                : "Filesystem state is unverifiable."
+    };
+}
+export class NodeDocumentFileState {
+    async classifyDerivedTemporary(request) {
+        request.signal?.throwIfAborted();
+        const path = documentTemporaryPath(request.plan.destination, request.plan.planDigest);
+        try {
+            const paths = await recaptureDocumentPublicationPaths({
+                consumerRoot: request.consumerRoot,
+                destination: path
+            });
+            request.signal?.throwIfAborted();
+            let observed;
+            try {
+                observed = await readBoundedRegularFile(paths.destinationPath, MAXIMUM_DOCUMENT_BYTES);
+            }
+            catch (error) {
+                if (error instanceof Error && "code" in error &&
+                    error.code === "ENOENT") {
+                    await assertPublicationAncestryStable(request.consumerRoot, path, paths);
+                    return { state: "absent" };
+                }
+                throw error;
+            }
+            request.signal?.throwIfAborted();
+            await assertPublicationAncestryStable(request.consumerRoot, path, paths);
+            if (observed.outcome !== "read") {
+                return unverifiable("Derived document temporary is not a stable regular file.");
+            }
+            const identityValue = wireIdentity(observed.identity);
+            return {
+                state: "present",
+                path,
+                identity: identityValue
+            };
+        }
+        catch (error) {
+            if (request.signal?.aborted === true) {
+                throw error;
+            }
+            return unverifiable(error);
+        }
+    }
+    async classifyDestination(request) {
+        try {
+            request.signal?.throwIfAborted();
+            const paths = await recaptureDocumentPublicationPaths({
+                consumerRoot: request.consumerRoot,
+                destination: request.plan.destination
+            });
+            request.signal?.throwIfAborted();
+            let observed;
+            try {
+                observed = await readBoundedRegularFile(paths.destinationPath, request.plan.output.size);
+            }
+            catch (error) {
+                if (error instanceof Error && "code" in error &&
+                    error.code === "ENOENT") {
+                    await assertPublicationAncestryStable(request.consumerRoot, request.plan.destination, paths);
+                    return { state: "absent" };
+                }
+                throw error;
+            }
+            request.signal?.throwIfAborted();
+            await assertPublicationAncestryStable(request.consumerRoot, request.plan.destination, paths);
+            const expected = planPostimage(request.plan);
+            if (observed.outcome !== "read" ||
+                observed.bytes.byteLength !== expected.size ||
+                digest(observed.bytes) !== expected.digest ||
+                (process.platform !== "win32" && (observed.mode & 0o777) !== expected.mode)) {
+                return conflict("Document destination is not the exact Plan output.");
+            }
+            return { state: "exact", identity: wireIdentity(observed.identity) };
+        }
+        catch (error) {
+            if (request.signal?.aborted === true) {
+                throw error;
+            }
+            return unverifiable(error);
+        }
+    }
+    async classifyTemporary(request) {
+        request.signal?.throwIfAborted();
+        const expected = identity(request.temporary);
+        if (expected === undefined) {
+            return unverifiable("Document temporary has invalid or zero physical identity.");
+        }
+        if (!isDocumentRepositoryPath(request.temporary.path)) {
+            return unverifiable("Document temporary path is not portable.");
+        }
+        try {
+            const paths = await recaptureDocumentPublicationPaths({
+                consumerRoot: request.consumerRoot,
+                destination: request.temporary.path
+            });
+            let observed;
+            try {
+                request.signal?.throwIfAborted();
+                observed = await readBoundedRegularFile(paths.destinationPath, MAXIMUM_DOCUMENT_BYTES);
+            }
+            catch (error) {
+                if (error instanceof Error && "code" in error &&
+                    error.code === "ENOENT") {
+                    await assertPublicationAncestryStable(request.consumerRoot, request.temporary.path, paths);
+                    return { state: "absent" };
+                }
+                throw error;
+            }
+            request.signal?.throwIfAborted();
+            await assertPublicationAncestryStable(request.consumerRoot, request.temporary.path, paths);
+            if (observed.outcome !== "read" ||
+                !sameDocumentPhysicalIdentity(observed.identity, expected) ||
+                digest(observed.bytes) !== request.temporary.digest ||
+                (process.platform !== "win32" && (observed.mode & 0o777) !== 0o644)) {
+                return conflict("Document temporary does not match its exact owned evidence.");
+            }
+            return { state: "owned-exact", temporary: request.temporary };
+        }
+        catch (error) {
+            if (request.signal?.aborted === true) {
+                throw error;
+            }
+            return unverifiable(error);
+        }
+    }
+}
+//# sourceMappingURL=node-document-file-state.js.map

package/dist/adapters/node/node-document-file-state.js.map

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