@agent-teams/document-authoring 0.0.0

package/dist/adapters/node/node-document-journal-store-faults.d.ts

@@ -0,0 +1,36 @@
+type NodeDocumentJournalFaultPoint = {
+    readonly phase: "after-candidate-synced";
+} | {
+    readonly phase: "after-canonical-quarantined";
+} | {
+    readonly phase: "after-canonical-published";
+} | {
+    readonly phase: "after-quarantine-removed";
+} | {
+    readonly operation: "create" | "remove" | "replace";
+    readonly phase: "before-final-directory-sync";
+} | {
+    readonly phase: "before-reconciliation-directory-sync";
+} | {
+    readonly evidence: "candidate" | "quarantine";
+    readonly operation: "create" | "remove" | "replace";
+    readonly path: string;
+    readonly phase: "before-private-cleanup";
+} | {
+    readonly evidence: "candidate" | "quarantine";
+    readonly operation: "create" | "remove" | "replace";
+    readonly path: string;
+    readonly phase: "before-logical-retirement";
+} | {
+    readonly operation: "remove" | "replace";
+    readonly path: string;
+    readonly phase: "before-shared-quarantine";
+} | {
+    readonly operation: "create" | "remove" | "replace";
+    readonly path: string;
+    readonly phase: "before-directory-sync";
+    readonly role: "destination" | "source" | "state-parent";
+};
+export type NodeDocumentJournalFaultInjector = (point: NodeDocumentJournalFaultPoint) => Promise<void> | void;
+export {};
+//# sourceMappingURL=node-document-journal-store-faults.d.ts.map

package/dist/adapters/node/node-document-journal-store-faults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-journal-store-faults.d.ts","sourceRoot":"","sources":["../../../src/adapters/node/node-document-journal-store-faults.ts"],"names":[],"mappings":"AAAA,KAAK,6BAA6B,GAC9B;IAAE,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,KAAK,EAAE,6BAA6B,CAAA;CAAE,GACjD;IAAE,QAAQ,CAAC,KAAK,EAAE,2BAA2B,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAA;CAAE,GAC9C;IACE,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,6BAA6B,CAAC;CAC/C,GACD;IAAE,QAAQ,CAAC,KAAK,EAAE,sCAAsC,CAAA;CAAE,GAC1D;IACE,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;CAC1C,GACD;IACE,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,2BAA2B,CAAC;CAC7C,GACD;IACE,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;CAC5C,GACD;IACE,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,QAAQ,GAAG,cAAc,CAAC;CAC1D,CAAC;AAEN,MAAM,MAAM,gCAAgC,GAAG,CAC7C,KAAK,EAAE,6BAA6B,KACjC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC"}

package/dist/adapters/node/node-document-journal-store-faults.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=node-document-journal-store-faults.js.map

package/dist/adapters/node/node-document-journal-store-faults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-journal-store-faults.js","sourceRoot":"","sources":["../../../src/adapters/node/node-document-journal-store-faults.ts"],"names":[],"mappings":""}

package/dist/adapters/node/node-document-journal-store-private.d.ts

@@ -0,0 +1,2 @@
+export { NodeDocumentJournalStore } from "./node-document-journal-store.js";
+//# sourceMappingURL=node-document-journal-store-private.d.ts.map

package/dist/adapters/node/node-document-journal-store-private.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-journal-store-private.d.ts","sourceRoot":"","sources":["../../../src/adapters/node/node-document-journal-store-private.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACzB,MAAM,kCAAkC,CAAC"}

package/dist/adapters/node/node-document-journal-store-private.js

@@ -0,0 +1,2 @@
+export { NodeDocumentJournalStore } from "./node-document-journal-store.js";
+//# sourceMappingURL=node-document-journal-store-private.js.map

package/dist/adapters/node/node-document-journal-store-private.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-journal-store-private.js","sourceRoot":"","sources":["../../../src/adapters/node/node-document-journal-store-private.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACzB,MAAM,kCAAkC,CAAC"}

package/dist/adapters/node/node-document-journal-store.d.ts

