jiradc-cli 1.0.8 → 1.0.10

package/dist/index.js

@@ -1,8 +1,43 @@
 #!/usr/bin/env node
 
 // src/index.ts
+import { readFileSync } from "fs";
+import { dirname, join as join4 } from "path";
+import { fileURLToPath } from "url";
 import { styleText } from "util";
-import { Command } from "commander";
+import { Command as Command6 } from "commander";
+
+// src/commands/board/issues.ts
+import { Argument } from "commander";
+
+// src/utils/cli.ts
+import { InvalidArgumentError } from "commander";
+function intInRange(min, max) {
+  return (raw) => {
+    const n = parseInt(raw, 10);
+    if (Number.isNaN(n) || !Number.isFinite(n)) {
+      throw new InvalidArgumentError(`Not a number: "${raw}"`);
+    }
+    if (n < min || n > max) {
+      throw new InvalidArgumentError(`Must be between ${min} and ${max} (got ${n})`);
+    }
+    return n;
+  };
+}
+function nonNegativeInt(raw) {
+  const n = parseInt(raw, 10);
+  if (Number.isNaN(n) || n < 0) {
+    throw new InvalidArgumentError(`Must be a non-negative integer (got "${raw}")`);
+  }
+  return n;
+}
+function positiveInt(raw) {
+  const n = parseInt(raw, 10);
+  if (Number.isNaN(n) || n < 1) {
+    throw new InvalidArgumentError(`Must be a positive integer (got "${raw}")`);
+  }
+  return n;
+}
 
 // src/utils/client.ts
 import { JiraClient } from "jira-data-center-client";
