Review Package

1#!/usr/bin/env bash
2# Generate a review package: commit list, stat summary, and the net
3# diff with extended context, written to a file the reviewer reads in one
4# call. Using the recorded per-task BASE (not HEAD~1) keeps multi-commit
5# tasks intact.
6#
7# Usage: review-package PLAN_FILE BASE HEAD [OUTFILE]
8# Default OUTFILE: <repo-root>/.superpowers/sdd/<plan-basename>/review-<base7>..<head7>.diff
9# (named per range, so a re-review after fixes gets a distinct fresh file).
10set -euo pipefail
11
12if [ $# -lt 3 ] || [ $# -gt 4 ]; then
13  echo "usage: review-package PLAN_FILE BASE HEAD [OUTFILE]" >&2
14  exit 2
15fi
16
17plan=$1
18base=$2
19head=$3
20[ -f "$plan" ] || { echo "no such plan file: $plan" >&2; exit 2; }
21
22git rev-parse --verify --quiet "$base" >/dev/null || { echo "bad BASE: $base" >&2; exit 2; }
23git rev-parse --verify --quiet "$head" >/dev/null || { echo "bad HEAD: $head" >&2; exit 2; }
24
25if [ $# -eq 4 ]; then
26  out=$4
27else
28  dir=$("$(cd "$(dirname "$0")" && pwd)/sdd-workspace" "$plan")
29  out="$dir/review-$(git rev-parse --short "$base")..$(git rev-parse --short "$head").diff"
30fi
31
32{
33  echo "# Review package: ${base}..${head}"
34  echo
35  echo "## Commits"
36  git log --oneline "${base}..${head}"
37  echo
38  echo "## Files changed"
39  git diff --stat "${base}..${head}"
40  echo
41  echo "## Diff"
42  git diff -U10 "${base}..${head}"
43} > "$out"
44
45commits=$(git rev-list --count "${base}..${head}")
46echo "wrote ${out}: ${commits} commit(s), $(wc -c < "$out" | tr -d ' ') bytes"