#!/usr/bin/env python3
"""daemon-version.py — daemon 版本號的唯一產生器（2026-08-06 二版）

🔴 leo 08-06：「給版本號、本版更新內容、打包產品、顯示在前端，
   這一整串都應該是機械化，**不應該每次手工做**」

── 病根（實測）────────────────────────────────────────────────────
  manifest 宣告 daemon v0.18.5，線上產物拆開卻是 v0.18.4。
  原因：本 repo **一個 git tag 都沒有**，build 腳本寫的是 `git describe --tags`
  ⇒ 拿不到 v0.18.x ⇒ 版本只能靠打包時人工 `VERSION=v0.18.4 ./build-win.sh` 敲。
  人工敲 ⇒ 兩條打包線（win／mac）各敲各的 ⇒ manifest 說謊。

── 為什麼不是「數 commit 數」（一版的做法，已否決）─────────────────
  第一版用「動過 collector/ 的 commit 數」當 patch。確實不用手打，
  但**每個 commit 都變成一版**（一天 5 個 commit 就跳 5 版），
  而且每跳一版就要補一段 changelog——把機械化變成新的手工活。

── 現在的做法：版本由 changelog 決定，且不用手打數字 ──────────────
  單一真相源＝ docs-site/src/content/docs/help/changelog.md（用戶語言那份）。

    · 要出新版 ⇒ 在檔案最上面加一段標題 `## 下一版（未發佈）`，底下寫白話更新內容。
    · 打包時本腳本把它**戳成正式版號**（上一版 patch + 1）並補上今天日期。
    · 沒有「未發佈」段 ⇒ 版本＝最上面那一版（重打同一版，不會虛增）。

  ⇒ **版本號從頭到尾沒有人打過**，而且「更新內容」與「版本」天生綁在一起——
    不可能出現「版本升了但沒人知道改了什麼」，也不可能「寫了內容卻忘了升版」。
  ⇒ 不需要 git tag／Actions／輪詢（守 D20 紅線）。

  換線（0.18 → 0.19）：改 `DAEMON_LINE`，下一版就從 0.19.0 開始。

用法：
  daemon-version.py            # 印出版本（唯讀，不改檔）
  daemon-version.py --stamp    # 把「下一版（未發佈）」戳成正式版號＋日期後印出
"""
import datetime
import re
import subprocess
import sys
from pathlib import Path

HERE = Path(__file__).resolve().parent
ROOT = Path(subprocess.check_output(
    ["git", "rev-parse", "--show-toplevel"], cwd=HERE, text=True).strip())
CHANGELOG = ROOT / "docs-site/src/content/docs/help/changelog.md"
LINE_FILE = ROOT / "DAEMON_LINE"

UNRELEASED = "## 下一版（未發佈）"
RELEASED_RE = re.compile(r"^## v(\d+)\.(\d+)\.(\d+)（", re.M)


def die(msg):
    print(msg, file=sys.stderr)
    sys.exit(1)


def main():
    stamp = "--stamp" in sys.argv
    if not CHANGELOG.exists():
        die("❌ 找不到 changelog：%s" % CHANGELOG)
    line = LINE_FILE.read_text().strip() if LINE_FILE.exists() else "0.18"
    if not re.fullmatch(r"\d+\.\d+", line):
        die("❌ DAEMON_LINE 必須是 MAJOR.MINOR（例 0.18），現在是 %r" % line)

    text = CHANGELOG.read_text()
    top = RELEASED_RE.search(text)
    if not top:
        die("❌ changelog 裡找不到任何 `## vX.Y.Z（…）` 的版本段落")
    prev = (int(top.group(1)), int(top.group(2)), int(top.group(3)))

    has_unreleased = UNRELEASED in text
    if has_unreleased and text.index(UNRELEASED) > top.start():
        die("❌ `%s` 必須放在所有已發佈版本的**上面**（它代表還沒出的那一版）" % UNRELEASED)

    if not has_unreleased:
        # 沒有待發佈內容＝重打同一版。冪等，不虛增。
        version = "v%d.%d.%d" % prev
        if stamp:
            print("  ℹ️ changelog 沒有「下一版（未發佈）」段，版本維持 %s（重打同一版）"
                  % version, file=sys.stderr)
        print(version)
        return

    # 有待發佈內容 ⇒ 升版。換線時從該線的 .0 開始。
    major, minor = (int(x) for x in line.split("."))
    if (major, minor) != (prev[0], prev[1]):
        nxt = (major, minor, 0)
    else:
        nxt = (prev[0], prev[1], prev[2] + 1)
    version = "v%d.%d.%d" % nxt

    if stamp:
        today = datetime.date.today().isoformat()
        heading = "## %s（%s）" % (version, today)
        CHANGELOG.write_text(text.replace(UNRELEASED, heading, 1))
        print("  ✅ changelog：「下一版（未發佈）」→ %s" % heading, file=sys.stderr)

    print(version)


if __name__ == "__main__":
    main()