claudia-mentor 0.5.3 → 0.5.4

package/hooks/hooks.json

@@ -78,7 +78,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/claudia-teach.py",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/claudia-milestones.py",
             "timeout": 10
           }
         ]
@@ -105,7 +105,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/claudia-milestones.py",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/claudia-teach.py",
             "timeout": 10
           }
         ]

package/hooks/scripts/check-accessibility.py

@@ -159,7 +159,7 @@ def main():
     if warnings:
         save_state(session_id, shown)
         message = "Claudia noticed some accessibility concerns:\n" + "\n".join(warnings)
-        output = json.dumps({"systemMessage": message})
+        output = json.dumps({"systemMessage": f"\033[38;5;209m{message}\033[0m"})
         print(output)
 
     sys.exit(0)

package/hooks/scripts/check-deps.py

@@ -109,7 +109,7 @@ def main():
     if warnings:
         save_state(session_id, shown)
         message = "Claudia noticed some dependency concerns:\n" + "\n".join(warnings)
-        output = json.dumps({"systemMessage": message})
+        output = json.dumps({"systemMessage": f"\033[38;5;209m{message}\033[0m"})
         print(output)
 
     sys.exit(0)

package/hooks/scripts/check-dockerfile.py

@@ -166,7 +166,7 @@ def main():
     if warnings:
         save_state(session_id, shown)
         message = "Claudia noticed some Dockerfile patterns worth reviewing:\n" + "\n".join(warnings)
-        output = json.dumps({"systemMessage": message})
+        output = json.dumps({"systemMessage": f"\033[38;5;209m{message}\033[0m"})
         print(output)
 
     sys.exit(0)

package/hooks/scripts/check-git-hygiene.py

@@ -134,7 +134,7 @@ def main():
     if warnings:
         save_state(session_id, shown)
         message = "Claudia noticed a git hygiene concern:\n" + "\n".join(warnings)
-        output = json.dumps({"systemMessage": message})
+        output = json.dumps({"systemMessage": f"\033[38;5;209m{message}\033[0m"})
         print(output)
 
     sys.exit(0)

package/hooks/scripts/check-license.py

@@ -156,7 +156,7 @@ def main():
     if warnings:
         save_state(session_id, shown)
         message = "Claudia noticed some license concerns:\n" + "\n".join(warnings)
-        output = json.dumps({"systemMessage": message})
+        output = json.dumps({"systemMessage": f"\033[38;5;209m{message}\033[0m"})
         print(output)
 
     sys.exit(0)

package/hooks/scripts/check-practices.py

@@ -159,7 +159,7 @@ def main():
         save_state(session_id, shown)
         # Advisory output via JSON on stdout (systemMessage)
         message = "Claudia noticed some patterns worth reviewing:\n" + "\n".join(warnings)
-        output = json.dumps({"systemMessage": message})
+        output = json.dumps({"systemMessage": f"\033[38;5;209m{message}\033[0m"})
         print(output)
 
     sys.exit(0)

package/hooks/scripts/check-secrets.sh

@@ -99,15 +99,17 @@ with open('$STATE_FILE', 'w') as f:
             echo "[\"${WARNING_KEY}\"]" > "$STATE_FILE"
         fi
 
-        # Block with explanation
-        echo "Claudia: ${description} in ${FILE_PATH}." >&2
+        # Block with explanation (vermillion colored)
+        C="\033[38;5;209m"
+        R="\033[0m"
+        echo -e "${C}Claudia: ${description} in ${FILE_PATH}.${R}" >&2
         echo "" >&2
-        echo "Secrets should never be hardcoded in source files. Use:" >&2
+        echo -e "${C}Secrets should never be hardcoded in source files. Use:" >&2
         echo "  - Environment variables (.env file, gitignored)" >&2
         echo "  - A secret manager (AWS SSM, Vault, Doppler)" >&2
-        echo "  - CI/CD secrets for pipelines" >&2
+        echo -e "  - CI/CD secrets for pipelines${R}" >&2
         echo "" >&2
-        echo "If this is intentionally a test fixture or example, rename the file to include 'test', 'example', or 'fixture'." >&2
+        echo -e "${C}If this is intentionally a test fixture or example, rename the file to include 'test', 'example', or 'fixture'.${R}" >&2
         exit 2
     fi
 done

package/hooks/scripts/claudia-compact-tip.py

@@ -103,7 +103,7 @@ def main():
         save_state(session_id, state)
         output = json.dumps({
             "additionalContext": tip,
-            "systemMessage": tip,
+            "systemMessage": f"\033[38;5;209m{tip}\033[0m",
         })
         print(output)
 

package/hooks/scripts/claudia-milestones.py

@@ -10,6 +10,7 @@ import json
 import os
 import re
 import sys
+import time
 
 # Milestone definitions: key, detection pattern, celebration message
 MILESTONES = {
@@ -55,6 +56,24 @@ MILESTONES = {
 STATE_FILE = os.path.expanduser("~/.claude/claudia-milestones.json")
 
 
+def stop_lock_acquire(session_id):
+    """Try to acquire the per-turn Stop hook lock. Returns True if acquired."""
+    lock_file = os.path.expanduser(f"~/.claude/claudia_stop_lock_{session_id}.tmp")
+    now = time.time()
+    try:
+        if os.path.exists(lock_file):
+            with open(lock_file) as f:
+                ts = float(f.read().strip())
+            if now - ts < 2.0:
+                return False  # Another hook already claimed this turn
+        os.makedirs(os.path.dirname(lock_file), exist_ok=True)
+        with open(lock_file, "w") as f:
+            f.write(str(now))
+        return True
+    except (IOError, ValueError):
+        return True  # On error, let it through
+
+
 def load_state():
     if os.path.exists(STATE_FILE):
         try:
@@ -147,12 +166,14 @@ def main():
     if celebration:
         state["achieved"] = list(achieved)
         save_state(state)
-        msg = f"Claudia: {celebration}"
-        output = json.dumps({
-            "additionalContext": msg,
-            "systemMessage": msg,
-        })
-        print(output)
+        session_id = input_data.get("session_id", "default")
+        if stop_lock_acquire(session_id):
+            msg = f"Claudia: {celebration}"
+            output = json.dumps({
+                "additionalContext": msg,
+                "systemMessage": f"\033[38;5;209m{msg}\033[0m",
+            })
+            print(output)
 
     # Save state even without celebration (for file_count tracking)
     elif new_files > 0:

package/hooks/scripts/claudia-next-steps.py

@@ -10,6 +10,7 @@ import json
 import os
 import re
 import sys
+import time
 
 # Completion signals
 COMPLETION_PATTERNS = [
@@ -74,6 +75,24 @@ NEXT_STEPS = {
     ],
 }
 
+def stop_lock_acquire(session_id):
+    """Try to acquire the per-turn Stop hook lock. Returns True if acquired."""
+    lock_file = os.path.expanduser(f"~/.claude/claudia_stop_lock_{session_id}.tmp")
+    now = time.time()
+    try:
+        if os.path.exists(lock_file):
+            with open(lock_file) as f:
+                ts = float(f.read().strip())
+            if now - ts < 2.0:
+                return False
+        os.makedirs(os.path.dirname(lock_file), exist_ok=True)
+        with open(lock_file, "w") as f:
+            f.write(str(now))
+        return True
+    except (IOError, ValueError):
+        return True
+
+
 # Pattern to extract filenames from the message
 FILENAME_PATTERN = r"[`'\"]?(\S+\.(\w{1,4}))[`'\"]?"
 
@@ -174,6 +193,9 @@ def main():
         else:
             formatted.append(step.replace(" {filename}", "").replace("{filename}", "the file"))
 
+    if not stop_lock_acquire(session_id):
+        sys.exit(0)
+
     state["count"] += 1
     save_state(session_id, state)
 
@@ -182,7 +204,7 @@ def main():
     )
     output = json.dumps({
         "additionalContext": suggestion_text,
-        "systemMessage": suggestion_text,
+        "systemMessage": f"\033[38;5;209m{suggestion_text}\033[0m",
     })
     print(output)
     sys.exit(0)

package/hooks/scripts/claudia-prompt-coach.py

@@ -176,7 +176,7 @@ def main():
         save_state(session_id, state)
         result = {"additionalContext": coaching_note}
         if user_msg:
-            result["systemMessage"] = user_msg
+            result["systemMessage"] = f"\033[38;5;209m{user_msg}\033[0m"
         print(json.dumps(result))
 
     sys.exit(0)

package/hooks/scripts/claudia-run-suggest.py

@@ -10,6 +10,7 @@ import json
 import os
 import re
 import sys
+import time
 
 # File type -> run suggestion
 RUN_SUGGESTIONS = {
@@ -28,6 +29,24 @@ FILE_PATTERNS = [
     r"(?:new file|writing to|saved to)\s+[`'\"]?(\S+\.(\w+))[`'\"]?",
 ]
 
+def stop_lock_acquire(session_id):
+    """Try to acquire the per-turn Stop hook lock. Returns True if acquired."""
+    lock_file = os.path.expanduser(f"~/.claude/claudia_stop_lock_{session_id}.tmp")
+    now = time.time()
+    try:
+        if os.path.exists(lock_file):
+            with open(lock_file) as f:
+                ts = float(f.read().strip())
+            if now - ts < 2.0:
+                return False
+        os.makedirs(os.path.dirname(lock_file), exist_ok=True)
+        with open(lock_file, "w") as f:
+            f.write(str(now))
+        return True
+    except (IOError, ValueError):
+        return True
+
+
 PACKAGE_JSON_PATTERN = r"(?:created|wrote|updated|modified)\s+[`'\"]?package\.json[`'\"]?"
 
 
@@ -105,12 +124,14 @@ def main():
 
     # Check for package.json mentions
     if "package.json" not in shown_types and re.search(PACKAGE_JSON_PATTERN, message, re.IGNORECASE):
+        if not stop_lock_acquire(session_id):
+            sys.exit(0)
         shown_types.add("package.json")
         state["shown_types"] = list(shown_types)
         save_state(session_id, state)
         suggestion = RUN_SUGGESTIONS["package.json"][1]
         msg = f"Claudia: {suggestion}"
-        output = json.dumps({"additionalContext": msg, "systemMessage": msg})
+        output = json.dumps({"additionalContext": msg, "systemMessage": f"\033[38;5;209m{msg}\033[0m"})
         print(output)
         sys.exit(0)
 
@@ -121,12 +142,14 @@ def main():
             filename = match.group(1)
             ext = match.group(2).lower()
             if ext in RUN_SUGGESTIONS and ext not in shown_types:
+                if not stop_lock_acquire(session_id):
+                    sys.exit(0)
                 shown_types.add(ext)
                 state["shown_types"] = list(shown_types)
                 save_state(session_id, state)
                 suggestion = RUN_SUGGESTIONS[ext][1].format(filename=filename)
                 msg = f"Claudia: {suggestion}"
-                output = json.dumps({"additionalContext": msg, "systemMessage": msg})
+                output = json.dumps({"additionalContext": msg, "systemMessage": f"\033[38;5;209m{msg}\033[0m"})
                 print(output)
                 sys.exit(0)
 

package/hooks/scripts/claudia-session-tips.py

@@ -188,7 +188,8 @@ def main():
         if tip:
             visible_parts.append(tip)
         if visible_parts:
-            result["systemMessage"] = " | ".join(visible_parts) if greeting and tip else visible_parts[0]
+            msg = " | ".join(visible_parts) if greeting and tip else visible_parts[0]
+            result["systemMessage"] = f"\033[38;5;209m{msg}\033[0m"
         print(json.dumps(result))
 
     sys.exit(0)

package/hooks/scripts/claudia-teach.py

@@ -12,6 +12,7 @@ import json
 import os
 import re
 import sys
+import time
 
 # Technology keywords by category
 KEYWORDS = {
@@ -77,6 +78,24 @@ ERROR_PATTERNS = [
     (r'\bReferenceError\b', "a reference error — usually a typo or missing variable"),
 ]
 
+def stop_lock_acquire(session_id):
+    """Try to acquire the per-turn Stop hook lock. Returns True if acquired."""
+    lock_file = os.path.expanduser(f"~/.claude/claudia_stop_lock_{session_id}.tmp")
+    now = time.time()
+    try:
+        if os.path.exists(lock_file):
+            with open(lock_file) as f:
+                ts = float(f.read().strip())
+            if now - ts < 2.0:
+                return False
+        os.makedirs(os.path.dirname(lock_file), exist_ok=True)
+        with open(lock_file, "w") as f:
+            f.write(str(now))
+        return True
+    except (IOError, ValueError):
+        return True
+
+
 # Contextual command reveals for beginners
 COMMAND_REVEALS = {
     "file_written": {
@@ -276,12 +295,14 @@ def main():
         state["shown_keywords"] = list(shown_keywords)
         state["revealed_commands"] = list(revealed_commands)
         save_state(session_id, state)
-        tip_text = "\n".join(f"Claudia: {tip}" for tip in tips)
-        output = json.dumps({
-            "additionalContext": tip_text,
-            "systemMessage": tip_text,
-        })
-        print(output)
+        if stop_lock_acquire(session_id):
+            tip_text = "\n".join(f"Claudia: {tip}" for tip in tips)
+            colored = "\n".join(f"\033[38;5;209m{line}\033[0m" for line in tip_text.split("\n"))
+            output = json.dumps({
+                "additionalContext": tip_text,
+                "systemMessage": colored,
+            })
+            print(output)
     elif shown_keywords != set(state["shown_keywords"]) or revealed_commands != set(state["revealed_commands"]):
         state["shown_keywords"] = list(shown_keywords)
         state["revealed_commands"] = list(revealed_commands)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudia-mentor",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "Proactive technology mentor, security advisor, and prompt coach for Claude Code",
   "author": "Regan O'Malley <regan@reganomalley.com>",
   "license": "MIT",