ci: consolidate test harness adapter server (#1217)

This PR will implement the SDK testharness adapter server to the shared
utils.

This should also stabilize some of the flaky ci tests since we not
longer depend on a full repo build to ensure all contract test
dependencies are built

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Medium Risk**
> Medium risk because it changes how contract-test infrastructure is
built and launched in CI/local scripts, which can break contract test
pipelines despite not affecting production runtime.
> 
> **Overview**
> Consolidates the browser and React Native contract-test adapter
servers into `@launchdarkly/js-contract-test-utils`, adding an exported
`startAdapter()` API plus a new `sdk-testharness-server`/`sts` CLI with
configurable ports.
> 
> Removes the standalone `browser-contract-test-adapter` and
`react-native-contract-test-adapter` workspaces, updates contract-test
entity packages to start the adapter via `start:adapter`, and simplifies
GitHub Actions workflows to focus/build only the needed workspaces
(including updated cleanup process matching the new CLI).
> 
> Adjusts TypeScript build config in `contract-test-utils` to compile
the new adapter/CLI entrypoints, and fixes contract-test ESLint configs
by setting `tsconfigRootDir` for React and server-node.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
ebef965. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

<!-- devin-review-badge-begin -->

---

<a href="https://app.devin.ai/review/launchdarkly/js-core/pull/1217"
target="_blank">
  <picture>
<source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-open-in-devin-review-dark.svg?v=1">
<img
src="https://static.devin.ai/assets/gh-open-in-devin-review-light.svg?v=1"
alt="Open with Devin">
  </picture>
</a>
<!-- devin-review-badge-end -->

Author: joker23

.github/workflows/browser.yml

@@ -45,23 +45,20 @@ jobs:
 
       # Contract Tests
       - name: Install contract test dependencies
-        run: yarn workspaces focus browser-contract-test-adapter browser-contract-test-service
+        run: yarn workspaces focus browser-contract-test-service
 
       - name: Install Playwright browsers
         run: yarn workspace browser-contract-test-service install-playwright-browsers
 
       - name: Build shared contract test utils
-        run: yarn workspace @launchdarkly/js-contract-test-utils build:client
-
-      - name: Build contract test adapter
-        run: yarn workspace browser-contract-test-adapter run build
+        run: yarn workspaces foreach -pR --topological-dev --from '@launchdarkly/js-contract-test-utils' run build
 
       - name: Build contract test entity (browser app)
         run: yarn workspace browser-contract-test-service run build
 
       - name: Start contract test adapter in background
         run: |
-          yarn workspace browser-contract-test-adapter run start > /tmp/adapter.log 2>&1 &
+          yarn workspace browser-contract-test-service run start:adapter > /tmp/adapter.log 2>&1 &
           echo $! > /tmp/adapter.pid
 
       - name: Serve browser app with http-server
@@ -130,7 +127,7 @@ jobs:
           [ -f /tmp/adapter.pid ] && kill $(cat /tmp/adapter.pid) || true
           pkill -f "playwright" || true
           pkill -f "http-server" || true
-          pkill -f "browser-contract-test-adapter" || true
+          pkill -f "sdk-testharness-server" || true
 
   run-example:
     runs-on: ubuntu-latest

.github/workflows/react-native-contract-tests.yml

@@ -28,16 +28,13 @@ jobs:
           node-version: 24
 
       - name: Install dependencies
-        run: yarn workspaces focus react-native-contract-test-adapter react-native-contract-test-entity
+        run: yarn workspaces focus react-native-contract-test-entity
 
       - name: Build SDK and dependencies
         run: yarn workspaces foreach -pR --topological-dev --from '@launchdarkly/react-native-client-sdk' run build
 
       - name: Build shared contract test utils
-        run: yarn workspace @launchdarkly/js-contract-test-utils build:client
-
-      - name: Build contract test adapter
-        run: yarn workspace react-native-contract-test-adapter run build
+        run: yarn workspaces foreach -pR --topological-dev --from '@launchdarkly/js-contract-test-utils' run build
 
       - name: Enable KVM group perms (for emulator performance)
         run: |
@@ -71,7 +68,7 @@ jobs:
 
       - name: Start adapter in background
         run: |
-          yarn workspace react-native-contract-test-adapter run start > /tmp/adapter.log 2>&1 &
+          yarn workspace react-native-contract-test-entity run start:adapter > /tmp/adapter.log 2>&1 &
           echo $! > /tmp/adapter.pid
 
       - name: Wait for adapter to be ready

.github/workflows/react.yml

@@ -31,15 +31,15 @@ jobs:
           workspace_path: packages/sdk/react
 
       # Contract Tests
-      - name: Install contract test dependencies
+      - name: Install and build contract test dependencies
         env:
           YARN_ENABLE_IMMUTABLE_INSTALLS: 'false'
         run: |
-          yarn workspaces foreach -pR --topological-dev --from 'browser-contract-test-adapter' install
-          yarn workspaces foreach -pR --topological-dev --from "@launchdarkly/react-sdk-contract-tests" install
-          yarn workspaces foreach -pR --topological-dev --from 'browser-contract-test-adapter' run build
-          yarn workspaces foreach -pR --topological-dev --from "@launchdarkly/react-sdk-contract-tests" run build
-          yarn workspace @launchdarkly/react-sdk-contract-tests install-playwright-browsers
+          yarn workspaces foreach -pR --topological-dev --from '@launchdarkly/react-sdk-contract-tests' install
+          yarn workspaces foreach -pR --topological-dev --from '@launchdarkly/react-sdk-contract-tests' run build
+
+      - name: Install Playwright browsers
+        run: yarn workspace @launchdarkly/react-sdk-contract-tests install-playwright-browsers
       - name: Run test adapter
         run: |
           yarn workspace @launchdarkly/react-sdk-contract-tests run start:adapter > /tmp/adapter.log 2>&1 &

package.json

@@ -24,7 +24,6 @@
     "packages/sdk/react/examples/server-only",
     "packages/sdk/react-native",
     "packages/sdk/react-native/example",
-    "packages/sdk/react-native/contract-tests/adapter",
     "packages/sdk/react-native/contract-tests/entity",
     "packages/sdk/vercel",
     "packages/sdk/svelte",
@@ -41,7 +40,6 @@
     "packages/tooling/jest/example/react-native-example",
     "packages/sdk/browser",
     "packages/sdk/browser/contract-tests/entity",
-    "packages/sdk/browser/contract-tests/adapter",
     "packages/sdk/server-ai",
     "packages/sdk/server-ai/examples/bedrock",
     "packages/sdk/server-ai/examples/chat-judge",

packages/sdk/browser/contract-tests/README.md

@@ -6,7 +6,7 @@ This directory contains the contract test implementation for the LaunchDarkly Br
 
 The browser contract tests consist of three components:
 
-1. **Adapter** (`adapter/`): A Node.js server that:
+1. **Adapter**: The `npx sdk-testharness-server adapter` CLI from `@launchdarkly/js-contract-test-utils`. The adapter:
    - Exposes a REST API on port 8000 for the test harness
    - Runs a WebSocket server on port 8001 for browser communication
    - Translates REST commands to WebSocket messages