qfai 1.0.0 → 1.0.1

package/dist/index.d.cts

@@ -9,6 +9,8 @@ type TestFileScan = {
     globs: string[];
     excludeGlobs: string[];
     matchedFileCount: number;
+    truncated: boolean;
+    limit: number;
 };
 
 type IssueSeverity = "info" | "warning" | "error";
@@ -157,7 +159,10 @@ type ReportData = {
     issues: Issue[];
 };
 declare function createReportData(root: string, validation?: ValidationResult, configResult?: ConfigLoadResult): Promise<ReportData>;
-declare function formatReportMarkdown(data: ReportData): string;
+type ReportMarkdownOptions = {
+    baseUrl?: string;
+};
+declare function formatReportMarkdown(data: ReportData, options?: ReportMarkdownOptions): string;
 declare function formatReportJson(data: ReportData): string;
 
 declare function validateProject(root: string, configResult?: ConfigLoadResult): Promise<ValidationResult>;

package/dist/index.d.ts

@@ -9,6 +9,8 @@ type TestFileScan = {
     globs: string[];
     excludeGlobs: string[];
     matchedFileCount: number;
+    truncated: boolean;
+    limit: number;
 };
 
 type IssueSeverity = "info" | "warning" | "error";
@@ -157,7 +159,10 @@ type ReportData = {
     issues: Issue[];
 };
 declare function createReportData(root: string, validation?: ValidationResult, configResult?: ConfigLoadResult): Promise<ReportData>;
-declare function formatReportMarkdown(data: ReportData): string;
+type ReportMarkdownOptions = {
+    baseUrl?: string;
+};
+declare function formatReportMarkdown(data: ReportData, options?: ReportMarkdownOptions): string;
 declare function formatReportJson(data: ReportData): string;
 
 declare function validateProject(root: string, configResult?: ConfigLoadResult): Promise<ValidationResult>;

package/dist/index.mjs

@@ -474,6 +474,7 @@ var DEFAULT_IGNORE_DIRS = /* @__PURE__ */ new Set([
   "tmp",
   ".mcp-tools"
 ]);
