#!/usr/bin/env bash # lib/tests/extract-guard.test.sh # hooks/extract-guard.sh: denies an extraction into / or a system dir, # silent on everything else. Also locks the settings.json wiring (last). # shellcheck disable=SC2016 # single-quoted forms are the commands under test set -u ROOT="$(cd "$(dirname "$0")/../.." && pwd)" H="$ROOT/hooks/extract-guard.sh" WORK=$(mktemp -d) trap 'rm -rf "$WORK"' EXIT pass=0; fail=0 check() { if [ "$2" = "$3" ]; then pass=$((pass+1)); else fail=$((fail+1)); printf 'FAIL %s: got[%s] want[%s]\n' "$1" "$2" "$3"; fi; } OUT=""; RC=0 run() { # run OUT=$(printf '%s' "$1" \ | jq -Rs '{tool_name:"Bash",tool_input:{command:.}}' \ | bash "$H" 2>/dev/null); RC=$? } decision() { printf '%s' "$OUT" \ | jq -r '.hookSpecificOutput.permissionDecision // "none"' 2>/dev/null; } deny() { run "$1"; check "deny[$1]" "$RC $(decision)" "0 deny"; } allow() { run "$1"; check "allow[$1]" "$RC [$OUT]" "0 []"; } # ── deny ── deny 'dpkg -x p.deb /' deny 'dpkg-deb --extract p.deb /usr' deny 'dpkg -x p.deb' deny $'dpkg -x p.deb \\\n/' deny 'tar -xzf a.tgz -C /usr' deny 'tar -xf a.tar -C "/usr"' deny 'tar -C /usr -xzf a.tgz' deny 'tar -z -xvf a.tgz -C /' deny 'tar xzf a.tgz -C/' deny 'tar -xvC / -f a.tar' deny 'tar -xf a.tar --directory=/etc' deny 'tar -C /tmp/w -C / -xf a.tar' deny $'tar -xzf a.tgz \\\n -C /usr' deny 'cd / && tar xf a.tar' deny 'cd / && cd usr && tar xf a.tar' deny 'pushd /usr && unzip a.zip' deny "unzip a.zip -d '/opt'" deny 'unzip -od /usr a.zip' deny 'cpio -idm -D /usr < a.cpio' deny 'cd / && cpio -vidm < a.cpio' deny 'cp -r build /opt/app' deny 'cp -r build /opt/app 2>/dev/null' deny 'cp -rt /usr/lib src' deny 'cp -a src "/usr/local/x"' deny 'find dist -exec cp -r {} /var/www/html \;' deny "ssh vm 'dpkg -x p.deb /'" deny "ssh -i k -p 2222 root@vm 'tar -xf /tmp/a.tar -C /'" deny 'vaas-cli ssh vm -- tar -xzf a.tgz -C /usr' deny "vaas-cli ssh vm 'dpkg -x /tmp/p.deb /'" deny $'vaas-cli ssh vm "\nset -e\ncd /\ntar xf /tmp/a.tar\n"' deny 'bash -c "cd /usr/lib && unzip a.zip"' deny "sudo sh -c 'cd / && tar xzf /tmp/a.tgz'" deny "timeout 600 vaas-cli ssh vm 'dpkg -x p.deb /'" deny $'ssh vm bash -s <<\'EOF\' 2>&1 | tail -5\ntar -xf a.tar -C /\nEOF' deny $'cat <<< "$x"\ntar -xf a.tar -C /' deny 'tar -xf $(ls *.tar) -C /' deny 'tar -xf `ls *.tar` -C /usr' deny 'out="$(vaas-cli ssh vm '"'dpkg -x /tmp/p.deb /'"')"' deny 'tar -xf a.tar -C "$DEST"' deny 'tar -xf a.tar -C ~/../../usr' deny 'stdbuf -oL tar -xf a.tar -C /' deny 'busybox tar -xf a.tar -C /' deny 'for f in *.deb; do dpkg -x $f /; done' deny 'cd "$work" && tar xf a.tar' deny "bash -c \"ssh vm 'sh -c \\\"bash -c \\\\\\\"tar xf a -C /\\\\\\\"\\\"'\"" deny 'dpkg-deb -x p.deb /' deny 'dpkg --extract p.deb /usr' deny 'cd / && ssh vm "tar xf a"' deny '(cd /; tar xf a.tar)' deny 't'"'a'"'r xf a.tar -C /' deny '"t"ar xf a.tar -C /' deny $'ta\\\nr xf a.tar -C /' deny $'$\'tar\' xf a.tar -C /' deny '$"tar" xf a.tar -C /' deny $'tar xf a.tar -C $\'\\x2f\'' deny $'echo \x01# ; tar xf a.tar -C /' deny 'tar xf a.tar -C /u?r' deny 'cp -r build /{usr,}' deny 'cp -r build /op*' deny 'cp -r build dist*' deny 'find . | cpio -pdm /' # two violations: exactly one JSON object run 'dpkg -x a.deb / ; tar -xf a.tar -C /usr' check two-violations "$(printf '%s' "$OUT" | jq -s length)" 1 # ── allow ── allow 'tar -C /tmp/x -xf a.tar' allow 'tar -cf /tmp/a.tar /usr' allow 'tar tf a.tar' allow 'tar -tvf a.tar -C /' allow 'tar -xf a.tar' allow 'tar -xf a.tar -C ~/x' allow 'tar -xf a.tar -C "$HOME/x"' allow 'tar -xf a.tar -C /var/folders/ab/T/tmp.X' allow 'tar -xf a.tar -C /var/tmp/w' allow 'tar -xf a.tar -C /home/u/proj/build' allow 'cd /home/u/proj && unzip a.zip' allow '(cd / && ls) && tar xf a.tar' allow 'find . | cpio -pdm /tmp/w' allow 'dpkg -c p.deb' allow 'dpkg -R -i debs/' allow 'unzip -l a.zip' allow 'unzip -Z1 a.zip' allow 'cpio -itv < a.cpio' allow 'unzip a.zip -d build' allow 'cp a.txt /etc/hosts' allow 'cp -r src dist' allow 'cp --parents a /tmp/x' allow 'cp -r a b > /dev/null' allow 'grep -rn "dpkg -x" docs' allow 'echo "tar xf a"' allow "vaas-cli ssh vm 'tar -xf a.tar -C /tmp/w'" allow "vaas-cli ssh vm 'unzip a.zip -d build'" allow "vaas-cli ssh vm 'command -v unzip || sudo apt-get install -y unzip'" allow 'sudo apt install tar xz-utils' allow 'git commit -m "doc: list an archive with tar tf before extracting"' allow 'bash ~/.claude/lib/memory.sh add learning --title "dpkg -x into a system dir breaks usr-merge" --body-file /tmp/b' # quiet corpus: ordinary commands, silent rc 0 while IFS= read -r c; do allow "$c"; done <<'EOF' ls -la /usr/lib | grep tar jq -r '.a[] | select(.x > 1)' f.json awk '{ print $1 }' data.txt echo "a" "b" git status --short git log --oneline -n 5 cat /etc/hosts grep -rn "cp" src make test suite=memory npm run build && npm test sed -n '1,20p' README.md find . -name '*.sh' -exec shellcheck {} + curl -sS https://example.org/x -o /tmp/x.json mkdir -p /tmp/w && cd /tmp/w && ls python3 -I -c 'print(1)' docker ps --format '{{.Names}}' ssh vm 'uname -a' rsync -n a/ b/ cp a.txt b.txt git commit -m "$(printf 'fix: a\n\nbody')" EOF run $'git commit -m "$(cat <<\'EOF\'\nfeat: x\n\nbody about archives\nEOF\n)"' check quiet-heredoc-commit "$RC [$OUT]" "0 []" # angle-bracket placeholders are words, real redirections are not allow 'dpkg -x ' allow 'tar -xf -C ' allow $'git commit -F - <<\'EOF\'\nnever run dpkg -x \nEOF' deny 'dpkg -x p.deb /' deny 'cp -r a /opt/app >log' deny 'dpkg -x /' deny 'dpkg -x &1 >"$WORK/o"); rc=$? check nojq "$rc [$(cat "$WORK/o")] [$err]" \ "0 [] [extract-guard: jq missing, guard inactive]" run 'tar xf a -C /' check deny-json-shape "$(printf '%s' "$OUT" | jq -r \ '.hookSpecificOutput | .hookEventName + " " + .permissionDecision')" \ "PreToolUse deny" check deny-reason-names-rule "$(printf '%s' "$OUT" \ | jq -r '.hookSpecificOutput.permissionDecisionReason' \ | grep -c 'Destructive tools & data loss')" 1 out=$(printf 'not json' | bash "$H" 2>/dev/null); check badjson "$? [$out]" "0 []" out=$(printf '{}' | bash "$H" 2>/dev/null); check nocmd "$? [$out]" "0 []" # ── wiring (last): settings.json carries the entry and the soft_deny line ── S="$ROOT/settings.json" check wiring-entry "$(jq -e '.hooks.PreToolUse[] | select(any(.hooks[]; .command=="bash ~/.claude/hooks/extract-guard.sh")) | .matcher=="Bash|Monitor" and .hooks[0].timeout==10' "$S" 2>&1)" true check wiring-soft-deny "$(jq -r '[.autoMode.soft_deny[] | select(startswith("Extracting, unpacking or recursively copying"))] | length' "$S")" 1 printf 'PASS=%s FAIL=%s\n' "$pass" "$fail"; [ "$fail" -eq 0 ]