empathy-framework 5.3.0__py3-none-any.whl → 5.4.0__py3-none-any.whl

empathy_os/cli/commands/inspect.py

@@ -1,436 +0,0 @@
-"""Inspect commands for patterns, metrics, and interactive REPL.
-
-Copyright 2025 Smart-AI-Memory
-Licensed under Fair Source License 0.9
-"""
-
-import heapq
-import sys
-import time
-
-from empathy_os.config import EmpathyConfig, _validate_file_path, load_config
-from empathy_os.core import EmpathyOS
-from empathy_os.logging_config import get_logger
-from empathy_os.metrics.collector import MetricsCollector
-from empathy_os.pattern_library import PatternLibrary
-from empathy_os.persistence import PatternPersistence, StateManager
-
-logger = get_logger(__name__)
-
-
-def cmd_run(args):
-    """Interactive REPL for testing empathy interactions.
-
-    Starts an interactive session for testing empathy levels and features.
-
-    Args:
-        args: Namespace object from argparse with attributes:
-            - config (str | None): Path to configuration file.
-            - user_id (str | None): User ID (default: cli_user).
-            - level (int): Target empathy level (1-5).
-
-    Returns:
-        None: Runs interactive REPL until user exits.
-    """
-    config_file = args.config
-    user_id = args.user_id or "cli_user"
-    level = args.level
-
-    print("🧠 Empathy Framework - Interactive Mode")
-    print("=" * 50)
-
-    # Load configuration
-    if config_file:
-        config = load_config(filepath=config_file)
-        print(f"✓ Loaded config from: {config_file}")
-    else:
-        config = EmpathyConfig(user_id=user_id, target_level=level)
-        print("✓ Using default configuration")
-
-    print(f"\nUser ID: {config.user_id}")
-    print(f"Target Level: {config.target_level}")
-    print(f"Confidence Threshold: {config.confidence_threshold:.0%}")
-
-    # Create EmpathyOS instance
-    try:
-        empathy = EmpathyOS(
-            user_id=config.user_id,
-            target_level=config.target_level,
-            confidence_threshold=config.confidence_threshold,
-            persistence_enabled=config.persistence_enabled,
-        )
-        print("✓ Empathy OS initialized")
-    except ValueError as e:
-        # Invalid configuration parameters
-        print(f"✗ Configuration error: {e}")
-        sys.exit(1)
-    except (OSError, FileNotFoundError, PermissionError) as e:
-        # Cannot access required files/directories
-        print(f"✗ File system error: {e}")
-        sys.exit(1)
-    except Exception as e:
-        # Unexpected initialization failure
-        logger.exception(f"Unexpected error initializing Empathy OS: {e}")
-        print(f"✗ Failed to initialize Empathy OS: {e}")
-        sys.exit(1)
-
-    print("\n" + "=" * 50)
-    print("Type your input (or 'exit'/'quit' to stop)")
-    print("Type 'help' for available commands")
-    print("=" * 50 + "\n")
-
-    # Interactive loop
-    while True:
-        try:
-            user_input = input("You: ").strip()
-
-            if not user_input:
-                continue
-
-            if user_input.lower() in ["exit", "quit", "q"]:
-                print("\n👋 Goodbye!")
-                break
-
-            if user_input.lower() == "help":
-                print("\nAvailable commands:")
-                print("  exit, quit, q - Exit the program")
-                print("  help - Show this help message")
-                print("  trust - Show current trust level")
-                print("  stats - Show session statistics")
-                print("  level - Show current empathy level")
-                print()
-                continue
-
-            if user_input.lower() == "trust":
-                trust = empathy.collaboration_state.trust_level
-                print(f"\n  Current trust level: {trust:.0%}\n")
-                continue
-
-            if user_input.lower() == "level":
-                current_level = empathy.collaboration_state.current_level
-                print(f"\n  Current empathy level: {current_level}\n")
-                continue
-
-            if user_input.lower() == "stats":
-                print("\n  Session Statistics:")
-                print(f"    Trust: {empathy.collaboration_state.trust_level:.0%}")
-                print(f"    Current Level: {empathy.collaboration_state.current_level}")
-                print(f"    Target Level: {config.target_level}")
-                print()
-                continue
-
-            # Process interaction
-            start_time = time.time()
-            response = empathy.interact(user_id=config.user_id, user_input=user_input, context={})
-            duration = (time.time() - start_time) * 1000
-
-            # Display response with level indicator
-            level_indicators = ["❌", "🔵", "🟢", "🟡", "🔮"]
-            level_indicator = level_indicators[response.level]
-
-            print(f"\nBot {level_indicator} [L{response.level}]: {response.response}")
-
-            # Show predictions if Level 4
-            if response.predictions:
-                print("\n🔮 Predictions:")
-                for pred in response.predictions:
-                    print(f"   • {pred}")
-
-            conf = f"{response.confidence:.0%}"
-            print(f"\n  Level: {response.level} | Confidence: {conf} | Time: {duration:.0f}ms")
-            print()
-
-            # Ask for feedback
-            feedback = input("Was this helpful? (y/n/skip): ").strip().lower()
-            if feedback == "y":
-                empathy.record_success(success=True)
-                trust = empathy.collaboration_state.trust_level
-                print(f"  ✓ Trust increased to {trust:.0%}\n")
-            elif feedback == "n":
-                empathy.record_success(success=False)
-                trust = empathy.collaboration_state.trust_level
-                print(f"  ✗ Trust decreased to {trust:.0%}\n")
-
-        except KeyboardInterrupt:
-            print("\n\n👋 Goodbye!")
-            break
-        except (ValueError, KeyError) as e:
-            # Invalid input or response structure
-            print(f"\n✗ Input error: {e}\n")
-        except Exception as e:
-            # Unexpected errors in interactive loop - log and continue
-            logger.exception(f"Unexpected error in interactive loop: {e}")
-            print(f"\n✗ Error: {e}\n")
-
-
-def cmd_inspect(args):
-    """Unified inspection command for patterns, metrics, and state.
-
-    Inspect various framework data including patterns, user metrics, and states.
-
-    Args:
-        args: Namespace object from argparse with attributes:
-            - type (str): What to inspect ('patterns', 'metrics', or 'state').
-            - user_id (str | None): Filter by user ID.
-            - db (str | None): Database path (default: .empathy/patterns.db).
-            - state_dir (str | None): State directory for state inspection.
-
-    Returns:
-        None: Prints inspection results. Exits with code 1 on failure.
-    """
-    inspect_type = args.type
-    user_id = args.user_id
-    db_path = args.db or ".empathy/patterns.db"
-
-    print(f"🔍 Inspecting: {inspect_type}")
-    print("=" * 50)
-
-    if inspect_type == "patterns":
-        try:
-            # Determine file format from extension
-            if db_path.endswith(".json"):
-                library = PatternPersistence.load_from_json(db_path)
-            else:
-                library = PatternPersistence.load_from_sqlite(db_path)
-
-            patterns = list(library.patterns.values())
-
-            # Filter by user_id if specified
-            if user_id:
-                patterns = [p for p in patterns if p.agent_id == user_id]
-
-            print(f"\nPatterns for {'user ' + user_id if user_id else 'all users'}:")
-            print(f"  Total patterns: {len(patterns)}")
-
-            if patterns:
-                print("\n  Top patterns:")
-                # Sort by confidence
-                top_patterns = heapq.nlargest(10, patterns, key=lambda p: p.confidence)
-                for i, pattern in enumerate(top_patterns, 1):
-                    print(f"\n  {i}. {pattern.name}")
-                    print(f"     Confidence: {pattern.confidence:.0%}")
-                    print(f"     Used: {pattern.usage_count} times")
-                    print(f"     Success rate: {pattern.success_rate:.0%}")
-        except FileNotFoundError:
-            print(f"✗ Pattern library not found: {db_path}")
-            print("  Tip: Use 'empathy-framework workflow' to set up your first project")
-            sys.exit(1)
-        except (ValueError, KeyError) as e:
-            # Invalid pattern data format
-            print(f"✗ Invalid pattern data: {e}")
-            sys.exit(1)
-        except Exception as e:
-            # Unexpected errors loading patterns
-            logger.exception(f"Unexpected error loading patterns: {e}")
-            print(f"✗ Failed to load patterns: {e}")
-            sys.exit(1)
-
-    elif inspect_type == "metrics":
-        if not user_id:
-            print("✗ User ID required for metrics inspection")
-            print("  Usage: empathy-framework inspect metrics --user-id USER_ID")
-            sys.exit(1)
-
-        try:
-            collector = MetricsCollector(db_path=db_path)
-            stats = collector.get_user_stats(user_id)
-
-            print(f"\nMetrics for user: {user_id}")
-            print(f"  Total operations: {stats.get('total_operations', 0)}")
-            print(f"  Success rate: {stats.get('success_rate', 0):.0%}")
-            print(f"  Average response time: {stats.get('avg_response_time_ms', 0):.0f}ms")
-            print("\n  Empathy level usage:")
-            for level in range(1, 6):
-                count = stats.get(f"level_{level}_count", 0)
-                print(f"    Level {level}: {count} times")
-        except (OSError, FileNotFoundError) as e:
-            # Database file not found
-            print(f"✗ Metrics database not found: {e}")
-            sys.exit(1)
-        except KeyError as e:
-            # User not found
-            print(f"✗ User {user_id} not found: {e}")
-            sys.exit(1)
-        except Exception as e:
-            # Unexpected errors loading metrics
-            logger.exception(f"Unexpected error loading metrics: {e}")
-            print(f"✗ Failed to load metrics: {e}")
-            sys.exit(1)
-
-    elif inspect_type == "state":
-        state_dir = args.state_dir or ".empathy/state"
-        try:
-            manager = StateManager(state_dir)
-            users = manager.list_users()
-
-            print("\nSaved states:")
-            print(f"  Total users: {len(users)}")
-
-            if users:
-                print("\n  Users:")
-                for uid in users:
-                    print(f"    • {uid}")
-        except (OSError, FileNotFoundError) as e:
-            # State directory not found
-            print(f"✗ State directory not found: {e}")
-            sys.exit(1)
-        except Exception as e:
-            # Unexpected errors loading state
-            logger.exception(f"Unexpected error loading state: {e}")
-            print(f"✗ Failed to load state: {e}")
-            sys.exit(1)
-
-    print()
-
-
-def cmd_export(args):
-    """Export patterns to file for sharing/backup.
-
-    Args:
-        args: Namespace object from argparse with attributes:
-            - output (str): Output file path.
-            - user_id (str | None): Filter patterns by user ID.
-            - db (str | None): Source database path.
-            - format (str): Output format ('json').
-
-    Returns:
-        None: Exports patterns to file. Exits with code 1 on failure.
-
-    Raises:
-        ValueError: If output path is invalid or unsafe.
-    """
-    output_file = args.output
-    user_id = args.user_id
-    db_path = args.db or ".empathy/patterns.db"
-    format_type = args.format
-
-    print(f"📦 Exporting patterns to: {output_file}")
-    print("=" * 50)
-
-    try:
-        # Load pattern library from source file
-        if db_path.endswith(".json"):
-            library = PatternPersistence.load_from_json(db_path)
-        else:
-            library = PatternPersistence.load_from_sqlite(db_path)
-
-        patterns = list(library.patterns.values())
-
-        # Filter by user_id if specified
-        if user_id:
-            patterns = [p for p in patterns if p.agent_id == user_id]
-
-        print(f"  Found {len(patterns)} patterns")
-
-        # Validate output path
-        validated_output = _validate_file_path(output_file)
-
-        if format_type == "json":
-            # Create filtered library if user_id specified
-            if user_id:
-                filtered_library = PatternLibrary()
-                for pattern in patterns:
-                    filtered_library.contribute_pattern(pattern.agent_id, pattern)
-            else:
-                filtered_library = library
-
-            # Export as JSON
-            PatternPersistence.save_to_json(filtered_library, str(validated_output))
-            print(f"  ✓ Exported {len(patterns)} patterns to {output_file}")
-        else:
-            print(f"✗ Unsupported format: {format_type}")
-            sys.exit(1)
-
-    except FileNotFoundError:
-        print(f"✗ Source file not found: {db_path}")
-        print("  Tip: Patterns are saved automatically when using the framework")
-        sys.exit(1)
-    except (OSError, PermissionError) as e:
-        # Cannot write output file
-        print(f"✗ Cannot write to file: {e}")
-        sys.exit(1)
-    except (ValueError, KeyError) as e:
-        # Invalid pattern data
-        print(f"✗ Invalid pattern data: {e}")
-        sys.exit(1)
-    except Exception as e:
-        # Unexpected errors during export
-        logger.exception(f"Unexpected error exporting patterns: {e}")
-        print(f"✗ Export failed: {e}")
-        sys.exit(1)
-
-    print()
-
-
-def cmd_import(args):
-    """Import patterns from file (local dev only - SQLite/JSON).
-
-    Merges imported patterns into existing pattern library.
-
-    Args:
-        args: Namespace object from argparse with attributes:
-            - input (str): Input file path.
-            - db (str | None): Target database path (default: .empathy/patterns.db).
-
-    Returns:
-        None: Imports and merges patterns. Exits with code 1 on failure.
-    """
-    input_file = args.input
-    db_path = args.db or ".empathy/patterns.db"
-
-    print(f"📥 Importing patterns from: {input_file}")
-    print("=" * 50)
-
-    try:
-        # Load patterns from input file
-        if input_file.endswith(".json"):
-            imported_library = PatternPersistence.load_from_json(input_file)
-        else:
-            imported_library = PatternPersistence.load_from_sqlite(input_file)
-
-        pattern_count = len(imported_library.patterns)
-        print(f"  Found {pattern_count} patterns in file")
-
-        # Load existing library if it exists, otherwise create new one
-        try:
-            if db_path.endswith(".json"):
-                existing_library = PatternPersistence.load_from_json(db_path)
-            else:
-                existing_library = PatternPersistence.load_from_sqlite(db_path)
-
-            print(f"  Existing library has {len(existing_library.patterns)} patterns")
-        except FileNotFoundError:
-            existing_library = PatternLibrary()
-            print("  Creating new pattern library")
-
-        # Merge imported patterns into existing library
-        for pattern in imported_library.patterns.values():
-            existing_library.contribute_pattern(pattern.agent_id, pattern)
-
-        # Save merged library (SQLite for local dev)
-        if db_path.endswith(".json"):
-            PatternPersistence.save_to_json(existing_library, db_path)
-        else:
-            PatternPersistence.save_to_sqlite(existing_library, db_path)
-
-        print(f"  ✓ Imported {pattern_count} patterns")
-        print(f"  ✓ Total patterns in library: {len(existing_library.patterns)}")
-
-    except FileNotFoundError:
-        print(f"✗ Input file not found: {input_file}")
-        sys.exit(1)
-    except (ValueError, KeyError) as e:
-        # Invalid pattern data format
-        print(f"✗ Invalid pattern data: {e}")
-        sys.exit(1)
-    except (OSError, PermissionError) as e:
-        # Cannot read input or write to database
-        print(f"✗ File access error: {e}")
-        sys.exit(1)
-    except Exception as e:
-        # Unexpected errors during import
-        logger.exception(f"Unexpected error importing patterns: {e}")
-        print(f"✗ Import failed: {e}")
-        sys.exit(1)
-
-    print()

empathy_os/cli/commands/inspection.py

@@ -1,57 +0,0 @@
-"""Code inspection commands.
-
-Commands for scanning and inspecting codebases for issues.
-
-Copyright 2025 Smart-AI-Memory
-Licensed under Fair Source License 0.9
-"""
-
-import subprocess
-from pathlib import Path
-
-from empathy_os.cli.core import console
-
-
-def scan(
-    path: Path = Path("."),
-    format_out: str = "text",
-    fix: bool = False,
-    staged: bool = False,
-) -> None:
-    """Scan codebase for issues using ruff and bandit."""
-    console.print(f"[bold blue]Scanning {path}...[/bold blue]\n")
-
-    # Run ruff for linting
-    console.print("[bold]Running ruff (linting)...[/bold]")
-    ruff_args = ["ruff", "check", str(path)]
-    if fix:
-        ruff_args.append("--fix")
-    subprocess.run(ruff_args, check=False)
-
-    # Run bandit for security (if available)
-    console.print("\n[bold]Running bandit (security)...[/bold]")
-    bandit_args = ["bandit", "-r", str(path), "-q"]
-    if format_out == "json":
-        bandit_args.extend(["-f", "json"])
-    result = subprocess.run(bandit_args, check=False, capture_output=True)
-    if result.returncode == 0:
-        console.print("[green]No security issues found[/green]")
-    elif result.stdout:
-        console.print(result.stdout.decode())
-
-    console.print("\n[bold green]Scan complete![/bold green]")
-
-
-def inspect_cmd(
-    path: Path = Path("."),
-    format_out: str = "text",
-) -> None:
-    """Deep inspection with code analysis."""
-    args = ["empathy-inspect", str(path)]
-    if format_out != "text":
-        args.extend(["--format", format_out])
-
-    result = subprocess.run(args, check=False, capture_output=False)
-    if result.returncode != 0:
-        console.print("[yellow]Note: empathy-inspect may not be installed[/yellow]")
-        console.print("Install with: pip install empathy-framework[software]")

empathy_os/cli/commands/memory.py

@@ -1,48 +0,0 @@
-"""Memory system control panel commands.
-
-Commands for managing Redis-backed short-term memory system.
-
-Copyright 2025 Smart-AI-Memory
-Licensed under Fair Source License 0.9
-"""
-
-import subprocess
-import sys
-
-import typer
-
-# Create the memory Typer app
-memory_app = typer.Typer(help="Memory system control panel")
-
-
-@memory_app.command("status")
-def memory_status() -> None:
-    """Check memory system status (Redis, patterns, stats)."""
-    subprocess.run([sys.executable, "-m", "empathy_os.memory.control_panel", "status"], check=False)
-
-
-@memory_app.command("start")
-def memory_start() -> None:
-    """Start Redis server for short-term memory."""
-    subprocess.run([sys.executable, "-m", "empathy_os.memory.control_panel", "start"], check=False)
-
-
-@memory_app.command("stop")
-def memory_stop() -> None:
-    """Stop Redis server."""
-    subprocess.run([sys.executable, "-m", "empathy_os.memory.control_panel", "stop"], check=False)
-
-
-@memory_app.command("stats")
-def memory_stats() -> None:
-    """Show memory statistics."""
-    subprocess.run([sys.executable, "-m", "empathy_os.memory.control_panel", "stats"], check=False)
-
-
-@memory_app.command("patterns")
-def memory_patterns() -> None:
-    """List stored patterns."""
-    subprocess.run(
-        [sys.executable, "-m", "empathy_os.memory.control_panel", "patterns", "--list"],
-        check=False,
-    )

