ring-cli 0.14.1__tar.gz → 0.14.2__tar.gz

{ring_cli-0.14.1 → ring_cli-0.14.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ring-cli
-Version: 0.14.1
+Version: 0.14.2
 Summary: RiNG — Realtime Instance Notification Grid for active agent CLI sessions.
 Keywords: claude-code,codex,ollama,llama-cpp,tui,dashboard,session,monitor,rich
 Author: Wei Lee

ring_cli-0.14.2/pyproject.toml

@@ -0,0 +1,212 @@
+[project]
+name = "ring-cli"
+version = "0.14.2"
+description = "RiNG — Realtime Instance Notification Grid for active agent CLI sessions."
+readme = "README.en.md"
+requires-python = ">=3.13"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "claude-code",
+    "codex",
+    "ollama",
+    "llama-cpp",
+    "tui",
+    "dashboard",
+    "session",
+    "monitor",
+    "rich",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development",
+    "Topic :: Utilities",
+]
+dependencies = ["rich>=13"]
+
+[[project.authors]]
+name = "Wei Lee"
+email = "weilee.rx@gmail.com"
+
+[project.urls]
+Homepage = "https://github.com/Lee-W/ring"
+Repository = "https://github.com/Lee-W/ring"
+Documentation = "https://lee-w.github.io/ring/"
+
+[project.optional-dependencies]
+tui = ["textual>=0.80"]
+
+[project.scripts]
+ring = "ring.cli:main"
+
+[dependency-groups]
+base = [
+    "poethepoet>=0.41.0",
+    "babel>=2.14",
+]
+test = [
+    "pytest>=9",
+    "pytest-cov>=4",
+    "pytest-xdist>=3.1.0",
+    "pytest-asyncio>=0.24",
+    "textual>=0.80",
+]
+linters = [
+    "ruff>=0.15.1",
+    "mypy>=1.19.1",
+    "prek>=0.3.3",
+    "commitizen>=4.13.9",
+]
+docs = [
+    "mkdocs-material>=9,<10",
+    "mkdocs-static-i18n>=1.3,<2",
+]
+
+[[dependency-groups.dev]]
+include-group = "base"
+
+[[dependency-groups.dev]]
+include-group = "test"
+
+[[dependency-groups.dev]]
+include-group = "linters"
+
+[build-system]
+requires = ["uv_build >= 0.10.3, <0.12.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "ring"
+module-root = "src"
+
+[tool.mypy]
+files = [
+    "src",
+    "tests",
+]
+strict = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_unused_configs = true
+
+[tool.ruff]
+target-version = "py313"
+line-length = 120
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "W",
+    "I",
+    "UP",
+    "RUF",
+]
+ignore = [
+    "RUF001",
+    "RUF002",
+    "RUF003",
+]
+
+[tool.codespell]
+skip = ".git*,*.lock"
+check-hidden = true
+ignore-words-list = "otification"
+
+[tool.poe.tasks.format]
+help = "Format the code"
+
+[[tool.poe.tasks.format.sequence]]
+cmd = "ruff check --fix"
+
+[[tool.poe.tasks.format.sequence]]
+cmd = "ruff format"
+
+[tool.poe.tasks.lint]
+help = "Lint the code"
+
+[[tool.poe.tasks.lint.sequence]]
+cmd = "ruff check"
+
+[[tool.poe.tasks.lint.sequence]]
+cmd = "mypy"
+
+[tool.poe.tasks.test]
+help = "Run the test suite"
+cmd = "pytest"
+
+[tool.poe.tasks.cover]
+help = "Run the test suite with coverage"
+cmd = "pytest --cov=ring --cov-report=term-missing --cov-report=xml:coverage.xml --junitxml=junit.xml -o junit_family=legacy"
+
+[tool.poe.tasks.all]
+help = "Run all tasks"
+sequence = [
+    "format",
+    "lint",
+    "cover",
+]
+
+[tool.poe.tasks.ci]
+help = "Run all tasks in CI"
+sequence = [
+    { cmd = "prek run --all-files" },
+    "cover",
+]
+
+[tool.poe.tasks.ci.env]
+SKIP = "no-commit-to-branch"
+
+[tool.poe.tasks.setup-pre-commit]
+help = "Install pre-commit hooks"
+cmd = "prek install"
+
+[tool.poe.tasks."i18n:extract"]
+help = "從原始碼抽出可翻譯字串到 .pot（改字串後重抽。不要用 pybabel update：會塞空 msgstr 進 .po，弄壞 i18n 測試。新字串請手動把已翻譯條目加進各 .po）"
+cmd = "pybabel extract -F babel.cfg -o src/ring/locale/ring.pot src/ring"
+
+[tool.poe.tasks."i18n:check"]
+help = "列出原始碼有、但某語言 .po 還沒翻譯的字串（純資訊，不失敗）。先跑 i18n:extract"
+cmd = "python scripts/i18n_check.py"
+
+[tool.poe.tasks."i18n:compile"]
+help = "把各語言的 .po 編成 .mo（改 .po 後要重編並 commit）"
+cmd = "pybabel compile -d src/ring/locale -D ring"
+
+[tool.poe.tasks."docs:serve"]
+help = "Serve the docs site locally with live reload"
+cmd = "mkdocs serve"
+
+[tool.poe.tasks."docs:build"]
+help = "Build the docs site into site/"
+cmd = "mkdocs build --strict"
+
+[tool.commitizen]
+name = "cz_conventional_commits"
+tag_format = "$version"
+version_scheme = "pep440"
+version_provider = "uv"
+update_changelog_on_bump = true
+major_version_zero = true
+
+[tool.pytest]
+testpaths = ["tests"]
+addopts = [
+    "-n",
+    "auto",
+    "--dist=loadfile",
+]
+
+[tool.coverage.run]
+source = ["ring"]
+
+[tool.coverage.paths]
+source = [
+    "src/ring",
+    "*/ring",
+]

ring_cli-0.14.1/pyproject.toml → ring_cli-0.14.2/pyproject.toml.orig

@@ -2,7 +2,7 @@
 # import 的 module（見 [tool.uv.build-backend] module-name）與 CLI 指令仍是 `ring`。
 [project]
 name = "ring-cli"
-version = "0.14.1"
+version = "0.14.2"
 description = "RiNG — Realtime Instance Notification Grid for active agent CLI sessions."
 readme = "README.en.md"
 requires-python = ">=3.13"

{ring_cli-0.14.1 → ring_cli-0.14.2}/src/ring/registry.py

@@ -69,6 +69,8 @@ WAITING_KIND_ICONS = {
     "idle": "⏸",
 }
 HOOK_HEARTBEAT_STALE_GRACE_SECONDS = 60.0
+# 只送過 SessionStart 就再無下文的 hook row，寬限多久後判離場（見 _is_bare_session_start_row）
+BARE_SESSION_START_GRACE_SECONDS = 120.0
 
 # Provider → 「當下 live process 的 (cwd, tty) 清單」偵測器。core 不認識任何具體工具：
 # 要支援新工具的存活偵測＝註冊一個偵測器，_hook_sessions / sources 零改動。
@@ -423,6 +425,34 @@ def _hook_heartbeat_stale(
     return source_mtime - heartbeat_at > grace_seconds
 
 
+def _is_bare_session_start_row(
+    tty: str,
+    last_event: str,
+    age_seconds: float,
+    *,
+    grace_seconds: float = BARE_SESSION_START_GRACE_SECONDS,
+) -> bool:
+    """這筆 hook row 是不是「只送過 SessionStart 就再無下文、又沒有終端」的承載 session。
+
+    Claude Code 的背景 job／agent（``--bg-pty-host`` / ``--agent``）起來時會送一筆
+    SessionStart，之後可能整段生命週期都不再送任何事件。hook row 的狀態只靠事件推進
+    （不像 scan row 會隨 idle 秒數自己衰減），所以這種 row 會以 🟢 working 卡在看板上
+    直到 ``ACTIVE_WINDOW_SECONDS`` 過期，而且它沒有 tty、跳也跳不過去——2026-07-28
+    現場取證：一次背景 job 讓看板憑空多一列，registry 裡最久的一筆已經掛了三天。
+
+    真正在做事的背景 job 起步幾秒內就會送出 UserPromptSubmit／PreToolUse，寬限期過後
+    仍只有 SessionStart 才判離場；之後只要它真的動起來，下一個事件會把 row 寫回在場，
+    不是永久刪除。有 tty 的前景 session 一律不套用——剛開好還沒輸入的終端 session 也
+    只有 SessionStart，那是正常在場狀態。
+
+    :param tty:           row 記錄到的終端；空字串代表沒有可聚焦終端。
+    :param last_event:    registry 檔裡的 ``last_event``。
+    :param age_seconds:   距離 ``last_active`` 過了多久。
+    :param grace_seconds: 寬限秒數，超過才判離場。
+    """
+    return not tty and last_event == "SessionStart" and age_seconds > grace_seconds
+
+
 _tmux_cache: tuple[float, dict[str, str]] = (-1.0, {})
 _tmux_panes_cache: tuple[float, list[TmuxPane]] = (-1.0, [])
 
@@ -1408,6 +1438,14 @@ def _hook_sessions(
                     # 「下一個事件來時還新不新鮮」；這裡 hook 靜默 = 同一筆請求還掛著，
                     # 摘要必然還是它，直接沿用）。
                     row.waiting_detail = pending_detail
+            if _is_bare_session_start_row(
+                row.tty or "",
+                str(data.get("last_event", "")),
+                time.time() - row.last_active,
+            ):
+                # 背景 job／agent 的承載 session：只報到、不做事、沒有終端。判離場後
+                # 預設收起（`--all` / TUI 的 a 仍查得到），它真的動起來時會自己回來。
+                row.status = Status.ENDED
             out.append(row)
         except (KeyError, ValueError):
             continue