@agent-teams/engineering-foundation 0.4.0 → 0.5.0

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

@@ -0,0 +1,299 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/scaffold-receipt/v1",
+  "title": "Scaffold Receipt v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "protocolVersion", "planDigest", "adapter", "outcome", "commit", "operations", "diagnostics", "receiptDigest"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "protocolVersion": { "const": 1 },
+    "planDigest": { "$ref": "#/$defs/digest" },
+    "adapter": {
+      "oneOf": [
+        { "$ref": "#/$defs/filesystemAdapter" },
+        { "$ref": "#/$defs/memoryAdapter" }
+      ]
+    },
+    "outcome": { "enum": ["already-applied", "applied", "failed-recovered", "recovery-required", "rejected"] },
+    "commit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state", "atomicity"],
+      "properties": {
+        "state": { "enum": ["committed", "recovered", "recovery-required", "rejected"] },
+        "atomicity": { "enum": ["journaled-recoverable", "memory-atomic"] }
+      }
+    },
+    "operations": {
+      "type": "array",
+      "maxItems": 4096,
+      "items": {
+        "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"] },
+          "resultDigest": { "$ref": "#/$defs/digest" }
+        },
+        "allOf": [
+          {
+            "if": {
+              "properties": {
+                "outcome": { "enum": ["already-satisfied", "applied", "recovered"] }
+              },
+              "required": ["outcome"]
+            },
+            "then": {
+              "properties": { "resultDigest": { "$ref": "#/$defs/digest" } },
+              "required": ["resultDigest"]
+            }
+          },
+          {
+            "if": {
+              "properties": {
+                "outcome": { "enum": ["conflict", "not-applied"] }
+              },
+              "required": ["outcome"]
+            },
+            "then": { "properties": { "resultDigest": false } }
+          }
+        ]
+      }
+    },
+    "diagnostics": { "type": "array", "maxItems": 1024, "items": { "$ref": "#/$defs/diagnostic" } },
+    "receiptDigest": { "$ref": "#/$defs/digest" }
+  },
+  "allOf": [
+    {
+      "oneOf": [
+        {
+          "properties": {
+            "adapter": { "$ref": "#/$defs/filesystemAdapter" },
+            "outcome": { "const": "applied" },
+            "commit": { "$ref": "#/$defs/filesystemCommitted" },
+            "operations": { "$ref": "#/$defs/appliedOperations" }
+          }
+        },
+        {
+          "properties": {
+            "adapter": { "$ref": "#/$defs/memoryAdapter" },
+            "outcome": { "const": "applied" },
+            "commit": { "$ref": "#/$defs/memoryCommitted" },
+            "operations": { "$ref": "#/$defs/appliedOperations" }
+          }
+        },
+        {
+          "properties": {
+            "adapter": { "$ref": "#/$defs/filesystemAdapter" },
+            "outcome": { "const": "already-applied" },
+            "commit": { "$ref": "#/$defs/filesystemCommitted" },
+            "operations": { "$ref": "#/$defs/alreadyAppliedOperations" }
+          }
+        },
+        {
+          "properties": {
+            "adapter": { "$ref": "#/$defs/memoryAdapter" },
+            "outcome": { "const": "already-applied" },
+            "commit": { "$ref": "#/$defs/memoryCommitted" },
+            "operations": { "$ref": "#/$defs/alreadyAppliedOperations" }
+          }
+        },
+        {
+          "properties": {
+            "adapter": { "$ref": "#/$defs/filesystemAdapter" },
+            "outcome": { "const": "failed-recovered" },
+            "commit": { "$ref": "#/$defs/filesystemRecovered" },
+            "operations": { "$ref": "#/$defs/failedRecoveredOperations" }
+          }
+        },
+        {
+          "properties": {
+            "adapter": { "$ref": "#/$defs/filesystemAdapter" },
+            "outcome": { "const": "recovery-required" },
+            "commit": { "$ref": "#/$defs/filesystemRecoveryRequired" },
+            "operations": { "$ref": "#/$defs/recoveryRequiredOperations" }
+          }
+        },
+        {
+          "properties": {
+            "adapter": { "$ref": "#/$defs/filesystemAdapter" },
+            "outcome": { "const": "rejected" },
+            "commit": { "$ref": "#/$defs/filesystemRejected" },
+            "operations": { "$ref": "#/$defs/incompleteOperations" }
+          }
+        },
+        {
+          "properties": {
+            "adapter": { "$ref": "#/$defs/memoryAdapter" },
+            "outcome": { "const": "rejected" },
+            "commit": { "$ref": "#/$defs/memoryRejected" },
+            "operations": { "$ref": "#/$defs/incompleteOperations" }
+          }
+        }
+      ]
+    }
+  ],
+  "$defs": {
+    "filesystemAdapter": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "contractVersion"],
+      "properties": {
+        "id": { "const": "foundation.filesystem/v1" },
+        "contractVersion": { "const": 1 }
+      }
+    },
+    "memoryAdapter": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "contractVersion"],
+      "properties": {
+        "id": { "const": "foundation.memory/v1" },
+        "contractVersion": { "const": 1 }
+      }
+    },
+    "filesystemCommitted": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state", "atomicity"],
+      "properties": {
+        "state": { "const": "committed" },
+        "atomicity": { "const": "journaled-recoverable" }
+      }
+    },
+    "memoryCommitted": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state", "atomicity"],
+      "properties": {
+        "state": { "const": "committed" },
+        "atomicity": { "const": "memory-atomic" }
+      }
+    },
+    "filesystemRecovered": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state", "atomicity"],
+      "properties": {
+        "state": { "const": "recovered" },
+        "atomicity": { "const": "journaled-recoverable" }
+      }
+    },
+    "filesystemRecoveryRequired": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state", "atomicity"],
+      "properties": {
+        "state": { "const": "recovery-required" },
+        "atomicity": { "const": "journaled-recoverable" }
+      }
+    },
+    "filesystemRejected": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state", "atomicity"],
+      "properties": {
+        "state": { "const": "rejected" },
+        "atomicity": { "const": "journaled-recoverable" }
+      }
+    },
+    "memoryRejected": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state", "atomicity"],
+      "properties": {
+        "state": { "const": "rejected" },
+        "atomicity": { "const": "memory-atomic" }
+      }
+    },
+    "appliedOperations": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["outcome"],
+        "properties": {
+          "outcome": { "enum": ["already-satisfied", "applied"] }
+        }
+      },
+      "contains": {
+        "type": "object",
+        "required": ["outcome"],
+        "properties": {
+          "outcome": { "const": "applied" }
+        }
+      },
+      "minContains": 1
+    },
+    "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",
+      "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"] }
+        }
+      },
+      "contains": {
+        "type": "object",
+        "required": ["outcome"],
+        "properties": {
+          "outcome": { "enum": ["conflict", "not-applied"] }
+        }
+      },
+      "minContains": 1
+    },
+    "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-target-catalog/v1.schema.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/scaffold-target-catalog/v1",
+  "title": "Scaffold Target Catalog v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "packages"],
+  "properties": {
+    "version": { "const": 1 },
+    "packages": {
+      "type": "array",
+      "maxItems": 4096,
+      "items": { "$ref": "#/$defs/target" }
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 160,
+      "pattern": "^[a-z0-9][a-z0-9._/-]*$"
+    },
+    "repositoryPath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "pattern": "^(?!.*(?:^|/)\\.{1,2}(?:/|$))[A-Za-z0-9._@-]+(?:/[A-Za-z0-9._@-]+)*$"
+    },
+    "target": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "role", "path", "package_name"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "role": { "$ref": "#/$defs/id" },
+        "path": { "$ref": "#/$defs/repositoryPath" },
+        "package_name": {
+          "type": "string",
+          "minLength": 1,
+          "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]+$"
+        }
+      }
+    }
+  }
+}

