world.ptah.version

ptah.world

Documentation

Edit history within a work. Tracks the evolution from draft to published to revised — every version, every change.

main record

Edit history within a work. Tracks the evolution from draft to published to revised — every version, every change.

Record Key tid Timestamp-based ID

Properties

changeDescription string Optional

What changed in this version

maxLength: 10240 bytesmaxGraphemes: 1024 graphemes
createdAt string datetime Required

Timestamp when this version was created

creatorDID string did Required

The permanent identity of the version's creator

isCurrent boolean Optional

Whether this is the current/active version

previousVersion string at-uri Optional

Reference to the version this replaced (empty = first version)

status string Optional

The status of this version

Known values: active, superseded, retracted, archived
versionLabel string Optional

Label describing this version stage

maxLength: 640 bytesmaxGraphemes: 64 graphemes
Known values: draft, published, revised, corrected, final
workReference string at-uri Required

Reference to the work this is a version of

worldReference string at-uri Required

Reference to the world this version belongs to

View raw schema
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "creatorDID",
      "worldReference",
      "createdAt",
      "workReference"
    ],
    "properties": {
      "status": {
        "type": "string",
        "description": "The status of this version",
        "knownValues": [
          "active",
          "superseded",
          "retracted",
          "archived"
        ]
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "Timestamp when this version was created"
      },
      "isCurrent": {
        "type": "boolean",
        "description": "Whether this is the current/active version"
      },
      "creatorDID": {
        "type": "string",
        "format": "did",
        "description": "The permanent identity of the version's creator"
      },
      "versionLabel": {
        "type": "string",
        "maxLength": 640,
        "description": "Label describing this version stage",
        "knownValues": [
          "draft",
          "published",
          "revised",
          "corrected",
          "final"
        ],
        "maxGraphemes": 64
      },
      "workReference": {
        "type": "string",
        "format": "at-uri",
        "description": "Reference to the work this is a version of"
      },
      "worldReference": {
        "type": "string",
        "format": "at-uri",
        "description": "Reference to the world this version belongs to"
      },
      "previousVersion": {
        "type": "string",
        "format": "at-uri",
        "description": "Reference to the version this replaced (empty = first version)"
      },
      "changeDescription": {
        "type": "string",
        "maxLength": 10240,
        "description": "What changed in this version",
        "maxGraphemes": 1024
      }
    }
  },
  "description": "Edit history within a work. Tracks the evolution from draft to published to revised — every version, every change."
}

Lexicon Garden

@