htmlgraph 0.23.2__py3-none-any.whl → 0.23.4__py3-none-any.whl

htmlgraph/__init__.py

@@ -84,7 +84,7 @@ from htmlgraph.types import (
 )
 from htmlgraph.work_type_utils import infer_work_type, infer_work_type_from_id
 
-__version__ = "0.23.2"
+__version__ = "0.23.4"
 __all__ = [
     # Exceptions
     "HtmlGraphError",

htmlgraph/agent_detection.py

@@ -20,8 +20,7 @@ def detect_agent_name() -> str:
         1. HTMLGRAPH_AGENT environment variable (explicit override)
         2. Claude Code detection (CLAUDE_CODE_VERSION, parent process)
         3. Gemini detection (GEMINI environment markers)
-        4. OpenCode detection (OPENCODE environment markers)
-        5. Fall back to "cli"
+        4. Fall back to "cli"
     """
     # 1. Explicit override
     explicit = os.environ.get("HTMLGRAPH_AGENT")
@@ -36,11 +35,7 @@ def detect_agent_name() -> str:
     if _is_gemini():
         return "gemini"
 
-    # 4. OpenCode detection
-    if _is_opencode():
-        return "opencode"
-
-    # 5. Default to CLI
+    # 4. Default to CLI
     return "cli"
 
 
@@ -93,39 +88,6 @@ def _is_gemini() -> bool:
     return False
 
 
-def _is_opencode() -> bool:
-    """Check if running in OpenCode environment."""
-    # Check for OpenCode-specific environment variables
-    if os.environ.get("OPENCODE_VERSION"):
-        return True
-
-    if os.environ.get("OPENCODE_API_KEY"):
-        return True
-
-    if os.environ.get("OPENCODE_SESSION_ID"):
-        return True
-
-    # Check for opencode in command line args
-    if any("opencode" in arg.lower() for arg in sys.argv):
-        return True
-
-    # Check for OpenCode configuration
-    try:
-        # Look for OpenCode config in common locations
-        opencode_config = Path.home() / ".opencode"
-        if opencode_config.exists():
-            return True
-
-        # Check project-level OpenCode config
-        project_config = Path.cwd() / ".opencode"
-        if project_config.exists():
-            return True
-    except Exception:
-        pass
-
-    return False
-
-
 def get_agent_display_name(agent: str) -> str:
     """
     Get a human-friendly display name for an agent.
@@ -140,7 +102,6 @@ def get_agent_display_name(agent: str) -> str:
         "claude": "Claude",
         "claude-code": "Claude",
         "gemini": "Gemini",
-        "opencode": "OpenCode",
         "cli": "CLI",
         "haiku": "Haiku",
         "opus": "Opus",

htmlgraph/cli.py

@@ -11,7 +11,8 @@ Usage:
 Claude Code Integration:
     htmlgraph claude                    # Start Claude Code
     htmlgraph claude --init             # Start with orchestrator system prompt (recommended)
-    htmlgraph claude --continue         # Resume last Claude Code session
+    htmlgraph claude --continue         # Resume last Claude Code session (with plugin loaded)
+    htmlgraph claude --dev              # Start in development mode (load plugin from packages/)
 
 Session Management:
     htmlgraph session start [--id ID] [--agent AGENT]
@@ -170,7 +171,7 @@ def cmd_init(args: argparse.Namespace) -> None:
         generate_docs = True  # Always generate in non-interactive mode
 
     def init_progress() -> tuple[Any | None, Any | None]:
-        if args.quiet or getattr(args, "format", "text") != "text":
+        if getattr(args, "quiet", False) or getattr(args, "format", "text") != "text":
             return None, None
         try:
             from rich.console import Console
@@ -3589,6 +3590,19 @@ def cmd_claude(args: argparse.Namespace) -> None:
     """Start Claude Code with orchestrator prompt."""
     import textwrap
 
+    # Load orchestration rules from plugin
+    rules_file = (
+        Path(__file__).parent.parent.parent.parent
+        / "packages"
+        / "claude-plugin"
+        / "rules"
+        / "orchestration.md"
+    )
+
+    orchestration_rules = ""
+    if rules_file.exists():
+        orchestration_rules = rules_file.read_text(encoding="utf-8")
+
     try:
         if args.init:
             # Load optimized orchestrator system prompt
@@ -3622,9 +3636,14 @@ def cmd_claude(args: argparse.Namespace) -> None:
                     """
                 )
 
+            # Combine fallback prompt with orchestration rules
+            combined_prompt = system_prompt
+            if orchestration_rules:
+                combined_prompt = f"{system_prompt}\n\n---\n\n{orchestration_rules}"
+
             if args.quiet or args.format == "json":
                 # Non-interactive: directly launch Claude with system prompt
-                cmd = ["claude", "--append-system-prompt", system_prompt]
+                cmd = ["claude", "--append-system-prompt", combined_prompt]
             else:
                 # Interactive: show summary first
                 print("=" * 60)
@@ -3632,13 +3651,13 @@ def cmd_claude(args: argparse.Namespace) -> None:
                 print("=" * 60)
                 print("\nStarting Claude Code with orchestrator system prompt...")
                 print("Key directives:")
-                print("  ✓ Delegate implementation to subagents")
+                print("  ✓ Delegate to Gemini (FREE), Codex, Copilot first")
+                print("  ✓ Use Task() only as fallback")
                 print("  ✓ Create work items before delegating")
                 print("  ✓ Track all work in .htmlgraph/")
-                print("  ✓ Respect dependency chains")
                 print()
 
-                cmd = ["claude", "--append-system-prompt", system_prompt]
+                cmd = ["claude", "--append-system-prompt", combined_prompt]
 
             try:
                 subprocess.run(cmd, check=False)
@@ -3652,12 +3671,78 @@ def cmd_claude(args: argparse.Namespace) -> None:
 
         elif args.continue_session:
             # Resume last Claude Code session
+            # Find plugin directory relative to project root
+            plugin_dir = (
+                Path(__file__).parent.parent.parent.parent
+                / "packages"
+                / "claude-plugin"
+                / ".claude-plugin"
+            )
+
             if args.quiet or args.format == "json":
                 cmd = ["claude", "--resume"]
             else:
                 print("Resuming last Claude Code session...")
                 cmd = ["claude", "--resume"]
 
+            # Add orchestration rules if available
+            if orchestration_rules:
+                cmd.extend(["--append-system-prompt", orchestration_rules])
+                if not (args.quiet or args.format == "json"):
+                    print("  ✓ Multi-AI delegation rules injected")
+
+            # Add plugin directory if it exists
+            if plugin_dir.exists():
+                cmd.extend(["--plugin-dir", str(plugin_dir)])
+                if not (args.quiet or args.format == "json"):
+                    print(f"  ✓ Loading plugin from: {plugin_dir}")
+
+            try:
+                subprocess.run(cmd, check=False)
+            except FileNotFoundError:
+                print("Error: 'claude' command not found.", file=sys.stderr)
+                print(
+                    "Please install Claude Code CLI: https://code.claude.com",
+                    file=sys.stderr,
+                )
+                sys.exit(1)
+
+        elif args.dev:
+            # Development mode: load plugin from local directory
+            plugin_dir = (
+                Path(__file__).parent.parent.parent.parent
+                / "packages"
+                / "claude-plugin"
+                / ".claude-plugin"
+            )
+
+            if not plugin_dir.exists():
+                print(
+                    f"Error: Plugin directory not found: {plugin_dir}", file=sys.stderr
+                )
+                print(
+                    "Expected location: packages/claude-plugin/.claude-plugin",
+                    file=sys.stderr,
+                )
+                sys.exit(1)
+
+            if args.quiet or args.format == "json":
+                cmd = ["claude", "--plugin-dir", str(plugin_dir)]
+            else:
+                print("=" * 60)
+                print("🔧 HtmlGraph Development Mode")
+                print("=" * 60)
+                print(f"\nLoading plugin from: {plugin_dir}")
+                print("  ✓ Skills, agents, and hooks will be loaded from local files")
+                print("  ✓ Multi-AI delegation rules will be injected")
+                print("  ✓ Changes to plugin files will take effect after restart")
+                print()
+                cmd = ["claude", "--plugin-dir", str(plugin_dir)]
+
+            # Add orchestration rules if available
+            if orchestration_rules:
+                cmd.extend(["--append-system-prompt", orchestration_rules])
+
             try:
                 subprocess.run(cmd, check=False)
             except FileNotFoundError:
@@ -3670,8 +3755,16 @@ def cmd_claude(args: argparse.Namespace) -> None:
 
         else:
             # Default: start normal Claude Code session
+            cmd = ["claude"]
+
+            # Add orchestration rules if available
+            if orchestration_rules:
+                cmd.extend(["--append-system-prompt", orchestration_rules])
+                if not (args.quiet or args.format == "json"):
+                    print("Starting Claude Code with multi-AI delegation rules...")
+
             try:
-                subprocess.run(["claude"], check=False)
+                subprocess.run(cmd, check=False)
             except FileNotFoundError:
                 print("Error: 'claude' command not found.", file=sys.stderr)
                 print(
@@ -5106,6 +5199,11 @@ For more help: https://github.com/Shakes-tzd/htmlgraph
         action="store_true",
         help="Resume last Claude Code session",
     )
+    claude_group.add_argument(
+        "--dev",
+        action="store_true",
+        help="Start in development mode with plugin loaded from packages/claude-plugin",
+    )
     claude_parser.set_defaults(func=cmd_claude)
 
     args = parser.parse_args()

htmlgraph/collections/base.py

@@ -71,7 +71,19 @@ class BaseCollection(Generic[CollectionT]):
         self._graph: HtmlGraph | None = None  # Lazy-loaded
 
     def _ensure_graph(self) -> HtmlGraph:
-        """Get the graph for this collection, using SDK's shared instances where available."""
+        """
+        Get or initialize the graph for this collection.
+
+        Uses SDK's shared graph instances where available to avoid creating
+        multiple graph objects for the same collection. Creates a new instance
+        for unrecognized collections.
+
+        Returns:
+            HtmlGraph instance for this collection
+
+        Note:
+            This method is lazy - the graph is only loaded on first access.
+        """
         if self._graph is None:
             # Use SDK's shared graph instances to avoid multiple graph objects
             if self._collection_name == "features" and hasattr(self._sdk, "_graph"):
@@ -92,7 +104,21 @@ class BaseCollection(Generic[CollectionT]):
         return self._graph
 
     def __getattribute__(self, name: str) -> Any:
-        """Override to provide helpful error messages for missing attributes."""
+        """
+        Override attribute access to provide helpful error messages.
+
+        When an attribute doesn't exist, provides suggestions for common
+        mistakes and similar method names to improve discoverability.
+
+        Args:
+            name: Attribute name being accessed
+
+        Returns:
+            The requested attribute
+
+        Raises:
+            AttributeError: With helpful suggestions if attribute not found
+        """
         try:
             return object.__getattribute__(self, name)
         except AttributeError as e:
@@ -134,7 +160,15 @@ class BaseCollection(Generic[CollectionT]):
             raise AttributeError(error_msg) from e
 
     def __dir__(self) -> list[str]:
-        """Return attributes with most useful ones first for discoverability."""
+        """
+        Return attributes with most useful ones first.
+
+        Orders attributes to show commonly-used methods first in auto-complete
+        and help() output, improving discoverability for new users.
+
+        Returns:
+            List of attribute names, ordered by priority then alphabetically
+        """
         priority = [
             # Creation and retrieval
             "create",
@@ -518,13 +552,15 @@ class BaseCollection(Generic[CollectionT]):
         """
         Start working on a node (feature/bug/etc).
 
-        Delegates to SessionManager to:
+        Delegates to SessionManager if available for smart tracking:
         1. Check WIP limits
         2. Ensure not claimed by others
         3. Auto-claim for agent
         4. Link to active session
         5. Log 'FeatureStart' event
 
+        Falls back to simple status update if SessionManager not available.
+
         Args:
             node_id: Node ID to start
             agent: Agent ID (defaults to SDK agent)
@@ -534,6 +570,10 @@ class BaseCollection(Generic[CollectionT]):
 
         Raises:
             NodeNotFoundError: If node not found
+
+        Example:
+            >>> sdk.features.start('feat-abc123')
+            >>> sdk.features.start('feat-xyz', agent='claude')
         """
         agent = agent or self._sdk.agent
 
@@ -566,14 +606,17 @@ class BaseCollection(Generic[CollectionT]):
         transcript_id: str | None = None,
     ) -> Node | None:
         """
-        Complete a node.
+        Mark a node as complete.
 
-        Delegates to SessionManager to:
-        1. Update status
+        Delegates to SessionManager if available for event logging and
+        transcript linking:
+        1. Update status to 'done'
         2. Log 'FeatureComplete' event
         3. Release claim (optional behavior)
         4. Link transcript if provided (for parallel agent tracking)
 
+        Falls back to simple status update if SessionManager not available.
+
         Args:
             node_id: Node ID to complete
             agent: Agent ID (defaults to SDK agent)
@@ -585,6 +628,10 @@ class BaseCollection(Generic[CollectionT]):
 
         Raises:
             NodeNotFoundError: If node not found
+
+        Example:
+            >>> sdk.features.complete('feat-abc123')
+            >>> sdk.features.complete('feat-xyz', agent='claude', transcript_id='trans-123')
         """
         agent = agent or self._sdk.agent
 
@@ -615,11 +662,13 @@ class BaseCollection(Generic[CollectionT]):
         """
         Claim a node for an agent.
 
-        Delegates to SessionManager to:
+        Delegates to SessionManager if available for ownership tracking:
         1. Check ownership rules
         2. Update assignment
         3. Log 'FeatureClaim' event
 
+        Falls back to simple assignment if SessionManager not available.
+
         Args:
             node_id: Node ID to claim
             agent: Agent ID (defaults to SDK agent)
@@ -631,6 +680,10 @@ class BaseCollection(Generic[CollectionT]):
             ValueError: If agent not provided and SDK has no agent
             NodeNotFoundError: If node not found
             ClaimConflictError: If node already claimed by different agent
+
+        Example:
+            >>> sdk.features.claim('feat-abc123')
+            >>> sdk.features.claim('feat-xyz', agent='claude')
         """
         agent = agent or self._sdk.agent
         if not agent:
@@ -665,11 +718,13 @@ class BaseCollection(Generic[CollectionT]):
         """
         Release a claimed node.
 
-        Delegates to SessionManager to:
+        Delegates to SessionManager if available for ownership tracking:
         1. Verify ownership
         2. Clear assignment
         3. Log 'FeatureRelease' event
 
+        Falls back to simple assignment clearing if SessionManager not available.
+
         Args:
             node_id: Node ID to release
             agent: Agent ID (defaults to SDK agent)
@@ -679,6 +734,10 @@ class BaseCollection(Generic[CollectionT]):
 
         Raises:
             NodeNotFoundError: If node not found
+
+        Example:
+            >>> sdk.features.release('feat-abc123')
+            >>> sdk.features.release('feat-xyz', agent='claude')
         """
         # SessionManager.release_feature requires an agent to verify ownership
         agent = agent or self._sdk.agent

htmlgraph/converter.py

@@ -395,7 +395,8 @@ def html_to_session(filepath: Path | str) -> Session:
     parser = HtmlParser.from_file(filepath)
 
     # Get article element with session data
-    article = parser.query_one("article[data-type='session']")
+    article_results = parser.query("article[data-type='session']")
+    article = article_results[0] if article_results else None
     if not article:
         raise ValueError(f"No session article found in: {filepath}")
 
@@ -465,7 +466,8 @@ def html_to_session(filepath: Path | str) -> Session:
         data["transcript_git_branch"] = transcript_branch
 
     # Parse title
-    title_el = parser.query_one("h1")
+    title_el_results = parser.query("h1")
+    title_el = title_el_results[0] if title_el_results else None
     if title_el:
         data["title"] = title_el.to_text().strip()
 
@@ -482,24 +484,28 @@ def html_to_session(filepath: Path | str) -> Session:
     data["worked_on"] = worked_on
 
     # Parse continued_from edge
-    continued_link = parser.query_one(
+    continued_link_results = parser.query(
         "nav[data-graph-edges] section[data-edge-type='continued-from'] a"
     )
+    continued_link = continued_link_results[0] if continued_link_results else None
     if continued_link:
         href = continued_link.attrs.get("href") or ""
         data["continued_from"] = href.replace(".html", "")
 
     # Parse handoff context
-    handoff_section = parser.query_one("section[data-handoff]")
+    handoff_section_results = parser.query("section[data-handoff]")
+    handoff_section = handoff_section_results[0] if handoff_section_results else None
     if handoff_section:
-        notes_el = parser.query_one("section[data-handoff] [data-handoff-notes]")
+        notes_el_results = parser.query("section[data-handoff] [data-handoff-notes]")
+        notes_el = notes_el_results[0] if notes_el_results else None
         if notes_el:
             notes_text = notes_el.to_text().strip()
             if notes_text.lower().startswith("notes:"):
                 notes_text = notes_text.split(":", 1)[1].strip()
             data["handoff_notes"] = notes_text
 
-        next_el = parser.query_one("section[data-handoff] [data-recommended-next]")
+        next_el_results = parser.query("section[data-handoff] [data-recommended-next]")
+        next_el = next_el_results[0] if next_el_results else None
         if next_el:
             next_text = next_el.to_text().strip()
             if next_text.lower().startswith("recommended next:"):
@@ -555,12 +561,14 @@ def html_to_session(filepath: Path | str) -> Session:
         pattern_type = tr.attrs.get("data-pattern-type", "neutral")
 
         # Extract sequence from first <td class="sequence">
-        seq_td = tr.query_one("td.sequence")
+        seq_tds = tr.query("td.sequence")
+        seq_td = seq_tds[0] if seq_tds else None
         sequence_str = seq_td.to_text().strip() if seq_td else ""
         sequence = [s.strip() for s in sequence_str.split("→")] if sequence_str else []
 
         # Extract count from third <td>
-        count_td = tr.query_all("td")[2] if len(tr.query_all("td")) > 2 else None
+        tds = tr.query("td")
+        count_td = tds[2] if len(tds) > 2 else None
         count_str = count_td.to_text().strip() if count_td else "0"
         try:
             count = int(count_str)
@@ -568,7 +576,7 @@ def html_to_session(filepath: Path | str) -> Session:
             count = 0
 
         # Extract timestamps from fourth <td>
-        time_td = tr.query_all("td")[3] if len(tr.query_all("td")) > 3 else None
+        time_td = tds[3] if len(tds) > 3 else None
         time_str = time_td.to_text().strip() if time_td else ""
         times = time_str.split(" / ")
         first_detected = times[0].strip() if len(times) > 0 else ""

htmlgraph/models.py

@@ -317,6 +317,24 @@ class Node(BaseModel):
             "session_ids": self.context_sessions,
         }
 
+    def to_dict(self) -> dict:
+        """
+        Convert Node to dictionary format.
+
+        This is a convenience alias for Pydantic's model_dump() method,
+        providing a more discoverable API for serialization.
+
+        Returns:
+            dict: Dictionary representation of the Node with all fields
+
+        Example:
+            >>> feature = sdk.features.create("My Feature").save()
+            >>> data = feature.to_dict()
+            >>> print(data['title'])
+            'My Feature'
+        """
+        return self.model_dump()
+
     def to_html(self, stylesheet_path: str = "../styles.css") -> str:
         """
         Convert node to full HTML document.

htmlgraph/parser.py

@@ -80,7 +80,8 @@ class HtmlParser:
 
     def get_article(self) -> Any | None:
         """Get the main article element (graph node root)."""
-        return self.query_one("article[id]")
+        results = self.query("article[id]")
+        return results[0] if results else None
 
     def get_node_id(self) -> str | None:
         """Extract node ID from article element."""
@@ -200,13 +201,15 @@ class HtmlParser:
     def get_title(self) -> str | None:
         """Get node title from h1 or title element."""
         # Try h1 in header first
-        h1 = self.query_one("article header h1")
+        h1_results = self.query("article header h1")
+        h1 = h1_results[0] if h1_results else None
         if h1:
             text: str = h1.to_text().strip()
             return text
 
         # Fall back to title element
-        title = self.query_one("title")
+        title_results = self.query("title")
+        title = title_results[0] if title_results else None
         if title:
             text2: str = title.to_text().strip()
             return text2
@@ -225,7 +228,8 @@ class HtmlParser:
         """
         edges: dict[str, list[dict[str, Any]]] = {}
 
-        edge_nav = self.query_one("nav[data-graph-edges]")
+        edge_nav_results = self.query("nav[data-graph-edges]")
+        edge_nav = edge_nav_results[0] if edge_nav_results else None
         if not edge_nav:
             return edges
 
@@ -363,7 +367,10 @@ class HtmlParser:
 
     def get_content(self) -> str:
         """Extract main content from section[data-content]."""
-        content_section = self.query_one("section[data-content]")
+        content_section_results = self.query("section[data-content]")
+        content_section = (
+            content_section_results[0] if content_section_results else None
+        )
         if not content_section:
             return ""
 
@@ -381,12 +388,16 @@ class HtmlParser:
 
     def get_findings(self) -> str | None:
         """Extract findings from section[data-findings] (Spike-specific)."""
-        findings_section = self.query_one("section[data-findings]")
+        findings_section_results = self.query("section[data-findings]")
+        findings_section = (
+            findings_section_results[0] if findings_section_results else None
+        )
         if not findings_section:
             return None
 
         # Look for findings-content div using full selector
-        content_div = self.query_one("section[data-findings] div.findings-content")
+        content_div_results = self.query("section[data-findings] div.findings-content")
+        content_div = content_div_results[0] if content_div_results else None
         if content_div:
             text = content_div.to_text().strip()
             return text if text else None
@@ -406,7 +417,10 @@ class HtmlParser:
 
     def get_decision(self) -> str | None:
         """Extract decision from section[data-decision] (Spike-specific)."""
-        decision_section = self.query_one("section[data-decision]")
+        decision_section_results = self.query("section[data-decision]")
+        decision_section = (
+            decision_section_results[0] if decision_section_results else None
+        )
         if not decision_section:
             return None
 

{htmlgraph-0.23.2.dist-info → htmlgraph-0.23.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: htmlgraph
-Version: 0.23.2
+Version: 0.23.4
 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
@@ -259,6 +259,7 @@ MIT
 ## Links
 
 - [GitHub](https://github.com/Shakes-tzd/htmlgraph)
+- [API Reference](docs/API_REFERENCE.md) - Complete SDK API documentation
 - [Documentation](docs/) - SDK guide, workflows, development principles
 - [Examples](examples/) - Real-world usage examples
 - [PyPI](https://pypi.org/project/htmlgraph/)

{htmlgraph-0.23.2.dist-info → htmlgraph-0.23.4.dist-info}/RECORD

@@ -1,12 +1,12 @@
-htmlgraph/__init__.py,sha256=CpjmLuef0RQAd4Op9FbEPyFMeLmaavFZMejnMU9FbWM,4979
-htmlgraph/agent_detection.py,sha256=MG1kx9S-ey_Wi84hJTwwgw6VDvYEbUpygmDjGPhHcUA,3805
+htmlgraph/__init__.py,sha256=leC4_bp-4lRTKLF1Vvfsi4pvj1nx_ka59W_VTDdH-6U,4979
+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=-h-_7b5xRuxyLpIYHIeNbJabe3hY3_yTql_jWxfbjTU,197621
+htmlgraph/cli.py,sha256=CZC631eM4toy2l7fP63EaORRATlUa5sDmJgU98bFjKU,201518
 htmlgraph/context_analytics.py,sha256=CaLu0o2uSr6rlBM5YeaFZe7grgsy7_Hx10qdXuNcdao,11344
-htmlgraph/converter.py,sha256=OfcydZcJqvr2jpMxvAD4wcq8o4NXC7w4X4QzdDiYq8k,22277
+htmlgraph/converter.py,sha256=fhJF2h4YbrmL1wIa1jk7kGkT_CYGHeWp_5UzXitQ6HE,22747
 htmlgraph/dashboard.html,sha256=rkZYjSnPbUuAm35QMpCNWemenYqQTdkkumCX2hhe8Dc,173537
 htmlgraph/dependency_models.py,sha256=eKpBz9y_pTE5E8baESqHyGUDj5-uXokVd2Bx3ZogAyM,4313
 htmlgraph/deploy.py,sha256=kM_IMa3PmKpQf4YVH57aL9uV5IfpVJgaj-IFsgAKIbY,17771
@@ -23,13 +23,13 @@ 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=tgFFFwOuEe7Yal5I1JTZHJnF625oaHMATEGIvJgrFnk,81818
+htmlgraph/models.py,sha256=vigJmC_MkKcHH362Yoauomy7fOQ0Xrn2XNASgCDEKK8,82362
 htmlgraph/orchestrator-system-prompt-optimized.txt,sha256=8UptB4-jmyz0OrjRm5VlJqBxzk3oXNJEgUQChuTWhR8,2885
 htmlgraph/orchestrator.py,sha256=6mj70vroWjmNmdvQ7jqqRSA9O1rFUNMUYDWPzqkizLk,19697
 htmlgraph/orchestrator_mode.py,sha256=F6LNZARqieQXUri3CRSq_lsqFbnVeGXJQPno1ZP47O4,9187
 htmlgraph/orchestrator_validator.py,sha256=gd_KbHsRsNEIF7EElwcxbMYqOMlyeuYIZwClASp-L-E,4699
 htmlgraph/parallel.py,sha256=BsyqGKWY_DkSRElBdvvAkWlL6stC9BPkyxjdPdggx_w,22418
-htmlgraph/parser.py,sha256=w6KHfg6Bd4E6_Z-XzhWIb-YgsaqIw8wmzn-mirPbZcI,15890
+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/routing.py,sha256=QYDY6bzYPmv6kocAXCqguB1cazN0i_xTo9EVCO3fO2Y,8803
@@ -71,7 +71,7 @@ htmlgraph/builders/phase.py,sha256=pvdG_ZiswzdRCBM1pz7hOoCS9MD-lwaOgPqVcuLXucs,3
 htmlgraph/builders/spike.py,sha256=_LXMDEJCdCjJPbNB8CA0FDlFDN-pZbdzvQDFXdrldo0,4327
 htmlgraph/builders/track.py,sha256=tdolGgYQl3PvoX6jHNCq3Vh6USrb7uN3NX555SoRHGs,23097
 htmlgraph/collections/__init__.py,sha256=qHT1UvHD-jCmNI4t1fWprWLw-5jE7NabN6kngboVRFY,1056
-htmlgraph/collections/base.py,sha256=gOEWzOqtOSphhjzvncIl0hrQTus7rGukXZgHwubxDa0,22730
+htmlgraph/collections/base.py,sha256=yK-1Kdh1wq3Ng7PkEzKX2UXlbqQl8257-9WIOfVGSmI,24721
 htmlgraph/collections/bug.py,sha256=bDbZy_sdiIn7AK0b8CXs88mUEr1ZkOGVezG0aKwh0pw,1331
 htmlgraph/collections/chore.py,sha256=PgKPjd1WkHHmZD4p4nRr8rUhC1JxfYfNWOfANxNbXqs,1352
 htmlgraph/collections/epic.py,sha256=1qJPzEHqwlfRk-4VVyKNvlZPRuGlXq68saH3tv0fZqY,1350
@@ -134,12 +134,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.2.data/data/htmlgraph/dashboard.html,sha256=rkZYjSnPbUuAm35QMpCNWemenYqQTdkkumCX2hhe8Dc,173537
-htmlgraph-0.23.2.data/data/htmlgraph/styles.css,sha256=oDUSC8jG-V-hKojOBO9J88hxAeY2wJrBYTq0uCwX_Y4,7135
-htmlgraph-0.23.2.data/data/htmlgraph/templates/AGENTS.md.template,sha256=f96h7V6ygwj-v-fanVI48eYMxR6t_se4bet1H4ZsDpI,7642
-htmlgraph-0.23.2.data/data/htmlgraph/templates/CLAUDE.md.template,sha256=h1kG2hTX2XYig2KszsHBfzrwa_4Cfcq2Pj4SwqzeDlM,1984
-htmlgraph-0.23.2.data/data/htmlgraph/templates/GEMINI.md.template,sha256=gAGzE53Avki87BM_otqy5HdcYCoLsHgqaKjVzNzPMX8,1622
-htmlgraph-0.23.2.dist-info/METADATA,sha256=sXhGvvPyc0ZtSB0FvkXu4A_gaKqs9x0uu0pS8Yb2kh8,7753
-htmlgraph-0.23.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-htmlgraph-0.23.2.dist-info/entry_points.txt,sha256=EaUbjA_bbDwEO_XDLEGMeK8aQP-ZnHiUTkLshyKDyB8,98
-htmlgraph-0.23.2.dist-info/RECORD,,
+htmlgraph-0.23.4.data/data/htmlgraph/dashboard.html,sha256=rkZYjSnPbUuAm35QMpCNWemenYqQTdkkumCX2hhe8Dc,173537
+htmlgraph-0.23.4.data/data/htmlgraph/styles.css,sha256=oDUSC8jG-V-hKojOBO9J88hxAeY2wJrBYTq0uCwX_Y4,7135
+htmlgraph-0.23.4.data/data/htmlgraph/templates/AGENTS.md.template,sha256=f96h7V6ygwj-v-fanVI48eYMxR6t_se4bet1H4ZsDpI,7642
+htmlgraph-0.23.4.data/data/htmlgraph/templates/CLAUDE.md.template,sha256=h1kG2hTX2XYig2KszsHBfzrwa_4Cfcq2Pj4SwqzeDlM,1984
+htmlgraph-0.23.4.data/data/htmlgraph/templates/GEMINI.md.template,sha256=gAGzE53Avki87BM_otqy5HdcYCoLsHgqaKjVzNzPMX8,1622
+htmlgraph-0.23.4.dist-info/METADATA,sha256=BtfEQ59TY_LKrZZ40lLuSVriuWuXgakO3z9VFHviYjQ,7827
+htmlgraph-0.23.4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+htmlgraph-0.23.4.dist-info/entry_points.txt,sha256=EaUbjA_bbDwEO_XDLEGMeK8aQP-ZnHiUTkLshyKDyB8,98
+htmlgraph-0.23.4.dist-info/RECORD,,