Function listRunnerLogFiles

cli/src/ui/logger.ts:249–296

(limit: number = 50)

 * Returns up to `limit` entries; empty array if none.
 */
export async function listRunnerLogFiles(limit: number = 50): Promise<LogFileInfo[]> {
  try {
    const logsDir = configuration.logsDir;
    if (!existsSync(logsDir)) {
      return [];
    }

    const logs = readdirSync(logsDir)
      .filter(file => file.endsWith('-runner.log'))
      .map(file => {
        const fullPath = join(logsDir, file);
        const stats = statSync(fullPath);
        return { file, path: fullPath, modified: stats.mtime } as LogFileInfo;
      })
      .sort((a, b) => b.modified.getTime() - a.modified.getTime());

    // Prefer the path persisted by the runner if present (return 0th element if present)
    try {
      const state = await readRunnerState();

      if (!state) {
        return logs;
      }

      if (state.runnerLogPath && existsSync(state.runnerLogPath)) {
        const stats = statSync(state.runnerLogPath);
        const persisted: LogFileInfo = {
          file: basename(state.runnerLogPath),
          path: state.runnerLogPath,
          modified: stats.mtime
        };
        const idx = logs.findIndex(l => l.path === persisted.path);
        if (idx >= 0) {
          const [found] = logs.splice(idx, 1);
          logs.unshift(found);
        } else {
          logs.unshift(persisted);
        }
      }
    } catch {
      // Ignore errors reading runner state; fall back to directory listing
    }

    return logs.slice(0, Math.max(0, limit));
  } catch {
    return [];
  }
}

/**
 * Get the most recent runner log file, or null if none exist.