@agent-teams/document-authoring 0.0.0

package/schemas/document-command-envelope/v1.schema.json

@@ -0,0 +1,161 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/document-command-envelope/v1",
+  "title": "Document Command Envelope",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "command", "outcome", "diagnostics", "result"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "command": { "enum": ["docs.doctor", "docs.find", "docs.new", "docs.recover"] },
+    "outcome": { "enum": ["success", "partial", "conflict", "violation", "authority-stale", "recovery-required", "invalid-input", "execution-failure", "cancelled"] },
+    "diagnostics": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/diagnostic" } },
+    "result": {
+      "oneOf": [
+        { "$ref": "#/$defs/findResult" },
+        { "$ref": "#/$defs/newResult" },
+        { "$ref": "#/$defs/doctorResult" },
+        { "$ref": "#/$defs/recoverResult" }
+      ]
+    }
+  },
+  "allOf": [
+    { "$ref": "#/$defs/findEnvelope" },
+    { "$ref": "#/$defs/newEnvelope" },
+    { "$ref": "#/$defs/doctorEnvelope" },
+    { "$ref": "#/$defs/recoverEnvelope" }
+  ],
+  "$defs": {
+    "opaqueId": { "type": "string", "minLength": 1, "maxLength": 214, "pattern": "^[A-Za-z0-9@][A-Za-z0-9@._/-]*$" },
+    "lowerId": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[a-z0-9][a-z0-9._/-]*$" },
+    "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})*$"
+    },
+    "documentDescriptor": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "type", "status", "owner", "summary", "repositoryPath", "title", "source"],
+      "properties": {
+        "id": { "$ref": "#/$defs/opaqueId" },
+        "type": { "$ref": "#/$defs/lowerId" },
+        "status": { "$ref": "#/$defs/lowerId" },
+        "owner": { "$ref": "#/$defs/opaqueId" },
+        "summary": { "type": "string", "minLength": 1, "maxLength": 1000 },
+        "repositoryPath": { "$ref": "#/$defs/repositoryPath" },
+        "title": { "type": "string", "minLength": 1, "maxLength": 240 },
+        "source": { "enum": ["frontmatter-readme", "markdown-tree"] }
+      }
+    },
+    "findResult": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "matches", "documents"],
+      "properties": {
+        "kind": { "const": "find" },
+        "matches": { "type": "integer", "minimum": 0, "maximum": 100000 },
+        "documents": { "type": "array", "maxItems": 2048, "items": { "$ref": "#/$defs/documentDescriptor" } }
+      }
+    },
+    "newResult": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "documentPath", "reachability"],
+      "properties": {
+        "kind": { "const": "new" },
+        "documentPath": { "$ref": "#/$defs/repositoryPath" },
+        "reachability": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["state"],
+          "properties": {
+            "state": { "enum": ["manual-required", "managed", "not-required"] },
+            "indexPath": { "$ref": "#/$defs/repositoryPath" },
+            "markdownLink": { "type": "string", "minLength": 1, "maxLength": 1024 }
+          },
+          "allOf": [
+            {
+              "if": { "type": "object", "properties": { "state": { "const": "manual-required" } }, "required": ["state"] },
+              "then": {
+                "type": "object",
+                "required": ["indexPath", "markdownLink"],
+                "properties": {
+                  "indexPath": { "$ref": "#/$defs/repositoryPath" },
+                  "markdownLink": { "type": "string", "minLength": 1, "maxLength": 1024 }
+                }
+              }
+            }
+          ]
+        }
+      }
+    },
+    "doctorResult": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "transactionState", "recoveryClass"],
+      "properties": {
+        "kind": { "const": "doctor" },
+        "transactionState": { "enum": ["none", "pending", "tampered", "unknown-version"] },
+        "protocolKind": { "enum": ["document-authoring", "scaffolding"] },
+        "foundationVersion": { "$ref": "#/$defs/semver" },
+        "recoveryClass": { "enum": ["auto-recoverable", "manual", "not-required"] }
+      }
+    },
+    "recoverResult": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "transactionState"],
+      "properties": {
+        "kind": { "const": "recover" },
+        "transactionState": { "enum": ["already-applied", "manual-required", "no-pending-transaction", "recovered"] },
+        "receiptDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "findEnvelope": {
+      "if": { "type": "object", "properties": { "command": { "const": "docs.find" } }, "required": ["command"] },
+      "then": { "type": "object", "properties": { "result": { "$ref": "#/$defs/findResult" } } }
+    },
+    "newEnvelope": {
+      "if": { "type": "object", "properties": { "command": { "const": "docs.new" } }, "required": ["command"] },
+      "then": { "type": "object", "properties": { "result": { "$ref": "#/$defs/newResult" } } }
+    },
+    "doctorEnvelope": {
+      "if": { "type": "object", "properties": { "command": { "const": "docs.doctor" } }, "required": ["command"] },
+      "then": { "type": "object", "properties": { "result": { "$ref": "#/$defs/doctorResult" } } }
+    },
+    "recoverEnvelope": {
+      "if": { "type": "object", "properties": { "command": { "const": "docs.recover" } }, "required": ["command"] },
+      "then": { "type": "object", "properties": { "result": { "$ref": "#/$defs/recoverResult" } } }
+    },
+    "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", "planning", "query", "recovery"] },
+        "subject": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "message": { "type": "string", "minLength": 1, "maxLength": 1000 },
+        "remediation": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["commandId", "args"],
+          "properties": {
+            "commandId": { "enum": ["docs.doctor", "docs.find", "docs.new", "docs.recover"] },
+            "args": {
+              "type": "object",
+              "maxProperties": 16,
+              "propertyNames": { "pattern": "^[a-z][a-zA-Z0-9]*$", "maxLength": 64 },
+              "additionalProperties": { "type": "string", "maxLength": 512 }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/document-command-envelope/v2.schema.json

@@ -0,0 +1,205 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/document-command-envelope/v2",
+  "title": "Document Mutation Command Envelope",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "command", "outcome", "diagnostics", "result"],
+  "properties": {
+    "schemaVersion": { "const": 2 },
+    "command": { "enum": ["docs.doctor", "docs.new", "docs.recover"] },
+    "outcome": { "enum": ["success", "conflict", "violation", "authority-stale", "recovery-required", "invalid-input", "execution-failure", "cancelled"] },
+    "diagnostics": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/diagnostic" } },
+    "result": {
+      "oneOf": [
+        { "$ref": "#/$defs/newResult" },
+        { "$ref": "#/$defs/doctorResult" },
+        { "$ref": "#/$defs/recoverResult" }
+      ]
+    }
+  },
+  "allOf": [
+    { "$ref": "#/$defs/newEnvelope" },
+    { "$ref": "#/$defs/doctorEnvelope" },
+    { "$ref": "#/$defs/recoverEnvelope" }
+  ],
+  "$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}$" },
+    "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})*$"
+    },
+    "recoveryCommand": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["commandId", "args"],
+      "properties": {
+        "commandId": { "enum": ["detach", "docs.recover", "scaffold-recover"] },
+        "args": {
+          "type": "object",
+          "maxProperties": 16,
+          "propertyNames": { "pattern": "^[a-z][a-zA-Z0-9]*$", "maxLength": 64 },
+          "additionalProperties": { "type": "string", "maxLength": 512 }
+        }
+      }
+    },
+    "reachability": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["state", "indexPath", "markdownLink"],
+          "properties": {
+            "state": { "const": "manual-required" },
+            "indexPath": { "$ref": "#/$defs/repositoryPath" },
+            "markdownLink": { "type": "string", "minLength": 1, "maxLength": 1024 }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["state"],
+          "properties": { "state": { "const": "managed" } }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["state"],
+          "properties": { "state": { "const": "not-required" } }
+        }
+      ]
+    },
+    "newResult": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "reservation"],
+      "properties": {
+        "kind": { "const": "new" },
+        "reservation": { "const": "none" },
+        "writeState": { "enum": ["preview", "applied", "already-applied"] },
+        "documentPath": { "$ref": "#/$defs/repositoryPath" },
+        "receiptOutcome": { "enum": ["applied", "already-applied", "authority-stale", "rejected", "recovery-required", "manual-recovery-required", "failed-before-publication", "cancelled"] },
+        "reachability": { "$ref": "#/$defs/reachability" }
+      },
+      "allOf": [
+        {
+          "if": { "type": "object", "properties": { "writeState": {} }, "required": ["writeState"] },
+          "then": {
+            "type": "object",
+            "required": ["documentPath", "reachability"],
+            "properties": {
+              "documentPath": { "$ref": "#/$defs/repositoryPath" },
+              "reachability": { "$ref": "#/$defs/reachability" }
+            }
+          }
+        }
+      ]
+    },
+    "doctorResult": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "transactionState", "recoveryClass"],
+      "properties": {
+        "kind": { "const": "doctor" },
+        "installedFoundationVersion": { "$ref": "#/$defs/semver" },
+        "installedFoundationBuildIdentity": { "$ref": "#/$defs/digest" },
+        "filesystem": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["basis", "strictDirectoryDurability"],
+          "properties": {
+            "basis": { "const": "platform-contract" },
+            "strictDirectoryDurability": { "enum": ["platform-supported", "platform-unsupported"] }
+          }
+        },
+        "transactionState": { "enum": ["none", "document", "scaffold", "local-mode", "transition-residue", "unknown", "corrupt", "version-mismatch"] },
+        "protocolKind": { "enum": ["document-authoring", "scaffolding", "local-mode", "unknown"] },
+        "foundationVersion": { "$ref": "#/$defs/semver" },
+        "foundationBuildIdentity": { "$ref": "#/$defs/digest" },
+        "recoveryClass": { "enum": ["auto-recoverable", "manual", "not-required"] },
+        "recoveryCommand": { "$ref": "#/$defs/recoveryCommand" }
+      },
+      "allOf": [
+        {
+          "if": { "type": "object", "properties": { "recoveryClass": { "const": "not-required" } }, "required": ["recoveryClass"] },
+          "then": { "type": "object", "properties": { "recoveryCommand": false } }
+        }
+      ]
+    },
+    "recoverResult": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "transactionState", "writeState", "recoveryRequired"],
+      "properties": {
+        "kind": { "const": "recover" },
+        "transactionState": { "enum": ["already-applied", "manual-required", "no-pending-transaction", "recovered", "recovery-required", "cancelled", "failed"] },
+        "writeState": { "enum": ["already-committed", "committed", "unchanged", "unknown"] },
+        "recoveryRequired": { "type": "boolean" },
+        "receiptDigest": { "$ref": "#/$defs/digest" },
+        "recoveryCommand": { "$ref": "#/$defs/recoveryCommand" }
+      }
+    },
+    "newEnvelope": {
+      "if": { "type": "object", "properties": { "command": { "const": "docs.new" } }, "required": ["command"] },
+      "then": { "type": "object", "properties": { "result": { "$ref": "#/$defs/newResult" } } }
+    },
+    "doctorEnvelope": {
+      "if": { "type": "object", "properties": { "command": { "const": "docs.doctor" } }, "required": ["command"] },
+      "then": {
+        "type": "object",
+        "properties": { "result": { "$ref": "#/$defs/doctorResult" } },
+        "allOf": [{
+          "if": { "type": "object", "properties": { "outcome": { "enum": ["success", "violation", "recovery-required"] } }, "required": ["outcome"] },
+          "then": {
+            "type": "object",
+            "properties": {
+              "result": {
+                "type": "object",
+                "required": ["installedFoundationVersion", "installedFoundationBuildIdentity", "filesystem"],
+                "properties": {
+                  "installedFoundationVersion": { "$ref": "#/$defs/semver" },
+                  "installedFoundationBuildIdentity": { "$ref": "#/$defs/digest" },
+                  "filesystem": { "type": "object" }
+                }
+              }
+            }
+          }
+        }]
+      }
+    },
+    "recoverEnvelope": {
+      "if": { "type": "object", "properties": { "command": { "const": "docs.recover" } }, "required": ["command"] },
+      "then": { "type": "object", "properties": { "result": { "$ref": "#/$defs/recoverResult" } } }
+    },
+    "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", "planning", "recovery"] },
+        "subject": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "message": { "type": "string", "minLength": 1, "maxLength": 1000 },
+        "remediation": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["commandId", "args"],
+          "properties": {
+            "commandId": { "enum": ["detach", "docs.doctor", "docs.find", "docs.new", "docs.recover", "scaffold-recover"] },
+            "args": {
+              "type": "object",
+              "maxProperties": 16,
+              "propertyNames": { "pattern": "^[a-z][a-zA-Z0-9]*$", "maxLength": 64 },
+              "additionalProperties": { "type": "string", "maxLength": 512 }
+            }
+          }
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,102 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agent-teams.ai/schemas/document-intent/v1",
+  "title": "Document Intent",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "type", "id", "title", "owner", "summary"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "type": { "$ref": "#/$defs/lowerId" },
+    "id": { "$ref": "#/$defs/opaqueId" },
+    "title": { "$ref": "#/$defs/title" },
+    "owner": { "$ref": "#/$defs/opaqueId" },
+    "summary": { "$ref": "#/$defs/summary" },
+    "slug": { "$ref": "#/$defs/slug" },
+    "destination": { "$ref": "#/$defs/repositoryPath" },
+    "related": {
+      "type": "array",
+      "maxItems": 128,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/opaqueId" }
+    },
+    "additionalMetadata": { "$ref": "#/$defs/jsonObject1" }
+  },
+  "$defs": {
+    "lowerId": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[a-z0-9][a-z0-9._/-]*$" },
+    "opaqueId": { "type": "string", "minLength": 1, "maxLength": 214, "pattern": "^[A-Za-z0-9@][A-Za-z0-9@._/-]*$" },
+    "title": { "type": "string", "minLength": 1, "maxLength": 240, "pattern": "^[^\\u0000-\\u001F\\u007F]+$" },
+    "summary": { "type": "string", "minLength": 1, "maxLength": 1000, "pattern": "^[^\\u0000-\\u001F\\u007F]+$" },
+    "slug": { "type": "string", "minLength": 1, "maxLength": 160, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "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})*$"
+    },
+    "metadataKey": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64,
+      "pattern": "^(?!(?:__proto__|prototype|constructor)$)[A-Za-z_][A-Za-z0-9_-]*$"
+    },
+    "additionalMetadataKey": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64,
+      "pattern": "^(?!(?:id|type|status|owner|summary|title|slug|destination|related|__proto__|prototype|constructor)$)[A-Za-z_][A-Za-z0-9_-]*$"
+    },
+    "jsonScalar": {
+      "oneOf": [
+        { "type": "null" },
+        { "type": "boolean" },
+        { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 },
+        { "type": "string", "maxLength": 4096, "pattern": "^[^\\u0000-\\u001F\\u007F]*$" }
+      ]
+    },
+    "jsonObject1": {
+      "type": "object",
+      "maxProperties": 64,
+      "propertyNames": { "$ref": "#/$defs/additionalMetadataKey" },
+      "additionalProperties": { "$ref": "#/$defs/jsonValue1" }
+    },
+    "jsonValue1": {
+      "oneOf": [
+        { "$ref": "#/$defs/jsonScalar" },
+        { "type": "array", "maxItems": 128, "items": { "$ref": "#/$defs/jsonValue2" } },
+        { "$ref": "#/$defs/jsonObject2" }
+      ]
+    },
+    "jsonObject2": {
+      "type": "object",
+      "maxProperties": 64,
+      "propertyNames": { "$ref": "#/$defs/metadataKey" },
+      "additionalProperties": { "$ref": "#/$defs/jsonValue2" }
+    },
+    "jsonValue2": {
+      "oneOf": [
+        { "$ref": "#/$defs/jsonScalar" },
+        { "type": "array", "maxItems": 128, "items": { "$ref": "#/$defs/jsonValue3" } },
+        { "$ref": "#/$defs/jsonObject3" }
+      ]
+    },
+    "jsonObject3": {
+      "type": "object",
+      "maxProperties": 64,
+      "propertyNames": { "$ref": "#/$defs/metadataKey" },
+      "additionalProperties": { "$ref": "#/$defs/jsonValue3" }
+    },
+    "jsonValue3": {
+      "oneOf": [
+        { "$ref": "#/$defs/jsonScalar" },
+        { "type": "array", "maxItems": 128, "items": { "$ref": "#/$defs/jsonScalar" } },
+        {
+          "type": "object",
+          "maxProperties": 64,
+          "propertyNames": { "$ref": "#/$defs/metadataKey" },
+          "additionalProperties": { "$ref": "#/$defs/jsonScalar" }
+        }
+      ]
+    }
+  }
+}

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" }
+      }
+    }
+  }
+}