claude-session-status 0.1.0__tar.gz

claude_session_status-0.1.0/PKG-INFO

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: claude-session-status
+Version: 0.1.0
+Summary: Track warm/cold status of Claude Code sessions in a dedicated DuckDB file
+Project-URL: Homepage, https://github.com/keith-fajardo/claude-session-status
+Project-URL: Repository, https://github.com/keith-fajardo/claude-session-status
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: duckdb>=0.9
+
+# claude-session-status
+
+Tracks warm/cold status of Claude Code sessions in a dedicated DuckDB file — separate from `claude-session-logger` to avoid file-lock conflicts.
+
+## Why
+
+`claude-session-logger` writes to `sessions.duckdb` at session end. If a TUI holds a persistent read-only connection to that file, the write blocks. This package uses its own DB (`~/.claude/claude-session-status/status.duckdb`) and **never holds an open connection between operations**.
+
+## Install
+
+```bash
+pip install claude-session-status
+```
+
+## Hook integration
+
+Add to `~/.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "SessionStart": [
+      {"type": "command", "command": "claude-session-status mark-warm"}
+    ],
+    "SessionEnd": [
+      {"type": "command", "command": "claude-session-status mark-cold"}
+    ]
+  }
+}
+```
+
+Claude Code pipes session JSON to stdin; the scripts extract `session_id`, `project`, and `cwd` automatically.
+
+## Commands
+
+```bash
+# Live-refresh table of warm/cold sessions (Ctrl-C to quit)
+claude-session-status watch
+
+# Called by hooks (reads JSON from stdin)
+claude-session-status mark-warm
+claude-session-status mark-cold
+```
+
+## DB schema
+
+```sql
+CREATE TABLE session_status (
+    session_id TEXT PRIMARY KEY,
+    project    TEXT,
+    cwd        TEXT,
+    started_at TIMESTAMP,
+    updated_at TIMESTAMP,
+    status     TEXT  -- 'warm' | 'cold'
+)
+```
+
+DB location: `~/.claude/claude-session-status/status.duckdb`
+
+## Design
+
+- Runtime dependency: `duckdb` only
+- Every DB access: open → read/write → close. No persistent connections.
+- `mark-warm` / `mark-cold`: silent on success, errors go to stderr (never block Claude Code)
+- 3-retry lock backoff on connect

claude_session_status-0.1.0/README.md

@@ -0,0 +1,65 @@
+# claude-session-status
+
+Tracks warm/cold status of Claude Code sessions in a dedicated DuckDB file — separate from `claude-session-logger` to avoid file-lock conflicts.
+
+## Why
+
+`claude-session-logger` writes to `sessions.duckdb` at session end. If a TUI holds a persistent read-only connection to that file, the write blocks. This package uses its own DB (`~/.claude/claude-session-status/status.duckdb`) and **never holds an open connection between operations**.
+
+## Install
+
+```bash
+pip install claude-session-status
+```
+
+## Hook integration
+
+Add to `~/.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "SessionStart": [
+      {"type": "command", "command": "claude-session-status mark-warm"}
+    ],
+    "SessionEnd": [
+      {"type": "command", "command": "claude-session-status mark-cold"}
+    ]
+  }
+}
+```
+
+Claude Code pipes session JSON to stdin; the scripts extract `session_id`, `project`, and `cwd` automatically.
+
+## Commands
+
+```bash
+# Live-refresh table of warm/cold sessions (Ctrl-C to quit)
+claude-session-status watch
+
+# Called by hooks (reads JSON from stdin)
+claude-session-status mark-warm
+claude-session-status mark-cold
+```
+
+## DB schema
+
+```sql
+CREATE TABLE session_status (
+    session_id TEXT PRIMARY KEY,
+    project    TEXT,
+    cwd        TEXT,
+    started_at TIMESTAMP,
+    updated_at TIMESTAMP,
+    status     TEXT  -- 'warm' | 'cold'
+)
+```
+
+DB location: `~/.claude/claude-session-status/status.duckdb`
+
+## Design
+
+- Runtime dependency: `duckdb` only
+- Every DB access: open → read/write → close. No persistent connections.
+- `mark-warm` / `mark-cold`: silent on success, errors go to stderr (never block Claude Code)
+- 3-retry lock backoff on connect

claude_session_status-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "claude-session-status"
+version = "0.1.0"
+description = "Track warm/cold status of Claude Code sessions in a dedicated DuckDB file"
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = ["duckdb>=0.9"]
+
+[project.urls]
+Homepage = "https://github.com/keith-fajardo/claude-session-status"
+Repository = "https://github.com/keith-fajardo/claude-session-status"
+
+[project.scripts]
+claude-session-status = "claude_session_status.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

claude_session_status-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

claude_session_status-0.1.0/src/claude_session_status/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

claude_session_status-0.1.0/src/claude_session_status/cli.py

@@ -0,0 +1,115 @@
+import json
+import sys
+import time
+import argparse
+from . import db
+
+_GREEN = "\033[32m"
+_DIM   = "\033[2m"
+_RESET = "\033[0m"
+_CLEAR = "\033[2J\033[H"
+
+
+def _read_stdin_json() -> dict:
+    raw = sys.stdin.read()
+    if not raw.strip():
+        return {}
+    return json.loads(raw)
+
+
+def _session_id_from(data: dict) -> str:
+    return (
+        data.get("session_id")
+        or data.get("sessionId")
+        or data.get("id")
+        or ""
+    )
+
+
+def _project_from(data: dict) -> str:
+    return (
+        data.get("project")
+        or data.get("project_name")
+        or data.get("projectName")
+        or ""
+    )
+
+
+def _cwd_from(data: dict) -> str:
+    return data.get("cwd") or ""
+
+
+def cmd_mark_warm(_args):
+    try:
+        data = _read_stdin_json()
+        session_id = _session_id_from(data)
+        if not session_id:
+            print("claude-session-status: no session_id in stdin payload", file=sys.stderr)
+            return
+        db.mark_warm(session_id, _project_from(data), _cwd_from(data))
+    except Exception as e:
+        print(f"claude-session-status mark-warm error: {e}", file=sys.stderr)
+
+
+def cmd_mark_cold(_args):
+    try:
+        data = _read_stdin_json()
+        session_id = _session_id_from(data)
+        if not session_id:
+            print("claude-session-status: no session_id in stdin payload", file=sys.stderr)
+            return
+        db.mark_cold(session_id, _project_from(data), _cwd_from(data))
+    except Exception as e:
+        print(f"claude-session-status mark-cold error: {e}", file=sys.stderr)
+
+
+def _render(rows: list[dict]) -> str:
+    lines = [f"{'SESSION':>12}  {'PROJECT':<20}  {'STARTED':<19}  STATUS"]
+    lines.append("-" * 70)
+    for r in rows:
+        sid   = str(r["session_id"])[-12:]
+        proj  = (r["project"] or r["cwd"] or "?")[:20]
+        ts    = str(r["started_at"])[:19] if r["started_at"] else "?"
+        if r["status"] == "warm":
+            status = f"{_GREEN}warm{_RESET}"
+        else:
+            status = f"{_DIM}cold{_RESET}"
+        lines.append(f"{sid:>12}  {proj:<20}  {ts:<19}  {status}")
+    return "\n".join(lines)
+
+
+def cmd_watch(_args):
+    try:
+        while True:
+            rows = db.fetch_all()
+            sys.stdout.write(_CLEAR)
+            print(f"claude-session-status  (refreshes every 5s, Ctrl-C to quit)\n")
+            print(_render(rows))
+            sys.stdout.flush()
+            time.sleep(5)
+    except KeyboardInterrupt:
+        pass
+    except Exception as e:
+        print(f"claude-session-status watch error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+def main():
+    parser = argparse.ArgumentParser(prog="claude-session-status")
+    sub = parser.add_subparsers(dest="cmd")
+
+    sub.add_parser("mark-warm", help="Upsert session as warm (reads JSON from stdin)")
+    sub.add_parser("mark-cold", help="Upsert session as cold (reads JSON from stdin)")
+    sub.add_parser("watch",     help="Live-refresh warm/cold session table")
+
+    args = parser.parse_args()
+
+    if args.cmd == "mark-warm":
+        cmd_mark_warm(args)
+    elif args.cmd == "mark-cold":
+        cmd_mark_cold(args)
+    elif args.cmd == "watch":
+        cmd_watch(args)
+    else:
+        parser.print_help()
+        sys.exit(1)

claude_session_status-0.1.0/src/claude_session_status/db.py

@@ -0,0 +1,85 @@
+import time
+import duckdb
+from pathlib import Path
+
+DB_PATH = Path.home() / ".claude" / "claude-session-status" / "status.duckdb"
+
+_CREATE_TABLE = """
+CREATE TABLE IF NOT EXISTS session_status (
+    session_id TEXT PRIMARY KEY,
+    project    TEXT,
+    cwd        TEXT,
+    started_at TIMESTAMP,
+    updated_at TIMESTAMP,
+    status     TEXT
+)
+"""
+
+_UPSERT_WARM = """
+INSERT INTO session_status (session_id, project, cwd, started_at, updated_at, status)
+VALUES (?, ?, ?, now(), now(), 'warm')
+ON CONFLICT (session_id) DO UPDATE SET
+    project    = excluded.project,
+    cwd        = excluded.cwd,
+    updated_at = now(),
+    status     = 'warm'
+"""
+
+_UPSERT_COLD = """
+INSERT INTO session_status (session_id, project, cwd, started_at, updated_at, status)
+VALUES (?, ?, ?, now(), now(), 'cold')
+ON CONFLICT (session_id) DO UPDATE SET
+    updated_at = now(),
+    status     = 'cold'
+"""
+
+_SELECT_ALL = """
+SELECT session_id, project, cwd, started_at, updated_at, status
+FROM session_status
+ORDER BY updated_at DESC
+"""
+
+
+def _connect():
+    DB_PATH.parent.mkdir(parents=True, exist_ok=True)
+    last_err = None
+    for attempt in range(3):
+        try:
+            return duckdb.connect(str(DB_PATH))
+        except duckdb.IOException as e:
+            last_err = e
+            time.sleep(0.2 * (attempt + 1))
+    raise last_err
+
+
+def _ensure_table(con):
+    con.execute(_CREATE_TABLE)
+
+
+def mark_warm(session_id: str, project: str, cwd: str) -> None:
+    con = _connect()
+    try:
+        _ensure_table(con)
+        con.execute(_UPSERT_WARM, [session_id, project, cwd])
+    finally:
+        con.close()
+
+
+def mark_cold(session_id: str, project: str, cwd: str) -> None:
+    con = _connect()
+    try:
+        _ensure_table(con)
+        con.execute(_UPSERT_COLD, [session_id, project, cwd])
+    finally:
+        con.close()
+
+
+def fetch_all() -> list[dict]:
+    con = _connect()
+    try:
+        _ensure_table(con)
+        rows = con.execute(_SELECT_ALL).fetchall()
+        cols = ["session_id", "project", "cwd", "started_at", "updated_at", "status"]
+        return [dict(zip(cols, row)) for row in rows]
+    finally:
+        con.close()

claude_session_status-0.1.0/src/claude_session_status.egg-info/PKG-INFO

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: claude-session-status
+Version: 0.1.0
+Summary: Track warm/cold status of Claude Code sessions in a dedicated DuckDB file
+Project-URL: Homepage, https://github.com/keith-fajardo/claude-session-status
+Project-URL: Repository, https://github.com/keith-fajardo/claude-session-status
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: duckdb>=0.9
+
+# claude-session-status
+
+Tracks warm/cold status of Claude Code sessions in a dedicated DuckDB file — separate from `claude-session-logger` to avoid file-lock conflicts.
+
+## Why
+
+`claude-session-logger` writes to `sessions.duckdb` at session end. If a TUI holds a persistent read-only connection to that file, the write blocks. This package uses its own DB (`~/.claude/claude-session-status/status.duckdb`) and **never holds an open connection between operations**.
+
+## Install
+
+```bash
+pip install claude-session-status
+```
+
+## Hook integration
+
+Add to `~/.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "SessionStart": [
+      {"type": "command", "command": "claude-session-status mark-warm"}
+    ],
+    "SessionEnd": [
+      {"type": "command", "command": "claude-session-status mark-cold"}
+    ]
+  }
+}
+```
+
+Claude Code pipes session JSON to stdin; the scripts extract `session_id`, `project`, and `cwd` automatically.
+
+## Commands
+
+```bash
+# Live-refresh table of warm/cold sessions (Ctrl-C to quit)
+claude-session-status watch
+
+# Called by hooks (reads JSON from stdin)
+claude-session-status mark-warm
+claude-session-status mark-cold
+```
+
+## DB schema
+
+```sql
+CREATE TABLE session_status (
+    session_id TEXT PRIMARY KEY,
+    project    TEXT,
+    cwd        TEXT,
+    started_at TIMESTAMP,
+    updated_at TIMESTAMP,
+    status     TEXT  -- 'warm' | 'cold'
+)
+```
+
+DB location: `~/.claude/claude-session-status/status.duckdb`
+
+## Design
+
+- Runtime dependency: `duckdb` only
+- Every DB access: open → read/write → close. No persistent connections.
+- `mark-warm` / `mark-cold`: silent on success, errors go to stderr (never block Claude Code)
+- 3-retry lock backoff on connect

claude_session_status-0.1.0/src/claude_session_status.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+src/claude_session_status/__init__.py
+src/claude_session_status/cli.py
+src/claude_session_status/db.py
+src/claude_session_status.egg-info/PKG-INFO
+src/claude_session_status.egg-info/SOURCES.txt
+src/claude_session_status.egg-info/dependency_links.txt
+src/claude_session_status.egg-info/entry_points.txt
+src/claude_session_status.egg-info/requires.txt
+src/claude_session_status.egg-info/top_level.txt

claude_session_status-0.1.0/src/claude_session_status.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

claude_session_status-0.1.0/src/claude_session_status.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+claude-session-status = claude_session_status.cli:main

claude_session_status-0.1.0/src/claude_session_status.egg-info/requires.txt

@@ -0,0 +1 @@
+duckdb>=0.9

claude_session_status-0.1.0/src/claude_session_status.egg-info/top_level.txt

@@ -0,0 +1 @@
+claude_session_status