@rtorcato/repo-tooling 3.2.4 → 3.3.0

package/dist/languages/swift/checks.js

@@ -105,6 +105,42 @@ export async function checkPackageSwift(dir) {
         detail: `Package.swift declares tools ${toolsVersion} and explicit platforms`,
     };
 }
+/**
+ * Release automation for a SwiftPM package (#310). There is no publish step to
+ * look for — a release *is* a semver git tag consumers resolve with
+ * `.package(url:from:)` — so "configured" means a workflow that fires on a tag
+ * push. semantic-release is deliberately not accepted as evidence: its pipeline
+ * is npm end to end, and a Swift repo running it is publishing the wrong thing.
+ *
+ * Only the trigger section is searched (everything above `jobs:`), because
+ * `tags:` also appears inside job steps — docker/metadata-action emits one — and
+ * a step that mentions tags is not a release trigger.
+ */
+export async function checkSwiftRelease(dir) {
+    const check = 'Release automation';
+    const hint = 'Run `npx @rtorcato/repo-tooling fix swift-release` to scaffold a tag-triggered release workflow';
+    const workflowsDir = path.join(dir, '.github', 'workflows');
+    if (await fs.pathExists(workflowsDir)) {
+        const files = (await fs.readdir(workflowsDir)).filter((f) => f.endsWith('.yml') || f.endsWith('.yaml'));
+        for (const file of files) {
+            const contents = await fs.readFile(path.join(workflowsDir, file), 'utf-8');
+            const triggers = contents.split(/^jobs:/m)[0] ?? '';
+            if (/^\s+tags:/m.test(triggers)) {
+                return {
+                    check,
+                    status: 'ok',
+                    detail: `.github/workflows/${file} releases on a tag push`,
+                };
+            }
+        }
+    }
+    return {
+        check,
+        status: 'optional-missing',
+        detail: 'no workflow triggered by a version tag',
+        hint,
+    };
+}
 /**
  * The Swift shape of the base `Git hooks` / `Pre-push hook` checks (#309).
  * `install` is null because the wiring — `git config core.hooksPath` — is
@@ -123,5 +159,6 @@ export async function runSwiftChecks(dir) {
         await checkPackageSwift(dir),
         ...(await Promise.all(SWIFT_FILE_CHECKS.map((spec) => checkFile(dir, spec)))),
         await checkSwiftGitignore(dir),
+        await checkSwiftRelease(dir),
     ];
 }

package/dist/languages/swift/ci.js

@@ -140,6 +140,49 @@ ${pkg.platforms.map((p) => `          - ${p}`).join('\n')}`,
 export function renderSwiftWorkflow(pkg) {
     return renderGitHubWorkflow(swiftGithubJobs(pkg));
 }
+/**
+ * The release pipeline (#310). SwiftPM has no registry publish step — a release
+ * *is* a semver git tag that consumers resolve with `.package(url:from:)` — so
+ * the workflow fires on the tag rather than on a merge, and its only output is
+ * a GitHub Release with generated notes.
+ *
+ * The build/test gate runs before the release is cut because a tag is
+ * effectively permanent: SwiftPM caches resolved tags, so re-pointing a bad one
+ * doesn't reliably reach consumers who already resolved it.
+ *
+ * `gh` (preinstalled on the runner) rather than a release action: one fewer
+ * third-party pin to track, and `--verify-tag` refuses to invent a tag that
+ * isn't actually pushed.
+ */
+export function renderSwiftReleaseWorkflow() {
+    return `name: 🏷️  Release
+
+on:
+  push:
+    tags:
+      - '[0-9]+.[0-9]+.[0-9]+'
+      - 'v[0-9]+.[0-9]+.[0-9]+'
+
+jobs:
+  release:
+    runs-on: ${MACOS}
+    permissions:
+      contents: write
+    steps:
+${XCODE_SETUP}
+
+      - name: 🏗️  swift build
+        run: swift build
+
+      - name: 🧪 swift test
+        run: swift test
+
+      - name: 🏷️  Publish GitHub Release
+        env:
+          GH_TOKEN: \${{ github.token }}
+        run: gh release create "\${{ github.ref_name }}" --generate-notes --verify-tag
+`;
+}
 /**
  * GitLab runs Swift in the official Linux image. That rules out Xcode — so no
  * platform matrix and no SwiftLint (a Homebrew/macOS tool in practice); the

package/dist/languages/swift/fixers.js

@@ -7,7 +7,7 @@ import fs from 'fs-extra';
 import { buildPresetConfig } from '../../cli/commands/setup-presets.js';
 import { copyPreset } from '../../cli/utils/copy-preset.js';
 import { LOCKFILE_NAME, writeLockfile } from '../../cli/utils/lockfile.js';
-import { readSwiftPackage, renderSwiftGitLabCI, renderSwiftWorkflow } from './ci.js';
+import { readSwiftPackage, renderSwiftGitLabCI, renderSwiftReleaseWorkflow, renderSwiftWorkflow, } from './ci.js';
 import { SWIFT_HOOKS_DIR, installSwiftGitHooks } from './git-hooks.js';
 import { ensureSwiftGitignore } from './gitignore.js';
 export const SWIFT_FIXERS = [
@@ -73,6 +73,19 @@ export const SWIFT_FIXERS = [
             return { filesWritten: ['.github/workflows/ci.yml'] };
         },
     },
+    {
+        target: 'swift-release',
+        description: 'Scaffold .github/workflows/release.yml (build + test on a version tag, then publish a GitHub Release)',
+        appliesTo: ['Release automation'],
+        outputs: ['.github/workflows/release.yml'],
+        canFixDrift: true,
+        async run({ targetDir }) {
+            const workflowsDir = path.join(targetDir, '.github', 'workflows');
+            await fs.ensureDir(workflowsDir);
+            await fs.writeFile(path.join(workflowsDir, 'release.yml'), renderSwiftReleaseWorkflow());
+            return { filesWritten: ['.github/workflows/release.yml'] };
+        },
+    },
     {
         target: 'swift-gitlab-ci',
         description: 'Scaffold .gitlab-ci.yml for Swift (swift build + test on the Linux Swift image)',

package/dist/languages/swift/scaffold.js

@@ -18,7 +18,7 @@ import { generateEditorConfig } from '../../cli/generators/misc.js';
 import { generateCodeQLWorkflow, generateDependabotConfig } from '../../cli/generators/security.js';
 import { copyPreset } from '../../cli/utils/copy-preset.js';
 import { LANGUAGES } from '../registry.js';
-import { readSwiftPackage, renderSwiftWorkflow } from './ci.js';
+import { readSwiftPackage, renderSwiftReleaseWorkflow, renderSwiftWorkflow } from './ci.js';
 import { SWIFT_HOOKS_DIR, installSwiftGitHooks } from './git-hooks.js';
 import { ensureSwiftGitignore } from './gitignore.js';
 /**
@@ -168,7 +168,18 @@ ${config.projectName}/
 - **GitHub Actions** — \`swift build\`/\`swift test\` on macOS, plus \`xcodebuild\` per declared platform
 
 Run \`npx @rtorcato/repo-tooling doctor\` any time to audit this repo against the standard.
+${config.semanticRelease
+        ? `
+## Releasing
 
+SwiftPM has no registry: a release is a semver git tag. Pushing one runs the
+build/test gate and publishes a GitHub Release from it.
+
+\`\`\`bash
+git tag 1.0.0 && git push origin 1.0.0
+\`\`\`
+`
+        : ''}
 ## Contributing
 
 1. Fork the repository
@@ -199,6 +210,9 @@ export function swiftFileList(config) {
         '.editorconfig',
         '.github/workflows/ci.yml',
     ];
+    if (config.semanticRelease) {
+        files.push('.github/workflows/release.yml');
+    }
     if (config.gitHooks) {
         files.push(`${SWIFT_HOOKS_DIR}/pre-commit`, `${SWIFT_HOOKS_DIR}/pre-push`);
     }
@@ -227,6 +241,10 @@ export async function generateSwiftProject(config, targetDir) {
     const workflowsDir = path.join(targetDir, '.github', 'workflows');
     await fs.ensureDir(workflowsDir);
     await fs.writeFile(path.join(workflowsDir, 'ci.yml'), renderSwiftWorkflow(await readSwiftPackage(targetDir)));
+    // A tag-triggered release, not an npm publish (#310) — see the preset.
+    if (config.semanticRelease) {
+        await fs.writeFile(path.join(workflowsDir, 'release.yml'), renderSwiftReleaseWorkflow());
+    }
     // `core.hooksPath` won't stick here — `setup` scaffolds into a directory that
     // isn't a git repo yet — so the hooks land as files and the README tells you
     // the one-line config to run after `git init`.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rtorcato/repo-tooling",
-	"version": "3.2.4",
+	"version": "3.3.0",
 	"description": "One CLI to scaffold, audit and fix your repo's whole toolchain — linting, tests, commits, releases & CI.",
 	"type": "module",
 	"keywords": [
@@ -46,6 +46,7 @@
 	"files": [
 		"dist/cli/**/*.js",
 		"dist/languages/**/*.js",
+		"dist/base/**/*.js",
 		"tooling/commitlint/commitlint.mjs",
 		"tooling/commitlint/commitlint.d.mts",
 		"tooling/esbuild/index.mjs",

package/tooling/github-actions/workflows/cloudflare-pages.yml

@@ -26,7 +26,7 @@ jobs:
           node-version-file: .nvmrc
 
       - name: Setup pnpm
-        uses: pnpm/action-setup@v4
+        uses: pnpm/action-setup@v6
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile