@noor.ahamed/pr-check 1.0.1

package/README.md

@@ -0,0 +1,157 @@
+# pr-check
+
+Show your GitHub Pull Request responsibilities in one command: PRs awaiting your review, assigned to you, and your open PRs waiting on others.
+
+## What it does
+
+When you run `pr-check`, it:
+
+1. **Awaiting Your Review** — Open PRs where you are requested as a reviewer
+2. **Assigned to You** — Open PRs assigned to you
+3. **Your Open PRs Waiting on Review** — PRs you authored that are still open
+
+Each PR shows repo, number, title, URL, author, and how long it has been open. PRs older than a threshold are marked as STALE.
+
+## Install
+
+```bash
+npm install -g @noor.ahamed/pr-check
+```
+
+## Requirements
+
+- **Node.js** 18 or later
+- **GitHub CLI (`gh`)** — used for authentication and API access. You do **not** need to install it or log in beforehand: when you run `pr-check`, it checks for `gh` and your login status and guides you through setup if needed (install + sign-in).
+
+No personal access token or manual config is required.
+
+## Usage
+
+```bash
+pr-check
+```
+
+To log in to your Github:
+
+```bash
+pr-check login
+```
+
+### Options
+
+| Option           | Description                                                   |
+| ---------------- | ------------------------------------------------------------- |
+| `--no-color`     | Disable colored output                                        |
+| `--json`         | Output JSON for scripting                                     |
+| `--stale <days>` | Mark PRs older than N days as STALE (default: 3)              |
+| `--limit <n>`    | Max results per category (default: 20)                        |
+| `--org <org>`    | Only show PRs in this GitHub organization                     |
+| `--repos <csv>`  | Only show PRs in these repos (e.g. `owner/repo1,owner/repo2`) |
+| `--quiet`        | Only print counts; use exit code to indicate responsibility   |
+
+### Examples
+
+```bash
+# Default: human-readable output (installs gh and runs login if needed)
+pr-check
+
+# Explicitly log in or install gh (no PR fetch)
+pr-check login
+
+# JSON output for scripts
+pr-check --json
+
+# Stale threshold 5 days, max 10 per section
+pr-check --stale 5 --limit 10
+
+# Only PRs in a specific org
+pr-check --org mycompany
+
+# Only PRs in specific repos
+pr-check --repos owner1/repoA,owner2/repoB
+
+# No colors (e.g. in CI logs)
+pr-check --no-color
+
+# Quiet: only counts and exit code
+pr-check --quiet
+```
+
+### Example output (default)
+
+```
+👀 Awaiting Your Review (2)
+
+  [Draft] Add new API
+    acme/backend #42 · by @alice · open 1 day
+    https://github.com/acme/backend/pull/42
+
+  Fix login bug
+    acme/web #101 · by @bob · open 5 days STALE
+    https://github.com/acme/web/pull/101
+
+📌 Assigned to You (0)
+
+📝 Your Open PRs Waiting on Review (1)
+
+  Bump deps
+    acme/lib #7 · by @you · open 2 hours
+    https://github.com/acme/lib/pull/7
+
+Total responsibility: 2
+```
+
+### Example JSON output
+
+```json
+{
+  "awaitingReview": [
+    {
+      "repo": "acme/backend",
+      "number": 42,
+      "title": "Add new API",
+      "url": "https://github.com/acme/backend/pull/42",
+      "authorLogin": "alice",
+      "createdAt": "2025-02-20T10:00:00Z",
+      "isDraft": true,
+      "reviewDecision": null,
+      "hasRequestedReviewers": true,
+      "category": "review",
+      "ageDays": 1,
+      "isStale": false
+    }
+  ],
+  "assignedToYou": [],
+  "yourOpenPRs": [],
+  "totalResponsibilityCount": 1
+}
+```
+
+## Exit codes
+
+| Code | Meaning                                                                      |
+| ---- | ---------------------------------------------------------------------------- |
+| `0`  | Success; with `--quiet`: no PRs awaiting your review or assigned to you      |
+| `1`  | Error (e.g. install/login was skipped or failed, network or rate limit)      |
+| `2`  | Only with `--quiet`: at least one PR awaiting your review or assigned to you |
+
+Use `--quiet` in scripts or CI to check responsibility without parsing output:
+
+```bash
+pr-check --quiet
+echo "Exit code: $?"
+```
+
+## Troubleshooting
+
+- **pr-check says GitHub CLI is required and asks to install**  
+  Answer **y** to have pr-check install `gh` (via winget/scoop/choco on Windows, brew on macOS, apt/dnf on Linux). If you said **n** or install failed, run `pr-check` again and choose **y**, or install from [cli.github.com](https://cli.github.com/) and run `pr-check` again.
+
+- **After installing `gh`, pr-check still says it’s not installed**  
+  On Windows, the PATH may not include `gh` until you open a **new terminal**. Close and reopen your terminal, then run `pr-check` again.
+
+- **Rate limit exceeded**  
+  Wait a few minutes or run `gh auth refresh`. Authenticated users have higher limits.
+
+- **No PRs shown**  
+  Ensure you have open PRs that match (review requested, assigned, or authored by you). Use `--org` or `--repos` only if you intend to filter.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const ora_1 = __importDefault(require("ora"));
+const chalk_1 = __importDefault(require("chalk"));
+const package_json_1 = __importDefault(require("../package.json"));
+const github_1 = require("./github");
+const format_1 = require("./format");
+const login_1 = require("./login");
+function isAuthError(msg) {
+    return msg === github_1.GH_NOT_FOUND || msg === github_1.GH_NOT_AUTHED;
+}
+function parseRepos(csv) {
+    if (!csv || !csv.trim())
+        return [];
+    return csv
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+async function runPrCheck(options) {
+    const run = async () => {
+        await (0, github_1.ensureGhAuth)();
+        const login = await (0, github_1.getCurrentUserLogin)();
+        const jsonOrQuiet = options.json || options.quiet;
+        const spinner = jsonOrQuiet ? null : (0, ora_1.default)("Fetching PRs...").start();
+        const results = await (0, github_1.fetchPrs)(login, options);
+        if (spinner)
+            spinner.succeed("Done");
+        if (options.quiet) {
+            const a = results.awaitingReview.length;
+            const b = results.assignedToYou.length;
+            const c = results.yourOpenPRs.length;
+            console.log(`review: ${a} assigned: ${b} open: ${c}`);
+            return results.totalResponsibilityCount > 0 ? 2 : 0;
+        }
+        if (options.json) {
+            console.log((0, format_1.formatJson)(results, options.staleDays));
+            return 0;
+        }
+        console.log((0, format_1.formatHuman)(results, { staleDays: options.staleDays, noColor: options.noColor }));
+        return 0;
+    };
+    try {
+        return await run();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (!isAuthError(msg)) {
+            console.error((0, format_1.formatError)(msg, options.noColor));
+            return 1;
+        }
+        const log = options.noColor ? (s) => console.log(s) : (s) => console.log(chalk_1.default.blue(s));
+        log("GitHub CLI (gh) is required and you need to be logged in. Running login flow...");
+        await (0, login_1.runLoginFlow)(options.noColor);
+        try {
+            return await run();
+        }
+        catch (retryErr) {
+            const retryMsg = retryErr instanceof Error ? retryErr.message : String(retryErr);
+            console.error((0, format_1.formatError)(retryMsg, options.noColor));
+            return 1;
+        }
+    }
+}
+async function main() {
+    const program = (0, commander_1.createCommand)();
+    program
+        .name("pr-check")
+        .description("Show your GitHub Pull Request responsibilities in one command")
+        .version(package_json_1.default.version ?? "1.0.0")
+        .option("--no-color", "Disable colored output")
+        .option("--json", "Output JSON for scripting")
+        .option("--stale <days>", "Highlight PRs older than N days as STALE", "3")
+        .option("--limit <n>", "Max results per category", "20")
+        .option("--org <org>", "Only show PRs in this GitHub org")
+        .option("--repos <csv>", "Only show PRs in these repos (e.g. owner/repo1,owner/repo2)")
+        .option("--quiet", "Only print counts and exit with code 0/2/1");
+    program
+        .command("login")
+        .description("Log in to GitHub via GitHub CLI (gh). Prompts to install gh if not found.")
+        .action(async () => {
+        const parentOpts = program.opts();
+        const noColor = parentOpts.noColor ?? false;
+        if (noColor)
+            chalk_1.default.level = 0;
+        const code = await (0, login_1.runLoginFlow)(noColor);
+        process.exit(code);
+    });
+    program.action(async () => {
+        const opts = program.opts();
+        const noColor = opts.noColor ?? false;
+        if (noColor)
+            chalk_1.default.level = 0;
+        const staleDays = Math.max(0, parseInt(String(opts.stale ?? "3"), 10) || 3);
+        const limit = Math.max(1, Math.min(100, parseInt(String(opts.limit ?? "20"), 10) || 20));
+        const options = {
+            staleDays,
+            limitPerCategory: limit,
+            org: opts.org,
+            repos: parseRepos(opts.repos),
+            noColor,
+            json: opts.json ?? false,
+            quiet: opts.quiet ?? false,
+        };
+        const code = await runPrCheck(options);
+        process.exit(code);
+    });
+    await program.parseAsync();
+    return 0;
+}
+main()
+    .then((code) => process.exit(code))
+    .catch(() => process.exit(1));

package/dist/format.d.ts

@@ -0,0 +1,16 @@
+import type { PRRecord, GroupedResults } from "./types";
+export declare function formatPrLine(pr: PRRecord, options: {
+    staleDays: number;
+    noColor: boolean;
+}): string;
+export declare function formatSection(title: string, emoji: string, prs: PRRecord[], options: {
+    staleDays: number;
+    noColor: boolean;
+}): string;
+export declare function formatHuman(results: GroupedResults, options: {
+    staleDays: number;
+    noColor: boolean;
+}): string;
+export declare function formatJson(results: GroupedResults, staleDays: number): string;
+export declare function formatError(message: string, noColor: boolean): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAaxD,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,EACZ,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAC/C,MAAM,CAgBR;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,QAAQ,EAAE,EACf,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAC/C,MAAM,CAMR;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAC/C,MAAM,CAsCR;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,GAChB,MAAM,CAaR;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAErE"}

package/dist/format.js

@@ -0,0 +1,76 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatPrLine = formatPrLine;
+exports.formatSection = formatSection;
+exports.formatHuman = formatHuman;
+exports.formatJson = formatJson;
+exports.formatError = formatError;
+const chalk_1 = __importDefault(require("chalk"));
+const utils_1 = require("./utils");
+function ageDays(createdAt) {
+    const then = new Date(createdAt).getTime();
+    const now = Date.now();
+    return Math.floor((now - then) / (24 * 60 * 60 * 1000));
+}
+function isStale(createdAt, staleDays) {
+    return ageDays(createdAt) >= staleDays;
+}
+function formatPrLine(pr, options) {
+    const age = (0, utils_1.timeAgo)(pr.createdAt);
+    const stale = isStale(pr.createdAt, options.staleDays);
+    const dim = options.noColor ? (s) => s : chalk_1.default.dim;
+    const yellow = options.noColor ? (s) => s : chalk_1.default.yellow;
+    const gray = options.noColor ? (s) => s : chalk_1.default.gray;
+    const lines = [];
+    const title = pr.isDraft ? `[Draft] ${pr.title}` : pr.title;
+    lines.push(`  ${title}`);
+    lines.push(dim(`    ${pr.repo} #${pr.number} · by @${pr.authorLogin} · open ${age}`) +
+        (stale ? ` ${yellow(" STALE")}` : ""));
+    lines.push(gray(`    ${pr.url}`));
+    return lines.join("\n");
+}
+function formatSection(title, emoji, prs, options) {
+    if (prs.length === 0)
+        return "";
+    const header = `${emoji} ${title} (${prs.length})`;
+    const bold = options.noColor ? (s) => s : chalk_1.default.bold;
+    const sections = [bold(header), ...prs.map((pr) => formatPrLine(pr, options))];
+    return sections.join("\n");
+}
+function formatHuman(results, options) {
+    const total = results.awaitingReview.length +
+        results.assignedToYou.length +
+        results.yourOpenPRs.length;
+    if (total === 0) {
+        const green = options.noColor ? (s) => s : chalk_1.default.green;
+        return green("All clear — no PR responsibilities right now.");
+    }
+    const parts = [];
+    parts.push(formatSection("Awaiting Your Review", "👀", results.awaitingReview, options));
+    parts.push(formatSection("Assigned to You", "📌", results.assignedToYou, options));
+    parts.push(formatSection("Your Open PRs Waiting on Review", "📝", results.yourOpenPRs, options));
+    const nonEmpty = parts.filter(Boolean);
+    const bold = options.noColor ? (s) => s : chalk_1.default.bold;
+    nonEmpty.push(bold(`\nTotal responsibility: ${results.totalResponsibilityCount}`));
+    return nonEmpty.join("\n\n");
+}
+function formatJson(results, staleDays) {
+    const serializePr = (pr) => ({
+        ...pr,
+        ageDays: ageDays(pr.createdAt),
+        isStale: isStale(pr.createdAt, staleDays),
+    });
+    const out = {
+        awaitingReview: results.awaitingReview.map(serializePr),
+        assignedToYou: results.assignedToYou.map(serializePr),
+        yourOpenPRs: results.yourOpenPRs.map(serializePr),
+        totalResponsibilityCount: results.totalResponsibilityCount,
+    };
+    return JSON.stringify(out, null, 2);
+}
+function formatError(message, noColor) {
+    return noColor ? message : chalk_1.default.red(message);
+}

package/dist/github.d.ts

@@ -0,0 +1,50 @@
+import type { GroupedResults, PrCheckOptions } from "./types";
+export declare const GH_NOT_FOUND = "pr-check requires GitHub CLI (gh). Install: https://cli.github.com/ \u2014 then run: gh auth login.";
+export declare const GH_NOT_AUTHED = "pr-check requires GitHub CLI (gh). If not logged in, run: gh auth login.";
+/**
+ * Returns true if the GitHub CLI (gh) is installed and on PATH.
+ * On Windows, a missing command often does not set ENOENT, so any failure is treated as not installed.
+ */
+export declare function isGhInstalled(): Promise<boolean>;
+/**
+ * Run `gh auth login` with inherited stdio so the user can interact.
+ */
+export declare function runGhAuthLogin(): Promise<void>;
+export declare function ensureGhAuth(): Promise<void>;
+export declare function getCurrentUserLogin(): Promise<string>;
+interface GhSearchPrItem {
+    repository?: {
+        nameWithOwner?: string;
+        owner?: {
+            login?: string;
+        };
+        name?: string;
+    };
+    number: number;
+    title: string;
+    url: string;
+    author?: {
+        login?: string;
+    } | null;
+    createdAt: string;
+    isDraft: boolean;
+}
+/**
+ * Validate that each repo exists (404 or API error = invalid). Throws with invalid list if any.
+ */
+export declare function validateRepos(repos: string[]): Promise<void>;
+/**
+ * Run gh search prs and return parsed PR list.
+ * Uses only CLI flags (no query string) so behaviour matches the manual:
+ *   gh search prs --review-requested=@me --state=open --repo=owner/repo
+ */
+export declare function searchPrs(limit: number, flags: {
+    reviewRequested?: string;
+    assignee?: string;
+    author?: string;
+    repo?: string[];
+    owner?: string;
+}): Promise<GhSearchPrItem[]>;
+export declare function fetchPrs(_login: string, options: PrCheckOptions): Promise<GroupedResults>;
+export {};
+//# sourceMappingURL=github.d.ts.map

package/dist/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAwB,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGpF,eAAO,MAAM,YAAY,wGACyE,CAAC;AACnG,eAAO,MAAM,aAAa,6EACkD,CAAC;AAE7E;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAOtD;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpD;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBlD;AAED,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CAO3D;AAED,UAAU,cAAc;IACtB,UAAU,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAeD;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBlE;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE;IACL,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,OAAO,CAAC,cAAc,EAAE,CAAC,CA6C3B;AAiBD,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAwD/F"}

package/dist/github.js

@@ -0,0 +1,198 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GH_NOT_AUTHED = exports.GH_NOT_FOUND = void 0;
+exports.isGhInstalled = isGhInstalled;
+exports.runGhAuthLogin = runGhAuthLogin;
+exports.ensureGhAuth = ensureGhAuth;
+exports.getCurrentUserLogin = getCurrentUserLogin;
+exports.validateRepos = validateRepos;
+exports.searchPrs = searchPrs;
+exports.fetchPrs = fetchPrs;
+const execa_1 = require("execa");
+const utils_1 = require("./utils");
+exports.GH_NOT_FOUND = "pr-check requires GitHub CLI (gh). Install: https://cli.github.com/ — then run: gh auth login.";
+exports.GH_NOT_AUTHED = "pr-check requires GitHub CLI (gh). If not logged in, run: gh auth login.";
+/**
+ * Returns true if the GitHub CLI (gh) is installed and on PATH.
+ * On Windows, a missing command often does not set ENOENT, so any failure is treated as not installed.
+ */
+async function isGhInstalled() {
+    try {
+        const result = await (0, execa_1.execa)("gh", ["--version"], { reject: false });
+        return result.exitCode === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Run `gh auth login` with inherited stdio so the user can interact.
+ */
+async function runGhAuthLogin() {
+    await (0, execa_1.execa)("gh", ["auth", "login"], { stdio: "inherit" });
+}
+async function ensureGhAuth() {
+    try {
+        await (0, execa_1.execa)("gh", ["auth", "status"]);
+    }
+    catch (err) {
+        const execaErr = err;
+        if (execaErr.code === "ENOENT" || execaErr.message?.includes("not found")) {
+            throw new Error(exports.GH_NOT_FOUND);
+        }
+        if (execaErr.exitCode !== 0 ||
+            execaErr.message?.includes("not logged in") ||
+            execaErr.message?.includes("authentication")) {
+            throw new Error(exports.GH_NOT_AUTHED);
+        }
+        throw err;
+    }
+}
+async function getCurrentUserLogin() {
+    const { stdout } = await (0, execa_1.execa)("gh", ["api", "user", "--jq", ".login"]);
+    const login = (stdout ?? "").trim();
+    if (!login) {
+        throw new Error(exports.GH_NOT_AUTHED);
+    }
+    return login;
+}
+function repoSlug(item) {
+    const r = item.repository;
+    if (!r)
+        return "unknown/unknown";
+    if (r.nameWithOwner)
+        return r.nameWithOwner;
+    const owner = r.owner?.login ?? "unknown";
+    const name = r.name ?? "unknown";
+    return `${owner}/${name}`;
+}
+function authorLogin(item) {
+    return item.author?.login ?? "unknown";
+}
+/**
+ * Validate that each repo exists (404 or API error = invalid). Throws with invalid list if any.
+ */
+async function validateRepos(repos) {
+    if (repos.length === 0)
+        return;
+    const invalid = [];
+    await Promise.all(repos.map(async (repo) => {
+        const result = await (0, execa_1.execa)("gh", ["api", `/repos/${repo}`], { reject: false });
+        if (result.exitCode !== 0 || !result.stdout?.trim()) {
+            invalid.push(repo);
+        }
+    }));
+    if (invalid.length > 0) {
+        throw new Error(`Repository not found or no access: ${invalid.join(", ")}. Check spelling and that the repo exists.`);
+    }
+}
+/**
+ * Run gh search prs and return parsed PR list.
+ * Uses only CLI flags (no query string) so behaviour matches the manual:
+ *   gh search prs --review-requested=@me --state=open --repo=owner/repo
+ */
+async function searchPrs(limit, flags) {
+    const args = ["search", "prs", "--state=open", "--limit", String(limit)];
+    if (flags.reviewRequested) {
+        args.push(`--review-requested=${flags.reviewRequested}`);
+    }
+    if (flags.assignee) {
+        args.push(`--assignee=${flags.assignee}`);
+    }
+    if (flags.author) {
+        args.push(`--author=${flags.author}`);
+    }
+    if (flags.owner) {
+        args.push(`--owner=${flags.owner}`);
+    }
+    if (flags.repo?.length) {
+        for (const r of flags.repo) {
+            args.push(`--repo=${r}`);
+        }
+    }
+    args.push("--json", "repository,number,title,url,author,createdAt,isDraft");
+    try {
+        const { stdout } = await (0, execa_1.execa)("gh", args);
+        const raw = (stdout ?? "").trim();
+        if (!raw)
+            return [];
+        const data = JSON.parse(raw);
+        if (Array.isArray(data)) {
+            return data;
+        }
+        const msg = data.message ?? "Unknown API error";
+        if (msg.includes("rate limit") || msg.includes("403")) {
+            throw new Error("GitHub rate limit exceeded. Try: gh auth refresh or wait a few minutes.");
+        }
+        throw new Error(msg);
+    }
+    catch (err) {
+        const execaErr = err;
+        if (execaErr.code === "ENOENT") {
+            throw new Error(exports.GH_NOT_FOUND);
+        }
+        if (execaErr.stderr?.includes("rate limit")) {
+            throw new Error("GitHub rate limit exceeded. Try: gh auth refresh or wait a few minutes.");
+        }
+        throw err;
+    }
+}
+function mapToRecord(item, category) {
+    return {
+        repo: repoSlug(item),
+        number: item.number,
+        title: item.title,
+        url: item.url,
+        authorLogin: authorLogin(item),
+        createdAt: item.createdAt,
+        isDraft: item.isDraft ?? false,
+        reviewDecision: null,
+        hasRequestedReviewers: category === "review",
+        category,
+    };
+}
+async function fetchPrs(_login, options) {
+    if (options.repos && options.repos.length > 0) {
+        await validateRepos(options.repos);
+    }
+    const limit = options.limitPerCategory;
+    const baseFlags = {
+        repo: options.repos,
+        owner: options.org,
+    };
+    const categories = ["review", "assigned", "authored"];
+    const searchFlags = [
+        { ...baseFlags, reviewRequested: "@me" },
+        { ...baseFlags, assignee: "@me" },
+        { ...baseFlags, author: "@me" },
+    ];
+    const results = await Promise.all(searchFlags.map((flags, i) => searchPrs(limit, flags).then((items) => items.map((item) => mapToRecord(item, categories[i])))));
+    const reviewList = results[0];
+    const assignedList = results[1];
+    const authoredList = results[2];
+    const allTagged = [...reviewList, ...assignedList, ...authoredList];
+    const deduped = (0, utils_1.dedupePrs)(allTagged);
+    const awaitingReview = [];
+    const assignedToYou = [];
+    const yourOpenPRs = [];
+    for (const pr of deduped) {
+        switch (pr.category) {
+            case "review":
+                awaitingReview.push(pr);
+                break;
+            case "assigned":
+                assignedToYou.push(pr);
+                break;
+            case "authored":
+                yourOpenPRs.push(pr);
+                break;
+        }
+    }
+    const totalResponsibilityCount = awaitingReview.length + assignedToYou.length;
+    return {
+        awaitingReview,
+        assignedToYou,
+        yourOpenPRs,
+        totalResponsibilityCount,
+    };
+}

package/dist/login.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Ask user: "GitHub CLI (gh) is required. Do you want to install it? (y/n)"
+ * Returns true for y/yes, false for n/no or empty.
+ */
+export declare function promptInstallGh(noColor: boolean): Promise<boolean>;
+/**
+ * Try to install gh or open the install page. Uses platform-appropriate package managers.
+ */
+export declare function installOrOpenGh(noColor: boolean): Promise<void>;
+/**
+ * Full login flow: check gh -> if missing, prompt to install -> install or open URL -> run gh auth login.
+ */
+export declare function runLoginFlow(noColor: boolean): Promise<number>;
+//# sourceMappingURL=login.d.ts.map

package/dist/login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../src/login.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAMxE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA0ErE;AASD;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAsCpE"}

package/dist/login.js

@@ -0,0 +1,159 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.promptInstallGh = promptInstallGh;
+exports.installOrOpenGh = installOrOpenGh;
+exports.runLoginFlow = runLoginFlow;
+const readline_1 = require("readline");
+const execa_1 = require("execa");
+const os_1 = require("os");
+const chalk_1 = __importDefault(require("chalk"));
+const github_1 = require("./github");
+const GH_INSTALL_URL = "https://cli.github.com/";
+function question(prompt) {
+    const rl = (0, readline_1.createInterface)({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            rl.close();
+            resolve((answer ?? "").trim().toLowerCase());
+        });
+    });
+}
+/**
+ * Ask user: "GitHub CLI (gh) is required. Do you want to install it? (y/n)"
+ * Returns true for y/yes, false for n/no or empty.
+ */
+async function promptInstallGh(noColor) {
+    const msg = "GitHub CLI (gh) is required. Do you want to install it? (y/n): ";
+    const out = noColor ? msg : chalk_1.default.yellow(msg);
+    const answer = await question(out);
+    return answer === "y" || answer === "yes";
+}
+/**
+ * Try to install gh or open the install page. Uses platform-appropriate package managers.
+ */
+async function installOrOpenGh(noColor) {
+    const plat = (0, os_1.platform)();
+    const log = (s) => (noColor ? console.log(s) : console.log(chalk_1.default.blue(s)));
+    if (plat === "win32") {
+        const winInstallers = [
+            {
+                name: "winget",
+                args: [
+                    "install",
+                    "--id",
+                    "GitHub.cli",
+                    "-e",
+                    "--silent",
+                    "--accept-package-agreements",
+                    "--accept-source-agreements",
+                ],
+            },
+            { name: "scoop", args: ["install", "gh"] },
+            { name: "choco", args: ["install", "gh", "-y"] },
+        ];
+        for (const { name, args } of winInstallers) {
+            try {
+                const cmd = name === "winget" ? "winget" : name === "scoop" ? "scoop" : "choco";
+                log(`Trying to install GitHub CLI via ${name}...`);
+                await (0, execa_1.execa)(cmd, args, { stdio: "inherit" });
+                log("Installation started or completed. If a new terminal is required, open one and run pr-check again.");
+                return;
+            }
+            catch {
+                continue;
+            }
+        }
+        log("No package manager found (winget, scoop, or choco). Opening install page in browser...");
+        await openUrl(GH_INSTALL_URL);
+        console.log(`Install from: ${GH_INSTALL_URL}`);
+        console.log("After installing, run pr-check again.");
+        return;
+    }
+    if (plat === "darwin") {
+        try {
+            log("Installing GitHub CLI via Homebrew...");
+            await (0, execa_1.execa)("brew", ["install", "gh"], { stdio: "inherit" });
+            return;
+        }
+        catch {
+            log("Homebrew failed or not installed. Opening install page...");
+            await openUrl(GH_INSTALL_URL);
+            console.log(`Install from: ${GH_INSTALL_URL}`);
+            console.log("After installing, run pr-check again.");
+            return;
+        }
+    }
+    if (plat === "linux") {
+        try {
+            log("Trying to install GitHub CLI via apt...");
+            await (0, execa_1.execa)("sudo", ["apt-get", "update", "-qq"], { reject: false });
+            await (0, execa_1.execa)("sudo", ["apt-get", "install", "-y", "gh"], { stdio: "inherit" });
+            return;
+        }
+        catch {
+            try {
+                log("Trying to install GitHub CLI via dnf...");
+                await (0, execa_1.execa)("sudo", ["dnf", "install", "-y", "gh"], { stdio: "inherit" });
+                return;
+            }
+            catch {
+                // fall through to open URL
+            }
+        }
+    }
+    log("Opening GitHub CLI install page in browser...");
+    await openUrl(GH_INSTALL_URL);
+    console.log(`Install from: ${GH_INSTALL_URL}`);
+    console.log("After installing, run pr-check again.");
+}
+function openUrl(url) {
+    const plat = (0, os_1.platform)();
+    const cmd = plat === "win32" ? "cmd" : plat === "darwin" ? "open" : "xdg-open";
+    const args = plat === "win32" ? ["/c", "start", "", url] : [url];
+    return (0, execa_1.execa)(cmd, args).then(() => undefined).catch(() => undefined);
+}
+/**
+ * Full login flow: check gh -> if missing, prompt to install -> install or open URL -> run gh auth login.
+ */
+async function runLoginFlow(noColor) {
+    if (await (0, github_1.isGhInstalled)()) {
+        try {
+            await (0, github_1.runGhAuthLogin)();
+            if (!noColor)
+                console.log(chalk_1.default.green("Login complete. You can now run pr-check."));
+            return 0;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(noColor ? msg : chalk_1.default.red(msg));
+            return 1;
+        }
+    }
+    console.log(noColor ? "GitHub CLI (gh) is not installed." : chalk_1.default.yellow("GitHub CLI (gh) is not installed."));
+    const wantInstall = await promptInstallGh(noColor);
+    if (!wantInstall) {
+        console.log(noColor ? "Skipped. Install gh from https://cli.github.com/ and run pr-check login." : chalk_1.default.dim("Skipped. Install gh from https://cli.github.com/ and run pr-check login."));
+        return 0;
+    }
+    await installOrOpenGh(noColor);
+    if (await (0, github_1.isGhInstalled)()) {
+        try {
+            await (0, github_1.runGhAuthLogin)();
+            if (!noColor)
+                console.log(chalk_1.default.green("Login complete."));
+            return 0;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(noColor ? msg : chalk_1.default.red(msg));
+            return 1;
+        }
+    }
+    console.log(noColor
+        ? "After installing gh, run: pr-check login"
+        : chalk_1.default.dim("After installing gh, run: pr-check login"));
+    return 0;
+}

package/dist/types.d.ts

@@ -0,0 +1,37 @@
+export type PRCategory = "review" | "assigned" | "authored";
+export type ReviewDecision = "APPROVED" | "CHANGES_REQUESTED" | "REVIEW_REQUIRED" | null;
+export interface PRRecord {
+    repo: string;
+    number: number;
+    title: string;
+    url: string;
+    authorLogin: string;
+    createdAt: string;
+    isDraft: boolean;
+    reviewDecision: ReviewDecision;
+    hasRequestedReviewers: boolean;
+    category: PRCategory;
+}
+export interface PrCheckOptions {
+    staleDays: number;
+    limitPerCategory: number;
+    org?: string;
+    repos?: string[];
+    noColor: boolean;
+    json: boolean;
+    quiet: boolean;
+}
+export interface GroupedResults {
+    awaitingReview: PRRecord[];
+    assignedToYou: PRRecord[];
+    yourOpenPRs: PRRecord[];
+    totalResponsibilityCount: number;
+}
+export interface PrCheckJsonOutput {
+    awaitingReview: PRRecord[];
+    assignedToYou: PRRecord[];
+    yourOpenPRs: PRRecord[];
+    totalResponsibilityCount: number;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAE5D,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,mBAAmB,GACnB,iBAAiB,GACjB,IAAI,CAAC;AAET,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,cAAc,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,QAAQ,EAAE,CAAC;IAC3B,aAAa,EAAE,QAAQ,EAAE,CAAC;IAC1B,WAAW,EAAE,QAAQ,EAAE,CAAC;IACxB,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,QAAQ,EAAE,CAAC;IAC3B,aAAa,EAAE,QAAQ,EAAE,CAAC;IAC1B,WAAW,EAAE,QAAQ,EAAE,CAAC;IACxB,wBAAwB,EAAE,MAAM,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils.d.ts

@@ -0,0 +1,20 @@
+import type { PRRecord } from "./types";
+/**
+ * Return human-readable time ago from ISO date string or unix timestamp.
+ */
+export declare function timeAgo(createdAt: string | number): string;
+/**
+ * Dedupe PRs by URL; when a PR appears in multiple lists, keep the highest-priority category
+ * (review > assigned > authored).
+ */
+export declare function dedupePrs(prs: PRRecord[]): PRRecord[];
+/**
+ * Build GitHub search query string: baseQuery + optional org: + optional repo: terms.
+ * Limit is applied at call site (gh search prs --limit).
+ */
+export declare function buildSearchQuery(opts: {
+    baseQuery: string;
+    org?: string;
+    repos?: string[];
+}): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,SAAS,CAAC;AAQpD;;GAEG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAgB1D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAYrD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,GAAG,MAAM,CAWT"}

package/dist/utils.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.timeAgo = timeAgo;
+exports.dedupePrs = dedupePrs;
+exports.buildSearchQuery = buildSearchQuery;
+const CATEGORY_PRIORITY = {
+    review: 3,
+    assigned: 2,
+    authored: 1,
+};
+/**
+ * Return human-readable time ago from ISO date string or unix timestamp.
+ */
+function timeAgo(createdAt) {
+    const now = Date.now();
+    const then = typeof createdAt === "string"
+        ? new Date(createdAt).getTime()
+        : createdAt * 1000;
+    const diffMs = Math.max(0, now - then);
+    const diffSec = Math.floor(diffMs / 1000);
+    const diffMin = Math.floor(diffSec / 60);
+    const diffHours = Math.floor(diffMin / 60);
+    const diffDays = Math.floor(diffHours / 24);
+    if (diffDays > 0)
+        return `${diffDays} day${diffDays === 1 ? "" : "s"}`;
+    if (diffHours > 0)
+        return `${diffHours} hour${diffHours === 1 ? "" : "s"}`;
+    if (diffMin >= 60)
+        return "1 hour";
+    return "< 1 hour";
+}
+/**
+ * Dedupe PRs by URL; when a PR appears in multiple lists, keep the highest-priority category
+ * (review > assigned > authored).
+ */
+function dedupePrs(prs) {
+    const byUrl = new Map();
+    for (const pr of prs) {
+        const existing = byUrl.get(pr.url);
+        if (!existing ||
+            CATEGORY_PRIORITY[pr.category] > CATEGORY_PRIORITY[existing.category]) {
+            byUrl.set(pr.url, pr);
+        }
+    }
+    return Array.from(byUrl.values());
+}
+/**
+ * Build GitHub search query string: baseQuery + optional org: + optional repo: terms.
+ * Limit is applied at call site (gh search prs --limit).
+ */
+function buildSearchQuery(opts) {
+    const parts = [opts.baseQuery.trim()];
+    if (opts.org) {
+        parts.push(`org:${opts.org}`);
+    }
+    if (opts.repos && opts.repos.length > 0) {
+        for (const r of opts.repos) {
+            parts.push(`repo:${r}`);
+        }
+    }
+    return parts.join(" ");
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@noor.ahamed/pr-check",
+  "version": "1.0.1",
+  "description": "Show your GitHub Pull Request responsibilities in one command",
+  "main": "dist/cli.js",
+  "types": "dist/cli.d.ts",
+  "bin": {
+    "pr-check": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "lint": "eslint src tests --ext .ts",
+    "prepublishOnly": "npm run build",
+    "postinstall": "echo \"pr-check requires GitHub CLI (gh). If not logged in, run: gh auth login.\""
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "cli",
+    "github",
+    "pull-request",
+    "review",
+    "pr",
+    "cross-platform"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/NooryA/pr-check.git"
+  },
+  "homepage": "https://github.com/NooryA/pr-check#readme",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^12.1.0",
+    "execa": "^8.0.1",
+    "ora": "^5.4.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "prettier": "^3.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  }
+}