qualia-framework-v2 2.0.0 → 2.1.1

package/hooks/migration-guard.sh

@@ -0,0 +1,43 @@
+#!/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-deploy-gate.sh

@@ -12,6 +12,24 @@ if [ -f "tsconfig.json" ]; then
   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

package/hooks/pre-push.sh

@@ -12,8 +12,12 @@ if [ -f "$STATE" ] && [ -f "$TRACKING" ]; then
   NOW=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
 
   # Update tracking.json with current values
-  if command -v python3 &>/dev/null; then
-    python3 -c "
+  if ! command -v python3 &>/dev/null; then
+    echo "WARNING: python3 not found — tracking.json not updated" >&2
+    exit 0
+  fi
+
+  if ! python3 -c "
 import json
 with open('$TRACKING', 'r') as f:
     t = json.load(f)
@@ -23,7 +27,9 @@ t['last_commit'] = '${LAST_COMMIT}'
 t['last_updated'] = '${NOW}'
 with open('$TRACKING', 'w') as f:
     json.dump(t, f, indent=2)
-" 2>/dev/null
-    git add "$TRACKING" 2>/dev/null
+" 2>/tmp/qualia-push-err.txt; then
+    echo "WARNING: Failed to update tracking.json — $(cat /tmp/qualia-push-err.txt)" >&2
+    exit 0
   fi
+  git add "$TRACKING" 2>/dev/null
 fi

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "qualia-framework-v2",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "description": "Claude Code workflow framework by Qualia Solutions. Plan, build, verify, ship.",
   "bin": {
-    "qualia-framework-v2": "./bin/install.js"
+    "qualia-framework-v2": "./bin/cli.js"
   },
   "keywords": [
     "claude-code",
@@ -22,6 +22,9 @@
     "url": "https://github.com/qualia-solutions/qualia-framework-v2"
   },
   "homepage": "https://github.com/qualia-solutions/qualia-framework-v2#readme",
