jiradc-cli 1.0.22 → 1.0.23-g3f22a81.1

package/dist/index.js

@@ -48,6 +48,39 @@ function positiveInt(raw) {
   return n;
 }
 
+// ../../cli-utils/dist/resolve-arg.js
+import { readFileSync as readFileSync3 } from "fs";
+import { InvalidArgumentError as InvalidArgumentError2 } from "commander";
+var RESOLVE_ARG_HINT = "(@- reads stdin, @<path> reads a file)";
+function resolveArgValue(raw) {
+  if (raw === "@-") {
+    if (process.stdin.isTTY) {
+      throw new InvalidArgumentError2('received "@-" but stdin is a terminal (nothing piped). Pipe data in (e.g. `... | cmd --body @-`), or pass the value directly.');
+    }
+    try {
+      return readFileSync3(0, "utf8");
+    } catch (err) {
+      throw new InvalidArgumentError2(`failed to read from stdin for "@-": ${err.message}`);
+    }
+  }
+  if (raw.startsWith("@@")) {
+    return raw.slice(1);
+  }
+  if (raw.startsWith("@")) {
+    const path = raw.slice(1);
+    try {
+      return readFileSync3(path, "utf8");
+    } catch (err) {
+      const e = err;
+      if (e.code === "ENOENT") {
+        throw new InvalidArgumentError2(`file not found: "${path}" (resolved from "${raw}"). Use "@-" to read stdin, "@<path>" to read a file, or "@@${path}" to pass the literal text "@${path}".`);
+      }
+      throw new InvalidArgumentError2(`failed to read file "${path}" (resolved from "${raw}"): ${e.message}`);
+    }
+  }
+  return raw;
+}
+
 // ../../cli-utils/dist/registry.js
 var SUB_ENTITY_ID_NUMERIC = {
   comment: true,
@@ -78,7 +111,7 @@ function subEntityOption(cmd, entity, opts = {}) {
   return defineOption(cmd, `--${entity}-id <id>`, description, numeric ? positiveInt : void 0, opts.mandatory);
 }
 function bodyOption(cmd, opts = {}) {
-  return defineOption(cmd, "--body <text>", "Prose body content", void 0, opts.mandatory);
+  return defineOption(cmd, "--body <text>", `Prose body content ${RESOLVE_ARG_HINT}`, resolveArgValue, opts.mandatory);
 }
 var EXAMPLES = /* @__PURE__ */ new WeakSet();
 function commandPath(cmd) {
@@ -717,7 +750,7 @@ var ASSIGNEE_TYPES = [
   "UNASSIGNED"
 ];
 function create(parent) {
-  const cmd = parent.command("create").description("Create a new component in a project").requiredOption("--project <key>", "Project key (e.g., AI)").requiredOption("--name <name>", "Component name").option("--description <text>", "Component description").option("--lead <username>", "Username of the component lead").addOption(new Option2("--assignee-type <type>", "Assignee strategy").choices(ASSIGNEE_TYPES));
+  const cmd = parent.command("create").description("Create a new component in a project").requiredOption("--project <key>", "Project key (e.g., AI)").requiredOption("--name <name>", "Component name").option("--description <text>", `Component description ${RESOLVE_ARG_HINT}`, resolveArgValue).option("--lead <username>", "Username of the component lead").addOption(new Option2("--assignee-type <type>", "Assignee strategy").choices(ASSIGNEE_TYPES));
   examples(cmd, [
     "--project AI --name Backend",
     '--project AI --name Frontend --description "UI work" --lead jsmith',
@@ -791,7 +824,7 @@ var ASSIGNEE_TYPES2 = [
   "UNASSIGNED"
 ];
 function update(parent) {
-  const cmd = parent.command("update <id>").description("Update an existing component (only provided fields are changed)").option("--name <name>", "New component name").option("--description <text>", "New component description").option("--lead <username>", "Username of the component lead (empty string clears it)").addOption(new Option3("--assignee-type <type>", "New assignee strategy").choices(ASSIGNEE_TYPES2));
+  const cmd = parent.command("update <id>").description("Update an existing component (only provided fields are changed)").option("--name <name>", "New component name").option("--description <text>", `New component description ${RESOLVE_ARG_HINT}`, resolveArgValue).option("--lead <username>", "Username of the component lead (empty string clears it)").addOption(new Option3("--assignee-type <type>", "New assignee strategy").choices(ASSIGNEE_TYPES2));
   examples(cmd, [
     "11289 --name Backend",
     '11289 --description "Server-side code"',
@@ -1254,7 +1287,7 @@ function registerCommentCommands(parent) {
 
 // src/commands/issue/create.ts
 function create3(parent) {
-  const cmd = 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"}')`);
+  const cmd = 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 ${RESOLVE_ARG_HINT}`, resolveArgValue).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"}')`);
   examples(cmd, [
     '--project PROJ --type Task --summary "Fix login bug"',
     '--project PROJ --type Story --summary "New feature" --assignee jsmith --priority High',
@@ -1454,7 +1487,7 @@ function linkTypes(parent) {
 
 // src/commands/issue/link.ts
 function link(parent) {
-  const cmd = 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");
+  const cmd = 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 ${RESOLVE_ARG_HINT}`, resolveArgValue);
   examples(cmd, [
     "--type Relates --from AI-154 --to AI-149",
     ["--type Blocks --from PROJ-456 --to PROJ-123", "PROJ-456 blocks PROJ-123"]
@@ -1499,7 +1532,7 @@ function search2(parent) {
 
 // src/commands/issue/transition.ts
 function transition(parent) {
-  const cmd = 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");
+  const cmd = 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 ${RESOLVE_ARG_HINT}`, resolveArgValue);
   examples(cmd, [
     "PROJ-123 --to 31",
     'PROJ-123 --to "In Review"',
@@ -1559,20 +1592,20 @@ function unlink2(parent) {
 }
 
 // src/utils/multi-value.ts
-import { InvalidArgumentError as InvalidArgumentError2 } from "commander";
+import { InvalidArgumentError as InvalidArgumentError3 } 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`);
+    throw new InvalidArgumentError3(`${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`);
+    throw new InvalidArgumentError3(`${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(
+    throw new InvalidArgumentError3(
       `${flagName} mixes set and mutate syntax. Either all values have +/- prefix, or none do.`
     );
   }
@@ -1594,7 +1627,7 @@ function buildSetValue(parsed, wrap) {
   return parsed.values.map(wrap);
 }
 function update3(parent) {
-  const cmd = 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")');
+  const cmd = 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) ${RESOLVE_ARG_HINT}`, resolveArgValue).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")');
   examples(cmd, [
     'PROJ-123 --summary "New title"',
     "PROJ-123 --priority High --assignee me",
@@ -1674,7 +1707,7 @@ function update3(parent) {
 
 // src/commands/issue/worklog/create.ts
 function create4(parent) {
-  const cmd = parent.command("create <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");
+  const cmd = parent.command("create <key>").description("Log time spent on an issue").requiredOption("--time <timeSpent>", "Time spent (e.g., '2h', '30m', '1d 4h')").option("--comment <text>", `Worklog comment ${RESOLVE_ARG_HINT}`, resolveArgValue).option("--started <datetime>", "Start time in ISO 8601 format");
   examples(cmd, [
     "PROJ-123 --time 2h",
     'PROJ-123 --time "1d 4h" --comment "Backend implementation"',
@@ -1743,7 +1776,7 @@ var ADJUST_ESTIMATE2 = ["new", "leave", "auto"];
 function update4(parent) {
   const cmd = parent.command("update <key>").description("Update an existing worklog entry");
   subEntityOption(cmd, "worklog", { mandatory: true });
-  cmd.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"');
+  cmd.option("--time <timeSpent>", "Time spent (e.g., '2h', '30m', '1d 4h')").option("--comment <text>", `Worklog comment ${RESOLVE_ARG_HINT}`, resolveArgValue).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"');
   examples(cmd, [
     'PROJ-123 --worklog-id 12345 --time "1h 30m"',
     'PROJ-123 --worklog-id 12345 --comment "Revised note"',

package/package.json

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