Staff Review

Changelog

Notable changes to Staff Review, newest first.

Changelog

1.1.2 — 2026-06-03

Added

  • Syntax highlighting now uses Shiki's full bundled language registry. Staff Review no longer limits highlighting to a hand-picked subset of languages; it resolves Shiki language ids and aliases on demand, so uncommon source files are much more likely to highlight correctly.
  • Every bundled Shiki theme is available in settings. Light and dark syntax theme menus now come from Shiki's own theme metadata instead of a curated list.

Fixed

  • Proxied Staff Review pages load their split frontend assets. The binary release now embeds the generated CSS, JS, logo, and Shiki split chunks, and the server serves them by path so hostnames such as staff.sr.sparehost no longer load the page shell while 404ing or 502ing the chunks.
  • Backticked paths stay inside comment cards. Long inline-code filenames in review comments now wrap within the card instead of widening the sidebar and creating a horizontal scrollbar.
  • Dev HTML responses no longer emit duplicate Content-Length headers. The development server now serves Bun's HTML bundle as a direct route entry.

Changed

  • The README and CLI reference now document staff serve --port <n> alongside the related browser-opening flags.

1.1.1 — 2026-06-02

Fixed

  • Inline-comment file paths no longer overflow the sidebar. A long path:line on a review comment — or a long filename in the Files tab — used to push a horizontal scrollbar across the right sidebar. Both now left-truncate with an ellipsis so the base filename and line number stay visible.
  • staff no longer shares a port with another project. When another instance was already serving on the default port, a new staff could bind the same port and silently load-balance requests between the two projects. It now binds the port exclusively and walks up to the next free one as intended.
  • Diff reads tolerate half-written files. A diff read during a concurrent save could surface an unactionable JSON Parse error. Writes are now atomic (temp file + rename) and an empty/half-written file is treated as absent, so the error is gone. A genuinely corrupt file now reports a clear corrupt diff file message instead of being silently recreated empty.

1.1.0 — 2026-06-01

Added

  • Large diffs stay responsive. The web UI now auto-collapses files in big diffs instead of mounting every file's syntax-highlighted diff at once (a 100-file diff used to crawl). Generated/lock/minified/snapshot files and files over 1000 lines start collapsed, and the diff auto-expands at most 20 files / 6000 lines before collapsing the rest. Files with review comments — and binary/symlink rows — are always shown, and your explicit expand/collapse choices still win and persist. Each collapsed file is one click to open.

1.0.1 — 2026-06-01

Changed

  • /staff-docs now excludes bot-authored PR comments entirely (e.g. CodeRabbit, SonarCloud — anything GitHub marks user.type: "Bot"). They were previously eligible as recurring-bug/fix lessons, but in practice they're templated noise the base /staff-review already catches, so they no longer seed the docs library — only human review comments do.

1.0.0 — 2026-06-01

First stable release. Everything below landed since the 0.1.0 preview.

Reviews

  • Multi-agent /staff-review — the review fans out across parallel find sub-agents, then a second verify wave re-checks every finding to cut false positives before anything is posted as an inline comment. Fan-out width is the reviewAgents setting (or pass a number inline, e.g. /staff-review main..WT 6).
  • AI reviewers now set a priority (P1–P3) on each finding, so you can triage what to fix first.

Learning from your history

  • /staff-docs (with the /staff-docs-scout building block) — mines your review history (past Staff Review diffs and merged GitHub PRs via gh) for recurring, generalizable lessons, ranks them by impact, and turns the ones you keep into entries under .staffreview/docs/ that every future /staff-review checks against. The reading fans out across parallel scout sub-agents.
  • docsAgents setting controls the /staff-docs scout fan-out (default 5, range 1–20), in the gear menu or via staff settings.

Web UI

  • Comment-count badge on the Comments tab (matching the Files tab).
  • Compact diff header with abbreviated SHAs and fuller tooltips; app icon and favicon.
  • Inline image attachments on comments; real-time updates over WebSocket.
  • Binary files render as a compact row instead of being diffed as text.

Other

  • PORT env support and deterministic port selection for the local server.
  • Documentation site and landing page at staffreview.dev.

Changed

  • The captured-examples directory is now .staffreview/docs/ (previously .staffreview/library/).

Fixed

  • /staff-docs no longer labels a bot-authored PR comment as "caught by a human reviewer" — bot / automated reviewers are detected and their comments are only kept as recurring-bug or merged-fix lessons.

0.1.0 — 2026-05-30

Initial preview release: the staff CLI, the local web UI for reviewing a diff, the first /staff-* review skills, and Homebrew install (brew install staffreview/tap/staff).

On this page