@thanhthi2895/luna-ai 2.16.2

package/agentic/claude/.claude/skills/chrome-devtools/scripts/ws-full-debug.js

@@ -0,0 +1,107 @@
+import { getBrowser, getPage, disconnectBrowser, outputJSON } from './lib/browser.js';
+
+async function debugWsFull() {
+  const browser = await getBrowser({ headless: false });
+  const page = await getPage(browser);
+
+  const logs = [];
+  const wsEvents = [];
+  const networkErrors = [];
+
+  // Capture ALL console messages
+  page.on('console', msg => {
+    logs.push({
+      type: msg.type(),
+      text: msg.text(),
+      location: msg.location()
+    });
+  });
+
+  // Capture page errors
+  page.on('pageerror', err => {
+    logs.push({ type: 'pageerror', text: err.message });
+  });
+
+  // Monitor WebSocket via CDP
+  const client = await page.createCDPSession();
+  await client.send('Network.enable');
+
+  client.on('Network.webSocketCreated', e => {
+    console.log('WS Created:', e.url);
+    wsEvents.push({ event: 'created', url: e.url, requestId: e.requestId });
+  });
+
+  client.on('Network.webSocketWillSendHandshakeRequest', e => {
+    console.log('WS Handshake Request:', e.requestId);
+    wsEvents.push({ event: 'handshake_request', requestId: e.requestId, request: e.request });
+  });
+
+  client.on('Network.webSocketHandshakeResponseReceived', e => {
+    console.log('WS Handshake Response:', e.response?.status);
+    wsEvents.push({
+      event: 'handshake_response',
+      requestId: e.requestId,
+      status: e.response?.status,
+      headers: e.response?.headers
+    });
+  });
+
+  client.on('Network.webSocketClosed', e => {
+    console.log('WS Closed:', e.requestId);
+    wsEvents.push({ event: 'closed', requestId: e.requestId });
+  });
+
+  client.on('Network.webSocketFrameError', e => {
+    console.log('WS Frame Error:', e.errorMessage);
+    wsEvents.push({ event: 'frame_error', requestId: e.requestId, error: e.errorMessage });
+  });
+
+  client.on('Network.webSocketFrameReceived', e => {
+    wsEvents.push({ event: 'frame_received', requestId: e.requestId, data: e.response?.payloadData?.substring(0, 200) });
+  });
+
+  client.on('Network.webSocketFrameSent', e => {
+    wsEvents.push({ event: 'frame_sent', requestId: e.requestId, data: e.response?.payloadData?.substring(0, 200) });
+  });
+
+  // Track failed requests
+  client.on('Network.loadingFailed', e => {
+    if (e.type === 'WebSocket') {
+      networkErrors.push({ requestId: e.requestId, error: e.errorText, canceled: e.canceled });
+    }
+  });
+
+  console.log('Navigating to app...');
+  await page.goto('http://localhost:5173', { waitUntil: 'networkidle0', timeout: 20000 });
+
+  console.log('Current URL:', page.url());
+
+  // Wait longer and collect events
+  console.log('Waiting 10s to collect WebSocket events...');
+  await new Promise(r => setTimeout(r, 10000));
+
+  // Filter for /ws connections only (not vite-hmr)
+  const appWsEvents = wsEvents.filter(e => e.url?.includes('/ws') && !e.url?.includes('token='));
+
+  outputJSON({
+    success: true,
+    url: page.url(),
+    appWsEvents,
+    allWsEvents: wsEvents,
+    networkErrors,
+    logs: logs.filter(l =>
+      l.text?.toLowerCase().includes('websocket') ||
+      l.text?.toLowerCase().includes('unauthorized') ||
+      l.text?.toLowerCase().includes('error') ||
+      l.type === 'error'
+    ).slice(0, 20)
+  });
+
+  await disconnectBrowser();
+  process.exit(0);
+}
+
+debugWsFull().catch(e => {
+  console.error(JSON.stringify({ success: false, error: e.message, stack: e.stack }));
+  process.exit(1);
+});

package/agentic/claude/.claude/skills/clickup-task/SKILL.md

@@ -0,0 +1,257 @@
+---
+name: lu:clickup-task
+author: luna
+description: 'ClickUp task skill with two modes. MODE 1 - Full auto implement: fetch task → display summary → Critical Gate → delegate to lu:cook (which handles research/plan/execute/review/archive internally). MODE 2 - ID/TC only: resolve task, find linked PR, write ID/TC to task description only, nothing else.'
+---
+
+# ClickUp Task
+
+## CLI Access
+
+Commands use `luna` CLI wrapper for permission-aware routing.
+Read commands (`get_*`, `search_*`) are auto-approved. Write commands (`update_*`, `create_*`, `set_*`) prompt for permission.
+
+Run `luna --help` to see all available commands.
+
+## Mode Detection (FIRST — before doing anything else)
+
+| User intent    | Keywords                                                                        | Mode              |
+| -------------- | ------------------------------------------------------------------------------- | ----------------- |
+| **Implement**  | "work on", "implement", "pick up task", "do task", task ID/URL (no id-tc hint) | **MODE 1** → Full Auto Workflow |
+| **ID/TC only** | "id-tc", "id/tc", "update id-tc", "generate id-tc", "write id-tc", "add id-tc" | **MODE 2** → ID/TC Only |
+
+---
+
+## MODE 1: Full Auto Implement
+
+Auto-drive all steps. No manual stops except: multiple search results, Level 3 track choice, ambiguous requirements, partial review failure.
+
+### Steps 1–4: Setup (shared across all tracks)
+
+**Step 1 – Resolve Task**
+
+By ID (DEV-xxxx or task URL):
+```bash
+luna get_clickup_task <task_id> --markdown
+luna get_clickup_comments <task_id>
+```
+
+> Always use `--markdown` in Mode 1 — required to read description for Testing Checklist.
+
+By search (keywords):
+```bash
+luna search_clickup <keywords>
+```
+Multiple results → display list → ask user to choose.
+
+Extract from URL: last path segment is `task_id`:
+- `https://app.clickup.com/t/{team_id}/{task_id}` → use `{task_id}`
+- `https://app.clickup.com/t/{task_id}` → use `{task_id}`
+
+**Step 2 – Display Task Summary**
+
+```
+## ClickUp Task: [TASK_NAME]
+- **ID**: DEV-xxxx
+- **Status**: [current status]
+- **Priority**: [priority]
+- **Assignees**: [names]
+- **Description**: [first 3 lines]
+- **Subtasks**: [count] items
+- **Comments**: [count] comments
+```
+
+**Step 3 – Critical Gate**
+
+Run risk assessment per CLAUDE.md. Display the assessment table.
+
+Task type detection from name/description:
+
+| Keywords                           | Type     |
+| ---------------------------------- | -------- |
+| feature, add, implement, create    | Feature  |
+| bug, fix, issue, error             | Bug fix  |
+| refactor, optimize, improve, clean | Refactor |
+| chore, update, upgrade, config     | Chore    |
+
+**Step 4 – Testing Checklist + Delegate to lu:cook**
+
+> **Slug rule:** kebab-case from task name, lowercase, max 50 chars, drop special chars.
+> `"Fix HEIC preview detection for iPhone"` → `fix-heic-preview-detection`
+
+**4a. Testing Checklist (ALL tracks — mandatory, never skip):**
+
+Inspect `markdown_description` for `## Testing Checklist:` section:
+- **Present** → keep as-is
+- **Absent** → generate Testing Checklist from task requirements. Do NOT write to ClickUp here — ClickUp update happens in Final Step b.
+
+**4b. Delegate to lu:cook:**
+
+Pass the full task description + context to `lu:cook`. Cook handles research, planning, branching, implementation, tests, and review internally.
+
+| Task type | Command |
+|-----------|---------|
+| Feature / Refactor / Chore | `/cook "<full task description with context>"` |
+| Bug fix | `/fix "<bug description>"` |
+| Debug / Investigate | `/debugger "<issue description>"` |
+
+**3-strike rule on failures:**
+1. Strike 1–2: retry with adjusted approach
+2. Strike 3: invoke `debugger` skill → if resolved, continue; else comment on ClickUp task → notify user
+
+**Step 5 → Final Step** (see below).
+
+---
+
+### Final Step (Mode 1 only): ID/TC + Checklist Update + Archive
+
+> Tests and review are handled by `lu:cook` internally. Final Step only handles ClickUp-specific actions.
+
+**a. Generate ID/TC** — follow `references/id-tc-generation.md` for content format (Implementation Detail + Testing Checklist + Files — all required). Write to task description:
+```bash
+luna update_clickup_idtc <task_id> --file /tmp/idtc-content.md
+```
+
+Handle exit code:
+- **Exit 0**: Done ✓
+- **Exit 2**: Task has attachments — ask user to paste content into ClickUp description manually (URL in script output)
+- **Exit 3**: Video embeds detected in description — use `AskUserQuestion`:
+  - **(A) Paste manually**: print content from output → ask user to paste at end of ClickUp description
+  - **(B) Post as comment**: `luna create_clickup_comment <task_id> --file /tmp/idtc-content.md`
+
+**b. Update Testing Checklist in ClickUp** — based on review result:
+
+| Review result   | Action                                                                                     |
+| --------------- | ------------------------------------------------------------------------------------------ |
+| All checks pass | Mark **all** items done: `luna update_clickup_checklist <task_id> --all --resolved true` |
+| Partial pass    | Mark only verified items: `--item "text" --resolved true` per item                         |
+| Review fails    | Do NOT update — fix issues → re-run `/cook` again                                          |
+
+**c. Archive** — use `lu:plan archive` to move plan to `plans/archive/`:
+```
+/lu:plan archive
+```
+
+---
+
+## MODE 2: ID/TC Only
+
+Write Implementation Detail + Testing Checklist to task description. **No other actions.**
+
+**Step 1 – Resolve Task:**
+```bash
+luna get_clickup_task <task_id> --markdown
+```
+
+**Step 2 – Locate PR + Generate + Write:**
+
+Follow `references/id-tc-generation.md` exactly.
+
+> ⚠️ CRITICAL: The ONLY action is writing ID/TC to task description. Do NOT update status, do NOT comment, do NOT perform any other ClickUp action.
+
+---
+
+## On-demand Actions
+
+| User request                                                      | Action                                                                 |
+| ----------------------------------------------------------------- | ---------------------------------------------------------------------- |
+| "get subtasks", "list subtasks", "subtasks of DEV-xxxx"           | `luna get_clickup_subtasks <task_id>`                                   |
+| "get PR URL", "get pull request URL", "PR URL of DEV-xxxx"        | `luna get_clickup_pr_url <task_id>`                                     |
+| "add PR", "set PR", "link PR", "attach PR to DEV-xxxx"            | See **Add PR to Task** section below                                   |
+| "comment on ClickUp"                                              | `luna create_clickup_comment <task_id> --file /tmp/clickup-comment.txt` |
+| "update checklist", "check off", "mark checklist", "tick checklist" | See **Checklist Update** section below                               |
+| "archive"                                                         | `/lu:plan archive`                                                     |
+
+### Add PR to Task
+
+1. **Resolve PR URL:**
+   - User provides URL → use it directly
+   - User does not provide → detect from current branch:
+     ```bash
+     gh pr view --json url -q '.url'
+     ```
+     If no PR found for current branch → report error, ask user to provide URL.
+
+2. **Set PR URL on ClickUp task:**
+   ```bash
+   luna set_clickup_pr_url <task_id> <pr_url>
+   ```
+
+3. **Comment PR link on ClickUp:**
+   ```bash
+   echo "<pr_url>" > /tmp/clickup-comment.txt && luna create_clickup_comment <task_id> --file /tmp/clickup-comment.txt
+   ```
+
+### Checklist Update
+
+Display current checklist before changing:
+```bash
+luna get_clickup_task <task_id> --markdown
+```
+
+Mark specific item(s) done:
+```bash
+luna update_clickup_checklist <task_id> --item "landscape orientation" --resolved true
+```
+
+Mark all done:
+```bash
+luna update_clickup_checklist <task_id> --all --resolved true
+```
+
+Unmark item(s):
+```bash
+luna update_clickup_checklist <task_id> --item "text" --resolved false
+```
+
+Script behavior: fetches `markdown_description`, patches `- [ ]` / `- [x]` lines in `## Testing Checklist:` section, PUTs via REST API. Exit 2 = manual mode (task has attachments) — print content for user to paste.
+
+---
+
+## Configuration
+
+### Option A: Central `.env` (recommended)
+
+Add to `agentic/claude/.env` (synced to `~/.claude/.env`):
+```bash
+CLICKUP_API_TOKEN=pk_xxxxxxxxxxxxxxxxxxxx
+CLICKUP_TEAM_ID=1234567
+```
+
+`team_id` = ClickUp Workspace ID from URL: `app.clickup.com/{team_id}/home`.
+
+### Option B: Skill-local config (fallback)
+
+```bash
+cp $SKILL_DIR/clickup.local.example.json $SKILL_DIR/clickup.local.json
+```
+
+```json
+{
+  "api_token": "pk_xxxxxxxxxxxxxxxxxxxx",
+  "team_id": "1234567"
+}
+```
+
+Resolution order: env vars (`agentic/claude/.env`) → `$SKILL_DIR/clickup.local.json`.
+
+---
+
+## Error Handling
+
+| Error                            | Action                                                       |
+| -------------------------------- | ------------------------------------------------------------ |
+| Task not found                   | Report error, ask for correct ID                             |
+| No API token or team_id          | Stop — display setup instructions from Configuration section |
+| API 401/403                      | Token invalid — ask user to verify `clickup.local.json`      |
+| 3-strike execution failure       | Stop → comment on ClickUp task → notify user                 |
+| Multiple search results (Step 1) | Display list → ask user to choose                            |
+| Exit code 2 (ID/TC update)       | Print content — ask user to paste into ClickUp               |
+| Exit code 3 (ID/TC update)       | Video embeds detected — `AskUserQuestion`: (A) paste manually or (B) `create-comment <task_id> --file /tmp/idtc-content.md` |
+
+## Notes
+
+- All code, comments, and file content in **English**
+- Communicate with user in **their language**
+- When task has attachments in description, use manual mode (display content for user to paste) to preserve inline images
+- When task description contains video embeds (YouTube, Loom, direct video files), use video mode (exit 3) — ask user to choose between manual paste or posting as comment

