sessionpulse 0.1.2__tar.gz → 0.1.3__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sessionpulse
-Version: 0.1.2
+Version: 0.1.3
 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
@@ -154,6 +154,27 @@ sessionpulse followups    # read the last 30 days now instead of waiting
 
 Check everything with `sessionpulse doctor`. Remove it with `sessionpulse uninstall` (your data stays) and `pipx uninstall sessionpulse`.
 
+## GNOME extension
+
+A native top-bar indicator for GNOME Shell 45 to 48, as an alternative to the AppIndicator panel icon. It shows the same thing: the number of open sessions, orange while one is working, plus a menu with each session, today's totals, and links to the dashboard and the to-do board.
+
+The extension only reads `~/.local/share/sessionpulse/status.json` ([format](https://github.com/vijayshuklaHL/sessionpulse/blob/main/docs/status-json.md)), which `sessionpulse daemon` writes, so the app has to be installed too:
+
+```sh
+pipx install sessionpulse
+sessionpulse install --daemon   # hooks, plus the daemon (no icon) at login
+sessionpulse daemon &           # start it now
+```
+
+Then install the extension. It isn't on extensions.gnome.org yet, so install it from a clone of this repo:
+
+```sh
+gnome-extension/pack.sh
+gnome-extensions install --force gnome-extension/dist/sessionpulse@vijayshuklaHL.github.io.shell-extension.zip
+```
+
+Log out and back in (on X11 you can press Alt+F2 and type `r` instead), then run `gnome-extensions enable sessionpulse@vijayshuklaHL.github.io`. If you used the panel icon before, stop it: run `sessionpulse install --daemon` again so login starts the daemon instead of the tray.
+
 ## Commands
 
 | Command | What it does |
@@ -162,10 +183,12 @@ Check everything with `sessionpulse doctor`. Remove it with `sessionpulse uninst
 | `sessionpulse uninstall` | Removes exactly those hooks and the autostart entry. Your data stays. |
 | `sessionpulse tray` | Panel icon and dashboard server |
 | `sessionpulse serve` | Dashboard server only |
+| `sessionpulse daemon` | Dashboard server plus `status.json` for panel widgets such as the GNOME extension, no icon (`install --daemon` starts it at login) |
 | `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 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 snapshot` | Prints the dashboard data as JSON |
 
 ## Settings

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

@@ -126,6 +126,27 @@ sessionpulse followups    # read the last 30 days now instead of waiting
 
 Check everything with `sessionpulse doctor`. Remove it with `sessionpulse uninstall` (your data stays) and `pipx uninstall sessionpulse`.
 
+## GNOME extension
+
+A native top-bar indicator for GNOME Shell 45 to 48, as an alternative to the AppIndicator panel icon. It shows the same thing: the number of open sessions, orange while one is working, plus a menu with each session, today's totals, and links to the dashboard and the to-do board.
+
+The extension only reads `~/.local/share/sessionpulse/status.json` ([format](https://github.com/vijayshuklaHL/sessionpulse/blob/main/docs/status-json.md)), which `sessionpulse daemon` writes, so the app has to be installed too:
+
+```sh
+pipx install sessionpulse
+sessionpulse install --daemon   # hooks, plus the daemon (no icon) at login
+sessionpulse daemon &           # start it now
+```
+
+Then install the extension. It isn't on extensions.gnome.org yet, so install it from a clone of this repo:
+
+```sh
+gnome-extension/pack.sh
+gnome-extensions install --force gnome-extension/dist/sessionpulse@vijayshuklaHL.github.io.shell-extension.zip
+```
+
+Log out and back in (on X11 you can press Alt+F2 and type `r` instead), then run `gnome-extensions enable sessionpulse@vijayshuklaHL.github.io`. If you used the panel icon before, stop it: run `sessionpulse install --daemon` again so login starts the daemon instead of the tray.
+
 ## Commands
 
 | Command | What it does |
@@ -134,10 +155,12 @@ Check everything with `sessionpulse doctor`. Remove it with `sessionpulse uninst
 | `sessionpulse uninstall` | Removes exactly those hooks and the autostart entry. Your data stays. |
 | `sessionpulse tray` | Panel icon and dashboard server |
 | `sessionpulse serve` | Dashboard server only |
+| `sessionpulse daemon` | Dashboard server plus `status.json` for panel widgets such as the GNOME extension, no icon (`install --daemon` starts it at login) |
 | `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 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 snapshot` | Prints the dashboard data as JSON |
 
 ## Settings

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sessionpulse"
-version = "0.1.2"
+version = "0.1.3"
 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.2 → sessionpulse-0.1.3}/src/sessionpulse/__init__.py

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

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

@@ -3,11 +3,15 @@ import argparse
 import getpass
 import json
 import os
+import signal
 import socket
+import subprocess
 import sys
+import threading
 import webbrowser
+from collections import Counter
 
-from . import __version__, config, followups, hook, install, reader, server, todos, tray
+from . import __version__, config, followups, hook, install, reader, server, status, todos, tray
 
 
 def headless():
@@ -37,6 +41,24 @@ def cmd_serve(cfg, args):
         pass
 
 
+def cmd_daemon(cfg, args):
+    """Dashboard server + follow-ups + status.json, no icon: for the GNOME extension."""
+    try:
+        srv = server.make_server(cfg)
+        threading.Thread(target=srv.serve_forever, daemon=True).start()
+        followups.start_worker(cfg)
+        print(f"Session Pulse on {cfg.url}", flush=True)
+    except OSError:
+        print(f"Port {cfg.port} is already in use (another `sessionpulse serve`/`tray`?); "
+              "writing status.json only.", flush=True)
+    print(f"Writing {status.path(cfg)} every {status.INTERVAL}s", flush=True)
+    stop = threading.Event()
+    for sig in (signal.SIGTERM, signal.SIGINT, signal.SIGHUP):
+        signal.signal(sig, lambda *_: stop.set())
+    status.run(cfg, stop, on_error=lambda exc: print(f"status.json not written: {exc}",
+                                                    file=sys.stderr, flush=True))
+
+
 def cmd_tray(cfg, args):
     tray.run(cfg)
 
@@ -62,6 +84,10 @@ def cmd_install(cfg, args):
           f" SessionStart/SessionEnd hooks in {cfg.claude / 'settings.json'}")
     if args.no_autostart:
         return
