empathy-framework 3.5.6__py3-none-any.whl → 3.7.0__py3-none-any.whl

coach_wizards/base_wizard.py

@@ -1,5 +1,4 @@
-"""
-Base Coach Wizard - Foundation for all Coach wizards
+"""Base Coach Wizard - Foundation for all Coach wizards
 
 Level 4 Anticipatory Empathy implementation using the Empathy Framework.
 
@@ -56,8 +55,7 @@ class WizardResult:
 
 
 class BaseCoachWizard(ABC):
-    """
-    Base class for all Coach wizards
+    """Base class for all Coach wizards
 
     Implements Level 4 Anticipatory Empathy:
     - Analyzes current code
@@ -73,8 +71,7 @@ class BaseCoachWizard(ABC):
 
     @abstractmethod
     def analyze_code(self, code: str, file_path: str, language: str) -> list[WizardIssue]:
-        """
-        Analyze code for current issues
+        """Analyze code for current issues
 
         Args:
             code: Source code to analyze
@@ -83,15 +80,18 @@ class BaseCoachWizard(ABC):
 
         Returns:
             List of issues found
+
         """
-        pass
 
     @abstractmethod
     def predict_future_issues(
-        self, code: str, file_path: str, project_context: dict[str, Any], timeline_days: int = 90
+        self,
+        code: str,
+        file_path: str,
+        project_context: dict[str, Any],
+        timeline_days: int = 90,
     ) -> list[WizardPrediction]:
-        """
-        Level 4 Anticipatory: Predict issues 30-90 days ahead
+        """Level 4 Anticipatory: Predict issues 30-90 days ahead
 
         Args:
             code: Source code to analyze
@@ -101,21 +101,20 @@ class BaseCoachWizard(ABC):
 
         Returns:
             List of predicted future issues
+
         """
-        pass
 
     @abstractmethod
     def suggest_fixes(self, issue: WizardIssue) -> str:
-        """
-        Suggest how to fix an issue
+        """Suggest how to fix an issue
 
         Args:
             issue: The issue to fix
 
         Returns:
             Fix suggestion with code examples
+
         """
-        pass
 
     def run_full_analysis(
         self,
@@ -124,8 +123,7 @@ class BaseCoachWizard(ABC):
         language: str,
         project_context: dict[str, Any] | None = None,
     ) -> WizardResult:
-        """
-        Run complete analysis: current issues + future predictions
+        """Run complete analysis: current issues + future predictions
 
         Args:
             code: Source code to analyze
@@ -135,6 +133,7 @@ class BaseCoachWizard(ABC):
 
         Returns:
             Complete wizard result
+
         """
         start_time = datetime.now()
 
@@ -145,7 +144,10 @@ class BaseCoachWizard(ABC):
         predictions = []
         if project_context:
             predictions = self.predict_future_issues(
-                code, file_path, project_context, timeline_days=90
+                code,
+                file_path,
+                project_context,
+                timeline_days=90,
             )
 
         # Generate recommendations
@@ -167,7 +169,9 @@ class BaseCoachWizard(ABC):
         )
 
     def _generate_recommendations(
-        self, issues: list[WizardIssue], predictions: list[WizardPrediction]
+        self,
+        issues: list[WizardIssue],
+        predictions: list[WizardPrediction],
     ) -> list[str]:
         """Generate actionable recommendations"""
         recommendations = []
@@ -181,13 +185,15 @@ class BaseCoachWizard(ABC):
         high_probability_predictions = [p for p in predictions if p.probability > 0.7]
         if high_probability_predictions:
             recommendations.append(
-                f"Prevent {len(high_probability_predictions)} predicted issues with high probability"
+                f"Prevent {len(high_probability_predictions)} predicted issues with high probability",
             )
 
         return recommendations
 
     def _generate_summary(
-        self, issues: list[WizardIssue], predictions: list[WizardPrediction]
+        self,
+        issues: list[WizardIssue],
+        predictions: list[WizardPrediction],
     ) -> str:
         """Generate human-readable summary"""
         error_count = len([i for i in issues if i.severity == "error"])