package/agentic/claude/.claude/skills/clickup-task/references/id-tc-generation.md

@@ -0,0 +1,88 @@
+# ID/TC Generation
+
+Generate Implementation Detail (ID) and Testing Checklist (TC) for ClickUp task from PR.
+
+Triggered by:
+
+- **Auto**: Final Step d of `clickup-task` skill after PR creation
+- **Standalone**: User says "generate id-tc for DEV-xxxx" or "update task with id/tc"
+
+**⚠️ CRITICAL RULE**: When generating ID/TC (both auto and standalone), the ONLY action is writing ID/TC content to the task description. Do NOT update task status, do NOT comment PR link, do NOT perform any other ClickUp action. ID/TC generation = description update ONLY.
+
+## Process
+
+### 1. Locate PR
+
+**From workflow** (task_id already known):
+
+```bash
+gh pr view HEAD --json url,title,body,files
+```
+
+**From standalone** (task_id provided):
+
+- Search PR URL in task custom fields (`Pull Request URL`) or description: pattern `github.com/.*/pull/\d+`
+- If not found, check comments: `node $SKILL_DIR/scripts/clickup-api.cjs get-comments <task_id>`
+- If found: `gh pr view <pr-url> --json title,body,files`
+
+### 2. Generate Content
+
+**Implementation Detail** — SHORT bullet points:
+
+- 1 line each, max 3-5 bullets
+- Focus on WHAT changed, not HOW
+- Use imperative form: "Add...", "Fix...", "Update..."
+- Example: `Add permission check for Champion role`
+- NOT: `Added a new permission check that verifies whether the user has Champion role`
+
+**Testing Checklist** — SHORT test cases:
+
+- Start with action verb: Verify, Check, Confirm, Test
+- 1 specific behavior per checkbox, max 5-7 items
+- Example: `- [ ] Verify Champion can view blockwalks`
+- NOT: `- [ ] Verify that a user with Champion role is able to view the blockwalks section`
+
+**Files** — concise list:
+
+- Filenames only (not full paths) when possible
+- Group by directory if many files
+
+### 3. Run Update Script
+
+Use the template at `~/.claude/templates/id-tc.md`, fill in the placeholders, write to a temp file, then call the script:
+
+```bash
+# Fill in the template and write to temp file
+cat > /tmp/idtc-content.md << 'EOF'
+{filled content based on ~/.claude/templates/id-tc.md}
+EOF
+
+node $SKILL_DIR/scripts/clickup-update-idtc.cjs {task_id} --file /tmp/idtc-content.md
+```
+
+**Script behavior** (`$SKILL_DIR/scripts/clickup-update-idtc.cjs`):
+
+- Reads config from `~/.claude/skills/clickup-task/clickup.local.json` → falls back to `CLICKUP_API_TOKEN` / `CLICKUP_TEAM_ID` env vars
+- Fetches task with `custom_task_ids=true&team_id=...&include_markdown_description=true`
+- Decides update mode automatically:
+  - `markdown_description` present → append and PUT (auto mode A)
+  - No attachments → append to plain description and PUT (auto mode B)
+  - Has attachments + no `markdown_description` → **exit code 2**, prints content for manual paste
+- On exit code 2: inform user to paste content manually at task URL
+
+### 4. Output Format
+
+See template: [`~/.claude/templates/id-tc.md`](../../templates/id-tc.md)
+
+Always follow the template structure exactly — sections, spacing, and checkbox format.
+
+## Error Handling
+
+| Error / Exit code           | Action                                                                              |
+| --------------------------- | ----------------------------------------------------------------------------------- |
+| Missing config (exit 1)     | Stop — display setup instructions from SKILL.md Configuration section               |
+| API 401/403 (exit 1)        | Token invalid — ask user to verify `~/.claude/skills/clickup-task/clickup.local.json` |
+| Task not found 404 (exit 1) | Report error with task ID                                                           |
+| Manual mode (exit 2)        | Display printed content — ask user to paste into ClickUp                            |
+| No PR found                 | Ask user for PR URL or generate from task info only                                 |
+| PR not accessible           | Generate from task info only, warn user                                             |

package/agentic/claude/.claude/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); });
+}