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

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

@@ -1,11 +1,12 @@
 Metadata-Version: 2.4
 Name: graph-mind-memory
-Version: 0.5.0
+Version: 0.5.2
 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
 Project-URL: Homepage, https://github.com/goyohan0611-png/graph-mind
 Project-URL: Issues, https://github.com/goyohan0611-png/graph-mind/issues
+Project-URL: Changelog, https://github.com/goyohan0611-png/graph-mind/blob/main/CHANGELOG.md
 Keywords: mcp,memory,claude,codex,llm,longmemeval,local-first
 Classifier: Development Status :: 3 - Alpha
 Classifier: Programming Language :: Python :: 3
@@ -120,6 +121,8 @@ Requires Python 3.10+ (64-bit). Windows, macOS or Linux. Hosting a brain that ot
 needs Python 3.12 or older on that one PC (its Postgres helper, pgserver, has no newer build yet);
 everything else, joining included, works on 3.13 and 3.14 too.
 
+What changed in each release: [CHANGELOG.md](CHANGELOG.md).
+
 ```bash
 pip install graph-mind-memory
 graph-mind-install
@@ -180,9 +183,12 @@ random 20-64 character tokens caught; in 246,750 ordinary chat turns it fired 92
 all on real ids and tokens). Commit ids, hashes and UUIDs are kept, since you recall those on
 purpose.
 
-There is no switch to keep keys: a recalled memory goes to your model's provider with the question,
-so a stored key would leave your PC the first time it is useful. To have Graph-MIND remember a key,
-tell it **where the key is**, not the key: *"my OpenAI key is in 1Password, under Dev"*.
+Keep masking on if you use a cloud model: a recalled memory goes to your model's provider with the
+question, so a stored key would leave your PC the first time it is useful. To have Graph-MIND
+remember a key, tell it **where the key is**, not the key: *"my OpenAI key is in 1Password, under
+Dev"*. If your model runs on your own machines and you want keys remembered as typed, add
+`"mask_secrets": false` to `~/.graph-mind/config.json` (applies from the next message; already
+masked text stays masked).
 
 Only what you actually send is captured: the service reads each app's transcript, which is written
 after you press Enter, so a paste you delete before sending never reaches it. A plain password

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

@@ -93,6 +93,8 @@ Requires Python 3.10+ (64-bit). Windows, macOS or Linux. Hosting a brain that ot
 needs Python 3.12 or older on that one PC (its Postgres helper, pgserver, has no newer build yet);
 everything else, joining included, works on 3.13 and 3.14 too.
 
+What changed in each release: [CHANGELOG.md](CHANGELOG.md).
+
 ```bash
 pip install graph-mind-memory
 graph-mind-install
@@ -153,9 +155,12 @@ random 20-64 character tokens caught; in 246,750 ordinary chat turns it fired 92
 all on real ids and tokens). Commit ids, hashes and UUIDs are kept, since you recall those on
 purpose.
 
-There is no switch to keep keys: a recalled memory goes to your model's provider with the question,
-so a stored key would leave your PC the first time it is useful. To have Graph-MIND remember a key,
-tell it **where the key is**, not the key: *"my OpenAI key is in 1Password, under Dev"*.
+Keep masking on if you use a cloud model: a recalled memory goes to your model's provider with the
+question, so a stored key would leave your PC the first time it is useful. To have Graph-MIND
+remember a key, tell it **where the key is**, not the key: *"my OpenAI key is in 1Password, under
+Dev"*. If your model runs on your own machines and you want keys remembered as typed, add
+`"mask_secrets": false` to `~/.graph-mind/config.json` (applies from the next message; already
+masked text stays masked).
 
 Only what you actually send is captured: the service reads each app's transcript, which is written
 after you press Enter, so a paste you delete before sending never reaches it. A plain password

{graph_mind_memory-0.5.0 → graph_mind_memory-0.5.2}/automatic_capture.py

