@agent-teams/engineering-foundation 0.6.0 → 0.8.0

package/schemas/scaffold-receipt.schema.json

@@ -0,0 +1,180 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/scaffold-receipt",
+  "title": "Scaffold Receipt",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "protocolVersion", "planDigest", "adapter", "outcome", "commit", "operations", "diagnostics", "receiptDigest"],
+  "properties": {
+    "schemaVersion": { "const": 2 },
+    "protocolVersion": { "const": 2 },
+    "planDigest": { "$ref": "#/$defs/digest" },
+    "adapter": { "$ref": "#/$defs/filesystemAdapter" },
+    "outcome": { "enum": ["already-applied", "applied", "authority-stale", "failed-recovered", "recovery-required", "rejected"] },
+    "commit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state", "atomicity"],
+      "properties": {
+        "state": { "enum": ["committed", "recovered", "recovery-required", "rejected", "rolled-back"] },
+        "atomicity": { "const": "journaled-recoverable" }
+      }
+    },
+    "operations": {
+      "type": "array",
+      "maxItems": 4096,
+      "items": { "$ref": "#/$defs/operationReceipt" }
+    },
+    "diagnostics": { "type": "array", "maxItems": 1024, "items": { "$ref": "#/$defs/diagnostic" } },
+    "receiptDigest": { "$ref": "#/$defs/digest" }
+  },
+  "allOf": [
+    { "$ref": "#/$defs/appliedContract" },
+    { "$ref": "#/$defs/alreadyAppliedContract" },
+    { "$ref": "#/$defs/failedRecoveredContract" },
+    { "$ref": "#/$defs/recoveryRequiredContract" },
+    { "$ref": "#/$defs/rejectedContract" },
+    { "$ref": "#/$defs/authorityStaleContract" }
+  ],
+  "$defs": {
+    "filesystemAdapter": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "contractVersion"],
+      "properties": { "id": { "const": "foundation.filesystem/v1" }, "contractVersion": { "const": 1 } }
+    },
+    "operationReceipt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["operationId", "path", "outcome"],
+      "properties": {
+        "operationId": { "$ref": "#/$defs/id" },
+        "path": { "$ref": "#/$defs/repositoryPath" },
+        "outcome": { "enum": ["already-satisfied", "applied", "conflict", "not-applied", "recovered", "unobserved"] },
+        "resultDigest": { "$ref": "#/$defs/digest" }
+      },
+      "allOf": [
+        {
+          "if": { "type": "object", "properties": { "outcome": { "enum": ["already-satisfied", "applied", "recovered"] } }, "required": ["outcome"] },
+          "then": {
+            "type": "object",
+            "properties": { "resultDigest": { "$ref": "#/$defs/digest" } },
+            "required": ["resultDigest"]
+          }
+        },
+        {
+          "if": { "type": "object", "properties": { "outcome": { "enum": ["conflict", "not-applied", "unobserved"] } }, "required": ["outcome"] },
+          "then": { "type": "object", "properties": { "resultDigest": false } }
+        }
+      ]
+    },
+    "appliedContract": {
+      "if": { "type": "object", "properties": { "outcome": { "const": "applied" } }, "required": ["outcome"] },
+      "then": {
+        "type": "object",
+        "properties": {
+          "adapter": { "$ref": "#/$defs/filesystemAdapter" },
+          "commit": { "type": "object", "properties": { "state": { "const": "committed" } }, "required": ["state"] },
+          "operations": { "$ref": "#/$defs/appliedOperations" }
+        }
+      }
+    },
+    "alreadyAppliedContract": {
+      "if": { "type": "object", "properties": { "outcome": { "const": "already-applied" } }, "required": ["outcome"] },
+      "then": {
+        "type": "object",
+        "properties": {
+          "adapter": { "$ref": "#/$defs/filesystemAdapter" },
+          "commit": { "type": "object", "properties": { "state": { "const": "committed" } }, "required": ["state"] },
+          "operations": { "$ref": "#/$defs/alreadyAppliedOperations" }
+        }
+      }
+    },
+    "failedRecoveredContract": {
+      "if": { "type": "object", "properties": { "outcome": { "const": "failed-recovered" } }, "required": ["outcome"] },
+      "then": {
+        "type": "object",
+        "properties": {
+          "adapter": { "$ref": "#/$defs/filesystemAdapter" },
+          "commit": { "type": "object", "properties": { "state": { "const": "recovered" }, "atomicity": { "const": "journaled-recoverable" } }, "required": ["state", "atomicity"] },
+          "operations": { "$ref": "#/$defs/failedRecoveredOperations" }
+        }
+      }
+    },
+    "recoveryRequiredContract": {
+      "if": { "type": "object", "properties": { "outcome": { "const": "recovery-required" } }, "required": ["outcome"] },
+      "then": {
+        "type": "object",
+        "properties": {
+          "adapter": { "$ref": "#/$defs/filesystemAdapter" },
+          "commit": { "type": "object", "properties": { "state": { "const": "recovery-required" }, "atomicity": { "const": "journaled-recoverable" } }, "required": ["state", "atomicity"] },
+          "operations": { "$ref": "#/$defs/recoveryRequiredOperations" }
+        }
+      }
+    },
+    "rejectedContract": {
+      "if": { "type": "object", "properties": { "outcome": { "const": "rejected" } }, "required": ["outcome"] },
+      "then": {
+        "type": "object",
+        "properties": {
+          "adapter": { "$ref": "#/$defs/filesystemAdapter" },
+          "commit": { "type": "object", "properties": { "state": { "const": "rejected" } }, "required": ["state"] },
+          "operations": { "$ref": "#/$defs/incompleteOperations" }
+        }
+      }
+    },
+    "authorityStaleContract": {
+      "if": { "type": "object", "properties": { "outcome": { "const": "authority-stale" } }, "required": ["outcome"] },
+      "then": {
+        "type": "object",
+        "properties": {
+          "adapter": { "$ref": "#/$defs/filesystemAdapter" },
+          "commit": { "type": "object", "properties": { "state": { "const": "rolled-back" }, "atomicity": { "const": "journaled-recoverable" } }, "required": ["state", "atomicity"] },
+          "operations": { "$ref": "#/$defs/authorityStaleOperations" }
+        }
+      }
+    },
+    "appliedOperations": {
+      "type": "array", "minItems": 1,
+      "prefixItems": [
+        { "type": "object", "required": ["outcome"], "properties": { "outcome": { "const": "applied" } } }
+      ],
+      "items": { "type": "object", "required": ["outcome"], "properties": { "outcome": { "enum": ["already-satisfied", "applied"] } } }
+    },
+    "alreadyAppliedOperations": {
+      "type": "array", "minItems": 1,
+      "items": { "type": "object", "required": ["outcome"], "properties": { "outcome": { "const": "already-satisfied" } } }
+    },
+    "failedRecoveredOperations": {
+      "type": "array", "minItems": 1,
+      "items": { "type": "object", "required": ["outcome"], "properties": { "outcome": { "enum": ["already-satisfied", "recovered"] } } }
+    },
+    "incompleteOperations": {
+      "type": "array", "minItems": 1,
+      "items": { "type": "object", "required": ["outcome"], "properties": { "outcome": { "enum": ["already-satisfied", "conflict", "not-applied"] } } }
+    },
+    "recoveryRequiredOperations": {
+      "type": "array", "minItems": 1,
+      "items": { "type": "object", "required": ["outcome"], "properties": { "outcome": { "enum": ["already-satisfied", "conflict", "not-applied", "unobserved"] } } }
+    },
+    "authorityStaleOperations": {
+      "type": "array", "minItems": 1,
+      "items": { "type": "object", "required": ["outcome"], "properties": { "outcome": { "const": "not-applied" } } }
+    },
+    "id": { "type": "string", "minLength": 1, "maxLength": 214, "pattern": "^[A-Za-z0-9@][A-Za-z0-9@._/-]*$" },
+    "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "repositoryPath": { "type": "string", "minLength": 1, "maxLength": 512, "pattern": "^(?!.*(?:^|/)\\.{1,2}(?:/|$))[A-Za-z0-9._@-]+(?:/[A-Za-z0-9._@-]+)*$" },
+    "diagnostic": {
+      "type": "object", "additionalProperties": false,
+      "required": ["ruleId", "severity", "phase", "subject", "message", "remediation"],
+      "properties": {
+        "ruleId": { "$ref": "#/$defs/id" },
+        "severity": { "enum": ["error", "info", "warning"] },
+        "phase": { "enum": ["apply", "composition", "input", "planning", "policy", "recovery"] },
+        "subject": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "message": { "type": "string", "minLength": 1, "maxLength": 1000 },
+        "remediation": { "type": "string", "minLength": 1, "maxLength": 1000 }
+      }
+    }
+  }
+}

