@retasc/cli 1.16.1 → 1.17.0

package/CHANGELOG.md

@@ -6,6 +6,28 @@ release commits and the issues they reference.
 
 Dates are the npm publish date. Each entry names the RTSC issue behind it.
 
+## 1.17.0 (2026-08-02)
+
+- **RTSC-529** — the column mapping is a numbered picker, like every other prompt.
+
+  It was the only one that made you type a word. Picking an org, a project, a source, a
+  list, a reviewer, a sign-in door or whether to install globally are all numbered lists
+  reading `Choose a number` — and the reviewer picker appears two lines below this one, so a
+  single import taught two input styles within four lines of output.
+
+  ```
+    to do
+      1) todo   (suggested)
+      2) doing
+      3) done
+      4) canceled
+    Choose a number [1]:
+  ```
+
+  Enter still takes the suggestion, now marked in the list rather than described beside it.
+  Typing the word still works for anyone who has learned the vocabulary; it just isn't what
+  the prompt advertises.
+
 ## 1.16.1 (2026-08-02)
 
 - **RTSC-528** — two things the first real `retasc import` run turned up.

package/dist/commands/import.js

@@ -180,7 +180,7 @@ export async function mapStatuses(statuses, reviewers, askFn) {
     const statusMap = {};
     const reviewerByStatus = {};
     console.log(`\nWhat does each column mean? ${statuses.length} to confirm.\n` +
-        "  Press Enter to keep the suggested answer, or type a different one.\n" +
+        "  Press Enter to take the suggested answer, or pick another number.\n" +
         "  The suggestion comes from the column's type in your tool, not its name.");
     // Grouped under the source's own section names, in the source's own order within each
     // (RTSC-436/526). On a twenty-column Jira board a flat list is a wall; the sections are
@@ -196,36 +196,44 @@ export async function mapStatuses(statuses, reviewers, askFn) {
         const suggested = allowed.includes(s.suggested)
             ? s.suggested
             : "todo";
+        // RTSC-529 — NUMBERED, like every other prompt in the CLI.
+        //
+        // This was the only one that asked you to type a word. Org, project, source, list,
+        // reviewer, sign-in door (RTSC-508) and install choice (RTSC-523) are all numbered
+        // pickers reading "Choose a number" — and the reviewer picker appears two lines below
+        // THIS one, so a single run taught two input styles within four lines of output.
+        //
+        // RTSC-528 tried to fix that by making the typing instruction explicit. That treated
+        // the symptom: a prompt that has to teach you its own input method is usually the
+        // wrong input method.
+        //
+        // The default is marked in the list rather than described outside it, and the words
+        // are still accepted — someone ten columns in knows the vocabulary, and typing `doing`
+        // beats re-reading a list. That is a shortcut, not the advertised path, so it is not
+        // in the instruction.
+        console.log(`\n  ${clean(s.name)}`);
+        allowed.forEach((m, i) => console.log(`    ${i + 1}) ${m}${m === suggested ? "   (suggested)" : ""}`));
+        const defaultSlot = allowed.indexOf(suggested) + 1;
         for (let attempt = 0;; attempt++) {
-            // RTSC-528 — the prompt has to name the ACTION. It used to read
-            //   `to do  [todo]  (todo / doing / done / canceled):`
-            // where nothing is a verb: the bracket is the default and the parenthesis is a bare
-            // word list, so the first person to run it had to guess that you type one of them.
-            // The reviewer picker two lines below says "Choose a number" and is unambiguous,
-            // which made the contrast worse.
-            //
-            // The suggestion is also removed from the alternatives — it is already what Enter
-            // does, and listing it again is what made the line read as four equal options with a
-            // mysterious bracket in front.
-            const others = allowed.filter((m) => m !== suggested);
-            const answer = (await askFn(`\n  ${clean(s.name)}\n` +
-                `    Enter to keep ${suggested}, or type: ${others.join(", ")}\n` +
-                `  > `)).trim().toLowerCase();
-            const choice = answer === "" ? suggested : answer;
-            if (allowed.includes(choice)) {
+            const answer = (await askFn(`  Choose a number [${defaultSlot}]: `)).trim().toLowerCase();
+            // Enter takes the suggestion; a digit picks a row; a word still works.
+            const byNumber = /^\d+$/.test(answer) ? allowed[Number(answer) - 1] : undefined;
+            const choice = answer === "" ? suggested : (byNumber ?? answer);
+            if (choice && allowed.includes(choice)) {
                 statusMap[s.id] = choice;
                 break;
             }
-            if (choice === "review" && !reviewAllowed(s.group)) {
-                // Say WHY, rather than repeating the list. The server would reject it anyway.
+            // Say WHY when the answer names something real but not permitted here. The server
+            // would reject it anyway, and repeating the list explains nothing.
+            if (answer === "review" && !reviewAllowed(s.group)) {
                 console.log("    Not for this column: review means finished and awaiting acceptance,");
                 console.log("    and this one holds work nobody has started.");
             }
-            else if (choice === "review") {
+            else if (answer === "review") {
                 console.log("    No one in this org can be a reviewer yet, so review isn't available.");
             }
             else {
-                console.log(`    Pick one of: ${allowed.join(", ")}`);
+                console.log(`    Enter a number between 1 and ${allowed.length}.`);
             }
             if (attempt >= 2)
                 throw new Error("no valid choice — aborting");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retasc/cli",
-  "version": "1.16.1",
+  "version": "1.17.0",
   "description": "Retasc CLI \u2014 the issue tracker AI agents pull work from. Sign in with GitHub or Google, create projects, mint agent API keys, and wire your agent to the Retasc MCP server in one command.",
   "type": "module",
   "bin": {