diff --git a/src/extract_claude_logs.py b/src/extract_claude_logs.py
index 8430825..a65820a 100644
--- a/src/extract_claude_logs.py
+++ b/src/extract_claude_logs.py
@@ -14,6 +14,22 @@
 from typing import Dict, List, Optional, Tuple
 
 
+# Constants
+INDENT_NUMBER = 2
+MAJOR_SEPARATOR_WIDTH = 60
+MINOR_SEPARATOR_WIDTH = 40
+SESSION_ID_MAX_LENGTH = 8
+LINES_SHOWN_MESSAGE = 8
+LINES_PER_PAGE_MESSAGE = 30
+MAX_LINES_PER_MESSAGE_DISPLAY = 50
+MAX_LINE_LENGTH_DISPLAY = 100
+MIN_PREVIEW_TEXT_LENGTH = 3
+PREVIEW_TEXT_TRUNCATE_LENGTH = 100
+PREVIEW_ERROR_TRUNCATE_LENGTH = 30
+LIST_SEPARATOR_WIDTH = 80
+SEARCH_MAX_RESULTS_DEFAULT = 30
+
+
 class ClaudeConversationExtractor:
     """Extract and convert Claude Code conversations from JSONL to markdown."""
 
@@ -122,7 +138,7 @@ def extract_conversation(self, jsonl_path: Path, detailed: bool = False) -> List
                                 conversation.append(
                                     {
                                         "role": "tool_use",
-                                        "content": f"🔧 Tool: {tool_name}\nInput: {json.dumps(tool_input, indent=2)}",
+                                        "content": f"🔧 Tool: {tool_name}\nInput: {json.dumps(tool_input, indent=INDENT_NUMBER)}",
                                         "timestamp": entry.get("timestamp", ""),
                                     }
                                 )
@@ -183,7 +199,7 @@ def _extract_text_content(self, content, detailed: bool = False) -> str:
                         tool_name = item.get("name", "unknown")
                         tool_input = item.get("input", {})
                         text_parts.append(f"\n🔧 Using tool: {tool_name}")
-                        text_parts.append(f"Input: {json.dumps(tool_input, indent=2)}\n")
+                        text_parts.append(f"Input: {json.dumps(tool_input, indent=INDENT_NUMBER)}\n")
             return "\n".join(text_parts)
         else:
             return str(content)
@@ -208,9 +224,9 @@ def display_conversation(self, jsonl_path: Path, detailed: bool = False) -> None
             
             # Clear screen and show header
             print("\033[2J\033[H", end="")  # Clear screen
-            print("=" * 60)
+            print("=" * MAJOR_SEPARATOR_WIDTH)
             print(f"📄 Viewing: {jsonl_path.parent.name}")
-            print(f"Session: {session_id[:8]}...")
+            print(f"Session: {session_id[:SESSION_ID_MAX_LENGTH]}...")
             
             # Get timestamp from first message
             first_timestamp = messages[0].get("timestamp", "")
@@ -221,12 +237,12 @@ def display_conversation(self, jsonl_path: Path, detailed: bool = False) -> None
                 except Exception:
                     pass
             
-            print("=" * 60)
+            print("=" * MAJOR_SEPARATOR_WIDTH)
             print("↑↓ to scroll • Q to quit • Enter to continue\n")
             
             # Display messages with pagination
-            lines_shown = 8  # Header lines
-            lines_per_page = 30
+            lines_shown = LINES_SHOWN_MESSAGE  # Header lines
+            lines_per_page = LINES_PER_PAGE_MESSAGE
             
             for i, msg in enumerate(messages):
                 role = msg["role"]
@@ -234,13 +250,13 @@ def display_conversation(self, jsonl_path: Path, detailed: bool = False) -> None
                 
                 # Format role display
                 if role == "user" or role == "human":
-                    print(f"\n{'─' * 40}")
+                    print(f"\n{'─' * MINOR_SEPARATOR_WIDTH}")
                     print(f"👤 HUMAN:")
-                    print(f"{'─' * 40}")
+                    print(f"{'─' * MINOR_SEPARATOR_WIDTH}")
                 elif role == "assistant":
-                    print(f"\n{'─' * 40}")
+                    print(f"\n{'─' * MINOR_SEPARATOR_WIDTH}")
                     print(f"🤖 CLAUDE:")
-                    print(f"{'─' * 40}")
+                    print(f"{'─' * MINOR_SEPARATOR_WIDTH}")
                 elif role == "tool_use":
                     print(f"\n🔧 TOOL USE:")
                 elif role == "tool_result":
@@ -252,12 +268,12 @@ def display_conversation(self, jsonl_path: Path, detailed: bool = False) -> None
                 
                 # Display content (limit very long messages)
                 lines = content.split('\n')
-                max_lines_per_msg = 50
+                max_lines_per_msg = MAX_LINES_PER_MESSAGE_DISPLAY
                 
                 for line_idx, line in enumerate(lines[:max_lines_per_msg]):
                     # Wrap very long lines
-                    if len(line) > 100:
-                        line = line[:97] + "..."
+                    if len(line) > MAX_LINE_LENGTH_DISPLAY:
+                        line = line[:(MAX_LINE_LENGTH_DISPLAY - 3)] + "..."
                     print(line)
                     lines_shown += 1
                     
@@ -275,9 +291,9 @@ def display_conversation(self, jsonl_path: Path, detailed: bool = False) -> None
                     print(f"... [{len(lines) - max_lines_per_msg} more lines truncated]")
                     lines_shown += 1
             
-            print("\n" + "=" * 60)
+            print("\n" + "=" * MAJOR_SEPARATOR_WIDTH)
             print("📄 End of conversation")
-            print("=" * 60)
+            print("=" * MAJOR_SEPARATOR_WIDTH)
             input("\nPress Enter to continue...")
             
         except Exception as e:
@@ -306,7 +322,7 @@ def save_as_markdown(
             date_str = datetime.now().strftime("%Y-%m-%d")
             time_str = ""
 
-        filename = f"claude-conversation-{date_str}-{session_id[:8]}.md"
+        filename = f"claude-conversation-{date_str}-{session_id[:SESSION_ID_MAX_LENGTH]}.md"
         output_path = self.output_dir / filename
 
         with open(output_path, "w", encoding="utf-8") as f:
@@ -361,7 +377,7 @@ def save_as_json(
         else:
             date_str = datetime.now().strftime("%Y-%m-%d")
 
-        filename = f"claude-conversation-{date_str}-{session_id[:8]}.json"
+        filename = f"claude-conversation-{date_str}-{session_id[:SESSION_ID_MAX_LENGTH]}.json"
         output_path = self.output_dir / filename
 
         # Create JSON structure
@@ -373,7 +389,7 @@ def save_as_json(
         }
 
         with open(output_path, "w", encoding="utf-8") as f:
-            json.dump(output, f, indent=2, ensure_ascii=False)
+            json.dump(output, f, indent=INDENT_NUMBER, ensure_ascii=False)
 
         return output_path
     
@@ -398,7 +414,7 @@ def save_as_html(
             date_str = datetime.now().strftime("%Y-%m-%d")
             time_str = ""
 
-        filename = f"claude-conversation-{date_str}-{session_id[:8]}.html"
+        filename = f"claude-conversation-{date_str}-{session_id[:SESSION_ID_MAX_LENGTH]}.html"
         output_path = self.output_dir / filename
 
         # HTML template with modern styling
@@ -407,7 +423,7 @@ def save_as_html(
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Claude Conversation - {session_id[:8]}</title>
+    <title>Claude Conversation - {session_id[:SESSION_ID_MAX_LENGTH]}</title>
     <style>
         body {{
             font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
@@ -593,8 +609,8 @@ def get_conversation_preview(self, session_path: Path) -> Tuple[str, int]:
                                                         text = parts[1].strip()
                                                 
                                                 # If we have real user text, use it
-                                                if text and len(text) > 3:  # Lower threshold to catch "hello"
-                                                    first_user_msg = text[:100].replace('\n', ' ')
+                                                if text and len(text) > MIN_PREVIEW_TEXT_LENGTH:  # Lower threshold to catch "hello"
+                                                    first_user_msg = text[:PREVIEW_TEXT_TRUNCATE_LENGTH].replace('\n', ' ')
                                                     break
                                     
                                     # Handle string content (less common but possible)
@@ -615,14 +631,14 @@ def get_conversation_preview(self, session_path: Path) -> Tuple[str, int]:
                                         
                                         # Skip tool results and interruptions
                                         if not content.startswith("tool_use_id") and "[Request interrupted" not in content:
-                                            if content and len(content) > 3:  # Lower threshold to catch short messages
-                                                first_user_msg = content[:100].replace('\n', ' ')
+                                            if content and len(content) > MIN_PREVIEW_TEXT_LENGTH:  # Lower threshold to catch short messages
+                                                first_user_msg = content[:PREVIEW_TEXT_TRUNCATE_LENGTH].replace('\n', ' ')
                         except json.JSONDecodeError:
                             continue
                             
             return first_user_msg or "No preview available", msg_count
         except Exception as e:
-            return f"Error: {str(e)[:30]}", 0
+            return f"Error: {str(e)[:PREVIEW_ERROR_TRUNCATE_LENGTH]}", 0
 
     def list_recent_sessions(self, limit: int = None) -> List[Path]:
         """List recent sessions with details."""
@@ -634,7 +650,7 @@ def list_recent_sessions(self, limit: int = None) -> List[Path]:
             return []
 
         print(f"\n📚 Found {len(sessions)} Claude sessions:\n")
-        print("=" * 80)
+        print("=" * LIST_SEPARATOR_WIDTH)
 
         # Show all sessions if no limit specified
         sessions_to_show = sessions[:limit] if limit else sessions
@@ -656,13 +672,13 @@ def list_recent_sessions(self, limit: int = None) -> List[Path]:
 
             # Print formatted info
             print(f"\n{i}. 📁 {project}")
-            print(f"   📄 Session: {session_id[:8]}...")
+            print(f"   📄 Session: {session_id[:SESSION_ID_MAX_LENGTH]}...")
             print(f"   📅 Modified: {modified.strftime('%Y-%m-%d %H:%M')}")
             print(f"   💬 Messages: {msg_count}")
             print(f"   💾 Size: {size_kb:.1f} KB")
             print(f"   📝 Preview: \"{preview}...\"")
 
-        print("\n" + "=" * 80)
+        print("\n" + "=" * LIST_SEPARATOR_WIDTH)
         return sessions[:limit]
 
     def extract_multiple(
@@ -844,7 +860,7 @@ def main():
             date_to=date_to,
             speaker_filter=speaker_filter,
             case_sensitive=args.case_sensitive,
-            max_results=30,
+            max_results=SEARCH_MAX_RESULTS_DEFAULT,
         )
 
         if not results:
@@ -867,11 +883,11 @@ def main():
             print(f"\n{len(file_paths_list)}. 📄 {file_path.parent.name} ({len(file_results)} matches)")
             # Show first match preview
             first = file_results[0]
-            print(f"   {first.speaker}: {first.matched_content[:100]}...")
+            print(f"   {first.speaker}: {first.matched_content[:PREVIEW_TEXT_TRUNCATE_LENGTH]}...")
 
         # Offer to view conversations
         if file_paths_list:
-            print("\n" + "=" * 60)
+            print("\n" + "=" * MAJOR_SEPARATOR_WIDTH)
             try:
                 view_choice = input("\nView a conversation? Enter number (1-{}) or press Enter to skip: ".format(
                     len(file_paths_list))).strip()
diff --git a/src/interactive_ui.py b/src/interactive_ui.py
index d7b3450..9ad15d5 100644
--- a/src/interactive_ui.py
+++ b/src/interactive_ui.py
@@ -21,6 +21,14 @@
     from search_conversations import ConversationSearcher
 
 
+# Constants
+SESSION_DISPLAY_LIMIT = 20
+PROJECT_LENGTH = 30
+MAJOR_SEPARATOR_WIDTH = 60
+PROGRESS_BAR_WIDTH = 40
+RECENT_SESSIONS_LIMIT = 5
+
+
 class InteractiveUI:
     """Interactive terminal UI for easier conversation extraction"""
 
@@ -120,18 +128,18 @@ def show_sessions_menu(self) -> List[int]:
         print(f"\n✅ Found {len(self.sessions)} conversations!\n")
 
         # Display sessions
-        for i, session_path in enumerate(self.sessions[:20], 1):  # Show max 20
+        for i, session_path in enumerate(self.sessions[:SESSION_DISPLAY_LIMIT], 1):  # Show max SESSION_DISPLAY_LIMIT
             project = session_path.parent.name
             modified = datetime.fromtimestamp(session_path.stat().st_mtime)
             size_kb = session_path.stat().st_size / 1024
 
             date_str = modified.strftime("%Y-%m-%d %H:%M")
-            print(f"  {i:2d}. [{date_str}] {project[:30]:<30} ({size_kb:.1f} KB)")
+            print(f"  {i:2d}. [{date_str}] {project[:PROJECT_LENGTH]:<{PROJECT_LENGTH}} ({size_kb:.1f} KB)")
 
-        if len(self.sessions) > 20:
-            print(f"\n  ... and {len(self.sessions) - 20} more conversations")
+        if len(self.sessions) > SESSION_DISPLAY_LIMIT:
+            print(f"\n  ... and {len(self.sessions) - SESSION_DISPLAY_LIMIT} more conversations")
 
-        print("\n" + "=" * 60)
+        print("\n" + "=" * MAJOR_SEPARATOR_WIDTH)
         print("\nOptions:")
         print("  A. Extract ALL conversations")
         print("  R. Extract 5 most RECENT")
@@ -147,7 +155,7 @@ def show_sessions_menu(self) -> List[int]:
             elif choice == "A":
                 return list(range(len(self.sessions)))
             elif choice == "R":
-                return list(range(min(5, len(self.sessions))))
+                return list(range(min(RECENT_SESSIONS_LIMIT, len(self.sessions))))
             elif choice == "S":
                 selection = input("Enter conversation numbers (e.g., 1,3,5): ").strip()
                 try:
@@ -169,7 +177,7 @@ def show_sessions_menu(self) -> List[int]:
 
     def show_progress(self, current: int, total: int, message: str = ""):
         """Display a simple progress bar"""
-        bar_width = 40
+        bar_width = PROGRESS_BAR_WIDTH
         progress = current / total if total > 0 else 0
         filled = int(bar_width * progress)
         bar = "█" * filled + "░" * (bar_width - filled)
diff --git a/src/realtime_search.py b/src/realtime_search.py
index 4aabe41..97ebfb1 100644
--- a/src/realtime_search.py
+++ b/src/realtime_search.py
@@ -22,6 +22,21 @@
     import tty
 
 
+# Constants
+TERMINAL_UPDATE_RATE = 0.1
+GET_KEY_SLEEP_TIME = 0.01
+MAX_PREVIEW_LENGTH = 60
+MAX_RESULTS_DISPLAYED = 10
+PROJECT_NAME_MAX_LENGTH = 20
+DEBOUNCE_DELAY_MS = 300
+DEFAULT_MAX_RESULTS = 20
+SEARCH_WORKER_POLL_INTERVAL = 0.05
+TIMEOUT_WORKER_THREAD = 0.5
+HEADER_LINES_COUNT = 4
+MAJOR_SEPARATOR_WIDTH = 60
+SEARCH_BOX_OFFSET = 3
+
+
 @dataclass
 class SearchState:
     """Maintains the current state of the search interface"""
@@ -58,7 +73,7 @@ def __exit__(self, *args):
         if sys.platform != "win32" and self.old_settings:
             termios.tcsetattr(self.stdin_fd, termios.TCSADRAIN, self.old_settings)
 
-    def get_key(self, timeout: float = 0.1) -> Optional[str]:
+    def get_key(self, timeout: float = TERMINAL_UPDATE_RATE) -> Optional[str]:
         """Get a single keypress with timeout - FIXED version"""
         if sys.platform == "win32":
             # Windows implementation
@@ -88,7 +103,7 @@ def get_key(self, timeout: float = 0.1) -> Optional[str]:
                             return key.decode("utf-8")
                         except UnicodeDecodeError:
                             return None
-                time.sleep(0.01)
+                time.sleep(GET_KEY_SLEEP_TIME)
             return None
         else:
             # Unix/Linux/macOS implementation - FIXED
@@ -145,7 +160,7 @@ class TerminalDisplay:
 
     def __init__(self):
         self.last_result_count = 0
-        self.header_lines = 4  # Lines used by header
+        self.header_lines = HEADER_LINES_COUNT  # Lines used by header
 
     def clear_screen(self):
         """Clear the terminal screen"""
@@ -174,9 +189,9 @@ def draw_header(self):
         """Draw the search interface header"""
         self.move_cursor(1, 1)
         print("🔍 REAL-TIME SEARCH")
-        print("=" * 60)
+        print("=" * MAJOR_SEPARATOR_WIDTH)
         print("Type to search • ↑↓ to select • Enter to open • ESC to exit")
-        print("─" * 60)
+        print("─" * MAJOR_SEPARATOR_WIDTH)
 
     def draw_results(self, results: List, selected_index: int, query: str):
         """Draw search results with highlighting"""
@@ -193,7 +208,7 @@ def draw_results(self, results: List, selected_index: int, query: str):
                 print("Start typing to search...")
         else:
             # Display results
-            for i, result in enumerate(results[:10]):  # Show max 10 results
+            for i, result in enumerate(results[:MAX_RESULTS_DISPLAYED]):  # Show max MAX_RESULTS_DISPLAYED results
                 self.move_cursor(self.header_lines + i + 1, 1)
 
                 # Format result display
@@ -204,10 +219,10 @@ def draw_results(self, results: List, selected_index: int, query: str):
 
                 # Show result info
                 date_str = result.timestamp.strftime("%Y-%m-%d")
-                project = Path(result.file_path).parent.name[:20]
+                project = Path(result.file_path).parent.name[:PROJECT_NAME_MAX_LENGTH]
 
                 # Highlight matching text
-                preview = result.context[:60].replace("\n", " ")
+                preview = result.context[:MAX_PREVIEW_LENGTH].replace("\n", " ")
                 if query.lower() in preview.lower():
                     # Simple highlighting - could be improved
                     idx = preview.lower().find(query.lower())
@@ -219,15 +234,15 @@ def draw_results(self, results: List, selected_index: int, query: str):
 
                 print(f"📄 {date_str} | {project} | {preview}...")
 
-        self.last_result_count = len(results[:10])
+        self.last_result_count = len(results[:MAX_RESULTS_DISPLAYED])
 
     def draw_search_box(self, query: str, cursor_pos: int):
         """Draw the search input box"""
         # Position at bottom of results
-        row = self.header_lines + self.last_result_count + 3
+        row = self.header_lines + self.last_result_count + SEARCH_BOX_OFFSET
         self.move_cursor(row, 1)
         self.clear_line()
-        print("─" * 60)
+        print("─" * MAJOR_SEPARATOR_WIDTH)
 
         self.move_cursor(row + 1, 1)
         self.clear_line()
@@ -249,7 +264,7 @@ def __init__(self, searcher, extractor):
         self.search_thread = None
         self.search_lock = threading.Lock()
         self.results_cache = {}
-        self.debounce_delay = 0.3  # 300ms debounce
+        self.debounce_delay = DEBOUNCE_DELAY_MS / 1000  # Convert to seconds
         self.stop_event = threading.Event()  # For clean thread shutdown
 
     def _process_search_request(self):
@@ -282,7 +297,7 @@ def _process_search_request(self):
             search_kwargs = {
                 "query": query,
                 "mode": "smart",
-                "max_results": 20,
+                "max_results": DEFAULT_MAX_RESULTS,
                 "case_sensitive": False,
             }
             if hasattr(self, "search_dir") and self.search_dir:
@@ -307,7 +322,7 @@ def search_worker(self):
         """Background thread for searching"""
         while not self.stop_event.is_set():
             # Wait for search request
-            time.sleep(0.05)
+            time.sleep(SEARCH_WORKER_POLL_INTERVAL)
             self._process_search_request()
 
         # Thread cleanup
@@ -335,7 +350,7 @@ def handle_input(self, key: str) -> Optional[str]:
         elif key == "DOWN":
             if self.state.results:
                 self.state.selected_index = min(
-                    len(self.state.results[:10]) - 1, self.state.selected_index + 1
+                    len(self.state.results[:MAX_RESULTS_DISPLAYED]) - 1, self.state.selected_index + 1
                 )
                 return "redraw"  # Signal to redraw
 
@@ -389,7 +404,7 @@ def stop(self):
         """Stop the search worker thread cleanly"""
         if self.search_thread and self.search_thread.is_alive():
             self.stop_event.set()
-            self.search_thread.join(timeout=0.5)
+            self.search_thread.join(timeout=TIMEOUT_WORKER_THREAD)
 
     def run(self) -> Optional[Path]:
         """Run the real-time search interface"""
@@ -404,7 +419,7 @@ def run(self) -> Optional[Path]:
             with KeyboardHandler() as keyboard:
                 # Initial draw
                 self.display.draw_results(
-                    self.state.results[:10],
+                    self.state.results[:MAX_RESULTS_DISPLAYED],
                     self.state.selected_index,
                     self.state.query,
                 )
@@ -414,7 +429,7 @@ def run(self) -> Optional[Path]:
                 
                 while True:
                     # Get keyboard input
-                    key = keyboard.get_key(timeout=0.1)
+                    key = keyboard.get_key(timeout=TERMINAL_UPDATE_RATE)
                     
                     if key:
                         action = self.handle_input(key)
@@ -429,7 +444,7 @@ def run(self) -> Optional[Path]:
                         elif action == "redraw" or action is None:
                             # Redraw the interface
                             self.display.draw_results(
-                                self.state.results[:10],
+                                self.state.results[:MAX_RESULTS_DISPLAYED],
                                 self.state.selected_index,
                                 self.state.query,
                             )
@@ -510,7 +525,7 @@ def smart_search(query: str, **kwargs):
                 pass  # Keep original order if sorting fails
 
         # Limit results
-        max_results = kwargs.get("max_results", 20)
+        max_results = kwargs.get("max_results", DEFAULT_MAX_RESULTS)
         return results[:max_results]
 
     # Replace the search method
diff --git a/src/search_conversations.py b/src/search_conversations.py
index b78f51a..1d4d3f6 100644
--- a/src/search_conversations.py
+++ b/src/search_conversations.py
@@ -30,6 +30,35 @@
     print("      pip install spacy && python -m spacy download en_core_web_sm")
 
 
+# Constants
+MAJOR_SEPARATOR_WIDTH = 60
+DEFAULT_MAX_RESULTS = 20
+MAX_CONTENT_LENGTH = 200
+DEFAULT_CONTEXT_SIZE  = 150
+DEFAULT_MAX_TOPICS = 5
+CONTENT_LENGTH_PROCESSING = 10
+MAX_NOUN_PHRASES_LENGTH = 3
+INDENT_NUMBER = 2
+MIN_TOPIC_PHRASE_COUNT = 1
+
+# Other constants for relevance or similarity
+RELEVANCE_THRESHOLD = 0.1
+MIN_RELEVANCE_COMPARED = 1.0
+MATCH_FACTOR_FOR_RELEVANCE = 0.2
+MATCH_BONUS = 0.5
+MIN_RELEVANCE_MULTIPLE_OCCURRENCES = 0.3
+MATCH_FACTOR_MULTIPLE_OCCURRENCES = 0.1
+MIN_RELEVANCE_OVERLAP = 0.4
+MATCH_FACTOR_OVERLAP = 0.4
+PROXIMITY_BONUS = 0.1
+MIN_TOKENS_FOR_PROXIMITY_BONUS = 1
+PROXIMITY_WINDOW_MULTIPLIER = 2
+ADDITIONAL_BOOST_EXACT_MATCH = 0.3
+MATCH_CONTEXT_STEP = 100
+SEMANTIC_SIMILARITY_THRESHOLD = 0.3
+CONTEXT_FALLBACK_MULTIPLIER = 2
+
+
 @dataclass
 class SearchResult:
     """Represents a search result with context"""
@@ -46,11 +75,11 @@ class SearchResult:
     def __str__(self) -> str:
         """User-friendly string representation"""
         return (
-            f"\n{'=' * 60}\n"
+            f"\n{'=' * MAJOR_SEPARATOR_WIDTH}\n"
             f"File: {self.file_path.name}\n"
             f"Speaker: {self.speaker.title()}\n"
             f"Relevance: {self.relevance_score:.0%}\n"
-            f"{'=' * 60}\n"
+            f"{'=' * MAJOR_SEPARATOR_WIDTH}\n"
             f"{self.context}\n"
         )
 
@@ -133,7 +162,7 @@ def search(
         date_from: Optional[datetime] = None,
         date_to: Optional[datetime] = None,
         speaker_filter: Optional[str] = None,
-        max_results: int = 20,
+        max_results: int = DEFAULT_MAX_RESULTS,
         case_sensitive: bool = False,
     ) -> List[SearchResult]:
         """
@@ -272,7 +301,7 @@ def _search_smart(
                                 content, query, query_tokens, case_sensitive
                             )
 
-                            if relevance > 0.1:  # Threshold for inclusion
+                            if relevance > RELEVANCE_THRESHOLD:  # Threshold for inclusion
                                 # Extract context
                                 context = self._extract_context(
                                     content, query, case_sensitive
@@ -292,7 +321,7 @@ def _search_smart(
                                 result = SearchResult(
                                     file_path=jsonl_file,
                                     conversation_id=conversation_id,
-                                    matched_content=content[:200],
+                                    matched_content=content[:MAX_CONTENT_LENGTH],
                                     context=context,
                                     speaker=speaker,
                                     timestamp=timestamp,
@@ -349,7 +378,7 @@ def _search_exact(
                             if search_query in search_content:
                                 # Calculate relevance based on match frequency
                                 match_count = search_content.count(search_query)
-                                relevance = min(1.0, match_count * 0.2)
+                                relevance = min(MIN_RELEVANCE_COMPARED, match_count * MATCH_FACTOR_FOR_RELEVANCE)
 
                                 context = self._extract_context(
                                     content, query, case_sensitive
@@ -369,7 +398,7 @@ def _search_exact(
                                 result = SearchResult(
                                     file_path=jsonl_file,
                                     conversation_id=conversation_id,
-                                    matched_content=content[:200],
+                                    matched_content=content[:MAX_CONTENT_LENGTH],
                                     context=context,
                                     speaker=speaker,
                                     timestamp=timestamp,
@@ -429,12 +458,12 @@ def _search_regex(
 
                             if matches:
                                 # Calculate relevance based on match quality
-                                relevance = min(1.0, len(matches) * 0.2)
+                                relevance = min(MIN_RELEVANCE_COMPARED, len(matches) * MATCH_FACTOR_FOR_RELEVANCE)
 
                                 # Get context around first match
                                 first_match = matches[0]
-                                start = max(0, first_match.start() - 100)
-                                end = min(len(content), first_match.end() + 100)
+                                start = max(0, first_match.start() - MATCH_CONTEXT_STEP)
+                                end = min(len(content), first_match.end() + MATCH_CONTEXT_STEP)
                                 context = "..." + content[start:end] + "..."
 
                                 # Parse timestamp if present
@@ -516,7 +545,7 @@ def _search_semantic(
                                 query_doc, query_tokens, content_doc
                             )
 
-                            if similarity > 0.3:  # Threshold for semantic matches
+                            if similarity > SEMANTIC_SIMILARITY_THRESHOLD:  # Threshold for semantic matches
                                 context = self._extract_context(content, query, False)
 
                                 # Parse timestamp if present
@@ -533,7 +562,7 @@ def _search_semantic(
                                 result = SearchResult(
                                     file_path=jsonl_file,
                                     conversation_id=conversation_id,
-                                    matched_content=content[:200],
+                                    matched_content=content[:MAX_CONTENT_LENGTH],
                                     context=context,
                                     speaker=speaker,
                                     timestamp=timestamp,
@@ -603,28 +632,28 @@ def _calculate_relevance(
 
         # Exact match bonus
         if query_lower in content_lower:
-            relevance += 0.5
+            relevance += MATCH_BONUS
             # Additional bonus for multiple occurrences
             count = content_lower.count(query_lower)
-            relevance += min(0.3, count * 0.1)
+            relevance += min(MIN_RELEVANCE_MULTIPLE_OCCURRENCES, count * MATCH_FACTOR_MULTIPLE_OCCURRENCES)
 
         # Token overlap
         content_tokens = set(content_lower.split()) - self.stop_words
         if query_tokens and content_tokens:
             overlap = len(query_tokens & content_tokens)
-            relevance += min(0.4, overlap / len(query_tokens) * 0.4)
+            relevance += min(MIN_RELEVANCE_OVERLAP, overlap / len(query_tokens) * MATCH_FACTOR_OVERLAP)
 
         # Proximity bonus - are query terms near each other?
-        if len(query_tokens) > 1:
+        if len(query_tokens) > MIN_TOKENS_FOR_PROXIMITY_BONUS:
             # Check if all query tokens appear within a window
             words = content_lower.split()
             for i in range(len(words) - len(query_tokens)):
-                window = set(words[i : i + len(query_tokens) * 2])
+                window = set(words[i : i + len(query_tokens) * PROXIMITY_WINDOW_MULTIPLIER])
                 if query_tokens.issubset(window):
-                    relevance += 0.1
+                    relevance += PROXIMITY_BONUS
                     break
 
-        return min(1.0, relevance)
+        return min(MIN_RELEVANCE_COMPARED, relevance)
 
     def _calculate_semantic_similarity(
         self, query_doc, query_tokens, content_doc
@@ -654,12 +683,12 @@ def _calculate_semantic_similarity(
 
         # Boost for exact phrase matches
         if query_doc.text.lower() in content_doc.text.lower():
-            base_similarity = min(1.0, base_similarity + 0.3)
+            base_similarity = min(MIN_RELEVANCE_COMPARED, base_similarity + ADDITIONAL_BOOST_EXACT_MATCH)
 
         return base_similarity
 
     def _extract_context(
-        self, content: str, query: str, case_sensitive: bool, context_size: int = 150
+        self, content: str, query: str, case_sensitive: bool, context_size: int = DEFAULT_CONTEXT_SIZE
     ) -> str:
         """Extract context around the match for display."""
         if not case_sensitive:
@@ -670,8 +699,8 @@ def _extract_context(
 
         if pos == -1:
             # No exact match, return beginning of content
-            return content[: context_size * 2] + (
-                "..." if len(content) > context_size * 2 else ""
+            return content[: context_size * CONTEXT_FALLBACK_MULTIPLIER] + (
+                "..." if len(content) > context_size * CONTEXT_FALLBACK_MULTIPLIER else ""
             )
 
         # Extract context around match
@@ -707,7 +736,7 @@ def search_by_date_range(
         return self._filter_files_by_date(jsonl_files, date_from, date_to)
 
     def get_conversation_topics(
-        self, jsonl_file: Path, max_topics: int = 5
+        self, jsonl_file: Path, max_topics: int = DEFAULT_MAX_TOPICS
     ) -> List[str]:
         """
         Extract main topics from a conversation.
@@ -736,13 +765,13 @@ def get_conversation_topics(
             return []
 
         # Process with spaCy
-        full_text = " ".join(all_content[:10])  # Limit to avoid processing too much
+        full_text = " ".join(all_content[:CONTENT_LENGTH_PROCESSING])  # Limit to avoid processing too much
         doc = self.nlp(full_text)
 
         # Extract noun phrases as topics
         noun_phrases = []
         for chunk in doc.noun_chunks:
-            if len(chunk.text.split()) <= 3:  # Reasonable length
+            if len(chunk.text.split()) <= MAX_NOUN_PHRASES_LENGTH:  # Reasonable length
                 noun_phrases.append(chunk.text.lower())
 
         # Count frequency
@@ -754,7 +783,7 @@ def get_conversation_topics(
         sorted_phrases = sorted(phrase_counts.items(), key=lambda x: x[1], reverse=True)
 
         # Return top topics
-        return [phrase for phrase, count in sorted_phrases[:max_topics] if count > 1]
+        return [phrase for phrase, count in sorted_phrases[:max_topics] if count > MIN_TOPIC_PHRASE_COUNT]
 
 
 def create_search_index(search_dir: Path, output_file: Path) -> None:
@@ -810,7 +839,7 @@ def create_search_index(search_dir: Path, output_file: Path) -> None:
 
     # Save index
     with open(output_file, "w") as f:
-        json.dump(index, f, indent=2)
+        json.dump(index, f, indent=INDENT_NUMBER)
 
     print(f"Created search index with {len(index['conversations'])} conversations")