@agent-teams/document-authoring 0.0.0

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

@@ -0,0 +1,273 @@
+import { assertNotCancelled } from "../../cancellation.js";
+import { assertArtifactOwnerAllowed } from "../policies/assert-artifact-owner-allowed.js";
+import { assertV2PlanningProfile } from "../policies/assert-v2-planning-profile.js";
+import { assertDocumentPlanDigests } from "../policies/document-contract-digests.js";
+import { sameDocumentCatalogSnapshot } from "../policies/same-document-catalog-snapshot.js";
+import { DocumentPlanningError } from "../../document-planning-error.js";
+import { compileDocumentPlan } from "./compile-document-plan.js";
+import { loadV2ProfileDescription } from "./load-v2-profile-description.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 ||
+        JSON.stringify(left.parentMaterialization) !==
+            JSON.stringify(right.parentMaterialization)) {
+        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 (!sameDocumentCatalogSnapshot(before, after)) {
+        throw new DocumentPlanningError("DOCUMENT_PLANNING_AUTHORITY_CHANGED", "Document catalog changed while the Plan was compiled.");
+    }
+}
+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,
+        ...(request.parentPolicy === undefined
+            ? {}
+            : { parentPolicy: request.parentPolicy }),
+        ...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,
+            ...(request.parentPolicy === undefined
+                ? {}
+                : { parentPolicy: request.parentPolicy }),
+            ...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
+        });
+        assertV2PlanningProfile(profile, request.parentPolicy);
+        const artifact = this.#dependencies.policies.selectDocumentArtifact(profile, intent.type);
+        assertArtifactOwnerAllowed(artifact, intent);
+        const profileDescription = await loadV2ProfileDescription(this.#dependencies.profileDescription, profile, { consumerRoot: request.consumerRoot, profilePath: request.profilePath, ...options });
+        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,
+            ...(request.parentPolicy === undefined
+                ? {}
+                : { parentPolicy: request.parentPolicy }),
+            ...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,
+            ...(profileDescription === undefined ? {} : {
+                profileSemanticDigest: profileDescription.semanticDigest
+            }),
+            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/application/use-cases/plan-documentation-document.js.map

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

package/dist/application/use-cases/recapture-directory-receipt-evidence.d.ts

@@ -0,0 +1,8 @@
+import type { DocumentParentMaterializerV2 } from "../ports/document-parent-materializer.js";
+import type { ActiveDocumentJournal } from "./document-transaction-continuation.js";
+import { type DocumentDirectoryReceiptEvidence } from "./document-transaction-receipts.js";
+export declare function recaptureDirectoryReceiptEvidence(parentMaterializer: DocumentParentMaterializerV2, consumerRoot: string, active: ActiveDocumentJournal): Promise<{
+    readonly current: boolean;
+    readonly evidence?: DocumentDirectoryReceiptEvidence;
+}>;
+//# sourceMappingURL=recapture-directory-receipt-evidence.d.ts.map

package/dist/application/use-cases/recapture-directory-receipt-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recapture-directory-receipt-evidence.d.ts","sourceRoot":"","sources":["../../../src/application/use-cases/recapture-directory-receipt-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AAC7F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AACpF,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,oCAAoC,CAAC;AAE5C,wBAAsB,iCAAiC,CACrD,kBAAkB,EAAE,4BAA4B,EAChD,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC;IACT,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,gCAAgC,CAAC;CACtD,CAAC,CA4BD"}

package/dist/application/use-cases/recapture-directory-receipt-evidence.js

@@ -0,0 +1,32 @@
+import { directoryReceiptEvidence } from "./document-transaction-receipts.js";
+export async function recaptureDirectoryReceiptEvidence(parentMaterializer, consumerRoot, active) {
+    const evidence = directoryReceiptEvidence(active.envelope);
+    if (active.envelope.schemaVersion !== 4 || evidence === undefined) {
+        return { current: true, ...(evidence === undefined ? {} : { evidence }) };
+    }
+    try {
+        const inspection = await parentMaterializer.inspect({
+            consumerRoot,
+            journal: {
+                anchorIdentity: active.envelope.journal.parentMaterialization.anchorIdentity,
+                createdDirectories: active.envelope.journal.parentMaterialization.createdDirectories,
+                plan: active.envelope.journal.plan.parentMaterialization,
+                schemaVersion: 2
+            }
+        });
+        if (inspection.state === "current") {
+            return { current: true, evidence };
+        }
+    }
+    catch {
+        // Unsafe or unavailable filesystem evidence is intentionally downgraded.
+    }
+    return {
+        current: false,
+        evidence: {
+            observedCreatedDirectories: evidence.observedCreatedDirectories,
+            state: "preserved-unknown"
+        }
+    };
+}
+//# sourceMappingURL=recapture-directory-receipt-evidence.js.map

package/dist/application/use-cases/recapture-directory-receipt-evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recapture-directory-receipt-evidence.js","sourceRoot":"","sources":["../../../src/application/use-cases/recapture-directory-receipt-evidence.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,wBAAwB,EAEzB,MAAM,oCAAoC,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,kBAAgD,EAChD,YAAoB,EACpB,MAA6B;IAK7B,MAAM,QAAQ,GAAG,wBAAwB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3D,IAAI,MAAM,CAAC,QAAQ,CAAC,aAAa,KAAK,CAAC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC5E,CAAC;IACD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC;YAClD,YAAY;YACZ,OAAO,EAAE;gBACP,cAAc,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,qBAAqB,CAAC,cAAc;gBAC5E,kBAAkB,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,qBAAqB,CAAC,kBAAkB;gBACpF,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB;gBACxD,aAAa,EAAE,CAAC;aACjB;SACF,CAAC,CAAC;QACH,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACnC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACrC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;IAC3E,CAAC;IACD,OAAO;QACL,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE;YACR,0BAA0B,EAAE,QAAQ,CAAC,0BAA0B;YAC/D,KAAK,EAAE,mBAAmB;SAC3B;KACF,CAAC;AACJ,CAAC"}

package/dist/application/use-cases/recover-document-transaction.d.ts

@@ -0,0 +1,10 @@
+import type { DocumentReceiptContract as DocumentReceipt } from "../model/document-receipt.js";
+import type { DocumentTransactionCoordinator } from "../ports/document-transaction-coordinator.js";
+import { type DocumentTransactionRequest, type DocumentTransactionRuntime } from "./document-transaction-continuation.js";
+export interface RecoverDocumentTransactionDependencies extends DocumentTransactionRuntime {
+    readonly coordinator: DocumentTransactionCoordinator;
+}
+export type RecoverDocumentTransactionRequest = DocumentTransactionRequest;
+/** Recovers only a current, strictly validated v3/v2 transaction. */
+export declare function recoverDocumentTransaction(dependencies: RecoverDocumentTransactionDependencies, request: RecoverDocumentTransactionRequest): Promise<DocumentReceipt>;
+//# sourceMappingURL=recover-document-transaction.d.ts.map

package/dist/application/use-cases/recover-document-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recover-document-transaction.d.ts","sourceRoot":"","sources":["../../../src/application/use-cases/recover-document-transaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,IAAI,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/F,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,8CAA8C,CAAC;AAOnG,OAAO,EAQL,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAChC,MAAM,wCAAwC,CAAC;AAYhD,MAAM,WAAW,sCACjB,SAAQ,0BAA0B;IAChC,QAAQ,CAAC,WAAW,EAAE,8BAA8B,CAAC;CACtD;AAED,MAAM,MAAM,iCAAiC,GAAG,0BAA0B,CAAC;AAqc3E,qEAAqE;AACrE,wBAAsB,0BAA0B,CAC9C,YAAY,EAAE,sCAAsC,EACpD,OAAO,EAAE,iCAAiC,GACzC,OAAO,CAAC,eAAe,CAAC,CAe1B"}