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

package/dist/document-authoring/adapters/node/node-document-structure-verifier.js

@@ -0,0 +1,80 @@
+import { selectDocumentArtifact } from "../../application/policies/resolve-document-authoring.js";
+function diagnostic(ruleId, subject, message) {
+    return Object.freeze({ ruleId, subject, message });
+}
+function sameEvidence(observed, planned) {
+    return observed.path === planned.path &&
+        observed.digest === planned.digest &&
+        observed.size === planned.size;
+}
+function authorityDiagnostics(catalog, plan) {
+    const diagnostics = [];
+    if (!sameEvidence(catalog.authority.profile, plan.authority.profile)) {
+        diagnostics.push(diagnostic("document.new.profile-authority-mismatch", plan.authority.profile.path, "The catalog profile authority does not match the applied plan."));
+    }
+    if (!sameEvidence(catalog.authority.metadataSchema, plan.authority.metadataSchema)) {
+        diagnostics.push(diagnostic("document.new.metadata-authority-mismatch", plan.authority.metadataSchema.path, "The catalog metadata authority does not match the applied plan."));
+    }
+    if (!sameEvidence(catalog.authority.ownerCatalog, plan.authority.ownerCatalog)) {
+        diagnostics.push(diagnostic("document.new.owner-authority-mismatch", plan.authority.ownerCatalog.path, "The catalog owner authority does not match the applied plan."));
+    }
+    if (catalog.projectId !== plan.projectId) {
+        diagnostics.push(diagnostic("document.new.project-mismatch", plan.destination, "The rebuilt catalog does not identify the planned project."));
+    }
+    return diagnostics;
+}
+function descriptorMatches(descriptor, plan, initialStatus, expectedTitle) {
+    return descriptor.id === plan.intent.id &&
+        descriptor.repositoryPath === plan.destination &&
+        descriptor.type === plan.intent.type &&
+        descriptor.title === expectedTitle &&
+        descriptor.owner === plan.intent.owner &&
+        descriptor.summary === plan.intent.summary &&
+        descriptor.status === initialStatus;
+}
+/** Rebuilds the catalog and proves that the applied document has one exact descriptor. */
+export class NodeDocumentStructureVerifier {
+    #catalog;
+    #profiles;
+    constructor(dependencies) {
+        this.#catalog = dependencies.catalog;
+        this.#profiles = dependencies.profiles;
+    }
+    async verify(input) {
+        const request = {
+            consumerRoot: input.consumerRoot,
+            profilePath: input.plan.authority.profile.path,
+            ...(input.signal === undefined ? {} : { signal: input.signal }),
+        };
+        const [catalog, profile] = await Promise.all([
+            this.#catalog.execute(request),
+            this.#profiles.read({
+                consumerRoot: input.consumerRoot,
+                path: input.plan.authority.profile.path,
+                ...(input.signal === undefined ? {} : { signal: input.signal }),
+            }),
+        ]);
+        const diagnostics = [...authorityDiagnostics(catalog, input.plan)];
+        if (!sameEvidence(profile.evidence, input.plan.authority.profile)) {
+            diagnostics.push(diagnostic("document.new.profile-authority-mismatch", input.plan.authority.profile.path, "The planning profile authority does not match the applied plan."));
+        }
+        if (catalog.status !== "complete") {
+            diagnostics.push(diagnostic("document.new.catalog-partial", input.plan.destination, "The post-apply documentation catalog is partial."));
+        }
+        const artifact = selectDocumentArtifact(profile, input.plan.intent.type);
+        const expectedTitle = artifact.heading.kind === "title"
+            ? input.plan.intent.title
+            : `${input.plan.intent.id}: ${input.plan.intent.title}`;
+        const candidates = catalog.documents.filter((entry) => entry.id === input.plan.intent.id ||
+            entry.repositoryPath === input.plan.destination);
+        if (candidates.length !== 1 ||
+            !descriptorMatches(candidates[0], input.plan, artifact.initialStatus, expectedTitle)) {
+            diagnostics.push(diagnostic("document.new.descriptor-mismatch", input.plan.destination, "The rebuilt catalog does not contain exactly the planned document descriptor."));
+        }
+        return Object.freeze({
+            diagnostics: Object.freeze(diagnostics),
+            valid: diagnostics.length === 0,
+        });
+    }
+}
+//# sourceMappingURL=node-document-structure-verifier.js.map

