attune-ai 2.0.0__py3-none-any.whl

attune/cli/parsers/status.py

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

attune/cli/parsers/sync.py

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

attune/cli/parsers/tier.py

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

attune/cli/parsers/workflow.py

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

attune/cli/utils/__init__.py

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

attune/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
+""",
+}

attune/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()