pinsay-cli 0.11.0 → 0.11.1

package/README.md

@@ -62,6 +62,12 @@ Full guides: https://pinsay.dev/docs/ · Issues: https://github.com/moamen-ui/pi
 
 ## Changelog
 
+### 0.11.1
+
+- MCP tools: passing the old `id` argument now says it was renamed to `number` instead of a generic error.
+- `pinsay_reply` returns the comment `number` with the `replyId`.
+- `--help` exit-code legend: exit 4 also covers "comment not found".
+
 ### 0.11.0
 
 - Comments are numbered per project: `#1`, `#2`, … in `list`, `get`, `status`, `apply`, `reply` and the dashboard. Pass that number (or `--number`); the internal id is no longer accepted, and `get --id` is removed.

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.11.0" : "0.0.0-dev";
+    BUILD_CLI_VERSION = true ? "0.11.1" : "0.0.0-dev";
   }
 });
 
@@ -2459,7 +2459,13 @@ function parseCommentNumber(input) {
   const n = Number(s);
   return Number.isSafeInteger(n) ? n : null;
 }
-function invalidNumberMessage(input) {
+function invalidNumberMessage(input, legacyId) {
+  if (input === void 0 || input === null) {
+    if (legacyId !== void 0 && legacyId !== null) {
+      return `"id" was renamed: pass "number", the comment's #number in this project (see pinsay_list_comments).`;
+    }
+    return `Missing comment number: pass "number", the comment's #number in this project (see pinsay_list_comments).`;
+  }
   return `Invalid comment number: ${String(input)}. Expected a number like 12 or #12.`;
 }
 async function fetchCommentByNumber(server, token, project, number) {
@@ -13902,7 +13908,7 @@ var TOOL_PINSAY_COMMIT_AND_MARK = {
 };
 var TOOL_PINSAY_REPLY = {
   name: "pinsay_reply",
-  description: `Post a reply on a comment, visible to its author and the other stakeholders, with tool/model attribution. Does not change the comment's status; to close a comment out with a reply, use pinsay_mark_applied or pinsay_commit_and_mark. Returns {replyId}. ${MODELS_NOTICE} ${UNTRUSTED_NOTICE}`,
+  description: `Post a reply on a comment, visible to its author and the other stakeholders, with tool/model attribution. Does not change the comment's status; to close a comment out with a reply, use pinsay_mark_applied or pinsay_commit_and_mark. Returns {number, replyId}. ${MODELS_NOTICE} ${UNTRUSTED_NOTICE}`,
   inputSchema: {
     type: "object",
     properties: {
@@ -14262,7 +14268,7 @@ async function handleGetQueue(args, ctx) {
 async function handleGetComment(args, ctx) {
   const number = parseCommentNumber(args?.number);
   if (number === null) {
-    throw mcpError("forbidden", invalidNumberMessage(args?.number));
+    throw mcpError("forbidden", invalidNumberMessage(args?.number, args?.id));
   }
   let id;
   try {
@@ -14299,7 +14305,7 @@ async function handleMarkApplied(args, ctx) {
   const number = parseCommentNumber(args?.number);
   const reply = args?.reply;
   if (number === null) {
-    throw mcpError("forbidden", invalidNumberMessage(args?.number));
+    throw mcpError("forbidden", invalidNumberMessage(args?.number, args?.id));
   }
   if (typeof reply !== "string") {
     throw mcpError("forbidden", "number and reply are required");
@@ -14342,6 +14348,9 @@ async function handleCommitAndMark(args, ctx) {
   const numbers = args?.numbers;
   const reply = args?.reply;
   const files = args?.files;
+  if (numbers === void 0 || numbers === null) {
+    throw mcpError("forbidden", invalidNumberMessage(void 0, args?.ids ?? args?.id));
+  }
   const tool = args?.tool || ctx.configAiTool;
   const models = parseModelsArgs(args);
   if (!Array.isArray(numbers) || numbers.length === 0 || typeof reply !== "string") {
@@ -14548,7 +14557,7 @@ async function handleReply(args, ctx) {
   const number = parseCommentNumber(args?.number);
   const body = args?.body;
   if (number === null) {
-    throw mcpError("forbidden", invalidNumberMessage(args?.number));
+    throw mcpError("forbidden", invalidNumberMessage(args?.number, args?.id));
   }
   if (typeof body !== "string") {
     throw mcpError("forbidden", "number and body are required");
@@ -14570,13 +14579,13 @@ async function handleReply(args, ctx) {
     body: { body, aiTool: tool || void 0, ...modelsBody(models) },
     token: ctx.token
   });
-  return { replyId: res?.id ?? res?.data?.id ?? null };
+  return { number, replyId: res?.id ?? res?.data?.id ?? null };
 }
 async function handleSetStatus(args, ctx) {
   const number = parseCommentNumber(args?.number);
   const statusStr = String(args?.status || "").toLowerCase();
   if (number === null) {
-    throw mcpError("forbidden", invalidNumberMessage(args?.number));
+    throw mcpError("forbidden", invalidNumberMessage(args?.number, args?.id));
   }
   if (!statusStr) {
     throw mcpError("forbidden", "number and status are required");
@@ -15168,7 +15177,7 @@ Tools
 
 Run npx pinsay-cli <command> --help for examples.
 Flags: --no-color  No colours or styling (also NO_COLOR=1)
-Exit codes: 0 ok \xB7 1 error \xB7 2 bad usage / paused workspace \xB7 3 key or permission \xB7 4 can't reach PinSay \xB7 5 CLI too old`;
+Exit codes: 0 ok \xB7 1 error \xB7 2 bad usage / paused workspace \xB7 3 key or permission \xB7 4 can't reach PinSay, or comment not found \xB7 5 CLI too old`;
 var HELP_TEXTS = {
   init: {
     purpose: "Set up this repo (sign in, project, skills)",
@@ -15422,7 +15431,8 @@ var HELP_TEXTS = {
     ],
     notes: [
       "Exit codes: 0 ok \xB7 1 error \xB7 2 bad usage / paused workspace",
-      "            3 key or permission \xB7 4 can't reach PinSay \xB7 5 CLI too old"
+      "            3 key or permission \xB7 4 can't reach PinSay, or comment not found",
+      "            5 CLI too old"
     ]
   },
   reply: {
@@ -15462,7 +15472,7 @@ var HELP_TEXTS = {
     ],
     notes: [
       "Exit codes: 0 ok \xB7 1 a check failed \xB7 3 key or permission",
-      "            4 can't reach PinSay \xB7 5 CLI too old"
+      "            4 can't reach PinSay, or comment not found \xB7 5 CLI too old"
     ]
   },
   update: {

package/package.json

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