htmlgraph 0.23.5__py3-none-any.whl → 0.24.1__py3-none-any.whl

htmlgraph/reflection.py

@@ -0,0 +1,442 @@
+"""
+Computational Reflection Module.
+
+Pre-computes actionable context from session history for injection into
+orchestrator prompts. Addresses the LLM limitation where models can only
+effectively track 5-10 variables in working memory.
+
+Design Principles:
+1. COMPUTE, don't prompt - Do the synthesis work here, not in prompts
+2. LIMIT to 5 items - Respect LLM working memory constraints
+3. PRIORITIZE by recency and relevance - Most actionable items first
+4. CONNECT the dots - Surface relationships the model would miss
+
+Usage:
+    from htmlgraph.reflection import ComputationalReflection
+
+    reflection = ComputationalReflection(sdk)
+    context = reflection.get_actionable_context()
+    # Returns: {
+    #     "summary": "3 blockers, 1 recent failure, avoid Read-Read-Read pattern",
+    #     "items": [...],  # Max 5 items
+    #     "injected_at": "2025-01-04T12:00:00"
+    # }
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from datetime import datetime, timedelta
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from htmlgraph.sdk import SDK
+
+
+@dataclass
+class ReflectionItem:
+    """A single actionable reflection item."""
+
+    category: str  # "blocker", "failure", "anti_pattern", "spike", "recommendation"
+    priority: int  # 1-5, higher = more important
+    title: str  # Brief title
+    detail: str  # One-line actionable detail
+    source_id: str | None = None  # ID of source item (feature, spike, etc.)
+
+    def to_dict(self) -> dict[str, Any]:
+        """Convert to dictionary for JSON serialization."""
+        return {
+            "category": self.category,
+            "priority": self.priority,
+            "title": self.title,
+            "detail": self.detail,
+            "source_id": self.source_id,
+        }
+
+
+class ComputationalReflection:
+    """
+    Computes actionable context from HtmlGraph history.
+
+    This class addresses the core problem: LLMs can retrieve data but
+    struggle to synthesize insights from complex graph structures.
+    We do the synthesis here and inject computed results.
+
+    Example:
+        >>> sdk = SDK(agent="claude")
+        >>> reflection = ComputationalReflection(sdk)
+        >>> context = reflection.get_actionable_context()
+        >>> print(context["summary"])
+        "2 blockers | Avoid: Edit-Edit-Edit | Related: spk-abc123"
+    """
+
+    MAX_ITEMS = 5  # LLM working memory limit
+    LOOKBACK_HOURS = 48  # How far back to look for patterns
+
+    def __init__(self, sdk: SDK):
+        self.sdk = sdk
+        self._cache: dict[str, Any] = {}
+        self._cache_time: datetime | None = None
+        self._cache_ttl = timedelta(minutes=5)
+
+    def get_actionable_context(
+        self,
+        current_feature_id: str | None = None,
+        current_track: str | None = None,
+    ) -> dict[str, Any]:
+        """
+        Get pre-computed actionable context for injection.
+
+        This is the main entry point. Returns a structured dict
+        suitable for injection into SessionStart or PreToolUse hooks.
+
+        Args:
+            current_feature_id: ID of feature being worked on (if any)
+            current_track: Track name for filtering relevant history
+
+        Returns:
+            Dict with summary string and list of max 5 items
+        """
+        # Check cache
+        if self._cache_time and datetime.now() - self._cache_time < self._cache_ttl:
+            return self._cache
+
+        items: list[ReflectionItem] = []
+
+        # 1. Get blocking items (highest priority)
+        items.extend(self._get_blockers(current_feature_id))
+
+        # 2. Get recent failures
+        items.extend(self._get_recent_failures(current_track))
+
+        # 3. Get anti-patterns to avoid
+        items.extend(self._get_anti_patterns())
+
+        # 4. Get related spikes (investigations)
+        items.extend(self._get_related_spikes(current_feature_id, current_track))
+
+        # 5. Get strategic recommendations
+        items.extend(self._get_recommendations())
+
+        # Sort by priority (highest first) and limit to MAX_ITEMS
+        items.sort(key=lambda x: x.priority, reverse=True)
+        items = items[: self.MAX_ITEMS]
+
+        # Build summary string
+        summary = self._build_summary(items)
+
+        result = {
+            "summary": summary,
+            "items": [item.to_dict() for item in items],
+            "injected_at": datetime.now().isoformat(),
+            "item_count": len(items),
+        }
+
+        # Cache result
+        self._cache = result
+        self._cache_time = datetime.now()
+
+        return result
+
+    def _get_blockers(self, feature_id: str | None) -> list[ReflectionItem]:
+        """Get items blocking current work."""
+        items = []
+
+        try:
+            # Use SDK's find_bottlenecks
+            bottlenecks = self.sdk.find_bottlenecks(top_n=3)
+
+            for bn in bottlenecks[:2]:  # Max 2 blockers
+                items.append(
+                    ReflectionItem(
+                        category="blocker",
+                        priority=5,  # Highest priority
+                        title=f"Blocker: {bn.get('title', 'Unknown')[:40]}",
+                        detail=f"Blocks {bn.get('blocks_count', 0)} items. Resolve first.",
+                        source_id=bn.get("id"),
+                    )
+                )
+        except Exception:
+            pass
+
+        # Also check for features marked as blocking
+        try:
+            blocked = self.sdk.features.where(status="blocked")
+            for feat in blocked[:1]:  # Max 1 blocked feature
+                items.append(
+                    ReflectionItem(
+                        category="blocker",
+                        priority=4,
+                        title=f"Blocked: {feat.title[:40]}",
+                        detail="Feature is blocked. Check dependencies.",
+                        source_id=feat.id,
+                    )
+                )
+        except Exception:
+            pass
+
+        return items
+
+    def _get_recent_failures(self, track: str | None) -> list[ReflectionItem]:
+        """Get recent failures from session history."""
+        items = []
+
+        try:
+            # Get recent sessions
+            sessions = self.sdk.sessions.all()
+            cutoff = datetime.now() - timedelta(hours=self.LOOKBACK_HOURS)
+
+            recent_sessions = [
+                s
+                for s in sessions
+                if hasattr(s, "started_at") and s.started_at and s.started_at > cutoff
+            ]
+
+            # Look for error patterns in session activity
+            for session in recent_sessions[-3:]:  # Last 3 sessions
+                if hasattr(session, "activity_log") and session.activity_log:
+                    for activity in session.activity_log:
+                        success = (
+                            activity.success
+                            if not isinstance(activity, dict)
+                            else activity.get("success", True)
+                        )
+                        if not success:
+                            tool = (
+                                activity.tool
+                                if not isinstance(activity, dict)
+                                else activity.get("tool", "")
+                            )
+                            summary = (
+                                activity.summary
+                                if not isinstance(activity, dict)
+                                else activity.get("summary", "")
+                            )
+
+                            items.append(
+                                ReflectionItem(
+                                    category="failure",
+                                    priority=4,
+                                    title=f"Recent failure: {tool}",
+                                    detail=summary[:60]
+                                    if summary
+                                    else "Check session log",
+                                    source_id=session.id,
+                                )
+                            )
+                            break  # One failure per session max
+        except Exception:
+            pass
+
+        return items[:2]  # Max 2 failures
+
+    def _get_anti_patterns(self) -> list[ReflectionItem]:
+        """Get anti-patterns to avoid from recent sessions."""
+        items = []
+
+        try:
+            # Import learning module for pattern analysis
+            from htmlgraph.learning import LearningPersistence
+
+            learning = LearningPersistence(self.sdk)
+
+            # Get active session for analysis
+            active_sessions = [
+                s for s in self.sdk.sessions.all() if s.status == "active"
+            ]
+
+            if active_sessions:
+                # Analyze most recent active session
+                session = active_sessions[-1]
+                analysis = learning.analyze_for_orchestrator(session.id)
+
+                # Extract anti-patterns
+                for pattern in analysis.get("anti_patterns", [])[:1]:
+                    seq = pattern.get("sequence", [])
+                    desc = pattern.get("description", "")
+                    items.append(
+                        ReflectionItem(
+                            category="anti_pattern",
+                            priority=3,
+                            title=f"Avoid: {' → '.join(seq)}",
+                            detail=desc[:60]
+                            if desc
+                            else "Detected inefficient pattern",
+                            source_id=session.id,
+                        )
+                    )
+        except Exception:
+            pass
+
+        return items[:1]  # Max 1 anti-pattern
+
+    def _get_related_spikes(
+        self, feature_id: str | None, track: str | None
+    ) -> list[ReflectionItem]:
+        """Get related investigation spikes."""
+        items = []
+
+        try:
+            spikes = self.sdk.spikes.all()
+
+            # Find spikes with findings that might be relevant
+            relevant_spikes = []
+
+            for spike in spikes:
+                # Check if spike has findings
+                if not hasattr(spike, "findings") or not spike.findings:
+                    continue
+
+                # Check if spike is related to current feature
+                if feature_id and hasattr(spike, "edges") and spike.edges:
+                    for edge_type, edges in spike.edges.items():
+                        for edge in edges:
+                            if edge.target_id == feature_id:
+                                relevant_spikes.append((spike, 5))  # High relevance
+                                break
+
+                # Check if spike mentions the track
+                if track and track.lower() in (spike.title or "").lower():
+                    relevant_spikes.append((spike, 3))  # Medium relevance
+
+                # Check for recent completed spikes with findings
+                if spike.status == "done" and spike.findings:
+                    if hasattr(spike, "updated") and spike.updated:
+                        cutoff = datetime.now() - timedelta(hours=24)
+                        if spike.updated > cutoff:
+                            relevant_spikes.append((spike, 2))  # Lower relevance
+
+            # Sort by relevance and take top
+            relevant_spikes.sort(key=lambda x: x[1], reverse=True)
+
+            for spike, relevance in relevant_spikes[:1]:
+                findings_preview = spike.findings[:60] if spike.findings else ""
+                items.append(
+                    ReflectionItem(
+                        category="spike",
+                        priority=2,
+                        title=f"Related: {spike.title[:35]}",
+                        detail=findings_preview or "See spike for details",
+                        source_id=spike.id,
+                    )
+                )
+        except Exception:
+            pass
+
+        return items[:1]  # Max 1 spike
+
+    def _get_recommendations(self) -> list[ReflectionItem]:
+        """Get strategic recommendations."""
+        items = []
+
+        try:
+            recs = self.sdk.recommend_next_work(agent_count=1)
+
+            if recs and len(recs) > 0:
+                rec = recs[0]
+                reasons = rec.get("reasons", [])
+                reason_str = reasons[0] if reasons else "Recommended next"
+
+                items.append(
+                    ReflectionItem(
+                        category="recommendation",
+                        priority=2,
+                        title=f"Next: {rec.get('title', 'Unknown')[:35]}",
+                        detail=reason_str[:60],
+                        source_id=rec.get("id"),
+                    )
+                )
+        except Exception:
+            pass
+
+        return items[:1]  # Max 1 recommendation
+
+    def _build_summary(self, items: list[ReflectionItem]) -> str:
+        """Build a one-line summary from items."""
+        if not items:
+            return "No actionable context found."
+
+        parts = []
+
+        # Count by category
+        blockers = [i for i in items if i.category == "blocker"]
+        failures = [i for i in items if i.category == "failure"]
+        anti_patterns = [i for i in items if i.category == "anti_pattern"]
+        spikes = [i for i in items if i.category == "spike"]
+
+        if blockers:
+            parts.append(f"{len(blockers)} blocker{'s' if len(blockers) > 1 else ''}")
+
+        if failures:
+            parts.append(
+                f"{len(failures)} recent failure{'s' if len(failures) > 1 else ''}"
+            )
+
+        if anti_patterns:
+            pattern = anti_patterns[0]
+            parts.append(f"Avoid: {pattern.title.replace('Avoid: ', '')}")
+
+        if spikes:
+            spike = spikes[0]
+            parts.append(f"See: {spike.source_id}")
+
+        return " | ".join(parts) if parts else "Session context loaded."
+
+    def format_for_injection(self, context: dict[str, Any] | None = None) -> str:
+        """
+        Format context for injection into hooks.
+
+        Returns a markdown-formatted string suitable for additionalContext.
+        """
+        if context is None:
+            context = self.get_actionable_context()
+
+        if not context.get("items"):
+            return ""
+
+        lines = ["## Computed Reflections", ""]
+        lines.append(f"**Summary:** {context.get('summary', 'N/A')}")
+        lines.append("")
+
+        for item in context.get("items", []):
+            icon = {
+                "blocker": "🚫",
+                "failure": "❌",
+                "anti_pattern": "⚠️",
+                "spike": "🔍",
+                "recommendation": "💡",
+            }.get(item.get("category", ""), "•")
+
+            lines.append(f"{icon} **{item.get('title', 'Unknown')}**")
+            lines.append(f"   {item.get('detail', '')}")
+            if item.get("source_id"):
+                lines.append(f"   _Source: {item.get('source_id')}_")
+            lines.append("")
+
+        lines.append("---")
+        lines.append("")
+
+        return "\n".join(lines)
+
+
+def get_reflection_context(
+    sdk: SDK,
+    feature_id: str | None = None,
+    track: str | None = None,
+) -> str:
+    """
+    Convenience function to get formatted reflection context.
+
+    This is the main entry point for hooks.
+
+    Args:
+        sdk: HtmlGraph SDK instance
+        feature_id: Current feature ID (optional)
+        track: Current track name (optional)
+
+    Returns:
+        Formatted string for injection into hook context
+    """
+    reflection = ComputationalReflection(sdk)
+    context = reflection.get_actionable_context(feature_id, track)
+    return reflection.format_for_injection(context)

htmlgraph/sdk.py

@@ -39,6 +39,7 @@ Example:
 
 from __future__ import annotations
 
+import os
 from pathlib import Path
 from typing import Any
 
@@ -201,13 +202,19 @@ class SDK:
         sdk.epics.assign(["epic-001"], agent="claude")
     """
 
