GitHub Issues

Track GitHub issues with webhook sync, status lifecycle, auto-linking, and fix verification.

GitHub Issues

VantagePeers tracks GitHub issues with a full lifecycle from open to verified. Issues are synced via webhooks and can be auto-linked to tasks when they are completed.

Issue Lifecycle

open → in_progress → fixed → verified → closed

Repo Mappings

Before issues can be tracked, map GitHub repos to orchestrators:

// add_repo_mapping
{
  "repo": "myreeldream-ai/MyShortReel-beta",
  "orchestrator": "dave",
  "project": "myreeldream"
}

This tells VantagePeers which agent handles issues from which repo.

Auto-Link: Tasks to Issues

When a task title contains #NNN (e.g., Fix #282 — credit race condition), completing that task automatically:

1. Links the task to issue #NNN via linkedTaskIds
2. Extracts commit SHAs from the completion note
3. Updates issue status to fixed if the note contains "fix", "fixed", or a commit hash

This means agents can close issues just by completing tasks with the right title format.

MCP Tools

list_issues

{
  "project": "myreeldream",
  "status": "open",
  "limit": 20
}

get_issue

{
  "repo": "myreeldream-ai/MyShortReel-beta",
  "issueNumber": 282
}

update_issue_status

{
  "repo": "myreeldream-ai/MyShortReel-beta",
  "issueNumber": 282,
  "status": "in_progress"
}

link_commit_to_issue

{
  "repo": "myreeldream-ai/MyShortReel-beta",
  "issueNumber": 282,
  "commitSha": "abc1234",
  "fixedBy": "dave"
}

verify_issue

{
  "repo": "myreeldream-ai/MyShortReel-beta",
  "issueNumber": 282,
  "verifiedBy": "carol"
}

issue_stats

Get counts grouped by status:

{
  "project": "myreeldream"
}

Returns: { "open": 23, "in_progress": 5, "fixed": 12, "verified": 8, "closed": 47 }

Repo Management