@agent-teams/document-authoring 0.0.0

package/dist/composition/describe-document-authoring-profile-v2.js

@@ -0,0 +1,220 @@
+import { compareBinaryStrings } from "../binary-string-comparator.js";
+import { assertNotCancelled } from "../cancellation.js";
+import { NodeDocumentMetadataSidecarReader } from "../adapters/node/node-document-metadata-sidecar-reader.js";
+import { loadValidatedDocumentAuthoringProfileV2, resolvedArtifactOwnerIds } from "../adapters/node/load-validated-document-authoring-profile-v2.js";
+import { NodeMetadataInstanceValidator } from "../adapters/node/node-metadata-instance-validator.js";
+import { NodeOwnerMembershipReader } from "../adapters/node/node-owner-membership-reader.js";
+import { readDocumentAuthorityFile } from "../adapters/node/read-document-authority-file.js";
+import { documentAuthoringProfileSemanticDigest, documentAuthoringProfileSemanticDigestV3 } from "../application/policies/document-authoring-semantic-digests.js";
+import { DocumentCatalogError } from "../document-catalog-error.js";
+const MAX_TEMPLATE_BYTES = 256 * 1024;
+const BASE_REQUIRED_METADATA = Object.freeze([
+    "id",
+    "type",
+    "status",
+    "owner",
+    "summary"
+]);
+function freezeIdentity(identity) {
+    return identity.format === "qualified"
+        ? Object.freeze({
+            ...identity,
+            grammar: Object.freeze({
+                ...identity.grammar,
+                prefixSegments: Object.freeze([...identity.grammar.prefixSegments])
+            })
+        })
+        : Object.freeze({ ...identity });
+}
+function freezePlacement(placement) {
+    return placement.kind === "explicit"
+        ? Object.freeze({
+            ...placement,
+            allowedRoots: Object.freeze([...placement.allowedRoots]),
+            requiredSegmentsInOrder: Object.freeze([
+                ...placement.requiredSegmentsInOrder
+            ])
+        })
+        : Object.freeze({ ...placement });
+}
+function freezeReachability(value) {
+    return Object.freeze({
+        ...value
+    });
+}
+function describeType(artifactType, allowedOwnerIds, requiredMetadata) {
+    return Object.freeze({
+        allowedOwnerIds: Object.freeze([...allowedOwnerIds].toSorted(compareBinaryStrings)),
+        heading: Object.freeze({
+            ...artifactType["heading"]
+        }),
+        identity: freezeIdentity(artifactType["identity"]),
+        initialStatus: artifactType["initialStatus"],
+        placement: freezePlacement(artifactType["placement"]),
+        reachability: freezeReachability(artifactType["reachability"]),
+        requiredMetadata,
+        template: Object.freeze({
+            ...artifactType["template"]
+        }),
+        type: artifactType["type"]
+    });
+}
+async function loadTemplateEvidence(request, profile) {
+    const paths = [...new Set(profile.authoring.artifactTypes.map((artifactType) => artifactType.template.path))].toSorted(compareBinaryStrings);
+    const files = await Promise.all(paths.map((path) => readDocumentAuthorityFile({
+        consumerRoot: request.consumerRoot,
+        maxBytes: MAX_TEMPLATE_BYTES,
+        path
+    })));
+    assertNotCancelled(request.signal);
+    return new Map(files.map((file) => [file.evidence.path, file.evidence]));
+}
+async function loadDescriptionAuthority(request, expectedVersion) {
+    const { evidence, profile } = await loadValidatedDocumentAuthoringProfileV2({
+        consumerRoot: request.consumerRoot,
+        path: request.profilePath,
+        ...(request.signal === undefined ? {} : { signal: request.signal })
+    });
+    if (profile.schemaVersion !== expectedVersion) {
+        throw new DocumentCatalogError("DOCUMENT_CATALOG_INPUT_INVALID", `Document authoring profile description v${expectedVersion} requires schemaVersion ${expectedVersion}.`);
+    }
+    const [ownerCatalog, metadata, sidecar, templateEvidenceByPath] = await Promise.all([
+        new NodeOwnerMembershipReader().read({
+            consumerRoot: request.consumerRoot,
+            contract: profile.catalog.ownerCatalog.contract,
+            path: profile.catalog.ownerCatalog.path,
+            ...(request.signal === undefined ? {} : { signal: request.signal })
+        }),
+        new NodeMetadataInstanceValidator().load({
+            consumerRoot: request.consumerRoot,
+            path: profile.catalog.metadataSchemaPath,
+            ...(request.signal === undefined ? {} : { signal: request.signal })
+        }),
+        profile.catalog.metadataSidecar === undefined
+            ? undefined
+            : new NodeDocumentMetadataSidecarReader().read({
+                consumerRoot: request.consumerRoot,
+                path: profile.catalog.metadataSidecar.path,
+                ...(request.signal === undefined ? {} : { signal: request.signal })
+            }),
+        loadTemplateEvidence(request, profile)
+    ]);
+    return Object.freeze({
+        metadata,
+        ownerCatalog,
+        profile,
+        profileEvidence: evidence,
+        ...(sidecar === undefined ? {} : { sidecarEvidence: sidecar.evidence }),
+        templateEvidenceByPath
+    });
+}
+function projectDescription(authority) {
+    const { metadata, ownerCatalog, profile, profileEvidence } = authority;
+    const ownerIds = Object.freeze([...ownerCatalog.ids].toSorted(compareBinaryStrings));
+    const ownerSet = new Set(ownerIds);
+    for (const artifactType of profile.authoring.artifactTypes) {
+        const allowedOwnerIds = resolvedArtifactOwnerIds(profile, artifactType);
+        if (allowedOwnerIds === undefined) {
+            throw new DocumentCatalogError("DOCUMENT_CATALOG_INPUT_INVALID", `Profile v${profile.schemaVersion} artifact type does not declare authoring owners: ${artifactType.type}.`);
+        }
+        if (allowedOwnerIds.some((owner) => !ownerSet.has(owner))) {
+            throw new DocumentCatalogError("DOCUMENT_CATALOG_INPUT_INVALID", `Profile v${profile.schemaVersion} artifact type contains an owner absent from the owner catalog: ${artifactType.type}.`);
+        }
+    }
+    const requiredMetadata = Object.freeze([...new Set([
+            ...BASE_REQUIRED_METADATA,
+            ...(metadata.requiredProperties ?? [])
+        ])].toSorted(compareBinaryStrings));
+    const types = Object.freeze(profile.authoring.artifactTypes
+        .map((artifactType) => {
+        const allowedOwnerIds = resolvedArtifactOwnerIds(profile, artifactType);
+        if (allowedOwnerIds === undefined) {
+            throw new DocumentCatalogError("DOCUMENT_CATALOG_INPUT_INVALID", `Profile v${profile.schemaVersion} artifact type does not declare authoring owners: ${artifactType.type}.`);
+        }
+        return describeType(artifactType, allowedOwnerIds, requiredMetadata);
+    })
+        .toSorted((left, right) => compareBinaryStrings(left.type, right.type)));
+    const templates = Object.freeze(types.map((type) => {
+        const evidence = authority.templateEvidenceByPath.get(type.template.path);
+        if (evidence === undefined) {
+            throw new DocumentCatalogError("DOCUMENT_CATALOG_AUTHORITY_UNAVAILABLE", `Document template evidence is unavailable: ${type.template.path}.`);
+        }
+        return Object.freeze({ evidence, type: type.type });
+    }));
+    const common = Object.freeze({
+        authority: Object.freeze({
+            metadataSchema: metadata.evidence,
+            ...(authority.sidecarEvidence === undefined
+                ? {}
+                : { metadataSidecar: authority.sidecarEvidence }),
+            ownerCatalog: ownerCatalog.evidence,
+            profile: profileEvidence,
+            templates
+        }),
+        authorityPaths: Object.freeze({
+            metadataSchema: metadata.evidence.path,
+            ...(authority.sidecarEvidence === undefined
+                ? {}
+                : { metadataSidecar: authority.sidecarEvidence.path }),
+            ownerCatalog: ownerCatalog.evidence.path,
+            profile: profileEvidence.path
+        }),
+        catalog: Object.freeze({
+            collections: Object.freeze(profile.catalog.collections
+                .map((collection) => Object.freeze(collection.kind === "frontmatter-readme"
+                ? {
+                    ...collection,
+                    roots: Object.freeze([...collection.roots].toSorted(compareBinaryStrings))
+                }
+                : { ...collection }))
+                .toSorted((left, right) => compareBinaryStrings(left.kind === "markdown-tree" ? left.root : left.roots.join("/"), right.kind === "markdown-tree" ? right.root : right.roots.join("/")))),
+            excludedPrefixes: Object.freeze([...(profile.catalog.excludedPrefixes ?? [])].toSorted(compareBinaryStrings))
+        }),
+        ownerIds,
+        projectId: profile.projectId,
+        types
+    });
+    if (profile.schemaVersion === 2) {
+        const withoutDigest = Object.freeze({
+            ...common,
+            profileSchemaVersion: 2,
+            schemaVersion: 2
+        });
+        return Object.freeze({
+            ...withoutDigest,
+            semanticDigest: documentAuthoringProfileSemanticDigest(withoutDigest)
+        });
+    }
+    const withoutDigest = Object.freeze({
+        ...common,
+        profileSchemaVersion: 3,
+        schemaVersion: 3
+    });
+    return Object.freeze({
+        ...withoutDigest,
+        semanticDigest: documentAuthoringProfileSemanticDigestV3(withoutDigest)
+    });
+}
+async function describeDocumentAuthoringProfile(request, version) {
+    const before = projectDescription(await loadDescriptionAuthority(request, version));
+    const after = projectDescription(await loadDescriptionAuthority(request, version));
+    if (before.semanticDigest !== after.semanticDigest) {
+        throw new DocumentCatalogError("DOCUMENT_CATALOG_AUTHORITY_CHANGED", "Document authoring profile authority changed while it was described.");
+    }
+    return after;
+}
+export async function describeDocumentAuthoringProfileV2(request) {
+    const description = await describeDocumentAuthoringProfile(request, 2);
+    if (description.profileSchemaVersion !== 2) {
+        throw new TypeError("Document authoring profile v2 projection is inconsistent.");
+    }
+    return description;
+}
+export async function describeDocumentAuthoringProfileV3(request) {
+    const description = await describeDocumentAuthoringProfile(request, 3);
+    if (description.profileSchemaVersion !== 3) {
+        throw new TypeError("Document authoring profile v3 projection is inconsistent.");
+    }
+    return description;
+}
+//# sourceMappingURL=describe-document-authoring-profile-v2.js.map

package/dist/composition/describe-document-authoring-profile-v2.js.map

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

package/dist/composition/inspect-document-authoring-environment-v1.d.ts

@@ -0,0 +1,7 @@
+import type { DocumentEnvironmentInspection } from "../application/ports/document-environment-inspector.js";
+export interface InspectDocumentAuthoringEnvironmentV1Request {
+    readonly consumerRoot: string;
+    readonly signal?: AbortSignal;
+}
+export declare function inspectDocumentAuthoringEnvironmentV1(request: InspectDocumentAuthoringEnvironmentV1Request): Promise<DocumentEnvironmentInspection>;
+//# sourceMappingURL=inspect-document-authoring-environment-v1.d.ts.map

package/dist/composition/inspect-document-authoring-environment-v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-document-authoring-environment-v1.d.ts","sourceRoot":"","sources":["../../src/composition/inspect-document-authoring-environment-v1.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,wDAAwD,CAAC;AAE5G,MAAM,WAAW,4CAA4C;IAC3D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,wBAAsB,qCAAqC,CACzD,OAAO,EAAE,4CAA4C,GACpD,OAAO,CAAC,6BAA6B,CAAC,CAKxC"}

package/dist/composition/inspect-document-authoring-environment-v1.js

@@ -0,0 +1,10 @@
+import { installedDocumentAuthoringVersion } from "../package-version.js";
+import { installedDocumentAuthoringBuildIdentity } from "../installed-artifact-identity.js";
+import { NodeDocumentEnvironmentInspector } from "../adapters/node/node-document-environment-inspector.js";
+export async function inspectDocumentAuthoringEnvironmentV1(request) {
+    return new NodeDocumentEnvironmentInspector({
+        buildIdentity: installedDocumentAuthoringBuildIdentity,
+        version: installedDocumentAuthoringVersion
+    }).inspect(request.consumerRoot, request.signal);
+}
+//# sourceMappingURL=inspect-document-authoring-environment-v1.js.map

