@kb-labs/clickup-entry 2.96.0

package/dist/commands/task-create.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/error.ts","../../src/commands/task-create.ts"],"names":[],"mappings":"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","file":"task-create.js","sourcesContent":["import type { PluginContextV3 } from '@kb-labs/sdk';\nimport { ClickUpApiError } from '@kb-labs/clickup-core';\n\nexport { validationError } from '@kb-labs/sdk';\n\nfunction apiHint(err: ClickUpApiError): string {\n  switch (err.status) {\n    case 401: return 'CLICKUP_API_KEY is invalid or expired — check the token in your environment';\n    case 403: return 'You don\\'t have permission for this action in ClickUp — check workspace access';\n    case 404: return 'Resource not found — verify the ID is correct (use `kb clickup workspace` to browse IDs)';\n    case 429: return 'ClickUp rate limit reached — wait a moment and retry';\n    default:  return 'Unexpected ClickUp API error';\n  }\n}\n\n/**\n * Output a structured error and return — call right before `return { exitCode: 1, result: null }`.\n * In JSON mode emits `{ ok: false, error: { code, message, hint?, status? } }`.\n * In CLI mode uses ctx.ui.error() with hint and cause.\n */\nexport function handleError(ctx: PluginContextV3, err: unknown, isJson?: boolean): void {\n  if (err instanceof ClickUpApiError) {\n    const hint = apiHint(err);\n    if (isJson) {\n      ctx.ui?.json?.({ ok: false, error: { code: err.code, message: err.message, status: err.status, hint } });\n    } else {\n      ctx.ui?.error?.(err.message, { hint, cause: `ClickUp API ${err.status} (${err.code})` });\n    }\n    return;\n  }\n\n  const message = err instanceof Error ? err.message : String(err);\n  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);\n\n  if (isJson) {\n    ctx.ui?.json?.({\n      ok: false,\n      error: {\n        code: isEnvMissing ? 'ENV_MISSING' : 'INTERNAL_ERROR',\n        message,\n        ...(isEnvMissing && {\n          hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables',\n        }),\n      },\n    });\n  } else {\n    ctx.ui?.error?.(message, {\n      ...(isEnvMissing && {\n        hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables',\n        command: 'export CLICKUP_API_KEY=pk_xxx CLICKUP_TEAM_ID=yyy',\n      }),\n    });\n  }\n}\n\n/**\n * Re-throws `err` as an HTTP-aware error for REST handlers.\n * `ClickUpApiError` → preserves HTTP status code; env errors → 400; others → 500.\n * The envelope middleware in rest-api reads `err.statusCode` to set the response status.\n */\nexport function rethrowForRest(err: unknown): never {\n  if (err instanceof ClickUpApiError) {\n    const hint = apiHint(err);\n    const restErr = Object.assign(new Error(err.message), {\n      statusCode: err.status,\n      code: err.code,\n      details: { hint },\n    });\n    throw restErr;\n  }\n  const message = err instanceof Error ? err.message : String(err);\n  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);\n  if (isEnvMissing) {\n    throw Object.assign(new Error(message), {\n      statusCode: 400,\n      code: 'ENV_MISSING',\n      details: { hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables' },\n    });\n  }\n  throw err;\n}\n","import { defineCommand, type CLIInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { requireApiKey, createTask } from '@kb-labs/clickup-core';\nimport { handleError, validationError } from '../utils/error.js';\n\ntype TaskCreateFlags = {\n  list: string;\n  name: string;\n  desc?: string;\n  status?: string;\n  priority?: number;\n  assignee?: string;\n  due?: string;\n  parent?: string;\n  json?: boolean;\n  full?: boolean;\n  'dry-run'?: boolean;\n};\n\nfunction parseDue(due: string): number | undefined {\n  const n = Number(due);\n  if (!isNaN(n) && n > 0) return n;\n  const d = new Date(due);\n  if (!isNaN(d.getTime())) return d.getTime();\n  return undefined;\n}\n\nexport default defineCommand({\n  id: 'clickup:task.create',\n  description: 'Create a new task',\n\n  handler: {\n    async intent(_ctx: PluginContextV3, input: CLIInput<TaskCreateFlags>) {\n      const { list, name } = input.flags;\n      return {\n        summary: `Create task \"${name ?? '(unnamed)'}\" in list ${list ?? '(unknown)'}`,\n        operations: [{ type: 'create' as const, resource: 'task', details: { list, name } }],\n      };\n    },\n\n    async execute(ctx: PluginContextV3, input: CLIInput<TaskCreateFlags>) {\n      const { list, name, desc, status, priority, assignee, due, parent, json, full } = input.flags;\n\n      if (!list) {\n        validationError(ctx, '--list is required', 'Use `kb clickup list tasks <listId>` to find the list ID', json);\n        return { exitCode: 1, result: null };\n      }\n      if (!name) {\n        validationError(ctx, '--name is required', undefined, json);\n        return { exitCode: 1, result: null };\n      }\n\n      try {\n        const task = await createTask(requireApiKey(), list, {\n          name,\n          markdown_content: desc?.replace(/\\\\n/g, '\\n'),\n          status,\n          priority,\n          assignees: assignee ? assignee.split(',').map(Number) : undefined,\n          due_date: due ? parseDue(due) : undefined,\n          parent,\n        });\n\n        if (json) {\n          ctx.ui?.json?.(full ? task : { id: task.id, name: task.name, status: task.status.status, url: task.url });\n        } else {\n          ctx.ui?.success?.('Task created', {\n            sections: [{\n              items: [\n                `id: ${task.id}`,\n                `name: ${task.name}`,\n                `status: ${task.status.status}`,\n                `url: ${task.url}`,\n              ],\n            }],\n          });\n        }\n\n        return { exitCode: 0, result: task };\n      } catch (err) {\n        handleError(ctx, err, json);\n        return { exitCode: 1, result: null };\n      }\n    },\n  },\n});\n"]}

package/dist/commands/task-delete.d.ts

@@ -0,0 +1,14 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { CLIInput } from '@kb-labs/sdk';
+
+type TaskDeleteFlags = {
+    yes?: boolean;
+    json?: boolean;
+    'dry-run'?: boolean;
+};
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<TaskDeleteFlags>, {
+    deleted: boolean;
+    taskId: string;
+} | null>;
+
+export { _default as default };

package/dist/commands/task-delete.js

@@ -0,0 +1,92 @@
+import { defineCommand, validationError } from '@kb-labs/sdk';
+import { deleteTask, requireApiKey, ClickUpApiError } from '@kb-labs/clickup-core';
+
+// src/commands/task-delete.ts
+function apiHint(err) {
+  switch (err.status) {
+    case 401:
+      return "CLICKUP_API_KEY is invalid or expired \u2014 check the token in your environment";
+    case 403:
+      return "You don't have permission for this action in ClickUp \u2014 check workspace access";
+    case 404:
+      return "Resource not found \u2014 verify the ID is correct (use `kb clickup workspace` to browse IDs)";
+    case 429:
+      return "ClickUp rate limit reached \u2014 wait a moment and retry";
+    default:
+      return "Unexpected ClickUp API error";
+  }
+}
+function handleError(ctx, err, isJson) {
+  if (err instanceof ClickUpApiError) {
+    const hint = apiHint(err);
+    if (isJson) {
+      ctx.ui?.json?.({ ok: false, error: { code: err.code, message: err.message, status: err.status, hint } });
+    } else {
+      ctx.ui?.error?.(err.message, { hint, cause: `ClickUp API ${err.status} (${err.code})` });
+    }
+    return;
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);
+  if (isJson) {
+    ctx.ui?.json?.({
+      ok: false,
+      error: {
+        code: isEnvMissing ? "ENV_MISSING" : "INTERNAL_ERROR",
+        message,
+        ...isEnvMissing && {
+          hint: "Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables"
+        }
+      }
+    });
+  } else {
+    ctx.ui?.error?.(message, {
+      ...isEnvMissing && {
+        hint: "Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables",
+        command: "export CLICKUP_API_KEY=pk_xxx CLICKUP_TEAM_ID=yyy"
+      }
+    });
+  }
+}
+
+// src/commands/task-delete.ts
+var task_delete_default = defineCommand({
+  id: "clickup:task.delete",
+  description: "Delete a task",
+  handler: {
+    async intent(_ctx, input) {
+      const [taskId] = input.argv;
+      return {
+        summary: `Delete task ${taskId ?? "(unknown)"}`,
+        operations: [{ type: "delete", resource: "task", details: { taskId } }]
+      };
+    },
+    async execute(ctx, input) {
+      const [taskId] = input.argv;
+      if (!taskId) {
+        validationError(ctx, "Task ID is required", "Usage: kb clickup task delete <taskId> --yes", input.flags.json);
+        return { exitCode: 1, result: null };
+      }
+      if (!input.flags.yes) {
+        validationError(ctx, `--yes is required to delete task ${taskId}`, "Add --yes to confirm deletion", input.flags.json);
+        return { exitCode: 1, result: null };
+      }
+      try {
+        await deleteTask(requireApiKey(), taskId);
+        if (input.flags.json) {
+          ctx.ui?.json?.({ ok: true, deleted: true, taskId });
+        } else {
+          ctx.ui?.success?.(`Deleted task ${taskId}`);
+        }
+        return { exitCode: 0, result: { deleted: true, taskId } };
+      } catch (err) {
+        handleError(ctx, err, input.flags.json);
+        return { exitCode: 1, result: null };
+      }
+    }
+  }
+});
+
+export { task_delete_default as default };
+//# sourceMappingURL=task-delete.js.map
+//# sourceMappingURL=task-delete.js.map

package/dist/commands/task-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/error.ts","../../src/commands/task-delete.ts"],"names":[],"mappings":"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","file":"task-delete.js","sourcesContent":["import type { PluginContextV3 } from '@kb-labs/sdk';\nimport { ClickUpApiError } from '@kb-labs/clickup-core';\n\nexport { validationError } from '@kb-labs/sdk';\n\nfunction apiHint(err: ClickUpApiError): string {\n  switch (err.status) {\n    case 401: return 'CLICKUP_API_KEY is invalid or expired — check the token in your environment';\n    case 403: return 'You don\\'t have permission for this action in ClickUp — check workspace access';\n    case 404: return 'Resource not found — verify the ID is correct (use `kb clickup workspace` to browse IDs)';\n    case 429: return 'ClickUp rate limit reached — wait a moment and retry';\n    default:  return 'Unexpected ClickUp API error';\n  }\n}\n\n/**\n * Output a structured error and return — call right before `return { exitCode: 1, result: null }`.\n * In JSON mode emits `{ ok: false, error: { code, message, hint?, status? } }`.\n * In CLI mode uses ctx.ui.error() with hint and cause.\n */\nexport function handleError(ctx: PluginContextV3, err: unknown, isJson?: boolean): void {\n  if (err instanceof ClickUpApiError) {\n    const hint = apiHint(err);\n    if (isJson) {\n      ctx.ui?.json?.({ ok: false, error: { code: err.code, message: err.message, status: err.status, hint } });\n    } else {\n      ctx.ui?.error?.(err.message, { hint, cause: `ClickUp API ${err.status} (${err.code})` });\n    }\n    return;\n  }\n\n  const message = err instanceof Error ? err.message : String(err);\n  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);\n\n  if (isJson) {\n    ctx.ui?.json?.({\n      ok: false,\n      error: {\n        code: isEnvMissing ? 'ENV_MISSING' : 'INTERNAL_ERROR',\n        message,\n        ...(isEnvMissing && {\n          hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables',\n        }),\n      },\n    });\n  } else {\n    ctx.ui?.error?.(message, {\n      ...(isEnvMissing && {\n        hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables',\n        command: 'export CLICKUP_API_KEY=pk_xxx CLICKUP_TEAM_ID=yyy',\n      }),\n    });\n  }\n}\n\n/**\n * Re-throws `err` as an HTTP-aware error for REST handlers.\n * `ClickUpApiError` → preserves HTTP status code; env errors → 400; others → 500.\n * The envelope middleware in rest-api reads `err.statusCode` to set the response status.\n */\nexport function rethrowForRest(err: unknown): never {\n  if (err instanceof ClickUpApiError) {\n    const hint = apiHint(err);\n    const restErr = Object.assign(new Error(err.message), {\n      statusCode: err.status,\n      code: err.code,\n      details: { hint },\n    });\n    throw restErr;\n  }\n  const message = err instanceof Error ? err.message : String(err);\n  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);\n  if (isEnvMissing) {\n    throw Object.assign(new Error(message), {\n      statusCode: 400,\n      code: 'ENV_MISSING',\n      details: { hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables' },\n    });\n  }\n  throw err;\n}\n","import { defineCommand, type CLIInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { requireApiKey, deleteTask } from '@kb-labs/clickup-core';\nimport { handleError, validationError } from '../utils/error.js';\n\ntype TaskDeleteFlags = { yes?: boolean; json?: boolean; 'dry-run'?: boolean };\n\nexport default defineCommand({\n  id: 'clickup:task.delete',\n  description: 'Delete a task',\n\n  handler: {\n    async intent(_ctx: PluginContextV3, input: CLIInput<TaskDeleteFlags>) {\n      const [taskId] = input.argv;\n      return {\n        summary: `Delete task ${taskId ?? '(unknown)'}`,\n        operations: [{ type: 'delete' as const, resource: 'task', details: { taskId } }],\n      };\n    },\n\n    async execute(ctx: PluginContextV3, input: CLIInput<TaskDeleteFlags>) {\n      const [taskId] = input.argv;\n      if (!taskId) {\n        validationError(ctx, 'Task ID is required', 'Usage: kb clickup task delete <taskId> --yes', input.flags.json);\n        return { exitCode: 1, result: null };\n      }\n\n      if (!input.flags.yes) {\n        validationError(ctx, `--yes is required to delete task ${taskId}`, 'Add --yes to confirm deletion', input.flags.json);\n        return { exitCode: 1, result: null };\n      }\n\n      try {\n        await deleteTask(requireApiKey(), taskId);\n\n        if (input.flags.json) {\n          ctx.ui?.json?.({ ok: true, deleted: true, taskId });\n        } else {\n          ctx.ui?.success?.(`Deleted task ${taskId}`);\n        }\n\n        return { exitCode: 0, result: { deleted: true, taskId } };\n      } catch (err) {\n        handleError(ctx, err, input.flags.json);\n        return { exitCode: 1, result: null };\n      }\n    },\n  },\n});\n"]}

package/dist/commands/task-get.d.ts

@@ -0,0 +1,14 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import * as _kb_labs_clickup_contracts from '@kb-labs/clickup-contracts';
+import { CLIInput } from '@kb-labs/sdk';
+
+type TaskGetFlags = {
+    json?: boolean;
+    full?: boolean;
+};
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<TaskGetFlags>, {
+    task: _kb_labs_clickup_contracts.ClickUpTask;
+    comments: _kb_labs_clickup_contracts.ClickUpComment[];
+} | null>;
+
+export { _default as default };

package/dist/commands/task-get.js

@@ -0,0 +1,128 @@
+import { defineCommand, validationError } from '@kb-labs/sdk';
+import { requireApiKey, getTask, getTaskComments, ClickUpApiError } from '@kb-labs/clickup-core';
+
+// src/commands/task-get.ts
+function apiHint(err) {
+  switch (err.status) {
+    case 401:
+      return "CLICKUP_API_KEY is invalid or expired \u2014 check the token in your environment";
+    case 403:
+      return "You don't have permission for this action in ClickUp \u2014 check workspace access";
+    case 404:
+      return "Resource not found \u2014 verify the ID is correct (use `kb clickup workspace` to browse IDs)";
+    case 429:
+      return "ClickUp rate limit reached \u2014 wait a moment and retry";
+    default:
+      return "Unexpected ClickUp API error";
+  }
+}
+function handleError(ctx, err, isJson) {
+  if (err instanceof ClickUpApiError) {
+    const hint = apiHint(err);
+    if (isJson) {
+      ctx.ui?.json?.({ ok: false, error: { code: err.code, message: err.message, status: err.status, hint } });
+    } else {
+      ctx.ui?.error?.(err.message, { hint, cause: `ClickUp API ${err.status} (${err.code})` });
+    }
+    return;
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);
+  if (isJson) {
+    ctx.ui?.json?.({
+      ok: false,
+      error: {
+        code: isEnvMissing ? "ENV_MISSING" : "INTERNAL_ERROR",
+        message,
+        ...isEnvMissing && {
+          hint: "Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables"
+        }
+      }
+    });
+  } else {
+    ctx.ui?.error?.(message, {
+      ...isEnvMissing && {
+        hint: "Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables",
+        command: "export CLICKUP_API_KEY=pk_xxx CLICKUP_TEAM_ID=yyy"
+      }
+    });
+  }
+}
+
+// src/utils/slim.ts
+function slimTask(task) {
+  return {
+    id: task.id,
+    name: task.name,
+    status: task.status.status,
+    priority: task.priority?.id ? Number(task.priority.id) : null,
+    due_date: task.due_date ? Number(task.due_date) : null,
+    url: task.url
+  };
+}
+function slimTaskWithDesc(task) {
+  return { ...slimTask(task), description: task.description ?? "" };
+}
+
+// src/commands/task-get.ts
+var task_get_default = defineCommand({
+  id: "clickup:task.get",
+  description: "Get full task details including comments",
+  handler: {
+    async execute(ctx, input) {
+      const [taskId] = input.argv;
+      if (!taskId) {
+        validationError(ctx, "Task ID is required", "Usage: kb clickup task get <taskId>", input.flags.json);
+        return { exitCode: 1, result: null };
+      }
+      try {
+        const apiKey = requireApiKey();
+        const [task, comments] = await Promise.all([
+          getTask(apiKey, taskId),
+          getTaskComments(apiKey, taskId)
+        ]);
+        if (input.flags.json) {
+          ctx.ui?.json?.(input.flags.full ? { task, comments } : slimTaskWithDesc(task));
+          return { exitCode: 0, result: { task, comments } };
+        }
+        const priority = task.priority?.priority ?? "\u2013";
+        const assignees = task.assignees.map((a) => a.username).join(", ") || "\u2013";
+        const due = task.due_date ? new Date(Number(task.due_date)).toLocaleDateString() : "\u2013";
+        const sections = [];
+        if (task.description) {
+          sections.push({ header: "Description", items: [task.description] });
+        }
+        if (comments.length) {
+          sections.push({
+            header: `Comments (${comments.length})`,
+            items: comments.map((c) => {
+              const date = new Date(Number(c.date)).toLocaleString();
+              return `[${c.user.username} @ ${date}] ${c.comment_text}`;
+            })
+          });
+        }
+        ctx.ui?.sideBox?.({
+          title: `[${task.id}] ${task.name}`,
+          status: "info",
+          summary: {
+            "Status": task.status.status,
+            "Priority": priority,
+            "Assignees": assignees,
+            "Due": due,
+            "List": `${task.list.name} / ${task.folder.name}`,
+            "URL": task.url
+          },
+          sections
+        });
+        return { exitCode: 0, result: { task, comments } };
+      } catch (err) {
+        handleError(ctx, err, input.flags.json);
+        return { exitCode: 1, result: null };
+      }
+    }
+  }
+});
+
+export { task_get_default as default };
+//# sourceMappingURL=task-get.js.map
+//# sourceMappingURL=task-get.js.map

package/dist/commands/task-get.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/error.ts","../../src/utils/slim.ts","../../src/commands/task-get.ts"],"names":[],"mappings":"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","file":"task-get.js","sourcesContent":["import type { PluginContextV3 } from '@kb-labs/sdk';\nimport { ClickUpApiError } from '@kb-labs/clickup-core';\n\nexport { validationError } from '@kb-labs/sdk';\n\nfunction apiHint(err: ClickUpApiError): string {\n  switch (err.status) {\n    case 401: return 'CLICKUP_API_KEY is invalid or expired — check the token in your environment';\n    case 403: return 'You don\\'t have permission for this action in ClickUp — check workspace access';\n    case 404: return 'Resource not found — verify the ID is correct (use `kb clickup workspace` to browse IDs)';\n    case 429: return 'ClickUp rate limit reached — wait a moment and retry';\n    default:  return 'Unexpected ClickUp API error';\n  }\n}\n\n/**\n * Output a structured error and return — call right before `return { exitCode: 1, result: null }`.\n * In JSON mode emits `{ ok: false, error: { code, message, hint?, status? } }`.\n * In CLI mode uses ctx.ui.error() with hint and cause.\n */\nexport function handleError(ctx: PluginContextV3, err: unknown, isJson?: boolean): void {\n  if (err instanceof ClickUpApiError) {\n    const hint = apiHint(err);\n    if (isJson) {\n      ctx.ui?.json?.({ ok: false, error: { code: err.code, message: err.message, status: err.status, hint } });\n    } else {\n      ctx.ui?.error?.(err.message, { hint, cause: `ClickUp API ${err.status} (${err.code})` });\n    }\n    return;\n  }\n\n  const message = err instanceof Error ? err.message : String(err);\n  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);\n\n  if (isJson) {\n    ctx.ui?.json?.({\n      ok: false,\n      error: {\n        code: isEnvMissing ? 'ENV_MISSING' : 'INTERNAL_ERROR',\n        message,\n        ...(isEnvMissing && {\n          hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables',\n        }),\n      },\n    });\n  } else {\n    ctx.ui?.error?.(message, {\n      ...(isEnvMissing && {\n        hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables',\n        command: 'export CLICKUP_API_KEY=pk_xxx CLICKUP_TEAM_ID=yyy',\n      }),\n    });\n  }\n}\n\n/**\n * Re-throws `err` as an HTTP-aware error for REST handlers.\n * `ClickUpApiError` → preserves HTTP status code; env errors → 400; others → 500.\n * The envelope middleware in rest-api reads `err.statusCode` to set the response status.\n */\nexport function rethrowForRest(err: unknown): never {\n  if (err instanceof ClickUpApiError) {\n    const hint = apiHint(err);\n    const restErr = Object.assign(new Error(err.message), {\n      statusCode: err.status,\n      code: err.code,\n      details: { hint },\n    });\n    throw restErr;\n  }\n  const message = err instanceof Error ? err.message : String(err);\n  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);\n  if (isEnvMissing) {\n    throw Object.assign(new Error(message), {\n      statusCode: 400,\n      code: 'ENV_MISSING',\n      details: { hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables' },\n    });\n  }\n  throw err;\n}\n","import type { ClickUpTask } from '@kb-labs/clickup-contracts';\n\nexport function slimTask(task: ClickUpTask) {\n  return {\n    id:       task.id,\n    name:     task.name,\n    status:   task.status.status,\n    priority: task.priority?.id ? Number(task.priority.id) : null,\n    due_date: task.due_date ? Number(task.due_date) : null,\n    url:      task.url,\n  };\n}\n\nexport function slimTaskWithDesc(task: ClickUpTask) {\n  return { ...slimTask(task), description: task.description ?? '' };\n}\n","import { defineCommand, type CLIInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { requireApiKey, getTask, getTaskComments } from '@kb-labs/clickup-core';\nimport { handleError, validationError } from '../utils/error.js';\nimport { slimTaskWithDesc } from '../utils/slim.js';\n\ntype TaskGetFlags = { json?: boolean; full?: boolean };\n\nexport default defineCommand({\n  id: 'clickup:task.get',\n  description: 'Get full task details including comments',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<TaskGetFlags>) {\n      const [taskId] = input.argv;\n      if (!taskId) {\n        validationError(ctx, 'Task ID is required', 'Usage: kb clickup task get <taskId>', input.flags.json);\n        return { exitCode: 1, result: null };\n      }\n\n      try {\n        const apiKey = requireApiKey();\n        const [task, comments] = await Promise.all([\n          getTask(apiKey, taskId),\n          getTaskComments(apiKey, taskId),\n        ]);\n\n        if (input.flags.json) {\n          ctx.ui?.json?.(input.flags.full ? { task, comments } : slimTaskWithDesc(task));\n          return { exitCode: 0, result: { task, comments } };\n        }\n\n        const priority = task.priority?.priority ?? '–';\n        const assignees = task.assignees.map(a => a.username).join(', ') || '–';\n        const due = task.due_date\n          ? new Date(Number(task.due_date)).toLocaleDateString()\n          : '–';\n\n        const sections: Array<{ header: string; items: string[] }> = [];\n\n        if (task.description) {\n          sections.push({ header: 'Description', items: [task.description] });\n        }\n\n        if (comments.length) {\n          sections.push({\n            header: `Comments (${comments.length})`,\n            items: comments.map(c => {\n              const date = new Date(Number(c.date)).toLocaleString();\n              return `[${c.user.username} @ ${date}] ${c.comment_text}`;\n            }),\n          });\n        }\n\n        ctx.ui?.sideBox?.({\n          title: `[${task.id}] ${task.name}`,\n          status: 'info',\n          summary: {\n            'Status':    task.status.status,\n            'Priority':  priority,\n            'Assignees': assignees,\n            'Due':       due,\n            'List':      `${task.list.name} / ${task.folder.name}`,\n            'URL':       task.url,\n          },\n          sections,\n        });\n\n        return { exitCode: 0, result: { task, comments } };\n      } catch (err) {\n        handleError(ctx, err, input.flags.json);\n        return { exitCode: 1, result: null };\n      }\n    },\n  },\n});\n"]}

