@thanhthi2895/luna-ai 2.16.2

package/agentic/antigravity/.agents/skills/clickup-task/scripts/clickup-api.cjs

@@ -0,0 +1,226 @@
+#!/usr/bin/env node
+/**
+ * clickup-api.cjs
+ * ClickUp REST API CLI — replaces MCP tools for all task operations.
+ *
+ * Commands:
+ *   get-task <task_id> [--markdown]   (--markdown includes markdown_description field)
+ *   get-subtasks <task_id>            (list all subtasks of a parent task)
+ *   get-comments <task_id>
+ *   search <keywords...>
+ *   update-task <task_id> --status <status>
+ *   get-pr-url <task_id>              (read "Pull Request URL" custom field value)
+ *   set-pr-url <task_id> <pr_url>     (update "Pull Request URL" custom field on task)
+ *   create-comment <task_id> [text]   (or pipe via stdin, or --file <path>)
+ *
+ * Exit codes: 0 - success, 1 - error
+ */
+
+'use strict';
+
+const fs = require('fs');
+const { requireConfig, apiRequest } = require('./clickup-shared.cjs');
+
+// ─── Stdin ────────────────────────────────────────────────────────────────────
+
+function readStdin() {
+  return new Promise(resolve => {
+    if (process.stdin.isTTY) return resolve('');
+    let data = '';
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', chunk => (data += chunk));
+    process.stdin.on('end', () => resolve(data.trim()));
+  });
+}
+
+// ─── Commands ─────────────────────────────────────────────────────────────────
+
+async function getTask(taskId, args, token, teamId) {
+  const withMarkdown = args.includes('--markdown');
+  const query = `custom_task_ids=true&team_id=${teamId}&subtasks=true${withMarkdown ? '&include_markdown_description=true' : ''}`;
+  const result = await apiRequest('GET', `/task/${encodeURIComponent(taskId)}?${query}`, token);
+  console.log(JSON.stringify(result, null, 2));
+}
+
+/** Fetch all subtasks of a parent task.
+ *  Uses subtasks=true param; extracts the subtasks array from the task response. */
+async function getSubtasks(taskId, token, teamId) {
+  const result = await apiRequest(
+    'GET',
+    `/task/${encodeURIComponent(taskId)}?custom_task_ids=true&team_id=${teamId}&subtasks=true`,
+    token
+  );
+  const subtasks = result.subtasks || [];
+  if (subtasks.length === 0) {
+    console.log(JSON.stringify({ subtasks: [], count: 0, message: 'No subtasks found.' }, null, 2));
+  } else {
+    console.log(JSON.stringify({ subtasks, count: subtasks.length }, null, 2));
+  }
+}
+
+async function getComments(taskId, token, teamId) {
+  const result = await apiRequest(
+    'GET',
+    `/task/${encodeURIComponent(taskId)}/comment?custom_task_ids=true&team_id=${teamId}`,
+    token
+  );
+  console.log(JSON.stringify(result, null, 2));
+}
+
+async function search(keywords, token, teamId) {
+  const result = await apiRequest(
+    'GET',
+    `/team/${teamId}/task?search=${encodeURIComponent(keywords)}&subtasks=true`,
+    token
+  );
+  console.log(JSON.stringify(result, null, 2));
+}
+
+async function updateTask(taskId, args, token, teamId) {
+  const body = {};
+  const statusFlag = args.indexOf('--status');
+  if (statusFlag !== -1 && args[statusFlag + 1]) body.status = args[statusFlag + 1];
+
+  if (Object.keys(body).length === 0) {
+    console.error('ERROR: No update fields provided. Use --status <status>');
+    process.exit(1);
+  }
+  const result = await apiRequest(
+    'PUT',
+    `/task/${encodeURIComponent(taskId)}?custom_task_ids=true&team_id=${teamId}`,
+    token,
+    body
+  );
+  console.log(JSON.stringify(result, null, 2));
+}
+
+/** Get the "Pull Request URL" custom field value from a task. */
+async function getPrUrl(taskId, token, teamId) {
+  const task = await apiRequest(
+    'GET',
+    `/task/${encodeURIComponent(taskId)}?custom_task_ids=true&team_id=${teamId}`,
+    token
+  );
+  const prField = (task.custom_fields || []).find(f => f.name === 'Pull Request URL');
+  if (!prField) {
+    const names = (task.custom_fields || []).map(f => `"${f.name}"`).join(', ');
+    console.error(`ERROR: Custom field "Pull Request URL" not found. Available: ${names || '(none)'}`);
+    process.exit(1);
+  }
+  console.log(JSON.stringify({ field: prField.name, value: prField.value || null }, null, 2));
+}
+
+/** Update the "Pull Request URL" custom field on a task.
+ *  Searches task.custom_fields for a field matching /pull.?request|pr.?url/i,
+ *  then POSTs to /task/{id}/field/{field_id} with { value: prUrl }. */
+async function setPrUrl(taskId, prUrl, token, teamId) {
+  const task = await apiRequest(
+    'GET',
+    `/task/${encodeURIComponent(taskId)}?custom_task_ids=true&team_id=${teamId}`,
+    token
+  );
+  const prField = (task.custom_fields || []).find(f =>
+    f.name === 'Pull Request URL'
+  );
+  if (!prField) {
+    const names = (task.custom_fields || []).map(f => `"${f.name}"`).join(', ');
+    console.error(`ERROR: Custom field "Pull Request URL" not found. Available: ${names || '(none)'}`);
+    process.exit(1);
+  }
+  const result = await apiRequest(
+    'POST',
+    `/task/${encodeURIComponent(taskId)}/field/${prField.id}?custom_task_ids=true&team_id=${teamId}`,
+    token,
+    { value: prUrl }
+  );
+  console.log(JSON.stringify(result, null, 2));
+}
+
+async function createComment(taskId, args, token, teamId) {
+  let commentText = '';
+  const fileFlag = args.indexOf('--file');
+  if (fileFlag !== -1 && args[fileFlag + 1]) {
+    commentText = fs.readFileSync(args[fileFlag + 1], 'utf8').trim();
+  } else {
+    const textArgs = args.filter((_, i) => i !== fileFlag && i !== fileFlag + 1);
+    commentText = textArgs.length > 0 ? textArgs.join(' ') : await readStdin();
+  }
+  if (!commentText) {
+    console.error('ERROR: No comment text provided (pass as argument, pipe via stdin, or use --file <path>).');
+    process.exit(1);
+  }
+  const result = await apiRequest(
+    'POST',
+    `/task/${encodeURIComponent(taskId)}/comment?custom_task_ids=true&team_id=${teamId}`,
+    token,
+    { comment_text: commentText, notify_all: false }
+  );
+  console.log(JSON.stringify(result, null, 2));
+}
+
+// ─── Main ─────────────────────────────────────────────────────────────────────
+
+async function main() {
+  const { token, teamId } = requireConfig();
+  const [cmd, ...args] = process.argv.slice(2);
+
+  switch (cmd) {
+    case 'get-task': {
+      const taskId = args[0];
+      if (!taskId) { console.error('Usage: clickup-api.cjs get-task <task_id> [--markdown]'); process.exit(1); }
+      await getTask(taskId, args.slice(1), token, teamId);
+      break;
+    }
+    case 'get-subtasks': {
+      const taskId = args[0];
+      if (!taskId) { console.error('Usage: clickup-api.cjs get-subtasks <task_id>'); process.exit(1); }
+      await getSubtasks(taskId, token, teamId);
+      break;
+    }
+    case 'get-comments': {
+      const taskId = args[0];
+      if (!taskId) { console.error('Usage: clickup-api.cjs get-comments <task_id>'); process.exit(1); }
+      await getComments(taskId, token, teamId);
+      break;
+    }
+    case 'search': {
+      if (args.length === 0) { console.error('Usage: clickup-api.cjs search <keywords>'); process.exit(1); }
+      await search(args.join(' '), token, teamId);
+      break;
+    }
+    case 'update-task': {
+      const taskId = args[0];
+      if (!taskId) { console.error('Usage: clickup-api.cjs update-task <task_id> --status <status>'); process.exit(1); }
+      await updateTask(taskId, args.slice(1), token, teamId);
+      break;
+    }
+    case 'get-pr-url': {
+      const taskId = args[0];
+      if (!taskId) { console.error('Usage: clickup-api.cjs get-pr-url <task_id>'); process.exit(1); }
+      await getPrUrl(taskId, token, teamId);
+      break;
+    }
+    case 'set-pr-url': {
+      const taskId = args[0];
+      const prUrl = args[1];
+      if (!taskId || !prUrl) { console.error('Usage: clickup-api.cjs set-pr-url <task_id> <pr_url>'); process.exit(1); }
+      await setPrUrl(taskId, prUrl, token, teamId);
+      break;
+    }
+    case 'create-comment': {
+      const taskId = args[0];
+      if (!taskId) { console.error('Usage: clickup-api.cjs create-comment <task_id> [text|--file <path>]'); process.exit(1); }
+      await createComment(taskId, args.slice(1), token, teamId);
+      break;
+    }
+    default:
+      console.error('Usage: node clickup-api.cjs <command> [args]');
+      console.error('Commands: get-task | get-subtasks | get-comments | get-pr-url | search | update-task | set-pr-url | create-comment');
+      process.exit(1);
+  }
+}
+
+// Guard: only run as CLI, safe to require() as module
+if (require.main === module) {
+  main().catch(err => { console.error('ERROR:', err.message); process.exit(1); });
+}

