forgexa-cli 1.0.4__tar.gz → 1.1.4__tar.gz

{forgexa_cli-1.0.4 → forgexa_cli-1.1.4}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: forgexa-cli
-Version: 1.0.4
+Version: 1.1.4
 Summary: Forgexa CLI — command-line client and AI agent runtime for the Forgexa platform
-Author-email: Shinetech <dev@shinetechsoftware.com>
+Author-email: Jason Sun <dev.winds@gmail.com>
 License: MIT
 Project-URL: Homepage, https://forgexa.net
 Project-URL: Documentation, https://docs.forgexa.net
@@ -228,3 +228,73 @@ password = pypi-AgEIcH...
 EOF
 chmod 600 ~/.pypirc
 ```
+
+## Local Development & Debugging
+
+### Editable Install
+
+```bash
+cd cli
+pip install -e .
+```
+
+This installs the `forgexa` command pointing to your local source. Changes take effect immediately.
+
+### Testing Against Local Server
+
+```bash
+# Point CLI to local backend
+export FORGEXA_SERVER_URL=http://localhost:8000
+
+# Login
+forgexa login
+
+# Test commands
+forgexa workspace list
+forgexa daemon start
+```
+
+### Testing Against Remote/LAN Server
+
+```bash
+export FORGEXA_SERVER_URL=http://192.168.0.100:8000
+forgexa login
+forgexa daemon start
+```
+
+### Debugging the Daemon
+
+```bash
+# Run in foreground to see all logs
+forgexa daemon start
+
+# Check which agents are discovered
+forgexa runtimes list
+
+# Verbose logging (if supported)
+DAEMON_LOG_LEVEL=DEBUG forgexa daemon start
+```
+
+### Project Structure
+
+```
+cli/
+├── forgexa_cli/
+│   ├── __init__.py     # Version constant
+│   ├── main.py         # CLI entry point (argparse)
+│   ├── daemon.py       # Daemon implementation
+│   └── py.typed        # PEP 561 marker
+├── scripts/
+│   ├── bump-version.sh # Version management
+│   ├── publish.sh      # PyPI publishing
+│   └── sync-daemon.sh  # Sync daemon code from backend
+├── pyproject.toml      # Package metadata
+└── README.md           # This file
+```
+
+### Design Principles
+
+- **Zero external dependencies** — uses only Python stdlib (urllib, json, subprocess)
+- **Lightweight** — installs in seconds, no compilation needed
+- **Cross-platform** — works on Linux, macOS, Windows
+- **Standalone daemon** — discovers local AI agents without server-side configuration

{forgexa_cli-1.0.4 → forgexa_cli-1.1.4}/README.md

@@ -199,3 +199,73 @@ password = pypi-AgEIcH...
 EOF
 chmod 600 ~/.pypirc
 ```
+
+## Local Development & Debugging
+
+### Editable Install
+
+```bash
+cd cli
+pip install -e .
+```
+
+This installs the `forgexa` command pointing to your local source. Changes take effect immediately.
+
+### Testing Against Local Server
+
+```bash
+# Point CLI to local backend
+export FORGEXA_SERVER_URL=http://localhost:8000
+
+# Login
+forgexa login
+
+# Test commands
+forgexa workspace list
+forgexa daemon start
+```
+
+### Testing Against Remote/LAN Server
+
+```bash
+export FORGEXA_SERVER_URL=http://192.168.0.100:8000
+forgexa login
+forgexa daemon start
+```
+
+### Debugging the Daemon
+
+```bash
+# Run in foreground to see all logs
+forgexa daemon start
+
+# Check which agents are discovered
+forgexa runtimes list
+
+# Verbose logging (if supported)
+DAEMON_LOG_LEVEL=DEBUG forgexa daemon start
+```
+
+### Project Structure
+
+```
+cli/
+├── forgexa_cli/
+│   ├── __init__.py     # Version constant
+│   ├── main.py         # CLI entry point (argparse)
+│   ├── daemon.py       # Daemon implementation
+│   └── py.typed        # PEP 561 marker
+├── scripts/
+│   ├── bump-version.sh # Version management
+│   ├── publish.sh      # PyPI publishing
+│   └── sync-daemon.sh  # Sync daemon code from backend
+├── pyproject.toml      # Package metadata
+└── README.md           # This file
+```
+
+### Design Principles
+
+- **Zero external dependencies** — uses only Python stdlib (urllib, json, subprocess)
+- **Lightweight** — installs in seconds, no compilation needed
+- **Cross-platform** — works on Linux, macOS, Windows
+- **Standalone daemon** — discovers local AI agents without server-side configuration

