add automation script

Author: ddurzo

.github/workflows/build-extension.yml

@@ -0,0 +1,75 @@
+name: Build Extension
+
+on:
+  push:
+    branches:
+      - '**'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+concurrency:
+  group: extension-build-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  package:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Compute CI version
+        shell: bash
+        run: |
+          set -euo pipefail
+          BASE_VERSION="$(node -p "require('./package.json').version.split('-')[0]")"
+          CI_VERSION="${BASE_VERSION}-ci.${GITHUB_RUN_NUMBER}"
+          node -e "const fs=require('fs'); const pkg=JSON.parse(fs.readFileSync('package.json','utf8')); pkg.version='${CI_VERSION}'; fs.writeFileSync('package.json', JSON.stringify(pkg, null, 2) + '\n');"
+          echo "CI_VERSION=${CI_VERSION}" >> "$GITHUB_ENV"
+          echo "VSIX_NAME=agentic-flow-${CI_VERSION}.vsix" >> "$GITHUB_ENV"
+
+      - name: Build extension
+        run: npm run compile
+
+      - name: Package VSIX
+        shell: bash
+        run: |
+          set -euo pipefail
+          mkdir -p dist
+          npx @vscode/vsce package --out "dist/${VSIX_NAME}"
+
+      - name: Upload workflow artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ env.VSIX_NAME }}
+          path: dist/${{ env.VSIX_NAME }}
+          if-no-files-found: error
+
+      - name: Publish prerelease on main
+        if: github.ref == 'refs/heads/main'
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: latest-build
+          name: Latest Build
+          prerelease: true
+          make_latest: false
+          target_commitish: ${{ github.sha }}
+          files: dist/${{ env.VSIX_NAME }}
+          body: |
+            Automated extension build from `${{ github.sha }}`.
+
+            Version: `${{ env.CI_VERSION }}`
+            Branch: `${{ github.ref_name }}`
+            Commit: `${{ github.event.head_commit.message }}`

README.md

@@ -198,6 +198,12 @@ npm run dev:host:workspace
 npm run package
 ```
 
+## CI / Releases
+
+- Every push builds and packages a `.vsix` in GitHub Actions as a downloadable workflow artifact
+- Pushes to `main` also refresh the GitHub prerelease `latest-build` with the newest `.vsix`
+- CI rewrites the extension version only inside the runner to a unique prerelease form like `1.0.0-ci.42`, so each generated build is installable as a distinct package
+
 ---
 
 ## License

package.json

@@ -194,6 +194,7 @@
     "compile": "tsc -p ./",
     "watch": "tsc -watch -p ./",
     "package": "vsce package",
+    "package:ci": "vsce package --out dist/agentic-flow.vsix",
     "dev:host": "code . --new-window --extensionDevelopmentPath=. --user-data-dir ./.vscode-test/user-data --extensions-dir ./.vscode-test/extensions",
     "dev:host:insiders": "code-insiders . --new-window --extensionDevelopmentPath=. --user-data-dir ./.vscode-test/user-data --extensions-dir ./.vscode-test/extensions",
     "dev:host:workspace": "mkdir -p ./.vscode-test/workspace && code ./.vscode-test/workspace --new-window --extensionDevelopmentPath=. --user-data-dir ./.vscode-test/user-data --extensions-dir ./.vscode-test/extensions"