nexo-brain 1.3.0 → 1.4.0

package/src/scripts/check-context.py

@@ -0,0 +1,257 @@
+#!/usr/bin/env python3
+"""Context checker for NEXO operations - prevents duplicate actions.
+
+Mechanical checks (email sent, file exists, action done) run in Python.
+When the 'smart' command is used, passes context to Claude CLI for
+intelligent duplicate/conflict detection that goes beyond file checks.
+"""
+
+import os
+import sys
+import json
+import hashlib
+import subprocess
+from datetime import datetime
+from pathlib import Path
+
+CLAUDE_CLI = Path.home() / ".local" / "bin" / "claude"
+
+class ContextChecker:
+    def __init__(self):
+        self.state_dir = Path.home() / 'claude' / 'state'
+        self.state_dir.mkdir(exist_ok=True)
+        
+    def check_email_sent(self, to_addr, subject, since_hours=72):
+        """Check if email was already sent to address with subject."""
+        sent_path = Path.home() / 'mail' / '.nexo-sent' / '.Sent'  # Configure for your mail setup
+        if not sent_path.exists():
+            return False
+
+        subject_lower = subject.lower()
+        to_lower = to_addr.lower()
+        cutoff = datetime.now().timestamp() - (since_hours * 3600)
+        cur_dir = sent_path / 'cur'
+        if not cur_dir.exists():
+            return False
+
+        for msg_file in cur_dir.iterdir():
+            try:
+                if msg_file.stat().st_mtime < cutoff:
+                    continue
+                content = msg_file.read_text(errors='ignore')
+            except (OSError, UnicodeDecodeError):
+                continue
+
+            content_lower = content.lower()
+            if f"to:{to_lower}" in content_lower or f"to: {to_lower}" in content_lower:
+                if subject_lower in content_lower:
+                    return True
+        return False
+        
+    def check_file_exists(self, pattern, search_dirs=None):
+        """Check if file matching pattern exists in common locations."""
+        if search_dirs is None:
+            search_dirs = [
+                '/var/www/vhosts',
+                str(Path.home() / 'claude'),
+                '/opt'
+            ]
+            
+        for base_dir in search_dirs:
+            if not os.path.exists(base_dir):
+                continue
+            matches = []
+            try:
+                for root, _, files in os.walk(base_dir):
+                    for filename in files:
+                        if pattern in filename:
+                            matches.append(str(Path(root) / filename))
+                            if len(matches) >= 5:
+                                return matches
+            except OSError:
+                continue
+        return []
+        
+    def check_action_done(self, action_type, identifier, ttl_days=7):
+        """Check if action was already performed recently."""
+        action_file = self.state_dir / 'actions.json'
+        
+        # Load existing actions
+        actions = {}
+        if action_file.exists():
+            with open(action_file) as f:
+                actions = json.load(f)
+                
+        # Create action key
+        key = hashlib.md5(f"{action_type}:{identifier}".encode()).hexdigest()
+        
+        # Check if exists and not expired
+        if key in actions:
+            action_time = datetime.fromisoformat(actions[key]['timestamp'])
+            age_days = (datetime.now() - action_time).days
+            if age_days < ttl_days:
+                return True, actions[key]
+                
+        return False, None
+        
+    def mark_action_done(self, action_type, identifier, metadata=None):
+        """Mark action as completed."""
+        action_file = self.state_dir / 'actions.json'
+        
+        # Load existing actions
+        actions = {}
+        if action_file.exists():
+            with open(action_file) as f:
+                actions = json.load(f)
+                
+        # Add new action
+        key = hashlib.md5(f"{action_type}:{identifier}".encode()).hexdigest()
+        actions[key] = {
+            'type': action_type,
+            'identifier': identifier,
+            'timestamp': datetime.now().isoformat(),
+            'metadata': metadata or {}
+        }
+        
+        # Save
+        with open(action_file, 'w') as f:
+            json.dump(actions, f, indent=2)
+            
+        return key
+
+def smart_check(action_description: str, context: str = "") -> dict:
+    """Use Claude CLI to intelligently check if an action would be redundant.
+
+    Goes beyond simple file/hash checks — understands intent and context
+    to detect semantic duplicates (e.g., "send welcome email" vs
+    "email onboarding message" to same person).
+    """
+    checker = ContextChecker()
+
+    # Gather mechanical context first
+    state_file = checker.state_dir / 'actions.json'
+    recent_actions = {}
+    if state_file.exists():
+        try:
+            all_actions = json.loads(state_file.read_text())
+            cutoff = datetime.now().timestamp() - (7 * 86400)
+            for k, v in all_actions.items():
+                try:
+                    ts = datetime.fromisoformat(v['timestamp']).timestamp()
+                    if ts > cutoff:
+                        recent_actions[k] = v
+                except (ValueError, KeyError):
+                    pass
+        except Exception:
+            pass
+
+    if not CLAUDE_CLI.exists():
+        return {"redundant": False, "reason": "CLI unavailable, cannot smart-check"}
+
+    prompt = f"""You are a context deduplication engine for NEXO operations.
+
+PROPOSED ACTION:
+{action_description}
+
+ADDITIONAL CONTEXT:
+{context or "None"}
+
+RECENT ACTIONS (last 7 days):
+{json.dumps(list(recent_actions.values()), indent=1, default=str)}
+
+Respond with ONLY valid JSON (no markdown):
+{{
+  "redundant": true/false,
+  "confidence": 0.0-1.0,
+  "reason": "<one line explanation>",
+  "matching_action": "<identifier of matching action if redundant, else null>"
+}}
+
+Rules:
+- Same recipient + same intent within 72h = redundant
+- Same file modification with same content = redundant
+- Similar but different scope (e.g., different recipients) = NOT redundant
+- When in doubt, say not redundant (false negatives are cheaper than false positives)"""
+
+    env = os.environ.copy()
+    env.pop("CLAUDECODE", None)
+    env.pop("CLAUDE_CODE", None)
+
+    try:
+        result = subprocess.run(
+            [str(CLAUDE_CLI), "-p", prompt, "--model", "opus",
+             "--allowedTools", "Read,Write,Edit,Glob,Grep"],
+            capture_output=True, text=True, timeout=60, env=env
+        )
+        if result.returncode == 0:
+            text = result.stdout.strip()
+            if "```json" in text:
+                text = text.split("```json")[1].split("```")[0]
+            elif "```" in text:
+                text = text.split("```")[1].split("```")[0]
+            return json.loads(text.strip())
+    except Exception:
+        pass
+
+    return {"redundant": False, "reason": "CLI check failed, defaulting to not redundant"}
+
+
+def main():
+    """CLI interface for context checking."""
+    if len(sys.argv) < 3:
+        print("Usage: check-context.py <command> <args>")
+        print("Commands:")
+        print("  email <to> <subject>       - Check if email was sent")
+        print("  file <pattern>             - Check if file exists")
+        print("  action <type> <id>         - Check if action was done")
+        print("  smart <description> [ctx]  - Intelligent duplicate check via CLI")
+        sys.exit(1)
+
+    checker = ContextChecker()
+    command = sys.argv[1]
+
+    if command == 'email':
+        if len(sys.argv) < 4:
+            print("Usage: check-context.py email <to> <subject>")
+            sys.exit(1)
+        exists = checker.check_email_sent(sys.argv[2], sys.argv[3])
+        print("EXISTS" if exists else "NOT_FOUND")
+        sys.exit(0 if not exists else 1)
+
+    elif command == 'file':
+        files = checker.check_file_exists(sys.argv[2])
+        if files:
+            print("\n".join(files))
+            sys.exit(1)
+        else:
+            print("NOT_FOUND")
+            sys.exit(0)
+
+    elif command == 'action':
+        if len(sys.argv) < 4:
+            print("Usage: check-context.py action <type> <id>")
+            sys.exit(1)
+        done, data = checker.check_action_done(sys.argv[2], sys.argv[3])
+        if done:
+            print(f"DONE: {data}")
+            sys.exit(1)
+        else:
+            print("NOT_DONE")
+            sys.exit(0)
+
+    elif command == 'smart':
+        if len(sys.argv) < 3:
+            print("Usage: check-context.py smart <description> [context]")
+            sys.exit(1)
+        description = sys.argv[2]
+        context = sys.argv[3] if len(sys.argv) > 3 else ""
+        result = smart_check(description, context)
+        print(json.dumps(result, indent=2))
+        sys.exit(1 if result.get("redundant") else 0)
+
+    else:
+        print(f"Unknown command: {command}")
+        sys.exit(1)
+
+if __name__ == '__main__':
+    main()