@@ -234,10 +234,39 @@ class AutomaticCaptureService:
                   "conversation_sources": conversation, "semantic": semantic,
                   "semantic_llm": semantic_llm,
                   "associative": associative,
-                  "errors": errors}
+                  "errors": errors,
+                  "warnings": self._stall_warnings(conversation)}
         self._write_status(result)
         return result
 
+    STALL_ROWS = 2000
+
+    def _stall_warnings(self, conversation):
+        """A source whose transcripts keep growing while no conversation comes out of them: the
+        app most likely changed its transcript format, and capture would otherwise stop without
+        a word. Counted across passes in capture-health.json; reset by the next turn found."""
+        path = self.state_dir / "capture-health.json"
+        try:
+            health = json.loads(path.read_text(encoding="utf-8"))
+        except (OSError, ValueError):
+            health = {}
+        warnings = []
+        for name, outcome in conversation.items():
+            if not isinstance(outcome, dict) or "scanned_rows" not in outcome:
+                continue
+            entry = health.setdefault(name, {"rows_without_turns": 0, "last_turn_at": None})
+            if outcome.get("recorded_turns"):
+                entry.update(rows_without_turns=0, last_turn_at=self.now())
+            else:
+                entry["rows_without_turns"] += outcome["scanned_rows"]
+            if entry["rows_without_turns"] >= self.STALL_ROWS:
+                warnings.append(
+                    f"{name}: {entry['rows_without_turns']} new transcript lines and no "
+                    f"conversation found in them since {entry['last_turn_at'] or 'capture began'}"
+                    " - the app may have changed its format; update Graph-MIND or report it")
+        _atomic_json(path, health)
+        return warnings
+
     def _write_status(self, result):
         _atomic_json(self.status_path, {**result, "pid": os.getpid(),
                                        "config_db": str(self.db_path)})

{graph_mind_memory-0.5.0 → graph_mind_memory-0.5.2}/conversation_memory.py

@@ -79,8 +79,17 @@ AGENT_INSTRUCTIONS = re.compile(
     r"(?:#\s*AGENTS\.md instructions[^\n]*\s*)?<INSTRUCTIONS>.*?</INSTRUCTIONS>", flags=re.DOTALL)
 
 
+def masking_on():
+    """On unless ~/.graph-mind/config.json says "mask_secrets": false: someone running a model on
+    their own machines may want keys kept in memory verbatim."""
+    from brain_log import _config
+    return _config().get("mask_secrets", True) is not False
+
+
 def _redact(value):
     cleaned = AGENT_INSTRUCTIONS.sub("", AUTOMATIC_BLOCKS.sub("", value))
+    if not masking_on():
+        return cleaned.strip(), 0
     count = 0
     for pattern, replacement in SECRET_PATTERNS:
         cleaned, replacements = pattern.subn(replacement, cleaned)

{graph_mind_memory-0.5.0 → graph_mind_memory-0.5.2}/graph_mind_mcp_server.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 from datetime import datetime, timedelta
 from pathlib import Path
 from typing import Any, Literal
+import json
 import os
 import sys
 import threading
@@ -346,6 +347,17 @@ def gather(database, query, *, scopes=None, as_of, knowledge_cutoff=None, limit=
     return result
 
 
+def capture_warnings() -> list[str]:
+    """What the capture service last reported as wrong (a source that stopped yielding turns)."""
+    try:
+        from automatic_capture import default_service_state_dir
+        status = json.loads((default_service_state_dir() / "status.json")
+                            .read_text(encoding="utf-8"))
+        return list(status.get("warnings") or [])
+    except Exception:
+        return []
+
+
 def build_server(db_path=None):
     database = Path(db_path).expanduser() if db_path is not None else configured_db_path()
     server = MCPServer(
@@ -368,7 +380,8 @@ def build_server(db_path=None):
             "project, file or symbol, use code_activity. brain_folder shows or changes where the "
             "memory lives and shares it with the user's other PCs. When the user asks to "
             "delete something from memory, use brain_forget: list first, delete only what the "
-            "user picks. Preserve provenance."
+            "user picks. If a result carries capture_warnings, tell the user once, plainly: "
+            "conversations from that app are no longer being saved. Preserve provenance."
         ),
         version=SERVER_VERSION,
     )
