diff --git a/gitnexus-claude-plugin/hooks/hook-db-lock-probe.cjs b/gitnexus-claude-plugin/hooks/hook-db-lock-probe.cjs
index 4376795e2..94c6848e4 100644
--- a/gitnexus-claude-plugin/hooks/hook-db-lock-probe.cjs
+++ b/gitnexus-claude-plugin/hooks/hook-db-lock-probe.cjs
@@ -1,3 +1,7 @@
+// Bundled byte-identical into every hook adapter directory — each one installs
+// standalone and cannot import across packages. Drift guards in
+// gitnexus/test/unit/hooks.test.ts and test/unit/factory-plugin.test.ts fail if the
+// copies diverge; fix them together.
 /**
  * Cross-platform best-effort probe: does another process hold dbPath open
  * with a command line that looks like a GitNexus MCP/serve server?
diff --git a/gitnexus-claude-plugin/hooks/hook-lock.js b/gitnexus-claude-plugin/hooks/hook-lock.js
index 759856384..03ac738f9 100644
--- a/gitnexus-claude-plugin/hooks/hook-lock.js
+++ b/gitnexus-claude-plugin/hooks/hook-lock.js
@@ -1,3 +1,7 @@
+// Bundled byte-identical into every hook adapter directory — each one installs
+// standalone and cannot import across packages. Drift guards in
+// gitnexus/test/unit/hooks.test.ts and test/unit/factory-plugin.test.ts fail if the
+// copies diverge; fix them together.
 const fs = require('fs');
 const path = require('path');
 
diff --git a/gitnexus-claude-plugin/hooks/win-rm-list-json.ps1 b/gitnexus-claude-plugin/hooks/win-rm-list-json.ps1
index 5c1564e30..0745148f7 100644
--- a/gitnexus-claude-plugin/hooks/win-rm-list-json.ps1
+++ b/gitnexus-claude-plugin/hooks/win-rm-list-json.ps1
@@ -1,3 +1,7 @@
+# Bundled byte-identical into every hook adapter directory — each one installs
+# standalone and cannot import across packages. Drift guards in
+# gitnexus/test/unit/hooks.test.ts and test/unit/factory-plugin.test.ts fail if the
+# copies diverge; fix them together.
 $ErrorActionPreference = 'Stop'
 $target = $env:GITNEXUS_HOOK_RM_TARGET
 if ([string]::IsNullOrWhiteSpace($target)) { Write-Output '[]'; exit 0 }
diff --git a/gitnexus-cursor-integration/hooks/hook-lock.cjs b/gitnexus-cursor-integration/hooks/hook-lock.cjs
index 759856384..03ac738f9 100644
--- a/gitnexus-cursor-integration/hooks/hook-lock.cjs
+++ b/gitnexus-cursor-integration/hooks/hook-lock.cjs
@@ -1,3 +1,7 @@
+// Bundled byte-identical into every hook adapter directory — each one installs
+// standalone and cannot import across packages. Drift guards in
+// gitnexus/test/unit/hooks.test.ts and test/unit/factory-plugin.test.ts fail if the
+// copies diverge; fix them together.
 const fs = require('fs');
 const path = require('path');
 
diff --git a/gitnexus-factory-plugin/hooks/hook-db-lock-probe.cjs b/gitnexus-factory-plugin/hooks/hook-db-lock-probe.cjs
index 4376795e2..94c6848e4 100644
--- a/gitnexus-factory-plugin/hooks/hook-db-lock-probe.cjs
+++ b/gitnexus-factory-plugin/hooks/hook-db-lock-probe.cjs
@@ -1,3 +1,7 @@
+// Bundled byte-identical into every hook adapter directory — each one installs
+// standalone and cannot import across packages. Drift guards in
+// gitnexus/test/unit/hooks.test.ts and test/unit/factory-plugin.test.ts fail if the
+// copies diverge; fix them together.
 /**
  * Cross-platform best-effort probe: does another process hold dbPath open
  * with a command line that looks like a GitNexus MCP/serve server?
diff --git a/gitnexus-factory-plugin/hooks/hook-lock.js b/gitnexus-factory-plugin/hooks/hook-lock.js
index 759856384..03ac738f9 100644
--- a/gitnexus-factory-plugin/hooks/hook-lock.js
+++ b/gitnexus-factory-plugin/hooks/hook-lock.js
@@ -1,3 +1,7 @@
+// Bundled byte-identical into every hook adapter directory — each one installs
+// standalone and cannot import across packages. Drift guards in
+// gitnexus/test/unit/hooks.test.ts and test/unit/factory-plugin.test.ts fail if the
+// copies diverge; fix them together.
 const fs = require('fs');
 const path = require('path');
 
diff --git a/gitnexus-factory-plugin/hooks/win-rm-list-json.ps1 b/gitnexus-factory-plugin/hooks/win-rm-list-json.ps1
index 5c1564e30..0745148f7 100644
--- a/gitnexus-factory-plugin/hooks/win-rm-list-json.ps1
+++ b/gitnexus-factory-plugin/hooks/win-rm-list-json.ps1
@@ -1,3 +1,7 @@
+# Bundled byte-identical into every hook adapter directory — each one installs
+# standalone and cannot import across packages. Drift guards in
+# gitnexus/test/unit/hooks.test.ts and test/unit/factory-plugin.test.ts fail if the
+# copies diverge; fix them together.
 $ErrorActionPreference = 'Stop'
 $target = $env:GITNEXUS_HOOK_RM_TARGET
 if ([string]::IsNullOrWhiteSpace($target)) { Write-Output '[]'; exit 0 }
diff --git a/gitnexus/hooks/claude/hook-db-lock-probe.cjs b/gitnexus/hooks/claude/hook-db-lock-probe.cjs
index 4376795e2..94c6848e4 100644
--- a/gitnexus/hooks/claude/hook-db-lock-probe.cjs
+++ b/gitnexus/hooks/claude/hook-db-lock-probe.cjs
@@ -1,3 +1,7 @@
+// Bundled byte-identical into every hook adapter directory — each one installs
+// standalone and cannot import across packages. Drift guards in
+// gitnexus/test/unit/hooks.test.ts and test/unit/factory-plugin.test.ts fail if the
+// copies diverge; fix them together.
 /**
  * Cross-platform best-effort probe: does another process hold dbPath open
  * with a command line that looks like a GitNexus MCP/serve server?
diff --git a/gitnexus/hooks/claude/hook-lock.cjs b/gitnexus/hooks/claude/hook-lock.cjs
index 759856384..03ac738f9 100644
--- a/gitnexus/hooks/claude/hook-lock.cjs
+++ b/gitnexus/hooks/claude/hook-lock.cjs
@@ -1,3 +1,7 @@
+// Bundled byte-identical into every hook adapter directory — each one installs
+// standalone and cannot import across packages. Drift guards in
+// gitnexus/test/unit/hooks.test.ts and test/unit/factory-plugin.test.ts fail if the
+// copies diverge; fix them together.
 const fs = require('fs');
 const path = require('path');
 
diff --git a/gitnexus/hooks/claude/win-rm-list-json.ps1 b/gitnexus/hooks/claude/win-rm-list-json.ps1
index 5c1564e30..0745148f7 100644
--- a/gitnexus/hooks/claude/win-rm-list-json.ps1
+++ b/gitnexus/hooks/claude/win-rm-list-json.ps1
@@ -1,3 +1,7 @@
+# Bundled byte-identical into every hook adapter directory — each one installs
+# standalone and cannot import across packages. Drift guards in
+# gitnexus/test/unit/hooks.test.ts and test/unit/factory-plugin.test.ts fail if the
+# copies diverge; fix them together.
 $ErrorActionPreference = 'Stop'
 $target = $env:GITNEXUS_HOOK_RM_TARGET
 if ([string]::IsNullOrWhiteSpace($target)) { Write-Output '[]'; exit 0 }