+    if args.daemon:
+        print(f"Background daemon will start at login ({install.enable_autostart('daemon')}).")
+        print("Start it now with: sessionpulse daemon &")
+        return
     missing = tray.available()
     if missing:
         print(f"Skipped login autostart: {missing}\nYou can still run: sessionpulse serve")
@@ -113,6 +139,11 @@ def cmd_doctor(cfg, args):
         busy = s.connect_ex(("127.0.0.1", cfg.port)) == 0
     print(f"  {'ok ' if busy else '-- '}  dashboard {'running' if busy else 'not running'} on {cfg.url}"
           + ("" if busy else ": start it with `sessionpulse serve`"))
+    a = status.age(cfg)
+    if a is not None:
+        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?'}")
     for w in h["warnings"]:
         line(False, w)
     return 0 if ok else 1
@@ -132,11 +163,16 @@ def cmd_todo(cfg, args):
     except ValueError as exc:
         sys.exit(f"error: {exc}")
     items = todos.load(cfg)
-    show = [i for i in items if bool(i["done_at"]) == (args.action == "list-done")]
+    want = (lambda i: i["done_at"]) if args.action == "list-done" else todos.is_open
+    show = [i for i in items if want(i)]
     for i in show:
         tag = f"  [{i['project']}]" if i.get("project") else ""
         when = f"  done {i['done_at'][:10]}" if i["done_at"] else ""
         print(f"{i['id']}  {i['text']}{tag}{when}")
+    parked = [i for i in items if not i["done_at"] and i.get("status") in todos.STATUSES]
+    if parked and args.action != "list-done":
+        held = sum(i["status"] == "hold" for i in parked)
+        print(f"({held} on hold, {len(parked) - held} archived; see the dashboard board)")
     if not show:
         print("Nothing here." if args.action == "list-done" else "No open to-dos.")
 
@@ -155,15 +191,50 @@ def cmd_followups(cfg, args):
         print("Tip: add `followups = true` to ~/.config/sessionpulse/config.toml to do this automatically.")
 
 
+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")
+    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]
+    text = {i["id"]: i["text"] for i in items}
+    total = 0
+    for project in projects:
+        try:
+            groups = followups.find_duplicates(cfg, project)
+        except (RuntimeError, OSError, ValueError, subprocess.TimeoutExpired) as exc:
+            print(f"{project or '(no project)'}: skipped, {exc}", flush=True)
+            continue
+        if not groups:
+            continue
+        print(f"\n{project or '(no project)'}", flush=True)
+        for g in groups:
+            print("  same:")
+            for x in g:
+                print(f"    {x}  {text.get(x, '')}")
+        if args.apply:
+            n = todos.merge_duplicates(cfg, groups)
+        else:
+            n = sum(len(g) - 1 for g in groups)
+        total += n
+    if args.apply:
+        print(f"\nArchived {total} duplicate(s); each keeps `duplicate_of` pointing at the one kept.")
+    else:
+        print(f"\n{total} duplicate(s) found. Run again with --apply to archive them, keeping the newest.")
+
+
 def main(argv=None):
     p = argparse.ArgumentParser(prog="sessionpulse", description=__doc__)
     p.add_argument("--version", action="version", version=f"sessionpulse {__version__}")
     sub = p.add_subparsers(dest="cmd", required=True)
-    sub.add_parser("install", help="add Claude Code hooks and login autostart") \
-       .add_argument("--no-autostart", action="store_true", help="only add the hooks")
+    i = sub.add_parser("install", help="add Claude Code hooks and login autostart")
+    i.add_argument("--no-autostart", action="store_true", help="only add the hooks")
+    i.add_argument("--daemon", action="store_true",
+                   help="autostart the background daemon (for the GNOME extension) instead of the panel icon")
     sub.add_parser("uninstall", help="remove the hooks and autostart (keeps your data)")
     sub.add_parser("tray", help="panel icon + dashboard server")
     sub.add_parser("serve", help="dashboard server only")
+    sub.add_parser("daemon", help="dashboard server + status.json for the GNOME extension, no icon")
     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")
@@ -177,6 +248,9 @@ def main(argv=None):
     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")
     f.add_argument("--again", action="store_true", help="re-read sessions already read")
+    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)")
     sub.add_parser("hook", help=argparse.SUPPRESS)
     args = p.parse_args(argv)
     cfg = config.load()

{sessionpulse-0.1.2 → sessionpulse-0.1.3}/src/sessionpulse/followups.py

@@ -30,6 +30,7 @@ DIGEST_CHARS = 60000   # how much of a transcript goes to the model
 USER_CHARS = 1200      # per prompt
 CLAUDE_CHARS = 2500    # per reply
 MAX_ITEMS = 12
+MAX_OPEN = 150         # open to-dos shown to the model per project
 TIMEOUT = 180
 
 SYSTEM = """You read a transcript of a Claude Code session between a user and Claude and list the \
@@ -51,8 +52,9 @@ English, naming the concrete thing ("Ask the vendor for the September invoice br
 Put the reason or context in `detail` (max 200 characters). Never copy passwords, keys or tokens into items.
 
 You also get the user's currently open to-dos for this project, with ids. Put an id in `resolved` only \
-if this transcript clearly shows that item was completed. Do not repeat an open to-do as a new item, and \
-do not re-add anything listed under "dismissed"."""
+if this transcript clearly shows that item was completed. Do not repeat an open to-do as a new item, even \
+in different words: if an open to-do already covers the work, leave it out. Do not re-add anything listed \
+under "dismissed"."""
 
 SCHEMA = {
     "type": "object",
@@ -111,15 +113,15 @@ def claude_bin(cfg):
     return None
 
 
-def ask_claude(cfg, prompt):
+def ask_claude(cfg, prompt, system=SYSTEM, schema=SCHEMA):
     exe = claude_bin(cfg)
     if not exe:
         raise RuntimeError("the `claude` command was not found; set claude_command in config.toml")
     work = cfg.data / "followups-cwd"
     work.mkdir(parents=True, exist_ok=True)
     cmd = [exe, "-p", "--model", cfg.followups_model, "--no-session-persistence", "--tools", "",
-           "--settings", json.dumps({"disableAllHooks": True}), "--system-prompt", SYSTEM,
-           "--output-format", "json", "--json-schema", json.dumps(SCHEMA)]
+           "--settings", json.dumps({"disableAllHooks": True}), "--system-prompt", system,
+           "--output-format", "json", "--json-schema", json.dumps(schema)]
     env = {**os.environ, "SESSIONPULSE_CHILD": "1"}
     r = subprocess.run(cmd, input=prompt, capture_output=True, text=True, cwd=work, env=env, timeout=TIMEOUT)
     try:
@@ -156,7 +158,10 @@ def process(cfg, sess, path):
     """Extract follow-ups from one session and merge them into the to-do list."""
     items = todos.load(cfg)
     project = sess.get("project") or ""
-    open_ = [i for i in items if not i.get("done_at") and i.get("project") == project][:40]
+    # newest first: the model must see recent items, or it adds them again reworded
+    open_ = sorted((i for i in items if not i.get("done_at") and i.get("status") != "archived"
+                    and i.get("project") == project),
+                   key=lambda i: i.get("created") or "", reverse=True)[:MAX_OPEN]
     dismissed = [d for d in todos.dismissed(cfg) if d.get("project") == project][-40:]
     prompt = digest(path, project)
     prompt += "\n\n## Open to-dos for this project\n" + (
@@ -167,6 +172,39 @@ def process(cfg, sess, path):
     return todos.merge_followups(cfg, sess, out.get("items") or [], out.get("resolved") or [])
 
 
+# ---------- one-off cleanup ----------
+DEDUPE_SYSTEM = """You get one project's open to-do list, one item per line with its id. Group the items \
+that are the same piece of work written in different words. Reply only with the JSON the schema asks for.
+
+Two items are duplicates only if doing one would finish the other. Items about different devices, sites, \
+people, dates or steps are NOT duplicates, even if worded alike ("Disable Telnet on the routers" and \
+"Disable WAN management on the routers" are separate). A broader item does not swallow a narrower one \
+unless it names that same work. Leave out every item that has no duplicate. When unsure, leave it out."""
+
+DEDUPE_SCHEMA = {
+    "type": "object",
+    "properties": {"groups": {"type": "array", "items": {
+        "type": "array", "minItems": 2, "items": {"type": "string"}}}},
+    "required": ["groups"],
+}
+
+
+def find_duplicates(cfg, project):
+    """Ask the model which open to-dos in one project are reworded copies; returns groups of ids."""
+    open_ = [i for i in todos.load(cfg) if todos.is_open(i) and (i.get("project") or "") == (project or "")]
+    if len(open_) < 2:
+        return []
+    ids = {i["id"] for i in open_}
+    out = ask_claude(cfg, "\n".join(f"[{i['id']}] {i['text']}" for i in open_),
+                     system=DEDUPE_SYSTEM, schema=DEDUPE_SCHEMA)
+    groups = []
+    for g in out.get("groups") or []:
+        g = [x for x in dict.fromkeys(map(str, g)) if x in ids]
+        if len(g) > 1:
+            groups.append(g)
+    return groups
+
+
 def candidates(cfg, snap, days=None, idle_minutes=None, force=False):
     """Sessions worth (re)reading: recent, quiet for a while, and changed since last read."""
     days = cfg.followups_days if days is None else days

{sessionpulse-0.1.2 → sessionpulse-0.1.3}/src/sessionpulse/install.py

@@ -126,7 +126,8 @@ def uninstall_hooks(cfg: Config):
     return changed
 
 
-def enable_autostart():
+def enable_autostart(mode="tray"):
+    """Start `sessionpulse tray` (panel icon) or `sessionpulse daemon` (no icon) at login."""
     icon = Path(__file__).with_name("icons") / "sessionpulse-idle.svg"
     AUTOSTART.parent.mkdir(parents=True, exist_ok=True)
     AUTOSTART.write_text(
@@ -134,7 +135,7 @@ def enable_autostart():
         "Type=Application\n"
         "Name=Session Pulse\n"
         "Comment=Panel icon and dashboard for Claude Code sessions\n"
-        f'Exec="{sys.executable}" -m sessionpulse tray\n'
+        f'Exec="{sys.executable}" -m sessionpulse {mode}\n'
         f"Icon={icon}\n"
         "Terminal=false\n"
         "X-GNOME-Autostart-enabled=true\n"

{sessionpulse-0.1.2 → sessionpulse-0.1.3}/src/sessionpulse/static/dashboard.html

@@ -180,6 +180,7 @@ input[type=search] { flex: 1; min-width: 200px; }
 .k-decision { --c: var(--crit); } .k-external { --c: var(--busy); } .k-waiting { --c: var(--series-7); }
 .k-checklist { --c: var(--accent); } .k-task { --c: var(--series-5); } .k-mine, .k-todo { --c: var(--other); }
 .k-doing { --c: var(--accent); } .k-done { --c: var(--good); }
+.k-hold { --c: var(--series-4); } .k-archived { --c: var(--other); }
 .kindtag { color: color-mix(in srgb, var(--c) 78%, var(--text-primary));
   background: color-mix(in srgb, var(--c) 16%, transparent); }
 .kindtag.dot { background: var(--c); }
@@ -232,6 +233,7 @@ a:hover { text-decoration: underline; }
 .card2.dragging { opacity: .4; }
 .card2 { border-left: 3px solid var(--c); }
 .card2.done { border-left-color: var(--good); }
+.card2.parked .t { color: var(--text-secondary); }
 .doing-pill { font-size: 10px; font-weight: 600; text-transform: uppercase; letter-spacing: .04em; color: #fff;
   background: var(--accent); border-radius: 5px; padding: 1px 6px; }
 .card2.done .t { color: var(--text-secondary); }
@@ -651,6 +653,8 @@ $("#history").addEventListener("click", ev => {
 const dayLabel = iso => { const d = dkey(new Date(iso)), t = new Date(); const today = dkey(t);
   t.setDate(t.getDate()-1); return d === today ? "Today" : d === dkey(t) ? "Yesterday" : dayTitle(d); };
 const KIND = {external: "Outside work", checklist: "Checklist", decision: "Decide", waiting: "Waiting on", task: "Later"};
+const PARKED = ["hold", "archived"];
+const isOpen = i => !i.done_at && !PARKED.includes(i.status);
 const todoRow = (i, done, grouped) => {
   const born = i.session_at || i.created;
   const from = i.source === "session" && i.session
@@ -666,7 +670,7 @@ const todoRow = (i, done, grouped) => {
 
 function renderTodos() {
   const items = DATA.todos || [], r = rangeStart();
-  const open = items.filter(i => !i.done_at && (!TODOF || (TODOF === "session") === (i.source === "session")))
+  const open = items.filter(i => isOpen(i) && (!TODOF || (TODOF === "session") === (i.source === "session")))
     .sort((a, b) => (a.source === "session") - (b.source === "session") || a.created.localeCompare(b.created));
   const F = DATA.followups || {};
   $("#fu-status").innerHTML = !F.enabled
@@ -676,7 +680,8 @@ function renderTodos() {
     : `Follow-ups are picked up from sessions after 20 quiet minutes${F.last_run ? ` · last checked ${ago(Date.parse(F.last_run))}` : ""}.`;
   const done = items.filter(i => i.done_at && (!r || dkey(new Date(i.done_at)) >= r))
     .sort((a, b) => b.done_at.localeCompare(a.done_at));
-  $("#todo-count").textContent = open.length ? `${open.length} open` : "";
+  const held = items.filter(i => !i.done_at && i.status === "hold").length, arch = items.filter(i => !i.done_at && i.status === "archived").length;
+  $("#todo-count").textContent = [open.length && `${open.length} open`, held && `${held} on hold`, arch && `${arch} archived`].filter(Boolean).join(" · ");
   // Group by project, newest activity first. Groups with something from the last 3 days start open.
   const G = {};
   for (const i of open) (G[i.project || ""] ||= []).push(i);
@@ -772,27 +777,31 @@ function renderLearn() {
 const COLS = {
   kind: [["decision", "Decide", "choices waiting on you"], ["external", "Outside work", "send, call, sign, visit"],
          ["waiting", "Waiting on", "someone owes you"], ["checklist", "Checklist", "audit and verify"],
-         ["task", "Later", "for a future session"], ["mine", "Added by me", ""], ["done", "Done", ""]],
-  status: [["todo", "To do", ""], ["doing", "Doing", "what you're on now"], ["done", "Done", ""]],
+         ["task", "Later", "for a future session"], ["mine", "Added by me", ""], ["hold", "On hold", "paused for now"],
+         ["done", "Done", ""], ["archived", "Archived", "dropped, kept for reference"]],
+  status: [["todo", "To do", ""], ["doing", "Doing", "what you're on now"], ["hold", "On hold", "paused for now"],
+           ["done", "Done", ""], ["archived", "Archived", "dropped, kept for reference"]],
 };
 let BY = "kind", DRAG = null;
-const colOf = i => i.done_at ? "done" : BY === "status" ? (i.doing ? "doing" : "todo") : (i.kind || "mine");
+const colOf = i => i.done_at ? "done" : PARKED.includes(i.status) ? i.status
+  : BY === "status" ? (i.doing ? "doing" : "todo") : (i.kind || "mine");
 function moveOp(i, col) {
   if (col === "done") return {op: "set", id: i.id, done: true};
-  const op = {op: "set", id: i.id, done: false};
+  if (PARKED.includes(col)) return {op: "set", id: i.id, done: false, status: col};
+  const op = {op: "set", id: i.id, done: false, status: null};
   if (BY === "status") op.doing = col === "doing";
   else op.kind = col === "mine" ? null : col;
   return op;
 }
 const card = i => {
-  const born = i.session_at || i.created, cols = COLS[BY], here = colOf(i);
-  return `<div class="card2 k-${esc(i.kind || "mine")}${i.doing && !i.done_at ? " doing" : ""}${i.done_at ? " done" : ""}" draggable="true" data-id="${esc(i.id)}">
-    <div class="t">${BY === "status" && i.kind ? `<span class="kindtag k-${esc(i.kind)}">${esc(KIND[i.kind])}</span>` : ""}${esc(i.text)}</div>
+  const born = i.session_at || i.created, cols = COLS[BY], here = colOf(i), parked = PARKED.includes(here);
+  return `<div class="card2 k-${esc(i.kind || "mine")}${i.doing && here !== "done" && !parked ? " doing" : ""}${i.done_at ? " done" : ""}${parked ? " parked" : ""}" draggable="true" data-id="${esc(i.id)}">
+    <div class="t">${(BY === "status" || parked) && i.kind ? `<span class="kindtag k-${esc(i.kind)}">${esc(KIND[i.kind])}</span>` : ""}${esc(i.text)}</div>
     ${i.detail ? `<div class="d" title="Click to expand">${esc(i.detail)}</div>` : ""}
-    <div class="meta">${i.doing && !i.done_at && BY === "kind" ? `<span class="doing-pill">Doing</span>` : ""}${i.project ? `<span class="tag" title="${esc(i.project)}">${esc(i.project.split("/").pop())}</span>` : ""}
+    <div class="meta">${i.doing && !i.done_at && !parked && BY === "kind" ? `<span class="doing-pill">Doing</span>` : ""}${i.project ? `<span class="tag" title="${esc(i.project)}">${esc(i.project.split("/").pop())}</span>` : ""}
       <span title="${i.done_at ? "Done " + esc(fmtD(i.done_at)) : (i.session_at ? "Discussed " : "Added ") + esc(fmtD(born))}">${i.done_at ? "done " + ago(Date.parse(i.done_at)) : ago(Date.parse(born))}</span>
       ${i.closed_by && i.done_at ? `<span title="A later session showed this was done">· auto</span>` : ""}
-      <span class="acts">${i.session && !i.done_at ? `<button class="copy" data-copy="cd ${esc(i.cwd || "")} && claude --resume ${esc(i.session)}" title="Copy the command that reopens the session this came from">Resume</button>` : ""}
+      <span class="acts">${i.session && !i.done_at && !parked ? `<button class="copy" data-copy="cd ${esc(i.cwd || "")} && claude --resume ${esc(i.session)}" title="Copy the command that reopens the session this came from">Resume</button>` : ""}
         <select data-move="${esc(i.id)}" aria-label="Move to"><option value="">Move…</option>${cols.filter(c => c[0] !== here).map(c => `<option value="${c[0]}">${c[1]}</option>`).join("")}</select>
         <button class="x" data-del="${esc(i.id)}" title="${i.source === "session" ? "Dismiss (won't be picked up again)" : "Delete"}" aria-label="Delete">×</button></span>
     </div></div>`;
@@ -802,9 +811,9 @@ function renderBoard() {
   if (!DATA || DRAG || $("#boardview").hidden) return;
   if (document.activeElement?.matches?.("#board select")) return;  // don't yank a menu that's open
   const items = DATA.todos || [], r = rangeStart(), proj = $("#board-proj").value, q = $("#board-q").value.trim().toLowerCase();
-  const projects = [...new Set(items.filter(i => !i.done_at).map(i => i.project).filter(Boolean))].sort();
+  const projects = [...new Set(items.filter(i => !i.done_at).map(i => i.project).filter(Boolean))].sort();  // parked ones too, so you can find them
   const sel = $("#board-proj");
-  const opts = `<option value="">All projects</option>` + projects.map(p => `<option value="${esc(p)}"${p === proj ? " selected" : ""}>${esc(p)} (${items.filter(i => !i.done_at && i.project === p).length})</option>`).join("");
+  const opts = `<option value="">All projects</option>` + projects.map(p => `<option value="${esc(p)}"${p === proj ? " selected" : ""}>${esc(p)} (${items.filter(i => isOpen(i) && i.project === p).length})</option>`).join("");
   if (sel.dataset.sig !== opts) { sel.innerHTML = opts; sel.dataset.sig = opts; sel.value = projects.includes(proj) ? proj : ""; }
   const shown = items.filter(i => (!proj || i.project === proj)
     && (!q || [i.text, i.detail, i.project].some(v => (v||"").toLowerCase().includes(q)))
@@ -813,12 +822,12 @@ function renderBoard() {
   const when = i => i.done_at || i.session_at || i.created;
   $("#board").innerHTML = COLS[BY].map(([k, label, hint]) => {
     const list = (by[k] || []).sort((a, b) => when(b).localeCompare(when(a)));
-    const cap = k === "done" ? 150 : 400;
+    const cap = k === "done" || k === "archived" ? 150 : 400;
     return `<section class="col k-${k}" data-col="${k}"><div class="col-head"><span class="kindtag dot k-${k}"></span>${label}<span class="n">${list.length}</span>${hint ? `<span class="hint">${hint}</span>` : ""}</div>
-      <div class="col-body">${list.slice(0, cap).map(card).join("") || `<div class="col-empty">${k === "done" ? "Drop a card here when it's done" : "Nothing here"}</div>`}
+      <div class="col-body">${list.slice(0, cap).map(card).join("") || `<div class="col-empty">${k === "done" ? "Drop a card here when it's done" : k === "hold" ? "Drop a card here to pause it" : k === "archived" ? "Drop a card here to shelve it" : "Nothing here"}</div>`}
       ${list.length > cap ? `<div class="col-empty">+${list.length - cap} more; narrow it with the project filter</div>` : ""}</div></section>`;
   }).join("");
-  const open = items.filter(i => !i.done_at).length;
+  const open = items.filter(isOpen).length;
   $("#board-note").textContent = `${open} open · Done shows ${RANGE ? (RANGE === 1 ? "today" : `the last ${RANGE} days`) : "everything"} (change it top right) · drag cards between columns`;
 }
 
@@ -859,7 +868,7 @@ B.addEventListener("click", ev => {
 // ---------- wiring ----------
 function render() {
   if (!DATA) return;
-  const open = (DATA.todos || []).filter(i => !i.done_at).length;
+  const open = (DATA.todos || []).filter(isOpen).length;
   $("#board-badge").textContent = open ? open : "";
   if (!$("#boardview").hidden) return renderBoard();
   const sessions = DATA.sessions.filter(inRange);

sessionpulse-0.1.3/src/sessionpulse/status.py

@@ -0,0 +1,96 @@
+"""`status.json`: a small, token-free summary for panel widgets such as the GNOME extension.
+
+`sessionpulse daemon` rewrites it every few seconds (atomically, mode 0600) and
+removes it on a clean exit. A reader should treat it as stale when `updated` is
+older than about three intervals: the daemon was killed or the machine slept.
+"""
+import json
+import os
+import time
+from pathlib import Path
+
+from . import __version__, config, reader, todos, tray
+
+SCHEMA = 1
+INTERVAL = 5  # seconds between writes
+
+
+def path(cfg: config.Config) -> Path:
+    return cfg.data / "status.json"
+
+
+def build(cfg: config.Config, snap, today=None):
+    v = tray.summary(snap, today=today)
+    now = int(time.time() * 1000)
+    return {
+        "schema": SCHEMA,
+        "version": __version__,
+        "updated": now,
+        "interval": INTERVAL,
+        "pid": os.getpid(),
+        "port": cfg.port,
+        "state": v["icon"],  # busy | idle | none
+        "open": len(v["live"]),
+        "working": v["busy"],
+        "sessions": [{
+            "project": s.get("project") or "?",
+            "state": "busy" if s.get("state") == "busy" else "idle",
+            "started": (s.get("live") or {}).get("startedAt") or now,
+        } for s in v["live"]],
+        "today": {
+            "sessions": v["today_sessions"],
+            "active_hours": round(v["today_hours"], 2),
+            "output_tokens": int(v["today_output"]),
+        },
+        "todos_open": sum(1 for t in snap.get("todos") or [] if todos.is_open(t)),
+        "warnings": len(v["warnings"]),
+    }
+
+
+def write(cfg: config.Config, data):
+    """Atomic replace, readable only by you (project names are private enough)."""
+    target = path(cfg)
+    target.parent.mkdir(parents=True, exist_ok=True)
+    tmp = target.with_name(f".status.{os.getpid()}.tmp")
+    fd = os.open(tmp, os.O_WRONLY | os.O_CREAT | os.O_TRUNC, 0o600)
+    with os.fdopen(fd, "w") as f:
+        json.dump(data, f, separators=(",", ":"))
+    os.replace(tmp, target)
+
+
+def write_now(cfg: config.Config, today=None):
+    with reader.lock:
+        snap = reader.snapshot(cfg)
+    data = build(cfg, snap, today=today)
+    write(cfg, data)
+    return data
+
+
+def run(cfg: config.Config, stop, on_error=None):
+    """Write status.json every INTERVAL seconds until `stop` (a threading.Event) is set, then remove it."""
+    try:
+        while not stop.is_set():
+            try:
+                write_now(cfg)
+            except Exception as exc:  # noqa: BLE001 - keep the daemon alive
+                if on_error:
+                    on_error(exc)
+            stop.wait(INTERVAL)
+    finally:
+        remove(cfg)
+
+
+def remove(cfg: config.Config):
+    try:
+        path(cfg).unlink()
+    except FileNotFoundError:
+        pass
+
+
+def age(cfg: config.Config):
+    """Seconds since the daemon last wrote status.json, or None if there is none."""
+    try:
+        data = json.loads(path(cfg).read_text())
+        return max(0.0, time.time() - data["updated"] / 1000)
+    except (OSError, ValueError, KeyError, TypeError):
+        return None

{sessionpulse-0.1.2 → sessionpulse-0.1.3}/src/sessionpulse/todos.py

@@ -13,6 +13,7 @@ from datetime import datetime
 
 MAX_TEXT = 500
 KINDS = ("external", "checklist", "decision", "waiting", "task")
+STATUSES = ("hold", "archived")  # parked items: not done, but not on the active list either
 lock = threading.Lock()
 
 
@@ -46,6 +47,11 @@ def _save(cfg, items):
     _write(_path(cfg), items)
 
 
+def is_open(item):
+    """Still to do: not done, on hold or archived."""
+    return not item.get("done_at") and item.get("status") not in STATUSES
+
+
 def _dismissed_path(cfg):
     return cfg.data / "todos-dismissed.json"
 
@@ -63,19 +69,58 @@ def _norm(text):
     return re.sub(r"[^a-z0-9]+", " ", text.lower()).strip()
 
 
+SIMILAR = 0.6   # word overlap at which two to-dos count as the same one reworded
+RECENT_DAYS = 30
+_STOP = frozenset("a an the and or of to in on for with from by at as is be it its this that into via "
+                  "per their your our my all any each then than not no do get set up out off whether".split())
+
+
+def _words(text):
+    """The content words of a to-do, with a plain plural 's' dropped."""
+    out = set()
+    for w in re.findall(r"[a-z0-9]+", text.lower()):
+        if w in _STOP:
+            continue
+        if len(w) > 3 and w.endswith("s") and not w.endswith("ss"):
+            w = w[:-1]
+        out.add(w)
+    return out
+
+
+def similar(a, b):
+    """True if two to-do texts say the same thing in different words."""
+    wa, wb = _words(a), _words(b)
+    return bool(wa and wb) and len(wa & wb) / len(wa | wb) >= SIMILAR
+
+
+def _recent(stamp, days=RECENT_DAYS):
+    try:
+        return (datetime.now().astimezone() - datetime.fromisoformat(stamp)).days < days
+    except (TypeError, ValueError):
+        return False
+
+
 def merge_followups(cfg, sess, found, resolved):
     """Add follow-ups found in a session and close the ones it resolved.
 