package/schemas/scaffold-recovery-journal.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/scaffold-recovery-journal",
+  "title": "Scaffold Recovery Journal",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "state", "plan", "operations"],
+  "properties": {
+    "schemaVersion": { "const": 2 },
+    "state": { "const": "PREPARED" },
+    "plan": { "$ref": "https://agent-teams.ai/schemas/scaffold-plan" },
+    "operations": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 4096,
+      "items": { "$ref": "#/$defs/operation" }
+    }
+  },
+  "$defs": {
+    "operation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["operationId", "path", "state"],
+      "properties": {
+        "operationId": { "type": "string", "minLength": 1, "maxLength": 214 },
+        "path": { "type": "string", "minLength": 1, "maxLength": 512, "pattern": "^(?!.*(?:^|/)\\.{1,2}(?:/|$))[A-Za-z0-9._@-]+(?:/[A-Za-z0-9._@-]+)*$" },
+        "state": { "enum": ["pending", "publishing", "published", "preexisting"] }
+      }
+    }
+  }
+}

package/schemas/{scaffold-target-catalog/v1.schema.json → scaffold-target-catalog.schema.json}

@@ -1,12 +1,12 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-teams.ai/schemas/scaffold-target-catalog/v1",
-  "title": "Scaffold Target Catalog v1",
+  "$id": "https://agent-teams.ai/schemas/scaffold-target-catalog",
+  "title": "Scaffold Target Catalog",
   "type": "object",
   "additionalProperties": false,
   "required": ["version", "packages"],
   "properties": {
-    "version": { "const": 1 },
+    "version": { "const": 2 },
     "packages": {
       "type": "array",
       "maxItems": 4096,
@@ -20,6 +20,12 @@
       "maxLength": 160,
       "pattern": "^[a-z0-9][a-z0-9._/-]*$"
     },
+    "ownerDocumentId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 160,
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._/-]*$"
+    },
     "repositoryPath": {
       "type": "string",
       "minLength": 1,
@@ -29,7 +35,7 @@
     "target": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["id", "role", "path", "package_name"],
+      "required": ["id", "role", "path", "package_name", "owner_document"],
       "properties": {
         "id": { "$ref": "#/$defs/id" },
         "role": { "$ref": "#/$defs/id" },
@@ -40,12 +46,7 @@
           "maxLength": 214,
           "pattern": "^(?:@[a-z0-9][a-z0-9._-]*/)?[a-z0-9][a-z0-9._-]*$"
         },
-        "owner_document": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 512,
-          "pattern": "^[^\\u0000-\\u001F]+$"
-        }
+        "owner_document": { "$ref": "#/$defs/ownerDocumentId" }
       }
     }
   }

