@agent-teams/engineering-foundation 0.14.0 → 0.15.0

package/dist/document-authoring/application/use-cases/compile-document-plan.js

@@ -0,0 +1,156 @@
+import { sha256Bytes } from "../../../canonical-json.js";
+import { assertDocumentPlanDigests, documentIdentityProjectionDigest, documentIntentDigest, documentOwnerMembershipDigest, documentPlanDigest, documentReferencedDocumentDigest } from "../policies/document-contract-digests.js";
+import { documentRepositoryParentPath } from "../policies/document-repository-path.js";
+import { projectReferencedDocuments } from "../projections/document-catalog-projections.js";
+import { DocumentPlanningError } from "../../document-planning-error.js";
+const MAXIMUM_OUTPUT_BYTES = 1_048_576;
+const BASE64_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+function sameEvidence(left, right) {
+    return (left.path === right.path &&
+        left.digest === right.digest &&
+        left.size === right.size);
+}
+function fail(code, message) {
+    throw new DocumentPlanningError(code, message);
+}
+function assertCompilationAuthority(input) {
+    if (input.catalog.status !== "complete") {
+        fail("DOCUMENT_PLANNING_CATALOG_PARTIAL", "Document planning requires a complete rebuilt catalog.");
+    }
+    if (input.catalog.projectId !== input.profile.projectId) {
+        fail("DOCUMENT_PLANNING_AUTHORITY_CHANGED", "Document profile and rebuilt catalog disagree on project identity.");
+    }
+    if (!sameEvidence(input.profile.evidence, input.catalog.authority.profile) ||
+        !sameEvidence(input.metadataSchema, input.catalog.authority.metadataSchema) ||
+        !sameEvidence(input.ownerCatalog, input.catalog.authority.ownerCatalog)) {
+        fail("DOCUMENT_PLANNING_AUTHORITY_CHANGED", "Document planning authority does not match the rebuilt catalog evidence.");
+    }
+    if (!input.catalog.ownerIds.includes(input.intent.owner)) {
+        fail("DOCUMENT_PLANNING_INPUT_INVALID", `Document owner ${input.intent.owner} is not present in the owner catalog.`);
+    }
+}
+function assertCanonicalOutput(output) {
+    const bytes = new TextEncoder().encode(output);
+    if (bytes.byteLength === 0 ||
+        bytes.byteLength > MAXIMUM_OUTPUT_BYTES ||
+        output.startsWith("\uFEFF") ||
+        output.includes("\u0000") ||
+        output.includes("\r") ||
+        !output.endsWith("\n") ||
+        output.endsWith("\n\n")) {
+        fail("DOCUMENT_PLANNING_OUTPUT_INVALID", "Rendered document violates the bounded canonical UTF-8/LF output contract.");
+    }
+    return bytes;
+}
+function equalBytes(left, right) {
+    return (left.byteLength === right.byteLength &&
+        left.every((value, index) => value === right[index]));
+}
+function encodeBase64(bytes) {
+    let result = "";
+    for (let index = 0; index < bytes.length; index += 3) {
+        const first = bytes[index] ?? 0;
+        const second = bytes[index + 1] ?? 0;
+        const third = bytes[index + 2] ?? 0;
+        const bits = (first << 16) | (second << 8) | third;
+        result += BASE64_ALPHABET[(bits >> 18) & 63];
+        result += BASE64_ALPHABET[(bits >> 12) & 63];
+        result += index + 1 < bytes.length ? BASE64_ALPHABET[(bits >> 6) & 63] : "=";
+        result += index + 2 < bytes.length ? BASE64_ALPHABET[bits & 63] : "=";
+    }
+    return result;
+}
+function assertDestinationState(input, outputBytes) {
+    if (input.state.expectedParent.path !==
+        documentRepositoryParentPath(input.destination)) {
+        fail("DOCUMENT_PLANNING_PARENT_UNAVAILABLE", "Observed parent does not match the planned document destination.");
+    }
+    if (input.state.destination.state === "conflict") {
+        fail("DOCUMENT_PLANNING_CONFLICT", `Document destination is a ${input.state.destination.kind}.`);
+    }
+    if (input.state.destination.state === "regular-file" &&
+        !equalBytes(input.state.destination.bytes, outputBytes)) {
+        fail("DOCUMENT_PLANNING_CONFLICT", "Document destination already contains different bytes.");
+    }
+}
+function assertSortedIdentityProjection(entries) {
+    const projection = entries.map(({ id, repositoryPath }) => Object.freeze({ id, repositoryPath }));
+    const sorted = projection.toSorted((left, right) => (left.id < right.id ? -1 : left.id > right.id ? 1 : 0) ||
+        (left.repositoryPath < right.repositoryPath
+            ? -1
+            : left.repositoryPath > right.repositoryPath
+                ? 1
+                : 0));
+    if (sorted.some((entry, index) => entry.id !== projection[index].id ||
+        entry.repositoryPath !== projection[index].repositoryPath)) {
+        fail("DOCUMENT_PLANNING_OUTPUT_INVALID", "Document identity projection is not in canonical binary order.");
+    }
+    return Object.freeze(projection);
+}
+/** Pure assembly of a validated, fully observed document planning snapshot. */
+export function compileDocumentPlan(input) {
+    assertCompilationAuthority(input);
+    const outputBytes = assertCanonicalOutput(input.output);
+    assertDestinationState(input, outputBytes);
+    const identityProjection = assertSortedIdentityProjection(input.identityProjection);
+    if (identityProjection.length > 100_000) {
+        fail("DOCUMENT_PLANNING_OUTPUT_INVALID", "Document identity projection exceeds the v1 entry budget.");
+    }
+    const references = projectReferencedDocuments(input.catalog, input.intent.related ?? []);
+    if (references.missingIds.length > 0 || references.unresolvedIds.length > 0) {
+        fail("DOCUMENT_PLANNING_INPUT_INVALID", "Document Intent references missing or ambiguous catalog identities.");
+    }
+    const referencedDocuments = Object.freeze(references.documents.map((reference) => Object.freeze({
+        ...reference,
+        projectionDigest: documentReferencedDocumentDigest(reference)
+    })));
+    const output = Object.freeze({
+        digest: sha256Bytes(outputBytes),
+        size: outputBytes.byteLength,
+        mode: "0644",
+        mediaType: "text/markdown; charset=utf-8",
+        contentBase64: encodeBase64(outputBytes)
+    });
+    const planWithoutDigest = {
+        schemaVersion: 1,
+        protocolVersion: 1,
+        compiler: input.compiler,
+        projectId: input.profile.projectId,
+        intent: input.intent,
+        intentDigest: documentIntentDigest(input.intent),
+        authority: Object.freeze({
+            profile: input.profile.evidence,
+            metadataSchema: input.metadataSchema,
+            ownerCatalog: input.ownerCatalog,
+            template: input.template.evidence
+        }),
+        selectedOwner: Object.freeze({
+            id: input.intent.owner,
+            membershipDigest: documentOwnerMembershipDigest(input.ownerCatalog.digest, input.intent.owner)
+        }),
+        identityProjection: Object.freeze({
+            entryCount: identityProjection.length,
+            digest: documentIdentityProjectionDigest(identityProjection)
+        }),
+        referencedDocuments,
+        destination: input.destination,
+        expectedParent: input.state.expectedParent,
+        destinationPrecondition: Object.freeze({ state: "absent" }),
+        output,
+        requiredAdapterCapabilities: Object.freeze([
+            "create-file-no-replace/v1"
+        ]),
+        diagnostics: Object.freeze([])
+    };
+    const digestInput = planWithoutDigest;
+    const plan = Object.freeze({
+        ...digestInput,
+        planDigest: documentPlanDigest({
+            ...digestInput,
+            planDigest: "sha256:0000000000000000000000000000000000000000000000000000000000000000"
+        })
+    });
+    assertDocumentPlanDigests(plan);
+    return plan;
+}
+//# sourceMappingURL=compile-document-plan.js.map

package/dist/document-authoring/application/use-cases/compile-document-plan.js.map

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

package/dist/document-authoring/application/use-cases/plan-documentation-document.d.ts

@@ -0,0 +1,66 @@
+import type { DocumentIdentityProjectionEntry, DocumentationCatalogSnapshot } from "../model/document-catalog.js";
+import type { DocumentArtifactType, DocumentIntent, DocumentPlan, DocumentPlanningProfileSnapshot } from "../model/document-planning.js";
+import type { CanonicalDocumentRenderer } from "../ports/canonical-document-renderer.js";
+import type { DocumentContractValidator } from "../ports/document-contract-validator.js";
+import type { DocumentPlanningProfileReader } from "../ports/document-planning-profile-reader.js";
+import type { DocumentPlanningStateReader } from "../ports/document-planning-state-reader.js";
+import type { DocumentTemplateReader } from "../ports/document-template-reader.js";
+import type { DocumentationCatalogReader } from "../ports/documentation-catalog-reader.js";
+import type { MetadataInstanceValidator } from "../ports/metadata-instance-validator.js";
+import type { OwnerMembershipReader } from "../ports/owner-membership-reader.js";
+interface ResolvedDocumentAuthoring {
+    readonly artifact: DocumentArtifactType;
+    readonly slug?: string;
+    readonly destination: string;
+    readonly heading: string;
+}
+interface DocumentLogicalPreimage {
+    readonly identityProjection: readonly DocumentIdentityProjectionEntry[];
+    readonly isExactSelf: boolean;
+}
+/**
+ * Closed pure policy surface consumed by the read-only orchestration use case.
+ * Implementations live in the policy layer; consumer code cannot supply it from
+ * the public composition root.
+ */
+interface DocumentPlanningPolicies {
+    normalizeDocumentIntent(input: DocumentIntent): DocumentIntent;
+    selectDocumentArtifact(profile: DocumentPlanningProfileSnapshot, type: string): DocumentArtifactType;
+    resolveDocumentAuthoring(input: {
+        readonly artifact: DocumentArtifactType;
+        readonly intent: DocumentIntent;
+    }): ResolvedDocumentAuthoring;
+    isDestinationCoveredByCatalog(destination: string, collections: DocumentPlanningProfileSnapshot["collections"], excludedPrefixes: readonly string[]): boolean;
+    classifyDocumentLogicalPreimage(input: {
+        readonly catalog: DocumentationCatalogSnapshot;
+        readonly id: string;
+        readonly destination: string;
+        readonly observedBytes?: Uint8Array;
+        readonly expectedBytes: Uint8Array;
+    }): DocumentLogicalPreimage;
+}
+export interface PlanDocumentationDocumentRequest {
+    readonly consumerRoot: string;
+    readonly profilePath: string;
+    readonly intent: unknown;
+    readonly signal?: AbortSignal;
+}
+interface Dependencies {
+    readonly catalog: DocumentationCatalogReader;
+    readonly compiler: DocumentPlan["compiler"];
+    readonly contracts: DocumentContractValidator;
+    readonly metadata: MetadataInstanceValidator;
+    readonly owners: OwnerMembershipReader;
+    readonly policies: DocumentPlanningPolicies;
+    readonly profile: DocumentPlanningProfileReader;
+    readonly renderer: CanonicalDocumentRenderer;
+    readonly state: DocumentPlanningStateReader;
+    readonly templates: DocumentTemplateReader;
+}
+export declare class PlanDocumentationDocument {
+    #private;
+    constructor(dependencies: Dependencies);
+    execute(request: PlanDocumentationDocumentRequest): Promise<DocumentPlan>;
+}
+export {};
+//# sourceMappingURL=plan-documentation-document.d.ts.map

