@krodak/clickup-cli 1.45.0 → 1.45.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.45.0",
+  "version": "1.45.2",
   "author": {
     "name": "Krzysztof Rodak"
   },

package/dist/{chunk-ISEGUZ6H.js → chunk-OPPKVJ6P.js}

@@ -269,6 +269,30 @@ async function writeBundleData(root, bundle, opts) {
   ]);
   return { dir, contentHash, attachmentsDownloaded: downloaded, attachmentsFailed: failed };
 }
+async function backfillAttachments(root, taskId, download = defaultDownload) {
+  const dir = taskDir(root, taskId);
+  const file = join(dir, "attachments.json");
+  const entries = JSON.parse(await readFile(file, "utf8"));
+  const pending = entries.filter((a) => !a.local);
+  if (pending.length === 0) return { downloaded: 0, failed: [] };
+  const attDir = join(dir, "attachments");
+  await mkdir(attDir, { recursive: true });
+  const failed = [];
+  let downloaded = 0;
+  for (const att of pending) {
+    const name = safeAttachmentFilename(att.id, att.title);
+    const target = join(attDir, name);
+    try {
+      if (!existsSync(target)) await writeFile(target, await download(att.url));
+      att.local = `attachments/${name}`;
+      downloaded++;
+    } catch (err) {
+      failed.push({ id: att.id, title: att.title, error: err.message });
+    }
+  }
+  await writeFile(file, JSON.stringify(entries, null, 2) + "\n");
+  return { downloaded, failed };
+}
 async function readBundleData(root, taskId) {
   const dir = taskDir(root, taskId);
   const [task, comments, attachments, meta] = await Promise.all([
@@ -318,6 +342,7 @@ export {
   safeAttachmentFilename,
   taskDir,
   writeBundleData,
+  backfillAttachments,
   readBundleData,
   renderBundleMarkdown,
   writeTaskBundle

package/dist/index.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import {
+  backfillAttachments,
   formatDate,
   formatDateISO,
   formatDuration,
@@ -8,7 +9,7 @@ import {
   readBundleData,
   renderBundleMarkdown,
   writeBundleData
-} from "./chunk-ISEGUZ6H.js";
+} from "./chunk-OPPKVJ6P.js";
 
 // src/index.ts
 import { realpathSync as realpathSync2 } from "fs";
@@ -7463,6 +7464,11 @@ function saveManifest(root, manifest) {
   renameSync(tmp, path);
 }
 
+// src/util/plural.ts
+function plural(n, singular, pluralForm = `${singular}s`) {
+  return `${n} ${n === 1 ? singular : pluralForm}`;
+}
+
 // src/export/engine.ts
 function addSlice(manifest, taskId, slice) {
   const entry = manifest.tasks[taskId];
@@ -7502,6 +7508,11 @@ async function runExport(client, plan, opts) {
         try {
           const cached = await readBundleData(opts.root, id);
           for (const s of cached.subtaskIds) enqueue(s);
+          if (opts.downloadAttachments && cached.attachments.length > 0) {
+            const bf = await backfillAttachments(opts.root, id, opts.download);
+            summary.attachmentsDownloaded += bf.downloaded;
+            summary.attachmentsFailed += bf.failed.length;
+          }
         } catch {
           delete manifest.tasks[id];
           toFetch.push(id);
@@ -7540,7 +7551,7 @@ async function runExport(client, plan, opts) {
     const total = touched.size + queue.length;
     const done = summary.fetched + summary.skipped + summary.failed.length;
     opts.log(
-      `[${sliceName}] ${done}/${total} tasks (${summary.fetched} fetched, ${summary.skipped} cached, ${summary.failed.length} failed)`
+      `[${sliceName}] ${done}/${plural(total, "task")} (${summary.fetched} fetched, ${summary.skipped} cached, ${summary.failed.length} failed)`
     );
     if (sinceCheckpoint >= checkpointEvery) {
       saveManifest(opts.root, manifest);
@@ -7628,7 +7639,7 @@ function renderDocReadme(doc, written, location) {
   const lines = [
     `# ${docTitle(doc)}`,
     "",
-    `Doc id: ${doc.id} \xB7 Location: ${location} \xB7 ${written.length} pages`,
+    `Doc id: ${doc.id} \xB7 Location: ${location} \xB7 ${plural(written.length, "page")}`,
     ...doc.date_updated ? [`Last updated: ${new Date(Number(doc.date_updated)).toISOString()}`] : [],
     "",
     "## Pages",
@@ -7646,7 +7657,7 @@ function renderDocsIndex(entries) {
   const lines = [
     "# Docs",
     "",
-    `${entries.length} docs`,
+    plural(entries.length, "doc"),
     "",
     "| Doc | Location | Pages |",
     "| --- | --- | --- |"
@@ -7680,7 +7691,7 @@ async function exportDocs(client, teamId, opts) {
   };
   const summary = { docs: 0, pages: 0, skipped: 0, failed: [] };
   const entries = [];
-  opts.log(`Plan [docs]: ${docs.length} docs in workspace "${teamName}"`);
+  opts.log(`Plan [docs]: ${plural(docs.length, "doc")} in workspace "${teamName}"`);
   for (const doc of docs) {
     const dir = docDirName(doc);
     const location = locationOf(doc);
@@ -7707,7 +7718,7 @@ async function exportDocs(client, teamId, opts) {
       summary.pages += pageCount;
       entries.push({ doc, dir, pages: pageCount, location });
       opts.log(
-        `[docs] ${summary.docs + summary.skipped + summary.failed.length}/${docs.length} ${docTitle(doc)} (${pageCount} pages)`
+        `[docs] ${summary.docs + summary.skipped + summary.failed.length}/${docs.length} ${docTitle(doc)} (${plural(pageCount, "page")})`
       );
     } catch (err) {
       summary.failed.push({ id: doc.id, error: err.message });
@@ -7732,17 +7743,16 @@ function link(task) {
 function assignees(task) {
   return task.assignees.map((a) => a.username).join(", ");
 }
-function typeOf(task, initiativeItemId) {
+function typeOf(task, opts) {
   const id = task.custom_item_id ?? 0;
   if (id === 0) return "task";
-  return initiativeItemId !== void 0 && id === initiativeItemId ? "initiative" : `type ${id}`;
+  if (opts.initiativeItemId !== void 0 && id === opts.initiativeItemId) return "initiative";
+  return opts.typeNames?.[id] ?? `type ${id}`;
 }
-function taskTable(tasks, initiativeItemId) {
+function taskTable(tasks, opts) {
   const lines = ["| Task | Status | Assignees | Type |", "| --- | --- | --- | --- |"];
   for (const t of tasks) {
-    lines.push(
-      `| ${link(t)} | ${t.status.status} | ${assignees(t)} | ${typeOf(t, initiativeItemId)} |`
-    );
+    lines.push(`| ${link(t)} | ${t.status.status} | ${assignees(t)} | ${typeOf(t, opts)} |`);
   }
   return lines;
 }
@@ -7751,22 +7761,21 @@ function renderTeamIndex(hierarchy, tasks, opts) {
   const byList = /* @__PURE__ */ new Map();
   for (const t of topLevel) byList.set(t.list.id, [...byList.get(t.list.id) ?? [], t]);
   const listCount = hierarchy.lists.length + hierarchy.folders.reduce((n, f) => n + f.lists.length, 0);
-  const folderWord = hierarchy.folders.length === 1 ? "folder" : "folders";
   const lines = [
     `# ${hierarchy.space.name} (space)`,
     "",
-    `Exported ${opts.exportedAt.slice(0, 10)} \xB7 ${listCount} lists \xB7 ${hierarchy.folders.length} ${folderWord} \xB7 ${tasks.length} tasks`,
+    `Exported ${opts.exportedAt.slice(0, 10)} \xB7 ${plural(listCount, "list")} \xB7 ${plural(hierarchy.folders.length, "folder")} \xB7 ${plural(tasks.length, "task")}`,
     ""
   ];
   const renderList = (list, level) => {
     const group = byList.get(list.id) ?? [];
     const h = "#".repeat(level);
-    lines.push(`${h} ${list.name} \u2014 ${group.length} tasks`, "");
+    lines.push(`${h} ${list.name} \u2014 ${plural(group.length, "task")}`, "");
     const related = opts.relatedSlices?.filter((s) => s.listId === list.id) ?? [];
     for (const r of related) {
       lines.push(`\u2192 see also [${r.name}](../${r.name}/README.md)`, "");
     }
-    if (group.length > 0) lines.push(...taskTable(group, opts.initiativeItemId), "");
+    if (group.length > 0) lines.push(...taskTable(group, opts), "");
   };
   for (const list of hierarchy.lists) renderList(list, 2);
   for (const folder of hierarchy.folders) {
@@ -7789,7 +7798,7 @@ function renderRoadmapIndex(list, tasks, opts) {
   const lines = [
     `# ${list.name}`,
     "",
-    `Exported ${opts.exportedAt.slice(0, 10)} \xB7 ${initiatives.length} initiatives \xB7 ${tasks.length} tasks`,
+    `Exported ${opts.exportedAt.slice(0, 10)} \xB7 ${plural(initiatives.length, "initiative")} \xB7 ${plural(tasks.length, "task")}`,
     ""
   ];
   const renderTree = (parentId, depth) => {
@@ -7844,7 +7853,7 @@ function renderUserIndex(user, tasks, opts) {
   const lines = [
     `# ${user.username} \u2014 tasks`,
     "",
-    `Exported ${opts.exportedAt.slice(0, 10)} \xB7 ${tasks.length} tasks assigned \xB7 user id ${user.id}`,
+    `Exported ${opts.exportedAt.slice(0, 10)} \xB7 ${plural(tasks.length, "task")} assigned \xB7 user id ${user.id}`,
     ""
   ];
   const open = tasks.filter((t) => !isDoneStatus(t.status.status));
@@ -7910,7 +7919,7 @@ function renderRootReadme(manifest) {
   const lines = [
     `# ClickUp export${ws ? `: ${ws.name}` : ""}`,
     "",
-    `${taskCount} tasks \xB7 ${docCount} docs \xB7 generated by \`cup export\``,
+    `${plural(taskCount, "task")} \xB7 ${plural(docCount, "doc")} \xB7 generated by \`cup export\``,
     "",
     "## Slices",
     "",
@@ -8009,9 +8018,17 @@ function emptySummary(plan, opts) {
     attachmentsFailed: 0
   };
 }
+async function fetchTypeNames(client, teamId) {
+  try {
+    const types = await client.getCustomTaskTypes(teamId);
+    return Object.fromEntries(types.map((t) => [t.id, t.name]));
+  } catch {
+    return {};
+  }
+}
 function describePlan(plan) {
   const initiatives = plan.tasks.filter((t) => t.initiative).length;
-  return `Plan [${plan.slice.name}]: ${plan.tasks.length} tasks (${initiatives} initiatives) in workspace "${plan.workspace.name}"`;
+  return `Plan [${plan.slice.name}]: ${plural(plan.tasks.length, "task")} (${plural(initiatives, "initiative")}) in workspace "${plan.workspace.name}"`;
 }
 async function execute(client, teamId, plan, opts, writeIndex) {
   opts.log(describePlan(plan));
@@ -8052,7 +8069,7 @@ async function exportUser(config, userRef, opts) {
   });
 }
 function formatExportSummary(s) {
-  if (s.dryRun) return `Dry run: ${s.planned} tasks would be exported to ${s.out}`;
+  if (s.dryRun) return `Dry run: ${plural(s.planned, "task")} would be exported to ${s.out}`;
   const lines = [
     `Exported slice "${s.slice}" to ${s.out}`,
     `  tasks: ${s.fetched} fetched, ${s.skipped} already present, ${s.failed.length} failed`,
@@ -8076,13 +8093,15 @@ async function exportTeam(config, spaceRef, opts) {
     const manifest = loadManifest(root);
     const relatedSlices = Object.entries(manifest.slices).filter(([, s]) => s.kind === "roadmap" || s.kind === "initiatives").map(([name, s]) => ({ name, listId: s.scope }));
     const tasks = Object.values(plan.tasksById ?? {});
+    const typeNames = await fetchTypeNames(client, teamId);
     writeSliceFiles(
       root,
       plan.slice.name,
       renderTeamIndex(plan.hierarchy, tasks, {
         exportedAt: (/* @__PURE__ */ new Date()).toISOString(),
         relatedSlices,
-        initiativeItemId: opts.initiativeItemId
+        initiativeItemId: opts.initiativeItemId,
+        typeNames
       }),
       { hierarchy: plan.hierarchy, taskIds: plan.tasks.map((t) => t.id) }
     );
@@ -8122,7 +8141,7 @@ async function exportInitiatives(config, listId, opts) {
     initiativeItemId: opts.initiativeItemId
   });
   return execute(client, teamId, plan, opts, async (root) => {
-    const { readBundleData: readBundleData2 } = await import("./writer-EYKGCPNB.js");
+    const { readBundleData: readBundleData2 } = await import("./writer-UZHLSQMW.js");
     const manifest = loadManifest(root);
     const wanted = /* @__PURE__ */ new Set();
     const queue = plan.tasks.map((t) => t.id);
@@ -8157,7 +8176,7 @@ async function exportDocs2(config, opts) {
   const root = resolve(opts.out);
   if (opts.dryRun) {
     const docs = await client.getAllDocs(teamId);
-    opts.log(`Plan [docs]: ${docs.length} docs`);
+    opts.log(`Plan [docs]: ${plural(docs.length, "doc")}`);
     return {
       slice: "docs",
       out: root,
@@ -8177,7 +8196,7 @@ async function exportDocs2(config, opts) {
   return { slice: "docs", out: root, dryRun: false, ...summary };
 }
 function formatDocsSummary(s) {
-  if (s.dryRun) return `Dry run: ${s.docs} docs would be exported to ${s.out}`;
+  if (s.dryRun) return `Dry run: ${plural(s.docs, "doc")} would be exported to ${s.out}`;
   const lines = [
     `Exported docs to ${s.out}/docs`,
     `  docs: ${s.docs} fetched (${s.pages} pages), ${s.skipped} already present, ${s.failed.length} failed`
@@ -8210,9 +8229,9 @@ async function exportAll(config, opts) {
   const estMinutes = Math.ceil(estRequests / opts.rpm);
   opts.log(`Workspace export plan for "${workspaceName}":`);
   opts.log(
-    `  ${spaces.length} spaces, ${listCount} lists, ${allTaskIds.size} tasks, ${docs.length} docs`
+    `  ${plural(spaces.length, "space")}, ${plural(listCount, "list")}, ${plural(allTaskIds.size, "task")}, ${plural(docs.length, "doc")}`
   );
-  opts.log(`  Already exported: ${alreadyExported} tasks (will be skipped)`);
+  opts.log(`  Already exported: ${plural(alreadyExported, "task")} (will be skipped)`);
   opts.log(`  Estimated requests: ~${estRequests}`);
   opts.log(
     `  Estimated time at ${opts.rpm} req/min: ~${estMinutes < 60 ? `${estMinutes}m` : `${Math.floor(estMinutes / 60)}h ${estMinutes % 60}m`}`
@@ -8246,6 +8265,7 @@ async function exportAll(config, opts) {
     if (!ok) throw new Error("Cancelled");
   }
   const spaceNames = Object.fromEntries(spaces.map((s) => [s.id, s.name]));
+  const typeNames = await fetchTypeNames(client, teamId);
   const summary = { ...empty };
   for (const plan of plans) {
     const run2 = await runExport(client, plan, {
@@ -8267,7 +8287,8 @@ async function exportAll(config, opts) {
       plan.slice.name,
       renderTeamIndex(plan.hierarchy, tasks, {
         exportedAt: (/* @__PURE__ */ new Date()).toISOString(),
-        initiativeItemId: opts.initiativeItemId
+        initiativeItemId: opts.initiativeItemId,
+        typeNames
       }),
       { hierarchy: plan.hierarchy, taskIds: plan.tasks.map((t) => t.id) }
     );
@@ -8278,7 +8299,7 @@ async function exportAll(config, opts) {
 }
 function formatAllSummary(s) {
   if (s.dryRun)
-    return `Dry run: ${s.planned} tasks across ${s.spaces.length} spaces would be exported to ${s.out}`;
+    return `Dry run: ${plural(s.planned, "task")} across ${plural(s.spaces.length, "space")} would be exported to ${s.out}`;
   const lines = [
     `Exported workspace to ${s.out}`,
     `  spaces: ${s.spaces.length} (${s.spaces.join(", ")})`,

package/dist/{writer-EYKGCPNB.js → writer-UZHLSQMW.js}

@@ -1,13 +1,15 @@
 #!/usr/bin/env node
 import {
+  backfillAttachments,
   readBundleData,
   renderBundleMarkdown,
   safeAttachmentFilename,
   taskDir,
   writeBundleData,
   writeTaskBundle
-} from "./chunk-ISEGUZ6H.js";
+} from "./chunk-OPPKVJ6P.js";
 export {
+  backfillAttachments,
   readBundleData,
   renderBundleMarkdown,
   safeAttachmentFilename,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krodak/clickup-cli",
-  "version": "1.45.0",
+  "version": "1.45.2",
   "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.45.0
+# ClickUp CLI (`cup`) - skill version 1.45.2
 
 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.45.0, 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.45.2, update with `npm install -g @krodak/clickup-cli` and refresh this skill with `cup skill`.
 
 ## Install & Configure
 
@@ -434,7 +434,7 @@ Every task stored once (`tasks/<id>/task.json` + `task.md` + comments + attachme
 
 ```bash
 cup export user me --out ./archive                    # my tasks, incl. closed + archived
-cup export team "Kayenta" --out ./archive             # every list in a space
+cup export team "Atlas" --out ./archive             # every list in a space
 cup export roadmap <listId> --item-id 1004 --out ./archive   # initiatives grouped with subtask trees
 cup export docs --out ./archive                       # every doc as markdown page trees
 cup export all --dry-run                              # plan: counts, estimated time