omni-cortex 1.5.0__py3-none-any.whl → 1.7.0__py3-none-any.whl

{omni_cortex-1.5.0.data → omni_cortex-1.7.0.data}/data/share/omni-cortex/dashboard/backend/chat_service.py

@@ -214,9 +214,13 @@ async def save_conversation(
     client = get_client()
     if client:
         try:
+            # Escape content to prevent injection in summary generation
+            safe_content = xml_escape(content[:2000])
             summary_prompt = f"""Summarize this conversation in one concise sentence (max 100 chars):
 
-{content[:2000]}
+<conversation>
+{safe_content}
+</conversation>
 
 Summary:"""
             response = client.models.generate_content(

{omni_cortex-1.5.0.data → omni_cortex-1.7.0.data}/data/share/omni-cortex/dashboard/backend/image_service.py

@@ -209,9 +209,9 @@ Tags: {', '.join(memory.tags) if memory.tags else 'N/A'}
             if preset_prompt:
                 parts.append(f"\nImage style guidance:\n{preset_prompt}")
 
-        # Add user's custom prompt
+        # Add user's custom prompt (escaped to prevent injection)
         if request.custom_prompt:
-            parts.append(f"\nUser request: {request.custom_prompt}")
+            parts.append(f"\nUser request: {xml_escape(request.custom_prompt)}")
 
         parts.append("\nGenerate a professional, high-quality image optimized for social media sharing.")
 
@@ -461,10 +461,10 @@ Tags: {', '.join(memory.tags) if memory.tags else 'N/A'}
                 "parts": parts
             })
 
-        # Add refinement prompt
+        # Add refinement prompt (escaped to prevent injection)
         contents.append({
             "role": "user",
-            "parts": [{"text": refinement_prompt}]
+            "parts": [{"text": xml_escape(refinement_prompt)}]
         })
 
         # Configure - use defaults or provided values

{omni_cortex-1.5.0.data → omni_cortex-1.7.0.data}/data/share/omni-cortex/dashboard/backend/main.py

@@ -135,6 +135,7 @@ class DatabaseChangeHandler(FileSystemEventHandler):
         self.loop = loop
         self._debounce_task: Optional[asyncio.Task] = None
         self._last_path: Optional[str] = None
+        self._last_activity_count: dict[str, int] = {}
 
     def on_modified(self, event):
         if event.src_path.endswith("cortex.db") or event.src_path.endswith("global.db"):
@@ -146,9 +147,35 @@ class DatabaseChangeHandler(FileSystemEventHandler):
                 )
 
     async def _debounced_notify(self):
-        await asyncio.sleep(0.5)  # Wait for rapid changes to settle
+        await asyncio.sleep(0.3)  # Reduced from 0.5s for faster updates
         if self._last_path:
-            await self.ws_manager.broadcast("database_changed", {"path": self._last_path})
+            db_path = self._last_path
+
+            # Broadcast general database change
+            await self.ws_manager.broadcast("database_changed", {"path": db_path})
+
+            # Fetch and broadcast latest activities (IndyDevDan pattern)
+            try:
+                # Get recent activities
+                recent = get_activities(db_path, limit=5, offset=0)
+                if recent:
+                    # Broadcast each new activity
+                    for activity in recent:
+                        await self.ws_manager.broadcast_activity_logged(
+                            db_path,
+                            activity if isinstance(activity, dict) else activity.model_dump()
+                        )
+
+                    # Also broadcast session update
+                    sessions = get_recent_sessions(db_path, limit=1)
+                    if sessions:
+                        session = sessions[0]
+                        await self.ws_manager.broadcast_session_updated(
+                            db_path,
+                            session if isinstance(session, dict) else dict(session)
+                        )
+            except Exception as e:
+                print(f"[WS] Error broadcasting activities: {e}")
 
 
 # File watcher

{omni_cortex-1.5.0.data → omni_cortex-1.7.0.data}/data/share/omni-cortex/dashboard/backend/websocket_manager.py

@@ -77,6 +77,28 @@ class WebSocketManager:
         """Get the number of active connections."""
         return len(self.connections)
 
+    # Typed broadcast methods (IndyDevDan pattern)
+    async def broadcast_activity_logged(self, project: str, activity: dict[str, Any]):
+        """Broadcast when a new activity is logged."""
+        await self.broadcast("activity_logged", {
+            "project": project,
+            "activity": activity,
+        })
+
+    async def broadcast_session_updated(self, project: str, session: dict[str, Any]):
+        """Broadcast when a session is updated."""
+        await self.broadcast("session_updated", {
+            "project": project,
+            "session": session,
+        })
+
+    async def broadcast_stats_updated(self, project: str, stats: dict[str, Any]):
+        """Broadcast when stats change (for charts/panels)."""
+        await self.broadcast("stats_updated", {
+            "project": project,
+            "stats": stats,
+        })
+
 
 # Global manager instance
 manager = WebSocketManager()

omni_cortex-1.7.0.data/data/share/omni-cortex/hooks/post_tool_use.py

