diffbutler 0.5.2__tar.gz → 0.6.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: diffbutler
-Version: 0.5.2
+Version: 0.6.0
 Summary: A terminal dashboard for human-directed AI code reviews.
 Keywords: code-review,github,terminal,ai
 License-Expression: MIT
@@ -91,15 +91,18 @@ From the GitHub repository you want to review, launch:
 diffbutler
 ```
 
-First-run setup detects the local repository, looks up your GitHub username using
-the selected token, asks for your preferred agent, and saves your choices. If username detection
-is unavailable, setup asks for it. Choose the recommended token access for public repositories;
-private repositories require it. Setup asks for the token's environment variable name
-and validates access. It never saves the token.
+First-run setup detects the local repository and asks whether to monitor just that
+repository or all repositories belonging to the same owner. It looks up your GitHub
+username using the selected token, asks for your preferred agent, and saves your choices.
+If username detection is unavailable, setup asks for it. Choose the recommended token
+access for public repositories; private repositories require it. Setup asks for the
+token's environment variable name and validates access. It never saves the token.
 New configs silently enable both Codex and Claude when found in `PATH`; setup asks
 only which detected agent should be the default. Missing agents get commented-out
 entries you can enable after installation.
 Later launches reuse your configuration.
+Repository filters accept exact names such as `heikkitoivonen/diffbutler` or
+`heikkitoivonen/*` for all accessible repositories owned by that account.
 
 The dashboard shows active reviews, including followed PRs whose GitHub review
 requests have disappeared after you posted feedback. Waiting-for-author reviews
@@ -131,14 +134,17 @@ Select a PR with the arrow keys, then work through the review:
    while retaining review history.
 
 `Space` performs the selected PR's next action: start a review, discuss findings,
-or open the browser. An AI review never counts as your approval. Background analysis
+or open the browser. For `check` and `author`, it resumes the saved agent conversation,
+just like `c`. An AI review never counts as your approval. Background analysis
 uses the agent's [native permission controls](docs/native-reviews.md#native-permissions-and-authentication)
 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.
 - `b`: Browse accessible PRs and follow one.
-- `R`: Refresh from GitHub.
+- `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.
+- `Ctrl+R`: Refresh from GitHub.
 - `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.
@@ -149,10 +155,11 @@ See the [dashboard guide](docs/dashboard.md) for all actions and
 [configuration guide](docs/configuration.md) for settings.
 
 Your own PRs are hidden from the review queue by default, including direct and team
-requests. Set `include_own_prs = true` in `[ui]` to review them, such as PRs an agent
-created using your account. PRs assigned to you are also hidden by default, even when
+requests. Use `R` to select one explicitly, or set `include_own_prs = true` in `[ui]`
+to show them all, such as PRs an agent created using your account.
+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.
+`[ui]` to include them, or select one with `R`.
 
 ## Reset
 

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

@@ -63,15 +63,18 @@ From the GitHub repository you want to review, launch:
 diffbutler
 ```
 
-First-run setup detects the local repository, looks up your GitHub username using
-the selected token, asks for your preferred agent, and saves your choices. If username detection
-is unavailable, setup asks for it. Choose the recommended token access for public repositories;
-private repositories require it. Setup asks for the token's environment variable name
-and validates access. It never saves the token.
+First-run setup detects the local repository and asks whether to monitor just that
+repository or all repositories belonging to the same owner. It looks up your GitHub
+username using the selected token, asks for your preferred agent, and saves your choices.
+If username detection is unavailable, setup asks for it. Choose the recommended token
+access for public repositories; private repositories require it. Setup asks for the
+token's environment variable name and validates access. It never saves the token.
 New configs silently enable both Codex and Claude when found in `PATH`; setup asks
 only which detected agent should be the default. Missing agents get commented-out
 entries you can enable after installation.
 Later launches reuse your configuration.
+Repository filters accept exact names such as `heikkitoivonen/diffbutler` or
+`heikkitoivonen/*` for all accessible repositories owned by that account.
 
 The dashboard shows active reviews, including followed PRs whose GitHub review
 requests have disappeared after you posted feedback. Waiting-for-author reviews
@@ -103,14 +106,17 @@ Select a PR with the arrow keys, then work through the review:
    while retaining review history.
 
 `Space` performs the selected PR's next action: start a review, discuss findings,
-or open the browser. An AI review never counts as your approval. Background analysis
+or open the browser. For `check` and `author`, it resumes the saved agent conversation,
+just like `c`. An AI review never counts as your approval. Background analysis
 uses the agent's [native permission controls](docs/native-reviews.md#native-permissions-and-authentication)
 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.
 - `b`: Browse accessible PRs and follow one.
-- `R`: Refresh from GitHub.
+- `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.
+- `Ctrl+R`: Refresh from GitHub.
 - `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.
@@ -121,10 +127,11 @@ See the [dashboard guide](docs/dashboard.md) for all actions and
 [configuration guide](docs/configuration.md) for settings.
 
 Your own PRs are hidden from the review queue by default, including direct and team
-requests. Set `include_own_prs = true` in `[ui]` to review them, such as PRs an agent
-created using your account. PRs assigned to you are also hidden by default, even when
+requests. Use `R` to select one explicitly, or set `include_own_prs = true` in `[ui]`
+to show them all, such as PRs an agent created using your account.
+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.
+`[ui]` to include them, or select one with `R`.
 
 ## Reset
 

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

@@ -1,6 +1,6 @@
 [project]
 name = "diffbutler"
-version = "0.5.2"
+version = "0.6.0"
 description = "A terminal dashboard for human-directed AI code reviews."
 readme = "README.md"
 requires-python = ">=3.14"
@@ -39,7 +39,7 @@ dependencies = [
 diffbutler = "diffbutler.ui.cli:main"
 
 [build-system]
-requires = ["uv_build>=0.12.13,<0.13.0"]
+requires = ["uv_build>=0.12.13,<0.14.0"]
 build-backend = "uv_build"
 
 [dependency-groups]
@@ -56,8 +56,8 @@ dev = [
 ]
 
 [tool.uv]
-required-version = ">=0.12.13,<0.13"
-exclude-newer = "15 days"
+required-version = ">=0.12.13"
+exclude-newer = "2 days"
 
 [tool.ruff]
 target-version = "py314"

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

@@ -1,6 +1,6 @@
 [project]
 name = "diffbutler"
-version = "0.5.2"
+version = "0.6.0"
 description = "A terminal dashboard for human-directed AI code reviews."
 readme = "README.md"
 requires-python = ">=3.14"
@@ -34,7 +34,7 @@ dependencies = [
 diffbutler = "diffbutler.ui.cli:main"
 
 [build-system]
-requires = ["uv_build>=0.12.13,<0.13.0"]
+requires = ["uv_build>=0.12.13,<0.14.0"]
 build-backend = "uv_build"
 
 [dependency-groups]
@@ -51,9 +51,9 @@ dev = [
 ]
 
 [tool.uv]
-required-version = ">=0.12.13,<0.13"
+required-version = ">=0.12.13"
 # Give new dependency releases time to settle before routine upgrades.
-exclude-newer = "15 days"
+exclude-newer = "2 days"
 
 [tool.ruff]
 target-version = "py314"

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

@@ -69,6 +69,7 @@ open_in_browser = ["o", "ctrl+o"]
 # token_env = "GITHUB_TOKEN" # Omit for public access (None); login is then required.
 # include_team_requests = true
 # repositories = [] # Empty means review requests from all accessible repositories.
+# Use ["owner/repo"] for one repository or ["owner/*"] for all of an owner's repositories.
 # login = "your-login"
 
 # Remove the top-level reviewers = [] before adding reviewers:

{diffbutler-0.5.2 → diffbutler-0.6.0}/src/diffbutler/config/setup.py

@@ -15,7 +15,7 @@ from diffbutler.config.settings import NATIVE_PRESETS, ConfigError, Forge, Revie
 def save_setup(
     path: Path | None,
     forge: Forge | None,
-    repository_path: Path | None,
+    local_repository: tuple[str, Path] | None,
     reviewers: Sequence[Reviewer] = (),
     default_reviewer: str | None = None,
 ) -> Path:
@@ -40,7 +40,8 @@ def save_setup(
             if "review" not in document:
                 document["review"] = tomlkit.table()
             document["review"]["default_reviewer"] = default_reviewer
-        if repository_path is not None and forge is not None:
+        if local_repository is not None and forge is not None:
+            repository, repository_path = local_repository
             repos = document.get("repos")
             if repos is None:
                 repos = tomlkit.table()
@@ -48,7 +49,6 @@ def save_setup(
             if not isinstance(repos, MutableMapping):
                 raise ConfigError("Use a [repos] table to save local repository paths")
             repos = cast(MutableMapping[str, Any], repos)
-            repository = forge.repositories[0]
             if repository not in repos:
                 repos[repository] = {"path": str(repository_path)}
             else:

{diffbutler-0.5.2 → diffbutler-0.6.0}/src/diffbutler/core/application.py

@@ -1,14 +1,16 @@
 """Configured shared-core entry points with owned database/forge lifetimes."""
 
 import asyncio
+import re
 from collections.abc import AsyncGenerator
 from contextlib import asynccontextmanager
 from pathlib import Path
 from typing import Literal
 
 from diffbutler.config.settings import Settings, load_settings
+from diffbutler.core.pr_lookup import ReviewTarget, numbered_prs, open_pr
 from diffbutler.core.sync import DiffButler, PullRequestRow, SyncReport, list_queue
-from diffbutler.domain.forge import PRPage, PRQuery
+from diffbutler.domain.forge import Account, PRPage, PRQuery, PRRef
 from diffbutler.forges.base import ForgeError
 from diffbutler.forges.registry import open_forge
 from diffbutler.store.dashboard import SQLiteDashboardStore
@@ -88,6 +90,56 @@ async def browse_configured(
         return await service.browse_prs(query, cursor)
 
 
+async def review_targets_configured(path: Path | None, value: str) -> tuple[ReviewTarget, ...]:
+    """Resolve without following PRs or requesting any AI work."""
+    value = value.strip()
+    numeric = re.fullmatch(r"#?([1-9][0-9]*)", value)
+    if not numeric and not value.startswith("https://"):
+        raise ForgeError("Enter a PR link or a positive PR number")
+    found: dict[tuple[Account, PRRef], ReviewTarget] = {}
+    async with local_store(path) as (store, settings):
+        if not settings.forges:
+            raise ForgeError("No forge configured")
+        if numeric and not any(config.repositories for config in settings.forges):
+            raise ForgeError("No monitored repositories configured; enter a PR link instead")
+        matched_url = False
+        for index, config in enumerate(settings.forges, 1):
+            if numeric and not config.repositories:
+                continue
+            async with remote_service(store, settings, index) as service:
+                if numeric:
+                    prs = await numbered_prs(service.forge, config.repositories, int(numeric[1]))
+                else:
+                    try:
+                        ref = service.forge.ref(value)
+                    except ForgeError:
+                        continue
+                    matched_url = True
+                    pr = await open_pr(service.forge, ref)
+                    prs = (pr,) if pr else ()
+                account = await service.forge.whoami()
+                if config.login and account.login.casefold() != config.login.casefold():
+                    raise ForgeError("Authenticated identity does not match configured account")
+                for pr in prs:
+                    found.setdefault((account, pr.ref), ReviewTarget(index, account, pr))
+        if not numeric and not matched_url:
+            raise ForgeError("Enter a valid PR link on a configured forge")
+    return tuple(found.values())
+
+
+async def follow_review_target_configured(
+    path: Path | None, target: ReviewTarget
+) -> PullRequestRow:
+    """Revalidate the chosen account and open state before tracking a review target."""
+    async with (
+        local_store(path) as (store, settings),
+        remote_service(store, settings, target.forge_index) as service,
+    ):
+        if await service.forge.whoami() != target.account:
+            raise ForgeError("Configured account changed; look up the PR again")
+        return await service.follow_pr(target.pull_request.ref, for_review=True)
+
+
 async def local_queue(
     path: Path | None,
     view: Literal["active", "requested", "following"],

{diffbutler-0.5.2 → diffbutler-0.6.0}/src/diffbutler/core/dashboard.py

@@ -176,15 +176,23 @@ async def dashboard_rows(
         for row in rows:
             if row.tracked.state == "DONE":
                 continue
-            if view == "triage" and row.tracked.state != "FINDINGS_TRIAGE":
+            if (
+                not row.tracked.explicit_review
+                and view == "triage"
+                and row.tracked.state != "FINDINGS_TRIAGE"
+            ):
                 continue
-            if view == "posted" and row.tracked.state != "PENDING_AUTHOR_CHANGES":
+            if (
+                not row.tracked.explicit_review
+                and view == "posted"
+                and row.tracked.state != "PENDING_AUTHOR_CHANGES"
+            ):
                 continue
             pr = row.tracked.pull_request
             searchable = (
                 f"{pr.ref.namespace}/{pr.ref.repository}#{pr.ref.number} {pr.title} {pr.author}"
             )
-            if text.lower() not in searchable.lower():
+            if not row.tracked.explicit_review and text.lower() not in searchable.lower():
                 continue
             run = await store.latest_run(row.tracked.task_id) if row.tracked.task_id else None
             analysis = await reviews.get_result(run.id) if run else None

{diffbutler-0.5.2 → diffbutler-0.6.0}/src/diffbutler/core/managed.py

@@ -296,6 +296,9 @@ class ManagedReviews:
             findings_threshold=self.settings.review.findings_threshold,
         )
         try:
+            # Record explicit intent before maintenance can wait on another PR's I/O.
+            # Cancellation while waiting must also cancel this durable queued run.
+            await self.cleanup()
             while True:
                 preferences = await SQLiteDashboardStore(self.store.database).preferences()
                 result = await worker.execute_requested(
@@ -313,6 +316,12 @@ class ManagedReviews:
         except asyncio.CancelledError:
             await self.reviews.cancel_review(run.id)
             raise
+        except Exception:
+            # A maintenance failure before claiming must not leave an orphaned
+            # queued attempt after its supervisor has reported failure.
+            if (await self.reviews.get_run(run.id)).status == "queued":
+                await self.reviews.cancel_review(run.id)
+            raise
 
     async def findings(self, row: PullRequestRow) -> ReviewResult | None:
         if row.tracked.task_id is None:
@@ -363,7 +372,7 @@ async def review_configured(
             load_settings, path, repo=f"{ref.namespace}/{ref.repository}"
         )
         managed = ManagedReviews(queue.database, settings, await owned_directories(settings))
-        await managed.cleanup()
+        await managed.recovery.recover_rebooted()
         return await managed.review(row, reviewer, progress)
 
 
@@ -414,7 +423,7 @@ async def handoff_configured(
     async with local_store(path) as (queue, settings):
         row = await resolve_local(queue, value, login)
         managed = ManagedReviews(queue.database, settings, await owned_directories(settings))
-        await managed.cleanup()
+        await managed.recovery.recover_rebooted()
         launch = await managed.prepare_handoff(row)
         exited = True
         try:

diffbutler-0.6.0/src/diffbutler/core/pr_lookup.py

@@ -0,0 +1,50 @@
+"""Read-only resolution of explicit review targets across repository scopes."""
+
+from dataclasses import dataclass
+
+from diffbutler.domain.forge import Account, PRRef, PullRequest, repository_matches
+from diffbutler.forges.base import ForgeError, ReadForge
+
+
+@dataclass(frozen=True)
+class ReviewTarget:
+    forge_index: int
+    account: Account
+    pull_request: PullRequest
+
+
+async def open_pr(forge: ReadForge, ref: PRRef) -> PullRequest | None:
+    try:
+        pr = await forge.get_pull_request(ref)
+    except ForgeError as exc:
+        if exc.status == 404:
+            return None
+        raise
+    if pr.ref != ref:
+        raise ForgeError("Forge returned a different PR identity")
+    return pr if pr.state == "open" else None
+
+
+async def numbered_prs(
+    forge: ReadForge, repositories: list[str], number: int
+) -> tuple[PullRequest, ...]:
+    """Resolve exact numbers directly after expanding owner repository scopes."""
+    found: dict[PRRef, PullRequest] = {}
+    checked: set[PRRef] = set()
+
+    async def check(ref: PRRef) -> None:
+        if ref not in checked:
+            checked.add(ref)
+            if pr := await open_pr(forge, ref):
+                found[ref] = pr
+
+    for repository in dict.fromkeys(repositories):
+        if not repository.endswith("/*"):
+            await check(forge.ref(f"{repository}#{number}"))
+            continue
+        for name in await forge.list_repositories(repository.removesuffix("/*")):
+            ref = forge.ref(f"{name}#{number}")
+            if ref.forge != forge.id or not repository_matches(repository, ref):
+                raise ForgeError("Forge returned a repository outside the requested owner")
+            await check(ref)
+    return tuple(found.values())

{diffbutler-0.5.2 → diffbutler-0.6.0}/src/diffbutler/core/repositories.py

@@ -23,7 +23,7 @@ from diffbutler.sources.git import GitSourceReader, SourceError
 
 
 @asynccontextmanager
-async def file_lock(path: Path) -> AsyncGenerator[None]:
+async def file_lock(path: Path, *, wait: bool = True) -> AsyncGenerator[bool]:
     """Cancellation never leaves a background thread waiting on an advisory lock."""
     await settled_io(lambda: path.parent.mkdir(parents=True, exist_ok=True))
     fd = os.open(path, os.O_CREAT | os.O_RDWR | os.O_NOFOLLOW, 0o600)
@@ -36,8 +36,11 @@ async def file_lock(path: Path) -> AsyncGenerator[None]:
                 fcntl.flock(fd, fcntl.LOCK_EX | fcntl.LOCK_NB)
                 break
             except BlockingIOError:
+                if not wait:
+                    yield False
+                    return
                 await asyncio.sleep(0.05)
-        yield
+        yield True
     finally:
         os.close(fd)
 
@@ -218,10 +221,12 @@ class RepositoryCache:
                     await settled_io(lambda path=path: (path / "last-used").touch())
 
     async def prune(self) -> None:
-        """Evict whole inactive repositories; never expire a live session's pins."""
+        """Evict inactive repositories, deferring maintenance while the cache is busy."""
         if not self.path.exists():
             return
-        async with file_lock(self.lock_path):
+        async with file_lock(self.lock_path, wait=False) as acquired:
+            if not acquired:
+                return
             directories = await open_directories(self.path)
             for resource in await self._resources(directories):
                 path = self.path / resource.name

{diffbutler-0.5.2 → diffbutler-0.6.0}/src/diffbutler/core/setup.py

@@ -19,7 +19,7 @@ from diffbutler.config.settings import (
     load_settings,
 )
 from diffbutler.config.setup import save_setup
-from diffbutler.domain.forge import PRQuery, identity_part
+from diffbutler.domain.forge import identity_part, repository_parts
 from diffbutler.forges.base import ForgeError
 from diffbutler.forges.github.setup import detect_login, repository_is_public, validate_access
 from diffbutler.sources.remotes import discover_repository
@@ -100,9 +100,21 @@ async def startup_settings(
         else await question("Repository to monitor (owner/name)")
     )
     try:
-        PRQuery(repository=repository)
+        repository_parts(repository)
     except ValueError:
         raise ConfigError("Repository must be owner/name") from None
+    scope = repository
+    if detected is not None and matched:
+        owner = repository.split("/")[0]
+        choice = (
+            await question(
+                f"Repositories to monitor (repo for just {repository}, all for {owner}/*)", "repo"
+            )
+        ).lower()
+        if choice not in {"repo", "all"}:
+            raise ConfigError("Choose repo or all repositories")
+        if choice == "all":
+            scope = f"{owner}/*"
     base_url = "https://api.github.com" if host == "github.com" else f"https://{host}/api/v3"
     public = await check(
         "Checking GitHub repository visibility", repository_is_public(base_url, repository)
@@ -154,7 +166,7 @@ async def startup_settings(
         token_env=token_env,
         login=login,
         include_team_requests=not public,
-        repositories=[repository],
+        repositories=[scope],
     )
     reviewers, default = await setup_reviewer(
         settings, directory, question, progress, discover=new_config
@@ -163,7 +175,7 @@ async def startup_settings(
         save_setup,
         path,
         forge,
-        detected.path if detected and matched else None,
+        (repository, detected.path) if detected and matched else None,
         reviewers,
         default,
     )

{diffbutler-0.5.2 → diffbutler-0.6.0}/src/diffbutler/core/sync.py

@@ -5,7 +5,7 @@ from typing import Literal
 
 from pydantic import BaseModel, ConfigDict
 
-from diffbutler.domain.forge import Account, Discovery, PRPage, PRQuery, PRRef
+from diffbutler.domain.forge import Account, Discovery, PRPage, PRQuery, PRRef, repository_matches
 from diffbutler.domain.sync import ReviewActivity, TrackedPR, reconcile
 from diffbutler.forges.base import ForgeError, ReadForge
 from diffbutler.store.base import QueueStore, SyncConflict
@@ -80,8 +80,7 @@ class DiffButler:
                             if (
                                 pr.state == "open"
                                 and pr.ref.forge == account.forge
-                                and f"{pr.ref.namespace}/{pr.ref.repository}".lower()
-                                == repository.lower()
+                                and repository_matches(repository, pr.ref)
                             ):
                                 discovered[pr.ref] = pr
                         cursor = page.next_cursor
@@ -167,7 +166,7 @@ class DiffButler:
             )
         raise AssertionError("unreachable")
 
-    async def follow_pr(self, ref: PRRef) -> PullRequestRow:
+    async def follow_pr(self, ref: PRRef, *, for_review: bool = False) -> PullRequestRow:
         account = await self._account()
         stale: TrackedPR | None = None
         for attempt in range(3):
@@ -180,6 +179,8 @@ class DiffButler:
             pr = await self.forge.get_pull_request(ref)
             if pr.ref != ref:
                 raise ForgeError("Forge returned a different PR identity")
+            if for_review and pr.state != "open":
+                raise ForgeError("PR is closed or merged; choose an open PR")
             # Following succeeds even if activity access fails; return the warning to the UI.
             try:
                 activity = await self.forge.get_review_activity(ref)
@@ -188,7 +189,7 @@ class DiffButler:
             if activity.account != account or await self._account() != account:
                 raise ForgeError("Account changed during follow; no changes saved")
             item = reconcile(previous, pr, activity, previous.sources if previous else ())
-            item = replace(item, following=True)
+            item = replace(item, following=True, explicit_review=item.explicit_review or for_review)
             try:
                 await self.store.apply(
                     account, snapshot.version, (item,), refreshed=frozenset({ref})
@@ -200,6 +201,33 @@ class DiffButler:
                 continue
             persisted = await self.store.snapshot(account)
             result = next(row for row in persisted.items if row.pull_request.ref == ref)
+            if for_review and result.state == "DONE":
+                # An explicit review request may reopen an approved, still-open PR.
+                # Persist completion first so the old cycle and its cleanup survive.
+                if result.pull_request.state != "open":
+                    raise ForgeError("PR is closed or merged; choose an open PR")
+                reopened = replace(
+                    result,
+                    task_id=None,
+                    cycle=result.cycle + 1,
+                    state="PENDING_AI_REVIEW",
+                    completion_reason=None,
+                    completion_event=None,
+                    opened_at=None,
+                    posted_at=None,
+                    review_requested_at=None,
+                    notice="Review explicitly requested",
+                )
+                try:
+                    await self.store.apply(account, persisted.version, (reopened,))
+                except SyncConflict:
+                    if attempt == 2:
+                        raise ForgeError(
+                            "Queue changed concurrently; retry review request"
+                        ) from None
+                    continue
+                persisted = await self.store.snapshot(account)
+                result = next(row for row in persisted.items if row.pull_request.ref == ref)
             return PullRequestRow(account=account, tracked=result, warnings=activity.warnings)
         raise AssertionError("unreachable")
 
@@ -222,6 +250,9 @@ async def list_queue(
         if login is not None and account.login.lower() != login.lower():
             continue
         for item in (await store.snapshot(account)).items:
+            if item.explicit_review and item.state != "DONE":
+                rows.append(PullRequestRow(account=account, tracked=item))
+                continue
             if (
                 not include_own_prs
                 and item.pull_request.author.casefold() == account.login.casefold()

{diffbutler-0.5.2 → diffbutler-0.6.0}/src/diffbutler/domain/forge.py

@@ -12,6 +12,17 @@ def identity_part(value: str) -> str:
     return value
 
 
+def repository_parts(value: str, *, allow_wildcard: bool = False) -> tuple[str, str]:
+    parts = value.split("/")
+    if len(parts) != 2:
+        raise ValueError("repository must be namespace/name")
+    owner, name = parts
+    identity_part(owner)
+    if not (allow_wildcard and name == "*"):
+        identity_part(name)
+    return owner, name
+
+
 @dataclass(frozen=True)
 class Account:
     forge: str
@@ -33,6 +44,13 @@ class PRRef:
             raise ValueError("PR number must be positive")
 
 
+def repository_matches(scope: str, ref: PRRef) -> bool:
+    owner, name = repository_parts(scope, allow_wildcard=True)
+    return owner.lower() == ref.namespace.lower() and (
+        name == "*" or name.lower() == ref.repository.lower()
+    )
+
+
 @dataclass(frozen=True)
 class PullRequest:
     ref: PRRef
@@ -67,11 +85,7 @@ class PRQuery:
 
     def __post_init__(self) -> None:
         if self.repository is not None:
-            parts = self.repository.split("/")
-            if len(parts) != 2:
-                raise ValueError("repository must be namespace/name")
-            for part in parts:
-                identity_part(part)
+            repository_parts(self.repository, allow_wildcard=True)
         if self.author is not None:
             identity_part(self.author)
         if self.state not in {"open", "closed", "merged", "all"}:

{diffbutler-0.5.2 → diffbutler-0.6.0}/src/diffbutler/domain/sync.py

@@ -72,6 +72,7 @@ class TrackedPR:
     notice: str = ""
     posted_at: datetime | None = None
     review_requested_at: datetime | None = None
+    explicit_review: bool = False
 
 
 @dataclass(frozen=True)

{diffbutler-0.5.2 → diffbutler-0.6.0}/src/diffbutler/forges/base.py

@@ -31,6 +31,7 @@ class ReadForge(Protocol):
     def id(self) -> str: ...
     async def whoami(self) -> Account: ...
     async def list_review_requests(self) -> Discovery: ...
+    async def list_repositories(self, owner: str) -> tuple[str, ...]: ...
     async def search_pull_requests(self, query: PRQuery, cursor: str | None = None) -> PRPage: ...
     async def get_pull_request(self, ref: PRRef) -> PullRequest: ...
     def ref(self, value: str) -> PRRef: ...