project-auto-wizard 0.13.0 → 0.13.2

package/src/core/flutter-hooks.js

@@ -0,0 +1,125 @@
+// Flutter 타입 훅 — types.js 레지스트리의 flutter 항목이 가리키는 구현 모음.
+// 공통 코드는 flutter를 직접 알지 못하고 훅 이름으로만 호출한다(각 훅의 계약은 types.js 머리말 참고).
+import { existsSync } from "node:fs";
+import {
+  ENV_MODES, DEPLOY_MODES, DEFAULT_ENV_MODE, DEFAULT_DEPLOY_MODE, STORE_PLATFORMS, NO_STORE,
+  isEnvMode, isDeployMode, parseStoreList, formatStoreList, deployModeWarning,
+  storeWorkflowFilter, cleanupDeselectedStoreWorkflows, resolveFlutterOptions,
+} from "./flutter-options.js";
+import { planFlutterAppFiles, copyFlutterAppFiles } from "./copy/flutter-app.js";
+import { flutterStoreChecks } from "./flutter-doctor.js";
+import { inferInstalledStores } from "./installed-stores.js";
+import { escapeYamlDoubleQuoted } from "./wizard-env.js";
+import { CliError } from "./errors.js";
+
+// 저장값이 없으면 그 상태에서 실제로 적용되는 동작을 함께 알린다.
+function statusLabels(options) {
+  return [
+    ` env_mode=${options.envMode ?? "미설정(dotenv 유지)"}`,
+    ` flutter_store=${options.flutterStore ?? "미설정(둘 다 설치)"}`,
+    ` android_deploy_mode=${options.androidDeployMode ?? "미설정(store_only)"}`,
+    ` ios_deploy_mode=${options.iosDeployMode ?? "미설정(store_only)"}`,
+  ].join("");
+}
+
+// 스토어 저장값이 없는 기존 Flutter 설치는 설치돼 있는 스토어 워크플로우로 추론한다(대화형과 같은 결론).
+// 추론하지 않으면 미결정이 "둘 다"로 확정 저장되어, 지웠던 플랫폼의 워크플로우·fastlane 파일이 되살아난다.
+// workflowsDir가 없으면(status 등 읽기 전용 경로) 추론하지 않는다.
+function resolveOptions({ opts = {}, existing = null, workflowsDir = null }) {
+  const inferredStores = workflowsDir && opts.flutterStore == null && existing?.types?.includes("flutter")
+    && existing.options?.flutterStore == null && existsSync(workflowsDir)
+    ? inferInstalledStores(workflowsDir) : null;
+  return resolveFlutterOptions({
+    cli: {
+      envMode: opts.flutterEnvMode ?? "", stores: opts.flutterStore ?? inferredStores,
+      androidDeployMode: opts.androidDeployMode ?? "", iosDeployMode: opts.iosDeployMode ?? "",
+    },
+    existing,
+  });
+}
+
+// version.yml options 아래 Flutter 블록(6칸 들여쓰기). 값이 비었으면 워크플로우 템플릿 기본값과 같은 값으로 채운다 —
+// 저장값과 실제 설치 내용이 어긋나지 않게. stores가 null(미결정)이면 현행 동작대로 둘 다 설치되므로 "android,ios"로 기록한다.
+function versionOptionsBlock({ envMode, stores, androidDeployMode, iosDeployMode } = {}) {
+  const quote = (v) => `"${escapeYamlDoubleQuoted(v)}"`;
+  return [
+    `      env_mode: ${quote(envMode || DEFAULT_ENV_MODE)} # ${ENV_MODES.join(" | ")} (Flutter 환경변수 주입 방식)`,
+    `      flutter_store: ${quote(formatStoreList(stores ?? STORE_PLATFORMS))} # android | ios | android,ios | none (스토어 배포 대상)`,
+    `      android_deploy_mode: ${quote(androidDeployMode || DEFAULT_DEPLOY_MODE)} # ${DEPLOY_MODES.join(" | ")} (Play Store 배포 모드)`,
+    `      ios_deploy_mode: ${quote(iosDeployMode || DEFAULT_DEPLOY_MODE)} # ${DEPLOY_MODES.join(" | ")} (iOS 배포 모드)`,
+  ].join("\n");
+}
+
+// 값 목록 검증 플래그 하나를 만든다 — 값이 목록 밖이면 CliError.
+const enumFlag = (flag, field, isValid, allowed) => ({
+  flag, field, initial: "",
+  parse(v) {
+    if (!isValid(v)) throw new CliError(`${flag} 값이 올바르지 않습니다: ${v ?? "(없음)"} (${allowed.join(" | ")})`);
+    return v;
+  },
+});
+
+export const flutterHooks = {
+  resolveOptions,
+  // 확정된 옵션 → 설치 컨텍스트 필드. 기본값은 옵션이 없을 때의 "미결정" 상태다.
+  contextDefaults: {
+    envMode: "",             // "dart-define" | "dotenv". ""=미결정 → 템플릿 기본값(dart-define)
+    flutterStore: null,      // 스토어 배포 대상 string[] (예: ["android","ios"]). null=미결정 → 둘 다(현행 동작)
+    androidDeployMode: "",   // store_only | store_prepare | store_submit. ""=미결정 → store_only
+    iosDeployMode: "",       // 위와 동일 (iOS)
+  },
+  contextFields: (options) => ({
+    envMode: options.envMode,
+    flutterStore: options.stores,
+    androidDeployMode: options.androidDeployMode,
+    iosDeployMode: options.iosDeployMode,
+  }),
+  optionsFromContext: ({ envMode, flutterStore, androidDeployMode, iosDeployMode }) => ({
+    envMode, stores: flutterStore, androidDeployMode, iosDeployMode,
+  }),
+  versionOptionsBlock,
+  // version.yml 저장 키 → 파싱 결과 필드. 값은 원문 문자열로 돌려주고, 유효성 판정은 resolveOptions 몫이다.
+  savedOptionKeys: {
+    env_mode: "envMode", flutter_store: "flutterStore",
+    android_deploy_mode: "androidDeployMode", ios_deploy_mode: "iosDeployMode",
+  },
+  // CLI 플래그 — 파싱 결과 필드(opts)와 값 검증. initial은 미지정 값이다.
+  cliFlags: [
+    enumFlag("--flutter-env-mode", "flutterEnvMode", isEnvMode, ENV_MODES),
+    {
+      flag: "--flutter-store", field: "flutterStore", initial: null,
+      parse(v) {
+        // 빈 문자열은 parseStoreList가 []로 보지만, 스토어를 안 고르겠다는 뜻은 명시적인 none으로만 받는다.
+        const stores = v ? parseStoreList(v) : null;
+        if (stores === null) {
+          throw new CliError(`--flutter-store 값이 올바르지 않습니다: ${v || "(없음)"} (${[STORE_PLATFORMS.join(","), ...STORE_PLATFORMS, NO_STORE].join(" | ")})`);
+        }
+        return stores;
+      },
+    },
+    enumFlag("--android-deploy-mode", "androidDeployMode", isDeployMode, DEPLOY_MODES),
+    enumFlag("--ios-deploy-mode", "iosDeployMode", isDeployMode, DEPLOY_MODES),
+  ],
+  // 설치 직후 알릴 경고 — store_submit은 main push마다 심사를 자동 제출하므로 선택하지 않은 스토어에는 뜨면 안 된다.
+  installNotices: ({ stores, androidDeployMode, iosDeployMode }) => [
+    (stores === null || stores.includes("android")) && deployModeWarning(androidDeployMode),
+    (stores === null || stores.includes("ios")) && deployModeWarning(iosDeployMode),
+  ],
+  // 설치 로그에 남길 선택값 [이름, 값] 목록
+  logChoices: (context) => {
+    const stores = Array.isArray(context.flutterStore) ? (context.flutterStore.join(",") || "없음") : "미결정(둘 다)";
+    return [["flutter",
+      `env=${context.envMode || "-"} stores=${stores} android=${context.androidDeployMode || "-"} ios=${context.iosDeployMode || "-"}`]];
+  },
+  // 스토어 대상이 배열일 때만 스토어 워크플로우 필터를 건다(null=미결정 → 전부 설치).
+  workflowFilter: ({ flutterStore }) => (Array.isArray(flutterStore) ? storeWorkflowFilter(flutterStore) : null),
+  // 선택 해제된 스토어 워크플로우 정리 — 대상이 미결정(null)이면 아무것도 지우지 않는다.
+  cleanupWorkflows: (workflowsDir, installed, context, baseline, opts) => (Array.isArray(context.flutterStore)
+    ? cleanupDeselectedStoreWorkflows(workflowsDir, installed, context.flutterStore, baseline, opts)
+    : { removed: [], backedUp: [] }),
+  appFilesTag: "flutter-app",
+  planAppFiles: planFlutterAppFiles,
+  copyAppFiles: copyFlutterAppFiles,
+  statusLabels,
+  doctorChecks: flutterStoreChecks,
+};