+var DEFAULT_GLOB_FILE_LIMIT = 2e4;
 async function collectFiles(root, options = {}) {
   const entries = [];
   if (!await exists2(root)) {
@@ -488,16 +489,29 @@ async function collectFiles(root, options = {}) {
   return entries;
 }
 async function collectFilesByGlobs(root, options) {
+  const limit = normalizeLimit(options.limit);
   if (options.globs.length === 0) {
-    return [];
+    return { files: [], truncated: false, matchedFileCount: 0, limit };
   }
-  return fg(options.globs, {
+  const stream = fg.stream(options.globs, {
     cwd: root,
     ignore: options.ignore ?? [],
     onlyFiles: true,
     absolute: true,
     unique: true
   });
+  const files = [];
+  let truncated = false;
+  for await (const entry of stream) {
+    if (files.length >= limit) {
+      truncated = true;
+      destroyStream(stream);
+      break;
+    }
+    files.push(String(entry));
+  }
+  const matchedFileCount = files.length;
+  return { files, truncated, matchedFileCount, limit };
 }
 async function walk(base, current, ignoreDirs, extensions, out) {
   const items = await readdir(current, { withFileTypes: true });
@@ -529,6 +543,25 @@ async function exists2(target) {
     return false;
   }
 }
+function normalizeLimit(value) {
+  if (typeof value !== "number" || Number.isNaN(value)) {
+    return DEFAULT_GLOB_FILE_LIMIT;
+  }
+  const flooredValue = Math.floor(value);
+  if (flooredValue <= 0) {
+    return DEFAULT_GLOB_FILE_LIMIT;
+  }
+  return flooredValue;
+}
+function destroyStream(stream) {
+  if (!stream || typeof stream !== "object") {
+    return;
+  }
+  const record2 = stream;
+  if (typeof record2.destroy === "function") {
+    record2.destroy();
+  }
+}
 
 // src/core/specLayout.ts
 import { readdir as readdir2 } from "fs/promises";
@@ -1094,15 +1127,18 @@ async function collectScTestReferences(root, globs, excludeGlobs) {
       scan: {
         globs: normalizedGlobs,
         excludeGlobs: mergedExcludeGlobs,
-        matchedFileCount: 0
+        matchedFileCount: 0,
+        truncated: false,
+        limit: DEFAULT_GLOB_FILE_LIMIT
       }
     };
   }
-  let files = [];
+  let scanResult;
   try {
-    files = await collectFilesByGlobs(root, {
+    scanResult = await collectFilesByGlobs(root, {
       globs: normalizedGlobs,
-      ignore: mergedExcludeGlobs
+      ignore: mergedExcludeGlobs,
+      limit: DEFAULT_GLOB_FILE_LIMIT
     });
   } catch (error) {
     return {
@@ -1110,13 +1146,15 @@ async function collectScTestReferences(root, globs, excludeGlobs) {
       scan: {
         globs: normalizedGlobs,
         excludeGlobs: mergedExcludeGlobs,
-        matchedFileCount: 0
+        matchedFileCount: 0,
+        truncated: false,
+        limit: DEFAULT_GLOB_FILE_LIMIT
       },
       error: formatError3(error)
     };
   }
   const normalizedFiles = Array.from(
-    new Set(files.map((file) => path6.normalize(file)))
+    new Set(scanResult.files.map((file) => path6.normalize(file)))
   );
   for (const file of normalizedFiles) {
     const text = await readFile3(file, "utf-8");
@@ -1135,7 +1173,9 @@ async function collectScTestReferences(root, globs, excludeGlobs) {
     scan: {
       globs: normalizedGlobs,
       excludeGlobs: mergedExcludeGlobs,
-      matchedFileCount: normalizedFiles.length
+      matchedFileCount: scanResult.matchedFileCount,
+      truncated: scanResult.truncated,
+      limit: scanResult.limit
     }
   };
 }
@@ -1180,8 +1220,8 @@ import { readFile as readFile4 } from "fs/promises";
 import path7 from "path";
 import { fileURLToPath } from "url";
 async function resolveToolVersion() {
-  if ("1.0.0".length > 0) {
-    return "1.0.0";
+  if ("1.0.1".length > 0) {
+    return "1.0.1";
   }
   try {
     const packagePath = resolvePackageJsonPath();
@@ -2853,13 +2893,14 @@ async function createReportData(root, validation, configResult) {
     issues: normalizedValidation.issues
   };
 }
-function formatReportMarkdown(data) {
+function formatReportMarkdown(data, options = {}) {
   const lines = [];
+  const baseUrl = normalizeBaseUrl(options.baseUrl);
   lines.push("# QFAI Report");
   lines.push("");
   lines.push(`- \u751F\u6210\u65E5\u6642: ${data.generatedAt}`);
-  lines.push(`- \u30EB\u30FC\u30C8: ${data.root}`);
-  lines.push(`- \u8A2D\u5B9A: ${data.configPath}`);
+  lines.push(`- \u30EB\u30FC\u30C8: ${formatPathLink(data.root, baseUrl)}`);
+  lines.push(`- \u8A2D\u5B9A: ${formatPathLink(data.configPath, baseUrl)}`);
   lines.push(`- \u7248: ${data.version}`);
   lines.push("");
   const severityOrder = {
@@ -2998,8 +3039,7 @@ function formatReportMarkdown(data) {
         `#### ${item.severity.toUpperCase()} [${item.code}] ${item.message}`
       );
       if (item.file) {
-        const loc = item.loc?.line ? `:${item.loc.line}` : "";
-        out.push(`- file: ${item.file}${loc}`);
+        out.push(`- file: ${formatPathWithLine(item.file, item.loc, baseUrl)}`);
       }
       if (item.rule) {
         out.push(`- rule: ${item.rule}`);
@@ -3125,6 +3165,11 @@ function formatReportMarkdown(data) {
   lines.push(
     `- testFileCount: ${data.traceability.testFiles.matchedFileCount}`
   );
+  if (data.traceability.testFiles.truncated) {
+    lines.push(
+      `- testFileTruncated: true (limit=${data.traceability.testFiles.limit})`
+    );
+  }
   if (data.traceability.sc.missingIds.length === 0) {
     lines.push("- missingIds: (none)");
   } else {
@@ -3134,7 +3179,8 @@ function formatReportMarkdown(data) {
       if (files.length === 0) {
         return id;
       }
-      return `${id} (${files.join(", ")})`;
+      const formattedFiles = files.map((file) => formatPathLink(file, baseUrl));
+      return `${id} (${formattedFiles.join(", ")})`;
     });
     lines.push(`- missingIds: ${missingWithSources.join(", ")}`);
   }
@@ -3151,7 +3197,8 @@ function formatReportMarkdown(data) {
       if (refs.length === 0) {
         lines.push(`- ${scId}: (none)`);
       } else {
-        lines.push(`- ${scId}: ${refs.join(", ")}`);
+        const formattedRefs = refs.map((ref) => formatPathLink(ref, baseUrl));
+        lines.push(`- ${scId}: ${formattedRefs.join(", ")}`);
       }
     }
   }
@@ -3166,8 +3213,9 @@ function formatReportMarkdown(data) {
   } else {
     for (const item of specScIssues) {
       const location = item.file ?? "(unknown)";
+      const formattedLocation = location === "(unknown)" ? location : formatPathLink(location, baseUrl);
       const refs = item.refs && item.refs.length > 0 ? item.refs.join(", ") : item.message;
-      lines.push(`- ${location}: ${refs}`);
+      lines.push(`- ${formattedLocation}: ${refs}`);
     }
   }
   lines.push("");
@@ -3179,7 +3227,7 @@ function formatReportMarkdown(data) {
   } else {
     for (const spot of hotspots) {
       lines.push(
-        `- ${spot.file}: total ${spot.total} (error ${spot.error} / warning ${spot.warning} / info ${spot.info})`
+        `- ${formatPathLink(spot.file, baseUrl)}: total ${spot.total} (error ${spot.error} / warning ${spot.warning} / info ${spot.info})`
       );
     }
   }
@@ -3336,6 +3384,41 @@ function formatMarkdownTable(headers, rows) {
   const separator = `| ${widths.map((width) => "-".repeat(width)).join(" | ")} |`;
   return [formatRow(headers), separator, ...rows.map(formatRow)];
 }
+function normalizeBaseUrl(value) {
+  if (!value) {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  if (!trimmed) {
+    return void 0;
+  }
+  return trimmed.replace(/\/+$/, "");
+}
+function formatPathLink(value, baseUrl) {
+  if (!baseUrl) {
+    return value;
+  }
+  if (value === ".") {
+    return `[${value}](${baseUrl})`;
+  }
+  const encoded = encodePathForUrl(value);
+  if (!encoded) {
+    return value;
+  }
+  return `[${value}](${baseUrl}/${encoded})`;
+}
+function formatPathWithLine(value, loc, baseUrl) {
+  const link = formatPathLink(value, baseUrl);
+  const line = loc?.line ? `:${loc.line}` : "";
+  return `${link}${line}`;
+}
+function encodePathForUrl(value) {
+  const normalized = value.replace(/\\/g, "/");
+  if (normalized === ".") {
+    return "";
+  }
+  return normalized.split("/").map((segment) => encodeURIComponent(segment)).join("/");
+}
 function toSortedArray2(values) {
   return Array.from(values).sort((a, b) => a.localeCompare(b));
 }