deterministic profiler output and search efficiency

- addresses latest feedback for PR #119 ;
- profile-codeql-query-from-logs: remove non-deterministic `Generated:`
  timestamp from detail file header to ensure reproducible output for
  integration test fixtures ;
- search-ql-code: early-exit file processing once maxResults matches are
  collected; subsequent files are scanned cheaply for totalMatches count
  only, avoiding large array allocations and context extraction ;

Author: data-douser

client/integration-tests/primitives/tools/profile_codeql_query_from_logs/multi_query_raw_log/after/query-evaluation-detail.txt

@@ -1,5 +1,5 @@
 # CodeQL Evaluator Profile — Predicate Detail
-# Generated: 2026-03-10T14:57:38.405Z
+# Generated: 2026-03-10T18:36:19.438Z
 # Log format: raw
 # CodeQL version: 2.23.1
 # Use read_file with line ranges from the JSON response to access individual predicates.

client/integration-tests/primitives/tools/profile_codeql_query_from_logs/single_query_raw_log/after/query-evaluation-detail.txt

@@ -1,5 +1,5 @@
 # CodeQL Evaluator Profile — Predicate Detail
-# Generated: 2026-03-10T14:57:38.415Z
+# Generated: 2026-03-10T18:36:19.453Z
 # Log format: raw
 # CodeQL version: 2.23.1
 # Use read_file with line ranges from the JSON response to access individual predicates.

server/dist/codeql-development-mcp-server.js

@@ -61796,7 +61796,6 @@ function buildDetailFile(profile, topN) {
   const lines = [];
   const lineIndex = /* @__PURE__ */ new Map();
   lines.push("# CodeQL Evaluator Profile \u2014 Predicate Detail");
-  lines.push(`# Generated: ${(/* @__PURE__ */ new Date()).toISOString()}`);
   lines.push(`# Log format: ${profile.logFormat}`);
   if (profile.codeqlVersion) {
     lines.push(`# CodeQL version: ${profile.codeqlVersion}`);
@@ -63055,14 +63054,32 @@ async function searchQlCode(params) {
   const filesToSearch = collectFiles(paths, includeExtensions, fileCount);
   const allMatches = [];
   let totalMatches = 0;
+  let collectedEnough = false;
   for (const file of filesToSearch) {
+    if (collectedEnough) {
+      try {
+        const st = lstatSync(file);
+        if (!st.isFile()) continue;
+        const content = st.size <= MAX_FILE_SIZE_BYTES ? readFileSync9(file, "utf-8") : null;
+        if (content) {
+          for (const line of content.replace(/\r\n/g, "\n").split("\n")) {
+            if (regex.test(line)) totalMatches++;
+          }
+        }
+      } catch {
+      }
+      continue;
+    }
     const fileMatches = await searchFile(file, regex, contextLines);
     totalMatches += fileMatches.length;
     for (const m of fileMatches) {
       if (allMatches.length < maxResults) {
         allMatches.push(m);
       }
     }
+    if (allMatches.length >= maxResults) {
+      collectedEnough = true;
+    }
   }
   return {
     results: allMatches,

server/dist/codeql-development-mcp-server.js.map

@@ -108,7 +108,6 @@ function buildDetailFile(
   const lineIndex = new Map<string, { start: number; end: number }>();
 
   lines.push('# CodeQL Evaluator Profile — Predicate Detail');
-  lines.push(`# Generated: ${new Date().toISOString()}`);
   lines.push(`# Log format: ${profile.logFormat}`);
   if (profile.codeqlVersion) {
     lines.push(`# CodeQL version: ${profile.codeqlVersion}`);

server/src/tools/codeql/profile-codeql-query-from-logs.ts

@@ -288,8 +288,29 @@ export async function searchQlCode(params: {
 
   const allMatches: SearchMatch[] = [];
   let totalMatches = 0;
+  let collectedEnough = false;
 
   for (const file of filesToSearch) {
+    if (collectedEnough) {
+      // Still need totalMatches count but skip storing results.
+      // For small files, just count line matches without allocating.
+      try {
+        const st = lstatSync(file);
+        if (!st.isFile()) continue;
+        const content = st.size <= MAX_FILE_SIZE_BYTES
+          ? readFileSync(file, 'utf-8')
+          : null;
+        if (content) {
+          for (const line of content.replace(/\r\n/g, '\n').split('\n')) {
+            if (regex.test(line)) totalMatches++;
+          }
+        }
+      } catch {
+        // skip
+      }
+      continue;
+    }
+
     const fileMatches = await searchFile(file, regex, contextLines);
     totalMatches += fileMatches.length;
 
@@ -298,6 +319,10 @@ export async function searchQlCode(params: {
         allMatches.push(m);
       }
     }
+
+    if (allMatches.length >= maxResults) {
+      collectedEnough = true;
+    }
   }
 
   return {