package/dist/document-authoring/adapters/node/node-document-structure-verifier.js.map

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

package/dist/document-authoring/adapters/node/node-document-template-reader.d.ts

@@ -0,0 +1,10 @@
+import type { DocumentTemplateSnapshot } from "../../application/model/document-planning.js";
+import type { DocumentTemplateReader } from "../../application/ports/document-template-reader.js";
+export declare class NodeDocumentTemplateReader implements DocumentTemplateReader {
+    read(request: {
+        readonly consumerRoot: string;
+        readonly path: string;
+        readonly signal?: AbortSignal;
+    }): Promise<DocumentTemplateSnapshot>;
+}
+//# sourceMappingURL=node-document-template-reader.d.ts.map

package/dist/document-authoring/adapters/node/node-document-template-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-template-reader.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/adapters/node/node-document-template-reader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AAC7F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qDAAqD,CAAC;AAOlG,qBAAa,0BAA2B,YAAW,sBAAsB;IACjE,IAAI,CAAC,OAAO,EAAE;QAClB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;KAC/B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA6BpC;CACF"}

package/dist/document-authoring/adapters/node/node-document-template-reader.js

@@ -0,0 +1,32 @@
+import { assertNotCancelled } from "../../../cancellation.js";
+import { CapabilityInputError } from "../../../capability-runtime.js";
+import { DocumentCatalogError } from "../../document-catalog-error.js";
+import { DocumentPlanningError } from "../../document-planning-error.js";
+import { readDocumentAuthorityFile } from "./read-document-authority-file.js";
+const MAX_TEMPLATE_BYTES = 256 * 1024;
+export class NodeDocumentTemplateReader {
+    async read(request) {
+        assertNotCancelled(request.signal);
+        try {
+            const file = await readDocumentAuthorityFile({
+                consumerRoot: request.consumerRoot,
+                maxBytes: MAX_TEMPLATE_BYTES,
+                path: request.path
+            });
+            assertNotCancelled(request.signal);
+            return Object.freeze({ evidence: file.evidence, source: file.source });
+        }
+        catch (error) {
+            if (error instanceof CapabilityInputError || error instanceof DocumentPlanningError) {
+                throw error;
+            }
+            if (error instanceof DocumentCatalogError) {
+                throw new DocumentPlanningError(error.code === "DOCUMENT_CATALOG_INPUT_INVALID"
+                    ? "DOCUMENT_PLANNING_INPUT_INVALID"
+                    : "DOCUMENT_PLANNING_AUTHORITY_UNAVAILABLE", `Document template is unavailable or invalid: ${request.path}.`, { cause: error });
+            }
+            throw new DocumentPlanningError("DOCUMENT_PLANNING_AUTHORITY_UNAVAILABLE", `Document template is unavailable or invalid: ${request.path}.`, { cause: error });
+        }
+    }
+}
+//# sourceMappingURL=node-document-template-reader.js.map

package/dist/document-authoring/adapters/node/node-document-template-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-template-reader.js","sourceRoot":"","sources":["../../../../src/document-authoring/adapters/node/node-document-template-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAGtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,MAAM,kBAAkB,GAAG,GAAG,GAAG,IAAI,CAAC;AAEtC,MAAM,OAAO,0BAA0B;IACrC,KAAK,CAAC,IAAI,CAAC,OAIV;QACC,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,yBAAyB,CAAC;gBAC3C,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB,CAAC,CAAC;YACH,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACnC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,oBAAoB,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;gBACpF,MAAM,KAAK,CAAC;YACd,CAAC;YACD,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;gBAC1C,MAAM,IAAI,qBAAqB,CAC7B,KAAK,CAAC,IAAI,KAAK,gCAAgC;oBAC7C,CAAC,CAAC,iCAAiC;oBACnC,CAAC,CAAC,yCAAyC,EAC7C,gDAAgD,OAAO,CAAC,IAAI,GAAG,EAC/D,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,qBAAqB,CAC7B,yCAAyC,EACzC,gDAAgD,OAAO,CAAC,IAAI,GAAG,EAC/D,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/document-authoring/adapters/node/node-document-transaction-coordinator.d.ts

@@ -0,0 +1,21 @@
+import type { DocumentTransactionCoordinator, DocumentTransactionLease, DocumentTransactionStatus } from "../../application/ports/document-transaction-coordinator.js";
+import type { FoundationTransactionLease } from "../../../transaction-coordination/application/foundation-transaction-coordinator.js";
+import type { InternalFoundationTransactionStatus } from "../../../transaction-coordination/application/model/internal-transaction-status.js";
+interface FoundationCoordinator {
+    inspect(): Promise<InternalFoundationTransactionStatus>;
+    acquire(options: {
+        readonly requestedMutation: "document-authoring";
+        readonly allowRecoveryOf?: "document-authoring";
+    }): Promise<FoundationTransactionLease>;
+}
+export declare class NodeDocumentTransactionCoordinator implements DocumentTransactionCoordinator {
+    #private;
+    constructor(coordinator: FoundationCoordinator);
+    inspect(): Promise<DocumentTransactionStatus>;
+    acquire(request: {
+        readonly mode: "apply" | "recover";
+    }): Promise<DocumentTransactionLease>;
+}
+export declare function createNodeDocumentTransactionCoordinator(consumerRoot: string): Promise<DocumentTransactionCoordinator>;
+export {};
+//# sourceMappingURL=node-document-transaction-coordinator.d.ts.map

package/dist/document-authoring/adapters/node/node-document-transaction-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-document-transaction-coordinator.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/adapters/node/node-document-transaction-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,6DAA6D,CAAC;AAErE,OAAO,KAAK,EAEV,0BAA0B,EAC3B,MAAM,qFAAqF,CAAC;AAC7F,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,oFAAoF,CAAC;AAE9I,UAAU,qBAAqB;IAC7B,OAAO,IAAI,OAAO,CAAC,mCAAmC,CAAC,CAAC;IACxD,OAAO,CAAC,OAAO,EAAE;QACf,QAAQ,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;QACjD,QAAQ,CAAC,eAAe,CAAC,EAAE,oBAAoB,CAAC;KACjD,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACzC;AAmFD,qBAAa,kCACX,YAAW,8BAA8B;;IAGzC,YAAY,WAAW,EAAE,qBAAqB,EAE7C;IAEK,OAAO,IAAI,OAAO,CAAC,yBAAyB,CAAC,CAElD;IAEK,OAAO,CAAC,OAAO,EAAE;QACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;KACpC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAuBpC;CACF;AAED,wBAAsB,wCAAwC,CAC5D,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,8BAA8B,CAAC,CAIzC"}

package/dist/document-authoring/adapters/node/node-document-transaction-coordinator.js

