claude-code-workflow 6.3.4 → 6.3.5

package/ccw/src/templates/dashboard-js/components/cli-history.js

@@ -15,7 +15,9 @@ async function loadCliHistory(options = {}) {
     const { limit = cliHistoryLimit, tool = cliHistoryFilter, status = null } = options;
 
     // Use history-native endpoint to get native session info
-    let url = `/api/cli/history-native?path=${encodeURIComponent(projectPath)}&limit=${limit}`;
+    // Use recursiveQueryEnabled setting (from cli-status.js) to control recursive query
+    const recursive = typeof recursiveQueryEnabled !== 'undefined' ? recursiveQueryEnabled : true;
+    let url = `/api/cli/history-native?path=${encodeURIComponent(projectPath)}&limit=${limit}&recursive=${recursive}`;
     if (tool) url += `&tool=${tool}`;
     if (status) url += `&status=${status}`;
     if (cliHistorySearch) url += `&search=${encodeURIComponent(cliHistorySearch)}`;
@@ -36,9 +38,12 @@ async function loadCliHistory(options = {}) {
 async function loadNativeSessionContent(executionId, sourceDir) {
   try {
     // If sourceDir provided, use it to build the correct path
-    const basePath = sourceDir && sourceDir !== '.'
-      ? projectPath + '/' + sourceDir
-      : projectPath;
+    // Check if sourceDir is absolute path (contains : or starts with /)
+    let basePath = projectPath;
+    if (sourceDir && sourceDir !== '.') {
+      const isAbsolute = sourceDir.includes(':') || sourceDir.startsWith('/');
+      basePath = isAbsolute ? sourceDir : projectPath + '/' + sourceDir;
+    }
     const url = `/api/cli/native-session?path=${encodeURIComponent(basePath)}&id=${encodeURIComponent(executionId)}`;
     const response = await fetch(url);
     if (!response.ok) return null;
@@ -65,9 +70,12 @@ async function loadEnrichedConversation(executionId) {
 async function loadExecutionDetail(executionId, sourceDir) {
   try {
     // If sourceDir provided, use it to build the correct path
-    const basePath = sourceDir && sourceDir !== '.' 
-      ? projectPath + '/' + sourceDir 
-      : projectPath;
+    // Check if sourceDir is absolute path (contains : or starts with /)
+    let basePath = projectPath;
+    if (sourceDir && sourceDir !== '.') {
+      const isAbsolute = sourceDir.includes(':') || sourceDir.startsWith('/');
+      basePath = isAbsolute ? sourceDir : projectPath + '/' + sourceDir;
+    }
     const url = `/api/cli/execution?path=${encodeURIComponent(basePath)}&id=${encodeURIComponent(executionId)}`;
     const response = await fetch(url);
     if (!response.ok) throw new Error('Execution not found');
@@ -137,8 +145,9 @@ function renderCliHistory() {
              </span>`
           : '';
 
-        // Escape sourceDir for use in onclick
-        const sourceDirEscaped = exec.sourceDir ? exec.sourceDir.replace(/'/g, "\\'") : '';
+        // Normalize and escape sourceDir for use in onclick
+        // Convert backslashes to forward slashes to prevent JS escape issues in onclick
+        const sourceDirEscaped = exec.sourceDir ? exec.sourceDir.replace(/\\/g, '/').replace(/'/g, "\\'") : '';
 
         return `
           <div class="cli-history-item ${hasNative ? 'has-native' : ''}">
@@ -155,11 +164,14 @@ function renderCliHistory() {
               <div class="cli-history-meta">
                 <span><i data-lucide="clock" class="w-3 h-3"></i> ${timeAgo}</span>
                 <span><i data-lucide="timer" class="w-3 h-3"></i> ${duration}</span>
-                <span><i data-lucide="hash" class="w-3 h-3"></i> ${exec.id.split('-')[0]}</span>
+                <span title="${exec.id}"><i data-lucide="hash" class="w-3 h-3"></i> ${exec.id.substring(0, 13)}...${exec.id.split('-').pop()}</span>
                 ${turnBadge}
               </div>
             </div>
             <div class="cli-history-actions">
+              <button class="btn-icon" onclick="event.stopPropagation(); copyCliExecutionId('${exec.id}')" title="Copy ID">
+                <i data-lucide="copy" class="w-3.5 h-3.5"></i>
+              </button>
               ${hasNative ? `
                 <button class="btn-icon" onclick="event.stopPropagation(); showNativeSessionDetail('${exec.id}', '${sourceDirEscaped}')" title="View Native Session">
                   <i data-lucide="file-json" class="w-3.5 h-3.5"></i>
@@ -431,9 +443,12 @@ function confirmDeleteExecution(executionId, sourceDir) {
 async function deleteExecution(executionId, sourceDir) {
   try {
     // Build correct path - use sourceDir if provided for recursive items
-    const basePath = sourceDir && sourceDir !== '.' 
-      ? projectPath + '/' + sourceDir 
-      : projectPath;
+    // Check if sourceDir is absolute path (contains : or starts with /)
+    let basePath = projectPath;
+    if (sourceDir && sourceDir !== '.') {
+      const isAbsolute = sourceDir.includes(':') || sourceDir.startsWith('/');
+      basePath = isAbsolute ? sourceDir : projectPath + '/' + sourceDir;
+    }
     
     const response = await fetch(`/api/cli/execution?path=${encodeURIComponent(basePath)}&id=${encodeURIComponent(executionId)}`, {
       method: 'DELETE'
@@ -461,6 +476,18 @@ async function deleteExecution(executionId, sourceDir) {
 }
 
 // ========== Copy Functions ==========
+async function copyCliExecutionId(executionId) {
+  if (navigator.clipboard) {
+    try {
+      await navigator.clipboard.writeText(executionId);
+      showRefreshToast('ID copied: ' + executionId, 'success');
+    } catch (err) {
+      console.error('Failed to copy ID:', err);
+      showRefreshToast('Failed to copy ID', 'error');
+    }
+  }
+}
+
 async function copyExecutionPrompt(executionId) {
   const detail = await loadExecutionDetail(executionId);
   if (!detail) {

package/ccw/src/templates/dashboard-js/components/cli-status.js

@@ -21,9 +21,24 @@ let nativeResumeEnabled = localStorage.getItem('ccw-native-resume') !== 'false';
 // Recursive Query settings (for hierarchical storage aggregation)
 let recursiveQueryEnabled = localStorage.getItem('ccw-recursive-query') !== 'false'; // default true
 
-// Code Index MCP provider (codexlens or ace)
+// Code Index MCP provider (codexlens, ace, or none)
 let codeIndexMcpProvider = 'codexlens';
 
+// ========== Helper Functions ==========
+/**
+ * Get the context-tools filename based on provider
+ */
+function getContextToolsFileName(provider) {
+  switch (provider) {
+    case 'ace':
+      return 'context-tools-ace.md';
+    case 'none':
+      return 'context-tools-none.md';
+    default:
+      return 'context-tools.md';
+  }
+}
+
 // ========== Initialization ==========
 function initCliStatus() {
   // Load all statuses in one call using aggregated endpoint
@@ -637,9 +652,17 @@ function renderCliStatus() {
                       onclick="setCodeIndexMcpProvider('ace')">
                 ACE
               </button>
+              <button class="code-mcp-btn px-3 py-1.5 text-xs font-medium rounded-md transition-all ${codeIndexMcpProvider === 'none' ? 'bg-primary text-primary-foreground shadow-sm' : 'text-muted-foreground hover:text-foreground'}"
+                      onclick="setCodeIndexMcpProvider('none')">
+                None
+              </button>
             </div>
           </div>
           <p class="cli-setting-desc">Code search provider (updates CLAUDE.md context-tools reference)</p>
+          <p class="cli-setting-desc text-xs text-muted-foreground mt-1">
+            <i data-lucide="file-text" class="w-3 h-3 inline-block mr-1"></i>
+            Current: <code class="bg-muted px-1 rounded">${getContextToolsFileName(codeIndexMcpProvider)}</code>
+          </p>
         </div>
       </div>
     </div>
@@ -775,7 +798,8 @@ async function setCodeIndexMcpProvider(provider) {
       if (window.claudeCliToolsConfig && window.claudeCliToolsConfig.settings) {
         window.claudeCliToolsConfig.settings.codeIndexMcp = provider;
       }
-      showRefreshToast(`Code Index MCP switched to ${provider === 'ace' ? 'ACE (Augment)' : 'CodexLens'}`, 'success');
+      const providerName = provider === 'ace' ? 'ACE (Augment)' : provider === 'none' ? 'None (Built-in only)' : 'CodexLens';
+      showRefreshToast(`Code Index MCP switched to ${providerName}`, 'success');
       // Re-render both CLI status and settings section
       if (typeof renderCliStatus === 'function') renderCliStatus();
       if (typeof renderCliSettingsSection === 'function') renderCliSettingsSection();

package/ccw/src/templates/dashboard-js/views/cli-manager.js

@@ -996,9 +996,14 @@ function renderCliSettingsSection() {
           '<select class="cli-setting-select" onchange="setCodeIndexMcpProvider(this.value)">' +
             '<option value="codexlens"' + (codeIndexMcpProvider === 'codexlens' ? ' selected' : '') + '>CodexLens</option>' +
             '<option value="ace"' + (codeIndexMcpProvider === 'ace' ? ' selected' : '') + '>ACE (Augment)</option>' +
+            '<option value="none"' + (codeIndexMcpProvider === 'none' ? ' selected' : '') + '>None (Built-in)</option>' +
           '</select>' +
         '</div>' +
         '<p class="cli-setting-desc">' + t('cli.codeIndexMcpDesc') + '</p>' +
+        '<p class="cli-setting-desc text-xs text-muted-foreground">' +
+          '<i data-lucide="file-text" class="w-3 h-3 inline-block mr-1"></i>' +
+          'Current: <code class="bg-muted px-1 rounded">' + getContextToolsFileName(codeIndexMcpProvider) + '</code>' +
+        '</p>' +
       '</div>' +
     '</div>';
 

package/ccw/src/templates/dashboard-js/views/history.js

@@ -69,8 +69,10 @@ async function renderCliHistoryView() {
           '</div>'
         : '';
 
+      // Normalize sourceDir: convert backslashes to forward slashes for safe onclick handling
+      var normalizedSourceDir = (exec.sourceDir || '').replace(/\\/g, '/');
       historyHtml += '<div class="history-item' + (isSelected ? ' history-item-selected' : '') + '" ' +
-        'onclick="' + (isMultiSelectMode ? 'toggleExecutionSelection(\'' + exec.id + '\')' : 'showExecutionDetail(\'' + exec.id + (exec.sourceDir ? '\',\'' + escapeHtml(exec.sourceDir) : '') + '\')') + '">' +
+        'onclick="' + (isMultiSelectMode ? 'toggleExecutionSelection(\'' + exec.id + '\')' : 'showExecutionDetail(\'' + exec.id + '\', \'' + normalizedSourceDir.replace(/'/g, "\\'") + '\')') + '">' +
         checkboxHtml +
         '<div class="history-item-main">' +
           '<div class="history-item-header">' +
@@ -87,14 +89,17 @@ async function renderCliHistoryView() {
           '<div class="history-item-meta">' +
             '<span class="history-time"><i data-lucide="clock" class="w-3 h-3"></i> ' + timeAgo + '</span>' +
             '<span class="history-duration"><i data-lucide="timer" class="w-3 h-3"></i> ' + duration + '</span>' +
-            '<span class="history-id"><i data-lucide="hash" class="w-3 h-3"></i> ' + exec.id.split('-')[0] + '</span>' +
+            '<span class="history-id" title="' + exec.id + '"><i data-lucide="hash" class="w-3 h-3"></i> ' + exec.id.substring(0, 13) + '...' + exec.id.split('-').pop() + '</span>' +
           '</div>' +
         '</div>' +
         '<div class="history-item-actions">' +
-          '<button class="btn-icon" onclick="event.stopPropagation(); showExecutionDetail(\'' + exec.id + '\')" title="View Details">' +
+          '<button class="btn-icon" onclick="event.stopPropagation(); copyExecutionId(\'' + exec.id + '\')" title="Copy ID">' +
+            '<i data-lucide="copy" class="w-4 h-4"></i>' +
+          '</button>' +
+          '<button class="btn-icon" onclick="event.stopPropagation(); showExecutionDetail(\'' + exec.id + '\', \'' + normalizedSourceDir.replace(/'/g, "\\'") + '\')" title="View Details">' +
             '<i data-lucide="eye" class="w-4 h-4"></i>' +
           '</button>' +
-          '<button class="btn-icon btn-danger" onclick="event.stopPropagation(); confirmDeleteExecution(\'' + exec.id + (exec.sourceDir ? '\',\'' + escapeHtml(exec.sourceDir) : '') + '\')" title="Delete">' +
+          '<button class="btn-icon btn-danger" onclick="event.stopPropagation(); confirmDeleteExecution(\'' + exec.id + '\', \'' + normalizedSourceDir.replace(/'/g, "\\'") + '\')" title="Delete">' +
             '<i data-lucide="trash-2" class="w-4 h-4"></i>' +
           '</button>' +
         '</div>' +
@@ -179,6 +184,16 @@ async function renderCliHistoryView() {
 }
 
 // ========== Actions ==========
+async function copyExecutionId(executionId) {
+  try {
+    await navigator.clipboard.writeText(executionId);
+    showRefreshToast('ID copied: ' + executionId, 'success');
+  } catch (err) {
+    console.error('Failed to copy ID:', err);
+    showRefreshToast('Failed to copy ID', 'error');
+  }
+}
+
 async function filterCliHistoryView(tool) {
   cliHistoryFilter = tool || null;
   await loadCliHistory();

package/ccw/src/tools/claude-cli-tools.ts

@@ -42,7 +42,7 @@ export interface ClaudeCliToolsConfig {
     nativeResume: boolean;
     recursiveQuery: boolean;
     cache: ClaudeCacheSettings;
-    codeIndexMcp: 'codexlens' | 'ace';  // Code Index MCP provider
+    codeIndexMcp: 'codexlens' | 'ace' | 'none';  // Code Index MCP provider
   };
 }
 
@@ -308,7 +308,7 @@ export function getClaudeCliToolsInfo(projectDir: string): {
  */
 export function updateCodeIndexMcp(
   projectDir: string,
-  provider: 'codexlens' | 'ace'
+  provider: 'codexlens' | 'ace' | 'none'
 ): { success: boolean; error?: string; config?: ClaudeCliToolsConfig } {
   try {
     // Update config
@@ -319,21 +319,28 @@ export function updateCodeIndexMcp(
     // Only update global CLAUDE.md (consistent with Chinese response / Windows platform)
     const globalClaudeMdPath = path.join(os.homedir(), '.claude', 'CLAUDE.md');
 
+    // Define patterns for all formats
+    const codexlensPattern = /@~\/\.claude\/workflows\/context-tools\.md/g;
+    const acePattern = /@~\/\.claude\/workflows\/context-tools-ace\.md/g;
+    const nonePattern = /@~\/\.claude\/workflows\/context-tools-none\.md/g;
+
+    // Determine target file based on provider
+    const targetFile = provider === 'ace'
+      ? '@~/.claude/workflows/context-tools-ace.md'
+      : provider === 'none'
+        ? '@~/.claude/workflows/context-tools-none.md'
+        : '@~/.claude/workflows/context-tools.md';
+
     if (!fs.existsSync(globalClaudeMdPath)) {
       // If global CLAUDE.md doesn't exist, check project-level
       const projectClaudeMdPath = path.join(projectDir, '.claude', 'CLAUDE.md');
       if (fs.existsSync(projectClaudeMdPath)) {
         let content = fs.readFileSync(projectClaudeMdPath, 'utf-8');
 
-        // Define patterns for both formats
-        const codexlensPattern = /@~\/\.claude\/workflows\/context-tools\.md/g;
-        const acePattern = /@~\/\.claude\/workflows\/context-tools-ace\.md/g;
-
-        if (provider === 'ace') {
-          content = content.replace(codexlensPattern, '@~/.claude/workflows/context-tools-ace.md');
-        } else {
-          content = content.replace(acePattern, '@~/.claude/workflows/context-tools.md');
-        }
+        // Replace any existing pattern with the target
+        content = content.replace(codexlensPattern, targetFile);
+        content = content.replace(acePattern, targetFile);
+        content = content.replace(nonePattern, targetFile);
 
         fs.writeFileSync(projectClaudeMdPath, content, 'utf-8');
         console.log(`[claude-cli-tools] Updated project CLAUDE.md to use ${provider} (no global CLAUDE.md found)`);
@@ -342,14 +349,10 @@ export function updateCodeIndexMcp(
       // Update global CLAUDE.md (primary target)
       let content = fs.readFileSync(globalClaudeMdPath, 'utf-8');
 
-      const codexlensPattern = /@~\/\.claude\/workflows\/context-tools\.md/g;
-      const acePattern = /@~\/\.claude\/workflows\/context-tools-ace\.md/g;
-
-      if (provider === 'ace') {
-        content = content.replace(codexlensPattern, '@~/.claude/workflows/context-tools-ace.md');
-      } else {
-        content = content.replace(acePattern, '@~/.claude/workflows/context-tools.md');
-      }
+      // Replace any existing pattern with the target
+      content = content.replace(codexlensPattern, targetFile);
+      content = content.replace(acePattern, targetFile);
+      content = content.replace(nonePattern, targetFile);
 
       fs.writeFileSync(globalClaudeMdPath, content, 'utf-8');
       console.log(`[claude-cli-tools] Updated global CLAUDE.md to use ${provider}`);
@@ -365,7 +368,21 @@ export function updateCodeIndexMcp(
 /**
  * Get current Code Index MCP provider
  */
-export function getCodeIndexMcp(projectDir: string): 'codexlens' | 'ace' {
+export function getCodeIndexMcp(projectDir: string): 'codexlens' | 'ace' | 'none' {
   const config = loadClaudeCliTools(projectDir);
   return config.settings.codeIndexMcp || 'codexlens';
 }
+
+/**
+ * Get the context-tools file path based on provider
+ */
+export function getContextToolsPath(provider: 'codexlens' | 'ace' | 'none'): string {
+  switch (provider) {
+    case 'ace':
+      return 'context-tools-ace.md';
+    case 'none':
+      return 'context-tools-none.md';
+    default:
+      return 'context-tools.md';
+  }
+}

package/ccw/src/tools/smart-search.ts

@@ -24,6 +24,39 @@ import {
 import type { ProgressInfo } from './codex-lens.js';
 import { getProjectRoot } from '../utils/path-validator.js';
 
+// Timing utilities for performance analysis
+const TIMING_ENABLED = process.env.SMART_SEARCH_TIMING === '1' || process.env.DEBUG?.includes('timing');
+
+interface TimingData {
+  [key: string]: number;
+}
+
+function createTimer(): { mark: (name: string) => void; getTimings: () => TimingData; log: () => void } {
+  const startTime = performance.now();
+  const marks: { name: string; time: number }[] = [];
+  let lastMark = startTime;
+
+  return {
+    mark(name: string) {
+      const now = performance.now();
+      marks.push({ name, time: now - lastMark });
+      lastMark = now;
+    },
+    getTimings(): TimingData {
+      const timings: TimingData = {};
+      marks.forEach(m => { timings[m.name] = Math.round(m.time * 100) / 100; });
+      timings['_total'] = Math.round((performance.now() - startTime) * 100) / 100;
+      return timings;
+    },
+    log() {
+      if (TIMING_ENABLED) {
+        const timings = this.getTimings();
+        console.error(`[TIMING] smart-search: ${JSON.stringify(timings)}`);
+      }
+    }
+  };
+}
+
 // Define Zod schema for validation
 const ParamsSchema = z.object({
   // Action: search (content), find_files (path/name pattern), init, status
@@ -48,6 +81,9 @@ const ParamsSchema = z.object({
   regex: z.boolean().default(true),            // Use regex pattern matching (default: enabled)
   caseSensitive: z.boolean().default(true),    // Case sensitivity (default: case-sensitive)
   tokenize: z.boolean().default(true),         // Tokenize multi-word queries for OR matching (default: enabled)
+  // File type filtering
+  excludeExtensions: z.array(z.string()).optional().describe('File extensions to exclude from results (e.g., ["md", "txt"])'),
+  codeOnly: z.boolean().default(false).describe('Only return code files (excludes md, txt, json, yaml, xml, etc.)'),
   // Fuzzy matching is implicit in hybrid mode (RRF fusion)
 });
 
@@ -254,6 +290,8 @@ interface SearchMetadata {
   tokenized?: boolean; // Whether tokenization was applied
   // Pagination metadata
   pagination?: PaginationInfo;
+  // Performance timing data (when SMART_SEARCH_TIMING=1 or DEBUG includes 'timing')
+  timing?: TimingData;
   // Init action specific
   action?: string;
   path?: string;
@@ -1086,7 +1124,8 @@ async function executeCodexLensExactMode(params: Params): Promise<SearchResult>
  * Requires index with embeddings
  */
 async function executeHybridMode(params: Params): Promise<SearchResult> {
-  const { query, path = '.', maxResults = 5, extraFilesCount = 10, maxContentLength = 200, enrich = false } = params;
+  const timer = createTimer();
+  const { query, path = '.', maxResults = 5, extraFilesCount = 10, maxContentLength = 200, enrich = false, excludeExtensions, codeOnly = false } = params;
 
   if (!query) {
     return {
@@ -1097,6 +1136,7 @@ async function executeHybridMode(params: Params): Promise<SearchResult> {
 
   // Check CodexLens availability
   const readyStatus = await ensureCodexLensReady();
+  timer.mark('codexlens_ready_check');
   if (!readyStatus.ready) {
     return {
       success: false,
@@ -1106,6 +1146,7 @@ async function executeHybridMode(params: Params): Promise<SearchResult> {
 
   // Check index status
   const indexStatus = await checkIndexStatus(path);
+  timer.mark('index_status_check');
 
   // Request more results to support split (full content + extra files)
   const totalToFetch = maxResults + extraFilesCount;
@@ -1114,8 +1155,10 @@ async function executeHybridMode(params: Params): Promise<SearchResult> {
     args.push('--enrich');
   }
   const result = await executeCodexLens(args, { cwd: path });
+  timer.mark('codexlens_search');
 
   if (!result.success) {
+    timer.log();
     return {
       success: false,
       error: result.error,
@@ -1150,6 +1193,7 @@ async function executeHybridMode(params: Params): Promise<SearchResult> {
         symbol: item.symbol || null,
       };
     });
+    timer.mark('parse_results');
 
     initialCount = allResults.length;
 
@@ -1159,14 +1203,15 @@ async function executeHybridMode(params: Params): Promise<SearchResult> {
     allResults = baselineResult.filteredResults;
     baselineInfo = baselineResult.baselineInfo;
 
-    // 1. Filter noisy files (coverage, node_modules, etc.)
-    allResults = filterNoisyFiles(allResults);
+    // 1. Filter noisy files (coverage, node_modules, etc.) and excluded extensions
+    allResults = filterNoisyFiles(allResults, { excludeExtensions, codeOnly });
     // 2. Boost results containing query keywords
     allResults = applyKeywordBoosting(allResults, query);
     // 3. Enforce score diversity (penalize identical scores)
     allResults = enforceScoreDiversity(allResults);
     // 4. Re-sort by adjusted scores
     allResults.sort((a, b) => b.score - a.score);
+    timer.mark('post_processing');
   } catch {
     return {
       success: true,
@@ -1184,6 +1229,7 @@ async function executeHybridMode(params: Params): Promise<SearchResult> {
 
   // Split results: first N with full content, rest as file paths only
   const { results, extra_files } = splitResultsWithExtraFiles(allResults, maxResults, extraFilesCount);
+  timer.mark('split_results');
 
   // Build metadata with baseline info if detected
   let note = 'Hybrid mode uses RRF fusion (exact + fuzzy + vector) for best results';
@@ -1191,6 +1237,10 @@ async function executeHybridMode(params: Params): Promise<SearchResult> {
     note += ` | Filtered ${initialCount - allResults.length} hot-spot results with baseline score ~${baselineInfo.score.toFixed(4)}`;
   }
 
+  // Log timing data
+  timer.log();
+  const timings = timer.getTimings();
+
   return {
     success: true,
     results,
@@ -1203,22 +1253,82 @@ async function executeHybridMode(params: Params): Promise<SearchResult> {
       note,
       warning: indexStatus.warning,
       suggested_weights: getRRFWeights(query),
+      timing: TIMING_ENABLED ? timings : undefined,
     },
   };
 }
 
-const RRF_WEIGHTS = {
-  code: { exact: 0.7, fuzzy: 0.2, vector: 0.1 },
-  natural: { exact: 0.4, fuzzy: 0.2, vector: 0.4 },
-  default: { exact: 0.5, fuzzy: 0.2, vector: 0.3 },
-};
+/**
+ * Query intent used to adapt RRF weights (Python parity).
+ *
+ * Keep this logic aligned with CodexLens Python hybrid search:
+ * `codex-lens/src/codexlens/search/hybrid_search.py`
+ */
+export type QueryIntent = 'keyword' | 'semantic' | 'mixed';
+
+// Python default: vector 60%, exact 30%, fuzzy 10%
+const DEFAULT_RRF_WEIGHTS = {
+  exact: 0.3,
+  fuzzy: 0.1,
+  vector: 0.6,
+} as const;
+
+function normalizeWeights(weights: Record<string, number>): Record<string, number> {
+  const sum = Object.values(weights).reduce((acc, v) => acc + v, 0);
+  if (!Number.isFinite(sum) || sum <= 0) return { ...weights };
+  return Object.fromEntries(Object.entries(weights).map(([k, v]) => [k, v / sum]));
+}
+
+/**
+ * Detect query intent using the same heuristic signals as Python:
+ * - Code patterns: `.`, `::`, `->`, CamelCase, snake_case, common code keywords
+ * - Natural language patterns: >5 words, question marks, interrogatives, common verbs
+ */
+export function detectQueryIntent(query: string): QueryIntent {
+  const trimmed = query.trim();
+  if (!trimmed) return 'mixed';
+
+  const lower = trimmed.toLowerCase();
+  const wordCount = trimmed.split(/\s+/).filter(Boolean).length;
+
+  const hasCodeSignals =
+    /(::|->|\.)/.test(trimmed) ||
+    /[A-Z][a-z]+[A-Z]/.test(trimmed) ||
+    /\b\w+_\w+\b/.test(trimmed) ||
+    /\b(def|class|function|const|let|var|import|from|return|async|await|interface|type)\b/i.test(lower);
+
+  const hasNaturalSignals =
+    wordCount > 5 ||
+    /\?/.test(trimmed) ||
+    /\b(how|what|why|when|where)\b/i.test(trimmed) ||
+    /\b(handle|explain|fix|implement|create|build|use|find|search|convert|parse|generate|support)\b/i.test(trimmed);
+
+  if (hasCodeSignals && hasNaturalSignals) return 'mixed';
+  if (hasCodeSignals) return 'keyword';
+  if (hasNaturalSignals) return 'semantic';
+  return 'mixed';
+}
+
+/**
+ * Intent → weights mapping (Python parity).
+ * - keyword: exact-heavy
+ * - semantic: vector-heavy
+ * - mixed: keep defaults
+ */
+export function adjustWeightsByIntent(
+  intent: QueryIntent,
+  baseWeights: Record<string, number>,
+): Record<string, number> {
+  if (intent === 'keyword') return normalizeWeights({ exact: 0.5, fuzzy: 0.1, vector: 0.4 });
+  if (intent === 'semantic') return normalizeWeights({ exact: 0.2, fuzzy: 0.1, vector: 0.7 });
+  return normalizeWeights({ ...baseWeights });
+}
 
-function getRRFWeights(query: string): Record<string, number> {
-  const isCode = looksLikeCodeQuery(query);
-  const isNatural = detectNaturalLanguage(query);
-  if (isCode) return RRF_WEIGHTS.code;
-  if (isNatural) return RRF_WEIGHTS.natural;
-  return RRF_WEIGHTS.default;
+export function getRRFWeights(
+  query: string,
+  baseWeights: Record<string, number> = DEFAULT_RRF_WEIGHTS,
+): Record<string, number> {
+  return adjustWeightsByIntent(detectQueryIntent(query), baseWeights);
 }
 
 /**
@@ -1231,7 +1341,29 @@ const FILE_EXCLUDE_REGEXES = [...FILTER_CONFIG.exclude_files].map(pattern =>
   new RegExp('^' + pattern.replace(/[.*+?^${}()|[\]\\]/g, '\\$&').replace(/\\\*/g, '.*') + '$')
 );
 
-function filterNoisyFiles(results: SemanticMatch[]): SemanticMatch[] {
+// Non-code file extensions (for codeOnly filter)
+const NON_CODE_EXTENSIONS = new Set([
+  'md', 'txt', 'json', 'yaml', 'yml', 'xml', 'csv', 'log',
+  'ini', 'cfg', 'conf', 'toml', 'env', 'properties',
+  'html', 'htm', 'svg', 'png', 'jpg', 'jpeg', 'gif', 'ico', 'webp',
+  'pdf', 'doc', 'docx', 'xls', 'xlsx', 'ppt', 'pptx',
+  'lock', 'sum', 'mod',
+]);
+
+interface FilterOptions {
+  excludeExtensions?: string[];
+  codeOnly?: boolean;
+}
+
+function filterNoisyFiles(results: SemanticMatch[], options: FilterOptions = {}): SemanticMatch[] {
+  const { excludeExtensions = [], codeOnly = false } = options;
+
+  // Build extension filter set
+  const excludedExtSet = new Set(excludeExtensions.map(ext => ext.toLowerCase().replace(/^\./, '')));
+  if (codeOnly) {
+    NON_CODE_EXTENSIONS.forEach(ext => excludedExtSet.add(ext));
+  }
+
   return results.filter(r => {
     const filePath = r.file || '';
     if (!filePath) return true;
@@ -1249,6 +1381,14 @@ function filterNoisyFiles(results: SemanticMatch[]): SemanticMatch[] {
       return false;
     }
 
+    // Extension filter check
+    if (excludedExtSet.size > 0) {
+      const ext = filename.split('.').pop()?.toLowerCase() || '';
+      if (excludedExtSet.has(ext)) {
+        return false;
+      }
+    }
+
     return true;
   });
 }
@@ -1396,10 +1536,11 @@ function filterDominantBaselineScores(
  */
 function applyRRFFusion(
   resultsMap: Map<string, any[]>,
-  weights: Record<string, number>,
+  weightsOrQuery: Record<string, number> | string,
   limit: number,
   k: number = 60,
 ): any[] {
+  const weights = typeof weightsOrQuery === 'string' ? getRRFWeights(weightsOrQuery) : weightsOrQuery;
   const pathScores = new Map<string, { score: number; result: any; sources: string[] }>();
 
   resultsMap.forEach((results, source) => {

package/codex-lens/src/codexlens/config.py

@@ -103,6 +103,11 @@ class Config:
     # Indexing/search optimizations
     global_symbol_index_enabled: bool = True  # Enable project-wide symbol index fast path
 
+    # Optional search reranking (disabled by default)
+    enable_reranking: bool = False
+    reranking_top_k: int = 50
+    symbol_boost_factor: float = 1.5
+
     # Multi-endpoint configuration for litellm backend
     embedding_endpoints: List[Dict[str, Any]] = field(default_factory=list)
     # List of endpoint configs: [{"model": "...", "api_key": "...", "api_base": "...", "weight": 1.0}]