jiradc-cli 1.0.12 → 1.0.13

package/dist/index.js

@@ -80,35 +80,13 @@ function getClient() {
   return new JiraClient({ baseUrl, token });
 }
 
-// src/utils/strip-response.ts
-function stripResponse(obj) {
-  if (Array.isArray(obj)) {
-    return obj.map(stripResponse);
-  }
-  if (obj === null || typeof obj !== "object") {
-    return obj;
-  }
-  const record = obj;
-  const result = {};
-  for (const [key, value] of Object.entries(record)) {
-    if (key === "self" || key === "_links" || key === "_expandable" || key === "expand" || key === "avatarUrls" || key === "avatarId" || key === "iconUrl") {
-      continue;
-    }
-    if (value === null || value === void 0) {
-      continue;
-    }
-    result[key] = stripResponse(value);
-  }
-  return result;
-}
-
 // src/utils/output.ts
 var prettyPrint = false;
 function setPretty(value) {
   prettyPrint = value;
 }
 function output(data) {
-  process.stdout.write(`${JSON.stringify(stripResponse(data), null, prettyPrint ? 2 : void 0)}
+  process.stdout.write(`${JSON.stringify(data, null, prettyPrint ? 2 : void 0)}
 `);
 }
 function handleError(err) {
@@ -174,6 +152,282 @@ function handleError(err) {
   process.exit(1);
 }
 
+// src/utils/transformers/base.ts
+function jiraBaseUrl() {
+  return (process.env.JIRA_URL ?? "").replace(/\/+$/, "");
+}
+function transformPaged(response, fn) {
+  const { startAt, maxResults, total } = response;
+  if ("issues" in response) {
+    const mapped2 = response.issues.map(fn);
+    return { startAt, maxResults, total, isLast: startAt + mapped2.length >= total, issues: mapped2 };
+  }
+  if ("values" in response) {
+    const mapped2 = response.values.map(fn);
+    return { startAt, maxResults, total, isLast: startAt + mapped2.length >= total, values: mapped2 };
+  }
+  const mapped = response.worklogs.map(fn);
+  return { startAt, maxResults, total, isLast: startAt + mapped.length >= total, worklogs: mapped };
+}
+
+// src/utils/transformers/user.ts
+function transformUser(user) {
+  const { self: _self, avatarUrls: _avatarUrls, expand: _expand, ...rest } = user;
+  return rest;
+}
+
+// src/utils/transformers/field.ts
+function transformField(field) {
+  return field;
+}
+function transformCustomFieldOption(option) {
+  const { self: _self, ...rest } = option;
+  return rest;
+}
+
+// src/utils/transformers/project.ts
+function projectBrowseUrl(key) {
+  return `${jiraBaseUrl()}/projects/${key}`;
+}
+function transformProject(p) {
+  const { self: _self, avatarUrls: _avatarUrls, expand: _expand, lead, ...rest } = p;
+  return {
+    ...rest,
+    url: projectBrowseUrl(p.key),
+    ...lead ? { lead: transformUser(lead) } : {}
+  };
+}
+
+// src/utils/transformers/component.ts
+function componentBrowseUrl(projectKey) {
+  return `${jiraBaseUrl()}/projects/${projectKey}/components`;
+}
+function transformComponent(c) {
+  const { self: _self, lead, assignee, realAssignee, ...rest } = c;
+  return {
+    ...rest,
+    ...c.project ? { url: componentBrowseUrl(c.project) } : {},
+    ...lead ? { lead: transformUser(lead) } : {},
+    ...assignee ? { assignee: transformUser(assignee) } : {},
+    ...realAssignee ? { realAssignee: transformUser(realAssignee) } : {}
+  };
+}
+function transformComponentIssueCounts(c) {
+  const { self: _self, ...rest } = c;
+  return rest;
+}
+
+// src/utils/transformers/board.ts
+function boardBrowseUrl(boardId) {
+  return `${jiraBaseUrl()}/secure/RapidBoard.jspa?rapidView=${boardId}`;
+}
+function transformBoard(b) {
+  const { self: _self, ...rest } = b;
+  return { ...rest, url: boardBrowseUrl(b.id) };
+}
+
+// src/utils/transformers/sprint.ts
+function sprintBrowseUrl(boardId, sprintId) {
+  return `${jiraBaseUrl()}/secure/RapidBoard.jspa?rapidView=${boardId}&view=planning&sprint=${sprintId}`;
+}
+function transformSprint(s) {
+  const { self: _self, ...rest } = s;
+  return {
+    ...rest,
+    ...s.originBoardId !== void 0 ? { url: sprintBrowseUrl(s.originBoardId, s.id) } : {}
+  };
+}
+
+// src/utils/transformers/issue.ts
+function issueBrowseUrl(key) {
+  return `${jiraBaseUrl()}/browse/${key}`;
+}
+function transformIssueRef(key) {
+  return { key, url: issueBrowseUrl(key) };
+}
+function transformCreatedIssue(r) {
+  return { id: r.id, key: r.key, url: issueBrowseUrl(r.key) };
+}
+function transformIssueType(t) {
+  const { self: _self, iconUrl: _iconUrl, avatarId: _avatarId, description: _description, ...rest } = t;
+  return rest;
+}
+function transformStatus(s) {
+  const { self: _self, iconUrl: _iconUrl, description: _description, statusCategory, ...rest } = s;
+  return {
+    ...rest,
+    // statusCategory carries `self` and `colorName` we don't want; keep only id/key/name.
+    ...statusCategory ? { statusCategory: { id: statusCategory.id, key: statusCategory.key, name: statusCategory.name } } : {}
+  };
+}
+function transformPriority(p) {
+  const { self: _self, iconUrl: _iconUrl, ...rest } = p;
+  return rest;
+}
+function transformResolution(r) {
+  const { self: _self, description: _description, ...rest } = r;
+  return rest;
+}
+function transformVersion(v) {
+  const { self: _self, ...rest } = v;
+  return rest;
+}
+function transformIssueLinkType(t) {
+  const { self: _self, ...rest } = t;
+  return rest;
+}
+function transformComment(c) {
+  const { self: _self, author, updateAuthor, ...rest } = c;
+  return {
+    ...rest,
+    ...author ? { author: transformUser(author) } : {},
+    ...updateAuthor ? { updateAuthor: transformUser(updateAuthor) } : {}
+  };
+}
+function transformWorklog(w) {
+  const { self: _self, author, updateAuthor, ...rest } = w;
+  return {
+    ...rest,
+    ...author ? { author: transformUser(author) } : {},
+    ...updateAuthor ? { updateAuthor: transformUser(updateAuthor) } : {}
+  };
+}
+function transformAttachment(a) {
+  const { self: _self, author, ...rest } = a;
+  return {
+    ...rest,
+    ...author ? { author: transformUser(author) } : {}
+  };
+}
+function transformIssueBasic(b) {
+  const { self: _self, fields, ...rest } = b;
+  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) } : {}
+      }
+    } : {}
+  };
+}
+function transformIssueLink(l) {
+  const { self: _self, type, inwardIssue, outwardIssue, ...rest } = l;
+  return {
+    ...rest,
+    type: transformIssueLinkType(type),
+    ...inwardIssue ? { inwardIssue: transformIssueBasic(inwardIssue) } : {},
+    ...outwardIssue ? { outwardIssue: transformIssueBasic(outwardIssue) } : {}
+  };
+}
+function transformIssue(issue) {
+  const { self: _self, expand: _expand, names: _names, schema: _schema, fields, ...rest } = issue;
+  return {
+    ...rest,
+    url: issueBrowseUrl(issue.key),
+    fields: transformIssueFields(fields)
+  };
+}
+function isEmpty(v) {
+  if (v === null || v === void 0 || v === "") return true;
+  if (Array.isArray(v)) return v.length === 0;
+  if (typeof v === "object") return Object.keys(v).length === 0;
+  return false;
+}
+function compactRecord(obj) {
+  const out = {};
+  for (const [k, v] of Object.entries(obj)) {
+    if (!isEmpty(v)) out[k] = v;
+  }
+  return out;
+}
+function pruneSentinels(fields) {
+  const out = { ...fields };
+  delete out.aggregatetimespent;
+  delete out.aggregatetimeestimate;
+  delete out.aggregatetimeoriginalestimate;
+  if (out.workratio === -1) delete out.workratio;
+  for (const k of ["progress", "aggregateprogress"]) {
+    const v = out[k];
+    if (v && v.progress === 0 && v.total === 0) delete out[k];
+  }
+  const votes = out.votes;
+  if (votes && votes.votes === 0) delete out.votes;
+  const watches = out.watches;
+  if (watches && watches.watchCount === 0) delete out.watches;
+  return out;
+}
+function transformIssueFields(fields) {
+  const {
+    // shaped sub-entities (recursed individually)
+    issuetype,
+    status,
+    priority,
+    resolution,
+    assignee,
+    reporter,
+    creator,
+    fixVersions,
+    versions: versions2,
+    issuelinks,
+    subtasks,
+    parent,
+    comment: comment2,
+    worklog: worklog2,
+    attachment,
+    // required scalars / structured fields we always keep verbatim
+    summary,
+    project,
+    created,
+    updated,
+    // everything else: optional scalars, customfield_*, etc. — gets compacted
+    ...rest
+  } = fields;
+  const compacted = pruneSentinels(compactRecord(rest));
+  return {
+    ...compacted,
+    summary,
+    project,
+    created,
+    updated,
+    issuetype: transformIssueType(issuetype),
+    status: transformStatus(status),
+    ...priority ? { priority: transformPriority(priority) } : {},
+    ...resolution ? { resolution: transformResolution(resolution) } : {},
+    ...assignee ? { assignee: transformUser(assignee) } : {},
+    ...reporter ? { reporter: transformUser(reporter) } : {},
+    ...creator ? { creator: transformUser(creator) } : {},
+    ...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) } : {},
+    // 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.
+    ...comment2 && comment2.comments.length > 0 ? {
+      comment: {
+        comments: comment2.comments.map(transformComment),
+        maxResults: comment2.maxResults,
+        total: comment2.total,
+        startAt: comment2.startAt
+      }
+    } : {},
+    ...worklog2 && worklog2.worklogs.length > 0 ? {
+      worklog: {
+        worklogs: worklog2.worklogs.map(transformWorklog),
+        maxResults: worklog2.maxResults,
+        total: worklog2.total,
+        startAt: worklog2.startAt
+      }
+    } : {},
+    ...attachment && attachment.length > 0 ? { attachment: attachment.map(transformAttachment) } : {}
+  };
+}
+
 // src/commands/board/issues.ts
 function issues(parent) {
   parent.command("issues").description("Get issues for a board").addArgument(new Argument("<id>", "Board ID").argParser(positiveInt)).option("--max <number>", "Max results (1-50, Jira DC caps at 50)", intInRange(1, 50), 25).option("--start-at <number>", "Starting index for pagination", nonNegativeInt).option("--fields <fields>", "Comma-separated field names to return").option("--jql <jql>", "Additional JQL filter within the board").addHelpText(
@@ -188,7 +442,7 @@ function issues(parent) {
       fields: opts.fields?.split(",").map((f) => f.trim()),
       jql: opts.jql
     });
-    output(result);
+    output(transformPaged(result, transformIssue));
   });
 }
 
@@ -207,7 +461,7 @@ function list(parent) {
       type: opts.type,
       name: opts.name
     });
-    output(result);
+    output(result.map(transformBoard));
   });
 }
 
@@ -252,7 +506,7 @@ Examples:
         leadUserName: opts.lead,
         assigneeType: opts.assigneeType
       });
-      output(result);
+      output(transformComponent(result));
     }
   );
 }
@@ -277,7 +531,7 @@ function get(parent) {
   parent.command("get <id>").description("Get a component by ID").addHelpText("after", "\nExamples:\n  jiradc component get 11289").action(async (id) => {
     const client = getClient();
     const result = await client.components.get({ id });
-    output(result);
+    output(transformComponent(result));
   });
 }
 
@@ -286,7 +540,7 @@ function issueCount(parent) {
   parent.command("issue-count <id>").description("Get the number of issues currently using this component").addHelpText("after", "\nExamples:\n  jiradc component issue-count 11289").action(async (id) => {
     const client = getClient();
     const result = await client.components.getRelatedIssueCounts({ id });
-    output(result);
+    output(transformComponentIssueCounts(result));
   });
 }
 
@@ -295,7 +549,7 @@ function list2(parent) {
   parent.command("list <projectKey>").description("List all components for a project").addHelpText("after", "\nExamples:\n  jiradc component list AI").action(async (projectKey) => {
     const client = getClient();
     const result = await client.components.list({ projectKeyOrId: projectKey });
-    output(result);
+    output(result.map(transformComponent));
   });
 }
 
@@ -328,7 +582,7 @@ Examples:
         leadUserName: opts.lead,
         assigneeType: opts.assigneeType
       });
-      output(result);
+      output(transformComponent(result));
     }
   );
 }
@@ -368,7 +622,7 @@ function options(parent) {
       maxResults: opts.max,
       page: opts.page
     });
-    output(result);
+    output(transformPaged({ ...result, startAt: result.startAt ?? 0 }, transformCustomFieldOption));
   });
 }
 
@@ -380,7 +634,7 @@ function search(parent) {
   ).action(async (keyword, opts) => {
     const client = getClient();
     const result = await client.fields.search(keyword, opts.limit);
-    output(result);
+    output(result.map(transformField));
   });
 }
 
@@ -618,7 +872,7 @@ Examples:
     for (const issue of parsed) {
       try {
         const result = await client.issues.create(issue);
-        results.push({ key: result.key });
+        results.push(transformCreatedIssue(result));
       } catch (error) {
         results.push({ error: error instanceof Error ? error.message : "Unknown error" });
       }
@@ -679,12 +933,12 @@ Examples:
         dueDate: f.duedate ?? void 0,
         assignee: opts.assignee ?? f.assignee?.name
       };
-      const result = await client.issues.create(createParams);
-      const newKey = result.key;
+      const created = transformCreatedIssue(await client.issues.create(createParams));
+      const newKey = created.key;
       const cloneResult = {
         cloned: true,
         source: key,
-        newIssue: result
+        newIssue: created
       };
       if (opts.includeAttachments && f.attachment?.length) {
         const tmpFiles = [];
@@ -721,9 +975,9 @@ Examples:
             return Promise.resolve();
           })
         );
-        const created = outcomes.filter((o) => o.status === "fulfilled").length;
+        const created2 = outcomes.filter((o) => o.status === "fulfilled").length;
         const skipped = outcomes.filter((o) => o.status === "rejected").length;
-        cloneResult.linksCopied = created;
+        cloneResult.linksCopied = created2;
         if (skipped > 0) cloneResult.linksSkipped = skipped;
       }
       output(cloneResult);
@@ -736,7 +990,7 @@ function commentEdit(parent) {
   parent.command("comment-edit <key>").description("Edit an existing comment").requiredOption("--id <commentId>", "Comment ID to edit").requiredOption("--body <text>", "Updated comment body in wiki markup").addHelpText("after", '\nExamples:\n  jiradc issue comment-edit PROJ-123 --id 12345 --body "Updated comment text"').action(async (key, opts) => {
     const client = getClient();
     const result = await client.issues.editComment({ issueKeyOrId: key, commentId: opts.id, body: opts.body });
-    output(result);
+    output(transformComment(result));
   });
 }
 
@@ -745,7 +999,7 @@ function comment(parent) {
   parent.command("comment <key>").description("Add a comment to an issue").requiredOption("--body <text>", "Comment body in wiki markup").addHelpText("after", '\nExamples:\n  jiradc issue comment PROJ-123 --body "Fixed in latest build"').action(async (key, opts) => {
     const client = getClient();
     const result = await client.issues.addComment({ issueKeyOrId: key, body: opts.body });
-    output(result);
+    output(transformComment(result));
   });
 }
 
@@ -777,7 +1031,7 @@ Examples:
         parent: opts.parent,
         customFields: opts.customFields ? JSON.parse(opts.customFields) : void 0
       });
-      output(result);
+      output(transformCreatedIssue(result));
     }
   );
 }
@@ -885,7 +1139,7 @@ function getWorklog(parent) {
       startAt: opts.startAt,
       maxResults: opts.max
     });
-    output(result);
+    output(transformPaged(result, transformWorklog));
   });
 }
 
@@ -918,7 +1172,7 @@ function get2(parent) {
       fields,
       expand: opts.expand
     });
-    output(result);
+    output(transformIssue(result));
   });
 }
 
@@ -930,7 +1184,11 @@ function linkEpic(parent) {
       issueKeyOrId: key,
       fields: { customfield_10100: opts.epic }
     });
-    output({ linked: true, issue: key, epic: opts.epic });
+    output({
+      linked: true,
+      issue: transformIssueRef(key),
+      epic: transformIssueRef(opts.epic)
+    });
   });
 }
 
@@ -939,7 +1197,7 @@ function linkTypes(parent) {
   parent.command("link-types").description("List all issue link types").addHelpText("after", "\nExamples:\n  jiradc issue link-types").action(async () => {
     const client = getClient();
     const result = await client.links.getTypes();
-    output(result);
+    output(result.map(transformIssueLinkType));
   });
 }
 
@@ -956,7 +1214,12 @@ function link(parent) {
       outwardIssueKey: opts.to,
       comment: opts.comment
     });
-    output({ created: true, type: opts.type, inward: opts.from, outward: opts.to });
+    output({
+      created: true,
+      type: opts.type,
+      inward: transformIssueRef(opts.from),
+      outward: transformIssueRef(opts.to)
+    });
   });
 }
 
@@ -974,7 +1237,7 @@ function search2(parent) {
       maxResults: opts.max,
       fields
     });
-    output(result);
+    output(transformPaged(result, transformIssue));
   });
 }
 
@@ -986,7 +1249,7 @@ function transition(parent) {
   ).action(async (key, opts) => {
     const client = getClient();
     await client.issues.transition({ issueKeyOrId: key, transitionId: opts.to, comment: opts.comment });
-    output({ transitioned: true, issueKey: key });
+    output({ transitioned: true, issue: transformIssueRef(key) });
   });
 }
 
@@ -1037,7 +1300,11 @@ Examples:
         }
       }
     }
-    output({ updated: true, issueKey: key, ...uploaded.length > 0 && { attachments: uploaded } });
+    output({
+      updated: true,
+      issue: transformIssueRef(key),
+      ...uploaded.length > 0 && { attachments: uploaded }
+    });
   });
 }
 
@@ -1054,7 +1321,7 @@ function worklog(parent) {
       comment: opts.comment,
       started: opts.started
     });
-    output(result);
+    output(transformWorklog(result));
   });
 }
 
@@ -1104,7 +1371,7 @@ function list4(parent) {
   ).action(async (opts) => {
     const client = getClient();
     const result = await client.projects.getAll({ expand: opts.expand, includeArchived: opts.includeArchived });
-    output(result);
+    output(result.map(transformProject));
   });
 }
 
@@ -1116,7 +1383,7 @@ function versions(parent) {
   ).action(async (key, opts) => {
     const client = getClient();
     const result = await client.projects.getVersions({ projectKeyOrId: key, expand: opts.expand });
-    output(result);
+    output(result.map(transformVersion));
   });
 }
 
@@ -1148,7 +1415,7 @@ function create3(parent) {
       endDate: opts.endDate,
       goal: opts.goal
     });
-    output(result);
+    output(transformSprint(result));
   });
 }
 
@@ -1167,7 +1434,7 @@ function issues2(parent) {
       fields: opts.fields?.split(",").map((f) => f.trim()),
       jql: opts.jql
     });
-    output(result);
+    output(transformPaged(result, transformIssue));
   });
 }
 
@@ -1184,7 +1451,7 @@ function list5(parent) {
       boardId: opts.board,
       state: opts.state
     });
-    output(result);
+    output(result.map(transformSprint));
   });
 }
 
@@ -1206,7 +1473,7 @@ function update3(parent) {
         endDate: opts.endDate,
         goal: opts.goal
       });
-      output(result);
+      output(transformSprint(result));
     }
   );
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jiradc-cli",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "publish": true,
   "type": "module",
   "main": "dist/index.js",
@@ -12,7 +12,7 @@
   ],
   "dependencies": {
     "commander": "^13.1.0",
-    "jira-data-center-client": "1.0.31"
+    "jira-data-center-client": "1.0.32"
   },
   "devDependencies": {
     "@types/node": "24.10.4",