jiradc-cli 1.0.17 → 1.0.18-g1be46a3.1

package/README.md

@@ -15,6 +15,12 @@ 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
 ```
 
+## Breaking changes in this release
+
+- `issue transitions` now returns a bare JSON array of transitions (previously wrapped in `{ transitions: [...] }`). Each transition is reduced to `{ id, name, to, fields? }` — verbose fields like `to.iconUrl`, `to.statusCategory`, `isGlobal`, `isInitial`, `isConditional`, `hasScreen` are stripped.
+- `component list` now requires `--project <key>` instead of a positional `<projectKey>` argument.
+- `issue link-epic` is now variadic on the issue argument: `link-epic <issueKey...> --epic <epicKey>`. Single-issue calls keep working.
+
 ## Commands
 
 All commands output JSON. Add `--pretty` to pretty-print.
@@ -26,16 +32,17 @@ All commands output JSON. Add `--pretty` to pretty-print.
 | `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 update <key>` | Update an issue (`--summary`, `--description`, `--priority`, `--assignee`, `--labels`, `--components`, `--fix-versions`, or `--fields` JSON) |
 | `jiradc issue delete <key>` | Delete an issue |
-| `jiradc issue transition <key> <transitionId>` | Transition issue to a new status |
+| `jiradc issue assign <key> <user>` | Assign issue (user can be a username, `me`, or `none` to unassign) |
+| `jiradc issue transition <key>` | Transition issue to a new status (`--to` accepts ID or status name, `--comment` to add a note) |
 | `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 link-epic <keys...>` | Link one or more issues to an epic (`--epic <epicKey>`) |
 | `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 |
@@ -60,7 +67,16 @@ All commands output JSON. Add `--pretty` to pretty-print.
 |---------|-------------|
 | `jiradc project list` | List projects |
 | `jiradc project versions <key>` | List versions for a project |
-| `jiradc project components <key>` | List components for a project |
+
+### component
+
+| Command | Description |
+|---------|-------------|
+| `jiradc component list` | List components for a project (`--project <key>`) |
+| `jiradc component get <id>` | Get a component by ID |
+| `jiradc component create` | Create a component (`--project`, `--name`, `--description`, `--lead`) |
+| `jiradc component update <id>` | Update a component |
+| `jiradc component issue-count <id>` | Get the number of issues using a component |
 
 ### board
 
@@ -93,7 +109,7 @@ All commands output JSON. Add `--pretty` to pretty-print.
 
 ## 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.
+Search and list commands accept `--limit` to control page size (Jira DC caps at 50 for agile endpoints). Responses include `nextPage` — pass it back as `--start` to fetch the next page. When `nextPage` is `null`, there are no more results.
 
 ## Examples
 
@@ -113,9 +129,26 @@ jiradc issue create --project AI --type Task --summary "Implement feature X" --d
 # 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)
+# Transition by ID or by status name
 jiradc issue transitions AI-123
-jiradc issue transition AI-123 31
+jiradc issue transition AI-123 --to 31
+jiradc issue transition AI-123 --to "In Review" --comment "Ready for review"
+
+# Assign
+jiradc issue assign AI-123 me
+jiradc issue assign AI-123 jsmith
+jiradc issue assign AI-123 none
+
+# Update with shortcuts (instead of --fields JSON)
+jiradc issue update AI-123 --summary "New title" --priority High
+jiradc issue update AI-123 --assignee me
+jiradc issue update AI-123 --labels backend,urgent           # set mode
+jiradc issue update AI-123 --labels +urgent,-backend          # mutate mode
+jiradc issue update AI-123 --components +Frontend
+jiradc issue update AI-123 --fix-versions 1.0,2.0
+
+# Link multiple issues to an epic in one call
+jiradc issue link-epic AI-456 AI-457 AI-458 --epic AI-100
 
 # Add a comment
 jiradc issue comment AI-123 --body "Fixed in commit abc123"
@@ -140,4 +173,7 @@ jiradc issue clone AI-123
 
 # Get dev status (linked branches, PRs)
 jiradc issue dev-status AI-123
