project-auto-wizard 0.13.1 → 0.13.2

package/README.md

@@ -21,7 +21,7 @@ Everything it installs is plain GitHub Actions in your own repository. No API ke
 </div>
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## Latest Version : v0.13.1 (2026-09-30)
+## Latest Version : v0.13.2 (2026-09-30)
 
 [Full release history](CHANGELOG.md)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-auto-wizard",
-  "version": "0.13.1",
+  "version": "0.13.2",
   "description": "One command DevOps: npx wizard that installs GitHub-native Release Automation (optional GitHub Copilot AI summaries) into any project",
   "license": "MIT",
   "type": "module",

package/payload/version.yml.template

@@ -53,5 +53,5 @@ metadata:
       semver_auto: {{OPT_SEMVER_AUTO}}
       copilot_ai: {{OPT_COPILOT_AI}}
       deploy_style: "{{OPT_DEPLOY_STYLE}}" # simple | nginx | traefik | none (서버 배포 워크플로우)
-{{FLUTTER_OPTIONS}}
+{{TYPE_OPTIONS}}
 {{DEPLOY}}

package/src/cli/args.js

@@ -2,15 +2,17 @@
 import { VALID_TYPES, VALID_MODES } from "../context.js";
 import { DEPLOY_STYLES, isDeployStyle, NO_DEPLOY_STYLE } from "../core/deploy-style.js";
 import { isValidBranchName } from "../core/branches.js";
-import {
-  ENV_MODES, DEPLOY_MODES, STORE_PLATFORMS, NO_STORE, isEnvMode, isDeployMode, parseStoreList,
-} from "../core/flutter-options.js";
+import { TYPES } from "../core/types.js";
 import { CliError } from "../core/errors.js";
 import { normalizePath, isRepoRelativePath } from "../core/paths.js";
 
 // 기존 import 경로(cli/args.js) 호환 — 정의는 core에 있다.
 export { CliError, normalizePath, isRepoRelativePath };
 
