claudia-mentor 0.5.3 → 0.5.6

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

@@ -101,9 +101,9 @@ def main():
 
     if tip:
         save_state(session_id, state)
+        # Only systemMessage here -- additionalContext gets wiped by compaction
         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

@@ -9,6 +9,7 @@ Advisory only (exit 0 with additionalContext), never blocks.
 import json
 import os
 import random
+import subprocess
 import sys
 
 # Pool of startup tips for beginners
@@ -30,6 +31,64 @@ COMPACT_TIP = (
     "conversation details. If you need to re-explain something, that's normal."
 )
 
+
+def gather_project_context():
+    """Read claudia-context.json, milestones, and git state to rebuild context after compaction."""
+    parts = []
+
+    # Stack and decisions from context file
+    context_path = os.path.expanduser("~/.claude/claudia-context.json")
+    if os.path.exists(context_path):
+        try:
+            with open(context_path) as f:
+                ctx = json.load(f)
+            stack = ctx.get("stack", {})
+            decisions = ctx.get("decisions", [])
+            experience = ctx.get("experience", "intermediate")
+            if stack:
+                parts.append(f"Project stack: {json.dumps(stack)}")
+            if decisions:
+                parts.append("Decisions made this session: " + "; ".join(str(d) for d in decisions[-5:]))
+            if experience == "beginner":
+                parts.append("User experience level: beginner. Use simple language, explain jargon.")
+        except (json.JSONDecodeError, IOError):
+            pass
+
+    # Milestones achieved
+    milestones_path = os.path.expanduser("~/.claude/claudia-milestones.json")
+    if os.path.exists(milestones_path):
+        try:
+            with open(milestones_path) as f:
+                ms = json.load(f)
+            achieved = ms.get("achieved", [])
+            if achieved:
+                parts.append(f"Milestones achieved: {', '.join(achieved)}")
+        except (json.JSONDecodeError, IOError):
+            pass
+
+    # Recent git activity
+    try:
+        log = subprocess.run(
+            ["git", "log", "--oneline", "-5"],
+            capture_output=True, text=True, timeout=5
+        )
+        if log.returncode == 0 and log.stdout.strip():
+            parts.append(f"Recent commits:\n{log.stdout.strip()}")
+    except (subprocess.TimeoutExpired, FileNotFoundError):
+        pass
+
+    try:
+        status = subprocess.run(
+            ["git", "status", "--short"],
+            capture_output=True, text=True, timeout=5
+        )
+        if status.returncode == 0 and status.stdout.strip():
+            parts.append(f"Uncommitted changes:\n{status.stdout.strip()}")
+    except (subprocess.TimeoutExpired, FileNotFoundError):
+        pass
+
+    return "\n".join(parts) if parts else None
+
 # Beginner greeting — no command list, just reassurance
 BEGINNER_GREETING = (
     "IMPORTANT — Claudia plugin is loaded. On this very first response, "
@@ -161,15 +220,41 @@ def main():
             state.setdefault("shown_tips_history", []).append(tip_text)
             tip = f"\U0001f4a1 Claudia tip: {tip_text}"
 
-    elif source == "compact" and is_beginner:
-        if not state.get("shown_compact_tip"):
+    elif source == "compact":
+        # Re-inject project context after compaction (this survives because
+        # SessionStart fires AFTER compaction completes)
+        project_ctx = gather_project_context()
+        if project_ctx:
+            context_injection = (
+                "Claudia context recovery: The conversation was just compacted. "
+                "Here is what Claudia knows about the current project and session:\n\n"
+                + project_ctx
+                + "\n\nUse this context to stay grounded. Don't mention compaction unless the user asks."
+            )
+            # Prepend to greeting so it goes into additionalContext
+            greeting = context_injection
+
+        if is_beginner and not state.get("shown_compact_tip"):
             state["shown_compact_tip"] = True
             tip = f"\U0001f4a1 Claudia: {COMPACT_TIP}"
+        elif not is_beginner:
+            tip = "\U0001f4a1 Claudia: Context compacted. I've caught Claude up on your project."
 
     elif source == "resume":
+        # Re-inject context on resume too
+        project_ctx = gather_project_context()
+        if project_ctx:
+            context_injection = (
+                "Claudia context recovery: This is a resumed session. "
+                "Here is what Claudia knows about the current project:\n\n"
+                + project_ctx
+                + "\n\nUse this context to stay grounded."
+            )
+            greeting = context_injection
+
         if not state.get("shown_resume_tip"):
             state["shown_resume_tip"] = True
-            tip = "\U0001f4a1 Claudia: Welcome back. I'm still watching."
+            tip = "\U0001f4a1 Claudia: Welcome back. I've caught Claude up on your project."
 
     # source == "clear": no tip needed
 
@@ -188,7 +273,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.6",
   "description": "Proactive technology mentor, security advisor, and prompt coach for Claude Code",
   "author": "Regan O'Malley <regan@reganomalley.com>",
   "license": "MIT",