+
+# List components for a project
+jiradc component list --project AI
 ```

package/dist/index.js

@@ -432,17 +432,60 @@ function transformIssueFields(fields) {
   };
 }
 
+// src/utils/transformers/transition.ts
+function slimAllowedValue(raw) {
+  if (!raw || typeof raw !== "object") return {};
+  const av = raw;
+  const slim = {};
+  if (typeof av.id === "string") slim.id = av.id;
+  if (typeof av.name === "string") slim.name = av.name;
+  if (typeof av.value === "string") slim.value = av.value;
+  return slim;
+}
+function slimField(raw) {
+  if (!raw || typeof raw !== "object") return {};
+  const field = raw;
+  const out = {};
+  if (typeof field.required === "boolean") out.required = field.required;
+  if (typeof field.name === "string") out.name = field.name;
+  if (Array.isArray(field.allowedValues)) {
+    out.allowedValues = field.allowedValues.map(slimAllowedValue);
+  }
+  return out;
+}
+function slimFields(fields) {
+  const out = {};
+  for (const [key, raw] of Object.entries(fields)) {
+    out[key] = slimField(raw);
+  }
+  return out;
+}
+function transformTransition(t) {
+  const out = {
+    id: t.id,
+    name: t.name,
+    to: t.to.name
+  };
+  if (t.fields && Object.keys(t.fields).length > 0) {
+    out.fields = slimFields(t.fields);
+  }
+  return out;
+}
+function transformTransitions(response) {
+  return response.transitions.map(transformTransition);
+}
+
 // 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(
+  parent.command("issues").description("Get issues for a board").addArgument(new Argument("<id>", "Board ID").argParser(positiveInt)).option("--limit <number>", "Max results (1-50, Jira DC caps at 50)", intInRange(1, 50), 25).option("--start <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(
     "after",
-    '\nExamples:\n  jiradc board issues 42\n  jiradc board issues 42 --max 10\n  jiradc board issues 42 --jql "status = Open" --fields summary,status\n  jiradc board issues 42 --start-at 50 --max 25'
+    '\nExamples:\n  jiradc board issues 42\n  jiradc board issues 42 --limit 10\n  jiradc board issues 42 --jql "status = Open" --fields summary,status\n  jiradc board issues 42 --start 50 --limit 25'
   ).action(async (id, opts) => {
     const client = getClient();
     const result = await client.agile.getBoardIssues({
       boardId: id,
-      startAt: opts.startAt,
-      maxResults: opts.max,
+      startAt: opts.start,
+      maxResults: opts.limit,
       fields: opts.fields?.split(",").map((f) => f.trim()),
       jql: opts.jql
     });
@@ -454,13 +497,13 @@ function issues(parent) {
 import { Option } from "commander";
 var BOARD_TYPES = ["scrum", "kanban", "simple"];
 function list(parent) {
-  parent.command("list").description("List agile boards").option("--max <number>", "Max results (1-1000)", intInRange(1, 1e3), 25).option("--project <key>", "Filter boards by project key or ID").addOption(new Option("--type <type>", "Board type filter").choices(BOARD_TYPES)).option("--name <name>", "Filter boards by name").addHelpText(
+  parent.command("list").description("List agile boards").option("--limit <number>", "Max results (1-1000)", intInRange(1, 1e3), 25).option("--project <key>", "Filter boards by project key or ID").addOption(new Option("--type <type>", "Board type filter").choices(BOARD_TYPES)).option("--name <name>", "Filter boards by name").addHelpText(
     "after",
-    '\nExamples:\n  jiradc board list\n  jiradc board list --max 10\n  jiradc board list --project PROJ\n  jiradc board list --type scrum --name "Team Board"'
+    '\nExamples:\n  jiradc board list\n  jiradc board list --limit 10\n  jiradc board list --project PROJ\n  jiradc board list --type scrum --name "Team Board"'
   ).action(async (opts) => {
     const client = getClient();
     const result = await client.agile.getBoards({
-      maxResults: opts.max,
+      maxResults: opts.limit,
       projectKeyOrId: opts.project,
       type: opts.type,
       name: opts.name
@@ -477,7 +520,7 @@ function registerBoardCommands(program2) {
 Examples:
   $ jiradc board list
   $ jiradc board list --type scrum --project PROJ
-  $ jiradc board issues 42 --max 20
+  $ jiradc board issues 42 --limit 20
 `
   );
   list(board);
@@ -550,9 +593,9 @@ function issueCount(parent) {
 
 // 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) => {
+  parent.command("list").description("List all components for a project").requiredOption("--project <key>", "Project key (e.g., AI)").addHelpText("after", "\nExamples:\n  jiradc component list --project AI").action(async (opts) => {
     const client = getClient();
-    const result = await client.components.list({ projectKeyOrId: projectKey });
+    const result = await client.components.list({ projectKeyOrId: opts.project });
     output(result.map(transformComponent));
   });
 }
