fchek 1.0.0

package/lib/launch.js

@@ -0,0 +1,182 @@
+'use strict';
+
+/**
+ * launch.js — start an application and wait for its window to appear
+ *
+ * Solves the problem: "did the app actually open and is the UI showing?"
+ * Returns PID, window title, position when the window is ready.
+ * Agent can then take a screenshot to verify UI state.
+ */
+
+const { spawnSync, spawn } = require('child_process');
+const path = require('path');
+const fs   = require('fs');
+const { output, ok, fail } = require('./output');
+
+const HELP = `
+fchek launch <exe> [--wait=<ms>] [--title=<partial>] [--args=<args>] [--kill-existing]
+
+Launch an application and wait for its window to appear.
+Use before fchek screenshot to verify the app started correctly.
+
+Options:
+  --wait=5000        Max wait time for window in ms (default: 10000)
+  --title=<text>     Window title to wait for (default: exe basename)
+  --args=<args>      Arguments to pass to the executable
+  --kill-existing    Kill existing instances before launching
+
+Examples:
+  fchek launch bin/Vertex.exe
+  fchek launch bin/Vertex.exe --title=SpotlightWindow --wait=8000
+  fchek launch "C:/App/App.exe" --kill-existing
+`.trim();
+
+function runPowerShell(script, timeoutMs = 20000) {
+  return spawnSync('powershell', [
+    '-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-Command', script,
+  ], { encoding: 'utf8', timeout: timeoutMs, windowsHide: false });
+}
+
+async function run(args) {
+  if (args.length === 0 || args[0] === '--help') { console.log(HELP); return; }
+
+  if (process.platform !== 'win32') {
+    return output(fail('fchek launch is Windows-only.'));
+  }
+
+  const exePath     = args[0];
+  const waitMs      = parseInt((args.find(a => a.startsWith('--wait='))  || '--wait=10000').replace('--wait=', ''), 10);
+  const titleHint   = (args.find(a => a.startsWith('--title=')) || '').replace('--title=', '') ||
+                      path.basename(exePath, path.extname(exePath));
+  const exeArgs     = (args.find(a => a.startsWith('--args=')) || '').replace('--args=', '') || '';
+  const killExisting = args.includes('--kill-existing');
+
+  if (!fs.existsSync(exePath)) {
+    return output(fail(`Executable not found: ${exePath}`));
+  }
+
+  const absExe = path.resolve(exePath);
+
+  const script = `
+Add-Type @"
+using System;
+using System.Runtime.InteropServices;
+using System.Drawing;
+public class WinCheck {
+    [DllImport("user32.dll")] public static extern bool GetWindowRect(IntPtr hwnd, out RECT rect);
+    [DllImport("user32.dll")] public static extern bool IsWindowVisible(IntPtr hwnd);
+    public struct RECT { public int Left, Top, Right, Bottom; }
+}
+"@
+
+${killExisting ? `
+# Kill existing instances
+$exeName = [System.IO.Path]::GetFileNameWithoutExtension(${JSON.stringify(absExe)})
+Get-Process -Name $exeName -ErrorAction SilentlyContinue | Stop-Process -Force
+Start-Sleep -Milliseconds 500
+` : ''}
+
+# Start the process
+$psi = New-Object System.Diagnostics.ProcessStartInfo
+$psi.FileName  = ${JSON.stringify(absExe)}
+$psi.Arguments = ${JSON.stringify(exeArgs)}
+$psi.UseShellExecute = $true
+$proc = [System.Diagnostics.Process]::Start($psi)
+
+if ($null -eq $proc) {
+    Write-Output '{"launched":false,"error":"Failed to start process"}'
+    exit 0
+}
+
+$pid    = $proc.Id
+$waitMs = ${waitMs}
+$step   = 200
+$elapsed = 0
+$windowTitle = ""
+$windowFound = $false
+
+while ($elapsed -lt $waitMs) {
+    Start-Sleep -Milliseconds $step
+    $elapsed += $step
+
+    try { $proc.Refresh() } catch {}
+
+    # Check if process is still running
+    if ($proc.HasExited) {
+        Write-Output ('{"launched":true,"pid":' + $pid + ',"window_appeared":false,"error":"Process exited with code ' + $proc.ExitCode + '","elapsed_ms":' + $elapsed + '}')
+        exit 0
+    }
+
+    # Check for window
+    try {
+        $hwnd = $proc.MainWindowHandle
+        if ($hwnd -ne [IntPtr]::Zero) {
+            $title = $proc.MainWindowTitle
+            if ([string]::IsNullOrEmpty(${JSON.stringify(titleHint)}) -or $title -match [regex]::Escape(${JSON.stringify(titleHint)})) {
+                $rect = New-Object WinCheck+RECT
+                [WinCheck]::GetWindowRect($hwnd, [ref]$rect) | Out-Null
+                $w = $rect.Right  - $rect.Left
+                $h = $rect.Bottom - $rect.Top
+                $windowTitle = $title
+                $windowFound = $true
+                Write-Output ('{"launched":true,"pid":' + $pid + ',"window_appeared":true,"window_title":"' + $title.Replace('"','\"') + '","x":' + $rect.Left + ',"y":' + $rect.Top + ',"width":' + $w + ',"height":' + $h + ',"elapsed_ms":' + $elapsed + '}')
+                exit 0
+            }
+        }
+    } catch {}
+
+    # Also search all processes for matching window title
+    $matching = Get-Process -ErrorAction SilentlyContinue | Where-Object {
+        $_.MainWindowTitle -match [regex]::Escape(${JSON.stringify(titleHint)}) -and $_.MainWindowHandle -ne [IntPtr]::Zero
+    }
+    if ($matching) {
+        $m = $matching[0]
+        $rect = New-Object WinCheck+RECT
+        [WinCheck]::GetWindowRect($m.MainWindowHandle, [ref]$rect) | Out-Null
+        $w = $rect.Right  - $rect.Left
+        $h = $rect.Bottom - $rect.Top
+        Write-Output ('{"launched":true,"pid":' + $m.Id + ',"window_appeared":true,"window_title":"' + $m.MainWindowTitle.Replace('"','\"') + '","x":' + $rect.Left + ',"y":' + $rect.Top + ',"width":' + $w + ',"height":' + $h + ',"elapsed_ms":' + $elapsed + '}')
+        exit 0
+    }
+}
+
+# Timed out — window didn't appear
+Write-Output ('{"launched":true,"pid":' + $pid + ',"window_appeared":false,"error":"Window did not appear within ' + $waitMs + 'ms","elapsed_ms":' + $elapsed + '}')
+`;
+
+  const res = runPowerShell(script, waitMs + 10000);
+
+  if (res.error) {
+    return output(fail(`PowerShell error: ${res.error.message}`));
+  }
+
+  const jsonLine = (res.stdout || '').split('\n').map(l => l.trim()).find(l => l.startsWith('{'));
+
+  if (!jsonLine) {
+    return output(fail(`launch output error: ${(res.stderr || res.stdout || '').slice(0, 500)}`));
+  }
+
+  let data;
+  try { data = JSON.parse(jsonLine); }
+  catch { return output(fail(`parse error: ${jsonLine.slice(0, 200)}`)); }
+
+  if (data.error && !data.launched) {
+    return output(fail(data.error));
+  }
+
+  output(ok({
+    exe:             absExe,
+    launched:        data.launched,
+    pid:             data.pid,
+    window_appeared: data.window_appeared,
+    window_title:    data.window_title || null,
+    position:        data.x != null ? { x: data.x, y: data.y, width: data.width, height: data.height } : null,
+    elapsed_ms:      data.elapsed_ms,
+    error:           data.error || null,
+    next_step:       data.window_appeared
+      ? `Window is visible. Run: fchek screenshot --window="${data.window_title || titleHint}"`
+      : 'Window did not appear. Check fchek winlog for errors.',
+  }));
+}
+
+module.exports = { run };