yourmemory 1.4.2__tar.gz → 1.4.4__tar.gz

{yourmemory-1.4.2 → yourmemory-1.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: yourmemory
-Version: 1.4.2
+Version: 1.4.4
 Summary: Persistent memory for Claude — Ebbinghaus forgetting curve, semantic deduplication, MCP-native
 Author-email: Sachit Misra <mishrasachit1@gmail.com>
 License-Expression: CC-BY-NC-4.0
@@ -24,12 +24,12 @@ Requires-Dist: duckdb>=0.10.0
 Requires-Dist: apscheduler
 Requires-Dist: spacy<4.0,>=3.8.13
 Requires-Dist: networkx>=3.0
+Requires-Dist: fastapi
+Requires-Dist: uvicorn[standard]
 Provides-Extra: postgres
 Requires-Dist: psycopg2-binary; extra == "postgres"
 Requires-Dist: pgvector; extra == "postgres"
 Provides-Extra: sse
-Requires-Dist: fastapi; extra == "sse"
-Requires-Dist: uvicorn[standard]; extra == "sse"
 Requires-Dist: httpx; extra == "sse"
 Provides-Extra: neo4j
 Requires-Dist: neo4j>=5.0; extra == "neo4j"

{yourmemory-1.4.2 → yourmemory-1.4.4}/memory_mcp.py

@@ -555,6 +555,32 @@ async def call_tool(name: str, arguments: dict) -> list[types.TextContent]:
         return [types.TextContent(type="text", text=json.dumps({"error": f"Unknown tool: {name}"}))]
 
 
+def _start_dashboard(port: int) -> None:
+    """Start the memory dashboard HTTP server in a background daemon thread.
+
+    Binds to 127.0.0.1 only — local access, not exposed to the network.
+    Prints the URL to stderr so it doesn't pollute the MCP stdio stream.
+    """
+    try:
+        import uvicorn
+        from src.app import app as dashboard_app
+
+        config = uvicorn.Config(
+            dashboard_app,
+            host="127.0.0.1",
+            port=port,
+            log_level="error",
+            access_log=False,
+        )
+        server = uvicorn.Server(config)
+
+        t = threading.Thread(target=server.run, daemon=True, name="dashboard")
+        t.start()
+        print(f"  Dashboard → http://127.0.0.1:{port}/ui", file=sys.stderr)
+    except Exception as exc:
+        print(f"  Dashboard unavailable: {exc}", file=sys.stderr)
+
+
 def _start_decay_scheduler():
     """Run the decay job once immediately, then every 24 hours in a background thread."""
     from src.jobs.decay_job import run as run_decay
@@ -828,29 +854,68 @@ def setup():
 
     # ── 4. Inject memory rules into global agent instructions ───────────────
     print("\n[4/4] Injecting memory rules into global agent instructions…")
-    _inject_memory_rules(home)
+
+    # Resolve user_id: env var → saved file → prompt
+    uid_path = os.path.join(home, ".yourmemory", "user_id")
+    user_id = os.getenv("YOURMEMORY_USER", "").strip()
+    if not user_id and os.path.exists(uid_path):
+        with open(uid_path) as f:
+            user_id = f.read().strip()
+    if not user_id:
+        try:
+            user_id = input("  Your name (used as memory user_id, e.g. 'alice'): ").strip()
+        except (EOFError, OSError):
+            user_id = ""
+    if not user_id:
+        user_id = "user"
+    os.makedirs(os.path.dirname(uid_path), exist_ok=True)
+    with open(uid_path, "w") as f:
+        f.write(user_id)
+    print(f"  user_id → {user_id}")
+
+    _inject_memory_rules(home, user_id)
 
     print("\n✓ Setup complete. Restart your AI client to load YourMemory.\n")
 
 
-def _inject_memory_rules(home: str) -> None:
-    """Append _MEMORY_RULES to every detected global agent instruction file.
-    Skips silently if the rules block is already present.
+def _inject_memory_rules(home: str, user_id: str = "user") -> None:
+    """Append memory rules to every detected global agent instruction file.
+    Replaces <your_name> with the actual user_id. Skips if already present.
     """
+    rules = _MEMORY_RULES.replace("<your_name>", user_id)
+
     candidates = [
-        # Claude Code global instructions
+        # Claude Code — all platforms
         os.path.join(home, ".claude", "CLAUDE.md"),
-        # Cursor global rules
+        # Cursor — all platforms
         os.path.join(home, ".cursor", "rules", "memory.mdc"),
-        # Windsurf global rules
+        # Windsurf — all platforms
         os.path.join(home, ".codeium", "windsurf", "memories", "memory_rules.md"),
+        # OpenCode — all platforms
+        os.path.join(home, ".config", "opencode", "instructions.md"),
     ]
 
+    # Cline (VS Code) — platform-specific globalStorage path
+    if sys.platform == "darwin":
+        vscode_global = os.path.join(home, "Library", "Application Support",
+                                     "Code", "User", "globalStorage")
+    elif sys.platform == "win32":
+        vscode_global = os.path.join(os.getenv("APPDATA", ""), "Code",
+                                     "User", "globalStorage")
+    else:
+        vscode_global = os.path.join(home, ".config", "Code", "User", "globalStorage")
+
+    if os.path.isdir(vscode_global):
+        for entry in os.listdir(vscode_global):
+            if "claude-dev" in entry or "cline" in entry.lower():
+                candidates.append(os.path.join(vscode_global, entry, "settings", "instructions.md"))
+                break
+
     wrote_any = False
     for path in candidates:
         dir_ = os.path.dirname(path)
         if not os.path.isdir(dir_):
-            continue  # client not installed — skip
+            continue
         try:
             existing = ""
             if os.path.exists(path):
@@ -860,22 +925,75 @@ def _inject_memory_rules(home: str) -> None:
                 print(f"  ✓  Already present → {path}")
                 wrote_any = True
                 continue
+            os.makedirs(dir_, exist_ok=True)
             with open(path, "a") as f:
                 if existing and not existing.endswith("\n"):
                     f.write("\n")
-                f.write("\n" + _MEMORY_RULES)
-            print(f"  ✓  Memory rules appended → {path}")
+                f.write("\n" + rules)
+            print(f"  ✓  Memory rules injected → {path}")
             wrote_any = True
         except Exception as exc:
             print(f"  ✗  Could not write to {path}: {exc}")
 
     if not wrote_any:
-        print("  (No global instruction files detected — add MEMORY_RULES.md to your project's CLAUDE.md manually.)")
+        print("  (No global instruction files detected — copy sample_CLAUDE.md to your project's CLAUDE.md manually.)")
+
+
+def _first_run_setup() -> None:
+    """Silently run first-time setup when the MCP server starts for the first time.
+
+    Triggered when ~/.yourmemory/user_id does not exist.
+    All output goes to stderr — stdout is reserved for the MCP stdio stream.
+    spaCy download runs in a background thread so it doesn't delay server startup.
+    """
+    home = os.path.expanduser("~")
+    uid_path = os.path.join(home, ".yourmemory", "user_id")
+
+    if os.path.exists(uid_path):
+        return  # already set up
+
+    print("  [YourMemory] First run detected — running setup…", file=sys.stderr)
+
+    # Resolve user_id: env var → system login → fallback
+    user_id = os.getenv("YOURMEMORY_USER", "").strip()
+    if not user_id:
+        try:
+            import getpass
+            user_id = getpass.getuser()
+        except Exception:
+            user_id = "user"
+
+    os.makedirs(os.path.join(home, ".yourmemory"), exist_ok=True)
+    with open(uid_path, "w") as f:
+        f.write(user_id)
+    print(f"  [YourMemory] user_id → {user_id}", file=sys.stderr)
+
+    # Inject memory rules into detected client instruction files
+    _inject_memory_rules(home, user_id)
+
+    # Fire install ping
+    _ping_install()
+
+    # Download spaCy model in background — don't block server startup
+    def _download_spacy():
+        try:
+            import subprocess
+            subprocess.run(
+                [sys.executable, "-m", "spacy", "download", "en_core_web_sm"],
+                check=False, capture_output=True,
+            )
+        except Exception:
+            pass
+
+    threading.Thread(target=_download_spacy, daemon=True, name="spacy-dl").start()
+
+    print("  [YourMemory] Setup complete. Memory rules injected into your AI client.", file=sys.stderr)
 
 
 def run():
     from src.db.migrate import migrate
     migrate()
+    _first_run_setup()
     _start_decay_scheduler()
 
     # SSE mode: --sse flag, PORT env var, or Windows default (stdio pipes unreliable on Windows)
@@ -892,6 +1010,8 @@ def run():
         # Default to SSE on Windows — stdio pipes break intermittently on Windows
         _run_sse(int(os.getenv("PORT", 3033)))
     else:
+        dashboard_port = int(os.getenv("YOURMEMORY_DASHBOARD_PORT", 3033))
+        _start_dashboard(dashboard_port)
         asyncio.run(main())
 
 

{yourmemory-1.4.2 → yourmemory-1.4.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "yourmemory"
-version = "1.4.2"
+version = "1.4.4"
 description = "Persistent memory for Claude — Ebbinghaus forgetting curve, semantic deduplication, MCP-native"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -30,11 +30,13 @@ dependencies = [
     "apscheduler",
     "spacy>=3.8.13,<4.0",
     "networkx>=3.0",
+    "fastapi",
+    "uvicorn[standard]",
 ]
 
 [project.optional-dependencies]
 postgres = ["psycopg2-binary", "pgvector"]
-sse = ["fastapi", "uvicorn[standard]", "httpx"]
+sse = ["httpx"]
 neo4j = ["neo4j>=5.0"]
 all = ["yourmemory[postgres,sse,neo4j]"]
 

{yourmemory-1.4.2 → yourmemory-1.4.4}/yourmemory.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: yourmemory
-Version: 1.4.2
+Version: 1.4.4
 Summary: Persistent memory for Claude — Ebbinghaus forgetting curve, semantic deduplication, MCP-native
 Author-email: Sachit Misra <mishrasachit1@gmail.com>
 License-Expression: CC-BY-NC-4.0
@@ -24,12 +24,12 @@ Requires-Dist: duckdb>=0.10.0
 Requires-Dist: apscheduler
 Requires-Dist: spacy<4.0,>=3.8.13
 Requires-Dist: networkx>=3.0
+Requires-Dist: fastapi
+Requires-Dist: uvicorn[standard]
 Provides-Extra: postgres
 Requires-Dist: psycopg2-binary; extra == "postgres"
 Requires-Dist: pgvector; extra == "postgres"
 Provides-Extra: sse
-Requires-Dist: fastapi; extra == "sse"
-Requires-Dist: uvicorn[standard]; extra == "sse"
 Requires-Dist: httpx; extra == "sse"
 Provides-Extra: neo4j
 Requires-Dist: neo4j>=5.0; extra == "neo4j"

{yourmemory-1.4.2 → yourmemory-1.4.4}/yourmemory.egg-info/requires.txt

@@ -7,6 +7,8 @@ duckdb>=0.10.0
 apscheduler
 spacy<4.0,>=3.8.13
 networkx>=3.0
+fastapi
+uvicorn[standard]
 
 [all]
 yourmemory[neo4j,postgres,sse]
@@ -19,6 +21,4 @@ psycopg2-binary
 pgvector
 
 [sse]
-fastapi
-uvicorn[standard]
 httpx