coach_wizards/cicd_wizard.py

@@ -1,5 +1,4 @@
-"""
-CICDWizard - CI/CD pipeline optimization
+"""CICDWizard - CI/CD pipeline optimization
 
 Level 4 Anticipatory Empathy for DevOps using the Empathy Framework.
 
@@ -13,8 +12,7 @@ from .base_wizard import BaseCoachWizard, WizardIssue, WizardPrediction
 
 
 class CICDWizard(BaseCoachWizard):
-    """
-    CI/CD pipeline optimization
+    """CI/CD pipeline optimization
 
     Detects:
     - slow pipelines
@@ -30,12 +28,13 @@ class CICDWizard(BaseCoachWizard):
 
     def __init__(self):
         super().__init__(
-            name="CICDWizard", category="DevOps", languages=["yaml", "groovy", "python", "bash"]
+            name="CICDWizard",
+            category="DevOps",
+            languages=["yaml", "groovy", "python", "bash"],
         )
 
     def analyze_code(self, code: str, file_path: str, language: str) -> list[WizardIssue]:
-        """
-        Analyze code for devops issues
+        """Analyze code for devops issues
 
         This is a reference implementation. In production, integrate with:
         - Static analysis tools
@@ -55,10 +54,13 @@ class CICDWizard(BaseCoachWizard):
         return issues
 
     def predict_future_issues(
-        self, code: str, file_path: str, project_context: dict[str, Any], timeline_days: int = 90
+        self,
+        code: str,
+        file_path: str,
+        project_context: dict[str, Any],
+        timeline_days: int = 90,
     ) -> list[WizardPrediction]:
-        """
-        Level 4 Anticipatory: Predict devops issues {timeline_days} days ahead
+        """Level 4 Anticipatory: Predict devops issues {timeline_days} days ahead
 
         Uses:
         - Historical patterns
@@ -74,16 +76,16 @@ class CICDWizard(BaseCoachWizard):
 
         self.logger.info(
             f"{self.name} predicted {len(predictions)} future issues "
-            f"for {file_path} ({timeline_days} days ahead)"
+            f"for {file_path} ({timeline_days} days ahead)",
         )
         return predictions
 
     def suggest_fixes(self, issue: WizardIssue) -> str:
-        """
-        Suggest how to fix a devops issue
+        """Suggest how to fix a devops issue
 
         Returns:
             Detailed fix suggestion with code examples
+
         """
         # Implementation depends on issue type
         return f"Fix suggestion for {issue.category} issue: {issue.message}"

coach_wizards/compliance_wizard.py

@@ -1,5 +1,4 @@
-"""
-ComplianceWizard - Regulatory and compliance checking
+"""ComplianceWizard - Regulatory and compliance checking
 
 Level 4 Anticipatory Empathy for Compliance using the Empathy Framework.
 
@@ -13,8 +12,7 @@ from .base_wizard import BaseCoachWizard, WizardIssue, WizardPrediction
 
 
 class ComplianceWizard(BaseCoachWizard):
-    """
-    Regulatory and compliance checking
+    """Regulatory and compliance checking
 
     Detects:
     - PII handling issues
@@ -36,8 +34,7 @@ class ComplianceWizard(BaseCoachWizard):
         )
 
     def analyze_code(self, code: str, file_path: str, language: str) -> list[WizardIssue]:
-        """
-        Analyze code for compliance issues
+        """Analyze code for compliance issues
 
         This is a reference implementation. In production, integrate with:
         - Static analysis tools
@@ -57,10 +54,13 @@ class ComplianceWizard(BaseCoachWizard):
         return issues
 
     def predict_future_issues(
-        self, code: str, file_path: str, project_context: dict[str, Any], timeline_days: int = 90
+        self,
+        code: str,
+        file_path: str,
+        project_context: dict[str, Any],
+        timeline_days: int = 90,
     ) -> list[WizardPrediction]:
-        """
-        Level 4 Anticipatory: Predict compliance issues {timeline_days} days ahead
+        """Level 4 Anticipatory: Predict compliance issues {timeline_days} days ahead
 
         Uses:
         - Historical patterns
@@ -76,16 +76,16 @@ class ComplianceWizard(BaseCoachWizard):
 
         self.logger.info(
             f"{self.name} predicted {len(predictions)} future issues "
-            f"for {file_path} ({timeline_days} days ahead)"
+            f"for {file_path} ({timeline_days} days ahead)",
         )
         return predictions
 
     def suggest_fixes(self, issue: WizardIssue) -> str:
-        """
-        Suggest how to fix a compliance issue
+        """Suggest how to fix a compliance issue
 
         Returns:
             Detailed fix suggestion with code examples
+
         """
         # Implementation depends on issue type
         return f"Fix suggestion for {issue.category} issue: {issue.message}"

coach_wizards/database_wizard.py

@@ -1,5 +1,4 @@
-"""
-DatabaseWizard - Database optimization and schema analysis
+"""DatabaseWizard - Database optimization and schema analysis
 
 Level 4 Anticipatory Empathy for Database using the Empathy Framework.
 
@@ -13,8 +12,7 @@ from .base_wizard import BaseCoachWizard, WizardIssue, WizardPrediction
 
 
 class DatabaseWizard(BaseCoachWizard):
-    """
-    Database optimization and schema analysis
+    """Database optimization and schema analysis
 
     Detects:
     - missing indexes
@@ -36,8 +34,7 @@ class DatabaseWizard(BaseCoachWizard):
         )
 
     def analyze_code(self, code: str, file_path: str, language: str) -> list[WizardIssue]:
-        """
-        Analyze code for database issues
+        """Analyze code for database issues
 
         This is a reference implementation. In production, integrate with:
         - Static analysis tools
@@ -57,10 +54,13 @@ class DatabaseWizard(BaseCoachWizard):
         return issues
 
     def predict_future_issues(
-        self, code: str, file_path: str, project_context: dict[str, Any], timeline_days: int = 90
+        self,
+        code: str,
+        file_path: str,
+        project_context: dict[str, Any],
+        timeline_days: int = 90,
     ) -> list[WizardPrediction]:
-        """
-        Level 4 Anticipatory: Predict database issues {timeline_days} days ahead
+        """Level 4 Anticipatory: Predict database issues {timeline_days} days ahead
 
         Uses:
         - Historical patterns
@@ -76,16 +76,16 @@ class DatabaseWizard(BaseCoachWizard):
 
         self.logger.info(
             f"{self.name} predicted {len(predictions)} future issues "
-            f"for {file_path} ({timeline_days} days ahead)"
+            f"for {file_path} ({timeline_days} days ahead)",
         )
         return predictions
 
     def suggest_fixes(self, issue: WizardIssue) -> str:
-        """
-        Suggest how to fix a database issue
+        """Suggest how to fix a database issue
 
         Returns:
             Detailed fix suggestion with code examples
