perf(mcp): keep local read flows local

tests/test_mcp_memory_ergonomics_helpers.py

@@ -591,6 +591,39 @@ def test_context_and_related_use_identity_inputs(mod):
         mod.find_related_nodes({"path": "/notes/root"})
 
 
+def test_hybrid_context_resolves_path_inside_complete_local_snapshot(mod):
+    with tempfile.TemporaryDirectory() as tmp:
+        state_dir = pathlib.Path(tmp)
+        mod.AUTH_DIR = state_dir
+        mod.INDEX_PATH = state_dir / "index.sqlite"
+        mod.INDEX_LOCK_PATH = state_dir / "index.lock"
+        indexed = node("/notes/local-root", "active", node_type="note")
+        indexed["id"] = "local-root-123"
+        mod.index_node(indexed)
+        mod.set_local_graph_index_complete("project-1", True)
+
+        def unexpected_request(*_args, **_kwargs):
+            raise AssertionError("complete local context must not make an HTTP request")
+
+        mod.request_json = unexpected_request
+        result = mod.get_memory_context({
+            "path": "/notes/local-root",
+            "depth": 0,
+            "mode": "hybrid",
+        })
+
+        assert result["source"] == "local_index"
+        assert result["seed_node_ids"] == ["local-root-123"]
+        assert result["items"][0]["full_path"] == "/notes/local-root"
+        with mod.index_connect() as conn:
+            plan = conn.execute(
+                "EXPLAIN QUERY PLAN SELECT node_id FROM local_index_nodes "
+                "WHERE project_id = ? AND full_path = ? AND archived = 0",
+                ("project-1", "/notes/local-root"),
+            ).fetchall()
+        assert any("local_index_nodes_project_path" in row["detail"] for row in plan)
+
+
 def test_local_helper_ui_forms_submit_identity_for_existing_node_actions():
     source = (pathlib.Path(__file__).resolve().parents[1] / "resources" / "scripts" / "napseer_mcp_server.py").read_text()
     assert "name='node_id' value='{html.escape(item.get('id') or '')}'" in source
@@ -643,6 +676,7 @@ def test_recent_memory_defaults_to_paths(mod):
     assert result["ok"] is True
     assert result["view"] == "paths"
     assert result["items"] == [{
+        "node_id": "id-recent-title",
         "full_path": "/notes/recent-title",
         "type": "note",
         "status": "active",
@@ -671,6 +705,7 @@ def test_recent_memory_accepts_date_aliases_and_returns_dates(mod):
     mod.request_json = fake_request
     result = mod.recent_memory({"since": "2026-05-05", "until": "2026-05-06"})
     assert result["items"] == [{
+        "node_id": "id-recent-title",
         "full_path": "/notes/recent-title",
         "type": "note",
         "status": "active",
@@ -699,6 +734,7 @@ def test_find_defaults_to_paths_and_requests_compact_rest_view(mod):
     assert result["ok"] is True
     assert result["view"] == "paths"
     assert result["items"] == [{
+        "node_id": "id-found",
         "full_path": "/plans/found",
         "type": "plan",
         "status": "planned",
@@ -721,6 +757,8 @@ def test_discover_uses_search_when_keywords_present(mod):
     assert calls and calls[-1]["q"] == "gateway relay"
     assert calls[-1]["view"] == "summary"
     assert "date" in result["awareness"]["date_fields_in_rows"]
+    assert "item.node_id" in result["awareness"]["next_step"]
+    assert "outside discovery" in result["awareness"]["next_step"]
 
 
 def test_classify_query_points_exact_paths_to_context(mod):
@@ -748,7 +786,11 @@ def test_title_view_requests_summary_rest_view_without_content(mod):
     result = mod.list_project_nodes({"view": "titles"})
     assert result["ok"] is True
     assert result["view"] == "titles"
-    assert result["items"] == [{"title": "Readable Title", "full_path": "/notes/titled"}]
+    assert result["items"] == [{
+        "node_id": "id-titled",
+        "title": "Readable Title",
+        "full_path": "/notes/titled",
+    }]
     assert "content_text" not in result["items"][0]
 
 

tests/test_mcp_memory_node_encryption.py

@@ -296,7 +296,12 @@ def run():
     active = mod.list_project_nodes({"folder_path": "/plans", "active_only": True})
     assert [item["full_path"] for item in active["items"]] == ["/plans/active"]
     status_filtered = mod.list_project_nodes({"folder_path": "/plans", "status": ["completed"], "view": "paths"})
-    assert status_filtered["items"] == [{"full_path": "/plans/done", "type": "note", "status": "completed"}]
+    assert status_filtered["items"] == [{
+        "node_id": "done",
+        "full_path": "/plans/done",
+        "type": "note",
+        "status": "completed",
+    }]
 
     def search_response(method, path, payload=None, **kwargs):
         assert "q=" in path

tests/test_mcp_memory_surface_efficiency.py

@@ -24,6 +24,9 @@ def load_module():
 def mod(monkeypatch):
     monkeypatch.delenv("NAPSEER_TOOL_PROFILES", raising=False)
     module = load_module()
+    module._auth_state = tempfile.TemporaryDirectory()
+    module.AUTH_PATH = pathlib.Path(module._auth_state.name) / "auth.json"
+    module.AUTH = {"account_id": "acct-1", "token": "token"}
     module.CONFIGURED_TOOL_PROFILES = None
     return module
 

tests/test_mcp_search_latency.py

@@ -74,3 +74,43 @@ def test_sparse_index_search_latency_does_not_scale_with_query_variants(tmp_path
     elapsed = time.monotonic() - started
     assert len(calls) == 1
     assert elapsed < 0.15
+
+
+def test_complete_local_search_skips_remote_encryption_preflight_and_search(tmp_path):
+    mod = load_module()
+    mod.INDEX_PATH = tmp_path / "index.sqlite"
+    mod.INDEX_PATH.touch()
+    mod.resolve_project_id = lambda _args: "project-1"
+    mod.project_encryption_state = lambda _project_id: "unknown"
+    items = [
+        {
+            "id": f"node-{index}",
+            "project_id": "project-1",
+            "full_path": f"/notes/result-{index}",
+            "name": f"result-{index}",
+            "type": "note",
+            "tags": [],
+            "updated_at": "2026-08-22T00:00:00Z",
+        }
+        for index in range(5)
+    ]
+    mod.local_index_diagnostics = lambda _project_id: {
+        "exists": True,
+        "graph_complete": True,
+    }
+    mod.search_local_index = lambda _args: {
+        "items": items,
+        "query": {"terms": ["result"]},
+        "search_strategies": [],
+        "index": {"exists": True, "graph_complete": True},
+    }
+
+    def unexpected_request(*_args, **_kwargs):
+        raise AssertionError("complete local search must not make an HTTP request")
+
+    mod.request_json = unexpected_request
+    result = mod.search_memory({"q": "result", "limit": 5, "view": "summary"})
+
+    assert result["sources"] == ["local"]
+    assert len(result["items"]) == 5
+    assert all(item["node_id"].startswith("node-") for item in result["items"])