project-auto-wizard 0.13.0 → 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.0 (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.0",
+  "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",
@@ -21,6 +21,8 @@
     "test": "npm run test:node && npm run test:py",
     "test:node": "node --test --test-concurrency=1",
     "test:py": "node scripts/run-py-tests.mjs",
+    "generate:workflows": "node scripts/generate-workflows.mjs",
+    "generate:workflows:check": "node scripts/generate-workflows.mjs --check",
     "sync:dogfood": "node scripts/sync-dogfood.mjs",
     "sync:dogfood:check": "node scripts/sync-dogfood.mjs --check"
   },

package/payload/scripts/version_manager.py

@@ -436,6 +436,64 @@ def sync_maven(path_dir, new_version):
 
 
 _GRADLE_VERSION_RE = re.compile(r"""^([ \t]*version[ \t]*=[ \t]*)(['"])([^'"\n]*)\2""", re.MULTILINE)
+_GRADLE_SHARED_BLOCKS = ("allprojects", "subprojects")
+
+
+def _gradle_code(line, quote=""):
+    """한 줄에서 주석을 떼고 따옴표 안 글자는 공백으로 바꾼다. url 'https://…'의 `//`나
+    문자열 속 중괄호가 블록 깊이 계산을 흐트러뜨리지 않게 한다. detect.js와 같은 규칙.
+
+    quote는 이 줄이 시작될 때 열려 있던 따옴표다. 삼중따옴표(\"\"\" ''')는 여러 줄에 걸치므로
+    (코드, 줄 끝에서 열려 있는 따옴표)를 돌려줘 다음 줄이 이어받게 한다. 한 줄짜리 따옴표는
+    줄 끝에서 닫힌 것으로 본다."""
+    out, i = [], 0
+    while i < len(line):
+        ch = line[i]
+        if quote:
+            if ch == "\\" and i + 1 < len(line):
+                out.append("  "); i += 2; continue
+            if line.startswith(quote, i):
+                out.append(quote); i += len(quote); quote = ""; continue
+            out.append(" ")
+        elif line.startswith(('"""', "'''"), i):
+            quote = line[i:i + 3]; out.append(quote); i += 3; continue
+        elif ch in "'\"":
+            quote = ch; out.append(ch)
+        elif line.startswith("//", i):
+            break
+        else:
+            out.append(ch)
+        i += 1
+    return "".join(out), quote if len(quote) == 3 else ""
+
+
+def _gradle_version_matches(text):
+    """프로젝트 버전 줄의 match 목록. 읽기와 동기화가 이 한 곳을 공유해 같은 줄만 다룬다.
+
+    들여쓰지 않은 `version =`이 있으면 그것만 쓴다. 없을 때만 allprojects/subprojects 블록 안의
+    들여쓴 줄을 인정한다 — `node { version = '20.11.0' }` 같은 플러그인 설정 블록을
+    프로젝트 버전으로 오인하면 버전이 뛰고 빌드 설정이 깨진다."""
+    top, shared = [], []
+    stack = []  # 열린 블록 이름. 줄 끝이 `{`로 끝나는 줄의 마지막 단어
+    quote = ""  # 여러 줄 문자열 안이면 그 따옴표. 문자열 속 줄은 코드가 아니다
+    pos = 0
+    for line in text.splitlines(keepends=True):
+        m = None if quote else _GRADLE_VERSION_RE.match(line)
+        if m:
+            m = _GRADLE_VERSION_RE.match(text, pos)
+            if not m.group(1)[:1].isspace():
+                top.append(m)
+            elif any(b in _GRADLE_SHARED_BLOCKS for b in stack):
+                shared.append(m)
+        code, quote = _gradle_code(line, quote)
+        name = re.search(r"(\w+)\s*\{[^{}]*$", code)
+        for ch in code:
+            if ch == "{":
+                stack.append(name.group(1) if name else "")
+            elif ch == "}" and stack:
+                stack.pop()
+        pos += len(line)
+    return top or shared
 
 
 def sync_spring(path_dir, new_version):
