@agent-teams/engineering-foundation 0.4.0 → 0.5.0

package/schemas/repository-agent-workflow/v1.schema.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.agent-teams.ai/engineering-foundation/repository-agent-workflow/v1",
+  "title": "Portable repository agent workflow policy",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "instructions",
+    "scripts",
+    "changedChecks",
+    "fullScanPaths"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "instructions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["canonical", "claude", "gemini", "copilot"],
+      "properties": {
+        "canonical": { "$ref": "#/$defs/repositoryPath" },
+        "claude": { "$ref": "#/$defs/repositoryPath" },
+        "gemini": { "$ref": "#/$defs/repositoryPath" },
+        "copilot": { "$ref": "#/$defs/repositoryPath" }
+      }
+    },
+    "scripts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["changed", "fast", "full"],
+      "properties": {
+        "changed": { "$ref": "#/$defs/scriptName" },
+        "fast": { "$ref": "#/$defs/scriptName" },
+        "full": { "$ref": "#/$defs/scriptName" }
+      }
+    },
+    "changedChecks": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 8,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "script", "extensions"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]{0,62}$"
+          },
+          "script": { "$ref": "#/$defs/scriptName" },
+          "extensions": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 32,
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "pattern": "^\\.[A-Za-z0-9][A-Za-z0-9.-]{0,15}$"
+            }
+          },
+          "passPaths": {
+            "type": "boolean",
+            "default": true
+          }
+        }
+      }
+    },
+    "fullScanPaths": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 64,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/repositoryPath" }
+    }
+  },
+  "$defs": {
+    "repositoryPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 240,
+      "pattern": "^(?!/)(?!.*\\\\)(?!.*(?:^|/)\\.\\.(?:/|$))[^\\u0000]+$"
+    },
+    "scriptName": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 80,
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9:_-]*$"
+    }
+  }
+}

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

@@ -0,0 +1,60 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/scaffold-intent/v1",
+  "title": "Scaffold Intent v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "compositionId", "targetRef"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "compositionId": { "$ref": "#/$defs/id" },
+    "targetRef": { "$ref": "#/$defs/id" },
+    "recipeParameters": { "$ref": "#/$defs/jsonObject" },
+    "facets": {
+      "type": "array",
+      "maxItems": 32,
+      "items": { "$ref": "#/$defs/configuredDefinition" }
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 160,
+      "pattern": "^[a-z0-9][a-z0-9._/-]*$"
+    },
+    "definitionRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "contractVersion"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "contractVersion": { "type": "integer", "minimum": 1, "maximum": 2147483647 }
+      }
+    },
+    "configuredDefinition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ref"],
+      "properties": {
+        "ref": { "$ref": "#/$defs/definitionRef" },
+        "parameters": { "$ref": "#/$defs/jsonObject" }
+      }
+    },
+    "jsonObject": {
+      "type": "object",
+      "maxProperties": 128,
+      "additionalProperties": { "$ref": "#/$defs/jsonValue" }
+    },
+    "jsonValue": {
+      "oneOf": [
+        { "type": "null" },
+        { "type": "boolean" },
+        { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 },
+        { "type": "string", "maxLength": 65536 },
+        { "type": "array", "maxItems": 1024, "items": { "$ref": "#/$defs/jsonValue" } },
+        { "$ref": "#/$defs/jsonObject" }
+      ]
+    }
+  }
+}

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

