Michael Ramos 64062af9a1 feat: Portable Guided Reviews — export, share links, agent-authored guides, guides.show (#1324) ...

A Guided Review can now leave Plannotator: as a single self-contained HTML file that renders exactly like the in-app guide, as an encrypted-by-default share link on guides.show, or authored by any agent through the new guide CLI.

Highlights: packages/guide-viewer extracted from review-editor at the injection seam (read-only host, no third renderer); guides.show Worker with R2-backed share storage, per-IP rate limiting on creation, delete tokens hashed at rest, and 128-bit ids; portable exports pin the viewer by SRI hash with budget and manifest gates in PR CI and at deploy; two-runtime parity across Bun and Pi verified; v0.27.x saved guides load unchanged. Retention is indefinite by explicit decision, to revisit with the lean sharing refactor.

Decision record: adr/decisions/007-portable-guided-reviews-20260815.md

2026-08-16 12:17:13 -07:00

..

call-flow-runtime

feat(review): make the CallDiff runtime a strictly opt-in, in-UI install (#1270)

2026-08-11 16:28:08 -07:00

agent-jobs.ts

Make the document UI reusable as published building blocks (#957)

2026-07-06 20:39:09 -07:00

agent-terminal.ts

Make the document UI reusable as published building blocks (#957)

2026-07-06 20:39:09 -07:00

agents.ts

Make the document UI reusable as published building blocks (#957)

2026-07-06 20:39:09 -07:00

annotatable.ts

feat: annotate accepts YAML, JSON, TOML and other plain-text files (#1099)

2026-07-20 15:33:42 -07:00

annotate-args.test.ts

Make HTML annotations render HTML by default

2026-06-16 16:16:05 -07:00

annotate-args.ts

Make HTML annotations render HTML by default

2026-06-16 16:16:05 -07:00

annotate-client-lease.test.ts

feat(annotate): dismiss abandoned gate sessions (#1143)

2026-07-29 23:02:49 -07:00

annotate-client-lease.ts

feat(annotate): dismiss abandoned gate sessions (#1143)

2026-07-29 23:02:49 -07:00

annotate-decision.test.ts

feat(annotate): dismiss abandoned gate sessions (#1143)

2026-07-29 23:02:49 -07:00

annotate-decision.ts

feat(annotate): dismiss abandoned gate sessions (#1143)

2026-07-29 23:02:49 -07:00

annotate-history.ts

fix(annotate): persist submitted feedback before deleting the draft (#678) (#1237)

2026-08-09 16:16:57 -07:00

annotate-reference-roots-node.ts

Persist saved annotate file edits in drafts (#936)

2026-06-18 21:31:25 -07:00

annotate-target.test.ts

fix(annotate): recognize wrapped URLs in token probe and port #1185 coverage (#1187)

2026-08-03 13:25:41 -07:00

annotate-target.ts

fix(annotate): recognize wrapped URLs in token probe and port #1185 coverage (#1187)

2026-08-03 13:25:41 -07:00

archive-mode.ts

fix(annotate): enforce archive read-only surfaces (#1171)

2026-07-31 17:23:44 -07:00

at-reference.test.ts

feat(annotate): add --gate, --json, and --silent-approve flags (#570)

2026-04-23 17:40:40 -07:00

at-reference.ts

feat(annotate): add --gate, --json, and --silent-approve flags (#570)

2026-04-23 17:40:40 -07:00

browser-paths.ts

Make the document UI reusable as published building blocks (#957)

2026-07-06 20:39:09 -07:00

call-flow-install-lock.test.ts

feat(review): install Call Flow automatically in the background on opt-in (#1271)

2026-08-11 17:48:18 -07:00

call-flow-install-lock.ts

feat(review): install Call Flow automatically in the background on opt-in (#1271)

2026-08-11 17:48:18 -07:00

call-flow-install.test.ts

feat(review): make the CallDiff runtime a strictly opt-in, in-UI install (#1270)

2026-08-11 16:28:08 -07:00

call-flow-install.ts

feat(review): install Call Flow automatically in the background on opt-in (#1271)

2026-08-11 17:48:18 -07:00

call-flow-languages.test.ts

feat(review): make the CallDiff runtime a strictly opt-in, in-UI install (#1270)

2026-08-11 16:28:08 -07:00

call-flow-languages.ts

feat(review): make the CallDiff runtime a strictly opt-in, in-UI install (#1270)

2026-08-11 16:28:08 -07:00

call-flow-pack-locks.ts

feat(review): make the CallDiff runtime a strictly opt-in, in-UI install (#1270)

2026-08-11 16:28:08 -07:00

call-flow-types.test.ts

feat(review): refine Call Flow navigation and annotations (#1277)

2026-08-12 11:18:29 -07:00

call-flow-types.ts

feat(review): refine Call Flow navigation and annotations (#1277)

2026-08-12 11:18:29 -07:00

call-flow.test.ts

feat(review): jj support for Call Flow analysis (#1312)

2026-08-15 10:47:09 -07:00

call-flow.ts

feat(review): jj support for Call Flow analysis (#1312)

2026-08-15 10:47:09 -07:00

checklist.ts

feat: Pi-style iterative planning for OpenCode plugin (#318)

2026-03-16 16:13:57 -07:00

cli-pagination.ts

feat(review): large-PR pipeline, instant-open checkout, scroll perf, and worker-pool highlighting (#893)

2026-06-12 13:50:09 -07:00

code-file.ts

Make the document UI reusable as published building blocks (#957)

2026-07-06 20:39:09 -07:00

code-nav.test.ts

feat: search-based code navigation with peek view (#711)

2026-05-13 12:24:37 -07:00

code-nav.ts

feat: search-based code navigation with peek view (#711)

2026-05-13 12:24:37 -07:00

commit-avatars.test.ts

fix(review): avatar lookups can no longer delay /api/commits

2026-07-05 11:50:41 -07:00

commit-avatars.ts

fix(review): avatar lookups can no longer delay /api/commits

2026-07-05 11:50:41 -07:00

commit-history.test.ts

fix(review): bound server memory for large tracked-file diffs (#1167)

2026-08-03 13:25:35 -07:00

commit-history.ts

feat(review): Commits panel — linear history rail with per-commit diffs (#994)

2026-07-04 10:13:11 -07:00

compress.ts

Make the document UI reusable as published building blocks (#957)

2026-07-06 20:39:09 -07:00

config.test.ts

feat: Portable Guided Reviews — export, share links, agent-authored guides, guides.show (#1324)

2026-08-16 12:17:13 -07:00

config.ts

feat: Portable Guided Reviews — export, share links, agent-authored guides, guides.show (#1324)

2026-08-16 12:17:13 -07:00

crypto.ts

Make the document UI reusable as published building blocks (#957)

2026-07-06 20:39:09 -07:00

data-dir.test.ts

feat(data-dir): fall back to $XDG_DATA_HOME/plannotator when ~/.plannotator does not exist (#1093)

2026-07-20 08:55:12 -07:00

data-dir.ts

feat(data-dir): fall back to $XDG_DATA_HOME/plannotator when ~/.plannotator does not exist (#1093)

2026-07-20 08:55:12 -07:00

diff-fingerprint.test.ts

fix(review): bound server memory for large tracked-file diffs (#1167)

2026-08-03 13:25:35 -07:00

diff-paths.ts

feat: Portable Guided Reviews — export, share links, agent-authored guides, guides.show (#1324)

2026-08-16 12:17:13 -07:00

draft.test.ts

Add WebTUI agent panel to annotate mode (#941)

2026-06-19 09:04:15 -07:00

draft.ts

Add WebTUI agent panel to annotate mode (#941)

2026-06-19 09:04:15 -07:00

external-annotation.test.ts

fix(skills): harden skill references before first release (#1235)

2026-08-07 14:22:58 -07:00

external-annotation.ts

Make the document UI reusable as published building blocks (#957)

2026-07-06 20:39:09 -07:00

extract-code-paths.ts

Make the document UI reusable as published building blocks (#957)

2026-07-06 20:39:09 -07:00

favicon.ts

Make the document UI reusable as published building blocks (#957)

2026-07-06 20:39:09 -07:00

feedback-templates.ts

Make the document UI reusable as published building blocks (#957)

2026-07-06 20:39:09 -07:00

file-browser-watch-core.test.ts

fix(annotate): stop the folder watcher freezing the server (#1314)

2026-08-13 16:02:41 -07:00

file-browser-watch-core.ts

fix(annotate): stop the folder watcher freezing the server (#1314)

2026-08-13 16:02:41 -07:00

gitbutler-core.test.ts

fix(review): fall back across GitButler JSON flag syntaxes (but 0.22.0) (#1216)

2026-08-05 11:37:07 -07:00

gitbutler-core.ts

fix(review): fall back across GitButler JSON flag syntaxes (but 0.22.0) (#1216)

2026-08-05 11:37:07 -07:00

goal-setup.ts

Make the document UI reusable as published building blocks (#957)

2026-07-06 20:39:09 -07:00

guide-format-fixtures.ts

feat: Portable Guided Reviews — export, share links, agent-authored guides, guides.show (#1324)

2026-08-16 12:17:13 -07:00

guide-format.ts

feat: Portable Guided Reviews — export, share links, agent-authored guides, guides.show (#1324)

2026-08-16 12:17:13 -07:00

guide-instructions-store.test.ts

feat(guide): reviewer-supplied extra instructions for Guided Review (#1267)

2026-08-11 10:24:39 -07:00

guide-instructions-store.ts

feat(guide): reviewer-supplied extra instructions for Guided Review (#1267)

2026-08-11 10:24:39 -07:00

guide-store.test.ts

feat: Portable Guided Reviews — export, share links, agent-authored guides, guides.show (#1324)

2026-08-16 12:17:13 -07:00

guide-store.ts

feat: Portable Guided Reviews — export, share links, agent-authored guides, guides.show (#1324)

2026-08-16 12:17:13 -07:00

guide-viewer-manifest.ts

feat: Portable Guided Reviews — export, share links, agent-authored guides, guides.show (#1324)

2026-08-16 12:17:13 -07:00

guide.ts

feat: Portable Guided Reviews — export, share links, agent-authored guides, guides.show (#1324)

2026-08-16 12:17:13 -07:00

html-assets-node.ts

Open files in external apps + code-review UX pass (#942)

2026-06-19 08:56:06 -07:00

html-assets.test.ts

Make HTML annotations render HTML by default

2026-06-16 16:16:05 -07:00

html-assets.ts

Make HTML annotations render HTML by default

2026-06-16 16:16:05 -07:00

html-diff.test.ts

Render arbitrary HTML in HtmlViewer without altering it (#1023)

2026-07-08 13:11:01 -07:00

html-diff.ts

Render arbitrary HTML in HtmlViewer without altering it (#1023)

2026-07-08 13:11:01 -07:00

html-to-markdown.test.ts

feat(annotate): support HTML files and URL annotation (#545)

2026-04-12 18:56:28 -07:00

html-to-markdown.ts

Make HTML annotations render HTML by default

2026-06-16 16:16:05 -07:00

improvement-hooks.test.ts

feat(hook): improvement hook context injection for planning (#459)

2026-04-01 13:16:55 -07:00

improvement-hooks.ts

feat: add PLANNOTATOR_DATA_DIR env var to customize data directory (#795)

2026-05-26 14:56:07 -07:00

integrations-common.ts

feat(pi): complete Pi server rewrite — modular architecture, full Bun parity, shared code extraction (#382)

2026-03-24 00:44:54 -07:00

jj-core.test.ts

feat(review): jj support for Call Flow analysis (#1312)

2026-08-15 10:47:09 -07:00

jj-core.ts

feat(review): jj support for Call Flow analysis (#1312)

2026-08-15 10:47:09 -07:00

jj-snapshot.test.ts

feat(review): jj support for Call Flow analysis (#1312)

2026-08-15 10:47:09 -07:00

markdown-extensions.test.ts

feat(annotate): configurable extra markdown extensions (#1309)

2026-08-13 09:47:18 -07:00

markdown-extensions.ts

feat(annotate): configurable extra markdown extensions (#1309)

2026-08-13 09:47:18 -07:00

open-in-apps.ts

Make the document UI reusable as published building blocks (#957)

2026-07-06 20:39:09 -07:00

package.json

feat: Portable Guided Reviews — export, share links, agent-authored guides, guides.show (#1324)

2026-08-16 12:17:13 -07:00

pfm-reminder.test.ts

feat(hook): PFM reminder & improvement hook support across all runtimes (#689)

2026-05-11 08:14:13 -04:00

pfm-reminder.ts

feat(pfm): code line range references, hover preview, sketch Graphviz (#692)

2026-05-11 10:13:47 -04:00

plan-review-lifecycle.ts

Fix OpenCode plan review cancellation cleanup (#1064)

2026-07-16 14:15:23 -07:00

port-range.ts

feat(server): support bounded port ranges (#1042)

2026-07-16 06:31:52 -07:00

pr-artifact-document.test.ts

feat(review): add PR and MR artifact gallery (#1055)

2026-07-17 21:25:23 -07:00

pr-artifact-document.ts

feat(review): add PR and MR artifact gallery (#1055)

2026-07-17 21:25:23 -07:00

pr-context-live.test.ts

feat(review): PR Overview panel + description/comment annotations + media (#981)

2026-06-30 23:05:43 -07:00

pr-context-live.ts

feat(review): PR Overview panel + description/comment annotations + media (#981)

2026-06-30 23:05:43 -07:00

pr-github.test.ts

feat(review): large-PR pipeline, instant-open checkout, scroll perf, and worker-pool highlighting (#893)

2026-06-12 13:50:09 -07:00

pr-github.ts

fix(review): surface partial GitLab comment submissions (#1164)

2026-07-31 10:59:58 -07:00

pr-gitlab.test.ts

fix(review): surface partial GitLab comment submissions (#1164)

2026-07-31 10:59:58 -07:00

pr-gitlab.ts

fix(review): surface partial GitLab comment submissions (#1164)

2026-07-31 10:59:58 -07:00

pr-provider.test.ts

fix(gitlab): persist unposted inline comments + split pr-provider from browser-safe pr-types (#719)

2026-05-13 05:27:28 -07:00

pr-provider.ts

fix(review): surface partial GitLab comment submissions (#1164)

2026-07-31 10:59:58 -07:00

pr-stack.test.ts

fix(review): keep large-diff memory bound when the object-size probe fails (#1205)

2026-08-04 22:21:56 -07:00

pr-stack.ts

fix(review): bound server memory for large tracked-file diffs (#1167)

2026-08-03 13:25:35 -07:00

pr-types.ts

fix(review): surface partial GitLab comment submissions (#1164)

2026-07-31 10:59:58 -07:00

project.ts

Make the document UI reusable as published building blocks (#957)

2026-07-06 20:39:09 -07:00

prompts-integration.test.ts

feat(annotate): preserve notes on structured approval (#1092)

2026-07-26 21:09:28 -07:00

prompts.test.ts

feat(annotate): preserve notes on structured approval (#1092)

2026-07-26 21:09:28 -07:00

prompts.ts

feat(annotate): preserve notes on structured approval (#1092)

2026-07-26 21:09:28 -07:00

reference-common.test.ts

Fix annotate terminal startup in large folders

2026-07-08 12:33:12 -07:00

reference-common.ts

Fix annotate terminal startup in large folders

2026-07-08 12:33:12 -07:00

repo.ts

feat(ui): markdown reader parity — HTML blocks, GitHub alerts, GFM inline extras (#597)

2026-04-21 18:56:41 -07:00

resolve-file.test.ts

feat(annotate): configurable extra markdown extensions (#1309)

2026-08-13 09:47:18 -07:00

resolve-file.ts

feat(annotate): configurable extra markdown extensions (#1309)

2026-08-13 09:47:18 -07:00

review-args.test.ts

Add modern GitButler review support (#1067)

2026-07-17 07:37:50 -07:00

review-args.ts

Add modern GitButler review support (#1067)

2026-07-17 07:37:50 -07:00

review-core.test-d.ts

fix(review): bound server memory for large tracked-file diffs (#1167)

2026-08-03 13:25:35 -07:00

review-core.test.ts

feat(review): jj support for Call Flow analysis (#1312)

2026-08-15 10:47:09 -07:00

review-core.ts

feat(review): jj support for Call Flow analysis (#1312)

2026-08-15 10:47:09 -07:00

review-profiles.ts

feat(review): Cursor + OpenCode review engines (unified marker-review) (#959)

2026-06-24 14:35:52 -07:00

review-workspace-node.ts

fix: bound workspace repo discovery so symlink escapes can't stall startup

2026-07-19 22:47:46 -07:00

review-workspace.ts

fix(review): treat cross-drive relative() results as repo escapes (#1117)

2026-07-24 19:22:10 -07:00

semantic-diff-types.ts

feat(review): add semantic diff overview (#871)

2026-06-08 22:23:54 -07:00

semantic-diff.test.ts

feat(review): large-PR pipeline, instant-open checkout, scroll perf, and worker-pool highlighting (#893)

2026-06-12 13:50:09 -07:00

semantic-diff.ts

feat(review): large-PR pipeline, instant-open checkout, scroll perf, and worker-pool highlighting (#893)

2026-06-12 13:50:09 -07:00

single-flight.test.ts

Add modern GitButler review support (#1067)

2026-07-17 07:37:50 -07:00

single-flight.ts

Add modern GitButler review support (#1067)

2026-07-17 07:37:50 -07:00

source-save-node.test.ts

Persist saved annotate file edits in drafts (#936)

2026-06-18 21:31:25 -07:00

source-save-node.ts

Persist saved annotate file edits in drafts (#936)

2026-06-18 21:31:25 -07:00

source-save.ts

Make the document UI reusable as published building blocks (#957)

2026-07-06 20:39:09 -07:00

storage.ts

fix(annotate): persist submitted feedback before deleting the draft (#678) (#1237)

2026-08-09 16:16:57 -07:00

tailscale.test.ts

feat(remote): tailnet auto-advertise, ready QR code, and a first-class --tailscale mode (#1280)

2026-08-12 12:07:30 -07:00

tailscale.ts

feat(remote): tailnet auto-advertise, ready QR code, and a first-class --tailscale mode (#1280)

2026-08-12 12:07:30 -07:00

tour.ts

feat: Code Tour — guided PR walkthrough as a third agent provider (#569)

2026-04-20 20:57:57 -07:00

tsconfig.json

feat(pi): complete Pi server rewrite — modular architecture, full Bun parity, shared code extraction (#382)

2026-03-24 00:44:54 -07:00

types.ts

Make the document UI reusable as published building blocks (#957)

2026-07-06 20:39:09 -07:00

url-to-markdown.test.ts

feat(annotate): try Accept: text/markdown before Jina/Turndown (#557)

2026-04-13 21:30:09 -07:00

url-to-markdown.ts

Make HTML annotations render HTML by default

2026-06-16 16:16:05 -07:00

vcs-core.test.ts

fix(review): bound server memory for large tracked-file diffs (#1167)

2026-08-03 13:25:35 -07:00

vcs-core.ts

feat(review): jj support for Call Flow analysis (#1312)

2026-08-15 10:47:09 -07:00

workspace-status.test.ts

Fix folder watcher cold-start refs scan (#1306)

2026-08-13 09:45:59 -07:00

workspace-status.ts

Fix folder watcher cold-start refs scan (#1306)

2026-08-13 09:45:59 -07:00

worktree-pool.test.ts

fix(review): bound server memory for large tracked-file diffs (#1167)

2026-08-03 13:25:35 -07:00

worktree-pool.ts

fix(ai): drive Codex Ask AI via codex app-server (#971)

2026-06-28 09:58:09 -07:00

worktree.ts

feat(review): AI review agents, local worktree, and UI polish (#491)

2026-04-06 12:15:27 -07:00