@@ -0,0 +1,89 @@
+import { createNodeFoundationTransactionCoordinator } from "../../../transaction-coordination/adapters/node/node-foundation-transaction-coordinator.js";
+function observedProperty(value, property) {
+    return Reflect.get(value, property);
+}
+function isExactDocumentRecovery(status) {
+    return (status.state === "pending" &&
+        status.operationKind === "document-authoring" &&
+        observedProperty(status, "format") === "document-authoring-envelope-v3" &&
+        observedProperty(status.recovery, "commandId") === "docs-recover" &&
+        status.recovery.exactFoundationVersion === status.foundationVersion &&
+        status.recovery.exactFoundationBuildIdentity ===
+            status.foundationBuildIdentity &&
+        !status.diagnostics.some(({ code }) => code === "FOUNDATION_TRANSACTION_VERSION_MISMATCH"));
+}
+function manualReason(status) {
+    if (status.state === "manual-recovery-required") {
+        return status.reason;
+    }
+    return (status.diagnostics[0]?.message ??
+        `A ${status.operationKind} Foundation transaction blocks document authoring.`);
+}
+function toDocumentStatus(status) {
+    if (status.state === "idle") {
+        return { state: "idle" };
+    }
+    return isExactDocumentRecovery(status)
+        ? { state: "recoverable" }
+        : { state: "manual-recovery-required", reason: manualReason(status) };
+}
+function combinedReleaseFailure(inspectionError, releaseError) {
+    return new Error("Document transaction inspection and barrier retention both failed.", {
+        cause: new AggregateError([inspectionError, releaseError], "Transaction evidence inspection and operation-lock release failed.")
+    });
+}
+async function releaseSafely(options) {
+    let status;
+    try {
+        status = await options.coordinator.inspect();
+    }
+    catch (inspectionError) {
+        try {
+            await options.lease.release({ retainTransactionBarrier: true });
+        }
+        catch (releaseError) {
+            throw combinedReleaseFailure(inspectionError, releaseError);
+        }
+        throw inspectionError;
+    }
+    await options.lease.release({
+        retainTransactionBarrier: options.retainRequested || status.state !== "idle"
+    });
+}
+export class NodeDocumentTransactionCoordinator {
+    #coordinator;
+    constructor(coordinator) {
+        this.#coordinator = coordinator;
+    }
+    async inspect() {
+        return toDocumentStatus(await this.#coordinator.inspect());
+    }
+    async acquire(request) {
+        const lease = await this.#coordinator.acquire({
+            requestedMutation: "document-authoring",
+            ...(request.mode === "recover"
+                ? { allowRecoveryOf: "document-authoring" }
+                : {})
+        });
+        let held = true;
+        return {
+            status: toDocumentStatus(lease.status),
+            release: async (releaseOptions) => {
+                if (!held) {
+                    return;
+                }
+                await releaseSafely({
+                    coordinator: this.#coordinator,
+                    lease,
+                    retainRequested: releaseOptions?.retainTransactionBarrier === true
+                });
+                held = false;
+            }
+        };
+    }
+}
+export async function createNodeDocumentTransactionCoordinator(consumerRoot) {
+    const coordinator = await createNodeFoundationTransactionCoordinator(consumerRoot);
+    return new NodeDocumentTransactionCoordinator(coordinator);
+}
+//# sourceMappingURL=node-document-transaction-coordinator.js.map

package/dist/document-authoring/adapters/node/node-document-transaction-coordinator.js.map

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

package/dist/document-authoring/adapters/node/recapture-document-publication-paths.d.ts

@@ -0,0 +1,16 @@
+import type { PortablePathIdentity } from "../../../repository-mutation/application/model/path-identity.js";
+export interface RecapturedDocumentPublicationPaths {
+    readonly ancestryIdentities: readonly PortablePathIdentity[];
+    readonly destinationPath: string;
+    readonly parent: string;
+    readonly parentIdentity: PortablePathIdentity;
+    readonly root: string;
+}
+/** Recaptures strict real-directory ancestry; the result is valid only for the immediate operation. */
+export declare function recaptureDocumentPublicationPaths(request: {
+    readonly consumerRoot: string;
+    readonly destination: string;
+}): Promise<RecapturedDocumentPublicationPaths>;
+export declare function sameDocumentPhysicalIdentity(left: PortablePathIdentity, right: PortablePathIdentity): boolean;
+export declare function sameDocumentAncestry(left: readonly PortablePathIdentity[], right: readonly PortablePathIdentity[]): boolean;
+//# sourceMappingURL=recapture-document-publication-paths.d.ts.map

package/dist/document-authoring/adapters/node/recapture-document-publication-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recapture-document-publication-paths.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/adapters/node/recapture-document-publication-paths.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iEAAiE,CAAC;AAI5G,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,kBAAkB,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC7D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAgDD,uGAAuG;AACvG,wBAAsB,iCAAiC,CAAC,OAAO,EAAE;IAC/D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,GAAG,OAAO,CAAC,kCAAkC,CAAC,CA0C9C;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAIT;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,oBAAoB,EAAE,EACrC,KAAK,EAAE,SAAS,oBAAoB,EAAE,GACrC,OAAO,CAIT"}

