@aipanel/core 1.3.4 → 1.3.6

package/lib/node/diagnostics.d.ts

@@ -1,8 +1,9 @@
+import { type DiagnosticsPhase, type DiagnosticsPolicy } from "../common/diagnostics";
 /** 是否为可诊断的源码文件（供宿主钩子过滤 edit/write 目标） */
 export declare function isJsFile(filePath: string): boolean;
 /**
  * run_diagnostics 工具描述（单一来源，供 opencode / dsh 两侧插件引用）：
- * 只声明能力与支持的文件类型，不涉及内部使用的检查工具。
+ * 只声明能力与支持的文件类型，不涉及内部使用的检查工具（检查来源由用户配置，可能是项目命令）。
  */
 export declare const DIAGNOSTICS_TOOL_DESCRIPTION: string;
 /** LSP 风格诊断项（供宿主写入 metadata.diagnostics 等结构化输出） */
@@ -33,18 +34,7 @@ export interface TscResult {
 export interface EslintOutput {
     text?: string;
     diagnostics?: DiagnosticItem[];
-    /** 实际运行的 lint 引擎（"ESLint" / "oxlint"）；缺省视为 ESLint（兼容旧调用方） */
-    engines?: string[];
 }
-export interface DiagnosticsResult {
-    eslintOutput: EslintOutput;
-    tscOutput: TscResult;
-}
-/**
- * ESLint 检查，接受文件路径或 glob 模式。
- * 结果按 error / warning 分级格式化；warnings 数量超限时截断并注明。
- */
-export declare function lintFiles(pattern: string, cwd: string, warnLimit?: number): Promise<EslintOutput>;
 /** 从文件路径向上查找最近的 tsconfig.json 所在目录 */
 export declare function findTsconfigDir(filePath: string): string | null;
 /** 在工作区子目录中查找 tsconfig.json（不包括根目录；调用方已处理根目录场景） */
@@ -58,34 +48,62 @@ export declare function runTypeCheck(filePath: string | undefined, cwd: string):
  * 一次编辑批次里的 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 以 "." 全量扫描。
- */
-export declare function runProjectDiagnostics(workspace: string): Promise<DiagnosticsResult>;
+/** 诊断分区：一个检查在一段目标上的产出 */
+export interface DiagnosticsSection {
+    /** 分区标题：check 的 name，或内置引擎标题（ESLint + oxlint / vue-tsc） */
+    name: string;
+    /** 所属目标文件（相对项目根）；仅编辑后自动诊断按文件拆分时存在 */
+    target?: string;
+    /** 模型可见正文；无内容时缺省（自动诊断据此跳过该分区） */
+    text?: string;
+    /** LSP 坐标结构化条目（0-based），供 canonical 输出与诊断卡片使用 */
+    diagnostics: DiagnosticItem[];
+}
+/** 诊断结果：有序分区列表（历史上是写死的 { eslintOutput, tscOutput }，现已泛化） */
+export interface DiagnosticsResult {
+    sections: DiagnosticsSection[];
+}
+/** 诊断目标：agent 调工具（单文件 / 全量）或编辑后自动诊断（本步编辑过的文件） */
+export type DiagnosticsTarget = {
+    kind: "file";
+    file: string;
+    cwd: string;
+} | {
+    kind: "project";
+    cwd: string;
+} | {
+    kind: "edited";
+    files: string[];
+    cwd: string;
+};
+/** 渲染选项 */
+export interface RenderDiagnosticsOptions {
+    /** 只输出有发现的分区（编辑后自动诊断；全空返回空串） */
+    onlyFindings?: boolean;
+    /** 每个分区的发现条数上限（超出折叠成一行提示） */
+    maxFindingsPerSection?: number;
+}
+/** 类型检查分区标题（单一来源：跟随实际引擎 tsc / vue-tsc） */
 /** 类型检查分区标题（单一来源：跟随实际引擎 tsc / vue-tsc） */
 export declare function tscSectionTitle(tscOutput: TscResult): string;
-/** Lint 分区标题（单一来源：跟随实际运行的引擎组合，如 "ESLint + oxlint"） */
-export declare function lintSectionTitle(lintOutput: EslintOutput): string;
 /** 分区发现被条数上限折叠时的提示（自动诊断摘要与 run_diagnostics 完整输出的分界） */
 export declare function omittedFindingsHint(omitted: number): string;
 /**
- * 组装统一的分区诊断文本（Lint / 类型检查）。
- * 默认保留空分区的占位文案（run_diagnostics 要正面回答"有没有问题"）；
+ * 诊断深入口：按策略与阶段执行配置的检查，返回有序分区。
+ *
+ * 三类检查：`typecheck`（引擎级内置）、内置 linter 预设（展开成 CommandCheck）、
+ * 用户自定义检查——后两类走**完全同一条**执行与适配逻辑。
+ * 检查按声明顺序串行执行，输出顺序确定、进程数可控；
+ * `severity` 门槛在分区归一化处生效，文本与结构化条目一起收紧。
+ */
+export declare function runDiagnostics(target: DiagnosticsTarget, policy: DiagnosticsPolicy, phase: DiagnosticsPhase): Promise<DiagnosticsResult>;
+/** 汇总结构化条目（canonical 输出 / 诊断卡片用） */
+export declare function collectDiagnostics(result: DiagnosticsResult): DiagnosticItem[];
+/**
+ * 把分区结果渲染成模型可见文本。
  * `onlyFindings: true` 只输出有发现的分区、全空返回空串（编辑后自动诊断不刷占位噪音）；
  * `maxFindingsPerSection` 把每个分区的发现折叠成有界摘要——编辑后自动诊断每个 step 都会投递，
  * 因此用条数上限控制重复成本，完整结果仍由不带上限的 run_diagnostics 给出。
- * `title` 允许为空串，此时直接返回分区正文（追加式投递场景无需标题）。
+ * 编辑后自动诊断（分区带 target）保留 `### 文件` 结构。
  */
-export declare function formatDiagnosticsSections(title: string, eslintOutput: EslintOutput, tscOutput: TscResult, options?: {
-    onlyFindings?: boolean;
-    maxFindingsPerSection?: number;
-}): string;
+export declare function renderDiagnostics(result: DiagnosticsResult, options?: RenderDiagnosticsOptions): string;

package/lib/node.cjs

@@ -15,6 +15,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var node_exports = {};
 module.exports = __toCommonJS(node_exports);
 __reExport(node_exports, require("./common/constants.cjs"), module.exports);
+__reExport(node_exports, require("./common/diagnostics.cjs"), module.exports);
 __reExport(node_exports, require("./common/logger-core.cjs"), module.exports);
 __reExport(node_exports, require("./node/node-logger.cjs"), module.exports);
 __reExport(node_exports, require("./node/process-logger.cjs"), module.exports);
@@ -24,6 +25,7 @@ __reExport(node_exports, require("./node/diagnostics.cjs"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./common/constants.cjs"),
+  ...require("./common/diagnostics.cjs"),
   ...require("./common/logger-core.cjs"),
   ...require("./node/node-logger.cjs"),
   ...require("./node/process-logger.cjs"),

package/lib/node.d.ts

@@ -1,4 +1,5 @@
 export * from "./common/constants";
+export * from "./common/diagnostics";
 export * from "./common/logger-core";
 export * from "./node/node-logger";
 export * from "./node/process-logger";

package/package.json

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