groodev/ops-review repository overview

⁠Review Service

Automated code review service powered by Claude Agent SDK. Runs inside a Cloudflare Container, managed by the ops API via a Durable Object.

⁠Architecture

ops API Worker
    |  REVIEW_CONTAINER.idFromName("repo:type")
    v
ReviewContainer DO --> Cloudflare Container (this service)
    |                       |
    |  forwards HTTP        |  Hono on port 3100
    |                       |  git clone, Claude agent
    v                       v

Each unique repo:reviewType pair gets its own DO instance and container. The DO starts the container on first request and forwards HTTP to it. On review completion, the container POSTs results back to the ops API via callback.

⁠API

⁠POST /review

Start a new review job.

{
  "repo": "owner/repo/project",
  "review_type": "security",
  "git_tag": "v1.0.0",
  "job_id": "report-uuid-from-ops-db",
  "callback_url": "https://ops.groo.dev/v1/review/callback"
}

Returns 202 with the internal job ID.

⁠GET /status/:id

Get job status and result.

⁠GET /logs/:id

SSE stream of job logs. Sends event: done when the job completes or fails.

⁠GET /health

Returns { "status": "ok" }.

⁠Environment Variables

⁠Docker

# Build
docker build -t groodev/ops-review .

# Run locally
docker run -p 3100:3100 \
  -e CLAUDE_CODE_OAUTH_TOKEN=... \
  -e GITHUB_TOKEN=... \
  groodev/ops-review

The image is published to Docker Hub⁠ on every push to main that changes review/.

⁠Development

npm install
npm run dev    # starts with tsx watch