jiradc-cli 1.0.10 → 1.0.12-g3332dfd.1

package/README.md

@@ -0,0 +1,143 @@
+# jiradc-cli
+
+Command-line interface for [Jira Data Center](https://developer.atlassian.com/server/jira/platform/rest-apis/). 35 commands across 6 domains — issues, projects, boards, sprints, fields, and users.
+
+## Install
+
+```bash
+npm install -g jiradc-cli
+```
+
+## Setup
+
+```bash
+export JIRA_URL="https://jira.example.com"   # Base URL of your Jira instance
+export JIRA_TOKEN="your-personal-access-token" # HTTP Access Token from Jira
+```
+
+## Commands
+
+All commands output JSON. Add `--pretty` to pretty-print.
+
+### issue
+
+| Command | Description |
+|---------|-------------|
+| `jiradc issue get <key>` | Get issue details (`--fields` to select, `--expand` for changelog/transitions) |
+| `jiradc issue search <jql>` | Search issues with JQL |
+| `jiradc issue create` | Create an issue (`--project`, `--type`, `--summary`, `--description`, `--custom-fields`) |
+| `jiradc issue update <key>` | Update an issue |
+| `jiradc issue delete <key>` | Delete an issue |
+| `jiradc issue transition <key> <transitionId>` | Transition issue to a new status |
+| `jiradc issue transitions <key>` | List available transitions |
+| `jiradc issue comment <key>` | Add a comment |
+| `jiradc issue comment-edit <key> <commentId>` | Edit a comment |
+| `jiradc issue link <key> <targetKey>` | Link two issues (`--type` link type name) |
+| `jiradc issue unlink <linkId>` | Remove a link |
+| `jiradc issue link-types` | List available link types |
+| `jiradc issue link-epic <epicKey> <issueKey>` | Link an issue to an epic |
+| `jiradc issue worklog <key>` | Add a work log entry |
+| `jiradc issue get-worklog <key>` | Get work log entries |
+| `jiradc issue changelog <key>` | Get issue changelog |
+| `jiradc issue batch-changelog` | Get changelog for multiple issues (`--keys`) |
+| `jiradc issue clone <key>` | Clone an issue with subtasks |
+| `jiradc issue batch-create` | Create multiple issues from JSON |
+| `jiradc issue dev-status <key>` | Get development status (branches, PRs, commits) |
+
+#### issue attachment
+
+| Command | Description |
+|---------|-------------|
+| `jiradc issue attachment list <key>` | List attachments |
+| `jiradc issue attachment download <key> <attachmentId>` | Download a specific attachment |
+| `jiradc issue attachment download-all <key>` | Download all attachments |
+| `jiradc issue attachment upload <key> <files...>` | Upload files |
+| `jiradc issue attachment delete <attachmentId>` | Delete an attachment |
+
+### project
+
+| Command | Description |
+|---------|-------------|
+| `jiradc project list` | List projects |
+| `jiradc project versions <key>` | List versions for a project |
+| `jiradc project components <key>` | List components for a project |
+
+### board
+
+| Command | Description |
+|---------|-------------|
+| `jiradc board list` | List boards (`--project`, `--type`: scrum/kanban/simple, `--name`) |
+| `jiradc board issues <boardId>` | Get issues on a board |
+
+### sprint
+
+| Command | Description |
+|---------|-------------|
+| `jiradc sprint list <boardId>` | List sprints (`--state`: future/active/closed) |
+| `jiradc sprint issues <boardId> <sprintId>` | Get issues in a sprint |
+| `jiradc sprint create <boardId>` | Create a sprint |
+| `jiradc sprint update <sprintId>` | Update a sprint |
+
+### field
+
+| Command | Description |
+|---------|-------------|
+| `jiradc field search` | Search for fields (`--query`, `--type`: custom/system) |
+| `jiradc field options <fieldKey>` | Get allowed values for a field (`--project`, `--issue-type`) |
+
+### user
+
+| Command | Description |
+|---------|-------------|
+| `jiradc user me` | Get current user info |
+
+## Pagination
+
+Search and list commands accept `--max` to control page size (Jira DC caps at 50 for agile endpoints). Responses include `nextPage` — pass it back as `--start-at` to fetch the next page. When `nextPage` is `null`, there are no more results.
+
+## Examples
+
+```bash
+# Get an issue with default fields
+jiradc issue get AI-123
+
+# Get an issue with specific fields
+jiradc issue get AI-123 --fields summary,status,assignee,customfield_10100
+
+# Search with JQL
+jiradc issue search 'project = AI AND status = "In Development" ORDER BY updated DESC'
+
+# Create an issue
+jiradc issue create --project AI --type Task --summary "Implement feature X" --description "Details here"
+
+# Create with custom fields
+jiradc issue create --project AI --type Story --summary "User login" --custom-fields '{"customfield_10100": "value"}'
+
+# Transition an issue (find transition ID first)
+jiradc issue transitions AI-123
+jiradc issue transition AI-123 31
+
+# Add a comment
+jiradc issue comment AI-123 --body "Fixed in commit abc123"
+
+# Link two issues
+jiradc issue link AI-123 AI-456 --type "blocks"
+
+# Log work
+jiradc issue worklog AI-123 --time "2h 30m" --comment "Code review"
+
+# List active sprints
+jiradc sprint list 42 --state active
+
+# Get sprint issues
+jiradc sprint issues 42 100
+
+# Find a custom field key
+jiradc field search --query "story points"
+
+# Clone an issue with subtasks
+jiradc issue clone AI-123
+
+# Get dev status (linked branches, PRs)
+jiradc issue dev-status AI-123
+```

package/dist/index.js

@@ -5,7 +5,7 @@ import { readFileSync } from "fs";
 import { dirname, join as join4 } from "path";
 import { fileURLToPath } from "url";
 import { styleText } from "util";
-import { Command as Command6 } from "commander";
+import { Command as Command8 } from "commander";
 
 // src/commands/board/issues.ts
 import { Argument } from "commander";
@@ -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,234 @@ 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, ...rest } = t;
+  return rest;
+}
+function transformStatus(s) {
+  const { self: _self, iconUrl: _iconUrl, ...rest } = s;
+  return rest;
+}
+function transformPriority(p) {
+  const { self: _self, iconUrl: _iconUrl, ...rest } = p;
+  return rest;
+}
+function transformResolution(r) {
+  const { self: _self, ...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, fields, ...rest } = issue;
+  return {
+    ...rest,
+    url: issueBrowseUrl(issue.key),
+    fields: transformIssueFields(fields)
+  };
+}
+function transformIssueFields(fields) {
+  const {
+    issuetype,
+    status,
+    priority,
+    resolution,
+    assignee,
+    reporter,
+    creator,
+    fixVersions,
+    versions: versions2,
+    issuelinks,
+    subtasks,
+    parent,
+    comment: comment2,
+    worklog: worklog2,
+    attachment,
+    ...rest
+  } = fields;
+  return {
+    ...rest,
+    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: fixVersions.map(transformVersion) } : {},
+    ...versions2 ? { versions: versions2.map(transformVersion) } : {},
+    ...issuelinks ? { issuelinks: issuelinks.map(transformIssueLink) } : {},
+    ...subtasks ? { subtasks: subtasks.map(transformIssueBasic) } : {},
+    ...parent ? { parent: transformIssueBasic(parent) } : {},
+    ...comment2 ? {
+      comment: {
+        comments: comment2.comments.map(transformComment),
+        maxResults: comment2.maxResults,
+        total: comment2.total,
+        startAt: comment2.startAt
+      }
+    } : {},
+    ...worklog2 ? {
+      worklog: {
+        worklogs: worklog2.worklogs.map(transformWorklog),
+        maxResults: worklog2.maxResults,
+        total: worklog2.total,
+        startAt: worklog2.startAt
+      }
+    } : {},
+    ...attachment ? { 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 +394,7 @@ function issues(parent) {
       fields: opts.fields?.split(",").map((f) => f.trim()),
       jql: opts.jql
     });
-    output(result);
+    output(transformPaged(result, transformIssue));
   });
 }
 
