graph-mind-memory 0.5.2__tar.gz → 0.5.4__tar.gz

{graph_mind_memory-0.5.2 → graph_mind_memory-0.5.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: graph-mind-memory
-Version: 0.5.2
+Version: 0.5.4
 Summary: Local-first memory for AI coding assistants: verbatim, on your own PC, no LLM calls at write time.
 Author-email: Yohan Ko <goyohan0611@gmail.com>
 License-Expression: AGPL-3.0-only
@@ -78,8 +78,8 @@ calls Graph-MIND over MCP and gets back a few thousand tokens of the conversatio
 ## Benchmarks
 
 All numbers below come from files in this repository: the pre-registrations, each question's
-answer, and the judge's verdict on it, under [`runs/`](runs). The method is in
-[REPORT.md](REPORT.md), including the failures and the corrections.
+answer, and the judge's verdict on it, under [`research/runs/`](research/runs). The method is in
+[REPORT.md](research/REPORT.md), including the failures and the corrections.
 
 **LongMemEval_S: answer accuracy, 500 questions.** The answer model is gpt-5-mini; the judge is the
 official gpt-4o-2024-08-06.
@@ -139,7 +139,7 @@ or from source:
 ```bash
 git clone https://github.com/goyohan0611-png/graph-mind.git
 cd graph-mind
-python install.py
+python src/install.py
 ```
 
 The installer:
@@ -233,7 +233,7 @@ On the PC that holds the memory, tell its AI:
 It replies with a connection code (`gm1.…`). On each other PC:
 
 ```bash
-graph-mind-install --join gm1.…     # or: python install.py --join gm1.…
+graph-mind-install --join gm1.…     # or: python src/install.py --join gm1.…
 ```
 
 The memory then lives in a Postgres server on the first PC, which Graph-MIND sets up itself. Other
@@ -254,16 +254,17 @@ each PC.
 ## Reproducing the benchmarks
 
 1. Download `longmemeval_s_cleaned.json` from [LongMemEval](https://github.com/xiaowu0162/LongMemEval)
-   into `external/longmemeval/`.
+   into `research/external/longmemeval/`.
 2. Set `OPENAI_API_KEY` for the answer model and the judge.
-3. Run the commands in [REPORT.md §10](REPORT.md#10-reproducing).
+3. `pip install -e .`, then from `research/` run the commands in
+   [REPORT.md §10](research/REPORT.md#10-reproducing).
 
 A full 500-question run costs about US$3.
 
 ## Tests
 
 ```bash
-python -m unittest discover -p "test_*.py"
+python -m unittest discover -s tests -p "test_*.py"
 ```
 
 ---
@@ -271,7 +272,7 @@ python -m unittest discover -p "test_*.py"
 ## Known limits
 
 - **For the first few seconds after an AI app starts, answers use word search only** while the
-  embedding model loads in the background (6-9 s on a slow, synced disk; it was 50-70 s before
+  embedding model loads in the background (6-30 s on a slow, synced disk, depending on load; it was 50-70 s before
   0.4). The first answer never waits for it; later answers take well under a second.
 - **Daily use on Windows only so far.** macOS and Linux pass the tests in CI but have not seen real
   use.
@@ -279,20 +280,17 @@ python -m unittest discover -p "test_*.py"
   can stop capture until Graph-MIND is updated.
 - **Multi-session questions are the weakest type at 80%.** These are questions that count or
   combine facts across many conversations.
-- **The repository still holds the research-phase experiments** next to the product (see
-  [Repository layout](#repository-layout)); the installed package carries only the 22 product
-  modules.
 
-The full list is in [REPORT.md §9](REPORT.md#9-known-limits).
+The full list is in [REPORT.md §9](research/REPORT.md#9-known-limits).
 
 ## Repository layout
 
-| | files |
+| folder | what is in it |
 |---|---|
-| **Product** (what `pip install graph-mind-memory` installs) | `graph_mind_mcp_server.py` (MCP server), `automatic_capture*.py` (capture service), `install.py`, `brain_log.py` (sharing across PCs), `forget.py` (deleting), `local_brain.py` / `conversation_memory.py` / `coding_memory.py` / `development_memory.py` (stores), `semantic_recall.py` / `local_embedder.py` / `vector_cache.py` / `embedding_warmup.py` (search), and their helpers |
-| **Benchmarks** | `product_answer_eval.py`, `official_judge_v073.py`, `rival_mem0.py`, `rival_mempalace.py`, `rival_clean_prereg.py`, and the result files under `runs/` |
-| **Research phase** | the other modules: earlier extraction pipelines and analyses that REPORT.md cites |
-| **Tests** | `test_*.py` |
+| [`src/`](src) | the product, exactly what `pip install graph-mind-memory` installs: `graph_mind_mcp_server.py` (MCP server), `automatic_capture*.py` (capture service), `install.py`, `brain_log.py` (sharing across PCs), `forget.py` (deleting), the stores, and search (`semantic_recall.py`, `local_embedder.py`) |
+| [`tests/`](tests) | unit tests, run in CI on Windows, Linux and macOS |
+| [`research/`](research) | the benchmark and research-phase scripts, [REPORT.md](research/REPORT.md), and every run's results under `runs/` |
+| [`demo/`](demo) | the README's GIF and the script that records it |
 
 ## Security
 

{graph_mind_memory-0.5.2 → graph_mind_memory-0.5.4}/README.md

@@ -50,8 +50,8 @@ calls Graph-MIND over MCP and gets back a few thousand tokens of the conversatio
 ## Benchmarks
 
 All numbers below come from files in this repository: the pre-registrations, each question's
-answer, and the judge's verdict on it, under [`runs/`](runs). The method is in
-[REPORT.md](REPORT.md), including the failures and the corrections.
+answer, and the judge's verdict on it, under [`research/runs/`](research/runs). The method is in
+[REPORT.md](research/REPORT.md), including the failures and the corrections.
 
 **LongMemEval_S: answer accuracy, 500 questions.** The answer model is gpt-5-mini; the judge is the
 official gpt-4o-2024-08-06.
@@ -111,7 +111,7 @@ or from source:
 ```bash
 git clone https://github.com/goyohan0611-png/graph-mind.git
 cd graph-mind
-python install.py
+python src/install.py
 ```
 
 The installer:
@@ -205,7 +205,7 @@ On the PC that holds the memory, tell its AI:
 It replies with a connection code (`gm1.…`). On each other PC:
 
 ```bash
-graph-mind-install --join gm1.…     # or: python install.py --join gm1.…
+graph-mind-install --join gm1.…     # or: python src/install.py --join gm1.…
 ```
 
 The memory then lives in a Postgres server on the first PC, which Graph-MIND sets up itself. Other
@@ -226,16 +226,17 @@ each PC.
 ## Reproducing the benchmarks
 
 1. Download `longmemeval_s_cleaned.json` from [LongMemEval](https://github.com/xiaowu0162/LongMemEval)
-   into `external/longmemeval/`.
+   into `research/external/longmemeval/`.
 2. Set `OPENAI_API_KEY` for the answer model and the judge.
-3. Run the commands in [REPORT.md §10](REPORT.md#10-reproducing).
+3. `pip install -e .`, then from `research/` run the commands in
+   [REPORT.md §10](research/REPORT.md#10-reproducing).
 
 A full 500-question run costs about US$3.
 
 ## Tests
 
 ```bash
-python -m unittest discover -p "test_*.py"
+python -m unittest discover -s tests -p "test_*.py"
 ```
 
 ---
@@ -243,7 +244,7 @@ python -m unittest discover -p "test_*.py"
 ## Known limits
 
 - **For the first few seconds after an AI app starts, answers use word search only** while the
-  embedding model loads in the background (6-9 s on a slow, synced disk; it was 50-70 s before
+  embedding model loads in the background (6-30 s on a slow, synced disk, depending on load; it was 50-70 s before
   0.4). The first answer never waits for it; later answers take well under a second.
 - **Daily use on Windows only so far.** macOS and Linux pass the tests in CI but have not seen real
   use.
@@ -251,20 +252,17 @@ python -m unittest discover -p "test_*.py"
   can stop capture until Graph-MIND is updated.
 - **Multi-session questions are the weakest type at 80%.** These are questions that count or
   combine facts across many conversations.
-- **The repository still holds the research-phase experiments** next to the product (see
-  [Repository layout](#repository-layout)); the installed package carries only the 22 product
-  modules.
 
-The full list is in [REPORT.md §9](REPORT.md#9-known-limits).
+The full list is in [REPORT.md §9](research/REPORT.md#9-known-limits).
 
 ## Repository layout
 
-| | files |
+| folder | what is in it |
 |---|---|
-| **Product** (what `pip install graph-mind-memory` installs) | `graph_mind_mcp_server.py` (MCP server), `automatic_capture*.py` (capture service), `install.py`, `brain_log.py` (sharing across PCs), `forget.py` (deleting), `local_brain.py` / `conversation_memory.py` / `coding_memory.py` / `development_memory.py` (stores), `semantic_recall.py` / `local_embedder.py` / `vector_cache.py` / `embedding_warmup.py` (search), and their helpers |
-| **Benchmarks** | `product_answer_eval.py`, `official_judge_v073.py`, `rival_mem0.py`, `rival_mempalace.py`, `rival_clean_prereg.py`, and the result files under `runs/` |
-| **Research phase** | the other modules: earlier extraction pipelines and analyses that REPORT.md cites |
-| **Tests** | `test_*.py` |
+| [`src/`](src) | the product, exactly what `pip install graph-mind-memory` installs: `graph_mind_mcp_server.py` (MCP server), `automatic_capture*.py` (capture service), `install.py`, `brain_log.py` (sharing across PCs), `forget.py` (deleting), the stores, and search (`semantic_recall.py`, `local_embedder.py`) |
+| [`tests/`](tests) | unit tests, run in CI on Windows, Linux and macOS |
+| [`research/`](research) | the benchmark and research-phase scripts, [REPORT.md](research/REPORT.md), and every run's results under `runs/` |
+| [`demo/`](demo) | the README's GIF and the script that records it |
 
 ## Security
 

{graph_mind_memory-0.5.2 → graph_mind_memory-0.5.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "graph-mind-memory"
-version = "0.5.2"
+version = "0.5.4"
 description = "Local-first memory for AI coding assistants: verbatim, on your own PC, no LLM calls at write time."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -45,7 +45,8 @@ graph-mind-capture = "automatic_capture_cli:main"
 graph-mind-forget = "forget:main"
 
 [tool.setuptools]
-# ponytail: flat modules, as in the repository; a graph_mind/ package is the upgrade path.
+# ponytail: flat modules under src/; a graph_mind/ package is the upgrade path.
+package-dir = { "" = "src" }
 py-modules = [
     "associative_memory",
     "automatic_capture",

{graph_mind_memory-0.5.2 → graph_mind_memory-0.5.4/src}/brain_log.py

@@ -461,6 +461,27 @@ def _pg(url):
     return connection
 
 
+_READERS: dict = {}
+
+
+def _read_rows(url, query, parameters):
+    """A read on one connection kept open per hub: the sync before every answer paid a fresh
+    connection (password handshake included) each time, 0.2 s of a 0.9 s answer. A connection
+    the hub dropped (it restarted) is replaced once."""
+    import psycopg
+    for attempt in (1, 2):
+        connection = _READERS.get(url)
+        if connection is None or connection.closed:
+            connection = _READERS[url] = _pg(url)
+            connection.autocommit = True
+        try:
+            return connection.execute(query, parameters).fetchall()
+        except psycopg.OperationalError:
+            _READERS.pop(url, None)
+            if attempt == 2:
+                raise
+
+
 def _outbox() -> Path:
     from development_paths import graph_mind_home
     return graph_mind_home() / "outbox.jsonl"
@@ -514,9 +535,8 @@ def _new_lines(db: sqlite3.Connection, shared) -> list[str]:
         source = "postgres"
         row = db.execute("SELECT offset FROM brain_log_cursor WHERE source=?",
                          (source,)).fetchone()
-        with _pg(shared) as connection:
-            rows = connection.execute("SELECT seq, line FROM brain_log WHERE seq > %s ORDER BY seq",
-                                      (row[0] if row else 0,)).fetchall()
+        rows = _read_rows(shared, "SELECT seq, line FROM brain_log WHERE seq > %s ORDER BY seq",
+                          (row[0] if row else 0,))
         if rows:
             with db:
                 db.execute("INSERT OR REPLACE INTO brain_log_cursor VALUES(?,?)",

{graph_mind_memory-0.5.2 → graph_mind_memory-0.5.4/src}/graph_mind_mcp_server.py

@@ -26,12 +26,13 @@ if hasattr(sys.stderr, "reconfigure"):
 
 
 def _version() -> str:
-    """The package version: pyproject.toml beside this file in a source checkout, else the
+    """The package version: the checkout's pyproject.toml (one folder up from src/), else the
     installed distribution's. A hand-kept constant here had drifted to 0.5.0 at release 0.3.1."""
     import re
-    project = Path(__file__).with_name("pyproject.toml")
-    if project.exists():
-        found = re.search(r'^version = "([^"]+)"', project.read_text(encoding="utf-8"), re.M)
+    project = Path(__file__).resolve().parent.parent / "pyproject.toml"
+    text = project.read_text(encoding="utf-8") if project.exists() else ""
+    if 'name = "graph-mind-memory"' in text:
+        found = re.search(r'^version = "([^"]+)"', text, re.M)
         if found:
             return found.group(1)
     try:
@@ -358,6 +359,21 @@ def capture_warnings() -> list[str]:
         return []
 
 
+PROACTIVE_NOTE = (
+    "Remember proactively. Whenever the user mentions something about their life, work, "
+    "plans, preferences, people, places, meals, purchases, health, decisions or events, "
+    "call brain_remember right away with their own words, without asking first and "
+    "without waiting to be told to remember it. Saving too much costs nothing; forgetting "
+    "is what the user notices. Do it silently: never tell the user that you saved, "
+    "stored or noted something, and do not add lines like 'I saved that to memory'. "
+    "Mention memory only when the user asks what you remember or whether it was saved. ")
+# set by the installer for apps whose transcripts the capture service already saves
+CAPTURED_NOTE = (
+    "Every turn of this conversation is saved automatically. Do not call brain_remember for "
+    "ordinary chat; call it only when the user explicitly asks you to remember something or "
+    "to record a decision. ")
+
+
 def build_server(db_path=None):
     database = Path(db_path).expanduser() if db_path is not None else configured_db_path()
     server = MCPServer(
@@ -365,13 +381,7 @@ def build_server(db_path=None):
         title="Graph-MIND Universal Personal Memory",
         description="User-owned local brain shared across models, sessions and applications.",
         instructions=(
-            "Remember proactively. Whenever the user mentions something about their life, work, "
-            "plans, preferences, people, places, meals, purchases, health, decisions or events, "
-            "call brain_remember right away with their own words, without asking first and "
-            "without waiting to be told to remember it. Saving too much costs nothing; forgetting "
-            "is what the user notices. Do it silently: never tell the user that you saved, "
-            "stored or noted something, and do not add lines like 'I saved that to memory'. "
-            "Mention memory only when the user asks what you remember or whether it was saved. "
+            (CAPTURED_NOTE if os.environ.get("GRAPH_MIND_CAPTURED") else PROACTIVE_NOTE) +
             "Call brain_context first when a request may depend on the user's prior conversations, "
             "facts, preferences, decisions, projects or work, including 'where did we leave off?'. "
             "It skips unrelated requests and returns a bounded evidence packet instead of "
@@ -563,12 +573,15 @@ def build_server(db_path=None):
             return {"status": "SKIPPED", "route": route,
                     "scope_completeness": "NOT_APPLICABLE", "char_budget": max_chars,
                     "used_chars": 0, "estimated_tokens": 0, "selected_items": 0,
-                    "omitted_items": 0, "items": [], "context": ""}
+                    "omitted_items": 0, "ids": [], "context": ""}
         recalled = gather(database, query, scopes=scopes, as_of=as_of or _now(),
                           knowledge_cutoff=knowledge_cutoff, limit=limit, recent=recent,
                           since=since, about_assistant=about_assistant, around=around)
         packet = build_context_pack(recalled, max_chars=max_chars,
                                     order="time" if recent else "relevance")
+        # `context` already carries each item's kind, date, title, text and source; the item
+        # list repeated all of it and was 2/3 of what the model had to read (43K -> 16K chars)
+        packet["ids"] = [item["id"] for item in packet.pop("items")]
         packet["route"] = route
         warnings = capture_warnings()
         if warnings:

{graph_mind_memory-0.5.2 → graph_mind_memory-0.5.4/src}/graph_mind_memory.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: graph-mind-memory
-Version: 0.5.2
+Version: 0.5.4
 Summary: Local-first memory for AI coding assistants: verbatim, on your own PC, no LLM calls at write time.
 Author-email: Yohan Ko <goyohan0611@gmail.com>
 License-Expression: AGPL-3.0-only
@@ -78,8 +78,8 @@ calls Graph-MIND over MCP and gets back a few thousand tokens of the conversatio
 ## Benchmarks
 
 All numbers below come from files in this repository: the pre-registrations, each question's
-answer, and the judge's verdict on it, under [`runs/`](runs). The method is in
-[REPORT.md](REPORT.md), including the failures and the corrections.
+answer, and the judge's verdict on it, under [`research/runs/`](research/runs). The method is in
+[REPORT.md](research/REPORT.md), including the failures and the corrections.
 
 **LongMemEval_S: answer accuracy, 500 questions.** The answer model is gpt-5-mini; the judge is the
 official gpt-4o-2024-08-06.
@@ -139,7 +139,7 @@ or from source:
 ```bash
 git clone https://github.com/goyohan0611-png/graph-mind.git
 cd graph-mind
-python install.py
+python src/install.py
 ```
 
 The installer:
@@ -233,7 +233,7 @@ On the PC that holds the memory, tell its AI:
 It replies with a connection code (`gm1.…`). On each other PC:
 
 ```bash
-graph-mind-install --join gm1.…     # or: python install.py --join gm1.…
+graph-mind-install --join gm1.…     # or: python src/install.py --join gm1.…
 ```
 
 The memory then lives in a Postgres server on the first PC, which Graph-MIND sets up itself. Other
@@ -254,16 +254,17 @@ each PC.
 ## Reproducing the benchmarks
 
 1. Download `longmemeval_s_cleaned.json` from [LongMemEval](https://github.com/xiaowu0162/LongMemEval)
-   into `external/longmemeval/`.
+   into `research/external/longmemeval/`.
 2. Set `OPENAI_API_KEY` for the answer model and the judge.
-3. Run the commands in [REPORT.md §10](REPORT.md#10-reproducing).
+3. `pip install -e .`, then from `research/` run the commands in
+   [REPORT.md §10](research/REPORT.md#10-reproducing).
 
 A full 500-question run costs about US$3.
 
 ## Tests
 
 ```bash
-python -m unittest discover -p "test_*.py"
+python -m unittest discover -s tests -p "test_*.py"
 ```
 
 ---
@@ -271,7 +272,7 @@ python -m unittest discover -p "test_*.py"
 ## Known limits
 
 - **For the first few seconds after an AI app starts, answers use word search only** while the
-  embedding model loads in the background (6-9 s on a slow, synced disk; it was 50-70 s before
+  embedding model loads in the background (6-30 s on a slow, synced disk, depending on load; it was 50-70 s before
   0.4). The first answer never waits for it; later answers take well under a second.
 - **Daily use on Windows only so far.** macOS and Linux pass the tests in CI but have not seen real
   use.
@@ -279,20 +280,17 @@ python -m unittest discover -p "test_*.py"
   can stop capture until Graph-MIND is updated.
 - **Multi-session questions are the weakest type at 80%.** These are questions that count or
   combine facts across many conversations.
-- **The repository still holds the research-phase experiments** next to the product (see
-  [Repository layout](#repository-layout)); the installed package carries only the 22 product
-  modules.
 
-The full list is in [REPORT.md §9](REPORT.md#9-known-limits).
+The full list is in [REPORT.md §9](research/REPORT.md#9-known-limits).
 
 ## Repository layout
 
-| | files |
+| folder | what is in it |
 |---|---|
-| **Product** (what `pip install graph-mind-memory` installs) | `graph_mind_mcp_server.py` (MCP server), `automatic_capture*.py` (capture service), `install.py`, `brain_log.py` (sharing across PCs), `forget.py` (deleting), `local_brain.py` / `conversation_memory.py` / `coding_memory.py` / `development_memory.py` (stores), `semantic_recall.py` / `local_embedder.py` / `vector_cache.py` / `embedding_warmup.py` (search), and their helpers |
-| **Benchmarks** | `product_answer_eval.py`, `official_judge_v073.py`, `rival_mem0.py`, `rival_mempalace.py`, `rival_clean_prereg.py`, and the result files under `runs/` |
-| **Research phase** | the other modules: earlier extraction pipelines and analyses that REPORT.md cites |
-| **Tests** | `test_*.py` |
+| [`src/`](src) | the product, exactly what `pip install graph-mind-memory` installs: `graph_mind_mcp_server.py` (MCP server), `automatic_capture*.py` (capture service), `install.py`, `brain_log.py` (sharing across PCs), `forget.py` (deleting), the stores, and search (`semantic_recall.py`, `local_embedder.py`) |
+| [`tests/`](tests) | unit tests, run in CI on Windows, Linux and macOS |
+| [`research/`](research) | the benchmark and research-phase scripts, [REPORT.md](research/REPORT.md), and every run's results under `runs/` |
+| [`demo/`](demo) | the README's GIF and the script that records it |
 
 ## Security
 

graph_mind_memory-0.5.4/src/graph_mind_memory.egg-info/SOURCES.txt

@@ -0,0 +1,63 @@
+LICENSE
+README.md
+pyproject.toml
+src/associative_memory.py
+src/automatic_capture.py
+src/automatic_capture_cli.py
+src/brain_log.py
+src/clock.py
+src/coding_memory.py
+src/conversation_memory.py
+src/development_memory.py
+src/development_paths.py
+src/embedding_warmup.py
+src/entity_timeline.py
+src/forget.py
+src/graph_mind_mcp_server.py
+src/install.py
+src/local_brain.py
+src/local_embedder.py
+src/semantic_llm_extractor.py
+src/semantic_memory.py
+src/semantic_recall.py
+src/temporal_resolver.py
+src/universal_personal_memory.py
+src/vector_cache.py
+src/graph_mind_memory.egg-info/PKG-INFO
+src/graph_mind_memory.egg-info/SOURCES.txt
+src/graph_mind_memory.egg-info/dependency_links.txt
+src/graph_mind_memory.egg-info/entry_points.txt
+src/graph_mind_memory.egg-info/requires.txt
+src/graph_mind_memory.egg-info/top_level.txt
+tests/test_associative_memory.py
+tests/test_automatic_capture.py
+tests/test_capture_health.py
+tests/test_coding_memory.py
+tests/test_cold_start.py
+tests/test_concurrent_use.py
+tests/test_conversation_memory.py
+tests/test_executable_memory.py
+tests/test_executable_plan_v2_diagnostic.py
+tests/test_forget.py
+tests/test_forget_conversation.py
+tests/test_graph_mind_mcp_server.py
+tests/test_ingestion_gate.py
+tests/test_ingestion_synonyms.py
+tests/test_install.py
+tests/test_llm_concept_planner.py
+tests/test_local_brain.py
+tests/test_longmemeval_adapter.py
+tests/test_longmemeval_ingestion_calibration.py
+tests/test_longmemeval_ingestion_preflight.py
+tests/test_longmemeval_ingestion_v7.py
+tests/test_memory_algebra.py
+tests/test_precondition_verifier.py
+tests/test_recent_recall.py
+tests/test_resume_retries.py
+tests/test_secret_masking.py
+tests/test_semantic_llm_extractor.py
+tests/test_semantic_memory.py
+tests/test_semantic_recall.py
+tests/test_shared_brain.py
+tests/test_temporal_state.py
+tests/test_universal_personal_memory.py

{graph_mind_memory-0.5.2 → graph_mind_memory-0.5.4/src}/install.py

@@ -23,6 +23,9 @@ HERE = Path(__file__).resolve().parent
 SERVER = HERE / "graph_mind_mcp_server.py"
 NAME = "graph-mind-memory"
 ENV = {"PYTHONUTF8": "1", "PYTHONIOENCODING": "utf-8"}
+# apps whose transcripts the capture service reads: every turn is saved without the model,
+# so the model need not spend a tool call on brain_remember for ordinary chat
+CAPTURED = {**ENV, "GRAPH_MIND_CAPTURED": "1"}
 
 
 def step(message):
@@ -31,7 +34,7 @@ def step(message):
 
 def packages():
     done = subprocess.run([sys.executable, "-m", "pip", "install", "--disable-pip-version-check",
-                           "-q", "-r", str(HERE / "requirements.txt")])
+                           "-q", "-r", str(HERE.parent / "requirements.txt")])
     if done.returncode:
         # PyTorch ships files nested deep enough to pass Windows' 260-character path limit when
         # Python lives under a long folder: pip then fails halfway with "No such file".
@@ -42,10 +45,10 @@ def packages():
                  "  or install Python or this folder under a shorter path, e.g. C:\\graph-mind")
 
 
-def _json_entry(path: Path, key: str = "mcpServers", **extra) -> None:
+def _json_entry(path: Path, key: str = "mcpServers", env=ENV, **extra) -> None:
     settings = json.loads(path.read_text(encoding="utf-8")) if path.exists() else {}
     servers = settings.setdefault(key, {})
-    environment = {**servers.get(NAME, {}).get("env", {}), **ENV}   # keep the user's own settings
+    environment = {**servers.get(NAME, {}).get("env", {}), **env}   # keep the user's own settings
     servers[NAME] = {**extra, "command": sys.executable, "args": [str(SERVER)], "env": environment}
     temporary = path.with_suffix(".graph-mind.tmp")
     temporary.write_text(json.dumps(settings, ensure_ascii=False, indent=2), encoding="utf-8")
@@ -55,14 +58,17 @@ def _json_entry(path: Path, key: str = "mcpServers", **extra) -> None:
 def claude_code(home: Path) -> str:
     claude = shutil.which("claude")      # full path: an npm install is claude.CMD, which
     if claude:                           # Windows will not launch by its bare name
-        subprocess.run([claude, "mcp", "remove", "-s", "user", NAME], capture_output=True)
-        environment = [flag for key, value in ENV.items() for flag in ("-e", f"{key}={value}")]
-        # the name before -e: the CLI's -e takes every value that follows, the name included
-        subprocess.run([claude, "mcp", "add", "-s", "user", NAME, *environment, "--",
-                        sys.executable, str(SERVER)], check=True, capture_output=True)
-        return "Claude Code"
+        environment = [flag for key, value in CAPTURED.items() for flag in ("-e", f"{key}={value}")]
+        try:
+            subprocess.run([claude, "mcp", "remove", "-s", "user", NAME], capture_output=True)
+            # the name before -e: the CLI's -e takes every value that follows, the name included
+            subprocess.run([claude, "mcp", "add", "-s", "user", NAME, *environment, "--",
+                            sys.executable, str(SERVER)], check=True, capture_output=True)
+            return "Claude Code"
+        except (OSError, subprocess.CalledProcessError):
+            pass      # Windows refused to launch it (access denied, seen live): write the file
     if (home / ".claude.json").exists():
-        _json_entry(home / ".claude.json", type="stdio")
+        _json_entry(home / ".claude.json", env=CAPTURED, type="stdio")
         return "Claude Code"
     return ""
 
@@ -158,9 +164,9 @@ def codex(home: Path) -> str:
     text = config.read_text(encoding="utf-8") if config.exists() else ""
     header = f"[mcp_servers.{NAME}]"
     text = _without_codex_block(text)
-    environment = "\n".join(f"{key} = '{value}'" for key, value in ENV.items())
-    # required: otherwise Codex leaves out a server still starting when the first question comes
-    text += (f"\n{header}\nrequired = true\nstartup_timeout_sec = 60\n"
+    environment = "\n".join(f"{key} = '{value}'" for key, value in CAPTURED.items())
+    # not required: a memory server that fails to start must never keep a chat from starting
+    text += (f"\n{header}\nstartup_timeout_sec = 60\n"
              f"command = '{sys.executable}'\nargs = ['{SERVER}']\n\n"
              f"[mcp_servers.{NAME}.env]\n{environment}\n")
     config.write_text(text, encoding="utf-8")
@@ -171,7 +177,7 @@ def capture_service(start: bool) -> str:
     sys.path.insert(0, str(HERE))
     from automatic_capture import _atomic_json, default_config_path, default_service_state_dir, make_config
     if not default_config_path().exists():
-        config = make_config(workspace=str(HERE), project_id="project:graph-mind",
+        config = make_config(workspace=str(HERE.parent), project_id="project:graph-mind",
                              session_id="service:automatic-capture-v0.2",
                              sessions_root=str(Path.home() / ".codex" / "sessions"))
         # Conversations only. Watching a code folder is opt-in: this folder is Graph-MIND itself,
@@ -263,7 +269,7 @@ def main(argv=None):
         sys.path.insert(0, str(HERE))
         from brain_log import _decode
         _decode(args.join)
-    if not args.skip_packages and (HERE / "requirements.txt").exists():   # pip: already done
+    if not args.skip_packages and (HERE.parent / "requirements.txt").exists():   # pip: already done
         step("installing packages (the first time takes a few minutes)")
         packages()
     home = Path.home()

{graph_mind_memory-0.5.2 → graph_mind_memory-0.5.4/src}/local_brain.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 from development_paths import use_wal
 
 from pathlib import Path
+import functools
 import hashlib
 import json
 import re
@@ -39,6 +40,7 @@ def _string_list(value, error):
     return list(dict.fromkeys(item.strip() for item in value))
 
 
+@functools.lru_cache(maxsize=65536)     # every memory's title and tags, on every question
 def _normalized(value):
     text = unicodedata.normalize("NFKC", value).casefold()
     return " ".join(re.findall(r"[^\W_]+", text, flags=re.UNICODE))