@agent-teams/engineering-foundation 0.21.0 → 1.0.0

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

@@ -1,141 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-teams.ai/schemas/document-receipt/v1",
-  "title": "Document Receipt",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["schemaVersion", "protocolVersion", "planDigest", "adapter", "destination", "outcome", "commit", "diagnostics", "receiptDigest"],
-  "properties": {
-    "schemaVersion": { "const": 1 },
-    "protocolVersion": { "const": 1 },
-    "planDigest": { "$ref": "#/$defs/digest" },
-    "adapter": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["id", "contractVersion"],
-      "properties": {
-        "id": { "const": "foundation.filesystem/v1" },
-        "contractVersion": { "const": 1 }
-      }
-    },
-    "destination": { "$ref": "#/$defs/repositoryPath" },
-    "outcome": { "enum": ["applied", "already-applied", "authority-stale", "rejected", "recovery-required", "manual-recovery-required", "failed-before-publication", "cancelled"] },
-    "resultDigest": { "$ref": "#/$defs/digest" },
-    "commit": { "$ref": "#/$defs/commitObservation" },
-    "diagnostics": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/diagnostic" } },
-    "receiptDigest": { "$ref": "#/$defs/digest" }
-  },
-  "allOf": [
-    { "$ref": "#/$defs/appliedContract" },
-    { "$ref": "#/$defs/alreadyAppliedContract" },
-    { "$ref": "#/$defs/noResultContract" },
-    { "$ref": "#/$defs/recoveryContract" }
-  ],
-  "$defs": {
-    "opaqueId": { "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}(?:/|$))(?!.*\\.(?:/|$))(?!.*(?:^|/)(?:[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",
-      "additionalProperties": false,
-      "required": ["state", "publication", "atomicity", "recoverability"],
-      "properties": {
-        "state": { "enum": ["committed", "not-published", "preserved", "recovery-required", "manual-recovery-required"] },
-        "publication": { "enum": ["none", "preexisting-exact", "published", "unknown"] },
-        "atomicity": { "enum": ["not-applicable", "single-file-atomic-create"] },
-        "recoverability": { "enum": ["not-required", "journaled-recoverable", "preserved-for-recovery"] }
-      }
-    },
-    "appliedContract": {
-      "if": { "type": "object", "properties": { "outcome": { "const": "applied" } }, "required": ["outcome"] },
-      "then": {
-        "type": "object",
-        "required": ["resultDigest"],
-        "properties": {
-          "resultDigest": { "$ref": "#/$defs/digest" },
-          "commit": {
-            "type": "object",
-            "properties": {
-              "state": { "const": "committed" },
-              "publication": { "const": "published" },
-              "atomicity": { "const": "single-file-atomic-create" },
-              "recoverability": { "const": "not-required" }
-            }
-          }
-        }
-      }
-    },
-    "alreadyAppliedContract": {
-      "if": { "type": "object", "properties": { "outcome": { "const": "already-applied" } }, "required": ["outcome"] },
-      "then": {
-        "type": "object",
-        "required": ["resultDigest"],
-        "properties": {
-          "resultDigest": { "$ref": "#/$defs/digest" },
-          "commit": {
-            "type": "object",
-            "properties": {
-              "state": { "const": "committed" },
-              "publication": { "const": "preexisting-exact" },
-              "atomicity": { "const": "not-applicable" },
-              "recoverability": { "const": "not-required" }
-            }
-          }
-        }
-      }
-    },
-    "noResultContract": {
-      "if": { "type": "object", "properties": { "outcome": { "enum": ["authority-stale", "rejected", "failed-before-publication", "cancelled"] } }, "required": ["outcome"] },
-      "then": {
-        "type": "object",
-        "properties": {
-          "resultDigest": false,
-          "commit": {
-            "type": "object",
-            "properties": {
-              "state": { "const": "not-published" },
-              "publication": { "const": "none" },
-              "atomicity": { "const": "not-applicable" },
-              "recoverability": { "const": "not-required" }
-            }
-          }
-        }
-      }
-    },
-    "recoveryContract": {
-      "if": { "type": "object", "properties": { "outcome": { "enum": ["recovery-required", "manual-recovery-required"] } }, "required": ["outcome"] },
-      "then": {
-        "type": "object",
-        "properties": {
-          "resultDigest": false,
-          "commit": {
-            "type": "object",
-            "properties": {
-              "state": { "enum": ["preserved", "recovery-required", "manual-recovery-required"] },
-              "publication": { "enum": ["none", "published", "unknown"] },
-              "atomicity": { "enum": ["not-applicable", "single-file-atomic-create"] },
-              "recoverability": { "const": "preserved-for-recovery" }
-            }
-          }
-        }
-      }
-    },
-    "diagnostic": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["ruleId", "severity", "phase", "subject", "message"],
-      "properties": {
-        "ruleId": { "$ref": "#/$defs/opaqueId" },
-        "severity": { "enum": ["error", "info", "warning"] },
-        "phase": { "enum": ["apply", "authority", "input", "recovery"] },
-        "subject": { "type": "string", "minLength": 1, "maxLength": 512 },
-        "message": { "type": "string", "minLength": 1, "maxLength": 1000 }
-      }
-    }
-  }
-}

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

@@ -1,108 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-teams.ai/schemas/document-receipt/v2",
-  "title": "Document Receipt v2",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["schemaVersion", "protocolVersion", "planDigest", "adapter", "destination", "outcome", "commit", "directoryMaterialization", "diagnostics", "receiptDigest"],
-  "properties": {
-    "schemaVersion": { "const": 2 },
-    "protocolVersion": { "const": 2 },
-    "planDigest": { "$ref": "https://agent-teams.ai/schemas/document-receipt/v1#/$defs/digest" },
-    "adapter": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["id", "contractVersion"],
-      "properties": {
-        "id": { "const": "foundation.filesystem/v1" },
-        "contractVersion": { "const": 1 }
-      }
-    },
-    "destination": { "$ref": "https://agent-teams.ai/schemas/document-receipt/v1#/$defs/repositoryPath" },
-    "outcome": { "enum": ["applied", "already-applied", "authority-stale", "rejected", "recovery-required", "manual-recovery-required", "failed-before-publication", "cancelled"] },
-    "resultDigest": { "$ref": "https://agent-teams.ai/schemas/document-receipt/v1#/$defs/digest" },
-    "commit": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["state", "publication", "fileAtomicity", "recoverability"],
-      "properties": {
-        "state": { "enum": ["committed", "not-published", "recovery-required", "manual-recovery-required"] },
-        "publication": { "enum": ["none", "preexisting-exact", "published", "unknown"] },
-        "fileAtomicity": { "enum": ["not-applicable", "single-file-atomic-create"] },
-        "recoverability": { "enum": ["not-required", "preserved-for-recovery"] }
-      }
-    },
-    "directoryMaterialization": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["state", "plannedDirectories", "observedCreatedDirectories"],
-      "properties": {
-        "state": { "enum": ["none-created", "created-and-retained", "preserved-unknown"] },
-        "plannedDirectories": { "type": "array", "maxItems": 128, "items": { "$ref": "https://agent-teams.ai/schemas/document-receipt/v1#/$defs/repositoryPath" } },
-        "observedCreatedDirectories": { "type": "array", "maxItems": 128, "items": { "$ref": "https://agent-teams.ai/schemas/document-receipt/v1#/$defs/repositoryPath" } }
-      }
-    },
-    "diagnostics": { "type": "array", "maxItems": 256, "items": { "$ref": "https://agent-teams.ai/schemas/document-receipt/v1#/$defs/diagnostic" } },
-    "receiptDigest": { "$ref": "https://agent-teams.ai/schemas/document-receipt/v1#/$defs/digest" }
-  },
-  "allOf": [
-    {
-      "if": { "properties": { "outcome": { "enum": ["applied", "already-applied"] } }, "required": ["outcome"] },
-      "then": {
-        "properties": {
-          "resultDigest": { "$ref": "https://agent-teams.ai/schemas/document-receipt/v1#/$defs/digest" }
-        },
-        "required": ["resultDigest"]
-      },
-      "else": { "properties": { "resultDigest": false } }
-    },
-    {
-      "if": {
-        "properties": {
-          "directoryMaterialization": {
-            "type": "object",
-            "properties": { "state": { "const": "none-created" } },
-            "required": ["state"]
-          }
-        },
-        "required": ["directoryMaterialization"]
-      },
-      "then": {
-        "properties": {
-          "directoryMaterialization": {
-            "type": "object",
-            "properties": {
-              "observedCreatedDirectories": { "type": "array", "maxItems": 0 }
-            }
-          }
-        }
-      }
-    },
-    {
-      "if": {
-        "properties": {
-          "directoryMaterialization": {
-            "type": "object",
-            "properties": { "state": { "const": "preserved-unknown" } },
-            "required": ["state"]
-          }
-        },
-        "required": ["directoryMaterialization"]
-      },
-      "then": {
-        "properties": {
-          "outcome": {
-            "enum": ["recovery-required", "manual-recovery-required"]
-          },
-          "commit": {
-            "type": "object",
-            "properties": {
-              "recoverability": { "const": "preserved-for-recovery" }
-            },
-            "required": ["recoverability"]
-          }
-        }
-      }
-    }
-  ]
-}

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

@@ -1,169 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-teams.ai/schemas/foundation-transaction-envelope/v3",
-  "title": "Foundation Document Transaction Envelope",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["schemaVersion", "operationKind", "recoveryHandler", "foundation", "adapterContractVersion", "payloadKind", "journal", "payloadDigest", "state", "envelopeDigest"],
-  "properties": {
-    "schemaVersion": { "const": 3 },
-    "operationKind": { "const": "document-authoring" },
-    "recoveryHandler": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["id", "contractVersion"],
-      "properties": {
-        "id": { "const": "foundation.document-authoring" },
-        "contractVersion": { "const": 2 }
-      }
-    },
-    "foundation": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["version", "buildIdentity"],
-      "properties": {
-        "version": { "$ref": "#/$defs/semver" },
-        "buildIdentity": { "$ref": "#/$defs/digest" }
-      }
-    },
-    "adapterContractVersion": { "const": 1 },
-    "payloadKind": { "const": "document-authoring-journal/v2" },
-    "journal": { "$ref": "#/$defs/documentJournalV2" },
-    "payloadDigest": { "$ref": "#/$defs/digest" },
-    "state": { "enum": ["PREPARED", "PUBLISHING", "PUBLISHED"] },
-    "envelopeDigest": { "$ref": "#/$defs/digest" }
-  },
-  "oneOf": [
-    { "$ref": "#/$defs/preparedEnvelope" },
-    { "$ref": "#/$defs/publishingEnvelope" },
-    { "$ref": "#/$defs/publishedEnvelope" }
-  ],
-  "$defs": {
-    "digest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
-    "semver": { "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-]+)*)?$" },
-    "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})*$"
-    },
-    "unsignedDecimal": {
-      "type": "string",
-      "pattern": "^(?:0|[1-9][0-9]*)$",
-      "maxLength": 32
-    },
-    "nonzeroUnsignedDecimal": {
-      "type": "string",
-      "pattern": "^[1-9][0-9]*$",
-      "maxLength": 32
-    },
-    "physicalIdentity": {
-      "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" }
-      }
-    },
-    "nonzeroPhysicalIdentity": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["adapter", "version", "dev", "ino", "birthtimeNs"],
-      "properties": {
-        "adapter": { "const": "node-filesystem" },
-        "version": { "const": 1 },
-        "dev": { "$ref": "#/$defs/nonzeroUnsignedDecimal" },
-        "ino": { "$ref": "#/$defs/nonzeroUnsignedDecimal" },
-        "birthtimeNs": { "$ref": "#/$defs/nonzeroUnsignedDecimal" }
-      }
-    },
-    "destination": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["path", "state"],
-      "properties": {
-        "path": { "$ref": "#/$defs/repositoryPath" },
-        "state": { "enum": ["pending", "preexisting", "publishing", "published"] }
-      }
-    },
-    "ownedTemporary": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["path", "digest", "identity"],
-      "properties": {
-        "path": { "$ref": "#/$defs/repositoryPath" },
-        "digest": { "$ref": "#/$defs/digest" },
-        "identity": { "$ref": "#/$defs/physicalIdentity" }
-      }
-    },
-    "documentJournalV2": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["schemaVersion", "plan", "destination"],
-      "properties": {
-        "schemaVersion": { "const": 2 },
-        "plan": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1" },
-        "destination": { "$ref": "#/$defs/destination" },
-        "ownedTemporary": { "$ref": "#/$defs/ownedTemporary" },
-        "publicationIdentity": { "$ref": "#/$defs/nonzeroPhysicalIdentity" }
-      }
-    },
-    "preparedEnvelope": {
-      "type": "object",
-      "properties": {
-        "state": { "const": "PREPARED" },
-        "journal": {
-          "type": "object",
-          "properties": {
-            "destination": {
-              "type": "object",
-              "properties": { "state": { "enum": ["pending", "preexisting"] } }
-            },
-            "ownedTemporary": false,
-            "publicationIdentity": false
-          }
-        }
-      }
-    },
-    "publishingEnvelope": {
-      "type": "object",
-      "properties": {
-        "state": { "const": "PUBLISHING" },
-        "journal": {
-          "type": "object",
-          "required": ["ownedTemporary"],
-          "properties": {
-            "destination": {
-              "type": "object",
-              "properties": { "state": { "const": "publishing" } }
-            },
-            "ownedTemporary": { "$ref": "#/$defs/ownedTemporary" },
-            "publicationIdentity": false
-          }
-        }
-      }
-    },
-    "publishedEnvelope": {
-      "type": "object",
-      "properties": {
-        "state": { "const": "PUBLISHED" },
-        "journal": {
-          "type": "object",
-          "required": ["publicationIdentity"],
-          "properties": {
-            "destination": {
-              "type": "object",
-              "properties": { "state": { "const": "published" } }
-            },
-            "publicationIdentity": { "$ref": "#/$defs/nonzeroPhysicalIdentity" },
-            "ownedTemporary": false
-          }
-        }
-      }
-    }
-  }
-}

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

