spec-runner 1.0.7 → 1.0.8

package/templates/.spec-runner/scripts/openapi/openapi-generate.sh

@@ -1,207 +0,0 @@
-#!/usr/bin/env bash
-# OpenAPI から型・クライアントを生成する。
-# ターゲットは「今のドキュメント」(.spec-runner/openapi-generator-targets.json) にだけ載せる。
-# 対話で generator と output を聞き、生成後に「名前を付けて保存」するとドキュメントに追記され、次から名前で呼べる。
-# 使用例:
-#   ./openapi-generate.sh              # 対話: 既存から選択 or 新規（generator/output を聞いて保存）
-#   ./openapi-generate.sh typescript   # ドキュメントに登録した名前で生成
-#   ./openapi-generate.sh --generator python --output src/api_python  # 直接指定（終了時に「保存する？」と聞く）
-#   ./openapi-generate.sh --list
-
-set -e
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="${REPO_ROOT:-$(git -C "$SCRIPT_DIR" rev-parse --show-toplevel 2>/dev/null)}"
-[[ -n "$REPO_ROOT" ]] || REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-cd "$REPO_ROOT"
-
-INPUT_SPEC="${REPO_ROOT}/docs/06_API仕様/openapi.yaml"
-CONFIG="${REPO_ROOT}/.spec-runner/openapi-generator-targets.json"
-
-if [[ ! -f "$INPUT_SPEC" ]]; then
-  echo "openapi-generate: openapi.yaml がありません（docs/06_API仕様/openapi.yaml）。" >&2
-  exit 1
-fi
-
-if ! command -v jq >/dev/null 2>&1; then
-  echo "openapi-generate: 対話でドキュメントを更新するために jq が必要です（brew install jq）。" >&2
-  exit 1
-fi
-
-# 設定ファイルを用意（無ければ空の targets）
-ensure_config() {
-  if [[ ! -f "$CONFIG" ]]; then
-    mkdir -p "$(dirname "$CONFIG")"
-    echo '{"targets":{},"inputSpec":"docs/06_API仕様/openapi.yaml"}' > "$CONFIG"
-  fi
-}
-
-# JSON から generator と output を取得
-get_from_config() {
-  local target="$1"
-  if [[ -f "$CONFIG" ]]; then
-    local g o
-    g=$(jq -r --arg t "$target" '.targets[$t].generator // empty' "$CONFIG" 2>/dev/null)
-    o=$(jq -r --arg t "$target" '.targets[$t].output // empty' "$CONFIG" 2>/dev/null)
-    if [[ -n "$g" ]] && [[ -n "$o" ]]; then
-      echo "${g}|${o}"
-    fi
-  fi
-}
-
-# ドキュメントにターゲットを 1 件追加
-save_target() {
-  local name="$1"
-  local generator="$2"
-  local output="$3"
-  local desc="${4:-}"
-  ensure_config
-  if [[ -z "$name" ]]; then return; fi
-  # 既存 targets にマージ。description は任意。
-  jq --arg n "$name" --arg g "$generator" --arg o "$output" --arg d "$desc" \
-    '.targets[$n] = (if $d != "" then {"generator":$g,"output":$o,"description":$d} else {"generator":$g,"output":$o} end)' \
-    "$CONFIG" > "${CONFIG}.tmp" && mv "${CONFIG}.tmp" "$CONFIG"
-  echo "  → .spec-runner/openapi-generator-targets.json に「$name」を追加しました。"
-}
-
-# 生成実行（共通）
-run_generate() {
-  local generator="$1"
-  local output="$2"
-  echo "OpenAPI から生成: generator=$generator, output=$output"
-  npx --yes @openapitools/openapi-generator-cli@latest generate \
-    -i "$INPUT_SPEC" \
-    -g "$generator" \
-    -o "$REPO_ROOT/$output" \
-    --additional-properties=supportsES6=true
-  echo "生成完了: $output"
-}
-
-list_targets() {
-  ensure_config
-  echo "登録済みターゲット（.spec-runner/openapi-generator-targets.json）:"
-  if ! jq -e '.targets | length > 0' "$CONFIG" >/dev/null 2>&1; then
-    echo "  （なし）対話で追加してください: ./openapi-generate.sh"
-  else
-    jq -r '.targets | to_entries[] | "  \(.key): generator=\(.value.generator), output=\(.value.output)"' "$CONFIG" 2>/dev/null || true
-  fi
-  echo ""
-  echo "直接指定: --generator <name> --output <dir>  例: --generator ruby --output lib/api_ruby"
-  echo "一覧: https://openapi-generator.tech/docs/generators/"
-  exit 0
-}
-
-# 対話: 新規ターゲット（generator / output を聞き、生成してから名前を付けて保存）
-interactive_new() {
-  local g o name desc
-  echo "新規ターゲットを追加します。"
-  read -r -p "Generator 名 (例: typescript-fetch, python, go): " g
-  g=$(echo "$g" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
-  if [[ -z "$g" ]]; then
-    echo "Generator 名が空のため中止しました。" >&2
-    exit 1
-  fi
-  read -r -p "出力ディレクトリ (例: src/api-client-ts): " o
-  o=$(echo "$o" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
-  if [[ -z "$o" ]]; then
-    echo "出力ディレクトリが空のため中止しました。" >&2
-    exit 1
-  fi
-  run_generate "$g" "$o"
-  echo ""
-  read -r -p "この組み合わせをドキュメントに保存しますか？名前 (空白でスキップ): " name
-  name=$(echo "$name" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
-  if [[ -n "$name" ]]; then
-    read -r -p "説明 (任意): " desc
-    save_target "$name" "$g" "$o" "$desc"
-  fi
-}
-
-# 引数解析
-GENERATOR=""
-OUTPUT=""
-TARGET="${OPENAPI_TARGET:-}"
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --list|-l) list_targets ;;
-    -h|--help)
-      echo "使用法: openapi-generate.sh [ターゲット名] | [--generator <name> --output <dir>]"
-      echo "  引数なし     → 対話: 登録済みから選択 or 新規追加（generator/output を聞いてドキュメントに保存）"
-      echo "  ターゲット名 → ドキュメントに登録した名前で生成"
-      echo "  --generator X --output Y → 直接生成。終了時に「ドキュメントに保存する？」と聞く"
-      echo ""
-      list_targets
-      ;;
-    --generator) GENERATOR="$2"; shift 2 ;;
-    --output)    OUTPUT="$2";   shift 2 ;;
-    --*)
-      echo "openapi-generate: 不明なオプション $1" >&2
-      exit 1
-      ;;
-    *) TARGET="$1"; shift ;;
-  esac
-done
-
-# 直接指定で生成 → 終了時に「保存する？」と聞く
-if [[ -n "$GENERATOR" ]] && [[ -n "$OUTPUT" ]]; then
-  run_generate "$GENERATOR" "$OUTPUT"
-  if [[ -t 0 ]]; then
-    echo ""
-    read -r -p "この組み合わせをドキュメントに保存しますか？名前 (空白でスキップ): " name
-    name=$(echo "$name" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
-    if [[ -n "$name" ]]; then
-      read -r -p "説明 (任意): " desc
-      save_target "$name" "$GENERATOR" "$OUTPUT" "$desc"
-    fi
-  fi
-  exit 0
-fi
-
-# ターゲット名指定 → ドキュメントから取得して生成
-if [[ -n "$TARGET" ]]; then
-  pair=$(get_from_config "$TARGET")
-  if [[ -z "$pair" ]]; then
-    echo "openapi-generate: 登録されていないターゲット「$TARGET」" >&2
-    echo "  --list で一覧。または引数なしで対話し、この名前で保存してください。" >&2
-    exit 1
-  fi
-  IFS='|' read -r GENERATOR OUTPUT <<< "$pair"
-  run_generate "$GENERATOR" "$OUTPUT"
-  exit 0
-fi
-
-# 引数なし → 対話
-ensure_config
-keys=($(jq -r '.targets | keys[]' "$CONFIG" 2>/dev/null || true))
-
-if [[ ${#keys[@]} -eq 0 ]]; then
-  # まだ 1 件もない → 新規追加フローへ
-  interactive_new
-  exit 0
-fi
-
-echo "ターゲットを選ぶか、新規追加します:"
-for i in "${!keys[@]}"; do
-  echo "  $((i+1))) ${keys[$i]}"
-done
-echo "  n) 新規追加（generator / output を入力してドキュメントに保存）"
-read -r -p "番号または名前 [1]: " ans
-ans="${ans:-1}"
-
-if [[ "$ans" == "n" ]] || [[ "$ans" == "N" ]] || [[ "$ans" == "新規" ]]; then
-  interactive_new
-  exit 0
-fi
-
-if [[ "$ans" =~ ^[0-9]+$ ]] && [[ "$ans" -ge 1 ]] && [[ "$ans" -le ${#keys[@]} ]]; then
-  TARGET="${keys[$((ans-1))]}"
-else
-  TARGET="$ans"
-fi
-
-pair=$(get_from_config "$TARGET")
-if [[ -z "$pair" ]]; then
-  echo "openapi-generate: 登録されていないターゲット「$TARGET」" >&2
-  exit 1
-fi
-IFS='|' read -r GENERATOR OUTPUT <<< "$pair"
-run_generate "$GENERATOR" "$OUTPUT"

package/templates/.spec-runner/scripts/setup/init-project.sh

@@ -1,152 +0,0 @@
-#!/usr/bin/env bash
-# プロジェクト初期設定を AI と対話しながら行う。設定は .spec-runner/project.json に集約する。
-# 使用例: .spec-runner/scripts/setup/init-project.sh
-
-set -e
-REPO_ROOT="${REPO_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || echo ".")}"
-cd "$REPO_ROOT"
-SPEC_RUNNER="$REPO_ROOT/.spec-runner"
-CONFIG="$SPEC_RUNNER/project.json"
-
-command -v jq >/dev/null 2>&1 || { echo "init-project: jq が必要です（brew install jq）" >&2; exit 1; }
-
-echo "=== spec-runner プロジェクト初期設定 ==="
-echo ""
-
-# --- 1. テストコマンド ---
-detect_test_command() {
-  if [[ -f "package.json" ]] && grep -q '"test"' package.json 2>/dev/null; then
-    echo "npm test"
-    return
-  fi
-  if [[ -f "pyproject.toml" ]]; then
-    command -v poetry >/dev/null 2>&1 && echo "poetry run pytest" || echo "pytest"
-    return
-  fi
-  if [[ -f "go.mod" ]]; then
-    echo "go test ./..."
-    return
-  fi
-  echo ""
-}
-
-CURRENT_TEST=""
-[[ -f "$CONFIG" ]] && CURRENT_TEST=$(jq -r '.test_command.run // empty' "$CONFIG" 2>/dev/null)
-[[ -z "$CURRENT_TEST" ]] && [[ -f "$SPEC_RUNNER/test-command.json" ]] && CURRENT_TEST=$(jq -r '.run // empty' "$SPEC_RUNNER/test-command.json" 2>/dev/null)
-DETECTED=$(detect_test_command)
-
-echo "【1】テストコマンド（require-tests-green.sh が実行するコマンド）"
-if [[ -n "$CURRENT_TEST" ]]; then
-  echo "  現在: $CURRENT_TEST"
-fi
-if [[ -n "$DETECTED" ]]; then
-  echo "  検出候補: $DETECTED"
-fi
-echo "  (1) 検出したコマンドを使う  (2) 自分で入力  (Enter = 変更しない)"
-read -r choice
-case "$choice" in
-  1)
-    if [[ -n "$DETECTED" ]]; then
-      RUN_CMD="$DETECTED"
-    else
-      echo "  検出できませんでした。コマンドを入力してください（例: npm test）:"
-      read -r RUN_CMD
-    fi
-    ;;
-  2)
-    echo "  コマンドを入力（例: docker compose run --rm app npm test）:"
-    read -r RUN_CMD
-    ;;
-  *)
-    RUN_CMD="${CURRENT_TEST:-$DETECTED}"
-    ;;
-esac
-echo ""
-
-# --- 2. 命名規則 ---
-echo "【2】命名規則（ブランチ・UC 仕様書・設計判断記録のファイル名）"
-DEFAULT_BRANCH="feature"
-DEFAULT_UC="UC-NNN-xxx.md"
-DEFAULT_ADR="MMDD-題名.md"
-if [[ -f "$CONFIG" ]]; then
-  DEFAULT_BRANCH=$(jq -r '.naming.branch_prefix // "feature"' "$CONFIG" 2>/dev/null)
-fi
-echo "  ブランチ例: ${DEFAULT_BRANCH}/UC-001-create-task"
-echo "  UC 仕様書例: docs/05_ユースケース仕様/<カテゴリ>/UC-001-create-task.md"
-echo "  設計判断記録例: docs/03_アーキテクチャ/設計判断記録/0314-アーキテクチャ選定.md"
-echo "  変更しますか？ (y/N)"
-read -r change_naming
-if [[ "$change_naming" == "y" || "$change_naming" == "Y" ]]; then
-  echo "  ブランチ接頭辞（Enter = $DEFAULT_BRANCH）:"
-  read -r bp
-  BRANCH_PREFIX="${bp:-$DEFAULT_BRANCH}"
-  echo "  → branch_prefix: $BRANCH_PREFIX（project.json に反映）"
-else
-  BRANCH_PREFIX="$DEFAULT_BRANCH"
-fi
-# UC 以外の作業用ブランチ接頭辞（feature/<接頭辞>/xxx）
-DEFAULT_OTHER_WORK="work, infra, cicd"
-if [[ -f "$CONFIG" ]]; then
-  current_ow=$(jq -r '.naming.other_work_prefixes | join(", ") // empty' "$CONFIG" 2>/dev/null)
-  [[ -n "$current_ow" ]] && DEFAULT_OTHER_WORK="$current_ow"
-fi
-echo "  UC 以外の作業用ブランチ接頭辞（カンマ区切り。例: feature/cicd/xxx, feature/infra/xxx）"
-echo "  現在: [$DEFAULT_OTHER_WORK]"
-echo "  変更する場合は入力、そのままなら Enter:"
-read -r other_work_input
-if [[ -n "$other_work_input" ]]; then
-  OTHER_WORK_JSON=$(echo "$other_work_input" | jq -R 'split(",") | map(gsub("^ +| +$";"")) | map(select(length>0))')
-  echo "  → other_work_prefixes を反映します"
-else
-  OTHER_WORK_JSON=""
-fi
-echo ""
-
-# --- 3. 設計書チェック（必須ドキュメント）---
-echo "【3】設計書チェック（ゲート確認で必須とするドキュメント一覧）"
-CREATE_OR_UPDATE=""
-if [[ -f "$CONFIG" ]]; then
-  echo "  現在の project.json の required_docs を使用します。"
-  # naming.branch_prefix / other_work_prefixes / test_command.run を今回の値で更新
-  jq --arg bp "$BRANCH_PREFIX" '.naming.branch_prefix = $bp' "$CONFIG" > "${CONFIG}.tmp" 2>/dev/null && mv "${CONFIG}.tmp" "$CONFIG"
-  if [[ -n "$OTHER_WORK_JSON" ]]; then
-    jq --argjson ow "$OTHER_WORK_JSON" '.naming.other_work_prefixes = $ow' "$CONFIG" > "${CONFIG}.tmp" 2>/dev/null && mv "${CONFIG}.tmp" "$CONFIG"
-  fi
-  if [[ -n "$RUN_CMD" ]]; then
-    jq --arg run "$RUN_CMD" '.test_command = {run: $run}' "$CONFIG" > "${CONFIG}.tmp" 2>/dev/null && mv "${CONFIG}.tmp" "$CONFIG"
-    echo "  → test_command と naming を反映しました: $RUN_CMD"
-  else
-    echo "  命名（branch_prefix / other_work_prefixes）を反映しました。編集は .spec-runner/project.json を直接変更してください。"
-  fi
-else
-  echo "  project.json がありません。デフォルトの必須ドキュメントで作成しますか？ (Y/n)"
-  read -r create_docs
-  if [[ "$create_docs" != "n" && "$create_docs" != "N" ]]; then
-    CREATE_OR_UPDATE=1
-    mkdir -p "$SPEC_RUNNER"
-    if [[ -f "$SPEC_RUNNER/project.json.example" ]]; then
-      cp "$SPEC_RUNNER/project.json.example" "$CONFIG"
-      jq --arg bp "$BRANCH_PREFIX" '.naming.branch_prefix = $bp' "$CONFIG" > "${CONFIG}.tmp" && mv "${CONFIG}.tmp" "$CONFIG"
-      [[ -n "$OTHER_WORK_JSON" ]] && jq --argjson ow "$OTHER_WORK_JSON" '.naming.other_work_prefixes = $ow' "$CONFIG" > "${CONFIG}.tmp" && mv "${CONFIG}.tmp" "$CONFIG"
-      if [[ -n "$RUN_CMD" ]]; then
-        jq --arg run "$RUN_CMD" '.test_command = {run: $run}' "$CONFIG" > "${CONFIG}.tmp" && mv "${CONFIG}.tmp" "$CONFIG"
-      fi
-      echo "  → project.json をデフォルトで作成しました。"
-    else
-      ow_default='["work","infra","cicd"]'
-      [[ -n "$OTHER_WORK_JSON" ]] && ow_default="$OTHER_WORK_JSON"
-      jq -n \
-        --arg bp "$BRANCH_PREFIX" \
-        --arg run "${RUN_CMD:-npm test}" \
-        --argjson ow "$ow_default" \
-        '{naming: {branch_prefix: $bp, uc_id_pattern: "UC-[0-9]{3}", uc_spec_basename: "{uc_id}-{slug}.md", adr_basename: "MMDD-{title}.md", docs_05_categories: true, other_work_prefixes: $ow}, required_docs: {charter: ["docs/01_憲章/憲章.md"], domain: ["docs/02_ドメイン設計/ユビキタス言語辞書.md", "docs/02_ドメイン設計/ドメインモデル.md", "docs/02_ドメイン設計/集約.md"], architecture: ["docs/03_アーキテクチャ/パターン選定.md", "docs/03_アーキテクチャ/インフラ方針.md", "docs/03_アーキテクチャ/設計判断記録"], grade_a: ["docs/04_インフラ設計/schema.dbml"], gate3_openapi: ["docs/06_API仕様/openapi.yaml"]}, test_design: {dir: "tests", pattern: "*.spec.*"}, test_command: {run: $run}}' \
-        > "$CONFIG"
-      echo "  → project.json を作成しました。"
-    fi
-  fi
-fi
-echo ""
-
-echo "=== 初期設定の流れは以上です ==="
-echo "  再実行: .spec-runner/scripts/setup/init-project.sh"
-echo "  設定の編集: .spec-runner/project.json（1 ファイルに集約）"