gitflow-analytics 3.3.0__py3-none-any.whl → 3.4.7__py3-none-any.whl

gitflow_analytics/_version.py

@@ -1,4 +1,4 @@
 """Version information for gitflow-analytics."""
 
-__version__ = "3.3.0"
+__version__ = "3.4.7"
 __version_info__ = tuple(int(x) for x in __version__.split("."))

gitflow_analytics/cli.py

@@ -33,6 +33,8 @@ from .reports.weekly_trends_writer import WeeklyTrendsWriter
 from .training.pipeline import CommitClassificationTrainer
 from .ui.progress_display import create_progress_display
 
+logger = logging.getLogger(__name__)
+
 
 class RichHelpFormatter:
     """Rich help formatter for enhanced CLI help display."""
@@ -48,8 +50,19 @@ class RichHelpFormatter:
         return help_text
 
     @staticmethod
-    def format_option_help(description: str, default: Any = None, choices: list = None) -> str:
-        """Format option help with default and choices."""
+    def format_option_help(
+        description: str, default: Optional[str] = None, choices: Optional[list[str]] = None
+    ) -> str:
+        """Format option help with default and choices.
+
+        Args:
+            description: Option description text
+            default: Default value to display (optional)
+            choices: List of valid choices (optional)
+
+        Returns:
+            Formatted help text string
+        """
         help_text = description
         if default is not None:
             help_text += f" [default: {default}]"
@@ -281,12 +294,18 @@ class TUIAsDefaultGroup(click.Group):
         if args and args[0].startswith("-"):
             # Check if TUI dependencies are available
             try:
-                import textual
+                import importlib.util
 
+                textual_spec = importlib.util.find_spec("textual")
                 # TUI is available - route to TUI
-                new_args = ["tui"] + args
-                return super().parse_args(ctx, new_args)
-            except ImportError:
+                if textual_spec is not None:
+                    new_args = ["tui"] + args
+                    return super().parse_args(ctx, new_args)
+                else:
+                    # TUI not available - fallback to analyze
+                    new_args = ["analyze"] + args
+                    return super().parse_args(ctx, new_args)
+            except (ImportError, ValueError):
                 # TUI not available - fallback to analyze
                 new_args = ["analyze"] + args
                 return super().parse_args(ctx, new_args)
@@ -1066,10 +1085,7 @@ def analyze(
                 )
 
                 # Extract commits from the raw data
-                if raw_data and raw_data.get("commits"):
-                    commits = raw_data["commits"]
-                else:
-                    commits = []
+                commits = raw_data["commits"] if raw_data and raw_data.get("commits") else []
                 all_commits.extend(commits)
 
             if not all_commits:
@@ -4460,6 +4476,114 @@ def merge_identity(config: Path, dev1: str, dev2: str) -> None:
         sys.exit(1)
 
 