@@ -0,0 +1,22 @@
+import type { DocumentTransactionEnvelope } from "../../application/model/document-transaction.js";
+import type { DocumentJournalStore, JournalAuthority, StoredDocumentJournal } from "../../application/ports/document-journal-store.js";
+import type { NodeDocumentJournalFaultInjector } from "./node-document-journal-store-faults.js";
+interface NodeDocumentJournalOperations {
+    readonly faultInjector?: NodeDocumentJournalFaultInjector;
+}
+export declare class NodeDocumentJournalStore implements DocumentJournalStore {
+    #private;
+    readonly journalPath: string;
+    readonly operations: NodeDocumentJournalOperations;
+    constructor(journalPath: string, operations?: NodeDocumentJournalOperations);
+    read(): Promise<StoredDocumentJournal | undefined>;
+    stabilizeForReconciliation(): Promise<StoredDocumentJournal | undefined>;
+    create(envelope: DocumentTransactionEnvelope): Promise<JournalAuthority>;
+    replace(request: {
+        readonly expectedAuthority: JournalAuthority;
+        readonly envelope: DocumentTransactionEnvelope;
+    }): Promise<JournalAuthority>;
+    remove(expectedAuthority: JournalAuthority): Promise<void>;
+}
+export {};
+//# sourceMappingURL=node-document-journal-store.d.ts.map

package/dist/adapters/node/node-document-journal-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-journal-store.d.ts","sourceRoot":"","sources":["../../../src/adapters/node/node-document-journal-store.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iDAAiD,CAAC;AAEnG,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EAEhB,qBAAqB,EACtB,MAAM,mDAAmD,CAAC;AAC3D,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,yCAAyC,CAAC;AAchG,UAAU,6BAA6B;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,gCAAgC,CAAC;CAC3D;AA0OD,qBAAa,wBAAyB,YAAW,oBAAoB;;IAIjE,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,QAAQ,CAAC,UAAU,EAAE,6BAA6B;IAFpD,YACW,WAAW,EAAE,MAAM,EACnB,UAAU,GAAE,6BAAkC,EAwCxD;IAEK,IAAI,IAAI,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAGvD;IAEY,0BAA0B,IAAI,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAQpF;IAEK,MAAM,CAAC,QAAQ,EAAE,2BAA2B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAE7E;IAEK,OAAO,CAAC,OAAO,EAAE;QACrB,QAAQ,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;QAC7C,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;KAChD,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAI5B;IAEK,MAAM,CAAC,iBAAiB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/D;CACF"}

package/dist/adapters/node/node-document-journal-store.js

