fix: replace orchestrator-develop branch references with main

The orchestrator-develop branch no longer exists. Update all fallback
clone commands and test fixtures to use main instead.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

.github/workflows/build-tests-mac.yml

@@ -12,7 +12,6 @@ jobs:
   buildForAllPlatformsMacOS:
     name: ${{ matrix.targetPlatform }} on ${{ matrix.unityVersion }}
     runs-on: macos-latest
-    continue-on-error: true
     strategy:
       fail-fast: false
       matrix:

.github/workflows/release-cli.yml

@@ -0,0 +1,170 @@
+name: Release CLI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Release tag to build (e.g., v2.0.0). Uses latest release if empty.'
+        required: false
+        type: string
+      publish-npm:
+        description: 'Publish to npm'
+        required: false
+        default: false
+        type: boolean
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.release.tag_name || inputs.tag || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build-binaries:
+    name: Build ${{ matrix.target }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - target: linux-x64
+            os: ubuntu-latest
+            pkg-target: node20-linux-x64
+            binary-name: game-ci-linux-x64
+          - target: linux-arm64
+            os: ubuntu-latest
+            pkg-target: node20-linux-arm64
+            binary-name: game-ci-linux-arm64
+          - target: macos-x64
+            os: macos-latest
+            pkg-target: node20-macos-x64
+            binary-name: game-ci-macos-x64
+          - target: macos-arm64
+            os: macos-latest
+            pkg-target: node20-macos-arm64
+            binary-name: game-ci-macos-arm64
+          - target: windows-x64
+            os: windows-latest
+            pkg-target: node20-win-x64
+            binary-name: game-ci-windows-x64.exe
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.release.tag_name || inputs.tag || github.ref }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Build TypeScript
+        run: yarn build
+
+      - name: Verify CLI before packaging
+        run: node lib/cli.js version
+
+      - name: Build standalone binary
+        run: npx pkg lib/cli.js --target ${{ matrix.pkg-target }} --output ${{ matrix.binary-name }} --compress GZip
+
+      - name: Verify standalone binary (non-cross-compiled)
+        if: |
+          (matrix.target == 'linux-x64' && runner.os == 'Linux') ||
+          (matrix.target == 'macos-arm64' && runner.os == 'macOS' && runner.arch == 'ARM64') ||
+          (matrix.target == 'macos-x64' && runner.os == 'macOS' && runner.arch == 'X64') ||
+          (matrix.target == 'windows-x64' && runner.os == 'Windows')
+        run: ./${{ matrix.binary-name }} version
+        shell: bash
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: binary-${{ matrix.target }}
+          path: ${{ matrix.binary-name }}
+          retention-days: 5
+
+  create-checksums-and-upload:
+    name: Checksums and release upload
+    needs: build-binaries
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: binaries
+          pattern: binary-*
+          merge-multiple: true
+
+      - name: List binaries
+        run: ls -la binaries/
+
+      - name: Generate SHA256 checksums
+        run: |
+          cd binaries
+          sha256sum game-ci-* > checksums.txt
+          echo "=== checksums.txt ==="
+          cat checksums.txt
+
+      - name: Determine release tag
+        id: tag
+        run: |
+          if [ "${{ github.event_name }}" = "release" ]; then
+            echo "tag=${{ github.event.release.tag_name }}" >> "$GITHUB_OUTPUT"
+          elif [ -n "${{ inputs.tag }}" ]; then
+            echo "tag=${{ inputs.tag }}" >> "$GITHUB_OUTPUT"
+          else
+            echo "No release tag available. Skipping upload."
+            echo "tag=" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Upload binaries to release
+        if: steps.tag.outputs.tag != ''
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          cd binaries
+          for f in game-ci-* checksums.txt; do
+            echo "Uploading $f..."
+            gh release upload "${{ steps.tag.outputs.tag }}" "$f" \
+              --repo "${{ github.repository }}" \
+              --clobber
+          done
+
+  publish-npm:
+    name: Publish to npm
+    needs: build-binaries
+    runs-on: ubuntu-latest
+    if: >-
+      (github.event_name == 'release') || (github.event_name == 'workflow_dispatch' && inputs.publish-npm)
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.release.tag_name || inputs.tag || github.ref }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Build
+        run: yarn build
+
+      - name: Run tests
+        run: yarn test
+
+      - name: Verify CLI
+        run: |
+          node lib/cli.js version
+          node lib/cli.js --help
+
+      - name: Publish to npm
+        run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

action.yml

@@ -182,8 +182,8 @@ inputs:
     required: false
     default: ''
     description:
-      '[Orchestrator] Run a custom job instead of the standard build automation for orchestrator (in yaml format with
-      the keys image, secrets (name, value object array), command line string)'
+      '[Orchestrator] Run a custom job instead of the standard build automation for orchestrator (in yaml format with the
+      keys image, secrets (name, value object array), command line string)'
   awsStackName:
     default: 'game-ci'
     required: false
@@ -279,23 +279,6 @@ inputs:
     description:
       '[Orchestrator] Specifies the repo for the unity builder. Useful if you forked the repo for testing, features, or
       fixes.'
-  testSuitePath:
-    description: 'Path to YAML test suite definition file'
-    required: false
-  testSuiteEvent:
-    description: 'CI event name for suite selection (pr, push, release)'
-    required: false
-  testTaxonomyPath:
-    description: 'Path to custom taxonomy definition YAML'
-    required: false
-  testResultFormat:
-    description: 'Test result output format: junit, json, or both'
-    required: false
-    default: 'junit'
-  testResultPath:
-    description: 'Directory for structured test result output'
-    required: false
-    default: './test-results'
 
 outputs:
   volume:

install.ps1

@@ -0,0 +1,122 @@
+# game-ci CLI installer for Windows
+# Usage: irm https://raw.githubusercontent.com/game-ci/unity-builder/main/install.ps1 | iex
+#
+# Environment variables:
+#   GAME_CI_VERSION   - Install a specific version (e.g., v2.0.0). Defaults to latest.
+#   GAME_CI_INSTALL   - Installation directory. Defaults to $HOME\.game-ci\bin.
+
+$ErrorActionPreference = 'Stop'
+
+$Repo = "game-ci/unity-builder"
+$InstallDir = if ($env:GAME_CI_INSTALL) { $env:GAME_CI_INSTALL } else { Join-Path $env:USERPROFILE ".game-ci\bin" }
+$AssetName = "game-ci-windows-x64.exe"
+$BinaryName = "game-ci.exe"
+
+function Write-Info($Message) {
+    Write-Host "info: " -ForegroundColor Green -NoNewline
+    Write-Host $Message
+}
+
+function Write-Warn($Message) {
+    Write-Host "warn: " -ForegroundColor Yellow -NoNewline
+    Write-Host $Message
+}
+
+# Determine version
+if ($env:GAME_CI_VERSION) {
+    $Version = $env:GAME_CI_VERSION
+    Write-Info "Using specified version: $Version"
+} else {
+    Write-Info "Fetching latest release..."
+    try {
+        $Release = Invoke-RestMethod "https://api.github.com/repos/$Repo/releases/latest"
+        $Version = $Release.tag_name
+    } catch {
+        Write-Host "error: Could not determine latest version. Check https://github.com/$Repo/releases" -ForegroundColor Red
+        exit 1
+    }
+}
+
+$DownloadUrl = "https://github.com/$Repo/releases/download/$Version/$AssetName"
+$ChecksumUrl = "https://github.com/$Repo/releases/download/$Version/checksums.txt"
+$BinaryPath = Join-Path $InstallDir $BinaryName
+
+Write-Host ""
+Write-Info "Installing game-ci $Version (windows-x64)"
+Write-Info "  from: $DownloadUrl"
+Write-Info "  to:   $BinaryPath"
+Write-Host ""
+
+# Create install directory
+if (-not (Test-Path $InstallDir)) {
+    New-Item -ItemType Directory -Force -Path $InstallDir | Out-Null
+}
+
+# Download binary
+try {
+    Invoke-WebRequest -Uri $DownloadUrl -OutFile $BinaryPath -UseBasicParsing
+} catch {
+    if ($_.Exception.Response.StatusCode -eq 404) {
+        Write-Host "error: Release asset not found: $AssetName ($Version)" -ForegroundColor Red
+        Write-Host "       Check available assets at https://github.com/$Repo/releases/tag/$Version" -ForegroundColor Red
+    } else {
+        Write-Host "error: Download failed: $_" -ForegroundColor Red
+    }
+    exit 1
+}
+
+# Verify checksum
+try {
+    $Checksums = Invoke-WebRequest -Uri $ChecksumUrl -UseBasicParsing | Select-Object -ExpandProperty Content
+    $ExpectedLine = $Checksums -split "`n" | Where-Object { $_ -match $AssetName } | Select-Object -First 1
+    if ($ExpectedLine) {
+        $ExpectedHash = ($ExpectedLine -split '\s+')[0]
+        $ActualHash = (Get-FileHash -Path $BinaryPath -Algorithm SHA256).Hash.ToLower()
+        if ($ExpectedHash -eq $ActualHash) {
+            Write-Info "Checksum verified (SHA256)"
+        } else {
+            Write-Host "error: Checksum verification failed!" -ForegroundColor Red
+            Write-Host "  Expected: $ExpectedHash" -ForegroundColor Red
+            Write-Host "  Got:      $ActualHash" -ForegroundColor Red
+            Remove-Item $BinaryPath -Force
+            exit 1
+        }
+    }
+} catch {
+    # Checksums not available for this release; continue without verification
+}
+
+# Verify the binary works
+try {
+    $VersionOutput = & $BinaryPath version 2>&1
+    Write-Info "Verified: $($VersionOutput | Select-Object -First 1)"
+} catch {
+    Write-Warn "Binary downloaded but could not verify. It may still work."
+}
+
+Write-Host ""
+Write-Host "game-ci installed successfully!" -ForegroundColor Green -BackgroundColor Black
+Write-Host ""
+
+# Check PATH and offer to add
+$UserPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
+if ($UserPath -notlike "*$InstallDir*") {
+    Write-Warn "game-ci is not in your PATH."
+    Write-Host ""
+    Write-Host "To add it permanently, run:" -ForegroundColor Yellow
+    Write-Host ""
+    Write-Host "  [Environment]::SetEnvironmentVariable('PATH', ""$InstallDir;"" + [Environment]::GetEnvironmentVariable('PATH', 'User'), 'User')"
+    Write-Host ""
+    Write-Info "Then restart your terminal."
+
+    # Offer to add automatically
+    Write-Host ""
+    $AddToPath = Read-Host "Add to PATH now? (Y/n)"
+    if ($AddToPath -ne 'n' -and $AddToPath -ne 'N') {
+        [Environment]::SetEnvironmentVariable('PATH', "$InstallDir;$UserPath", 'User')
+        $env:PATH = "$InstallDir;$env:PATH"
+        Write-Info "Added to PATH. You can now run: game-ci --help"
+    }
+} else {
+    Write-Info "game-ci is already in your PATH. Run: game-ci --help"
+}

install.sh

@@ -0,0 +1,196 @@
+#!/bin/sh
+# game-ci CLI installer
+# Usage: curl -fsSL https://raw.githubusercontent.com/game-ci/unity-builder/main/install.sh | sh
+#
+# Environment variables:
+#   GAME_CI_VERSION   - Install a specific version (e.g., v2.0.0). Defaults to latest.
+#   GAME_CI_INSTALL   - Installation directory. Defaults to ~/.game-ci/bin.
+
+set -e
+
+REPO="game-ci/unity-builder"
+INSTALL_DIR="${GAME_CI_INSTALL:-$HOME/.game-ci/bin}"
+BINARY_NAME="game-ci"
+
+# Colors (disabled if not a terminal)
+if [ -t 1 ]; then
+  BOLD='\033[1m'
+  GREEN='\033[0;32m'
+  YELLOW='\033[0;33m'
+  RED='\033[0;31m'
+  RESET='\033[0m'
+else
+  BOLD=''
+  GREEN=''
+  YELLOW=''
+  RED=''
+  RESET=''
+fi
+
+info() {
+  printf "${GREEN}info${RESET}: %s\n" "$1"
+}
+
+warn() {
+  printf "${YELLOW}warn${RESET}: %s\n" "$1"
+}
+
+error() {
+  printf "${RED}error${RESET}: %s\n" "$1" >&2
+  exit 1
+}
+
+# Detect OS and architecture
+detect_platform() {
+  OS="$(uname -s)"
+  ARCH="$(uname -m)"
+
+  case "$OS" in
+    Linux*)  PLATFORM="linux" ;;
+    Darwin*) PLATFORM="macos" ;;
+    MINGW*|MSYS*|CYGWIN*)
+      PLATFORM="windows"
+      warn "For Windows, consider using install.ps1 instead:"
+      warn "  irm https://raw.githubusercontent.com/game-ci/unity-builder/main/install.ps1 | iex"
+      ;;
+    *) error "Unsupported operating system: $OS" ;;
+  esac
+
+  case "$ARCH" in
+    x86_64|amd64)  ARCH="x64" ;;
+    aarch64|arm64) ARCH="arm64" ;;
+    *) error "Unsupported architecture: $ARCH" ;;
+  esac
+
+  ASSET_NAME="game-ci-${PLATFORM}-${ARCH}"
+  if [ "$PLATFORM" = "windows" ]; then
+    ASSET_NAME="${ASSET_NAME}.exe"
+    BINARY_NAME="game-ci.exe"
+  fi
+}
+
+# Get latest release tag from GitHub API
+get_latest_version() {
+  if [ -n "$GAME_CI_VERSION" ]; then
+    VERSION="$GAME_CI_VERSION"
+    info "Using specified version: $VERSION"
+    return
+  fi
+
+  info "Fetching latest release..."
+
+  if command -v curl > /dev/null 2>&1; then
+    VERSION=$(curl -fsSL "https://api.github.com/repos/${REPO}/releases/latest" | grep '"tag_name"' | sed -E 's/.*"([^"]+)".*/\1/')
+  elif command -v wget > /dev/null 2>&1; then
+    VERSION=$(wget -qO- "https://api.github.com/repos/${REPO}/releases/latest" | grep '"tag_name"' | sed -E 's/.*"([^"]+)".*/\1/')
+  else
+    error "Neither curl nor wget found. Please install one of them."
+  fi
+
+  if [ -z "$VERSION" ]; then
+    error "Could not determine latest version. Check https://github.com/${REPO}/releases"
+  fi
+}
+
+# Download and install the binary
+install() {
+  DOWNLOAD_URL="https://github.com/${REPO}/releases/download/${VERSION}/${ASSET_NAME}"
+
+  printf "\n"
+  info "Installing game-ci ${VERSION} (${PLATFORM}-${ARCH})"
+  info "  from: ${DOWNLOAD_URL}"
+  info "  to:   ${INSTALL_DIR}/${BINARY_NAME}"
+  printf "\n"
+
+  mkdir -p "$INSTALL_DIR"
+
+  # Download with progress
+  if command -v curl > /dev/null 2>&1; then
+    HTTP_CODE=$(curl -fSL "$DOWNLOAD_URL" -o "${INSTALL_DIR}/${BINARY_NAME}" -w "%{http_code}" 2>/dev/null) || true
+    if [ "$HTTP_CODE" = "404" ]; then
+      error "Release asset not found: ${ASSET_NAME} (${VERSION}). Check available assets at https://github.com/${REPO}/releases/tag/${VERSION}"
+    elif [ ! -f "${INSTALL_DIR}/${BINARY_NAME}" ]; then
+      error "Download failed. URL: ${DOWNLOAD_URL}"
+    fi
+  elif command -v wget > /dev/null 2>&1; then
+    wget -q "$DOWNLOAD_URL" -O "${INSTALL_DIR}/${BINARY_NAME}" || error "Download failed. URL: ${DOWNLOAD_URL}"
+  fi
+
+  chmod +x "${INSTALL_DIR}/${BINARY_NAME}"
+
+  # Verify the binary works
+  if "${INSTALL_DIR}/${BINARY_NAME}" version > /dev/null 2>&1; then
+    INSTALLED_VERSION=$("${INSTALL_DIR}/${BINARY_NAME}" version 2>&1 | head -1)
+    info "Verified: ${INSTALLED_VERSION}"
+  else
+    warn "Binary downloaded but could not verify. It may still work."
+  fi
+
+  printf "\n"
+  printf "${BOLD}game-ci installed successfully!${RESET}\n"
+  printf "\n"
+
+  # Check if install dir is in PATH
+  case ":$PATH:" in
+    *":${INSTALL_DIR}:"*)
+      info "game-ci is already in your PATH. Run: game-ci --help"
+      ;;
+    *)
+      SHELL_NAME=$(basename "$SHELL" 2>/dev/null || echo "sh")
+      case "$SHELL_NAME" in
+        zsh)  PROFILE="~/.zshrc" ;;
+        bash) PROFILE="~/.bashrc" ;;
+        fish) PROFILE="~/.config/fish/config.fish" ;;
+        *)    PROFILE="~/.profile" ;;
+      esac
+
+      printf "${YELLOW}Add game-ci to your PATH by adding this to ${PROFILE}:${RESET}\n"
+      printf "\n"
+      if [ "$SHELL_NAME" = "fish" ]; then
+        printf "  set -gx PATH \"%s\" \$PATH\n" "$INSTALL_DIR"
+      else
+        printf "  export PATH=\"%s:\$PATH\"\n" "$INSTALL_DIR"
+      fi
+      printf "\n"
+      info "Then restart your shell or run: source ${PROFILE}"
+      ;;
+  esac
+}
+
+# Verify checksum if checksums.txt is available
+verify_checksum() {
+  if ! command -v sha256sum > /dev/null 2>&1; then
+    return 0
+  fi
+
+  CHECKSUM_URL="https://github.com/${REPO}/releases/download/${VERSION}/checksums.txt"
+
+  CHECKSUMS=""
+  if command -v curl > /dev/null 2>&1; then
+    CHECKSUMS=$(curl -fsSL "$CHECKSUM_URL" 2>/dev/null) || return 0
+  elif command -v wget > /dev/null 2>&1; then
+    CHECKSUMS=$(wget -qO- "$CHECKSUM_URL" 2>/dev/null) || return 0
+  fi
+
+  if [ -z "$CHECKSUMS" ]; then
+    return 0
+  fi
+
+  EXPECTED=$(echo "$CHECKSUMS" | grep "$ASSET_NAME" | awk '{print $1}')
+  if [ -z "$EXPECTED" ]; then
+    return 0
+  fi
+
+  ACTUAL=$(sha256sum "${INSTALL_DIR}/${BINARY_NAME}" | awk '{print $1}')
+  if [ "$EXPECTED" != "$ACTUAL" ]; then
+    error "Checksum verification failed!\n  Expected: ${EXPECTED}\n  Got:      ${ACTUAL}"
+  fi
+
+  info "Checksum verified (SHA256)"
+}
+
+# Main
+detect_platform
+get_latest_version
+install
+verify_checksum

package.json

@@ -3,6 +3,24 @@
   "version": "3.0.0",
   "description": "Build Unity projects for different platforms.",
   "main": "dist/index.js",
+  "bin": {
+    "game-ci": "./lib/cli.js"
+  },
+  "pkg": {
+    "scripts": "lib/**/*.js",
+    "assets": [
+      "lib/**/*.json",
+      "package.json"
+    ],
+    "targets": [
+      "node20-linux-x64",
+      "node20-linux-arm64",
+      "node20-macos-x64",
+      "node20-macos-arm64",
+      "node20-win-x64"
+    ],
+    "outputPath": "dist-binaries"
+  },
   "repository": "git@github.com:game-ci/unity-builder.git",
   "author": "Webber <webber@takken.io>",
   "license": "MIT",
@@ -12,6 +30,7 @@
     "lint": "prettier --check \"src/**/*.{js,ts}\" && eslint src/**/*.ts",
     "format": "prettier --write \"src/**/*.{js,ts}\"",
     "cli": "yarn ts-node src/index.ts -m cli",
+    "game-ci": "ts-node src/cli.ts",
     "gcp-secrets-tests": "cross-env providerStrategy=aws orchestratorTests=true inputPullCommand=\"gcp-secret-manager\" populateOverride=true pullInputList=UNITY_EMAIL,UNITY_SERIAL,UNITY_PASSWORD yarn test -i -t \"orchestrator\"",
     "gcp-secrets-cli": "cross-env orchestratorTests=true USE_IL2CPP=false inputPullCommand=\"gcp-secret-manager\" yarn ts-node src/index.ts -m cli --populateOverride true --pullInputList UNITY_EMAIL,UNITY_SERIAL,UNITY_PASSWORD",
     "aws-secrets-cli": "cross-env orchestratorTests=true inputPullCommand=\"aws-secret-manager\" yarn ts-node src/index.ts -m cli --populateOverride true --pullInputList UNITY_EMAIL,UNITY_SERIAL,UNITY_PASSWORD",
@@ -54,7 +73,8 @@
     "ts-md5": "^1.3.1",
     "unity-changeset": "^3.1.0",
     "uuid": "^9.0.0",
-    "yaml": "^2.2.2"
+    "yaml": "^2.2.2",
+    "yargs": "^17.7.2"
   },
   "devDependencies": {
     "@types/base-64": "^1.0.0",
@@ -62,6 +82,7 @@
     "@types/node": "^17.0.23",
     "@types/semver": "^7.3.9",
     "@types/uuid": "^9.0.0",
+    "@types/yargs": "^17.0.35",
     "@typescript-eslint/parser": "4.8.1",
     "@vercel/ncc": "^0.36.1",
     "cross-env": "^7.0.3",
@@ -77,6 +98,7 @@
     "js-yaml": "^4.1.0",
     "lefthook": "^1.6.1",
     "node-fetch": "2",
+    "pkg": "^5.8.1",
     "prettier": "^2.5.1",
     "ts-jest": "^27.1.3",
     "ts-node": "10.8.1",

src/cli.ts

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+
+import yargs from 'yargs';
+// eslint-disable-next-line import/no-unresolved
+import { hideBin } from 'yargs/helpers';
+import buildCommand from './cli/commands/build';
+import testCommand from './cli/commands/test';
+import orchestrateCommand from './cli/commands/orchestrate';
+import activateCommand from './cli/commands/activate';
+import statusCommand from './cli/commands/status';
+import versionCommand from './cli/commands/version';
+import updateCommand from './cli/commands/update';
+import * as core from '@actions/core';
+
+const cli = yargs(hideBin(process.argv))
+  .scriptName('game-ci')
+  .usage('$0 <command> [options]')
+  .command(buildCommand)
+  .command(testCommand)
+  .command(orchestrateCommand)
+  .command(activateCommand)
+  .command(statusCommand)
+  .command(versionCommand)
+  .command(updateCommand)
+  .demandCommand(1, 'You must specify a command. Run game-ci --help for available commands.')
+  .strict()
+  .alias('h', 'help')
+  .epilogue('For more information, visit https://game.ci')
+  .wrap(Math.min(120, process.stdout.columns || 80));
+
+async function main() {
+  try {
+    await cli.parse();
+  } catch (error: any) {
+    if (error.name !== 'YError') {
+      core.error(`Error: ${error.message}`);
+      process.exit(1);
+    }
+  }
+}
+
+main();

src/cli/__tests__/cli-integration.test.ts

@@ -0,0 +1,135 @@
+import { execFile } from 'node:child_process';
+import path from 'node:path';
+
+/**
+ * Integration tests that spawn the CLI as a child process and verify
+ * exit codes and output. Uses node with --require ts-node/register to
+ * run the TypeScript entry point directly so no build step is required.
+ */
+
+const CLI_ENTRY = path.resolve(__dirname, '..', '..', 'cli.ts');
+
+function runCli(cliArguments: string[]): Promise<{ code: number | null; stdout: string; stderr: string }> {
+  return new Promise((resolve) => {
+    execFile(
+      process.execPath,
+      ['--require', 'ts-node/register/transpile-only', CLI_ENTRY, ...cliArguments],
+      { timeout: 30_000, cwd: path.resolve(__dirname, '..', '..', '..') },
+      (error, stdout, stderr) => {
+        resolve({
+          code: error ? error.code ?? 1 : 0,
+          stdout: stdout.toString(),
+          stderr: stderr.toString(),
+        });
+      },
+    );
+  });
+}
+
+// Integration tests spawn child processes which need more time than the default 5s
+jest.setTimeout(30_000);
+
+describe('CLI integration', () => {
+  it('exits 0 and shows all commands for --help', async () => {
+    const result = await runCli(['--help']);
+
+    expect(result.code).toStrictEqual(0);
+    expect(result.stdout).toContain('game-ci');
+    expect(result.stdout).toContain('build');
+    expect(result.stdout).toContain('test');
+    expect(result.stdout).toContain('orchestrate');
+    expect(result.stdout).toContain('activate');
+    expect(result.stdout).toContain('status');
+    expect(result.stdout).toContain('version');
+    expect(result.stdout).toContain('update');
+  });
+
+  it('exits 0 and shows version info for version command', async () => {
+    const result = await runCli(['version']);
+
+    expect(result.code).toStrictEqual(0);
+    expect(result.stdout).toContain('unity-builder');
+  });
+
+  it('exits 0 and shows build flags for build --help', async () => {
+    const result = await runCli(['build', '--help']);
+
+    expect(result.code).toStrictEqual(0);
+    expect(result.stdout).toContain('--target-platform');
+    expect(result.stdout).toContain('--unity-version');
+    expect(result.stdout).toContain('--project-path');
+    expect(result.stdout).toContain('--build-name');
+    expect(result.stdout).toContain('--builds-path');
+    expect(result.stdout).toContain('--build-method');
+    expect(result.stdout).toContain('--custom-parameters');
+    expect(result.stdout).toContain('--versioning');
+  });
+
+  it('exits 0 and shows test flags for test --help', async () => {
+    const result = await runCli(['test', '--help']);
+
+    expect(result.code).toStrictEqual(0);
+    expect(result.stdout).toContain('--target-platform');
+    expect(result.stdout).toContain('--test-mode');
+    expect(result.stdout).toContain('--test-results-path');
+    expect(result.stdout).toContain('--enable-code-coverage');
+  });
+
+  it('exits 0 for test alias t --help', async () => {
+    const result = await runCli(['t', '--help']);
+
+    expect(result.code).toStrictEqual(0);
+    expect(result.stdout).toContain('--test-mode');
+  });
+
+  it('exits non-zero for an unknown command', async () => {
+    const result = await runCli(['nonexistent']);
+
+    expect(result.code).not.toStrictEqual(0);
+  });
+
+  it('exits non-zero when no command is provided', async () => {
+    const result = await runCli([]);
+
+    expect(result.code).not.toStrictEqual(0);
+  });
+
+  it('exits 0 for orchestrate --help', async () => {
+    const result = await runCli(['orchestrate', '--help']);
+
+    expect(result.code).toStrictEqual(0);
+    expect(result.stdout).toContain('--target-platform');
+    expect(result.stdout).toContain('--provider-strategy');
+  });
+
+  it('exits 0 for orchestrate alias o --help', async () => {
+    const result = await runCli(['o', '--help']);
+
+    expect(result.code).toStrictEqual(0);
+    expect(result.stdout).toContain('--provider-strategy');
+  });
+
+  it('exits 0 for activate --help', async () => {
+    const result = await runCli(['activate', '--help']);
+
+    expect(result.code).toStrictEqual(0);
+    expect(result.stdout).toContain('activate');
+  });
+
+  it('exits 0 for status --help', async () => {
+    const result = await runCli(['status', '--help']);
+
+    expect(result.code).toStrictEqual(0);
+    expect(result.stdout).toContain('status');
+    expect(result.stdout).toContain('--cache-dir');
+  });
+
+  it('exits 0 for update --help', async () => {
+    const result = await runCli(['update', '--help']);
+
+    expect(result.code).toStrictEqual(0);
+    expect(result.stdout).toContain('update');
+    expect(result.stdout).toContain('--force');
+    expect(result.stdout).toContain('--version');
+  });
+});

src/cli/__tests__/commands.test.ts

@@ -0,0 +1,312 @@
+import buildCommand from '../commands/build';
+import testCommand from '../commands/test';
+import activateCommand from '../commands/activate';
+import orchestrateCommand from '../commands/orchestrate';
+import statusCommand from '../commands/status';
+import versionCommand from '../commands/version';
+import updateCommand from '../commands/update';
+
+function createFakeYargs(): { yargs: any; options: Record<string, any> } {
+  const options: Record<string, any> = {};
+  const yargs: any = {
+    option: jest.fn(),
+    positional: jest.fn(),
+    example: jest.fn(),
+    env: jest.fn(),
+  };
+
+  yargs.option.mockImplementation((name: string, config: any) => {
+    options[name] = config;
+
+    return yargs;
+  });
+  yargs.positional.mockImplementation((name: string, config: any) => {
+    options[name] = config;
+
+    return yargs;
+  });
+  yargs.example.mockReturnValue(yargs);
+  yargs.env.mockReturnValue(yargs);
+
+  return { yargs, options };
+}
+
+describe('CLI commands', () => {
+  describe('build command', () => {
+    it('exports the correct command name', () => {
+      expect(buildCommand.command).toStrictEqual('build');
+    });
+
+    it('has a description', () => {
+      expect(buildCommand.describe).toBeTruthy();
+    });
+
+    it('has a builder function', () => {
+      expect(typeof buildCommand.builder).toStrictEqual('function');
+    });
+
+    it('has a handler function', () => {
+      expect(typeof buildCommand.handler).toStrictEqual('function');
+    });
+
+    it('defines all expected build flags via builder', () => {
+      const { yargs, options } = createFakeYargs();
+
+      (buildCommand.builder as Function)(yargs);
+
+      // Core build flags (from shared + build-specific)
+      expect(options['target-platform']).toBeDefined();
+      expect(options['target-platform'].demandOption).toStrictEqual(true);
+      expect(options['unity-version']).toBeDefined();
+      expect(options['project-path']).toBeDefined();
+      expect(options['build-profile']).toBeDefined();
+      expect(options['build-name']).toBeDefined();
+      expect(options['builds-path']).toBeDefined();
+      expect(options['build-method']).toBeDefined();
+      expect(options['custom-parameters']).toBeDefined();
+      expect(options['versioning']).toBeDefined();
+      expect(options['version']).toBeDefined();
+      expect(options['custom-image']).toBeDefined();
+      expect(options['manual-exit']).toBeDefined();
+      expect(options['enable-gpu']).toBeDefined();
+
+      // Android flags
+      expect(options['android-version-code']).toBeDefined();
+      expect(options['android-export-type']).toBeDefined();
+      expect(options['android-keystore-name']).toBeDefined();
+      expect(options['android-keystore-base64']).toBeDefined();
+      expect(options['android-keystore-pass']).toBeDefined();
+      expect(options['android-keyalias-name']).toBeDefined();
+      expect(options['android-keyalias-pass']).toBeDefined();
+      expect(options['android-target-sdk-version']).toBeDefined();
+      expect(options['android-symbol-type']).toBeDefined();
+
+      // Docker flags
+      expect(options['docker-cpu-limit']).toBeDefined();
+      expect(options['docker-memory-limit']).toBeDefined();
+      expect(options['docker-workspace-path']).toBeDefined();
+      expect(options['run-as-host-user']).toBeDefined();
+      expect(options['chown-files-to']).toBeDefined();
+
+      // Build should NOT have orchestrator-specific flags
+      expect(options['provider-strategy']).toBeUndefined();
+      expect(options['aws-stack-name']).toBeUndefined();
+      expect(options['kube-config']).toBeUndefined();
+    });
+
+    it('sets correct default values', () => {
+      const { yargs, options } = createFakeYargs();
+
+      (buildCommand.builder as Function)(yargs);
+
+      expect(options['unity-version'].default).toStrictEqual('auto');
+      expect(options['project-path'].default).toStrictEqual('.');
+      expect(options['builds-path'].default).toStrictEqual('build');
+      expect(options['versioning'].default).toStrictEqual('Semantic');
+      expect(options['manual-exit'].default).toStrictEqual(false);
+      expect(options['enable-gpu'].default).toStrictEqual(false);
+      expect(options['android-export-type'].default).toStrictEqual('androidPackage');
+      expect(options['android-symbol-type'].default).toStrictEqual('none');
+    });
+
+    it('provides camelCase aliases for kebab-case options', () => {
+      const { yargs, options } = createFakeYargs();
+
+      (buildCommand.builder as Function)(yargs);
+
+      expect(options['target-platform'].alias).toStrictEqual('targetPlatform');
+      expect(options['unity-version'].alias).toStrictEqual('unityVersion');
+      expect(options['project-path'].alias).toStrictEqual('projectPath');
+      expect(options['build-name'].alias).toStrictEqual('buildName');
+      expect(options['builds-path'].alias).toStrictEqual('buildsPath');
+      expect(options['build-method'].alias).toStrictEqual('buildMethod');
+    });
+  });
+
+  describe('test command', () => {
+    it('exports command with alias', () => {
+      expect(testCommand.command).toStrictEqual(['test', 't']);
+    });
+
+    it('has a description', () => {
+      expect(testCommand.describe).toBeTruthy();
+    });
+
+    it('has a builder function', () => {
+      expect(typeof testCommand.builder).toStrictEqual('function');
+    });
+
+    it('has a handler function', () => {
+      expect(typeof testCommand.handler).toStrictEqual('function');
+    });
+
+    it('defines test-specific flags', () => {
+      const { yargs, options } = createFakeYargs();
+
+      (testCommand.builder as Function)(yargs);
+
+      expect(options['test-mode']).toBeDefined();
+      expect(options['test-mode'].default).toStrictEqual('All');
+      expect(options['test-mode'].choices).toStrictEqual(['EditMode', 'PlayMode', 'All']);
+      expect(options['test-results-path']).toBeDefined();
+      expect(options['test-category']).toBeDefined();
+      expect(options['test-filter']).toBeDefined();
+      expect(options['enable-code-coverage']).toBeDefined();
+      expect(options['coverage-options']).toBeDefined();
+    });
+
+    it('includes shared project options', () => {
+      const { yargs, options } = createFakeYargs();
+
+      (testCommand.builder as Function)(yargs);
+
+      expect(options['target-platform']).toBeDefined();
+      expect(options['target-platform'].demandOption).toStrictEqual(true);
+      expect(options['unity-version']).toBeDefined();
+      expect(options['project-path']).toBeDefined();
+      expect(options['custom-image']).toBeDefined();
+    });
+
+    it('includes docker options but not orchestrator options', () => {
+      const { yargs, options } = createFakeYargs();
+
+      (testCommand.builder as Function)(yargs);
+
+      expect(options['docker-cpu-limit']).toBeDefined();
+      expect(options['docker-memory-limit']).toBeDefined();
+      expect(options['provider-strategy']).toBeUndefined();
+      expect(options['aws-stack-name']).toBeUndefined();
+    });
+  });
+
+  describe('activate command', () => {
+    it('exports the correct command name', () => {
+      expect(activateCommand.command).toStrictEqual('activate');
+    });
+
+    it('has a description', () => {
+      expect(activateCommand.describe).toBeTruthy();
+    });
+
+    it('has a builder function', () => {
+      expect(typeof activateCommand.builder).toStrictEqual('function');
+    });
+
+    it('has a handler function', () => {
+      expect(typeof activateCommand.handler).toStrictEqual('function');
+    });
+  });
+
+  describe('orchestrate command', () => {
+    it('exports command with alias', () => {
+      expect(orchestrateCommand.command).toStrictEqual(['orchestrate', 'o']);
+    });
+
+    it('has a description', () => {
+      expect(orchestrateCommand.describe).toBeTruthy();
+    });
+
+    it('has a builder function', () => {
+      expect(typeof orchestrateCommand.builder).toStrictEqual('function');
+    });
+
+    it('has a handler function', () => {
+      expect(typeof orchestrateCommand.handler).toStrictEqual('function');
+    });
+
+    it('defines key orchestrator flags', () => {
+      const { yargs, options } = createFakeYargs();
+
+      (orchestrateCommand.builder as Function)(yargs);
+
+      expect(options['target-platform']).toBeDefined();
+      expect(options['target-platform'].demandOption).toStrictEqual(true);
+      expect(options['provider-strategy']).toBeDefined();
+      expect(options['provider-strategy'].default).toStrictEqual('aws');
+      expect(options['aws-stack-name']).toBeDefined();
+      expect(options['kube-config']).toBeDefined();
+      expect(options['kube-volume']).toBeDefined();
+      expect(options['cache-key']).toBeDefined();
+      expect(options['watch-to-end']).toBeDefined();
+      expect(options['clone-depth']).toBeDefined();
+    });
+
+    it('does not include build-only options', () => {
+      const { yargs, options } = createFakeYargs();
+
+      (orchestrateCommand.builder as Function)(yargs);
+
+      expect(options['build-profile']).toBeUndefined();
+      expect(options['manual-exit']).toBeUndefined();
+      expect(options['enable-gpu']).toBeUndefined();
+      expect(options['android-version-code']).toBeUndefined();
+    });
+  });
+
+  describe('status command', () => {
+    it('exports the correct command name', () => {
+      expect(statusCommand.command).toStrictEqual('status');
+    });
+
+    it('has a description', () => {
+      expect(statusCommand.describe).toBeTruthy();
+    });
+
+    it('has a handler function', () => {
+      expect(typeof statusCommand.handler).toStrictEqual('function');
+    });
+
+    it('includes cache-dir option', () => {
+      const { yargs, options } = createFakeYargs();
+
+      (statusCommand.builder as Function)(yargs);
+
+      expect(options['cache-dir']).toBeDefined();
+      expect(options['project-path']).toBeDefined();
+    });
+  });
+
+  describe('version command', () => {
+    it('exports the correct command name', () => {
+      expect(versionCommand.command).toStrictEqual('version');
+    });
+
+    it('has a description', () => {
+      expect(versionCommand.describe).toBeTruthy();
+    });
+
+    it('has a handler function', () => {
+      expect(typeof versionCommand.handler).toStrictEqual('function');
+    });
+  });
+
+  describe('update command', () => {
+    it('exports the correct command name', () => {
+      expect(updateCommand.command).toStrictEqual('update');
+    });
+
+    it('has a description', () => {
+      expect(updateCommand.describe).toBeTruthy();
+    });
+
+    it('has a builder function', () => {
+      expect(typeof updateCommand.builder).toStrictEqual('function');
+    });
+
+    it('has a handler function', () => {
+      expect(typeof updateCommand.handler).toStrictEqual('function');
+    });
+
+    it('defines force and version flags', () => {
+      const { yargs, options } = createFakeYargs();
+
+      (updateCommand.builder as Function)(yargs);
+
+      expect(options['force']).toBeDefined();
+      expect(options['force'].type).toStrictEqual('boolean');
+      expect(options['force'].default).toStrictEqual(false);
+      expect(options['version']).toBeDefined();
+      expect(options['version'].type).toStrictEqual('string');
+    });
+  });
+});

src/cli/__tests__/input-mapper.test.ts

@@ -0,0 +1,221 @@
+import { mapCliArgumentsToInput, CliArguments } from '../input-mapper';
+import { Cli } from '../../model/cli/cli';
+import GitHub from '../../model/github';
+
+afterEach(() => {
+  jest.restoreAllMocks();
+  Cli.options = undefined;
+});
+
+describe('mapCliArgumentsToInput', () => {
+  describe('basic mapping', () => {
+    it('populates Cli.options from CLI arguments', () => {
+      const cliArguments: CliArguments = {
+        targetPlatform: 'StandaloneLinux64',
+        unityVersion: '2022.3.56f1',
+        projectPath: './my-project',
+      };
+
+      mapCliArgumentsToInput(cliArguments);
+
+      expect(Cli.options).toBeDefined();
+      expect(Cli.options!['targetPlatform']).toStrictEqual('StandaloneLinux64');
+      expect(Cli.options!['unityVersion']).toStrictEqual('2022.3.56f1');
+      expect(Cli.options!['projectPath']).toStrictEqual('./my-project');
+    });
+
+    it('disables GitHub Actions input reading', () => {
+      const cliArguments: CliArguments = { targetPlatform: 'WebGL' };
+
+      mapCliArgumentsToInput(cliArguments);
+
+      expect(GitHub.githubInputEnabled).toStrictEqual(false);
+    });
+
+    it('sets mode to cli by default when not provided', () => {
+      const cliArguments: CliArguments = { targetPlatform: 'Android' };
+
+      mapCliArgumentsToInput(cliArguments);
+
+      expect(Cli.options!['mode']).toStrictEqual('cli');
+    });
+
+    it('preserves an explicitly provided mode', () => {
+      const cliArguments: CliArguments = { targetPlatform: 'Android', mode: 'custom-mode' };
+
+      mapCliArgumentsToInput(cliArguments);
+
+      expect(Cli.options!['mode']).toStrictEqual('custom-mode');
+    });
+  });
+
+  describe('default values', () => {
+    it('omits undefined values from Cli.options', () => {
+      const cliArguments: CliArguments = {
+        targetPlatform: 'StandaloneLinux64',
+        unityVersion: undefined,
+        buildName: undefined,
+      };
+
+      mapCliArgumentsToInput(cliArguments);
+
+      expect(Cli.options!['targetPlatform']).toStrictEqual('StandaloneLinux64');
+      expect(Cli.options!).not.toHaveProperty('unityVersion');
+      expect(Cli.options!).not.toHaveProperty('buildName');
+    });
+  });
+
+  describe('boolean conversion', () => {
+    it('converts boolean true to string "true"', () => {
+      const cliArguments: CliArguments = { manualExit: true };
+
+      mapCliArgumentsToInput(cliArguments);
+
+      expect(Cli.options!['manualExit']).toStrictEqual('true');
+    });
+
+    it('converts boolean false to string "false"', () => {
+      const cliArguments: CliArguments = { enableGpu: false };
+
+      mapCliArgumentsToInput(cliArguments);
+
+      expect(Cli.options!['enableGpu']).toStrictEqual('false');
+    });
+
+    it('converts allowDirtyBuild boolean to string', () => {
+      const cliArguments: CliArguments = { allowDirtyBuild: true };
+
+      mapCliArgumentsToInput(cliArguments);
+
+      expect(Cli.options!['allowDirtyBuild']).toStrictEqual('true');
+    });
+  });
+
+  describe('yargs internal properties', () => {
+    it('filters out yargs _ property', () => {
+      const cliArguments: CliArguments = {
+        targetPlatform: 'iOS',
+        _: ['build'] as any,
+      };
+
+      mapCliArgumentsToInput(cliArguments);
+
+      expect(Cli.options!).not.toHaveProperty('_');
+    });
+
+    it('filters out yargs $0 property', () => {
+      const cliArguments: CliArguments = {
+        targetPlatform: 'iOS',
+        $0: 'game-ci' as any,
+      };
+
+      mapCliArgumentsToInput(cliArguments);
+
+      expect(Cli.options!).not.toHaveProperty('$0');
+    });
+  });
+
+  describe('flag name conversion', () => {
+    it('passes camelCase keys through directly', () => {
+      const cliArguments: CliArguments = {
+        androidKeystoreName: 'my.keystore',
+        androidKeystorePass: 'secret',
+        dockerCpuLimit: '4',
+        dockerMemoryLimit: '8g',
+      };
+
+      mapCliArgumentsToInput(cliArguments);
+
+      expect(Cli.options!['androidKeystoreName']).toStrictEqual('my.keystore');
+      expect(Cli.options!['androidKeystorePass']).toStrictEqual('secret');
+      expect(Cli.options!['dockerCpuLimit']).toStrictEqual('4');
+      expect(Cli.options!['dockerMemoryLimit']).toStrictEqual('8g');
+    });
+
+    it('maps all android-related arguments', () => {
+      const cliArguments: CliArguments = {
+        androidVersionCode: '42',
+        androidExportType: 'androidAppBundle',
+        androidKeystoreBase64: 'base64data',
+        androidKeyaliasName: 'myalias',
+        androidKeyaliasPass: 'aliaspass',
+        androidTargetSdkVersion: '33',
+        androidSymbolType: 'public',
+      };
+
+      mapCliArgumentsToInput(cliArguments);
+
+      expect(Cli.options!['androidVersionCode']).toStrictEqual('42');
+      expect(Cli.options!['androidExportType']).toStrictEqual('androidAppBundle');
+      expect(Cli.options!['androidKeystoreBase64']).toStrictEqual('base64data');
+      expect(Cli.options!['androidKeyaliasName']).toStrictEqual('myalias');
+      expect(Cli.options!['androidKeyaliasPass']).toStrictEqual('aliaspass');
+      expect(Cli.options!['androidTargetSdkVersion']).toStrictEqual('33');
+      expect(Cli.options!['androidSymbolType']).toStrictEqual('public');
+    });
+
+    it('maps docker and container arguments', () => {
+      const cliArguments: CliArguments = {
+        dockerIsolationMode: 'hyperv',
+        dockerWorkspacePath: '/custom/workspace',
+        containerRegistryRepository: 'custom/editor',
+        containerRegistryImageVersion: '5',
+        runAsHostUser: 'true',
+        chownFilesTo: 'root:root',
+      };
+
+      mapCliArgumentsToInput(cliArguments);
+
+      expect(Cli.options!['dockerIsolationMode']).toStrictEqual('hyperv');
+      expect(Cli.options!['dockerWorkspacePath']).toStrictEqual('/custom/workspace');
+      expect(Cli.options!['containerRegistryRepository']).toStrictEqual('custom/editor');
+      expect(Cli.options!['containerRegistryImageVersion']).toStrictEqual('5');
+      expect(Cli.options!['runAsHostUser']).toStrictEqual('true');
+      expect(Cli.options!['chownFilesTo']).toStrictEqual('root:root');
+    });
+
+    it('maps orchestrator-related arguments', () => {
+      const cliArguments: CliArguments = {
+        providerStrategy: 'k8s',
+        awsStackName: 'my-stack',
+        kubeConfig: 'base64config',
+        kubeVolume: 'my-pvc',
+        kubeVolumeSize: '10Gi',
+        kubeStorageClass: 'gp3',
+        containerCpu: '2048',
+        containerMemory: '4096',
+        cacheKey: 'my-cache',
+        watchToEnd: 'false',
+        cloneDepth: '100',
+      };
+
+      mapCliArgumentsToInput(cliArguments);
+
+      expect(Cli.options!['providerStrategy']).toStrictEqual('k8s');
+      expect(Cli.options!['awsStackName']).toStrictEqual('my-stack');
+      expect(Cli.options!['kubeConfig']).toStrictEqual('base64config');
+      expect(Cli.options!['kubeVolume']).toStrictEqual('my-pvc');
+      expect(Cli.options!['kubeVolumeSize']).toStrictEqual('10Gi');
+      expect(Cli.options!['kubeStorageClass']).toStrictEqual('gp3');
+      expect(Cli.options!['containerCpu']).toStrictEqual('2048');
+      expect(Cli.options!['containerMemory']).toStrictEqual('4096');
+      expect(Cli.options!['cacheKey']).toStrictEqual('my-cache');
+      expect(Cli.options!['watchToEnd']).toStrictEqual('false');
+      expect(Cli.options!['cloneDepth']).toStrictEqual('100');
+    });
+  });
+
+  describe('Cli.isCliMode integration', () => {
+    it('enables CLI mode after mapping', () => {
+      const cliArguments: CliArguments = { targetPlatform: 'WebGL' };
+
+      mapCliArgumentsToInput(cliArguments);
+
+      expect(Cli.isCliMode).toStrictEqual(true);
+    });
+
+    it('is not in CLI mode before mapping', () => {
+      expect(Cli.isCliMode).toStrictEqual(false);
+    });
+  });
+});

src/cli/commands/activate.ts

@@ -0,0 +1,83 @@
+import type { CommandModule } from 'yargs';
+import * as core from '@actions/core';
+import { mapCliArgumentsToInput, CliArguments } from '../input-mapper';
+
+interface ActivateArguments extends CliArguments {
+  unityVersion?: string;
+  unitySerial?: string;
+  unityLicensingServer?: string;
+}
+
+const activateCommand: CommandModule<object, ActivateArguments> = {
+  command: 'activate',
+  describe: 'Verify Unity license configuration',
+  builder: (yargs) => {
+    return yargs
+      .option('unity-version', {
+        alias: 'unityVersion',
+        type: 'string',
+        description: 'Version of Unity to activate',
+        default: 'auto',
+      })
+      .option('unity-licensing-server', {
+        alias: 'unityLicensingServer',
+        type: 'string',
+        description: 'The Unity licensing server address for floating licenses',
+        default: '',
+      })
+      .env('UNITY')
+      .example(
+        'UNITY_SERIAL=XXXX-XXXX-XXXX-XXXX game-ci activate',
+        'Activate Unity using a serial from environment variable',
+      )
+      .example(
+        'game-ci activate --unity-licensing-server http://license-server:8080',
+        'Activate Unity using a floating license server',
+      ) as any;
+  },
+  handler: async (cliArguments) => {
+    try {
+      mapCliArgumentsToInput(cliArguments);
+
+      const unitySerial = process.env.UNITY_SERIAL;
+      const unityLicense = process.env.UNITY_LICENSE;
+      const licensingServer = cliArguments.unityLicensingServer || process.env.UNITY_LICENSING_SERVER || '';
+
+      if (licensingServer) {
+        core.info(`Activating Unity via licensing server: ${licensingServer}`);
+        core.info('Floating license activation is handled automatically during builds.');
+        core.info('No manual activation step is needed when using a licensing server.');
+
+        return;
+      }
+
+      if (!unitySerial && !unityLicense) {
+        throw new Error(
+          'No Unity license found.\n\n' +
+            'Provide one of the following:\n' +
+            '  - UNITY_SERIAL environment variable (professional license)\n' +
+            '  - UNITY_LICENSE environment variable (personal license file content)\n' +
+            '  - --unity-licensing-server flag (floating license)\n\n' +
+            'For more information, visit: https://game.ci/docs/github/activation',
+        );
+      }
+
+      if (unitySerial) {
+        const maskedSerial = unitySerial.length > 8 ? `${unitySerial.slice(0, 4)}...${unitySerial.slice(-4)}` : '****';
+        core.info(`Unity serial detected: ${maskedSerial}`);
+        core.info('License will be activated automatically when running a build.');
+      } else if (unityLicense) {
+        core.info('Unity license file detected from UNITY_LICENSE environment variable.');
+        core.info('License will be activated automatically when running a build.');
+      }
+
+      core.info('\nActivation verified. You can now run: game-ci build --target-platform <platform>');
+    } catch (error: any) {
+      core.setFailed(`Activation failed: ${error.message}`);
+
+      throw error;
+    }
+  },
+};
+
+export default activateCommand;

src/cli/commands/build.ts

@@ -0,0 +1,108 @@
+import type { CommandModule } from 'yargs';
+import * as core from '@actions/core';
+import { BuildParameters, ImageTag } from '../../model';
+import { mapCliArgumentsToInput, CliArguments } from '../input-mapper';
+import MacBuilder from '../../model/mac-builder';
+import Docker from '../../model/docker';
+import Action from '../../model/action';
+import PlatformSetup from '../../model/platform-setup';
+import { withProjectOptions, withDockerOptions, withAndroidOptions } from './shared-options';
+
+interface BuildArguments extends CliArguments {
+  targetPlatform: string;
+}
+
+const buildCommand: CommandModule<object, BuildArguments> = {
+  command: 'build',
+  describe: 'Build a Unity project locally via Docker or native runner',
+  builder: (yargs) => {
+    let y = withProjectOptions(yargs);
+    y = withAndroidOptions(y);
+    y = withDockerOptions(y);
+
+    return y
+      .option('build-profile', {
+        alias: 'buildProfile',
+        type: 'string',
+        description: 'Path to the build profile to activate, relative to the project root',
+        default: '',
+      })
+      .option('versioning', {
+        type: 'string',
+        description: 'The versioning scheme to use when building the project',
+        default: 'Semantic',
+      })
+      .option('version', {
+        type: 'string',
+        description: 'The version, when used with the "Custom" versioning scheme',
+        default: '',
+      })
+      .option('manual-exit', {
+        alias: 'manualExit',
+        type: 'boolean',
+        description: 'Suppresses -quit. Exit your build method using EditorApplication.Exit(0) instead.',
+        default: false,
+      })
+      .option('enable-gpu', {
+        alias: 'enableGpu',
+        type: 'boolean',
+        description: 'Launches unity without specifying -nographics',
+        default: false,
+      })
+      .option('cache-unity-installation-on-mac', {
+        alias: 'cacheUnityInstallationOnMac',
+        type: 'boolean',
+        description: 'Whether to cache the Unity hub and editor installation on MacOS',
+        default: false,
+      })
+      .option('unity-hub-version-on-mac', {
+        alias: 'unityHubVersionOnMac',
+        type: 'string',
+        description: 'The version of Unity Hub to install on MacOS (e.g. 3.4.0). Defaults to latest available on brew.',
+        default: '',
+      })
+      .example('game-ci build --target-platform StandaloneLinux64', 'Build for Linux using auto-detected Unity version')
+      .example(
+        'game-ci build --target-platform Android --unity-version 2022.3.56f1 --build-method MyBuild.Run',
+        'Build for Android with a specific Unity version and build method',
+      ) as any;
+  },
+  handler: async (cliArguments) => {
+    try {
+      mapCliArgumentsToInput(cliArguments);
+
+      const buildParameters = await BuildParameters.create();
+      const baseImage = new ImageTag(buildParameters);
+
+      core.info(`Building locally for ${buildParameters.targetPlatform}...`);
+      core.info(`Unity version: ${buildParameters.editorVersion}`);
+      core.info(`Project path: ${buildParameters.projectPath}`);
+
+      const actionFolder = Action.actionFolder;
+      await PlatformSetup.setup(buildParameters, actionFolder);
+
+      const exitCode =
+        process.platform === 'darwin'
+          ? await MacBuilder.run(actionFolder)
+          : await Docker.run(baseImage.toString(), {
+              workspace: process.cwd(),
+              actionFolder,
+              ...buildParameters,
+            });
+
+      core.info(`\nBuild completed with exit code: ${exitCode}`);
+      core.info(`Build version: ${buildParameters.buildVersion}`);
+      core.info(`Build path: ${buildParameters.buildPath}`);
+
+      if (exitCode !== 0) {
+        throw new Error(`Build failed with exit code ${exitCode}`);
+      }
+    } catch (error: any) {
+      core.setFailed(`Build failed: ${error.message}`);
+
+      throw error;
+    }
+  },
+};
+
+export default buildCommand;

src/cli/commands/orchestrate.ts

@@ -0,0 +1,62 @@
+import type { CommandModule } from 'yargs';
+import * as core from '@actions/core';
+import { BuildParameters, ImageTag, Orchestrator } from '../../model';
+import { mapCliArgumentsToInput, CliArguments } from '../input-mapper';
+import { withProjectOptions, withOrchestratorOptions } from './shared-options';
+
+interface OrchestrateArguments extends CliArguments {
+  targetPlatform: string;
+  providerStrategy?: string;
+}
+
+const orchestrateCommand: CommandModule<object, OrchestrateArguments> = {
+  command: ['orchestrate', 'o'],
+  describe: 'Run a build via orchestrator providers (AWS, Kubernetes, etc.)',
+  builder: (yargs) => {
+    let y = withProjectOptions(yargs);
+    y = withOrchestratorOptions(y);
+
+    return y
+      .option('versioning', {
+        type: 'string',
+        description: 'The versioning scheme to use',
+        default: 'None',
+      })
+      .example(
+        'game-ci orchestrate --target-platform StandaloneLinux64 --provider-strategy aws',
+        'Build on AWS using the orchestrator',
+      )
+      .example(
+        'game-ci o --target-platform StandaloneLinux64 --provider-strategy k8s --kube-config <base64>',
+        'Build on Kubernetes (short alias)',
+      ) as any;
+  },
+  handler: async (cliArguments) => {
+    try {
+      mapCliArgumentsToInput(cliArguments);
+
+      const buildParameters = await BuildParameters.create();
+      const baseImage = new ImageTag(buildParameters);
+
+      core.info(`Orchestrating build via ${buildParameters.providerStrategy}...`);
+      core.info(`Target platform: ${buildParameters.targetPlatform}`);
+      core.info(`Unity version: ${buildParameters.editorVersion}`);
+      core.info(`Build GUID: ${buildParameters.buildGuid}`);
+
+      const result = await Orchestrator.run(buildParameters, baseImage.toString());
+
+      core.info(`\nOrchestrated build completed.`);
+      if (result?.BuildResults) {
+        core.info(`Results: ${result.BuildResults}`);
+      } else {
+        core.warning('Build completed but no build results were returned.');
+      }
+    } catch (error: any) {
+      core.setFailed(`Orchestrated build failed: ${error.message}`);
+
+      throw error;
+    }
+  },
+};
+
+export default orchestrateCommand;

src/cli/commands/shared-options.ts

@@ -0,0 +1,308 @@
+import type { Argv } from 'yargs';
+
+/**
+ * Shared option groups for CLI commands. Avoids duplicating option
+ * definitions across build, test, and orchestrate commands.
+ */
+
+export function withProjectOptions<T>(yargs: Argv<T>) {
+  return yargs
+    .option('target-platform', {
+      alias: 'targetPlatform',
+      type: 'string' as const,
+      description: 'Platform that the build should target',
+      demandOption: true,
+    })
+    .option('unity-version', {
+      alias: 'unityVersion',
+      type: 'string' as const,
+      description: 'Version of Unity to use. Use "auto" to detect from ProjectVersion.txt.',
+      default: 'auto',
+    })
+    .option('project-path', {
+      alias: 'projectPath',
+      type: 'string' as const,
+      description: 'Path to the Unity project',
+      default: '.',
+    })
+    .option('build-name', {
+      alias: 'buildName',
+      type: 'string' as const,
+      description: 'Name of the build',
+      default: '',
+    })
+    .option('builds-path', {
+      alias: 'buildsPath',
+      type: 'string' as const,
+      description: 'Path where the builds should be stored',
+      default: 'build',
+    })
+    .option('build-method', {
+      alias: 'buildMethod',
+      type: 'string' as const,
+      description: 'Path to a Namespace.Class.StaticMethod to run to perform the build',
+      default: '',
+    })
+    .option('custom-parameters', {
+      alias: 'customParameters',
+      type: 'string' as const,
+      description: 'Custom parameters to configure the build',
+      default: '',
+    })
+    .option('custom-image', {
+      alias: 'customImage',
+      type: 'string' as const,
+      description: 'Specific docker image that should be used for building the project',
+      default: '',
+    })
+    .option('git-private-token', {
+      alias: 'gitPrivateToken',
+      type: 'string' as const,
+      description: 'GitHub private token for repository access',
+      default: '',
+    })
+    .option('skip-activation', {
+      alias: 'skipActivation',
+      type: 'string' as const,
+      description: 'Skip Unity activation/deactivation',
+      default: 'false',
+    })
+    .option('unity-licensing-server', {
+      alias: 'unityLicensingServer',
+      type: 'string' as const,
+      description: 'The Unity licensing server address',
+      default: '',
+    })
+    .option('container-registry-repository', {
+      alias: 'containerRegistryRepository',
+      type: 'string' as const,
+      description: 'Container registry and repository to pull image from. Only applicable if customImage is not set.',
+      default: 'unityci/editor',
+    })
+    .option('container-registry-image-version', {
+      alias: 'containerRegistryImageVersion',
+      type: 'string' as const,
+      description: 'Container registry image version. Only applicable if customImage is not set.',
+      default: '3',
+    });
+}
+
+export function withDockerOptions<T>(yargs: Argv<T>) {
+  return yargs
+    .option('docker-cpu-limit', {
+      alias: 'dockerCpuLimit',
+      type: 'string' as const,
+      description: 'Number of CPU cores to assign the docker container',
+      default: '',
+    })
+    .option('docker-memory-limit', {
+      alias: 'dockerMemoryLimit',
+      type: 'string' as const,
+      description: 'Amount of memory to assign the docker container (e.g. 512m, 4g)',
+      default: '',
+    })
+    .option('docker-workspace-path', {
+      alias: 'dockerWorkspacePath',
+      type: 'string' as const,
+      description: 'The path to mount the workspace inside the docker container',
+      default: '/github/workspace',
+    })
+    .option('docker-isolation-mode', {
+      alias: 'dockerIsolationMode',
+      type: 'string' as const,
+      description:
+        'Isolation mode to use for the docker container (process, hyperv, or default). Only applicable on Windows.',
+      default: 'default',
+    })
+    .option('run-as-host-user', {
+      alias: 'runAsHostUser',
+      type: 'string' as const,
+      description: 'Whether to run as a user that matches the host system',
+      default: 'false',
+    })
+    .option('chown-files-to', {
+      alias: 'chownFilesTo',
+      type: 'string' as const,
+      description: 'User and optionally group to give ownership of build artifacts',
+      default: '',
+    })
+    .option('ssh-agent', {
+      alias: 'sshAgent',
+      type: 'string' as const,
+      description: 'SSH Agent path to forward to the container',
+      default: '',
+    })
+    .option('ssh-public-keys-directory-path', {
+      alias: 'sshPublicKeysDirectoryPath',
+      type: 'string' as const,
+      description: 'Path to a directory containing SSH public keys to forward to the container',
+      default: '',
+    });
+}
+
+export function withAndroidOptions<T>(yargs: Argv<T>) {
+  return yargs
+    .option('android-version-code', {
+      alias: 'androidVersionCode',
+      type: 'string' as const,
+      description: 'The android versionCode',
+      default: '',
+    })
+    .option('android-export-type', {
+      alias: 'androidExportType',
+      type: 'string' as const,
+      description: 'The android export type (androidPackage, androidAppBundle, androidStudioProject)',
+      default: 'androidPackage',
+    })
+    .option('android-keystore-name', {
+      alias: 'androidKeystoreName',
+      type: 'string' as const,
+      description: 'The android keystoreName',
+      default: '',
+    })
+    .option('android-keystore-base64', {
+      alias: 'androidKeystoreBase64',
+      type: 'string' as const,
+      description: 'The base64 contents of the android keystore file',
+      default: '',
+    })
+    .option('android-keystore-pass', {
+      alias: 'androidKeystorePass',
+      type: 'string' as const,
+      description: 'The android keystorePass',
+      default: '',
+    })
+    .option('android-keyalias-name', {
+      alias: 'androidKeyaliasName',
+      type: 'string' as const,
+      description: 'The android keyaliasName',
+      default: '',
+    })
+    .option('android-keyalias-pass', {
+      alias: 'androidKeyaliasPass',
+      type: 'string' as const,
+      description: 'The android keyaliasPass',
+      default: '',
+    })
+    .option('android-target-sdk-version', {
+      alias: 'androidTargetSdkVersion',
+      type: 'string' as const,
+      description: 'The android target API level',
+      default: '',
+    })
+    .option('android-symbol-type', {
+      alias: 'androidSymbolType',
+      type: 'string' as const,
+      description: 'The android symbol type to export (none, public, debugging)',
+      default: 'none',
+    });
+}
+
+export function withOrchestratorOptions<T>(yargs: Argv<T>) {
+  return yargs
+    .option('provider-strategy', {
+      alias: 'providerStrategy',
+      type: 'string' as const,
+      description: 'Orchestrator provider: aws, k8s, local-docker, local-system',
+      default: 'aws',
+    })
+    .option('aws-stack-name', {
+      alias: 'awsStackName',
+      type: 'string' as const,
+      description: 'The Cloud Formation stack name (AWS provider)',
+      default: 'game-ci',
+    })
+    .option('kube-config', {
+      alias: 'kubeConfig',
+      type: 'string' as const,
+      description: 'Base64 encoded Kubernetes config (K8s provider)',
+      default: '',
+    })
+    .option('kube-volume', {
+      alias: 'kubeVolume',
+      type: 'string' as const,
+      description: 'Persistent Volume Claim name for Unity build (K8s provider)',
+      default: '',
+    })
+    .option('kube-volume-size', {
+      alias: 'kubeVolumeSize',
+      type: 'string' as const,
+      description: 'Disc space for Kubernetes Persistent Volume',
+      default: '5Gi',
+    })
+    .option('kube-storage-class', {
+      alias: 'kubeStorageClass',
+      type: 'string' as const,
+      description: 'Kubernetes storage class to use for orchestrator jobs. Leave empty to install rook cluster.',
+      default: '',
+    })
+    .option('container-cpu', {
+      alias: 'containerCpu',
+      type: 'string' as const,
+      description: 'CPU allocation for remote build container',
+      default: '1024',
+    })
+    .option('container-memory', {
+      alias: 'containerMemory',
+      type: 'string' as const,
+      description: 'Memory allocation for remote build container',
+      default: '3072',
+    })
+    .option('cache-key', {
+      alias: 'cacheKey',
+      type: 'string' as const,
+      description: 'Cache key to indicate bucket for cache',
+      default: '',
+    })
+    .option('allow-dirty-build', {
+      alias: 'allowDirtyBuild',
+      type: 'boolean' as const,
+      description: 'Allow builds from dirty branches',
+      default: false,
+    })
+    .option('watch-to-end', {
+      alias: 'watchToEnd',
+      type: 'string' as const,
+      description: 'Whether to watch the build to completion',
+      default: 'true',
+    })
+    .option('clone-depth', {
+      alias: 'cloneDepth',
+      type: 'string' as const,
+      description: 'Git clone depth (0 for full clone)',
+      default: '50',
+    })
+    .option('read-input-from-override-list', {
+      alias: 'readInputFromOverrideList',
+      type: 'string' as const,
+      description: 'Comma separated list of input value names to read from the input override command',
+      default: '',
+    })
+    .option('read-input-override-command', {
+      alias: 'readInputOverrideCommand',
+      type: 'string' as const,
+      description: 'Command to execute to pull input from an external source (e.g. cloud provider secret managers)',
+      default: '',
+    })
+    .option('post-build-steps', {
+      alias: 'postBuildSteps',
+      type: 'string' as const,
+      description:
+        'Post build job in yaml format with the keys image, secrets (name, value object array), command string',
+      default: '',
+    })
+    .option('pre-build-steps', {
+      alias: 'preBuildSteps',
+      type: 'string' as const,
+      description:
+        'Pre build job after repository setup but before the build job (yaml format with keys image, secrets, command)',
+      default: '',
+    })
+    .option('custom-job', {
+      alias: 'customJob',
+      type: 'string' as const,
+      description:
+        'Custom job instead of the standard build automation (yaml format with keys image, secrets, command)',
+      default: '',
+    });
+}

src/cli/commands/status.ts

@@ -0,0 +1,117 @@
+import type { CommandModule } from 'yargs';
+import * as core from '@actions/core';
+import fs from 'node:fs';
+import path from 'node:path';
+import UnityVersioning from '../../model/unity-versioning';
+
+const statusCommand: CommandModule = {
+  command: 'status',
+  describe: 'Show project info, environment, and cache status',
+  builder: (yargs) => {
+    return yargs
+      .option('project-path', {
+        alias: 'projectPath',
+        type: 'string',
+        description: 'Path to the Unity project',
+        default: '.',
+      })
+      .option('cache-dir', {
+        alias: 'cacheDir',
+        type: 'string',
+        description: 'Path to an additional cache directory to inspect',
+        default: '',
+      });
+  },
+  handler: async (cliArguments) => {
+    const projectPath = (cliArguments.projectPath as string) || '.';
+    const cacheDirectory = cliArguments.cacheDir as string;
+
+    core.info('game-ci Workspace Status');
+    core.info('========================\n');
+
+    // Project detection
+    const projectVersionPath = path.join(projectPath, 'ProjectSettings', 'ProjectVersion.txt');
+    const hasProject = fs.existsSync(projectVersionPath);
+
+    core.info(`Project Path: ${path.resolve(projectPath)}`);
+    core.info(`Unity Project Found: ${hasProject ? 'Yes' : 'No'}`);
+
+    if (hasProject) {
+      try {
+        const unityVersion = UnityVersioning.determineUnityVersion(projectPath, 'auto');
+        core.info(`Unity Version: ${unityVersion}`);
+      } catch {
+        core.info(`Unity Version: Unable to detect`);
+      }
+
+      // Library cache status
+      const libraryPath = path.join(projectPath, 'Library');
+      if (fs.existsSync(libraryPath)) {
+        const stats = fs.statSync(libraryPath);
+        core.info(`Library Cache: Present (modified ${stats.mtime.toISOString()})`);
+
+        const keyDirectories = ['PackageCache', 'ScriptAssemblies', 'ShaderCache', 'Bee'];
+        for (const directory of keyDirectories) {
+          const directoryPath = path.join(libraryPath, directory);
+          if (fs.existsSync(directoryPath)) {
+            const directoryStats = fs.statSync(directoryPath);
+            core.info(`  ${directory}/: exists (modified ${directoryStats.mtime.toISOString()})`);
+          }
+        }
+      } else {
+        core.info(`Library Cache: Not present (clean build required)`);
+      }
+
+      // Cache archive detection
+      if (cacheDirectory && fs.existsSync(cacheDirectory)) {
+        core.info(`\nCache Archives (${cacheDirectory}):`);
+        const cacheFiles = fs.readdirSync(cacheDirectory).filter((f) => f.endsWith('.tar') || f.endsWith('.tar.lz4'));
+        if (cacheFiles.length > 0) {
+          for (const file of cacheFiles) {
+            const filePath = path.join(cacheDirectory, file);
+            const fileStats = fs.statSync(filePath);
+            const sizeMegabytes = (fileStats.size / (1024 * 1024)).toFixed(1);
+            core.info(`  - ${file} (${sizeMegabytes} MB, ${fileStats.mtime.toISOString()})`);
+          }
+        } else {
+          core.info('  No cache archives found.');
+        }
+      }
+
+      // Build output detection
+      const buildsPath = path.join(projectPath, '..', 'build');
+      if (fs.existsSync(buildsPath)) {
+        const builds = fs.readdirSync(buildsPath);
+        if (builds.length > 0) {
+          core.info(`\nBuild Outputs (${buildsPath}):`);
+          for (const build of builds) {
+            const buildPath = path.join(buildsPath, build);
+            const buildStats = fs.statSync(buildPath);
+            core.info(`  - ${build} (${buildStats.isDirectory() ? 'dir' : 'file'}, ${buildStats.mtime.toISOString()})`);
+          }
+        }
+      }
+    }
+
+    // Environment
+    core.info('\nEnvironment:');
+    core.info(`  Platform: ${process.platform}`);
+    core.info(`  Node.js: ${process.version}`);
+    core.info(`  UNITY_SERIAL: ${process.env.UNITY_SERIAL ? 'Set' : 'Not set'}`);
+    core.info(`  UNITY_LICENSE: ${process.env.UNITY_LICENSE ? 'Set' : 'Not set'}`);
+    core.info(`  UNITY_EMAIL: ${process.env.UNITY_EMAIL ? 'Set' : 'Not set'}`);
+    core.info(`  UNITY_PASSWORD: ${process.env.UNITY_PASSWORD ? 'Set' : 'Not set'}`);
+
+    // Docker availability
+    core.info(`\nDocker: Checking...`);
+    try {
+      const { execSync } = await import('node:child_process');
+      const dockerVersion = execSync('docker --version', { encoding: 'utf8' }).trim();
+      core.info(`  ${dockerVersion}`);
+    } catch {
+      core.info(`  Docker not found or not accessible`);
+    }
+  },
+};
+
+export default statusCommand;

src/cli/commands/test.ts

@@ -0,0 +1,126 @@
+import type { CommandModule } from 'yargs';
+import * as core from '@actions/core';
+import { BuildParameters, ImageTag } from '../../model';
+import { mapCliArgumentsToInput, CliArguments } from '../input-mapper';
+import Docker from '../../model/docker';
+import Action from '../../model/action';
+import PlatformSetup from '../../model/platform-setup';
+import { withProjectOptions, withDockerOptions } from './shared-options';
+
+interface TestArguments extends CliArguments {
+  targetPlatform: string;
+  testMode?: string;
+}
+
+const testCommand: CommandModule<object, TestArguments> = {
+  command: ['test', 't'],
+  describe: 'Run tests for a Unity project',
+  builder: (yargs) => {
+    let y = withProjectOptions(yargs);
+    y = withDockerOptions(y);
+
+    return y
+      .option('test-mode', {
+        alias: 'testMode',
+        type: 'string',
+        description: 'The mode to run tests in (EditMode, PlayMode, or All)',
+        default: 'All',
+        choices: ['EditMode', 'PlayMode', 'All'],
+      })
+      .option('test-results-path', {
+        alias: 'testResultsPath',
+        type: 'string',
+        description: 'Path where test results XML should be stored',
+        default: 'test-results',
+      })
+      .option('test-category', {
+        alias: 'testCategory',
+        type: 'string',
+        description: 'Only run tests in the given category (semicolon-separated)',
+        default: '',
+      })
+      .option('test-filter', {
+        alias: 'testFilter',
+        type: 'string',
+        description: 'Only run tests that match the filter (semicolon-separated)',
+        default: '',
+      })
+      .option('coverage-options', {
+        alias: 'coverageOptions',
+        type: 'string',
+        description: 'Options for code coverage (e.g. assemblyFilters, pathFilters)',
+        default: '',
+      })
+      .option('enable-code-coverage', {
+        alias: 'enableCodeCoverage',
+        type: 'boolean',
+        description: 'Enable code coverage when running tests',
+        default: false,
+      })
+      .option('versioning', {
+        type: 'string',
+        description: 'The versioning scheme to use',
+        default: 'None',
+      })
+      .option('cache-unity-installation-on-mac', {
+        alias: 'cacheUnityInstallationOnMac',
+        type: 'boolean',
+        description: 'Whether to cache the Unity hub and editor installation on MacOS',
+        default: false,
+      })
+      .option('unity-hub-version-on-mac', {
+        alias: 'unityHubVersionOnMac',
+        type: 'string',
+        description: 'The version of Unity Hub to install on MacOS (e.g. 3.4.0). Defaults to latest available on brew.',
+        default: '',
+      })
+      .example('game-ci test --target-platform StandaloneLinux64', 'Run all tests for Linux platform')
+      .example(
+        'game-ci t --target-platform StandaloneLinux64 --test-mode EditMode',
+        'Run only EditMode tests (short alias)',
+      )
+      .example(
+        'game-ci test --target-platform StandaloneLinux64 --enable-code-coverage',
+        'Run tests with code coverage',
+      ) as any;
+  },
+  handler: async (cliArguments) => {
+    try {
+      // Map test-specific flags into the input system
+      mapCliArgumentsToInput(cliArguments);
+
+      const buildParameters = await BuildParameters.create();
+      const baseImage = new ImageTag(buildParameters);
+
+      const testMode = cliArguments.testMode || 'All';
+
+      core.info(`Running Unity tests (${testMode})...`);
+      core.info(`Target platform: ${buildParameters.targetPlatform}`);
+      core.info(`Unity version: ${buildParameters.editorVersion}`);
+      core.info(`Project path: ${buildParameters.projectPath}`);
+
+      const actionFolder = Action.actionFolder;
+      await PlatformSetup.setup(buildParameters, actionFolder);
+
+      const exitCode = await Docker.run(baseImage.toString(), {
+        workspace: process.cwd(),
+        actionFolder,
+        ...buildParameters,
+      });
+
+      const resultsPath = cliArguments.testResultsPath || 'test-results';
+      core.info(`\nTests completed with exit code: ${exitCode}`);
+      core.info(`Test results: ${resultsPath}`);
+
+      if (exitCode !== 0) {
+        throw new Error(`Tests failed with exit code ${exitCode}`);
+      }
+    } catch (error: any) {
+      core.setFailed(`Tests failed: ${error.message}`);
+
+      throw error;
+    }
+  },
+};
+
+export default testCommand;

src/cli/commands/update.ts

@@ -0,0 +1,387 @@
+import type { CommandModule } from 'yargs';
+import * as core from '@actions/core';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import https from 'node:https';
+import http from 'node:http';
+import { execFileSync } from 'node:child_process';
+
+const REPO = 'game-ci/unity-builder';
+
+interface GitHubRelease {
+  // eslint-disable-next-line camelcase
+  tag_name: string;
+  assets: Array<{
+    name: string;
+    // eslint-disable-next-line camelcase
+    browser_download_url: string;
+    size: number;
+  }>;
+}
+
+interface UpdateArguments {
+  force?: boolean;
+  version?: string;
+}
+
+/**
+ * Fetches JSON from a URL via HTTPS, following redirects.
+ */
+function fetchJson(url: string): Promise<any> {
+  return new Promise((resolve, reject) => {
+    const get = (targetUrl: string, redirectCount: number) => {
+      if (redirectCount > 5) {
+        reject(new Error('Too many redirects'));
+
+        return;
+      }
+      https
+        .get(
+          targetUrl,
+          {
+            headers: { 'User-Agent': 'game-ci-cli', Accept: 'application/json' },
+          },
+          (response) => {
+            if (
+              response.statusCode &&
+              response.statusCode >= 300 &&
+              response.statusCode < 400 &&
+              response.headers.location
+            ) {
+              get(response.headers.location, redirectCount + 1);
+
+              return;
+            }
+            if (response.statusCode !== 200) {
+              reject(new Error(`HTTP ${response.statusCode} from ${targetUrl}`));
+
+              return;
+            }
+            let data = '';
+            response.on('data', (chunk) => (data += chunk));
+            response.on('end', () => {
+              try {
+                resolve(JSON.parse(data));
+              } catch {
+                reject(new Error('Invalid JSON response'));
+              }
+            });
+          },
+        )
+        .on('error', reject);
+    };
+    get(url, 0);
+  });
+}
+
+/**
+ * Downloads a file from a URL, following redirects. Returns the file content as a Buffer.
+ */
+function downloadFile(url: string): Promise<Buffer> {
+  return new Promise((resolve, reject) => {
+    const get = (targetUrl: string, redirectCount: number) => {
+      if (redirectCount > 10) {
+        reject(new Error('Too many redirects'));
+
+        return;
+      }
+
+      const protocol = targetUrl.startsWith('https') ? https : http;
+      protocol
+        .get(targetUrl, { headers: { 'User-Agent': 'game-ci-cli' } }, (response) => {
+          if (
+            response.statusCode &&
+            response.statusCode >= 300 &&
+            response.statusCode < 400 &&
+            response.headers.location
+          ) {
+            get(response.headers.location, redirectCount + 1);
+
+            return;
+          }
+          if (response.statusCode !== 200) {
+            reject(new Error(`HTTP ${response.statusCode} downloading ${targetUrl}`));
+
+            return;
+          }
+          const chunks: Buffer[] = [];
+          response.on('data', (chunk: Buffer) => chunks.push(chunk));
+          response.on('end', () => resolve(Buffer.concat(chunks)));
+        })
+        .on('error', reject);
+    };
+    get(url, 0);
+  });
+}
+
+/**
+ * Gets the current version from package.json or the compiled binary.
+ */
+function getCurrentVersion(): string {
+  // Try reading from package.json at various relative locations
+  const candidates = [
+    path.join(__dirname, '..', '..', '..', 'package.json'),
+    path.join(__dirname, '..', '..', 'package.json'),
+    path.join(process.cwd(), 'package.json'),
+  ];
+
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) {
+      try {
+        const packageData = JSON.parse(fs.readFileSync(candidate, 'utf8'));
+        if (packageData.version) {
+          return packageData.version;
+        }
+      } catch {
+        // Continue to next candidate
+      }
+    }
+  }
+
+  return 'unknown';
+}
+
+/**
+ * Determines the correct asset name for the current platform/architecture.
+ */
+function getAssetName(): string {
+  const platform = process.platform;
+  const arch = process.arch;
+
+  let osPart: string;
+  switch (platform) {
+    case 'linux':
+      osPart = 'linux';
+      break;
+    case 'darwin':
+      osPart = 'macos';
+      break;
+    case 'win32':
+      osPart = 'windows';
+      break;
+    default:
+      throw new Error(`Unsupported platform: ${platform}`);
+  }
+
+  let archPart: string;
+  switch (arch) {
+    case 'x64':
+      archPart = 'x64';
+      break;
+    case 'arm64':
+      archPart = 'arm64';
+      break;
+    default:
+      throw new Error(`Unsupported architecture: ${arch}`);
+  }
+
+  const assetBaseName = `game-ci-${osPart}-${archPart}`;
+
+  return osPart === 'windows' ? `${assetBaseName}.exe` : assetBaseName;
+}
+
+/**
+ * Determines the path to the currently running executable.
+ * For standalone binaries (pkg), process.execPath points to the binary itself.
+ * For Node.js execution, we return undefined since self-update does not apply.
+ */
+function getExecutablePath(): string | undefined {
+  // When running as a pkg binary, process.pkg is defined
+  if ((process as any).pkg) {
+    return process.execPath;
+  }
+
+  // When running via Node.js, check if there is a standalone binary in the typical install location
+  const installDirectory = process.env.GAME_CI_INSTALL || path.join(os.homedir(), '.game-ci', 'bin');
+  const binaryName = process.platform === 'win32' ? 'game-ci.exe' : 'game-ci';
+  const installedPath = path.join(installDirectory, binaryName);
+
+  if (fs.existsSync(installedPath)) {
+    return installedPath;
+  }
+
+  return;
+}
+
+/**
+ * Strips leading 'v' from a version string and splits into numeric parts.
+ */
+function parseVersionParts(version: string): number[] {
+  return version
+    .replace(/^v/, '')
+    .split('.')
+    .map((part) => Number(part));
+}
+
+/**
+ * Compares two semver strings. Returns:
+ *  -1 if a < b
+ *   0 if a == b
+ *   1 if a > b
+ */
+function compareSemver(a: string, b: string): number {
+  const partsA = parseVersionParts(a);
+  const partsB = parseVersionParts(b);
+
+  for (let index = 0; index < 3; index++) {
+    const x = partsA[index] || 0;
+    const y = partsB[index] || 0;
+    if (x < y) return -1;
+    if (x > y) return 1;
+  }
+
+  return 0;
+}
+
+const updateCommand: CommandModule<object, UpdateArguments> = {
+  command: 'update',
+  describe: 'Update game-ci to the latest version',
+  builder: (yargs) => {
+    return yargs
+      .option('force', {
+        alias: 'f',
+        type: 'boolean',
+        description: 'Force update even if already on latest version',
+        default: false,
+      })
+      .option('version', {
+        type: 'string',
+        description: 'Update to a specific version (e.g., v2.0.0)',
+        default: '',
+      })
+      .example('game-ci update', 'Update to the latest version')
+      .example('game-ci update --version v2.1.0', 'Update to a specific version')
+      .example('game-ci update --force', 'Force reinstall of the current version') as any;
+  },
+  handler: async (cliArguments) => {
+    try {
+      const currentVersion = getCurrentVersion();
+      core.info(`Current version: v${currentVersion}`);
+      core.info(`Platform: ${process.platform} ${process.arch}`);
+      core.info('');
+
+      // Fetch release info
+      let release: GitHubRelease;
+      const targetVersion = cliArguments.version as string;
+
+      if (targetVersion) {
+        const tag = targetVersion.startsWith('v') ? targetVersion : `v${targetVersion}`;
+        core.info(`Fetching release ${tag}...`);
+        release = await fetchJson(`https://api.github.com/repos/${REPO}/releases/tags/${tag}`);
+      } else {
+        core.info('Checking for updates...');
+        release = await fetchJson(`https://api.github.com/repos/${REPO}/releases/latest`);
+      }
+
+      const latestVersion = release.tag_name;
+      core.info(`Latest version:  ${latestVersion}`);
+      core.info('');
+
+      // Compare versions
+      const comparison = compareSemver(currentVersion, latestVersion);
+      if (comparison >= 0 && !cliArguments.force) {
+        core.info('You are already on the latest version. Use --force to reinstall.');
+
+        return;
+      }
+
+      if (comparison > 0 && !targetVersion) {
+        core.info(`Current version (v${currentVersion}) is newer than latest release (${latestVersion}).`);
+        core.info('Use --force to downgrade, or --version to target a specific release.');
+
+        return;
+      }
+
+      // Find the correct asset
+      const assetName = getAssetName();
+      const asset = release.assets.find((a) => a.name === assetName);
+
+      if (!asset) {
+        const available = release.assets.map((a) => a.name).join(', ');
+        throw new Error(
+          `No binary found for ${process.platform}-${process.arch} (looking for ${assetName}).\nAvailable assets: ${available}`,
+        );
+      }
+
+      const sizeMb = (asset.size / (1024 * 1024)).toFixed(1);
+      core.info(`Downloading ${assetName} (${sizeMb} MB)...`);
+
+      // Download the new binary
+      const binaryData = await downloadFile(asset.browser_download_url);
+
+      // Determine where to write the updated binary
+      const executablePath = getExecutablePath();
+
+      if (!executablePath) {
+        core.info('');
+        core.info('game-ci is running via Node.js (not as a standalone binary).');
+        core.info('To update the npm package, run:');
+        core.info('  npm install -g unity-builder@latest');
+        core.info('');
+        core.info('To install the standalone binary instead:');
+        core.info('  curl -fsSL https://raw.githubusercontent.com/game-ci/unity-builder/main/install.sh | sh');
+
+        return;
+      }
+
+      // Write the new binary.
+      // On Windows, we cannot overwrite a running executable directly.
+      // Write to a temporary file, then rename.
+      const temporaryPath = `${executablePath}.update`;
+      const backupPath = `${executablePath}.backup`;
+
+      fs.writeFileSync(temporaryPath, binaryData);
+
+      if (process.platform !== 'win32') {
+        fs.chmodSync(temporaryPath, 0o755);
+      }
+
+      // Verify the downloaded binary
+      try {
+        const output = execFileSync(temporaryPath, ['version'], { encoding: 'utf8', timeout: 10_000 });
+        core.info(`Verified new binary: ${output.trim().split('\n')[0]}`);
+      } catch (verifyError: any) {
+        fs.unlinkSync(temporaryPath);
+        throw new Error(`Downloaded binary failed verification: ${verifyError.message}`);
+      }
+
+      // Replace the current binary
+      try {
+        // Backup current
+        if (fs.existsSync(backupPath)) {
+          fs.unlinkSync(backupPath);
+        }
+        fs.renameSync(executablePath, backupPath);
+        fs.renameSync(temporaryPath, executablePath);
+
+        // Clean up backup
+        try {
+          fs.unlinkSync(backupPath);
+        } catch {
+          // On Windows the backup may be locked; that is fine
+        }
+      } catch (replaceError: any) {
+        // Attempt to restore from backup
+        if (fs.existsSync(backupPath) && !fs.existsSync(executablePath)) {
+          fs.renameSync(backupPath, executablePath);
+        }
+
+        // Clean up temporary file
+        if (fs.existsSync(temporaryPath)) {
+          fs.unlinkSync(temporaryPath);
+        }
+        throw new Error(`Failed to replace binary: ${replaceError.message}`);
+      }
+
+      core.info('');
+      core.info(`Successfully updated game-ci to ${latestVersion}`);
+    } catch (error: any) {
+      core.error(`Update failed: ${error.message}`);
+
+      throw error;
+    }
+  },
+};
+
+export default updateCommand;

src/cli/commands/version.ts

@@ -0,0 +1,37 @@
+import type { CommandModule } from 'yargs';
+import * as core from '@actions/core';
+import fs from 'node:fs';
+import path from 'node:path';
+
+const versionCommand: CommandModule = {
+  command: 'version',
+  describe: 'Show version info',
+  builder: {},
+  handler: async () => {
+    try {
+      // Read version from package.json
+      let packageJsonPath = path.join(__dirname, '..', '..', '..', 'package.json');
+      if (!fs.existsSync(packageJsonPath)) {
+        packageJsonPath = path.join(__dirname, '..', '..', 'package.json');
+      }
+      if (!fs.existsSync(packageJsonPath)) {
+        packageJsonPath = path.join(process.cwd(), 'package.json');
+      }
+
+      if (fs.existsSync(packageJsonPath)) {
+        const packageData = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+        core.info(`game-ci (unity-builder) v${packageData.version}`);
+        core.info(`Node.js ${process.version}`);
+        core.info(`Platform: ${process.platform} ${process.arch}`);
+      } else {
+        core.info('game-ci (unity-builder)');
+        core.info('Version information unavailable');
+      }
+    } catch (error: any) {
+      core.info('game-ci (unity-builder)');
+      core.error(`Could not read version: ${error.message}`);
+    }
+  },
+};
+
+export default versionCommand;

src/cli/input-mapper.ts

@@ -0,0 +1,113 @@
+import { Cli } from '../model/cli/cli';
+import GitHub from '../model/github';
+
+/**
+ * Maps CLI arguments (kebab-case flags) to the Input/OrchestratorOptions
+ * interface used by the action. This bridges the gap between user-friendly
+ * CLI flags and the camelCase environment/input system unity-builder expects.
+ *
+ * The existing Input class already queries Cli.options, environment variables,
+ * and GitHub Action inputs in priority order. We populate Cli.options so that
+ * the rest of the codebase works unchanged.
+ */
+export interface CliArguments {
+  targetPlatform?: string;
+  unityVersion?: string;
+  projectPath?: string;
+  buildProfile?: string;
+  buildName?: string;
+  buildsPath?: string;
+  buildMethod?: string;
+  customParameters?: string;
+  versioning?: string;
+  version?: string;
+  customImage?: string;
+  manualExit?: boolean;
+  enableGpu?: boolean;
+
+  androidVersionCode?: string;
+  androidExportType?: string;
+  androidKeystoreName?: string;
+  androidKeystoreBase64?: string;
+  androidKeystorePass?: string;
+  androidKeyaliasName?: string;
+  androidKeyaliasPass?: string;
+  androidTargetSdkVersion?: string;
+  androidSymbolType?: string;
+
+  dockerCpuLimit?: string;
+  dockerMemoryLimit?: string;
+  dockerIsolationMode?: string;
+  dockerWorkspacePath?: string;
+  containerRegistryRepository?: string;
+  containerRegistryImageVersion?: string;
+  runAsHostUser?: string;
+  chownFilesTo?: string;
+
+  sshAgent?: string;
+  sshPublicKeysDirectoryPath?: string;
+  gitPrivateToken?: string;
+
+  providerStrategy?: string;
+  awsStackName?: string;
+  kubeConfig?: string;
+  kubeVolume?: string;
+  kubeVolumeSize?: string;
+  kubeStorageClass?: string;
+  containerCpu?: string;
+  containerMemory?: string;
+  cacheKey?: string;
+  watchToEnd?: string;
+  allowDirtyBuild?: boolean;
+  skipActivation?: string;
+  cloneDepth?: string;
+
+  readInputFromOverrideList?: string;
+  readInputOverrideCommand?: string;
+  postBuildSteps?: string;
+  preBuildSteps?: string;
+  customJob?: string;
+
+  unityLicensingServer?: string;
+
+  cacheUnityInstallationOnMac?: boolean;
+  unityHubVersionOnMac?: string;
+
+  testMode?: string;
+  testResultsPath?: string;
+  testCategory?: string;
+  testFilter?: string;
+  coverageOptions?: string;
+  enableCodeCoverage?: boolean;
+
+  mode?: string;
+
+  [key: string]: unknown;
+}
+
+/**
+ * Converts kebab-case CLI flags to camelCase keys matching the Input class
+ * property names, then injects them into Cli.options so the existing
+ * Input.getInput() / OrchestratorOptions.getInput() chain picks them up.
+ */
+export function mapCliArgumentsToInput(cliArguments: CliArguments): void {
+  // Disable GitHub Actions input reading when in CLI mode
+  GitHub.githubInputEnabled = false;
+
+  // The existing Cli.options mechanism is used by Input.getInput() to query
+  // CLI-provided values. We set it directly.
+  const mapped: Record<string, unknown> = {};
+
+  for (const [key, value] of Object.entries(cliArguments)) {
+    if (value !== undefined && key !== '_' && key !== '$0') {
+      mapped[key] = typeof value === 'boolean' ? String(value) : value;
+    }
+  }
+
+  // Ensure mode is set so Cli.isCliMode returns true
+  if (!mapped['mode']) {
+    mapped['mode'] = 'cli';
+  }
+
+  Cli.options = mapped;
+}

src/index.ts

