An agentic skills framework & software development methodology that works.
#!/usr/bin/env bash
# Tests for executing-plans' bookkeeping helpers: scripts/task-start extracts
# the brief and records BASE in one call; scripts/task-done runs the task's
# test command, records the result in the ledger, and refuses to record a
# failing task.
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
EP_SCRIPTS="$REPO_ROOT/skills/executing-plans/scripts"
FAILURES=0
TEST_ROOT=""
pass() { echo " [PASS] $1"; }
fail() {
echo " [FAIL] $1"
FAILURES=$((FAILURES + 1))
}
cleanup() {
if [[ -n "$TEST_ROOT" && -d "$TEST_ROOT" ]]; then
rm -rf "$TEST_ROOT"
fi
}
main() {
echo "=== Test: executing-plans scripts ==="
TEST_ROOT="$(mktemp -d)"
trap cleanup EXIT
git init -q -b main "$TEST_ROOT/repo"
local repo
repo="$(cd "$TEST_ROOT/repo" && git rev-parse --show-toplevel)"
# Same spelling as the scripts print (pwd), not rev-parse's C:/... on Git Bash.
repo="$(cd "$repo" && pwd)"
local git_id=(-c user.email=[email protected] -c user.name=t -c commit.gpgsign=false)
cat > "$repo/plan.md" <<'PLAN'
# Plan
## Task 1: First thing
Do the first thing.
## Task 2: Second thing
Do the second thing.
PLAN
( cd "$repo" && git add plan.md && git "${git_id[@]}" commit -qm fixture )
local base
base="$(cd "$repo" && git rev-parse HEAD)"
# --- task-start: argument validation ---
local rc=0
(cd "$repo" && "$EP_SCRIPTS/task-start" plan.md >/dev/null 2>&1) || rc=$?
if [[ "$rc" -eq 2 ]]; then
pass "task-start without a task number errors with exit 2"
else
fail "task-start without a task number errors with exit 2 (got $rc)"
fi
# --- task-start: brief path + BASE in one call ---
local out
out="$(cd "$repo" && "$EP_SCRIPTS/task-start" plan.md 1)"
if [[ "$out" == *"brief: $repo/.superpowers/sdd/plan/task-1-brief.md"* ]]; then
pass "task-start prints the brief path under the plan's workspace"
else
fail "task-start prints the brief path under the plan's workspace"
echo " got: $out"
fi
if [[ "$out" == *"base: $base"* ]]; then
pass "task-start prints BASE as the current HEAD"
else
fail "task-start prints BASE as the current HEAD"
echo " got: $out"
fi
if [[ -s "$repo/.superpowers/sdd/plan/task-1-brief.md" ]]; then
pass "task-start writes the brief file"
else
fail "task-start writes the brief file"
fi
# --- task-done: records a passing task ---
( cd "$repo" && echo x > work.txt && git add work.txt && git "${git_id[@]}" commit -qm "task 1" )
local head
head="$(cd "$repo" && git rev-parse HEAD)"
out="$(cd "$repo" && "$EP_SCRIPTS/task-done" plan.md 1 "$base" -- sh -c 'echo "Ran 3 tests"; echo OK')"
rc=$?
local ledger="$repo/.superpowers/sdd/plan/progress.md"
local expected="Task 1: complete (commits ${base:0:7}..${head:0:7}, tests: sh -c 'echo \"Ran 3 tests\"; echo OK' → OK)"
if [[ -f "$ledger" ]] && grep -qF "$expected" "$ledger"; then
pass "task-done appends the completion line with commit range and test result"
else
fail "task-done appends the completion line with commit range and test result"
echo " expected: $expected"
echo " ledger:"; sed 's/^/ /' "$ledger" 2>/dev/null || echo " (missing)"
fi
if [[ "$out" == *"OK"* ]]; then
pass "task-done prints the tail of the test output"
else
fail "task-done prints the tail of the test output"
echo " got: $out"
fi
if [[ -s "$repo/.superpowers/sdd/plan/task-1-tests.log" ]]; then
pass "task-done keeps the full test output in the workspace"
else
fail "task-done keeps the full test output in the workspace"
fi
# --- task-done: refuses to record a failing task ---
rc=0
out="$(cd "$repo" && "$EP_SCRIPTS/task-done" plan.md 2 "$head" -- sh -c 'echo "FAILED (errors=1)"; exit 1' 2>&1)" || rc=$?
if [[ "$rc" -ne 0 ]]; then
pass "task-done exits non-zero when the test command fails"
else
fail "task-done exits non-zero when the test command fails"
fi
if ! grep -q "Task 2: complete" "$ledger"; then
pass "task-done does not record a failing task as complete"
else
fail "task-done does not record a failing task as complete"
fi
if [[ "$out" == *"FAILED"* ]]; then
pass "task-done shows the failing output"
else
fail "task-done shows the failing output"
echo " got: $out"
fi
# --- task-done: records a passing task whose test command prints nothing ---
# https://github.com/obra/superpowers/issues/2385 -- under `set -euo
# pipefail`, the ledger's `grep -v '^[[:space:]]*$' log | tail -n 1`
# exits 1 on an empty/blank log, which used to abort the whole script
# (silently, no ledger line) even though the test command itself passed.
( cd "$repo" && echo y > work2.txt && git add work2.txt && git "${git_id[@]}" commit -qm "task 2" )
local head2
head2="$(cd "$repo" && git rev-parse HEAD)"
rc=0
out="$(cd "$repo" && "$EP_SCRIPTS/task-done" plan.md 2 "$head" -- true 2>&1)" || rc=$?
if [[ "$rc" -eq 0 ]]; then
pass "task-done exits 0 when a passing test command prints nothing"
else
fail "task-done exits 0 when a passing test command prints nothing (got rc=$rc)"
echo " got: $out"
fi
local expected2="Task 2: complete (commits ${head:0:7}..${head2:0:7}, tests: true → (no output))"
if [[ -f "$ledger" ]] && grep -qF "$expected2" "$ledger"; then
pass "task-done records a passing task that printed no output"
else
fail "task-done records a passing task that printed no output"
echo " expected: $expected2"
echo " ledger:"; sed 's/^/ /' "$ledger" 2>/dev/null || echo " (missing)"
fi
echo
if [[ "$FAILURES" -eq 0 ]]; then
echo "PASS"
else
echo "FAIL ($FAILURES)"
exit 1
fi
}
main "$@"