@kendoo.agentdesk/agentdesk 0.9.11 → 0.9.13

package/cli/agents.mjs

@@ -4,8 +4,8 @@ export const BUILT_IN_AGENTS = {
   Jane: {
     badge: "●● JANE ●●",
     role: "Product Analyst / Team Lead",
-    description: "leads the session, clarifies requirements, coordinates the team, manages tracker status",
-    groundRules: "Jane focuses on requirements, scope, and coordination — she does not read code. She creates tracker tasks when needed, manages status transitions, and posts the session start/end comments.",
+    description: "leads the session, clarifies requirements, coordinates the team, manages tracker status, decomposes large tasks into subtasks",
+    groundRules: "Jane focuses on requirements, scope, and coordination — she does not read code. She creates tracker tasks when needed, manages status transitions, posts the session start/end comments, and decomposes large features into subtasks (basic vs deferred).",
     planning: "Requirements: what we're building, acceptance criteria, scope. Flags UI tasks for Luna.",
     execution: {
       step: "Jane wraps up",
@@ -202,10 +202,153 @@ export function resolveTeam(config) {
   return team;
 }
 
+/**
+ * Return tracker-specific command snippets for execution steps.
+ */
+function trackerCommands(tracker, config) {
+  if (!tracker) return null;
+
+  if (tracker === "linear") {
+    return {
+      postPrLink: [
+        'Post PR link on Linear using attachmentCreate:',
+        '```',
+        'curl -s -X POST https://api.linear.app/graphql \\',
+        '  -H "Authorization: $LINEAR_API_KEY" -H "Content-Type: application/json" \\',
+        '  -d \'{"query":"mutation { attachmentCreate(input: { issueId: \\"$ISSUE_ID\\", title: \\"Pull Request\\", url: \\"$PR_URL\\" }) { success } }"}\'',
+        '```',
+      ].join('\n'),
+      attachScreenshots: [
+        'Upload each screenshot via Linear fileUpload mutation, then post a comment with the image URLs:',
+        '```bash',
+        'for f in screenshots/*.png; do',
+        '  UPLOAD=$(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: \\"\'$(basename "$f")\'\\", size: \'$(stat -f%z "$f")\') { uploadFile { uploadUrl assetUrl headers { key value } } } }"}\')',
+        '  # Extract uploadUrl, assetUrl, headers from $UPLOAD — PUT the file to uploadUrl, then collect assetUrl',
+        'done',
+        '# Post a comment with all image URLs as markdown images',
+        '```',
+      ].join('\n'),
+      agentComment: [
+        'Post a comment on Linear with key findings:',
+        '```',
+        '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: \\"<COMMENT>\\" }) { success } }"}\'',
+        '```',
+      ].join('\n'),
+      transitionToReview: [
+        'Transition to "In Review" on Linear:',
+        '```',
+        'curl -s -X POST https://api.linear.app/graphql \\',
+        '  -H "Authorization: $LINEAR_API_KEY" -H "Content-Type: application/json" \\',
+        '  -d \'{"query":"mutation { issueUpdate(id: \\"$ISSUE_ID\\", input: { stateId: \\"$IN_REVIEW_STATE_ID\\" }) { success } }"}\'',
+        '```',
+        'Find the "In Review" state ID from workflowStates first.',
+      ].join('\n'),
+      postSummary: [
+        'Post final summary comment on Linear (use commentCreate mutation above).',
+      ].join('\n'),
+    };
+  }
+
+  const baseUrl = config?.jira?.baseUrl || '$JIRA_BASE_URL';
+  if (tracker === "jira") {
+    return {
+      postPrLink: [
+        'Post PR link on Jira as a remote link:',
+        '```bash',
+        `curl -s -X POST -u "$JIRA_EMAIL:$JIRA_API_TOKEN" -H "Content-Type: application/json" \\`,
+        `  "${baseUrl}/rest/api/3/issue/$TASK_ID/remotelink" \\`,
+        `  -d '{"object":{"url":"$PR_URL","title":"Pull Request"}}'`,
+        '```',
+      ].join('\n'),
+      attachScreenshots: [
+        'Upload each screenshot as a Jira attachment:',
+        '```bash',
+        `for f in screenshots/*.png; do`,
+        `  curl -s -X POST -u "$JIRA_EMAIL:$JIRA_API_TOKEN" \\`,
+        `    -H "X-Atlassian-Token: no-check" \\`,
+        `    -F "file=@$f" \\`,
+        `    "${baseUrl}/rest/api/3/issue/$TASK_ID/attachments"`,
+        `done`,
+        '```',
+      ].join('\n'),
+      agentComment: [
+        'Post a comment on Jira with key findings:',
+        '```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>"}]}]}}'`,
+        '```',
+      ].join('\n'),
+      transitionToReview: [
+        'Transition task to "In Review" on Jira:',
+        '```bash',
+        `# First get available transitions:`,
+        `curl -s -u "$JIRA_EMAIL:$JIRA_API_TOKEN" "${baseUrl}/rest/api/3/issue/$TASK_ID/transitions"`,
+        `# Then transition (find the "In Review" transition ID):`,
+        `curl -s -X POST -u "$JIRA_EMAIL:$JIRA_API_TOKEN" -H "Content-Type: application/json" \\`,
+        `  "${baseUrl}/rest/api/3/issue/$TASK_ID/transitions" \\`,
+        `  -d '{"transition":{"id":"<TRANSITION_ID>"}}'`,
+        '```',
+      ].join('\n'),
+      postSummary: [
+        `Post final summary comment on Jira (use comment endpoint above).`,
+      ].join('\n'),
+    };
+  }
+
+  if (tracker === "github") {
+    return {
+      postPrLink: [
+        'Reference the issue in the PR body ("Closes #$TASK_ID") and post a comment:',
+        '```bash',
+        'gh issue comment $TASK_ID --body "PR created: $PR_URL"',
+        '```',
+      ].join('\n'),
+      attachScreenshots: [
+        'Upload screenshots and post them in a GitHub issue comment:',
+        '```bash',
+        'BODY=""',
+        'for f in screenshots/*.png; do',
+        '  BASE64=$(base64 < "$f")',
+        '  BODY="$BODY![$(basename $f)](data:image/png;base64,$BASE64)\\n"',
+        'done',
+        'gh issue comment $TASK_ID --body "$BODY"',
+        '```',
+      ].join('\n'),
+      agentComment: [
+        'Post a comment on GitHub with key findings:',
+        '```bash',
+        'gh issue comment $TASK_ID --body "<COMMENT>"',
+        '```',
+      ].join('\n'),
+      transitionToReview: [
+        'Add "in review" label on GitHub:',
+        '```bash',
+        'gh issue edit $TASK_ID --remove-label "in progress" --add-label "in review" 2>/dev/null || true',
+        '```',
+      ].join('\n'),
+      postSummary: [
+        'Post final summary comment on GitHub:',
+        '```bash',
+        'gh issue comment $TASK_ID --body "<SUMMARY>"',
+        '```',
+      ].join('\n'),
+    };
+  }
+
+  return null;
+}
+
 /**
  * Generate the dynamic parts of the prompt from the team.
+ * @param {Array} team - resolved team array
+ * @param {Object} opts - optional { tracker, config } for tracker-specific execution steps
  */
-export function generateTeamPrompt(team) {
+export function generateTeamPrompt(team, opts = {}) {
   const count = team.length;
   const agentWord = count === 1 ? "one AI agent" : `${count} AI agents`;
 
@@ -246,15 +389,55 @@ export function generateTeamPrompt(team) {
     `${a.badge}  ${a.planning}`
   ).join("\n");
 
-  // Execution steps
+  // Execution steps — inject tracker-specific commands
+  const cmds = trackerCommands(opts.tracker, opts.config);
   const execAgents = team
     .filter(a => a.execution)
     .sort((a, b) => a.execution.order - b.execution.order);
   let stepNum = 1;
   const execSteps = [];
   for (const a of execAgents) {
-    const tasks = a.execution.tasks.map((t, i) => `${i + 1}. ${t}`).join("\n");
-    execSteps.push(`### Step ${stepNum} — ${a.name} ${a.execution.step.replace(/^[A-Za-z]+ /, "")}:\n${tasks}`);
+    let tasks = [...a.execution.tasks];
+
+    if (cmds) {
+      // Bart: expand PR link + tracker comment tasks with actual commands
+      if (a.name === "Bart") {
+        tasks = tasks.map(t => {
+          if (/PR link/i.test(t) || /Post PR.*tracker/i.test(t)) {
+            return `Push and create PR.\n   ${cmds.postPrLink}`;
+          }
+          if (/screenshot.*tracker/i.test(t)) {
+            return `Upload screenshots to tracker, then post a comment.\n   ${cmds.attachScreenshots}\n   ${cmds.agentComment.replace('<COMMENT>', 'Screenshots attached — see attachments above.')}`;
+          }
+          return t;
+        });
+      }
+
+      // Jane: expand transition + summary tasks
+      if (a.name === "Jane") {
+        tasks = tasks.map(t => {
+          if (/transition.*in review/i.test(t) || /move.*in review/i.test(t)) {
+            return `Transition task to "In Review".\n   ${cmds.transitionToReview}`;
+          }
+          if (/summary.*tracker/i.test(t) || /final summary/i.test(t)) {
+            return `Post final summary comment on tracker.\n   ${cmds.postSummary}`;
+          }
+          return t;
+        });
+      }
+
+      // Dennis & Sam: expand tracker comment
+      if (a.name === "Dennis" || a.name === "Sam") {
+        const hasTrackerTask = tasks.some(t => /tracker/i.test(t) || /comment/i.test(t));
+        if (!hasTrackerTask) {
+          const findingsLabel = a.name === "Dennis" ? "Files changed, technical decisions" : "Architecture concerns or clean audit";
+          tasks.push(`Post comment on tracker with key findings (${findingsLabel}).\n   ${cmds.agentComment}`);
+        }
+      }
+    }
+
+    const taskList = tasks.map((t, i) => `${i + 1}. ${t}`).join("\n");
+    execSteps.push(`### Step ${stepNum} — ${a.name} ${a.execution.step.replace(/^[A-Za-z]+ /, "")}:\n${taskList}`);
     stepNum++;
   }
   sections.executionSteps = execSteps.join("\n\n");

package/cli/daemon.mjs

@@ -365,7 +365,7 @@ export async function runDaemon() {
 
       // Resolve team
       const team = resolveTeam(config);
-      const teamSections = generateTeamPrompt(team);
+      const teamSections = generateTeamPrompt(team, { tracker, config });
 
       const inboxUrl = `${agentdeskServer}/api/sessions/${sessionId}/inbox`;
       const sessionUrl = `${agentdeskServer}/sessions/${sessionId}`;

package/cli/team.mjs

@@ -82,7 +82,7 @@ export async function runTeam(taskId, opts = {}) {
 
   // Resolve team and generate dynamic prompt sections
   const team = resolveTeam(config);
-  const teamSections = generateTeamPrompt(team);
+  const teamSections = generateTeamPrompt(team, { tracker, config });
 
   // --- Verify tracker permissions before starting session ---
   if (tracker) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kendoo.agentdesk/agentdesk",
-  "version": "0.9.11",
+  "version": "0.9.13",
   "description": "AI team orchestrator for Claude Code — run collaborative agent sessions from your terminal",
   "type": "module",
   "bin": {
@@ -21,7 +21,7 @@
     "server": "node server/index.mjs",
     "build": "vite build",
     "preview": "vite preview",
-    "test": "node --test tests/server.test.mjs"
+    "test": "node --test tests/server.test.mjs tests/agents.test.mjs tests/homepage.test.mjs"
   },
   "dependencies": {
     "bcryptjs": "^3.0.3",

package/prompts/team.md

@@ -231,6 +231,88 @@ Jane MUST post the session start comment and set "In Progress" before moving on.
 
 Output on its own line: `SESSION_TITLE: <4-8 word title>`
 
+### Decompose (if needed)
+
+After assessing the task, Jane evaluates whether it is **too large for a single session**. Signs of a large task:
+- Multiple independent workstreams or features
+- Cross-cutting concerns spanning 3+ areas of the codebase
+- Estimated effort exceeding what a team session can deliver in one run
+- The description explicitly describes an epic, initiative, or multi-part feature
+
+**If the task is small/focused** — skip decomposition, proceed to PLAN.
+
+**If the task is large**, Jane decomposes it:
+
+1. **Check current issue type.** If the task is already a subtask of another issue, do NOT decompose further — just work on it.
+
+2. **Break the feature into subtasks.** Draft 3-8 subtasks that together would deliver the full feature. Each subtask should be independently deliverable.
+
+3. **Classify each subtask:**
+   - `[basic]` — straightforward, low-risk, can be completed by the team in this session
+   - `[deferred]` — complex, needs user input, or depends on external factors
+
+4. **Create subtasks in the tracker:**
+
+{{#JIRA}}
+   For each subtask, create a Jira issue with the original task as parent:
+   ```bash
+   curl -s -X POST -u "$JIRA_EMAIL:$JIRA_API_TOKEN" -H "Content-Type: application/json" \
+     "{{JIRA_BASE_URL}}/rest/api/3/issue" \
+     -d '{
+       "fields": {
+         "project": {"key": "<PROJECT_KEY>"},
+         "parent": {"key": "{{TASK_ID}}"},
+         "summary": "<subtask summary>",
+         "description": {"type":"doc","version":1,"content":[{"type":"paragraph","content":[{"type":"text","text":"<subtask description>"}]}]},
+         "issuetype": {"name": "Subtask"},
+         "labels": ["basic"] or ["deferred"]
+       }
+     }'
+   ```
+   Note: Extract the project key from {{TASK_ID}} (the part before the hyphen).
+{{/JIRA}}
+
+{{#LINEAR}}
+   For each subtask, create a Linear sub-issue:
+   ```
+   mutation {
+     issueCreate(input: {
+       teamId: "$TEAM_ID"
+       parentId: "$PARENT_ISSUE_ID"
+       title: "<subtask title>"
+       description: "<subtask description>"
+       labelIds: ["$BASIC_OR_DEFERRED_LABEL_ID"]
+     }) { success issue { id identifier title } }
+   }
+   ```
+   First fetch the parent issue's teamId and id. Create "basic" and "deferred" labels if they don't exist.
+{{/LINEAR}}
+
+{{#GITHUB}}
+   GitHub doesn't support native subtasks. Instead:
+   - Edit the original issue body to add a task list:
+     ```
+     ## Subtasks
+     - [ ] [basic] Subtask 1 description
+     - [ ] [basic] Subtask 2 description
+     - [ ] [deferred] Subtask 3 description
+     ```
+   - Create separate linked issues for each subtask with a `subtask` label:
+     ```bash
+     gh issue create --title "[basic] Subtask title" --body "Parent: #{{TASK_ID}}\n\nDescription..." --label subtask
+     ```
+{{/GITHUB}}
+
+{{#NO_TRACKER}}
+   Without a tracker, list the subtasks in the session output with their classification. The user can create tracker tasks manually.
+{{/NO_TRACKER}}
+
+5. **Post decomposition summary** on the tracker as a comment. List all subtasks with their classification.
+
+6. **Announce to the team** which `[basic]` subtasks will be tackled in this session. The `[deferred]` subtasks are left for the user to schedule.
+
+7. **Continue to PLAN** with only the `[basic]` subtasks in scope.
+
 ---
 
 ## PLAN (1-2 rounds max)