package/src/core/flutter-options.js

@@ -94,6 +94,11 @@ export function storeAppFilesFor(stores) {
   return platforms.flatMap((p) => STORE_APP_FILES[p]);
 }
 
+// store_submit은 main push마다 심사를 제출하므로 고른 직후 한 줄로 알린다. 다른 모드는 알릴 것이 없어 빈 문자열.
+export function deployModeWarning(mode) {
+  return mode === "store_submit" ? "store_submit을 고르면 main push마다 심사가 자동 제출됩니다." : "";
+}
+
 const validOr = (isValid, value, fallback) => (isValid(value) ? value : fallback);
 
 // 옵션 최종 결정 — 우선순위: CLI > version.yml 저장값 > 기본값.

package/src/core/removal-exec.js

@@ -0,0 +1,67 @@
+// uninstall·purge 공통 삭제 실행부 — 두 명령은 옵션을 삭제 계획으로 바꾸기만 하고,
+// 실제 삭제와 기록은 여기서 한 번에 처리한다. 대상 판별은 removal-plan.js(읽기 전용)가 맡는다.
+import { join, posix } from "node:path";
+import { readdirSync, rmdirSync } from "node:fs";
+import { PATHS } from "./paths.js";
+import { remove } from "./fsutil.js";
+import { removeVersionSectionFromReadme } from "./copy/readme.js";
+import { removeAutoAddedEntriesFromGitignore } from "./copy/gitignore.js";
+import { logRemovals } from "./logger.js";
+
+// 파일을 지운 뒤 비게 된 상위 폴더를 레포 루트 직전까지 정리한다(마법사가 만든 fastlane/ 등).
+// 비어 있지 않은 폴더를 만나면 멈추므로 사용자 파일이 남은 폴더는 건드리지 않는다.
+export function pruneEmptyDirs(targetRoot, relDir) {
+  let rel = relDir;
+  while (rel && rel !== "." && rel !== "/") {
+    const abs = join(targetRoot, rel);
+    try {
+      if (readdirSync(abs).length) break;
+      rmdirSync(abs);
+    } catch { break; }
+    rel = posix.dirname(rel);
+  }
+}
+
+// Flutter 앱 파일 제거 — 미수정분만 plan에 들어오므로 그대로 지우고 빈 폴더를 정리한다.
+// 로그는 삭제가 끝난 뒤 한꺼번에 남기므로 기록할 항목을 done에 모은다.
+export function removeAppFiles(targetRoot, appFiles, done = []) {
+  for (const rel of appFiles) {
+    remove(join(targetRoot, rel));
+    pruneEmptyDirs(targetRoot, posix.dirname(rel));
+    done.push(["remove", "flutter-app", rel]);
+  }
+}
+
+// 설치물을 지운 뒤 비게 된 .github/workflows·.github/scripts(와 .github)를 정리한다.
+// 이번에 그 폴더에서 무언가를 지웠을 때만 — 원래 비어 있던 폴더까지 손대지 않는다.
+export function pruneInstallDirs(targetRoot, plan) {
+  if (plan.workflows.length || plan.baseline?.length) pruneEmptyDirs(targetRoot, PATHS.workflowsDir);
+  if (plan.scripts.length) pruneEmptyDirs(targetRoot, PATHS.scriptsDir);
+}
+
+// plan: { workflows, scripts, appFiles, baseline, versionYml, readme, gitignore, changelog } — 모두 "삭제 대상" 여부/목록.
+// options.logOrder: 뒤쪽 항목(version·readme·gitignore·changelog)의 기록 순서 — 명령마다 기존 순서를 유지한다.
+// options.gitignoreDetail(status): .gitignore 기록 문구. null을 돌려주면 기록하지 않는다.
+// 반환: 실제로 제거된 결과 — readme/gitignore는 plan이 대상으로 봤어도 안전하게 포기(skip-*)될 수 있어 실제 결과로 덮어쓴다.
+export function executeRemoval(targetRoot, plan, { logOrder, gitignoreDetail }) {
+  const wfDir = join(targetRoot, PATHS.workflowsDir);
+  const done = [];
+  for (const name of plan.workflows) { remove(join(wfDir, name)); done.push(["remove", "workflow", name]); }
+  for (const name of plan.scripts) { remove(join(targetRoot, PATHS.scriptsDir, name)); done.push(["remove", "script", name]); }
+  removeAppFiles(targetRoot, plan.appFiles, done);
+  for (const p of plan.baseline || []) { remove(join(targetRoot, p)); done.push(["remove", "metadata", p]); }
+  pruneInstallDirs(targetRoot, plan);
+
+  const entries = { version: [], readme: [], gitignore: [], changelog: [] };
+  const readme = !!plan.readme && removeVersionSectionFromReadme(targetRoot) === "removed";
+  const gitignoreStatus = plan.gitignore ? removeAutoAddedEntriesFromGitignore(targetRoot) : null;
+  const gitignore = gitignoreStatus === "removed" || gitignoreStatus === "file-deleted";
+  if (plan.versionYml) { remove(join(targetRoot, PATHS.versionFile)); entries.version.push(["remove", "version", PATHS.versionFile]); }
+  for (const f of plan.changelog || []) { remove(join(targetRoot, f)); entries.changelog.push(["remove", "changelog", f]); }
+  if (readme) entries.readme.push(["remove", "readme", "README.md 버전 섹션"]);
+  const detail = gitignoreStatus && gitignoreDetail(gitignoreStatus);
+  if (detail) entries.gitignore.push(["remove", "gitignore", detail]);
+  for (const k of logOrder) done.push(...entries[k]);
+  logRemovals(targetRoot, done);
+  return { readme, gitignore };
+}

