qfai 1.0.0 → 1.0.1

package/dist/cli/index.mjs

@@ -16,6 +16,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 exists(root)) {
@@ -30,16 +31,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 });
@@ -71,6 +85,25 @@ async function exists(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/cli/commands/analyze.ts
 async function runAnalyze(options) {
@@ -890,15 +923,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 (error2) {
     return {
@@ -906,13 +942,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(error2)
     };
   }
   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");
@@ -931,7 +969,9 @@ async function collectScTestReferences(root, globs, excludeGlobs) {
     scan: {
       globs: normalizedGlobs,
       excludeGlobs: mergedExcludeGlobs,
-      matchedFileCount: normalizedFiles.length
+      matchedFileCount: scanResult.matchedFileCount,
+      truncated: scanResult.truncated,
+      limit: scanResult.limit
     }
   };
 }
@@ -1101,8 +1141,8 @@ import { readFile as readFile5 } from "fs/promises";
 import path9 from "path";
 import { fileURLToPath as fileURLToPath2 } 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();
@@ -1313,19 +1353,27 @@ async function createDoctorData(options) {
     ...config.validation.traceability.testFileExcludeGlobs
   ]);
   try {
-    const matched = globs.length === 0 ? [] : await collectFilesByGlobs(root, { globs, ignore: exclude });
-    const matchedCount = matched.length;
-    const severity = globs.length === 0 ? "warning" : scenarioFiles.length > 0 && config.validation.traceability.scMustHaveTest && matchedCount === 0 ? "warning" : "ok";
+    const scanResult = globs.length === 0 ? {
+      files: [],
+      truncated: false,
+      matchedFileCount: 0,
+      limit: DEFAULT_GLOB_FILE_LIMIT
+    } : await collectFilesByGlobs(root, { globs, ignore: exclude });
+    const matchedCount = scanResult.matchedFileCount;
+    const truncated = scanResult.truncated;
+    const severity = globs.length === 0 ? "warning" : truncated ? "warning" : scenarioFiles.length > 0 && config.validation.traceability.scMustHaveTest && matchedCount === 0 ? "warning" : "ok";
     addCheck(checks, {
       id: "traceability.testGlobs",
       severity,
       title: "Test file globs",
-      message: globs.length === 0 ? "testFileGlobs is empty (SC\u2192Test cannot be verified)" : `matchedFileCount=${matchedCount}`,
+      message: globs.length === 0 ? "testFileGlobs is empty (SC\u2192Test cannot be verified)" : truncated ? `fileCount=${matchedCount} (truncated, limit=${scanResult.limit})` : `fileCount=${matchedCount}`,
       details: {
         globs,
         excludeGlobs: exclude,
         scenarioFiles: scenarioFiles.length,
-        scMustHaveTest: config.validation.traceability.scMustHaveTest
+        scMustHaveTest: config.validation.traceability.scMustHaveTest,
+        truncated,
+        limit: scanResult.limit
       }
     });
   } catch (error2) {
@@ -1334,7 +1382,12 @@ async function createDoctorData(options) {
       severity: "error",
       title: "Test file globs",
       message: "Glob scan failed (invalid pattern or filesystem error)",
-      details: { globs, excludeGlobs: exclude, error: String(error2) }
+      details: {
+        globs,
+        excludeGlobs: exclude,
+        limit: DEFAULT_GLOB_FILE_LIMIT,
+        error: String(error2)
+      }
     });
   }
   return {
@@ -1368,8 +1421,10 @@ async function buildOutDirCollisionCheck(root) {
         (collisionRoot) => toRelativePath(result.monorepoRoot, collisionRoot)
       ).sort((a, b) => a.localeCompare(b))
     })).sort((a, b) => a.outDir.localeCompare(b.outDir));
