htmlgraph 0.26.3__tar.gz → 0.26.5__tar.gz

{htmlgraph-0.26.3 → htmlgraph-0.26.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: htmlgraph
-Version: 0.26.3
+Version: 0.26.5
 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

{htmlgraph-0.26.3 → htmlgraph-0.26.5}/packages/gemini-extension/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "htmlgraph",
-  "version": "0.26.3",
+  "version": "0.26.5",
   "description": "HtmlGraph session tracking and documentation for Gemini CLI. Ensures proper activity attribution, feature awareness, and continuous work tracking.",
   "author": "Shakes",
   "license": "MIT",

{htmlgraph-0.26.3 → htmlgraph-0.26.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "htmlgraph"
-version = "0.26.3"
+version = "0.26.5"
 description = "HTML is All You Need - Graph database on web standards"
 authors = [{name = "Shakes", email = "shakestzd@gmail.com"}]
 readme = "README.md"

{htmlgraph-0.26.3 → htmlgraph-0.26.5}/src/python/htmlgraph/__init__.py

@@ -95,7 +95,7 @@ from htmlgraph.types import (
 )
 from htmlgraph.work_type_utils import infer_work_type, infer_work_type_from_id
 
-__version__ = "0.26.3"
+__version__ = "0.26.5"
 __all__ = [
     # Exceptions
     "HtmlGraphError",

{htmlgraph-0.26.3 → htmlgraph-0.26.5}/src/python/htmlgraph/cli.py

@@ -4977,6 +4977,58 @@ def cmd_claude(args: argparse.Namespace) -> None:
             if orchestration_rules:
                 combined_prompt = f"{system_prompt}\n\n---\n\n{orchestration_rules}"
 
+            # Add dev mode specific guidance
+            dev_addendum = textwrap.dedent(
+                """
+
+                ═══════════════════════════════════════════════════════════
+                🔧 DEVELOPMENT MODE - HtmlGraph Project
+                ═══════════════════════════════════════════════════════════
+
+                CRITICAL: Hooks load htmlgraph from PyPI, NOT local source!
+
+                Development Workflow:
+                1. Make changes to src/python/htmlgraph/
+                2. Run tests: uv run pytest
+                3. Deploy to PyPI: ./scripts/deploy-all.sh X.Y.Z --no-confirm
+                4. Restart Claude Code (hooks auto-load new version from PyPI)
+                5. Verify changes work correctly
+
+                Why PyPI in Dev Mode?
+                - Hooks use: #!/usr/bin/env -S uv run --with htmlgraph
+                - Always pulls latest version from PyPI
+                - Tests in production-like environment
+                - No surprises when distributed to users
+                - Single source of truth (PyPI package)
+
+                Incremental Versioning:
+                - Use patch versions: 0.26.2 → 0.26.3 → 0.26.4
+                - No need to edit hook shebangs (always get latest)
+                - Deploy frequently for rapid iteration
+
+                Session ID Tracking (v0.26.3+):
+                - PostToolUse hooks query for most recent UserQuery session
+                - All events should share same session_id
+                - Verify: See "Development Mode" section in CLAUDE.md
+
+                Key References:
+                - Development workflow: CLAUDE.md "Development Mode" section
+                - Orchestrator patterns: /orchestrator-directives skill
+                - Code quality: /code-quality skill
+                - Deployment: /deployment-automation skill
+
+                Remember: You're dogfooding HtmlGraph!
+                - Use SDK to track your own work
+                - Delegate to spawner agents (Gemini, Codex, Copilot)
+                - Follow orchestration patterns
+                - Test in production-like environment
+
+                ═══════════════════════════════════════════════════════════
+                """
+            )
+
+            combined_prompt = f"{combined_prompt}\n{dev_addendum}"
+
             if args.quiet or args.format == "json":
                 cmd = [
                     "claude",

{htmlgraph-0.26.3 → htmlgraph-0.26.5}/src/python/htmlgraph/hooks/event_tracker.py

@@ -755,18 +755,40 @@ def track_event(hook_type: str, hook_input: dict[str, Any]) -> dict[str, Any]:
         # Override detected agent for subagent context
         detected_agent = f"{subagent_type}-spawner"
     else:
-        # Normal orchestrator/parent context - use global session cache
-        active_session = manager.get_active_session()
-        if not active_session:
-            # No active HtmlGraph session yet; start one (stable internal id).
-            try:
-                active_session = manager.start_session(
-                    session_id=None,
-                    agent=detected_agent,
-                    title=f"Session {datetime.now().strftime('%Y-%m-%d %H:%M')}",
-                )
-            except Exception:
-                return {"continue": True}
+        # Normal orchestrator/parent context
+        # CRITICAL: Use session_id from hook_input (Claude Code provides this)
+        # Only fall back to manager.get_active_session() if not in hook_input
+        hook_session_id = hook_input.get("session_id") or hook_input.get("sessionId")
+
+        if hook_session_id:
+            # Claude Code provided session_id - use it directly
+            # Check if session already exists
+            existing = manager.session_converter.load(hook_session_id)
+            if existing:
+                active_session = existing
+            else:
+                # Create new session with Claude's session_id
+                try:
+                    active_session = manager.start_session(
+                        session_id=hook_session_id,
+                        agent=detected_agent,
+                        title=f"Session {datetime.now().strftime('%Y-%m-%d %H:%M')}",
+                    )
+                except Exception:
+                    return {"continue": True}
+        else:
+            # Fallback: No session_id in hook_input - use global session cache
+            active_session = manager.get_active_session()
+            if not active_session:
+                # No active HtmlGraph session yet; start one
+                try:
+                    active_session = manager.start_session(
+                        session_id=None,
+                        agent=detected_agent,
+                        title=f"Session {datetime.now().strftime('%Y-%m-%d %H:%M')}",
+                    )
+                except Exception:
+                    return {"continue": True}
 
     active_session_id = active_session.id