fix(V3.2-P7): worktree-safe hook prefix — git-common-dir replaces show-toplevel

Hooks failed when Claude Code was opened from a git worktree because
git rev-parse --show-toplevel returns the worktree path, not the main
repo root, causing .memory/hooks/ to be unfindable.

New prefix in generate_hooks_settings():
  _r="$(git rev-parse --path-format=absolute --git-common-dir 2>/dev/null)" \
    || exit 0; _r="${_r%/.git}"; cd "$_r" && ...

- --git-common-dir always resolves to the main repo .git (not the worktree subdir)
- --path-format=absolute gives a consistent absolute path regardless of CWD
- bash suffix removal (no sed, no false match on .github paths)
- Requires git 2.31+ (March 2021)

Bug discovered in QTP worktree session; EFM had the same root cause.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: lagameon

.memory/lib/init.py

@@ -213,7 +213,14 @@ def generate_hooks_settings() -> dict:
     # is editing files in a subdirectory like deployment/live_trading/).
     # The _root variable silently exits if not in a git repo, preventing
     # errors (and infinite Stop-hook loops) in non-git subdirectories.
-    _root = '_r="$(git rev-parse --show-toplevel 2>/dev/null)" || exit 0; cd "$_r" && '
+    #
+    # Worktree-safe: --path-format=absolute --git-common-dir always returns
+    # the main repo's .git path (not the worktree path), so hooks can find
+    # .memory/hooks/ even when Claude is opened from a git worktree.
+    # bash ${_r%/.git} strips exactly "/.git" at the end (no sed, no glob
+    # issues with paths that contain ".github" directories).
+    # Requires git 2.31+ (released 2021-03).
+    _root = '_r="$(git rev-parse --path-format=absolute --git-common-dir 2>/dev/null)" || exit 0; _r="${_r%/.git}"; cd "$_r" && '
     return {
         "SessionStart": [
             {

.memory/tests/test_init.py

@@ -428,10 +428,12 @@ def test_hooks_commands_have_cd_prefix(self):
                 for hook in group["hooks"]:
                     cmd = hook["command"]
                     if ".memory/hooks/" in cmd:
+                        # Worktree-safe: must use --git-common-dir (not
+                        # --show-toplevel which returns the worktree path)
                         self.assertIn(
-                            'git rev-parse --show-toplevel',
+                            'git rev-parse --path-format=absolute --git-common-dir',
                             cmd,
-                            f"{event_name} hook missing cd-to-root prefix",
+                            f"{event_name} hook missing worktree-safe cd-to-root prefix",
                         )
                         # Must suppress stderr and exit gracefully for non-git dirs
                         self.assertIn(

CHANGELOG.md

@@ -4,6 +4,34 @@ All notable changes to EFM (Evidence-First Memory for Claude Code) will be docum
 
 ---
 
+## 2026-03-03 — V3.2 Phase 7: Worktree-Safe Hook Prefix
+
+### Fix: Hooks fail when Claude Code is opened from a git worktree
+
+**BUG: `--show-toplevel` returns the worktree path, not the main repo path**
+`git rev-parse --show-toplevel` in a worktree returns the worktree directory (e.g. `.claude/worktrees/vibrant-swartz/`), not the main repository root. This caused all hook scripts that reference `.memory/hooks/` to fail with "No such file or directory" because the worktree directory doesn't contain a `.memory/` tree.
+
+Root cause discovered while using Claude Code worktrees in the QTP project. EFM itself had the identical bug.
+
+**Fix:** Changed the hook command prefix in `generate_hooks_settings()` to:
+```
+_r="$(git rev-parse --path-format=absolute --git-common-dir 2>/dev/null)" || exit 0; _r="${_r%/.git}"; cd "$_r" && ...
+```
+- `--git-common-dir` always returns the main repo's `.git` path (not the worktree-specific subdir)
+- `--path-format=absolute` ensures an absolute path regardless of CWD
+- `${_r%/.git}` strips the trailing `/.git` using bash suffix removal (no sed — avoids false matches on paths containing `.github` directories)
+- Requires git 2.31+ (March 2021)
+
+All 5 hooks (SessionStart, PreToolUse:Edit/Write, PreToolUse:EnterPlanMode, Stop, PreCompact) updated.
+
+**Upgrade:** Run `/memory-init` to regenerate hooks with the worktree-safe prefix.
+
+**Modified files (2):**
+- `.memory/lib/init.py` — `generate_hooks_settings()` worktree-safe prefix (with explanatory comment)
+- `.memory/tests/test_init.py` — updated assertion to check for `--git-common-dir` instead of `--show-toplevel`
+
+---
+
 ## 2026-02-17 — V3.2 Phase 6: Git Merge Safety (`/memory-repair`)
 
 ### New: Post-merge repair command for `events.jsonl`