1#!/usr/bin/env bash
2# Extract one task's full text from an implementation plan into a file the
3# implementer reads in one call, so the task text never has to be pasted
4# through the controller's context.
5#
6# Usage: task-brief PLAN_FILE TASK_NUMBER [OUTFILE]
7# Default OUTFILE: <repo-root>/.superpowers/sdd/task-<N>-brief.md
8# (per worktree; concurrent runs in the same working tree share it).
9set -euo pipefail
10 
11if [ $# -lt 2 ] || [ $# -gt 3 ]; then
12  echo "usage: task-brief PLAN_FILE TASK_NUMBER [OUTFILE]" >&2
13  exit 2
14fi
15 
16plan=$1
17n=$2
18[ -f "$plan" ] || { echo "no such plan file: $plan" >&2; exit 2; }
19 
20if [ $# -eq 3 ]; then
21  out=$3
22else
23  dir=$("$(cd "$(dirname "$0")" && pwd)/sdd-workspace")
24  out="$dir/task-${n}-brief.md"
25fi
26 
27awk -v n="$n" '
28  /^```/ { infence = !infence }
29  !infence && /^#+[ \t]+Task[ \t]+[0-9]+/ {
30    intask = ($0 ~ ("^#+[ \t]+Task[ \t]+" n "([^0-9]|$)"))
31  }
32  intask { print }
33' "$plan" > "$out"
34 
35if [ ! -s "$out" ]; then
36  echo "task ${n} not found in ${plan} (no heading matching 'Task ${n}')" >&2
37  exit 3
38fi
39 
40echo "wrote ${out}: $(wc -l < "$out" | tr -d ' ') lines"
41