jiradc-cli 1.0.18 → 1.0.20

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
 
@@ -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,6 +432,49 @@ 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("--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(
@@ -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
@@ -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) => {
@@ -1185,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;
+    }
   });
 }
 
@@ -1250,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) });
   });
 }
@@ -1264,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));
   });
 }
 
@@ -1278,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) {
@@ -1308,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)
     });
   });
 }
@@ -1353,6 +1559,7 @@ Examples:
   deleteIssue(issue);
   transition(issue);
   transitions(issue);
+  assign(issue);
   comment(issue);
   commentEdit(issue);
   worklog(issue);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jiradc-cli",
-  "version": "1.0.18",
+  "version": "1.0.20",
   "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.36"
   },
   "devDependencies": {
     "@types/node": "24.10.4",