jiradc-cli 1.0.4 → 1.0.6

package/dist/index.js

@@ -1,34 +1,1084 @@
 #!/usr/bin/env node
-import { styleText } from 'node:util';
-import { Command } from 'commander';
-import { registerBoardCommands } from './commands/board/index.js';
-import { registerFieldCommands } from './commands/field/index.js';
-import { registerIssueCommands } from './commands/issue/index.js';
-import { registerProjectCommands } from './commands/project/index.js';
-import { registerSprintCommands } from './commands/sprint/index.js';
-import { registerUserCommands } from './commands/user/index.js';
-import { handleError } from './utils/output.js';
-const DIM = '\x1b[2m';
-const RESET = '\x1b[0m';
-const program = new Command();
-program
-    .name('jiradc')
-    .description('Jira Data Center CLI')
-    .version('1.0.0')
-    .configureHelp({
-    styleTitle: (str) => styleText('bold', str),
-    styleUsage: (str) => styleText('dim', str),
-    styleCommandDescription: (str) => styleText('dim', str),
-    styleOptionDescription: (str) => styleText('dim', str),
-    styleSubcommandDescription: (str) => styleText('dim', str),
-})
-    .addHelpText('beforeAll', `\n${styleText('bold', 'jiradc')} ${DIM}— Jira Data Center CLI${RESET}\n`)
-    .addHelpText('after', `
-${styleText('bold', 'Environment:')}
+
+// src/index.ts
+import { styleText } from "util";
+import { Command } from "commander";
+
+// src/utils/client.ts
+import { JiraClient } from "jira-data-center-client";
+function getClient() {
+  const baseUrl = process.env.JIRA_URL;
+  const token = process.env.JIRA_TOKEN;
+  if (!baseUrl || !token) {
+    const missing = [...!baseUrl ? ["JIRA_URL"] : [], ...!token ? ["JIRA_TOKEN"] : []];
+    process.stderr.write(
+      `${JSON.stringify({
+        error: `Missing required environment variables: ${missing.join(", ")}`,
+        setup: {
+          JIRA_URL: "Your Jira Server base URL (e.g., https://jira.example.com)",
+          JIRA_TOKEN: "Personal Access Token \u2014 generate in Jira > Profile > Personal Access Tokens"
+        },
+        hint: "Export these in your shell profile (e.g., ~/.zshrc)."
+      })}
+`
+    );
+    process.exit(1);
+  }
+  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
+function output(data) {
+  process.stdout.write(`${JSON.stringify(stripResponse(data), null, 2)}
+`);
+}
+function handleError(err) {
+  const message = err instanceof Error ? err.message : String(err);
+  const axiosStatus = err?.response?.status;
+  if (axiosStatus === 400) {
+    const responseData = err?.response?.data;
+    const jiraErrors = responseData && typeof responseData === "object" ? responseData : void 0;
+    process.stderr.write(
+      `${JSON.stringify({
+        error: `Bad request (HTTP 400)`,
+        detail: jiraErrors ?? message,
+        hint: "Check that all parameters are valid (JQL syntax, field names, project keys, etc.)."
+      })}
+`
+    );
+  } else if (axiosStatus === 401) {
+    process.stderr.write(
+      `${JSON.stringify({
+        error: "Authentication failed (HTTP 401)",
+        hint: "Verify that JIRA_URL and JIRA_TOKEN are set correctly. The token may be expired or invalid."
+      })}
+`
+    );
+  } else if (axiosStatus === 403) {
+    const responseData = err?.response?.data;
+    process.stderr.write(
+      `${JSON.stringify({
+        error: "Forbidden (HTTP 403)",
+        detail: responseData && typeof responseData === "object" ? responseData : message,
+        hint: "Your account does not have permission for this operation. Check project permissions and token scope."
+      })}
+`
+    );
+  } else if (message.includes("ENOTFOUND") || message.includes("ECONNREFUSED") || message.includes("ECONNRESET")) {
+    process.stderr.write(
+      `${JSON.stringify({
+        error: `Cannot connect to Jira server: ${message}`,
+        hint: "Verify that JIRA_URL is correct and the server is reachable."
+      })}
+`
+    );
+  } else if (axiosStatus === 500) {
+    process.stderr.write(
+      `${JSON.stringify({
+        error: `Server error (HTTP 500): ${message}`,
+        hint: "The server returned an internal error. Check that all parameters are valid (project keys, issue keys, JQL query syntax)."
+      })}
+`
+    );
+  } else {
+    process.stderr.write(`${JSON.stringify({ error: message })}
+`);
+  }
+  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(
+    "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),
+      startAt: opts.startAt,
+      maxResults: opts.max,
+      fields: opts.fields?.split(",").map((f) => f.trim()),
+      jql: opts.jql
+    });
+    output(result);
+  });
+}
+
+// src/commands/board/list.ts
+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(
+    "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) => {
+    const client = getClient();
+    const result = await client.agile.getBoards({
+      maxResults: opts.max,
+      projectKeyOrId: opts.project,
+      type: opts.type,
+      name: opts.name
+    });
+    output(result);
+  });
+}
+
+// src/commands/board/index.ts
+function registerBoardCommands(program2) {
+  const board = program2.command("board").description("Board operations").addHelpText(
+    "after",
+    `
+Examples:
+  $ jiradc board list
+  $ jiradc board list --type scrum --project PROJ
+  $ jiradc board issues 42 --max 20
+`
+  );
+  list(board);
+  issues(board);
+}
+
+// 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(
+    "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) => {
+    const client = getClient();
+    const result = await client.fields.getFieldOptions({
+      fieldId: id,
+      query: opts.query,
+      maxResults: opts.max,
+      page: opts.page
+    });
+    output(result);
+  });
+}
+
+// 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(
+    "after",
+    "\nExamples:\n  jiradc field search epic\n  jiradc field search customfield_10100\n  jiradc field search priority --limit 5"
+  ).action(async (keyword, opts) => {
+    const client = getClient();
+    const result = await client.fields.search(keyword, opts.limit);
+    output(result);
+  });
+}
+
+// src/commands/field/index.ts
+function registerFieldCommands(program2) {
+  const field = program2.command("field").description("Field operations").addHelpText(
+    "after",
+    `
+Examples:
+  $ jiradc field search "epic"
+  $ jiradc field search "priority"
+  $ jiradc field options 10120
+`
+  );
+  search(field);
+  options(field);
+}
+
+// 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) => {
+    const client = getClient();
+    await client.issues.deleteAttachment({ attachmentId: opts.id });
+    output({ deleted: true, attachmentId: opts.id });
+  });
+}
+
+// src/commands/issue/attachment/download-all.ts
+import { mkdirSync } from "fs";
+import { join } from "path";
+function downloadAll(parent) {
+  parent.command("download-all <key>").description("Download all attachments from an issue").requiredOption("--output <dir>", "Local directory to save attachments into").addHelpText("after", "\nExamples:\n  jiradc issue attachment download-all PROJ-123 --output ./downloads").action(async (key, opts) => {
+    const client = getClient();
+    mkdirSync(opts.output, { recursive: true });
+    const issue = await client.issues.get({
+      issueKeyOrId: key,
+      fields: ["attachment"]
+    });
+    const atts = issue.fields.attachment ?? [];
+    if (atts.length === 0) {
+      output({ issueKey: key, downloaded: 0, files: [] });
+      return;
+    }
+    const results = [];
+    const failed = [];
+    for (const att of atts) {
+      if (!att.content) {
+        failed.push({ filename: att.filename, error: "No content URL" });
+        continue;
+      }
+      const destPath = join(opts.output, att.filename);
+      try {
+        await client.issues.downloadAttachment({ url: att.content, destinationPath: destPath });
+        results.push({ filename: att.filename, size: att.size, path: destPath });
+      } catch (err) {
+        failed.push({ filename: att.filename, error: String(err) });
+      }
+    }
+    output({
+      issueKey: key,
+      downloaded: results.length,
+      total: atts.length,
+      files: results,
+      ...failed.length > 0 && { failed }
+    });
+  });
+}
+
+// src/commands/issue/attachment/download.ts
+function download(parent) {
+  parent.command("download <key>").description("Download a single attachment by ID").requiredOption("--id <attachmentId>", "Attachment ID").requiredOption("--output <path>", "Local file path to save the attachment").addHelpText("after", "\nExamples:\n  jiradc issue attachment download PROJ-123 --id 12345 --output ./report.pdf").action(async (key, opts) => {
+    const client = getClient();
+    const attachment = await client.issues.getAttachment({ attachmentId: opts.id });
+    if (!attachment.content) {
+      throw new Error(`Attachment ${opts.id} has no content URL`);
+    }
+    await client.issues.downloadAttachment({
+      url: attachment.content,
+      destinationPath: opts.output
+    });
+    output({
+      downloaded: true,
+      issueKey: key,
+      path: opts.output,
+      filename: attachment.filename,
+      size: attachment.size
+    });
+  });
+}
+
+// src/commands/issue/attachment/list.ts
+function list2(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({
+      issueKeyOrId: key,
+      fields: ["attachment"]
+    });
+    const atts = issue.fields.attachment ?? [];
+    output({
+      issueKey: key,
+      total: atts.length,
+      attachments: atts.map((a) => ({
+        id: a.id,
+        filename: a.filename,
+        size: a.size,
+        mimeType: a.mimeType,
+        created: a.created
+      }))
+    });
+  });
+}
+
+// src/commands/issue/attachment/upload.ts
+function upload(parent) {
+  parent.command("upload <key>").description("Upload attachments to an issue").requiredOption("--files <paths>", "Comma-separated file paths to upload").addHelpText(
+    "after",
+    "\nExamples:\n  jiradc issue attachment upload PROJ-123 --files ./report.pdf\n  jiradc issue attachment upload PROJ-123 --files ./a.txt,./b.png"
+  ).action(async (key, opts) => {
+    const client = getClient();
+    const filePaths = opts.files.split(",").map((f) => f.trim());
+    const results = [];
+    for (const filePath of filePaths) {
+      const attachments2 = await client.issues.addAttachment({ issueKeyOrId: key, filePath });
+      results.push(...attachments2);
+    }
+    output({
+      issueKey: key,
+      uploaded: results.length,
+      attachments: results.map((a) => ({
+        id: a.id,
+        filename: a.filename,
+        size: a.size,
+        mimeType: a.mimeType,
+        created: a.created
+      }))
+    });
+  });
+}
+
+// src/commands/issue/attachment/index.ts
+function registerAttachmentCommands(parent) {
+  const attachment = parent.command("attachment").description("Attachment operations").addHelpText(
+    "after",
+    `
+Examples:
+  $ jiradc issue attachment list PROJ-123
+  $ jiradc issue attachment upload PROJ-123 --files ./report.pdf
+  $ jiradc issue attachment download PROJ-123 --id 12345 --output ./report.pdf
+  $ jiradc issue attachment download-all PROJ-123 --output ./downloads
+  $ jiradc issue attachment delete --id 12345
+`
+  );
+  upload(attachment);
+  list2(attachment);
+  download(attachment);
+  downloadAll(attachment);
+  deleteAttachment(attachment);
+}
+
+// src/commands/issue/attachments.ts
+import { mkdirSync as mkdirSync2 } from "fs";
+import { join as join2 } from "path";
+function attachments(parent) {
+  parent.command("attachments <key>").description("Download all attachments from an issue").requiredOption("--output <dir>", "Local directory to save attachments into").addHelpText("after", "\nExamples:\n  jiradc issue attachments PROJ-123 --output ./downloads").action(async (key, opts) => {
+    const client = getClient();
+    mkdirSync2(opts.output, { recursive: true });
+    const issue = await client.issues.get({
+      issueKeyOrId: key,
+      fields: ["attachment"]
+    });
+    const atts = issue.fields.attachment ?? [];
+    if (atts.length === 0) {
+      output({ issueKey: key, downloaded: 0, files: [] });
+      return;
+    }
+    const results = [];
+    const failed = [];
+    for (const att of atts) {
+      if (!att.content) {
+        failed.push({ filename: att.filename, error: "No content URL" });
+        continue;
+      }
+      const destPath = join2(opts.output, att.filename);
+      try {
+        await client.issues.downloadAttachment({ url: att.content, destinationPath: destPath });
+        results.push({ filename: att.filename, size: att.size, path: destPath });
+      } catch (err) {
+        failed.push({ filename: att.filename, error: String(err) });
+      }
+    }
+    output({
+      issueKey: key,
+      downloaded: results.length,
+      total: atts.length,
+      files: results,
+      ...failed.length > 0 && { failed }
+    });
+  });
+}
+
+// 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(
+    "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);
+  });
+}
+
+// src/commands/issue/batch-create.ts
+function batchCreate(parent) {
+  parent.command("batch-create").description("Create multiple issues from a JSON array").requiredOption("--issues <json>", "JSON array of issue objects").addHelpText(
+    "after",
+    `
+Examples:
+  jiradc issue batch-create --issues '[{"projectKeyOrId":"PROJ","issueTypeName":"Task","summary":"Task 1"},{"projectKeyOrId":"PROJ","issueTypeName":"Task","summary":"Task 2"}]'`
+  ).action(async (opts) => {
+    const client = getClient();
+    const parsed = JSON.parse(opts.issues);
+    const results = [];
+    for (const issue of parsed) {
+      try {
+        const result = await client.issues.create(issue);
+        results.push({ key: result.key });
+      } catch (error) {
+        results.push({ error: error instanceof Error ? error.message : "Unknown error" });
+      }
+    }
+    output(results);
+  });
+}
+
+// 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) => {
+    const client = getClient();
+    const result = await client.issues.getChangelog({ issueKeyOrId: key, maxResults: opts.max });
+    output(result);
+  });
+}
+
+// src/commands/issue/clone.ts
+import { unlink } from "fs/promises";
+import { tmpdir } from "os";
+import { join as join3 } from "path";
+var CLONE_FIELDS = [
+  "summary",
+  "description",
+  "issuetype",
+  "project",
+  "priority",
+  "labels",
+  "components",
+  "fixVersions",
+  "assignee",
+  "duedate",
+  "attachment",
+  "issuelinks"
+];
+function clone(parent) {
+  parent.command("clone <key>").description("Clone an issue (create a duplicate with the same fields)").option("--summary <text>", 'Override the summary (default: "CLONE - <original>")').option("--project <key>", "Create in a different project").option("--assignee <username>", "Override assignee").option("--include-attachments", "Copy attachments to the cloned issue").option("--include-links", "Copy issue links to the cloned issue").addHelpText(
+    "after",
+    `
+Examples:
+  jiradc issue clone PROJ-123
+  jiradc issue clone PROJ-123 --summary "Cloned: new title"
+  jiradc issue clone PROJ-123 --include-attachments --include-links`
+  ).action(
+    async (key, opts) => {
+      const client = getClient();
+      const source = await client.issues.get({ issueKeyOrId: key, fields: CLONE_FIELDS });
+      const f = source.fields;
+      const createParams = {
+        projectKeyOrId: opts.project ?? f.project?.key ?? "",
+        issueTypeName: f.issuetype?.name ?? "",
+        summary: opts.summary ?? `CLONE - ${f.summary ?? ""}`,
+        description: f.description ?? void 0,
+        priority: f.priority?.name,
+        labels: f.labels,
+        components: f.components?.map((c) => c.name),
+        fixVersions: f.fixVersions?.length ? f.fixVersions.map((v) => v.name) : void 0,
+        dueDate: f.duedate ?? void 0,
+        assignee: opts.assignee ?? f.assignee?.name
+      };
+      const result = await client.issues.create(createParams);
+      const newKey = result.key;
+      const cloneResult = {
+        cloned: true,
+        source: key,
+        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);
+        }
+        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 {
+            if (link2.outwardIssue) {
+              await client.links.create({
+                typeName: link2.type.name,
+                inwardIssueKey: newKey,
+                outwardIssueKey: link2.outwardIssue.key
+              });
+            } else if (link2.inwardIssue) {
+              await 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;
+      }
+      output(cloneResult);
+    }
+  );
+}
+
+// src/commands/issue/comment-edit.ts
+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);
+  });
+}
+
+// src/commands/issue/comment.ts
+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);
+  });
+}
+
+// src/commands/issue/create.ts
+function create(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",
+    `
+Examples:
+  jiradc issue create --project PROJ --type Task --summary "Fix login bug"
+  jiradc issue create --project PROJ --type Story --summary "New feature" --assignee jsmith --priority High
+  jiradc issue create --project PROJ --type Task --summary "Epic child" --custom-fields '{"customfield_10100": "PROJ-123"}'
+  jiradc issue create --project PROJ --type Bug --summary "Urgent" --labels urgent,production --components Backend`
+  ).action(
+    async (opts) => {
+      const client = getClient();
+      const result = await client.issues.create({
+        projectKeyOrId: opts.project,
+        issueTypeName: opts.type,
+        summary: opts.summary,
+        description: opts.description,
+        assignee: opts.assignee,
+        reporter: opts.reporter,
+        priority: opts.priority,
+        labels: opts.labels?.split(",").map((l) => l.trim()),
+        components: opts.components?.split(",").map((c) => c.trim()),
+        fixVersions: opts.fixVersions?.split(",").map((v) => v.trim()),
+        dueDate: opts.dueDate,
+        parent: opts.parent,
+        customFields: opts.customFields ? JSON.parse(opts.customFields) : void 0
+      });
+      output(result);
+    }
+  );
+}
+
+// src/commands/issue/delete.ts
+function deleteIssue(parent) {
+  parent.command("delete <key>").description("Delete an issue").option("--delete-subtasks", "Also delete subtasks (default: false)").addHelpText(
+    "after",
+    "\nExamples:\n  jiradc issue delete PROJ-123\n  jiradc issue delete PROJ-123 --delete-subtasks"
+  ).action(async (key, opts) => {
+    const client = getClient();
+    await client.issues.delete({ issueKeyOrId: key, deleteSubtasks: opts.deleteSubtasks });
+    output({ deleted: true, issueKey: key });
+  });
+}
+
+// src/commands/issue/dev-status.ts
+function devStatus(parent) {
+  parent.command("dev-status <key>").description("Get development status (PRs, commits, branches, builds) for an issue").option("--detail", "Include PR URLs, commit IDs, and other details").addHelpText(
+    "after",
+    "\nExamples:\n  jiradc issue dev-status PROJ-123\n  jiradc issue dev-status PROJ-123 --detail"
+  ).action(async (key, opts) => {
+    const client = getClient();
+    const issue = await client.issues.get({ issueKeyOrId: key, fields: ["summary"] });
+    const issueId = issue.id;
+    const result = await client.devStatus.getSummary(issueId);
+    const s = result.summary;
+    const source = (byInstance) => {
+      const names = Object.values(byInstance).map((v) => v.name);
+      return names.length > 0 ? names.join(", ") : void 0;
+    };
+    const devInfo = {
+      pullRequests: {
+        total: s.pullrequest.overall.count,
+        open: s.pullrequest.overall.details.openCount,
+        merged: s.pullrequest.overall.details.mergedCount,
+        declined: s.pullrequest.overall.details.declinedCount,
+        ...source(s.pullrequest.byInstanceType) && { source: source(s.pullrequest.byInstanceType) }
+      },
+      commits: {
+        total: s.repository.overall.count,
+        ...s.repository.overall.lastUpdated && { lastUpdated: s.repository.overall.lastUpdated },
+        ...source(s.repository.byInstanceType) && { source: source(s.repository.byInstanceType) }
+      },
+      branches: { total: s.branch.overall.count },
+      builds: {
+        total: s.build.overall.count,
+        ...s.build.overall.count > 0 && {
+          successful: s.build.overall.successfulBuildCount,
+          failed: s.build.overall.failedBuildCount,
+          unknown: s.build.overall.unknownBuildCount
+        }
+      },
+      reviews: { total: s.review.overall.count },
+      deployments: { total: s["deployment-environment"].overall.count }
+    };
+    if (opts.detail) {
+      const [prDetail, repoDetail] = await Promise.all([
+        s.pullrequest.overall.count > 0 ? client.devStatus.getDetail(issueId, "pullrequest") : null,
+        s.repository.overall.count > 0 ? client.devStatus.getDetail(issueId, "repository") : null
+      ]);
+      if (prDetail) {
+        const prs = prDetail.detail.flatMap((d) => d.pullRequests);
+        devInfo.pullRequests.items = prs.map((pr) => ({
+          id: pr.id,
+          title: pr.name,
+          status: pr.status,
+          url: pr.url,
+          author: pr.author.name,
+          source: pr.source.branch,
+          destination: pr.destination.branch,
+          lastUpdate: pr.lastUpdate
+        }));
+      }
+      if (repoDetail) {
+        const commits = repoDetail.detail.flatMap(
+          (d) => d.repositories.flatMap(
+            (r) => r.commits.map((c) => ({
+              id: c.displayId,
+              message: c.message.split("\n")[0],
+              author: c.author.name,
+              date: c.authorTimestamp,
+              url: c.url,
+              fileCount: c.fileCount,
+              merge: c.merge
+            }))
+          )
+        );
+        devInfo.commits.items = commits;
+      }
+    }
+    output(devInfo);
+  });
+}
+
+// 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(
+    "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) => {
+    const client = getClient();
+    const result = await client.issues.getWorklogs({
+      issueKeyOrId: key,
+      startAt: opts.startAt,
+      maxResults: opts.max
+    });
+    output(result);
+  });
+}
+
+// src/utils/constants.ts
+var DEFAULT_FIELDS = [
+  "summary",
+  "description",
+  "status",
+  "assignee",
+  "reporter",
+  "labels",
+  "priority",
+  "created",
+  "updated",
+  "issuetype",
+  "components",
+  "comment"
+];
+
+// src/commands/issue/get.ts
+function get(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"
+  ).action(async (key, opts) => {
+    const client = getClient();
+    const fields = opts.allFields ? void 0 : opts.fields?.split(",").map((f) => f.trim()) ?? DEFAULT_FIELDS;
+    const result = await client.issues.get({
+      issueKeyOrId: key,
+      fields,
+      expand: opts.expand
+    });
+    output(result);
+  });
+}
+
+// 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) => {
+    const client = getClient();
+    await client.issues.update({
+      issueKeyOrId: key,
+      fields: { customfield_10100: opts.epic }
+    });
+    output({ linked: true, issue: key, epic: opts.epic });
+  });
+}
+
+// src/commands/issue/link-types.ts
+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);
+  });
+}
+
+// src/commands/issue/link.ts
+function link(parent) {
+  parent.command("link").description("Link two issues together").requiredOption("--type <name>", "Link type name (e.g., 'Blocks', 'Duplicate', 'Relates')").requiredOption("--from <key>", 'Source issue key (e.g., the issue that "blocks")').requiredOption("--to <key>", 'Target issue key (e.g., the issue that "is blocked by")').option("--comment <text>", "Optional comment").addHelpText(
+    "after",
+    "\nExamples:\n  jiradc issue link --type Relates --from AI-154 --to AI-149\n  jiradc issue link --type Blocks --from PROJ-456 --to PROJ-123  # PROJ-456 blocks PROJ-123"
+  ).action(async (opts) => {
+    const client = getClient();
+    await client.links.create({
+      typeName: opts.type,
+      inwardIssueKey: opts.from,
+      outwardIssueKey: opts.to,
+      comment: opts.comment
+    });
+    output({ created: true, type: opts.type, inward: opts.from, outward: opts.to });
+  });
+}
+
+// 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(
+    "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) => {
+    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,
+      fields
+    });
+    output(result);
+  });
+}
+
+// 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(
+    "after",
+    '\nExamples:\n  jiradc issue transition PROJ-123 --to 31\n  jiradc issue transition PROJ-123 --to 31 --comment "Moving to review"'
+  ).action(async (key, opts) => {
+    const client = getClient();
+    await client.issues.transition({ issueKeyOrId: key, transitionId: opts.to, comment: opts.comment });
+    output({ transitioned: true, issueKey: key });
+  });
+}
+
+// src/commands/issue/transitions.ts
+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);
+  });
+}
+
+// src/commands/issue/unlink.ts
+function unlink2(parent) {
+  parent.command("unlink <id>").description("Remove a link between two issues").addHelpText("after", "\nExamples:\n  jiradc issue unlink 12345").action(async (id) => {
+    const client = getClient();
+    await client.links.remove({ linkId: id });
+    output({ removed: true, linkId: id });
+  });
+}
+
+// src/commands/issue/update.ts
+function update(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",
+    `
+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`
+  ).action(async (key, opts) => {
+    if (!opts.fields && !opts.attachments) {
+      console.error(JSON.stringify({ error: "Provide --fields and/or --attachments" }));
+      process.exit(1);
+    }
+    const client = getClient();
+    if (opts.fields) {
+      const parsed = JSON.parse(opts.fields);
+      await client.issues.update({ issueKeyOrId: key, fields: parsed, notifyUsers: opts.notifyUsers });
+    }
+    const uploaded = [];
+    if (opts.attachments) {
+      const filePaths = opts.attachments.split(",").map((p) => p.trim()).filter(Boolean);
+      for (const filePath of filePaths) {
+        const result = await client.issues.addAttachment({ issueKeyOrId: key, filePath });
+        for (const att of result) {
+          uploaded.push({ filename: att.filename, id: att.id });
+        }
+      }
+    }
+    output({ updated: true, issueKey: key, ...uploaded.length > 0 && { attachments: uploaded } });
+  });
+}
+
+// src/commands/issue/worklog.ts
+function worklog(parent) {
+  parent.command("worklog <key>").description("Log time spent on an issue").requiredOption("--time <timeSpent>", "Time spent (e.g., '2h', '30m', '1d 4h')").option("--comment <text>", "Worklog comment").option("--started <datetime>", "Start time in ISO 8601 format").addHelpText(
+    "after",
+    '\nExamples:\n  jiradc issue worklog PROJ-123 --time 2h\n  jiradc issue worklog PROJ-123 --time "1d 4h" --comment "Backend implementation"\n  jiradc issue worklog PROJ-123 --time 3h --started "2026-03-19T09:00:00.000+0000"'
+  ).action(async (key, opts) => {
+    const client = getClient();
+    const result = await client.issues.addWorklog({
+      issueKeyOrId: key,
+      timeSpent: opts.time,
+      comment: opts.comment,
+      started: opts.started
+    });
+    output(result);
+  });
+}
+
+// src/commands/issue/index.ts
+function registerIssueCommands(program2) {
+  const issue = program2.command("issue").description("Issue operations").addHelpText(
+    "after",
+    `
+Examples:
+  $ jiradc issue get PROJ-123
+  $ jiradc issue search "project = PROJ AND status = Open" --max 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
+  $ jiradc issue attachment list PROJ-123
+`
+  );
+  get(issue);
+  search2(issue);
+  create(issue);
+  update(issue);
+  deleteIssue(issue);
+  transition(issue);
+  transitions(issue);
+  comment(issue);
+  commentEdit(issue);
+  worklog(issue);
+  getWorklog(issue);
+  changelog(issue);
+  batchChangelog(issue);
+  link(issue);
+  unlink2(issue);
+  linkTypes(issue);
+  linkEpic(issue);
+  registerAttachmentCommands(issue);
+  attachments(issue);
+  batchCreate(issue);
+  clone(issue);
+  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) {
+  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);
+  });
+}
+
+// src/commands/project/versions.ts
+function versions(parent) {
+  parent.command("versions <key>").description("Get all versions for a project").option("--expand <expand>", "Expand options").addHelpText(
+    "after",
+    "\nExamples:\n  jiradc project versions PROJ\n  jiradc project versions PROJ --expand operations"
+  ).action(async (key, opts) => {
+    const client = getClient();
+    const result = await client.projects.getVersions({ projectKeyOrId: key, expand: opts.expand });
+    output(result);
+  });
+}
+
+// src/commands/project/index.ts
+function registerProjectCommands(program2) {
+  const project = program2.command("project").description("Project operations").addHelpText(
+    "after",
+    `
+Examples:
+  $ jiradc project list
+  $ jiradc project versions PROJ
+  $ jiradc project components PROJ
+`
+  );
+  list3(project);
+  versions(project);
+  components(project);
+}
+
+// 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(
+    "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),
+      startDate: opts.startDate,
+      endDate: opts.endDate,
+      goal: opts.goal
+    });
+    output(result);
+  });
+}
+
+// src/commands/sprint/issues.ts
+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(
+    "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),
+      startAt: opts.startAt,
+      maxResults: opts.max,
+      fields: opts.fields?.split(",").map((f) => f.trim()),
+      jql: opts.jql
+    });
+    output(result);
+  });
+}
+
+// src/commands/sprint/list.ts
+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(
+    "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),
+      state: opts.state
+    });
+    output(result);
+  });
+}
+
+// src/commands/sprint/update.ts
+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(
+    "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),
+        name: opts.name,
+        state: opts.state,
+        startDate: opts.startDate,
+        endDate: opts.endDate,
+        goal: opts.goal
+      });
+      output(result);
+    }
+  );
+}
+
+// src/commands/sprint/index.ts
+function registerSprintCommands(program2) {
+  const sprint = program2.command("sprint").description("Sprint operations").addHelpText(
+    "after",
+    `
+Examples:
+  $ jiradc sprint list --board 42
+  $ jiradc sprint list --board 42 --state active
+  $ jiradc sprint issues 123 --max 20
+  $ jiradc sprint create --board 42 --name "Sprint 10" --start-date 2026-04-01 --end-date 2026-04-14
+`
+  );
+  list4(sprint);
+  issues2(sprint);
+  create2(sprint);
+  update2(sprint);
+}
+
+// src/commands/user/me.ts
+function me(parent) {
+  parent.command("me [username]").description("Get a user profile. Omit username to get the authenticated user.").addHelpText("after", "\nExamples:\n  jiradc user me\n  jiradc user me jsmith").action(async (username) => {
+    const client = getClient();
+    const result = username ? await client.users.getUser({ username }) : await client.users.getMyself();
+    output(result);
+  });
+}
+
+// src/commands/user/index.ts
+function registerUserCommands(program2) {
+  const user = program2.command("user").description("User operations").addHelpText(
+    "after",
+    `
+Examples:
+  $ jiradc user me
+  $ jiradc user me jsmith
+`
+  );
+  me(user);
+}
+
+// src/index.ts
+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({
+  styleTitle: (str) => styleText("bold", str),
+  styleUsage: (str) => styleText("dim", str),
+  styleCommandDescription: (str) => styleText("dim", str),
+  styleOptionDescription: (str) => styleText("dim", str),
+  styleSubcommandDescription: (str) => styleText("dim", str)
+}).addHelpText("beforeAll", `
+${styleText("bold", "jiradc")} ${DIM}\u2014 Jira Data Center CLI${RESET}
+`).addHelpText(
+  "after",
+  `
+${styleText("bold", "Environment:")}
   JIRA_URL      Jira Server base URL ${DIM}(e.g., https://jira.example.com)${RESET}
   JIRA_TOKEN    Personal Access Token ${DIM}(generate in Jira > Profile > Personal Access Tokens)${RESET}
 
-${styleText('bold', 'Examples:')}
+${styleText("bold", "Examples:")}
   ${DIM}$${RESET} jiradc user me
   ${DIM}$${RESET} jiradc issue search "project = PROJ AND status = Open" --max 10
   ${DIM}$${RESET} jiradc issue get PROJ-123 --fields summary,status
@@ -36,7 +1086,8 @@ ${styleText('bold', 'Examples:')}
   ${DIM}$${RESET} jiradc issue transition PROJ-123 --to 11
   ${DIM}$${RESET} jiradc board list --type scrum
   ${DIM}$${RESET} jiradc sprint list --board 42 --state active
-`);
+`
+);
 registerIssueCommands(program);
 registerProjectCommands(program);
 registerBoardCommands(program);
@@ -44,9 +1095,7 @@ registerSprintCommands(program);
 registerFieldCommands(program);
 registerUserCommands(program);
 try {
-    await program.parseAsync();
-}
-catch (err) {
-    handleError(err);
+  await program.parseAsync();
+} catch (err) {
+  handleError(err);
 }
-//# sourceMappingURL=index.js.map