@herbertgao/pi-extensions 2026.9.2 → 2026.9.3

package/node_modules/pi-lens/dist/clients/dispatch/runners/lsp.js

@@ -126,6 +126,7 @@ const lspRunner = {
         // so this is tracked separately: the only claim it invalidates is "0
         // diagnostics means clean".
         let unconfirmedServerIds = [];
+        let deferredServerIds = [];
         let usedWarmAttach = false;
         let failureReason = "";
         const content = readFileContent(ctx.filePath);
@@ -180,6 +181,7 @@ const lspRunner = {
                 lspDiags = touched.diags;
                 diagnosticsInconclusive = touched.inconclusive === true;
                 unconfirmedServerIds = touchCoverageGap(touched);
+                deferredServerIds = touched.deferredServerIds ?? [];
             }
         }
         catch (err) {
@@ -237,6 +239,15 @@ const lspRunner = {
             return { status: "skipped", diagnostics: [], semantic: "none" };
         }
         if (lspDiags.length === 0) {
+            if (deferredServerIds.length > 0) {
+                return {
+                    status: "deferred",
+                    diagnostics: [],
+                    semantic: "none",
+                    unconfirmedServerIds: [...unconfirmedServerIds],
+                    deferredServerIds: [...deferredServerIds],
+                };
+            }
             if (unconfirmedServerIds.length > 0) {
                 // #1470/#1493: an auxiliary never reported — cut off by the aux grace
                 // timer, or silent with nothing published for this content — so this
@@ -345,7 +356,11 @@ const lspRunner = {
                 ? "warning"
                 : "none";
         return {
-            status: hasErrors ? "failed" : "succeeded",
+            status: hasErrors
+                ? "failed"
+                : deferredServerIds.length > 0
+                    ? "deferred"
+                    : "succeeded",
             // "failed" here means the file has blocking type errors — the check ran
             // fine. Tag it so the smell analyzer doesn't read it as a runner crash.
             failureKind: hasErrors ? "blocking_diagnostics" : undefined,
@@ -354,6 +369,9 @@ const lspRunner = {
             ...(unconfirmedServerIds.length > 0 && {
                 unconfirmedServerIds: [...unconfirmedServerIds],
             }),
+            ...(deferredServerIds.length > 0 && {
+                deferredServerIds: [...deferredServerIds],
+            }),
         };
     },
 };

package/node_modules/pi-lens/dist/clients/dispatch/runners/markdownlint.js

@@ -1,4 +1,5 @@
 import { safeSpawnAsync } from "../../safe-spawn.js";
+import { logRunnerAdvisoryOnce, resolveRunnerCwd } from "../../tool-cwd.js";
 import { getLinterPolicyForCwd, markdownlintConfigArgs, } from "../../tool-policy.js";
 import { PRIORITY } from "../priorities.js";
 import { createAvailabilityChecker, resolveToolCommandWithInstallFallback, } from "./utils/runner-helpers.js";
@@ -96,7 +97,7 @@ const markdownlintRunner = {
     priority: PRIORITY.DOC_QUALITY,
     skipTestFiles: false,
     async run(ctx) {
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "markdownlint");
         const policy = getLinterPolicyForCwd(ctx.filePath, cwd);
         if (policy && !policy.preferredRunners.includes("markdownlint")) {
             return { status: "skipped", diagnostics: [], semantic: "none" };
@@ -114,7 +115,7 @@ const markdownlintRunner = {
         // its budget in another lane (availability verify, autofix --fix). Skip
         // without spawning — "not checked", never re-reported as clean.
         if (isInSpawnTimeoutCooldown(cmd)) {
-            ctx.log(`markdownlint: ${cmd} is cooling down after a spawn timeout — skipping (one bounded failure budget per edit)`);
+            logRunnerAdvisoryOnce(ctx, "markdownlint", cwd, `markdownlint: ${cmd} is cooling down after a spawn timeout — skipping (one bounded failure budget per edit)`);
             return { status: "skipped", diagnostics: [], semantic: "none" };
         }
         // Shared config-args seam (#1247): the autofix path consumes the same

package/node_modules/pi-lens/dist/clients/dispatch/runners/mypy.js

@@ -1,5 +1,6 @@
 import * as path from "node:path";
 import { safeSpawnAsync } from "../../safe-spawn.js";
+import { resolveRunnerCwd } from "../../tool-cwd.js";
 import { hasMypyConfig } from "../../tool-policy.js";
 import { PRIORITY } from "../priorities.js";
 import { createAvailabilityChecker, resolveToolCommandWithInstallFallback, } from "./utils/runner-helpers.js";
@@ -61,7 +62,7 @@ const mypyRunner = {
     priority: PRIORITY.GENERAL_ANALYSIS,
     skipTestFiles: false,
     async run(ctx) {
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "mypy");
         // Only run if mypy config exists — avoids false positives in untyped projects
         if (!hasMypyConfig(cwd)) {
             return { status: "skipped", diagnostics: [], semantic: "none" };

package/node_modules/pi-lens/dist/clients/dispatch/runners/oxlint.js

@@ -8,6 +8,7 @@
  */
 import { findLocalBinUpwards } from "../../package-manager.js";
 import { safeSpawnAsync } from "../../safe-spawn.js";
+import { resolveRunnerCwd } from "../../tool-cwd.js";
 import { truncatedByOutputCap } from "../../spawn-output-cap.js";
 import { getJstsLintPolicyForCwd, hasVitePlusConfig, } from "../../tool-policy.js";
 import { PRIORITY } from "../priorities.js";
@@ -58,7 +59,7 @@ const oxlintRunner = {
     priority: PRIORITY.LINT_SECONDARY,
     skipTestFiles: false,
     async run(ctx) {
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "oxlint");
         const policy = getJstsLintPolicyForCwd(cwd);
         if (!policy.preferredRunners.includes("oxlint")) {
             return { status: "skipped", diagnostics: [], semantic: "none" };

package/node_modules/pi-lens/dist/clients/dispatch/runners/php-lint.js

@@ -1,5 +1,6 @@
 import * as path from "node:path";
 import { safeSpawnAsync } from "../../safe-spawn.js";
+import { resolveRunnerCwd } from "../../tool-cwd.js";
 import { PRIORITY } from "../priorities.js";
 import { createAvailabilityChecker } from "./utils/runner-helpers.js";
 const php = createAvailabilityChecker("php", ".exe");
@@ -31,7 +32,7 @@ const phpLintRunner = {
     priority: PRIORITY.GENERAL_ANALYSIS,
     skipTestFiles: false,
     async run(ctx) {
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "php-lint");
         if (!(await php.isAvailableAsync(cwd))) {
             return { status: "skipped", diagnostics: [], semantic: "none" };
         }

package/node_modules/pi-lens/dist/clients/dispatch/runners/phpstan.js

@@ -1,5 +1,6 @@
 import * as path from "node:path";
 import { safeSpawnAsync } from "../../safe-spawn.js";
+import { resolveRunnerCwd } from "../../tool-cwd.js";
 import { getLinterPolicyForCwd, hasPhpstanConfig } from "../../tool-policy.js";
 import { PRIORITY } from "../priorities.js";
 import { createAvailabilityChecker, resolveVendorToolCommand, } from "./utils/runner-helpers.js";
@@ -84,7 +85,7 @@ const phpstanRunner = {
     priority: PRIORITY.GENERAL_ANALYSIS,
     skipTestFiles: false,
     async run(ctx) {
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "phpstan");
         const policy = getLinterPolicyForCwd(ctx.filePath, cwd);
         if (policy && !policy.preferredRunners.includes("phpstan")) {
             return { status: "skipped", diagnostics: [], semantic: "none" };

package/node_modules/pi-lens/dist/clients/dispatch/runners/prisma-validate.js

@@ -1,5 +1,6 @@
 import * as path from "node:path";
 import { safeSpawnAsync } from "../../safe-spawn.js";
+import { resolveRunnerCwd } from "../../tool-cwd.js";
 import { PRIORITY } from "../priorities.js";
 import { resolveLocalFirstAsync } from "./utils/runner-helpers.js";
 function parsePrismaValidateOutput(raw, filePath) {
@@ -37,7 +38,7 @@ const prismaValidateRunner = {
     priority: PRIORITY.GENERAL_ANALYSIS,
     skipTestFiles: false,
     async run(ctx) {
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "prisma-validate");
         const resolved = await resolveLocalFirstAsync("prisma", cwd);
         const absPath = path.resolve(cwd, ctx.filePath);
         const result = await safeSpawnAsync(resolved.cmd, [...resolved.args, "validate", "--schema", absPath], { timeout: 20000, cwd });

package/node_modules/pi-lens/dist/clients/dispatch/runners/psscriptanalyzer.js

@@ -3,6 +3,8 @@ import * as os from "node:os";
 import * as path from "node:path";
 import { incrementDegradationCount } from "../../degradation-ledger.js";
 import { safeSpawnAsync } from "../../safe-spawn.js";
+import { probeToolAsync } from "../../tool-probe.js";
+import { resolveRunnerCwd } from "../../tool-cwd.js";
 import { PRIORITY } from "../priorities.js";
 import { classifyProbeFailure, createAvailabilityLatch, isLatchingOutcome, logAvailabilityDecision, startHostStallSampler, } from "./utils/availability-policy.js";
 // The PS script written to a temp file each run. `-File` with a temp script
@@ -25,8 +27,13 @@ const PS_TIMEOUT_MS = 30000;
  * available". `safeSpawnAsync` carries the standard taxonomy — `failure`,
  * `spawnFailure.kind` and the errno on `error` — which is what lets the
  * availability policy tell a stall from an absence.
+ *
+ * The two presence probes that used to share this wrapper now go through
+ * `probeToolAsync` (#2894), so the only spawn left here is the ANALYSIS pass
+ * — which always has a project to resolve `PSScriptAnalyzerSettings.psd1`
+ * against. `cwd` is required to keep it that way.
  */
-function spawnPs(cmd, args, options = {}) {
+function spawnPs(cmd, args, options) {
     const { timeoutMs = PS_TIMEOUT_MS, cwd } = options;
     return safeSpawnAsync(cmd, args, {
         cwd,
@@ -126,13 +133,7 @@ async function resolvePowerShellCmd() {
     for (const candidate of ["pwsh", "powershell"]) {
         const sampler = startHostStallSampler();
         const startedAt = Date.now();
-        // cwd-exempt: global interpreter-presence probe ("is pwsh/powershell on PATH at all"), not tied to any project
-        const result = await spawnPs(candidate, [
-            "-NoProfile",
-            "-NonInteractive",
-            "-Command",
-            "exit 0",
-        ]);
+        const result = await probeToolAsync(candidate, ["-NoProfile", "-NonInteractive", "-Command", "exit 0"], { timeout: PS_TIMEOUT_MS, resourceLabel: "psscriptanalyzer" });
         const hostStallMs = sampler.stop();
         const elapsedMs = Date.now() - startedAt;
         elapsedTotalMs += elapsedMs;
@@ -178,13 +179,12 @@ async function checkModuleAvailable(cmd) {
         return memo;
     const sampler = startHostStallSampler();
     const startedAt = Date.now();
-    // cwd-exempt: global module-presence probe -- PSScriptAnalyzer resolves from PowerShell's module search path, not a per-project install
-    const result = await spawnPs(cmd, [
+    const result = await probeToolAsync(cmd, [
         "-NoProfile",
         "-NonInteractive",
         "-Command",
         "if (Get-Module -ListAvailable PSScriptAnalyzer) { exit 0 } else { exit 1 }",
-    ]);
+    ], { timeout: PS_TIMEOUT_MS, resourceLabel: "psscriptanalyzer" });
     const hostStallMs = sampler.stop();
     const elapsedMs = Date.now() - startedAt;
     if (!result.error && result.status === 0) {
@@ -292,7 +292,7 @@ const psScriptAnalyzerRunner = {
         if (execLatch.read() === false) {
             return { status: "skipped", diagnostics: [], semantic: "none" };
         }
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "psscriptanalyzer");
         const absPath = path.resolve(cwd, ctx.filePath);
         // Write script to temp file so we avoid cmd.exe quoting entirely
         const tmpScript = path.join(os.tmpdir(), `pi-lens-psa-${process.pid}.ps1`);

package/node_modules/pi-lens/dist/clients/dispatch/runners/pyright.js

@@ -10,6 +10,7 @@ import { logExtension } from "../../extension-log.js";
 import { getLSPService } from "../../lsp/index.js";
 import { augmentPythonEnvironment, detectPythonEnvironment, } from "../../python-environment.js";
 import { safeSpawnAsync } from "../../safe-spawn.js";
+import { resolveRunnerCwd } from "../../tool-cwd.js";
 import { PRIORITY } from "../priorities.js";
 import { createAvailabilityChecker, resolveAvailableOrInstall, } from "./utils/runner-helpers.js";
 import { finishParsedRun } from "./utils/tool-failure.js";
@@ -28,7 +29,7 @@ const pyrightRunner = {
             const lspService = getLSPService();
             await lspService.getClientForFile(ctx.filePath);
         }
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "pyright");
         // Get pyright command - try multiple strategies
         let cmd = null;
         // Strategy 1: Check cached availability (fast path)

package/node_modules/pi-lens/dist/clients/dispatch/runners/rubocop.js

@@ -8,6 +8,7 @@
  * Supports bundle exec (preferred in Bundler projects).
  */
 import { safeSpawnAsync } from "../../safe-spawn.js";
+import { resolveRunnerCwd } from "../../tool-cwd.js";
 import { getAutofixCapability, getLinterPolicyForCwd, getRubocopCommand, } from "../../tool-policy.js";
 import { PRIORITY } from "../priorities.js";
 import { resolveCommandArgsWithInstallFallback } from "./utils/runner-helpers.js";
@@ -55,7 +56,7 @@ const rubocopRunner = {
     appliesTo: ["ruby"],
     priority: PRIORITY.FORMAT_AND_LINT_PRIMARY,
     async run(ctx) {
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "rubocop");
         const policy = getLinterPolicyForCwd(ctx.filePath, cwd);
         if (policy && !policy.preferredRunners.includes("rubocop")) {
             return { status: "skipped", diagnostics: [], semantic: "none" };

package/node_modules/pi-lens/dist/clients/dispatch/runners/ruff.js

@@ -11,7 +11,7 @@ import { stripAnsi } from "../../sanitize.js";
 import { getAutofixCapability, getLinterPolicyForCwd, ruffConfigArgs, } from "../../tool-policy.js";
 import { PRIORITY } from "../priorities.js";
 import { parseRuffOutput } from "./utils/diagnostic-parsers.js";
-import { createAvailabilityChecker, resolveAvailableOrInstall, } from "./utils/runner-helpers.js";
+import { createAvailabilityChecker, resolveAvailableOrInstall, resolveRunnerCwd, } from "./utils/runner-helpers.js";
 const ruff = createAvailabilityChecker("ruff", ".exe");
 function parseRuffJson(raw, filePath) {
     try {
@@ -50,7 +50,7 @@ const ruffRunner = {
     appliesTo: ["python"],
     priority: PRIORITY.FORMAT_AND_LINT_PRIMARY,
     async run(ctx) {
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "ruff");
         const policy = getLinterPolicyForCwd(ctx.filePath, cwd);
         if (policy && !policy.preferredRunners.includes("ruff-lint")) {
             return { status: "skipped", diagnostics: [], semantic: "none" };

package/node_modules/pi-lens/dist/clients/dispatch/runners/rust-clippy.js

@@ -3,14 +3,15 @@
  *
  * Runs `cargo clippy` for Rust files to catch common mistakes.
  */
-import { dirname, isAbsolute, join, resolve } from "node:path";
-import { findNearestContaining } from "../../path-utils.js";
+import { existsSync } from "node:fs";
+import { isAbsolute, join, resolve } from "node:path";
 import { rustClient } from "../../rust-client.js";
 import { safeSpawnAsync } from "../../safe-spawn.js";
 import { stripAnsi } from "../../sanitize.js";
 import { getLazyInstallAttempt, tryLazyInstall, } from "./utils/lazy-installer.js";
 import { describeInstallAttempt, logAvailabilityDecision, } from "./utils/availability-policy.js";
 import { PRIORITY } from "../priorities.js";
+import { resolveRunnerCwd } from "../../tool-cwd.js";
 import { createCwdCachedProbe } from "./utils/runner-helpers.js";
 // Cached per-cwd `cargo clippy --version` probe (#120). Before this, the
 // probe fired on every Rust file save in a project where clippy was already
@@ -89,15 +90,20 @@ const rustClippyRunner = {
                 return { status: "skipped", diagnostics: [], semantic: "none" };
             }
         }
-        // Find the package root (where Cargo.toml is)
-        const cargoToml = findCargoToml(ctx.filePath);
-        if (!cargoToml) {
+        // The package root (where Cargo.toml is), through the shared cwd seam
+        // (#2894): `RUNNER_MARKERS["rust-clippy"]` is `["Cargo.toml"]`, so this
+        // IS the walk this runner used to do with `findNearestContaining` — plus
+        // the seam's dispatch-root and `$HOME` ceilings, which the hand-rolled
+        // walk had neither of. The gate then asks about exactly the directory
+        // cargo will run in, rather than about a separately-derived one.
+        const cargoDir = resolveRunnerCwd(ctx, "rust-clippy");
+        if (!existsSync(join(cargoDir, "Cargo.toml"))) {
             return { status: "skipped", diagnostics: [], semantic: "none" };
         }
         // Run cargo clippy on the package
         const result = await safeSpawnAsync(cargoExe, ["clippy", "--message-format=json", "-q"], {
             timeout: 60000,
-            cwd: cargoToml.replace("Cargo.toml", ""),
+            cwd: cargoDir,
         });
         const raw = stripAnsi(result.stdout + result.stderr);
         if (result.status === 0 && !raw.trim()) {
@@ -105,7 +111,6 @@ const rustClippyRunner = {
         }
         // Parse JSON output. span.file is relative to the package root, so pass
         // the cargo dir to resolve diagnostics to absolute paths for filtering.
-        const cargoDir = cargoToml.replace("Cargo.toml", "");
         const allDiagnostics = parseClippyOutput(raw, ctx.filePath, cargoDir);
         if (allDiagnostics.length === 0) {
             // Non-parseable output
@@ -134,10 +139,6 @@ const rustClippyRunner = {
         };
     },
 };
-function findCargoToml(filePath) {
-    const dir = findNearestContaining(dirname(filePath), ["Cargo.toml"]);
-    return dir ? join(dir, "Cargo.toml") : undefined;
-}
 /**
  * #1802 fix round: the original review claimed rustc/clippy's top-level
  * `compiler-message.level` is genuinely two-valued (error/warning). A live

package/node_modules/pi-lens/dist/clients/dispatch/runners/shellcheck.js

@@ -22,6 +22,7 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { safeSpawnAsync } from "../../safe-spawn.js";
+import { resolveRunnerCwd } from "../../tool-cwd.js";
 import { PRIORITY } from "../priorities.js";
 import { createAvailabilityChecker, lspPrimaryCoversFile, resolveAvailableOrInstall, } from "./utils/runner-helpers.js";
 import { finishParsedRun } from "./utils/tool-failure.js";
@@ -110,7 +111,7 @@ const shellcheckRunner = {
     priority: PRIORITY.GENERAL_ANALYSIS,
     skipTestFiles: false, // Shell scripts in test directories should still be checked
     async run(ctx) {
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "shellcheck");
         // #233: bash-language-server runs shellcheck internally. When the `bash` LSP
         // covers this file AND shellcheck is on PATH (so the LSP actually emits its
         // findings), the warm server already produces these diagnostics — skip the

package/node_modules/pi-lens/dist/clients/dispatch/runners/shfmt.js

@@ -1,6 +1,7 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { safeSpawnAsync } from "../../safe-spawn.js";
+import { resolveRunnerCwd } from "../../tool-cwd.js";
 import { PRIORITY } from "../priorities.js";
 import { createAvailabilityChecker, resolveAvailableOrInstall, } from "./utils/runner-helpers.js";
 const shfmt = createAvailabilityChecker("shfmt", ".exe");
@@ -31,7 +32,7 @@ const shfmtRunner = {
     priority: PRIORITY.FORMAT_AND_LINT_PRIMARY,
     skipTestFiles: false,
     async run(ctx) {
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "shfmt");
         let cmd = null;
         if (await shfmt.isAvailableAsync(cwd)) {
             cmd = shfmt.getCommand(cwd);

package/node_modules/pi-lens/dist/clients/dispatch/runners/spellcheck.js

@@ -20,7 +20,7 @@
  */
 import { safeSpawnAsync } from "../../safe-spawn.js";
 import { PRIORITY } from "../priorities.js";
-import { createAvailabilityChecker } from "./utils/runner-helpers.js";
+import { createAvailabilityChecker, resolveRunnerCwd, } from "./utils/runner-helpers.js";
 import { parseToolRun } from "./utils/tool-failure.js";
 const typos = createAvailabilityChecker("typos", ".exe");
 // typos-cli exit codes: 0 = no typos, 2 = typos found, 1 = an error that
@@ -82,7 +82,7 @@ const spellcheckRunner = {
     priority: PRIORITY.DOC_QUALITY,
     skipTestFiles: false, // Check docs in test files too
     async run(ctx) {
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "spellcheck/typos");
         // Skip if typos-cli is not installed
         if (!(await typos.isAvailableAsync(cwd))) {
             return { status: "skipped", diagnostics: [], semantic: "none" };

package/node_modules/pi-lens/dist/clients/dispatch/runners/spotbugs.js

@@ -3,6 +3,7 @@ import * as os from "node:os";
 import * as path from "node:path";
 import { BoundedLruCache } from "../../bounded-cache.js";
 import { safeSpawnAsync } from "../../safe-spawn.js";
+import { resolveRunnerCwd } from "../../tool-cwd.js";
 import { findCompiledClassesDir } from "../../tool-policy.js";
 import { PRIORITY } from "../priorities.js";
 import { createAvailabilityChecker, resolveAvailableOrInstall, } from "./utils/runner-helpers.js";
@@ -191,7 +192,7 @@ const spotbugsRunner = {
     appliesTo: ["java", "kotlin"],
     priority: PRIORITY.DEEP_LANGUAGE_ANALYSIS,
     async run(ctx) {
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "spotbugs");
         const classesDir = findCompiledClassesDir(cwd);
         if (!classesDir) {
             ctx.log?.("spotbugs: Java project detected but no compiled .class files found — run `mvn compile` / `gradle build` first");

package/node_modules/pi-lens/dist/clients/dispatch/runners/sqlfluff.js

@@ -1,4 +1,5 @@
 import { safeSpawnAsync } from "../../safe-spawn.js";
+import { logRunnerAdvisoryOnce, resolveRunnerCwd } from "../../tool-cwd.js";
 import { getLinterPolicyForCwd, hasSqlfluffConfig } from "../../tool-policy.js";
 import { PRIORITY } from "../priorities.js";
 import { createAvailabilityChecker, resolveToolCommandWithInstallFallback, } from "./utils/runner-helpers.js";
@@ -117,14 +118,14 @@ const sqlfluffRunner = {
     priority: PRIORITY.SQL_LINT,
     skipTestFiles: false,
     async run(ctx) {
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "sqlfluff");
         const policy = getLinterPolicyForCwd(ctx.filePath, cwd);
         if (policy && !policy.preferredRunners.includes("sqlfluff")) {
             return { status: "skipped", diagnostics: [], semantic: "none" };
         }
         const hasConfig = hasSqlfluffConfig(cwd);
         if (!hasConfig) {
-            ctx.log("sqlfluff: no config detected, using ANSI dialect defaults");
+            logRunnerAdvisoryOnce(ctx, "sqlfluff", cwd, "sqlfluff: no config detected, using ANSI dialect defaults");
         }
         let cmd = null;
         if (await sqlfluff.isAvailableAsync(cwd)) {

package/node_modules/pi-lens/dist/clients/dispatch/runners/stylelint.js

@@ -1,5 +1,6 @@
 import * as path from "node:path";
 import { safeSpawnAsync } from "../../safe-spawn.js";
+import { logRunnerAdvisoryOnce, resolveRunnerCwd } from "../../tool-cwd.js";
 import { getLinterPolicyForCwd, hasStylelintConfig, } from "../../tool-policy.js";
 import { PRIORITY } from "../priorities.js";
 import { createAvailabilityChecker, resolveToolCommandWithInstallFallback, } from "./utils/runner-helpers.js";
@@ -116,7 +117,7 @@ const stylelintRunner = {
     priority: PRIORITY.FORMAT_AND_LINT_PRIMARY,
     skipTestFiles: false,
     async run(ctx) {
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "stylelint");
         const policy = getLinterPolicyForCwd(ctx.filePath, cwd);
         if (policy && !policy.preferredRunners.includes("stylelint")) {
             return { status: "skipped", diagnostics: [], semantic: "none" };
@@ -124,7 +125,7 @@ const stylelintRunner = {
         const fileDir = path.dirname(path.resolve(cwd, ctx.filePath));
         const hasConfig = hasStylelintConfig(fileDir) || hasStylelintConfig(cwd);
         if (!hasConfig) {
-            ctx.log("stylelint: no config detected, running with default rules");
+            logRunnerAdvisoryOnce(ctx, "stylelint", cwd, "stylelint: no config detected, running with default rules");
         }
         let cmd = null;
         if (await stylelint.isAvailableAsync(cwd)) {

package/node_modules/pi-lens/dist/clients/dispatch/runners/swiftlint.js

@@ -1,5 +1,6 @@
 import * as path from "node:path";
 import { safeSpawnAsync } from "../../safe-spawn.js";
+import { resolveRunnerCwd } from "../../tool-cwd.js";
 import { PRIORITY } from "../priorities.js";
 import { createAvailabilityChecker, resolveToolCommandWithInstallFallback, } from "./utils/runner-helpers.js";
 import { parseToolRun } from "./utils/tool-failure.js";
@@ -115,7 +116,7 @@ const swiftlintRunner = {
     priority: PRIORITY.GENERAL_ANALYSIS,
     skipTestFiles: false,
     async run(ctx) {
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "swiftlint");
         let cmd = null;
         if (await swiftlint.isAvailableAsync(cwd)) {
             cmd = swiftlint.getCommand(cwd);

package/node_modules/pi-lens/dist/clients/dispatch/runners/taplo.js

@@ -1,6 +1,7 @@
 import * as path from "node:path";
 import { findLocalBinUpwards } from "../../package-manager.js";
 import { safeSpawnAsync } from "../../safe-spawn.js";
+import { resolveRunnerCwd } from "../../tool-cwd.js";
 import { getLinterPolicyForCwd } from "../../tool-policy.js";
 import { PRIORITY } from "../priorities.js";
 import { createAvailabilityChecker, lspPrimaryCoversFile, resolveToolCommandWithInstallFallback, } from "./utils/runner-helpers.js";
@@ -106,7 +107,7 @@ const taploRunner = {
     priority: PRIORITY.FORMAT_AND_LINT_PRIMARY,
     skipTestFiles: false,
     async run(ctx) {
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "taplo");
         const policy = getLinterPolicyForCwd(ctx.filePath, cwd);
         if (policy && !policy.preferredRunners.includes("taplo")) {
             return { status: "skipped", diagnostics: [], semantic: "none" };

package/node_modules/pi-lens/dist/clients/dispatch/runners/terragrunt.js

@@ -1,5 +1,6 @@
 import * as path from "node:path";
 import { safeSpawnAsync } from "../../safe-spawn.js";
+import { resolveRunnerCwd } from "../../tool-cwd.js";
 import { pathsEqual } from "../../path-utils.js";
 import { getLinterPolicyForCwd } from "../../tool-policy.js";
 import { PRIORITY } from "../priorities.js";
@@ -128,7 +129,7 @@ const terragruntRunner = {
     priority: PRIORITY.GENERAL_ANALYSIS,
     skipTestFiles: false,
     async run(ctx) {
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "terragrunt");
         const policy = getLinterPolicyForCwd(ctx.filePath, cwd);
         if (policy && !policy.preferredRunners.includes("terragrunt"))
             return SKIPPED;

package/node_modules/pi-lens/dist/clients/dispatch/runners/tflint.js

@@ -1,5 +1,6 @@
 import * as path from "node:path";
 import { safeSpawnAsync } from "../../safe-spawn.js";
+import { resolveRunnerCwd } from "../../tool-cwd.js";
 import { getLinterPolicyForCwd } from "../../tool-policy.js";
 import { findNearestDirWithAnyBasename } from "../../workspace-topology.js";
 import { PRIORITY } from "../priorities.js";
@@ -52,7 +53,7 @@ const tflintRunner = {
     priority: PRIORITY.GENERAL_ANALYSIS,
     skipTestFiles: false,
     async run(ctx) {
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "tflint");
         const policy = getLinterPolicyForCwd(ctx.filePath, cwd);
         if (policy && !policy.preferredRunners.includes("tflint")) {
             return { status: "skipped", diagnostics: [], semantic: "none" };

package/node_modules/pi-lens/dist/clients/dispatch/runners/trivy-config.js

@@ -40,6 +40,7 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import { incrementDegradationCount } from "../../degradation-ledger.js";
 import { safeSpawnAsync } from "../../safe-spawn.js";
+import { resolveRunnerCwd } from "../../tool-cwd.js";
 import { isTrivyEnabled, resolveSeverityFloor, } from "../../trivy-client.js";
 import { PRIORITY } from "../priorities.js";
 import { createAvailabilityChecker, resolveAvailableOrInstall, } from "./utils/runner-helpers.js";
@@ -148,7 +149,7 @@ const trivyConfigRunner = {
     priority: PRIORITY.GENERAL_ANALYSIS,
     skipTestFiles: false,
     async run(ctx) {
-        const cwd = ctx.cwd || process.cwd();
+        const cwd = resolveRunnerCwd(ctx, "trivy-config");
         // Single opt-in switch — trivy is opt-in across all modes.
         if (!isTrivyEnabled(cwd)) {
             return { status: "skipped", diagnostics: [], semantic: "none" };

package/node_modules/pi-lens/dist/clients/dispatch/runners/utils/availability-policy.js

@@ -75,6 +75,11 @@ export function describeInstallAttempt(attempt, options = {}) {
             return { install: "succeeded", ...(reason && { installReason: reason }) };
         case "failed":
             return { install: "failed", ...(reason && { installReason: reason }) };
+        case "unavailable":
+            return {
+                install: "unavailable",
+                ...(reason && { installReason: reason }),
+            };
         default:
             return {
                 install: "not-attempted",

package/node_modules/pi-lens/dist/clients/dispatch/runners/utils/candidate-probe.js

@@ -11,7 +11,7 @@
  * Complexity limit. This is that sweep, written once.
  */
 import * as fs from "node:fs";
-import { safeSpawnAsync } from "../../../safe-spawn.js";
+import { probeToolAsync } from "../../../tool-probe.js";
 import { classifyProbeFailure, startHostStallSampler, } from "./availability-policy.js";
 /**
  * Walk `candidates` in order. A candidate containing a path separator is
@@ -45,7 +45,7 @@ export async function probeAvailabilityCandidates(candidates, probeArgs, timeout
             let result;
             let stallMs;
             try {
-                result = await safeSpawnAsync(candidate, [...probeArgs], {
+                result = await probeToolAsync(candidate, probeArgs, {
                     timeout: timeoutMs,
                 });
             }

package/node_modules/pi-lens/dist/clients/dispatch/runners/utils/runner-helpers.js

@@ -20,9 +20,11 @@ import { getServersForFileWithConfig, isServerDisabled, } from "../../../lsp/con
 import { findGlobalBinary, findLocalBinAt, findLocalBinsUpwards, findLocalBinUpwards, VENDOR_BIN_DIRS, VENV_BIN_DIRS, } from "../../../package-manager.js";
 import { logLatency } from "../../../latency-logger.js";
 import { safeSpawnAsync } from "../../../safe-spawn.js";
+import { probeToolAsync } from "../../../tool-probe.js";
 import { compareOrdinal } from "../../../string-utils.js";
 import { getToolCommandSpec, shouldAutoInstallTool, } from "../../../tool-policy.js";
 import { isInSpawnTimeoutCooldown } from "../../../spawn-timeout-cooldown.js";
+import { resolveToolCwd } from "../../../tool-cwd.js";
 import { createAvailabilityProbeFlight } from "../../../availability-probe-flight.js";
 import { classifyProbeFailure, createAvailabilityLatch, describeInstallAttempt, describeProbeEvidence, isLatchingOutcome, logAvailabilityDecision, startHostStallSampler, transientRetryDelayMs, } from "./availability-policy.js";
 export { createAvailabilityLatch, classifyProbeFailure, describeProbeEvidence, describeUnavailability, isTransientDecision, logAvailabilityDecision, startHostStallSampler, } from "./availability-policy.js";
@@ -1390,7 +1392,7 @@ async function probeAstGrepCommandAsync(cmd, argsPrefix = []) {
     let check;
     let hostStallMs;
     try {
-        check = await safeSpawnAsync(cmd, [...argsPrefix, "--version"], {
+        check = await probeToolAsync(cmd, [...argsPrefix, "--version"], {
             timeout: 5000,
         });
     }
@@ -1674,7 +1676,7 @@ export async function resolveLocalFirstAsync(toolName, cwd, windowsExt = ".cmd")
     if (globalBin)
         return { cmd: globalBin, args: [] };
     // 3. Global PATH (already installed system-wide, on PATH)
-    const globalCheck = await safeSpawnAsync(toolName, ["--version"], {
+    const globalCheck = await probeToolAsync(toolName, ["--version"], {
         timeout: 3000,
     });
     if (!globalCheck.error && globalCheck.status === 0) {
@@ -1693,3 +1695,7 @@ export const sg = {
     isAvailableAsync: isSgAvailableAsync,
     getCommand: getSgCommand,
 };
+/** Shared cwd seam for runner probes and analysis children (#2777). */
+export function resolveRunnerCwd(ctx, tool) {
+    return resolveToolCwd("runner", tool, ctx.filePath, ctx);
+}