-    Returns (added, closed). Skips anything already on the list or dismissed."""
+    Returns (added, closed). Skips anything already on the list or dismissed,
+    including the same to-do reworded (see similar()) within the project."""
     added = closed = 0
+    project = sess.get("project")
     with lock:
         items = load(cfg)
-        seen = {_norm(i["text"]) for i in items} | {_norm(d.get("text", "")) for d in dismissed(cfg)}
+        gone = dismissed(cfg)
+        seen = {_norm(i["text"]) for i in items} | {_norm(d.get("text", "")) for d in gone}
+        # reworded copies: compare with this project's live items, recently done ones and dismissals
+        near = [i["text"] for i in items if i.get("project") == project
+                and (not i.get("done_at") or _recent(i["done_at"]))]
+        near += [d.get("text", "") for d in gone if d.get("project") == project]
         for f in found:
             text = _clean(f.get("text") if isinstance(f, dict) else "", 200)
-            if not text or _norm(text) in seen:
+            if not text or _norm(text) in seen or any(similar(text, t) for t in near):
                 continue
             seen.add(_norm(text))
+            near.append(text)
             kind = f.get("kind") if f.get("kind") in KINDS else "task"
             items.append({"id": secrets.token_hex(4), "text": text, "project": sess.get("project"),
                           "created": _now(), "done_at": None, "source": "session", "kind": kind,
@@ -84,7 +129,7 @@ def merge_followups(cfg, sess, found, resolved):
                           "session_at": sess.get("end")})
             added += 1
         for i in items:
-            if i["id"] in resolved and not i.get("done_at") and i.get("project") == sess.get("project"):
+            if i["id"] in resolved and not i.get("done_at") and i.get("project") == project:
                 i["done_at"] = _now()
                 i["closed_by"] = sess.get("id")
                 closed += 1
@@ -93,6 +138,31 @@ def merge_followups(cfg, sess, found, resolved):
     return added, closed
 
 
+def merge_duplicates(cfg, groups):
+    """Archive all but one open item of each group of duplicate ids; returns how many.
+
+    The kept item is the one in progress, else the newest. Archived copies record
+    `duplicate_of`, so they stay on the board and can be moved back."""
+    merged = 0
+    with lock:
+        items = load(cfg)
+        by_id = {i["id"]: i for i in items}
+        for group in groups:
+            live = [by_id[g] for g in dict.fromkeys(group) if g in by_id and is_open(by_id[g])]
+            if len(live) < 2:
+                continue
+            keep = max(live, key=lambda i: (bool(i.get("doing")), i.get("created") or ""))
+            for i in live:
+                if i is not keep:
+                    i["status"] = "archived"
+                    i["doing"] = False
+                    i["duplicate_of"] = keep["id"]
+                    merged += 1
+        if merged:
+            _save(cfg, items)
+    return merged
+
+
 def _clean(text, limit=MAX_TEXT):
     return " ".join(str(text or "").split())[:limit]
 
