@krodak/clickup-cli 1.19.0 → 1.19.2

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.19.0",
+  "version": "1.19.2",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/dist/{chunk-XAXTPUJP.js → chunk-NIDL2AXQ.js}

@@ -227,6 +227,9 @@ var ClickUpClient = class {
   async getTask(taskId) {
     return this.request(this.taskPath(taskId, "?include_markdown_description=true"));
   }
+  async getTimeInStatus(taskId) {
+    return this.request(this.taskPath(taskId, "/time_in_status"));
+  }
   async createTask(listId, options) {
     return this.request(`/list/${listId}/task`, {
       method: "POST",
@@ -672,7 +675,7 @@ var ClickUpClient = class {
   }
   async getDocPageListing(workspaceId, docId) {
     const data = await this.requestV3(
-      `/workspaces/${workspaceId}/docs/${docId}/pagelisting`
+      `/workspaces/${workspaceId}/docs/${docId}/pages`
     );
     return readCollectionField(
       data,
@@ -1283,6 +1286,18 @@ function formatDuration(ms) {
   if (hours > 0) return `${hours}h`;
   return `${minutes}m`;
 }
+function formatLongDuration(ms) {
+  const totalMinutes = Math.round(Math.abs(ms) / 6e4);
+  if (totalMinutes === 0) return "< 1m";
+  const days = Math.floor(totalMinutes / 1440);
+  const hours = Math.floor(totalMinutes % 1440 / 60);
+  const minutes = totalMinutes % 60;
+  const parts = [];
+  if (days > 0) parts.push(`${days}d`);
+  if (hours > 0) parts.push(`${hours}h`);
+  if (minutes > 0) parts.push(`${minutes}m`);
+  return parts.join(" ");
+}
 function formatDateISO(ms) {
   const d = new Date(Number(ms));
   const year = d.getUTCFullYear();
@@ -1990,10 +2005,12 @@ export {
   formatDate,
   formatTimestamp,
   formatDuration,
+  formatLongDuration,
   formatDateISO,
   isTTY,
   shouldOutputJson,
   formatTable,
+  colorStatus,
   TASK_COLUMNS,
   formatMarkdownTable,
   formatCommentsMarkdown,

package/dist/index.js

@@ -5,6 +5,7 @@ import {
   TASK_COLUMNS,
   addProfile,
   buildTypeMap,
+  colorStatus,
   deleteFavorite,
   deleteFilter,
   fetchMyTasks,
@@ -18,6 +19,7 @@ import {
   formatDuration,
   formatGroupedTasksMarkdown,
   formatListsMarkdown,
+  formatLongDuration,
   formatMarkdownTable,
   formatSpacesMarkdown,
   formatTable,
@@ -47,7 +49,7 @@ import {
   showDetailsAndOpen,
   summarize,
   writeConfig
-} from "./chunk-XAXTPUJP.js";
+} from "./chunk-NIDL2AXQ.js";
 
 // src/index.ts
 import { realpathSync as realpathSync2 } from "fs";
@@ -1022,6 +1024,84 @@ ${commentsMd}`);
   }
 }
 
+// src/commands/time-in-status.ts
+import chalk5 from "chalk";
+function transformResponse(taskId, data) {
+  const entries = [];
+  for (const entry of data.status_history ?? []) {
+    const ms = (entry.total_time?.by_minute ?? 0) * 6e4;
+    entries.push({
+      status: entry.status,
+      duration: formatLongDuration(ms),
+      durationMs: ms,
+      current: false
+    });
+  }
+  if (data.current_status) {
+    const ms = (data.current_status.total_time?.by_minute ?? 0) * 6e4;
+    const existing = entries.find((e) => e.status === data.current_status.status);
+    if (existing) {
+      existing.current = true;
+    } else {
+      entries.push({
+        status: data.current_status.status,
+        duration: formatLongDuration(ms),
+        durationMs: ms,
+        current: true
+      });
+    }
+  }
+  const totalMs = entries.reduce((sum, e) => sum + e.durationMs, 0);
+  return { taskId, statuses: entries, totalMs, total: formatLongDuration(totalMs) };
+}
+async function fetchTimeInStatus(config, taskId) {
+  const client = new ClickUpClient(config);
+  let data;
+  try {
+    data = await client.getTimeInStatus(taskId);
+  } catch (err) {
+    if (err instanceof Error && /No data for TIS/i.test(err.message)) {
+      throw new Error(
+        'The "Time in Status" ClickApp is not enabled for this workspace.\nEnable it in ClickUp: Space Settings \u2192 ClickApps \u2192 Time in Status',
+        { cause: err }
+      );
+    }
+    throw err;
+  }
+  return transformResponse(taskId, data);
+}
+function printTimeInStatus(result, forceJson) {
+  if (shouldOutputJson(forceJson)) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  const rows = result.statuses.map((s) => ({
+    status: s.status,
+    duration: s.duration,
+    current: s.current ? "*" : ""
+  }));
+  if (!isTTY()) {
+    const mdColumns = [
+      { key: "status", label: "Status" },
+      { key: "duration", label: "Duration" },
+      { key: "current", label: "Current" }
+    ];
+    const table = formatMarkdownTable(rows, mdColumns);
+    console.log(`${table}
+
+**Total:** ${result.total}`);
+    return;
+  }
+  const columns = [
+    { key: "status", label: "STATUS", maxWidth: 25, format: (v) => colorStatus(v) },
+    { key: "duration", label: "DURATION" },
+    { key: "current", label: "", format: (v) => v ? chalk5.green("\u25C0") : "" }
+  ];
+  console.log(formatTable(rows, columns));
+  console.log("");
+  console.log(`${chalk5.bold("Total:")} ${result.total}`);
+}
+
 // src/commands/metadata.ts
 var commandMetadata = [
   {
@@ -1455,6 +1535,18 @@ var commandMetadata = [
       { section: "write", usage: "time delete <timeEntryId>", description: "Delete a time entry" }
     ]
   },
+  {
+    name: "time-in-status",
+    description: "Show how long a task has been in each status",
+    flags: ["--json"],
+    quickReference: [
+      {
+        section: "read",
+        usage: "time-in-status <taskId>",
+        description: "Show how long a task has been in each status"
+      }
+    ]
+  },
   {
     name: "docs",
     description: "List workspace docs (optionally filter by name)",
@@ -2924,7 +3016,7 @@ function generateCompletion(shell, name = "cup") {
 import { readFileSync, realpathSync, mkdirSync, copyFileSync, existsSync } from "fs";
 import { join, dirname } from "path";
 import { homedir } from "os";
-import chalk5 from "chalk";
+import chalk6 from "chalk";
 function skillPath() {
   if (!process.argv[1]) {
     throw new Error("Cannot determine install path. Run with: cup skill");
@@ -2958,11 +3050,10 @@ async function installSkillInteractive() {
   const installed = [];
   if (isTTY()) {
     const { checkbox } = await import("@inquirer/prompts");
-    const preselected = targets.filter((t) => t.detected).map((t) => t.name);
     const selected = await checkbox({
       message: "Install skill for which agents?",
       choices: targets.map((t) => ({
-        name: `${t.name}${t.detected ? chalk5.dim(" (detected)") : ""}`,
+        name: `${t.name}${t.detected ? chalk6.dim(" (detected)") : ""}`,
         value: t.name,
         checked: t.detected
       }))
@@ -3280,7 +3371,7 @@ async function manageTags(config, taskId, opts) {
 }
 
 // src/commands/checklist.ts
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 async function viewChecklists(config, taskId) {
   const client = new ClickUpClient(config);
   const task = await client.getTask(taskId);
@@ -3313,14 +3404,14 @@ function formatChecklists(checklists) {
   const lines = [];
   for (const cl of checklists) {
     const resolved = cl.items.filter((i) => i.resolved).length;
-    lines.push(chalk6.bold(`${cl.name} (${resolved}/${cl.items.length})`));
-    lines.push(chalk6.dim(`  ID: ${cl.id}`));
+    lines.push(chalk7.bold(`${cl.name} (${resolved}/${cl.items.length})`));
+    lines.push(chalk7.dim(`  ID: ${cl.id}`));
     for (const item of cl.items) {
-      const check = item.resolved ? chalk6.green("[x]") : chalk6.dim("[ ]");
-      const name = item.resolved ? chalk6.dim(item.name) : item.name;
-      const assignee = item.assignee ? chalk6.dim(` @${item.assignee.username}`) : "";
+      const check = item.resolved ? chalk7.green("[x]") : chalk7.dim("[ ]");
+      const name = item.resolved ? chalk7.dim(item.name) : item.name;
+      const assignee = item.assignee ? chalk7.dim(` @${item.assignee.username}`) : "";
       lines.push(`  ${check} ${name}${assignee}`);
-      lines.push(chalk6.dim(`      item-id: ${item.id}`));
+      lines.push(chalk7.dim(`      item-id: ${item.id}`));
     }
   }
   return lines.join("\n");
@@ -3379,7 +3470,7 @@ async function deleteCommentByTaskSelection(config, taskId, options) {
 }
 
 // src/commands/replies.ts
-import chalk7 from "chalk";
+import chalk8 from "chalk";
 async function getReplies(config, commentId) {
   const client = new ClickUpClient(config);
   return client.getThreadedComments(commentId);
@@ -3394,7 +3485,7 @@ function formatReplies(replies) {
   return replies.map((r) => {
     const user = r.user?.username ?? "Unknown";
     const date = formatTimestamp(Number(r.date));
-    return `${chalk7.bold(user)} ${chalk7.dim(date)}
+    return `${chalk8.bold(user)} ${chalk8.dim(date)}
   ${r.comment_text}`;
   }).join("\n\n");
 }
@@ -3457,7 +3548,7 @@ function formatDocsMarkdown(docs) {
 }
 
 // src/commands/doc.ts
-import chalk8 from "chalk";
+import chalk9 from "chalk";
 async function getDocInfo(config, docId) {
   const client = new ClickUpClient(config);
   const [doc, pages] = await Promise.all([
@@ -3469,14 +3560,14 @@ async function getDocInfo(config, docId) {
 function formatDocInfo(doc, pages, indent = 0) {
   const lines = [];
   if (indent === 0) {
-    lines.push(`${chalk8.bold(doc.name)} ${chalk8.dim(doc.id)}`);
+    lines.push(`${chalk9.bold(doc.name)} ${chalk9.dim(doc.id)}`);
     if (pages.length === 0) {
       lines.push("  (no pages)");
     }
   }
   for (const page of pages) {
     const prefix = "  ".repeat(indent + 1);
-    lines.push(`${prefix}${page.name} ${chalk8.dim(page.id)}`);
+    lines.push(`${prefix}${page.name} ${chalk9.dim(page.id)}`);
     if (page.pages && page.pages.length > 0) {
       lines.push(formatDocInfo(doc, page.pages, indent + 1));
     }
@@ -3555,7 +3646,7 @@ async function deleteDocPage(config, docId, pageId) {
 }
 
 // src/commands/folders.ts
-import chalk9 from "chalk";
+import chalk10 from "chalk";
 async function listFolders(config, spaceId, nameFilter) {
   const client = new ClickUpClient(config);
   const folders = await client.getFolders(spaceId);
@@ -3574,9 +3665,9 @@ async function listFolders(config, spaceId, nameFilter) {
 function formatFolders(folders) {
   if (folders.length === 0) return "No folders found";
   return folders.map((f) => {
-    const header = `${chalk9.bold(f.name)} ${chalk9.dim(f.id)}`;
+    const header = `${chalk10.bold(f.name)} ${chalk10.dim(f.id)}`;
     if (f.lists.length === 0) return header;
-    const listLines = f.lists.map((l) => `  ${chalk9.dim(">")} ${l.name} ${chalk9.dim(l.id)}`);
+    const listLines = f.lists.map((l) => `  ${chalk10.dim(">")} ${l.name} ${chalk10.dim(l.id)}`);
     return [header, ...listLines].join("\n");
   }).join("\n\n");
 }
@@ -3591,13 +3682,13 @@ function formatFoldersMarkdown(folders) {
 }
 
 // src/commands/time.ts
-import chalk10 from "chalk";
+import chalk11 from "chalk";
 var TIME_COLUMNS = [
   { key: "task", label: "Task", maxWidth: 35 },
   { key: "duration", label: "Duration", maxWidth: 10 },
   { key: "date", label: "Date", maxWidth: 20 },
   { key: "description", label: "Description", maxWidth: 30 },
-  { key: "status", label: "", maxWidth: 10, format: (v) => v === "RUNNING" ? chalk10.green(v) : "" }
+  { key: "status", label: "", maxWidth: 10, format: (v) => v === "RUNNING" ? chalk11.green(v) : "" }
 ];
 async function startTimer(config, taskId, description) {
   const client = new ClickUpClient(config);
@@ -3693,7 +3784,7 @@ function formatTimeEntriesMarkdown(entries) {
 }
 
 // src/commands/tags.ts
-import chalk11 from "chalk";
+import chalk12 from "chalk";
 var TAG_COLUMNS = [
   { key: "name", label: "Name", maxWidth: 40 },
   { key: "fg", label: "FG", maxWidth: 10 },
@@ -3726,13 +3817,13 @@ function formatTags(tags) {
   if (tags.length === 0) return "No tags found";
   if (isTTY()) {
     const rows = tags.map((t) => ({
-      name: t.tag_bg ? chalk11.bgHex(t.tag_bg).hex(t.tag_fg || "#ffffff")(` ${t.name} `) : chalk11.bold(t.name),
+      name: t.tag_bg ? chalk12.bgHex(t.tag_bg).hex(t.tag_fg || "#ffffff")(` ${t.name} `) : chalk12.bold(t.name),
       fg: t.tag_fg || "",
       bg: t.tag_bg || ""
     }));
     return formatTable(rows, TAG_COLUMNS);
   }
-  return tags.map((t) => chalk11.bold(t.name)).join(", ");
+  return tags.map((t) => chalk12.bold(t.name)).join(", ");
 }
 function formatTagsMarkdown(tags) {
   if (tags.length === 0) return "No tags found";
@@ -3767,7 +3858,7 @@ function formatMembersMarkdown(members) {
 }
 
 // src/commands/fields.ts
-import chalk12 from "chalk";
+import chalk13 from "chalk";
 var FIELD_COLUMNS = [
   { key: "id", label: "ID", maxWidth: 20 },
   { key: "name", label: "Name", maxWidth: 30 },
@@ -3776,7 +3867,7 @@ var FIELD_COLUMNS = [
     key: "required",
     label: "Required",
     maxWidth: 10,
-    format: (v) => v === "yes" ? chalk12.yellow(v) : chalk12.dim(v)
+    format: (v) => v === "yes" ? chalk13.yellow(v) : chalk13.dim(v)
   },
   { key: "options", label: "Options", maxWidth: 40 }
 ];
@@ -3883,13 +3974,13 @@ async function bulkTag(config, tagName, taskIds, action) {
 }
 
 // src/commands/goals.ts
-import chalk13 from "chalk";
+import chalk14 from "chalk";
 function colorProgress(value) {
   const num = parseInt(value, 10);
   if (isNaN(num)) return value;
-  if (num >= 75) return chalk13.green(value);
-  if (num >= 25) return chalk13.yellow(value);
-  return chalk13.red(value);
+  if (num >= 75) return chalk14.green(value);
+  if (num >= 25) return chalk14.yellow(value);
+  return chalk14.red(value);
 }
 var GOAL_COLUMNS = [
   { key: "id", label: "ID", maxWidth: 15 },
@@ -3983,14 +4074,14 @@ function formatKeyResultsMarkdown(keyResults) {
 }
 
 // src/commands/task-types.ts
-import chalk14 from "chalk";
+import chalk15 from "chalk";
 async function listTaskTypes(config) {
   const client = new ClickUpClient(config);
   return client.getCustomTaskTypes(config.teamId);
 }
 function formatTaskTypes(types) {
   if (types.length === 0) return "No custom task types";
-  return types.map((t) => `${chalk14.bold(t.name)} ${chalk14.dim(`(${t.id})`)}`).join("\n");
+  return types.map((t) => `${chalk15.bold(t.name)} ${chalk15.dim(`(${t.id})`)}`).join("\n");
 }
 function formatTaskTypesMarkdown(types) {
   if (types.length === 0) return "No custom task types";
@@ -3998,14 +4089,14 @@ function formatTaskTypesMarkdown(types) {
 }
 
 // src/commands/templates.ts
-import chalk15 from "chalk";
+import chalk16 from "chalk";
 async function listTemplates(config) {
   const client = new ClickUpClient(config);
   return client.getTaskTemplates(config.teamId);
 }
 function formatTemplates(templates) {
   if (templates.length === 0) return "No task templates";
-  return templates.map((t) => `${chalk15.bold(t.name)} ${chalk15.dim(`(${t.id})`)}`).join("\n");
+  return templates.map((t) => `${chalk16.bold(t.name)} ${chalk16.dim(`(${t.id})`)}`).join("\n");
 }
 function formatTemplatesMarkdown(templates) {
   if (templates.length === 0) return "No task templates";
@@ -4013,14 +4104,14 @@ function formatTemplatesMarkdown(templates) {
 }
 
 // src/commands/list-templates.ts
-import chalk16 from "chalk";
+import chalk17 from "chalk";
 async function listListTemplates(config) {
   const client = new ClickUpClient(config);
   return client.getListTemplates(config.teamId);
 }
 function formatListTemplates(templates) {
   if (templates.length === 0) return "No list templates";
-  return templates.map((t) => `${chalk16.bold(t.name)} ${chalk16.dim(`(${t.id})`)}`).join("\n");
+  return templates.map((t) => `${chalk17.bold(t.name)} ${chalk17.dim(`(${t.id})`)}`).join("\n");
 }
 function formatListTemplatesMarkdown(templates) {
   if (templates.length === 0) return "No list templates";
@@ -4028,14 +4119,14 @@ function formatListTemplatesMarkdown(templates) {
 }
 
 // src/commands/folder-templates.ts
-import chalk17 from "chalk";
+import chalk18 from "chalk";
 async function listFolderTemplates(config) {
   const client = new ClickUpClient(config);
   return client.getFolderTemplates(config.teamId);
 }
 function formatFolderTemplates(templates) {
   if (templates.length === 0) return "No folder templates";
-  return templates.map((t) => `${chalk17.bold(t.name)} ${chalk17.dim(`(${t.id})`)}`).join("\n");
+  return templates.map((t) => `${chalk18.bold(t.name)} ${chalk18.dim(`(${t.id})`)}`).join("\n");
 }
 function formatFolderTemplatesMarkdown(templates) {
   if (templates.length === 0) return "No folder templates";
@@ -4058,7 +4149,7 @@ async function createListFromTemplate(config, name, opts) {
 }
 
 // src/commands/views.ts
-import chalk18 from "chalk";
+import chalk19 from "chalk";
 async function listViews(config, id, container = "list") {
   const client = new ClickUpClient(config);
   if (container === "space") return client.getSpaceViews(id);
@@ -4069,7 +4160,7 @@ async function listViews(config, id, container = "list") {
 }
 function formatViews(views) {
   if (views.length === 0) return "No views";
-  return views.map((v) => `${chalk18.bold(v.name)} ${chalk18.dim(`(${v.id})`)} ${chalk18.dim(v.type)}`).join("\n");
+  return views.map((v) => `${chalk19.bold(v.name)} ${chalk19.dim(`(${v.id})`)} ${chalk19.dim(v.type)}`).join("\n");
 }
 function formatViewsMarkdown(views) {
   if (views.length === 0) return "No views";
@@ -4077,20 +4168,20 @@ function formatViewsMarkdown(views) {
 }
 
 // src/commands/view.ts
-import chalk19 from "chalk";
+import chalk20 from "chalk";
 async function getView(config, viewId) {
   const client = new ClickUpClient(config);
   return client.getView(viewId);
 }
 function formatView(view) {
   const lines = [];
-  lines.push(chalk19.bold.underline(view.name));
+  lines.push(chalk20.bold.underline(view.name));
   lines.push("");
-  lines.push(`  ${chalk19.bold("ID")}     ${view.id}`);
-  lines.push(`  ${chalk19.bold("Type")}   ${view.type}`);
-  if (view.visibility) lines.push(`  ${chalk19.bold("Visibility")} ${view.visibility}`);
-  if (view.date_created) lines.push(`  ${chalk19.bold("Created")} ${formatDate(view.date_created)}`);
-  if (view.protected !== void 0) lines.push(`  ${chalk19.bold("Protected")} ${view.protected}`);
+  lines.push(`  ${chalk20.bold("ID")}     ${view.id}`);
+  lines.push(`  ${chalk20.bold("Type")}   ${view.type}`);
+  if (view.visibility) lines.push(`  ${chalk20.bold("Visibility")} ${view.visibility}`);
+  if (view.date_created) lines.push(`  ${chalk20.bold("Created")} ${formatDate(view.date_created)}`);
+  if (view.protected !== void 0) lines.push(`  ${chalk20.bold("Protected")} ${view.protected}`);
   return lines.join("\n");
 }
 function formatViewMarkdown(view) {
@@ -4528,7 +4619,7 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
     wrapAction(async (opts) => {
       const config = loadConfig(getProfileName());
       if (opts.list === "sprint:current") {
-        const { resolveActiveSprintListId } = await import("./sprint-7S5UOUQX.js");
+        const { resolveActiveSprintListId } = await import("./sprint-HVK63FZI.js");
         opts.list = await resolveActiveSprintListId(config);
       }
       if (opts.assignee === "me") {
@@ -4661,6 +4752,13 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
       printActivity(result, opts.json ?? false);
     })
   );
+  program.command("time-in-status <taskId>").description("Show how long a task has been in each status").option("--json", "Force JSON output even in terminal").action(
+    wrapAction(async (taskId, opts) => {
+      const config = loadConfig(getProfileName());
+      const result = await fetchTimeInStatus(config, taskId);
+      printTimeInStatus(result, opts.json ?? false);
+    })
+  );
   program.command("lists <spaceId>").description("List all lists in a space (including lists inside folders)").option("--name <partial>", "Filter by name (case-insensitive contains)").option("--json", "Force JSON output even in terminal").action(
     wrapAction(async (spaceId, opts) => {
       const config = loadConfig(getProfileName());
@@ -4842,7 +4940,7 @@ function buildProgram(programName = basename(process.argv[1] ?? "cup")) {
     wrapAction(async (taskId, opts) => {
       const config = loadConfig(getProfileName());
       if (opts.to === "sprint:current") {
-        const { resolveActiveSprintListId } = await import("./sprint-7S5UOUQX.js");
+        const { resolveActiveSprintListId } = await import("./sprint-HVK63FZI.js");
         opts.to = await resolveActiveSprintListId(config);
       }
       const message = await moveTask(config, taskId, opts);

package/dist/{sprint-7S5UOUQX.js → sprint-HVK63FZI.js}

@@ -7,7 +7,7 @@ import {
   parseSprintDates,
   resolveActiveSprintListId,
   runSprintCommand
-} from "./chunk-XAXTPUJP.js";
+} from "./chunk-NIDL2AXQ.js";
 export {
   SPRINT_KEYWORDS,
   extractSpaceKeywords,

package/package.json

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