nexo-brain 7.9.4 → 7.9.6

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "7.9.4",
+  "version": "7.9.6",
   "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,11 @@
 
 [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.9.4` is the current packaged-runtime line. Patch release that blocks the Brain 7.9.3 + Desktop 0.28.2 diary regression: canonical lifecycle plans now require real `session_diary` evidence (`wait_for_diary_write`) before `stop_session`, and canonical completion is rejected/retryable without that diary row. It also fixes npm CLI onboarding so `nexo-brain --version` and subcommands never launch the wizard when legacy/v2 calibration is already valid, commits setup calibration atomically only after the wizard completes, and adds `nexo-brain warmup-models` so install/update paths predownload the local mDeBERTa/BGE/reranker models. Verification: full Brain pytest (`2189 passed, 3 skipped, 1 xfailed, 5 xpassed`), release-readiness, npm pack dry-run, and coordinated Desktop v0.28.3 checks.
+Version `7.9.6` is the current packaged-runtime line. Patch release that closes continuity + MCP restart stability for installed users: Brain now persists conversation-scoped continuity snapshots and resume bundles, activates packaged runtimes atomically under `~/.nexo/core/current`, writes a durable `mcp-restart-required` marker on real version changes, and self-drains old MCP processes until the client restarts against the installed runtime. Coordinated Desktop v0.28.7 consumes the same contract so existing `brain-only` and `brain+desktop` installs reroute to the new runtime instead of running mixed old/new MCP code.
+
+Previously in `7.9.5`: patch release that fixes canonical diary confirmation for Desktop: Brain resolves the Desktop/Claude session UUID through NEXO SID aliases before checking `session_diary`, so archive/delete/app-exit can confirm diaries written by `nexo_session_diary_write` under the active `nexo-...` SID. Verification: `pytest tests/test_lifecycle_events.py` (28 passing) plus coordinated Desktop v0.28.6 shutdown/archive/delete/app-exit checks.
+
+Previously in `7.9.4`: patch release that blocks the Brain 7.9.3 + Desktop 0.28.2 diary regression: canonical lifecycle plans now require real `session_diary` evidence (`wait_for_diary_write`) before `stop_session`, and canonical completion is rejected/retryable without that diary row. It also fixes npm CLI onboarding so `nexo-brain --version` and subcommands never launch the wizard when legacy/v2 calibration is already valid, commits setup calibration atomically only after the wizard completes, and adds `nexo-brain warmup-models` so install/update paths predownload the local mDeBERTa/BGE/reranker models. Verification: full Brain pytest (`2189 passed, 3 skipped, 1 xfailed, 5 xpassed`), release-readiness, npm pack dry-run, and coordinated Desktop v0.28.3 checks.
 
 Previously in `7.9.3`: patch release that hardens Brain's canonical lifecycle plan for Desktop close/archive/delete/app-exit diary guarantees: `canonical_actions` now publish the v2 canonical shape (`type` plus `payload.prompt`) while keeping one-release compatibility mirrors (`kind` plus top-level `prompt`) for older Desktop clients. This lets Desktop execute resume → diary prompt → stop with one exact owner per lifecycle event and preserve Brain-side dedupe by event id. Targeted verification: `pytest tests/test_lifecycle_events.py` (25 passing) plus release-readiness after artifact sync.
 

package/bin/nexo-brain.js

@@ -3249,6 +3249,10 @@ async function runSetup() {
     '    printf \'%s\\n\' "${NEXO_CODE%/}"',
     '    return 0',
     '  fi',
+    '  if [ -f "$NEXO_HOME/core/current/cli.py" ]; then',
+    '    printf \'%s\\n\' "$NEXO_HOME/core/current"',
+    '    return 0',
+    '  fi',
     '  if [ -f "$NEXO_HOME/core/cli.py" ]; then',
     '    printf \'%s\\n\' "$NEXO_HOME/core"',
     '    return 0',
@@ -3302,6 +3306,11 @@ async function runSetup() {
     '  exit 1',
     'fi',
     'CLI_PY="$NEXO_CODE/cli.py"',
+    'if [ ! -f "$CLI_PY" ] && [ -f "$NEXO_HOME/core/current/cli.py" ]; then',
+    '  NEXO_CODE="$NEXO_HOME/core/current"',
+    '  export NEXO_CODE',
+    '  CLI_PY="$NEXO_HOME/core/current/cli.py"',
+    'fi',
     'if [ ! -f "$CLI_PY" ] && [ -f "$NEXO_HOME/core/cli.py" ]; then',
     '  NEXO_CODE="$NEXO_HOME/core"',
     '  export NEXO_CODE',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "7.9.4",
+  "version": "7.9.6",
   "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/auto_update.py

@@ -537,6 +537,10 @@ def _runtime_cli_wrapper_text() -> str:
         '    printf \'%s\\n\' "${NEXO_CODE%/}"\n'
         '    return 0\n'
         '  fi\n'
+        '  if [ -f "$NEXO_HOME/core/current/cli.py" ]; then\n'
+        '    printf \'%s\\n\' "$NEXO_HOME/core/current"\n'
+        '    return 0\n'
+        '  fi\n'
         '  if [ -f "$NEXO_HOME/core/cli.py" ]; then\n'
         '    printf \'%s\\n\' "$NEXO_HOME/core"\n'
         '    return 0\n'
@@ -590,6 +594,11 @@ def _runtime_cli_wrapper_text() -> str:
         '  exit 1\n'
         'fi\n'
         'CLI_PY="$NEXO_CODE/cli.py"\n'
+        'if [ ! -f "$CLI_PY" ] && [ -f "$NEXO_HOME/core/current/cli.py" ]; then\n'
+        '  NEXO_CODE="$NEXO_HOME/core/current"\n'
+        '  export NEXO_CODE\n'
+        '  CLI_PY="$NEXO_HOME/core/current/cli.py"\n'
+        'fi\n'
         'if [ ! -f "$CLI_PY" ] && [ -f "$NEXO_HOME/core/cli.py" ]; then\n'
         '  NEXO_CODE="$NEXO_HOME/core"\n'
         '  export NEXO_CODE\n'

package/src/cli.py

@@ -47,6 +47,7 @@ import time
 from pathlib import Path
 
 from runtime_home import export_resolved_nexo_home
+from runtime_versioning import build_mcp_status, clear_restart_required_marker
 
 NEXO_HOME = export_resolved_nexo_home()
 NEXO_CODE = Path(os.environ.get("NEXO_CODE", str(Path(__file__).resolve().parent)))
@@ -120,6 +121,82 @@ def _fetch_latest_version(timeout_seconds: int = 2) -> str | None:
     return latest
 
 
+def _print_json_or_text(payload: dict, *, as_json: bool = False) -> int:
+    if as_json:
+        print(json.dumps(payload, ensure_ascii=False))
+    else:
+        print(json.dumps(payload, indent=2, ensure_ascii=False))
+    return 0 if payload.get("ok", True) else 1
+
+
+def _mcp_status(args) -> int:
+    return _print_json_or_text(
+        build_mcp_status(client=getattr(args, "client", "") or ""),
+        as_json=bool(getattr(args, "json", False)),
+    )
+
+
+def _mcp_clear_restart(args) -> int:
+    return _print_json_or_text(
+        clear_restart_required_marker(
+            client=getattr(args, "client", "") or "",
+            installed_version=getattr(args, "installed_version", "") or "",
+            process_version=getattr(args, "process_version", "") or "",
+        ),
+        as_json=bool(getattr(args, "json", False)),
+    )
+
+
+def _continuity_snapshot_write(args) -> int:
+    from continuity import write_snapshot
+
+    result = write_snapshot(
+        conversation_id=args.conversation_id,
+        session_id=args.session_id or "",
+        external_session_id=args.external_session_id or "",
+        client=args.client or "",
+        event_type=args.event_type or "turn_end",
+        payload=args.payload or "",
+        trace_id=args.trace_id or "",
+        idempotency_key=args.idempotency_key or "",
+    )
+    return _print_json_or_text(result, as_json=bool(getattr(args, "json", False)))
+
+
+def _continuity_snapshot_read(args) -> int:
+    from continuity import read_snapshot
+
+    result = read_snapshot(
+        conversation_id=args.conversation_id or "",
+        session_id=args.session_id or "",
+        limit=args.limit or 20,
+    )
+    return _print_json_or_text(result, as_json=bool(getattr(args, "json", False)))
+
+
+def _continuity_resume_bundle(args) -> int:
+    from continuity import build_resume_bundle
+
+    result = build_resume_bundle(
+        conversation_id=args.conversation_id or "",
+        session_id=args.session_id or "",
+        external_session_id=args.external_session_id or "",
+        client=args.client or "",
+        token_budget=args.token_budget or 2000,
+    )
+    return _print_json_or_text(result, as_json=bool(getattr(args, "json", False)))
+
+
+def _continuity_audit(args) -> int:
+    from continuity import continuity_audit
+
+    result = continuity_audit(
+        conversation_id=args.conversation_id,
+        limit=args.limit or 50,
+    )
+    return _print_json_or_text(result, as_json=bool(getattr(args, "json", False)))
+
+
 def _should_refresh_latest_version() -> bool:
     """Decide whether to hit the npm registry to refresh `latest` version.
 
@@ -3075,6 +3152,49 @@ def main():
     dashboard_parser = sub.add_parser("dashboard", help="Web dashboard control")
     dashboard_parser.add_argument("action", choices=["on", "off", "status"], help="Start, stop, or check dashboard")
 
+    mcp_parser = sub.add_parser("mcp", help="MCP runtime status and restart state")
+    mcp_sub = mcp_parser.add_subparsers(dest="mcp_command")
+    mcp_status_p = mcp_sub.add_parser("status", help="Read the current runtime/MCP alignment state")
+    mcp_status_p.add_argument("--client", default="", help="Optional client label such as claude_desktop or codex")
+    mcp_status_p.add_argument("--json", action="store_true", help="JSON output")
+    mcp_clear_p = mcp_sub.add_parser("clear-restart", help="Acknowledge that a client/session reloaded the new runtime")
+    mcp_clear_p.add_argument("--client", default="", help="Client label such as claude_desktop or codex")
+    mcp_clear_p.add_argument("--installed-version", default="")
+    mcp_clear_p.add_argument("--process-version", default="")
+    mcp_clear_p.add_argument("--json", action="store_true", help="JSON output")
+
+    continuity_parser = sub.add_parser("continuity", help="Continuity snapshots and resume bundles")
+    continuity_sub = continuity_parser.add_subparsers(dest="continuity_command")
+    cwrite_p = continuity_sub.add_parser("snapshot-write", help="Write a continuity snapshot")
+    cwrite_p.add_argument("--conversation-id", required=True)
+    cwrite_p.add_argument("--session-id", default="")
+    cwrite_p.add_argument("--external-session-id", default="")
+    cwrite_p.add_argument("--client", default="")
+    cwrite_p.add_argument("--event-type", default="turn_end")
+    cwrite_p.add_argument("--payload", default="")
+    cwrite_p.add_argument("--trace-id", default="")
+    cwrite_p.add_argument("--idempotency-key", default="")
+    cwrite_p.add_argument("--json", action="store_true", help="JSON output")
+
+    cread_p = continuity_sub.add_parser("snapshot-read", help="Read continuity snapshots")
+    cread_p.add_argument("--conversation-id", default="")
+    cread_p.add_argument("--session-id", default="")
+    cread_p.add_argument("--limit", type=int, default=20)
+    cread_p.add_argument("--json", action="store_true", help="JSON output")
+
+    cbundle_p = continuity_sub.add_parser("resume-bundle", help="Build a continuity resume bundle")
+    cbundle_p.add_argument("--conversation-id", default="")
+    cbundle_p.add_argument("--session-id", default="")
+    cbundle_p.add_argument("--external-session-id", default="")
+    cbundle_p.add_argument("--client", default="")
+    cbundle_p.add_argument("--token-budget", type=int, default=2000)
+    cbundle_p.add_argument("--json", action="store_true", help="JSON output")
+
+    caudit_p = continuity_sub.add_parser("audit", help="Read the continuity audit timeline")
+    caudit_p.add_argument("--conversation-id", required=True)
+    caudit_p.add_argument("--limit", type=int, default=50)
+    caudit_p.add_argument("--json", action="store_true", help="JSON output")
+
     # -- desktop bridge (read-only, for NEXO Desktop and any external UI) --
     # v7.4.0 — lifecycle event bridge (guardian-claude-desktop-plan).
     lifecycle_parser = sub.add_parser("lifecycle", help="Conversation lifecycle event handler (v7.4 Desktop bridge)")
@@ -3268,6 +3388,24 @@ def main():
             return _clients_sync(args)
         clients_parser.print_help()
         return 0
+    elif args.command == "mcp":
+        if args.mcp_command == "status":
+            return _mcp_status(args)
+        if args.mcp_command == "clear-restart":
+            return _mcp_clear_restart(args)
+        mcp_parser.print_help()
+        return 0
+    elif args.command == "continuity":
+        if args.continuity_command == "snapshot-write":
+            return _continuity_snapshot_write(args)
+        elif args.continuity_command == "snapshot-read":
+            return _continuity_snapshot_read(args)
+        elif args.continuity_command == "resume-bundle":
+            return _continuity_resume_bundle(args)
+        elif args.continuity_command == "audit":
+            return _continuity_audit(args)
+        continuity_parser.print_help()
+        return 0
     elif args.command == "preferences":
         return _preferences(args)
     elif args.command == "doctor":