nmem-cli 0.7.6__tar.gz → 0.7.9__tar.gz

nmem_cli-0.7.9/.gitignore

@@ -0,0 +1 @@
+config.env

{nmem_cli-0.7.6 → nmem_cli-0.7.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nmem-cli
-Version: 0.7.6
+Version: 0.7.9
 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.7.6 → nmem_cli-0.7.9}/pyproject.toml

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

{nmem_cli-0.7.6 → nmem_cli-0.7.9}/src/nmem_cli/__init__.py

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

{nmem_cli-0.7.6 → nmem_cli-0.7.9}/src/nmem_cli/cli.py

@@ -557,6 +557,43 @@ def _is_loopback_hostname(hostname: str | None) -> bool:
         return False
 
 
+def _httpx_transport_kwargs(url: str) -> dict[str, Any]:
+    """Disable environment proxy settings for loopback URLs.
+
+    Windows proxy configuration can incorrectly capture localhost traffic for
+    CLI/TUI requests. Loopback calls should always go directly to the local Mem
+    server instead of honoring system proxy settings.
+    """
+    try:
+        hostname = urlsplit(url).hostname
+    except Exception:
+        hostname = None
+    return {"trust_env": False} if _is_loopback_hostname(hostname) else {}
+
+
+def _merge_httpx_kwargs(url: str, kwargs: dict[str, Any]) -> dict[str, Any]:
+    merged = dict(kwargs)
+    for key, value in _httpx_transport_kwargs(url).items():
+        merged.setdefault(key, value)
+    return merged
+
+
+def _httpx_request(method: str, url: str, **kwargs: Any) -> httpx.Response:
+    return httpx.request(method, url, **_merge_httpx_kwargs(url, kwargs))
+
+
+def _httpx_get(url: str, **kwargs: Any) -> httpx.Response:
+    return httpx.get(url, **_merge_httpx_kwargs(url, kwargs))
+
+
+def _httpx_post(url: str, **kwargs: Any) -> httpx.Response:
+    return httpx.post(url, **_merge_httpx_kwargs(url, kwargs))
+
+
+def _httpx_stream(method: str, url: str, **kwargs: Any):
+    return httpx.stream(method, url, **_merge_httpx_kwargs(url, kwargs))
+
+
 def _iter_local_management_base_urls() -> list[str]:
     candidates: list[str] = []
     seen: set[str] = set()
@@ -585,7 +622,7 @@ def _iter_local_management_base_urls() -> list[str]:
 def _request_local_remote_access_management(path: str) -> dict[str, Any] | None:
     for base_url in _iter_local_management_base_urls():
         try:
-            response = httpx.post(f"{base_url}{path}", timeout=10.0)
+            response = _httpx_post(f"{base_url}{path}", timeout=10.0)
         except httpx.RequestError:
             continue
 
@@ -744,7 +781,7 @@ def api_request(
         merged_headers.update(headers)
 
     cookies = get_api_cookies() or None
-    response = httpx.request(
+    response = _httpx_request(
         method,
         url,
         params=params,
@@ -760,7 +797,7 @@ def api_request(
     # If auth headers are stripped in transit, retry once with query-key fallback.
     if get_api_key() and _is_missing_api_key_response(response):
         retry_params = _build_params_with_query_key(params)
-        response = httpx.request(
+        response = _httpx_request(
             method,
             url,
             params=retry_params,
@@ -779,7 +816,7 @@ def api_request(
         compat_url = _strip_remote_api_path_prefix(url)
         if compat_url != url:
             retry_params = _build_params_with_query_key(params)
-            response = httpx.request(
+            response = _httpx_request(
                 method,
                 compat_url,
                 params=retry_params,
@@ -1636,7 +1673,7 @@ def _plugin_detection_probes() -> (
 def _fetch_plugin_registry() -> list[dict]:
     """Fetch the community integrations registry. Uses cache on failure. Never raises."""
     try:
-        resp = httpx.get(_REGISTRY_URL, timeout=10.0, headers={"User-Agent": f"nmem-cli/{__version__}"})
+        resp = _httpx_get(_REGISTRY_URL, timeout=10.0, headers={"User-Agent": f"nmem-cli/{__version__}"})
         resp.raise_for_status()
         data = resp.json()
         # Cache for offline use
@@ -4523,8 +4560,10 @@ def cmd_threads_save(
             )
         sys.exit(1)
 
-    # Resolve project path
-    resolved_path = Path(project_path).resolve()
+    # Use an absolute lexical path instead of resolving symlinks. Session stores
+    # record the user's working directory string, not the filesystem canonical
+    # realpath, so eager resolve() can drift from Claude/Codex/Gemini metadata.
+    resolved_path = Path(project_path).expanduser().absolute()
     if not resolved_path.exists():
         if is_json_mode():
             output_json({"error": "path_not_found", "path": str(resolved_path)})
@@ -5171,7 +5210,7 @@ def cmd_sources_list(
         return
 
     if not sources:
-        console.print("[dim]No sources in library[/dim]")
+        console.print("[dim]No artifacts in Library[/dim]")
         return
 
     table = Table(show_header=True, header_style="bold", box=None, pad_edge=False)
@@ -5219,7 +5258,7 @@ def cmd_sources_show(source_id: str, space_id: str | None = None) -> None:
         return
 
     console.print(f"\n[bold]{data.get('original_name', source_id)}[/bold]")
-    console.print(f"  [dim]ID[/dim]        {data.get('id', '')}")
+    console.print(f"  [dim]Artifact ID[/dim] {data.get('id', '')}")
     console.print(f"  [dim]Type[/dim]      {data.get('source_type', '')}")
     console.print(f"  [dim]MIME[/dim]      {data.get('mime_type', '')}")
     console.print(f"  [dim]State[/dim]     {data.get('lifecycle_state', '')}")
@@ -5275,9 +5314,9 @@ def cmd_sources_delete(
 
     if not normalized_ids:
         if is_json_mode():
-            output_json({"error": "invalid_input", "message": "No source IDs provided"})
+            output_json({"error": "invalid_input", "message": "No artifact IDs provided"})
         else:
-            print_error("Invalid Input", "No source IDs provided")
+            print_error("Invalid Input", "No artifact IDs provided")
         return
 
     if dry_run:
@@ -5316,14 +5355,14 @@ def cmd_sources_delete(
                 else:
                     console.print(f"  [yellow]- not found[/yellow] [dim]{p['id']}[/dim]")
             n = len(normalized_ids)
-            console.print(f"\n  [dim]{found} of {n} {'source' if n == 1 else 'sources'} found, would be deleted.[/dim]")
+            console.print(f"\n  [dim]{found} of {n} {'artifact' if n == 1 else 'artifacts'} found, would be deleted.[/dim]")
         return
 
     if not force and not is_json_mode():
         if len(normalized_ids) == 1:
-            prompt = f"Delete source {normalized_ids[0]}? This removes all files, chunks, and graph links."
+            prompt = f"Delete artifact {normalized_ids[0]}? This removes all files, chunks, and graph links."
         else:
-            prompt = f"Delete {len(normalized_ids)} sources? This removes all files, chunks, and graph links."
+            prompt = f"Delete {len(normalized_ids)} artifacts? This removes all files, chunks, and graph links."
         if not Confirm.ask(prompt):
             console.print("[dim]Cancelled[/dim]")
             return
@@ -5364,7 +5403,7 @@ def cmd_sources_delete(
         # api_delete already prints error on failure
     else:
         if failed == 0:
-            print_success("Deleted", f"{deleted} sources")
+            print_success("Deleted", f"{deleted} artifacts")
         else:
             print_error(
                 "Bulk delete completed with failures",
@@ -5372,6 +5411,250 @@ def cmd_sources_delete(
             )
 
 
+def cmd_sources_search(
+    query: str,
+    limit: int = 20,
+    space_id: str | None = None,
+) -> None:
+    """Search across Library artifact names and summaries (FTS)."""
+    params: dict[str, Any] = {"q": query, "limit": limit}
+    if space_id:
+        params["space_id"] = space_id
+
+    if not is_json_mode():
+        with Progress(
+            SpinnerColumn(),
+            TextColumn(f"[cyan]Searching Library for '{query}'...[/cyan]"),
+            console=console,
+            transient=True,
+        ) as p:
+            p.add_task("", total=None)
+            data = api_get("/sources/search", params=params, timeout=30.0)
+    else:
+        data = api_get("/sources/search", params=params, timeout=30.0)
+
+    results = data.get("results", [])
+
+    if is_json_mode():
+        output_json(data)
+        return
+
+    if not results:
+        console.print(f"[dim]No Library artifacts matched '{query}'[/dim]")
+        return
+
+    console.print(
+        f"[green]Found {len(results)} matches[/green] for [cyan]{query}[/cyan]\n"
+    )
+    table = Table(show_header=True, header_style="bold", box=None, pad_edge=False)
+    table.add_column("ID", style="cyan", no_wrap=True)
+    table.add_column("Title")
+    table.add_column("Type", style="dim")
+    table.add_column("Score", justify="right", width=6)
+    table.add_column("Snippet", style="dim")
+    for r in results:
+        table.add_row(
+            r.get("source_id", ""),
+            truncate(r.get("title", ""), 40),
+            r.get("source_type", ""),
+            format_score(r.get("score", 0.0)),
+            truncate(r.get("snippet", ""), 60),
+        )
+    console.print(table)
+
+
+def cmd_sources_read(
+    source_id: str,
+    offset: int = 0,
+    limit: int = 8000,
+    space_id: str | None = None,
+) -> None:
+    """Read the parsed content of a Library artifact."""
+    params: dict[str, Any] = {
+        "offset": offset,
+        "limit": limit,
+    }
+    if space_id:
+        params["space_id"] = space_id
+
+    if not is_json_mode():
+        with Progress(
+            SpinnerColumn(),
+            TextColumn("[cyan]Loading artifact content...[/cyan]"),
+            console=console,
+            transient=True,
+        ) as p:
+            p.add_task("", total=None)
+            data = api_get(f"/sources/{source_id}/content", params=params or None, timeout=30.0)
+    else:
+        data = api_get(f"/sources/{source_id}/content", params=params or None, timeout=30.0)
+
+    window = data.get("content", "") or ""
+    total_length_value = data.get("total_length")
+    returned_length_value = data.get("returned_length")
+    window_offset_value = data.get("offset")
+    total_length = int(total_length_value) if total_length_value is not None else len(window)
+    returned_length = (
+        int(returned_length_value) if returned_length_value is not None else len(window)
+    )
+    window_offset = int(window_offset_value) if window_offset_value is not None else offset
+    window_end = window_offset + returned_length
+    has_more = bool(data.get("has_more"))
+
+    if is_json_mode():
+        output_json({
+            "source_id": source_id,
+            "original_name": data.get("original_name", ""),
+            "offset": window_offset,
+            "returned_length": returned_length,
+            "total_length": total_length,
+            "has_more": has_more,
+            "content": window,
+        })
+        return
+
+    console.print(f"\n[bold]{data.get('original_name', source_id)}[/bold]")
+    console.print(f"  [dim]Artifact ID[/dim] {source_id}")
+    console.print(
+        f"  [dim]Bytes[/dim] {window_offset}..{window_end} of {total_length}"
+    )
+    console.print()
+    console.print(window)
+    if has_more:
+        console.print(
+            f"\n[dim]... {total_length - window_end} more characters. Use --offset {window_end} to continue.[/dim]"
+        )
+
+
+def cmd_sources_search_chunks(
+    source_id: str,
+    query: str,
+    limit: int = 5,
+    space_id: str | None = None,
+) -> None:
+    """Search within a single artifact's indexed chunks (BM25)."""
+    arguments: dict[str, Any] = {
+        "source_id": source_id,
+        "query": query,
+        "limit": limit,
+    }
+    if space_id:
+        arguments["space_id"] = space_id
+
+    if not is_json_mode():
+        with Progress(
+            SpinnerColumn(),
+            TextColumn(f"[cyan]Searching artifact sections for '{query}'...[/cyan]"),
+            console=console,
+            transient=True,
+        ) as p:
+            p.add_task("", total=None)
+            data = api_mcp_tool_call("search_source_chunks", arguments)
+    else:
+        data = api_mcp_tool_call("search_source_chunks", arguments)
+
+    if is_json_mode():
+        output_json(data)
+        return
+
+    if data.get("status") == "error":
+        print_error("Search failed", data.get("error", "Unknown error"))
+        return
+
+    chunks = data.get("chunks", [])
+    source_name = data.get("source_name") or source_id
+    if not chunks:
+        console.print(f"[dim]No chunks matched '{query}' in {source_name}[/dim]")
+        return
+
+    console.print(
+        f"[green]Matched {len(chunks)}[/green] of {data.get('total_chunks', '?')} chunks "
+        f"in [bold]{source_name}[/bold]\n"
+    )
+    for i, chunk in enumerate(chunks, 1):
+        idx = chunk.get("chunk_index")
+        score = chunk.get("score")
+        score_str = f" [dim]score={format_score(score)}[/dim]" if score is not None else ""
+        idx_str = f"chunk {idx}" if idx is not None else f"match {i}"
+        console.print(f"[bold cyan]{idx_str}[/bold cyan]{score_str}")
+        text = chunk.get("text", "")
+        preview = text if len(text) < 800 else text[:800] + "..."
+        console.print(preview)
+        console.print()
+
+
+def cmd_sources_analyze(
+    source_id: str,
+    columns: list[str] | None = None,
+    space_id: str | None = None,
+) -> None:
+    """Analyze a tabular Library artifact (CSV/TSV/XLSX/XLS)."""
+    arguments: dict[str, Any] = {"source_id": source_id}
+    if columns:
+        arguments["columns"] = columns
+    if space_id:
+        arguments["space_id"] = space_id
+
+    if not is_json_mode():
+        with Progress(
+            SpinnerColumn(),
+            TextColumn("[cyan]Analyzing artifact...[/cyan]"),
+            console=console,
+            transient=True,
+        ) as p:
+            p.add_task("", total=None)
+            data = api_mcp_tool_call("analyze_source_data", arguments)
+    else:
+        data = api_mcp_tool_call("analyze_source_data", arguments)
+
+    if is_json_mode():
+        output_json(data)
+        return
+
+    if data.get("status") == "error":
+        print_error("Analysis failed", data.get("error", "Unknown error"))
+        return
+
+    source_name = data.get("source_name") or source_id
+    console.print(f"\n[bold]{source_name}[/bold]")
+    sheets = data.get("sheets") or ([data] if data.get("columns") else [])
+    if not sheets:
+        console.print("[dim]Analyzer returned no sheet data[/dim]")
+        console.print()
+        console.print_json(data=data)
+        return
+
+    for sheet in sheets:
+        sheet_name = sheet.get("sheet_name") or sheet.get("name")
+        if sheet_name:
+            console.print(f"\n[bold]Sheet:[/bold] {sheet_name}")
+        rows = sheet.get("row_count") or sheet.get("rows")
+        cols_meta = sheet.get("columns") or []
+        if rows is not None:
+            console.print(f"  [dim]Rows[/dim]    {rows}")
+        if cols_meta:
+            console.print(f"  [dim]Columns[/dim] {len(cols_meta)}")
+            table = Table(show_header=True, header_style="bold", box=None, pad_edge=False)
+            table.add_column("Column", style="cyan")
+            table.add_column("Type", style="dim")
+            table.add_column("Non-null", justify="right")
+            table.add_column("Summary", style="dim")
+            for col in cols_meta:
+                name = col.get("name", "")
+                dtype = col.get("dtype", col.get("type", ""))
+                non_null = col.get("non_null_count", col.get("count", ""))
+                summary_bits: list[str] = []
+                if col.get("min") is not None and col.get("max") is not None:
+                    summary_bits.append(f"min={col['min']} max={col['max']}")
+                if col.get("mean") is not None:
+                    summary_bits.append(f"mean={col['mean']:.2f}")
+                if col.get("top"):
+                    summary_bits.append(f"top={col['top']}")
+                table.add_row(name, str(dtype), str(non_null), ", ".join(summary_bits))
+            console.print(table)
+    console.print()
+
+
 def cmd_sources_add(
     targets: list[str],
     comment: str | None = None,
@@ -5572,7 +5855,7 @@ def _get_remote_access_status() -> dict[str, Any] | None:
     """Fetch Access Anywhere status from the local backend (GET)."""
     for base_url in _iter_local_management_base_urls():
         try:
-            response = httpx.get(
+            response = _httpx_get(
                 f"{base_url}/api/remote-access/status", timeout=10.0
             )
         except httpx.RequestError:
@@ -6411,7 +6694,7 @@ def _check_for_update(platform_id: str) -> Optional[dict]:
     """Call backbone API to check for updates.  Returns parsed JSON or None."""
     url = f"{_UPDATE_CHECK_URL}?platform={platform_id}&secure=false"
     try:
-        resp = httpx.get(
+        resp = _httpx_get(
             url,
             headers={"Accept": "application/json", "User-Agent": _UPDATE_USER_AGENT},
             timeout=30.0,
@@ -6922,7 +7205,7 @@ def _update_appimage(yes: bool) -> None:
     ) as p:
         p.add_task("", total=None)
         try:
-            resp = httpx.get(
+            resp = _httpx_get(
                 f"{_UPDATE_CHECK_URL}?platform=linux-appimage&secure=true",
                 headers={"Accept": "application/json", "User-Agent": _UPDATE_USER_AGENT},
                 timeout=30.0,
@@ -7008,7 +7291,7 @@ def _update_appimage(yes: bool) -> None:
                 suffix=".AppImage", dir=str(appimage_path.parent), delete=False,
             ) as tmp:
                 temp_path = Path(tmp.name)
-                with httpx.stream(
+                with _httpx_stream(
                     "GET", download_url, timeout=600.0, follow_redirects=True,
                 ) as stream:
                     stream.raise_for_status()
@@ -8480,9 +8763,9 @@ EXAMPLES
   nmem wm patch --heading "## Notes" --append "extra note"     Append to a section
   nmem wm history                   List past WM dates
   nmem --json m search "x"          JSON output
-  nmem s                             List sources in library
-  nmem s show <id>                   Show source details
-  nmem s delete <id>                 Delete a source
+  nmem library                       List Library artifacts
+  nmem library show <id>             Show artifact details
+  nmem library delete <id>           Delete an artifact
   nmem g expand <id>                 Graph connections for a memory
   nmem f                             Activity feed (last 7 days)
   nmem f --days 1                    Today's activity
@@ -8493,7 +8776,8 @@ ALIASES
   m  = memories
   t  = threads
   wm = working-memory
-  s  = sources
+  l  = library
+  s  = sources (legacy alias)
   g  = graph
   f  = feed
   c  = communities
@@ -9506,25 +9790,31 @@ PRIORITY
     spaces_subs.add_parser("enable", help="Turn on memory spaces")
     spaces_subs.add_parser("disable", help="Turn off memory spaces (only when no extra spaces remain)")
 
-    # sources (with alias 's')
-    for name in ["sources", "s"]:
+    # library artifacts (legacy aliases: sources, s)
+    for name, help_text in [
+        ("library", "Library — files, web pages, notes, and other artifacts"),
+        ("lib", argparse.SUPPRESS),
+        ("l", argparse.SUPPRESS),
+        ("sources", argparse.SUPPRESS),
+        ("s", argparse.SUPPRESS),
+    ]:
         src_parser = subparsers.add_parser(
-            name, help="Source library — files, URLs, documents", parents=[_ambient_space_parent]
+            name, help=help_text, parents=[_ambient_space_parent]
         )
         src_subs = src_parser.add_subparsers(dest="action")
 
         ls = src_subs.add_parser(
             "list",
-            help="List sources (default)",
+            help="List Library artifacts (default)",
             parents=[_space_parent],
             epilog="""examples:
-  nmem s
-  nmem s list --type url -n 50
-  nmem s list --state error""",
+  nmem library
+  nmem library list --type url -n 50
+  nmem library list --state error""",
             formatter_class=argparse.RawDescriptionHelpFormatter,
         )
         ls.add_argument(
-            "-n", "--limit", type=int, default=20, help="Max sources to show"
+            "-n", "--limit", type=int, default=20, help="Max artifacts to show"
         )
         ls.add_argument(
             "--type", dest="source_type",
@@ -9548,7 +9838,7 @@ PRIORITY
         add.add_argument("target", nargs="+", help="File path(s) or URL(s) to ingest")
         add.add_argument(
             "-c", "--comment", dest="user_comment",
-            help="Comment about the source",
+            help="Comment about the artifact",
         )
         add.add_argument(
             "-l", "--label", dest="labels", action="append",
@@ -9557,26 +9847,26 @@ PRIORITY
 
         sh = src_subs.add_parser(
             "show",
-            help="Show source details",
+            help="Show artifact details",
             parents=[_space_parent],
             epilog="""examples:
-  nmem s show src-abc123
-  nmem --json s show src-abc123""",
+  nmem library show src-abc123
+  nmem --json library show src-abc123""",
             formatter_class=argparse.RawDescriptionHelpFormatter,
         )
-        sh.add_argument("id", help="Source ID")
+        sh.add_argument("id", help="Artifact ID")
 
         d = src_subs.add_parser(
             "delete",
-            help="Delete source(s)",
+            help="Delete artifact(s)",
             parents=[_space_parent],
             epilog="""examples:
-  nmem s delete src-abc123
-  nmem s delete src-abc123 src-def456 --force
-  nmem s delete src-abc123 --dry-run""",
+  nmem library delete src-abc123
+  nmem library delete src-abc123 src-def456 --force
+  nmem library delete src-abc123 --dry-run""",
             formatter_class=argparse.RawDescriptionHelpFormatter,
         )
-        d.add_argument("id", nargs="+", help="Source ID(s) to delete")
+        d.add_argument("id", nargs="+", help="Artifact ID(s) to delete")
         d.add_argument(
             "-f", "--force", action="store_true",
             help="Skip confirmation prompt",
@@ -9586,6 +9876,69 @@ PRIORITY
             help="Preview what would be deleted without making changes",
         )
 
+        srch = src_subs.add_parser(
+            "search",
+            help="Search Library artifacts by name/summary (FTS)",
+            parents=[_space_parent],
+            epilog="""examples:
+  nmem library search "meeting notes"
+  nmem library search roadmap -n 10""",
+            formatter_class=argparse.RawDescriptionHelpFormatter,
+        )
+        srch.add_argument("query", help="Search query")
+        srch.add_argument(
+            "-n", "--limit", type=int, default=20, help="Max results (default 20)"
+        )
+
+        rd = src_subs.add_parser(
+            "read",
+            help="Read parsed artifact content",
+            parents=[_space_parent],
+            epilog="""examples:
+  nmem library read src-abc123
+  nmem library read src-abc123 --offset 8000 --limit 8000""",
+            formatter_class=argparse.RawDescriptionHelpFormatter,
+        )
+        rd.add_argument("id", help="Artifact ID")
+        rd.add_argument(
+            "--offset", type=int, default=0, help="Character offset (default 0)"
+        )
+        rd.add_argument(
+            "--limit", type=int, default=8000,
+            help="Max characters to return (default 8000)",
+        )
+
+        sc = src_subs.add_parser(
+            "search-chunks",
+            help="Search within an artifact's indexed chunks",
+            parents=[_space_parent],
+            epilog="""examples:
+  nmem library search-chunks src-abc123 "risk factors"
+  nmem library search-chunks src-abc123 budget -n 3""",
+            formatter_class=argparse.RawDescriptionHelpFormatter,
+        )
+        sc.add_argument("id", help="Artifact ID")
+        sc.add_argument("query", help="Search query")
+        sc.add_argument(
+            "-n", "--limit", type=int, default=5,
+            help="Max matching chunks (1-20, default 5)",
+        )
+
+        an = src_subs.add_parser(
+            "analyze",
+            help="Analyze tabular artifact (CSV/TSV/XLSX/XLS)",
+            parents=[_space_parent],
+            epilog="""examples:
+  nmem library analyze src-abc123
+  nmem library analyze src-abc123 --column price --column region""",
+            formatter_class=argparse.RawDescriptionHelpFormatter,
+        )
+        an.add_argument("id", help="Artifact ID")
+        an.add_argument(
+            "--column", dest="columns", action="append",
+            help="Column name to analyze (repeatable)",
+        )
+
     # license
     lic_parser = subparsers.add_parser("license", help="License management")
     lic_subs = lic_parser.add_subparsers(dest="action")
@@ -10213,7 +10566,7 @@ def main() -> int:
             cmd_spaces_set_enabled(False)
         else:
             cmd_spaces_list()
-    elif cmd in ("sources", "s"):
+    elif cmd in ("library", "lib", "l", "sources", "s"):
         action = args.action
         if action == "add":
             cmd_sources_add(
@@ -10226,6 +10579,32 @@ def main() -> int:
             cmd_sources_show(args.id, getattr(args, "space", None))
         elif action == "delete":
             cmd_sources_delete(args.id, getattr(args, "force", False), getattr(args, "dry_run", False), getattr(args, "space", None))
+        elif action == "search":
+            cmd_sources_search(
+                query=args.query,
+                limit=getattr(args, "limit", 20),
+                space_id=getattr(args, "space", None),
+            )
+        elif action == "read":
+            cmd_sources_read(
+                source_id=args.id,
+                offset=getattr(args, "offset", 0),
+                limit=getattr(args, "limit", 8000),
+                space_id=getattr(args, "space", None),
+            )
+        elif action == "search-chunks":
+            cmd_sources_search_chunks(
+                source_id=args.id,
+                query=args.query,
+                limit=getattr(args, "limit", 5),
+                space_id=getattr(args, "space", None),
+            )
+        elif action == "analyze":
+            cmd_sources_analyze(
+                source_id=args.id,
+                columns=getattr(args, "columns", None),
+                space_id=getattr(args, "space", None),
+            )
         else:
             # Default: list
             cmd_sources_list(

{nmem_cli-0.7.6 → nmem_cli-0.7.9}/src/nmem_cli/session_import.py

@@ -29,6 +29,30 @@ from typing import Any, Optional
 logger = logging.getLogger(__name__)
 
 
+def _project_path_variants(project_path: str) -> list[str]:
+    variants: list[str] = []
+
+    def _add(candidate: str | None) -> None:
+        if not candidate:
+            return
+        normalized = os.path.normpath(candidate)
+        if normalized not in variants:
+            variants.append(normalized)
+
+    expanded = os.path.expanduser(project_path)
+    _add(expanded)
+    _add(os.path.abspath(expanded))
+    _add(os.path.realpath(expanded))
+
+    for existing in list(variants):
+        if existing.startswith("/private/"):
+            _add(existing[len("/private"):])
+        elif existing.startswith(("/var/", "/tmp/", "/etc/")):
+            _add("/private" + existing)
+
+    return variants
+
+
 def _env_path(env_var: str, default: Path) -> Path:
     raw = os.environ.get(env_var, "").strip()
     if not raw:
@@ -47,33 +71,45 @@ def _get_codex_sessions_dir() -> Path:
 def _encode_claude_project_path(project_path: str) -> str:
     return _encode_claude_project_path_variant(
         project_path,
-        preserve_hidden_dot=False,
+        dot_mode="all_as_hyphen",
+    )
+
+
+def _encode_claude_project_path_hidden_dot_compat(project_path: str) -> str:
+    return _encode_claude_project_path_variant(
+        project_path,
+        dot_mode="hidden_only",
     )
 
 
 def _encode_claude_project_path_legacy(project_path: str) -> str:
     return _encode_claude_project_path_variant(
         project_path,
-        preserve_hidden_dot=True,
+        dot_mode="preserve",
     )
 
 
 def _resolve_claude_project_dir(project_path: str) -> tuple[Optional[Path], Path]:
     claude_projects_dir = _get_claude_projects_dir()
+    project_path_variants = _project_path_variants(project_path)
     candidate_dirs: list[Path] = []
-    for encoded in (
-        _encode_claude_project_path(project_path),
-        _encode_claude_project_path_legacy(project_path),
-    ):
-        candidate = claude_projects_dir / encoded
-        if candidate not in candidate_dirs:
-            candidate_dirs.append(candidate)
+    for path_variant in project_path_variants:
+        for encoded in (
+            _encode_claude_project_path(path_variant),
+            _encode_claude_project_path_hidden_dot_compat(path_variant),
+            _encode_claude_project_path_legacy(path_variant),
+        ):
+            candidate = claude_projects_dir / encoded
+            if candidate not in candidate_dirs:
+                candidate_dirs.append(candidate)
 
     for candidate in candidate_dirs:
         if candidate.exists() and candidate.is_dir():
             return candidate, candidate_dirs[0]
 
-    normalized_project_path = _normalize_project_path(project_path)
+    normalized_project_paths = {
+        _normalize_project_path(path_variant) for path_variant in project_path_variants
+    }
     if claude_projects_dir.exists() and claude_projects_dir.is_dir():
         for project_dir in claude_projects_dir.iterdir():
             if not project_dir.is_dir():
@@ -82,7 +118,7 @@ def _resolve_claude_project_dir(project_path: str) -> tuple[Optional[Path], Path
             decoded_path = _decode_claude_project_dir_name(project_dir.name)
             if (
                 decoded_path is not None
-                and _normalize_project_path(decoded_path) == normalized_project_path
+                and _normalize_project_path(decoded_path) in normalized_project_paths
             ):
                 return project_dir, candidate_dirs[0]
 
@@ -1391,10 +1427,11 @@ def _find_valid_path(base: str, remaining: list[str]) -> Optional[str]:
             return result
 
     if len(remaining) >= 2:
-        combined = remaining[0] + "-" + remaining[1]
-        result = _find_valid_path(base, [combined] + remaining[2:])
-        if result:
-            return result
+        for delimiter in ("-", "."):
+            combined = remaining[0] + delimiter + remaining[1]
+            result = _find_valid_path(base, [combined] + remaining[2:])
+            if result:
+                return result
 
     return None
 
@@ -1441,16 +1478,17 @@ def _find_valid_path_windows(base: str, remaining: list[str]) -> Optional[str]:
             return result
 
     if len(remaining) >= 2:
-        combined = remaining[0] + "-" + remaining[1]
-        result = _find_valid_path_windows(base, [combined] + remaining[2:])
-        if result:
-            return result
+        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, *, preserve_hidden_dot: bool
+    project_path: str, *, dot_mode: str
 ) -> str:
     windows_match = re.match(r"^([A-Za-z]):[\\/](.*)$", project_path)
     if windows_match:
@@ -1459,7 +1497,7 @@ def _encode_claude_project_path_variant(
         segments = [
             _encode_claude_path_segment(
                 segment,
-                preserve_hidden_dot=preserve_hidden_dot,
+                dot_mode=dot_mode,
             )
             for segment in re.split(r"[\\/]+", rest)
             if segment
@@ -1467,7 +1505,7 @@ def _encode_claude_project_path_variant(
         return "-".join([drive_letter, *segments]) if segments else drive_letter
 
     segments = [
-        _encode_claude_path_segment(segment, preserve_hidden_dot=preserve_hidden_dot)
+        _encode_claude_path_segment(segment, dot_mode=dot_mode)
         for segment in project_path.replace("\\", "/").split("/")
         if segment
     ]
@@ -1475,9 +1513,11 @@ def _encode_claude_project_path_variant(
 
 
 def _encode_claude_path_segment(
-    segment: str, *, preserve_hidden_dot: bool
+    segment: str, *, dot_mode: str
 ) -> str:
-    if not preserve_hidden_dot and segment.startswith(".") and len(segment) > 1:
+    if dot_mode == "all_as_hyphen":
+        return segment.replace(".", "-")
+    if dot_mode == "hidden_only" and segment.startswith(".") and len(segment) > 1:
         return "-" + segment[1:]
     return segment
 

{nmem_cli-0.7.6 → nmem_cli-0.7.9}/src/nmem_cli/tui/api_client.py

@@ -79,6 +79,7 @@ class ApiClient:
                 timeout=30.0,
                 headers=self._headers,
                 cookies=self._cookies,
+                trust_env=self.is_remote,
             )
         return self._client
 

nmem_cli-0.7.6/.gitignore

@@ -1,5 +0,0 @@
-config.env
-
-# Generated agent prompts — source of truth is embedded_prompts.py
-src/nowledge_graph_server/agent/feed_agent_system.md
-src/nowledge_graph_server/agent/system_prompt.md