feat(prs): add repository overview and reading panel for v0.3.0

Author: MilosMosovsky

CHANGELOG.md

@@ -6,6 +6,32 @@ All notable changes are documented here. The format follows
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-10-08
+
+### Added
+
+- Pull request reading panel with descriptions, changed files, review and check details, branches,
+  and linked local worktrees. Details load on selection, with shared requests, caching, and retry.
+- Searchable organization and repository picker, with PR totals and attention counts.
+- Direct GitHub links from every pull request row and the reading panel.
+
+### Changed
+
+- Replaced the wide pull request table with a repository overview and a separate sticky reader.
+  The list follows normal page scrolling; phones open the reader with a Back to pull requests action.
+- Compact `organization / repository` headings show counts and latest commit time, including when
+  collapsed. Organizations and repositories follow the selected activity or name sort.
+- Repository previews show two pull requests with a Show more action; search and filters show all
+  matching results. Repository expansion and the selected PR are remembered for the browser session.
+- Consolidated PR status controls into a dropdown alongside search, filters, and sorting.
+- Refreshed the README, design notes, and light, dark, and phone PR screenshots using synthetic data.
+
+### Fixed
+
+- Long check lists no longer stretch pull request rows; details are available in the reader.
+- Aligned repository metadata and pull request actions, with wrapping for long titles and paths.
+- Dividers stay clear of rounded selected, hovered, and keyboard-focused rows.
+
 ## [0.2.0] - 2026-10-07
 
 ### Added
@@ -55,6 +81,7 @@ First public release.
 - Single zero-dependency Go binary (around 20 MB RAM); Homebrew cask, release archives for macOS and
   Linux, and `scripts/install.sh`.
 
-[Unreleased]: https://github.com/MilosMosovsky/agentyard/compare/v0.2.0...HEAD
+[Unreleased]: https://github.com/MilosMosovsky/agentyard/compare/v0.3.0...HEAD
+[0.3.0]: https://github.com/MilosMosovsky/agentyard/releases/tag/v0.3.0
 [0.2.0]: https://github.com/MilosMosovsky/agentyard/releases/tag/v0.2.0
 [0.1.0]: https://github.com/MilosMosovsky/agentyard/releases/tag/v0.1.0

README.md

