dry-run

SpecSwarm Dry-Run Prediction

Marty's most expensive operation is committing to a chunk that turns out to be the wrong shape. The dual-session mentor↔builder pattern existed partly to catch this BEFORE it shipped. With v7.x's automation, the equivalent safety rail is prediction: read what will be built, surface what's likely to go wrong, let Marty redirect before code lands.

Run this at chunk start (or any point before /ss:ship) to get a structured prediction. Re-runnable — the report rewrites on each invocation as more artifacts come into existence.

Phase 1: Resolve feature + phase scope

PLUGIN_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
# shellcheck disable=SC1091
source "${PLUGIN_DIR}/lib/features-location.sh"
# shellcheck disable=SC1091
source "${PLUGIN_DIR}/lib/intervention.sh"
# shellcheck disable=SC1091
[ -f "${PLUGIN_DIR}/lib/notify.sh" ] && source "${PLUGIN_DIR}/lib/notify.sh"

FEATURE_NUM=""
PHASE="auto"
HISTORY_LIMIT=20

while [ $# -gt 0 ]; do
  case "$1" in
    --phase)         PHASE="$2";         shift 2 ;;
    --history-limit) HISTORY_LIMIT="$2"; shift 2 ;;
    -h|--help)
      cat <<EOF
Usage: /ss:dry-run [FEATURE_NUM] [options]

Predict the chunk's full execution path without running it.

Options:
  --phase SCOPE      auto (default) | plan | tasks | decisions | implement
  --history-limit N  Past intervention/verify entries to feed the simulator (default 20)

Examples:
  /ss:dry-run
  /ss:dry-run 003
  /ss:dry-run 003 --phase implement
  /ss:dry-run --history-limit 50
EOF
      exit 0
      ;;
    *)
      if [ -z "$FEATURE_NUM" ]; then FEATURE_NUM="$1"; fi
      shift
      ;;
  esac
done

# Validate --phase
case "$PHASE" in
  auto|plan|tasks|decisions|implement) ;;
  *)
    echo "❌ Invalid --phase '$PHASE' (use: auto|plan|tasks|decisions|implement)" >&2
    exit 2
    ;;
esac

REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)

# Resolve feature (same cascade as /ss:decisions and /ss:retrospective)
if [ -z "$FEATURE_NUM" ]; then
  BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
  FEATURE_NUM=$(echo "$BRANCH" | grep -oE '^[0-9]{3}' || echo "")
fi
if [ -z "$FEATURE_NUM" ]; then
  get_features_dir "$REPO_ROOT"
  FEATURE_NUM=$(find "$FEATURES_DIR" -maxdepth 1 -type d -name '[0-9][0-9][0-9]-*' 2>/dev/null \
    | sort | tail -1 | xargs -n1 basename 2>/dev/null \
    | grep -oE '^[0-9]{3}' || echo "")
fi
if [ -z "$FEATURE_NUM" ]; then
  echo "❌ No feature number provided and no feature dirs found." >&2
  exit 2
fi
if ! find_feature_dir "$FEATURE_NUM" "$REPO_ROOT"; then
  echo "❌ Feature $FEATURE_NUM not found." >&2
  exit 2
fi
FEATURE_ID=$(basename "$FEATURE_DIR")

# Spec.md is mandatory — if it doesn't exist, /ss:specify hasn't run yet
SPEC_PATH="${FEATURE_DIR}/spec.md"
if [ ! -f "$SPEC_PATH" ]; then
  echo "❌ spec.md not found at $SPEC_PATH. Run /ss:specify first." >&2
  exit 2
fi

echo "🔮 Dry-run prediction for $FEATURE_ID"
echo "  feature_dir:    $FEATURE_DIR"
echo "  phase_scope:    $PHASE"
echo "  history_limit:  $HISTORY_LIMIT"
echo ""