komrad

release_review

Release the caller's review with a verdict: approved only when the caller started no thread on the snapshot, changes requested when it started any.

writesnot idempotentMCP toolAgent

Komrad mails the agent under review once, naming the review for get_review. An approval tells the agent its work is done.

Calling it#

curl -X POST http://127.0.0.1:8787/komrad.agent.v1.AgentService/ReleaseReview \
  -H 'Content-Type: application/json' \
  -d '{}'

Request#

ReleaseReviewRequest#

ReleaseReviewRequest releases the caller's open review on a task.

FieldTypeDescription
one of

The task the review is on. Unset uses the caller's own task.

task_iduuid

The task, by id.

task_slugstring

not empty

The task, by slug.

verdictReviewVerdict

The review's verdict.

bodystring

at most 1500 characters

What the reviewer says about the work as a whole. The writer reads it before the threads.

Response#

ReleaseReviewResponse#

FieldTypeDescription
reviewReview

The review as released, with its verdict.

commentsint32

How many comments the review released.

pathstring

The absolute path of the file the review was written to.

Types#

Review#

Review is a reviewer agent's comments on one snapshot, released to the writer together. The review is private until the agent releases it.

FieldTypeDescription
iduuid*

The review's id.

task_iduuid*

The id of the task the review is on.

snapshot_iduuid*

The id of the snapshot the review is written against.

snapshot_ordinalint32

The number of the snapshot the review is written against.

author_kindReviewAuthorKind

Who wrote the review.

author_agent_iduuid

The id of the agent that wrote the review. Unset when a forge user wrote it.

verdictReviewVerdict

The review's verdict. Unspecified until the review is released.

released_attimestamp

When the review was released. Unset until then.

pathstring

The absolute path of the file the released review was written to.

created_attimestamp

When the review was created with its first comment.

updated_attimestamp

When the review last changed.

bodystring

What the author said about the work as a whole. Empty when the author said nothing.

open_threadsint32

How many of the review's threads are not resolved. A released review with none is finished, whatever its verdict.

external_loginstring

The forge login of the author of a review copied from the forge. Empty otherwise.

ReviewVerdict#

ReviewVerdict is what a review concludes about a snapshot.

ValueDescription
approved

The snapshot is good as it stands.

changes_requested

The writer has more to do.

commented

Comments without a conclusion either way.

ReviewAuthorKind#

ReviewAuthorKind is who wrote a review or comment.

ValueDescription
human

The person.

agent

An agent, either the writer or a reviewer.

forge

A forge user, whose comment komrad copied from the pull request.