project-auto-wizard 0.12.0 → 0.12.1

package/payload/workflows/spring/server-deploy/PROJECT-SPRING-SIMPLE-CICD.yaml

@@ -1,14 +1,10 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # Spring Boot CI/CD 배포 (SSH + Docker)
-# ===================================================================
 #
 # deploy 브랜치 푸시 시 Docker 이미지를 빌드하고
 # SSH로 접속 가능한 서버(Synology·AWS EC2·VPS 등)에 자동 배포합니다.
 #
-# ===================================================================
-# 🔑 필수 GitHub Secrets
-# ===================================================================
+# 필수 GitHub Secrets
 # APPLICATION_PROD_YML (선택): application-prod.yml 내용
 # DOCKERHUB_USERNAME: DockerHub 사용자명
 # DOCKERHUB_TOKEN: DockerHub 액세스 토큰
@@ -16,51 +12,45 @@
 # SERVER_USER: SSH 사용자명
 # SERVER_PASSWORD: SSH 비밀번호 (SSH_AUTH_METHOD=password일 때)
 # SSH_KEY: SSH 개인키 .pem 내용 (SSH_AUTH_METHOD=key일 때, AWS EC2 등)
-# ===================================================================
 #
-# 🔧 환경변수 설정 (env 섹션에서 설정)
-# ===================================================================
+# 환경변수 설정 (env 섹션에서 설정)
 #
-# 🌐 포트 및 컨테이너:
+# 포트 및 컨테이너:
 # CONTAINER_INTERNAL_PORT: Spring Boot 내부 포트 (기본: 8080)
 # DEPLOY_PORT: 배포 포트
 # CONTAINER_NAME: 컨테이너 이름 (기본: PROJECT_NAME)
 #
-# 📦 볼륨 마운트:
+# 볼륨 마운트:
 # ENABLE_VOLUME_MOUNT: 볼륨 마운트 활성화 (true/false)
 # VOLUME_HOST_PATH: 호스트 볼륨 경로
 # VOLUME_CONTAINER_PATH: 컨테이너 내부 마운트 경로
 #
-# 🔌 SSH 연결:
+# SSH 연결:
 # SSH_PORT: SSH 포트 (기본: 2022)
 # SSH_COMMAND_TIMEOUT: SSH 명령 타임아웃 (기본: 600s)
 # SSH_CONNECTION_TIMEOUT: SSH 연결 타임아웃 (기본: 60s)
 #
-# ⏱️ 헬스체크:
+# 헬스체크:
 # HEALTHCHECK_WAIT_SECONDS: 초기화 대기 시간 (기본: 10초)
 # HEALTHCHECK_PATH: HTTP 엔드포인트 경로 (비어있으면 로그만 사용)
 # HEALTHCHECK_MAX_RETRIES: HTTP 재시도 횟수 (기본: 5회)
 # HEALTHCHECK_RETRY_INTERVAL: 재시도 간격 (기본: 3초)
 # HEALTHCHECK_LOG_PATTERN: Fallback 로그 검색 패턴
 #
-# 💡 HEALTHCHECK_PATH 예시:
+# HEALTHCHECK_PATH 예시:
 #   Spring Boot (Actuator): "/actuator/health"
 #   커스텀: "/api/v1/health"
 #
-# 💡 HEALTHCHECK_LOG_PATTERN 예시:
+# HEALTHCHECK_LOG_PATTERN 예시:
 #   Spring Boot: "Tomcat started on port"
-# ===================================================================
 #
-# 🌿 브랜치별 배포:
+# 브랜치별 배포:
 # - deploy 브랜치: 자동 배포 (DEPLOY_PORT 사용)
 # - {{MAIN_BRANCH}} 브랜치: 수동 실행만 가능
-# ===================================================================
 
 name: PROJECT-SPRING-SIMPLE-CICD
 
-# ===================================================================
 # 트리거 설정
-# ===================================================================
 # deploy 브랜치에 push할 때 자동으로 CI/CD가 실행됩니다.
 # {{MAIN_BRANCH}} 브랜치는 workflow_dispatch로 수동 실행만 가능합니다.
 on:
