project-auto-wizard 0.12.0 → 0.12.2

package/src/commands/interactive.js

@@ -10,7 +10,6 @@ import { parseExisting } from "../core/version-yml.js";
 import { runBreakingCheck } from "../core/breaking-check.js";
 import { resolveProjectPaths } from "../core/paths-resolve.js";
 import { resolveBranchConfig, detectRemoteBranches, ensureDevelopBranch, sortBranchesForSelection } from "../core/branches.js";
-import { askAllOptionalWorkflows } from "../core/options-ask.js";
 import { promptEnvPlan } from "../ui/env-plan.js";
 import { surveyWorkflows } from "../core/copy/workflows.js";
 import { createContext, VALID_TYPES } from "../context.js";
@@ -34,7 +33,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   const payload = assertPayload(payloadRoot ?? resolvePayloadRoot());
   const templateVersion = readTemplateVersion();
 
-  // 층1 — 시작 배너 (#446 확정 시안 A). 스텁엔 banner 없음 → intro 폴백.
+  // 시작 배너. 스텁엔 banner 없음 → intro 폴백.
   if (io.banner) io.banner({ version: templateVersion, modeLabel: "대화형 통합 마법사" });
   else io.intro?.("project-auto-wizard — 대화형 통합 마법사");
 
@@ -42,12 +41,12 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   const vyPath = join(cwd, "version.yml");
   const existing = existsSync(vyPath) ? parseExisting(readFileSync(vyPath, "utf8")) : null;
 
-  // 층5 — 신규/업데이트 판별 (#446)
+  // 신규/업데이트 판별
   io.installKind?.({ currentTemplateVersion: existing?.templateVersion || "", templateVersion });
 
   // 1) 모드 선택
   // status/doctor — 읽기 전용이라 감지·breaking 게이트가 필요 없다. 결과를 보여준 뒤 메뉴로
-  // 돌아온다(이슈 #31): 진단의 목적이 설치 준비이므로 확인 → 설치를 한 세션에서 끝내야 한다.
+  // 돌아온다: 진단의 목적이 설치 준비이므로 확인 → 설치를 한 세션에서 끝내야 한다.
   // CLI 경로(index.js의 --mode status/doctor)는 단발 명령이므로 지금처럼 즉시 종료한다.
   let mode;
   for (let round = 0; ; round++) {
@@ -75,7 +74,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
 
   // full/version/workflows — 감지 (version은 기존 version.yml 최우선)
   // 감지 경고는 즉시 찍지 않고 모았다가 감지 박스 안에서 출력한다 — 종전에는 경고가 박스보다
-  // 먼저 나와 앞선 질문에 대한 경고처럼 보였다 (이슈 #80). 안내 문구도 대화형용으로 바꾼다.
+  // 먼저 나와 앞선 질문에 대한 경고처럼 보였다. 안내 문구도 대화형용으로 바꾼다.
   const detectWarnings = [];
   let types = detectTypes(cwd);
   let version = (existing?.version) || detectVersion(cwd, {
@@ -85,16 +84,14 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   let branch = detectDefaultBranch(cwd);
   const repoName = detectRepoName(cwd);
   // 선택 워크플로우 초기값: version.yml 저장 옵션 (.sh read_template_options L2361 등가)
-  let includeNexus = existing?.options?.nexus ?? false;
-  let includeSecretBackup = existing?.options?.secretBackup ?? false;
   let includeSemverAuto = existing?.options?.semverAuto ?? null;
   let includeCopilotAi = existing?.options?.copilotAi ?? null;
-  // 서버 배포 방식 — 저장값(version.yml)이 있으면 재질문하지 않는다 (nexus/secret_backup과 같은 규약).
+  // 서버 배포 방식 — 저장값(version.yml)이 있으면 재질문하지 않는다 (semver_auto와 같은 규약).
   let deployStyle = isDeployStyle(existing?.options?.deployStyle) ? existing.options.deployStyle : "";
   const showOptional = mode === "full";
   const realTty = process.stdout.isTTY === true;
 
-  // Flutter 옵션 (이슈 #131) — 저장값이 있으면 재질문하지 않는다 (deploy_style과 같은 규약).
+  // Flutter 옵션 — 저장값이 있으면 재질문하지 않는다 (deploy_style과 같은 규약).
   // 저장값 없는 기존 설치는 동작 보존을 위해 dotenv를 초기 선택으로, 스토어는 설치된 워크플로우로 추론한다.
   // 환경변수 기본값 규칙(신규=dart-define, 기존 설치·저장값 없음=dotenv)은 resolveFlutterOptions가 단일 진실이다.
   let flutter = savedFlutterState(existing);
@@ -109,11 +106,11 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     if (types.includes("flutter")) flutter = await askUnsetFlutterOptions(io, flutter, flutterAsk);
   };
 
-  // 층2 — 감지 로그 (#446). markers = 실제로 존재를 확인한 파일 (이슈 #77).
+  // 감지 로그. markers = 실제로 존재를 확인한 파일.
   let markers = detectMarkers(cwd, types);
   io.detectionLog?.({ types, version, branch, markers, warnings: detectWarnings });
 
-  // 타입 확정 (이슈 #78) — 감지는 추정이므로 다른 질문보다 먼저 확인받는다. 종전에는 확정 UI가
+  // 타입 확정 — 감지는 추정이므로 다른 질문보다 먼저 확인받는다. 종전에는 확정 UI가
   // '수정하기 > 프로젝트 타입' 두 단계 뒤에 숨어 있어, 타입이 틀린 채로 설치가 끝나는 일이 많았다.
   // 타입이 뒤에 나올 질문(선택 워크플로우·경로·env)의 범위를 정하므로 순서상 여기가 맞다.
   // 저장값이 있는 업데이트 설치와 비대화형에서는 묻지 않는다 — 기존 동작 그대로.
@@ -128,24 +125,15 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     }
   }
 
