jdi-cli 0.1.0

package/bin/jdi-install-playwright.ps1

@@ -0,0 +1,319 @@
+<#
+.SYNOPSIS
+  jdi-install-playwright (Windows): installs Playwright dev dep + chromium browser
+  + injects Playwright MCP config in detected runtime configs.
+
+.DESCRIPTION
+  Optional install. Adds:
+   - @playwright/test as devDependency (via detected pkg manager: pnpm > yarn > npm)
+   - chromium browser via `npx playwright install chromium`
+   - MCP server config in:
+     * .claude/settings.local.json     (Claude Code)
+     * .opencode/opencode.jsonc        (OpenCode)
+   Copilot has no MCP; skip with warn.
+   Antigravity MCP support unverified; skip with warn.
+
+  Idempotent: if @playwright/test already present, skips dep install.
+  If MCP config already has playwright entry, skips injection.
+
+.PARAMETER SkipBrowser
+  Skip `npx playwright install chromium`. Use if browser already installed.
+
+.PARAMETER SkipMcp
+  Skip MCP config injection. Only install dep + browser.
+
+.PARAMETER Runtime
+  Force MCP injection only into this runtime. Default: detect all present.
+  Values: claude | opencode | copilot | antigravity | all
+
+.PARAMETER AntigravityScope
+  Antigravity MCP scope: user (~/.gemini/settings.json) or project (.gemini/settings.json).
+  Default: user
+
+.EXAMPLE
+  .\bin\jdi-install-playwright.ps1
+  .\bin\jdi-install-playwright.ps1 -SkipBrowser
+  .\bin\jdi-install-playwright.ps1 -Runtime claude
+  .\bin\jdi-install-playwright.ps1 -Runtime all -AntigravityScope project
+#>
+[CmdletBinding()]
+param(
+  [switch]$SkipBrowser,
+  [switch]$SkipMcp,
+  [ValidateSet('claude','opencode','copilot','antigravity','all')]
+  [string]$Runtime = 'all',
+  [ValidateSet('user','project')]
+  [string]$AntigravityScope = 'user'
+)
+
+$ErrorActionPreference = 'Stop'
+$ProjectDir = (Get-Location).Path
+
+function Detect-PackageManager {
+  if (Test-Path (Join-Path $ProjectDir 'pnpm-lock.yaml')) { return 'pnpm' }
+  if (Test-Path (Join-Path $ProjectDir 'yarn.lock'))      { return 'yarn' }
+  if (Test-Path (Join-Path $ProjectDir 'bun.lockb'))      { return 'bun' }
+  return 'npm'
+}
+
+function Has-PlaywrightDep {
+  $pkg = Join-Path $ProjectDir 'package.json'
+  if (-not (Test-Path $pkg)) { return $false }
+  $json = Get-Content $pkg -Raw | ConvertFrom-Json
+  $deps = @{}
+  if ($json.dependencies)    { $json.dependencies.PSObject.Properties    | ForEach-Object { $deps[$_.Name] = $_.Value } }
+  if ($json.devDependencies) { $json.devDependencies.PSObject.Properties | ForEach-Object { $deps[$_.Name] = $_.Value } }
+  return $deps.ContainsKey('@playwright/test')
+}
+
+function Install-PlaywrightDep {
+  if (Has-PlaywrightDep) {
+    Write-Host "  [skip] @playwright/test already in package.json"
+    return $true
+  }
+
+  if (-not (Test-Path (Join-Path $ProjectDir 'package.json'))) {
+    Write-Warning "package.json not found. Run 'npm init -y' first or this command outside a JS/TS project."
+    return $false
+  }
+
+  $pm = Detect-PackageManager
+  Write-Host "  Installing @playwright/test via $pm..."
+
+  switch ($pm) {
+    'pnpm' { & pnpm add -D '@playwright/test' }
+    'yarn' { & yarn add -D '@playwright/test' }
+    'bun'  { & bun add -d '@playwright/test' }
+    default { & npm install --save-dev '@playwright/test' }
+  }
+
+  return ($LASTEXITCODE -eq 0)
+}
+
+function Install-ChromiumBrowser {
+  if ($SkipBrowser) {
+    Write-Host "  [skip] -SkipBrowser flag set"
+    return $true
+  }
+  Write-Host "  Installing chromium browser (~170MB, may take a minute)..."
+  & npx --yes playwright install chromium
+  return ($LASTEXITCODE -eq 0)
+}
+
+function Inject-ClaudeMcp {
+  $claudeDir = Join-Path $ProjectDir '.claude'
+  if (-not (Test-Path $claudeDir)) {
+    Write-Host "  [skip] .claude/ not present (Claude Code not installed)"
+    return
+  }
+
+  $settingsPath = Join-Path $claudeDir 'settings.local.json'
+  $settings = @{}
+
+  if (Test-Path $settingsPath) {
+    try {
+      $raw = Get-Content $settingsPath -Raw
+      $parsed = $raw | ConvertFrom-Json
+      $parsed.PSObject.Properties | ForEach-Object { $settings[$_.Name] = $_.Value }
+    } catch {
+      Write-Warning "  Existing $settingsPath is not valid JSON; skipping injection."
+      return
+    }
+  }
+
+  if (-not $settings.ContainsKey('mcpServers')) { $settings['mcpServers'] = @{} }
+  $mcp = @{}
+  if ($settings['mcpServers'] -is [psobject]) {
+    $settings['mcpServers'].PSObject.Properties | ForEach-Object { $mcp[$_.Name] = $_.Value }
+  } elseif ($settings['mcpServers'] -is [hashtable]) {
+    $mcp = $settings['mcpServers']
+  }
+
+  if ($mcp.ContainsKey('playwright')) {
+    Write-Host "  [skip] mcpServers.playwright already present in settings.local.json"
+    return
+  }
+
+  $mcp['playwright'] = @{
+    command = 'npx'
+    args    = @('-y', '@playwright/mcp@latest')
+  }
+  $settings['mcpServers'] = $mcp
+
+  $json = $settings | ConvertTo-Json -Depth 8
+  $json | Out-File -FilePath $settingsPath -Encoding UTF8 -NoNewline
+  Write-Host "  -> wrote .claude/settings.local.json (mcpServers.playwright)"
+}
+
+function Inject-OpencodeMcp {
+  $ocDir = Join-Path $ProjectDir '.opencode'
+  if (-not (Test-Path $ocDir)) {
+    Write-Host "  [skip] .opencode/ not present (OpenCode not installed)"
+    return
+  }
+
+  $configPath = Join-Path $ocDir 'opencode.jsonc'
+  $raw = ''
+  if (Test-Path $configPath) {
+    $raw = Get-Content $configPath -Raw
+    if ($raw -match '"playwright"\s*:') {
+      Write-Host "  [skip] mcp.playwright already present in opencode.jsonc"
+      return
+    }
+  } else {
+    $raw = "// OpenCode config - JDI managed `n{`n  `"`$schema`": `"https://opencode.ai/config.json`"`n}`n"
+  }
+
+  # Strip comments for parse, keep header for re-emit
+  $stripped = ($raw -replace '(?m)^\s*//.*$','') -replace '/\*[\s\S]*?\*/',''
+  try {
+    $parsed = $stripped | ConvertFrom-Json
+  } catch {
+    Write-Warning "  Existing opencode.jsonc is not parseable; skipping injection."
+    return
+  }
+
+  $obj = @{}
+  $parsed.PSObject.Properties | ForEach-Object { $obj[$_.Name] = $_.Value }
+
+  if (-not $obj.ContainsKey('mcp')) { $obj['mcp'] = @{} }
+  $mcp = @{}
+  if ($obj['mcp'] -is [psobject]) {
+    $obj['mcp'].PSObject.Properties | ForEach-Object { $mcp[$_.Name] = $_.Value }
+  } elseif ($obj['mcp'] -is [hashtable]) {
+    $mcp = $obj['mcp']
+  }
+
+  $mcp['playwright'] = @{
+    type    = 'local'
+    command = @('npx', '-y', '@playwright/mcp@latest')
+    enabled = $true
+  }
+  $obj['mcp'] = $mcp
+
+  $newJson = $obj | ConvertTo-Json -Depth 8
+  $header = "// OpenCode config - JDI managed (mcp.playwright managed; rest is yours)`n"
+  $output = $header + $newJson + "`n"
+  $output | Out-File -FilePath $configPath -Encoding UTF8 -NoNewline
+  Write-Host "  -> wrote .opencode/opencode.jsonc (mcp.playwright)"
+}
+
+function Inject-CopilotMcp {
+  # Copilot MCP via VS Code workspace: .vscode/mcp.json
+  $vscodeDir = Join-Path $ProjectDir '.vscode'
+  $f = Join-Path $vscodeDir 'mcp.json'
+
+  if ((Test-Path $f) -and ((Get-Content $f -Raw) -match '"playwright"\s*:')) {
+    Write-Host "  [skip] servers.playwright already present in .vscode/mcp.json"
+    return
+  }
+
+  New-Item -ItemType Directory -Force -Path $vscodeDir | Out-Null
+
+  $settings = @{}
+  if (Test-Path $f) {
+    try {
+      $parsed = Get-Content $f -Raw | ConvertFrom-Json
+      $parsed.PSObject.Properties | ForEach-Object { $settings[$_.Name] = $_.Value }
+    } catch {
+      Write-Warning "  Existing .vscode/mcp.json not valid JSON; skipping."
+      return
+    }
+  }
+
+  if (-not $settings.ContainsKey('servers')) { $settings['servers'] = @{} }
+  $servers = @{}
+  if ($settings['servers'] -is [psobject]) {
+    $settings['servers'].PSObject.Properties | ForEach-Object { $servers[$_.Name] = $_.Value }
+  } elseif ($settings['servers'] -is [hashtable]) {
+    $servers = $settings['servers']
+  }
+
+  $servers['playwright'] = @{
+    command = 'npx'
+    args    = @('-y', '@playwright/mcp@latest')
+  }
+  $settings['servers'] = $servers
+
+  ($settings | ConvertTo-Json -Depth 8) | Out-File -FilePath $f -Encoding UTF8 -NoNewline
+  Write-Host "  -> wrote .vscode/mcp.json (servers.playwright) for Copilot"
+}
+
+function Inject-AntigravityMcp {
+  $base = if ($AntigravityScope -eq 'user') { Join-Path $UserHome '.gemini' } else { Join-Path $ProjectDir '.gemini' }
+  $f = Join-Path $base 'settings.json'
+
+  if ((Test-Path $f) -and ((Get-Content $f -Raw) -match '"playwright"\s*:')) {
+    Write-Host "  [skip] mcpServers.playwright already present in $f"
+    return
+  }
+
+  New-Item -ItemType Directory -Force -Path $base | Out-Null
+
+  $settings = @{}
+  if (Test-Path $f) {
+    try {
+      $parsed = Get-Content $f -Raw | ConvertFrom-Json
+      $parsed.PSObject.Properties | ForEach-Object { $settings[$_.Name] = $_.Value }
+    } catch {
+      Write-Warning "  Existing $f not valid JSON; skipping."
+      return
+    }
+  }
+
+  if (-not $settings.ContainsKey('mcpServers')) { $settings['mcpServers'] = @{} }
+  $mcp = @{}
+  if ($settings['mcpServers'] -is [psobject]) {
+    $settings['mcpServers'].PSObject.Properties | ForEach-Object { $mcp[$_.Name] = $_.Value }
+  } elseif ($settings['mcpServers'] -is [hashtable]) {
+    $mcp = $settings['mcpServers']
+  }
+
+  $mcp['playwright'] = @{
+    command = 'npx'
+    args    = @('-y', '@playwright/mcp@latest')
+  }
+  $settings['mcpServers'] = $mcp
+
+  ($settings | ConvertTo-Json -Depth 8) | Out-File -FilePath $f -Encoding UTF8 -NoNewline
+  Write-Host "  -> wrote $f (mcpServers.playwright) for Antigravity"
+}
+
+# =====================================================================
+# Main
+# =====================================================================
+
+Write-Host ''
+Write-Host '=== JDI: Install Playwright + MCP ==='
+Write-Host ''
+
+Write-Host 'Step 1: Install dep'
+$depOk = Install-PlaywrightDep
+if (-not $depOk) {
+  Write-Error "Dep install failed. Aborting."
+  exit 1
+}
+
+Write-Host ''
+Write-Host 'Step 2: Install browser'
+$bOk = Install-ChromiumBrowser
+if (-not $bOk) {
+  Write-Warning "Browser install failed. You can rerun later: 'npx playwright install chromium'"
+}
+
+if (-not $SkipMcp) {
+  Write-Host ''
+  Write-Host 'Step 3: Inject MCP config in detected runtimes'
+  if ($Runtime -in 'claude','all')      { Inject-ClaudeMcp }
+  if ($Runtime -in 'opencode','all')    { Inject-OpencodeMcp }
+  if ($Runtime -in 'copilot','all')     { Inject-CopilotMcp }
+  if ($Runtime -in 'antigravity','all') { Inject-AntigravityMcp }
+}
+
+Write-Host ''
+Write-Host 'Done. Restart your runtime to pick up MCP changes.'
+Write-Host '  - Claude Code: close + reopen, OR run /mcp to verify'
+Write-Host '  - OpenCode: opencode reload'
+Write-Host '  - Copilot (VS Code): reload window, palette `MCP: List Servers`'
+Write-Host '  - Antigravity: restart antigravity'
+Write-Host ''

package/bin/jdi-install-playwright.sh

@@ -0,0 +1,284 @@
+#!/usr/bin/env bash
+# jdi-install-playwright (POSIX): installs Playwright dev dep + chromium browser
+# + injects Playwright MCP config in detected runtime configs.
+#
+# Optional install. Idempotent.
+#
+# Usage:
+#   ./bin/jdi-install-playwright.sh
+#   ./bin/jdi-install-playwright.sh --skip-browser
+#   ./bin/jdi-install-playwright.sh --runtime claude
+#
+# Flags:
+#   --skip-browser            Skip `npx playwright install chromium`
+#   --skip-mcp                Skip MCP config injection (only dep + browser)
+#   --runtime <r>             claude | opencode | copilot | antigravity | all (default: all)
+#   --antigravity-scope <s>   user (default) | project
+
+set -euo pipefail
+
+PROJECT_DIR="$(pwd)"
+USER_HOME="${HOME:-$USERPROFILE}"
+SKIP_BROWSER=0
+SKIP_MCP=0
+RUNTIME=all
+AG_SCOPE=user
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --skip-browser)      SKIP_BROWSER=1; shift ;;
+    --skip-mcp)          SKIP_MCP=1; shift ;;
+    --runtime)           RUNTIME="$2"; shift 2 ;;
+    --antigravity-scope) AG_SCOPE="$2"; shift 2 ;;
+    *) echo "Unknown flag: $1"; exit 1 ;;
+  esac
+done
+
+case "$RUNTIME" in
+  claude|opencode|copilot|antigravity|all) ;;
+  *) echo "Invalid --runtime. Use: claude | opencode | copilot | antigravity | all"; exit 1 ;;
+esac
+
+case "$AG_SCOPE" in
+  user|project) ;;
+  *) echo "Invalid --antigravity-scope. Use: user | project"; exit 1 ;;
+esac
+
+detect_pm() {
+  if [ -f "$PROJECT_DIR/pnpm-lock.yaml" ]; then echo pnpm
+  elif [ -f "$PROJECT_DIR/yarn.lock" ];     then echo yarn
+  elif [ -f "$PROJECT_DIR/bun.lockb" ];     then echo bun
+  else echo npm
+  fi
+}
+
+has_pw_dep() {
+  local pkg="$PROJECT_DIR/package.json"
+  [ -f "$pkg" ] || { echo 0; return; }
+  if grep -qE '"@playwright/test"' "$pkg"; then echo 1; else echo 0; fi
+}
+
+install_pw_dep() {
+  if [ "$(has_pw_dep)" = "1" ]; then
+    echo "  [skip] @playwright/test already in package.json"
+    return 0
+  fi
+  if [ ! -f "$PROJECT_DIR/package.json" ]; then
+    echo "  [warn] package.json not found. Run 'npm init -y' first."
+    return 1
+  fi
+
+  local pm
+  pm="$(detect_pm)"
+  echo "  Installing @playwright/test via $pm..."
+
+  case "$pm" in
+    pnpm) pnpm add -D @playwright/test ;;
+    yarn) yarn add -D @playwright/test ;;
+    bun)  bun add -d @playwright/test ;;
+    *)    npm install --save-dev @playwright/test ;;
+  esac
+}
+
+install_chromium() {
+  if [ "$SKIP_BROWSER" = "1" ]; then
+    echo "  [skip] --skip-browser flag set"
+    return 0
+  fi
+  echo "  Installing chromium browser (~170MB, may take a minute)..."
+  npx --yes playwright install chromium || {
+    echo "  [warn] chromium install failed. Rerun later: npx playwright install chromium"
+    return 0
+  }
+}
+
+inject_claude_mcp() {
+  local dir="$PROJECT_DIR/.claude"
+  if [ ! -d "$dir" ]; then
+    echo "  [skip] .claude/ not present (Claude Code not installed)"
+    return
+  fi
+
+  local f="$dir/settings.local.json"
+  if [ -f "$f" ] && grep -qE '"playwright"\s*:' "$f"; then
+    echo "  [skip] mcpServers.playwright already present in settings.local.json"
+    return
+  fi
+
+  if ! command -v node >/dev/null 2>&1; then
+    echo "  [warn] node not in PATH; cannot edit JSON safely"
+    return
+  fi
+
+  node - <<'NODE_EOF'
+const fs = require('fs');
+const path = require('path');
+const f = path.join(process.cwd(), '.claude', 'settings.local.json');
+let s = {};
+if (fs.existsSync(f)) {
+  try { s = JSON.parse(fs.readFileSync(f, 'utf8')); }
+  catch { console.log('  [warn] settings.local.json invalid JSON; skip'); process.exit(0); }
+}
+s.mcpServers = s.mcpServers || {};
+if (s.mcpServers.playwright) {
+  console.log('  [skip] mcpServers.playwright already present');
+  process.exit(0);
+}
+s.mcpServers.playwright = {
+  command: 'npx',
+  args: ['-y', '@playwright/mcp@latest']
+};
+fs.writeFileSync(f, JSON.stringify(s, null, 2) + '\n');
+console.log('  -> wrote .claude/settings.local.json (mcpServers.playwright)');
+NODE_EOF
+}
+
+inject_opencode_mcp() {
+  local dir="$PROJECT_DIR/.opencode"
+  if [ ! -d "$dir" ]; then
+    echo "  [skip] .opencode/ not present (OpenCode not installed)"
+    return
+  fi
+
+  if ! command -v node >/dev/null 2>&1; then
+    echo "  [warn] node not in PATH; cannot edit JSONC safely"
+    return
+  fi
+
+  node - <<'NODE_EOF'
+const fs = require('fs');
+const path = require('path');
+const f = path.join(process.cwd(), '.opencode', 'opencode.jsonc');
+let raw = '';
+if (fs.existsSync(f)) {
+  raw = fs.readFileSync(f, 'utf8');
+  if (/"playwright"\s*:/.test(raw)) {
+    console.log('  [skip] mcp.playwright already present in opencode.jsonc');
+    process.exit(0);
+  }
+} else {
+  raw = '// OpenCode config - JDI managed\n{\n  "$schema": "https://opencode.ai/config.json"\n}\n';
+}
+const stripped = raw.replace(/^\s*\/\/.*$/gm, '').replace(/\/\*[\s\S]*?\*\//g, '');
+let obj;
+try { obj = JSON.parse(stripped); }
+catch { console.log('  [warn] opencode.jsonc not parseable; skip'); process.exit(0); }
+obj.mcp = obj.mcp || {};
+obj.mcp.playwright = {
+  type: 'local',
+  command: ['npx', '-y', '@playwright/mcp@latest'],
+  enabled: true
+};
+const header = '// OpenCode config - JDI managed (mcp.playwright managed; rest is yours)\n';
+fs.writeFileSync(f, header + JSON.stringify(obj, null, 2) + '\n');
+console.log('  -> wrote .opencode/opencode.jsonc (mcp.playwright)');
+NODE_EOF
+}
+
+inject_copilot_mcp() {
+  local vscode_dir="$PROJECT_DIR/.vscode"
+  local f="$vscode_dir/mcp.json"
+
+  if [ -f "$f" ] && grep -q '"playwright"' "$f" 2>/dev/null; then
+    echo "  [skip] servers.playwright already present in .vscode/mcp.json"
+    return
+  fi
+
+  mkdir -p "$vscode_dir"
+
+  if ! command -v node >/dev/null 2>&1; then
+    echo "  [warn] node not in PATH; cannot edit JSON safely"
+    return
+  fi
+
+  node - <<'NODE_EOF'
+const fs = require('fs');
+const path = require('path');
+const f = path.join(process.cwd(), '.vscode', 'mcp.json');
+let s = {};
+if (fs.existsSync(f)) {
+  try { s = JSON.parse(fs.readFileSync(f, 'utf8')); }
+  catch { console.log('  [warn] mcp.json invalid JSON; skip'); process.exit(0); }
+}
+s.servers = s.servers || {};
+if (s.servers.playwright) {
+  console.log('  [skip] servers.playwright already present');
+  process.exit(0);
+}
+s.servers.playwright = { command: 'npx', args: ['-y', '@playwright/mcp@latest'] };
+fs.writeFileSync(f, JSON.stringify(s, null, 2) + '\n');
+console.log('  -> wrote .vscode/mcp.json (servers.playwright) for Copilot');
+NODE_EOF
+}
+
+inject_antigravity_mcp() {
+  local base
+  if [ "$AG_SCOPE" = "user" ]; then
+    base="$USER_HOME/.gemini"
+  else
+    base="$PROJECT_DIR/.gemini"
+  fi
+  local f="$base/settings.json"
+
+  if [ -f "$f" ] && grep -q '"playwright"' "$f" 2>/dev/null; then
+    echo "  [skip] mcpServers.playwright already present in $f"
+    return
+  fi
+
+  mkdir -p "$base"
+
+  if ! command -v node >/dev/null 2>&1; then
+    echo "  [warn] node not in PATH; cannot edit JSON safely"
+    return
+  fi
+
+  AG_FILE="$f" node - <<'NODE_EOF'
+const fs = require('fs');
+const f = process.env.AG_FILE;
+let s = {};
+if (fs.existsSync(f)) {
+  try { s = JSON.parse(fs.readFileSync(f, 'utf8')); }
+  catch { console.log('  [warn] settings.json invalid JSON; skip'); process.exit(0); }
+}
+s.mcpServers = s.mcpServers || {};
+if (s.mcpServers.playwright) {
+  console.log('  [skip] mcpServers.playwright already present');
+  process.exit(0);
+}
+s.mcpServers.playwright = { command: 'npx', args: ['-y', '@playwright/mcp@latest'] };
+fs.writeFileSync(f, JSON.stringify(s, null, 2) + '\n');
+console.log('  -> wrote ' + f + ' (mcpServers.playwright) for Antigravity');
+NODE_EOF
+}
+
+# =====================================================================
+# Main
+# =====================================================================
+
+echo ""
+echo "=== JDI: Install Playwright + MCP ==="
+echo ""
+
+echo "Step 1: Install dep"
+install_pw_dep || { echo "Dep install failed. Aborting."; exit 1; }
+
+echo ""
+echo "Step 2: Install browser"
+install_chromium
+
+if [ "$SKIP_MCP" != "1" ]; then
+  echo ""
+  echo "Step 3: Inject MCP config in detected runtimes"
+  if [ "$RUNTIME" = "claude" ]      || [ "$RUNTIME" = "all" ]; then inject_claude_mcp; fi
+  if [ "$RUNTIME" = "opencode" ]    || [ "$RUNTIME" = "all" ]; then inject_opencode_mcp; fi
+  if [ "$RUNTIME" = "copilot" ]     || [ "$RUNTIME" = "all" ]; then inject_copilot_mcp; fi
+  if [ "$RUNTIME" = "antigravity" ] || [ "$RUNTIME" = "all" ]; then inject_antigravity_mcp; fi
+fi
+
+echo ""
+echo "Done. Restart your runtime to pick up MCP changes."
+echo "  - Claude Code: close + reopen, OR run /mcp to verify"
+echo "  - OpenCode: opencode reload"
+echo "  - Copilot (VS Code): reload window, palette 'MCP: List Servers'"
+echo "  - Antigravity: restart antigravity"
+echo ""