@@ -70,49 +60,46 @@ on:
     # @wizard paths-anchor (모노레포일 때 integrator가 paths 필터를 여기 주입)
   workflow_dispatch:  # 수동 실행 허용
 
-# ===================================================================
-# 환경 변수 설정
-# ===================================================================
 env:
-  # 🔧 프로젝트 설정 - 실제 프로젝트명으로 변경하세요
+  # 프로젝트 설정 - 실제 프로젝트명으로 변경하세요
   PROJECT_NAME: "__PROJECT_NAME__"  # @wizard ask:@repo
 
-  # ☁️ Spring Boot 설정
+  # Spring Boot 설정
   SPRING_PROFILE: "prod"
   JAVA_VERSION: "__JAVA_VERSION__"  # @wizard ask:@jdk
   GRADLE_OPTS: "-Dspring.profiles.active=prod"
 
-  # 📁 경로 설정
+  # 경로 설정
   APPLICATION_YML_DIR: "__APPLICATION_YML_DIR__"  # @wizard auto:spring-app-yml-dir
   DOCKERFILE_PATH: "./Dockerfile"
 
-  # 🌐 포트 설정
+  # 포트 설정
   CONTAINER_INTERNAL_PORT: "8080"  # Spring Boot 내부 포트 (고정값)
   DEPLOY_PORT: "__DEPLOY_PORT__"  # @wizard ask:8080
 
-  # 🐳 컨테이너 이름 설정
+  # 컨테이너 이름 설정
   # 비워두면 PROJECT_NAME을 기본값으로 사용 (예: mapsy-back)
   # 커스텀 이름을 원하면 직접 입력 (예: "my-custom-container")
   CONTAINER_NAME: ""
 
-  # 📦 볼륨 마운트 설정
+  # 볼륨 마운트 설정
   # true: 볼륨 마운트 활성화 (디렉토리 없으면 자동 생성)
   # false: 볼륨 마운트 비활성화 (기본값)
   ENABLE_VOLUME_MOUNT: "false"  # @wizard ask:false
   VOLUME_HOST_PATH: "/volume1/projects/__PROJECT_NAME__"  # @wizard ask:/volume1/projects/__PROJECT_NAME__
   VOLUME_CONTAINER_PATH: "/mnt/__PROJECT_NAME__"  # @wizard ask:/mnt/__PROJECT_NAME__
 
-  # 🔐 SSH 인증 방식: "password"(Synology·일반 서버) | "key"(AWS EC2·.pem)
+  # SSH 인증 방식: "password"(Synology·일반 서버) | "key"(AWS EC2·.pem)
   #   password → SERVER_PASSWORD secret 사용
   #   key      → SSH_KEY secret 사용 (.pem 파일 전체 내용을 secret 값으로)
   SSH_AUTH_METHOD: "password"  # @wizard ask:password
 
-  # 🔌 SSH 연결 설정
+  # SSH 연결 설정
   SSH_PORT: "__SSH_PORT__"  # @wizard ask:2022
   SSH_COMMAND_TIMEOUT: "600s"  # SSH 명령 실행 타임아웃
   SSH_CONNECTION_TIMEOUT: "60s"  # SSH 연결 타임아웃
 
-  # ⏱️ 헬스체크 설정
+  # 헬스체크 설정
   HEALTHCHECK_WAIT_SECONDS: "10"  # 컨테이너 초기화 대기 시간 (초)
   HEALTHCHECK_PATH: "/actuator/health"  # HTTP 엔드포인트 경로 (비어있으면 로그 패턴만 사용)
   HEALTHCHECK_MAX_RETRIES: "5"  # HTTP 재시도 횟수
@@ -120,19 +107,15 @@ env:
   HEALTHCHECK_LOG_PATTERN: "Tomcat started on port"  # Fallback 로그 검색 패턴
 
 jobs:
-  # ===================================================================
   # 빌드 작업
-  # ===================================================================
   build:
     name: Spring Boot 애플리케이션 빌드
     runs-on: ubuntu-latest
 
     steps:
-      # 1. 소스코드 체크아웃
       - name: 코드 체크아웃
         uses: actions/checkout@v7
 
-      # 2. Java 개발 환경 설정
       - name: Java 설정
         uses: actions/setup-java@v5
         with:
@@ -140,43 +123,34 @@ jobs:
           distribution: 'temurin'
           cache: 'gradle'
 
-      # 3. Gradle 실행 권한 부여
       - name: Gradle Wrapper 실행권한 부여
         run: chmod +x gradlew
 
-      # 4. Spring Boot 운영 환경 설정 파일 생성
       # GitHub Secrets에서 APPLICATION_PROD_YML 값을 읽어와서
       # 리소스 디렉토리에 파일로 생성
       - name: application-prod.yml 생성
         run: |
-          # 리소스 디렉토리 생성 (환경변수 사용)
           mkdir -p ${{ env.APPLICATION_YML_DIR }}
 
-          # GitHub Secrets의 APPLICATION_PROD_YML 내용을 파일로 저장
           cat << 'EOF' > ./${{ env.APPLICATION_YML_DIR }}/application-prod.yml
           ${{ secrets.APPLICATION_PROD_YML }}
           EOF
 
           echo "✅ application-prod.yml 파일 생성 완료 (${{ env.APPLICATION_YML_DIR }})"
 
-      # 5. Gradle 빌드 실행
       # 테스트는 제외하고 운영 프로파일로 빌드
       - name: Build with Gradle
         run: ./gradlew clean build -x test ${{ env.GRADLE_OPTS }}
 
-      # 6. Docker 빌드 환경 설정
       - name: Docker 빌드환경 설정
         uses: docker/setup-buildx-action@v3
 
-      # 7. DockerHub 로그인
       - name: DockerHub 로그인
         uses: docker/login-action@v3
         with:
           username: ${{ secrets.DOCKERHUB_USERNAME }}
           password: ${{ secrets.DOCKERHUB_TOKEN }}
 
-      # 8. Docker 레이어 캐싱 설정
-      # 빌드 속도 향상을 위한 캐시 설정
       - name: Cache Docker layers
         uses: actions/cache@v6
         with:
@@ -185,7 +159,6 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-buildx-
 
-      # 9. Docker 이미지 빌드 및 푸시
       # 브랜치명을 태그로 사용하여 환경별로 이미지 관리
       - name: Docker 이미지 빌드 및 푸시
         uses: docker/build-push-action@v5
@@ -197,22 +170,18 @@ jobs:
           cache-from: type=local,src=/tmp/.buildx-cache
           cache-to: type=local,dest=/tmp/.buildx-cache-new,mode=max
 
-      # 10. Docker 캐시 정리
       - name: Move Docker cache
         run: |
           rm -rf /tmp/.buildx-cache
           mv /tmp/.buildx-cache-new /tmp/.buildx-cache
 
-  # ===================================================================
   # 배포 작업
-  # ===================================================================
   deploy:
     name: 원격 서버 배포
     needs: build
     runs-on: ubuntu-latest
 
     steps:
-      # SSH를 통한 원격 서버 배포 실행
       - name: Deploy
         uses: appleboy/ssh-action@v1.0.3
         env:
@@ -227,14 +196,12 @@ jobs:
           script: |
             set -e
 
-            # ============================================================
             # 배포 환경 변수 설정
-            # ============================================================
             echo "🔧 환경변수 설정.."
             export PATH=$PATH:/usr/local/bin
             export PW=${{ secrets.SERVER_PASSWORD }}
 
-            # 🔐 SSH 인증 방식에 따른 sudo 추상화
+            # SSH 인증 방식에 따른 sudo 추상화
             #   password 모드: echo $PW | sudo -S  (Synology 등 sudo 비밀번호 필요 서버)
             #   key 모드: sudo 직접  (AWS EC2 등 passwordless sudo 서버)
             SSH_AUTH_METHOD="${SSH_AUTH_METHOD:-password}"
@@ -245,15 +212,11 @@ jobs:
             fi
             echo "🔐 SSH 인증 방식: ${SSH_AUTH_METHOD}"
 
-            # GitHub에서 전달받은 브랜치명
             BRANCH=${{ github.ref_name }}
 
-            # 프로젝트 설정
             PROJECT_NAME="${{ env.PROJECT_NAME }}"
 
-            # ============================================================
             # 포트 및 컨테이너명 설정
-            # ============================================================
             PORT=${{ env.DEPLOY_PORT }}
 
             # 컨테이너 이름 설정 (환경변수가 비어있으면 PROJECT_NAME을 기본값으로 사용)
@@ -267,7 +230,6 @@ jobs:
 
             echo "🚀 배포 환경으로 배포합니다 (브랜치: $BRANCH)"
 
-            # 설정 정보 출력
             echo "📋 배포 설정 정보:"
             echo "  - 브랜치: $BRANCH"
             echo "  - 프로젝트: $PROJECT_NAME"
@@ -275,18 +237,13 @@ jobs:
             echo "  - 포트: $PORT"
             echo "  - Docker 이미지: ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}:${BRANCH}"
 
-            # ============================================================
             # Docker 이미지 풀 (Pull)
-            # ============================================================
             echo "⬇️ Docker 이미지 풀: ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}:${BRANCH}"
             SUDO docker pull ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}:${BRANCH}
 
-            # ============================================================
             # 기존 컨테이너 정리
-            # ============================================================
             echo "🧹 컨테이너 $CONTAINER_NAME 존재 여부 확인 중..."
 
-            # 동일한 이름의 컨테이너가 존재하는지 확인
             if SUDO docker ps -a --format '{{.Names}}' | grep -Eq "^${CONTAINER_NAME}\$"; then
               echo "⚠️ 컨테이너 $CONTAINER_NAME 이(가) 존재합니다. 중지 및 삭제 중..."
               SUDO docker rm -f $CONTAINER_NAME
@@ -295,15 +252,11 @@ jobs:
               echo "ℹ️ 존재하는 컨테이너 $CONTAINER_NAME 이(가) 없습니다."
             fi
 
-            # ============================================================
             # 새 컨테이너 실행
-            # ============================================================
             echo "🚀 새로운 컨테이너 $CONTAINER_NAME 실행 중..."
 
-            # 볼륨 마운트 옵션 설정
             VOLUME_MOUNT_OPTION=""
             if [ "${{ env.ENABLE_VOLUME_MOUNT }}" == "true" ]; then
-              # 디렉토리가 없으면 생성
               if [ ! -d "${{ env.VOLUME_HOST_PATH }}" ]; then
                 echo "📁 볼륨 마운트 디렉토리 생성: ${{ env.VOLUME_HOST_PATH }}"
                 SUDO mkdir -p "${{ env.VOLUME_HOST_PATH }}"
@@ -314,11 +267,6 @@ jobs:
               echo "ℹ️ 볼륨 마운트 비활성화됨"
             fi
 
-            # Docker 컨테이너 실행
-            # - 포트 매핑: ${PORT}:${{ env.CONTAINER_INTERNAL_PORT }} (외부:내부)
-            # - 시간대: Asia/Seoul
-            # - Spring 프로파일: ${{ env.SPRING_PROFILE }}
-            # - 볼륨 마운트: ENABLE_VOLUME_MOUNT=true일 때만 활성화
             SUDO docker run -d \
               -p ${PORT}:${{ env.CONTAINER_INTERNAL_PORT }} \
               --name $CONTAINER_NAME \
@@ -328,9 +276,7 @@ jobs:
               $VOLUME_MOUNT_OPTION \
               ${{ secrets.DOCKERHUB_USERNAME }}/${PROJECT_NAME}:${BRANCH}
 
-            # ============================================================
             # 컨테이너 헬스체크
-            # ============================================================
             echo "⏳ 컨테이너 초기화 대기 중... (${{ env.HEALTHCHECK_WAIT_SECONDS }}초)"
             sleep ${{ env.HEALTHCHECK_WAIT_SECONDS }}
 
@@ -398,14 +344,11 @@ jobs:
               fi
             fi
 
-            # 최종 성공 메시지
             if [ "$HEALTHCHECK_SUCCESS" = "true" ]; then
               echo "✅ 헬스체크 완료: 컨테이너 $CONTAINER_NAME 이(가) 정상적으로 실행 중입니다"
             fi
 
-            # ============================================================
             # 배포 완료 확인
-            # ============================================================
             echo "✅ 배포가 성공적으로 완료되었습니다!"
             echo ""
             echo "📋 배포 결과 요약:"
@@ -417,10 +360,7 @@ jobs:
             echo ""
             echo "🔗 접속 URL: http://${{ secrets.SERVER_HOST }}:${PORT}"
 
-# ===================================================================
-# 📝 사용 방법
-# ===================================================================
+# 사용 방법
 # 1. GitHub Secrets 설정 (DOCKERHUB_*, SERVER_*)
 # 2. env 섹션에서 PROJECT_NAME, DEPLOY_PORT 설정
 # 3. deploy 브랜치에 push → 자동 CI/CD 실행
-# ===================================================================

package/src/cli/args.js

@@ -12,8 +12,6 @@ export function parseArgs(argv) {
     version: "",             // 통합 대상 프로젝트의 초기 버전 (--project-version)
     types: [],
     primaryType: "",
-    includeNexus: null,      // null=미설정
-    includeSecretBackup: null,
     includeSemverAuto: null,  // --semver-auto / --no-semver-auto (기본 true — 미지정 시 다운스트림에서 해석)
     includeCopilotAi: null,   // --copilot / --no-copilot (기본 false — AI Credits를 소비하는 opt-in)
     pathsCsv: "",            // "flutter=app,react=client" 원문 (정규화는 resolve 단계)
@@ -42,7 +40,7 @@ export function parseArgs(argv) {
     keepScripts: false,
   };
   const args = [...argv];
-  const seenFlags = new Set(); // L7: --nexus류 상호 모순 플래그 검증용
+  const seenFlags = new Set(); // --semver-auto/--copilot류 상호 모순 플래그 검증용
   while (args.length > 0) {
     const a = args.shift();
     switch (a) {
@@ -122,18 +120,6 @@ export function parseArgs(argv) {
         }
         result.iosDeployMode = v; break;
       }
-      case "--nexus":
-        if (seenFlags.has("--no-nexus")) throw new CliError("--nexus와 --no-nexus는 동시에 지정할 수 없습니다");
-        seenFlags.add("--nexus"); result.includeNexus = true; break;
-      case "--no-nexus":
-        if (seenFlags.has("--nexus")) throw new CliError("--nexus와 --no-nexus는 동시에 지정할 수 없습니다");
-        seenFlags.add("--no-nexus"); result.includeNexus = false; break;
-      case "--secret-backup":
-        if (seenFlags.has("--no-secret-backup")) throw new CliError("--secret-backup과 --no-secret-backup은 동시에 지정할 수 없습니다");
-        seenFlags.add("--secret-backup"); result.includeSecretBackup = true; break;
-      case "--no-secret-backup":
-        if (seenFlags.has("--secret-backup")) throw new CliError("--secret-backup과 --no-secret-backup은 동시에 지정할 수 없습니다");
-        seenFlags.add("--no-secret-backup"); result.includeSecretBackup = false; break;
       case "--semver-auto":
         if (seenFlags.has("--no-semver-auto")) throw new CliError("--semver-auto와 --no-semver-auto는 동시에 지정할 수 없습니다");
         seenFlags.add("--semver-auto"); result.includeSemverAuto = true; break;

package/src/cli/help.js

@@ -21,8 +21,6 @@ export const HELP_TEXT = `project-auto-wizard — One command DevOps: GitHub-nat
       --flutter-store CSV            Flutter 스토어 배포 대상: android,ios | android | ios | none (기본: 둘 다 설치)
       --android-deploy-mode MODE     Play Store 배포 모드: store_only | store_prepare | store_submit (기본: store_only)
       --ios-deploy-mode MODE         iOS 배포 모드: store_only | store_prepare | store_submit (기본: store_only)
-      --nexus / --no-nexus            라이브러리 publish 워크플로우 포함/제외 (Nexus + GitHub Packages)
-      --secret-backup / --no-secret-backup   Secret 백업 워크플로우 포함/제외
       --semver-auto / --no-semver-auto  커밋 타입 기반 자동 major/minor/patch 승격 (기본: 사용함)
       --copilot / --no-copilot  Copilot으로 AI 요약 생성 (기본: 사용 안 함, GitHub Copilot AI Credits 소비)
       --force              full 실행에 필수 (모든 확인 생략, 비대화형 기본값 사용)

package/src/commands/doctor.js

@@ -1,7 +1,7 @@
 // doctor 명령 — 로컬 환경 진단(읽기 전용, 규칙 기반). gh CLI에 위임해 원격 상태를 점검한다.
 // AI 진단은 포함하지 않는다(스펙 §4에서 검토 후 기각 — 복잡도 대비 이득 낮음).
 //
-// 출력 설계(이슈 #29) — `flutter doctor` 패턴을 차용한다.
+// 출력 설계 — `flutter doctor` 패턴을 차용한다.
 //   ① 항목 라벨에 purpose("무엇을 위한 설정인지")를 병기한다. `WORKFLOW_PAT`만 보고는 그게
 //      자기 릴리스 흐름의 무엇을 담당하는지 알 수 없다 — flutter의
 //      `Android toolchain - develop for Android devices`와 같은 이유다.
@@ -44,7 +44,7 @@ export function runDoctor(cwd = process.cwd(), { exec = defaultExec } = {}) {
       note: ["이 폴더엔 아직 설치되지 않았습니다 — 지금 설치하면 됩니다."],
     });
 
-  // Flutter 스토어 배포 파일 점검 (이슈 #131) — 로컬 파일만 보므로 gh 조회 결과와 무관하게 수행한다.
+  // Flutter 스토어 배포 파일 점검 — 로컬 파일만 보므로 gh 조회 결과와 무관하게 수행한다.
   if (installed) for (const item of flutterStoreChecks(cwd)) add(item);
 
   const ghVersion = exec("gh", ["--version"]);
@@ -91,7 +91,7 @@ export function runDoctor(cwd = process.cwd(), { exec = defaultExec } = {}) {
 
   const perm = exec("gh", ["api", `repos/${owner}/${repo}/actions/permissions/workflow`, "--jq", ".default_workflow_permissions"]);
   const permValue = (perm.stdout || "").trim();
-  // 이 값은 "워크플로우가 permissions를 생략했을 때 적용되는 기본값"이지 상한이 아니다(#34).
+  // 이 값은 "워크플로우가 permissions를 생략했을 때 적용되는 기본값"이지 상한이 아니다.
   // 마법사가 설치하는 워크플로우는 전부 자체 permissions를 선언하므로(회귀 가드:
   // tests/node/payload-workflow-permissions.test.js) read여도 정상 동작한다 — 이 레포 자체가
   // read인데 VERSION-CONTROL이 버전 커밋 push에 성공하는 것이 그 증거다.
@@ -126,7 +126,7 @@ export function runDoctor(cwd = process.cwd(), { exec = defaultExec } = {}) {
     : {
       // 조치가 필요 없으므로 WARN이 아니라 INFO다 — 위 Workflow permissions 항목과 동일 이유:
       // 폴백(wait-for-merge-and-trigger-release / Trigger NPM-PUBLISH)이 GITHUB_TOKEN만으로
-      // 파이프라인을 끝까지 이어가므로, 없는 장애를 경고로 띄우지 않는다(이슈 #105).
+      // 파이프라인을 끝까지 이어가므로, 없는 장애를 경고로 띄우지 않는다.
       name: "WORKFLOW_PAT secret", label: "WORKFLOW_PAT", purpose: "자동 태그·Release 발행", status: "INFO",
       note: [
         "secret이 없어도 폴백이 자동으로 이어받아 태그·Release까지 진행됩니다 — 실제 병합 후 최대 ~20초 정도 더 걸릴 뿐입니다.",
@@ -176,7 +176,7 @@ const PLATFORM_ROW_NAME = { android: "Flutter Android 배포 파일", ios: "Flut
 const PLACEHOLDER_RE = /__[A-Z][A-Z0-9_]*__/g; // 감지 규칙은 ExportOptions.plist 템플릿·IOS-TESTFLIGHT 검증과 동일
 const EXPORT_OPTIONS_REL = STORE_APP_FILES.ios.find((rel) => rel.endsWith("ExportOptions.plist"));
 
-// Flutter 스토어 배포 진단 — 선택한 플랫폼의 필수 파일과 ExportOptions.plist 플레이스홀더 (이슈 #131).
+// Flutter 스토어 배포 진단 — 선택한 플랫폼의 필수 파일과 ExportOptions.plist 플레이스홀더.
 // 스토어 시크릿 등록 여부는 이번 범위 밖이다. 반환: doctor 결과 행 배열.
 function flutterStoreChecks(cwd) {
   const existing = parseExisting(readFileSync(join(cwd, PATHS.versionFile), "utf8"));

package/src/commands/dry-run.js

@@ -1,5 +1,5 @@
 // --dry-run 미리보기 — 실제 파일을 쓰지 않고 무엇이 바뀔지 계산한다.
-// full/uninstall 두 모드 지원 (issue #70 — 부분 설치·되돌리기 모드 제거).
+// full/uninstall 두 모드 지원 (부분 설치·되돌리기 모드 제거).
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { PATHS } from "../core/paths.js";

package/src/commands/full.js

@@ -1,6 +1,6 @@
 // full 모드 오케스트레이터 (.sh execute_integration full case 등가).
 // 복사 순서: workflows(+env 치환) → flutter 앱 파일 → version.yml → readme → scripts → gitignore(조건부)
-// gitignore는 충돌 백업 부산물(.bak/.template.yaml)이 이번 실행에서 실제로 생겼을 때만 갱신한다 — issue #7.
+// gitignore는 충돌 백업 부산물(.bak/.template.yaml)이 이번 실행에서 실제로 생겼을 때만 갱신한다.
 // (원본의 util/issue/discussion/setup-guide/config 설치는 project-auto-wizard 스코프에서 제외 — DESIGN-SPEC §2)
 import { join } from "node:path";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
@@ -20,18 +20,17 @@ import { cleanupOtherDeployWorkflows, DEFAULT_DEPLOY_STYLE } from "../core/deplo
 import { cleanupDeselectedStoreWorkflows } from "../core/flutter-options.js";
 import { log, maskValue } from "../core/logger.js";
 
-// context: { version, types, paths:Map, branch, versionCode, includeNexus, includeSecretBackup,
+// context: { version, types, paths:Map, branch, versionCode,
 //            force, repoName, resolvers, now, today }
 // payloadRoot: 패키지 payload/ 루트. targetRoot: 통합 대상.
 export function runFull(context, payloadRoot, targetRoot = ".", hooks = {}) {
   const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
     force = true, now, today, templateVersion = "unknown",
-    includeNexus = false, includeSecretBackup = false,
     includeSemverAuto } = context;
 
   // project_paths 마커 계산 (.sh existing_marker_in_dir 등가).
   // 대표 마커명이 아니라 그 폴더에 실제로 있는 파일을 쓴다 — build.gradle.kts만 있는 레포의
-  // version.yml에 "# build.gradle"이라고 적히면 감지 로그와 같은 종류의 거짓말이 된다 (이슈 #77).
+  // version.yml에 "# build.gradle"이라고 적히면 감지 로그와 같은 종류의 거짓말이 된다.
   const pathMarkers = new Map();
   for (const [t, p] of paths) {
     const marker = existingMarkerInDir(t, join(targetRoot, p || "."));
@@ -55,11 +54,11 @@ export function runFull(context, payloadRoot, targetRoot = ".", hooks = {}) {
   for (const f of flutterApp.created) log.info("flutter-app", "create", f);
   for (const f of flutterApp.kept) log.info("flutter-app", "keep", `${f} (기존 파일 유지)`);
 
-  // 기존 version.yml의 알려지지 않은 최상위 필드를 재생성 시 보존한다 (issue #20 M8).
+  // 기존 version.yml의 알려지지 않은 최상위 필드를 재생성 시 보존한다.
   const vyPath = join(targetRoot, PATHS.versionFile);
   const extraTopLevel = existsSync(vyPath) ? parseExisting(readFileSync(vyPath, "utf8")).extraTopLevel : [];
 
-  // 2. version.yml 생성 (payload/version.yml.template 렌더링 — 전체 재생성 전략 D4)
+  // 2. version.yml 생성 (payload/version.yml.template 렌더링 — 전체 재생성)
   writeText(join(targetRoot, PATHS.versionFile),
     renderVersionYml(context, readVersionYmlTemplate(payloadRoot), { pathMarkers, deployValues, extraTopLevel }));
 
@@ -72,10 +71,10 @@ export function runFull(context, payloadRoot, targetRoot = ".", hooks = {}) {
   copyScripts(payloadRoot, targetRoot);
 
   // 5. gitignore — 워크플로우 충돌 처리가 .bak나 .template.yaml을 실제로 만든 경우에만 갱신한다.
-  //    충돌 없는 설치(대부분의 최초 설치)는 .gitignore를 전혀 건드리지 않는다 — issue #7.
+  //    충돌 없는 설치(대부분의 최초 설치)는 .gitignore를 전혀 건드리지 않는다.
   const gitignoreUpdated0 = wfCounters.backupAdded > 0 || wfCounters.templateAdded > 0;
 
-  // 6. 이전 배포 방식 정리 (이슈 #80) — 방식을 바꿔 재설치하면 이전 CD가 남아 배포가 두 번 돈다.
+  // 6. 이전 배포 방식 정리 — 방식을 바꿔 재설치하면 이전 CD가 남아 배포가 두 번 돈다.
   //    옛 baseline이 살아 있는 지금이 "사용자가 손댔는가"를 판정할 수 있는 유일한 시점이다.
   const previousBaseline = readBaseline(targetRoot);
   const cleanup = cleanupOtherDeployWorkflows(
@@ -108,7 +107,7 @@ export function runFull(context, payloadRoot, targetRoot = ".", hooks = {}) {
   const gitignoreUpdated = gitignoreUpdated0 || cleanup.backedUp.length > 0 || storeCleanup.backedUp.length > 0;
   if (gitignoreUpdated) ensureGitignore(targetRoot);
 
-  // 7. baseline 기록 (issue #69) — 다음 업데이트에서 "누가 바꿨는지"를 가를 기준점.
+  // 7. baseline 기록 — 다음 업데이트에서 "누가 바꿨는지"를 가를 기준점.
   //    env 치환까지 전부 끝난 뒤에 해시해야 디스크 내용이 최종형이다. 그래서 copyWorkflows 안이
   //    아니라 여기서 기록한다.
   //    기존 baseline은 병합 대상 — 이번에 건드리지 않은 파일의 기준점을 잃지 않는다.
@@ -122,7 +121,7 @@ export function runFull(context, payloadRoot, targetRoot = ".", hooks = {}) {
     previous: previousBaseline,
   });
 
-  // 8. 설치 후 검증 (이슈 #81, #80) — 디스크에 실제로 쓰인 내용을 다시 읽어 확인한다.
+  // 8. 설치 후 검증 — 디스크에 실제로 쓰인 내용을 다시 읽어 확인한다.
   //    미치환 플레이스홀더가 남았는지, 어떤 Secret이 있어야 워크플로우가 도는지.
   //    설치를 실패시키지는 않는다 — 사실을 알려주는 것이 목적이고, 판단은 사용자 몫이다.
   const wfDir = join(targetRoot, PATHS.workflowsDir);

package/src/commands/interactive-flutter.js

@@ -1,4 +1,4 @@
-// 대화형 마법사의 Flutter 옵션 질문 (이슈 #131) — 환경변수 방식 · 스토어 배포 대상 · 배포 모드.
+// 대화형 마법사의 Flutter 옵션 질문 — 환경변수 방식 · 스토어 배포 대상 · 배포 모드.
 // 상태는 { envMode, stores, androidDeployMode, iosDeployMode } 불변 객체로 주고받는다.
 //   envMode·*DeployMode의 ""와 stores의 null = 미결정 (stores의 빈 배열 = "스토어 배포 안 함"으로 이미 결정됨).
 // 이미 결정된 값은 다시 묻지 않는다 (version.yml 저장값 재질문 생략 규약). ESC(취소)는 항상 기본값: