#!/bin/sh
# check-version-consistency.sh — ISEP 版本一致性檢查（inkstone/ISEP#6）
#
# 立這支的來由（2026-08-20）：README.md 曾寫死「狀態：0.1.0」，
# 但這個 repo `release_counter=0`、一個 tag 都沒打。leo 當場指出這是違規，
# 且命中規範自己的 E12（宣稱交付但沒有 tag）；leo 補充：
# 「release 不是寫在 readme，要放在 release 裡」。
#
# 判準只有一句：**「ISEP 現在是哪一版」只有一個地方答得出來＝ Gitea Releases（git tag）。**
# 其他地方要嘛指過去、要嘛跟它機械同步，不准各自宣告一個號碼。
#
#   1. `.claude-plugin/plugin.json` 的 `version` 欄位，必須跟「最新的 tag」完全一致。
#      還沒打過任何 tag 時（現在就是這個狀態），version 欄位必須是哨兵值 `0.0.0`
#      ──意思是「這份 manifest 誠實承認：目前沒有一個經過驗證、掛在 Gitea Releases
#      上的版本」。不准提前寫一個沒人驗過的號碼（那正是這張票抓到的違規本身）。
#      真正打 tag 的那天，`.claude-plugin/plugin.json` 的 version 要跟那個 tag
#      同一個 commit 就改掉，兩者一起進 release。
#   2. `README.md` 不准再自己宣告版本號（例如「- 0.1.0 —」這種樣式的行）。
#      讀者要查現在是哪一版，去 Releases 頁面，不是讀 README。
#
# 用法：scripts/check-version-consistency.sh
# 離開碼：0＝一致（可以放心說「這裡查得到版本」）；1＝不一致（stderr 講清楚錯在哪、
#         該改哪個檔案）。可以隨時手動跑，也是 hooks/release-tag-guard.sh 在打 tag
#         那一刻用來擋下不一致 tag 的同一套判準（複製了一份精簡邏輯，避免 hook
#         每次 Bash 呼叫都要 fork 這支腳本）。

set -eu

PROJ="$(cd "$(dirname "$0")/.." && pwd)"
PLUGIN_JSON="$PROJ/.claude-plugin/plugin.json"
README="$PROJ/README.md"

FAIL=0

# --- 1. plugin.json 讀得到、version 欄位存在 ---
if [ ! -f "$PLUGIN_JSON" ]; then
  echo "❌ 找不到 $PLUGIN_JSON" >&2
  exit 1
fi

PJVER=$(python3 -c "import json;print(json.load(open('$PLUGIN_JSON')).get('version',''))" 2>/dev/null || printf '')
if [ -z "$PJVER" ]; then
  echo "❌ .claude-plugin/plugin.json 沒有 version 欄位（或不是合法 JSON）" >&2
  exit 1
fi

# --- 2. 跟最新 tag 比對 ---
LATEST_TAG=$(cd "$PROJ" && git tag --list 'v*' --sort=-v:refname 2>/dev/null | head -1 || printf '')

if [ -z "$LATEST_TAG" ]; then
  # 沒有任何 tag：唯一合法的 plugin.json version 是哨兵值 0.0.0
  if [ "$PJVER" != "0.0.0" ]; then
    echo "❌ 版本不一致：" >&2
    echo "   repo 裡沒有任何 tag（release_counter=0，還沒有一個正式 release）" >&2
    echo "   但 .claude-plugin/plugin.json 的 version 卻宣稱「$PJVER」" >&2
    echo "   → 這就是 inkstone/ISEP#6 抓到的違規本身：宣稱一個版本，卻沒有 tag 撐它。" >&2
    echo "   → 修法：version 改回 0.0.0（=尚未發過正式版），等真正打 tag 那天再同步改成那個號碼。" >&2
    FAIL=1
  fi
else
  TAGVER=${LATEST_TAG#v}
  if [ "$PJVER" != "$TAGVER" ]; then
    echo "❌ 版本不一致：" >&2
    echo "   Gitea 上最新的 tag 是 $LATEST_TAG（版本 $TAGVER）" >&2
    echo "   但 .claude-plugin/plugin.json 的 version 是「$PJVER」" >&2
    echo "   → 兩者必須完全一致，不然「ISEP 現在是哪一版」又變成各說各話。" >&2
    FAIL=1
  fi
fi

# --- 3. README 不准自己宣告版本號 ---
HIT=$(grep -nE '^\s*-\s*v?[0-9]+\.[0-9]+\.[0-9]+\s*(—|-)' "$README" 2>/dev/null || printf '')
if [ -f "$README" ] && [ -n "$HIT" ]; then
  echo "❌ README.md 還在自己宣告版本號（不准，release 只放在 Gitea Releases）：" >&2
  echo "$HIT" >&2
  FAIL=1
fi

if [ "$FAIL" -eq 0 ]; then
  if [ -n "$LATEST_TAG" ]; then
    echo "✅ 版本一致：plugin.json＝$PJVER，最新 tag＝$LATEST_TAG，README 沒有自行宣告版本。"
  else
    echo "✅ 版本一致：plugin.json＝$PJVER（哨兵值，尚無 tag 是合法狀態），README 沒有自行宣告版本。"
  fi
fi

exit "$FAIL"