chore: implement release-please for automated releases (#10)

Add release-please GitHub Action for automated versioning and changelog
generation based on conventional commits.

- Add release-please workflow triggered on push to main
- Configure PHP release type for composer.json version bumping
- Initialize changelog and manifest at version 0.1.0
- Convert lightweight tags to annotated tags for git describe compatibility

Closes #8

Co-authored-by: Claude Opus 4.5 <[email protected]>

Author: kojiromike

.github/workflows/release-please.yml

@@ -0,0 +1,62 @@
+name: Release Please
+
+on:
+  push:
+    branches:
+    - main
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Run Release Please
+      id: release
+      uses: googleapis/release-please-action@v4
+      with:
+        token: ${{ secrets.GITHUB_TOKEN }}
+
+    # Convert lightweight tag to annotated tag
+    #
+    # Why this is needed:
+    # - Release-please creates releases via GitHub's release API, which creates lightweight tags
+    # - We require annotated tags because:
+    #   * git describe ignores lightweight tags by default (requires --tags flag)
+    #   * Lightweight tags are not copied into forks
+    #   * Annotated tags have proper metadata (creation date, tagger info, message)
+    #
+    # Why we do this after release creation:
+    # - We can't create the annotated tag before release-please runs because we don't know
+    #   the version number until release-please determines it from conventional commits
+    # - The GitHub release API will use an existing tag if present (per the target_commitish
+    #   parameter docs: "Unused if the Git tag already exists"), but release-please doesn't
+    #   provide a way to hook into the process between version determination and release creation
+    # - Using skip-github-release has known issues and breaks release-please's workflow
+    #   (see: https://github.com/googleapis/release-please/issues/1561)
+    #
+    # Race condition considerations:
+    # - There is a small window (milliseconds) between when the lightweight tag is created
+    #   and when we convert it to annotated where someone could fetch the lightweight tag
+    # - In practice, this risk is acceptable because:
+    #   * Most users interact with releases, not tags directly
+    #   * The window is extremely brief
+    #   * By the time manual tag fetches occur, the annotated version exists
+    #   * The GitHub release points to the correct commit regardless of tag type
+    - name: Convert to annotated tag
+      if: ${{ steps.release.outputs.release_created }}
+      run: |
+        git config user.name "github-actions[bot]"
+        git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+        git fetch --tags
+        TAG_NAME="${{ steps.release.outputs.tag_name }}"
+        git tag -a -f -m "Release ${TAG_NAME}" "${TAG_NAME}" "${TAG_NAME}^{commit}"
+        git push -f origin "${TAG_NAME}"

.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0"
+}

CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

release-please-config.json

@@ -0,0 +1,67 @@
+{
+  "release-type": "php",
+  "packages": {
+    ".": {
+      "package-name": "oce-cli-import-codes",
+      "changelog-path": "CHANGELOG.md",
+      "include-component-in-tag": false,
+      "include-v-in-tag": false
+    }
+  },
+  "bump-minor-pre-major": true,
+  "bump-patch-for-minor-pre-major": true,
+  "changelog-sections": [
+    {
+      "type": "feat",
+      "section": "Features"
+    },
+    {
+      "type": "fix",
+      "section": "Bug Fixes"
+    },
+    {
+      "type": "perf",
+      "section": "Performance Improvements"
+    },
+    {
+      "type": "revert",
+      "section": "Reverts"
+    },
+    {
+      "type": "docs",
+      "section": "Documentation"
+    },
+    {
+      "type": "style",
+      "section": "Styles",
+      "hidden": true
+    },
+    {
+      "type": "chore",
+      "section": "Miscellaneous Chores",
+      "hidden": true
+    },
+    {
+      "type": "refactor",
+      "section": "Code Refactoring"
+    },
+    {
+      "type": "test",
+      "section": "Tests",
+      "hidden": true
+    },
+    {
+      "type": "build",
+      "section": "Build System"
+    },
+    {
+      "type": "ci",
+      "section": "Continuous Integration",
+      "hidden": true
+    },
+    {
+      "type": "deps",
+      "section": "Dependencies"
+    }
+  ]
+}