projectops 4.2.14 → 4.2.16

package/README.md

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

package/package.json

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

package/src/commands/interactive.js

@@ -11,7 +11,8 @@ import { detectTypes, detectVersion, detectDefaultBranch, detectRepoName, makeRe
 import { parseExisting } from "../core/version-yml.js";
 import { runBreakingCheck } from "../core/breaking-check.js";
 import { runMigrations } from "../core/migrations/index.js";
-import { resolveProjectPaths } from "../core/paths-resolve.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 { promptEnvPlan } from "../ui/env-plan.js";
 import { listWorkflowConflicts } from "../core/copy/workflows.js";
@@ -88,6 +89,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     let changelogProvider = existing?.options?.changelogProvider ?? "github-ai";
     let changelogBaseUrl = existing?.options?.changelogBaseUrl ?? "";
     let deployBranch = existing?.options?.deployBranch ?? "develop"; // #456
+    let deployBranchReady = null; // #490 — 이번 실행에서 개발 브랜치 존재/생성이 확인됐는지
     let intent = existing?.options?.intent ?? null; // #485 프로젝트 성격
     const showOptional = mode === "full" || mode === "workflows";
     const realTty = process.stdout.isTTY === true;
@@ -122,6 +124,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
       changelogProvider = r.changelogProvider;
       changelogBaseUrl = r.changelogBaseUrl;
       deployBranch = r.deployBranch;
+      deployBranchReady = r.deployBranchReady ?? deployBranchReady; // #490
       intent = r.intent;
     }
 
@@ -185,6 +188,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
           changelogProvider = r.changelogProvider;
           changelogBaseUrl = r.changelogBaseUrl;
           deployBranch = r.deployBranch;
+          deployBranchReady = r.deployBranchReady ?? deployBranchReady; // #490
           intent = r.intent;
         }
       }
@@ -196,6 +200,8 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
         root: cwd, types, paths, existingPaths: existing?.paths ?? new Map(),
         force: false, tty: realTty, io: io.engineIo ?? {},
       });
+      // 타입 탈출구 (#487) — 경로 단계에서 제외된 타입은 version.yml·복사·env 전 단계에서 뺀다
+      types = filterExcludedTypes(types, paths);
     } else {
       for (const t of types) if (t !== "basic" && !paths.has(t)) paths.set(t, existing?.paths.get(t) || ".");
     }
@@ -253,6 +259,24 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
       });
     }
 
+    // 고아 타입 워크플로우 정리 (#487) — 타입 변경으로 선택에서 빠진 타입의 잔존 워크플로우
+    if (mode === "full" || mode === "workflows") {
+      const orphans = detectOrphanWorkflows({ tempDir, targetRoot: cwd, selectedTypes: types });
+      if (orphans.length > 0) {
+        io.note?.(
+          orphans.map((o) => `• ${o.filename} (${o.type} 타입 — 현재 미선택)`).join("\n"),
+          `🧹 선택되지 않은 타입의 워크플로우 ${orphans.length}개 발견`,
+        );
+        const yes = await io.askYesNo(`위 ${orphans.length}개를 정리할까요? (.bak 무해화 — 복원 가능)`, true);
+        if (yes === true) {
+          const results = applyOrphanCleanup(cwd, orphans);
+          const ok = results.filter((r) => r.action === "bak");
+          const failed = results.filter((r) => r.action === "error");
+          io.note?.(`✅ 고아 워크플로우 정리: ${ok.length}개${failed.length ? ` (실패 ${failed.length}개)` : ""}`, "정리 완료");
+        }
+      }
+    }
+
     let result = null;
     if (mode === "full") result = runFull(ctx, tempDir, cwd, hooks);
     else if (mode === "version") result = runVersion(ctx, tempDir, cwd);
@@ -264,7 +288,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
 
     // 완료 요약 (.sh print_summary L5438)
     io.summary?.({
-      mode, types, version, deployBranch,
+      mode, types, version, deployBranch, deployBranchReady,
       counters: { workflows: result?.workflows?.copied ?? 0, workflowFiles: result?.workflows?.copiedFiles ?? [], utilModules: 0 },
     }, cwd);
     io.outro?.(`통합 완료 — ${mode} 모드로 설치했습니다.`);

package/src/core/copy/workflows.js