package/dist/commands/task-search.d.ts

@@ -0,0 +1,16 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import * as _kb_labs_clickup_contracts from '@kb-labs/clickup-contracts';
+import { CLIInput } from '@kb-labs/sdk';
+
+type TaskSearchFlags = {
+    list?: string;
+    status?: string;
+    assignee?: string;
+    limit?: number;
+    closed?: boolean;
+    json?: boolean;
+    full?: boolean;
+};
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<TaskSearchFlags>, _kb_labs_clickup_contracts.ClickUpTask[] | null>;
+
+export { _default as default };

package/dist/commands/task-search.js

@@ -0,0 +1,112 @@
+import { defineCommand } from '@kb-labs/sdk';
+import { searchTasks, requireApiKey, requireTeamId, ClickUpApiError } from '@kb-labs/clickup-core';
+
+// src/commands/task-search.ts
+function apiHint(err) {
+  switch (err.status) {
+    case 401:
+      return "CLICKUP_API_KEY is invalid or expired \u2014 check the token in your environment";
+    case 403:
+      return "You don't have permission for this action in ClickUp \u2014 check workspace access";
+    case 404:
+      return "Resource not found \u2014 verify the ID is correct (use `kb clickup workspace` to browse IDs)";
+    case 429:
+      return "ClickUp rate limit reached \u2014 wait a moment and retry";
+    default:
+      return "Unexpected ClickUp API error";
+  }
+}
+function handleError(ctx, err, isJson) {
+  if (err instanceof ClickUpApiError) {
+    const hint = apiHint(err);
+    if (isJson) {
+      ctx.ui?.json?.({ ok: false, error: { code: err.code, message: err.message, status: err.status, hint } });
+    } else {
+      ctx.ui?.error?.(err.message, { hint, cause: `ClickUp API ${err.status} (${err.code})` });
+    }
+    return;
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);
+  if (isJson) {
+    ctx.ui?.json?.({
+      ok: false,
+      error: {
+        code: isEnvMissing ? "ENV_MISSING" : "INTERNAL_ERROR",
+        message,
+        ...isEnvMissing && {
+          hint: "Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables"
+        }
+      }
+    });
+  } else {
+    ctx.ui?.error?.(message, {
+      ...isEnvMissing && {
+        hint: "Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables",
+        command: "export CLICKUP_API_KEY=pk_xxx CLICKUP_TEAM_ID=yyy"
+      }
+    });
+  }
+}
+
+// src/utils/slim.ts
+function slimTask(task) {
+  return {
+    id: task.id,
+    name: task.name,
+    status: task.status.status,
+    priority: task.priority?.id ? Number(task.priority.id) : null,
+    due_date: task.due_date ? Number(task.due_date) : null,
+    url: task.url
+  };
+}
+
+// src/commands/task-search.ts
+var task_search_default = defineCommand({
+  id: "clickup:task.search",
+  description: "Search tasks across the workspace",
+  handler: {
+    async execute(ctx, input) {
+      try {
+        const [query] = input.argv;
+        const tasks = await searchTasks(requireApiKey(), requireTeamId(), {
+          query,
+          list_ids: input.flags.list ? [input.flags.list] : void 0,
+          statuses: input.flags.status ? input.flags.status.split(",") : void 0,
+          assignees: input.flags.assignee ? input.flags.assignee.split(",") : void 0,
+          limit: input.flags.limit ?? 20,
+          include_closed: input.flags.closed
+        });
+        if (input.flags.json) {
+          ctx.ui?.json?.(input.flags.full ? tasks : tasks.map(slimTask));
+          return { exitCode: 0, result: tasks };
+        }
+        if (!tasks.length) {
+          ctx.ui?.info?.("No tasks found.");
+          return { exitCode: 0, result: tasks };
+        }
+        ctx.ui?.chain?.(tasks.map((task) => {
+          const priority = task.priority?.priority ?? "\u2013";
+          const assignees = task.assignees.map((a) => a.username).join(", ") || "\u2013";
+          return {
+            title: `[${task.id}] ${task.name}`,
+            sections: [{
+              items: [
+                `status: ${task.status.status}  priority: ${priority}  assignees: ${assignees}`,
+                `list: ${task.list.name}  ${task.url}`
+              ]
+            }]
+          };
+        }));
+        return { exitCode: 0, result: tasks };
+      } catch (err) {
+        handleError(ctx, err, input.flags.json);
+        return { exitCode: 1, result: null };
+      }
+    }
+  }
+});
+
+export { task_search_default as default };
+//# sourceMappingURL=task-search.js.map
+//# sourceMappingURL=task-search.js.map

