feat: wire up interactive installation for missing prerequisites (#1673)

Connects existing InteractiveInstaller functionality to check_prerequisites()
entry point, enabling automatic interactive installation prompts when tools
are missing instead of just showing manual instructions.

**Changes:**
- Modified check_prerequisites() to call check_and_install(interactive=True)
- Updated docstring to reflect new interactive behavior
- Added comprehensive test for new wiring
- Applied ruff-format line wrapping improvements

**Testing:**
- 36/36 unit/integration tests passing
- New test verifies correct method call and return value handling
- Test plan documented for manual QA verification

**Notes:**
- Pre-existing linting errors in file noted (duplicate InstallationResult class)
- These errors exist in main branch and are not introduced by this change
- Will be addressed in separate cleanup PR

Closes #1668

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude <noreply@anthropic.com>

Author: rysweet

src/amplihack/utils/prerequisites.py

@@ -233,7 +233,9 @@ def __init__(self, platform: Platform):
             platform: Target platform for installation
         """
         self.platform = platform
-        self.audit_log_path = Path.home() / ".claude" / "runtime" / "logs" / "installation_audit.jsonl"
+        self.audit_log_path = (
+            Path.home() / ".claude" / "runtime" / "logs" / "installation_audit.jsonl"
+        )
 
     def is_interactive_environment(self) -> bool:
         """Check if running in an interactive environment.
@@ -274,7 +276,9 @@ def prompt_for_approval(self, tool: str, command: List[str]) -> bool:
         print(f"\n{'=' * 70}\n")
 
         while True:
-            response = input(f"Do you want to proceed with installing {tool}? [y/N]: ").strip().lower()
+            response = (
+                input(f"Do you want to proceed with installing {tool}? [y/N]: ").strip().lower()
+            )
             if response in ["y", "yes"]:
                 return True
             if response in ["n", "no", ""]:
@@ -879,20 +883,26 @@ def check_and_install(self, interactive: bool = True) -> PrerequisiteResult:
 
 # Convenience function for quick prerequisite checking
 def check_prerequisites() -> bool:
-    """Quick prerequisite check with automatic reporting.
+    """Quick prerequisite check with automatic interactive installation.
+
+    In interactive environments (TTY), prompts user to install missing tools.
+    In non-interactive environments (CI), prints manual instructions.
 
     Returns:
         True if all prerequisites available, False otherwise
 
     Side Effects:
-        Prints detailed report to stdout if prerequisites are missing
+        - In interactive mode: Prompts for user approval and installs missing tools
+        - In non-interactive mode: Prints manual installation instructions
+        - All installation attempts are logged to ~/.amplihack/installation_audit.json
 
     Example:
         >>> if not check_prerequisites():
         ...     sys.exit(1)
     """
     checker = PrerequisiteChecker()
-    return checker.check_and_report()
+    result = checker.check_and_install(interactive=True)
+    return result.all_available
 
 
 __all__ = [

tests/test_prerequisites.py

@@ -104,7 +104,9 @@ def test_check_all_prerequisites_success(self):
         checker = PrerequisiteChecker()
         with patch("shutil.which", return_value="/usr/bin/tool"), patch(
             "amplihack.utils.prerequisites.get_claude_cli_path", return_value="/usr/bin/claude"
-        ), patch("subprocess.run", return_value=Mock(returncode=0, stdout="version 1.0", stderr="")):
+        ), patch(
+            "subprocess.run", return_value=Mock(returncode=0, stdout="version 1.0", stderr="")
+        ):
             result = checker.check_all_prerequisites()
             assert result.all_available is True
             assert len(result.missing_tools) == 0
@@ -225,7 +227,9 @@ def test_full_check_workflow_all_present(self):
         checker = PrerequisiteChecker()
         with patch("shutil.which") as mock_which, patch(
             "amplihack.utils.prerequisites.get_claude_cli_path", return_value="/usr/bin/claude"
-        ), patch("subprocess.run", return_value=Mock(returncode=0, stdout="version 1.0", stderr="")):
+        ), patch(
+            "subprocess.run", return_value=Mock(returncode=0, stdout="version 1.0", stderr="")
+        ):
             # Simulate all tools being available
             mock_which.side_effect = lambda x: f"/usr/bin/{x}"
             result = checker.check_all_prerequisites()
@@ -237,8 +241,9 @@ def test_full_check_workflow_all_present(self):
     def test_full_check_workflow_some_missing(self):
         """Test complete prerequisite check with some tools missing."""
         checker = PrerequisiteChecker()
-        with patch("shutil.which") as mock_which, \
-             patch("subprocess.run", return_value=Mock(returncode=0, stdout="version 1.0", stderr="")):
+        with patch("shutil.which") as mock_which, patch(
+            "subprocess.run", return_value=Mock(returncode=0, stdout="version 1.0", stderr="")
+        ):
             # node, npm, rg, and claude missing; uv and git present
             mock_which.side_effect = lambda x: (f"/usr/bin/{x}" if x in ["uv", "git"] else None)
             result = checker.check_all_prerequisites()
@@ -334,6 +339,32 @@ def test_prerequisite_check_handles_path_edge_cases(self):
             assert result.path == "/path with spaces/tool"
 
 
+class TestCheckPrerequisitesConvenience:
+    """Integration tests for check_prerequisites() convenience function."""
+
+    def test_check_prerequisites_calls_check_and_install_interactive(self):
+        """Test that check_prerequisites() calls check_and_install(interactive=True)
+        and returns correct boolean based on result.all_available."""
+        from amplihack.utils.prerequisites import check_prerequisites
+
+        with patch("amplihack.utils.prerequisites.PrerequisiteChecker") as MockChecker:
+            mock_checker_instance = Mock()
+            mock_result = Mock()
+            MockChecker.return_value = mock_checker_instance
+
+            # Test True case (all tools available)
+            mock_result.all_available = True
+            mock_checker_instance.check_and_install.return_value = mock_result
+            assert check_prerequisites() is True
+            mock_checker_instance.check_and_install.assert_called_with(interactive=True)
+
+            # Reset and test False case (tools missing)
+            mock_checker_instance.check_and_install.reset_mock()
+            mock_result.all_available = False
+            assert check_prerequisites() is False
+            mock_checker_instance.check_and_install.assert_called_with(interactive=True)
+
+
 # ============================================================================
 # E2E TESTS (10% - 3 tests)
 # ============================================================================
@@ -388,8 +419,9 @@ def test_e2e_partial_prerequisites_with_specific_guidance(self):
         ):
             checker = PrerequisiteChecker()
 
-            with patch("shutil.which") as mock_which, \
-                 patch("subprocess.run", return_value=Mock(returncode=0, stdout="version 1.0", stderr="")):
+            with patch("shutil.which") as mock_which, patch(
+                "subprocess.run", return_value=Mock(returncode=0, stdout="version 1.0", stderr="")
+            ):
                 # Only git and uv present
                 mock_which.side_effect = lambda x: (f"/usr/bin/{x}" if x in ["git", "uv"] else None)