projectops 4.0.3 → 4.0.4

package/src/ui/banner.js

@@ -0,0 +1,30 @@
+// 첫 화면 배너 (#446 층1) — 클래식 박스형 (사용자 확정 시안 A)
+// .ps1 Print-Banner 계승 + 브랜딩을 projectops로 갱신.
+import { A, paint, visualWidth } from "./ansi.js";
+
+const INNER = 56; // 박스 내부 폭
+
+function boxLine(out, content = "") {
+  const pad = Math.max(0, INNER - visualWidth(content));
+  out(paint("║", A.cyan) + content + " ".repeat(pad) + paint("║", A.cyan) + "\n");
+}
+
+// 대화형 첫 화면 배너 — 박스 타이틀 + 메타 4줄 (.ps1 Print-Banner 등가, #446 확정 시안 A)
+export function printBanner({ version, modeLabel }, out = (s) => process.stdout.write(s)) {
+  out("\n");
+  out(paint(`╔${"═".repeat(INNER)}╗`, A.cyan) + "\n");
+  boxLine(out);
+  boxLine(out, `      ${paint("✦", A.yellow)}  ${paint("P R O J E C T O P S", A.bold)}  ${paint("✦", A.yellow)}`);
+  boxLine(out);
+  out(paint(`╚${"═".repeat(INNER)}╝`, A.cyan) + "\n");
+  out(`     🌙 Version : ${paint(`v${version}`, A.green)}\n`);
+  out(`     🐵 Author  : Cassiiopeia\n`);
+  out(`     🪐 Mode    : ${modeLabel}\n`);
+  out(`     📦 Repo    : ${paint("github.com/Cassiiopeia/projectops", A.dim)}\n`);
+  out("\n");
+}
+
+// 비대화형(--force/CI) 축약 배너 — 1줄 (사용자 확정: 로그 오염 최소 + 버전 추적)
+export function printBannerCompact({ version, mode }, out = (s) => process.stdout.write(s)) {
+  out(`${paint("✦", A.yellow)} ${paint("projectops", A.bold)} v${version} — ${mode} 모드 (--force)\n`);
+}

package/src/ui/env-plan.js

