prq-cli 0.9.0 → 0.10.0

package/README.md

@@ -4,7 +4,7 @@
 
 PR Queue — see what code reviews need your attention.
 
-A CLI tool that shows you a categorized view of PRs that need action — then lets you act on them with whatever tools you already use. PRQ is the queue. You bring the workflow.
+Four categories. What needs re-review, what's requested, what's stale, what's waiting on others. `prq` is the queue. You bring the workflow.
 
 ## Install
 
@@ -40,6 +40,8 @@ Shows PRs needing your attention in four categories:
 - **○ Stale** — no activity for N days
 - **◇ Your PRs Waiting** — waiting on someone else
 
+PRs you mark as started appear in a separate **▸ In Progress** group at the top.
+
 ```bash
 prq                                        # interactive mode (default)
 prq status --repos org/repo1 org/repo2     # specific repos
@@ -58,6 +60,7 @@ Interactive mode is the default when running in a terminal. Navigate your queue
 | r | Review — open files changed |
 | o | Open — open PR in browser |
 | n | Nudge — post a comment |
+| s | Start/Stop — mark as in progress |
 | c | Copy URL to clipboard |
 | a | Actions — open menu with all actions |
 | q | Quit |
@@ -93,9 +96,9 @@ prq skill            # install in current project
 prq skill --global   # install globally
 ```
 
-## Pluggable Actions
+## Custom Actions
 
-PRQ doesn't force a workflow. Every action is a configurable shell command template — inline commands or scripts. Override the defaults or add your own in `.prqrc.json`.
+`prq` doesn't force a workflow. Every action is a configurable shell command template — inline commands or scripts. Override the defaults or add your own in `.prqrc.json`.
 
 Actions run with full terminal control. When you trigger an action, prq suspends its TUI, the command takes over the screen (interactive tools like Claude Code work as normal), and prq resumes when the command exits.
 
@@ -163,9 +166,9 @@ With no config, `prq review` opens the files changed tab and `prq open` opens th
 | `{days}` | `5` |
 | `{category}` | `needs-re-review` |
 
-## Agent & Automation
+## Scripting
 
-PRQ is fully scriptable with `--json` output and `--yes` flags:
+`prq` is fully scriptable with `--json` output and `--yes` flags:
 
 ```bash
 # Agent reads the queue
@@ -181,7 +184,7 @@ prq status --json | claude -p "Review needs-re-review PRs older than 7 days"
 
 ### Claude Code Skill
 
-Install the `/prq` skill to use PRQ inside Claude Code sessions:
+Install the `/prq` skill to use `prq` inside Claude Code sessions:
 
 ```bash
 prq skill --global

package/dist/bin/prq.js

@@ -2081,8 +2081,8 @@ var require_commander = __commonJS((exports) => {
 });
 
 // src/cli.ts
-import fs3 from "node:fs";
-import path3 from "node:path";
+import fs4 from "node:fs";
+import path4 from "node:path";
 import { fileURLToPath } from "node:url";
 
 // ../../node_modules/.bun/commander@13.1.0/node_modules/commander/esm.mjs
@@ -6664,8 +6664,59 @@ function categorize(reviewedPRs, requestedPRs, authoredPRs, staleDays) {
   return results;
 }
 
