@omercnet/paseo-pr-radar 0.3.4-next.72.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Omer Cohen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,64 @@
+# PR Radar
+
+A Paseo plugin that turns pull requests linked to active workspaces into a viewer-aware delivery queue.
+
+PR Radar combines Paseo workspace and agent state with pull request checks, review status, mergeability, and the current GitHub user's relationship to each pull request. It answers which deliverables need you, which are already being handled, and which are waiting elsewhere.
+
+## Screenshots
+
+Repository, pull request, workspace, and agent names in these screenshots are synthetic. The live
+browser DOM was rewritten before capture so no private identifiers are published.
+
+### Wide dashboard
+
+![PR Radar wide dashboard](docs/images/pr-radar-github-inbox-wide.png)
+
+### Compact dashboard
+
+![PR Radar compact dashboard](docs/images/pr-radar-github-inbox-compact.png)
+
+## What it shows
+
+- Needs you: authored blockers and review requests whose checks have completed.
+- Being handled: actionable work with an active Paseo agent.
+- Waiting externally: running checks, pending reviews, repository requirements, and external-author work.
+- Ready: authored pull requests that are mergeable with settled checks and reviews.
+- Viewer labels: `YOURS`, `REVIEW`, and `EXTERNAL`.
+- Contextual actions: ask an existing agent or start one in the linked workspace.
+
+Paseo supplies normalized workspace pull request status. A daemon-side plugin handler uses the authenticated `gh` CLI to distinguish authored pull requests from review requests. If viewer lookup fails, PR Radar falls back conservatively and does not claim that a row needs the user.
+
+## Install
+
+Install the published package on the daemon host:
+
+```bash
+paseo plugin install npm:@omercnet/paseo-pr-radar
+```
+
+Or install from the plugin's monorepo directory:
+
+```bash
+paseo plugin add omercnet/paseo-plugins:pr-radar
+```
+
+The daemon must have plugins enabled and `gh` authenticated for GitHub viewer-aware triage.
+
+## Develop
+
+```bash
+npm ci
+npm run check
+npm test
+npm run test:coverage
+npm run typecheck
+npx paseo plugin install "$PWD"
+npx paseo plugin reload pr-radar
+```
+
+Release Please maintains the version, changelog, component tag, and GitHub release from
+Conventional Commits in the monorepo.
+
+The project targets Paseo `0.8.x`, including compatible `0.8` prereleases. Host-owned navigation opens linked agents and
+workspaces without private routes or page reloads on web, desktop, iOS, and Android. React `19.1`
+and React Native `0.81` match the versions supplied by the plugin host.