@@ -0,0 +1,207 @@
+// @wizard env 계획 질문 UI (.sh wf_scope_string/wf_collect_asks/_wf_print_field_card/
+// _wf_prefill_all/_wf_prefill_interactive/wf_prompt_env_plan 등가).
+// 실측 기준: template_integrator.sh 3059~3085(scope), 3087~3143(collect), 3152~3169(card),
+//           3220~3280(prompt 본체 wf_prompt_env_plan).
+// io 주입식 — 테스트는 {select, multiselect, text} 스텁을 넘긴다. 기본은 readline-engine 실물.
+import { join } from "node:path";
+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 { loadWizardPrompts, wfField, workflowDisplayName } from "../core/wizard-labels.js";
+import * as engine from "./readline-engine.js";
+
+const CANCEL = engine.CANCEL;
+
+// 진행 안내는 stderr로 출력 (.sh print_to_user가 >&2인 것과 동일 — stdout 파이프 오염 방지).
+const defaultLog = (s = "") => stderr.write(s + "\n");
+
+// 사용처 문자열 조립 (.sh wf_scope_string 등가).
+// usages: [{type, workflowName}] — 타입이 여러 개면 타입만 "t1·t2", 하나면 "타입 name1·name2".
+export function scopeString(usages = []) {
+  const types = []; const names = [];
+  for (const { type, workflowName } of usages) {
+    if (!types.includes(type)) types.push(type);
+    if (!names.includes(workflowName)) names.push(workflowName);
+  }
+  if (types.length > 1) return types.join("·");
+  return `${types.join("·")} ${names.join("·")}`.trim();
+}
+
+// ask KEY 수집 (.sh wf_collect_asks 등가) — 실제 설치되는 워크플로우와 같은 소스를 스캔한다.
+// tempDir: 다운로드 원본 루트. types: 설치 대상 타입 목록.
+// opts:
+//   resolvers    - @접두 기본값(@repo 등) 해석용 (.sh는 수집 시점에 resolve_token — 동일)
+//   includeNexus - true면 server-deploy 제외 + nexus/ 포함 (복사 엔진과 스캔 범위 일치)
+//   prompts      - wizard-labels 파싱 객체 (워크플로우 표시명용, null이면 확장자 제거 폴백)
+// 반환: { keys:[], defaults:Map<key,default>, typeDefaults:Map<"type|key",default>,
+//        usages:Map<key,[{type,workflowName}]> }
+export function collectAsks(tempDir, types = [], opts = {}) {
+  const { resolvers = {}, includeNexus = false, prompts = null } = opts;
+  const baseDir = join(tempDir, PATHS.workflowsDir, PATHS.projectTypesDir);
+  const keys = [];
+  const defaults = new Map();
+  const typeDefaults = new Map();
+  const usages = new Map();
+
+  for (const type of types) {
+    const typeDir = join(baseDir, type);
+    if (!exists(typeDir)) continue;
+    // 복사 엔진과 동일한 폴더 구성: 타입 직하위 + (nexus 아니면) server-deploy + (nexus면) nexus
+    const dirs = [typeDir];
+    if (!includeNexus) dirs.push(join(typeDir, "server-deploy"));
+    else dirs.push(join(typeDir, "nexus"));
+
+    for (const dir of dirs) {
+      if (!exists(dir)) continue;
+      for (const filename of listYamlFiles(dir)) {
+        const content = readFileSync(join(dir, filename), "utf8");
+        if (!content.includes("@wizard")) continue;
+        const workflowName = workflowDisplayName(prompts, filename);
+        for (const line of content.split(/\r?\n/)) {
+          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;
+          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) || [];
+          list.push({ type, workflowName });
+          usages.set(p.key, list);
+        }
+      }
+    }
+  }
+  return { keys, defaults, typeDefaults, usages };
+}
+
+// KEY가 처음 등장한 type (.sh _wf_first_type_for — 라벨 조회 시 타입 오버라이드 우선순위용)
+function firstTypeFor(usages, key) {
+  return usages.get(key)?.[0]?.type ?? "";
+}
+
+// KEY 1개를 'label·사용처·설명·예시·기본값' 카드로 출력 (.sh _wf_print_field_card 등가).
+// info: { default, usages } — idx/tot 있으면 "(i/t)" 진행 표시. log 주입 가능(테스트 무음화).
+export function printFieldCard(prompts, key, info, idx = null, tot = null, log = defaultLog) {
+  const t = info.usages?.[0]?.type ?? "";
+  const label = wfField(prompts, t, key, "label");
+  const help = wfField(prompts, t, key, "help");
+  const ex = wfField(prompts, t, key, "example");
+  const scope = scopeString(info.usages || []);
+  const head = idx != null && tot != null
+    ? `   ▸ (${idx}/${tot}) ${label}  [${scope}]`
+    : `   ▸ ${label}  [${scope}]`;
+  log(head);
+  if (help) log(`       ${help}`);
+  if (ex) log(`       예) ${ex}`);
+  log(`       기본값: ${info.default ?? ""}`);
+  log("");
+}
+
+// 지정 KEY들을 하나씩 입력받아 values에 기록 (.sh _wf_prefill_interactive 등가).
+// 빈 입력(Enter)/ESC → KEY 공통 기본값 유지 (.sh safe_read || _in="" 등가).
+async function promptEach(io, prompts, asks, todoKeys, values, log) {
+  const tot = todoKeys.length;
+  if (tot === 0) return;
+  log("");
+  log("   값을 입력하세요. 그대로 두려면 아무것도 입력하지 말고 Enter를 누르면 기본값이 적용됩니다.");
+  log("");
+  let i = 0;
+  for (const key of todoKeys) {
+    i++;
+    const def = asks.defaults.get(key) ?? "";
+    printFieldCard(prompts, key, { default: def, usages: asks.usages.get(key) || [] }, i, tot, log);
+    let input = await io.text({ message: `↳ 값 입력 (Enter=기본값 «${def}» 유지):`, defaultValue: def });
+    if (input === CANCEL || input == null || input === "") input = def;
+    values.set(key, input);
+    const label = wfField(prompts, firstTypeFor(asks.usages, key), key, "label");
+    log(`         → ${label} = ${input}`);
+    log("");
+  }
+}
+
+// 배포 env 설정 계획 (.sh wf_prompt_env_plan 등가).
+// 반환: { values: Map<key,value>, useDefaults: boolean }
+//  - useDefaults=true  → 호출부는 substituteEnv에 그대로 넘기면 타입별 기본값 경로(.sh _wf_prefill_all 등가)
+//  - useDefaults=false → values에 담긴 키만 사용자 확정값으로 치환, 나머지는 기본값
+//    (⚠️ substituteEnv는 useDefaults=false일 때만 values를 참조하므로 이 플래그를 반드시 함께 전달)
+// 인자:
+//   tempDir/types/resolvers/includeNexus — collectAsks와 동일 의미
+//   targetRoot — wizard-prompts.yml 1차 탐색 위치(기본 ".")
+//   force      — true면 질문 없이 전부 기본값 (.sh FORCE_MODE 등가)
+//   io         — {select, multiselect, text} 주입 (기본 readline-engine). 테스트 스텁 지점.
+//   log        — 카드·안내 출력 함수 주입 (기본 stderr)
+export async function promptEnvPlan({
+  tempDir, types = [], io = null, force = false, resolvers = {},
+  includeNexus = false, targetRoot = ".", repoName = "", log = defaultLog,
+} = {}) {
+  const prompts = loadWizardPrompts(targetRoot, tempDir);
+  const asks = collectAsks(tempDir, types, { resolvers, includeNexus, prompts });
+  const defaults = asks.defaults;
+
+  // 수집 키 0개 → 질문 자체가 없음 (.sh `[ ${#WF_ASK_KEYS[@]} -eq 0 ]` 등가)
+  if (asks.keys.length === 0) return { values: new Map(), useDefaults: true };
+
+  // 비대화형: force 또는 (io 미주입 && 비TTY) → 전부 기본값 (.sh FORCE_MODE/TTY_AVAILABLE 분기 등가)
+  // io가 주입돼 있으면(테스트/상위 마법사) TTY 여부와 무관하게 대화형으로 진행한다.
+  const interactive = !force && (io != null || stdin.isTTY);
+  if (!interactive) return { values: new Map(defaults), useDefaults: true };
+
+  const ui = io ?? engine;
+
+  // 기본값 미리보기 카드 전체 출력 (.sh 3237~3251)
+  log("");
+  log("▶ 배포 워크플로우 환경설정을 채웁니다");
+  log("");
+  log("   설치되는 배포 워크플로우가 사용할 값입니다. 항목마다 '무엇에 쓰이는지·설명·예시'와");
+  log("   기본값을 함께 보여드립니다. 그대로 둬도 되고, 원하는 것만 바꿀 수 있습니다.");
+  log("");
+  const tot = asks.keys.length;
+  asks.keys.forEach((key, i) => {
+    printFieldCard(prompts, key, { default: defaults.get(key), usages: asks.usages.get(key) || [] }, i + 1, tot, log);
+  });
+  log("   ─────────────────────────────────────────────");
+
+  const choice = await ui.select({
+    message: "어떻게 채울까요?",
+    options: [
+      { value: "all", label: "① 위 기본값 그대로 전부 설치 (입력 없이 바로 진행)" },
+      { value: "each", label: "② 하나씩 직접 입력 (모든 항목을 순서대로)" },
+      { value: "some", label: "③ 몇 개만 골라서 바꾸기 (고른 것만 입력 · 나머지는 기본값)" },
+    ],
+  });
+  // ESC/취소 → 전부 기본값 (.sh `if [ "$_rc" -ne 0 ]` 등가)
+  if (choice === CANCEL || choice == null || choice === "all") {
+    return { values: new Map(defaults), useDefaults: true };
+  }
+
+  // 사용자가 확정한 키만 values에 담는다 — substituteEnv(useDefaults:false)가
+  // values에 없는 키는 타입별 기본값으로 채우므로 .sh(_wf_prefill_all 후 덮어쓰기)와 등가.
+  const values = new Map();
+  if (choice === "each") {
+    await promptEach(ui, prompts, asks, asks.keys, values, log);
+    return { values, useDefaults: false };
+  }
+
+  // some: 바꿀 항목만 멀티선택 → 고른 것만 입력 (.sh 3266~3277)
+  const options = asks.keys.map((key) => ({
+    value: key,
+    label: `${wfField(prompts, firstTypeFor(asks.usages, key), key, "label")}  (기본: ${defaults.get(key)})`,
+  }));
+  const selected = await ui.multiselect({
+    message: "바꿀 항목을 고르세요 (Space로 선택 · Enter로 확정)",
+    options,
+    initialValues: [],
+  });
+  // ESC/빈 선택 → 전부 기본값 (.sh: _wf_prefill_all만 수행)
+  if (selected === CANCEL || !Array.isArray(selected) || selected.length === 0) {
+    return { values: new Map(defaults), useDefaults: true };
+  }
+  // 수집 키 순서 유지 + WF_ASK_KEYS 멤버만 인정 (.sh _wf_prefill_interactive 필터 등가)
+  const todo = asks.keys.filter((k) => selected.includes(k));
+  await promptEach(ui, prompts, asks, todo, values, log);
+  return { values, useDefaults: false };
+}

