@agent-teams/engineering-foundation 0.21.0 → 1.0.0

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

@@ -1,273 +0,0 @@
-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/document-authoring/application/use-cases/plan-documentation-document.js.map

@@ -1 +0,0 @@
-{"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/application/use-cases/recapture-directory-receipt-evidence.d.ts

@@ -1,8 +0,0 @@
-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/document-authoring/application/use-cases/recapture-directory-receipt-evidence.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"recapture-directory-receipt-evidence.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/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/document-authoring/application/use-cases/recapture-directory-receipt-evidence.js

@@ -1,32 +0,0 @@
-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/document-authoring/application/use-cases/recapture-directory-receipt-evidence.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"recapture-directory-receipt-evidence.js","sourceRoot":"","sources":["../../../../src/document-authoring/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/document-authoring/application/use-cases/recover-document-transaction.d.ts

@@ -1,10 +0,0 @@
-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/document-authoring/application/use-cases/recover-document-transaction.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"recover-document-transaction.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/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"}