htmlgraph 0.20.3__tar.gz → 0.20.4__tar.gz

{htmlgraph-0.20.3 → htmlgraph-0.20.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: htmlgraph
-Version: 0.20.3
+Version: 0.20.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

{htmlgraph-0.20.3 → htmlgraph-0.20.4}/packages/gemini-extension/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "htmlgraph",
-  "version": "0.20.3",
+  "version": "0.20.4",
   "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.20.3 → htmlgraph-0.20.4}/pyproject.toml

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

{htmlgraph-0.20.3 → htmlgraph-0.20.4}/src/python/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.20.3"
+__version__ = "0.20.4"
 __all__ = [
     # Exceptions
     "HtmlGraphError",

{htmlgraph-0.20.3 → htmlgraph-0.20.4}/src/python/htmlgraph/cli.py

@@ -3241,6 +3241,64 @@ def cmd_track_plan(args: argparse.Namespace) -> None:
         print(f"\nView plan: open {args.graph_dir}/tracks/{args.track_id}/plan.html")
 
 
+def cmd_track_show(args: argparse.Namespace) -> None:
+    """Show details of a track."""
+    import json
+    from pathlib import Path
+
+    from htmlgraph.track_manager import TrackManager
+
+    manager = TrackManager(args.graph_dir)
+
+    # Load the track
+    track = manager.load_track(args.track_id)
+    if not track:
+        print(f"Error: Track '{args.track_id}' not found", file=sys.stderr)
+        sys.exit(1)
+
+    if args.format == "json":
+        data = {
+            "id": track.id,
+            "title": track.title,
+            "description": track.description,
+            "status": track.status,
+            "priority": track.priority,
+            "has_spec": track.has_spec,
+            "has_plan": track.has_plan,
+            "created": track.created.isoformat(),
+            "updated": track.updated.isoformat(),
+            "features": track.features,
+            "sessions": track.sessions,
+        }
+        print(json.dumps(data, indent=2))
+    else:
+        # Determine if consolidated or directory-based
+        is_consolidated = manager.is_consolidated(args.track_id)
+        if is_consolidated:
+            track_file = Path(args.graph_dir) / "tracks" / f"{args.track_id}.html"
+            file_type = "single file (consolidated)"
+        else:
+            track_file = Path(args.graph_dir) / "tracks" / args.track_id / "index.html"
+            file_type = "directory-based"
+
+        print(f"Track: {track.id}")
+        print(f"  Title: {track.title}")
+        print(f"  Description: {track.description}")
+        print(f"  Status: {track.status}")
+        print(f"  Priority: {track.priority}")
+        print(f"  Format: {file_type}")
+        print(f"  Has Spec: {'Yes' if track.has_spec else 'No'}")
+        print(f"  Has Plan: {'Yes' if track.has_plan else 'No'}")
+        print(f"  Created: {track.created.strftime('%Y-%m-%d %H:%M')}")
+        print(f"  Updated: {track.updated.strftime('%Y-%m-%d %H:%M')}")
+        if track.features:
+            print(f"  Features: {', '.join(track.features)}")
+        if track.sessions:
+            print(f"  Sessions: {', '.join(track.sessions)}")
+        print(f"\nPath: {track_file}")
+        print(f"View: open {track_file}")
+
+
 def cmd_track_delete(args: argparse.Namespace) -> None:
     """Delete a track."""
     import json
@@ -4248,6 +4306,16 @@ For more help: https://github.com/Shakes-tzd/htmlgraph
         "--format", "-f", choices=["text", "json"], default="text", help="Output format"
     )
 
+    # track show
+    track_show = track_subparsers.add_parser("show", help="Show track details")
+    track_show.add_argument("track_id", help="Track ID to display")
+    track_show.add_argument(
+        "--graph-dir", "-g", default=".htmlgraph", help="Graph directory"
+    )
+    track_show.add_argument(
+        "--format", "-f", choices=["text", "json"], default="text", help="Output format"
+    )
+
     # track delete
     track_delete = track_subparsers.add_parser("delete", help="Delete a track")
     track_delete.add_argument("track_id", help="Track ID to delete")
@@ -4625,6 +4693,8 @@ For more help: https://github.com/Shakes-tzd/htmlgraph
             cmd_track_spec(args)
         elif args.track_command == "plan":
             cmd_track_plan(args)
+        elif args.track_command == "show":
+            cmd_track_show(args)
         elif args.track_command == "delete":
             cmd_track_delete(args)
         else:
@@ -4671,7 +4741,7 @@ For more help: https://github.com/Shakes-tzd/htmlgraph
             feature_parser.print_help()
             sys.exit(1)
     elif args.command == "analytics":
-        from htmlgraph.cli_analytics import cmd_analytics
+        from htmlgraph.analytics.cli import cmd_analytics
 
         cmd_analytics(args)
     elif args.command == "events":

{htmlgraph-0.20.3 → htmlgraph-0.20.4}/src/python/htmlgraph/track_manager.py

@@ -338,6 +338,44 @@ class TrackManager:
             track_id=track_id,
         )
 
+    def load_track(self, track_id: str) -> Track | None:
+        """
+        Load a track from disk.
+
+        Supports both consolidated (single .html file) and directory-based tracks.
+
+        Args:
+            track_id: Track ID
+
+        Returns:
+            Track instance or None if not found
+        """
+        track_path = self.get_track_path(track_id)
+        if track_path is None:
+            return None
+
+        # For now, return a basic Track instance
+        # TODO: Parse HTML back to Track using justhtml
+        if track_path.is_file():
+            # Consolidated format - single file
+            return Track(
+                id=track_id,
+                title=f"Track {track_id}",
+                description="Loaded from consolidated format",
+            )
+        else:
+            # Directory format - check for spec and plan
+            spec_exists = (track_path / "spec.html").exists()
+            plan_exists = (track_path / "plan.html").exists()
+
+            return Track(
+                id=track_id,
+                title=f"Track {track_id}",
+                description="Loaded from directory format",
+                has_spec=spec_exists,
+                has_plan=plan_exists,
+            )
+
     def list_tracks(self) -> list[str]:
         """
         List all track IDs.