@@ -101,7 +171,7 @@ def apply(cfg, op):
     """Run one change and return the new list.
 
     op is a dict: {"op": "add", "text", "project"?} | {"op": "done"|"undo"|"delete", "id"}
-    | {"op": "delete", "ids": [...]} | {"op": "set", "id", "kind"?, "doing"?, "done"?}
+    | {"op": "delete", "ids": [...]} | {"op": "set", "id", "kind"?, "doing"?, "done"?, "status"?}
     | {"op": "edit", "id", "text"}. Raises ValueError on anything else."""
     if not isinstance(op, dict):
         raise ValueError("expected an object")
@@ -134,15 +204,26 @@ def apply(cfg, op):
                     hit["kind"] = op["kind"] or None
                 if "doing" in op:
                     hit["doing"] = bool(op["doing"])
+                if "status" in op:
+                    if op["status"] not in (*STATUSES, None, ""):
+                        raise ValueError("unknown status")
+                    if op["status"]:
+                        hit["status"] = op["status"]
+                        hit["doing"] = False
+                    else:
+                        hit.pop("status", None)
+                        hit.pop("duplicate_of", None)
                 if "done" in op:
                     hit["done_at"] = (hit.get("done_at") or _now()) if op["done"] else None
                     if not op["done"]:
                         hit.pop("closed_by", None)
                 if hit.get("done_at"):
                     hit["doing"] = False
