@agent-teams/engineering-foundation 0.11.0 → 0.13.0

package/dist/transaction-coordination/application/ports/foundation-operation-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation-operation-lock.js","sourceRoot":"","sources":["../../../../src/transaction-coordination/application/ports/foundation-operation-lock.ts"],"names":[],"mappings":""}

package/dist/transaction-coordination/application/ports/foundation-transaction-slot.d.ts

@@ -0,0 +1,5 @@
+import type { FoundationTransactionStatus } from "../model/transaction-status.js";
+export interface FoundationTransactionSlot {
+    inspect(): Promise<FoundationTransactionStatus>;
+}
+//# sourceMappingURL=foundation-transaction-slot.d.ts.map

package/dist/transaction-coordination/application/ports/foundation-transaction-slot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation-transaction-slot.d.ts","sourceRoot":"","sources":["../../../../src/transaction-coordination/application/ports/foundation-transaction-slot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAElF,MAAM,WAAW,yBAAyB;IACxC,OAAO,IAAI,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACjD"}

package/dist/transaction-coordination/application/ports/foundation-transaction-slot.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=foundation-transaction-slot.js.map

package/dist/transaction-coordination/application/ports/foundation-transaction-slot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation-transaction-slot.js","sourceRoot":"","sources":["../../../../src/transaction-coordination/application/ports/foundation-transaction-slot.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-teams/engineering-foundation",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Versioned engineering policy, tooling, and conformance for Agent Teams repositories.",
   "license": "Apache-2.0",
   "type": "module",
@@ -13,6 +13,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./document-authoring": {
+      "types": "./dist/document-authoring/index.d.ts",
+      "import": "./dist/document-authoring/index.js"
+    },
     "./local-mode": {
       "types": "./dist/local-mode/index.d.ts",
       "import": "./dist/local-mode/index.js"
@@ -34,9 +38,15 @@
     "schemas/contract-protobuf-breaking-qualification/v1.schema.json",
     "schemas/contract-protobuf-evolution-baseline/v1.schema.json",
     "schemas/contract-protobuf-evolution/v1.schema.json",
+    "schemas/document-authoring-profile/v1.schema.json",
+    "schemas/document-command-envelope/v1.schema.json",
+    "schemas/document-intent/v1.schema.json",
+    "schemas/document-plan/v1.schema.json",
+    "schemas/document-receipt/v1.schema.json",
     "schemas/documentation-local-references/v1.schema.json",
     "schemas/foundation-check-report/v1.schema.json",
     "schemas/foundation-config/v1.schema.json",
+    "schemas/foundation-transaction-envelope/v2.schema.json",
     "schemas/governance-architecture-decision-baseline/v1.schema.json",
     "schemas/governance-architecture-decisions/v1.schema.json",
     "schemas/package-public-api-baseline/v1.schema.json",

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

@@ -0,0 +1,186 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/document-authoring-profile/v1",
+  "title": "Document Authoring Profile",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "projectId", "catalog", "authoring"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "projectId": { "$ref": "#/$defs/lowerId" },
+    "catalog": { "$ref": "#/$defs/catalog" },
+    "authoring": { "$ref": "#/$defs/authoring" }
+  },
+  "$defs": {
+    "lowerId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 160,
+      "pattern": "^[a-z0-9][a-z0-9._/-]*$"
+    },
+    "repositoryPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "pattern": "^(?!.*(?:^|/)\\.{1,2}(?:/|$))(?!.*\\.(?:/|$))(?!.*(?:^|/)(?:[Cc][Oo][Nn]|[Pp][Rr][Nn]|[Aa][Uu][Xx]|[Nn][Uu][Ll]|[Cc][Oo][Mm][1-9]|[Ll][Pp][Tt][1-9])(?:\\.[A-Za-z0-9._@-]*)?(?:/|$))[A-Za-z0-9._@-]+(?:/[A-Za-z0-9._@-]+)*$"
+    },
+    "catalog": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["metadataSchemaPath", "ownerCatalog", "collections"],
+      "properties": {
+        "metadataSchemaPath": { "$ref": "#/$defs/repositoryPath" },
+        "ownerCatalog": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["path", "contract"],
+          "properties": {
+            "path": { "$ref": "#/$defs/repositoryPath" },
+            "contract": { "const": "foundation.owner-map/v1" }
+          }
+        },
+        "collections": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 32,
+          "items": {
+            "oneOf": [
+              { "$ref": "#/$defs/markdownTreeCollection" },
+              { "$ref": "#/$defs/frontmatterReadmeCollection" }
+            ]
+          }
+        },
+        "excludedPrefixes": {
+          "type": "array",
+          "maxItems": 128,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/repositoryPath" }
+        }
+      }
+    },
+    "markdownTreeCollection": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "root"],
+      "properties": {
+        "kind": { "const": "markdown-tree" },
+        "root": { "$ref": "#/$defs/repositoryPath" }
+      }
+    },
+    "frontmatterReadmeCollection": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "roots"],
+      "properties": {
+        "kind": { "const": "frontmatter-readme" },
+        "roots": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 32,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/repositoryPath" }
+        }
+      }
+    },
+    "authoring": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "artifactTypes"],
+      "properties": {
+        "mode": { "const": "create-only" },
+        "artifactTypes": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 32,
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/artifactType" }
+        }
+      }
+    },
+    "artifactType": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "initialStatus", "identity", "placement", "template", "heading"],
+      "properties": {
+        "type": { "$ref": "#/$defs/lowerId" },
+        "initialStatus": { "$ref": "#/$defs/lowerId" },
+        "identity": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "format"],
+          "properties": {
+            "kind": { "const": "explicit" },
+            "format": { "enum": ["adr-four-digits", "open-decision-three-digits", "qualified"] }
+          }
+        },
+        "placement": {
+          "oneOf": [
+            { "$ref": "#/$defs/collectionPlacement" },
+            { "$ref": "#/$defs/qualifiedLeafIndexPlacement" },
+            { "$ref": "#/$defs/explicitPlacement" }
+          ]
+        },
+        "template": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "path"],
+          "properties": {
+            "kind": { "const": "fenced-markdown-body" },
+            "path": { "$ref": "#/$defs/repositoryPath" }
+          }
+        },
+        "heading": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind"],
+          "properties": { "kind": { "enum": ["id-colon-title", "title"] } }
+        }
+      }
+    },
+    "collectionPlacement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "directory", "filename"],
+      "properties": {
+        "kind": { "const": "collection" },
+        "directory": { "$ref": "#/$defs/repositoryPath" },
+        "filename": { "enum": ["numeric-id-slug", "id-slug", "slug", "README.md"] }
+      }
+    },
+    "qualifiedLeafIndexPlacement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "allowedRoots", "requiredSegmentsInOrder", "requiredBasename"],
+      "properties": {
+        "kind": { "const": "qualified-leaf-index" },
+        "allowedRoots": { "$ref": "#/$defs/pathList" },
+        "requiredSegmentsInOrder": { "$ref": "#/$defs/pathSegmentList" },
+        "requiredBasename": { "const": "README.md" }
+      }
+    },
+    "explicitPlacement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "allowedRoots", "requiredSegmentsInOrder", "requiredBasename"],
+      "properties": {
+        "kind": { "const": "explicit" },
+        "allowedRoots": { "$ref": "#/$defs/pathList" },
+        "requiredSegmentsInOrder": { "$ref": "#/$defs/pathSegmentList" },
+        "requiredBasename": { "enum": ["README.md"] }
+      }
+    },
+    "pathList": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 32,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/repositoryPath" }
+    },
+    "pathSegmentList": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 16,
+      "items": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[A-Za-z0-9._@-]+$" }
+    }
+  }
+}

package/schemas/document-command-envelope/v1.schema.json

@@ -0,0 +1,161 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/document-command-envelope/v1",
+  "title": "Document Command Envelope",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "command", "outcome", "diagnostics", "result"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "command": { "enum": ["docs.doctor", "docs.find", "docs.new", "docs.recover"] },
+    "outcome": { "enum": ["success", "partial", "conflict", "violation", "authority-stale", "recovery-required", "invalid-input", "execution-failure", "cancelled"] },
+    "diagnostics": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/diagnostic" } },
+    "result": {
+      "oneOf": [
+        { "$ref": "#/$defs/findResult" },
+        { "$ref": "#/$defs/newResult" },
+        { "$ref": "#/$defs/doctorResult" },
+        { "$ref": "#/$defs/recoverResult" }
+      ]
+    }
+  },
+  "allOf": [
+    { "$ref": "#/$defs/findEnvelope" },
+    { "$ref": "#/$defs/newEnvelope" },
+    { "$ref": "#/$defs/doctorEnvelope" },
+    { "$ref": "#/$defs/recoverEnvelope" }
+  ],
+  "$defs": {
+    "opaqueId": { "type": "string", "minLength": 1, "maxLength": 214, "pattern": "^[A-Za-z0-9@][A-Za-z0-9@._/-]*$" },
+    "lowerId": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[a-z0-9][a-z0-9._/-]*$" },
+    "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "semver": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$" },
+    "repositoryPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "pattern": "^(?!.*(?:^|/)\\.{1,2}(?:/|$))(?!.*\\.(?:/|$))(?!.*(?:^|/)(?:[Cc][Oo][Nn]|[Pp][Rr][Nn]|[Aa][Uu][Xx]|[Nn][Uu][Ll]|[Cc][Oo][Mm][1-9]|[Ll][Pp][Tt][1-9])(?:\\.[A-Za-z0-9._@-]*)?(?:/|$))[A-Za-z0-9._@-]+(?:/[A-Za-z0-9._@-]+)*$"
+    },
+    "documentDescriptor": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "type", "status", "owner", "summary", "repositoryPath", "title", "source"],
+      "properties": {
+        "id": { "$ref": "#/$defs/opaqueId" },
+        "type": { "$ref": "#/$defs/lowerId" },
+        "status": { "$ref": "#/$defs/lowerId" },
+        "owner": { "$ref": "#/$defs/opaqueId" },
+        "summary": { "type": "string", "minLength": 1, "maxLength": 1000 },
+        "repositoryPath": { "$ref": "#/$defs/repositoryPath" },
+        "title": { "type": "string", "minLength": 1, "maxLength": 240 },
+        "source": { "enum": ["frontmatter-readme", "markdown-tree"] }
+      }
+    },
+    "findResult": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "matches", "documents"],
+      "properties": {
+        "kind": { "const": "find" },
+        "matches": { "type": "integer", "minimum": 0, "maximum": 100000 },
+        "documents": { "type": "array", "maxItems": 2048, "items": { "$ref": "#/$defs/documentDescriptor" } }
+      }
+    },
+    "newResult": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "documentPath", "reachability"],
+      "properties": {
+        "kind": { "const": "new" },
+        "documentPath": { "$ref": "#/$defs/repositoryPath" },
+        "reachability": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["state"],
+          "properties": {
+            "state": { "enum": ["manual-required", "managed", "not-required"] },
+            "indexPath": { "$ref": "#/$defs/repositoryPath" },
+            "markdownLink": { "type": "string", "minLength": 1, "maxLength": 1024 }
+          },
+          "allOf": [
+            {
+              "if": { "type": "object", "properties": { "state": { "const": "manual-required" } }, "required": ["state"] },
+              "then": {
+                "type": "object",
+                "required": ["indexPath", "markdownLink"],
+                "properties": {
+                  "indexPath": { "$ref": "#/$defs/repositoryPath" },
+                  "markdownLink": { "type": "string", "minLength": 1, "maxLength": 1024 }
+                }
+              }
+            }
+          ]
+        }
+      }
+    },
+    "doctorResult": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "transactionState", "recoveryClass"],
+      "properties": {
+        "kind": { "const": "doctor" },
+        "transactionState": { "enum": ["none", "pending", "tampered", "unknown-version"] },
+        "protocolKind": { "enum": ["document-authoring", "scaffolding"] },
+        "foundationVersion": { "$ref": "#/$defs/semver" },
+        "recoveryClass": { "enum": ["auto-recoverable", "manual", "not-required"] }
+      }
+    },
+    "recoverResult": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "transactionState"],
+      "properties": {
+        "kind": { "const": "recover" },
+        "transactionState": { "enum": ["already-applied", "manual-required", "no-pending-transaction", "recovered"] },
+        "receiptDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "findEnvelope": {
+      "if": { "type": "object", "properties": { "command": { "const": "docs.find" } }, "required": ["command"] },
+      "then": { "type": "object", "properties": { "result": { "$ref": "#/$defs/findResult" } } }
+    },
+    "newEnvelope": {
+      "if": { "type": "object", "properties": { "command": { "const": "docs.new" } }, "required": ["command"] },
+      "then": { "type": "object", "properties": { "result": { "$ref": "#/$defs/newResult" } } }
+    },
+    "doctorEnvelope": {
+      "if": { "type": "object", "properties": { "command": { "const": "docs.doctor" } }, "required": ["command"] },
+      "then": { "type": "object", "properties": { "result": { "$ref": "#/$defs/doctorResult" } } }
+    },
+    "recoverEnvelope": {
+      "if": { "type": "object", "properties": { "command": { "const": "docs.recover" } }, "required": ["command"] },
+      "then": { "type": "object", "properties": { "result": { "$ref": "#/$defs/recoverResult" } } }
+    },
+    "diagnostic": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ruleId", "severity", "phase", "subject", "message"],
+      "properties": {
+        "ruleId": { "$ref": "#/$defs/opaqueId" },
+        "severity": { "enum": ["error", "info", "warning"] },
+        "phase": { "enum": ["apply", "authority", "input", "planning", "query", "recovery"] },
+        "subject": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "message": { "type": "string", "minLength": 1, "maxLength": 1000 },
+        "remediation": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["commandId", "args"],
+          "properties": {
+            "commandId": { "enum": ["docs.doctor", "docs.find", "docs.new", "docs.recover"] },
+            "args": {
+              "type": "object",
+              "maxProperties": 16,
+              "propertyNames": { "pattern": "^[a-z][a-zA-Z0-9]*$", "maxLength": 64 },
+              "additionalProperties": { "type": "string", "maxLength": 512 }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/document-intent/v1.schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/document-intent/v1",
+  "title": "Document Intent",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "type", "id", "title", "owner", "summary"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "type": { "$ref": "#/$defs/lowerId" },
+    "id": { "$ref": "#/$defs/opaqueId" },
+    "title": { "$ref": "#/$defs/title" },
+    "owner": { "$ref": "#/$defs/opaqueId" },
+    "summary": { "type": "string", "minLength": 1, "maxLength": 1000 },
+    "related": {
+      "type": "array",
+      "maxItems": 128,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/opaqueId" }
+    },
+    "additionalMetadata": { "$ref": "#/$defs/jsonObject1" }
+  },
+  "$defs": {
+    "lowerId": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[a-z0-9][a-z0-9._/-]*$" },
+    "opaqueId": { "type": "string", "minLength": 1, "maxLength": 214, "pattern": "^[A-Za-z0-9@][A-Za-z0-9@._/-]*$" },
+    "title": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[^\\u0000-\\u001F\\u007F]+$" },
+    "jsonScalar": {
+      "oneOf": [
+        { "type": "null" },
+        { "type": "boolean" },
+        { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 },
+        { "type": "string", "maxLength": 4096 }
+      ]
+    },
+    "jsonObject1": { "type": "object", "maxProperties": 64, "additionalProperties": { "$ref": "#/$defs/jsonValue1" } },
+    "jsonValue1": {
+      "oneOf": [
+        { "$ref": "#/$defs/jsonScalar" },
+        { "type": "array", "maxItems": 128, "items": { "$ref": "#/$defs/jsonValue2" } },
+        { "$ref": "#/$defs/jsonObject2" }
+      ]
+    },
+    "jsonObject2": { "type": "object", "maxProperties": 64, "additionalProperties": { "$ref": "#/$defs/jsonValue2" } },
+    "jsonValue2": {
+      "oneOf": [
+        { "$ref": "#/$defs/jsonScalar" },
+        { "type": "array", "maxItems": 128, "items": { "$ref": "#/$defs/jsonValue3" } },
+        { "$ref": "#/$defs/jsonObject3" }
+      ]
+    },
+    "jsonObject3": { "type": "object", "maxProperties": 64, "additionalProperties": { "$ref": "#/$defs/jsonValue3" } },
+    "jsonValue3": {
+      "oneOf": [
+        { "$ref": "#/$defs/jsonScalar" },
+        { "type": "array", "maxItems": 128, "items": { "$ref": "#/$defs/jsonScalar" } },
+        { "type": "object", "maxProperties": 64, "additionalProperties": { "$ref": "#/$defs/jsonScalar" } }
+      ]
+    }
+  }
+}

package/schemas/document-plan/v1.schema.json

@@ -0,0 +1,146 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/document-plan/v1",
+  "title": "Document Plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "protocolVersion", "compiler", "projectId", "intent", "intentDigest", "authority", "selectedOwner", "identityProjection", "referencedDocuments", "destination", "expectedParent", "destinationPrecondition", "output", "requiredAdapterCapabilities", "diagnostics", "planDigest"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "protocolVersion": { "const": 1 },
+    "compiler": { "$ref": "#/$defs/compiler" },
+    "projectId": { "$ref": "#/$defs/lowerId" },
+    "intent": { "$ref": "https://agent-teams.ai/schemas/document-intent/v1" },
+    "intentDigest": { "$ref": "#/$defs/digest" },
+    "authority": { "$ref": "#/$defs/authority" },
+    "selectedOwner": { "$ref": "#/$defs/selectedOwner" },
+    "identityProjection": { "$ref": "#/$defs/identityProjection" },
+    "referencedDocuments": {
+      "type": "array",
+      "maxItems": 128,
+      "items": { "$ref": "#/$defs/referencedDocument" }
+    },
+    "destination": { "$ref": "#/$defs/repositoryPath" },
+    "expectedParent": { "$ref": "#/$defs/expectedParent" },
+    "destinationPrecondition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state"],
+      "properties": { "state": { "const": "absent" } }
+    },
+    "output": { "$ref": "#/$defs/output" },
+    "requiredAdapterCapabilities": {
+      "type": "array",
+      "prefixItems": [{ "const": "create-file-no-replace/v1" }],
+      "minItems": 1,
+      "maxItems": 1
+    },
+    "diagnostics": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/diagnostic" } },
+    "planDigest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "lowerId": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[a-z0-9][a-z0-9._/-]*$" },
+    "opaqueId": { "type": "string", "minLength": 1, "maxLength": 214, "pattern": "^[A-Za-z0-9@][A-Za-z0-9@._/-]*$" },
+    "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "semver": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$" },
+    "repositoryPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "pattern": "^(?!.*(?:^|/)\\.{1,2}(?:/|$))(?!.*\\.(?:/|$))(?!.*(?:^|/)(?:[Cc][Oo][Nn]|[Pp][Rr][Nn]|[Aa][Uu][Xx]|[Nn][Uu][Ll]|[Cc][Oo][Mm][1-9]|[Ll][Pp][Tt][1-9])(?:\\.[A-Za-z0-9._@-]*)?(?:/|$))[A-Za-z0-9._@-]+(?:/[A-Za-z0-9._@-]+)*$"
+    },
+    "compiler": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version", "buildIdentity"],
+      "properties": {
+        "id": { "const": "@agent-teams/engineering-foundation" },
+        "version": { "$ref": "#/$defs/semver" },
+        "buildIdentity": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "authoritySource": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "digest", "size"],
+      "properties": {
+        "path": { "$ref": "#/$defs/repositoryPath" },
+        "digest": { "$ref": "#/$defs/digest" },
+        "size": { "type": "integer", "minimum": 1, "maximum": 4194304 }
+      }
+    },
+    "authority": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["profile", "metadataSchema", "ownerCatalog", "template"],
+      "properties": {
+        "profile": { "$ref": "#/$defs/authoritySource" },
+        "metadataSchema": { "$ref": "#/$defs/authoritySource" },
+        "ownerCatalog": { "$ref": "#/$defs/authoritySource" },
+        "template": { "$ref": "#/$defs/authoritySource" }
+      }
+    },
+    "selectedOwner": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "membershipDigest"],
+      "properties": {
+        "id": { "$ref": "#/$defs/opaqueId" },
+        "membershipDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "identityProjection": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["entryCount", "digest"],
+      "properties": {
+        "entryCount": { "type": "integer", "minimum": 0, "maximum": 100000 },
+        "digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "referencedDocument": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "path", "projectionDigest"],
+      "properties": {
+        "id": { "$ref": "#/$defs/opaqueId" },
+        "path": { "$ref": "#/$defs/repositoryPath" },
+        "projectionDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "expectedParent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "state", "ancestry"],
+      "properties": {
+        "path": { "$ref": "#/$defs/repositoryPath" },
+        "state": { "const": "directory" },
+        "ancestry": { "const": "real-directories" }
+      }
+    },
+    "output": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["digest", "size", "mode", "mediaType", "contentBase64"],
+      "properties": {
+        "digest": { "$ref": "#/$defs/digest" },
+        "size": { "type": "integer", "minimum": 1, "maximum": 1048576 },
+        "mode": { "const": "0644" },
+        "mediaType": { "const": "text/markdown; charset=utf-8" },
+        "contentBase64": { "type": "string", "minLength": 4, "maxLength": 1398104, "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$" }
+      }
+    },
+    "diagnostic": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ruleId", "severity", "phase", "subject", "message"],
+      "properties": {
+        "ruleId": { "$ref": "#/$defs/opaqueId" },
+        "severity": { "enum": ["error", "info", "warning"] },
+        "phase": { "enum": ["authority", "input", "planning", "policy"] },
+        "subject": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "message": { "type": "string", "minLength": 1, "maxLength": 1000 }
+      }
+    }
+  }
+}