-  // 선택 워크플로우(Nexus/Secret) 질문 (.sh ask_all_optional_workflows L2707 — full/workflows만)
+  // 배포 방식·Flutter 옵션·semver/Copilot 질문 — 선택 항목을 묻는 경우(showOptional)만
   if (showOptional) {
-    const r = await askAllOptionalWorkflows({
-      payloadRoot: payload, types, targetRoot: cwd,
-      current: { nexus: existing?.options?.nexus ?? null, secretBackup: existing?.options?.secretBackup ?? null },
-      force: false, tty: realTty,
-      io: { confirm: ({ message, initialValue }) => io.askYesNo(message, initialValue) },
-    });
-    includeNexus = r.nexus;
-    includeSecretBackup = r.secretBackup;
-
-    // 서버 배포 방식 (이슈 #80). Nexus(라이브러리)를 고르면 server-deploy가 통째로 빠지므로 묻지 않는다.
-    if (!includeNexus && !isDeployStyle(deployStyle)) {
+    // 서버 배포 방식.
+    if (!isDeployStyle(deployStyle)) {
       const picked = await io.selectDeployStyle();
       deployStyle = isDeployStyle(picked) ? picked : DEFAULT_DEPLOY_STYLE; // ESC = 기본값
     }
 
-    // Flutter 옵션 (이슈 #131) — 환경변수 방식 → 스토어 배포 대상 → 플랫폼별 배포 모드.
+    // Flutter 옵션 — 환경변수 방식 → 스토어 배포 대상 → 플랫폼별 배포 모드.
     await askFlutterOptions();
 
     // 신규 질문 — 자동 semver 승격 (기본 ON). 저장값 있으면 재질문 생략.
@@ -171,11 +159,11 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   let paths = new Map();
   let confirmed = false;
   while (!confirmed) {
-    // 층3 — 프로젝트 분석 개요 카드 (#446). 스텁엔 없음 → note 폴백.
+    // 프로젝트 분석 개요 카드. 스텁엔 없음 → note 폴백.
     if (io.analysisCard) {
-      io.analysisCard({ mode, modeLabel: modeLabel(mode), types, version, branch, includeNexus, includeSecretBackup, showOptional, paths, flutter, envModeDefault: flutterAsk.envModeDefault });
+      io.analysisCard({ mode, modeLabel: modeLabel(mode), types, version, branch, showOptional, paths, flutter, envModeDefault: flutterAsk.envModeDefault });
     } else {
-      io.note?.(summarize({ mode, types, version, branch, includeNexus, includeSecretBackup, showOptional, flutter, envModeDefault: flutterAsk.envModeDefault }), "프로젝트 분석 결과");
+      io.note?.(summarize({ mode, types, version, branch, showOptional, flutter, envModeDefault: flutterAsk.envModeDefault }), "프로젝트 분석 결과");
     }
     const choice = await io.confirmProjectMenu();
     if (choice === "cancel") { io.cancelMessage?.("설치를 취소했습니다."); return 0; }
@@ -184,7 +172,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     // edit 루프
     let editing = true;
     while (editing) {
-      const what = await io.editMenu({ showOptional, showFlutter: showOptional && types.includes("flutter") });
+      const what = await io.editMenu({ showFlutter: showOptional && types.includes("flutter") });
       if (isCancel(what) || what === "done") { editing = false; break; }
       if (what === "type") {
         const t = await io.selectTypes(types);
@@ -204,12 +192,6 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
       } else if (what === "branch") {
         const b = await io.askText("기본 브랜치", branch);
         if (!isCancel(b) && b) branch = b;
-      } else if (what === "nexus") {
-        const y = await io.askYesNo("Nexus publish 워크플로우를 포함할까요?", includeNexus);
-        if (!isCancel(y)) includeNexus = y === true;
-      } else if (what === "secret") {
-        const y = await io.askYesNo("Secret 백업 워크플로우를 포함할까요?", includeSecretBackup);
-        if (!isCancel(y)) includeSecretBackup = y === true;
       } else if (FLUTTER_EDIT_ITEMS.has(what)) {
         flutter = await editFlutterOption(io, what, flutter, flutterAsk.envModeDefault);
       }
@@ -226,7 +208,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     iosDeployMode: flutter.iosDeployMode || DEFAULT_DEPLOY_MODE,
   };
 
-  const versionCode = existing?.versionCode ?? detectBuildNumber(cwd, { types }) ?? 1; // 기존 빌드번호 보존, 신규 통합 시 프로젝트 파일에서 감지 (이슈 #41)
+  const versionCode = existing?.versionCode ?? detectBuildNumber(cwd, { types }) ?? 1; // 기존 빌드번호 보존, 신규 통합 시 프로젝트 파일에서 감지
 
   // 신규 질문 ① — 브랜치 설정 (DESIGN-SPEC §4). full/workflows만 질문, version은 기본값 기록.
   // 저장값(version.yml metadata.template.branches)이 있으면 재질문 없이 재사용 (업데이트 모드).
@@ -235,7 +217,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     : resolveBranchConfig({ defaultBranch: branch });
   if (showOptional && !existing?.branches) {
     const remoteBranches = await detectRemoteBranches(cwd);
-    // 이슈 #93 — 두 질문에 같은 이름을 입력해야만 trunk-based가 되는 암묵적 규칙 대신,
+    // 두 질문에 같은 이름을 입력해야만 trunk-based가 되는 암묵적 규칙 대신,
     // 전략을 먼저 명시적으로 고르게 한다. 취소/그 외 값은 기존 기본 동작과 같은 pr-flow로 폴백
     // (selectDeployStyle의 "ESC = 기본값" 패턴과 동일).
     const strategyPick = await io.selectBranchStrategy();
@@ -273,22 +255,21 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   if (showOptional) {
     const plan = await promptEnvPlan({
       payloadRoot: payload, types, io: io.engineIo ?? null, force: false,
-      resolvers, includeNexus, includeSecretBackup, deployStyle, targetRoot: cwd, repoName,
-      flutterStore: flutterOptions.stores, // 선택 해제된 스토어 워크플로우의 ask 질문은 묻지 않는다 (D2 env-plan)
+      resolvers, deployStyle, targetRoot: cwd, repoName,
+      flutterStore: flutterOptions.stores, // 선택 해제된 스토어 워크플로우의 ask 질문은 묻지 않는다
     });
     envValues = plan.values;
     envUseDefaults = plan.useDefaults;
-    envAnswers = plan.answers || []; // 완료 요약·설치 로그가 같은 답변 데이터를 쓴다 (#79, #80)
+    envAnswers = plan.answers || []; // 완료 요약·설치 로그가 같은 답변 데이터를 쓴다
   }
 
   const { now, today } = clock || utcNow();
   const ctx = createContext({
     mode, force: true, types, version, versionCode, branch, branches, paths,
-    includeNexus, includeSecretBackup,
     includeSemverAuto,
     includeCopilotAi,
     repoName, templateVersion, resolvers, envValues, envUseDefaults, now, today,
-    // 설치 로그(#79)·완료 요약(#80)이 쓰는 부가 문맥 — 설치 동작 자체는 바꾸지 않는다.
+    // 설치 로그·완료 요약이 쓰는 부가 문맥 — 설치 동작 자체는 바꾸지 않는다.
     markers, envAnswers, detectWarnings,
     deployStyle: deployStyle || DEFAULT_DEPLOY_STYLE,
     envMode: flutterOptions.envMode, flutterStore: flutterOptions.stores,
@@ -297,7 +278,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   });
   ctx.templateVersion = templateVersion;
 
-  // 사용자가 답해야 하는 것만 묻는다 (issue #69). baseline 3-way가 자동으로 안전한 경우를
+  // 사용자가 답해야 하는 것만 묻는다. baseline 3-way가 자동으로 안전한 경우를
   // 걸러내므로, 여기 오는 것은 (a) 양쪽이 다 바뀐 진짜 충돌과 (b) 사용자가 지운 파일뿐이다.
   let hooks = {};
   if (showOptional && io.engineIo?.select) {
@@ -363,7 +344,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
 }
 
 // 브랜치 선택 — 원격 목록이 있으면 select(+직접 입력), 없으면 텍스트 입력. ESC/빈값 = 기본값.
-// 이슈 #85: def를 최우선으로, main/develop을 그다음으로 정렬하고 커서를 def에 고정한다.
+// def를 최우선으로, main/develop을 그다음으로 정렬하고 커서를 def에 고정한다.
 export async function pickBranch(io, message, def, remoteBranches, isCancel) {
   if (io.engineIo?.select && remoteBranches.length) {
     const sorted = sortBranchesForSelection(remoteBranches, def);
@@ -383,7 +364,7 @@ export async function pickBranch(io, message, def, remoteBranches, isCancel) {
   return isCancel(v) || !v ? def : v;
 }
 
-function summarize({ mode, types, version, branch, includeNexus, includeSecretBackup, showOptional, flutter, envModeDefault }) {
+function summarize({ mode, types, version, branch, showOptional, flutter, envModeDefault }) {
   const lines = [
     `통합 모드 : ${modeLabel(mode)}`,
     `프로젝트 타입 : ${types.join(", ")}${types.length > 1 ? " (멀티)" : ""}`,
@@ -391,8 +372,6 @@ function summarize({ mode, types, version, branch, includeNexus, includeSecretBa
     `기본 브랜치 : ${branch}`,
   ];
   if (showOptional) {
-    lines.push(`Nexus publish : ${includeNexus ? "포함" : "제외"}`);
-    lines.push(`Secret 백업 : ${includeSecretBackup ? "포함" : "제외"}`);
     if (types.includes("flutter")) {
       const stores = flutter.stores ?? [];
       const modeParts = stores.map((p) => `${p}=${(p === "android" ? flutter.androidDeployMode : flutter.iosDeployMode) || DEFAULT_DEPLOY_MODE}`);

package/src/commands/purge.js

@@ -48,7 +48,7 @@ export function printPurgePlan(plan, { dryRun = false } = {}) {
 // 실제 삭제 수행 — planPurge()와 동일 shape을 반환하되 실제로 제거된 항목을 반영한다.
 // planRemoval 결과를 그대로 지우지 않는 이유: 그 목록은 항상 전체라서
 // --keep-* 로 선택적 카테고리만 보존하는 요구사항과 맞지 않는다.
-// H3 (Fable 검토): readmeSection은 plan의 판정을 그대로 되돌려주지 않고
+// readmeSection은 plan의 판정을 그대로 되돌려주지 않고
 // removeVersionSectionFromReadme()의 실제 반환값("removed"인지)을 반영한다 — 스펙 §6이
 // "반환값은 실제 삭제 결과를 반영"하라고 명시하기 때문에, plan과 실제 제거 조건이
 // 이론상 어긋나는 경우에도 printPurgeResult가 거짓으로 "제거됨"을 보고하지 않는다.
@@ -65,7 +65,7 @@ export function executePurge(payloadRoot, targetRoot = ".", keepFlags = {}) {
 }
 
 // 삭제 후 실제 제거된 목록 출력 — printPurgePlan과 완전히 동일한 형태(파일명 나열)로
-// 맞춘다 (M3, Fable 검토: 개수만 출력하면 스펙 §5-6의 "제거된 목록 재출력" 요구를 충족하지 못함).
+// 맞춘다 (개수만 출력하면 스펙 §5-6의 "제거된 목록 재출력" 요구를 충족하지 못함).
 export function printPurgeResult(result) {
   const lines = ["", "제거됨:", ""];
   lines.push(`워크플로우 (${result.workflows.length}개):`);

package/src/commands/status.js

@@ -26,8 +26,6 @@ export function runStatus(payloadRoot, targetRoot = ".") {
   const branchesForCompare = existing.branches || { main: detectDefaultBranch(targetRoot) || "main", develop: "develop", mode: "pr-flow" };
   const context = {
     types: existing.types, paths: existing.paths,
-    includeNexus: existing.options.nexus === true,
-    includeSecretBackup: existing.options.secretBackup === true,
     repoName, resolvers, branches: branchesForCompare,
     flutterStore: flutterOptions.stores,
   };
@@ -41,7 +39,7 @@ export function runStatus(payloadRoot, targetRoot = ".") {
     branches: existing.branches,
     options: existing.options,
     // 사용자가 손댄 파일 = 진짜 충돌(changed) + 업스트림은 그대로인데 내가 고친 것(localOnly).
-    // baseline이 없으면 localOnly는 항상 비어 있어 종전과 동일하게 동작한다 (issue #69).
+    // baseline이 없으면 localOnly는 항상 비어 있어 종전과 동일하게 동작한다.
     modifiedFiles: [...plan.changed, ...plan.localOnly].map((f) => f.filename),
     // 업데이트 시 무슨 일이 일어날지 미리 보여주는 버킷들 — 판단 재료가 없어 사용자가
     // 직접 git diff를 떠야 했던 문제를 없앤다.
@@ -71,7 +69,7 @@ export function printStatus(status) {
   const semverAutoLabel = status.options.semverAuto === null ? "미설정(기본 false)" : status.options.semverAuto;
   const copilotAiLabel = boolLabel(status.options.copilotAi ?? null);
   const flutterLabels = status.types.includes("flutter") ? flutterOptionLabels(status.options) : "";
-  lines.push(`옵션            : nexus=${boolLabel(status.options.nexus)} secret_backup=${boolLabel(status.options.secretBackup)} semver_auto=${semverAutoLabel} copilot_ai=${copilotAiLabel}${flutterLabels}`);
+  lines.push(`옵션            : semver_auto=${semverAutoLabel} copilot_ai=${copilotAiLabel}${flutterLabels}`);
   if (status.modifiedFiles.length) {
     lines.push("", `사용자가 수정한 워크플로우 파일 (${status.modifiedFiles.length}개):`);
     for (const f of status.modifiedFiles) lines.push(`  - ${f}`);
@@ -79,7 +77,7 @@ export function printStatus(status) {
     lines.push("", "모든 워크플로우 파일이 설치 시점 기본값과 동일합니다 (수정 없음).");
   }
 
-  // 업데이트하면 무슨 일이 일어나는지 (issue #69). baseline이 없는 설치는 전부 0이라 출력하지 않는다.
+  // 업데이트하면 무슨 일이 일어나는지. baseline이 없는 설치는 전부 0이라 출력하지 않는다.
   const b = status.buckets || { autoUpdatable: [], localKept: [], conflicts: [], removed: [] };
   if (b.autoUpdatable.length || b.localKept.length || b.conflicts.length || b.removed.length) {
     lines.push("", "지금 업데이트하면:");
@@ -92,7 +90,7 @@ export function printStatus(status) {
   console.log(lines.join("\n"));
 }
 
-// Flutter 타입일 때만 붙는 옵션 (이슈 #131). 저장값이 없으면 그 상태에서 실제로 적용되는 동작을 함께 알린다.
+// Flutter 타입일 때만 붙는 옵션. 저장값이 없으면 그 상태에서 실제로 적용되는 동작을 함께 알린다.
 function flutterOptionLabels(options) {
   return [
     ` env_mode=${options.envMode ?? "미설정(dotenv 유지)"}`,

package/src/commands/uninstall.js

@@ -17,7 +17,7 @@ export function planUninstall(payloadRoot, targetRoot, selection) {
   const removalPlan = planRemoval(payloadRoot, targetRoot);
   return {
     workflows: selection.workflows ? removalPlan.workflows : [],
-    // baseline은 워크플로우 해시 기록 — 워크플로우를 지우면 함께 사라져야 한다 (issue #69)
+    // baseline은 워크플로우 해시 기록 — 워크플로우를 지우면 함께 사라져야 한다
     baseline: selection.workflows ? removalPlan.baseline : [],
     scripts: selection.scripts ? removalPlan.scripts : [],
     readme: selection.readme ? hasVersionSection(targetRoot) : false,
@@ -46,7 +46,7 @@ export function runUninstall(context, payloadRoot, targetRoot, selection) {
 // ── 대화형 체크리스트 흐름 ────────────────────────────────────────────
 const ITEM_DEFS = [
   // .github/.wizard 에는 baseline.json과 설치 로그(.wizard/logs)가 함께 들어 있다 —
-  // 워크플로우를 지우면 함께 사라지므로 라벨에 명시한다 (이슈 #79).
+  // 워크플로우를 지우면 함께 사라지므로 라벨에 명시한다.
   { key: "workflows", label: "워크플로우 (.github/workflows/PROJECT-*.yaml) + 설치 기록 (.github/.wizard)" },
   { key: "scripts", label: "스크립트 (.github/scripts/*.py)" },
   { key: "readme", label: "README.md 버전 섹션 (AUTO-VERSION-SECTION)" },
@@ -54,8 +54,7 @@ const ITEM_DEFS = [
   { key: "versionYml", label: "version.yml (버전/브랜치 설정 전체)" },
 ];
 
-// 기본 체크 상태 — 설치 시 옵션(nexus/secret-backup)이 opt-in인 것과 대칭으로,
-// 여기서는 "안전 삭제" 2종만 기본 체크하고 나머지(readme/gitignore/versionYml)는 opt-in.
+// 기본 체크 상태 — "안전 삭제" 2종만 기본 체크하고 나머지(readme/gitignore/versionYml)는 opt-in.
 export const SAFE_ITEMS = ["workflows", "scripts"];
 
 function detectAvailableItems(payloadRoot, targetRoot) {

package/src/context.js

@@ -4,9 +4,9 @@ export const VALID_TYPES = [
   "react-native", "react-native-expo", "node", "python", "basic", "go",
 ];
 
-// --mode 화이트리스트 (issue #19) — 알 수 없는 값은 부수효과(브랜치 조회 등) 이전에 즉시 거부해야 한다.
-// purge는 --help/대화형 메뉴에 노출하지 않는 숨김 모드(issue #6)이지만 검증 대상에는 포함한다.
-// version/workflows(부분 설치)와 revert는 제거됐다 (issue #70) — 부분 설치는 설치 시점 baseline을
+// --mode 화이트리스트 — 알 수 없는 값은 부수효과(브랜치 조회 등) 이전에 즉시 거부해야 한다.
+// purge는 --help/대화형 메뉴에 노출하지 않는 숨김 모드이지만 검증 대상에는 포함한다.
+// version/workflows(부분 설치)와 revert는 제거됐다 — 부분 설치는 설치 시점 baseline을
 // 반쪽만 갱신해 업데이트 판정을 흐리고, revert는 uninstall의 부분집합이었다.
 export const VALID_MODES = [
   "interactive", "full",
@@ -24,11 +24,9 @@ export function createContext(overrides = {}) {
     branch: "",
     branches: null,          // { main, develop, mode: "pr-flow"|"trunk-based" } — resolveBranchConfig 결과
     paths: new Map(),        // type -> path
-    includeNexus: null,      // null=미설정, true/false=명시
-    includeSecretBackup: null,
     includeSemverAuto: null, // null=미설정(다운스트림에서 true로 해석), true/false=명시
     includeCopilotAi: null,  // null=미설정(다운스트림에서 false로 해석), true/false=명시 — Copilot AI 요약 opt-in
-    // Flutter 옵션 (이슈 #131) — Flutter 타입이 없는 프로젝트에서는 전부 무시된다.
+    // Flutter 옵션 — Flutter 타입이 없는 프로젝트에서는 전부 무시된다.
     // 결정은 src/core/flutter-options.js의 resolveFlutterOptions가 한다.
     envMode: "",             // "dart-define" | "dotenv". ""=미결정 → 템플릿 기본값(dart-define)
     flutterStore: null,      // 스토어 배포 대상 string[] (예: ["android","ios"]). null=미결정 → 둘 다(현행 동작)

package/src/core/assets.js

@@ -24,7 +24,7 @@ export function readTemplateVersion() {
   }
 }
 
-// payload/workflows/common 직하위 yaml 목록 (secret-backup 하위 폴더 제외 — 복사 엔진과 동일 규약).
+// payload/workflows/common 직하위 yaml 목록.
 export function listCommonWorkflows(payloadRoot = resolvePayloadRoot()) {
   return listYamlFiles(join(payloadRoot, "workflows", "common"));
 }
@@ -40,7 +40,7 @@ export function assertPayload(payloadRoot = resolvePayloadRoot()) {
   return payloadRoot;
 }
 
-// payload/version.yml.template 원문 (Task 14 치환 파이프라인 소비).
+// payload/version.yml.template 원문.
 export function readVersionYmlTemplate(payloadRoot = resolvePayloadRoot()) {
   const p = join(payloadRoot, "version.yml.template");
   return exists(p) ? readText(p) : null;

package/src/core/baseline.js

@@ -1,4 +1,4 @@
-// 설치 시점 baseline (issue #69) — 업데이트에서 "누가 바꿨는지"를 가르는 기준점.
+// 설치 시점 baseline — 업데이트에서 "누가 바꿨는지"를 가르는 기준점.
 //
 // 왜 필요한가: isUnchanged()는 payload(theirs)와 설치본(ours)을 2-way로 비교한다.
 // base가 없으니 업스트림이 한 글자만 고쳐도 사용자가 손대지 않은 파일이 changed로 떨어지고,

package/src/core/branches.js

@@ -1,7 +1,7 @@
 // 브랜치 구성 (DESIGN-SPEC §4 신규 질문 ①).
 // on: push: branches: 는 YAML 정적 값 — 마법사가 릴리스/개발 브랜치를 물어(또는 플래그로 받아)
-// {{MAIN_BRANCH}}/{{DEVELOP_BRANCH}} 플레이스홀더를 치환한다 (치환 자체는 branding.js — Task 14).
-// main === develop 이면 trunk-based 모드 → RELEASE-PUBLISH 단독 설치 (설치 매트릭스는 Task 16).
+// {{MAIN_BRANCH}}/{{DEVELOP_BRANCH}} 플레이스홀더를 치환한다 (치환 자체는 branding.js).
+// main === develop 이면 trunk-based 모드 → RELEASE-PUBLISH 단독 설치.
 import { execFile } from "node:child_process";
 
 // 기본 exec — git 명령 실행. 반환 {code, stdout, stderr}. 테스트는 mock 주입.
@@ -34,7 +34,7 @@ export function resolveBranchConfig({ mainBranch = "", developBranch = "", defau
   return { main, develop, mode: main === develop ? "trunk-based" : "pr-flow" };
 }
 
-// 브랜치 선택 프롬프트용 정렬 (이슈 #85). def를 최우선으로, 그다음 priority(main/develop)
+// 브랜치 선택 프롬프트용 정렬. def를 최우선으로, 그다음 priority(main/develop)
 // 순서로 목록 앞에 배치한다. 나머지는 remoteBranches의 원래 순서(git이 준 알파벳순)를 유지한다.
 // 순수 함수 — remoteBranches 원본은 변경하지 않는다.
 export function sortBranchesForSelection(remoteBranches, def, priority = ["main", "develop"]) {

package/src/core/breaking-check.js

@@ -24,7 +24,7 @@ export async function loadBreakingJson(payloadRoot) {
 // opts:
 //   cwd             - 통합 대상 루트 (기존 version.yml에서 현재 템플릿 버전 읽음)
 //   payloadRoot     - 패키지 payload/ 루트 (번들 폴백용)
-//   templateVersion - 설치하려는 템플릿 버전 (.sh의 DEFAULT_VERSION 고정 버그를 실버전으로 교정 — 설계 D2)
+//   templateVersion - 설치하려는 템플릿 버전 (.sh의 DEFAULT_VERSION 고정 버그를 실버전으로 교정)
 //   askYesNo        - async(message, defaultYes)→bool. null이면 비대화형: 경고만 출력 후 진행
 //   loader          - 테스트 주입용 (기본 loadBreakingJson)
 export async function runBreakingCheck({ cwd, payloadRoot, templateVersion, askYesNo = null, loader = loadBreakingJson }) {

package/src/core/breaking.js

@@ -11,7 +11,7 @@ export function compareVersions(a, b) {
 }
 
 // breaking-changes.json에서 current < ver <= target 범위 항목 수집.
-// ⚠️ .sh 버그 수정: target은 하드코딩 1.3.14가 아니라 실제 templateVersion을 넘긴다 (D2).
+// ⚠️ .sh 버그 수정: target은 하드코딩 1.3.14가 아니라 실제 templateVersion을 넘긴다.
 // _ 로 시작하는 키(메타) 제외. severity critical / 그 외(warning).
 // 버전 키의 값은 항목 객체 또는 항목 객체의 배열(같은 릴리스에 고지가 여러 건일 때).
 export function collectBreaking(json, current, target) {

package/src/core/copy/flutter-app.js

@@ -1,6 +1,6 @@
-// Flutter 앱 소유 파일(fastlane·ExportOptions.plist) 설치 (이슈 #131).
+// Flutter 앱 소유 파일(fastlane·ExportOptions.plist) 설치.
 // 워크플로우와 달리 사용자가 값을 채워 넣는 파일이라 "없을 때만 생성"한다 — 덮어쓰지 않고 baseline
-// 3-way도 적용하지 않는다(copyWorkflows의 secret-backup 경로와 같은 선례). 원본 갱신을 기존 사용자에게
+// 3-way도 적용하지 않는다(기존 사용자 파일을 덮어쓰지 않는 규약). 원본 갱신을 기존 사용자에게
 // 전파하는 것은 범위 밖이다.
 import { join, posix } from "node:path";
 import { existsSync } from "node:fs";

package/src/core/copy/gitignore.js

@@ -1,15 +1,15 @@
 // .gitignore 보장 — 마법사 자신이 만드는 충돌 백업 부산물(*.bak, *.template.yaml)만 대상으로 한다.
-// 마법사가 설치하는 것과 무관한 개인 개발환경 설정(IDE 등)은 마법사 책임 범위 밖 — issue #7.
+// 마법사가 설치하는 것과 무관한 개인 개발환경 설정(IDE 등)은 마법사 책임 범위 밖.
 // 배너 블록은 종료 마커(BANNER_END)로 범위가 명확히 구분되어 있어, 그 안에 사용자가 다른 줄을
-// 끼워넣어도 REQUIRED_ENTRIES만 정확히 개별 제거하고 나머지는 보존한다 (issue #20 M7).
+// 끼워넣어도 REQUIRED_ENTRIES만 정확히 개별 제거하고 나머지는 보존한다.
 // 주의(의도된 트레이드오프): 이 수정 이전 버전으로 설치되어 종료 마커가 없는 배너가 이미 있는
 // 레포에서는, 배너 직후 REQUIRED_ENTRIES가 연속으로 이어지는 동안만 제거하는 구 방식으로
-// 폴백한다 — issue #7이 "이미 설치된 레포의 .gitignore는 소급 처리하지 않고 사용자 판단에
+// 폴백한다 — 이전 결정이 "이미 설치된 레포의 .gitignore는 소급 처리하지 않고 사용자 판단에
 // 맡긴다"고 명시하므로 별도 마이그레이션 로직을 추가하지 않는다.
 import { join } from "node:path";
 import { existsSync, readFileSync, writeFileSync, rmSync } from "node:fs";
 
-// issue #7: 마법사가 설치하는 것과 무관한 개인 개발환경 항목(/.idea 등)은 마법사 책임 밖이므로 제거.
+// 마법사가 설치하는 것과 무관한 개인 개발환경 항목(/.idea 등)은 마법사 책임 밖이므로 제거.
 // 대신 마법사 자신의 충돌 처리(workflows.js backup/template 결정)가
 // 실제로 만들어내는 부산물만 gitignore 대상으로 삼는다.
 const REQUIRED_ENTRIES = ["*.bak", "*.template.yaml"];
@@ -66,7 +66,7 @@ export function ensureGitignore(targetRoot = ".") {
 // ensureGitignore가 기존 파일에 배너 블록을 추가할 때 항상 이 정확한 시퀀스로 시작한다
 // (빈 줄 하나 + 3줄 배너), 그리고 REQUIRED_ENTRIES 뒤에 BANNER_END로 끝난다. 배너~BANNER_END
 // 범위 안에서 REQUIRED_ENTRIES와 일치하는 줄만 개별 제거하고, 사용자가 그 사이/뒤에 추가한
-// 줄은 절대 건드리지 않는다 (issue #20 M7).
+// 줄은 절대 건드리지 않는다.
 const BANNER =
   "\n" +
   "# ====================================================================\n" +
@@ -75,7 +75,7 @@ const BANNER =
 
 // REQUIRED_ENTRIES 뒤에 오는 종료 마커 — 배너 블록의 "끝"을 명확히 구분해, 그 사이에 사용자가
 // 다른 줄을 끼워넣어도 removeAutoAddedEntriesFromGitignore가 정확한 범위 안에서 개별 제거할 수
-// 있게 한다 (issue #20 M7). ensureGitignore가 기존 파일에 배너를 추가할 때만 함께 쓴다
+// 있게 한다. ensureGitignore가 기존 파일에 배너를 추가할 때만 함께 쓴다
 // (신규 파일 생성 케이스는 NEW_FILE_CONTENT를 통째로 쓰고 종료 마커는 쓰지 않는다 —
 // startsWith 전체 prefix 매칭이라 별도 마커가 필요 없다).
 const BANNER_END = "# ==== project-auto-wizard: end of auto-added entries ====\n";
@@ -114,7 +114,7 @@ export function removeAutoAddedEntriesFromGitignore(targetRoot = ".") {
 
   // 종료 마커가 있으면(이 수정 이후 설치분) 그 범위 안에서 REQUIRED_ENTRIES만 개별적으로
   // 제거하고, 사용자가 그 사이에 끼워넣은 줄은 순서·연속 여부와 무관하게 그대로 보존한다
-  // (issue #20 M7).
+  //.
   const endIdx = content.indexOf(BANNER_END, afterBanner);
   if (endIdx !== -1) {
     const region = content.slice(afterBanner, endIdx).split("\n");
@@ -126,7 +126,7 @@ export function removeAutoAddedEntriesFromGitignore(targetRoot = ".") {
   }
 
   // 종료 마커가 없는 구버전 설치(이 수정 이전) — 배너 직후 REQUIRED_ENTRIES가 연속으로
-  // 이어지는 동안만 제거하는 기존 방식으로 폴백한다 (issue #7과 동일한 소급 미처리 원칙).
+  // 이어지는 동안만 제거하는 기존 방식으로 폴백한다 (동일한 소급 미처리 원칙).
   const lines = content.slice(afterBanner).split("\n");
   let consumed = 0;
   for (const line of lines) {