spectra-cli 4.1.1

package/plugins/spec-driver/scripts/init-project.sh

@@ -0,0 +1,328 @@
+#!/usr/bin/env bash
+# Spec Driver - 项目级初始化脚本
+# 首次在项目中触发 Spec Driver 时由主编排器调用
+# 职责：检查/创建 .specify/ 目录、constitution、spec-driver.config.yaml
+
+set -euo pipefail
+
+# 颜色定义
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+RED='\033[0;31m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+BOLD='\033[1m'
+
+# 输出模式
+OUTPUT_MODE="text"
+
+parse_args() {
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --json)
+        OUTPUT_MODE="json"
+        shift
+        ;;
+      *)
+        shift
+        ;;
+    esac
+  done
+}
+
+# 项目根目录（假定从项目根运行）
+PROJECT_ROOT="$(pwd)"
+SPECIFY_DIR="${PROJECT_ROOT}/.specify"
+SPECIFY_TEMPLATES_DIR="${SPECIFY_DIR}/templates"
+SPECIFY_SCORECARDS_DIR="${SPECIFY_DIR}/scorecards"
+SPECIFY_RUNS_DIR="${SPECIFY_DIR}/runs"
+CONSTITUTION_FILE="${SPECIFY_DIR}/memory/constitution.md"
+PROJECT_CONTEXT_FILE="${SPECIFY_DIR}/project-context.yaml"
+LEGACY_PROJECT_CONTEXT_FILE="${SPECIFY_DIR}/project-context.md"
+CONFIG_FILE="${PROJECT_ROOT}/spec-driver.config.yaml"
+ALT_CONFIG_FILE="${SPECIFY_DIR}/spec-driver.config.yaml"
+
+# 获取 Plugin 目录（相对于脚本位置）
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_DIR="$(dirname "$SCRIPT_DIR")"
+source "${SCRIPT_DIR}/lib/init-project-output.sh"
+SPECIFY_BASE_TEMPLATES_DIR="${PLUGIN_DIR}/templates/specify-base"
+FALLBACK_SPECIFY_TEMPLATES_DIR="${PLUGIN_DIR}/../../.specify/templates"
+DEFAULT_SCORECARD_DIR="${PLUGIN_DIR}/scorecards"
+REQUIRED_SPECIFY_TEMPLATES=(
+  "plan-template.md"
+  "project-context-template.yaml"
+  "spec-template.md"
+  "tasks-template.md"
+  "checklist-template.md"
+  "constitution-template.md"
+  "agent-file-template.md"
+  # 调研模板（纳入同步体系）
+  "product-research-template.md"
+  "tech-research-template.md"
+  "research-synthesis-template.md"
+  "verification-report-template.md"
+)
+
+# 初始化结果
+INIT_RESULTS=()
+NEEDS_CONSTITUTION=false
+NEEDS_CONFIG=false
+HAS_GATE_POLICY=false
+HAS_SPEC_DRIVER_SKILLS=false
+SKILL_MAP=""
+PROJECT_CONTEXT_MODE="missing"
+
+# 步骤 1: 检查/创建 .specify/ 目录
+init_specify_dir() {
+  if [[ -d "$SPECIFY_DIR" ]]; then
+    INIT_RESULTS+=("specify_dir:exists")
+  else
+    INIT_RESULTS+=("specify_dir:created")
+  fi
+
+  # 目录结构确保存在（幂等）
+  mkdir -p "${SPECIFY_DIR}/memory"
+  mkdir -p "${SPECIFY_DIR}/templates"
+  mkdir -p "${SPECIFY_DIR}/workflows"
+  mkdir -p "${SPECIFY_DIR}/scorecards"
+  mkdir -p "${SPECIFY_DIR}/runs"
+  mkdir -p "${SPECIFY_DIR}/scripts/bash"
+}
+
+sync_specify_templates() {
+  local copied_count=0
+  local missing_templates=()
+
+  for template_name in "${REQUIRED_SPECIFY_TEMPLATES[@]}"; do
+    local target_path="${SPECIFY_TEMPLATES_DIR}/${template_name}"
+    if [[ -f "$target_path" ]]; then
+      continue
+    fi
+
+    local source_path=""
+    if [[ -f "${SPECIFY_BASE_TEMPLATES_DIR}/${template_name}" ]]; then
+      source_path="${SPECIFY_BASE_TEMPLATES_DIR}/${template_name}"
+    elif [[ -f "${FALLBACK_SPECIFY_TEMPLATES_DIR}/${template_name}" ]]; then
+      source_path="${FALLBACK_SPECIFY_TEMPLATES_DIR}/${template_name}"
+    fi
+
+    if [[ -n "$source_path" ]]; then
+      cp "$source_path" "$target_path"
+      copied_count=$((copied_count + 1))
+    else
+      missing_templates+=("$template_name")
+    fi
+  done
+
+  if [[ $copied_count -gt 0 ]]; then
+    INIT_RESULTS+=("specify_templates:copied:${copied_count}")
+  fi
+
+  if [[ ${#missing_templates[@]} -eq 0 ]]; then
+    INIT_RESULTS+=("specify_templates:ready")
+  else
+    local missing_csv
+    missing_csv="$(IFS=','; echo "${missing_templates[*]}")"
+    INIT_RESULTS+=("specify_templates:missing:${missing_csv}")
+  fi
+}
+
+sync_scorecard_defaults() {
+  local copied_count=0
+
+  if [[ ! -d "$DEFAULT_SCORECARD_DIR" ]]; then
+    INIT_RESULTS+=("scorecards:missing_defaults")
+    return 0
+  fi
+
+  local source_file
+  for source_file in "$DEFAULT_SCORECARD_DIR"/*.yaml; do
+    if [[ ! -f "$source_file" ]]; then
+      continue
+    fi
+
+    local target_path="${SPECIFY_SCORECARDS_DIR}/$(basename "$source_file")"
+    if [[ -f "$target_path" ]]; then
+      continue
+    fi
+
+    cp "$source_file" "$target_path"
+    copied_count=$((copied_count + 1))
+  done
+
+  if [[ $copied_count -gt 0 ]]; then
+    INIT_RESULTS+=("scorecards:copied:${copied_count}")
+  fi
+  INIT_RESULTS+=("scorecards:ready")
+}
+
+ensure_project_context() {
+  if [[ -f "$PROJECT_CONTEXT_FILE" && -f "$LEGACY_PROJECT_CONTEXT_FILE" ]]; then
+    PROJECT_CONTEXT_MODE="dual"
+    INIT_RESULTS+=("project_context:dual")
+    return 0
+  fi
+
+  if [[ -f "$PROJECT_CONTEXT_FILE" ]]; then
+    PROJECT_CONTEXT_MODE="yaml"
+    INIT_RESULTS+=("project_context:exists")
+    return 0
+  fi
+
+  if [[ -f "$LEGACY_PROJECT_CONTEXT_FILE" ]]; then
+    PROJECT_CONTEXT_MODE="legacy-md"
+    INIT_RESULTS+=("project_context:legacy_md")
+    return 0
+  fi
+
+  local template_path="${SPECIFY_TEMPLATES_DIR}/project-context-template.yaml"
+  if [[ ! -f "$template_path" ]]; then
+    INIT_RESULTS+=("project_context:missing_template")
+    return 0
+  fi
+
+  cp "$template_path" "$PROJECT_CONTEXT_FILE"
+  PROJECT_CONTEXT_MODE="yaml"
+  INIT_RESULTS+=("project_context:created")
+}
+
+# 步骤 2: 检查 constitution.md
+check_constitution() {
+  if [[ -f "$CONSTITUTION_FILE" ]]; then
+    INIT_RESULTS+=("constitution:exists")
+    return 0
+  fi
+
+  NEEDS_CONSTITUTION=true
+  INIT_RESULTS+=("constitution:missing")
+}
+
+# 步骤 3: 检查 spec-driver.config.yaml
+check_config() {
+  if [[ -f "$CONFIG_FILE" ]] || [[ -f "$ALT_CONFIG_FILE" ]]; then
+    INIT_RESULTS+=("config:exists")
+    validate_config_schema
+    return 0
+  fi
+
+  NEEDS_CONFIG=true
+  INIT_RESULTS+=("config:missing")
+}
+
+# 步骤 3a: Schema 校验（config 存在时执行）
+validate_config_schema() {
+  local validate_script="${SCRIPT_DIR}/validate-config.mjs"
+  if [[ ! -f "$validate_script" ]]; then
+    INIT_RESULTS+=("config_schema:skip")
+    return 0
+  fi
+
+  if node "$validate_script" --project-root "$PROJECT_ROOT" --validate >/dev/null 2>&1; then
+    INIT_RESULTS+=("config_schema:pass")
+  else
+    local output
+    output="$(node "$validate_script" --project-root "$PROJECT_ROOT" --validate 2>&1)" || true
+    INIT_RESULTS+=("config_schema:fail")
+    # 仅在 text 模式下输出错误详情，避免污染 --json 输出
+    if [[ "$OUTPUT_MODE" == "text" ]]; then
+      echo -e "  ${RED}配置 Schema 校验失败:${NC}"
+      echo "$output" | while IFS= read -r line; do
+        echo -e "    $line"
+      done
+    fi
+  fi
+}
+
+# 步骤 4: 检查 gate_policy 配置
+check_gate_policy() {
+  local config_path=""
+  if [[ -f "$CONFIG_FILE" ]]; then
+    config_path="$CONFIG_FILE"
+  elif [[ -f "$ALT_CONFIG_FILE" ]]; then
+    config_path="$ALT_CONFIG_FILE"
+  fi
+
+  if [[ -z "$config_path" ]]; then
+    # 配置文件不存在，跳过检查
+    HAS_GATE_POLICY=false
+    INIT_RESULTS+=("gate_policy:no_config")
+    return 0
+  fi
+
+  if grep -q "^gate_policy:" "$config_path" 2>/dev/null; then
+    HAS_GATE_POLICY=true
+    INIT_RESULTS+=("gate_policy:exists")
+  else
+    HAS_GATE_POLICY=false
+    INIT_RESULTS+=("gate_policy:missing")
+  fi
+}
+
+# 步骤 5: 检测已有 spec-driver skills
+detect_spec_driver_skills() {
+  local found_skills=()
+  local commands_dirs=(
+    "${PROJECT_ROOT}/.claude/commands"
+    "${PROJECT_ROOT}/.codex/commands"
+  )
+  local skills_dir
+
+  for skills_dir in "${commands_dirs[@]}"; do
+    if [[ -d "$skills_dir" ]]; then
+      for skill_file in "$skills_dir"/spec-driver.*.md; do
+        if [[ -f "$skill_file" ]]; then
+          local phase
+          phase="$(basename "$skill_file" .md | sed 's/spec-driver\.//')"
+          if [[ ! " ${found_skills[*]} " =~ " ${phase} " ]]; then
+            found_skills+=("$phase")
+          fi
+        fi
+      done
+    fi
+  done
+
+  if [[ ${#found_skills[@]} -gt 0 ]]; then
+    HAS_SPEC_DRIVER_SKILLS=true
+    SKILL_MAP=$(printf '%s,' "${found_skills[@]}" | sed 's/,$//')
+    INIT_RESULTS+=("spec_driver_skills:found:${SKILL_MAP}")
+  else
+    INIT_RESULTS+=("spec_driver_skills:none")
+  fi
+}
+
+run_init_checks() {
+  init_specify_dir
+  sync_specify_templates
+  sync_scorecard_defaults
+  ensure_project_context
+  check_constitution
+  check_config
+  check_gate_policy
+  detect_spec_driver_skills
+  show_effective_config
+}
+
+# effective config 展示（仅当配置文件存在时）
+show_effective_config() {
+  local validate_script="${SCRIPT_DIR}/validate-config.mjs"
+  if [[ ! -f "$validate_script" ]]; then
+    return 0
+  fi
+  if [[ ! -f "$CONFIG_FILE" ]] && [[ ! -f "$ALT_CONFIG_FILE" ]]; then
+    return 0
+  fi
+  # 仅 text 输出模式下展示
+  if [[ "$OUTPUT_MODE" == "text" ]]; then
+    node "$validate_script" --project-root "$PROJECT_ROOT" --show-effective 2>/dev/null || true
+  fi
+}
+
+# 主流程
+main() {
+  parse_args "$@"
+  run_init_checks
+  output_init_results
+}
+
+main "$@"