{forgexa_cli-1.0.4 → forgexa_cli-1.1.4}/forgexa_cli/__init__.py

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

forgexa_cli-1.1.4/forgexa_cli/_build_config.py

@@ -0,0 +1,2 @@
+# Auto-generated by publish.sh — do not edit manually.
+BUILD_SERVER_URL = "https://api.forgexa.net"

{forgexa_cli-1.0.4 → forgexa_cli-1.1.4}/forgexa_cli/daemon.py

@@ -46,6 +46,10 @@ try:
 except (ImportError, ModuleNotFoundError):
     # Running standalone (e.g., from desktop app bundle or forgexa-cli).
     # Provide a minimal settings object reading from environment variables.
+    # Production default for end-user installs; server-side deployments
+    # override via .env or systemd Environment= directives.
+    _STANDALONE_DEFAULT_URL = "https://api.forgexa.net"
+
     class _StandaloneSettings:
         """Minimal settings shim for standalone daemon execution."""
 
@@ -55,7 +59,7 @@ except (ImportError, ModuleNotFoundError):
 
         @property
         def DAEMON_SERVER_URL(self) -> str:
-            return os.environ.get("DAEMON_SERVER_URL", "http://localhost:8000")
+            return os.environ.get("DAEMON_SERVER_URL", _STANDALONE_DEFAULT_URL)
 
         @property
         def DAEMON_SERVER_URLS(self) -> str:
@@ -105,11 +109,29 @@ except (ImportError, ModuleNotFoundError):
 
     settings = _StandaloneSettings()  # type: ignore[assignment]
 
+# ── Logging — self-managed file handler ────────────────────────────────
+# The daemon configures its own FileHandler so logs are written to
+# ~/.forgexa/daemon/daemon.log regardless of how the daemon was launched
+# (Makefile, Tauri desktop app, `forgexa daemon start --detach`, etc.).
+# A StreamHandler is added only when stderr is a TTY (foreground mode)
+# so logs are visible on the terminal without duplication.
+_log_dir = Path.home() / ".forgexa" / "daemon"
+_log_dir.mkdir(parents=True, exist_ok=True)
+DAEMON_LOG_PATH = _log_dir / "daemon.log"
+
+_log_handlers: list[logging.Handler] = [
+    logging.FileHandler(DAEMON_LOG_PATH, mode="a", encoding="utf-8"),
+]
+if sys.stderr.isatty():
+    _log_handlers.append(logging.StreamHandler(sys.stderr))
+
 logging.basicConfig(
     level=logging.INFO,
     format="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
+    handlers=_log_handlers,
 )
 logger = logging.getLogger("daemon")
+logger.info("Daemon log: %s", DAEMON_LOG_PATH)
 
 
 # ── Hardware ID — stable cross-IP machine fingerprint ──
@@ -313,21 +335,91 @@ class AgentDiscovery:
         },
     }
 
