<?php
// ─── Changelog reader ────────────────────────────────────────────────────────
// Reads the repository CHANGELOG.md and exposes the most recent version entry,
// so the backoffice can show "Versão X — what changed" without a DB round-trip.
// The file is versioned with the code, so it updates automatically on git pull.

/**
 * Return the latest CHANGELOG.md entry.
 *
 * Expected format:
 *   ## v2.2 — Adicionado pagamentos parciais
 *   - primeira alteração
 *   - segunda alteração
 *
 * @return array{version: ?string, changes: string[]}
 */
function changelog_latest(): array {
    $file = dirname(__DIR__, 2) . '/CHANGELOG.md';
    if (!is_file($file)) return ['version' => null, 'changes' => []];

    $lines = @file($file, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
    if ($lines === false) return ['version' => null, 'changes' => []];

    $version = null;
    $changes = [];
    foreach ($lines as $line) {
        if (preg_match('/^##\s+(.+)$/', $line, $m)) {
            if ($version === null) {
                $version = trim($m[1]);
                continue;
            }
            break; // reached the next version entry
        }
        if ($version !== null && str_starts_with(ltrim($line), '-')) {
            $changes[] = ltrim(ltrim($line), '- ');
        }
    }
    return ['version' => $version, 'changes' => $changes];
}