diffbutler 0.6.0__tar.gz → 0.7.0__tar.gz

{diffbutler-0.6.0 → diffbutler-0.7.0}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: diffbutler
-Version: 0.6.0
+Version: 0.7.0
 Summary: A terminal dashboard for human-directed AI code reviews.
 Keywords: code-review,github,terminal,ai
 License-Expression: MIT
 License-File: LICENSE.txt
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3 :: Only
@@ -34,7 +34,7 @@ Keep track of what each pull request needs next: AI review, your review, or auth
 changes. Start an AI review, discuss its findings in the agent's own session, and
 finish your review in the browser.
 
-![DiffButler dashboard showing pull requests and the next review action](diffbutler.png)
+![DiffButler dashboard showing pull requests and the next review action](https://raw.githubusercontent.com/heikkitoivonen/diffbutler/main/diffbutler.png)
 
 ## Install
 
@@ -108,8 +108,8 @@ The dashboard shows active reviews, including followed PRs whose GitHub review
 requests have disappeared after you posted feedback. Waiting-for-author reviews
 stay visible across refreshes and restarts. If an approved PR receives new commits,
 it reappears as `done+` at the end of the queue without starting another AI review.
-Authenticated polling slows when API quota is scarce and speeds back up when it
-recovers, accounting for refresh cost and time until the quota resets.
+Polling spreads API quota evenly until it resets, leaving 10% in reserve: it slows
+when quota is scarce or refreshes are costly and speeds back up when quota recovers.
 
 Select a PR with the arrow keys, then work through the review:
 
@@ -128,7 +128,8 @@ Select a PR with the arrow keys, then work through the review:
    starts a new run with the current reviewer and replaces the current review details.
    Ask questions and explicitly tell the agent which comments to post, if any.
 3. Exit the agent to return to the dashboard, which refreshes activity from GitHub.
-   Press `w` if you are waiting for author changes, or `o` to review in your browser.
+   Press `o` to open the PR in your browser at any time; it does not change the state.
+   Press `w` if you are waiting for author changes, or `a` once you are ready to approve.
 4. After approving on GitHub, press `m` to mark the task complete locally. DiffButler
    also detects your approval, closure, or merge and cleans up owned session resources
    while retaining review history.
@@ -140,7 +141,7 @@ uses the agent's [native permission controls](docs/native-reviews.md#native-perm
 and read-only review instructions; source sent to the agent may go to its model provider.
 
 - `/`: Filter the queue.
-- `a`: Toggle monitoring all open PRs in configured repositories.
+- `A`: Toggle monitoring all open PRs in configured repositories.
 - `b`: Browse accessible PRs and follow one.
 - `R`: Find and add a PR by link or number, then review it; choose a repository if
   the number is ambiguous. Explicitly selected PRs bypass queue visibility filters.
@@ -148,6 +149,7 @@ and read-only review instructions; source sent to the agent may go to its model
 - `k`: Stop the selected PR's review and reset its local tracking and owned resources.
   It disappears until a forge refresh rediscovers it; review history is retained.
 - `h`: View completed review history.
+- `,`: Edit settings; saved changes apply without restarting.
 - `?`: Show all keyboard shortcuts.
 - `q`: Quit.
 
@@ -161,6 +163,29 @@ PRs assigned to you are also hidden by default, even when
 you are requested directly or through a team. Set `include_assigned_prs = true` in
 `[ui]` to include them, or select one with `R`.
 
+### How PRs move through the board
+
+Solid arrows are actions you take; dashed arrows happen automatically.
+
+How a PR arrives:
+
+![Flow diagram: review requests and all-PR monitoring reach the board through polling, browsing adds followed PRs, and your own or assigned PRs are hidden unless enabled; R adds a PR directly and starts a review. New PRs start as pending unless already approved, closed, or merged.](https://raw.githubusercontent.com/heikkitoivonen/diffbutler/main/docs/diagrams/pr-arrival.svg)
+
+How its status changes:
+
+![State diagram: r queues a review, the worker runs it, and the result is approve or check; w, a, and m move a PR between author, approve, and done; Ctrl+C or a failed agent returns it to pending; GitHub commits, your submitted reviews, and closes or merges move it automatically; new commits after approval show done+.](https://raw.githubusercontent.com/heikkitoivonen/diffbutler/main/docs/diagrams/pr-status.svg)
+
+`r`, `a`, `w`, and `m` work from any open status, not only along the arrows shown,
+though `r` refuses while a review is already queued or running. New commits on a
+`done+` PR keep it `done+` rather than returning it to `pending`.
+
+How it leaves:
+
+![Flow diagram: m, your approval, or a close or merge moves a PR to done and history; k removes it until a refresh finds it still requested or monitored; becoming an assignee hides it unless include_assigned_prs is set or it was selected with R.](https://raw.githubusercontent.com/heikkitoivonen/diffbutler/main/docs/diagrams/pr-exit.svg)
+
+A PR stays on the board when its review request is withdrawn; press `k` to remove it.
+A PR you only followed stays away after `k` until you follow it again.
+
 ## Reset
 
 Close running DiffButler sessions, then run:

{diffbutler-0.6.0 → diffbutler-0.7.0}/README.md

@@ -6,7 +6,7 @@ Keep track of what each pull request needs next: AI review, your review, or auth
 changes. Start an AI review, discuss its findings in the agent's own session, and
 finish your review in the browser.
 
-![DiffButler dashboard showing pull requests and the next review action](diffbutler.png)
+![DiffButler dashboard showing pull requests and the next review action](https://raw.githubusercontent.com/heikkitoivonen/diffbutler/main/diffbutler.png)
 
 ## Install
 
@@ -80,8 +80,8 @@ The dashboard shows active reviews, including followed PRs whose GitHub review
 requests have disappeared after you posted feedback. Waiting-for-author reviews
 stay visible across refreshes and restarts. If an approved PR receives new commits,
 it reappears as `done+` at the end of the queue without starting another AI review.
-Authenticated polling slows when API quota is scarce and speeds back up when it
-recovers, accounting for refresh cost and time until the quota resets.
+Polling spreads API quota evenly until it resets, leaving 10% in reserve: it slows
+when quota is scarce or refreshes are costly and speeds back up when quota recovers.
 
 Select a PR with the arrow keys, then work through the review:
 
@@ -100,7 +100,8 @@ Select a PR with the arrow keys, then work through the review:
    starts a new run with the current reviewer and replaces the current review details.
    Ask questions and explicitly tell the agent which comments to post, if any.
 3. Exit the agent to return to the dashboard, which refreshes activity from GitHub.
-   Press `w` if you are waiting for author changes, or `o` to review in your browser.
+   Press `o` to open the PR in your browser at any time; it does not change the state.
+   Press `w` if you are waiting for author changes, or `a` once you are ready to approve.
 4. After approving on GitHub, press `m` to mark the task complete locally. DiffButler
    also detects your approval, closure, or merge and cleans up owned session resources
    while retaining review history.
@@ -112,7 +113,7 @@ uses the agent's [native permission controls](docs/native-reviews.md#native-perm
 and read-only review instructions; source sent to the agent may go to its model provider.
 
 - `/`: Filter the queue.
-- `a`: Toggle monitoring all open PRs in configured repositories.
+- `A`: Toggle monitoring all open PRs in configured repositories.
 - `b`: Browse accessible PRs and follow one.
 - `R`: Find and add a PR by link or number, then review it; choose a repository if
   the number is ambiguous. Explicitly selected PRs bypass queue visibility filters.
@@ -120,6 +121,7 @@ and read-only review instructions; source sent to the agent may go to its model
 - `k`: Stop the selected PR's review and reset its local tracking and owned resources.
   It disappears until a forge refresh rediscovers it; review history is retained.
 - `h`: View completed review history.
+- `,`: Edit settings; saved changes apply without restarting.
 - `?`: Show all keyboard shortcuts.
 - `q`: Quit.
 
@@ -133,6 +135,29 @@ PRs assigned to you are also hidden by default, even when
 you are requested directly or through a team. Set `include_assigned_prs = true` in
 `[ui]` to include them, or select one with `R`.
 
+### How PRs move through the board
+
+Solid arrows are actions you take; dashed arrows happen automatically.
+
+How a PR arrives:
+
+![Flow diagram: review requests and all-PR monitoring reach the board through polling, browsing adds followed PRs, and your own or assigned PRs are hidden unless enabled; R adds a PR directly and starts a review. New PRs start as pending unless already approved, closed, or merged.](https://raw.githubusercontent.com/heikkitoivonen/diffbutler/main/docs/diagrams/pr-arrival.svg)
+
+How its status changes:
+
+![State diagram: r queues a review, the worker runs it, and the result is approve or check; w, a, and m move a PR between author, approve, and done; Ctrl+C or a failed agent returns it to pending; GitHub commits, your submitted reviews, and closes or merges move it automatically; new commits after approval show done+.](https://raw.githubusercontent.com/heikkitoivonen/diffbutler/main/docs/diagrams/pr-status.svg)
+
+`r`, `a`, `w`, and `m` work from any open status, not only along the arrows shown,
+though `r` refuses while a review is already queued or running. New commits on a
+`done+` PR keep it `done+` rather than returning it to `pending`.
+
+How it leaves:
+
+![Flow diagram: m, your approval, or a close or merge moves a PR to done and history; k removes it until a refresh finds it still requested or monitored; becoming an assignee hides it unless include_assigned_prs is set or it was selected with R.](https://raw.githubusercontent.com/heikkitoivonen/diffbutler/main/docs/diagrams/pr-exit.svg)
+
+A PR stays on the board when its review request is withdrawn; press `k` to remove it.
+A PR you only followed stays away after `k` until you follow it again.
+
 ## Reset
 
 Close running DiffButler sessions, then run:

{diffbutler-0.6.0 → diffbutler-0.7.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "diffbutler"
-version = "0.6.0"
+version = "0.7.0"
 description = "A terminal dashboard for human-directed AI code reviews."
 readme = "README.md"
 requires-python = ">=3.14"
@@ -13,7 +13,7 @@ keywords = [
     "ai",
 ]
 classifiers = [
-    "Development Status :: 3 - Alpha",
+    "Development Status :: 4 - Beta",
     "Environment :: Console",
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3 :: Only",
@@ -53,11 +53,12 @@ dev = [
     "pytest-cov>=7.1.0",
     "pytest-xdist>=3.8.0",
     "ruff>=0.16.5",
+    "zizmor>=1.32.0",
 ]
 
 [tool.uv]
 required-version = ">=0.12.13"
-exclude-newer = "2 days"
+exclude-newer = "8 days"
 
 [tool.ruff]
 target-version = "py314"

{diffbutler-0.6.0 → diffbutler-0.7.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "diffbutler"
-version = "0.6.0"
+version = "0.7.0"
 description = "A terminal dashboard for human-directed AI code reviews."
 readme = "README.md"
 requires-python = ">=3.14"
@@ -8,7 +8,7 @@ license = "MIT"
 license-files = ["LICENSE.txt"]
 keywords = ["code-review", "github", "terminal", "ai"]
 classifiers = [
-    "Development Status :: 3 - Alpha",
+    "Development Status :: 4 - Beta",
     "Environment :: Console",
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3 :: Only",
@@ -48,12 +48,13 @@ dev = [
     "pytest-cov>=7.1.0",
     "pytest-xdist>=3.8.0",
     "ruff>=0.16.5",
+    "zizmor>=1.32.0",
 ]
 
 [tool.uv]
 required-version = ">=0.12.13"
 # Give new dependency releases time to settle before routine upgrades.
-exclude-newer = "2 days"
+exclude-newer = "8 days"
 
 [tool.ruff]
 target-version = "py314"

{diffbutler-0.6.0 → diffbutler-0.7.0}/src/diffbutler/config/default.toml

@@ -5,7 +5,7 @@ reviewers = []
 
 [general]
 # Minimum: 60 seconds with authenticated accounts, 600 with any public account.
-# poll_interval_s = 600 # Override the minimum; low authenticated quota slows polling.
+# poll_interval_s = 600 # Override the minimum; low quota slows polling.
 max_concurrent_reviews = 2
 # Omit workspace_root to follow $XDG_DATA_HOME/diffbutler/reviews
 # (default ~/.local/share/diffbutler/reviews).
@@ -27,9 +27,7 @@ auto_migrate = true
 [review]
 findings_threshold = "minor" # blocking | important | minor | nit | question
 min_confidence = 0.5
-exclude_globs = ["**/*.lock", "**/vendor/**", "**/*.min.js", "**/generated/**"]
 mode = "source_only"
-checkout = "worktree" # Native reviews currently use pinned source snapshots.
 # default_reviewer = "codex"
 # prompt = "~/review-instructions.md"
 
@@ -37,7 +35,7 @@ checkout = "worktree" # Native reviews currently use pinned source snapshots.
 include_own_prs = false # Set true to review PRs authored by your account.
 include_assigned_prs = false # Set true to review PRs assigned to your account.
 columns = ["number", "title", "author", "state"]
-sort_by = "attention"
+sort_by = "state"
 sort_desc = true
 preview_pane = true
 default_filter = "active"
@@ -60,7 +58,6 @@ open_in_browser = ["o", "ctrl+o"]
 # git_transport = "auto" # auto | https | ssh; remembers the last successful fetch.
 # default_reviewer = "codex"
 # prompt = "~/review-instructions.md"
-# checkout = "mediated"
 
 # Remove the top-level forges = [] before adding forge accounts:
 # [[forges]]