+    @staticmethod
+    def _expand_path():
+        """Augment PATH with well-known agent CLI directories.
+
+        GUI apps (macOS, Windows) and systemd services often have a
+        minimal PATH that does not include user-installed CLI tools.
+        We probe common installation directories for each platform so
+        ``shutil.which`` can locate agent binaries.
+        """
+        home = Path.home()
+        is_win = sys.platform == "win32"
+        is_mac = sys.platform == "darwin"
+
+        extra_dirs: list[Path] = []
+
+        if is_win:
+            # Windows: npm global, AppData installs, scoop, cargo, bun
+            appdata = Path(os.environ.get("APPDATA", home / "AppData" / "Roaming"))
+            localappdata = Path(os.environ.get("LOCALAPPDATA", home / "AppData" / "Local"))
+            extra_dirs += [
+                appdata / "npm",                         # npm -g installs
+                localappdata / "Programs" / "Python" / "Scripts",
+                home / ".opencode" / "bin",
+                home / ".cargo" / "bin",
+                home / ".bun" / "bin",
+                home / "scoop" / "shims",                # scoop package manager
+            ]
+            # nvm-windows stores versions differently
+            nvm_home = os.environ.get("NVM_HOME", "")
+            if nvm_home:
+                nvm_path = Path(nvm_home)
+                nvm_symlink = os.environ.get("NVM_SYMLINK", "")
+                if nvm_symlink:
+                    extra_dirs.append(Path(nvm_symlink))
+                elif nvm_path.is_dir():
+                    versions = sorted(nvm_path.glob("v*/"), reverse=True)
+                    if versions:
+                        extra_dirs.append(versions[0])
+        else:
+            # macOS + Linux shared paths
+            extra_dirs += [
+                home / ".local" / "bin",         # pip / pipx installs, Claude Code
+                home / ".opencode" / "bin",      # opencode
+                home / ".cargo" / "bin",         # Rust / cargo installs
+                home / ".bun" / "bin",           # bun
+                home / ".volta" / "bin",         # volta (node version manager)
+            ]
+            if is_mac:
+                # Homebrew Intel + Apple Silicon
+                extra_dirs += [
+                    Path("/usr/local/bin"),
+                    Path("/opt/homebrew/bin"),
+                ]
+            # nvm (macOS + Linux)
+            nvm_dir = os.environ.get("NVM_DIR", str(home / ".nvm"))
+            nvm_path = Path(nvm_dir)
+            if nvm_path.is_dir():
+                versions = sorted(nvm_path.glob("versions/node/*/bin"), reverse=True)
+                if versions:
+                    extra_dirs.append(versions[0])
+
+        current = os.environ.get("PATH", "")
+        current_set = set(current.split(os.pathsep))
+        additions = [str(d) for d in extra_dirs if d.is_dir() and str(d) not in current_set]
+        if additions:
+            os.environ["PATH"] = os.pathsep.join(additions) + os.pathsep + current
+            logger.debug("Expanded PATH with: %s", ", ".join(additions))
+
     async def discover(self) -> list[DiscoveredAgent]:
+        self._expand_path()
         available = []
         for agent_id, spec in self.AGENT_REGISTRY.items():
             custom_path = os.environ.get(spec.get("env_path_override", ""))
             cmd = custom_path or spec["commands"][0]
-            if shutil.which(cmd):
+            resolved = shutil.which(cmd)
+            if resolved:
                 version = await self._get_version(spec["detect"])
                 available.append(DiscoveredAgent(
                     agent_id=agent_id,
-                    command=cmd,
+                    command=resolved,
                     version=version,
                     invoke_modes=spec["invoke_modes"],
                     compatibility_level=spec["compatibility_level"],
                 ))
-                logger.info("Discovered agent: %s v%s (%s)", agent_id, version, cmd)
+                logger.info("Discovered agent: %s v%s (%s)", agent_id, version, resolved)
         return available
 
     async def _get_version(self, detect_cmd: str) -> str:

{forgexa_cli-1.0.4 → forgexa_cli-1.1.4}/forgexa_cli/main.py

@@ -5,7 +5,7 @@ A lightweight, standalone CLI that communicates with the Forgexa server via REST
 Zero external dependencies — uses only Python stdlib.
 
 Configuration:
