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

htmlgraph/orchestration/spawners/copilot.py

@@ -1,12 +1,14 @@
 """Copilot spawner implementation."""
 
+import logging
 import subprocess
-import sys
 import time
 from typing import TYPE_CHECKING, Any
 
 from .base import AIResult, BaseSpawner
 
+logger = logging.getLogger(__name__)
+
 if TYPE_CHECKING:
     from htmlgraph.sdk import SDK
 
@@ -129,15 +131,11 @@ class CopilotSpawner(BaseSpawner):
 
             # Record subprocess invocation if tracker is available
             subprocess_event_id = None
-            print(
-                f"DEBUG: tracker={tracker is not None}, parent_event_id={parent_event_id}",
-                file=sys.stderr,
+            logger.warning(
+                f"DEBUG: tracker={tracker is not None}, parent_event_id={parent_event_id}"
             )
             if tracker and parent_event_id:
-                print(
-                    "DEBUG: Recording subprocess invocation for Copilot...",
-                    file=sys.stderr,
-                )
+                logger.debug("Recording subprocess invocation for Copilot...")
                 try:
                     subprocess_event = tracker.record_tool_call(
                         tool_name="subprocess.copilot",
@@ -147,23 +145,20 @@ class CopilotSpawner(BaseSpawner):
                     )
                     if subprocess_event:
                         subprocess_event_id = subprocess_event.get("event_id")
-                        print(
-                            f"DEBUG: Subprocess event created for Copilot: {subprocess_event_id}",
-                            file=sys.stderr,
+                        logger.warning(
+                            f"DEBUG: Subprocess event created for Copilot: {subprocess_event_id}"
                         )
                     else:
-                        print("DEBUG: subprocess_event was None", file=sys.stderr)
+                        logger.debug("subprocess_event was None")
                 except Exception as e:
                     # Tracking failure should not break execution
-                    print(
-                        f"DEBUG: Exception recording Copilot subprocess: {e}",
-                        file=sys.stderr,
+                    logger.warning(
+                        f"DEBUG: Exception recording Copilot subprocess: {e}"
                     )
                     pass
             else:
-                print(
-                    f"DEBUG: Skipping Copilot subprocess tracking - tracker={tracker is not None}, parent_event_id={parent_event_id}",
-                    file=sys.stderr,
+                logger.warning(
+                    f"DEBUG: Skipping Copilot subprocess tracking - tracker={tracker is not None}, parent_event_id={parent_event_id}"
                 )
 
             result = subprocess.run(

htmlgraph/orchestration/spawners/gemini.py

@@ -1,13 +1,15 @@
 """Gemini spawner implementation."""
 
 import json
+import logging
 import subprocess
-import sys
 import time
 from typing import TYPE_CHECKING, Any
 
 from .base import AIResult, BaseSpawner
 
+logger = logging.getLogger(__name__)
+
 if TYPE_CHECKING:
     from htmlgraph.sdk import SDK
 
@@ -220,15 +222,11 @@ class GeminiSpawner(BaseSpawner):
 
             # Record subprocess invocation if tracker is available
             subprocess_event_id = None
-            print(
-                f"DEBUG: tracker={tracker is not None}, parent_event_id={parent_event_id}",
-                file=sys.stderr,
+            logger.warning(
+                f"DEBUG: tracker={tracker is not None}, parent_event_id={parent_event_id}"
             )
             if tracker and parent_event_id:
-                print(
-                    "DEBUG: Recording subprocess invocation for Gemini...",
-                    file=sys.stderr,
-                )
+                logger.debug("Recording subprocess invocation for Gemini...")
                 try:
                     subprocess_event = tracker.record_tool_call(
                         tool_name="subprocess.gemini",
@@ -238,23 +236,18 @@ class GeminiSpawner(BaseSpawner):
                     )
                     if subprocess_event:
                         subprocess_event_id = subprocess_event.get("event_id")
-                        print(
-                            f"DEBUG: Subprocess event created for Gemini: {subprocess_event_id}",
-                            file=sys.stderr,
+                        logger.warning(
+                            f"DEBUG: Subprocess event created for Gemini: {subprocess_event_id}"
                         )
                     else:
-                        print("DEBUG: subprocess_event was None", file=sys.stderr)
+                        logger.debug("subprocess_event was None")
                 except Exception as e:
                     # Tracking failure should not break execution
-                    print(
-                        f"DEBUG: Exception recording Gemini subprocess: {e}",
-                        file=sys.stderr,
-                    )
+                    logger.warning(f"DEBUG: Exception recording Gemini subprocess: {e}")
                     pass
             else:
-                print(
-                    f"DEBUG: Skipping Gemini subprocess tracking - tracker={tracker is not None}, parent_event_id={parent_event_id}",
-                    file=sys.stderr,
+                logger.warning(
+                    f"DEBUG: Skipping Gemini subprocess tracking - tracker={tracker is not None}, parent_event_id={parent_event_id}"
                 )
 
             # Execute with timeout and stderr redirection

htmlgraph/orchestration/subprocess_runner.py

@@ -1,13 +1,16 @@
+from __future__ import annotations
+
 """Subprocess execution with standardized error handling.
 
 Provides consistent error handling for Claude Code CLI invocations.
 """
 
-from __future__ import annotations
-
+import logging
 import subprocess
 import sys
 
+logger = logging.getLogger(__name__)
+
 
 class SubprocessRunner:
     """Execute subprocess commands with error handling."""
@@ -25,7 +28,7 @@ class SubprocessRunner:
         try:
             subprocess.run(cmd, check=False)
         except FileNotFoundError:
-            print("Error: 'claude' command not found.", file=sys.stderr)
+            logger.warning("Error: 'claude' command not found.")
             print(
                 "Please install Claude Code CLI: https://code.claude.com",
                 file=sys.stderr,

htmlgraph/orchestration/task_coordination.py

@@ -1,3 +1,7 @@
+import logging
+
+logger = logging.getLogger(__name__)
+
 """
 Orchestration helpers for reliable parallel task coordination.
 
@@ -7,9 +11,13 @@ Provides Task ID pattern for retrieving results from parallel delegations.
 import time
 import uuid
 from datetime import datetime, timedelta
-from typing import Any
+from typing import TYPE_CHECKING, Any
 
-from htmlgraph.sdk import SDK
+if TYPE_CHECKING:
+    from htmlgraph.sdk import SDK
+else:
+    # Avoid circular import during module initialization
+    SDK = None
 
 
 def generate_task_id() -> str:
@@ -72,7 +80,7 @@ Provide detailed findings in your response.
 
 
 def get_results_by_task_id(
-    sdk: SDK,
+    sdk: "SDK",
     task_id: str,
     timeout: int = 60,
     poll_interval: int = 2,
@@ -138,7 +146,7 @@ def get_results_by_task_id(
 
 
 def parallel_delegate(
-    sdk: SDK,
+    sdk: "SDK",
     tasks: list[dict[str, str]],
     timeout: int = 120,
 ) -> dict[str, dict[str, Any]]:
@@ -161,7 +169,7 @@ def parallel_delegate(
         ])
 
         for task_id, result in results.items():
-            print(f"{task_id}: {result['findings']}")
+            logger.info(f"{task_id}: {result['findings']}")
     """
     # Generate task IDs and enhanced prompts
     task_mapping = {}
@@ -189,7 +197,7 @@ def parallel_delegate(
 
 
 def save_task_results(
-    sdk: SDK,
+    sdk: "SDK",
     task_id: str,
     description: str,
     results: str,
@@ -263,7 +271,7 @@ def save_task_results(
 
 
 def validate_and_save(
-    sdk: SDK,
+    sdk: "SDK",
     task_id: str,
     description: str,
     results: str,
@@ -303,7 +311,7 @@ def validate_and_save(
         )
 
         if outcome["validated"]:
-            print(f"✅ Saved to spike: {outcome['spike_id']}")
+            logger.info(f"✅ Saved to spike: {outcome['spike_id']}")
     """
     validated = True
     validation_results = None

htmlgraph/orchestrator.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 """
 SubagentOrchestrator for context-preserving delegation.
 
@@ -83,7 +85,6 @@ Key Patterns
 4. Parallel execution: Multiple subagents can work simultaneously
 """
 
-from __future__ import annotations
 
 from dataclasses import dataclass, field
 from datetime import datetime

htmlgraph/parallel.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 """
 Parallel workflow execution coordinator for multi-agent task processing.
 
@@ -76,7 +78,6 @@ Best Practices:
     - Limit to 3-5 parallel agents for optimal results
 """
 
-from __future__ import annotations
 
 from dataclasses import dataclass, field
 from datetime import datetime

htmlgraph/query_builder.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 """
 Fluent Query Builder for HtmlGraph.
 
@@ -24,7 +26,6 @@ Example:
         .execute()
 """
 
-from __future__ import annotations
 
 import re
 from collections.abc import Callable, Iterator

htmlgraph/reflection.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 """
 Computational Reflection Module.
 
@@ -23,7 +25,6 @@ Usage:
     # }
 """
 
-from __future__ import annotations
 
 from dataclasses import dataclass
 from datetime import datetime, timedelta

htmlgraph/refs.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 """
 Short reference manager for graph nodes.
 
@@ -5,7 +7,6 @@ Manages persistent mapping of short refs (@f1, @t2, @b5) to full node IDs,
 enabling AI-friendly snapshots and queries.
 """
 
-from __future__ import annotations
 
 import json
 from datetime import datetime

htmlgraph/repo_hash.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 """
 Repository Hashing and Git Awareness Module.
 
@@ -22,7 +24,6 @@ Architecture:
     - monorepo_project: "project-name" (if in monorepo)
 """
 
-from __future__ import annotations
 
 import hashlib
 import logging