@krodak/clickup-cli 1.27.1 → 1.28.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "clickup-cli",
   "description": "ClickUp CLI skills for managing tasks, sprints, comments, checklists, custom fields, tags, and time tracking via the cup command",
-  "version": "1.27.1",
+  "version": "1.28.0",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/dist/index.js

@@ -1993,27 +1993,54 @@ function parsePriority(value) {
   if (Number.isInteger(num) && num >= 1 && num <= 4) return num;
   throw new Error("Priority must be urgent, high, normal, low, or 1-4");
 }
+var DATE_ONLY_RE = /^\d{4}-\d{2}-\d{2}$/;
+var LOCAL_DATETIME_RE = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2}))?$/;
+var ISO_WITH_OFFSET_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2})?(?:\.\d+)?(?:Z|[+-]\d{2}:?\d{2})$/;
 function parseDueDate(value, timezone) {
-  if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) {
-    throw new Error("Date must be in YYYY-MM-DD format");
+  if (DATE_ONLY_RE.test(value)) {
+    const parts = value.split("-").map(Number);
+    const y = parts[0];
+    const m = parts[1];
+    const d = parts[2];
+    return { ms: wallClockToMs(y, m, d, 0, 0, 0, timezone, value), hasTime: false };
+  }
+  const localMatch = LOCAL_DATETIME_RE.exec(value);
+  if (localMatch) {
+    const y = Number(localMatch[1]);
+    const m = Number(localMatch[2]);
+    const d = Number(localMatch[3]);
+    const hh = Number(localMatch[4]);
+    const mm = Number(localMatch[5]);
+    const ss = localMatch[6] !== void 0 ? Number(localMatch[6]) : 0;
+    if (hh > 23 || mm > 59 || ss > 59) {
+      throw new Error(
+        "Date must be in YYYY-MM-DD, YYYY-MM-DDTHH:MM[:SS], or full ISO 8601 format (time component out of range)"
+      );
+    }
+    return { ms: wallClockToMs(y, m, d, hh, mm, ss, timezone, value), hasTime: true };
   }
-  const parts = value.split("-").map(Number);
-  const y = parts[0];
-  const m = parts[1];
-  const d = parts[2];
+  if (ISO_WITH_OFFSET_RE.test(value)) {
+    const ms = Date.parse(value);
+    if (!isNaN(ms)) return { ms, hasTime: true };
+  }
+  throw new Error(
+    "Date must be in YYYY-MM-DD, YYYY-MM-DDTHH:MM[:SS], or full ISO 8601 format (e.g. 2025-03-15T14:30 or 2025-03-15T14:30:00+08:00)"
+  );
+}
+function wallClockToMs(year, month, day, hour, minute, second, timezone, rawValue) {
   if (timezone) {
     try {
-      const ms2 = dateToTimezoneMs(y, m, d, timezone);
+      const ms2 = wallClockToTimezoneMs(year, month, day, hour, minute, second, timezone);
       if (!isNaN(ms2)) return ms2;
     } catch {
     }
   }
-  const ms = Date.UTC(y, m - 1, d);
-  if (isNaN(ms)) throw new Error(`Invalid date: ${value}`);
+  const ms = Date.UTC(year, month - 1, day, hour, minute, second);
+  if (isNaN(ms)) throw new Error(`Invalid date: ${rawValue}`);
   return ms;
 }
-function dateToTimezoneMs(year, month, day, timezone) {
-  const approxUtc = new Date(Date.UTC(year, month - 1, day));
+function wallClockToTimezoneMs(year, month, day, hour, minute, second, timezone) {
+  const approxUtc = new Date(Date.UTC(year, month - 1, day, hour, minute, second));
   const tzStr = approxUtc.toLocaleString("en-US", {
     timeZone: timezone,
     year: "numeric",
@@ -2074,13 +2101,15 @@ function buildUpdatePayload(opts, timezone) {
     if (opts.dueDate === "none" || opts.dueDate === "clear") {
       payload.due_date = null;
     } else {
-      payload.due_date = parseDueDate(opts.dueDate, timezone);
-      payload.due_date_time = false;
+      const parsed = parseDueDate(opts.dueDate, timezone);
+      payload.due_date = parsed.ms;
+      payload.due_date_time = parsed.hasTime;
     }
   }
   if (opts.startDate !== void 0) {
-    payload.start_date = parseDueDate(opts.startDate, timezone);
-    payload.start_date_time = false;
+    const parsed = parseDueDate(opts.startDate, timezone);
+    payload.start_date = parsed.ms;
+    payload.start_date_time = parsed.hasTime;
   }
   if (opts.assignee !== void 0 || opts.removeAssignee !== void 0) {
     payload.assignees = {};
@@ -2180,12 +2209,14 @@ async function createTask(config, options) {
     payload.priority = parsePriority(options.priority);
   }
   if (options.dueDate !== void 0) {
-    payload.due_date = parseDueDate(options.dueDate, timezone);
-    payload.due_date_time = false;
+    const parsed = parseDueDate(options.dueDate, timezone);
+    payload.due_date = parsed.ms;
+    payload.due_date_time = parsed.hasTime;
   }
   if (options.startDate !== void 0) {
-    payload.start_date = parseDueDate(options.startDate, timezone);
-    payload.start_date_time = false;
+    const parsed = parseDueDate(options.startDate, timezone);
+    payload.start_date = parsed.ms;
+    payload.start_date_time = parsed.hasTime;
   }
   if (options.assignee !== void 0) {
     payload.assignees = [parseAssigneeId(options.assignee)];
@@ -6804,7 +6835,13 @@ async function bulkAssign(config, userIdOrMe, taskIds, action) {
 async function bulkDueDate(config, date, taskIds) {
   const client = new ClickUpClient(config);
   const timezone = await client.getUserTimezone();
-  const payload = date === "none" || date === "clear" ? { due_date: null } : { due_date: parseDueDate(date, timezone), due_date_time: false };
+  let payload;
+  if (date === "none" || date === "clear") {
+    payload = { due_date: null };
+  } else {
+    const parsed = parseDueDate(date, timezone);
+    payload = { due_date: parsed.ms, due_date_time: parsed.hasTime };
+  }
   const outcomes = await runInBatches(
     taskIds,
     BULK_CONCURRENCY,
@@ -6888,7 +6925,7 @@ async function createGoal(config, name, opts) {
   return client.createGoal(config.teamId, name, {
     description: opts?.description,
     color: opts?.color,
-    ...opts?.dueDate ? { dueDate: parseDueDate(opts.dueDate, timezone) } : {}
+    ...opts?.dueDate ? { dueDate: parseDueDate(opts.dueDate, timezone).ms } : {}
   });
 }
 async function updateGoal(config, goalId, updates) {
@@ -7654,7 +7691,13 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
   program.command("update <taskId>").description("Update a task").option("-n, --name <text>", "New task name").option("-d, --description <text>", "New description (markdown supported)").option(
     "-s, --status <status>",
     'New status (fuzzy matched, e.g. "prog" matches "in progress")'
-  ).option("--priority <level>", "Priority: urgent, high, normal, low (or 1-4)").option("--due-date <date>", 'Due date (YYYY-MM-DD, or "none"/"clear" to remove)').option("--start-date <date>", "Start date (YYYY-MM-DD)").option(
+  ).option("--priority <level>", "Priority: urgent, high, normal, low (or 1-4)").option(
+    "--due-date <date>",
+    'Due date (YYYY-MM-DD, YYYY-MM-DDTHH:MM[:SS], or full ISO 8601 with offset; or "none"/"clear" to remove)'
+  ).option(
+    "--start-date <date>",
+    "Start date (YYYY-MM-DD, YYYY-MM-DDTHH:MM[:SS], or full ISO 8601 with offset)"
+  ).option(
     "--time-estimate <duration>",
     'Time estimate (e.g. "2h", "30m", "1h30m", "0" or "none" to clear)'
   ).option("--assignee <userId>", 'Add assignee by user ID or "me"').option("--remove-assignee <userId>", 'Remove assignee by user ID or "me"').option("--parent <taskId>", "Set parent task (makes this a subtask)").option("--detach", "Remove parent task (promote subtask to top-level)").option("--archive", "Archive the task").option("--unarchive", "Unarchive the task").option("--type <type>", "Change task type (name or custom_item_id)").option("--field <nameAndValue...>", 'Set custom field: --field "Name" value').option("--json", "Force JSON output even in terminal").action(
@@ -7704,7 +7747,13 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
       }
     )
   );
-  program.command("create").description("Create a new task").option("-l, --list <listId>", 'Target list ID or "sprint:current" for active sprint').requiredOption("-n, --name <name>", "Task name").option("-d, --description <text>", "Task description (markdown supported)").option("-p, --parent <taskId>", "Parent task ID (list auto-detected from parent)").option("-s, --status <status>", "Initial status").option("--priority <level>", "Priority: urgent, high, normal, low (or 1-4)").option("--due-date <date>", "Due date (YYYY-MM-DD)").option("--start-date <date>", "Start date (YYYY-MM-DD)").option("--assignee <userId>", 'Assignee user ID or "me"').option("--tags <tags>", "Comma-separated tag names").option("--custom-item-id <id>", "Custom task type ID (use to create initiatives)").option("--time-estimate <duration>", 'Time estimate (e.g. "2h", "30m", "1h30m")').option("--template <id>", "Create from a task template (find IDs with cup templates)").option("--field <nameAndValue...>", 'Set custom field: --field "Name" value (can repeat)').option("--json", "Force JSON output even in terminal").action(
+  program.command("create").description("Create a new task").option("-l, --list <listId>", 'Target list ID or "sprint:current" for active sprint').requiredOption("-n, --name <name>", "Task name").option("-d, --description <text>", "Task description (markdown supported)").option("-p, --parent <taskId>", "Parent task ID (list auto-detected from parent)").option("-s, --status <status>", "Initial status").option("--priority <level>", "Priority: urgent, high, normal, low (or 1-4)").option(
+    "--due-date <date>",
+    "Due date (YYYY-MM-DD, YYYY-MM-DDTHH:MM[:SS], or full ISO 8601 with offset)"
+  ).option(
+    "--start-date <date>",
+    "Start date (YYYY-MM-DD, YYYY-MM-DDTHH:MM[:SS], or full ISO 8601 with offset)"
+  ).option("--assignee <userId>", 'Assignee user ID or "me"').option("--tags <tags>", "Comma-separated tag names").option("--custom-item-id <id>", "Custom task type ID (use to create initiatives)").option("--time-estimate <duration>", 'Time estimate (e.g. "2h", "30m", "1h30m")').option("--template <id>", "Create from a task template (find IDs with cup templates)").option("--field <nameAndValue...>", 'Set custom field: --field "Name" value (can repeat)').option("--json", "Force JSON output even in terminal").action(
     wrapAction(async (opts) => {
       const config = loadConfig(getProfileName());
       if (opts.list === "sprint:current") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krodak/clickup-cli",
-  "version": "1.27.1",
+  "version": "1.28.0",
   "description": "ClickUp CLI for AI agents and humans",
   "type": "module",
   "license": "MIT",

package/skills/clickup-cli/SKILL.md

@@ -3,11 +3,11 @@ name: clickup
 description: 'Use when managing ClickUp tasks, sprints, or comments via the `cup` CLI tool. Triggers: task queries, status updates, sprint tracking, creating subtasks, posting comments, threaded replies, standup summaries, searching tasks, checking overdue items, assigning tasks, listing spaces and lists, opening tasks in browser, checking auth or config, setting custom fields, deleting tasks, managing tags, managing checklists, editing comments, task links, time tracking, attachments, file uploads, listing members, listing fields, duplicating tasks, bulk operations, goals, key results, saved filters, favorites.'
 ---
 
-# ClickUp CLI (`cup`) - skill version 1.27.1
+# ClickUp CLI (`cup`) - skill version 1.28.0
 
 Reference for AI agents using the `cup` CLI tool. Covers task management, sprint tracking, comments, time tracking, custom fields, goals, docs, and project workflows.
 
-> **Version check:** Run `cup --version`. If your installed version is older than 1.27.1, update with `npm install -g @krodak/clickup-cli` and refresh this skill with `cup skill`.
+> **Version check:** Run `cup --version`. If your installed version is older than 1.28.0, update with `npm install -g @krodak/clickup-cli` and refresh this skill with `cup skill`.
 
 ## Install & Configure
 
@@ -248,7 +248,7 @@ All commands support `--help` for full flag details. All commands support `--jso
 | Task IDs                 | Native (`abc123def`) or custom (`PROJ-123`). Custom IDs auto-detected by `PREFIX-DIGITS` format                                                                                                                                                                                                                                                    |
 | `--status`               | Fuzzy matching: exact > starts-with > contains. Prints match to stderr                                                                                                                                                                                                                                                                             |
 | `--priority`             | Names (`urgent`, `high`, `normal`, `low`) or numbers (1-4)                                                                                                                                                                                                                                                                                         |
-| `--due-date`             | `YYYY-MM-DD` format                                                                                                                                                                                                                                                                                                                                |
+| `--due-date`             | `YYYY-MM-DD` (date only), `YYYY-MM-DDTHH:MM` (with time), or full ISO 8601 with offset. Time-of-day formats set `due_date_time: true` in ClickUp                                                                                                                                                                                                   |
 | `--assignee`             | User ID or `me`                                                                                                                                                                                                                                                                                                                                    |
 | `--tags`                 | Comma-separated (e.g. `--tags "bug,frontend"`)                                                                                                                                                                                                                                                                                                     |
 | `--time-estimate`        | Duration: `"2h"`, `"30m"`, `"1h30m"`, or raw milliseconds                                                                                                                                                                                                                                                                                          |
@@ -323,6 +323,8 @@ cup inbox --days 7                   # recently updated
 ```bash
 cup update abc123def -s "done"
 cup update abc123def --priority high --due-date 2025-03-15
+cup update abc123def --due-date 2025-03-15T14:30     # date + time (user's timezone)
+cup update abc123def --due-date 2025-03-15T14:30:00Z # UTC
 cup create -n "Fix the thing" -p abc123def
 cup create -n "Fix bug" -l <listId> --priority urgent --tags "bug,frontend"
 cup create -n "Bug fix" -l sprint:current         # create in active sprint