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

empathy_os/cli/parsers/routing.py

@@ -1,110 +0,0 @@
-"""Argument parser for adaptive routing commands.
-
-Copyright 2025 Smart-AI-Memory
-Licensed under Fair Source License 0.9
-"""
-
-
-def register_parsers(subparsers):
-    """Register routing command parsers.
-
-    Args:
-        subparsers: Subparser object from main argument parser
-
-    Returns:
-        None: Adds routing subparser with stats, check, models subcommands
-    """
-    from ..commands.routing import (
-        cmd_routing_check,
-        cmd_routing_models,
-        cmd_routing_stats,
-    )
-
-    # Main routing command
-    routing_parser = subparsers.add_parser(
-        "routing",
-        help="Adaptive model routing statistics and recommendations",
-        description="Analyze model routing performance based on historical telemetry",
-    )
-
-    # Routing subcommands
-    routing_subparsers = routing_parser.add_subparsers(
-        dest="routing_command", required=True
-    )
-
-    # routing stats command
-    stats_parser = routing_subparsers.add_parser(
-        "stats",
-        help="Show routing statistics for a workflow",
-        description="Display model performance metrics and recommendations",
-    )
-
-    stats_parser.add_argument("workflow", help="Workflow name (e.g., 'code-review')")
-
-    stats_parser.add_argument(
-        "--stage",
-        help="Stage name (optional, shows all stages if not specified)",
-    )
-
-    stats_parser.add_argument(
-        "--days",
-        type=int,
-        default=7,
-        help="Number of days to analyze (default: 7)",
-    )
-
-    stats_parser.set_defaults(func=cmd_routing_stats)
-
-    # routing check command
-    check_parser = routing_subparsers.add_parser(
-        "check",
-        help="Check for tier upgrade recommendations",
-        description="Analyze failure rates and recommend tier upgrades",
-    )
-
-    check_parser.add_argument(
-        "--workflow",
-        help="Workflow name (required unless --all is used)",
-    )
-
-    check_parser.add_argument(
-        "--stage",
-        help="Stage name (optional)",
-    )
-
-    check_parser.add_argument(
-        "--all",
-        action="store_true",
-        help="Check all workflows",
-    )
-
-    check_parser.add_argument(
-        "--days",
-        type=int,
-        default=7,
-        help="Number of days to analyze (default: 7)",
-    )
-
-    check_parser.set_defaults(func=cmd_routing_check)
-
-    # routing models command
-    models_parser = routing_subparsers.add_parser(
-        "models",
-        help="Compare model performance",
-        description="Show performance metrics for all models from a provider",
-    )
-
-    models_parser.add_argument(
-        "--provider",
-        default="anthropic",
-        help="Provider name (default: anthropic)",
-    )
-
-    models_parser.add_argument(
-        "--days",
-        type=int,
-        default=7,
-        help="Number of days to analyze (default: 7)",
-    )
-
-    models_parser.set_defaults(func=cmd_routing_models)

empathy_os/cli/parsers/setup.py

@@ -1,42 +0,0 @@
-"""Parser definitions for setup commands.
-
-Copyright 2025 Smart-AI-Memory
-Licensed under Fair Source License 0.9
-"""
-
-from ..commands import setup
-
-
-def register_parsers(subparsers):
-    """Register setup command parsers.
-
-    Args:
-        subparsers: ArgumentParser subparsers object from main parser
-    """
-    # Init command
-    parser_init = subparsers.add_parser(
-        "init",
-        help="Initialize a new Empathy Framework project",
-    )
-    parser_init.add_argument(
-        "--format",
-        choices=["yaml", "json"],
-        default="yaml",
-        help="Configuration format (default: yaml)",
-    )
-    parser_init.add_argument(
-        "--output",
-        help="Output file path (default: empathy.config.{format})",
-    )
-    parser_init.set_defaults(func=setup.cmd_init)
-
-    # Validate command
-    parser_validate = subparsers.add_parser(
-        "validate",
-        help="Validate a configuration file",
-    )
-    parser_validate.add_argument(
-        "config",
-        help="Path to configuration file to validate",
-    )
-    parser_validate.set_defaults(func=setup.cmd_validate)

empathy_os/cli/parsers/status.py

