OpenHands / OpenHands/extensions
Provide a role-scoped GitHub gateway for Docker automations
Nobody has claimed this yet.
- 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
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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