+                    hit.pop("status", None)
             elif kind == "done":
                 hit["done_at"] = hit.get("done_at") or _now()
                 hit["doing"] = False
+                hit.pop("status", None)
             elif kind == "undo":
                 hit["done_at"] = None
                 hit.pop("closed_by", None)

{sessionpulse-0.1.2 → sessionpulse-0.1.3}/src/sessionpulse/tray.py

@@ -13,7 +13,7 @@ import webbrowser
 from datetime import datetime
 from importlib import resources
 
-from . import config, followups, reader, server
+from . import config, followups, reader, server, todos
 
 SLOTS = 8  # fixed rows for open sessions: replacing the whole menu would close it while open
 LIVE = ("busy", "idle", "running")
@@ -140,7 +140,7 @@ def run(cfg: config.Config):
                         f"{fmt_n(v['today_output'])} output tokens")
         warn.set_label(f"⚠ {len(v['warnings'])} data warning(s): see dashboard")
         warn.set_visible(bool(v["warnings"]))
-        n = sum(1 for t in snap.get("todos") or [] if not t.get("done_at"))
+        n = sum(1 for t in snap.get("todos") or [] if todos.is_open(t))
         board.set_label(f"Open to-do board ({n} open)" if n else "Open to-do board")
         return False
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sessionpulse
-Version: 0.1.2
+Version: 0.1.3
 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
@@ -154,6 +154,27 @@ sessionpulse followups    # read the last 30 days now instead of waiting
 
 Check everything with `sessionpulse doctor`. Remove it with `sessionpulse uninstall` (your data stays) and `pipx uninstall sessionpulse`.
 
