fix(test): skip heavy-check lock for scoped tooling runs

scripts/test-projects.mjs

@@ -16,6 +16,7 @@ import {
   parseTestProjectsArgs,
   resolveParallelFullSuiteConcurrency,
   resolveChangedTargetArgs,
+  shouldAcquireLocalHeavyCheckLock,
   writeVitestIncludeFile,
 } from "./test-projects.test-support.mjs";
 import {
@@ -26,11 +27,7 @@ import {
 
 // Keep this shim so `pnpm test -- src/foo.test.ts` still forwards filters
 // cleanly instead of leaking pnpm's passthrough sentinel to Vitest.
-const releaseLock = acquireLocalHeavyCheckLockSync({
-  cwd: process.cwd(),
-  env: process.env,
-  toolName: "test",
-});
+let releaseLock = () => {};
 let lockReleased = false;
 
 const FULL_SUITE_CONFIG_WEIGHT = new Map([
@@ -243,6 +240,14 @@ async function main() {
           cwd: process.cwd(),
         });
 
+  releaseLock = shouldAcquireLocalHeavyCheckLock(runSpecs, process.env)
+    ? acquireLocalHeavyCheckLockSync({
+        cwd: process.cwd(),
+        env: process.env,
+        toolName: "test",
+      })
+    : () => {};
+
   const isFullSuiteRun =
     targetArgs.length === 0 &&
     changedTargetArgs === null &&

scripts/test-projects.test-support.mjs

@@ -754,6 +754,21 @@ export function createVitestRunSpecs(args, params = {}) {
   });
 }
 
+export function shouldAcquireLocalHeavyCheckLock(runSpecs, env = process.env) {
+  if (env.OPENCLAW_TEST_PROJECTS_FORCE_LOCK === "1") {
+    return true;
+  }
+
+  return !(
+    env.OPENCLAW_TEST_PROJECTS_SERIAL === "1" &&
+    runSpecs.length === 1 &&
+    runSpecs[0]?.config === TOOLING_VITEST_CONFIG &&
+    runSpecs[0]?.watchMode === false &&
+    Array.isArray(runSpecs[0]?.includePatterns) &&
+    runSpecs[0].includePatterns.length > 0
+  );
+}
+
 export function writeVitestIncludeFile(filePath, includePatterns) {
   fs.writeFileSync(filePath, `${JSON.stringify(includePatterns, null, 2)}\n`);
 }