package/schemas/{scaffolding-config/v1.schema.json → scaffolding-config.schema.json}

@@ -1,12 +1,12 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-teams.ai/schemas/scaffolding-config/v1",
-  "title": "Scaffolding Configuration v1",
+  "$id": "https://agent-teams.ai/schemas/scaffolding-config",
+  "title": "Scaffolding Configuration",
   "type": "object",
   "additionalProperties": false,
   "required": ["schemaVersion", "projectId", "targetCatalogPath", "compositions"],
   "properties": {
-    "schemaVersion": { "const": 1 },
+    "schemaVersion": { "const": 2 },
     "projectId": { "$ref": "#/$defs/id" },
     "targetCatalogPath": { "$ref": "#/$defs/repositoryPath" },
     "compositions": {
@@ -59,7 +59,7 @@
     "composition": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["id", "scaffoldProfile", "recipe", "targetRoles", "policies"],
+      "required": ["id", "scaffoldProfile", "recipe", "targetRoles", "authorityVerifiers", "policies"],
       "properties": {
         "id": { "$ref": "#/$defs/id" },
         "scaffoldProfile": { "$ref": "#/$defs/configuredDefinition" },
@@ -70,6 +70,12 @@
           "maxItems": 32,
           "items": { "$ref": "#/$defs/id" }
         },
+        "authorityVerifiers": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 1,
+          "items": { "$ref": "#/$defs/authorityVerifier" }
+        },
         "fixedRecipeParameters": { "$ref": "#/$defs/jsonObject" },
         "defaultRecipeParameters": { "$ref": "#/$defs/jsonObject" },
         "facets": { "$ref": "#/$defs/facetPolicy" },
@@ -80,6 +86,36 @@
         }
       }
     },