@@ -597,7 +640,7 @@ function registerComponentCommands(program2) {
     "after",
     `
 Examples:
-  $ jiradc component list AI
+  $ jiradc component list --project AI
   $ jiradc component get 11289
   $ jiradc component create --project AI --name Backend
   $ jiradc component update 11289 --name Backend
@@ -615,15 +658,15 @@ Examples:
 
 // 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(
+  parent.command("options <id>").description("Get available options for a custom field").option("--query <text>", "Filter options by text").option("--limit <number>", "Max results to return (1-1000)", intInRange(1, 1e3), 25).option("--page <number>", "Page number (1-indexed)", positiveInt).addHelpText(
     "after",
-    '\nExamples:\n  jiradc field options 10001\n  jiradc field options 10001 --query "High"\n  jiradc field options 10001 --max 20 --page 2'
+    '\nExamples:\n  jiradc field options 10001\n  jiradc field options 10001 --query "High"\n  jiradc field options 10001 --limit 20 --page 2'
   ).action(async (id, opts) => {
     const client = getClient();
     const result = await client.fields.getFieldOptions({
       fieldId: id,
       query: opts.query,
-      maxResults: opts.max,
+      maxResults: opts.limit,
       page: opts.page
     });
     output(transformPaged({ ...result, startAt: result.startAt ?? 0 }, transformCustomFieldOption));
@@ -657,6 +700,42 @@ Examples:
   options(field);
 }
 
+// src/utils/resolve-user.ts
+var cachedMe;
+async function resolveUserToken(token) {
+  if (token === "none") return null;
+  if (token === "me") {
+    if (cachedMe !== void 0) return cachedMe;
+    const me2 = await getClient().users.getMyself();
+    if (!me2.name) {
+      throw new Error('Could not resolve "me": authenticated user has no name field');
+    }
+    cachedMe = me2.name;
+    return cachedMe;
+  }
+  return token;
+}
+
+// src/commands/issue/assign.ts
+function assign(parent) {
+  parent.command("assign <key> <user>").description('Assign an issue. <user> is a username, "me", or "none" to unassign.').addHelpText(
+    "after",
+    `
+Examples:
+  jiradc issue assign PROJ-123 jsmith
+  jiradc issue assign PROJ-123 me
+  jiradc issue assign PROJ-123 none`
+  ).action(async (key, user) => {
+    const resolved = await resolveUserToken(user);
+    const client = getClient();
+    await client.issues.update({
+      issueKeyOrId: key,
+      fields: { assignee: resolved === null ? null : { name: resolved } }
+    });
+    output({ assigned: true, issue: transformIssueRef(key), assignee: resolved });
+  });
+}
+
 // src/commands/issue/attachment/delete.ts
 function deleteAttachment(parent) {
   parent.command("delete").description("Delete an attachment by ID").requiredOption("--id <attachmentId>", "Attachment ID to delete").addHelpText("after", "\nExamples:\n  jiradc issue attachment delete --id 12345").action(async (opts) => {
@@ -842,16 +921,16 @@ function attachments(parent) {
 
 // src/commands/issue/batch-changelog.ts
 function batchChangelog(parent) {
-  parent.command("batch-changelog <keys>").description("Get changelogs for multiple issues at once").option("--max <number>", "Max changelog entries per issue (1-50, Jira DC caps at 50)", intInRange(1, 50), 25).addHelpText(
+  parent.command("batch-changelog <keys>").description("Get changelogs for multiple issues at once").option("--limit <number>", "Max changelog entries per issue (1-50, Jira DC caps at 50)", intInRange(1, 50), 25).addHelpText(
     "after",
-    "\nExamples:\n  jiradc issue batch-changelog PROJ-1,PROJ-2,PROJ-3\n  jiradc issue batch-changelog PROJ-123,PROJ-124 --max 10"
+    "\nExamples:\n  jiradc issue batch-changelog PROJ-1,PROJ-2,PROJ-3\n  jiradc issue batch-changelog PROJ-123,PROJ-124 --limit 10"
   ).action(async (keys, opts) => {
     const client = getClient();
     const keyList = keys.split(",").map((k) => k.trim());
     const entries = await Promise.all(
       keyList.map(async (key) => {
         try {
-          const data = await client.issues.getChangelog({ issueKeyOrId: key, maxResults: opts.max });
+          const data = await client.issues.getChangelog({ issueKeyOrId: key, maxResults: opts.limit });
           return [key, data];
         } catch (error) {
           return [key, { error: error instanceof Error ? error.message : "Unknown error" }];
@@ -887,9 +966,12 @@ Examples:
 
 // src/commands/issue/changelog.ts
 function changelog(parent) {
-  parent.command("changelog <key>").description("Get changelog for an issue").option("--max <number>", "Max changelog entries (1-50, Jira DC caps at 50)", intInRange(1, 50), 25).addHelpText("after", "\nExamples:\n  jiradc issue changelog PROJ-123\n  jiradc issue changelog PROJ-123 --max 10").action(async (key, opts) => {
+  parent.command("changelog <key>").description("Get changelog for an issue").option("--limit <number>", "Max changelog entries (1-50, Jira DC caps at 50)", intInRange(1, 50), 25).addHelpText(
+    "after",
+    "\nExamples:\n  jiradc issue changelog PROJ-123\n  jiradc issue changelog PROJ-123 --limit 10"
+  ).action(async (key, opts) => {
     const client = getClient();
-    const result = await client.issues.getChangelog({ issueKeyOrId: key, maxResults: opts.max });
+    const result = await client.issues.getChangelog({ issueKeyOrId: key, maxResults: opts.limit });
     output(result);
   });
 }
@@ -1133,15 +1215,15 @@ function devStatus(parent) {
 
 // src/commands/issue/get-worklog.ts
 function getWorklog(parent) {
-  parent.command("get-worklog <key>").description("Get worklogs for an issue").option("--start-at <number>", "Starting index for pagination", nonNegativeInt).option("--max <number>", "Max results per page (1-1000)", intInRange(1, 1e3), 25).addHelpText(
+  parent.command("get-worklog <key>").description("Get worklogs for an issue").option("--start <number>", "Starting index for pagination", nonNegativeInt).option("--limit <number>", "Max results per page (1-1000)", intInRange(1, 1e3), 25).addHelpText(
     "after",
-    "\nExamples:\n  jiradc issue get-worklog PROJ-123\n  jiradc issue get-worklog PROJ-123 --max 10\n  jiradc issue get-worklog PROJ-123 --start-at 10 --max 5"
+    "\nExamples:\n  jiradc issue get-worklog PROJ-123\n  jiradc issue get-worklog PROJ-123 --limit 10\n  jiradc issue get-worklog PROJ-123 --start 10 --limit 5"
   ).action(async (key, opts) => {
     const client = getClient();
     const result = await client.issues.getWorklogs({
       issueKeyOrId: key,
-      startAt: opts.startAt,
-      maxResults: opts.max
+      startAt: opts.start,
+      maxResults: opts.limit
     });
     output(transformPaged(result, transformWorklog));
   });
@@ -1182,17 +1264,37 @@ function get2(parent) {
 
 // src/commands/issue/link-epic.ts
 function linkEpic(parent) {
-  parent.command("link-epic <key>").description("Link an issue to an epic").requiredOption("--epic <epicKey>", "Epic issue key").addHelpText("after", "\nExamples:\n  jiradc issue link-epic PROJ-456 --epic PROJ-123").action(async (key, opts) => {
+  parent.command("link-epic <keys...>").description("Link one or more issues to an epic").requiredOption("--epic <epicKey>", "Epic issue key").addHelpText(
+    "after",
+    `
+Examples:
+  jiradc issue link-epic PROJ-456 --epic PROJ-123
+  jiradc issue link-epic PROJ-456 PROJ-457 PROJ-458 --epic PROJ-123`
+  ).action(async (keys, opts) => {
     const client = getClient();
-    await client.issues.update({
-      issueKeyOrId: key,
-      fields: { customfield_10100: opts.epic }
+    const results = await Promise.allSettled(
+      keys.map(
+        (key) => client.issues.update({ issueKeyOrId: key, fields: { customfield_10100: opts.epic } }).then(() => key)
+      )
+    );
+    const linked = [];
+    const failed = [];
+    results.forEach((r, i) => {
+      if (r.status === "fulfilled") {
+        linked.push({ key: r.value });
+      } else {
+        const message = r.reason instanceof Error ? r.reason.message : String(r.reason);
+        failed.push({ key: keys[i], error: message });
+      }
     });
     output({
-      linked: true,
-      issue: transformIssueRef(key),
-      epic: transformIssueRef(opts.epic)
+      epic: transformIssueRef(opts.epic),
+      linked,
+      ...failed.length > 0 && { failed }
     });
+    if (failed.length > 0) {
+      process.exitCode = 1;
+    }
   });
 }
 
@@ -1229,16 +1331,16 @@ function link(parent) {
 
 // src/commands/issue/search.ts
 function search2(parent) {
-  parent.command("search <jql>").description("Search issues using JQL").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 fields to return (defaults to essential fields)").option("--all-fields", "Return all fields instead of defaults").addHelpText(
+  parent.command("search <jql>").description("Search issues using JQL").option("--limit <number>", "Max results (1-50, Jira DC caps at 50)", intInRange(1, 50), 25).option("--start <number>", "Starting index for pagination", nonNegativeInt).option("--fields <fields>", "Comma-separated fields to return (defaults to essential fields)").option("--all-fields", "Return all fields instead of defaults").addHelpText(
     "after",
-    '\nExamples:\n  jiradc issue search "project = PROJ AND status = Open"\n  jiradc issue search "assignee = currentUser()" --max 10 --fields summary,status\n  jiradc issue search "project = PROJ" --start-at 50 --max 50'
+    '\nExamples:\n  jiradc issue search "project = PROJ AND status = Open"\n  jiradc issue search "assignee = currentUser()" --limit 10 --fields summary,status\n  jiradc issue search "project = PROJ" --start 50 --limit 50'
   ).action(async (jql, opts) => {
     const client = getClient();
     const fields = opts.allFields ? void 0 : opts.fields?.split(",").map((f) => f.trim()) ?? DEFAULT_FIELDS;
     const result = await client.issues.search({
       jql,
-      startAt: opts.startAt,
-      maxResults: opts.max,
+      startAt: opts.start,
+      maxResults: opts.limit,
       fields
     });
     output(transformPaged(result, transformIssue));
@@ -1247,12 +1349,37 @@ function search2(parent) {
 
 // src/commands/issue/transition.ts
 function transition(parent) {
-  parent.command("transition <key>").description("Transition issue to a new status").requiredOption("--to <id>", 'Transition ID (get from "jiradc issue transitions")').option("--comment <text>", "Comment to add during transition").addHelpText(
+  parent.command("transition <key>").description("Transition issue to a new status").requiredOption("--to <idOrName>", "Transition ID, or status name (case-insensitive)").option("--comment <text>", "Comment to add during transition").addHelpText(
     "after",
-    '\nExamples:\n  jiradc issue transition PROJ-123 --to 31\n  jiradc issue transition PROJ-123 --to 31 --comment "Moving to review"'
+    `
+Examples:
+  jiradc issue transition PROJ-123 --to 31
+  jiradc issue transition PROJ-123 --to "In Review"
+  jiradc issue transition PROJ-123 --to Done --comment "Verified in staging"`
   ).action(async (key, opts) => {
     const client = getClient();
-    await client.issues.transition({ issueKeyOrId: key, transitionId: opts.to, comment: opts.comment });
+    let transitionId;
+    if (/^\d+$/.test(opts.to)) {
+      transitionId = opts.to;
+    } else {
+      const raw = await client.issues.getTransitions({
+        issueKeyOrId: key,
+        expand: "transitions.fields"
+      });
+      const transitions2 = transformTransitions(raw);
+      const target = opts.to.toLowerCase();
+      const matches = transitions2.filter((t) => t.name.toLowerCase() === target);
+      if (matches.length === 0) {
+        const names = transitions2.map((t) => `"${t.name}"`).join(", ");
+        throw new Error(`Transition "${opts.to}" not available from current status. Available: ${names || "(none)"}`);
+      }
+      if (matches.length > 1) {
+        const ids = matches.map((t) => t.id).join(", ");
+        throw new Error(`Multiple transitions named "${opts.to}". Use --to <id> with one of: ${ids}`);
+      }
+      transitionId = matches[0].id;
+    }
+    await client.issues.transition({ issueKeyOrId: key, transitionId, comment: opts.comment });
     output({ transitioned: true, issue: transformIssueRef(key) });
   });
 }
@@ -1261,8 +1388,11 @@ function transition(parent) {
 function transitions(parent) {
   parent.command("transitions <key>").description("Get available transitions for an issue").addHelpText("after", "\nExamples:\n  jiradc issue transitions PROJ-123").action(async (key) => {
     const client = getClient();
-    const result = await client.issues.getTransitions({ issueKeyOrId: key });
-    output(result);
+    const result = await client.issues.getTransitions({
+      issueKeyOrId: key,
+      expand: "transitions.fields"
+    });
+    output(transformTransitions(result));
   });
 }
 
@@ -1275,24 +1405,103 @@ function unlink2(parent) {
   });
 }
 
+// src/utils/multi-value.ts
+import { InvalidArgumentError as InvalidArgumentError2 } from "commander";
+function parseMultiValue(flagName, raw) {
+  const items = raw.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  if (items.length === 0) {
+    throw new InvalidArgumentError2(`${flagName} cannot be empty`);
+  }
+  const lonePrefix = items.find((s) => s === "+" || s === "-");
+  if (lonePrefix !== void 0) {
+    throw new InvalidArgumentError2(`${flagName} has an empty value after '${lonePrefix}' prefix`);
+  }
+  const prefixed = items.filter((s) => s.startsWith("+") || s.startsWith("-"));
+  const bare = items.filter((s) => !s.startsWith("+") && !s.startsWith("-"));
+  if (prefixed.length > 0 && bare.length > 0) {
+    throw new InvalidArgumentError2(
+      `${flagName} mixes set and mutate syntax. Either all values have +/- prefix, or none do.`
+    );
+  }
+  if (bare.length > 0) {
+    return { mode: "set", values: bare };
+  }
+  const adds = prefixed.filter((s) => s.startsWith("+")).map((s) => s.slice(1));
+  const removes = prefixed.filter((s) => s.startsWith("-")).map((s) => s.slice(1));
+  return { mode: "mutate", adds, removes };
+}
+
 // src/commands/issue/update.ts
+function buildUpdateOps(parsed, wrap) {
+  if (parsed.mode !== "mutate") return void 0;
+  return [...parsed.adds.map((v) => ({ add: wrap(v) })), ...parsed.removes.map((v) => ({ remove: wrap(v) }))];
+}
+function buildSetValue(parsed, wrap) {
+  if (parsed.mode !== "set") return void 0;
+  return parsed.values.map(wrap);
+}
 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(
+  parent.command("update <key>").description("Update issue fields").option("--fields <json>", "JSON string of fields to update (advanced; merges with shortcuts, wins on conflict)").option("--no-notify-users", "Suppress notification emails (default: notify)").option("--attachments <paths>", "Comma-separated local file paths to attach").option("--summary <text>", "Set the issue summary").option("--description <text>", "Set the issue description (wiki markup)").option("--priority <name>", "Set the priority by name (e.g. High)").option("--assignee <user>", 'Set the assignee. Username, "me", or "none" to unassign.').option("--labels <list>", 'Set labels ("a,b,c") or mutate ("+add,-remove")').option("--components <list>", 'Set components ("a,b") or mutate ("+add,-remove")').option("--fix-versions <list>", 'Set fix versions ("1.0,2.0") or mutate ("+1.0,-0.9")').addHelpText(
     "after",
     `
 Examples:
-  jiradc issue update PROJ-123 --fields '{"summary": "New title"}'
-  jiradc issue update PROJ-123 --fields '{"assignee": {"name": "jsmith"}, "priority": {"name": "High"}}'
-  jiradc issue update PROJ-123 --attachments /path/to/file.pdf,/path/to/image.png
-  jiradc issue update PROJ-123 --fields '{"summary": "With attachment"}' --attachments ./report.pdf`
+  jiradc issue update PROJ-123 --summary "New title"
+  jiradc issue update PROJ-123 --priority High --assignee me
+  jiradc issue update PROJ-123 --labels backend,urgent
+  jiradc issue update PROJ-123 --labels +urgent,-backend
+  jiradc issue update PROJ-123 --components +Frontend
+  jiradc issue update PROJ-123 --fields '{"customfield_10100": "EPIC-1"}' --priority High
+  jiradc issue update PROJ-123 --attachments /path/to/file.pdf,/path/to/image.png`
   ).action(async (key, opts) => {
-    if (!opts.fields && !opts.attachments) {
-      throw new Error("Provide --fields and/or --attachments");
+    const hasShortcut = opts.summary !== void 0 || opts.description !== void 0 || opts.priority !== void 0 || opts.assignee !== void 0 || opts.labels !== void 0 || opts.components !== void 0 || opts.fixVersions !== void 0;
+    if (!opts.fields && !opts.attachments && !hasShortcut) {
+      throw new Error(
+        "Provide at least one of --fields, --attachments, or a shortcut flag (--summary, --priority, --labels, ...)"
+      );
+    }
+    const fields = {};
+    const updateOps = {};
+    if (opts.summary !== void 0) fields.summary = opts.summary;
+    if (opts.description !== void 0) fields.description = opts.description;
+    if (opts.priority !== void 0) fields.priority = { name: opts.priority };
+    if (opts.assignee !== void 0) {
+      const resolved = await resolveUserToken(opts.assignee);
+      fields.assignee = resolved === null ? null : { name: resolved };
+    }
+    if (opts.labels !== void 0) {
+      const parsed = parseMultiValue("--labels", opts.labels);
+      const setVal = buildSetValue(parsed, (v) => v);
+      const ops = buildUpdateOps(parsed, (v) => v);
+      if (setVal) fields.labels = setVal;
+      if (ops) updateOps.labels = ops;
+    }
+    if (opts.components !== void 0) {
+      const parsed = parseMultiValue("--components", opts.components);
+      const setVal = buildSetValue(parsed, (v) => ({ name: v }));
+      const ops = buildUpdateOps(parsed, (v) => ({ name: v }));
+      if (setVal) fields.components = setVal;
+      if (ops) updateOps.components = ops;
+    }
+    if (opts.fixVersions !== void 0) {
+      const parsed = parseMultiValue("--fix-versions", opts.fixVersions);
+      const setVal = buildSetValue(parsed, (v) => ({ name: v }));
+      const ops = buildUpdateOps(parsed, (v) => ({ name: v }));
+      if (setVal) fields.fixVersions = setVal;
+      if (ops) updateOps.fixVersions = ops;
     }
-    const client = getClient();
     if (opts.fields) {
-      const parsed = JSON.parse(opts.fields);
-      await client.issues.update({ issueKeyOrId: key, fields: parsed, notifyUsers: opts.notifyUsers });
+      const parsedFields = JSON.parse(opts.fields);
+      Object.assign(fields, parsedFields);
+    }
+    const client = getClient();
+    const didFieldUpdate = Object.keys(fields).length > 0 || Object.keys(updateOps).length > 0;
+    if (didFieldUpdate) {
+      await client.issues.update({
+        issueKeyOrId: key,
+        fields: Object.keys(fields).length > 0 ? fields : void 0,
+        update: Object.keys(updateOps).length > 0 ? updateOps : void 0,
+        notifyUsers: opts.notifyUsers
+      });
     }
     const uploaded = [];
     if (opts.attachments) {
@@ -1305,9 +1514,9 @@ Examples:
       }
     }
     output({
-      updated: true,
-      issue: transformIssueRef(key),
-      ...uploaded.length > 0 && { attachments: uploaded }
+      ...didFieldUpdate && { updated: true },
+      ...uploaded.length > 0 && { attached: true, attachments: uploaded },
+      issue: transformIssueRef(key)
     });
   });
 }
