@rtorcato/repo-tooling 3.38.2 → 3.38.3

package/AGENTS.md

@@ -98,6 +98,8 @@ npx @rtorcato/repo-tooling fix claude-skills --yes --json
 
 Fixers marked `explicitOnly` are exempt from `fix` all *and* from `fix --yes` — they only run when named as the target. Today that is `claude-skills`, the one fixer whose blast radius is outside the repo.
 
+The same goes for every `optional-missing` finding: a bulk `fix` records it `skipped`, because optional tools are often mutually exclusive (Biome / ESLint / Prettier / Oxlint, semantic-release / Changesets / Release Please) and installing them all is never the intent (#630). Name the one you want — `fix editorconfig --yes`.
+
 A fixer may also **refuse** — the target file holds something the generator cannot reproduce, so overwriting would destroy it. Today that is `dependabot` against a config with repo-local `ignore:` rules (#422), and `biome` against a `biome.json` that does not parse, whose settings cannot be merged (#587). A targeted `fix dependabot` then exits 1 with `error: dependabot-ignore-rules`; a bulk `fix --yes` records it `skipped` and carries on with the rest. Neither `--yes` nor `--json` overrides it — resolve the named rules by hand and re-run.
 
 ## Source-of-truth files in the repo

package/dist/cli/commands/fix.js

@@ -502,8 +502,10 @@ export async function fixCommand(target, options = {}) {
         if (!silent) {
             console.log(`  ${chalk.bold(result.check)} (${result.status}) → ${fixer.target}`);
         }
-        // Opt-in only — `--yes` must not sweep in a fixer that writes outside the repo.
-        if (fixer.explicitOnly) {
+        // Opt-in only — `--yes` must not sweep in a fixer that writes outside the repo,
+        // nor an optional tool: optional alternatives (Biome/ESLint/Prettier/Oxlint,
+        // semantic-release/Changesets/Release Please) are mutually exclusive (#630).
+        if (fixer.explicitOnly || result.status === 'optional-missing') {
             actions.push(recordFor(fixer.target, result.check, result.status, 'skipped', []));
             if (!silent) {
                 console.log(chalk.gray(`    skipped — run \`fix ${fixer.target}\` explicitly`));

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rtorcato/repo-tooling",
-	"version": "3.38.2",
+	"version": "3.38.3",
 	"description": "One CLI to scaffold, audit and fix your repo's whole toolchain — linting, tests, commits, releases & CI.",
 	"type": "module",
 	"keywords": [