@rtorcato/repo-tooling 3.7.3 → 3.7.4

package/README.md

@@ -53,6 +53,20 @@ npx @rtorcato/repo-tooling copy oxlint       # → .oxlintrc.json
 npx @rtorcato/repo-tooling copy claude-skill # → .claude/skills/repo-tooling.md
 ```
 
+The Biome preset honours your `.gitignore`, so build output stays unlinted. One
+known gap: Biome cannot parse Tailwind CSS v4 stylesheets (`@theme`, `@source`,
+`@custom-variant`, `@apply`) and reports a parse error on them. If you use
+Tailwind v4, exclude your stylesheet in `biome.json`:
+
+```jsonc
+{
+  "extends": ["@rtorcato/repo-tooling/biome"],
+  // `includes` replaces the preset's list rather than extending it — restate
+  // the exclusions you still want alongside the CSS one.
+  "files": { "includes": ["**", "!**/node_modules", "!**/dist", "!**/*.css"] }
+}
+```
+
 **Already have a project?** Don't rerun `setup` — use `doctor` + `fix`:
 
 ```bash

package/dist/cli/generators/linting.js

@@ -34,6 +34,46 @@ export const BIOME_CONFIG = 'biome.json';
  * BIOME_CONFIG and delete this on the way past, so the ambiguity can't persist.
  */
 export const BIOME_LEGACY_CONFIG = 'biome.jsonc';
+/**
+ * Used when nothing in the target repo says which Biome will read the config —
+ * a bare directory mid-`setup`, before `pnpm install` has run. Matches the
+ * `$schema` the shipped preset carries.
+ */
+const BIOME_SCHEMA_FALLBACK = '2.5.0';
+async function readJsonOrNull(filepath) {
+    try {
+        return (await fs.readJson(filepath));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The Biome version the scaffolded `$schema` URL should name (#363).
+ *
+ * A hardcoded version drifts the moment the consumer's Biome moves, and Biome
+ * reports the mismatch on *every* invocation ("The configuration schema version
+ * does not match the CLI version 2.5.7") — noise on a file the consumer never
+ * wrote. The installed package wins because it is literally the binary that
+ * will parse the file and emit that warning; the declared range is the next
+ * best statement of intent when node_modules isn't populated yet.
+ */
+export async function resolveBiomeSchemaVersion(targetDir) {
+    const installed = await readJsonOrNull(path.join(targetDir, 'node_modules', '@biomejs', 'biome', 'package.json'));
+    const pkg = await readJsonOrNull(path.join(targetDir, 'package.json'));
+    const deps = {
+        ...(pkg?.dependencies ?? {}),
+        ...(pkg?.devDependencies ?? {}),
+    };
+    // Both an exact version ("2.5.7") and a range ("^2.5.0") carry the x.y.z we
+    // need, so one pattern covers every source.
+    for (const candidate of [installed?.version, deps['@biomejs/biome']]) {
+        const match = typeof candidate === 'string' ? /(\d+\.\d+\.\d+)/.exec(candidate) : null;
+        if (match?.[1])
+            return match[1];
+    }
+    return BIOME_SCHEMA_FALLBACK;
+}
 /**
  * The thin pointer config — the same shape this repo dogfoods. `fix biome` used
  * to copy the whole preset inline instead, which meant the scaffolded file
@@ -45,8 +85,9 @@ export async function generateBiomeConfig(targetDir) {
     // file globs via `files.includes`; emitting the old 1.x `include`/`ignore`
     // keys here forced consumers to run `biome migrate` before `biome check`
     // would run at all.
+    const version = await resolveBiomeSchemaVersion(targetDir);
     const biomeConfig = {
-        $schema: 'https://biomejs.dev/schemas/2.5.0/schema.json',
+        $schema: `https://biomejs.dev/schemas/${version}/schema.json`,
         extends: ['@rtorcato/repo-tooling/biome'],
     };
     await fs.writeJson(path.join(targetDir, BIOME_CONFIG), biomeConfig, { spaces: 2 });

package/package.json

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

package/tooling/biome/biome.json

@@ -1,7 +1,7 @@
 {
 	"$schema": "https://biomejs.dev/schemas/2.5.0/schema.json",
 	"vcs": {
-		"enabled": false,
+		"enabled": true,
 		"clientKind": "git",
 		"useIgnoreFile": true
 	},