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

empathy_os/cli/parsers/info.py

@@ -0,0 +1,26 @@
+"""Parser definitions for info commands.
+
+Copyright 2025 Smart-AI-Memory
+Licensed under Fair Source License 0.9
+"""
+
+from ..commands import info as info_commands
+
+
+def register_parsers(subparsers):
+    """Register info command parsers.
+
+    Args:
+        subparsers: ArgumentParser subparsers object
+    """
+    # info command
+    parser_info = subparsers.add_parser("info", help="Display framework information")
+    parser_info.add_argument("--config", help="Path to config file")
+    parser_info.set_defaults(func=info_commands.cmd_info)
+
+    # frameworks command
+    parser_frameworks = subparsers.add_parser("frameworks", help="List agent frameworks")
+    parser_frameworks.add_argument("--all", action="store_true", help="Show all frameworks")
+    parser_frameworks.add_argument("--recommend", help="Recommend for use case")
+    parser_frameworks.add_argument("--json", action="store_true", help="Output as JSON")
+    parser_frameworks.set_defaults(func=info_commands.cmd_frameworks)

empathy_os/cli/parsers/inspect.py

@@ -0,0 +1,66 @@
+"""Parser definitions for inspect commands.
+
+Copyright 2025 Smart-AI-Memory
+Licensed under Fair Source License 0.9
+"""
+
+from ..commands import inspect
+
+
+def register_parsers(subparsers):
+    """Register inspect command parsers.
+
+    Args:
+        subparsers: ArgumentParser subparsers object from main parser
+    """
+    # Run command - Interactive REPL
+    parser_run = subparsers.add_parser("run", help="Interactive REPL mode")
+    parser_run.add_argument("--config", "-c", help="Configuration file path")
+    parser_run.add_argument("--user-id", help="User ID (default: cli_user)")
+    parser_run.add_argument(
+        "--level",
+        type=int,
+        default=4,
+        help="Target empathy level (1-5, default: 4)",
+    )
+    parser_run.set_defaults(func=inspect.cmd_run)
+
+    # Inspect command - Unified inspection
+    parser_inspect = subparsers.add_parser("inspect", help="Inspect patterns, metrics, or state")
+    parser_inspect.add_argument(
+        "type",
+        choices=["patterns", "metrics", "state"],
+        help="Type of inspection (patterns, metrics, or state)",
+    )
+    parser_inspect.add_argument("--user-id", help="User ID to filter by (optional)")
+    parser_inspect.add_argument("--db", help="Database path (default: .empathy/patterns.db)")
+    parser_inspect.add_argument(
+        "--state-dir",
+        help="State directory path (default: .empathy/state)",
+    )
+    parser_inspect.set_defaults(func=inspect.cmd_inspect)
+
+    # Export command
+    parser_export = subparsers.add_parser(
+        "export",
+        help="Export patterns to file for sharing/backup",
+    )
+    parser_export.add_argument("output", help="Output file path")
+    parser_export.add_argument(
+        "--user-id",
+        help="User ID to export (optional, exports all if not specified)",
+    )
+    parser_export.add_argument("--db", help="Database path (default: .empathy/patterns.db)")
+    parser_export.add_argument(
+        "--format",
+        default="json",
+        choices=["json"],
+        help="Export format (default: json)",
+    )
+    parser_export.set_defaults(func=inspect.cmd_export)
+
+    # Import command
+    parser_import = subparsers.add_parser("import", help="Import patterns from file")
+    parser_import.add_argument("input", help="Input file path")
+    parser_import.add_argument("--db", help="Database path (default: .empathy/patterns.db)")
+    parser_import.set_defaults(func=inspect.cmd_import)

empathy_os/cli/parsers/metrics.py

@@ -0,0 +1,42 @@
+"""Parser definitions for metrics commands.
+
+Copyright 2025 Smart-AI-Memory
+Licensed under Fair Source License 0.9
+"""
+
+from ..commands import metrics
+
+
+def register_parsers(subparsers):
+    """Register metrics command parsers.
+
+    Args:
+        subparsers: ArgumentParser subparsers object from main parser
+    """
+    # Metrics command
+    parser_metrics = subparsers.add_parser(
+        "metrics",
+        help="Display user metrics",
+    )
+    parser_metrics.add_argument(
+        "user",
+        help="User ID to retrieve metrics for",
+    )
+    parser_metrics.add_argument(
+        "--db",
+        default="./metrics.db",
+        help="Path to metrics database (default: ./metrics.db)",
+    )
+    parser_metrics.set_defaults(func=metrics.cmd_metrics_show)
+
+    # State command
+    parser_state = subparsers.add_parser(
+        "state",
+        help="List saved user states",
+    )
+    parser_state.add_argument(
+        "--state-dir",
+        default=".empathy/state",
+        help="State directory path (default: .empathy/state)",
+    )
+    parser_state.set_defaults(func=metrics.cmd_state_list)

empathy_os/cli/parsers/orchestrate.py