@@ -207,7 +413,7 @@ function list(parent) {
       type: opts.type,
       name: opts.name
     });
-    output(result);
+    output(result.map(transformBoard));
   });
 }
 
@@ -226,6 +432,135 @@ Examples:
   issues(board);
 }
 
+// src/commands/component/create.ts
+import { Option as Option2 } from "commander";
+var ASSIGNEE_TYPES = [
+  "PROJECT_DEFAULT",
+  "COMPONENT_LEAD",
+  "PROJECT_LEAD",
+  "UNASSIGNED"
+];
+function create(parent) {
+  parent.command("create").description("Create a new component in a project").requiredOption("--project <key>", "Project key (e.g., AI)").requiredOption("--name <name>", "Component name").option("--description <text>", "Component description").option("--lead <username>", "Username of the component lead").addOption(new Option2("--assignee-type <type>", "Assignee strategy").choices(ASSIGNEE_TYPES)).addHelpText(
+    "after",
+    `
+Examples:
+  jiradc component create --project AI --name Backend
+  jiradc component create --project AI --name Frontend --description "UI work" --lead jsmith
+  jiradc component create --project AI --name Infra --assignee-type COMPONENT_LEAD --lead jsmith`
+  ).action(
+    async (opts) => {
+      const client = getClient();
+      const result = await client.components.create({
+        project: opts.project,
+        name: opts.name,
+        description: opts.description,
+        leadUserName: opts.lead,
+        assigneeType: opts.assigneeType
+      });
+      output(transformComponent(result));
+    }
+  );
+}
+
+// src/commands/component/delete.ts
+function deleteComponent(parent) {
+  parent.command("delete <id>").description("Delete a component, optionally reassigning its issues to another component").option("--move-issues-to <id>", "Reassign existing issues to this component ID before deletion").addHelpText(
+    "after",
+    `
+Examples:
+  jiradc component delete 11289
+  jiradc component delete 11289 --move-issues-to 11290`
+  ).action(async (id, opts) => {
+    const client = getClient();
+    await client.components.delete({ id, moveIssuesTo: opts.moveIssuesTo });
+    output({ deleted: true, componentId: id, ...opts.moveIssuesTo && { movedIssuesTo: opts.moveIssuesTo } });
+  });
+}
+
+// src/commands/component/get.ts
+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(transformComponent(result));
+  });
+}
+
+// src/commands/component/issue-count.ts
+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(transformComponentIssueCounts(result));
+  });
+}
+
+// src/commands/component/list.ts
+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.map(transformComponent));
+  });
+}
+
+// src/commands/component/update.ts
+import { Option as Option3 } from "commander";
+var ASSIGNEE_TYPES2 = [
+  "PROJECT_DEFAULT",
+  "COMPONENT_LEAD",
+  "PROJECT_LEAD",
+  "UNASSIGNED"
+];
+function update(parent) {
+  parent.command("update <id>").description("Update an existing component (only provided fields are changed)").option("--name <name>", "New component name").option("--description <text>", "New component description").option("--lead <username>", "Username of the component lead (empty string clears it)").addOption(new Option3("--assignee-type <type>", "New assignee strategy").choices(ASSIGNEE_TYPES2)).addHelpText(
+    "after",
+    `
+Examples:
+  jiradc component update 11289 --name Backend
+  jiradc component update 11289 --description "Server-side code"
+  jiradc component update 11289 --lead jsmith --assignee-type COMPONENT_LEAD`
+  ).action(
+    async (id, opts) => {
+      if (opts.name === void 0 && opts.description === void 0 && opts.lead === void 0 && opts.assigneeType === void 0) {
+        throw new Error("Provide at least one of --name, --description, --lead, --assignee-type");
+      }
+      const client = getClient();
+      const result = await client.components.update({
+        id,
+        name: opts.name,
+        description: opts.description,
+        leadUserName: opts.lead,
+        assigneeType: opts.assigneeType
+      });
+      output(transformComponent(result));
+    }
+  );
+}
+
+// src/commands/component/index.ts
+function registerComponentCommands(program2) {
+  const component = program2.command("component").description("Project component operations").addHelpText(
+    "after",
+    `
+Examples:
+  $ jiradc component list AI
+  $ jiradc component get 11289
+  $ jiradc component create --project AI --name Backend
+  $ jiradc component update 11289 --name Backend
+  $ jiradc component delete 11289 --move-issues-to 11290
+  $ jiradc component issue-count 11289
+`
+  );
+  list2(component);
+  get(component);
+  create(component);
+  update(component);
+  deleteComponent(component);
+  issueCount(component);
+}
+
 // src/commands/field/options.ts
 function options(parent) {
   parent.command("options <id>").description("Get available options for a custom field").option("--query <text>", "Filter options by text").option("--max <number>", "Max results to return (1-1000)", intInRange(1, 1e3), 25).option("--page <number>", "Page number (1-indexed)", positiveInt).addHelpText(
@@ -239,7 +574,7 @@ function options(parent) {
       maxResults: opts.max,
       page: opts.page
     });
-    output(result);
+    output(transformPaged({ ...result, startAt: result.startAt ?? 0 }, transformCustomFieldOption));
   });
 }
 
