agentsys 5.0.0

package/adapters/opencode/commands/ship-ci-review-loop.md

@@ -0,0 +1,334 @@
+<!-- AUTO-GENERATED by scripts/gen-adapters.js - DO NOT EDIT -->
+---
+description: "Use when monitoring CI and handling review comments during /ship. Details mandatory wait periods, auto-reviewer handling, and comment resolution."
+agent: general
+---
+
+> **OpenCode Note**: Invoke agents using `@agent-name` syntax.
+> Available agents: task-discoverer, exploration-agent, planning-agent,
+> implementation-agent, deslop-agent, delivery-validator, sync-docs-agent, consult-agent
+> Example: `@exploration-agent analyze the codebase`
+
+
+<ci-review-loop>
+# Phase 4: CI & Review Monitor Loop - Reference
+
+This file contains detailed implementation for the CI & Review Monitor Loop phase of `/ship`.
+
+**Parent document**: `ship.md`
+
+---
+
+<mandatory-requirements>
+## This Phase Is Mandatory
+
+This is not optional. You must:
+1. Wait the full 3 minutes for auto-reviewers
+2. Run the monitor loop (not just check once)
+3. Address all comments before merge
+</mandatory-requirements>
+
+---
+
+<pr-auto-review>
+## PR Auto-Review Process
+
+PRs receive automatic reviews from configured auto-reviewers (Copilot, Gemini, CodeRabbit, etc.).
+
+**Mandatory workflow:**
+1. After PR creation, wait **at least 3 minutes** for first review round
+2. Read **all comments** from all reviewers
+3. Address **every comment** - no exceptions
+4. Iterate until **zero unresolved threads** (typically 2-4 rounds)
+
+**Rules:**
+- Always address all comments, including "minor" or "nit" suggestions
+- Do not skip a comment unless factually wrong or user-approved
+- Treat all feedback as **required changes**, not suggestions
+</pr-auto-review>
+
+---
+
+<overview>
+## Overview
+
+The monitor loop must wait for:
+1. CI to pass
+2. All comments resolved (addressed or replied to)
+3. No "changes requested" reviews remain
+
+## Why All Comments Matter
+
+**Every comment must be addressed:**
+- Critical/High issues: Fix immediately
+- Medium issues: Fix (don't defer)
+- Minor/Nit issues: Fix (shows attention to quality)
+- Style suggestions: Fix (maintains codebase consistency)
+- Questions: Answer with explanation
+- False positives: Reply explaining why, then resolve
+- Not relevant: Reply explaining why, then resolve
+
+Do not ignore comments. Do not leave comments unresolved. A clean PR has zero unresolved conversations.
+</overview>
+
+## The Monitor Loop Algorithm
+
+> **Note:** The JavaScript below is **conceptual pseudocode** showing the algorithm flow.
+> Implement using bash functions defined in this file.
+
+*(JavaScript reference - not executable in OpenCode)*
+
+## Step 1: Wait for CI
+
+```bash
+wait_for_ci() {
+  echo "Waiting for CI checks..."
+
+  while true; do
+    CHECKS=$(gh pr checks $PR_NUMBER --json name,state 2>/dev/null || echo "[]")
+
+    PENDING=$(echo "$CHECKS" | jq '[.[] | select(.state | IN("PENDING", "QUEUED", "IN_PROGRESS"))] | length')
+    FAILED=$(echo "$CHECKS" | jq '[.[] | select(.state | IN("FAILURE", "CANCELLED"))] | length')
+    PASSED=$(echo "$CHECKS" | jq '[.[] | select(.state=="SUCCESS")] | length')
+
+    if [ "$FAILED" -gt 0 ]; then
+      echo "[ERROR] CI failed ($FAILED checks)"
+      gh pr checks $PR_NUMBER
+      return 1
+    elif [ "$PENDING" -eq 0 ] && [ "$PASSED" -gt 0 ]; then
+      echo "[OK] CI passed ($PASSED checks)"
+      return 0
+    elif [ "$PENDING" -eq 0 ] && [ "$PASSED" -eq 0 ]; then
+      echo "[WARN] No CI checks found, proceeding..."
+      return 0
+    fi
+
+    echo "  Waiting... ($PENDING pending, $PASSED passed)"
+    sleep 15
+  done
+}
+```
+
+## Step 2: Check PR Feedback
+
+```bash
+check_pr_feedback() {
+  local pr_number=$1
+
+  echo "Checking PR feedback..."
+
+  # Extract owner and repo from git remote
+  REPO_INFO=$(gh repo view --json owner,name --jq '"\(.owner.login)/\(.name)"')
+  OWNER=$(echo "$REPO_INFO" | cut -d'/' -f1)
+  REPO=$(echo "$REPO_INFO" | cut -d'/' -f2)
+
+  # Get review state
+  REVIEWS=$(gh pr view $pr_number --json reviews --jq '.reviews')
+  CHANGES_REQUESTED=$(echo "$REVIEWS" | jq '[.[] | select(.state=="CHANGES_REQUESTED")] | length')
+
+  # Get unresolved review threads
+  # NOTE: Fetches first 100 threads. For PRs with >100 threads, implement pagination.
+  UNRESOLVED_THREADS=$(gh api graphql -f query='
+    query($owner: String!, $repo: String!, $pr: Int!) {
+      repository(owner: $owner, name: $repo) {
+        pullRequest(number: $pr) {
+          reviewThreads(first: 100) {
+            nodes {
+              isResolved
+            }
+          }
+        }
+      }
+    }
+  ' -f owner="$OWNER" -f repo="$REPO" -F pr=$pr_number \
+    --jq '[.data.repository.pullRequest.reviewThreads.nodes[] | select(.isResolved == false)] | length')
+
+  echo "  Unresolved threads: $UNRESOLVED_THREADS"
+  echo "  Changes requested: $CHANGES_REQUESTED"
+
+  echo "{\"unresolvedThreads\": $UNRESOLVED_THREADS, \"changesRequested\": $CHANGES_REQUESTED}"
+}
+```
+
+### Get Full Thread Details
+
+```bash
+get_unresolved_threads() {
+  local pr_number=$1
+
+  REPO_INFO=$(gh repo view --json owner,name --jq '"\(.owner.login)/\(.name)"')
+  OWNER=$(echo "$REPO_INFO" | cut -d'/' -f1)
+  REPO=$(echo "$REPO_INFO" | cut -d'/' -f2)
+
+  # NOTE: Fetches first 100 threads. For PRs with >100, implement pagination.
+  gh api graphql -f query='
+    query($owner: String!, $repo: String!, $pr: Int!) {
+      repository(owner: $owner, name: $repo) {
+        pullRequest(number: $pr) {
+          reviewThreads(first: 100) {
+            nodes {
+              id
+              isResolved
+              path
+              line
+              diffHunk
+              comments(first: 1) {
+                nodes {
+                  id
+                  body
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  ' -f owner="$OWNER" -f repo="$REPO" -F pr=$pr_number \
+    --jq '.data.repository.pullRequest.reviewThreads.nodes[] | select(.isResolved == false)'
+}
+```
+
+## Step 3: Address ALL Feedback
+
+> **Note:** This is **conceptual pseudocode** showing the algorithm flow.
+> Implement using: gh api, Read, Edit, Task (ci-fixer), etc.
+
+*(JavaScript reference - not executable in OpenCode)*
+
+## Comment Analysis Heuristics
+
+> **Note:** Classification heuristics for comment handling.
+
+*(JavaScript reference - not executable in OpenCode)*
+
+## Implementing Fixes
+
+Use the ci-fixer agent for code changes:
+
+*(JavaScript reference - not executable in OpenCode)*
+
+## Resolving Threads
+
+```bash
+resolve_thread() {
+  local thread_id=$1
+
+  gh api graphql -f query='
+    mutation($threadId: ID!) {
+      resolveReviewThread(input: {threadId: $threadId}) {
+        thread {
+          isResolved
+        }
+      }
+    }
+  ' -f threadId="$thread_id"
+}
+
+reply_to_comment() {
+  local pr_number=$1
+  local comment_id=$2
+  local body=$3
+
+  REPO_INFO=$(gh repo view --json owner,name --jq '"\(.owner.login)/\(.name)"')
+  OWNER=$(echo "$REPO_INFO" | cut -d'/' -f1)
+  REPO=$(echo "$REPO_INFO" | cut -d'/' -f2)
+
+  gh api -X POST "repos/$OWNER/$REPO/pulls/$pr_number/comments" \
+    -f body="$body" \
+    -F in_reply_to="$comment_id"
+}
+```
+
+## Step 4: Commit and Push
+
+```bash
+commit_and_push_fixes() {
+  local message=$1
+  local branch=${2:-$(git branch --show-current)}
+
+  if [ -n "$(git status --porcelain)" ]; then
+    git add -A
+    git commit -m "$message"
+    git push origin "$branch"
+    echo "[OK] Pushed fixes"
+    return 0
+  else
+    echo "No code changes to commit (only comment replies)"
+    return 1
+  fi
+}
+```
+
+## Complete Loop Script
+
+```bash
+#!/bin/bash
+# Phase 4: CI & Review Monitor Loop
+
+MAX_ITERATIONS=10
+INITIAL_WAIT=${SHIP_INITIAL_WAIT:-180}  # Configurable via env var
+ITERATION_WAIT=30
+iteration=0
+
+while [ $iteration -lt $MAX_ITERATIONS ]; do
+  iteration=$((iteration + 1))
+  echo "[CI Monitor] Iteration $iteration"
+
+  # Step 1: Wait for CI
+  if ! wait_for_ci; then
+    echo "CI failed - launching ci-fixer agent..."
+    continue
+  fi
+
+  # Step 1.5: First iteration - wait for auto-reviews
+  if [ $iteration -eq 1 ] && [ "$INITIAL_WAIT" -gt 0 ]; then
+    echo "First iteration - waiting ${INITIAL_WAIT}s for auto-reviews..."
+    sleep $INITIAL_WAIT
+  fi
+
+  # Step 2: Check feedback
+  FEEDBACK=$(check_pr_feedback $PR_NUMBER)
+  UNRESOLVED=$(echo "$FEEDBACK" | jq -r '.unresolvedThreads')
+  CHANGES_REQ=$(echo "$FEEDBACK" | jq -r '.changesRequested')
+
+  if [ "$UNRESOLVED" -eq 0 ] && [ "$CHANGES_REQ" -eq 0 ]; then
+    echo "[OK] ALL CHECKS PASSED"
+    echo "[OK] ALL COMMENTS RESOLVED"
+    echo "Ready to merge!"
+    break
+  fi
+
+  # Step 3: Address all feedback
+  echo "Addressing $UNRESOLVED unresolved threads..."
+
+  # Step 4: Commit and push
+  commit_and_push_fixes "fix: address review feedback (iteration $iteration)"
+
+  # Step 5: Wait before next iteration
+  echo "Waiting ${ITERATION_WAIT}s..."
+  sleep $ITERATION_WAIT
+done
+
+if [ $iteration -ge $MAX_ITERATIONS ]; then
+  echo "[ERROR] Max iterations reached - manual intervention required"
+  exit 1
+fi
+```
+
+<iteration-summary>
+## Iteration Summary Output
+
+```markdown
+## Iteration ${iteration} Summary
+
+**CI Status**: [OK] Passed
+**Comments Addressed**: ${addressedCount}
+  - Code fixes: ${codeFixCount}
+  - Answered questions: ${questionCount}
+  - Resolved as not applicable: ${notApplicableCount}
+**Remaining Unresolved**: ${remainingCount}
+
+${remainingCount > 0 ? 'Continuing...' : 'Ready to merge!'}
+```
+</iteration-summary>
+</ci-review-loop>

package/adapters/opencode/commands/ship-deployment.md

@@ -0,0 +1,336 @@
+<!-- AUTO-GENERATED by scripts/gen-adapters.js - DO NOT EDIT -->
+---
+description: "Use when deploying and validating during /ship. Details Railway/Vercel deployment, smoke testing, and rollback procedures."
+agent: general
+---
+
+# Phases 7-10: Deploy & Validate - Reference
+
+This file contains platform-specific deployment and validation for `/ship`.
+
+**Parent document**: `ship.md`
+
+**Note**: Skip all phases if `WORKFLOW="single-branch"`.
+
+## Phase 7: Deploy to Development
+
+### Railway
+
+```bash
+if [ "$DEPLOYMENT" = "railway" ]; then
+  echo "Waiting for Railway development deployment..."
+
+  SERVICE_NAME=$(railway service list --json | jq -r '.[0].name')
+  DEPLOY_ID=$(railway deployment list --service $SERVICE_NAME --json | jq -r '.[0].id')
+
+  while true; do
+    STATUS=$(railway deployment get $DEPLOY_ID --json | jq -r '.status')
+
+    if [ "$STATUS" = "SUCCESS" ]; then
+      DEV_URL=$(railway domain list --service $SERVICE_NAME --json | jq -r '.[0].domain')
+      echo "[OK] Deployed to development: https://$DEV_URL"
+      break
+    elif [ "$STATUS" = "FAILED" ]; then
+      echo "[ERROR] Development deployment failed"
+      railway logs --deployment $DEPLOY_ID
+      exit 1
+    fi
+
+    sleep 10
+  done
+fi
+```
+
+### Vercel
+
+```bash
+if [ "$DEPLOYMENT" = "vercel" ]; then
+  echo "Waiting for Vercel development deployment..."
+
+  DEPLOY_URL=$(vercel ls --json | jq -r '.[0].url')
+
+  while true; do
+    STATUS=$(vercel inspect $DEPLOY_URL --json | jq -r '.readyState')
+
+    if [ "$STATUS" = "READY" ]; then
+      echo "[OK] Deployed to development: https://$DEPLOY_URL"
+      DEV_URL="https://$DEPLOY_URL"
+      break
+    elif [ "$STATUS" = "ERROR" ]; then
+      echo "[ERROR] Development deployment failed"
+      vercel logs $DEPLOY_URL
+      exit 1
+    fi
+
+    sleep 10
+  done
+fi
+```
+
+### Netlify
+
+```bash
+if [ "$DEPLOYMENT" = "netlify" ]; then
+  echo "Waiting for Netlify development deployment..."
+
+  SITE_ID=$(netlify status --json | jq -r '.site_id')
+  DEPLOY_ID=$(netlify api listSiteDeploys --data "{ \"site_id\": \"$SITE_ID\" }" | jq -r '.[0].id')
+
+  while true; do
+    STATUS=$(netlify api getDeploy --data "{ \"deploy_id\": \"$DEPLOY_ID\" }" | jq -r '.state')
+
+    if [ "$STATUS" = "ready" ]; then
+      DEV_URL=$(netlify api getDeploy --data "{ \"deploy_id\": \"$DEPLOY_ID\" }" | jq -r '.deploy_ssl_url')
+      echo "[OK] Deployed to development: $DEV_URL"
+      break
+    elif [ "$STATUS" = "error" ]; then
+      echo "[ERROR] Development deployment failed"
+      exit 1
+    fi
+
+    sleep 10
+  done
+fi
+```
+
+### Generic / Unknown
+
+```bash
+if [ -z "$DEPLOYMENT" ] || [ "$DEPLOYMENT" = "null" ]; then
+  echo "No deployment platform detected"
+  echo "Assuming merge to $MAIN_BRANCH means deployment"
+  DEV_URL="N/A"
+fi
+```
+
+## Phase 8: Validate Development
+
+### Health Check
+
+```bash
+echo "Running smoke tests on development..."
+
+# Wait for deployment to stabilize
+sleep 30
+
+# Basic health check
+HTTP_STATUS=$(curl -s -o /dev/null -w "%{http_code}" $DEV_URL/health || echo "000")
+
+if [ "$HTTP_STATUS" = "200" ] || [ "$HTTP_STATUS" = "301" ] || [ "$HTTP_STATUS" = "302" ]; then
+  echo "[OK] Health check passed: $HTTP_STATUS"
+else
+  echo "[ERROR] Health check failed: $HTTP_STATUS"
+  echo "Investigate deployment issues before proceeding to production"
+  exit 1
+fi
+```
+
+### Error Log Monitoring
+
+```bash
+echo "Checking logs for errors..."
+
+if [ "$DEPLOYMENT" = "railway" ]; then
+  ERROR_COUNT=$(railway logs --tail 100 | grep -iE "(error|exception|fatal)" | wc -l)
+elif [ "$DEPLOYMENT" = "vercel" ]; then
+  ERROR_COUNT=$(vercel logs $DEV_URL --since 5m | grep -iE "(error|exception|fatal)" | wc -l)
+elif [ "$DEPLOYMENT" = "netlify" ]; then
+  ERROR_COUNT=$(netlify logs --since 5m | grep -iE "(error|exception|fatal)" | wc -l)
+else
+  ERROR_COUNT=0
+fi
+
+if [ "$ERROR_COUNT" -gt 10 ]; then
+  echo "[ERROR] High error rate detected: $ERROR_COUNT errors in last 5 minutes"
+  echo "Review logs before proceeding to production"
+  exit 1
+else
+  echo "[OK] Error rate acceptable: $ERROR_COUNT errors"
+fi
+```
+
+### Project Smoke Tests
+
+```bash
+if jq -e '.scripts["smoke-test"]' package.json > /dev/null 2>&1; then
+  echo "Running project smoke tests..."
+
+  export SMOKE_TEST_URL=$DEV_URL
+  $PACKAGE_MGR run smoke-test
+
+  if [ $? -eq 0 ]; then
+    echo "[OK] Smoke tests passed"
+  else
+    echo "[ERROR] Smoke tests failed"
+    exit 1
+  fi
+fi
+```
+
+### Validation Summary
+
+```markdown
+## Development Validation [OK]
+
+**URL**: ${DEV_URL}
+**Health Check**: [OK] ${HTTP_STATUS}
+**Error Rate**: [OK] ${ERROR_COUNT} errors
+**Smoke Tests**: [OK] Passed
+
+Proceeding to production...
+```
+
+## Phase 9: Deploy to Production
+
+### Merge to Production Branch
+
+```bash
+echo "Merging $MAIN_BRANCH → $PROD_BRANCH..."
+
+git checkout $PROD_BRANCH
+git pull origin $PROD_BRANCH
+
+git merge $MAIN_BRANCH --no-edit
+
+if [ $? -ne 0 ]; then
+  echo "[ERROR] Merge to production failed (conflicts)"
+  git merge --abort
+  exit 1
+fi
+
+git push origin $PROD_BRANCH
+
+if [ $? -eq 0 ]; then
+  PROD_SHA=$(git rev-parse HEAD)
+  echo "[OK] Production branch at: $PROD_SHA"
+else
+  echo "[ERROR] Push to production failed"
+  exit 1
+fi
+```
+
+### Wait for Production Deployment
+
+Same platform-specific logic as Phase 7, but targeting production environment.
+
+```bash
+echo "Waiting for production deployment..."
+
+# Platform-specific deployment monitoring
+# (Similar to Phase 7)
+
+echo "[OK] Deployed to production: $PROD_URL"
+```
+
+## Phase 10: Validate Production
+
+### Conservative Validation
+
+```bash
+echo "Validating production deployment..."
+
+# Wait longer for production to stabilize
+sleep 60
+
+# Health check
+HTTP_STATUS=$(curl -s -o /dev/null -w "%{http_code}" $PROD_URL/health || echo "000")
+
+if [ "$HTTP_STATUS" = "200" ] || [ "$HTTP_STATUS" = "301" ] || [ "$HTTP_STATUS" = "302" ]; then
+  echo "[OK] Production health check: $HTTP_STATUS"
+else
+  echo "[ERROR] Production health check failed: $HTTP_STATUS"
+  rollback_production
+fi
+```
+
+### Production Error Monitoring
+
+```bash
+echo "Monitoring production logs..."
+
+if [ "$DEPLOYMENT" = "railway" ]; then
+  ERROR_COUNT=$(railway logs --tail 100 | grep -iE "(error|exception|fatal)" | wc -l)
+elif [ "$DEPLOYMENT" = "vercel" ]; then
+  ERROR_COUNT=$(vercel logs $PROD_URL --since 5m | grep -iE "(error|exception|fatal)" | wc -l)
+fi
+
+if [ "$ERROR_COUNT" -gt 20 ]; then
+  echo "[ERROR] CRITICAL: High error rate in production: $ERROR_COUNT errors"
+  rollback_production
+else
+  echo "[OK] Production error rate acceptable: $ERROR_COUNT errors"
+fi
+```
+
+### Production Smoke Tests
+
+```bash
+if jq -e '.scripts["smoke-test:prod"]' package.json > /dev/null 2>&1; then
+  echo "Running production smoke tests..."
+
+  export SMOKE_TEST_URL=$PROD_URL
+  $PACKAGE_MGR run smoke-test:prod
+
+  if [ $? -ne 0 ]; then
+    echo "[ERROR] Production smoke tests failed"
+    rollback_production
+  fi
+fi
+```
+
+## Rollback Mechanism
+
+**Triggered automatically on any production validation failure.**
+
+```bash
+rollback_production() {
+  echo "========================================"
+  echo "ROLLBACK INITIATED"
+  echo "========================================"
+  echo "WARNING: Force pushing to $PROD_BRANCH to revert"
+
+  git checkout $PROD_BRANCH
+  git reset --hard HEAD~1
+
+  # Use --force-with-lease for safety
+  if ! git push --force-with-lease origin $PROD_BRANCH; then
+    echo "[ERROR] Force push failed - remote may have unexpected changes"
+    echo "Manual intervention required"
+    exit 1
+  fi
+
+  echo "[OK] Rolled back production to previous deployment"
+  echo "Previous version will redeploy automatically"
+
+  # Wait for rollback deployment
+  sleep 30
+
+  # Verify rollback succeeded
+  HTTP_STATUS=$(curl -s -o /dev/null -w "%{http_code}" $PROD_URL/health || echo "000")
+  if [ "$HTTP_STATUS" = "200" ]; then
+    echo "[OK] Rollback successful, production is healthy"
+  else
+    echo "[WARN] Rollback deployed but health check unclear"
+    echo "Manual investigation required"
+  fi
+
+  exit 1
+}
+```
+
+## Platform Detection Reference
+
+The `detect-platform.js` script returns:
+
+```json
+{
+  "ci": "github-actions|gitlab-ci|circleci|jenkins|travis|null",
+  "deployment": "railway|vercel|netlify|heroku|null",
+  "branchStrategy": "single-branch|multi-branch",
+  "mainBranch": "main|master",
+  "projectType": "nodejs|python|rust|go",
+  "packageManager": "npm|yarn|pnpm|pip|cargo"
+}
+```
+
+Use these values to adapt deployment monitoring to your specific platform.