projectops 4.2.14 → 4.2.15

package/README.md

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "4.2.14",
+  "version": "4.2.15",
   "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";
@@ -196,6 +197,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 +256,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);

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/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;