jiradc-cli 1.0.43 → 1.0.45

package/README.md

@@ -31,27 +31,68 @@ All commands output JSON. Add `--pretty` to pretty-print.
 
 ### issue
 
-| Command                               | Description                                                                                                                                           |
-| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `jiradc issue get <key>`              | One issue. `--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
+
+With no `--fields`, one issue comes back with every dimension that hangs off it, out of the
+single request the command already makes:
+
+| Default field                                                   | What arrives                                             |
+| --------------------------------------------------------------- | -------------------------------------------------------- |
+| `summary` `status` `issuetype` `priority` `labels` `components` | The issue itself                                         |
+| `assignee` `reporter` `created` `updated`                       | Who and when                                             |
+| `description`                                                   | In full — it is the issue, not a dimension of it         |
+| `issuelinks`                                                    | `{ id, type, key, summary, status, issuetype }` per link |
+| `epic`                                                          | The key of the epic this issue sits under, if any        |
+| `parent` `subtasks`                                             | `{ key, summary, status, issuetype }` each               |
+| `attachment`                                                    | `{ files: [{ id, filename, size }], use }`               |
+| `comment`                                                       | `{ count, use }` — the thread is named, not carried      |
+
+The rule: **the default names every dimension, and carries it only when carrying it is
+complete.** A link stub is the whole link, so links arrive whole and point at no command. An
+attachment's bytes and a comment's body are not something to inline, so those arrive as an
+inventory plus the command that reads them — the same `use` convention `project get` uses for
+components and versions. A field with nothing in it is absent altogether, pointer included:
+no `attachment` key means there are no attachments, which is readable only because the field
+was asked for.
+
+`type` on a link is the phrase true **from this issue's side** — `blocks`, `is blocked by`,
+`relates to` — so the direction needs no decoding and there is no nested `inwardIssue` /
+`outwardIssue`. The link's own id is `linkId`, not `id`, because `id` beside `key` reads as the
+linked issue's id. `--fields issuelinks` returns the same flat shape.
+
+Every row above is a `--fields` selector except `epic`, which is an output key: the Epic Link is
+a custom field, so select it by name with `--fields "Epic Link"`.
+
+Naming `attachment` or `comment` in `--fields`, or passing `--all-fields`, returns that field
+in full instead. `worklog` and `watches` are not requested at all; ask for them by name.
+
+Nothing here costs a second request. Development activity and the change history are separate
+endpoints and stay behind `issue dev-status` and `issue changelog`.
+
+`issue search` deliberately keeps none of this — what is one link list on one issue is fifty of
+them on a page of results.
 
 #### issue comment
 

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";
@@ -187,6 +187,31 @@ function transformSprint(s) {
   };
 }
 
+// src/utils/constants.ts
+var SEARCH_DEFAULT_FIELDS = [
+  "summary",
+  "status",
+  "assignee",
+  "reporter",
+  "labels",
+  "priority",
+  "created",
+  "updated",
+  "issuetype",
+  "components"
+];
+var EPIC_LINK_FIELD_ID = "customfield_10100";
+var DEFAULT_FIELDS = [
+  ...SEARCH_DEFAULT_FIELDS,
+  "description",
+  "comment",
+  "issuelinks",
+  EPIC_LINK_FIELD_ID,
+  "parent",
+  "subtasks",
+  "attachment"
+];
+
 // src/utils/transformers/issue.ts
 function issueBrowseUrl(key) {
   return `${jiraBaseUrl()}/browse/${key}`;
@@ -248,28 +273,24 @@ function transformAttachment(a) {
     ...author ? { author: transformUser(author) } : {}
   };
 }
-function transformIssueBasic(b) {
-  const { self: _self, fields, ...rest } = b;
+function transformIssueStub(b) {
+  const fields = b.fields;
   return {
-    ...rest,
-    url: issueBrowseUrl(b.key),
-    ...fields ? {
-      fields: {
-        ...fields.summary !== void 0 ? { summary: fields.summary } : {},
-        ...fields.status ? { status: transformStatus(fields.status) } : {},
-        ...fields.priority ? { priority: transformPriority(fields.priority) } : {},
-        ...fields.issuetype ? { issuetype: transformIssueType(fields.issuetype) } : {}
-      }
-    } : {}
+    key: b.key,
+    ...fields?.summary !== void 0 ? { summary: fields.summary } : {},
+    ...fields?.status ? { status: fields.status.name } : {},
+    ...fields?.issuetype ? { issuetype: fields.issuetype.name } : {}
   };
 }
 function transformIssueLink(l) {
-  const { self: _self, type, inwardIssue, outwardIssue, ...rest } = l;
+  const other = l.outwardIssue ?? l.inwardIssue;
   return {
-    ...rest,
-    type: transformIssueLinkType(type),
-    ...inwardIssue ? { inwardIssue: transformIssueBasic(inwardIssue) } : {},
-    ...outwardIssue ? { outwardIssue: transformIssueBasic(outwardIssue) } : {}
+    linkId: l.id,
+    // A link with an issue on neither end is not something Jira sends. If it
+    // ever does, the type's name is the honest answer — a direction phrase with
+    // nothing on the far end of it would not be.
+    type: other ? l.outwardIssue ? l.type.outward : l.type.inward : l.type.name,
+    ...other ? transformIssueStub(other) : {}
   };
 }
 function customFieldNames(names, fields) {
@@ -279,9 +300,9 @@ function customFieldNames(names, fields) {
   );
   return kept.length > 0 ? Object.fromEntries(kept) : void 0;
 }
-function transformIssue(issue) {
+function transformIssue(issue, opts = {}) {
   const { self: _self, expand: _expand, names, schema: _schema, fields, ...rest } = issue;
-  const transformed = transformIssueFields(fields, issue.key);
+  const transformed = transformIssueFields(fields, issue.key, opts);
   const fieldNames = customFieldNames(names, transformed);
   return {
     ...rest,
@@ -323,6 +344,12 @@ function pruneSentinels(fields) {
   if (watches && watches.watchCount === 0) delete out.watches;
   return out;
 }
+function nameEpicLink(fields) {
+  const value = fields[EPIC_LINK_FIELD_ID];
+  if (typeof value !== "string" || !ISSUE_KEY_PATTERN.test(value)) return fields;
+  const { [EPIC_LINK_FIELD_ID]: _epicLink, ...rest } = fields;
+  return { ...rest, epic: value };
+}
 var DEV_STATUS_DUMP = /com\.atlassian\.jira\.plugin\.devstatus/;
 function collapseDevStatus(fields, key) {
   const out = { ...fields };
@@ -360,7 +387,7 @@ function collapseIssueRefs(fields) {
   }
   return out;
 }
-function transformIssueFields(fields, key) {
+function transformIssueFields(fields, key, opts) {
   if (!fields) return {};
   const {
     // shaped sub-entities (recursed individually)
@@ -387,7 +414,7 @@ function transformIssueFields(fields, key) {
     // everything else: optional scalars, customfield_*, etc. — gets compacted
     ...rest
   } = fields;
-  const compacted = collapseDevStatus(collapseIssueRefs(pruneSentinels(compactRecord(rest))), key);
+  const compacted = collapseDevStatus(collapseIssueRefs(nameEpicLink(pruneSentinels(compactRecord(rest)))), key);
   const components = compacted.components;
   return {
     ...compacted,
@@ -406,13 +433,21 @@ function transformIssueFields(fields, key) {
     ...fixVersions && fixVersions.length > 0 ? { fixVersions: fixVersions.map(transformVersion) } : {},
     ...versions2 && versions2.length > 0 ? { versions: versions2.map(transformVersion) } : {},
     ...issuelinks && issuelinks.length > 0 ? { issuelinks: issuelinks.map(transformIssueLink) } : {},
-    ...subtasks && subtasks.length > 0 ? { subtasks: subtasks.map(transformIssueBasic) } : {},
-    ...parent ? { parent: transformIssueBasic(parent) } : {},
+    ...subtasks && subtasks.length > 0 ? { subtasks: subtasks.map(transformIssueStub) } : {},
+    ...parent ? { parent: transformIssueStub(parent) } : {},
     // Drop empty comment / worklog containers entirely. The default Jira
     // search response includes both wrappers on every issue regardless of
     // count; on a 25-issue page that's 25 × 2 empty objects of pure noise.
-    ...comment && comment.comments.length > 0 ? {
-      comment: {
+    // The thread is named, not carried — see `JiraCommentSummaryOutput`.
+    //
+    // The compact branch gates on `total`, not on the array, because `total` is
+    // the only thing it reads. A deployment that caps embedded comments answers
+    // with a populated total and an empty `comments`; gating on the array there
+    // would drop the key, and a missing key is documented to mean "there are
+    // none" — reporting a long thread as no thread, in the one direction the
+    // caller was told to trust.
+    ...comment && (opts.compact ? comment.total > 0 : comment.comments.length > 0) ? {
+      comment: opts.compact ? { count: comment.total, use: `jiradc issue comment list ${key}` } : {
         comments: comment.comments.map(transformComment),
         maxResults: comment.maxResults,
         total: comment.total,
@@ -427,9 +462,35 @@ function transformIssueFields(fields, key) {
         startAt: worklog.startAt
       }
     } : {},
-    ...attachment && attachment.length > 0 ? { attachment: attachment.map(transformAttachment) } : {}
+    // `attachment` is in the default field set to say that files are attached —
+    // not to carry their records. An empty list yields no key at all rather
+    // than a pointer to nothing: the absence is the answer, and it is readable
+    // as one only because the field was asked for.
+    ...attachment && attachment.length > 0 ? {
+      attachment: opts.compact ? {
+        files: attachment.map(({ id, filename, size }) => ({ id, filename, size })),
+        // Both commands spelled in full. Abbreviating the second to
+        // `download …` saved 24 characters and invited a caller to run
+        // exactly that, which is not a command.
+        use: `jiradc issue attachment download-all ${key} --output <dir> (one file: jiradc issue attachment download ${key} --attachment-id <id> --output <path>)`
+      } : attachment.map(transformAttachment)
+    } : {}
+  };
+}
+
+// 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) {
@@ -1030,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" }];
         }
@@ -1074,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 }));
   });
 }
 
@@ -1437,21 +1502,6 @@ function editmeta(parent) {
   });
 }
 
-// src/utils/constants.ts
-var SEARCH_DEFAULT_FIELDS = [
-  "summary",
-  "status",
-  "assignee",
-  "reporter",
-  "labels",
-  "priority",
-  "created",
-  "updated",
-  "issuetype",
-  "components"
-];
-var DEFAULT_FIELDS = [...SEARCH_DEFAULT_FIELDS, "description", "comment"];
-
 // src/utils/field-selectors.ts
 var WILDCARD = "*";
 var NEGATION = "-";
@@ -1555,10 +1605,13 @@ async function loadFieldNameIndex(client) {
 }
 async function selectFields(client, opts, defaults) {
   if (opts.allFields === true) return void 0;
-  if (opts.fields === void 0) return defaults;
-  const tokens = parseFieldSelectors(opts.fields);
-  if (tokens.length === 0) return defaults;
-  return resolveFieldSelectors(tokens, await loadFieldNameIndex(client));
+  if (usesDefaultFields(opts)) return defaults;
+  return resolveFieldSelectors(parseFieldSelectors(opts.fields), await loadFieldNameIndex(client));
+}
+function usesDefaultFields(opts) {
+  if (opts.allFields === true) return false;
+  if (opts.fields === void 0) return true;
+  return parseFieldSelectors(opts.fields).length === 0;
 }
 
 // src/commands/issue/get.ts
@@ -1578,7 +1631,7 @@ function get4(parent) {
       fields,
       expand: opts.expand
     });
-    output(transformIssue(result));
+    output(transformIssue(result, { compact: usesDefaultFields(opts) }));
   });
 }
 
@@ -1590,7 +1643,7 @@ function linkEpic(parent) {
     const client = getClient();
     const results = await Promise.allSettled(
       keys.map(
-        (key) => client.issues.update({ issueKeyOrId: key, fields: { customfield_10100: opts.epic } }).then(() => key)
+        (key) => client.issues.update({ issueKeyOrId: key, fields: { [EPIC_LINK_FIELD_ID]: opts.epic } }).then(() => key)
       )
     );
     const linked = [];
@@ -1711,26 +1764,41 @@ function search2(parent) {
         return;
       }
       const every = await fetchEveryPage(page, { pageSize: plan.pageSize, start: plan.start });
-      output({ ...every, issues: every.issues.map(transformIssue) });
+      output({ ...every, issues: every.issues.map((i) => transformIssue(i)) });
     }
   );
 }
 
 // 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(
@@ -1739,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>",
@@ -1757,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 });
     }
   );
 }
@@ -1903,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);
@@ -1915,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 }
     });
   });
 }
@@ -2535,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();
@@ -2757,7 +2824,7 @@ function search3(parent) {
         total: res.total,
         startAt: res.startAt,
         count: res.issues?.length ?? 0,
-        issues: (res.issues ?? []).map(transformIssue)
+        issues: (res.issues ?? []).map((i) => transformIssue(i))
       });
     }
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jiradc-cli",
-  "version": "1.0.43",
+  "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-typescript": "0.0.0",
     "cli-utils": "1.0.0",
-    "config-eslint": "0.0.0",
-    "config-typescript": "0.0.0"
+    "config-eslint": "0.0.0"
   },
   "engines": {
     "node": ">=22.0.0"