@@ -1336,7 +1545,7 @@ function registerIssueCommands(program2) {
     `
 Examples:
   $ jiradc issue get PROJ-123
-  $ jiradc issue search "project = PROJ AND status = Open" --max 10
+  $ jiradc issue search "project = PROJ AND status = Open" --limit 10
   $ jiradc issue create --project PROJ --type Task --summary "Fix the bug" --priority High
   $ jiradc issue update PROJ-123 --fields '{"summary": "New title"}'
   $ jiradc issue transition PROJ-123 --to 11
@@ -1350,6 +1559,7 @@ Examples:
   deleteIssue(issue);
   transition(issue);
   transitions(issue);
+  assign(issue);
   comment(issue);
   commentEdit(issue);
   worklog(issue);
@@ -1426,15 +1636,15 @@ function create3(parent) {
 // src/commands/sprint/issues.ts
 import { Argument as Argument2 } from "commander";
 function issues2(parent) {
-  parent.command("issues").description("Get issues in a sprint").addArgument(new Argument2("<id>", "Sprint 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 sprint").addHelpText(
+  parent.command("issues").description("Get issues in a sprint").addArgument(new Argument2("<id>", "Sprint ID").argParser(positiveInt)).option("--limit <number>", "Max results (1-50, Jira DC caps at 50)", intInRange(1, 50), 25).option("--start <number>", "Starting index for pagination", nonNegativeInt).option("--fields <fields>", "Comma-separated field names to return").option("--jql <jql>", "Additional JQL filter within the sprint").addHelpText(
     "after",
-    '\nExamples:\n  jiradc sprint issues 100\n  jiradc sprint issues 100 --max 20\n  jiradc sprint issues 100 --jql "status = Done" --fields summary,status\n  jiradc sprint issues 100 --start-at 50 --max 25'
+    '\nExamples:\n  jiradc sprint issues 100\n  jiradc sprint issues 100 --limit 20\n  jiradc sprint issues 100 --jql "status = Done" --fields summary,status\n  jiradc sprint issues 100 --start 50 --limit 25'
   ).action(async (id, opts) => {
     const client = getClient();
     const result = await client.agile.getSprintIssues({
       sprintId: id,
-      startAt: opts.startAt,
-      maxResults: opts.max,
+      startAt: opts.start,
+      maxResults: opts.limit,
       fields: opts.fields?.split(",").map((f) => f.trim()),
       jql: opts.jql
     });
@@ -1490,7 +1700,7 @@ function registerSprintCommands(program2) {
 Examples:
   $ jiradc sprint list --board 42
   $ jiradc sprint list --board 42 --state active
-  $ jiradc sprint issues 123 --max 20
+  $ jiradc sprint issues 123 --limit 20
   $ jiradc sprint create --board 42 --name "Sprint 10" --start-date 2026-04-01 --end-date 2026-04-14
 `
   );
