empathy-framework 4.7.1__py3-none-any.whl → 4.8.0__py3-none-any.whl

empathy_os/cli/utils/data.py

@@ -0,0 +1,242 @@
+"""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

@@ -0,0 +1,68 @@
+"""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()

empathy_os/{cli.py → cli_legacy.py}

@@ -1,5 +1,22 @@
-"""Command-Line Interface for Empathy Framework
+"""Command-Line Interface for Empathy Framework (LEGACY)
 
+DEPRECATED: This module is deprecated as of v5.0.0.
+Use the minimal CLI instead: `empathy` (empathy_os.cli_minimal)
+
+The minimal CLI provides:
+- `empathy workflow list|info|run` - Workflow management
+- `empathy telemetry show|savings|export` - Usage tracking
+- `empathy provider show|set` - Provider configuration
+- `empathy validate` - Configuration validation
+
+For interactive features, use Claude Code slash commands:
+- /dev, /testing, /docs, /release, /help
+
+Migration guide: https://smartaimemory.com/framework-docs/migration/cli/
+
+---
+
+Original description:
 Provides CLI commands for:
 - Running interactive REPL (empathy run)
 - Inspecting patterns, metrics, state (empathy inspect)
@@ -12,6 +29,15 @@ Copyright 2025 Smart-AI-Memory
 Licensed under Fair Source License 0.9
 """
 
+import warnings
+
+warnings.warn(
+    "empathy_os.cli_legacy is deprecated. Use 'empathy' (cli_minimal) instead. "
+    "See: https://smartaimemory.com/framework-docs/reference/cli-reference/",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
 import argparse
 import heapq
 import sys
@@ -22,7 +48,6 @@ from pathlib import Path
 from empathy_os import EmpathyConfig, EmpathyOS, load_config
 from empathy_os.config import _validate_file_path
 from empathy_os.cost_tracker import cmd_costs
-from empathy_os.dashboard import cmd_dashboard
 from empathy_os.discovery import show_tip_if_available
 from empathy_os.logging_config import get_logger
 from empathy_os.pattern_library import PatternLibrary
@@ -3681,31 +3706,6 @@ def main():
     parser_new.add_argument("--list", "-l", action="store_true", help="List available templates")
     parser_new.set_defaults(func=cmd_new)
 
-    # Dashboard command (visual web interface)
-    parser_dashboard = subparsers.add_parser("dashboard", help="Launch visual dashboard in browser")
-    parser_dashboard.add_argument(
-        "--port",
-        type=int,
-        default=8765,
-        help="Port to run on (default: 8765)",
-    )
-    parser_dashboard.add_argument(
-        "--patterns-dir",
-        default="./patterns",
-        help="Path to patterns directory",
-    )
-    parser_dashboard.add_argument(
-        "--empathy-dir",
-        default=".empathy",
-        help="Empathy data directory",
-    )
-    parser_dashboard.add_argument(
-        "--no-browser",
-        action="store_true",
-        help="Don't open browser automatically",
-    )
-    parser_dashboard.set_defaults(func=cmd_dashboard)
-
     # Frameworks command (agent framework management)
     parser_frameworks = subparsers.add_parser(
         "frameworks",