+@cli.command(name="run")
+@click.option(
+    "--config",
+    "-c",
+    type=click.Path(exists=True, path_type=Path),
+    help="Path to configuration file (optional, will search for default)",
+)
+def run_launcher(config: Optional[Path]) -> None:
+    """Interactive launcher for gitflow-analytics.
+
+    \b
+    This interactive command guides you through:
+      • Repository selection (multi-select)
+      • Analysis period configuration
+      • Cache management
+      • Identity analysis preferences
+      • Preferences storage
+
+    \b
+    EXAMPLES:
+      # Launch interactive mode
+      gitflow-analytics run
+
+      # Launch with specific config
+      gitflow-analytics run -c config.yaml
+
+    \b
+    PREFERENCES:
+      Your selections are saved to the launcher section
+      in your configuration file for future use.
+
+    \b
+    WORKFLOW:
+      1. Select repositories to analyze
+      2. Choose analysis period (weeks)
+      3. Configure cache clearing
+      4. Set identity analysis preference
+      5. Run analysis with your selections
+    """
+    try:
+        from .cli_wizards.run_launcher import run_interactive_launcher
+
+        success = run_interactive_launcher(config_path=config)
+        sys.exit(0 if success else 1)
+
+    except Exception as e:
+        click.echo(f"❌ Launcher failed: {e}", err=True)
+        logger.error(f"Launcher error: {type(e).__name__}")
+        sys.exit(1)
+
+
+@cli.command(name="install")
+@click.option(
+    "--output-dir",
+    type=click.Path(path_type=Path),
+    default=".",
+    help="Directory for config files (default: current directory)",
+)
+@click.option(
+    "--skip-validation",
+    is_flag=True,
+    help="Skip credential validation (for testing)",
+)
+def install_command(output_dir: Path, skip_validation: bool) -> None:
+    """Interactive installation wizard for GitFlow Analytics.
+
+    \b
+    This wizard will guide you through setting up GitFlow Analytics:
+    • GitHub credentials and repository configuration
+    • Optional JIRA integration
+    • Optional AI-powered insights (OpenRouter/ChatGPT)
+    • Analysis settings and defaults
+
+    \b
+    EXAMPLES:
+      # Run installation wizard in current directory
+      gitflow-analytics install
+
+      # Install to specific directory
+      gitflow-analytics install --output-dir ./my-config
+
+    \b
+    The wizard will:
+    1. Validate all credentials before saving
+    2. Generate config.yaml and .env files
+    3. Set secure permissions on .env (0600)
+    4. Update .gitignore if in a git repository
+    5. Test the configuration
+    6. Optionally run initial analysis
+
+    \b
+    SECURITY NOTES:
+      • .env file contains sensitive credentials
+      • Never commit .env to version control
+      • File permissions set to owner-only (0600)
+    """
+    try:
+        from .cli_wizards.install_wizard import InstallWizard
+
+        wizard = InstallWizard(output_dir=Path(output_dir), skip_validation=skip_validation)
+        success = wizard.run()
+        sys.exit(0 if success else 1)
+
+    except Exception as e:
+        click.echo(f"❌ Installation failed: {e}", err=True)
+        sys.exit(1)
+
+
 @cli.command(name="discover-storypoint-fields")
 @click.option(
     "--config",
@@ -4672,16 +4796,41 @@ def identities(config: Path, weeks: int, apply: bool) -> None:
             # Show suggestions
             click.echo(f"\n⚠️  Found {len(identity_result.clusters)} potential identity clusters:")
 
-            # Display all mappings
+            # Display all mappings with confidence scores
             if suggested_config.get("analysis", {}).get("manual_identity_mappings"):
                 click.echo("\n📋 Suggested identity mappings:")
-                for mapping in suggested_config["analysis"]["manual_identity_mappings"]:
-                    canonical = mapping["canonical_email"]
+                for i, mapping in enumerate(
+                    suggested_config["analysis"]["manual_identity_mappings"], 1
+                ):
+                    canonical = mapping["primary_email"]
                     aliases = mapping.get("aliases", [])
+                    confidence = mapping.get("confidence", 0.0)
+                    reasoning = mapping.get("reasoning", "")
+
+                    # Color-code based on confidence (90%+ threshold)
+                    if confidence >= 0.95:
+                        confidence_indicator = "🟢"  # Very high confidence
+                    elif confidence >= 0.90:
+                        confidence_indicator = "🟡"  # High confidence (above threshold)
+                    else:
+                        confidence_indicator = "🟠"  # Medium confidence (below threshold)
+
                     if aliases:
-                        click.echo(f"   {canonical}")
+                        click.echo(
+                            f"\n   {confidence_indicator} Cluster {i} "
+                            f"(Confidence: {confidence:.1%}):"
+                        )
+                        click.echo(f"      Primary: {canonical}")
                         for alias in aliases:
-                            click.echo(f"     → {alias}")
+                            click.echo(f"      Alias:   {alias}")
+
+                        # Show reasoning if available
+                        if reasoning:
+                            # Truncate reasoning for display
+                            display_reasoning = (
+                                reasoning if len(reasoning) <= 80 else reasoning[:77] + "..."
+                            )
+                            click.echo(f"      Reason:  {display_reasoning}")
 
             # Check for bot exclusions
             if suggested_config.get("exclude", {}).get("authors"):

gitflow_analytics/cli_wizards/__init__.py

@@ -0,0 +1,10 @@
+"""CLI subpackage for GitFlow Analytics.
+
+This package contains CLI-related modules including the installation wizard
+and interactive launcher.
+"""
+
+from .install_wizard import InstallWizard
+from .run_launcher import InteractiveLauncher, run_interactive_launcher
+
+__all__ = ["InstallWizard", "InteractiveLauncher", "run_interactive_launcher"]