@@ -81,8 +81,8 @@ commit, the worktree's index and any uncommitted file. Sizes are `du` logical si
 ### Pull requests
 
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/prs-dark.png">
-  <img alt="The Pull requests page: colored status quick views, searchable multi-select filters, and a table where each PR shows the one thing blocking it." src="docs/screenshots/prs-light.png" width="100%">
+  <source media="(prefers-color-scheme: dark)" srcset="docs/screenshots/prs-dark.jpg">
+  <img alt="The Pull requests page: compact organization / repository groups with activity and status counts, direct GitHub links, and a sticky reader for the selected PR." src="docs/screenshots/prs-light.jpg" width="100%">
 </picture>
 
 Every open PR you authored (`is:pr is:open author:@me archived:false`, as whoever `gh` is logged in
@@ -102,8 +102,18 @@ this order:
 | **Blocked** | branch protection is not satisfied | |
 | **Ready to merge** | none of the above | who approved it |
 
-Next to the state: check counts, review state, last commit, diff size, and the local worktree that has
-the branch checked out. Status quick views give one-click access to needs-action, ready, waiting, draft, and queued PRs. The Filter menu combines multiple statuses, organizations, and repositories with search. Active selections can be removed individually; filters and sort order are remembered for the browser session.
+The overview groups PRs under compact `organization / repository` headings. Counts, attention
+indicators, and the latest commit time remain visible when a repository is collapsed. Groups follow
+your activity or name sort. Expanded repositories preview two PRs; **Show more** opens the rest.
+
+Select a PR to read its description, changed files, checks, reviews, branch, and linked local worktree
+in the sticky reader. The list scrolls with the page. **GitHub** links on each row and in the reader
+open the PR directly. On a phone, selection opens the reader with a **Back to pull requests** action.
+
+Use the repository heading's picker to find an organization or repository, the status dropdown for
+needs-action, ready, waiting, draft, or queued PRs, and **Filter** for multiple selections. Search and
+filters show all matching results without the two-PR preview limit. Active selections can be removed
+individually; filters, sorting, repository expansion, and the selected PR persist for the browser session.
 
 ### Sessions
 
@@ -135,7 +145,7 @@ every target is thumb-sized.
 <p align="center">
   <img alt="The Worktrees page on a phone: totals as a two-by-two grid and repositories as cards." src="docs/screenshots/phone-worktrees.png" width="260">
   &nbsp;&nbsp;
-  <img alt="The Pull requests page on a phone: status quick views, a mobile filter panel, and one card per PR with its blocker, checks and review." src="docs/screenshots/phone-prs.png" width="260">
+  <img alt="The Pull requests page on a phone: repository groups with activity counts, compact PR previews and direct GitHub actions." src="docs/screenshots/phone-prs.jpg" width="260">
 </p>
 
 **Sync now** (top right) re-runs the worktree scan, the PR poll and the session index right away and
@@ -379,8 +389,10 @@ manager.
 
 #### JSON
 
-The page's data is also served as JSON: `/api.json` (worktrees), `/api/prs.json` (pull requests) and
-`/api/status` (version, last scan times, whether a sync is running).
+The page's data is also served as JSON: `/api.json` (worktrees), `/api/prs.json` (pull requests),
+`/api/pr-detail?repo=OWNER/REPO&number=123` (description and changed files for a tracked PR), and
+`/api/status` (version, last scan times, whether a sync is running). PR details include up to the first
+100 changed files and the total changed-file count.
 
 ## Privacy and security
 
@@ -424,7 +436,8 @@ every 5 minutes, or on Sync now
 - **GitHub API cost.** One GraphQL query pages through your PRs 20 at a time: about 1 point per 20
   PRs per poll, so about 7 points every 5 minutes for 120 PRs, out of the 5,000 an hour GitHub
   allows. Failing check names are fetched only for PRs that have failures. Polling pauses while
-  fewer than 300 points remain.
+  fewer than 300 points remain. Descriptions and changed files load only when selected; simultaneous
+  requests share a query, and server results are cached for five minutes or until a new commit.
 - **Sessions without reading transcripts.** Each transcript is read as a 128 KB head and a 512 KB
   tail, and only again when the file changes. Opening a session reads just enough of its end for the
   latest 40 messages.

demo.go

@@ -215,7 +215,20 @@ func demoPRs(now time.Time) []*TrackedPR {
 		{Repo: "acme/infra", Number: 214, Title: "Terraform 1.9 and provider upgrades", Branch: "codex/terraform-1.9", IsDraft: true,
 			CreatedAt: ago(3 * h), LastCommit: ago(2 * h), Additions: 146, Deletions: 139,
 			ReviewDecision: "REVIEW_REQUIRED", Mergeable: "MERGEABLE", MergeState: "DRAFT",
-			Checks: CheckSummary{State: "PENDING", Passed: 4, Pending: 2}},
+			Checks: CheckSummary{State: "FAILURE", Passed: 122, Failed: 12, Failing: []string{
+				"Terraform validate — shared networking and private endpoints",
+				"Staging plan — database parameter group compatibility",
+				"Production plan — application workload identity bindings",
+				"Provider lock consistency across infrastructure modules",
+				"Policy checks — encrypted storage and backup retention",
+				"Module integration tests — object storage lifecycle",
+				"Module integration tests — managed database failover",
+				"Container registry access — staging deployment identity",
+				"Migration lint — resource address replacement detection",
+				"Documentation — generated module inputs and outputs",
+				"Dependency audit — provider version constraints",
+				"Deployment preview — staging service health checks",
+			}}},
 		{Repo: "acme/infra", Number: 210, Title: "Pin the AWS provider to 5.x across modules", Branch: "chore/pin-aws-provider",
 			CreatedAt: ago(8 * d), LastCommit: ago(6 * d), Additions: 27, Deletions: 27,
 			ReviewDecision: "APPROVED", Approvers: []string{"priya-r"}, Mergeable: "MERGEABLE", MergeState: "BEHIND",
@@ -235,6 +248,43 @@ func demoPRs(now time.Time) []*TrackedPR {
 	return prs
 }
 
+// Descriptions and file paths are synthetic, just like the rest of the demo.
+func demoPRDetail(pr *TrackedPR) PRDetail {
+	bodies := map[int]string{
+		482:  "## Summary\n\nPrevent concurrent refresh requests from rotating the same token twice. Requests for a session share the pending refresh and receive the newly issued token.\n\n## Validation\n\nAdded concurrent refresh coverage and ran the auth suite with the race detector.",
+		476:  "## Summary\n\nWrite payments to both ledgers during migration. Reconciliation compares balances before switching the read path.\n\n## Rollout\n\nKeep the original ledger available for rollback. The PostgreSQL integration test and migration lint check need attention before this can merge.",
+		479:  "Accept an idempotency key when creating a charge. Repeated requests return the original result instead of creating another charge.\n\nKeys expire after 24 hours and are scoped to the account.",
+		471:  "Write CSV rows to the response as they are read from the database, keeping memory use bounded for large exports.\n\nStop reading when the client disconnects. Tested with a million-row export and an interrupted download.",
+		1291: "Give shipping its own checkout step and validation state. Customers can edit their address without losing their payment information.\n\nThe branch needs a rebase after the recent checkout layout changes.",
+		1279: "Restore saved cart contents when a customer signs in on another device.\n\nReview feedback asks for explicit behavior when a saved item is no longer available.",
+		1284: "Load the product carousel when it approaches the viewport. The first product image keeps its eager loading behavior.\n\nReduces initial JavaScript and image requests on product pages.",
+		214:  "Upgrade Terraform and pin provider versions across infrastructure modules.\n\nStill preparing the staging apply and migration notes. This PR is not ready for review.",
+		210:  "Pin the AWS provider to the same supported major version in every module.\n\nUpdate the dependency locks and verify the generated plan.",
+		88:   "Add support for pushing eligible linked assets on HTTP/2 connections.\n\nCover cancellation and cache behavior in the protocol tests. The compatibility checks are still running.",
+		12:   "Initialize Node and Python version managers only when their commands are first used.\n\nProject-specific version selection keeps working while interactive shell startup gets faster.",
+	}
+	files := map[string][]string{
+		"acme/api":           {"internal/api/handler.go", "internal/api/handler_test.go", "docs/api.md"},
+		"acme/web":           {"src/checkout/Checkout.tsx", "src/checkout/Checkout.test.tsx"},
+		"acme/infra":         {"infra/versions.tf", "infra/.terraform.lock.hcl"},
+		"acme-labs/tinyhttp": {"src/http2/server.ts", "tests/http2/server.test.ts"},
+		"ada/dotfiles":       {"zsh/config.zsh", "zsh/lazy-tools.zsh"},
+	}
+	detail := PRDetail{Body: bodies[pr.Number], Author: "ada", Files: []PRFile{}}
+	paths := files[pr.Repo]
+	for i, path := range paths {
+		// Keep per-file diff totals consistent with the synthetic PR summary.
+		added, removed := pr.Additions/len(paths), pr.Deletions/len(paths)
+		if i == 0 {
+			added += pr.Additions % len(paths)
+			removed += pr.Deletions % len(paths)
+		}
+		detail.Files = append(detail.Files, PRFile{Path: path, Additions: added, Deletions: removed})
+	}
+	detail.ChangedFiles = len(detail.Files)
+	return detail
+}
+
 // ---------------------------------------------------------------- sessions
 
 // convo turns a script into messages ending at end: "> " is the person,

docs/design/brief.md

@@ -22,9 +22,13 @@ Search and multi-select verdict/repository filters update the map, metrics, proj
 
 ## Pull requests
 
-Colored status quick views filter by the server's workflow tone. The shared Filter menu combines statuses, organizations, and repositories. Selections use OR within a field and AND between fields; option counts exclude that option's own field. Active selections can be removed individually, and Reset all clears them with search.
+A repository workspace header shows the current scope, PR total, attention count, and latest activity. Its searchable picker moves between all repositories, an organization, or a single repository. The status dropdown and shared Filter menu use the same option catalog and selection state. Selections use OR within a field and AND between fields; option counts exclude that option's own field. Active selections can be removed individually, and Reset all clears them with search.
 
-The table keeps blocker, checks, and review evidence distinct. Activity combines last commit and opened time to preserve readable column widths. Status text must wrap at words rather than split words into fragments.
+The left overview uses inline `organization / repository` headings with aligned attention, count, and activity columns. Organizations and repositories follow the chosen activity or name sort. Collapsed repositories retain their metadata; expanded groups show two PR previews with a Show more action. Search and filtering lift this preview limit. A GitHub action is always available on each row.
+
+The overview follows normal document scrolling. A separate sticky reader shows the selected PR's description, changed files, checks, reviews, branch, and local worktree. Long checks use a disclosure in the reader rather than stretching list rows. Below 900px, the reader replaces the list and offers a Back to pull requests action with focus restoration. Below 640px, existing mobile navigation remains unchanged.
+
+Selected, hovered, and keyboard-focused rows have quiet rounded surfaces. A single boundary renderer suppresses separators on both sides of those surfaces, using the actually visible rows so filtering and previews do not leave orphan dividers. Long titles wrap; metadata stays aligned. Descriptions render a small Markdown subset as text and safe elements, never raw HTML.
 
 ## Sessions