package/dist/commands/task-search.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/error.ts","../../src/utils/slim.ts","../../src/commands/task-search.ts"],"names":[],"mappings":"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","file":"task-search.js","sourcesContent":["import type { PluginContextV3 } from '@kb-labs/sdk';\nimport { ClickUpApiError } from '@kb-labs/clickup-core';\n\nexport { validationError } from '@kb-labs/sdk';\n\nfunction apiHint(err: ClickUpApiError): string {\n  switch (err.status) {\n    case 401: return 'CLICKUP_API_KEY is invalid or expired — check the token in your environment';\n    case 403: return 'You don\\'t have permission for this action in ClickUp — check workspace access';\n    case 404: return 'Resource not found — verify the ID is correct (use `kb clickup workspace` to browse IDs)';\n    case 429: return 'ClickUp rate limit reached — wait a moment and retry';\n    default:  return 'Unexpected ClickUp API error';\n  }\n}\n\n/**\n * Output a structured error and return — call right before `return { exitCode: 1, result: null }`.\n * In JSON mode emits `{ ok: false, error: { code, message, hint?, status? } }`.\n * In CLI mode uses ctx.ui.error() with hint and cause.\n */\nexport function handleError(ctx: PluginContextV3, err: unknown, isJson?: boolean): void {\n  if (err instanceof ClickUpApiError) {\n    const hint = apiHint(err);\n    if (isJson) {\n      ctx.ui?.json?.({ ok: false, error: { code: err.code, message: err.message, status: err.status, hint } });\n    } else {\n      ctx.ui?.error?.(err.message, { hint, cause: `ClickUp API ${err.status} (${err.code})` });\n    }\n    return;\n  }\n\n  const message = err instanceof Error ? err.message : String(err);\n  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);\n\n  if (isJson) {\n    ctx.ui?.json?.({\n      ok: false,\n      error: {\n        code: isEnvMissing ? 'ENV_MISSING' : 'INTERNAL_ERROR',\n        message,\n        ...(isEnvMissing && {\n          hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables',\n        }),\n      },\n    });\n  } else {\n    ctx.ui?.error?.(message, {\n      ...(isEnvMissing && {\n        hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables',\n        command: 'export CLICKUP_API_KEY=pk_xxx CLICKUP_TEAM_ID=yyy',\n      }),\n    });\n  }\n}\n\n/**\n * Re-throws `err` as an HTTP-aware error for REST handlers.\n * `ClickUpApiError` → preserves HTTP status code; env errors → 400; others → 500.\n * The envelope middleware in rest-api reads `err.statusCode` to set the response status.\n */\nexport function rethrowForRest(err: unknown): never {\n  if (err instanceof ClickUpApiError) {\n    const hint = apiHint(err);\n    const restErr = Object.assign(new Error(err.message), {\n      statusCode: err.status,\n      code: err.code,\n      details: { hint },\n    });\n    throw restErr;\n  }\n  const message = err instanceof Error ? err.message : String(err);\n  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);\n  if (isEnvMissing) {\n    throw Object.assign(new Error(message), {\n      statusCode: 400,\n      code: 'ENV_MISSING',\n      details: { hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables' },\n    });\n  }\n  throw err;\n}\n","import type { ClickUpTask } from '@kb-labs/clickup-contracts';\n\nexport function slimTask(task: ClickUpTask) {\n  return {\n    id:       task.id,\n    name:     task.name,\n    status:   task.status.status,\n    priority: task.priority?.id ? Number(task.priority.id) : null,\n    due_date: task.due_date ? Number(task.due_date) : null,\n    url:      task.url,\n  };\n}\n\nexport function slimTaskWithDesc(task: ClickUpTask) {\n  return { ...slimTask(task), description: task.description ?? '' };\n}\n","import { defineCommand, type CLIInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { requireApiKey, requireTeamId, searchTasks } from '@kb-labs/clickup-core';\nimport { handleError } from '../utils/error.js';\nimport { slimTask } from '../utils/slim.js';\n\ntype TaskSearchFlags = {\n  list?: string;\n  status?: string;\n  assignee?: string;\n  limit?: number;\n  closed?: boolean;\n  json?: boolean;\n  full?: boolean;\n};\n\nexport default defineCommand({\n  id: 'clickup:task.search',\n  description: 'Search tasks across the workspace',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<TaskSearchFlags>) {\n      try {\n        const [query] = input.argv;\n\n        const tasks = await searchTasks(requireApiKey(), requireTeamId(), {\n          query,\n          list_ids: input.flags.list ? [input.flags.list] : undefined,\n          statuses: input.flags.status ? input.flags.status.split(',') : undefined,\n          assignees: input.flags.assignee ? input.flags.assignee.split(',') : undefined,\n          limit: input.flags.limit ?? 20,\n          include_closed: input.flags.closed,\n        });\n\n        if (input.flags.json) {\n          ctx.ui?.json?.(input.flags.full ? tasks : tasks.map(slimTask));\n          return { exitCode: 0, result: tasks };\n        }\n\n        if (!tasks.length) {\n          ctx.ui?.info?.('No tasks found.');\n          return { exitCode: 0, result: tasks };\n        }\n\n        ctx.ui?.chain?.(tasks.map(task => {\n          const priority = task.priority?.priority ?? '–';\n          const assignees = task.assignees.map(a => a.username).join(', ') || '–';\n          return {\n            title: `[${task.id}] ${task.name}`,\n            sections: [{\n              items: [\n                `status: ${task.status.status}  priority: ${priority}  assignees: ${assignees}`,\n                `list: ${task.list.name}  ${task.url}`,\n              ],\n            }],\n          };\n        }));\n\n        return { exitCode: 0, result: tasks };\n      } catch (err) {\n        handleError(ctx, err, input.flags.json);\n        return { exitCode: 1, result: null };\n      }\n    },\n  },\n});\n"]}

package/dist/commands/task-update.d.ts

@@ -0,0 +1,19 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import * as _kb_labs_clickup_contracts from '@kb-labs/clickup-contracts';
+import { CLIInput } from '@kb-labs/sdk';
+
+type TaskUpdateFlags = {
+    name?: string;
+    desc?: string;
+    status?: string;
+    priority?: number;
+    assignee_add?: string;
+    assignee_rem?: string;
+    due?: string;
+    json?: boolean;
+    full?: boolean;
+    'dry-run'?: boolean;
+};
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<TaskUpdateFlags>, _kb_labs_clickup_contracts.ClickUpTask | null>;
+
+export { _default as default };

package/dist/commands/task-update.js

@@ -0,0 +1,124 @@
+import { defineCommand, validationError } from '@kb-labs/sdk';
+import { updateTask, requireApiKey, ClickUpApiError } from '@kb-labs/clickup-core';
+
+// src/commands/task-update.ts
+function apiHint(err) {
+  switch (err.status) {
+    case 401:
+      return "CLICKUP_API_KEY is invalid or expired \u2014 check the token in your environment";
+    case 403:
+      return "You don't have permission for this action in ClickUp \u2014 check workspace access";
+    case 404:
+      return "Resource not found \u2014 verify the ID is correct (use `kb clickup workspace` to browse IDs)";
+    case 429:
+      return "ClickUp rate limit reached \u2014 wait a moment and retry";
+    default:
+      return "Unexpected ClickUp API error";
+  }
+}
+function handleError(ctx, err, isJson) {
+  if (err instanceof ClickUpApiError) {
+    const hint = apiHint(err);
+    if (isJson) {
+      ctx.ui?.json?.({ ok: false, error: { code: err.code, message: err.message, status: err.status, hint } });
+    } else {
+      ctx.ui?.error?.(err.message, { hint, cause: `ClickUp API ${err.status} (${err.code})` });
+    }
+    return;
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);
+  if (isJson) {
+    ctx.ui?.json?.({
+      ok: false,
+      error: {
+        code: isEnvMissing ? "ENV_MISSING" : "INTERNAL_ERROR",
+        message,
+        ...isEnvMissing && {
+          hint: "Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables"
+        }
+      }
+    });
+  } else {
+    ctx.ui?.error?.(message, {
+      ...isEnvMissing && {
+        hint: "Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables",
+        command: "export CLICKUP_API_KEY=pk_xxx CLICKUP_TEAM_ID=yyy"
+      }
+    });
+  }
+}
+
+// src/commands/task-update.ts
+function parseDue(due) {
+  if (due === "null" || due === "none") return null;
+  const n = Number(due);
+  if (!isNaN(n) && n > 0) return n;
+  const d = new Date(due);
+  if (!isNaN(d.getTime())) return d.getTime();
+  return null;
+}
+var task_update_default = defineCommand({
+  id: "clickup:task.update",
+  description: "Update an existing task",
+  handler: {
+    async intent(_ctx, input) {
+      const [taskId] = input.argv;
+      const skipKeys = /* @__PURE__ */ new Set(["json", "full", "dry-run", "yes", "output"]);
+      const changes = Object.entries(input.flags).filter(([k, v]) => !skipKeys.has(k) && v !== void 0).map(([k, v]) => `${k}=${JSON.stringify(v)}`);
+      return {
+        summary: `Update task ${taskId ?? "(unknown)"}`,
+        operations: [{
+          type: "update",
+          resource: "task",
+          details: { taskId, changes }
+        }]
+      };
+    },
+    async execute(ctx, input) {
+      const [taskId] = input.argv;
+      if (!taskId) {
+        validationError(ctx, "Task ID is required", "Usage: kb clickup task update <taskId> [--name ...] [--status ...]", input.flags.json);
+        return { exitCode: 1, result: null };
+      }
+      const { name, desc, status, priority, assignee_add, assignee_rem, due, json, full } = input.flags;
+      const body = {};
+      if (name !== void 0) body.name = name;
+      if (desc !== void 0) body.markdown_content = desc.replace(/\\n/g, "\n");
+      if (status !== void 0) body.status = status;
+      if (priority !== void 0) body.priority = priority;
+      if (due !== void 0) body.due_date = parseDue(due);
+      if (assignee_add || assignee_rem) {
+        body.assignees = {
+          add: assignee_add ? assignee_add.split(",").map(Number) : [],
+          rem: assignee_rem ? assignee_rem.split(",").map(Number) : []
+        };
+      }
+      try {
+        const task = await updateTask(requireApiKey(), taskId, body);
+        if (json) {
+          ctx.ui?.json?.(full ? task : { id: task.id, name: task.name, status: task.status.status, url: task.url });
+        } else {
+          ctx.ui?.success?.("Task updated", {
+            sections: [{
+              items: [
+                `id: ${task.id}`,
+                `name: ${task.name}`,
+                `status: ${task.status.status}`,
+                `url: ${task.url}`
+              ]
+            }]
+          });
+        }
+        return { exitCode: 0, result: task };
+      } catch (err) {
+        handleError(ctx, err, json);
+        return { exitCode: 1, result: null };
+      }
+    }
+  }
+});
+
+export { task_update_default as default };
+//# sourceMappingURL=task-update.js.map
+//# sourceMappingURL=task-update.js.map

package/dist/commands/task-update.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/error.ts","../../src/commands/task-update.ts"],"names":[],"mappings":"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","file":"task-update.js","sourcesContent":["import type { PluginContextV3 } from '@kb-labs/sdk';\nimport { ClickUpApiError } from '@kb-labs/clickup-core';\n\nexport { validationError } from '@kb-labs/sdk';\n\nfunction apiHint(err: ClickUpApiError): string {\n  switch (err.status) {\n    case 401: return 'CLICKUP_API_KEY is invalid or expired — check the token in your environment';\n    case 403: return 'You don\\'t have permission for this action in ClickUp — check workspace access';\n    case 404: return 'Resource not found — verify the ID is correct (use `kb clickup workspace` to browse IDs)';\n    case 429: return 'ClickUp rate limit reached — wait a moment and retry';\n    default:  return 'Unexpected ClickUp API error';\n  }\n}\n\n/**\n * Output a structured error and return — call right before `return { exitCode: 1, result: null }`.\n * In JSON mode emits `{ ok: false, error: { code, message, hint?, status? } }`.\n * In CLI mode uses ctx.ui.error() with hint and cause.\n */\nexport function handleError(ctx: PluginContextV3, err: unknown, isJson?: boolean): void {\n  if (err instanceof ClickUpApiError) {\n    const hint = apiHint(err);\n    if (isJson) {\n      ctx.ui?.json?.({ ok: false, error: { code: err.code, message: err.message, status: err.status, hint } });\n    } else {\n      ctx.ui?.error?.(err.message, { hint, cause: `ClickUp API ${err.status} (${err.code})` });\n    }\n    return;\n  }\n\n  const message = err instanceof Error ? err.message : String(err);\n  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);\n\n  if (isJson) {\n    ctx.ui?.json?.({\n      ok: false,\n      error: {\n        code: isEnvMissing ? 'ENV_MISSING' : 'INTERNAL_ERROR',\n        message,\n        ...(isEnvMissing && {\n          hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables',\n        }),\n      },\n    });\n  } else {\n    ctx.ui?.error?.(message, {\n      ...(isEnvMissing && {\n        hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables',\n        command: 'export CLICKUP_API_KEY=pk_xxx CLICKUP_TEAM_ID=yyy',\n      }),\n    });\n  }\n}\n\n/**\n * Re-throws `err` as an HTTP-aware error for REST handlers.\n * `ClickUpApiError` → preserves HTTP status code; env errors → 400; others → 500.\n * The envelope middleware in rest-api reads `err.statusCode` to set the response status.\n */\nexport function rethrowForRest(err: unknown): never {\n  if (err instanceof ClickUpApiError) {\n    const hint = apiHint(err);\n    const restErr = Object.assign(new Error(err.message), {\n      statusCode: err.status,\n      code: err.code,\n      details: { hint },\n    });\n    throw restErr;\n  }\n  const message = err instanceof Error ? err.message : String(err);\n  const isEnvMissing = /CLICKUP_API_KEY|CLICKUP_TEAM_ID/.test(message);\n  if (isEnvMissing) {\n    throw Object.assign(new Error(message), {\n      statusCode: 400,\n      code: 'ENV_MISSING',\n      details: { hint: 'Set CLICKUP_API_KEY (and CLICKUP_TEAM_ID for workspace commands) as environment variables' },\n    });\n  }\n  throw err;\n}\n","import { defineCommand, type CLIInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { requireApiKey, updateTask } from '@kb-labs/clickup-core';\nimport { handleError, validationError } from '../utils/error.js';\n\ntype TaskUpdateFlags = {\n  name?: string;\n  desc?: string;\n  status?: string;\n  priority?: number;\n  assignee_add?: string;\n  assignee_rem?: string;\n  due?: string;\n  json?: boolean;\n  full?: boolean;\n  'dry-run'?: boolean;\n};\n\nfunction parseDue(due: string): number | null {\n  if (due === 'null' || due === 'none') return null;\n  const n = Number(due);\n  if (!isNaN(n) && n > 0) return n;\n  const d = new Date(due);\n  if (!isNaN(d.getTime())) return d.getTime();\n  return null;\n}\n\nexport default defineCommand({\n  id: 'clickup:task.update',\n  description: 'Update an existing task',\n\n  handler: {\n    async intent(_ctx: PluginContextV3, input: CLIInput<TaskUpdateFlags>) {\n      const [taskId] = input.argv;\n      const skipKeys = new Set(['json', 'full', 'dry-run', 'yes', 'output']);\n      const changes = Object.entries(input.flags)\n        .filter(([k, v]) => !skipKeys.has(k) && v !== undefined)\n        .map(([k, v]) => `${k}=${JSON.stringify(v)}`);\n      return {\n        summary: `Update task ${taskId ?? '(unknown)'}`,\n        operations: [{\n          type: 'update' as const,\n          resource: 'task',\n          details: { taskId, changes },\n        }],\n      };\n    },\n\n    async execute(ctx: PluginContextV3, input: CLIInput<TaskUpdateFlags>) {\n      const [taskId] = input.argv;\n      if (!taskId) {\n        validationError(ctx, 'Task ID is required', 'Usage: kb clickup task update <taskId> [--name ...] [--status ...]', input.flags.json);\n        return { exitCode: 1, result: null };\n      }\n\n      const { name, desc, status, priority, assignee_add, assignee_rem, due, json, full } = input.flags;\n\n      const body: Record<string, unknown> = {};\n      if (name !== undefined) body.name = name;\n      if (desc !== undefined) body.markdown_content = desc.replace(/\\\\n/g, '\\n');\n      if (status !== undefined) body.status = status;\n      if (priority !== undefined) body.priority = priority;\n      if (due !== undefined) body.due_date = parseDue(due);\n      if (assignee_add || assignee_rem) {\n        body.assignees = {\n          add: assignee_add ? assignee_add.split(',').map(Number) : [],\n          rem: assignee_rem ? assignee_rem.split(',').map(Number) : [],\n        };\n      }\n\n      try {\n        const task = await updateTask(requireApiKey(), taskId, body);\n\n        if (json) {\n          ctx.ui?.json?.(full ? task : { id: task.id, name: task.name, status: task.status.status, url: task.url });\n        } else {\n          ctx.ui?.success?.('Task updated', {\n            sections: [{\n              items: [\n                `id: ${task.id}`,\n                `name: ${task.name}`,\n                `status: ${task.status.status}`,\n                `url: ${task.url}`,\n              ],\n            }],\n          });\n        }\n\n        return { exitCode: 0, result: task };\n      } catch (err) {\n        handleError(ctx, err, json);\n        return { exitCode: 1, result: null };\n      }\n    },\n  },\n});\n"]}