@@ -1,47 +0,0 @@
-"""Parser definitions for status and health commands.
-
-Copyright 2025 Smart-AI-Memory
-Licensed under Fair Source License 0.9
-"""
-
-from ..commands import status as status_commands
-
-
-def register_parsers(subparsers):
-    """Register status command parsers.
-
-    Args:
-        subparsers: ArgumentParser subparsers object
-    """
-    # status command
-    parser_status = subparsers.add_parser("status", help="Show project status")
-    parser_status.add_argument("--patterns-dir", default="./patterns", help="Patterns directory")
-    parser_status.add_argument("--project-root", default=".", help="Project root")
-    parser_status.add_argument(
-        "--inactivity", type=int, default=30, help="Inactivity threshold (minutes)"
-    )
-    parser_status.add_argument("--full", action="store_true", help="Show all items")
-    parser_status.add_argument("--json", action="store_true", help="Output as JSON")
-    parser_status.add_argument("--select", type=int, help="Select item for action")
-    parser_status.add_argument("--force", action="store_true", help="Force show status")
-    parser_status.set_defaults(func=status_commands.cmd_status)
-
-    # review command (deprecated)
-    parser_review = subparsers.add_parser("review", help="Code review (deprecated)")
-    parser_review.set_defaults(func=status_commands.cmd_review)
-
-    # health command
-    parser_health = subparsers.add_parser("health", help="Run health checks")
-    parser_health.add_argument("--check", help="Specific check (lint/type/format/test)")
-    parser_health.add_argument("--deep", action="store_true", help="Run all checks")
-    parser_health.add_argument("--fix", action="store_true", help="Auto-fix issues")
-    parser_health.add_argument("--dry-run", action="store_true", help="Preview fixes only")
-    parser_health.add_argument(
-        "--interactive", action="store_true", help="Interactive fix mode"
-    )
-    parser_health.add_argument("--project-root", default=".", help="Project root")
-    parser_health.add_argument("--details", action="store_true", help="Show details")
-    parser_health.add_argument("--full", action="store_true", help="Show all details")
-    parser_health.add_argument("--trends", type=int, help="Show trends (days)")
-    parser_health.add_argument("--json", action="store_true", help="Output as JSON")
-    parser_health.set_defaults(func=status_commands.cmd_health)

empathy_os/cli/parsers/sync.py

@@ -1,31 +0,0 @@
-"""Parser definitions for sync commands.
-
-Copyright 2025 Smart-AI-Memory
-Licensed under Fair Source License 0.9
-"""
-
-from ..commands import sync
-
-
-def register_parsers(subparsers):
-    """Register sync command parsers.
-
-    Args:
-        subparsers: ArgumentParser subparsers object from main parser
-    """
-    # Sync-claude command
-    parser_sync_claude = subparsers.add_parser(
-        "sync-claude",
-        help="Sync learned patterns to Claude Code rules",
-    )
-    parser_sync_claude.add_argument(
-        "--patterns-dir",
-        default="patterns",
-        help="Source patterns directory (default: patterns)",
-    )
-    parser_sync_claude.add_argument(
-        "--output-dir",
-        default=".claude/rules/empathy",
-        help="Target Claude Code rules directory (default: .claude/rules/empathy)",
-    )
-    parser_sync_claude.set_defaults(func=sync.cmd_sync_claude)

empathy_os/cli/parsers/tier.py

@@ -1,33 +0,0 @@
-"""Parser definitions for tier commands.
-
-Copyright 2025 Smart-AI-Memory
-Licensed under Fair Source License 0.9
-"""
-
-from ..commands import tier as tier_commands
-
-
-def register_parsers(subparsers):
-    """Register tier command parsers.
-
-    Args:
-        subparsers: ArgumentParser subparsers object
-    """
-    # Create tier subcommand group
-    tier_parser = subparsers.add_parser("tier", help="Tier management commands")
-    tier_subparsers = tier_parser.add_subparsers(dest="tier_command")
-
-    # tier recommend
-    parser_recommend = tier_subparsers.add_parser(
-        "recommend", help="Get tier recommendation"
-    )
-    parser_recommend.add_argument("description", help="Bug or task description")
-    parser_recommend.add_argument("--files", help="Comma-separated list of files")
-    parser_recommend.add_argument(
-        "--complexity", choices=["low", "medium", "high"], help="Complexity hint"
-    )
-    parser_recommend.set_defaults(func=tier_commands.cmd_tier_recommend)
-
-    # tier stats
-    parser_stats = tier_subparsers.add_parser("stats", help="Show tier statistics")
-    parser_stats.set_defaults(func=tier_commands.cmd_tier_stats)

empathy_os/cli/parsers/workflow.py

@@ -1,77 +0,0 @@
-"""Parser definitions for workflow commands.
-
-Copyright 2025 Smart-AI-Memory
-Licensed under Fair Source License 0.9
-"""
-
-from ..commands import workflow
-
-
-def register_parsers(subparsers):
-    """Register workflow command parsers.
-
-    Args:
-        subparsers: ArgumentParser subparsers object from main parser
-    """
-    # Main workflow command - multi-model workflow management
-    parser_workflow = subparsers.add_parser(
-        "workflow",
-        help="Multi-model workflows for cost-optimized task pipelines",
-    )
-    parser_workflow.add_argument(
-        "action",
-        choices=["list", "describe", "run", "config"],
-        help="Action: list, describe, run, or config",
-    )
-    parser_workflow.add_argument(
-        "name",
-        nargs="?",
-        help="Workflow name (for describe/run)",
-    )
-    parser_workflow.add_argument(
-        "--input",
-        "-i",
-        help="JSON input data for workflow execution",
-    )
-    parser_workflow.add_argument(
-        "--provider",
-        "-p",
-        choices=["anthropic", "openai", "google", "ollama", "hybrid"],
-        default=None,  # None means use config
-        help="Model provider: anthropic, openai, google, ollama, or hybrid (mix of best models)",
-    )
-    parser_workflow.add_argument(
-        "--force",
-        action="store_true",
-        help="Force overwrite existing config file",
-    )
-    parser_workflow.add_argument("--json", action="store_true", help="Output as JSON")
-    parser_workflow.add_argument(
-        "--use-recommended-tier",
-        action="store_true",
-        help="Enable intelligent tier fallback: start with CHEAP tier and automatically upgrade if quality gates fail",
-    )
-    parser_workflow.add_argument(
-        "--write-tests",
-        action="store_true",
-        help="(test-gen workflow) Write generated tests to disk",
-    )
-    parser_workflow.add_argument(
-        "--output-dir",
-        default="tests/generated",
-        help="(test-gen workflow) Output directory for generated tests",
-    )
-    parser_workflow.add_argument(
-        "--health-score-threshold",
-        type=int,
-        default=95,
-        help="(health-check workflow) Minimum health score required (0-100, default: 95 for very strict quality)",
-    )
-    parser_workflow.set_defaults(func=workflow.cmd_workflow)
-
-    # Legacy workflow-setup command (DEPRECATED)
-    parser_workflow_setup = subparsers.add_parser(
-        "workflow-setup",
-        help="[DEPRECATED] Interactive setup wizard (use 'empathy init' instead)",
-    )
-    parser_workflow_setup.set_defaults(func=workflow.cmd_workflow_legacy)

empathy_os/cli/utils/__init__.py

@@ -1 +0,0 @@
-"""CLI utility functions."""

empathy_os/cli/utils/data.py

