qualia-framework-v2 2.6.0 → 2.8.0

package/tests/state.test.sh

@@ -0,0 +1,398 @@
+#!/bin/bash
+# Qualia Framework v2 — state.js behavioral tests
+# Run: bash tests/state.test.sh
+
+PASS=0
+FAIL=0
+# Resolve STATE_JS to an ABSOLUTE path so `cd` inside subshells doesn't break it.
+STATE_JS="$(cd "$(dirname "$0")/../bin" && pwd)/state.js"
+NODE="${NODE:-node}"
+
+# Track tmp dirs we create so we can clean them up on exit
+TMP_DIRS=()
+cleanup() {
+  for d in "${TMP_DIRS[@]}"; do
+    [ -d "$d" ] && rm -rf "$d"
+  done
+}
+trap cleanup EXIT
+
+# Make a fresh temp project with 2 phases, already initialized.
+# Prints the absolute path to the new tmp dir (does NOT cd).
+make_project() {
+  local TMP
+  TMP=$(mktemp -d)
+  TMP_DIRS+=("$TMP")
+  (
+    cd "$TMP" || exit 1
+    $NODE "$STATE_JS" init \
+      --project "TestProject" \
+      --phases '[{"name":"Foundation","goal":"Auth"},{"name":"Core","goal":"Features"}]' \
+      >/dev/null 2>&1
+  )
+  echo "$TMP"
+}
+
+# pass "name" — record a passing assertion
+pass() {
+  echo "  ✓ $1"
+  PASS=$((PASS + 1))
+}
+
+# fail "name" "detail"
+fail_case() {
+  echo "  ✗ $1${2:+ — $2}"
+  FAIL=$((FAIL + 1))
+}
+
+echo "=== state.js Behavioral Tests ==="
+echo ""
+
+# Sanity check
+if [ ! -f "$STATE_JS" ]; then
+  echo "FATAL: state.js not found at $STATE_JS"
+  exit 1
+fi
+
+# ─── Basic I/O ───────────────────────────────────────────
+echo "basic I/O:"
+
+# 1. cmdInit produces valid tracking.json + STATE.md
+TMP=$(mktemp -d); TMP_DIRS+=("$TMP")
+(
+  cd "$TMP" || exit 1
+  $NODE "$STATE_JS" init \
+    --project "TestProject" \
+    --phases '[{"name":"Foundation","goal":"Auth"},{"name":"Core","goal":"Features"}]' \
+    >/tmp/qualia-state-test.out 2>&1
+)
+INIT_EXIT=$?
+if [ "$INIT_EXIT" -eq 0 ] \
+   && [ -f "$TMP/.planning/tracking.json" ] \
+   && [ -f "$TMP/.planning/STATE.md" ] \
+   && grep -q '"ok": true' /tmp/qualia-state-test.out \
+   && grep -q '"action": "init"' /tmp/qualia-state-test.out; then
+  pass "cmdInit creates tracking.json + STATE.md"
+else
+  fail_case "cmdInit creates tracking.json + STATE.md" "exit=$INIT_EXIT"
+fi
+
+# tracking.json content sanity
+if grep -q '"project": "TestProject"' "$TMP/.planning/tracking.json" \
+   && grep -q '"total_phases": 2' "$TMP/.planning/tracking.json" \
+   && grep -q '"phase": 1' "$TMP/.planning/tracking.json" \
+   && grep -q '"status": "setup"' "$TMP/.planning/tracking.json"; then
+  pass "cmdInit tracking.json has correct fields"
+else
+  fail_case "cmdInit tracking.json fields"
+fi
+
+# STATE.md content sanity
+if grep -q 'Phase: 1 of 2 — Foundation' "$TMP/.planning/STATE.md" \
+   && grep -q 'Status: setup' "$TMP/.planning/STATE.md"; then
+  pass "cmdInit STATE.md has correct header"
+else
+  fail_case "cmdInit STATE.md header"
+fi
+
+# 2. cmdCheck reads back init state
+OUT=$(cd "$TMP" && $NODE "$STATE_JS" check 2>&1)
+CHECK_EXIT=$?
+if [ "$CHECK_EXIT" -eq 0 ] \
+   && echo "$OUT" | grep -q '"ok": true' \
+   && echo "$OUT" | grep -q '"phase": 1' \
+   && echo "$OUT" | grep -q '"status": "setup"' \
+   && echo "$OUT" | grep -q '"total_phases": 2'; then
+  pass "cmdCheck returns phase=1 status=setup total_phases=2"
+else
+  fail_case "cmdCheck returns init state" "exit=$CHECK_EXIT"
+fi
+
+# 3. cmdCheck with no project → ok:false NO_PROJECT, exit 1
+TMP2=$(mktemp -d); TMP_DIRS+=("$TMP2")
+OUT=$(cd "$TMP2" && $NODE "$STATE_JS" check 2>&1)
+CHECK_EXIT=$?
+if [ "$CHECK_EXIT" -eq 1 ] \
+   && echo "$OUT" | grep -q '"ok": false' \
+   && echo "$OUT" | grep -q '"error": "NO_PROJECT"'; then
+  pass "cmdCheck without .planning → NO_PROJECT, exit 1"
+else
+  fail_case "cmdCheck NO_PROJECT" "exit=$CHECK_EXIT"
+fi
+
+# ─── Happy path transitions ──────────────────────────────
+echo ""
+echo "happy path transitions:"
+
+# 4. setup → planned (with plan file)
+TMP=$(make_project)
+touch "$TMP/.planning/phase-1-plan.md"
+OUT=$(cd "$TMP" && $NODE "$STATE_JS" transition --to planned 2>&1)
+EXIT=$?
+if [ "$EXIT" -eq 0 ] \
+   && echo "$OUT" | grep -q '"ok": true' \
+   && echo "$OUT" | grep -q '"status": "planned"' \
+   && echo "$OUT" | grep -q '"previous_status": "setup"'; then
+  pass "setup → planned succeeds with plan file"
+else
+  fail_case "setup → planned" "exit=$EXIT out=$OUT"
+fi
+
+# 5. planned → built (records tasks_done/tasks_total)
+OUT=$(cd "$TMP" && $NODE "$STATE_JS" transition --to built --tasks-done 5 --tasks-total 5 2>&1)
+EXIT=$?
+if [ "$EXIT" -eq 0 ] \
+   && echo "$OUT" | grep -q '"ok": true' \
+   && echo "$OUT" | grep -q '"status": "built"' \
+   && grep -q '"tasks_done": 5' "$TMP/.planning/tracking.json" \
+   && grep -q '"tasks_total": 5' "$TMP/.planning/tracking.json"; then
+  pass "planned → built records tasks_done/tasks_total"
+else
+  fail_case "planned → built" "exit=$EXIT"
+fi
+
+# 6. built → verified(pass) auto-advances to phase 2, resets status to setup
+touch "$TMP/.planning/phase-1-verification.md"
+OUT=$(cd "$TMP" && $NODE "$STATE_JS" transition --to verified --verification pass 2>&1)
+EXIT=$?
+if [ "$EXIT" -eq 0 ] \
+   && echo "$OUT" | grep -q '"ok": true' \
+   && echo "$OUT" | grep -q '"phase": 2' \
+   && echo "$OUT" | grep -q '"status": "setup"'; then
+  pass "built → verified(pass) auto-advances phase and resets to setup"
+else
+  fail_case "built → verified(pass) auto-advance" "exit=$EXIT out=$OUT"
+fi
+
+# 7. built → verified(fail) stays on phase 1, records verification=fail
+TMP=$(make_project)
+touch "$TMP/.planning/phase-1-plan.md"
+(cd "$TMP" && $NODE "$STATE_JS" transition --to planned >/dev/null 2>&1)
+(cd "$TMP" && $NODE "$STATE_JS" transition --to built --tasks-done 3 --tasks-total 5 >/dev/null 2>&1)
+touch "$TMP/.planning/phase-1-verification.md"
+OUT=$(cd "$TMP" && $NODE "$STATE_JS" transition --to verified --verification fail 2>&1)
+EXIT=$?
+if [ "$EXIT" -eq 0 ] \
+   && echo "$OUT" | grep -q '"ok": true' \
+   && echo "$OUT" | grep -q '"phase": 1' \
+   && echo "$OUT" | grep -q '"status": "verified"' \
+   && echo "$OUT" | grep -q '"verification": "fail"'; then
+  pass "built → verified(fail) stays on phase 1"
+else
+  fail_case "built → verified(fail)" "exit=$EXIT out=$OUT"
+fi
+
+# ─── Precondition failures ───────────────────────────────
+echo ""
+echo "precondition failures:"
+
+# 8. setup → built fails with PRECONDITION_FAILED
+TMP=$(make_project)
+OUT=$(cd "$TMP" && $NODE "$STATE_JS" transition --to built 2>&1)
+EXIT=$?
+if [ "$EXIT" -eq 1 ] \
+   && echo "$OUT" | grep -q '"ok": false' \
+   && echo "$OUT" | grep -q '"error": "PRECONDITION_FAILED"' \
+   && echo "$OUT" | grep -q "Cannot go from 'setup' to 'built'"; then
+  pass "setup → built fails with PRECONDITION_FAILED"
+else
+  fail_case "setup → built precondition" "exit=$EXIT out=$OUT"
+fi
+
+# 9. planned → verified fails (requires status=built)
+TMP=$(make_project)
+touch "$TMP/.planning/phase-1-plan.md"
+(cd "$TMP" && $NODE "$STATE_JS" transition --to planned >/dev/null 2>&1)
+touch "$TMP/.planning/phase-1-verification.md"
+OUT=$(cd "$TMP" && $NODE "$STATE_JS" transition --to verified --verification pass 2>&1)
+EXIT=$?
+if [ "$EXIT" -eq 1 ] \
+   && echo "$OUT" | grep -q '"error": "PRECONDITION_FAILED"' \
+   && echo "$OUT" | grep -q "Cannot go from 'planned' to 'verified'"; then
+  pass "planned → verified fails (requires built)"
+else
+  fail_case "planned → verified precondition" "exit=$EXIT out=$OUT"
+fi
+
+# 10. planned with missing plan file → MISSING_FILE
+TMP=$(make_project)
+# no phase-1-plan.md created
+OUT=$(cd "$TMP" && $NODE "$STATE_JS" transition --to planned 2>&1)
+EXIT=$?
+if [ "$EXIT" -eq 1 ] \
+   && echo "$OUT" | grep -q '"error": "MISSING_FILE"' \
+   && echo "$OUT" | grep -q "phase-1-plan.md"; then
+  pass "setup → planned fails without plan file (MISSING_FILE)"
+else
+  fail_case "setup → planned MISSING_FILE" "exit=$EXIT out=$OUT"
+fi
+
+# 11. built → verified with missing verification file → MISSING_FILE
+TMP=$(make_project)
+touch "$TMP/.planning/phase-1-plan.md"
+(cd "$TMP" && $NODE "$STATE_JS" transition --to planned >/dev/null 2>&1)
+(cd "$TMP" && $NODE "$STATE_JS" transition --to built --tasks-done 1 --tasks-total 1 >/dev/null 2>&1)
+# NO verification file
+OUT=$(cd "$TMP" && $NODE "$STATE_JS" transition --to verified --verification pass 2>&1)
+EXIT=$?
+if [ "$EXIT" -eq 1 ] \
+   && echo "$OUT" | grep -q '"error": "MISSING_FILE"' \
+   && echo "$OUT" | grep -q "phase-1-verification.md"; then
+  pass "built → verified fails without verification file (MISSING_FILE)"
+else
+  fail_case "built → verified MISSING_FILE" "exit=$EXIT out=$OUT"
+fi
+
+# 12. built → verified without --verification → MISSING_ARG
+TMP=$(make_project)
+touch "$TMP/.planning/phase-1-plan.md"
+(cd "$TMP" && $NODE "$STATE_JS" transition --to planned >/dev/null 2>&1)
+(cd "$TMP" && $NODE "$STATE_JS" transition --to built --tasks-done 1 --tasks-total 1 >/dev/null 2>&1)
+touch "$TMP/.planning/phase-1-verification.md"
+OUT=$(cd "$TMP" && $NODE "$STATE_JS" transition --to verified 2>&1)
+EXIT=$?
+if [ "$EXIT" -eq 1 ] \
+   && echo "$OUT" | grep -q '"error": "MISSING_ARG"' \
+   && echo "$OUT" | grep -q "verification"; then
+  pass "built → verified without --verification → MISSING_ARG"
+else
+  fail_case "built → verified MISSING_ARG" "exit=$EXIT out=$OUT"
+fi
+
+# 13. → shipped without --deployed-url → MISSING_ARG
+# Must go through polished first, so fabricate state by transitioning through the full path.
+TMP=$(make_project)
+touch "$TMP/.planning/phase-1-plan.md"
+(cd "$TMP" && $NODE "$STATE_JS" transition --to planned >/dev/null 2>&1)
+(cd "$TMP" && $NODE "$STATE_JS" transition --to built --tasks-done 1 --tasks-total 1 >/dev/null 2>&1)
+touch "$TMP/.planning/phase-1-verification.md"
+(cd "$TMP" && $NODE "$STATE_JS" transition --to verified --verification pass >/dev/null 2>&1)
+# Now on phase 2, status=setup. Run phase 2 to completion.
+touch "$TMP/.planning/phase-2-plan.md"
+(cd "$TMP" && $NODE "$STATE_JS" transition --to planned >/dev/null 2>&1)
+(cd "$TMP" && $NODE "$STATE_JS" transition --to built --tasks-done 1 --tasks-total 1 >/dev/null 2>&1)
+touch "$TMP/.planning/phase-2-verification.md"
+(cd "$TMP" && $NODE "$STATE_JS" transition --to verified --verification pass >/dev/null 2>&1)
+# Status should now be "verified" on last phase (no auto-advance past last phase)
+(cd "$TMP" && $NODE "$STATE_JS" transition --to polished >/dev/null 2>&1)
+# Now try ship without deployed-url
+OUT=$(cd "$TMP" && $NODE "$STATE_JS" transition --to shipped 2>&1)
+EXIT=$?
+if [ "$EXIT" -eq 1 ] \
+   && echo "$OUT" | grep -q '"error": "MISSING_ARG"' \
+   && echo "$OUT" | grep -q "deployed-url"; then
+  pass "→ shipped without --deployed-url → MISSING_ARG"
+else
+  fail_case "→ shipped MISSING_ARG" "exit=$EXIT out=$OUT"
+fi
+
+# 14. Unknown target --to frobnicate → INVALID_STATUS
+TMP=$(make_project)
+OUT=$(cd "$TMP" && $NODE "$STATE_JS" transition --to frobnicate 2>&1)
+EXIT=$?
+if [ "$EXIT" -eq 1 ] \
+   && echo "$OUT" | grep -q '"error": "INVALID_STATUS"'; then
+  pass "--to frobnicate → INVALID_STATUS"
+else
+  fail_case "invalid target" "exit=$EXIT out=$OUT"
+fi
+
+# ─── Gap cycle circuit breaker ───────────────────────────
+echo ""
+echo "gap cycle circuit breaker:"
+
+# 15. First gap closure: verified(fail) → planned, gap_cycles[1]=1
+TMP=$(make_project)
+touch "$TMP/.planning/phase-1-plan.md"
+touch "$TMP/.planning/phase-1-verification.md"
+(cd "$TMP" && $NODE "$STATE_JS" transition --to planned >/dev/null 2>&1)
+(cd "$TMP" && $NODE "$STATE_JS" transition --to built --tasks-done 1 --tasks-total 1 >/dev/null 2>&1)
+(cd "$TMP" && $NODE "$STATE_JS" transition --to verified --verification fail >/dev/null 2>&1)
+OUT=$(cd "$TMP" && $NODE "$STATE_JS" transition --to planned 2>&1)
+EXIT=$?
+if [ "$EXIT" -eq 0 ] \
+   && echo "$OUT" | grep -q '"ok": true' \
+   && echo "$OUT" | grep -q '"gap_cycles": 1'; then
+  pass "first gap closure: verified(fail) → planned, gap_cycles=1"
+else
+  fail_case "first gap closure" "exit=$EXIT out=$OUT"
+fi
+
+# 16. Second gap closure: gap_cycles[1]=2
+(cd "$TMP" && $NODE "$STATE_JS" transition --to built --tasks-done 1 --tasks-total 1 >/dev/null 2>&1)
+(cd "$TMP" && $NODE "$STATE_JS" transition --to verified --verification fail >/dev/null 2>&1)
+OUT=$(cd "$TMP" && $NODE "$STATE_JS" transition --to planned 2>&1)
+EXIT=$?
+if [ "$EXIT" -eq 0 ] \
+   && echo "$OUT" | grep -q '"ok": true' \
+   && echo "$OUT" | grep -q '"gap_cycles": 2'; then
+  pass "second gap closure: gap_cycles=2"
+else
+  fail_case "second gap closure" "exit=$EXIT out=$OUT"
+fi
+
+# 17. Third gap closure attempt → GAP_CYCLE_LIMIT
+(cd "$TMP" && $NODE "$STATE_JS" transition --to built --tasks-done 1 --tasks-total 1 >/dev/null 2>&1)
+(cd "$TMP" && $NODE "$STATE_JS" transition --to verified --verification fail >/dev/null 2>&1)
+OUT=$(cd "$TMP" && $NODE "$STATE_JS" transition --to planned 2>&1)
+EXIT=$?
+if [ "$EXIT" -eq 1 ] \
+   && echo "$OUT" | grep -q '"error": "GAP_CYCLE_LIMIT"'; then
+  pass "third gap closure attempt blocked (GAP_CYCLE_LIMIT)"
+else
+  fail_case "gap cycle limit" "exit=$EXIT out=$OUT"
+fi
+
+# 18. verified(pass) resets gap_cycles[1] to 0
+# Set up a fresh project, do ONE failed cycle, then pass on the next attempt.
+TMP=$(make_project)
+touch "$TMP/.planning/phase-1-plan.md"
+touch "$TMP/.planning/phase-1-verification.md"
+(cd "$TMP" && $NODE "$STATE_JS" transition --to planned >/dev/null 2>&1)
+(cd "$TMP" && $NODE "$STATE_JS" transition --to built --tasks-done 1 --tasks-total 1 >/dev/null 2>&1)
+(cd "$TMP" && $NODE "$STATE_JS" transition --to verified --verification fail >/dev/null 2>&1)
+# gap_cycles[1] is now 0 before the gap closure; becomes 1 after
+(cd "$TMP" && $NODE "$STATE_JS" transition --to planned >/dev/null 2>&1)
+(cd "$TMP" && $NODE "$STATE_JS" transition --to built --tasks-done 1 --tasks-total 1 >/dev/null 2>&1)
+(cd "$TMP" && $NODE "$STATE_JS" transition --to verified --verification pass >/dev/null 2>&1)
+# After pass, gap_cycles[1] should be reset to 0 in tracking.json
+if grep -q '"1": 0' "$TMP/.planning/tracking.json"; then
+  pass "verified(pass) resets gap_cycles[1] to 0"
+else
+  fail_case "gap cycle reset on pass"
+fi
+
+# ─── Special transitions ─────────────────────────────────
+echo ""
+echo "special transitions:"
+
+# 19. --to note --notes "foo" succeeds, records notes
+TMP=$(make_project)
+OUT=$(cd "$TMP" && $NODE "$STATE_JS" transition --to note --notes "hello world" 2>&1)
+EXIT=$?
+if [ "$EXIT" -eq 0 ] \
+   && echo "$OUT" | grep -q '"ok": true' \
+   && echo "$OUT" | grep -q '"action": "note"' \
+   && echo "$OUT" | grep -q '"status": "setup"' \
+   && grep -q '"notes": "hello world"' "$TMP/.planning/tracking.json"; then
+  pass "--to note records notes, status unchanged"
+else
+  fail_case "--to note" "exit=$EXIT out=$OUT"
+fi
+
+# 20. --to activity succeeds without status change
+OUT=$(cd "$TMP" && $NODE "$STATE_JS" transition --to activity 2>&1)
+EXIT=$?
+if [ "$EXIT" -eq 0 ] \
+   && echo "$OUT" | grep -q '"ok": true' \
+   && echo "$OUT" | grep -q '"action": "activity"' \
+   && echo "$OUT" | grep -q '"status": "setup"'; then
+  pass "--to activity succeeds without status change"
+else
+  fail_case "--to activity" "exit=$EXIT out=$OUT"
+fi
+
+# ─── Summary ─────────────────────────────────────────────
+echo ""
+echo "=== Results: $PASS passed, $FAIL failed ==="
+[ "$FAIL" -eq 0 ] && exit 0 || exit 1

