claude-dev-env 1.19.0 → 1.19.1

package/hooks/blocking/content-search-to-zoekt-redirector.py

@@ -8,7 +8,10 @@ import sys
 from content_search_zoekt_bash_block_reason import block_reason_for_bash_command
 from content_search_zoekt_block_payload import build_block_payload
 from content_search_zoekt_indexed_paths import is_in_indexed_repo, is_specific_file
-from content_search_zoekt_redirect_guidance import get_zoekt_redirect_guidance
+from content_search_zoekt_redirect_guidance import (
+    get_zoekt_redirect_guidance,
+    get_zoekt_redirect_reason_brief,
+)
 
 
 def main() -> None:
@@ -45,7 +48,8 @@ def main() -> None:
     short_label = f"blocked {block_reason}; use Zoekt MCP"
     payload = build_block_payload(
         brief_label=short_label,
-        permission_decision_reason=get_zoekt_redirect_guidance(),
+        permission_decision_reason=get_zoekt_redirect_reason_brief(),
+        additional_context=get_zoekt_redirect_guidance(),
     )
     print(json.dumps(payload))
     sys.exit(0)

package/hooks/blocking/content_search_zoekt_block_payload.py

@@ -4,14 +4,18 @@
 def build_block_payload(
     brief_label: str,
     permission_decision_reason: str,
+    additional_context: str | None = None,
 ) -> dict:
     destructive_gate_label_prefix = "[destructive-gate]"
+    hook_specific_output: dict = {
+        "hookEventName": "PreToolUse",
+        "permissionDecision": "deny",
+        "permissionDecisionReason": permission_decision_reason,
+    }
+    if additional_context is not None:
+        hook_specific_output["additionalContext"] = additional_context
     return {
-        "hookSpecificOutput": {
-            "hookEventName": "PreToolUse",
-            "permissionDecision": "deny",
-            "permissionDecisionReason": permission_decision_reason,
-        },
+        "hookSpecificOutput": hook_specific_output,
         "systemMessage": f"{destructive_gate_label_prefix} {brief_label}",
         "suppressOutput": True,
     }

package/hooks/blocking/content_search_zoekt_redirect_guidance.py

@@ -1,4 +1,10 @@
-"""Zoekt MCP usage and repo-to-disk path mapping for PreToolUse permissionDecisionReason."""
+"""Zoekt MCP usage and repo-to-disk path mapping for PreToolUse outputs."""
+
+
+def get_zoekt_redirect_reason_brief() -> str:
+    return (
+        "Use Zoekt MCP (e.g. mcp__zoekt__search) instead of Grep/Search in Zoekt-indexed trees."
+    )
 
 
 def get_zoekt_redirect_guidance() -> str:

package/hooks/blocking/test_content_search_to_zoekt_redirector_integration.py

@@ -13,7 +13,10 @@ class ContentSearchHookIntegrationTests(unittest.TestCase):
         hook_directory = pathlib.Path(__file__).resolve().parent
         if str(hook_directory) not in sys.path:
             sys.path.insert(0, str(hook_directory))
-        from content_search_zoekt_redirect_guidance import get_zoekt_redirect_guidance
+        from content_search_zoekt_redirect_guidance import (
+            get_zoekt_redirect_guidance,
+            get_zoekt_redirect_reason_brief,
+        )
 
         hook_path = hook_directory / "content-search-to-zoekt-redirector.py"
         destructive_gate_label_prefix = "[destructive-gate]"
@@ -38,6 +41,10 @@ class ContentSearchHookIntegrationTests(unittest.TestCase):
         )
         self.assertEqual(
             payload["hookSpecificOutput"]["permissionDecisionReason"],
+            get_zoekt_redirect_reason_brief(),
+        )
+        self.assertEqual(
+            payload["hookSpecificOutput"]["additionalContext"],
             get_zoekt_redirect_guidance(),
         )
         self.assertEqual(

package/hooks/blocking/test_content_search_to_zoekt_redirector_unit.py

@@ -11,7 +11,10 @@ if str(HOOK_DIRECTORY) not in sys.path:
     sys.path.insert(0, str(HOOK_DIRECTORY))
 
 from content_search_zoekt_block_payload import build_block_payload
-from content_search_zoekt_redirect_guidance import get_zoekt_redirect_guidance
+from content_search_zoekt_redirect_guidance import (
+    get_zoekt_redirect_guidance,
+    get_zoekt_redirect_reason_brief,
+)
 
 
 class BuildBlockPayloadTests(unittest.TestCase):
@@ -32,12 +35,14 @@ class BuildBlockPayloadTests(unittest.TestCase):
         self.assertEqual(payload["suppressOutput"], True)
         self.assertNotIn("decision", payload)
         self.assertNotIn("reason", payload)
+        self.assertNotIn("additionalContext", payload["hookSpecificOutput"])
 
     def test_serialized_payload_under_documented_context_cap(self) -> None:
         cap_characters = 10_000
         payload = build_block_payload(
             brief_label="blocked Bash(grep); use Zoekt MCP",
-            permission_decision_reason=get_zoekt_redirect_guidance(),
+            permission_decision_reason=get_zoekt_redirect_reason_brief(),
+            additional_context=get_zoekt_redirect_guidance(),
         )
         serialized = json.dumps(payload)
         self.assertLessEqual(

package/hooks/hooks.json

@@ -2,6 +2,16 @@
   "description": "Code standards enforcement, safety guards, and development workflow hooks",
   "hooks": {
     "PreToolUse": [
+      {
+        "matcher": "Grep|Search",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/blocking/content-search-to-zoekt-redirector.py",
+            "timeout": 10
+          }
+        ]
+      },
       {
         "matcher": "Write|Edit",
         "hooks": [
@@ -84,6 +94,11 @@
             "type": "command",
             "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/blocking/test-preflight-check.py",
             "timeout": 10
+          },
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/blocking/content-search-to-zoekt-redirector.py",
+            "timeout": 10
           }
         ]
       },

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "claude-dev-env",
-    "version": "1.19.0",
+    "version": "1.19.1",
     "description": "Claude Code development standards — rules, hooks, agents, commands, and skills",
     "type": "module",
     "bin": {