@herbertgao/pi-extensions 2026.8.4 → 2026.8.6

package/node_modules/pi-lens/dist/clients/tool-policy.js

@@ -1,8 +1,30 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
+import { TERRAGRUNT_FILENAMES } from "./file-kinds.js";
 import { logLatency } from "./latency-logger.js";
+import { resolvePackagePath } from "./package-root.js";
 import { findNearestContaining, walkUpDirs } from "./path-utils.js";
-import { loadProjectSnapshot } from "./project-snapshot.js";
+import { loadProjectSnapshotWithoutWordIndex } from "./project-snapshot.js";
+// Extension → formatter policy. This map, `FORMATTER_POLICY_BY_FILENAME`, and
+// `AUTO_INSTALLABLE_DEFAULT_FORMATTERS` are the inverse of the formatter
+// definitions in `clients/formatters.ts` (formatter → extensions). The two are
+// bound by `tests/clients/formatter-policy-consistency.test.ts` (#1135, the
+// #883/#209 single-source-of-truth class) so they cannot drift silently. All
+// three are re-exported (read-only intent) via a single `export {}` below —
+// deliberately NOT inline on these declarations, to keep the pre-existing,
+// structural lookup-table duplication out of the PR's "new code" (SonarCloud).
+//
+// Two deliberate #1135 decisions live in the entries below, documented here so
+// the rationale sits outside the duplicated run:
+//   - `.sass` offers ["biome", "prettier"] only — NOT oxfmt: oxfmt is absent
+//     from OXFMT_SUPPORTED_EXTENSIONS (oxfmt/prettier handle .css/.scss/.less,
+//     not the indented `.sass` syntax). It was previously hand-listed here,
+//     diverging from the oxfmt definition (inert, because `matching` filtered
+//     it out); dropped to bind the two.
+//   - `.fish` intentionally has NO entry. `fish-indent` is a LINT runner
+//     (getLinterPolicyForFile), not a FormatterInfo — a formatter policy naming
+//     it was a dead, unsatisfiable entry; fish reformatting runs via the
+//     linter/autofix path. Removed to keep extension→formatter consistent.
 const FORMATTER_POLICY_BY_EXTENSION = new Map([
     [
         ".js",
@@ -133,7 +155,8 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
     [
         ".sass",
         {
-            formatterNames: ["biome", "prettier", "oxfmt"],
+            // #1135: no oxfmt (see map header comment).
+            formatterNames: ["biome", "prettier"],
             defaultFormatter: "biome",
             defaultWhenUnconfigured: true,
             gate: "smart-default",
@@ -230,7 +253,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["ktfmt", "ktlint"],
             defaultFormatter: "ktlint",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -239,7 +262,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["ktfmt", "ktlint"],
             defaultFormatter: "ktlint",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -248,7 +271,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["swiftformat"],
             defaultFormatter: "swiftformat",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -257,7 +280,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["fantomas"],
             defaultFormatter: "fantomas",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -266,7 +289,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["fantomas"],
             defaultFormatter: "fantomas",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -275,7 +298,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["fantomas"],
             defaultFormatter: "fantomas",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -284,7 +307,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["nixfmt"],
             defaultFormatter: "nixfmt",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -293,7 +316,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["mix"],
             defaultFormatter: "mix",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -302,7 +325,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["mix"],
             defaultFormatter: "mix",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -311,7 +334,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["mix"],
             defaultFormatter: "mix",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -320,7 +343,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["mix"],
             defaultFormatter: "mix",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -329,7 +352,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["mix"],
             defaultFormatter: "mix",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -419,7 +442,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["csharpier"],
             defaultFormatter: "csharpier",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -437,7 +460,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["ormolu"],
             defaultFormatter: "ormolu",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -446,7 +469,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["ormolu"],
             defaultFormatter: "ormolu",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -504,21 +527,12 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
             gate: "smart-default",
         },
     ],
-    [
-        ".fish",
-        {
-            formatterNames: ["fish-indent"],
-            defaultFormatter: "fish-indent",
-            defaultWhenUnconfigured: true,
-            gate: "smart-default",
-        },
-    ],
     [
         ".toml",
         {
             formatterNames: ["taplo"],
             defaultFormatter: "taplo",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -527,7 +541,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["terraform"],
             defaultFormatter: "terraform",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -536,7 +550,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["terraform"],
             defaultFormatter: "terraform",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -617,7 +631,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["psscriptanalyzer-format"],
             defaultFormatter: "psscriptanalyzer-format",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -626,7 +640,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["psscriptanalyzer-format"],
             defaultFormatter: "psscriptanalyzer-format",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -635,7 +649,7 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
         {
             formatterNames: ["psscriptanalyzer-format"],
             defaultFormatter: "psscriptanalyzer-format",
-            defaultWhenUnconfigured: true,
+            defaultWhenUnconfigured: false,
             gate: "smart-default",
         },
     ],
@@ -643,10 +657,15 @@ const FORMATTER_POLICY_BY_EXTENSION = new Map([
 // oxfmt supports these extensions — registered as a candidate formatter for each.
 // Using a post-processing pass avoids repeating the same modification across
 // many map entries (and keeps SonarCloud's duplication gate happy).
-const OXFMT_SUPPORTED_EXTENSIONS = new Set([
+// This is the SINGLE SOURCE OF TRUTH for oxfmt's supported extensions — do not
+// hand-maintain a second copy; `clients/formatters.ts`'s `oxfmtFormatter.extensions`
+// imports and spreads this same Set (#1134; previously two parallel hand-maintained
+// lists, the #883 single-source-of-truth class).
+export const OXFMT_SUPPORTED_EXTENSIONS = new Set([
     ".js", ".jsx", ".mjs", ".cjs",
     ".ts", ".tsx", ".mts", ".cts",
     ".vue",
+    ".svelte",
     ".css", ".scss", ".less",
     ".html", ".htm",
     ".json", ".jsonc",
@@ -662,6 +681,22 @@ FORMATTER_POLICY_BY_EXTENSION.set(".vue", {
     defaultWhenUnconfigured: false,
     gate: "config-first",
 });
+// Add .svelte entry (no prior formatter policy existed for this extension —
+// docs/language-coverage.md previously listed no formatter). oxfmt is the only
+// candidate; the loop below appends it since ".svelte" is in
+// OXFMT_SUPPORTED_EXTENSIONS. Unlike the other oxfmt extensions, oxfmt's
+// .svelte support is conditional on more than "a config file exists" — see
+// `hasOxfmtSvelteConfig` below, gated in `formatters.ts`'s
+// `hasExplicitFormatterConfig` (verified empirically against the real oxfmt
+// npm binary; oxfmt exits non-zero on .svelte without BOTH the `svelte`
+// package installed and the config's `svelte` flag enabled — an unconditional
+// offer would guarantee a formatter failure, not a no-op).
+FORMATTER_POLICY_BY_EXTENSION.set(".svelte", {
+    formatterNames: [],
+    defaultFormatter: "oxfmt",
+    defaultWhenUnconfigured: false,
+    gate: "config-first",
+});
 for (const [ext, policy] of FORMATTER_POLICY_BY_EXTENSION) {
     if (OXFMT_SUPPORTED_EXTENSIONS.has(ext) && !policy.formatterNames.includes("oxfmt")) {
         policy.formatterNames.push("oxfmt");
@@ -675,10 +710,30 @@ const AUTO_INSTALLABLE_DEFAULT_FORMATTERS = new Map([
     ["taplo", "taplo"],
     ["ktlint", "ktlint"],
 ]);
+// `gate: "smart-default"` so a matched file is formatted only when nothing else
+// claims it. Misdetection edge: `root.hcl` is filename-detected as terragrunt, so
+// a non-terragrunt `root.hcl` gets smart-default formatted with `terragrunt hcl
+// fmt`'s generic HCL canonicalization — a soft outcome (canonical HCL, no config
+// semantics assumed), not a hard failure.
+const TERRAGRUNT_FORMATTER_POLICY = {
+    formatterNames: ["terragrunt-hcl"],
+    defaultFormatter: "terragrunt-hcl",
+    defaultWhenUnconfigured: true,
+    gate: "smart-default",
+};
+const FORMATTER_POLICY_BY_FILENAME = new Map(TERRAGRUNT_FILENAMES.map((name) => [name, TERRAGRUNT_FORMATTER_POLICY]));
+// Re-exported (read-only intent) for the #1135 drift guard. Kept as a single
+// separate statement — NOT inline on the declarations above — so the touched
+// lines don't fall at the head of the pre-existing lookup-table duplication and
+// get counted as new duplicated code. Bindings are live, so position is safe.
+export { AUTO_INSTALLABLE_DEFAULT_FORMATTERS, FORMATTER_POLICY_BY_EXTENSION, FORMATTER_POLICY_BY_FILENAME, };
 export function getFormatterPolicyForExtension(ext) {
     return FORMATTER_POLICY_BY_EXTENSION.get(ext.toLowerCase());
 }
 export function getFormatterPolicyForFile(filePath) {
+    const byFilename = FORMATTER_POLICY_BY_FILENAME.get(path.basename(filePath).toLowerCase());
+    if (byFilename)
+        return byFilename;
     return getFormatterPolicyForExtension(path.extname(filePath));
 }
 export function getSmartDefaultFormatterName(filePath) {
@@ -773,8 +828,21 @@ const AUTOFIX_CAPABILITIES = new Map([
     ],
 ]);
 const TOOL_EXECUTION_POLICY = new Map([
+    // Dispatch/LSP runners use the shared availability/install seam. These
+    // managed tools are missing-command repair candidates; probe failures still
+    // fail closed before this policy is consulted.
+    ["pyright", { gate: "smart-default", autoInstall: true }],
+    ["shellcheck", { gate: "smart-default", autoInstall: true }],
+    ["shfmt", { gate: "smart-default", autoInstall: true }],
+    ["tflint", { gate: "smart-default", autoInstall: true }],
+    ["terragrunt", { gate: "smart-default", autoInstall: true }],
+    ["trivy", { gate: "config-first", autoInstall: true }],
     ["biome", { gate: "smart-default", autoInstall: true }],
     ["ruff", { gate: "smart-default", autoInstall: true }],
+    ["jscpd", { gate: "smart-default", autoInstall: true }],
+    ["madge", { gate: "smart-default", autoInstall: true }],
+    ["knip", { gate: "smart-default", autoInstall: true }],
+    ["ast-grep", { gate: "smart-default", autoInstall: true }],
     ["oxlint", { gate: "smart-default", autoInstall: true }],
     ["stylelint", { gate: "smart-default", autoInstall: true }],
     ["sqlfluff", { gate: "smart-default", autoInstall: true }],
@@ -785,6 +853,7 @@ const TOOL_EXECUTION_POLICY = new Map([
     ["mypy", { gate: "config-first", autoInstall: true }],
     ["taplo", { gate: "smart-default", autoInstall: true }],
     ["hadolint", { gate: "smart-default", autoInstall: true }],
+    ["helm", { gate: "smart-default", autoInstall: true }],
     ["htmlhint", { gate: "smart-default", autoInstall: true }],
     ["ktlint", { gate: "smart-default", autoInstall: true }],
     // ktfmt is opt-in (a project's explicit formatting choice), so it only runs
@@ -1096,8 +1165,8 @@ export function getLinterPolicyForFile(filePath, context = {}) {
             runnerNames: ["sqlfluff"],
             preferredRunners: ["sqlfluff"],
             defaultRunner: "sqlfluff",
-            defaultWhenUnconfigured: true,
-            gate: "smart-default",
+            defaultWhenUnconfigured: false,
+            gate: "config-first",
         };
     }
     if ([".rb", ".rake", ".gemspec", ".ru"].includes(ext)) {
@@ -1145,6 +1214,15 @@ export function getLinterPolicyForFile(filePath, context = {}) {
             gate: "smart-default",
         };
     }
+    if (TERRAGRUNT_FILENAMES.includes(path.basename(filePath).toLowerCase())) {
+        return {
+            runnerNames: ["terragrunt"],
+            preferredRunners: ["terragrunt"],
+            defaultRunner: "terragrunt",
+            defaultWhenUnconfigured: true,
+            gate: "smart-default",
+        };
+    }
     if ([".kt", ".kts"].includes(ext)) {
         // When the project opts into ktfmt, ktfmt (a pure formatter wired as a safe
         // autofix) owns Kotlin formatting; ktlint's lint steps aside so its style
@@ -1227,7 +1305,7 @@ export function getLinterPolicyForFile(filePath, context = {}) {
             preferredRunners: ["tflint"],
             defaultRunner: "tflint",
             defaultWhenUnconfigured: true,
-            gate: "smart-default",
+            gate: context.hasTflintConfig ? "config-first" : "smart-default",
         };
     }
     if ([".ex", ".exs", ".eex", ".heex", ".leex"].includes(ext)) {
@@ -1296,7 +1374,7 @@ export function getLinterPolicyForFile(filePath, context = {}) {
  * start / project-seq bumps rather than on every read.
  */
 export function getCachedProjectConventions(cwd) {
-    const snapshot = loadProjectSnapshot(cwd);
+    const snapshot = loadProjectSnapshotWithoutWordIndex(cwd);
     return snapshot?.conventions;
 }
 export function getLinterPolicyForCwd(filePath, cwd) {
@@ -1314,6 +1392,9 @@ export function getLinterPolicyForCwd(filePath, cwd) {
         hasMypyConfig: hasMypyConfig(cwd),
         hasDetektConfig: hasDetektConfig(cwd),
         hasKtfmtConfig: hasKtfmtConfig(cwd),
+        // From the file's directory, not cwd: a `.tflint.hcl` in a terraform
+        // subdirectory is invisible to an upward walk that starts at the repo root.
+        hasTflintConfig: hasTflintConfig(path.dirname(path.resolve(cwd, filePath))),
     };
     const policy = getLinterPolicyForFile(filePath, context);
     if (policy) {
@@ -1372,6 +1453,7 @@ export function getAutofixPolicyForFile(filePath, context = {}) {
             defaultWhenUnconfigured: true,
             gate: "smart-default",
             safe: true,
+            scope: "cargo-project",
         };
     }
     if ([".json", ".jsonc"].includes(ext)) {
@@ -1412,8 +1494,8 @@ export function getAutofixPolicyForFile(filePath, context = {}) {
             toolNames: ["sqlfluff"],
             preferredTools: ["sqlfluff"],
             defaultTool: "sqlfluff",
-            defaultWhenUnconfigured: true,
-            gate: "smart-default",
+            defaultWhenUnconfigured: false,
+            gate: "config-first",
             safe: true,
         };
     }
@@ -1428,6 +1510,16 @@ export function getAutofixPolicyForFile(filePath, context = {}) {
         };
     }
     if ([".kt", ".kts"].includes(ext)) {
+        if (context.hasKtlintConfig) {
+            return {
+                toolNames: ["ktlint", "ktfmt", "detekt"],
+                preferredTools: ["ktlint"],
+                defaultTool: "ktlint",
+                defaultWhenUnconfigured: false,
+                gate: "config-first",
+                safe: true,
+            };
+        }
         // ktfmt is config-first and the project's explicit formatting choice, so it
         // wins over both detekt and the ktlint smart-default when opted in (#129).
         if (context.hasKtfmtConfig) {
@@ -1504,6 +1596,7 @@ export function getAutofixPolicyForFile(filePath, context = {}) {
             defaultWhenUnconfigured: true,
             gate: "smart-default",
             safe: true,
+            scope: "dart-project",
         };
     }
     return undefined;
@@ -1625,6 +1718,69 @@ export function hasOxfmtConfig(cwd) {
     }
     return false;
 }
+// Empirically verified against the real `oxfmt` npm package (0.62.0), a
+// scratch fixture, and a plain `Component.svelte` — see PR body for the full
+// four-cell matrix. Both conditions are required; either alone always fails:
+//   - no `svelte` package, no config flag  -> exit 2 ("excluded by ignore rules")
+//   - no `svelte` package, config flag on  -> exit 2 ("Cannot find module 'svelte/compiler'")
+//   - `svelte` package installed, no flag  -> exit 2 ("excluded by ignore rules")
+//   - `svelte` package installed, flag on  -> exit 0, formats the file
+// Per https://oxc.rs/docs/guide/usage/formatter/language-support.html, oxfmt
+// also requires the npm-distributed binary (not the standalone GitHub-release
+// binary) for `.svelte` — pi-lens already resolves oxfmt via `findInNodeModules`/
+// `which`, which favors the npm-installed binary, so that requirement is not
+// separately re-checked here.
+//
+// Known limits of this line-match heuristic (#1134 P3 tail 1): it tolerates a
+// trailing `#`-comment after the value (`svelte = true  # enable`), but it is
+// NOT a real TOML parser — a `svelte = true` occurrence nested under a
+// `[table]` section, or one embedded inside a multi-line/triple-quoted string
+// value, would still match and false-positive. Both are considered acceptable
+// risk: an oxfmt.toml sectioning `svelte` under a table is not a realistic
+// config shape for this single top-level boolean key, and a false positive
+// here only causes oxfmt to be OFFERED (still gated by oxfmt actually running
+// and the `svelte` package check above), never a silent formatter failure.
+const OXFMT_SVELTE_TOML_TRUE = /(^|\n)\s*svelte\s*=\s*true\s*(\s*#.*)?(\r?\n|$)/;
+export function hasOxfmtSvelteConfig(cwd) {
+    // Monorepo asymmetry (#1134 P3 tail 2): this dependency check stops at the
+    // NEAREST package.json (`hasNearestPackageJsonDependency`), while the
+    // config walk below (`walkUpDirs`) continues all the way to the repo root.
+    // A root-level `svelte` dependency combined with an oxfmt config at the
+    // root, but invoked with a sub-package `cwd` that has its own
+    // (svelte-less) package.json, under-offers oxfmt for that sub-package —
+    // the same nearest-vs-root-walk asymmetry as the `.tflint.hcl` note in
+    // `getLinterPolicyForCwd` above. This is untested/deliberately unfixed:
+    // failing to offer a valid formatter is safe (never mis-offers one that
+    // then fails at runtime), unlike the inverse.
+    if (!hasNearestPackageJsonDependency(cwd, "svelte"))
+        return false;
+    for (const dir of walkUpDirs(cwd)) {
+        const rcPath = path.join(dir, ".oxfmtrc.json");
+        if (fs.existsSync(rcPath)) {
+            try {
+                const cfg = JSON.parse(fs.readFileSync(rcPath, "utf-8"));
+                if (cfg.svelte === true)
+                    return true;
+            }
+            catch { }
+        }
+        // oxfmt.toml is TOML; pi-lens has no TOML parser dependency, so this is
+        // a targeted line match for the single boolean key rather than a full
+        // parse (same pragmatic style as hasVitePlusConfig's content.includes
+        // check above) — presence of the file alone is NOT sufficient, since a
+        // TOML config can omit `svelte` or set it false.
+        const tomlPath = path.join(dir, "oxfmt.toml");
+        if (fs.existsSync(tomlPath)) {
+            try {
+                const content = fs.readFileSync(tomlPath, "utf-8");
+                if (OXFMT_SVELTE_TOML_TRUE.test(content))
+                    return true;
+            }
+            catch { }
+        }
+    }
+    return false;
+}
 export function hasStylelintConfig(cwd) {
     for (const dir of walkUpDirs(cwd)) {
         if (STYLELINT_CONFIGS.some((cfg) => fs.existsSync(path.join(dir, cfg)))) {
@@ -1832,9 +1988,61 @@ export function hasRuffConfig(cwd) {
     }
     return false;
 }
+/**
+ * Shared config-args seam for the markdownlint lint AND autofix surfaces
+ * (#1247). The lint runner (`markdownlint.ts`) and the autofix path
+ * (`pipeline.ts` `tryMarkdownlintFix`) MUST both consume this builder so the
+ * package-owned sensible-defaults config (`config/markdownlint/core.json`) can
+ * never drift apart from the bare `--fix` invocation again.
+ */
+/**
+ * Shared fallback shape for the config-args builders (#1247): when the
+ * project has its own config the lint/autofix surfaces pass NO args (the
+ * tool discovers it); otherwise both surfaces point at the package-owned
+ * fallback so the tool never silently runs its default ruleset. One shape
+ * here means the per-tool builders cannot drift from each other.
+ */
+function configArgsWithFallback(hasConfig, toolArgs, packageConfigPath) {
+    return hasConfig
+        ? []
+        : [...toolArgs, resolvePackagePath(import.meta.url, packageConfigPath)];
+}
+export function markdownlintConfigArgs(cwd) {
+    return configArgsWithFallback(hasMarkdownlintConfig(cwd), ["--config"], "config/markdownlint/core.json");
+}
+/**
+ * Shared config-args seam for the ruff lint AND autofix surfaces (#1247).
+ * The lint runner (`ruff.ts`) and `ruffClient.fixFileAsync` MUST both consume
+ * this builder so `config/ruff/core.toml` applies on `--fix` too.
+ */
+export function ruffConfigArgs(cwd) {
+    return configArgsWithFallback(hasRuffConfig(cwd), ["--config"], "config/ruff/core.toml");
+}
+/**
+ * Shared config-args seam for the biome lint AND autofix surfaces (#1247).
+ * The lint runner (`biome-check.ts`) and `biomeClient.fixFileAsync` MUST both
+ * consume this builder so the user's `biome.json(c)` — or the package-owned
+ * `config/biome/core.jsonc` fallback — applies on `lint --write` too.
+ */
+export function biomeConfigArgs(cwd) {
+    return [
+        "--config-path=" +
+            (getBiomeConfigPath(cwd) ??
+                resolvePackagePath(import.meta.url, "config/biome/core.jsonc")),
+    ];
+}
 export function hasGolangciConfig(cwd) {
     return findNearestContaining(cwd, GOLANGCI_CONFIGS) !== undefined;
 }
+// tflint ships built-in rules and runs without config, so `.tflint.hcl` is not
+// a prerequisite — it is the project electing tflint as its terraform linter,
+// which promotes the policy from smart-default to config-first. Takes a start
+// directory rather than the project cwd because tflint resolves config
+// per-directory: callers pass the EDITED FILE's directory so this agrees with
+// what the runner will actually hand tflint via `--config`.
+export function hasTflintConfig(startDir) {
+    return findNearestContaining(startDir, [".tflint.hcl"]) !== undefined;
+}
 export function hasClangFormatConfig(cwd) {
     return (findNearestContaining(cwd, [".clang-format", "_clang-format"]) !== undefined);
 }
@@ -1897,7 +2105,150 @@ const KTFMT_GRADLE_FILES = [
     "settings.gradle.kts",
     "settings.gradle",
 ];
+const KOTLIN_GRADLE_FILES = [
+    "build.gradle.kts",
+    "build.gradle",
+    "settings.gradle.kts",
+    "settings.gradle",
+];
+const spotlessKotlinConfigCache = new Map();
+let spotlessGradleReadCount = 0;
+/** Test-only observability for asserting the hot-path I/O bound. */
+export function _getSpotlessGradleReadCountForTests() {
+    return spotlessGradleReadCount;
+}
+/**
+ * Blank comments and quoted strings while preserving braces and newlines in
+ * executable Gradle source. This is deliberately a small lexical pre-pass,
+ * not a Groovy/Kotlin parser. In particular, statically disabled constructs
+ * such as `if (false) { ktlint() }` remain a documented false-positive.
+ */
+function stripGradleCommentsAndStrings(source) {
+    let result = "";
+    let state = "code";
+    let quote = "";
+    for (let index = 0; index < source.length; index += 1) {
+        const char = source[index];
+        const next = source[index + 1];
+        if (state === "code") {
+            if (char === "/" && next === "/") {
+                result += "  ";
+                index += 1;
+                state = "line-comment";
+            }
+            else if (char === "/" && next === "*") {
+                result += "  ";
+                index += 1;
+                state = "block-comment";
+            }
+            else if (char === '"' || char === "'") {
+                result += " ";
+                quote = char;
+                state = "string";
+            }
+            else {
+                result += char;
+            }
+            continue;
+        }
+        if (state === "line-comment") {
+            if (char === "\n" || char === "\r") {
+                result += char;
+                state = "code";
+            }
+            else {
+                result += " ";
+            }
+            continue;
+        }
+        if (state === "block-comment") {
+            if (char === "*" && next === "/") {
+                result += "  ";
+                index += 1;
+                state = "code";
+            }
+            else {
+                result += char === "\n" || char === "\r" ? char : " ";
+            }
+            continue;
+        }
+        if (char === "\\") {
+            result += " ";
+            if (index + 1 < source.length) {
+                result += source[index + 1] === "\n" ? "\n" : " ";
+                index += 1;
+            }
+        }
+        else if (char === quote) {
+            result += " ";
+            state = "code";
+        }
+        else {
+            result += char === "\n" || char === "\r" ? char : " ";
+        }
+    }
+    return result;
+}
+function namedGradleBlockBodies(source, name) {
+    const bodies = [];
+    const startPattern = new RegExp(`\\b${name}\\s*\\{`, "g");
+    for (const match of source.matchAll(startPattern)) {
+        const open = source.indexOf("{", match.index);
+        let depth = 1;
+        for (let index = open + 1; index < source.length; index += 1) {
+            if (source[index] === "{")
+                depth += 1;
+            if (source[index] === "}")
+                depth -= 1;
+            if (depth === 0) {
+                bodies.push(source.slice(open + 1, index));
+                break;
+            }
+        }
+    }
+    return bodies;
+}
+/**
+ * Resolve the formatter elected by a Spotless `kotlin { ... }` block.
+ * ktlint is the deterministic tie-break if a malformed project names both.
+ */
+export function getSpotlessKotlinFormatter(cwd) {
+    for (const dir of walkUpDirs(cwd)) {
+        for (const gradle of KOTLIN_GRADLE_FILES) {
+            const filePath = path.join(dir, gradle);
+            if (!fs.existsSync(filePath))
+                continue;
+            try {
+                const mtime = fs.statSync(filePath).mtimeMs;
+                let config = spotlessKotlinConfigCache.get(filePath);
+                if (!config || config.mtime !== mtime) {
+                    const source = stripGradleCommentsAndStrings(fs.readFileSync(filePath, "utf-8"));
+                    spotlessGradleReadCount += 1;
+                    const kotlinBodies = namedGradleBlockBodies(source, "spotless").flatMap((spotless) => namedGradleBlockBodies(spotless, "kotlin"));
+                    config = {
+                        mtime,
+                        ktlintConfig: kotlinBodies.some((body) => /\bktlint\s*\(/.test(body)),
+                        ktfmtConfig: kotlinBodies.some((body) => /\bktfmt\s*\(/.test(body)),
+                    };
+                    spotlessKotlinConfigCache.set(filePath, config);
+                }
+                if (config.ktlintConfig)
+                    return "ktlint";
+                if (config.ktfmtConfig)
+                    return "ktfmt";
+            }
+            catch { }
+        }
+    }
+    return undefined;
+}
+export function hasKtlintConfig(cwd) {
+    return getSpotlessKotlinFormatter(cwd) === "ktlint";
+}
 export function hasKtfmtConfig(cwd) {
+    const spotlessFormatter = getSpotlessKotlinFormatter(cwd);
+    if (spotlessFormatter)
+        return spotlessFormatter === "ktfmt";
     for (const dir of walkUpDirs(cwd)) {
         if (KTFMT_CONFIG_FILES.some((cfg) => fs.existsSync(path.join(dir, cfg))))
             return true;