ci: semantic-release streamlining

Agent-Id: agent-f1f3a32a-cf6a-4d05-b1be-28d9269e7688

Author: LittleCoinCoin

.github/workflows/prerelease-discord-notification.yml

@@ -1,19 +1,23 @@
 name: Publish to PyPI
 
 on:
-  push:
-    tags:
-      - 'v[0-9]+.[0-9]+.[0-9]+*'
-  workflow_dispatch:
+  workflow_call:
+    # Automatic release path: semantic-release passes the exact tag to test and publish.
     inputs:
       tag:
-        description: 'Git tag to publish (e.g., v1.0.0)'
+        description: 'Git tag to test and publish (for release orchestration)'
         required: true
         type: string
-      ref:
-        description: 'Branch or commit to checkout'
-        required: false
-        default: 'main'
+    outputs:
+      tag:
+        description: 'Published git tag'
+        value: ${{ jobs.publish-pypi.outputs.tag }}
+  workflow_dispatch:
+    # Manual recovery path: choose the exact tag to test and publish.
+    inputs:
+      tag:
+        description: 'Git tag to test and publish (e.g., v1.0.0)'
+        required: true
         type: string
 
 jobs:
@@ -24,7 +28,9 @@ jobs:
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
-          ref: ${{ github.event.inputs.ref || github.ref }}
+          # Automatic path: semantic-release passes the released tag directly.
+          # Manual path: validate the same tag that will be published.
+          ref: ${{ inputs.tag }}
 
       - name: Setup Python
         uses: actions/setup-python@v5
@@ -44,6 +50,8 @@ jobs:
     name: Publish to PyPI
     runs-on: ubuntu-latest
     needs: test
+    outputs:
+      tag: ${{ steps.published_tag.outputs.tag }}
     environment:
       name: pypi
       url: https://pypi.org/project/hatch-xclam/
@@ -55,11 +63,7 @@ jobs:
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
-          ref: ${{ github.event.inputs.ref || github.ref }}
-
-      - name: Checkout specific tag for manual dispatch
-        if: github.event_name == 'workflow_dispatch'
-        run: git checkout ${{ github.event.inputs.tag }}
+          ref: ${{ inputs.tag }}
 
       - name: Setup Python
         uses: actions/setup-python@v5
@@ -80,3 +84,8 @@ jobs:
           print-hash: true
           verbose: true
           skip-existing: true
+
+      - name: Record published tag
+        id: published_tag
+        run: |
+          echo "tag=${{ inputs.tag }}" >> "$GITHUB_OUTPUT"

.github/workflows/publish.yml

@@ -8,6 +8,7 @@ on:
 
 jobs:
   test:
+    if: ${{ !startsWith(github.event.head_commit.message, 'chore(release):') }}
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
@@ -30,8 +31,12 @@ jobs:
           python -c "import hatch; print('Hatch package imports successfully')"
 
   release:
+    if: ${{ !startsWith(github.event.head_commit.message, 'chore(release):') }}
     needs: test
     runs-on: ubuntu-latest
+    outputs:
+      published: ${{ steps.semantic_release.outputs.published }}
+      tag: ${{ steps.semantic_release.outputs.tag }}
     steps:
       - name: Generate GitHub App Token
         id: generate_token
@@ -58,10 +63,115 @@ jobs:
         run: npm audit signatures
 
       - name: Release
+        id: semantic_release
         env:
           GITHUB_TOKEN: ${{ steps.generate_token.outputs.token }}
           GH_TOKEN: ${{ steps.generate_token.outputs.token }}
         run: |
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
-          npx semantic-release
+          node <<'EOF'
+          const fs = require('fs');
+
+          (async () => {
+            const semanticReleaseModule = await import('semantic-release');
+            const semanticRelease = semanticReleaseModule.default || semanticReleaseModule;
+            const result = await semanticRelease();
+
+            if (!process.env.GITHUB_OUTPUT) {
+              throw new Error('GITHUB_OUTPUT is not set');
+            }
+
+            if (!result) {
+              fs.appendFileSync(process.env.GITHUB_OUTPUT, 'published=false\n');
+              fs.appendFileSync(process.env.GITHUB_OUTPUT, 'tag=\n');
+              return;
+            }
+
+            fs.appendFileSync(process.env.GITHUB_OUTPUT, 'published=true\n');
+            fs.appendFileSync(process.env.GITHUB_OUTPUT, `tag=${result.nextRelease.gitTag}\n`);
+          })().catch((error) => {
+            console.error(error);
+            process.exit(1);
+          });
+          EOF
+
+  publish:
+    name: Publish released package
+    needs: release
+    if: ${{ needs.release.outputs.published == 'true' }}
+    uses: ./.github/workflows/publish.yml
+    with:
+      tag: ${{ needs.release.outputs.tag }}
+    secrets: inherit
+
+  notify-discord:
+    name: Notify Discord
+    needs:
+      - release
+      - publish
+    if: ${{ needs.release.outputs.published == 'true' && needs.publish.result == 'success' }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Resolve GitHub release
+        id: release
+        uses: actions/github-script@v8
+        env:
+          TAG_NAME: ${{ needs.publish.outputs.tag }}
+        with:
+          script: |
+            const { data: release } = await github.rest.repos.getReleaseByTag({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              tag: process.env.TAG_NAME,
+            });
+
+            core.setOutput('tag_name', release.tag_name);
+            core.setOutput('html_url', release.html_url);
+            core.setOutput('is_prerelease', String(release.prerelease));
+
+      - name: Build Discord payload
+        id: discord
+        uses: actions/github-script@v8
+        env:
+          TAG_NAME: ${{ steps.release.outputs.tag_name }}
+          HTML_URL: ${{ steps.release.outputs.html_url }}
+          IS_PRERELEASE: ${{ steps.release.outputs.is_prerelease }}
+        with:
+          script: |
+            const isPrerelease = process.env.IS_PRERELEASE === 'true';
+            const tagName = process.env.TAG_NAME;
+            const htmlUrl = process.env.HTML_URL;
+
+            core.setOutput('content', isPrerelease ? '' : '<@&1418053865818951721>');
+            core.setOutput('title', isPrerelease
+              ? '🧪 Hatch Pre-release Available for Testing'
+              : '🎉 New *Hatch!* Release Available!');
+            core.setOutput('description', isPrerelease
+              ? `**Version \`${tagName}\`** is now available for testing!\n\n⚠️ **This is a pre-release** - expect potential bugs and breaking changes\n🔬 Perfect for testing new features and providing feedback\n📋 Click [here](${htmlUrl}) to view what's new and download\n\n💻 Install with pip:\n\`\`\`bash\npip install hatch-xclam==${tagName}\n\`\`\`\n\nHelp us make *Hatch!* better by testing and reporting [issues](https://github.com/CrackingShells/Hatch/issues)! 🐛➡️✨`
+              : `**Version \`${tagName}\`** has been released!\n\n🚀 Get the latest features and improvements\n📚 Click [here](${htmlUrl}) to view the changelog and download\n\n💻 Install with pip:\n\`\`\`bash\npip install hatch-xclam\n\`\`\`\n\nHappy MCP coding with *Hatch!* 🐣`);
+            core.setOutput('color', isPrerelease ? '0xff9500' : '0x00ff88');
+            core.setOutput('username', isPrerelease
+              ? 'Cracking Shells Pre-release Bot'
+              : 'Cracking Shells Release Bot');
+            core.setOutput('image', isPrerelease
+              ? 'https://raw.githubusercontent.com/CrackingShells/.github/main/resources/images/hatch_icon_dark_bg_transparent.png'
+              : 'https://raw.githubusercontent.com/CrackingShells/.github/main/resources/images/hatch_icon_light_bg_transparent.png');
+            core.setOutput('avatar_url', isPrerelease
+              ? 'https://raw.githubusercontent.com/CrackingShells/.github/main/resources/images/cs_core_dark_bg.png'
+              : 'https://raw.githubusercontent.com/CrackingShells/.github/main/resources/images/cs_icon_light_bg.png');
+
+      - name: Send Discord notification
+        uses: sarisia/actions-status-discord@v1
+        with:
+          webhook: ${{ secrets.DISCORD_HATCH_ANNOUNCEMENTS }}
+          nodetail: true
+          content: ${{ steps.discord.outputs.content }}
+          title: ${{ steps.discord.outputs.title }}
+          description: ${{ steps.discord.outputs.description }}
+          color: ${{ steps.discord.outputs.color }}
+          username: ${{ steps.discord.outputs.username }}
+          image: ${{ steps.discord.outputs.image }}
+          avatar_url: ${{ steps.discord.outputs.avatar_url }}

.github/workflows/release-discord-notification.yml

@@ -51,7 +51,7 @@
       "@semantic-release/git",
       {
         "assets": ["CHANGELOG.md", "pyproject.toml"],
-        "message": "chore(release): ${nextRelease.version}\n\n${nextRelease.notes}"
+        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
       }
     ],
     [