Function runTests

src/tools/run_tests.js:325–390

* Execute the test suite and return a structured result. * * @param {object} opts * @param {string} [opts.test_filter] - Optional name/pattern filter * @param {string} [opts.workdir] - Working directory (default: process.cwd()) * @param {number} [opts.timeout] - Timeout in ms (def

(opts = {})

 * @returns {object} Structured test result
 */
function runTests(opts = {}) {
  const cwd = opts.workdir || process.cwd();
  const timeout = opts.timeout || 120000;
  const test_filter = opts.test_filter || null;

  const detector = getTestRunnerDetector({ workdir: cwd });
  const runner = detector.detect();

  if (!runner) {
    return {
      passed: 0, failed: 0, errors: 0, skipped: 0, failures: [],
      raw: 'No test runner detected. Create a pytest.ini, package.json with a test script, Cargo.toml, go.mod, etc.',
      exitCode: -1, durationMs: 0, command: null, framework: null,
      summary: 'No test runner detected.',
    };
  }

  const filterArg = buildFilterArg(runner.framework, test_filter);
  const command = runner.command + filterArg;

  const start = Date.now();
  let rawOutput = '';
  let exitCode = 0;

  try {
    rawOutput = execSync(command, {
      encoding: 'utf-8',
      timeout,
      cwd,
      maxBuffer: 2 * 1024 * 1024,
      // Merge stderr into stdout so we capture everything
      stdio: ['ignore', 'pipe', 'pipe'],
    });
  } catch (e) {
    rawOutput = (e.stdout || '') + (e.stderr || '');
    exitCode = typeof e.status === 'number' ? e.status : 1;
  }

  const durationMs = Date.now() - start;
  const raw = sanitizeToolOutput(rawOutput).slice(0, 3000);
  const parsed = parseOutput(runner.framework, rawOutput, exitCode);

  const { passed, failed, errors, skipped, failures } = parsed;

  // Build a one-line summary the model can parse at a glance
  const parts = [];
  if (passed > 0) parts.push(`${passed} passed`);
  if (failed > 0) parts.push(`${failed} failed`);
  if (errors > 0) parts.push(`${errors} errors`);
  if (skipped > 0) parts.push(`${skipped} skipped`);
  const summary = parts.length > 0 ? parts.join(', ') : (exitCode === 0 ? 'all passed' : 'failed (no tests found or parse error)');

  return {
    passed,
    failed,
    errors,
    skipped,
    failures: failures.slice(0, 20), // cap to avoid overwhelming context