Comment

Save session notes to the current in-progress beads task.

Step 1: Find Current Task

br list --status=in_progress --json 2>/dev/null

Parse the JSON output to find in_progress tasks.

Result	Action
Single task	Use it as target
Multiple tasks	AskUserQuestion: "Which task should receive the comment?" with task titles as options
No tasks	Show error: "No in-progress task. Use /next to claim one." and STOP

Save the selected issue ID as $ISSUE_ID and title as $ISSUE_TITLE.

Step 2: Determine Content

2a: Free Text (arguments provided)

If $ARGUMENTS contains text, use it directly as $CONTENT. Skip to Step 3.

2b: Auto-Summary (no arguments)

If $ARGUMENTS is empty, delegate to mindcontext-core:note-generator agent:

Task agent: note-generator
Prompt: |
  Generate session progress notes.
  Issue: $ISSUE_ID - $ISSUE_TITLE
  Context: (infer from conversation — what is the user doing?)

  Analyze the conversation above for:
  - What was implemented, created, or fixed
  - Decisions made and rationale
  - Files modified or created
  - Blockers or issues encountered
  - Next steps

The agent returns structured markdown with ## Progress and ## Next Steps sections.

After receiving the agent's output, show it to the user:

USE AskUserQuestion:

{
  "questions": [{
    "question": "Save this comment to $ISSUE_ID?",
    "header": "Confirm",
    "options": [
      {"label": "Save as-is", "description": "Save the generated notes"},
      {"label": "Edit first", "description": "Let me modify before saving"},
      {"label": "Cancel", "description": "Don't save anything"}
    ],
    "multiSelect": false
  }]
}

Response	Action
"Save as-is"	Use agent output as $CONTENT
"Edit first"	Ask user for edited text, use that as $CONTENT
"Cancel"	Show "Cancelled." and STOP

Step 3: Save Comment

TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")

Save the comment using br:

br comments add $ISSUE_ID "## Session Update - $TIMESTAMP

$CONTENT"

Step 4: Confirm

✅ Comment saved to $ISSUE_ID