@@ -18,6 +18,17 @@ function configureEnv(targetPath, { type, projectPath = ".", repoName = "", reso
   writeFileSync(targetPath, out);
 }
 
+// util 버전 동기화 워크플로우 (#491) — .github/util/ 모듈(version.json)이 있는 레포에서만 의미가 있다.
+// util이 없는 레포(예: spring 단독)에 복사하면 트리거가 영원히 안 걸리는 no-op 오염이 된다.
+const UTIL_VERSION_SYNC = "PROJECT-COMMON-TEMPLATE-UTIL-VERSION-SYNC.yml";
+
+// 이 통합에서 util 모듈이 존재하게 되는가 — 대상에 이미 있거나(업데이트),
+// 선택 타입의 util이 템플릿에 있어 곧 복사될 예정(runFull 6단계)이면 true.
+function utilSyncApplies(tempDir, targetRoot, types) {
+  if (exists(join(targetRoot, ".github", "util"))) return true;
+  return types.some((t) => exists(join(tempDir, ".github", "util", t)));
+}
+
 // 3분류 (신규/unchanged/changed) — 대상 워크플로우 디렉토리 기준.
 function classify(srcDir, workflowsDir, envOpts) {
   const result = { newFiles: [], unchanged: [], changed: [] };
@@ -62,6 +73,8 @@ export function copyWorkflows(context, tempDir, targetRoot = ".", hooks = {}) {
   const commonDir = join(projectTypesDir, "common");
   if (exists(commonDir)) {
     for (const filename of listYamlFiles(commonDir)) {
+      // #491 — util 동기화 워크플로우는 util 모듈이 있(게 되)는 레포에만 복사
+      if (filename === UTIL_VERSION_SYNC && !utilSyncApplies(tempDir, targetRoot, types)) continue;
       const src = join(commonDir, filename);
       const dst = join(workflowsDir, filename);
       if (existsSync(dst) && isUnchanged(readFileSync(src, "utf8"), readFileSync(dst, "utf8"), envOptsFor("common"))) {

package/src/core/options-ask.js

@@ -16,34 +16,39 @@ import { branchStatus, createBranch, pushBranch } from "./git-branch.js";
 // 개발(배포) 브랜치 존재 확인 + 생성 제안 (#477) — 대화형 전용.
 // 로컬에 없고 원격에도 없(거나 불명이)면 기본 브랜치에서 생성을 제안하고, 생성 후 push 여부도 묻는다.
 // git 미설치·비레포·질문 불가(io.confirm 없음)면 조용히 통과 — 마법사 진행을 막지 않는다.
+// 반환 ready (#490 — 완료 요약이 "브랜치 만들어라" 재지시를 접을지 판단):
+//   true  = 브랜치가 이미 있거나 이번 실행에서 생성함 → 요약에서 생성 안내 불필요
+//   false = 없는데 사용자가 거절/생성 실패 → 안내 유지
+//   null  = 확인 자체를 못 함(비레포·질문 불가) → 안내 유지(보수적)
 export async function ensureDeployBranch({ targetRoot = ".", deployBranch = "", defaultBranch = "", io = {}, say = () => {} }) {
-  if (!deployBranch || typeof io.confirm !== "function") return { created: false, pushed: false };
+  if (!deployBranch || typeof io.confirm !== "function") return { created: false, pushed: false, ready: null };
   const st = branchStatus(targetRoot, deployBranch);
-  if (!st.isRepo || st.local) return { created: false, pushed: false };
+  if (!st.isRepo) return { created: false, pushed: false, ready: null };
+  if (st.local) return { created: false, pushed: false, ready: true };
   if (st.remote === true) {
     say(`ℹ️ '${deployBranch}' 브랜치가 원격에는 있고 로컬에 없습니다 — 필요 시 'git switch ${deployBranch}'로 가져오세요.`);
-    return { created: false, pushed: false };
+    return { created: false, pushed: false, ready: true };
   }
   say(`⚠️ 개발(릴리스 소스) 브랜치 '${deployBranch}'가 없습니다 — 릴리스(${deployBranch}→${defaultBranch || "기본 브랜치"} PR)가 동작하려면 필요합니다.`);
   const mk = await io.confirm({ message: `${defaultBranch || "현재"} 브랜치에서 '${deployBranch}' 브랜치를 만들까요?`, initialValue: true });
   if (mk !== true) {
     say(`→ 건너뜁니다. 나중에 직접: git checkout -b ${deployBranch} && git push -u origin ${deployBranch}`);
-    return { created: false, pushed: false };
+    return { created: false, pushed: false, ready: false };
   }
   if (!createBranch(targetRoot, deployBranch, defaultBranch)) {
     say(`⚠️ 브랜치 생성 실패 — 직접 실행해주세요: git branch ${deployBranch}${defaultBranch ? ` ${defaultBranch}` : ""}`);
-    return { created: false, pushed: false };
+    return { created: false, pushed: false, ready: false };
   }
   say(`✅ 로컬 브랜치 '${deployBranch}' 생성 완료 (checkout은 하지 않았습니다)`);
   // #481 — push 질문에 브랜치명 명시 ("어느 브랜치를 push하는지" 불명확 방지)
   const up = await io.confirm({ message: `원격(origin)에 '${deployBranch}' 브랜치도 push할까요?`, initialValue: true });
-  if (up !== true) return { created: true, pushed: false };
+  if (up !== true) return { created: true, pushed: false, ready: true };
   if (pushBranch(targetRoot, deployBranch)) {
     say(`✅ origin/${deployBranch} push 완료`);
-    return { created: true, pushed: true };
+    return { created: true, pushed: true, ready: true };
   }
   say(`⚠️ push 실패(자격/네트워크) — 직접 실행해주세요: git push -u origin ${deployBranch}`);
-  return { created: true, pushed: false };
+  return { created: true, pushed: false, ready: true };
 }
 
 // 재노출 — 파서 본체는 version-yml.js에 있다 (순환 import 방지: options-ask → version-yml 방향만 허용)
@@ -115,6 +120,7 @@ export async function askAllOptionalWorkflows({
   let changelogProvider = current.changelogProvider ?? null;
   let changelogBaseUrl = current.changelogBaseUrl ?? null;
   let deployBranch = current.deployBranch ?? null; // #456 릴리스 PR head 브랜치
+  let deployBranchReady = null; // #490 — 이번 실행에서 브랜치 존재/생성이 확인됐는지 (null=확인 안 함)
   let intent = current.intent ?? null; // #485 프로젝트 성격 (app/library/both/none/manual)
 
   // basic 단독 타입은 서버 배포도 라이브러리 publish도 개념상 성립하지 않는다.
@@ -328,7 +334,9 @@ export async function askAllOptionalWorkflows({
       deployBranch = (typeof ans === "string" && !isCancel(ans) && ans.trim()) ? ans.trim() : (deployBranch ?? "develop");
       say(`개발(릴리스 소스) 브랜치: ${deployBranch}`);
       // 브랜치 존재 확인 + 생성 제안 (#477) — 없으면 릴리스 파이프라인이 조용히 놀게 된다
-      await ensureDeployBranch({ targetRoot, deployBranch, defaultBranch, io, say });
+      // #490 — 결과(ready)를 완료 요약에 전달해 이미 생성/확인한 브랜치를 재지시하지 않는다
+      const br = await ensureDeployBranch({ targetRoot, deployBranch, defaultBranch, io, say });
+      deployBranchReady = br.ready;
     }
   }
 
@@ -349,6 +357,8 @@ export async function askAllOptionalWorkflows({
     changelogProvider: changelogProvider ?? "github-ai",
     changelogBaseUrl: changelogBaseUrl ?? "",
     deployBranch: deployBranch ?? "develop",
+    deployBranchReady, // #490 — true=존재/생성 확인됨, false=거절/실패, null=확인 안 함
+
     // #485 intent — 확정값 우선, 없으면 최종 deploy/publish에서 역추론(basic·비대화형 경로 보정)
     intent: intent ?? inferIntent(finalDeploy, finalPublish) ?? "manual",
   };

package/src/core/orphan-workflows.js

@@ -0,0 +1,64 @@
+// 고아 타입 워크플로우 감지·정리 (#487) — 타입 변경으로 선택에서 빠진 타입의
+// 템플릿 워크플로우를 감지해 .bak 무해화한다 (레거시 마이그레이션과 동일 방식).
+// 안전 원칙: 템플릿 인벤토리와 "정확한 파일명 일치"만 대상 — prefix 매칭 금지
+// (사용자 커스텀 워크플로우 오살 방지). common/은 타입이 아니므로 순회에서 제외.
+import { existsSync, renameSync, rmSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { PATHS } from "./paths.js";
+import { exists, listYamlFiles } from "./fsutil.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 pubRoot = join(typeDir, "publish");
+  if (exists(pubRoot)) {
+    for (const e of readdirSync(pubRoot, { withFileTypes: true })) {
+      if (e.isDirectory()) dirs.push(join(pubRoot, e.name));
+    }
+  }
+  const files = new Set();
+  for (const d of dirs) {
+    if (!exists(d)) continue;
+    for (const f of listYamlFiles(d)) files.add(f);
+  }
+  return files;
+}
+
+// 선택 안 된 타입의 템플릿 워크플로우가 대상 레포에 실재하면 고아로 반환.
+export function detectOrphanWorkflows({ tempDir, targetRoot = ".", selectedTypes = [] }) {
+  const projectTypesDir = join(tempDir, PATHS.workflowsDir, PATHS.projectTypesDir);
+  if (!exists(projectTypesDir)) return [];
+  const selected = new Set(selectedTypes);
+  // 선택된 타입이 쓰는 파일명 집합 — 교차 방어 (파일명은 타입 prefix로 유일하지만 안전망)
+  const keep = new Set();
+  for (const t of selected) for (const f of typeInventory(projectTypesDir, t)) keep.add(f);
+  const workflowsDir = join(targetRoot, PATHS.workflowsDir);
+  const orphans = [];
+  for (const e of readdirSync(projectTypesDir, { withFileTypes: true })) {
+    if (!e.isDirectory() || e.name === "common" || selected.has(e.name)) continue;
+    for (const f of typeInventory(projectTypesDir, e.name)) {
+      if (keep.has(f)) continue;
+      if (existsSync(join(workflowsDir, f))) orphans.push({ filename: f, type: e.name });
+    }
+  }
+  return orphans.sort((a, b) => a.filename.localeCompare(b.filename));
+}
+
+// .bak 무해화 실행기 — 부분 실패 허용 (migrations applySafeMigrations와 동일 원칙).
+export function applyOrphanCleanup(targetRoot, orphans) {
+  const workflowsDir = join(targetRoot, PATHS.workflowsDir);
+  const results = [];
+  for (const { filename } of orphans) {
+    try {
+      const src = join(workflowsDir, filename);
+      const bak = `${src}.bak`;
+      if (existsSync(bak)) rmSync(bak, { force: true }); // Windows rename은 대상 존재 시 실패
+      renameSync(src, bak);
+      results.push({ filename, action: "bak" });
+    } catch (err) {
+      results.push({ filename, action: "error", error: err.message });
+    }
+  }
+  return results;
+}

package/src/core/paths-resolve.js

@@ -181,7 +181,9 @@ export async function resolveProjectPaths({
       continue;
     }
 
-    // ── ⑤-b 대화형: 후보 개수별 분기 (.sh L1492~1525) ──
+    // ── ⑤-b 대화형: 후보 개수별 분기 (.sh L1492~1525) + 타입 탈출구 (#487) ──
+    const EXCLUDE = "이 타입 제외"; // 센티넬 — 한국어 value로 노출 (기존 "직접 입력" 패턴)
+    let excluded = false;
     if (candidates.length === 1) {
       const cand = candidates[0];
       const candMarker = existingMarkerInDir(t, cand === "." ? root : join(root, cand));
@@ -189,31 +191,38 @@ export async function resolveProjectPaths({
       say("");
       say(`  ${prog} 🔍 ${t} — ${candMarker} 발견`);
       say(`      위치: <레포루트>/${candFull}`);
-      // '아니오'/취소 시 chosen 미설정 → 아래 직접입력 루프로
-      const ok = await io.confirm({
-        message: `  ${t} 프로젝트 루트를 '${cand}'(으)로 설정할까요? (${candFull} 기준 — 아니오 선택 시 직접 입력)`,
-        initialValue: true,
+      const sel = await io.select({
+        message: `  ${t} 프로젝트 루트를 '${cand}'(으)로 설정할까요?`,
+        options: [
+          { value: cand, label: `예 — '${cand}' 사용 (${candFull} 기준)` },
+          { value: "직접 입력", label: "아니오 — 경로 직접 입력" },
+          { value: EXCLUDE, label: `이 타입 아님 — ${t} 설치 대상에서 제외` },
+        ],
       });
-      if (ok === true) chosen = cand;
+      if (sel === EXCLUDE) excluded = true;
+      else if (!isCancel(sel) && sel != null && sel !== "직접 입력") chosen = sel;
+      // ESC/직접 입력 → 아래 직접입력 루프로
     } else if (candidates.length > 1) {
       say("");
       say(`  ${prog} 🔍 ${t}: 경로 후보 ${candidates.length}개 발견`);
-      // 후보들 + '직접 입력' 메뉴 — value 자체를 한국어로 (센티넬 노출 방지, .sh L1508~1521)
+      // 후보들 + '직접 입력'/'이 타입 제외' 메뉴 — value 자체를 한국어로 (센티넬 노출 방지, .sh L1508~1521)
       const options = candidates.map((c) => ({
         value: c,
         label: `${c} (${existingMarkerInDir(t, c === "." ? root : join(root, c))})`,
       }));
       options.push({ value: "직접 입력", label: "직접 입력" });
+      options.push({ value: EXCLUDE, label: `이 타입 아님 — ${t} 설치 대상에서 제외` });
       const sel = await io.select({ message: `  ${t} 프로젝트 루트를 선택하세요`, options });
       // ESC(취소)도 직접 입력으로 폴백 (.sh `|| _sel="직접 입력"`)
-      if (!isCancel(sel) && sel != null && sel !== "직접 입력") chosen = sel;
+      if (sel === EXCLUDE) excluded = true;
+      else if (!isCancel(sel) && sel != null && sel !== "직접 입력") chosen = sel;
     } else {
       say("");
       say(`  ⚠️ ${prog} ${t}: 프로젝트를 찾지 못했습니다 (maxdepth 3).`);
     }
 
-    // ── 직접 입력 루프 (위에서 미확정 시, .sh L1528~1553) ──
-    while (!chosen) {
+    // ── 직접 입력 루프 (위에서 미확정 시, .sh L1528~1553) — 제외 탈출구 포함 (#487) ──
+    while (!chosen && !excluded) {
       const hintMarker = existingMarkerInDir(t, root);
       let prompt = `  ${t} 프로젝트 루트 경로 입력 (${hintMarker} 이 있는 폴더, 예: server, app — 루트면 그냥 Enter`;
       if (existing) prompt += `, 현재값: ${existing}`;
@@ -229,11 +238,25 @@ export async function resolveProjectPaths({
         chosen = input;
       } else {
         say(`  ⚠️ ${input}/${m} 파일이 없습니다.`);
-        const forceOk = await io.confirm({ message: "  그래도 이 경로를 사용할까요?", initialValue: false });
-        if (forceOk === true) chosen = input;
+        const act = await io.select({
+          message: "  어떻게 할까요?",
+          options: [
+            { value: "retry", label: "다시 입력" },
+            { value: "force", label: `그래도 '${input}' 경로 사용` },
+            { value: EXCLUDE, label: `이 타입 아님 — ${t} 설치 대상에서 제외` },
+          ],
+        });
+        if (act === "force") chosen = input;
+        else if (act === EXCLUDE) excluded = true;
+        // retry/ESC → 루프 계속
       }
     }
 
+    if (excluded) {
+      say(`  ➖ ${t} 제외 — 이 타입은 버전 동기화·워크플로우 설치 대상에서 빠집니다`);
+      continue;
+    }
+
     result.set(t, chosen);
     say(`  ✅ ${t} → ${chosen}`);
   }
@@ -259,3 +282,10 @@ export async function resolveProjectPaths({
   say("");
   return result;
 }
+
+// 경로 단계에서 제외된 타입 반영 (#487) — basic이 아니면서 paths에 없는 타입 제거.
+// 전부 제외되면 basic 폴백 (타입 0개 상태 금지). 비대화형은 제외가 불가능하므로 no-op.
+export function filterExcludedTypes(types, paths) {
+  const kept = types.filter((t) => t === "basic" || paths.has(t));
+  return kept.length ? kept : ["basic"];
+}

package/src/core/wizard-env.js

@@ -41,6 +41,13 @@ export function resolveToken(name, type, resolvers = {}) {
   return typeof fn === "function" ? (fn(type) ?? "") : "";
 }
 
+// 잔여 전역 토큰 치환 (.sh 3347~3351) — 파일 본문·수집값(#489)·카드 표시가 전부 같은 규칙을 쓴다.
+// 파일에 실제 써지는 값과 version.yml deploy 블록 기억값이 어긋나지 않게 하는 단일 지점.
+export function resolveGlobalTokens(s, repoName = "") {
+  if (typeof s !== "string" || (!s.includes("__PROJECT_NAME__") && !s.includes("__APP_ARTIFACT_NAME__"))) return s;
+  return s.replaceAll("__PROJECT_NAME__", repoName).replaceAll("__APP_ARTIFACT_NAME__", repoName);
+}
+
 // 파일 전체 치환 (configure_workflow_env 등가).
 // content: 원본 워크플로우 텍스트. 반환: 치환된 텍스트.
 // opts:
@@ -70,16 +77,16 @@ export function substituteEnv(content, opts = {}) {
       if (chosen != null && chosen !== "" && !useDefaults) val = chosen;
       else val = def;
       // ask 키만 수집 (.sh wf_deploy_set — auto는 저장 안 함). deploy 블록용.
-      if (collectAsks) collectAsks.set(p.key, val);
+      // #489 — 파일 본문은 아래 전역 토큰 치환을 거치므로 수집값도 동일 치환해
+      //        version.yml deploy 블록이 설치본과 항상 바이트 일치하게 한다.
+      if (collectAsks) collectAsks.set(p.key, resolveGlobalTokens(val, repoName));
     }
     lines[i] = setEnvLine(lines[i], p.key, val);
   }
   let out = lines.join(usesCRLF ? "\r\n" : "\n");
 
   // 잔여 전역 토큰 (.sh 3347~3351)
-  if (out.includes("__PROJECT_NAME__") || out.includes("__APP_ARTIFACT_NAME__")) {
-    out = out.replaceAll("__PROJECT_NAME__", repoName).replaceAll("__APP_ARTIFACT_NAME__", repoName);
-  }
+  out = resolveGlobalTokens(out, repoName);
 
   // paths-anchor (.sh 3353~3360): 경로가 '.'이 아니면 주석 라인 전체를 paths 라인으로 교체
   if (PATHS_ANCHOR_RE.test(out) && projectPath && projectPath !== ".") {

package/src/index.js

@@ -13,6 +13,7 @@ import { detectTypes, detectVersion, detectDefaultBranch, detectRepoName, makeRe
 import { parseExisting } from "./core/version-yml.js";
 import { runBreakingCheck } from "./core/breaking-check.js";
 import { runMigrations } from "./core/migrations/index.js";
+import { detectOrphanWorkflows } from "./core/orphan-workflows.js";
 import { resolveProjectPaths } from "./core/paths-resolve.js";
 import { printBannerCompact } from "./ui/banner.js";
 import { printSummary } from "./ui/summary.js";
@@ -150,6 +151,14 @@ export async function run(argv, { cwd = process.cwd(), source = { type: "git" },
       await runMigrations({ targetRoot: cwd });
     }
 
+    // 고아 타입 워크플로우 안내 (#487) — 비대화형은 자동 무해화 금지(배포 파이프라인일 수 있음), 안내만
+    if (opts.mode === "full" || opts.mode === "workflows") {
+      const orphans = detectOrphanWorkflows({ tempDir, targetRoot: cwd, selectedTypes: types });
+      for (const o of orphans) {
+        console.error(`⚠️ 선택되지 않은 타입(${o.type})의 워크플로우가 남아있습니다: ${o.filename} — 대화형 마법사(npx projectops)에서 정리할 수 있습니다.`);
+      }
+    }
+
     switch (opts.mode) {
       case "full": result = runFull(context, tempDir, cwd); break;
       case "version": result = runVersion(context, tempDir, cwd); break;

package/src/ui/env-plan.js

@@ -8,7 +8,7 @@ import { readFileSync } from "node:fs";
 import { stdin, stderr } from "node:process";
 import { PATHS } from "../core/paths.js";
 import { exists, listYamlFiles } from "../core/fsutil.js";
-import { parseWizardLine, resolveToken } from "../core/wizard-env.js";
+import { parseWizardLine, resolveToken, resolveGlobalTokens } from "../core/wizard-env.js";
 import { loadWizardPrompts, wfField, workflowDisplayName } from "../core/wizard-labels.js";
 import * as engine from "./readline-engine.js";
 
@@ -39,7 +39,7 @@ export function scopeString(usages = []) {
 // 반환: { keys:[], defaults:Map<key,default>, typeDefaults:Map<"type|key",default>,
 //        usages:Map<key,[{type,workflowName}]> }
 export function collectAsks(tempDir, types = [], opts = {}) {
-  const { resolvers = {}, deployTarget = "docker-ssh", publishTargets = [], prompts = null } = opts;
+  const { resolvers = {}, deployTarget = "docker-ssh", publishTargets = [], prompts = null, repoName = "" } = opts;
   const baseDir = join(tempDir, PATHS.workflowsDir, PATHS.projectTypesDir);
   const keys = [];
   const defaults = new Map();
@@ -64,9 +64,13 @@ export function collectAsks(tempDir, types = [], opts = {}) {
           const p = parseWizardLine(line); // KEY 정규식 [A-Z_]+ (.sh와 동일)
           if (!p || p.action !== "ask") continue;
           // 타입별 기본값: @접두면 resolver 해석, 아니면 리터럴 (.sh _type_default 등가)
-          const typeDefault = p.arg.startsWith("@")
-            ? resolveToken(p.arg.slice(1), type, resolvers)
-            : p.arg;
+          // #489 — __PROJECT_NAME__ 등 전역 토큰은 카드 표시 전에 미리 해석한다.
+          //        설치본(파일 복사 시 전역 치환)과 동일한 값을 보여주지 않으면
+          //        사용자가 "리터럴이 그대로 박히나?" 오해하게 된다.
+          const typeDefault = resolveGlobalTokens(
+            p.arg.startsWith("@") ? resolveToken(p.arg.slice(1), type, resolvers) : p.arg,
+            repoName,
+          );
           typeDefaults.set(`${type}|${p.key}`, typeDefault);
           if (!defaults.has(p.key)) { keys.push(p.key); defaults.set(p.key, typeDefault); }
           const list = usages.get(p.key) || [];
@@ -140,7 +144,7 @@ export async function promptEnvPlan({
   deployTarget = "docker-ssh", publishTargets = [], targetRoot = ".", repoName = "", log = defaultLog,
 } = {}) {
   const prompts = loadWizardPrompts(targetRoot, tempDir);
-  const asks = collectAsks(tempDir, types, { resolvers, deployTarget, publishTargets, prompts });
+  const asks = collectAsks(tempDir, types, { resolvers, deployTarget, publishTargets, prompts, repoName });
   const defaults = asks.defaults;
 
   // 수집 키 0개 → 질문 자체가 없음 (.sh `[ ${#WF_ASK_KEYS[@]} -eq 0 ]` 등가)

package/src/ui/summary.js

@@ -9,6 +9,7 @@ const SEPARATOR = "────────────────────
 export function printSummary(ctx, targetRoot = ".") {
   const { mode, types = [], version = "", counters = {} } = ctx || {};
   const deployBranchName = ctx?.deployBranch || "develop"; // #477 — 설정된 배포 브랜치명으로 안내
+  const deployBranchReady = ctx?.deployBranchReady === true; // #490 — 마법사가 이번 실행에서 존재/생성 확인함
   const err = (s = "") => process.stderr.write(`${s}\n`);
   // 색상은 TTY일 때만 (.sh YELLOW/CYAN/NC 등가)
   const isTty = !!process.stderr.isTTY;
@@ -139,8 +140,13 @@ export function printSummary(ctx, targetRoot = ".") {
   err("     → Secret Name: _GITHUB_PAT_TOKEN");
   err("     → Scopes: repo, workflow");
   err("");
-  err(`  2️⃣  ${deployBranchName} 브랜치 생성 (아직 없다면)`);
-  err(`     → git checkout -b ${deployBranchName} && git push -u origin ${deployBranchName}`);
+  // #490 — 마법사가 브랜치를 직접 생성(또는 존재 확인)했으면 같은 작업을 재지시하지 않는다
+  if (deployBranchReady) {
+    err(`  2️⃣  ✅ ${deployBranchName} 브랜치 준비 완료 — 마법사가 확인·생성했습니다 (추가 작업 불필요)`);
+  } else {
+    err(`  2️⃣  ${deployBranchName} 브랜치 생성 (아직 없다면)`);
+    err(`     → git checkout -b ${deployBranchName} && git push -u origin ${deployBranchName}`);
+  }
   err("");
   err("  3️⃣  CodeRabbit 활성화 (코드 리뷰를 켰다면)");
   err("     → https://coderabbit.ai 로그인 → GitHub 앱 설치 → 이 저장소에 접근 권한(grant access) 부여");