From 35a63b9540b0f13568e93cea4c34a028e5eaa3af Mon Sep 17 00:00:00 2001
From: AIOSAI <aipass.system@gmail.com>
Date: Thu, 28 May 2026 19:51:27 -0700
Subject: [PATCH] fix: bootstrap @hooks as 13th branch + correct stale
 12-counts

setup.sh never bootstrapped @hooks (hardcoded 12-branch list, stale comment from before hooks existed). Fresh clones got no @hooks passport + an absolute registry path -> drone @hooks commands failed ('path escapes project root'). Engine still fired (runs from AIPASS_HOME) but the citizen was non-functional.

- setup.sh: + bootstrap_branch hooks, 12->13 count + comment
- .aipass/aipass_global_prompt.md: 12->13 core branches, + hooks (injected every turn)
- devpulse local prompt: 13 Core Branches, + @hooks experts row
- dashboard dispatch_section docstring: 12->13

Found via Docker clone-from-dev test (DPLAN-0190 Phase D).
---
 .aipass/aipass_global_prompt.md                              | 2 +-
 setup.sh                                                     | 5 +++--
 src/aipass/devpulse/.aipass/aipass_local_prompt.md           | 5 +++--
 .../prax/apps/plugins/devpulse_dashboard/dispatch_section.py | 2 +-
 4 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/.aipass/aipass_global_prompt.md b/.aipass/aipass_global_prompt.md
index 446ac300..035ff085 100644
--- a/.aipass/aipass_global_prompt.md
+++ b/.aipass/aipass_global_prompt.md
@@ -57,7 +57,7 @@ src/aipass/{name}/
 └── README.md
 ```
 
-12 core branches: aipass, drone, seedgo, prax, cli, flow, ai_mail, api, trigger, spawn, memory, devpulse.
+13 core branches: aipass, drone, seedgo, prax, cli, flow, ai_mail, api, trigger, spawn, memory, devpulse, hooks.
 
 # Commands
 
diff --git a/setup.sh b/setup.sh
index aa0cc718..3f1e9c18 100755
--- a/setup.sh
+++ b/setup.sh
@@ -478,12 +478,13 @@ bootstrap_branch "spawn"    "$SCRIPT_DIR/src/aipass/spawn"    "builder" "Branch
 bootstrap_branch "devpulse" "$SCRIPT_DIR/src/aipass/devpulse" "manager" "Orchestration hub and coordination"
 bootstrap_branch "memory"   "$SCRIPT_DIR/src/aipass/memory"   "builder" "Vector memory bank"
 bootstrap_branch "aipass"   "$SCRIPT_DIR/src/aipass/aipass"   "builder" "Concierge — init, doctor, profile, onboarding"
+bootstrap_branch "hooks"    "$SCRIPT_DIR/src/aipass/hooks"    "builder" "Hook engine — cross-platform hook dispatch and per-project config"
 
 # External branches
 # NOTE: backup, daemon removed S82/S87. commons, skills moved to external repos.
-# Only the 12 core branches above should be bootstrapped.
+# Only the 13 core branches above should be bootstrapped.
 
-echo "  12 branches bootstrapped"
+echo "  13 branches bootstrapped"
 
 # --- Seed branch config files from .example defaults ---
 # Some branches need a config file that's gitignored (contains local state).
diff --git a/src/aipass/devpulse/.aipass/aipass_local_prompt.md b/src/aipass/devpulse/.aipass/aipass_local_prompt.md
index 729cf7e9..f3e41f52 100644
--- a/src/aipass/devpulse/.aipass/aipass_local_prompt.md
+++ b/src/aipass/devpulse/.aipass/aipass_local_prompt.md
@@ -33,6 +33,7 @@ Task belongs to specialist domain → ask them. Investigate/fix small things you
 | Command routing | @drone | @branch resolution, subprocess |
 | Memory, vectors | @memory | ChromaDB, search, archival |
 | User onboarding, init | @aipass | Concierge, aipass init, doctor, scanner |
+| Hooks, engine, gates | @hooks | Hook engine, bridges, per-project config, sound |
 
 ## Git — Dev Branch, Drone Only, You Are Gatekeeper
 
@@ -82,9 +83,9 @@ drone @flow list open                                      # active plans
 drone systems                                              # all branches
 ```
 
-## 12 Core Branches
+## 13 Core Branches
 
-drone, seedgo, prax, cli, ai_mail, api, flow, spawn, trigger, memory, aipass, devpulse (you — coordinates via dispatch+agents)
+drone, seedgo, prax, cli, ai_mail, api, flow, spawn, trigger, memory, aipass, hooks, devpulse (you — coordinates via dispatch+agents)
 
 ## Working Habits
 
diff --git a/src/aipass/prax/apps/plugins/devpulse_dashboard/dispatch_section.py b/src/aipass/prax/apps/plugins/devpulse_dashboard/dispatch_section.py
index 3b78d12a..8012d7fe 100644
--- a/src/aipass/prax/apps/plugins/devpulse_dashboard/dispatch_section.py
+++ b/src/aipass/prax/apps/plugins/devpulse_dashboard/dispatch_section.py
@@ -56,7 +56,7 @@ def _read_lock(lock_path: Path) -> Dict:
 def build_dispatch_section(branch_path: Path) -> bool:
     """Build dispatch section data and write to dashboard.
 
-    Scans all 12 branches for active dispatch locks.
+    Scans all 13 branches for active dispatch locks.
 
     Args:
         branch_path: Path to devpulse branch root.