@telora/factory 0.4.5

package/dist/gates/behavioral.js

@@ -0,0 +1,485 @@
+/**
+ * Behavioral gate evaluation for the factory orchestrator.
+ *
+ * Manages the dev server lifecycle and Playwright test execution within
+ * a factory worktree. The flow is:
+ *   1. Start the dev server (blueprint config or "npm run dev")
+ *   2. Wait for the server to be ready (stdout detection or timeout)
+ *   3. Run `npx playwright test --reporter=json {testGlob}` in the worktree
+ *   4. Parse Playwright JSON reporter output for structured results
+ *   5. Kill the dev server process tree on completion or timeout
+ *   6. Return structured gate check results
+ *
+ * Dev server readiness detection looks for common patterns in stdout:
+ *   - "ready" (generic)
+ *   - "localhost" (generic server bind)
+ *   - "Local:" (Vite dev server)
+ *
+ * The dev server process is killed using negative PID (process group kill)
+ * to ensure all child processes are terminated.
+ */
+import { spawn } from 'node:child_process';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Log prefix for behavioral gate messages. */
+const LOG_PREFIX = '[gate:behavioral]';
+/** Maximum output length per check result (10 KB). */
+const MAX_OUTPUT_LENGTH = 10_000;
+/** Default test glob if not specified in config. */
+const DEFAULT_TEST_GLOB = 'tests/**/*.spec.ts';
+/** Default dev server command if not specified in config. */
+const DEFAULT_DEV_SERVER_COMMAND = 'npm run dev';
+/** Default timeout for dev server readiness and test execution (30s). */
+const DEFAULT_TIMEOUT_MS = 30_000;
+/** Patterns in stdout that indicate the dev server is ready. */
+const READY_PATTERNS = [
+    'ready',
+    'localhost',
+    'Local:',
+];
+/** Grace period for dev server process tree kill (ms). */
+const KILL_GRACE_MS = 3_000;
+// ============================================================================
+// Dev server management
+// ============================================================================
+/**
+ * Start the dev server and wait for it to be ready.
+ *
+ * Spawns the dev server command in the worktree directory with a new
+ * process group (detached: true) so we can kill the entire tree later.
+ * Listens on stdout for readiness patterns or times out.
+ *
+ * @returns The dev server child process, or null if it failed to start.
+ */
+function startDevServer(command, worktreePath) {
+    const [cmd, ...args] = parseCommand(command);
+    const proc = spawn(cmd, args, {
+        cwd: worktreePath,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        detached: true,
+        shell: true,
+        env: { ...process.env, CI: 'true' },
+    });
+    return proc;
+}
+/**
+ * Wait for the dev server to emit a readiness signal on stdout.
+ *
+ * Resolves when any of the READY_PATTERNS are detected in stdout,
+ * or rejects on timeout.
+ */
+function waitForServerReady(proc, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        let resolved = false;
+        let stdoutBuffer = '';
+        const timer = setTimeout(() => {
+            if (!resolved) {
+                resolved = true;
+                reject(new Error(`Dev server did not become ready within ${timeoutMs}ms. ` +
+                    `Captured stdout: ${truncateOutput(stdoutBuffer)}`));
+            }
+        }, timeoutMs);
+        const onData = (chunk) => {
+            if (resolved)
+                return;
+            const text = chunk.toString();
+            stdoutBuffer += text;
+            const lowerText = stdoutBuffer.toLowerCase();
+            const isReady = READY_PATTERNS.some((pattern) => lowerText.includes(pattern.toLowerCase()));
+            if (isReady) {
+                resolved = true;
+                clearTimeout(timer);
+                // Detach the listener but keep the process running
+                proc.stdout?.removeListener('data', onData);
+                resolve();
+            }
+        };
+        proc.stdout?.on('data', onData);
+        proc.on('error', (err) => {
+            if (!resolved) {
+                resolved = true;
+                clearTimeout(timer);
+                reject(new Error(`Dev server failed to start: ${err.message}`));
+            }
+        });
+        proc.on('close', (code) => {
+            if (!resolved) {
+                resolved = true;
+                clearTimeout(timer);
+                reject(new Error(`Dev server exited prematurely with code ${code ?? 'unknown'}. ` +
+                    `Captured stdout: ${truncateOutput(stdoutBuffer)}`));
+            }
+        });
+    });
+}
+/**
+ * Kill the dev server process tree.
+ *
+ * Uses negative PID to send SIGTERM to the entire process group.
+ * Falls back to killing just the process if group kill fails.
+ * Waits up to KILL_GRACE_MS, then sends SIGKILL.
+ */
+async function killDevServer(proc) {
+    const pid = proc.pid;
+    if (pid === undefined)
+        return;
+    // Try process group kill first (negative PID)
+    try {
+        process.kill(-pid, 'SIGTERM');
+    }
+    catch {
+        // Process group kill failed -- try direct kill
+        try {
+            proc.kill('SIGTERM');
+        }
+        catch {
+            // Already dead
+            return;
+        }
+    }
+    // Wait for graceful shutdown, then force kill if still alive
+    await new Promise((resolve) => {
+        const forceKillTimer = setTimeout(() => {
+            try {
+                process.kill(-pid, 'SIGKILL');
+            }
+            catch {
+                try {
+                    proc.kill('SIGKILL');
+                }
+                catch {
+                    // Already dead
+                }
+            }
+            resolve();
+        }, KILL_GRACE_MS);
+        proc.on('close', () => {
+            clearTimeout(forceKillTimer);
+            resolve();
+        });
+    });
+}
+// ============================================================================
+// Playwright test execution
+// ============================================================================
+/**
+ * Run Playwright tests in the worktree and capture JSON output.
+ *
+ * Executes `npx playwright test --reporter=json {testGlob}` and collects
+ * the full stdout as the JSON report.
+ */
+function runPlaywrightTests(worktreePath, testGlob, timeoutMs) {
+    return new Promise((resolve) => {
+        const proc = spawn('npx', ['playwright', 'test', '--reporter=json', testGlob], {
+            cwd: worktreePath,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            shell: true,
+            env: { ...process.env, CI: 'true' },
+        });
+        let stdout = '';
+        let stderr = '';
+        proc.stdout?.on('data', (chunk) => {
+            stdout += chunk.toString();
+        });
+        proc.stderr?.on('data', (chunk) => {
+            stderr += chunk.toString();
+        });
+        const timer = setTimeout(() => {
+            try {
+                proc.kill('SIGTERM');
+            }
+            catch {
+                // Already dead
+            }
+            // Give it a moment to clean up, then force kill
+            setTimeout(() => {
+                try {
+                    proc.kill('SIGKILL');
+                }
+                catch {
+                    // Already dead
+                }
+            }, KILL_GRACE_MS);
+        }, timeoutMs);
+        proc.on('close', (code) => {
+            clearTimeout(timer);
+            resolve({ stdout, stderr, exitCode: code ?? 1 });
+        });
+        proc.on('error', (err) => {
+            clearTimeout(timer);
+            resolve({ stdout, stderr: stderr + '\n' + err.message, exitCode: 1 });
+        });
+    });
+}
+// ============================================================================
+// Playwright JSON report parsing
+// ============================================================================
+/**
+ * Parse Playwright JSON reporter output into GateCheckResult items.
+ *
+ * Extracts individual test results from the nested suite/spec/test
+ * hierarchy. Each test becomes a separate GateCheckResult entry.
+ *
+ * If the JSON cannot be parsed, returns a single failed result with
+ * the raw output.
+ */
+function parsePlaywrightResults(jsonOutput, stderrOutput, exitCode, durationMs) {
+    let report;
+    try {
+        report = JSON.parse(jsonOutput);
+    }
+    catch {
+        // JSON parse failed -- return a single check with raw output
+        return [{
+                checkName: 'playwright-test-run',
+                passed: false,
+                output: truncateOutput(`Failed to parse Playwright JSON output.\n\n` +
+                    `Exit code: ${exitCode}\n\n` +
+                    `stdout:\n${jsonOutput}\n\n` +
+                    `stderr:\n${stderrOutput}`),
+                durationMs,
+                isAdversaryGenerated: false,
+            }];
+    }
+    const results = [];
+    // Handle top-level errors (e.g. config errors, no tests found)
+    if (report.errors && report.errors.length > 0) {
+        const errorMessages = report.errors
+            .map((e) => e.message ?? 'Unknown error')
+            .join('\n');
+        results.push({
+            checkName: 'playwright-setup',
+            passed: false,
+            output: truncateOutput(`Playwright reported errors:\n${errorMessages}`),
+            durationMs,
+            isAdversaryGenerated: false,
+        });
+    }
+    // Recursively extract test results from suites
+    if (report.suites) {
+        for (const suite of report.suites) {
+            extractSuiteResults(suite, [], results);
+        }
+    }
+    // If no results were extracted but exit code was non-zero, add a summary
+    if (results.length === 0) {
+        results.push({
+            checkName: 'playwright-test-run',
+            passed: exitCode === 0,
+            output: truncateOutput(exitCode === 0
+                ? 'All Playwright tests passed (no individual results extracted).'
+                : `Playwright exited with code ${exitCode}.\n\nstderr:\n${stderrOutput}`),
+            durationMs,
+            isAdversaryGenerated: false,
+        });
+    }
+    return results;
+}
+/**
+ * Recursively extract test results from a Playwright suite.
+ *
+ * Builds a fully qualified test name from the suite path and spec/test
+ * titles. Each test result becomes a GateCheckResult.
+ */
+function extractSuiteResults(suite, parentPath, results) {
+    const currentPath = suite.title
+        ? [...parentPath, suite.title]
+        : parentPath;
+    // Process specs in this suite
+    if (suite.specs) {
+        for (const spec of suite.specs) {
+            extractSpecResults(spec, currentPath, results);
+        }
+    }
+    // Recurse into nested suites
+    if (suite.suites) {
+        for (const nested of suite.suites) {
+            extractSuiteResults(nested, currentPath, results);
+        }
+    }
+}
+/**
+ * Extract results from a Playwright spec (describe/test block).
+ */
+function extractSpecResults(spec, suitePath, results) {
+    if (!spec.tests || spec.tests.length === 0) {
+        // Spec without tests -- use the spec's own ok status
+        const checkName = [...suitePath, spec.title ?? 'unknown'].join(' > ');
+        results.push({
+            checkName,
+            passed: spec.ok === true,
+            output: truncateOutput(spec.ok ? 'Passed' : 'Failed'),
+            durationMs: 0,
+            isAdversaryGenerated: false,
+        });
+        return;
+    }
+    for (const test of spec.tests) {
+        const testTitle = test.title ?? spec.title ?? 'unknown';
+        const checkName = [...suitePath, testTitle].join(' > ');
+        // Determine pass/fail from test results
+        const testResults = test.results ?? [];
+        const lastResult = testResults[testResults.length - 1];
+        const passed = test.status === 'expected'
+            || lastResult?.status === 'passed'
+            || (test.expectedStatus === test.status);
+        const totalDuration = testResults.reduce((sum, r) => sum + (r.duration ?? 0), 0);
+        // Build output from error information
+        let output = '';
+        if (passed) {
+            output = `Passed (${totalDuration}ms)`;
+        }
+        else {
+            const errorParts = [];
+            for (const result of testResults) {
+                if (result.error) {
+                    if (result.error.message)
+                        errorParts.push(result.error.message);
+                    if (result.error.snippet)
+                        errorParts.push(result.error.snippet);
+                }
+                if (result.errors) {
+                    for (const err of result.errors) {
+                        if (err.message)
+                            errorParts.push(err.message);
+                        if (err.snippet)
+                            errorParts.push(err.snippet);
+                    }
+                }
+            }
+            output = errorParts.length > 0
+                ? errorParts.join('\n---\n')
+                : `Failed with status: ${lastResult?.status ?? test.status ?? 'unknown'}`;
+        }
+        results.push({
+            checkName,
+            passed,
+            output: truncateOutput(output),
+            durationMs: totalDuration,
+            isAdversaryGenerated: false,
+        });
+    }
+}
+// ============================================================================
+// Main exported function
+// ============================================================================
+/**
+ * Run behavioral gates for a factory work unit.
+ *
+ * Starts the dev server, waits for readiness, runs Playwright tests,
+ * parses results, and cleans up. Returns structured results suitable
+ * for persisting as gate check results.
+ *
+ * @param worktreePath  Absolute path to the factory worktree.
+ * @param config        Behavioral gate config from the blueprint, or null for defaults.
+ * @returns             Overall pass/fail and individual check results.
+ */
+export async function runBehavioralGates(worktreePath, config) {
+    const testGlob = config?.testGlob ?? DEFAULT_TEST_GLOB;
+    const devServerCommand = config?.devServerCommand ?? DEFAULT_DEV_SERVER_COMMAND;
+    const timeoutMs = config?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const overallStart = Date.now();
+    console.log(`${LOG_PREFIX} Starting behavioral gates in ${worktreePath} ` +
+        `(devServer: "${devServerCommand}", glob: "${testGlob}", timeout: ${timeoutMs}ms)`);
+    // ── Step 1: Start the dev server ────────────────────────────────────
+    let devServer = null;
+    try {
+        devServer = startDevServer(devServerCommand, worktreePath);
+        if (devServer.pid === undefined) {
+            return {
+                passed: false,
+                results: [{
+                        checkName: 'dev-server-start',
+                        passed: false,
+                        output: 'Failed to start dev server: process pid is undefined.',
+                        durationMs: Date.now() - overallStart,
+                        isAdversaryGenerated: false,
+                    }],
+            };
+        }
+        console.log(`${LOG_PREFIX} Dev server started (pid: ${devServer.pid})`);
+        // ── Step 2: Wait for server readiness ───────────────────────────────
+        try {
+            await waitForServerReady(devServer, timeoutMs);
+            console.log(`${LOG_PREFIX} Dev server is ready`);
+        }
+        catch (readyErr) {
+            const error = readyErr instanceof Error ? readyErr.message : String(readyErr);
+            console.error(`${LOG_PREFIX} Dev server readiness check failed: ${error}`);
+            return {
+                passed: false,
+                results: [{
+                        checkName: 'dev-server-ready',
+                        passed: false,
+                        output: truncateOutput(`Dev server failed readiness check.\n\n${error}`),
+                        durationMs: Date.now() - overallStart,
+                        isAdversaryGenerated: false,
+                    }],
+            };
+        }
+        // ── Step 3: Run Playwright tests ────────────────────────────────────
+        const testStart = Date.now();
+        const { stdout, stderr, exitCode } = await runPlaywrightTests(worktreePath, testGlob, timeoutMs);
+        const testDuration = Date.now() - testStart;
+        console.log(`${LOG_PREFIX} Playwright tests completed ` +
+            `(exitCode: ${exitCode}, duration: ${testDuration}ms)`);
+        // ── Step 4: Parse results ───────────────────────────────────────────
+        const results = parsePlaywrightResults(stdout, stderr, exitCode, testDuration);
+        const passed = results.every((r) => r.passed);
+        console.log(`${LOG_PREFIX} Behavioral gates ${passed ? 'PASSED' : 'FAILED'} ` +
+            `(${results.filter((r) => r.passed).length}/${results.length} checks passed)`);
+        return { passed, results };
+    }
+    catch (err) {
+        const error = err instanceof Error ? err.message : String(err);
+        console.error(`${LOG_PREFIX} Unexpected error during behavioral gates: ${error}`);
+        return {
+            passed: false,
+            results: [{
+                    checkName: 'behavioral-gate-error',
+                    passed: false,
+                    output: truncateOutput(`Unexpected error: ${error}`),
+                    durationMs: Date.now() - overallStart,
+                    isAdversaryGenerated: false,
+                }],
+        };
+    }
+    finally {
+        // ── Step 5: Kill dev server on completion or error ───────────────────
+        if (devServer) {
+            console.log(`${LOG_PREFIX} Killing dev server...`);
+            await killDevServer(devServer);
+            console.log(`${LOG_PREFIX} Dev server terminated`);
+        }
+    }
+}
+// ============================================================================
+// Utility helpers
+// ============================================================================
+/**
+ * Truncate output to the maximum allowed length.
+ * Appends a truncation notice if the output was shortened.
+ */
+function truncateOutput(output) {
+    if (output.length <= MAX_OUTPUT_LENGTH) {
+        return output;
+    }
+    const truncationNotice = '\n\n... [truncated at 10000 chars]';
+    return output.slice(0, MAX_OUTPUT_LENGTH - truncationNotice.length) + truncationNotice;
+}
+/**
+ * Parse a shell command string into the command and its arguments.
+ *
+ * Handles simple cases like "npm run dev" or "node server.js".
+ * For complex commands with pipes or redirects, the shell: true
+ * option on spawn handles those.
+ */
+function parseCommand(command) {
+    const parts = command.trim().split(/\s+/);
+    if (parts.length === 0 || parts[0] === '') {
+        return ['npm', 'run', 'dev'];
+    }
+    return parts;
+}
+//# sourceMappingURL=behavioral.js.map

