warp-os 1.1.0

package/bin/hooks/_warp_json.sh

@@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+# _warp_json.sh — Shared JSON field extraction for Warp hooks (no jq)
+# Source this file in every hook script. Provides:
+#   _warp_read_input   — read JSON from stdin into memory
+#   _warp_field "key"  — extract a string field value
+#   _warp_field_raw "key" — extract a non-string field value (bool/number/null)
+#   _warp_escape_json "string" — escape a string for embedding in JSON
+#
+# Usage:
+#   source "$(dirname "$0")/_warp_json.sh"
+#   _warp_read_input
+#   CWD=$(_warp_field "cwd")
+#   SESSION_ID=$(_warp_field "session_id")
+
+_WARP_HOOK_INPUT=""
+
+# Read all of stdin into _WARP_HOOK_INPUT. Call once per hook.
+_warp_read_input() {
+  _WARP_HOOK_INPUT=$(cat)
+}
+
+# Extract a JSON string field: "key": "value" → value
+# Handles optional whitespace around the colon.
+# Returns empty string if field not found.
+_warp_field() {
+  local key="$1"
+  if [ -z "$_WARP_HOOK_INPUT" ]; then
+    echo ""
+    return
+  fi
+  echo "$_WARP_HOOK_INPUT" | \
+    grep -o "\"$key\"[[:space:]]*:[[:space:]]*\"[^\"]*\"" | \
+    head -1 | \
+    sed "s/\"$key\"[[:space:]]*:[[:space:]]*\"//;s/\"$//"
+}
+
+# Extract a non-string JSON field: "key": true → true, "key": 42 → 42
+# For booleans, numbers, null. Returns empty string if not found.
+_warp_field_raw() {
+  local key="$1"
+  if [ -z "$_WARP_HOOK_INPUT" ]; then
+    echo ""
+    return
+  fi
+  echo "$_WARP_HOOK_INPUT" | \
+    grep -o "\"$key\"[[:space:]]*:[[:space:]]*[^,}\"][^,}]*" | \
+    head -1 | \
+    sed "s/\"$key\"[[:space:]]*:[[:space:]]*//" | \
+    tr -d '[:space:]'
+}
+
+# Escape a string for safe embedding inside a JSON string value.
+# Order matters: backslash must be escaped first.
+_warp_escape_json() {
+  local s="$1"
+  # Backslash first (doubles all existing backslashes)
+  s="${s//\\/\\\\}"
+  # Double quotes
+  s="${s//\"/\\\"}"
+  # Newlines
+  s="${s//$'\n'/\\n}"
+  # Tabs
+  s="${s//$'\t'/\\t}"
+  # Carriage returns
+  s="${s//$'\r'/}"
+  echo "$s"
+}

package/bin/hooks/consistency-check.sh

@@ -0,0 +1,92 @@
+#!/usr/bin/env bash
+# consistency-check.sh — Validate CLAUDE.md and TODOS.md on Stop
+# Fires on Stop event (alongside claude-mem's summarize hook).
+# Reads git diff for session changes, checks for staleness.
+# Outputs warnings via stdout. Never blocks — exits 0 on any error.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/_warp_json.sh"
+_warp_read_input
+
+CWD=$(_warp_field "cwd")
+if [ -z "$CWD" ]; then
+  exit 0
+fi
+cd "$CWD" 2>/dev/null || exit 0
+
+# Need git for diff-based checks
+if ! command -v git >/dev/null 2>&1; then
+  exit 0
+fi
+
+# Get files changed this session (unstaged + staged)
+CHANGED_FILES=$(git diff --name-only HEAD 2>/dev/null || true)
+STAGED_FILES=$(git diff --cached --name-only 2>/dev/null || true)
+ALL_CHANGED=$(echo -e "${CHANGED_FILES}\n${STAGED_FILES}" | sort -u | grep -v '^$' || true)
+
+if [ -z "$ALL_CHANGED" ]; then
+  exit 0
+fi
+
+WARNINGS=""
+
+# Check A: New files not referenced in nearest CLAUDE.md
+while IFS= read -r filepath; do
+  [ -z "$filepath" ] && continue
+  # Only check files that are new (not in HEAD)
+  if ! git show HEAD:"$filepath" >/dev/null 2>&1; then
+    # Find nearest CLAUDE.md
+    dir=$(dirname "$filepath")
+    claude_md=""
+    while [ "$dir" != "." ] && [ "$dir" != "/" ]; do
+      if [ -f "$dir/CLAUDE.md" ]; then
+        claude_md="$dir/CLAUDE.md"
+        break
+      fi
+      dir=$(dirname "$dir")
+    done
+    # Fall back to root CLAUDE.md
+    if [ -z "$claude_md" ] && [ -f "CLAUDE.md" ]; then
+      claude_md="CLAUDE.md"
+    fi
+    if [ -n "$claude_md" ]; then
+      basename_file=$(basename "$filepath")
+      if ! grep -q "$basename_file" "$claude_md" 2>/dev/null; then
+        WARNINGS="${WARNINGS}MISSING: ${filepath} not referenced in ${claude_md}\n"
+      fi
+    fi
+  fi
+done <<< "$ALL_CHANGED"
+
+# Check B: TODOS.md — flag items that may now be done
+if [ -f "TODOS.md" ]; then
+  # Get unchecked P1 items
+  P1_OPEN=$(sed -n '/^## P1/,/^## P[2-9]/p' TODOS.md 2>/dev/null | grep '^\- \[ \]' || true)
+  if [ -n "$P1_OPEN" ]; then
+    # Check if any changed files relate to open TODO items
+    while IFS= read -r todo_line; do
+      [ -z "$todo_line" ] && continue
+      # Extract keywords from the TODO (skip common words)
+      keywords=$(echo "$todo_line" | sed 's/^- \[ \] //' | tr '[:upper:]' '[:lower:]' | \
+        grep -oE '\b[a-z]{4,}\b' | grep -vE '^(that|this|with|from|have|been|they|will|just|also|into|when|after)$' | head -5)
+      for kw in $keywords; do
+        # Check if any changed file paths or commit messages relate
+        if echo "$ALL_CHANGED" | grep -qi "$kw" 2>/dev/null; then
+          clean_todo=$(echo "$todo_line" | sed 's/^- \[ \] //')
+          WARNINGS="${WARNINGS}TODO-CHECK: '${clean_todo}' may be addressed — changed files match '${kw}'\n"
+          break
+        fi
+      done
+    done <<< "$P1_OPEN"
+  fi
+fi
+
+# Output warnings if any
+if [ -n "$WARNINGS" ]; then
+  echo "[warp-consistency] Session changes detected:"
+  echo -e "$WARNINGS" | grep -v '^$' | head -10
+  echo "(Run /warp-release-update before pushing to verify docs are current)"
+fi
+
+exit 0

package/bin/hooks/identity-briefing.sh