package/dist/document-authoring/adapters/node/recapture-document-publication-paths.js

@@ -0,0 +1,89 @@
+import { lstat, readdir, realpath } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve, sep } from "node:path";
+import { OWNED_TEMPORARY_CLEANUP_RESIDUE_MARKER } from "../../../repository-mutation/adapters/node/node-cleanup-owned-temporary.js";
+import { isDocumentRepositoryPath } from "../../application/policies/document-repository-path.js";
+function contained(root, candidate) {
+    const relation = relative(root, candidate);
+    return relation === "" ||
+        (!isAbsolute(relation) && relation !== ".." && !relation.startsWith(`..${sep}`));
+}
+function portableNameIdentity(name) {
+    return name.normalize("NFC").replace(/[A-Z]/gu, (character) => character.toLowerCase());
+}
+async function assertNoPortableAlias(parent, segment) {
+    const identity = portableNameIdentity(segment);
+    const entries = await readdir(parent);
+    if (entries.some((entry) => entry !== segment && portableNameIdentity(entry) === identity)) {
+        throw new Error(`Document publication ancestry has a portable name alias: ${segment}.`);
+    }
+}
+async function assertNoOwnedCleanupResidue(parent) {
+    const entries = await readdir(parent);
+    if (entries.some((entry) => entry.includes(OWNED_TEMPORARY_CLEANUP_RESIDUE_MARKER))) {
+        throw new Error("A document temporary cleanup residue was preserved for manual recovery.");
+    }
+}
+function pathIdentity(metadata) {
+    const identity = {
+        birthtimeNs: metadata.birthtimeNs,
+        dev: metadata.dev,
+        ino: metadata.ino
+    };
+    if (identity.dev === 0n || identity.ino === 0n || identity.birthtimeNs === 0n) {
+        throw new Error("Document publication ancestry has zero physical identity.");
+    }
+    return identity;
+}
+/** Recaptures strict real-directory ancestry; the result is valid only for the immediate operation. */
+export async function recaptureDocumentPublicationPaths(request) {
+    if (!isDocumentRepositoryPath(request.destination)) {
+        throw new Error("Document publication destination is not a portable repository path.");
+    }
+    const lexicalRoot = resolve(request.consumerRoot);
+    const rootMetadata = await lstat(lexicalRoot, { bigint: true });
+    if (rootMetadata.isSymbolicLink() || !rootMetadata.isDirectory()) {
+        throw new Error("Document publication root must be a real directory.");
+    }
+    const root = await realpath(lexicalRoot);
+    let parent = root;
+    const ancestryIdentities = [pathIdentity(rootMetadata)];
+    for (const segment of request.destination.split("/").slice(0, -1)) {
+        await assertNoOwnedCleanupResidue(parent);
+        await assertNoPortableAlias(parent, segment);
+        const candidate = join(parent, segment);
+        const metadata = await lstat(candidate, { bigint: true });
+        if (metadata.isSymbolicLink() || !metadata.isDirectory()) {
+            throw new Error(`Document publication ancestry is not a real directory: ${segment}.`);
+        }
+        const canonical = await realpath(candidate);
+        if (resolve(canonical) !== resolve(candidate) || !contained(root, canonical)) {
+            throw new Error("Document publication ancestry is redirected or escapes the repository.");
+        }
+        ancestryIdentities.push(pathIdentity(metadata));
+        parent = canonical;
+    }
+    const parentMetadata = await lstat(parent, { bigint: true });
+    if (parentMetadata.isSymbolicLink() || !parentMetadata.isDirectory()) {
+        throw new Error("Document publication parent changed during recapture.");
+    }
+    const basename = request.destination.split("/").at(-1);
+    await assertNoOwnedCleanupResidue(parent);
+    await assertNoPortableAlias(parent, basename);
+    return Object.freeze({
+        ancestryIdentities: Object.freeze(ancestryIdentities),
+        destinationPath: join(parent, basename),
+        parent,
+        parentIdentity: pathIdentity(parentMetadata),
+        root
+    });
+}
+export function sameDocumentPhysicalIdentity(left, right) {
+    return left.dev === right.dev &&
+        left.ino === right.ino &&
+        left.birthtimeNs === right.birthtimeNs;
+}
+export function sameDocumentAncestry(left, right) {
+    return left.length === right.length &&
+        left.every((identity, index) => sameDocumentPhysicalIdentity(identity, right[index]));
+}
+//# sourceMappingURL=recapture-document-publication-paths.js.map

package/dist/document-authoring/adapters/node/recapture-document-publication-paths.js.map

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

package/dist/document-authoring/application/model/document-command.d.ts

@@ -0,0 +1,69 @@
+import type { DocumentReceiptOutcome } from "./document-receipt.js";
+export type DocumentCommandId = "docs.doctor" | "docs.new" | "docs.recover";
+export type DocumentCommandOutcome = "authority-stale" | "cancelled" | "conflict" | "execution-failure" | "invalid-input" | "recovery-required" | "success" | "violation";
+type DocumentCommandExitCode = 0 | 1 | 2 | 3 | 130;
+export interface DocumentRecoveryCommand {
+    readonly commandId: "detach" | "docs.recover" | "scaffold-recover";
+    readonly args: Readonly<Record<string, string>>;
+}
+export type DocumentCommandRemediation = DocumentRecoveryCommand | {
+    readonly commandId: DocumentCommandId | "docs.find";
+    readonly args: Readonly<Record<string, string>>;
+};
+export interface DocumentCommandDiagnostic {
+    readonly ruleId: string;
+    readonly severity: "error" | "info" | "warning";
+    readonly phase: "apply" | "authority" | "input" | "planning" | "recovery";
+    readonly subject: string;
+    readonly message: string;
+    readonly remediation?: DocumentCommandRemediation;
+}
+interface DocumentCommandEnvelope<Result> {
+    readonly schemaVersion: 2;
+    readonly command: DocumentCommandId;
+    readonly outcome: DocumentCommandOutcome;
+    readonly diagnostics: readonly DocumentCommandDiagnostic[];
+    readonly result: Result;
+}
+export interface DocumentCommandExecution<Result> {
+    readonly envelope: DocumentCommandEnvelope<Result>;
+    readonly exitCode: DocumentCommandExitCode;
+}
+export interface DocumentReachabilityProjection {
+    readonly state: "managed" | "manual-required" | "not-required";
+    readonly indexPath?: string;
+    readonly markdownLink?: string;
+}
+export interface DocumentNewResult {
+    readonly kind: "new";
+    readonly documentPath?: string;
+    readonly writeState?: "already-applied" | "applied" | "preview";
+    readonly reservation: "none";
+    readonly receiptOutcome?: DocumentReceiptOutcome;
+    readonly reachability?: DocumentReachabilityProjection;
+}
+export interface DocumentDoctorResult {
+    readonly kind: "doctor";
+    readonly installedFoundationVersion?: string;
+    readonly installedFoundationBuildIdentity?: string;
+    readonly filesystem?: {
+        readonly basis: "platform-contract";
+        readonly strictDirectoryDurability: "platform-supported" | "platform-unsupported";
+    };
+    readonly transactionState: "corrupt" | "document" | "local-mode" | "none" | "scaffold" | "transition-residue" | "unknown" | "version-mismatch";
+    readonly protocolKind?: "document-authoring" | "local-mode" | "scaffolding" | "unknown";
+    readonly foundationVersion?: string;
+    readonly foundationBuildIdentity?: string;
+    readonly recoveryClass: "auto-recoverable" | "manual" | "not-required";
+    readonly recoveryCommand?: DocumentRecoveryCommand;
+}
+export interface DocumentRecoverResult {
+    readonly kind: "recover";
+    readonly transactionState: "already-applied" | "manual-required" | "no-pending-transaction" | "recovered" | "recovery-required" | "cancelled" | "failed";
+    readonly writeState: "already-committed" | "committed" | "unchanged" | "unknown";
+    readonly recoveryRequired: boolean;
+    readonly receiptDigest?: string;
+    readonly recoveryCommand?: DocumentRecoveryCommand;
+}
+export {};
+//# sourceMappingURL=document-command.d.ts.map

package/dist/document-authoring/application/model/document-command.d.ts.map

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

package/dist/document-authoring/application/model/document-command.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=document-command.js.map

package/dist/document-authoring/application/model/document-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-command.js","sourceRoot":"","sources":["../../../../src/document-authoring/application/model/document-command.ts"],"names":[],"mappings":""}

package/dist/document-authoring/application/model/document-physical-identity.d.ts

@@ -0,0 +1,10 @@
+export interface DocumentPhysicalIdentity {
+    readonly adapter: "node-filesystem";
+    readonly version: 1;
+    readonly dev: string;
+    readonly ino: string;
+    readonly birthtimeNs: string;
+}
+export declare function assertDocumentPhysicalIdentity(value: unknown): asserts value is DocumentPhysicalIdentity;
+export declare function assertNonzeroDocumentPhysicalIdentity(value: unknown): asserts value is DocumentPhysicalIdentity;
+//# sourceMappingURL=document-physical-identity.d.ts.map

package/dist/document-authoring/application/model/document-physical-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-physical-identity.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/model/document-physical-identity.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAID,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,KAAK,IAAI,wBAAwB,CAsB3C;AAED,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,KAAK,IAAI,wBAAwB,CAW3C"}

package/dist/document-authoring/application/model/document-physical-identity.js

@@ -0,0 +1,29 @@
+const DECIMAL_IDENTITY_COMPONENT = /^(?:0|[1-9][0-9]{0,31})$/u;
+export function assertDocumentPhysicalIdentity(value) {
+    if (typeof value !== "object" ||
+        value === null ||
+        Array.isArray(value)) {
+        throw new Error("Document physical identity is not an object.");
+    }
+    const candidate = value;
+    if (Reflect.ownKeys(candidate).length !== 5 ||
+        candidate.adapter !== "node-filesystem" ||
+        candidate.version !== 1 ||
+        ![
+            candidate.dev,
+            candidate.ino,
+            candidate.birthtimeNs
+        ].every((part) => typeof part === "string" &&
+            DECIMAL_IDENTITY_COMPONENT.test(part))) {
+        throw new Error("Document physical identity wire evidence is invalid.");
+    }
+}
+export function assertNonzeroDocumentPhysicalIdentity(value) {
+    assertDocumentPhysicalIdentity(value);
+    if (value.dev === "0" ||
+        value.ino === "0" ||
+        value.birthtimeNs === "0") {
+        throw new Error("Document physical identity contains zero and grants no mutation authority.");
+    }
+}
+//# sourceMappingURL=document-physical-identity.js.map

package/dist/document-authoring/application/model/document-physical-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-physical-identity.js","sourceRoot":"","sources":["../../../../src/document-authoring/application/model/document-physical-identity.ts"],"names":[],"mappings":"AAQA,MAAM,0BAA0B,GAAG,2BAA2B,CAAC;AAE/D,MAAM,UAAU,8BAA8B,CAC5C,KAAc;IAEd,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EACpB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,SAAS,GAAG,KAAgC,CAAC;IACnD,IACE,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC;QACvC,SAAS,CAAC,OAAO,KAAK,iBAAiB;QACvC,SAAS,CAAC,OAAO,KAAK,CAAC;QACvB,CAAC;YACC,SAAS,CAAC,GAAG;YACb,SAAS,CAAC,GAAG;YACb,SAAS,CAAC,WAAW;SACtB,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ;YACxC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EACxC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,KAAc;IAEd,8BAA8B,CAAC,KAAK,CAAC,CAAC;IACtC,IACE,KAAK,CAAC,GAAG,KAAK,GAAG;QACjB,KAAK,CAAC,GAAG,KAAK,GAAG;QACjB,KAAK,CAAC,WAAW,KAAK,GAAG,EACzB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;IACJ,CAAC;AACH,CAAC"}