jiradc-cli 1.0.20 → 1.0.21

package/README.md

@@ -37,14 +37,17 @@ All commands output JSON. Add `--pretty` to pretty-print.
 | `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 comment add <key>` | Add a comment (`--body`) |
+| `jiradc issue comment edit <key>` | Edit a comment (`--id`, `--body`) |
+| `jiradc issue comment delete <key>` | Delete a comment (`--id`) |
 | `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 <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 worklog add <key>` | Add a work log entry (`--time`, `--comment`, `--started`) |
+| `jiradc issue worklog list <key>` | Get work log entries |
+| `jiradc issue worklog edit <key>` | Update a work log entry (`--id`, `--time`, `--comment`, `--started`, `--adjust-estimate`, `--new-estimate`) |
+| `jiradc issue worklog delete <key>` | Delete a work log entry (`--id`, `--adjust-estimate`, `--new-estimate`, `--increase-by`) |
 | `jiradc issue changelog <key>` | Get issue changelog |
 | `jiradc issue batch-changelog` | Get changelog for multiple issues (`--keys`) |
 | `jiradc issue clone <key>` | Clone an issue with subtasks |
@@ -93,6 +96,7 @@ All commands output JSON. Add `--pretty` to pretty-print.
 | `jiradc sprint issues <boardId> <sprintId>` | Get issues in a sprint |
 | `jiradc sprint create <boardId>` | Create a sprint |
 | `jiradc sprint update <sprintId>` | Update a sprint |
+| `jiradc sprint delete <sprintId>` | Delete a sprint (returns its issues to the backlog) |
 
 ### field
 
@@ -151,13 +155,16 @@ jiradc issue update AI-123 --fix-versions 1.0,2.0
 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"
+jiradc issue comment add AI-123 --body "Fixed in commit abc123"
+
+# Delete a comment
+jiradc issue comment delete AI-123 --id 12345
 
 # Link two issues
 jiradc issue link AI-123 AI-456 --type "blocks"
 
 # Log work
-jiradc issue worklog AI-123 --time "2h 30m" --comment "Code review"
+jiradc issue worklog add AI-123 --time "2h 30m" --comment "Code review"
 
 # List active sprints
 jiradc sprint list 42 --state active

package/dist/index.js

@@ -5,7 +5,7 @@ import { readFileSync } from "fs";
 import { dirname, join as join4 } from "path";
 import { fileURLToPath } from "url";
 import { styleText } from "util";
-import { Command as Command8 } from "commander";
+import { Command as Command11 } from "commander";
 
 // src/commands/board/issues.ts
 import { Argument } from "commander";
@@ -379,8 +379,8 @@ function transformIssueFields(fields) {
     issuelinks,
     subtasks,
     parent,
-    comment: comment2,
-    worklog: worklog2,
+    comment,
+    worklog,
     attachment,
     // required scalars / structured fields we always keep verbatim
     summary,
@@ -412,20 +412,20 @@ function transformIssueFields(fields) {
     // Drop empty comment / worklog containers entirely. The default Jira
     // search response includes both wrappers on every issue regardless of
     // count; on a 25-issue page that's 25 × 2 empty objects of pure noise.
-    ...comment2 && comment2.comments.length > 0 ? {
+    ...comment && comment.comments.length > 0 ? {
       comment: {
-        comments: comment2.comments.map(transformComment),
-        maxResults: comment2.maxResults,
-        total: comment2.total,
-        startAt: comment2.startAt
+        comments: comment.comments.map(transformComment),
+        maxResults: comment.maxResults,
+        total: comment.total,
+        startAt: comment.startAt
       }
     } : {},
-    ...worklog2 && worklog2.worklogs.length > 0 ? {
+    ...worklog && worklog.worklogs.length > 0 ? {
       worklog: {
-        worklogs: worklog2.worklogs.map(transformWorklog),
-        maxResults: worklog2.maxResults,
-        total: worklog2.total,
-        startAt: worklog2.startAt
+        worklogs: worklog.worklogs.map(transformWorklog),
+        maxResults: worklog.maxResults,
+        total: worklog.total,
+        startAt: worklog.startAt
       }
     } : {},
     ...attachment && attachment.length > 0 ? { attachment: attachment.map(transformAttachment) } : {}
@@ -1071,24 +1071,49 @@ Examples:
   );
 }
 
-// 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) => {
+// src/commands/issue/comment/add.ts
+function add(parent) {
+  parent.command("add <key>").description("Add a comment to an issue").requiredOption("--body <text>", "Comment body in wiki markup").addHelpText("after", '\nExamples:\n  jiradc issue comment add PROJ-123 --body "Fixed in latest build"').action(async (key, opts) => {
     const client = getClient();
-    const result = await client.issues.editComment({ issueKeyOrId: key, commentId: opts.id, body: opts.body });
+    const result = await client.issues.addComment({ issueKeyOrId: key, body: opts.body });
     output(transformComment(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) => {
+// src/commands/issue/comment/delete.ts
+function deleteComment(parent) {
+  parent.command("delete <key>").description("Delete a comment from an issue").requiredOption("--id <commentId>", "Comment ID to delete").addHelpText("after", "\nExamples:\n  jiradc issue comment delete PROJ-123 --id 12345").action(async (key, opts) => {
     const client = getClient();
-    const result = await client.issues.addComment({ issueKeyOrId: key, body: opts.body });
+    await client.issues.deleteComment({ issueKeyOrId: key, commentId: opts.id });
+    output({ deleted: true, issueKey: key, commentId: opts.id });
+  });
+}
+
+// src/commands/issue/comment/edit.ts
+function edit(parent) {
+  parent.command("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(transformComment(result));
   });
 }
 
+// src/commands/issue/comment/index.ts
+function registerCommentCommands(parent) {
+  const comment = parent.command("comment").description("Comment operations").addHelpText(
+    "after",
+    `
+Examples:
+  $ jiradc issue comment add PROJ-123 --body "Fixed in latest build"
+  $ jiradc issue comment edit PROJ-123 --id 12345 --body "Updated comment text"
+  $ jiradc issue comment delete PROJ-123 --id 12345
+`
+  );
+  add(comment);
+  edit(comment);
+  deleteComment(comment);
+}
+
 // src/commands/issue/create.ts
 function create2(parent) {
   parent.command("create").description("Create a new issue").requiredOption("--project <key>", "Project key or ID").requiredOption("--type <name>", "Issue type name (e.g., Task, Bug, Story)").requiredOption("--summary <text>", "Issue summary/title").option("--description <text>", "Issue description in wiki markup").option("--assignee <username>", "Assignee username").option("--reporter <username>", "Reporter username").option("--priority <name>", "Priority name (e.g., High, Medium, Low)").option("--labels <labels>", "Comma-separated labels").option("--components <names>", "Comma-separated component names").option("--fix-versions <versions>", "Comma-separated fix version names").option("--due-date <date>", "Due date in YYYY-MM-DD format").option("--parent <key>", "Parent issue key (for subtasks)").option("--custom-fields <json>", `Additional custom fields as JSON (e.g., '{"customfield_10100": "EPIC-1"}')`).addHelpText(
@@ -1213,22 +1238,6 @@ 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 <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 --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.start,
-      maxResults: opts.limit
-    });
-    output(transformPaged(result, transformWorklog));
-  });
-}
-
 // src/utils/constants.ts
 var DEFAULT_FIELDS = [
   "summary",
@@ -1521,11 +1530,11 @@ Examples:
   });
 }
 
-// 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(
+// src/commands/issue/worklog/add.ts
+function add2(parent) {
+  parent.command("add <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"'
+    '\nExamples:\n  jiradc issue worklog add PROJ-123 --time 2h\n  jiradc issue worklog add PROJ-123 --time "1d 4h" --comment "Backend implementation"\n  jiradc issue worklog add 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({
@@ -1538,6 +1547,86 @@ function worklog(parent) {
   });
 }
 
+// src/commands/issue/worklog/delete.ts
+import { Option as Option4 } from "commander";
+var ADJUST_ESTIMATE = ["new", "leave", "manual", "auto"];
+function deleteWorklog(parent) {
+  parent.command("delete <key>").description("Delete a worklog entry").requiredOption("--id <worklogId>", "Worklog ID to delete").addOption(new Option4("--adjust-estimate <mode>", "How to adjust the remaining estimate").choices(ADJUST_ESTIMATE)).option("--new-estimate <estimate>", 'New remaining estimate; required when --adjust-estimate is "new"').option("--increase-by <amount>", 'Amount to increase the estimate by; required when --adjust-estimate is "manual"').addHelpText(
+    "after",
+    "\nExamples:\n  jiradc issue worklog delete PROJ-123 --id 12345\n  jiradc issue worklog delete PROJ-123 --id 12345 --adjust-estimate leave\n  jiradc issue worklog delete PROJ-123 --id 12345 --adjust-estimate new --new-estimate 2h"
+  ).action(
+    async (key, opts) => {
+      const client = getClient();
+      await client.issues.deleteWorklog({
+        issueKeyOrId: key,
+        worklogId: opts.id,
+        adjustEstimate: opts.adjustEstimate,
+        newEstimate: opts.newEstimate,
+        increaseBy: opts.increaseBy
+      });
+      output({ deleted: true, issueKey: key, worklogId: opts.id });
+    }
+  );
+}
+
+// src/commands/issue/worklog/edit.ts
+import { Option as Option5 } from "commander";
+var ADJUST_ESTIMATE2 = ["new", "leave", "auto"];
+function edit2(parent) {
+  parent.command("edit <key>").description("Update an existing worklog entry").requiredOption("--id <worklogId>", "Worklog ID to edit").option("--time <timeSpent>", "Time spent (e.g., '2h', '30m', '1d 4h')").option("--comment <text>", "Worklog comment").option("--started <datetime>", "Start time in ISO 8601 format").addOption(new Option5("--adjust-estimate <mode>", "How to adjust the remaining estimate").choices(ADJUST_ESTIMATE2)).option("--new-estimate <estimate>", 'New remaining estimate; required when --adjust-estimate is "new"').addHelpText(
+    "after",
+    '\nExamples:\n  jiradc issue worklog edit PROJ-123 --id 12345 --time "1h 30m"\n  jiradc issue worklog edit PROJ-123 --id 12345 --comment "Revised note"\n  jiradc issue worklog edit PROJ-123 --id 12345 --time 2h --adjust-estimate new --new-estimate 4h'
+  ).action(
+    async (key, opts) => {
+      const client = getClient();
+      const result = await client.issues.updateWorklog({
+        issueKeyOrId: key,
+        worklogId: opts.id,
+        timeSpent: opts.time,
+        comment: opts.comment,
+        started: opts.started,
+        adjustEstimate: opts.adjustEstimate,
+        newEstimate: opts.newEstimate
+      });
+      output(transformWorklog(result));
+    }
+  );
+}
+
+// src/commands/issue/worklog/list.ts
+function list4(parent) {
+  parent.command("list <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 worklog list PROJ-123\n  jiradc issue worklog list PROJ-123 --limit 10\n  jiradc issue worklog list PROJ-123 --start 10 --limit 5"
+  ).action(async (key, opts) => {
+    const client = getClient();
+    const result = await client.issues.getWorklogs({
+      issueKeyOrId: key,
+      startAt: opts.start,
+      maxResults: opts.limit
+    });
+    output(transformPaged(result, transformWorklog));
+  });
+}
+
+// src/commands/issue/worklog/index.ts
+function registerWorklogCommands(parent) {
+  const worklog = parent.command("worklog").description("Worklog operations").addHelpText(
+    "after",
+    `
+Examples:
+  $ jiradc issue worklog add PROJ-123 --time 2h --comment "Backend work"
+  $ jiradc issue worklog list PROJ-123 --limit 10
+  $ jiradc issue worklog edit PROJ-123 --id 12345 --time "1h 30m"
+  $ jiradc issue worklog delete PROJ-123 --id 12345
+`
+  );
+  add2(worklog);
+  list4(worklog);
+  edit2(worklog);
+  deleteWorklog(worklog);
+}
+
 // src/commands/issue/index.ts
 function registerIssueCommands(program2) {
   const issue = program2.command("issue").description("Issue operations").addHelpText(
@@ -1560,10 +1649,8 @@ Examples:
   transition(issue);
   transitions(issue);
   assign(issue);
-  comment(issue);
-  commentEdit(issue);
-  worklog(issue);
-  getWorklog(issue);
+  registerCommentCommands(issue);
+  registerWorklogCommands(issue);
   changelog(issue);
   batchChangelog(issue);
   link(issue);
@@ -1578,7 +1665,7 @@ Examples:
 }
 
 // src/commands/project/list.ts
-function list4(parent) {
+function list5(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"
@@ -1611,7 +1698,7 @@ Examples:
   $ jiradc project versions PROJ
 `
   );
-  list4(project);
+  list5(project);
   versions(project);
 }
 
@@ -1633,10 +1720,20 @@ function create3(parent) {
   });
 }
 
-// src/commands/sprint/issues.ts
+// src/commands/sprint/delete.ts
 import { Argument as Argument2 } from "commander";
+function deleteSprint(parent) {
+  parent.command("delete").description("Delete a sprint (returns its issues to the backlog)").addArgument(new Argument2("<id>", "Sprint ID").argParser(positiveInt)).addHelpText("after", "\nExamples:\n  jiradc sprint delete 100").action(async (id) => {
+    const client = getClient();
+    await client.agile.deleteSprint({ sprintId: id });
+    output({ deleted: true, sprintId: id });
+  });
+}
+
+// src/commands/sprint/issues.ts
+import { Argument as Argument3 } from "commander";
 function issues2(parent) {
-  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(
+  parent.command("issues").description("Get issues in a sprint").addArgument(new Argument3("<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 --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) => {
@@ -1653,10 +1750,10 @@ function issues2(parent) {
 }
 
 // src/commands/sprint/list.ts
-import { Option as Option4 } from "commander";
+import { Option as Option6 } from "commander";
 var SPRINT_STATES = ["future", "active", "closed"];
-function list5(parent) {
-  parent.command("list").description("List sprints for a board").requiredOption("--board <id>", "Board ID", positiveInt).addOption(new Option4("--state <state>", "Filter by sprint state").choices(SPRINT_STATES)).addHelpText(
+function list6(parent) {
+  parent.command("list").description("List sprints for a board").requiredOption("--board <id>", "Board ID", positiveInt).addOption(new Option6("--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) => {
@@ -1670,10 +1767,10 @@ function list5(parent) {
 }
 
 // src/commands/sprint/update.ts
-import { Argument as Argument3, Option as Option5 } from "commander";
+import { Argument as Argument4, Option as Option7 } from "commander";
 var SPRINT_STATES2 = ["future", "active", "closed"];
 function update3(parent) {
-  parent.command("update").description("Update an existing sprint").addArgument(new Argument3("<id>", "Sprint ID").argParser(positiveInt)).option("--name <name>", "New sprint name").addOption(new Option5("--state <state>", "New sprint state").choices(SPRINT_STATES2)).option("--start-date <date>", "New start date in ISO 8601 format").option("--end-date <date>", "New end date in ISO 8601 format").option("--goal <goal>", "New sprint goal").addHelpText(
+  parent.command("update").description("Update an existing sprint").addArgument(new Argument4("<id>", "Sprint ID").argParser(positiveInt)).option("--name <name>", "New sprint name").addOption(new Option7("--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(
@@ -1704,10 +1801,11 @@ Examples:
   $ jiradc sprint create --board 42 --name "Sprint 10" --start-date 2026-04-01 --end-date 2026-04-14
 `
   );
-  list5(sprint);
+  list6(sprint);
   issues2(sprint);
   create3(sprint);
   update3(sprint);
+  deleteSprint(sprint);
 }
 
 // src/commands/token/client.ts
@@ -1767,7 +1865,7 @@ Examples:
 }
 
 // src/commands/token/list.ts
-function list6(parent) {
+function list7(parent) {
   parent.command("list").description("List Personal Access Tokens owned by the authenticated user (secrets not included)").option("--basic-username <u>", "Override $JIRA_BASIC_USERNAME").option(
     "--basic-password <p>",
     "Override $JIRA_BASIC_PASSWORD (caution: visible in process table; prefer the env var)"
@@ -1811,7 +1909,7 @@ Auth:
 `
   );
   create4(token);
-  list6(token);
+  list7(token);
   revoke(token);
 }
 
@@ -1880,7 +1978,7 @@ function readPackageVersion() {
 }
 var DIM = "\x1B[2m";
 var RESET = "\x1B[0m";
-var program = new Command8();
+var program = new Command11();
 program.name("jiradc").description("Jira Data Center CLI").version(readPackageVersion()).configureHelp({
   styleTitle: (str) => styleText("bold", str),
   styleUsage: (str) => styleText("dim", str),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jiradc-cli",
-  "version": "1.0.20",
+  "version": "1.0.21",
   "publish": true,
   "type": "module",
   "main": "dist/index.js",
@@ -12,7 +12,7 @@
   ],
   "dependencies": {
     "commander": "^13.1.0",
-    "jira-data-center-client": "1.0.36"
+    "jira-data-center-client": "1.0.37"
   },
   "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"