package/dist/document-authoring/application/use-cases/plan-documentation-document.d.ts.map

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

package/dist/document-authoring/application/use-cases/plan-documentation-document.js

@@ -0,0 +1,276 @@
+import { assertNotCancelled } from "../../../cancellation.js";
+import { assertDocumentPlanDigests } from "../policies/document-contract-digests.js";
+import { DocumentPlanningError } from "../../document-planning-error.js";
+import { compileDocumentPlan } from "./compile-document-plan.js";
+function signalOption(signal) {
+    return signal === undefined ? {} : { signal };
+}
+function sameEvidence(left, right) {
+    return (left.path === right.path &&
+        left.digest === right.digest &&
+        left.size === right.size);
+}
+function assertStableEvidence(name, before, after) {
+    if (!sameEvidence(before, after)) {
+        throw new DocumentPlanningError("DOCUMENT_PLANNING_AUTHORITY_CHANGED", `${name} changed while the document Plan was compiled.`);
+    }
+}
+function outputBytes(output) {
+    return new TextEncoder().encode(output);
+}
+function sameBytes(left, right) {
+    return left.length === right.length &&
+        left.every((value, index) => value === right[index]);
+}
+function samePlanningState(left, right) {
+    if (left.expectedParent.path !== right.expectedParent.path ||
+        left.destination.state !== right.destination.state) {
+        return false;
+    }
+    if (left.destination.state === "absent" || right.destination.state === "absent") {
+        return left.destination.state === right.destination.state;
+    }
+    if (left.destination.state === "conflict" || right.destination.state === "conflict") {
+        return left.destination.state === "conflict" &&
+            right.destination.state === "conflict" &&
+            left.destination.kind === right.destination.kind;
+    }
+    return sameBytes(left.destination.bytes, right.destination.bytes);
+}
+function assertStablePlanningState(before, after) {
+    if (!samePlanningState(before, after)) {
+        throw new DocumentPlanningError("DOCUMENT_PLANNING_AUTHORITY_CHANGED", "Document destination or parent changed while the Plan was compiled.");
+    }
+}
+function assertStableCatalog(before, after) {
+    if (!sameCatalogSnapshot(before, after)) {
+        throw new DocumentPlanningError("DOCUMENT_PLANNING_AUTHORITY_CHANGED", "Document catalog changed while the Plan was compiled.");
+    }
+}
+function sameEvidenceList(left, right) {
+    return left.length === right.length &&
+        left.every((entry, index) => sameEvidence(entry, right[index]));
+}
+function sameCatalogSnapshot(left, right) {
+    const leftAuthority = [
+        left.authority.profile,
+        left.authority.metadataSchema,
+        left.authority.ownerCatalog
+    ];
+    const rightAuthority = [
+        right.authority.profile,
+        right.authority.metadataSchema,
+        right.authority.ownerCatalog
+    ];
+    return left.status === right.status &&
+        left.projectId === right.projectId &&
+        sameEvidenceList(leftAuthority, rightAuthority) &&
+        JSON.stringify(left.diagnostics) === JSON.stringify(right.diagnostics) &&
+        JSON.stringify(left.documents) === JSON.stringify(right.documents) &&
+        JSON.stringify(left.identityProjection) === JSON.stringify(right.identityProjection) &&
+        JSON.stringify(left.ownerIds) === JSON.stringify(right.ownerIds);
+}
+async function loadPlanningAuthority(dependencies, request, profile, templatePath) {
+    const options = signalOption(request.signal);
+    const [catalog, metadata, owners, template] = await Promise.all([
+        dependencies.catalog.execute({
+            consumerRoot: request.consumerRoot,
+            profilePath: request.profilePath,
+            ...options
+        }),
+        dependencies.metadata.load({
+            consumerRoot: request.consumerRoot,
+            path: profile.metadataSchemaPath,
+            ...options
+        }),
+        dependencies.owners.read({
+            consumerRoot: request.consumerRoot,
+            contract: profile.ownerCatalog.contract,
+            path: profile.ownerCatalog.path,
+            ...options
+        }),
+        dependencies.templates.read({
+            consumerRoot: request.consumerRoot,
+            path: templatePath,
+            ...options
+        })
+    ]);
+    return { catalog, metadata, owners, template };
+}
+function assertCatalogAuthority(profile, intent, authority) {
+    if (authority.catalog.status !== "complete") {
+        throw new DocumentPlanningError("DOCUMENT_PLANNING_CATALOG_PARTIAL", "Document planning requires a complete rebuilt catalog.");
+    }
+    assertStableEvidence("Document profile", profile.evidence, authority.catalog.authority.profile);
+    assertStableEvidence("Document metadata schema", authority.metadata.evidence, authority.catalog.authority.metadataSchema);
+    assertStableEvidence("Document owner catalog", authority.owners.evidence, authority.catalog.authority.ownerCatalog);
+    if (!authority.owners.ids.includes(intent.owner)) {
+        throw new DocumentPlanningError("DOCUMENT_PLANNING_INPUT_INVALID", `Document owner ${intent.owner} is not present in the owner catalog.`);
+    }
+}
+async function recaptureAuthority(input) {
+    const { authority, dependencies, destination, profile, request, state, templatePath } = input;
+    const options = signalOption(request.signal);
+    const [profileAfter, metadataAfter, ownersAfter, templateAfter] = await Promise.all([
+        dependencies.profile.read({
+            consumerRoot: request.consumerRoot,
+            path: request.profilePath,
+            ...options
+        }),
+        dependencies.metadata.load({
+            consumerRoot: request.consumerRoot,
+            path: profile.metadataSchemaPath,
+            ...options
+        }),
+        dependencies.owners.read({
+            consumerRoot: request.consumerRoot,
+            contract: profile.ownerCatalog.contract,
+            path: profile.ownerCatalog.path,
+            ...options
+        }),
+        dependencies.templates.read({
+            consumerRoot: request.consumerRoot,
+            path: templatePath,
+            ...options
+        })
+    ]);
+    assertStableEvidence("Document profile", profile.evidence, profileAfter.evidence);
+    assertStableEvidence("Document metadata schema", authority.metadata.evidence, metadataAfter.evidence);
+    assertStableEvidence("Document owner catalog", authority.owners.evidence, ownersAfter.evidence);
+    assertStableEvidence("Document template", authority.template.evidence, templateAfter.evidence);
+    const stateBeforeCatalog = await dependencies.state.observe({
+        consumerRoot: request.consumerRoot,
+        destination,
+        ...options
+    });
+    assertStablePlanningState(state, stateBeforeCatalog);
+    const catalogAfter = await dependencies.catalog.execute({
+        consumerRoot: request.consumerRoot,
+        profilePath: request.profilePath,
+        ...options
+    });
+    assertStableCatalog(authority.catalog, catalogAfter);
+    const [stateAfterCatalog, templateAfterCatalog] = await Promise.all([
+        dependencies.state.observe({
+            consumerRoot: request.consumerRoot,
+            destination,
+            ...options
+        }),
+        dependencies.templates.read({
+            consumerRoot: request.consumerRoot,
+            path: templatePath,
+            ...options
+        })
+    ]);
+    assertStablePlanningState(state, stateAfterCatalog);
+    assertStableEvidence("Document template", authority.template.evidence, templateAfterCatalog.evidence);
+}
+export class PlanDocumentationDocument {
+    #dependencies;
+    constructor(dependencies) {
+        this.#dependencies = dependencies;
+    }
+    async execute(request) {
+        assertNotCancelled(request.signal);
+        const options = signalOption(request.signal);
+        const validatedIntent = await this.#dependencies.contracts.validateIntent(request.intent);
+        assertNotCancelled(request.signal);
+        const intent = this.#dependencies.policies.normalizeDocumentIntent(validatedIntent);
+        const profile = await this.#dependencies.profile.read({
+            consumerRoot: request.consumerRoot,
+            path: request.profilePath,
+            ...options
+        });
+        const artifact = this.#dependencies.policies.selectDocumentArtifact(profile, intent.type);
+        const resolved = this.#dependencies.policies.resolveDocumentAuthoring({
+            artifact,
+            intent
+        });
+        if (!this.#dependencies.policies.isDestinationCoveredByCatalog(resolved.destination, profile.collections, profile.excludedPrefixes)) {
+            throw new DocumentPlanningError("DOCUMENT_PLANNING_INPUT_INVALID", "Planned destination is outside the complete documentation catalog.");
+        }
+        const authority = await loadPlanningAuthority(this.#dependencies, request, profile, resolved.artifact.template.path);
+        assertCatalogAuthority(profile, intent, authority);
+        if (authority.template.evidence.path !== resolved.artifact.template.path) {
+            throw new DocumentPlanningError("DOCUMENT_PLANNING_AUTHORITY_CHANGED", "Document template evidence does not match the selected artifact authority.");
+        }
+        const skeleton = this.#dependencies.renderer.parseTemplate(authority.template.source);
+        const frontmatter = Object.freeze({
+            id: intent.id,
+            type: intent.type,
+            status: resolved.artifact.initialStatus,
+            owner: intent.owner,
+            summary: intent.summary,
+            ...(intent.related === undefined ? {} : { related: intent.related }),
+            ...(intent.additionalMetadata === undefined
+                ? {}
+                : { additionalMetadata: intent.additionalMetadata })
+        });
+        const validation = authority.metadata.validate({
+            id: frontmatter.id,
+            type: frontmatter.type,
+            status: frontmatter.status,
+            owner: frontmatter.owner,
+            summary: frontmatter.summary,
+            ...(frontmatter.related === undefined ? {} : { related: frontmatter.related }),
+            ...(frontmatter.additionalMetadata === undefined
+                ? {}
+                : frontmatter.additionalMetadata)
+        });
+        if (!validation.valid) {
+            throw new DocumentPlanningError("DOCUMENT_PLANNING_OUTPUT_INVALID", `Compiled document metadata is invalid: ${validation.messages.join("; ")}`);
+        }
+        const output = this.#dependencies.renderer.render({
+            frontmatter,
+            heading: resolved.heading,
+            template: skeleton
+        });
+        const expectedBytes = outputBytes(output);
+        const state = await this.#dependencies.state.observe({
+            consumerRoot: request.consumerRoot,
+            destination: resolved.destination,
+            ...options
+        });
+        const logicalPreimage = this.#dependencies.policies.classifyDocumentLogicalPreimage({
+            catalog: authority.catalog,
+            id: intent.id,
+            destination: resolved.destination,
+            ...(state.destination.state === "regular-file"
+                ? { observedBytes: state.destination.bytes }
+                : {}),
+            expectedBytes
+        });
+        if ((state.destination.state === "regular-file") !==
+            logicalPreimage.isExactSelf) {
+            throw new DocumentPlanningError("DOCUMENT_PLANNING_CONFLICT", "Existing destination is not the exact logical document self.");
+        }
+        await recaptureAuthority({
+            authority,
+            dependencies: this.#dependencies,
+            destination: resolved.destination,
+            profile,
+            request,
+            state,
+            templatePath: resolved.artifact.template.path
+        });
+        assertNotCancelled(request.signal);
+        const plan = compileDocumentPlan({
+            catalog: authority.catalog,
+            compiler: this.#dependencies.compiler,
+            destination: resolved.destination,
+            identityProjection: logicalPreimage.identityProjection,
+            intent,
+            metadataSchema: authority.metadata.evidence,
+            ownerCatalog: authority.owners.evidence,
+            output,
+            profile,
+            state,
+            template: authority.template
+        });
+        const validatedPlan = await this.#dependencies.contracts.validatePlan(plan);
+        assertDocumentPlanDigests(validatedPlan);
+        assertNotCancelled(request.signal);
+        return validatedPlan;
+    }
+}
+//# sourceMappingURL=plan-documentation-document.js.map

package/dist/document-authoring/application/use-cases/plan-documentation-document.js.map

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

package/dist/document-authoring/document-planning-error.d.ts

@@ -0,0 +1,6 @@
+export type DocumentPlanningErrorCode = "DOCUMENT_PLANNING_AUTHORITY_CHANGED" | "DOCUMENT_PLANNING_AUTHORITY_UNAVAILABLE" | "DOCUMENT_PLANNING_CATALOG_PARTIAL" | "DOCUMENT_PLANNING_CONFLICT" | "DOCUMENT_PLANNING_INPUT_INVALID" | "DOCUMENT_PLANNING_OUTPUT_INVALID" | "DOCUMENT_PLANNING_PARENT_UNAVAILABLE";
+export declare class DocumentPlanningError extends Error {
+    readonly code: DocumentPlanningErrorCode;
+    constructor(code: DocumentPlanningErrorCode, message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=document-planning-error.d.ts.map

package/dist/document-authoring/document-planning-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-planning-error.d.ts","sourceRoot":"","sources":["../../src/document-authoring/document-planning-error.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,yBAAyB,GACjC,qCAAqC,GACrC,yCAAyC,GACzC,mCAAmC,GACnC,4BAA4B,GAC5B,iCAAiC,GACjC,kCAAkC,GAClC,sCAAsC,CAAC;AAE3C,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IAEzC,YACE,IAAI,EAAE,yBAAyB,EAC/B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY,EAKvB;CACF"}

package/dist/document-authoring/document-planning-error.js

@@ -0,0 +1,9 @@
+export class DocumentPlanningError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = "DocumentPlanningError";
+        this.code = code;
+    }
+}
+//# sourceMappingURL=document-planning-error.js.map

package/dist/document-authoring/document-planning-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-planning-error.js","sourceRoot":"","sources":["../../src/document-authoring/document-planning-error.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACrC,IAAI,CAA4B;IAEzC,YACE,IAA+B,EAC/B,OAAe,EACf,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/document-authoring/index.d.ts

@@ -1,12 +1,22 @@
 import { type BuildDocumentationCatalogRequest } from "./application/use-cases/build-documentation-catalog.js";
 import { type FindDocumentsRequest } from "./application/use-cases/find-documents.js";
+import { type PlanDocumentationDocumentRequest } from "./application/use-cases/plan-documentation-document.js";
 export type { DocumentAuthorityDigest, DocumentAuthorityEvidence, DocumentDescriptor, DocumentIdentityProjectionEntry, DocumentationCatalogAuthority, DocumentationCatalogDiagnostic, DocumentationCatalogSnapshot, ReferencedDocumentProjection, ReferencedDocumentProjectionResult } from "./application/model/document-catalog.js";
 export type { DocumentFindFilters, DocumentFindQuery, DocumentFindResult } from "./application/model/document-find.js";
+export type { DocumentCompilerIdentity, DocumentIntent, DocumentJsonObject, DocumentJsonPrimitive, DocumentJsonValue, DocumentPlan, DocumentPlanDiagnostic } from "./application/model/document-planning.js";
 export type { BuildDocumentationCatalogRequest } from "./application/use-cases/build-documentation-catalog.js";
 export type { FindDocumentsRequest } from "./application/use-cases/find-documents.js";