@@ -1,164 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://agent-teams.ai/schemas/foundation-transaction-envelope/v4",
-  "title": "Foundation Document Transaction Envelope v4",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["schemaVersion", "operationKind", "recoveryHandler", "foundation", "adapterContractVersion", "payloadKind", "journal", "payloadDigest", "state", "envelopeDigest"],
-  "properties": {
-    "schemaVersion": { "const": 4 },
-    "operationKind": { "const": "document-authoring" },
-    "recoveryHandler": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["id", "contractVersion"],
-      "properties": {
-        "id": { "const": "foundation.document-authoring" },
-        "contractVersion": { "const": 3 }
-      }
-    },
-    "foundation": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["version", "buildIdentity"],
-      "properties": {
-        "version": { "$ref": "https://agent-teams.ai/schemas/foundation-transaction-envelope/v3#/$defs/semver" },
-        "buildIdentity": { "$ref": "https://agent-teams.ai/schemas/foundation-transaction-envelope/v3#/$defs/digest" }
-      }
-    },
-    "adapterContractVersion": { "const": 1 },
-    "payloadKind": { "const": "document-authoring-journal/v3" },
-    "journal": { "$ref": "#/$defs/documentJournalV3" },
-    "payloadDigest": { "$ref": "https://agent-teams.ai/schemas/foundation-transaction-envelope/v3#/$defs/digest" },
-    "state": { "enum": ["PREPARED", "MATERIALIZING", "PUBLISHING", "PUBLISHED"] },
-    "envelopeDigest": { "$ref": "https://agent-teams.ai/schemas/foundation-transaction-envelope/v3#/$defs/digest" }
-  },
-  "oneOf": [
-    { "$ref": "#/$defs/preparedEnvelope" },
-    { "$ref": "#/$defs/materializingEnvelope" },
-    { "$ref": "#/$defs/publishingEnvelope" },
-    { "$ref": "#/$defs/publishedEnvelope" }
-  ],
-  "$defs": {
-    "parentMaterialization": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["anchorIdentity", "createdDirectories"],
-      "properties": {
-        "anchorIdentity": { "$ref": "https://agent-teams.ai/schemas/foundation-transaction-envelope/v3#/$defs/nonzeroPhysicalIdentity" },
-        "createdDirectories": {
-          "type": "array",
-          "maxItems": 128,
-          "items": {
-            "type": "object",
-            "additionalProperties": false,
-            "required": ["path", "identity"],
-            "properties": {
-              "path": { "$ref": "https://agent-teams.ai/schemas/foundation-transaction-envelope/v3#/$defs/repositoryPath" },
-              "identity": { "$ref": "https://agent-teams.ai/schemas/foundation-transaction-envelope/v3#/$defs/nonzeroPhysicalIdentity" }
-            }
-          }
-        },
-        "pendingDirectory": { "$ref": "https://agent-teams.ai/schemas/foundation-transaction-envelope/v3#/$defs/repositoryPath" }
-      }
-    },
-    "destination": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["path", "state"],
-      "properties": {
-        "path": { "$ref": "https://agent-teams.ai/schemas/foundation-transaction-envelope/v3#/$defs/repositoryPath" },
-        "state": { "enum": ["pending", "preexisting", "materializing", "publishing", "published"] }
-      }
-    },
-    "documentJournalV3": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["schemaVersion", "plan", "destination", "parentMaterialization"],
-      "properties": {
-        "schemaVersion": { "const": 3 },
-        "plan": { "$ref": "https://agent-teams.ai/schemas/document-plan/v2" },
-        "destination": { "$ref": "#/$defs/destination" },
-        "parentMaterialization": { "$ref": "#/$defs/parentMaterialization" },
-        "ownedTemporary": { "$ref": "https://agent-teams.ai/schemas/foundation-transaction-envelope/v3#/$defs/ownedTemporary" },
-        "publicationIdentity": { "$ref": "https://agent-teams.ai/schemas/foundation-transaction-envelope/v3#/$defs/nonzeroPhysicalIdentity" }
-      }
-    },
-    "preparedEnvelope": {
-      "type": "object",
-      "properties": {
-        "state": { "const": "PREPARED" },
-        "journal": {
-          "type": "object",
-          "properties": {
-            "destination": { "type": "object", "properties": { "state": { "enum": ["pending", "preexisting"] } } },
-            "parentMaterialization": {
-              "type": "object",
-              "properties": {
-                "createdDirectories": { "type": "array", "maxItems": 0 },
-                "pendingDirectory": false
-              }
-            },
-            "ownedTemporary": false,
-            "publicationIdentity": false
-          }
-        }
-      }
-    },
-    "materializingEnvelope": {
-      "type": "object",
-      "properties": {
-        "state": { "const": "MATERIALIZING" },
-        "journal": {
-          "type": "object",
-          "properties": {
-            "destination": { "type": "object", "properties": { "state": { "const": "materializing" } } },
-            "plan": {
-              "type": "object",
-              "properties": {
-                "parentMaterialization": {
-                  "type": "object",
-                  "properties": {
-                    "missingDirectories": { "type": "array", "minItems": 1 }
-                  }
-                }
-              }
-            },
-            "ownedTemporary": false,
-            "publicationIdentity": false
-          }
-        }
-      }
-    },
-    "publishingEnvelope": {
-      "type": "object",
-      "properties": {
-        "state": { "const": "PUBLISHING" },
-        "journal": {
-          "type": "object",
-          "required": ["ownedTemporary"],
-          "properties": {
-            "destination": { "type": "object", "properties": { "state": { "const": "publishing" } } },
-            "ownedTemporary": { "$ref": "https://agent-teams.ai/schemas/foundation-transaction-envelope/v3#/$defs/ownedTemporary" },
-            "publicationIdentity": false
-          }
-        }
-      }
-    },
-    "publishedEnvelope": {
-      "type": "object",
-      "properties": {
-        "state": { "const": "PUBLISHED" },
-        "journal": {
-          "type": "object",
-          "required": ["publicationIdentity"],
-          "properties": {
-            "destination": { "type": "object", "properties": { "state": { "const": "published" } } },
-            "publicationIdentity": { "$ref": "https://agent-teams.ai/schemas/foundation-transaction-envelope/v3#/$defs/nonzeroPhysicalIdentity" },
-            "ownedTemporary": false
-          }
-        }
-      }
-    }
-  }
-}