nexo-brain 7.17.4 → 7.17.5

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "7.17.4",
+  "version": "7.17.5",
   "description": "Local cognitive runtime for Claude Code \u2014 persistent memory, overnight learning, doctor diagnostics, personal scripts, recovery-aware jobs, startup preflight, and optional dashboard/power helper.",
   "author": {
     "name": "NEXO Brain",

package/README.md

@@ -18,7 +18,9 @@
 
 [Watch the overview video](https://nexo-brain.com/watch/) · [Watch on YouTube](https://www.youtube.com/watch?v=i2lkGhKyVqI) · [Open the infographic](https://nexo-brain.com/assets/nexo-brain-infographic-v5.png)
 
-Version `7.17.4` is the current packaged-runtime line. Corrective patch over v7.17.3 - automation runners now keep full NEXO discipline for real background agents while strict JSON children stay clean, and runtime doctor/metrics expose caller coverage and Guardian injection telemetry instead of hiding blind spots.
+Version `7.17.5` is the current packaged-runtime line. Patch release over v7.17.4 - `nexo --version --json` now returns fast machine-readable update status (`installed`, `latest`, `hasUpdate`, `unknown`, `latestSource`) while the human output keeps the legacy `nexo vX` line plus a compact latest/installed status line for Desktop compatibility.
+
+Previously in `7.17.4`: corrective patch over v7.17.3 - automation runners now keep full NEXO discipline for real background agents while strict JSON children stay clean, and runtime doctor/metrics expose caller coverage and Guardian injection telemetry instead of hiding blind spots.
 
 Previously in `7.17.3`: corrective patch over v7.17.2 - standalone Brain install/update no longer aborts when the Desktop-only `qwen3-0.6b-q4-local-presence` model is not bundled or already cached locally. Required Brain warmups stay strict; only the optional local-presence GGUF now degrades cleanly.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "7.17.4",
+  "version": "7.17.5",
   "mcpName": "io.github.wazionapps/nexo",
   "description": "NEXO Brain — Shared brain for AI agents. Persistent memory, semantic RAG, natural forgetting, metacognitive guard, trust scoring, 150+ MCP tools. Works with Claude Code, Codex, Claude Desktop & any MCP client. 100% local, free.",
   "homepage": "https://nexo-brain.com",

package/src/cli.py

@@ -3,6 +3,7 @@
 
 Entry points:
   nexo chat [PATH]
+  nexo --version [--json]
   nexo export [PATH] [--json]
   nexo import-inspect PATH [--json]
   nexo import PATH [--json]
@@ -233,17 +234,41 @@ def _version_sort_key(raw: str) -> tuple[tuple[int, ...], int, str]:
     return (tuple(parts), 1 if not suffix else 0, suffix)
 
 
-def _version_status_line() -> str:
+def _version_status_payload() -> dict:
     installed = _get_version()
     latest = _load_latest_version_cache()
+    latest_source = "cache" if latest else ""
     if latest is None and _should_refresh_latest_version():
         latest = _fetch_latest_version()
+        latest_source = "npm" if latest else ""
     if latest and installed and _version_sort_key(latest) < _version_sort_key(installed):
         latest = installed
+        latest_source = "installed"
         try:
             _save_latest_version_cache(installed)
         except Exception:
             pass
+    has_update = bool(
+        latest
+        and installed
+        and _version_sort_key(latest) > _version_sort_key(installed)
+    )
+    return {
+        "ok": True,
+        "name": "nexo",
+        "package": LATEST_NPM_PACKAGE,
+        "installed": installed,
+        "latest": latest or "",
+        "hasUpdate": has_update,
+        "unknown": not bool(installed and latest),
+        "latestSource": latest_source,
+    }
+
+
+def _version_status_line(payload: dict | None = None) -> str:
+    payload = payload or _version_status_payload()
+    installed = str(payload.get("installed") or "?").strip()
+    latest = str(payload.get("latest") or "").strip()
     if latest:
         return f"NEXO Latest: v{latest} | Installed: v{installed}"
     return f"NEXO Installed: v{installed}"
@@ -2823,6 +2848,7 @@ def main():
     parser = argparse.ArgumentParser(prog="nexo", description="NEXO Runtime CLI", add_help=False)
     parser.add_argument("-h", "--help", action="store_true", help="Show help")
     parser.add_argument("-v", "--version", action="store_true", help="Show version")
+    parser.add_argument("--json", action="store_true", help="JSON output for --version")
     sub = parser.add_subparsers(dest="command")
 
     # -- email (Plan F1 — interactive wizard for email accounts) --
@@ -3408,7 +3434,12 @@ def main():
         _print_help()
         return 0
     if args.version:
-        print(f"nexo v{_get_version()}")
+        payload = _version_status_payload()
+        if args.json:
+            print(json.dumps(payload, ensure_ascii=False))
+        else:
+            print(f"nexo v{payload.get('installed') or _get_version()}")
+            print(_version_status_line(payload))
         return 0
 
     if args.command == "email":