@aipanel/core 1.2.27 → 1.2.28

package/es/node/diagnostics.d.ts

@@ -51,8 +51,20 @@ export declare function findTsconfigDir(filePath: string): string | null;
 export declare function findAllTsconfigDirs(workspace: string): string[];
 /** 运行 TypeScript 类型检查（tsc / vue-tsc 按项目自动选择）--build --noEmit，返回原始输出 */
 export declare function runTypeCheck(filePath: string | undefined, cwd: string): Promise<TscResult>;
+/**
+ * 多文件类型检查：按最近的 tsconfig 项目分组，每个项目只跑一次 `--build --noEmit`，
+ * 再把项目输出切分回各文件（与单文件路径共用 filterTscOutputForFile）。
+ * 一次编辑批次里的 N 个文件因此从 N 次项目构建降到 1 次。
+ */
+export declare function runTypeChecksForFiles(files: string[], cwd: string): Promise<Map<string, TscResult>>;
 /** 并行运行 ESLint + 类型检查（单文件或 glob） */
 export declare function runAllChecks(pattern: string, cwd: string): Promise<DiagnosticsResult>;
+/**
+ * 批量运行 ESLint + 类型检查：Lint 逐文件（ESLint 进程内、oxlint 单次 CLI），
+ * 类型检查按 tsconfig 项目合并为一次（见 runTypeChecksForFiles）。
+ * 返回"文件绝对路径 → 诊断结果"，供 step 边界的一次性收尾诊断使用。
+ */
+export declare function runAllChecksForFiles(files: string[], cwd: string): Promise<Map<string, DiagnosticsResult>>;
 /**
  * 全量项目诊断：优先从根 tsconfig 运行一次类型检查 --build，
  * 根无 tsconfig 时回退到逐个子目录 build；ESLint 以 "." 全量扫描。
@@ -62,5 +74,17 @@ export declare function runProjectDiagnostics(workspace: string): Promise<Diagno
 export declare function tscSectionTitle(tscOutput: TscResult): string;
 /** Lint 分区标题（单一来源：跟随实际运行的引擎组合，如 "ESLint + oxlint"） */
 export declare function lintSectionTitle(lintOutput: EslintOutput): string;
-/** 组装统一的分区诊断文本（Lint / 类型检查，空结果显示占位文案） */
-export declare function formatDiagnosticsSections(title: string, eslintOutput: EslintOutput, tscOutput: TscResult): string;
+/** 分区发现被条数上限折叠时的提示（自动诊断摘要与 run_diagnostics 完整输出的分界） */
+export declare function omittedFindingsHint(omitted: number): string;
+/**
+ * 组装统一的分区诊断文本（Lint / 类型检查）。
+ * 默认保留空分区的占位文案（run_diagnostics 要正面回答"有没有问题"）；
+ * `onlyFindings: true` 只输出有发现的分区、全空返回空串（编辑后自动诊断不刷占位噪音）；
+ * `maxFindingsPerSection` 把每个分区的发现折叠成有界摘要——编辑后自动诊断每个 step 都会投递，
+ * 因此用条数上限控制重复成本，完整结果仍由不带上限的 run_diagnostics 给出。
+ * `title` 允许为空串，此时直接返回分区正文（追加式投递场景无需标题）。
+ */
+export declare function formatDiagnosticsSections(title: string, eslintOutput: EslintOutput, tscOutput: TscResult, options?: {
+    onlyFindings?: boolean;
+    maxFindingsPerSection?: number;
+}): string;

package/es/node/diagnostics.mjs

@@ -342,6 +342,22 @@ function parseTscDiags(rawOutput, filePath, projectDir, source = "tsc") {
   }
   return diags;
 }
