projectops 4.2.13 → 4.2.15

package/README.md

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

package/package.json

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

package/src/cli/args.js

@@ -3,6 +3,7 @@ import { VALID_TYPES } from "../context.js";
 
 export const DEPLOY_TARGETS = ["docker-ssh", "vercel", "none"];
 export const PUBLISH_TARGETS = ["nexus", "npm", "github-packages"];
+export const INTENT_VALUES = ["app", "library", "both", "none", "manual"];
 
 // argv(process.argv.slice(2)) → 파싱 결과. 오류 시 throw(호출부에서 exit 1).
 export function parseArgs(argv) {
@@ -14,6 +15,7 @@ export function parseArgs(argv) {
     deployTarget: null,      // 배포 축 (#439): docker-ssh|vercel|none, null=미설정
     publishTargets: null,    // publish 축 (#439): 타겟 배열, null=미설정
     deployBranch: "",        // 릴리스 PR head 브랜치 (#456): --deploy-branch, 빈 값=미지정
+    intent: null,            // 프로젝트 성격 (#485): --intent app|library|both|none|manual, null=미설정(역추론)
     includeSecretBackup: null,
     pathsCsv: "",            // "flutter=app,react=client" 원문 (정규화는 resolve 단계)
     force: false,
@@ -79,6 +81,15 @@ export function parseArgs(argv) {
         if (v) result.deployBranch = v;
         break;
       }
+      case "--intent": {
+        // 프로젝트 성격 (#485). 미지정이면 --deploy/--publish에서 역추론.
+        const v = (args.shift() ?? "").trim();
+        if (!INTENT_VALUES.includes(v)) {
+          throw new CliError(`--intent 값은 ${INTENT_VALUES.join(" | ")} 중 하나여야 합니다: '${v}'`);
+        }
+        result.intent = v;
+        break;
+      }
       // ── deprecated alias (1 minor 유지 — #439) ──
       case "--nexus":
         process.stderr.write("⚠️  --nexus는 deprecated입니다. --publish nexus --deploy none 을 사용하세요.\n");

package/src/cli/help.js

@@ -13,6 +13,8 @@ export const HELP_TEXT = `projectops — GitHub 프로젝트 자동화 템플릿
                            (next는 react로 흡수됨 — Next.js 프로젝트는 react 사용)
       --project-version V  통합 대상의 초기 버전 (예: 1.0.0). 미지정 시 자동 감지
       --paths "t=p,..."    타입별 프로젝트 경로 (모노레포). 예: flutter=app,react=client
+      --intent KIND        프로젝트 성격(#485): app | library | both | none | manual
+                           (미지정 시 --deploy/--publish에서 역추론. library/none→deploy 제외, app/none→publish 제외)
       --deploy TARGET      배포 방식 택1: docker-ssh(기본) | vercel | none
       --publish CSV        publish 타겟 csv: nexus,npm,github-packages (기본: 없음)
       --deploy-branch NAME 릴리스 PR head 브랜치 (#456, 기본: develop). default_branch와 별개

package/src/commands/full.js

@@ -24,7 +24,7 @@ export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
     force = true, now, today, templateVersion = "unknown",
     deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false,
     changelogProvider = "github-ai", changelogBaseUrl = "", codeReviewCoderabbit = true,
-    deployBranch = "" } = context;
+    deployBranch = "", intent = null } = context;
 
   // project_paths 마커 계산 (.sh existing_marker_in_dir 등가 — 대표 마커명)
   const pathMarkers = new Map();
@@ -41,7 +41,7 @@ export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
       version, types, paths, pathMarkers, branch, deployBranch, versionCode, now, today,
       deployValues,
       templateOptions: { templateVersion, deployTarget, publishTargets, includeSecretBackup, optionsDate: today,
-        changelogProvider, changelogBaseUrl, codeReviewCoderabbit },
+        changelogProvider, changelogBaseUrl, codeReviewCoderabbit, intent },
     }));
 
   // 2. README 버전 섹션

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 intent = existing?.options?.intent ?? null; // #485 프로젝트 성격
     const showOptional = mode === "full" || mode === "workflows";
     const realTty = process.stdout.isTTY === true;
 
@@ -104,6 +106,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
           changelogProvider: existing?.options?.changelogProvider ?? null,
           changelogBaseUrl: existing?.options?.changelogBaseUrl ?? null,
           deployBranch: existing?.options?.deployBranch ?? null,
+          intent: existing?.options?.intent ?? null,
         },
         force: false, tty: realTty,
         io: {
@@ -120,6 +123,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
       changelogProvider = r.changelogProvider;
       changelogBaseUrl = r.changelogBaseUrl;
       deployBranch = r.deployBranch;
+      intent = r.intent;
     }
 
     // 확인/수정 루프 — ESC는 '머무르기' (.sh L1877~1881: 명시적 '아니오'만 종료)
@@ -165,7 +169,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,
+              codeReviewCoderabbit, changelogProvider, changelogBaseUrl, deployBranch, intent,
             },
             force: false, tty: realTty, forceAsk: true, scope: [what],
             io: {
@@ -182,6 +186,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
           changelogProvider = r.changelogProvider;
           changelogBaseUrl = r.changelogBaseUrl;
           deployBranch = r.deployBranch;
+          intent = r.intent;
         }
       }
     }
@@ -192,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) || ".");
     }
@@ -211,7 +218,7 @@ 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,
+      codeReviewCoderabbit, changelogProvider, changelogBaseUrl, deployBranch, intent,
       repoName, templateVersion, resolvers, envValues, envUseDefaults, now, today,
     });
     ctx.templateVersion = templateVersion;
@@ -249,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/context.js

@@ -24,6 +24,7 @@ export function createContext(overrides = {}) {
     changelogBaseUrl: null,  // ollama일 때만 값
     codeReviewCoderabbit: null,
     deployBranch: "",        // 릴리스 PR head 브랜치 (#456). 빈 값=metadata.deploy_branch 미출력
+    intent: null,            // 프로젝트 성격 (#485 — app/library/both/none/manual). null=미설정(역추론)
     templateVersion: "",
     tempDir: "",
     deployValues: new Map(), // "type.KEY" -> value

package/src/core/options-ask.js

@@ -10,7 +10,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { listYamlFiles } from "./fsutil.js";
 import { PATHS } from "./paths.js";
-import { parseTemplateOptions } from "./version-yml.js";
+import { parseTemplateOptions, inferIntent } from "./version-yml.js";
 import { branchStatus, createBranch, pushBranch } from "./git-branch.js";
 
 // 개발(배포) 브랜치 존재 확인 + 생성 제안 (#477) — 대화형 전용.
@@ -87,7 +87,12 @@ async function askOptionalWorkflow({ dir, icon, short, desc, current, force, tty
 }
 
 // 옵션 질문의 축 키 (#483 수정 스코프 단위) — 수정 메뉴가 이 단위로 한 축만 재질문한다.
-export const OPTION_AXES = ["deploy", "publish", "code-review", "changelog", "release-branch", "secret"];
+// intent(#485)는 프로젝트 성격 — 재질문 시 deploy/publish 축을 재유도한다.
+export const OPTION_AXES = ["intent", "deploy", "publish", "code-review", "changelog", "release-branch", "secret"];
+
+// intent → 어떤 배포 축을 물을지 (#485). manual은 둘 다(기존 순차 질문), 나머지는 유도.
+const INTENT_ASKS_DEPLOY = { app: true, both: true, manual: true, library: false, none: false };
+const INTENT_ASKS_PUBLISH = { library: true, both: true, manual: true, app: false, none: false };
 
 // 배포/publish 축 + Secret 백업을 순서대로 질문 (.sh ask_all_optional_workflows 등가).
 // tempDir: 템플릿 다운로드 루트 — project-types는 {tempDir}/.github/workflows/project-types
@@ -110,6 +115,7 @@ export async function askAllOptionalWorkflows({
   let changelogProvider = current.changelogProvider ?? null;
   let changelogBaseUrl = current.changelogBaseUrl ?? null;
   let deployBranch = current.deployBranch ?? null; // #456 릴리스 PR head 브랜치
+  let intent = current.intent ?? null; // #485 프로젝트 성격 (app/library/both/none/manual)
 
   // basic 단독 타입은 서버 배포도 라이브러리 publish도 개념상 성립하지 않는다.
   // 배포/publish 질문을 건너뛰고 none·[]로 조용히 확정한다 (타입 변경 시 재질문됨).
@@ -140,24 +146,68 @@ export async function askAllOptionalWorkflows({
       if (changelogBaseUrl === null && saved.changelogBaseUrl !== null) changelogBaseUrl = saved.changelogBaseUrl;
       // #456 deploy_branch 저장값 재사용
       if (deployBranch === null && saved.deployBranch != null) deployBranch = saved.deployBranch;
+      // #485 intent 저장값 재사용 — 없으면 저장된 deploy/publish에서 역추론(구 version.yml 하위호환)
+      if (intent === null) intent = saved.intent ?? inferIntent(saved.deploy, saved.publish);
     }
   }
 
-  // ── ② 배포 방식 (택1) — basic 단독이면 질문 스킵, none으로 확정 ──
+  // ── ② intent(프로젝트 성격) 우선 분기 → 배포 축 유도 (#485) ──
+  // basic 단독이면 intent 개념 자체가 없어 질문 스킵, none/[]로 확정.
   if (isBasicOnly) {
     if (deploy === null) deploy = "none";
     if (publish === null) publish = [];
+    intent = "none";
   } else {
-    const willAskDeploy = ask("deploy") || deploy === null;
-    const willAskPublish = ask("publish") || publish === null;
-    // #480 — deploy·publish는 서로 다른 두 축이다. 둘 다 물을 참이면 먼저 큰 그림을 한 번 안내한다.
-    // (수정 메뉴로 한 축만 고칠 때는 맥락이 이미 명확하므로 생략)
-    if (willAskDeploy && willAskPublish && tty && typeof io.select === "function") {
+    // 수정 메뉴에서 deploy/publish 축만 콕 집어 고칠 때(scope에 그 축이 있고 intent는 없음)는
+    // intent 질문·게이팅을 건너뛰고 그 축만 바로 편집한다 (#483 격리 존중). intent는 값 유지·역추론.
+    const scopedAxisOnly = scopeSet !== null && !scopeSet.has("intent");
+    if (scopedAxisOnly) {
+      if (intent === null) intent = inferIntent(deploy, publish) ?? "manual";
+    } else {
+      // intent 질문: 미확정이거나(초기 통합) intent 축을 강제 재질문(수정 메뉴 "프로젝트 성격")일 때.
+      const askIntent = ask("intent") || intent === null;
+      if (askIntent) {
+        if (force || !tty || typeof io.select !== "function") {
+          // 비대화형: CLI intent 미지정이면 deploy/publish에서 역추론, 그래도 없으면 manual(기존 동작)
+          intent = intent ?? inferIntent(deploy, publish) ?? "manual";
+        } else {
+          say("");
+          say("🧭 이 프로젝트는 어떤 성격인가요? (배포 관련 질문을 여기에 맞춰 좁혀드립니다)");
+          const ans = await io.select({
+            message: "프로젝트 성격을 선택하세요",
+            options: [
+              { value: "app", label: "서버/호스팅에 올려 돌리는 앱·서비스 (배포만)" },
+              { value: "library", label: "남이 가져다 쓰는 라이브러리/패키지 (publish만)" },
+              { value: "both", label: "둘 다 (서버로도 돌리고 라이브러리로도 냄)" },
+              { value: "none", label: "배포 안 함 (CI·빌드 검증만)" },
+              { value: "manual", label: "직접 하나씩 고를게요 (모든 옵션 개별 질문)" },
+            ],
+          });
+          intent = (!isCancel(ans) && INTENT_ASKS_DEPLOY[ans] !== undefined) ? ans : (intent ?? "manual");
+          say(`프로젝트 성격: ${intent}`);
+        }
+        // intent 확정 후 유도: 안 묻는 축은 값 확정, 묻는 축은 재질문 대상으로 되돌린다.
+        if (!INTENT_ASKS_DEPLOY[intent]) deploy = "none";
+        if (!INTENT_ASKS_PUBLISH[intent]) publish = [];
+        if (INTENT_ASKS_DEPLOY[intent] && ask("intent")) deploy = null;
+        if (INTENT_ASKS_PUBLISH[intent] && ask("intent")) publish = null;
+      }
+    }
+    // intent가 정해진 뒤, 유도 규칙에 따라 각 축을 물을지 결정 (#485).
+    // scopedAxisOnly(수정 메뉴 단일 축)면 intent 게이트를 무시하고 그 축을 편집하게 한다.
+    const deployGate = scopedAxisOnly ? true : INTENT_ASKS_DEPLOY[intent];
+    const publishGate = scopedAxisOnly ? true : INTENT_ASKS_PUBLISH[intent];
+    const willAskDeploy = deployGate && (ask("deploy") || deploy === null);
+    const willAskPublish = publishGate && (ask("publish") || publish === null);
+    // 유도로 안 묻는 축은 기본값 확정.
+    if (!deployGate && deploy === null) deploy = "none";
+    if (!publishGate && publish === null) publish = [];
+    // manual(직접 고르기)에서 둘 다 물을 땐 두 축이 별개임을 한 번 안내 (#480 계승).
+    if (intent === "manual" && willAskDeploy && willAskPublish && tty && typeof io.select === "function") {
       say("");
       say("🧭 배포는 두 가지가 따로 있습니다 — 서로 독립이라 각각 답하시면 됩니다:");
       say("   1) 실행물 배포 — 서버/호스팅에 올려 돌리는 것 (Docker, Vercel …)");
       say("   2) 라이브러리 배포(publish) — 남이 가져다 쓰게 레지스트리에 내는 것 (Nexus, npm …)");
-      say("   먼저 (1) 실행물 배포부터 물어보고, 이어서 (2) 라이브러리 배포를 물어봅니다.");
     }
     if (willAskDeploy) {
       if (force || !tty || typeof io.select !== "function") {
@@ -291,11 +341,15 @@ export async function askAllOptionalWorkflows({
     current: secretBackup, force, tty, io, forceAsk: ask("secret"), say,
   });
 
+  const finalDeploy = deploy ?? "docker-ssh";
+  const finalPublish = publish ?? [];
   return {
-    deploy: deploy ?? "docker-ssh", publish: publish ?? [], secretBackup: secretBackup === true,
+    deploy: finalDeploy, publish: finalPublish, secretBackup: secretBackup === true,
     codeReviewCoderabbit: codeReviewCoderabbit === true,
     changelogProvider: changelogProvider ?? "github-ai",
     changelogBaseUrl: changelogBaseUrl ?? "",
     deployBranch: deployBranch ?? "develop",
+    // #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/version-yml.js

@@ -52,7 +52,7 @@ const HEADER = `# ==============================================================
 export function parseTemplateOptions(content) {
   const out = { deploy: null, publish: null, secretBackup: null,
                 changelogProvider: null, changelogBaseUrl: null, codeReviewCoderabbit: null,
-                deployBranch: null };
+                deployBranch: null, intent: null };
   // deploy_branch는 metadata 직속(#456) — template.options 밖이라 별도로 스캔한다.
   for (const line of String(content || "").split("\n")) {
     if (line.startsWith("#")) continue;
@@ -85,6 +85,14 @@ export function parseTemplateOptions(content) {
         const bm = line.match(/^\s+base_url:\s*(.*)/);
         if (bm) { out.changelogBaseUrl = strip(bm[1]); continue; }
       }
+      // intent(프로젝트 성격, #485) — deploy 라인보다 먼저 매칭 (deploy: 와 intent: 구분).
+      // 값 뒤 인라인 주석(# ...)이 붙으므로 따옴표 안 or 첫 토큰만 취한다.
+      let im = line.match(/^\s+intent:\s*["']?([a-z]+)["']?/);
+      if (im) {
+        const v = im[1];
+        if (["app", "library", "both", "none", "manual"].includes(v)) out.intent = v;
+        continue;
+      }
       let m = line.match(/^\s+deploy:\s*(.+)/);
       if (m) {
         const v = strip(m[1]);
@@ -144,6 +152,22 @@ export function parseTemplateOptions(content) {
   return out;
 }
 
+// deploy/publish 저장값에서 intent(프로젝트 성격) 역추론 (#485 — intent 키 없는 구 version.yml 하위호환).
+//   deploy≠none & publish=[]  → app     (서버/앱만)
+//   deploy=none & publish≠[]  → library (라이브러리만)
+//   deploy≠none & publish≠[]  → both
+//   deploy=none & publish=[]  → none
+// deploy/publish가 아직 null(미설정)이면 intent도 추론 불가 → null 반환(진입 질문을 하도록).
+export function inferIntent(deploy, publish) {
+  if (deploy == null && (publish == null)) return null;
+  const hasServer = deploy != null && deploy !== "none";
+  const hasLib = Array.isArray(publish) && publish.length > 0;
+  if (hasServer && hasLib) return "both";
+  if (hasServer) return "app";
+  if (hasLib) return "library";
+  return "none";
+}
+
 // v4.1.0 이전 단수 project_type 키 → project_types 배열 최소 변환 (#471).
 // version.yml을 재생성하지 않는 경로(workflows 모드)에서 신형 version_manager(단수 키 명시 거부)와의
 // 정합을 맞춘다 — 해당 라인만 교체하고 나머지 내용은 손대지 않는다.
@@ -267,14 +291,17 @@ export function buildVersionYml({ version, types = [], paths = new Map(), pathMa
   // template 옵션 블록 (.sh save_template_options 신규 추가 케이스). templateOptions 지정 시.
   if (templateOptions) {
     const { templateVersion = "unknown", deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false, optionsDate = today,
-            changelogProvider = "github-ai", changelogBaseUrl = "", codeReviewCoderabbit = true } = templateOptions;
+            changelogProvider = "github-ai", changelogBaseUrl = "", codeReviewCoderabbit = true, intent = null } = templateOptions;
     const publishJson = `[${publishTargets.map((t) => `"${t}"`).join(",")}]`;
+    // intent(프로젝트 성격, #485) — 미지정이면 deploy/publish에서 역추론해 기록 (재통합 시 진입 질문 생략용)
+    const intentVal = intent || inferIntent(deployTarget, publishTargets) || "manual";
     out += `  template:\n`;
     out += `    source: "projectops"\n`;
     out += `    version: "${templateVersion}"\n`;
     out += `    integrated_date: "${optionsDate}"\n`;
     out += `    last_update_date: "${optionsDate}"\n`;
     out += `    options:\n`;
+    out += `      intent: "${intentVal}"   # 프로젝트 성격(app/library/both/none/manual) — 배포 질문 유도 기준\n`;
     out += `      deploy: "${deployTarget}"\n`;
     out += `      publish: ${publishJson}\n`;
     out += `      secret_backup: ${includeSecretBackup}\n`;

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";
@@ -103,15 +104,26 @@ export async function run(argv, { cwd = process.cwd(), source = { type: "git" },
   const { now, today } = clock || utcNow();
   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 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 = [];
+  }
+
   const context = createContext({
     mode: opts.mode, force: true, types, version, versionCode, branch,
     paths,
-    // 배포/publish 축(#439): CLI 플래그 최우선 → version.yml 저장 옵션(구 키 자동 마이그레이션) → 기본값
-    deployTarget: opts.deployTarget ?? existing?.options?.deploy ?? "docker-ssh",
-    publishTargets: opts.publishTargets ?? existing?.options?.publish ?? [],
+    deployTarget,
+    publishTargets,
     includeSecretBackup: opts.includeSecretBackup ?? existing?.options?.secretBackup ?? false,
     // 릴리스 배포 브랜치(#456): CLI 플래그 → version.yml 저장값 → 빈 값(미출력, 스킬이 develop 폴백)
     deployBranch: opts.deployBranch || existing?.options?.deployBranch || "",
+    intent,
     // changelog/code_review 축(#455): 비대화형은 저장값 → 기본값. null이 흘러 provider:"null"로 기록되던 버그 수정.
     changelogProvider: existing?.options?.changelogProvider ?? "github-ai",
     changelogBaseUrl: existing?.options?.changelogBaseUrl ?? "",
@@ -139,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/prompts.js

@@ -39,6 +39,8 @@ export async function editMenu({ showOptional = false } = {}) {
     { value: "branch", label: "기본 브랜치" },
   ];
   if (showOptional) {
+    // #485 — 프로젝트 성격(intent): 재선택 시 배포/publish 축을 재유도한다.
+    options.push({ value: "intent", label: "프로젝트 성격 (배포 유형)" });
     // #483 — 항목별 격리: 한 축만 골라 그 축만 재질문한다 (통짜 "배포/Publish 방식" 분해)
     options.push({ value: "deploy", label: "배포 방식 (서버 실행물)" });
     options.push({ value: "publish", label: "라이브러리 배포(publish) 타겟" });