feat(c7): incident response — severity classifier + scoped kill-switch + runbook (V23)
Closes the last fully-[planned] Track-C dimension (was scored 1). - incident.sh raise <event>: classify severity via incident-severity.map (LOW/MED/HIGH/CRIT), record a structured entry (owner routing), and for HIGH/CRIT auto-engage the scoped kill-switch + dispatch an alert (reuses H6 alert-dispatch.sh). Exit 2 on HIGH/CRIT so a pipeline gate goes red. - kill-switch.sh engage/clear/check/status, scoped by project/model/provider (+ global). `check` exits 2 when engaged so gates honor it. - casan-harness.sh honors an engaged kill-switch before running (opt-in CASAN_KILLSWITCH_ENFORCE=1, default OFF → baseline unchanged). - incident-runbook.md: severity→owner→response + postmortem template + prod TODO. - phase-c7-incident-tests.sh: 15 checks — severity grading, auto kill-switch on HIGH/CRIT, MED-only records, lifecycle, global scope, structured record, and the production wrapper refusing to run under an engaged switch. Baselines: run-casan4 35/35, adversarial 44/44. New suite total: 175 → 190. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 4.8
parent
571f5d8cc3
commit
f24ed21324
@@ -0,0 +1,66 @@
|
||||
#!/usr/bin/env bash
|
||||
set -uo pipefail
|
||||
|
||||
# CASAN H6/H7 — Kill-switch (Incident response · C7 / V23).
|
||||
#
|
||||
# A scoped emergency stop: engage a switch for a project / model / provider and
|
||||
# any gate that honors it refuses to run further work in that scope. Engaging is
|
||||
# recorded; clearing requires an explicit reason (production: reviewer approval).
|
||||
#
|
||||
# Usage:
|
||||
# kill-switch.sh engage <scope> <id> [reason] # turn the switch ON
|
||||
# kill-switch.sh clear <scope> <id> [reason] # turn it OFF (audited)
|
||||
# kill-switch.sh check <scope> <id> # exit 2 if engaged, 0 if clear
|
||||
# kill-switch.sh status # list engaged switches
|
||||
# scope ∈ {project, model, provider, global}. A `global` switch stops everything.
|
||||
# Env: CASAN_KILLSWITCH_DIR (default .specify/logs/level5/kill-switch)
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
|
||||
KS_DIR="${CASAN_KILLSWITCH_DIR:-$PROJECT_ROOT/.specify/logs/level5/kill-switch}"
|
||||
mkdir -p "$KS_DIR"
|
||||
|
||||
CMD="${1:-}"; SCOPE="${2:-}"; ID="${3:-}"; REASON="${4:-unspecified}"
|
||||
ts() { date -u +"%Y-%m-%dT%H:%M:%SZ"; }
|
||||
safe() { printf '%s' "$1" | tr '/ :' '___'; }
|
||||
|
||||
case "$CMD" in
|
||||
engage)
|
||||
[[ -n "$SCOPE" && -n "$ID" ]] || { echo "usage: kill-switch.sh engage <scope> <id> [reason]" >&2; exit 64; }
|
||||
f="$KS_DIR/$(safe "$SCOPE")-$(safe "$ID").on"
|
||||
printf '{"scope":"%s","id":"%s","reason":"%s","engaged_at":"%s","actor":"%s"}\n' \
|
||||
"$SCOPE" "$ID" "$REASON" "$(ts)" "${CASAN_ACTOR:-system}" > "$f"
|
||||
echo "KILL_SWITCH_ENGAGED scope=$SCOPE id=$ID reason=$REASON"
|
||||
;;
|
||||
clear)
|
||||
[[ -n "$SCOPE" && -n "$ID" ]] || { echo "usage: kill-switch.sh clear <scope> <id> [reason]" >&2; exit 64; }
|
||||
f="$KS_DIR/$(safe "$SCOPE")-$(safe "$ID").on"
|
||||
if [[ -f "$f" ]]; then
|
||||
printf '%s cleared_by=%s reason=%s at=%s\n' "$(cat "$f")" "${CASAN_ACTOR:-system}" "$REASON" "$(ts)" \
|
||||
>> "$KS_DIR/kill-switch-history.log"
|
||||
rm -f "$f"
|
||||
echo "KILL_SWITCH_CLEARED scope=$SCOPE id=$ID"
|
||||
else
|
||||
echo "KILL_SWITCH_NOT_ENGAGED scope=$SCOPE id=$ID"
|
||||
fi
|
||||
;;
|
||||
check)
|
||||
[[ -n "$SCOPE" && -n "$ID" ]] || { echo "usage: kill-switch.sh check <scope> <id>" >&2; exit 64; }
|
||||
# A global switch, or a switch for this exact scope/id, blocks.
|
||||
if [[ -f "$KS_DIR/global-all.on" ]]; then
|
||||
echo "KILL_SWITCH_ACTIVE scope=global" >&2; exit 2
|
||||
fi
|
||||
if [[ -f "$KS_DIR/$(safe "$SCOPE")-$(safe "$ID").on" ]]; then
|
||||
echo "KILL_SWITCH_ACTIVE scope=$SCOPE id=$ID" >&2; exit 2
|
||||
fi
|
||||
echo "KILL_SWITCH_CLEAR scope=$SCOPE id=$ID"; exit 0
|
||||
;;
|
||||
status)
|
||||
n=0
|
||||
for f in "$KS_DIR"/*.on; do [[ -e "$f" ]] || continue; cat "$f"; n=$((n+1)); done
|
||||
echo "KILL_SWITCH_STATUS engaged=$n"
|
||||
;;
|
||||
*)
|
||||
echo "Usage: kill-switch.sh {engage|clear|check|status} <scope> <id> [reason]" >&2
|
||||
exit 64 ;;
|
||||
esac
|
||||
Reference in New Issue
Block a user