@thanhthi2895/luna-ai 2.16.2

package/agentic/shared/skills/asana-task/references/implement-workflow.md

@@ -0,0 +1,164 @@
+# Implement / Fix Workflow for Asana Tasks
+
+Context-gathering and delegation workflow for implementing features or fixing bugs from Asana tasks.
+
+**⚠️ CRITICAL RULE**: After implementation/fix, the ONLY Asana action is writing ID/TC to task notes. Do NOT update task status, do NOT post comments, do NOT perform any other Asana action.
+
+---
+
+## 1. Resolve Task
+
+```bash
+luna get_asana_task <task-gid-or-url>
+```
+
+Display task summary per SKILL.md Step 2 format.
+
+## 2. Collect All Context
+
+Gather context from **all available sources** before delegating. Each source is optional — skip gracefully if unavailable.
+
+### 2a. Asana Task
+
+Already fetched in Step 1. Extract:
+
+- **Task name** — short title of the work
+- **Description (notes)** — requirements, acceptance criteria, reproduction steps
+- **Custom fields** — priority, sprint, labels, etc.
+
+### 2b. Asana Comments
+
+```bash
+luna get_asana_comments <task-gid>
+```
+
+Extract from comments:
+
+- **Clarifications** — additional context from team discussion
+- **QA notes** — tester feedback, screenshots, logs
+- **Linked URLs** — PR links, Jira links mentioned in comments
+
+### 2c. Linked Jira Issue
+
+Scan task notes + comments for Jira issue patterns:
+
+- URL: `https://*.atlassian.net/browse/PROJ-123`
+- Key: `SE-114`, `DEV-456`, `PROJ-789` (2-5 uppercase letters + dash + digits)
+
+If found:
+
+```bash
+luna get_jira_issue <issue-key>
+luna get_jira_comments <issue-key>
+```
+
+Extract from Jira:
+
+- **Acceptance Criteria (AC)** — primary source for test validation
+- **Description** — background context, business rules
+- **Issue type** — Bug / Story / Task (determines delegation target)
+- **Priority** — Critical / High / Medium / Low
+- **Labels / Components** — scope hints
+- **Comments** — QA feedback, blockers, dev clarifications, testing notes
+
+If Jira not accessible: skip, note "Jira not accessible — using Asana context only".
+
+### 2d. Linked PR / MR
+
+Scan task notes + comments for PR/MR URLs:
+
+- GitHub: `https://github.com/ORG/REPO/pull/123`
+- GitLab: `https://gitlab.com/ORG/REPO/-/merge_requests/123`
+
+Detect platform:
+
+```bash
+luna get_git_platform
+# Output: {"platform":"github|gitlab","cli":"gh|glab","authenticated":true,"remote":"..."}
+```
+
+**GitHub:**
+
+```bash
+gh pr view <pr-url> --json title,body,files,additions,deletions,baseRefName,headRefName
+```
+
+**GitLab:**
+
+```bash
+glab mr view <mr-url>
+```
+
+If no PR/MR found in notes, check current branch:
+
+```bash
+# GitHub
+gh pr view HEAD --json url,title,body,files 2>/dev/null
+# GitLab
+glab mr view --source-branch "$(git branch --show-current)" 2>/dev/null
+```
+
+Extract from PR/MR:
+
+- **Title/body** — "What Changed" / "How to Test" sections
+- **Changed files** — impacted components, scope of change
+- **Branch name** — may hint at feature/fix type
+
+If PR/MR not accessible: skip, note "PR not accessible — using task context only".
+
+## 3. Synthesize Context
+
+Combine all collected info into a structured brief for delegation:
+
+```markdown
+## Task Context
+
+**Type**: Feature / Bug Fix
+**Priority**: <from Jira or Asana custom fields>
+
+### Requirements
+
+<from Asana description + Jira AC>
+
+### Bug Details (if fix)
+
+- **Steps to reproduce**: <from Asana/Jira description>
+- **Expected**: <expected behavior>
+- **Actual**: <actual behavior>
+- **Environment**: <if mentioned>
+
+### Additional Context
+
+<from comments, QA notes, PR body>
+
+### Scope Hints
+
+- Jira: <issue-key> (if found)
+- PR: <pr-url> (if found)
+- Files: <changed files from PR> (if found)
+```
+
+## 4. Delegate
+
+### Implement (Feature)
+
+Delegate to `lu:cook` with the synthesized context:
+
+- Pass the full context brief as task description
+- lu:cook handles its own research → plan → implement → test → review cycle
+- Default mode: `--interactive` (user reviews at each gate)
+
+### Fix Bug
+
+Delegate to `lu:fix` with the synthesized context:
+
+- Pass the full context brief including reproduction steps
+- lu:fix handles debug → classify → fix → verify → review cycle
+- Default mode: `--auto` (autonomous with confidence scoring)
+
+## 5. Post-Implementation
+
+After lu:cook or lu:fix completes successfully:
+
+1. **Auto-run ID/TC** — Follow `references/id-tc-workflow.md` to write Implementation Detail + Testing Checklist back to Asana task notes
+2. Report completion to user with summary of changes

package/agentic/shared/skills/asana-task/references/qa-testing-instructions-workflow.md

@@ -0,0 +1,118 @@
+# QA Testing Instructions Generation for Asana
+
+Generate comprehensive, structured QA Testing Instructions for an Asana task.
+Uses all available context: Asana task description, PR, Jira issue, and comments.
+
+**⚠️ CRITICAL RULE**: When generating QA Testing Instructions, the ONLY action is writing content to the task notes/description. Do NOT update task status, do NOT post comments, do NOT perform any other Asana action.
+
+---
+
+## Process
+
+### 1. Resolve Task
+
+```bash
+luna get_asana_task <task-gid-or-url>
+```
+
+Extract from the task data:
+
+- Task **name** and **description (notes)**
+- Linked **PR URL** — scan `notes` for GitHub/GitLab PR URLs
+- Linked **Jira issue key** — scan `notes` for Atlassian/Jira issue URLs or keys (e.g. `SE-114`, `DEV-123`)
+
+### 2. Fetch Comments
+
+```bash
+luna get_asana_comments <task-gid>
+```
+
+From comments, additionally extract:
+
+- Any **PR URL** mentioned (GitHub/GitLab pull request links)
+- Any **Jira issue URL or key** mentioned
+- Any **QA notes** or instructions from reviewers
+
+### 3. Fetch PR / MR Details (if PR found)
+
+Detect platform:
+
+```bash
+luna get_git_platform
+# Output: {"platform":"github|gitlab","cli":"gh|glab","authenticated":true,"remote":"..."}
+```
+
+**GitHub:**
+
+```bash
+gh pr view <pr-url-or-number> --json title,body,files,additions,deletions,baseRefName,headRefName
+```
+
+**GitLab:**
+
+```bash
+glab mr view <mr-url>
+```
+
+Or check current branch:
+
+```bash
+# GitHub
+gh pr view HEAD --json title,body,files,additions,deletions 2>/dev/null
+# GitLab
+glab mr view --source-branch "$(git branch --show-current)" 2>/dev/null
+```
+
+Extract from PR/MR:
+
+- **Title** — scope of change
+- **Body** — often contains "What Changed" / "How to Test" hints
+- **Changed files** — to understand impacted components/screens
+- **Branch name** — may hint at feature or fix type
+
+If PR/MR not accessible: skip, note "PR not accessible — generating from task info only".
+
+### 4. Fetch Jira Issue (if found)
+
+```bash
+luna get_jira_issue <issue-key>
+luna get_jira_comments <issue-key>
+```
+
+Extract from Jira:
+
+- **Acceptance Criteria (AC)** — primary source for test cases
+- **Description** — background/context
+- **Issue type** — Bug / Story / Task (affects test emphasis)
+- **Priority** — influences which TCs are marked [CRITICAL] or [HIGH]
+- **Comments** — QA feedback, blockers, clarifications
+
+If Jira not accessible: skip, note "Jira not accessible — generating from task/PR info only".
+
+### 5. Generate QA Testing Instructions
+
+Synthesize all collected info into the format below.
+
+**Rules:**
+
+- Each test case covers exactly ONE specific behavior
+- Use numbered TCs: `TC-1`, `TC-2`, ... `TC-N`
+- Label critical fix TCs explicitly: `[CRITICAL BUG FIX]`
+- **Steps**: use bullet points (`- `) with imperative verbs — each bullet is one concrete action
+  - Be specific: mention screen name, button label, data value
+  - Example: `- Open the listing detail page for a ticket with no valueRating`
+- **Expected**: bullet points — one precise outcome per bullet (label, color, count, message)
+- Always include a regression TC at the end
+- Max ~7-10 TCs (quality over quantity)
+
+### 6. Run Update Script
+
+Write the generated content in HTML format to a local temporary file (e.g., `qatest.html` in the current working directory) using the template at `skills/asana-task/templates/qa-testing-instructions.html` inside your agent's config directory (e.g., `~/.claude/skills/asana-task/templates/qa-testing-instructions.html`), then call via `luna`:
+
+**⚠️ CRITICAL:** Do NOT use `/tmp/` or absolute paths outside the context directory. Create the file locally (e.g., `./qatest.html`) to avoid "Error writing file" permission issues.
+
+```bash
+# Generate content to qatest.html, then:
+luna update_asana_notes {task_gid} --file qatest.html --section "QA Testing Instructions"
+rm qatest.html
+```

package/agentic/shared/skills/asana-task/scripts/asana-api.cjs

@@ -0,0 +1,190 @@
+#!/usr/bin/env node
+/**
+ * asana-api.cjs
+ * Asana REST API CLI — read-only task operations.
+ *
+ * Commands:
+ *   get-task <task-gid>          Fetch task details
+ *   get-subtasks <task-gid>     Fetch subtasks of a task
+ *   get-comments <task-gid>     Fetch comments (stories) on a task
+ *
+ * Exit codes: 0 - success, 1 - error
+ */
+
+'use strict';
+
+const { requireConfig, apiRequest } = require('./asana-shared.cjs');
+
+// --- Field selections --------------------------------------------------------
+
+const TASK_FIELDS = [
+  'gid', 'name', 'notes', 'html_notes', 'resource_subtype',
+  'assignee.name', 'assignee.email',
+  'completed', 'completed_at',
+  'due_on', 'due_at', 'start_on',
+  'created_at', 'modified_at',
+  'projects.name', 'memberships.section.name',
+  'tags.name', 'custom_fields',
+  'parent.name', 'parent.gid', 'num_subtasks',
+].join(',');
+
+const SUBTASK_FIELDS = 'gid,name,completed,assignee.name,due_on,resource_subtype';
+
+const STORY_FIELDS = 'gid,type,resource_subtype,text,html_text,created_at,created_by.name,is_pinned';
+
+
+
+// --- Commands ----------------------------------------------------------------
+
+async function getTask(taskGid, apiToken) {
+  const result = await apiRequest(
+    'GET',
+    `/tasks/${encodeURIComponent(taskGid)}?opt_fields=${TASK_FIELDS}`,
+    apiToken
+  );
+  const t = result.data || {};
+  const output = {
+    gid: t.gid,
+    name: t.name,
+    type: t.resource_subtype || 'default_task',
+    assignee: t.assignee ? { name: t.assignee.name, email: t.assignee.email } : null,
+    completed: t.completed,
+    completed_at: t.completed_at,
+    due_on: t.due_on,
+    due_at: t.due_at,
+    start_on: t.start_on,
+    created_at: t.created_at,
+    modified_at: t.modified_at,
+    projects: (t.projects || []).map(p => p.name),
+    section: t.memberships?.[0]?.section?.name || null,
+    tags: (t.tags || []).map(tag => tag.name),
+    custom_fields: (t.custom_fields || []).map(cf => ({
+      name: cf.name,
+      value: cf.display_value || cf.enum_value?.name || cf.text_value || cf.number_value || null,
+    })),
+    parent: t.parent ? { gid: t.parent.gid, name: t.parent.name } : null,
+    num_subtasks: t.num_subtasks,
+    notes: t.notes,
+  };
+  console.log(JSON.stringify(output, null, 2));
+}
+
+async function getSubtasks(taskGid, apiToken) {
+  const allSubtasks = [];
+  let offset = null;
+
+  do {
+    const offsetParam = offset ? `&offset=${offset}` : '';
+    const result = await apiRequest(
+      'GET',
+      `/tasks/${encodeURIComponent(taskGid)}/subtasks?opt_fields=${SUBTASK_FIELDS}&limit=100${offsetParam}`,
+      apiToken
+    );
+    const items = (result.data || []).map(s => ({
+      gid: s.gid,
+      name: s.name,
+      completed: s.completed,
+      assignee: s.assignee?.name || null,
+      due_on: s.due_on,
+      type: s.resource_subtype || 'default_task',
+    }));
+    allSubtasks.push(...items);
+    offset = result.next_page?.offset || null;
+  } while (offset);
+
+  console.log(JSON.stringify({ total: allSubtasks.length, subtasks: allSubtasks }, null, 2));
+}
+
+async function getComments(taskGid, apiToken) {
+  const allComments = [];
+  let offset = null;
+
+  do {
+    const offsetParam = offset ? `&offset=${offset}` : '';
+    const result = await apiRequest(
+      'GET',
+      `/tasks/${encodeURIComponent(taskGid)}/stories?opt_fields=${STORY_FIELDS}&limit=100${offsetParam}`,
+      apiToken
+    );
+    // Filter to comments only (exclude system stories)
+    const comments = (result.data || [])
+      .filter(s => s.type === 'comment')
+      .map(s => ({
+        gid: s.gid,
+        author: s.created_by?.name || 'Unknown',
+        created_at: s.created_at,
+        text: s.text,
+        is_pinned: s.is_pinned || false,
+      }));
+    allComments.push(...comments);
+    offset = result.next_page?.offset || null;
+  } while (offset);
+
+  console.log(JSON.stringify({ total: allComments.length, comments: allComments }, null, 2));
+}
+
+
+// --- Helpers -----------------------------------------------------------------
+
+/**
+ * Extract task GID from Asana URL or return as-is if already a GID.
+ * Supported URL patterns:
+ *   https://app.asana.com/0/PROJECT_GID/TASK_GID
+ *   https://app.asana.com/0/PROJECT_GID/TASK_GID/f
+ *   https://app.asana.com/0/PROJECT_GID/list?taskId=TASK_GID
+ *   https://app.asana.com/1/WORKSPACE_GID/project/PROJECT_GID/task/TASK_GID
+ *   https://app.asana.com/1/WORKSPACE_GID/project/PROJECT_GID/task/TASK_GID?focus=true
+ */
+function extractTaskGid(input) {
+  if (/^\d+$/.test(input)) return input;
+
+  // New format: /1/.../task/TASK_GID (with optional query string)
+  const newPathMatch = input.match(/\/task\/(\d+)(?:[/?#]|$)/);
+  if (newPathMatch) return newPathMatch[1];
+
+  // Old format: /0/PROJECT_GID/TASK_GID or /0/PROJECT_GID/TASK_GID/f
+  const pathMatch = input.match(/app\.asana\.com\/0\/\d+\/(\d+)/);
+  if (pathMatch) return pathMatch[1];
+
+  // Query string: taskId=TASK_GID
+  const queryMatch = input.match(/[?&]taskId=(\d+)/);
+  if (queryMatch) return queryMatch[1];
+
+  return input;
+}
+
+// --- Main --------------------------------------------------------------------
+
+async function main() {
+  const { apiToken } = requireConfig();
+  const [cmd, ...args] = process.argv.slice(2);
+
+  switch (cmd) {
+    case 'get-task': {
+      const rawId = args[0];
+      if (!rawId) { console.error('Usage: asana-api.cjs get-task <task-gid-or-url>'); process.exit(1); }
+      await getTask(extractTaskGid(rawId), apiToken);
+      break;
+    }
+    case 'get-subtasks': {
+      const rawId = args[0];
+      if (!rawId) { console.error('Usage: asana-api.cjs get-subtasks <task-gid-or-url>'); process.exit(1); }
+      await getSubtasks(extractTaskGid(rawId), apiToken);
+      break;
+    }
+    case 'get-comments': {
+      const rawId = args[0];
+      if (!rawId) { console.error('Usage: asana-api.cjs get-comments <task-gid-or-url>'); process.exit(1); }
+      await getComments(extractTaskGid(rawId), apiToken);
+      break;
+    }
+    default:
+      console.error('Usage: node asana-api.cjs <command> [args]');
+      console.error('Commands: get-task | get-subtasks | get-comments');
+      process.exit(1);
+  }
+}
+
+if (require.main === module) {
+  main().catch(err => { console.error('ERROR:', err.message); process.exit(1); });
+}

package/agentic/shared/skills/asana-task/scripts/asana-shared.cjs

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+/**
+ * asana-shared.cjs
+ * Shared utilities for all Asana scripts.
+ *
+ * Exports:
+ *   loadConfig()    — load api_token from env or config file
+ *   requireConfig() — loadConfig + exit(1) if missing credentials
+ *   apiRequest()    — authenticated Asana REST API call (Bearer token)
+ */
+
+'use strict';
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+
+// --- Config ------------------------------------------------------------------
+
+function loadConfig() {
+  const target = process.env.LUNA_AGENT || 'claude';
+  const isAntigravity = target === 'antigravity' || target === 'gemini';
+  const isOpencode = target === 'opencode';
+
+  const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+  const claudeConfigDir = process.env.CLAUDE_CONFIG_DIR || path.join(homeDir, '.claude');
+
+  let basePath;
+  if (isAntigravity) {
+    basePath = path.join(homeDir, '.gemini', 'antigravity');
+  } else if (isOpencode) {
+    basePath = path.join(homeDir, '.config', 'opencode');
+  } else {
+    basePath = claudeConfigDir;
+  }
+
+  const centralEnv = path.join(basePath, '.env');
+
+  // Priority: (1) env var ASANA_PAT → (2) ~/.claude/.env or ~/.gemini/antigravity/.env etc.
+  let apiToken = process.env.ASANA_PAT || '';
+
+  if (!apiToken) {
+    try {
+      const envContent = fs.readFileSync(centralEnv, 'utf8');
+      for (const line of envContent.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('#') || !trimmed.includes('=')) continue;
+        const [key, ...rest] = trimmed.split('=');
+        const val = rest.join('=').trim();
+        if (key.trim() === 'ASANA_PAT') { apiToken = val; break; }
+      }
+    } catch { /* .env not found */ }
+  }
+
+  return { apiToken, centralEnv };
+}
+
+function requireConfig() {
+  const { apiToken, centralEnv } = loadConfig();
+  if (!apiToken) {
+    console.error('ERROR: Missing Asana API token.');
+    console.error(`Set ASANA_PAT env var or add to ${centralEnv}`);
+    console.error('Format: ASANA_PAT=1/xxx:yyy');
+    console.error('Generate token at: https://app.asana.com/0/my-apps');
+    process.exit(1);
+  }
+  return { apiToken };
+}
+
+// --- HTTP --------------------------------------------------------------------
+
+function apiRequest(method, urlPath, apiToken, body = null) {
+  return new Promise((resolve, reject) => {
+    const fullUrl = `https://app.asana.com/api/1.0${urlPath}`;
+    const parsed = new URL(fullUrl);
+
+    const options = {
+      hostname: parsed.hostname,
+      port: 443,
+      path: parsed.pathname + parsed.search,
+      method,
+      headers: {
+        Authorization: `Bearer ${apiToken}`,
+        'Content-Type': 'application/json',
+        Accept: '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(data ? JSON.parse(data) : {});
+        }
+      });
+    });
+
+    req.on('error', reject);
+    if (body) req.write(JSON.stringify(body));
+    req.end();
+  });
+}
+
+module.exports = { loadConfig, requireConfig, apiRequest };