agentsys 5.0.3 → 5.2.0

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

@@ -1,334 +0,0 @@
-<!-- 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

@@ -1,336 +0,0 @@
-<!-- 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.