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

empathy_llm_toolkit/session_status.py

@@ -1,5 +1,4 @@
-"""
-Session Status Assistant
+"""Session Status Assistant
 
 Proactive briefing system that greets developers when they return to an
 Empathy-enhanced project, providing a prioritized status report with
@@ -93,8 +92,7 @@ class SessionStatus:
 
 
 class SessionStatusCollector:
-    """
-    Aggregates project status from all data sources.
+    """Aggregates project status from all data sources.
 
     Scans patterns directories, roadmap docs, and git history
     to build a prioritized status report for developers.
@@ -119,8 +117,7 @@ class SessionStatusCollector:
         self._state: dict[str, Any] | None = None
 
     def should_show(self) -> bool:
-        """
-        Check if status should be shown based on inactivity.
+        """Check if status should be shown based on inactivity.
 
         Returns True if:
         - First interaction after inactivity_minutes of no activity
@@ -164,11 +161,11 @@ class SessionStatusCollector:
         logger.debug("Recorded interaction at %s", state["last_interaction"])
 
     def collect(self) -> SessionStatus:
-        """
-        Collect and prioritize status items from all data sources.
+        """Collect and prioritize status items from all data sources.
 
         Returns:
             SessionStatus with prioritized items and wins
+
         """
         status = SessionStatus()
 
@@ -224,7 +221,7 @@ class SessionStatusCollector:
                     action_prompt=f"Review security finding: {finding}. "
                     f"Provide analysis and recommend: ACCEPTED, DEFERRED, or FALSE_POSITIVE.",
                     details={"pending_count": pending_count, "items": pending_items[:3]},
-                )
+                ),
             )
 
     def _collect_bug_items(self, status: SessionStatus) -> None:
@@ -267,7 +264,7 @@ class SessionStatusCollector:
                     f"{first_bug.get('error_message', 'No description')}. "
                     f"File: {first_bug.get('file_path', 'unknown')}",
                     details={"count": len(high_severity), "bugs": high_severity[:3]},
-                )
+                ),
             )
 
         # Add investigating bugs (P2)
@@ -285,7 +282,7 @@ class SessionStatusCollector:
                     f"Use: empathy patterns resolve {first_bug.get('bug_id', '')} "
                     f"--root-cause '<cause>' --fix '<fix>'",
                     details={"count": len(investigating), "bugs": investigating[:5]},
-                )
+                ),
             )
 
     def _collect_tech_debt_items(self, status: SessionStatus) -> None:
@@ -336,7 +333,7 @@ class SessionStatusCollector:
                         "change": change,
                         "hotspots": current.get("hotspots", [])[:3],
                     },
-                )
+                ),
             )
         elif change < 0:
             # Tech debt decreasing - this is a win
@@ -364,7 +361,7 @@ class SessionStatusCollector:
                         {
                             "task": task.strip(),
                             "file": plan_file.name,
-                        }
+                        },
                     )
             except OSError as e:
                 logger.warning("Failed to read plan file %s: %s", plan_file, e)
@@ -381,7 +378,7 @@ class SessionStatusCollector:
                     action_prompt=f"Continue roadmap item from {first_task['file']}: "
                     f"{first_task['task']}",
                     details={"count": len(unchecked_tasks), "tasks": unchecked_tasks[:5]},
-                )
+                ),
             )
 
     def _collect_git_items(self, status: SessionStatus) -> None:
@@ -389,6 +386,7 @@ class SessionStatusCollector:
         try:
             result = subprocess.run(
                 ["git", "log", "-10", "--format=%h|%s", "--since=7.days"],
+                check=False,
                 capture_output=True,
                 text=True,
                 timeout=5,
@@ -413,7 +411,7 @@ class SessionStatusCollector:
                         {
                             "hash": commit_hash,
                             "message": message,
-                        }
+                        },
                     )
 
             if wip_commits:
@@ -429,7 +427,7 @@ class SessionStatusCollector:
                         f"{first_commit['message']}. "
                         "This commit may need follow-up work.",
                         details={"count": len(wip_commits), "commits": wip_commits[:5]},
-                    )
+                    ),
                 )
 
         except Exception as e:
@@ -540,8 +538,7 @@ class SessionStatusCollector:
         status: SessionStatus,
         max_items: int | None = None,
     ) -> str:
-        """
-        Format status for terminal output.
+        """Format status for terminal output.
 
         Args:
             status: The SessionStatus to format
@@ -549,6 +546,7 @@ class SessionStatusCollector:
 
         Returns:
             Formatted markdown string
+
         """
         max_items = max_items or self.config["max_display_items"]
         sorted_items = status.get_sorted_items()
@@ -616,8 +614,7 @@ class SessionStatusCollector:
         return json.dumps(data, indent=2, default=str)
 
     def get_action_prompt(self, status: SessionStatus, selection: int) -> str | None:
-        """
-        Get the action prompt for a selected item.
+        """Get the action prompt for a selected item.
 
         Args:
             status: The SessionStatus
@@ -625,6 +622,7 @@ class SessionStatusCollector:
 
         Returns:
             Action prompt string, or None if invalid selection
+
         """
         sorted_items = status.get_sorted_items()
 

empathy_llm_toolkit/state.py

@@ -1,5 +1,4 @@
-"""
-Collaboration State Management
+"""Collaboration State Management
 
 Tracks AI-human collaboration over time to enable Level 3+ empathy.
 
@@ -24,8 +23,7 @@ class PatternType(Enum):
 
 @dataclass
 class UserPattern:
-    """
-    A detected pattern in user behavior.
+    """A detected pattern in user behavior.
 
     Enables Level 3 (Proactive) empathy.
     """
@@ -39,8 +37,7 @@ class UserPattern:
     context: dict[str, Any] = field(default_factory=dict)
 
     def should_act(self, trust_level: float) -> bool:
-        """
-        Determine if we should act proactively on this pattern.
+        """Determine if we should act proactively on this pattern.
 
         Requires both high confidence and sufficient trust.
         """
@@ -60,8 +57,7 @@ class Interaction:
 
 @dataclass
 class CollaborationState:
-    """
-    Tracks AI-human collaboration state over time.
+    """Tracks AI-human collaboration state over time.
 
     This is the foundation for Level 2+ empathy:
     - Level 2: Uses conversation history for context
@@ -104,7 +100,11 @@ class CollaborationState:
         return self.successful_actions / total
 
     def add_interaction(
-        self, role: str, content: str, empathy_level: int, metadata: dict | None = None
+        self,
+        role: str,
+        content: str,
+        empathy_level: int,
+        metadata: dict | None = None,
     ):
         """Add interaction to history"""
         self.interactions.append(
@@ -114,7 +114,7 @@ class CollaborationState:
                 content=content,
                 empathy_level=empathy_level,
                 metadata=metadata or {},
-            )
+            ),
         )
 
         # Track level history
@@ -122,12 +122,12 @@ class CollaborationState:
             self.level_history.append(empathy_level)
 
     def update_trust(self, outcome: str, magnitude: float = 1.0):
-        """
-        Update trust level based on action outcome.
+        """Update trust level based on action outcome.
 
         Args:
             outcome: "success" or "failure"
             magnitude: How much to adjust (0.0 to 1.0)
+
         """
         if outcome == "success":
             adjustment = 0.05 * magnitude
@@ -159,8 +159,7 @@ class CollaborationState:
         self.detected_patterns.append(pattern)
 
     def find_matching_pattern(self, trigger_text: str) -> UserPattern | None:
-        """
-        Find pattern that matches current input.
+        """Find pattern that matches current input.
 
         Returns pattern with highest confidence if found.
         """
@@ -177,10 +176,11 @@ class CollaborationState:
         return None
 
     def get_conversation_history(
-        self, max_turns: int = 10, include_metadata: bool = False
+        self,
+        max_turns: int = 10,
+        include_metadata: bool = False,
     ) -> list[dict[str, Any]]:
-        """
-        Get recent conversation history in LLM format.
+        """Get recent conversation history in LLM format.
 
         Args:
             max_turns: Maximum number of turns to include
@@ -188,17 +188,16 @@ class CollaborationState:
 
         Returns:
             List of {"role": "user/assistant", "content": "..."}
+
         """
         recent = self.interactions[-max_turns:] if max_turns else self.interactions
 
         if include_metadata:
             return [{"role": i.role, "content": i.content, "metadata": i.metadata} for i in recent]
-        else:
-            return [{"role": i.role, "content": i.content} for i in recent]
+        return [{"role": i.role, "content": i.content} for i in recent]
 
     def should_progress_to_level(self, level: int) -> bool:
-        """
-        Determine if system should progress to higher empathy level.
+        """Determine if system should progress to higher empathy level.
 
         Progression criteria:
         - Level 2: Immediate (guided questions always helpful)

empathy_os/__init__.py

@@ -1,5 +1,4 @@
-"""
-Empathy Framework - AI-Human Collaboration Library
+"""Empathy Framework - AI-Human Collaboration Library
 
 A five-level maturity model for building AI systems that progress from
 reactive responses to anticipatory problem prevention.