package/schemas/scaffolding-config/v1.schema.json

@@ -0,0 +1,99 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/scaffolding-config/v1",
+  "title": "Scaffolding Configuration v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "projectId", "targetCatalogPath", "compositions"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "projectId": { "$ref": "#/$defs/id" },
+    "targetCatalogPath": { "$ref": "#/$defs/repositoryPath" },
+    "compositions": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 128,
+      "items": { "$ref": "#/$defs/composition" }
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 160,
+      "pattern": "^[a-z0-9][a-z0-9._/-]*$"
+    },
+    "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/id" },
+        "contractVersion": { "type": "integer", "minimum": 1, "maximum": 2147483647 }
+      }
+    },
+    "configuredDefinition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ref"],
+      "properties": {
+        "ref": { "$ref": "#/$defs/definitionRef" },
+        "parameters": { "$ref": "#/$defs/jsonObject" }
+      }
+    },
+    "facetPolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "fixed": { "type": "array", "maxItems": 32, "items": { "$ref": "#/$defs/configuredDefinition" } },
+        "default": { "type": "array", "maxItems": 32, "items": { "$ref": "#/$defs/configuredDefinition" } },
+        "allowed": { "type": "array", "maxItems": 64, "items": { "$ref": "#/$defs/definitionRef" } }
+      }
+    },
+    "composition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "scaffoldProfile", "recipe", "targetRoles", "policies"],
+      "properties": {
+        "id": { "$ref": "#/$defs/id" },
+        "scaffoldProfile": { "$ref": "#/$defs/configuredDefinition" },
+        "recipe": { "$ref": "#/$defs/configuredDefinition" },
+        "targetRoles": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 32,
+          "items": { "$ref": "#/$defs/id" }
+        },
+        "fixedRecipeParameters": { "$ref": "#/$defs/jsonObject" },
+        "defaultRecipeParameters": { "$ref": "#/$defs/jsonObject" },
+        "facets": { "$ref": "#/$defs/facetPolicy" },
+        "policies": {
+          "type": "array",
+          "maxItems": 32,
+          "items": { "$ref": "#/$defs/configuredDefinition" }
+        }
+      }
+    },
+    "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" }
+      ]
+    }
+  }
+}