docs(writing-agent-relay-workflows): pr_url verification + github-primitive PR contract#40
docs(writing-agent-relay-workflows): pr_url verification + github-primitive PR contract#40khaliqgant wants to merge 1 commit into
Conversation
…ithub-primitive PR contract
Recommends pairing `verification: { type: 'pr_url', value: 'owner/repo' }`
(landing in @agent-relay/workflow-types via relay#852) with
`createGitHubStep({ action: 'createPR' })` so the worker opens the PR
through the github-primitive — not raw `gh pr create` — and the verifier
catches a missing PR before the step completes.
Closes the failure mode where proactive-runtime M3 workers reported
OWNER_DECISION: COMPLETE with green tests but no PR open on any branch.
|
Warning Rate limit exceeded
You’ve run out of usage credits. Purchase more in the billing tab. ⌛ How to resolve this issue?After the wait time has elapsed, a review can be triggered using the We recommend that you space out your commits to avoid hitting the rate limit. 🚦 How do rate limits work?CodeRabbit enforces hourly rate limits for each developer per organization. Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout. Please see our FAQ for further information. ℹ️ Review info⚙️ Run configurationConfiguration used: Organization UI Review profile: CHILL Plan: Pro Plus Run ID: 📒 Files selected for processing (1)
✨ Finishing Touches🧪 Generate unit tests (beta)
Comment |
Summary
Documents the new `verification: { type: 'pr_url', value: 'owner/repo' }` check (landing in `@agent-relay/workflow-types` via relay#852) and pairs it with the existing `createGitHubStep({ action: 'createPR' })` guidance so the worker always publishes the PR through the github-primitive — not raw `gh pr create` — and the verifier refuses to mark the step complete when no GitHub PR URL appears in the output.
Motivation
The proactive-runtime M3 swarm shipped six Track A–F implementation steps. Every worker posted `OWNER_DECISION: COMPLETE` with green tests and a clean process exit, and every worker forgot to actually open a pull request. The runner's evidence-based completion path accepted that — file mods + positive-conclusion text + exit 0 was enough. `pr_url` closes that loophole declaratively; pairing it with `createGitHubStep` ensures the worker uses the same primitive whether it runs locally (gh CLI) or in cloud (Nango), and that its output naturally contains a URL the verifier can find.
Changes
🤖 Generated with Claude Code