Versioning / History

[perber]

We want to keep versioning file-based.

A revisions/ folder should exist. Inside that folder, a folder with the pageId should be created.

Each change creates a snapshot (revision). It should be configurable how many revisions are stored. If the limit is exceeded, the oldest revisions must be deleted.

Revision filename format

revisions/<pageId>/<date-time>-<content-hash>.json

Example:
2025-12-09T13-45-10Z-9f2a1c3e.json

Revision JSON content

Each revision file must contain:

• pageID
• contentHash
• title
• content
• author
• timestamp

The content-hash is calculated by title + content.