@@ -251,7 +586,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));
   });
 }
 
@@ -343,7 +678,7 @@ function download(parent) {
 }
 
 // src/commands/issue/attachment/list.ts
-function list2(parent) {
+function list3(parent) {
   parent.command("list <key>").description("List attachments on an issue").addHelpText("after", "\nExamples:\n  jiradc issue attachment list PROJ-123").action(async (key) => {
     const client = getClient();
     const issue = await client.issues.get({
@@ -406,7 +741,7 @@ Examples:
 `
   );
   upload(attachment);
-  list2(attachment);
+  list3(attachment);
   download(attachment);
   downloadAll(attachment);
   deleteAttachment(attachment);
@@ -489,7 +824,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" });
       }
@@ -550,12 +885,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 = [];
@@ -592,9 +927,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);
@@ -607,7 +942,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));
   });
 }
 
@@ -616,12 +951,12 @@ 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));
   });
 }
 
 // src/commands/issue/create.ts
-function create(parent) {
+function create2(parent) {
   parent.command("create").description("Create a new issue").requiredOption("--project <key>", "Project key or ID").requiredOption("--type <name>", "Issue type name (e.g., Task, Bug, Story)").requiredOption("--summary <text>", "Issue summary/title").option("--description <text>", "Issue description in wiki markup").option("--assignee <username>", "Assignee username").option("--reporter <username>", "Reporter username").option("--priority <name>", "Priority name (e.g., High, Medium, Low)").option("--labels <labels>", "Comma-separated labels").option("--components <names>", "Comma-separated component names").option("--fix-versions <versions>", "Comma-separated fix version names").option("--due-date <date>", "Due date in YYYY-MM-DD format").option("--parent <key>", "Parent issue key (for subtasks)").option("--custom-fields <json>", `Additional custom fields as JSON (e.g., '{"customfield_10100": "EPIC-1"}')`).addHelpText(
     "after",
     `
@@ -648,7 +983,7 @@ Examples:
         parent: opts.parent,
         customFields: opts.customFields ? JSON.parse(opts.customFields) : void 0
       });
-      output(result);
+      output(transformCreatedIssue(result));
     }
   );
 }
@@ -756,7 +1091,7 @@ function getWorklog(parent) {
       startAt: opts.startAt,
       maxResults: opts.max
     });
