@agent-teams/document-authoring 0.0.0

package/dist/filesystem-path-safety.js.map

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

package/dist/find-command.d.ts

@@ -0,0 +1,28 @@
+import type { DocumentDescriptor } from "./application/model/document-catalog.js";
+import type { DocumentFindResult } from "./application/model/document-find.js";
+interface CommandDiagnostic {
+    readonly message: string;
+    readonly phase: "authority" | "input" | "query";
+    readonly ruleId: string;
+    readonly severity: "error" | "warning";
+    readonly subject: string;
+}
+interface DocumentFindEnvelope {
+    readonly command: "docs.find";
+    readonly diagnostics: readonly CommandDiagnostic[];
+    readonly outcome: "authority-stale" | "cancelled" | "execution-failure" | "invalid-input" | "partial" | "success";
+    readonly result: {
+        readonly documents: readonly DocumentDescriptor[];
+        readonly kind: "find";
+        readonly matches: number;
+    };
+    readonly schemaVersion: 1;
+}
+export interface DocumentFindCommandResult {
+    readonly envelope: DocumentFindEnvelope;
+    readonly exitCode: 0 | 1 | 2 | 3 | 130;
+}
+export declare function documentFindFailure(error: unknown): DocumentFindCommandResult;
+export declare function documentFindSuccess(result: DocumentFindResult): DocumentFindCommandResult;
+export {};
+//# sourceMappingURL=find-command.d.ts.map

package/dist/find-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-command.d.ts","sourceRoot":"","sources":["../src/find-command.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAEnB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EACV,kBAAkB,EACnB,MAAM,sCAAsC,CAAC;AAM9C,UAAU,iBAAiB;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACnD,QAAQ,CAAC,OAAO,EACZ,iBAAiB,GACjB,WAAW,GACX,mBAAmB,GACnB,eAAe,GACf,SAAS,GACT,SAAS,CAAC;IACd,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;QAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;CACxC;AAsDD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,GACb,yBAAyB,CA6F3B;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,kBAAkB,GACzB,yBAAyB,CAW3B"}

package/dist/find-command.js

