forgexa-cli 1.16.3__tar.gz → 1.16.5__tar.gz

{forgexa_cli-1.16.3 → forgexa_cli-1.16.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forgexa-cli
-Version: 1.16.3
+Version: 1.16.5
 Summary: Forgexa CLI — command-line client and AI agent runtime for the Forgexa platform
 Author-email: Jason Sun <dev.winds@gmail.com>
 License-Expression: MIT
@@ -127,10 +127,11 @@ The command detects how `forgexa-cli` was installed:
 
 - `pipx` install: uses `pipx upgrade forgexa-cli`, or `pipx install --force forgexa-cli==<version>` for a pinned version
 - `pip` install: uses `python -m pip install --upgrade forgexa-cli`
+- non-editable local path install (`pip install /path/to/cli`): follows the same `pip` upgrade path and switches to the published PyPI release
 
-For safety, `forgexa upgrade` stops any running local daemon before upgrading. Restart it afterward with `forgexa daemon start`.
+For safety, `forgexa upgrade` stops any running local daemon before upgrading. If the daemon was previously started in background mode, the CLI starts it again automatically after a successful upgrade; otherwise it prints a manual restart hint.
 
-`forgexa upgrade` is intended for standard PyPI / pipx installs. Editable installs, local path installs, and VCS installs are rejected with a manual upgrade hint.
+`forgexa upgrade` supports standard PyPI / pipx installs and non-editable local path installs. Editable installs, VCS installs, and other direct URL installs are rejected with a manual upgrade hint.
 
 ## Configuration
 

{forgexa_cli-1.16.3 → forgexa_cli-1.16.5}/README.md

@@ -95,10 +95,11 @@ The command detects how `forgexa-cli` was installed:
 
 - `pipx` install: uses `pipx upgrade forgexa-cli`, or `pipx install --force forgexa-cli==<version>` for a pinned version
 - `pip` install: uses `python -m pip install --upgrade forgexa-cli`
+- non-editable local path install (`pip install /path/to/cli`): follows the same `pip` upgrade path and switches to the published PyPI release
 
-For safety, `forgexa upgrade` stops any running local daemon before upgrading. Restart it afterward with `forgexa daemon start`.
+For safety, `forgexa upgrade` stops any running local daemon before upgrading. If the daemon was previously started in background mode, the CLI starts it again automatically after a successful upgrade; otherwise it prints a manual restart hint.
 
-`forgexa upgrade` is intended for standard PyPI / pipx installs. Editable installs, local path installs, and VCS installs are rejected with a manual upgrade hint.
+`forgexa upgrade` supports standard PyPI / pipx installs and non-editable local path installs. Editable installs, VCS installs, and other direct URL installs are rejected with a manual upgrade hint.
 
 ## Configuration
 

{forgexa_cli-1.16.3 → forgexa_cli-1.16.5}/forgexa_cli/__init__.py

@@ -1,2 +1,2 @@
 """forgexa-cli — Forgexa command-line client."""
-__version__ = "1.16.3"
+__version__ = "1.16.5"

{forgexa_cli-1.16.3 → forgexa_cli-1.16.5}/forgexa_cli/daemon.py

@@ -523,7 +523,7 @@ except (ImportError, ModuleNotFoundError):
 # DAEMON_VERSION is the protocol/logic version of the daemon code.
 # Kept in sync with pyproject.toml version via bump-version.sh.
 # CLIENT_TYPE identifies which packaging/distribution this daemon runs in.
-DAEMON_VERSION = "1.16.3"
+DAEMON_VERSION = "1.16.5"
 
 
 def _detect_client_type() -> str:

{forgexa_cli-1.16.3 → forgexa_cli-1.16.5}/forgexa_cli/main.py

@@ -402,7 +402,7 @@ def _unsupported_upgrade_source(direct_url: dict | None) -> str | None:
         return f"{vcs} checkout"
     url = str(direct_url.get("url") or "").strip()
     if url.startswith("file:"):
-        return "local path install"
+        return None
     if url:
         return "direct URL install"
     return "non-standard install source"
@@ -694,6 +694,62 @@ def _stop_daemon_if_running() -> tuple[bool, int | None]:
     return True, pid
 
 
+_DAEMON_START_CONTEXT_PATH: Path = Path.home() / ".forgexa" / "daemon" / "start-context.json"
+
+
+def _write_daemon_start_context(*, mode: str, server_url: str | None) -> None:
+    try:
+        _DAEMON_START_CONTEXT_PATH.parent.mkdir(parents=True, exist_ok=True)
+        _DAEMON_START_CONTEXT_PATH.write_text(
+            json.dumps(
+                {
+                    "mode": mode,
+                    "server_url": (server_url or "").rstrip("/") or None,
+                }
+            )
+        )
+    except Exception:
+        pass
+
+
+def _read_daemon_start_context() -> dict[str, str] | None:
+    try:
+        payload = json.loads(_DAEMON_START_CONTEXT_PATH.read_text())
+    except Exception:
+        return None
+    if not isinstance(payload, dict):
+        return None
+    mode = str(payload.get("mode") or "").strip()
+    server_url = str(payload.get("server_url") or "").strip().rstrip("/")
+    result: dict[str, str] = {}
+    if mode:
+        result["mode"] = mode
+    if server_url:
+        result["server_url"] = server_url
+    return result or None
+
+
+def _start_daemon_after_upgrade() -> tuple[bool, str | None]:
+    context = _read_daemon_start_context() or {}
+    if context.get("mode") != "background":
+        return False, None
+
+    server_url = context.get("server_url") or None
+    try:
+        cmd_daemon_start(
+            argparse.Namespace(
+                detach=True,
+                server_url=server_url,
+            )
+        )
+    except SystemExit as exc:
+        return False, f"Auto-restart failed with exit code {exc.code}."
+    except Exception as exc:
+        return False, str(exc)
+
+    return True, server_url
+
+
 def _request_json(
     path: str,
     *,
@@ -1120,6 +1176,11 @@ def cmd_daemon_start(args: argparse.Namespace) -> None:
     if token:
         os.environ.setdefault("DAEMON_API_TOKEN", token)
 
+    _write_daemon_start_context(
+        mode="background" if getattr(args, "detach", False) else "foreground",
+        server_url=server_url,
+    )
+
     if getattr(args, "detach", False):
         # ── Background (detach) mode ─────────────────────────────────────────
         import subprocess as sp
@@ -1500,7 +1561,13 @@ def cmd_upgrade(args: argparse.Namespace) -> None:
     installed_version = _installed_cli_version() or "unknown"
     print(f"Upgrade complete. Installed version: {installed_version}")
     if daemon_stopped:
-        print("Restart the daemon with: forgexa daemon start")
+        restarted, server_url = _start_daemon_after_upgrade()
+        if restarted:
+            print("Daemon restarted in background.")
+            if server_url:
+                print(f"  Server : {server_url}")
+        else:
+            print("Restart the daemon with: forgexa daemon start")
 
 
 # ── Argument parser ──
@@ -1751,10 +1818,6 @@ def main() -> None:
     _output_format = args.format or "table"
 
     cmd = args.command
-    if not cmd:
-        parser.print_help()
-        return
-
     # Start background update-check now (writes cache if stale; zero latency).
     # Skip for `upgrade` (user is already updating) and raw log tailing
     # (`daemon logs -f` / `logs -f`) which never returns.
@@ -1765,6 +1828,11 @@ def main() -> None:
     if not _skip_update_check:
         _launch_update_check_process()
 
+    if not cmd:
+        parser.print_help()
+        _print_update_notice_if_available()
+        return
+
     dispatch: dict = {
         "version": cmd_version,
         "upgrade": cmd_upgrade,

{forgexa_cli-1.16.3 → forgexa_cli-1.16.5}/forgexa_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forgexa-cli
-Version: 1.16.3
+Version: 1.16.5
 Summary: Forgexa CLI — command-line client and AI agent runtime for the Forgexa platform
 Author-email: Jason Sun <dev.winds@gmail.com>
 License-Expression: MIT
@@ -127,10 +127,11 @@ The command detects how `forgexa-cli` was installed:
 
 - `pipx` install: uses `pipx upgrade forgexa-cli`, or `pipx install --force forgexa-cli==<version>` for a pinned version
 - `pip` install: uses `python -m pip install --upgrade forgexa-cli`
+- non-editable local path install (`pip install /path/to/cli`): follows the same `pip` upgrade path and switches to the published PyPI release
 
-For safety, `forgexa upgrade` stops any running local daemon before upgrading. Restart it afterward with `forgexa daemon start`.
+For safety, `forgexa upgrade` stops any running local daemon before upgrading. If the daemon was previously started in background mode, the CLI starts it again automatically after a successful upgrade; otherwise it prints a manual restart hint.
 
-`forgexa upgrade` is intended for standard PyPI / pipx installs. Editable installs, local path installs, and VCS installs are rejected with a manual upgrade hint.
+`forgexa upgrade` supports standard PyPI / pipx installs and non-editable local path installs. Editable installs, VCS installs, and other direct URL installs are rejected with a manual upgrade hint.
 
 ## Configuration
 

{forgexa_cli-1.16.3 → forgexa_cli-1.16.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "forgexa-cli"
-version = "1.16.3"
+version = "1.16.5"
 description = "Forgexa CLI — command-line client and AI agent runtime for the Forgexa platform"
 requires-python = ">=3.9"
 license = "MIT"

{forgexa_cli-1.16.3 → forgexa_cli-1.16.5}/tests/test_auth_and_runtime_commands.py

@@ -266,6 +266,29 @@ def test_launch_update_check_process_spawns_background_python_when_cache_is_stal
     assert kwargs["stderr"] is main.subprocess.DEVNULL
 
 
+def test_main_without_command_still_runs_update_notice_flow(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    calls: list[str] = []
+
+    monkeypatch.setattr(main.sys, "argv", ["forgexa"])
+    monkeypatch.setattr(
+        main,
+        "_launch_update_check_process",
+        lambda: calls.append("launch"),
+    )
+    monkeypatch.setattr(
+        main,
+        "_print_update_notice_if_available",
+        lambda: calls.append("notice"),
+    )
+
+    with contextlib.redirect_stdout(io.StringIO()):
+        main.main()
+
+    assert calls == ["launch", "notice"]
+
+
 def test_build_upgrade_plan_for_pipx_latest(monkeypatch: pytest.MonkeyPatch) -> None:
     monkeypatch.setattr(main, "_cli_distribution", lambda: SimpleNamespace(version="1.12.3"))
     monkeypatch.setattr(main, "_distribution_root", lambda dist: Path("/installed/site-packages"))
@@ -339,6 +362,41 @@ def test_build_upgrade_plan_adds_break_system_packages_on_pep668(monkeypatch: py
     assert plan.command[-1] == "forgexa-cli"
 
 
+def test_build_upgrade_plan_allows_non_editable_local_path_installs(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setattr(main, "_cli_distribution", lambda: SimpleNamespace(version="1.15.7"))
+    monkeypatch.setattr(
+        main,
+        "_distribution_root",
+        lambda dist: Path("/home/demo/.local/lib/python3.12/site-packages"),
+    )
+    monkeypatch.setattr(main, "_running_from_distribution_root", lambda root: True)
+    monkeypatch.setattr(
+        main,
+        "_direct_url_metadata",
+        lambda dist: {"dir_info": {}, "url": "file:///opt/forgexa/cli"},
+    )
+    monkeypatch.setattr(main, "_looks_like_pipx_environment", lambda python=None: False)
+    monkeypatch.setattr(main.importlib.util, "find_spec", lambda name: object() if name == "pip" else None)
+    monkeypatch.setattr(main, "_is_user_site_install", lambda root: True)
+    monkeypatch.setattr(main, "_is_virtualenv", lambda: False)
+    monkeypatch.setattr(main, "_is_pep668_environment", lambda: True)
+    monkeypatch.setattr(main.sys, "executable", "/usr/bin/python3")
+
+    plan = main._build_upgrade_plan(None)
+
+    assert plan.installer == "pip"
+    assert plan.command == [
+        "/usr/bin/python3",
+        "-m",
+        "pip",
+        "install",
+        "--upgrade",
+        "--user",
+        "--break-system-packages",
+        "forgexa-cli",
+    ]
+
+
 def test_pep668_detection_returns_false_in_normal_venv(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
     monkeypatch.setattr(main.sys, "prefix", str(tmp_path))
     import sysconfig as _sc
@@ -378,6 +436,7 @@ def test_cmd_upgrade_runs_planned_command(monkeypatch: pytest.MonkeyPatch) -> No
     monkeypatch.setattr(main, "_normalize_target_version", lambda value: value)
     monkeypatch.setattr(main, "_stop_daemon_if_running", lambda: (False, None))
     monkeypatch.setattr(main, "_installed_cli_version", lambda: "1.12.3")
+    monkeypatch.setattr(main, "_start_daemon_after_upgrade", lambda: (False, None))
 
     def fake_run(cmd):
         calls.append(cmd)
@@ -394,6 +453,64 @@ def test_cmd_upgrade_runs_planned_command(monkeypatch: pytest.MonkeyPatch) -> No
     assert "Upgrade complete. Installed version: 1.12.3" in output
 
 
+def test_cmd_upgrade_restarts_background_daemon_after_success(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    plan = main.UpgradePlan(
+        installer="pip",
+        command=["python3", "-m", "pip", "install", "--upgrade", "forgexa-cli"],
+        current_version="1.16.3",
+        target_version=None,
+    )
+    start_calls: list[bool] = []
+
+    monkeypatch.setattr(main, "_build_upgrade_plan", lambda target: plan)
+    monkeypatch.setattr(main, "_normalize_target_version", lambda value: value)
+    monkeypatch.setattr(main, "_stop_daemon_if_running", lambda: (True, 4242))
+    monkeypatch.setattr(main, "_installed_cli_version", lambda: "1.16.4")
+    monkeypatch.setattr(main.subprocess, "run", lambda cmd: SimpleNamespace(returncode=0))
+    monkeypatch.setattr(
+        main,
+        "_start_daemon_after_upgrade",
+        lambda: start_calls.append(True) or (True, "https://api.example.com"),
+    )
+
+    buffer = io.StringIO()
+    with contextlib.redirect_stdout(buffer):
+        main.cmd_upgrade(SimpleNamespace(target_version=None))
+
+    output = buffer.getvalue()
+    assert start_calls == [True]
+    assert "Stopped local daemon (PID 4242) before upgrade." in output
+    assert "Daemon restarted in background." in output
+    assert "Server : https://api.example.com" in output
+
+
+def test_cmd_upgrade_keeps_manual_restart_hint_when_auto_restart_skips(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    plan = main.UpgradePlan(
+        installer="pip",
+        command=["python3", "-m", "pip", "install", "--upgrade", "forgexa-cli"],
+        current_version="1.16.3",
+        target_version=None,
+    )
+
+    monkeypatch.setattr(main, "_build_upgrade_plan", lambda target: plan)
+    monkeypatch.setattr(main, "_normalize_target_version", lambda value: value)
+    monkeypatch.setattr(main, "_stop_daemon_if_running", lambda: (True, 4242))
+    monkeypatch.setattr(main, "_installed_cli_version", lambda: "1.16.4")
+    monkeypatch.setattr(main.subprocess, "run", lambda cmd: SimpleNamespace(returncode=0))
+    monkeypatch.setattr(main, "_start_daemon_after_upgrade", lambda: (False, None))
+
+    buffer = io.StringIO()
+    with contextlib.redirect_stdout(buffer):
+        main.cmd_upgrade(SimpleNamespace(target_version=None))
+
+    output = buffer.getvalue()
+    assert "Restart the daemon with: forgexa daemon start" in output
+
+
 def test_cmd_upgrade_noops_when_target_matches_current(monkeypatch: pytest.MonkeyPatch) -> None:
     plan = main.UpgradePlan(
         installer="pip",