+
         """
         # Implementation depends on issue type
         return f"Fix suggestion for {issue.category} issue: {issue.message}"

coach_wizards/debugging_wizard.py

@@ -1,5 +1,4 @@
-"""
-DebuggingWizard - Error detection and debugging assistance
+"""DebuggingWizard - Error detection and debugging assistance
 
 Level 4 Anticipatory Empathy for Debugging using the Empathy Framework.
 
@@ -13,8 +12,7 @@ from .base_wizard import BaseCoachWizard, WizardIssue, WizardPrediction
 
 
 class DebuggingWizard(BaseCoachWizard):
-    """
-    Error detection and debugging assistance
+    """Error detection and debugging assistance
 
     Detects:
     - potential null references
@@ -36,8 +34,7 @@ class DebuggingWizard(BaseCoachWizard):
         )
 
     def analyze_code(self, code: str, file_path: str, language: str) -> list[WizardIssue]:
-        """
-        Analyze code for debugging issues
+        """Analyze code for debugging issues
 
         This is a reference implementation. In production, integrate with:
         - Static analysis tools
@@ -57,10 +54,13 @@ class DebuggingWizard(BaseCoachWizard):
         return issues
 
     def predict_future_issues(
-        self, code: str, file_path: str, project_context: dict[str, Any], timeline_days: int = 90
+        self,
+        code: str,
+        file_path: str,
+        project_context: dict[str, Any],
+        timeline_days: int = 90,
     ) -> list[WizardPrediction]:
-        """
-        Level 4 Anticipatory: Predict debugging issues {timeline_days} days ahead
+        """Level 4 Anticipatory: Predict debugging issues {timeline_days} days ahead
 
         Uses:
         - Historical patterns
@@ -76,16 +76,16 @@ class DebuggingWizard(BaseCoachWizard):
 
         self.logger.info(
             f"{self.name} predicted {len(predictions)} future issues "
-            f"for {file_path} ({timeline_days} days ahead)"
+            f"for {file_path} ({timeline_days} days ahead)",
         )
         return predictions
 
     def suggest_fixes(self, issue: WizardIssue) -> str:
-        """
-        Suggest how to fix a debugging issue
+        """Suggest how to fix a debugging issue
 
         Returns:
             Detailed fix suggestion with code examples
+
         """
         # Implementation depends on issue type
         return f"Fix suggestion for {issue.category} issue: {issue.message}"

coach_wizards/documentation_wizard.py

@@ -1,5 +1,4 @@
-"""
-DocumentationWizard - Documentation quality and completeness
+"""DocumentationWizard - Documentation quality and completeness
 
 Level 4 Anticipatory Empathy for Documentation using the Empathy Framework.
 
@@ -13,8 +12,7 @@ from .base_wizard import BaseCoachWizard, WizardIssue, WizardPrediction
 
 
 class DocumentationWizard(BaseCoachWizard):
-    """
-    Documentation quality and completeness
+    """Documentation quality and completeness
 
     Detects:
     - missing docstrings
@@ -36,8 +34,7 @@ class DocumentationWizard(BaseCoachWizard):
         )
 
     def analyze_code(self, code: str, file_path: str, language: str) -> list[WizardIssue]:
-        """
-        Analyze code for documentation issues
+        """Analyze code for documentation issues
 
         This is a reference implementation. In production, integrate with:
         - Static analysis tools
@@ -57,10 +54,13 @@ class DocumentationWizard(BaseCoachWizard):
         return issues
 
     def predict_future_issues(
-        self, code: str, file_path: str, project_context: dict[str, Any], timeline_days: int = 90
+        self,
+        code: str,
+        file_path: str,
+        project_context: dict[str, Any],
+        timeline_days: int = 90,
     ) -> list[WizardPrediction]:
-        """
-        Level 4 Anticipatory: Predict documentation issues {timeline_days} days ahead
+        """Level 4 Anticipatory: Predict documentation issues {timeline_days} days ahead
 
         Uses:
         - Historical patterns
@@ -76,16 +76,16 @@ class DocumentationWizard(BaseCoachWizard):
 
         self.logger.info(
             f"{self.name} predicted {len(predictions)} future issues "
-            f"for {file_path} ({timeline_days} days ahead)"
+            f"for {file_path} ({timeline_days} days ahead)",
         )
         return predictions
 
     def suggest_fixes(self, issue: WizardIssue) -> str:
-        """
-        Suggest how to fix a documentation issue
+        """Suggest how to fix a documentation issue
 
         Returns:
             Detailed fix suggestion with code examples
+
         """
         # Implementation depends on issue type
         return f"Fix suggestion for {issue.category} issue: {issue.message}"

coach_wizards/generate_wizards.py

@@ -1,6 +1,5 @@
 #!/usr/bin/env python3
-"""
-Generate all 16 Coach wizards from template.
+"""Generate all 16 Coach wizards from template.
 
 This script generates the 16 specialized Coach wizards.
 This is a development/build utility, excluded from coverage via .coveragerc.

coach_wizards/localization_wizard.py

@@ -1,5 +1,4 @@
-"""
-LocalizationWizard - Internationalization and localization
+"""LocalizationWizard - Internationalization and localization
 
 Level 4 Anticipatory Empathy for Localization using the Empathy Framework.
 
@@ -13,8 +12,7 @@ from .base_wizard import BaseCoachWizard, WizardIssue, WizardPrediction
 
 
 class LocalizationWizard(BaseCoachWizard):
-    """
-    Internationalization and localization
+    """Internationalization and localization
 
     Detects:
     - hardcoded strings
@@ -36,8 +34,7 @@ class LocalizationWizard(BaseCoachWizard):
         )
 
     def analyze_code(self, code: str, file_path: str, language: str) -> list[WizardIssue]:
-        """
-        Analyze code for localization issues
+        """Analyze code for localization issues
 
         This is a reference implementation. In production, integrate with:
         - Static analysis tools
@@ -59,7 +56,11 @@ class LocalizationWizard(BaseCoachWizard):
         return issues
 
     def _check_hardcoded_string(
-        self, line: str, line_num: int, file_path: str, language: str
+        self,
+        line: str,
+        line_num: int,
+        file_path: str,
+        language: str,
     ) -> WizardIssue | None:
         """Check a single line for hardcoded user-facing strings."""
         # Skip comments and imports
@@ -83,7 +84,10 @@ class LocalizationWizard(BaseCoachWizard):
         return None
 
     def _check_python_hardcoded(
-        self, line: str, line_num: int, file_path: str
+        self,
+        line: str,
+        line_num: int,
+        file_path: str,
     ) -> WizardIssue | None:
         """Check Python code for hardcoded UI strings."""
         # Look for print() or raise with string literals
@@ -132,10 +136,13 @@ class LocalizationWizard(BaseCoachWizard):
         return None
 
     def predict_future_issues(
-        self, code: str, file_path: str, project_context: dict[str, Any], timeline_days: int = 90
+        self,
+        code: str,
+        file_path: str,
+        project_context: dict[str, Any],
+        timeline_days: int = 90,
     ) -> list[WizardPrediction]:
-        """
-        Level 4 Anticipatory: Predict localization issues {timeline_days} days ahead
+        """Level 4 Anticipatory: Predict localization issues {timeline_days} days ahead
 
         Uses:
         - Historical patterns
@@ -151,16 +158,16 @@ class LocalizationWizard(BaseCoachWizard):
 
         self.logger.info(
             f"{self.name} predicted {len(predictions)} future issues "
-            f"for {file_path} ({timeline_days} days ahead)"
+            f"for {file_path} ({timeline_days} days ahead)",
         )
         return predictions
 
     def suggest_fixes(self, issue: WizardIssue) -> str:
-        """
-        Suggest how to fix a localization issue
+        """Suggest how to fix a localization issue
 
         Returns:
             Detailed fix suggestion with code examples
+
         """
         # Implementation depends on issue type
         return f"Fix suggestion for {issue.category} issue: {issue.message}"

coach_wizards/migration_wizard.py

@@ -1,5 +1,4 @@
-"""
-MigrationWizard - Code migration and upgrade assistance
+"""MigrationWizard - Code migration and upgrade assistance
 
 Level 4 Anticipatory Empathy for Migration using the Empathy Framework.
 
@@ -13,8 +12,7 @@ from .base_wizard import BaseCoachWizard, WizardIssue, WizardPrediction
 
 
 class MigrationWizard(BaseCoachWizard):
-    """
-    Code migration and upgrade assistance
+    """Code migration and upgrade assistance
 
     Detects:
     - deprecated APIs
