feat: add pull request dashboard with organization and technology filters

Signed-off-by: Arnab Nandy <arnab_nandy7@yahoo.com>

Author: arnabnandy7

doc/architecture.md

@@ -64,6 +64,60 @@ flowchart LR
   Drizzle <--> Turso
 ```
 
+## Pull request discovery
+
+`/pull-requests` provides a separate public PR dashboard with organization,
+technology, optional repository, status, and sort filters stored in the URL.
+`GET /api/pull-requests` returns basic results before enrichment. An exact
+repository replaces the organization qualifier, since combining GitHub scope
+qualifiers can broaden results. Open excludes drafts; closed excludes merged PRs.
+
+Languages use a bundled GitHub Linguist name/alias catalog and repository language
+qualifiers. Frameworks use repository topics
+without imposing an additional language. Discovery covers up to 20 recently
+updated matching repositories within the organization, with visible coverage
+notices. An exact repository is checked independently of that cap. Repository
+groups are merged in sort order before pagination, with at most three search
+requests running concurrently. Searches expose up to ten pages of 24 results.
+
+`POST /api/pull-requests/enrichment` accepts up to 24 PR references. It batches
+review information through GraphQL and enriches up to 12 unique repositories,
+three at a time. Shared repository services preserve the issue board's two-hour
+metadata cache and six-hour responsiveness and documentation caches. Optional
+failures remain Unknown; private repository and PR details are not returned.
+All optional enrichment is skipped without the server's `GITHUB_TOKEN` to protect
+the shared unauthenticated quota. This does not require visitor login. Linked issue
+counts cover only public nodes in the first ten links; token-authorized connection
+totals are never exposed. The shared REST helper permits only the GitHub HTTPS API
+origin and refuses redirects.
+
+`GET /api/pull-requests/details` loads change statistics and mergeability when a
+card expands. Basic results remain usable while insights load. Changing filters
+or navigating away aborts stale client requests. Search, enrichment, and detail
+requests have separate application rate-limit buckets. No new tables are needed.
+
+Performance should be measured separately for initial search and enrichment,
+with warm and cold caches and different numbers of unique repositories. No
+production latency target has been established. Saved PR searches and notifications
+are deferred.
+
+Active PR cards include an explainable readiness score: non-draft state (20),
+review decision (30), CI checks (25), absence of merge conflicts (15), and review
+size (10). Approved reviews receive 30 points, required reviews 10, and changes
+requested 0. Passing checks receive 25, pending/expected checks 5, and failures or
+errors 0. Changes up to 200 lines and 5 files receive 10 size points; up to 1,000
+lines and 20 files receive 5; larger changes receive 0. These weights are product
+heuristics for review readiness and effort, not code-quality judgments.
+
+Drafts are capped at 39. Changes requested, failing checks, or conflicts cap the
+score at 49. Missing signals produce a minimum–maximum range with weighted signal
+coverage rather than a failure penalty. Complete scores of 80 or more are labeled
+Ready; other unblocked complete scores need attention. Merged/closed PRs are N/A.
+Change statistics and mergeability are scalar fields on the existing batched
+GraphQL request, so scoring adds no HTTP requests and does not delay basic search.
+Without batch details, expanding a card can refine its score using the existing
+on-demand detail request.
+
 ## Issue discovery
 
 `GET /api/search` validates and rate-limits requests before querying GitHub. Languages use GitHub language qualifiers; framework and ecosystem terms such as React, Next.js, Spring Boot, and Kubernetes use repository topics.

src/app/api/pull-requests/details/route.ts

@@ -0,0 +1,29 @@
+import { NextResponse } from "next/server";
+import { REPOSITORY_PATTERN } from "@/features/pull-requests/filters";
+import { getPullRequestDetails } from "@/features/pull-requests/server/enrichment";
+import {
+  limitPullRequestRequest,
+  pullRequestApiError,
+} from "@/features/pull-requests/server/api";
+
+export async function GET(request: Request) {
+  const params = new URL(request.url).searchParams;
+  const repository = params.get("repository") ?? "";
+  const number = Number(params.get("number"));
+  if (
+    !REPOSITORY_PATTERN.test(repository) ||
+    !Number.isSafeInteger(number) ||
+    number < 1
+  )
+    return NextResponse.json(
+      { error: "Provide a valid repository and PR number." },
+      { status: 400 },
+    );
+  const limited = limitPullRequestRequest(request, "details");
+  if (limited) return limited;
+  try {
+    return NextResponse.json(await getPullRequestDetails(repository, number));
+  } catch (error) {
+    return pullRequestApiError(error);
+  }
+}

src/app/api/pull-requests/enrichment/route.ts

@@ -0,0 +1,52 @@
+import { NextResponse } from "next/server";
+import { REPOSITORY_PATTERN } from "@/features/pull-requests/filters";
+import {
+  enrichPullRequests,
+  type EnrichmentReference,
+} from "@/features/pull-requests/server/enrichment";
+import {
+  limitPullRequestRequest,
+  pullRequestApiError,
+} from "@/features/pull-requests/server/api";
+
+export async function POST(request: Request) {
+  const limited = limitPullRequestRequest(request, "enrichment");
+  if (limited) return limited;
+  let body: unknown;
+  try {
+    const text = await request.text();
+    if (text.length > 12000)
+      return NextResponse.json(
+        { error: "Request is too large." },
+        { status: 400 },
+      );
+    body = JSON.parse(text);
+  } catch {
+    return NextResponse.json({ error: "Invalid JSON." }, { status: 400 });
+  }
+  if (
+    !Array.isArray(body) ||
+    body.length < 1 ||
+    body.length > 24 ||
+    !body.every(
+      (reference) =>
+        reference &&
+        typeof reference.id === "string" &&
+        /^[a-zA-Z0-9_=-]{1,200}$/.test(reference.id) &&
+        typeof reference.repository === "string" &&
+        REPOSITORY_PATTERN.test(reference.repository),
+    )
+  ) {
+    return NextResponse.json(
+      { error: "Provide 1–24 valid pull request references." },
+      { status: 400 },
+    );
+  }
+  try {
+    return NextResponse.json(
+      await enrichPullRequests(body as EnrichmentReference[]),
+    );
+  } catch (error) {
+    return pullRequestApiError(error);
+  }
+}

src/app/api/pull-requests/route.ts

@@ -0,0 +1,23 @@
+import { NextResponse } from "next/server";
+import {
+  readPullRequestFilters,
+  validatePullRequestFilters,
+} from "@/features/pull-requests/filters";
+import { searchPullRequests } from "@/features/pull-requests/server/search";
+import {
+  limitPullRequestRequest,
+  pullRequestApiError,
+} from "@/features/pull-requests/server/api";
+
+export async function GET(request: Request) {
+  const filters = readPullRequestFilters(new URL(request.url).searchParams);
+  const error = validatePullRequestFilters(filters);
+  if (error) return NextResponse.json({ error }, { status: 400 });
+  const limited = limitPullRequestRequest(request, "search");
+  if (limited) return limited;
+  try {
+    return NextResponse.json(await searchPullRequests(filters));
+  } catch (error) {
+    return pullRequestApiError(error);
+  }
+}

src/app/pull-requests/page.tsx

@@ -0,0 +1,23 @@
+import { Suspense } from "react";
+import type { Metadata } from "next";
+import { PullRequestDashboard } from "@/features/pull-requests/components/pull-request-dashboard";
+
+export const metadata: Metadata = {
+  title: "Pull Request Finder | OpenIssue.dev",
+  description:
+    "Search public GitHub pull requests by organization and technology, with repository insights and review status.",
+};
+
+export default function PullRequestsPage() {
+  return (
+    <Suspense
+      fallback={
+        <main className="p-8">
+          <output>Loading pull request dashboard…</output>
+        </main>
+      }
+    >
+      <PullRequestDashboard />
+    </Suspense>
+  );
+}

src/components/dashboard-navigation.tsx

@@ -0,0 +1,37 @@
+import Link from "next/link";
+import { CircleDot, GitPullRequest } from "lucide-react";
+import { cn } from "@/lib/utils";
+
+export function DashboardNavigation({
+  current,
+}: Readonly<{ current: "issues" | "pull-requests" }>) {
+  return (
+    <nav
+      aria-label="Dashboards"
+      className="flex w-fit items-center gap-1 rounded-lg border bg-background p-1 text-sm"
+    >
+      {[
+        { href: "/", value: "issues", label: "Issues", Icon: CircleDot },
+        {
+          href: "/pull-requests",
+          value: "pull-requests",
+          label: "Pull requests",
+          Icon: GitPullRequest,
+        },
+      ].map(({ href, value, label, Icon }) => (
+        <Link
+          key={value}
+          href={href}
+          aria-current={current === value ? "page" : undefined}
+          className={cn(
+            "inline-flex items-center gap-2 rounded-md px-3 py-2 hover:bg-muted",
+            current === value && "bg-muted font-medium",
+          )}
+        >
+          <Icon className="size-4" />
+          {label}
+        </Link>
+      ))}
+    </nav>
+  );
+}

src/features/issues/components/issue-finder.tsx

@@ -9,6 +9,7 @@ import {
   useState,
 } from "react";
 import Image from "next/image";
+import { DashboardNavigation } from "@/components/dashboard-navigation";
 import { Bookmark, Mail, Search, Sparkles, Trash2 } from "lucide-react";
 import { ThemeToggle } from "@/components/theme-toggle";
 import { AuthControls } from "@/components/auth-controls";
@@ -1065,11 +1066,6 @@ function getSelectedContentTab(activeTab: ContentTab, authenticated: boolean) {
   return authenticated ? activeTab : "results";
 }
 
-function getTokenStatus(data: SearchResponse | null) {
-  if (!data) return "unknown";
-  return data.tokenConfigured ? "configured" : "not set";
-}
-
 function getRetryHandler(
   errorSource: "search" | "loadMore" | null,
   search: () => void,
@@ -1115,7 +1111,6 @@ function SearchOverview({
   scope,
   responsiveness,
   data,
-  tokenStatus,
 }: Readonly<{
   label: string;
   sort: string;
@@ -1126,7 +1121,6 @@ function SearchOverview({
   scope: string;
   responsiveness: string;
   data: SearchResponse | null;
-  tokenStatus: string;
 }>) {
   return (
     <Card className="self-end">
@@ -1151,7 +1145,6 @@ function SearchOverview({
           label="Raw GitHub matches"
           value={data ? compactNumber(data.totalCount) : "-"}
         />
-        <Metric label="GitHub token" value={tokenStatus} />
       </CardContent>
     </Card>
   );
@@ -1747,7 +1740,6 @@ export function IssueFinder() {
     }
   }
 
-  const tokenStatus = getTokenStatus(data);
   const handleRetry = getRetryHandler(
     errorSource,
     () => void searchIssues(),
@@ -1784,6 +1776,7 @@ export function IssueFinder() {
                   <ThemeToggle />
                 </div>
               </div>
+              <DashboardNavigation current="issues" />
               <div className="max-w-3xl space-y-4">
                 <h1 className="text-4xl font-semibold tracking-normal text-foreground sm:text-5xl">
                   Find active open-source issues by tech.
@@ -1981,7 +1974,6 @@ export function IssueFinder() {
             scope={selectedScope.label}
             responsiveness={selectedResponsiveness.label}
             data={data}
-            tokenStatus={tokenStatus}
           />
         </div>
       </section>