project-auto-wizard 0.2.0 → 0.3.0

package/src/core/paths-resolve.js

@@ -9,7 +9,7 @@
 //   io.log(line)                                   → 안내 출력 (없으면 stderr)
 import { existsSync, readdirSync } from "node:fs";
 import { join } from "node:path";
-import { markerForType as baseMarkerForType, extraMarkers } from "./detect.js";
+import { markerForType as baseMarkerForType, resolveMarker } from "./detect.js";
 import { normalizePath, CliError } from "../cli/args.js";
 
 // 취소(ESC/Ctrl+C)는 CANCEL 심볼 — ui를 import하지 않고 심볼 여부로만 판정 (core→ui 역참조 방지)
@@ -24,15 +24,11 @@ export function markerForType(type) {
   return KNOWN_MARKER_TYPES.has(type) ? baseMarkerForType(type) : "";
 }
 
-// 디렉토리에 실재하는 마커 파일명 반환 — 보조 마커 포함, 없으면 대표 마커 (표시용).
+// 디렉토리에 실재하는 마커 파일명 반환 — resolveMarker의 fs 구동판.
 // (.sh existing_marker_in_dir L1232~1245: spring build.gradle/.kts/pom.xml, python pyproject/setup.py/requirements.txt)
 export function existingMarkerInDir(type, dir) {
-  const primary = markerForType(type);
-  const names = primary ? [primary, ...extraMarkers(type)] : [];
-  for (const n of names) {
-    if (existsSync(join(dir, n))) return n;
-  }
-  return primary;
+  if (!markerForType(type)) return ""; // .sh 등가: 미지 타입은 빈 문자열
+  return resolveMarker(type, (n) => existsSync(join(dir, n)));
 }
 
 // maxdepth 3 재귀 파일 탐색 — 매치 파일의 "디렉토리" 상대경로(루트는 ".")를 수집.

package/src/core/removal-plan.js

@@ -63,7 +63,7 @@ export function planRemoval(payloadRoot, targetRoot = ".") {
     // (b) 관리 마커로 시작하는 것 — payload에서 이름이 바뀌거나 삭제된 파일도 인식 (issue #20 L12).
     for (const name of markedWorkflowNames(wfDir)) removedWf.add(name);
   }
