relay-cc 2.0.0

package/commands/relay/review.md

@@ -0,0 +1,322 @@
+---
+name: relay:review
+description: Review a PR or address review comments on your own PR
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - AskUserQuestion
+---
+
+<objective>
+Two modes:
+- **Mode A — Review a PR**: Analyze someone else's PR with a code review agent
+- **Mode B — Address comments**: Fix review comments on your own PR
+
+Selected upfront via user choice.
+</objective>
+
+<context>
+@.relay/config.json
+@.relay/STATE.md
+</context>
+
+<process>
+
+## 0. Pre-flight
+
+```bash
+test -f .relay/config.json && echo "config exists" || echo "no config"
+command -v gh >/dev/null 2>&1 && echo "gh available" || echo "gh missing"
+```
+
+If no config: suggest `/relay:setup` and STOP.
+If `gh` CLI not available: report that `gh` is required and STOP.
+
+Read model profile:
+```bash
+MODEL_PROFILE=$(cat .relay/config.json 2>/dev/null | grep -o '"model_profile"[[:space:]]*:[[:space:]]*"[^"]*"' | grep -o '"[^"]*"$' | tr -d '"' || echo "balanced")
+```
+
+**Model lookup table:**
+
+| Agent | quality | balanced | budget |
+|-------|---------|----------|--------|
+| relay-reviewer | opus | sonnet | sonnet |
+
+## 1. Choose Mode
+
+```
+AskUserQuestion(
+  header: "Review",
+  question: "What would you like to do?",
+  options: [
+    { label: "Review a PR", description: "Analyze someone else's PR and provide code review" },
+    { label: "Address comments", description: "Fix review comments on your own PR" }
+  ]
+)
+```
+
+---
+
+## Mode A — Review a PR
+
+### A1. List Open PRs
+
+```bash
+gh pr list --state open --limit 20
+```
+
+If no open PRs: report and STOP.
+
+```
+AskUserQuestion(
+  header: "PR",
+  question: "Which PR would you like to review?",
+  options: [
+    { label: "#${PR_1_NUM}", description: "${PR_1_TITLE}" },
+    { label: "#${PR_2_NUM}", description: "${PR_2_TITLE}" },
+    { label: "#${PR_3_NUM}", description: "${PR_3_TITLE}" }
+  ]
+)
+```
+
+### A2. Save Current Branch and Checkout PR
+
+```bash
+ORIGINAL_BRANCH=$(git branch --show-current)
+git fetch origin
+gh pr checkout ${PR_NUMBER}
+```
+
+### A3. Get Diff
+
+```bash
+BASE_BRANCH=$(gh pr view ${PR_NUMBER} --json baseRefName --jq '.baseRefName')
+git diff ${BASE_BRANCH}...HEAD --stat
+git diff ${BASE_BRANCH}...HEAD
+```
+
+### A4. Spawn Reviewer Agent
+
+```bash
+mkdir -p .relay/reviews
+```
+
+```
+Task(
+  prompt="
+<pr>
+Number: ${PR_NUMBER}
+Title: ${PR_TITLE}
+Author: ${PR_AUTHOR}
+Base: ${BASE_BRANCH}
+Description: ${PR_DESCRIPTION}
+
+<diff>
+${DIFF_CONTENT}
+</diff>
+
+<files_changed>
+${DIFF_STAT}
+</files_changed>
+</pr>
+
+<codebase_context>
+@.relay/codebase/ARCHITECTURE.md (if exists)
+@.relay/codebase/CONVENTIONS.md (if exists)
+@.relay/codebase/TESTING.md (if exists)
+</codebase_context>
+
+<output>
+Write review to: .relay/reviews/PR-${PR_NUMBER}-review.md
+</output>
+",
+  subagent_type="relay-reviewer",
+  model="{reviewer_model}",
+  description="Review PR #${PR_NUMBER}"
+)
+```
+
+### A5. Display Review and Offer Actions
+
+Read `.relay/reviews/PR-${PR_NUMBER}-review.md` and display summary.
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ Relay ► REVIEW COMPLETE — PR #${PR_NUMBER}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Recommendation: ${APPROVE | COMMENT | REQUEST_CHANGES}
+Critical: ${COUNT}
+Suggestions: ${COUNT}
+
+Full review: .relay/reviews/PR-${PR_NUMBER}-review.md
+```
+
+```
+AskUserQuestion(
+  header: "Action",
+  question: "What would you like to do with this review?",
+  options: [
+    { label: "Post as PR comment", description: "Submit review via gh pr review" },
+    { label: "View full review", description: "Display the complete review document" },
+    { label: "Done", description: "Return to original branch" }
+  ]
+)
+```
+
+**If "Post as PR comment":**
+```bash
+gh pr review ${PR_NUMBER} --body "$(cat .relay/reviews/PR-${PR_NUMBER}-review.md)" --comment
+```
+
+### A6. Restore Original Branch
+
+```bash
+git checkout "${ORIGINAL_BRANCH}"
+```
+
+Always restore the original branch, regardless of action taken.
+
+---
+
+## Mode B — Address PR Comments
+
+### B1. List Your Open PRs
+
+```bash
+gh pr list --state open --author @me --limit 20
+```
+
+If no open PRs: report and STOP.
+
+```
+AskUserQuestion(
+  header: "PR",
+  question: "Which PR has comments to address?",
+  options: [
+    { label: "#${PR_1_NUM}", description: "${PR_1_TITLE}" },
+    { label: "#${PR_2_NUM}", description: "${PR_2_TITLE}" },
+    { label: "#${PR_3_NUM}", description: "${PR_3_TITLE}" }
+  ]
+)
+```
+
+### B2. Fetch Review Comments
+
+```bash
+REPO=$(gh repo view --json nameWithOwner --jq '.nameWithOwner')
+gh api repos/${REPO}/pulls/${PR_NUMBER}/comments --jq '.[] | {path: .path, line: .line, body: .body, user: .user.login}'
+gh api repos/${REPO}/pulls/${PR_NUMBER}/reviews --jq '.[] | select(.state != "APPROVED") | {body: .body, user: .user.login, state: .state}'
+```
+
+### B3. Display Comments Grouped by File
+
+Group comments by file path and display:
+
+```
+## Review Comments for PR #${PR_NUMBER}
+
+### ${FILE_1}
+- Line ${LINE}: ${COMMENT_BODY} (by ${USER})
+
+### ${FILE_2}
+- Line ${LINE}: ${COMMENT_BODY} (by ${USER})
+```
+
+### B4. Choose What to Address
+
+```
+AskUserQuestion(
+  header: "Comments",
+  question: "Which comments would you like to address?",
+  options: [
+    { label: "All comments", description: "Address every review comment" },
+    { label: "Select specific", description: "Choose which comments to fix" },
+    { label: "View only", description: "Just review the comments, don't change code" }
+  ]
+)
+```
+
+If "View only": display and STOP.
+
+If "Select specific": let user pick which comments to address.
+
+### B5. Checkout PR Branch and Fix
+
+```bash
+gh pr checkout ${PR_NUMBER}
+```
+
+For each comment to address:
+1. Read the file at the mentioned line
+2. Understand the feedback
+3. Make the code change using Edit
+4. Verify the fix
+
+### B6. Commit Fixes
+
+For each file changed, commit with descriptive message:
+
+```bash
+# Detect ticket ID from branch name or PR title
+TICKET_ID=$(git branch --show-current | grep -oE '[A-Z]+-[0-9]+' | head -1)
+TICKET_ID=${TICKET_ID:-review}
+
+git add ${CHANGED_FILE}
+git commit -m "fix(${TICKET_ID}): address review — ${DESCRIPTION}"
+```
+
+### B7. Offer to Push
+
+```
+AskUserQuestion(
+  header: "Push",
+  question: "Push fixes to update the PR?",
+  options: [
+    { label: "Push", description: "Push commits to update PR #${PR_NUMBER}" },
+    { label: "Skip", description: "Keep changes local for now" }
+  ]
+)
+```
+
+If "Push":
+```bash
+git push
+```
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ Relay ► COMMENTS ADDRESSED — PR #${PR_NUMBER}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Comments addressed: ${COUNT}
+Commits: ${COMMIT_COUNT}
+Pushed: ${YES/NO}
+```
+
+</process>
+
+<success_criteria>
+**Mode A:**
+- [ ] PR selected from open PRs
+- [ ] Original branch saved
+- [ ] PR branch checked out
+- [ ] Diff captured
+- [ ] Reviewer agent produced structured review
+- [ ] Review displayed with recommendation
+- [ ] Action taken (post, view, or skip)
+- [ ] Original branch restored
+
+**Mode B:**
+- [ ] User's PR selected
+- [ ] Review comments fetched and displayed
+- [ ] Selected comments addressed with code changes
+- [ ] Each fix committed with descriptive message
+- [ ] Pushed if requested
+</success_criteria>

package/commands/relay/rollback.md

@@ -0,0 +1,248 @@
+---
+name: relay:rollback
+description: Safely revert work done on a specific ticket
+argument-hint: <ticket-id>
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - AskUserQuestion
+---
+
+<objective>
+Safely revert ticket work using `git revert` (creates new commits — no history rewriting).
+
+Destructive action — requires explicit user confirmation before executing.
+</objective>
+
+<context>
+@.relay/STATE.md
+Ticket ID: $ARGUMENTS
+</context>
+
+<process>
+
+## 0. Pre-flight
+
+```bash
+test -f .relay/config.json && echo "config exists" || echo "no config"
+```
+
+If no config: suggest `/relay:setup` and STOP.
+
+If no $ARGUMENTS:
+```
+AskUserQuestion(
+  header: "Ticket",
+  question: "Which ticket's work would you like to rollback?",
+  options: [
+    { label: "Enter ID", description: "Type a ticket ID (e.g., PROJ-123)" },
+    { label: "Cancel", description: "Don't rollback anything" }
+  ]
+)
+```
+
+## 1. Find Ticket Commits
+
+```bash
+git log --oneline --all --grep="${TICKET_ID}"
+```
+
+If no commits found:
+```
+No commits found for ${TICKET_ID}.
+```
+STOP.
+
+## 2. Display Commits and Files
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ Relay ► ROLLBACK — ${TICKET_ID}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Show commits:
+```bash
+git log --oneline --all --grep="${TICKET_ID}" --format="%h %s (%ai)"
+```
+
+Show files affected:
+```bash
+git log --all --grep="${TICKET_ID}" --name-only --format="" | sort -u
+```
+
+Count total:
+```bash
+COMMIT_COUNT=$(git log --oneline --all --grep="${TICKET_ID}" | wc -l | tr -d ' ')
+FILE_COUNT=$(git log --all --grep="${TICKET_ID}" --name-only --format="" | sort -u | wc -l | tr -d ' ')
+```
+
+```
+Found ${COMMIT_COUNT} commits affecting ${FILE_COUNT} files.
+```
+
+## 3. Check for Interleaved Commits
+
+Check if other work is interleaved with ticket commits:
+
+```bash
+# Get the range of ticket commits
+FIRST_COMMIT=$(git log --oneline --all --grep="${TICKET_ID}" --format="%H" | tail -1)
+LAST_COMMIT=$(git log --oneline --all --grep="${TICKET_ID}" --format="%H" | head -1)
+
+# Check for non-ticket commits in that range
+git log --oneline ${FIRST_COMMIT}..${LAST_COMMIT} | grep -v "${TICKET_ID}"
+```
+
+If interleaved commits exist, warn:
+```
+WARNING: Other commits exist between ${TICKET_ID} commits.
+Reverting may cause conflicts. Consider selective revert.
+```
+
+## 4. Choose Rollback Mode
+
+```
+AskUserQuestion(
+  header: "Mode",
+  question: "How would you like to rollback ${TICKET_ID}? (${COMMIT_COUNT} commits, ${FILE_COUNT} files)",
+  options: [
+    { label: "Full revert", description: "Revert all ${COMMIT_COUNT} commits for ${TICKET_ID}" },
+    { label: "Selective revert", description: "Choose which commits to revert" },
+    { label: "Soft rollback", description: "Just switch to main branch (no revert commits)" },
+    { label: "Cancel", description: "Don't rollback" }
+  ]
+)
+```
+
+If "Cancel": STOP.
+
+### Soft Rollback
+
+```bash
+BASE_BRANCH=$(git remote show origin 2>/dev/null | grep 'HEAD branch' | sed 's/.*: //')
+BASE_BRANCH=${BASE_BRANCH:-main}
+git checkout "${BASE_BRANCH}"
+```
+
+Skip to step 6.
+
+### Selective Revert
+
+Display commits numbered for selection:
+```bash
+git log --oneline --all --grep="${TICKET_ID}" --format="%h %s"
+```
+
+Ask user which commits to revert (by hash or number).
+
+### Full Revert / Selective Revert
+
+Continue to step 5.
+
+## 5. Confirm and Execute
+
+**Explicit confirmation required:**
+
+```
+AskUserQuestion(
+  header: "Confirm",
+  question: "This will create revert commits for ${REVERT_COUNT} commits. This cannot be easily undone. Proceed?",
+  options: [
+    { label: "Revert", description: "Execute git revert for selected commits" },
+    { label: "Cancel", description: "Abort rollback" }
+  ]
+)
+```
+
+If "Cancel": STOP.
+
+**Execute reverts (newest first):**
+
+```bash
+# Get commits in reverse chronological order (newest first)
+COMMITS=$(git log --oneline --all --grep="${TICKET_ID}" --format="%H")
+
+for COMMIT in ${COMMITS}; do
+  git revert --no-edit ${COMMIT} || {
+    echo "Conflict during revert of ${COMMIT}"
+    echo "Resolve conflicts and run: git revert --continue"
+    break
+  }
+done
+```
+
+If conflicts occur, display:
+```
+Conflict encountered while reverting ${COMMIT_HASH}.
+
+Conflicting files:
+$(git diff --name-only --diff-filter=U)
+
+Options:
+1. Resolve conflicts manually, then run: git revert --continue
+2. Abort the rollback: git revert --abort
+```
+
+## 6. Handle Artifacts
+
+```
+AskUserQuestion(
+  header: "Artifacts",
+  question: "What should happen to the ticket artifacts in .relay/tickets/${TICKET_ID}/?",
+  options: [
+    { label: "Archive", description: "Move to .relay/tickets/${TICKET_ID}/.archived/" },
+    { label: "Delete", description: "Remove all ticket artifacts" },
+    { label: "Keep", description: "Leave artifacts as-is" }
+  ]
+)
+```
+
+**Archive:**
+```bash
+mkdir -p .relay/tickets/${TICKET_ID}/.archived
+mv .relay/tickets/${TICKET_ID}/*.md .relay/tickets/${TICKET_ID}/.archived/ 2>/dev/null
+```
+
+**Delete:**
+```bash
+rm -rf .relay/tickets/${TICKET_ID}
+```
+
+**Keep:** No action.
+
+## 7. Update State
+
+Update STATE.md:
+- Clear active ticket if it was the rolled-back ticket
+- Add note to recent tickets: "reverted"
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ Relay ► ROLLBACK COMPLETE — ${TICKET_ID}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Reverted: ${REVERT_COUNT} commits
+Artifacts: ${archived/deleted/kept}
+
+## Next Steps
+
+- `/relay:tickets` — browse available tickets
+- `/relay:status` — check current state
+```
+
+</process>
+
+<success_criteria>
+- [ ] Ticket commits found and displayed
+- [ ] Interleaved commits warned about
+- [ ] User chose rollback mode
+- [ ] Explicit confirmation obtained before revert
+- [ ] `git revert --no-edit` executed for selected commits (newest first)
+- [ ] Conflicts handled gracefully if they occur
+- [ ] Artifacts archived, deleted, or kept per user choice
+- [ ] STATE.md updated (active ticket cleared, marked as reverted)
+</success_criteria>

package/commands/relay/set-profile.md

@@ -0,0 +1,116 @@
+---
+name: set-profile
+description: Switch model profile for Relay agents (quality/balanced/budget)
+arguments:
+  - name: profile
+    description: "Profile name: quality, balanced, or budget"
+    required: true
+---
+
+<objective>
+Switch the model profile used by Relay agents. This controls which Claude model each agent uses, balancing quality vs token spend.
+</objective>
+
+<profiles>
+| Profile | Description |
+|---------|-------------|
+| **quality** | Opus everywhere except read-only verification |
+| **balanced** | Opus for planning, Sonnet for execution/verification (default) |
+| **budget** | Sonnet for writing, Haiku for research/verification |
+</profiles>
+
+<process>
+
+## 1. Validate argument
+
+```
+if $ARGUMENTS.profile not in ["quality", "balanced", "budget"]:
+  Error: Invalid profile "$ARGUMENTS.profile"
+  Valid profiles: quality, balanced, budget
+  STOP
+```
+
+## 2. Ensure config exists
+
+```bash
+ls .relay/config.json 2>/dev/null
+```
+
+If `.relay/config.json` missing, create it with defaults:
+```bash
+mkdir -p .relay
+```
+```json
+{
+  "model_profile": "balanced",
+  "workflow": {
+    "research": true,
+    "plan_check": true,
+    "verifier": true
+  }
+}
+```
+Write this to `.relay/config.json`, then continue.
+
+## 3. Update config.json
+
+Read current config:
+```bash
+cat .relay/config.json
+```
+
+Update `model_profile` field:
+```json
+{
+  "model_profile": "$ARGUMENTS.profile"
+}
+```
+
+Write updated config back to `.relay/config.json`.
+
+## 4. Confirm
+
+```
+✓ Model profile set to: $ARGUMENTS.profile
+
+Agents will now use:
+[Show table from model-profiles.md for selected profile]
+
+Next spawned agents will use the new profile.
+```
+
+</process>
+
+<examples>
+
+**Switch to budget mode:**
+```
+/relay:set-profile budget
+
+✓ Model profile set to: budget
+
+Agents will now use:
+| Agent | Model |
+|-------|-------|
+| relay-planner | sonnet |
+| relay-executor | sonnet |
+| relay-verifier | haiku |
+| ... | ... |
+```
+
+**Switch to quality mode:**
+```
+/relay:set-profile quality
+
+✓ Model profile set to: quality
+
+Agents will now use:
+| Agent | Model |
+|-------|-------|
+| relay-planner | opus |
+| relay-executor | opus |
+| relay-verifier | sonnet |
+| ... | ... |
+```
+
+</examples>