build-web

/build-web

按 docs/api-contract.yaml 与 docs/prd.md UX 语义实现前端 UI。M6.4 起改用 main thread + 6-phase 范式，每组件流式可见，每文件 validation，每 step checkpoint commit。

输入：$ARGUMENTS

Phase 1 — 前置校验

test -f docs/api-contract.yaml || { echo "❌ 请先运行 /design"; exit 1; }
test -f docs/prd.md || { echo "❌ 请先运行 /prd"; exit 1; }
[ -f "$DDT_PLUGIN_ROOT/bin/aggregate.mjs" ] || DDT_PLUGIN_ROOT=$(cat "${HOME}/.claude/delivery-metrics/.ddt-plugin-root" 2>/dev/null)
[ -f "$DDT_PLUGIN_ROOT/bin/aggregate.mjs" ] || DDT_PLUGIN_ROOT="${HOME}/.claude/plugins/marketplaces/digital-delivery-team"
[ -f "$DDT_PLUGIN_ROOT/bin/aggregate.mjs" ] || { echo "❌ DDT plugin root 未解析"; exit 1; }
export DDT_PLUGIN_ROOT
if printf '%s' "$ARGUMENTS" | grep -q -- '--dry-run'; then
  node "$DDT_PLUGIN_ROOT/bin/print-dry-run.mjs" --phase build-web --inputs "docs/api-contract.yaml,docs/design-brief.md,.ddt/design/<channel>/raw/" --outputs "web/" --next "/verify"
  exit 0
fi
node "$DDT_PLUGIN_ROOT/bin/emit-phase.mjs" --phase build-web --action start
"$DDT_PLUGIN_ROOT/bin/check-blockers.sh" || exit 2

if command -v npx >/dev/null 2>&1; then
  npx --yes @redocly/cli lint docs/api-contract.yaml || exit 4
fi

# PR-E：frontend.type !== 'spa' 时直接 noop 退出，不创建 web/ 工程
#   server-side（Thymeleaf/JSP/...）→ 模板由 /build-api 在 backend 项目里处理
#   none / api-only / cli                → 无前端工程
FRONT_TYPE=$(node "$DDT_PLUGIN_ROOT/bin/get-frontend-type.mjs" 2>/dev/null)
if [ "$FRONT_TYPE" = "server-side" ] || [ "$FRONT_TYPE" = "none" ]; then
  echo "ℹ️  frontend.type=$FRONT_TYPE，/build-web 跳过：服务端渲染由 /build-api 在 backend 项目内处理（src/main/resources/templates 等）；纯 API/CLI 无前端工程。"
  node "$DDT_PLUGIN_ROOT/bin/emit-phase.mjs" --phase build-web --action end
  exit 0
fi

# v0.8.1 D7：frontend.type=spa 时强校验 docs/design-brief.md 存在，避免跳过
# /design-brief → /design-execute 直接 build-web 让 brief 缺失但 web/ 已实现，
# verify 时再发现已迟。--skip-brief 是显式逃生口（少见 — 例如改回归既有项目）。
if [ "$FRONT_TYPE" = "spa" ] && [ ! -f docs/design-brief.md ]; then
  if printf '%s' "$ARGUMENTS" | grep -q -- '--skip-brief'; then
    echo "⚠️  --skip-brief 已声明，跳过 design-brief 前置校验（不推荐 — UI 一致性可能下降）"
  else
    echo "❌ frontend.type=spa 但缺 docs/design-brief.md"
    echo "   建议路径：/design-brief（编译 SSoT）→ /design-execute --channel claude-design"
    echo "   如确认无需 AI 设计源，加 --skip-brief 显式声明并重跑 /build-web --skip-brief"
    exit 1
  fi
fi