Manual Reviews

Manual review is the primary control path. It creates a normal review.Request and sends it through the same bounded worker queue as webhook work. The rest of the pipeline is identical: SCM enrichment, context selection, model review, finding validation, draft output, and human approval before final publication.

Inputs

Provider	Required identifiers	Example run ID
GitHub	repository as owner/repo, pr_number	owner/repo!7
GitLab	project_id, mr_iid	25!19

Use the provider identifiers from the SCM system, not local branch names.

Trigger a review

CLI

7review review github --repo owner/repo --pr 7 --server http://localhost:8080
7review review gitlab --project 25 --mr 19 --server http://localhost:8080

Tool API

curl -fsS \
  -H "Authorization: Bearer $REVIEW_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"request_review","input":{"provider":"gitlab","project_id":"25","mr_iid":19}}' \
  http://localhost:8080/tools/execute

GitHub payload:

{
  "name": "request_review",
  "input": {
    "provider": "github",
    "repository": "owner/repo",
    "pr_number": 7
  }
}

Docker Make

make docker-review-gitlab PROJECT_ID=25 MR=19
make docker-review-github REPO=owner/repo PR=7

Response semantics

A successful request returns the run ID and an enqueued status. A rejected request should include a reason.

Result	Meaning	Typical fix
enqueued	The job entered the bounded worker queue	Inspect it with sessions or session
already running or conflict	The same run ID is queued or running	Wait for the current run or inspect it
queue full	The server accepted the request format but has no queue capacity	Increase WEBHOOK_QUEUE_SIZE or retry later
validation error	Provider, repository, project, PR, or MR input is missing or invalid	Correct the identifiers

Manual triggers can create a fresh rerun after a previous run completed or failed. They do not double-enqueue the same currently running run.

Inspect the result

7review sessions --server http://localhost:8080
7review session owner/repo!7 --server http://localhost:8080
7review history owner/repo!7 --server http://localhost:8080

For GitLab, replace the run ID with project_id!mr_iid:

7review session 25!19 --server http://localhost:8080

Operational notes

• Manual review still uses WEBHOOK_WORKERS, WEBHOOK_QUEUE_SIZE, and WEBHOOK_JOB_TIMEOUT_MS.
• Manual review does not bypass provider authentication or SCM enrichment.
• Webhook policy does not block manual requests; the operator is the policy decision for manual mode.
• Final publication remains an explicit human action after draft output is prepared.