-    output(result);
+    output(transformPaged(result, transformWorklog));
   });
 }
 
@@ -777,7 +1112,7 @@ var DEFAULT_FIELDS = [
 ];
 
 // src/commands/issue/get.ts
-function get(parent) {
+function get2(parent) {
   parent.command("get <key>").description("Get issue details").option("--fields <fields>", "Comma-separated fields to return (defaults to essential fields)").option("--all-fields", "Return all fields instead of defaults").option("--expand <expand>", 'Expand options (e.g., "transitions", "changelog")').addHelpText(
     "after",
     "\nExamples:\n  jiradc issue get PROJ-123\n  jiradc issue get PROJ-123 --fields summary,status,assignee\n  jiradc issue get PROJ-123 --all-fields\n  jiradc issue get PROJ-123 --expand changelog,transitions"
@@ -789,7 +1124,7 @@ function get(parent) {
       fields,
       expand: opts.expand
     });
-    output(result);
+    output(transformIssue(result));
   });
 }
 
@@ -801,7 +1136,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)
+    });
   });
 }
 
@@ -810,7 +1149,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));
   });
 }
 
@@ -827,7 +1166,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)
+    });
   });
 }
 
@@ -845,7 +1189,7 @@ function search2(parent) {
       maxResults: opts.max,
       fields
     });
