feat: Add semantic release and commitlint

https://harperdb.atlassian.net/browse/STUDIO-188

Author: dawsontoth

.env

@@ -10,6 +10,9 @@ jobs:
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          fetch-tags: true
       - name: Set up Node.js
         uses: actions/setup-node@v4
       - name: Set up pnpm
@@ -20,6 +23,11 @@ jobs:
         run: pnpm test
       - name: Run lint
         run: pnpm lint
+      - name: Determine version tag for build
+        run: |
+          VERSION_TAG="v${GITHUB_SHA:0:7}"
+          echo "$VERSION_TAG"
+          echo "VITE_STUDIO_VERSION=$VERSION_TAG" >> $GITHUB_ENV
       - name: Build dev
         run: pnpm build:dev
       - name: Install HarperDB

.github/workflows/deploy-dev.yaml

@@ -9,6 +9,9 @@ jobs:
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          fetch-tags: true
       - name: Set up Node.js
         uses: actions/setup-node@v4
       - name: Set up pnpm
@@ -19,6 +22,13 @@ jobs:
         run: pnpm test
       - name: Run lint
         run: pnpm lint
+      - name: Determine version tag for build
+        run: |
+          VERSION_TAG=$(git tag --points-at HEAD | grep -E '^v?[0-9]+\.[0-9]+\.[0-9]+' | sort -V | tail -n1)
+          if [ -z "$VERSION_TAG" ]; then
+            VERSION_TAG="v0.0.0+${GITHUB_SHA:0:7}"
+          fi
+          echo "VITE_STUDIO_VERSION=$VERSION_TAG" >> $GITHUB_ENV
       - name: Build prod
         run: pnpm build:prod
       - name: Install HarperDB

.github/workflows/deploy-prod.yaml

@@ -7,9 +7,14 @@ on:
 jobs:
   deployToStage:
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          fetch-tags: true
       - name: Set up Node.js
         uses: actions/setup-node@v4
       - name: Set up pnpm
@@ -20,7 +25,20 @@ jobs:
         run: pnpm test
       - name: Run lint
         run: pnpm lint
-      - name: Build stage
+      - name: Verify stage can build
+        run: pnpm build:stage
+      - name: Semantic release
+        run: pnpm release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - name: Determine version tag for build
+        run: |
+          VERSION_TAG=$(git tag --points-at HEAD | grep -E '^v?[0-9]+\.[0-9]+\.[0-9]+' | sort -V | tail -n1)
+          if [ -z "$VERSION_TAG" ]; then
+            VERSION_TAG="v0.0.0+${GITHUB_SHA:0:7}"
+          fi
+          echo "VITE_STUDIO_VERSION=$VERSION_TAG" >> $GITHUB_ENV
+      - name: Build stage for release
         run: pnpm build:stage
       - name: Install HarperDB
         run: npm install -g [email protected]

.github/workflows/deploy-stage.yaml

@@ -0,0 +1,18 @@
+name: Verify Commits
+on:
+  pull_request:
+    types: [opened, synchronize, edited, reopened, ready_for_review]
+  push:
+    branches: [dev, stage, prod]
+jobs:
+  commitlint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Commitlint
+        uses: wagoid/commitlint-github-action@v6
+        with:
+          configFile: commitlint.config.cjs

.github/workflows/verify-commits.yaml

@@ -0,0 +1,10 @@
+module.exports = {
+	extends: ['@commitlint/config-conventional'],
+	rules: {
+		'subject-case': [
+			2,
+			'always',
+			['sentence-case', 'start-case', 'pascal-case', 'upper-case'],
+		],
+	},
+};

commitlint.config.cjs

@@ -11,13 +11,40 @@
 		"build:dev": "tsc -b && vite build --mode dev",
 		"build:stage": "tsc -b && vite build --mode stage",
 		"build:prod": "tsc -b && vite build --mode prod",
+		"commitlint": "commitlint --from=HEAD~1 --to=HEAD",
+		"release": "semantic-release",
 		"update-sdk": "npx -y dotenv-cli -e .env.local -- npm run update-sdk:fetch && npx -y openapi-typescript --root-types --alphabetize --enum ./dist/central-manager.json -o ./src/lib/api.gen.d.ts",
 		"update-sdk:fetch": "mkdir -p dist && curl --location \"$VITE_CENTRAL_MANAGER_API_URL/openapi\" -u \"$HDB_ADMIN_USERNAME_FOR_OPENAPI:$HDB_ADMIN_PASSWORD_FOR_OPENAPI\" -o ./dist/central-manager.json",
 		"lint": "eslint .",
 		"preview": "vite preview",
 		"test": "vitest run",
 		"test:watch": "vitest"
 	},
+	"release": {
+		"branches": ["stage"],
+		"tagFormat": "v${version}",
+		"plugins": [
+			["@semantic-release/commit-analyzer", {
+				"preset": "conventionalcommits",
+				"releaseRules": [
+					{"type": "feat", "release": "minor"},
+					{"type": "fix", "release": "patch"},
+					{"type": "perf", "release": "patch"},
+					{"type": "refactor", "release": "patch"},
+					{"type": "chore", "release": "patch"},
+					{"type": "docs", "release": "patch"},
+					{"type": "style", "release": "patch"},
+					{"type": "test", "release": "patch"},
+					{"type": "build", "release": "patch"},
+					{"type": "ci", "release": "patch"},
+					{"type": "revert", "release": "patch"},
+					{"type": "*", "release": "patch"}
+				]
+			}],
+			"@semantic-release/release-notes-generator",
+			"@semantic-release/github"
+		]
+	},
 	"dependencies": {
 		"@datadog/browser-rum": "^6.18.0",
 		"@datadog/browser-rum-react": "^6.18.0",
@@ -60,7 +87,12 @@
 		"zod": "^3.25.0"
 	},
 	"devDependencies": {
+		"@commitlint/cli": "^19.5.0",
+		"@commitlint/config-conventional": "^19.5.0",
 		"@eslint/js": "^9.19.0",
+		"@semantic-release/commit-analyzer": "^13.0.0",
+		"@semantic-release/release-notes-generator": "^14.0.0",
+		"@semantic-release/github": "^10.0.7",
 		"@tanstack/router-devtools": "^1.111.11",
 		"@types/react": "^19.0.8",
 		"@types/react-dom": "^19.0.3",
@@ -70,6 +102,7 @@
 		"eslint-plugin-react-refresh": "^0.4.18",
 		"globals": "^15.14.0",
 		"oxlint": "^0.15.12",
+		"semantic-release": "^24.1.0",
 		"typescript": "~5.7.2",
 		"typescript-eslint": "^8.22.0",
 		"vite": "^6.1.0",