package/agentic/antigravity/.agents/skills/clickup-task/scripts/clickup-shared.cjs

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+/**
+ * clickup-shared.cjs
+ * Shared utilities for all ClickUp scripts.
+ *
+ * Exports:
+ *   loadConfig()      — load API token + team_id from env or config file
+ *   requireConfig()   — loadConfig + exit(1) if missing credentials
+ *   apiRequest()      — authenticated ClickUp REST API call
+ *   exitManualMode()  — print content for manual paste and exit(2)
+ *   exitVideoMode()   — print content for video mode and exit(3)
+ */
+
+'use strict';
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+
+// ─── Config ───────────────────────────────────────────────────────────────────
+
+function loadConfig() {
+  // Priority: (1) env vars → (2) project-local → (3) global ~/.gemini/antigravity/skills/
+  let token = process.env.CLICKUP_API_TOKEN || '';
+  let teamId = process.env.CLICKUP_TEAM_ID || '';
+
+  if (!token || !teamId) {
+    const candidatePaths = [
+      path.join(process.cwd(), '.agents', 'skills', 'clickup-task', 'clickup.local.json'),
+      path.join(process.env.HOME || process.env.USERPROFILE || '', '.gemini', 'antigravity', 'skills', 'clickup-task', 'clickup.local.json'),
+    ];
+
+    for (const configPath of candidatePaths) {
+      try {
+        const c = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        if (!token) token = c.api_token || '';
+        if (!teamId) teamId = String(c.team_id || '');
+        if (token && teamId) break;
+      } catch {
+        // config file not found — try next path
+      }
+    }
+  }
+
+  return { token, teamId };
+}
+
+function requireConfig() {
+  const { token, teamId } = loadConfig();
+  if (!token || !teamId) {
+    console.error('ERROR: Missing api_token or team_id.');
+    console.error('Config lookup order:');
+    console.error('  1. Env vars: CLICKUP_API_TOKEN and CLICKUP_TEAM_ID');
+    console.error('  2. Project-local: agentic/antigravity/.agents/skills/clickup-task/clickup.local.json');
+    console.error('  3. Global: ~/.gemini/antigravity/skills/clickup-task/clickup.local.json');
+    console.error('File format: { "api_token": "pk_...", "team_id": "..." }');
+    process.exit(1);
+  }
+  return { token, teamId };
+}
+
+// ─── HTTP ─────────────────────────────────────────────────────────────────────
+
+function apiRequest(method, urlPath, token, body = null) {
+  return new Promise((resolve, reject) => {
+    const options = {
+      hostname: 'api.clickup.com',
+      path: `/api/v2${urlPath}`,
+      method,
+      headers: {
+        Authorization: token,
+        'Content-Type': 'application/json',
+      },
+    };
+
+    const req = https.request(options, res => {
+      let data = '';
+      res.on('data', chunk => (data += chunk));
+      res.on('end', () => {
+        if (res.statusCode >= 400) {
+          reject(new Error(`API ${res.statusCode}: ${data}`));
+        } else {
+          resolve(JSON.parse(data));
+        }
+      });
+    });
+
+    req.on('error', reject);
+    if (body) req.write(JSON.stringify(body));
+    req.end();
+  });
+}
+
+// ─── Manual mode ──────────────────────────────────────────────────────────────
+
+function exitManualMode(taskId, content, actionMsg) {
+  console.log('MANUAL MODE: Task has attachments without markdown_description.');
+  console.log(actionMsg);
+  console.log(`Task URL: https://app.clickup.com/t/${taskId}`);
+  console.log('\n' + content);
+  process.exit(2);
+}
+
+// ─── Video mode ───────────────────────────────────────────────────────────────
+
+/**
+ * exitVideoMode — exit code 3
+ * Called when markdown_description contains video embeds.
+ * Overwriting via PUT would cause ClickUp to lose video block rendering.
+ * The caller (SKILL.md) reads this output and prompts user to choose:
+ *   (A) paste manually, or (B) post ID/TC as a comment.
+ */
+function exitVideoMode(taskId, content) {
+  console.log('VIDEO MODE: Task description contains video embeds that cannot be safely overwritten via the API.');
+  console.log(`Task URL: https://app.clickup.com/t/${taskId}`);
+  console.log('\n---IDTC_CONTENT_START---\n');
+  console.log(content);
+  console.log('\n---IDTC_CONTENT_END---');
+  process.exit(3);
+}
+
+module.exports = { loadConfig, requireConfig, apiRequest, exitManualMode, exitVideoMode };

