forgexa-cli 1.47.3__tar.gz → 1.48.0__tar.gz

{forgexa_cli-1.47.3 → forgexa_cli-1.48.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forgexa-cli
-Version: 1.47.3
+Version: 1.48.0
 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
@@ -132,10 +132,16 @@ forgexa upgrade --target-version 1.12.3
 
 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`
+- `pipx` install: uses `pipx upgrade --index-url https://pypi.org/simple forgexa-cli`, or `pipx install --force --index-url https://pypi.org/simple forgexa-cli==<version>` for a pinned version
+- `pip` install: uses `python -m pip install --upgrade --index-url https://pypi.org/simple 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
 
+Self-upgrades pass `--index-url https://pypi.org/simple` to pip or pipx, matching the official PyPI release check and avoiding a configured mirror that has not yet synchronized a new release. A direct `pip install --upgrade forgexa-cli` command always follows that Python environment's pip configuration. When its mirror is behind, upgrade manually with:
+
+```bash
+python -m pip install --upgrade --index-url https://pypi.org/simple forgexa-cli==1.12.3
+```
+
 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` 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.

{forgexa_cli-1.47.3 → forgexa_cli-1.48.0}/README.md

@@ -100,10 +100,16 @@ forgexa upgrade --target-version 1.12.3
 
 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`
+- `pipx` install: uses `pipx upgrade --index-url https://pypi.org/simple forgexa-cli`, or `pipx install --force --index-url https://pypi.org/simple forgexa-cli==<version>` for a pinned version
+- `pip` install: uses `python -m pip install --upgrade --index-url https://pypi.org/simple 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
 
+Self-upgrades pass `--index-url https://pypi.org/simple` to pip or pipx, matching the official PyPI release check and avoiding a configured mirror that has not yet synchronized a new release. A direct `pip install --upgrade forgexa-cli` command always follows that Python environment's pip configuration. When its mirror is behind, upgrade manually with:
+
+```bash
+python -m pip install --upgrade --index-url https://pypi.org/simple forgexa-cli==1.12.3
+```
+
 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` 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.

{forgexa_cli-1.47.3 → forgexa_cli-1.48.0}/forgexa_cli/__init__.py

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

{forgexa_cli-1.47.3 → forgexa_cli-1.48.0}/forgexa_cli/agent_core.py

@@ -1616,14 +1616,74 @@ def build_opencode_command(
     return cmd
 
 
-def opencode_base_env(env: dict[str, str], *, data_home: str | Path) -> dict[str, str]:
-    """Isolate each opencode run in its own XDG data directory.
+def opencode_base_env(
+    env: dict[str, str], *, data_home: str | Path, require_windows_shell: bool = False,
+) -> dict[str, str]:
+    """Isolate each OpenCode run in its own XDG data directory.
 
     Prevents concurrent opencode processes from racing on the shared SQLite
     WAL file ('Failed to run the query PRAGMA wal_checkpoint(PASSIVE)').
     """
     env = dict(env)
     env["XDG_DATA_HOME"] = str(data_home)
+    return configure_opencode_windows_shell(env, required=require_windows_shell)
+
+
+def _find_opencode_windows_shell(env: dict[str, str]) -> str | None:
+    configured = env.get("OPENCODE_GIT_BASH_PATH", "").strip()
+    if configured and Path(configured).is_file():
+        return configured
+
+    git = shutil.which("git", path=env.get("PATH"))
+    if git:
+        git_path = Path(git)
+        for git_root in (git_path.parent.parent, git_path.parent.parent.parent):
+            git_bash = git_root / "bin" / "bash.exe"
+            if git_bash.is_file():
+                return str(git_bash)
+
+    return shutil.which("pwsh", path=env.get("PATH"))
+
+
+def configure_opencode_windows_shell(
+    env: dict[str, str], *, required: bool = False,
+) -> dict[str, str]:
+    """Force OpenCode off classic Windows PowerShell for agent tool calls."""
+    env = dict(env)
+    if sys.platform != "win32":
+        return env
+
+    shell = _find_opencode_windows_shell(env)
+    if not shell:
+        message = (
+            "OpenCode on Windows requires Git Bash or PowerShell 7 (pwsh) so "
+            "agent tool output is UTF-8. Install Git for Windows or PowerShell 7, "
+            "then retry or select another agent."
+        )
+        if required:
+            raise RuntimeError(message)
+        logger.warning(message)
+        return env
+
+    raw_config = env.get("OPENCODE_CONFIG_CONTENT", "").strip()
+    config: dict[str, Any] = {}
+    if raw_config:
+        try:
+            parsed = json.loads(raw_config)
+        except json.JSONDecodeError as exc:
+            raise RuntimeError(
+                "OPENCODE_CONFIG_CONTENT must be a JSON object to configure "
+                "OpenCode's Windows tool shell."
+            ) from exc
+        if not isinstance(parsed, dict):
+            raise RuntimeError(
+                "OPENCODE_CONFIG_CONTENT must be a JSON object to configure "
+                "OpenCode's Windows tool shell."
+            )
+        config = parsed
+
+    config["shell"] = shell
+    env["OPENCODE_CONFIG_CONTENT"] = json.dumps(config, ensure_ascii=False)
     return env