+export type { PlanDocumentationDocumentRequest } from "./application/use-cases/plan-documentation-document.js";
 export { projectReferencedDocuments } from "./application/projections/document-catalog-projections.js";
 export { DocumentCatalogError } from "./document-catalog-error.js";
 export type { DocumentCatalogErrorCode } from "./document-catalog-error.js";
+export { DocumentPlanningError } from "./document-planning-error.js";
+export type { DocumentPlanningErrorCode } from "./document-planning-error.js";
 export declare function buildDocumentationCatalog(request: BuildDocumentationCatalogRequest): Promise<import("./application/model/document-catalog.js").DocumentationCatalogSnapshot>;
 export declare function findDocumentationDocuments(request: FindDocumentsRequest): Promise<import("./application/model/document-find.js").DocumentFindResult>;
+/**
+ * Compiles a deterministic Document Plan without reserving an identity or
+ * mutating the consumer repository.
+ */
+export declare function planDocumentationDocument(request: PlanDocumentationDocumentRequest): Promise<import("./application/model/document-planning.js").DocumentPlan>;
 //# sourceMappingURL=index.d.ts.map

package/dist/document-authoring/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/document-authoring/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,wDAAwD,CAAC;AAChE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,2CAA2C,CAAC;AAEnD,YAAY,EACV,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,+BAA+B,EAC/B,6BAA6B,EAC7B,8BAA8B,EAC9B,4BAA4B,EAC5B,4BAA4B,EAC5B,kCAAkC,EACnC,MAAM,yCAAyC,CAAC;AACjD,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EAAE,gCAAgC,EAAE,MAAM,wDAAwD,CAAC;AAC/G,YAAY,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,0BAA0B,EAAE,MAAM,2DAA2D,CAAC;AACvG,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAE5E,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,gCAAgC,2FAS1C;AAED,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,oBAAoB,8EAQ7E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/document-authoring/index.ts"],"names":[],"mappings":"AAwBA,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,wDAAwD,CAAC;AAChE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,wDAAwD,CAAC;AAGhE,YAAY,EACV,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,+BAA+B,EAC/B,6BAA6B,EAC7B,8BAA8B,EAC9B,4BAA4B,EAC5B,4BAA4B,EAC5B,kCAAkC,EACnC,MAAM,yCAAyC,CAAC;AACjD,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EACV,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACvB,MAAM,0CAA0C,CAAC;AAClD,YAAY,EAAE,gCAAgC,EAAE,MAAM,wDAAwD,CAAC;AAC/G,YAAY,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACtF,YAAY,EAAE,gCAAgC,EAAE,MAAM,wDAAwD,CAAC;AAC/G,OAAO,EAAE,0BAA0B,EAAE,MAAM,2DAA2D,CAAC;AACvG,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,YAAY,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAE9E,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,gCAAgC,2FAS1C;AAED,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,oBAAoB,8EAQ7E;AAWD;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,gCAAgC,4EAiD1C"}