Review a git diff or PR, sharing state with the plannotator browser app

[bendrucker]

plannotator-tui only reviews documents. It could also support reviewing diffs.

The browser app handles them: plannotator review [--git | --gitbutler] [--local | --no-local] [--tailscale] [PR_URL] reviews local VCS changes or a GitHub/GitLab PR, backed by a semantic-diff/ directory under the shared Plannotator data dir.

Both already resolve XDG_DATA_HOME/plannotator and persist annotations to the same location.

Proposal

Let plannotator-tui open a diff or a PR (mirroring plannotator review's flags where sensible) and annotate it the same way it annotates a document today, reading and writing semantic-diff/ so a review started in the browser can finish in the terminal, or vice versa.

Interested in contributing a PR for this, will investigate further, opening this to track notes on what would be needed for this and how much effort it might be.

[backnotprop]

Yes. We're currently considering it and how to do it best. Keep posting your notes here as you dig in; we'll weigh in on the design before any code.

[bendrucker]

Spent some time poking around at this and scoping out the bits that could be built today in this repo versus architecture changes that would span all clients, i.e. TUI and browser. Cleaning them up to post shortly, first thing I'll flag:

backed by a semantic-diff/ directory

This was a mis-read, that directory is just for parking the sem CLI, not state persistence.