-    const severity = collisions.length > 0 ? "warning" : "ok";
-    const message = collisions.length > 0 ? `outDir collision detected (count=${collisions.length})` : `outDir collision not detected (configs=${configRoots.length})`;
+    const truncated = result.scan.truncated;
+    const severity = collisions.length > 0 || truncated ? "warning" : "ok";
+    const messageBase = collisions.length > 0 ? `outDir collision detected (count=${collisions.length})` : `outDir collision not detected (configs=${configRoots.length})`;
+    const message = truncated ? `${messageBase}; scan truncated (collected=${result.scan.matchedFileCount}, limit=${result.scan.limit})` : messageBase;
     return {
       id: "output.outDirCollision",
       severity,
@@ -1378,7 +1433,8 @@ async function buildOutDirCollisionCheck(root) {
       details: {
         monorepoRoot: relativeRoot,
         configRoots,
-        collisions
+        collisions,
+        scan: result.scan
       }
     };
   } catch (error2) {
@@ -1393,10 +1449,11 @@ async function buildOutDirCollisionCheck(root) {
 }
 async function detectOutDirCollisions(root) {
   const monorepoRoot = await findMonorepoRoot(root);
-  const configPaths = await collectFilesByGlobs(monorepoRoot, {
+  const configScan = await collectFilesByGlobs(monorepoRoot, {
     globs: ["**/qfai.config.yaml"],
     ignore: DEFAULT_CONFIG_SEARCH_IGNORE_GLOBS
   });
+  const configPaths = configScan.files;
   const configRoots = Array.from(
     new Set(configPaths.map((configPath) => path10.dirname(configPath)))
   ).sort((a, b) => a.localeCompare(b));
@@ -1417,7 +1474,16 @@ async function detectOutDirCollisions(root) {
       });
     }
   }
-  return { monorepoRoot, configRoots, collisions };
+  return {
+    monorepoRoot,
+    configRoots,
+    collisions,
+    scan: {
+      truncated: configScan.truncated,
+      matchedFileCount: configScan.matchedFileCount,
+      limit: configScan.limit
+    }
+  };
 }
 async function findMonorepoRoot(startDir) {
   let current = path10.resolve(startDir);
@@ -3524,13 +3590,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 = {
@@ -3669,8 +3736,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}`);
@@ -3796,6 +3862,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 {
@@ -3805,7 +3876,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(", ")}`);
   }
@@ -3822,7 +3894,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(", ")}`);
       }
     }
   }
@@ -3837,8 +3910,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("");
@@ -3850,7 +3924,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})`
       );
     }
   }
@@ -4007,6 +4081,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));
 }
@@ -4060,6 +4169,16 @@ function buildHotspots(issues) {
   );
 }
 
+// src/cli/lib/warnings.ts
+function warnIfTruncated(scan, context) {
+  if (!scan.truncated) {
+    return;
+  }
+  warn(
+    `[warn] ${context}: file scan truncated: collected ${scan.matchedFileCount} files (limit ${scan.limit})`
+  );
+}
+
 // src/cli/commands/report.ts
 async function runReport(options) {
   const root = path20.resolve(options.root);
@@ -4103,7 +4222,8 @@ async function runReport(options) {
     }
   }
   const data = await createReportData(root, validation, configResult);
-  const output = options.format === "json" ? formatReportJson(data) : formatReportMarkdown(data);
+  warnIfTruncated(data.traceability.testFiles, "report");
+  const output = options.format === "json" ? formatReportJson(data) : options.baseUrl ? formatReportMarkdown(data, { baseUrl: options.baseUrl }) : formatReportMarkdown(data);
   const outRoot = resolvePath(root, configResult.config, "outDir");
   const defaultOut = options.format === "json" ? path20.join(outRoot, "report.json") : path20.join(outRoot, "report.md");
   const out = options.outPath ?? defaultOut;
@@ -4200,6 +4320,7 @@ async function runValidate(options) {
   const configResult = await loadConfig(root);
   const result = await validateProject(root, configResult);
   const normalized = normalizeValidationResult(root, result);
+  warnIfTruncated(normalized.traceability.testFiles, "validate");
   const failOn = resolveFailOn(options, configResult.config.validation.failOn);
   const willFail = shouldFail(normalized, failOn);
   const format = options.format ?? "text";
@@ -4458,6 +4579,17 @@ function parseArgs(argv, cwd) {
       case "--run-validate":
         options.reportRunValidate = true;
         break;
+      case "--base-url": {
+        const next = readOptionValue(args, i);
+        if (next === null) {
+          invalid = true;
+          options.help = true;
+          break;
+        }
+        options.reportBaseUrl = next;
+        i += 1;
+        break;
+      }
       case "--help":
       case "-h":
         options.help = true;
@@ -4554,6 +4686,7 @@ async function run(argv, cwd) {
           format: options.reportFormat,
           ...options.reportOut !== void 0 ? { outPath: options.reportOut } : {},
           ...options.reportIn !== void 0 ? { inputPath: options.reportIn } : {},
+          ...options.reportBaseUrl !== void 0 ? { baseUrl: options.reportBaseUrl } : {},
           ...options.reportRunValidate ? { runValidate: true } : {}
         });
       }
@@ -4603,6 +4736,7 @@ Options:
   --out <path>                  report/doctor: \u51FA\u529B\u5148
   --in <path>                   report: validate.json \u306E\u5165\u529B\u5148\uFF08config\u3088\u308A\u512A\u5148\uFF09
   --run-validate                report: validate \u3092\u5B9F\u884C\u3057\u3066\u304B\u3089 report \u3092\u751F\u6210
+  --base-url <url>              report: \u30D1\u30B9\u3092\u30EA\u30F3\u30AF\u5316\u3059\u308B\u57FA\u6E96URL
   -h, --help      \u30D8\u30EB\u30D7\u8868\u793A
 `;
 }