hool-cli 0.9.0 → 0.9.2

package/presets/team/hooks/login-nudge.sh

@@ -1,56 +1,37 @@
 #!/bin/bash
 # Hook: Login Nudge
 # Trigger: Called by PL before first QA run or when authenticated testing is needed
-# Purpose: Prompt user to manually log into browser profiles
+# Purpose: Prompt user to manually log into the shared browser profile
 #
-# Agents can't log into services requiring real credentials (OAuth, 2FA, passwords).
-# This hook opens each browser profile in headed mode so the user can log in.
-# After login, the profile persists cookies/localStorage for agent use.
+# All agents share a single browser profile at .hool/browser-profiles/shared/
+# via --user-data-dir. User logs in once via headful mode, all agents (headless
+# and headful) get the same auth state.
 
 set -euo pipefail
 
-PROFILES_DIR=".hool/browser-profiles"
-PROFILES=("qa" "fe-dev" "forensic")
+SHARED_PROFILE=".hool/browser-profiles/shared"
+mkdir -p "$SHARED_PROFILE"
 
 echo "============================================"
 echo "  BROWSER PROFILE LOGIN REQUIRED"
 echo "============================================"
 echo ""
-echo "Agents need authenticated browser sessions to test login-protected flows."
-echo "You need to manually log into each browser profile."
+echo "Agents need an authenticated browser session to test login-protected flows."
+echo "All agents share a single browser profile at: ${SHARED_PROFILE}/"
 echo ""
-
-for profile in "${PROFILES[@]}"; do
-  PROFILE_DIR="${PROFILES_DIR}/${profile}"
-  mkdir -p "$PROFILE_DIR"
-
-  echo "---"
-  echo "Profile: ${profile}"
-  echo "  Purpose:"
-  case "$profile" in
-    qa)       echo "    QA agent uses this for E2E testing and visual testing" ;;
-    fe-dev)   echo "    FE Dev uses this for design card comparison and visual checks" ;;
-    forensic) echo "    Forensic uses this for reproducing UI bugs" ;;
-  esac
-  echo "  Directory: ${PROFILE_DIR}/"
-  echo ""
-done
-
 echo "============================================"
 echo "  HOW TO LOG IN"
 echo "============================================"
 echo ""
-echo "For each profile, run:"
-echo ""
-echo "  playwright-mcp --profile .hool/browser-profiles/<profile-name>"
+echo "Run:"
 echo ""
-echo "This opens a browser with that profile. Log into all required services,"
-echo "then close the browser. The auth state will persist for agent use."
+echo "  playwright-mcp --user-data-dir ${SHARED_PROFILE}"
 echo ""
-echo "Example:"
-echo "  playwright-mcp --profile .hool/browser-profiles/qa"
+echo "This opens a visible browser with the shared profile."
+echo "Log into all required services, then close the browser."
+echo "The auth state persists for all agents in both headless and headful modes."
 echo ""
-echo "After logging in to all profiles, tell the Product Lead you're done."
+echo "After logging in, tell the Product Lead you're done."
 echo "============================================"
 
 # Output for hook system
@@ -58,7 +39,7 @@ cat << 'EOF'
 {
   "hookSpecificOutput": {
     "hookEventName": "UserPromptSubmit",
-    "additionalContext": "LOGIN NUDGE: Browser profiles need user login before agents can test authenticated flows. Profiles: qa, fe-dev, forensic. Ask the user to run: playwright-mcp --profile .hool/browser-profiles/<name> for each profile, log into required services, then close the browser."
+    "additionalContext": "LOGIN NUDGE: Shared browser profile needs user login before agents can test authenticated flows. Profile: .hool/browser-profiles/shared/. Ask the user to run: playwright-mcp --user-data-dir .hool/browser-profiles/shared — log into required services, then close the browser."
   }
 }
 EOF

package/presets/team/hooks/metrics.sh

@@ -17,7 +17,8 @@ if [ ! -f "$METRICS_FILE" ]; then
 INIT
 fi
 
-# Increment total tool calls
-current_total=$(grep -oP '(?<=tool-calls: )\d+' "$METRICS_FILE" 2>/dev/null || echo "0")
+# Increment total tool calls (BSD sed compatible)
+current_total=$(sed -n 's/.*tool-calls: *\([0-9]*\).*/\1/p' "$METRICS_FILE" 2>/dev/null | head -1)
+current_total=${current_total:-0}
 new_total=$((current_total + 1))
 sed -i '' "s/tool-calls: ${current_total}/tool-calls: ${new_total}/" "$METRICS_FILE" 2>/dev/null || true

package/presets/team/mcps/mcps.json

@@ -2,49 +2,143 @@
   "servers": {
     "context7": {
       "command": "npx",
-      "args": ["-y", "@context7/mcp"],
+      "args": [
+        "-y",
+        "@context7/mcp"
+      ],
       "install": "global (npx auto-installs)",
       "description": "Up-to-date library documentation. All agents use this.",
-      "agents": ["all"]
+      "agents": [
+        "all"
+      ]
     },
     "deepwiki": {
       "command": "npx",
-      "args": ["-y", "deepwiki-mcp"],
+      "args": [
+        "-y",
+        "deepwiki-mcp"
+      ],
       "install": "global (npx auto-installs)",
       "description": "Deep documentation for open-source projects.",
-      "agents": ["product-lead", "be-tech-lead", "fe-tech-lead", "be-dev", "fe-dev"]
+      "agents": [
+        "product-lead",
+        "be-tech-lead",
+        "fe-tech-lead",
+        "be-dev",
+        "fe-dev"
+      ]
     },
     "playwright": {
       "package": "@playwright/mcp",
       "command": "playwright-mcp",
-      "args": ["--headless"],
+      "args": [
+        "--headless"
+      ],
       "install": "npm install -g @playwright/mcp (done during hool init)",
-      "description": "Browser automation. Single instance, multiple named profiles.",
-      "agents": ["qa", "forensic", "fe-dev"],
+      "description": "Headless browser automation. Single instance, multiple named profiles. Shares browser profile with playwright-headful.",
+      "agents": [
+        "qa",
+        "forensic",
+        "fe-dev"
+      ],
       "profiles": {
         "description": "Each agent operates in its own named browser profile stored under .hool/browser-profiles/<profile-name>/. Profiles persist cookies, localStorage, and auth state across sessions.",
-        "available": ["qa", "fe-dev", "forensic"],
+        "available": [
+          "qa",
+          "fe-dev",
+          "forensic"
+        ],
         "user-login-required": "Agents cannot log into services that require real credentials (OAuth, 2FA, etc). The user must manually open each profile and log in before agents can test authenticated flows. See the login-nudge hook."
-      }
+      },
+      "shares-profile-with": "playwright-headful"
+    },
+    "playwright-headful": {
+      "command": "playwright-mcp",
+      "args": [],
+      "install": "npm install -g @playwright/mcp (same binary as headless, just no --headless flag)",
+      "description": "Visible browser for human-assisted login, interactive debugging, and live demos. Shares browser profile with headless mode.",
+      "agents": [
+        "qa",
+        "forensic",
+        "fe-dev"
+      ],
+      "shares-profile-with": "playwright"
     }
   },
   "by-domain": {
-    "web-app": ["context7", "deepwiki", "playwright"],
-    "api-only": ["context7", "deepwiki"],
-    "cli-tool": ["context7", "deepwiki"],
-    "browser-game": ["context7", "deepwiki", "playwright"],
-    "animation": ["context7", "deepwiki", "playwright"],
-    "mobile": ["context7", "deepwiki"],
-    "desktop": ["context7", "deepwiki", "playwright"]
+    "web-app": [
+      "context7",
+      "deepwiki",
+      "playwright",
+      "playwright-headful"
+    ],
+    "api-only": [
+      "context7",
+      "deepwiki"
+    ],
+    "cli-tool": [
+      "context7",
+      "deepwiki"
+    ],
+    "browser-game": [
+      "context7",
+      "deepwiki",
+      "playwright",
+      "playwright-headful"
+    ],
+    "animation": [
+      "context7",
+      "deepwiki",
+      "playwright",
+      "playwright-headful"
+    ],
+    "mobile": [
+      "context7",
+      "deepwiki"
+    ],
+    "desktop": [
+      "context7",
+      "deepwiki",
+      "playwright",
+      "playwright-headful"
+    ]
   },
   "agent-access-matrix": {
-    "product-lead":  ["context7", "deepwiki"],
-    "be-tech-lead":  ["context7", "deepwiki"],
-    "fe-tech-lead":  ["context7", "deepwiki"],
-    "be-dev":        ["context7", "deepwiki"],
-    "fe-dev":        ["context7", "deepwiki", "playwright"],
-    "qa":            ["context7", "playwright"],
-    "forensic":      ["context7", "playwright"],
-    "governor":      ["context7"]
+    "product-lead": [
+      "context7",
+      "deepwiki",
+      "playwright-headful"
+    ],
+    "be-tech-lead": [
+      "context7",
+      "deepwiki"
+    ],
+    "fe-tech-lead": [
+      "context7",
+      "deepwiki"
+    ],
+    "be-dev": [
+      "context7",
+      "deepwiki"
+    ],
+    "fe-dev": [
+      "context7",
+      "deepwiki",
+      "playwright",
+      "playwright-headful"
+    ],
+    "qa": [
+      "context7",
+      "playwright",
+      "playwright-headful"
+    ],
+    "forensic": [
+      "context7",
+      "playwright",
+      "playwright-headful"
+    ],
+    "governor": [
+      "context7"
+    ]
   }
 }

package/presets/team/prompts/claude-md.md

@@ -52,10 +52,10 @@ project-root/          ← Project-level git (Product Lead owns)
 
 ### Playwright Browser Profiles
 - Globally installed (`npm install -g @playwright/mcp`) — persistent binary, not ephemeral npx
-- Each agent uses a named profile: `qa`, `fe-dev`, `forensic`
-- Profiles stored in `.hool/browser-profiles/<profile-name>/`
-- Cookies, localStorage, and auth state persist per profile across sessions
-- Agents cannot log into OAuth/2FA services — user must manually log into profiles first (see login-nudge hook)
+- **Shared profile**: Both headless and headful modes share the same browser profile at `.hool/browser-profiles/shared/` via `--user-data-dir`
+- Cookies, localStorage, and auth state persist across sessions and across modes (headless ↔ headful)
+- User logs in via headful mode → agents test via headless mode with the same auth state
+- Agents cannot log into OAuth/2FA services — user must manually log in first (see login-nudge hook)
 
 ### Playwright Modes (Headless vs Headful)
 

package/presets/team/settings/claude-settings.json

@@ -2,24 +2,38 @@
   "env": {
     "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
   },
+  "teammateMode": "tmux",
   "mcpServers": {
     "context7": {
       "command": "npx",
-      "args": ["-y", "@context7/mcp"]
+      "args": [
+        "-y",
+        "@context7/mcp"
+      ]
     },
     "deepwiki": {
       "command": "npx",
-      "args": ["-y", "deepwiki-mcp"]
+      "args": [
+        "-y",
+        "deepwiki-mcp"
+      ]
     },
     "playwright": {
       "command": "playwright-mcp",
-      "args": ["--headless"],
-      "_note": "Globally installed via npm install -g @playwright/mcp. Default headless mode for automation, screenshots, E2E testing."
+      "args": [
+        "--headless",
+        "--user-data-dir",
+        ".hool/browser-profiles/shared"
+      ],
+      "_note": "Headless mode. Shares browser profile with playwright-headful via --user-data-dir."
     },
     "playwright-headful": {
       "command": "playwright-mcp",
-      "args": [],
-      "_note": "Headful mode — visible browser for human-assisted login, interactive debugging, and live demos. Use when user needs to see/interact with the browser."
+      "args": [
+        "--user-data-dir",
+        ".hool/browser-profiles/shared"
+      ],
+      "_note": "Headful (visible) mode. Shares browser profile with playwright (headless) via same --user-data-dir."
     }
   },
   "permissions": {