@bensandee/tooling 0.57.3 → 0.58.0

package/README.md

@@ -78,6 +78,28 @@ Custom blocks are anchored to the nearest preceding non-blank line. When `repo:s
 
 To skip a workflow file entirely, add `# @bensandee/tooling:ignore` as the first line — `repo:sync` will leave the file untouched.
 
+### pnpm-workspace.yaml
+
+`repo:sync` manages `pnpm-workspace.yaml` with a narrow contract — mandated keys, a few seeded-on-creation keys, and everything else passed through verbatim.
+
+**Mandated** (drift fails `repo:sync --check`):
+
+- `blockExoticSubdeps: true`
+- `minimumReleaseAge` — any non-negative number (`0` is valid)
+
+**Seeded on creation only** (free to change or remove afterward):
+
+- `minimumReleaseAgeExclude: ["@bensandee/*"]`
+- `packages: ["packages/*"]` (monorepos only)
+
+All other keys — `allowBuilds`, custom entries — are preserved verbatim through `repo:sync`. The generator emits the file for single-package repos too, not just monorepos.
+
+Opt out entirely with `"pnpmWorkspace": false` in `.tooling.json`; the generator then never inspects or writes the file.
+
+### packageManager force-bump
+
+`repo:sync` rewrites `package.json#packageManager` when an existing value is `pnpm@<N>.x` with `N < 11`, setting it to the tooling's pinned pnpm version (currently `11.1.1`). This is delivered through `repo:sync` rather than Renovate because the mandated `pnpm-workspace.yaml` keys (`blockExoticSubdeps`) require pnpm 11+. Within-major bumps (`pnpm@11.x → 11.y`) remain Renovate's job; non-pnpm package managers (yarn, npm) are out of scope.
+
 ### Repository setup
 
 | Command                   | Description                                                                                                                            |
@@ -350,6 +372,7 @@ Available override fields:
 | `releaseStrategy`    | string  | Detected from existing config, else monorepo: `"changesets"`, single: `"simple"` |
 | `projectType`        | string  | Auto-detected from `package.json` deps                                           |
 | `detectPackageTypes` | boolean | `true`                                                                           |
+| `pnpmWorkspace`      | `false` | Set to `false` to opt out of `pnpm-workspace.yaml` management                    |
 
 ## Debug logging