@@ -132,94 +131,94 @@ from .persistence import MetricsCollector, PatternPersistence, StateManager
 from .trust_building import TrustBuildingBehaviors
 
 __all__ = [
+    "AccessTier",
+    "AgentCoordinator",
+    "AgentCredentials",
+    "AgentMetrics",
+    # Monitoring (Multi-Agent)
+    "AgentMonitor",
+    "AgentTask",
+    "AuditEvent",
+    # Security - Audit
+    "AuditLogger",
+    "Classification",
+    "ClassificationRules",
+    # Claude Memory
+    "ClaudeMemoryConfig",
+    "ClaudeMemoryLoader",
+    "CollaborationStateError",
+    "ConfidenceThresholdError",
+    "ConflictContext",
+    # Coordination (Multi-Agent)
+    "ConflictResolver",
+    "EmergenceDetector",
+    # Configuration
+    "EmpathyConfig",
+    # Exceptions
+    "EmpathyFrameworkError",
+    "EmpathyLevelError",
     "EmpathyOS",
-    # Unified Memory Interface
-    "UnifiedMemory",
-    "MemoryConfig",
+    "EncryptionManager",
     "Environment",
+    "FeedbackLoopDetector",
+    "FeedbackLoopError",
     "Level1Reactive",
     "Level2Guided",
     "Level3Proactive",
     "Level4Anticipatory",
     "Level5Systems",
-    "FeedbackLoopDetector",
     "LeveragePointAnalyzer",
-    "EmergenceDetector",
+    "LeveragePointError",
+    "LoggingConfig",
+    "MemDocsStorage",
+    "MemoryConfig",
+    "MemoryPermissionError",
+    "MetricsCollector",
+    "PIIDetection",
+    "PIIPattern",
+    # Security - PII
+    "PIIScrubber",
+    "Pattern",
     # Pattern Library
     "PatternLibrary",
-    "Pattern",
     "PatternMatch",
-    # Coordination (Multi-Agent)
-    "ConflictResolver",
-    "ResolutionResult",
-    "ResolutionStrategy",
-    "TeamPriorities",
-    "AgentCoordinator",
-    "AgentTask",
-    "TeamSession",
-    # Monitoring (Multi-Agent)
-    "AgentMonitor",
-    "AgentMetrics",
-    "TeamMetrics",
-    # Redis Short-Term Memory
-    "RedisShortTermMemory",
-    "AccessTier",
-    "AgentCredentials",
-    "StagedPattern",
-    "ConflictContext",
-    "TTLStrategy",
-    # Redis Configuration
-    "get_redis_memory",
-    "get_redis_config",
-    "get_railway_redis",
-    "check_redis_connection",
-    # Trust
-    "TrustBuildingBehaviors",
+    "PatternMetadata",
+    "PatternNotFoundError",
     # Persistence
     "PatternPersistence",
-    "StateManager",
-    "MetricsCollector",
-    # Configuration
-    "EmpathyConfig",
-    "load_config",
-    # Logging
-    "get_logger",
-    "LoggingConfig",
-    # Exceptions
-    "EmpathyFrameworkError",
-    "ValidationError",
-    "PatternNotFoundError",
-    "TrustThresholdError",
-    "ConfidenceThresholdError",
-    "EmpathyLevelError",
-    "LeveragePointError",
-    "FeedbackLoopError",
-    "CollaborationStateError",
+    # Redis Short-Term Memory
+    "RedisShortTermMemory",
+    "ResolutionResult",
+    "ResolutionStrategy",
+    "SecretDetection",
+    "SecretType",
+    # Security - Secrets
+    "SecretsDetector",
     # Long-term Memory
     "SecureMemDocsIntegration",
-    "Classification",
-    "ClassificationRules",
-    "PatternMetadata",
     "SecurePattern",
-    "MemDocsStorage",
-    "EncryptionManager",
     "SecurityError",
-    "MemoryPermissionError",
-    # Claude Memory
-    "ClaudeMemoryConfig",
-    "ClaudeMemoryLoader",
-    # Security - PII
-    "PIIScrubber",
-    "PIIDetection",
-    "PIIPattern",
-    # Security - Secrets
-    "SecretsDetector",
-    "SecretDetection",
-    "SecretType",
+    "SecurityViolation",
     "Severity",
+    "StagedPattern",
+    "StateManager",
+    "TTLStrategy",
+    "TeamMetrics",
+    "TeamPriorities",
+    "TeamSession",
+    # Trust
+    "TrustBuildingBehaviors",
+    "TrustThresholdError",
+    # Unified Memory Interface
+    "UnifiedMemory",
+    "ValidationError",
+    "check_redis_connection",
     "detect_secrets",
-    # Security - Audit
-    "AuditLogger",
-    "AuditEvent",
-    "SecurityViolation",
+    # Logging
+    "get_logger",
+    "get_railway_redis",
+    "get_redis_config",
+    # Redis Configuration
+    "get_redis_memory",
+    "load_config",
 ]