cdx-manager 0.12.1 → 0.12.2

package/README.md

@@ -1,6 +1,6 @@
 # CDX Manager
 
-[![License](https://img.shields.io/badge/license-MIT-4C8BF5)](LICENSE) ![Version](https://img.shields.io/badge/version-v0.12.1-4C8BF5) ![Python](https://img.shields.io/badge/python-3.9%2B-3776AB?logo=python&logoColor=white)
+[![License](https://img.shields.io/badge/license-MIT-4C8BF5)](LICENSE) ![Version](https://img.shields.io/badge/version-v0.12.2-4C8BF5) ![Python](https://img.shields.io/badge/python-3.9%2B-3776AB?logo=python&logoColor=white)
 
 **Run multiple Codex, Claude, Antigravity, and Ollama sessions from one terminal. Switch between accounts instantly.**
 
@@ -274,7 +274,7 @@ cdx disk profiles --candidates
 
 ### Next-Ready Notifications
 
-Use `cdx ready` when every useful assistant is cooling down and you want your terminal back. It is shorthand for `cdx notify --schedule --next-ready`: cdx picks the next known reset, registers a native OS notification, and exits immediately.
+Use `cdx ready` when every useful assistant is cooling down and you want your terminal back. It is shorthand for `cdx notify --schedule --next-ready`: cdx picks the next known reset, registers a native OS notification, and exits immediately. If no future reset is known, it exits successfully and explains that no notification was scheduled.
 
 ```bash
 cdx ready
@@ -372,7 +372,7 @@ cdx history --summary --from 2026-05-01 --to 2026-05-28
 | `cdx reset <name> [--yes] [--json]` | Explicitly consume one available banked Codex rate-limit reset; confirmation is required unless `--yes` is supplied |
 | `cdx export <file> [--include-auth] [--sessions a,b] [--passphrase-env VAR\|--passphrase-stdin] [--force] [--json]` | Export sessions to a portable bundle; `--include-auth` encrypts auth data with a passphrase |
 | `cdx import <file> [--sessions a,b] [--passphrase-env VAR\|--passphrase-stdin] [--force] [--json]` | Import sessions from a bundle into the current `CDX_HOME` |
-| `cdx doctor [--json]` | Inspect CLI dependencies, provider CLI versions/capability hints, CDX_HOME permissions, missing state, orphan profiles, and pending quarantines |
+| `cdx doctor [--severity OK|WARN|FAIL[,OK|WARN|FAIL...]] [--json]` | Inspect CLI dependencies, provider CLI versions/capability hints, CDX_HOME permissions, missing state, orphan profiles, and pending quarantines; optionally filter issue severities |
 | `cdx repair [--dry-run] [--force] [--json]` | Plan or apply safe repairs for missing state files, quarantines, and orphan profiles |
 | `cdx view [--json] [--lan] [--lan-rw] [--focus <ref>] [--read] [--port <port>] [--host <host>] [--refresh-interval <s>] [--tls] [--tls-cert <path>] [--tls-key <path>] [--open] [--no-open]` | Open the Logics browser/focus viewer by delegating to `logics-manager view`; all viewer flags are forwarded; JSON mode reports diagnostics without launching it |
 | `cdx update [--check] [--yes] [--json] [--version TAG]` | Update cdx-manager using the installer that matches how it was installed |

package/changelogs/CHANGELOGS_0_12_2.md

@@ -0,0 +1,28 @@
+# CDX Manager 0.12.2
+
+## Highlights
+
+- `cdx ready` now exits successfully when no future reset is known, clearly reporting that no notification was scheduled.
+- `cdx doctor` can filter diagnostics by severity with `--severity OK|WARN|FAIL`.
+- Unknown `cdx config <name>` sessions now explain how to inspect existing sessions or create the requested one.
+
+## Changes
+
+### Safer ready notifications
+
+When `cdx ready` cannot find an upcoming session reset, it returns a successful unscheduled result instead of failing. Named reset notifications with no known reset remain explicit errors.
+
+### Filterable diagnostics
+
+`cdx doctor --severity` accepts a comma-separated list of `OK`, `WARN`, and `FAIL` statuses. Text and JSON output retain accurate summaries for the filtered report.
+
+### Actionable configuration errors
+
+Unknown-session errors from `cdx config` now direct users to `cdx configs` to inspect available sessions and `cdx add <name>` to create one.
+
+## Validation
+
+- `npm run lint`
+- `npm test`
+- `logics-manager lint --require-status`
+- `logics-manager audit --group-by-doc`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdx-manager",
-  "version": "0.12.1",
+  "version": "0.12.2",
   "description": "Terminal session manager for Codex and Claude accounts.",
   "license": "MIT",
   "author": "Alexandre Agostini",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cdx-manager"
-version = "0.12.1"
+version = "0.12.2"
 description = "Terminal session manager for Codex and Claude accounts."
 readme = "README.md"
 requires-python = ">=3.9"

package/src/cli.py

@@ -78,7 +78,7 @@ from .status_view import (
 )
 from .update_check import check_for_update, check_logics_manager_for_update
 
-VERSION = "0.12.1"
+VERSION = "0.12.2"
 
 # Public surface: this module is a facade. Names below are imported above
 # purely to be re-exported (consumed by tests and external callers); listing
@@ -216,7 +216,7 @@ def _print_help(use_color=False):
         f"  {_style('cdx clean profiles (--tmp|--old-logs DAYS) [--yes] [--json]', '36', use_color)}",
         f"  {_style('cdx export <file> [--include-auth] [--sessions a,b] [--passphrase-env VAR|--passphrase-stdin] [--force] [--json]', '36', use_color)}",
         f"  {_style('cdx import <file> [--sessions a,b] [--passphrase-env VAR|--passphrase-stdin] [--force|--merge] [--json]', '36', use_color)}",
-        f"  {_style('cdx doctor [--json]', '36', use_color)}",
+        f"  {_style('cdx doctor [--severity OK|WARN|FAIL[,OK|WARN|FAIL...]] [--json]', '36', use_color)}",
         f"  {_style('cdx repair [--dry-run] [--force] [--json]', '36', use_color)}",
         f"  {_style('cdx view [--json]', '36', use_color)}",
         f"  {_style('cdx update [all] [--check] [--yes] [--json] [--version TAG]', '36', use_color)}",

package/src/cli_args.py

@@ -12,7 +12,7 @@ from .errors import CdxError
 from .provider_runtime import _normalize_reasoning_effort
 
 STATUS_USAGE = "Usage: cdx status [--json] [--refresh|--cached] [--timeout SECONDS] | cdx status --small|-s [--refresh|--cached] [--timeout SECONDS] | cdx status <name> [--json] [--refresh|--cached] [--timeout SECONDS]"
-DOCTOR_USAGE = "Usage: cdx doctor [--json]"
+DOCTOR_USAGE = "Usage: cdx doctor [--severity OK|WARN|FAIL[,OK|WARN|FAIL...]] [--json]"
 DISK_USAGE = "Usage: cdx disk [profiles] [--candidates] [--json]"
 REPAIR_USAGE = "Usage: cdx repair [--dry-run] [--force] [--json]"
 UPDATE_USAGE = "Usage: cdx update [all] [--check] [--yes] [--json] [--version TAG]"
@@ -46,6 +46,35 @@ def _parse_json_flag(args):
     return json_flag, cleaned
 
 
+def _parse_doctor_args(args):
+    parsed = {"json": False, "severity": None}
+    index = 0
+    while index < len(args):
+        arg = args[index]
+        if arg == "--json":
+            parsed["json"] = True
+            index += 1
+            continue
+        if arg == "--severity":
+            if parsed["severity"] is not None or index + 1 >= len(args):
+                raise CdxError(DOCTOR_USAGE)
+            value = args[index + 1]
+            index += 2
+        elif arg.startswith("--severity="):
+            if parsed["severity"] is not None:
+                raise CdxError(DOCTOR_USAGE)
+            value = arg.split("=", 1)[1]
+            index += 1
+        else:
+            raise CdxError(DOCTOR_USAGE)
+
+        values = [item.strip().upper() for item in value.split(",")]
+        if not values or any(item not in {"OK", "WARN", "FAIL"} for item in values):
+            raise CdxError(DOCTOR_USAGE)
+        parsed["severity"] = ",".join(dict.fromkeys(values))
+    return parsed
+
+
 def _parse_flag_args(args, schema, usage, positionals_key=None, max_positionals=0):
     parsed = {spec["key"]: spec.get("default") for spec in schema.values()}
     positionals = []

package/src/cli_commands.py

@@ -17,7 +17,6 @@ from .cli_args import (
     CAN_RESUME_USAGE,
     CONTEXT_USAGE,
     DISK_USAGE,
-    DOCTOR_USAGE,
     HANDOFF_USAGE,
     LAST_USAGE,
     MEMORY_USAGE,
@@ -33,6 +32,7 @@ from .cli_args import (
     _parse_config_args,
     _parse_configs_args,
     _parse_copy_args,
+    _parse_doctor_args,
     _parse_export_args,
     _parse_flag_args,
     _parse_history_args,
@@ -98,7 +98,7 @@ from .context_store import (
 )
 from .errors import CdxError
 from .fs_utils import atomic_write
-from .health import collect_health_report, format_health_report
+from .health import collect_health_report, filter_health_report, format_health_report
 from .notify import (
     format_notify_event,
     format_scheduled_notification,
@@ -1700,7 +1700,10 @@ def handle_config(rest, ctx):
     parsed = _parse_config_args(rest)
     session = ctx["service"]["get_session"](parsed["name"])
     if not session:
-        raise CdxError(f"Unknown session: {parsed['name']}")
+        raise CdxError(
+            f"Unknown session: {parsed['name']}. Run cdx configs to inspect existing sessions or "
+            f"cdx add {parsed['name']} to create it."
+        )
     message = f"Launch settings for {parsed['name']}"
     if parsed["json"]:
         _write_json(ctx, _json_success("config", message, session=session, launch=session.get("launch") or {}))
@@ -1893,17 +1896,15 @@ def handle_clean(rest, ctx):
 
 
 def handle_doctor(rest, ctx):
-    json_flag = "--json" in rest
-    unknown = [arg for arg in rest if arg != "--json"]
-    if unknown:
-        raise CdxError(DOCTOR_USAGE)
+    parsed = _parse_doctor_args(rest)
     report = collect_health_report(
         ctx["service"],
         ctx["service"]["base_dir"],
         env=ctx.get("env"),
         spawn_sync=ctx.get("spawn_sync"),
     )
-    if json_flag:
+    report = filter_health_report(report, parsed["severity"])
+    if parsed["json"]:
         _write_json(ctx, _json_success("doctor", "Collected health report", report=report))
     else:
         ctx["out"](f"{format_health_report(report, use_color=ctx['use_color'])}\n")

package/src/health.py

@@ -363,6 +363,19 @@ def summarize_health(issues):
     }
 
 
+def filter_health_report(report, severity):
+    if severity is None:
+        return report
+    severities = set(severity.split(","))
+    issues = [issue for issue in report["issues"] if issue["status"] in severities]
+    return {
+        **report,
+        "issues": issues,
+        "summary": summarize_health(issues),
+        "severity": severity,
+    }
+
+
 def format_health_report(report, use_color=False):
     rows = [["STATUS", "CHECK", "MESSAGE"]]
     for issue in report["issues"]:

package/src/notify.py

@@ -221,6 +221,13 @@ def schedule_notification_event(base_dir, parsed, event, spawn_sync=None, env=No
     now_fn = now_fn or time.time
     target_timestamp = event.get("target_timestamp")
     if target_timestamp is None:
+        if parsed["mode"] == "next-ready":
+            return {
+                "scheduled": False,
+                "backend": "none",
+                "message": event["message"],
+                "target_timestamp": None,
+            }
         raise CdxError(f"Cannot schedule notification: {event['message']}")
     if target_timestamp <= now_fn():
         return {