@@ -0,0 +1,146 @@
+import { CapabilityInputError } from "./capability-runtime.js";
+import { DocumentAuthoringError } from "./errors.js";
+import { DocumentCatalogError } from "./document-catalog-error.js";
+const MAXIMUM_DOCUMENTS = 2_048;
+const MAXIMUM_DIAGNOSTICS = 256;
+function diagnostic(source, phase) {
+    return Object.freeze({
+        message: source.message.slice(0, 1_000),
+        phase,
+        ruleId: source.ruleId,
+        severity: source.severity,
+        subject: source.subject.slice(0, 512)
+    });
+}
+function boundDiagnostics(sources) {
+    if (sources.length <= MAXIMUM_DIAGNOSTICS) {
+        return Object.freeze(sources.map((source) => diagnostic(source, "query")));
+    }
+    return Object.freeze([
+        ...sources
+            .slice(0, MAXIMUM_DIAGNOSTICS - 1)
+            .map((source) => diagnostic(source, "query")),
+        Object.freeze({
+            message: `Catalog returned ${sources.length} diagnostics; JSON output includes the first ${MAXIMUM_DIAGNOSTICS - 1}.`,
+            phase: "query",
+            ruleId: "document.query.diagnostics-truncated",
+            severity: "warning",
+            subject: "document.query"
+        })
+    ]);
+}
+function envelope(input) {
+    return Object.freeze({
+        schemaVersion: 1,
+        command: "docs.find",
+        outcome: input.outcome,
+        diagnostics: Object.freeze([...(input.diagnostics ?? [])]),
+        result: Object.freeze({
+            kind: "find",
+            matches: input.matches ?? 0,
+            documents: Object.freeze([...(input.documents ?? [])])
+        })
+    });
+}
+export function documentFindFailure(error) {
+    if (error instanceof CapabilityInputError &&
+        error.problem.code === "EXECUTION_CANCELLED") {
+        return Object.freeze({
+            envelope: envelope({
+                diagnostics: [
+                    Object.freeze({
+                        message: error.problem.message,
+                        phase: "query",
+                        ruleId: "document.query.cancelled",
+                        severity: "error",
+                        subject: "document.query"
+                    })
+                ],
+                outcome: "cancelled"
+            }),
+            exitCode: 130
+        });
+    }
+    if (error instanceof CapabilityInputError) {
+        return Object.freeze({
+            envelope: envelope({
+                diagnostics: [
+                    Object.freeze({
+                        message: error.problem.message.slice(0, 1_000),
+                        phase: "input",
+                        ruleId: "document.query.invalid-input",
+                        severity: "error",
+                        subject: "document.query"
+                    })
+                ],
+                outcome: "invalid-input"
+            }),
+            exitCode: 2
+        });
+    }
+    if (error instanceof DocumentCatalogError) {
+        const authorityStale = error.code === "DOCUMENT_CATALOG_AUTHORITY_CHANGED";
+        return Object.freeze({
+            envelope: envelope({
+                diagnostics: [
+                    Object.freeze({
+                        message: error.message.slice(0, 1_000),
+                        phase: authorityStale ? "authority" : "input",
+                        ruleId: authorityStale
+                            ? "document.query.authority-stale"
+                            : "document.query.invalid-input",
+                        severity: "error",
+                        subject: "document.query"
+                    })
+                ],
+                outcome: authorityStale ? "authority-stale" : "invalid-input"
+            }),
+            exitCode: authorityStale ? 1 : 2
+        });
+    }
+    if (error instanceof DocumentAuthoringError && error.code === "CONSUMER_INVALID") {
+        return Object.freeze({
+            envelope: envelope({
+                diagnostics: [
+                    Object.freeze({
+                        message: error.message.slice(0, 1_000),
+                        phase: "input",
+                        ruleId: "document.query.invalid-input",
+                        severity: "error",
+                        subject: "document.query"
+                    })
+                ],
+                outcome: "invalid-input"
+            }),
+            exitCode: 2
+        });
+    }
+    return Object.freeze({
+        envelope: envelope({
+            diagnostics: [
+                Object.freeze({
+                    message: (error instanceof Error ? error.message : String(error)).slice(0, 1_000),
+                    phase: "query",
+                    ruleId: "document.query.execution-failure",
+                    severity: "error",
+                    subject: "document.query"
+                })
+            ],
+            outcome: "execution-failure"
+        }),
+        exitCode: 3
+    });
+}
+export function documentFindSuccess(result) {
+    const partial = result.catalogStatus === "partial";
+    return Object.freeze({
+        envelope: envelope({
+            diagnostics: boundDiagnostics(result.diagnostics),
+            documents: result.documents.slice(0, MAXIMUM_DOCUMENTS),
+            matches: result.matches,
+            outcome: partial ? "partial" : "success"
+        }),
+        exitCode: partial ? 1 : 0
+    });
+}
+//# sourceMappingURL=find-command.js.map

package/dist/find-command.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+import { type BuildDocumentationCatalogRequest } from "./application/use-cases/build-documentation-catalog.js";
+import { type FindDocumentsRequest } from "./application/use-cases/find-documents.js";
+import type { PlanDocumentationDocumentRequest, PlanDocumentationDocumentRequestV2 } from "./application/use-cases/plan-documentation-document.js";
+import type { ApplyDocumentPlanRequest } from "./application/use-cases/apply-document-plan.js";
+import type { RecoverDocumentTransactionRequest } from "./application/use-cases/recover-document-transaction.js";
+import { describeDocumentAuthoringProfileV2, describeDocumentAuthoringProfileV3 } from "./composition/describe-document-authoring-profile-v2.js";
+import { inspectDocumentAuthoringEnvironmentV1 } from "./composition/inspect-document-authoring-environment-v1.js";
+export { readDocumentAuthoringSchema } from "./schema-catalog.js";
+export type { DocumentAuthoringSchemaId } from "./schema-catalog.js";
+export type { DocumentAuthorityDigest, DocumentAuthorityEvidence, DocumentDescriptor, DocumentDescriptorV2, DocumentIdentityProjectionEntry, DocumentationCatalogAuthority, DocumentationCatalogAuthorityV2, DocumentationCatalogDiagnostic, DocumentationCatalogSnapshot, DocumentationCatalogSnapshotV2, DocumentMetadataObject, DocumentMetadataPrimitive, DocumentMetadataValue, ReferencedDocumentProjection, ReferencedDocumentProjectionResult } from "./application/model/document-catalog.js";
+export type { DocumentFindFilters, DocumentFindQuery, DocumentFindResult, DocumentFindResultV2 } from "./application/model/document-find.js";
+export type { DocumentAuthoringProfileDescriptionV2, DocumentAuthoringProfileDescriptionV3, DocumentAuthoringTypeDescriptionV2, DocumentReachabilityStrategyV2 } from "./application/model/document-authoring-profile-description.js";
+export type { DocumentCompilerIdentity, DocumentIntent, DocumentJsonObject, DocumentJsonPrimitive, DocumentJsonValue, DocumentCatalogCollection, DocumentIdentityStrategy, DocumentPlacementStrategy, DocumentPlan, DocumentPlanCommon, DocumentPlanContract, DocumentPlanV1, DocumentPlanV2, DocumentPlanDiagnostic, DocumentReachabilityStrategy } from "./application/model/document-planning.js";
+export type { DocumentPhysicalIdentity } from "./application/model/document-physical-identity.js";
+export type { DocumentCreatedDirectoryEvidenceV2, DocumentParentMaterializationInspectionV2, DocumentParentMaterializationJournalV2, } from "./application/model/document-parent-materialization.js";
+/**
+ * @deprecated Qualification-only low-level planner model. Import from
+ * `@agent-teams/document-authoring/qualification`.
+ */
+export type { DocumentParentMaterializationPlanV2 } from "./application/model/document-parent-materialization.js";
+export type { DocumentCommitObservation, DocumentReceipt, DocumentReceiptBase, DocumentReceiptDiagnostic, DocumentReceiptOutcome, DocumentReceiptV1, DocumentReceiptV2, DocumentReceiptContract } from "./application/model/document-receipt.js";
+export type { DocumentTransactionInspectionDiagnostic, DocumentTransactionInspection, DocumentTransactionInspectionV1, DocumentTransactionInspectionV2 } from "./application/model/document-transaction-inspection.js";
+export type { DocumentJournalBase, DocumentOwnedTemporary, DocumentTransactionEnvelope, DocumentTransactionEnvelopeBase, DocumentTransactionEnvelopeV3, DocumentTransactionEnvelopeV4, DocumentTransactionEnvelopeV4Base, DocumentTransactionJournal, DocumentTransactionJournalV3, DocumentTransactionJournalV3Base } from "./application/model/document-transaction.js";
+export type { ApplyDocumentPlanRequest } from "./application/use-cases/apply-document-plan.js";
+export type { RecoverDocumentTransactionRequest } from "./application/use-cases/recover-document-transaction.js";
+export type { DocumentTransactionRequest } from "./application/use-cases/document-transaction-continuation.js";
+export type { BuildDocumentationCatalogRequest } from "./application/use-cases/build-documentation-catalog.js";
+export type { FindDocumentsRequest } from "./application/use-cases/find-documents.js";
+export type { DescribeDocumentAuthoringProfileV2Request, DescribeDocumentAuthoringProfileV3Request } from "./composition/describe-document-authoring-profile-v2.js";
+export type { InspectDocumentAuthoringEnvironmentV1Request } from "./composition/inspect-document-authoring-environment-v1.js";
+export type { DocumentEnvironmentInspection } from "./application/ports/document-environment-inspector.js";
+export type { PlanDocumentationDocumentRequest, PlanDocumentationDocumentRequestContract, PlanDocumentationDocumentRequestV2 } from "./application/use-cases/plan-documentation-document.js";
+export { projectReferencedDocuments } from "./application/projections/document-catalog-projections.js";
+export { DocumentCatalogError } from "./document-catalog-error.js";
+export type { DocumentCatalogErrorCode } from "./document-catalog-error.js";
+export { DocumentPlanningError } from "./document-planning-error.js";
+export type { DocumentPlanningErrorCode } from "./document-planning-error.js";
+export { inspectDocumentTransactionV1, inspectDocumentTransactionV2 } from "./composition/inspect-document-transaction.js";
+export { describeDocumentAuthoringProfileV2 };
+export { describeDocumentAuthoringProfileV3 };
+export { inspectDocumentAuthoringEnvironmentV1 };
+export { planDocumentParentMaterializationV2 } from "./adapters/node/node-document-parent-materializer.js";
+export declare function buildDocumentationCatalog(request: BuildDocumentationCatalogRequest): Promise<import("./application/model/document-catalog.js").DocumentationCatalogSnapshot>;
+export declare function buildDocumentationCatalogV2(request: BuildDocumentationCatalogRequest): Promise<import("./application/model/document-catalog.js").DocumentationCatalogSnapshotV2>;
+export declare function findDocumentationDocuments(request: FindDocumentsRequest): Promise<import("./application/model/document-find.js").DocumentFindResult>;
+export declare function findDocumentationDocumentsV2(request: FindDocumentsRequest): Promise<import("./application/model/document-find.js").DocumentFindResultV2>;
+/**
+ * Compiles a deterministic Document Plan without reserving an identity or
+ * mutating the consumer repository.
+ */
+export declare function planDocumentationDocument(request: PlanDocumentationDocumentRequest): Promise<import("./application/model/document-planning.js").DocumentPlan>;
+/** Compiles the directory-materializing Document Plan v2 contract. */
+export declare function planDocumentationDocumentV2(request: PlanDocumentationDocumentRequestV2): Promise<import("./application/model/document-planning.js").DocumentPlanV2>;
+/** Applies one exact Document Plan through the durable create-only writer. */
+export declare function applyDocumentationPlan(request: ApplyDocumentPlanRequest): Promise<import("./application/model/document-receipt.js").DocumentReceipt>;
+/** Applies one exact Document Plan v2 through envelope v4. */
+export declare function applyDocumentationPlanV2(request: Omit<ApplyDocumentPlanRequest, "plan"> & {
+    readonly plan: import("./application/model/document-planning.js").DocumentPlanV2;
+}): Promise<import("./application/model/document-receipt.js").DocumentReceiptV2>;
+/** Recovers one coordinator-qualified document transaction. */
+export declare function recoverDocumentationTransaction(request: RecoverDocumentTransactionRequest): Promise<import("./application/model/document-receipt.js").DocumentReceipt>;
+/** Recovers either exact supported document transaction generation. */
+export declare function recoverDocumentationTransactionV2(request: RecoverDocumentTransactionRequest): Promise<import("./application/model/document-receipt.js").DocumentReceiptContract>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,95 @@
+import { FilesystemMarkdownRepository } from "./documentation-observation/adapters/outbound/filesystem/filesystem-markdown-repository.js";
+import { NodeAuthoringProfileReader } from "./adapters/node/node-authoring-profile-reader.js";
+import { NodeAuthoringProfileReaderV2 } from "./adapters/node/node-authoring-profile-reader-v2.js";
+import { NodeDocumentMetadataSidecarReader } from "./adapters/node/node-document-metadata-sidecar-reader.js";
+import { NodeMetadataInstanceValidator } from "./adapters/node/node-metadata-instance-validator.js";
+import { NodeOwnerMembershipReader } from "./adapters/node/node-owner-membership-reader.js";
+import { BuildDocumentationCatalog, BuildDocumentationCatalogV2 } from "./application/use-cases/build-documentation-catalog.js";
+import { FindDocuments, FindDocumentsV2 } from "./application/use-cases/find-documents.js";
+import { planNodeDocumentationDocument } from "./composition/node-document-planning.js";
+import { applyNodeDocumentationPlan, recoverNodeDocumentationTransaction } from "./composition/node-document-writing.js";
+import { describeDocumentAuthoringProfileV2, describeDocumentAuthoringProfileV3 } from "./composition/describe-document-authoring-profile-v2.js";
+import { inspectDocumentAuthoringEnvironmentV1 } from "./composition/inspect-document-authoring-environment-v1.js";
+export { readDocumentAuthoringSchema } from "./schema-catalog.js";
+export { projectReferencedDocuments } from "./application/projections/document-catalog-projections.js";
+export { DocumentCatalogError } from "./document-catalog-error.js";
+export { DocumentPlanningError } from "./document-planning-error.js";
+export { inspectDocumentTransactionV1, inspectDocumentTransactionV2 } from "./composition/inspect-document-transaction.js";
+export { describeDocumentAuthoringProfileV2 };
+export { describeDocumentAuthoringProfileV3 };
+export { inspectDocumentAuthoringEnvironmentV1 };
+export { planDocumentParentMaterializationV2 } from "./adapters/node/node-document-parent-materializer.js";
+export async function buildDocumentationCatalog(request) {
+    const builder = new BuildDocumentationCatalog({
+        metadata: new NodeMetadataInstanceValidator(),
+        owners: new NodeOwnerMembershipReader(),
+        profile: new NodeAuthoringProfileReader(),
+        repository: new FilesystemMarkdownRepository()
+    });
+    return builder.execute(request);
+}
+export async function buildDocumentationCatalogV2(request) {
+    const builder = new BuildDocumentationCatalogV2({
+        metadata: new NodeMetadataInstanceValidator(),
+        owners: new NodeOwnerMembershipReader(),
+        profile: new NodeAuthoringProfileReaderV2(),
+        repository: new FilesystemMarkdownRepository(),
+        sidecar: new NodeDocumentMetadataSidecarReader()
+    });
+    return builder.execute(request);
+}
+export async function findDocumentationDocuments(request) {
+    const catalog = new BuildDocumentationCatalog({
+        metadata: new NodeMetadataInstanceValidator(),
+        owners: new NodeOwnerMembershipReader(),
+        profile: new NodeAuthoringProfileReader(),
+        repository: new FilesystemMarkdownRepository()
+    });
+    return new FindDocuments(catalog).execute(request);
+}
+export async function findDocumentationDocumentsV2(request) {
+    const catalog = new BuildDocumentationCatalogV2({
+        metadata: new NodeMetadataInstanceValidator(),
+        owners: new NodeOwnerMembershipReader(),
+        profile: new NodeAuthoringProfileReaderV2(),
+        repository: new FilesystemMarkdownRepository(),
+        sidecar: new NodeDocumentMetadataSidecarReader()
+    });
+    return new FindDocumentsV2(catalog).execute(request);
+}
+/**
+ * Compiles a deterministic Document Plan without reserving an identity or
+ * mutating the consumer repository.
+ */
+export async function planDocumentationDocument(request) {
+    return planNodeDocumentationDocument(request);
+}
+/** Compiles the directory-materializing Document Plan v2 contract. */
+export async function planDocumentationDocumentV2(request) {
+    const plan = await planNodeDocumentationDocument(request);
+    if (plan.schemaVersion !== 2) {
+        throw new TypeError("Document Plan v2 entrypoint received a legacy planning result.");
+    }
+    return plan;
+}
+/** Applies one exact Document Plan through the durable create-only writer. */
+export async function applyDocumentationPlan(request) {
+    return applyNodeDocumentationPlan(request);
+}
+/** Applies one exact Document Plan v2 through envelope v4. */
+export async function applyDocumentationPlanV2(request) {
+    const receipt = await applyNodeDocumentationPlan(request);
+    if (receipt.schemaVersion !== 2) {
+        throw new TypeError("Document Plan v2 produced a legacy Receipt.");
+    }
+    return receipt;
+}
+/** Recovers one coordinator-qualified document transaction. */
+export async function recoverDocumentationTransaction(request) {
+    return recoverNodeDocumentationTransaction(request);
+}
+/** Recovers either exact supported document transaction generation. */
+export async function recoverDocumentationTransactionV2(request) {
+    return recoverNodeDocumentationTransaction(request);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/installed-artifact-identity.d.ts

@@ -0,0 +1,2 @@
+export declare function installedDocumentAuthoringBuildIdentity(): Promise<`sha256:${string}`>;
+//# sourceMappingURL=installed-artifact-identity.d.ts.map

package/dist/installed-artifact-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installed-artifact-identity.d.ts","sourceRoot":"","sources":["../src/installed-artifact-identity.ts"],"names":[],"mappings":"AAiBA,wBAAgB,uCAAuC,IAAI,OAAO,CAAC,UAAU,MAAM,EAAE,CAAC,CAGrF"}

package/dist/installed-artifact-identity.js

@@ -0,0 +1,13 @@
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { computeInstalledArtifactBuildIdentity } from "@agent-teams/repository-mutation";
+const packageRoot = dirname(fileURLToPath(new URL("../package.json", import.meta.url)));
+function computeDocumentAuthoringBuildIdentity(root, limits = {}) {
+    return computeInstalledArtifactBuildIdentity({ packageRoot: root, roots: ["dist", "schemas"] }, limits);
+}
+let installedIdentity;
+export function installedDocumentAuthoringBuildIdentity() {
+    installedIdentity ??= computeDocumentAuthoringBuildIdentity(packageRoot);
+    return installedIdentity;
+}
+//# sourceMappingURL=installed-artifact-identity.js.map

package/dist/installed-artifact-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installed-artifact-identity.js","sourceRoot":"","sources":["../src/installed-artifact-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,qCAAqC,EAAE,MAAM,kCAAkC,CAAC;AAEzF,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAExF,SAAS,qCAAqC,CAC5C,IAAY,EACZ,MAAM,GAAgD,EAAE;IAExD,OAAO,qCAAqC,CAC1C,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,CAC1D,CAAC;AACJ,CAAC;AAED,IAAI,iBAA0D,CAAC;AAC/D,MAAM,UAAU,uCAAuC;IACrD,iBAAiB,KAAK,qCAAqC,CAAC,WAAW,CAAC,CAAC;IACzE,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}

package/dist/observation.d.ts

@@ -0,0 +1,4 @@
+export { FilesystemMarkdownRepository } from "./documentation-observation/adapters/outbound/filesystem/filesystem-markdown-repository.js";
+export * from "./documentation-observation/application/model/markdown-document.js";
+export type * from "./documentation-observation/application/ports/markdown-repository.js";
+//# sourceMappingURL=observation.d.ts.map

package/dist/observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.d.ts","sourceRoot":"","sources":["../src/observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,4FAA4F,CAAC;AAC1I,cAAc,oEAAoE,CAAC;AACnF,mBAAmB,sEAAsE,CAAC"}

package/dist/observation.js

@@ -0,0 +1,3 @@
+export { FilesystemMarkdownRepository } from "./documentation-observation/adapters/outbound/filesystem/filesystem-markdown-repository.js";
+export * from "./documentation-observation/application/model/markdown-document.js";
+//# sourceMappingURL=observation.js.map

package/dist/observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.js","sourceRoot":"","sources":["../src/observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,4FAA4F,CAAC;AAC1I,cAAc,oEAAoE,CAAC"}

package/dist/package-version.d.ts

@@ -0,0 +1,2 @@
+export declare function installedDocumentAuthoringVersion(): Promise<string>;
+//# sourceMappingURL=package-version.d.ts.map