+// 타입 전용 CLI 플래그(타입 훅 cliFlags) — 플래그 이름 → { field, initial, parse }. 훅은 타입 표 순서대로 모은다.
+export const TYPE_CLI_FLAGS = TYPES.flatMap((t) => t.hooks?.cliFlags ?? []);
+const TYPE_CLI_FLAG_BY_NAME = new Map(TYPE_CLI_FLAGS.map((f) => [f.flag, f]));
+
 // argv(process.argv.slice(2)) → 파싱 결과. 오류 시 throw(호출부에서 exit 1).
 export function parseArgs(argv) {
   const result = {
@@ -24,10 +26,8 @@ export function parseArgs(argv) {
     mainBranch: "",          // 릴리스 브랜치 (--main-branch). 빈값=감지된 default branch
     developBranch: "",       // 개발 브랜치 (--develop-branch). 빈값=develop
     deployStyle: "",         // 서버 배포 방식 (--deploy-style). 빈값=version.yml 저장값 → simple
-    flutterEnvMode: "",      // Flutter 환경변수 방식 (--flutter-env-mode). 빈값=저장값 → 신규 dart-define/기존 dotenv
-    flutterStore: null,      // Flutter 스토어 배포 대상 string[] (--flutter-store). null=미지정, none → []
-    androidDeployMode: "",   // Play Store 배포 모드 (--android-deploy-mode). 빈값=저장값 → store_only
-    iosDeployMode: "",       // iOS 배포 모드 (--ios-deploy-mode). 빈값=저장값 → store_only
+    // 타입 전용 플래그 필드(예: Flutter 환경변수 방식·스토어 대상·배포 모드) — 미지정 값은 타입 훅이 정한다.
+    ...Object.fromEntries(TYPE_CLI_FLAGS.map((f) => [f.field, f.initial])),
     force: false,
     help: false,
     showVersion: false,      // -v/--version → 패키지 버전 출력 (npm 관례)
@@ -49,6 +49,8 @@ export function parseArgs(argv) {
   const seenFlags = new Set(); // --semver-auto/--copilot류 상호 모순 플래그 검증용
   while (args.length > 0) {
     const a = args.shift();
+    const typeFlag = TYPE_CLI_FLAG_BY_NAME.get(a);
+    if (typeFlag) { result[typeFlag.field] = typeFlag.parse(args.shift()); continue; }
     switch (a) {
       case "-m": case "--mode":
         result.mode = args.shift() ?? ""; break;
@@ -103,36 +105,6 @@ export function parseArgs(argv) {
         }
         result.deployStyle = v; break;
       }
-      case "--flutter-env-mode": {
-        const v = args.shift();
-        if (!isEnvMode(v)) {
-          throw new CliError(`--flutter-env-mode 값이 올바르지 않습니다: ${v ?? "(없음)"} (${ENV_MODES.join(" | ")})`);
-        }
-        result.flutterEnvMode = v; break;
-      }
-      case "--flutter-store": {
-        const v = args.shift();
-        // 빈 문자열은 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(" | ")})`);
-        }
-        result.flutterStore = stores; break;
-      }
-      case "--android-deploy-mode": {
-        const v = args.shift();
-        if (!isDeployMode(v)) {
-          throw new CliError(`--android-deploy-mode 값이 올바르지 않습니다: ${v ?? "(없음)"} (${DEPLOY_MODES.join(" | ")})`);
-        }
-        result.androidDeployMode = v; break;
-      }
-      case "--ios-deploy-mode": {
-        const v = args.shift();
-        if (!isDeployMode(v)) {
-          throw new CliError(`--ios-deploy-mode 값이 올바르지 않습니다: ${v ?? "(없음)"} (${DEPLOY_MODES.join(" | ")})`);
-        }
-        result.iosDeployMode = v; break;
-      }
       case "--semver-auto":
         if (seenFlags.has("--no-semver-auto")) throw new CliError("--semver-auto와 --no-semver-auto는 동시에 지정할 수 없습니다");
         seenFlags.add("--semver-auto"); result.includeSemverAuto = true; break;

package/src/commands/full.js

@@ -198,16 +198,14 @@ export function cleanupWorkflows(context, payloadRoot, targetRoot, baseline, { j
   return { cleanup, storeCleanup, staleCleanup };
 }
 
-// 설치 결과를 가른 선택(배포 방식·자동 승격·Copilot·Flutter 옵션)을 남긴다 — 대화형에서 고른 값도
+// 설치 결과를 가른 선택(배포 방식·자동 승격·Copilot·타입 전용 옵션)을 남긴다 — 대화형에서 고른 값도
 // 여기로 모이므로, 나중에 "왜 이렇게 설치됐나"를 로그만으로 따라갈 수 있다.
 function logChoices(context, types) {
   if (context.deployStyle) log.info("option", "deploy", context.deployStyle);
   if (context.includeSemverAuto != null) log.info("option", "semver", context.includeSemverAuto ? "on" : "off");
   if (context.includeCopilotAi != null) log.info("option", "copilot", context.includeCopilotAi ? "on" : "off");
-  if (types.includes("flutter")) {
-    const stores = Array.isArray(context.flutterStore) ? (context.flutterStore.join(",") || "없음") : "미결정(둘 다)";
-    log.info("option", "flutter",
-      `env=${context.envMode || "-"} stores=${stores} android=${context.androidDeployMode || "-"} ios=${context.iosDeployMode || "-"}`);
+  for (const { hook } of hooksFor(types, "logChoices")) {
+    for (const [name, value] of hook(context)) log.info("option", name, value);
   }
 }
 

package/src/commands/install-settings.js

@@ -3,6 +3,7 @@
 // 설치 컨텍스트로 조립하는 규칙은 한 곳에 둬야 한쪽만 고쳐 두 모드의 결과가 갈라지지 않는다.
 import { detectVersion, detectBuildNumber } from "../core/detect-fs.js";
 import { createContext } from "../context.js";
+import { mergeHookResults } from "../core/types.js";
 import { isDeployStyle, DEFAULT_DEPLOY_STYLE, hasServerDeployWorkflows, effectiveDeployStyle } from "../core/deploy-style.js";
 
 // version.yml에 저장된 배포 방식 — 없거나 알 수 없는 값이면 "".
@@ -29,21 +30,18 @@ export function resolveVersionCode({ cwd, existing, types, paths }) {
 
 // 확정된 값들을 설치 컨텍스트로 조립한다.
 //   deployStyle: resolveDeployStyle 결과(고른 값). 실제 설치되는 방식으로 바꿔 기록한다.
-//   flutterOptions: { envMode, stores, androidDeployMode, iosDeployMode } — 두 경로 모두 확정된 값.
+//   typeOptions: 타입 훅(resolveOptions)이 확정한 타입 전용 옵션 — 두 경로 모두 확정된 값. 컨텍스트 필드로의 변환도 타입 훅이 한다.
 //   releaseOptions: { includeSemverAuto, includeCopilotAi } — resolveReleaseOptions 결과.
 //   extra: 경로별로만 쓰는 필드(envValues 등).
 export function buildInstallContext({
-  payload, existing, templateVersion, types, deployStyle, flutterOptions, releaseOptions, ...rest
+  payload, existing, templateVersion, types, deployStyle, typeOptions, releaseOptions, ...rest
 }) {
   return createContext({
     types,
     ...releaseOptions,
     // 안내는 고른 값으로 하되, 기록은 실제로 설치되는 방식으로 한다.
     deployStyle: effectiveDeployStyle(payload, types, deployStyle),
-    envMode: flutterOptions.envMode,
-    flutterStore: flutterOptions.stores,
-    androidDeployMode: flutterOptions.androidDeployMode,
-    iosDeployMode: flutterOptions.iosDeployMode,
+    ...mergeHookResults(types, "contextFields", typeOptions),
     previousTemplateVersion: existing?.templateVersion || "",
     templateVersion,
     ...rest,

package/src/commands/interactive.js

@@ -317,7 +317,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     payload, existing, templateVersion, types,
     // 저장값이 무중단이어도 선택한 타입에 그 방식이 없으면 단일 서버 배포가 설치된다 — 설치된 방식을 기록한다.
     deployStyle: resolveDeployStyle({ payload, types, explicit: deployStyle, existing }),
-    flutterOptions,
+    typeOptions: flutterOptions,
     releaseOptions: { includeSemverAuto, includeCopilotAi },
     mode, force: true, version, versionCode, branch, branches, paths,
     repoName, resolvers, envValues, envUseDefaults, now, today,

package/src/commands/status.js

@@ -5,11 +5,10 @@ import { parseExisting } from "../core/version-yml.js";
 import { planWorkflows } from "../core/copy/workflows.js";
 import { makeResolvers, detectRepoName, detectDefaultBranch } from "../core/detect-fs.js";
 import { PATHS } from "../core/paths.js";
-import { resolveFlutterOptions } from "../core/flutter-options.js";
 import { isDeployStyle, DEFAULT_DEPLOY_STYLE } from "../core/deploy-style.js";
 import { findStaleWorkflows } from "../core/removal-plan.js";
 import { readBaseline } from "../core/baseline.js";
-import { hooksFor } from "../core/types.js";
+import { hooksFor, mergeHookResults } from "../core/types.js";
 
 // payloadRoot: 패키지 payload/ 루트. targetRoot: 상태를 확인할 대상 레포.
 export function runStatus(payloadRoot, targetRoot = ".") {
@@ -20,10 +19,8 @@ export function runStatus(payloadRoot, targetRoot = ".") {
   const repoName = detectRepoName(targetRoot);
   // 설치 때 워크플로우에 치환된 환경변수 방식·배포 모드와 스토어 선택을 비교 기준에도 똑같이 적용한다 —
   // 그렇지 않으면 미수정 파일이 드리프트로, 선택 해제한 스토어 워크플로우가 "삭제함"으로 오탐된다.
-  const flutterOptions = resolveFlutterOptions({
-    cli: { envMode: "", stores: null, androidDeployMode: "", iosDeployMode: "" }, existing,
-  });
-  const resolvers = makeResolvers(targetRoot, repoName, existing.paths, flutterOptions);
+  const typeOptions = mergeHookResults(existing.types, "resolveOptions", { existing });
+  const resolvers = makeResolvers(targetRoot, repoName, existing.paths, typeOptions);
   // version.yml에 branches 블록이 없으면(신기능 이전 설치·수기 편집) makeSrcText(null)이
   // {{MAIN_BRANCH}}/{{DEVELOP_BRANCH}}를 치환하지 못해 모든 워크플로우가 드리프트로 오탐된다 —
   // 비교용 기본값으로 폴백(실제 저장값은 아니지만 드리프트 비교 목적에는 충분).
@@ -31,7 +28,7 @@ export function runStatus(payloadRoot, targetRoot = ".") {
   const context = {
     types: existing.types, paths: existing.paths,
     repoName, resolvers, branches: branchesForCompare,
-    flutterStore: flutterOptions.stores,
+    ...mergeHookResults(existing.types, "contextFields", typeOptions),
     // 설치 때 고른 배포 방식으로 비교해야 nginx·traefik CD 수정도 드리프트로 잡힌다.
     // 빠지면 기본값(simple)으로 걸러 설치된 무중단 CD가 비교 대상에서 사라진다.
     deployStyle: isDeployStyle(existing.options.deployStyle) ? existing.options.deployStyle : DEFAULT_DEPLOY_STYLE,

package/src/context.js

@@ -1,5 +1,5 @@
 // 마법사 전역 상태를 하나의 객체로 명시화
-import { TYPE_IDS } from "./core/types.js";
+import { TYPE_IDS, allHookValues } from "./core/types.js";
 
 // --type 화이트리스트 — 타입 레지스트리(core/types.js)의 표시 순서 그대로.
 export const VALID_TYPES = TYPE_IDS;
@@ -26,12 +26,8 @@ export function createContext(overrides = {}) {
     paths: new Map(),        // type -> path
     includeSemverAuto: null, // null=미설정(다운스트림에서 true로 해석), true/false=명시
     includeCopilotAi: null,  // null=미설정(다운스트림에서 false로 해석), true/false=명시 — Copilot AI 요약 opt-in
-    // Flutter 옵션 — Flutter 타입이 없는 프로젝트에서는 전부 무시된다.
-    // 결정은 src/core/flutter-options.js의 resolveFlutterOptions가 한다.
-    envMode: "",             // "dart-define" | "dotenv". ""=미결정 → 템플릿 기본값(dart-define)
-    flutterStore: null,      // 스토어 배포 대상 string[] (예: ["android","ios"]). null=미결정 → 둘 다(현행 동작)
-    androidDeployMode: "",   // store_only | store_prepare | store_submit. ""=미결정 → store_only
-    iosDeployMode: "",       // 위와 동일 (iOS)
+    // 타입 전용 옵션 필드 — 해당 타입이 없는 프로젝트에서는 전부 무시된다. 필드와 기본값은 타입 훅(contextDefaults)이 정한다.
+    ...allHookValues("contextDefaults"),
     templateVersion: "",
     deployValues: new Map(), // "type.KEY" -> value
     counters: {},

package/src/core/flutter-hooks.js

@@ -1,8 +1,16 @@
 // Flutter 타입 훅 — types.js 레지스트리의 flutter 항목이 가리키는 구현 모음.
 // 공통 코드는 flutter를 직접 알지 못하고 훅 이름으로만 호출한다(각 훅의 계약은 types.js 머리말 참고).
-import { storeWorkflowFilter, cleanupDeselectedStoreWorkflows } from "./flutter-options.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) {
@@ -14,7 +22,95 @@ function statusLabels(options) {
   ].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)이면 아무것도 지우지 않는다.

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/types.js

@@ -24,7 +24,17 @@ import { flutterHooks } from "./flutter-hooks.js";
 //     appFilesTag                                     앱 파일 복사 로그의 분류 이름
 //     statusLabels(options)                           status 옵션 줄에 덧붙일 문자열
 //     doctorChecks(cwd, existing, { docs })           doctor 진단 행 배열
-// (타입 전용 옵션 해석·CLI 플래그·version.yml 블록·대화형 질문은 아직 각 호출부에 남아 있다.)
+//     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",
@@ -114,6 +124,14 @@ export function hooksFor(types, name) {
   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,11 +6,10 @@ 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 { fallbackStyleTypes } from "./core/deploy-style.js";
-import { resolveFlutterOptions } from "./core/flutter-options.js";
-import { inferInstalledStores } from "./core/installed-stores.js";
+import { hooksFor, mergeHookResults } from "./core/types.js";
 import { PATHS } from "./core/paths.js";
 import { resolvePayloadRoot, assertPayload, readTemplateVersion } from "./core/assets.js";
 import { detectTypes, detectDefaultBranch, detectRepoName, makeResolvers, detectMarkers } from "./core/detect-fs.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와 함께 쓰세요.`);
@@ -317,20 +315,10 @@ 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),
   });
 
   // 고른 배포 방식 — 플래그 → 저장값 → 기본값. 실제 설치되는 방식으로의 정리는 컨텍스트 조립에서 한다.
@@ -338,7 +326,7 @@ async function runInner(argv, {
 
   const context = buildInstallContext({
     payload, existing, templateVersion: readTemplateVersion(), types, deployStyle: chosenDeployStyle,
-    flutterOptions,
+    typeOptions,
     // 옵션: CLI 플래그 최우선 → version.yml 저장 옵션 → 기본값 (대화형과 같은 규칙)
     releaseOptions: resolveReleaseOptions({ semverAuto: opts.includeSemverAuto, copilotAi: opts.includeCopilotAi }, existing),
     mode: opts.mode, force: opts.force, version, versionCode, branch,
@@ -346,7 +334,7 @@ async function runInner(argv, {
     paths,
     repoName,
     // @wizard ask/auto 토큰 값을 계산하는 resolver
-    resolvers: makeResolvers(cwd, repoName, paths, flutterOptions),
+    resolvers: makeResolvers(cwd, repoName, paths, typeOptions),
     now, today,
     // 설치 로그용 부가 문맥 — 설치 동작 자체는 바꾸지 않는다.
     markers: detectMarkers(cwd, types), detectWarnings,
@@ -395,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가 됐는데, 그 규칙이 사전에 안내되지 않아