@@ -455,10 +513,13 @@ def sync_spring(path_dir, new_version):
         text = read_file(gradle_file)
         # 줄 시작의 `version =`만 프로젝트 버전이다. 앵커가 없으면 kotlin_version 같은
         # 의존성 버전 변수까지 함께 바뀌어 빌드가 깨진다.
-        new_text, count = _GRADLE_VERSION_RE.subn(
-            lambda m: f"{m.group(1)}{m.group(2)}{_keep_snapshot(m.group(3), new_version)}{m.group(2)}", text,
-        )
-        if count == 0:
+        matches = _gradle_version_matches(text)
+        new_text = text
+        # 뒤에서부터 바꿔 앞쪽 span이 밀리지 않게 한다.
+        for m in reversed(matches):
+            replaced = f"{m.group(1)}{m.group(2)}{_keep_snapshot(m.group(3), new_version)}{m.group(2)}"
+            new_text = new_text[:m.start()] + replaced + new_text[m.end():]
+        if not matches:
             log(f"WARNING: spring: no `version = '...'` line in {gradle_file} — skipping")
             continue
         write_file(gradle_file, new_text)
@@ -586,21 +647,36 @@ def sync_python(path_dir, new_version):
         log(f"updated: {target}")
 
 
+_PLIST_VERSION_RE = re.compile(r'(<key>CFBundleShortVersionString</key>\s*<string>)([^<]*)(</string>)')
+
+
+def _rn_app_plists(ios_dir):
+    """앱 타깃의 Info.plist만 이름순으로. Pods·빌드 산출물·테스트 타깃은 우리 버전이 아니다.
+    읽기와 동기화가 같은 파일 집합을 보도록 한 곳에서 고른다."""
+    skip = {"Pods", "build"}
+    return [
+        p for p in sorted(ios_dir.glob("*/Info.plist"))
+        if p.parent.name not in skip and not p.parent.name.endswith("Tests")
+    ]
+
+
 def sync_react_native(path_dir, new_version):
     ios_dir = Path(path_dir) / "ios"
     found_plist = False
     if ios_dir.is_dir():
-        for plist_file in ios_dir.rglob("Info.plist"):
+        for plist_file in _rn_app_plists(ios_dir):
             text = read_file(plist_file)
-            if "CFBundleShortVersionString" in text:
-                new_text = re.sub(
-                    r'(<key>CFBundleShortVersionString</key>\s*<string>)[^<]*(</string>)',
-                    r'\g<1>' + new_version + r'\g<2>',
-                    text,
-                )
-                write_file(plist_file, new_text)
-                log(f"updated: {plist_file}")
-                found_plist = True
+            m = _PLIST_VERSION_RE.search(text)
+            if not m:
+                continue
+            # $(MARKETING_VERSION) 같은 빌드 변수 참조는 Xcode 설정이 원본이라 덮어쓰지 않는다.
+            if m.group(2).strip().startswith("$("):
+                log(f"skipped: {plist_file} — CFBundleShortVersionString references a build variable")
+                continue
+            new_text = _PLIST_VERSION_RE.sub(lambda mm: mm.group(1) + new_version + mm.group(3), text)
+            write_file(plist_file, new_text)
+            log(f"updated: {plist_file}")
+            found_plist = True
     else:
         log(f"WARNING: react-native: {ios_dir} not found — skipping")
 
@@ -691,7 +767,7 @@ def _read_spring(path_dir):
     for name in ("build.gradle", "build.gradle.kts"):
         p = Path(path_dir) / name
         if p.is_file():
-            for m in _GRADLE_VERSION_RE.finditer(read_file(p)):
+            for m in _gradle_version_matches(read_file(p)):
                 version = core_version(m.group(3))
                 if version:
                     return version
