Task Brief

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/<plan-basename>/task-<N>-brief.md
8# (per plan and per worktree; concurrent runs of the SAME plan in the same
9# working tree share it).
10set -euo pipefail
11
12if [ $# -lt 2 ] || [ $# -gt 3 ]; then
13  echo "usage: task-brief PLAN_FILE TASK_NUMBER [OUTFILE]" >&2
14  exit 2
15fi
16
17plan=$1
18n=$2
19[ -f "$plan" ] || { echo "no such plan file: $plan" >&2; exit 2; }
20
21if [ $# -eq 3 ]; then
22  out=$3
23else
24  dir=$("$(cd "$(dirname "$0")" && pwd)/sdd-workspace" "$plan")
25  out="$dir/task-${n}-brief.md"
26fi
27
28awk -v n="$n" '
29  /^```/ { infence = !infence }
30  !infence && /^#+[ \t]+Task[ \t]+[0-9]+/ {
31    intask = ($0 ~ ("^#+[ \t]+Task[ \t]+" n "([^0-9]|$)"))
32  }
33  intask { print }
34' "$plan" > "$out"
35
36if [ ! -s "$out" ]; then
37  echo "task ${n} not found in ${plan} (no heading matching 'Task ${n}')" >&2
38  exit 3
39fi
40
41echo "wrote ${out}: $(wc -l < "$out" | tr -d ' ') lines"