project-auto-wizard 0.1.12 → 0.1.14

package/README.md

@@ -16,7 +16,7 @@ npx project-auto-wizard
 [![node](https://img.shields.io/badge/node-%3E%3D20.12-brightgreen)](package.json)
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## 최신 버전 : v0.1.11 (2026-08-03)
+## 최신 버전 : v0.1.13 (2026-08-04)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 
@@ -46,6 +46,7 @@ npx project-auto-wizard --mode full --force --type spring,react   # CI에서 비
 
 - **멀티타입**: `--type spring,react,python` — 한 레포에 여러 타입 공존
 - **모노레포**: `--paths "flutter=app,react=client"` — 타입별 서브폴더 지정 (마커 파일 자동 감지)
+- `spring`/`flutter`/`react`/`next`/`python` 5개 타입은 아래 "타입별 워크플로우 구성"처럼 전용 CI/CD가 설치됩니다. `node`/`react-native`/`react-native-expo`/`basic`은 타입 전용 CI 없이 릴리스 자동화(버전 관리·체인지로그·AI 요약)를 담당하는 공통 워크플로우만 설치됩니다 — 빌드/배포 CI는 직접 추가해서 확장할 수 있습니다.
 
 ### 질문 문구 커스터마이징
 
@@ -65,13 +66,14 @@ flutter.APP_ARTIFACT_NAME:
 `spring`/`flutter`는 아래처럼 단일 CI 이상으로 깊게 구성되어 있습니다:
 
 - **flutter**: Android(Firebase/Playstore/Selfhosted/TestAPK 배포), iOS(TestFlight/Test-TestFlight), CI, Lab 트리거까지 8종
-- **spring**: 무중단 배포 2종(Nginx/Traefik) + 단일 서버 배포 + PR 프리뷰 + Nexus publish(opt-in)
+- **spring**: 단일 서버 배포(SIMPLE-CICD, **기본 활성**) + 무중단 배포 2종(Nginx/Traefik, opt-in) + PR 프리뷰 + GitHub Packages publish(항상 설치) + Nexus publish(`--nexus` opt-in)
+  - 무중단 배포 워크플로우는 파일은 설치되지만 `push` 트리거가 기본적으로 비활성(`workflow_dispatch`만 활성)입니다. 기본 배포는 SIMPLE-CICD가 담당하며, 무중단 배포로 전환하려면 해당 워크플로우 YAML의 `push.branches` 주석을 해제하고 SIMPLE-CICD의 `push` 트리거는 주석 처리해야 합니다(각 YAML 상단 주석에 안내되어 있습니다).
 - **react/next**: CI와 CI+CD 분리 구성
 - **python**: CI / PR 프리뷰 / SimpleCICD
 
 ### 되돌리기(`--mode revert`)
 
-`npx project-auto-wizard --mode revert`는 payload가 설치한 파일명과 **정확히 일치하는 것만** 제거합니다. 사용자가 직접 만든 워크플로우, `version.yml`, `README.md`, `.gitignore`는 건드리지 않습니다. 설치 시 충돌 처리로 생성된 `.bak`/`.template.yaml` 파생 파일도 함께 정리됩니다.
+`npx project-auto-wizard --mode revert --force`는 payload가 설치한 파일명과 **정확히 일치하는 것만** 제거합니다. 사용자가 직접 만든 워크플로우, `version.yml`, `README.md`, `.gitignore`는 건드리지 않습니다. 설치 시 충돌 처리로 생성된 `.bak`/`.template.yaml` 파생 파일도 함께 정리됩니다.
 
 ### 완전 삭제(`--mode uninstall`)
 
@@ -137,7 +139,7 @@ npx project-auto-wizard [옵션]
       --purge-readme        --mode uninstall --force 시 README.md 버전 섹션도 제거
       --purge-gitignore     --mode uninstall --force 시 .gitignore 자동 추가 항목도 제거
       --purge-version       --mode uninstall --force 시 version.yml도 제거
-      --force              전 질문 생략 (CI용)
+      --force              full/version/workflows/revert 실행에 필수 (전 질문 생략, CI용)
 ```
 
 ## 설치 상태 확인 · 진단 · 미리보기
@@ -205,7 +207,7 @@ flowchart TB
 ## 개발
 
 ```bash
-npm test          # node --test + python unittest (node 219 + py 87)
+npm test          # node --test + python unittest (node 222 + py 87)
 npm run test:node
 npm run test:py
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-auto-wizard",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "One command DevOps: npx wizard that installs GitHub-native AI Release Automation into any project",
   "license": "MIT",
   "type": "module",

package/src/cli/args.js

@@ -1,5 +1,5 @@
 // CLI 인자 파싱 (.sh top-level while-case 등가) — template_integrator.sh 842~920.
-import { VALID_TYPES } from "../context.js";
+import { VALID_TYPES, VALID_MODES } from "../context.js";
 
 // argv(process.argv.slice(2)) → 파싱 결과. 오류 시 throw(호출부에서 exit 1).
 export function parseArgs(argv) {
@@ -88,6 +88,11 @@ export function parseArgs(argv) {
         throw new CliError(`알 수 없는 옵션: ${a}`);
     }
   }
+  if (!VALID_MODES.includes(result.mode)) {
+    throw new CliError(
+      `지원하지 않는 모드: '${result.mode}'\n지원 모드: interactive full version workflows revert uninstall status doctor`
+    );
+  }
   return result;
 }
 

package/src/cli/help.js

@@ -19,7 +19,7 @@ export const HELP_TEXT = `project-auto-wizard — One command DevOps: GitHub-nat
       --nexus / --no-nexus            Nexus 라이브러리 publish 워크플로우 포함/제외
       --secret-backup / --no-secret-backup   Secret 백업 워크플로우 포함/제외
       --semver-auto / --no-semver-auto  커밋 타입 기반 자동 major/minor/patch 승격 (기본: 사용함)
-      --force              모든 확인 생략, 비대화형 기본값 사용
+      --force              full/version/workflows/revert 실행에 필수 (모든 확인 생략, 비대화형 기본값 사용)
       --dry-run            실제 파일 변경 없이 무엇이 바뀔지만 미리 보여줌 (full/version/workflows/revert/uninstall 전체 지원)
       --purge-readme        --mode uninstall --force 시 README.md 버전 섹션도 제거
       --purge-gitignore     --mode uninstall --force 시 .gitignore 자동 추가 항목도 제거
@@ -29,7 +29,7 @@ export const HELP_TEXT = `project-auto-wizard — One command DevOps: GitHub-nat
 
 예시:
   npx project-auto-wizard --mode full --force --type spring,react
-  npx project-auto-wizard --mode workflows --type flutter --paths "flutter=app"
+  npx project-auto-wizard --mode workflows --force --type flutter --paths "flutter=app"
   npx project-auto-wizard --mode status
   npx project-auto-wizard --mode doctor
   npx project-auto-wizard --mode full --force --type node --dry-run

package/src/commands/interactive.js

@@ -240,9 +240,9 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   // 완료 요약 (.sh print_summary L5438)
   io.summary?.({
     mode, types, version, branches,
-    counters: { workflows: result?.workflows?.copied ?? 0 },
+    copiedFiles: result?.workflows?.copiedFiles ?? [],
     gitignoreUpdated: result?.gitignoreUpdated === true,
-  }, cwd);
+  });
   io.outro?.(`통합 완료 — ${mode} 모드로 설치했습니다.`);
   return 0;
 }

package/src/context.js

@@ -4,6 +4,13 @@ export const VALID_TYPES = [
   "react-native", "react-native-expo", "node", "python", "basic",
 ];
 
+// --mode 화이트리스트 (issue #19) — 알 수 없는 값은 부수효과(브랜치 조회 등) 이전에 즉시 거부해야 한다.
+// purge는 --help/대화형 메뉴에 노출하지 않는 숨김 모드(issue #6)이지만 검증 대상에는 포함한다.
+export const VALID_MODES = [
+  "interactive", "full", "version", "workflows",
+  "revert", "uninstall", "status", "doctor", "purge",
+];
+
 export const DEFAULT_VERSION = "0.0.0"; // 패키지 버전 읽기 실패 시 폴백 (배너용 — breaking 비교엔 안 씀)
 
 export function createContext(overrides = {}) {

package/src/core/copy/workflows.js

@@ -69,6 +69,7 @@ export function copyWorkflows(context, payloadRoot, targetRoot = ".", hooks = {}
   const counters = { copied: 0, skipped: 0, templateAdded: 0, optionalCopied: 0, backupAdded: 0 };
   const deployValues = new Map(); // Map<type, Map<key,value>> — deploy 블록용 ask 값
   counters.deployValues = deployValues;
+  counters.copiedFiles = []; // 이번 실행에서 실제로 새로 쓰여진 파일명 (issue #19 — printSummary 정확성용)
   const srcText = makeSrcText(context.branches || null);
   // values/useDefaults는 치환 경로에서만 의미 (isUnchanged는 내부에서 useDefaults:true 강제 — 가상 비교 무손상)
   const envOptsFor = (type) => ({ type, projectPath: paths.get(type) || ".", repoName, resolvers, values: envValues, useDefaults: envUseDefaults });
@@ -89,6 +90,7 @@ export function copyWorkflows(context, payloadRoot, targetRoot = ".", hooks = {}
       }
       writeText(dst, body);
       counters.copied++;
+      counters.copiedFiles.push(filename);
     }
   }
 
@@ -108,6 +110,7 @@ export function copyWorkflows(context, payloadRoot, targetRoot = ".", hooks = {}
       writeText(dst, srcText(join(secretDir, filename)));
       counters.optionalCopied++;
       counters.copied++;
+      counters.copiedFiles.push(filename);
     }
   }
 
@@ -125,6 +128,7 @@ function applyDecision(decision, srcDir, workflowsDir, filename, counters, srcTe
     writeText(dst, srcText(src));
     counters.copied++;
     counters.backupAdded++;
+    counters.copiedFiles.push(filename);
     return;
   }
   if (decision === "template") {
@@ -132,6 +136,7 @@ function applyDecision(decision, srcDir, workflowsDir, filename, counters, srcTe
     const templateName = (filename.endsWith(".yaml") ? filename.slice(0, -".yaml".length) : filename) + ".template.yaml";
     writeText(join(workflowsDir, templateName), srcText(src)); // 기존 .template.yaml 덮어씀(.sh rm -f + cp 등가)
     counters.templateAdded++;
+    counters.copiedFiles.push(templateName);
     return;
   }
   counters.skipped++; // 'skip'/미지정/ESC → 기존 유지 (.sh S)·force 기본)
@@ -185,7 +190,11 @@ function copyWorkflowsForType(type, projectTypesDir, workflowsDir, ctx, counters
     const { newFiles, unchanged, changed } = classify(typeDir, workflowsDir, envOpts, srcText);
     unchangedNames = unchanged.slice();
     for (const f of unchanged) counters.skipped++;
-    for (const f of newFiles) { writeText(join(workflowsDir, f), srcText(join(typeDir, f))); counters.copied++; }
+    for (const f of newFiles) {
+      writeText(join(workflowsDir, f), srcText(join(typeDir, f)));
+      counters.copied++;
+      counters.copiedFiles.push(f);
+    }
     // changed: 결정 Map에 따라 처리 (미지정=skip → 현행 force 동작과 동일)
     for (const f of changed) applyDecision(decisions.get(f), typeDir, workflowsDir, f, counters, srcText);
   }
@@ -198,7 +207,11 @@ function copyWorkflowsForType(type, projectTypesDir, workflowsDir, ctx, counters
     } else {
       const { newFiles, unchanged, changed } = classify(serverDeployDir, workflowsDir, envOpts, srcText);
       for (const f of unchanged) counters.skipped++;
-      for (const f of newFiles) { writeText(join(workflowsDir, f), srcText(join(serverDeployDir, f))); counters.copied++; }
+      for (const f of newFiles) {
+        writeText(join(workflowsDir, f), srcText(join(serverDeployDir, f)));
+        counters.copied++;
+        counters.copiedFiles.push(f);
+      }
       for (const f of changed) applyDecision(decisions.get(f), serverDeployDir, workflowsDir, f, counters, srcText);
     }
   }
@@ -218,6 +231,7 @@ function copyWorkflowsForType(type, projectTypesDir, workflowsDir, ctx, counters
       writeText(dst, body);
       counters.optionalCopied++;
       counters.copied++;
+      counters.copiedFiles.push(filename);
     }
   }
 

package/src/index.js

@@ -93,9 +93,10 @@ export async function run(argv, {
 
   // revert 모드 — payload 유래 파일 제거 (감지·질문 불필요, --force 게이트만)
   if (opts.mode === "revert") {
+    // TTY 여부와 무관하게 --force가 없으면 거부한다 (issue #19 — TTY에서 확인 없이 즉시 실행되던 결함 수정).
     // --dry-run은 파일을 쓰지 않으므로 --force 게이트를 우회한다 (status/doctor와 동일한 안전성).
-    if (!opts.force && !opts.dryRun && !process.stdout.isTTY) {
-      console.error("비대화형 환경에서는 --force 옵션이 필요합니다.");
+    if (!opts.force && !opts.dryRun) {
+      console.error("revert 모드는 --force 없이 실행할 수 없습니다 (확인 절차가 없습니다).");
       return 1;
     }
     if (opts.dryRun) {
@@ -220,10 +221,11 @@ export async function run(argv, {
     printDoctorReport(runDoctor(cwd));
     return 0;
   }
-  // 명시 모드인데 --force 없으면 (비대화형 CLI는 --force 필요)
+  // 명시 모드(full/version/workflows)인데 --force 없으면 TTY 여부와 무관하게 즉시 거부한다
+  // (issue #19 — TTY에서 확인 없이 즉시 설치되던 결함 수정).
   // --dry-run은 파일을 쓰지 않으므로 --force 게이트를 우회한다 (status/doctor와 동일한 안전성).
-  if (!opts.force && !opts.dryRun && !process.stdout.isTTY) {
-    console.error("비대화형 환경에서는 --force 옵션이 필요합니다.");
+  if (!opts.force && !opts.dryRun) {
+    console.error("--force 없이는 이 모드를 실행할 수 없습니다 (확인 절차가 없습니다).");
     return 1;
   }
 
@@ -265,7 +267,7 @@ export async function run(argv, {
   const { now, today } = clock || utcNow();
 
   const context = createContext({
-    mode: opts.mode, force: true, types, version, versionCode, branch,
+    mode: opts.mode, force: opts.force, types, version, versionCode, branch,
     branches,
     paths,
     // 옵션 워크플로우: CLI 플래그 최우선 → version.yml 저장 옵션(.sh read_template_options 등가) → false
@@ -295,21 +297,20 @@ export async function run(argv, {
     return 0;
   }
 
+  // opts.mode는 parseArgs()에서 화이트리스트 검증을 통과했고, interactive/revert/purge/uninstall/status/doctor는
+  // 전부 위에서 조기 반환했으므로 이 시점엔 full/version/workflows 중 하나로 보장된다(issue #19 — default 분기 제거).
   let result = null;
   switch (opts.mode) {
     case "full": result = runFull(context, payload, cwd); break;
     case "version": result = runVersion(context, payload, cwd); break;
     case "workflows": result = runWorkflows(context, payload, cwd); break;
-    default:
-      // 알 수 없는 모드 → .sh와 동일하게 복사 0건, 에러 아님
-      break;
   }
 
   // 완료 요약 (.sh print_summary — CLI 모드에서도 출력)
   printSummary({
     mode: opts.mode, types, version, branches,
-    counters: { workflows: result?.workflows?.copied ?? 0 },
+    copiedFiles: result?.workflows?.copiedFiles ?? [],
     gitignoreUpdated: result?.gitignoreUpdated === true,
-  }, cwd);
+  });
   return 0;
 }

package/src/ui/prompts.js

@@ -89,7 +89,7 @@ export function banner(info) { _printBanner(info); }
 export function detectionLog(info) { _detLog(info); }
 export function analysisCard(info) { _card(info); }
 export function installKind(info) { _installKind(info); }
-export function summary(ctx, targetRoot) { _summary(ctx, targetRoot); }
+export function summary(ctx) { _summary(ctx); }
 
 // env 계획·경로 해석·충돌 메뉴가 쓰는 저수준 엔진 io (env-plan/paths-resolve의 io 계약)
 export const engineIo = {

package/src/ui/summary.js

@@ -1,21 +1,17 @@
 // 완료 요약 출력 (.sh print_summary 등가). 전부 stderr.
-// ctx: { mode, types:[], version, counters:{ workflows }, branches? }
-import { existsSync } from "node:fs";
-import { join } from "node:path";
-import { PATHS, WORKFLOW_PREFIX, WORKFLOW_COMMON_PREFIX } from "../core/paths.js";
-import { listYamlFiles } from "../core/fsutil.js";
+// ctx: { mode, types:[], version, copiedFiles:[], branches?, gitignoreUpdated? }
+import { WORKFLOW_PREFIX, WORKFLOW_COMMON_PREFIX } from "../core/paths.js";
 
 const SEPARATOR = "────────────────────────────────────────";
 
-export function printSummary(ctx, targetRoot = ".") {
-  const { mode, types = [], version = "", counters = {}, branches = null, gitignoreUpdated = false } = ctx || {};
+export function printSummary(ctx) {
+  const { mode, types = [], version = "", copiedFiles = [], branches = null, gitignoreUpdated = false } = ctx || {};
   const err = (s = "") => process.stderr.write(`${s}\n`);
   // 색상은 TTY일 때만 (.sh YELLOW/CYAN/NC 등가)
   const isTty = !!process.stderr.isTTY;
   const YELLOW = isTty ? "\x1b[1;33m" : "";
   const CYAN = isTty ? "\x1b[0;36m" : "";
   const NC = isTty ? "\x1b[0m" : "";
-  const workflowsCopied = counters.workflows ?? 0;
 
   err("");
   err(SEPARATOR);
@@ -66,24 +62,22 @@ export function printSummary(ctx, targetRoot = ".") {
   err("");
   err("추가된 워크플로우:");
 
-  // 실제 복사된 워크플로우 분류
+  // 실제로 이번 실행에서 복사된 파일만 분류한다 (copyWorkflows()가 반환한 copiedFiles —
+  // 디렉터리 재스캔은 재실행 시 skip된 파일까지 "새로 설치됨"으로 보여주는 결함이 있었다, issue #19).
   const commonWorkflows = [];
   const typeWorkflows = [];
-  const workflowsDir = join(targetRoot, PATHS.workflowsDir);
-  if (existsSync(workflowsDir)) {
-    const typePrefixes = types.map((t) => `${WORKFLOW_PREFIX}-${t.toUpperCase()}-`);
-    for (const filename of listYamlFiles(workflowsDir)) {
-      if (!filename.startsWith(`${WORKFLOW_PREFIX}-`)) continue; // PROJECT-*.{yaml,yml}만
-      if (filename.startsWith(`${WORKFLOW_COMMON_PREFIX}-`)) {
-        commonWorkflows.push(filename);
-      } else if (typePrefixes.some((p) => filename.startsWith(p))) {
-        typeWorkflows.push(filename);
-      }
+  const typePrefixes = types.map((t) => `${WORKFLOW_PREFIX}-${t.toUpperCase()}-`);
+  for (const filename of copiedFiles) {
+    if (!filename.startsWith(`${WORKFLOW_PREFIX}-`)) continue; // PROJECT-*만
+    if (filename.startsWith(`${WORKFLOW_COMMON_PREFIX}-`)) {
+      commonWorkflows.push(filename);
+    } else if (typePrefixes.some((p) => filename.startsWith(p))) {
+      typeWorkflows.push(filename);
     }
   }
 
   if (commonWorkflows.length > 0 || typeWorkflows.length > 0) {
-    err(`  📦 새로 설치됨 (${workflowsCopied}개):`);
+    err(`  📦 새로 설치됨 (${commonWorkflows.length + typeWorkflows.length}개):`);
     for (const wf of commonWorkflows) err(`     📌 ${wf}`);
     for (const wf of typeWorkflows) err(`     🎯 ${wf}`);
   }