feat: replace semantic-release with github-actions[bot] release workflow (#16)

* feat: replace semantic-release with github-actions[bot] release workflow

- Remove semantic-release and all related dependencies
- Implement github-actions[bot] based release workflow
- Add manual release trigger with patch/minor/major options
- Use github-actions[bot] identity for version commits and tags
- Maintain dual publishing (npm + GitHub Packages)
- Add automatic GitHub release creation with changelog
- Simplify release process and remove NPM token authentication issues
- Support both automatic (on version change) and manual releases
- Inspired by .examples/sample-repo proven pattern

* docs: update all semantic-release references to github-actions[bot]

- Update README.md release section with new workflow instructions
- Update CONTRIBUTING.md with automatic and manual release processes
- Regenerate package-lock.json without semantic-release dependencies
- Remove all references to semantic-release configuration
- Document new github-actions[bot] based release workflow

* fix: resolve Biome installation and update PR title check

- Reinstall @biomejs/biome to fix missing cli-linux-x64 module
- Update PR title check workflow with better configuration
- Add subject pattern validation and clearer error messages
- Maintain conventional commit enforcement for changelog generation
- Fix linting issues that were blocking CI

* fix: regenerate clean package-lock.json after dependency cleanup

- Remove corrupted node_modules and package-lock.json
- Clean npm install to fix Rollup/Vitest dependency issues
- All tests now passing (55/55)
- Biome linting working correctly
- Complete dependency tree cleanup after semantic-release removal

Author: kauandotnet

.github/workflows/pr-title.yml

@@ -12,6 +12,7 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
+          # Conventional commit types for better changelog generation
           types: |
             build
             chore
@@ -24,3 +25,11 @@ jobs:
             revert
             style
             test
+          # Allow any scope
+          requireScope: false
+          # Custom subject pattern - allow any descriptive text
+          subjectPattern: ^.{1,100}$
+          subjectPatternError: |
+            The subject "{subject}" found in the pull request title "{title}"
+            didn't match the configured pattern. Please ensure that the subject
+            doesn't start with an uppercase character and is descriptive.

.github/workflows/release.yml

@@ -2,12 +2,22 @@ name: Release
 
 on:
   push:
-    branches:
-      - main
-      - next
-      - beta
-      - alpha
-      - dev
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      release-type:
+        description: "Type of release"
+        required: true
+        default: "auto"
+        type: choice
+        options:
+          - auto
+          - patch
+          - minor
+          - major
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
 
 permissions:
   contents: write
@@ -18,77 +28,180 @@ permissions:
   actions: write
 
 jobs:
-  # Run tests before release
-  test:
+  # Pre-release validation
+  validate:
+    name: Pre-release Validation
     runs-on: ubuntu-latest
+    timeout-minutes: 20
+    outputs:
+      should-release: ${{ steps.check-changes.outputs.should-release }}
+
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
         with:
           node-version: 20
           cache: "npm"
-      - run: npm ci
-      - run: npm run typecheck
-      - run: npm run lint
-      - run: npm test
-      - run: npm run build
 
-  # Release job that depends on tests passing
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Check for version changes
+        id: check-changes
+        run: |
+          # Check if this is a manual release
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            echo "should-release=true" >> $GITHUB_OUTPUT
+            echo "✅ Manual release triggered"
+            exit 0
+          fi
+
+          # Check if package.json version changed in this push
+          if git diff HEAD~1 HEAD --name-only | grep -q "package.json"; then
+            if git diff HEAD~1 HEAD package.json | grep -q '"version"'; then
+              echo "should-release=true" >> $GITHUB_OUTPUT
+              echo "✅ Version change detected in package.json"
+            else
+              echo "should-release=false" >> $GITHUB_OUTPUT
+              echo "ℹ️ No version change in package.json"
+            fi
+          else
+            echo "should-release=false" >> $GITHUB_OUTPUT
+            echo "ℹ️ No package.json changes"
+          fi
+
+      - name: Build packages
+        run: npm run build
+
+      - name: Run tests
+        run: npm test
+        timeout-minutes: 10
+
+      - name: Verify package can be packed
+        run: npm pack --dry-run
+
+  # Release job - only runs if validation passes and changes detected
   release:
-    needs: test
+    name: Release
+    needs: validate
     runs-on: ubuntu-latest
+    if: needs.validate.outputs.should-release == 'true'
     outputs:
-      released: ${{ steps.release.outputs.released }}
-      version: ${{ steps.release.outputs.version }}
-      major: ${{ steps.release.outputs.major }}
-      minor: ${{ steps.release.outputs.minor }}
-      patch: ${{ steps.release.outputs.patch }}
+      published: ${{ steps.publish.outputs.published }}
+      version: ${{ steps.get-version.outputs.version }}
+
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
 
-      - uses: actions/setup-node@v4
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
         with:
           node-version: 20
           cache: "npm"
           registry-url: "https://registry.npmjs.org"
 
-      - run: npm ci
-      - run: npm run build
+      - name: Install dependencies
+        run: npm ci
 
-      # Verify package can be packed
-      - run: npm pack --dry-run
+      - name: Build package
+        run: npm run build
+
+      - name: Handle manual version bump
+        if: github.event_name == 'workflow_dispatch' && github.event.inputs.release-type != 'auto'
+        run: |
+          # Bump version based on input
+          npm version ${{ github.event.inputs.release-type }} --no-git-tag-version
+
+          # Commit version change
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add package.json package-lock.json
+          git commit -m "chore: bump version to $(node -p "require('./package.json').version")"
+          git push origin main
+
+      - name: Get current version
+        id: get-version
+        run: |
+          version=$(node -p "require('./package.json').version")
+          echo "version=$version" >> $GITHUB_OUTPUT
+          echo "📦 Current version: $version"
 
-      - name: Release
-        id: release
-        run: npx semantic-release
+      - name: Create git tag
+        run: |
+          version="${{ steps.get-version.outputs.version }}"
+          tag_name="v$version"
+
+          # Check if tag already exists
+          if git tag -l | grep -q "^${tag_name}$"; then
+            echo "ℹ️ Tag $tag_name already exists, skipping tag creation"
+          else
+            git tag "$tag_name"
+            git push origin "$tag_name"
+            echo "✅ Created and pushed tag $tag_name"
+          fi
+
+      - name: Publish to npm
+        id: publish
+        run: |
+          # Check if this version is already published
+          if npm view docling-sdk@${{ steps.get-version.outputs.version }} version >/dev/null 2>&1; then
+            echo "ℹ️ Version ${{ steps.get-version.outputs.version }} already published to npm"
+            echo "published=false" >> $GITHUB_OUTPUT
+          else
+            npm publish
+            echo "✅ Published docling-sdk@${{ steps.get-version.outputs.version }} to npm"
+            echo "published=true" >> $GITHUB_OUTPUT
+          fi
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
-          GIT_AUTHOR_NAME: semantic-release-bot
-          GIT_AUTHOR_EMAIL: [email protected]
-          GIT_COMMITTER_NAME: semantic-release-bot
-          GIT_COMMITTER_EMAIL: [email protected]
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
-  # Optional: Notify on successful release
-  notify:
-    needs: release
-    runs-on: ubuntu-latest
-    if: needs.release.outputs.released == 'true'
-    steps:
-      - name: Notify Release
+      - name: Create GitHub Release
+        if: steps.publish.outputs.published == 'true'
         run: |
-          echo "🎉 Successfully released version ${{ needs.release.outputs.version }}"
-          echo "📦 Package: https://www.npmjs.com/package/docling-sdk"
-          echo "🏷️ GitHub Release: https://github.com/btwld/docling-sdk/releases/tag/v${{ needs.release.outputs.version }}"
+          version="${{ steps.get-version.outputs.version }}"
+          tag_name="v$version"
+
+          # Generate release notes from recent commits
+          release_notes=$(git log --pretty=format:"- %s" $(git describe --tags --abbrev=0 HEAD~1 2>/dev/null || echo "HEAD~10")..HEAD | head -20)
+
+          # Create GitHub release
+          gh release create "$tag_name" \
+            --title "Release $version" \
+            --notes "## Changes in $version
+
+$release_notes
+
+## Installation
+
+\`\`\`bash
+npm install docling-sdk@$version
+\`\`\`
+
+## Links
+- 📦 [npm package](https://www.npmjs.com/package/docling-sdk)
+- 📚 [Documentation](https://github.com/btwld/docling-sdk#readme)" \
+            --latest
+
+          echo "✅ Created GitHub release for $tag_name"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
   # Publish to GitHub Package Registry
   github-packages:
+    name: GitHub Packages
     needs: release
     runs-on: ubuntu-latest
-    if: needs.release.outputs.released == 'true'
+    if: needs.release.outputs.published == 'true'
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
@@ -116,3 +229,17 @@ jobs:
       # Restore original package.json
       - name: Restore package.json
         run: mv package.json.backup package.json
+
+  # Notify on successful release
+  notify:
+    name: Notify Success
+    needs: [release, github-packages]
+    runs-on: ubuntu-latest
+    if: needs.release.outputs.published == 'true'
+    steps:
+      - name: Notify Release
+        run: |
+          echo "🎉 Successfully released docling-sdk@${{ needs.release.outputs.version }}"
+          echo "📦 npm: https://www.npmjs.com/package/docling-sdk"
+          echo "📦 GitHub Packages: https://github.com/btwld/docling-sdk/packages"
+          echo "🏷️ GitHub Release: https://github.com/btwld/docling-sdk/releases/tag/v${{ needs.release.outputs.version }}"