pinsay-cli 0.13.0 → 0.14.0

package/README.md

@@ -62,6 +62,11 @@ Full guides: https://pinsay.dev/docs/ · Issues: https://github.com/moamen-ui/pi
 
 ## Changelog
 
+### 0.14.0
+
+- Custom statuses: `list --status`, `apply --status` and `status <number> <status>` (and the MCP `pinsay_list_comments` / `pinsay_set_status` tools) take a custom status by label or key (`c<id>`), case-insensitive. Output shows the status label; `--json` adds `statusKey` and `statusLabel` next to `status`.
+- An unknown status now exits 2 with the workspace's statuses (MCP: `invalid_input`) instead of listing everything. `apply` alone still means Ready; `applied` stays Completed and is set only by `apply --mark`.
+
 ### 0.13.0
 
 - Comment media in `get` (human output and `--json`) and in the MCP `pinsay_get_comment` / `pinsay_get_queue` tools: recording steps (each with its screenshot), annotated screenshots, voice messages and the files on replies. Each file is named by its saved path (`media[].path`, `element.screenshotPath`; MCP `untrusted.media[].path`).

package/dist/cli.js

@@ -392,7 +392,7 @@ var init_build_constants = __esm({
   "src/build-constants.ts"() {
     "use strict";
     BUILD_DEFAULT_SERVER = true ? "https://app.pinsay.dev" : "https://app.pinsay.dev";
-    BUILD_CLI_VERSION = true ? "0.13.0" : "0.0.0-dev";
+    BUILD_CLI_VERSION = true ? "0.14.0" : "0.0.0-dev";
   }
 });
 
@@ -3010,23 +3010,84 @@ var init_shared = __esm({
   }
 });
 
-// src/apply/queue.ts
-function mapStatusToNumber(status) {
-  if (status === void 0 || status === null)
-    return void 0;
-  if (typeof status === "number")
-    return status;
-  const s = String(status).toLowerCase();
-  if (s === "open" || s === "1")
-    return 1;
-  if (s === "ready" || s === "readytoapply" || s === "2")
-    return 2;
-  if (s === "applied" || s === "3")
-    return 3;
-  if (s === "archived" || s === "4")
-    return 4;
+// src/statuses.ts
+function fetchStatuses(client) {
+  const id = `${client.server}|${client.token ?? ""}`;
+  let hit = cache.get(id);
+  if (!hit) {
+    hit = api(client.server, "/api/statuses", { token: client.token }).then((res) => Array.isArray(res) ? res : []).catch(() => []);
+    cache.set(id, hit);
+  }
+  return hit;
+}
+function builtinKeyFor(norm) {
+  if (norm in BUILTIN_KEYS)
+    return norm;
+  if (norm in BUILTIN_ALIASES)
+    return BUILTIN_ALIASES[norm];
+  for (const [k, n] of Object.entries(BUILTIN_KEYS))
+    if (String(n) === norm)
+      return k;
   return void 0;
 }
+function resolveStatus(input, catalog = []) {
+  const norm = String(input ?? "").trim().toLowerCase();
+  if (!norm)
+    return void 0;
+  const builtin = builtinKeyFor(norm);
+  if (builtin) {
+    const status = BUILTIN_KEYS[builtin];
+    return { key: builtin, status, label: BUILTIN_LABELS[status] };
+  }
+  const custom2 = catalog.filter((c) => c.isCustom !== false && typeof c.key === "string" && !(c.key in BUILTIN_KEYS));
+  const hit = custom2.find((c) => c.key.toLowerCase() === norm) ?? custom2.find((c) => typeof c.label === "string" && c.label.trim().toLowerCase() === norm);
+  if (!hit)
+    return void 0;
+  return { key: hit.key, status: CUSTOM_STATUS, label: hit.label ?? hit.key };
+}
+function statusLabel(comment, catalog = []) {
+  if (comment.customStatus?.label)
+    return comment.customStatus.label;
+  if (comment.statusKey) {
+    const hit = catalog.find((c) => c.key === comment.statusKey && c.label);
+    if (hit)
+      return hit.label;
+  }
+  const n = Number(comment.status);
+  if (BUILTIN_NAMES[n])
+    return BUILTIN_NAMES[n];
+  if (n === CUSTOM_STATUS)
+    return "custom";
+  return String(comment.status);
+}
+function unknownStatusError(input, catalog = []) {
+  const names = Object.keys(BUILTIN_KEYS);
+  for (const c of catalog) {
+    if (c.isCustom && c.key)
+      names.push(`"${c.label ?? c.key}" (${c.key})`);
+  }
+  return `Unknown status "${input}". This workspace's statuses: ${names.join(", ")}`;
+}
+function statusJson(comment, catalog) {
+  const n = Number(comment.status);
+  const key = comment.statusKey ?? Object.entries(BUILTIN_KEYS).find(([, v]) => v === n)?.[0] ?? null;
+  return { statusKey: key, statusLabel: statusLabel(comment, catalog) };
+}
+var BUILTIN_KEYS, BUILTIN_ALIASES, BUILTIN_NAMES, BUILTIN_LABELS, CUSTOM_STATUS, cache;
+var init_statuses = __esm({
+  "src/statuses.ts"() {
+    "use strict";
+    init_api();
+    BUILTIN_KEYS = { open: 1, ready: 2, applied: 3, archived: 4 };
+    BUILTIN_ALIASES = { readytoapply: "ready", completed: "applied" };
+    BUILTIN_NAMES = { 1: "Open", 2: "ReadyToApply", 3: "Applied", 4: "Archived" };
+    BUILTIN_LABELS = { 1: "Open", 2: "Ready", 3: "Applied", 4: "Archived" };
+    CUSTOM_STATUS = 5;
+    cache = /* @__PURE__ */ new Map();
+  }
+});
+
+// src/apply/queue.ts
 function mapEnvironmentToNumber(env) {
   if (env === void 0 || env === null)
     return void 0;
@@ -3045,11 +3106,16 @@ async function fetchQueue(ctx, filter) {
   return (await fetchQueueShared(ctx, filter)).items;
 }
 async function fetchQueueShared(ctx, filter) {
-  const statusNum = filter?.status !== void 0 ? mapStatusToNumber(filter.status) : 2;
   const envNum = mapEnvironmentToNumber(filter?.environment);
   const queryParts = [];
-  if (statusNum !== void 0)
-    queryParts.push(`status=${statusNum}`);
+  if (filter?.status === void 0) {
+    queryParts.push("status=2");
+  } else {
+    const resolved = resolveStatus(filter.status, await fetchStatuses(ctx));
+    if (!resolved)
+      throw new Error(unknownStatusError(String(filter.status), await fetchStatuses(ctx)));
+    queryParts.push(`statusKey=${encodeURIComponent(resolved.key)}`);
+  }
   if (envNum !== void 0)
     queryParts.push(`environment=${envNum}`);
   const qs = queryParts.length > 0 ? `?${queryParts.join("&")}` : "";
@@ -3072,6 +3138,8 @@ async function fetchQueueShared(ctx, filter) {
         id: item.id,
         number: item.number,
         status: item.status,
+        statusKey: item.statusKey ?? null,
+        customStatus: item.customStatus ?? null,
         environment: item.environment,
         body: item.body ?? "",
         authorName: item.authorName ?? null,
@@ -3157,6 +3225,8 @@ async function fetchQueueShared(ctx, filter) {
         id: item.id,
         number: item.number,
         status: item.status,
+        statusKey: item.statusKey ?? null,
+        customStatus: item.customStatus ?? null,
         environment: item.environment,
         body: item.body ?? "",
         authorName: item.authorName ?? null,
@@ -3203,6 +3273,7 @@ var init_queue = __esm({
     init_member_rules();
     init_media();
     init_shared();
+    init_statuses();
     warnedNonAdminFallback = false;
   }
 });
@@ -3294,6 +3365,7 @@ function toAiCommentView(raw, page, saved) {
     aiRules,
     replies,
     status: raw?.status,
+    ...statusJson(raw ?? {}),
     media: toMediaViews(raw?.media, saved?.media),
     textSource: typeof raw?.textSource === "string" ? raw.textSource : null
   };
@@ -3310,36 +3382,12 @@ var init_projection = __esm({
   "src/apply/projection.ts"() {
     "use strict";
     init_media();
+    init_statuses();
     init_shared();
   }
 });
 
 // src/commands/comments.ts
-function mapStatusToNumber2(status) {
-  if (!status)
-    return void 0;
-  const s = status.toLowerCase();
-  if (s === "open" || s === "1")
-    return 1;
-  if (s === "ready" || s === "readytoapply" || s === "2")
-    return 2;
-  if (s === "applied" || s === "3")
-    return 3;
-  if (s === "archived" || s === "4")
-    return 4;
-  return void 0;
-}
-function mapStatusToString(status) {
-  if (status === 1 || status === "1")
-    return "Open";
-  if (status === 2 || status === "2")
-    return "ReadyToApply";
-  if (status === 3 || status === "3")
-    return "Applied";
-  if (status === 4 || status === "4")
-    return "Archived";
-  return String(status);
-}
 function mapEnvironmentToNumber2(env) {
   if (!env)
     return void 0;
@@ -3395,18 +3443,18 @@ function exitOnUnresolvedProject(resolved, flag) {
   }
   process.exit(2);
 }
-async function fetchCommentsFor(server, token, project, statusNum, envNum) {
+async function fetchCommentsFor(server, token, project, statusKey, envNum) {
   const queryParts = ["view=summary"];
-  if (statusNum !== void 0)
-    queryParts.push(`status=${statusNum}`);
+  if (statusKey !== void 0)
+    queryParts.push(`statusKey=${encodeURIComponent(statusKey)}`);
   if (envNum !== void 0)
     queryParts.push(`environment=${envNum}`);
   const url = `/api/projects/${encodeURIComponent(project)}/comments?${queryParts.join("&")}`;
   const res = await api(server, url, { token });
   return res?.items ?? [];
 }
-function printCommentLine(item) {
-  const st = mapStatusToString(item.status);
+function printCommentLine(item, catalog) {
+  const st = statusLabel(item, catalog);
   const env = mapEnvironmentToString(item.environment);
   const author = item.authorName || "Anonymous";
   const loc = item.route || item.sourcePath || "";
@@ -3416,14 +3464,23 @@ async function listCommand(cwd2, parsed, positionals = []) {
   const { server, token, root, config } = await getClient(cwd2, parsed, { requireProject: false });
   const statusArg = (typeof parsed["status"] === "string" ? parsed["status"] : positionals[1]) || void 0;
   const envArg = (typeof parsed["env"] === "string" ? parsed["env"] : positionals[2]) || void 0;
-  const statusNum = mapStatusToNumber2(statusArg);
+  const catalog = await fetchStatuses({ server, token });
+  let statusKey;
+  if (statusArg !== void 0) {
+    const resolvedStatus = resolveStatus(statusArg, catalog);
+    if (!resolvedStatus) {
+      console.error(unknownStatusError(statusArg, catalog));
+      process.exit(2);
+    }
+    statusKey = resolvedStatus.key;
+  }
   const envNum = mapEnvironmentToNumber2(envArg);
   const flag = typeof parsed["project"] === "string" ? parsed["project"] : void 0;
   const resolved = resolveProject(config, cwd2, root, flag);
   if (resolved.ok) {
-    const items = await fetchCommentsFor(server, token, resolved.project.key, statusNum, envNum);
+    const items = await fetchCommentsFor(server, token, resolved.project.key, statusKey, envNum);
     if (parsed["json"] === true) {
-      console.log(JSON.stringify(items.map(({ id, ...rest }) => ({ number: rest.number, internalId: id, ...rest })), null, 2));
+      console.log(JSON.stringify(items.map(({ id, ...rest }) => ({ number: rest.number, internalId: id, ...rest, ...statusJson(rest, catalog) })), null, 2));
       process.exit(0);
     }
     if (items.length === 0) {
@@ -3431,7 +3488,7 @@ async function listCommand(cwd2, parsed, positionals = []) {
       process.exit(0);
     }
     for (const item of items)
-      printCommentLine(item);
+      printCommentLine(item, catalog);
     process.exit(0);
   }
   if (resolved.reason === "not-found") {
@@ -3444,11 +3501,11 @@ async function listCommand(cwd2, parsed, positionals = []) {
   const projects = listProjects(config);
   const grouped = [];
   for (const p of projects) {
-    const comments = await fetchCommentsFor(server, token, p.key, statusNum, envNum);
+    const comments = await fetchCommentsFor(server, token, p.key, statusKey, envNum);
     grouped.push({ key: p.key, path: p.path, comments });
   }
   if (parsed["json"] === true) {
-    console.log(JSON.stringify(grouped.map((g) => ({ project: g.key, comments: g.comments.map(({ id, ...rest }) => ({ number: rest.number, internalId: id, ...rest })) })), null, 2));
+    console.log(JSON.stringify(grouped.map((g) => ({ project: g.key, comments: g.comments.map(({ id, ...rest }) => ({ number: rest.number, internalId: id, ...rest, ...statusJson(rest, catalog) })) })), null, 2));
     process.exit(0);
   }
   for (const g of grouped) {
@@ -3457,7 +3514,7 @@ async function listCommand(cwd2, parsed, positionals = []) {
       console.log("No comments found.");
     } else {
       for (const item of g.comments)
-        printCommentLine(item);
+        printCommentLine(item, catalog);
     }
     console.log("");
   }
@@ -3492,12 +3549,13 @@ async function getCommand(cwd2, parsed, positionals = []) {
   await pruneMedia(root);
   const saved = await saveIfRooted(raw, { root, projectKey: project, server, token });
   const view = toAiCommentView(raw, void 0, saved);
+  const catalog = await fetchStatuses({ server, token });
   if (parsed["json"] === true) {
     const resolved = resolveSource(cwd2, view.element?.sourcePath);
-    console.log(JSON.stringify({ ...view, resolvedSource: resolved }, null, 2));
+    console.log(JSON.stringify({ ...view, ...statusJson(raw, catalog), resolvedSource: resolved }, null, 2));
     process.exit(0);
   }
-  console.log(`Comment #${n} [${mapStatusToString(view.status)}] [${mapEnvironmentToString(view.environment)}]`);
+  console.log(`Comment #${n} [${statusLabel(raw, catalog)}] [${mapEnvironmentToString(view.environment)}]`);
   console.log(`Author: ${view.authorName || "Anonymous"} | Created: ${view.createdAt}`);
   if (view.element.route || view.element.sourcePath) {
     console.log(`Location: ${view.element.route || ""} ${view.element.sourcePath ? `(${view.element.sourcePath})` : ""}`);
@@ -3588,7 +3646,7 @@ async function statusCommand(cwd2, parsed, positionals = []) {
   const numStr = positionals[1];
   const newStatusStr = positionals[2];
   if (!numStr || !newStatusStr) {
-    console.error("Usage: pinsay status <number> <open|ready|applied|archived>");
+    console.error('Usage: pinsay status <number> <open|ready|applied|archived|"custom status">');
     process.exit(2);
   }
   const n = parseCommentNumber(numStr);
@@ -3596,12 +3654,13 @@ async function statusCommand(cwd2, parsed, positionals = []) {
     console.error(invalidNumberMessage(numStr));
     process.exit(2);
   }
-  const statusNum = mapStatusToNumber2(newStatusStr);
-  if (statusNum === void 0) {
-    console.error(`Invalid status: ${newStatusStr}. Must be open, ready, applied, or archived.`);
+  const catalog = await fetchStatuses({ server, token });
+  const resolvedStatus = resolveStatus(newStatusStr, catalog);
+  if (!resolvedStatus) {
+    console.error(unknownStatusError(newStatusStr, catalog));
     process.exit(2);
   }
-  if (statusNum === 3) {
+  if (resolvedStatus.status === 3) {
     console.error(
       'Marking a comment as \'applied\' is not permitted via `pinsay status`.\nUse `pinsay apply --mark <number> --reply "<explanation>"` (or `pinsay reply <number> "<text>"`) to record a properly structured reply.'
     );
@@ -3617,12 +3676,20 @@ async function statusCommand(cwd2, parsed, positionals = []) {
     }
     throw err;
   }
-  await api(server, `/api/comments/${raw.id}`, {
-    method: "PATCH",
-    body: { status: statusNum },
-    token
-  });
-  console.log(`Updated comment #${n} status to ${mapStatusToString(statusNum)}.`);
+  try {
+    await api(server, `/api/comments/${raw.id}`, {
+      method: "PATCH",
+      body: { statusKey: resolvedStatus.key },
+      token
+    });
+  } catch (err) {
+    if (err instanceof ApiError && err.code === 403) {
+      console.error(err.message);
+      process.exit(1);
+    }
+    throw err;
+  }
+  console.log(`Updated comment #${n} status to ${resolvedStatus.label}.`);
   process.exit(0);
 }
 async function replyCommand(cwd2, parsed, positionals = []) {
@@ -3667,6 +3734,7 @@ var init_comments = __esm({
     init_projection();
     init_media();
     init_server();
+    init_statuses();
   }
 });
 
@@ -9103,6 +9171,16 @@ init_queue();
 init_projection();
 init_media();
 init_server();
+init_statuses();
+async function exitOnUnknownStatus(server, token, status) {
+  if (typeof status !== "string")
+    return;
+  const catalog = await fetchStatuses({ server, token });
+  if (!resolveStatus(status, catalog)) {
+    console.error(unknownStatusError(status, catalog));
+    process.exit(2);
+  }
+}
 async function exitIfWorkspaceFrozen(server, token) {
   if (!token)
     return void 0;
@@ -9213,6 +9291,7 @@ async function applyCommand(cwd2, parsed, positionals = []) {
     cwd: root,
     workspaceName
   };
+  await exitOnUnknownStatus(server, token, parsed["status"]);
   if (parsed["mark"] !== void 0) {
     const markVal2 = parsed["mark"];
     let markId;
@@ -9369,6 +9448,7 @@ async function applyAllProjects(root, cwd2, config, server, parsed) {
     process.exit(3);
   }
   const workspaceName = await exitIfWorkspaceFrozen(server, token);
+  await exitOnUnknownStatus(server, token, parsed["status"]);
   const projects = listProjects(config);
   const plan = parsed["plan"] === true;
   const status = typeof parsed["status"] === "string" ? parsed["status"] : void 0;
@@ -14756,8 +14836,7 @@ var TOOL_PINSAY_LIST_COMMENTS = {
       },
       status: {
         type: "string",
-        enum: ["open", "ready", "applied", "archived"],
-        description: "Filter by comment status"
+        description: "Filter by comment status: open, ready, applied, archived, or a custom status label/key"
       }
     },
     additionalProperties: false
@@ -14927,7 +15006,7 @@ var TOOL_PINSAY_REPLY = {
 };
 var TOOL_PINSAY_SET_STATUS = {
   name: "pinsay_set_status",
-  description: `Set a comment's status to open, ready or archived. "applied" is not accepted here: only pinsay_mark_applied and pinsay_commit_and_mark set it, because they also record the reply and the commit. Returns {number, status}. ${UNTRUSTED_NOTICE}`,
+  description: `Set a comment's status to open, ready, archived or a custom status (by label or key). "applied" is not accepted here: only pinsay_mark_applied and pinsay_commit_and_mark set it, because they also record the reply and the commit. Returns {number, status}. ${UNTRUSTED_NOTICE}`,
   inputSchema: {
     type: "object",
     properties: {
@@ -14942,8 +15021,7 @@ var TOOL_PINSAY_SET_STATUS = {
       },
       status: {
         type: "string",
-        enum: ["open", "ready", "archived"],
-        description: "Status to set"
+        description: "Status to set: open, ready, archived, or a custom status label/key (not applied)"
       }
     },
     required: ["number", "status"],
@@ -15012,26 +15090,11 @@ init_media();
 init_shared();
 init_member_rules();
 init_config();
+init_statuses();
 init_comment_ref();
 function mcpError(code, message) {
   return { code, message };
 }
-function mapStatusToNumber3(status) {
-  if (status === void 0 || status === null)
-    return void 0;
-  if (typeof status === "number")
-    return status;
-  const s = String(status).toLowerCase();
-  if (s === "open" || s === "1")
-    return 1;
-  if (s === "ready" || s === "readytoapply" || s === "2")
-    return 2;
-  if (s === "applied" || s === "3")
-    return 3;
-  if (s === "archived" || s === "4")
-    return 4;
-  return void 0;
-}
 function mapEnvironmentToNumber3(env) {
   if (env === void 0 || env === null)
     return void 0;
@@ -15179,13 +15242,20 @@ function reshapeComment(raw, page, saved) {
   };
 }
 async function handleListComments(args, ctx) {
-  const statusNum = mapStatusToNumber3(args?.status);
+  const catalog = await fetchStatuses(ctx);
+  let statusKey;
+  if (args?.status !== void 0 && args.status !== null && String(args.status).trim() !== "") {
+    const resolvedStatus = resolveStatus(args.status, catalog);
+    if (!resolvedStatus)
+      throw mcpError("invalid_input", unknownStatusError(String(args.status), catalog));
+    statusKey = resolvedStatus.key;
+  }
   const envNum = mapEnvironmentToNumber3(args?.environment);
   const page = typeof args?.page === "number" && args.page >= 1 ? args.page : 1;
   const pageSize = typeof args?.pageSize === "number" && args.pageSize >= 1 && args.pageSize <= 100 ? args.pageSize : 50;
   const queryParts = ["view=summary", `pageNumber=${page}`, `pageSize=${pageSize}`];
-  if (statusNum !== void 0)
-    queryParts.push(`status=${statusNum}`);
+  if (statusKey !== void 0)
+    queryParts.push(`statusKey=${encodeURIComponent(statusKey)}`);
   if (envNum !== void 0)
     queryParts.push(`environment=${envNum}`);
   const url = `/api/projects/${encodeURIComponent(ctx.project)}/comments?${queryParts.join("&")}`;
@@ -15195,6 +15265,7 @@ async function handleListComments(args, ctx) {
     number: item.number,
     internalId: item.id,
     status: item.status,
+    ...statusJson(item, catalog),
     environment: item.environment,
     body: item.body ?? "",
     untrusted: {
@@ -15647,19 +15718,20 @@ async function handleReply(args, ctx) {
 }
 async function handleSetStatus(args, ctx) {
   const number = parseCommentNumber(args?.number);
-  const statusStr = String(args?.status || "").toLowerCase();
+  const statusStr = String(args?.status || "").trim();
   if (number === null) {
     throw mcpError("invalid_input", invalidNumberMessage(args?.number, args?.id));
   }
   if (!statusStr) {
     throw mcpError("invalid_input", "number and status are required");
   }
-  if (statusStr === "applied") {
-    throw mcpError("invalid_input", 'Status "applied" is only settable via mark tools');
+  const catalog = await fetchStatuses(ctx);
+  const resolvedStatus = resolveStatus(statusStr, catalog);
+  if (!resolvedStatus) {
+    throw mcpError("invalid_input", unknownStatusError(statusStr, catalog));
   }
-  const statusNum = mapStatusToNumber3(statusStr);
-  if (statusNum === void 0) {
-    throw mcpError("invalid_input", `Invalid status: ${args.status}`);
+  if (resolvedStatus.status === 3) {
+    throw mcpError("invalid_input", 'Status "applied" is only settable via mark tools');
   }
   let id;
   try {
@@ -15673,10 +15745,10 @@ async function handleSetStatus(args, ctx) {
   }
   await api(ctx.server, `/api/comments/${id}`, {
     method: "PATCH",
-    body: { status: statusNum },
+    body: { statusKey: resolvedStatus.key },
     token: ctx.token
   });
-  return { number, status: statusStr };
+  return { number, status: resolvedStatus.key };
 }
 async function handleResolveSource(args, ctx) {
   const hash = args?.hash;
@@ -16379,7 +16451,7 @@ var HELP_TEXTS = {
   },
   status: {
     purpose: "Who you are, this folder's project, comments waiting",
-    usage: "npx pinsay-cli status\n       npx pinsay-cli status <number> <open|ready|applied|archived>\n       npx pinsay-cli status --deployed [sha]",
+    usage: "npx pinsay-cli status\n       npx pinsay-cli status <number> <open|ready|archived|status>\n       npx pinsay-cli status --deployed [sha]",
     common: [
       ["--json", "Overview as JSON"],
       ["--deployed [sha]", "Mark applied comments live (default HEAD)"],
@@ -16395,7 +16467,7 @@ var HELP_TEXTS = {
     ],
     examples: [
       ["npx pinsay-cli status", "Who you are and what's waiting"],
-      ["npx pinsay-cli status 42 ready", "Mark comment #42 ready"],
+      ["npx pinsay-cli status 42 ready", "Move #42 to Ready (or a custom status)"],
       ["npx pinsay-cli status --deployed", "Mark this build's applied comments live"]
     ]
   },
@@ -16421,13 +16493,13 @@ var HELP_TEXTS = {
     purpose: "List feedback comments",
     usage: "npx pinsay-cli list [status] [environment]",
     common: [
-      ["--status <status>", "Filter (open, ready, applied, archived)"],
+      ["--status <status>", "Filter: open, ready, applied, archived, custom"],
       ["--env <env>", "Filter (local, staging, production)"],
       ["--project <key>", "Project (default: this folder's)"],
       ["--json", "Comments as JSON"]
     ],
     all: [
-      ["--status <status>", "Filter (open, ready, applied, archived)"],
+      ["--status <status>", "Filter: open, ready, applied, archived, custom"],
       ["--env <env>", "Filter (local, staging, production)"],
       ["--project <key>", "Project (default: this folder's)"],
       ["--key <key>", "API key"],
@@ -16469,7 +16541,7 @@ var HELP_TEXTS = {
       ["--mark <number>|all", "Commit and mark applied (needs --models)"],
       ["--reply <text>", "Reply recorded with --mark"],
       ["--models <list>", '"<id>=<role>", mandatory with --mark'],
-      ["--status <status>", "Filter the queue (open, ready, applied, archived)"],
+      ["--status <status>", "Queue status (default ready; custom label/key)"],
       ["--env <env>", "Filter (local, staging, production)"],
       ["--json", "Queue as JSON"]
     ],
@@ -16485,7 +16557,7 @@ var HELP_TEXTS = {
       ["--dry-run", "Print what --mark would do; change nothing"],
       ["--fail <number>", "Mark apply failed with a reply"],
       ["--reason <text>", "Why it failed (required with --fail)"],
-      ["--status <status>", "Filter the queue (open, ready, applied, archived)"],
+      ["--status <status>", "Queue status (default ready; custom label/key)"],
       ["--env <env>", "Filter (local, staging, production)"],
       ["--key <key>", "API key"],
       ["--project <key>", "Project for the queue"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pinsay-cli",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Click-to-comment feedback for your web app: install the widget, then turn pending comments into AI apply prompts.",
   "type": "module",
   "license": "MIT",