package/hooks/auto-update.sh

@@ -1,56 +0,0 @@
-#!/bin/bash
-# Qualia auto-update — checks once per day, updates silently in background
-# Runs as PreToolUse hook. Cached so it's a no-op most of the time.
-
-CLAUDE_DIR="$HOME/.claude"
-CACHE_FILE="$CLAUDE_DIR/.qualia-last-update-check"
-CONFIG_FILE="$CLAUDE_DIR/.qualia-config.json"
-LOCK_FILE="$CLAUDE_DIR/.qualia-updating"
-MAX_AGE=86400  # 24 hours in seconds
-
-# Exit fast if recently checked (most common path — single stat call)
-if [ -f "$CACHE_FILE" ]; then
-  LAST_CHECK=$(cat "$CACHE_FILE" 2>/dev/null || echo 0)
-  NOW=$(date +%s)
-  AGE=$((NOW - LAST_CHECK))
-  if [ "$AGE" -lt "$MAX_AGE" ]; then
-    exit 0
-  fi
-fi
-
-# Exit if already updating
-[ -f "$LOCK_FILE" ] && exit 0
-
-# Update cache timestamp immediately (prevents concurrent checks)
-date +%s > "$CACHE_FILE"
-
-# Run the actual check + update in background so we don't block the user
-(
-  trap 'rm -f "$LOCK_FILE"' EXIT
-  touch "$LOCK_FILE"
-
-  # Get installed version
-  INSTALLED=$(node -e "try{console.log(JSON.parse(require('fs').readFileSync('$CONFIG_FILE','utf8')).version)}catch{console.log('0.0.0')}" 2>/dev/null)
-  [ -z "$INSTALLED" ] && INSTALLED="0.0.0"
-
-  # Get latest from npm (5s timeout)
-  LATEST=$(npm view qualia-framework-v2 version 2>/dev/null)
-  [ -z "$LATEST" ] && exit 0
-
-  # Compare versions
-  NEEDS_UPDATE=$(node -e "
-    const a='$LATEST'.split('.').map(Number), b='$INSTALLED'.split('.').map(Number);
-    for(let i=0;i<3;i++){if(a[i]>b[i]){console.log('yes');process.exit()}if(a[i]<b[i]){process.exit()}}
-  " 2>/dev/null)
-
-  if [ "$NEEDS_UPDATE" = "yes" ]; then
-    # Get saved install code
-    CODE=$(node -e "try{console.log(JSON.parse(require('fs').readFileSync('$CONFIG_FILE','utf8')).code)}catch{}" 2>/dev/null)
-    [ -z "$CODE" ] && exit 0
-
-    # Run silent update
-    npx qualia-framework-v2@latest install <<< "$CODE" > /dev/null 2>&1
-  fi
-) &
-
-exit 0

package/hooks/block-env-edit.sh

@@ -1,11 +0,0 @@
-#!/bin/bash
-# Prevent Claude from editing .env files
-# Claude Code hooks receive JSON on stdin with tool_input.file_path
-
-INPUT=$(cat)
-FILE=$(echo "$INPUT" | jq -r '.tool_input.file_path // .tool_input.command // ""' 2>/dev/null)
-
-if [[ "$FILE" == *.env* ]] || [[ "$FILE" == *".env.local"* ]] || [[ "$FILE" == *".env.production"* ]]; then
-  echo "BLOCKED: Cannot edit environment files. Ask Fawzi to update secrets."
-  exit 2
-fi

package/hooks/branch-guard.sh

@@ -1,27 +0,0 @@
-#!/bin/bash
-# Block non-OWNER push to main/master
-# Reads role from ~/.claude/.qualia-config.json (machine-readable source of truth)
-
-BRANCH=$(git branch --show-current 2>/dev/null)
-CONFIG="$HOME/.claude/.qualia-config.json"
-
-if [ ! -f "$CONFIG" ]; then
-  echo "BLOCKED: ~/.claude/.qualia-config.json missing. Run: npx qualia-framework-v2 install"
-  exit 1
-fi
-
-# Extract role without jq dependency (installers may not have jq)
-ROLE=$(node -e "try{console.log(JSON.parse(require('fs').readFileSync('$CONFIG','utf8')).role||'')}catch{}" 2>/dev/null)
-
-if [ -z "$ROLE" ]; then
-  echo "BLOCKED: Cannot determine role from $CONFIG. Defaulting to deny."
-  exit 1
-fi
-
-if [[ "$BRANCH" == "main" || "$BRANCH" == "master" ]]; then
-  if [[ "$ROLE" != "OWNER" ]]; then
-    echo "BLOCKED: Employees cannot push to $BRANCH. Create a feature branch first."
-    echo "Run: git checkout -b feature/your-feature-name"
-    exit 1
-  fi
-fi

package/hooks/migration-guard.sh

@@ -1,43 +0,0 @@
-#!/bin/bash
-# Catch dangerous SQL patterns in migration files
-# Runs as PreToolUse hook on Write/Edit of migration files
-
-INPUT=$(cat)
-FILE=$(echo "$INPUT" | jq -r '.tool_input.file_path // ""' 2>/dev/null)
-CONTENT=$(echo "$INPUT" | jq -r '.tool_input.content // .tool_input.new_string // ""' 2>/dev/null)
-
-# Only check migration/SQL files
-case "$FILE" in
-  *migration*|*migrate*|*.sql) ;;
-  *) exit 0 ;;
-esac
-
-ERRORS=""
-
-# DROP TABLE without safeguards
-if echo "$CONTENT" | grep -qi "DROP TABLE" && ! echo "$CONTENT" | grep -qi "IF EXISTS"; then
-  ERRORS="${ERRORS}\n  ✗ DROP TABLE without IF EXISTS"
-fi
-
-# DELETE without WHERE
-if echo "$CONTENT" | grep -qi "DELETE FROM" && ! echo "$CONTENT" | grep -qi "WHERE"; then
-  ERRORS="${ERRORS}\n  ✗ DELETE FROM without WHERE clause"
-fi
-
-# TRUNCATE (almost always wrong in migrations)
-if echo "$CONTENT" | grep -qi "TRUNCATE"; then
-  ERRORS="${ERRORS}\n  ✗ TRUNCATE detected — are you sure?"
-fi
-
-# CREATE TABLE without RLS
-if echo "$CONTENT" | grep -qi "CREATE TABLE" && ! echo "$CONTENT" | grep -qi "ENABLE ROW LEVEL SECURITY"; then
-  ERRORS="${ERRORS}\n  ✗ CREATE TABLE without ENABLE ROW LEVEL SECURITY"
-fi
-
-if [ -n "$ERRORS" ]; then
-  echo "◆ Migration guard — dangerous patterns found:"
-  echo -e "$ERRORS"
-  echo ""
-  echo "Fix these before proceeding. If intentional, ask Fawzi to approve."
-  exit 2
-fi

