@aipanel/core 1.3.6 → 1.3.8

package/es/common/diagnostics.d.ts

@@ -13,6 +13,13 @@ import type { AIPanelDiagnosticEntry } from "./types";
 export type DiagnosticsPhase = "edit" | "manual";
 /** 检查在哪些阶段执行（缺省 both） */
 export type DiagnosticsRun = DiagnosticsPhase | "both";
+/**
+ * 诊断目标形态（与 `run` 正交：`run` 管阶段，这里管"跑什么样的目标"）：
+ * - `edited`：编辑后自动诊断（本步编辑过的文件）
+ * - `file`：`run_diagnostics({ filePath })` 单文件
+ * - `project`：`run_diagnostics()` 全量
+ */
+export type DiagnosticsTargetKind = "edited" | "file" | "project";
 /**
  * 类型检查检查：唯一的"引擎级"内置（要 tsconfig 感知的批量归并、项目本地 tsc/vue-tsc 探测
  * 与自带 vue-tsc 兜底，不是一条命令能表达的）。其余一切检查都走同一条命令执行路径。
@@ -20,6 +27,8 @@ export type DiagnosticsRun = DiagnosticsPhase | "both";
 export interface TypecheckCheck {
     builtin: "typecheck";
     run?: DiagnosticsRun;
+    /** 只在这些目标形态下跑（如 ["project"] = 仅全量诊断）；缺省 = 不限 */
+    targets?: DiagnosticsTargetKind[];
     /** 只吃这些扩展名（如 [".ts", ".vue"]）；缺省 = 可诊断源码扩展名（与历史行为一致） */
     extensions?: string[];
 }
@@ -48,6 +57,8 @@ export interface CommandCheck {
     projectArgs?: string[];
     /** 只吃这些扩展名（如 [".css", ".scss"]）；缺省 = 不限 */
     extensions?: string[];
+    /** 只在这些目标形态下跑（如 ["project"] = 仅全量诊断）——想知道"这次是不是全量"就用它；缺省 = 不限 */
+    targets?: DiagnosticsTargetKind[];
     /** 相对项目根，默认项目根 */
     cwd?: string;
     run?: DiagnosticsRun;
@@ -68,6 +79,7 @@ export type LinterPresetCheck = {
     args?: string[];
     projectArgs?: string[];
     extensions?: string[];
+    targets?: DiagnosticsTargetKind[];
     format?: DiagnosticsFormat;
     cwd?: string;
     run?: DiagnosticsRun;
@@ -192,6 +204,8 @@ export declare function isLinterPreset(check: DiagnosticsCheck): check is Linter
 export declare function isTypecheckCheck(check: DiagnosticsCheck): check is TypecheckCheck;
 /** 该检查是否在指定阶段执行 */
 export declare function checkRunsInPhase(check: DiagnosticsCheck, phase: DiagnosticsPhase): boolean;
+/** 该检查是否在指定目标形态下执行（未声明 targets = 不限） */
+export declare function checkRunsOnTarget(check: DiagnosticsCheck, kind: DiagnosticsTargetKind): boolean;
 /**
  * 逐层覆盖 + 逐字段归一化：后面的层覆盖前面的层，非法值回退默认并通过 `onInvalid` 告警。
  * 调用方（provider）负责把告警写进日志，核心层保持无副作用、可单测。

package/es/common/diagnostics.mjs

@@ -71,6 +71,9 @@ function checkRunsInPhase(check, phase) {
   const run = check.run ?? "both";
   return run === "both" || run === phase;
 }
+function checkRunsOnTarget(check, kind) {
+  return check.targets === void 0 || check.targets.includes(kind);
+}
 const FORMATS = [
   "text",
   "tsc",
@@ -80,6 +83,7 @@ const FORMATS = [
   "aipanel-json"
 ];
 const RUNS = ["edit", "manual", "both"];
+const TARGET_KINDS = ["edited", "file", "project"];
 function normalizeExtensions(raw) {
   if (!Array.isArray(raw)) return void 0;
   const extensions = raw.filter((item) => typeof item === "string" && item.trim() !== "").map((item) => {
@@ -88,6 +92,13 @@ function normalizeExtensions(raw) {
   });
   return extensions.length > 0 ? [...new Set(extensions)] : void 0;
 }
+function normalizeTargets(raw) {
+  if (!Array.isArray(raw)) return void 0;
+  const targets = raw.filter(
+    (item) => TARGET_KINDS.includes(item)
+  );
+  return targets.length > 0 ? [...new Set(targets)] : void 0;
+}
 function normalizeArgs(raw) {
   if (!Array.isArray(raw)) return void 0;
   const args = raw.filter((item) => typeof item === "string");
@@ -98,6 +109,7 @@ function normalizeCheck(raw) {
   const value = raw;
   const run = RUNS.includes(value.run) ? value.run : void 0;
   const extensions = normalizeExtensions(value.extensions);
+  const targets = normalizeTargets(value.targets);
   const cwd = typeof value.cwd === "string" && value.cwd ? { cwd: value.cwd } : {};
   const timeout = typeof value.timeoutMs === "number" && Number.isFinite(value.timeoutMs) && value.timeoutMs > 0 ? { timeoutMs: Math.floor(value.timeoutMs) } : {};
   const format = FORMATS.includes(value.format) ? { format: value.format } : {};
@@ -106,6 +118,7 @@ function normalizeCheck(raw) {
       return {
         builtin: "typecheck",
         ...run ? { run } : {},
+        ...targets ? { targets } : {},
         ...extensions ? { extensions } : {}
       };
     }
@@ -117,6 +130,7 @@ function normalizeCheck(raw) {
         ...presetArgs ? { args: presetArgs } : {},
         ...presetProjectArgs ? { projectArgs: presetProjectArgs } : {},
         ...extensions ? { extensions } : {},
+        ...targets ? { targets } : {},
         ...run ? { run } : {},
         ...format,
         ...cwd,
@@ -138,6 +152,7 @@ function normalizeCheck(raw) {
     ...args ? { args } : {},
     ...projectArgs ? { projectArgs } : {},
     ...extensions ? { extensions } : {},
+    ...targets ? { targets } : {},
     ...cwd,
     ...run ? { run } : {},
     ...format,
@@ -218,6 +233,7 @@ export {
   DEFAULT_MAX_MESSAGE_CHARS,
   SOURCE_EXTENSIONS,
   checkRunsInPhase,
+  checkRunsOnTarget,
   isCommandCheck,
   isLinterPreset,
   isTypecheckCheck,

package/es/node/diagnostics.mjs

@@ -9,6 +9,7 @@ import {
   COMMAND_CHECK_TIMEOUT_MS,
   SOURCE_EXTENSIONS,
   checkRunsInPhase,
+  checkRunsOnTarget,
   isCommandCheck,
   isLinterPreset,
   isTypecheckCheck,
@@ -759,8 +760,11 @@ async function runCommandCheck(check, target, phase, severity, optional = false)
     if (failure) return { text: failure, diagnostics: [] };
     const raw = rawCommandOutput(outcome);
     try {
-      if (check.adapter) return await runAdapterModule(check, outcome, cwd, fileSet);
-      return adaptBuiltinFormat(check.format ?? "text", check, raw, cwd, severity);
+      const produced2 = check.adapter ? await runAdapterModule(check, outcome, cwd, fileSet) : adaptBuiltinFormat(check.format ?? "text", check, raw, cwd, severity);
+      if (phase === "edit" && outcome.exitCode === 0 && produced2.diagnostics.length === 0) {
+        return { ...produced2, text: void 0, notes: void 0 };
+      }
+      return produced2;
     } catch (error) {
       const reason = error instanceof Error ? error.message : String(error);
       const excerpt = raw.replace(/\s+/g, " ").trim().slice(0, 200);
@@ -860,7 +864,9 @@ async function runTypecheckCheck(check, target, phase, severity) {
   ];
 }
 async function runDiagnostics(target, policy, phase) {
-  const checks = policy.checks.filter((check) => checkRunsInPhase(check, phase));
+  const checks = policy.checks.filter(
+    (check) => checkRunsInPhase(check, phase) && checkRunsOnTarget(check, target.kind)
+  );
   log.debug("runDiagnostics", { phase, target: target.kind, checks: checks.length });
   const results = await Promise.all(
     checks.map((check) => {

package/lib/common/diagnostics.cjs

@@ -25,6 +25,7 @@ __export(diagnostics_exports, {
   DEFAULT_MAX_MESSAGE_CHARS: () => DEFAULT_MAX_MESSAGE_CHARS,
   SOURCE_EXTENSIONS: () => SOURCE_EXTENSIONS,
   checkRunsInPhase: () => checkRunsInPhase,
+  checkRunsOnTarget: () => checkRunsOnTarget,
   isCommandCheck: () => isCommandCheck,
   isLinterPreset: () => isLinterPreset,
   isTypecheckCheck: () => isTypecheckCheck,
@@ -105,6 +106,9 @@ function checkRunsInPhase(check, phase) {
   const run = check.run ?? "both";
   return run === "both" || run === phase;
 }
+function checkRunsOnTarget(check, kind) {
+  return check.targets === void 0 || check.targets.includes(kind);
+}
 const FORMATS = [
   "text",
   "tsc",
@@ -114,6 +118,7 @@ const FORMATS = [
   "aipanel-json"
 ];
 const RUNS = ["edit", "manual", "both"];
+const TARGET_KINDS = ["edited", "file", "project"];
 function normalizeExtensions(raw) {
   if (!Array.isArray(raw)) return void 0;
   const extensions = raw.filter((item) => typeof item === "string" && item.trim() !== "").map((item) => {
@@ -122,6 +127,13 @@ function normalizeExtensions(raw) {
   });
   return extensions.length > 0 ? [...new Set(extensions)] : void 0;
 }
+function normalizeTargets(raw) {
+  if (!Array.isArray(raw)) return void 0;
+  const targets = raw.filter(
+    (item) => TARGET_KINDS.includes(item)
+  );
+  return targets.length > 0 ? [...new Set(targets)] : void 0;
+}
 function normalizeArgs(raw) {
   if (!Array.isArray(raw)) return void 0;
   const args = raw.filter((item) => typeof item === "string");
@@ -132,6 +144,7 @@ function normalizeCheck(raw) {
   const value = raw;
   const run = RUNS.includes(value.run) ? value.run : void 0;
   const extensions = normalizeExtensions(value.extensions);
+  const targets = normalizeTargets(value.targets);
   const cwd = typeof value.cwd === "string" && value.cwd ? { cwd: value.cwd } : {};
   const timeout = typeof value.timeoutMs === "number" && Number.isFinite(value.timeoutMs) && value.timeoutMs > 0 ? { timeoutMs: Math.floor(value.timeoutMs) } : {};
   const format = FORMATS.includes(value.format) ? { format: value.format } : {};
@@ -140,6 +153,7 @@ function normalizeCheck(raw) {
       return {
         builtin: "typecheck",
         ...run ? { run } : {},
+        ...targets ? { targets } : {},
         ...extensions ? { extensions } : {}
       };
     }
@@ -151,6 +165,7 @@ function normalizeCheck(raw) {
         ...presetArgs ? { args: presetArgs } : {},
         ...presetProjectArgs ? { projectArgs: presetProjectArgs } : {},
         ...extensions ? { extensions } : {},
+        ...targets ? { targets } : {},
         ...run ? { run } : {},
         ...format,
         ...cwd,
@@ -172,6 +187,7 @@ function normalizeCheck(raw) {
     ...args ? { args } : {},
     ...projectArgs ? { projectArgs } : {},
     ...extensions ? { extensions } : {},
+    ...targets ? { targets } : {},
     ...cwd,
     ...run ? { run } : {},
     ...format,
@@ -253,6 +269,7 @@ function resolveDiagnosticsPolicy(layers, onInvalid = () => {
   DEFAULT_MAX_MESSAGE_CHARS,
   SOURCE_EXTENSIONS,
   checkRunsInPhase,
+  checkRunsOnTarget,
   isCommandCheck,
   isLinterPreset,
   isTypecheckCheck,

package/lib/common/diagnostics.d.ts

@@ -13,6 +13,13 @@ import type { AIPanelDiagnosticEntry } from "./types";
 export type DiagnosticsPhase = "edit" | "manual";
 /** 检查在哪些阶段执行（缺省 both） */
 export type DiagnosticsRun = DiagnosticsPhase | "both";
+/**
+ * 诊断目标形态（与 `run` 正交：`run` 管阶段，这里管"跑什么样的目标"）：
+ * - `edited`：编辑后自动诊断（本步编辑过的文件）
+ * - `file`：`run_diagnostics({ filePath })` 单文件
+ * - `project`：`run_diagnostics()` 全量
+ */
+export type DiagnosticsTargetKind = "edited" | "file" | "project";
 /**
  * 类型检查检查：唯一的"引擎级"内置（要 tsconfig 感知的批量归并、项目本地 tsc/vue-tsc 探测
  * 与自带 vue-tsc 兜底，不是一条命令能表达的）。其余一切检查都走同一条命令执行路径。
@@ -20,6 +27,8 @@ export type DiagnosticsRun = DiagnosticsPhase | "both";
 export interface TypecheckCheck {
     builtin: "typecheck";
     run?: DiagnosticsRun;
+    /** 只在这些目标形态下跑（如 ["project"] = 仅全量诊断）；缺省 = 不限 */
+    targets?: DiagnosticsTargetKind[];
     /** 只吃这些扩展名（如 [".ts", ".vue"]）；缺省 = 可诊断源码扩展名（与历史行为一致） */
     extensions?: string[];
 }
@@ -48,6 +57,8 @@ export interface CommandCheck {
     projectArgs?: string[];
     /** 只吃这些扩展名（如 [".css", ".scss"]）；缺省 = 不限 */
     extensions?: string[];
+    /** 只在这些目标形态下跑（如 ["project"] = 仅全量诊断）——想知道"这次是不是全量"就用它；缺省 = 不限 */
+    targets?: DiagnosticsTargetKind[];
     /** 相对项目根，默认项目根 */
     cwd?: string;
     run?: DiagnosticsRun;
@@ -68,6 +79,7 @@ export type LinterPresetCheck = {
     args?: string[];
     projectArgs?: string[];
     extensions?: string[];
+    targets?: DiagnosticsTargetKind[];
     format?: DiagnosticsFormat;
     cwd?: string;
     run?: DiagnosticsRun;
@@ -192,6 +204,8 @@ export declare function isLinterPreset(check: DiagnosticsCheck): check is Linter
 export declare function isTypecheckCheck(check: DiagnosticsCheck): check is TypecheckCheck;
 /** 该检查是否在指定阶段执行 */
 export declare function checkRunsInPhase(check: DiagnosticsCheck, phase: DiagnosticsPhase): boolean;
+/** 该检查是否在指定目标形态下执行（未声明 targets = 不限） */
+export declare function checkRunsOnTarget(check: DiagnosticsCheck, kind: DiagnosticsTargetKind): boolean;
 /**
  * 逐层覆盖 + 逐字段归一化：后面的层覆盖前面的层，非法值回退默认并通过 `onInvalid` 告警。
  * 调用方（provider）负责把告警写进日志，核心层保持无副作用、可单测。

package/lib/node/diagnostics.cjs

@@ -793,8 +793,11 @@ async function runCommandCheck(check, target, phase, severity, optional = false)
     if (failure) return { text: failure, diagnostics: [] };
     const raw = rawCommandOutput(outcome);
     try {
-      if (check.adapter) return await runAdapterModule(check, outcome, cwd, fileSet);
-      return adaptBuiltinFormat(check.format ?? "text", check, raw, cwd, severity);
+      const produced2 = check.adapter ? await runAdapterModule(check, outcome, cwd, fileSet) : adaptBuiltinFormat(check.format ?? "text", check, raw, cwd, severity);
+      if (phase === "edit" && outcome.exitCode === 0 && produced2.diagnostics.length === 0) {
+        return { ...produced2, text: void 0, notes: void 0 };
+      }
+      return produced2;
     } catch (error) {
       const reason = error instanceof Error ? error.message : String(error);
       const excerpt = raw.replace(/\s+/g, " ").trim().slice(0, 200);
@@ -894,7 +897,9 @@ async function runTypecheckCheck(check, target, phase, severity) {
   ];
 }
 async function runDiagnostics(target, policy, phase) {
-  const checks = policy.checks.filter((check) => (0, import_diagnostics.checkRunsInPhase)(check, phase));
+  const checks = policy.checks.filter(
+    (check) => (0, import_diagnostics.checkRunsInPhase)(check, phase) && (0, import_diagnostics.checkRunsOnTarget)(check, target.kind)
+  );
   log.debug("runDiagnostics", { phase, target: target.kind, checks: checks.length });
   const results = await Promise.all(
     checks.map((check) => {

package/package.json

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