claude-dev-env 1.0.0

package/hooks/hooks.json

@@ -0,0 +1,246 @@
+{
+  "description": "Code standards enforcement, safety guards, and development workflow hooks",
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/blocking/write-existing-file-blocker.py",
+            "timeout": 10
+          },
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/blocking/sensitive-file-protector.py",
+            "timeout": 10
+          },
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/blocking/pyautogui-scroll-blocker.py",
+            "timeout": 10
+          },
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/validation/hook-format-validator.py",
+            "timeout": 15
+          },
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/validators/run_all_validators.py",
+            "timeout": 15
+          },
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/blocking/code-rules-enforcer.py",
+            "timeout": 15
+          },
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/blocking/tdd-enforcer.py",
+            "timeout": 10
+          },
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/validation/code-style-validator.py",
+            "timeout": 15
+          },
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/blocking/docker-settings-guard.py",
+            "timeout": 15
+          }
+        ]
+      },
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/advisory/refactor-guard.py",
+            "timeout": 15
+          },
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/advisory/migration-safety-advisor.py",
+            "timeout": 15
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/blocking/destructive-command-blocker.py",
+            "timeout": 10
+          },
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/blocking/block-main-commit.py",
+            "timeout": 15
+          },
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/blocking/pr-description-enforcer.py",
+            "timeout": 10
+          },
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/blocking/test-preflight-check.py",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "matcher": "Task|Agent",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/blocking/parallel-task-blocker.py",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "matcher": "AskUserQuestion",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/notification/attention-needed-notify.py",
+            "timeout": 15
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/session/hook-structure-context.py",
+            "timeout": 10
+          },
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/session/bulk-edit-reminder.py",
+            "timeout": 15
+          },
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/session/code-rules-reminder.py",
+            "timeout": 15
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/session/compact-context-reinject.py",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/session/plugin-data-dir-cleanup.py",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/notification/attention-needed-notify.py",
+            "timeout": 15
+          },
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/blocking/hedging-language-blocker.py",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/lifecycle/session-end-cleanup.py",
+            "timeout": 15
+          }
+        ]
+      }
+    ],
+    "ConfigChange": [
+      {
+        "matcher": "user_settings",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/lifecycle/config-change-guard.py",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/validation/mypy_validator.py",
+            "timeout": 30
+          },
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/validation/e2e-test-validator.py",
+            "timeout": 15
+          },
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/workflow/auto-formatter.py",
+            "timeout": 30
+          }
+        ]
+      },
+      {
+        "matcher": "Agent|Task|TeamCreate",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/workflow/investigation-tracker-reset.py",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/notification/claude-notification-handler.py",
+            "timeout": 15
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/lifecycle/config-change-guard.py

@@ -0,0 +1,84 @@
+#!/usr/bin/env python3
+from datetime import datetime
+import json
+import os
+import sys
+
+AUDIT_LOG = os.path.expanduser("~/.claude/cache/config-change-audit.log")
+KNOWN_HOOK_COUNT_FILE = os.path.expanduser("~/.claude/cache/known-hook-count.txt")
+
+
+def count_hooks_in_settings(file_path: str) -> int:
+    try:
+        with open(file_path) as settings_file:
+            settings = json.load(settings_file)
+    except (OSError, json.JSONDecodeError):
+        return 0
+    hooks_section = settings.get("hooks", {})
+    total_count = 0
+    for event_hook_groups in hooks_section.values():
+        for hook_configuration in event_hook_groups:
+            total_count += len(hook_configuration.get("hooks", []))
+    return total_count
+
+
+def write_audit_entry(source: str, file_path: str) -> None:
+    audit_entry = f"{datetime.now().isoformat()} source={source} file={file_path}\n"
+    try:
+        os.makedirs(os.path.dirname(AUDIT_LOG), exist_ok=True)
+        with open(AUDIT_LOG, "a") as audit_file:
+            audit_file.write(audit_entry)
+    except OSError:
+        pass
+
+
+def guard_hook_injection(file_path: str) -> None:
+    current_count = count_hooks_in_settings(file_path)
+
+    if not os.path.exists(KNOWN_HOOK_COUNT_FILE):
+        try:
+            with open(KNOWN_HOOK_COUNT_FILE, "w") as count_file:
+                count_file.write(str(current_count))
+        except OSError:
+            pass
+        return
+
+    try:
+        with open(KNOWN_HOOK_COUNT_FILE) as count_file:
+            stored_count = int(count_file.read().strip())
+    except (OSError, ValueError):
+        stored_count = current_count
+
+    try:
+        with open(KNOWN_HOOK_COUNT_FILE, "w") as count_file:
+            count_file.write(str(current_count))
+    except OSError:
+        pass
+
+    if current_count > stored_count:
+        block_decision = {
+            "decision": "block",
+            "reason": f"Hook count changed {stored_count} -> {current_count}. Delete known-hook-count.txt to reset.",
+        }
+        print(json.dumps(block_decision))
+
+
+def main() -> None:
+    try:
+        hook_input = json.load(sys.stdin)
+    except json.JSONDecodeError:
+        sys.exit(0)
+
+    source = hook_input.get("source", "")
+    file_path = hook_input.get("file_path", "")
+
+    write_audit_entry(source, file_path)
+
+    if source == "user_settings" and file_path:
+        guard_hook_injection(file_path)
+
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

package/hooks/lifecycle/session-end-cleanup.py

@@ -0,0 +1,59 @@
+#!/usr/bin/env python3
+import json
+import os
+import sys
+import time
+from typing import Callable
+
+CACHE_DIR = os.path.expanduser("~/.claude/cache/")
+STALE_THRESHOLD_DAYS = 7
+BACKUP_RETENTION_DAYS = 30
+SECONDS_PER_DAY = 86400
+
+
+def purge_old_entries(
+    directory: str,
+    max_age_days: int,
+    should_include: Callable[[os.DirEntry[str]], bool] = lambda _entry: True,
+) -> None:
+    if not os.path.exists(directory):
+        return
+    cutoff_time = time.time() - (max_age_days * SECONDS_PER_DAY)
+    try:
+        for each_entry in os.scandir(directory):
+            if should_include(each_entry):
+                try:
+                    if each_entry.stat().st_mtime < cutoff_time:
+                        os.unlink(each_entry.path)
+                except OSError:
+                    pass
+    except OSError:
+        pass
+
+
+def main() -> None:
+    try:
+        json.load(sys.stdin)
+    except json.JSONDecodeError:
+        sys.exit(0)
+
+    purge_old_entries(
+        CACHE_DIR,
+        STALE_THRESHOLD_DAYS,
+        should_include=lambda each_entry: each_entry.name.startswith("claude-ctx-") and each_entry.name.endswith(".json"),
+    )
+    purge_old_entries(
+        CACHE_DIR,
+        STALE_THRESHOLD_DAYS,
+        should_include=lambda each_entry: each_entry.name.endswith(".tmp"),
+    )
+    purge_old_entries(
+        os.path.join(CACHE_DIR, "transcript-backups"),
+        BACKUP_RETENTION_DAYS,
+    )
+
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

package/hooks/notification/attention-needed-notify.py

@@ -0,0 +1,63 @@
+#!/usr/bin/env python3
+"""
+Notification hook - cross-platform (Windows/Linux/WSL)
+Plays chimes sound + shows desktop notification when Claude needs user input.
+"""
+
+import json
+import os
+import platform
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from notification_utils import (
+    notify_ntfy,
+    is_wsl,
+    notify_windows,
+    notify_wsl,
+    notify_linux,
+    sound_windows,
+    sound_wsl,
+    sound_linux,
+    get_project_name,
+)
+
+DEFAULT_MESSAGE = "Input needed"
+
+
+def get_question_from_stdin() -> str:
+    """Extract question text from hook input JSON."""
+    try:
+        hook_input = json.load(sys.stdin)
+        tool_input = hook_input.get("tool_input", {})
+        questions = tool_input.get("questions", [])
+        if questions:
+            return questions[0].get("question", DEFAULT_MESSAGE)
+    except (json.JSONDecodeError, KeyError, IndexError):
+        pass
+    return DEFAULT_MESSAGE
+
+
+def main() -> None:
+    system = platform.system()
+
+    project_name = get_project_name()
+    question_text = get_question_from_stdin()
+
+    notify_ntfy(title=project_name, message=question_text)
+
+    if system == "Windows":
+        sound_windows()
+        notify_windows(project_name, question_text)
+    elif is_wsl():
+        sound_wsl()
+        notify_wsl(project_name, question_text)
+    elif system == "Linux":
+        sound_linux()
+        notify_linux()
+    else:
+        print("\a", end="", flush=True)
+
+
+if __name__ == "__main__":
+    main()

package/hooks/notification/claude-notification-handler.py

@@ -0,0 +1,59 @@
+#!/usr/bin/env python3
+
+import json
+import os
+import platform
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from notification_utils import (
+    notify_ntfy,
+    is_wsl,
+    notify_windows,
+    notify_wsl,
+    sound_wsl,
+    sound_windows,
+    get_project_name,
+)
+
+
+def send_desktop_and_push_notification(
+    project_name: str,
+    notification_message: str,
+    ntfy_priority: str,
+) -> None:
+    notify_ntfy(title=project_name, message=notification_message, priority=ntfy_priority)
+    system = platform.system()
+    if system == "Windows":
+        sound_windows()
+        notify_windows(project_name, notification_message)
+    elif is_wsl():
+        sound_wsl()
+        notify_wsl(project_name, notification_message)
+
+
+def main() -> None:
+    try:
+        hook_input = json.load(sys.stdin)
+    except (json.JSONDecodeError, ValueError):
+        sys.exit(0)
+
+    notification_type = hook_input.get("notification_type", "")
+    notification_message = hook_input.get("message", "Claude needs attention")
+    project_name = get_project_name()
+
+    if notification_type == "idle_prompt":
+        send_desktop_and_push_notification(project_name, notification_message, ntfy_priority="default")
+    elif notification_type == "permission_prompt":
+        permission_message = f"[PERMISSION] {notification_message}"
+        send_desktop_and_push_notification(project_name, permission_message, ntfy_priority="high")
+    elif notification_type == "auth_success":
+        print(f"auth_success: {notification_message}", file=sys.stderr)
+    elif notification_type == "elicitation_dialog":
+        print(f"elicitation_dialog: {notification_message}", file=sys.stderr)
+
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()