Skip to main content

Changelog

@rtorcato/repo-tooling@6.3.0 (2026-11-10)​

Minor Changes​

  • 1dccde3: The scaffolded ci.yml for a Changesets repo gets a changeset job: a PR that changes src/ (or packages/<name>/src/) with no new .changeset/*.md fails. It skips the Version Packages PR and PRs titled docs, chore, ci, test, build, style or refactor; pnpm changeset --empty covers anything else that ships nothing. doctor reports GitHub Actions drift when a Changesets repo's ci.yml lacks the job, and fix github-actions scaffolds it. semantic-release repos get no new job.
  • 3fea8af: doctor now reports a public package still on semantic-release as Release tool (optional-missing, so it never fails the exit code), and the new fix changesets-migrate moves it to Changesets. It deletes the semantic-release config, release field and deps, adds .changeset/config.json and @changesets/cli, sets package.json version to the latest on npm (left alone when the package is not published yet), lists the root in pnpm-workspace.yaml, and rewrites release.yml as the two-job Version Packages flow, keeping its environment: and dropping the milestone: closed trigger. It records semanticRelease: false, changesets: true in .repo-tooling.json. It runs only when named, never from a bare fix.
  • ed257eb: .repo-tooling.json takes an optional extends: a relative path, an npm package path or github:<owner>/<repo>/<path>[#<ref>] pointing at a shared base of rules. The base comes first and the repo's own rules are deep-merged on top, so the repo always wins. doctor adds an Extends row and reports an unreadable base as drift; fix and doctor --snapshot never write into the base, and --snapshot lists the rules still inherited from it. Without extends, nothing changes.

Patch Changes​

  • 3c82d8e: The shared Biome preset now leaves pnpm-lock.yaml and CHANGELOG.md out of files.includes, so biome check --write no longer reflows the lockfile or fails on the Changesets-generated changelog.
  • 549c62c: The shared Biome preset now keeps .md, .mdx, .yaml and .yml out of the formatter. Biome 2.6 started formatting them and turns changeset frontmatter into a heading.
  • 471508c: fix changesets-migrate no longer prints terminal control characters from an untrusted package.json name, npm's version output or npm's error line in its abort messages. They become ?, and each value is truncated.
  • 5e5a6dd: fix changesets-migrate is hardened. It validates the package name and passes -- to npm view, and rejects a non-semver version from npm before writing it. It also drops npx semantic-release and pnpm exec semantic-release release scripts, not only the bare one, keeps a tab-indented package.json, and points to fix release-environment when the old release workflow had no environment:.
  • 3bade23: Scaffolded projects now depend on @commitlint/config-conventional ^21.2.4, matching this package's peer range.
  • cc6d9bd: The workflows setup and fix generate now pin every GitHub Action to a commit SHA with a # vX.Y.Z comment, instead of a mutable tag such as actions/checkout@v7. The shipped workflow templates and action.yml are pinned the same way. doctor reads the major from either form, so an older pin that disagrees with the preset is still reported. A workflow that already pins a SHA keeps it.
  • d1b624e: Add a Releasing guide that walks through a Changesets release, from the PR changeset to the approved publish.
  • bfd4ece: doctor no longer silently ignores a .repo-tooling.json that holds only rules (or isn't valid JSON): it reports lockfile drift saying the rules are ignored, and fix lockfile now writes the record around the existing rules instead of replacing them with the empty scaffold. A non-boolean rules.github merge toggle now reads config error: … in the Merge settings row. The .repo-tooling.json reference says rules must sit in a full lockfile.

@rtorcato/repo-tooling@6.2.2 (2026-11-02)​

Patch Changes​

  • 40e2c99: doctor and fix github-settings reject a non-boolean rules.github.autoMerge or deleteOnMerge ("false", 0) with a config error. They used to read it as on, so a repo that meant false got auto-merge turned on and doctor never went clean (#956).
  • 483e5e2: doctor reports drift when the release environment has no deployment branch policy, or a custom one that leaves out the default branch, so any branch could request the release approval. fix release-environment sets a custom policy on the same PUT and adds the default branch, or the branches in the new rules.github.releaseBranches (#960). A protected-branches policy is left alone, and a custom one only gains branches.
  • f2373cb: fix release-environment now resends the release environment's prevent_self_review and wait_timer on every PUT (#962). GitHub's PUT replaces the environment, so a reviewers or branch-policy write could reset either setting to its default.

@rtorcato/repo-tooling@6.2.1 (2026-10-29)​

Patch Changes​

  • a03a79d: setup with Changesets now adds @changesets/cli to devDependencies, and doctor reports drift when .changeset/config.json exists without it (#952).
  • 0b74994: fix github-settings now coerces rules.github.autoMerge, deleteOnMerge and actionsCanCreatePullRequests to booleans before they reach gh api -F, so a non-boolean lockfile value can no longer make gh read a file (#949).

6.1.1 (2026-10-15)​

Bug Fixes​

6.1.0 (2026-10-13)

Bug Fixes​

  • cli: build list from the fix registry; tidy stranger-facing copy (#845) (fc8ba85), closes rtorcato/repo-tooling#417 #NNN
  • doctor: Claude worktree settings is n/a without a package.json (#846) (5ca6925)
  • doctor: keep skipped checks skipped under declared exceptions (#856) (eadd034), closes #851 #853
  • doctor: report below-LTS Node as optional-missing, not drift (#831) (8b6a5eb), closes #826
  • doctor: report git-identity skips as skipped, not ok (#851) (20a599b), closes #839 #backed #835
  • doctor: report GitHub checks as skipped, not ok, when gh can't run (#835) (9bc217c), closes #824
  • doctor: resolve git state and workflows from the repo root under -d (#859) (98c01dd), closes #812 #817
  • fix: refuse an empty directory and point doctor at setup (#841) (658389f), closes #636
  • github-settings: make the github-settings fixer explicitOnly (#867) (d35cafb)
  • lockfile: flag and re-detect a release tool or bundler the repo no longer uses (#864) (35aeddd)
  • milestones: check the default branch workflows before closing (#852) (723e51e), closes 833/#837
  • milestones: never close a milestone that fires release.yml (#837) (d78dce3)
  • npm-trust: borrow the root repository when run on a workspace package (#854) (d34074f), closes #811
  • security: label-mode dependabot workflow drops contents: write (#855) (aba97a0), closes #819
  • setup: fail clearly without pnpm or a TTY; print help once (#840) (73bd356), closes #825
  • setup: make a fresh preset scaffold pass its own verify, build and doctor (#832) (5b3e3c6), closes #826 #831
  • setup: pin scaffolded repo-tooling to the running version (#836) (1205d60), closes #822 #832 #572
  • skills: install the Claude skill as .claude/skills/repo-tooling/SKILL.md (#843) (1d204c1)

Features​

6.0.1 (2026-10-13)​

Bug Fixes​

6.0.0 (2026-10-07)

Bug Fixes​

5.5.3 (2026-10-06)​

Bug Fixes​

  • doctor: name agent files that exist but lack the managed block (#786) (60951fc), closes #782
  • esbuild: load esbuild-node-externals only when there is something to externalize (#787) (5e3aeb9), closes #781
  • peers: accept size-limit 13 and 14 in the peer range (#788) (384b6d0), closes #783
  • release: default the release job to environment: release (#789) (d4c2fe5), closes #785
  • release: never cancel a release that is already publishing (#791) (0bd54fc), closes #790 #790 #785 #775 pre-#790

5.5.2 (2026-10-02)​

Bug Fixes​

  • github-actions: write codecov.yml and packageManager only when the workflows need them (#780) (6824c7a), closes #779

5.5.1 (2026-10-02)​

Bug Fixes​

5.5.0 (2026-10-02)

Bug Fixes​

  • github-actions: drop an emptied needs: when the release job is moved out (#764) (7310ec8), closes #761 #763

Features​

  • skills: npm-publish covers the release.yml dispatch flow (#766) (fecc653), closes #765

5.4.1 (2026-10-02)​

Bug Fixes​

  • action: run the CLI version the git ref names and pass --offline (#760) (e1f5786), closes #759
  • github-actions: move the release job out of ci.yml instead of regenerating it (#762) (98fdeb7), closes #761

5.4.0 (2026-10-02)

Features​

  • ci: split the release into release.yml — supersede waiting runs, release main's tip (#758) (c3c6947), closes #753
  • doctor: --offline skips checks that read live GitHub state (#757) (20c25c7), closes #737 #755 #759
  • doctor: require release secrets to be environment secrets on release (#756) (343a01b), closes #754

5.3.0 (2026-10-01)

Features​

  • ci: release only on workflow_dispatch or a closed milestone (#745) (4b879f4), closes #740
  • dependabot: configurable label mode instead of auto-merge (rules.dependabot.onPr) (#748) (48df0d9), closes #746 #658
  • doctor: require a size-limit budget for publishable libraries (#743) (d19d520), closes #739 hi#value

5.2.0 (2026-10-01)

Features​

  • milestones: roll a next milestone and warn on release hygiene (#744) (0b413f2), closes #740 #741

5.1.4 (2026-09-30)​

Bug Fixes​

  • ci: route the bare base path in the Cloudflare docs deploy (#733) (75b34fe)

5.1.3 (2026-09-30)​

Bug Fixes​

  • schema: serve the JSON Schemas from docs.torcato.dev (#732) (d2f5f0f)

5.1.2 (2026-09-30)​

Bug Fixes​

  • ci: pin wrangler to an exact version in the Cloudflare docs deploy (#729) (00728cf)

5.1.1 (2026-09-30)​

Bug Fixes​

  • ci: deploy Cloudflare docs with npx wrangler in pnpm workspaces (#727) (3a11242), closes #725

5.1.0 (2026-09-30)

Features​

5.0.1 (2026-09-29)​

Bug Fixes​

  • cli: point moved docs-site and brand targets at the shipped shared-docs commands (#720) (6459dda)

5.0.0 (2026-09-29)

4.8.0 (2026-09-29)

Features​

  • docs-site: opt-in sibling project links via rules.docs.siblings (#715) (899362d), closes #676
  • doctor: report workflow secrets that are not configured (#716) (19b7d59), closes #685

4.7.0 (2026-09-29)

Features​

  • ci: smoke-test the packed tarball for packages with a bin (#714) (7797bf1), closes #693
  • docs-site: wire the brand favicon and social card into the docs site (#710) (606b2a7), closes #680

4.6.0 (2026-09-29)

Bug Fixes​

  • ci: gate release job on releasable subjects and never cancel runs on main (#711) (f8cafe6), closes #690
  • docs-site: rebuild docs via workflow_run after CI, not release: published (#709) (ab07d97), closes #691

Features​

4.5.0 (2026-09-29)

Bug Fixes​

  • docs-site: only add bundlephobia/codecov badges when they apply (#701) (3e3d302), closes #675

Features​

  • guide npm OIDC trusted publishing in setup, doctor and fix (#687) (#706) (57edb30)

4.4.0 (2026-09-29)

Bug Fixes​

  • doctor: report missing security automation when the lock records it (#704) (621c1e2), closes #692 #692

Features​

  • brand: scaffold a favicon and render the PNGs in fix brand (#705) (03544e9), closes #678

4.3.1 (2026-09-29)​

Bug Fixes​

  • docs-site: align scaffold dependency ranges with the family (#707) (ab698a5), closes #674

4.3.0 (2026-09-29)

Bug Fixes​

  • dependabot: assign the owner and comment when a PR falls through to manual review (#703) (1aa5c68), closes #694

Features​

  • setup: offer brand assets in the wizard and record the choice (#702) (ccebaeb), closes #677

4.2.0 (2026-09-24)

Bug Fixes​

  • docs-site: emit the scaffold in Biome preset style and drop the smoke spec (#681) (5527582), closes #662

Features​

  • fix: let selfSafe fixers run on this repo under REPO_TOOLING_ALLOW_SELF (#682) (95c8e39), closes #673

4.1.0 (2026-09-24)

Bug Fixes​

Features​

  • brand: read the banner tagline from rules.brand.tagline (#669) (54e62f6), closes #666

4.0.0 (2026-09-24)

3.45.0 (2026-09-23)

Features​

  • loop: add loop tick --json and shrink the skill to judgement only (#657) (b340b8b), closes #620

3.44.0 (2026-09-23)

Features​

3.43.0 (2026-09-23)

Features​

3.42.0 (2026-09-23)

Features​

3.41.0 (2026-09-23)

Features​

3.40.0 (2026-09-23)

Features​

3.39.0 (2026-09-23)

Bug Fixes​

  • fix: skip the confirm prompt on --dry-run and without a TTY (#649) (0e3cb11), closes #637
  • husky: chmod an existing hook that already runs the command (#648) (1f9a155), closes #646

Features​

3.38.3 (2026-09-23)​

Bug Fixes​

  • fix: skip optional-missing findings in a bulk fix (#647) (39cd7f4), closes #630

3.38.2 (2026-09-23)​

Bug Fixes​

  • dependabot: stop assuming npm in repos without a package.json (#643) (33475e8), closes #422 #631
  • doctor: run base checks only for a repo with no language marker (#645) (35c7208), closes #632
  • fix: never replace hand-written husky hooks or docs.yml workflow (#644) (c9edb28), closes #629
  • fix: report the files a --dry-run would actually change (#642) (8869a85), closes #635

3.38.1 (2026-09-23)​

Bug Fixes​

  • detect-language: let Package.swift win over a docs-only package.json (#639) (5279b2d), closes #633
  • doctor: skip README badges check without package.json, match own name (#641) (f716172), closes #634
  • fix: refuse husky without package.json and skip crashing fixers in bulk runs (#640) (80a4058), closes #636

3.38.0 (2026-09-23)

Bug Fixes​

  • ai-issue-loop: make the Pass 5 status file absolute and define SUGGESTED (#623) (36cbf35), closes #610
  • skills: fall back to general-purpose when reviewer agents are absent (#628) (4259a82), closes #611 #611
  • skills: let a promoted ai-suggested issue reach the queue (#609) (b073fc9), closes #608
  • skills: split optional gh flags so zsh passes them as two words (#626) (54fa351), closes #624

Features​

  • ai-issue-loop: notify with PushNotification instead of osascript (#627) (d7598b6), closes #623 #612

3.37.2 (2026-09-21)​

Bug Fixes​

3.37.1 (2026-09-21)​

Bug Fixes​

3.37.0 (2026-09-21)

Features​

  • loop-guard: halt when gh is not the declared agent account (#603) (2fb3193), closes #601

3.36.0 (2026-09-21)

Bug Fixes​

  • biome: merge into an existing biome.json instead of replacing it (#598) (4f77fc6), closes #587
  • biome: parse Tailwind v4 directives in the shipped preset (#599) (2a9a3f0), closes #589
  • pnpm-workspace: mirror onlyBuiltDependencies into allowBuilds (#595) (a2953b2), closes #588
  • skills: iterate symlinkDirectories line by line so zsh links anything (#596) (e7ab3dd), closes #585

Features​

  • doctor: flag peers installed below the declared range (#597) (efe3a28), closes #591
  • typescript: add a vite-app preset with vite/client and checked tests (#600) (ae2fdd3), closes #592

3.35.0 (2026-08-27)

Features​

3.34.0 (2026-08-27)

Features​

3.33.0 (2026-08-27)

Features​

  • doctor: flag Swift sources under Sources/ that no declared target claims (#582) (4c56f56), closes #575

3.32.0 (2026-08-27)

Bug Fixes​

  • setup: derive the pnpm release-age exemption from package.json name (#580) (c98b4f0), closes #573

Features​

  • lockfile: write an empty rules scaffold so a new repo has rules to edit (#581) (3591b34), closes #571

3.31.2 (2026-08-27)​

Bug Fixes​

  • cli: report one version for --version, writtenBy, and the skill stamps (#579) (926e803), closes #480 #417 #572
  • setup: make the library preset own the build script it writes exports for (#577) (ebc5414), closes #570 #573
  • swift: preserve an existing Package.swift instead of overwriting it (#576) (9210ea5), closes #574 #575

3.31.1 (2026-08-27)​

Bug Fixes​

  • skills: scope the verdict-marker read to the PR's head commit (#569) (6a6e371), closes #497 #567

3.31.0 (2026-08-27)

Features​

3.30.0 (2026-08-27)

Features​

3.29.0 (2026-08-27)

Features​

3.28.0 (2026-08-27)

Features​

  • doctor: scan recent commit history for placeholder or generated author emails (#562) (efc4c8a), closes #557

3.27.0 (2026-08-26)

Features​

  • doctor: record deliberate deviations as declared exceptions in .repo-tooling.json (#561) (2dd0a65), closes #558 #552

3.26.0 (2026-08-26)

Bug Fixes​

Features​

3.25.0 (2026-08-26)

Features​

  • cli: add loop guard for bare-checkout repair and node_modules rebuild gating (#553) (d908f4b), closes #519 #519

3.24.0 (2026-08-26)

Features​

  • doctor: flag an older lockfile and migrate it in place with fix lockfile (#544) (03bedee), closes #531
  • labels: give the human's pickup state a merge-ready label instead of an absence (#543) (61d8e3d), closes #541

3.23.0 (2026-08-26)

Features​

  • doctor: verify aiLoop.agentUser is an assignable collaborator (#537) (4cf2263), closes #530 #521
  • schema: publish the .repo-tooling.json JSON Schema at its $schema URL (#539) (686ce35), closes #529

3.22.1 (2026-08-26)​

Bug Fixes​

  • skills: gate the ai-issue-loop decision-comment upsert on the loop's own login (#526) (c79cac6), closes #511

3.22.0 (2026-08-21)

Bug Fixes​

  • skills: resolve the stamped version from git tags in a checkout (#523) (5a28bc9), closes #417

Features​

  • skills: assign in-flight work to the agent account (#525) (ad310e6)

3.21.1 (2026-08-21)​

Bug Fixes​

3.21.0 (2026-08-21)

Features​

3.20.0 (2026-08-21)

Bug Fixes​

Features​

3.19.2 (2026-08-21)​

Bug Fixes​

  • doctor: shell-quote both paths in the skill-fork diff hint (#497) (93e60e3), closes #492 #493

3.19.1 (2026-08-21)​

Bug Fixes​

3.19.0 (2026-08-21)

Features​

  • doctor: honour --skills-dir when reporting the Claude skill (#490) (9907de4), closes #485

3.18.0 (2026-08-21)

Features​

  • skills: route agent follow-ups to ai-suggested issues (#489) (0646da5), closes #478

3.17.0 (2026-08-21)

Features​

  • skills: tell a stale installed skill from a deliberate local fork (#483) (5bba9ba), closes #480 #448

3.16.3 (2026-08-21)​

Bug Fixes​

3.16.2 (2026-08-21)​

Bug Fixes​

3.16.1 (2026-08-21)​

Bug Fixes​

  • biome: stop pinning a version in the $schema URL (#477) (769c3ae), closes #330

3.16.0 (2026-08-21)

Bug Fixes​

Features​

3.15.3 (2026-08-21)​

Bug Fixes​

  • setup: use inquirer's select type so the wizard can run at all (#466) (a927ba9), closes #463 #461

3.15.2 (2026-08-20)​

Bug Fixes​

  • skills: stop routing held Dependabot PRs through ai-changes (#464) (6d5f22c), closes #459 #455

3.15.1 (2026-08-20)​

Bug Fixes​

3.15.0 (2026-08-20)

Bug Fixes​

Features​

  • doctor: audit ai-issue-loop label colours and descriptions (#456) (1381117), closes #446 #422

3.14.0 (2026-08-20)

Bug Fixes​

  • dependabot: refuse to silently delete repo-local ignore rules (#445) (8d279c6), closes #422
  • security: gate Dependabot auto-merge on the dev-minor group (#447) (bb32f69), closes #423

Features​

  • doctor: check the release environment gate (#449) (024377c)
  • doctor: tell a stale copied asset from a deliberate local fork (#448) (d83aef9), closes #428
  • docusaurus: add docs-generator helpers as a copy asset (#444) (b6ad3e8), closes #426

3.13.2 (2026-08-20)​

Bug Fixes​

  • claude: claim reviewers before spawning in ai-issue-loop Pass 3 (#442) (446cfdb), closes #439

3.13.1 (2026-08-20)​

Bug Fixes​

  • skills: make npm-publish consumer-neutral and release-tool-aware (#437) (e3a2ae1), closes #433 #436

3.13.0 (2026-08-20)

Bug Fixes​

  • doctor: stop requiring sync-changelog on Changesets repos (#433) (c905d49), closes #425

Features​

  • claude: ship sync-agents.mjs as a copy asset (#434) (2510f2c), closes #427
  • doctor: detect Biome $schema drift from the installed CLI (#435) (e833408), closes #424

3.12.1 (2026-08-17)​

Bug Fixes​

  • docs: repair the docs tsconfig for TypeScript 7 (#421) (bc86f75)

3.12.0 (2026-08-17)

Features​

3.11.1 (2026-08-17)​

Bug Fixes​

3.11.0 (2026-08-17)

Features​

  • github: make squash the only merge method in the standard (#415) (a2d53ff), closes #204 #N

3.10.2 (2026-08-17)​

Bug Fixes​

  • cli: fail closed when fix claude-skills has nowhere to install (#413) (816ecef)

3.10.1 (2026-08-12)​

Bug Fixes​

  • ai: symlink nested workspace node_modules into agent worktrees (#408) (e3fe54c), closes #406

3.10.0 (2026-08-12)

Bug Fixes​

Features​

  • skills: ship the ai-issue-loop skill with a user-level install target (#409) (e4e0bcd), closes #404

3.9.2 (2026-08-12)​

Bug Fixes​

  • brand: escape double quotes in generated SVG text (#403) (2806804)

3.9.1 (2026-08-12)​

Bug Fixes​

  • commitlint: stop enforcing body/footer line length (#402) (a272bcd)

3.9.0 (2026-08-11)

Features​

3.8.7 (2026-08-11)​

Bug Fixes​

  • doctor: flag agent docs that name the dead js-tooling bin (#394) (7e6f957), closes #393

3.8.6 (2026-08-10)​

Bug Fixes​

3.8.5 (2026-08-10)​

Bug Fixes​

3.8.4 (2026-08-10)​

Bug Fixes​

3.8.3 (2026-08-10)​

Bug Fixes​

  • doctor: accept an inlined biome preset, not just an extends pointer (#379) (2c75d80), closes #378

3.8.2 (2026-08-10)​

Bug Fixes​


Every entry above is published to GitHub Releases. Anything older than the first GitHub Release is recorded in CHANGELOG.md.