@agent-teams/engineering-foundation 0.14.0 → 0.16.0-rc.0

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/application/use-cases/recover-document-transaction.d.ts

@@ -0,0 +1,10 @@
+import type { 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

@@ -0,0 +1 @@
+{"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,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,8CAA8C,CAAC;AAOnG,OAAO,EAQL,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAChC,MAAM,wCAAwC,CAAC;AAQhD,MAAM,WAAW,sCACjB,SAAQ,0BAA0B;IAChC,QAAQ,CAAC,WAAW,EAAE,8BAA8B,CAAC;CACtD;AAED,MAAM,MAAM,iCAAiC,GAAG,0BAA0B,CAAC;AAoS3E,qEAAqE;AACrE,wBAAsB,0BAA0B,CAC9C,YAAY,EAAE,sCAAsC,EACpD,OAAO,EAAE,iCAAiC,GACzC,OAAO,CAAC,eAAe,CAAC,CAe1B"}

package/dist/document-authoring/application/use-cases/recover-document-transaction.js

@@ -0,0 +1,233 @@
+import { classifyDocumentRecovery } from "../policies/classify-document-recovery.js";
+import { completePublishedTransaction, continuePendingPublication, errorMessage, finalizeDocumentTransaction, recoveryReceipt, isCancellation } from "./document-transaction-continuation.js";
+import { DocumentTransactionUseCaseError } from "./document-transaction-error.js";
+import { assertNonzeroDocumentPhysicalIdentity } from "../model/document-physical-identity.js";
+import { executeWithDocumentTransactionLease } from "./document-transaction-execution.js";
+function signalOption(signal) {
+    return signal === undefined ? {} : { signal };
+}
+function transactionFailure(error) {
+    if (error instanceof DocumentTransactionUseCaseError) {
+        return error;
+    }
+    return new DocumentTransactionUseCaseError("DOCUMENT_TRANSACTION_INCONSISTENT", `Document recovery could not establish a truthful outcome: ${errorMessage(error)}`, { cause: error });
+}
+function nonzero(identity) {
+    return identity.birthtimeNs !== "0" && identity.dev !== "0" && identity.ino !== "0";
+}
+function sameIdentity(left, right) {
+    return left.birthtimeNs === right.birthtimeNs &&
+        left.dev === right.dev && left.ino === right.ino;
+}
+function destinationObservation(active, state) {
+    if (state.state !== "exact") {
+        return state;
+    }
+    if (!nonzero(state.identity)) {
+        return { identity: "zero-identity", state: "exact" };
+    }
+    if (active.envelope.state === "PUBLISHING") {
+        return {
+            identity: sameIdentity(state.identity, active.envelope.journal.ownedTemporary.identity)
+                ? "bound-temporary"
+                : "different",
+            state: "exact"
+        };
+    }
+    if (active.envelope.state === "PUBLISHED") {
+        return {
+            identity: sameIdentity(state.identity, active.envelope.journal.publicationIdentity)
+                ? "bound-publication"
+                : "different",
+            state: "exact"
+        };
+    }
+    return { identity: "unbound", state: "exact" };
+}
+function temporaryObservation(active, state, exactState) {
+    if (active.envelope.state !== "PUBLISHING") {
+        return state.state === "absent"
+            ? { state: "absent" }
+            : state.state === "unverifiable"
+                ? { state: "unverifiable" }
+                : nonzero(state.identity)
+                    ? { identity: "nonzero", state: "replaced" }
+                    : { state: "zero-identity" };
+    }
+    if (!nonzero(active.envelope.journal.ownedTemporary.identity)) {
+        return { state: "zero-identity" };
+    }
+    if (exactState?.state === "absent") {
+        return { state: "absent" };
+    }
+    if (exactState?.state === "owned-exact") {
+        return { identity: "nonzero", state: "exact" };
+    }
+    if (exactState?.state === "unverifiable") {
+        return { state: "unverifiable" };
+    }
+    return { identity: "nonzero", state: "replaced" };
+}
+async function observe(dependencies, request, active) {
+    const plan = active.envelope.journal.plan;
+    const [destination, derived] = await Promise.all([
+        dependencies.fileState.classifyDestination({
+            consumerRoot: request.consumerRoot,
+            plan,
+            ...signalOption(request.signal)
+        }),
+        dependencies.fileState.classifyDerivedTemporary({
+            consumerRoot: request.consumerRoot,
+            plan,
+            ...signalOption(request.signal)
+        })
+    ]);
+    const temporary = active.envelope.state === "PUBLISHING"
+        ? active.envelope.journal.ownedTemporary
+        : undefined;
+    const exactTemporary = temporary === undefined
+        ? undefined
+        : await dependencies.fileState.classifyTemporary({
+            consumerRoot: request.consumerRoot,
+            temporary,
+            ...signalOption(request.signal)
+        });
+    const journal = active.envelope.state === "PREPARED"
+        ? {
+            boundIdentity: "none",
+            fileIdentity: nonzero(active.authority.identity) ? "nonzero" : "zero-identity",
+            lifecycle: "PREPARED",
+            preparedState: active.envelope.journal.destination.state,
+            version: "v2"
+        }
+        : active.envelope.state === "PUBLISHING"
+            ? {
+                boundIdentity: nonzero(active.envelope.journal.ownedTemporary.identity)
+                    ? "temporary" : "zero-identity",
+                fileIdentity: nonzero(active.authority.identity) ? "nonzero" : "zero-identity",
+                lifecycle: "PUBLISHING",
+                version: "v2"
+            }
+            : {
+                boundIdentity: nonzero(active.envelope.journal.publicationIdentity)
+                    ? "publication" : "zero-identity",
+                fileIdentity: nonzero(active.authority.identity) ? "nonzero" : "zero-identity",
+                lifecycle: "PUBLISHED",
+                version: "v2"
+            };
+    return {
+        observation: {
+            destination: destinationObservation(active, destination),
+            journal,
+            temporary: temporaryObservation(active, derived, exactTemporary)
+        },
+        ...(temporary === undefined ? {} : { temporary })
+    };
+}
+async function readActiveJournal(dependencies) {
+    let stored;
+    try {
+        stored = await dependencies.journal.read();
+    }
+    catch (error) {
+        throw new DocumentTransactionUseCaseError("DOCUMENT_TRANSACTION_EVIDENCE_UNAVAILABLE", "Document recovery evidence cannot be trusted; no Receipt can be bound safely.", { cause: error });
+    }
+    if (stored === undefined) {
+        throw new DocumentTransactionUseCaseError("DOCUMENT_TRANSACTION_EVIDENCE_UNAVAILABLE", "Coordinator reported recovery but the trusted document journal is absent.");
+    }
+    return { authority: stored.authority, envelope: stored.envelope };
+}
+async function executeRecoveryDecision(dependencies, request, active, observed, action) {
+    switch (action) {
+        case "resume-prepare":
+            return continuePendingPublication(dependencies, request, active);
+        case "resume-publish":
+            if (observed.temporary === undefined) {
+                throw new DocumentTransactionUseCaseError("DOCUMENT_TRANSACTION_INCONSISTENT", "Recovery classifier requested publication without a bound temporary.");
+            }
+            return continuePendingPublication(dependencies, request, active, observed.temporary);
+        case "complete-publication":
+            if (observed.temporary === undefined) {
+                throw new DocumentTransactionUseCaseError("DOCUMENT_TRANSACTION_INCONSISTENT", "Recovery classifier requested completion without temporary evidence.");
+            }
+            return completePublishedTransaction(dependencies, request, active, observed.temporary);
+        case "finalize-checks": {
+            assertNonzeroDocumentPhysicalIdentity(active.envelope.state === "PUBLISHED"
+                ? active.envelope.journal.publicationIdentity : undefined);
+            const finalized = await finalizeDocumentTransaction(dependencies, { consumerRoot: request.consumerRoot }, active, "applied");
+            return finalized ?? recoveryReceipt(active.envelope.journal.plan, {
+                message: "Recovered publication failed stable final verification.",
+                publication: "published",
+                ruleId: "document.transaction.final-verification"
+            });
+        }
+        case "already-applied": {
+            const finalized = await finalizeDocumentTransaction(dependencies, request, active, "already-applied");
+            return finalized ?? recoveryReceipt(active.envelope.journal.plan, {
+                message: "Preexisting exact output failed stable final verification.",
+                publication: "none",
+                ruleId: "document.transaction.final-verification"
+            });
+        }
+    }
+}
+async function runRecovery(dependencies, request) {
+    const active = await readActiveJournal(dependencies);
+    const plan = active.envelope.journal.plan;
+    const observed = await observe(dependencies, request, active);
+    // Read-only adapters may observe cancellation and still return a value.
+    // Recheck before interpreting evidence or entering any recovery mutation.
+    request.signal?.throwIfAborted();
+    const decision = classifyDocumentRecovery(observed.observation);
+    if (decision.action === "manual") {
+        return recoveryReceipt(plan, {
+            manual: true,
+            message: `Automatic recovery is unsafe: ${decision.reason}.`,
+            publication: active.envelope.state === "PUBLISHED" ? "published" : "unknown",
+            ruleId: `document.transaction.${decision.reason}`
+        });
+    }
+    const authority = await dependencies.authority.assess({
+        consumerRoot: request.consumerRoot,
+        plan,
+        ...signalOption(request.signal)
+    });
+    // Authority replay may likewise translate adapter failures into an
+    // assessment. Cancellation remains the caller's exact error at this safe,
+    // pre-mutation boundary while all durable evidence stays preserved.
+    request.signal?.throwIfAborted();
+    if (authority.state !== "current") {
+        return recoveryReceipt(plan, {
+            message: authority.reason,
+            publication: active.envelope.state === "PUBLISHED" ? "published" : "unknown",
+            ruleId: "document.transaction.recovery-authority"
+        });
+    }
+    return executeRecoveryDecision(dependencies, request, active, observed, decision.action);
+}
+async function executeRecovery(dependencies, request) {
+    try {
+        const value = await runRecovery(dependencies, request);
+        return {
+            retainTransactionBarrier: value.outcome !== "applied" &&
+                value.outcome !== "already-applied",
+            value
+        };
+    }
+    catch (error) {
+        const failure = isCancellation(error, request.signal)
+            ? error : transactionFailure(error);
+        throw failure;
+    }
+}
+/** Recovers only a current, strictly validated v3/v2 transaction. */
+export async function recoverDocumentTransaction(dependencies, request) {
+    const lease = await dependencies.coordinator.acquire({ mode: "recover" });
+    return executeWithDocumentTransactionLease(lease, async () => {
+        if (lease.status.state !== "recoverable") {
+            throw new DocumentTransactionUseCaseError("DOCUMENT_TRANSACTION_COORDINATION_FAILED", "Document recovery requires a coordinator-qualified recoverable transaction.");
+        }
+        return executeRecovery(dependencies, request);
+    }, "Document recovery and transaction lease release both failed.");
+}
+//# sourceMappingURL=recover-document-transaction.js.map

package/dist/document-authoring/application/use-cases/recover-document-transaction.js.map

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

package/dist/document-authoring/application/use-cases/run-document-doctor.d.ts

@@ -0,0 +1,18 @@
+import type { DocumentCommandExecution, DocumentDoctorResult } from "../model/document-command.js";
+import type { DocumentTransactionInspectionV1 } from "../model/document-transaction-inspection.js";
+import type { DocumentEnvironmentInspector } from "../ports/document-environment-inspector.js";
+export interface RunDocumentDoctorRequest {
+    readonly consumerRoot: string;
+    readonly signal?: AbortSignal;
+}
+interface Dependencies {
+    readonly environment: DocumentEnvironmentInspector;
+    inspect(consumerRoot: string): Promise<DocumentTransactionInspectionV1>;
+}
+export declare class RunDocumentDoctor {
+    #private;
+    constructor(dependencies: Dependencies);
+    execute(request: RunDocumentDoctorRequest): Promise<DocumentCommandExecution<DocumentDoctorResult>>;
+}
+export {};
+//# sourceMappingURL=run-document-doctor.d.ts.map

package/dist/document-authoring/application/use-cases/run-document-doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-document-doctor.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/use-cases/run-document-doctor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,6CAA6C,CAAC;AACnG,OAAO,KAAK,EAEV,4BAA4B,EAC7B,MAAM,4CAA4C,CAAC;AAOpD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,UAAU,YAAY;IACpB,QAAQ,CAAC,WAAW,EAAE,4BAA4B,CAAC;IACnD,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAAC;CACzE;AAmFD,qBAAa,iBAAiB;;IAG5B,YAAY,YAAY,EAAE,YAAY,EAErC;IAEK,OAAO,CACX,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,wBAAwB,CAAC,oBAAoB,CAAC,CAAC,CAuGzD;CACF"}