package/src/scripts/nexo-catchup.py

@@ -24,16 +24,17 @@ import sys
 from datetime import datetime, timedelta
 from pathlib import Path
 
+CLAUDE_CLI = Path.home() / ".local" / "bin" / "claude"
+
 HOME = Path.home()
-NEXO_HOME = os.environ.get("NEXO_HOME", str(Path.home() / ".nexo"))
-LOG_DIR = HOME / "claude" / "logs"
+LOG_DIR = HOME / ".nexo" / "logs"
 LOG_DIR.mkdir(parents=True, exist_ok=True)
 LOG_FILE = LOG_DIR / "catchup.log"
-STATE_FILE = HOME / "claude" / "operations" / ".catchup-state.json"
+STATE_FILE = HOME / ".nexo" / "operations" / ".catchup-state.json"
 
 PYTHON_BREW = "/opt/homebrew/bin/python3"
 PYTHON_SYS = "/Library/Frameworks/Python.framework/Versions/3.12/bin/python3"
-SCRIPTS = HOME / "claude" / "scripts"
+SCRIPTS = HOME / ".nexo" / "scripts"
 
 
 def log(msg: str):
@@ -140,7 +141,7 @@ def main():
             subprocess.run(
                 [PYTHON_BREW if os.path.exists(PYTHON_BREW) else PYTHON_SYS, str(update_script)],
                 capture_output=True, text=True, timeout=60,
-                env={**os.environ, "HOME": str(HOME), "NEXO_HOME": NEXO_HOME}
+                env={**os.environ, "HOME": str(HOME), "NEXO_HOME": str(HOME / ".nexo")}
             )
         except Exception as e:
             log(f"  Update check failed: {e}")
@@ -167,11 +168,64 @@ def main():
 
     if ran == 0:
         log("All tasks up to date, nothing to catch up.")
+    elif ran >= 3:
+        # Many tasks caught up — ask CLI to assess system state
+        _cli_post_catchup_assessment(ran, skipped, state)
     else:
         log(f"Caught up {ran} tasks, {skipped} already current.")
 
     log("=== Catch-Up complete ===")
 
 
+def _cli_post_catchup_assessment(ran: int, skipped: int, state: dict):
+    """When 3+ tasks were missed, use CLI to assess if there are concerns."""
+    if not CLAUDE_CLI.exists():
+        log(f"Caught up {ran} tasks, {skipped} already current. (CLI unavailable for assessment)")
+        return
+
+    assessment_file = LOG_DIR / "catchup-assessment.md"
+    state_summary = json.dumps(state, indent=2, default=str)
+
+    prompt = f"""You are the NEXO Catch-Up system. The Mac was off/asleep and {ran} scheduled tasks just ran as catch-up ({skipped} were already current).
+
+Task run state (timestamps of last successful runs):
+{state_summary}
+
+Assess:
+1. How long was the system likely offline? (compare timestamps to now)
+2. Are there any tasks that depend on each other where order matters?
+3. Any tasks that may have produced stale results because they ran late?
+4. Should any task be re-run at its normal time today?
+
+Write a brief assessment (max 20 lines) to: {assessment_file}
+
+Format:
+## Catch-Up Assessment — {datetime.now().strftime('%Y-%m-%d %H:%M')}
+- Offline duration: ~Xh
+- Tasks caught up: {ran}
+- Concerns: ...
+- Recommendation: ..."""
+
+    log(f"Caught up {ran} tasks — running CLI assessment...")
+    env = os.environ.copy()
+    env.pop("CLAUDECODE", None)
+    env.pop("CLAUDE_CODE", None)
+
+    try:
+        result = subprocess.run(
+            [str(CLAUDE_CLI), "-p", prompt, "--model", "opus",
+             "--allowedTools", "Read,Write,Edit,Glob,Grep"],
+            capture_output=True, text=True, timeout=90, env=env
+        )
+        if result.returncode == 0:
+            log(f"Assessment written to {assessment_file}")
+        else:
+            log(f"CLI assessment exited {result.returncode}")
+    except subprocess.TimeoutExpired:
+        log("CLI assessment timed out (90s)")
+    except Exception as e:
+        log(f"CLI assessment error: {e}")
+
+
 if __name__ == "__main__":
     main()