package/dist/composition/inspect-document-authoring-environment-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-document-authoring-environment-v1.js","sourceRoot":"","sources":["../../src/composition/inspect-document-authoring-environment-v1.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,uCAAuC,EAAE,MAAM,mCAAmC,CAAC;AAC5F,OAAO,EAAE,gCAAgC,EAAE,MAAM,yDAAyD,CAAC;AAQ3G,MAAM,CAAC,KAAK,UAAU,qCAAqC,CACzD,OAAqD;IAErD,OAAO,IAAI,gCAAgC,CAAC;QAC1C,aAAa,EAAE,uCAAuC;QACtD,OAAO,EAAE,iCAAiC;KAC3C,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;AACnD,CAAC"}

package/dist/composition/inspect-document-transaction.d.ts

@@ -0,0 +1,4 @@
+import type { DocumentTransactionInspectionV1, DocumentTransactionInspectionV2 } from "../application/model/document-transaction-inspection.js";
+export declare function inspectDocumentTransactionV2(consumerRoot: string): Promise<DocumentTransactionInspectionV2>;
+export declare function inspectDocumentTransactionV1(consumerRoot: string): Promise<DocumentTransactionInspectionV1>;
+//# sourceMappingURL=inspect-document-transaction.d.ts.map

package/dist/composition/inspect-document-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-document-transaction.d.ts","sourceRoot":"","sources":["../../src/composition/inspect-document-transaction.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,+BAA+B,EAC/B,+BAA+B,EAChC,MAAM,yDAAyD,CAAC;AAoJjE,wBAAsB,4BAA4B,CAChD,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,+BAA+B,CAAC,CAE1C;AAED,wBAAsB,4BAA4B,CAChD,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,+BAA+B,CAAC,CA6B1C"}