+## GNOME extension
+
+A native top-bar indicator for GNOME Shell 45 to 48, as an alternative to the AppIndicator panel icon. It shows the same thing: the number of open sessions, orange while one is working, plus a menu with each session, today's totals, and links to the dashboard and the to-do board.
+
+The extension only reads `~/.local/share/sessionpulse/status.json` ([format](https://github.com/vijayshuklaHL/sessionpulse/blob/main/docs/status-json.md)), which `sessionpulse daemon` writes, so the app has to be installed too:
+
+```sh
+pipx install sessionpulse
+sessionpulse install --daemon   # hooks, plus the daemon (no icon) at login
+sessionpulse daemon &           # start it now
+```
+
+Then install the extension. It isn't on extensions.gnome.org yet, so install it from a clone of this repo:
+
+```sh
+gnome-extension/pack.sh
+gnome-extensions install --force gnome-extension/dist/sessionpulse@vijayshuklaHL.github.io.shell-extension.zip
+```
+
+Log out and back in (on X11 you can press Alt+F2 and type `r` instead), then run `gnome-extensions enable sessionpulse@vijayshuklaHL.github.io`. If you used the panel icon before, stop it: run `sessionpulse install --daemon` again so login starts the daemon instead of the tray.
+
 ## Commands
 
 | Command | What it does |
@@ -162,10 +183,12 @@ Check everything with `sessionpulse doctor`. Remove it with `sessionpulse uninst
 | `sessionpulse uninstall` | Removes exactly those hooks and the autostart entry. Your data stays. |
 | `sessionpulse tray` | Panel icon and dashboard server |
 | `sessionpulse serve` | Dashboard server only |
+| `sessionpulse daemon` | Dashboard server plus `status.json` for panel widgets such as the GNOME extension, no icon (`install --daemon` starts it at login) |
 | `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 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 snapshot` | Prints the dashboard data as JSON |
 
 ## Settings

{sessionpulse-0.1.2 → sessionpulse-0.1.3}/src/sessionpulse.egg-info/SOURCES.txt

@@ -11,6 +11,7 @@ src/sessionpulse/install.py
 src/sessionpulse/learn.py
 src/sessionpulse/reader.py
 src/sessionpulse/server.py
+src/sessionpulse/status.py
 src/sessionpulse/todos.py
 src/sessionpulse/tray.py
 src/sessionpulse.egg-info/PKG-INFO

{sessionpulse-0.1.2 → sessionpulse-0.1.3}/tests/test_sessionpulse.py

@@ -14,7 +14,7 @@ from pathlib import Path
 
 sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "src"))
 
-from sessionpulse import cli, config, followups, hook, install, learn, reader, server, todos, tray  # noqa: E402
+from sessionpulse import cli, config, followups, hook, install, learn, reader, server, status, todos, tray  # noqa: E402
 
 SID = "11111111-2222-3333-4444-555555555555"
 
@@ -313,6 +313,31 @@ class TodoTests(Fixture):
         self.assertEqual(sorted(d["text"] for d in todos.dismissed(self.cfg)), ["a", "b"])
         self.assertEqual(todos.merge_followups(self.cfg, {"id": "s2", "project": "p"}, [{"text": "a"}], []), (0, 0))
 
+    def test_reworded_followups_skipped(self):
+        merge = todos.merge_followups
+        merge(self.cfg, {"id": "s", "project": "p"},
+              [{"text": "Put Grafana alert rules on no data and execution error"}], [])
+        self.assertEqual(merge(self.cfg, {"id": "s2", "project": "p"},
+                               [{"text": "Check that Grafana alert rules fire on no data and on execution error"},
+                                {"text": "Disable Telnet on the Credo routers"},
+                                {"text": "Disable WAN management on the Credo routers"}], []), (2, 0))
+        # the same words in another project are a different to-do
+        self.assertEqual(merge(self.cfg, {"id": "s3", "project": "q"},
+                               [{"text": "Check Grafana alert rules on no data and execution error"}], []), (1, 0))
+
+    def test_merge_duplicates(self):
+        a = todos.apply(self.cfg, {"op": "add", "text": "old wording"})[-1]["id"]
+        b = todos.apply(self.cfg, {"op": "add", "text": "new wording"})[-1]["id"]
+        c = todos.apply(self.cfg, {"op": "add", "text": "in progress"})[-1]["id"]
+        todos.apply(self.cfg, {"op": "set", "id": c, "doing": True})
+        self.assertEqual(todos.merge_duplicates(self.cfg, [[a, b, c], [a, "missing"]]), 2)
+        by = {i["id"]: i for i in todos.load(self.cfg)}
+        self.assertTrue(todos.is_open(by[c]))  # the one in progress is kept
+        self.assertEqual([(by[x]["status"], by[x]["duplicate_of"]) for x in (a, b)], [("archived", c)] * 2)
+        it = next(i for i in todos.apply(self.cfg, {"op": "set", "id": a, "status": None}) if i["id"] == a)
+        self.assertNotIn("duplicate_of", it)
+        self.assertEqual(todos.merge_duplicates(self.cfg, [[b, c]]), 0)  # b is already archived
+
     def test_board_moves(self):
         i = todos.apply(self.cfg, {"op": "add", "text": "x"})[0]["id"]
         it = todos.apply(self.cfg, {"op": "set", "id": i, "kind": "decision", "doing": True})[0]
@@ -325,6 +350,23 @@ class TodoTests(Fixture):
         with self.assertRaises(ValueError):
             todos.apply(self.cfg, {"op": "set", "id": i, "kind": "nope"})
 
+    def test_hold_and_archive(self):
+        i = todos.apply(self.cfg, {"op": "add", "text": "x"})[0]["id"]
+        it = todos.apply(self.cfg, {"op": "set", "id": i, "doing": True})[0]
+        it = todos.apply(self.cfg, {"op": "set", "id": i, "done": False, "status": "hold"})[0]
+        self.assertEqual((it["status"], it["doing"], it["done_at"]), ("hold", False, None))
+        self.assertFalse(todos.is_open(it))
+        it = todos.apply(self.cfg, {"op": "set", "id": i, "status": "archived"})[0]
+        self.assertEqual(it["status"], "archived")
+        it = todos.apply(self.cfg, {"op": "set", "id": i, "done": False, "status": None})[0]
+        self.assertNotIn("status", it)
+        self.assertTrue(todos.is_open(it))
+        todos.apply(self.cfg, {"op": "set", "id": i, "status": "hold"})
+        it = todos.apply(self.cfg, {"op": "done", "id": i})[0]
+        self.assertNotIn("status", it)  # finishing a held item un-parks it
+        with self.assertRaises(ValueError):
+            todos.apply(self.cfg, {"op": "set", "id": i, "status": "someday"})
+
     def test_bad_ops_rejected(self):
         for op in ({"op": "add", "text": "  "}, {"op": "done", "id": "missing"}, {"op": "x"}, []):
             with self.assertRaises(ValueError):
@@ -346,6 +388,72 @@ class TodoTests(Fixture):
         self.assertIn("call Sam  [ops]  done", out.getvalue())
 
 
+class StatusTests(Fixture):
+    def live_session(self):
+        t = self.t0
+        self.write([user(t, "hi"), assistant(t, "m1", 42)])
+        (self.cfg.claude / "sessions" / "1.json").write_text(json.dumps(
+            {"pid": os.getpid(), "sessionId": SID, "status": "busy", "startedAt": 1234}))
+        return t.date().isoformat()
+
+    def test_status_file(self):
+        day = self.live_session()
+        todos.apply(self.cfg, {"op": "add", "text": "ship it"})
+        data = status.write_now(self.cfg, today=day)
+        on_disk = json.loads(status.path(self.cfg).read_text())
+        self.assertEqual(on_disk, data)
+        self.assertEqual((data["schema"], data["state"], data["open"], data["working"]), (1, "busy", 1, 1))
+        self.assertEqual(data["sessions"][0]["state"], "busy")
+        self.assertEqual(data["sessions"][0]["started"], 1234)
+        self.assertEqual(data["today"]["output_tokens"], 42)
+        self.assertEqual(data["todos_open"], 1)
+        self.assertEqual(status.path(self.cfg).stat().st_mode & 0o777, 0o600)
+        self.assertNotIn(config.token(self.cfg), status.path(self.cfg).read_text())
+        self.assertLess(status.age(self.cfg), 5)
+        self.assertEqual(list(self.cfg.data.glob(".status.*")), [])  # no temp files left
+
+    def test_no_sessions_and_removal(self):
+        data = status.write_now(self.cfg)
+        self.assertEqual((data["state"], data["open"], data["sessions"]), ("none", 0, []))
+        status.remove(self.cfg)
+        status.remove(self.cfg)  # twice is fine
+        self.assertIsNone(status.age(self.cfg))
+
+    def test_daemon_loop_writes_then_cleans_up(self):
+        self.live_session()
+        stop, seen = threading.Event(), []
+
+        def watch():
+            for _ in range(200):
+                if status.path(self.cfg).exists():
+                    seen.append(json.loads(status.path(self.cfg).read_text())["open"])
+                    break
+                stop.wait(0.01)
+            stop.set()
+
+        threading.Thread(target=watch).start()
+        with unittest.mock.patch.object(status, "INTERVAL", 0.02):
+            status.run(self.cfg, stop)
+        self.assertEqual(seen, [1])
+        self.assertFalse(status.path(self.cfg).exists())
+
+    def test_daemon_command_runs_without_icon(self):
+        with unittest.mock.patch.object(config, "load", return_value=self.cfg), \
+             unittest.mock.patch.object(cli.signal, "signal"), \
+             unittest.mock.patch.object(cli.followups, "start_worker"), \
+             unittest.mock.patch.object(cli.status, "run") as run, \
+             unittest.mock.patch("sys.stdout", io.StringIO()) as out:
+            cli.main(["daemon"])
+        run.assert_called_once()
+        self.assertIn("status.json", out.getvalue())
+
+    def test_install_daemon_autostart(self):
+        target = Path(self.tmp.name) / "autostart" / "sessionpulse.desktop"
+        with unittest.mock.patch.object(install, "AUTOSTART", target):
+            install.enable_autostart("daemon")
+        self.assertIn("-m sessionpulse daemon", target.read_text())
+
+
 class HeadlessTests(Fixture):
     def run_cli(self, argv, env):
         out = io.StringIO()