@@ -0,0 +1,61 @@
+"""Parser definitions for orchestrate commands.
+
+Copyright 2025 Smart-AI-Memory
+Licensed under Fair Source License 0.9
+"""
+
+from ..commands import orchestrate
+
+
+def register_parsers(subparsers):
+    """Register orchestrate command parsers.
+
+    Args:
+        subparsers: ArgumentParser subparsers object from main parser
+    """
+    # Orchestrate command
+    parser_orchestrate = subparsers.add_parser(
+        "orchestrate",
+        help="Run meta-orchestration workflows (release-prep, health-check)",
+    )
+    parser_orchestrate.add_argument(
+        "workflow",
+        choices=["release-prep", "health-check", "test-coverage"],
+        help="Orchestration workflow to run",
+    )
+    parser_orchestrate.add_argument(
+        "--path",
+        default=".",
+        help="Project path (for release-prep)",
+    )
+    parser_orchestrate.add_argument(
+        "--mode",
+        choices=["daily", "weekly", "release"],
+        help="Health check mode (for health-check)",
+    )
+    parser_orchestrate.add_argument(
+        "--project-root",
+        default=".",
+        help="Project root directory (for health-check)",
+    )
+    parser_orchestrate.add_argument(
+        "--json",
+        action="store_true",
+        help="Output as JSON",
+    )
+    parser_orchestrate.add_argument(
+        "--min-coverage",
+        type=int,
+        help="Minimum test coverage percentage (for release-prep)",
+    )
+    parser_orchestrate.add_argument(
+        "--min-quality",
+        type=int,
+        help="Minimum quality score (for release-prep)",
+    )
+    parser_orchestrate.add_argument(
+        "--max-critical",
+        type=int,
+        help="Maximum critical issues allowed (for release-prep)",
+    )
+    parser_orchestrate.set_defaults(func=orchestrate.cmd_orchestrate)

empathy_os/cli/parsers/patterns.py

@@ -0,0 +1,54 @@
+"""Parser definitions for pattern commands.
+
+Copyright 2025 Smart-AI-Memory
+Licensed under Fair Source License 0.9
+"""
+
+from ..commands import patterns as patterns_commands
+
+
+def register_parsers(subparsers):
+    """Register pattern command parsers.
+
+    Args:
+        subparsers: ArgumentParser subparsers object
+    """
+    # Create patterns subcommand group
+    patterns_parser = subparsers.add_parser("patterns", help="Pattern management commands")
+    patterns_subparsers = patterns_parser.add_subparsers(dest="patterns_command")
+
+    # patterns list
+    parser_list = patterns_subparsers.add_parser("list", help="List patterns in library")
+    parser_list.add_argument("library", help="Path to pattern library")
+    parser_list.add_argument(
+        "--format", choices=["json", "sqlite"], default="json", help="Library format"
+    )
+    parser_list.set_defaults(func=patterns_commands.cmd_patterns_list)
+
+    # patterns export
+    parser_export = patterns_subparsers.add_parser("export", help="Export patterns")
+    parser_export.add_argument("input", help="Input file path")
+    parser_export.add_argument("output", help="Output file path")
+    parser_export.add_argument(
+        "--input-format", choices=["json", "sqlite"], default="json", help="Input format"
+    )
+    parser_export.add_argument(
+        "--output-format", choices=["json", "sqlite"], default="json", help="Output format"
+    )
+    parser_export.set_defaults(func=patterns_commands.cmd_patterns_export)
+
+    # patterns resolve
+    parser_resolve = patterns_subparsers.add_parser("resolve", help="Resolve a bug pattern")
+    parser_resolve.add_argument("bug_id", nargs="?", help="Bug ID to resolve")
+    parser_resolve.add_argument("--root-cause", help="Root cause description")
+    parser_resolve.add_argument("--fix", help="Fix description")
+    parser_resolve.add_argument("--fix-code", help="Code snippet of the fix")
+    parser_resolve.add_argument("--time", type=int, help="Resolution time in minutes")
+    parser_resolve.add_argument(
+        "--patterns-dir", default="./patterns", help="Patterns directory path"
+    )
+    parser_resolve.add_argument("--resolved-by", help="Who resolved it")
+    parser_resolve.add_argument(
+        "--no-regenerate", action="store_true", help="Don't regenerate summary"
+    )
+    parser_resolve.set_defaults(func=patterns_commands.cmd_patterns_resolve)

empathy_os/cli/parsers/provider.py

@@ -0,0 +1,40 @@
+"""Parser definitions for provider commands.
+
+Copyright 2025 Smart-AI-Memory
+Licensed under Fair Source License 0.9
+"""
+
+from ..commands import provider
+
+
+def register_parsers(subparsers):
+    """Register provider command parsers (Anthropic-only as of v5.0.0).
+
+    Args:
+        subparsers: ArgumentParser subparsers object from main parser
+    """
+    # Provider parent command
+    parser_provider = subparsers.add_parser(
+        "provider",
+        help="Configure Claude/Anthropic provider",
+    )
+    provider_sub = parser_provider.add_subparsers(dest="provider_command", required=True)
+
+    # Provider show command
+    p_show = provider_sub.add_parser(
+        "show",
+        help="Show current provider configuration",
+    )
+    p_show.set_defaults(func=provider.cmd_provider_show)
+
+    # Provider set command
+    p_set = provider_sub.add_parser(
+        "set",
+        help="Set default provider (must be 'anthropic')",
+    )
+    p_set.add_argument(
+        "name",
+        choices=["anthropic"],
+        help="Provider name (anthropic only)",
+    )
+    p_set.set_defaults(func=provider.cmd_provider_set)

empathy_os/cli/parsers/setup.py

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

@@ -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)

empathy_os/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)

empathy_os/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)

empathy_os/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)

empathy_os/cli/utils/__init__.py

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