@@ -557,6 +570,9 @@ def build_server(db_path=None):
         packet = build_context_pack(recalled, max_chars=max_chars,
                                     order="time" if recent else "relevance")
         packet["route"] = route
+        warnings = capture_warnings()
+        if warnings:
+            packet["capture_warnings"] = warnings
         if route["mode"] == "EXECUTE":
             packet.setdefault("warnings", []).append(
                 "STRUCTURED_EXECUTION_REQUIRED_FOR_COMPLETE_SCOPE_CLAIMS")
@@ -626,6 +642,9 @@ def build_server(db_path=None):
         result = {} if shared_out is None else {
             "connection_code": shared_out["connection_code"],
             "reachable_at": shared_out["addresses"], "firewall": shared_out["firewall"]}
+        warnings = capture_warnings()
+        if warnings:
+            result["capture_warnings"] = warnings
         return {**result, "folder": where, "this_device": device_name(),
                 "devices": devices(shared),
                 "imported_from_other_devices": imported["imported"],

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

@@ -1,11 +1,12 @@
 Metadata-Version: 2.4
 Name: graph-mind-memory
-Version: 0.5.0
+Version: 0.5.2
 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
 Project-URL: Homepage, https://github.com/goyohan0611-png/graph-mind
 Project-URL: Issues, https://github.com/goyohan0611-png/graph-mind/issues
+Project-URL: Changelog, https://github.com/goyohan0611-png/graph-mind/blob/main/CHANGELOG.md
 Keywords: mcp,memory,claude,codex,llm,longmemeval,local-first
 Classifier: Development Status :: 3 - Alpha
 Classifier: Programming Language :: Python :: 3
@@ -120,6 +121,8 @@ Requires Python 3.10+ (64-bit). Windows, macOS or Linux. Hosting a brain that ot
 needs Python 3.12 or older on that one PC (its Postgres helper, pgserver, has no newer build yet);
 everything else, joining included, works on 3.13 and 3.14 too.
 
+What changed in each release: [CHANGELOG.md](CHANGELOG.md).
+
 ```bash
 pip install graph-mind-memory
 graph-mind-install
@@ -180,9 +183,12 @@ random 20-64 character tokens caught; in 246,750 ordinary chat turns it fired 92
 all on real ids and tokens). Commit ids, hashes and UUIDs are kept, since you recall those on
 purpose.
 
-There is no switch to keep keys: a recalled memory goes to your model's provider with the question,
-so a stored key would leave your PC the first time it is useful. To have Graph-MIND remember a key,
-tell it **where the key is**, not the key: *"my OpenAI key is in 1Password, under Dev"*.
+Keep masking on if you use a cloud model: a recalled memory goes to your model's provider with the
+question, so a stored key would leave your PC the first time it is useful. To have Graph-MIND
+remember a key, tell it **where the key is**, not the key: *"my OpenAI key is in 1Password, under
+Dev"*. If your model runs on your own machines and you want keys remembered as typed, add
+`"mask_secrets": false` to `~/.graph-mind/config.json` (applies from the next message; already
+masked text stays masked).
 
 Only what you actually send is captured: the service reads each app's transcript, which is written
 after you press Enter, so a paste you delete before sending never reaches it. A plain password

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "graph-mind-memory"
-version = "0.5.0"
+version = "0.5.2"
 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"
@@ -35,6 +35,7 @@ dependencies = [
 [project.urls]
 Homepage = "https://github.com/goyohan0611-png/graph-mind"
 Issues = "https://github.com/goyohan0611-png/graph-mind/issues"
+Changelog = "https://github.com/goyohan0611-png/graph-mind/blob/main/CHANGELOG.md"
 
 [project.scripts]
 graph-mind = "graph_mind_mcp_server:main"