{
  "components": {
    "schemas": {
      "AppendRequest": {
        "additionalProperties": false,
        "description": "AppendRequest appends Facts as one atomic batch.",
        "properties": {
          "expected_cutoff": {
            "oneOf": [
              {
                "maximum": 9007199254740991,
                "minimum": 0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "facts": {
            "items": {
              "contentEncoding": "base64",
              "type": "string"
            },
            "maxItems": 128,
            "minItems": 1,
            "type": "array"
          },
          "operation_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9._:-]+$",
            "type": "string"
          },
          "space": {
            "$ref": "#/components/schemas/SpaceRef"
          }
        },
        "required": [
          "space",
          "facts",
          "operation_id"
        ],
        "title": "AppendRequest",
        "type": "object"
      },
      "AppendResult": {
        "additionalProperties": false,
        "description": "AppendResult identifies the committed batch; Cutoff equals Last.",
        "properties": {
          "cutoff": {
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "first": {
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "last": {
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "replayed": {
            "type": "boolean"
          },
          "space": {
            "$ref": "#/components/schemas/SpaceRef"
          }
        },
        "required": [
          "space",
          "first",
          "last",
          "cutoff",
          "replayed"
        ],
        "title": "AppendResult",
        "type": "object"
      },
      "ArgumentCondition": {
        "additionalProperties": false,
        "description": "ArgumentCondition requires the argument at Index (0 is the first argument after the predicate) to equal the canonical Ontos value Equals.",
        "properties": {
          "equals": {
            "contentEncoding": "base64",
            "type": "string"
          },
          "index": {
            "maximum": 65535,
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "index",
          "equals"
        ],
        "type": "object"
      },
      "Batch": {
        "additionalProperties": false,
        "description": "Batch is the committed batch an entry belongs to.",
        "properties": {
          "first": {
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "last": {
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "first",
          "last"
        ],
        "type": "object"
      },
      "BindingHTTP": {
        "additionalProperties": false,
        "description": "BindingHTTP describes the HTTP binding in the describe document.",
        "properties": {
          "prefix": {
            "type": "string"
          }
        },
        "required": [
          "prefix"
        ],
        "type": "object"
      },
      "Bindings": {
        "additionalProperties": false,
        "description": "Bindings names the primary binding and describes each offered one.",
        "properties": {
          "http": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/BindingHTTP"
              },
              {
                "type": "null"
              }
            ]
          },
          "primary": {
            "type": "string"
          }
        },
        "required": [
          "primary"
        ],
        "type": "object"
      },
      "Build": {
        "additionalProperties": false,
        "description": "Build identifies the binary: the revision it was built from, whether that tree was dirty, and the Go version.",
        "properties": {
          "dirty": {
            "type": "boolean"
          },
          "go": {
            "type": "string"
          },
          "revision": {
            "type": "string"
          }
        },
        "required": [
          "revision",
          "dirty",
          "go"
        ],
        "type": "object"
      },
      "Check": {
        "additionalProperties": false,
        "description": "Check is one dependency the service needs in order to serve its contract.",
        "properties": {
          "detail": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "status": {
            "description": "ok | failing",
            "type": "string"
          }
        },
        "required": [
          "name",
          "status",
          "detail"
        ],
        "type": "object"
      },
      "Child": {
        "additionalProperties": false,
        "description": "Child is one child at the parent's selected cutoff, with its creation entry.",
        "properties": {
          "created_at": {
            "$ref": "#/components/schemas/EntryRef"
          },
          "key": {
            "type": "string"
          },
          "space": {
            "$ref": "#/components/schemas/Space"
          }
        },
        "required": [
          "key",
          "space",
          "created_at"
        ],
        "type": "object"
      },
      "ChildrenRequest": {
        "additionalProperties": false,
        "description": "ChildrenRequest enumerates a space's immediate children at the cutoff Through (omitted: captured once), continuing with Cursor.",
        "properties": {
          "cursor": {
            "maxLength": 4096,
            "type": "string"
          },
          "limit": {
            "maximum": 128,
            "minimum": 0,
            "type": "integer"
          },
          "space": {
            "$ref": "#/components/schemas/SpaceRef"
          },
          "through": {
            "oneOf": [
              {
                "maximum": 9007199254740991,
                "minimum": 0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "space"
        ],
        "title": "ChildrenRequest",
        "type": "object"
      },
      "ChildrenResult": {
        "additionalProperties": false,
        "description": "ChildrenResult is one page of the fixed child set.",
        "properties": {
          "children": {
            "items": {
              "$ref": "#/components/schemas/Child"
            },
            "type": "array"
          },
          "next_cursor": {
            "type": "string"
          },
          "space": {
            "$ref": "#/components/schemas/SpaceRef"
          },
          "through": {
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "space",
          "through",
          "children"
        ],
        "title": "ChildrenResult",
        "type": "object"
      },
      "CreateRequest": {
        "additionalProperties": false,
        "description": "CreateRequest creates a child space and its empty journal under Parent.",
        "properties": {
          "expected_cutoff": {
            "oneOf": [
              {
                "maximum": 9007199254740991,
                "minimum": 0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "key": {
            "maxLength": 255,
            "minLength": 1,
            "type": "string"
          },
          "operation_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9._:-]+$",
            "type": "string"
          },
          "parent": {
            "$ref": "#/components/schemas/SpaceRef"
          }
        },
        "required": [
          "parent",
          "key",
          "operation_id"
        ],
        "title": "CreateRequest",
        "type": "object"
      },
      "CreateResult": {
        "additionalProperties": false,
        "description": "CreateResult is the original creation, including on replay: the child, the creation entry in the parent, and the parent's cutoff after it.",
        "properties": {
          "child": {
            "$ref": "#/components/schemas/Space"
          },
          "parent_cutoff": {
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "parent_entry": {
            "$ref": "#/components/schemas/EntryRef"
          },
          "replayed": {
            "type": "boolean"
          }
        },
        "required": [
          "child",
          "parent_entry",
          "parent_cutoff",
          "replayed"
        ],
        "title": "CreateResult",
        "type": "object"
      },
      "Describe": {
        "additionalProperties": false,
        "description": "Describe is the document of GET /describe: who this is, the root, which contract, which build, which bindings, which operations, which refusals, the limits and profiles, and which committed contract files GET /describe/{file} serves verbatim.",
        "properties": {
          "bindings": {
            "$ref": "#/components/schemas/Bindings"
          },
          "build": {
            "$ref": "#/components/schemas/Build"
          },
          "contract": {
            "type": "string"
          },
          "files": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "identity": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Identity"
              },
              {
                "type": "null"
              }
            ]
          },
          "limits": {
            "$ref": "#/components/schemas/Limits"
          },
          "operations": {
            "items": {
              "$ref": "#/components/schemas/Operation"
            },
            "type": "array"
          },
          "profiles": {
            "$ref": "#/components/schemas/Profiles"
          },
          "refusals": {
            "items": {
              "$ref": "#/components/schemas/Refusal"
            },
            "type": "array"
          },
          "service": {
            "type": "string"
          }
        },
        "required": [
          "service",
          "contract",
          "build",
          "bindings",
          "operations",
          "refusals",
          "limits",
          "profiles",
          "files"
        ],
        "title": "Describe",
        "type": "object"
      },
      "Entry": {
        "additionalProperties": false,
        "description": "Entry is one fact occurrence.",
        "properties": {
          "batch": {
            "$ref": "#/components/schemas/Batch"
          },
          "fact": {
            "contentEncoding": "base64",
            "type": "string"
          },
          "origin": {
            "enum": [
              "append",
              "create"
            ],
            "type": "string"
          },
          "ref": {
            "$ref": "#/components/schemas/EntryRef"
          }
        },
        "required": [
          "ref",
          "fact",
          "origin",
          "batch"
        ],
        "title": "Entry",
        "type": "object"
      },
      "EntryRef": {
        "additionalProperties": false,
        "description": "EntryRef is the occurrence identity of one entry: a position in one journal.",
        "properties": {
          "position": {
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "root_id": {
            "pattern": "^rt_[0-9a-f]{32}$",
            "type": "string"
          },
          "space_id": {
            "pattern": "^spc_[0-9a-f]{32}$",
            "type": "string"
          }
        },
        "required": [
          "root_id",
          "space_id",
          "position"
        ],
        "title": "EntryRef",
        "type": "object"
      },
      "Error": {
        "additionalProperties": false,
        "description": "Error is a refusal.",
        "properties": {
          "details": {
            "type": "object"
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "error",
          "message"
        ],
        "title": "Error",
        "type": "object"
      },
      "Filter": {
        "additionalProperties": false,
        "description": "Filter is a conjunction of structural conditions compared by Ontos equality.",
        "properties": {
          "arguments": {
            "items": {
              "$ref": "#/components/schemas/ArgumentCondition"
            },
            "type": "array"
          },
          "origin": {
            "enum": [
              "append",
              "create"
            ],
            "type": "string"
          },
          "positions": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/PositionRange"
              },
              {
                "type": "null"
              }
            ]
          },
          "predicate": {
            "contentEncoding": "base64",
            "type": "string"
          }
        },
        "title": "Filter",
        "type": "object"
      },
      "HTTPBinding": {
        "additionalProperties": false,
        "description": "HTTPBinding carries one operation over HTTP.",
        "properties": {
          "method": {
            "type": "string"
          },
          "path": {
            "type": "string"
          }
        },
        "required": [
          "method",
          "path"
        ],
        "type": "object"
      },
      "HeadRequest": {
        "additionalProperties": false,
        "description": "HeadRequest selects one space's committed cutoff.",
        "properties": {
          "space": {
            "$ref": "#/components/schemas/SpaceRef"
          }
        },
        "required": [
          "space"
        ],
        "title": "HeadRequest",
        "type": "object"
      },
      "HeadResult": {
        "additionalProperties": false,
        "description": "HeadResult is the cutoff: 0 for an empty journal, else the end of the latest committed batch.",
        "properties": {
          "cutoff": {
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "space": {
            "$ref": "#/components/schemas/SpaceRef"
          }
        },
        "required": [
          "space",
          "cutoff"
        ],
        "title": "HeadResult",
        "type": "object"
      },
      "Health": {
        "additionalProperties": false,
        "description": "Health is the envelope of GET /livez and GET /healthz.",
        "properties": {
          "build": {
            "$ref": "#/components/schemas/Build"
          },
          "checks": {
            "items": {
              "$ref": "#/components/schemas/Check"
            },
            "type": "array"
          },
          "contract": {
            "type": "string"
          },
          "identity": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Identity"
              },
              {
                "type": "null"
              }
            ]
          },
          "service": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "time": {
            "type": "string"
          }
        },
        "required": [
          "status",
          "service",
          "contract",
          "build",
          "time",
          "checks"
        ],
        "title": "Health",
        "type": "object"
      },
      "Identity": {
        "additionalProperties": false,
        "description": "Identity is the service-specific identity member of the health envelope and the describe document: the logical root, its space, and the store lineage.",
        "properties": {
          "journal_instance_id": {
            "type": "string"
          },
          "root_id": {
            "type": "string"
          },
          "root_space_id": {
            "type": "string"
          }
        },
        "required": [
          "root_id",
          "root_space_id",
          "journal_instance_id"
        ],
        "type": "object"
      },
      "Limits": {
        "additionalProperties": false,
        "description": "Limits is the advertised operational admission profile.",
        "properties": {
          "default_page_entries": {
            "type": "integer"
          },
          "max_append_bytes": {
            "type": "integer"
          },
          "max_append_facts": {
            "type": "integer"
          },
          "max_atom_bytes": {
            "type": "integer"
          },
          "max_body_bytes": {
            "type": "integer"
          },
          "max_cursor_bytes": {
            "type": "integer"
          },
          "max_fact_bytes": {
            "type": "integer"
          },
          "max_inspect_bytes": {
            "type": "integer"
          },
          "max_inspect_candidates": {
            "type": "integer"
          },
          "max_key_bytes": {
            "type": "integer"
          },
          "max_page_bytes": {
            "type": "integer"
          },
          "max_page_entries": {
            "type": "integer"
          },
          "max_position": {
            "type": "integer"
          },
          "max_snapshot_bytes": {
            "type": "integer"
          },
          "max_snapshot_spaces": {
            "type": "integer"
          },
          "max_tuple_arity": {
            "type": "integer"
          },
          "max_value_depth": {
            "type": "integer"
          }
        },
        "required": [
          "max_position",
          "max_key_bytes",
          "max_fact_bytes",
          "max_append_facts",
          "max_append_bytes",
          "max_body_bytes",
          "max_page_entries",
          "default_page_entries",
          "max_page_bytes",
          "max_inspect_candidates",
          "max_inspect_bytes",
          "max_snapshot_spaces",
          "max_snapshot_bytes",
          "max_cursor_bytes",
          "max_value_depth",
          "max_tuple_arity",
          "max_atom_bytes"
        ],
        "type": "object"
      },
      "Operation": {
        "additionalProperties": false,
        "description": "Operation is the shared operation table row consumed by bindings and clients.",
        "properties": {
          "doc": {
            "type": "string"
          },
          "errors": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "http": {
            "$ref": "#/components/schemas/HTTPBinding"
          },
          "kind": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "params": {
            "items": {
              "$ref": "#/components/schemas/Param"
            },
            "type": "array"
          },
          "request": {
            "type": "string"
          },
          "response": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "kind",
          "doc",
          "params",
          "errors"
        ],
        "type": "object"
      },
      "Param": {
        "additionalProperties": false,
        "description": "Param is a named input outside a JSON body.",
        "properties": {
          "doc": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "repeated": {
            "type": "boolean"
          },
          "required": {
            "type": "boolean"
          }
        },
        "required": [
          "name",
          "kind",
          "required",
          "repeated",
          "doc"
        ],
        "type": "object"
      },
      "PositionRange": {
        "additionalProperties": false,
        "description": "PositionRange bounds a filter to positions in (After, Through].",
        "properties": {
          "after": {
            "oneOf": [
              {
                "maximum": 9007199254740991,
                "minimum": 0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "through": {
            "oneOf": [
              {
                "maximum": 9007199254740991,
                "minimum": 0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object"
      },
      "Profiles": {
        "additionalProperties": false,
        "description": "Profiles names the frozen value, encoding and projection profiles the continuing history is pinned to.",
        "properties": {
          "codec": {
            "type": "string"
          },
          "compound": {
            "type": "string"
          },
          "creation_predicate": {
            "type": "string"
          },
          "data": {
            "type": "string"
          },
          "data_json": {
            "type": "string"
          },
          "equality": {
            "type": "string"
          },
          "facts": {
            "type": "string"
          }
        },
        "required": [
          "facts",
          "codec",
          "compound",
          "data",
          "data_json",
          "equality",
          "creation_predicate"
        ],
        "type": "object"
      },
      "QueryRequest": {
        "additionalProperties": false,
        "description": "QueryRequest reads Space and its descendants over an explicit Snapshot, which the service captures when absent.",
        "properties": {
          "cursor": {
            "maxLength": 4096,
            "type": "string"
          },
          "filter": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Filter"
              },
              {
                "type": "null"
              }
            ]
          },
          "limit": {
            "maximum": 128,
            "minimum": 0,
            "type": "integer"
          },
          "max_depth": {
            "oneOf": [
              {
                "maximum": 9007199254740991,
                "minimum": 0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "snapshot": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Snapshot"
              },
              {
                "type": "null"
              }
            ]
          },
          "space": {
            "$ref": "#/components/schemas/SpaceRef"
          }
        },
        "required": [
          "space"
        ],
        "title": "QueryRequest",
        "type": "object"
      },
      "QueryResult": {
        "additionalProperties": false,
        "description": "QueryResult is one page over the snapshot, in depth-first preorder then position.",
        "properties": {
          "entries": {
            "items": {
              "$ref": "#/components/schemas/Entry"
            },
            "type": "array"
          },
          "next_cursor": {
            "type": "string"
          },
          "snapshot": {
            "$ref": "#/components/schemas/Snapshot"
          }
        },
        "required": [
          "snapshot",
          "entries"
        ],
        "title": "QueryResult",
        "type": "object"
      },
      "ReadRequest": {
        "additionalProperties": false,
        "description": "ReadRequest reads (After, Through] of one journal, optionally filtered.",
        "properties": {
          "after": {
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "filter": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Filter"
              },
              {
                "type": "null"
              }
            ]
          },
          "limit": {
            "maximum": 128,
            "minimum": 0,
            "type": "integer"
          },
          "space": {
            "$ref": "#/components/schemas/SpaceRef"
          },
          "through": {
            "oneOf": [
              {
                "maximum": 9007199254740991,
                "minimum": 0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "space"
        ],
        "title": "ReadRequest",
        "type": "object"
      },
      "ReadResult": {
        "additionalProperties": false,
        "description": "ReadResult is one page.",
        "properties": {
          "entries": {
            "items": {
              "$ref": "#/components/schemas/Entry"
            },
            "type": "array"
          },
          "next_after": {
            "maximum": 9007199254740991,
            "minimum": 1,
            "type": "integer"
          },
          "scanned_through": {
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          },
          "space": {
            "$ref": "#/components/schemas/SpaceRef"
          },
          "through": {
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "space",
          "through",
          "entries",
          "scanned_through"
        ],
        "title": "ReadResult",
        "type": "object"
      },
      "Refusal": {
        "additionalProperties": false,
        "description": "Refusal is one row of the refusal table: the surface's name for it, the status the HTTP binding maps it to, and its one-line meaning.",
        "properties": {
          "http": {
            "type": "integer"
          },
          "meaning": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "http",
          "meaning"
        ],
        "type": "object"
      },
      "ResolveRequest": {
        "additionalProperties": false,
        "description": "ResolveRequest selects a space exactly by Space, or the current occupant of Path under RootID.",
        "properties": {
          "path": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "root_id": {
            "pattern": "^rt_[0-9a-f]{32}$",
            "type": "string"
          },
          "space": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/SpaceRef"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "title": "ResolveRequest",
        "type": "object"
      },
      "ResolveResult": {
        "additionalProperties": false,
        "description": "ResolveResult is the space, or null when the path is unoccupied.",
        "properties": {
          "space": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Space"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "space"
        ],
        "title": "ResolveResult",
        "type": "object"
      },
      "Snapshot": {
        "additionalProperties": false,
        "description": "Snapshot is a recursively complete selection of journal prefixes under a scope, to a depth bound.",
        "properties": {
          "max_depth": {
            "oneOf": [
              {
                "maximum": 9007199254740991,
                "minimum": 0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "scope": {
            "$ref": "#/components/schemas/SpaceRef"
          },
          "spaces": {
            "items": {
              "$ref": "#/components/schemas/SnapshotSpace"
            },
            "type": "array"
          }
        },
        "required": [
          "scope",
          "max_depth",
          "spaces"
        ],
        "title": "Snapshot",
        "type": "object"
      },
      "SnapshotSpace": {
        "additionalProperties": false,
        "description": "SnapshotSpace is one covered space and the cutoff its facts were selected through.",
        "properties": {
          "space": {
            "$ref": "#/components/schemas/Space"
          },
          "through": {
            "maximum": 9007199254740991,
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "space",
          "through"
        ],
        "type": "object"
      },
      "Space": {
        "additionalProperties": false,
        "description": "Space is a space's identity together with its path from the root.",
        "properties": {
          "path": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "root_id": {
            "pattern": "^rt_[0-9a-f]{32}$",
            "type": "string"
          },
          "space_id": {
            "pattern": "^spc_[0-9a-f]{32}$",
            "type": "string"
          }
        },
        "required": [
          "root_id",
          "space_id",
          "path"
        ],
        "title": "Space",
        "type": "object"
      },
      "SpaceRef": {
        "additionalProperties": false,
        "description": "SpaceRef is the exact identity of one continuing space and its journal.",
        "properties": {
          "root_id": {
            "pattern": "^rt_[0-9a-f]{32}$",
            "type": "string"
          },
          "space_id": {
            "pattern": "^spc_[0-9a-f]{32}$",
            "type": "string"
          }
        },
        "required": [
          "root_id",
          "space_id"
        ],
        "title": "SpaceRef",
        "type": "object"
      }
    }
  },
  "info": {
    "description": "Generated from journal.Operations and the journal types (ulab-standard/API.md). SURFACE.md and HTTP.md define semantics beyond these checked shapes.",
    "title": "ulab-journal",
    "version": "2026-09-12"
  },
  "openapi": "3.1.0",
  "paths": {
    "/describe": {
      "get": {
        "operationId": "describe",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Describe"
                }
              }
            },
            "description": "the result",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid: unsupported method; Allow names the supported method",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "service identity, root, contract, build, binding, operations, refusals, limits, profiles and files",
        "tags": [
          "operational"
        ]
      }
    },
    "/describe/{file}": {
      "get": {
        "operationId": "describe_file",
        "parameters": [
          {
            "description": "an exact file name listed by describe",
            "in": "path",
            "name": "file",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              },
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "the file, verbatim",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid: unsupported method; Allow names the supported method",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "one embedded contract file, verbatim",
        "tags": [
          "operational"
        ]
      }
    },
    "/healthz": {
      "get": {
        "operationId": "health",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Health"
                }
              }
            },
            "description": "the result",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid: unsupported method; Allow names the supported method",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Health"
                }
              }
            },
            "description": "a check is failing; the same envelope",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "whether the engine can serve the contract",
        "tags": [
          "operational"
        ]
      }
    },
    "/livez": {
      "get": {
        "operationId": "livez",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Health"
                }
              }
            },
            "description": "the result",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid: unsupported method; Allow names the supported method",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "the process is up and can answer; empty checks and never 503",
        "tags": [
          "operational"
        ]
      }
    },
    "/v1/append": {
      "post": {
        "operationId": "append",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AppendRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppendResult"
                }
              }
            },
            "description": "replayed: the original result of this operation ID",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppendResult"
                }
              }
            },
            "description": "accepted",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid: unsupported method; Allow names the supported method",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "conflict, idempotency_mismatch",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid: the JSON request envelope exceeds 8 MiB",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "append an atomic batch of facts, optionally requiring the current cutoff",
        "tags": [
          "mutation"
        ]
      }
    },
    "/v1/children": {
      "post": {
        "operationId": "children",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChildrenRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChildrenResult"
                }
              }
            },
            "description": "the result",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid: unsupported method; Allow names the supported method",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid: the JSON request envelope exceeds 8 MiB",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "enumerate a space's immediate children at a fixed cutoff, in creation order",
        "tags": [
          "read"
        ]
      }
    },
    "/v1/create": {
      "post": {
        "operationId": "create",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateResult"
                }
              }
            },
            "description": "replayed: the original result of this operation ID",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateResult"
                }
              }
            },
            "description": "accepted",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid: unsupported method; Allow names the supported method",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "conflict, exists, idempotency_mismatch",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid: the JSON request envelope exceeds 8 MiB",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "create a child space and its empty journal under an existing parent, recording the creation in the parent's journal",
        "tags": [
          "mutation"
        ]
      }
    },
    "/v1/head": {
      "post": {
        "operationId": "head",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/HeadRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HeadResult"
                }
              }
            },
            "description": "the result",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid: unsupported method; Allow names the supported method",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid: the JSON request envelope exceeds 8 MiB",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "read a space's committed cutoff",
        "tags": [
          "read"
        ]
      }
    },
    "/v1/query": {
      "post": {
        "operationId": "query",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/QueryRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QueryResult"
                }
              }
            },
            "description": "the result",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid: unsupported method; Allow names the supported method",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid: the JSON request envelope exceeds 8 MiB",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "read a space and its descendants over an explicit snapshot manifest",
        "tags": [
          "read"
        ]
      }
    },
    "/v1/read": {
      "post": {
        "operationId": "read",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReadRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReadResult"
                }
              }
            },
            "description": "the result",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid: unsupported method; Allow names the supported method",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid: the JSON request envelope exceeds 8 MiB",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "read a fixed prefix of one journal, optionally filtered, one page at a time",
        "tags": [
          "read"
        ]
      }
    },
    "/v1/resolve": {
      "post": {
        "operationId": "resolve",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ResolveRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResolveResult"
                }
              }
            },
            "description": "the result",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "not_found",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "405": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid: unsupported method; Allow names the supported method",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "invalid: the JSON request envelope exceeds 8 MiB",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "internal",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            },
            "description": "unavailable",
            "headers": {
              "Ulab-Contract": {
                "required": true,
                "schema": {
                  "const": "2026-09-12",
                  "type": "string"
                }
              },
              "Ulab-Service": {
                "required": true,
                "schema": {
                  "const": "journal",
                  "type": "string"
                }
              }
            }
          }
        },
        "summary": "resolve a path to its current occupant, or an exact space identity to its path",
        "tags": [
          "read"
        ]
      }
    }
  },
  "servers": [
    {
      "description": "the standalone default listener",
      "url": "http://127.0.0.1:8092"
    }
  ]
}