@@ -0,0 +1,235 @@
+import { randomUUID } from "node:crypto";
+import { basename, dirname, join } from "node:path";
+import { TextDecoder } from "node:util";
+import { NodeJournalSlotStore, syncDirectoryStrictly } from "@agent-teams/repository-mutation/node";
+import { canonicalJson } from "../../canonical-json.js";
+import { FOUNDATION_TRANSACTION_FILE } from "../../state-contract.js";
+import { parseStrictJson } from "../../strict-json.js";
+import { assertDocumentTransactionEnvelope } from "../../application/policies/document-transaction-envelope-policy.js";
+const maximumJournalBytes = 32 * 1024 * 1024;
+const strictUtf8 = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
+class NodeDocumentJournalStoreError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "NodeDocumentJournalStoreError";
+    }
+}
+function portableIdentity(identity) {
+    if (!/^[1-9][0-9]{0,19}$/u.test(identity.dev) ||
+        !/^[1-9][0-9]{0,19}$/u.test(identity.ino) ||
+        !/^[1-9][0-9]{0,19}$/u.test(identity.birthtimeNs)) {
+        throw new NodeDocumentJournalStoreError("Document journal identity is invalid or zero.");
+    }
+    return {
+        birthtimeNs: BigInt(identity.birthtimeNs),
+        dev: BigInt(identity.dev),
+        ino: BigInt(identity.ino)
+    };
+}
+function journalIdentity(identity) {
+    const result = {
+        adapter: "node-filesystem",
+        version: 1,
+        birthtimeNs: identity.birthtimeNs.toString(),
+        dev: identity.dev.toString(),
+        ino: identity.ino.toString()
+    };
+    portableIdentity(result);
+    return result;
+}
+function wireAuthority(authority) {
+    return {
+        authorityDigest: authority.authorityDigest,
+        identity: journalIdentity(authority.identity)
+    };
+}
+function slotAuthority(authority) {
+    return {
+        authorityDigest: authority.authorityDigest,
+        identity: portableIdentity(authority.identity)
+    };
+}
+async function canonicalEnvelopeBytes(envelope) {
+    const validated = await assertDocumentTransactionEnvelope(envelope);
+    const bytes = Buffer.from(`${canonicalJson(validated)}\n`, "utf8");
+    if (bytes.byteLength > maximumJournalBytes) {
+        throw new NodeDocumentJournalStoreError("Document journal exceeds its strict size limit.");
+    }
+    return bytes;
+}
+async function parseEnvelope(bytes) {
+    let envelope;
+    try {
+        envelope = await assertDocumentTransactionEnvelope(parseStrictJson(strictUtf8.decode(bytes)));
+    }
+    catch (error) {
+        throw new NodeDocumentJournalStoreError("Document journal contains invalid strict canonical JSON.", { cause: error });
+    }
+    if (!bytes.equals(await canonicalEnvelopeBytes(envelope))) {
+        throw new NodeDocumentJournalStoreError("Document journal JSON is not in canonical byte form.");
+    }
+    return envelope;
+}
+function evidenceDescription(context) {
+    return context.evidence === "candidate"
+        ? "Document journal transition candidate"
+        : "Quarantined document journal";
+}
+function subjectDescription(context) {
+    const evidence = evidenceDescription(context);
+    const descriptions = {
+        candidate: "Document journal transition candidate",
+        canonical: "Canonical document journal",
+        evidence,
+        quarantine: "Quarantined document journal",
+        replacement: "Replacement document journal",
+        "retired-evidence": `Retired ${evidence}`
+    };
+    return descriptions[context.subject ?? "canonical"];
+}
+function failed(message, context) {
+    return new NodeDocumentJournalStoreError(message, context.cause === undefined ? undefined : { cause: context.cause });
+}
+const failures = {
+    "candidate-exists": (context) => failed("Document journal transition candidate already exists and was preserved.", context),
+    "candidate-unavailable": (context) => context.cause instanceof Error
+        ? context.cause
+        : failed("Document journal transition candidate could not be created safely.", context),
+    "canonical-recreated": (context) => failed("Canonical document journal was recreated concurrently; all evidence was preserved.", context),
+    changed: (context) => failed(`${subjectDescription(context)} identity or canonical bytes changed concurrently; all evidence was preserved.`, context),
+    "must-be-stabilized": (context) => failed("Document journal mutation must be stabilized before another operation.", context),
+    "not-regular-file": (context) => failed("Document journal is not a stable bounded regular file.", context),
+    "publication-conflict": (context) => failed(context.mutation === "replace"
+        ? "Canonical document journal slot changed during transition; all evidence was preserved."
+        : "Canonical document journal slot is occupied; transition evidence was preserved.", context),
+    "quarantine-unavailable": (context) => failed(context.mutation === "remove"
+        ? "Document journal could not enter its verified removal quarantine."
+        : "Document journal could not enter its verified quarantine transition; evidence was preserved.", context),
+    "slot-occupied": (context) => failed("Canonical document journal slot is occupied; it was preserved.", context),
+    "state-directory-missing": (context) => failed("Foundation state directory must exist before journal access.", context),
+    "too-many-entries": (context) => failed("Document journal directory contains too many entries to inspect safely.", context),
+    "transition-residue": (context) => failed("Incomplete document journal transition evidence was preserved and requires recovery.", context)
+};
+function documentJournalFailure(failure, context) {
+    return failures[failure](context);
+}
+function retirementEvidence(evidence) {
+    return evidence === "candidate" ? "candidate" : "quarantine";
+}
+function mapFaultPoint(point) {
+    switch (point.phase) {
+        case "after-candidate-synced":
+            return { phase: "after-candidate-synced" };
+        case "before-reconciliation-directory-sync":
+            return { phase: "before-reconciliation-directory-sync" };
+        case "after-canonical-synced":
+            return { phase: "after-canonical-published" };
+        case "after-shared-quarantine-synced":
+            return { phase: "after-canonical-quarantined" };
+        case "after-final-directory-sync":
+            return point.mutation === "create"
+                ? undefined
+                : { phase: "after-quarantine-removed" };
+        case "before-final-directory-sync":
+            return { operation: point.mutation, phase: "before-final-directory-sync" };
+        case "before-shared-quarantine":
+            return { operation: point.mutation, path: point.path, phase: "before-shared-quarantine" };
+        case "before-retirement-directory":
+            return {
+                evidence: retirementEvidence(point.evidence),
+                operation: point.mutation,
+                path: point.path,
+                phase: "before-private-cleanup"
+            };
+        case "before-logical-retirement":
+            return {
+                evidence: retirementEvidence(point.evidence),
+                operation: point.mutation,
+                path: point.path,
+                phase: "before-logical-retirement"
+            };
+        case "before-directory-sync":
+            return {
+                operation: point.mutation,
+                path: point.path,
+                phase: "before-directory-sync",
+                role: point.role
+            };
+        case "before-canonical-link":
+        case "after-canonical-linked":
+        case "before-private-retirement":
+        case "before-private-retirement-rename":
+        case "before-quarantine-directory":
+            return undefined;
+    }
+}
+function storedDocumentJournal(stored) {
+    return { authority: wireAuthority(stored.authority), envelope: stored.journal };
+}
+export class NodeDocumentJournalStore {
+    journalPath;
+    operations;
+    #store;
+    constructor(journalPath, operations = {}) {
+        this.journalPath = journalPath;
+        this.operations = operations;
+        const parent = dirname(journalPath);
+        const canonicalName = basename(journalPath);
+        if (canonicalName !== FOUNDATION_TRANSACTION_FILE) {
+            throw new NodeDocumentJournalStoreError("Document journal store must use the historical Foundation transaction slot.");
+        }
+        const { faultInjector } = operations;
+        this.#store = new NodeJournalSlotStore({
+            canonicalPath: journalPath,
+            codec: { parse: parseEnvelope, serialize: canonicalEnvelopeBytes },
+            failure: documentJournalFailure,
+            ...(faultInjector === undefined
+                ? {}
+                : {
+                    faultInjector: (point) => {
+                        const mapped = mapFaultPoint(point);
+                        return mapped === undefined ? undefined : faultInjector(mapped);
+                    }
+                }),
+            maximumBytes: maximumJournalBytes,
+            naming: {
+                candidatePath: join(parent, `${canonicalName}.document-transition`),
+                quarantineDirectoryName: (previous) => `${canonicalName}.document-quarantine.${previous.identity.dev}.${previous.identity.ino}.${previous.identity.birthtimeNs}.${randomUUID()}`,
+                residues: [
+                    { exact: `${canonicalName}.document-transition` },
+                    { prefix: `${canonicalName}.document-quarantine.` },
+                    { prefix: `${canonicalName}.document-retired.` }
+                ],
+                retiredDirectoryName: () => `${canonicalName}.document-retired.${randomUUID()}`,
+                terminalRootName: `${canonicalName}.completed-document-evidence`
+            },
+            canonicalInspection: "authority",
+            observableSyncStages: ["transition"],
+            reconciliation: "residue-only",
+            syncDirectory: syncDirectoryStrictly
+        });
+    }
+    async read() {
+        const stored = await this.#store.read();
+        return stored === undefined ? undefined : storedDocumentJournal(stored);
+    }
+    async stabilizeForReconciliation() {
+        const observation = await this.#store.stabilizeForReconciliation();
+        if (observation.outcome === "recovery-required") {
+            throw documentJournalFailure("transition-residue", { mutation: "stabilize" });
+        }
+        return observation.stored === undefined
+            ? undefined
+            : storedDocumentJournal(observation.stored);
+    }
+    async create(envelope) {
+        return wireAuthority(await this.#store.create(envelope));
+    }
+    async replace(request) {
+        return wireAuthority(await this.#store.replace(slotAuthority(request.expectedAuthority), request.envelope));
+    }
+    async remove(expectedAuthority) {
+        await this.#store.remove(slotAuthority(expectedAuthority));
+    }
+}
+//# sourceMappingURL=node-document-journal-store.js.map

package/dist/adapters/node/node-document-journal-store.js.map

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

package/dist/adapters/node/node-document-metadata-sidecar-reader.d.ts

@@ -0,0 +1,9 @@
+import type { DocumentMetadataSidecarReader, DocumentMetadataSidecarSnapshot } from "../../application/ports/document-metadata-sidecar-reader.js";
+export declare class NodeDocumentMetadataSidecarReader implements DocumentMetadataSidecarReader {
+    read(request: {
+        readonly consumerRoot: string;
+        readonly path: string;
+        readonly signal?: AbortSignal;
+    }): Promise<DocumentMetadataSidecarSnapshot>;
+}
+//# sourceMappingURL=node-document-metadata-sidecar-reader.d.ts.map

package/dist/adapters/node/node-document-metadata-sidecar-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-metadata-sidecar-reader.d.ts","sourceRoot":"","sources":["../../../src/adapters/node/node-document-metadata-sidecar-reader.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,6BAA6B,EAC7B,+BAA+B,EAChC,MAAM,6DAA6D,CAAC;AAkFrE,qBAAa,iCACX,YAAW,6BAA6B;IAElC,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,+BAA+B,CAAC,CAU3C;CACF"}

package/dist/adapters/node/node-document-metadata-sidecar-reader.js

@@ -0,0 +1,87 @@
+import { CapabilityInputError } from "../../capability-runtime.js";
+import { assertNotCancelled } from "../../cancellation.js";
+import { parseStrictYamlSource } from "../../strict-yaml.js";
+import { compareBinaryStrings } from "../../binary-string-comparator.js";
+import { isDocumentRepositoryPath } from "../../application/policies/document-repository-path.js";
+import { CatalogMetadataProjectionError, projectCatalogMetadata } from "../../application/policies/project-catalog-metadata.js";
+import { DocumentCatalogError } from "../../document-catalog-error.js";
+import { readDocumentAuthorityFile } from "./read-document-authority-file.js";
+const MAXIMUM_SIDECAR_BYTES = 1024 * 1024;
+const MAXIMUM_SIDECAR_DOCUMENTS = 10_000;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function invalidSidecar(message, cause) {
+    throw new DocumentCatalogError("DOCUMENT_CATALOG_INPUT_INVALID", `Document metadata sidecar is invalid: ${message}`, cause === undefined ? undefined : { cause });
+}
+function projectDocuments(value) {
+    if (!isRecord(value)) {
+        invalidSidecar("documents must be a mapping.");
+    }
+    const paths = Reflect.ownKeys(value);
+    if (paths.some((path) => typeof path !== "string")) {
+        invalidSidecar("document paths must be strings.");
+    }
+    if (paths.length > MAXIMUM_SIDECAR_DOCUMENTS) {
+        invalidSidecar(`documents exceeds ${MAXIMUM_SIDECAR_DOCUMENTS} entries.`);
+    }
+    const projected = {};
+    for (const path of paths.toSorted(compareBinaryStrings)) {
+        if (!isDocumentRepositoryPath(path) || !path.toLowerCase().endsWith(".md")) {
+            invalidSidecar(`document path is not portable Markdown: ${path}.`);
+        }
+        const descriptor = Object.getOwnPropertyDescriptor(value, path);
+        if (descriptor === undefined ||
+            !("value" in descriptor) ||
+            descriptor.enumerable !== true) {
+            invalidSidecar("documents must contain enumerable own data properties.");
+        }
+        try {
+            projected[path] = projectCatalogMetadata(descriptor.value);
+        }
+        catch (error) {
+            if (error instanceof CatalogMetadataProjectionError) {
+                invalidSidecar(`${path}: ${error.message}`, error);
+            }
+            throw error;
+        }
+    }
+    return Object.freeze(projected);
+}
+function parseSidecar(source) {
+    let input;
+    try {
+        input = parseStrictYamlSource(source, "document-metadata-sidecar");
+    }
+    catch (error) {
+        if (error instanceof CapabilityInputError) {
+            invalidSidecar(error.message, error);
+        }
+        throw error;
+    }
+    if (!isRecord(input)) {
+        invalidSidecar("root must be an object.");
+    }
+    const keys = Object.keys(input).toSorted(compareBinaryStrings);
+    if (keys.length !== 2 ||
+        keys[0] !== "contract" ||
+        keys[1] !== "documents" ||
+        input["contract"] !== "foundation.document-metadata-sidecar/v1") {
+        invalidSidecar("root must contain only contract foundation.document-metadata-sidecar/v1 and documents.");
+    }
+    return projectDocuments(input["documents"]);
+}
+export class NodeDocumentMetadataSidecarReader {
+    async read(request) {
+        assertNotCancelled(request.signal);
+        const file = await readDocumentAuthorityFile({
+            consumerRoot: request.consumerRoot,
+            maxBytes: MAXIMUM_SIDECAR_BYTES,
+            path: request.path
+        });
+        const documents = parseSidecar(file.source);
+        assertNotCancelled(request.signal);
+        return Object.freeze({ documents, evidence: file.evidence });
+    }
+}
+//# sourceMappingURL=node-document-metadata-sidecar-reader.js.map

package/dist/adapters/node/node-document-metadata-sidecar-reader.js.map

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

package/dist/adapters/node/node-document-parent-materializer.d.ts

@@ -0,0 +1,39 @@
+import { type DocumentPhysicalIdentity } from "../../application/model/document-physical-identity.js";
+import type { DocumentCreatedDirectoryEvidenceV2, DocumentParentMaterializationInspectionV2, DocumentParentMaterializationJournalV2, DocumentParentMaterializationPlanV2 } from "../../application/model/document-parent-materialization.js";
+import { type NodePathAuthorityOperations } from "./node-path-authority.js";
+interface Operations extends NodePathAuthorityOperations {
+    readonly mkdir: (path: string, options: {
+        readonly mode: number;
+    }) => Promise<void>;
+    readonly syncDirectory: (path: string) => Promise<void>;
+}
+export declare function planDocumentParentMaterializationV2(request: {
+    readonly consumerRoot: string;
+    readonly destination: string;
+    readonly signal?: AbortSignal;
+}): Promise<DocumentParentMaterializationPlanV2>;
+export declare class NodeDocumentParentMaterializerV2 {
+    #private;
+    constructor(overrides?: Partial<Operations>);
+    begin(request: {
+        readonly consumerRoot: string;
+        readonly plan: DocumentParentMaterializationPlanV2;
+    }): Promise<DocumentParentMaterializationJournalV2>;
+    inspect(request: {
+        readonly consumerRoot: string;
+        readonly journal: DocumentParentMaterializationJournalV2;
+    }): Promise<DocumentParentMaterializationInspectionV2>;
+    createNext(request: {
+        readonly consumerRoot: string;
+        readonly journal: DocumentParentMaterializationJournalV2;
+        readonly signal?: AbortSignal;
+    }): Promise<DocumentCreatedDirectoryEvidenceV2 | undefined>;
+    createAndBindOne(request: {
+        readonly consumerRoot: string;
+        readonly expectedParentIdentity: DocumentPhysicalIdentity;
+        readonly path: string;
+        readonly bindCreatedDirectory: (evidence: DocumentCreatedDirectoryEvidenceV2) => Promise<void>;
+    }): Promise<void>;
+}
+export {};
+//# sourceMappingURL=node-document-parent-materializer.d.ts.map

package/dist/adapters/node/node-document-parent-materializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-parent-materializer.d.ts","sourceRoot":"","sources":["../../../src/adapters/node/node-document-parent-materializer.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,uDAAuD,CAAC;AAC/D,OAAO,KAAK,EACV,kCAAkC,EAClC,yCAAyC,EACzC,sCAAsC,EACtC,mCAAmC,EACpC,MAAM,4DAA4D,CAAC;AAEpE,OAAO,EAML,KAAK,2BAA2B,EACjC,MAAM,0BAA0B,CAAC;AAElC,UAAU,UAAW,SAAQ,2BAA2B;IAMtD,QAAQ,CAAC,KAAK,EAAE,CACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAC/B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAoED,wBAAsB,mCAAmC,CAAC,OAAO,EAAE;IACjE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,GAAG,OAAO,CAAC,mCAAmC,CAAC,CAwC/C;AAED,qBAAa,gCAAgC;;IAG3C,YAAY,SAAS,GAAE,OAAO,CAAC,UAAU,CAAM,EAE9C;IAEK,KAAK,CAAC,OAAO,EAAE;QACnB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,IAAI,EAAE,mCAAmC,CAAC;KACpD,GAAG,OAAO,CAAC,sCAAsC,CAAC,CAalD;IAEK,OAAO,CAAC,OAAO,EAAE;QACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,EAAE,sCAAsC,CAAC;KAC1D,GAAG,OAAO,CAAC,yCAAyC,CAAC,CAiErD;IAEK,UAAU,CAAC,OAAO,EAAE;QACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,EAAE,sCAAsC,CAAC;QACzD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,kCAAkC,GAAG,SAAS,CAAC,CAuD1D;IAEK,gBAAgB,CAAC,OAAO,EAAE;QAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,sBAAsB,EAAE,wBAAwB,CAAC;QAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,oBAAoB,EAAE,CAC7B,QAAQ,EAAE,kCAAkC,KACzC,OAAO,CAAC,IAAI,CAAC,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDhB;CAEF"}