name: Release guard

# 发布标记语义守门（M163）：**push tag 默认创建稳定版**这条不许只靠注释保证。
#
# 判据全部在 `packaging/check_release_semantics.py`，它做四件事：
#   ① 标记表：push tag（空串）的 create **不含** --prerelease；dispatch true ⇒ 预发布；
#      dispatch false ⇒ create 稳定、edit 显式摘标记；非法取值必须抛。
#   ② 真 bash 往返：把 `packaging/release_marker.py --emit-bash` 的产物 source 进 bash，
#      读回 create_mark / edit_mark 两个数组——证明流水线**真跑的那段代码**对，不只是函数对。
#   ③ release-publish.yml 的可执行内容里没有 --prerelease 字面量：标记只能从那张表来。
#   ④ release.yml 的 dispatch 默认值 == false（读 YAML 结构，不是 grep 字符串）。
# 最后一步 `--self-mutation` 是这条守门自己的变异自测：把「默认值改回 true」「塞回字面量」
# 「表里 push 分支改成预发布」逐项注入临时副本，断言守门**每一项都红**、基线绿。守门自己
# 抓不住回归时它会先红，所以这条断言不会变成装饰品。
#
# 为什么不并进 guards.yml：那份文件已经 398 行（400 行红线），再挂一个 job 必越线。
# 改 `release.yml` 的 prerelease 输入 / 改那段 `gh release` 时，先跑
# `python3 packaging/check_release_semantics.py`（本机可用 `python`，脚本会自己找 bash）。
#
# （M164）同一个 job 还挂**发布名单守卫** `packaging/check_publish_slots.py`：`PUBLISH_SLOTS` 与槽位表/产物
# 必须对得上。PR 阶段跑源码级断言（名单非空、每项都是 `release.yml` 槽位表里的 `mode: ci` 档）——
# 名单里写错一个字此前只会表现为「Release 侧一个也不匹配、齐全性检查红在别处」，根因要翻两层日志；
# `--self-test` 再注入 8 条回归（缺资产 / 拼错 / 声明了 probe 档 / 名单声明了没产物 / 有产物没声明）证明它会红。
# 发布侧那道「产物 ⇄ 名单」的运行时断言在 `release-publish.yml`（同一份脚本，`--dist`）。

on:
  push:
    branches: [main]
  pull_request:
  workflow_dispatch:

permissions:
  contents: read

jobs:
  release-semantics:
    name: 发布标记语义守门（push tag → 稳定版）
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: 标记表自检（push tag ⇒ 稳定版）
        run: python3 packaging/release_marker.py --self-test
      - name: 语义断言（标记表 / bash 往返 / 流水线只用表 / dispatch 默认值）
        run: python3 packaging/check_release_semantics.py
      - name: 变异自测（守门抓不抓得住回归）
        run: python3 packaging/check_release_semantics.py --self-mutation
      - name: 发布名单守卫自测（声明⇒必须有产物 / 有产物没声明⇒显式警告）
        run: python3 packaging/check_publish_slots.py --self-test
      - name: 发布名单与矩阵槽位一致（拼错字 / 声明了 probe 档 当场红）
        run: python3 packaging/check_publish_slots.py