specfact-cli 0.4.2__py3-none-any.whl → 0.6.8__py3-none-any.whl

specfact_cli/commands/init.py

@@ -7,6 +7,7 @@ to IDE-specific locations for slash command integration.
 
 from __future__ import annotations
 
+import sys
 from pathlib import Path
 
 import typer
@@ -15,7 +16,14 @@ from icontract import ensure, require
 from rich.console import Console
 from rich.panel import Panel
 
-from specfact_cli.utils.ide_setup import IDE_CONFIG, copy_templates_to_ide, detect_ide
+from specfact_cli.telemetry import telemetry
+from specfact_cli.utils.ide_setup import (
+    IDE_CONFIG,
+    copy_templates_to_ide,
+    detect_ide,
+    find_package_resources_path,
+    get_package_installation_locations,
+)
 
 
 app = typer.Typer(help="Initialize SpecFact for IDE integration")
@@ -65,61 +73,222 @@ def init(
         specfact init --ide vscode --force  # Overwrite existing files
         specfact init --repo /path/to/repo --ide copilot
     """
-    # Resolve repo path
-    repo_path = repo.resolve()
-
-    # Detect IDE
-    detected_ide = detect_ide(ide)
-    ide_config = IDE_CONFIG[detected_ide]
-    ide_name = ide_config["name"]
-
-    console.print()
-    console.print(Panel("[bold cyan]SpecFact IDE Setup[/bold cyan]", border_style="cyan"))
-    console.print(f"[cyan]Repository:[/cyan] {repo_path}")
-    console.print(f"[cyan]IDE:[/cyan] {ide_name} ({detected_ide})")
-    console.print()
-
-    # Find templates directory
-    # Try relative to project root first (for development)
-    templates_dir = repo_path / "resources" / "prompts"
-    if not templates_dir.exists():
-        # Try relative to installed package (for distribution)
-        import importlib.util
-
-        spec = importlib.util.find_spec("specfact_cli")
-        if spec and spec.origin:
-            package_dir = Path(spec.origin).parent.parent
-            templates_dir = package_dir / "resources" / "prompts"
-            if not templates_dir.exists():
-                # Fallback: try resources/prompts in project root
-                templates_dir = Path(__file__).parent.parent.parent.parent / "resources" / "prompts"
-
-    if not templates_dir.exists():
-        console.print(f"[red]Error:[/red] Templates directory not found: {templates_dir}")
-        console.print("[yellow]Expected location:[/yellow] resources/prompts/")
-        console.print("[yellow]Please ensure SpecFact is properly installed.[/yellow]")
-        raise typer.Exit(1)
-
-    console.print(f"[cyan]Templates:[/cyan] {templates_dir}")
-    console.print()
-
-    # Copy templates to IDE location
-    try:
-        copied_files, settings_path = copy_templates_to_ide(repo_path, detected_ide, templates_dir, force)
-
-        if not copied_files:
-            console.print("[yellow]No templates copied (all files already exist, use --force to overwrite)[/yellow]")
-            raise typer.Exit(0)
+    telemetry_metadata = {
+        "ide": ide,
+        "force": force,
+    }
+
+    with telemetry.track_command("init", telemetry_metadata) as record:
+        # Resolve repo path
+        repo_path = repo.resolve()
+
+        # Detect IDE
+        detected_ide = detect_ide(ide)
+        ide_config = IDE_CONFIG[detected_ide]
+        ide_name = ide_config["name"]
 
         console.print()
-        console.print(Panel("[bold green]✓ Initialization Complete[/bold green]", border_style="green"))
-        console.print(f"[green]Copied {len(copied_files)} template(s) to {ide_config['folder']}[/green]")
-        if settings_path:
-            console.print(f"[green]Updated VS Code settings:[/green] {settings_path}")
+        console.print(Panel("[bold cyan]SpecFact IDE Setup[/bold cyan]", border_style="cyan"))
+        console.print(f"[cyan]Repository:[/cyan] {repo_path}")
+        console.print(f"[cyan]IDE:[/cyan] {ide_name} ({detected_ide})")
         console.print()
-        console.print("[dim]You can now use SpecFact slash commands in your IDE![/dim]")
-        console.print("[dim]Example: /specfact-import-from-code --repo . --confidence 0.7[/dim]")
 
-    except Exception as e:
-        console.print(f"[red]Error:[/red] Failed to initialize IDE integration: {e}")
-        raise typer.Exit(1) from e
+        # Find templates directory
+        # Priority order:
+        # 1. Development: relative to project root (resources/prompts)
+        # 2. Installed package: use importlib.resources to find package location
+        # 3. Fallback: try relative to this file (for edge cases)
+        templates_dir: Path | None = None
+        package_templates_dir: Path | None = None
+        tried_locations: list[Path] = []
+
+        # Try 1: Development mode - relative to repo root
+        dev_templates_dir = (repo_path / "resources" / "prompts").resolve()
+        tried_locations.append(dev_templates_dir)
+        console.print(f"[dim]Debug:[/dim] Trying development path: {dev_templates_dir}")
+        if dev_templates_dir.exists():
+            templates_dir = dev_templates_dir
+            console.print(f"[green]✓[/green] Found templates at: {templates_dir}")
+        else:
+            console.print("[dim]Debug:[/dim] Development path not found, trying installed package...")
+            # Try 2: Installed package - use importlib.resources
+            # Note: importlib is part of Python's standard library (since Python 3.1)
+            # importlib.resources.files() is available since Python 3.9
+            # Since we require Python >=3.11, this should always be available
+            # However, we catch exceptions for robustness (minimal installations, edge cases)
+            package_templates_dir = None
+            try:
+                import importlib.resources
+
+                console.print("[dim]Debug:[/dim] Using importlib.resources.files() API...")
+                # Use files() API (Python 3.9+) - recommended approach
+                resources_ref = importlib.resources.files("specfact_cli")
+                templates_ref = resources_ref / "resources" / "prompts"
+                # Convert Traversable to Path
+                # Traversable objects can be converted to Path via str()
+                # Use resolve() to handle Windows/Linux/macOS path differences
+                package_templates_dir = Path(str(templates_ref)).resolve()
+                tried_locations.append(package_templates_dir)
+                console.print(f"[dim]Debug:[/dim] Package templates path: {package_templates_dir}")
+                if package_templates_dir.exists():
+                    templates_dir = package_templates_dir
+                    console.print(f"[green]✓[/green] Found templates at: {templates_dir}")
+                else:
+                    console.print("[yellow]⚠[/yellow] Package templates path exists but directory not found")
+            except (ImportError, ModuleNotFoundError) as e:
+                console.print(
+                    f"[yellow]⚠[/yellow] importlib.resources not available or module not found: {type(e).__name__}: {e}"
+                )
+                console.print("[dim]Debug:[/dim] Falling back to importlib.util.find_spec()...")
+            except (TypeError, AttributeError, ValueError) as e:
+                console.print(f"[yellow]⚠[/yellow] Error converting Traversable to Path: {e}")
+                console.print("[dim]Debug:[/dim] Falling back to importlib.util.find_spec()...")
+            except Exception as e:
+                console.print(f"[yellow]⚠[/yellow] Unexpected error with importlib.resources: {type(e).__name__}: {e}")
+                console.print("[dim]Debug:[/dim] Falling back to importlib.util.find_spec()...")
+
+            # Fallback: importlib.util.find_spec() + comprehensive package location search
+            if not templates_dir or not templates_dir.exists():
+                try:
+                    import importlib.util
+
+                    console.print("[dim]Debug:[/dim] Using importlib.util.find_spec() fallback...")
+                    spec = importlib.util.find_spec("specfact_cli")
+                    if spec and spec.origin:
+                        # spec.origin points to __init__.py
+                        # Go up to package root, then to resources/prompts
+                        # Use resolve() for cross-platform compatibility
+                        package_root = Path(spec.origin).parent.resolve()
+                        package_templates_dir = (package_root / "resources" / "prompts").resolve()
+                        tried_locations.append(package_templates_dir)
+                        console.print(f"[dim]Debug:[/dim] Package root from spec.origin: {package_root}")
+                        console.print(f"[dim]Debug:[/dim] Templates path from spec: {package_templates_dir}")
+                        if package_templates_dir.exists():
+                            templates_dir = package_templates_dir
+                            console.print(f"[green]✓[/green] Found templates at: {templates_dir}")
+                        else:
+                            console.print("[yellow]⚠[/yellow] Templates path from spec not found")
+                    else:
+                        console.print("[yellow]⚠[/yellow] Could not find specfact_cli module spec")
+                        if spec is None:
+                            console.print("[dim]Debug:[/dim] spec is None")
+                        elif not spec.origin:
+                            console.print("[dim]Debug:[/dim] spec.origin is None or empty")
+                except Exception as e:
+                    console.print(f"[yellow]⚠[/yellow] Error with importlib.util.find_spec(): {type(e).__name__}: {e}")
+
+            # Fallback: Comprehensive package location search (cross-platform)
+            if not templates_dir or not templates_dir.exists():
+                try:
+                    console.print("[dim]Debug:[/dim] Searching all package installation locations...")
+                    package_locations = get_package_installation_locations("specfact_cli")
+                    console.print(f"[dim]Debug:[/dim] Found {len(package_locations)} possible package location(s)")
+                    for i, loc in enumerate(package_locations, 1):
+                        console.print(f"[dim]Debug:[/dim]   {i}. {loc}")
+                        # Check for resources/prompts in this package location
+                        resource_path = (loc / "resources" / "prompts").resolve()
+                        tried_locations.append(resource_path)
+                        if resource_path.exists():
+                            templates_dir = resource_path
+                            console.print(f"[green]✓[/green] Found templates at: {templates_dir}")
+                            break
+                    if not templates_dir or not templates_dir.exists():
+                        # Try using the helper function as a final attempt
+                        console.print("[dim]Debug:[/dim] Trying find_package_resources_path() helper...")
+                        resource_path = find_package_resources_path("specfact_cli", "resources/prompts")
+                        if resource_path and resource_path.exists():
+                            tried_locations.append(resource_path)
+                            templates_dir = resource_path
+                            console.print(f"[green]✓[/green] Found templates at: {templates_dir}")
+                        else:
+                            console.print("[yellow]⚠[/yellow] Resources not found in any package location")
+                except Exception as e:
+                    console.print(f"[yellow]⚠[/yellow] Error searching package locations: {type(e).__name__}: {e}")
+
+            # Try 3: Fallback - relative to this file (for edge cases)
+            if not templates_dir or not templates_dir.exists():
+                try:
+                    console.print("[dim]Debug:[/dim] Trying fallback: relative to __file__...")
+                    # Get the directory containing this file (init.py)
+                    # init.py is in: src/specfact_cli/commands/init.py
+                    # Go up: commands -> specfact_cli -> src -> project root
+                    current_file = Path(__file__).resolve()
+                    fallback_dir = (current_file.parent.parent.parent.parent / "resources" / "prompts").resolve()
+                    tried_locations.append(fallback_dir)
+                    console.print(f"[dim]Debug:[/dim] Current file: {current_file}")
+                    console.print(f"[dim]Debug:[/dim] Fallback templates path: {fallback_dir}")
+                    if fallback_dir.exists():
+                        templates_dir = fallback_dir
+                        console.print(f"[green]✓[/green] Found templates at: {templates_dir}")
+                    else:
+                        console.print("[yellow]⚠[/yellow] Fallback path not found")
+                except Exception as e:
+                    console.print(f"[yellow]⚠[/yellow] Error with __file__ fallback: {type(e).__name__}: {e}")
+
+        if not templates_dir or not templates_dir.exists():
+            console.print()
+            console.print("[red]Error:[/red] Templates directory not found after all attempts")
+            console.print()
+            console.print("[yellow]Tried locations:[/yellow]")
+            for i, location in enumerate(tried_locations, 1):
+                exists = "✓" if location.exists() else "✗"
+                console.print(f"  {i}. {exists} {location}")
+            console.print()
+            console.print("[yellow]Debug information:[/yellow]")
+            console.print(f"  - Python version: {sys.version}")
+            console.print(f"  - Platform: {sys.platform}")
+            console.print(f"  - Current working directory: {Path.cwd()}")
+            console.print(f"  - Repository path: {repo_path}")
+            console.print(f"  - __file__ location: {Path(__file__).resolve()}")
+            try:
+                import importlib.util
+
+                spec = importlib.util.find_spec("specfact_cli")
+                if spec:
+                    console.print(f"  - Module spec found: {spec}")
+                    console.print(f"  - Module origin: {spec.origin}")
+                    if spec.origin:
+                        console.print(f"  - Module location: {Path(spec.origin).parent.resolve()}")
+                else:
+                    console.print("  - Module spec: Not found")
+            except Exception as e:
+                console.print(f"  - Error checking module spec: {e}")
+            console.print()
+            console.print("[yellow]Expected location:[/yellow] resources/prompts/")
+            console.print("[yellow]Please ensure SpecFact is properly installed.[/yellow]")
+            raise typer.Exit(1)
+
+        console.print(f"[cyan]Templates:[/cyan] {templates_dir}")
+        console.print()
+
+        # Copy templates to IDE location
+        try:
+            copied_files, settings_path = copy_templates_to_ide(repo_path, detected_ide, templates_dir, force)
+
+            if not copied_files:
+                console.print(
+                    "[yellow]No templates copied (all files already exist, use --force to overwrite)[/yellow]"
+                )
+                record({"files_copied": 0, "already_exists": True})
+                raise typer.Exit(0)
+
+            record(
+                {
+                    "detected_ide": detected_ide,
+                    "files_copied": len(copied_files),
+                    "settings_updated": settings_path is not None,
+                }
+            )
+
+            console.print()
+            console.print(Panel("[bold green]✓ Initialization Complete[/bold green]", border_style="green"))
+            console.print(f"[green]Copied {len(copied_files)} template(s) to {ide_config['folder']}[/green]")
+            if settings_path:
+                console.print(f"[green]Updated VS Code settings:[/green] {settings_path}")
+            console.print()
+            console.print("[dim]You can now use SpecFact slash commands in your IDE![/dim]")
+            console.print("[dim]Example: /specfact-import-from-code --repo . --confidence 0.7[/dim]")
+
+        except Exception as e:
+            console.print(f"[red]Error:[/red] Failed to initialize IDE integration: {e}")
+            raise typer.Exit(1) from e