-    FORGEXA_SERVER_URL   Server URL (default: http://localhost:8000)
+    FORGEXA_SERVER_URL   Server URL (default: https://api.forgexa.net)
     FORGEXA_TOKEN        Bearer token (obtain via `forgexa login`)
 
 Usage:
@@ -30,8 +30,20 @@ from pathlib import Path
 # ── HTTP helpers (stdlib only) ──
 
 
+# Default server URL — resolved in priority order:
+#   1. FORGEXA_SERVER_URL environment variable (runtime override)
+#   2. _build_config.py   — generated by publish.sh at wheel-build time
+#   3. Hardcoded fallback — https://api.forgexa.net
+#
+# For local development use: FORGEXA_SERVER_URL=http://localhost:8000 forgexa ...
+try:
+    from forgexa_cli._build_config import BUILD_SERVER_URL as _DEFAULT_SERVER_URL
+except ImportError:
+    _DEFAULT_SERVER_URL = "https://api.forgexa.net"
+
+
 def _api_url() -> str:
-    return os.environ.get("FORGEXA_SERVER_URL", "http://localhost:8000")
+    return os.environ.get("FORGEXA_SERVER_URL", _DEFAULT_SERVER_URL)
 
 
 def _token() -> str | None:
@@ -218,20 +230,26 @@ def cmd_daemon_start(args: argparse.Namespace) -> None:
         os.environ.setdefault("DAEMON_API_TOKEN", token)
 
     if getattr(args, "detach", False):
-        # Background mode: spawn forgexa-daemon as detached subprocess
+        # Background mode: spawn forgexa-daemon as detached subprocess.
+        # Redirect stderr to the canonical log file so logs are not lost.
         import subprocess as sp
 
+        log_path = Path.home() / ".forgexa" / "daemon" / "daemon.log"
+        log_path.parent.mkdir(parents=True, exist_ok=True)
+
         cmd = [sys.executable, "-m", "forgexa_cli.daemon"]
-        proc = sp.Popen(
-            cmd,
-            stdout=sp.DEVNULL,
-            stderr=sp.DEVNULL,
-            start_new_session=True,
-        )
+        with open(log_path, "a", encoding="utf-8") as log_fh:
+            proc = sp.Popen(
+                cmd,
+                stdout=sp.DEVNULL,
+                stderr=log_fh,
+                start_new_session=True,
+            )
         pid_file = Path.home() / ".forgexa-daemon.pid"
         pid_file.write_text(str(proc.pid))
         print(f"Daemon started in background (PID {proc.pid})")
         print(f"Server: {server_url}")
+        print(f"Logs:   {log_path}")
         print(f"Stop with: forgexa daemon stop")
     else:
         # Foreground mode: run daemon directly

{forgexa_cli-1.0.4 → forgexa_cli-1.1.4}/forgexa_cli.egg-info/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: forgexa-cli
-Version: 1.0.4
+Version: 1.1.4
 Summary: Forgexa CLI — command-line client and AI agent runtime for the Forgexa platform
-Author-email: Shinetech <dev@shinetechsoftware.com>
+Author-email: Jason Sun <dev.winds@gmail.com>
 License: MIT
 Project-URL: Homepage, https://forgexa.net
 Project-URL: Documentation, https://docs.forgexa.net
@@ -228,3 +228,73 @@ password = pypi-AgEIcH...
 EOF
 chmod 600 ~/.pypirc
 ```
+
+## Local Development & Debugging
+
+### Editable Install
+
+```bash
+cd cli
+pip install -e .
+```
+
+This installs the `forgexa` command pointing to your local source. Changes take effect immediately.
+
+### Testing Against Local Server
+
+```bash
+# Point CLI to local backend
+export FORGEXA_SERVER_URL=http://localhost:8000
+
+# Login
+forgexa login
+
+# Test commands
+forgexa workspace list
+forgexa daemon start
+```
+
+### Testing Against Remote/LAN Server
+
+```bash
+export FORGEXA_SERVER_URL=http://192.168.0.100:8000
+forgexa login
+forgexa daemon start
+```
+
+### Debugging the Daemon
+
+```bash
+# Run in foreground to see all logs
+forgexa daemon start
+
+# Check which agents are discovered
+forgexa runtimes list
+
+# Verbose logging (if supported)
+DAEMON_LOG_LEVEL=DEBUG forgexa daemon start
+```
+
+### Project Structure
+
+```
+cli/
+├── forgexa_cli/
+│   ├── __init__.py     # Version constant
+│   ├── main.py         # CLI entry point (argparse)
+│   ├── daemon.py       # Daemon implementation
+│   └── py.typed        # PEP 561 marker
+├── scripts/
+│   ├── bump-version.sh # Version management
+│   ├── publish.sh      # PyPI publishing
+│   └── sync-daemon.sh  # Sync daemon code from backend
+├── pyproject.toml      # Package metadata
+└── README.md           # This file
+```
+
+### Design Principles
+
+- **Zero external dependencies** — uses only Python stdlib (urllib, json, subprocess)
+- **Lightweight** — installs in seconds, no compilation needed
+- **Cross-platform** — works on Linux, macOS, Windows
+- **Standalone daemon** — discovers local AI agents without server-side configuration

{forgexa_cli-1.0.4 → forgexa_cli-1.1.4}/forgexa_cli.egg-info/SOURCES.txt

@@ -1,6 +1,7 @@
 README.md
 pyproject.toml
 forgexa_cli/__init__.py
+forgexa_cli/_build_config.py
 forgexa_cli/daemon.py
 forgexa_cli/main.py
 forgexa_cli/py.typed

{forgexa_cli-1.0.4 → forgexa_cli-1.1.4}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "forgexa-cli"
-version = "1.0.4"
+version = "1.1.4"
 description = "Forgexa CLI — command-line client and AI agent runtime for the Forgexa platform"
 requires-python = ">=3.9"
 license = { text = "MIT" }
 authors = [
-    { name = "Shinetech", email = "dev@shinetechsoftware.com" },
+    { name = "Jason Sun", email = "dev.winds@gmail.com" },
 ]
 readme = "README.md"
 keywords = ["forgexa", "ai", "software-factory", "cli", "devops", "agent"]