ck_review_submit
Submit a governed plan, diff, or completion for human review. Creates a review record with ID and URL for approval decisions.
Instructions
Submit a governed plan, diff, or completion packet for human review and execution gating. Write operation — creates a review record and returns a review_id and browser URL. review_type controls what is being submitted: plan (before implementation), diff (before merging), or completion (task done). submission_body is the full content: plan text, diff, or completion description. For iterative plan refinement, pass previous_review_id and plan_phase (ticket → research_packet → design_options → narrowed_decision → implementation_plan → code_backed_plan). Returns review_id, status (pending), and a URL where the human reviewer can approve or deny. After submission, poll ck_review_status until the decision is approved or denied before proceeding. Use ck_review_feedback (human-facing) to record a decision on an existing review.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| alignment_context | No | ||
| annotations | No | Structured key-value annotations for machine-readable metadata. | |
| code_snippets | No | ||
| codebase_findings | No | ||
| consulted_roles | No | ||
| feedback_notes | No | Freeform feedback notes from the reviewer. | |
| implementation_steps | No | ||
| metadata | No | Arbitrary key-value metadata for extensibility and audit context. | |
| options_considered | No | ||
| plan_phase | No | Current phase of plan refinement. | |
| previous_review_id | No | Reference to a prior review for iterative refinement. | |
| prior_art_summary | No | Summary of prior attempts or related work. | |
| rejected_options | No | ||
| research_summary | No | Summary of research performed before this submission. | |
| review_type | No | Type of review being submitted or queried (plan, diff, or completion). | |
| scope_estimate | No | ||
| selected_option | No | The chosen approach with rationale. | |
| session_id | No | Unique session identifier for correlating findings, proofs, budget, and audit trail. | |
| submission_body | Yes | Full submission content: plan text, diff, or completion description. | |
| submitted_by | No | Identity of the submitter for audit trail. | |
| task_id | No | Task identifier within the session for scoped operations. | |
| title | No | Human-readable title for display and search. | |
| validation_plan | No |