@telora/daemon 0.12.33

package/dist/qa-dev-server.js

@@ -0,0 +1,279 @@
+/**
+ * QA dev server spawn and health monitoring.
+ *
+ * Manages the lifecycle of Vite dev servers in QA worktrees:
+ * runs npm install, spawns `npm run dev` on an allocated port,
+ * streams stdout/stderr to log files, and provides stop/health helpers.
+ */
+import { spawn, execFileSync } from 'node:child_process';
+import { mkdirSync, existsSync, createWriteStream, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+// ── Internal state ───────────────────────────────────────────────────
+/**
+ * Track spawned child processes so stopQaDevServer can reference them.
+ * Keyed by PID.
+ */
+const activeProcesses = new Map();
+// ── Constants ────────────────────────────────────────────────────────
+/** Grace period in ms to wait for SIGTERM before escalating to SIGKILL. */
+const STOP_GRACE_PERIOD_MS = 5000;
+// ── Public API ───────────────────────────────────────────────────────
+/**
+ * Install dependencies and spawn a dev server in a QA worktree.
+ *
+ * 1. Runs `npm install` synchronously in the worktree.
+ * 2. Spawns `npm run dev` with `PORT` env var set to the allocated port.
+ * 3. Pipes stdout/stderr to log files under `{logDir}/qa-{strategyId-prefix}/`.
+ * 4. Registers an on-exit handler that calls `onUnexpectedExit` if the
+ *    process exits without an intentional stop.
+ *
+ * @returns The child process PID and log file paths.
+ * @throws If npm install fails or the dev server process cannot be spawned.
+ */
+export function startQaDevServer(options) {
+    const { config, strategyId, worktreePath, port, onUnexpectedExit } = options;
+    // ── 1. Run npm install ───────────────────────────────────────────
+    console.log(`[qa-dev-server] Running npm install in ${worktreePath}...`);
+    try {
+        execFileSync('npm', ['install'], {
+            cwd: worktreePath,
+            stdio: 'pipe',
+            timeout: 300_000, // 5 min timeout for install
+        });
+        console.log(`[qa-dev-server] npm install completed.`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`npm install failed in QA worktree: ${message}`);
+    }
+    // ── 2. Prepare log directory and files ───────────────────────────
+    const logSubDir = join(config.logDir, 'qa-' + strategyId.slice(0, 8));
+    if (!existsSync(logSubDir)) {
+        mkdirSync(logSubDir, { recursive: true, mode: 0o700 });
+    }
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const stdoutPath = join(logSubDir, `dev-server-${timestamp}.stdout.log`);
+    const stderrPath = join(logSubDir, `dev-server-${timestamp}.stderr.log`);
+    const stdoutStream = createWriteStream(stdoutPath, { mode: 0o600 });
+    const stderrStream = createWriteStream(stderrPath, { mode: 0o600 });
+    // ── 3. Build QA Supabase env overrides ──────────────────────────
+    // The browser running in a remote QA session needs to reach the local
+    // Supabase instance via the daemon host's LAN IP, not 127.0.0.1.
+    // Replace the host portion of localSupabaseUrl with config.qaHost.
+    const qaSupabaseUrl = buildQaSupabaseUrl(config.localSupabaseUrl, config.qaHost);
+    const spawnEnv = {
+        ...process.env,
+        VITE_LOCAL_SUPABASE_URL: qaSupabaseUrl,
+        VITE_USE_LOCAL_SUPABASE: 'true',
+    };
+    if (config.localSupabaseAnonKey) {
+        spawnEnv.VITE_LOCAL_SUPABASE_ANON_KEY = config.localSupabaseAnonKey;
+    }
+    console.log(`[qa-dev-server] QA Supabase URL: ${qaSupabaseUrl}`);
+    // ── 4. Spawn dev server ──────────────────────────────────────────
+    const framework = detectFramework(worktreePath);
+    const { command, args, extraEnv } = buildDevServerCommand(framework, port);
+    console.log(`[qa-dev-server] Detected framework: ${framework}. Spawning ${command} ${args.join(' ')} on port ${port} in ${worktreePath}...`);
+    const proc = spawn(command, args, {
+        cwd: worktreePath,
+        env: { ...spawnEnv, ...extraEnv },
+        stdio: ['ignore', 'pipe', 'pipe'],
+        detached: false,
+    });
+    if (!proc.pid) {
+        stdoutStream.destroy();
+        stderrStream.destroy();
+        throw new Error('Failed to spawn dev server process: no PID returned');
+    }
+    const pid = proc.pid;
+    activeProcesses.set(pid, proc);
+    // Pipe output to log files
+    proc.stdout?.pipe(stdoutStream);
+    proc.stderr?.pipe(stderrStream);
+    // ── 5. Set up exit handler ───────────────────────────────────────
+    // Track whether the stop was intentional (via stopQaDevServer)
+    let intentionalStop = false;
+    proc.on('close', (code, signal) => {
+        activeProcesses.delete(pid);
+        stdoutStream.end();
+        stderrStream.end();
+        if (!intentionalStop) {
+            const exitInfo = signal
+                ? `killed by signal ${signal}`
+                : `exited with code ${code ?? 'unknown'}`;
+            const errorMsg = `Dev server process (PID ${pid}) ${exitInfo}`;
+            console.error(`[qa-dev-server] Unexpected exit: ${errorMsg}`);
+            onUnexpectedExit(errorMsg);
+        }
+        else {
+            console.log(`[qa-dev-server] Dev server (PID ${pid}) stopped gracefully.`);
+        }
+    });
+    proc.on('error', (err) => {
+        activeProcesses.delete(pid);
+        stdoutStream.end();
+        stderrStream.end();
+        if (!intentionalStop) {
+            const errorMsg = `Dev server process error: ${err.message}`;
+            console.error(`[qa-dev-server] ${errorMsg}`);
+            onUnexpectedExit(errorMsg);
+        }
+    });
+    // Attach the intentional-stop flag setter to the process object
+    // so stopQaDevServer can mark it before sending signals.
+    proc._qaIntentionalStop = () => {
+        intentionalStop = true;
+    };
+    console.log(`[qa-dev-server] Dev server started (PID ${pid}, port ${port}).`);
+    return { pid, stdoutPath, stderrPath };
+}
+/**
+ * Gracefully stop a running QA dev server.
+ *
+ * Sends SIGTERM first, then escalates to SIGKILL if the process
+ * does not exit within the grace period.
+ */
+export async function stopQaDevServer(pid) {
+    const proc = activeProcesses.get(pid);
+    // Mark as intentional stop if we have the process reference
+    if (proc) {
+        const extended = proc;
+        extended._qaIntentionalStop?.();
+    }
+    // Send SIGTERM
+    if (!isQaDevServerRunning(pid)) {
+        activeProcesses.delete(pid);
+        return;
+    }
+    console.log(`[qa-dev-server] Sending SIGTERM to PID ${pid}...`);
+    try {
+        process.kill(pid, 'SIGTERM');
+    }
+    catch {
+        // Process already gone
+        activeProcesses.delete(pid);
+        return;
+    }
+    // Wait for graceful shutdown
+    const exited = await waitForExit(pid, STOP_GRACE_PERIOD_MS);
+    if (exited) {
+        activeProcesses.delete(pid);
+        return;
+    }
+    // Escalate to SIGKILL
+    console.warn(`[qa-dev-server] PID ${pid} did not exit after SIGTERM, sending SIGKILL...`);
+    try {
+        process.kill(pid, 'SIGKILL');
+    }
+    catch {
+        // Process already gone
+    }
+    activeProcesses.delete(pid);
+}
+/**
+ * Check if a QA dev server process is still alive.
+ *
+ * Uses the `process.kill(pid, 0)` pattern which sends no signal
+ * but throws if the process does not exist.
+ */
+export function isQaDevServerRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ── Helpers ──────────────────────────────────────────────────────────
+/**
+ * Build the browser-accessible Supabase URL for a QA environment.
+ *
+ * The local Supabase typically listens on 127.0.0.1:54321, but the QA
+ * browser is remote (e.g. on a different machine). Replace the host
+ * portion with the daemon's LAN IP (qaHost) so the browser can reach it.
+ */
+export function buildQaSupabaseUrl(localSupabaseUrl, qaHost) {
+    try {
+        const parsed = new URL(localSupabaseUrl);
+        parsed.hostname = qaHost;
+        return parsed.toString().replace(/\/$/, '');
+    }
+    catch {
+        // If parsing fails, fall back to simple replacement
+        return `http://${qaHost}:54321`;
+    }
+}
+/**
+ * Detect the dev framework from the project's package.json.
+ * Checks devDependencies and dependencies for known frameworks.
+ */
+export function detectFramework(worktreePath) {
+    try {
+        const pkgJson = JSON.parse(readFileSync(join(worktreePath, 'package.json'), 'utf-8'));
+        const allDeps = { ...pkgJson.dependencies, ...pkgJson.devDependencies };
+        if (allDeps['next'])
+            return 'nextjs';
+        if (allDeps['vite'])
+            return 'vite';
+        // Check the dev script as a fallback
+        const devScript = pkgJson.scripts?.dev ?? '';
+        if (devScript.includes('next'))
+            return 'nextjs';
+        if (devScript.includes('vite'))
+            return 'vite';
+        return 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/**
+ * Build the spawn command and args for starting a dev server
+ * based on the detected framework.
+ */
+function buildDevServerCommand(framework, port) {
+    switch (framework) {
+        case 'nextjs':
+            // Next.js reads PORT and HOSTNAME env vars since v13
+            return {
+                command: 'npm',
+                args: ['run', 'dev'],
+                extraEnv: { PORT: String(port), HOSTNAME: '0.0.0.0' },
+            };
+        case 'vite':
+            return {
+                command: 'npx',
+                args: ['vite', '--port', String(port), '--host', '0.0.0.0'],
+                extraEnv: {},
+            };
+        default:
+            // Fallback: use npm run dev with PORT env var (most frameworks respect this)
+            return {
+                command: 'npm',
+                args: ['run', 'dev'],
+                extraEnv: { PORT: String(port), HOSTNAME: '0.0.0.0' },
+            };
+    }
+}
+/**
+ * Wait for a process to exit, polling at short intervals.
+ * Returns true if the process exited within the timeout.
+ */
+function waitForExit(pid, timeoutMs) {
+    return new Promise((resolve) => {
+        const startTime = Date.now();
+        const interval = setInterval(() => {
+            if (!isQaDevServerRunning(pid)) {
+                clearInterval(interval);
+                resolve(true);
+                return;
+            }
+            if (Date.now() - startTime >= timeoutMs) {
+                clearInterval(interval);
+                resolve(false);
+            }
+        }, 250);
+    });
+}
+//# sourceMappingURL=qa-dev-server.js.map

package/dist/qa-dev-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-dev-server.js","sourceRoot":"","sources":["../src/qa-dev-server.ts"],"names":[],"mappings":"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"}

package/dist/qa-orchestrator.d.ts

@@ -0,0 +1,79 @@
+/**
+ * QA environment orchestration.
+ *
+ * Called by the daemon poll loop to process pending QA requests.
+ * Coordinates provisioning and teardown using the lower-level modules.
+ */
+import type { DaemonConfig, StrategyWorktreeInfo } from './types.js';
+import type { StartQaDevServerOptions, StartQaDevServerResult } from './qa-dev-server.js';
+import type { QaEnvironmentState, ProductQaEnvironmentState } from './qa-state.js';
+/** Shape of a QA request row from the API query. */
+export interface QaRequest {
+    strategy_id: string;
+    strategy_name: string;
+    qa_status: string;
+    product_id: string;
+}
+/** Shape of a deactivated QA strategy row from the API query. */
+export interface DeactivatedQaStrategy {
+    strategy_id: string;
+    strategy_name: string;
+    qa_status: string;
+    strategy_status: string;
+    product_id: string;
+}
+/** Injectable dependencies for testing. */
+export interface QaOrchestratorDeps {
+    getQaRequests: (productId: string) => Promise<QaRequest[]>;
+    getDeactivatedQaStrategies: (productId: string) => Promise<DeactivatedQaStrategy[]>;
+    updateQaStatus: (strategyId: string, fields: Record<string, unknown>) => Promise<void>;
+    getStrategyWorktree: (strategyId: string) => StrategyWorktreeInfo | undefined;
+    symlinkEnvFiles: (repoPath: string, worktreePath: string) => void;
+    allocatePort: (config: DaemonConfig) => Promise<number>;
+    buildQaUrl: (config: DaemonConfig, port: number) => string;
+    startQaDevServer: (options: StartQaDevServerOptions) => StartQaDevServerResult;
+    stopQaDevServer: (pid: number) => Promise<void>;
+    getQaEnvironment: (strategyId: string) => QaEnvironmentState | undefined;
+    setQaEnvironment: (strategyId: string, state: QaEnvironmentState) => void;
+    removeQaEnvironment: (strategyId: string) => boolean;
+    hasActiveQaEnvironment: (strategyId: string) => boolean;
+}
+/**
+ * Check for and process pending QA requests.
+ * Called each poll cycle from listener.ts.
+ */
+export declare function checkQaRequests(config: DaemonConfig, deps?: QaOrchestratorDeps): Promise<void>;
+/**
+ * Check for strategies that have been deactivated while QA was running.
+ * Tears down any QA environment whose strategy is no longer in 'active' status.
+ * Called each poll cycle from listener.ts.
+ */
+export declare function checkQaForDeactivatedStrategies(config: DaemonConfig, deps?: QaOrchestratorDeps): Promise<void>;
+/** Shape of a product QA request row from the API query. */
+export interface ProductQaRequest {
+    product_id: string;
+    product_name: string;
+    qa_status: string;
+}
+/** Injectable dependencies for product QA testing. */
+export interface ProductQaOrchestratorDeps {
+    getProductQaRequests: (productId: string) => Promise<ProductQaRequest[]>;
+    updateProductQaStatus: (productId: string, fields: Record<string, unknown>) => Promise<void>;
+    createQaWorktree: (config: DaemonConfig, branchName: string, id: string) => string;
+    removeQaWorktree: (repoPath: string, worktreePath: string) => void;
+    symlinkEnvFiles: (repoPath: string, worktreePath: string) => void;
+    allocatePort: (config: DaemonConfig) => Promise<number>;
+    buildQaUrl: (config: DaemonConfig, port: number) => string;
+    startQaDevServer: (options: StartQaDevServerOptions) => StartQaDevServerResult;
+    stopQaDevServer: (pid: number) => Promise<void>;
+    getProductQaEnvironment: (productId: string) => ProductQaEnvironmentState | undefined;
+    setProductQaEnvironment: (productId: string, state: ProductQaEnvironmentState) => void;
+    removeProductQaEnvironment: (productId: string) => boolean;
+    hasActiveProductQaEnvironment: (productId: string) => boolean;
+}
+/**
+ * Check for and process pending product QA requests.
+ * Called each poll cycle from listener.ts.
+ */
+export declare function checkProductQaRequests(config: DaemonConfig, deps?: ProductQaOrchestratorDeps): Promise<void>;
+//# sourceMappingURL=qa-orchestrator.d.ts.map

package/dist/qa-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-orchestrator.d.ts","sourceRoot":"","sources":["../src/qa-orchestrator.ts"],"names":[],"mappings":"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"}