Add Cursor agent workflow: commands, scripts, rules, and skills

Complete agent-assisted development workflow for Edge repositories.
Includes slash commands with companion scripts, coding standards rules,
review standards extracted from PR history, and the author skill for
creating/maintaining commands and skills.

Author: Jon Tzeng

.cursor/commands/asana-attach-pr.sh

@@ -0,0 +1,181 @@
+#!/usr/bin/env bash
+# asana-attach-pr.sh
+# Attach a GitHub PR to an Asana task. Optionally assign to reviewer and set status.
+#
+# Usage:
+#   asana-attach-pr.sh --task <task_gid> --pr-url <pr_url> --pr-title <title> --pr-number <number> \
+#     [--assign] [--reviewer <user_gid>] [--implementor <user_gid>]
+#
+# Requires env vars: ASANA_TOKEN, ASANA_GITHUB_SECRET
+#
+# Without --assign: only attaches the PR to the task (no assignment or status change).
+# With --assign: also assigns to reviewer, sets status to "Review Needed", and
+#   auto-populates Est. Review Hrs if empty.
+#
+# If --assign is used and --reviewer or --implementor are provided, they override
+# what's on the task. If the task's Reviewer field is empty and no override is
+# given, the script outputs PROMPT_REVIEWER so the calling agent can ask the user
+# and re-run with the override. If the Implementor field is empty and no override
+# is given, it auto-resolves to the current user via asana-whoami.sh.
+#
+# Output: One-line summary per action (success/failure/prompt)
+set -euo pipefail
+
+TASK_GID=""
+PR_URL=""
+PR_TITLE=""
+PR_NUMBER=""
+REVIEWER_OVERRIDE=""
+IMPLEMENTOR_OVERRIDE=""
+DO_ASSIGN=false
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --task) TASK_GID="$2"; shift 2 ;;
+    --pr-url) PR_URL="$2"; shift 2 ;;
+    --pr-title) PR_TITLE="$2"; shift 2 ;;
+    --pr-number) PR_NUMBER="$2"; shift 2 ;;
+    --assign) DO_ASSIGN=true; shift ;;
+    --reviewer) REVIEWER_OVERRIDE="$2"; shift 2 ;;
+    --implementor) IMPLEMENTOR_OVERRIDE="$2"; shift 2 ;;
+    *) echo "Unknown arg: $1" >&2; exit 1 ;;
+  esac
+done
+
+if [[ -z "$TASK_GID" || -z "$PR_URL" || -z "$PR_TITLE" || -z "$PR_NUMBER" ]]; then
+  echo "Error: --task, --pr-url, --pr-title, and --pr-number are all required" >&2
+  exit 1
+fi
+if [[ -z "${ASANA_TOKEN:-}" ]]; then
+  echo "Error: ASANA_TOKEN not set" >&2; exit 1
+fi
+if [[ -z "${ASANA_GITHUB_SECRET:-}" ]]; then
+  echo "Error: ASANA_GITHUB_SECRET not set" >&2; exit 1
+fi
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+# Known field GIDs (airbitz.co workspace)
+STATUS_FIELD="1190660107346181"
+REVIEW_NEEDED_OPTION="1190660107348334"
+REVIEWER_FIELD="1203334388004673"
+IMPLEMENTOR_FIELD="1203334386796983"
+SPENT_DEV_HRS_FIELD="1202996660964169"
+EST_REVIEW_HRS_FIELD="1203002792997295"
+
+# --- Step 1: Attach PR via GitHub integration ---
+ATTACH_RESULT=$(curl -s -X POST "https://github.integrations.asana.plus/custom/v1/actions/widget" \
+  -H "Authorization: Bearer $ASANA_GITHUB_SECRET" \
+  -H "Content-Type: application/json" \
+  -d "{
+    \"allowedProjects\": [],
+    \"blockedProjects\": [],
+    \"pullRequestDescription\": \"https://app.asana.com/0/0/$TASK_GID\",
+    \"pullRequestName\": $(python3 -c "import json,sys; print(json.dumps(sys.argv[1]))" "$PR_TITLE"),
+    \"pullRequestNumber\": $PR_NUMBER,
+    \"pullRequestURL\": \"$PR_URL\"
+  }" 2>&1)
+
+ATTACH_STATUS=$(echo "$ATTACH_RESULT" | python3 -c "import sys,json; r=json.load(sys.stdin); print(r[0].get('result','unknown'))" 2>/dev/null || echo "error: $ATTACH_RESULT")
+echo ">> PR attach: $ATTACH_STATUS"
+
+# Without --assign, stop after attaching
+if ! $DO_ASSIGN; then
+  exit 0
+fi
+
+# --- Step 2: Read task fields (Reviewer + Implementor) ---
+TASK_FIELDS=$(curl -s "https://app.asana.com/api/1.0/tasks/$TASK_GID?opt_fields=custom_fields.gid,custom_fields.people_value,custom_fields.number_value" \
+  -H "Authorization: Bearer $ASANA_TOKEN")
+
+read_people_field() {
+  local field_gid="$1"
+  echo "$TASK_FIELDS" | python3 -c "
+import sys, json
+data = json.load(sys.stdin)['data']
+for f in data['custom_fields']:
+    if f['gid'] == '$field_gid':
+        pv = f.get('people_value', [])
+        print(pv[0]['gid'] if pv else '')
+        break
+" 2>/dev/null || echo ""
+}
+
+REVIEWER_GID="${REVIEWER_OVERRIDE:-$(read_people_field "$REVIEWER_FIELD")}"
+IMPLEMENTOR_GID="${IMPLEMENTOR_OVERRIDE:-$(read_people_field "$IMPLEMENTOR_FIELD")}"
+
+# Auto-resolve implementor to current user if empty
+if [[ -z "$IMPLEMENTOR_GID" ]]; then
+  IMPLEMENTOR_GID=$("$SCRIPT_DIR/asana-whoami.sh" 2>/dev/null || true)
+  if [[ -n "$IMPLEMENTOR_GID" ]]; then
+    IMPLEMENTOR_OVERRIDE="$IMPLEMENTOR_GID"
+    echo ">> Implementor: auto-resolved to current user ($IMPLEMENTOR_GID)"
+  fi
+fi
+
+if [[ -z "$REVIEWER_GID" ]]; then
+  echo ">> PROMPT_REVIEWER"
+  exit 2
+fi
+
+if [[ -z "$IMPLEMENTOR_GID" ]]; then
+  echo ">> PROMPT_IMPLEMENTOR"
+  exit 2
+fi
+
+# --- Step 3: Set Implementor if override was provided ---
+if [[ -n "$IMPLEMENTOR_OVERRIDE" ]]; then
+  curl -s -X PUT "https://app.asana.com/api/1.0/tasks/$TASK_GID" \
+    -H "Authorization: Bearer $ASANA_TOKEN" \
+    -H "Content-Type: application/json" \
+    -d "{\"data\":{\"custom_fields\":{\"$IMPLEMENTOR_FIELD\":{\"people_value\":[\"$IMPLEMENTOR_OVERRIDE\"]}}}}" > /dev/null 2>&1 || true
+  echo ">> Implementor: set"
+fi
+
+# --- Step 4: Assign to reviewer and set status to Review Needed ---
+UPDATE_RESULT=$(curl -s -X PUT "https://app.asana.com/api/1.0/tasks/$TASK_GID" \
+  -H "Authorization: Bearer $ASANA_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d "{
+    \"data\": {
+      \"assignee\": \"$REVIEWER_GID\",
+      \"custom_fields\": {
+        \"$STATUS_FIELD\": \"$REVIEW_NEEDED_OPTION\"
+      }
+    }
+  }" 2>&1)
+
+ASSIGNEE_NAME=$(echo "$UPDATE_RESULT" | python3 -c "import sys,json; print(json.load(sys.stdin)['data']['assignee']['name'])" 2>/dev/null || echo "unknown")
+echo ">> Assigned to: $ASSIGNEE_NAME"
+echo ">> Status: Review Needed"
+
+# --- Step 5: Auto-populate Est. Review Hrs if empty (non-blocking) ---
+python3 -c "
+import sys, json
+data = json.loads('''$TASK_FIELDS''')['data']
+spent_dev = None
+est_review = None
+for f in data['custom_fields']:
+    if f['gid'] == '$SPENT_DEV_HRS_FIELD':
+        spent_dev = f.get('number_value')
+    elif f['gid'] == '$EST_REVIEW_HRS_FIELD':
+        est_review = f.get('number_value')
+if est_review is not None:
+    print('>> Est. Review Hrs: already set (' + str(est_review) + ')')
+elif spent_dev is None:
+    print('>> Est. Review Hrs: skipped (no Spent Dev Hrs)')
+else:
+    val = max(round(spent_dev * 0.1, 1), 0.1)
+    print(f'SET_EST_REVIEW={val}')
+" 2>/dev/null | while IFS= read -r line; do
+  if [[ "$line" == SET_EST_REVIEW=* ]]; then
+    VAL="${line#SET_EST_REVIEW=}"
+    curl -s -X PUT "https://app.asana.com/api/1.0/tasks/$TASK_GID" \
+      -H "Authorization: Bearer $ASANA_TOKEN" \
+      -H "Content-Type: application/json" \
+      -d "{\"data\":{\"custom_fields\":{\"$EST_REVIEW_HRS_FIELD\":$VAL}}}" > /dev/null 2>&1 || true
+    echo ">> Est. Review Hrs: set to $VAL (10% of Spent Dev Hrs)"
+  else
+    echo "$line"
+  fi
+done || true

.cursor/commands/asana-create-dep-task.sh

@@ -0,0 +1,202 @@
+#!/usr/bin/env bash
+# asana-create-dep-task.sh
+# Create a dependent Asana task that blocks a parent task.
+# Checks for existing dependencies first to avoid duplicates.
+#
+# Usage:
+#   asana-create-dep-task.sh --parent <parent_gid> --name "task name" [--notes "description"] [--assignee <user_gid>]
+#
+# If --assignee is omitted, the task is assigned to the current user
+# (resolved via asana-whoami.sh).
+#
+# Requires env var: ASANA_TOKEN
+#
+# Output:
+#   TASK_GID: <gid>
+#   TASK_URL: <url>
+#   CREATED: true|false (false if task already existed)
+#   ASSIGNED_TO: <user_gid>
+#   FIELDS_SET: priority=<val>, status=<val>
+#   DEPENDENCY_SET: <new_gid> blocks <parent_gid>
+#
+# Exit codes: 0 = success, 1 = error
+set -euo pipefail
+
+PARENT_GID=""
+TASK_NAME=""
+TASK_NOTES=""
+ASSIGNEE_GID=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --parent) PARENT_GID="$2"; shift 2 ;;
+    --name) TASK_NAME="$2"; shift 2 ;;
+    --notes) TASK_NOTES="$2"; shift 2 ;;
+    --assignee) ASSIGNEE_GID="$2"; shift 2 ;;
+    *) echo "Unknown flag: $1" >&2; exit 1 ;;
+  esac
+done
+
+if [[ -z "$PARENT_GID" || -z "$TASK_NAME" ]]; then
+  echo "Usage: asana-create-dep-task.sh --parent <gid> --name <name> [--notes <desc>] [--assignee <gid>]" >&2
+  exit 1
+fi
+
+if [[ -z "${ASANA_TOKEN:-}" ]]; then
+  echo "Error: ASANA_TOKEN not set" >&2
+  exit 1
+fi
+
+API="https://app.asana.com/api/1.0"
+AUTH="Authorization: Bearer $ASANA_TOKEN"
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+# Auto-resolve assignee to current user if not provided
+if [[ -z "$ASSIGNEE_GID" ]]; then
+  ASSIGNEE_GID=$("$SCRIPT_DIR/asana-whoami.sh" 2>/dev/null || true)
+fi
+
+# Phase 1: Check if a dependency with a matching name already exists
+existing=$(curl -s "$API/tasks/$PARENT_GID/dependencies?opt_fields=name&limit=100" \
+  -H "$AUTH" | python3 -c "
+import sys, json
+data = json.load(sys.stdin).get('data', [])
+target = '''$TASK_NAME'''
+for dep in data:
+    if dep.get('name', '').strip().lower() == target.strip().lower():
+        print(dep['gid'])
+        sys.exit(0)
+print('')
+")
+
+if [[ -n "$existing" ]]; then
+  echo "TASK_GID: $existing"
+  echo "TASK_URL: https://app.asana.com/0/0/$existing"
+  echo "CREATED: false"
+  exit 0
+fi
+
+# Phase 2: Get parent task's project and custom fields to copy
+parent_info=$(curl -s "$API/tasks/$PARENT_GID?opt_fields=workspace.gid,memberships.project.gid,memberships.project.name,custom_fields.gid,custom_fields.enum_value.gid,custom_fields.enum_value.name" \
+  -H "$AUTH")
+
+read -r WORKSPACE_GID PROJECT_GIDS PRIORITY_GID PRIORITY_VAL STATUS_GID STATUS_VAL < <(echo "$parent_info" | python3 -c "
+import sys, json, re
+data = json.load(sys.stdin)['data']
+ws = data.get('workspace', {}).get('gid', '')
+
+# Collect all non-version projects (board/backlog projects, not release milestones)
+projects = []
+for m in data.get('memberships', []):
+    p = m.get('project', {})
+    if not re.match(r'^\d+\.\d+\.\d+$', p.get('name', '')):
+        projects.append(p.get('gid', ''))
+if not projects and data.get('memberships'):
+    projects.append(data['memberships'][0]['project']['gid'])
+proj_str = ','.join(projects)
+
+# Custom fields to copy
+FIELD_MAP = {
+    '795866930204488': 'priority',
+    '1190660107346181': 'status',
+}
+fields = {}
+for f in data.get('custom_fields', []):
+    label = FIELD_MAP.get(f['gid'])
+    if label and f.get('enum_value'):
+        fields[label + '_gid'] = f['gid']
+        fields[label + '_val'] = f['enum_value']['gid']
+        fields[label + '_name'] = f['enum_value']['name']
+
+pri_gid = fields.get('priority_gid', '')
+pri_val = fields.get('priority_val', '')
+sta_gid = fields.get('status_gid', '')
+sta_val = fields.get('status_val', '')
+
+print(f'{ws} {proj_str} {pri_gid}:{pri_val}:{fields.get(\"priority_name\",\"\")} {sta_gid}:{sta_val}:{fields.get(\"status_name\",\"\")}')
+")
+
+PRIORITY_FIELD=$(echo "$PRIORITY_VAL" | cut -d: -f1)
+PRIORITY_ENUM=$(echo "$PRIORITY_VAL" | cut -d: -f2)
+PRIORITY_NAME=$(echo "$PRIORITY_VAL" | cut -d: -f3)
+STATUS_FIELD=$(echo "$STATUS_VAL" | cut -d: -f1)
+STATUS_ENUM=$(echo "$STATUS_VAL" | cut -d: -f2)
+STATUS_NAME=$(echo "$STATUS_VAL" | cut -d: -f3)
+
+# Phase 3: Create the task
+NOTES_JSON=$(python3 -c "import json; print(json.dumps('''$TASK_NOTES'''))")
+
+custom_fields_json="{}"
+if [[ -n "$PRIORITY_FIELD" && -n "$PRIORITY_ENUM" ]]; then
+  custom_fields_json=$(python3 -c "
+import json
+cf = {}
+pf = '$PRIORITY_FIELD'
+pe = '$PRIORITY_ENUM'
+sf = '$STATUS_FIELD'
+se = '$STATUS_ENUM'
+if pf and pe: cf[pf] = pe
+if sf and se: cf[sf] = se
+print(json.dumps(cf))
+")
+fi
+
+# Build projects list from comma-separated GIDs
+IFS=',' read -ra PROJECT_ARR <<< "$PROJECT_GIDS"
+
+new_task=$(curl -s "$API/tasks" \
+  -H "$AUTH" \
+  -H "Content-Type: application/json" \
+  -d "$(python3 -c "
+import json
+projects = '''$PROJECT_GIDS'''.split(',')
+assignee = '''$ASSIGNEE_GID''' or None
+data = {
+    'data': {
+        'name': '''$TASK_NAME''',
+        'notes': $NOTES_JSON,
+        'projects': [p for p in projects if p],
+        'workspace': '$WORKSPACE_GID',
+        'custom_fields': $custom_fields_json
+    }
+}
+if assignee:
+    data['data']['assignee'] = assignee
+print(json.dumps(data))
+")")
+
+NEW_GID=$(echo "$new_task" | python3 -c "
+import sys, json
+data = json.load(sys.stdin)
+if 'errors' in data:
+    print('ERROR: ' + json.dumps(data['errors']), file=sys.stderr)
+    sys.exit(1)
+print(data['data']['gid'])
+")
+
+if [[ -z "$NEW_GID" || "$NEW_GID" == "ERROR"* ]]; then
+  echo "Error creating task" >&2
+  exit 1
+fi
+
+FIRST_PROJECT=$(echo "$PROJECT_GIDS" | cut -d, -f1)
+echo "TASK_GID: $NEW_GID"
+echo "TASK_URL: https://app.asana.com/0/$FIRST_PROJECT/$NEW_GID"
+echo "CREATED: true"
+[[ -n "$ASSIGNEE_GID" ]] && echo "ASSIGNED_TO: $ASSIGNEE_GID"
+
+# Phase 4: Set as blocking dependency
+curl -s -X POST "$API/tasks/$PARENT_GID/addDependencies" \
+  -H "$AUTH" \
+  -H "Content-Type: application/json" \
+  -d "{\"data\": {\"dependencies\": [\"$NEW_GID\"]}}" > /dev/null
+
+echo "DEPENDENCY_SET: $NEW_GID blocks $PARENT_GID"
+
+if [[ -n "$PRIORITY_NAME" || -n "$STATUS_NAME" ]]; then
+  fields_msg=""
+  [[ -n "$PRIORITY_NAME" ]] && fields_msg="priority=$PRIORITY_NAME"
+  [[ -n "$STATUS_NAME" ]] && fields_msg="${fields_msg:+$fields_msg, }status=$STATUS_NAME"
+  echo "FIELDS_SET: $fields_msg"
+fi