merge sandbox/ai-1790562657-0EF743: chg_0001 dth scaffold + chg_0002 experiment_platform MVP

- chg_0001_dth_scaffold (skip_coverage): openspec framework + NestJS+React+PGlite scaffold
- chg_0002_sp1_experiment_platform_mvp: 6 scenarios S1-S6 + 21 perm-smoke + 16 e2e + 3 demo operators (hello-mpc/pir/vertical-lr)

Sandbox task exit 0. Independent verification: check_spec_coverage.sh gap=0 PASS.
Co-Authored-By: Claude Opus 4.8 <[email protected]>
This commit is contained in:
xstudio agent committed 2026-09-28 10:54:34 +08:00
commit c1cf6f54e5
314 files changed
+55077

No files matched your search

+581
View File
@@ -0,0 +1,581 @@
#!/usr/bin/env bash
# ==============================================================================
# scripts/check_spec_coverage.sh (skill: ai-collab-framework)
# 校验 openspec/changes/ 下每个 chg_* 变更目录(含 archive/ 下带日期前缀的归档项):
# - 每个 scenario id 在 spec.md 中以 '### S<n>' 标题行存在
# - 每个 case id 在 testcases.md 中存在
# - 每个 case 的 Bound Task 在 tasks.md 中存在(反向校验)
# - spec.md 结构校验(借鉴 OpenSpec delta 约定):
# * 含 '## ADDED/MODIFIED/REMOVED Scenarios' 任一段即进入 delta 模式,
# 所有 S 块必须归属某个 delta 段(不允许散落在其他段下)
# * ADDED/MODIFIED/全量模式下的场景块必须非空壳(至少一条 **WHEN** 与 **THEN**)
# * REMOVED 块必须带 Reason 与 Migration
# * 与 openspec/specs/<capability>/spec.md 交叉核对:
# ADDED 的 id 不得已存在;MODIFIED/REMOVED 的 id 必须已存在;
# 主 spec 不存在时(新 capability)只允许 ADDED
# - proposal.md frontmatter 'skip_coverage: true' 豁免整个 chg
# (纯 refactor/docs/tooling 等不改行为的变更;勿为过门禁编造场景)
# - 每条 src/ 改动落在 implementation_files 白名单内
# (需要目标项目是 git 仓库;否则显式 WARN,不静默放行)
# 退出码:0 = pass;非 0 = 阻塞
#
# 用法:PROJECT_ROOT=<项目路径> bash scripts/check_spec_coverage.sh [--json]
# (PROJECT_ROOT 默认取当前目录;脚本可以放在技能包里,不必在项目内)
# --json:机器消费模式。stdout 输出单一 JSON document;文本输出全部抑制;
# 退码语义不变(0 = pass, 1 = fail)。错误信封采用 OpenSpec 风格
# `{ status: [{severity, code, message, fix?}] }`(仅在有 failure 时出现)。
# 默认模式 stdout 字节级不变(保护 `set -e` CI 消费者)。
# 回归自测:bash scripts/selftest_check_spec_coverage.sh (改本脚本后必跑)
# ==============================================================================
set -euo pipefail
# ---- 参数解析(必须在 source parse.sh 之前;JSON_MODE 影响后续行为)----
JSON_MODE=0
for arg in "$@"; do
case "$arg" in
--json) JSON_MODE=1 ;;
-h|--help)
sed -n '2,30p' "$0" | sed 's/^# \{0,1\}//'
exit 0
;;
*)
echo "FAIL: 未知参数 '$arg'(仅支持 --json / --help)" >&2
exit 2
;;
esac
done
# ---- 公共解析器(scripts/lib/parse.sh)----
# 改 parse.sh 里的解析函数前请跑 selftest_check_spec_coverage.sh 验证 gate 默认行为不变。
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
# shellcheck source=lib/parse.sh
. "$SCRIPT_DIR/lib/parse.sh"
# ---- JSON 累积器(仅 JSON_MODE=1 时填充)----
# 每个 chg 累积为一个 JSON object(字符串),终态用 jq 合并。
# 字段:name / status / failure_count / warning_count / failures / warnings
JSON_CHG_ENTRIES=""
# 全局 findings 数组(cross-chg 共享;信封失败时也归入)
JSON_FINDINGS=""
# json_quote: 把字符串安全嵌入 JSON。\n / " / \ 处理;其余原样。
# 不追求 RFC 7159 全部边界——只覆盖本脚本实际出现的字符(中英文 / 路径 / S<n>)。
json_quote() {
local s="$1"
s=${s//\\/\\\\}
s=${s//\"/\\\"}
s=${s// /\\t}
# 多行字串:把换行替换为字面 \n(让 jq 解析成单行 JSON value)
s=${s//$'\n'/\\n}
printf '"%s"' "$s"
}
# json_record_failure <code> <message> <fix?> [change_name]
# 同时累积到当前 chg(如果给定 change_name)和全局 findings。
json_record_failure() {
local code="$1" msg="$2" fix="${3:-}" chg="${4:-}"
local fix_json="null"
[ -n "$fix" ] && fix_json=$(json_quote "$fix")
local entry
entry=$(printf '{"severity":"error","code":%s,"message":%s,"fix":%s}' \
"$(json_quote "$code")" "$(json_quote "$msg")" "$fix_json")
if [ -n "$chg" ]; then
JSON_CHG_FAILURES="${JSON_CHG_FAILURES:+$JSON_CHG_FAILURES,}$entry"
fi
JSON_FINDINGS="${JSON_FINDINGS:+$JSON_FINDINGS,}$entry"
}
json_record_warning() {
local code="$1" msg="$2" chg="${3:-}"
local entry
entry=$(printf '{"severity":"warning","code":%s,"message":%s}' \
"$(json_quote "$code")" "$(json_quote "$msg")")
if [ -n "$chg" ]; then
JSON_CHG_WARNINGS="${JSON_CHG_WARNINGS:+$JSON_CHG_WARNINGS,}$entry"
fi
JSON_FINDINGS="${JSON_FINDINGS:+$JSON_FINDINGS,}$entry"
}
# ROOT: the project that uses this skill (NOT the skill's own location).
# Default: current working directory. Override with PROJECT_ROOT=<path>.
ROOT="${PROJECT_ROOT:-$(pwd)}"
CHANGES_DIR="$ROOT/openspec/changes"
EXIT=0
# implementation_files 白名单校验依赖 git。先判定环境能力,缺什么就 WARN 什么,
# 不允许静默不生效(无 git 仓库时白名单曾完全不起作用且无任何提示)。
GIT_OK=0
if git -C "$ROOT" rev-parse --git-dir >/dev/null 2>&1; then
GIT_OK=1
fi
# base 分支:让「本 chg 已 commit 的 src/ 改动」也纳入比对。
# 可用 SPEC_COVERAGE_BASE=<ref> 显式指定。
BASE_REF=""
if [ "$GIT_OK" = "1" ]; then
BASE_REF="${SPEC_COVERAGE_BASE:-}"
if [ -z "$BASE_REF" ]; then
for cand in origin/main origin/master main master; do
if git -C "$ROOT" rev-parse --verify -q "$cand" >/dev/null 2>&1; then
BASE_REF="$cand"
break
fi
done
fi
fi
# ---- 输出层 ----
# 文本模式:emit = echo(行为与 v2.4.0 字节级一致)
# JSON 模式:emit 不打印,仅把结构化数据累积到 JSON_CHG_ENTRIES;终态输出单一 JSON
# 唯一的差异是 JSON 模式下文本输出完全抑制。
if [ "$JSON_MODE" = "0" ]; then
echo "==[ check_spec_coverage ]================================="
echo "ROOT: $ROOT"
if [ "$GIT_OK" = "1" ]; then
echo "git: base=${BASE_REF:-<none, 只比对未提交改动>}"
fi
echo
fi
# Use find instead of globbing so this works in both bash and zsh.
# '*chg_*' 同时覆盖活动目录 chg_NNNN_<slug> 与归档项 archive/YYYY-MM-DD-chg_NNNN_<slug>。
while IFS= read -r d; do
[ -d "$d" ] || continue
MAP="$d/testcases.map.yaml"
SPEC="$d/spec.md"
TC="$d/testcases.md"
TASKS="$d/tasks.md"
PROPOSAL="$d/proposal.md"
CHG_FAIL=0
# 归档项只校验自身结构完整性;与主 spec 的指向核对(ADDED 不得已在/REMOVED 必须在)
# 只对活动 chg 做——归档时 delta 已合并进主 spec,再核对必然误报。
IS_ARCH=0
case "$d" in */archive/*) IS_ARCH=1 ;; esac
CHG_NAME=$(basename "$d")
JSON_CHG_FAILURES=""
JSON_CHG_WARNINGS=""
if [ "$JSON_MODE" = "0" ]; then
echo "── change: $CHG_NAME"
fi
# skip 豁免(借鉴 OpenSpec skip_specs):声明非行为变更则整个 chg 不再要求工件。
# 豁免标记只能写在 proposal.md 里——proposal 本身仍必需。
if grep -qE '^skip_coverage:[[:space:]]*true' "$PROPOSAL" 2>/dev/null; then
if [ "$JSON_MODE" = "0" ]; then
echo " SKIP proposal.md 声明 skip_coverage: true(非行为变更豁免),其余工件不校验"
fi
# JSON 模式:记录 SKIP 状态
if [ "$JSON_MODE" = "1" ]; then
entry=$(printf '{"name":%s,"status":"SKIP","failures":[],"warnings":[]}' \
"$(json_quote "$CHG_NAME")")
JSON_CHG_ENTRIES="${JSON_CHG_ENTRIES:+$JSON_CHG_ENTRIES,}$entry"
fi
continue
fi
# Required files(tasks.md 纳入必需:Bound Task 反向校验以它为基准)
for f in "$PROPOSAL" "$SPEC" "$TC" "$TASKS" "$MAP"; do
if [ ! -f "$f" ]; then
if [ "$JSON_MODE" = "0" ]; then
echo " FAIL MISSING: $f"
fi
json_record_failure "MISSING_FILE" "required file missing: $f" "建工件后重跑门禁" "$CHG_NAME"
EXIT=1
CHG_FAIL=1
fi
done
[ ! -f "$MAP" ] && continue
# 注意:set -o pipefail 下「grep 无匹配」会让整条管道非 0,
# 不加 `|| true` 时脚本会中途静默退出(既不报错也不继续检查后续 chg)。
SCEN_IDS=$(grep -oE 'id:[[:space:]]*[A-Za-z0-9_]+' "$MAP" 2>/dev/null | awk '{print $2}' | sort -u || true)
CASE_IDS=$(grep -oE 'cases:[[:space:]]*\[[^]]*\]' "$MAP" 2>/dev/null \
| grep -oE 'C[0-9]+_[A-Za-z0-9_]+' | sort -u || true)
N_SCEN=$(echo $SCEN_IDS | wc -w | xargs)
N_CASE=$(echo $CASE_IDS | wc -w | xargs)
if [ "$JSON_MODE" = "0" ]; then
echo " scenarios: $N_SCEN"
echo " cases: $N_CASE"
fi
# 防空跑:解析不到内容说明 map.yaml 结构不符合约定,此时必须 FAIL 而不是静默放行
if [ "$N_SCEN" = "0" ]; then
if [ "$JSON_MODE" = "0" ]; then
echo " FAIL map.yaml 未解析出任何 scenario(需要形如 'id: S1' 的行): $MAP"
fi
json_record_failure "MAP_EMPTY_SCENARIOS" \
"map.yaml 未解析出任何 scenario(需要形如 'id: S1' 的行): $MAP" \
"在 map.yaml scenarios: 段为每个场景写 'id: Sn' 行" "$CHG_NAME"
EXIT=1
CHG_FAIL=1
fi
if [ "$N_CASE" = "0" ]; then
if [ "$JSON_MODE" = "0" ]; then
echo " FAIL map.yaml 未解析出任何 case(需要形如 'cases: [C1_xxx]' 的行): $MAP"
fi
json_record_failure "MAP_EMPTY_CASES" \
"map.yaml 未解析出任何 case(需要形如 'cases: [C1_xxx]' 的行): $MAP" \
"在 map.yaml scenarios: 段为每条 case 写 'cases: [C1_xxx]' 列表" "$CHG_NAME"
EXIT=1
CHG_FAIL=1
fi
for sid in $SCEN_IDS; do
if ! grep -qE "^###[[:space:]]+${sid}([[:space:]]|:|$)" "$SPEC" 2>/dev/null; then
if [ "$JSON_MODE" = "0" ]; then
echo " FAIL scenario $sid NOT in $SPEC"
echo " spec.md 需含字面标题行 '### $sid' 或 '### $sid <场景名>'(门禁按标题匹配)"
echo " 「$sid/6 同 xxx」这类缩写合并写法不被识别,请逐场景写出标题"
fi
json_record_failure "SCENARIO_NOT_IN_SPEC" \
"scenario $sid NOT in $SPEC" \
"spec.md 需含字面标题行 '### $sid' 或 '### $sid <场景名>'(门禁按标题匹配)" \
"$CHG_NAME"
EXIT=1
CHG_FAIL=1
fi
done
for cid in $CASE_IDS; do
if ! grep -qF "$cid" "$TC" 2>/dev/null; then
if [ "$JSON_MODE" = "0" ]; then
echo " FAIL case $cid NOT in $TC"
fi
json_record_failure "CASE_NOT_IN_TESTCASES" \
"case $cid NOT in $TC" \
"在 testcases.md 写 '### $cid' 标题 + 至少一条用例" "$CHG_NAME"
EXIT=1
CHG_FAIL=1
fi
done
# 反向校验:testcases.md 里的 Bound Task 必须真实存在于 tasks.md
BT_IDS=$(grep -oE 'Bound Task:[[:space:]]*T[0-9]+' "$TC" 2>/dev/null | grep -oE 'T[0-9]+' | sort -u || true)
for t in $BT_IDS; do
if ! grep -qE "id:[[:space:]]*${t}([^0-9A-Za-z_]|$)" "$TASKS" 2>/dev/null; then
if [ "$JSON_MODE" = "0" ]; then
echo " FAIL Bound Task $t (referenced in $TC) NOT in $TASKS"
fi
json_record_failure "BOUND_TASK_NOT_IN_TASKS" \
"Bound Task $t (referenced in $TC) NOT in $TASKS" \
"在 tasks.md 写 'id: $t' 行,或修改 testcases.md 的 'Bound Task: $t' 指向真实任务" \
"$CHG_NAME"
EXIT=1
CHG_FAIL=1
fi
done
# ---- spec.md 结构校验(delta 模式 / 空壳 / REMOVED 完整性 / 主 spec 交叉核对)----
DELTA_MODE=0
if grep -qE '^##[[:space:]]+(ADDED|MODIFIED|REMOVED)[[:space:]]+Scenarios' "$SPEC" 2>/dev/null; then
DELTA_MODE=1
fi
ADDED_IDS=""; MOD_IDS=""; REM_IDS=""
S_BLOCKS=$(extract_s_blocks "$SPEC")
while IFS=$'\t' read -r sid kind flag1 flag2; do
[ -z "$sid" ] && continue
if [ "$DELTA_MODE" = "1" ] && [ "$kind" = "PLAIN" ]; then
if [ "$JSON_MODE" = "0" ]; then
echo " FAIL scenario $sid 散落在 delta 段之外(delta 模式下每个 S 块必须位于"
echo " '## ADDED|MODIFIED|REMOVED Scenarios' 三个段落之一)"
fi
json_record_failure "SCENARIO_OUTSIDE_DELTA" \
"scenario $sid 散落在 delta 段之外(delta 模式下每个 S 块必须位于 '## ADDED|MODIFIED|REMOVED Scenarios' 三个段落之一)" \
"把 $sid 移到对应的 delta 段下" "$CHG_NAME"
EXIT=1; CHG_FAIL=1
fi
case "${flag1:-}" in
NO-WHEN|NO-THEN|NO-REASON|NO-MIGRATION)
if [ "$JSON_MODE" = "0" ]; then
echo " FAIL scenario $sid ($kind) 块不完整:缺 ${flag1#NO-}"
case "${flag2:-}" in
NO-*) echo " 同时缺 ${flag2#NO-}" ;;
esac
if [ "$kind" = "REMOVED" ]; then
echo " REMOVED 块需含 **Reason** 与 **Migration** 两行"
else
echo " 场景块至少需各一条 '- **WHEN**' 与 '- **THEN**'(空壳场景不放行)"
fi
fi
# 错误信息合并:flag1/flag2 一起;fix 提示根据 kind 分支
local_fix="在 $sid 场景块下加 '- **WHEN**' 与 '- **THEN**' 各一条(REMOVED 块需 **Reason** 与 **Migration**)"
json_record_failure "INCOMPLETE_SCENARIO_BLOCK" \
"scenario $sid ($kind) 块不完整:缺 ${flag1#NO-}${flag2:+; 同时缺 ${flag2#NO-}}" \
"$local_fix" "$CHG_NAME"
EXIT=1; CHG_FAIL=1
;;
esac
case "$kind" in
ADDED) ADDED_IDS="$ADDED_IDS $sid" ;;
MODIFIED) MOD_IDS="$MOD_IDS $sid" ;;
REMOVED) REM_IDS="$REM_IDS $sid" ;;
esac
done <<< "$S_BLOCKS"
if [ "$DELTA_MODE" = "1" ] && [ "$IS_ARCH" = "0" ]; then
CAP=$(grep -m1 '^# Spec:' "$SPEC" 2>/dev/null | sed -E 's/^#[[:space:]]*Spec:[[:space:]]*//; s/[[:space:]]+$//' || true)
if [ -n "$CAP" ] && [ "${CAP#*<}" = "$CAP" ]; then
MAIN="$ROOT/openspec/specs/$CAP/spec.md"
if [ ! -f "$MAIN" ]; then
if [ -n "${MOD_IDS// /}" ] || [ -n "${REM_IDS// /}" ]; then
if [ "$JSON_MODE" = "0" ]; then
echo " FAIL spec 声明了 MODIFIED/REMOVED,但主 spec 不存在: $MAIN"
echo " 新 capability 只允许 ADDED;或确认 '# Spec:' 行的名称与 openspec/specs/ 目录一致"
fi
json_record_failure "DELTA_BUT_NO_MAIN_SPEC" \
"spec 声明了 MODIFIED/REMOVED,但主 spec 不存在: $MAIN" \
"新 capability 只允许 ADDED;或确认 '# Spec:' 行的名称与 openspec/specs/ 目录一致" \
"$CHG_NAME"
EXIT=1; CHG_FAIL=1
fi
else
for sid in $ADDED_IDS; do
if grep -qE "^###[[:space:]]+${sid}([[:space:]]|:|$)" "$MAIN" 2>/dev/null; then
if [ "$JSON_MODE" = "0" ]; then
echo " FAIL ADDED scenario $sid 已存在于主 spec(${MAIN})——应改为 MODIFIED 并整块拷贝"
fi
json_record_failure "ADDED_ALREADY_EXISTS" \
"ADDED scenario $sid 已存在于主 spec(${MAIN})" \
"应改为 MODIFIED 并整块拷贝" "$CHG_NAME"
EXIT=1; CHG_FAIL=1
fi
done
for sid in $MOD_IDS; do
if ! grep -qE "^###[[:space:]]+${sid}([[:space:]]|:|$)" "$MAIN" 2>/dev/null; then
if [ "$JSON_MODE" = "0" ]; then
echo " FAIL MODIFIED 目标 $sid 不在主 spec(${MAIN})中——MODIFIED 必须指向已存在的场景"
fi
json_record_failure "MODIFIED_NOT_IN_MAIN" \
"MODIFIED 目标 $sid 不在主 spec(${MAIN})中" \
"MODIFIED 必须指向已存在的场景,或修正场景 id" "$CHG_NAME"
EXIT=1; CHG_FAIL=1
fi
done
for sid in $REM_IDS; do
if ! grep -qE "^###[[:space:]]+${sid}([[:space:]]|:|$)" "$MAIN" 2>/dev/null; then
if [ "$JSON_MODE" = "0" ]; then
echo " FAIL REMOVED 目标 $sid 不在主 spec(${MAIN})中——REMOVED 必须指向已存在的场景"
fi
json_record_failure "REMOVED_NOT_IN_MAIN" \
"REMOVED 目标 $sid 不在主 spec(${MAIN})中" \
"REMOVED 必须指向已存在的场景,或修正场景 id" "$CHG_NAME"
EXIT=1; CHG_FAIL=1
fi
done
fi
fi
else
if [ "$JSON_MODE" = "0" ]; then
echo " note: 全量 spec(旧式)。新 chg 建议改用 '## ADDED/MODIFIED/REMOVED Scenarios' delta 段,"
echo " 归档时按标记合并进 openspec/specs/<capability>/spec.md(见 SKILL.md 归档动作)"
fi
fi
# ---- a4 cross-check: map.yaml 的 '# spec: <capability>@chg_NNNN' 注释 ----
# 与 spec.md '# Spec: <capability>' 标题对齐;同时 chg_NNNN 与目录 basename 对齐。
# 注释缺失不阻塞(保持向后兼容——老 fixture 没填注释;新 chg 应照模板写注释)。
# 双方都写了但不一致 = FAIL(jxcj 实跑教训:comment 是纯装饰时两处写歪没人发现)。
SPEC_CAP=$(grep -m1 '^# Spec:' "$SPEC" 2>/dev/null | sed -E 's/^#[[:space:]]*Spec:[[:space:]]*//; s/[[:space:]]+$//' || true)
MAP_SPEC_LINE=$(grep -m1 -E '^[[:space:]]*#[[:space:]]*spec:[[:space:]]*[^[:space:]]+@chg_[0-9]+' "$MAP" 2>/dev/null || true)
if [ -n "$MAP_SPEC_LINE" ] && [ -n "$SPEC_CAP" ]; then
MAP_CAP=$(printf '%s\n' "$MAP_SPEC_LINE" | sed -E 's/.*spec:[[:space:]]*([^@[:space:]]+)@.*/\1/')
MAP_CHG=$(printf '%s\n' "$MAP_SPEC_LINE" | sed -E 's/.*@chg_([0-9]+).*/chg_\1/')
# 占位符(<...>)跳过 capability 比对——模板原文/未替换的 chg 不应判 FAIL。
# chg_NNNN 与目录对齐仍查(学用临时值也会被检出)。
if [[ "$MAP_CAP" != *"<"* ]] && [[ "$MAP_CAP" != *">"* ]] && [ "$MAP_CAP" != "$SPEC_CAP" ]; then
if [ "$JSON_MODE" = "0" ]; then
echo " FAIL map.yaml '# spec: $MAP_CAP@...' 与 spec.md '# Spec: $SPEC_CAP' capability 不一致"
echo " 两处 capability 名要对齐;chg 改一处时另一处也要改"
fi
json_record_failure "CAPABILITY_COMMENT_MISMATCH" \
"map.yaml '# spec: $MAP_CAP@...' 与 spec.md '# Spec: $SPEC_CAP' capability 不一致" \
"两处 capability 名要对齐;chg 改一处时另一处也要改" "$CHG_NAME"
EXIT=1; CHG_FAIL=1
fi
DIR_CHG=$(basename "$d")
case "$DIR_CHG" in
${MAP_CHG}_*|archive/*-${MAP_CHG}_*) ;;
*)
if [ "$JSON_MODE" = "0" ]; then
echo " FAIL map.yaml 注释 chg id '$MAP_CHG' 与目录 basename '$DIR_CHG' 不一致"
fi
json_record_failure "CHG_ID_COMMENT_MISMATCH" \
"map.yaml 注释 chg id '$MAP_CHG' 与目录 basename '$DIR_CHG' 不一致" \
"把 map.yaml '# spec: ...@$MAP_CHG' 改为当前目录对应的 chg_NNNN" "$CHG_NAME"
EXIT=1; CHG_FAIL=1
;;
esac
fi
# ---- implementation_files 走白名单 ----
# 把白名单条目直接当 git pathspec 用(不再硬编 src/);这样 monorepo/非根 src/
# 布局(backend/src/、packages/foo/src/ 等)也能真实生效(jxcj 实跑教训:
# 'git diff -- src/' 只匹配仓库根 src/,monorepo 下等于没查、且不 WARN)。
# 解析规则:在 'implementation_files:' 之后取 yaml 列表项(' - path'),
# 跳过空行、行末注释、缩进错位。
IMPL_PATHS=()
while IFS= read -r p; do
[ -n "$p" ] && IMPL_PATHS+=("$p")
done < <(awk '
/implementation_files:/ { in_block = 1; next }
in_block && /^[[:space:]]*-[[:space:]]*/ {
line = $0
sub(/^[[:space:]]*-[[:space:]]*/, "", line)
sub(/[[:space:]]*#.*$/, "", line)
sub(/[[:space:]]+$/, "", line)
if (line != "") print line
next
}
in_block && /^[[:space:]]*[A-Za-z_]/ { in_block = 0 }
' "$MAP" 2>/dev/null)
if [ "${#IMPL_PATHS[@]}" -gt 0 ]; then
if [ "$GIT_OK" = "0" ]; then
if [ "$JSON_MODE" = "0" ]; then
echo " WARN $ROOT 不是 git 仓库,implementation_files 白名单未参与校验(门禁未生效,非通过)"
echo " 跑 'git init && git add -A && git commit -m init' 后重跑本脚本以启用"
fi
json_record_warning "IMPL_FILES_NO_GIT" \
"$ROOT 不是 git 仓库,implementation_files 白名单未参与校验(门禁未生效,非通过)" \
"$CHG_NAME"
else
# 未提交改动 + 相对 base 分支已提交的改动都算(只看 diff HEAD 会漏掉已 commit 的越界改动)
# 把白名单条目作为 pathspec 喂给 git:每个条目独立 arg(不再硬编 src/)
SRC_CHANGES=$(
{ git -C "$ROOT" diff --name-only HEAD "${IMPL_PATHS[@]}" 2>/dev/null || true
if [ -n "$BASE_REF" ]; then
git -C "$ROOT" diff --name-only "$BASE_REF"...HEAD "${IMPL_PATHS[@]}" 2>/dev/null || true
fi
} | sort -u
)
if [ -z "$BASE_REF" ]; then
if [ "$JSON_MODE" = "0" ]; then
echo " WARN 未找到 base 分支 (main/master),只比对了未提交的 src/ 改动"
echo " 已 commit 的越界改动不会被查到;可用 SPEC_COVERAGE_BASE=<ref> 指定基线"
fi
json_record_warning "NO_BASE_REF" \
"未找到 base 分支 (main/master),只比对了未提交的 src/ 改动" \
"$CHG_NAME"
fi
# 友好提示(不阻塞):白名单全以 src/ 开头但仓库根无 src/ 目录——
# 这正是历史上 monorepo 静默失效的入口;现在 pathspec 已按 entries 真实查找,
# 但作者可能漏掉了真实子目录(如 backend/src/)。
if printf '%s\n' "${IMPL_PATHS[@]}" | grep -q '^src/' && [ ! -d "$ROOT/src" ]; then
if [ "$JSON_MODE" = "0" ]; then
echo " note 白名单条目以 src/ 开头但 $ROOT 下无 src/ 目录(monorepo?)。"
echo " 把条目改为真实子路径(如 backend/src/)以避免歧义。门禁按条目路径生效,不阻塞。"
fi
fi
for path in $SRC_CHANGES; do
ok=0
for allowed in "${IMPL_PATHS[@]}"; do
if [[ "$path" == "$allowed"* ]]; then ok=1; break; fi
done
if [ "$ok" = "0" ]; then
if [ "$JSON_MODE" = "0" ]; then
echo " WARN out-of-scope src change: $path"
fi
json_record_failure "OUT_OF_SCOPE_SRC" \
"out-of-scope src change: $path" \
"把改动移到 implementation_files 白名单内,或扩展白名单" "$CHG_NAME"
EXIT=1
CHG_FAIL=1
fi
done
fi
fi
if [ "$CHG_FAIL" = "0" ]; then
if [ "$JSON_MODE" = "0" ]; then
echo " OK"
fi
fi
# JSON 模式:把当前 chg 的累积结果作为一个 entry 入数组
if [ "$JSON_MODE" = "1" ]; then
CHG_STATUS="PASS"
[ "$CHG_FAIL" = "1" ] && CHG_STATUS="FAIL"
if grep -qE '^skip_coverage:[[:space:]]*true' "$PROPOSAL" 2>/dev/null; then
CHG_STATUS="SKIP"
fi
entry=$(printf '{"name":%s,"status":"%s","failures":[%s],"warnings":[%s]}' \
"$(json_quote "$CHG_NAME")" "$CHG_STATUS" \
"${JSON_CHG_FAILURES:-}" "${JSON_CHG_WARNINGS:-}")
JSON_CHG_ENTRIES="${JSON_CHG_ENTRIES:+$JSON_CHG_ENTRIES,}$entry"
fi
done < <(find "$CHANGES_DIR" -mindepth 1 -maxdepth 2 -type d -name '*chg_*' | sort)
# ---- 终态输出 ----
if [ "$JSON_MODE" = "0" ]; then
echo
if [ "$EXIT" = "0" ]; then
echo "==[ PASS ]== spec coverage gap = 0"
else
echo "==[ FAIL ]== see FAIL above; merge blocked"
fi
exit $EXIT
fi
# JSON 模式:构建单一 JSON document
# 字段:root / changes[] / summary{pass,fail,skip,findings} / status[] (envelope, 仅失败时)
# 计数策略:让 jq 数真值(`length` 算数组元素数),不在 bash 里用 grep 数逗号分隔符。
# 退化路径(无 jq)才用 grep 兜底。jq 调用是对自身中间输出做计算——jq 不存在时 jq 退 127,
# 也用 { || true; } 兜住,避免 set -e 终止。
if command -v jq >/dev/null 2>&1; then
PASS_CT=$(jq -nc --argjson a "[$JSON_CHG_ENTRIES]" '[ $a[] | select(.status=="PASS") ] | length')
FAIL_CT=$(jq -nc --argjson a "[$JSON_CHG_ENTRIES]" '[ $a[] | select(.status=="FAIL") ] | length')
SKIP_CT=$(jq -nc --argjson a "[$JSON_CHG_ENTRIES]" '[ $a[] | select(.status=="SKIP") ] | length')
if [ -n "$JSON_FINDINGS" ]; then
FINDING_CT=$(jq -nc --argjson a "[$JSON_FINDINGS]" '$a | length')
else
FINDING_CT=0
fi
TOTAL=$(jq -nc --argjson a "[$JSON_CHG_ENTRIES]" '$a | length')
else
# 无 jq 兜底:grep -c 数行(仅用于多 chg 计数;findings 数省略)
PASS_CT=$(printf '%s' "$JSON_CHG_ENTRIES" | { grep -oE '"status":"PASS"' || true; } | wc -l | xargs)
FAIL_CT=$(printf '%s' "$JSON_CHG_ENTRIES" | { grep -oE '"status":"FAIL"' || true; } | wc -l | xargs)
SKIP_CT=$(printf '%s' "$JSON_CHG_ENTRIES" | { grep -oE '"status":"SKIP"' || true; } | wc -l | xargs)
if [ -n "$JSON_FINDINGS" ]; then
FINDING_CT=$(printf '%s' "$JSON_FINDINGS" | { grep -oE '^\{' || true; } | wc -l | xargs)
else
FINDING_CT=0
fi
TOTAL=$((PASS_CT + FAIL_CT + SKIP_CT))
fi
# 用 jq 合并输出(如果系统无 jq,回退到 printf 拼接——后者仍能产出合法 JSON)
if command -v jq >/dev/null 2>&1; then
if [ "$EXIT" = "0" ]; then
jq -nc \
--arg root "$ROOT" \
--argjson changes "[$JSON_CHG_ENTRIES]" \
--argjson pass "$PASS_CT" \
--argjson fail "$FAIL_CT" \
--argjson skip "$SKIP_CT" \
--argjson findings_count "$FINDING_CT" \
'{root: $root, summary: {pass: $pass, fail: $fail, skip: $skip, findings: $findings_count}, changes: $changes}'
else
jq -nc \
--arg root "$ROOT" \
--argjson changes "[$JSON_CHG_ENTRIES]" \
--argjson status "[$JSON_FINDINGS]" \
--argjson pass "$PASS_CT" \
--argjson fail "$FAIL_CT" \
--argjson skip "$SKIP_CT" \
--argjson findings_count "$FINDING_CT" \
'{root: $root, status: $status, summary: {pass: $pass, fail: $fail, skip: $skip, findings: $findings_count}, changes: $changes}'
fi
else
# 无 jq 回退(仅用于无 jq 环境,CI 一般有 jq)
if [ "$EXIT" = "0" ]; then
printf '{"root":"%s","summary":{"pass":%s,"fail":%s,"skip":%s,"findings":%s},"changes":[%s]}\n' \
"$ROOT" "$PASS_CT" "$FAIL_CT" "$SKIP_CT" "$FINDING_CT" "$JSON_CHG_ENTRIES"
else
printf '{"root":"%s","status":[%s],"summary":{"pass":%s,"fail":%s,"skip":%s,"findings":%s},"changes":[%s]}\n' \
"$ROOT" "$JSON_FINDINGS" "$PASS_CT" "$FAIL_CT" "$SKIP_CT" "$FINDING_CT" "$JSON_CHG_ENTRIES"
fi
fi
exit $EXIT
+74
View File
@@ -0,0 +1,74 @@
#!/usr/bin/env bash
# ==============================================================================
# scripts/create_change.sh (skill: ai-collab-framework)
# 简化版 change 创建:
# - 找下一个 chg_NNNN 编号
# - 创建 openspec/changes/chg_NNNN_<slug>/(含 mvp/prototype/)
# - 复制技能包 templates/ 里的全部模板
#
# 需要 branch + worktree + Change-Id 校验时,用 scripts/create_change.py。
#
# 目标项目定位:环境变量 PROJECT_ROOT,默认当前目录。
# (脚本位于技能包内,不假设自己在目标项目里。)
#
# 用法:PROJECT_ROOT=/path/to/project bash create_change.sh <slug>
# 例:bash create_change.sh add_note_crud
# ==============================================================================
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
TEMPLATES_DIR="$SCRIPT_DIR/../templates"
ROOT="${PROJECT_ROOT:-$(pwd)}"
CHANGES_DIR="$ROOT/openspec/changes"
SLUG="${1:-}"
if [ -z "$SLUG" ]; then
echo "Usage: PROJECT_ROOT=<project> $0 <slug> e.g. $0 add_note_crud"
exit 2
fi
if [ ! -d "$TEMPLATES_DIR" ]; then
echo "FAIL: 找不到模板目录 $TEMPLATES_DIR" >&2
exit 1
fi
# 找下一个编号:识别 chg_NNNN[_slug] 与归档项 archive/YYYY-MM-DD-chg_NNNN_slug,
# 必须连 archive/ 一起扫,否则归档后编号会复用旧号。
mkdir -p "$CHANGES_DIR"
LAST=$(find "$CHANGES_DIR" -mindepth 1 -maxdepth 2 -type d 2>/dev/null \
| grep -oE 'chg_[0-9]{4}' | sort -u | tail -1 | sed 's/chg_//' || true)
LAST="${LAST:-0}"
# 10# 前缀:避免 "0009" 被当成非法八进制
NEXT=$((10#$LAST + 1))
printf -v CHG_ID 'chg_%04d' "$NEXT"
TARGET="$CHANGES_DIR/${CHG_ID}_${SLUG}"
if [ -d "$TARGET" ]; then
echo "FAIL: $TARGET 已存在"
exit 1
fi
mkdir -p "$TARGET/mvp/prototype"
touch "$TARGET/mvp/prototype/.gitkeep"
echo "created $TARGET"
# 复制全部模板(含无后缀的 testcases.map.yaml)
COUNT=0
for tpl in "$TEMPLATES_DIR"/*; do
[ -f "$tpl" ] || continue
cp "$tpl" "$TARGET/$(basename "$tpl")"
COUNT=$((COUNT + 1))
done
echo
echo "templates copied: $COUNT files"
ls "$TARGET"
echo
echo "Next:"
echo " 1. edit $TARGET/proposal.md (PM)"
echo " 2. edit $TARGET/spec.md (PD, 场景写成 '### S1 <场景名>')"
echo " 3. edit $TARGET/testcases.md + testcases.map.yaml (QA, case id 形如 C1_xxx)"
echo " 4. edit $TARGET/tasks.md (TM)"
echo " 5. PROJECT_ROOT=$ROOT bash $SCRIPT_DIR/check_spec_coverage.sh"
echo
echo "Change-Id trailer to add in commit: Change-Id: $CHG_ID"
+47
View File
@@ -0,0 +1,47 @@
#!/usr/bin/env bash
# ==============================================================================
# scripts/lib/parse.sh (skill: ai-collab-framework)
# 公共解析器:被 check_spec_coverage.sh 以及未来脚本(extract_spec.sh / 子代理
# 探活 / CI 报告生成器)共用,保证解析规则 0 漂移。
#
# 用法:. "$SKILL/scripts/lib/parse.sh"
# 调用:extract_s_blocks <spec.md 路径>
# 输出:每行一个 S 块,TSV:id \t ADDED|MODIFIED|REMOVED|PLAIN [\t FLAG]
# FLAG: NO-WHEN / NO-THEN / NO-REASON / NO-MIGRATION(空块标志;空时该列无值)
#
# 改这里的解析函数前请跑:
# bash scripts/selftest_check_spec_coverage.sh
# 确认 gate 默认输出(无 --json)字节级不变。
# ==============================================================================
# S 块结构提取(awk):输出 "S<n>\tADDED|MODIFIED|REMOVED|PLAIN[\tFLAG...]" 行。
# PLAIN = 不在 delta 段内(delta 模式下视为散块;全量模式下是正常块)。
# FLAG: NO-WHEN / NO-THEN(空壳)、NO-REASON / NO-MIGRATION(REMOVED 缺项)。
extract_s_blocks() {
awk '
function flush( id, k, out) {
if (sid == "") return
id = sid
sub(/^###[ \t]+/, "", id)
sub(/[ \t:].*$/, "", id)
k = "PLAIN"
if (sec ~ /^ADDED[ \t]+Scenarios/) k = "ADDED"
else if (sec ~ /^MODIFIED[ \t]+Scenarios/) k = "MODIFIED"
else if (sec ~ /^REMOVED[ \t]+Scenarios/) k = "REMOVED"
out = id "\t" k
if (k == "REMOVED") {
if (body !~ /Reason/) out = out "\tNO-REASON"
if (body !~ /Migration/) out = out "\tNO-MIGRATION"
} else {
if (body !~ /\*\*WHEN\*\*/) out = out "\tNO-WHEN"
if (body !~ /\*\*THEN\*\*/) out = out "\tNO-THEN"
}
print out
sid = ""; body = ""
}
/^## / { flush(); sec = $0; sub(/^##[ \t]+/, "", sec); next }
/^###[ \t]+S[0-9]/ { flush(); sid = $0; body = ""; next }
{ if (sid != "") body = body "\n" $0 }
END { flush() }
' "$1" 2>/dev/null || true
}
+301
View File
@@ -0,0 +1,301 @@
#!/usr/bin/env bash
# ==============================================================================
# scripts/selftest_check_spec_coverage.sh (skill: ai-collab-framework)
# check_spec_coverage.sh 的 fixture 回归自测(全内联、零外部依赖)。
# 借鉴上游 OpenSpec 的 parity-test 思路:门禁规则改动后必跑本脚本,
# 防止「改了匹配规则却静默漏判/误判」这类漂移(见 skill-audit 2.1/2.6 教训)。
#
# 用法:bash scripts/selftest_check_spec_coverage.sh
# 退出码:0 = 全部通过
# ==============================================================================
set -uo pipefail
SELF_DIR="$(cd "$(dirname "$0")" && pwd)"
GATE="$SELF_DIR/check_spec_coverage.sh"
SKILL_ROOT="$(cd "$SELF_DIR/.." && pwd)"
T=$(mktemp -d)
PASS=0; FAIL=0
cleanup() { rm -rf "$T"; }
trap cleanup EXIT
ck() { # ck <name> <want_exit> <want_grep> <dir> [env assignments...]
local name="$1" want_exit="$2" want_grep="$3" dir="$4"; shift 4
local out rc
out=$(env "$@" PROJECT_ROOT="$dir" bash "$GATE" 2>&1); rc=$?
local ok=1
[ "$rc" = "$want_exit" ] || ok=0
if [ -n "$want_grep" ]; then printf '%s\n' "$out" | grep -qF "$want_grep" || ok=0; fi
if [ "$ok" = "1" ]; then echo "PASS $name"; PASS=$((PASS+1));
else echo "FAIL $name (rc=$rc want=$want_exit; want grep '$want_grep')"; printf '%s\n' "$out" | sed 's/^/ |/'; FAIL=$((FAIL+1)); fi
}
# ---- 最小工件构造工具(非 git 目录白名单只 WARN 不阻塞,正好复用)----------
mkp() { mkdir -p "$1/openspec/changes/chg_0001_demo"
printf -- '---\nchange_id: chg_0001\nskip_coverage: %s\n---\n# Change: t\n' "${2:-false}" \
> "$1/openspec/changes/chg_0001_demo/proposal.md"; }
mkt() { printf '# Tasks\n\n- id: T1\n output: design.md\n- id: T2\n output: src/demo/\n' \
> "$1/openspec/changes/chg_0001_demo/tasks.md"; }
mkc() { local d="$1"; shift
{ printf '# Testcases\n'
for c in "$@"; do printf '\n### %s\n\n- Scenario: S?\n- Bound Task: T2\n' "$c"; done
} > "$d/testcases.md"; }
mkmap() { local d="$1" spec="$2"
{ printf 'scenarios:\n'
IFS=';' read -ra rows <<< "$spec"
for row in "${rows[@]}"; do
printf ' - id: %s\n cases: [%s]\n' "${row%%:*}" "${row#*:}"
done
printf 'gate:\n blocking_gap_tolerance: 0\n implementation_files:\n - src/demo/\n'
} > "$d/testcases.map.yaml"; }
mkspec() { printf '# Spec: %s\n%s\n' "$2" "$3" > "$1/spec.md"; }
B_WHEN='- **WHEN** a
- **THEN** b
'
# ---- S1: 模板派生 happy path(真实 id + git + 已提交 in-scope 改动)--------
D=$T/s1; mkdir -p "$D/openspec/changes/chg_0001_demo"
cp "$SKILL_ROOT"/templates/proposal.md "$SKILL_ROOT"/templates/spec.md "$SKILL_ROOT"/templates/tasks.md \
"$SKILL_ROOT"/templates/testcases.md "$SKILL_ROOT"/templates/testcases.map.yaml "$D/openspec/changes/chg_0001_demo/"
sed -i '' -e 's/C1_<slug>/C1_a/g; s/C2_<slug>/C2_b/g; s/C3_<slug>/C3_c/g; s|src/<module>/|src/module/|g; s|tests/unit/<module>/|tests/unit/module/|g' "$D/openspec/changes/chg_0001_demo"/*
printf '\n### C3_c\n\n- Scenario: S2\n- Bound Task: T2\n' >> "$D/openspec/changes/chg_0001_demo/testcases.md"
git -C "$D" init -q -b main && git -C "$D" add -A && git -C "$D" commit -qm init && git -C "$D" checkout -qb change/x
mkdir -p "$D/src/module" && echo x > "$D/src/module/a.ts" && git -C "$D" add -A && git -C "$D" commit -qm impl
ck "S1 模板派生happy(新capability全ADDED)" 0 "PASS" "$D"
# ---- S2: 旧式全量 spec(无 delta 段)→ 放行 + 迁移提示 ----------------------
D=$T/s2; mkp "$D"; mkt "$D"; mkc "$D/openspec/changes/chg_0001_demo" C1_a C2_b
mkspec "$D/openspec/changes/chg_0001_demo" "demo-cap" "## Concrete Scenarios
### S1 add
$B_WHEN
### S2 del
$B_WHEN"
mkmap "$D/openspec/changes/chg_0001_demo" "S1:C1_a C2_b;S2:C2_b"
ck "S2 旧式全量spec放行+note" 0 "全量 spec(旧式)" "$D"
# ---- S3: delta 合法(主 spec S1,S2;chg ADDED S3 + MODIFIED S1 + REMOVED S2)
D=$T/s3; mkp "$D"; mkt "$D"; mkc "$D/openspec/changes/chg_0001_demo" C1_a C3_d
mkspec "$D/openspec/changes/chg_0001_demo" "demo-cap" "## ADDED Scenarios
### S3 new thing
$B_WHEN
## MODIFIED Scenarios
### S1 add
- **WHEN** a-modified
- **THEN** b-modified
## REMOVED Scenarios
### S2 del
- **Reason**: superseded by S3
- **Migration**: use S3 path"
mkmap "$D/openspec/changes/chg_0001_demo" "S3:C3_d;S1:C1_a"
mkdir -p "$D/openspec/specs/demo-cap"
mkspec "$D/openspec/specs/demo-cap" "demo-cap" "## Concrete Scenarios
### S1 add
$B_WHEN
### S2 del
$B_WHEN"
ck "S3 delta合法(三种操作+指向齐全)" 0 "PASS" "$D"
# ---- S4: ADDED id 已在主 spec → FAIL ----------------------------------------
D=$T/s4; mkp "$D"; mkt "$D"; mkc "$D/openspec/changes/chg_0001_demo" C1_a
mkspec "$D/openspec/changes/chg_0001_demo" "demo-cap" "## ADDED Scenarios
### S1 add
$B_WHEN"
mkmap "$D/openspec/changes/chg_0001_demo" "S1:C1_a"
mkdir -p "$D/openspec/specs/demo-cap"
mkspec "$D/openspec/specs/demo-cap" "demo-cap" "### S1 add
$B_WHEN"
ck "S4 ADDED已存在主spec提示改MODIFIED" 1 "应改为 MODIFIED" "$D"
# ---- S5: 主 spec 不存在却有 MODIFIED → FAIL ---------------------------------
D=$T/s5; mkp "$D"; mkt "$D"; mkc "$D/openspec/changes/chg_0001_demo" C1_a
mkspec "$D/openspec/changes/chg_0001_demo" "demo-cap" "## MODIFIED Scenarios
### S1 add
$B_WHEN"
mkmap "$D/openspec/changes/chg_0001_demo" "S1:C1_a"
ck "S5 新capability禁MODIFIED(无主spec)" 1 "新 capability 只允许 ADDED" "$D"
# ---- S6: REMOVED 缺 Reason/Migration → FAIL ---------------------------------
D=$T/s6; mkp "$D"; mkt "$D"; mkc "$D/openspec/changes/chg_0001_demo" C1_a
mkspec "$D/openspec/changes/chg_0001_demo" "demo-cap" "## REMOVED Scenarios
### S1 add
"
mkmap "$D/openspec/changes/chg_0001_demo" "S1:C1_a"
mkdir -p "$D/openspec/specs/demo-cap"
mkspec "$D/openspec/specs/demo-cap" "demo-cap" "### S1 add
$B_WHEN"
ck "S6 REMOVED缺Reason+Migration" 1 "REMOVED 块需含" "$D"
# ---- S7: delta 模式下 S 块散落在三段之外 → FAIL ------------------------------
D=$T/s7; mkp "$D"; mkt "$D"; mkc "$D/openspec/changes/chg_0001_demo" C1_a C2_b
mkspec "$D/openspec/changes/chg_0001_demo" "demo-cap" "## ADDED Scenarios
### S1 add
$B_WHEN
## Concrete Scenarios
### S2 stray
$B_WHEN"
mkmap "$D/openspec/changes/chg_0001_demo" "S1:C1_a C2_b;S2:C2_b"
ck "S7 delta模式散落块FAIL" 1 "散落在 delta 段之外" "$D"
# ---- S8: 空壳场景(缺 THEN)→ FAIL -------------------------------------------
D=$T/s8; mkp "$D"; mkt "$D"; mkc "$D/openspec/changes/chg_0001_demo" C1_a
mkspec "$D/openspec/changes/chg_0001_demo" "demo-cap" "## ADDED Scenarios
### S1 add
- **WHEN** only-when"
mkmap "$D/openspec/changes/chg_0001_demo" "S1:C1_a"
ck "S8 空壳场景缺THEN FAIL" 1 "缺 THEN" "$D"
# ---- S9: skip_coverage 豁免(只有 proposal)→ SKIP + 放行 --------------------
D=$T/s9; mkdir -p "$D/openspec/changes/chg_0009_refactor"
printf -- '---\nchange_id: chg_0009\nskip_coverage: true\n---\n# Change: pure refactor\n' \
> "$D/openspec/changes/chg_0009_refactor/proposal.md"
ck "S9 skip豁免可见不静默" 0 "SKIP" "$D"
# ---- S10a: 归档项(日期前缀)被扫描:结构缺陷仍 FAIL -------------------------
D=$T/s10a; A="$D/openspec/changes/archive/2026-09-17-chg_0005_demo"; mkdir -p "$A"
printf -- '---\nchange_id: chg_0005\n---\n# t\n' > "$A/proposal.md"
printf '# Tasks\n\n- id: T1\n output: x\n' > "$A/tasks.md"
printf '# Testcases\n\n### C1_a\n\n- Scenario: S1\n- Bound Task: T1\n' > "$A/testcases.md"
printf 'scenarios:\n - id: S1\n cases: [C1_a]\ngate:\n blocking_gap_tolerance: 0\n implementation_files:\n - src/demo/\n' > "$A/testcases.map.yaml"
printf '# Spec: demo-cap\n\n## ADDED Scenarios\n\n### S1 add\n\n- **WHEN** only\n' > "$A/spec.md"
ck "S10a 日期前缀归档仍被扫(空壳FAIL)" 1 "缺 THEN" "$D"
# ---- S10b: 归档项不做指向核对(合并后 ADDED 已在主 spec 仍放行)-------------
D=$T/s10b; A="$D/openspec/changes/archive/2026-09-16-chg_0003_demo"; mkdir -p "$A"
printf -- '---\nchange_id: chg_0003\n---\n# t\n' > "$A/proposal.md"
printf '# Tasks\n\n- id: T2\n output: src/demo/\n' > "$A/tasks.md"
printf '# Testcases\n\n### C1_a\n\n- Scenario: S1\n- Bound Task: T2\n' > "$A/testcases.md"
printf 'scenarios:\n - id: S1\n cases: [C1_a]\ngate:\n blocking_gap_tolerance: 0\n implementation_files:\n - src/demo/\n' > "$A/testcases.map.yaml"
printf '# Spec: demo-cap\n\n## ADDED Scenarios\n\n### S1 add\n%s' "$B_WHEN" > "$A/spec.md"
mkdir -p "$D/openspec/specs/demo-cap"
printf '# Spec: demo-cap\n\n### S1 add\n%s' "$B_WHEN" > "$D/openspec/specs/demo-cap/spec.md"
ck "S10b 归档项豁免指向核对" 0 "PASS" "$D"
# ---- S11: create_change.sh 编号不复用归档号 ----------------------------------
D=$T/s11; mkdir -p "$D/openspec/changes/archive/2026-09-17-chg_0009_old"
OUT=$(PROJECT_ROOT="$D" bash "$SELF_DIR/create_change.sh" new_thing 2>&1)
if printf '%s\n' "$OUT" | grep -q 'chg_0010_new_thing'; then
echo "PASS S11 编号连archive扫(不复用chg_0009)"; PASS=$((PASS+1))
else
echo "FAIL S11 期望 chg_0010,实际:"; printf '%s\n' "$OUT" | sed 's/^/ |/'; FAIL=$((FAIL+1))
fi
# ---- S12: a1 monorepo 路径白名单真实生效(backend/src/foo/)------------------
# 旧实现 'git diff -- src/' 在 monorepo 下静默失效;新实现以 entries 为 pathspec。
D=$T/s12; mkp "$D"; mkt "$D"; mkc "$D/openspec/changes/chg_0001_demo" C1_a
mkspec "$D/openspec/changes/chg_0001_demo" "demo-cap" "## ADDED Scenarios
### S1 add
$B_WHEN"
# 白名单指 backend/src/foo/,仓库根无 src/;应通过路径 pathspec 真实生效 + 提示 note
printf 'scenarios:\n - id: S1\n cases: [C1_a]\ngate:\n blocking_gap_tolerance: 0\n implementation_files:\n - backend/src/foo/\n' > "$D/openspec/changes/chg_0001_demo/testcases.map.yaml"
git -C "$D" init -q -b main && git -C "$D" add -A && git -C "$D" commit -qm init
mkdir -p "$D/backend/src/foo" && echo x > "$D/backend/src/foo/a.ts"
git -C "$D" add -A && git -C "$D" commit -qm impl
# 期望:通过(pathspec 真生效,无 out-of-scope WARN)。
# note 只在写歪成 src/ 但根无 src/ 目录时触发;本用例白名单已是 backend/src/foo/,无 note。
# 关键反向断言:out-of-scope WARN 不应出现(旧实现下会静默失效,新实现下能精准放行)。
ck_neg() { # ck_neg <name> <want_exit> <not_grep> <dir>
local name="$1" want_exit="$2" not_grep="$3" dir="$4"
local out rc; out=$(PROJECT_ROOT="$dir" bash "$GATE" 2>&1); rc=$?
if [ "$rc" = "$want_exit" ] && ! printf '%s\n' "$out" | grep -qF "$not_grep"; then
echo "PASS $name"; PASS=$((PASS+1))
else
echo "FAIL $name (rc=$rc want=$want_exit; should NOT contain '$not_grep')"; printf '%s\n' "$out" | sed 's/^/ |/'; FAIL=$((FAIL+1))
fi
}
ck_neg "S12 monorepo路径白名单真实生效" 0 "out-of-scope" "$D"
# ---- S13: a4 map.yaml '# spec:' 注释 capability 不一致 → FAIL -----------------
D=$T/s13; mkp "$D"; mkt "$D"; mkc "$D/openspec/changes/chg_0001_demo" C1_a
mkspec "$D/openspec/changes/chg_0001_demo" "demo-cap" "## ADDED Scenarios
### S1 add
$B_WHEN"
# 注释里 capability 写歪(demo-cap 与 spec.md 一致,但这里故意写 typo)—— 应 FAIL
printf '# spec: wrong-cap@chg_0001\nscenarios:\n - id: S1\n cases: [C1_a]\ngate:\n blocking_gap_tolerance: 0\n implementation_files:\n - src/demo/\n' > "$D/openspec/changes/chg_0001_demo/testcases.map.yaml"
ck "S13 map.yaml capability注释不一致FAIL" 1 "capability 不一致" "$D"
# ---- S14: --json 模式 PASS(结构合法 + 无文本漂移)--------------------------
# ck_json <name> <want_exit> <jq_assertion> <not_grep_text> <dir>
# - 跑 gate --json,断言退码 + jq 表达式 + stdout 不含指定文本(防 echo 守卫漏改)
ck_json() {
local name="$1" want_exit="$2" jq_expr="$3" not_text="$4" dir="$5"
local out rc
out=$(PROJECT_ROOT="$dir" bash "$GATE" --json 2>&1); rc=$?
local ok=1
[ "$rc" = "$want_exit" ] || ok=0
if [ -n "$not_text" ]; then
printf '%s\n' "$out" | grep -qF "$not_text" && ok=0
fi
# JSON 合法性 + jq 表达式断言(jq 失败 → ok=0)
if ! printf '%s\n' "$out" | jq -e "$jq_expr" >/dev/null 2>&1; then ok=0; fi
if [ "$ok" = "1" ]; then echo "PASS $name"; PASS=$((PASS+1));
else echo "FAIL $name (rc=$rc want=$want_exit; jq='$jq_expr'; not_grep='$not_text')"; printf '%s\n' "$out" | sed 's/^/ |/'; FAIL=$((FAIL+1)); fi
}
# 复用 S3 的 delta 合法 fixture(ADDED + MODIFIED + REMOVED + 主 spec 对齐)
D=$T/s14; mkp "$D"; mkt "$D"; mkc "$D/openspec/changes/chg_0001_demo" C1_a C3_d
mkspec "$D/openspec/changes/chg_0001_demo" "demo-cap" "## ADDED Scenarios
### S3 new thing
$B_WHEN
## MODIFIED Scenarios
### S1 add
- **WHEN** a-modified
- **THEN** b-modified
## REMOVED Scenarios
### S2 del
- **Reason**: superseded by S3
- **Migration**: use S3 path"
mkmap "$D/openspec/changes/chg_0001_demo" "S3:C3_d;S1:C1_a"
mkdir -p "$D/openspec/specs/demo-cap"
mkspec "$D/openspec/specs/demo-cap" "demo-cap" "## Concrete Scenarios
### S1 add
$B_WHEN
### S2 del
$B_WHEN"
# PASS 路径:jq 断言 (status=PASS, summary.pass>=1, 无 status envelope, 无文本漂移)
# 注意 jq `and` 左结合后右侧表达式以左侧 input 为上下文;用括号分组避免 .summary
# 丢失(jq -e 退码 1 = false → ck_json 报 FAIL)。
ck_json "S14 --json PASS退0+合法+无文本漂移" 0 \
'(.summary.fail == 0) and ((.changes | length) >= 1) and (any(.changes[]; .status == "PASS")) and ((.status // null) == null)' \
"==[ PASS ]==" "$D"
# ---- S15: --json 模式 FAIL(信封含期望 code + 文本抑制)---------------------
# 复用 S5 fixture(主 spec 不存在却有 MODIFIED → DELTA_BUT_NO_MAIN_SPEC)
D=$T/s15; mkp "$D"; mkt "$D"; mkc "$D/openspec/changes/chg_0001_demo" C1_a
mkspec "$D/openspec/changes/chg_0001_demo" "demo-cap" "## MODIFIED Scenarios
### S1 add
$B_WHEN"
mkmap "$D/openspec/changes/chg_0001_demo" "S1:C1_a"
# FAIL 路径:jq 断言 (status envelope 含期望 code, summary.fail>=1, 无 ==[ FAIL ]== 文本)
ck_json "S15 --json FAIL退1+信封含code+文本抑制" 1 \
'(.status | type == "array") and (.status | any(.[]; .code == "DELTA_BUT_NO_MAIN_SPEC")) and (.summary.fail >= 1)' \
"==[ FAIL ]==" "$D"
echo "----"
echo "PASS=$PASS FAIL=$FAIL"
[ "$FAIL" = "0" ]