mirror of
https://github.com/obra/superpowers
synced 2026-07-16 07:34:30 +00:00
Compare commits
2 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| cda4b15fd6 | |||
| 93b250b155 |
@@ -6,18 +6,9 @@ Claude Code plugins need hooks that work on Windows, macOS, and Linux. This docu
|
||||
|
||||
## The Problem
|
||||
|
||||
Claude Code runs hook commands through a shell:
|
||||
Claude Code runs hook commands through the system's default shell:
|
||||
- **Windows**: CMD.exe
|
||||
- **macOS/Linux**: bash or sh
|
||||
- **Windows with Git Bash installed**: Git Bash
|
||||
- **Windows without Git Bash**: PowerShell (older versions used CMD.exe)
|
||||
|
||||
Neither Windows fallback shell can parse our command string: PowerShell treats
|
||||
a leading quoted path as a string expression and errors on the next bareword,
|
||||
and CMD.exe's `/c` quoting rules strip the outer quotes when the path contains
|
||||
a metacharacter such as `(`. Our hooks therefore declare `"shell": "bash"`
|
||||
(supported since Claude Code 2.1.81; older versions ignore the key), which
|
||||
forces the Git Bash route and, when Git Bash is absent, produces an actionable
|
||||
"install Git for Windows" error instead of a shell parser failure.
|
||||
|
||||
This creates several challenges:
|
||||
|
||||
@@ -51,7 +42,6 @@ hooks/
|
||||
{
|
||||
"type": "command",
|
||||
"command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" session-start",
|
||||
"shell": "bash",
|
||||
"async": false
|
||||
}
|
||||
]
|
||||
|
||||
@@ -7,7 +7,6 @@
|
||||
{
|
||||
"type": "command",
|
||||
"command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" session-start",
|
||||
"shell": "bash",
|
||||
"async": false
|
||||
}
|
||||
]
|
||||
|
||||
@@ -230,14 +230,16 @@ prepare_metadata_root() {
|
||||
|
||||
METADATA_ROOT="$(prepare_metadata_root "$METADATA_SOURCE")"
|
||||
|
||||
git -C "$REPO_ROOT" archive --format=tar "$REF" -- \
|
||||
# Pin tar.umask and extract with -p so staged modes are canonical 755/644
|
||||
# regardless of the builder's git config or process umask.
|
||||
git -C "$REPO_ROOT" -c tar.umask=0022 archive --format=tar "$REF" -- \
|
||||
.codex-plugin \
|
||||
CODE_OF_CONDUCT.md \
|
||||
LICENSE \
|
||||
README.md \
|
||||
assets \
|
||||
skills \
|
||||
| tar -xf - -C "$STAGE"
|
||||
| tar -xpf - -C "$STAGE"
|
||||
|
||||
VERSION="$(jq -r '.version // empty' "$STAGE/.codex-plugin/plugin.json")"
|
||||
[[ -n "$VERSION" ]] || die "could not read version from .codex-plugin/plugin.json"
|
||||
@@ -298,12 +300,19 @@ case "$FORMAT" in
|
||||
)
|
||||
;;
|
||||
tar.gz)
|
||||
# Match the prior official archive's deterministic tar entry metadata.
|
||||
# Match the prior official archive's deterministic tar entry metadata:
|
||||
# ustar entries with uid/gid 0 and empty uname/gname. GNU tar and bsdtar
|
||||
# (macOS) spell those flags differently.
|
||||
if tar --version 2>/dev/null | grep -q 'GNU tar'; then
|
||||
TAR_METADATA_FLAGS=(--owner=:0 --group=:0 --numeric-owner)
|
||||
else
|
||||
TAR_METADATA_FLAGS=(--uid 0 --gid 0 --uname '' --gname '')
|
||||
fi
|
||||
TZ=UTC find "$STAGE" -exec touch -t 197001010000 {} +
|
||||
(
|
||||
cd "$STAGE"
|
||||
rm -f "$OUTPUT"
|
||||
COPYFILE_DISABLE=1 tar -cf - --no-recursion --format ustar --uid 0 --gid 0 --uname '' --gname '' -T "$ARCHIVE_LIST" |
|
||||
COPYFILE_DISABLE=1 tar -cf - --no-recursion --format ustar "${TAR_METADATA_FLAGS[@]}" -T "$ARCHIVE_LIST" |
|
||||
gzip -9n >"$OUTPUT"
|
||||
)
|
||||
;;
|
||||
|
||||
@@ -25,7 +25,8 @@ fi
|
||||
# Parse command line arguments
|
||||
VERBOSE=false
|
||||
SPECIFIC_TEST=""
|
||||
TIMEOUT=600 # Default 10 minute timeout per test
|
||||
TIMEOUT=900 # Per-test-file budget; must exceed the file's worst case
|
||||
# (test-subagent-driven-development.sh: 9 prompts x 90s each)
|
||||
RUN_INTEGRATION=false
|
||||
|
||||
while [[ $# -gt 0 ]]; do
|
||||
@@ -52,7 +53,7 @@ while [[ $# -gt 0 ]]; do
|
||||
echo "Options:"
|
||||
echo " --verbose, -v Show verbose output"
|
||||
echo " --test, -t NAME Run only the specified test"
|
||||
echo " --timeout SECONDS Set timeout per test (default: 300)"
|
||||
echo " --timeout SECONDS Set timeout per test (default: 900)"
|
||||
echo " --integration, -i Run integration tests (slow, 10-30 min)"
|
||||
echo " --help, -h Show this help"
|
||||
echo ""
|
||||
|
||||
@@ -30,12 +30,14 @@ run_claude() {
|
||||
|
||||
# Check if output contains a pattern
|
||||
# Usage: assert_contains "output" "pattern" "test name"
|
||||
# Matching is case-insensitive: patterns are prose keywords, and models
|
||||
# freely capitalize skill terms ("Do Not Trust", "Spec Compliance").
|
||||
assert_contains() {
|
||||
local output="$1"
|
||||
local pattern="$2"
|
||||
local test_name="${3:-test}"
|
||||
|
||||
if echo "$output" | grep -q "$pattern"; then
|
||||
if echo "$output" | grep -qi "$pattern"; then
|
||||
echo " [PASS] $test_name"
|
||||
return 0
|
||||
else
|
||||
@@ -54,7 +56,7 @@ assert_not_contains() {
|
||||
local pattern="$2"
|
||||
local test_name="${3:-test}"
|
||||
|
||||
if echo "$output" | grep -q "$pattern"; then
|
||||
if echo "$output" | grep -qi "$pattern"; then
|
||||
echo " [FAIL] $test_name"
|
||||
echo " Did not expect to find: $pattern"
|
||||
echo " In output:"
|
||||
@@ -74,7 +76,7 @@ assert_count() {
|
||||
local expected="$3"
|
||||
local test_name="${4:-test}"
|
||||
|
||||
local actual=$(echo "$output" | grep -c "$pattern" || echo "0")
|
||||
local actual=$(echo "$output" | grep -ci "$pattern" || echo "0")
|
||||
|
||||
if [ "$actual" -eq "$expected" ]; then
|
||||
echo " [PASS] $test_name (found $actual instances)"
|
||||
@@ -98,16 +100,20 @@ assert_order() {
|
||||
local test_name="${4:-test}"
|
||||
|
||||
# Get line numbers where patterns appear
|
||||
local line_a=$(echo "$output" | grep -n "$pattern_a" | head -1 | cut -d: -f1)
|
||||
local line_b=$(echo "$output" | grep -n "$pattern_b" | head -1 | cut -d: -f1)
|
||||
local line_a=$(echo "$output" | grep -ni "$pattern_a" | head -1 | cut -d: -f1)
|
||||
local line_b=$(echo "$output" | grep -ni "$pattern_b" | head -1 | cut -d: -f1)
|
||||
|
||||
if [ -z "$line_a" ]; then
|
||||
echo " [FAIL] $test_name: pattern A not found: $pattern_a"
|
||||
echo " In output:"
|
||||
echo "$output" | sed 's/^/ /'
|
||||
return 1
|
||||
fi
|
||||
|
||||
if [ -z "$line_b" ]; then
|
||||
echo " [FAIL] $test_name: pattern B not found: $pattern_b"
|
||||
echo " In output:"
|
||||
echo "$output" | sed 's/^/ /'
|
||||
return 1
|
||||
fi
|
||||
|
||||
|
||||
@@ -96,13 +96,13 @@ echo "Test 5: Spec compliance reviewer mindset..."
|
||||
|
||||
output=$(run_claude "What is the spec compliance reviewer's attitude toward the implementer's report in subagent-driven-development?" "$CLAUDE_PROMPT_TIMEOUT")
|
||||
|
||||
if assert_contains "$output" "not trust\|don't trust\|skeptical\|verify.*independently\|suspiciously" "Reviewer is skeptical"; then
|
||||
if assert_contains "$output" "not.*trust\|don't trust\|skeptical\|verify.*independently\|suspiciously" "Reviewer is skeptical"; then
|
||||
: # pass
|
||||
else
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if assert_contains "$output" "read.*code\|inspect.*code\|verify.*code" "Reviewer reads code"; then
|
||||
if assert_contains "$output" "read.*code\|inspect.*code\|verify.*code\|read.*diff\|trust.*diff" "Reviewer reads code"; then
|
||||
: # pass
|
||||
else
|
||||
exit 1
|
||||
|
||||
@@ -210,8 +210,13 @@ assert_equals "$tar_archive_paths" "$archive_paths" "zip and tar.gz archives con
|
||||
tar_task_brief_mode="$(tar -tzvf "$tar_archive" skills/subagent-driven-development/scripts/task-brief | awk '{print $1}')"
|
||||
assert_equals "$tar_task_brief_mode" "-rwxr-xr-x" "tar.gz archive preserves executable script mode"
|
||||
|
||||
tar_metadata_times="$(tar -tzvf "$tar_archive" | awk '{print $6, $7, $8}' | sort -u)"
|
||||
assert_equals "$tar_metadata_times" "Dec 31 1969" "tar.gz archive normalizes entry timestamps"
|
||||
tar_metadata_times="$(python3 - "$tar_archive" <<'PY'
|
||||
import sys, tarfile
|
||||
with tarfile.open(sys.argv[1]) as archive:
|
||||
print(sorted({member.mtime for member in archive.getmembers()}))
|
||||
PY
|
||||
)"
|
||||
assert_equals "$tar_metadata_times" "[0]" "tar.gz archive normalizes entry timestamps"
|
||||
|
||||
metadata_archive="$TEST_ROOT/metadata-source.tar.gz"
|
||||
metadata_zip="$TEST_ROOT/metadata-source.zip"
|
||||
|
||||
@@ -143,27 +143,6 @@ for (const forbiddenText of forbiddenTexts) {
|
||||
|
||||
echo "SessionStart hook output tests"
|
||||
|
||||
# Registration shape: the hook must declare shell:"bash" so Claude Code on
|
||||
# Windows dispatches via Git Bash (or fails with an actionable error) instead
|
||||
# of PowerShell/cmd.exe, whose parsers break on the quoted command string
|
||||
# (PowerShell ParserError; cmd.exe quote-stripping on paths with metacharacters).
|
||||
if node -e '
|
||||
const hooks = JSON.parse(require("fs").readFileSync(process.argv[1], "utf8"));
|
||||
const entry = hooks.hooks.SessionStart[0].hooks[0];
|
||||
if (entry.shell !== "bash") {
|
||||
console.error(`SessionStart hook shell is ${JSON.stringify(entry.shell)}, expected "bash"`);
|
||||
process.exit(1);
|
||||
}
|
||||
if (!/run-hook\.cmd" session-start$/.test(entry.command)) {
|
||||
console.error(`unexpected SessionStart command shape: ${entry.command}`);
|
||||
process.exit(1);
|
||||
}
|
||||
' "$REPO_ROOT/hooks/hooks.json"; then
|
||||
pass "hooks.json registers SessionStart with shell:bash dispatch"
|
||||
else
|
||||
fail "hooks.json registers SessionStart with shell:bash dispatch"
|
||||
fi
|
||||
|
||||
claude_home="$(make_home claude-code)"
|
||||
assert_command_output \
|
||||
"Claude Code emits nested SessionStart additionalContext" \
|
||||
|
||||
Reference in New Issue
Block a user