@agent-teams/engineering-foundation 0.14.0 → 0.15.0

package/dist/document-authoring/index.js

@@ -1,11 +1,25 @@
 import { FilesystemMarkdownRepository } from "../documentation-observation/adapters/outbound/filesystem/filesystem-markdown-repository.js";
+import { installedFoundationVersion } from "../package-version.js";
+import { installedFoundationBuildIdentity } from "../transaction-coordination/adapters/node/installed-foundation-build-identity.js";
+import { CanonicalMarkdownError, YamlCanonicalDocumentRenderer } from "./adapters/canonical-markdown.js";
 import { NodeAuthoringProfileReader } from "./adapters/node/node-authoring-profile-reader.js";
+import { NodeDocumentContractValidator } from "./adapters/node/node-document-contract-validator.js";
+import { NodeDocumentPlanningProfileReader } from "./adapters/node/node-document-planning-profile-reader.js";
+import { NodeDocumentPlanningStateReader } from "./adapters/node/node-document-planning-state-reader.js";
+import { NodeDocumentTemplateReader } from "./adapters/node/node-document-template-reader.js";
 import { NodeMetadataInstanceValidator } from "./adapters/node/node-metadata-instance-validator.js";
 import { NodeOwnerMembershipReader } from "./adapters/node/node-owner-membership-reader.js";
+import { DocumentPlanningPolicyError } from "./application/policies/document-planning-policy-error.js";
+import { classifyDocumentLogicalPreimage, isDestinationCoveredByCatalog } from "./application/policies/document-logical-preimage.js";
+import { normalizeDocumentIntent } from "./application/policies/normalize-document-intent.js";
+import { resolveDocumentAuthoring, selectDocumentArtifact } from "./application/policies/resolve-document-authoring.js";
 import { BuildDocumentationCatalog } from "./application/use-cases/build-documentation-catalog.js";
 import { FindDocuments } from "./application/use-cases/find-documents.js";
+import { PlanDocumentationDocument } from "./application/use-cases/plan-documentation-document.js";
+import { DocumentPlanningError } from "./document-planning-error.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 async function buildDocumentationCatalog(request) {
     const builder = new BuildDocumentationCatalog({
         metadata: new NodeMetadataInstanceValidator(),
@@ -24,4 +38,62 @@ export async function findDocumentationDocuments(request) {
     });
     return new FindDocuments(catalog).execute(request);
 }
+function planningPolicyFailure(error) {
+    const code = error.problem === "catalog-incomplete"
+        ? "DOCUMENT_PLANNING_CATALOG_PARTIAL"
+        : ["catalog-collision", "destination-conflict"].includes(error.problem)
+            ? "DOCUMENT_PLANNING_CONFLICT"
+            : "DOCUMENT_PLANNING_INPUT_INVALID";
+    throw new DocumentPlanningError(code, error.message, { cause: error });
+}
+/**
+ * Compiles a deterministic Document Plan without reserving an identity or
+ * mutating the consumer repository.
+ */
+export async function planDocumentationDocument(request) {
+    const catalog = new BuildDocumentationCatalog({
+        metadata: new NodeMetadataInstanceValidator(),
+        owners: new NodeOwnerMembershipReader(),
+        profile: new NodeAuthoringProfileReader(),
+        repository: new FilesystemMarkdownRepository()
+    });
+    const [version, buildIdentity] = await Promise.all([
+        installedFoundationVersion(),
+        installedFoundationBuildIdentity()
+    ]);
+    const planner = new PlanDocumentationDocument({
+        catalog,
+        compiler: {
+            id: "@agent-teams/engineering-foundation",
+            version,
+            buildIdentity
+        },
+        contracts: new NodeDocumentContractValidator(),
+        metadata: new NodeMetadataInstanceValidator(),
+        owners: new NodeOwnerMembershipReader(),
+        policies: {
+            classifyDocumentLogicalPreimage,
+            isDestinationCoveredByCatalog,
+            normalizeDocumentIntent,
+            resolveDocumentAuthoring,
+            selectDocumentArtifact
+        },
+        profile: new NodeDocumentPlanningProfileReader(),
+        renderer: new YamlCanonicalDocumentRenderer(),
+        state: new NodeDocumentPlanningStateReader(),
+        templates: new NodeDocumentTemplateReader()
+    });
+    try {
+        return await planner.execute(request);
+    }
+    catch (error) {
+        if (error instanceof DocumentPlanningPolicyError) {
+            planningPolicyFailure(error);
+        }
+        if (error instanceof CanonicalMarkdownError) {
+            throw new DocumentPlanningError("DOCUMENT_PLANNING_AUTHORITY_UNAVAILABLE", `Document template authority is invalid: ${error.message}`, { cause: error });
+        }
+        throw error;
+    }
+}
 //# sourceMappingURL=index.js.map

package/dist/document-authoring/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/document-authoring/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,6FAA6F,CAAC;AAC3I,OAAO,EAAE,0BAA0B,EAAE,MAAM,kDAAkD,CAAC;AAC9F,OAAO,EAAE,6BAA6B,EAAE,MAAM,qDAAqD,CAAC;AACpG,OAAO,EAAE,yBAAyB,EAAE,MAAM,iDAAiD,CAAC;AAC5F,OAAO,EACL,yBAAyB,EAE1B,MAAM,wDAAwD,CAAC;AAChE,OAAO,EACL,aAAa,EAEd,MAAM,2CAA2C,CAAC;AAoBnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,2DAA2D,CAAC;AACvG,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAyC;IAEzC,MAAM,OAAO,GAAG,IAAI,yBAAyB,CAAC;QAC5C,QAAQ,EAAE,IAAI,6BAA6B,EAAE;QAC7C,MAAM,EAAE,IAAI,yBAAyB,EAAE;QACvC,OAAO,EAAE,IAAI,0BAA0B,EAAE;QACzC,UAAU,EAAE,IAAI,4BAA4B,EAAE;KAC/C,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,OAA6B;IAC5E,MAAM,OAAO,GAAG,IAAI,yBAAyB,CAAC;QAC5C,QAAQ,EAAE,IAAI,6BAA6B,EAAE;QAC7C,MAAM,EAAE,IAAI,yBAAyB,EAAE;QACvC,OAAO,EAAE,IAAI,0BAA0B,EAAE;QACzC,UAAU,EAAE,IAAI,4BAA4B,EAAE;KAC/C,CAAC,CAAC;IACH,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AACrD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/document-authoring/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-teams/engineering-foundation",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "Versioned engineering policy, tooling, and conformance for Agent Teams repositories.",
   "license": "Apache-2.0",
   "type": "module",