@@ -725,10 +801,9 @@ def _read_react_native(path_dir):
     $(MARKETING_VERSION) 참조나 템플릿 기본값 "1.0"처럼 x.y.z가 아닌 값은 건너뛴다."""
     ios_dir = Path(path_dir) / "ios"
     if ios_dir.is_dir():
-        # rglob 첫 결과는 파일시스템 순서라 Pods·테스트 타깃 plist가 걸릴 수 있다 — 앱 폴더 한 단계만, 이름순.
-        for plist in sorted(ios_dir.glob("*/Info.plist")):
-            m = re.search(r'<key>CFBundleShortVersionString</key>\s*<string>([^<]*)</string>', read_file(plist))
-            version = core_version(m.group(1)) if m else None
+        for plist in _rn_app_plists(ios_dir):
+            m = _PLIST_VERSION_RE.search(read_file(plist))
+            version = core_version(m.group(2)) if m else None
             if version:
                 return version
     gradle_file = Path(path_dir) / "android" / "app" / "build.gradle"

package/payload/version.yml.template

@@ -27,6 +27,7 @@
 # - go: (none — git tag based, go.mod has no version field)
 # - basic: version.yml only
 # A file version like 1.2.0-rc.1 or 1.2.0+4 is read as 1.2.0 (version below is x.y.z only).
+# Synced files are rewritten to x.y.z as well, so even `get` turns 2.0.0-beta.1 in package.json into 2.0.0.
 # Gradle/Maven -SNAPSHOT is kept when the version is bumped (1.2.0-SNAPSHOT -> 1.2.1-SNAPSHOT).
 # ===
 
@@ -52,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/doctor.js

@@ -11,12 +11,11 @@
 //      않는다. 번역하면 설명은 읽히지만 정작 화면에서 그 항목을 찾지 못한다.
 import { spawnSync } from "node:child_process";
 import { existsSync, readFileSync } from "node:fs";
-import { join, posix } from "node:path";
+import { join } from "node:path";
 import { A, paint, colorEnabled, visualWidth } from "../ui/ansi.js";
 import { PATHS } from "../core/paths.js";
 import { parseExisting } from "../core/version-yml.js";
-import { STORE_PLATFORMS, STORE_APP_FILES, parseStoreList, storeAppFilesFor } from "../core/flutter-options.js";
-import { inferInstalledStores } from "../core/installed-stores.js";
+import { hooksFor } from "../core/types.js";
 
 const defaultExec = (cmd, args) => spawnSync(cmd, args, { encoding: "utf8" });
 
@@ -43,8 +42,13 @@ export function runDoctor(cwd = process.cwd(), { exec = defaultExec } = {}) {
       note: ["이 폴더엔 아직 설치되지 않았습니다 — 지금 설치하면 됩니다."],
     });
 
-  // Flutter 스토어 배포 파일 점검 — 로컬 파일만 보므로 gh 조회 결과와 무관하게 수행한다.
-  if (installed) for (const item of flutterStoreChecks(cwd)) add(item);
+  // 타입별 로컬 파일 점검(예: Flutter 스토어 배포 파일) — 로컬 파일만 보므로 gh 조회 결과와 무관하게 수행한다.
+  if (installed) {
+    const existing = parseExisting(readFileSync(join(cwd, PATHS.versionFile), "utf8"));
+    for (const { hook } of hooksFor(existing.types, "doctorChecks")) {
+      for (const item of hook(cwd, existing, { docs: DOC })) add(item);
+    }
+  }
 
   const ghVersion = exec("gh", ["--version"]);
   if (ghVersion.error || ghVersion.status !== 0) {
@@ -179,51 +183,6 @@ export function runDoctor(cwd = process.cwd(), { exec = defaultExec } = {}) {
   return results;
 }
 
-const PLATFORM_ROW_NAME = { android: "Flutter Android 배포 파일", ios: "Flutter iOS 배포 파일" };
-const PLACEHOLDER_RE = /__[A-Z][A-Z0-9_]*__/g; // 감지 규칙은 ExportOptions.plist 템플릿·IOS-TESTFLIGHT 검증과 동일
-const EXPORT_OPTIONS_REL = STORE_APP_FILES.ios.find((rel) => rel.endsWith("ExportOptions.plist"));
-
-// Flutter 스토어 배포 진단 — 선택한 플랫폼의 필수 파일과 ExportOptions.plist 플레이스홀더.
-// 스토어 시크릿 등록 여부는 이번 범위 밖이다. 반환: doctor 결과 행 배열.
-function flutterStoreChecks(cwd) {
-  const existing = parseExisting(readFileSync(join(cwd, PATHS.versionFile), "utf8"));
-  if (!existing.types.includes("flutter")) return [];
-  const saved = existing.options.flutterStore == null ? null : parseStoreList(existing.options.flutterStore);
-  // 저장값 없는 기존 설치는 설치된 스토어 워크플로우로 추론한다 (interactive와 같은 규칙).
-  const stores = saved ?? inferInstalledStores(join(cwd, PATHS.workflowsDir));
-  const flutterRoot = existing.paths.get("flutter") || ".";
-  const rows = [];
-
-  for (const platform of STORE_PLATFORMS.filter((p) => stores.includes(p))) {
-    const files = storeAppFilesFor([platform]).map((rel) => posix.join(flutterRoot, rel));
-    const missing = files.filter((file) => !existsSync(join(cwd, file)));
-    const head = { name: PLATFORM_ROW_NAME[platform], purpose: "fastlane 스토어 업로드에 필요한 파일" };
-    rows.push(missing.length
-      ? {
-        ...head, status: "WARN", value: `없는 파일: ${missing.join(", ")}`,
-        impact: ["이 파일이 없으면 스토어 배포 워크플로우가 fastlane 단계에서 실패합니다."],
-        actions: ["마법사를 다시 실행하면 없는 파일만 새로 만들어 줍니다 (이미 있는 파일은 덮어쓰지 않음)"],
-        doc: DOC.flutterStore,
-      }
-      : { ...head, status: "OK", value: `${files.length}개 있음` });
-  }
-
-  const plistPath = posix.join(flutterRoot, EXPORT_OPTIONS_REL);
-  if (stores.includes("ios") && existsSync(join(cwd, plistPath))) {
-    const head = { name: "ExportOptions.plist", purpose: "iOS 서명·내보내기 설정" };
-    const left = [...new Set(readFileSync(join(cwd, plistPath), "utf8").match(PLACEHOLDER_RE) ?? [])];
-    rows.push(left.length
-      ? {
-        ...head, status: "WARN", value: `채워지지 않은 값: ${left.join(", ")}`,
-        impact: ["채우지 않으면 IOS-TESTFLIGHT 워크플로우가 ExportOptions.plist 검증 단계에서 중단됩니다."],
-        actions: [`${plistPath} 의 플레이스홀더를 실제 값(Team ID · 번들 ID · 프로비저닝 프로파일 이름)으로 바꾸세요`],
-        doc: DOC.flutterStore,
-      }
-      : { ...head, status: "OK", value: "플레이스홀더 없음" });
-  }
-  return rows;
-}
-
 const asLines = (v) => (Array.isArray(v) ? v : v ? [String(v)] : []);
 const headOf = (r) => `${r.label || r.name}${r.purpose ? ` — ${r.purpose}` : ""}`;
 

package/src/commands/dry-run.js

@@ -4,9 +4,9 @@ import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { PATHS } from "../core/paths.js";
 import { planWorkflows } from "../core/copy/workflows.js";
-import { planFlutterAppFiles } from "../core/copy/flutter-app.js";
+import { planTypeAppFiles } from "../core/copy/app-files.js";
 import { planUninstall } from "./uninstall.js";
-import { renderVersionYml, parseExisting } from "../core/version-yml.js";
+import { renderVersionYml, parseExisting, sameIgnoringTimestamps } from "../core/version-yml.js";
 import { readVersionYmlTemplate } from "../core/assets.js";
 import { existingMarkerInDir } from "../core/paths-resolve.js";
 import { planScripts } from "../core/copy/simple.js";
@@ -28,7 +28,8 @@ function versionYmlPreview(context, payloadRoot, targetRoot) {
   const wouldBe = renderVersionYml(context, readVersionYmlTemplate(payloadRoot), {
     pathMarkers, extraTopLevel,
   });
-  return { existed: existingRaw !== null, changed: existingRaw !== wouldBe };
+  // 실제 설치와 같은 기준으로 비교한다 — 시각 줄만 다르면 설치도 파일을 다시 쓰지 않는다.
+  return { existed: existingRaw !== null, changed: existingRaw === null || !sameIgnoringTimestamps(existingRaw, wouldBe) };
 }
 
 // mode: "full" | "uninstall". 읽기 전용 — 아무 파일도 쓰지 않는다.
@@ -49,7 +50,7 @@ export function planDryRun(mode, context, payloadRoot, targetRoot = ".") {
     cleanup,
     gitignore: backedUp ? planGitignore(targetRoot) : null,
     // Flutter 스토어 배포 파일(Fastfile·ExportOptions.plist) — 이미 있는 파일은 덮어쓰지 않고 유지한다.
-    flutterApp: planFlutterAppFiles(context, payloadRoot, targetRoot),
+    flutterApp: planTypeAppFiles(context, payloadRoot, targetRoot),
     versionYml: versionYmlPreview(context, payloadRoot, targetRoot),
     // 실제 설치가 함께 바꾸는 파일 — 특히 기존 파일을 덮어쓰는 스크립트는 미리 보여줘야 한다.
     scripts: planScripts(payloadRoot, targetRoot),

package/src/commands/full.js

@@ -12,12 +12,12 @@ import { existingMarkerInDir } from "../core/paths-resolve.js";
 import { addVersionSectionToReadme, README_STATUS_LABEL } from "../core/copy/readme.js";
 import { copyWorkflows, computeBaselineEntries, makeSrcText } from "../core/copy/workflows.js";
 import { copyScripts, removeScriptBytecode } from "../core/copy/simple.js";
-import { copyFlutterAppFiles } from "../core/copy/flutter-app.js";
+import { copyTypeAppFiles } from "../core/copy/app-files.js";
 import { ensureGitignore } from "../core/copy/gitignore.js";
 import { readBaseline, writeBaseline, appFileHash } from "../core/baseline.js";
 import { scanUnsubstituted, classifySecrets, narrowSecretsBySshAuth } from "../core/verify.js";
 import { cleanupOtherDeployWorkflows, payloadWorkflowNames, DEFAULT_DEPLOY_STYLE } from "../core/deploy-style.js";
-import { cleanupDeselectedStoreWorkflows } from "../core/flutter-options.js";
+import { hooksFor } from "../core/types.js";
 import { findStaleWorkflows, cleanupStaleWorkflows } from "../core/removal-plan.js";
 import { log, maskValue } from "../core/logger.js";
 
@@ -62,9 +62,9 @@ export function runFull(context, payloadRoot, targetRoot = ".", hooks = {}) {
 
   // 1-1. Flutter 앱 파일(fastlane·ExportOptions) — 사용자가 값을 채워 쓰는 파일이라 없을 때만 만든다.
   //      워크플로우 복사가 끝난 뒤에 실행한다(워크플로우가 이 파일들을 전제로 돈다).
-  const flutterApp = copyFlutterAppFiles(context, payloadRoot, targetRoot);
-  for (const f of flutterApp.created) log.info("flutter-app", "create", f);
-  for (const f of flutterApp.kept) log.info("flutter-app", "keep", `${f} (기존 파일 유지)`);
+  const flutterApp = copyTypeAppFiles(context, payloadRoot, targetRoot, (tag, action, f) => {
+    log.info(tag, action, action === "keep" ? `${f} (기존 파일 유지)` : f);
+  });
 
   // 기존 version.yml의 알려지지 않은 최상위 필드를 재생성 시 보존한다.
   const vyPath = join(targetRoot, PATHS.versionFile);
@@ -188,23 +188,24 @@ export function cleanupWorkflows(context, payloadRoot, targetRoot, baseline, { j
   const cleanup = cleanupOtherDeployWorkflows(workflowsDir, listDir(),
     context.deployStyle || DEFAULT_DEPLOY_STYLE, baseline,
     { available: payloadWorkflowNames(payloadRoot), justWritten, dryRun });
-  const storeCleanup = Array.isArray(context.flutterStore) && (context.types || []).includes("flutter")
-    ? cleanupDeselectedStoreWorkflows(workflowsDir, listDir(), context.flutterStore, baseline, { dryRun })
-    : { removed: [], backedUp: [] };
+  const storeCleanup = { removed: [], backedUp: [] };
+  for (const { hook } of hooksFor(context.types || [], "cleanupWorkflows")) {
+    const r = hook(workflowsDir, listDir(), context, baseline, { dryRun });
+    storeCleanup.removed.push(...r.removed);
+    storeCleanup.backedUp.push(...r.backedUp);
+  }
   const staleCleanup = cleanupStaleWorkflows(targetRoot, findStaleWorkflows(payloadRoot, targetRoot, baseline), baseline, { dryRun });
   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

@@ -0,0 +1,49 @@
+// 설치 설정 해석 단계 — 비대화형(index.js)과 대화형(interactive.js)이 공유한다.
+// 값을 채우는 방법(플래그·질문)은 경로마다 다르지만, 타입·버전·배포 방식·옵션을 확정하고
+// 설치 컨텍스트로 조립하는 규칙은 한 곳에 둬야 한쪽만 고쳐 두 모드의 결과가 갈라지지 않는다.
+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에 저장된 배포 방식 — 없거나 알 수 없는 값이면 "".
+export const savedDeployStyle = (existing) =>
+  isDeployStyle(existing?.options?.deployStyle) ? existing.options.deployStyle : "";
+
+// 배포 방식 — 명시값(플래그·질문 답변) → 저장값 → 기본값.
+// 서버 배포 워크플로우가 없는 타입은 설치 결과에 영향이 없으므로 기록하지 않는다(null).
+export function resolveDeployStyle({ payload, types, explicit = "", existing }) {
+  if (!hasServerDeployWorkflows(payload, types)) return null;
+  return explicit || savedDeployStyle(existing) || DEFAULT_DEPLOY_STYLE;
+}
+
+// 버전 — 기존 version.yml 최우선(재실행 시 덮어쓰기 방지) → 명시값 → 파일 감지.
+// detectOpts는 감지 함수로 그대로 넘긴다(types·paths·warn·hint).
+export function resolveVersion({ cwd, existing, explicit = "", ...detectOpts }) {
+  return existing?.version || explicit || detectVersion(cwd, detectOpts);
+}
+
+// 빌드 번호 — 기존 값 보존, 신규 통합이면 프로젝트 파일에서 감지, 못 찾으면 1.
+export function resolveVersionCode({ cwd, existing, types, paths }) {
+  return existing?.versionCode ?? detectBuildNumber(cwd, { types, paths }) ?? 1;
+}
+
+// 확정된 값들을 설치 컨텍스트로 조립한다.
+//   deployStyle: resolveDeployStyle 결과(고른 값). 실제 설치되는 방식으로 바꿔 기록한다.
+//   typeOptions: 타입 훅(resolveOptions)이 확정한 타입 전용 옵션 — 두 경로 모두 확정된 값. 컨텍스트 필드로의 변환도 타입 훅이 한다.
+//   releaseOptions: { includeSemverAuto, includeCopilotAi } — resolveReleaseOptions 결과.
+//   extra: 경로별로만 쓰는 필드(envValues 등).
+export function buildInstallContext({
+  payload, existing, templateVersion, types, deployStyle, typeOptions, releaseOptions, ...rest
+}) {
+  return createContext({
+    types,
+    ...releaseOptions,
+    // 안내는 고른 값으로 하되, 기록은 실제로 설치되는 방식으로 한다.
+    deployStyle: effectiveDeployStyle(payload, types, deployStyle),
+    ...mergeHookResults(types, "contextFields", typeOptions),
+    previousTemplateVersion: existing?.templateVersion || "",
+    templateVersion,
+    ...rest,
+  });
+}

package/src/commands/interactive.js

@@ -5,7 +5,7 @@
 import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 import { resolvePayloadRoot, assertPayload, readTemplateVersion } from "../core/assets.js";
-import { detectTypes, detectVersion, detectDefaultBranch, detectRepoName, makeResolvers, detectBuildNumber, detectMarkers } from "../core/detect-fs.js";
+import { detectTypes, detectVersion, detectDefaultBranch, detectRepoName, makeResolvers, detectMarkers } from "../core/detect-fs.js";
 import { parseExisting } from "../core/version-yml.js";
 import { pickReleaseOptions, resolveReleaseOptions } from "../core/release-options.js";
 import { runBreakingCheck } from "../core/breaking-check.js";
@@ -15,8 +15,9 @@ import {
 } from "../core/branches.js";
 import { promptEnvPlan } from "../ui/env-plan.js";
 import { surveyWorkflows } from "../core/copy/workflows.js";
-import { createContext, VALID_TYPES } from "../context.js";
-import { isDeployStyle, DEFAULT_DEPLOY_STYLE, hasServerDeployWorkflows, hasNonstopWorkflows, effectiveDeployStyle } from "../core/deploy-style.js";
+import { VALID_TYPES } from "../context.js";
+import { savedDeployStyle, resolveDeployStyle, resolveVersion, resolveVersionCode, buildInstallContext } from "./install-settings.js";
+import { isDeployStyle, DEFAULT_DEPLOY_STYLE, hasServerDeployWorkflows, hasNonstopWorkflows } from "../core/deploy-style.js";
 import { PATHS } from "../core/paths.js";
 import { resolveFlutterOptions, DEFAULT_DEPLOY_MODE, STORE_PLATFORMS } from "../core/flutter-options.js";
 import { inferInstalledStores } from "../core/installed-stores.js";
@@ -83,8 +84,8 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   // 먼저 나와 앞선 질문에 대한 경고처럼 보였다. 안내 문구도 대화형용으로 바꾼다.
   const detectWarnings = [];
   let types = detectTypes(cwd);
-  let version = (existing?.version) || detectVersion(cwd, {
-    types,
+  let version = resolveVersion({
+    cwd, existing, types,
     warn: (m) => detectWarnings.push(m),
     hint: "다음 화면의 '수정하기 > 버전'에서 바로 고칠 수 있습니다.",
   });
@@ -100,7 +101,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   let { semverAuto: includeSemverAuto, copilotAi: includeCopilotAi } = pickReleaseOptions(
     { semverAuto: baseCtx?.includeSemverAuto, copilotAi: baseCtx?.includeCopilotAi }, existing);
   // 서버 배포 방식 — 저장값(version.yml)이 있으면 재질문하지 않는다 (semver_auto와 같은 규약).
-  let deployStyle = isDeployStyle(existing?.options?.deployStyle) ? existing.options.deployStyle : "";
+  let deployStyle = savedDeployStyle(existing);
   const showOptional = mode === "full";
   const realTty = process.stdout.isTTY === true;
 
@@ -295,7 +296,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   if (versionAutoDetected && [...paths.values()].some((p) => p && p !== ".")) {
     version = detectVersion(cwd, { types, paths, warn: () => {} });
   }
-  const versionCode = existing?.versionCode ?? detectBuildNumber(cwd, { types, paths }) ?? 1; // 기존 빌드번호 보존, 신규 통합 시 프로젝트 파일에서 감지
+  const versionCode = resolveVersionCode({ cwd, existing, types, paths });
 
   // @wizard env 계획 질문 (full/workflows만)
   const resolvers = makeResolvers(cwd, repoName, paths, flutterOptions);
@@ -312,20 +313,17 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   }
 
   const { now, today } = clock || utcNow();
-  const ctx = createContext({
-    mode, force: true, types, version, versionCode, branch, branches, paths,
-    includeSemverAuto,
-    includeCopilotAi,
-    repoName, templateVersion, resolvers, envValues, envUseDefaults, now, today,
+  const ctx = buildInstallContext({
+    payload, existing, templateVersion, types,
+    // 저장값이 무중단이어도 선택한 타입에 그 방식이 없으면 단일 서버 배포가 설치된다 — 설치된 방식을 기록한다.
+    deployStyle: resolveDeployStyle({ payload, types, explicit: deployStyle, existing }),
+    typeOptions: flutterOptions,
+    releaseOptions: { includeSemverAuto, includeCopilotAi },
+    mode, force: true, version, versionCode, branch, branches, paths,
+    repoName, resolvers, envValues, envUseDefaults, now, today,
     // 설치 로그·완료 요약이 쓰는 부가 문맥 — 설치 동작 자체는 바꾸지 않는다.
     markers, envAnswers, detectWarnings,
-    // 저장값이 무중단이어도 선택한 타입에 그 방식이 없으면 단일 서버 배포가 설치된다 — 설치된 방식을 기록한다.
-    deployStyle: hasServerDeploy() ? effectiveDeployStyle(payload, types, deployStyle || DEFAULT_DEPLOY_STYLE) : null,
-    envMode: flutterOptions.envMode, flutterStore: flutterOptions.stores,
-    androidDeployMode: flutterOptions.androidDeployMode, iosDeployMode: flutterOptions.iosDeployMode,
-    previousTemplateVersion: existing?.templateVersion || "",
   });
-  ctx.templateVersion = templateVersion;
 
   // 사용자가 답해야 하는 것만 묻는다. baseline 3-way가 자동으로 안전한 경우를
   // 걸러내므로, 여기 오는 것은 (a) 양쪽이 다 바뀐 진짜 충돌과 (b) 사용자가 지운 파일뿐이다.

package/src/commands/purge.js

@@ -7,12 +7,10 @@
 import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 import { PATHS } from "../core/paths.js";
-import { remove } from "../core/fsutil.js";
 import { planRemoval, backupArtifacts } from "../core/removal-plan.js";
-import { removeAppFiles, pruneInstallDirs } from "./uninstall.js";
-import { removeVersionSectionFromReadme, hasVersionSection } from "../core/copy/readme.js";
-import { removeAutoAddedEntriesFromGitignore, hasAutoAddedEntries } from "../core/copy/gitignore.js";
-import { logRemovals } from "../core/logger.js";
+import { executeRemoval } from "../core/removal-exec.js";
+import { hasVersionSection } from "../core/copy/readme.js";
+import { hasAutoAddedEntries } from "../core/copy/gitignore.js";
 
 const CHANGELOG_FILES = ["CHANGELOG.json", "CHANGELOG.md"];
 
@@ -87,22 +85,11 @@ export function printPurgePlan(plan, { dryRun = false } = {}) {
 // 이론상 어긋나는 경우에도 printPurgeResult가 거짓으로 "제거됨"을 보고하지 않는다.
 export function executePurge(payloadRoot, targetRoot = ".", keepFlags = {}) {
   const plan = planPurge(payloadRoot, targetRoot, keepFlags);
-  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);
-  if (plan.versionYml) { remove(join(targetRoot, PATHS.versionFile)); done.push(["remove", "version", PATHS.versionFile]); }
-  const readmeSection = plan.readmeSection && removeVersionSectionFromReadme(targetRoot) === "removed";
-  const gitignoreStatus = plan.gitignore ? removeAutoAddedEntriesFromGitignore(targetRoot) : null;
-  const gitignore = gitignoreStatus === "removed" || gitignoreStatus === "file-deleted";
-  if (gitignore) done.push(["remove", "gitignore", ".gitignore 자동 추가 항목"]);
-  for (const f of plan.changelog) { remove(join(targetRoot, f)); done.push(["remove", "changelog", f]); }
-  if (readmeSection) done.push(["remove", "readme", "README.md 버전 섹션"]);
-  logRemovals(targetRoot, done);
-  return { ...plan, readmeSection, gitignore };
+  const { readme, gitignore } = executeRemoval(targetRoot, { ...plan, readme: plan.readmeSection }, {
+    logOrder: ["version", "gitignore", "changelog", "readme"],
+    gitignoreDetail: (status) => (status === "removed" || status === "file-deleted" ? ".gitignore 자동 추가 항목" : null),
+  });
+  return { ...plan, readmeSection: readme, gitignore };
 }
 
 // 삭제 후 실제 제거된 목록 출력 — printPurgePlan과 완전히 동일한 형태(파일명 나열)로