+function filterTscOutputForFile(rawOutput, filePath, projectDir) {
+  const resolved = path.resolve(filePath);
+  const errorLinePat = /^(.+?)\((\d+),(\d+)\):\s+(error|warning)\s+TS\d+:/;
+  const filtered = [];
+  let keep = false;
+  for (const line of rawOutput.split("\n")) {
+    const m = errorLinePat.exec(line);
+    if (m) {
+      keep = path.resolve(projectDir, m[1]) === resolved;
+    } else if (!/^\s/.test(line)) {
+      keep = false;
+    }
+    if (keep) filtered.push(line);
+  }
+  return filtered.join("\n");
+}
 async function runTypeCheck(filePath, cwd) {
   const dir = cwd;
   const projectDir = filePath ? findTsconfigDir(filePath) ?? dir : dir;
@@ -372,21 +388,7 @@ async function runTypeCheck(filePath, cwd) {
   }
   const diagnostics = parseTscDiags(rawOutput, filePath, projectDir, engine.source);
   if (filePath) {
-    const resolved = path.resolve(filePath);
-    const errorLinePat = /^(.+?)\((\d+),(\d+)\):\s+(error|warning)\s+TS\d+:/;
-    const lines = rawOutput.split("\n");
-    const filtered = [];
-    let keep = false;
-    for (const line of lines) {
-      const m = errorLinePat.exec(line);
-      if (m) {
-        keep = path.resolve(projectDir, m[1]) === resolved;
-      } else if (!/^\s/.test(line)) {
-        keep = false;
-      }
-      if (keep) filtered.push(line);
-    }
-    rawOutput = filtered.join("\n");
+    rawOutput = filterTscOutputForFile(rawOutput, filePath, projectDir);
   }
   log.debug("type-check finished", {
     engine: engine.source,
@@ -396,6 +398,32 @@ async function runTypeCheck(filePath, cwd) {
   });
   return { rawOutput, exitCode, diagnostics, source: engine.source };
 }
+async function runTypeChecksForFiles(files, cwd) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const file of files) {
+    const resolved = path.resolve(file);
+    const projectDir = findTsconfigDir(resolved) ?? cwd;
+    const group = groups.get(projectDir);
+    if (group) group.push(resolved);
+    else groups.set(projectDir, [resolved]);
+  }
+  const results = /* @__PURE__ */ new Map();
+  for (const [projectDir, group] of groups) {
+    const whole = await runTypeCheck(void 0, projectDir).catch(() => ({
+      rawOutput: "",
+      exitCode: 0
+    }));
+    for (const file of group) {
+      results.set(file, {
+        rawOutput: filterTscOutputForFile(whole.rawOutput, file, projectDir),
+        exitCode: whole.exitCode,
+        diagnostics: (whole.diagnostics ?? []).filter((d) => d.file === file),
+        source: whole.source
+      });
+    }
+  }
+  return results;
+}
 async function runAllChecks(pattern, cwd) {
   log.debug("runAllChecks", { pattern, cwd });
   const [eslintOutput, tscOutput] = await Promise.all([
@@ -404,6 +432,18 @@ async function runAllChecks(pattern, cwd) {
   ]);
   return { eslintOutput, tscOutput };
 }
+async function runAllChecksForFiles(files, cwd) {
+  const targets = [...new Set(files.map((file) => path.resolve(file)))];
+  const tscByFile = await runTypeChecksForFiles(targets, cwd);
+  const results = /* @__PURE__ */ new Map();
+  for (const file of targets) {
+    results.set(file, {
+      eslintOutput: await lintFiles(file, cwd),
+      tscOutput: tscByFile.get(file) ?? { rawOutput: "", exitCode: 0 }
+    });
+  }
+  return results;
+}
 async function runProjectDiagnostics(workspace) {
   const tscDirs = fs.existsSync(path.join(workspace, "tsconfig.json")) ? [workspace] : findAllTsconfigDirs(workspace);
   log.debug("Tsc dirs to check", { count: tscDirs.length, dirs: tscDirs });
@@ -425,18 +465,36 @@ function tscSectionTitle(tscOutput) {
 function lintSectionTitle(lintOutput) {
   return lintOutput.engines?.length ? lintOutput.engines.join(" + ") : "ESLint";
 }
-function formatDiagnosticsSections(title, eslintOutput, tscOutput) {
+function omittedFindingsHint(omitted) {
+  return `\u2026\u8FD8\u6709 ${omitted} \u6761\uFF0C\u5B8C\u6574\u7ED3\u679C\u8BF7\u8C03\u7528 run_diagnostics`;
+}
+function boundFindings(text, maxFindings) {
+  if (!maxFindings || !text) return text;
+  const lines = text.split("\n").filter((line) => line.trim() !== "");
+  if (lines.length <= maxFindings) return text;
+  return [...lines.slice(0, maxFindings), omittedFindingsHint(lines.length - maxFindings)].join(
+    "\n"
+  );
+}
+function formatDiagnosticsSections(title, eslintOutput, tscOutput, options = {}) {
+  const lintLines = boundFindings(eslintOutput.text, options.maxFindingsPerSection);
+  const tscLines = boundFindings(tscOutput.rawOutput.trim(), options.maxFindingsPerSection);
   const parts = [];
-  parts.push(`## ${lintSectionTitle(eslintOutput)}
+  if (!options.onlyFindings || lintLines) {
+    parts.push(`## ${lintSectionTitle(eslintOutput)}
 
-` + (eslintOutput.text || "\u6CA1\u6709\u53D1\u73B0\u95EE\u9898"));
-  const tscLines = tscOutput.rawOutput.trim();
-  parts.push(`## ${tscSectionTitle(tscOutput)}
+` + (lintLines || "\u6CA1\u6709\u53D1\u73B0\u95EE\u9898"));
+  }
+  if (!options.onlyFindings || tscLines) {
+    parts.push(`## ${tscSectionTitle(tscOutput)}
 
 ` + (tscLines || "\u6CA1\u6709\u53D1\u73B0\u7C7B\u578B\u9519\u8BEF"));
-  return `${title}
+  }
+  if (parts.length === 0) return "";
+  const body = parts.join("\n\n");
+  return title ? `${title}
 
-` + parts.join("\n\n");
+${body}` : body;
 }
 export {
   DIAGNOSTICS_TOOL_DESCRIPTION,
@@ -446,8 +504,11 @@ export {
   isJsFile,
   lintFiles,
   lintSectionTitle,
+  omittedFindingsHint,
   runAllChecks,
+  runAllChecksForFiles,
   runProjectDiagnostics,
   runTypeCheck,
+  runTypeChecksForFiles,
   tscSectionTitle
 };

package/lib/node/diagnostics.cjs

@@ -34,9 +34,12 @@ __export(diagnostics_exports, {
   isJsFile: () => isJsFile,
   lintFiles: () => lintFiles,
   lintSectionTitle: () => lintSectionTitle,
+  omittedFindingsHint: () => omittedFindingsHint,
   runAllChecks: () => runAllChecks,
+  runAllChecksForFiles: () => runAllChecksForFiles,
   runProjectDiagnostics: () => runProjectDiagnostics,
   runTypeCheck: () => runTypeCheck,
+  runTypeChecksForFiles: () => runTypeChecksForFiles,
   tscSectionTitle: () => tscSectionTitle
 });
 module.exports = __toCommonJS(diagnostics_exports);
@@ -385,6 +388,22 @@ function parseTscDiags(rawOutput, filePath, projectDir, source = "tsc") {
   }
   return diags;
 }
+function filterTscOutputForFile(rawOutput, filePath, projectDir) {
+  const resolved = import_node_path.default.resolve(filePath);
+  const errorLinePat = /^(.+?)\((\d+),(\d+)\):\s+(error|warning)\s+TS\d+:/;
+  const filtered = [];
+  let keep = false;
+  for (const line of rawOutput.split("\n")) {
+    const m = errorLinePat.exec(line);
+    if (m) {
+      keep = import_node_path.default.resolve(projectDir, m[1]) === resolved;
+    } else if (!/^\s/.test(line)) {
+      keep = false;
+    }
+    if (keep) filtered.push(line);
+  }
+  return filtered.join("\n");
+}
 async function runTypeCheck(filePath, cwd) {
   const dir = cwd;
   const projectDir = filePath ? findTsconfigDir(filePath) ?? dir : dir;
@@ -415,21 +434,7 @@ async function runTypeCheck(filePath, cwd) {
   }
   const diagnostics = parseTscDiags(rawOutput, filePath, projectDir, engine.source);
   if (filePath) {
-    const resolved = import_node_path.default.resolve(filePath);
-    const errorLinePat = /^(.+?)\((\d+),(\d+)\):\s+(error|warning)\s+TS\d+:/;
-    const lines = rawOutput.split("\n");
-    const filtered = [];
-    let keep = false;
-    for (const line of lines) {
-      const m = errorLinePat.exec(line);
-      if (m) {
-        keep = import_node_path.default.resolve(projectDir, m[1]) === resolved;
-      } else if (!/^\s/.test(line)) {
-        keep = false;
-      }
-      if (keep) filtered.push(line);
-    }
-    rawOutput = filtered.join("\n");
+    rawOutput = filterTscOutputForFile(rawOutput, filePath, projectDir);
   }
   log.debug("type-check finished", {
     engine: engine.source,
@@ -439,6 +444,32 @@ async function runTypeCheck(filePath, cwd) {
   });
   return { rawOutput, exitCode, diagnostics, source: engine.source };
 }
+async function runTypeChecksForFiles(files, cwd) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const file of files) {
+    const resolved = import_node_path.default.resolve(file);
+    const projectDir = findTsconfigDir(resolved) ?? cwd;
+    const group = groups.get(projectDir);
+    if (group) group.push(resolved);
+    else groups.set(projectDir, [resolved]);
+  }
+  const results = /* @__PURE__ */ new Map();
+  for (const [projectDir, group] of groups) {
+    const whole = await runTypeCheck(void 0, projectDir).catch(() => ({
+      rawOutput: "",
+      exitCode: 0
+    }));
+    for (const file of group) {
+      results.set(file, {
+        rawOutput: filterTscOutputForFile(whole.rawOutput, file, projectDir),
+        exitCode: whole.exitCode,
+        diagnostics: (whole.diagnostics ?? []).filter((d) => d.file === file),
+        source: whole.source
+      });
+    }
+  }
+  return results;
+}
 async function runAllChecks(pattern, cwd) {
   log.debug("runAllChecks", { pattern, cwd });
   const [eslintOutput, tscOutput] = await Promise.all([
@@ -447,6 +478,18 @@ async function runAllChecks(pattern, cwd) {
   ]);
   return { eslintOutput, tscOutput };
 }
+async function runAllChecksForFiles(files, cwd) {
+  const targets = [...new Set(files.map((file) => import_node_path.default.resolve(file)))];
+  const tscByFile = await runTypeChecksForFiles(targets, cwd);
+  const results = /* @__PURE__ */ new Map();
+  for (const file of targets) {
+    results.set(file, {
+      eslintOutput: await lintFiles(file, cwd),
+      tscOutput: tscByFile.get(file) ?? { rawOutput: "", exitCode: 0 }
+    });
+  }
+  return results;
+}
 async function runProjectDiagnostics(workspace) {
   const tscDirs = import_node_fs.default.existsSync(import_node_path.default.join(workspace, "tsconfig.json")) ? [workspace] : findAllTsconfigDirs(workspace);
   log.debug("Tsc dirs to check", { count: tscDirs.length, dirs: tscDirs });
@@ -468,18 +511,36 @@ function tscSectionTitle(tscOutput) {
 function lintSectionTitle(lintOutput) {
   return lintOutput.engines?.length ? lintOutput.engines.join(" + ") : "ESLint";
 }
-function formatDiagnosticsSections(title, eslintOutput, tscOutput) {
+function omittedFindingsHint(omitted) {
+  return `\u2026\u8FD8\u6709 ${omitted} \u6761\uFF0C\u5B8C\u6574\u7ED3\u679C\u8BF7\u8C03\u7528 run_diagnostics`;
+}
+function boundFindings(text, maxFindings) {
+  if (!maxFindings || !text) return text;
+  const lines = text.split("\n").filter((line) => line.trim() !== "");
+  if (lines.length <= maxFindings) return text;
+  return [...lines.slice(0, maxFindings), omittedFindingsHint(lines.length - maxFindings)].join(
+    "\n"
+  );
+}
+function formatDiagnosticsSections(title, eslintOutput, tscOutput, options = {}) {
+  const lintLines = boundFindings(eslintOutput.text, options.maxFindingsPerSection);
+  const tscLines = boundFindings(tscOutput.rawOutput.trim(), options.maxFindingsPerSection);
   const parts = [];
-  parts.push(`## ${lintSectionTitle(eslintOutput)}
+  if (!options.onlyFindings || lintLines) {
+    parts.push(`## ${lintSectionTitle(eslintOutput)}
 
-` + (eslintOutput.text || "\u6CA1\u6709\u53D1\u73B0\u95EE\u9898"));
-  const tscLines = tscOutput.rawOutput.trim();
-  parts.push(`## ${tscSectionTitle(tscOutput)}
+` + (lintLines || "\u6CA1\u6709\u53D1\u73B0\u95EE\u9898"));
+  }
+  if (!options.onlyFindings || tscLines) {
+    parts.push(`## ${tscSectionTitle(tscOutput)}
 
 ` + (tscLines || "\u6CA1\u6709\u53D1\u73B0\u7C7B\u578B\u9519\u8BEF"));
-  return `${title}
+  }
+  if (parts.length === 0) return "";
+  const body = parts.join("\n\n");
+  return title ? `${title}
 
-` + parts.join("\n\n");
+${body}` : body;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -490,8 +551,11 @@ function formatDiagnosticsSections(title, eslintOutput, tscOutput) {
   isJsFile,
   lintFiles,
   lintSectionTitle,
+  omittedFindingsHint,
   runAllChecks,
+  runAllChecksForFiles,
   runProjectDiagnostics,
   runTypeCheck,
+  runTypeChecksForFiles,
   tscSectionTitle
 });

package/lib/node/diagnostics.d.ts

@@ -51,8 +51,20 @@ export declare function findTsconfigDir(filePath: string): string | null;
 export declare function findAllTsconfigDirs(workspace: string): string[];
 /** 运行 TypeScript 类型检查（tsc / vue-tsc 按项目自动选择）--build --noEmit，返回原始输出 */
 export declare function runTypeCheck(filePath: string | undefined, cwd: string): Promise<TscResult>;
+/**
+ * 多文件类型检查：按最近的 tsconfig 项目分组，每个项目只跑一次 `--build --noEmit`，
+ * 再把项目输出切分回各文件（与单文件路径共用 filterTscOutputForFile）。
+ * 一次编辑批次里的 N 个文件因此从 N 次项目构建降到 1 次。
+ */
+export declare function runTypeChecksForFiles(files: string[], cwd: string): Promise<Map<string, TscResult>>;
 /** 并行运行 ESLint + 类型检查（单文件或 glob） */
 export declare function runAllChecks(pattern: string, cwd: string): Promise<DiagnosticsResult>;
+/**
+ * 批量运行 ESLint + 类型检查：Lint 逐文件（ESLint 进程内、oxlint 单次 CLI），
+ * 类型检查按 tsconfig 项目合并为一次（见 runTypeChecksForFiles）。
+ * 返回"文件绝对路径 → 诊断结果"，供 step 边界的一次性收尾诊断使用。
+ */
+export declare function runAllChecksForFiles(files: string[], cwd: string): Promise<Map<string, DiagnosticsResult>>;
 /**
  * 全量项目诊断：优先从根 tsconfig 运行一次类型检查 --build，
  * 根无 tsconfig 时回退到逐个子目录 build；ESLint 以 "." 全量扫描。
@@ -62,5 +74,17 @@ export declare function runProjectDiagnostics(workspace: string): Promise<Diagno
 export declare function tscSectionTitle(tscOutput: TscResult): string;
 /** Lint 分区标题（单一来源：跟随实际运行的引擎组合，如 "ESLint + oxlint"） */
 export declare function lintSectionTitle(lintOutput: EslintOutput): string;
-/** 组装统一的分区诊断文本（Lint / 类型检查，空结果显示占位文案） */
-export declare function formatDiagnosticsSections(title: string, eslintOutput: EslintOutput, tscOutput: TscResult): string;
+/** 分区发现被条数上限折叠时的提示（自动诊断摘要与 run_diagnostics 完整输出的分界） */
+export declare function omittedFindingsHint(omitted: number): string;
+/**
+ * 组装统一的分区诊断文本（Lint / 类型检查）。
+ * 默认保留空分区的占位文案（run_diagnostics 要正面回答"有没有问题"）；
+ * `onlyFindings: true` 只输出有发现的分区、全空返回空串（编辑后自动诊断不刷占位噪音）；
+ * `maxFindingsPerSection` 把每个分区的发现折叠成有界摘要——编辑后自动诊断每个 step 都会投递，
+ * 因此用条数上限控制重复成本，完整结果仍由不带上限的 run_diagnostics 给出。
+ * `title` 允许为空串，此时直接返回分区正文（追加式投递场景无需标题）。
+ */
+export declare function formatDiagnosticsSections(title: string, eslintOutput: EslintOutput, tscOutput: TscResult, options?: {
+    onlyFindings?: boolean;
+    maxFindingsPerSection?: number;
+}): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aipanel/core",
-  "version": "1.2.27",
+  "version": "1.2.28",
   "type": "module",
   "sideEffects": false,
   "main": "lib/index.cjs",