package/dist/composition/inspect-document-transaction.js

@@ -0,0 +1,179 @@
+import { lstat, opendir, realpath } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { NodeDocumentJournalStore } from "../adapters/node/node-document-journal-store.js";
+import { recaptureDocumentPublicationPaths } from "../adapters/node/recapture-document-publication-paths.js";
+import { installedDocumentAuthoringBuildIdentity } from "../installed-artifact-identity.js";
+import { installedDocumentAuthoringVersion } from "../package-version.js";
+import { FOUNDATION_TRANSACTION_FILE, LOCAL_STATE_DIRECTORY } from "../state-contract.js";
+const maximumStateEntries = 1024;
+const transitionNames = new Set([
+    `${FOUNDATION_TRANSACTION_FILE}.tmp`,
+    `${FOUNDATION_TRANSACTION_FILE}.known-file.tmp`,
+    `${FOUNDATION_TRANSACTION_FILE}.document-transition`
+]);
+function missing(error) {
+    return error instanceof Error && "code" in error &&
+        error.code === "ENOENT";
+}
+function diagnostic(code, message) {
+    return [{ code, message }];
+}
+function unsafe(reason) {
+    return {
+        schemaVersion: 2,
+        state: "manual-recovery-required",
+        reason,
+        transactionKind: "corrupt",
+        diagnostics: diagnostic("FOUNDATION_TRANSACTION_MANUAL_RECOVERY_REQUIRED", reason)
+    };
+}
+async function hasForeignEvidence(stateDirectory) {
+    const directory = await opendir(stateDirectory);
+    let count = 0;
+    try {
+        for (;;) {
+            const entry = await directory.read();
+            if (entry === null) {
+                return false;
+            }
+            count += 1;
+            if (count > maximumStateEntries) {
+                return true;
+            }
+            if (transitionNames.has(entry.name) ||
+                entry.name.startsWith(`${FOUNDATION_TRANSACTION_FILE}.document-quarantine.`) ||
+                entry.name.startsWith(`${FOUNDATION_TRANSACTION_FILE}.document-retired.`)) {
+                return true;
+            }
+        }
+    }
+    finally {
+        await directory.close();
+    }
+}
+async function inspectV2(consumerRoot) {
+    const root = await realpath(resolve(consumerRoot));
+    const stateDirectory = join(root, LOCAL_STATE_DIRECTORY);
+    try {
+        await lstat(stateDirectory);
+    }
+    catch (error) {
+        if (missing(error)) {
+            return { schemaVersion: 2, state: "idle", diagnostics: [] };
+        }
+        return unsafe("Document transaction evidence path cannot be inspected safely.");
+    }
+    try {
+        await recaptureDocumentPublicationPaths({
+            consumerRoot: root,
+            destination: `${LOCAL_STATE_DIRECTORY}/${FOUNDATION_TRANSACTION_FILE}`
+        });
+    }
+    catch {
+        try {
+            await lstat(stateDirectory);
+        }
+        catch (error) {
+            if (missing(error)) {
+                return { schemaVersion: 2, state: "idle", diagnostics: [] };
+            }
+        }
+        return unsafe("Document transaction evidence path is redirected or cannot be inspected safely.");
+    }
+    const journalPath = join(stateDirectory, FOUNDATION_TRANSACTION_FILE);
+    // Check residue before reading the canonical slot so every platform
+    // exposes the same deterministic recovery coordinate.
+    if (await hasForeignEvidence(stateDirectory)) {
+        return unsafe("journal-transition-residue");
+    }
+    let stored;
+    try {
+        stored = await new NodeDocumentJournalStore(journalPath).read();
+    }
+    catch {
+        return unsafe("Transaction evidence is foreign, corrupt, incompatible, or has transition residue; it was preserved.");
+    }
+    if (stored === undefined) {
+        return await hasForeignEvidence(stateDirectory)
+            ? unsafe("Transaction transition evidence requires exact owner-package recovery.")
+            : { schemaVersion: 2, state: "idle", diagnostics: [] };
+    }
+    const envelope = stored.envelope;
+    const [version, buildIdentity] = await Promise.all([
+        installedDocumentAuthoringVersion(), installedDocumentAuthoringBuildIdentity()
+    ]);
+    const exact = envelope.foundation.version === version &&
+        envelope.foundation.buildIdentity === buildIdentity;
+    const format = envelope.schemaVersion === 4
+        ? "document-authoring-envelope-v4"
+        : "document-authoring-envelope-v3";
+    if (!exact) {
+        const reason = `Document Authoring ${envelope.foundation.version} (${envelope.foundation.buildIdentity}) must recover this transaction before ${version} (${buildIdentity}) can mutate the repository.`;
+        return {
+            schemaVersion: 2,
+            state: "manual-recovery-required",
+            reason,
+            operationKind: "document-authoring",
+            transactionKind: "version-mismatch",
+            format,
+            foundationVersion: envelope.foundation.version,
+            foundationBuildIdentity: envelope.foundation.buildIdentity,
+            recovery: {
+                commandId: "docs-recover",
+                args: {
+                    exactFoundationVersion: envelope.foundation.version,
+                    exactFoundationBuildIdentity: envelope.foundation.buildIdentity
+                }
+            },
+            diagnostics: diagnostic("FOUNDATION_TRANSACTION_VERSION_MISMATCH", reason)
+        };
+    }
+    return {
+        schemaVersion: 2,
+        state: "recoverable",
+        operationKind: "document-authoring",
+        format,
+        foundationVersion: version,
+        foundationBuildIdentity: buildIdentity,
+        recovery: {
+            commandId: "docs-recover",
+            exactFoundationVersion: version,
+            exactFoundationBuildIdentity: buildIdentity
+        },
+        diagnostics: diagnostic("FOUNDATION_TRANSACTION_ACTIVE", "A pending document-authoring transaction must be recovered.")
+    };
+}
+export async function inspectDocumentTransactionV2(consumerRoot) {
+    return inspectV2(consumerRoot);
+}
+export async function inspectDocumentTransactionV1(consumerRoot) {
+    const observed = await inspectV2(consumerRoot);
+    if (observed.state === "idle") {
+        return { schemaVersion: 1, state: "idle", diagnostics: [] };
+    }
+    if (observed.state === "recoverable" && observed.format === "document-authoring-envelope-v3") {
+        return { ...observed, schemaVersion: 1, format: "document-authoring-envelope-v3" };
+    }
+    if (observed.state === "recoverable") {
+        return {
+            schemaVersion: 1,
+            state: "manual-recovery-required",
+            reason: "Document transaction envelope v4 requires the v2 inspection contract.",
+            operationKind: "document-authoring",
+            transactionKind: "document",
+            format: observed.format,
+            foundationVersion: observed.foundationVersion,
+            foundationBuildIdentity: observed.foundationBuildIdentity,
+            recovery: {
+                commandId: "docs-recover",
+                args: {
+                    exactFoundationVersion: observed.recovery.exactFoundationVersion,
+                    exactFoundationBuildIdentity: observed.recovery.exactFoundationBuildIdentity
+                }
+            },
+            diagnostics: observed.diagnostics
+        };
+    }
+    return { ...observed, schemaVersion: 1 };
+}
+//# sourceMappingURL=inspect-document-transaction.js.map

package/dist/composition/inspect-document-transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-document-transaction.js","sourceRoot":"","sources":["../../src/composition/inspect-document-transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAC3F,OAAO,EAAE,iCAAiC,EAAE,MAAM,0DAA0D,CAAC;AAM7G,OAAO,EAAE,uCAAuC,EAAE,MAAM,mCAAmC,CAAC;AAC5F,OAAO,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE1F,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACjC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,GAAG,2BAA2B,MAAM;IACpC,GAAG,2BAA2B,iBAAiB;IAC/C,GAAG,2BAA2B,sBAAsB;CACrD,CAAC,CAAC;AAEH,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK;QAC7C,KAA+B,CAAC,IAAI,KAAK,QAAQ,CAAC;AACvD,CAAC;AAED,SAAS,UAAU,CACjB,IAAqD,EAAE,OAAe;IAEtE,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,MAAM,CAAC,MAAc;IAG5B,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,KAAK,EAAE,0BAA0B;QACjC,MAAM;QACN,eAAe,EAAE,SAAS;QAC1B,WAAW,EAAE,UAAU,CAAC,iDAAiD,EAAE,MAAM,CAAC;KACnF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,cAAsB;IACtD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAChD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,CAAC;QACH,SAAS,CAAC;YACR,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;YACrC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,OAAO,KAAK,CAAC;YACf,CAAC;YACD,KAAK,IAAI,CAAC,CAAC;YACX,IAAI,KAAK,GAAG,mBAAmB,EAAE,CAAC;gBAChC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBACjC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,2BAA2B,uBAAuB,CAAC;gBAC5E,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,2BAA2B,oBAAoB,CAAC,EAAE,CAAC;gBAC5E,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,YAAoB;IAC3C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IACnD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IACzD,IAAI,CAAC;QAAC,MAAM,KAAK,CAAC,cAAc,CAAC,CAAC;IAAC,CAAC;IACpC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACnB,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;QAC9D,CAAC;QACD,OAAO,MAAM,CAAC,gEAAgE,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,CAAC;QACH,MAAM,iCAAiC,CAAC;YACtC,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,GAAG,qBAAqB,IAAI,2BAA2B,EAAE;SACvE,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,cAAc,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnB,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;YAC9D,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC,iFAAiF,CAAC,CAAC;IACnG,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAC;IACtE,oEAAoE;IACpE,sDAAsD;IACtD,IAAI,MAAM,kBAAkB,CAAC,cAAc,CAAC,EAAE,CAAC;QAC7C,OAAO,MAAM,CAAC,4BAA4B,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,wBAAwB,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,sGAAsG,CAAC,CAAC;IACxH,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,MAAM,kBAAkB,CAAC,cAAc,CAAC;YAC7C,CAAC,CAAC,MAAM,CAAC,wEAAwE,CAAC;YAClF,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAC3D,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACjC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACjD,iCAAiC,EAAE,EAAE,uCAAuC,EAAE;KAC/E,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,OAAO,KAAK,OAAO;QACnD,QAAQ,CAAC,UAAU,CAAC,aAAa,KAAK,aAAa,CAAC;IACtD,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,KAAK,CAAC;QACzC,CAAC,CAAC,gCAAyC;QAC3C,CAAC,CAAC,gCAAyC,CAAC;IAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,sBAAsB,QAAQ,CAAC,UAAU,CAAC,OAAO,KAAK,QAAQ,CAAC,UAAU,CAAC,aAAa,0CAA0C,OAAO,KAAK,aAAa,8BAA8B,CAAC;QACxM,OAAO;YACL,aAAa,EAAE,CAAC;YAChB,KAAK,EAAE,0BAA0B;YACjC,MAAM;YACN,aAAa,EAAE,oBAAoB;YACnC,eAAe,EAAE,kBAAkB;YACnC,MAAM;YACN,iBAAiB,EAAE,QAAQ,CAAC,UAAU,CAAC,OAAO;YAC9C,uBAAuB,EAAE,QAAQ,CAAC,UAAU,CAAC,aAAa;YAC1D,QAAQ,EAAE;gBACR,SAAS,EAAE,cAAc;gBACzB,IAAI,EAAE;oBACJ,sBAAsB,EAAE,QAAQ,CAAC,UAAU,CAAC,OAAO;oBACnD,4BAA4B,EAAE,QAAQ,CAAC,UAAU,CAAC,aAAa;iBAChE;aACF;YACD,WAAW,EAAE,UAAU,CAAC,yCAAyC,EAAE,MAAM,CAAC;SAC3E,CAAC;IACJ,CAAC;IACD,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,KAAK,EAAE,aAAa;QACpB,aAAa,EAAE,oBAAoB;QACnC,MAAM;QACN,iBAAiB,EAAE,OAAO;QAC1B,uBAAuB,EAAE,aAAa;QACtC,QAAQ,EAAE;YACR,SAAS,EAAE,cAAc;YACzB,sBAAsB,EAAE,OAAO;YAC/B,4BAA4B,EAAE,aAAa;SAC5C;QACD,WAAW,EAAE,UAAU,CAAC,+BAA+B,EAAE,6DAA6D,CAAC;KACxH,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,YAAoB;IAEpB,OAAO,SAAS,CAAC,YAAY,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,YAAoB;IAEpB,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,CAAC;IAC/C,IAAI,QAAQ,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QAC9B,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAC9D,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,KAAK,aAAa,IAAI,QAAQ,CAAC,MAAM,KAAK,gCAAgC,EAAE,CAAC;QAC7F,OAAO,EAAE,GAAG,QAAQ,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,gCAAgC,EAAE,CAAC;IACrF,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;QACrC,OAAO;YACL,aAAa,EAAE,CAAC;YAChB,KAAK,EAAE,0BAA0B;YACjC,MAAM,EAAE,uEAAuE;YAC/E,aAAa,EAAE,oBAAoB;YACnC,eAAe,EAAE,UAAU;YAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;YAC7C,uBAAuB,EAAE,QAAQ,CAAC,uBAAuB;YACzD,QAAQ,EAAE;gBACR,SAAS,EAAE,cAAc;gBACzB,IAAI,EAAE;oBACJ,sBAAsB,EAAE,QAAQ,CAAC,QAAQ,CAAC,sBAAsB;oBAChE,4BAA4B,EAAE,QAAQ,CAAC,QAAQ,CAAC,4BAA4B;iBAC7E;aACF;YACD,WAAW,EAAE,QAAQ,CAAC,WAAW;SAClC,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,GAAG,QAAQ,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;AAC3C,CAAC"}

package/dist/composition/node-document-authority-recompiler.d.ts

@@ -0,0 +1,11 @@
+import type { DocumentPlanContract as DocumentPlan } from "../application/model/document-planning.js";
+import type { DocumentAuthorityAssessment, DocumentAuthorityRecompiler } from "../application/ports/document-authority-recompiler.js";
+/** Closed Node replay of the exact planner from the Plan-embedded Intent and profile path. */
+export declare class NodeDocumentAuthorityRecompiler implements DocumentAuthorityRecompiler {
+    assess(request: {
+        readonly consumerRoot: string;
+        readonly plan: DocumentPlan;
+        readonly signal?: AbortSignal;
+    }): Promise<DocumentAuthorityAssessment>;
+}
+//# sourceMappingURL=node-document-authority-recompiler.d.ts.map

package/dist/composition/node-document-authority-recompiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-authority-recompiler.d.ts","sourceRoot":"","sources":["../../src/composition/node-document-authority-recompiler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,IAAI,YAAY,EAAE,MAAM,2CAA2C,CAAC;AACtG,OAAO,KAAK,EACV,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,uDAAuD,CAAC;AAkB/D,8FAA8F;AAC9F,qBAAa,+BACb,YAAW,2BAA2B;IAC9B,MAAM,CAAC,OAAO,EAAE;QACpB,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,2BAA2B,CAAC,CA6DvC;CACF"}

