inscript 0.3.0__tar.gz → 0.4.0__tar.gz

{inscript-0.3.0 → inscript-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: inscript
-Version: 0.3.0
+Version: 0.4.0
 Summary: Universal agent activity ledger. Records what AI agents do.
 Author: Andrew Park
 License-Expression: MIT

{inscript-0.3.0 → inscript-0.4.0}/inscript.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: inscript
-Version: 0.3.0
+Version: 0.4.0
 Summary: Universal agent activity ledger. Records what AI agents do.
 Author: Andrew Park
 License-Expression: MIT

{inscript-0.3.0 → inscript-0.4.0}/inscript_pkg/__init__.py

@@ -17,7 +17,7 @@ import time
 from datetime import datetime, timezone
 from pathlib import Path
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"
 
 INSCRIPT_DIR = Path.home() / ".inscript"
 ACTIVE_PROJECT_FILE = INSCRIPT_DIR / "active_project"
@@ -133,6 +133,9 @@ def cli() -> None:
         "cleanup": _cmd_cleanup,
         "export": lambda: _cmd_export(args[1]) if len(args) > 1 else print("Usage: inscript export <session-id>", file=sys.stderr),
         "set": lambda: (set_active_project(args[1]), print(f"Active project: {Path(args[1]).resolve()}")) if len(args) > 1 else print("Usage: inscript set <path>", file=sys.stderr),
+        "tag": lambda: _cmd_tag(args[1] if len(args) > 1 else None),
+        "untag": lambda: _cmd_tag(None),
+        "time": lambda: _cmd_time(args[1] if len(args) > 1 else None),
         "help": _cmd_help, "--help": _cmd_help, "-h": _cmd_help,
     }
 
@@ -155,7 +158,10 @@ Commands:
   inscript overlap      File collisions across concurrent sessions
   inscript cleanup      Enforce retention policy
   inscript export <id>  Export session as markdown
-  inscript set <path>   Manually set active project""")
+  inscript set <path>   Manually set active project
+  inscript tag <name>   Tag current work with a feature/task name
+  inscript untag        Clear the current tag
+  inscript time [tag]   Show time spent, optionally filtered by tag""")
 
 
 def _cmd_init():
@@ -276,6 +282,186 @@ def _cmd_log(session_id: str | None):
     print(f"  {len(files_seen)} files, {edits} edits, {len(prompts)} prompts")
 
 
+def _cmd_tag(tag_name: str | None):
+    """Set or clear the active tag for the current session."""
+    sess = active_session()
+    if not sess:
+        print("No active session", file=__import__("sys").stderr)
+        __import__("sys").exit(1)
+
+    sdir = session_dir(sess)
+    tag_file = sdir / "active_tag"
+
+    if tag_name is None:
+        # Clear tag
+        try:
+            tag_file.unlink()
+        except OSError:
+            pass
+        print("Tag cleared")
+    else:
+        tag_file.write_text(tag_name + "\n")
+        print(f"Tagged: {tag_name}")
+
+
+def _format_duration(seconds: int) -> str:
+    """Format seconds into human-readable duration."""
+    if seconds < 60:
+        return f"{seconds}s"
+    elif seconds < 3600:
+        m, s = divmod(seconds, 60)
+        return f"{m}m {s}s"
+    else:
+        h, remainder = divmod(seconds, 3600)
+        m, s = divmod(remainder, 60)
+        return f"{h}h {m}m"
+
+
+def _cmd_time(tag_filter: str | None):
+    """Show time spent, optionally filtered by tag."""
+    all_sessions = list_sessions()
+    if not all_sessions:
+        print("No sessions found")
+        return
+
+    # Collect timing data from prompts across all sessions
+    tag_data: dict[str | None, dict] = {}  # tag -> {sessions, prompts, first_ts, last_ts, active_seconds, files, edits}
+
+    for s in all_sessions:
+        sid = s["session_id"]
+        sdir = session_dir(sid)
+        prompts = _load_prompts(sdir)
+        touches_file = sdir / "touches.jsonl"
+
+        # Load touches
+        touches: list[dict] = []
+        if touches_file.exists():
+            for line in touches_file.open():
+                try:
+                    touches.append(json.loads(line))
+                except json.JSONDecodeError:
+                    pass
+
+        if not prompts:
+            continue
+
+        # Compute time per prompt block
+        for i, p in enumerate(prompts):
+            tag = p.get("tag")
+            if tag_filter and tag != tag_filter:
+                continue
+
+            # Parse this prompt's timestamp
+            prompt_ts = p.get("ts", "")
+
+            # Find next prompt's timestamp (or session end) for duration
+            if i + 1 < len(prompts):
+                next_ts = prompts[i + 1].get("ts", "")
+            else:
+                # Use last touch timestamp or summary end_time
+                summary_file = sdir / "summary.json"
+                if summary_file.exists():
+                    try:
+                        summary = json.loads(summary_file.read_text())
+                        end = summary.get("end_time", "")
+                        next_ts = end.split("T")[-1] if "T" in end else ""
+                    except (json.JSONDecodeError, OSError):
+                        next_ts = ""
+                else:
+                    # Use last touch
+                    block_touches = [t for t in touches if t.get("prompt_idx") == p.get("idx")]
+                    next_ts = block_touches[-1].get("ts", "") if block_touches else ""
+
+            # Compute duration for this prompt block
+            block_seconds = _ts_diff(prompt_ts, next_ts)
+
+            # Count files and edits for this block
+            block_touches = [t for t in touches if t.get("prompt_idx") == p.get("idx")]
+            block_files = {t.get("file") for t in block_touches}
+            block_edits = sum(1 for t in block_touches if t.get("action") in ("edit", "write"))
+
+            # Aggregate by tag
+            if tag not in tag_data:
+                tag_data[tag] = {
+                    "sessions": set(),
+                    "prompts": 0,
+                    "active_seconds": 0,
+                    "first_ts": s.get("start_time", ""),
+                    "last_ts": s.get("start_time", ""),
+                    "files": set(),
+                    "edits": 0,
+                    "prompt_texts": [],
+                }
+
+            td = tag_data[tag]
+            td["sessions"].add(sid)
+            td["prompts"] += 1
+            td["active_seconds"] += block_seconds
+            td["files"].update(block_files)
+            td["edits"] += block_edits
+            td["prompt_texts"].append(p.get("prompt", ""))
+            # Track first/last
+            session_time = s.get("start_time", "")
+            if session_time < td["first_ts"] or not td["first_ts"]:
+                td["first_ts"] = session_time
+            if session_time > td["last_ts"]:
+                td["last_ts"] = session_time
+
+    if not tag_data:
+        if tag_filter:
+            print(f"No data for tag: {tag_filter}")
+        else:
+            print("No prompt data found")
+        return
+
+    # Display
+    if tag_filter:
+        # Single tag detail view
+        td = tag_data.get(tag_filter)
+        if not td:
+            print(f"No data for tag: {tag_filter}")
+            return
+        print(f"Feature: {tag_filter}\n")
+        print(f"  Sessions:     {len(td['sessions'])}")
+        print(f"  Prompts:      {td['prompts']}")
+        print(f"  Active time:  {_format_duration(td['active_seconds'])}")
+        print(f"  Files:        {len(td['files'])}")
+        print(f"  Edits:        {td['edits']}")
+        print(f"  First:        {td['first_ts']}")
+        print(f"  Last:         {td['last_ts']}")
+        print(f"\n  Prompts:")
+        for pt in td["prompt_texts"]:
+            display = pt[:70] + "..." if len(pt) > 70 else pt
+            print(f"    - \"{display}\"")
+    else:
+        # Overview of all tags
+        print("Time by tag:\n")
+        # Sort: tagged first (alphabetical), then untagged
+        sorted_tags = sorted(
+            tag_data.keys(),
+            key=lambda t: (t is None, t or "")
+        )
+        for tag in sorted_tags:
+            td = tag_data[tag]
+            label = tag or "(untagged)"
+            print(f"  {label}")
+            print(f"    {_format_duration(td['active_seconds'])} active, {td['prompts']} prompts, {td['edits']} edits, {len(td['sessions'])} sessions")
+            print()
+
+
+def _ts_diff(ts1: str, ts2: str) -> int:
+    """Compute seconds between two HH:MM:SS timestamps. Returns 0 on failure."""
+    try:
+        parts1 = [int(x) for x in ts1.split(":")]
+        parts2 = [int(x) for x in ts2.split(":")]
+        s1 = parts1[0] * 3600 + parts1[1] * 60 + parts1[2]
+        s2 = parts2[0] * 3600 + parts2[1] * 60 + parts2[2]
+        diff = s2 - s1
+        return max(0, diff)  # Clamp negative (midnight crossing edge case)
+    except (ValueError, IndexError):
+        return 0
+
+
 def _cmd_overlap():
     if not OVERLAP_DIR.exists():
         print("No overlap data")

{inscript-0.3.0 → inscript-0.4.0}/inscript_pkg/hook.py

@@ -105,6 +105,15 @@ def _current_prompt_idx(sdir: Path) -> int | None:
     return n - 1 if n > 0 else None
 
 
+def _current_tag(sdir: Path) -> str | None:
+    """Read the active tag for this session."""
+    tag_file = sdir / "active_tag"
+    try:
+        return tag_file.read_text().strip() or None
+    except OSError:
+        return None
+
+
 # ---------------------------------------------------------------------------
 # SessionStart handler
 # ---------------------------------------------------------------------------
@@ -158,12 +167,17 @@ def handle_prompt_submit(data: dict) -> None:
         return
 
     prompt_idx = _count_lines(sdir / "prompts.jsonl")
+    tag = _current_tag(sdir)
 
-    _append_jsonl(sdir / "prompts.jsonl", {
+    entry = {
         "idx": prompt_idx,
         "ts": _now_time(),
         "prompt": prompt,
-    })
+    }
+    if tag:
+        entry["tag"] = tag
+
+    _append_jsonl(sdir / "prompts.jsonl", entry)
 
 
 # ---------------------------------------------------------------------------
@@ -222,6 +236,7 @@ def handle_post_tool_use(data: dict) -> None:
     # Append to touches.jsonl
     action = _tool_action(tool_name)
     prompt_idx = _current_prompt_idx(sdir)
+    tag = _current_tag(sdir)
     touch = {
         "ts": _now_time(),
         "file": display_path,
@@ -230,6 +245,8 @@ def handle_post_tool_use(data: dict) -> None:
     }
     if prompt_idx is not None:
         touch["prompt_idx"] = prompt_idx
+    if tag:
+        touch["tag"] = tag
 
     # Add lines_changed for Edit
     if tool_name == "Edit" and tool_input.get("new_string") is not None:

{inscript-0.3.0 → inscript-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "inscript"
-version = "0.3.0"
+version = "0.4.0"
 description = "Universal agent activity ledger. Records what AI agents do."
 readme = "README.md"
 license = "MIT"