@@ -0,0 +1,379 @@
+#!/usr/bin/env python3
+"""PostToolUse hook - logs tool result after execution.
+
+This hook is called by Claude Code after each tool completes.
+It logs the tool output, duration, and success/error status.
+
+Hook configuration for settings.json:
+{
+    "hooks": {
+        "PostToolUse": [
+            {
+                "type": "command",
+                "command": "python hooks/post_tool_use.py"
+            }
+        ]
+    }
+}
+"""
+
+import json
+import re
+import sys
+import os
+import sqlite3
+from datetime import datetime, timezone
+from pathlib import Path
+
+# Import shared session management
+from session_utils import get_or_create_session
+
+
+# Patterns for sensitive field names that should be redacted
+SENSITIVE_FIELD_PATTERNS = [
+    r'(?i)(api[_-]?key|apikey)',
+    r'(?i)(password|passwd|pwd)',
+    r'(?i)(secret|token|credential)',
+    r'(?i)(auth[_-]?token|access[_-]?token)',
+    r'(?i)(private[_-]?key|ssh[_-]?key)',
+]
+
+
+def redact_sensitive_fields(data: dict) -> dict:
+    """Redact sensitive fields from a dictionary for safe logging.
+
+    Recursively processes nested dicts and lists.
+    """
+    if not isinstance(data, dict):
+        return data
+
+    result = {}
+    for key, value in data.items():
+        # Check if key matches sensitive patterns
+        is_sensitive = any(
+            re.search(pattern, str(key))
+            for pattern in SENSITIVE_FIELD_PATTERNS
+        )
+
+        if is_sensitive:
+            result[key] = '[REDACTED]'
+        elif isinstance(value, dict):
+            result[key] = redact_sensitive_fields(value)
+        elif isinstance(value, list):
+            result[key] = [
+                redact_sensitive_fields(item) if isinstance(item, dict) else item
+                for item in value
+            ]
+        else:
+            result[key] = value
+
+    return result
+
+
+def get_db_path() -> Path:
+    """Get the database path for the current project."""
+    project_path = os.environ.get("CLAUDE_PROJECT_DIR", os.getcwd())
+    return Path(project_path) / ".omni-cortex" / "cortex.db"
+
+
+def ensure_database(db_path: Path) -> sqlite3.Connection:
+    """Ensure database exists and is initialized.
+
+    Auto-creates the database and schema if it doesn't exist.
+    This enables 'out of the box' functionality.
+    """
+    db_path.parent.mkdir(parents=True, exist_ok=True)
+    conn = sqlite3.connect(str(db_path))
+
+    # Check if schema exists
+    cursor = conn.cursor()
+    cursor.execute("SELECT name FROM sqlite_master WHERE type='table' AND name='activities'")
+    if cursor.fetchone() is None:
+        # Apply minimal schema for activities (full schema applied by MCP)
+        conn.executescript("""
+            CREATE TABLE IF NOT EXISTS activities (
+                id TEXT PRIMARY KEY,
+                session_id TEXT,
+                agent_id TEXT,
+                timestamp TEXT NOT NULL,
+                event_type TEXT NOT NULL,
+                tool_name TEXT,
+                tool_input TEXT,
+                tool_output TEXT,
+                duration_ms INTEGER,
+                success INTEGER DEFAULT 1,
+                error_message TEXT,
+                project_path TEXT,
+                file_path TEXT,
+                metadata TEXT
+            );
+            CREATE INDEX IF NOT EXISTS idx_activities_timestamp ON activities(timestamp DESC);
+            CREATE INDEX IF NOT EXISTS idx_activities_tool ON activities(tool_name);
+        """)
+        conn.commit()
+
+    return conn
+
+
+def generate_id() -> str:
+    """Generate a unique activity ID."""
+    timestamp_ms = int(datetime.now().timestamp() * 1000)
+    random_hex = os.urandom(4).hex()
+    return f"act_{timestamp_ms}_{random_hex}"
+
+
+def truncate(text: str, max_length: int = 10000) -> str:
+    """Truncate text to max length."""
+    if len(text) <= max_length:
+        return text
+    return text[:max_length - 20] + "\n... [truncated]"
+
+
+def extract_skill_info(tool_input: dict, project_path: str) -> tuple:
+    """Extract skill name and scope from Skill tool input.
+
+    Returns:
+        Tuple of (skill_name, command_scope)
+    """
+    try:
+        skill_name = tool_input.get("skill", "")
+        if not skill_name:
+            return None, None
+
+        # Determine scope by checking file locations
+        project_cmd = Path(project_path) / ".claude" / "commands" / f"{skill_name}.md"
+        if project_cmd.exists():
+            return skill_name, "project"
+
+        universal_cmd = Path.home() / ".claude" / "commands" / f"{skill_name}.md"
+        if universal_cmd.exists():
+            return skill_name, "universal"
+
+        return skill_name, "unknown"
+    except Exception:
+        return None, None
+
+
+def extract_mcp_server(tool_name: str) -> str:
+    """Extract MCP server name from tool name pattern mcp__servername__toolname."""
+    if not tool_name or not tool_name.startswith("mcp__"):
+        return None
+
+    parts = tool_name.split("__")
+    if len(parts) >= 3:
+        return parts[1]
+    return None
+
+
+def ensure_analytics_columns(conn: sqlite3.Connection) -> None:
+    """Ensure command analytics columns exist in activities table."""
+    cursor = conn.cursor()
+    columns = cursor.execute("PRAGMA table_info(activities)").fetchall()
+    column_names = [col[1] for col in columns]
+
+    new_columns = [
+        ("command_name", "TEXT"),
+        ("command_scope", "TEXT"),
+        ("mcp_server", "TEXT"),
+        ("skill_name", "TEXT"),
+        ("summary", "TEXT"),
+        ("summary_detail", "TEXT"),
+    ]
+
+    for col_name, col_type in new_columns:
+        if col_name not in column_names:
+            cursor.execute(f"ALTER TABLE activities ADD COLUMN {col_name} {col_type}")
+
+    conn.commit()
+
+
+def generate_summary(tool_name: str, tool_input: dict, success: bool) -> tuple:
+    """Generate short and detailed summaries for an activity.
+
+    Returns:
+        Tuple of (summary, summary_detail)
+    """
+    if not tool_name:
+        return None, None
+
+    input_data = tool_input if isinstance(tool_input, dict) else {}
+    short = ""
+    detail = ""
+
+    if tool_name == "Read":
+        path = input_data.get("file_path", "unknown")
+        filename = Path(path).name if path else "file"
+        short = f"Read file: {filename}"
+        detail = f"Reading contents of {path}"
+
+    elif tool_name == "Write":
+        path = input_data.get("file_path", "unknown")
+        filename = Path(path).name if path else "file"
+        short = f"Write file: {filename}"
+        detail = f"Writing/creating file at {path}"
+
+    elif tool_name == "Edit":
+        path = input_data.get("file_path", "unknown")
+        filename = Path(path).name if path else "file"
+        short = f"Edit file: {filename}"
+        detail = f"Editing {path}"
+
+    elif tool_name == "Bash":
+        cmd = str(input_data.get("command", ""))[:50]
+        short = f"Run: {cmd}..."
+        detail = f"Executing: {input_data.get('command', 'unknown')}"
+
+    elif tool_name == "Grep":
+        pattern = input_data.get("pattern", "")
+        short = f"Search: {pattern[:30]}"
+        detail = f"Searching for pattern: {pattern}"
+
+    elif tool_name == "Glob":
+        pattern = input_data.get("pattern", "")
+        short = f"Find files: {pattern[:30]}"
+        detail = f"Finding files matching: {pattern}"
+
+    elif tool_name == "Skill":
+        skill = input_data.get("skill", "unknown")
+        short = f"Run skill: /{skill}"
+        detail = f"Executing slash command /{skill}"
+
+    elif tool_name == "Task":
+        desc = input_data.get("description", "task")
+        short = f"Spawn agent: {desc[:30]}"
+        detail = f"Launching sub-agent: {desc}"
+
+    elif tool_name == "TodoWrite":
+        todos = input_data.get("todos", [])
+        count = len(todos) if isinstance(todos, list) else 0
+        short = f"Update todo: {count} items"
+        detail = f"Managing task list with {count} items"
+
+    elif tool_name.startswith("mcp__"):
+        parts = tool_name.split("__")
+        server = parts[1] if len(parts) > 1 else "unknown"
+        tool = parts[2] if len(parts) > 2 else tool_name
+        short = f"MCP: {server}/{tool}"
+        detail = f"Calling {tool} from MCP server {server}"
+
+    else:
+        short = f"Tool: {tool_name}"
+        detail = f"Using tool {tool_name}"
+
+    if not success:
+        short = f"[FAILED] {short}"
+        detail = f"[FAILED] {detail}"
+
+    return short, detail
+
+
+def main():
+    """Process PostToolUse hook."""
+    try:
+        # Read all input at once (more reliable than json.load on stdin)
+        raw_input = sys.stdin.read()
+        if not raw_input or not raw_input.strip():
+            print(json.dumps({}))
+            return
+
+        input_data = json.loads(raw_input)
+
+        # Extract data from hook input
+        tool_name = input_data.get("tool_name")
+        tool_input = input_data.get("tool_input", {})
+        tool_output = input_data.get("tool_output", {})
+        agent_id = input_data.get("agent_id")
+
+        # Determine success/error
+        is_error = input_data.get("is_error", False)
+        error_message = None
+        if is_error and isinstance(tool_output, dict):
+            error_message = tool_output.get("error") or tool_output.get("message")
+
+        # Skip logging our own tools to prevent recursion
+        # MCP tools are named like "mcp__omni-cortex__cortex_remember"
+        if tool_name and ("cortex_" in tool_name or "omni-cortex" in tool_name):
+            print(json.dumps({}))
+            return
+
+        project_path = os.environ.get("CLAUDE_PROJECT_DIR", os.getcwd())
+
+        # Auto-initialize database (creates if not exists)
+        db_path = get_db_path()
+        conn = ensure_database(db_path)
+
+        # Ensure analytics columns exist
+        ensure_analytics_columns(conn)
+
+        # Get or create session (auto-manages session lifecycle)
+        session_id = get_or_create_session(conn, project_path)
+
+        # Redact sensitive fields before logging
+        safe_input = redact_sensitive_fields(tool_input) if isinstance(tool_input, dict) else tool_input
+        safe_output = redact_sensitive_fields(tool_output) if isinstance(tool_output, dict) else tool_output
+
+        # Extract command analytics
+        skill_name = None
+        command_scope = None
+        mcp_server = None
+
+        # Extract skill info from Skill tool calls
+        if tool_name == "Skill" and isinstance(tool_input, dict):
+            skill_name, command_scope = extract_skill_info(tool_input, project_path)
+
+        # Extract MCP server from tool name (mcp__servername__toolname pattern)
+        if tool_name and tool_name.startswith("mcp__"):
+            mcp_server = extract_mcp_server(tool_name)
+
+        # Generate summary for activity
+        summary = None
+        summary_detail = None
+        try:
+            summary, summary_detail = generate_summary(tool_name, safe_input, not is_error)
+        except Exception:
+            pass
+
+        # Insert activity record with analytics columns
+        cursor = conn.cursor()
+        cursor.execute(
+            """
+            INSERT INTO activities (
+                id, session_id, agent_id, timestamp, event_type,
+                tool_name, tool_input, tool_output, success, error_message, project_path,
+                skill_name, command_scope, mcp_server, summary, summary_detail
+            ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+            """,
+            (
+                generate_id(),
+                session_id,
+                agent_id,
+                datetime.now(timezone.utc).isoformat(),
+                "post_tool_use",
+                tool_name,
+                truncate(json.dumps(safe_input, default=str)),
+                truncate(json.dumps(safe_output, default=str)),
+                0 if is_error else 1,
+                error_message,
+                project_path,
+                skill_name,
+                command_scope,
+                mcp_server,
+                summary,
+                summary_detail,
+            ),
+        )
+        conn.commit()
+        conn.close()
+
+        # Return empty response (no modification)
+        print(json.dumps({}))
+
+    except Exception as e:
+        # Hooks should never block - log error but continue
+        print(json.dumps({"systemMessage": f"Cortex post_tool_use: {e}"}))
+
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

{omni_cortex-1.5.0.data → omni_cortex-1.7.0.data}/data/share/omni-cortex/hooks/pre_tool_use.py

@@ -25,6 +25,9 @@ import sqlite3
 from datetime import datetime, timezone
 from pathlib import Path
 
+# Import shared session management
+from session_utils import get_or_create_session
+
 
 # Patterns for sensitive field names that should be redacted
 SENSITIVE_FIELD_PATTERNS = [
@@ -157,13 +160,15 @@ def main():
             print(json.dumps({}))
             return
 
-        session_id = os.environ.get("CLAUDE_SESSION_ID")
         project_path = os.environ.get("CLAUDE_PROJECT_DIR", os.getcwd())
 
         # Auto-initialize database (creates if not exists)
         db_path = get_db_path()
         conn = ensure_database(db_path)
 
+        # Get or create session (auto-manages session lifecycle)
+        session_id = get_or_create_session(conn, project_path)
+
         # Redact sensitive fields before logging
         safe_input = redact_sensitive_fields(tool_input) if isinstance(tool_input, dict) else tool_input
 

omni_cortex-1.7.0.data/data/share/omni-cortex/hooks/session_utils.py

@@ -0,0 +1,186 @@
+#!/usr/bin/env python3
+"""Shared session management utilities for Claude Code hooks.
+
+This module provides session management functionality that can be shared
+across pre_tool_use.py and post_tool_use.py hooks to ensure consistent
+session tracking.
+
+Session Management Logic:
+1. Check for existing session file at `.omni-cortex/current_session.json`
+2. If session exists and is valid (not timed out), use it
+3. If no valid session, create a new one in both file and database
+4. Update last_activity_at on each use to track session activity
+"""
+
+import json
+import os
+import sqlite3
+import time
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Optional
+
+
+# Session timeout in seconds (4 hours of inactivity = new session)
+SESSION_TIMEOUT_SECONDS = 4 * 60 * 60
+
+
+def generate_session_id() -> str:
+    """Generate a unique session ID matching the MCP format.
+
+    Returns:
+        Session ID in format: sess_{timestamp_ms}_{random_hex}
+    """
+    timestamp_ms = int(time.time() * 1000)
+    random_hex = os.urandom(4).hex()
+    return f"sess_{timestamp_ms}_{random_hex}"
+
+
+def get_session_file_path() -> Path:
+    """Get the path to the current session file.
+
+    Returns:
+        Path to .omni-cortex/current_session.json
+    """
+    project_path = os.environ.get("CLAUDE_PROJECT_DIR", os.getcwd())
+    return Path(project_path) / ".omni-cortex" / "current_session.json"
+
+
+def load_session_file() -> Optional[dict]:
+    """Load the current session from file if it exists.
+
+    Returns:
+        Session data dict or None if file doesn't exist or is invalid
+    """
+    session_file = get_session_file_path()
+    if not session_file.exists():
+        return None
+
+    try:
+        with open(session_file, "r") as f:
+            return json.load(f)
+    except (json.JSONDecodeError, IOError):
+        return None
+
+
+def save_session_file(session_data: dict) -> None:
+    """Save the current session to file.
+
+    Args:
+        session_data: Dict containing session_id, project_path, started_at, last_activity_at
+    """
+    session_file = get_session_file_path()
+    session_file.parent.mkdir(parents=True, exist_ok=True)
+
+    with open(session_file, "w") as f:
+        json.dump(session_data, f, indent=2)
+
+
+def is_session_valid(session_data: dict) -> bool:
+    """Check if a session is still valid (not timed out).
+
+    A session is valid if:
+    - It has a last_activity_at timestamp
+    - The timestamp is within SESSION_TIMEOUT_SECONDS of now
+
+    Args:
+        session_data: Session dict with last_activity_at field
+
+    Returns:
+        True if session is valid, False otherwise
+    """
+    last_activity = session_data.get("last_activity_at")
+    if not last_activity:
+        return False
+
+    try:
+        last_time = datetime.fromisoformat(last_activity.replace("Z", "+00:00"))
+        now = datetime.now(timezone.utc)
+        elapsed_seconds = (now - last_time).total_seconds()
+        return elapsed_seconds < SESSION_TIMEOUT_SECONDS
+    except (ValueError, TypeError):
+        return False
+
+
+def create_session_in_db(conn: sqlite3.Connection, session_id: str, project_path: str) -> None:
+    """Create a new session record in the database.
+
+    Also creates the sessions table if it doesn't exist (for first-run scenarios).
+
+    Args:
+        conn: SQLite database connection
+        session_id: The session ID to create
+        project_path: The project directory path
+    """
+    cursor = conn.cursor()
+    now = datetime.now(timezone.utc).isoformat()
+
+    # Check if sessions table exists (it might not if only activities table was created)
+    cursor.execute("SELECT name FROM sqlite_master WHERE type='table' AND name='sessions'")
+    if cursor.fetchone() is None:
+        # Create sessions table with minimal schema
+        conn.executescript("""
+            CREATE TABLE IF NOT EXISTS sessions (
+                id TEXT PRIMARY KEY,
+                project_path TEXT NOT NULL,
+                started_at TEXT NOT NULL,
+                ended_at TEXT,
+                summary TEXT,
+                tags TEXT,
+                metadata TEXT
+            );
+            CREATE INDEX IF NOT EXISTS idx_sessions_started ON sessions(started_at DESC);
+            CREATE INDEX IF NOT EXISTS idx_sessions_project ON sessions(project_path);
+        """)
+        conn.commit()
+
+    cursor.execute(
+        """
+        INSERT OR IGNORE INTO sessions (id, project_path, started_at)
+        VALUES (?, ?, ?)
+        """,
+        (session_id, project_path, now),
+    )
+    conn.commit()
+
+
+def get_or_create_session(conn: sqlite3.Connection, project_path: str) -> str:
+    """Get the current session ID, creating a new one if needed.
+
+    Session management logic:
+    1. Check for existing session file
+    2. If exists and not timed out, use it and update last_activity
+    3. If doesn't exist or timed out, create new session
+
+    Args:
+        conn: SQLite database connection
+        project_path: The project directory path
+
+    Returns:
+        The session ID to use for activity logging
+    """
+    session_data = load_session_file()
+    now_iso = datetime.now(timezone.utc).isoformat()
+
+    if session_data and is_session_valid(session_data):
+        # Update last activity time
+        session_data["last_activity_at"] = now_iso
+        save_session_file(session_data)
+        return session_data["session_id"]
+
+    # Create new session
+    session_id = generate_session_id()
+
+    # Create in database
+    create_session_in_db(conn, session_id, project_path)
+
+    # Save to file
+    session_data = {
+        "session_id": session_id,
+        "project_path": project_path,
+        "started_at": now_iso,
+        "last_activity_at": now_iso,
+    }
+    save_session_file(session_data)
+
+    return session_id

{omni_cortex-1.5.0.dist-info → omni_cortex-1.7.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: omni-cortex
-Version: 1.5.0
+Version: 1.7.0
 Summary: Give Claude Code a perfect memory - auto-logs everything, searches smartly, and gets smarter over time
 Project-URL: Homepage, https://github.com/AllCytes/Omni-Cortex
 Project-URL: Repository, https://github.com/AllCytes/Omni-Cortex
@@ -294,18 +294,47 @@ The PDFs use a light theme with blue/purple/green accents. Edit `docs/create_pdf
 
 ## Development
 
+### Quick Setup (with Claude Code)
+
+If you're using Claude Code, just run:
+
+```bash
+/dev-setup
+```
+
+This will guide you through setting up the development environment.
+
+### Manual Setup
+
 ```bash
-# Install dev dependencies
-pip install -e ".[dev]"
+# Clone and install in editable mode
+git clone https://github.com/AllCytes/Omni-Cortex.git
+cd Omni-Cortex
+pip install -e .
+
+# Install dashboard dependencies
+cd dashboard/backend && pip install -r requirements.txt
+cd ../frontend && npm install
+cd ../..
+
+# Verify installation
+omni-cortex --help
+omni-cortex-dashboard --help
+```
 
-# Run tests
+**Important**: Always use `pip install -e .` (editable mode) so changes are immediately reflected without reinstalling.
+
+### Running Tests
+
+```bash
 pytest
 
-# Format code
-black src tests
-ruff check src tests
+# With coverage
+pytest --cov=src/omni_cortex
 ```
 
+See [CONTRIBUTING.md](CONTRIBUTING.md) for full development guidelines.
+
 ## Security
 
 Omni Cortex v1.0.3 has been security reviewed:

omni_cortex-1.7.0.dist-info/RECORD

@@ -0,0 +1,25 @@
+omni_cortex-1.7.0.data/data/share/omni-cortex/hooks/post_tool_use.py,sha256=yBLoYvEdUunbG8fclzIEWszCptworkUUcOUSKzNsvms,12271
+omni_cortex-1.7.0.data/data/share/omni-cortex/hooks/pre_tool_use.py,sha256=mkZ7eeBnjWkIgNnrqfYSXIhhLNYYk4hQx_6F0pNrGoc,6395
+omni_cortex-1.7.0.data/data/share/omni-cortex/hooks/session_utils.py,sha256=3SKPCytqWuRPOupWdzmwBoKBDJqtLcT1Nle_pueDQUY,5746
+omni_cortex-1.7.0.data/data/share/omni-cortex/hooks/stop.py,sha256=T1bwcmbTLj0gzjrVvFBT1zB6wff4J2YkYBAY-ZxZI5g,5336
+omni_cortex-1.7.0.data/data/share/omni-cortex/hooks/subagent_stop.py,sha256=V9HQSFGNOfkg8ZCstPEy4h5V8BP4AbrVr8teFzN1kNk,3314
+omni_cortex-1.7.0.data/data/share/omni-cortex/dashboard/backend/.env.example,sha256=LenAe1A9dnwaS5UaRFPR0m_dghUcjsK-yMXZTSLIL8o,667
+omni_cortex-1.7.0.data/data/share/omni-cortex/dashboard/backend/backfill_summaries.py,sha256=ElchfcBv4pmVr2PsePCgFlCyuvf4_jDJj_C3AmMhu7U,8973
+omni_cortex-1.7.0.data/data/share/omni-cortex/dashboard/backend/chat_service.py,sha256=2Dfxlj0xwR47EI1jrbOF8t1E0m_OaXl-wdJoo6rqiHE,9187
+omni_cortex-1.7.0.data/data/share/omni-cortex/dashboard/backend/database.py,sha256=Zh4Hl5I0DTZCosWIvkOYpo3Nyta8f54vnj72giDQ8vE,34942
+omni_cortex-1.7.0.data/data/share/omni-cortex/dashboard/backend/image_service.py,sha256=wkWjUtLTLqIFgJ9WU99O8IWDvEUbv9-P8pizkV-TvhM,19059
+omni_cortex-1.7.0.data/data/share/omni-cortex/dashboard/backend/logging_config.py,sha256=WnunFGET9zlsn9WBpVsio2zI7BiUQanE0xzAQQxIhII,3944
+omni_cortex-1.7.0.data/data/share/omni-cortex/dashboard/backend/main.py,sha256=-sJg8GIOzX07xuUxvE6cZ6THqLblA0ObxQiOyNfvrFk,37232
+omni_cortex-1.7.0.data/data/share/omni-cortex/dashboard/backend/models.py,sha256=Lv_qIrDNRlQNiveRwDrlhVz1QTeWD4DPpr5BBuA5Ty0,5968
+omni_cortex-1.7.0.data/data/share/omni-cortex/dashboard/backend/project_config.py,sha256=ZxGoeRpHvN5qQyf2hRxrAZiHrPSwdQp59f0di6O1LKM,4352
+omni_cortex-1.7.0.data/data/share/omni-cortex/dashboard/backend/project_scanner.py,sha256=lwFXS8iJbOoxf7FAyo2TjH25neaMHiJ8B3jS57XxtDI,5713
+omni_cortex-1.7.0.data/data/share/omni-cortex/dashboard/backend/prompt_security.py,sha256=LcdZhYy1CfpSq_4BPO6lMJ15phc2ZXLUSBAnAvODVCI,3423
+omni_cortex-1.7.0.data/data/share/omni-cortex/dashboard/backend/pyproject.toml,sha256=9pbbGQXLe1Xd06nZAtDySCHIlfMWvPaB-C6tGZR6umc,502
+omni_cortex-1.7.0.data/data/share/omni-cortex/dashboard/backend/security.py,sha256=nQsoPE0n5dtY9ive00d33W1gL48GgK7C5Ae0BK2oW2k,3479
+omni_cortex-1.7.0.data/data/share/omni-cortex/dashboard/backend/uv.lock,sha256=miB9zGGSirBkjDE-OZTPCnv43Yc98xuAz_Ne8vTNFHg,186004
+omni_cortex-1.7.0.data/data/share/omni-cortex/dashboard/backend/websocket_manager.py,sha256=ABXAtlhBI5vnTcwdQUS-UQcDyTn-rWZL5OKEP9YY-kU,3619
+omni_cortex-1.7.0.dist-info/METADATA,sha256=Oij28FeAaP2iylNabfycTMGdR2ynLdhia8T0OGB_GAc,10521
+omni_cortex-1.7.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+omni_cortex-1.7.0.dist-info/entry_points.txt,sha256=rohx4mFH2ffZmMb9QXPZmFf-ZGjA3jpKVDVeET-ttiM,150
+omni_cortex-1.7.0.dist-info/licenses/LICENSE,sha256=oG_397owMmi-Umxp5sYocJ6RPohp9_bDNnnEu9OUphg,1072
+omni_cortex-1.7.0.dist-info/RECORD,,

omni_cortex-1.5.0.data/data/share/omni-cortex/hooks/post_tool_use.py

@@ -1,160 +0,0 @@
-#!/usr/bin/env python3
-"""PostToolUse hook - logs tool result after execution.
-
-This hook is called by Claude Code after each tool completes.
-It logs the tool output, duration, and success/error status.
-
-Hook configuration for settings.json:
-{
-    "hooks": {
-        "PostToolUse": [
-            {
-                "type": "command",
-                "command": "python hooks/post_tool_use.py"
-            }
-        ]
-    }
-}
-"""
-
-import json
-import sys
-import os
-import sqlite3
-from datetime import datetime, timezone
-from pathlib import Path
-
-
-def get_db_path() -> Path:
-    """Get the database path for the current project."""
-    project_path = os.environ.get("CLAUDE_PROJECT_DIR", os.getcwd())
-    return Path(project_path) / ".omni-cortex" / "cortex.db"
-
-
-def ensure_database(db_path: Path) -> sqlite3.Connection:
-    """Ensure database exists and is initialized.
-
-    Auto-creates the database and schema if it doesn't exist.
-    This enables 'out of the box' functionality.
-    """
-    db_path.parent.mkdir(parents=True, exist_ok=True)
-    conn = sqlite3.connect(str(db_path))
-
-    # Check if schema exists
-    cursor = conn.cursor()
-    cursor.execute("SELECT name FROM sqlite_master WHERE type='table' AND name='activities'")
-    if cursor.fetchone() is None:
-        # Apply minimal schema for activities (full schema applied by MCP)
-        conn.executescript("""
-            CREATE TABLE IF NOT EXISTS activities (
-                id TEXT PRIMARY KEY,
-                session_id TEXT,
-                agent_id TEXT,
-                timestamp TEXT NOT NULL,
-                event_type TEXT NOT NULL,
-                tool_name TEXT,
-                tool_input TEXT,
-                tool_output TEXT,
-                duration_ms INTEGER,
-                success INTEGER DEFAULT 1,
-                error_message TEXT,
-                project_path TEXT,
-                file_path TEXT,
-                metadata TEXT
-            );
-            CREATE INDEX IF NOT EXISTS idx_activities_timestamp ON activities(timestamp DESC);
-            CREATE INDEX IF NOT EXISTS idx_activities_tool ON activities(tool_name);
-        """)
-        conn.commit()
-
-    return conn
-
-
-def generate_id() -> str:
-    """Generate a unique activity ID."""
-    timestamp_ms = int(datetime.now().timestamp() * 1000)
-    random_hex = os.urandom(4).hex()
-    return f"act_{timestamp_ms}_{random_hex}"
-
-
-def truncate(text: str, max_length: int = 10000) -> str:
-    """Truncate text to max length."""
-    if len(text) <= max_length:
-        return text
-    return text[:max_length - 20] + "\n... [truncated]"
-
-
-def main():
-    """Process PostToolUse hook."""
-    try:
-        # Read all input at once (more reliable than json.load on stdin)
-        raw_input = sys.stdin.read()
-        if not raw_input or not raw_input.strip():
-            print(json.dumps({}))
-            return
-
-        input_data = json.loads(raw_input)
-
-        # Extract data from hook input
-        tool_name = input_data.get("tool_name")
-        tool_input = input_data.get("tool_input", {})
-        tool_output = input_data.get("tool_output", {})
-        agent_id = input_data.get("agent_id")
-
-        # Determine success/error
-        is_error = input_data.get("is_error", False)
-        error_message = None
-        if is_error and isinstance(tool_output, dict):
-            error_message = tool_output.get("error") or tool_output.get("message")
-
-        # Skip logging our own tools to prevent recursion
-        # MCP tools are named like "mcp__omni-cortex__cortex_remember"
-        if tool_name and ("cortex_" in tool_name or "omni-cortex" in tool_name):
-            print(json.dumps({}))
-            return
-
-        session_id = os.environ.get("CLAUDE_SESSION_ID")
-        project_path = os.environ.get("CLAUDE_PROJECT_DIR", os.getcwd())
-
-        # Auto-initialize database (creates if not exists)
-        db_path = get_db_path()
-        conn = ensure_database(db_path)
-
-        # Insert activity record
-        cursor = conn.cursor()
-        cursor.execute(
-            """
-            INSERT INTO activities (
-                id, session_id, agent_id, timestamp, event_type,
-                tool_name, tool_input, tool_output, success, error_message, project_path
-            ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-            """,
-            (
-                generate_id(),
-                session_id,
-                agent_id,
-                datetime.now(timezone.utc).isoformat(),
-                "post_tool_use",
-                tool_name,
-                truncate(json.dumps(tool_input, default=str)),
-                truncate(json.dumps(tool_output, default=str)),
-                0 if is_error else 1,
-                error_message,
-                project_path,
-            ),
-        )
-        conn.commit()
-        conn.close()
-
-        # Return empty response (no modification)
-        print(json.dumps({}))
-
-    except Exception as e:
-        # Hooks should never block - log error but continue
-        print(json.dumps({"systemMessage": f"Cortex post_tool_use: {e}"}))
-
-    sys.exit(0)
-
-
-if __name__ == "__main__":
-    main()

omni_cortex-1.5.0.dist-info/RECORD

@@ -1,24 +0,0 @@
-omni_cortex-1.5.0.data/data/share/omni-cortex/hooks/post_tool_use.py,sha256=zXy30KNDW6UoWP0nwq5n320r1wFa-tE6V4QuSdDzx8w,5106
-omni_cortex-1.5.0.data/data/share/omni-cortex/hooks/pre_tool_use.py,sha256=PUNza7KJTYEM6XIYNOyMQsaF1OsCqOg0eed55Y3XS8U,6239
-omni_cortex-1.5.0.data/data/share/omni-cortex/hooks/stop.py,sha256=T1bwcmbTLj0gzjrVvFBT1zB6wff4J2YkYBAY-ZxZI5g,5336
-omni_cortex-1.5.0.data/data/share/omni-cortex/hooks/subagent_stop.py,sha256=V9HQSFGNOfkg8ZCstPEy4h5V8BP4AbrVr8teFzN1kNk,3314
-omni_cortex-1.5.0.data/data/share/omni-cortex/dashboard/backend/.env.example,sha256=LenAe1A9dnwaS5UaRFPR0m_dghUcjsK-yMXZTSLIL8o,667
-omni_cortex-1.5.0.data/data/share/omni-cortex/dashboard/backend/backfill_summaries.py,sha256=ElchfcBv4pmVr2PsePCgFlCyuvf4_jDJj_C3AmMhu7U,8973
-omni_cortex-1.5.0.data/data/share/omni-cortex/dashboard/backend/chat_service.py,sha256=CMncxkmdVDYvFOIw8_LhPUdao3aNs_fq063t1SdiwtY,9032
-omni_cortex-1.5.0.data/data/share/omni-cortex/dashboard/backend/database.py,sha256=Zh4Hl5I0DTZCosWIvkOYpo3Nyta8f54vnj72giDQ8vE,34942
-omni_cortex-1.5.0.data/data/share/omni-cortex/dashboard/backend/image_service.py,sha256=e8PWZCmYLxOYcAmcqT8UUe8P5qvGP73W9sWbkRwm0Vs,18973
-omni_cortex-1.5.0.data/data/share/omni-cortex/dashboard/backend/logging_config.py,sha256=WnunFGET9zlsn9WBpVsio2zI7BiUQanE0xzAQQxIhII,3944
-omni_cortex-1.5.0.data/data/share/omni-cortex/dashboard/backend/main.py,sha256=FezQeopiivfE_qyLfYH-bPEQb6HW0049ExQprBd0tQ0,36022
-omni_cortex-1.5.0.data/data/share/omni-cortex/dashboard/backend/models.py,sha256=Lv_qIrDNRlQNiveRwDrlhVz1QTeWD4DPpr5BBuA5Ty0,5968
-omni_cortex-1.5.0.data/data/share/omni-cortex/dashboard/backend/project_config.py,sha256=ZxGoeRpHvN5qQyf2hRxrAZiHrPSwdQp59f0di6O1LKM,4352
-omni_cortex-1.5.0.data/data/share/omni-cortex/dashboard/backend/project_scanner.py,sha256=lwFXS8iJbOoxf7FAyo2TjH25neaMHiJ8B3jS57XxtDI,5713
-omni_cortex-1.5.0.data/data/share/omni-cortex/dashboard/backend/prompt_security.py,sha256=LcdZhYy1CfpSq_4BPO6lMJ15phc2ZXLUSBAnAvODVCI,3423
-omni_cortex-1.5.0.data/data/share/omni-cortex/dashboard/backend/pyproject.toml,sha256=9pbbGQXLe1Xd06nZAtDySCHIlfMWvPaB-C6tGZR6umc,502
-omni_cortex-1.5.0.data/data/share/omni-cortex/dashboard/backend/security.py,sha256=nQsoPE0n5dtY9ive00d33W1gL48GgK7C5Ae0BK2oW2k,3479
-omni_cortex-1.5.0.data/data/share/omni-cortex/dashboard/backend/uv.lock,sha256=miB9zGGSirBkjDE-OZTPCnv43Yc98xuAz_Ne8vTNFHg,186004
-omni_cortex-1.5.0.data/data/share/omni-cortex/dashboard/backend/websocket_manager.py,sha256=fv16XkRkgN4SDNwTiP_p9qFnWta9lIpAXgKbFETZ7uM,2770
-omni_cortex-1.5.0.dist-info/METADATA,sha256=LCn_zYyFwx7S5pSn7xV4tgnlQ0ePJHrhRcJeYYcStHQ,9855
-omni_cortex-1.5.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-omni_cortex-1.5.0.dist-info/entry_points.txt,sha256=rohx4mFH2ffZmMb9QXPZmFf-ZGjA3jpKVDVeET-ttiM,150
-omni_cortex-1.5.0.dist-info/licenses/LICENSE,sha256=oG_397owMmi-Umxp5sYocJ6RPohp9_bDNnnEu9OUphg,1072
-omni_cortex-1.5.0.dist-info/RECORD,,