-    output(result);
+    output(transformPaged(result, transformIssue));
   });
 }
 
@@ -857,7 +1201,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) });
   });
 }
 
@@ -880,7 +1224,7 @@ function unlink2(parent) {
 }
 
 // src/commands/issue/update.ts
-function update(parent) {
+function update2(parent) {
   parent.command("update <key>").description("Update issue fields").option("--fields <json>", "JSON string of fields to update").option("--notify-users", "Notify users about the update (default: true)").option("--attachments <paths>", "Comma-separated local file paths to attach").addHelpText(
     "after",
     `
@@ -891,8 +1235,7 @@ Examples:
   jiradc issue update PROJ-123 --fields '{"summary": "With attachment"}' --attachments ./report.pdf`
   ).action(async (key, opts) => {
     if (!opts.fields && !opts.attachments) {
-      console.error(JSON.stringify({ error: "Provide --fields and/or --attachments" }));
-      process.exit(1);
+      throw new Error("Provide --fields and/or --attachments");
     }
     const client = getClient();
     if (opts.fields) {
@@ -909,7 +1252,11 @@ Examples:
         }
       }
     }
-    output({ updated: true, issueKey: key, ...uploaded.length > 0 && { attachments: uploaded } });
+    output({
+      updated: true,
+      issue: transformIssueRef(key),
+      ...uploaded.length > 0 && { attachments: uploaded }
+    });
   });
 }
 
@@ -926,7 +1273,7 @@ function worklog(parent) {
       comment: opts.comment,
       started: opts.started
     });
-    output(result);
+    output(transformWorklog(result));
   });
 }
 
@@ -944,10 +1291,10 @@ Examples:
   $ jiradc issue attachment list PROJ-123
 `
   );
-  get(issue);
+  get2(issue);
   search2(issue);
-  create(issue);
-  update(issue);
+  create2(issue);
+  update2(issue);
   deleteIssue(issue);
   transition(issue);
   transitions(issue);
@@ -968,24 +1315,15 @@ Examples:
   devStatus(issue);
 }
 
-// src/commands/project/components.ts
-function components(parent) {
-  parent.command("components <key>").description("Get all components for a project").addHelpText("after", "\nExamples:\n  jiradc project components PROJ").action(async (key) => {
-    const client = getClient();
-    const result = await client.projects.getComponents({ projectKeyOrId: key });
-    output(result);
-  });
-}
-
 // src/commands/project/list.ts
-function list3(parent) {
+function list4(parent) {
   parent.command("list").description("List all projects").option("--expand <expand>", 'Expand options (e.g., "description,lead")').option("--include-archived", "Include archived projects (default: false)").addHelpText(
     "after",
     "\nExamples:\n  jiradc project list\n  jiradc project list --expand description,lead\n  jiradc project list --include-archived"
   ).action(async (opts) => {
     const client = getClient();
     const result = await client.projects.getAll({ expand: opts.expand, includeArchived: opts.includeArchived });
-    output(result);
+    output(result.map(transformProject));
   });
 }
 
@@ -997,7 +1335,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));
   });
 }
 
@@ -1009,16 +1347,14 @@ function registerProjectCommands(program2) {
 Examples:
   $ jiradc project list
   $ jiradc project versions PROJ
-  $ jiradc project components PROJ
 `
   );
-  list3(project);
+  list4(project);
   versions(project);
-  components(project);
 }
 
 // src/commands/sprint/create.ts
-function create2(parent) {
+function create3(parent) {
   parent.command("create").description("Create a new sprint").requiredOption("--board <id>", "Board ID to create sprint in", positiveInt).requiredOption("--name <name>", "Sprint name").option("--start-date <date>", "Start date in ISO 8601 format").option("--end-date <date>", "End date in ISO 8601 format").option("--goal <goal>", "Sprint goal").addHelpText(
     "after",
     '\nExamples:\n  jiradc sprint create --board 42 --name "Sprint 10"\n  jiradc sprint create --board 42 --name "Sprint 10" --start-date 2026-03-20 --end-date 2026-04-03 --goal "Complete auth module"'
@@ -1031,7 +1367,7 @@ function create2(parent) {
       endDate: opts.endDate,
       goal: opts.goal
     });
-    output(result);
+    output(transformSprint(result));
   });
 }
 