package/dist/gates/behavioral.js.map

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

package/dist/gates/deterministic.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Deterministic gate evaluation.
+ *
+ * Runs configured shell commands (typecheck, lint, test, build) in the
+ * worktree directory and captures structured results. Commands execute
+ * sequentially; the first failure short-circuits remaining checks.
+ */
+import type { DeterministicGateConfig, GateCheckResult, TraceCheckConfig } from '../types.js';
+/**
+ * Run deterministic gate checks in the given worktree.
+ *
+ * Executes the configured commands sequentially. Each command is run as a
+ * shell command in the worktree directory. The first failure short-circuits
+ * remaining checks.
+ *
+ * @param worktreePath - Absolute path to the git worktree directory
+ * @param config - Blueprint deterministic gate config, or null for defaults
+ * @returns Overall pass/fail and per-check results
+ */
+export declare function runDeterministicGates(worktreePath: string, config: DeterministicGateConfig | null, traceChecks?: TraceCheckConfig[]): Promise<{
+    passed: boolean;
+    results: GateCheckResult[];
+}>;
+//# sourceMappingURL=deterministic.d.ts.map

package/dist/gates/deterministic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deterministic.d.ts","sourceRoot":"","sources":["../../src/gates/deterministic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,uBAAuB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAmJ9F;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,uBAAuB,GAAG,IAAI,EACtC,WAAW,CAAC,EAAE,gBAAgB,EAAE,GAC/B,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC,CAyE1D"}