@@ -1625,15 +1835,15 @@ function me(parent) {
 
 // src/commands/user/search.ts
 function search3(parent) {
-  parent.command("search <query>").description("Search users by partial username, display name or email").option("--max <n>", "Maximum results (1-50)", intInRange(1, 50), 25).option("--start <n>", "Starting index (pagination offset)", nonNegativeInt, 0).option("--include-inactive", "Include inactive users in results", false).addHelpText(
+  parent.command("search <query>").description("Search users by partial username, display name or email").option("--limit <n>", "Maximum results (1-50)", intInRange(1, 50), 25).option("--start <n>", "Starting index (pagination offset)", nonNegativeInt, 0).option("--include-inactive", "Include inactive users in results", false).addHelpText(
     "after",
-    '\nExamples:\n  jiradc user search Drago\n  jiradc user search "John Smith"\n  jiradc user search dragomir@first.bet --max 5'
+    '\nExamples:\n  jiradc user search Drago\n  jiradc user search "John Smith"\n  jiradc user search dragomir@first.bet --limit 5'
   ).action(async (query, opts) => {
     const client = getClient();
     const result = await client.users.searchUsers({
       username: query,
       startAt: opts.start,
-      maxResults: opts.max,
+      maxResults: opts.limit,
       includeActive: true,
       includeInactive: opts.includeInactive
     });
@@ -1688,7 +1898,7 @@ ${styleText("bold", "Environment:")}
 
 ${styleText("bold", "Examples:")}
   ${DIM}$${RESET} jiradc user me
-  ${DIM}$${RESET} jiradc issue search "project = PROJ AND status = Open" --max 10
+  ${DIM}$${RESET} jiradc issue search "project = PROJ AND status = Open" --limit 10
   ${DIM}$${RESET} jiradc issue get PROJ-123 --fields summary,status
   ${DIM}$${RESET} jiradc issue create --project PROJ --type Task --summary "Fix the bug"
   ${DIM}$${RESET} jiradc issue transition PROJ-123 --to 11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jiradc-cli",
-  "version": "1.0.17",
+  "version": "1.0.18-g1be46a3.1",
   "publish": true,
   "type": "module",
   "main": "dist/index.js",
@@ -12,7 +12,7 @@
   ],
   "dependencies": {
     "commander": "^13.1.0",
-    "jira-data-center-client": "1.0.35"
+    "jira-data-center-client": "1.0.35-g1be46a3.1"
   },
   "devDependencies": {
     "@types/node": "24.10.4",
@@ -22,8 +22,8 @@
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
     "vitest": "^4.0.16",
-    "config-typescript": "0.0.0",
-    "config-eslint": "0.0.0"
+    "config-eslint": "0.0.0",
+    "config-typescript": "0.0.0"
   },
   "engines": {
     "node": ">=22.0.0"