@@ -1,242 +0,0 @@
-"""Help text and documentation data for CLI commands.
-
-This module contains static help content displayed by various CLI commands.
-
-Copyright 2025 Smart-AI-Memory
-Licensed under Fair Source License 0.9
-"""
-
-CHEATSHEET = {
-    "Getting Started": [
-        ("empathy init", "Create a new config file"),
-        ("empathy workflow", "Interactive setup workflow"),
-        ("empathy run", "Interactive REPL mode"),
-    ],
-    "Daily Workflow": [
-        ("empathy morning", "Start-of-day briefing"),
-        ("empathy status", "What needs attention now"),
-        ("empathy ship", "Pre-commit validation"),
-    ],
-    "Code Quality": [
-        ("empathy health", "Quick health check"),
-        ("empathy health --deep", "Comprehensive check"),
-        ("empathy health --fix", "Auto-fix issues"),
-        ("empathy fix-all", "Fix all lint/format issues"),
-    ],
-    "Pattern Learning": [
-        ("empathy learn --analyze 20", "Learn from last 20 commits"),
-        ("empathy sync-claude", "Sync patterns to Claude Code"),
-        ("empathy inspect patterns", "View learned patterns"),
-    ],
-    "Code Review": [
-        ("empathy review", "Review recent changes"),
-        ("empathy review --staged", "Review staged changes only"),
-    ],
-    "Memory & State": [
-        ("empathy inspect state", "View saved states"),
-        ("empathy inspect metrics --user-id X", "View user metrics"),
-        ("empathy export patterns.json", "Export patterns"),
-    ],
-    "Advanced": [
-        ("empathy costs", "View API cost tracking"),
-        ("empathy dashboard", "Launch visual dashboard"),
-        ("empathy frameworks", "List agent frameworks"),
-        ("empathy workflow list", "List multi-model workflows"),
-        ("empathy new <template>", "Create project from template"),
-    ],
-}
-
-EXPLAIN_CONTENT = {
-    "morning": """
-HOW 'empathy morning' WORKS:
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-This command aggregates multiple data sources to give you a prioritized
-start-of-day briefing:
-
-1. PATTERNS ANALYSIS
-   Reads ./patterns/*.json to find:
-   - Unresolved bugs (status: investigating)
-   - Recent security decisions
-   - Tech debt trends
-
-2. GIT CONTEXT
-   Checks your recent git activity:
-   - Commits from yesterday
-   - Uncommitted changes
-   - Branch status
-
-3. HEALTH SNAPSHOT
-   Runs quick health checks:
-   - Lint issues count
-   - Type errors
-   - Test status
-
-4. PRIORITY SCORING
-   Items are scored and sorted by:
-   - Age (older = higher priority)
-   - Severity (critical > high > medium)
-   - Your recent activity patterns
-
-TIPS:
-• Run this first thing each day
-• Use 'empathy morning --verbose' for details
-• Pair with 'empathy status --select N' to dive deeper
-""",
-    "ship": """
-HOW 'empathy ship' WORKS:
-━━━━━━━━━━━━━━━━━━━━━━━━━
-Pre-commit validation pipeline that ensures code quality before shipping:
-
-1. HEALTH CHECKS
-   - Runs lint checks (ruff/flake8)
-   - Validates types (mypy/pyright)
-   - Checks formatting (black/prettier)
-
-2. PATTERN REVIEW
-   - Compares changes against known bug patterns
-   - Flags code that matches historical issues
-   - Suggests fixes based on past resolutions
-
-3. SECURITY SCAN
-   - Checks for hardcoded secrets
-   - Validates against security patterns
-   - Reports potential vulnerabilities
-
-4. PATTERN SYNC (optional)
-   - Updates Claude Code rules
-   - Syncs new patterns discovered
-   - Skip with --skip-sync
-
-EXIT CODES:
-• 0 = All checks passed, safe to commit
-• 1 = Issues found, review before committing
-
-TIPS:
-• Add to pre-commit hook: empathy ship --skip-sync
-• Use 'empathy ship --verbose' to see all checks
-""",
-    "learn": """
-HOW 'empathy learn' WORKS:
-━━━━━━━━━━━━━━━━━━━━━━━━━
-Extracts patterns from your git history to teach Claude about your codebase:
-
-1. COMMIT ANALYSIS
-   Parses commit messages looking for:
-   - fix: Bug fixes → debugging.json
-   - security: decisions → security.json
-   - TODO/FIXME in code → tech_debt.json
-
-2. DIFF INSPECTION
-   Analyzes code changes to:
-   - Identify affected files
-   - Extract error types
-   - Record fix patterns
-
-3. PATTERN STORAGE
-   Saves to ./patterns/:
-   - debugging.json: Bug patterns
-   - security.json: Security decisions
-   - tech_debt.json: Technical debt
-   - inspection.json: Code review findings
-
-4. SUMMARY GENERATION
-   Creates .claude/patterns_summary.md:
-   - Human-readable pattern overview
-   - Loaded by Claude Code automatically
-
-USAGE EXAMPLES:
-• empathy learn --analyze 10    # Last 10 commits
-• empathy learn --analyze 100   # Deeper history
-• empathy sync-claude           # Apply patterns to Claude
-
-TIPS:
-• Run weekly to keep patterns current
-• Use good commit messages (fix:, feat:, etc.)
-• Check ./patterns/ to see what was learned
-""",
-    "health": """
-HOW 'empathy health' WORKS:
-━━━━━━━━━━━━━━━━━━━━━━━━━
-Code health dashboard that runs multiple quality checks:
-
-1. QUICK MODE (default)
-   Fast checks that run in seconds:
-   - Lint: ruff check or flake8
-   - Format: black --check or prettier
-   - Basic type checking
-
-2. DEEP MODE (--deep)
-   Comprehensive checks (slower):
-   - Full type analysis (mypy --strict)
-   - Test suite execution
-   - Security scanning
-   - Dependency audit
-
-3. SCORING
-   Health score 0-100 based on:
-   - Lint issues (×2 penalty each)
-   - Type errors (×5 penalty each)
-   - Test failures (×10 penalty each)
-   - Security issues (×20 penalty each)
-
-4. AUTO-FIX (--fix)
-   Can automatically fix:
-   - Formatting issues
-   - Import sorting
-   - Simple lint errors
-
-USAGE:
-• empathy health              # Quick check
-• empathy health --deep       # Full check
-• empathy health --fix        # Auto-fix issues
-• empathy health --trends 30  # 30-day trend
-
-TIPS:
-• Run quick checks before commits
-• Run deep checks in CI/CD
-• Track trends to catch regressions
-""",
-    "sync-claude": """
-HOW 'empathy sync-claude' WORKS:
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-Converts learned patterns into Claude Code rules:
-
-1. READS PATTERNS
-   Loads from ./patterns/:
-   - debugging.json → Bug fix patterns
-   - security.json → Security decisions
-   - tech_debt.json → Known debt items
-
-2. GENERATES RULES
-   Creates .claude/rules/empathy/:
-   - debugging.md
-   - security.md
-   - tech_debt.md
-
-3. CLAUDE CODE INTEGRATION
-   Rules are automatically loaded when:
-   - Claude Code starts in this directory
-   - Combined with CLAUDE.md instructions
-
-HOW CLAUDE USES THESE:
-• Sees historical bugs before suggesting code
-• Knows about accepted security patterns
-• Understands existing tech debt
-
-FILE STRUCTURE:
-./patterns/             # Your pattern storage
-  debugging.json
-  security.json
-.claude/
-  CLAUDE.md             # Project instructions
-  rules/
-    empathy/            # Generated rules
-      debugging.md
-      security.md
-
-TIPS:
-• Run after 'empathy learn'
-• Commit .claude/rules/ to share with team
-• Weekly sync keeps Claude current
-""",
-}

