projectops 4.2.19 → 4.2.21

package/README.md

@@ -7,7 +7,7 @@
 > 이슈 등록부터 커밋, 보고서, 배포까지. 개발자는 코드만 작성하세요.
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## 최신 버전 : v4.2.18 (2026-07-14)
+## 최신 버전 : v4.2.20 (2026-07-17)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "4.2.19",
+  "version": "4.2.21",
   "description": "ProjectOps — 완전 자동화 GitHub 프로젝트 관리 템플릿 통합 CLI",
   "keywords": [
     "devops",

package/src/commands/interactive.js

@@ -13,7 +13,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 } from "../core/options-ask.js";
+import { askAllOptionalWorkflows, OPTION_AXES, applicableTargets } from "../core/options-ask.js";
 import { createRunTrace } from "../core/run-trace.js";
 import { appendGuideEntry } from "../core/migration-guide.js";
 import { promptEnvPlan } from "../ui/env-plan.js";
@@ -154,7 +154,8 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
       // edit 루프
       let editing = true;
       while (editing) {
-        const what = await io.editMenu({ showOptional });
+        // #498 — 타입에 적용 불가한 배포 축 항목은 메뉴에서 숨김 (타입을 바꾸면 다음 진입부터 다시 노출)
+        const what = await io.editMenu({ showOptional, axes: applicableTargets(types) });
         if (isCancel(what) || what === "done") { editing = false; break; }
         if (what === "type") {
           const t = await io.selectTypes(types);

package/src/core/copy/util.js

@@ -5,6 +5,8 @@ import { readdirSync } from "node:fs";
 import { exists, copyDirSync } from "../fsutil.js";
 
 // 반환: {copied:bool, moduleCount:number}. force가 아니면(비TTY) 스킵.
+// ⚠️ overlay 복사다 — 템플릿에서 삭제/리네임된 구 파일은 여기서 지우지 않는다.
+//    구 util 파일 정리는 migrations registry(util-file 카테고리)가 담당한다 (#500).
 export function copyUtilModules(tempDir, type, { force = false } = {}, targetRoot = ".") {
   const src = join(tempDir, ".github", "util", type);
   if (!exists(src)) return { copied: false, moduleCount: 0 };

package/src/core/migrations/index.js

@@ -10,6 +10,7 @@ const RULES = {
   workflow: workflowRule,
   "root-file": rootFileRule,
   "legacy-dir": legacyDirRule,
+  "util-file": rootFileRule, // #500 — util 모듈 내 폐기 파일: 정확 경로 삭제 (root-file rule 재사용)
 };
 
 // 대상 레포에서 레거시 잔재 감지. 반환: { safe: [entry], confirm: [entry], ask: [entry] }

package/src/core/migrations/registry.js

@@ -5,7 +5,9 @@
 //
 // 항목 스키마:
 //   id         - 고유 식별자 (kebab-case)
-//   category   - "workflow" | "root-file" | "legacy-dir"  (rules/ 폴더의 구현이 detect/apply 담당)
+//   category   - "workflow" | "root-file" | "legacy-dir" | "util-file"  (rules/ 폴더의 구현이 detect/apply 담당)
+//                util-file: .github/util/ 모듈 안의 폐기 파일 — root-file rule 재사용(정확 경로 삭제).
+//                           util 복사(copy/util.js)는 overlay라 구 파일을 지우지 않는다 — 정리는 여기가 유일 경로.
 //   tier       - "safe"    : 신형이 같은 기능을 대체(순수 리네임). 공존 시 이중 트리거 실해
 //                            → 확인 1회 후 자동 무해화(.bak) / 삭제
 //                "confirm" : 배포 파이프라인일 수 있음(그 레포의 유일한 현역 배포 가능성)
@@ -161,4 +163,44 @@ export const MIGRATIONS = [
   { id: "dir-docs-suh-template", category: "legacy-dir", tier: "ask",
     file: "docs/suh-template", replacedBy: "docs/projectops",
     since: "4.2.9", reason: "리브랜딩 — 스킬 산출물(이슈·보고서) 폴더 구명칭. 신 스킬은 docs/projectops/에 저장" },
+
+  // ── util-file / safe — Flutter 마법사 스크립트 Python 단일화 (#500) ──────────
+  // 로컬 실행 도구라 CI 중복 실행 위험은 없지만, 신형 py와 공존 시 사용자가 구 스크립트를
+  // 실행해 갈라진 동작을 볼 수 있다. 마법사 폴더에 사용자 상태가 없어 삭제가 기대 동작.
+  { id: "util-playstore-setup-sh", category: "util-file", tier: "safe",
+    file: ".github/util/flutter/playstore-wizard/playstore-wizard-setup.sh", replacedBy: "playstore-wizard.py",
+    since: "4.3.0", reason: "마법사 스크립트 Python 단일화 — setup 서브커맨드로 대체" },
+  { id: "util-playstore-setup-ps1", category: "util-file", tier: "safe",
+    file: ".github/util/flutter/playstore-wizard/playstore-wizard-setup.ps1", replacedBy: "playstore-wizard.py",
+    since: "4.3.0", reason: "마법사 스크립트 Python 단일화 — setup 서브커맨드로 대체" },
+  { id: "util-playstore-apply-sh", category: "util-file", tier: "safe",
+    file: ".github/util/flutter/playstore-wizard/playstore-wizard-apply.sh", replacedBy: "playstore-wizard.py",
+    since: "4.3.0", reason: "마법사 스크립트 Python 단일화 — apply 서브커맨드로 대체" },
+  { id: "util-playstore-apply-ps1", category: "util-file", tier: "safe",
+    file: ".github/util/flutter/playstore-wizard/playstore-wizard-apply.ps1", replacedBy: "playstore-wizard.py",
+    since: "4.3.0", reason: "마법사 스크립트 Python 단일화 — apply 서브커맨드로 대체" },
+  { id: "util-playstore-detect-sh", category: "util-file", tier: "safe",
+    file: ".github/util/flutter/playstore-wizard/detect-application-id.sh", replacedBy: "playstore-wizard.py",
+    since: "4.3.0", reason: "마법사 스크립트 Python 단일화 — detect-app-id 서브커맨드로 대체" },
+  { id: "util-playstore-detect-ps1", category: "util-file", tier: "safe",
+    file: ".github/util/flutter/playstore-wizard/detect-application-id.ps1", replacedBy: "playstore-wizard.py",
+    since: "4.3.0", reason: "마법사 스크립트 Python 단일화 — detect-app-id 서브커맨드로 대체" },
+  { id: "util-playstore-patch-py", category: "util-file", tier: "safe",
+    file: ".github/util/flutter/playstore-wizard/patch-build-gradle.py", replacedBy: "playstore-wizard.py",
+    since: "4.3.0", reason: "마법사 스크립트 Python 단일화 — 내부 함수로 흡수" },
+  { id: "util-firebase-setup-sh", category: "util-file", tier: "safe",
+    file: ".github/util/flutter/firebase-wizard/firebase-wizard-setup.sh", replacedBy: "firebase-wizard.py",
+    since: "4.3.0", reason: "마법사 스크립트 Python 단일화 — setup 서브커맨드로 대체" },
+  { id: "util-firebase-setup-ps1", category: "util-file", tier: "safe",
+    file: ".github/util/flutter/firebase-wizard/firebase-wizard-setup.ps1", replacedBy: "firebase-wizard.py",
+    since: "4.3.0", reason: "마법사 스크립트 Python 단일화 — setup 서브커맨드로 대체" },
+  { id: "util-firebase-test-sh", category: "util-file", tier: "safe",
+    file: ".github/util/flutter/firebase-wizard/test/setup-script-test.sh", replacedBy: "test/setup-script-test.py",
+    since: "4.3.0", reason: "마법사 테스트 Python 단일화" },
+  { id: "util-firebase-test-ps1", category: "util-file", tier: "safe",
+    file: ".github/util/flutter/firebase-wizard/test/setup-script-test.ps1", replacedBy: "test/setup-script-test.py",
+    since: "4.3.0", reason: "마법사 테스트 Python 단일화" },
+  { id: "util-testflight-setup-sh", category: "util-file", tier: "safe",
+    file: ".github/util/flutter/testflight-wizard/testflight-wizard-setup.sh", replacedBy: "testflight-wizard.py",
+    since: "4.3.0", reason: "마법사 스크립트 Python 단일화 — setup 서브커맨드로 대체" },
 ];

package/src/core/options-ask.js

@@ -56,6 +56,42 @@ export { parseTemplateOptions };
 
 export const DEPLOY_TARGETS = ["docker-ssh", "vercel", "none"];
 export const PUBLISH_TARGETS = ["nexus", "npm", "github-packages"];
+
+// #498 — 타입별 적용 가능 deploy/publish 타겟 선언.
+// 빈 배열 = 그 축이 개념상 성립하지 않는 타입. 모바일 앱(flutter/react-native/expo)은 스토어 배포
+// (Play Store/TestFlight/Firebase 등) 워크플로우가 타입 자체에 항상 포함되므로 서버 deploy 축과
+// 무관하고, 레지스트리 publish 개념도 없다. 두 축이 모두 빈 타입만 선택되면 질문 자체를 스킵한다.
+// 서버형 타입은 현행 선택지 전체를 유지한다 (동작 무변경 — 타입별 세분화는 후속 과제).
+export const TYPE_DEPLOY_TARGETS = {
+  spring: ["docker-ssh", "vercel"],
+  react: ["docker-ssh", "vercel"],
+  node: ["docker-ssh", "vercel"],
+  python: ["docker-ssh", "vercel"],
+  flutter: [],
+  "react-native": [],
+  "react-native-expo": [],
+  basic: [],
+};
+export const TYPE_PUBLISH_TARGETS = {
+  spring: ["nexus", "npm", "github-packages"],
+  react: ["nexus", "npm", "github-packages"],
+  node: ["nexus", "npm", "github-packages"],
+  python: ["nexus", "npm", "github-packages"],
+  flutter: [],
+  "react-native": [],
+  "react-native-expo": [],
+  basic: [],
+};
+
+// 선택된 타입 집합의 합집합으로 적용 가능 타겟 산출 (#498). 'none'은 항상 허용이라 목록에서 제외.
+// 미선언 타입은 보수적으로 전체 허용(질문 유지) — 새 타입 추가 시 위 선언도 함께 넣는 게 원칙.
+export function applicableTargets(types = []) {
+  const deployAll = DEPLOY_TARGETS.filter((t) => t !== "none");
+  return {
+    deploy: deployAll.filter((t) => types.some((ty) => (TYPE_DEPLOY_TARGETS[ty] ?? deployAll).includes(t))),
+    publish: PUBLISH_TARGETS.filter((t) => types.some((ty) => (TYPE_PUBLISH_TARGETS[ty] ?? PUBLISH_TARGETS).includes(t))),
+  };
+}
 // #455 — changelog 생성기 provider. github-ai가 기본(설정 제로). openai/gemini/claude/ollama는 openai 호환 한 갈래.
 export const CHANGELOG_PROVIDERS = ["github-ai", "coderabbit", "openai", "gemini", "claude", "ollama", "commit"];
 
@@ -124,10 +160,12 @@ export async function askAllOptionalWorkflows({
   let deployBranchCreated = null; // #493 — 이번 실행에서 마법사가 직접 생성했는지 (가이드 기록용)
   let intent = current.intent ?? null; // #485 프로젝트 성격 (app/library/both/none/manual)
 
-  // basic 단독 타입은 서버 배포도 라이브러리 publish도 개념상 성립하지 않는다.
-  // 배포/publish 질문을 건너뛰고 none·[]로 조용히 확정한다 (타입 변경 시 재질문됨).
-  // (basic은 "그 외" 폴백이라 항상 단독으로만 존재 — every로 안전 판정)
-  const isBasicOnly = types.length > 0 && types.every((t) => t === "basic");
+  // 두 축이 모두 빈 타입 조합(#498 — basic 단독, flutter 등 모바일 앱 단독)은 서버 배포도
+  // 라이브러리 publish도 개념상 성립하지 않는다. 질문을 전부 건너뛰고 none·[]로 조용히 확정한다
+  // (모바일 스토어 배포는 타입 워크플로우가 항상 포함되므로 안내조차 불필요 — 타입 변경 시 재질문됨).
+  // 구 isBasicOnly 특례를 일반화한 판정이다.
+  const applicable = applicableTargets(types);
+  const noAxes = types.length > 0 && applicable.deploy.length === 0 && applicable.publish.length === 0;
 
   // ① --force-ask가 아니면 version.yml 저장값을 먼저 읽어 재질문을 건너뛴다.
   //    CLI 명시값(current)이 이미 있으면 그쪽이 우선 — 저장값은 빈 자리만 채운다.
@@ -158,9 +196,14 @@ export async function askAllOptionalWorkflows({
     }
   }
 
+  // 적용 불가 타겟 조용한 정리 (#498) — 구버전에서 저장된 무의미 값(예: flutter 단독 + docker-ssh)은
+  // 어차피 복사 결과가 동일하므로 경고 없이 none/교집합으로 정리한다 (SSOT — 무의미 값 잔존 금지).
+  if (deploy !== null && deploy !== "none" && !applicable.deploy.includes(deploy)) deploy = "none";
+  if (Array.isArray(publish)) publish = publish.filter((t) => applicable.publish.includes(t));
+
   // ── ② intent(프로젝트 성격) 우선 분기 → 배포 축 유도 (#485) ──
-  // basic 단독이면 intent 개념 자체가 없어 질문 스킵, none/[]로 확정.
-  if (isBasicOnly) {
+  // 두 축 모두 빈 타입 조합이면 intent 개념 자체가 없어 질문 스킵, none/[]로 확정 (#498).
+  if (noAxes) {
     if (deploy === null) deploy = "none";
     if (publish === null) publish = [];
     intent = "none";
@@ -216,22 +259,28 @@ export async function askAllOptionalWorkflows({
       say("   1) 실행물 배포 — 서버/호스팅에 올려 돌리는 것 (Docker, Vercel …)");
       say("   2) 라이브러리 배포(publish) — 남이 가져다 쓰게 레지스트리에 내는 것 (Nexus, npm …)");
     }
+    // 비대화형/폴백 기본값 (#498) — docker-ssh가 적용 가능할 때만 기본, 아니면 none.
+    const deployDefault = applicable.deploy.includes("docker-ssh") ? "docker-ssh" : "none";
     if (willAskDeploy) {
       if (force || !tty || typeof io.select !== "function") {
-        deploy = deploy ?? "docker-ssh";
+        deploy = deploy ?? deployDefault;
       } else {
         say("");
         say("🚀 (1) 실행물(서버/앱)을 어디에 올리나요?");
         say("   서버·호스팅에 올릴 계획이 있으면 고르고, 없으면 '서버에 올리지 않음'으로 두세요.");
+        // 선택지는 적용 가능 타겟으로 필터링 (#498) — 'none'은 항상 노출.
+        const deployLabels = [
+          { value: "docker-ssh", label: "Docker + SSH 서버 배포 (기본)" },
+          { value: "vercel", label: "Vercel" },
+        ];
         const ans = await io.select({
           message: "실행물 배포 방식을 선택하세요",
           options: [
-            { value: "docker-ssh", label: "Docker + SSH 서버 배포 (기본)" },
-            { value: "vercel", label: "Vercel" },
+            ...deployLabels.filter((o) => applicable.deploy.includes(o.value)),
             { value: "none", label: "서버에 올리지 않음 (빌드 검증만 · 라이브러리는 다음에서 선택)" },
           ],
         });
-        deploy = (!isCancel(ans) && DEPLOY_TARGETS.includes(ans)) ? ans : (deploy ?? "docker-ssh");
+        deploy = (!isCancel(ans) && (ans === "none" || applicable.deploy.includes(ans))) ? ans : (deploy ?? deployDefault);
         say(`실행물 배포: ${deploy}`);
       }
     }
@@ -244,18 +293,20 @@ export async function askAllOptionalWorkflows({
         say("");
         say("📦 (2) 이 프로젝트를 남이 가져다 쓰는 라이브러리로도 배포(publish)하나요?");
         say("   (1) 실행물 배포와 별개입니다. 해당되는 걸 고르고, 라이브러리 배포를 안 하면 아무것도 고르지 말고 Enter.");
+        // 선택지는 적용 가능 타겟으로 필터링 (#498)
+        const publishLabels = [
+          { value: "nexus", label: "사내 Maven(Nexus) 라이브러리 배포" },
+          { value: "npm", label: "공개 npmjs 패키지 배포 (NPM_TOKEN)" },
+          { value: "github-packages", label: "GitHub Packages 라이브러리 배포" },
+        ];
         const ans = await io.multiselect({
           message: "라이브러리 배포 타겟 (없으면 선택 없이 Enter = 배포 안 함)",
-          options: [
-            { value: "nexus", label: "사내 Maven(Nexus) 라이브러리 배포" },
-            { value: "npm", label: "공개 npmjs 패키지 배포 (NPM_TOKEN)" },
-            { value: "github-packages", label: "GitHub Packages 라이브러리 배포" },
-          ],
+          options: publishLabels.filter((o) => applicable.publish.includes(o.value)),
           initialValues: publish ?? [],
           required: false,
         });
         publish = (!isCancel(ans) && Array.isArray(ans))
-          ? ans.filter((t) => PUBLISH_TARGETS.includes(t))
+          ? ans.filter((t) => applicable.publish.includes(t))
           : (publish ?? []);
         say(publish.length ? `라이브러리 배포: ${publish.join(", ")}` : "라이브러리 배포: 안 함");
       }
@@ -351,7 +402,8 @@ export async function askAllOptionalWorkflows({
     current: secretBackup, force, tty, io, forceAsk: ask("secret"), say,
   });
 
-  const finalDeploy = deploy ?? "docker-ssh";
+  // 최종 폴백도 적용 가능 타겟 기준 (#498) — 모바일/basic 조합에서 docker-ssh가 새어 나가지 않게.
+  const finalDeploy = deploy ?? (applicable.deploy.includes("docker-ssh") ? "docker-ssh" : "none");
   const finalPublish = publish ?? [];
   return {
     deploy: finalDeploy, publish: finalPublish, secretBackup: secretBackup === true,

package/src/index.js

@@ -17,6 +17,7 @@ import { detectOrphanWorkflows } from "./core/orphan-workflows.js";
 import { createRunTrace } from "./core/run-trace.js";
 import { appendGuideEntry } from "./core/migration-guide.js";
 import { resolveProjectPaths } from "./core/paths-resolve.js";
+import { applicableTargets } from "./core/options-ask.js";
 import { printBannerCompact } from "./ui/banner.js";
 import { printSummary } from "./ui/summary.js";
 import { runFull } from "./commands/full.js";
@@ -107,15 +108,23 @@ export async function run(argv, { cwd = process.cwd(), source = { type: "git" },
   const tempDir = join(cwd, PATHS.tempDir);
 
   // 프로젝트 성격(#485): CLI --intent → version.yml 저장값. deploy/publish 유도의 기준.
-  const intent = opts.intent ?? existing?.options?.intent ?? null;
-  // 배포/publish 축(#439): CLI 플래그 최우선 → 저장값 → 기본값. 단 --intent가 명시됐고 해당 축 플래그가
-  //   없으면 intent가 유도한다 (#485 비대화형): library/none이면 deploy=none, app/none이면 publish=[].
-  let deployTarget = opts.deployTarget ?? existing?.options?.deploy ?? "docker-ssh";
+  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 단독 등).
+  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";
 
   const context = createContext({
     mode: opts.mode, force: true, types, version, versionCode, branch,

package/src/ui/prompts.js

@@ -32,18 +32,22 @@ export async function confirmProjectMenu() {
 }
 
 // 수정 메뉴 — 어떤 항목을 고칠지. showOptional=full/workflows에서만 nexus/secret 노출.
-export async function editMenu({ showOptional = false } = {}) {
+// axes(#498): applicableTargets(types) 결과 — 적용 불가 축의 항목은 숨긴다 (모바일 앱/basic 단독 등).
+// null이면 기존처럼 전부 노출 (테스트 스텁 하위호환).
+export async function editMenu({ showOptional = false, axes = null } = {}) {
   const options = [
     { value: "type", label: "프로젝트 타입" },
     { value: "version", label: "버전" },
     { value: "branch", label: "기본 브랜치" },
   ];
   if (showOptional) {
-    // #485 — 프로젝트 성격(intent): 재선택 시 배포/publish 축을 재유도한다.
-    options.push({ value: "intent", label: "프로젝트 성격 (배포 유형)" });
+    const hasDeploy = axes == null || axes.deploy.length > 0;
+    const hasPublish = axes == null || axes.publish.length > 0;
+    // #485 — 프로젝트 성격(intent): 재선택 시 배포/publish 축을 재유도한다. 축이 하나도 없으면 무의미 → 숨김.
+    if (hasDeploy || hasPublish) options.push({ value: "intent", label: "프로젝트 성격 (배포 유형)" });
     // #483 — 항목별 격리: 한 축만 골라 그 축만 재질문한다 (통짜 "배포/Publish 방식" 분해)
-    options.push({ value: "deploy", label: "배포 방식 (서버 실행물)" });
-    options.push({ value: "publish", label: "라이브러리 배포(publish) 타겟" });
+    if (hasDeploy) options.push({ value: "deploy", label: "배포 방식 (서버 실행물)" });
+    if (hasPublish) options.push({ value: "publish", label: "라이브러리 배포(publish) 타겟" });
     options.push({ value: "code-review", label: "CodeRabbit 코드 리뷰" });
     options.push({ value: "changelog", label: "릴리스 노트(changelog) 생성기" });
     options.push({ value: "release-branch", label: "릴리스 소스(개발) 브랜치" });

package/src/ui/summary.js

@@ -120,8 +120,9 @@ export function printSummary(ctx, targetRoot = ".") {
   }
   if (types.includes("flutter") && utilModulesCopied > 0) {
     err("  💡 Flutter 배포 마법사 사용법:");
-    err("     • iOS TestFlight: .github/util/flutter/ios-testflight-setup-wizard/index.html");
-    err("     • Android Play Store: .github/util/flutter/android-playstore-setup-wizard/index.html");
+    err("     • iOS TestFlight: .github/util/flutter/testflight-wizard/testflight-wizard.html");
+    err("     • Android Play Store: .github/util/flutter/playstore-wizard/playstore-wizard.html");
+    err("     • Firebase App Distribution: .github/util/flutter/firebase-wizard/firebase-wizard.html");
     err("     • 브라우저에서 열어 필요한 정보 입력 후 파일 생성");
     err("");
   }