@agent-teams/engineering-foundation 0.13.1 → 0.14.0

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

@@ -22,7 +22,7 @@
       "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._@-]+)*$"
+      "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._@-]{1,255}(?:/[A-Za-z0-9._@-]{1,255})*$"
     },
     "catalog": {
       "type": "object",
@@ -104,15 +104,7 @@
       "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"] }
-          }
-        },
+        "identity": { "$ref": "#/$defs/identity" },
         "placement": {
           "oneOf": [
             { "$ref": "#/$defs/collectionPlacement" },
@@ -137,6 +129,62 @@
         }
       }
     },
+    "identity": {
+      "oneOf": [
+        { "$ref": "#/$defs/adrIdentity" },
+        { "$ref": "#/$defs/openDecisionIdentity" },
+        { "$ref": "#/$defs/qualifiedIdentity" }
+      ]
+    },
+    "adrIdentity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "format"],
+      "properties": {
+        "kind": { "const": "explicit" },
+        "format": { "const": "adr-four-digits" }
+      }
+    },
+    "openDecisionIdentity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "format"],
+      "properties": {
+        "kind": { "const": "explicit" },
+        "format": { "const": "open-decision-three-digits" }
+      }
+    },
+    "qualifiedIdentity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "format", "grammar"],
+      "properties": {
+        "kind": { "const": "explicit" },
+        "format": { "const": "qualified" },
+        "grammar": { "$ref": "#/$defs/qualifiedIdentityGrammar" }
+      }
+    },
+    "qualifiedIdentityGrammar": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["prefixSegments", "minSuffixSegments", "maxSuffixSegments"],
+      "properties": {
+        "prefixSegments": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 8,
+          "items": { "$ref": "#/$defs/qualifiedIdentitySegment" }
+        },
+        "minSuffixSegments": { "type": "integer", "minimum": 1, "maximum": 16 },
+        "maxSuffixSegments": { "type": "integer", "minimum": 1, "maximum": 16 }
+      }
+    },
+    "qualifiedIdentitySegment": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 80,
+      "pattern": "^[a-z][a-z0-9-]*$"
+    },
     "collectionPlacement": {
       "type": "object",
       "additionalProperties": false,
@@ -150,23 +198,24 @@
     "qualifiedLeafIndexPlacement": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["kind", "allowedRoots", "requiredSegmentsInOrder", "requiredBasename"],
+      "required": ["kind", "root", "requiredBasename"],
       "properties": {
         "kind": { "const": "qualified-leaf-index" },
-        "allowedRoots": { "$ref": "#/$defs/pathList" },
-        "requiredSegmentsInOrder": { "$ref": "#/$defs/pathSegmentList" },
+        "root": { "$ref": "#/$defs/repositoryPath" },
         "requiredBasename": { "const": "README.md" }
       }
     },
     "explicitPlacement": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["kind", "allowedRoots", "requiredSegmentsInOrder", "requiredBasename"],
+      "required": ["kind", "allowedRoots", "requiredSegmentsInOrder", "requiredBasename", "minimumSegmentsBeforeRequired", "minimumSegmentsAfterRequired"],
       "properties": {
         "kind": { "const": "explicit" },
         "allowedRoots": { "$ref": "#/$defs/pathList" },
         "requiredSegmentsInOrder": { "$ref": "#/$defs/pathSegmentList" },
-        "requiredBasename": { "enum": ["README.md"] }
+        "requiredBasename": { "enum": ["README.md"] },
+        "minimumSegmentsBeforeRequired": { "type": "integer", "minimum": 0, "maximum": 16 },
+        "minimumSegmentsAfterRequired": { "type": "integer", "minimum": 0, "maximum": 16 }
       }
     },
     "pathList": {

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

@@ -34,7 +34,7 @@
       "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._@-]+)*$"
+      "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._@-]{1,255}(?:/[A-Za-z0-9._@-]{1,255})*$"
     },
     "documentDescriptor": {
       "type": "object",

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

@@ -11,7 +11,9 @@
     "id": { "$ref": "#/$defs/opaqueId" },
     "title": { "$ref": "#/$defs/title" },
     "owner": { "$ref": "#/$defs/opaqueId" },
-    "summary": { "type": "string", "minLength": 1, "maxLength": 1000 },
+    "summary": { "$ref": "#/$defs/summary" },
+    "slug": { "$ref": "#/$defs/slug" },
+    "destination": { "$ref": "#/$defs/repositoryPath" },
     "related": {
       "type": "array",
       "maxItems": 128,
@@ -24,15 +26,40 @@
     "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]+$" },
+    "summary": { "type": "string", "minLength": 1, "maxLength": 1000, "pattern": "^[^\\u0000-\\u001F\\u007F]+$" },
+    "slug": { "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._@-]{1,255}(?:/[A-Za-z0-9._@-]{1,255})*$"
+    },
+    "metadataKey": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64,
+      "pattern": "^(?!(?:__proto__|prototype|constructor)$)[A-Za-z_][A-Za-z0-9_-]*$"
+    },
+    "additionalMetadataKey": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64,
+      "pattern": "^(?!(?:id|type|status|owner|summary|title|slug|destination|related|__proto__|prototype|constructor)$)[A-Za-z_][A-Za-z0-9_-]*$"
+    },
     "jsonScalar": {
       "oneOf": [
         { "type": "null" },
         { "type": "boolean" },
         { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 },
-        { "type": "string", "maxLength": 4096 }
+        { "type": "string", "maxLength": 4096, "pattern": "^[^\\u0000-\\u001F\\u007F]*$" }
       ]
     },
-    "jsonObject1": { "type": "object", "maxProperties": 64, "additionalProperties": { "$ref": "#/$defs/jsonValue1" } },
+    "jsonObject1": {
+      "type": "object",
+      "maxProperties": 64,
+      "propertyNames": { "$ref": "#/$defs/additionalMetadataKey" },
+      "additionalProperties": { "$ref": "#/$defs/jsonValue1" }
+    },
     "jsonValue1": {
       "oneOf": [
         { "$ref": "#/$defs/jsonScalar" },
@@ -40,7 +67,12 @@
         { "$ref": "#/$defs/jsonObject2" }
       ]
     },
-    "jsonObject2": { "type": "object", "maxProperties": 64, "additionalProperties": { "$ref": "#/$defs/jsonValue2" } },
+    "jsonObject2": {
+      "type": "object",
+      "maxProperties": 64,
+      "propertyNames": { "$ref": "#/$defs/metadataKey" },
+      "additionalProperties": { "$ref": "#/$defs/jsonValue2" }
+    },
     "jsonValue2": {
       "oneOf": [
         { "$ref": "#/$defs/jsonScalar" },
@@ -48,12 +80,22 @@
         { "$ref": "#/$defs/jsonObject3" }
       ]
     },
-    "jsonObject3": { "type": "object", "maxProperties": 64, "additionalProperties": { "$ref": "#/$defs/jsonValue3" } },
+    "jsonObject3": {
+      "type": "object",
+      "maxProperties": 64,
+      "propertyNames": { "$ref": "#/$defs/metadataKey" },
+      "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" } }
+        {
+          "type": "object",
+          "maxProperties": 64,
+          "propertyNames": { "$ref": "#/$defs/metadataKey" },
+          "additionalProperties": { "$ref": "#/$defs/jsonScalar" }
+        }
       ]
     }
   }

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

@@ -47,7 +47,13 @@
       "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._@-]+)*$"
+      "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._@-]{1,255}(?:/[A-Za-z0-9._@-]{1,255})*$"
+    },
+    "repositoryParentPath": {
+      "oneOf": [
+        { "const": "." },
+        { "$ref": "#/$defs/repositoryPath" }
+      ]
     },
     "compiler": {
       "type": "object",
@@ -66,7 +72,17 @@
       "properties": {
         "path": { "$ref": "#/$defs/repositoryPath" },
         "digest": { "$ref": "#/$defs/digest" },
-        "size": { "type": "integer", "minimum": 1, "maximum": 4194304 }
+        "size": { "type": "integer", "minimum": 1, "maximum": 1048576 }
+      }
+    },
+    "templateAuthoritySource": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "digest", "size"],
+      "properties": {
+        "path": { "$ref": "#/$defs/repositoryPath" },
+        "digest": { "$ref": "#/$defs/digest" },
+        "size": { "type": "integer", "minimum": 1, "maximum": 262144 }
       }
     },
     "authority": {
@@ -77,7 +93,7 @@
         "profile": { "$ref": "#/$defs/authoritySource" },
         "metadataSchema": { "$ref": "#/$defs/authoritySource" },
         "ownerCatalog": { "$ref": "#/$defs/authoritySource" },
-        "template": { "$ref": "#/$defs/authoritySource" }
+        "template": { "$ref": "#/$defs/templateAuthoritySource" }
       }
     },
     "selectedOwner": {
@@ -113,7 +129,7 @@
       "additionalProperties": false,
       "required": ["path", "state", "ancestry"],
       "properties": {
-        "path": { "$ref": "#/$defs/repositoryPath" },
+        "path": { "$ref": "#/$defs/repositoryParentPath" },
         "state": { "const": "directory" },
         "ancestry": { "const": "real-directories" }
       }

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

@@ -38,7 +38,7 @@
       "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._@-]+)*$"
+      "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._@-]{1,255}(?:/[A-Za-z0-9._@-]{1,255})*$"
     },
     "commitObservation": {
       "type": "object",

package/schemas/foundation-transaction-envelope/v2.schema.json

@@ -44,7 +44,7 @@
       "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._@-]+)*$"
+      "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._@-]{1,255}(?:/[A-Za-z0-9._@-]{1,255})*$"
     },
     "documentJournal": {
       "type": "object",
@@ -65,14 +65,32 @@
         "ownedTemporary": {
           "type": "object",
           "additionalProperties": false,
-          "required": ["path", "digest"],
+          "required": ["path", "digest", "identity"],
           "properties": {
             "path": { "$ref": "#/$defs/repositoryPath" },
-            "digest": { "$ref": "#/$defs/digest" }
+            "digest": { "$ref": "#/$defs/digest" },
+            "identity": { "$ref": "#/$defs/nodeTemporaryIdentity" }
           }
         }
       }
     },
+    "nodeTemporaryIdentity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["adapter", "version", "dev", "ino", "birthtimeNs"],
+      "properties": {
+        "adapter": { "const": "node-filesystem" },
+        "version": { "const": 1 },
+        "dev": { "$ref": "#/$defs/unsignedDecimal" },
+        "ino": { "$ref": "#/$defs/unsignedDecimal" },
+        "birthtimeNs": { "$ref": "#/$defs/unsignedDecimal" }
+      }
+    },
+    "unsignedDecimal": {
+      "type": "string",
+      "pattern": "^(?:0|[1-9][0-9]*)$",
+      "maxLength": 32
+    },
     "documentAuthoringEnvelope": {
       "if": { "type": "object", "properties": { "operationKind": { "const": "document-authoring" } }, "required": ["operationKind"] },
       "then": {