empathy_os/cli/utils/helpers.py

@@ -1,68 +0,0 @@
-"""Helper utilities for CLI commands.
-
-Copyright 2025 Smart-AI-Memory
-Licensed under Fair Source License 0.9
-"""
-
-from pathlib import Path
-
-
-def _file_exists(path: str) -> bool:
-    """Check if a file exists.
-
-    Args:
-        path: File path to check
-
-    Returns:
-        True if file exists, False otherwise
-    """
-    return Path(path).exists()
-
-
-def _show_achievements(engine) -> None:
-    """Show user achievements based on usage.
-
-    Args:
-        engine: Engine instance with stats
-    """
-    stats = engine.get_stats()
-
-    achievements = []
-    total_cmds = stats.get("total_commands", 0)
-    cmd_counts = stats.get("command_counts", {})
-
-    # Check achievements
-    if total_cmds >= 1:
-        achievements.append(("First Steps", "Ran your first command"))
-    if total_cmds >= 10:
-        achievements.append(("Getting Started", "Ran 10+ commands"))
-    if total_cmds >= 50:
-        achievements.append(("Power User", "Ran 50+ commands"))
-    if total_cmds >= 100:
-        achievements.append(("Expert", "Ran 100+ commands"))
-
-    if cmd_counts.get("learn", 0) >= 1:
-        achievements.append(("Pattern Learner", "Learned from git history"))
-    if cmd_counts.get("sync-claude", 0) >= 1:
-        achievements.append(("Claude Whisperer", "Synced patterns to Claude"))
-    if cmd_counts.get("morning", 0) >= 5:
-        achievements.append(("Early Bird", "Used morning briefing 5+ times"))
-    if cmd_counts.get("ship", 0) >= 10:
-        achievements.append(("Quality Shipper", "Used pre-commit checks 10+ times"))
-    if cmd_counts.get("health", 0) >= 1 and cmd_counts.get("fix-all", 0) >= 1:
-        achievements.append(("Code Doctor", "Used health checks and fixes"))
-
-    if stats.get("patterns_learned", 0) >= 10:
-        achievements.append(("Pattern Master", "Learned 10+ patterns"))
-
-    if stats.get("days_active", 0) >= 7:
-        achievements.append(("Week Warrior", "Active for 7+ days"))
-    if stats.get("days_active", 0) >= 30:
-        achievements.append(("Monthly Maven", "Active for 30+ days"))
-
-    if achievements:
-        print("  ACHIEVEMENTS UNLOCKED")
-        print("  " + "-" * 30)
-        for name, desc in achievements:
-            print(f"  * {name}: {desc}")
-        print()