projectops 4.45.0 → 4.45.1

package/README.md

@@ -9,7 +9,7 @@
 **Status: actively maintained.** npm `latest` is exactly what is on the `main` branch; work in progress on `develop` is never published. Versions can still ship several times a day. To stay on a version you have tested, run `npx projectops@<version>` ([releases](https://github.com/Cassiiopeia/projectops/releases)).
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## Latest version : v4.44.2 (2026-10-10)
+## Latest version : v4.45.0 (2026-10-10)
 
 [View full version history](CHANGELOG.md)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "4.45.0",
+  "version": "4.45.1",
   "description": "ProjectOps: installer CLI for a fully automated GitHub project management template (versioning, CI/CD, release notes, agent skills)",
   "keywords": [
     "devops",

package/src/commands/interactive.js

@@ -2,7 +2,7 @@
 // io 주입으로 테스트 가능. 실제 실행은 src/ui/prompts.js 함수를 io로 넘긴다.
 // 새 시각 층(banner/detectionLog/analysisCard/ideStatus/installKind/summary)과 저수준 엔진(engineIo)은
 // io의 "옵셔널 멤버" — 스텁이 생략하면 해당 층만 건너뛰고 실행 계약은 동일하다.
-import { DEFAULT_CODE_REVIEW_CODERABBIT } from "../core/constants.js";
+import { resolveOptions } from "../core/resolve-options.js";
 import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 import { PATHS } from "../core/paths.js";
@@ -14,7 +14,7 @@ import { runBreakingCheck } from "../core/breaking-check.js";
 import { runMigrations } from "../core/migrations/index.js";
 import { detectOrphanWorkflows, applyOrphanCleanup } from "../core/orphan-workflows.js";
 import { resolveProjectPaths, filterExcludedTypes } from "../core/paths-resolve.js";
-import { askAllOptionalWorkflows, OPTION_AXES, applicableTargets, migrateProvider } from "../core/options-ask.js";
+import { askAllOptionalWorkflows, OPTION_AXES, applicableTargets } from "../core/options-ask.js";
 import { createRunTrace, MIGRATION_DIR } from "../core/run-trace.js";
 import { appendGuideEntry } from "../core/migration-guide.js";
 import { promptEnvPlan } from "../ui/env-plan.js";
@@ -125,35 +125,26 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     let branch = detectDefaultBranch(cwd);
     const repoName = detectRepoName(cwd);
     const versionCode = existing?.versionCode ?? 1; // 기존 빌드번호 보존
-    // 배포/publish 축 초기값(#439): version.yml 저장 옵션 (구 키 자동 마이그레이션 포함)
-    let deployTarget = existing?.options?.deploy ?? "docker-ssh";
-    let publishTargets = existing?.options?.publish ?? [];
-    let includeSecretBackup = existing?.options?.secretBackup ?? false;
-    let aiPrSummary = existing?.options?.aiPrSummary ?? null;   // null = 아직 안 물음 (#566)
-    let codeReviewCoderabbit = existing?.options?.codeReviewCoderabbit ?? DEFAULT_CODE_REVIEW_CODERABBIT;
-    let changelogProvider = migrateProvider(existing?.options?.changelogProvider) ?? "commit";
-    let changelogBaseUrl = existing?.options?.changelogBaseUrl ?? "";
-    let deployBranch = existing?.options?.deployBranch ?? "develop"; // #456
+    // 옵션 초기값은 비대화형과 같은 resolve-options.js 에서 받는다 (#851).
+    // 질문을 건너뛰는 모드(version 등)도 이 값이 그대로 기록되므로 타입 적용성 정리까지 거친 값이어야 한다.
+    const { values: init, sources: initSources } = resolveOptions({ existing, types, cwd });
+    let deployTarget = init.deployTarget;
+    let publishTargets = init.publishTargets;
+    let includeSecretBackup = init.includeSecretBackup;
+    let aiPrSummary = init.aiPrSummary;
+    let codeReviewCoderabbit = init.codeReviewCoderabbit;
+    let changelogProvider = init.changelogProvider;
+    let changelogBaseUrl = init.changelogBaseUrl;
+    let deployBranch = init.deployBranch; // #456 — 비어 있으면 기록하지 않는다. 질문에서 고른 값만 남긴다
     let deployBranchReady = null; // #490 — 이번 실행에서 개발 브랜치 존재/생성이 확인됐는지
     let deployBranchCreated = null; // #493 — 마법사가 직접 생성했는지 (가이드 기록용)
-    let intent = existing?.options?.intent ?? null; // #485 프로젝트 성격
-    // semver 자동 승격(#546) — 질문하지 않는다(#485 질문 부담 축소 방향 유지).
-    // 저장값(명시적 false 포함)은 보존하고, 키가 없으면 기존 레포도 ON. 켜진 사실은 완료 화면이 알린다.
-    const semverAuto = existing?.options?.semverAuto ?? true;
-    const semverAutoNewlyOn = !!existing && existing?.options?.semverAuto == null;
-    const appRelease = existing?.options?.appRelease ?? null; // #553 저장값 보존 (묻지 않음)
-    // 상태 라벨 표기(#776): 저장값 > (신규 en / 기존 ko). 기존 한글 레포에는 영문 전환을 한 번 제안한다(아래).
-    const closeOnRelease = existing?.options?.closeOnRelease ?? (existing ? null : true); // #771 묻지 않는다
-    const excludedWorkflows = existing?.options?.excludedWorkflows ?? null; // #810 저장값 보존
-    const storeLocales = existing?.options?.storeLocales ?? null; // #829 저장값 보존
-    const storeLocalesIos = existing?.options?.storeLocalesIos ?? null;
-    const storeLocalesPlay = existing?.options?.storeLocalesPlay ?? null;
-    // Projects 보드 동기화(#716): 묻지 않는다. 저장값 > 이미 설치돼 있으면 유지 > 신규는 제외 (index.js 와 같은 규칙).
-    const projectsSync = existing?.options?.projectsSync
-      ?? existsSync(join(cwd, ".github/workflows/PROJECT-COMMON-PROJECTS-SYNC-MANAGER.yaml"));
-    // 레포 문구 언어(#769): 저장값 > (신규 en / 기존 ko). 기존 레포에는 영문 전환을 한 번만 제안한다.
-    let language = resolveRepoLanguage({ flag: null, stored: existing?.options?.language, existing: !!existing });
-    let labelStyle = resolveLabelStyle({ flag: null, stored: existing?.options?.labelStyle, existing: !!existing });
+    let intent = init.intent; // #485 프로젝트 성격
+    // 묻지 않는 값 — 저장값 보존 규칙은 resolve-options.js 에 있다
+    const { semverAuto, appRelease, closeOnRelease, excludedWorkflows, storeLocales, storeLocalesIos, storeLocalesPlay, projectsSync } = init;
+    const semverAutoNewlyOn = initSources.semverAutoNewlyOn;
+    // 레포 문구 언어(#769)·라벨 표기(#776): 기존 레포에는 영문 전환을 한 번만 제안한다(아래).
+    let language = init.language;
+    let labelStyle = init.labelStyle;
     const showOptional = mode === "full" || mode === "workflows";
     const realTty = process.stdout.isTTY === true;
     // 기존 한글 라벨 레포에는 영문 표준 전환을 한 번만 제안한다(#776). 거절하면 한글을 저장해 다시 묻지 않는다.
@@ -194,6 +185,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
       publishTargets = r.publish;
       includeSecretBackup = r.secretBackup;
       codeReviewCoderabbit = r.codeReviewCoderabbit;
+      aiPrSummary = r.aiPrSummary; // #851 — 빠져 있어 PR 요약 선택이 버려졌다
       changelogProvider = r.changelogProvider;
       changelogBaseUrl = r.changelogBaseUrl;
       deployBranch = r.deployBranch;
@@ -256,7 +248,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
             tempDir, types, targetRoot: cwd, defaultBranch: branch,
             current: {
               deploy: deployTarget, publish: publishTargets, secretBackup: includeSecretBackup,
-              codeReviewCoderabbit, changelogProvider, changelogBaseUrl, deployBranch, intent,
+              codeReviewCoderabbit, aiPrSummary, changelogProvider, changelogBaseUrl, deployBranch, intent,
             },
             force: false, tty: realTty, forceAsk: true, scope: [what],
             io: {
@@ -270,6 +262,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
           publishTargets = r.publish;
           includeSecretBackup = r.secretBackup;
           codeReviewCoderabbit = r.codeReviewCoderabbit;
+          aiPrSummary = r.aiPrSummary; // #851
           changelogProvider = r.changelogProvider;
           changelogBaseUrl = r.changelogBaseUrl;
           deployBranch = r.deployBranch;
@@ -334,10 +327,10 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     const { now, today } = clock || utcNow();
     const ctx = createContext({
       mode, force: true, types, version, versionCode, branch, paths, deployTarget, publishTargets, includeSecretBackup,
-      codeReviewCoderabbit, changelogProvider, changelogBaseUrl, deployBranch, intent, semverAuto, appRelease, labelStyle, closeOnRelease, projectsSync, language, excludedWorkflows, storeLocales, storeLocalesIos, storeLocalesPlay,
+      aiPrSummary, codeReviewCoderabbit, changelogProvider, changelogBaseUrl, deployBranch, intent, semverAuto, appRelease, labelStyle, closeOnRelease, projectsSync, language, excludedWorkflows, storeLocales, storeLocalesIos, storeLocalesPlay,
       repoName, templateVersion, resolvers, envValues, envUseDefaults, now, today,
       // #502 — version 모드가 기존 full 기록을 강등하지 않도록 (full이 우세)
-      recordMode: existing?.templateMode === "full" ? "full" : "version",
+      recordMode: init.recordMode,
     });
     ctx.templateVersion = templateVersion;
 

package/src/core/copy/workflows.js

@@ -15,6 +15,7 @@ import { substituteBranches } from "../branch-sub.js";
 import { saveIncoming, lineDiffCounts } from "../incoming.js";
 import { branchStatus } from "../git-branch.js";
 import { PUBLISH_TARGETS } from "../constants.js";
+import { commonOptionalGroups, serverDeployEnabled, SERVER_DEPLOY_DIR } from "../workflow-groups.js";
 
 // on: 블록의 브랜치 필터가 전부 develop 뿐인가 (#810).
 // 개발 브랜치가 없는 레포에 깔면 영영 실행되지 않는 워크플로우를 가린다.
@@ -229,78 +230,46 @@ export function copyWorkflows(context, tempDir, targetRoot = ".", hooks = {}) {
     if (asks.size) deployValues.set(type, asks);
   }
 
-  // (4.5) common/deploy/<target> — 타입 비종속 배포 타겟 (vercel 등, #439)
-  const commonDeployDir = join(commonDir, "deploy", deployTarget || "docker-ssh");
-  if (exists(commonDeployDir)) {
-    for (const filename of listYamlFiles(commonDeployDir)) {
-      const src = join(commonDeployDir, filename);
+  // (4.5~5) common/ 아래 선택형 폴더 — deploy/<target>, pr-summary, projects-sync, secret-backup.
+  // 어느 폴더를 켜는지는 workflow-groups.js 한 곳이 정한다 (#851). 고아 감지도 같은 표를 쓴다.
+  //   bak-replace: 템플릿과 같으면 건너뛰고, 다르면 .bak 으로 남기고 교체한다.
+  //   new-only   : 이미 있으면 건드리지 않는다. 새로 깔 때만 레포 이름을 채운다 (#729 — 고정값이면
+  //                모든 프로젝트가 서버의 같은 폴더에 Secret 을 덮어쓴다).
+  for (const group of commonOptionalGroups(commonDir, { includeSecretBackup, aiPrSummary, projectsSync, deployTarget })) {
+    const groupDir = join(commonDir, group.dir);
+    if (!group.enabled || !exists(groupDir)) continue;
+    for (const filename of listYamlFiles(groupDir)) {
+      const src = join(groupDir, filename);
       const dst = join(workflowsDir, filename);
-      if (existsSync(dst) && isUnchanged(readFileSync(src, "utf8"), readFileSync(dst, "utf8"), envOptsFor("common"))) {
-        counters.skipped++;
-        trace?.event("copy", "skipped-unchanged", filename, { group: "common-deploy" });
+      if (group.policy === "new-only") {
+        if (existsSync(dst)) continue;
+        if (skipNew(groupDir, filename, group.copyLabel)) continue;
+        copyFileSync(src, dst);
+        const raw = readFileSync(dst, "utf8");
+        const filled = resolveGlobalTokens(raw, repoName || "my-project");
+        if (filled !== raw) writeFileSync(dst, filled);
+        counters.optionalCopied++;
+        counters.copied++;
+        counters.copiedFiles.push(filename);
+        trace?.event("copy", "copied", filename, { group: group.copyLabel });
         continue;
       }
-      if (skipNew(commonDeployDir, filename, "common-deploy")) continue;
-      const backedUp = existsSync(dst);
-      if (backedUp) renameSync(dst, dst + ".bak");
-      copyFileSync(src, dst);
-      counters.optionalCopied++;
-      counters.copied++;
-      counters.copiedFiles.push(filename);
-      trace?.event("copy", backedUp ? "replaced-bak" : "copied", filename, { group: "common-deploy" });
-      if (backedUp) counters.replacedBak.push(filename);   // #673
-    }
-  }
-
-  // (4.7) common/pr-summary — AI 변경 요약 (#566). 선택했을 때만 복사한다.
-  // 종전에는 common 본체에 있어 무조건 복사된 뒤 런타임에 스스로 빠졌고, 그 판단이
-  // ".coderabbit.yaml 존재"라 파일만 있고 앱이 없는 저장소에서는 아무도 요약하지 않았다.
-  // (4.8) common/projects-sync — Projects 보드 동기화 (#716). 이것도 선택했을 때만 복사한다.
-  //   Secret(_GITHUB_PAT_TOKEN)과 PROJECT_URL 변수를 등록해야 동작하는데, Projects 를 안 쓰는 레포가
-  //   많아 설치만 되고 설정되지 않은 채 남았다. 같은 폴더 방식이라 게이트와 고아 감지(orphan-workflows.js)를 함께 둔다.
-  for (const [groupName, groupEnabled] of [["pr-summary", aiPrSummary], ["projects-sync", projectsSync]]) {
-  const prSummaryDir = join(commonDir, groupName);
-  if (exists(prSummaryDir) && groupEnabled) {
-    for (const filename of listYamlFiles(prSummaryDir)) {
-      const src = join(prSummaryDir, filename);
-      const dst = join(workflowsDir, filename);
       if (existsSync(dst) && isUnchanged(readFileSync(src, "utf8"), readFileSync(dst, "utf8"), envOptsFor("common"))) {
         counters.skipped++;
-        trace?.event("copy", "skipped-unchanged", filename, { group: groupName });
+        trace?.event("copy", "skipped-unchanged", filename, { group: group.copyLabel });
         continue;
       }
-      if (skipNew(prSummaryDir, filename, groupName)) continue;
+      if (skipNew(groupDir, filename, group.copyLabel)) continue;
       const backedUp = existsSync(dst);
       if (backedUp) renameSync(dst, dst + ".bak");
       copyFileSync(src, dst);
       counters.optionalCopied++;
       counters.copied++;
       counters.copiedFiles.push(filename);
-      trace?.event("copy", backedUp ? "replaced-bak" : "copied", filename, { group: groupName });
+      trace?.event("copy", backedUp ? "replaced-bak" : "copied", filename, { group: group.copyLabel });
       if (backedUp) counters.replacedBak.push(filename);   // #673
     }
   }
-  }
-
-  // (5) common/secret-backup — 있으면 무조건 스킵/신규만 복사
-  const secretDir = join(commonDir, "secret-backup");
-  if (exists(secretDir) && includeSecretBackup) {
-    for (const filename of listYamlFiles(secretDir)) {
-      const dst = join(workflowsDir, filename);
-      if (existsSync(dst)) continue; // 이미 존재하면 스킵
-      if (skipNew(secretDir, filename, "secret-backup")) continue;
-      copyFileSync(join(secretDir, filename), dst);
-      // PROJECT_NAME 이 고정값이면 모든 프로젝트가 서버의 같은 폴더에 Secret 을 덮어쓴다 (#729) —
-      // 다른 배포 워크플로처럼 레포 이름으로 채운다. 이름을 알 수 없으면 기존 기본값을 쓴다.
-      const raw = readFileSync(dst, "utf8");
-      const filled = resolveGlobalTokens(raw, repoName || "my-project");
-      if (filled !== raw) writeFileSync(dst, filled);
-      counters.optionalCopied++;
-      counters.copied++;
-      counters.copiedFiles.push(filename);
-      trace?.event("copy", "copied", filename, { group: "secret-backup" });
-    }
-  }
 
   // (6) 브랜치 치환 post-pass (#477) — 표준과 다른 브랜치 전략일 때만 복사된 파일에 적용.
   // isUnchanged 가상 비교에도 같은 branches가 들어가므로 다음 업데이트에서 재복사 churn이 없다.
@@ -411,8 +380,8 @@ export function listWorkflowConflicts(context, tempDir, targetRoot = ".") {
     if (exists(typeDir)) {
       for (const f of classify(typeDir, workflowsDir, envOpts, baseline).changed) conflicts.push({ filename: f, type });
     }
-    const serverDeployDir = join(typeDir, "server-deploy");
-    if (exists(serverDeployDir) && (deployTarget || "docker-ssh") === "docker-ssh") {
+    const serverDeployDir = join(typeDir, SERVER_DEPLOY_DIR);
+    if (exists(serverDeployDir) && serverDeployEnabled(deployTarget)) {
       for (const f of classify(serverDeployDir, workflowsDir, envOpts, baseline).changed) conflicts.push({ filename: f, type });
     }
   }
@@ -464,8 +433,8 @@ function copyWorkflowsForType(type, projectTypesDir, workflowsDir, ctx, counters
   }
 
   // server-deploy — deploy=docker-ssh일 때만 포함 (#439)
-  const serverDeployDir = join(typeDir, "server-deploy");
-  if (exists(serverDeployDir) && (deployTarget || "docker-ssh") === "docker-ssh") {
+  const serverDeployDir = join(typeDir, SERVER_DEPLOY_DIR);
+  if (exists(serverDeployDir) && serverDeployEnabled(deployTarget)) {
     const { newFiles, unchanged, changed, upstream } = classify(serverDeployDir, workflowsDir, envOpts, baseline);
     for (const f of unchanged) { counters.skipped++; trace?.event("copy", "skipped-unchanged", f, { group: `${type}/server-deploy` }); }
     for (const f of newFiles) { if (counters.skipNew(serverDeployDir, f, `${type}/server-deploy`)) continue; copyFileSync(join(serverDeployDir, f), join(workflowsDir, f)); counters.copied++; counters.copiedFiles.push(f); trace?.event("copy", "copied", f, { group: `${type}/server-deploy` }); }

package/src/core/options-ask.js

@@ -234,7 +234,10 @@ export async function askAllOptionalWorkflows({
       if (askIntent) {
         if (force || !tty || typeof io.select !== "function") {
           // 비대화형: CLI intent 미지정이면 deploy/publish에서 역추론, 그래도 없으면 manual(기존 동작)
-          intent = intent ?? inferIntent(deploy, publish) ?? "manual";
+          // 축이 아직 안 정해졌으면 비대화형(resolve-options.js)과 같은 기본 축으로 추론한다 (#851).
+          // 예전에는 null 로 추론해 "manual" 이 기록되어 같은 레포에서 두 경로의 결과가 갈렸다.
+          const defaultDeploy = applicable.deploy.includes("docker-ssh") ? "docker-ssh" : "none";
+          intent = intent ?? inferIntent(deploy ?? defaultDeploy, publish ?? []) ?? "manual";
         } else {
           say("");
           say(msg("options.intent.intro"));
@@ -394,7 +397,8 @@ export async function askAllOptionalWorkflows({
   //    "배포 브랜치"가 아니다 — 배포가 도는 곳은 기본 브랜치(default) 쪽 개념. #482 참조.
   if (ask("release-branch") || deployBranch === null) {
     if (force || !tty || typeof io.text !== "function") {
-      deployBranch = deployBranch ?? "develop";
+      // 묻지 못했으면 값을 지어내지 않는다 (#851) — 비어 있으면 기록하지 않고 스킬이 develop 으로 폴백한다.
+      deployBranch = deployBranch ?? "";
     } else {
       const base = defaultBranch || "main"; // git으로 감지된 기본 브랜치 (#481 동적 안내)
       say("");
@@ -431,7 +435,7 @@ export async function askAllOptionalWorkflows({
     aiPrSummary: aiPrSummary !== false,
     changelogProvider: changelogProvider ?? "commit",
     changelogBaseUrl: changelogBaseUrl ?? "",
-    deployBranch: deployBranch ?? "develop",
+    deployBranch: deployBranch ?? "",
     deployBranchReady, // #490 — true=존재/생성 확인됨, false=거절/실패, null=확인 안 함
     deployBranchCreated, // #493 — true=이번 실행에서 마법사가 생성, null=확인 안 함
 

package/src/core/orphan-workflows.js

@@ -6,11 +6,12 @@ import { existsSync, renameSync, rmSync, readdirSync } from "node:fs";
 import { join } from "node:path";
 import { PATHS } from "./paths.js";
 import { exists, listYamlFiles } from "./fsutil.js";
+import { commonOptionalGroups, SERVER_DEPLOY_DIR } from "./workflow-groups.js";
 
 // 템플릿의 project-types/<type>/ 인벤토리 — 직하위 + server-deploy/ + publish/*/ (copy 엔진과 동일 범위)
 function typeInventory(projectTypesDir, type) {
   const typeDir = join(projectTypesDir, type);
-  const dirs = [typeDir, join(typeDir, "server-deploy")];
+  const dirs = [typeDir, join(typeDir, SERVER_DEPLOY_DIR)];
   const pubRoot = join(typeDir, "publish");
   if (exists(pubRoot)) {
     for (const e of readdirSync(pubRoot, { withFileTypes: true })) {
@@ -28,30 +29,14 @@ function typeInventory(projectTypesDir, type) {
 // common/ 아래 "선택했을 때만 복사되는" 폴더들 (#566).
 // 켜면 복사 엔진이 넣어주지만, 끄면 이미 있던 파일이 그대로 남아 계속 실행됐다.
 // 축을 끈 사용자에게는 그게 곧 "껐는데 왜 도나"가 된다 — 여기서 고아로 잡는다.
-// deploy는 타겟별 폴더라 선택된 타겟만 살리고 나머지를 대상으로 삼는다.
+// 켜짐/꺼짐은 복사 엔진과 같은 표(workflow-groups.js)에서 읽는다 (#851).
 function commonOptionalOrphans(commonDir, opts) {
-  const { includeSecretBackup = false, aiPrSummary = true, projectsSync = true, deployTarget = "docker-ssh" } = opts;
   const out = [];
-
-  const gated = [
-    ["secret-backup", includeSecretBackup, "secret-backup"],
-    ["pr-summary", aiPrSummary, "pr-summary"],
-    ["projects-sync", projectsSync, "projects-sync"],
-  ];
-  for (const [dir, enabled, label] of gated) {
-    if (enabled) continue;
-    const d = join(commonDir, dir);
+  for (const group of commonOptionalGroups(commonDir, opts)) {
+    if (group.enabled) continue;
+    const d = join(commonDir, group.dir);
     if (!exists(d)) continue;
-    for (const f of listYamlFiles(d)) out.push({ filename: f, type: label });
-  }
-
-  // deploy/<target> — 선택된 타겟 외 폴더는 전부 고아 후보
-  const deployRoot = join(commonDir, "deploy");
-  if (exists(deployRoot)) {
-    for (const e of readdirSync(deployRoot, { withFileTypes: true })) {
-      if (!e.isDirectory() || e.name === deployTarget) continue;
-      for (const f of listYamlFiles(join(deployRoot, e.name))) out.push({ filename: f, type: `deploy/${e.name}` });
-    }
+    for (const f of listYamlFiles(d)) out.push({ filename: f, type: group.orphanLabel });
   }
   return out;
 }

package/src/core/resolve-options.js

@@ -0,0 +1,91 @@
+// 설치 옵션 값을 정하는 단 한 곳 (#851).
+//
+// 예전에는 비대화형(src/index.js)과 대화형(src/commands/interactive.js)이 같은 옵션을
+// 각자 정했다. 그 사이 규칙이 갈라져 대화형에서 PR 요약 선택이 버려지고(aiPrSummary),
+// 질문을 건너뛰는 version 모드가 모바일 단독 레포에 deploy: docker-ssh 를 남겼다.
+// 규칙은 모든 옵션에 같다: CLI 플래그 > version.yml 저장값 > 기본값.
+// 대화형은 이 결과를 초기값으로 쓰고, 사용자가 답한 것만 그 위에 덮어쓴다.
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { applicableTargets, migrateProvider } from "./options-ask.js";
+import { DEFAULT_CODE_REVIEW_CODERABBIT } from "./constants.js";
+import { resolveLabelStyle } from "./label-style.js";
+import { resolveRepoLanguage } from "./repo-language.js";
+
+// 이미 설치돼 있으면 Projects 동기화를 켜진 것으로 보는 기준 파일 (#716)
+export const PROJECTS_SYNC_WORKFLOW = ".github/workflows/PROJECT-COMMON-PROJECTS-SYNC-MANAGER.yaml";
+
+// 타입에 성립하지 않는 축 값을 정리한다 (#498). 모바일 앱·basic 단독은 두 축이 모두 비어
+// intent 도 none 으로 확정된다. 질문을 거친 값에도 같은 규칙을 다시 적용할 수 있게 따로 둔다.
+export function normalizeAxes({ deploy, publish, intent, types }) {
+  const applicable = applicableTargets(types);
+  const outDeploy = deploy !== "none" && !applicable.deploy.includes(deploy) ? "none" : deploy;
+  const outPublish = publish.filter((t) => applicable.publish.includes(t));
+  const noAxes = types.length > 0 && applicable.deploy.length === 0 && applicable.publish.length === 0;
+  return { deploy: outDeploy, publish: outPublish, intent: noAxes ? "none" : intent, applicable };
+}
+
+// flags: parseArgs 결과 중 옵션 관련 값 (없으면 {} — 대화형 초기값)
+// existing: parseExisting 결과 또는 null
+// 반환: { values, sources } — sources 는 trace 가 "왜 이 값인가"를 남길 근거다 (#561).
+export function resolveOptions({ flags = {}, existing = null, types = [], cwd = "." }) {
+  const stored = existing?.options ?? {};
+  const applicable = applicableTargets(types);
+
+  // 프로젝트 성격(#485): CLI --intent → 저장값. deploy/publish 유도의 기준.
+  let intent = flags.intent ?? stored.intent ?? null;
+  // 배포/publish 축(#439): 플래그 → 저장값 → 기본값(적용 가능할 때만 docker-ssh — #498).
+  let deploy = flags.deployTarget ?? stored.deploy
+    ?? (applicable.deploy.includes("docker-ssh") ? "docker-ssh" : "none");
+  let publish = flags.publishTargets ?? stored.publish ?? [];
+  // --intent 를 줬고 해당 축 플래그가 없으면 intent 가 축을 유도한다 (#485 비대화형)
+  if (flags.intent != null) {
+    if ((intent === "library" || intent === "none") && flags.deployTarget == null) deploy = "none";
+    if ((intent === "app" || intent === "none") && flags.publishTargets == null) publish = [];
+  }
+  const before = { deploy, publish: [...publish] };
+  ({ deploy, publish, intent } = normalizeAxes({ deploy, publish, intent, types }));
+
+  const values = {
+    intent, deployTarget: deploy, publishTargets: publish,
+    includeSecretBackup: flags.includeSecretBackup ?? stored.secretBackup ?? false,
+    // #566 — 설정 없이 바로 동작하므로 기본 켜짐
+    aiPrSummary: flags.aiPrSummary ?? stored.aiPrSummary ?? true,
+    // #716 — 설정(Secret, PROJECT_URL) 없는 신규 레포에 깔면 알림만 쌓인다. 이미 깔린 레포는 유지.
+    projectsSync: flags.projectsSync ?? stored.projectsSync ?? existsSync(join(cwd, PROJECTS_SYNC_WORKFLOW)),
+    // #502 — version 모드가 기존 full 통합 기록을 강등하지 않게 (full 이 우세)
+    recordMode: existing?.templateMode === "full" ? "full" : "version",
+    // #456 — 비어 있으면 version.yml 에 쓰지 않는다 (스킬이 develop 으로 폴백). 사용자가 고르거나 플래그로 준 것만 기록.
+    deployBranch: flags.deployBranch || stored.deployBranch || "",
+    // #455 — null 이 흘러 provider:"null" 로 기록되던 버그 방지
+    changelogProvider: migrateProvider(stored.changelogProvider) ?? "commit",
+    changelogBaseUrl: stored.changelogBaseUrl ?? "",
+    codeReviewCoderabbit: flags.codeReviewCoderabbit ?? stored.codeReviewCoderabbit ?? DEFAULT_CODE_REVIEW_CODERABBIT,
+    // #546, #814 — 명시적 false 는 존중, 키가 없으면 신규·기존 모두 켠다
+    semverAuto: stored.semverAuto ?? true,
+    // 마법사가 묻지 않는 값은 저장값만 보존한다 (전체 재생성이라 안 넘기면 사라진다)
+    appRelease: stored.appRelease ?? null,                 // #553
+    excludedWorkflows: stored.excludedWorkflows ?? null,   // #810
+    storeLocales: stored.storeLocales ?? null,             // #829
+    storeLocalesIos: stored.storeLocalesIos ?? null,
+    storeLocalesPlay: stored.storeLocalesPlay ?? null,
+    // #771 — 신규만 켠다. 기존 레포는 키를 만들지 않아 현행 유지
+    closeOnRelease: stored.closeOnRelease ?? (existing ? null : true),
+    // #769, #776 — 신규 en / 기존 ko. 업데이트만으로 기존 레포 문구·라벨이 바뀌지 않는다
+    language: resolveRepoLanguage({ flag: flags.language ?? null, stored: stored.language, existing: !!existing }),
+    labelStyle: resolveLabelStyle({ flag: flags.labelStyle ?? null, stored: stored.labelStyle, existing: !!existing }),
+  };
+
+  const from = (flagVal, storedVal, flagName) =>
+    flagVal != null ? `cli-flag(${flagName})` : (storedVal ? "version.yml(stored value)" : "default");
+  const sources = {
+    intent: flags.intent != null ? "cli-flag(--intent)"
+      : (stored.intent ? "version.yml(stored value)" : "not given, inferred from deploy/publish"),
+    deploy: from(flags.deployTarget, stored.deploy, "--deploy"),
+    publish: from(flags.publishTargets, stored.publish, "--publish"),
+    before, applicable,
+    // 기존 레포에서 semver_auto 가 이번에 처음 켜졌는지 — 완료 화면이 알린다
+    semverAutoNewlyOn: !!existing && stored.semverAuto == null,
+  };
+  return { values, sources };
+}

package/src/core/workflow-groups.js

@@ -0,0 +1,44 @@
+// 선택형 워크플로 그룹의 켜짐/꺼짐을 정하는 단 한 곳 (#851).
+//
+// 예전에는 복사(copy/workflows.js), 충돌 목록(listWorkflowConflicts), 고아 감지(orphan-workflows.js)가
+// 같은 조건을 각자 들고 있었다. 한쪽만 고치면 "켰는데 안 깔림" 또는 "껐는데 계속 돎"이 된다 (#567).
+// 새 조건부 폴더를 만들면 여기에 한 줄을 넣는다. 세 곳이 함께 따라온다.
+import { readdirSync } from "node:fs";
+import { join } from "node:path";
+import { exists } from "./fsutil.js";
+
+// 서버 배포(<type>/server-deploy/)는 docker-ssh 일 때만 깐다 (#439)
+export const SERVER_DEPLOY_DIR = "server-deploy";
+export function serverDeployEnabled(deployTarget) {
+  return (deployTarget || "docker-ssh") === "docker-ssh";
+}
+
+// common/ 아래 선택형 폴더 목록. 순서가 복사 순서다 (기록·요약에 나오는 순서를 바꾸지 않는다).
+//   policy: "bak-replace" — 템플릿과 다르면 .bak 으로 남기고 교체
+//           "new-only"    — 이미 있으면 건드리지 않는다 (secret-backup: 서버 경로를 사용자가 고쳐 쓴다)
+//   copyLabel / orphanLabel — trace 그룹 이름과 고아 안내 이름. 기존 기록과 같게 둔다.
+export function commonOptionalGroups(commonDir, opts = {}) {
+  const { includeSecretBackup = false, aiPrSummary = true, projectsSync = true, deployTarget = "docker-ssh" } = opts;
+  const selectedDeploy = deployTarget || "docker-ssh";
+  const groups = [];
+
+  // deploy/<target> — 타입 비종속 배포 타겟(vercel 등). 고른 타겟 폴더만 켠다.
+  const deployRoot = join(commonDir, "deploy");
+  const deployNames = exists(deployRoot)
+    ? readdirSync(deployRoot, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name)
+    : [];
+  if (!deployNames.includes(selectedDeploy)) deployNames.push(selectedDeploy); // 폴더가 없으면 아래에서 exists 로 걸러진다
+  for (const name of deployNames) {
+    groups.push({ dir: join("deploy", name), enabled: name === selectedDeploy, policy: "bak-replace",
+      copyLabel: "common-deploy", orphanLabel: `deploy/${name}` });
+  }
+  groups.push(
+    // #566 — AI 변경 요약. 설정 없이 바로 동작
+    { dir: "pr-summary", enabled: aiPrSummary === true, policy: "bak-replace", copyLabel: "pr-summary", orphanLabel: "pr-summary" },
+    // #716 — Projects 보드 동기화. Secret·변수를 등록해야 동작해 신규는 기본 꺼짐
+    { dir: "projects-sync", enabled: projectsSync === true, policy: "bak-replace", copyLabel: "projects-sync", orphanLabel: "projects-sync" },
+    // Secret 서버 백업
+    { dir: "secret-backup", enabled: includeSecretBackup === true, policy: "new-only", copyLabel: "secret-backup", orphanLabel: "secret-backup" },
+  );
+  return groups;
+}

package/src/index.js

@@ -19,16 +19,13 @@ import { detectOrphanWorkflows } from "./core/orphan-workflows.js";
 import { createRunTrace, MIGRATION_DIR } from "./core/run-trace.js";
 import { appendGuideEntry } from "./core/migration-guide.js";
 import { resolveProjectPaths, markerForType } from "./core/paths-resolve.js";
-import { applicableTargets, migrateProvider } from "./core/options-ask.js";
-import { DEFAULT_CODE_REVIEW_CODERABBIT } from "./core/constants.js";
+import { resolveOptions } from "./core/resolve-options.js";
 import { printBannerCompact } from "./ui/banner.js";
 import { printSummary } from "./ui/summary.js";
 import { runFull } from "./commands/full.js";
 import { runVersion } from "./commands/version.js";
 import { runWorkflows } from "./commands/workflows.js";
 import { runIssues } from "./commands/issues.js";
-import { resolveLabelStyle } from "./core/label-style.js";
-import { resolveRepoLanguage } from "./core/repo-language.js";
 import { runInteractive } from "./commands/interactive.js";
 import { runSkills } from "./commands/skills.js";
 
@@ -191,86 +188,38 @@ async function runCore(argv, { cwd = process.cwd(), source = { type: "git" }, cl
   const { now, today } = clock || utcNow();
   const tempDir = join(cwd, PATHS.tempDir);
 
-  // 프로젝트 성격(#485): CLI --intent → version.yml 저장값. deploy/publish 유도의 기준.
-  let intent = opts.intent ?? existing?.options?.intent ?? null;
-  // 배포/publish 축(#439): CLI 플래그 최우선 → 저장값 → 기본값(적용 가능할 때만 docker-ssh — #498).
-  //   단 --intent가 명시됐고 해당 축 플래그가 없으면 intent가 유도한다 (#485 비대화형):
-  //   library/none이면 deploy=none, app/none이면 publish=[].
-  const applicable = applicableTargets(types);
-  let deployTarget = opts.deployTarget ?? existing?.options?.deploy
-    ?? (applicable.deploy.includes("docker-ssh") ? "docker-ssh" : "none");
-  let publishTargets = opts.publishTargets ?? existing?.options?.publish ?? [];
-  if (opts.intent != null) {
-    if ((intent === "library" || intent === "none") && opts.deployTarget == null) deployTarget = "none";
-    if ((intent === "app" || intent === "none") && opts.publishTargets == null) publishTargets = [];
-  }
-  // 적용 불가 타겟 조용한 정리 (#498) — 대화형과 동일 규칙. 타입에 성립하지 않는 축 값은
-  // 복사 결과가 동일하므로 경고 없이 none/교집합으로 정리한다 (모바일 앱/basic 단독 등).
-  const beforeCleanup = { deploy: deployTarget, publish: [...publishTargets] };
-  if (deployTarget !== "none" && !applicable.deploy.includes(deployTarget)) deployTarget = "none";
-  publishTargets = publishTargets.filter((t) => applicable.publish.includes(t));
-  if (types.length > 0 && applicable.deploy.length === 0 && applicable.publish.length === 0) intent = "none";
+  // 옵션 값은 resolve-options.js 한 곳에서 정한다 (#851) — 대화형과 같은 규칙.
+  const { values: resolved, sources } = resolveOptions({
+    flags: {
+      intent: opts.intent, deployTarget: opts.deployTarget, publishTargets: opts.publishTargets,
+      includeSecretBackup: opts.includeSecretBackup, aiPrSummary: opts.aiPrSummary, projectsSync: opts.projectsSync,
+      deployBranch: opts.deployBranch, codeReviewCoderabbit: opts.codeReviewCoderabbit,
+      language: opts.language, labelStyle: opts.labelStyle,
+    },
+    existing, types, cwd,
+  });
+  const { intent, deployTarget, publishTargets } = resolved;
+  const { before: beforeCleanup, applicable } = sources;
 
   // 축 확정 근거 (#561) — "왜 이 값인가"가 가장 헷갈리는 자리다.
   // CLI 플래그 / 저장값 / intent 유도 / 타입 적용성 정리 중 무엇이 이겼는지 남긴다.
-  trace.event("resolve", "intent", String(intent ?? "(unset)"), {
-    source: opts.intent != null ? "cli-flag(--intent)"
-      : (existing?.options?.intent ? "version.yml(stored value)" : "not given, inferred from deploy/publish"),
-  });
+  trace.event("resolve", "intent", String(intent ?? "(unset)"), { source: sources.intent });
   trace.event("resolve", "deploy", deployTarget, {
-    source: opts.deployTarget != null ? "cli-flag(--deploy)"
-      : (existing?.options?.deploy ? "version.yml(stored value)" : "default"),
+    source: sources.deploy,
     applicableForTypes: applicable.deploy,
     adjusted: beforeCleanup.deploy !== deployTarget
       ? `${beforeCleanup.deploy} → ${deployTarget} (not applicable to the selected types)` : null,
   });
   trace.event("resolve", "publish", publishTargets.join(",") || "(none)", {
-    source: opts.publishTargets != null ? "cli-flag(--publish)"
-      : (existing?.options?.publish ? "version.yml(stored value)" : "default"),
+    source: sources.publish,
     applicableForTypes: applicable.publish,
     adjusted: beforeCleanup.publish.join(",") !== publishTargets.join(",")
       ? `${beforeCleanup.publish.join(",") || "(none)"} → ${publishTargets.join(",") || "(none)"} (cleaned up, not applicable)` : null,
   });
 
   const context = createContext({
-    mode: opts.mode, force: true, types, version, versionCode, branch,
-    paths,
-    deployTarget,
-    publishTargets,
-    includeSecretBackup: opts.includeSecretBackup ?? existing?.options?.secretBackup ?? false,
-    // #566 — CLI 값 우선, 없으면 저장값 보존, 그것도 없으면 true(설정 없이 바로 동작).
-    aiPrSummary: opts.aiPrSummary ?? existing?.options?.aiPrSummary ?? true,
-    // Projects 보드 동기화(#716): CLI > 저장값 > 이미 설치돼 있으면 유지 > 신규는 제외.
-    // 설정(Secret, PROJECT_URL)이 없는 레포에 설치되면 라벨이 바뀔 때마다 알림만 쌓이기 때문이다.
-    // 이미 설치된 레포가 갱신만으로 연동을 잃지 않도록 파일이 있으면 켜진 것으로 본다.
-    projectsSync: opts.projectsSync ?? existing?.options?.projectsSync
-      ?? existsSync(join(cwd, ".github/workflows/PROJECT-COMMON-PROJECTS-SYNC-MANAGER.yaml")),
-    // #502 — version 모드가 기존 full 통합 기록(mode)을 강등하지 않도록 (full이 우세)
-    recordMode: existing?.templateMode === "full" ? "full" : "version",
-    // 릴리스 배포 브랜치(#456): CLI 플래그 → version.yml 저장값 → 빈 값(미출력, 스킬이 develop 폴백)
-    deployBranch: opts.deployBranch || existing?.options?.deployBranch || "",
-    intent,
-    // changelog/code_review 축(#455): 비대화형은 저장값 → 기본값. null이 흘러 provider:"null"로 기록되던 버그 수정.
-    changelogProvider: migrateProvider(existing?.options?.changelogProvider) ?? "commit",
-    changelogBaseUrl: existing?.options?.changelogBaseUrl ?? "",
-    // 플래그 > 저장값 > 기본(꺼짐). 쓰겠다고 명시하면 켜지고, 아무 말이 없을 때만 기본값이 적용된다.
-    codeReviewCoderabbit: opts.codeReviewCoderabbit ?? existing?.options?.codeReviewCoderabbit ?? DEFAULT_CODE_REVIEW_CODERABBIT,
-    // semver 자동 승격(#546, #814): 저장값(명시적 false 포함)은 존중하고, 키가 없으면 신규·기존 모두 켠다.
-    // 기존 레포에서 처음 켜질 때는 버전이 예고 없이 오르지 않게 완료 화면이 알린다 (semverAutoNewlyOn).
-    semverAuto: existing?.options?.semverAuto ?? true,
-    // 앱 심사 배포 레포 여부(#553): 저장값만 보존한다. 마법사가 묻지 않으므로 새로 켜지 않는다
-    // (사용자가 version.yml에 직접 쓰거나 스킬이 기록한 값을 그대로 유지).
-    appRelease: existing?.options?.appRelease ?? null,
-    excludedWorkflows: existing?.options?.excludedWorkflows ?? null, // #810 저장값 보존
-    storeLocales: existing?.options?.storeLocales ?? null, // #829 저장값 보존 (전체 재생성이라 안 넘기면 사라진다)
-    storeLocalesIos: existing?.options?.storeLocalesIos ?? null,
-    storeLocalesPlay: existing?.options?.storeLocalesPlay ?? null,
-    // 상태 라벨 표기(#776): 플래그 > 저장값 > (신규 en / 기존 ko). 기존 레포의 라벨 이름은 업데이트만으로 바뀌지 않는다.
-    // 릴리스 시 완료 이슈 닫기(#771): 저장값 보존, 없으면 신규만 true. 기존 레포는 키를 만들지 않아 현행 유지.
-    closeOnRelease: existing?.options?.closeOnRelease ?? (existing ? null : true),
-    // 레포 문구 언어(#769): 플래그 > 저장값 > (신규 en / 기존 ko). 기존 레포의 템플릿 언어는 업데이트만으로 바뀌지 않는다.
-    language: resolveRepoLanguage({ flag: opts.language, stored: existing?.options?.language, existing: !!existing }),
-    labelStyle: resolveLabelStyle({ flag: opts.labelStyle, stored: existing?.options?.labelStyle, existing: !!existing }),
+    mode: opts.mode, force: true, types, version, versionCode, branch, paths,
+    ...resolved,
     repoName,
     // 실 resolver 4종 (.sh resolve_token 등가 — spring-app-yml 스텁 제거)
     resolvers: makeResolvers(cwd, repoName, paths),
@@ -382,7 +331,7 @@ async function runCore(argv, { cwd = process.cwd(), source = { type: "git" }, cl
       replacedBak: result?.workflows?.replacedBak ?? [],             // #673 기준점 없이 교체한 파일 안내
       legacyLeftover: migrationsResult?.confirmPending ?? [],         // #809 신·구 세대 동시 실행 안내
       notInstalled: result?.workflows?.notInstalled ?? [],            // #810 깔지 않은 워크플로우 안내
-      semverAutoNewlyOn: !!existing && existing?.options?.semverAuto == null && context.semverAuto === true, // 업데이트가 켠 사실 안내
+      semverAutoNewlyOn: sources.semverAutoNewlyOn && context.semverAuto === true, // 업데이트가 켠 사실 안내
       verification: result?.verification,   // #549 설치 후 검증 결과 (full/workflows 모드에서만 존재)
       // #569 — 고른 것만 안내하려면 선택값이 필요하다
       aiPrSummary: context.aiPrSummary, codeReviewCoderabbit: context.codeReviewCoderabbit,