cdx-manager 0.9.0 → 0.9.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.8.0-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.9.1-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.**
 
@@ -42,7 +42,7 @@ One command to launch any session. Zero auth juggling.
 - **Persistent launch settings.** Pin per-session power, permission, and fast-mode preferences once; `cdx` reapplies them on every launch until you unset them.
 - **Launch history.** Inspect recent launches with provider, result, duration, working directory, launch settings, and transcript path.
 - **Update prompts.** Periodic update checks surface `cdx update` directly in the `cdx`, `cdx status`, and launch output when a newer release is available. When `logics-manager` is installed, `cdx` can also suggest `logics-manager self-update`.
-- **Logics viewer shortcut.** `cdx view` opens the Logics browser/focus viewer through `logics-manager view` when the companion CLI is installed; `cdx view --json` reports availability and update diagnostics without opening the viewer.
+- **Logics viewer shortcut.** `cdx view` opens the Logics browser/focus viewer through `logics-manager view` when the companion CLI is installed. All viewer flags are forwarded: `--lan`, `--lan-rw`, `--focus <ref>`, `--read`, `--port`, `--host`, `--refresh-interval`, `--tls`, `--tls-cert`, `--tls-key`, `--open`, `--no-open`. `cdx view --json` reports availability and update diagnostics without opening the viewer.
 - **Shared handoff context.** Keep a per-workspace Markdown context, or build one from a source session transcript, and install it into another assistant session before switching providers or accounts.
 - **Passive status resolution.** Codex status is read from the local Codex app-server rate-limit API when available, with legacy transcript/history parsing kept as a fallback.
 - **Session transcript capture.** Every launch is recorded to a local log file via `script`, giving you a full terminal transcript for each session.
@@ -352,7 +352,7 @@ cdx history --summary --from 2026-05-01 --to 2026-05-28
 | `cdx import <file> [--sessions a,b] [--passphrase-env VAR] [--force] [--json]` | Import sessions from a bundle into the current `CDX_HOME` |
 | `cdx doctor [--json]` | Inspect CLI dependencies, CDX_HOME permissions, missing state, orphan profiles, and pending quarantines |
 | `cdx repair [--dry-run] [--force] [--json]` | Plan or apply safe repairs for missing state files, quarantines, and orphan profiles |
-| `cdx view [--json]` | Open the Logics browser/focus viewer by delegating to `logics-manager view`; JSON mode reports diagnostics without launching it |
+| `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 |
 | `cdx ready [--refresh] [--json]` | Schedule an OS notification for the next cooling-down assistant that becomes ready, then return immediately |
 | `cdx notify <name> --at-reset [--poll seconds] [--once] [--schedule] [--refresh] [--json]` | Wait for a session reset time or schedule an OS wake-up notification when due |

package/changelogs/CHANGELOGS_0_9_1.md

@@ -0,0 +1,36 @@
+# CDX Manager 0.9.1
+
+## Highlights
+
+- `cdx view` now forwards all `logics-manager view` flags instead of rejecting them.
+- Fixes a silent PATH resolution bug that could prevent `logics-manager` from being found.
+
+## Changes
+
+### cdx view: full flag passthrough
+
+`cdx view` previously accepted only `--json` and raised a usage error for every other argument. All `logics-manager view` flags are now supported and forwarded transparently:
+
+- `--lan` / `--lan-rw` — expose the viewer on the local network
+- `--focus <ref>` / `--read` — open the viewer centered on a workflow document
+- `--port <port>` / `--host <host>` — bind to a custom address
+- `--refresh-interval <s>` — override the auto-refresh interval
+- `--tls` / `--tls-cert <path>` / `--tls-key <path>` — serve over HTTPS
+- `--open` / `--no-open` — control browser auto-open
+
+### Bug fixes
+
+- `resolve_logics_manager`: `shutil.which` was called with `path=""` when `env` had no `PATH` key, causing it to search nothing and always return `None`. Now falls back to the process PATH.
+- `run_logics_viewer`: the viewer subprocess now inherits the full OS environment (`os.environ` merged with any `env` overrides) instead of receiving a partial dict that stripped all inherited variables.
+
+### Docs
+
+- README command table and feature description updated to list all forwarded viewer flags.
+- `LOGICS_PROMPT` updated to reference `cdx view` instead of `logics-manager view` directly.
+
+## Validation
+
+- `npm run prepublishOnly`
+- `npm pack --dry-run`
+- `logics-manager lint --require-status`
+- `logics-manager audit --legacy-cutoff-version 1.1.0 --group-by-doc`

package/changelogs/CHANGELOGS_0_9_2.md

@@ -0,0 +1,33 @@
+# CDX Manager 0.9.2
+
+## Highlights
+
+- `cdx import` gains a `--merge` flag to fill in missing data without overwriting what already exists locally.
+- npm and PyPI publication workflows now verify that the release tag's commit has a successful `CI` run before any registry upload step.
+
+## Changes
+
+### cdx import: `--merge` mode
+
+`cdx import` previously offered two stances on existing sessions: reject the conflict (default) or erase and replace (`--force`). A third mode is now available:
+
+```
+cdx import backup.cdx --merge
+```
+
+With `--merge`, for each session that already exists locally:
+
+- **Session fields** — existing values are kept; fields absent locally are pulled in from the bundle.
+- **Session state** — same merge rule: local data wins, bundle fills the gaps.
+- **Profile files** (auth.json, credentials, etc.) — files that already exist on disk are left untouched; files missing locally are restored from the bundle.
+- **New sessions** in the bundle that have no local counterpart are imported normally.
+
+`--force` and `--merge` are mutually exclusive and raise a clear error if combined.
+
+## Validation
+
+- `npm run prepublishOnly`
+- `npm pack --dry-run`
+- `python -m unittest discover -s test -p 'test_release_ci_py.py'`
+- `logics-manager lint --require-status`
+- `logics-manager audit --legacy-cutoff-version 1.1.0 --group-by-doc`

package/checksums/release-archives.json

@@ -64,6 +64,14 @@
     "v0.8.0": {
       "github_tarball_sha256": "62cd461f9e22636bb85d801e21209b1762859b6662623e74c01fd40c107ea29a",
       "github_zip_sha256": "4674c8b61110f52b99c76312e9962202a2e8fc6928327f8927781f45eeaa980f"
+    },
+    "v0.9.0": {
+      "github_tarball_sha256": "809af5746e1287f4c5dc7a2fb7583e67e212aa250c45be905c32374e5dee26d6",
+      "github_zip_sha256": "9118f81645c00a4a660923a1ae290f48bd458af7ebfcf9f6580a3b91023b7c76"
+    },
+    "v0.9.1": {
+      "github_tarball_sha256": "8cbab620c823aeaf56e72c1a4d20e251a1c7142bfeeb3d516321d59c2c0a621d",
+      "github_zip_sha256": "253909ede6dca61937835bd4ee29145ddacaa08fbdfba1b39810da73ae2ccc84"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdx-manager",
-  "version": "0.9.0",
+  "version": "0.9.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.9.0"
+version = "0.9.2"
 description = "Terminal session manager for Codex and Claude accounts."
 readme = "README.md"
 requires-python = ">=3.9"

package/src/cli.py

@@ -64,7 +64,7 @@ from .status_view import (
 )
 from .update_check import check_for_update, check_logics_manager_for_update
 
-VERSION = "0.9.0"
+VERSION = "0.9.2"
 
 
 # ---------------------------------------------------------------------------
@@ -108,7 +108,7 @@ def _print_help(use_color=False):
         f"  {_style('cdx rmv <name> [--force] [--json]', '36', use_color)}",
         f"  {_style('cdx clean [name] [--json]', '36', use_color)}",
         f"  {_style('cdx export <file> [--include-auth] [--sessions a,b] [--passphrase-env VAR] [--force] [--json]', '36', use_color)}",
-        f"  {_style('cdx import <file> [--sessions a,b] [--passphrase-env VAR] [--force] [--json]', '36', use_color)}",
+        f"  {_style('cdx import <file> [--sessions a,b] [--passphrase-env VAR] [--force|--merge] [--json]', '36', use_color)}",
         f"  {_style('cdx doctor [--json]', '36', use_color)}",
         f"  {_style('cdx repair [--dry-run] [--force] [--json]', '36', use_color)}",
         f"  {_style('cdx view [--json]', '36', use_color)}",

package/src/cli_commands.py

@@ -55,7 +55,7 @@ DOCTOR_USAGE = "Usage: cdx doctor [--json]"
 REPAIR_USAGE = "Usage: cdx repair [--dry-run] [--force] [--json]"
 UPDATE_USAGE = "Usage: cdx update [--check] [--yes] [--json] [--version TAG]"
 EXPORT_USAGE = "Usage: cdx export <file> [--include-auth] [--force] [--json] [--sessions name1,name2] [--passphrase-env VAR]"
-IMPORT_USAGE = "Usage: cdx import <file> [--force] [--json] [--sessions name1,name2] [--passphrase-env VAR]"
+IMPORT_USAGE = "Usage: cdx import <file> [--force|--merge] [--json] [--sessions name1,name2] [--passphrase-env VAR]"
 CONTEXT_USAGE = "Usage: cdx context show|path|init|edit|clear|set [text...] [--json]"
 HANDOFF_USAGE = "Usage: cdx handoff <name> [--json] | cdx handoff <source> <target> [--json]"
 SET_USAGE = "Usage: cdx set <name>|--sessions all|a,b|--provider PROVIDER [--power low|medium|high|xhigh|max] [--permission review|default|auto|full] [--fast on|off] [--rtk on|off] [--logics on|off] [--model MODEL] [--priority 0..100] [--json]"
@@ -1000,6 +1000,7 @@ def _parse_export_args(args):
 def _parse_import_args(args):
     parsed = _parse_flag_args(args, {
         "--force": {"key": "force", "type": "bool", "default": False},
+        "--merge": {"key": "merge", "type": "bool", "default": False},
         "--json": {"key": "json", "type": "bool", "default": False},
         "--sessions": {
             "key": "session_names",
@@ -1012,6 +1013,8 @@ def _parse_import_args(args):
     parsed["file_path"] = parsed.pop("positionals")[0] if parsed["positionals"] else None
     if not parsed["file_path"]:
         raise CdxError(IMPORT_USAGE)
+    if parsed["force"] and parsed["merge"]:
+        raise CdxError("--force and --merge are mutually exclusive.")
     return parsed
 
 
@@ -2643,6 +2646,7 @@ def handle_import(rest, ctx):
         passphrase=passphrase,
         session_names=parsed["session_names"],
         force=parsed["force"],
+        merge=parsed["merge"],
     )
     session_count = len(result["session_names"])
     auth_suffix = " with auth" if result["include_auth"] else ""

package/src/cli_view.py

@@ -12,7 +12,7 @@ from .logics_view import (
 from .update_check import check_logics_manager_for_update
 
 
-VIEW_USAGE = "Usage: cdx view [--json]"
+VIEW_USAGE = "Usage: cdx view [--json] [--lan] [--lan-rw] [--focus <ref>] [--read] [--port <port>] [--host <host>] [--refresh-interval <s>] [--tls] [--open] [--no-open]"
 API_SCHEMA_VERSION = 1
 
 
@@ -67,18 +67,44 @@ def _logics_manager_update_notice(ctx, env):
     )
 
 
+_VIEWER_FLAGS = {
+    "--lan", "--lan-rw", "--tls", "--read", "--open", "--no-open",
+}
+_VIEWER_VALUE_FLAGS = {
+    "--host", "--port", "--tls-cert", "--tls-key", "--refresh-interval", "--focus",
+}
+
+
+def _parse_view_args(rest):
+    json_flag = False
+    viewer_args = []
+    i = 0
+    while i < len(rest):
+        arg = rest[i]
+        if arg == "--json":
+            json_flag = True
+        elif arg in _VIEWER_FLAGS:
+            viewer_args.append(arg)
+        elif arg in _VIEWER_VALUE_FLAGS:
+            if i + 1 >= len(rest):
+                raise CdxError(f"{arg} requires a value. {VIEW_USAGE}")
+            viewer_args.extend([arg, rest[i + 1]])
+            i += 1
+        else:
+            raise CdxError(f"Unknown option: {arg}\n{VIEW_USAGE}")
+        i += 1
+    return json_flag, viewer_args
+
+
 def handle_view(rest, ctx):
-    json_flag = "--json" in rest
-    unknown = [arg for arg in rest if arg != "--json"]
-    if unknown:
-        raise CdxError(VIEW_USAGE)
+    json_flag, viewer_args = _parse_view_args(rest)
 
     env = ctx.get("env")
     cwd = ctx.get("cwd")
     executable = resolve_logics_manager(env=env)
     update_notice = _logics_manager_update_notice(ctx, env) if executable else None
     failure = None if executable else missing_logics_manager_failure()
-    diagnostics = build_viewer_diagnostics(executable, cwd, update_notice=update_notice, failure=failure)
+    diagnostics = build_viewer_diagnostics(executable, cwd, update_notice=update_notice, failure=failure, extra_args=viewer_args)
     warnings = _update_notice_warnings([update_notice])
 
     if json_flag:
@@ -92,7 +118,7 @@ def handle_view(rest, ctx):
         ctx["out"](f"{_warn(warning['message'], ctx['use_color'])}\n")
 
     try:
-        result = run_logics_viewer(executable, cwd, env=env, runner=ctx.get("spawn_sync"))
+        result = run_logics_viewer(executable, cwd, env=env, extra_args=viewer_args, runner=ctx.get("spawn_sync"))
     except FileNotFoundError as error:
         raise CdxError(f"logics-manager is required for cdx view. {LOGICS_MANAGER_INSTALL_HINT}") from error
     except KeyboardInterrupt:

package/src/logics_view.py

@@ -1,3 +1,4 @@
+import os
 import shutil
 import subprocess
 
@@ -7,11 +8,11 @@ LOGICS_MANAGER_INSTALL_HINT = "Install or update it with: npm install -g @grifhi
 
 def resolve_logics_manager(env=None):
     env = env or {}
-    return shutil.which("logics-manager", path=env.get("PATH", ""))
+    return shutil.which("logics-manager", path=env.get("PATH") or None)
 
 
-def build_viewer_diagnostics(executable, cwd, update_notice=None, failure=None):
-    command = [executable or "logics-manager", "view"]
+def build_viewer_diagnostics(executable, cwd, update_notice=None, failure=None, extra_args=None):
+    command = [executable or "logics-manager", "view"] + (extra_args or [])
     return {
         "available": bool(executable),
         "executable": executable,
@@ -29,9 +30,10 @@ def missing_logics_manager_failure():
     }
 
 
-def run_logics_viewer(executable, cwd, env=None, runner=None):
+def run_logics_viewer(executable, cwd, env=None, extra_args=None, runner=None):
     runner = runner or subprocess.run
-    argv = [executable, "view"]
+    argv = [executable, "view"] + (extra_args or [])
+    merged_env = {**os.environ, **(env or {})}
     if runner is subprocess.run:
-        return subprocess.run(argv, cwd=cwd, env=env)
-    return runner(argv, cwd=cwd, env=env)
+        return subprocess.run(argv, cwd=cwd, env=merged_env)
+    return runner(argv, cwd=cwd, env=merged_env)

package/src/provider_runtime.py

@@ -22,7 +22,7 @@ RTK_PROMPT = (
 LOGICS_PROMPT = (
     "When `logics-manager` is available, prefer it for Logics workflow operations: use "
     "`logics-manager status`, `health`, `audit`, and `lint` for workflow state and validation; "
-    "`logics-manager view` for the browser viewer and focus workflows; "
+    "`cdx view` for the browser viewer and focus workflows (supports `--lan`, `--focus <ref>`, `--port`, and all other viewer flags); "
     "`logics-manager sync read-doc|list-docs|search-docs|context-pack` for bounded document context; "
     "`logics-manager flow ...` for request/backlog/task lifecycle changes; and `logics-manager mcp ...` "
     "when an MCP surface is the right fit."

package/src/session_service.py

@@ -1173,7 +1173,7 @@ def create_session_service(options=None):
             "bundle_size_bytes": len(bundle_bytes),
         }
 
-    def import_bundle(file_path, passphrase=None, session_names=None, force=False):
+    def import_bundle(file_path, passphrase=None, session_names=None, force=False, merge=False):
         if not file_path or not os.path.isfile(file_path):
             raise CdxError(f"Bundle file not found: {file_path}")
         with open(file_path, "rb") as handle:
@@ -1193,15 +1193,18 @@ def create_session_service(options=None):
 
         existing = {session["name"] for session in list_sessions()}
         conflicts = [name for name in names if name in existing]
-        if conflicts and not force:
+        if conflicts and not force and not merge:
             raise CdxError(f"Import would overwrite existing sessions: {', '.join(conflicts)}")
 
         for session_payload in imported_sessions:
             name = session_payload["name"]
             _validate_new_session_name(name)
             provider = _normalize_provider(session_payload["provider"])
-            if name in existing:
+            is_existing = name in existing
+
+            if is_existing and force:
                 remove_session(name)
+                is_existing = False
 
             session_root = _get_session_root(name)
             auth_home = _get_session_auth_home(name, provider)
@@ -1210,18 +1213,38 @@ def create_session_service(options=None):
             _ensure_private_dir(session_root)
             _ensure_private_dir(auth_home)
 
-            session_record = {
-                **session_payload,
-                "provider": provider,
-                "enabled": session_payload.get("enabled", True) is not False,
-                "sessionRoot": session_root,
-                "authHome": auth_home,
-            }
-            store["replace_session"](name, session_record)
+            if is_existing and merge:
+                existing_record = store["get_session"](name) or {}
+                bundle_record = {
+                    **session_payload,
+                    "provider": provider,
+                    "enabled": session_payload.get("enabled", True) is not False,
+                    "sessionRoot": session_root,
+                    "authHome": auth_home,
+                }
+                # Existing values take precedence; bundle fills in missing keys only.
+                merged_record = {**bundle_record, **{k: v for k, v in existing_record.items() if v is not None}}
+                merged_record["sessionRoot"] = session_root
+                merged_record["authHome"] = auth_home
+                store["replace_session"](name, merged_record)
+            else:
+                session_record = {
+                    **session_payload,
+                    "provider": provider,
+                    "enabled": session_payload.get("enabled", True) is not False,
+                    "sessionRoot": session_root,
+                    "authHome": auth_home,
+                }
+                store["replace_session"](name, session_record)
 
             state = (payload.get("states") or {}).get(name)
             if state is not None:
-                store["write_session_state"](name, state)
+                if is_existing and merge:
+                    existing_state = store["read_session_state"](name) or {}
+                    merged_state = {**state, **{k: v for k, v in existing_state.items() if v is not None}}
+                    store["write_session_state"](name, merged_state)
+                else:
+                    store["write_session_state"](name, state)
 
             for item in (payload.get("profiles") or {}).get(name, []):
                 rel_path = _safe_relpath(item.get("path"))
@@ -1230,6 +1253,9 @@ def create_session_service(options=None):
                 except (AttributeError, ValueError, UnicodeEncodeError) as error:
                     raise CdxError(f"Bundle contains invalid file data for session {name}: {rel_path}") from error
                 dest_path = os.path.join(session_root, rel_path)
+                # In merge mode, skip files that already exist locally.
+                if is_existing and merge and os.path.exists(dest_path):
+                    continue
                 _ensure_private_dir(os.path.dirname(dest_path))
                 with open(dest_path, "wb") as handle:
                     handle.write(content)