@agent-teams/document-authoring 0.0.0

package/dist/adapters/node/node-document-template-reader.js

@@ -0,0 +1,32 @@
+import { assertNotCancelled } from "../../cancellation.js";
+import { CapabilityInputError } from "../../capability-runtime.js";
+import { DocumentCatalogError } from "../../document-catalog-error.js";
+import { DocumentPlanningError } from "../../document-planning-error.js";
+import { readDocumentAuthorityFile } from "./read-document-authority-file.js";
+const MAX_TEMPLATE_BYTES = 256 * 1024;
+export class NodeDocumentTemplateReader {
+    async read(request) {
+        assertNotCancelled(request.signal);
+        try {
+            const file = await readDocumentAuthorityFile({
+                consumerRoot: request.consumerRoot,
+                maxBytes: MAX_TEMPLATE_BYTES,
+                path: request.path
+            });
+            assertNotCancelled(request.signal);
+            return Object.freeze({ evidence: file.evidence, source: file.source });
+        }
+        catch (error) {
+            if (error instanceof CapabilityInputError || error instanceof DocumentPlanningError) {
+                throw error;
+            }
+            if (error instanceof DocumentCatalogError) {
+                throw new DocumentPlanningError(error.code === "DOCUMENT_CATALOG_INPUT_INVALID"
+                    ? "DOCUMENT_PLANNING_INPUT_INVALID"
+                    : "DOCUMENT_PLANNING_AUTHORITY_UNAVAILABLE", `Document template is unavailable or invalid: ${request.path}.`, { cause: error });
+            }
+            throw new DocumentPlanningError("DOCUMENT_PLANNING_AUTHORITY_UNAVAILABLE", `Document template is unavailable or invalid: ${request.path}.`, { cause: error });
+        }
+    }
+}
+//# sourceMappingURL=node-document-template-reader.js.map

package/dist/adapters/node/node-document-template-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-template-reader.js","sourceRoot":"","sources":["../../../src/adapters/node/node-document-template-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,MAAM,kBAAkB,GAAG,GAAG,GAAG,IAAI,CAAC;AAEtC,MAAM,OAAO,0BAA0B;IACrC,KAAK,CAAC,IAAI,CAAC,OAIV;QACC,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,yBAAyB,CAAC;gBAC3C,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB,CAAC,CAAC;YACH,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACnC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,oBAAoB,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;gBACpF,MAAM,KAAK,CAAC;YACd,CAAC;YACD,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;gBAC1C,MAAM,IAAI,qBAAqB,CAC7B,KAAK,CAAC,IAAI,KAAK,gCAAgC;oBAC7C,CAAC,CAAC,iCAAiC;oBACnC,CAAC,CAAC,yCAAyC,EAC7C,gDAAgD,OAAO,CAAC,IAAI,GAAG,EAC/D,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,qBAAqB,CAC7B,yCAAyC,EACzC,gDAAgD,OAAO,CAAC,IAAI,GAAG,EAC/D,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/adapters/node/node-document-transaction-coordinator.d.ts

@@ -0,0 +1,11 @@
+import type { DocumentTransactionCoordinator, DocumentTransactionLease, DocumentTransactionStatus } from "../../application/ports/document-transaction-coordinator.js";
+export declare class NodeDocumentTransactionCoordinator implements DocumentTransactionCoordinator {
+    #private;
+    constructor(consumerRoot: string);
+    inspect(): Promise<DocumentTransactionStatus>;
+    acquire(_request: {
+        readonly mode: "apply" | "recover";
+    }): Promise<DocumentTransactionLease>;
+}
+export declare function createNodeDocumentTransactionCoordinator(consumerRoot: string): DocumentTransactionCoordinator;
+//# sourceMappingURL=node-document-transaction-coordinator.d.ts.map

package/dist/adapters/node/node-document-transaction-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-transaction-coordinator.d.ts","sourceRoot":"","sources":["../../../src/adapters/node/node-document-transaction-coordinator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,8BAA8B,EAC9B,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,6DAA6D,CAAC;AAerE,qBAAa,kCAAmC,YAAW,8BAA8B;;IAGvF,YAAY,YAAY,EAAE,MAAM,EAE/B;IAEK,OAAO,IAAI,OAAO,CAAC,yBAAyB,CAAC,CAElD;IAEK,OAAO,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAgCjG;CACF;AAED,wBAAgB,wCAAwC,CACtD,YAAY,EAAE,MAAM,GACnB,8BAA8B,CAEhC"}

package/dist/adapters/node/node-document-transaction-coordinator.js

@@ -0,0 +1,60 @@
+import { acquireMutationLease, releaseMutationLease, retainMutationBarrier } from "@agent-teams/repository-mutation/node";
+import { inspectDocumentTransactionV2 } from "../../composition/inspect-document-transaction.js";
+function projected(inspection) {
+    if (inspection.state === "idle") {
+        return { state: "idle" };
+    }
+    if (inspection.state === "recoverable") {
+        return { state: "recoverable" };
+    }
+    return { state: "manual-recovery-required", reason: inspection.reason };
+}
+export class NodeDocumentTransactionCoordinator {
+    #consumerRoot;
+    constructor(consumerRoot) {
+        this.#consumerRoot = consumerRoot;
+    }
+    async inspect() {
+        return projected(await inspectDocumentTransactionV2(this.#consumerRoot));
+    }
+    async acquire(_request) {
+        const lease = await acquireMutationLease(this.#consumerRoot);
+        let held = true;
+        try {
+            const status = await this.inspect();
+            return {
+                status,
+                release: async (options) => {
+                    if (!held) {
+                        return;
+                    }
+                    if (options?.retainTransactionBarrier === true) {
+                        retainMutationBarrier(lease);
+                    }
+                    else {
+                        try {
+                            if ((await this.inspect()).state !== "idle") {
+                                retainMutationBarrier(lease);
+                            }
+                        }
+                        catch {
+                            retainMutationBarrier(lease);
+                        }
+                    }
+                    await releaseMutationLease(lease);
+                    held = false;
+                }
+            };
+        }
+        catch (error) {
+            retainMutationBarrier(lease);
+            await releaseMutationLease(lease);
+            held = false;
+            throw error;
+        }
+    }
+}
+export function createNodeDocumentTransactionCoordinator(consumerRoot) {
+    return new NodeDocumentTransactionCoordinator(consumerRoot);
+}
+//# sourceMappingURL=node-document-transaction-coordinator.js.map

package/dist/adapters/node/node-document-transaction-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-transaction-coordinator.js","sourceRoot":"","sources":["../../../src/adapters/node/node-document-transaction-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EAEtB,MAAM,uCAAuC,CAAC;AAO/C,OAAO,EAAE,4BAA4B,EAAE,MAAM,mDAAmD,CAAC;AAEjG,SAAS,SAAS,CAChB,UAAoE;IAEpE,IAAI,UAAU,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QAChC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC3B,CAAC;IACD,IAAI,UAAU,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;QACvC,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IAClC,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,0BAA0B,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;AAC1E,CAAC;AAED,MAAM,OAAO,kCAAkC;IACpC,aAAa,CAAS;IAE/B,YAAY,YAAoB;QAC9B,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,OAAO;QACX,OAAO,SAAS,CAAC,MAAM,4BAA4B,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgD;QAC5D,MAAM,KAAK,GAAkB,MAAM,oBAAoB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5E,IAAI,IAAI,GAAG,IAAI,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACpC,OAAO;gBACL,MAAM;gBACN,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;oBACzB,IAAI,CAAC,IAAI,EAAE,CAAC;wBACV,OAAO;oBACT,CAAC;oBACD,IAAI,OAAO,EAAE,wBAAwB,KAAK,IAAI,EAAE,CAAC;wBAC/C,qBAAqB,CAAC,KAAK,CAAC,CAAC;oBAC/B,CAAC;yBAAM,CAAC;wBACN,IAAI,CAAC;4BACH,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;gCAC5C,qBAAqB,CAAC,KAAK,CAAC,CAAC;4BAC/B,CAAC;wBACH,CAAC;wBAAC,MAAM,CAAC;4BACP,qBAAqB,CAAC,KAAK,CAAC,CAAC;wBAC/B,CAAC;oBACH,CAAC;oBACD,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC;oBAClC,IAAI,GAAG,KAAK,CAAC;gBACf,CAAC;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAqB,CAAC,KAAK,CAAC,CAAC;YAC7B,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,GAAG,KAAK,CAAC;YACb,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,wCAAwC,CACtD,YAAoB;IAEpB,OAAO,IAAI,kCAAkC,CAAC,YAAY,CAAC,CAAC;AAC9D,CAAC"}

package/dist/adapters/node/node-metadata-instance-validator.d.ts

@@ -0,0 +1,9 @@
+import type { MetadataInstanceValidator, MetadataSchemaSnapshot } from "../../application/ports/metadata-instance-validator.js";
+export declare class NodeMetadataInstanceValidator implements MetadataInstanceValidator {
+    load(request: {
+        readonly consumerRoot: string;
+        readonly path: string;
+        readonly signal?: AbortSignal;
+    }): Promise<MetadataSchemaSnapshot>;
+}
+//# sourceMappingURL=node-metadata-instance-validator.d.ts.map

package/dist/adapters/node/node-metadata-instance-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-metadata-instance-validator.d.ts","sourceRoot":"","sources":["../../../src/adapters/node/node-metadata-instance-validator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,yBAAyB,EACzB,sBAAsB,EAEvB,MAAM,wDAAwD,CAAC;AAmDhE,qBAAa,6BAA8B,YAAW,yBAAyB;IACvE,IAAI,CAAC,OAAO,EAAE;QAClB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAiDlC;CACF"}

package/dist/adapters/node/node-metadata-instance-validator.js

@@ -0,0 +1,90 @@
+import { Ajv2020 } from "ajv/dist/2020.js";
+import { assertNotCancelled } from "../../cancellation.js";
+import { parseStrictJson, StrictJsonError } from "../../strict-json.js";
+import { DocumentCatalogError } from "../../document-catalog-error.js";
+import { readDocumentAuthorityFile } from "./read-document-authority-file.js";
+const MAX_METADATA_SCHEMA_BYTES = 1024 * 1024;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function invalidSchema(message, cause) {
+    throw new DocumentCatalogError("DOCUMENT_CATALOG_INPUT_INVALID", message, cause === undefined ? undefined : { cause });
+}
+function assertLocalReferences(value) {
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            assertLocalReferences(item);
+        }
+        return;
+    }
+    if (!isRecord(value)) {
+        return;
+    }
+    for (const [key, item] of Object.entries(value)) {
+        if (key === "$ref" && (typeof item !== "string" || !item.startsWith("#"))) {
+            invalidSchema("Document metadata schema may use only local fragment $ref values.");
+        }
+        if (["$async", "$dynamicRef", "$recursiveRef"].includes(key)) {
+            invalidSchema("Document metadata schema may not use async, dynamic, or recursive validation.");
+        }
+        assertLocalReferences(item);
+    }
+}
+function messages(errors) {
+    return Object.freeze((errors ?? [])
+        .slice(0, 16)
+        .map((error) => `${error.instancePath || "/"} ${error.message ?? "is invalid"}`.slice(0, 1000)));
+}
+export class NodeMetadataInstanceValidator {
+    async load(request) {
+        assertNotCancelled(request.signal);
+        const file = await readDocumentAuthorityFile({
+            consumerRoot: request.consumerRoot,
+            maxBytes: MAX_METADATA_SCHEMA_BYTES,
+            path: request.path
+        });
+        assertNotCancelled(request.signal);
+        let schema;
+        try {
+            schema = parseStrictJson(file.source);
+        }
+        catch (error) {
+            if (error instanceof StrictJsonError) {
+                invalidSchema("Document metadata schema must contain strict JSON.", error);
+            }
+            throw error;
+        }
+        if (!isRecord(schema)) {
+            invalidSchema("Document metadata schema must be a JSON object.");
+        }
+        assertLocalReferences(schema);
+        const ajv = new Ajv2020({
+            allErrors: true,
+            strict: true,
+            strictTuples: false,
+            validateFormats: false
+        });
+        let validate;
+        try {
+            validate = ajv.compile(schema);
+        }
+        catch (error) {
+            invalidSchema("Document metadata schema cannot be compiled as Draft 2020-12.", error);
+        }
+        assertNotCancelled(request.signal);
+        return Object.freeze({
+            evidence: file.evidence,
+            ...(Array.isArray(schema["required"]) &&
+                schema["required"].every((item) => typeof item === "string")
+                ? {
+                    requiredProperties: Object.freeze([...new Set(schema["required"])].toSorted())
+                }
+                : {}),
+            validate(instance) {
+                const valid = validate(instance);
+                return Object.freeze({ messages: messages(validate.errors), valid });
+            }
+        });
+    }
+}
+//# sourceMappingURL=node-metadata-instance-validator.js.map

package/dist/adapters/node/node-metadata-instance-validator.js.map

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

package/dist/adapters/node/node-owner-membership-reader.d.ts

@@ -0,0 +1,10 @@
+import type { OwnerMembershipReader, OwnerMembershipSnapshot } from "../../application/ports/owner-membership-reader.js";
+export declare class NodeOwnerMembershipReader implements OwnerMembershipReader {
+    read(request: {
+        readonly consumerRoot: string;
+        readonly contract: "foundation.owner-map/v1";
+        readonly path: string;
+        readonly signal?: AbortSignal;
+    }): Promise<OwnerMembershipSnapshot>;
+}
+//# sourceMappingURL=node-owner-membership-reader.d.ts.map

package/dist/adapters/node/node-owner-membership-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-owner-membership-reader.d.ts","sourceRoot":"","sources":["../../../src/adapters/node/node-owner-membership-reader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,oDAAoD,CAAC;AA8D5D,qBAAa,yBAA0B,YAAW,qBAAqB;IAC/D,IAAI,CAAC,OAAO,EAAE;QAClB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;QAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CASnC;CACF"}

package/dist/adapters/node/node-owner-membership-reader.js

@@ -0,0 +1,62 @@
+import { CapabilityInputError } from "../../capability-runtime.js";
+import { assertNotCancelled } from "../../cancellation.js";
+import { compareBinaryStrings } from "../../binary-string-comparator.js";
+import { parseStrictYamlSource } from "../../strict-yaml.js";
+import { DocumentCatalogError } from "../../document-catalog-error.js";
+import { readDocumentAuthorityFile } from "./read-document-authority-file.js";
+const MAX_OWNER_CATALOG_BYTES = 1024 * 1024;
+const MAX_OWNER_COUNT = 4096;
+const OWNER_ID = /^[A-Za-z0-9@][A-Za-z0-9@._/-]*$/u;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function invalidOwnerCatalog(message, cause) {
+    throw new DocumentCatalogError("DOCUMENT_CATALOG_INPUT_INVALID", message, cause === undefined ? undefined : { cause });
+}
+function parseOwnerIds(source) {
+    let input;
+    try {
+        input = parseStrictYamlSource(source, "document-owner-catalog");
+    }
+    catch (error) {
+        if (error instanceof CapabilityInputError) {
+            invalidOwnerCatalog("Document owner catalog must contain strict YAML.", error);
+        }
+        throw error;
+    }
+    if (!isRecord(input)) {
+        invalidOwnerCatalog("Document owner catalog must be an object.");
+    }
+    const keys = Object.keys(input).toSorted(compareBinaryStrings);
+    if (keys.length !== 2 ||
+        keys[0] !== "owners" ||
+        keys[1] !== "version" ||
+        input.version !== 1 ||
+        !isRecord(input.owners)) {
+        invalidOwnerCatalog("Document owner catalog must contain only version 1 and an owners object.");
+    }
+    const owners = input.owners;
+    const ids = Object.keys(owners).toSorted(compareBinaryStrings);
+    if (ids.length === 0 || ids.length > MAX_OWNER_COUNT) {
+        invalidOwnerCatalog(`Document owner catalog must contain between 1 and ${MAX_OWNER_COUNT} owners.`);
+    }
+    for (const id of ids) {
+        if (id.length > 214 || !OWNER_ID.test(id) || !isRecord(owners[id])) {
+            invalidOwnerCatalog("Document owner IDs must be normalized opaque identifiers with object metadata.");
+        }
+    }
+    return Object.freeze(ids);
+}
+export class NodeOwnerMembershipReader {
+    async read(request) {
+        assertNotCancelled(request.signal);
+        const file = await readDocumentAuthorityFile({
+            consumerRoot: request.consumerRoot,
+            maxBytes: MAX_OWNER_CATALOG_BYTES,
+            path: request.path
+        });
+        assertNotCancelled(request.signal);
+        return Object.freeze({ evidence: file.evidence, ids: parseOwnerIds(file.source) });
+    }
+}
+//# sourceMappingURL=node-owner-membership-reader.js.map

package/dist/adapters/node/node-owner-membership-reader.js.map

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

package/dist/adapters/node/node-path-authority.d.ts

@@ -0,0 +1,53 @@
+import type { PortablePathIdentity } from "@agent-teams/repository-mutation";
+interface NodePathAuthorityStat {
+    readonly birthtimeNs: bigint;
+    readonly dev: bigint;
+    readonly ino: bigint;
+    isDirectory(): boolean;
+    isSymbolicLink(): boolean;
+}
+export interface NodePathAuthorityOperations {
+    readonly lstat: (path: string) => Promise<NodePathAuthorityStat>;
+    readonly readdir: (path: string) => Promise<string[]>;
+    readonly realpath: (path: string) => Promise<string>;
+}
+export interface NodeRepositoryRootAuthority {
+    readonly canonicalRoot: string;
+    readonly identity: PortablePathIdentity;
+    readonly lexicalRoot: string;
+}
+export interface NodeRepositoryDirectoryAuthority {
+    readonly ancestry: readonly {
+        readonly absolutePath: string;
+        readonly identity: PortablePathIdentity;
+        readonly repositoryPath: string;
+    }[];
+    readonly directory: string;
+    readonly directoryIdentity: PortablePathIdentity;
+    readonly repositoryPath: string;
+    readonly root: NodeRepositoryRootAuthority;
+}
+export interface NodeRepositoryPathAuthority {
+    readonly ancestry: NodeRepositoryDirectoryAuthority["ancestry"];
+    readonly destinationPath: string;
+    readonly parent: string;
+    readonly parentIdentity: PortablePathIdentity;
+    readonly repositoryPath: string;
+    readonly root: NodeRepositoryRootAuthority;
+}
+export declare function sameNodePathIdentity(left: PortablePathIdentity, right: PortablePathIdentity): boolean;
+export declare function captureNodeRepositoryRootAuthority(consumerRoot: string, operations?: NodePathAuthorityOperations): Promise<NodeRepositoryRootAuthority>;
+export declare function captureNodeRepositoryDirectoryAuthority(request: {
+    readonly consumerRoot: string;
+    readonly operations?: NodePathAuthorityOperations;
+    readonly repositoryPath: string;
+}): Promise<NodeRepositoryDirectoryAuthority>;
+export declare function captureNodeRepositoryPathAuthority(request: {
+    readonly consumerRoot: string;
+    readonly operations?: NodePathAuthorityOperations;
+    readonly repositoryPath: string;
+}): Promise<NodeRepositoryPathAuthority>;
+export declare function sameNodePathAncestry(left: NodeRepositoryDirectoryAuthority["ancestry"], right: NodeRepositoryDirectoryAuthority["ancestry"]): boolean;
+export declare function recaptureNodeRepositoryPathAuthority(authority: NodeRepositoryPathAuthority, operations?: NodePathAuthorityOperations): Promise<NodeRepositoryPathAuthority>;
+export {};
+//# sourceMappingURL=node-path-authority.d.ts.map

package/dist/adapters/node/node-path-authority.d.ts.map

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

package/dist/adapters/node/node-path-authority.js

@@ -0,0 +1,186 @@
+import { lstat, readdir, realpath } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve, sep } from "node:path";
+import { portableRepositoryPathIdentity } from "@agent-teams/repository-mutation";
+import { isDocumentRepositoryPath } from "../../application/policies/document-repository-path.js";
+const nodeOperations = {
+    lstat: (path) => lstat(path, { bigint: true }),
+    readdir,
+    realpath
+};
+// Threat contract: portable Node does not expose mkdirat/linkat/openat2
+// confinement through a held directory descriptor. These adapters therefore
+// protect cooperative Foundation writers and fail closed on observable moves,
+// replacements, and symlink swaps. A malicious same-OS-user process can still
+// win an unobservable gap between a proof and a pathname syscall (including
+// mkdir -> first lstat, open, and link), and may cause an out-of-root side
+// effect before the post-operation proof rejects the result. Such hostile
+// syscall racing is outside the portable adapter guarantee. Callers must
+// recapture before and after every sensitive operation and must never claim
+// ownership, journal evidence, or report publication when either proof differs.
+function identity(metadata) {
+    const value = {
+        birthtimeNs: metadata.birthtimeNs,
+        dev: metadata.dev,
+        ino: metadata.ino
+    };
+    if (value.birthtimeNs === 0n || value.dev === 0n || value.ino === 0n) {
+        throw new Error("Repository path authority has zero physical identity.");
+    }
+    return value;
+}
+export function sameNodePathIdentity(left, right) {
+    return left.birthtimeNs === right.birthtimeNs &&
+        left.dev === right.dev &&
+        left.ino === right.ino;
+}
+function contained(root, candidate) {
+    const relation = relative(root, candidate);
+    return relation === "" ||
+        (!isAbsolute(relation) && relation !== ".." && !relation.startsWith(`..${sep}`));
+}
+function assertRealDirectory(metadata, description) {
+    if (metadata.isSymbolicLink() || !metadata.isDirectory()) {
+        throw new Error(`${description} must be a real directory.`);
+    }
+}
+async function assertNoPortableAlias(parent, segment, operations) {
+    const expected = portableRepositoryPathIdentity(segment);
+    const entries = await operations.readdir(parent);
+    if (entries.some((entry) => entry !== segment && portableRepositoryPathIdentity(entry) === expected)) {
+        throw new Error(`Repository ancestry has a portable name collision: ${segment}.`);
+    }
+}
+export async function captureNodeRepositoryRootAuthority(consumerRoot, operations = nodeOperations) {
+    const lexicalRoot = resolve(consumerRoot);
+    const before = await operations.lstat(lexicalRoot);
+    assertRealDirectory(before, "Repository root");
+    const beforeIdentity = identity(before);
+    const canonicalRoot = await operations.realpath(lexicalRoot);
+    const [lexicalAfter, canonicalAfter] = await Promise.all([
+        operations.lstat(lexicalRoot),
+        operations.lstat(canonicalRoot)
+    ]);
+    assertRealDirectory(lexicalAfter, "Repository root");
+    assertRealDirectory(canonicalAfter, "Canonical repository root");
+    const lexicalAfterIdentity = identity(lexicalAfter);
+    const canonicalAfterIdentity = identity(canonicalAfter);
+    if (!sameNodePathIdentity(beforeIdentity, lexicalAfterIdentity) ||
+        !sameNodePathIdentity(lexicalAfterIdentity, canonicalAfterIdentity)) {
+        throw new Error("Repository root identity changed while it was captured.");
+    }
+    return Object.freeze({
+        canonicalRoot,
+        identity: canonicalAfterIdentity,
+        lexicalRoot
+    });
+}
+async function captureChildDirectory(root, parent, repositoryPath, segment, operations) {
+    await assertNoPortableAlias(parent, segment, operations);
+    const absolutePath = join(parent, segment);
+    const before = await operations.lstat(absolutePath);
+    assertRealDirectory(before, `Repository ancestry ${repositoryPath}`);
+    const beforeIdentity = identity(before);
+    const canonical = await operations.realpath(absolutePath);
+    if (resolve(canonical) !== resolve(absolutePath) ||
+        !contained(root.canonicalRoot, canonical)) {
+        throw new Error("Repository ancestry is redirected or escapes the repository.");
+    }
+    const after = await operations.lstat(absolutePath);
+    assertRealDirectory(after, `Repository ancestry ${repositoryPath}`);
+    const afterIdentity = identity(after);
+    if (!sameNodePathIdentity(beforeIdentity, afterIdentity)) {
+        throw new Error(`Repository ancestry identity changed: ${repositoryPath}.`);
+    }
+    return Object.freeze({
+        absolutePath: canonical,
+        identity: afterIdentity,
+        repositoryPath
+    });
+}
+export async function captureNodeRepositoryDirectoryAuthority(request) {
+    const operations = request.operations ?? nodeOperations;
+    if (request.repositoryPath !== "." &&
+        !isDocumentRepositoryPath(request.repositoryPath)) {
+        throw new Error("Repository directory is not a portable repository path.");
+    }
+    const root = await captureNodeRepositoryRootAuthority(request.consumerRoot, operations);
+    const ancestry = [{
+            absolutePath: root.canonicalRoot,
+            identity: root.identity,
+            repositoryPath: "."
+        }];
+    let parent = root.canonicalRoot;
+    const traversed = [];
+    if (request.repositoryPath !== ".") {
+        for (const segment of request.repositoryPath.split("/")) {
+            traversed.push(segment);
+            const captured = await captureChildDirectory(root, parent, traversed.join("/"), segment, operations);
+            ancestry.push(captured);
+            parent = captured.absolutePath;
+        }
+    }
+    const rootAfter = await captureNodeRepositoryRootAuthority(request.consumerRoot, operations);
+    if (!sameRootAuthority(root, rootAfter)) {
+        throw new Error("Repository root changed while ancestry was captured.");
+    }
+    const leaf = ancestry.at(-1);
+    return Object.freeze({
+        ancestry: Object.freeze(ancestry),
+        directory: leaf.absolutePath,
+        directoryIdentity: leaf.identity,
+        repositoryPath: request.repositoryPath,
+        root
+    });
+}
+export async function captureNodeRepositoryPathAuthority(request) {
+    if (!isDocumentRepositoryPath(request.repositoryPath)) {
+        throw new Error("Repository destination is not a portable repository path.");
+    }
+    const segments = request.repositoryPath.split("/");
+    const basename = segments.at(-1);
+    const parentRepositoryPath = segments.length === 1
+        ? "."
+        : segments.slice(0, -1).join("/");
+    const directory = await captureNodeRepositoryDirectoryAuthority({
+        consumerRoot: request.consumerRoot,
+        ...(request.operations === undefined ? {} : { operations: request.operations }),
+        repositoryPath: parentRepositoryPath
+    });
+    await assertNoPortableAlias(directory.directory, basename, request.operations ?? nodeOperations);
+    return Object.freeze({
+        ancestry: directory.ancestry,
+        destinationPath: join(directory.directory, basename),
+        parent: directory.directory,
+        parentIdentity: directory.directoryIdentity,
+        repositoryPath: request.repositoryPath,
+        root: directory.root
+    });
+}
+function sameRootAuthority(left, right) {
+    return left.canonicalRoot === right.canonicalRoot &&
+        left.lexicalRoot === right.lexicalRoot &&
+        sameNodePathIdentity(left.identity, right.identity);
+}
+export function sameNodePathAncestry(left, right) {
+    return left.length === right.length && left.every((entry, index) => {
+        const other = right[index];
+        return other !== undefined &&
+            entry.absolutePath === other.absolutePath &&
+            entry.repositoryPath === other.repositoryPath &&
+            sameNodePathIdentity(entry.identity, other.identity);
+    });
+}
+export async function recaptureNodeRepositoryPathAuthority(authority, operations = nodeOperations) {
+    const recaptured = await captureNodeRepositoryPathAuthority({
+        consumerRoot: authority.root.lexicalRoot,
+        operations,
+        repositoryPath: authority.repositoryPath
+    });
+    if (!sameRootAuthority(authority.root, recaptured.root) ||
+        !sameNodePathAncestry(authority.ancestry, recaptured.ancestry) ||
+        authority.destinationPath !== recaptured.destinationPath) {
+        throw new Error("Repository path authority changed during the operation.");
+    }
+    return recaptured;
+}
+//# sourceMappingURL=node-path-authority.js.map

package/dist/adapters/node/node-path-authority.js.map

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

package/dist/adapters/node/read-document-authority-file.d.ts

@@ -0,0 +1,12 @@
+import type { DocumentAuthorityEvidence } from "../../application/model/document-catalog.js";
+export interface DocumentAuthorityFile {
+    readonly bytes: Buffer;
+    readonly evidence: DocumentAuthorityEvidence;
+    readonly source: string;
+}
+export declare function readDocumentAuthorityFile(request: {
+    readonly consumerRoot: string;
+    readonly maxBytes: number;
+    readonly path: string;
+}): Promise<DocumentAuthorityFile>;
+//# sourceMappingURL=read-document-authority-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-document-authority-file.d.ts","sourceRoot":"","sources":["../../../src/adapters/node/read-document-authority-file.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEV,yBAAyB,EAC1B,MAAM,6CAA6C,CAAC;AAIrD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AA6DD,wBAAsB,yBAAyB,CAAC,OAAO,EAAE;IACvD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA4BjC"}