@agent-teams/engineering-foundation 0.16.1 → 0.17.0-rc.1

package/schemas/document-authoring-profile/v2.schema.json

@@ -0,0 +1,168 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/document-authoring-profile/v2",
+  "title": "Document Authoring Profile v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "projectId", "catalog", "authoring"],
+  "properties": {
+    "schemaVersion": { "const": 2 },
+    "projectId": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/lowerId" },
+    "catalog": { "$ref": "#/$defs/catalog" },
+    "authoring": { "$ref": "#/$defs/authoring" }
+  },
+  "$defs": {
+    "catalog": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["metadataSchemaPath", "ownerCatalog", "collections"],
+      "properties": {
+        "metadataSchemaPath": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" },
+        "ownerCatalog": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["path", "contract"],
+          "properties": {
+            "path": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" },
+            "contract": { "const": "foundation.owner-map/v1" }
+          }
+        },
+        "collections": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 32,
+          "items": {
+            "oneOf": [
+              { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/markdownTreeCollection" },
+              { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/frontmatterReadmeCollection" }
+            ]
+          }
+        },
+        "excludedPrefixes": {
+          "type": "array",
+          "maxItems": 128,
+          "uniqueItems": true,
+          "items": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" }
+        },
+        "metadataSidecar": { "$ref": "#/$defs/metadataSidecar" }
+      }
+    },
+    "metadataSidecar": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "path"],
+      "properties": {
+        "kind": { "const": "path-metadata-map" },
+        "path": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" }
+      }
+    },
+    "authoring": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "artifactTypes"],
+      "properties": {
+        "mode": { "const": "create-only" },
+        "artifactTypes": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 32,
+          "items": { "$ref": "#/$defs/artifactType" }
+        }
+      }
+    },
+    "artifactType": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "initialStatus",
+        "identity",
+        "placement",
+        "template",
+        "heading",
+        "reachability",
+        "allowedOwnerIds"
+      ],
+      "properties": {
+        "type": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/lowerId" },
+        "initialStatus": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/lowerId" },
+        "identity": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/identity" },
+        "placement": {
+          "oneOf": [
+            { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/collectionPlacement" },
+            { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/qualifiedLeafIndexPlacement" },
+            { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/explicitPlacement" }
+          ]
+        },
+        "template": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "path"],
+          "properties": {
+            "kind": { "const": "fenced-markdown-body" },
+            "path": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" }
+          }
+        },
+        "heading": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind"],
+          "properties": {
+            "kind": { "enum": ["id-colon-title", "title"] }
+          }
+        },
+        "reachability": { "$ref": "#/$defs/reachability" },
+        "allowedOwnerIds": { "$ref": "#/$defs/allowedOwnerIds" }
+      }
+    },
+    "allowedOwnerIds": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 4096,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 214,
+        "pattern": "^[A-Za-z0-9@][A-Za-z0-9@._/-]*$"
+      }
+    },
+    "reachability": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "indexPath"],
+          "properties": {
+            "kind": { "const": "manual-fixed-index" },
+            "indexPath": { "$ref": "https://agent-teams.ai/schemas/document-authoring-profile/v1#/$defs/repositoryPath" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "pathPrefix", "indexBasename"],
+          "properties": {
+            "kind": { "const": "manual-colocated-index" },
+            "pathPrefix": { "const": "before-required-segments" },
+            "indexBasename": { "const": "README.md" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "reason"],
+          "properties": {
+            "kind": { "const": "not-required" },
+            "reason": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 500,
+              "pattern": "^[^\\u0000-\\u001F\\u007F]+$"
+            }
+          }
+        }
+      ]
+    }
+  }
+}