package/dist/package-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-version.d.ts","sourceRoot":"","sources":["../src/package-version.ts"],"names":[],"mappings":"AAGA,wBAAsB,iCAAiC,IAAI,OAAO,CAAC,MAAM,CAAC,CAQzE"}

package/dist/package-version.js

@@ -0,0 +1,10 @@
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+export async function installedDocumentAuthoringVersion() {
+    const manifest = JSON.parse(await readFile(fileURLToPath(new URL("../package.json", import.meta.url)), "utf8"));
+    if (typeof manifest.version !== "string") {
+        throw new Error("Installed Document Authoring package version is unavailable.");
+    }
+    return manifest.version;
+}
+//# sourceMappingURL=package-version.js.map

package/dist/package-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-version.js","sourceRoot":"","sources":["../src/package-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,iCAAiC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CACxC,aAAa,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CACnE,CAAmC,CAAC;IACrC,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC1B,CAAC"}

package/dist/qualification/index.d.ts

@@ -0,0 +1,27 @@
+import type { DocumentPlanV2 } from "../application/model/document-planning.js";
+export type { DocumentCompilerIdentity, DocumentIntent, DocumentJsonObject, DocumentJsonPrimitive, DocumentJsonValue, DocumentPlan, DocumentPlanCommon, DocumentPlanDiagnostic, DocumentPlanV1, DocumentPlanV2 } from "../application/model/document-planning.js";
+export type { DocumentAuthorityDigest, DocumentAuthorityEvidence } from "../application/model/document-catalog.js";
+export type { DocumentJournalBase, DocumentOwnedTemporary, DocumentTransactionEnvelope, DocumentTransactionEnvelopeBase, DocumentTransactionEnvelopeV3, DocumentTransactionEnvelopeV4, DocumentTransactionEnvelopeV4Base, DocumentTransactionJournal, DocumentTransactionJournalV3, DocumentTransactionJournalV3Base } from "../application/model/document-transaction.js";
+export type { DocumentCreatedDirectoryEvidenceV2, DocumentParentMaterializationPlanV2 } from "../application/model/document-parent-materialization.js";
+export type { DocumentPhysicalIdentity } from "../application/model/document-physical-identity.js";
+export { assertDocumentPlanDigests } from "../application/policies/document-contract-digests.js";
+export { assertDocumentTransactionEnvelope } from "../application/policies/document-transaction-envelope-policy.js";
+export { documentTemporaryPath } from "../application/policies/document-temporary-path.js";
+export type DocumentAuthoringQualificationCrashPoint = "after-publishing-journal-durable" | "after-published-journal-durable";
+export interface RunDocumentAuthoringCrashQualificationRequest {
+    readonly consumerRoot: string;
+    readonly plan: DocumentPlanV2;
+    readonly crashPoint: DocumentAuthoringQualificationCrashPoint;
+}
+export interface DocumentAuthoringCrashQualificationResult {
+    readonly schemaVersion: 1;
+    readonly crashPoint: DocumentAuthoringQualificationCrashPoint;
+    readonly state: "apply-completed-before-crash-point";
+}
+/**
+ * Runs a real document apply until the selected durable crash checkpoint.
+ * The process intentionally remains pending after signalling and must be killed
+ * by the qualification harness.
+ */
+export declare function runDocumentAuthoringCrashQualification(request: RunDocumentAuthoringCrashQualificationRequest): Promise<DocumentAuthoringCrashQualificationResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/qualification/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/qualification/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAGhF,YAAY,EACV,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,cAAc,EACf,MAAM,2CAA2C,CAAC;AACnD,YAAY,EACV,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,0CAA0C,CAAC;AAClD,YAAY,EACV,mBAAmB,EACnB,sBAAsB,EACtB,2BAA2B,EAC3B,+BAA+B,EAC/B,6BAA6B,EAC7B,6BAA6B,EAC7B,iCAAiC,EACjC,0BAA0B,EAC1B,4BAA4B,EAC5B,gCAAgC,EACjC,MAAM,8CAA8C,CAAC;AACtD,YAAY,EACV,kCAAkC,EAClC,mCAAmC,EACpC,MAAM,yDAAyD,CAAC;AACjE,YAAY,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,yBAAyB,EAAE,MAAM,sDAAsD,CAAC;AACjG,OAAO,EAAE,iCAAiC,EAAE,MAAM,iEAAiE,CAAC;AACpH,OAAO,EAAE,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AAK3F,MAAM,MAAM,wCAAwC,GAChD,kCAAkC,GAClC,iCAAiC,CAAC;AAOtC,MAAM,WAAW,6CAA6C;IAC5D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,wCAAwC,CAAC;CAC/D;AAED,MAAM,WAAW,yCAAyC;IACxD,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,wCAAwC,CAAC;IAC9D,QAAQ,CAAC,KAAK,EAAE,oCAAoC,CAAC;CACtD;AAiJD;;;;GAIG;AACH,wBAAsB,sCAAsC,CAC1D,OAAO,EAAE,6CAA6C,GACrD,OAAO,CAAC,yCAAyC,CAAC,CAwBpD"}