projectops 4.2.18 → 4.2.20

package/README.md

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "4.2.18",
+  "version": "4.2.20",
   "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/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

@@ -128,10 +128,12 @@ export function printSummary(ctx, targetRoot = ".") {
 
   err("  📖 TEMPLATE REPO: https://github.com/Cassiiopeia/projectops");
   err("  📚 워크플로우 가이드: .github/workflows/project-types/README.md");
-  // #493 — 이번 실행의 마이그레이션 기록 (수동 체크리스트·breaking 조치·AI 메타데이터)
+  // #493 — 이번 실행의 마이그레이션 기록. "뭐가 남았고 AI에게 어떻게 시키는지"가 바로 보이게 행동 유도형으로 안내.
   if (ctx?.migrationGuidePath) {
     err(`  🧭 마이그레이션 가이드: ${ctx.migrationGuidePath}`);
-    err("     (이번 실행의 변경 내역, 수동 확인 체크리스트, AI Agent용 메타데이터가 기록됐습니다)");
+    err("     이번 설치에서 바뀐 내용과 직접 확인해야 할 작업이 이 파일에 정리되어 있습니다.");
+    err("     💡 AI Agent(Claude, Cursor 등)에게 \"마이그레이션 가이드 확인하고");
+    err("        남은 작업 처리해줘\"라고 요청하면 이 문서를 읽고 대신 진행합니다.");
   }
   err("");