Close Issue

Close a beads issue after work is complete. This is a standalone atomic command.

Usage

/conductor:close-issue <issue-id>
/conductor:close-issue <issue-id> <reason>

Prerequisites

Before closing, ensure:

• Build passes (/conductor:verify-build)
• Tests pass (/conductor:run-tests)
• Code reviewed (/conductor:code-review or /conductor:codex-review)
• Changes committed (/conductor:commit-changes)
• Follow-ups created (/conductor:create-followups)
• Docs updated (/conductor:update-docs)

Execute

1. Verify Issue Exists

echo "=== Close Issue ==="

ISSUE_ID="${1:-$ISSUE_ID}"

if [ -z "$ISSUE_ID" ]; then
  echo "ERROR: No issue ID provided"
  echo "Usage: /conductor:close-issue <issue-id>"
  echo '{"closed": false, "error": "no issue ID"}'
  exit 1
fi

echo "Closing issue: $ISSUE_ID"
bd show "$ISSUE_ID" 2>/dev/null || {
  echo "ERROR: Issue $ISSUE_ID not found"
  echo '{"closed": false, "error": "issue not found"}'
  exit 1
}
echo ""

2. Generate Completion Summary

Summarize what was done:

# Get commit message as summary
SUMMARY=$(git log -1 --format="%s" 2>/dev/null || echo "Implemented")
echo "Summary: $SUMMARY"

3. Close the Issue

bd close "$ISSUE_ID" --reason "$SUMMARY"

if [ $? -eq 0 ]; then
  echo ""
  echo "Issue $ISSUE_ID closed"
  echo '{"closed": true, "issue": "'$ISSUE_ID'"}'
else
  echo ""
  echo "ERROR: Failed to close issue"
  echo '{"closed": false, "error": "bd close failed"}'
  exit 1
fi

4. Final Status

echo ""
echo "=== Task Complete ==="
echo "Issue: $ISSUE_ID"
echo "Branch: $(git branch --show-current)"
echo "Commit: $(git log -1 --oneline)"

Output Format

{"closed": true, "issue": "TabzChrome-abc"}
{"closed": false, "error": "issue not found"}
{"closed": false, "error": "bd close failed"}

Error Handling

If close fails:

1. Check bd show <issue-id> to verify issue exists
2. Check issue status (may already be closed)
3. Check beads database connectivity

After Closing

The conductor is responsible for:

• Merging the feature branch to main
• Killing worker's tmux session
• Removing the worktree
• Deleting the feature branch

Workers do NOT:

• Push to remote (unless explicitly asked)
• Kill their own session
• Merge branches

Composable With

• /conductor:commit-changes - Run before closing
• /conductor:create-followups - Run before closing
• /conductor:update-docs - Run before closing
• /conductor:worker-done - Full pipeline that includes this