package/schemas/document-parent-materialization/v2.schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/document-parent-materialization/v2",
+  "title": "Document Parent Materialization Journal v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "plan", "anchorIdentity", "createdDirectories"],
+  "properties": {
+    "schemaVersion": { "const": 2 },
+    "plan": { "$ref": "#/$defs/plan" },
+    "anchorIdentity": { "$ref": "#/$defs/physicalIdentity" },
+    "createdDirectories": {
+      "type": "array",
+      "maxItems": 128,
+      "items": { "$ref": "#/$defs/createdDirectory" }
+    }
+  },
+  "$defs": {
+    "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})*$"
+    },
+    "repositoryDirectory": {
+      "oneOf": [{ "const": "." }, { "$ref": "#/$defs/repositoryPath" }]
+    },
+    "physicalIdentity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["adapter", "version", "dev", "ino", "birthtimeNs"],
+      "properties": {
+        "adapter": { "const": "node-filesystem" },
+        "version": { "const": 1 },
+        "dev": { "type": "string", "maxLength": 32, "pattern": "^[1-9][0-9]*$" },
+        "ino": { "type": "string", "maxLength": 32, "pattern": "^[1-9][0-9]*$" },
+        "birthtimeNs": { "type": "string", "maxLength": 32, "pattern": "^[1-9][0-9]*$" }
+      }
+    },
+    "plan": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["policy", "deepestExistingDirectory", "missingDirectories", "finalParent"],
+      "properties": {
+        "policy": { "const": "create-missing-real-directories" },
+        "deepestExistingDirectory": { "$ref": "#/$defs/repositoryDirectory" },
+        "missingDirectories": {
+          "type": "array",
+          "maxItems": 128,
+          "items": { "$ref": "#/$defs/repositoryPath" }
+        },
+        "finalParent": { "$ref": "#/$defs/repositoryDirectory" }
+      }
+    },
+    "createdDirectory": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "identity"],
+      "properties": {
+        "path": { "$ref": "#/$defs/repositoryPath" },
+        "identity": { "$ref": "#/$defs/physicalIdentity" }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/document-plan/v2",
+  "title": "Document Plan v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "protocolVersion", "compiler", "projectId", "intent", "intentDigest", "authority", "selectedOwner", "identityProjection", "referencedDocuments", "destination", "expectedParent", "parentMaterialization", "destinationPrecondition", "output", "requiredAdapterCapabilities", "diagnostics", "planDigest"],
+  "properties": {
+    "schemaVersion": { "const": 2 },
+    "protocolVersion": { "const": 2 },
+    "compiler": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/compiler" },
+    "projectId": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/lowerId" },
+    "intent": { "$ref": "https://agent-teams.ai/schemas/document-intent/v1" },
+    "intentDigest": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/digest" },
+    "authority": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["profile", "metadataSchema", "ownerCatalog", "template", "profileSemanticDigest", "catalogPreimageSemanticDigest", "expectedCatalogPostimageSemanticDigest"],
+      "properties": {
+        "profile": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/authoritySource" },
+        "metadataSchema": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/authoritySource" },
+        "metadataSidecar": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/authoritySource" },
+        "profileSemanticDigest": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/digest" },
+        "catalogPreimageSemanticDigest": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/digest" },
+        "expectedCatalogPostimageSemanticDigest": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/digest" },
+        "ownerCatalog": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/authoritySource" },
+        "template": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/templateAuthoritySource" }
+      }
+    },
+    "selectedOwner": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/selectedOwner" },
+    "identityProjection": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/identityProjection" },
+    "referencedDocuments": {
+      "type": "array",
+      "maxItems": 128,
+      "items": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/referencedDocument" }
+    },
+    "destination": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/repositoryPath" },
+    "expectedParent": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/expectedParent" },
+    "parentMaterialization": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["policy", "deepestExistingDirectory", "missingDirectories", "finalParent"],
+      "properties": {
+        "policy": { "const": "create-missing-real-directories" },
+        "deepestExistingDirectory": { "$ref": "#/$defs/repositoryDirectory" },
+        "missingDirectories": {
+          "type": "array",
+          "maxItems": 128,
+          "items": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/repositoryPath" }
+        },
+        "finalParent": { "$ref": "#/$defs/repositoryDirectory" }
+      }
+    },
+    "destinationPrecondition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["state"],
+      "properties": { "state": { "const": "absent" } }
+    },
+    "output": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/output" },
+    "requiredAdapterCapabilities": {
+      "type": "array",
+      "prefixItems": [
+        { "const": "create-directories-no-replace/v1" },
+        { "const": "create-file-no-replace/v1" }
+      ],
+      "minItems": 2,
+      "maxItems": 2
+    },
+    "diagnostics": {
+      "type": "array",
+      "maxItems": 256,
+      "items": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/diagnostic" }
+    },
+    "planDigest": { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/digest" }
+  },
+  "$defs": {
+    "repositoryDirectory": {
+      "oneOf": [
+        { "const": "." },
+        { "$ref": "https://agent-teams.ai/schemas/document-plan/v1#/$defs/repositoryPath" }
+      ]
+    }
+  }
+}

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

@@ -0,0 +1,108 @@
+{
+  "$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/v4.schema.json

@@ -0,0 +1,164 @@
+{
+  "$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
+          }
+        }
+      }
+    }
+  }
+}