get-claudia 1.40.1 → 1.40.2

package/memory-daemon/claudia_memory/__main__.py

@@ -207,13 +207,17 @@ def run_daemon(mcp_mode: bool = True, debug: bool = False, project_id: str = Non
         db.initialize()
         logger.info(f"Database initialized at {get_config().db_path}")
 
-        # Start health server
-        start_health_server()
-        logger.info(f"Health server started on port {get_config().health_port}")
-
-        # Start background scheduler
-        start_scheduler()
-        logger.info("Background scheduler started")
+        # Start health server and scheduler - ONLY in standalone mode.
+        # MCP server processes are ephemeral and session-bound; the standalone
+        # daemon (LaunchAgent/systemd) owns port 3848 and handles scheduling.
+        # Starting these here in MCP mode causes [Errno 48] Address already in
+        # use and double-scheduling alongside the running standalone daemon.
+        if not mcp_mode:
+            start_health_server()
+            logger.info(f"Health server started on port {get_config().health_port}")
+
+            start_scheduler()
+            logger.info("Background scheduler started")
 
         if mcp_mode:
             # Run MCP server (blocks until stdin closes)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "get-claudia",
-  "version": "1.40.1",
+  "version": "1.40.2",
   "description": "An AI assistant who learns how you work.",
   "keywords": [
     "claudia",

package/template-v2/.claude/hooks/session-health-check.py

@@ -51,6 +51,23 @@ def _get_status_summary():
         return None
 
 
+def _read_user_profile():
+    """Read context/me.md from CLAUDE_PROJECT_DIR if it exists. Returns snippet or empty string."""
+    project_dir = os.environ.get('CLAUDE_PROJECT_DIR', '')
+    if not project_dir:
+        return ''
+    me_path = Path(project_dir) / 'context' / 'me.md'
+    if not me_path.exists():
+        return ''
+    try:
+        content = me_path.read_text(encoding='utf-8', errors='replace')
+        if len(content) > 2000:
+            content = content[:2000]
+        return f'\n\nUser profile (from context/me.md):\n{content}'
+    except OSError:
+        return ''
+
+
 def check_health():
     context_parts = []
 
@@ -102,6 +119,7 @@ def check_health():
                 pass
             if restarted:
                 status_msg = _get_status_summary()
+                user_profile = _read_user_profile()
                 msg = (
                     "IMPORTANT: Memory daemon was stopped and has been auto-restarted. "
                     "However, the memory MCP tools (mcp__claudia-memory__*) are NOT available in this session "
@@ -113,6 +131,7 @@ def check_health():
                 )
                 if status_msg:
                     msg = f"{msg} Daemon status: {status_msg}"
+                msg = msg + user_profile
                 print(json.dumps({"additionalContext": msg}))
                 return
             context_parts.append(
@@ -146,6 +165,7 @@ def check_health():
                 pass
             if restarted:
                 status_msg = _get_status_summary()
+                user_profile = _read_user_profile()
                 msg = (
                     "IMPORTANT: Memory daemon was stopped and has been auto-restarted. "
                     "However, the memory MCP tools (mcp__claudia-memory__*) are NOT available in this session "
@@ -157,6 +177,7 @@ def check_health():
                 )
                 if status_msg:
                     msg = f"{msg} Daemon status: {status_msg}"
+                msg = msg + user_profile
                 print(json.dumps({"additionalContext": msg}))
                 return
             context_parts.append(
@@ -210,7 +231,8 @@ def check_health():
             pass
 
     output = " ".join(context_parts)
-    print(json.dumps({"additionalContext": output}))
+    user_profile = _read_user_profile()
+    print(json.dumps({"additionalContext": output + user_profile}))
 
 
 if __name__ == "__main__":

package/template-v2/.claude/hooks/session-health-check.sh

@@ -50,6 +50,27 @@ except Exception:
   exit 0
 fi
 
+# Helper: emit JSON for unhealthy-daemon states, appending context/me.md if available
+emit_with_profile() {
+  local MSG="$1"
+  local PROFILE=""
+  if [ -n "${CLAUDE_PROJECT_DIR:-}" ] && [ -f "${CLAUDE_PROJECT_DIR}/context/me.md" ]; then
+    PROFILE=$(head -c 2000 "${CLAUDE_PROJECT_DIR}/context/me.md" 2>/dev/null || true)
+  fi
+  if [ -n "$PROFILE" ] && command -v python3 &>/dev/null; then
+    CLAUDIA_MSG="$MSG" CLAUDIA_PROFILE="$PROFILE" python3 -c "
+import json, os
+msg = os.environ.get('CLAUDIA_MSG', '')
+profile = os.environ.get('CLAUDIA_PROFILE', '')
+if profile:
+    msg = msg + '\n\nUser profile (from context/me.md):\n' + profile
+print(json.dumps({'additionalContext': msg}))"
+  else
+    MSG_ESC=$(echo "$MSG" | sed 's/"/\\"/g')
+    echo "{\"additionalContext\": \"$MSG_ESC\"}"
+  fi
+}
+
 # Daemon is NOT healthy. Figure out why and provide actionable guidance.
 CONTEXT="IMPORTANT: Memory daemon is NOT running. Without it, you lose semantic search, pattern detection, cross-session learning, and proactive predictions. You MUST surface this to the user and offer to help fix it."
 
@@ -83,8 +104,7 @@ except Exception:
       if [ -n "$STATUS_SUMMARY" ]; then
         MSG="$MSG Daemon status: $STATUS_SUMMARY"
       fi
-      STATUS_ESC=$(echo "$MSG" | sed 's/"/\\"/g')
-      echo "{\"additionalContext\": \"$STATUS_ESC\"}"
+      emit_with_profile "$MSG"
       exit 0
     fi
     CONTEXT="$CONTEXT Daemon is installed (LaunchAgent exists) but could not be auto-restarted. Suggest: 'Your memory daemon is stopped. Please run: launchctl load ~/Library/LaunchAgents/com.claudia.memory.plist'"
@@ -120,8 +140,7 @@ except Exception:
       if [ -n "$STATUS_SUMMARY" ]; then
         MSG="$MSG Daemon status: $STATUS_SUMMARY"
       fi
-      STATUS_ESC=$(echo "$MSG" | sed 's/"/\\"/g')
-      echo "{\"additionalContext\": \"$STATUS_ESC\"}"
+      emit_with_profile "$MSG"
       exit 0
     fi
     CONTEXT="$CONTEXT Daemon is installed (systemd service exists) but could not be auto-restarted. Suggest: 'Your memory daemon is stopped. Please run: systemctl --user restart claudia-memory'"
@@ -149,5 +168,5 @@ if [ -f "$HOME/.claudia/daemon-stderr.log" ]; then
   fi
 fi
 
-echo "{\"additionalContext\": \"$CONTEXT\"}"
+emit_with_profile "$CONTEXT"
 exit 0

package/template-v2/.claude/rules/claudia-principles.md

@@ -372,6 +372,7 @@ Even without the explicit command, these principles apply whenever I'm processin
 - Make moral judgments about users
 - Share information inappropriately
 - Use em dashes (the hallmark of lazy AI writing)
+- Reference internal implementation details in conversation: skill files, rule files, hook names, MCP tool IDs (like `mcp__claudia-memory__*`), or internal system names. These are part of who I am - I follow them silently without narrating them.
 
 ---
 

package/template-v2/.claude/rules/memory-availability.md

@@ -1,6 +1,6 @@
 # Memory Availability Rule
 
-This rule is always active and applies to every session.
+This rule is always active and applies to every session. Follow it silently - do not cite this file, mention rule names, or reference internal tool IDs in your response to the user.
 
 ---
 
@@ -39,13 +39,8 @@ The user only needs to do one thing: **restart Claude Code**. The daemon auto-re
 
 ---
 
-## Why This Matters
+## Background (for context only, not to be surfaced verbatim)
 
-The most common cause of missing memory tools is not a crashed daemon but a **registration timing issue**: the daemon was restarted (auto or manually) after the current Claude Code session started. MCP tools connect at session initialization, not dynamically. The daemon is up; the tools just aren't registered yet.
+The most common cause of missing memory tools is a registration timing issue, not a crashed daemon. MCP tools register at session initialization. If the daemon restarted after the session started, the tools simply aren't registered yet - the daemon is up, but a Claude Code restart is the only fix.
 
-Silently using `plugin:episodic-memory` as a fallback:
-1. Gives the wrong data (different memory system, different scope)
-2. Makes it look like memory is working when it isn't
-3. Prevents the user from knowing they need to restart
-
-Always be transparent about the degraded state.
+Substituting with another memory plugin gives the wrong data from a different system and hides the real problem from the user. The honest answer is always to acknowledge the degraded state and point to the one action that fixes it.

package/template-v2/CLAUDE.md

@@ -80,20 +80,19 @@ Check for `context/me.md` at the start of any session. If it doesn't exist, this
 
 At the start of every session (after confirming `context/me.md` exists):
 
-1. **Verify memory tools** - Check that `memory.*` MCP tools are available in your tool list
-   - If NO memory tools: **Don't just warn. Offer to fix it.** Check the session-health-check hook output:
-     - Daemon installed but stopped → Offer to start it (platform-specific command)
-     - Daemon not installed → Offer to run the installer
-     - Briefly explain what's lost: semantic search, pattern detection, cross-session learning, proactive predictions
-     - If user agrees to start it, they'll need to restart Claude Code afterward for MCP tools to register
-   - If memory tools present: Continue to step 2
+1. **Check available tools** - Look for `memory.*` tools in your available tool list BEFORE greeting.
+   - If memory tools ARE present: continue to step 2
+   - If memory tools are NOT present:
+     a. Read `context/me.md` directly using the Read tool -- do this IMMEDIATELY as your first action, before saying anything to the user
+     b. Also read `context/commitments.md`, `context/learnings.md`, `context/patterns.md`, `context/waiting.md`
+     c. Greet the user naturally using whatever context you found in those files
+     d. Let them know memory tools aren't connected and ask if they want to troubleshoot
+     e. If they already restarted Claude Code and tools are STILL missing, the issue is likely MCP configuration (not a timing issue). Suggest running `/diagnose` to check.
 2. **Load context** - Call `memory.session` (operation: "context") to get recent memories, predictions, commitments, and unsummarized session alerts
    - If this call fails: The daemon may have crashed. Suggest checking `~/.claudia/daemon-stderr.log`
 3. **Catch up** - If unsummarized sessions are reported, generate retroactive summaries using `memory.end_session`
 4. **Greet naturally** - Use the loaded context to inform your greeting and surface urgent items
 
-**Fallback mode:** If memory tools aren't available and the user declines to start the daemon, read markdown context files directly (`context/*.md`). This provides basic continuity but no semantic search, pattern detection, or cross-session learning. Always inform the user they're in degraded mode.
-
 ### Returning User Greetings
 
 When `context/me.md` exists, I greet them personally using what I know. **Every greeting starts with my logo**, followed by a personalized message.