package/dist/composition/node-document-authority-recompiler.js

@@ -0,0 +1,81 @@
+import { canonicalJson } from "../canonical-json.js";
+import { assertNotCancelled } from "../cancellation.js";
+import { assertDocumentPlanDigests, documentPlanDigest } from "../application/policies/document-contract-digests.js";
+import { DocumentPlanningError } from "../document-planning-error.js";
+import { NodeDocumentContractValidator } from "../adapters/node/node-document-contract-validator.js";
+import { planNodeDocumentationDocument } from "./node-document-planning.js";
+function exactPlan(left, right) {
+    return canonicalJson(left) ===
+        canonicalJson(right);
+}
+function reason(error) {
+    return error instanceof Error ? error.message : "Document authority failed with an invalid error value.";
+}
+/** Closed Node replay of the exact planner from the Plan-embedded Intent and profile path. */
+export class NodeDocumentAuthorityRecompiler {
+    async assess(request) {
+        let validatedPlan;
+        try {
+            assertNotCancelled(request.signal);
+            validatedPlan = await new NodeDocumentContractValidator().validatePlan(request.plan);
+            assertDocumentPlanDigests(validatedPlan);
+        }
+        catch (error) {
+            assertNotCancelled(request.signal);
+            return {
+                state: "unverifiable",
+                reason: `Document Plan evidence cannot be validated safely: ${reason(error)}`
+            };
+        }
+        try {
+            const replayed = await planNodeDocumentationDocument({
+                consumerRoot: request.consumerRoot,
+                profilePath: validatedPlan.authority.profile.path,
+                intent: validatedPlan.intent,
+                ...(validatedPlan.schemaVersion === 2
+                    ? { parentPolicy: "create-missing-real-directories" }
+                    : {}),
+                ...(request.signal === undefined ? {} : { signal: request.signal })
+            });
+            assertDocumentPlanDigests(replayed);
+            assertNotCancelled(request.signal);
+            const comparable = replayed.schemaVersion === 2 && validatedPlan.schemaVersion === 2
+                ? (() => {
+                    const withoutDigest = {
+                        ...replayed,
+                        parentMaterialization: validatedPlan.parentMaterialization
+                    };
+                    return {
+                        ...withoutDigest,
+                        planDigest: documentPlanDigest({
+                            ...withoutDigest,
+                            planDigest: replayed.planDigest
+                        })
+                    };
+                })()
+                : replayed;
+            assertDocumentPlanDigests(comparable);
+            return exactPlan(comparable, validatedPlan)
+                ? { state: "current", plan: comparable }
+                : {
+                    state: "stale",
+                    reason: "Current consumer authority reproduces a different exact Document Plan."
+                };
+        }
+        catch (error) {
+            assertNotCancelled(request.signal);
+            if (error instanceof DocumentPlanningError &&
+                error.code !== "DOCUMENT_PLANNING_AUTHORITY_UNAVAILABLE") {
+                return {
+                    state: "stale",
+                    reason: `Current consumer authority no longer admits the supplied Document Plan: ${error.message}`
+                };
+            }
+            return {
+                state: "unverifiable",
+                reason: `Document Plan authority cannot be reproduced safely: ${reason(error)}`
+            };
+        }
+    }
+}
+//# sourceMappingURL=node-document-authority-recompiler.js.map

package/dist/composition/node-document-authority-recompiler.js.map

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

package/dist/composition/node-document-planning.d.ts

@@ -0,0 +1,7 @@
+import { type PlanDocumentationDocumentRequestContract } from "../application/use-cases/plan-documentation-document.js";
+/**
+ * Closed Node composition shared by public planning and Foundation-owned replay.
+ * This module is intentionally absent from the package export map.
+ */
+export declare function planNodeDocumentationDocument(request: PlanDocumentationDocumentRequestContract): Promise<import("../index.js").DocumentPlanContract>;
+//# sourceMappingURL=node-document-planning.d.ts.map

package/dist/composition/node-document-planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-planning.d.ts","sourceRoot":"","sources":["../../src/composition/node-document-planning.ts"],"names":[],"mappings":"AA6BA,OAAO,EAEL,KAAK,wCAAwC,EAC9C,MAAM,yDAAyD,CAAC;AAgBjE;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,wCAAwC,uDAqElD"}