-    def __init__(self, directory: Path | str | None = None, agent: str | None = None):
+    def __init__(
+        self,
+        directory: Path | str | None = None,
+        agent: str | None = None,
+        parent_session: str | None = None,
+    ):
         """
         Initialize SDK.
 
         Args:
             directory: Path to .htmlgraph directory (auto-discovered if not provided)
             agent: Agent identifier for operations
+            parent_session: Parent session ID to log activities to (for nested contexts)
         """
         if directory is None:
             directory = self._discover_htmlgraph()
@@ -217,6 +224,7 @@ class SDK:
 
         self._directory = Path(directory)
         self._agent_id = agent
+        self._parent_session = parent_session or os.getenv("HTMLGRAPH_PARENT_SESSION")
 
         # Initialize underlying HtmlGraphs first (for backward compatibility and sharing)
         # These are shared with SessionManager to avoid double-loading features
@@ -541,7 +549,7 @@ class SDK:
             file_paths: Files involved in this activity
             success: Whether the tool call succeeded
             feature_id: Explicit feature ID (skips attribution if provided)
-            session_id: Session ID (defaults to active session for current agent)
+            session_id: Session ID (defaults to parent session if available, then active session)
             parent_activity_id: ID of parent activity (e.g., Skill/Task invocation)
             payload: Optional rich payload data
 