package/agentic/antigravity/.agents/skills/clickup-task/scripts/clickup-update-checklist.cjs

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+/**
+ * clickup-update-checklist.cjs
+ * Update Testing Checklist items (markdown checkboxes) in a ClickUp task description.
+ *
+ * Usage:
+ *   node clickup-update-checklist.cjs <task_id> --item "partial text" --resolved true|false
+ *   node clickup-update-checklist.cjs <task_id> --all --resolved true|false
+ *
+ * Options:
+ *   --item "text"     Match checklist items containing this text (case-insensitive)
+ *   --all             Target all checklist items in the Testing Checklist section
+ *   --resolved true   Mark matched items as done:    - [x]
+ *   --resolved false  Mark matched items as undone:  - [ ]
+ *
+ * Exit codes: 0 - success, 1 - error, 2 - manual mode (task has attachments)
+ */
+
+'use strict';
+
+const { requireConfig, apiRequest, exitManualMode } = require('./clickup-shared.cjs');
+
+// ─── Checklist patch ──────────────────────────────────────────────────────────
+
+/**
+ * Toggle checkbox markers in the ## Testing Checklist: section of a markdown string.
+ * @param {string} markdown - full task markdown_description
+ * @param {string|null} itemText - substring to match (null = match all)
+ * @param {boolean} resolved - true → [x], false → [ ]
+ * @returns {{ patched: string, count: number }}
+ */
+function patchChecklist(markdown, itemText, resolved) {
+  const lines = markdown.split('\n');
+  const sectionStart = lines.findIndex(l => /^##\s*Testing Checklist/i.test(l));
+  if (sectionStart === -1) return { patched: markdown, count: 0 };
+
+  const sectionEnd = lines.findIndex((l, i) => i > sectionStart && /^##\s/.test(l));
+  const end = sectionEnd === -1 ? lines.length : sectionEnd;
+
+  let count = 0;
+  const checkboxRegex = /^(- \[)([ x])(\] )(.+)$/;
+  const processedLines = lines.slice(sectionStart + 1, end).map(line => {
+    const m = checkboxRegex.exec(line);
+    if (!m) return line;
+    if (m[2] === (resolved ? 'x' : ' ')) return line; // already in target state
+    if (itemText && !m[4].toLowerCase().includes(itemText.toLowerCase())) return line;
+    count++;
+    return `${m[1]}${resolved ? 'x' : ' '}${m[3]}${m[4]}`;
+  });
+
+  const patched = [
+    ...lines.slice(0, sectionStart + 1),
+    ...processedLines,
+    ...lines.slice(end),
+  ].join('\n');
+
+  return { patched, count };
+}
+
+// ─── Main ─────────────────────────────────────────────────────────────────────
+
+async function main() {
+  const { token, teamId } = requireConfig();
+  const args = process.argv.slice(2);
+  const taskId = args[0];
+
+  if (!taskId) {
+    console.error('Usage: clickup-update-checklist.cjs <task_id> [--item "text"] [--all] --resolved true|false');
+    process.exit(1);
+  }
+
+  const resolvedFlag = args.indexOf('--resolved');
+  if (resolvedFlag === -1 || !args[resolvedFlag + 1]) {
+    console.error('ERROR: --resolved true|false is required.');
+    process.exit(1);
+  }
+  const resolved = args[resolvedFlag + 1].toLowerCase() === 'true';
+
+  const itemFlag = args.indexOf('--item');
+  const itemText = itemFlag !== -1 ? args[itemFlag + 1] || null : null;
+  const matchAll = args.includes('--all');
+
+  if (!itemText && !matchAll) {
+    console.error('ERROR: Provide --item "text" to match specific item(s), or --all to update all items.');
+    process.exit(1);
+  }
+
+  console.log(`Fetching task ${taskId}...`);
+  const task = await apiRequest(
+    'GET',
+    `/task/${encodeURIComponent(taskId)}?custom_task_ids=true&team_id=${teamId}&include_markdown_description=true`,
+    token
+  );
+
+  const markdownDesc = task.markdown_description || '';
+  const plainDesc = task.description || '';
+  const hasAttachments = Array.isArray(task.attachments) && task.attachments.length > 0;
+  const sourceMarkdown = markdownDesc || plainDesc;
+
+  if (!sourceMarkdown) {
+    console.error('ERROR: Task has no description to update.');
+    process.exit(1);
+  }
+
+  const { patched, count } = patchChecklist(sourceMarkdown, itemText || null, resolved);
+
+  if (count === 0) {
+    const filter = itemText ? `matching "${itemText}"` : 'in Testing Checklist';
+    console.log(`No items ${filter} found with state - ${resolved ? '[ ]' : '[x]'}. Nothing updated.`);
+    process.exit(0);
+  }
+
+  if (markdownDesc) {
+    await apiRequest('PUT', `/task/${encodeURIComponent(taskId)}?custom_task_ids=true&team_id=${teamId}`, token, {
+      markdown_description: patched,
+    });
+    console.log(`Updated ${count} checklist item(s) (resolved=${resolved}).`);
+  } else if (!hasAttachments) {
+    await apiRequest('PUT', `/task/${encodeURIComponent(taskId)}?custom_task_ids=true&team_id=${teamId}`, token, {
+      markdown_description: patched,
+    });
+    console.log(`Updated ${count} checklist item(s) via plain description (resolved=${resolved}).`);
+  } else {
+    exitManualMode(taskId, patched, 'Paste the following updated description into ClickUp:');
+  }
+}
+
+main().catch(err => { console.error('ERROR:', err.message); process.exit(1); });

package/agentic/antigravity/.agents/skills/clickup-task/scripts/clickup-update-idtc.cjs

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+/**
+ * clickup-update-idtc.cjs
+ * Append ID/TC content to a ClickUp task description via REST API.
+ *
+ * Usage:
+ *   echo "<content>" | node clickup-update-idtc.cjs <task_id>
+ *   node clickup-update-idtc.cjs <task_id> --file <path>
+ *
+ * Exit codes: 0 - success, 1 - error, 2 - manual mode (task has attachments), 3 - video mode (video embeds detected)
+ */
+
+'use strict';
+
+const fs = require('fs');
+const { requireConfig, apiRequest, exitManualMode, exitVideoMode } = require('./clickup-shared.cjs');
+
+// ─── ID/TC detection and replacement ─────────────────────────────────────────
+
+/**
+ * Check if markdown description already contains an ID/TC section.
+ */
+function hasExistingIdTc(markdown) {
+  return /##\s*(Implementation Detail|Testing Checklist)/i.test(markdown);
+}
+
+/**
+ * Replace existing ID/TC section with new content.
+ * Finds the separator + header block and cuts from there, appending new content.
+ */
+function replaceExistingIdTc(existingDesc, newIdTcContent, separator) {
+  // Match the separator block before ID/TC headers (with or without extra --- from content)
+  const idTcBlockRegex = /(\n\n---\n\n(?:---\n\n)?)(##\s*(Implementation Detail|Testing Checklist))/i;
+  const match = idTcBlockRegex.exec(existingDesc);
+
+  if (match) {
+    return existingDesc.substring(0, match.index) + separator + newIdTcContent;
+  }
+
+  // Fallback: cut from the header directly
+  const headerRegex = /##\s*(Implementation Detail|Testing Checklist)/i;
+  const headerMatch = headerRegex.exec(existingDesc);
+  if (headerMatch) {
+    return existingDesc.substring(0, headerMatch.index).trimEnd() + separator + newIdTcContent;
+  }
+
+  return null;
+}
+
+// ─── Video detection ──────────────────────────────────────────────────────────
+
+/**
+ * Detect video embeds in markdown that cannot safely round-trip through
+ * ClickUp's markdown_description PUT endpoint without losing the video preview.
+ * Covers: YouTube, Loom, direct video files (.mp4/.webm/.mov/.avi/.mkv).
+ */
+function hasVideoEmbeds(markdown) {
+  const patterns = [
+    /youtube\.com\/watch/i,
+    /youtu\.be\//i,
+    /youtube\.com\/embed/i,
+    /loom\.com\/share\//i,
+    /loom\.com\/embed\//i,
+    /\.(mp4|webm|mov|avi|mkv)(\?|\s|$|[)"'])/i,
+  ];
+  return patterns.some(p => p.test(markdown));
+}
+
+// ─── Stdin ────────────────────────────────────────────────────────────────────
+
+function readStdin() {
+  return new Promise(resolve => {
+    let data = '';
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', chunk => (data += chunk));
+    process.stdin.on('end', () => resolve(data.trim()));
+  });
+}
+
+// ─── Main ─────────────────────────────────────────────────────────────────────
+
+async function main() {
+  const { token, teamId } = requireConfig();
+
+  const taskId = process.argv[2];
+  if (!taskId) {
+    console.error('Usage: node clickup-update-idtc.cjs <task_id> [--file <path>]');
+    process.exit(1);
+  }
+
+  let idTcContent = '';
+  const fileFlag = process.argv.indexOf('--file');
+  if (fileFlag !== -1 && process.argv[fileFlag + 1]) {
+    idTcContent = fs.readFileSync(process.argv[fileFlag + 1], 'utf8').trim();
+  } else {
+    idTcContent = await readStdin();
+  }
+
+  if (!idTcContent) {
+    console.error('ERROR: No ID/TC content provided (pipe via stdin or use --file).');
+    process.exit(1);
+  }
+
+  console.log(`Fetching task ${taskId}...`);
+  const task = await apiRequest(
+    'GET',
+    `/task/${encodeURIComponent(taskId)}?custom_task_ids=true&team_id=${teamId}&include_markdown_description=true`,
+    token
+  );
+
+  const markdownDesc = task.markdown_description || '';
+  const plainDesc = task.description || '';
+  const hasAttachments = Array.isArray(task.attachments) && task.attachments.length > 0;
+  const SEPARATOR = '\n\n---\n\n';
+
+  if (markdownDesc && hasVideoEmbeds(markdownDesc)) {
+    // Video embeds detected — PUT would cause ClickUp to lose video block rendering
+    exitVideoMode(taskId, idTcContent);
+  } else if (markdownDesc) {
+    let newDesc;
+    if (hasExistingIdTc(markdownDesc)) {
+      newDesc = replaceExistingIdTc(markdownDesc, idTcContent, SEPARATOR);
+      console.log('Replaced existing ID/TC section (auto mode A).');
+    } else {
+      newDesc = markdownDesc + SEPARATOR + idTcContent;
+      console.log('Updated task description (auto mode A).');
+    }
+    await apiRequest('PUT', `/task/${encodeURIComponent(taskId)}?custom_task_ids=true&team_id=${teamId}`, token, {
+      markdown_description: newDesc,
+    });
+  } else if (!hasAttachments) {
+    let newDesc;
+    if (hasExistingIdTc(plainDesc)) {
+      newDesc = replaceExistingIdTc(plainDesc, idTcContent, SEPARATOR);
+      console.log('Replaced existing ID/TC section (auto mode B).');
+    } else {
+      newDesc = (plainDesc || '') + SEPARATOR + idTcContent;
+      console.log('Updated task description (auto mode B).');
+    }
+    await apiRequest('PUT', `/task/${encodeURIComponent(taskId)}?custom_task_ids=true&team_id=${teamId}`, token, {
+      markdown_description: newDesc,
+    });
+  } else {
+    exitManualMode(taskId, idTcContent, 'Paste the following at the end of the task description in ClickUp:');
+  }
+}
+
+main().catch(err => { console.error('ERROR:', err.message); process.exit(1); });