htmlgraph 0.26.25__py3-none-any.whl → 0.27.1__py3-none-any.whl

htmlgraph/analytics/cross_session.py

@@ -1,3 +1,9 @@
+from __future__ import annotations
+
+import logging
+
+logger = logging.getLogger(__name__)
+
 """
 Cross-session analytics using Git commits as the continuity spine.
 
@@ -38,8 +44,6 @@ Example:
     authors = cross.work_by_author(since_commit="abc123")
 """
 
-from __future__ import annotations
-
 import subprocess
 from collections import defaultdict
 from dataclasses import dataclass
@@ -147,8 +151,8 @@ class CrossSessionAnalytics:
             ...     from_commit="HEAD~10",
             ...     to_commit="HEAD"
             ... )
-            >>> print(f"Total events: {report.total_events}")
-            >>> print(f"Features: {', '.join(report.features)}")
+            >>> logger.info(f"Total events: {report.total_events}")
+            >>> logger.info(f"Features: {', '.join(report.features)}")
         """
         # Get commit list from Git
         commits = self._get_commits_in_range(from_commit, to_commit)
@@ -273,7 +277,7 @@ class CrossSessionAnalytics:
 
         Example:
             >>> sessions = cross.sessions_for_feature("feature-auth")
-            >>> print(f"Feature worked on in {len(sessions)} sessions")
+            >>> logger.info(f"Feature worked on in {len(sessions)} sessions")
         """
         sessions = set()
 
@@ -320,8 +324,8 @@ class CrossSessionAnalytics:
 
         Example:
             >>> report = cross.feature_cross_session_report("feature-auth")
-            >>> print(f"Implemented across {len(report.sessions)} sessions")
-            >>> print(f"Duration: {report.duration_hours:.1f} hours")
+            >>> logger.info(f"Implemented across {len(report.sessions)} sessions")
+            >>> logger.info(f"Duration: {report.duration_hours:.1f} hours")
         """
         sessions = set()
         commits = set()
@@ -395,7 +399,7 @@ class CrossSessionAnalytics:
         Example:
             >>> authors = cross.work_by_author(since_commit="v1.0.0")
             >>> for email, stats in authors.items():
-            ...     print(f"{email}: {stats['event_count']} events")
+            ...     logger.info(f"{email}: {stats['event_count']} events")
         """
         authors: dict[str, dict[str, Any]] = defaultdict(
             lambda: {
@@ -476,7 +480,7 @@ class CrossSessionAnalytics:
 
         Example:
             >>> commits = cross.commits_for_session("session-abc")
-            >>> print(f"Session produced {len(commits)} commits")
+            >>> logger.info(f"Session produced {len(commits)} commits")
         """
         commits = set()
 

htmlgraph/analytics/dependency.py

@@ -1,3 +1,9 @@
+from __future__ import annotations
+
+import logging
+
+logger = logging.getLogger(__name__)
+
 """
 Dependency-aware analytics for HtmlGraph.
 
@@ -9,8 +15,6 @@ Provides advanced graph analysis for project management:
 - Work prioritization
 """
 
-from __future__ import annotations
-
 from collections import deque
 from typing import TYPE_CHECKING
 
@@ -55,12 +59,12 @@ class DependencyAnalytics:
         # Find bottlenecks (cached internally for performance)
         bottlenecks = dep.find_bottlenecks(top_n=5)
         for bn in bottlenecks:
-            print(f"{bn.title} blocks {bn.transitive_blocking} features")
+            logger.info(f"{bn.title} blocks {bn.transitive_blocking} features")
 
         # Get work recommendations (reuses cached data)
         recs = dep.recommend_next_tasks(agent_count=3)
         for rec in recs.recommendations:
-            print(f"Work on: {rec.title} (unlocks {len(rec.unlocks)} features)")
+            logger.info(f"Work on: {rec.title} (unlocks {len(rec.unlocks)} features)")
 
         # After making graph changes, invalidate cache
         sdk.features.update(feature_id, status="done")
@@ -201,7 +205,7 @@ class DependencyAnalytics:
 
         Example:
             report = dep.find_parallelizable_work(status="todo")
-            print(f"Can work on {report.max_parallelism} features in parallel")
+            logger.info(f"Can work on {report.max_parallelism} features in parallel")
         """
         # Get dependency levels (topological layers)
         levels = self.dependency_levels(status_filter=[status])
@@ -456,7 +460,7 @@ class DependencyAnalytics:
         Example:
             recs = dep.recommend_next_tasks(agent_count=3)
             for rec in recs.recommendations:
-                print(f"Work on: {rec.title}")
+                logger.info(f"Work on: {rec.title}")
         """
         # Get all nodes with target status
         candidates = [n for n in self.graph.nodes.values() if n.status == status]

htmlgraph/analytics/strategic/__init__.py

@@ -0,0 +1,80 @@
+"""
+Strategic Analytics - Phase 3: Pattern Detection & Smart Suggestions
+
+This module provides intelligent pattern detection and suggestion systems
+that learn from user delegation patterns and make smart suggestions.
+
+Key Components:
+1. PatternDetector - Detects tool sequences, delegation chains, error patterns
+2. SuggestionEngine - Generates context-aware suggestions with ranking
+3. PreferenceManager - Learns user preferences from feedback
+4. CostOptimizer - Suggests token budgets, parallelization, model selection
+
+Usage:
+    from htmlgraph.analytics.strategic import (
+        PatternDetector,
+        SuggestionEngine,
+        PreferenceManager,
+        CostOptimizer,
+    )
+
+    # Detect patterns from event history
+    detector = PatternDetector(db_path)
+    patterns = detector.detect_all_patterns()
+
+    # Get suggestions for current context
+    engine = SuggestionEngine(db_path)
+    suggestions = engine.suggest(context)
+
+    # Learn from feedback
+    manager = PreferenceManager(db_path)
+    manager.record_feedback(suggestion_id, accepted=True)
+"""
+
+from htmlgraph.analytics.strategic.cost_optimizer import (
+    CostOptimizer,
+    ModelRecommendation,
+    ParallelizationStrategy,
+    TokenBudget,
+)
+from htmlgraph.analytics.strategic.pattern_detector import (
+    DelegationChain,
+    ErrorPattern,
+    Pattern,
+    PatternDetector,
+    PatternType,
+    ToolSequencePattern,
+)
+from htmlgraph.analytics.strategic.preference_manager import (
+    Feedback,
+    PreferenceManager,
+    UserPreferences,
+)
+from htmlgraph.analytics.strategic.suggestion_engine import (
+    Suggestion,
+    SuggestionEngine,
+    SuggestionType,
+)
+
+__all__ = [
+    # Pattern Detection
+    "PatternDetector",
+    "Pattern",
+    "PatternType",
+    "ToolSequencePattern",
+    "DelegationChain",
+    "ErrorPattern",
+    # Suggestion Engine
+    "SuggestionEngine",
+    "Suggestion",
+    "SuggestionType",
+    # Preference Manager
+    "PreferenceManager",
+    "UserPreferences",
+    "Feedback",
+    # Cost Optimizer
+    "CostOptimizer",
+    "TokenBudget",
+    "ParallelizationStrategy",
+    "ModelRecommendation",
+]