Skip to content

Replay: Build GitHub data adapters for goal reconstruction #129

Description

@smota

Background & Problem Statement

Epic: #127

Replay MVP must work from GitHub alone. It needs adapters that collect relevant durable data without requiring local checkout, raw transcripts, or runner state.

Proposed Solution

Add GitHub adapter functions that load issues, comments, PRs, commits, checks/statuses, linked child issues, and follow-up references for a selected goal/epic/issue/PR.

Requirements

  • Load epic/child issue hierarchy from body links, labels, and references.
  • Load issue comments and workflow markers.
  • Load PR body, commits, mergedAt, merge commit, checks/status summaries where available.
  • Resolve follow-up links from comments/body.
  • Rate-limit and pagination behavior documented.
  • No raw transcript/session reads.

Acceptance criteria

  • Adapter returns complete replay source bundle for issue or PR input.
  • Pagination handles >100 comments/commits.
  • Missing permissions fail with actionable error.
  • Unit tests mock GitHub API calls.

Test plan

  • Mocked GitHub client tests.
  • Fixture tests with parent epic + child issues + merged PR.
  • Permission/error path tests.

Workflow classification

Standard tooling/product feature.

Metadata

Metadata

Assignees

No one assigned

    Labels

    awaiting-releaseManaged by multi-agent-sdlc integration lifecycle automationdrafted-by:piIssue drafted by PifeatureUser-facing product capabilityintegrated:developmentManaged by multi-agent-sdlc integration lifecycle automationproduct:cockpitAgentFlow Cockpit optional Goal Command Centerproduct:harnessHarness adapters, plugins, skills, settings, execution targetsrelease:v1.0.0Assigned to AgentFlow SDLC v1 releasestatus:v1-readyImplemented on development and awaiting v1 releasetoolingCLI tooling and automation

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions