@haiyangbg/buildbeat 2.0.2 → 3.0.0

package/templates/scripts/design-preview.sh

@@ -1,44 +0,0 @@
-#!/usr/bin/env bash
-# design-preview.sh —— Gate2 真渲染拍板(总线规则⑩)。
-# 把 design/design_<N>期/ 起成本地静态服务,用户在浏览器点过关键流之后再拍板;
-# 静态稿 / 截图不充当拍板对象。设计走查复核时同样可用。
-# 本脚本按自身位置定位协调层根,放 <根>/scripts/ 或 <根>/pm/scripts/ 均可(紧凑布局见 SKILL §3);下文命令示例按默认布局写。
-# 用法:
-#   bash scripts/design-preview.sh 1           # 渲染 design/design_1期 → http://localhost:8799
-#   bash scripts/design-preview.sh 2 8801      # 指定端口
-#   bash scripts/design-preview.sh design_2期   # 也接受完整目录名
-set -uo pipefail
-# 协调层根 = 向上最近的含 pm/NOW.md 的目录(设计稿在 <根>/design/);SDIR 只用于把用法提示打成实际路径。见 bus-check.sh 同段注释。
-_sd="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-ROOT="$_sd"; for _ in 1 2 3 4; do [ -f "$ROOT/pm/NOW.md" ] && break; ROOT="$(dirname "$ROOT")"; done
-[ -f "$ROOT/pm/NOW.md" ] || ROOT="$(cd "$_sd/.." && pwd)"
-SDIR="${_sd#"$ROOT"/}"; [ "$SDIR" = "$_sd" ] && SDIR="."
-
-N="${1:?用法: bash $SDIR/design-preview.sh <期号|目录名> [端口,默认 8799]}"
-PORT="${2:-8799}"
-
-DIR="$ROOT/design/design_${N}期"
-[ -d "$DIR" ] || DIR="$ROOT/design/$N"
-if [ ! -d "$DIR" ]; then
-  echo "✗ 找不到设计目录: design/design_${N}期 或 design/$N" >&2
-  echo "  现有:"
-  existing_n=0
-  for existing in "$ROOT"/design/design_*; do
-    [ -d "$existing" ] || continue
-    printf '  - %s\n' "${existing#"$ROOT"/}"
-    existing_n=$((existing_n + 1))
-  done
-  [ "$existing_n" -gt 0 ] || echo "  (无)"
-  exit 1
-fi
-
-ENTRY=""
-for candidate in "$DIR"/*.html; do
-  [ -f "$candidate" ] || continue
-  ENTRY="$candidate"
-  break
-done
-echo "▸ 渲染 ${DIR#"$ROOT"/} → http://localhost:$PORT/"
-[ -n "${ENTRY:-}" ] && echo "▸ 入口: http://localhost:$PORT/$(basename "$ENTRY" | sed 's/ /%20/g')"
-echo "▸ Gate2 拍板前:浏览器里把关键流点一遍(规则⑩)。Ctrl-C 停止。"
-exec python3 -m http.server "$PORT" --directory "$DIR"

package/templates/scripts/drift-check.sh

@@ -1,112 +0,0 @@
-#!/usr/bin/env bash
-# drift-check.sh —— 生产漂移检测(治「git ≠ 生产」与平台侧 env/secret 漂移,BuildBeat lessons.md 第 13 条)
-# 比对「部署平台当前配置(env 指纹 + 镜像/版本 tag)」vs 基线快照 bus-baseline.json(与本脚本同目录)。
-# 本脚本按自身位置定位协调层根,放 <根>/scripts/ 或 <根>/pm/scripts/ 均可(紧凑布局见 SKILL §3);下文命令示例按默认布局写。
-# ⚠ 能力边界:检测「平台配置 vs 基线」——把"配置被改"暴露出来,逼"改完即确认部署 + 刷基线";
-#   不检测「running 容器 vs 平台配置」(配置改了没重新部署、容器跑旧值),后者需平台运行时 API,各项目自行增强。
-# 🔴 红线:env value 只在内存进 sha256,**绝不落盘 / 绝不打印**;基线与输出只有 key 名 + 指纹。
-#   诚实边界:高熵 secret 的指纹不可逆;低熵值(true/false/端口/开关类)key 名已知,可被字典猜出——
-#   基线 bus-baseline.json 按半敏感文件对待:入私仓可以,勿公开传播。
-#
-# 项目接入点(必需):live-config.sh <app名>(与本脚本同目录)—— 自行调用部署平台 CLI,stdout 按行输出:
-#     tag <镜像tag或版本号>          (可选,一行)
-#     env <KEY>=<VALUE>             (每个环境变量一行;VALUE 只经内存管道,本脚本只留指纹)
-#   查询失败请返回非 0,别输出半截结果。
-# 用法:
-#   bash scripts/drift-check.sh                   # 检测(与 bus-check 同目录时被自动调用)
-#   bash scripts/drift-check.sh --update-baseline # 刷新基线(改 env/secret 或部署后跑 = 「确认已部署」动作)
-#   BUS_CHECK_NO_LIVE=1 ...                        # 跳过线上查询
-# 退出码:0 = 无漂移/跳过/无法判定;1 = --update-baseline 失败(基线保护);2 = 确凿检出漂移(bus-check --strict 据此拦)
-set -uo pipefail
-# 协调层根 = 向上最近的含 pm/NOW.md 的目录;SDIR = 本脚本目录(相对根)。见 bus-check.sh 同段注释。
-_sd="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-ROOT="$_sd"; for _ in 1 2 3 4; do [ -f "$ROOT/pm/NOW.md" ] && break; ROOT="$(dirname "$ROOT")"; done
-[ -f "$ROOT/pm/NOW.md" ] || ROOT="$(cd "$_sd/.." && pwd)"
-SDIR="${_sd#"$ROOT"/}"; [ "$SDIR" = "$_sd" ] && SDIR="."
-cd "$ROOT" || exit 1
-BASELINE="$SDIR/bus-baseline.json"
-UPDATE=0; [ "${1:-}" = "--update-baseline" ] && UPDATE=1
-
-# 监控应用:app名|代码子仓(镜像tag↔git tag 锚定:在子仓 git 里查 v<tag> 是否存在;无 tag 规范填 - 跳过)
-APPS=(
-  "<应用1>|<代码子仓1>"
-  "<应用2>|-"
-)
-
-if command -v sha256sum >/dev/null 2>&1; then SHACMD="sha256sum"; else SHACMD="shasum -a 256"; fi
-
-# 拉某 app 当前快照 {imageTag, perKeyFp};value 只进 sha256 前 10 位;失败返回非 0
-_snapshot(){
-  local name="$1" out imgtag perkey
-  out=$(bash "$SDIR/live-config.sh" "$name" 2>/dev/null) || return 1
-  [ -z "$out" ] && return 1
-  imgtag=$(printf '%s\n' "$out" | awk '$1=="tag"{print $2; exit}')
-  perkey=$(printf '%s\n' "$out" | grep '^env ' | sed 's/^env //' \
-    | while IFS='=' read -r k v; do printf '%s\t%s\n' "$k" "$(printf '%s' "$k=$v" | $SHACMD | cut -c1-10)"; done \
-    | jq -R -s -c 'split("\n")|map(select(length>0)|split("\t")|{(.[0]):.[1]})|add // {}')
-  [ -z "$perkey" ] && perkey='{}'  # env 空/解析失败→兜底{},不误报"查询失败"
-  jq -cn --arg t "${imgtag:-}" --argjson pk "$perkey" '{imageTag:$t, perKeyFp:$pk}'
-}
-
-if [ "${BUS_CHECK_NO_LIVE:-0}" = "1" ] || [ ! -f "$SDIR/live-config.sh" ] || ! command -v jq >/dev/null 2>&1; then
-  echo "  (漂移检测跳过:需 $SDIR/live-config.sh + jq + 不设 BUS_CHECK_NO_LIVE)"; exit 0
-fi
-
-# ── 刷新基线 ──
-if [ "$UPDATE" = "1" ]; then
-  acc="{}"; fail=0
-  for pair in "${APPS[@]:-}"; do
-    [ -n "$pair" ] || continue
-    name="${pair%%|*}"
-    snap=$(_snapshot "$name") || { echo "  ⚠️  $name 查询失败"; fail=1; continue; }
-    acc=$(printf '%s' "$acc" | jq -c --arg n "$name" --argjson s "$snap" '. + {($n):$s}')
-  done
-  if [ "$fail" = "1" ]; then
-    echo "  ✗ 有应用查询失败 —— 基线未写入(保留旧基线);修好平台 CLI/凭据后重跑 --update-baseline"
-    exit 1
-  fi
-  printf '%s' "$acc" | jq --arg d "$(date +%Y-%m-%d)" --arg s "$SDIR" \
-    '{updated:$d, note:("🔴只存指纹不存value;改env/secret或部署后跑 " + $s + "/drift-check.sh --update-baseline"), apps:.}' \
-    > "$BASELINE"
-  echo "  ✅ 基线已刷新 → $BASELINE"
-  exit 0
-fi
-
-# ── 检测 ──
-if [ ! -f "$BASELINE" ]; then
-  echo "  ⚠️  无基线 → 先跑: bash $SDIR/drift-check.sh --update-baseline"; exit 0
-fi
-
-drift=0; checked=0
-for pair in "${APPS[@]:-}"; do
-  [ -n "$pair" ] || continue
-  name="${pair%%|*}"; subrepo="${pair##*|}"
-  snap=$(_snapshot "$name") || { printf "  %-16s (查询失败,跳过)\n" "$name"; continue; }
-  checked=1
-  imgtag=$(printf '%s' "$snap" | jq -r '.imageTag')
-  base_app=$(jq -c --arg n "$name" '.apps[$n] // empty' "$BASELINE" 2>/dev/null)
-  if [ -z "$base_app" ]; then printf "  ⚠️  %-16s 基线无此应用 → --update-baseline\n" "$name"; drift=1; continue; fi
-  base_tag=$(printf '%s' "$base_app" | jq -r '.imageTag // ""')
-  # env 漂移:并集 key 分类 ＋新增 －删除 ≠值变(只报 key 名,不报 value)
-  changed=$(jq -rn \
-    --argjson b "$(printf '%s' "$base_app" | jq '.perKeyFp')" \
-    --argjson c "$(printf '%s' "$snap" | jq '.perKeyFp')" \
-    '($b+$c|keys) | map(. as $k |
-        if   $b[$k]==null then "＋"+$k
-        elif $c[$k]==null then "－"+$k
-        elif $b[$k]!=$c[$k] then "≠"+$k
-        else empty end) | join(" ")')
-  msg=""
-  [ -n "$imgtag" ] && [ "$imgtag" != "$base_tag" ] && msg="$msg 镜像 $base_tag→$imgtag(新部署?)"
-  [ -n "$changed" ] && msg="$msg env:[$changed]"
-  gt=""
-  if [ "$subrepo" != "-" ] && [ -d "$subrepo/.git" ] && [ -n "$imgtag" ]; then
-    # 锚定假设「镜像 tag X ↔ git tag vX」;你的 tag 规范不同就改这一行
-    git -C "$subrepo" rev-parse "v$imgtag" >/dev/null 2>&1 || gt=" 🏷git 无 v$imgtag(git≠生产?)"
-  fi
-  if [ -n "$msg" ] || [ -n "$gt" ]; then printf "  ⚠️  %-16s%s%s\n" "$name" "$msg" "$gt"; drift=1
-  else printf "  ✅ %-16s 配置/镜像==基线 (tag %s)\n" "$name" "${imgtag:-?}"; fi
-done
-if [ "$checked" = "0" ]; then echo "  ⚠️  没有成功查到任何应用(APPS 为空或全部查询失败)—— 无法判定漂移,检查 APPS 配置/平台 CLI/凭据"; exit 0
-elif [ "$drift" = "0" ]; then echo "  —— 无漂移"; exit 0
-else echo "  ⚠️  有漂移 → 配置改了是否已重新部署?新部署是否打 tag + 跑 --update-baseline?"; exit 2; fi

package/templates/scripts/pre-commit.sh

@@ -1,74 +0,0 @@
-#!/usr/bin/env bash
-# pre-commit.sh —— 红线机器闸。规则不能只靠自觉:每条规则问一句「违反了会怎样」,答案得是「拦下来」。
-# 闸①:凭据不入 git(红线1)—— gitleaks 扫暂存区,报警即拦;未装 gitleaks 只警告不拦(装:brew install gitleaks)。
-# 闸②:协调层可信 —— bus-check --strict 检出任一 conflict/error finding 即拦(离线模式,不查线上;仅 meta 仓生效,子仓自动跳过)。
-# 闸③:状态分写(规则⑦)—— 一次 commit 暂存 ≥2 个域的 status 文件即拦(单会话=单域,不该同时写别人的;
-#        换期压缩仪式例外:连同 pm/archive/ 一起提交即放行,或 BUS_RITUAL=1 git commit)。
-# 闸④:不批量 stage(红线2)—— 暂存文件数 > BUS_MAX_STAGED(默认 40)即拦,像 `git add -A` 的手笔;
-#        确属大重构:BUS_ALLOW_BULK=1 git commit 放行一次。
-# 闸⑤:契约先落盘(规则②,仅提醒不拦)—— 暂存文件名疑似接口边界(route/controller/api/schema/proto)时,
-#        提醒检查 PROTOCOL.md 是否同步;契约在 meta 仓、代码在子仓,跨仓无法原子核验,故不拦以免误伤。
-# 装法(meta 仓 + 各代码子仓,每仓各装一次;子仓从 meta 仓拷同一份即可):
-#   cp scripts/pre-commit.sh .git/hooks/pre-commit && chmod +x .git/hooks/pre-commit
-#   (紧凑布局下脚本在 pm/scripts/,拷贝源路径随之改;闸②两种布局都能自己找到 bus-check)
-#   (钩子想进版本控制可改用:git config core.hooksPath <钩子目录>,克隆后一次 config 即带)
-# 配套:红线3 已禁 --no-verify,这道闸绕不过去;bus-check 会自检「闸装了没」。
-set -uo pipefail
-cd "$(git rev-parse --show-toplevel)" || exit 1
-
-# ── 闸①:gitleaks(v8.19+ 用 `gitleaks git`,旧版退回 `protect`)──
-if command -v gitleaks >/dev/null 2>&1; then
-  if gitleaks git -h >/dev/null 2>&1; then
-    gitleaks git --staged --no-banner --redact >/dev/null 2>&1
-  else
-    gitleaks protect --staged --no-banner --redact >/dev/null 2>&1
-  fi || { echo "⛔ gitleaks 报警:疑似凭据进入暂存区,已拦截。看细节重跑:gitleaks git --staged(确认误报则登记 .gitleaksignore)"; exit 1; }
-else
-  echo "⚠️  未装 gitleaks —— 红线1(凭据不入 git)当前没有机器闸,只剩自觉。装:brew install gitleaks"
-fi
-
-# ── 闸②:bus-check --strict(只有协调层仓同时有 pm/NOW.md 与 bus-check.sh;两种布局都认,见 SKILL §3)──
-BC=""; for p in scripts/bus-check.sh pm/scripts/bus-check.sh; do [ -f "$p" ] && { BC="$p"; break; }; done
-if [ -f pm/NOW.md ] && [ -n "$BC" ]; then
-  out=$(BUS_CHECK_NO_FETCH=1 BUS_CHECK_NO_LIVE=1 bash "$BC" --strict 2>&1) || {
-    printf '%s\n' "$out" | grep -E "⚠️|⛔"
-    echo "⛔ bus-check --strict 未过 —— 全量输出看:bash $BC"
-    exit 1
-  }
-fi
-
-STAGED=$(git -c core.quotepath=false diff --cached --name-only)   # quotepath=false:中文文件名按原样输出,否则被引号+八进制转义,规则匹配不上
-
-# ── 闸③:状态分写(规则⑦)—— 一次 commit 只该动一个域的 status ──
-st_count=$(printf '%s\n' "$STAGED" | grep -c '^pm/status/.*\.md$' 2>/dev/null | tr -d ' ')
-st_count=${st_count:-0}
-if [ "$st_count" -ge 2 ] && [ "${BUS_RITUAL:-0}" != "1" ]; then
-  # 排除 status/README.md 自身;换期压缩仪式(连同 archive/ 提交)放行
-  real=$(printf '%s\n' "$STAGED" | awk '/^pm\/status\/.*\.md$/ && $0 !~ /README\.md$/ {n++} END {print n+0}')
-  has_archive=$(printf '%s\n' "$STAGED" | grep -c '^pm/archive/' 2>/dev/null | tr -d ' ')
-  if [ "${real:-0}" -ge 2 ] && [ "${has_archive:-0}" = "0" ]; then
-    echo "⛔ 一次 commit 暂存了 $real 个域的 status(规则⑦:各域只写自己的)—— 分开提交;换期压缩仪式请连同 pm/archive/ 一起提交(或 BUS_RITUAL=1 git commit)"
-    exit 1
-  fi
-fi
-
-# ── 闸④:不批量 stage(红线2)——像 git add -A 的手笔即拦 ──
-staged_n=$(printf '%s\n' "$STAGED" | grep -c . | tr -d ' ')
-MAXN="${BUS_MAX_STAGED:-40}"
-if [ "${staged_n:-0}" -gt "$MAXN" ] && [ "${BUS_ALLOW_BULK:-0}" != "1" ]; then
-  echo "⛔ 暂存了 $staged_n 个文件(>$MAXN)—— 像 \`git add -A\`(红线2:只 stage 自己域的具体文件,多仓分别提交);确属大重构:BUS_ALLOW_BULK=1 git commit"
-  exit 1
-fi
-
-# ── 闸⑤:契约先落盘(规则②,仅提醒)——只看**提供方**(Controller/路由/schema 定义) ──
-# 消费方(src/api/ 等客户端调用层、前端页面 router)是「跟随契约」不是「改契约」,不提醒——
-# 宽匹配在真实仓回放中 59% 提交误响,常驻红字=没有红字(评估 D2)。按项目调下面两个 env;
-# 更精的收法(自行升级):只匹配 diff 内容里新增/删除的路由定义与 DTO 字段,或只在重轨提醒。
-CONTRACT_HINT="${BUS_CONTRACT_HINT:-controller|endpoint|schema|\.proto|routes?/|router\.(go|py|rb|php|java|kt)}"
-CONTRACT_SKIP="${BUS_CONTRACT_SKIP:-(^|/)api(s)?/|(^|/)src/router/|/client(s)?/|request}"
-hint_hits=$(printf '%s\n' "$STAGED" | grep -iE "$CONTRACT_HINT" | grep -viE "$CONTRACT_SKIP" || true)
-if [ -n "$hint_hits" ] && ! printf '%s\n' "$STAGED" | grep -q 'PROTOCOL\.md'; then
-  echo "⚠️  暂存文件疑似动了接口**提供方**($(printf '%s\n' "$hint_hits" | head -1) 等)—— 跨边界行为变了的话,先改 contracts/PROTOCOL.md 再动代码(规则②;此为提醒不拦截)"
-fi
-
-exit 0

package/templates/scripts/verify-status.sh

@@ -1,105 +0,0 @@
-#!/usr/bin/env bash
-# verify-status.sh —— 工程层验证能力(证据分级 L3「自动化测试过」的兜底;bus-check §2.7 自动调用)
-# 本脚本按自身位置定位协调层根,放 <根>/scripts/ 或 <根>/pm/scripts/ 均可(紧凑布局见 SKILL §3);下文命令示例按默认布局写。
-# 三种用法:
-#   bash scripts/verify-status.sh        # 打印各套件状态:套件 | 命令 | 上次全绿时间(bus-check 调的是这个)
-#   bash scripts/verify-status.sh --run  # 逐套件真跑;全绿的套件记录「上次全绿时间」到标记文件
-#   bash scripts/verify-status.sh --format=machine
-#                                       # 给 bus-check 返回稳定 TSV finding,不打印人类文案
-# 接入:改 SUITES 数组即可(名称|命令;命令里自己 cd 进子仓)。标记文件 .last-green-<套件>(与本脚本同目录)
-# 是本地实查产物,不入 git(gitignore.template 已排除)——新机器上显示"从未全绿"是诚实的:你确实没在这台机器跑过。
-set -uo pipefail
-# 协调层根 = 向上最近的含 pm/NOW.md 的目录;SDIR = 本脚本目录(相对根)。见 bus-check.sh 同段注释。
-_sd="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-ROOT="$_sd"; for _ in 1 2 3 4; do [ -f "$ROOT/pm/NOW.md" ] && break; ROOT="$(dirname "$ROOT")"; done
-[ -f "$ROOT/pm/NOW.md" ] || ROOT="$(cd "$_sd/.." && pwd)"
-SDIR="${_sd#"$ROOT"/}"; [ "$SDIR" = "$_sd" ] && SDIR="."
-cd "$ROOT" || exit 1
-
-# 套件表:名称|命令(示例:npm / mvn 各一,按项目替换;没有测试就留占位符,bus-check 会如实红字)
-SUITES=(
-  "<套件1>|cd <代码子仓1> && npm test --silent"
-  "<套件2>|cd <代码子仓2> && mvn -q test"
-)
-
-RUN=0; FORMAT="human"
-for arg in "$@"; do
-  case "$arg" in
-    --run) RUN=1 ;;
-    --format=machine) FORMAT="machine" ;;
-    *) echo "verify-status: unknown argument: $arg" >&2; exit 2 ;;
-  esac
-done
-[ "$RUN" = 0 ] || [ "$FORMAT" = "human" ] || {
-  echo "verify-status: --run cannot be combined with --format=machine" >&2
-  exit 2
-}
-
-emit_machine_finding() {
-  code="$1"; level="$2"; message="$3"; path="$4"
-  message="$(printf '%s' "$message" | tr '\t\r\n' '   ')"
-  path="$(printf '%s' "$path" | tr '\t\r\n' '   ')"
-  printf 'FINDING\t%s\t%s\t%s\t%s\n' "$code" "$level" "$message" "$path"
-}
-
-mark_epoch() {
-  value="$1"
-  if date -j -f '%Y-%m-%d %H:%M' "$value" '+%s' >/dev/null 2>&1; then
-    date -j -f '%Y-%m-%d %H:%M' "$value" '+%s'
-  elif date -d "$value" '+%s' >/dev/null 2>&1; then
-    date -d "$value" '+%s'
-  else
-    return 1
-  fi
-}
-
-n=0; ph_warned=0; failed=0
-for pair in "${SUITES[@]:-}"; do
-  [ -n "$pair" ] || continue
-  case "$pair" in *"<"*)
-    if [ "$ph_warned" = 0 ] && [ "$FORMAT" = "human" ]; then
-      echo "⚠️  SUITES 还是占位符 —— 填入真实测试命令,L3 级证据才有兜底(没有测试?先补,见 SKILL §8.5 第 3 步)"
-    fi
-    ph_warned=1; continue;; esac
-  n=$((n+1))
-  name="${pair%%|*}"; cmd="${pair#*|}"
-  mark="$SDIR/.last-green-$name"
-  if [ "$RUN" = 1 ]; then
-    echo "▸ 跑 $name:$cmd"
-    if bash -c "$cmd"; then
-      date '+%Y-%m-%d %H:%M' > "$mark"; echo "✅ $name 全绿 → 已记 $(cat "$mark")"
-    else
-      echo "❌ $name 未过 —— 修完再跑 --run 刷新「上次全绿」"
-      failed=$((failed + 1))
-    fi
-  elif [ "$FORMAT" = "human" ]; then
-    last="从未全绿(或没在本机跑过)"; [ -f "$mark" ] && last="$(cat "$mark")"
-    printf '%s | %s | 上次全绿:%s\n' "$name" "$cmd" "$last"
-  else
-    max_age_days="${BUS_L3_MAX_AGE_DAYS:-7}"
-    case "$max_age_days" in ''|*[!0-9]*) max_age_days=7 ;; esac
-    if [ ! -f "$mark" ]; then
-      emit_machine_finding "sync.l3_stale" "warning" "Configured L3 suite '$name' has no local all-green marker." "$mark"
-      continue
-    fi
-    last="$(head -1 "$mark" 2>/dev/null || true)"
-    if ! last_epoch="$(mark_epoch "$last")"; then
-      emit_machine_finding "sync.l3_stale" "warning" "Configured L3 suite '$name' has an unreadable all-green marker." "$mark"
-      continue
-    fi
-    now_epoch="$(date '+%s')"
-    age_days=$(( (now_epoch - last_epoch) / 86400 ))
-    if [ "$age_days" -gt "$max_age_days" ]; then
-      emit_machine_finding "sync.l3_stale" "warning" "Configured L3 suite '$name' is stale ($age_days days > $max_age_days days)." "$mark"
-    fi
-  fi
-done
-if [ "$n" = 0 ]; then
-  if [ "$FORMAT" = "machine" ]; then
-    emit_machine_finding "sync.l3_unconfigured" "unverified" "No real L3 suite is configured." "$SDIR/verify-status.sh"
-  elif [ "$RUN" = 1 ]; then
-    echo "(没有可跑的套件)"
-  fi
-fi
-[ "$failed" -eq 0 ] || exit 1
-exit 0

package/templates//346/214/207/346/214/245/345/217/260.md

@@ -1,58 +0,0 @@
-# 指挥台 — Builder 怎么驱动工作包内的 AI 视角
-
-> 忘了怎么开场就看这页。先从看板认领一个端到端工作包;同一个 Builder 对它从判断、实现、测试一直负责到合并/发布证据。每个 session 一开就自动读 `AGENTS.md` + `pm/NOW.md`,你基本只需说「**开工 / 接着做 / 当前工作包该你这个视角了**」,剩下它自驱。
-> **每个 session 第一次对话只设定 AI 视角**:「你是当前工作包的产品/全栈/测试视角,负责……(照 `AGENTS.md` §1 表说)」;这不是人类岗位或成员分配。
-
-| AI 视角 Session | 在哪开(cwd) | 你的一句话 | 它在当前工作包内自动做啥 |
-|---|---|---|---|
-| **产品** | `pm/` | 「把需求X拆工单」/「验收X」 | 定一个覆盖多个子项的工作包、维护决策收件箱、更看板、按包记 decisions、收敛候选 hash 集;review-ready 后派一次 reviewer |
-| **全栈** | 工作区根 | 「看板上需求X该你了,开工」 | 读工作包+契约 → 在范围内持续实现 → 每提交过机器闸 → 只记实现语义 delta → 工作包/里程碑时状态带 hash + CHANGELOG |
-| **测试** | `<被测仓>/` | 「跑X的E2E + 走查设计」 | 黑盒 E2E + 带图设计走查 → 直接提 bug → 给里程碑核查提供证据 |
-
-## 工作包闭环
-同一个 Builder 对这一整条负责:1. **产品视角**收敛规格 + 人拍板 **⛔Gate1** → 2. 产品视角写设计 brief(要求单 HTML 可渲染)→ 设计工具出稿 → **真渲染后人拍板 ⛔Gate2** → 3. **全栈视角**实现(先改 PROTOCOL、每提交过机器闸、写者自发现问题先收敛;只有改冻结对外语义/不可逆副作用才提前 `risk-delta`)→ 4. **测试视角** E2E + 带图走查 → review-ready 后 milestone reviewer 静默全核**一次** → P0/P1 合并修完后 closure **一次** → **⛔Gate3 人确认合并** → 5. 部署候选 → **⛔Gate4 人确认上线** → 工作包收尾。多个 Builder 并行时各走自己的闭环,不把这条链拆成人类岗位流水线。
-
-> **会话不按子任务交还接力棒**:每轮先认领 `objective / in_scope / terminal_condition`;文档、commit、reviewer、status 都可能只是包内步骤。范围内仍有安全工作就继续,不等你再说“继续”。
-> **审批只分三档**:跨 Gate/扩范围/改冻结契约/不可逆外部动作/风险接受才 `STOP_NOW`;冻结前可逆选择进看板收件箱,到 Gate 默认一次批 2–5 个(确实只有 1 个就单项);事实、推导约束、归档/status/P2 等无需批。
-> **人批预算**:每个工作包、每道 Gate 默认只发 1 个批量请求。你只答一部分或要解释时,会话保持同一决策包继续说明,不会重新包装成“第二次审批”;不阻塞的工作照常继续。
-> 决策包收敛后,当前工作包的产品视角先落 `pm/decisions.md` 一行再回写各处;部分回答只更新收件箱,不为 `3/14 → 11/14 → 14/14` 制造三条台账。**线上是什么版本别问会话、别信文档,跑 `bash scripts/bus-check.sh` 看实况**。
-> **三轨制**:小改快轨 / 单功能标准轨 / 契约变更重轨(`pm/changes/` 提案)。本期走哪轨看 `pm/NOW.md`。
-> **核查门不按任务数收费**:首次 milestone 前不启动 reviewer;review-ready 后每工作包每 Gate 默认 1 次 milestone,P0/P1 合并修完后 1 次 closure,P2 不复核。reviewer 单次静默核完再返回,不播报中间 findings。同一 candidate 复用结论;返回前 hash 变化就标 `SUPERSEDED` 并停止,不得边改边 delta。
-> **4 个 Gate 不可自动跨过**;reviewer 批准 ≠ 你合并。你只是节拍器,信息全在 repo 里流动,不用你搬运。
-
-## 域回复怎么写
-
-每个 AI 视角面向人收口或交接时,统一按「已做 → 未做 → 下一步」回复:
-
-```md
-## 〔当前域〕｜✅ 已完成 / 🔄 未完成
-
-### 已做
-1. 〔功能或业务结果〕
-   - 证据：〔commit、测试结果或报告〕
-
-### 未做
-1. 〔还没完成或没验证什么〕
-   - 原因：〔具体原因〕
-
-### 下一步
-- **本域已完成：** 下一棒是〔哪个域 / AI 视角〕，负责〔业务级目标〕。
-- **本域未完成：** 需要〔谁〕提供或确认〔什么〕。
-- **无需协助：** 我继续做，暂不交棒。
-```
-
-`已做`只写功能/业务结果,证据紧跟对应事项;多项共用时在列表末写「共同证据」。`未做`要写原因,没有就写「无」。`下一步`只保留符合当前状态的一条;工作包已完成就写「下一棒:无」。没有真实阻塞就继续做,不把自己能解决的事包装成求助。完整口径见 `AGENTS.md` 的「域回复格式」。
-
-## 检查结果怎么读
-
-先跑 `bash scripts/bus-check.sh --strict`,再按级别读摘要；exit 0 只表示没有 `conflict/error`,不表示所有范围都核过。
-
-| Level | 含义 | 怎么办 |
-|---|---|---|
-| `confirmed` | 一条事实已直接观测 | 只复用该事实,不外推全绿 |
-| `warning` | 有风险/追溯弱点,但尚无确定矛盾 | 按 `path` 定位,受影响 Gate 前处理或明确挂账 |
-| `unverified` | 工具没可靠核到这段范围 | 补证据/工具/权限后重跑,收尾必须列出 |
-| `conflict` | 声明与事实矛盾或必需证据缺失 | 先修再重跑；strict 阻断 |
-| `error` | 协议结构或检查过程不可信 | 先修格式/唯一性/检查器；strict 阻断 |
-
-常见处置：`sync.scan_truncated` 看 `reason=limit|symlink|permission`——先确认省略范围,不要为消警盲抬阈值；symlink 目标单独核或落成根内 regular file；权限只补最小读取/目录搜索能力。`sync.l3_*` 配真实套件或刷新证据；`gate.* / evidence.* / ref.*` 修 canonical 行与证据引用；`stack.drift / sync.multirepo_drift` 回权威来源逐项对齐,脚本不代改。JSON 中 `coverage.complete=false` 时,结论只能写“已覆盖部分 + 未验证边界”。