@agent-teams/engineering-foundation 0.16.1 → 0.17.0-rc.0

package/dist/document-authoring/adapters/node/node-path-authority.js

@@ -0,0 +1,186 @@
+import { lstat, readdir, realpath } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve, sep } from "node:path";
+import { portableRepositoryPathIdentity } from "../../../repository-mutation/application/model/repository-path.js";
+import { isDocumentRepositoryPath } from "../../application/policies/document-repository-path.js";
+const nodeOperations = {
+    lstat: (path) => lstat(path, { bigint: true }),
+    readdir,
+    realpath
+};
+// Threat contract: portable Node does not expose mkdirat/linkat/openat2
+// confinement through a held directory descriptor. These adapters therefore
+// protect cooperative Foundation writers and fail closed on observable moves,
+// replacements, and symlink swaps. A malicious same-OS-user process can still
+// win an unobservable gap between a proof and a pathname syscall (including
+// mkdir -> first lstat, open, and link), and may cause an out-of-root side
+// effect before the post-operation proof rejects the result. Such hostile
+// syscall racing is outside the portable adapter guarantee. Callers must
+// recapture before and after every sensitive operation and must never claim
+// ownership, journal evidence, or report publication when either proof differs.
+function identity(metadata) {
+    const value = {
+        birthtimeNs: metadata.birthtimeNs,
+        dev: metadata.dev,
+        ino: metadata.ino
+    };
+    if (value.birthtimeNs === 0n || value.dev === 0n || value.ino === 0n) {
+        throw new Error("Repository path authority has zero physical identity.");
+    }
+    return value;
+}
+export function sameNodePathIdentity(left, right) {
+    return left.birthtimeNs === right.birthtimeNs &&
+        left.dev === right.dev &&
+        left.ino === right.ino;
+}
+function contained(root, candidate) {
+    const relation = relative(root, candidate);
+    return relation === "" ||
+        (!isAbsolute(relation) && relation !== ".." && !relation.startsWith(`..${sep}`));
+}
+function assertRealDirectory(metadata, description) {
+    if (metadata.isSymbolicLink() || !metadata.isDirectory()) {
+        throw new Error(`${description} must be a real directory.`);
+    }
+}
+async function assertNoPortableAlias(parent, segment, operations) {
+    const expected = portableRepositoryPathIdentity(segment);
+    const entries = await operations.readdir(parent);
+    if (entries.some((entry) => entry !== segment && portableRepositoryPathIdentity(entry) === expected)) {
+        throw new Error(`Repository ancestry has a portable name collision: ${segment}.`);
+    }
+}
+export async function captureNodeRepositoryRootAuthority(consumerRoot, operations = nodeOperations) {
+    const lexicalRoot = resolve(consumerRoot);
+    const before = await operations.lstat(lexicalRoot);
+    assertRealDirectory(before, "Repository root");
+    const beforeIdentity = identity(before);
+    const canonicalRoot = await operations.realpath(lexicalRoot);
+    const [lexicalAfter, canonicalAfter] = await Promise.all([
+        operations.lstat(lexicalRoot),
+        operations.lstat(canonicalRoot)
+    ]);
+    assertRealDirectory(lexicalAfter, "Repository root");
+    assertRealDirectory(canonicalAfter, "Canonical repository root");
+    const lexicalAfterIdentity = identity(lexicalAfter);
+    const canonicalAfterIdentity = identity(canonicalAfter);
+    if (!sameNodePathIdentity(beforeIdentity, lexicalAfterIdentity) ||
+        !sameNodePathIdentity(lexicalAfterIdentity, canonicalAfterIdentity)) {
+        throw new Error("Repository root identity changed while it was captured.");
+    }
+    return Object.freeze({
+        canonicalRoot,
+        identity: canonicalAfterIdentity,
+        lexicalRoot
+    });
+}
+async function captureChildDirectory(root, parent, repositoryPath, segment, operations) {
+    await assertNoPortableAlias(parent, segment, operations);
+    const absolutePath = join(parent, segment);
+    const before = await operations.lstat(absolutePath);
+    assertRealDirectory(before, `Repository ancestry ${repositoryPath}`);
+    const beforeIdentity = identity(before);
+    const canonical = await operations.realpath(absolutePath);
+    if (resolve(canonical) !== resolve(absolutePath) ||
+        !contained(root.canonicalRoot, canonical)) {
+        throw new Error("Repository ancestry is redirected or escapes the repository.");
+    }
+    const after = await operations.lstat(absolutePath);
+    assertRealDirectory(after, `Repository ancestry ${repositoryPath}`);
+    const afterIdentity = identity(after);
+    if (!sameNodePathIdentity(beforeIdentity, afterIdentity)) {
+        throw new Error(`Repository ancestry identity changed: ${repositoryPath}.`);
+    }
+    return Object.freeze({
+        absolutePath: canonical,
+        identity: afterIdentity,
+        repositoryPath
+    });
+}
+export async function captureNodeRepositoryDirectoryAuthority(request) {
+    const operations = request.operations ?? nodeOperations;
+    if (request.repositoryPath !== "." &&
+        !isDocumentRepositoryPath(request.repositoryPath)) {
+        throw new Error("Repository directory is not a portable repository path.");
+    }
+    const root = await captureNodeRepositoryRootAuthority(request.consumerRoot, operations);
+    const ancestry = [{
+            absolutePath: root.canonicalRoot,
+            identity: root.identity,
+            repositoryPath: "."
+        }];
+    let parent = root.canonicalRoot;
+    const traversed = [];
+    if (request.repositoryPath !== ".") {
+        for (const segment of request.repositoryPath.split("/")) {
+            traversed.push(segment);
+            const captured = await captureChildDirectory(root, parent, traversed.join("/"), segment, operations);
+            ancestry.push(captured);
+            parent = captured.absolutePath;
+        }
+    }
+    const rootAfter = await captureNodeRepositoryRootAuthority(request.consumerRoot, operations);
+    if (!sameRootAuthority(root, rootAfter)) {
+        throw new Error("Repository root changed while ancestry was captured.");
+    }
+    const leaf = ancestry.at(-1);
+    return Object.freeze({
+        ancestry: Object.freeze(ancestry),
+        directory: leaf.absolutePath,
+        directoryIdentity: leaf.identity,
+        repositoryPath: request.repositoryPath,
+        root
+    });
+}
+export async function captureNodeRepositoryPathAuthority(request) {
+    if (!isDocumentRepositoryPath(request.repositoryPath)) {
+        throw new Error("Repository destination is not a portable repository path.");
+    }
+    const segments = request.repositoryPath.split("/");
+    const basename = segments.at(-1);
+    const parentRepositoryPath = segments.length === 1
+        ? "."
+        : segments.slice(0, -1).join("/");
+    const directory = await captureNodeRepositoryDirectoryAuthority({
+        consumerRoot: request.consumerRoot,
+        ...(request.operations === undefined ? {} : { operations: request.operations }),
+        repositoryPath: parentRepositoryPath
+    });
+    await assertNoPortableAlias(directory.directory, basename, request.operations ?? nodeOperations);
+    return Object.freeze({
+        ancestry: directory.ancestry,
+        destinationPath: join(directory.directory, basename),
+        parent: directory.directory,
+        parentIdentity: directory.directoryIdentity,
+        repositoryPath: request.repositoryPath,
+        root: directory.root
+    });
+}
+function sameRootAuthority(left, right) {
+    return left.canonicalRoot === right.canonicalRoot &&
+        left.lexicalRoot === right.lexicalRoot &&
+        sameNodePathIdentity(left.identity, right.identity);
+}
+export function sameNodePathAncestry(left, right) {
+    return left.length === right.length && left.every((entry, index) => {
+        const other = right[index];
+        return other !== undefined &&
+            entry.absolutePath === other.absolutePath &&
+            entry.repositoryPath === other.repositoryPath &&
+            sameNodePathIdentity(entry.identity, other.identity);
+    });
+}
+export async function recaptureNodeRepositoryPathAuthority(authority, operations = nodeOperations) {
+    const recaptured = await captureNodeRepositoryPathAuthority({
+        consumerRoot: authority.root.lexicalRoot,
+        operations,
+        repositoryPath: authority.repositoryPath
+    });
+    if (!sameRootAuthority(authority.root, recaptured.root) ||
+        !sameNodePathAncestry(authority.ancestry, recaptured.ancestry) ||
+        authority.destinationPath !== recaptured.destinationPath) {
+        throw new Error("Repository path authority changed during the operation.");
+    }
+    return recaptured;
+}
+//# sourceMappingURL=node-path-authority.js.map

package/dist/document-authoring/adapters/node/node-path-authority.js.map

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

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

@@ -1,4 +1,5 @@
 import type { PortablePathIdentity } from "../../../repository-mutation/application/model/path-identity.js";
+import { sameNodePathIdentity } from "./node-path-authority.js";
 export interface RecapturedDocumentPublicationPaths {
     readonly ancestryIdentities: readonly PortablePathIdentity[];
     readonly destinationPath: string;
@@ -11,6 +12,6 @@ export declare function recaptureDocumentPublicationPaths(request: {
     readonly consumerRoot: string;
     readonly destination: string;
 }): Promise<RecapturedDocumentPublicationPaths>;
-export declare function sameDocumentPhysicalIdentity(left: PortablePathIdentity, right: PortablePathIdentity): boolean;
+export declare const sameDocumentPhysicalIdentity: typeof sameNodePathIdentity;
 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

@@ -1 +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"}
+{"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;AAC5G,OAAO,EAGL,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAElC,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;AAgBD,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,CAkB9C;AAED,eAAO,MAAM,4BAA4B,6BAAuB,CAAC;AAEjE,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

@@ -1,89 +1,33 @@
-import { lstat, readdir, realpath } from "node:fs/promises";
-import { isAbsolute, join, relative, resolve, sep } from "node:path";
+import { readdir } from "node:fs/promises";
 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.");
+import { captureNodeRepositoryPathAuthority, recaptureNodeRepositoryPathAuthority, sameNodePathIdentity } from "./node-path-authority.js";
+async function assertNoOwnedCleanupResidue(directories) {
+    for (const directory of directories) {
+        const entries = await readdir(directory);
+        if (entries.some((entry) => entry.includes(OWNED_TEMPORARY_CLEANUP_RESIDUE_MARKER))) {
+            throw new Error("A document temporary cleanup residue was preserved for manual recovery.");
+        }
     }
-    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);
+    const authority = await captureNodeRepositoryPathAuthority({
+        consumerRoot: request.consumerRoot,
+        repositoryPath: request.destination
+    });
+    await assertNoOwnedCleanupResidue(authority.ancestry.map((entry) => entry.absolutePath));
+    const recaptured = await recaptureNodeRepositoryPathAuthority(authority);
     return Object.freeze({
-        ancestryIdentities: Object.freeze(ancestryIdentities),
-        destinationPath: join(parent, basename),
-        parent,
-        parentIdentity: pathIdentity(parentMetadata),
-        root
+        ancestryIdentities: Object.freeze(recaptured.ancestry.map((entry) => entry.identity)),
+        destinationPath: recaptured.destinationPath,
+        parent: recaptured.parent,
+        parentIdentity: recaptured.parentIdentity,
+        root: recaptured.root.canonicalRoot
     });
 }
-export function sameDocumentPhysicalIdentity(left, right) {
-    return left.dev === right.dev &&
-        left.ino === right.ino &&
-        left.birthtimeNs === right.birthtimeNs;
-}
+export const sameDocumentPhysicalIdentity = sameNodePathIdentity;
 export function sameDocumentAncestry(left, right) {
     return left.length === right.length &&
-        left.every((identity, index) => sameDocumentPhysicalIdentity(identity, right[index]));
+        left.every((identity, index) => sameNodePathIdentity(identity, right[index]));
 }
 //# sourceMappingURL=recapture-document-publication-paths.js.map

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

@@ -1 +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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"}
+{"version":3,"file":"recapture-document-publication-paths.js","sourceRoot":"","sources":["../../../../src/document-authoring/adapters/node/recapture-document-publication-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,OAAO,EAAE,sCAAsC,EAAE,MAAM,4EAA4E,CAAC;AAEpI,OAAO,EACL,kCAAkC,EAClC,oCAAoC,EACpC,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAUlC,KAAK,UAAU,2BAA2B,CACxC,WAA8B;IAE9B,KAAK,MAAM,SAAS,IAAI,WAAW,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CACzB,KAAK,CAAC,QAAQ,CAAC,sCAAsC,CAAC,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CACb,yEAAyE,CAC1E,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,uGAAuG;AACvG,MAAM,CAAC,KAAK,UAAU,iCAAiC,CAAC,OAGvD;IACC,MAAM,SAAS,GAAG,MAAM,kCAAkC,CAAC;QACzD,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,cAAc,EAAE,OAAO,CAAC,WAAW;KACpC,CAAC,CAAC;IACH,MAAM,2BAA2B,CAC/B,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CACtD,CAAC;IACF,MAAM,UAAU,GAAG,MAAM,oCAAoC,CAAC,SAAS,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAC/B,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CACnD;QACD,eAAe,EAAE,UAAU,CAAC,eAAe;QAC3C,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,cAAc,EAAE,UAAU,CAAC,cAAc;QACzC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,aAAa;KACpC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,4BAA4B,GAAG,oBAAoB,CAAC;AAEjE,MAAM,UAAU,oBAAoB,CAClC,IAAqC,EACrC,KAAsC;IAEtC,OAAO,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;QACjC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAC7B,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAE,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/dist/document-authoring/application/model/document-authoring-profile-description.d.ts

@@ -0,0 +1,53 @@
+import type { DocumentAuthorityDigest, DocumentAuthorityEvidence } from "./document-catalog.js";
+import type { DocumentCatalogCollection, DocumentIdentityStrategy, DocumentPlacementStrategy, DocumentReachabilityStrategy } from "./document-planning.js";
+export type DocumentReachabilityStrategyV2 = Exclude<DocumentReachabilityStrategy, {
+    readonly kind: "not-required";
+}> | {
+    readonly kind: "not-required";
+    readonly reason: string;
+};
+export interface DocumentAuthoringTypeDescriptionV2 {
+    readonly allowedOwnerIds: readonly string[];
+    readonly heading: {
+        readonly kind: "id-colon-title" | "title";
+    };
+    readonly identity: DocumentIdentityStrategy;
+    readonly initialStatus: string;
+    readonly placement: DocumentPlacementStrategy;
+    readonly reachability: DocumentReachabilityStrategyV2;
+    readonly requiredMetadata: readonly string[];
+    readonly template: {
+        readonly kind: "fenced-markdown-body";
+        readonly path: string;
+    };
+    readonly type: string;
+}
+export interface DocumentAuthoringProfileDescriptionV2 {
+    readonly authority: {
+        readonly metadataSchema: DocumentAuthorityEvidence;
+        readonly metadataSidecar?: DocumentAuthorityEvidence;
+        readonly ownerCatalog: DocumentAuthorityEvidence;
+        readonly profile: DocumentAuthorityEvidence;
+        readonly templates: readonly {
+            readonly evidence: DocumentAuthorityEvidence;
+            readonly type: string;
+        }[];
+    };
+    readonly authorityPaths: {
+        readonly metadataSchema: string;
+        readonly metadataSidecar?: string;
+        readonly ownerCatalog: string;
+        readonly profile: string;
+    };
+    readonly catalog: {
+        readonly collections: readonly DocumentCatalogCollection[];
+        readonly excludedPrefixes: readonly string[];
+    };
+    readonly ownerIds: readonly string[];
+    readonly projectId: string;
+    readonly profileSchemaVersion: 2;
+    readonly schemaVersion: 2;
+    readonly semanticDigest: DocumentAuthorityDigest;
+    readonly types: readonly DocumentAuthoringTypeDescriptionV2[];
+}
+//# sourceMappingURL=document-authoring-profile-description.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-authoring-profile-description.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/model/document-authoring-profile-description.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,4BAA4B,EAC7B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,8BAA8B,GACtC,OAAO,CAAC,4BAA4B,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC,GACxE;IACE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEN,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAA;KAAE,CAAC;IAChE,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,8BAA8B,CAAC;IACtD,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;QACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,SAAS,EAAE;QAClB,QAAQ,CAAC,cAAc,EAAE,yBAAyB,CAAC;QACnD,QAAQ,CAAC,eAAe,CAAC,EAAE,yBAAyB,CAAC;QACrD,QAAQ,CAAC,YAAY,EAAE,yBAAyB,CAAC;QACjD,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;QAC5C,QAAQ,CAAC,SAAS,EAAE,SAAS;YAC3B,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;YAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;SACvB,EAAE,CAAC;KACL,CAAC;IACF,QAAQ,CAAC,cAAc,EAAE;QACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;QAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,WAAW,EAAE,SAAS,yBAAyB,EAAE,CAAC;QAC3D,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;KAC9C,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,uBAAuB,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,SAAS,kCAAkC,EAAE,CAAC;CAC/D"}

package/dist/document-authoring/application/model/document-authoring-profile-description.js

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

package/dist/document-authoring/application/model/document-authoring-profile-description.js.map

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

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

@@ -14,6 +14,14 @@ export interface DocumentDescriptor {
     readonly title: string;
     readonly type: string;
 }
+export type DocumentMetadataPrimitive = boolean | null | number | string;
+export interface DocumentMetadataObject {
+    readonly [key: string]: DocumentMetadataValue;
+}
+export type DocumentMetadataValue = DocumentMetadataPrimitive | readonly DocumentMetadataValue[] | DocumentMetadataObject;
+export interface DocumentDescriptorV2 extends DocumentDescriptor {
+    readonly metadata: DocumentMetadataObject;
+}
 export interface DocumentIdentityProjectionEntry {
     readonly id: string;
     readonly repositoryPath: string;
@@ -33,6 +41,9 @@ export interface DocumentationCatalogAuthority {
     readonly ownerCatalog: DocumentAuthorityEvidence;
     readonly profile: DocumentAuthorityEvidence;
 }
+export interface DocumentationCatalogAuthorityV2 extends DocumentationCatalogAuthority {
+    readonly metadataSidecar?: DocumentAuthorityEvidence;
+}
 export interface DocumentationCatalogSnapshot {
     readonly authority: DocumentationCatalogAuthority;
     readonly diagnostics: readonly DocumentationCatalogDiagnostic[];
@@ -42,6 +53,17 @@ export interface DocumentationCatalogSnapshot {
     readonly projectId: string;
     readonly status: "complete" | "partial";
 }
+export interface DocumentationCatalogSnapshotV2 extends Omit<DocumentationCatalogSnapshot, "authority" | "documents"> {
+    readonly authority: DocumentationCatalogAuthorityV2;
+    readonly documents: readonly DocumentDescriptorV2[];
+    readonly semanticDigest: DocumentAuthorityDigest;
+}
+export type DocumentationCatalogSnapshotContract = Omit<DocumentationCatalogSnapshot, "authority"> & {
+    readonly authority: DocumentationCatalogAuthority & {
+        readonly metadataSidecar?: DocumentAuthorityEvidence;
+    };
+    readonly semanticDigest?: DocumentAuthorityDigest;
+};
 export interface DocumentSearchCorpusEntry {
     readonly body: string;
     readonly descriptor: DocumentDescriptor;
@@ -51,6 +73,13 @@ export interface DocumentationSearchCatalogSnapshot {
     readonly catalog: DocumentationCatalogSnapshot;
     readonly documents: readonly DocumentSearchCorpusEntry[];
 }
+export interface DocumentSearchCorpusEntryV2 extends Omit<DocumentSearchCorpusEntry, "descriptor"> {
+    readonly descriptor: DocumentDescriptorV2;
+}
+export interface DocumentationSearchCatalogSnapshotV2 {
+    readonly catalog: DocumentationCatalogSnapshotV2;
+    readonly documents: readonly DocumentSearchCorpusEntryV2[];
+}
 export interface ReferencedDocumentProjectionResult {
     readonly documents: readonly ReferencedDocumentProjection[];
     readonly missingIds: readonly string[];

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

@@ -1 +1 @@
-{"version":3,"file":"document-catalog.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/model/document-catalog.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG,UAAU,MAAM,EAAE,CAAC;AAEzD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,eAAe,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,cAAc,EAAE,yBAAyB,CAAC;IACnD,QAAQ,CAAC,YAAY,EAAE,yBAAyB,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;CAC7C;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,6BAA6B,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,SAAS,8BAA8B,EAAE,CAAC;IAChE,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAClD,QAAQ,CAAC,kBAAkB,EAAE,SAAS,+BAA+B,EAAE,CAAC;IACxE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAC1D;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,SAAS,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAC5D,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C"}
+{"version":3,"file":"document-catalog.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/model/document-catalog.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG,UAAU,MAAM,EAAE,CAAC;AAEzD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,eAAe,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AACzE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAAC;CAC/C;AACD,MAAM,MAAM,qBAAqB,GAC7B,yBAAyB,GACzB,SAAS,qBAAqB,EAAE,GAChC,sBAAsB,CAAC;AAE3B,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;CAC3C;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,cAAc,EAAE,yBAAyB,CAAC;IACnD,QAAQ,CAAC,YAAY,EAAE,yBAAyB,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;CAC7C;AAED,MAAM,WAAW,+BACf,SAAQ,6BAA6B;IACrC,QAAQ,CAAC,eAAe,CAAC,EAAE,yBAAyB,CAAC;CACtD;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,6BAA6B,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,SAAS,8BAA8B,EAAE,CAAC;IAChE,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAClD,QAAQ,CAAC,kBAAkB,EAAE,SAAS,+BAA+B,EAAE,CAAC;IACxE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,WAAW,8BACf,SAAQ,IAAI,CAAC,4BAA4B,EAAE,WAAW,GAAG,WAAW,CAAC;IACrE,QAAQ,CAAC,SAAS,EAAE,+BAA+B,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACpD,QAAQ,CAAC,cAAc,EAAE,uBAAuB,CAAC;CAClD;AAED,MAAM,MAAM,oCAAoC,GAAG,IAAI,CACrD,4BAA4B,EAC5B,WAAW,CACZ,GAAG;IACF,QAAQ,CAAC,SAAS,EAAE,6BAA6B,GAAG;QAClD,QAAQ,CAAC,eAAe,CAAC,EAAE,yBAAyB,CAAC;KACtD,CAAC;IACF,QAAQ,CAAC,cAAc,CAAC,EAAE,uBAAuB,CAAC;CACnD,CAAC;AAEF,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAC1D;AAED,MAAM,WAAW,2BACf,SAAQ,IAAI,CAAC,yBAAyB,EAAE,YAAY,CAAC;IACrD,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;CAC3C;AAED,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,OAAO,EAAE,8BAA8B,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,SAAS,2BAA2B,EAAE,CAAC;CAC5D;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,SAAS,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAC5D,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C"}

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

@@ -1,4 +1,4 @@
-import type { DocumentDescriptor, DocumentationCatalogDiagnostic } from "./document-catalog.js";
+import type { DocumentAuthorityDigest, DocumentDescriptor, DocumentDescriptorV2, DocumentationCatalogDiagnostic } from "./document-catalog.js";
 export interface DocumentFindFilters {
     readonly id?: string;
     readonly owner?: string;
@@ -15,4 +15,8 @@ export interface DocumentFindResult {
     readonly documents: readonly DocumentDescriptor[];
     readonly matches: number;
 }
+export interface DocumentFindResultV2 extends Omit<DocumentFindResult, "documents"> {
+    readonly catalogSemanticDigest: DocumentAuthorityDigest;
+    readonly documents: readonly DocumentDescriptorV2[];
+}
 //# sourceMappingURL=document-find.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"document-find.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/model/document-find.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,8BAA8B,EAC/B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,SAAS,8BAA8B,EAAE,CAAC;IAChE,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B"}
+{"version":3,"file":"document-find.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/model/document-find.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,8BAA8B,EAC/B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,SAAS,8BAA8B,EAAE,CAAC;IAChE,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBACf,SAAQ,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC;IAC7C,QAAQ,CAAC,qBAAqB,EAAE,uBAAuB,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACrD"}

package/dist/document-authoring/application/model/document-parent-materialization.d.ts

@@ -0,0 +1,26 @@
+import type { DocumentPhysicalIdentity } from "./document-physical-identity.js";
+export interface DocumentParentMaterializationPlanV2 {
+    readonly policy: "create-missing-real-directories";
+    readonly deepestExistingDirectory: string;
+    readonly missingDirectories: readonly string[];
+    readonly finalParent: string;
+}
+export interface DocumentCreatedDirectoryEvidenceV2 {
+    readonly path: string;
+    readonly identity: DocumentPhysicalIdentity;
+}
+export interface DocumentParentMaterializationJournalV2 {
+    readonly schemaVersion: 2;
+    readonly plan: DocumentParentMaterializationPlanV2;
+    readonly anchorIdentity: DocumentPhysicalIdentity;
+    readonly createdDirectories: readonly DocumentCreatedDirectoryEvidenceV2[];
+}
+export type DocumentParentMaterializationInspectionV2 = {
+    readonly state: "current";
+    readonly nextDirectory?: string;
+} | {
+    readonly state: "manual-recovery-required";
+    readonly reason: "anchor-changed" | "created-directory-changed" | "portable-name-collision" | "unbound-directory-exists";
+    readonly path: string;
+};
+//# sourceMappingURL=document-parent-materialization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-parent-materialization.d.ts","sourceRoot":"","sources":["../../../../src/document-authoring/application/model/document-parent-materialization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAEhF,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,MAAM,EAAE,iCAAiC,CAAC;IACnD,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;CAC7C;AAED,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,mCAAmC,CAAC;IACnD,QAAQ,CAAC,cAAc,EAAE,wBAAwB,CAAC;IAClD,QAAQ,CAAC,kBAAkB,EAAE,SAAS,kCAAkC,EAAE,CAAC;CAC5E;AAED,MAAM,MAAM,yCAAyC,GACjD;IACE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,MAAM,EACX,gBAAgB,GAChB,2BAA2B,GAC3B,yBAAyB,GACzB,0BAA0B,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC"}

package/dist/document-authoring/application/model/document-parent-materialization.js

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

package/dist/document-authoring/application/model/document-parent-materialization.js.map

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

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

@@ -1,4 +1,5 @@
-import type { DocumentAuthorityDigest, DocumentAuthorityEvidence, DocumentIdentityProjectionEntry, DocumentationCatalogSnapshot } from "./document-catalog.js";
+import type { DocumentAuthorityDigest, DocumentAuthorityEvidence, DocumentIdentityProjectionEntry, DocumentationCatalogSnapshotContract } from "./document-catalog.js";
+import type { DocumentParentMaterializationPlanV2 } from "./document-parent-materialization.js";
 export type DocumentJsonPrimitive = boolean | null | number | string;
 export interface DocumentJsonObject {
     readonly [key: string]: DocumentJsonValue;
@@ -45,6 +46,7 @@ export type DocumentPlacementStrategy = {
     readonly minimumSegmentsAfterRequired: number;
 };
 export interface DocumentArtifactType {
+    readonly allowedOwnerIds?: readonly string[];
     readonly type: string;
     readonly initialStatus: string;
     readonly identity: DocumentIdentityStrategy;
@@ -81,11 +83,16 @@ export interface DocumentPlanningProfileSnapshot {
     readonly evidence: DocumentAuthorityEvidence;
     readonly excludedPrefixes: readonly string[];
     readonly metadataSchemaPath: string;
+    readonly metadataSidecar?: {
+        readonly kind: "path-metadata-map";
+        readonly path: string;
+    };
     readonly ownerCatalog: {
         readonly contract: "foundation.owner-map/v1";
         readonly path: string;
     };
     readonly projectId: string;
+    readonly schemaVersion?: 1 | 2;
 }
 export interface DocumentTemplateSnapshot {
     readonly evidence: DocumentAuthorityEvidence;
@@ -112,6 +119,7 @@ export interface DocumentPlanningStateSnapshot {
         readonly state: "directory";
         readonly ancestry: "real-directories";
     };
+    readonly parentMaterialization?: DocumentParentMaterializationPlanV2;
 }
 export interface DocumentPlanDiagnostic {
     readonly ruleId: string;
@@ -166,8 +174,26 @@ export interface DocumentPlan {
     readonly diagnostics: readonly DocumentPlanDiagnostic[];
     readonly planDigest: DocumentAuthorityDigest;
 }
+export type DocumentPlanV1 = DocumentPlan;
+export type DocumentPlanCommon = Omit<DocumentPlan, "protocolVersion" | "requiredAdapterCapabilities" | "schemaVersion">;
+export interface DocumentPlanV2 extends Omit<DocumentPlanCommon, "authority"> {
+    readonly authority: DocumentPlan["authority"] & {
+        readonly metadataSidecar?: DocumentAuthorityEvidence;
+        readonly profileSemanticDigest: DocumentAuthorityDigest;
+        readonly catalogPreimageSemanticDigest: DocumentAuthorityDigest;
+        readonly expectedCatalogPostimageSemanticDigest: DocumentAuthorityDigest;
+    };
+    readonly schemaVersion: 2;
+    readonly protocolVersion: 2;
+    readonly parentMaterialization: DocumentParentMaterializationPlanV2;
+    readonly requiredAdapterCapabilities: readonly [
+        "create-directories-no-replace/v1",
+        "create-file-no-replace/v1"
+    ];
+}
+export type DocumentPlanContract = DocumentPlan | DocumentPlanV2;
 export interface DocumentPlanningCompilationInput {
-    readonly catalog: DocumentationCatalogSnapshot;
+    readonly catalog: DocumentationCatalogSnapshotContract;
     readonly compiler: DocumentCompilerIdentity;
     readonly identityProjection: readonly DocumentIdentityProjectionEntry[];
     readonly intent: DocumentIntent;
@@ -177,6 +203,7 @@ export interface DocumentPlanningCompilationInput {
     readonly state: DocumentPlanningStateSnapshot;
     readonly template: DocumentTemplateSnapshot;
     readonly output: string;
+    readonly profileSemanticDigest?: DocumentAuthorityDigest;
 }
 export {};
 //# sourceMappingURL=document-planning.d.ts.map