@@ -0,0 +1,89 @@
+#!/usr/bin/env bash
+# identity-briefing.sh — Inject pipeline state + priorities into Claude's context
+# Fires on SessionStart (all sources). Bounded to ~100-200 tokens.
+# Outputs partial briefing if some files are missing (graceful degradation).
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/_warp_json.sh"
+_warp_read_input
+
+CWD=$(_warp_field "cwd")
+if [ -z "$CWD" ]; then
+  exit 0
+fi
+cd "$CWD" 2>/dev/null || exit 0
+
+# Build welcome banner (48-char width per design spec)
+RULE="━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+# Branch and git state
+BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
+UNCOMMITTED=$(git status --porcelain 2>/dev/null | wc -l | tr -d '[:space:]')
+if [ "$UNCOMMITTED" = "0" ]; then
+  GIT_STATE="clean"
+else
+  GIT_STATE="${UNCOMMITTED} files"
+fi
+
+# Pipeline state
+PIPELINE=""
+for artifact in brainstorm onboarding scope architecture design testspec security README; do
+  f=".warp/pipeline/${artifact}.md"
+  if [ -f "$f" ]; then
+    PIPELINE="${PIPELINE} ✓${artifact}"
+  else
+    PIPELINE="${PIPELINE} ○${artifact}"
+  fi
+done
+
+# Mode detection
+if [ -f ".warp/pipeline/README.md" ]; then
+  WARP_MODE="pipeline"
+elif [ -d ".warp/pipeline" ] && ls .warp/pipeline/*.md >/dev/null 2>&1; then
+  WARP_MODE="pipeline-partial"
+else
+  WARP_MODE="no-pipeline"
+fi
+
+# Build the banner
+BRIEFING="${RULE}"$'\n'"WARP │ orchestrator"$'\n'"${RULE}"
+BRIEFING="${BRIEFING}"$'\n'"  Branch:   ${BRANCH} | ${GIT_STATE}"
+if [ -n "$PIPELINE" ]; then
+  BRIEFING="${BRIEFING}"$'\n'"  Pipeline:${PIPELINE}"
+fi
+
+# Phase/cycle progress from roadmap
+if [ -f ".warp/pipeline/README.md" ]; then
+  CHECKED=$(grep -c '^\- \[x\]' .warp/pipeline/README.md 2>/dev/null || echo "0")
+  TOTAL=$(grep -c '^\- \[' .warp/pipeline/README.md 2>/dev/null || echo "0")
+  NEXT=$(grep -m1 '^\- \[ \]' .warp/pipeline/README.md 2>/dev/null | sed 's/^- \[ \] //' | head -c 60 || true)
+  if [ "$TOTAL" != "0" ]; then
+    BRIEFING="${BRIEFING}"$'\n'"Cycles: ${CHECKED}/${TOTAL} complete"
+    if [ -n "$NEXT" ]; then
+      BRIEFING="${BRIEFING} (next: ${NEXT})"
+    fi
+  fi
+fi
+
+# P1 priorities from TODOS.md
+if [ -f "TODOS.md" ]; then
+  P1_ITEMS=$(sed -n '/^## P1/,/^## P[2-9]/p' TODOS.md 2>/dev/null | grep '^\- \[ \]' | head -3 | sed 's/^- \[ \] //' | tr '\n' ' | ' || true)
+  if [ -n "$P1_ITEMS" ]; then
+    BRIEFING="${BRIEFING}"$'\n'"P1: ${P1_ITEMS}"
+  fi
+fi
+
+# Close the banner
+BRIEFING="${BRIEFING}"$'\n'"${RULE}"
+BRIEFING="${BRIEFING}"$'\n'"[Mode: ${WARP_MODE}]"
+
+# Output via JSON additionalContext (primary) with stdout fallback
+ESCAPED=$(_warp_escape_json "$BRIEFING")
+if [ -n "$ESCAPED" ]; then
+  echo "{\"hookSpecificOutput\":{\"hookEventName\":\"SessionStart\",\"additionalContext\":\"$ESCAPED\"}}"
+else
+  echo "$BRIEFING"
+fi
+
+exit 0

package/bin/hooks/identity-foundation.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+# identity-foundation.sh — First-run orientation for new users
+# Fires on SessionStart (all sources including compact).
+# Tier 1 is in the orchestrator agent definition — no tier injection needed.
+#
+# Primary: JSON additionalContext (CC-documented mechanism)
+# Fallback: raw stdout (tested, works, but undocumented)
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/_warp_json.sh"
+_warp_read_input
+
+# First-run orientation: welcome new users (one-time)
+CWD=$(_warp_field "cwd")
+INTRO_SEEN="$HOME/.warp/.intro-seen"
+CONTENT=""
+
+if [ ! -f "$INTRO_SEEN" ]; then
+  CONTENT="Welcome to Warp — a development operating system for Claude Code. 22 deep skills that think through every step of building a product, from first idea to shipped release. Getting started: /warp-plan-brainstorm (new project) or /warp-plan-onboarding (existing project). Settings: ~/.warp/settings.json."
+  mkdir -p "$HOME/.warp" 2>/dev/null || true
+  touch "$INTRO_SEEN" 2>/dev/null || true
+fi
+
+if [ -z "$CONTENT" ]; then
+  exit 0
+fi
+
+# Primary: JSON additionalContext (CC-documented for SessionStart)
+ESCAPED=$(_warp_escape_json "$CONTENT")
+if [ -n "$ESCAPED" ]; then
+  echo "{\"hookSpecificOutput\":{\"hookEventName\":\"SessionStart\",\"additionalContext\":\"$ESCAPED\"}}"
+else
+  echo "$CONTENT"
+fi
+
+exit 0

package/bin/install.js

@@ -0,0 +1,343 @@
+#!/usr/bin/env node
+// install.js — Warp installer (replaces install.sh)
+// No symlinks. Just file copies. Works on Windows, Mac, Linux.
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync } = require('child_process');
+
+// ── Paths ────────────────────────────────────────────────────────────────────
+
+const HOME = os.homedir();
+const REPO_ROOT = path.resolve(__dirname, '..');
+const SKILLS_DIR = path.join(HOME, '.claude', 'skills');
+const AGENTS_DIR = path.join(HOME, '.claude', 'agents');
+const WARP_DIR = path.join(HOME, '.warp');
+const HOOKS_DIR = path.join(WARP_DIR, 'hooks');
+const SHARED_DIR = path.join(WARP_DIR, 'shared');
+
+// ── Colors ───────────────────────────────────────────────────────────────────
+
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const RED = '\x1b[31m';
+const CYAN = '\x1b[36m';
+const NC = '\x1b[0m';
+
+function ok(msg) { console.log(`  ${GREEN}OK${NC}    ${msg}`); }
+function warn(msg) { console.log(`  ${YELLOW}WARN${NC}  ${msg}`); }
+function fail(msg) { console.log(`  ${RED}FAIL${NC}  ${msg}`); }
+function info(msg) { console.log(`  ${CYAN}INFO${NC}  ${msg}`); }
+
+// ── Helpers ──────────────────────────────────────────────────────────────────
+
+function mkdirSafe(dir) {
+  fs.mkdirSync(dir, { recursive: true });
+}
+
+function copyFile(src, dest) {
+  fs.copyFileSync(src, dest);
+}
+
+function copyDir(src, dest) {
+  mkdirSafe(dest);
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      copyFile(srcPath, destPath);
+    }
+  }
+}
+
+function removeSafe(target) {
+  try {
+    const stat = fs.lstatSync(target);
+    if (stat.isDirectory()) {
+      fs.rmSync(target, { recursive: true, force: true });
+    } else {
+      fs.unlinkSync(target);
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// ── Version ──────────────────────────────────────────────────────────────────
+
+const VERSION = fs.readFileSync(path.join(REPO_ROOT, 'VERSION'), 'utf8').trim();
+
+console.log('');
+console.log('Warp Installer');
+console.log('\u2501'.repeat(48));
+console.log(`  Version:  ${CYAN}v${VERSION}${NC}`);
+console.log(`  Source:   ${REPO_ROOT}`);
+console.log(`  Target:   ${SKILLS_DIR}`);
+console.log('');
+
+// ── Check if this is doctor mode ─────────────────────────────────────────────
+
+const isDoctor = process.argv[2] === 'doctor';
+
+// ── Step 1: Install Skills ───────────────────────────────────────────────────
+
+console.log('Installing skills...');
+mkdirSafe(SKILLS_DIR);
+
+const distDir = path.join(REPO_ROOT, 'dist');
+let skillsInstalled = 0;
+let skillsFailed = 0;
+
+if (!fs.existsSync(distDir)) {
+  fail('dist/ directory not found. Run build.sh first.');
+  process.exit(1);
+}
+
+// Clean up old-style single-directory install
+const oldInstall = path.join(SKILLS_DIR, 'warp');
+if (fs.existsSync(oldInstall)) {
+  removeSafe(oldInstall);
+  warn('Removed old-style install at ~/.claude/skills/warp');
+}
+
+for (const entry of fs.readdirSync(distDir, { withFileTypes: true })) {
+  if (!entry.isDirectory() || !entry.name.startsWith('warp-')) continue;
+
+  const srcSkillDir = path.join(distDir, entry.name);
+  const srcSkillFile = path.join(srcSkillDir, 'SKILL.md');
+
+  if (!fs.existsSync(srcSkillFile)) {
+    warn(`${entry.name} — no SKILL.md, skipping`);
+    continue;
+  }
+
+  const targetDir = path.join(SKILLS_DIR, entry.name);
+
+  try {
+    // Remove old version (symlink, copy, or directory)
+    if (fs.existsSync(targetDir) || fs.lstatSync(targetDir).isSymbolicLink()) {
+      removeSafe(targetDir);
+    }
+  } catch {
+    // target doesn't exist, that's fine
+  }
+
+  try {
+    copyDir(srcSkillDir, targetDir);
+    ok(entry.name);
+    skillsInstalled++;
+  } catch (err) {
+    fail(`${entry.name} — ${err.message}`);
+    skillsFailed++;
+  }
+}
+
+// Clean up stale skills (removed in newer versions)
+let staleSkills = 0;
+for (const entry of fs.readdirSync(SKILLS_DIR, { withFileTypes: true })) {
+  if (!entry.isDirectory() || !entry.name.startsWith('warp-')) continue;
+  const distCounterpart = path.join(distDir, entry.name, 'SKILL.md');
+  if (!fs.existsSync(distCounterpart)) {
+    removeSafe(path.join(SKILLS_DIR, entry.name));
+    warn(`${entry.name} — removed (stale from previous version)`);
+    staleSkills++;
+  }
+}
+
+console.log('');
+console.log('\u2501'.repeat(48));
+console.log(`Skills:  ${GREEN}${skillsInstalled}${NC} installed  ${RED}${skillsFailed}${NC} failed  ${YELLOW}${staleSkills}${NC} stale removed`);
+
+// ── Step 2: Install Agents ───────────────────────────────────────────────────
+
+console.log('');
+console.log('Installing agents...');
+mkdirSafe(AGENTS_DIR);
+
+const agentsDir = path.join(REPO_ROOT, 'agents');
+let agentsInstalled = 0;
+let agentsFailed = 0;
+
+for (const file of fs.readdirSync(agentsDir)) {
+  if (!file.startsWith('warp-') || !file.endsWith('.md')) continue;
+
+  const srcFile = path.join(agentsDir, file);
+  const destFile = path.join(AGENTS_DIR, file);
+
+  try {
+    // Remove old version (symlink or file)
+    try { fs.lstatSync(destFile); removeSafe(destFile); } catch {}
+    copyFile(srcFile, destFile);
+    ok(file);
+    agentsInstalled++;
+  } catch (err) {
+    fail(`${file} — ${err.message}`);
+    agentsFailed++;
+  }
+}
+
+// Clean up stale agents
+let staleAgents = 0;
+for (const file of fs.readdirSync(AGENTS_DIR)) {
+  if (!file.startsWith('warp-') || !file.endsWith('.md')) continue;
+  if (!fs.existsSync(path.join(agentsDir, file))) {
+    removeSafe(path.join(AGENTS_DIR, file));
+    warn(`${file} — removed (stale)`);
+    staleAgents++;
+  }
+}
+
+console.log('');
+console.log('\u2501'.repeat(48));
+console.log(`Agents:  ${GREEN}${agentsInstalled}${NC} installed  ${RED}${agentsFailed}${NC} failed  ${YELLOW}${staleAgents}${NC} stale removed`);
+
+// ── Step 3: Install Hooks ────────────────────────────────────────────────────
+
+console.log('');
+console.log('Installing hooks...');
+mkdirSafe(HOOKS_DIR);
+
+const hooksSource = path.join(REPO_ROOT, 'bin', 'hooks');
+let hooksInstalled = 0;
+
+if (fs.existsSync(hooksSource)) {
+  // Clean up old hook names from previous versions
+  const staleHooks = [
+    'session-start.sh', 'session-end.sh', 'pre-compact.sh', 'post-compact.sh',
+    'subagent-inject.sh', 'subagent-quicksave.sh', 'orch-guard.sh', 'block-md.sh',
+    'orchestrator-foundation.sh', 'orchestrator-briefing.sh', 'qa-gate.sh', 'qa-boundary.sh',
+    'phase-boundary-detect.sh', 'test-failure-router.sh', 'lifecycle-session-start.sh',
+    'lifecycle-session-end.sh', 'lifecycle-pre-compact.sh', 'lifecycle-post-compact.sh',
+    'lifecycle-subagent-inject.sh', 'lifecycle-subagent-quicksave.sh',
+    'guard-orch.sh', 'guard-block-md.sh', 'automation-phase-boundary.sh',
+    'automation-test-router.sh', 'verify-api-docs.sh', 'verify-qa-boundary.sh', 'verify-qa-gate.sh'
+  ];
+  for (const old of staleHooks) {
+    removeSafe(path.join(HOOKS_DIR, old));
+  }
+
+  for (const file of fs.readdirSync(hooksSource)) {
+    if (!file.endsWith('.sh')) continue;
+    const src = path.join(hooksSource, file);
+    const dest = path.join(HOOKS_DIR, file);
+    try {
+      copyFile(src, dest);
+      // Make executable on Unix
+      if (process.platform !== 'win32') {
+        fs.chmodSync(dest, 0o755);
+      }
+      hooksInstalled++;
+    } catch (err) {
+      fail(`${file} — ${err.message}`);
+    }
+  }
+  ok(`${hooksInstalled} hook scripts → ~/.warp/hooks/`);
+}
+
+// ── Step 4: Install Foundation ───────────────────────────────────────────────
+
+console.log('');
+console.log('Installing foundation...');
+mkdirSafe(SHARED_DIR);
+
+const tier1Src = path.join(REPO_ROOT, 'shared', 'tier1-engineering-constitution.md');
+if (fs.existsSync(tier1Src)) {
+  copyFile(tier1Src, path.join(SHARED_DIR, 'tier1-engineering-constitution.md'));
+  ok('Tier 1 → ~/.warp/shared/');
+} else {
+  warn('tier1-engineering-constitution.md not found');
+}
+
+// Clean up old tier files
+for (const old of ['tier3-ux-patterns.md', 'tier3-ux-infrastructure.md']) {
+  removeSafe(path.join(SHARED_DIR, old));
+}
+
+// Project hooks config template
+const hooksConfigSrc = path.join(REPO_ROOT, 'shared', 'project-hooks.json');
+if (fs.existsSync(hooksConfigSrc)) {
+  copyFile(hooksConfigSrc, path.join(WARP_DIR, 'project-hooks.json'));
+  ok('project-hooks.json → ~/.warp/');
+}
+
+// ── Step 5: Install claude-mem ───────────────────────────────────────────────
+
+console.log('');
+console.log('Installing claude-mem...');
+
+try {
+  execSync('npx claude-mem install', {
+    stdio: 'pipe',
+    timeout: 300000
+  });
+  ok('claude-mem installed (persistent memory)');
+} catch (err) {
+  warn('claude-mem install failed — memory features unavailable');
+  info('Install manually: npx claude-mem install');
+}
+
+// ── Step 6: Version Tracking ─────────────────────────────────────────────────
+
+console.log('');
+console.log('Writing version...');
+
+fs.writeFileSync(path.join(WARP_DIR, 'version'), VERSION + '\n');
+ok(`v${VERSION} → ~/.warp/version`);
+
+// Write package source path (for upgrade detection)
+fs.writeFileSync(path.join(WARP_DIR, 'repo-path'), REPO_ROOT + '\n');
+ok(`Source path → ~/.warp/repo-path`);
+
+// ── Step 7: Clean up old global hooks ────────────────────────────────────────
+
+const globalSettings = path.join(HOME, '.claude', 'settings.json');
+if (fs.existsSync(globalSettings)) {
+  try {
+    const content = fs.readFileSync(globalSettings, 'utf8');
+    if (content.includes('.warp/hooks/')) {
+      const settings = JSON.parse(content);
+      if (settings.hooks) {
+        let cleaned = false;
+        for (const [event, matchers] of Object.entries(settings.hooks)) {
+          if (!Array.isArray(matchers)) continue;
+          settings.hooks[event] = matchers.map(m => {
+            if (!m.hooks || !Array.isArray(m.hooks)) return m;
+            const filtered = m.hooks.filter(h => {
+              const isWarp = (h.command && h.command.includes('.warp/hooks/')) ||
+                             (h.prompt && h.prompt.includes('session is ending'));
+              if (isWarp) cleaned = true;
+              return !isWarp;
+            });
+            return { ...m, hooks: filtered };
+          }).filter(m => m.hooks && m.hooks.length > 0);
+          if (settings.hooks[event].length === 0) delete settings.hooks[event];
+        }
+        if (Object.keys(settings.hooks).length === 0) delete settings.hooks;
+        if (cleaned) {
+          fs.writeFileSync(globalSettings, JSON.stringify(settings, null, 2));
+          ok('Cleaned old Warp hooks from global settings.json');
+        }
+      }
+    }
+  } catch {
+    // Ignore — not critical
+  }
+}
+
+// ── Done ─────────────────────────────────────────────────────────────────────
+
+console.log('');
+console.log('\u2501'.repeat(48));
+console.log(`${GREEN}Warp installed successfully.${NC}`);
+console.log(`  Version:  ${CYAN}v${VERSION}${NC}`);
+console.log(`  Skills:   ${GREEN}${skillsInstalled}${NC}`);
+console.log(`  Agents:   ${GREEN}${agentsInstalled}${NC}`);
+console.log(`  Hooks:    ${GREEN}${hooksInstalled}${NC}`);
+console.log('\u2501'.repeat(48));
+console.log('');
+console.log('Restart Claude Code to discover skills, then try: /warp-setup');
+console.log('');