empathy_os/cli/commands/metrics.py

@@ -1,92 +0,0 @@
-"""Metrics commands for user statistics.
-
-Copyright 2025 Smart-AI-Memory
-Licensed under Fair Source License 0.9
-"""
-
-import sys
-
-from empathy_os.logging_config import get_logger
-from empathy_os.metrics.collector import MetricsCollector
-from empathy_os.persistence import StateManager
-
-logger = get_logger(__name__)
-
-
-def cmd_metrics_show(args):
-    """Display metrics for a user.
-
-    Args:
-        args: Namespace object from argparse with attributes:
-            - user (str): User ID to retrieve metrics for.
-            - db (str): Path to metrics database (default: ./metrics.db).
-
-    Returns:
-        None: Prints user metrics to stdout. Exits with code 1 on failure.
-    """
-    db_path = args.db
-    user_id = args.user
-
-    logger.info(f"Retrieving metrics for user: {user_id} from {db_path}")
-
-    collector = MetricsCollector(db_path)
-
-    try:
-        stats = collector.get_user_stats(user_id)
-
-        logger.info(f"Successfully retrieved metrics for user: {user_id}")
-        logger.info(f"=== Metrics for User: {user_id} ===\n")
-        logger.info(f"Total Operations: {stats['total_operations']}")
-        logger.info(f"Success Rate: {stats['success_rate']:.1%}")
-        logger.info(f"Average Response Time: {stats.get('avg_response_time_ms', 0):.0f} ms")
-        logger.info(f"\nFirst Use: {stats['first_use']}")
-        logger.info(f"Last Use: {stats['last_use']}")
-
-        logger.info("\nEmpathy Level Usage:")
-        logger.info(f"  Level 1: {stats.get('level_1_count', 0)} uses")
-        logger.info(f"  Level 2: {stats.get('level_2_count', 0)} uses")
-        logger.info(f"  Level 3: {stats.get('level_3_count', 0)} uses")
-        logger.info(f"  Level 4: {stats.get('level_4_count', 0)} uses")
-        logger.info(f"  Level 5: {stats.get('level_5_count', 0)} uses")
-    except (OSError, FileNotFoundError) as e:
-        # Database file not found
-        logger.error(f"Metrics database error: {e}")
-        logger.error(f"✗ Cannot read metrics database: {e}")
-        sys.exit(1)
-    except KeyError as e:
-        # User not found in database
-        logger.error(f"User not found in metrics: {e}")
-        logger.error(f"✗ User {user_id} not found: {e}")
-        sys.exit(1)
-    except Exception as e:
-        # Unexpected errors retrieving metrics
-        logger.exception(f"Unexpected error retrieving metrics for user {user_id}: {e}")
-        logger.error(f"✗ Failed to retrieve metrics: {e}")
-        sys.exit(1)
-
-
-def cmd_state_list(args):
-    """List saved user states.
-
-    Args:
-        args: Namespace object from argparse with attributes:
-            - state_dir (str): Directory containing state files.
-
-    Returns:
-        None: Prints list of users with saved states.
-    """
-    state_dir = args.state_dir
-
-    logger.info(f"Listing saved user states from: {state_dir}")
-
-    manager = StateManager(state_dir)
-    users = manager.list_users()
-
-    logger.info(f"Found {len(users)} saved user states")
-    logger.info(f"=== Saved User States: {state_dir} ===\n")
-    logger.info(f"Total users: {len(users)}")
-
-    if users:
-        logger.info("\nUsers:")
-        for user_id in users:
-            logger.info(f"  - {user_id}")