package/src/ui/prompts.js

@@ -74,3 +74,29 @@ export function intro(text) { engine.intro(text); }
 export function outro(text) { engine.outro(text); }
 export function note(text, title) { engine.note(text, title); }
 export function cancelMessage(text = "취소했습니다.") { engine.cancelMessage(text); }
+
+// ── #446 첫 화면 UI 5층 + SP2-C 대화형 계층 실물 io ─────────────────
+// runInteractive는 io.<method>?.() 옵셔널 호출 — 테스트 스텁은 이 메서드들을 생략해
+// 시각 층·env 질문을 건너뛴다 (실행 계약은 그대로).
+import { printBanner as _printBanner } from "./banner.js";
+import {
+  printDetectionLog as _detLog, printAnalysisCard as _card,
+  printIdeStatus as _ideStatus, printInstallKind as _installKind, collectIdeStatuses,
+} from "./status-cards.js";
+import { printSummary as _summary } from "./summary.js";
+import { defaultIo } from "../core/ide/runner.js";
+
+export function banner(info) { _printBanner(info); }
+export function detectionLog(info) { _detLog(info); }
+export function analysisCard(info) { _card(info); }
+export function installKind(info) { _installKind(info); }
+export function ideStatus() { _ideStatus(collectIdeStatuses(defaultIo())); }
+export function summary(ctx, targetRoot) { _summary(ctx, targetRoot); }
+
+// env 계획·경로 해석·충돌 메뉴가 쓰는 저수준 엔진 io (env-plan/paths-resolve의 io 계약)
+export const engineIo = {
+  select: engine.select,
+  multiselect: engine.multiselect,
+  text: engine.text,
+  confirm: engine.confirm,
+};

package/src/ui/status-cards.js

@@ -0,0 +1,86 @@
+// 첫 화면 상태 표시 층 (#446 층2~5) — 감지 로그 · 분석 카드 · IDE 상태 · 신규/업데이트 판별
+// (층5의 Breaking Changes 박스는 core/breaking-check.js가 담당)
+import { A, paint } from "./ansi.js";
+import { ADAPTERS } from "../core/ide/registry.js";
+import { markerForType } from "../core/detect.js";
+
+const GUT = paint("│", A.gray);
+const HEAD = paint("◆", A.cyan);
+const OK = paint("✓", A.green);
+
+// 층2 — 감지 로그 (.ps1 감지 진행 표시 등가)
+export function printDetectionLog({ types = [], version = "", branch = "" }, out = (s) => process.stdout.write(s)) {
+  out(`${paint("┌", A.gray)}  🔍 프로젝트를 살펴보는 중...\n`);
+  if (types.length && !(types.length === 1 && types[0] === "basic")) {
+    for (const t of types) {
+      const marker = markerForType(t);
+      out(`${GUT}  ${OK} ${marker ? `${marker} 발견 → ` : ""}${paint(t, A.bold)} 감지\n`);
+    }
+  } else {
+    out(`${GUT}  ${paint("─", A.dim)} 마커 파일 없음 → ${paint("basic", A.bold)} (직접 선택 가능)\n`);
+  }
+  out(`${GUT}  ${OK} 버전: ${paint(`v${version}`, A.green)} · 브랜치: ${paint(branch, A.green)}\n`);
+  out(`${GUT}\n`);
+}
+
+// 층3 — 프로젝트 분석 개요 카드 (.ps1 Print-ProjectAnalysis 등가+)
+export function printAnalysisCard({ mode = "", modeLabel = "", types = [], version = "", branch = "",
+  includeNexus = null, includeSecretBackup = null, paths = new Map(), showOptional = false },
+  out = (s) => process.stdout.write(s)) {
+  out(`${HEAD}  ${paint("프로젝트 분석 결과", A.bold)}\n`);
+  const row = (icon, label, value) => out(`${GUT}  ${icon} ${label.padEnd(10)} ${value}\n`);
+  row("📂", types.length > 1 ? "타입(멀티)" : "타입", paint(types.join(", ") || "basic", A.bold));
+  row("🌙", "버전", paint(`v${version}`, A.green));
+  row("🌿", "브랜치", branch);
+  if (modeLabel || mode) row("💫", "통합 모드", modeLabel || mode);
+  if (showOptional) {
+    row("📦", "Nexus", includeNexus === true ? paint("포함", A.green) : paint("제외", A.dim));
+    row("🔐", "Secret백업", includeSecretBackup === true ? paint("포함", A.green) : paint("제외", A.dim));
+  }
+  // 모노레포 경로 — 루트가 아닌 항목이 하나라도 있으면 표시
+  const nonRoot = [...paths.entries()].filter(([, p]) => p && p !== ".");
+  if (nonRoot.length) {
+    row("📁", "경로", [...paths.entries()].map(([t, p]) => `${t}→${p}`).join(", "));
+  }
+  out(`${GUT}\n`);
+}
+
+// 층4 — IDE Skills 현재 상태 수집 (어댑터 detect 순회 — 예외 없음 계약)
+export function collectIdeStatuses(io) {
+  return ADAPTERS.map((a) => {
+    let st;
+    try { st = a.detect(io); } catch { st = { installed: false, version: null, cliMissing: true, note: "감지 실패" }; }
+    return { id: a.id, label: a.label, ...st };
+  });
+}
+
+// 층4 — IDE Skills 현재 상태 표시
+export function printIdeStatus(statuses, out = (s) => process.stdout.write(s)) {
+  if (!statuses?.length) return;
+  out(`${HEAD}  ${paint("AI 에이전트 스킬 상태", A.bold)}\n`);
+  for (const s of statuses) {
+    let mark, detail;
+    if (s.installed) {
+      mark = OK;
+      detail = paint(`설치됨${s.version ? ` v${s.version}` : ""}${s.scope ? ` (${s.scope})` : ""}`, A.green);
+    } else if (s.cliMissing) {
+      mark = paint("⚠", A.yellow);
+      detail = paint(s.note || "CLI 없음", A.yellow);
+    } else {
+      mark = paint("─", A.dim);
+      detail = paint("미설치", A.dim);
+    }
+    out(`${GUT}  ${mark} ${s.label.padEnd(14)} ${detail}${s.note && !s.cliMissing ? paint(`  ${s.note}`, A.dim) : ""}\n`);
+  }
+  out(`${GUT}\n`);
+}
+
+// 층5 — 신규 통합 vs 업데이트 판별 라인 (Breaking 박스는 breaking-check.js)
+export function printInstallKind({ currentTemplateVersion = "", templateVersion = "" }, out = (s) => process.stdout.write(s)) {
+  if (currentTemplateVersion) {
+    out(`${GUT}  ♻️  ${paint("업데이트", A.bold)} — 템플릿 ${paint(`v${currentTemplateVersion}`, A.dim)} → ${paint(`v${templateVersion}`, A.green)}\n`);
+  } else {
+    out(`${GUT}  🆕 ${paint("신규 통합", A.bold)} — 이 프로젝트에 처음 설치합니다 (템플릿 ${paint(`v${templateVersion}`, A.green)})\n`);
+  }
+  out(`${GUT}\n`);
+}

package/src/ui/summary.js

@@ -0,0 +1,173 @@
+// 완료 요약 출력 (.sh print_summary L5438~5626 등가). 전부 stderr.
+// ctx: { mode, types:[], version, counters:{ workflows, utilModules } }
+import { existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import {
+  PATHS, WORKFLOW_PREFIX, WORKFLOW_COMMON_PREFIX, WORKFLOW_TEMPLATE_INIT,
+} from "../core/paths.js";
+import { listYamlFiles } from "../core/fsutil.js";
+
+const SEPARATOR = "────────────────────────────────────────";
+
+export function printSummary(ctx, targetRoot = ".") {
+  const { mode, types = [], version = "", counters = {} } = ctx || {};
+  const err = (s = "") => process.stderr.write(`${s}\n`);
+  // 색상은 TTY일 때만 (.sh YELLOW/CYAN/NC 등가)
+  const isTty = !!process.stderr.isTTY;
+  const YELLOW = isTty ? "\x1b[1;33m" : "";
+  const CYAN = isTty ? "\x1b[0;36m" : "";
+  const NC = isTty ? "\x1b[0m" : "";
+  const utilModulesCopied = counters.utilModules ?? 0;
+  const workflowsCopied = counters.workflows ?? 0;
+
+  err("");
+  err(SEPARATOR);
+  err("");
+  err("✨ projectops Setup Complete!");
+  err("");
+  err(SEPARATOR);
+  err("");
+  err("통합된 기능:");
+
+  // 모드별 체크리스트 (.sh L5449~5481)
+  switch (mode) {
+    case "full":
+      err("  ✅ 버전 관리 시스템 (version.yml)");
+      err("  ✅ README.md 자동 버전 업데이트");
+      err("  ✅ GitHub Actions 워크플로우");
+      if (utilModulesCopied > 0) err(`  ✅ 유틸리티 모듈 (${utilModulesCopied} 개)`);
+      err("  ✅ 이슈/PR/Discussion 템플릿");
+      err("  ✅ CodeRabbit AI 리뷰 설정");
+      err("  ✅ .gitignore 필수 항목");
+      err("  ✅ 템플릿 설정 가이드 (SETUP-GUIDE.md)");
+      break;
+    case "version":
+      err("  ✅ 버전 관리 시스템 (version.yml)");
+      err("  ✅ README.md 자동 버전 업데이트");
+      err("  ✅ .gitignore 필수 항목");
+      err("  ✅ 템플릿 설정 가이드 (SETUP-GUIDE.md)");
+      break;
+    case "workflows":
+      err("  ✅ GitHub Actions 워크플로우");
+      if (utilModulesCopied > 0) err(`  ✅ 유틸리티 모듈 (${utilModulesCopied} 개)`);
+      err("  ✅ 템플릿 설정 가이드 (SETUP-GUIDE.md)");
+      break;
+    case "issues":
+      err("  ✅ 이슈/PR/Discussion 템플릿");
+      break;
+    case "skills":
+      err("  ✅ Agent Skill 설치 (Claude, Cursor, Gemini, Codex, PI)");
+      break;
+  }
+
+  // skills 모드: 파일/워크플로우 추가 없으므로 간결하게 종료 (.sh L5484~5491)
+  if (mode === "skills") {
+    err("");
+    err("  📖 TEMPLATE REPO: https://github.com/Cassiiopeia/projectops");
+    err("");
+    err(SEPARATOR);
+    err("");
+    return;
+  }
+
+  err("");
+  err("추가된 파일:");
+  err(`  📄 version.yml (버전: ${version}, 타입: ${types.join(",")})`);
+  err("  📝 README.md (버전 섹션 추가)");
+  err("");
+  err("추가된 워크플로우:");
+
+  // 실제 복사된 워크플로우와 기존 파일 구분 (.sh L5505~5534)
+  const commonWorkflows = [];
+  const typeWorkflows = [];
+  const existingWorkflows = [];
+  const workflowsDir = join(targetRoot, PATHS.workflowsDir);
+  if (existsSync(workflowsDir)) {
+    const typePrefixes = types.map((t) => `${WORKFLOW_PREFIX}-${t.toUpperCase()}-`);
+    for (const filename of listYamlFiles(workflowsDir)) {
+      if (!filename.startsWith(`${WORKFLOW_PREFIX}-`)) continue; // PROJECT-*.{yaml,yml}만
+      if (filename === WORKFLOW_TEMPLATE_INIT) {
+        // TEMPLATE-INITIALIZER는 템플릿 전용 기존 파일로 분류
+        existingWorkflows.push(filename);
+      } else if (filename.startsWith(`${WORKFLOW_COMMON_PREFIX}-`)) {
+        commonWorkflows.push(filename);
+      } else if (typePrefixes.some((p) => filename.startsWith(p))) {
+        typeWorkflows.push(filename);
+      }
+    }
+  }
+
+  if (commonWorkflows.length > 0 || typeWorkflows.length > 0) {
+    err(`  📦 새로 설치됨 (${workflowsCopied}개):`);
+    for (const wf of commonWorkflows) err(`     📌 ${wf}`);
+    for (const wf of typeWorkflows) err(`     🎯 ${wf}`);
+  }
+  if (existingWorkflows.length > 0) {
+    err("");
+    err("  🔧 기존 파일 유지됨:");
+    for (const wf of existingWorkflows) err(`     📌 ${wf} (템플릿 전용)`);
+  }
+
+  err("");
+  err("  🔧 .github/scripts/");
+  err("     ├─ version_manager.sh");
+  err("     └─ changelog_manager.py");
+  err("");
+
+  // util 모듈 목록 (.sh L5566~5581) — 타입별 .github/util/{type}/*/ 스캔
+  if (utilModulesCopied > 0) {
+    err("  🧙 유틸리티 모듈:");
+    for (const t of types) {
+      const utilDir = join(targetRoot, ".github/util", t);
+      if (!existsSync(utilDir)) continue;
+      let entries = [];
+      try { entries = readdirSync(utilDir, { withFileTypes: true }); } catch { /* 무시 */ }
+      for (const e of entries) {
+        if (e.isDirectory()) err(`     ├─ ${e.name} (${t})`);
+      }
+    }
+    err("");
+  }
+
+  // 프로젝트 타입별 안내 (.sh L5583~5599)
+  if (types.includes("spring")) {
+    err("  💡 Spring 프로젝트 추가 설정:");
+    err("     • build.gradle의 버전 정보가 자동 동기화됩니다");
+    err("     • CI/CD 워크플로우에서 GitHub Secrets 설정이 필요합니다");
+    err("     • 자세한 설정 방법: .github/workflows/project-types/spring/README.md");
+    err("");
+  }
+  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("     • 브라우저에서 열어 필요한 정보 입력 후 파일 생성");
+    err("");
+  }
+
+  err("  📖 TEMPLATE REPO: https://github.com/Cassiiopeia/projectops");
+  err("  📚 워크플로우 가이드: .github/workflows/project-types/README.md");
+  err("");
+
+  // 필수 3가지 작업 안내 (.sh L5605~5625 — 원문 유지)
+  err(SEPARATOR);
+  err("");
+  err(`${YELLOW}⚠️  다음 3가지 작업을 완료해주세요:${NC}`);
+  err("");
+  err("  1️⃣  GitHub Personal Access Token 설정");
+  err("     → Repository Settings > Secrets > Actions");
+  err("     → Secret Name: _GITHUB_PAT_TOKEN");
+  err("     → Scopes: repo, workflow");
+  err("");
+  err("  2️⃣  develop 브랜치 생성");
+  err("     → git checkout -b develop && git push -u origin develop");
+  err("");
+  err("  3️⃣  CodeRabbit 활성화");
+  err("     → https://coderabbit.ai 방문하여 저장소 활성화");
+  err("");
+  err(SEPARATOR);
+  err("");
+  err(`${CYAN}📖 자세한 설정 방법은 다음 파일을 참고하세요:${NC}`);
+  err("   → SUH-DEVOPS-TEMPLATE-SETUP-GUIDE.md");
+  err("");
+}