@agent-teams/engineering-foundation 0.18.0 → 0.20.0

package/dist/transaction-coordination/application/release-foundation-transaction-lease.js

@@ -0,0 +1,23 @@
+function combinedInspectionAndReleaseFailure(inspectionError, releaseError) {
+    return new Error("Foundation transaction evidence inspection and barrier retention both failed.", {
+        cause: new AggregateError([inspectionError, releaseError], "Transaction evidence inspection and operation-lock release failed.")
+    });
+}
+export async function releaseFoundationTransactionLeaseSafely(options) {
+    let retainTransactionBarrier;
+    try {
+        retainTransactionBarrier =
+            await options.inspectRetainTransactionBarrier();
+    }
+    catch (inspectionError) {
+        try {
+            await options.lease.release({ retainTransactionBarrier: true });
+        }
+        catch (releaseError) {
+            throw combinedInspectionAndReleaseFailure(inspectionError, releaseError);
+        }
+        throw inspectionError;
+    }
+    await options.lease.release({ retainTransactionBarrier });
+}
+//# sourceMappingURL=release-foundation-transaction-lease.js.map

package/dist/transaction-coordination/application/release-foundation-transaction-lease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-foundation-transaction-lease.js","sourceRoot":"","sources":["../../../src/transaction-coordination/application/release-foundation-transaction-lease.ts"],"names":[],"mappings":"AAEA,SAAS,mCAAmC,CAC1C,eAAwB,EACxB,YAAqB;IAErB,OAAO,IAAI,KAAK,CACd,+EAA+E,EAC/E;QACE,KAAK,EAAE,IAAI,cAAc,CACvB,CAAC,eAAe,EAAE,YAAY,CAAC,EAC/B,oEAAoE,CACrE;KACF,CACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uCAAuC,CAAC,OAG7D;IACC,IAAI,wBAAiC,CAAC;IACtC,IAAI,CAAC;QACH,wBAAwB;YACtB,MAAM,OAAO,CAAC,+BAA+B,EAAE,CAAC;IACpD,CAAC;IAAC,OAAO,eAAe,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,wBAAwB,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,YAAY,EAAE,CAAC;YACtB,MAAM,mCAAmC,CACvC,eAAe,EACf,YAAY,CACb,CAAC;QACJ,CAAC;QACD,MAAM,eAAe,CAAC;IACxB,CAAC;IACD,MAAM,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,wBAAwB,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-teams/engineering-foundation",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "Versioned engineering policy, tooling, and conformance for Agent Teams repositories.",
   "license": "Apache-2.0",
   "type": "module",
@@ -58,6 +58,7 @@
     "schemas/contract-protobuf-evolution/v1.schema.json",
     "schemas/document-authoring-profile/v1.schema.json",
     "schemas/document-authoring-profile/v2.schema.json",
+    "schemas/document-authoring-profile/v3.schema.json",
     "schemas/document-command-envelope/v1.schema.json",
     "schemas/document-command-envelope/v2.schema.json",
     "schemas/document-intent/v1.schema.json",

package/schemas/document-authoring-profile/v3.schema.json

@@ -0,0 +1,200 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/document-authoring-profile/v3",
+  "title": "Document Authoring Profile v3",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "projectId", "catalog", "authoring"],
+  "properties": {
+    "schemaVersion": { "const": 3 },
+    "projectId": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/lowerId" },
+    "catalog": { "$ref": "#/$defs/catalog" },
+    "authoring": { "$ref": "#/$defs/authoring" }
+  },
+  "$defs": {
+    "catalog": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["metadataSchemaPath", "ownerCatalog", "collections"],
+      "properties": {
+        "metadataSchemaPath": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" },
+        "ownerCatalog": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["path", "contract"],
+          "properties": {
+            "path": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" },
+            "contract": { "const": "foundation.owner-map/v1" }
+          }
+        },
+        "collections": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 32,
+          "items": {
+            "oneOf": [
+              { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/markdownTreeCollection" },
+              { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/frontmatterReadmeCollection" }
+            ]
+          }
+        },
+        "excludedPrefixes": {
+          "type": "array",
+          "maxItems": 128,
+          "uniqueItems": true,
+          "items": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" }
+        },
+        "metadataSidecar": { "$ref": "#/$defs/metadataSidecar" }
+      }
+    },
+    "metadataSidecar": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "path"],
+      "properties": {
+        "kind": { "const": "path-metadata-map" },
+        "path": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" }
+      }
+    },
+    "authoring": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "artifactTypes"],
+      "properties": {
+        "mode": { "const": "create-only" },
+        "ownerSets": { "$ref": "#/$defs/ownerSets" },
+        "artifactTypes": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 32,
+          "items": { "$ref": "#/$defs/artifactType" }
+        }
+      }
+    },
+    "artifactType": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "initialStatus",
+        "identity",
+        "placement",
+        "template",
+        "heading",
+        "reachability"
+      ],
+      "oneOf": [
+        {
+          "required": ["allowedOwnerIds"],
+          "properties": { "allowedOwnerIds": true }
+        },
+        {
+          "required": ["ownerSetId"],
+          "properties": { "ownerSetId": true }
+        }
+      ],
+      "properties": {
+        "type": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/lowerId" },
+        "initialStatus": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/lowerId" },
+        "identity": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/identity" },
+        "placement": {
+          "oneOf": [
+            { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/collectionPlacement" },
+            { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/qualifiedLeafIndexPlacement" },
+            { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/explicitPlacement" }
+          ]
+        },
+        "template": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "path"],
+          "properties": {
+            "kind": { "const": "fenced-markdown-body" },
+            "path": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" }
+          }
+        },
+        "heading": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind"],
+          "properties": {
+            "kind": { "enum": ["id-colon-title", "title"] }
+          }
+        },
+        "reachability": { "$ref": "#/$defs/reachability" },
+        "allowedOwnerIds": { "$ref": "#/$defs/allowedOwnerIds" },
+        "ownerSetId": { "$ref": "#/$defs/ownerSetId" }
+      }
+    },
+    "ownerSetId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 160,
+      "pattern": "^[a-z0-9][a-z0-9._/-]*$"
+    },
+    "ownerSets": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "sets"],
+      "properties": {
+        "schemaVersion": { "const": 1 },
+        "sets": {
+          "type": "object",
+          "minProperties": 1,
+          "maxProperties": 128,
+          "propertyNames": { "$ref": "#/$defs/ownerSetId" },
+          "additionalProperties": { "$ref": "#/$defs/allowedOwnerIds" }
+        }
+      }
+    },
+    "allowedOwnerIds": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 4096,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 214,
+        "pattern": "^[A-Za-z0-9@][A-Za-z0-9@._/-]*$"
+      }
+    },
+    "reachability": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "indexPath"],
+          "properties": {
+            "kind": { "const": "manual-fixed-index" },
+            "indexPath": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "pathPrefix", "indexBasename"],
+          "properties": {
+            "kind": { "const": "manual-colocated-index" },
+            "pathPrefix": { "const": "before-required-segments" },
+            "indexBasename": { "const": "README.md" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "reason"],
+          "properties": {
+            "kind": { "const": "not-required" },
+            "reason": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 500,
+              "pattern": "^[^\\u0000-\\u001F\\u007F]+$"
+            }
+          }
+        }
+      ]
+    }
+  }
+}