Skip to content

Show the revision history of a page - #184

Merged
markusressel merged 1 commit into
feature/historyfrom
history-list
Nov 14, 2026
Merged

markusressel merged 1 commit into
feature/historyfrom
history-list

Conversation

@markusressel

Copy link
Copy Markdown
Member

A1 of the shared history concept (web, Android, backend). This PR goes into feature/history, which needs backend B1 (MkDocsEditor-Backend#96) in production before it reaches master.

  • Entry point: editor menu → "History" (HistoryScreen, HistoryViewModel).
  • List: newest first. Each entry shows the author's avatar and color, with a robot badge if an agent made the change. It names "Anna, Bob via Claude Code", the time, +n −m with the changed headings, and the commit message when it isn't the standard "Update ".
  • Diff: tapping an entry loads the diff from the commit before it (format=json). Hunks are shown inline as Markdown source, with changed words marked inside paired −/+ lines (wordChanges, pairChangedLines). Long lines scroll sideways.
  • Open in editor: tapping a hunk header opens the editor at the change, through the same ChangeLocation and heading/offset logic the feed uses.
  • Restore: editors get "Restore this version" on every entry but the newest, behind a confirm dialog, and the list reloads afterwards.
  • REST: getDocumentRevisionDiffHunks, plus B1's summary, agents and author display fields. The fixtures are real B1 answers from backend-2a.

Tests: models (real answers), word diff, hunk→location, the ViewModel with a fake client, and Robolectric UI. Not tried on a device yet: the only device connected was a personal phone.

🤖 Generated with Claude Code

The editor menu opens the history: who changed the page and when, with
agents and the changed headings. An entry opens to the inline diff of its
commit with the changed words marked, a hunk opens the editor there, and
editors can restore an older version.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@markusressel
markusressel merged commit 444169a into feature/history Nov 14, 2026
3 checks passed
@markusressel
markusressel deleted the history-list branch November 14, 2026 03:04
markusressel added a commit that referenced this pull request Nov 14, 2026
…changed a line (#187)

* Add a REST client for the revision history (#183)

Models follow a real backend answer: authors who are not accounts come
with empty strings, and times carry the committer's offset.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* Show the revision history of a page (#184)

The editor menu opens the history: who changed the page and when, with
agents and the changed headings. An entry opens to the inline diff of its
commit with the changed words marked, a hunk opens the editor there, and
editors can restore an older version.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* Tell what changed in a page since the last visit (#185)

* Tell what changed in a page since the last visit

On opening a page, a banner names who changed it since the account last
looked and where; it opens the changes hunk by hunk, and a hunk goes to its
place in the page. The server keeps the seen mark, set with the token of
the shown answer and again on leaving, so the own edits are no news later.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Fix what the emulator test against a real backend found

- The changes since the last visit were asked for inside a state update,
  which runs again when the state changed meanwhile: each run marked the
  page seen, so the shown answer was always empty. Leaving the page no
  longer marks it on ON_STOP either, which the screen gets while opening.
- The account itself is left out of the names of the banner.
- In the history an agent goes with its own person: "Bob via Claude Code,
  Anna" instead of "Bob, Anna via Claude Code".
- Lines with little in common get no word marks.
- A commit time a little ahead of the device clock reads as now.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* Undo a single change from the history (#186)

Editors on a server with revert get "Undo this change" on every entry but
the first version. Later changes stay; a conflict names the sections where
they are in the way. The history menu entry and the changes since the last
visit only show on servers that have them, read from server-info features.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* Restore a section from the history and tell who last changed a line (#188)

* Restore a single section from the history

A hunk under a heading of an older version offers to restore that section,
on servers with blame (which covers section restore), like the web client.
A section missing in the version or in the page is said in words. Adds the
REST client for blame as well.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Tell who last changed a line and when

A tap on the author strip, or on the line numbers next to it, asks the
server's blame and shows the author of the lines around it, their agents,
the time and the message of the change, with a way into the history.
Lines not committed yet say so instead of a time.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant