OpenHands / OpenHands/extensions

Provide a role-scoped GitHub gateway for Docker automations

Open
#558 5 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement ready-for-dev
Dominant language
Python
Stars
148
Forks
90
Avg merge
1d 17h
Merged PRs (30d)
36

Description

Desired Behavior

Provide a repository-scoped GitHub gateway for Docker automations. The trusted control plane retains the GitHub credential, while triage, implementation, review, and watchdog workers receive separate role tokens. This is the independently reviewable permission boundary used by the software-factory recipe in #556.

Acceptance Criteria
  • Role allowlists restrict writes to issue readiness, factory implementation branches, exact-commit review evidence, or guarded merge according to the selected role.
  • Private repository snapshots are available for exact commits without handing the GitHub credential to a worker.
  • Merge rejects changed heads, stale bases, missing acceptance statuses, failing/pending checks, and conflicts, and includes the reviewed SHA in the merge request.
  • Workers cannot administer/delete repositories, write main directly, force push, or invoke an unguarded merge.
  • Authorization and fail-closed merge tests pass without credentials or network access; setup documents the trust boundary and limits.

ready-for-dev: scope and acceptance criteria are defined.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading the software-factory recipe in #556 and tracing how its triage, implementation, review, and watchdog workers currently access GitHub. Define the gateway against every listed acceptance criterion, then verify authorization and fail-closed merge behavior with tests that use neither credentials nor network access.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, github, python
Domain
authorization, backend-api-design, security
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.