v8: establish the standalone @wdio/browserstack-service v8 maintenance line

.changeset/README.md

@@ -0,0 +1,12 @@
+# Changesets
+
+This repo uses [Changesets](https://github.com/changesets/changesets) to version and publish
+**`@wdio/browserstack-service`** on BrowserStack's own cadence (independent of WebdriverIO's
+release schedule).
+
+- Add a changeset for any user-facing change: `npm run changeset` (pick patch/minor/major).
+- On merge to `main` (the v9 line) or `v8` (the v8 line), the Release workflow opens a
+  "Version Packages" PR; merging that PR publishes to npm via OIDC trusted publishing.
+- The gRPC/protobuf client is generated inline from the bundled `.proto` files at build time
+  (`buf generate`) — it is no longer a separate workspace package, so `config.json` `ignore` is
+  empty and there is nothing extra for this pipeline to skip.

.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.0.0/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "v8",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,33 @@
+## What is this about?
+<!-- Give a small description related to the changes you have made -->
+
+## Related Jira task/s
+<!-- Add associated JIRA links -->
+
+## Release (mandatory for every PR — required for the `ready-for-review` label)
+<!-- CI gates the `ready-for-review` label on the **version bump** and the **internal release notes** below. Customer-facing notes + type are optional but strongly encouraged for the daily release. -->
+
+**Version bump:** *(required — tick exactly one)*
+<!-- minor = ANY new feature/capability (backwards-compatible). patch = bug fix or trivial change only. New features mislabeled as patch is the common mistake — when unsure, choose minor. -->
+- [ ] minor (backwards-compatible feature)
+- [ ] patch (bug fix or other small change)
+
+**Release notes type:** *(optional)*
+- [ ] New Feature
+- [ ] Bug Fix
+- [ ] Other Improvement
+
+**Release notes (customer-facing):** *(optional but encouraged)*
+<!-- 1-3 bullets in customer language, e.g. "Fixed test results not being reported when using the CLI." -->
+- 
+
+**Release notes (internal):** *(required — engineer-facing; what actually changed / why)*
+<!-- REQUIRED: at least one non-empty bullet — the ready-for-review gate checks this. Dev-facing notes for the internal CHANGELOG.md (non-customer-facing). -->
+- 
+
+## Checklist
+- [ ] Ready to review
+- [ ] Has it been tested locally?
+
+## PR Validations
+Run Tests: Comment RUN_TESTS to trigger sanity tests.

.github/workflows/changeset-from-pr.yml

@@ -0,0 +1,102 @@
+name: Changeset from PR template
+
+# Auto-generates the changeset for a PR from its "## Release" section (the same
+# section the ready-for-review gate enforces), so engineers never hand-run
+# `npx changeset`. Reads the ticked version bump (minor/patch) + the release notes
+# and commits `.changeset/pr-<number>.md` to the PR branch. Idempotent: re-runs on
+# every body edit and only commits when the derived changeset actually changes, so
+# the bot's own push (which re-fires `synchronize`) settles in one no-op pass.
+#
+# Scope: skips forks (no write token — they add a changeset manually), the
+# changesets "Version Packages" PR (head `changeset-release/*`), and PRs labelled
+# `skip-changeset` (CI/docs/chore). The ready-for-review gate still independently
+# REQUIRES the bump + internal notes; this workflow only GENERATES when they're valid.
+
+on:
+  pull_request:
+    types: [opened, edited, synchronize, reopened, labeled, unlabeled]
+
+concurrency:
+  group: changeset-from-pr-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+permissions:
+  contents: write
+
+jobs:
+  generate:
+    if: >-
+      github.event.pull_request.state == 'open' &&
+      github.event.pull_request.head.repo.full_name == github.repository &&
+      !startsWith(github.event.pull_request.head.ref, 'changeset-release/') &&
+      !contains(github.event.pull_request.labels.*.name, 'skip-changeset')
+    runs-on: ubuntu-latest
+    steps:
+      - name: Derive + commit the changeset from the Release section
+        uses: actions/github-script@60a0d83039c74a4aee543508d2ffcb1c3799cdea # v7.0.1
+        with:
+          script: |
+            const PKG = '@wdio/browserstack-service';
+            const pr = context.payload.pull_request;
+            const body = pr.body || '';
+            const head = pr.head.ref;
+
+            // --- isolate the "## Release" block (mirrors ready-for-review-label.yml) ---
+            const releaseBlock = body.split(/(?=^## )/m)
+              .find(s => /^##[ \t]*Release[ \t]*(\(|$)/m.test(s)) || '';
+            if (!releaseBlock) {
+              core.info('No "## Release" section in the PR body — the ready-for-review gate flags this. Skipping changeset generation.');
+              return;
+            }
+
+            // Count bump ticks only BEFORE the first "Release notes (" header, so a
+            // checkbox-looking bullet inside the notes can never be mistaken for a bump.
+            const bumpRegion = releaseBlock.split(/^\*\*Release notes \(/m)[0];
+            const bumps = [...bumpRegion.matchAll(/- \[[xX]\]\s*(minor|patch)(?=\s|\(|$)/g)].map(m => m[1].toLowerCase());
+            if (bumps.length !== 1) {
+              core.info(`Expected exactly one version-bump tick (minor|patch), found ${bumps.length}. Skipping (ready-for-review gate flags this).`);
+              return;
+            }
+            const bump = bumps[0];
+
+            // Extract non-empty bullets under a "**Release notes (<label>):**" header,
+            // stopping at the next bold header; strip the header-line remainder + HTML comments.
+            const extractNotes = (label) => {
+              const parts = releaseBlock.split(new RegExp('^\\*\\*Release notes \\(' + label + '\\):\\*\\*', 'm'));
+              if (parts.length < 2) return '';
+              const region = parts[1].replace(/^[^\n]*\n?/, '').split(/^\*\*/m)[0].replace(/<!--[\s\S]*?-->/g, '');
+              return region.split('\n').map(l => l.trim())
+                .filter(l => /^[-*]\s+\S/.test(l))
+                .map(l => l.replace(/^[-*]\s+/, '- '))
+                .join('\n');
+            };
+            // Public CHANGELOG prefers the customer-facing notes; fall back to the
+            // (required) internal notes, then the PR title as a last resort.
+            const summary = extractNotes('customer-facing') || extractNotes('internal') || `- ${pr.title}`;
+
+            const content = `---\n"${PKG}": ${bump}\n---\n\n${summary}\n`;
+            const filePath = `.changeset/pr-${pr.number}.md`;
+
+            // Idempotent: only write when the derived changeset differs from what's on the branch.
+            let sha;
+            try {
+              const cur = await github.rest.repos.getContent({ ...context.repo, path: filePath, ref: head });
+              sha = cur.data.sha;
+              const existing = Buffer.from(cur.data.content, 'base64').toString('utf8');
+              if (existing === content) {
+                core.info('Changeset already up to date — no commit.');
+                return;
+              }
+            } catch (e) {
+              if (e.status !== 404) throw e; // 404 = file not yet present
+            }
+
+            await github.rest.repos.createOrUpdateFileContents({
+              ...context.repo,
+              path: filePath,
+              branch: head,
+              message: `chore(changeset): auto-generate from PR template (${bump})`,
+              content: Buffer.from(content).toString('base64'),
+              ...(sha ? { sha } : {}),
+            });
+            core.notice(`Wrote ${filePath} — bump: ${bump}\n${summary}`);

.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+      - v8
+
+permissions:
+  contents: read
+
+jobs:
+  build-test:
+    name: Build & test (node ${{ matrix.node-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        node-version: ['18.20', '20', '22']
+    steps:
+      - name: Checkout
+        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+
+      - name: Setup Node
+        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Test
+        run: npm test