@@ -558,14 +566,23 @@ class SDK:
             ... )
             >>> print(f"Tracked: [{entry.tool}] {entry.summary}")
         """
-        # Find active session if not specified
+        # Determine target session: explicit > parent > active
         if not session_id:
-            active = self.session_manager.get_active_session(agent=self._agent_id)
-            if not active:
-                raise ValueError(
-                    "No active session. Start one with sdk.start_session()"
-                )
-            session_id = active.id
+            # Use parent session if available (for nested contexts)
+            if self._parent_session:
+                session_id = self._parent_session
+            else:
+                # Fall back to active session
+                active = self.session_manager.get_active_session(agent=self._agent_id)
+                if not active:
+                    raise ValueError(
+                        "No active session. Start one with sdk.start_session()"
+                    )
+                session_id = active.id
+
+        # Get parent activity ID from environment if not provided
+        if not parent_activity_id:
+            parent_activity_id = os.getenv("HTMLGRAPH_PARENT_ACTIVITY")
 
         return self.session_manager.track_activity(
             session_id=session_id,

{htmlgraph-0.23.5.dist-info → htmlgraph-0.24.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: htmlgraph
-Version: 0.23.5
+Version: 0.24.1
 Summary: HTML is All You Need - Graph database on web standards
 Project-URL: Homepage, https://github.com/Shakes-tzd/htmlgraph
 Project-URL: Documentation, https://github.com/Shakes-tzd/htmlgraph#readme
@@ -32,6 +32,7 @@ Requires-Dist: black>=23.0.0; extra == 'dev'
 Requires-Dist: invoke>=2.2.0; extra == 'dev'
 Requires-Dist: mypy>=1.0.0; extra == 'dev'
 Requires-Dist: pdoc>=14.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
 Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
 Requires-Dist: pytest>=7.0.0; extra == 'dev'
 Requires-Dist: ruff>=0.1.0; extra == 'dev'

{htmlgraph-0.23.5.dist-info → htmlgraph-0.24.1.dist-info}/RECORD

@@ -1,10 +1,10 @@
-htmlgraph/__init__.py,sha256=mtIyVp_jFrQp7Vq9fQotsdbgzaXHZl8m31141-Surps,4979
+htmlgraph/__init__.py,sha256=2J36CrlL9ZJVYngE0zXFK2OGThAO0bY2tHtmntl5qL0,5185
 htmlgraph/agent_detection.py,sha256=PAYo7rU3N_y1cGRd7Dwjh5Wgu-QZ7ENblX_yOzU-gJ0,2749
 htmlgraph/agent_registry.py,sha256=Usa_35by7p5gtpvHO7K3AcGimnorw-FzgPVa3cWTQ58,9448
 htmlgraph/agents.py,sha256=Yvu6x1nOfrW2WhRTAHiCuSpvqoVJXx1Mkzd59kwEczw,33466
 htmlgraph/analytics_index.py,sha256=ba6Y4H_NNOCxI_Z4U7wSgBFFairf4IJT74WcM1PoZuI,30594
 htmlgraph/attribute_index.py,sha256=cBZUV4YfGnhh6lF59aYPCdNrRr1hK__BzSKCueSDUhQ,6593
-htmlgraph/cli.py,sha256=CZC631eM4toy2l7fP63EaORRATlUa5sDmJgU98bFjKU,201518
+htmlgraph/cli.py,sha256=-v3VBsf0IZwNQ-7ASkp_1jJHDrsFQKIkHzbtU-K66Ts,216118
 htmlgraph/context_analytics.py,sha256=CaLu0o2uSr6rlBM5YeaFZe7grgsy7_Hx10qdXuNcdao,11344
 htmlgraph/converter.py,sha256=fhJF2h4YbrmL1wIa1jk7kGkT_CYGHeWp_5UzXitQ6HE,22747
 htmlgraph/dashboard.html,sha256=rkZYjSnPbUuAm35QMpCNWemenYqQTdkkumCX2hhe8Dc,173537
@@ -23,8 +23,8 @@ htmlgraph/ids.py,sha256=ibEC8xW1ZHbAW6ImOKP2wLARgW7nzkxu8voce_hkljk,8389
 htmlgraph/index.d.ts,sha256=7dvExfA16g1z5Kut8xyHnSUfZ6wiUUwWNy6R7WKiwas,6922
 htmlgraph/learning.py,sha256=6SsRdz-xJGFPjp7YagpUDTZqqjNKp2wWihcnhwkHys0,28566
 htmlgraph/mcp_server.py,sha256=AeJeGJEtX5Dqu5rfhKfT5kwF2Oe8V8xCaP8BgMEh86s,24033
-htmlgraph/models.py,sha256=vigJmC_MkKcHH362Yoauomy7fOQ0Xrn2XNASgCDEKK8,82362
-htmlgraph/orchestrator-system-prompt-optimized.txt,sha256=8UptB4-jmyz0OrjRm5VlJqBxzk3oXNJEgUQChuTWhR8,2885
+htmlgraph/models.py,sha256=Zs4aXDv9TRNqkFxib_TKgMpiygHak1mV1TAM0doZJqI,83045
+htmlgraph/orchestrator-system-prompt-optimized.txt,sha256=O9GwHwitLyYMAbNuNsPVVG4UtHGC7uPnmIhUTfFj-PY,9671
 htmlgraph/orchestrator.py,sha256=6mj70vroWjmNmdvQ7jqqRSA9O1rFUNMUYDWPzqkizLk,19697
 htmlgraph/orchestrator_mode.py,sha256=F6LNZARqieQXUri3CRSq_lsqFbnVeGXJQPno1ZP47O4,9187
 htmlgraph/orchestrator_validator.py,sha256=gd_KbHsRsNEIF7EElwcxbMYqOMlyeuYIZwClASp-L-E,4699
@@ -32,8 +32,9 @@ htmlgraph/parallel.py,sha256=BsyqGKWY_DkSRElBdvvAkWlL6stC9BPkyxjdPdggx_w,22418
 htmlgraph/parser.py,sha256=mPcQ3WQdDCpflhjk8397TPbHnQcU3SzefNk-JE406UA,16570
 htmlgraph/planning.py,sha256=iqPF9mCVQwOfJ4vuqcF2Y3-yhx9koJZw0cID7CknIug,35903
 htmlgraph/query_builder.py,sha256=aNtJ05GpGl9yUSSrX0D6pX_AgqlrrH-CulI_oP11PUk,18092
+htmlgraph/reflection.py,sha256=j5oclTrmRGEFgGCPHh93QSasEG2IMAFdFXRj7tP-S2c,15662
 htmlgraph/routing.py,sha256=QYDY6bzYPmv6kocAXCqguB1cazN0i_xTo9EVCO3fO2Y,8803
-htmlgraph/sdk.py,sha256=jhKHAU7hFsKFawQQOYjwnM4FJ69HC9lOwCDRh2Qt9ho,100400
+htmlgraph/sdk.py,sha256=GgQOXDiqpNtO0PTf88_taxLhJK4dLOjeGR5ExZw_F-4,101109
 htmlgraph/server.py,sha256=F94rNpGSlgCg3Ax6kvzi7WjWFeHr7QerLxgmVknP4gA,52479
 htmlgraph/session_manager.py,sha256=8_H29kN6Btii1RfzNpifjjUVTMU0cEeTElFsDC6icLM,89430
 htmlgraph/session_warning.py,sha256=leAYNp8pOkPFosIvNkY4Y3vjs1j76F3pGktUqQX9tI0,7877
@@ -70,6 +71,16 @@ htmlgraph/builders/pattern.py,sha256=QIKHJ3raOjwAWj1KipWA5o9wxbFCZLPsnoF1CkuFbnE
 htmlgraph/builders/phase.py,sha256=pvdG_ZiswzdRCBM1pz7hOoCS9MD-lwaOgPqVcuLXucs,3611
 htmlgraph/builders/spike.py,sha256=_LXMDEJCdCjJPbNB8CA0FDlFDN-pZbdzvQDFXdrldo0,4327
 htmlgraph/builders/track.py,sha256=tdolGgYQl3PvoX6jHNCq3Vh6USrb7uN3NX555SoRHGs,23097
+htmlgraph/cigs/__init__.py,sha256=FQa1Tx0fnp7U0RgM-4A_WuZvuFjLC_qCgRt9KdFG3nU,1935
+htmlgraph/cigs/autonomy.py,sha256=kq35CbzI9UV9h0Bzy8t9YIJwmHHM9KD381RUocQIlNs,14075
+htmlgraph/cigs/cost.py,sha256=DcXsIoJt_IlGVSD0Unk8f9lJUwoEXiBZATFHOM2SdjY,17502
+htmlgraph/cigs/messages_basic.py,sha256=QWaOmV6BLLkutrQGfX7B-RIEEy0dwGlUj1BuCKz2Shg,16422
+htmlgraph/cigs/messaging.py,sha256=jx6Y9fvuFHkoP_g2C4ff54ymfJBsVPAjORq5XORHslA,12965
+htmlgraph/cigs/models.py,sha256=QoCpaRsw8DzNzA9oPBcqr76ZMghxKtCJCVtL1zB5U6E,27643
+htmlgraph/cigs/pattern_storage.py,sha256=7ZjLc62xEk5TwLUkd88MW02d_iLNkDffX3CFudR95mg,14201
+htmlgraph/cigs/patterns.py,sha256=qshVy2jey3_MJaizYIagi_qWbSnShyLyHdB100vzjn8,18456
+htmlgraph/cigs/posttool_analyzer.py,sha256=hVUXXVuvFhq-smc2JAst-gMlQWI7gXCXH9f91kBcSRs,8134
+htmlgraph/cigs/tracker.py,sha256=OcyXY7tGxbRCtlLX8Pg2bVtCtzPJtvh1VOtt4jbL9SI,10502
 htmlgraph/collections/__init__.py,sha256=qHT1UvHD-jCmNI4t1fWprWLw-5jE7NabN6kngboVRFY,1056
 htmlgraph/collections/base.py,sha256=yK-1Kdh1wq3Ng7PkEzKX2UXlbqQl8257-9WIOfVGSmI,24721
 htmlgraph/collections/bug.py,sha256=bDbZy_sdiIn7AK0b8CXs88mUEr1ZkOGVezG0aKwh0pw,1331
@@ -101,6 +112,7 @@ htmlgraph/extensions/gemini/hooks/scripts/post-tool.sh,sha256=z8lUt5qoyLylwCVqNT
 htmlgraph/extensions/gemini/hooks/scripts/session-end.sh,sha256=yQzSKfxBzuMS-U_xcS_sbISrjQwnyM-E-KMu1LeRYAI,1095
 htmlgraph/extensions/gemini/hooks/scripts/session-start.sh,sha256=thpCbfE8WD8huFU7mUMas-gWAk6BsHtYLaKlIHusNRg,2670
 htmlgraph/hooks/__init__.py,sha256=jL2HyCoFWQQ8l-4-EAlypDxPalNE3JBfDyELYWAg-g0,865
+htmlgraph/hooks/cigs_pretool_enforcer.py,sha256=q0v8KwRI0oLdfUZup95LSXJO-olokNwSY1qqTu4vWnM,12702
 htmlgraph/hooks/event_tracker.py,sha256=KQcIWbhNJser6Tip87oUAPQJgUAAKESKE5ARQasLtCM,23301
 htmlgraph/hooks/hooks-config.example.json,sha256=tXpk-U-FZzGOoNJK2uiDMbIHCYEHA794J-El0fBwkqg,197
 htmlgraph/hooks/installer.py,sha256=nOctCFDEV7BEh7ZzxNY-apu1KZG0SHPMq74UPIOChqY,11756
@@ -110,11 +122,11 @@ htmlgraph/hooks/post-checkout.sh,sha256=Hsr5hqD54jisGbtqf7-Z-G_b6XNGcee_CZRYaKYz
 htmlgraph/hooks/post-commit.sh,sha256=if65jNGZnEWsZPq_iYDNYunrZ1cmjPUEUbh6_4vfpOE,511
 htmlgraph/hooks/post-merge.sh,sha256=gq-EeFLhDUVp-J2jyWMBVFcB0pdmH54Wu1SW_Gn-s2I,541
 htmlgraph/hooks/post_tool_use_failure.py,sha256=DHkJtuAOg5KSLfFZ1O-kePwaqmtNkbGQSEn4NplzvD8,8381
-htmlgraph/hooks/posttooluse.py,sha256=imrRl29qsywRQW0-ruBbJq-FGYKCkvgbjSvis3U5j50,11261
+htmlgraph/hooks/posttooluse.py,sha256=3usICpqlIdLKsijYY61BP2QezsB45MZ6evwFSobC9Yo,12822
 htmlgraph/hooks/pre-commit.sh,sha256=gTpbnHIBFxpAl7-REhXoS0NI4Pmlqo9pQEMEngTAU_A,3865
 htmlgraph/hooks/pre-push.sh,sha256=rNnkG8YmDtyk7OuJHOcbOYQR3MYFneaG6_w2X-Hl8Hs,660
 htmlgraph/hooks/pretooluse.py,sha256=Q6wtU_IBIjCd22j7MvZrdd959TdAHx8OovIOnqkwCm0,9606
-htmlgraph/hooks/task_enforcer.py,sha256=H7Gug843BTR5H4YfAgW8-b7rjICuAHLP9cw1iNfcHew,4510
+htmlgraph/hooks/task_enforcer.py,sha256=NFyU1TiUoVZBl91AWiZwZc3JzugWxcfGbaFw2nuGHnA,6587
 htmlgraph/hooks/task_validator.py,sha256=GwEoqL2lptPWQqckkfl0N-Auc7TtHiyRlOf6p7HcoIo,5438
 htmlgraph/hooks/validator.py,sha256=cwul8fIGS-_hFKskrYC6Hjh0F9yP4_3ErAsyp_SL43c,17417
 htmlgraph/operations/README.md,sha256=5h0P-aZ3po3h_7mUpuh7jJwOL-NEvtlBlPCbqzvLrIE,1730
@@ -124,7 +136,7 @@ htmlgraph/operations/events.py,sha256=vSuLj8IWtdfPMvoK6yDmDM3kh_SDOWU8Ofu5u4DF_T
 htmlgraph/operations/hooks.py,sha256=_jRHbjrWNM1fjukEr0TBu6wn90PVfpXtJjicSITqP0A,10037
 htmlgraph/operations/server.py,sha256=cxdSYZU10pNgiNfYk2T84D_40CAFjA9wSVsRfk9Ipm8,8746
 htmlgraph/orchestration/__init__.py,sha256=a9NWy-zWG9T7f7V37ibahniF_enn-31gM4veEJkM8cw,844
-htmlgraph/orchestration/headless_spawner.py,sha256=VfMX1Ubf7N8AFF1poSGyT_yyoUPIYmzlxYJJuyWqP98,19446
+htmlgraph/orchestration/headless_spawner.py,sha256=8B_y6NojAVwwaav25izAiKGApel61gAeVzDEcm_xP9k,40244
 htmlgraph/orchestration/model_selection.py,sha256=2IArHkde5rKD56aj5Jw9I9Z5iLV0yOgw3QCmNF996DE,11311
 htmlgraph/orchestration/task_coordination.py,sha256=7_oQ4AlHOv14hs6RvLsatJzF-F5gkIbv1EOrmeGPhiw,9699
 htmlgraph/scripts/__init__.py,sha256=a_ef7jnypTH3fzjutKYtUquJospdbA6IOR4o9dgv8Gk,48
@@ -134,12 +146,12 @@ htmlgraph/services/claiming.py,sha256=HcrltEJKN72mxuD7fGuXWeh1U0vwhjMvhZcFc02Eiy
 htmlgraph/templates/AGENTS.md.template,sha256=f96h7V6ygwj-v-fanVI48eYMxR6t_se4bet1H4ZsDpI,7642
 htmlgraph/templates/CLAUDE.md.template,sha256=h1kG2hTX2XYig2KszsHBfzrwa_4Cfcq2Pj4SwqzeDlM,1984
 htmlgraph/templates/GEMINI.md.template,sha256=gAGzE53Avki87BM_otqy5HdcYCoLsHgqaKjVzNzPMX8,1622
-htmlgraph-0.23.5.data/data/htmlgraph/dashboard.html,sha256=rkZYjSnPbUuAm35QMpCNWemenYqQTdkkumCX2hhe8Dc,173537
-htmlgraph-0.23.5.data/data/htmlgraph/styles.css,sha256=oDUSC8jG-V-hKojOBO9J88hxAeY2wJrBYTq0uCwX_Y4,7135
-htmlgraph-0.23.5.data/data/htmlgraph/templates/AGENTS.md.template,sha256=f96h7V6ygwj-v-fanVI48eYMxR6t_se4bet1H4ZsDpI,7642
-htmlgraph-0.23.5.data/data/htmlgraph/templates/CLAUDE.md.template,sha256=h1kG2hTX2XYig2KszsHBfzrwa_4Cfcq2Pj4SwqzeDlM,1984
-htmlgraph-0.23.5.data/data/htmlgraph/templates/GEMINI.md.template,sha256=gAGzE53Avki87BM_otqy5HdcYCoLsHgqaKjVzNzPMX8,1622
-htmlgraph-0.23.5.dist-info/METADATA,sha256=n09K5uXhSh8VZGdMVKavkhUlZUf2ioh7Yk5Knkit4fw,7827
-htmlgraph-0.23.5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-htmlgraph-0.23.5.dist-info/entry_points.txt,sha256=EaUbjA_bbDwEO_XDLEGMeK8aQP-ZnHiUTkLshyKDyB8,98
-htmlgraph-0.23.5.dist-info/RECORD,,
+htmlgraph-0.24.1.data/data/htmlgraph/dashboard.html,sha256=rkZYjSnPbUuAm35QMpCNWemenYqQTdkkumCX2hhe8Dc,173537
+htmlgraph-0.24.1.data/data/htmlgraph/styles.css,sha256=oDUSC8jG-V-hKojOBO9J88hxAeY2wJrBYTq0uCwX_Y4,7135
+htmlgraph-0.24.1.data/data/htmlgraph/templates/AGENTS.md.template,sha256=f96h7V6ygwj-v-fanVI48eYMxR6t_se4bet1H4ZsDpI,7642
+htmlgraph-0.24.1.data/data/htmlgraph/templates/CLAUDE.md.template,sha256=h1kG2hTX2XYig2KszsHBfzrwa_4Cfcq2Pj4SwqzeDlM,1984
+htmlgraph-0.24.1.data/data/htmlgraph/templates/GEMINI.md.template,sha256=gAGzE53Avki87BM_otqy5HdcYCoLsHgqaKjVzNzPMX8,1622
+htmlgraph-0.24.1.dist-info/METADATA,sha256=a0UZKmR2Kho_tfbBzgFiAnC4CmhkrmE3wkhRCQOLMcw,7881
+htmlgraph-0.24.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+htmlgraph-0.24.1.dist-info/entry_points.txt,sha256=EaUbjA_bbDwEO_XDLEGMeK8aQP-ZnHiUTkLshyKDyB8,98
+htmlgraph-0.24.1.dist-info/RECORD,,