brainplug 0.4.0__tar.gz → 0.4.1__tar.gz

{brainplug-0.4.0 → brainplug-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: brainplug
-Version: 0.4.0
+Version: 0.4.1
 Summary: A second brain for you and your AI assistants: a 3D map of everything you write and a memory they plug into. 100% local.
 Author: Juan Rodríguez
 License-Expression: MIT
@@ -65,9 +65,7 @@ brainplug doctor ~/Documents/MyVault          # checks that it answers, end to e
 ```
 
 `brainplug brain ~/Documents/MyVault --draft-about` writes a first draft of your "About me"
-note from what you have written, while it is still empty. Until the first release reaches PyPI,
-install it from GitHub:
-`uv tool install "brainplug @ git+https://github.com/juanmariarodriguez2-png/brainplug"`.
+note from what you have written, while it is still empty.
 Add `--sessions` to `connect` to include what you typed to Claude Code and Codex, and put
 export files after the vault to include what you wrote before (`… MyVault chatgpt-export.zip`).
 

{brainplug-0.4.0 → brainplug-0.4.1}/README.md

@@ -29,9 +29,7 @@ brainplug doctor ~/Documents/MyVault          # checks that it answers, end to e
 ```
 
 `brainplug brain ~/Documents/MyVault --draft-about` writes a first draft of your "About me"
-note from what you have written, while it is still empty. Until the first release reaches PyPI,
-install it from GitHub:
-`uv tool install "brainplug @ git+https://github.com/juanmariarodriguez2-png/brainplug"`.
+note from what you have written, while it is still empty.
 Add `--sessions` to `connect` to include what you typed to Claude Code and Codex, and put
 export files after the vault to include what you wrote before (`… MyVault chatgpt-export.zip`).
 

{brainplug-0.4.0 → brainplug-0.4.1}/brainplug/__init__.py

@@ -1,3 +1,3 @@
 """Brainplug: turn your AI chat history into a 3D map of your mind."""
 
-__version__ = "0.4.0"
+__version__ = "0.4.1"

{brainplug-0.4.0 → brainplug-0.4.1}/brainplug/__main__.py

@@ -174,6 +174,11 @@ def main(argv: list[str] | None = None) -> int:
         vault = getattr(args, "brain", None) or getattr(args, "vault", None)
         if args.cmd == "mcp" and not args.inputs and not args.notion and not vault and not args.sessions:
             ap.error("mcp needs your vault or your files, e.g.: brainplug mcp --brain ~/Vault export.zip")
+        if vault and not Path(vault).expanduser().is_dir():
+            if args.cmd == "mcp" or args.remember or args.review or args.context or args.draft_about:
+                ap.error(f'{vault} does not exist. Check the path; to start a new, empty brain there, '
+                         f'run: brainplug brain "{vault}"')
+            print(f"Creating a new folder for your brain: {Path(vault).expanduser().resolve()}")
         if args.cmd == "brain" and args.remember:
             path = memory.remember(vault, args.remember, kind=args.kind, pin=args.pin, source="me")
             print(f"Saved {path.resolve()}")

{brainplug-0.4.0 → brainplug-0.4.1}/brainplug/connect.py

@@ -64,11 +64,24 @@ class Client:
         return bool((self.cli and shutil.which(self.cli)) or (self.marker and self.marker.exists()))
 
 
+def _claude_desktop() -> list[Client]:
+    """Claude Desktop reads %APPDATA%\\Claude (or the macOS/Linux equivalent). Installed as a Windows
+    app package (MSIX), it reads a virtualized copy instead, under
+    %LOCALAPPDATA%\\Packages\\Claude_<id>\\LocalCache\\Roaming\\Claude, and its own "Edit Config"
+    button may open the copy it does not read. Both get the entry when both exist."""
+    found = [Client("claude-desktop", "Claude Desktop", _app_config("Claude") / "claude_desktop_config.json",
+                    marker=_app_config("Claude"))]
+    local = os.environ.get("LOCALAPPDATA")
+    for package in sorted(Path(local).glob("Packages/Claude_*")) if local else []:
+        folder = package / "LocalCache" / "Roaming" / "Claude"
+        found.append(Client("claude-desktop", "Claude Desktop", folder / "claude_desktop_config.json", marker=package))
+    return found
+
+
 def clients() -> list[Client]:
     home = _home()
     return [
-        Client("claude-desktop", "Claude Desktop", _app_config("Claude") / "claude_desktop_config.json",
-               marker=_app_config("Claude")),
+        *_claude_desktop(),
         Client("claude-code", "Claude Code", cli="claude", marker=home / ".claude"),
         Client("cursor", "Cursor", home / ".cursor" / "mcp.json", marker=home / ".cursor"),
         Client("codex", "Codex", _codex_home() / "config.toml", cli="codex", marker=_codex_home()),
@@ -247,19 +260,21 @@ def _handshake(command: str, args: list[str], timeout: float = 90.0) -> tuple[bo
             async with ClientSession(read, write) as session:
                 await session.initialize()
                 tools = [t.name for t in (await session.list_tools()).tools]
-                briefing = (await session.call_tool("context", {})).content[0].text
-                return time.monotonic() - began, tools, briefing
+                await session.call_tool("context", {})  # answers at once, before the files are read
+                answered = time.monotonic() - began
+                summary = (await session.call_tool("overview", {})).content[0].text  # waits for the index
+                return answered, tools, summary
 
     try:
-        took, tools, briefing = asyncio.run(asyncio.wait_for(talk(), timeout))
+        took, tools, summary = asyncio.run(asyncio.wait_for(talk(), timeout))
     except Exception as err:  # noqa: BLE001  (shown to the person, who can act on it)
         log.seek(0)
         said = " | ".join(line.strip() for line in log.read().splitlines()[-3:] if line.strip())
         return False, f"the server did not answer: {type(err).__name__}: {err}" + (f" (it said: {said})" if said else "")
     finally:
         log.close()
-    last = [line for line in briefing.splitlines() if line.strip()][-1:]
-    return True, f"answered in {took:.1f} s with {len(tools)} tools; it says: {last[0] if last else '(empty)'}"
+    first = next((line for line in summary.splitlines() if line.strip()), "(empty)")
+    return True, f"answered in {took:.1f} s with {len(tools)} tools; your brain: {first}"
 
 
 def _registered(client: Client) -> tuple[str, list[str]] | None:

{brainplug-0.4.0 → brainplug-0.4.1}/brainplug.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: brainplug
-Version: 0.4.0
+Version: 0.4.1
 Summary: A second brain for you and your AI assistants: a 3D map of everything you write and a memory they plug into. 100% local.
 Author: Juan Rodríguez
 License-Expression: MIT
@@ -65,9 +65,7 @@ brainplug doctor ~/Documents/MyVault          # checks that it answers, end to e
 ```
 
 `brainplug brain ~/Documents/MyVault --draft-about` writes a first draft of your "About me"
-note from what you have written, while it is still empty. Until the first release reaches PyPI,
-install it from GitHub:
-`uv tool install "brainplug @ git+https://github.com/juanmariarodriguez2-png/brainplug"`.
+note from what you have written, while it is still empty.
 Add `--sessions` to `connect` to include what you typed to Claude Code and Codex, and put
 export files after the vault to include what you wrote before (`… MyVault chatgpt-export.zip`).
 

{brainplug-0.4.0 → brainplug-0.4.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "brainplug"
-version = "0.4.0"
+version = "0.4.1"
 description = "A second brain for you and your AI assistants: a 3D map of everything you write and a memory they plug into. 100% local."
 readme = "README.md"
 license = "MIT"

{brainplug-0.4.0 → brainplug-0.4.1}/tests/test_connect.py

@@ -16,6 +16,7 @@ def home(tmp_path, monkeypatch):
     h = tmp_path / "home"
     h.mkdir()
     for name, value in (("HOME", h), ("USERPROFILE", h), ("APPDATA", h / "AppData" / "Roaming"),
+                        ("LOCALAPPDATA", h / "AppData" / "Local"),  # never a real Windows app package
                         ("XDG_CONFIG_HOME", h / ".config"), ("BRAINPLUG_CACHE", tmp_path / "cache")):
         monkeypatch.setenv(name, str(value))
     monkeypatch.delenv("CODEX_HOME", raising=False)
@@ -105,6 +106,7 @@ def test_doctor_checks_everything_end_to_end(home, tmp_path, monkeypatch, capsys
     assert main(["doctor", str(vault)]) == 0
     out = capsys.readouterr().out
     assert "the server starts and answers" in out and "All good." in out and "✗" not in out
+    assert "your brain: 21 items" in out  # it waits for the files to be read, then says how much is there
     (home / ".cursor" / "mcp.json").write_text('{"mcpServers": {"brainplug": {"command": "/no/such/brainplug", "args": []}}}')
     assert main(["doctor", str(vault)]) == 1
     assert "brainplug connect" in capsys.readouterr().out
@@ -122,3 +124,17 @@ def test_a_hanging_assistant_cli_is_reported_not_fatal(monkeypatch):
         raise bc.subprocess.TimeoutExpired("claude", 60)
     monkeypatch.setattr(bc.subprocess, "run", hang)
     assert bc._run(["claude", "mcp", "add"]).returncode == 1
+
+
+def test_connect_finds_claude_desktop_installed_as_a_windows_package(home, tmp_path, monkeypatch, capsys):
+    # The packaged (MSIX) app reads a virtualized copy of %APPDATA%\\Claude under its package folder.
+    monkeypatch.setattr(bc.shutil, "which", fake_which({"brainplug": "/opt/tools/brainplug"}))
+    package = home / "AppData" / "Local" / "Packages" / "Claude_pzs8sxrjxfjjc"
+    package.mkdir(parents=True)
+    vault = tmp_path / "Vault"
+    vault.mkdir()
+    assert main(["connect", str(vault)]) == 0
+    config = package / "LocalCache" / "Roaming" / "Claude" / "claude_desktop_config.json"
+    assert json.loads(config.read_text())["mcpServers"]["brainplug"]["args"] == ["mcp", "--brain", str(vault.resolve())]
+    assert not bc._app_config("Claude").exists()  # the copy this app does not read is not created
+    assert "Claude Desktop" in capsys.readouterr().out

{brainplug-0.4.0 → brainplug-0.4.1}/tests/test_memory.py

@@ -315,3 +315,13 @@ def test_a_vault_inside_another_input_is_read_once(tmp_path):
     (tmp_path / "Docs" / "elsewhere.md").write_text("a loose note outside the vault about tide pools", encoding="utf-8")
     items = sources.load([vault, tmp_path / "Docs"])
     assert len(items) == 11 and len({i.text for i in items}) == 11
+
+
+def test_brain_does_not_create_a_mistyped_folder(tmp_path, capsys):
+    import pytest
+    for flag in ("--draft-about", "--context", "--review"):
+        with pytest.raises(SystemExit):
+            main(["brain", str(tmp_path / "C" / "ruta" / "de" / "su" / "bóveda"), flag])
+    assert not (tmp_path / "C").exists() and "does not exist" in capsys.readouterr().err
+    assert main(["brain", str(tmp_path / "New brain")]) == 0  # setting up a new brain may create it, and says so
+    assert "Creating a new folder for your brain" in capsys.readouterr().out