jiradc-cli 1.0.44 → 1.0.45

package/README.md

@@ -31,27 +31,27 @@ All commands output JSON. Add `--pretty` to pretty-print.
 
 ### issue
 
-| Command                               | Description                                                                                                                                                                        |
-| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `jiradc issue get <key>`              | One issue, with every dimension hanging off it (see below). `--fields` selects fields by id or name, `--all-fields` returns everything Jira holds, `--expand` adds changelog/names |
-| `jiradc issue search <jql>`           | Issues matching a JQL query. `--all` collects every match (capped at 1,000); `description` and `comment` are excluded unless asked for via `--fields`                              |
-| `jiradc issue create`                 | The new issue's key and id. Requires `--project`, `--type`, `--summary`; `--fields <json>` sets anything else                                                                      |
-| `jiradc issue update <key>`           | Applies field changes. Shortcuts for `--summary`/`--description`/`--priority`/`--assignee`, list flags for `--labels`/`--components`/`--fix-versions`                              |
-| `jiradc issue delete <key>`           | Deletes the issue. `--delete-subtasks` to take its subtasks with it                                                                                                                |
-| `jiradc issue assign <key>`           | Sets the assignee. `--assignee` takes a username, `me`, or `none` to unassign                                                                                                      |
-| `jiradc issue transition <key>`       | Moves the issue. `--to` accepts a transition id, a transition name, or the target status name; `--fields` supplies screen fields, `--comment` a note                               |
-| `jiradc issue transitions <key>`      | The transitions available from the current status, each with the screen fields it requires                                                                                         |
-| `jiradc issue createmeta`             | The fields a new issue accepts and the values they allow. Requires `--project` and `--type`                                                                                        |
-| `jiradc issue editmeta <key>`         | The fields this issue's edit screen accepts, with their allowed values                                                                                                             |
-| `jiradc issue link`                   | Links two issues. Requires `--from`, `--to` and `--type` (a link type name)                                                                                                        |
-| `jiradc issue unlink <id>`            | Removes one issue link by its link id                                                                                                                                              |
-| `jiradc issue link-types`             | The link type names this instance accepts, for `issue link --type`                                                                                                                 |
-| `jiradc issue link-epic <keys...>`    | Links one or more issues to `--epic <epicKey>`; reports a `failed` array if any link is rejected                                                                                   |
-| `jiradc issue changelog <key>`        | The issue's change history                                                                                                                                                         |
-| `jiradc issue batch-changelog <keys>` | Change history for several issues at once, from a comma-separated key list                                                                                                         |
-| `jiradc issue clone <key>`            | Creates a duplicate. `--include-links`, `--include-attachments`, `--summary` and `--project` control what carries over                                                             |
-| `jiradc issue batch-create`           | Creates many issues from `--issues <json>` (an array of field objects)                                                                                                             |
-| `jiradc issue dev-status <key>`       | Branches, pull requests, commits and builds linked to the issue. `--detail` for the full records                                                                                   |
+| Command                               | Description                                                                                                                                                                                                                       |
+| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `jiradc issue get <key>`              | One issue, with every dimension hanging off it (see below). `--fields` selects fields by id or name, `--all-fields` returns everything Jira holds, `--expand` adds changelog/names                                                |
+| `jiradc issue search <jql>`           | Issues matching a JQL query. `--all` collects every match (capped at 1,000); `description` and `comment` are excluded unless asked for via `--fields`                                                                             |
+| `jiradc issue create`                 | The new issue's key and id. Requires `--project`, `--type`, `--summary`; `--fields <json>` sets anything else                                                                                                                     |
+| `jiradc issue update <key>`           | Applies field changes and reads them back: `fields` holds the touched fields as Jira now has them. Shortcuts for `--summary`/`--description`/`--priority`/`--assignee`, list flags for `--labels`/`--components`/`--fix-versions` |
+| `jiradc issue delete <key>`           | Deletes the issue. `--delete-subtasks` to take its subtasks with it                                                                                                                                                               |
+| `jiradc issue assign <key>`           | Sets the assignee. `--assignee` takes a username, `me`, or `none` to unassign                                                                                                                                                     |
+| `jiradc issue transition <key>`       | Moves the issue and reads back `status` and `resolution`. `--to` accepts a transition id, name, or target status, each checked against what is available; `--fields` supplies screen fields, `--comment` a note                   |
+| `jiradc issue transitions <key>`      | The transitions available from the current status, each with the screen fields it requires                                                                                                                                        |
+| `jiradc issue createmeta`             | The fields a new issue accepts and the values they allow. Requires `--project` and `--type`                                                                                                                                       |
+| `jiradc issue editmeta <key>`         | The fields this issue's edit screen accepts, with their allowed values                                                                                                                                                            |
+| `jiradc issue link`                   | Links two issues. Requires `--from`, `--to` and `--type` (a link type name)                                                                                                                                                       |
+| `jiradc issue unlink <id>`            | Removes one issue link by its link id                                                                                                                                                                                             |
+| `jiradc issue link-types`             | The link type names this instance accepts, for `issue link --type`                                                                                                                                                                |
+| `jiradc issue link-epic <keys...>`    | Links one or more issues to `--epic <epicKey>`; reports a `failed` array if any link is rejected                                                                                                                                  |
+| `jiradc issue changelog <key>`        | The issue's whole change history, every entry. `--limit` caps it; `total` always says how many exist                                                                                                                              |
+| `jiradc issue batch-changelog <keys>` | The same, for several issues at once, from a comma-separated key list                                                                                                                                                             |
+| `jiradc issue clone <key>`            | Creates a duplicate. `--include-links`, `--include-attachments`, `--summary` and `--project` control what carries over                                                                                                            |
+| `jiradc issue batch-create`           | Creates many issues from `--issues <json>` (an array of field objects)                                                                                                                                                            |
+| `jiradc issue dev-status <key>`       | Branches, pull requests, commits and builds linked to the issue. `--detail` for the full records                                                                                                                                  |
 
 #### What a bare `issue get` returns
 

package/dist/{chunk-3GFKV36K.js → chunk-KEI7DXAL.js}

@@ -668,6 +668,7 @@ function classifyError(err, opts) {
     envelope: {
       error: {
         type: n.type,
+        ...n.status !== void 0 ? { status: n.status } : {},
         message: n.message,
         recovery: n.recovery,
         retryable: n.retryable,
@@ -742,9 +743,19 @@ function suggestSubcommand(token, names) {
   }
   return best?.name;
 }
+function exitCleanlyOnClosedPipe(stream) {
+  stream.on("error", (err) => {
+    if (err.code === "EPIPE") {
+      process.exit(0);
+      return;
+    }
+    throw err;
+  });
+}
 async function runCli(program, opts) {
   routeErrors(program);
   attachSubcommandGuards(program);
+  exitCleanlyOnClosedPipe(process.stdout);
   try {
     await program.parseAsync();
   } catch (err) {
@@ -1126,6 +1137,7 @@ export {
   createErrorHandler,
   routeErrors,
   attachSubcommandGuards,
+  exitCleanlyOnClosedPipe,
   runCli,
   assertConventions,
   serializeCommandTree,

package/dist/{dist-JXPWCMQP.js → dist-YSXRGQRB.js}

@@ -22,6 +22,7 @@ import {
   dateTime,
   enumArg,
   examples,
+  exitCleanlyOnClosedPipe,
   fieldsOption,
   finiteNumber,
   formatOption,
@@ -48,7 +49,7 @@ import {
   text,
   textOrFileOption,
   uuid
-} from "./chunk-3GFKV36K.js";
+} from "./chunk-KEI7DXAL.js";
 export {
   BANNED_FLAGS,
   CliAuthError,
@@ -73,6 +74,7 @@ export {
   dateTime,
   enumArg,
   examples,
+  exitCleanlyOnClosedPipe,
   fieldsOption,
   finiteNumber,
   formatOption,

package/dist/index.js

@@ -25,7 +25,7 @@ import {
   subjectArg,
   text,
   textOrFileOption
-} from "./chunk-3GFKV36K.js";
+} from "./chunk-KEI7DXAL.js";
 
 // src/program.ts
 import { styleText } from "util";
@@ -478,6 +478,20 @@ function transformIssueFields(fields, key, opts) {
   };
 }
 
+// src/utils/transformers/changelog.ts
+function transformEntry(h) {
+  return {
+    id: h.id,
+    ...h.author ? { author: transformUser(h.author) } : {},
+    created: h.created,
+    items: h.items
+  };
+}
+function transformChangelog(raw, opts = {}) {
+  const histories = opts.limit === void 0 ? raw.histories : raw.histories.slice(0, opts.limit);
+  return { total: raw.total, values: histories.map(transformEntry) };
+}
+
 // src/utils/transformers/transition.ts
 function slimAllowedValue2(raw) {
   if (!raw || typeof raw !== "object") return {};
@@ -1077,15 +1091,19 @@ function registerAttachmentCommands(parent) {
 
 // src/commands/issue/batch-changelog.ts
 function batchChangelog(parent) {
-  const cmd = parent.command("batch-changelog").description("Get changelogs for multiple issues at once").argument("<keys>", "Comma-separated issue keys", keyList).option("--limit <number>", "Max changelog entries per issue (1-50, Jira DC caps at 50)", intInRange(1, 50), 25);
+  const cmd = parent.command("batch-changelog").description("Get the whole change history of several issues at once").argument("<keys>", "Comma-separated issue keys", keyList).option(
+    "--limit <number>",
+    "Return at most this many entries per issue, oldest first (default: every entry)",
+    positiveInt
+  );
   examples(cmd, ["PROJ-1,PROJ-2,PROJ-3", "PROJ-123,PROJ-124 --limit 10"]);
   cmd.action(async (keys, opts) => {
     const client = getClient();
     const entries = await Promise.all(
       keys.map(async (key) => {
         try {
-          const data = await client.issues.getChangelog({ issueKeyOrId: key, maxResults: opts.limit });
-          return [key, data];
+          const data = await client.issues.getChangelog({ issueKeyOrId: key });
+          return [key, transformChangelog(data, { limit: opts.limit })];
         } catch (error) {
           return [key, { error: error instanceof Error ? error.message : "Unknown error" }];
         }
@@ -1121,12 +1139,12 @@ function batchCreate(parent) {
 
 // src/commands/issue/changelog.ts
 function changelog(parent) {
-  const cmd = parent.command("changelog").description("Get changelog for an issue").argument("<key>", "Issue key", issueKey).option("--limit <number>", "Max changelog entries (1-50, Jira DC caps at 50)", intInRange(1, 50), 25);
+  const cmd = parent.command("changelog").description("Get the whole change history of an issue (several issues at once: batch-changelog)").argument("<key>", "Issue key", issueKey).option("--limit <number>", "Return at most this many entries, oldest first (default: every entry)", positiveInt);
   examples(cmd, ["PROJ-123", "PROJ-123 --limit 10"]);
   cmd.action(async (key, opts) => {
     const client = getClient();
-    const result = await client.issues.getChangelog({ issueKeyOrId: key, maxResults: opts.limit });
-    output(result);
+    const result = await client.issues.getChangelog({ issueKeyOrId: key });
+    output(transformChangelog(result, { limit: opts.limit }));
   });
 }
 
@@ -1753,19 +1771,34 @@ function search2(parent) {
 
 // src/commands/issue/transition.ts
 import { z as z3 } from "zod";
-var fieldsSchema2 = z3.record(z3.unknown());
+
+// src/utils/read-back.ts
+async function readBack(client, key, fields) {
+  try {
+    const issue = await client.issues.get({ issueKeyOrId: key, fields });
+    return { fields: transformIssue(issue).fields };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+      warning: `The write succeeded, but reading ${key} back failed: ${message}. Run jiradc issue get ${key} to see its current state.`
+    };
+  }
+}
+
+// src/utils/resolve-transition.ts
 function resolveTransitionId(to, transitions2) {
+  const available = transitions2.map((t) => ({ id: t.id, name: t.name, to: t.to }));
+  const recovery = "Re-run --to with one of the listed transitions (by id, name, or target status).";
+  if (/^\d+$/.test(to)) {
+    if (transitions2.some((t) => t.id === to)) return to;
+    throw new CliUsageError(`Transition id ${to} is not available from the current status`, recovery, { available });
+  }
   const target = to.toLowerCase();
   const byName = transitions2.filter((t) => t.name.toLowerCase() === target);
   const matches = byName.length > 0 ? byName : transitions2.filter((t) => t.to.toLowerCase() === target);
   if (matches.length === 1) return matches[0].id;
-  const available = transitions2.map((t) => ({ id: t.id, name: t.name, to: t.to }));
   if (matches.length === 0) {
-    throw new CliUsageError(
-      `Transition "${to}" not available from current status`,
-      "Re-run --to with one of the listed transitions (by name, id, or target status).",
-      { available }
-    );
+    throw new CliUsageError(`Transition "${to}" not available from current status`, recovery, { available });
   }
   const ids = matches.map((t) => t.id).join(", ");
   throw new CliUsageError(
@@ -1774,6 +1807,9 @@ function resolveTransitionId(to, transitions2) {
     { available }
   );
 }
+
+// src/commands/issue/transition.ts
+var fieldsSchema2 = z3.record(z3.unknown());
 function transition(parent) {
   const cmd = parent.command("transition").description("Transition issue to a new status").argument("<key>", "Issue key", issueKey).requiredOption("--to <idOrName>", "Transition ID, transition name, or target status name (case-insensitive)", text).option(
     "--fields <json>",
@@ -1792,18 +1828,11 @@ function transition(parent) {
     async (key, opts) => {
       const comment = resolveTextOrFile(opts, "comment", { required: false });
       const client = getClient();
-      let transitionId;
-      if (/^\d+$/.test(opts.to)) {
-        transitionId = opts.to;
-      } else {
-        const raw = await client.issues.getTransitions({
-          issueKeyOrId: key,
-          expand: "transitions.fields"
-        });
-        transitionId = resolveTransitionId(opts.to, transformTransitions(raw));
-      }
+      const raw = await client.issues.getTransitions({ issueKeyOrId: key, expand: "transitions.fields" });
+      const transitionId = resolveTransitionId(opts.to, transformTransitions(raw));
       await client.issues.transition({ issueKeyOrId: key, transitionId, fields: opts.fields, comment });
-      output({ transitioned: true, issue: transformIssueRef(key) });
+      const after = await readBack(client, key, ["status", "resolution", ...Object.keys(opts.fields ?? {})]);
+      output({ transitioned: true, issue: transformIssueRef(key), ...after });
     }
   );
 }
@@ -1938,6 +1967,8 @@ function update3(parent) {
         notifyUsers: opts.notifyUsers
       });
     }
+    const touched = [.../* @__PURE__ */ new Set([...Object.keys(fields), ...Object.keys(updateOps)])];
+    const after = didFieldUpdate ? await readBack(client, key, touched) : {};
     const uploaded = [];
     if (opts.attachments) {
       const filePaths = opts.attachments.split(",").map((p) => p.trim()).filter(Boolean);
@@ -1950,8 +1981,9 @@ function update3(parent) {
     }
     output({
       ...didFieldUpdate && { updated: true },
-      ...uploaded.length > 0 && { attached: true, attachments: uploaded },
-      issue: transformIssueRef(key)
+      issue: transformIssueRef(key),
+      ...after,
+      ...uploaded.length > 0 && { attached: true, attachments: uploaded }
     });
   });
 }
@@ -2570,7 +2602,7 @@ function list9(parent) {
   examples(cmd, ["", "--query billing", "--limit 50", "--all --permissions"]);
   cmd.action(async (opts) => {
     if (opts.all && process.argv.includes("--limit")) {
-      const { CliUsageError: CliUsageError2 } = await import("./dist-JXPWCMQP.js");
+      const { CliUsageError: CliUsageError2 } = await import("./dist-YSXRGQRB.js");
       throw new CliUsageError2("--all and --limit ask for opposite things; pass one or the other");
     }
     const client = getClient();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jiradc-cli",
-  "version": "1.0.44",
+  "version": "1.0.45",
   "publish": true,
   "type": "module",
   "main": "dist/index.js",
@@ -13,7 +13,7 @@
   "dependencies": {
     "commander": "^13.1.0",
     "zod": "^3.25.67",
-    "jira-data-center-client": "1.0.47"
+    "jira-data-center-client": "1.0.48"
   },
   "devDependencies": {
     "@types/node": "24.10.4",
@@ -23,9 +23,9 @@
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
     "vitest": "^4.0.16",
-    "config-eslint": "0.0.0",
     "config-typescript": "0.0.0",
-    "cli-utils": "1.0.0"
+    "cli-utils": "1.0.0",
+    "config-eslint": "0.0.0"
   },
   "engines": {
     "node": ">=22.0.0"