@@ -0,0 +1,250 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/scaffold-plan/v1",
+  "title": "Scaffold Plan v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "protocolVersion", "compiler", "projectId", "authority", "intent", "intentDigest", "authoritySnapshotDigest", "composition", "definitions", "resolved", "target", "readSet", "requiredAdapterCapabilities", "operations", "diagnostics", "planDigest"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "protocolVersion": { "const": 1 },
+    "compiler": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version"],
+      "properties": {
+        "id": { "const": "@agent-teams/engineering-foundation" },
+        "version": { "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-]+)*)?$" }
+      }
+    },
+    "projectId": { "$ref": "#/$defs/authorityId" },
+    "authority": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["configPath", "targetCatalogPath"],
+      "properties": {
+        "configPath": { "$ref": "#/$defs/repositoryPath" },
+        "targetCatalogPath": { "$ref": "#/$defs/repositoryPath" }
+      }
+    },
+    "intent": { "$ref": "#/$defs/intent" },
+    "intentDigest": { "$ref": "#/$defs/digest" },
+    "authoritySnapshotDigest": { "$ref": "#/$defs/digest" },
+    "composition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "scaffoldProfile", "recipe", "facets", "policies"],
+      "properties": {
+        "id": { "$ref": "#/$defs/authorityId" },
+        "scaffoldProfile": { "$ref": "#/$defs/definitionRef" },
+        "recipe": { "$ref": "#/$defs/definitionRef" },
+        "facets": { "type": "array", "maxItems": 32, "items": { "$ref": "#/$defs/definitionRef" } },
+        "policies": { "type": "array", "maxItems": 32, "items": { "$ref": "#/$defs/definitionRef" } }
+      }
+    },
+    "definitions": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 128,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["kind", "ref", "contractDigest"],
+        "properties": {
+          "kind": { "enum": ["facet", "policy", "recipe", "scaffold-profile"] },
+          "ref": { "$ref": "#/$defs/definitionRef" },
+          "contractDigest": { "$ref": "#/$defs/digest" }
+        }
+      }
+    },
+    "resolved": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["profileParameters", "recipeParameters", "facets", "policies"],
+      "properties": {
+        "profileParameters": { "$ref": "#/$defs/jsonObject" },
+        "recipeParameters": { "$ref": "#/$defs/jsonObject" },
+        "facets": {
+          "type": "array",
+          "maxItems": 32,
+          "items": { "$ref": "#/$defs/resolvedDefinition" }
+        },
+        "policies": {
+          "type": "array",
+          "maxItems": 32,
+          "items": { "$ref": "#/$defs/policyEvidence" }
+        }
+      }
+    },
+    "target": { "$ref": "#/$defs/target" },
+    "readSet": { "type": "array", "minItems": 1, "maxItems": 128, "items": { "$ref": "#/$defs/readAssertion" } },
+    "requiredAdapterCapabilities": {
+      "type": "array",
+      "prefixItems": [{ "const": "materialize-file/v1" }],
+      "minItems": 1,
+      "maxItems": 1
+    },
+    "operations": { "type": "array", "minItems": 1, "maxItems": 4096, "items": { "$ref": "#/$defs/operation" } },
+    "diagnostics": { "type": "array", "maxItems": 1024, "items": { "$ref": "#/$defs/diagnostic" } },
+    "planDigest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "authorityId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 160,
+      "pattern": "^[a-z0-9][a-z0-9._/-]*$"
+    },
+    "artifactId": {
+      "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._@-]+)*$" },
+    "definitionRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "contractVersion"],
+      "properties": {
+        "id": { "$ref": "#/$defs/authorityId" },
+        "contractVersion": { "type": "integer", "minimum": 1, "maximum": 2147483647 }
+      }
+    },
+    "configuredDefinition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ref"],
+      "properties": {
+        "ref": { "$ref": "#/$defs/definitionRef" },
+        "parameters": { "$ref": "#/$defs/jsonObject" }
+      }
+    },
+    "intent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "compositionId", "targetRef"],
+      "properties": {
+        "schemaVersion": { "const": 1 },
+        "compositionId": { "$ref": "#/$defs/authorityId" },
+        "targetRef": { "$ref": "#/$defs/authorityId" },
+        "recipeParameters": { "$ref": "#/$defs/jsonObject" },
+        "facets": {
+          "type": "array",
+          "maxItems": 32,
+          "items": { "$ref": "#/$defs/configuredDefinition" }
+        }
+      }
+    },
+    "resolvedDefinition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ref", "parameters"],
+      "properties": {
+        "ref": { "$ref": "#/$defs/definitionRef" },
+        "parameters": { "$ref": "#/$defs/jsonObject" }
+      }
+    },
+    "policyEvidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ref", "parameters", "outcome"],
+      "properties": {
+        "ref": { "$ref": "#/$defs/definitionRef" },
+        "parameters": { "$ref": "#/$defs/jsonObject" },
+        "outcome": { "const": "passed" }
+      }
+    },
+    "jsonObject": {
+      "type": "object",
+      "maxProperties": 128,
+      "additionalProperties": { "$ref": "#/$defs/jsonValue" }
+    },
+    "jsonValue": {
+      "oneOf": [
+        { "type": "null" },
+        { "type": "boolean" },
+        { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 },
+        { "type": "string", "maxLength": 65536 },
+        { "type": "array", "maxItems": 1024, "items": { "$ref": "#/$defs/jsonValue" } },
+        { "$ref": "#/$defs/jsonObject" }
+      ]
+    },
+    "target": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "role", "path", "packageName"],
+      "properties": {
+        "id": { "$ref": "#/$defs/authorityId" },
+        "role": { "$ref": "#/$defs/authorityId" },
+        "path": { "$ref": "#/$defs/repositoryPath" },
+        "packageName": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 214,
+          "pattern": "^(?:@[a-z0-9][a-z0-9._-]*/)?[a-z0-9][a-z0-9._-]*$"
+        },
+        "ownerDocument": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512,
+          "pattern": "^[^\\u0000-\\u001F]+$"
+        }
+      }
+    },
+    "readAssertion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "state", "digest", "size"],
+      "properties": {
+        "path": { "$ref": "#/$defs/repositoryPath" },
+        "state": { "const": "file" },
+        "digest": { "$ref": "#/$defs/digest" },
+        "size": { "type": "integer", "minimum": 0, "maximum": 1048576 }
+      }
+    },
+    "operation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "kind", "path", "precondition", "after", "causes"],
+      "properties": {
+        "id": { "$ref": "#/$defs/artifactId" },
+        "kind": { "const": "materialize-file" },
+        "path": { "$ref": "#/$defs/repositoryPath" },
+        "precondition": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["state"],
+          "properties": { "state": { "const": "absent" } }
+        },
+        "after": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["digest", "size", "mode", "mediaType", "contentBase64"],
+          "properties": {
+            "digest": { "$ref": "#/$defs/digest" },
+            "size": { "type": "integer", "minimum": 0, "maximum": 1048576 },
+            "mode": { "const": "0644" },
+            "mediaType": { "type": "string", "minLength": 1, "maxLength": 128 },
+            "contentBase64": { "type": "string", "maxLength": 1398104, "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$" }
+          }
+        },
+        "causes": { "type": "array", "minItems": 1, "maxItems": 16, "items": { "$ref": "#/$defs/artifactId" } }
+      }
+    },
+    "diagnostic": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ruleId", "severity", "phase", "subject", "message", "remediation"],
+      "properties": {
+        "ruleId": { "$ref": "#/$defs/artifactId" },
+        "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 }
+      }
+    }
+  }
+}