@@ -1050,15 +1386,15 @@ function issues2(parent) {
       fields: opts.fields?.split(",").map((f) => f.trim()),
       jql: opts.jql
     });
-    output(result);
+    output(transformPaged(result, transformIssue));
   });
 }
 
 // src/commands/sprint/list.ts
-import { Option as Option2 } from "commander";
+import { Option as Option4 } from "commander";
 var SPRINT_STATES = ["future", "active", "closed"];
-function list4(parent) {
-  parent.command("list").description("List sprints for a board").requiredOption("--board <id>", "Board ID", positiveInt).addOption(new Option2("--state <state>", "Filter by sprint state").choices(SPRINT_STATES)).addHelpText(
+function list5(parent) {
+  parent.command("list").description("List sprints for a board").requiredOption("--board <id>", "Board ID", positiveInt).addOption(new Option4("--state <state>", "Filter by sprint state").choices(SPRINT_STATES)).addHelpText(
     "after",
     "\nExamples:\n  jiradc sprint list --board 42\n  jiradc sprint list --board 42 --state active"
   ).action(async (opts) => {
@@ -1067,15 +1403,15 @@ function list4(parent) {
       boardId: opts.board,
       state: opts.state
     });
-    output(result);
+    output(result.map(transformSprint));
   });
 }
 
 // src/commands/sprint/update.ts
-import { Argument as Argument3, Option as Option3 } from "commander";
+import { Argument as Argument3, Option as Option5 } from "commander";
 var SPRINT_STATES2 = ["future", "active", "closed"];
-function update2(parent) {
-  parent.command("update").description("Update an existing sprint").addArgument(new Argument3("<id>", "Sprint ID").argParser(positiveInt)).option("--name <name>", "New sprint name").addOption(new Option3("--state <state>", "New sprint state").choices(SPRINT_STATES2)).option("--start-date <date>", "New start date in ISO 8601 format").option("--end-date <date>", "New end date in ISO 8601 format").option("--goal <goal>", "New sprint goal").addHelpText(
+function update3(parent) {
+  parent.command("update").description("Update an existing sprint").addArgument(new Argument3("<id>", "Sprint ID").argParser(positiveInt)).option("--name <name>", "New sprint name").addOption(new Option5("--state <state>", "New sprint state").choices(SPRINT_STATES2)).option("--start-date <date>", "New start date in ISO 8601 format").option("--end-date <date>", "New end date in ISO 8601 format").option("--goal <goal>", "New sprint goal").addHelpText(
     "after",
     '\nExamples:\n  jiradc sprint update 100 --name "Sprint 10 - Extended"\n  jiradc sprint update 100 --state active\n  jiradc sprint update 100 --end-date 2026-04-10 --goal "Updated goal"'
   ).action(
@@ -1089,7 +1425,7 @@ function update2(parent) {
         endDate: opts.endDate,
         goal: opts.goal
       });
-      output(result);
+      output(transformSprint(result));
     }
   );
 }
@@ -1106,10 +1442,10 @@ Examples:
   $ jiradc sprint create --board 42 --name "Sprint 10" --start-date 2026-04-01 --end-date 2026-04-14
 `
   );
-  list4(sprint);
+  list5(sprint);
   issues2(sprint);
-  create2(sprint);
-  update2(sprint);
+  create3(sprint);
+  update3(sprint);
 }
 
 // src/commands/user/me.ts
@@ -1147,7 +1483,7 @@ function readPackageVersion() {
 }
 var DIM = "\x1B[2m";
 var RESET = "\x1B[0m";
-var program = new Command6();
+var program = new Command8();
 program.name("jiradc").description("Jira Data Center CLI").version(readPackageVersion()).configureHelp({
   styleTitle: (str) => styleText("bold", str),
   styleUsage: (str) => styleText("dim", str),
@@ -1179,6 +1515,7 @@ program.hook("preAction", (thisCommand) => {
 });
 registerIssueCommands(program);
 registerProjectCommands(program);
+registerComponentCommands(program);
 registerBoardCommands(program);
 registerSprintCommands(program);
 registerFieldCommands(program);

package/package.json

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