nmem-cli 0.8.0__tar.gz → 0.8.3__tar.gz

{nmem_cli-0.8.0 → nmem_cli-0.8.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nmem-cli
-Version: 0.8.0
+Version: 0.8.3
 Summary: CLI and TUI for Nowledge Mem - AI memory management
 Project-URL: Homepage, https://mem.nowledge.co/
 Project-URL: Repository, https://github.com/nowledge-co/

{nmem_cli-0.8.0 → nmem_cli-0.8.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nmem-cli"
-version = "0.8.0"
+version = "0.8.3"
 description = "CLI and TUI for Nowledge Mem - AI memory management"
 authors = [
     {name = "Nowledge Labs"}

{nmem_cli-0.8.0 → nmem_cli-0.8.3}/src/nmem_cli/__init__.py

@@ -20,7 +20,7 @@ Environment (overrides config file):
     NMEM_API_KEY         Optional API key (Bearer auth)
 """
 
-__version__ = "0.8.0"
+__version__ = "0.8.3"
 __author__ = "Nowledge Labs"
 
 from .cli import main

nmem_cli-0.8.3/src/nmem_cli/claude_paths.py

@@ -0,0 +1,63 @@
+"""Claude Code project-directory path decoding helpers."""
+
+import os
+
+
+def find_valid_claude_path(base: str, remaining: list[str]) -> str | None:
+    """Find a valid path by matching Claude-encoded segments to real dirs."""
+    seen: set[tuple[str, tuple[str, ...]]] = set()
+
+    def _walk(current_base: str, parts: tuple[str, ...]) -> str | None:
+        state = (os.path.normpath(current_base), parts)
+        if state in seen:
+            return None
+        seen.add(state)
+
+        if not parts:
+            return current_base if os.path.exists(current_base) else None
+
+        try:
+            entries = list(os.scandir(current_base))
+        except OSError:
+            return None
+
+        matches: list[tuple[int, str]] = []
+        for entry in entries:
+            try:
+                if not entry.is_dir():
+                    continue
+            except OSError:
+                continue
+
+            for encoded_parts in _encoded_segment_variants(entry.name):
+                length = len(encoded_parts)
+                if length <= len(parts) and parts[:length] == encoded_parts:
+                    matches.append((length, entry.path))
+                    break
+
+        for consumed, next_base in sorted(
+            matches,
+            key=lambda candidate: candidate[0],
+            reverse=True,
+        ):
+            result = _walk(next_base, parts[consumed:])
+            if result:
+                return result
+        return None
+
+    return _walk(base, tuple(remaining))
+
+
+def _encoded_segment_variants(segment: str) -> list[tuple[str, ...]]:
+    variants: list[tuple[str, ...]] = []
+
+    def _add(encoded: str) -> None:
+        parts = tuple(encoded.split("-"))
+        if parts not in variants:
+            variants.append(parts)
+
+    _add(segment.replace(".", "-").replace("_", "-"))
+    if segment.startswith(".") and len(segment) > 1:
+        _add("-" + segment[1:])
+    _add(segment)
+    return variants

{nmem_cli-0.8.0 → nmem_cli-0.8.3}/src/nmem_cli/cli.py

@@ -88,7 +88,7 @@ PROVIDER_DEFAULTS: dict[str, dict[str, str]] = {
     "anthropic": {"model": "claude-sonnet-4-20250514", "api_base": "https://api.anthropic.com"},
     "gemini": {"model": "gemini-flash-latest", "api_base": "https://generativelanguage.googleapis.com"},
     "xai": {"model": "grok-3", "api_base": "https://api.x.ai/v1"},
-    "deepseek": {"model": "deepseek-chat", "api_base": "https://api.deepseek.com/v1"},
+    "deepseek": {"model": "deepseek-v4-flash", "api_base": "https://api.deepseek.com/v1"},
     "openrouter": {"model": "anthropic/claude-sonnet-4", "api_base": "https://openrouter.ai/api/v1"},
     "github_copilot": {"model": "gpt-5-mini"},
     "openai_codex": {"model": "gpt-5.2-codex"},
@@ -1378,6 +1378,88 @@ def _is_wsl_environment() -> bool:
         return False
 
 
+class _CliInstallContext(NamedTuple):
+    source: str
+    command_path: str | None
+    python_executable: str
+    package_path: str
+
+
+def _detect_cli_install_context() -> _CliInstallContext:
+    command_path = shutil.which("nmem")
+    python_executable = str(Path(sys.executable).resolve())
+    package_path = str(Path(__file__).resolve())
+    haystack = " ".join(
+        item.lower()
+        for item in [command_path or "", python_executable, package_path]
+    )
+
+    if "python-standalone" in haystack or "nowledge mem.app" in haystack:
+        source = "desktop-bundled"
+    elif "/usr/lib/nowledge-mem" in haystack or "/usr/lib/nowledge mem" in haystack:
+        source = "desktop-bundled"
+    elif "\\nowledge mem\\" in haystack or "/.local/share/nowledge-mem/" in haystack:
+        source = "desktop-bundled"
+    elif "pipx/venvs/nmem-cli" in haystack or ".local/pipx/venvs/nmem-cli" in haystack:
+        source = "pipx"
+    elif "/uv/tools/nmem-cli" in haystack or "\\uv\\tools\\nmem-cli" in haystack:
+        source = "uv"
+    elif "site-packages/nmem_cli" in haystack:
+        source = "python-package"
+    else:
+        source = "unknown"
+
+    return _CliInstallContext(
+        source=source,
+        command_path=command_path,
+        python_executable=python_executable,
+        package_path=package_path,
+    )
+
+
+def _format_cli_upgrade_hint(*, context: _CliInstallContext, server_newer: bool) -> str:
+    command_detail = (
+        f" first on PATH ({context.command_path})" if context.command_path else ""
+    )
+    if server_newer:
+        if context.source == "desktop-bundled":
+            return (
+                f"The CLI{command_detail} is older than the connected server. "
+                "In the desktop app, open Settings > Preferences > Developer Tools > "
+                "Install CLI, then restart the terminal. If this terminal is using a "
+                "PyPI/pipx install instead, run "
+                "`python -m pip install --upgrade nmem-cli` or `pipx upgrade nmem-cli`."
+            )
+        if context.source == "pipx":
+            return (
+                f"The CLI{command_detail} is older than the connected server. "
+                "Run `pipx upgrade nmem-cli`, or use "
+                "`uvx --from nmem-cli nmem status` for a fresh one-shot CLI."
+            )
+        if context.source == "uv":
+            return (
+                f"The CLI{command_detail} is older than the connected server. "
+                "Use `uvx --from nmem-cli nmem status` for the latest published CLI, "
+                "or reinstall the uv tool."
+            )
+        if context.source == "python-package":
+            return (
+                f"The CLI{command_detail} is older than the connected server. "
+                "Run `python -m pip install --upgrade nmem-cli`, or "
+                "`uvx --from nmem-cli nmem status` without installing."
+            )
+        return (
+            f"The CLI{command_detail} is older than the connected server. "
+            "Upgrade the `nmem-cli` package, or reinstall the desktop CLI from "
+            "Settings > Preferences > Developer Tools."
+        )
+
+    return (
+        "The CLI is newer than the connected server. Update or restart "
+        "Nowledge Mem, or point NMEM_API_URL at the server you intended to use."
+    )
+
+
 def _status_version_warning(
     *,
     cli_version: str,
@@ -1389,21 +1471,26 @@ def _status_version_warning(
     if not normalized_server or normalized_server == normalized_cli:
         return None
 
-    message = (
-        f"CLI is v{normalized_cli}, but the server at {api_url} reports v{normalized_server}."
+    message = "CLI is v{}, but the server at {} reports v{}.".format(
+        normalized_cli,
+        api_url,
+        normalized_server,
     )
 
     parsed = urlsplit(api_url)
     if _is_wsl_environment() and _is_loopback_hostname(parsed.hostname):
         return (
             message,
-            "WSL localhost may be reaching the Windows desktop app instead of the Linux service. "
-            "If you expected the WSL server, stop the Windows app or point NMEM_API_URL at the Linux service explicitly.",
+            "WSL localhost may be reaching the Windows desktop app instead of "
+            "the Linux service. If you expected the WSL server, stop the "
+            "Windows app or point NMEM_API_URL at the Linux service explicitly.",
         )
 
+    context = _detect_cli_install_context()
+    server_newer = _compare_versions(normalized_cli, normalized_server)
     return (
         message,
-        "Upgrade or restart the server process you are connected to, or point NMEM_API_URL at the intended server.",
+        _format_cli_upgrade_hint(context=context, server_newer=server_newer),
     )
 
 
@@ -1487,6 +1574,18 @@ def cmd_status() -> None:
     except Exception:
         search_index = None
 
+    version_warning = _status_version_warning(
+        cli_version=result["cli_version"],
+        server_version=result["server_version"],
+        api_url=result["api_url"],
+    )
+    if version_warning:
+        warning_message, warning_hint = version_warning
+        result["version_mismatch"] = {
+            "message": warning_message,
+            "hint": warning_hint,
+        }
+
     if is_json_mode():
         if agent_data:
             result["agent"] = {
@@ -1535,11 +1634,6 @@ def cmd_status() -> None:
             console.print(f"  search   {state_label}")
             if search_index.get("message"):
                 console.print(f"           [dim]{search_index['message']}[/dim]")
-        version_warning = _status_version_warning(
-            cli_version=result["cli_version"],
-            server_version=result["server_version"],
-            api_url=result["api_url"],
-        )
         if version_warning:
             warning_message, warning_hint = version_warning
             console.print(f"  [bold yellow]! Version mismatch[/bold yellow] {warning_message}")

{nmem_cli-0.8.0 → nmem_cli-0.8.3}/src/nmem_cli/session_import.py

@@ -25,9 +25,55 @@ from datetime import datetime
 from pathlib import Path
 from typing import Any, Optional
 
+from .claude_paths import find_valid_claude_path
+
 
 logger = logging.getLogger(__name__)
 
+_KNOWN_TITLE_SCAFFOLD_PREFIXES = (
+    "system:",
+    "developer:",
+    "you are ",
+    "you are codex",
+    "you are claude code",
+    "you are opencode",
+    "you are a coding assistant",
+    "you are an ai coding assistant",
+    "act as ",
+    "# ",
+    "## ",
+    "### ",
+    "instructions:",
+    "rules:",
+    "constraints:",
+    "codebase and user instructions",
+)
+
+_KNOWN_HOST_SCAFFOLD_TAG_PREFIXES = (
+    "<environment_context>",
+    "<permissions instructions>",
+    "<apps_instructions>",
+    "<skills_instructions>",
+    "<plugins_instructions>",
+    "<system_instruction>",
+    "<system>",
+    "<system-prompt>",
+    "<instructions>",
+    "<context>",
+)
+
+
+def _is_poor_title_source(content: str) -> bool:
+    stripped = content.strip()
+    if not stripped:
+        return True
+    lower = stripped.lower()
+    if any(lower.startswith(prefix) for prefix in _KNOWN_TITLE_SCAFFOLD_PREFIXES):
+        return True
+    if any(lower.startswith(prefix) for prefix in _KNOWN_HOST_SCAFFOLD_TAG_PREFIXES):
+        return True
+    return len(stripped) > 500
+
 
 def _project_path_variants(project_path: str) -> list[str]:
     variants: list[str] = []
@@ -312,9 +358,7 @@ def _discover_codex_sessions(
             if session_cwd != project_path:
                 continue
 
-            filename = session_file.stem
-            parts = filename.rsplit("-", 1)
-            file_session_id = parts[1] if len(parts) > 1 else filename
+            file_session_id = str(payload.get("id") or session_file.stem)
             if target_session_id and file_session_id != target_session_id:
                 continue
 
@@ -706,7 +750,11 @@ def parse_codex_session_streaming(
                     continue
                 seen_message_hashes.add(message_hash)
 
-                if role == "user" and not first_user_content:
+                if (
+                    role == "user"
+                    and not first_user_content
+                    and not _is_poor_title_source(content_text)
+                ):
                     first_user_content = content_text
 
                 messages.append(
@@ -788,7 +836,11 @@ def parse_gemini_session(file_path: Path) -> dict[str, Any]:
         if not content_text.strip():
             continue
 
-        if role == "user" and not first_user_content:
+        if (
+            role == "user"
+            and not first_user_content
+            and not _is_poor_title_source(content_text)
+        ):
             first_user_content = content_text
 
         messages.append(
@@ -923,7 +975,11 @@ def _parse_opencode_sqlite_session(db_path: Path, session_id: str) -> dict[str,
             if not content:
                 continue
 
-            if role == "user" and not first_user_content:
+            if (
+                role == "user"
+                and not first_user_content
+                and not _is_poor_title_source(content)
+            ):
                 first_user_content = content
 
             messages.append(
@@ -1011,7 +1067,11 @@ def _parse_opencode_json_session(session_path: Path) -> dict[str, Any]:
             if not content:
                 continue
 
-            if role == "user" and not first_user_content:
+            if (
+                role == "user"
+                and not first_user_content
+                and not _is_poor_title_source(content)
+            ):
                 first_user_content = content
 
             messages.append(
@@ -1318,7 +1378,11 @@ def parse_claude_code_session_streaming(
             i = max(i + 1, j)
             continue
 
-        if role == "user" and not first_user_content:
+        if (
+            role == "user"
+            and not first_user_content
+            and not _is_poor_title_source(content)
+        ):
             first_user_content = content
 
         messages.append(
@@ -1413,40 +1477,13 @@ def _decode_project_path_enhanced(encoded: str) -> Optional[str]:
         return simple
 
     segments = encoded[1:].split("-")
-    result = _find_valid_path("/", segments)
+    result = find_valid_claude_path("/", segments)
     if result:
         return result
 
     return simple
 
 
-def _find_valid_path(base: str, remaining: list[str]) -> Optional[str]:
-    if not remaining:
-        return base if os.path.exists(base) else None
-
-    if remaining[0] == "" and len(remaining) >= 2 and remaining[1]:
-        for prefix in (".", "-"):
-            result = _find_valid_path(base, [prefix + remaining[1], *remaining[2:]])
-            if result:
-                return result
-
-    next_segment = remaining[0]
-    with_slash = os.path.join(base, next_segment)
-    if os.path.exists(with_slash):
-        result = _find_valid_path(with_slash, remaining[1:])
-        if result:
-            return result
-
-    if len(remaining) >= 2:
-        for delimiter in ("-", "."):
-            combined = remaining[0] + delimiter + remaining[1]
-            result = _find_valid_path(base, [combined] + remaining[2:])
-            if result:
-                return result
-
-    return None
-
-
 def _decode_project_path_windows(encoded: str) -> Optional[str]:
     drive_match = re.match(r"^([A-Za-z])-(.*)$", encoded)
     if not drive_match:
@@ -1461,43 +1498,13 @@ def _decode_project_path_windows(encoded: str) -> Optional[str]:
 
     segments = rest.split("-")
     base = f"{drive_letter}:\\"
-    result = _find_valid_path_windows(base, segments)
+    result = find_valid_claude_path(base, segments)
     if result:
         return result
 
     return simple
 
 
-def _find_valid_path_windows(base: str, remaining: list[str]) -> Optional[str]:
-    if not remaining:
-        return base if os.path.exists(base) else None
-
-    if remaining[0] == "" and len(remaining) >= 2 and remaining[1]:
-        for prefix in (".", "-"):
-            result = _find_valid_path_windows(
-                base,
-                [prefix + remaining[1], *remaining[2:]],
-            )
-            if result:
-                return result
-
-    next_segment = remaining[0]
-    with_slash = os.path.join(base, next_segment)
-    if os.path.exists(with_slash):
-        result = _find_valid_path_windows(with_slash, remaining[1:])
-        if result:
-            return result
-
-    if len(remaining) >= 2:
-        for delimiter in ("-", "."):
-            combined = remaining[0] + delimiter + remaining[1]
-            result = _find_valid_path_windows(base, [combined] + remaining[2:])
-            if result:
-                return result
-
-    return None
-
-
 def _encode_claude_project_path_variant(
     project_path: str, *, dot_mode: str
 ) -> str:
@@ -1527,7 +1534,7 @@ def _encode_claude_path_segment(
     segment: str, *, dot_mode: str
 ) -> str:
     if dot_mode == "all_as_hyphen":
-        return segment.replace(".", "-")
+        return segment.replace(".", "-").replace("_", "-")
     if dot_mode == "hidden_only" and segment.startswith(".") and len(segment) > 1:
         return "-" + segment[1:]
     return segment

{nmem_cli-0.8.0 → nmem_cli-0.8.3}/src/nmem_cli/tui/screens/settings.py

@@ -54,7 +54,7 @@ PROVIDER_DEFAULTS: dict[str, dict[str, str]] = {
     "anthropic": {"model": "claude-sonnet-4-20250514", "api_base": "https://api.anthropic.com"},
     "gemini": {"model": "gemini-flash-latest", "api_base": "https://generativelanguage.googleapis.com"},
     "xai": {"model": "grok-3", "api_base": "https://api.x.ai/v1"},
-    "deepseek": {"model": "deepseek-chat", "api_base": "https://api.deepseek.com/v1"},
+    "deepseek": {"model": "deepseek-v4-flash", "api_base": "https://api.deepseek.com/v1"},
     "openrouter": {"model": "anthropic/claude-sonnet-4", "api_base": "https://openrouter.ai/api/v1"},
     "github_copilot": {"model": "gpt-5-mini"},
     "openai_codex": {"model": "gpt-5.2-codex"},