@kendoo.agentdesk/agentdesk 0.9.14 → 0.9.15

package/cli/agents.mjs

@@ -276,11 +276,17 @@ function trackerCommands(tracker, config) {
         '```',
       ].join('\n'),
       agentComment: [
-        'Post a comment on Jira with key findings:',
+        'Post a comment on Jira with key findings. IMPORTANT: Any URLs in the comment MUST use ADF inlineCard nodes so they render as clickable links:',
         '```bash',
         `curl -s -X POST -u "$JIRA_EMAIL:$JIRA_API_TOKEN" -H "Content-Type: application/json" \\`,
         `  "${baseUrl}/rest/api/3/issue/$TASK_ID/comment" \\`,
-        `  -d '{"body":{"type":"doc","version":1,"content":[{"type":"paragraph","content":[{"type":"text","text":"<COMMENT>"}]}]}}'`,
+        `  -d '<ADF_BODY>'`,
+        '```',
+        'For plain text: `{"type":"text","text":"..."}`',
+        'For clickable URLs: `{"type":"inlineCard","attrs":{"url":"https://..."}}`',
+        'Example body with a link:',
+        '```json',
+        '{"body":{"type":"doc","version":1,"content":[{"type":"paragraph","content":[{"type":"text","text":"Session: "},{"type":"inlineCard","attrs":{"url":"https://agentdesk.live/sessions/..."}}]}]}}',
         '```',
       ].join('\n'),
       transitionToReview: [

package/package.json

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

package/prompts/team.md

@@ -136,15 +136,36 @@ Keep comments to bullet points. The tracker should tell the story without the da
 
 Post comments using badge format with session link: {{SESSION_URL}}
 
+### Clickable URLs in Jira comments
+
+IMPORTANT: Jira REST API v3 uses ADF (Atlassian Document Format). Plain text URLs are NOT clickable. Always use `inlineCard` nodes for any URL you post:
+
+```json
+{"body":{"type":"doc","version":1,"content":[
+  {"type":"paragraph","content":[
+    {"type":"text","text":"Session: "},
+    {"type":"inlineCard","attrs":{"url":"https://agentdesk.live/sessions/..."}}
+  ]}
+]}}
+```
+
+- Plain text: `{"type":"text","text":"some text"}`
+- Clickable link: `{"type":"inlineCard","attrs":{"url":"<URL>"}}`
+- Line break between paragraphs: use separate `{"type":"paragraph","content":[...]}` blocks
+
 ### Required tracker actions
 
-1. **Session start (Jane):** Post "Team session started. Session: {{SESSION_URL}}" and transition to "In Progress":
+1. **Session start (Jane):** Post "Team session started" with clickable session link and transition to "In Progress":
    ```bash
    curl -s -u "$JIRA_EMAIL:$JIRA_API_TOKEN" "{{JIRA_BASE_URL}}/rest/api/3/issue/{{TASK_ID}}/transitions"
    # Find "In Progress" transition ID, then:
    curl -s -X POST -u "$JIRA_EMAIL:$JIRA_API_TOKEN" -H "Content-Type: application/json" \
      "{{JIRA_BASE_URL}}/rest/api/3/issue/{{TASK_ID}}/transitions" \
      -d '{"transition":{"id":"<TRANSITION_ID>"}}'
+   # Post session start comment with clickable link:
+   curl -s -X POST -u "$JIRA_EMAIL:$JIRA_API_TOKEN" -H "Content-Type: application/json" \
+     "{{JIRA_BASE_URL}}/rest/api/3/issue/{{TASK_ID}}/comment" \
+     -d '{"body":{"type":"doc","version":1,"content":[{"type":"paragraph","content":[{"type":"text","text":"Team session started. Session: "},{"type":"inlineCard","attrs":{"url":"{{SESSION_URL}}"}}]}]}}'
    ```
 
 2. **PR created (Bart):** Post PR link and attach as remote link:
@@ -154,14 +175,50 @@ Post comments using badge format with session link: {{SESSION_URL}}
      -d '{"object":{"url":"$PR_URL","title":"Pull Request"}}'
    ```
 
-3. **Session end (Jane):** Transition to "In Review" and post summary.
+3. **Session end (Jane):** Transition to "In Review", attach session protocol, and post summary.
+
+### Session protocol attachment
+
+At the end of the session, Jane MUST create and attach a session protocol file to the Jira task. This is a text file summarizing the entire session:
+
+```bash
+cat > /tmp/session-protocol.txt << 'PROTOCOL'
+Session Protocol — {{TASK_ID}}
+Date: $(date -u +"%Y-%m-%d %H:%M UTC")
+Session: {{SESSION_URL}}
+
+## Agents
+<list each agent and their role>
+
+## Plan
+<brief plan summary>
+
+## Changes Made
+<list of files changed and what was done>
+
+## Decisions
+<key technical decisions and reasoning>
+
+## PR
+<PR URL if created>
+
+## Status
+<final status — e.g., "In Review", "Blocked", etc.>
+PROTOCOL
+
+# Attach to Jira task
+curl -s -X POST -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \
+  -H "X-Atlassian-Token: no-check" \
+  -F "file=@/tmp/session-protocol.txt" \
+  "{{JIRA_BASE_URL}}/rest/api/3/issue/{{TASK_ID}}/attachments"
+```
 
 ### Agent tracker comments
 
-After completing work, agents post a brief comment on the tracker with key findings:
+After completing work, agents post a brief comment on the tracker with key findings. All URLs MUST use inlineCard:
 - **Dennis**: Files changed, technical decisions
 - **Sam**: Architecture concerns or clean audit
-- **Bart**: PR link, test results, screenshots
+- **Bart**: PR link (as inlineCard), test results, screenshots
 
 Keep comments to bullet points. The tracker should tell the story without the dashboard.
 {{/JIRA}}