package/src/core/types.js

@@ -1,3 +1,5 @@
+import { flutterHooks } from "./flutter-hooks.js";
+
 // 프로젝트 타입 레지스트리 — 타입별 지식(감지 마커, 감지 순서, 버전·빌드 번호 파일)을 한 곳에 둔다.
 // 타입 목록·마커 맵·감지 체인은 모두 이 표에서 만들어지므로, 새 타입은 여기에 한 줄을 더하는 것에서 시작한다.
 // (릴리스 시점의 버전 파일 쓰기는 payload/scripts/version_manager.py가 따로 담당한다.)
@@ -13,6 +15,26 @@
 //   versionSources     설치 시 버전을 읽을 파일 키(detect.js의 sources) — 주 타입일 때 이 순서로 먼저 읽는다.
 //   buildNumberSource  모바일 빌드 번호를 읽을 파일 키(detect.js의 detectBuildNumberFromFiles).
 //   singleServerCd     배포 방식 변형 없이 서버 배포 CD가 하나뿐일 때 그 워크플로우 파일명.
+//   hooks              타입 전용 동작. 없는 훅은 "할 일 없음"이라 공통 코드는 hooksFor()로 있는 것만 호출한다.
+//     workflowFilter(context)                         타입 루트 워크플로우 파일 필터(filename → bool) 또는 null
+//     cleanupWorkflows(dir, installed, context, baseline, opts)
+//                                                     선택에서 빠진 워크플로우 정리 → { removed, backedUp }
+//     planAppFiles / copyAppFiles(context, payloadRoot, targetRoot)
+//                                                     사용자 소유 앱 파일(없을 때만 생성) 계획/복사 → { created, kept }
+//     appFilesTag                                     앱 파일 복사 로그의 분류 이름
+//     statusLabels(options)                           status 옵션 줄에 덧붙일 문자열
+//     doctorChecks(cwd, existing, { docs })           doctor 진단 행 배열
+//     resolveOptions({ opts, existing, workflowsDir }) CLI 옵션 → 저장값 → 기본값 순으로 확정한 타입 옵션 객체
+//                                                     (workflowsDir는 설치된 워크플로우로 추론할 때만 넘긴다)
+//     contextDefaults                                 createContext의 미결정 기본 필드
+//     contextFields(options) / optionsFromContext(context)
+//                                                     옵션 객체 ↔ 설치 컨텍스트 필드 변환
+//     versionOptionsBlock(options)                    version.yml options 아래에 덧붙일 블록(6칸 들여쓰기)
+//     savedOptionKeys                                 version.yml 저장 키 → parseExisting 옵션 필드
+//     cliFlags[{ flag, field, initial, parse(v) }]    타입 전용 CLI 플래그(파싱 결과 opts[field]에 담긴다)
+//     installNotices(options)                         설치 직후 알릴 경고 배열(빈 값은 무시)
+//     logChoices(context)                             설치 로그에 남길 선택값 [이름, 값] 배열
+// (타입 전용 대화형 질문 흐름은 아직 interactive.js에 남아 있다.)
 export const TYPES = [
   {
     id: "spring",
@@ -26,6 +48,7 @@ export const TYPES = [
     detectBy: "markers", detectOrder: 1,
     versionSources: ["pubspec"],
     buildNumberSource: "pubspec",
+    hooks: flutterHooks,
   },
   {
     id: "next",
@@ -91,6 +114,24 @@ const BY_ID = new Map(TYPES.map((t) => [t.id, t]));
 // 알 수 없는 타입은 undefined — 호출부가 각자의 기본값을 정한다.
 export const typeInfo = (id) => BY_ID.get(id);
 
+// types 중 훅 name을 가진 것만 [{ id, hook }]으로 — 주어진 타입 순서를 유지한다.
+export function hooksFor(types, name) {
+  const found = [];
+  for (const id of types) {
+    const hook = BY_ID.get(id)?.hooks?.[name];
+    if (hook !== undefined) found.push({ id, hook });
+  }
+  return found;
+}
+
+// types 중 훅 name을 가진 타입들의 반환값(객체)을 하나로 합친다 — 옵션·컨텍스트 필드처럼 타입마다 다른 키를 낼 때 쓴다.
+export function mergeHookResults(types, name, ...args) {
+  return Object.assign({}, ...hooksFor(types, name).map(({ hook }) => hook(...args)));
+}
+
+// 모든 타입이 선언한 훅 상수(contextDefaults·savedOptionKeys 등)를 하나로 합친다 — 타입이 정해지기 전에 필요한 기본 형태용.
+export const allHookValues = (name) => Object.assign({}, ...TYPES.map((t) => t.hooks?.[name]));
+
 // 표시 순서 그대로의 타입 이름 목록
 // VALID_TYPES·ALL_TYPES가 같은 배열을 공유하므로 한쪽에서 바꿔 다른 쪽이 오염되지 않게 고정한다.
 export const TYPE_IDS = Object.freeze(TYPES.map((t) => t.id));

package/src/core/version-yml.js

@@ -1,8 +1,6 @@
 import { DEFAULT_DEPLOY_STYLE } from "./deploy-style.js";
 import { escapeYamlDoubleQuoted } from "./wizard-env.js";
-import {
-  ENV_MODES, DEPLOY_MODES, DEFAULT_ENV_MODE, DEFAULT_DEPLOY_MODE, STORE_PLATFORMS, formatStoreList,
-} from "./flutter-options.js";
+import { hooksFor, mergeHookResults, allHookValues } from "./types.js";
 
 // version.yml 파싱·생성 (전체 재생성 전략).
 // ⚠️ YAML 재직렬화 금지 — 주석이 데이터.
@@ -37,20 +35,18 @@ export function parseExtraTopLevel(content) {
   return blocks;
 }
 
-// Flutter 옵션 키 → 반환 필드. 값은 원문 문자열로 돌려주고, 유효성 판정은 resolveFlutterOptions 몫이다.
-const FLUTTER_OPTION_KEYS = {
-  env_mode: "envMode", flutter_store: "flutterStore",
-  android_deploy_mode: "androidDeployMode", ios_deploy_mode: "iosDeployMode",
-};
+// 타입 전용 옵션 키 → 반환 필드(타입 훅 savedOptionKeys). 값은 원문 문자열로 돌려주고, 유효성 판정은 타입 훅의 resolveOptions 몫이다.
+const TYPE_OPTION_KEYS = allHookValues("savedOptionKeys");
+const TYPE_OPTION_LINE = new RegExp(`^\\s+(${Object.keys(TYPE_OPTION_KEYS).join("|")}):\\s*(.+)`);
 
 // metadata.template.options 상태머신 파싱.
 // 반환: { semverAuto: bool|null, copilotAi: bool|null, deployStyle: string|null,
-//         envMode/flutterStore/androidDeployMode/iosDeployMode: string|null } — null=미기재.
+//         타입 전용 옵션 필드(예: envMode/flutterStore/androidDeployMode/iosDeployMode): string|null } — null=미기재.
 // 구 synology·coderabbit 키 등 다른 키는 어느 분기에도 안 걸려 자연히 무시된다(파싱 에러 없음).
 export function parseTemplateOptions(content) {
   const out = {
     semverAuto: null, copilotAi: null, deployStyle: null,
-    envMode: null, flutterStore: null, androidDeployMode: null, iosDeployMode: null,
+    ...Object.fromEntries(Object.values(TYPE_OPTION_KEYS).map((field) => [field, null])),
   };
   // 값 정규화: 따옴표 제거 + 트림
   // 인라인 주석(` # ...`)을 먼저 떼고 따옴표·공백을 정리한다. 문자열 값을 받는 키(deploy_style)는
@@ -64,8 +60,8 @@ export function parseTemplateOptions(content) {
     if (inTemplate && inOptions) {
       let m = line.match(/^\s+deploy_style:\s*(.+)/);
       if (m) { const v = strip(m[1]); if (v) out.deployStyle = v; continue; }
-      m = line.match(/^\s+(env_mode|flutter_store|android_deploy_mode|ios_deploy_mode):\s*(.+)/);
-      if (m) { const v = strip(m[2]); if (v) out[FLUTTER_OPTION_KEYS[m[1]]] = v; continue; }
+      m = line.match(TYPE_OPTION_LINE);
+      if (m) { const v = strip(m[2]); if (v) out[TYPE_OPTION_KEYS[m[1]]] = v; continue; }
       m = line.match(/^\s+semver_auto:\s*(.+)/);
       if (m) {
         const v = strip(m[1]);
@@ -187,24 +183,11 @@ export function parseTemplateBranches(content) {
   return out.main && out.develop && out.mode ? out : null;
 }
 
-// Flutter 옵션 블록 (전체 줄 토큰 {{FLUTTER_OPTIONS}} — Flutter 타입일 때만). options 아래 6칸 들여쓰기.
-// 값이 비었으면 워크플로우 템플릿의 기본값과 같은 값으로 채운다 — 저장값과 실제 설치 내용이 어긋나지 않게.
-// stores가 null(미결정)이면 현행 동작대로 둘 다 설치되므로 "android,ios"로 기록한다.
-function buildFlutterOptionsBlock({ envMode, stores, androidDeployMode, iosDeployMode } = {}) {
-  const quote = (v) => `"${escapeYamlDoubleQuoted(v)}"`;
-  return [
-    `      env_mode: ${quote(envMode || DEFAULT_ENV_MODE)} # ${ENV_MODES.join(" | ")} (Flutter 환경변수 주입 방식)`,
-    `      flutter_store: ${quote(formatStoreList(stores ?? STORE_PLATFORMS))} # android | ios | android,ios | none (스토어 배포 대상)`,
-    `      android_deploy_mode: ${quote(androidDeployMode || DEFAULT_DEPLOY_MODE)} # ${DEPLOY_MODES.join(" | ")} (Play Store 배포 모드)`,
-    `      ios_deploy_mode: ${quote(iosDeployMode || DEFAULT_DEPLOY_MODE)} # ${DEPLOY_MODES.join(" | ")} (iOS 배포 모드)`,
-  ].join("\n");
-}
-
 // version.yml 전체 생성 — payload/version.yml.template 렌더링.
 // opts: { templateText, version, types:[], paths:Map, pathMarkers?:Map,
 //         branch, branches?, versionCode, now, today, templateOptions?, deployValues?,
 //         extraTopLevel?:string[],  ← 기존 version.yml의 알려지지 않은 최상위 필드 보존
-//         flutterOptions?:{ envMode, stores, androidDeployMode, iosDeployMode } }  ← Flutter 타입일 때만 렌더
+//         typeOptions?:object }  ← 타입 훅(versionOptionsBlock)이 해당 타입일 때만 렌더하는 옵션 블록의 입력
 //   templateText = payload/version.yml.template 원문 (readVersionYmlTemplate — 필수)
 //   now   = "YYYY-MM-DD HH:MM:SS" (UTC) — 결정성 위해 주입 / today = "YYYY-MM-DD"
 //   branches = { main, develop, mode } (resolveBranchConfig 결과. 없으면 branch 기반 기본값)
@@ -213,7 +196,7 @@ function buildFlutterOptionsBlock({ envMode, stores, androidDeployMode, iosDeplo
 export function buildVersionYml({
   templateText, version, types = [], paths = new Map(), pathMarkers = new Map(),
   branch = "main", branches = null, versionCode = 1, now, today,
-  templateOptions = null, deployValues = new Map(), extraTopLevel = [], flutterOptions = {},
+  templateOptions = null, deployValues = new Map(), extraTopLevel = [], typeOptions = {},
 }) {
   if (!templateText) throw new Error("version.yml.template 원문이 필요합니다 (payload/version.yml.template 누락?)");
   const typesJson = types.length ? `[${types.map((t) => `"${t}"`).join(", ")}]` : `["basic"]`;
@@ -249,8 +232,8 @@ export function buildVersionYml({
     deployBlock = rows.join("\n");
   }
 
-  // Flutter 옵션 블록 (full-line 토큰 {{FLUTTER_OPTIONS}} — Flutter 타입일 때만, 아니면 줄 제거)
-  const flutterBlock = types.includes("flutter") ? buildFlutterOptionsBlock(flutterOptions) : "";
+  // 타입 옵션 블록 (full-line 토큰 {{TYPE_OPTIONS}} — 블록을 내는 타입이 있을 때만, 아니면 줄 제거)
+  const typeOptionsBlock = hooksFor(types, "versionOptionsBlock").map(({ hook }) => hook(typeOptions)).join("\n");
 
   const scalars = {
     VERSION: version, VERSION_CODE: String(versionCode),
@@ -267,7 +250,7 @@ export function buildVersionYml({
   for (const line of String(templateText).split("\n")) {
     const t = line.trim();
     if (t === "{{PROJECT_PATHS}}") { if (pathsBlock) out.push(pathsBlock); continue; }
-    if (t === "{{FLUTTER_OPTIONS}}") { if (flutterBlock) out.push(flutterBlock); continue; }
+    if (t === "{{TYPE_OPTIONS}}") { if (typeOptionsBlock) out.push(typeOptionsBlock); continue; }
     if (t === "{{DEPLOY}}") { if (deployBlock) out.push(deployBlock); continue; }
     if (t.startsWith("deploy_style:") && deployStyle === null) continue; // 서버 배포가 없는 타입은 기록하지 않는다
     out.push(line.replace(/\{\{([A-Z][A-Z0-9_]*)\}\}/g, (_, name) => {
@@ -298,12 +281,11 @@ export function sameIgnoringTimestamps(a, b) {
 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,
-    includeSemverAuto, includeCopilotAi, deployStyle,
-    envMode, flutterStore, androidDeployMode, iosDeployMode } = context;
+    includeSemverAuto, includeCopilotAi, deployStyle } = context;
   return buildVersionYml({
     templateText, version, types, paths, pathMarkers, branch, branches, versionCode, now, today,
     deployValues, extraTopLevel,
-    flutterOptions: { envMode, stores: flutterStore, androidDeployMode, iosDeployMode },
+    typeOptions: mergeHookResults(types, "optionsFromContext", context),
     templateOptions: {
       templateVersion,
       includeSemverAuto: includeSemverAuto !== false,

package/src/index.js

@@ -6,15 +6,13 @@ import { join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { readFileSync, existsSync } from "node:fs";
 import { createInterface } from "node:readline/promises";
-import { parseArgs, parsePathsCsv, CliError } from "./cli/args.js";
+import { parseArgs, parsePathsCsv, CliError, TYPE_CLI_FLAGS } from "./cli/args.js";
 import { HELP_TEXT } from "./cli/help.js";
-import { createContext } from "./context.js";
-import { DEFAULT_DEPLOY_STYLE, isDeployStyle, hasServerDeployWorkflows, fallbackStyleTypes, effectiveDeployStyle } from "./core/deploy-style.js";
-import { resolveFlutterOptions } from "./core/flutter-options.js";
-import { inferInstalledStores } from "./core/installed-stores.js";
+import { fallbackStyleTypes } from "./core/deploy-style.js";
+import { hooksFor, mergeHookResults } from "./core/types.js";
 import { PATHS } from "./core/paths.js";
 import { resolvePayloadRoot, assertPayload, readTemplateVersion } from "./core/assets.js";
-import { detectTypes, detectVersion, detectDefaultBranch, detectRepoName, makeResolvers, detectBuildNumber, detectMarkers } from "./core/detect-fs.js";
+import { detectTypes, detectDefaultBranch, detectRepoName, makeResolvers, detectMarkers } from "./core/detect-fs.js";
 import { parseExisting } from "./core/version-yml.js";
 import { resolveReleaseOptions } from "./core/release-options.js";
 import { runBreakingCheck } from "./core/breaking-check.js";
@@ -29,6 +27,7 @@ import { runUninstall, runUninstallFlow } from "./commands/uninstall.js";
 import * as prompts from "./ui/prompts.js";
 import { isPromptAbort } from "./ui/readline-engine.js";
 import { runInteractive } from "./commands/interactive.js";
+import { resolveDeployStyle, resolveVersion, resolveVersionCode, buildInstallContext } from "./commands/install-settings.js";
 import { initLogger, closeLogger, currentLogPath, hasLegacyMdLogs, log } from "./core/logger.js";
 import { runStatus, printStatus } from "./commands/status.js";
 import { runDoctor, printDoctorReport } from "./commands/doctor.js";
@@ -108,8 +107,7 @@ async function runInner(argv, {
     const ignored = [
       [opts.types.length, "--type"], [opts.version, "--project-version"], [opts.pathsCsv, "--paths"],
       [opts.mainBranch, "--main-branch"], [opts.developBranch, "--develop-branch"], [opts.deployStyle, "--deploy-style"],
-      [opts.flutterEnvMode, "--flutter-env-mode"], [opts.flutterStore, "--flutter-store"],
-      [opts.androidDeployMode, "--android-deploy-mode"], [opts.iosDeployMode, "--ios-deploy-mode"],
+      ...TYPE_CLI_FLAGS.map((f) => [opts[f.field], f.flag]),
     ].filter(([v]) => v).map(([, flag]) => flag);
     if (ignored.length) {
       console.error(`⚠️  대화형 모드에서는 ${ignored.join(", ")}를 사용하지 않습니다 — 질문에서 고르거나 --mode full --force와 함께 쓰세요.`);
@@ -286,9 +284,11 @@ async function runInner(argv, {
   // version: 기존 version.yml 최우선(SSoT — 재실행 시 덮어쓰기 방지) → CLI 지정 → 파일 감지
   // 비대화형이므로 폴백 안내는 CLI 문구(--project-version)를 그대로 쓴다.
   // 경로 확정 뒤에 감지해야 모노레포 하위 폴더의 버전·빌드 번호를 읽는다.
-  const version = (existing?.version) || opts.version
-    || detectVersion(cwd, { types, paths, warn: (m) => { detectWarnings.push(m); console.error(m); } });
-  const versionCode = existing?.versionCode ?? detectBuildNumber(cwd, { types, paths }) ?? 1; // 기존 빌드번호 보존, 신규 통합 시 프로젝트 파일에서 감지
+  const version = resolveVersion({
+    cwd, existing, explicit: opts.version,
+    types, paths, warn: (m) => { detectWarnings.push(m); console.error(m); },
+  });
+  const versionCode = resolveVersionCode({ cwd, existing, types, paths });
 
   // 브랜치 구성 (--main-branch/--develop-branch → version.yml 저장값 → 감지 default → main/develop)
   // 이전 버전이 저장한 감지 실패 값("(unknown)" 등)은 저장값으로 인정하지 않는다 — 그대로 두면 재실행해도 복구되지 않는다.
@@ -315,53 +315,36 @@ async function runInner(argv, {
     }
   }
 
-  // Flutter 옵션 — CLI 플래그 → version.yml 저장값 → 기본값(신규 dart-define, 기존 설치 dotenv 보존).
-  // Flutter 타입이 없는 프로젝트에서는 렌더·치환 단계가 전부 무시한다.
-  // 스토어 저장값이 없는 기존 Flutter 설치는 설치돼 있는 스토어 워크플로우로 추론한다(대화형과 같은 결론).
-  // 추론하지 않으면 미결정이 "둘 다"로 확정 저장되어, 지웠던 플랫폼의 워크플로우·fastlane 파일이 되살아난다.
-  const workflowsDir = join(cwd, PATHS.workflowsDir);
-  const inferredStores = opts.flutterStore == null && existing?.types?.includes("flutter")
-    && existing.options?.flutterStore == null && existsSync(workflowsDir)
-    ? inferInstalledStores(workflowsDir) : null;
-  const flutterOptions = resolveFlutterOptions({
-    cli: {
-      envMode: opts.flutterEnvMode, stores: opts.flutterStore ?? inferredStores,
-      androidDeployMode: opts.androidDeployMode, iosDeployMode: opts.iosDeployMode,
-    },
-    existing,
+  // 타입 전용 옵션 — CLI 플래그 → version.yml 저장값 → 기본값을 타입 훅이 정한다. 해당 타입이 없으면 비어 있다.
+  // (Flutter는 저장값이 없는 기존 설치의 스토어를 설치된 워크플로우로 추론한다 — 대화형과 같은 결론.)
+  const typeOptions = mergeHookResults(types, "resolveOptions", {
+    opts, existing, workflowsDir: join(cwd, PATHS.workflowsDir),
   });
 
-  const context = createContext({
-    mode: opts.mode, force: opts.force, types, version, versionCode, branch,
+  // 고른 배포 방식 — 플래그 → 저장값 → 기본값. 실제 설치되는 방식으로의 정리는 컨텍스트 조립에서 한다.
+  const chosenDeployStyle = resolveDeployStyle({ payload, types, explicit: opts.deployStyle, existing });
+
+  const context = buildInstallContext({
+    payload, existing, templateVersion: readTemplateVersion(), types, deployStyle: chosenDeployStyle,
+    typeOptions,
+    // 옵션: CLI 플래그 최우선 → version.yml 저장 옵션 → 기본값 (대화형과 같은 규칙)
+    releaseOptions: resolveReleaseOptions({ semverAuto: opts.includeSemverAuto, copilotAi: opts.includeCopilotAi }, existing),
+    mode: opts.mode, force: opts.force, version, versionCode, branch,
     branches,
     paths,
-    // 옵션: CLI 플래그 최우선 → version.yml 저장 옵션 → 기본값 (대화형과 같은 규칙)
-    ...resolveReleaseOptions({ semverAuto: opts.includeSemverAuto, copilotAi: opts.includeCopilotAi }, existing),
     repoName,
     // @wizard ask/auto 토큰 값을 계산하는 resolver
-    resolvers: makeResolvers(cwd, repoName, paths, flutterOptions),
+    resolvers: makeResolvers(cwd, repoName, paths, typeOptions),
     now, today,
     // 설치 로그용 부가 문맥 — 설치 동작 자체는 바꾸지 않는다.
     markers: detectMarkers(cwd, types), detectWarnings,
-    // 서버 배포 워크플로우가 없는 타입은 배포 방식이 설치에 영향이 없으므로 기록하지 않는다(null).
-    deployStyle: !hasServerDeployWorkflows(payload, types) ? null : opts.deployStyle
-      || (isDeployStyle(existing?.options?.deployStyle) ? existing.options.deployStyle : DEFAULT_DEPLOY_STYLE),
-    previousTemplateVersion: existing?.templateVersion || "",
-    envMode: flutterOptions.envMode,
-    flutterStore: flutterOptions.stores,
-    androidDeployMode: flutterOptions.androidDeployMode,
-    iosDeployMode: flutterOptions.iosDeployMode,
   });
 
-  context.templateVersion = readTemplateVersion();
-
   // 무중단(nginx·traefik) 워크플로우가 없는 타입은 단일 서버 배포로 설치한다 — 조용히 넘어가지 않게 알린다.
-  const fallbackTypes = fallbackStyleTypes(payload, types, context.deployStyle);
+  const fallbackTypes = fallbackStyleTypes(payload, types, chosenDeployStyle);
   if (fallbackTypes.length) {
-    console.error(`⚠️  ${fallbackTypes.join(", ")}에는 ${context.deployStyle} 무중단 배포 워크플로우가 없어 단일 서버 배포(simple)로 설치합니다.`);
+    console.error(`⚠️  ${fallbackTypes.join(", ")}에는 ${chosenDeployStyle} 무중단 배포 워크플로우가 없어 단일 서버 배포(simple)로 설치합니다.`);
   }
-  // 안내는 고른 값으로 하되, 기록은 실제로 설치되는 방식으로 한다.
-  context.deployStyle = effectiveDeployStyle(payload, types, context.deployStyle);
 
   // 비대화형 축약 배너 (1줄, 로그 오염 최소)
   printBannerCompact({ version: context.templateVersion, mode: opts.mode });
@@ -400,18 +383,11 @@ async function runInner(argv, {
   });
   for (const n of postInstallNotices(result)) console.error(n.startsWith(" ") ? n : `⚠️  ${n}`);
   // store_submit 배포 모드는 main push마다 심사를 자동 제출한다 — 비대화형에서도 같은 경고를 보여준다
-  // (대화형 경로는 ui/prompts.js#deployModeWarning을 선택 시점에 note로 보여준다).
-  // Flutter 타입이 아니거나 해당 스토어를 선택하지 않은 프로젝트에는 뜨면 안 된다.
-  const { stores } = flutterOptions;
-  const warnings = [];
-  if (types.includes("flutter") && (stores === null || stores.includes("android"))) {
-    warnings.push(prompts.deployModeWarning(flutterOptions.androidDeployMode));
-  }
-  if (types.includes("flutter") && (stores === null || stores.includes("ios"))) {
-    warnings.push(prompts.deployModeWarning(flutterOptions.iosDeployMode));
-  }
-  for (const w of warnings) {
-    if (w) console.error(`⚠️  ${w}`);
+  // (대화형 경로는 ui/prompts.js#deployModeWarning을 선택 시점에 note로 보여준다). 타입 훅이 해당 타입에만 낸다.
+  for (const { hook } of hooksFor(types, "installNotices")) {
+    for (const w of hook(typeOptions)) {
+      if (w) console.error(`⚠️  ${w}`);
+    }
   }
   return 0;
 }

package/src/ui/prompts.js

@@ -5,7 +5,7 @@
 import * as engine from "./readline-engine.js";
 import { DEPLOY_STYLES, NO_DEPLOY_STYLE } from "../core/deploy-style.js";
 import { TYPE_IDS } from "../core/types.js";
-import { ENV_MODES, DEFAULT_ENV_MODE, STORE_PLATFORMS, DEPLOY_MODES, DEFAULT_DEPLOY_MODE } from "../core/flutter-options.js";
+import { ENV_MODES, DEFAULT_ENV_MODE, STORE_PLATFORMS, DEPLOY_MODES, DEFAULT_DEPLOY_MODE, deployModeWarning } from "../core/flutter-options.js";
 
 export const CANCEL = engine.CANCEL;
 
@@ -188,10 +188,8 @@ export async function selectDeployMode({ platform, initialValue = DEFAULT_DEPLOY
   });
 }
 
-// store_submit은 main push마다 심사를 제출하므로 고른 직후 한 줄로 알린다. 호출부(interactive)가 note로 출력한다.
-export function deployModeWarning(mode) {
-  return mode === "store_submit" ? "store_submit을 고르면 main push마다 심사가 자동 제출됩니다." : "";
-}
+// store_submit 경고 문구 — 정의는 core에 있고, 호출부(interactive)가 note로 출력한다.
+export { deployModeWarning };
 
 // 브랜치 전략 선택. 종전에는 "릴리스 브랜치"/"개발 브랜치" 두 질문에
 // 같은 이름을 입력해야만 trunk-based가 됐는데, 그 규칙이 사전에 안내되지 않아