verify

SpecSwarm Spec-Mentor Verification

Runs adversarial verification on a completed task: dispatches a fresh spec-mentor subagent (no carried context, no anchoring bias) to compare what the spec says against what the code does, returns a structured verdict, and updates .specswarm/verify-queue/.

This is the architectural piece that replaces the dual mentor↔builder session pattern. Instead of a long-running mentor session catching drift, a fresh subagent fires once per completed task — better adversarial value, lower context cost, fully automatable.

Phase 1: Resolve target task(s)

PLUGIN_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
# shellcheck disable=SC1091
source "${PLUGIN_DIR}/lib/verify/queue.sh"
# shellcheck disable=SC1091
source "${PLUGIN_DIR}/lib/verify/task-context.sh"
# shellcheck disable=SC1091
source "${PLUGIN_DIR}/lib/references-loader.sh"
# shellcheck disable=SC1091
[ -f "${PLUGIN_DIR}/lib/notify.sh" ] && source "${PLUGIN_DIR}/lib/notify.sh"

# Parse arguments
TASK_ID=""
PROCESS_ALL=false
FEATURE_OVERRIDE=""
QUEUE_MODE=false
SIGHTED_MODE=false

while [ $# -gt 0 ]; do
  case "$1" in
    --all|--drain) PROCESS_ALL=true; shift ;;
    --queue)   QUEUE_MODE=true;      shift ;;
    --sighted) SIGHTED_MODE=true;    shift ;;
    --feature) FEATURE_OVERRIDE="$2"; shift 2 ;;
    -h|--help)
      cat <<EOF
Usage: /ss:verify [TASK_ID] [options]

Adversarial spec-vs-implementation verification for completed task(s).

Options:
  --all              Process every pending task in the queue
  --drain            Alias for --all (drains the whole queue)
  --feature NUM      Override auto-detected feature number
  --queue            Show queue status (pending / verified / flagged / needs-sighted)
  --sighted TASK_ID  Human sighted sign-off walkthrough for a NEEDS-SIGHTED task

Examples:
  /ss:verify T011
  /ss:verify --all
  /ss:verify --drain
  /ss:verify --queue
  /ss:verify --sighted T012
EOF
      exit 0
      ;;
    *)
      if [ -z "$TASK_ID" ]; then TASK_ID="$1"; fi
      shift
      ;;
  esac
done

# Queue overview mode — useful for "how many pending right now?"
if [ "$QUEUE_MODE" = true ]; then
  PENDING=$(ss_verify_queue_count pending)
  VERIFIED=$(ss_verify_queue_count verified)
  FLAGGED=$(ss_verify_queue_count flagged)
  NEEDS_SIGHTED=$(ss_verify_queue_count needs-sighted)
  echo "📋 SpecSwarm verification queue:"
  echo "  pending:       $PENDING"
  echo "  verified:      $VERIFIED"
  echo "  flagged:       $FLAGGED"
  echo "  needs-sighted: $NEEDS_SIGHTED"
  if [ "$PENDING" -gt 0 ]; then
    echo ""
    echo "Pending:"
    ss_verify_queue_list_pending | sed 's/^/  • /'
  fi
  if [ "$FLAGGED" -gt 0 ]; then
    echo ""
    echo "Flagged (need review):"
    find "$(ss_verify_queue_dir)" -maxdepth 1 -type f -name '*.flagged' \
      -exec basename {} \; 2>/dev/null | sed 's/\.flagged$//' | sed 's/^/  ⚠️  /'
  fi
  exit 0
fi

# Resolve target task list
TARGETS=()
if [ "$PROCESS_ALL" = true ]; then
  while IFS= read -r t; do
    [ -n "$t" ] && TARGETS+=("$t")
  done < <(ss_verify_queue_list_pending)
elif [ -n "$TASK_ID" ]; then
  TARGETS=("$TASK_ID")
else
  # Default: oldest pending
  OLDEST=$(ss_verify_queue_list_pending | head -n1)
  [ -n "$OLDEST" ] && TARGETS=("$OLDEST")
fi

if [ "${#TARGETS[@]}" -eq 0 ]; then
  echo "✅ No pending verifications. Queue is empty."
  exit 0
fi

echo "🔍 Verification targets: ${TARGETS[*]}"
echo ""