Prepare VS Code Check release pipeline

Author: sm18lr88

.github/workflows/ci.yml

@@ -9,12 +9,14 @@ on:
   pull_request:
 
 permissions:
-  contents: write
+  contents: read
 
 jobs:
   build:
     name: Type-check, build, and package
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
 
     steps:
       - name: Checkout
@@ -32,19 +34,64 @@ jobs:
       - name: Type-check and build
         run: npm run ci
 
+      - name: Read package version
+        id: package
+        shell: bash
+        run: echo "version=$(node -p 'require(\"./package.json\").version')" >> "$GITHUB_OUTPUT"
+
+      - name: Create artifact directory
+        run: mkdir -p artifacts
+
       - name: Package VSIX
-        run: npm run package -- --out vs-code-check-${{ github.ref_name }}.vsix
+        run: npm run package -- --out artifacts/vs-code-check-${{ steps.package.outputs.version }}.vsix
 
       - name: Upload VSIX artifact
         uses: actions/upload-artifact@v4
         with:
           name: vs-code-check-vsix
-          path: vs-code-check-${{ github.ref_name }}.vsix
+          path: artifacts/*.vsix
+          if-no-files-found: error
+
+  release:
+    name: Publish GitHub Release
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+
+      - name: Validate release tag
+        shell: bash
+        run: |
+          package_version="$(node -p 'require("./package.json").version')"
+          test "v${package_version}" = "${GITHUB_REF_NAME}"
+
+      - name: Prepare release notes
+        id: notes
+        shell: bash
+        run: |
+          notes_path=".github/release-notes/${GITHUB_REF_NAME}.md"
+          if [ ! -f "${notes_path}" ]; then
+            printf "# VS Code Check %s\n\nAutomated release for commit %s.\n" "${GITHUB_REF_NAME}" "${GITHUB_SHA}" > release-notes.md
+            notes_path="release-notes.md"
+          fi
+          echo "path=${notes_path}" >> "$GITHUB_OUTPUT"
+
+      - name: Download VSIX artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: vs-code-check-vsix
+          path: artifacts
 
       - name: Publish GitHub Release
-        if: startsWith(github.ref, 'refs/tags/v')
         uses: softprops/action-gh-release@v2
         with:
           name: VS Code Check ${{ github.ref_name }}
-          body_path: .github/release-notes/${{ github.ref_name }}.md
-          files: vs-code-check-${{ github.ref_name }}.vsix
+          body_path: ${{ steps.notes.outputs.path }}
+          files: artifacts/*.vsix

README.md

@@ -1,5 +1,7 @@
 # VS Code Check
 
+[![CI](https://github.com/sm18lr88/VS_Code_Check/actions/workflows/ci.yml/badge.svg)](https://github.com/sm18lr88/VS_Code_Check/actions/workflows/ci.yml)
+
 A concise VS Code extension that refreshes Problems diagnostics by loading lintable workspace files on demand.
 
 ## Features
@@ -68,6 +70,13 @@ Many linters and type checkers in VS Code only analyze open files. This extensio
 
 ## Installation
 
+### From GitHub
+
+Download the latest packaged `.vsix` from either:
+
+- The latest successful CI run artifact on the [CI workflow](https://github.com/sm18lr88/VS_Code_Check/actions/workflows/ci.yml)
+- A tagged [GitHub release](https://github.com/sm18lr88/VS_Code_Check/releases), when available
+
 ### From VSIX (Local)
 
 1. Download or build the `.vsix` file
@@ -84,6 +93,10 @@ npm run ci
 npm run package
 ```
 
+## CI/CD
+
+GitHub Actions runs on pushes to `master`, pull requests, and version tags. The workflow type-checks, builds, packages the extension into a `.vsix`, and uploads it as a downloadable workflow artifact. Tags named like `v1.1.1` also publish a GitHub Release with the VSIX attached.
+
 ## License
 
 MIT