+// src/state.ts
+import fs2 from "node:fs";
+import path2 from "node:path";
+var STATE_DIR = path2.join(process.env.HOME ?? process.env.USERPROFILE ?? "", ".config", "prq");
+var STATE_PATH = path2.join(STATE_DIR, "in-progress.json");
+function prKey(pr) {
+  return `${pr.repo}#${pr.number}`;
+}
+function loadInProgress() {
+  try {
+    const data = JSON.parse(fs2.readFileSync(STATE_PATH, "utf8"));
+    return new Set(Array.isArray(data) ? data : []);
+  } catch {
+    return new Set;
+  }
+}
+function save(keys) {
+  fs2.mkdirSync(STATE_DIR, { recursive: true });
+  fs2.writeFileSync(STATE_PATH, JSON.stringify(Array.from(keys), null, 2));
+}
+function toggleInProgress(pr) {
+  const keys = loadInProgress();
+  const k = prKey(pr);
+  if (keys.has(k)) {
+    keys.delete(k);
+    save(keys);
+    return false;
+  }
+  keys.add(k);
+  save(keys);
+  return true;
+}
+function applyInProgress(prs) {
+  const keys = loadInProgress();
+  if (keys.size === 0)
+    return prs;
+  const activeKeys = new Set(prs.map(prKey));
+  const staleKeys = Array.from(keys).filter((k) => !activeKeys.has(k));
+  if (staleKeys.length > 0) {
+    for (const k of staleKeys)
+      keys.delete(k);
+    save(keys);
+  }
+  return prs.map((pr) => keys.has(prKey(pr)) ? { ...pr, category: "in-progress" } : pr);
+}
+
 // src/interactive.ts
 var CATEGORY_CONFIG = {
+  "in-progress": {
+    icon: "▸",
+    label: "In Progress",
+    color: source_default.cyan
+  },
   "needs-re-review": {
     icon: "◆",
     label: "Needs Re-review",
@@ -6680,6 +6731,7 @@ var CATEGORY_CONFIG = {
   }
 };
 var CATEGORY_ORDER = [
+  "in-progress",
   "needs-re-review",
   "requested",
   "stale",
@@ -6752,8 +6804,10 @@ function render(state) {
     lines.push("");
     lines.push(` ${source_default.dim("1-9")} run action  ${source_default.white("q")} back`);
   } else {
+    const pr = result.prs[selectedIndex];
+    const sLabel = pr?.category === "in-progress" ? "stop" : "start";
     lines.push("");
-    lines.push(` ${source_default.dim("↑↓")} navigate  ${source_default.white("r")} review  ${source_default.white("o")} open  ${source_default.white("n")} nudge  ${source_default.white("c")} copy url  ${source_default.white("a")} actions  ${source_default.white("q")} quit`);
+    lines.push(` ${source_default.dim("↑↓")} navigate  ${source_default.white("r")} review  ${source_default.white("o")} open  ${source_default.white("n")} nudge  ${source_default.white("s")} ${sLabel}  ${source_default.white("c")} copy url  ${source_default.white("a")} actions  ${source_default.white("q")} quit`);
   }
   if (message) {
     lines.push("");
@@ -6793,7 +6847,7 @@ async function runAction(actionName, template, pr, state, onData) {
     return source_default.red(`${actionName} failed`);
   }
 }
-async function interactiveMode(result, config) {
+async function interactiveMode(result, sourcePrs, config) {
   if (result.prs.length === 0) {
     console.log(source_default.green(`
   All clear! No PRs need your attention.
@@ -6804,6 +6858,7 @@ async function interactiveMode(result, config) {
   const allActions = listActions(config);
   const state = {
     result,
+    sourcePrs,
     selectedIndex: 0,
     message: "",
     actionMenu: null
@@ -6881,6 +6936,19 @@ async function interactiveMode(result, config) {
           }
           break;
         }
+        case "s": {
+          const started = toggleInProgress(pr);
+          state.result = {
+            ...state.result,
+            prs: applyInProgress(state.sourcePrs)
+          };
+          const newTotal = state.result.prs.length;
+          if (state.selectedIndex >= newTotal) {
+            state.selectedIndex = Math.max(0, newTotal - 1);
+          }
+          state.message = started ? source_default.cyan(`started: ${pr.repo}#${pr.number}`) : source_default.dim(`unmarked: ${pr.repo}#${pr.number}`);
+          break;
+        }
         case "a": {
           const entries = Object.entries(allActions);
           state.actionMenu = entries.map(([name, template]) => ({
@@ -6901,6 +6969,11 @@ async function interactiveMode(result, config) {
 
 // src/output.ts
 var CATEGORY_CONFIG2 = {
+  "in-progress": {
+    icon: "▸",
+    label: "In Progress",
+    color: source_default.cyan
+  },
   "needs-re-review": {
     icon: "◆",
     label: "Needs Re-review",
@@ -6915,6 +6988,7 @@ var CATEGORY_CONFIG2 = {
   }
 };
 var CATEGORY_ORDER2 = [
+  "in-progress",
   "needs-re-review",
   "requested",
   "stale",
@@ -6984,7 +7058,8 @@ async function statusCommand(config, json, interactive) {
   process.stderr.write(`Found ${reviewedRaw.length} reviewed, ${requestedPRs.length} requested, ${authoredPRs.length} authored
 `);
   const reviewedPRs = await enrichAllWithReviews(reviewedRaw, user);
-  const prs = categorize(reviewedPRs, requestedPRs, authoredPRs, config.staleDays);
+  const categorized = categorize(reviewedPRs, requestedPRs, authoredPRs, config.staleDays);
+  const prs = applyInProgress(categorized);
   const result = {
     user,
     timestamp: new Date().toISOString(),
@@ -6994,15 +7069,15 @@ async function statusCommand(config, json, interactive) {
     process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
   } else if (interactive && process.stdin.isTTY) {
-    await interactiveMode(result, config);
+    await interactiveMode(result, categorized, config);
   } else {
     process.stdout.write(formatStatus(result));
   }
 }
 
 // src/config.ts
-import fs2 from "node:fs";
-import path2 from "node:path";
+import fs3 from "node:fs";
+import path3 from "node:path";
 
 // ../../node_modules/.bun/zod@3.25.76/node_modules/zod/v3/external.js
 var exports_external = {};
@@ -7479,8 +7554,8 @@ function getErrorMap() {
 }
 // ../../node_modules/.bun/zod@3.25.76/node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path2, errorMaps, issueData } = params;
-  const fullPath = [...path2, ...issueData.path || []];
+  const { data, path: path3, errorMaps, issueData } = params;
+  const fullPath = [...path3, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -7592,11 +7667,11 @@ var errorUtil;
 
 // ../../node_modules/.bun/zod@3.25.76/node_modules/zod/v3/types.js
 class ParseInputLazyPath {
-  constructor(parent, value, path2, key) {
+  constructor(parent, value, path3, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path2;
+    this._path = path3;
     this._key = key;
   }
   get path() {
@@ -10986,14 +11061,14 @@ var configSchema = exports_external.object({
 });
 function loadConfig(cliOverrides) {
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-  const globalPath = path2.join(home, ".config", "prq", "config.json");
-  const localPath = path2.join(process.cwd(), ".prqrc.json");
+  const globalPath = path3.join(home, ".config", "prq", "config.json");
+  const localPath = path3.join(process.cwd(), ".prqrc.json");
   let config = {};
-  if (fs2.existsSync(globalPath)) {
-    config = JSON.parse(fs2.readFileSync(globalPath, "utf8"));
+  if (fs3.existsSync(globalPath)) {
+    config = JSON.parse(fs3.readFileSync(globalPath, "utf8"));
   }
-  if (fs2.existsSync(localPath)) {
-    config = { ...config, ...JSON.parse(fs2.readFileSync(localPath, "utf8")) };
+  if (fs3.existsSync(localPath)) {
+    config = { ...config, ...JSON.parse(fs3.readFileSync(localPath, "utf8")) };
   }
   for (const [key, value] of Object.entries(cliOverrides)) {
     if (value !== undefined) {
@@ -11005,11 +11080,11 @@ function loadConfig(cliOverrides) {
 
 // src/cli.ts
 function getVersion() {
-  const __dirname2 = path3.dirname(fileURLToPath(import.meta.url));
+  const __dirname2 = path4.dirname(fileURLToPath(import.meta.url));
   for (const rel of ["../../package.json", "../package.json"]) {
-    const p = path3.resolve(__dirname2, rel);
-    if (fs3.existsSync(p)) {
-      return JSON.parse(fs3.readFileSync(p, "utf8")).version;
+    const p = path4.resolve(__dirname2, rel);
+    if (fs4.existsSync(p)) {
+      return JSON.parse(fs4.readFileSync(p, "utf8")).version;
     }
   }
   return "0.0.0";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "prq-cli",
-	"version": "0.9.0",
+	"version": "0.10.0",
 	"description": "PR Queue — see what code reviews need your attention",
 	"type": "module",
 	"bin": {
@@ -37,6 +37,6 @@
 		"type": "git",
 		"url": "git+https://github.com/caiopizzol/prq.git"
 	},
-	"homepage": "https://github.com/caiopizzol/prq",
+	"homepage": "https://prq.sh",
 	"bugs": "https://github.com/caiopizzol/prq/issues"
 }