@kendoo.agentdesk/agentdesk 0.4.3 → 0.4.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kendoo.agentdesk/agentdesk",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "AI team orchestrator for Claude Code — run collaborative agent sessions from your terminal",
   "type": "module",
   "bin": {

package/prompts/team.md

@@ -152,13 +152,92 @@ When a task involves UI changes, the team MUST capture screenshots of the affect
    kill $DEV_PID 2>/dev/null
    ```
 
-4. Upload screenshots to the task tracker and post them as a separate comment (see STRICT RULES above for format).
+4. Upload screenshots to the task tracker (see upload instructions below).
 
 **When to capture:**
 - After ALL code changes, reviews, and fixes are complete (during Bart's review step)
 - Before creating the PR
 - Only capture the pages/views that were actually affected by the changes
 
+### Uploading screenshots to the task tracker
+
+{{#LINEAR}}
+**Linear — Upload & attach screenshots:**
+
+Step 1: Get an upload URL from Linear:
+```bash
+UPLOAD_RESPONSE=$(curl -s -X POST https://api.linear.app/graphql \
+  -H "Authorization: $LINEAR_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"query":"mutation { fileUpload(contentType: \"image/png\", filename: \"screenshot.png\", size: '$(stat -f%z screenshot.png)') { uploadFile { uploadUrl assetUrl headers { key value } } } }"}')
+
+UPLOAD_URL=$(echo "$UPLOAD_RESPONSE" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d['data']['fileUpload']['uploadFile']['uploadUrl'])")
+ASSET_URL=$(echo "$UPLOAD_RESPONSE" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d['data']['fileUpload']['uploadFile']['assetUrl'])")
+HEADERS=$(echo "$UPLOAD_RESPONSE" | python3 -c "import sys,json; d=json.load(sys.stdin); h=d['data']['fileUpload']['uploadFile']['headers']; print(' '.join([f'-H \"{x[\"key\"]}: {x[\"value\"]}\"' for x in h]))")
+```
+
+Step 2: Upload the file to the signed URL:
+```bash
+eval curl -s -X PUT "$UPLOAD_URL" \
+  -H "Content-Type: image/png" \
+  $HEADERS \
+  --data-binary @screenshot.png
+```
+
+Step 3: Post a comment with the uploaded image URLs (as a SEPARATE comment, not inside badge blocks):
+```bash
+curl -s -X POST https://api.linear.app/graphql \
+  -H "Authorization: $LINEAR_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"query":"mutation { commentCreate(input: { issueId: \"'$ISSUE_ID'\", body: \"![Desktop]('$DESKTOP_ASSET_URL')\n\nDesktop view.\n\n![Mobile]('$MOBILE_ASSET_URL')\n\nMobile view.\" }) { success } }"}'
+```
+
+Repeat steps 1-2 for each screenshot file (desktop, mobile). Use the ASSET_URL values in the comment body.
+{{/LINEAR}}
+
+{{#JIRA}}
+**Jira — Upload & attach screenshots:**
+
+Upload each screenshot as an attachment:
+```bash
+curl -s -X POST "$JIRA_BASE_URL/rest/api/3/issue/{{TASK_ID}}/attachments" \
+  -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \
+  -H "X-Atlassian-Token: no-check" \
+  -F "file=@screenshots/desktop.png" \
+  -F "file=@screenshots/mobile.png"
+```
+
+Then post a comment referencing the attachments:
+```bash
+curl -s -X POST "$JIRA_BASE_URL/rest/api/3/issue/{{TASK_ID}}/comment" \
+  -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"body":{"type":"doc","version":1,"content":[{"type":"paragraph","content":[{"type":"text","text":"Screenshots of affected views:"}]},{"type":"mediaGroup","content":[{"type":"media","attrs":{"type":"file","collection":"","id":"desktop.png"}},{"type":"media","attrs":{"type":"file","collection":"","id":"mobile.png"}}]}]}}'
+```
+{{/JIRA}}
+
+{{#GITHUB}}
+**GitHub — Upload & attach screenshots:**
+
+GitHub supports drag-and-drop image uploads in comments. To upload via CLI, use the GitHub API:
+```bash
+# Upload image to GitHub's user content (via issue comment with image)
+# The simplest approach: create a comment with base64-embedded images or use gh CLI
+gh issue comment {{TASK_ID}} --body "$(cat <<SCREENSHOT_EOF
+**Screenshots of affected views:**
+
+Desktop (1280x800):
+![Desktop]($(python3 -c "import base64; print('data:image/png;base64,' + base64.b64encode(open('screenshots/desktop.png','rb').read()).decode())"))
+
+Mobile (375x812):
+![Mobile]($(python3 -c "import base64; print('data:image/png;base64,' + base64.b64encode(open('screenshots/mobile.png','rb').read()).decode())"))
+SCREENSHOT_EOF
+)"
+```
+
+Note: If base64 images are too large, upload them as release assets or to a gist and reference the raw URLs instead.
+{{/GITHUB}}
+
 {{#LINEAR}}
 ## LINEAR INTEGRATION