sessionpulse 0.1.3__tar.gz → 0.2.0__tar.gz

{sessionpulse-0.1.3/src/sessionpulse.egg-info → sessionpulse-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sessionpulse
-Version: 0.1.3
+Version: 0.2.0
 Summary: A quiet instrument panel for Claude Code: live sessions, usage, and a to-do board that fills itself from your sessions. Local only.
 Author: Vijay Shukla
 License-Expression: MIT
@@ -85,6 +85,7 @@ It reads the files Claude Code already writes under `~/.claude`. **Nothing leave
 
 - **Live sessions:** working or idle, running time, last change, tokens, model. The panel icon shows the count and turns orange while Claude is working.
 - **Follow-ups (optional):** Claude reads each session after 20 quiet minutes and adds what was left open to your to-do list, linked back to the session, with a one-click resume command. A later session that finishes an item closes it automatically.
+- **Why is this here?** Each follow-up keeps a short quote from the session, checked against the transcript; **Why?** shows it in context. The same work showing up in another project is flagged, with **Merge** and **Not the same**.
 - **Board:** every to-do as a card, colour-coded by kind (Decide, Outside work, Waiting on, Checklist, Later), or by status (To do, Doing, Done). Drag and drop, project filter, search.
 - **Your own to-dos too:** add them on the dashboard or with `sessionpulse todo add "…"`.
 - **Usage:** input, output and cache tokens per day, split by model; active hours per day; busiest projects.
@@ -187,8 +188,10 @@ Log out and back in (on X11 you can press Alt+F2 and type `r` instead), then run
 | `sessionpulse open` | Opens the dashboard in your browser, signed in (add `#board` to the address for the board) |
 | `sessionpulse doctor` | Checks the setup and warns if Claude Code's file formats look different |
 | `sessionpulse todo [add TEXT -p PROJECT \| done ID \| undo ID \| delete ID \| list-done]` | Your to-do list from the terminal |
+| `sessionpulse todo export [--format md\|csv\|json] [-p PROJECT] [--status open\|all]` | Prints the list as Markdown (grouped by project), CSV or JSON; the board's Export menu downloads the same ([fields](https://github.com/vijayshuklaHL/sessionpulse/blob/main/docs/todos-json.md)) |
 | `sessionpulse followups [--days N] [--session ID] [--now] [--again]` | Read recent sessions now and add their open follow-ups |
-| `sessionpulse dedupe [-p PROJECT] [--apply]` | Finds open to-dos that are the same work reworded; `--apply` archives the copies |
+| `sessionpulse followups status` | What follow-ups used (calls, tokens, cost), results per kind, and sessions that failed |
+| `sessionpulse dedupe [-p PROJECT] [--across] [--apply]` | Finds open to-dos that are the same work reworded (`--across`: in different projects); `--apply` archives the copies |
 | `sessionpulse snapshot` | Prints the dashboard data as JSON |
 
 ## Settings

{sessionpulse-0.1.3 → sessionpulse-0.2.0}/README.md

@@ -57,6 +57,7 @@ It reads the files Claude Code already writes under `~/.claude`. **Nothing leave
 
 - **Live sessions:** working or idle, running time, last change, tokens, model. The panel icon shows the count and turns orange while Claude is working.
 - **Follow-ups (optional):** Claude reads each session after 20 quiet minutes and adds what was left open to your to-do list, linked back to the session, with a one-click resume command. A later session that finishes an item closes it automatically.
+- **Why is this here?** Each follow-up keeps a short quote from the session, checked against the transcript; **Why?** shows it in context. The same work showing up in another project is flagged, with **Merge** and **Not the same**.
 - **Board:** every to-do as a card, colour-coded by kind (Decide, Outside work, Waiting on, Checklist, Later), or by status (To do, Doing, Done). Drag and drop, project filter, search.
 - **Your own to-dos too:** add them on the dashboard or with `sessionpulse todo add "…"`.
 - **Usage:** input, output and cache tokens per day, split by model; active hours per day; busiest projects.
@@ -159,8 +160,10 @@ Log out and back in (on X11 you can press Alt+F2 and type `r` instead), then run
 | `sessionpulse open` | Opens the dashboard in your browser, signed in (add `#board` to the address for the board) |
 | `sessionpulse doctor` | Checks the setup and warns if Claude Code's file formats look different |
 | `sessionpulse todo [add TEXT -p PROJECT \| done ID \| undo ID \| delete ID \| list-done]` | Your to-do list from the terminal |
+| `sessionpulse todo export [--format md\|csv\|json] [-p PROJECT] [--status open\|all]` | Prints the list as Markdown (grouped by project), CSV or JSON; the board's Export menu downloads the same ([fields](https://github.com/vijayshuklaHL/sessionpulse/blob/main/docs/todos-json.md)) |
 | `sessionpulse followups [--days N] [--session ID] [--now] [--again]` | Read recent sessions now and add their open follow-ups |
-| `sessionpulse dedupe [-p PROJECT] [--apply]` | Finds open to-dos that are the same work reworded; `--apply` archives the copies |
+| `sessionpulse followups status` | What follow-ups used (calls, tokens, cost), results per kind, and sessions that failed |
+| `sessionpulse dedupe [-p PROJECT] [--across] [--apply]` | Finds open to-dos that are the same work reworded (`--across`: in different projects); `--apply` archives the copies |
 | `sessionpulse snapshot` | Prints the dashboard data as JSON |
 
 ## Settings

{sessionpulse-0.1.3 → sessionpulse-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sessionpulse"
-version = "0.1.3"
+version = "0.2.0"
 description = "A quiet instrument panel for Claude Code: live sessions, usage, and a to-do board that fills itself from your sessions. Local only."
 readme = "README.md"
 license = "MIT"

{sessionpulse-0.1.3 → sessionpulse-0.2.0}/src/sessionpulse/__init__.py

@@ -1,3 +1,3 @@
 """Session Pulse: a local dashboard and panel icon for Claude Code sessions."""
 
-__version__ = "0.1.3"
+__version__ = "0.2.0"

{sessionpulse-0.1.3 → sessionpulse-0.2.0}/src/sessionpulse/cli.py

@@ -31,7 +31,11 @@ def remote_hint(cfg):
 
 
 def cmd_serve(cfg, args):
-    srv = server.make_server(cfg)
+    try:
+        srv = server.make_server(cfg)
+    except OSError as exc:
+        raise SystemExit(f"Can't serve on port {cfg.port}: {exc.strerror or exc}. Something else is using it "
+                         f"(another `sessionpulse serve`/`tray`?); stop that, or set `port` in {config.CONFIG_FILE}.")
     followups.start_worker(cfg)
     print(f"Session Pulse on {cfg.url}\n" + (remote_hint(cfg) if headless() else "Open it with: sessionpulse open"),
           flush=True)
@@ -144,16 +148,34 @@ def cmd_doctor(cfg, args):
         fresh = a < status.INTERVAL * 3
         print(f"  {'ok ' if fresh else '-- '}  status.json {'updated' if fresh else 'stale, last updated'} "
               f"{int(a)}s ago{'' if fresh else ': is `sessionpulse daemon` running?'}")
+    bad = followups.failing(cfg)
+    if bad:
+        sid, e = bad[0]
+        print(f"  --   {len(bad)} session(s) failed when read for follow-ups; the latest error: "
+              f"{e.get('last_error')}. See `sessionpulse followups status`.")
+    week = followups.usage_totals(cfg, 7)
+    if week["calls"]:
+        print(f"  ok   follow-ups used {week['calls']} model calls, {tokens(week['tokens'])} tokens in the last 7 days")
     for w in h["warnings"]:
         line(False, w)
     return 0 if ok else 1
 
 
+def tokens(n):
+    return f"{n / 1e6:.1f}M" if n >= 1e6 else f"{n / 1e3:.0f}k" if n >= 1e3 else str(n)
+
+
 def cmd_snapshot(cfg, args):
     json.dump(reader.snapshot(cfg), sys.stdout, indent=1)
 
 
 def cmd_todo(cfg, args):
+    if args.action == "export":
+        try:
+            sys.stdout.write(todos.export(todos.load(cfg), args.format, args.project, args.status))
+        except ValueError as exc:
+            sys.exit(f"error: {exc}")
+        return
     try:
         if args.action == "add":
             todos.apply(cfg, {"op": "add", "text": " ".join(args.text), "project": args.project})
@@ -177,7 +199,42 @@ def cmd_todo(cfg, args):
         print("Nothing here." if args.action == "list-done" else "No open to-dos.")
 
 
+def followups_status(cfg):
+    print(f"Follow-ups are {'on' if cfg.followups else 'off (add `followups = true` to config.toml)'}; "
+          f"model {cfg.followups_model}.")
+    st = followups.load_state(cfg)
+    read = [e for e in st.values() if isinstance(e, dict) and e.get("at")]
+    print(f"Sessions read: {len(read)}, adding {sum(e.get('added') or 0 for e in read)} "
+          f"and closing {sum(e.get('closed') or 0 for e in read)} to-dos.")
+    print("Model use (the cost is what the API would charge; on a subscription it counts toward your limits):")
+    for label, days in (("today", 1), ("7 days", 7), ("30 days", 30)):
+        u = followups.usage_totals(cfg, days)
+        print(f"  {label:8} {u['calls']:4} calls  {tokens(u['tokens']):>6} tokens "
+              f"({tokens(u['output_tokens'])} written)  ${u['cost_usd']:.2f}")
+    kinds = todos.kind_stats(cfg)
+    if kinds:
+        print("By kind (dismissed items count as added; \"noise\" = dismissed as not useful):")
+        print(f"  {'':10} {'added':>6} {'open':>6} {'done':>6} {'parked':>6} {'noise':>6} {'other':>6}")
+        for k in (*todos.KINDS, "unknown"):
+            if k in kinds:
+                r = kinds[k]
+                print(f"  {k:10} " + " ".join(f"{r[c]:>6}" for c in ("added", "open", "done", "parked",
+                                                                       "not_useful", "dismissed")))
+    bad = followups.failing(cfg)
+    if not bad:
+        print("No session is failing.")
+        return
+    print(f"{len(bad)} session(s) failed when last read:")
+    for sid, e in bad:
+        when = f"next try after {e['next_try'][:16].replace('T', ' ')}" if e.get("next_try") else \
+            "waiting until the session grows"
+        print(f"  {sid[:8]}  {e.get('project') or '?'}: {e['fails']}x, {when}\n            {e.get('last_error')}")
+    print("Retry one now with `sessionpulse followups --session <id>`.")
+
+
 def cmd_followups(cfg, args):
+    if args.action == "status":
+        return followups_status(cfg)
     if not followups.claude_bin(cfg):
         sys.exit("error: the `claude` command was not found; set claude_command in config.toml")
     try:
@@ -194,6 +251,8 @@ def cmd_followups(cfg, args):
 def cmd_dedupe(cfg, args):
     if not followups.claude_bin(cfg):
         sys.exit("error: the `claude` command was not found; set claude_command in config.toml")
+    if args.across:
+        return dedupe_across(cfg, args)
     items = todos.load(cfg)
     counts = Counter(i.get("project") or "" for i in items if todos.is_open(i))
     projects = [args.project] if args.project is not None else [p for p, n in counts.items() if n > 1]
@@ -223,6 +282,30 @@ def cmd_dedupe(cfg, args):
         print(f"\n{total} duplicate(s) found. Run again with --apply to archive them, keeping the newest.")
 
 
+def dedupe_across(cfg, args):
+    pairs = followups.pairs_across(cfg)
+    print(f"{len(pairs)} pair(s) across projects look alike; asking Claude which are the same work…", flush=True)
+    if not pairs:
+        return
+    try:
+        groups = followups.find_duplicates_across(cfg, pairs)
+    except (RuntimeError, OSError, ValueError, subprocess.TimeoutExpired) as exc:
+        sys.exit(f"error: {exc}")
+    by_id = {i["id"]: i for i in todos.load(cfg)}
+    for g in groups:
+        print("\n  same:")
+        for x in g:
+            i = by_id.get(x, {})
+            print(f"    {x}  {i.get('text', '')}  ({i.get('project') or 'no project'})")
+    if args.apply:
+        n = todos.merge_duplicates(cfg, groups, link=True)
+        print(f"\nArchived {n} duplicate(s), keeping the newest (or the one in progress). Their projects now count "
+              "as related, so follow-ups in one can close work listed in the other.")
+    else:
+        print(f"\n{sum(len(g) - 1 for g in groups)} duplicate(s) found. Run again with --apply to archive them, "
+              "keeping the newest, and link their projects.")
+
+
 def main(argv=None):
     p = argparse.ArgumentParser(prog="sessionpulse", description=__doc__)
     p.add_argument("--version", action="version", version=f"sessionpulse {__version__}")
@@ -238,12 +321,17 @@ def main(argv=None):
     sub.add_parser("open", help="open the dashboard in your browser")
     sub.add_parser("doctor", help="check the setup and data formats")
     sub.add_parser("snapshot", help="print the dashboard data as JSON")
-    t = sub.add_parser("todo", help="your to-do list: add, done, undo, delete, list, list-done")
+    t = sub.add_parser("todo", help="your to-do list: add, done, undo, delete, list, list-done, export")
     t.add_argument("action", nargs="?", default="list",
-                   choices=["list", "list-done", "add", "done", "undo", "delete"])
+                   choices=["list", "list-done", "add", "done", "undo", "delete", "export"])
     t.add_argument("text", nargs="*", help="the to-do text (add) or item ids (done/undo/delete)")
-    t.add_argument("-p", "--project", help="tag the new to-do with a project")
+    t.add_argument("-p", "--project", help="tag the new to-do with a project (export: only this project)")
+    t.add_argument("--format", choices=todos.FORMATS, default="md", help="export: md (default), csv or json")
+    t.add_argument("--status", choices=["open", "all"], default="open",
+                   help="export: open to-dos (default) or all, including done, on hold and archived")
     f = sub.add_parser("followups", help="pick open follow-ups out of recent sessions with Claude")
+    f.add_argument("action", nargs="?", default="run", choices=["run", "status"],
+                   help="run (default), or status: model use and sessions that failed")
     f.add_argument("--days", type=int, help="look back this many days (default: followups_days)")
     f.add_argument("--session", help="only this session id (or its first characters)")
     f.add_argument("--now", action="store_true", help="include sessions that are still active")
@@ -251,6 +339,8 @@ def main(argv=None):
     d = sub.add_parser("dedupe", help="find open to-dos that are the same work reworded, with Claude")
     d.add_argument("-p", "--project", help="only this project (default: every project)")
     d.add_argument("--apply", action="store_true", help="archive the copies (default: only list them)")
+    d.add_argument("--across", action="store_true",
+                   help="look for the same work listed in different projects (one model call per 40 likely pairs)")
     sub.add_parser("hook", help=argparse.SUPPRESS)
     args = p.parse_args(argv)
     cfg = config.load()