@@ -36,8 +34,7 @@ class MigrationWizard(BaseCoachWizard):
         )
 
     def analyze_code(self, code: str, file_path: str, language: str) -> list[WizardIssue]:
-        """
-        Analyze code for migration issues
+        """Analyze code for migration issues
 
         This is a reference implementation. In production, integrate with:
         - Static analysis tools
@@ -57,10 +54,13 @@ class MigrationWizard(BaseCoachWizard):
         return issues
 
     def predict_future_issues(
-        self, code: str, file_path: str, project_context: dict[str, Any], timeline_days: int = 90
+        self,
+        code: str,
+        file_path: str,
+        project_context: dict[str, Any],
+        timeline_days: int = 90,
     ) -> list[WizardPrediction]:
-        """
-        Level 4 Anticipatory: Predict migration issues {timeline_days} days ahead
+        """Level 4 Anticipatory: Predict migration issues {timeline_days} days ahead
 
         Uses:
         - Historical patterns
@@ -76,16 +76,16 @@ class MigrationWizard(BaseCoachWizard):
 
         self.logger.info(
             f"{self.name} predicted {len(predictions)} future issues "
-            f"for {file_path} ({timeline_days} days ahead)"
+            f"for {file_path} ({timeline_days} days ahead)",
         )
         return predictions
 
     def suggest_fixes(self, issue: WizardIssue) -> str:
-        """
-        Suggest how to fix a migration issue
+        """Suggest how to fix a migration issue
 
         Returns:
             Detailed fix suggestion with code examples
+
         """
         # Implementation depends on issue type
         return f"Fix suggestion for {issue.category} issue: {issue.message}"

coach_wizards/monitoring_wizard.py

@@ -1,5 +1,4 @@
-"""
-MonitoringWizard - System monitoring and alerting
+"""MonitoringWizard - System monitoring and alerting
 
 Level 4 Anticipatory Empathy for Monitoring using the Empathy Framework.
 
@@ -13,8 +12,7 @@ from .base_wizard import BaseCoachWizard, WizardIssue, WizardPrediction
 
 
 class MonitoringWizard(BaseCoachWizard):
-    """
-    System monitoring and alerting
+    """System monitoring and alerting
 
     Detects:
     - missing alerts
@@ -36,8 +34,7 @@ class MonitoringWizard(BaseCoachWizard):
         )
 
     def analyze_code(self, code: str, file_path: str, language: str) -> list[WizardIssue]:
-        """
-        Analyze code for monitoring issues
+        """Analyze code for monitoring issues
 
         This is a reference implementation. In production, integrate with:
         - Static analysis tools
@@ -57,10 +54,13 @@ class MonitoringWizard(BaseCoachWizard):
         return issues
 
     def predict_future_issues(
-        self, code: str, file_path: str, project_context: dict[str, Any], timeline_days: int = 90
+        self,
+        code: str,
+        file_path: str,
+        project_context: dict[str, Any],
+        timeline_days: int = 90,
     ) -> list[WizardPrediction]:
-        """
-        Level 4 Anticipatory: Predict monitoring issues {timeline_days} days ahead
+        """Level 4 Anticipatory: Predict monitoring issues {timeline_days} days ahead
 
         Uses:
         - Historical patterns
@@ -76,16 +76,16 @@ class MonitoringWizard(BaseCoachWizard):
 
         self.logger.info(
             f"{self.name} predicted {len(predictions)} future issues "
-            f"for {file_path} ({timeline_days} days ahead)"
+            f"for {file_path} ({timeline_days} days ahead)",
         )
         return predictions
 
     def suggest_fixes(self, issue: WizardIssue) -> str:
-        """
-        Suggest how to fix a monitoring issue
+        """Suggest how to fix a monitoring issue
 
         Returns:
             Detailed fix suggestion with code examples
+
         """
         # Implementation depends on issue type
         return f"Fix suggestion for {issue.category} issue: {issue.message}"