package/hooks/pre-compact.sh

@@ -1,11 +0,0 @@
-#!/bin/bash
-# Save state before context compression
-
-if [ -f ".planning/STATE.md" ]; then
-  echo "QUALIA: Saving state before compaction..."
-  # State is in git — just ensure it's committed
-  if git diff --name-only .planning/STATE.md 2>/dev/null | grep -q STATE; then
-    git add .planning/STATE.md
-    git commit -m "state: pre-compaction save" 2>/dev/null
-  fi
-fi

package/hooks/pre-deploy-gate.sh

@@ -1,50 +0,0 @@
-#!/bin/bash
-# Quality gates before production deploy
-
-echo "◆ Pre-deploy gate..."
-
-# TypeScript check
-if [ -f "tsconfig.json" ]; then
-  if ! npx tsc --noEmit 2>/dev/null; then
-    echo "BLOCKED: TypeScript errors. Fix before deploying."
-    exit 1
-  fi
-  echo "  ✓ TypeScript"
-fi
-
-# Lint check
-if [ -f "package.json" ] && grep -q '"lint"' package.json; then
-  if ! npm run lint 2>/dev/null; then
-    echo "BLOCKED: Lint errors. Fix before deploying."
-    exit 1
-  fi
-  echo "  ✓ Lint"
-fi
-
-# Test check
-if [ -f "package.json" ] && grep -q '"test"' package.json; then
-  if ! npm test 2>/dev/null; then
-    echo "BLOCKED: Tests failed. Fix before deploying."
-    exit 1
-  fi
-  echo "  ✓ Tests"
-fi
-
-# Build check
-if [ -f "package.json" ] && grep -q '"build"' package.json; then
-  if ! npm run build 2>/dev/null; then
-    echo "BLOCKED: Build failed. Fix before deploying."
-    exit 1
-  fi
-  echo "  ✓ Build"
-fi
-
-# Security: no service_role in client code
-LEAKS=$(grep -r "service_role" app/ components/ src/ 2>/dev/null | grep -v node_modules | grep -v ".server." | wc -l)
-if [ "$LEAKS" -gt 0 ]; then
-  echo "BLOCKED: service_role found in client code. Remove before deploying."
-  exit 1
-fi
-echo "  ✓ Security"
-
-echo "◆ All gates passed."

package/hooks/pre-push.sh

@@ -1,28 +0,0 @@
-#!/bin/bash
-# Update tracking.json timestamps before push
-# State.js handles phase/status sync — this just updates commit hash and timestamp
-
-TRACKING=".planning/tracking.json"
-
-if [ -f "$TRACKING" ]; then
-  if ! command -v node &>/dev/null; then
-    echo "WARNING: node not found, skipping tracking sync" >&2
-    exit 0
-  fi
-
-  LAST_COMMIT=$(git log --oneline -1 --format="%h" 2>/dev/null)
-  NOW=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-
-  node -e "
-    const fs = require('fs');
-    try {
-      const t = JSON.parse(fs.readFileSync('$TRACKING', 'utf8'));
-      t.last_commit = '${LAST_COMMIT}';
-      t.last_updated = '${NOW}';
-      fs.writeFileSync('$TRACKING', JSON.stringify(t, null, 2) + '\n');
-    } catch (e) {
-      process.stderr.write('WARNING: tracking sync failed: ' + e.message + '\n');
-    }
-  "
-  git add "$TRACKING" 2>/dev/null
-fi

package/hooks/session-start.sh

@@ -1,35 +0,0 @@
-#!/bin/bash
-# Qualia session start — show branded context panel on every new session.
-# Delegates to qualia-ui.js so formatting matches the rest of the framework.
-
-UI="$HOME/.claude/bin/qualia-ui.js"
-STATE=".planning/STATE.md"
-
-# Fallback if qualia-ui.js is missing (first install before mirror)
-if [ ! -f "$UI" ]; then
-  if [ -f "$STATE" ]; then
-    PHASE=$(grep "^Phase:" "$STATE" 2>/dev/null | head -1)
-    STATUS=$(grep "^Status:" "$STATE" 2>/dev/null | head -1)
-    echo "QUALIA: Project loaded. $PHASE | $STATUS"
-    echo "QUALIA: Run /qualia for next step."
-  elif [ -f ".continue-here.md" ]; then
-    echo "QUALIA: Handoff file found. Read .continue-here.md to resume."
-  else
-    echo "QUALIA: No project detected. Run /qualia-new to start."
-  fi
-  exit 0
-fi
-
-# Branded banner for every session start
-if [ -f "$STATE" ]; then
-  node "$UI" banner router
-  # Read next command from state.js and suggest it
-  NEXT=$(node "$HOME/.claude/bin/state.js" check 2>/dev/null | node -e "try{let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const j=JSON.parse(d);process.stdout.write(j.next_command||'')})}" 2>/dev/null)
-  [ -n "$NEXT" ] && node "$UI" info "Run $NEXT to continue"
-elif [ -f ".continue-here.md" ]; then
-  node "$UI" banner router
-  node "$UI" warn "Handoff found — read .continue-here.md to resume"
-else
-  node "$UI" banner router
-  node "$UI" info "No project detected. Run /qualia-new to start."
-fi