@@ -125,21 +160,29 @@ function handleError(err) {
 `
     );
   } else {
-    process.stderr.write(`${JSON.stringify({ error: message })}
-`);
+    const responseData = err?.response?.data;
+    const detail = responseData && typeof responseData === "object" ? responseData : void 0;
+    process.stderr.write(
+      `${JSON.stringify({
+        error: message,
+        ...axiosStatus !== void 0 && { statusCode: axiosStatus },
+        ...detail && { detail }
+      })}
+`
+    );
   }
   process.exit(1);
 }
 
 // src/commands/board/issues.ts
 function issues(parent) {
-  parent.command("issues <id>").description("Get issues for a board").option("--max <number>", "Max results", parseInt).option("--start-at <number>", "Starting index for pagination (default: 0)", parseInt).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("--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(
     "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'
   ).action(async (id, opts) => {
     const client = getClient();
     const result = await client.agile.getBoardIssues({
-      boardId: parseInt(id, 10),
+      boardId: id,
       startAt: opts.startAt,
       maxResults: opts.max,
       fields: opts.fields?.split(",").map((f) => f.trim()),
@@ -150,8 +193,10 @@ function issues(parent) {
 }
 
 // src/commands/board/list.ts
+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", parseInt).option("--project <key>", "Filter boards by project key or ID").option("--type <type>", "Board type filter (scrum, kanban, simple)").option("--name <name>", "Filter boards by name").addHelpText(
+  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(
     "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"'
   ).action(async (opts) => {
@@ -183,7 +228,7 @@ 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", parseInt).option("--page <number>", "Page number", parseInt).addHelpText(
+  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(
     "after",
     '\nExamples:\n  jiradc field options 10001\n  jiradc field options 10001 --query "High"\n  jiradc field options 10001 --max 20 --page 2'
   ).action(async (id, opts) => {
@@ -200,7 +245,7 @@ function options(parent) {
 
 // src/commands/field/search.ts
 function search(parent) {
-  parent.command("search <keyword>").description("Search for fields by name or ID").option("--limit <number>", "Maximum number of results (default: 10)", parseInt).addHelpText(
+  parent.command("search <keyword>").description("Search for fields by name or ID").option("--limit <number>", "Maximum number of results (1-1000)", intInRange(1, 1e3), 25).addHelpText(
     "after",
     "\nExamples:\n  jiradc field search epic\n  jiradc field search customfield_10100\n  jiradc field search priority --limit 5"
   ).action(async (keyword, opts) => {
@@ -410,21 +455,23 @@ 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 (default: 50)", parseInt).addHelpText(
+  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(
     "after",
     "\nExamples:\n  jiradc issue batch-changelog PROJ-1,PROJ-2,PROJ-3\n  jiradc issue batch-changelog PROJ-123,PROJ-124 --max 10"
   ).action(async (keys, opts) => {
     const client = getClient();
     const keyList = keys.split(",").map((k) => k.trim());
-    const results = {};
-    for (const key of keyList) {
-      try {
-        results[key] = await client.issues.getChangelog({ issueKeyOrId: key, maxResults: opts.max });
-      } catch (error) {
-        results[key] = { error: error instanceof Error ? error.message : "Unknown error" };
-      }
-    }
-    output(results);
+    const entries = await Promise.all(
+      keyList.map(async (key) => {
+        try {
+          const data = await client.issues.getChangelog({ issueKeyOrId: key, maxResults: opts.max });
+          return [key, data];
+        } catch (error) {
+          return [key, { error: error instanceof Error ? error.message : "Unknown error" }];
+        }
+      })
+    );
+    output(Object.fromEntries(entries));
   });
 }
 
@@ -453,7 +500,7 @@ 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 (default: 50)", parseInt).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("--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) => {
     const client = getClient();
     const result = await client.issues.getChangelog({ issueKeyOrId: key, maxResults: opts.max });
     output(result);
@@ -511,43 +558,44 @@ Examples:
         newIssue: result
       };
       if (opts.includeAttachments && f.attachment?.length) {
-        const copied = [];
         const tmpFiles = [];
-        for (const att of f.attachment) {
-          const tmpPath = join3(tmpdir(), `jiradc-clone-${Date.now()}-${att.filename}`);
-          tmpFiles.push(tmpPath);
-          await client.issues.downloadAttachment({ url: att.content, destinationPath: tmpPath });
-          await client.issues.addAttachment({ issueKeyOrId: newKey, filePath: tmpPath });
-          copied.push(att.filename);
-        }
+        const copied = await Promise.all(
+          f.attachment.map(async (att) => {
+            const tmpPath = join3(tmpdir(), `jiradc-clone-${Date.now()}-${att.filename}`);
+            tmpFiles.push(tmpPath);
+            await client.issues.downloadAttachment({ url: att.content, destinationPath: tmpPath });
+            await client.issues.addAttachment({ issueKeyOrId: newKey, filePath: tmpPath });
+            return att.filename;
+          })
+        );
         await Promise.all(tmpFiles.map((p) => unlink(p).catch(() => void 0)));
         cloneResult.attachmentsCopied = copied.length;
         cloneResult.attachments = copied;
       }
       if (opts.includeLinks && f.issuelinks?.length) {
-        const linkedCount = { created: 0, skipped: 0 };
-        for (const link2 of f.issuelinks) {
-          try {
+        const outcomes = await Promise.allSettled(
+          f.issuelinks.map((link2) => {
             if (link2.outwardIssue) {
-              await client.links.create({
+              return client.links.create({
                 typeName: link2.type.name,
                 inwardIssueKey: newKey,
                 outwardIssueKey: link2.outwardIssue.key
               });
-            } else if (link2.inwardIssue) {
-              await client.links.create({
+            }
+            if (link2.inwardIssue) {
+              return client.links.create({
                 typeName: link2.type.name,
                 inwardIssueKey: link2.inwardIssue.key,
                 outwardIssueKey: newKey
               });
             }
-            linkedCount.created++;
-          } catch {
-            linkedCount.skipped++;
-          }
-        }
-        cloneResult.linksCopied = linkedCount.created;
-        if (linkedCount.skipped > 0) cloneResult.linksSkipped = linkedCount.skipped;
+            return Promise.resolve();
+          })
+        );
+        const created = outcomes.filter((o) => o.status === "fulfilled").length;
+        const skipped = outcomes.filter((o) => o.status === "rejected").length;
+        cloneResult.linksCopied = created;
+        if (skipped > 0) cloneResult.linksSkipped = skipped;
       }
       output(cloneResult);
     }
@@ -698,7 +746,7 @@ 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 (default: 0)", parseInt).option("--max <number>", "Max results per page", parseInt).addHelpText(
+  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(
     "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"
   ).action(async (key, opts) => {
@@ -785,7 +833,7 @@ 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 (default: 50)", parseInt).option("--start-at <number>", "Starting index for pagination (default: 0)", parseInt).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("--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(
     "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'
   ).action(async (jql, opts) => {
@@ -971,14 +1019,14 @@ Examples:
 
 // src/commands/sprint/create.ts
 function create2(parent) {
-  parent.command("create").description("Create a new sprint").requiredOption("--board <id>", "Board ID to create sprint in").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(
+  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"'
   ).action(async (opts) => {
     const client = getClient();
     const result = await client.agile.createSprint({
       name: opts.name,
-      originBoardId: parseInt(opts.board, 10),
+      originBoardId: opts.board,
       startDate: opts.startDate,
       endDate: opts.endDate,
       goal: opts.goal
@@ -988,14 +1036,15 @@ function create2(parent) {
 }
 
 // src/commands/sprint/issues.ts
+import { Argument as Argument2 } from "commander";
 function issues2(parent) {
-  parent.command("issues <id>").description("Get issues in a sprint").option("--max <number>", "Max results", parseInt).option("--start-at <number>", "Starting index for pagination (default: 0)", parseInt).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("--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(
     "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'
   ).action(async (id, opts) => {
     const client = getClient();
     const result = await client.agile.getSprintIssues({
-      sprintId: parseInt(id, 10),
+      sprintId: id,
       startAt: opts.startAt,
       maxResults: opts.max,
       fields: opts.fields?.split(",").map((f) => f.trim()),
@@ -1006,14 +1055,16 @@ function issues2(parent) {
 }
 
 // src/commands/sprint/list.ts
+import { Option as Option2 } 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").option("--state <state>", "Filter by sprint state (future, active, closed)").addHelpText(
+  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(
     "after",
     "\nExamples:\n  jiradc sprint list --board 42\n  jiradc sprint list --board 42 --state active"
   ).action(async (opts) => {
     const client = getClient();
     const result = await client.agile.getSprints({
-      boardId: parseInt(opts.board, 10),
+      boardId: opts.board,
       state: opts.state
     });
     output(result);
@@ -1021,15 +1072,17 @@ function list4(parent) {
 }
 
 // src/commands/sprint/update.ts
+import { Argument as Argument3, Option as Option3 } from "commander";
+var SPRINT_STATES2 = ["future", "active", "closed"];
 function update2(parent) {
-  parent.command("update <id>").description("Update an existing sprint").option("--name <name>", "New sprint name").option("--state <state>", "New sprint state (future, active, closed)").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(
+  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(
     "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(
     async (id, opts) => {
       const client = getClient();
       const result = await client.agile.updateSprint({
-        sprintId: parseInt(id, 10),
+        sprintId: id,
         name: opts.name,
         state: opts.state,
         startDate: opts.startDate,
@@ -1082,10 +1135,20 @@ Examples:
 }
 
 // src/index.ts
+function readPackageVersion() {
+  try {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const pkgPath = join4(here, "..", "package.json");
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+    return pkg.version ?? "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
 var DIM = "\x1B[2m";
 var RESET = "\x1B[0m";
-var program = new Command();
-program.name("jiradc").description("Jira Data Center CLI").version("1.0.0").configureHelp({
+var program = new Command6();
+program.name("jiradc").description("Jira Data Center CLI").version(readPackageVersion()).configureHelp({
   styleTitle: (str) => styleText("bold", str),
   styleUsage: (str) => styleText("dim", str),
   styleCommandDescription: (str) => styleText("dim", str),

package/package.json

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