+  "scripts": {
+    "test": "bash tests/hooks.test.sh"
+  },
   "files": [
     "bin/",
     "agents/",
@@ -29,10 +32,10 @@
     "rules/",
     "skills/",
     "templates/",
+    "tests/",
     "CLAUDE.md",
     "guide.md",
-    "statusline.sh",
-    "install.sh"
+    "statusline.sh"
   ],
   "engines": {
     "node": ">=18"

package/skills/qualia/SKILL.md

@@ -22,7 +22,13 @@ echo "---VERIFICATIONS---"
 ls .planning/phase-*-verification.md 2>/dev/null || echo "NO_VERIFICATIONS"
 ```
 
-### 2. Route
+### Task Routing (size-based)
+
+- Single file change, config tweak, typo fix, bug with known cause → `/qualia-quick`
+- One feature, 1-5 files, clear scope, under 2 hours → `/qualia-task`
+- Multi-feature, 5+ files, needs architecture decisions, or part of a roadmap phase → `/qualia-plan`
+
+### 2. Route (state-based)
 
 | Condition | Command |
 |-----------|---------|

package/skills/qualia-build/SKILL.md

@@ -49,7 +49,7 @@ YOUR TASK:
 {paste the single task block from the plan — title, files, action, context refs, done-when}
 
 Execute this task. Read all @file references before writing. Commit when done.
-", subagent_type="general-purpose", description="Task {N}: {title}")
+", subagent_type="qualia-builder", description="Task {N}: {title}")
 ```
 
 **After each task completes:**

package/skills/qualia-plan/SKILL.md

@@ -48,7 +48,7 @@ Phase {N} success criteria: {criteria from STATE.md}
 {If --gaps: Also read @.planning/phase-{N}-verification.md for failures to fix}
 
 Create the plan file at .planning/phase-{N}-plan.md
-", subagent_type="general-purpose", description="Plan phase {N}")
+", subagent_type="qualia-planner", description="Plan phase {N}")
 ```
 
 ### 3. Review Plan
@@ -82,3 +82,16 @@ Update tracking.json: status → "planned"
 ```
   → Run: /qualia-build {N}
 ```
+
+### Gap Closure Mode (`--gaps`)
+
+When invoked as `/qualia-plan {N} --gaps`, the planner is in gap-closure mode:
+
+1. Read `.planning/phase-{N}-verification.md` — extract ONLY the FAIL items
+2. For each FAIL item, create a targeted fix task:
+   - **Files:** The specific files that failed verification
+   - **Action:** The specific fix needed (not "fix auth" — "add session persistence check in `src/lib/auth.ts` signIn function")
+   - **Done when:** The exact verification criterion that previously failed, restated
+3. Do NOT re-plan passing items. Do NOT add new features. Gap plans are surgical.
+4. Write to `.planning/phase-{N}-gaps-plan.md` (separate from original plan)
+5. All gap tasks are Wave 1 (parallel) unless they share files

package/skills/qualia-quick/SKILL.md

@@ -5,7 +5,7 @@ description: "Fast path for small tasks — bug fixes, tweaks, hot fixes. Skips
 
 # /qualia-quick — Quick Task
 
-For tasks under 30 minutes that don't need full phase planning. Bug fixes, small features, tweaks.
+For tasks under 1 hour that don't need full phase planning. Single file changes, bug fixes, config tweaks, typo fixes.
 
 ## Process
 

package/skills/qualia-task/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: qualia-task
+description: "Build a single task — more structured than /qualia-quick, lighter than /qualia-build. Spawns a fresh builder agent for one focused task."
+---
+
+# /qualia-task — Single Task Builder
+
+Build one thing properly. Fresh builder context, atomic commit, but no phase plan needed.
+
+## Usage
+`/qualia-task` — describe what to build interactively
+`/qualia-task {description}` — build it directly
+
+## When to Use
+- One feature, 1-5 files, clear scope, 1-3 hours of work
+- Adding a single feature, component, API route, or integration
+- Refactoring one module
+- Building something specific someone asked for
+
+## Process
+
+### 1. Clarify
+
+If no description provided, ask: **"What do you want to build?"**
+
+Then use AskUserQuestion:
+
+```
+question: "How complex is this task?"
+header: "Scope"
+options:
+  - label: "Small (1-2hrs)"
+    description: "Single file or component, straightforward implementation"
+  - label: "Medium (2-3hrs)"
+    description: "Multiple files, some integration work, needs testing"
+  - label: "Large (3hrs+)"
+    description: "Significant feature, multiple components — use /qualia-plan instead"
+```
+
+If "Large" — suggest `/qualia-plan` instead. Ask if they want to proceed anyway.
+
+### 2. Task Spec
+
+Write a quick task spec (don't save to file, just confirm with user):
+
+```
+◆ QUALIA ► TASK
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  What:    {what to build}
+  Files:   {files to create/modify}
+  Done:    {what "done" looks like}
+```
+
+Ask: **"Good to build?"**
+
+### 3. Build
+
+Spawn a builder agent with the task:
+
+```
+Agent(subagent_type: "qualia-builder")
+
+Task: {task description}
+Files: {files to create/modify}
+Done when: {completion criteria}
+
+Context: Read PROJECT.md if it exists. Follow all rules (security, frontend, deployment).
+```
+
+The builder runs in fresh context — reads before writing, follows rules, commits atomically.
+
+### 4. Verify
+
+After the builder finishes:
+- Run `npx tsc --noEmit` if TypeScript
+- Quick smoke test if applicable
+- Review what was built
+
+### 5. Report
+
+```
+◆ QUALIA ► TASK COMPLETE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  Task      {description}
+  Files     {files changed}
+  Commit    {commit hash}
+  Status    ✓ Done
+```
+
+Update `.planning/tracking.json` notes field if it exists.

package/skills/qualia-verify/SKILL.md

@@ -41,7 +41,7 @@ Phase plan with success criteria:
 {@.planning/phase-{N}-verification.md}
 
 Verify this phase. Write report to .planning/phase-{N}-verification.md
-", subagent_type="general-purpose", description="Verify phase {N}")
+", subagent_type="qualia-verifier", description="Verify phase {N}")
 ```
 
 ### 3. Present Results

package/tests/hooks.test.sh

@@ -0,0 +1,144 @@
+#!/bin/bash
+# Qualia Framework v2 — Hook Tests
+# Run: bash tests/hooks.test.sh
+
+PASS=0
+FAIL=0
+HOOKS_DIR="$(dirname "$0")/../hooks"
+
+assert_exit() {
+  local name="$1" expected="$2" actual="$3"
+  if [ "$expected" = "$actual" ]; then
+    echo "  ✓ $name"
+    PASS=$((PASS + 1))
+  else
+    echo "  ✗ $name (expected exit $expected, got $actual)"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+echo "=== Hook Tests ==="
+echo ""
+
+# --- block-env-edit.sh ---
+echo "block-env-edit:"
+
+echo '{"tool_input":{"file_path":".env.local"}}' | bash "$HOOKS_DIR/block-env-edit.sh" > /dev/null 2>&1
+assert_exit "blocks .env.local" 2 $?
+
+echo '{"tool_input":{"file_path":".env.production"}}' | bash "$HOOKS_DIR/block-env-edit.sh" > /dev/null 2>&1
+assert_exit "blocks .env.production" 2 $?
+
+echo '{"tool_input":{"file_path":".env"}}' | bash "$HOOKS_DIR/block-env-edit.sh" > /dev/null 2>&1
+assert_exit "blocks .env" 2 $?
+
+echo '{"tool_input":{"file_path":"src/app.tsx"}}' | bash "$HOOKS_DIR/block-env-edit.sh" > /dev/null 2>&1
+assert_exit "allows src/app.tsx" 0 $?
+
+echo '{"tool_input":{"file_path":"components/Footer.tsx"}}' | bash "$HOOKS_DIR/block-env-edit.sh" > /dev/null 2>&1
+assert_exit "allows components/Footer.tsx" 0 $?
+
+# --- migration-guard.sh ---
+echo ""
+echo "migration-guard:"
+
+echo '{"tool_input":{"file_path":"migrations/001.sql","content":"DROP TABLE users;"}}' | bash "$HOOKS_DIR/migration-guard.sh" > /dev/null 2>&1
+assert_exit "blocks DROP TABLE without IF EXISTS" 2 $?
+
+echo '{"tool_input":{"file_path":"migrations/001.sql","content":"DROP TABLE IF EXISTS old_users;"}}' | bash "$HOOKS_DIR/migration-guard.sh" > /dev/null 2>&1
+assert_exit "allows DROP TABLE IF EXISTS" 0 $?
+
+echo '{"tool_input":{"file_path":"migrations/002.sql","content":"DELETE FROM users;"}}' | bash "$HOOKS_DIR/migration-guard.sh" > /dev/null 2>&1
+assert_exit "blocks DELETE without WHERE" 2 $?
+
+echo '{"tool_input":{"file_path":"migrations/003.sql","content":"TRUNCATE TABLE sessions;"}}' | bash "$HOOKS_DIR/migration-guard.sh" > /dev/null 2>&1
+assert_exit "blocks TRUNCATE" 2 $?
+
+echo '{"tool_input":{"file_path":"migrations/004.sql","content":"CREATE TABLE users (id uuid);"}}' | bash "$HOOKS_DIR/migration-guard.sh" > /dev/null 2>&1
+assert_exit "blocks CREATE TABLE without RLS" 2 $?
+
+echo '{"tool_input":{"file_path":"migrations/005.sql","content":"ALTER TABLE users ADD COLUMN email text;"}}' | bash "$HOOKS_DIR/migration-guard.sh" > /dev/null 2>&1
+assert_exit "allows safe ALTER TABLE" 0 $?
+
+echo '{"tool_input":{"file_path":"src/app.tsx","content":"DROP TABLE users;"}}' | bash "$HOOKS_DIR/migration-guard.sh" > /dev/null 2>&1
+assert_exit "skips non-migration files" 0 $?
+
+# --- branch-guard.sh ---
+echo ""
+echo "branch-guard:"
+
+if [ -f "$HOOKS_DIR/branch-guard.sh" ]; then
+  echo "  ✓ branch-guard.sh exists"
+  PASS=$((PASS + 1))
+else
+  echo "  ✗ branch-guard.sh missing"
+  FAIL=$((FAIL + 1))
+fi
+
+if grep -q 'ROLE' "$HOOKS_DIR/branch-guard.sh"; then
+  echo "  ✓ checks ROLE variable"
+  PASS=$((PASS + 1))
+else
+  echo "  ✗ missing ROLE check"
+  FAIL=$((FAIL + 1))
+fi
+
+if grep -q 'z "$ROLE"' "$HOOKS_DIR/branch-guard.sh"; then
+  echo "  ✓ defaults to deny on missing ROLE"
+  PASS=$((PASS + 1))
+else
+  echo "  ✗ missing empty-ROLE deny"
+  FAIL=$((FAIL + 1))
+fi
+
+# --- pre-push.sh ---
+echo ""
+echo "pre-push:"
+
+if grep -q 'command -v python3' "$HOOKS_DIR/pre-push.sh"; then
+  echo "  ✓ checks for python3 availability"
+  PASS=$((PASS + 1))
+else
+  echo "  ✗ missing python3 check"
+  FAIL=$((FAIL + 1))
+fi
+
+if grep -q 'qualia-push-err' "$HOOKS_DIR/pre-push.sh"; then
+  echo "  ✓ captures python3 errors"
+  PASS=$((PASS + 1))
+else
+  echo "  ✗ missing python3 error capture"
+  FAIL=$((FAIL + 1))
+fi
+
+# --- pre-deploy-gate.sh ---
+echo ""
+echo "pre-deploy-gate:"
+
+if [ -f "$HOOKS_DIR/pre-deploy-gate.sh" ]; then
+  echo "  ✓ pre-deploy-gate.sh exists"
+  PASS=$((PASS + 1))
+else
+  echo "  ✗ pre-deploy-gate.sh missing"
+  FAIL=$((FAIL + 1))
+fi
+
+if grep -q 'tsc --noEmit' "$HOOKS_DIR/pre-deploy-gate.sh"; then
+  echo "  ✓ runs TypeScript check"
+  PASS=$((PASS + 1))
+else
+  echo "  ✗ missing TypeScript check"
+  FAIL=$((FAIL + 1))
+fi
+
+if grep -q 'service_role' "$HOOKS_DIR/pre-deploy-gate.sh"; then
+  echo "  ✓ checks for service_role leaks"
+  PASS=$((PASS + 1))
+else
+  echo "  ✗ missing service_role check"
+  FAIL=$((FAIL + 1))
+fi
+
+echo ""
+echo "=== Results: $PASS passed, $FAIL failed ==="
+[ "$FAIL" -eq 0 ] && exit 0 || exit 1

package/install.sh

@@ -1,223 +0,0 @@
-#!/bin/bash
-# Qualia Framework v2 — Installer
-# Installs skills, agents, rules, hooks, templates, status line, and configures settings.json
-
-set -e
-
-FRAMEWORK_DIR="$(cd "$(dirname "$0")" && pwd)"
-CLAUDE_DIR="$HOME/.claude"
-
-echo "◆ Qualia Framework v2"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  Installing to $CLAUDE_DIR"
-echo ""
-
-# Skills
-echo "  Installing skills..."
-for skill_dir in "$FRAMEWORK_DIR"/skills/*/; do
-  skill_name=$(basename "$skill_dir")
-  mkdir -p "$CLAUDE_DIR/skills/$skill_name"
-  cp "$skill_dir/SKILL.md" "$CLAUDE_DIR/skills/$skill_name/SKILL.md"
-  echo "    ✓ $skill_name"
-done
-
-# Agents
-echo "  Installing agents..."
-mkdir -p "$CLAUDE_DIR/agents"
-for agent in "$FRAMEWORK_DIR"/agents/*.md; do
-  cp "$agent" "$CLAUDE_DIR/agents/"
-  echo "    ✓ $(basename "$agent")"
-done
-
-# Rules
-echo "  Installing rules..."
-mkdir -p "$CLAUDE_DIR/rules"
-for rule in "$FRAMEWORK_DIR"/rules/*.md; do
-  cp "$rule" "$CLAUDE_DIR/rules/"
-  echo "    ✓ $(basename "$rule")"
-done
-
-# Hook scripts
-echo "  Installing hook scripts..."
-mkdir -p "$CLAUDE_DIR/hooks"
-for hook in "$FRAMEWORK_DIR"/hooks/*.sh; do
-  cp "$hook" "$CLAUDE_DIR/hooks/"
-  chmod +x "$CLAUDE_DIR/hooks/$(basename "$hook")"
-  echo "    ✓ $(basename "$hook")"
-done
-
-# Status line
-echo "  Installing status line..."
-cp "$FRAMEWORK_DIR/statusline.sh" "$CLAUDE_DIR/statusline.sh"
-chmod +x "$CLAUDE_DIR/statusline.sh"
-echo "    ✓ statusline.sh"
-
-# Templates
-echo "  Installing templates..."
-mkdir -p "$CLAUDE_DIR/qualia-templates"
-for tmpl in "$FRAMEWORK_DIR"/templates/*; do
-  cp "$tmpl" "$CLAUDE_DIR/qualia-templates/"
-  echo "    ✓ $(basename "$tmpl")"
-done
-
-# CLAUDE.md (user-level — applies to all projects)
-echo "  Installing CLAUDE.md..."
-cp "$FRAMEWORK_DIR/CLAUDE.md" "$CLAUDE_DIR/CLAUDE.md"
-echo "    ✓ CLAUDE.md"
-
-# Guide
-cp "$FRAMEWORK_DIR/guide.md" "$CLAUDE_DIR/qualia-guide.md"
-echo "    ✓ guide.md"
-
-# Configure settings.json with hooks, status line, and env
-echo ""
-echo "  Configuring settings.json..."
-
-python3 << 'PYEOF'
-import json, os
-
-settings_path = os.path.expanduser("~/.claude/settings.json")
-
-# Load existing settings or start fresh
-if os.path.exists(settings_path):
-    with open(settings_path) as f:
-        settings = json.load(f)
-else:
-    settings = {}
-
-# Env vars
-settings.setdefault("env", {})
-settings["env"].update({
-    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
-    "CLAUDE_CODE_DISABLE_AUTO_MEMORY": "0",
-    "MAX_MCP_OUTPUT_TOKENS": "25000",
-    "CLAUDE_CODE_NO_FLICKER": "1"
-})
-
-# Status line — teal branded, 2-line
-settings["statusLine"] = {
-    "type": "command",
-    "command": "~/.claude/statusline.sh"
-}
-
-# Spinner verbs — Qualia branded
-settings["spinnerVerbs"] = {
-    "mode": "replace",
-    "verbs": [
-        "Qualia-fying", "Solution-ing", "Teal-crafting", "Vibe-forging",
-        "Shipping", "Wiring", "Polishing", "Verifying",
-        "Orchestrating", "Architecting", "Deploying", "Hardening"
-    ]
-}
-
-# Spinner tips — Qualia tips
-settings["spinnerTipsOverride"] = {
-    "excludeDefault": True,
-    "tips": [
-        "◆ Lost? Type /qualia for the next step",
-        "◆ Small fix? Use /qualia-quick to skip planning",
-        "◆ End of day? /qualia-report before you clock out",
-        "◆ Context isolation: every task gets a fresh AI brain",
-        "◆ The verifier doesn't trust claims — it greps the code",
-        "◆ Plans are prompts — the plan IS what the builder reads",
-        "◆ Feature branches only — never push to main",
-        "◆ Read before write — no exceptions",
-        "◆ MVP first — build what's asked, nothing extra",
-        "◆ tracking.json syncs to ERP on every push"
-    ]
-}
-
-# Hooks
-hooks_dir = os.path.expanduser("~/.claude/hooks")
-settings["hooks"] = {
-    "PreToolUse": [
-        {
-            "matcher": "Bash",
-            "hooks": [{
-                "type": "command",
-                "if": "Bash(git push*)",
-                "command": f"{hooks_dir}/branch-guard.sh",
-                "timeout": 10,
-                "statusMessage": "◆ Checking branch permissions..."
-            }]
-        },
-        {
-            "matcher": "Edit|Write",
-            "hooks": [{
-                "type": "command",
-                "if": "Edit(*.env*)",
-                "command": f"{hooks_dir}/block-env-edit.sh",
-                "timeout": 5,
-                "statusMessage": "◆ Checking file permissions..."
-            }]
-        }
-    ],
-    "PostToolUse": [
-        {
-            "matcher": "Bash",
-            "hooks": [{
-                "type": "command",
-                "if": "Bash(vercel --prod*)",
-                "command": f"{hooks_dir}/pre-deploy-gate.sh",
-                "timeout": 120,
-                "statusMessage": "◆ Running quality gates..."
-            }]
-        }
-    ],
-    "PreCompact": [
-        {
-            "matcher": "compact",
-            "hooks": [{
-                "type": "command",
-                "command": f"{hooks_dir}/pre-compact.sh",
-                "timeout": 15,
-                "statusMessage": "◆ Saving state..."
-            }]
-        }
-    ],
-    "SubagentStart": [
-        {
-            "matcher": ".*",
-            "hooks": [{
-                "type": "command",
-                "command": "echo '{\"additionalContext\": \"◆ Qualia agent spawned\"}'"
-            }]
-        }
-    ]
-}
-
-# Permissions
-settings.setdefault("permissions", {})
-settings["permissions"].setdefault("allow", [])
-settings["permissions"].setdefault("deny", [
-    "Read(./.env)",
-    "Read(./.env.*)",
-    "Read(./secrets/**)"
-])
-
-# Effort level
-settings["effortLevel"] = "high"
-
-with open(settings_path, "w") as f:
-    json.dump(settings, f, indent=2)
-
-print("    ✓ Hooks registered (branch-guard, env-block, deploy-gate, pre-compact, subagent-label)")
-print("    ✓ Status line configured (2-line teal branded)")
-print("    ✓ Spinner verbs: Qualia branded")
-print("    ✓ Spinner tips: Qualia tips")
-print("    ✓ Environment variables set")
-PYEOF
-
-echo ""
-echo "◆ Installed ✓"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "  Skills:       10"
-echo "  Agents:       3 (planner, builder, verifier)"
-echo "  Hooks:        4 (branch-guard, env-block, deploy-gate, pre-compact)"
-echo "  Rules:        3 (security, frontend, deployment)"
-echo "  Templates:    4"
-echo "  Status line:  ✓"
-echo "  CLAUDE.md:    ✓ (user-level)"
-echo ""
-echo "  Restart Claude Code, then type /qualia in any project."
-echo ""