-  for (const s of ["version_manager.py", "changelog_manager.py"]) {
+  for (const s of ["version_manager.py", "changelog_manager.py", "truncate_release_notes.py", "issue_helper.py"]) {
     if (existsSync(join(targetRoot, PATHS.scriptsDir, s))) removedScripts.push(s);
   }
   // baseline은 마법사가 만든 내부 상태 파일이다 — 설치물을 지우면 함께 사라져야 한다.

package/src/core/verify.js

@@ -0,0 +1,86 @@
+// 설치 후 검증 (이슈 #81, #80) — 설치된 워크플로우를 다시 읽어 "이대로 돌아가는가"를 본다.
+//
+// 왜 설치 전이 아니라 후인가: 치환은 파일 단위로 흩어져 일어나고 auto 토큰은 resolver 결과에
+// 의존한다. 최종 디스크 내용을 보는 것이 실제로 배포될 것과 같은 것을 보는 유일한 방법이다.
+import { join } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+
+// 치환 대상이 아닌 토큰 — 워크플로우 스크립트 안의 heredoc 구분자다. 값이 아니라 문법이므로
+// 미치환 검사에서 제외한다. (예: cat <<'__SUH_FILE_CONTENT_EOF__')
+const SENTINEL_RE = /^__SUH_[A-Z0-9_]*__$/;
+const PLACEHOLDER_RE = /__[A-Z][A-Z0-9_]*__/g;
+
+// 주석으로 죽어 있는 줄 — 실행되지 않으므로 검사 대상이 아니다.
+// 템플릿에는 "[선택] ..." 예시 스텝이 통째로 주석 처리돼 들어 있는데, 이걸 세면
+// 쓰지도 않는 Secret을 "등록하세요"라고 안내하게 된다.
+const isCommented = (line) => /^\s*#/.test(line);
+
+// 미치환 플레이스홀더 스캔 (이슈 #81).
+// 종전에는 auto 토큰 계산이 실패해도(예: application.yaml을 못 찾아 경로가 빈 문자열) 그 줄을
+// 건드리지 않고 넘어가, __APPLICATION_YML_DIR__ 이 그대로 남은 워크플로우가 "설치 성공"으로
+// 끝났다. 배포 시점에야 그 이름의 디렉토리가 만들어지며 문제가 드러난다.
+//
+// 반환: [{ filename, line, token, text }] — 사람이 바로 고칠 수 있게 줄 번호까지 준다.
+export function scanUnsubstituted(workflowsDir, filenames = []) {
+  const found = [];
+  for (const filename of filenames) {
+    const p = join(workflowsDir, filename);
+    if (!existsSync(p)) continue;
+    let content;
+    try { content = readFileSync(p, "utf8"); } catch { continue; }
+    content.split(/\r?\n/).forEach((text, i) => {
+      if (isCommented(text)) return;
+      for (const token of text.match(PLACEHOLDER_RE) || []) {
+        if (SENTINEL_RE.test(token)) continue;
+        found.push({ filename, line: i + 1, token, text: text.trim() });
+      }
+    });
+  }
+  return found;
+}
+
+// GITHUB_TOKEN은 Actions가 자동 주입하므로 사용자가 등록할 대상이 아니다.
+const AUTO_SECRETS = new Set(["GITHUB_TOKEN"]);
+// 없어도 워크플로우가 도는 secret — 폴백이 문서화돼 있다. 필수와 섞어 "등록해야 동작합니다"라고
+// 하면 안내 자체를 못 믿게 되므로 분리한다.
+//   AI_API_KEY   → 없으면 GitHub Models(무료) → 규칙 fallback
+//   WORKFLOW_PAT → 없으면 GITHUB_TOKEN
+export const OPTIONAL_SECRETS = new Set(["AI_API_KEY", "WORKFLOW_PAT"]);
+const SECRET_RE = /secrets\.([A-Z][A-Z0-9_]*)/g;
+
+// 설치된 워크플로우가 요구하는 GitHub Secret 목록 (이슈 #80).
+// 완료 화면이 WORKFLOW_PAT와 권한만 안내하는 바람에, 배포 워크플로우가 실제로 필요로 하는
+// SERVER_HOST·SSH_KEY 같은 값이 하나도 안내되지 않았다. 설치 직후 상태로는 배포가 돌지 않는데
+// 그 사실이 어디에도 드러나지 않는다.
+//
+// 반환: Map<secretName, string[] 그 secret을 쓰는 파일명>
+export function collectRequiredSecrets(workflowsDir, filenames = []) {
+  const out = new Map();
+  for (const filename of filenames) {
+    const p = join(workflowsDir, filename);
+    if (!existsSync(p)) continue;
+    let content;
+    try { content = readFileSync(p, "utf8"); } catch { continue; }
+    for (const line of content.split(/\r?\n/)) {
+      if (isCommented(line)) continue;
+      for (const m of line.matchAll(SECRET_RE)) {
+        const name = m[1];
+        if (AUTO_SECRETS.has(name) || OPTIONAL_SECRETS.has(name)) continue;
+        if (!out.has(name)) out.set(name, []);
+        const users = out.get(name);
+        if (!users.includes(filename)) users.push(filename);
+      }
+    }
+  }
+  return new Map([...out.entries()].sort(([a], [b]) => a.localeCompare(b)));
+}
+
+// SSH 인증 방식에 따라 둘 중 하나만 필요한 secret — 사용자가 이미 답한 값으로 목록을 좁힌다.
+// 안 쓸 secret까지 "등록하세요"라고 하면 안내 자체를 신뢰하지 않게 된다.
+export function narrowSecretsBySshAuth(secrets, sshAuthMethod) {
+  if (!sshAuthMethod) return secrets;
+  const drop = sshAuthMethod === "key" ? "SERVER_PASSWORD" : "SSH_KEY";
+  const out = new Map(secrets);
+  out.delete(drop);
+  return out;
+}

package/src/core/version-yml.js

@@ -1,3 +1,4 @@
+import { DEFAULT_DEPLOY_STYLE } from "./deploy-style.js";
 import { escapeYamlDoubleQuoted } from "./wizard-env.js";
 
 // version.yml 파싱·생성 (.sh create_version_yml 등가, 전체 재생성 전략 D4).
@@ -38,9 +39,11 @@ export function parseExtraTopLevel(content) {
 // 구 synology·coderabbit 키 등 다른 키는 어느 분기에도 안 걸려 자연히 무시된다(파싱 에러 없음).
 // (options-ask.js가 이 함수를 import한다 — 순환 방지 위해 여기(version-yml)에 정의.)
 export function parseTemplateOptions(content) {
-  const out = { nexus: null, secretBackup: null, semverAuto: null };
+  const out = { nexus: null, secretBackup: null, semverAuto: null, deployStyle: null };
   // 값 정규화: 따옴표 제거 + 트림 (.sh tr -d '"' | tr -d "'" | xargs 등가)
-  const strip = (s) => String(s).replace(/["']/g, "").trim();
+  // 인라인 주석(` # ...`)을 먼저 떼고 따옴표·공백을 정리한다. 문자열 값을 받는 키(deploy_style)는
+  // 주석을 안 떼면 "simple # simple | nginx ..." 가 통째로 값이 된다.
+  const strip = (s) => String(s).replace(/\s+#.*$/, "").replace(/["']/g, "").trim();
   let inTemplate = false;
   let inOptions = false;
   for (const line of String(content || "").split("\n")) {
@@ -61,6 +64,8 @@ export function parseTemplateOptions(content) {
         if (v === "false") out.secretBackup = false;
         continue;
       }
+      m = line.match(/^\s+deploy_style:\s*(.+)/);
+      if (m) { const v = strip(m[1]); if (v) out.deployStyle = v; continue; }
       m = line.match(/^\s+semver_auto:\s*(.+)/);
       if (m) {
         const v = strip(m[1]);
@@ -128,7 +133,9 @@ export function parseExisting(content) {
 
 // metadata.template.branches 블록 파싱. 셋 다 있어야 유효 — 아니면 null.
 export function parseTemplateBranches(content) {
-  const strip = (s) => String(s).replace(/["']/g, "").trim();
+  // 인라인 주석(` # ...`)을 먼저 떼고 따옴표·공백을 정리한다. 문자열 값을 받는 키(deploy_style)는
+  // 주석을 안 떼면 "simple # simple | nginx ..." 가 통째로 값이 된다.
+  const strip = (s) => String(s).replace(/\s+#.*$/, "").replace(/["']/g, "").trim();
   let inTemplate = false;
   let inBranches = false;
   const out = { main: "", develop: "", mode: "" };
@@ -168,7 +175,7 @@ export function buildVersionYml({
   const b = branches || { main: branch || "main", develop: "develop", mode: "pr-flow" };
   const {
     templateVersion = "unknown", includeNexus = false, includeSecretBackup = false,
-    includeSemverAuto = true, optionsDate = today,
+    includeSemverAuto = true, deployStyle = "", optionsDate = today,
   } = templateOptions || {};
 
   // project_paths 블록 (full-line 토큰 {{PROJECT_PATHS}} — 없으면 라인 제거)
@@ -205,6 +212,7 @@ export function buildVersionYml({
     MAIN_BRANCH: b.main, DEVELOP_BRANCH: b.develop, BRANCH_MODE: b.mode,
     OPT_NEXUS: String(includeNexus), OPT_SECRET_BACKUP: String(includeSecretBackup),
     OPT_SEMVER_AUTO: String(includeSemverAuto),
+    OPT_DEPLOY_STYLE: String(deployStyle || ""),
   };
 
   const out = [];
@@ -225,3 +233,22 @@ export function buildVersionYml({
   if (!text.endsWith("\n")) text += "\n";
   return text.replace(/\n{3,}$/, "\n"); // 말미 과잉 빈 줄 정리
 }
+
+// context 하나로 version.yml 최종형을 만든다 — 실제 설치(full)와 미리보기(dry-run)가
+// 같은 함수를 쓰게 해서 "미리보기와 결과가 다른" 상황을 구조적으로 막는다.
+// deployValues는 실제 설치에서만 존재한다(미리보기는 치환을 수행하지 않으므로 빈 Map).
+export function renderVersionYml(context, templateText, { pathMarkers, deployValues = new Map(), extraTopLevel = [] }) {
+  const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
+    now, today, templateVersion = "unknown", branches = null,
+    includeNexus = false, includeSecretBackup = false, includeSemverAuto, deployStyle } = context;
+  return buildVersionYml({
+    templateText, version, types, paths, pathMarkers, branch, branches, versionCode, now, today,
+    deployValues, extraTopLevel,
+    templateOptions: {
+      templateVersion, includeNexus, includeSecretBackup,
+      includeSemverAuto: includeSemverAuto !== false,
+      deployStyle: deployStyle || DEFAULT_DEPLOY_STYLE,
+      optionsDate: today,
+    },
+  });
+}

package/src/core/wizard-env.js

@@ -31,11 +31,14 @@ export function setEnvLine(line, key, value) {
   // CRLF 안전: 라인 끝 \r을 분리해 처리 후 복원 (autocrlf 프로젝트 대응)
   const cr = line.endsWith("\r") ? "\r" : "";
   const body = cr ? line.slice(0, -1) : line;
-  const escaped = escapeYamlDoubleQuoted(value);
   // 값 치환: KEY: "기존값" → KEY: "value"
+  // 홑따옴표(KEY: '기존값')도 받는다 — 템플릿에 두 표기가 섞여 있는데 겹따옴표만 보면
+  // 홑따옴표 줄의 @wizard 마커가 아무 경고 없이 무시된다(이슈 #81과 같은 실패 형태).
+  // 치환 결과는 겹따옴표로 통일하고, 값은 그에 맞게 이스케이프한다.
+  const escaped = escapeYamlDoubleQuoted(value);
   let out = body.replace(
-    new RegExp(`^(\\s*${key}:\\s*")[^"]*(")`),
-    (_m, p1, p2) => `${p1}${escaped}${p2}`,
+    new RegExp(`^(\\s*${key}:\\s*)(["'])(?:(?!\\2).)*\\2`),
+    (_m, head) => `${head}"${escaped}"`,
   );
   // 그 줄 끝 # @wizard ... 주석 제거 (앞 공백째)
   out = out.replace(/(\S)[^\S\r\n]*#[^\S\r\n]*@wizard[^\S\r\n].*$/, "$1");

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);