spec-runner 1.0.6 → 1.0.8

package/install.sh

@@ -1,13 +1,11 @@
 #!/usr/bin/env bash
-# =============================================================================
-# spec-runner インストーラー (curl 方式)
+# spec-runner 用インストーラ（curl 用）
 #
 # 使い方:
-#   curl -sSL https://raw.githubusercontent.com/spec-runner/spec-runner/main/install.sh | bash
+#   curl -sSL https://raw.githubusercontent.com/TEEE88/spec-runner/main/install.sh | bash
 #
 # または wget:
-#   wget -qO- https://raw.githubusercontent.com/spec-runner/spec-runner/main/install.sh | bash
-# =============================================================================
+#   wget -qO- https://raw.githubusercontent.com/TEEE88/spec-runner/main/install.sh | bash
 
 set -e
 
@@ -25,12 +23,11 @@ die()  { echo -e "${RED}ERROR:${NC} $*" >&2; exit 1; }
 
 echo ""
 echo -e "${BOLD}╔════════════════════════════════════════╗${NC}"
-echo -e "${BOLD}║       spec-runner  インストーラー        ║${NC}"
-echo -e "${BOLD}║  AI-driven DDD Phase Gate System       ║${NC}"
+echo -e "${BOLD}║       spec-runner インストーラ        ║${NC}"
+echo -e "${BOLD}║     フェーズ駆動 / 次のステップ方式     ║${NC}"
 echo -e "${BOLD}╚════════════════════════════════════════╝${NC}"
 echo ""
 
-# ── Node.js チェック ──────────────────────────────────────────────────────────
 if command -v node &>/dev/null; then
   NODE_VERSION=$(node --version | sed 's/v//')
   NODE_MAJOR=$(echo "$NODE_VERSION" | cut -d. -f1)
@@ -42,7 +39,6 @@ else
   die "Node.js がインストールされていません。\n  https://nodejs.org からインストールしてください"
 fi
 
-# ── jq チェック ───────────────────────────────────────────────────────────────
 if command -v jq &>/dev/null; then
   ok "jq $(jq --version)"
 else
@@ -56,10 +52,9 @@ else
   else
     die "jq を手動でインストールしてください: https://stedolan.github.io/jq/download/"
   fi
-  ok "jq インストール完了"
+  ok "jq インストール済み"
 fi
 
-# ── git チェック ──────────────────────────────────────────────────────────────
 if command -v git &>/dev/null; then
   ok "git $(git --version | awk '{print $3}')"
 else
@@ -70,7 +65,6 @@ echo ""
 info "npx spec-runner を実行します..."
 echo ""
 
-# ── npm/npx で実行 ────────────────────────────────────────────────────────────
 if command -v npx &>/dev/null; then
   npx spec-runner@latest
 elif command -v npm &>/dev/null; then

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "spec-runner",
-  "version": "1.0.6",
-  "description": "AI-driven DDD phase gate system — design-first enforcement for Claude Code, Cursor, and Copilot",
+  "version": "1.0.8",
+  "description": "フェーズ駆動で設計先行を強制。npx で .spec-runner を展開し、次のステップ .md に従って進める",
   "license": "MIT",
   "bin": {
     "spec-runner": "bin/spec-runner.js"
@@ -22,6 +22,7 @@
     "nextjs",
     "spec-kit"
   ],
+  "scripts": {},
   "files": [
     "bin/",
     "templates/",
@@ -29,11 +30,6 @@
     "README.md",
     "LICENSE"
   ],
-  "dependencies": {
-    "chalk": "^4.1.2",
-    "enquirer": "^2.3.6",
-    "ora": "^5.4.1"
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/TEEE88/spec-runner.git"

package/templates/.spec-runner/hooks/pre-commit

@@ -0,0 +1,47 @@
+#!/bin/bash
+# spec-runner pre-commit: ブランチ名チェック + 命名規則チェック（Section 8-4）
+
+set -e
+REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null)"
+[[ -n "$REPO_ROOT" ]] || exit 0
+
+branch=$(git branch --show-current)
+
+pj="$REPO_ROOT/.spec-runner/project.json"
+[[ -f "$pj" ]] || { echo "pre-commit: project.json がありません: $pj" >&2; exit 1; }
+command -v jq >/dev/null 2>&1 || { echo "pre-commit: jq が必要です（brew install jq）" >&2; exit 1; }
+bp="$(jq -r '.naming.branch_prefix // "feature"' "$pj" 2>/dev/null)"
+uc_id_pat="$(jq -r '.naming.uc_id_pattern // "UC-[0-9]+"' "$pj" 2>/dev/null)"
+other_work="$(jq -r '.naming.other_work_prefixes[]? | . + "/.+"' "$pj" 2>/dev/null | tr '\n' '|' | sed 's/|$//')"
+[[ -z "$other_work" ]] && other_work="work/.+|infra/.+|cicd/.+"
+valid_pattern="^(main|develop|${bp}/(${uc_id_pat}-.+|${other_work})|fix/${uc_id_pat}-.+|release/[0-9]+\\.[0-9]+\\.[0-9]+.*|hotfix/[0-9]+\\.[0-9]+\\.[0-9]+-.+)$"
+
+if ! echo "$branch" | grep -qE "$valid_pattern"; then
+  echo "❌ ブランチ名が規則違反: $branch"
+  echo "   正しい形式:"
+  if [[ -f "$REPO_ROOT/.spec-runner/project.json" ]] && command -v jq >/dev/null 2>&1; then
+    bp=$(jq -r '.naming.branch_prefix // "feature"' "$REPO_ROOT/.spec-runner/project.json" 2>/dev/null || echo "feature")
+  else
+    bp="feature"
+  fi
+  echo "     ${bp}/{UC-ID}-{kebab-description}   （新規UC、UC-IDは project.json の uc_id_pattern）"
+  echo "     ${bp}/cicd/xxx  ${bp}/infra/xxx      （その他作業、project.json の other_work_prefixes）"
+  echo "     fix/{UC-ID}-{kebab-description}        （修正）"
+  echo "     release/{semver}                        （リリース）"
+  echo "     hotfix/{semver}-{kebab-description}     （緊急修正）"
+  exit 1
+fi
+
+# 命名規則チェック（.spec-runner スクリプトがある場合のみ実行）
+if [[ -d "$REPO_ROOT/src" ]]; then
+  while IFS= read -r dir; do
+    [[ -z "$dir" ]] && continue
+    base=$(basename "$dir")
+    if ! echo "$base" | grep -qE '^[a-z][a-z0-9-]*$'; then
+      echo "NAMING: フォルダ名「$dir」はkebab-caseで命名してください" >&2
+      exit 1
+    fi
+  done < <(find "$REPO_ROOT/src/" -type d 2>/dev/null || true)
+fi
+
+exit 0

package/templates/.spec-runner/hooks/pre-push

@@ -0,0 +1,9 @@
+#!/bin/bash
+# spec-runner pre-push: main/develop への直接 push 禁止（Section 8-5）
+
+branch=$(git branch --show-current)
+if [[ "$branch" == "main" || "$branch" == "develop" ]]; then
+  echo "❌ main / develop への直接 push は禁止です。PR を作成してください"
+  exit 1
+fi
+exit 0

package/templates/.spec-runner/project.json.example

@@ -0,0 +1,27 @@
+{
+  "_comment": "AI が編集して作成。other_work_prefixes は UC 以外の作業用ブランチ（例: feature/cicd/xxx）。",
+  "_comment_required_docs": "required_docs は steps.json を単一ソースにするため、\"steps:<common.docsキー>[/suffix]\" を指定できる（例: steps:openapi, steps:domain_root/集約.md）。",
+  "naming": {
+    "branch_prefix": "feature",
+    "uc_id_pattern": "UC-[0-9]+",
+    "uc_spec_basename": "{uc_id}-{slug}.md",
+    "adr_basename": "MMDD-{title}.md",
+    "docs_05_categories": true,
+    "other_work_prefixes": ["work", "infra", "cicd"]
+  },
+  "required_docs": {
+    "charter": ["steps:charter"],
+    "domain": ["steps:domain_root/ユビキタス言語辞書.md", "steps:domain_root/ドメインモデル.md", "steps:domain_root/集約.md"],
+    "architecture": ["steps:architecture_root/パターン選定.md", "steps:architecture_root/インフラ方針.md", "steps:architecture_root/設計判断記録"],
+    "grade_a": ["steps:infra_root/schema.dbml"],
+    "gate3_openapi": ["steps:openapi"]
+  },
+  "test_design": {
+    "dir": "tests",
+    "pattern": "*.spec.*",
+    "require_uc_prefixed_tests": true
+  },
+  "test_command": {
+    "run": "npm test"
+  }
+}

package/templates/.spec-runner/scripts/branch/uc-next-start.sh

@@ -0,0 +1,172 @@
+#!/usr/bin/env bash
+# 次の UC を開始する: main に切り替え、feature/UC-N-xxx ブランチを作成する。
+# 使用例:
+#   ./uc-next-start.sh                    # 次 UC 番号を自動検出。説明はプロンプトまたは "next-uc" で作成
+#   ./uc-next-start.sh task-update        # 次 UC 番号 + 説明 "task-update" でブランチ作成
+#   ./uc-next-start.sh task-update 認証    # 次 UC 番号 + 説明 + カテゴリ
+#   ./uc-next-start.sh UC-2 task-update   # 指定 UC + 説明
+#   ./uc-next-start.sh UC-2 task-update 認証 # 指定 UC + 説明 + カテゴリ
+#   ./uc-next-start.sh --yes task-update  # 確認なしで実行
+# 実行後は次のステップに進む旨を案内する。
+
+set -e
+REPO_ROOT="${REPO_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || echo ".")}"
+cd "$REPO_ROOT"
+BRANCH_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+YES_MODE=false
+ARGS=()
+for a in "$@"; do
+  case "$a" in
+    --yes|-y) YES_MODE=true ;;
+    *)        ARGS+=("$a") ;;
+  esac
+done
+
+PROJECT_JSON="$REPO_ROOT/.spec-runner/project.json"
+[[ -f "$PROJECT_JSON" ]] || { echo "uc-next-start: project.json がありません: $PROJECT_JSON" >&2; exit 1; }
+command -v jq >/dev/null 2>&1 || { echo "uc-next-start: jq が必要です（brew install jq）" >&2; exit 1; }
+UC_ID_RE="$(jq -r '.naming.uc_id_pattern' "$PROJECT_JSON")"
+BRANCH_PREFIX="$(jq -r '.naming.branch_prefix' "$PROJECT_JSON")"
+[[ -n "$UC_ID_RE" && "$UC_ID_RE" != "null" && -n "$BRANCH_PREFIX" && "$BRANCH_PREFIX" != "null" ]] || {
+  echo "uc-next-start: project.json の naming.uc_id_pattern / branch_prefix が未設定です" >&2
+  exit 1
+}
+
+next_uc_id() {
+  # docs/02_ユースケース仕様/<カテゴリ>/UC-*.md から次に使う UC-N を返す
+  local dir="$REPO_ROOT/docs/02_ユースケース仕様"
+  mkdir -p "$dir"
+  local max=0
+  for f in "$dir"/*/UC-*.md; do
+    [[ -e "$f" ]] || continue
+    base=$(basename "$f" .md)
+    if [[ "$base" =~ ^(${UC_ID_RE})- ]]; then
+      uc_id="${BASH_REMATCH[1]}"
+      digits=$(echo "$uc_id" | tr -cd '0-9')
+      [[ -z "$digits" ]] && continue
+      n=$((10#$digits))
+      [[ $n -gt $max ]] && max=$n
+    fi
+  done
+  printf "UC-%d\n" $((max + 1))
+}
+
+NEXT_UC="$(next_uc_id)"
+DESC=""
+CATEGORY=""
+
+# ファイル題名は日本語優先にするため、スクリプト引数の「生の説明」を保持する
+RAW_DESC=""
+if [[ ${#ARGS[@]} -ge 2 ]] && [[ "${ARGS[0]}" =~ ^${UC_ID_RE}$ ]]; then
+  NEXT_UC="${ARGS[0]}"
+  DESC="${ARGS[1]}"
+  RAW_DESC="${ARGS[1]}"
+  CATEGORY="${ARGS[2]:-}"
+elif [[ ${#ARGS[@]} -ge 1 ]]; then
+  DESC="${ARGS[0]}"
+  RAW_DESC="${ARGS[0]}"
+  CATEGORY="${ARGS[1]:-}"
+fi
+
+# 説明が無ければデフォルト（next-uc や UC 番号ベース）
+if [[ -z "$DESC" ]]; then
+  if [[ "$YES_MODE" == true ]]; then
+    DESC="next-uc"
+  else
+    echo "次の UC 用ブランチを作成します。"
+    echo "  UC: $NEXT_UC"
+    echo -n "  説明（英数字・ハイフン推奨。日本語のみの場合は uc-001 等にフォールバック。Enter で \"next-uc\"）: "
+    read -r DESC
+    DESC="${DESC:-next-uc}"
+  fi
+fi
+
+# 説明は英小文字・ハイフン（Git ブランチ名は ASCII のみ）。日本語など非 ASCII はサニタイズで除去される
+# macOS(BSD sed) でも動くように、連続ハイフンは 's/--*/-/g' で圧縮する
+DESC=$(echo "$DESC" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g' | sed 's/^-*//' | sed 's/-*$//')
+# サニタイズ後に空（日本語のみの説明など）の場合は UC 番号ベースのスラグでフォールバック
+[[ -z "$DESC" ]] && DESC="uc-$(echo "$NEXT_UC" | sed 's/^UC-//')"
+BRANCH_NAME="${BRANCH_PREFIX}/${NEXT_UC}-${DESC}"
+
+# UC 仕様書ファイル名は必ず日本語にする（題名が ASCII のみなら「要確認」にする）
+DOC_TITLE="$RAW_DESC"
+if [[ -z "$DOC_TITLE" ]]; then
+  DOC_TITLE="要確認"
+else
+  # 非ASCIIが無い（= 英数字/記号のみ）なら、日本語題名が無い扱いにして要確認へ
+  if echo "$DOC_TITLE" | LC_ALL=C grep -q '^[ -~]*$'; then
+    DOC_TITLE="要確認"
+  fi
+fi
+# ファイル名に危険な文字が入らないように除去（日本語は許可）
+DOC_TITLE=$(echo "$DOC_TITLE" | sed 's/[\\\\\\/\\:\\*\\?\\\"\\<\\>\\|]/ /g' | sed 's/[[:space:]]\\+/ /g' | sed 's/^ *//; s/ *$//')
+[[ -z "$DOC_TITLE" ]] && DOC_TITLE="要確認"
+
+# カテゴリ（省略時はデフォルト）。日本語カテゴリは許可し、危険文字だけ除去。
+CATEGORY="${CATEGORY:-ユースケース}"
+CATEGORY=$(echo "$CATEGORY" | sed 's/[^a-zA-Z0-9_ーぁ-んァ-ン一-龥\-]//g')
+[[ -z "$CATEGORY" ]] && CATEGORY="ユースケース"
+
+if git rev-parse --verify "$BRANCH_NAME" >/dev/null 2>&1; then
+  echo "Error: ブランチ '$BRANCH_NAME' は既に存在します。" >&2
+  exit 1
+fi
+
+CURRENT=$(git branch --show-current 2>/dev/null || echo "")
+MAIN_BRANCH="main"
+if ! git rev-parse --verify "$MAIN_BRANCH" >/dev/null 2>&1; then
+  MAIN_BRANCH="master"
+  if ! git rev-parse --verify "$MAIN_BRANCH" >/dev/null 2>&1; then
+    echo "Error: main も master も存在しません。" >&2
+    exit 1
+  fi
+fi
+
+if [[ "$YES_MODE" != true ]]; then
+  echo "次の UC を開始する準備をします。"
+  echo "  $MAIN_BRANCH にチェックアウトし、ブランチ \"$BRANCH_NAME\" を作成します。"
+  echo -n "  実行してよろしいですか？ [y/N]: "
+  read -r ans
+  case "$ans" in
+    [yY]|[yY][eE][sS]) ;;
+    *) echo "キャンセルしました。"; exit 0 ;;
+  esac
+fi
+
+git checkout "$MAIN_BRANCH"
+git pull --ff-only 2>/dev/null || true
+
+# ブランチ作成 + UC 仕様書作成（統合）
+UC_ID_PATTERN="^${UC_ID_RE}$"
+if ! echo "$NEXT_UC" | grep -qE "$UC_ID_PATTERN"; then
+  echo "Error: UC-ID が命名規則に合いません: $NEXT_UC（期待: $UC_ID_PATTERN）" >&2
+  exit 1
+fi
+valid_uc_pattern="^${BRANCH_PREFIX}/${UC_ID_RE}-[a-z0-9-]+\$"
+if ! echo "$BRANCH_NAME" | grep -qE "$valid_uc_pattern"; then
+  echo "Error: ブランチ名が命名規則に合いません: $BRANCH_NAME（期待: ${BRANCH_PREFIX}/<UC-ID>-kebab-description）" >&2
+  exit 1
+fi
+
+git checkout -b "$BRANCH_NAME"
+echo "Created branch: $BRANCH_NAME"
+
+FEATURE_DIR="docs/02_ユースケース仕様/${CATEGORY}"
+UC_DOC="${FEATURE_DIR}/${NEXT_UC}-${DOC_TITLE}.md"
+mkdir -p "$FEATURE_DIR"
+# UC ごとの判断ログ置き場（任意だが、作成しておくと運用が安定する）
+mkdir -p "${FEATURE_DIR}/判断記録"
+# テンプレ: 修正・改善は .spec-runner/templates/UC-N-ユースケース名.md を編集。プレースホルダ UC-N → UC番号, {ユースケース名} → 題名
+TEMPLATE="$REPO_ROOT/.spec-runner/templates/UC-N-ユースケース名.md"
+if [[ -f "$TEMPLATE" ]]; then
+  sed "s/UC-N/${NEXT_UC}/g; s/{ユースケース名}/${DOC_TITLE}/g" "$TEMPLATE" > "$UC_DOC"
+  echo "Created: $UC_DOC"
+else
+  touch "$UC_DOC"
+  echo "# ${NEXT_UC}: ${DOC_TITLE}" >> "$UC_DOC"
+  echo "Created: $UC_DOC"
+fi
+
+echo ""
+echo "次の UC 用ブランチの準備ができました。次のステップに進んでください。"