@@ -3,7 +3,6 @@ import { Action, BuildParameters, Cache, Orchestrator, Docker, ImageTag, Output
 import { Cli } from './model/cli/cli';
 import MacBuilder from './model/mac-builder';
 import PlatformSetup from './model/platform-setup';
-import { TestWorkflowService } from './model/orchestrator/services/test-workflow';
 
 async function runMain() {
   try {
@@ -18,23 +17,6 @@ async function runMain() {
     const { workspace, actionFolder } = Action;
 
     const buildParameters = await BuildParameters.create();
-
-    // If a test suite path is provided, use the test workflow engine
-    // instead of the standard build execution path
-    if (buildParameters.testSuitePath) {
-      core.info('[TestWorkflow] Test suite path detected, using test workflow engine');
-      const results = await TestWorkflowService.executeTestSuite(buildParameters.testSuitePath, buildParameters);
-
-      const totalFailed = results.reduce((sum, r) => sum + r.failed, 0);
-      if (totalFailed > 0) {
-        core.setFailed(`Test workflow completed with ${totalFailed} failure(s)`);
-      } else {
-        core.info('[TestWorkflow] All test runs passed');
-      }
-
-      return;
-    }
-
     const baseImage = new ImageTag(buildParameters);
 
     let exitCode = -1;

src/model/build-parameters.ts

@@ -107,12 +107,6 @@ class BuildParameters {
   public unityHubVersionOnMac!: string;
   public dockerWorkspacePath!: string;
 
-  public testSuitePath!: string;
-  public testSuiteEvent!: string;
-  public testTaxonomyPath!: string;
-  public testResultFormat!: string;
-  public testResultPath!: string;
-
   public static shouldUseRetainedWorkspaceMode(buildParameters: BuildParameters) {
     return buildParameters.maxRetainedWorkspaces > 0 && Orchestrator.lockedWorkspace !== ``;
   }
@@ -248,11 +242,6 @@ class BuildParameters {
       cacheUnityInstallationOnMac: Input.cacheUnityInstallationOnMac,
       unityHubVersionOnMac: Input.unityHubVersionOnMac,
       dockerWorkspacePath: Input.dockerWorkspacePath,
-      testSuitePath: Input.testSuitePath,
-      testSuiteEvent: Input.testSuiteEvent,
-      testTaxonomyPath: Input.testTaxonomyPath,
-      testResultFormat: Input.testResultFormat,
-      testResultPath: Input.testResultPath,
     };
   }
 

src/model/cli/cli.ts

@@ -155,8 +155,8 @@ export class Cli {
     return result.map((x) => x.Name);
   }
 
-  @CliFunction(`list-worfklow`, `lists running workflows`)
-  public static async ListWorfklow(): Promise<string[]> {
+  @CliFunction(`list-workflow`, `lists running workflows`)
+  public static async ListWorkflow(): Promise<string[]> {
     const buildParameter = await BuildParameters.create();
 
     await Orchestrator.setup(buildParameter);

src/model/input.ts

@@ -282,26 +282,6 @@ class Input {
     return Input.getInput('skipActivation')?.toLowerCase() ?? 'false';
   }
 
-  static get testSuitePath(): string {
-    return Input.getInput('testSuitePath') ?? '';
-  }
-
-  static get testSuiteEvent(): string {
-    return Input.getInput('testSuiteEvent') ?? '';
-  }
-
-  static get testTaxonomyPath(): string {
-    return Input.getInput('testTaxonomyPath') ?? '';
-  }
-
-  static get testResultFormat(): string {
-    return Input.getInput('testResultFormat') ?? 'junit';
-  }
-
-  static get testResultPath(): string {
-    return Input.getInput('testResultPath') ?? './test-results';
-  }
-
   public static ToEnvVarFormat(input: string) {
     if (input.toUpperCase() === input) {
       return input;

src/model/orchestrator/services/test-workflow/index.ts

@@ -1,12 +0,0 @@
-export { TestSuiteParser } from './test-suite-parser';
-export { TaxonomyFilterService } from './taxonomy-filter-service';
-export { TestResultReporter } from './test-result-reporter';
-export { TestWorkflowService } from './test-workflow-service';
-export {
-  TestSuiteDefinition,
-  TestRunDefinition,
-  TaxonomyDimension,
-  TaxonomyDefinition,
-  TestResult,
-  TestFailure,
-} from './test-workflow-types';

src/model/orchestrator/services/test-workflow/taxonomy-filter-service.ts

@@ -1,198 +0,0 @@
-import fs from 'node:fs';
-import YAML from 'yaml';
-import { TaxonomyDimension, TaxonomyDefinition } from './test-workflow-types';
-
-/**
- * Manages test taxonomy dimensions and builds filter arguments for
- * the Unity test runner CLI. Supports comma-separated value lists,
- * regex patterns (/pattern/), and hierarchical dot-notation matching.
- */
-export class TaxonomyFilterService {
-  /**
-   * Built-in taxonomy dimensions that are always available.
-   * Projects may extend these via a custom taxonomy file.
-   */
-  private static readonly BUILT_IN_DIMENSIONS: TaxonomyDimension[] = [
-    { name: 'Scope', values: ['Unit', 'Integration', 'System', 'End To End'] },
-    { name: 'Maturity', values: ['Trusted', 'Adolescent', 'Experimental'] },
-    { name: 'FeedbackSpeed', values: ['Fast', 'Moderate', 'Slow'] },
-    { name: 'Execution', values: ['Synchronous', 'Asynchronous', 'Coroutine'] },
-    { name: 'Rigor', values: ['Strict', 'Normal', 'Relaxed'] },
-    { name: 'Determinism', values: ['Deterministic', 'NonDeterministic'] },
-    { name: 'IsolationLevel', values: ['Full', 'Partial', 'None'] },
-  ];
-
-  /**
-   * Load taxonomy dimensions: built-in dimensions plus any custom dimensions
-   * from an optional taxonomy file.
-   */
-  static loadTaxonomy(filePath?: string): TaxonomyDimension[] {
-    const dimensions = [...TaxonomyFilterService.BUILT_IN_DIMENSIONS];
-
-    if (filePath && fs.existsSync(filePath)) {
-      const content = fs.readFileSync(filePath, 'utf8');
-      const parsed = YAML.parse(content) as TaxonomyDefinition;
-
-      if (parsed?.extensible_groups && Array.isArray(parsed.extensible_groups)) {
-        for (const group of parsed.extensible_groups) {
-          if (group.name && Array.isArray(group.values)) {
-            // If a custom dimension has the same name as a built-in, merge values
-            const existing = dimensions.find((d) => d.name === group.name);
-            if (existing) {
-              const existingValues = new Set(existing.values);
-              for (const value of group.values) {
-                if (!existingValues.has(value)) {
-                  existing.values.push(value);
-                }
-              }
-            } else {
-              dimensions.push({ name: group.name, values: [...group.values] });
-            }
-          }
-        }
-      }
-    }
-
-    return dimensions;
-  }
-
-  /**
-   * Convert a filter map to Unity test runner CLI args (--testFilter).
-   *
-   * Each filter dimension becomes a category expression. Multiple values in one
-   * dimension are OR'd; multiple dimensions are AND'd. The result is a single
-   * --testFilter string suitable for passing to Unity's test runner CLI.
-   *
-   * Regex patterns (values wrapped in /.../) are converted to category regex
-   * expressions supported by the Unity test runner.
-   */
-  static buildFilterArgs(filters: Record<string, string>): string {
-    if (!filters || Object.keys(filters).length === 0) {
-      return '';
-    }
-
-    const categoryExpressions: string[] = [];
-
-    for (const [dimension, valueSpec] of Object.entries(filters)) {
-      const expression = TaxonomyFilterService.buildDimensionExpression(dimension, valueSpec);
-      if (expression) {
-        categoryExpressions.push(expression);
-      }
-    }
-
-    if (categoryExpressions.length === 0) {
-      return '';
-    }
-
-    // Unity test runner uses --testFilter with category expressions
-    // Multiple dimensions are AND'd by joining with ';'
-    const filterString = categoryExpressions.join(';');
-    return `--testFilter "${filterString}"`;
-  }
-
-  /**
-   * Build a filter expression for a single taxonomy dimension.
-   */
-  private static buildDimensionExpression(dimension: string, valueSpec: string): string {
-    if (!valueSpec || valueSpec.trim() === '') {
-      return '';
-    }
-
-    const trimmed = valueSpec.trim();
-
-    // Check if the value is a regex pattern: /pattern/
-    if (trimmed.startsWith('/') && trimmed.endsWith('/') && trimmed.length > 2) {
-      const pattern = trimmed.slice(1, -1);
-      return `${dimension}=~${pattern}`;
-    }
-
-    // Comma-separated values: OR'd together
-    const values = trimmed
-      .split(',')
-      .map((v) => v.trim())
-      .filter((v) => v.length > 0);
-
-    if (values.length === 0) {
-      return '';
-    }
-
-    if (values.length === 1) {
-      return `${dimension}=${values[0]}`;
-    }
-
-    // Multiple values: use pipe-separated OR syntax
-    return `${dimension}=${values.join('|')}`;
-  }
-
-  /**
-   * Check if a test's taxonomy metadata matches the given filter criteria.
-   *
-   * A test matches if ALL filter dimensions match (AND across dimensions).
-   * Within a single dimension, the test must match ANY of the specified values (OR).
-   * Regex patterns are matched as regular expressions.
-   * Hierarchical dot-notation supports prefix matching (e.g., filter "Combat.Melee"
-   * matches test category "Combat.Melee.Sword").
-   */
-  static matchesFilter(testCategories: Record<string, string>, filters: Record<string, string>): boolean {
-    for (const [dimension, valueSpec] of Object.entries(filters)) {
-      const testValue = testCategories[dimension];
-
-      // If the test has no value for this dimension, it does not match
-      if (testValue === undefined || testValue === null) {
-        return false;
-      }
-
-      if (!TaxonomyFilterService.matchesDimensionFilter(testValue, valueSpec)) {
-        return false;
-      }
-    }
-
-    return true;
-  }
-
-  /**
-   * Check if a single test category value matches a dimension filter spec.
-   */
-  private static matchesDimensionFilter(testValue: string, valueSpec: string): boolean {
-    const trimmed = valueSpec.trim();
-
-    // Regex pattern
-    if (trimmed.startsWith('/') && trimmed.endsWith('/') && trimmed.length > 2) {
-      const pattern = trimmed.slice(1, -1);
-      try {
-        const regex = new RegExp(pattern);
-        return regex.test(testValue);
-      } catch {
-        // Invalid regex, treat as literal
-        return testValue === trimmed;
-      }
-    }
-
-    // Comma-separated values
-    const values = trimmed
-      .split(',')
-      .map((v) => v.trim())
-      .filter((v) => v.length > 0);
-
-    return values.some((filterValue) => {
-      // Exact match
-      if (testValue === filterValue) {
-        return true;
-      }
-
-      // Hierarchical dot-notation prefix match
-      // Filter "Combat.Melee" matches test "Combat.Melee" and "Combat.Melee.Sword"
-      if (filterValue.includes('.') || testValue.includes('.')) {
-        if (testValue.startsWith(filterValue + '.') || testValue === filterValue) {
-          return true;
-        }
-        // Also allow the test to be a prefix of the filter for upward matching
-        if (filterValue.startsWith(testValue + '.')) {
-          return true;
-        }
-      }
-
-      return false;
-    });
-  }
-}

src/model/orchestrator/services/test-workflow/test-result-reporter.ts

@@ -1,316 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { TestResult, TestFailure } from './test-workflow-types';
-
-/**
- * Parses test result files (JUnit XML, Unity JSON) and generates structured
- * summary reports. Supports writing results in multiple formats for CI
- * integration (GitHub Checks, artifact upload).
- */
-export class TestResultReporter {
-  /**
-   * Parse a JUnit XML test result file into a TestResult.
-   * JUnit XML is the standard format produced by Unity's test runner.
-   */
-  static parseJUnitResults(xmlPath: string): TestResult {
-    if (!fs.existsSync(xmlPath)) {
-      throw new Error(`JUnit result file not found: ${xmlPath}`);
-    }
-
-    const content = fs.readFileSync(xmlPath, 'utf8');
-    return TestResultReporter.parseJUnitXml(content);
-  }
-
-  /**
-   * Parse JUnit XML content string into a TestResult.
-   */
-  static parseJUnitXml(xmlContent: string): TestResult {
-    // Extract the testsuite opening tag
-    const suiteTagMatch = xmlContent.match(/<testsuite\s[^>]*>/);
-
-    let runName = 'unknown';
-    let totalTests = 0;
-    let failureCount = 0;
-    let skippedCount = 0;
-    let duration = 0;
-
-    if (suiteTagMatch) {
-      const tag = suiteTagMatch[0];
-
-      // Extract individual attributes -- order-independent
-      const nameMatch = tag.match(/\sname="([^"]*)"/);
-      const testsMatch = tag.match(/\stests="(\d+)"/);
-      const failuresMatch = tag.match(/\sfailures="(\d+)"/);
-      const skippedMatch = tag.match(/\sskipped="(\d+)"/);
-      const timeMatch = tag.match(/\stime="([^"]*)"/);
-
-      runName = nameMatch ? nameMatch[1] : 'unknown';
-      totalTests = testsMatch ? Number.parseInt(testsMatch[1], 10) : 0;
-      failureCount = failuresMatch ? Number.parseInt(failuresMatch[1], 10) : 0;
-      skippedCount = skippedMatch ? Number.parseInt(skippedMatch[1], 10) : 0;
-      duration = timeMatch ? Number.parseFloat(timeMatch[1]) : 0;
-    }
-
-    // Extract individual test failures by splitting into testcase blocks
-    const failures: TestFailure[] = [];
-    const testcasePattern = /<testcase\s[^>]*>[\s\S]*?<\/testcase>/g;
-
-    let tcMatch;
-    while ((tcMatch = testcasePattern.exec(xmlContent)) !== null) {
-      const block = tcMatch[0];
-
-      // Only process testcases that contain a <failure> element
-      if (!block.includes('<failure')) {
-        continue;
-      }
-
-      // Extract testcase attributes (order-independent)
-      const tcTag = block.match(/<testcase\s[^>]*>/);
-      if (!tcTag) continue;
-
-      const cnMatch = tcTag[0].match(/\sclassname="([^"]*)"/);
-      const tnMatch = tcTag[0].match(/\sname="([^"]*)"/);
-
-      const className = cnMatch ? cnMatch[1] : 'unknown';
-      const testName = tnMatch ? tnMatch[1] : 'unknown';
-
-      // Extract failure message
-      const failTag = block.match(/<failure\s[^>]*>/);
-      const msgMatch = failTag ? failTag[0].match(/\smessage="([^"]*)"/) : null;
-      const message = msgMatch ? msgMatch[1] : 'Test failed';
-
-      // Extract stack trace from CDATA or text content
-      const cdataMatch = block.match(/<failure[^>]*>[\s\S]*?<!\[CDATA\[([\s\S]*?)\]\]>/);
-      const textMatch = !cdataMatch ? block.match(/<failure[^>]*>([^<]*)<\/failure>/) : null;
-      const stackTrace = cdataMatch ? cdataMatch[1].trim() : textMatch ? textMatch[1].trim() : undefined;
-
-      failures.push({ testName, className, message, stackTrace: stackTrace || undefined });
-    }
-
-    const passed = totalTests - failureCount - skippedCount;
-
-    return {
-      runName,
-      passed: Math.max(0, passed),
-      failed: failureCount,
-      skipped: skippedCount,
-      duration,
-      failures,
-    };
-  }
-
-  /**
-   * Parse a Unity JSON test result file into a TestResult.
-   */
-  static parseJsonResults(jsonPath: string): TestResult {
-    if (!fs.existsSync(jsonPath)) {
-      throw new Error(`JSON result file not found: ${jsonPath}`);
-    }
-
-    const content = fs.readFileSync(jsonPath, 'utf8');
-    const data = JSON.parse(content);
-
-    return TestResultReporter.parseJsonData(data);
-  }
-
-  /**
-   * Parse Unity JSON test result data into a TestResult.
-   */
-  static parseJsonData(data: any): TestResult {
-    const runName = data.name ?? data.suiteName ?? 'unknown';
-    const passed = data.passed ?? data.passCount ?? 0;
-    const failed = data.failed ?? data.failCount ?? 0;
-    const skipped = data.skipped ?? data.skipCount ?? data.inconclusive ?? 0;
-    const duration = data.duration ?? data.time ?? 0;
-
-    const failures: TestFailure[] = [];
-
-    // Unity test results may have a 'testResults' or 'results' array
-    const results = data.testResults ?? data.results ?? data.children ?? [];
-
-    if (Array.isArray(results)) {
-      for (const result of results) {
-        TestResultReporter.extractFailures(result, failures);
-      }
-    }
-
-    return {
-      runName,
-      passed,
-      failed,
-      skipped,
-      duration,
-      failures,
-    };
-  }
-
-  /**
-   * Recursively extract failures from nested Unity test result JSON.
-   */
-  private static extractFailures(node: any, failures: TestFailure[]): void {
-    if (!node) return;
-
-    const status = (node.result ?? node.status ?? '').toLowerCase();
-    if (status === 'failed' || status === 'failure') {
-      failures.push({
-        testName: node.name ?? node.testName ?? 'unknown',
-        className: node.className ?? node.fullName ?? node.name ?? 'unknown',
-        message: node.message ?? node.output ?? 'Test failed',
-        stackTrace: node.stackTrace ?? node.trace ?? undefined,
-      });
-    }
-
-    // Recurse into children (Unity nests test fixtures inside suites)
-    const children = node.children ?? node.testResults ?? node.results ?? [];
-    if (Array.isArray(children)) {
-      for (const child of children) {
-        TestResultReporter.extractFailures(child, failures);
-      }
-    }
-  }
-
-  /**
-   * Generate a markdown summary table from an array of test results.
-   */
-  static generateSummary(results: TestResult[]): string {
-    if (results.length === 0) {
-      return 'No test results available.';
-    }
-
-    const lines: string[] = [];
-    lines.push('## Test Results Summary');
-    lines.push('');
-    lines.push('| Run | Passed | Failed | Skipped | Duration |');
-    lines.push('|-----|--------|--------|---------|----------|');
-
-    let totalPassed = 0;
-    let totalFailed = 0;
-    let totalSkipped = 0;
-    let totalDuration = 0;
-
-    for (const result of results) {
-      const status = result.failed > 0 ? 'X' : 'OK';
-      const durationStr = TestResultReporter.formatDuration(result.duration);
-      lines.push(
-        `| ${status} ${result.runName} | ${result.passed} | ${result.failed} | ${result.skipped} | ${durationStr} |`,
-      );
-      totalPassed += result.passed;
-      totalFailed += result.failed;
-      totalSkipped += result.skipped;
-      totalDuration += result.duration;
-    }
-
-    lines.push(
-      `| **Total** | **${totalPassed}** | **${totalFailed}** | **${totalSkipped}** | **${TestResultReporter.formatDuration(
-        totalDuration,
-      )}** |`,
-    );
-    lines.push('');
-
-    // Append failure details if any
-    const allFailures = results.flatMap((r) => r.failures.map((f) => ({ ...f, run: r.runName })));
-    if (allFailures.length > 0) {
-      lines.push('### Failures');
-      lines.push('');
-      for (const failure of allFailures) {
-        lines.push(`**${failure.run}** - \`${failure.className}.${failure.testName}\``);
-        lines.push(`> ${failure.message}`);
-        if (failure.stackTrace) {
-          lines.push('```');
-          lines.push(failure.stackTrace.slice(0, 500));
-          lines.push('```');
-        }
-        lines.push('');
-      }
-    }
-
-    return lines.join('\n');
-  }
-
-  /**
-   * Write test results to the output path in the specified format(s).
-   */
-  static writeResults(results: TestResult[], outputPath: string, format: 'junit' | 'json' | 'both'): void {
-    if (!fs.existsSync(outputPath)) {
-      fs.mkdirSync(outputPath, { recursive: true });
-    }
-
-    if (format === 'json' || format === 'both') {
-      const jsonPath = path.join(outputPath, 'test-results.json');
-      fs.writeFileSync(jsonPath, JSON.stringify(results, null, 2), 'utf8');
-    }
-
-    if (format === 'junit' || format === 'both') {
-      const junitPath = path.join(outputPath, 'test-results.xml');
-      const xml = TestResultReporter.toJUnitXml(results);
-      fs.writeFileSync(junitPath, xml, 'utf8');
-    }
-
-    // Always write markdown summary
-    const summaryPath = path.join(outputPath, 'test-summary.md');
-    const summary = TestResultReporter.generateSummary(results);
-    fs.writeFileSync(summaryPath, summary, 'utf8');
-  }
-
-  /**
-   * Convert TestResult array to JUnit XML format.
-   */
-  private static toJUnitXml(results: TestResult[]): string {
-    const lines: string[] = [];
-    lines.push('<?xml version="1.0" encoding="UTF-8"?>');
-    lines.push('<testsuites>');
-
-    for (const result of results) {
-      const total = result.passed + result.failed + result.skipped;
-      lines.push(
-        `  <testsuite name="${TestResultReporter.escapeXml(result.runName)}" tests="${total}" failures="${
-          result.failed
-        }" skipped="${result.skipped}" time="${result.duration.toFixed(3)}">`,
-      );
-
-      // Write failure test cases
-      for (const failure of result.failures) {
-        lines.push(
-          `    <testcase classname="${TestResultReporter.escapeXml(
-            failure.className,
-          )}" name="${TestResultReporter.escapeXml(failure.testName)}">`,
-        );
-        lines.push(`      <failure message="${TestResultReporter.escapeXml(failure.message)}">`);
-        if (failure.stackTrace) {
-          lines.push(`        <![CDATA[${failure.stackTrace}]]>`);
-        }
-        lines.push('      </failure>');
-        lines.push('    </testcase>');
-      }
-
-      lines.push('  </testsuite>');
-    }
-
-    lines.push('</testsuites>');
-    return lines.join('\n');
-  }
-
-  /**
-   * Escape special XML characters.
-   */
-  private static escapeXml(str: string): string {
-    return str
-      .replace(/&/g, '&amp;')
-      .replace(/</g, '&lt;')
-      .replace(/>/g, '&gt;')
-      .replace(/"/g, '&quot;')
-      .replace(/'/g, '&apos;');
-  }
-
-  /**
-   * Format a duration in seconds to a human-readable string.
-   */
-  private static formatDuration(seconds: number): string {
-    if (seconds < 60) {
-      return `${seconds.toFixed(1)}s`;
-    }
-    const minutes = Math.floor(seconds / 60);
-    const remainingSeconds = seconds % 60;
-    return `${minutes}m ${remainingSeconds.toFixed(0)}s`;
-  }
-}

src/model/orchestrator/services/test-workflow/test-suite-parser.ts

@@ -1,263 +0,0 @@
-import fs from 'node:fs';
-import YAML from 'yaml';
-import { TestSuiteDefinition, TestRunDefinition } from './test-workflow-types';
-
-/**
- * Parses and validates YAML-based test suite definition files.
- * Handles dependency resolution (topological sort) for ordered test run execution.
- */
-export class TestSuiteParser {
-  /**
-   * Read and parse a YAML test suite definition file.
-   * Validates the structure and returns a typed TestSuiteDefinition.
-   */
-  static parseSuiteFile(filePath: string): TestSuiteDefinition {
-    if (!fs.existsSync(filePath)) {
-      throw new Error(`Test suite file not found: ${filePath}`);
-    }
-
-    const content = fs.readFileSync(filePath, 'utf8');
-    const parsed = YAML.parse(content);
-
-    if (!parsed || typeof parsed !== 'object') {
-      throw new Error(`Invalid YAML in test suite file: ${filePath}`);
-    }
-
-    if (!parsed.name || typeof parsed.name !== 'string') {
-      throw new Error(`Test suite must have a 'name' field (string): ${filePath}`);
-    }
-
-    if (!Array.isArray(parsed.runs) || parsed.runs.length === 0) {
-      throw new Error(`Test suite must have a non-empty 'runs' array: ${filePath}`);
-    }
-
-    const suite: TestSuiteDefinition = {
-      name: parsed.name,
-      description: parsed.description,
-      runs: parsed.runs.map((run: any) => TestSuiteParser.parseRun(run)),
-    };
-
-    const errors = TestSuiteParser.validateSuite(suite);
-    if (errors.length > 0) {
-      throw new Error(`Test suite validation failed:\n  ${errors.join('\n  ')}`);
-    }
-
-    return suite;
-  }
-
-  /**
-   * Parse a single run definition from raw YAML data.
-   */
-  private static parseRun(raw: any): TestRunDefinition {
-    if (!raw || typeof raw !== 'object') {
-      throw new Error(`Each run must be an object`);
-    }
-
-    if (!raw.name || typeof raw.name !== 'string') {
-      throw new Error(`Each run must have a 'name' field (string)`);
-    }
-
-    const run: TestRunDefinition = {
-      name: raw.name,
-    };
-
-    if (raw.needs !== undefined) {
-      if (!Array.isArray(raw.needs)) {
-        throw new Error(`Run '${raw.name}': 'needs' must be an array of strings`);
-      }
-      run.needs = raw.needs;
-    }
-
-    if (raw.editMode !== undefined) {
-      run.editMode = Boolean(raw.editMode);
-    }
-
-    if (raw.playMode !== undefined) {
-      run.playMode = Boolean(raw.playMode);
-    }
-
-    if (raw.builtClient !== undefined) {
-      run.builtClient = Boolean(raw.builtClient);
-    }
-
-    if (raw.builtClientPath !== undefined) {
-      run.builtClientPath = String(raw.builtClientPath);
-    }
-
-    if (raw.filters !== undefined) {
-      if (typeof raw.filters !== 'object' || Array.isArray(raw.filters)) {
-        throw new Error(`Run '${raw.name}': 'filters' must be a key-value object`);
-      }
-      run.filters = {};
-      for (const [key, value] of Object.entries(raw.filters)) {
-        run.filters[key] = String(value);
-      }
-    }
-
-    if (raw.timeout !== undefined) {
-      const timeout = Number(raw.timeout);
-      if (Number.isNaN(timeout) || timeout <= 0) {
-        throw new Error(`Run '${raw.name}': 'timeout' must be a positive number`);
-      }
-      run.timeout = timeout;
-    }
-
-    return run;
-  }
-
-  /**
-   * Resolve run execution order via topological sort based on 'needs' dependencies.
-   * Returns an array of parallel groups -- each group contains runs that can execute concurrently.
-   * Runs within the same group have no inter-dependencies.
-   */
-  static resolveRunOrder(suite: TestSuiteDefinition): TestRunDefinition[][] {
-    const runMap = new Map<string, TestRunDefinition>();
-    for (const run of suite.runs) {
-      runMap.set(run.name, run);
-    }
-
-    // Build adjacency: inDegree counts and dependents map
-    const inDegree = new Map<string, number>();
-    const dependents = new Map<string, string[]>();
-
-    for (const run of suite.runs) {
-      if (!inDegree.has(run.name)) {
-        inDegree.set(run.name, 0);
-      }
-      if (!dependents.has(run.name)) {
-        dependents.set(run.name, []);
-      }
-
-      if (run.needs) {
-        for (const dep of run.needs) {
-          inDegree.set(run.name, (inDegree.get(run.name) ?? 0) + 1);
-          if (!dependents.has(dep)) {
-            dependents.set(dep, []);
-          }
-          dependents.get(dep)!.push(run.name);
-        }
-      }
-    }
-
-    // Kahn's algorithm producing parallel layers
-    const groups: TestRunDefinition[][] = [];
-    let ready = suite.runs.filter((r) => (inDegree.get(r.name) ?? 0) === 0);
-    let processed = 0;
-
-    while (ready.length > 0) {
-      groups.push(ready);
-      processed += ready.length;
-
-      const nextReady: TestRunDefinition[] = [];
-      for (const run of ready) {
-        for (const dep of dependents.get(run.name) ?? []) {
-          const newDegree = (inDegree.get(dep) ?? 1) - 1;
-          inDegree.set(dep, newDegree);
-          if (newDegree === 0) {
-            nextReady.push(runMap.get(dep)!);
-          }
-        }
-      }
-      ready = nextReady;
-    }
-
-    if (processed !== suite.runs.length) {
-      throw new Error(`Circular dependency detected in test suite '${suite.name}'`);
-    }
-
-    return groups;
-  }
-
-  /**
-   * Validate a parsed test suite definition.
-   * Returns an array of validation error messages (empty = valid).
-   */
-  static validateSuite(suite: TestSuiteDefinition): string[] {
-    const errors: string[] = [];
-    const runNames = new Set<string>();
-
-    // Check for duplicate run names
-    for (const run of suite.runs) {
-      if (runNames.has(run.name)) {
-        errors.push(`Duplicate run name: '${run.name}'`);
-      }
-      runNames.add(run.name);
-    }
-
-    // Check that all 'needs' references exist
-    for (const run of suite.runs) {
-      if (run.needs) {
-        for (const dep of run.needs) {
-          if (!runNames.has(dep)) {
-            errors.push(`Run '${run.name}' depends on unknown run '${dep}'`);
-          }
-        }
-
-        // Self-dependency
-        if (run.needs.includes(run.name)) {
-          errors.push(`Run '${run.name}' depends on itself`);
-        }
-      }
-    }
-
-    // Check that at least one test mode is specified per run
-    for (const run of suite.runs) {
-      if (!run.editMode && !run.playMode && !run.builtClient) {
-        errors.push(`Run '${run.name}' must specify at least one of: editMode, playMode, builtClient`);
-      }
-    }
-
-    // Detect circular dependencies via DFS
-    const circularError = TestSuiteParser.detectCircularDependencies(suite);
-    if (circularError) {
-      errors.push(circularError);
-    }
-
-    return errors;
-  }
-
-  /**
-   * Detect circular dependencies using DFS cycle detection.
-   */
-  private static detectCircularDependencies(suite: TestSuiteDefinition): string | null {
-    const adjacency = new Map<string, string[]>();
-    for (const run of suite.runs) {
-      adjacency.set(run.name, run.needs ?? []);
-    }
-
-    const visited = new Set<string>();
-    const visiting = new Set<string>();
-
-    const dfs = (node: string, path: string[]): string | null => {
-      if (visiting.has(node)) {
-        const cycleStart = path.indexOf(node);
-        const cycle = path.slice(cycleStart).concat(node);
-        return `Circular dependency: ${cycle.join(' -> ')}`;
-      }
-      if (visited.has(node)) {
-        return null;
-      }
-
-      visiting.add(node);
-      path.push(node);
-
-      for (const dep of adjacency.get(node) ?? []) {
-        if (adjacency.has(dep)) {
-          const result = dfs(dep, [...path]);
-          if (result) return result;
-        }
-      }
-
-      visiting.delete(node);
-      visited.add(node);
-      return null;
-    };
-
-    for (const run of suite.runs) {
-      const result = dfs(run.name, []);
-      if (result) return result;
-    }
-
-    return null;
-  }
-}

src/model/orchestrator/services/test-workflow/test-workflow-service.ts

@@ -1,246 +0,0 @@
-import { exec } from 'node:child_process';
-import { promisify } from 'node:util';
-import path from 'node:path';
-import * as core from '@actions/core';
-import BuildParameters from '../../../build-parameters';
-import { TestSuiteParser } from './test-suite-parser';
-import { TaxonomyFilterService } from './taxonomy-filter-service';
-import { TestResultReporter } from './test-result-reporter';
-import { TestRunDefinition, TestResult } from './test-workflow-types';
-
-const execAsync = promisify(exec);
-
-/**
- * Main entry point for the test workflow engine.
- * Orchestrates parsing of YAML suite definitions, resolving run order,
- * executing test runs via Unity CLI, and collecting structured results.
- */
-export class TestWorkflowService {
-  /**
-   * Execute a full test suite from a YAML definition file.
-   * Parses the suite, resolves dependency order, executes each parallel
-   * group sequentially (runs within a group execute concurrently), and
-   * collects all results.
-   */
-  static async executeTestSuite(suitePath: string, parameters: BuildParameters): Promise<TestResult[]> {
-    core.info(`[TestWorkflow] Loading test suite from: ${suitePath}`);
-
-    const suite = TestSuiteParser.parseSuiteFile(suitePath);
-    core.info(`[TestWorkflow] Suite '${suite.name}' loaded with ${suite.runs.length} run(s)`);
-
-    if (suite.description) {
-      core.info(`[TestWorkflow] Description: ${suite.description}`);
-    }
-
-    const groups = TestSuiteParser.resolveRunOrder(suite);
-    core.info(`[TestWorkflow] Resolved into ${groups.length} execution group(s)`);
-
-    const allResults: TestResult[] = [];
-    let groupIndex = 0;
-
-    for (const group of groups) {
-      groupIndex++;
-      const runNames = group.map((r) => r.name).join(', ');
-      core.info(`[TestWorkflow] Executing group ${groupIndex}/${groups.length}: [${runNames}]`);
-
-      // Execute runs within a group concurrently
-      const groupResults = await Promise.all(group.map((run) => TestWorkflowService.executeTestRun(run, parameters)));
-
-      allResults.push(...groupResults);
-
-      // Check for failures -- if any run in this group failed, log a warning
-      // but continue to the next group (fail-forward for maximum feedback)
-      const failedRuns = groupResults.filter((r) => r.failed > 0);
-      if (failedRuns.length > 0) {
-        const failedNames = failedRuns.map((r) => r.runName).join(', ');
-        core.warning(`[TestWorkflow] Failures detected in group ${groupIndex}: [${failedNames}]`);
-      }
-    }
-
-    // Generate and output summary
-    const summary = TestResultReporter.generateSummary(allResults);
-    core.info(summary);
-
-    // Write results if output path is configured
-    const resultPath = parameters.testResultPath;
-    const resultFormat = parameters.testResultFormat;
-    if (resultPath) {
-      TestResultReporter.writeResults(allResults, resultPath, resultFormat as 'junit' | 'json' | 'both');
-      core.info(`[TestWorkflow] Results written to: ${resultPath}`);
-    }
-
-    return allResults;
-  }
-
-  /**
-   * Execute a single test run definition.
-   * Builds the Unity CLI arguments based on the run configuration (edit mode,
-   * play mode, built client) and taxonomy filters, executes the command
-   * asynchronously, and parses the result output.
-   *
-   * Uses promisified exec instead of execSync so that Promise.all can
-   * actually run multiple test groups in parallel without blocking the
-   * Node.js event loop.
-   */
-  static async executeTestRun(run: TestRunDefinition, parameters: BuildParameters): Promise<TestResult> {
-    core.info(`[TestWorkflow] Starting run: '${run.name}'`);
-
-    const unityArguments = TestWorkflowService.buildUnityArgs(run, parameters);
-    const timeoutMs = (run.timeout ?? 600) * 1000;
-
-    core.info(`[TestWorkflow] Unity args: ${unityArguments}`);
-
-    const startTime = Date.now();
-
-    try {
-      const resultDirectory = path.join(parameters.testResultPath ?? './test-results', run.name);
-      const resultFile = path.join(resultDirectory, 'results.xml');
-
-      // Build the full Unity command
-      const unityPath = TestWorkflowService.resolveUnityPath(parameters);
-      const command = `"${unityPath}" ${unityArguments} -testResults "${resultFile}"`;
-
-      core.info(`[TestWorkflow] Executing: ${command}`);
-
-      await execAsync(command, {
-        timeout: timeoutMs,
-        maxBuffer: 50 * 1024 * 1024, // 50 MB to handle large Unity output
-        cwd: parameters.projectPath || process.cwd(),
-      });
-
-      const duration = (Date.now() - startTime) / 1000;
-
-      // Parse the result file
-      try {
-        const result = TestResultReporter.parseJUnitResults(resultFile);
-        result.runName = run.name;
-        result.duration = duration;
-
-        return result;
-      } catch {
-        // Result file may not exist if Unity exited early
-        core.warning(`[TestWorkflow] Could not parse results for run '${run.name}' -- result file may be missing`);
-
-        return {
-          runName: run.name,
-          passed: 0,
-          failed: 0,
-          skipped: 0,
-          duration,
-          failures: [],
-        };
-      }
-    } catch (error: any) {
-      const duration = (Date.now() - startTime) / 1000;
-
-      // The promisified exec sets error.killed when the process is terminated
-      // due to timeout, and error.signal will be 'SIGTERM'
-      const isTimeout = error.killed === true || error.signal === 'SIGTERM';
-
-      if (isTimeout) {
-        core.error(`[TestWorkflow] Run '${run.name}' timed out after ${run.timeout ?? 600}s`);
-      } else {
-        core.error(`[TestWorkflow] Run '${run.name}' failed: ${error.message}`);
-      }
-
-      // Try to parse partial results even on failure
-      const resultDirectory = path.join(parameters.testResultPath ?? './test-results', run.name);
-      const resultFile = path.join(resultDirectory, 'results.xml');
-
-      try {
-        const result = TestResultReporter.parseJUnitResults(resultFile);
-        result.runName = run.name;
-        result.duration = duration;
-
-        return result;
-      } catch {
-        return {
-          runName: run.name,
-          passed: 0,
-          failed: 1,
-          skipped: 0,
-          duration,
-          failures: [
-            {
-              testName: isTimeout ? 'Timeout' : 'ExecutionError',
-              className: run.name,
-              message: isTimeout
-                ? `Test run timed out after ${run.timeout ?? 600}s`
-                : error.message ?? 'Unknown execution error',
-              stackTrace: error.stderr ?? undefined,
-            },
-          ],
-        };
-      }
-    }
-  }
-
-  /**
-   * Build Unity CLI arguments for a test run based on its configuration.
-   */
-  static buildUnityArgs(run: TestRunDefinition, parameters: BuildParameters): string {
-    const unityArguments: string[] = ['-batchmode', '-nographics'];
-
-    // Project path
-    if (parameters.projectPath) {
-      unityArguments.push(`-projectPath "${parameters.projectPath}"`);
-    }
-
-    // Test mode
-    if (run.builtClient && run.builtClientPath) {
-      // Built client testing: run tests against a built player
-      unityArguments.push(
-        '-runTests',
-        `-testPlatform StandalonePlayer`,
-        `-assemblyNames Assembly-CSharp-Tests`,
-        `-builtPlayerPath "${run.builtClientPath}"`,
-      );
-    } else if (run.editMode && run.playMode) {
-      // Both modes: run EditMode first, then PlayMode will require a separate invocation
-      // For combined mode, use EditMode (the service handles sequencing)
-      unityArguments.push('-runTests', '-testPlatform EditMode');
-    } else if (run.playMode) {
-      unityArguments.push('-runTests', '-testPlatform PlayMode');
-    } else if (run.editMode) {
-      unityArguments.push('-runTests', '-testPlatform EditMode');
-    }
-
-    // Apply taxonomy filters
-    if (run.filters && Object.keys(run.filters).length > 0) {
-      const filterArguments = TaxonomyFilterService.buildFilterArgs(run.filters);
-      if (filterArguments) {
-        unityArguments.push(filterArguments);
-      }
-    }
-
-    // Target platform
-    if (parameters.targetPlatform) {
-      unityArguments.push(`-buildTarget ${parameters.targetPlatform}`);
-    }
-
-    return unityArguments.join(' ');
-  }
-
-  /**
-   * Resolve the path to the Unity editor executable.
-   */
-  private static resolveUnityPath(parameters: BuildParameters): string {
-    // In CI, Unity path is typically set via environment or the docker container
-    const environmentUnityPath = process.env.UNITY_PATH ?? process.env.UNITY_EDITOR;
-    if (environmentUnityPath) {
-      return environmentUnityPath;
-    }
-
-    // Default paths by platform
-    if (process.platform === 'win32') {
-      return `C:/Program Files/Unity/Hub/Editor/${parameters.editorVersion}/Editor/Unity.exe`;
-    }
-
-    if (process.platform === 'darwin') {
-      return `/Applications/Unity/Hub/Editor/${parameters.editorVersion}/Unity.app/Contents/MacOS/Unity`;
-    }
-
-    // Linux default (Docker container path)
-    return '/opt/unity/Editor/Unity';
-  }
-}

src/model/orchestrator/services/test-workflow/test-workflow-types.ts

@@ -1,41 +0,0 @@
-export interface TestSuiteDefinition {
-  name: string;
-  description?: string;
-  runs: TestRunDefinition[];
-}
-
-export interface TestRunDefinition {
-  name: string;
-  needs?: string[];
-  editMode?: boolean;
-  playMode?: boolean;
-  builtClient?: boolean;
-  builtClientPath?: string;
-  filters?: Record<string, string>; // dimension -> comma-separated values or /regex/
-  timeout?: number;
-}
-
-export interface TaxonomyDimension {
-  name: string;
-  values: string[];
-}
-
-export interface TaxonomyDefinition {
-  extensible_groups: TaxonomyDimension[];
-}
-
-export interface TestResult {
-  runName: string;
-  passed: number;
-  failed: number;
-  skipped: number;
-  duration: number;
-  failures: TestFailure[];
-}
-
-export interface TestFailure {
-  testName: string;
-  className: string;
-  message: string;
-  stackTrace?: string;
-}

src/model/orchestrator/services/test-workflow/test-workflow.test.ts

@@ -1,562 +0,0 @@
-import fs from 'node:fs';
-import { TestSuiteParser } from './test-suite-parser';
-import { TaxonomyFilterService } from './taxonomy-filter-service';
-import { TestResultReporter } from './test-result-reporter';
-import { TestWorkflowService } from './test-workflow-service';
-import { TestSuiteDefinition, TestResult, TestRunDefinition } from './test-workflow-types';
-
-jest.mock('node:fs');
-jest.mock('@actions/core');
-
-const mockFs = fs as jest.Mocked<typeof fs>;
-
-afterEach(() => {
-  jest.clearAllMocks();
-});
-
-// ============================================================================
-// Test Suite Parser
-// ============================================================================
-
-describe('TestSuiteParser', () => {
-  describe('parseSuiteFile', () => {
-    it('should parse a valid YAML suite file', () => {
-      const yaml = `
-name: pull-request
-description: Fast feedback for pull requests
-runs:
-  - name: fast
-    editMode: true
-    filters:
-      Maturity: Trusted
-      FeedbackSpeed: Fast,Moderate
-    timeout: 300
-  - name: basic
-    needs: [fast]
-    editMode: true
-    playMode: true
-    filters:
-      Maturity: Trusted,Adolescent
-    timeout: 600
-`;
-      mockFs.existsSync.mockReturnValue(true);
-      mockFs.readFileSync.mockReturnValue(yaml);
-
-      const suite = TestSuiteParser.parseSuiteFile('/path/to/suite.yml');
-
-      expect(suite.name).toBe('pull-request');
-      expect(suite.description).toBe('Fast feedback for pull requests');
-      expect(suite.runs).toHaveLength(2);
-      expect(suite.runs[0].name).toBe('fast');
-      expect(suite.runs[0].editMode).toBe(true);
-      expect(suite.runs[0].filters?.Maturity).toBe('Trusted');
-      expect(suite.runs[0].timeout).toBe(300);
-      expect(suite.runs[1].needs).toEqual(['fast']);
-    });
-
-    it('should throw when file does not exist', () => {
-      mockFs.existsSync.mockReturnValue(false);
-
-      expect(() => TestSuiteParser.parseSuiteFile('/missing.yml')).toThrow('not found');
-    });
-
-    it('should throw on invalid YAML', () => {
-      mockFs.existsSync.mockReturnValue(true);
-      mockFs.readFileSync.mockReturnValue('not: valid: yaml: [');
-
-      expect(() => TestSuiteParser.parseSuiteFile('/bad.yml')).toThrow();
-    });
-
-    it('should throw when suite has no name', () => {
-      mockFs.existsSync.mockReturnValue(true);
-      mockFs.readFileSync.mockReturnValue('runs:\n  - name: test\n    editMode: true');
-
-      expect(() => TestSuiteParser.parseSuiteFile('/no-name.yml')).toThrow("'name'");
-    });
-
-    it('should throw when suite has no runs', () => {
-      mockFs.existsSync.mockReturnValue(true);
-      mockFs.readFileSync.mockReturnValue('name: test');
-
-      expect(() => TestSuiteParser.parseSuiteFile('/no-runs.yml')).toThrow("'runs'");
-    });
-
-    it('should throw on invalid needs reference', () => {
-      const yaml = `
-name: bad-deps
-runs:
-  - name: first
-    editMode: true
-    needs: [nonexistent]
-`;
-      mockFs.existsSync.mockReturnValue(true);
-      mockFs.readFileSync.mockReturnValue(yaml);
-
-      expect(() => TestSuiteParser.parseSuiteFile('/bad-deps.yml')).toThrow("unknown run 'nonexistent'");
-    });
-  });
-
-  describe('resolveRunOrder', () => {
-    it('should return single group when no dependencies exist', () => {
-      const suite: TestSuiteDefinition = {
-        name: 'test',
-        runs: [
-          { name: 'a', editMode: true },
-          { name: 'b', playMode: true },
-        ],
-      };
-
-      const groups = TestSuiteParser.resolveRunOrder(suite);
-      expect(groups).toHaveLength(1);
-      expect(groups[0]).toHaveLength(2);
-    });
-
-    it('should resolve linear dependencies into sequential groups', () => {
-      const suite: TestSuiteDefinition = {
-        name: 'test',
-        runs: [
-          { name: 'a', editMode: true },
-          { name: 'b', needs: ['a'], playMode: true },
-          { name: 'c', needs: ['b'], editMode: true },
-        ],
-      };
-
-      const groups = TestSuiteParser.resolveRunOrder(suite);
-      expect(groups).toHaveLength(3);
-      expect(groups[0][0].name).toBe('a');
-      expect(groups[1][0].name).toBe('b');
-      expect(groups[2][0].name).toBe('c');
-    });
-
-    it('should place independent runs in the same group', () => {
-      const suite: TestSuiteDefinition = {
-        name: 'test',
-        runs: [
-          { name: 'root', editMode: true },
-          { name: 'branch-a', needs: ['root'], playMode: true },
-          { name: 'branch-b', needs: ['root'], editMode: true },
-        ],
-      };
-
-      const groups = TestSuiteParser.resolveRunOrder(suite);
-      expect(groups).toHaveLength(2);
-      expect(groups[0]).toHaveLength(1);
-      expect(groups[1]).toHaveLength(2);
-    });
-
-    it('should detect circular dependencies', () => {
-      const suite: TestSuiteDefinition = {
-        name: 'circular',
-        runs: [
-          { name: 'a', needs: ['b'], editMode: true },
-          { name: 'b', needs: ['a'], playMode: true },
-        ],
-      };
-
-      expect(() => TestSuiteParser.resolveRunOrder(suite)).toThrow('Circular dependency');
-    });
-
-    it('should detect three-way circular dependencies', () => {
-      const suite: TestSuiteDefinition = {
-        name: 'circular3',
-        runs: [
-          { name: 'a', needs: ['c'], editMode: true },
-          { name: 'b', needs: ['a'], playMode: true },
-          { name: 'c', needs: ['b'], editMode: true },
-        ],
-      };
-
-      expect(() => TestSuiteParser.resolveRunOrder(suite)).toThrow('Circular dependency');
-    });
-  });
-
-  describe('validateSuite', () => {
-    it('should return no errors for a valid suite', () => {
-      const suite: TestSuiteDefinition = {
-        name: 'valid',
-        runs: [
-          { name: 'a', editMode: true },
-          { name: 'b', needs: ['a'], playMode: true },
-        ],
-      };
-
-      const errors = TestSuiteParser.validateSuite(suite);
-      expect(errors).toHaveLength(0);
-    });
-
-    it('should detect duplicate run names', () => {
-      const suite: TestSuiteDefinition = {
-        name: 'dupes',
-        runs: [
-          { name: 'a', editMode: true },
-          { name: 'a', playMode: true },
-        ],
-      };
-
-      const errors = TestSuiteParser.validateSuite(suite);
-      expect(errors.some((e) => e.includes('Duplicate'))).toBe(true);
-    });
-
-    it('should detect missing test mode', () => {
-      const suite: TestSuiteDefinition = {
-        name: 'no-mode',
-        runs: [{ name: 'empty' }],
-      };
-
-      const errors = TestSuiteParser.validateSuite(suite);
-      expect(errors.some((e) => e.includes('editMode'))).toBe(true);
-    });
-
-    it('should detect self-dependency', () => {
-      const suite: TestSuiteDefinition = {
-        name: 'self-dep',
-        runs: [{ name: 'a', needs: ['a'], editMode: true }],
-      };
-
-      const errors = TestSuiteParser.validateSuite(suite);
-      expect(errors.some((e) => e.includes('depends on itself'))).toBe(true);
-    });
-  });
-});
-
-// ============================================================================
-// Taxonomy Filter Service
-// ============================================================================
-
-describe('TaxonomyFilterService', () => {
-  describe('loadTaxonomy', () => {
-    it('should return built-in dimensions when no file provided', () => {
-      const dimensions = TaxonomyFilterService.loadTaxonomy();
-
-      expect(dimensions.length).toBeGreaterThanOrEqual(7);
-      expect(dimensions.find((d) => d.name === 'Scope')).toBeDefined();
-      expect(dimensions.find((d) => d.name === 'Maturity')).toBeDefined();
-      expect(dimensions.find((d) => d.name === 'FeedbackSpeed')).toBeDefined();
-      expect(dimensions.find((d) => d.name === 'Execution')).toBeDefined();
-      expect(dimensions.find((d) => d.name === 'Rigor')).toBeDefined();
-      expect(dimensions.find((d) => d.name === 'Determinism')).toBeDefined();
-      expect(dimensions.find((d) => d.name === 'IsolationLevel')).toBeDefined();
-    });
-
-    it('should merge custom dimensions from file', () => {
-      const yaml = `
-extensible_groups:
-  - name: SubjectLevel
-    values: [Class, Feature, System, Product]
-  - name: DataScenario
-    values: [HappyPath, EdgeCase]
-`;
-      mockFs.existsSync.mockReturnValue(true);
-      mockFs.readFileSync.mockReturnValue(yaml);
-
-      const dimensions = TaxonomyFilterService.loadTaxonomy('/taxonomy.yml');
-
-      expect(dimensions.find((d) => d.name === 'SubjectLevel')).toBeDefined();
-      expect(dimensions.find((d) => d.name === 'DataScenario')).toBeDefined();
-      // Built-ins should still exist
-      expect(dimensions.find((d) => d.name === 'Scope')).toBeDefined();
-    });
-
-    it('should merge values for existing dimensions', () => {
-      const yaml = `
-extensible_groups:
-  - name: Scope
-    values: [Unit, Integration, Acceptance]
-`;
-      mockFs.existsSync.mockReturnValue(true);
-      mockFs.readFileSync.mockReturnValue(yaml);
-
-      const dimensions = TaxonomyFilterService.loadTaxonomy('/taxonomy.yml');
-      const scope = dimensions.find((d) => d.name === 'Scope');
-
-      expect(scope).toBeDefined();
-      // Should contain built-in + custom values without duplicates
-      expect(scope!.values).toContain('Unit');
-      expect(scope!.values).toContain('Integration');
-      expect(scope!.values).toContain('Acceptance');
-      expect(scope!.values).toContain('System');
-    });
-  });
-
-  describe('buildFilterArgs', () => {
-    it('should return empty string for empty filters', () => {
-      expect(TaxonomyFilterService.buildFilterArgs({})).toBe('');
-    });
-
-    it('should build single-value filter', () => {
-      const result = TaxonomyFilterService.buildFilterArgs({ Maturity: 'Trusted' });
-      expect(result).toBe('--testFilter "Maturity=Trusted"');
-    });
-
-    it('should build multi-value filter with pipe separator', () => {
-      const result = TaxonomyFilterService.buildFilterArgs({ Scope: 'Unit,Integration' });
-      expect(result).toBe('--testFilter "Scope=Unit|Integration"');
-    });
-
-    it('should build regex filter', () => {
-      const result = TaxonomyFilterService.buildFilterArgs({ Maturity: '/Trusted|Adolescent/' });
-      expect(result).toBe('--testFilter "Maturity=~Trusted|Adolescent"');
-    });
-
-    it('should AND multiple dimensions with semicolon', () => {
-      const result = TaxonomyFilterService.buildFilterArgs({
-        Maturity: 'Trusted',
-        Scope: 'Unit',
-      });
-      expect(result).toContain(';');
-      expect(result).toContain('Maturity=Trusted');
-      expect(result).toContain('Scope=Unit');
-    });
-  });
-
-  describe('matchesFilter', () => {
-    it('should match exact value', () => {
-      const match = TaxonomyFilterService.matchesFilter({ Scope: 'Unit', Maturity: 'Trusted' }, { Scope: 'Unit' });
-      expect(match).toBe(true);
-    });
-
-    it('should match comma-separated values', () => {
-      const match = TaxonomyFilterService.matchesFilter({ Scope: 'Integration' }, { Scope: 'Unit,Integration' });
-      expect(match).toBe(true);
-    });
-
-    it('should not match when value is not in list', () => {
-      const match = TaxonomyFilterService.matchesFilter({ Scope: 'End To End' }, { Scope: 'Unit,Integration' });
-      expect(match).toBe(false);
-    });
-
-    it('should require all dimensions to match (AND)', () => {
-      const match = TaxonomyFilterService.matchesFilter(
-        { Scope: 'Unit', Maturity: 'Experimental' },
-        { Scope: 'Unit', Maturity: 'Trusted' },
-      );
-      expect(match).toBe(false);
-    });
-
-    it('should match regex patterns', () => {
-      const match = TaxonomyFilterService.matchesFilter({ Maturity: 'Trusted' }, { Maturity: '/Trusted|Adolescent/' });
-      expect(match).toBe(true);
-    });
-
-    it('should not match when regex does not match', () => {
-      const match = TaxonomyFilterService.matchesFilter(
-        { Maturity: 'Experimental' },
-        { Maturity: '/Trusted|Adolescent/' },
-      );
-      expect(match).toBe(false);
-    });
-
-    it('should return false when test lacks a required dimension', () => {
-      const match = TaxonomyFilterService.matchesFilter({}, { Scope: 'Unit' });
-      expect(match).toBe(false);
-    });
-
-    it('should handle hierarchical dot-notation matching', () => {
-      const match = TaxonomyFilterService.matchesFilter({ Domain: 'Combat.Melee.Sword' }, { Domain: 'Combat.Melee' });
-      expect(match).toBe(true);
-    });
-  });
-});
-
-// ============================================================================
-// Test Result Reporter
-// ============================================================================
-
-describe('TestResultReporter', () => {
-  describe('parseJUnitXml', () => {
-    it('should parse a valid JUnit XML string', () => {
-      const xml = `<?xml version="1.0" encoding="UTF-8"?>
-<testsuite name="EditMode" tests="10" failures="2" skipped="1" time="5.432">
-  <testcase classname="MyTests" name="TestA">
-  </testcase>
-  <testcase classname="MyTests" name="TestB">
-    <failure message="Expected true">
-      <![CDATA[at MyTests.TestB() in TestFile.cs:42]]>
-    </failure>
-  </testcase>
-</testsuite>`;
-
-      const result = TestResultReporter.parseJUnitXml(xml);
-
-      expect(result.runName).toBe('EditMode');
-      expect(result.passed).toBe(7);
-      expect(result.failed).toBe(2);
-      expect(result.skipped).toBe(1);
-      expect(result.duration).toBeCloseTo(5.432);
-      expect(result.failures).toHaveLength(1);
-      expect(result.failures[0].testName).toBe('TestB');
-      expect(result.failures[0].className).toBe('MyTests');
-      expect(result.failures[0].message).toBe('Expected true');
-      expect(result.failures[0].stackTrace).toContain('TestFile.cs:42');
-    });
-
-    it('should handle empty test suite', () => {
-      const xml = `<testsuite name="Empty" tests="0" failures="0" time="0.0"></testsuite>`;
-
-      const result = TestResultReporter.parseJUnitXml(xml);
-      expect(result.passed).toBe(0);
-      expect(result.failed).toBe(0);
-      expect(result.failures).toHaveLength(0);
-    });
-  });
-
-  describe('parseJsonData', () => {
-    it('should parse Unity JSON test result data', () => {
-      const data = {
-        name: 'PlayMode',
-        passed: 15,
-        failed: 2,
-        skipped: 3,
-        duration: 12.5,
-        testResults: [{ name: 'FailingTest', className: 'MyClass', result: 'Failed', message: 'Assert failed' }],
-      };
-
-      const result = TestResultReporter.parseJsonData(data);
-      expect(result.runName).toBe('PlayMode');
-      expect(result.passed).toBe(15);
-      expect(result.failed).toBe(2);
-      expect(result.skipped).toBe(3);
-      expect(result.failures).toHaveLength(1);
-      expect(result.failures[0].testName).toBe('FailingTest');
-    });
-  });
-
-  describe('generateSummary', () => {
-    it('should generate a markdown summary table', () => {
-      const results: TestResult[] = [
-        {
-          runName: 'fast',
-          passed: 10,
-          failed: 0,
-          skipped: 2,
-          duration: 5.0,
-          failures: [],
-        },
-        {
-          runName: 'basic',
-          passed: 20,
-          failed: 1,
-          skipped: 0,
-          duration: 30.0,
-          failures: [{ testName: 'TestX', className: 'ClassX', message: 'Expected 1 but got 2' }],
-        },
-      ];
-
-      const summary = TestResultReporter.generateSummary(results);
-
-      expect(summary).toContain('Test Results Summary');
-      expect(summary).toContain('fast');
-      expect(summary).toContain('basic');
-      expect(summary).toContain('Total');
-      expect(summary).toContain('Failures');
-      expect(summary).toContain('TestX');
-    });
-
-    it('should return message when no results available', () => {
-      const summary = TestResultReporter.generateSummary([]);
-      expect(summary).toContain('No test results');
-    });
-  });
-
-  describe('writeResults', () => {
-    it('should create output directory and write files for json format', () => {
-      mockFs.existsSync.mockReturnValue(false);
-      mockFs.mkdirSync.mockReturnValue(undefined as any);
-      mockFs.writeFileSync.mockReturnValue(undefined);
-
-      const results: TestResult[] = [
-        { runName: 'test', passed: 5, failed: 0, skipped: 0, duration: 1.0, failures: [] },
-      ];
-
-      TestResultReporter.writeResults(results, '/output', 'json');
-
-      expect(mockFs.mkdirSync).toHaveBeenCalledWith('/output', { recursive: true });
-      // Should write JSON + summary
-      expect(mockFs.writeFileSync).toHaveBeenCalledTimes(2);
-    });
-
-    it('should write both formats when specified', () => {
-      mockFs.existsSync.mockReturnValue(true);
-      mockFs.writeFileSync.mockReturnValue(undefined);
-
-      const results: TestResult[] = [
-        { runName: 'test', passed: 5, failed: 0, skipped: 0, duration: 1.0, failures: [] },
-      ];
-
-      TestResultReporter.writeResults(results, '/output', 'both');
-
-      // Should write JSON + JUnit XML + summary = 3 calls
-      expect(mockFs.writeFileSync).toHaveBeenCalledTimes(3);
-    });
-  });
-});
-
-// ============================================================================
-// Test Workflow Service - buildUnityArgs
-// ============================================================================
-
-describe('TestWorkflowService', () => {
-  describe('buildUnityArgs', () => {
-    const baseParams = {
-      projectPath: '/project',
-      targetPlatform: 'StandaloneLinux64',
-      testResultPath: './test-results',
-      testResultFormat: 'junit',
-    } as any;
-
-    it('should build EditMode args', () => {
-      const run: TestRunDefinition = { name: 'edit', editMode: true };
-
-      const args = TestWorkflowService.buildUnityArgs(run, baseParams);
-
-      expect(args).toContain('-batchmode');
-      expect(args).toContain('-nographics');
-      expect(args).toContain('-runTests');
-      expect(args).toContain('-testPlatform EditMode');
-      expect(args).toContain('-projectPath');
-    });
-
-    it('should build PlayMode args', () => {
-      const run: TestRunDefinition = { name: 'play', playMode: true };
-
-      const args = TestWorkflowService.buildUnityArgs(run, baseParams);
-
-      expect(args).toContain('-testPlatform PlayMode');
-    });
-
-    it('should build built-client args', () => {
-      const run: TestRunDefinition = {
-        name: 'client',
-        builtClient: true,
-        builtClientPath: './Builds/Linux',
-      };
-
-      const args = TestWorkflowService.buildUnityArgs(run, baseParams);
-
-      expect(args).toContain('-testPlatform StandalonePlayer');
-      expect(args).toContain('-builtPlayerPath');
-      expect(args).toContain('./Builds/Linux');
-    });
-
-    it('should include taxonomy filter args', () => {
-      const run: TestRunDefinition = {
-        name: 'filtered',
-        editMode: true,
-        filters: { Maturity: 'Trusted', Scope: 'Unit,Integration' },
-      };
-
-      const args = TestWorkflowService.buildUnityArgs(run, baseParams);
-
-      expect(args).toContain('--testFilter');
-      expect(args).toContain('Maturity=Trusted');
-    });
-
-    it('should include build target', () => {
-      const run: TestRunDefinition = { name: 'test', editMode: true };
-
-      const args = TestWorkflowService.buildUnityArgs(run, baseParams);
-
-      expect(args).toContain('-buildTarget StandaloneLinux64');
-    });
-  });
-});

src/model/orchestrator/services/test/README.md

@@ -1,5 +0,0 @@
-# Test Workflow Engine
-
-Service for YAML-based test suite definitions, taxonomy filtering, and structured test results.
-
-See GitHub Issue for full specification.

yarn.lock

@@ -1006,6 +1006,15 @@
     eslint-visitor-keys "^2.1.0"
     semver "^6.3.1"
 
+"@babel/generator@7.18.2":
+  version "7.18.2"
+  resolved "https://registry.yarnpkg.com/@babel/generator/-/generator-7.18.2.tgz#33873d6f89b21efe2da63fe554460f3df1c5880d"
+  integrity sha512-W1lG5vUwFvfMd8HVXqdfbuG7RuaSrTCCD8cl8fP8wOivdbtbIg2Db3IWUcgvfxKbbn6ZBGYRW/Zk1MIwK49mgw==
+  dependencies:
+    "@babel/types" "^7.18.2"
+    "@jridgewell/gen-mapping" "^0.3.0"
+    jsesc "^2.5.1"
+
 "@babel/generator@^7.22.10", "@babel/generator@^7.7.2":
   version "7.22.10"
   resolved "https://registry.yarnpkg.com/@babel/generator/-/generator-7.22.10.tgz#c92254361f398e160645ac58831069707382b722"
@@ -1099,11 +1108,21 @@
   dependencies:
     "@babel/types" "^7.22.5"
 
+"@babel/helper-string-parser@^7.18.10", "@babel/helper-string-parser@^7.27.1":
+  version "7.27.1"
+  resolved "https://registry.yarnpkg.com/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz#54da796097ab19ce67ed9f88b47bb2ec49367687"
+  integrity sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==
+
 "@babel/helper-string-parser@^7.22.5":
   version "7.22.5"
   resolved "https://registry.yarnpkg.com/@babel/helper-string-parser/-/helper-string-parser-7.22.5.tgz#533f36457a25814cf1df6488523ad547d784a99f"
   integrity sha512-mM4COjgZox8U+JcXQwPijIZLElkgEpO5rsERVDJTc2qfCDfERyob6k5WegS14SX18IIjv+XD+GrqNumY5JRCDw==
 
+"@babel/helper-validator-identifier@^7.18.6", "@babel/helper-validator-identifier@^7.28.5":
+  version "7.28.5"
+  resolved "https://registry.yarnpkg.com/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz#010b6938fab7cb7df74aa2bbc06aa503b8fe5fb4"
+  integrity sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==
+
 "@babel/helper-validator-identifier@^7.22.20":
   version "7.22.20"
   resolved "https://registry.yarnpkg.com/@babel/helper-validator-identifier/-/helper-validator-identifier-7.22.20.tgz#c4ae002c61d2879e724581d96665583dbc1dc0e0"
@@ -1146,6 +1165,11 @@
     chalk "^2.4.2"
     js-tokens "^4.0.0"
 
+"@babel/parser@7.18.4":
+  version "7.18.4"
+  resolved "https://registry.yarnpkg.com/@babel/parser/-/parser-7.18.4.tgz#6774231779dd700e0af29f6ad8d479582d7ce5ef"
+  integrity sha512-FDge0dFazETFcxGw/EXzOkN8uJp0PC7Qbm+Pe9T+av2zlBpOgunFHkQPPn+eRuClU73JF+98D531UgayY89tow==
+
 "@babel/parser@^7.1.0", "@babel/parser@^7.14.7", "@babel/parser@^7.20.7", "@babel/parser@^7.22.10", "@babel/parser@^7.22.5":
   version "7.22.10"
   resolved "https://registry.yarnpkg.com/@babel/parser/-/parser-7.22.10.tgz#e37634f9a12a1716136c44624ef54283cabd3f55"
@@ -1288,6 +1312,15 @@
     debug "^4.1.0"
     globals "^11.1.0"
 
+"@babel/types@7.19.0":
+  version "7.19.0"
+  resolved "https://registry.yarnpkg.com/@babel/types/-/types-7.19.0.tgz#75f21d73d73dc0351f3368d28db73465f4814600"
+  integrity sha512-YuGopBq3ke25BVSiS6fgF49Ul9gH1x70Bcr6bqRLjWCkcX8Hre1/5+z+IiWOIerRMSSEfGZVB9z9kyq7wVs9YA==
+  dependencies:
+    "@babel/helper-string-parser" "^7.18.10"
+    "@babel/helper-validator-identifier" "^7.18.6"
+    to-fast-properties "^2.0.0"
+
 "@babel/types@^7.0.0", "@babel/types@^7.20.7", "@babel/types@^7.22.10", "@babel/types@^7.22.5", "@babel/types@^7.3.3":
   version "7.22.10"
   resolved "https://registry.yarnpkg.com/@babel/types/-/types-7.22.10.tgz#4a9e76446048f2c66982d1a989dd12b8a2d2dc03"
@@ -1297,6 +1330,14 @@
     "@babel/helper-validator-identifier" "^7.22.5"
     to-fast-properties "^2.0.0"
 
+"@babel/types@^7.18.2":
+  version "7.29.0"
+  resolved "https://registry.yarnpkg.com/@babel/types/-/types-7.29.0.tgz#9f5b1e838c446e72cf3cd4b918152b8c605e37c7"
+  integrity sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A==
+  dependencies:
+    "@babel/helper-string-parser" "^7.27.1"
+    "@babel/helper-validator-identifier" "^7.28.5"
+
 "@babel/types@^7.22.15", "@babel/types@^7.23.0":
   version "7.23.0"
   resolved "https://registry.yarnpkg.com/@babel/types/-/types-7.23.0.tgz#8c1f020c9df0e737e4e247c0619f58c68458aaeb"
@@ -2667,6 +2708,13 @@
   dependencies:
     "@types/yargs-parser" "*"
 
+"@types/yargs@^17.0.35":
+  version "17.0.35"
+  resolved "https://registry.yarnpkg.com/@types/yargs/-/yargs-17.0.35.tgz#07013e46aa4d7d7d50a49e15604c1c5340d4eb24"
+  integrity sha512-qUHkeCyQFxMXg79wQfTtfndEC+N9ZZg76HJftDJp+qH2tV7Gj4OJi7l+PiWwJ+pWtW8GwSmqsDj/oymhrTWXjg==
+  dependencies:
+    "@types/yargs-parser" "*"
+
 "@types/yarnpkg__lockfile@^1.1.6":
   version "1.1.6"
   resolved "https://registry.yarnpkg.com/@types/yarnpkg__lockfile/-/yarnpkg__lockfile-1.1.6.tgz#60a35ede6197d8cbedd5bb8393f3921e8d56d44b"
@@ -3115,6 +3163,11 @@ asynckit@^0.4.0:
   resolved "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz"
   integrity sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==
 
+at-least-node@^1.0.0:
+  version "1.0.0"
+  resolved "https://registry.yarnpkg.com/at-least-node/-/at-least-node-1.0.0.tgz#602cd4b46e844ad4effc92a8011a3c46e0238dc2"
+  integrity sha512-+q/t7Ekv1EDY2l6Gda6LLiX14rU9TV20Wa3ofeQmwPFZbOMo9DXrLbOjFaaclkXKWidIaopwAObQDqwWtGUjqg==
+
 available-typed-arrays@^1.0.5:
   version "1.0.5"
   resolved "https://registry.yarnpkg.com/available-typed-arrays/-/available-typed-arrays-1.0.5.tgz#92f95616501069d07d10edb2fc37d3e1c65123b7"
@@ -3229,7 +3282,7 @@ base-64@^1.0.0:
   resolved "https://registry.yarnpkg.com/base-64/-/base-64-1.0.0.tgz#09d0f2084e32a3fd08c2475b973788eee6ae8f4a"
   integrity sha512-kwDPIFCGx0NZHog36dj+tHiwP4QMzsZ3AgMViUBKI0+V5n4U0ufTCUMhnQ04diaRI8EX/QcPfql7zlhZ7j4zgg==
 
-base64-js@^1.0.2:
+base64-js@^1.0.2, base64-js@^1.3.1:
   version "1.5.1"
   resolved "https://registry.yarnpkg.com/base64-js/-/base64-js-1.5.1.tgz#1b1b440160a5bf7ad40b650f095963481903930a"
   integrity sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==
@@ -3277,6 +3330,15 @@ big-integer@^1.6.44:
   resolved "https://registry.yarnpkg.com/big-integer/-/big-integer-1.6.51.tgz#0df92a5d9880560d3ff2d5fd20245c889d130686"
   integrity sha512-GPEid2Y9QU1Exl1rpO9B2IPJGHPSupF5GnVIP0blYvNOMer2bTvSWs1jGOUg04hTmu67nmLsQ9TBo1puaotBHg==
 
+bl@^4.0.3:
+  version "4.1.0"
+  resolved "https://registry.yarnpkg.com/bl/-/bl-4.1.0.tgz#451535264182bec2fbbc83a62ab98cf11d9f7b3a"
+  integrity sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w==
+  dependencies:
+    buffer "^5.5.0"
+    inherits "^2.0.4"
+    readable-stream "^3.4.0"
+
 bowser@^2.11.0:
   version "2.11.0"
   resolved "https://registry.yarnpkg.com/bowser/-/bowser-2.11.0.tgz#5ca3c35757a7aa5771500c70a73a9f91ef420a8f"
@@ -3347,6 +3409,14 @@ buffer@4.9.2:
     ieee754 "^1.1.4"
     isarray "^1.0.0"
 
+buffer@^5.5.0:
+  version "5.7.1"
+  resolved "https://registry.yarnpkg.com/buffer/-/buffer-5.7.1.tgz#ba62e7c13133053582197160851a8f648e99eed0"
+  integrity sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ==
+  dependencies:
+    base64-js "^1.3.1"
+    ieee754 "^1.1.13"
+
 bundle-name@^3.0.0:
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/bundle-name/-/bundle-name-3.0.0.tgz#ba59bcc9ac785fb67ccdbf104a2bf60c099f0e1a"
@@ -3440,7 +3510,7 @@ chalk@^2.4.2:
     escape-string-regexp "^1.0.5"
     supports-color "^5.3.0"
 
-chalk@^4.0.0, chalk@^4.1.0:
+chalk@^4.0.0, chalk@^4.1.0, chalk@^4.1.2:
   version "4.1.2"
   resolved "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz"
   integrity sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==
@@ -3463,6 +3533,11 @@ charenc@0.0.2:
   resolved "https://registry.yarnpkg.com/charenc/-/charenc-0.0.2.tgz#c0a1d2f3a7092e03774bfa83f14c0fc5790a8667"
   integrity sha512-yrLQ/yVUFXkzg7EDQsPieE/53+0RlaWTs+wBrvW36cyilJ2SaDWfl4Yj7MtLTXleV9uEKefbAGUPv2/iWSooRA==
 
+chownr@^1.1.1:
+  version "1.1.4"
+  resolved "https://registry.yarnpkg.com/chownr/-/chownr-1.1.4.tgz#6fc9d7b42d32a583596337666e7d08084da2cc6b"
+  integrity sha512-jJ0bqzaylmJtVnNgzTeSOs8DPavpbYgEr/b0YL8/2GO3xJEhInFmhKMUnEJQjZumK7KXGFhUy89PrsJWlakBVg==
+
 chownr@^2.0.0:
   version "2.0.0"
   resolved "https://registry.npmjs.org/chownr/-/chownr-2.0.0.tgz"
@@ -3504,6 +3579,15 @@ cliui@^7.0.2:
     strip-ansi "^6.0.0"
     wrap-ansi "^7.0.0"
 
+cliui@^8.0.1:
+  version "8.0.1"
+  resolved "https://registry.yarnpkg.com/cliui/-/cliui-8.0.1.tgz#0c04b075db02cbfe60dc8e6cf2f5486b1a3608aa"
+  integrity sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==
+  dependencies:
+    string-width "^4.2.0"
+    strip-ansi "^6.0.1"
+    wrap-ansi "^7.0.0"
+
 clone-response@^1.0.2:
   version "1.0.3"
   resolved "https://registry.yarnpkg.com/clone-response/-/clone-response-1.0.3.tgz#af2032aa47816399cf5f0a1d0db902f517abb8c3"
@@ -3614,6 +3698,11 @@ core-util-is@1.0.2:
   resolved "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.2.tgz"
   integrity sha512-3lqz5YjWTYnW6dlDa5TLaTCcShfar1e40rmcJVwCBJC6mWlFuj0eCHIElmG1g5kyuJ/GD+8Wn4FFCcz4gJPfaQ==
 
+core-util-is@~1.0.0:
+  version "1.0.3"
+  resolved "https://registry.yarnpkg.com/core-util-is/-/core-util-is-1.0.3.tgz#a6042d3634c2b27e9328f837b965fac83808db85"
+  integrity sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==
+
 create-require@^1.1.0:
   version "1.1.1"
   resolved "https://registry.npmjs.org/create-require/-/create-require-1.1.1.tgz"
@@ -3732,6 +3821,11 @@ dedent@^0.7.0:
   resolved "https://registry.yarnpkg.com/dedent/-/dedent-0.7.0.tgz#2495ddbaf6eb874abb0e1be9df22d2e5a544326c"
   integrity sha512-Q6fKUPqnAHAyhiUgFU7BUzLiv0kd8saH9al7tnu5Q/okj6dnupxyTgFIBjVzJATdfIAm9NAsvXNzjaKa+bxVyA==
 
+deep-extend@^0.6.0:
+  version "0.6.0"
+  resolved "https://registry.yarnpkg.com/deep-extend/-/deep-extend-0.6.0.tgz#c4fa7c95404a17a9c3e8ca7e1537312b736330ac"
+  integrity sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==
+
 deep-is@^0.1.3:
   version "0.1.4"
   resolved "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz"
@@ -3803,6 +3897,11 @@ dequal@^2.0.3:
   resolved "https://registry.yarnpkg.com/dequal/-/dequal-2.0.3.tgz#2644214f1997d39ed0ee0ece72335490a7ac67be"
   integrity sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==
 
+detect-libc@^2.0.0:
+  version "2.1.2"
+  resolved "https://registry.yarnpkg.com/detect-libc/-/detect-libc-2.1.2.tgz#689c5dcdc1900ef5583a4cb9f6d7b473742074ad"
+  integrity sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==
+
 detect-newline@^3.0.0:
   version "3.1.0"
   resolved "https://registry.yarnpkg.com/detect-newline/-/detect-newline-3.1.0.tgz#576f5dfc63ae1a192ff192d8ad3af6308991b651"
@@ -3899,6 +3998,13 @@ end-of-stream@^1.1.0:
   dependencies:
     once "^1.4.0"
 
+end-of-stream@^1.4.1:
+  version "1.4.5"
+  resolved "https://registry.yarnpkg.com/end-of-stream/-/end-of-stream-1.4.5.tgz#7344d711dea40e0b74abc2ed49778743ccedb08c"
+  integrity sha512-ooEGc6HP26xXq/N+GCGOT0JKCLDGrq2bQUZrQ7gyrJiZANJ/8YDTxTpQBXGMn+WbIQXNVpyWymm7KYVICQnyOg==
+  dependencies:
+    once "^1.4.0"
+
 enquirer@^2.3.5:
   version "2.4.1"
   resolved "https://registry.yarnpkg.com/enquirer/-/enquirer-2.4.1.tgz#93334b3fbd74fc7097b224ab4a8fb7e40bf4ae56"
@@ -4398,6 +4504,11 @@ exit@^0.1.2:
   resolved "https://registry.yarnpkg.com/exit/-/exit-0.1.2.tgz#0632638f8d877cc82107d30a0fff1a17cba1cd0c"
   integrity sha512-Zk/eNKV2zbjpKzrsQ+n1G6poVbErQxJ0LBOJXaKZ1EViLzH+hrLu9cdXI4zw9dBQJslwBEpbQ2P1oS7nDxs6jQ==
 
+expand-template@^2.0.3:
+  version "2.0.3"
+  resolved "https://registry.yarnpkg.com/expand-template/-/expand-template-2.0.3.tgz#6e14b3fcee0f3a6340ecb57d2e8918692052a47c"
+  integrity sha512-XYfuKMvj4O35f/pOXLObndIRvyQ+/+6AhODh+OKWj9S9498pHHn/IMszH+gt0fBCRWMNfk1ZSp5x3AifmnI2vg==
+
 expect@^27.5.1:
   version "27.5.1"
   resolved "https://registry.npmjs.org/expect/-/expect-27.5.1.tgz"
@@ -4581,6 +4692,19 @@ form-data@~2.3.2:
     combined-stream "^1.0.6"
     mime-types "^2.1.12"
 
+from2@^2.3.0:
+  version "2.3.0"
+  resolved "https://registry.yarnpkg.com/from2/-/from2-2.3.0.tgz#8bfb5502bde4a4d36cfdeea007fcca21d7e382af"
+  integrity sha512-OMcX/4IC/uqEPVgGeyfN22LJk6AZrMkRZHxcHBMBvHScDGgwTm2GT2Wkgtocyd3JfZffjj2kYUDXXII0Fk9W0g==
+  dependencies:
+    inherits "^2.0.1"
+    readable-stream "^2.0.0"
+
+fs-constants@^1.0.0:
+  version "1.0.0"
+  resolved "https://registry.yarnpkg.com/fs-constants/-/fs-constants-1.0.0.tgz#6be0de9be998ce16af8afc24497b9ee9b7ccd9ad"
+  integrity sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow==
+
 fs-extra@^11.1.1:
   version "11.1.1"
   resolved "https://registry.yarnpkg.com/fs-extra/-/fs-extra-11.1.1.tgz#da69f7c39f3b002378b0954bb6ae7efdc0876e2d"
@@ -4590,6 +4714,16 @@ fs-extra@^11.1.1:
     jsonfile "^6.0.1"
     universalify "^2.0.0"
 
+fs-extra@^9.1.0:
+  version "9.1.0"
+  resolved "https://registry.yarnpkg.com/fs-extra/-/fs-extra-9.1.0.tgz#5954460c764a8da2094ba3554bf839e6b9a7c86d"
+  integrity sha512-hcg3ZmepS30/7BSFqRvoo3DOMQu7IjqxO5nCDt+zM9XWjb33Wg7ziNT+Qvqbuc3+gWpzO02JubVyk2G4Zvo1OQ==
+  dependencies:
+    at-least-node "^1.0.0"
+    graceful-fs "^4.2.0"
+    jsonfile "^6.0.1"
+    universalify "^2.0.0"
+
 fs-minipass@^2.0.0:
   version "2.1.0"
   resolved "https://registry.npmjs.org/fs-minipass/-/fs-minipass-2.1.0.tgz"
@@ -4612,6 +4746,11 @@ function-bind@^1.1.1:
   resolved "https://registry.npmjs.org/function-bind/-/function-bind-1.1.1.tgz"
   integrity sha512-yIovAzMX49sF8Yl58fSCWJ5svSLuaibPxXQJFLmBObTuCr0Mf1KiPopGM9NiFjiYBCbfaa2Fh6breQ6ANVTI0A==
 
+function-bind@^1.1.2:
+  version "1.1.2"
+  resolved "https://registry.yarnpkg.com/function-bind/-/function-bind-1.1.2.tgz#2c02d864d97f3ea6c8830c464cbd11ab6eab7a1c"
+  integrity sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==
+
 function.prototype.name@^1.1.5:
   version "1.1.5"
   resolved "https://registry.yarnpkg.com/function.prototype.name/-/function.prototype.name-1.1.5.tgz#cce0505fe1ffb80503e6f9e46cc64e46a12a9621"
@@ -4691,6 +4830,11 @@ getpass@^0.1.1:
   dependencies:
     assert-plus "^1.0.0"
 
+github-from-package@0.0.0:
+  version "0.0.0"
+  resolved "https://registry.yarnpkg.com/github-from-package/-/github-from-package-0.0.0.tgz#97fb5d96bfde8973313f20e8288ef9a167fa64ce"
+  integrity sha512-SyHy3T1v2NUXn29OsWdxmK6RwHD+vkj3v8en8AOBZ1wBQ/hCAQ5bAQTD02kW4W9tUp/3Qh6J8r9EvntiyCmOOw==
+
 glob-parent@^5.1.2:
   version "5.1.2"
   resolved "https://registry.yarnpkg.com/glob-parent/-/glob-parent-5.1.2.tgz#869832c58034fe68a4093c17dc15e8340d8401c4"
@@ -4875,6 +5019,13 @@ has@^1.0.3:
   dependencies:
     function-bind "^1.1.1"
 
+hasown@^2.0.2:
+  version "2.0.2"
+  resolved "https://registry.yarnpkg.com/hasown/-/hasown-2.0.2.tgz#003eaf91be7adc372e84ec59dc37252cedb80003"
+  integrity sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==
+  dependencies:
+    function-bind "^1.1.2"
+
 hosted-git-info@^2.1.4:
   version "2.8.9"
   resolved "https://registry.yarnpkg.com/hosted-git-info/-/hosted-git-info-2.8.9.tgz#dffc0bf9a21c02209090f2aa69429e1414daf3f9"
@@ -4953,7 +5104,7 @@ ieee754@1.1.13:
   resolved "https://registry.yarnpkg.com/ieee754/-/ieee754-1.1.13.tgz#ec168558e95aa181fd87d37f55c32bbcb6708b84"
   integrity sha512-4vf7I2LYV/HaWerSo3XmlMkp5eZ83i+/CDluXi/IGTs/O1sejBNhTtnxzmRZfvOUqj7lZjqHkeTvpgSFDlWZTg==
 
-ieee754@^1.1.4:
+ieee754@^1.1.13, ieee754@^1.1.4:
   version "1.2.1"
   resolved "https://registry.yarnpkg.com/ieee754/-/ieee754-1.2.1.tgz#8eb7a10a63fff25d15a57b001586d177d1b0d352"
   integrity sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==
@@ -5007,11 +5158,16 @@ inflight@^1.0.4:
     once "^1.3.0"
     wrappy "1"
 
-inherits@2, inherits@^2.0.3:
+inherits@2, inherits@^2.0.1, inherits@^2.0.3, inherits@^2.0.4, inherits@~2.0.3:
   version "2.0.4"
   resolved "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz"
   integrity sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==
 
+ini@~1.3.0:
+  version "1.3.8"
+  resolved "https://registry.yarnpkg.com/ini/-/ini-1.3.8.tgz#a29da425b48806f34767a4efce397269af28432c"
+  integrity sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==
+
 internal-slot@^1.0.5:
   version "1.0.5"
   resolved "https://registry.yarnpkg.com/internal-slot/-/internal-slot-1.0.5.tgz#f2a2ee21f668f8627a4667f309dc0f4fb6674986"
@@ -5026,6 +5182,14 @@ interpret@^1.0.0:
   resolved "https://registry.npmjs.org/interpret/-/interpret-1.4.0.tgz"
   integrity sha512-agE4QfB2Lkp9uICn7BAqoscw4SZP9kTE2hxiFI3jBPmXJfdqiahTbUuKGsMoN2GtqL9AxhYioAcVvgsb1HvRbA==
 
+into-stream@^6.0.0:
+  version "6.0.0"
+  resolved "https://registry.yarnpkg.com/into-stream/-/into-stream-6.0.0.tgz#4bfc1244c0128224e18b8870e85b2de8e66c6702"
+  integrity sha512-XHbaOAvP+uFKUFsOgoNPRjLkwB+I22JFPFe5OjTkQ0nwgj6+pSjb4NmB6VMxaPshLiOf+zcpOCBQuLwC1KHhZA==
+  dependencies:
+    from2 "^2.3.0"
+    p-is-promise "^3.0.0"
+
 is-arguments@^1.0.4:
   version "1.1.1"
   resolved "https://registry.yarnpkg.com/is-arguments/-/is-arguments-1.1.1.tgz#15b3f88fda01f2a97fec84ca761a560f123efa9b"
@@ -5073,6 +5237,13 @@ is-callable@^1.1.3, is-callable@^1.1.4, is-callable@^1.2.7:
   resolved "https://registry.yarnpkg.com/is-callable/-/is-callable-1.2.7.tgz#3bc2a85ea742d9e36205dcacdd72ca1fdc51b055"
   integrity sha512-1BC0BVFhS/p0qtw6enp8e+8OD0UrK0oFLztSjNzhcKA3WDuJxxAPXzPuPtKkjEY9UUoEWlX/8fgKeu2S8i9JTA==
 
+is-core-module@2.9.0:
+  version "2.9.0"
+  resolved "https://registry.yarnpkg.com/is-core-module/-/is-core-module-2.9.0.tgz#e1c34429cd51c6dd9e09e0799e396e27b19a9c69"
+  integrity sha512-+5FPy5PnwmO3lvfMb0AsoPaBG+5KHUI0wYFXOtYPnVVVspTFUuMZNfNaNVRt3FZadstu2c8x23vykRW/NBoU6A==
+  dependencies:
+    has "^1.0.3"
+
 is-core-module@^2.12.1, is-core-module@^2.13.0:
   version "2.13.0"
   resolved "https://registry.yarnpkg.com/is-core-module/-/is-core-module-2.13.0.tgz#bb52aa6e2cbd49a30c2ba68c42bf3435ba6072db"
@@ -5080,6 +5251,13 @@ is-core-module@^2.12.1, is-core-module@^2.13.0:
   dependencies:
     has "^1.0.3"
 
+is-core-module@^2.16.1:
+  version "2.16.1"
+  resolved "https://registry.yarnpkg.com/is-core-module/-/is-core-module-2.16.1.tgz#2a98801a849f43e2add644fbb6bc6229b19a4ef4"
+  integrity sha512-UfoeMA6fIJ8wTYFEUjelnaGI67v6+N7qXJEvQuIGa99l4xsCruSYOVSQ0uPANn4dAzm8lkYPaKLrrijLq7x23w==
+  dependencies:
+    hasown "^2.0.2"
+
 is-date-object@^1.0.1:
   version "1.0.5"
   resolved "https://registry.yarnpkg.com/is-date-object/-/is-date-object-1.0.5.tgz#0841d5536e724c25597bf6ea62e1bd38298df31f"
@@ -5235,7 +5413,7 @@ is-wsl@^2.2.0:
   dependencies:
     is-docker "^2.0.0"
 
-isarray@^1.0.0:
+isarray@^1.0.0, isarray@~1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/isarray/-/isarray-1.0.0.tgz#bb935d48582cba168c06834957a54a3e07124f11"
   integrity sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==
@@ -6197,7 +6375,7 @@ minimatch@^3.0.4, minimatch@^3.1.1, minimatch@^3.1.2:
   dependencies:
     brace-expansion "^1.1.7"
 
-minimist@^1.2.0, minimist@^1.2.6:
+minimist@^1.2.0, minimist@^1.2.3, minimist@^1.2.6:
   version "1.2.8"
   resolved "https://registry.yarnpkg.com/minimist/-/minimist-1.2.8.tgz#c1a464e7693302e082a075cee0c057741ac4772c"
   integrity sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==
@@ -6227,6 +6405,11 @@ minizlib@^2.1.1:
     minipass "^3.0.0"
     yallist "^4.0.0"
 
+mkdirp-classic@^0.5.2, mkdirp-classic@^0.5.3:
+  version "0.5.3"
+  resolved "https://registry.yarnpkg.com/mkdirp-classic/-/mkdirp-classic-0.5.3.tgz#fa10c9115cc6d8865be221ba47ee9bed78601113"
+  integrity sha512-gKLcREMhtuZRwRAfqP3RFW+TK4JqApVBtOIftVgjuABpAtpxhPGaDcfvbhNvD0B8iD1oUr/txX35NjcaY6Ns/A==
+
 mkdirp@^1.0.3:
   version "1.0.4"
   resolved "https://registry.npmjs.org/mkdirp/-/mkdirp-1.0.4.tgz"
@@ -6247,11 +6430,24 @@ multimap@^1.1.0:
   resolved "https://registry.yarnpkg.com/multimap/-/multimap-1.1.0.tgz#5263febc085a1791c33b59bb3afc6a76a2a10ca8"
   integrity sha512-0ZIR9PasPxGXmRsEF8jsDzndzHDj7tIav+JUmvIFB/WHswliFnquxECT/De7GR4yg99ky/NlRKJT82G1y271bw==
 
+multistream@^4.1.0:
+  version "4.1.0"
+  resolved "https://registry.yarnpkg.com/multistream/-/multistream-4.1.0.tgz#7bf00dfd119556fbc153cff3de4c6d477909f5a8"
+  integrity sha512-J1XDiAmmNpRCBfIWJv+n0ymC4ABcf/Pl+5YvC5B/D2f/2+8PtHvCNxMPKiQcZyi922Hq69J2YOpb1pTywfifyw==
+  dependencies:
+    once "^1.4.0"
+    readable-stream "^3.6.0"
+
 nanoid@^3.3.1:
   version "3.3.6"
   resolved "https://registry.yarnpkg.com/nanoid/-/nanoid-3.3.6.tgz#443380c856d6e9f9824267d960b4236ad583ea4c"
   integrity sha512-BGcqMMJuToF7i1rt+2PWSNVnWIkGCU78jBG3RxO/bZlnZPK2Cmi2QaffxGO/2RvWi9sL+FAiRiXMgsyxQ1DIDA==
 
+napi-build-utils@^1.0.1:
+  version "1.0.2"
+  resolved "https://registry.yarnpkg.com/napi-build-utils/-/napi-build-utils-1.0.2.tgz#b1fddc0b2c46e380a0b7a76f984dd47c41a13806"
+  integrity sha512-ONmRUqK7zj7DWX0D9ADe03wbwOBZxNAfF20PlGfCWQcD3+/MakShIHrMqx9YwPTfxDdF1zLeL+RGZiR9kGMLdg==
+
 natural-compare@^1.4.0:
   version "1.4.0"
   resolved "https://registry.yarnpkg.com/natural-compare/-/natural-compare-1.4.0.tgz#4abebfeed7541f2c27acfb29bdbbd15c8d5ba4f7"
@@ -6272,7 +6468,14 @@ no-case@^3.0.4:
     lower-case "^2.0.2"
     tslib "^2.0.3"
 
-node-fetch@2:
+node-abi@^3.3.0:
+  version "3.87.0"
+  resolved "https://registry.yarnpkg.com/node-abi/-/node-abi-3.87.0.tgz#423e28fea5c2f195fddd98acded9938c001ae6dd"
+  integrity sha512-+CGM1L1CgmtheLcBuleyYOn7NWPVu0s0EJH2C4puxgEZb9h8QpR9G2dBfZJOAUhi7VQxuBPMd0hiISWcTyiYyQ==
+  dependencies:
+    semver "^7.3.5"
+
+node-fetch@2, node-fetch@^2.6.6, node-fetch@^2.7.0:
   version "2.7.0"
   resolved "https://registry.yarnpkg.com/node-fetch/-/node-fetch-2.7.0.tgz#d0f0fa6e3e2dc1d27efcd8ad99d550bda94d187d"
   integrity sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==
@@ -6286,13 +6489,6 @@ node-fetch@^2.6.7:
   dependencies:
     whatwg-url "^5.0.0"
 
-node-fetch@^2.7.0:
-  version "2.7.0"
-  resolved "https://registry.yarnpkg.com/node-fetch/-/node-fetch-2.7.0.tgz#d0f0fa6e3e2dc1d27efcd8ad99d550bda94d187d"
-  integrity sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==
-  dependencies:
-    whatwg-url "^5.0.0"
-
 node-int64@^0.4.0:
   version "0.4.0"
   resolved "https://registry.yarnpkg.com/node-int64/-/node-int64-0.4.0.tgz#87a9065cdb355d3182d8f94ce11188b825c68a3b"
@@ -6508,6 +6704,11 @@ p-cancelable@^2.0.0:
   resolved "https://registry.npmjs.org/p-cancelable/-/p-cancelable-2.1.1.tgz"
   integrity sha512-BZOr3nRQHOntUjTrH8+Lh54smKHoHyur8We1V8DSMVrl5A2malOOwuJRnKRDjSnkoeBh4at6BwEnb5I7Jl31wg==
 
+p-is-promise@^3.0.0:
+  version "3.0.0"
+  resolved "https://registry.yarnpkg.com/p-is-promise/-/p-is-promise-3.0.0.tgz#58e78c7dfe2e163cf2a04ff869e7c1dba64a5971"
+  integrity sha512-Wo8VsW4IRQSKVXsJCn7TomUaVtyfjVDn3nUP7kE967BQk0CwFpdbZs0X0uk5sW9mkBa9eNM7hCMaG93WUAwxYQ==
+
 p-limit@^2.2.0:
   version "2.3.0"
   resolved "https://registry.yarnpkg.com/p-limit/-/p-limit-2.3.0.tgz#3dd33c647a214fdfffd835933eb086da0dc21db1"
@@ -6653,11 +6854,63 @@ pkg-dir@^7.0.0:
   dependencies:
     find-up "^6.3.0"
 
+pkg-fetch@3.4.2:
+  version "3.4.2"
+  resolved "https://registry.yarnpkg.com/pkg-fetch/-/pkg-fetch-3.4.2.tgz#6f68ebc54842b73f8c0808959a9df3739dcb28b7"
+  integrity sha512-0+uijmzYcnhC0hStDjm/cl2VYdrmVVBpe7Q8k9YBojxmR5tG8mvR9/nooQq3QSXiQqORDVOTY3XqMEqJVIzkHA==
+  dependencies:
+    chalk "^4.1.2"
+    fs-extra "^9.1.0"
+    https-proxy-agent "^5.0.0"
+    node-fetch "^2.6.6"
+    progress "^2.0.3"
+    semver "^7.3.5"
+    tar-fs "^2.1.1"
+    yargs "^16.2.0"
+
+pkg@^5.8.1:
+  version "5.8.1"
+  resolved "https://registry.yarnpkg.com/pkg/-/pkg-5.8.1.tgz#862020f3c0575638ef7d1146f951a54d65ddc984"
+  integrity sha512-CjBWtFStCfIiT4Bde9QpJy0KeH19jCfwZRJqHFDFXfhUklCx8JoFmMj3wgnEYIwGmZVNkhsStPHEOnrtrQhEXA==
+  dependencies:
+    "@babel/generator" "7.18.2"
+    "@babel/parser" "7.18.4"
+    "@babel/types" "7.19.0"
+    chalk "^4.1.2"
+    fs-extra "^9.1.0"
+    globby "^11.1.0"
+    into-stream "^6.0.0"
+    is-core-module "2.9.0"
+    minimist "^1.2.6"
+    multistream "^4.1.0"
+    pkg-fetch "3.4.2"
+    prebuild-install "7.1.1"
+    resolve "^1.22.0"
+    stream-meter "^1.0.4"
+
 pluralize@^8.0.0:
   version "8.0.0"
   resolved "https://registry.yarnpkg.com/pluralize/-/pluralize-8.0.0.tgz#1a6fa16a38d12a1901e0320fa017051c539ce3b1"
   integrity sha512-Nc3IT5yHzflTfbjgqWcCPpo7DaKy4FnpB0l/zCAW0Tc7jxAiuqSxHasntB3D7887LSrA93kDJ9IXovxJYxyLCA==
 
+prebuild-install@7.1.1:
+  version "7.1.1"
+  resolved "https://registry.yarnpkg.com/prebuild-install/-/prebuild-install-7.1.1.tgz#de97d5b34a70a0c81334fd24641f2a1702352e45"
+  integrity sha512-jAXscXWMcCK8GgCoHOfIr0ODh5ai8mj63L2nWrjuAgXE6tDyYGnx4/8o/rCgU+B4JSyZBKbeZqzhtwtC3ovxjw==
+  dependencies:
+    detect-libc "^2.0.0"
+    expand-template "^2.0.3"
+    github-from-package "0.0.0"
+    minimist "^1.2.3"
+    mkdirp-classic "^0.5.3"
+    napi-build-utils "^1.0.1"
+    node-abi "^3.3.0"
+    pump "^3.0.0"
+    rc "^1.2.7"
+    simple-get "^4.0.0"
+    tar-fs "^2.0.0"
+    tunnel-agent "^0.6.0"
+
 prelude-ls@^1.2.1:
   version "1.2.1"
   resolved "https://registry.yarnpkg.com/prelude-ls/-/prelude-ls-1.2.1.tgz#debc6489d7a6e6b0e7611888cec880337d316396"
@@ -6694,12 +6947,17 @@ pretty-format@^27.0.0, pretty-format@^27.5.1:
     ansi-styles "^5.0.0"
     react-is "^17.0.1"
 
+process-nextick-args@~2.0.0:
+  version "2.0.1"
+  resolved "https://registry.yarnpkg.com/process-nextick-args/-/process-nextick-args-2.0.1.tgz#7820d9b16120cc55ca9ae7792680ae7dba6d7fe2"
+  integrity sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==
+
 process@^0.11.10:
   version "0.11.10"
   resolved "https://registry.npmjs.org/process/-/process-0.11.10.tgz"
   integrity sha512-cdGef/drWFoydD1JsMzuFf8100nZl+GT+yacc2bEced5f9Rjk4z+WtFUTBu9PhOi9j/jfmBPu0mMEY4wIdAF8A==
 
-progress@^2.0.0:
+progress@^2.0.0, progress@^2.0.3:
   version "2.0.3"
   resolved "https://registry.yarnpkg.com/progress/-/progress-2.0.3.tgz#7e8cf8d8f5b8f239c1bc68beb4eb78567d572ef8"
   integrity sha512-7PiHtLll5LdnKIMw100I+8xJXR5gW2QwWYkT6iJva0bXitZKa/XMrSbdmg3r2Xnaidz9Qumd0VPaMrZlF9V9sA==
@@ -6772,6 +7030,16 @@ quick-lru@^5.1.1:
   resolved "https://registry.npmjs.org/quick-lru/-/quick-lru-5.1.1.tgz"
   integrity sha512-WuyALRjWPDGtt/wzJiadO5AXY+8hZ80hVpe6MyivgraREW751X3SbhRvG3eLKOYN+8VEvqLcf3wdnt44Z4S4SA==
 
+rc@^1.2.7:
+  version "1.2.8"
+  resolved "https://registry.yarnpkg.com/rc/-/rc-1.2.8.tgz#cd924bf5200a075b83c188cd6b9e211b7fc0d3ed"
+  integrity sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw==
+  dependencies:
+    deep-extend "^0.6.0"
+    ini "~1.3.0"
+    minimist "^1.2.0"
+    strip-json-comments "~2.0.1"
+
 react-is@^17.0.1:
   version "17.0.2"
   resolved "https://registry.yarnpkg.com/react-is/-/react-is-17.0.2.tgz#e691d4a8e9c789365655539ab372762b0efb54f0"
@@ -6796,6 +7064,28 @@ read-pkg@^5.2.0:
     parse-json "^5.0.0"
     type-fest "^0.6.0"
 
+readable-stream@^2.0.0, readable-stream@^2.1.4:
+  version "2.3.8"
+  resolved "https://registry.yarnpkg.com/readable-stream/-/readable-stream-2.3.8.tgz#91125e8042bba1b9887f49345f6277027ce8be9b"
+  integrity sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==
+  dependencies:
+    core-util-is "~1.0.0"
+    inherits "~2.0.3"
+    isarray "~1.0.0"
+    process-nextick-args "~2.0.0"
+    safe-buffer "~5.1.1"
+    string_decoder "~1.1.1"
+    util-deprecate "~1.0.1"
+
+readable-stream@^3.1.1, readable-stream@^3.4.0, readable-stream@^3.6.0:
+  version "3.6.2"
+  resolved "https://registry.yarnpkg.com/readable-stream/-/readable-stream-3.6.2.tgz#56a9b36ea965c00c5a93ef31eb111a0f11056967"
+  integrity sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==
+  dependencies:
+    inherits "^2.0.3"
+    string_decoder "^1.1.1"
+    util-deprecate "^1.0.1"
+
 rechoir@^0.6.2:
   version "0.6.2"
   resolved "https://registry.yarnpkg.com/rechoir/-/rechoir-0.6.2.tgz#85204b54dba82d5742e28c96756ef43af50e3384"
@@ -6914,6 +7204,15 @@ resolve@^1.1.6, resolve@^1.10.0, resolve@^1.20.0, resolve@^1.22.3, resolve@^1.22
     path-parse "^1.0.7"
     supports-preserve-symlinks-flag "^1.0.0"
 
+resolve@^1.22.0:
+  version "1.22.11"
+  resolved "https://registry.yarnpkg.com/resolve/-/resolve-1.22.11.tgz#aad857ce1ffb8bfa9b0b1ac29f1156383f68c262"
+  integrity sha512-RfqAvLnMl313r7c9oclB1HhUEAezcpLjz95wFH4LVuhk9JF/r22qmVP9AMmOU4vMX7Q8pN8jwNg/CSpdFnMjTQ==
+  dependencies:
+    is-core-module "^2.16.1"
+    path-parse "^1.0.7"
+    supports-preserve-symlinks-flag "^1.0.0"
+
 responselike@^1.0.2:
   version "1.0.2"
   resolved "https://registry.yarnpkg.com/responselike/-/responselike-1.0.2.tgz#918720ef3b631c5642be068f15ade5a46f4ba1e7"
@@ -6969,11 +7268,16 @@ safe-array-concat@^1.0.0:
     has-symbols "^1.0.3"
     isarray "^2.0.5"
 
-safe-buffer@^5.0.1, safe-buffer@^5.1.2:
+safe-buffer@^5.0.1, safe-buffer@^5.1.2, safe-buffer@~5.2.0:
   version "5.2.1"
   resolved "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz"
   integrity sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==
 
+safe-buffer@~5.1.0, safe-buffer@~5.1.1:
+  version "5.1.2"
+  resolved "https://registry.yarnpkg.com/safe-buffer/-/safe-buffer-5.1.2.tgz#991ec69d296e0313747d59bdfd2b745c35f8828d"
+  integrity sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==
+
 safe-regex-test@^1.0.0:
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/safe-regex-test/-/safe-regex-test-1.0.0.tgz#793b874d524eb3640d1873aad03596db2d4f2295"
@@ -7081,6 +7385,20 @@ signal-exit@^3.0.2, signal-exit@^3.0.3, signal-exit@^3.0.7:
   resolved "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz"
   integrity sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==
 
+simple-concat@^1.0.0:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/simple-concat/-/simple-concat-1.0.1.tgz#f46976082ba35c2263f1c8ab5edfe26c41c9552f"
+  integrity sha512-cSFtAPtRhljv69IK0hTVZQ+OfE9nePi/rtJmw5UjHeVyVroEqJXP1sFztKUy1qU+xvz3u/sfYJLa947b7nAN2Q==
+
+simple-get@^4.0.0:
+  version "4.0.1"
+  resolved "https://registry.yarnpkg.com/simple-get/-/simple-get-4.0.1.tgz#4a39db549287c979d352112fa03fd99fd6bc3543"
+  integrity sha512-brv7p5WgH0jmQJr1ZDDfKDOSeWWg+OVypG99A/5vYGPqJ6pxiaHLy8nxtFjBA7oMa01ebA9gfh1uMCFqOuXxvA==
+  dependencies:
+    decompress-response "^6.0.0"
+    once "^1.3.1"
+    simple-concat "^1.0.0"
+
 sisteransi@^1.0.5:
   version "1.0.5"
   resolved "https://registry.yarnpkg.com/sisteransi/-/sisteransi-1.0.5.tgz#134d681297756437cc05ca01370d3a7a571075ed"
@@ -7186,6 +7504,13 @@ stream-buffers@^3.0.2:
   resolved "https://registry.npmjs.org/stream-buffers/-/stream-buffers-3.0.2.tgz"
   integrity sha512-DQi1h8VEBA/lURbSwFtEHnSTb9s2/pwLEaFuNhXwy1Dx3Sa0lOuYT2yNUr4/j2fs8oCAMANtrZ5OrPZtyVs3MQ==
 
+stream-meter@^1.0.4:
+  version "1.0.4"
+  resolved "https://registry.yarnpkg.com/stream-meter/-/stream-meter-1.0.4.tgz#52af95aa5ea760a2491716704dbff90f73afdd1d"
+  integrity sha512-4sOEtrbgFotXwnEuzzsQBYEV1elAeFSO8rSGeTwabuX1RRn/kEq9JVH7I0MRBhKVRR0sJkr0M0QCH7yOLf9fhQ==
+  dependencies:
+    readable-stream "^2.1.4"
+
 string-length@^4.0.1:
   version "4.0.2"
   resolved "https://registry.yarnpkg.com/string-length/-/string-length-4.0.2.tgz#a8a8dc7bd5c1a82b9b3c8b87e125f66871b6e57a"
@@ -7230,6 +7555,20 @@ string.prototype.trimstart@^1.0.6:
     define-properties "^1.1.4"
     es-abstract "^1.20.4"
 
+string_decoder@^1.1.1:
+  version "1.3.0"
+  resolved "https://registry.yarnpkg.com/string_decoder/-/string_decoder-1.3.0.tgz#42f114594a46cf1a8e30b0a84f56c78c3edac21e"
+  integrity sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==
+  dependencies:
+    safe-buffer "~5.2.0"
+
+string_decoder@~1.1.1:
+  version "1.1.1"
+  resolved "https://registry.yarnpkg.com/string_decoder/-/string_decoder-1.1.1.tgz#9cf1611ba62685d7030ae9e4ba34149c3af03fc8"
+  integrity sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==
+  dependencies:
+    safe-buffer "~5.1.0"
+
 strip-ansi@^6.0.0, strip-ansi@^6.0.1:
   version "6.0.1"
   resolved "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz"
@@ -7262,6 +7601,11 @@ strip-json-comments@^3.1.0, strip-json-comments@^3.1.1:
   resolved "https://registry.yarnpkg.com/strip-json-comments/-/strip-json-comments-3.1.1.tgz#31f1281b3832630434831c310c01cccda8cbe006"
   integrity sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==
 
+strip-json-comments@~2.0.1:
+  version "2.0.1"
+  resolved "https://registry.yarnpkg.com/strip-json-comments/-/strip-json-comments-2.0.1.tgz#3c531942e908c2697c0ec344858c286c7ca0a60a"
+  integrity sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==
+
 strnum@^1.0.5:
   version "1.1.2"
   resolved "https://registry.yarnpkg.com/strnum/-/strnum-1.1.2.tgz#57bca4fbaa6f271081715dbc9ed7cee5493e28e4"
@@ -7354,6 +7698,27 @@ table@^6.0.9:
     string-width "^4.2.3"
     strip-ansi "^6.0.1"
 
+tar-fs@^2.0.0, tar-fs@^2.1.1:
+  version "2.1.4"
+  resolved "https://registry.yarnpkg.com/tar-fs/-/tar-fs-2.1.4.tgz#800824dbf4ef06ded9afea4acafe71c67c76b930"
+  integrity sha512-mDAjwmZdh7LTT6pNleZ05Yt65HC3E+NiQzl672vQG38jIrehtJk/J3mNwIg+vShQPcLF/LV7CMnDW6vjj6sfYQ==
+  dependencies:
+    chownr "^1.1.1"
+    mkdirp-classic "^0.5.2"
+    pump "^3.0.0"
+    tar-stream "^2.1.4"
+
+tar-stream@^2.1.4:
+  version "2.2.0"
+  resolved "https://registry.yarnpkg.com/tar-stream/-/tar-stream-2.2.0.tgz#acad84c284136b060dc3faa64474aa9aebd77287"
+  integrity sha512-ujeqbceABgwMZxEJnk2HDY2DlnUZ+9oEcb1KzTVfYHio0UE6dG71n60d8D2I4qNvleWrrXpmjpt7vZeF1LnMZQ==
+  dependencies:
+    bl "^4.0.3"
+    end-of-stream "^1.4.1"
+    fs-constants "^1.0.0"
+    inherits "^2.0.3"
+    readable-stream "^3.1.1"
+
 tar@^6.1.11:
   version "6.1.15"
   resolved "https://registry.yarnpkg.com/tar/-/tar-6.1.15.tgz#c9738b0b98845a3b344d334b8fa3041aaba53a69"
@@ -7758,6 +8123,11 @@ url@0.10.3:
     punycode "1.3.2"
     querystring "0.2.0"
 
+util-deprecate@^1.0.1, util-deprecate@~1.0.1:
+  version "1.0.2"
+  resolved "https://registry.yarnpkg.com/util-deprecate/-/util-deprecate-1.0.2.tgz#450d4dc9fa70de732762fbd2d4a28981419a0ccf"
+  integrity sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==
+
 util@^0.12.4:
   version "0.12.5"
   resolved "https://registry.yarnpkg.com/util/-/util-0.12.5.tgz#5f17a6059b73db61a875668781a1c2b136bd6fbc"
@@ -8032,6 +8402,11 @@ yargs-parser@20.x, yargs-parser@^20.2.2:
   resolved "https://registry.npmjs.org/yargs-parser/-/yargs-parser-20.2.9.tgz"
   integrity sha512-y11nGElTIV+CT3Zv9t7VKl+Q3hTQoT9a1Qzezhhl6Rp21gJ/IVTW7Z3y9EWXhuUBC2Shnf+DX0antecpAwSP8w==
 
+yargs-parser@^21.1.1:
+  version "21.1.1"
+  resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-21.1.1.tgz#9096bceebf990d21bb31fa9516e0ede294a77d35"
+  integrity sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==
+
 yargs@^16.2.0:
   version "16.2.0"
   resolved "https://registry.npmjs.org/yargs/-/yargs-16.2.0.tgz"
@@ -8045,6 +8420,19 @@ yargs@^16.2.0:
     y18n "^5.0.5"
     yargs-parser "^20.2.2"
 
+yargs@^17.7.2:
+  version "17.7.2"
+  resolved "https://registry.yarnpkg.com/yargs/-/yargs-17.7.2.tgz#991df39aca675a192b816e1e0363f9d75d2aa269"
+  integrity sha512-7dSzzRQ++CKnNI/krKnYRV7JKKPUXMEh61soaHKg9mrWEhzFWhFnxPxGl+69cD1Ou63C13NUPCnmIcrvqCuM6w==
+  dependencies:
+    cliui "^8.0.1"
+    escalade "^3.1.1"
+    get-caller-file "^2.0.5"
+    require-directory "^2.1.1"
+    string-width "^4.2.3"
+    y18n "^5.0.5"
+    yargs-parser "^21.1.1"
+
 yarn-audit-fix@^9.3.8:
   version "9.3.12"
   resolved "https://registry.yarnpkg.com/yarn-audit-fix/-/yarn-audit-fix-9.3.12.tgz#cc34e87aa080bace32f2f105be6b581a3cb6eb24"