@agent-teams/engineering-foundation 0.17.0-rc.0 → 0.17.0-rc.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-teams/engineering-foundation",
-  "version": "0.17.0-rc.0",
+  "version": "0.17.0-rc.2",
   "description": "Versioned engineering policy, tooling, and conformance for Agent Teams repositories.",
   "license": "Apache-2.0",
   "type": "module",
@@ -69,8 +69,11 @@
     "schemas/foundation-transaction-envelope/v2.schema.json",
     "schemas/foundation-transaction-envelope/v3.schema.json",
     "schemas/foundation-transaction-envelope/v4.schema.json",
+    "schemas/foundation-transaction-envelope/v5.schema.json",
     "schemas/governance-architecture-decision-baseline/v1.schema.json",
     "schemas/governance-architecture-decisions/v1.schema.json",
+    "schemas/known-file-transaction-plan/v1.schema.json",
+    "schemas/known-file-transaction-receipt/v1.schema.json",
     "schemas/package-public-api-baseline/v1.schema.json",
     "schemas/package-public-api-compatibility/v1.schema.json",
     "schemas/quality-executable-specification-catalog/v1.schema.json",

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

@@ -0,0 +1,94 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/foundation-transaction-envelope/v5",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "operationKind", "recoveryHandler", "foundation", "adapterContractVersion", "payloadKind", "state", "journal", "payloadDigest", "envelopeDigest"],
+  "properties": {
+    "schemaVersion": { "const": 5 },
+    "operationKind": { "const": "known-file-transaction" },
+    "recoveryHandler": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "contractVersion"],
+      "properties": {
+        "id": { "const": "foundation.replace-known-file" },
+        "contractVersion": { "const": 1 }
+      }
+    },
+    "foundation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["version", "buildIdentity"],
+      "properties": {
+        "version": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "buildIdentity": { "$ref": "#/$defs/sha256" }
+      }
+    },
+    "adapterContractVersion": { "const": 1 },
+    "payloadKind": { "const": "known-file-transaction-journal/v1" },
+    "state": { "enum": ["APPLYING", "COMMITTED"] },
+    "journal": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "plan", "operations", "authorizedDirectories", "createdDirectories"],
+      "properties": {
+        "schemaVersion": { "const": 1 },
+        "plan": { "$ref": "https://agent-teams.ai/schemas/known-file-transaction-plan/v1" },
+        "operations": { "type": "array", "maxItems": 32, "items": { "$ref": "#/$defs/journalOperation" } },
+        "authorizedDirectories": { "type": "array", "maxItems": 128, "items": { "type": "string", "minLength": 1, "maxLength": 1024 } },
+        "createdDirectories": { "type": "array", "maxItems": 128, "items": { "$ref": "#/$defs/createdDirectory" } }
+      }
+    },
+    "payloadDigest": { "$ref": "#/$defs/sha256" },
+    "envelopeDigest": { "$ref": "#/$defs/sha256" }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "identity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["birthtimeNs", "dev", "ino"],
+      "properties": {
+        "birthtimeNs": { "type": "string", "pattern": "^[1-9][0-9]*$" },
+        "dev": { "type": "string", "pattern": "^[1-9][0-9]*$" },
+        "ino": { "type": "string", "pattern": "^[1-9][0-9]*$" }
+      }
+    },
+    "journalOperation": {
+      "type": "object",
+      "required": ["path", "state"],
+      "properties": {
+        "path": { "type": "string", "minLength": 1, "maxLength": 1024 },
+        "state": { "enum": ["already-satisfied", "pending", "temporary-authorized", "temporary-ready", "capture-authorized", "capture-ready", "preimage-captured", "destination-retired", "publishing", "published", "rollback-restored"] },
+        "matchedPreimage": { "type": "integer", "minimum": 0, "maximum": 15 },
+        "rollbackTemporaryIdentity": { "$ref": "#/$defs/identity" },
+        "temporaryIdentity": { "$ref": "#/$defs/identity" },
+        "captureDirectoryIdentity": { "$ref": "#/$defs/identity" },
+        "capturedPreimageIdentity": { "$ref": "#/$defs/identity" },
+        "retirement": { "$ref": "#/$defs/retirement" }
+      },
+      "additionalProperties": false
+    },
+    "retirement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "state", "directoryIdentity", "pathIdentity"],
+      "properties": {
+        "kind": { "enum": ["destination", "rollback-temporary", "temporary"] },
+        "state": { "enum": ["ready", "captured", "unlink-authorized"] },
+        "directoryIdentity": { "$ref": "#/$defs/identity" },
+        "pathIdentity": { "$ref": "#/$defs/identity" }
+      }
+    },
+    "createdDirectory": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "identity"],
+      "properties": {
+        "path": { "type": "string", "minLength": 1, "maxLength": 1024 },
+        "identity": { "$ref": "#/$defs/identity" }
+      }
+    }
+  }
+}

package/schemas/known-file-transaction-plan/v1.schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/known-file-transaction-plan/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "protocol", "operations", "planDigest"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "protocol": { "const": "foundation.replace-known-file/v1" },
+    "operations": {
+      "type": "array",
+      "maxItems": 32,
+      "items": { "$ref": "#/$defs/operation" }
+    },
+    "planDigest": { "$ref": "#/$defs/sha256" }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "image": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contentBase64", "digest", "mode", "size"],
+      "properties": {
+        "contentBase64": { "type": "string", "contentEncoding": "base64" },
+        "digest": { "$ref": "#/$defs/sha256" },
+        "mode": { "type": "integer", "minimum": 0, "maximum": 511 },
+        "size": { "type": "integer", "minimum": 0, "maximum": 8388608 }
+      }
+    },
+    "precondition": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["state"],
+          "properties": { "state": { "const": "absent" } }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["state", "acceptedPreimages"],
+          "properties": {
+            "state": { "const": "known-file" },
+            "acceptedPreimages": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 16,
+              "items": { "$ref": "#/$defs/image" }
+            }
+          }
+        }
+      ]
+    },
+    "operation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "precondition", "postimage"],
+      "properties": {
+        "path": { "type": "string", "minLength": 1, "maxLength": 1024 },
+        "precondition": { "$ref": "#/$defs/precondition" },
+        "postimage": { "$ref": "#/$defs/image" }
+      }
+    }
+  }
+}

package/schemas/known-file-transaction-receipt/v1.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/known-file-transaction-receipt/v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "protocol", "planDigest", "outcome", "operations", "receiptDigest"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "protocol": { "const": "foundation.replace-known-file/v1" },
+    "planDigest": { "$ref": "#/$defs/sha256" },
+    "outcome": { "enum": ["already-satisfied", "applied", "rolled-back"] },
+    "operations": {
+      "type": "array",
+      "maxItems": 32,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "outcome"],
+        "properties": {
+          "path": { "type": "string", "minLength": 1, "maxLength": 1024 },
+          "outcome": { "enum": ["already-satisfied", "created", "replaced", "rolled-back-to-absent", "rolled-back-to-preimage"] },
+          "resultDigest": { "$ref": "#/$defs/sha256" }
+        },
+        "allOf": [{
+          "if": { "properties": { "outcome": { "const": "rolled-back-to-absent" } }, "required": ["outcome"] },
+          "then": { "properties": { "resultDigest": false } },
+          "else": { "required": ["resultDigest"] }
+        }]
+      }
+    },
+    "receiptDigest": { "$ref": "#/$defs/sha256" }
+  },
+  "$defs": {
+    "sha256": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+  }
+}