+    "authorityVerifier": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "contractVersion", "parameters"],
+      "properties": {
+        "id": { "const": "foundation.markdown-yaml-owner" },
+        "contractVersion": { "const": 1 },
+        "parameters": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["allowedStatuses", "documentRoots"],
+          "properties": {
+            "allowedStatuses": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 16,
+              "uniqueItems": true,
+              "items": { "$ref": "#/$defs/id" }
+            },
+            "documentRoots": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 8,
+              "uniqueItems": true,
+              "items": { "$ref": "#/$defs/repositoryPath" }
+            }
+          }
+        }
+      }
+    },
     "jsonObject": {
       "type": "object",
       "maxProperties": 128,

package/schemas/architecture-source-dependencies/v2.schema.json

@@ -1,102 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.agent-teams.ai/engineering-foundation/architecture-source-dependencies/v2",
-  "title": "Source dependency architecture capability configuration",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["schemaVersion", "workspace", "governedRoots", "boundaries"],
-  "properties": {
-    "schemaVersion": { "const": 2 },
-    "workspace": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["kind", "manifest"],
-      "properties": {
-        "kind": { "const": "pnpm" },
-        "manifest": { "const": "pnpm-workspace.yaml" }
-      }
-    },
-    "governedRoots": {
-      "type": "array",
-      "minItems": 1,
-      "uniqueItems": true,
-      "items": { "$ref": "#/$defs/repositoryDirectory" }
-    },
-    "boundaries": {
-      "type": "array",
-      "minItems": 1,
-      "maxItems": 5000,
-      "items": { "$ref": "#/$defs/boundary" }
-    }
-  },
-  "$defs": {
-    "repositoryDirectory": {
-      "type": "string",
-      "minLength": 1,
-      "maxLength": 240,
-      "pattern": "^(?!/)(?!.*\\\\)(?!.*(?:^|/)\\.{1,2}(?:/|$))[^*?{}[\\]]+$"
-    },
-    "boundaryId": {
-      "type": "string",
-      "minLength": 1,
-      "maxLength": 120,
-      "pattern": "^[a-z0-9](?:[a-z0-9._-]{0,118}[a-z0-9])?$"
-    },
-    "packageName": {
-      "type": "string",
-      "pattern": "^(?:@[a-z0-9][a-z0-9._-]*/)?[a-z0-9][a-z0-9._-]*$"
-    },
-    "builtinName": {
-      "type": "string",
-      "pattern": "^node:[a-z0-9_./-]+$"
-    },
-    "boundary": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["id", "roots", "entrypoints", "allow"],
-      "properties": {
-        "id": { "$ref": "#/$defs/boundaryId" },
-        "roots": {
-          "type": "array",
-          "minItems": 1,
-          "uniqueItems": true,
-          "items": { "$ref": "#/$defs/repositoryDirectory" }
-        },
-        "entrypoints": {
-          "type": "array",
-          "uniqueItems": true,
-          "items": { "$ref": "#/$defs/repositoryDirectory" }
-        },
-        "allow": {
-          "type": "object",
-          "additionalProperties": false,
-          "required": ["boundaries", "packages", "builtins", "runtimeReferences"],
-          "properties": {
-            "boundaries": {
-              "type": "array",
-              "uniqueItems": true,
-              "items": { "$ref": "#/$defs/boundaryId" }
-            },
-            "packages": {
-              "type": "array",
-              "uniqueItems": true,
-              "items": { "$ref": "#/$defs/packageName" }
-            },
-            "builtins": {
-              "type": "array",
-              "uniqueItems": true,
-              "items": { "$ref": "#/$defs/builtinName" }
-            },
-            "runtimeReferences": {
-              "type": "array",
-              "uniqueItems": true,
-              "items": {
-                "enum": ["commonjs", "dynamic", "type-query"]
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-}