Skip to content

[FEATURE] Create pull requests and merge/rework gates from approved workforce output #69

Description

@Joncallim

Roadmap source

docs/roadmap.md -> P2 Workforce and Autonomous Coding -> Next execution slices 7-8.

Problem

Forge should eventually turn approved specialist output into commits and GitHub pull requests, then require merge/rework decisions. This must build on VCS evidence and QA/Reviewer gates rather than jumping straight from generated output to merge.

Concrete plan

  1. Add PR creation only after repository evidence, validation output, QA gate, and Reviewer gate are complete.
  2. Persist commit SHA, branch, PR URL, check status, and merge readiness in vcs_changes.
  3. Add a final human merge approval gate with explicit rework and cancel paths.
  4. Poll or refresh GitHub check status with clear degraded states when GitHub auth is missing.
  5. Keep automatic merge disabled until all required gates are green and the operator approves.

Acceptance criteria

  • Forge can create a PR from an approved branch and attach the PR URL to the task.
  • CI/check status is visible and blocks merge readiness while pending/failing.
  • Rework sends the task/package back to an actionable state with the review reason.
  • Merge is impossible without final human approval.

Validation

  • GitHub integration tests/mocks for PR creation and check status mapping.
  • API tests for merge/rework gate transitions.
  • UI tests for PR/check/merge readiness states.
  • npm run lint, npx tsc --noEmit, npm test, npm run build.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions