project-auto-wizard 0.1.34 → 0.3.0

package/src/index.js

@@ -8,8 +8,9 @@ import { createInterface } from "node:readline/promises";
 import { parseArgs, parsePathsCsv, CliError } from "./cli/args.js";
 import { HELP_TEXT } from "./cli/help.js";
 import { createContext } from "./context.js";
+import { DEFAULT_DEPLOY_STYLE, isDeployStyle } from "./core/deploy-style.js";
 import { resolvePayloadRoot, assertPayload, readTemplateVersion } from "./core/assets.js";
-import { detectTypes, detectVersion, detectDefaultBranch, detectRepoName, makeResolvers, detectBuildNumber } from "./core/detect-fs.js";
+import { detectTypes, detectVersion, detectDefaultBranch, detectRepoName, makeResolvers, detectBuildNumber, detectMarkers } from "./core/detect-fs.js";
 import { parseExisting } from "./core/version-yml.js";
 import { runBreakingCheck } from "./core/breaking-check.js";
 import { resolveProjectPaths } from "./core/paths-resolve.js";
@@ -216,7 +217,10 @@ export async function run(argv, {
   // 감지 (CLI 인자 우선, 없으면 자동 감지 — version.yml 우선 규칙은 detectTypes/detectVersion 내부)
   const types = opts.types.length ? opts.types : detectTypes(cwd);
   // version: 기존 version.yml 최우선(SSoT — 재실행 시 덮어쓰기 방지) → CLI 지정 → 파일 감지
-  const version = (existing?.version) || opts.version || detectVersion(cwd);
+  // 비대화형이므로 폴백 안내는 CLI 문구(--project-version)를 그대로 쓴다 (이슈 #80).
+  const detectWarnings = [];
+  const version = (existing?.version) || opts.version
+    || detectVersion(cwd, { warn: (m) => { detectWarnings.push(m); console.error(m); } });
   const versionCode = existing?.versionCode ?? detectBuildNumber(cwd, { types }) ?? 1; // 기존 빌드번호 보존, 신규 통합 시 프로젝트 파일에서 감지 (.sh L2208~2221, 이슈 #41)
   const branch = detectDefaultBranch(cwd);
   const repoName = detectRepoName(cwd);
@@ -267,6 +271,11 @@ export async function run(argv, {
     // 실 resolver 4종 (.sh resolve_token 등가)
     resolvers: makeResolvers(cwd, repoName, paths),
     now, today,
+    // 설치 로그(#79)용 부가 문맥 — 설치 동작 자체는 바꾸지 않는다.
+    markers: detectMarkers(cwd, types), detectWarnings,
+    deployStyle: opts.deployStyle
+      || (isDeployStyle(existing?.options?.deployStyle) ? existing.options.deployStyle : DEFAULT_DEPLOY_STYLE),
+    previousTemplateVersion: existing?.templateVersion || "",
   });
 
   context.templateVersion = readTemplateVersion();
@@ -293,6 +302,10 @@ export async function run(argv, {
     mode: opts.mode, types, version, versionCode, branches,
     copiedFiles: result?.workflows?.copiedFiles ?? [],
     gitignoreUpdated: result?.gitignoreUpdated === true,
+    unresolved: result?.unresolved ?? [],
+    secrets: result?.secrets ?? new Map(),
+    installLogPath: result?.installLog?.path ?? "",
+    cleanup: result?.cleanup ?? null,
   });
   return 0;
 }

package/src/ui/env-plan.js

@@ -10,6 +10,7 @@ import { PAYLOAD } from "../core/paths.js";
 import { exists, listYamlFiles } from "../core/fsutil.js";
 import { parseWizardLine, resolveToken } from "../core/wizard-env.js";
 import { loadWizardPrompts, wfField, workflowDisplayName } from "../core/wizard-labels.js";
+import { deployFilter } from "../core/deploy-style.js";
 import * as engine from "./readline-engine.js";
 
 const CANCEL = engine.CANCEL;
@@ -38,40 +39,47 @@ export function scopeString(usages = []) {
 // 반환: { keys:[], defaults:Map<key,default>, typeDefaults:Map<"type|key",default>,
 //        usages:Map<key,[{type,workflowName}]> }
 export function collectAsks(payloadRoot, types = [], opts = {}) {
-  const { resolvers = {}, includeNexus = false, prompts = null } = opts;
+  const { resolvers = {}, includeNexus = false, includeSecretBackup = false, deployStyle = "", prompts = null } = opts;
+  // 설치하지 않을 배포 워크플로우의 질문까지 묻지 않는다 — 질문 수는 설치 범위를 따라간다.
+  const keepDeploy = deployFilter(deployStyle);
   const baseDir = join(payloadRoot, PAYLOAD.workflowsDir);
   const keys = [];
   const defaults = new Map();
   const typeDefaults = new Map();
   const usages = new Map();
 
+  // 스캔 단위: [타입, 폴더]. secret-backup은 타입이 아니라 공통이지만 @wizard 마커를 가지므로
+  // 포함하기로 한 경우에만 질문 수집 대상이 된다 (이슈 #82) — 종전에는 스캔 대상이 아니어서
+  // my-project 같은 예시값이 질문 없이 그대로 설치됐다.
+  const units = [];
   for (const type of types) {
     const typeDir = join(baseDir, type);
     if (!exists(typeDir)) continue;
     // 복사 엔진과 동일한 폴더 구성: 타입 직하위 + (nexus 아니면) server-deploy + (nexus면) nexus
-    const dirs = [typeDir];
-    if (!includeNexus) dirs.push(join(typeDir, "server-deploy"));
-    else dirs.push(join(typeDir, "nexus"));
-
-    for (const dir of dirs) {
-      if (!exists(dir)) continue;
-      for (const filename of listYamlFiles(dir)) {
-        const content = readFileSync(join(dir, filename), "utf8");
-        if (!content.includes("@wizard")) continue;
-        const workflowName = workflowDisplayName(prompts, filename);
-        for (const line of content.split(/\r?\n/)) {
-          const p = parseWizardLine(line); // KEY 정규식 [A-Z_]+ (.sh와 동일)
-          if (!p || p.action !== "ask") continue;
-          // 타입별 기본값: @접두면 resolver 해석, 아니면 리터럴 (.sh _type_default 등가)
-          const typeDefault = p.arg.startsWith("@")
-            ? resolveToken(p.arg.slice(1), type, resolvers)
-            : p.arg;
-          typeDefaults.set(`${type}|${p.key}`, typeDefault);
-          if (!defaults.has(p.key)) { keys.push(p.key); defaults.set(p.key, typeDefault); }
-          const list = usages.get(p.key) || [];
-          list.push({ type, workflowName });
-          usages.set(p.key, list);
-        }
+    units.push([type, typeDir, null]);
+    units.push([type, join(typeDir, includeNexus ? "nexus" : "server-deploy"), includeNexus ? null : keepDeploy]);
+  }
+  if (includeSecretBackup) units.push(["common", join(baseDir, "common", "secret-backup"), null]);
+
+  for (const [type, dir, fileFilter] of units) {
+    if (!exists(dir)) continue;
+    for (const filename of listYamlFiles(dir)) {
+      if (fileFilter && !fileFilter(filename)) continue;
+      const content = readFileSync(join(dir, filename), "utf8");
+      if (!content.includes("@wizard")) continue;
+      const workflowName = workflowDisplayName(prompts, filename);
+      for (const line of content.split(/\r?\n/)) {
+        const p = parseWizardLine(line); // KEY 정규식 [A-Z_]+ (.sh와 동일)
+        if (!p || p.action !== "ask") continue;
+        // 타입별 기본값: @접두면 resolver 해석, 아니면 리터럴 (.sh _type_default 등가)
+        const typeDefault = p.arg.startsWith("@")
+          ? resolveToken(p.arg.slice(1), type, resolvers)
+          : p.arg;
+        typeDefaults.set(`${type}|${p.key}`, typeDefault);
+        if (!defaults.has(p.key)) { keys.push(p.key); defaults.set(p.key, typeDefault); }
+        const list = usages.get(p.key) || [];
+        list.push({ type, workflowName });
+        usages.set(p.key, list);
       }
     }
   }
@@ -83,6 +91,23 @@ function firstTypeFor(usages, key) {
   return usages.get(key)?.[0]?.type ?? "";
 }
 
+// 최종 답변 목록 (이슈 #79, #80) — 완료 요약과 설치 로그가 같은 데이터를 쓰도록 여기서 만든다.
+// isDefault는 "기본값 그대로인가"다. 나중에 배포가 안 될 때 제일 먼저 확인하게 되는 정보라
+// 값만 남기면 부족하다.
+function buildAnswers(prompts, asks, values, useDefaults) {
+  return asks.keys.map((key) => {
+    const def = asks.defaults.get(key) ?? "";
+    const chosen = useDefaults ? def : (values.get(key) ?? def);
+    return {
+      key,
+      label: wfField(prompts, firstTypeFor(asks.usages, key), key, "label") || key,
+      value: chosen,
+      isDefault: chosen === def,
+      scope: scopeString(asks.usages.get(key) || []),
+    };
+  });
+}
+
 // KEY 1개를 'label·사용처·설명·예시·기본값' 카드로 출력 (.sh _wf_print_field_card 등가).
 // info: { default, usages } — idx/tot 있으면 "(i/t)" 진행 표시. log 주입 가능(테스트 무음화).
 export function printFieldCard(prompts, key, info, idx = null, tot = null, log = defaultLog) {
@@ -124,7 +149,7 @@ async function promptEach(io, prompts, asks, todoKeys, values, log) {
 }
 
 // 배포 env 설정 계획 (.sh wf_prompt_env_plan 등가).
-// 반환: { values: Map<key,value>, useDefaults: boolean }
+// 반환: { values: Map<key,value>, useDefaults: boolean, answers: [{key,label,value,isDefault,scope}] }
 //  - useDefaults=true  → 호출부는 substituteEnv에 그대로 넘기면 타입별 기본값 경로(.sh _wf_prefill_all 등가)
 //  - useDefaults=false → values에 담긴 키만 사용자 확정값으로 치환, 나머지는 기본값
 //    (⚠️ substituteEnv는 useDefaults=false일 때만 values를 참조하므로 이 플래그를 반드시 함께 전달)
@@ -136,19 +161,22 @@ async function promptEach(io, prompts, asks, todoKeys, values, log) {
 //   log        — 카드·안내 출력 함수 주입 (기본 stderr)
 export async function promptEnvPlan({
   payloadRoot, types = [], io = null, force = false, resolvers = {},
-  includeNexus = false, targetRoot = ".", repoName = "", log = defaultLog,
+  includeNexus = false, includeSecretBackup = false, deployStyle = "", targetRoot = ".", repoName = "", log = defaultLog,
 } = {}) {
   const prompts = loadWizardPrompts(targetRoot, payloadRoot);
-  const asks = collectAsks(payloadRoot, types, { resolvers, includeNexus, prompts });
+  const asks = collectAsks(payloadRoot, types, { resolvers, includeNexus, includeSecretBackup, deployStyle, prompts });
   const defaults = asks.defaults;
 
   // 수집 키 0개 → 질문 자체가 없음 (.sh `[ ${#WF_ASK_KEYS[@]} -eq 0 ]` 등가)
-  if (asks.keys.length === 0) return { values: new Map(), useDefaults: true };
+  if (asks.keys.length === 0) return { values: new Map(), useDefaults: true, answers: [] };
 
   // 비대화형: force 또는 (io 미주입 && 비TTY) → 전부 기본값 (.sh FORCE_MODE/TTY_AVAILABLE 분기 등가)
   // io가 주입돼 있으면(테스트/상위 마법사) TTY 여부와 무관하게 대화형으로 진행한다.
   const interactive = !force && (io != null || stdin.isTTY);
-  if (!interactive) return { values: new Map(defaults), useDefaults: true };
+  if (!interactive) {
+    const values = new Map(defaults);
+    return { values, useDefaults: true, answers: buildAnswers(prompts, asks, values, true) };
+  }
 
   const ui = io ?? engine;
 
@@ -175,7 +203,8 @@ export async function promptEnvPlan({
   });
   // ESC/취소 → 전부 기본값 (.sh `if [ "$_rc" -ne 0 ]` 등가)
   if (choice === CANCEL || choice == null || choice === "all") {
-    return { values: new Map(defaults), useDefaults: true };
+    const values = new Map(defaults);
+    return { values, useDefaults: true, answers: buildAnswers(prompts, asks, values, true) };
   }
 
   // 사용자가 확정한 키만 values에 담는다 — substituteEnv(useDefaults:false)가
@@ -183,7 +212,7 @@ export async function promptEnvPlan({
   const values = new Map();
   if (choice === "each") {
     await promptEach(ui, prompts, asks, asks.keys, values, log);
-    return { values, useDefaults: false };
+    return { values, useDefaults: false, answers: buildAnswers(prompts, asks, values, false) };
   }
 
   // some: 바꿀 항목만 멀티선택 → 고른 것만 입력 (.sh 3266~3277)
@@ -198,10 +227,11 @@ export async function promptEnvPlan({
   });
   // ESC/빈 선택 → 전부 기본값 (.sh: _wf_prefill_all만 수행)
   if (selected === CANCEL || !Array.isArray(selected) || selected.length === 0) {
-    return { values: new Map(defaults), useDefaults: true };
+    const values = new Map(defaults);
+    return { values, useDefaults: true, answers: buildAnswers(prompts, asks, values, true) };
   }
   // 수집 키 순서 유지 + WF_ASK_KEYS 멤버만 인정 (.sh _wf_prefill_interactive 필터 등가)
   const todo = asks.keys.filter((k) => selected.includes(k));
   await promptEach(ui, prompts, asks, todo, values, log);
-  return { values, useDefaults: false };
+  return { values, useDefaults: false, answers: buildAnswers(prompts, asks, values, false) };
 }

package/src/ui/prompts.js

@@ -2,6 +2,7 @@
 // node:readline 기반 자체 엔진 사용 (@clack/prompts 는 Windows TTY에서 Enter가 멈추는 버그로 제거).
 // 취소(ESC/Ctrl+C)는 각 함수가 CANCEL 심볼을 반환 → 호출부가 정상 종료(exit 0) 처리.
 import * as engine from "./readline-engine.js";
+import { DEPLOY_STYLES } from "../core/deploy-style.js";
 
 export const CANCEL = engine.CANCEL;
 
@@ -47,17 +48,55 @@ export async function editMenu({ showOptional = false } = {}) {
   return engine.select({ message: "어떤 항목을 수정할까요?", options });
 }
 
+const ALL_TYPES = ["spring", "flutter", "next", "react", "react-native", "react-native-expo", "node", "python", "basic"];
+
 // 타입 멀티선택.
 export async function selectTypes(current = []) {
-  const all = ["spring", "flutter", "next", "react", "react-native", "react-native-expo", "node", "python", "basic"];
   return engine.multiselect({
     message: "프로젝트 타입을 선택하세요 (Space 토글, Enter 확정)",
-    options: all.map((t) => ({ value: t, label: t })),
+    options: ALL_TYPES.map((t) => ({ value: t, label: t })),
     initialValues: current.length ? current : ["basic"],
     required: true,
   });
 }
 
+// 감지 직후 타입 확정 (이슈 #78). selectTypes와 달리 감지 근거 파일을 라벨에 붙여
+// "왜 이렇게 판단했는지"를 보여준다 — 근거가 보여야 맞는지 틀린지 판단할 수 있다.
+// 감지 결과가 맞으면 Enter 한 번으로 끝난다.
+export async function confirmTypes({ types = [], markers = null } = {}) {
+  const detected = new Set(types);
+  engine.note(
+    "선택한 타입에 따라 설치되는 CI/CD 워크플로우와 버전 동기화 대상 파일이 달라집니다.\n" +
+    "감지 결과가 맞으면 그대로 Enter를 누르세요.",
+    "프로젝트 타입 확정",
+  );
+  return engine.multiselect({
+    message: "이 프로젝트의 타입입니다 (Space 토글, Enter 확정)",
+    options: ALL_TYPES.map((t) => {
+      const marker = markers?.get?.(t);
+      // 감지된 타입만 근거를 붙인다 — 나머지는 후보로만 나열한다.
+      return { value: t, label: detected.has(t) && marker ? `${t} — ${marker} 발견` : t };
+    }),
+    initialValues: types.length ? types : ["basic"],
+    required: true,
+  });
+}
+
+// 배포 방식 선택 (이슈 #80). 서버 배포 CD 워크플로우는 서로 대체재라 하나만 쓴다.
+// 고른 것만 설치하고 push 트리거까지 켜준다 — 종전에는 넷을 다 깔고 SIMPLE만 켜져 있어,
+// 무중단을 원한 사람은 설치 후 YAML을 직접 고쳐야 했다.
+export async function selectDeployStyle() {
+  engine.note(
+    "서버 배포 워크플로우는 서로 대체재입니다 (Nginx와 Traefik을 동시에 쓰지 않습니다).\n" +
+    "고른 방식만 설치하고 자동 실행(push 트리거)까지 켭니다. PR 프리뷰는 선택과 무관하게 함께 설치됩니다.",
+    "배포 방식",
+  );
+  return engine.select({
+    message: "서버 배포는 어떤 방식으로 할까요?",
+    options: DEPLOY_STYLES.map((s) => ({ value: s.value, label: s.label })),
+  });
+}
+
 // 텍스트 입력 (빈 입력=기본값 유지).
 export async function askText(message, defaultValue = "") {
   const v = await engine.text({ message, defaultValue });

package/src/ui/status-cards.js

@@ -2,24 +2,28 @@
 // (층5의 Breaking Changes 박스는 core/breaking-check.js가 담당.
 //  원본의 층4 IDE Skills 상태는 project-auto-wizard 스코프 제외 — Agent Skills 미포함)
 import { A, paint } from "./ansi.js";
-import { markerForType } from "../core/detect.js";
 
 const GUT = paint("│", A.gray);
 const HEAD = paint("◆", A.cyan);
 const OK = paint("✓", A.green);
 
 // 층2 — 감지 로그 (.ps1 감지 진행 표시 등가)
-export function printDetectionLog({ types = [], version = "", branch = "" }, out = (s) => process.stderr.write(s)) {
+// markers: Map<type, 실제 발견 파일> (이슈 #77).
+// warnings: 감지 도중 나온 경고. 감지 함수를 먼저 호출한 뒤 박스를 그리는 구조라 경고가
+//           박스 위로 새어나가 앞선 질문에 대한 경고처럼 보였다 — 박스 안에서 출력한다 (이슈 #80).
+export function printDetectionLog({ types = [], version = "", branch = "", markers = new Map(), warnings = [] },
+  out = (s) => process.stderr.write(s)) {
   out(`${paint("┌", A.gray)}  🔍 프로젝트를 살펴보는 중...\n`);
   if (types.length && !(types.length === 1 && types[0] === "basic")) {
     for (const t of types) {
-      const marker = markerForType(t);
+      const marker = markers.get(t);
       out(`${GUT}  ${OK} ${marker ? `${marker} 발견 → ` : ""}${paint(t, A.bold)} 감지\n`);
     }
   } else {
     out(`${GUT}  ${paint("─", A.dim)} 마커 파일 없음 → ${paint("basic", A.bold)} (직접 선택 가능)\n`);
   }
   out(`${GUT}  ${OK} 버전: ${paint(`v${version}`, A.green)} · 브랜치: ${paint(branch, A.green)}\n`);
+  for (const w of warnings) out(`${GUT}  ${paint(w, A.yellow)}\n`);
   out(`${GUT}\n`);
 }
 

package/src/ui/summary.js

@@ -6,7 +6,9 @@ import { paint, A, colorEnabled } from "./ansi.js";
 const SEPARATOR = "────────────────────────────────────────";
 
 export function printSummary(ctx) {
-  const { mode, types = [], version = "", versionCode = null, copiedFiles = [], branches = null, gitignoreUpdated = false } = ctx || {};
+  const { mode, types = [], version = "", versionCode = null, copiedFiles = [], branches = null, gitignoreUpdated = false,
+    // 설치 후 검증·기록 (#79, #80, #81)
+    answers = [], unresolved = [], secrets = new Map(), installLogPath = "", cleanup = null } = ctx || {};
   const err = (s = "") => process.stderr.write(`${s}\n`);
   // 색상은 ansi.js의 공용 가드로 통일 (NO_COLOR + stderr TTY 여부)
   const enabled = colorEnabled(process.stderr);
@@ -87,14 +89,38 @@ export function printSummary(ctx) {
   err("");
   err("  🔧 .github/scripts/");
   err("     ├─ version_manager.py");
-  err("     └─ changelog_manager.py");
+  err("     ├─ changelog_manager.py");
+  err("     ├─ truncate_release_notes.py");
+  err("     └─ issue_helper.py");
   err("");
 
+  // 입력한 환경설정 값 (#80) — 마지막으로 눈으로 검산할 기회. 종전에는 답변이 워크플로우
+  // YAML 안으로만 사라져, 오타를 내도 배포가 실패한 뒤에야 알 수 있었다.
+  if (answers.length) {
+    err("  ⚙️  적용된 환경설정:");
+    for (const a of answers) {
+      const mark = a.isDefault ? paint(" (기본값)", A.dim, enabled) : "";
+      err(`     • ${a.label}: ${paint(a.value, A.green, enabled)}${mark}`);
+    }
+    err("");
+  }
+  // 배포 방식을 바꿔 재설치한 경우, 이전 CD를 어떻게 처리했는지 알린다 (#80).
+  if (cleanup?.removed?.length || cleanup?.backedUp?.length) {
+    err("  🧹 이전 배포 방식 정리:");
+    for (const f of cleanup.removed || []) err(`     • ${f} ${paint("삭제 (손대지 않은 파일)", A.dim, enabled)}`);
+    for (const f of cleanup.backedUp || []) err(`     • ${f} → ${f}.bak ${paint("수정하신 내용이 있어 백업", A.dim, enabled)}`);
+    err("");
+  }
+  if (installLogPath) {
+    err(`  📋 설치 기록: ${installLogPath}`);
+    err("     → 나중에 '무엇을 어떤 값으로 설치했는지' 확인할 때 이 파일을 보세요");
+    err("");
+  }
+
   // 프로젝트 타입별 안내
   if (types.includes("spring")) {
     err("  💡 Spring 프로젝트 추가 설정:");
-    err("     • build.gradle의 버전 정보가 자동 동기화됩니다");
-    err("     • CI/CD 워크플로우에서 GitHub Secrets 설정이 필요합니다");
+    err("     • build.gradle / build.gradle.kts / pom.xml 의 버전 정보가 자동 동기화됩니다");
     err("");
   }
 
@@ -106,12 +132,36 @@ export function printSummary(ctx) {
   err("");
   err(paint(paint("⚠️  다음 작업을 확인해주세요:", A.yellow, enabled), A.bold, enabled));
   err("");
-  err("  1️⃣  릴리스 automerge용 PAT (선택 — 없으면 GITHUB_TOKEN 사용)");
+
+  let step = 0;
+  const num = () => ["1️⃣ ", "2️⃣ ", "3️⃣ ", "4️⃣ ", "5️⃣ "][step++] || " •";
+
+  // 미치환 플레이스홀더 (#81) — 이 상태로는 해당 워크플로우가 동작하지 않으므로 제일 먼저 알린다.
+  if (unresolved.length) {
+    err(`  ${num()} ${paint("값이 채워지지 않은 항목이 있습니다 — 직접 채워야 동작합니다", A.red, enabled)}`);
+    for (const u of unresolved) {
+      err(`     → ${u.filename}:${u.line}  ${paint(u.token, A.bold, enabled)}`);
+    }
+    err("");
+  }
+
+  // 설치된 워크플로우가 실제로 요구하는 Secret (#80) — 종전에는 하나도 안내되지 않아
+  // "설치 성공"인데 배포는 돌지 않는 상태로 끝났다.
+  if (secrets.size) {
+    err(`  ${num()} 아래 GitHub Secret을 등록해야 배포 워크플로우가 동작합니다 (${secrets.size}개)`);
+    err("     → Settings > Secrets and variables > Actions");
+    for (const [name, users] of secrets) {
+      err(`     → ${paint(name, A.bold, enabled)}  ${paint(users.join(", "), A.dim, enabled)}`);
+    }
+    err("");
+  }
+
+  err(`  ${num()} 릴리스 automerge용 PAT (선택 — 없으면 GITHUB_TOKEN 사용)`);
   err("     → Repository Settings > Secrets > Actions");
   err("     → Secret Name: WORKFLOW_PAT (Scopes: repo, workflow)");
   err("     → GITHUB_TOKEN 머지는 후속 워크플로우를 트리거하지 않습니다");
   err("");
-  err("  2️⃣  GitHub Actions 권한 확인");
+  err(`  ${num()} GitHub Actions 권한 확인`);
   err("     → Settings > Actions > Workflow permissions: Read and write");
   err("");
   err(SEPARATOR);