covgate 0.2.0 → 0.2.2

package/src/setup/index.js

@@ -8,6 +8,7 @@ import {
   detectFramework,
   detectPackageManager,
   detectProfile,
+  detectScopeSpecs,
   detectSourceGlob,
   displayPath,
   installVitest,
@@ -108,23 +109,40 @@ export async function runSetup(options = {}) {
     testCommand = "npm run test:coverage";
   }
 
-  const profile = options.profile || detectProfile(root, pkg);
-  if (!["client", "server"].includes(profile)) {
-    throw new SetupError("profile 必须是 client 或 server");
+  let scopeSpecs;
+  if (options.profile || options.source) {
+    const profile = options.profile || detectProfile(root, pkg);
+    if (!["client", "server"].includes(profile)) {
+      throw new SetupError("profile 必须是 client 或 server");
+    }
+    const sourceGlob = normalizeGlob(
+      root,
+      options.source || detectSourceGlob(root, profile) || ""
+    );
+    scopeSpecs = sourceGlob
+      ? [
+          {
+            name: profile,
+            profile,
+            label: profile === "client" ? "客户端" : "服务端",
+            sourceGlob
+          }
+        ]
+      : [];
+  } else {
+    scopeSpecs = detectScopeSpecs(root, pkg);
   }
-  const sourceGlob = normalizeGlob(root, options.source || detectSourceGlob(root, profile) || "");
   const coveragePath = normalizeGlob(root, options.coverage || DEFAULT_COVERAGE_PATH);
   const configPath = path.join(root, "covgate.config.json");
   let configWritten = false;
 
-  if (options.noConfig !== true && testCommand && sourceGlob) {
+  if (options.noConfig !== true && testCommand && scopeSpecs.length > 0) {
     if (existsSync(configPath) && options.force !== true) {
       log("[covgate] " + displayPath(root, configPath) + " 已存在，保留现有配置");
     } else {
       const config = await buildStarterConfig({
         root,
-        profile,
-        sourceGlob,
+        scopes: scopeSpecs,
         command: testCommand,
         coveragePath
       });
@@ -137,9 +155,9 @@ export async function runSetup(options = {}) {
         "[covgate] 生成 " +
           displayPath(root, configPath) +
           "（" +
-          profile +
-          "，源码 " +
-          sourceGlob +
+          scopeSpecs
+            .map((scope) => scope.profile + "：" + scope.sourceGlob)
+            .join("，") +
           "）"
       );
       if (framework.id && !coverageScriptFor(framework.id) && !options.testCommand) {
@@ -150,7 +168,7 @@ export async function runSetup(options = {}) {
     if (!testCommand) {
       log("[covgate] 未找到可用的覆盖率测试命令，跳过 covgate.config.json。");
     }
-    if (!sourceGlob) {
+    if (scopeSpecs.length === 0) {
       log("[covgate] 未找到源码目录，跳过 covgate.config.json；请用 --source 指定。");
     }
   }
@@ -171,8 +189,9 @@ export async function runSetup(options = {}) {
     packageManager,
     framework: framework.id || null,
     installedFramework,
-    profile,
-    sourceGlob: sourceGlob || null,
+    profile: scopeSpecs.length === 1 ? scopeSpecs[0].profile : null,
+    sourceGlob: scopeSpecs.length === 1 ? scopeSpecs[0].sourceGlob : null,
+    scopes: scopeSpecs,
     testCommand: testCommand || null,
     coveragePath,
     configPath: configWritten ? configPath : existsSync(configPath) ? configPath : null,
@@ -191,7 +210,16 @@ export async function runSetup(options = {}) {
   if (summary.framework) {
     log("[covgate] 测试框架: " + (framework.label || summary.framework));
   }
+  if (scopeSpecs.length > 0) {
+    log(
+      "[covgate] Scope: " +
+        scopeSpecs
+          .map((scope) => scope.name + "/" + scope.profile + " (" + scope.sourceGlob + ")")
+          .join(", ")
+    );
+  }
   log("[covgate] 运行门禁: " + (summary.dryRun ? "npx covgate run" : "npx --no-install covgate run"));
+  log("[covgate] 注意：CovGate 不会生成或补写测试；项目必须为行为变更补真实测试后才能通过门禁。");
   if (!options.noAgent) {
     log("[covgate] AI 接入: AGENTS.md 与 scripts/covgate-agent-gate.*");
   }

package/src/setup/project.js

@@ -156,13 +156,27 @@ export function detectFramework(pkg) {
  */
 export function detectProfile(root, pkg) {
   const deps = directDependencyNames(pkg);
-  if (existsSync(path.join(root, "index.html"))) return "client";
+  const htmlLocations = [
+    "index.html",
+    "src/index.html",
+    "app/index.html",
+    "renderer/index.html"
+  ];
+  if (htmlLocations.some((file) => existsSync(path.join(root, file)))) return "client";
   if (pkg?.browser) return "client";
+  if (deps.has("electron") || deps.has("electron-builder")) return "client";
   if ([...BROWSER_DEPS].some((dependency) => deps.has(dependency))) return "client";
   if ([...SERVER_DEPS].some((dependency) => deps.has(dependency))) return "server";
   return "server";
 }
 
+/**
+ * @param {string} directory
+ */
+export function sourceGlobForDir(directory) {
+  return directory + "/**/*." + SOURCE_EXT;
+}
+
 /**
  * @param {string} root
  * @param {"client" | "server"} profile
@@ -170,33 +184,94 @@ export function detectProfile(root, pkg) {
  */
 export function detectSourceGlob(root, profile) {
   if (existsSync(path.join(root, "src"))) {
-    return "src/**/*." + SOURCE_EXT;
+    return sourceGlobForDir("src");
   }
   if (profile === "client" && existsSync(path.join(root, "app.js"))) {
     return "app.js";
   }
   const candidate = profile === "client" ? "client" : "server";
   if (existsSync(path.join(root, candidate))) {
-    return candidate + "/**/*." + SOURCE_EXT;
+    return sourceGlobForDir(candidate);
   }
   if (existsSync(path.join(root, "app"))) {
-    return "app/**/*." + SOURCE_EXT;
+    return sourceGlobForDir("app");
   }
   if (existsSync(path.join(root, "lib"))) {
-    return "lib/**/*." + SOURCE_EXT;
+    return sourceGlobForDir("lib");
   }
   return null;
 }
 
+/**
+ * Electron apps usually have a renderer tree (src) and a main-process tree
+ * (desktop). Treating src as server (the old setup default) was wrong.
+ *
+ * @param {string} root
+ * @param {any} pkg
+ */
+export function detectElectronApp(root, pkg) {
+  const deps = directDependencyNames(pkg);
+  if (deps.has("electron") || deps.has("electron-builder") || deps.has("@electron/packager")) {
+    return true;
+  }
+  const main = typeof pkg?.main === "string" ? pkg.main.replaceAll("\\", "/") : "";
+  return main.startsWith("desktop/") && existsSync(path.join(root, "src"));
+}
+
+/**
+ * @param {string} root
+ * @param {any} pkg
+ * @returns {Array<{ name: string, profile: "client" | "server", label: string, sourceGlob: string }>}
+ */
+export function detectScopeSpecs(root, pkg) {
+  if (detectElectronApp(root, pkg)) {
+    const clientDir = ["src", "app", "renderer", "client"].find((directory) =>
+      existsSync(path.join(root, directory))
+    );
+    const serverDir = ["desktop", "electron", "main"].find((directory) =>
+      existsSync(path.join(root, directory))
+    );
+    const specs = [];
+    if (clientDir) {
+      specs.push({
+        name: "client",
+        profile: "client",
+        label: "桌面客户端",
+        sourceGlob: sourceGlobForDir(clientDir)
+      });
+    }
+    if (serverDir) {
+      specs.push({
+        name: "server",
+        profile: "server",
+        label: "桌面主进程",
+        sourceGlob: sourceGlobForDir(serverDir)
+      });
+    }
+    if (specs.length > 0) return specs;
+  }
+  const profile = detectProfile(root, pkg);
+  const sourceGlob = detectSourceGlob(root, profile);
+  if (!sourceGlob) return [];
+  return [
+    {
+      name: profile,
+      profile,
+      label: profile === "client" ? "客户端" : "服务端",
+      sourceGlob
+    }
+  ];
+}
+
 /**
  * @param {"vitest" | "jest" | string} frameworkId
  */
 export function coverageScriptFor(frameworkId) {
   if (frameworkId === "vitest") {
-    return "vitest run --coverage --coverage.reporter=json --coverage.reporter=lcov --passWithNoTests";
+    return "vitest run --coverage --coverage.reporter=json --coverage.reporter=lcov";
   }
   if (frameworkId === "jest") {
-    return "jest --coverage --coverageReporters=json --coverageReporters=lcov --passWithNoTests";
+    return "jest --coverage --coverageReporters=json --coverageReporters=lcov";
   }
   return null;
 }

package/templates/AGENTS.md.snippet.md

@@ -3,6 +3,7 @@
 - 任何代码修改完成后，必须运行 `npx --no-install covgate run --json`；**退出码 0 才能结束任务**。
 - 退出码 `1`：补测试或修实现；`2`：修配置；`3`：修测试命令/覆盖率报告。不要绕过。
 - 禁止降低 `covgate.config.json` 中的门槛、扩大 exclude、删除豁免检查来让门禁通过。任何配置改动都必须由人类评审。
+- **行为变更必须新增或更新覆盖该行为的真实测试**；不能把“门禁失败”当作完成理由，也不得用空报告、`--passWithNoTests`、ignore 或降低门槛绕过。
 - 禁止 `istanbul ignore`、`c8 ignore`、`v8 ignore`、`node:coverage ignore`。
 - 确实不可达的代码使用 `covgate-ignore-next-line`、`covgate-ignore-start/end` 或 `covgate-ignore-file`，并写具体原因、owner 和 expires。
 - 新增或修改的源码必须出现在覆盖率报告中；`sources.include` 是范围事实来源。

package/templates/covgate.config.json

@@ -92,7 +92,8 @@
     "dir": ".covgate",
     "formats": [
       "json",
-      "markdown"
+      "markdown",
+      "html"
     ]
   }
 }