Taskfile.yml

version: "3"

dotenv:
  - .env.local # Load environment variables from .env.local

vars:
  # Default values for local development
  CI_API_V4_URL: "https://gitlab.com/api/v4"
  # CI_PROJECT_ID: "69861189"
  PACKAGE_NAME: "semantic-version-manager"
  EXECUTABLE_NAME: "semantic-version-manager"
  BREW_FORMULA_NAME: "SemanticVersionManager"
  VERSION:
    sh: swift package plugin {{.EXECUTABLE_NAME}} show full

tasks:
  clean:
    cmds:
      - swift package clean
      - swift package reset
      - swift package purge-cache

  version:show:full:
    cmds:
      - echo "Current version is {{.VERSION}}"

  version:bump:patch:
    desc: Bump patch version and commit
    cmds:
      - swift package plugin {{.EXECUTABLE_NAME}} bump patch
      - git add version.json
      - |
        VERSION=$(swift package plugin {{.EXECUTABLE_NAME}} show full)
        git commit -m "chore: bump version to $VERSION"
        echo "Version bumped to $VERSION"

  version:bump:minor:
    desc: Bump minor version and commit
    cmds:
      - swift package plugin {{.EXECUTABLE_NAME}} bump minor
      - git add version.json
      - |
        VERSION=$(swift package plugin {{.EXECUTABLE_NAME}} show full)
        git commit -m "chore: bump version to $VERSION"
        echo "Version bumped to $VERSION"

  version:bump:major:
    desc: Bump major version and commit
    cmds:
      - swift package plugin {{.EXECUTABLE_NAME}} bump major
      - git add version.json
      - |
        VERSION=$(swift package plugin {{.EXECUTABLE_NAME}} show full)
        git commit -m "chore: bump version to $VERSION"
        echo "Version bumped to $VERSION"

  format:
    cmds:
      - |
        swift package plugin --allow-writing-to-package-directory format-source-code --targets \
        SemanticVersionKit SemanticVersionKitTests \
        SemanticVersionTool SemanticVersionToolTests \
        SemanticVersionPlugin SemanticVersionPluginTests \
        --swift-format-configuration .swift-format.json

  lint:
    cmds:
      - |
        swift package plugin lint-source-code --targets \
        SemanticVersionKit SemanticVersionKitTests \
        SemanticVersionTool SemanticVersionToolTests \
        SemanticVersionPlugin SemanticVersionPluginTests \
        --swift-format-configuration .swift-format.json

  review:
    cmds:
      - task: format
      - task: lint

  build:debug:
    cmds:
      - mkdir -p .build/debug/codecov
      - swift build --enable-code-coverage --build-tests

  test:
    cmds:
      - swift test --parallel --skip-build --enable-code-coverage
      - rm -rf default.profraw

  coverage-path:
    cmds:
      - swift test --show-codecov-path

  test:coverage:
    cmds:
      # - task: binary:install:local
      - swift package plugin code-coverage-review {{ .COVERAGE_PATH }} --threshold 85
    vars:
      COVERAGE_PATH:
        sh: swift test --show-codecov-path

  document:
    cmds:
      - |
        swift package \
        --allow-writing-to-directory ./docs \
        generate-documentation \
        --target SemanticVersionKit \
        --output-path ./docs \
        --hosting-base-path / \
        --transform-for-static-hosting
      #--hosting-base-path /public/{{.PACKAGE_NAME}}
      - |
        cat << EOF > docs/theme-settings.json
        {
          "theme": {
            "color": {
              "documentation-intro-fill": "rebeccapurple"
            }
          }
        }
        EOF

  binary:uninstall:
    cmds:
      - rm -rf bin/{{.EXECUTABLE_NAME}}

  build:release:
    cmds:
      - rm -rf dist
      - swift build -c release --arch arm64 --arch x86_64 --product {{.EXECUTABLE_NAME}}
      - mkdir -p dist
      - cp .build/apple/Products/Release/{{.EXECUTABLE_NAME}} dist/

  binary:install:
    cmds:
      - task: binary:uninstall
      - task: build:release
      - sudo cp "{{.EXECUTABLE_BUILD_BIN_PATH}}/semantic-version-manager" /usr/local/bin/semantic-version-manager
    vars:
      EXECUTABLE_BUILD_BIN_PATH:
        sh: swift build -c release --show-bin-path

  binary:install:local:
    cmds:
      - rm -rf bin
      - mkdir -p bin
      - cp "dist/semantic-version-manager" bin/semantic-version-manager
    vars:
      EXECUTABLE_BUILD_BIN_PATH:
        sh: swift build -c release --show-bin-path

  brew:generate-formula:
    desc: Generate Homebrew formula with project-specific URL
    cmds:
      - |
        URL="{{.CI_API_V4_URL}}/projects/{{.CI_PROJECT_ID}}/packages/generic/{{.PACKAGE_NAME}}/{{.VERSION}}/{{.PACKAGE_NAME}}-{{.VERSION}}.tar.gz"
        SHA256=$(shasum -a 256 dist/{{.PACKAGE_NAME}}-{{.VERSION}}.tar.gz | awk '{print $1}')

        mkdir -p Formula
        cat << EOF > Formula/{{.EXECUTABLE_NAME}}.rb
        class {{.BREW_FORMULA_NAME}} < Formula
          desc "Swift version management tool"
          homepage "https://gitlab.com/thecb4-universe/public/{{.PACKAGE_NAME}}"
          url "${URL}"
          sha256 "${SHA256}"
          license "MIT"
          version "{{.VERSION}}"

          def install
            bin.install "{{.EXECUTABLE_NAME}}"
          end

          test do
            system "#{bin}/{{.EXECUTABLE_NAME}}", "--version"
          end
        end
        EOF

        echo "Generated Homebrew formula:"
        cat Formula/{{.PACKAGE_NAME}}.rb

  brew:test:
    cmds:
      - brew install --build-from-source Formula/{{.EXECUTABLE_NAME}}.rb
      - "{{.EXECUTABLE_NAME}} --help"
      - brew uninstall {{.EXECUTABLE_NAME}}

  package:prepare:
    cmds:
      - task: build:release
      - tar -czf dist/{{.PACKAGE_NAME}}-{{.VERSION}}.tar.gz -C dist {{.EXECUTABLE_NAME}}

  package:registry-upload:
    desc: Upload release package to GitLab Registry
    cmds:
      - |
        # Use CI_JOB_TOKEN in CI, fallback to personal token locally
        if [ -z "${CI}" ]; then
          AUTH_HEADER="PRIVATE-TOKEN: {{.GITLAB_REGISTRY_TOKEN}}"
        else
          AUTH_HEADER="JOB-TOKEN: ${CI_JOB_TOKEN}"
        fi

        curl --location --header "${AUTH_HEADER}" \
             --upload-file dist/{{.PACKAGE_NAME}}-{{.VERSION}}.tar.gz \
             "{{.CI_API_V4_URL}}/projects/{{.CI_PROJECT_ID}}/packages/generic/{{.PACKAGE_NAME}}/{{.VERSION}}/{{.PACKAGE_NAME}}-{{.VERSION}}.tar.gz"
    vars:
      GITLAB_TOKEN: "{{.GITLAB_TOKEN | default}}"

  package:registry-delete:
    cmds:
      - |
        # Use CI_JOB_TOKEN in CI, fallback to personal token locally
        if [ -z "${CI}" ]; then
          AUTH_HEADER="PRIVATE-TOKEN: {{.GITLAB_REGISTRY_TOKEN}}"
        else
          AUTH_HEADER="JOB-TOKEN: ${CI_JOB_TOKEN}"
        fi

        curl --request DELETE --header "${AUTH_HEADER}" \
          "{{.CI_API_V4_URL}}/projects/{{.CI_PROJECT_ID}}/packages/generic/{{.PACKAGE_NAME}}/{{.VERSION}}/{{.PACKAGE_NAME}}"

  package:tag:
    cmds:
      - git tag -a {{.VERSION}} -m "Release version {{.VERSION}}"
      - git push origin {{.VERSION}}

  package:release:
    desc: Create GitLab release and attach package link
    cmds:
      - |
        # Set authentication header
        if [ -z "${CI}" ]; then
          AUTH_HEADER="PRIVATE-TOKEN: {{.GITLAB_REGISTRY_TOKEN}}"
        else
          AUTH_HEADER="JOB-TOKEN: ${CI_JOB_TOKEN}"
        fi

        # Construct the package URL
        PACKAGE_URL="{{.CI_API_V4_URL}}/projects/{{.CI_PROJECT_ID}}/packages/generic/{{.PACKAGE_NAME}}/{{.VERSION}}/{{.PACKAGE_NAME}}-{{.VERSION}}.tar.gz"

        # Create the release with asset link
        curl --header "Content-Type: application/json" \
             --header "${AUTH_HEADER}" \
             --data '{
               "name": "Release {{.VERSION}}",
               "tag_name": "{{.VERSION}}",
               "description": "Release for version {{.VERSION}}",
               "assets": {
                 "links": [
                   {
                     "name": "{{.PACKAGE_NAME}}-{{.VERSION}}.tar.gz",
                     "url": "'"${PACKAGE_URL}"'",
                     "link_type": "package"
                   }
                 ]
               }
             }' \
             --request POST "{{.CI_API_V4_URL}}/projects/{{.CI_PROJECT_ID}}/releases"

  pipeline:local:
    cmds:
      - task: version:show:full
      - task: review
      - task: build:debug
      - task: test
      - task: test:coverage
      - task: document

  pipeline:homebrew:
    desc: Build and test Homebrew formula locally
    cmds:
      - task: package:prepare
      - task: brew:generate-formula
      - task: package:registry-upload
      - task: brew:test

  brew:install:remote:
    cmds:
      - brew uninstall --force {{.EXECUTABLE_NAME}} || true
      - brew untap thecb4-universe/{{.PACKAGE_NAME}} || true
      - brew tap thecb4-universe/{{.PACKAGE_NAME}} https://gitlab.com/thecb4-universe/public/{{.PACKAGE_NAME}}.git
      - brew install thecb4-universe/{{.PACKAGE_NAME}}/{{.EXECUTABLE_NAME}}
      - "{{.EXECUTABLE_NAME}} --help"
      - brew uninstall {{.EXECUTABLE_NAME}}
      - brew untap thecb4-universe/{{.PACKAGE_NAME}}

  deploy:documentation:
    cmds:
      - mkdir -p public/
      - cp -r docs/* public/
      - find public/ -type d -exec chmod 755 {} \; # Set permissions for directories
      - find public/ -type f -exec chmod 644 {} \; # Set permissions for files

  # Comprehensive Release Tasks
  release:validate:
    desc: Validate the codebase is ready for release
    cmds:
      - task: pipeline:local
      - echo "All tests passed, coverage met, and code formatted"

  release:prepare:
    desc: Prepare the release artifacts
    cmds:
      - task: package:prepare
      - task: brew:generate-formula
      - git add Formula/{{.EXECUTABLE_NAME}}.rb
      - |
        git commit -m "chore: update Homebrew formula for v{{.VERSION}}" || echo "No changes to commit"
      - echo "Release artifacts prepared and formula committed"

  release:publish:
    desc: Publish the release to registries and create tags
    cmds:
      - task: package:registry-upload
      - task: package:tag
      - task: package:release
      - echo "Package uploaded, tag created, and release published"

  release:finalize:
    desc: Final steps and notifications
    cmds:
      - git push origin main
      - echo "Release {{.VERSION}} completed successfully!"
      - |
        echo "Package URL: {{.CI_API_V4_URL}}/projects/{{.CI_PROJECT_ID}}/packages/generic/{{.PACKAGE_NAME}}/{{.VERSION}}/{{.PACKAGE_NAME}}-{{.VERSION}}.tar.gz"
      - |
        echo "Release URL: https://gitlab.com/thecb4-universe/public/{{.PACKAGE_NAME}}/-/releases/{{.VERSION}}"

  release:full:
    desc: Complete release process with validation, build, tag, and publish
    preconditions:
      - sh: git diff --quiet
        msg: "Working directory has uncommitted changes. Please commit or stash them first."
      - sh: git diff --cached --quiet  
        msg: "Staging area has uncommitted changes. Please commit or stash them first."
    cmds:
      - task: release:validate
      - task: release:prepare
      - task: release:publish
      - task: release:finalize

  release:patch:
    desc: Create a patch release (bug fixes)
    cmds:
      - task: version:bump:patch
      - task: release:full

  release:minor:
    desc: Create a minor release (new features)
    cmds:
      - task: version:bump:minor
      - task: release:full

  release:major:
    desc: Create a major release (breaking changes)
    cmds:
      - task: version:bump:major
      - task: release:full

  release:dry-run:
    desc: Test the release process without publishing
    cmds:
      - task: release:validate
      - task: build:release
      - tar -czf dist/{{.PACKAGE_NAME}}-{{.VERSION}}.tar.gz -C dist {{.EXECUTABLE_NAME}}
      - task: brew:generate-formula
      - echo "Dry run completed. Release {{.VERSION}} is ready."
      - echo "Review generated formula at Formula/{{.EXECUTABLE_NAME}}.rb"
      - echo "Package would be at dist/{{.PACKAGE_NAME}}-{{.VERSION}}.tar.gz"

  release:rollback:
    desc: Rollback a failed release
    cmds:
      - |
        git tag -d {{.VERSION}} || echo "Tag not found locally"
      - |
        git push origin :refs/tags/{{.VERSION}} || echo "Tag not found on remote"
      - task: package:registry-delete
      - git reset --hard HEAD~1
      - echo "Rolled back release {{.VERSION}}"