projectops 4.0.2 → 4.0.4

package/src/ui/readline-engine.js

@@ -0,0 +1,257 @@
+// node:readline 기반 대화형 프롬프트 엔진 (@clack/prompts 대체).
+// WHY: @clack/prompts 1.7.0 이 Windows TTY 콘솔에서 Enter(return) 키를 처리하지 못하고
+//   멈추는 버그가 있다(실측 확정). node:readline 의 keypress 이벤트는 Windows에서 정상 동작한다.
+//   .sh/.ps1 이 자체 메뉴를 구현한 것과 동일한 접근. 외부 의존성 0 → 내부망에서도 안전.
+//
+// 계약: 취소(ESC/Ctrl+C)는 CANCEL 심볼 반환. 각 함수 async.
+import { emitKeypressEvents } from "node:readline";
+import { stdin, stdout } from "node:process";
+
+export const CANCEL = Symbol("cancel");
+
+// ── ANSI 헬퍼 (picocolors 대체 — 의존성 0) ───────────────────────────
+const ESC = "\x1b[";
+const c = {
+  reset: `${ESC}0m`, dim: `${ESC}2m`, bold: `${ESC}1m`,
+  cyan: `${ESC}36m`, green: `${ESC}32m`, gray: `${ESC}90m`, yellow: `${ESC}33m`,
+};
+const paint = (s, color) => `${color}${s}${c.reset}`;
+const hideCursor = () => stdout.write(`${ESC}?25l`);
+const showCursor = () => stdout.write(`${ESC}?25h`);
+
+// 심볼 (clack 톤 유지)
+const S_ACTIVE = paint("●", c.green);
+const S_INACTIVE = paint("○", c.dim);
+const S_CHECK_ON = paint("◼", c.green);
+const S_CHECK_OFF = paint("◻", c.dim);
+const S_BAR = paint("│", c.gray);
+const S_Q = paint("◆", c.cyan);
+const S_DONE = paint("◇", c.green);
+
+// 여러 줄 지운 뒤 커서를 블록 시작으로 되돌리는 렌더러.
+// prevLines 만큼 위로 올라가 지우고 새로 그린다.
+function makeRenderer() {
+  let prevLines = 0;
+  return {
+    render(lines) {
+      if (prevLines > 0) stdout.write(`${ESC}${prevLines}A`); // 위로
+      stdout.write(`${ESC}0J`); // 커서 아래 전부 지우기
+      stdout.write(lines.join("\n") + "\n");
+      prevLines = lines.length;
+    },
+    reset() { prevLines = 0; },
+  };
+}
+
+// raw keypress 세션 공통 래퍼. onKey(str,key) → true 반환 시 종료.
+// 반환값은 finalize()가 만든다. 취소 시 CANCEL.
+function keySession(renderFn, onKey) {
+  return new Promise((resolve) => {
+    const wasRaw = stdin.isTTY ? stdin.isRaw : false;
+    emitKeypressEvents(stdin);
+    if (stdin.isTTY) stdin.setRawMode(true);
+    stdin.resume();
+    hideCursor();
+
+    const cleanup = () => {
+      stdin.removeListener("keypress", handler);
+      if (stdin.isTTY) stdin.setRawMode(wasRaw);
+      stdin.pause();
+      showCursor();
+    };
+
+    const handler = (str, key) => {
+      key = key || {};
+      // 취소: Ctrl+C / ESC
+      if ((key.ctrl && key.name === "c") || key.name === "escape") {
+        cleanup();
+        resolve(CANCEL);
+        return;
+      }
+      const done = onKey(str, key);
+      if (done !== undefined) {
+        cleanup();
+        resolve(done);
+      } else {
+        renderFn();
+      }
+    };
+    stdin.on("keypress", handler);
+    renderFn(); // 최초 렌더
+  });
+}
+
+// ── 단일 선택 (방향키 + Enter) ───────────────────────────────────────
+// options: [{value,label,hint?}]. 반환: 선택 value 또는 CANCEL.
+export async function select({ message, options, initialIndex = 0 }) {
+  if (!stdin.isTTY) {
+    // 비-TTY: 기본값(첫 항목) 반환 — 파이프 환경 방어
+    return options[initialIndex]?.value;
+  }
+  const r = makeRenderer();
+  let idx = Math.max(0, Math.min(initialIndex, options.length - 1));
+
+  const draw = () => {
+    const lines = [S_BAR, `${S_Q}  ${paint(message, c.bold)}`];
+    options.forEach((o, i) => {
+      const sel = i === idx;
+      const marker = sel ? S_ACTIVE : S_INACTIVE;
+      const label = sel ? paint(o.label, c.cyan) : o.label;
+      const hint = o.hint && sel ? paint(`  (${o.hint})`, c.dim) : "";
+      lines.push(`${S_BAR}  ${marker} ${label}${hint}`);
+    });
+    lines.push(paint(`└  ↑/↓ 이동 · Enter 확정 · ESC 취소`, c.gray));
+    r.render(lines);
+  };
+
+  const result = await keySession(draw, (str, key) => {
+    if (key.name === "up" || key.name === "k") { idx = (idx - 1 + options.length) % options.length; return; }
+    if (key.name === "down" || key.name === "j") { idx = (idx + 1) % options.length; return; }
+    // 숫자 점프 (1-9)
+    if (/^[1-9]$/.test(str || "")) {
+      const n = Number(str) - 1;
+      if (n < options.length) { idx = n; return; }
+      return;
+    }
+    if (key.name === "return" || key.name === "enter") return options[idx].value;
+    return; // 그 외 키: 무시하고 계속
+  });
+
+  // 확정 화면 다시 그리기 (◇ 완료 심볼 + 선택값)
+  if (result !== CANCEL) {
+    const chosen = options.find((o) => o.value === result);
+    r.render([S_BAR, `${S_DONE}  ${paint(message, c.dim)}`, `${S_BAR}  ${paint(chosen?.label ?? "", c.dim)}`]);
+  }
+  return result;
+}
+
+// ── 다중 선택 (Space 토글 + Enter) ──────────────────────────────────
+// options: [{value,label,hint?,disabled?}]. 반환: 선택 value 배열 또는 CANCEL.
+export async function multiselect({ message, options, initialValues = [], required = false }) {
+  if (!stdin.isTTY) {
+    return initialValues.length ? [...initialValues] : (required ? [options[0]?.value].filter(Boolean) : []);
+  }
+  const r = makeRenderer();
+  let idx = 0;
+  const chosen = new Set(initialValues);
+  let warn = "";
+
+  const draw = () => {
+    const lines = [S_BAR, `${S_Q}  ${paint(message, c.bold)}`];
+    options.forEach((o, i) => {
+      const cur = i === idx;
+      const box = chosen.has(o.value) ? S_CHECK_ON : S_CHECK_OFF;
+      const pointer = cur ? paint("❯", c.cyan) : " ";
+      const label = cur ? paint(o.label, c.cyan) : (o.disabled ? paint(o.label, c.dim) : o.label);
+      const hint = o.hint ? paint(`  (${o.hint})`, c.dim) : "";
+      lines.push(`${S_BAR} ${pointer} ${box} ${label}${hint}`);
+    });
+    if (warn) lines.push(paint(`   ${warn}`, c.yellow));
+    lines.push(paint(`└  ↑/↓ 이동 · Space 토글 · Enter 확정 · ESC 취소`, c.gray));
+    r.render(lines);
+  };
+
+  const result = await keySession(draw, (str, key) => {
+    warn = "";
+    if (key.name === "up" || key.name === "k") { idx = (idx - 1 + options.length) % options.length; return; }
+    if (key.name === "down" || key.name === "j") { idx = (idx + 1) % options.length; return; }
+    if (key.name === "space" || str === " ") {
+      const o = options[idx];
+      if (o.disabled) { warn = "선택할 수 없는 항목입니다."; return; }
+      if (chosen.has(o.value)) chosen.delete(o.value); else chosen.add(o.value);
+      return;
+    }
+    if (key.name === "return" || key.name === "enter") {
+      if (required && chosen.size === 0) { warn = "최소 1개 이상 선택하세요."; return; }
+      return [...chosen];
+    }
+    return;
+  });
+
+  if (result !== CANCEL) {
+    const labels = options.filter((o) => chosen.has(o.value)).map((o) => o.label).join(", ") || "(없음)";
+    r.render([S_BAR, `${S_DONE}  ${paint(message, c.dim)}`, `${S_BAR}  ${paint(labels, c.dim)}`]);
+  }
+  return result;
+}
+
+// ── 텍스트 입력 (Enter 확정, 빈 입력=기본값) ─────────────────────────
+// 반환: 입력 문자열(빈 입력 시 defaultValue) 또는 CANCEL.
+export async function text({ message, defaultValue = "" }) {
+  if (!stdin.isTTY) return defaultValue;
+  return new Promise((resolve) => {
+    const wasRaw = stdin.isTTY ? stdin.isRaw : false;
+    emitKeypressEvents(stdin);
+    if (stdin.isTTY) stdin.setRawMode(true);
+    stdin.resume();
+    let buf = "";
+
+    const prompt = () => {
+      stdout.write(`\r${ESC}0K`); // 줄 초기화
+      const shown = buf.length ? buf : paint(defaultValue || "", c.dim);
+      stdout.write(`${S_Q}  ${paint(message, c.bold)} ${shown}`);
+    };
+
+    const cleanup = () => {
+      stdin.removeListener("keypress", handler);
+      if (stdin.isTTY) stdin.setRawMode(wasRaw);
+      stdin.pause();
+      stdout.write("\n");
+    };
+
+    const handler = (str, key) => {
+      key = key || {};
+      if ((key.ctrl && key.name === "c") || key.name === "escape") { cleanup(); resolve(CANCEL); return; }
+      if (key.name === "return" || key.name === "enter") {
+        cleanup();
+        resolve(buf.length ? buf : defaultValue);
+        return;
+      }
+      if (key.name === "backspace") { buf = buf.slice(0, -1); prompt(); return; }
+      // 일반 문자 (제어문자 제외)
+      if (str && !key.ctrl && !key.meta && str.length === 1 && str >= " ") { buf += str; prompt(); return; }
+    };
+    stdin.on("keypress", handler);
+    prompt();
+  });
+}
+
+// ── Y/N 확인 (←→ 또는 y/n, Enter 확정) ──────────────────────────────
+// 반환: true/false 또는 CANCEL.
+export async function confirm({ message, initialValue = true }) {
+  if (!stdin.isTTY) return initialValue;
+  const r = makeRenderer();
+  let val = initialValue;
+
+  const draw = () => {
+    const yes = val ? paint("● 예", c.green) : paint("○ 예", c.dim);
+    const no = !val ? paint("● 아니오", c.green) : paint("○ 아니오", c.dim);
+    r.render([S_BAR, `${S_Q}  ${paint(message, c.bold)}`, `${S_BAR}  ${yes}   ${no}`,
+      paint(`└  ←/→ 또는 y/n · Enter 확정 · ESC 취소`, c.gray)]);
+  };
+
+  const result = await keySession(draw, (str, key) => {
+    if (key.name === "left" || key.name === "right" || key.name === "tab") { val = !val; return; }
+    if ((str || "").toLowerCase() === "y") { val = true; return; }
+    if ((str || "").toLowerCase() === "n") { val = false; return; }
+    if (key.name === "return" || key.name === "enter") return val;
+    return;
+  });
+
+  if (result !== CANCEL) {
+    r.render([S_BAR, `${S_DONE}  ${paint(message, c.dim)}`, `${S_BAR}  ${paint(result ? "예" : "아니오", c.dim)}`]);
+  }
+  return result;
+}
+
+// ── 출력 헬퍼 (clack intro/outro/note/cancel 대체) ──────────────────
+export function intro(text) { stdout.write(`\n${paint("┌", c.gray)}  ${paint(text, c.bold)}\n`); }
+export function outro(text) { stdout.write(`${paint("└", c.gray)}  ${paint(text, c.green)}\n\n`); }
+export function cancelMessage(text = "취소했습니다.") { stdout.write(`${paint("■", c.yellow)}  ${paint(text, c.yellow)}\n`); }
+export function note(text, title = "") {
+  const lines = String(text).split("\n");
+  stdout.write(`${paint("○", c.cyan)} ${paint(title, c.bold)}\n`);
+  for (const l of lines) stdout.write(`${S_BAR}  ${l}\n`);
+  stdout.write(`${S_BAR}\n`);
+}
+export function log(text = "") { stdout.write(`${text}\n`); }

package/src/ui/skills-prompts.js

@@ -1,12 +1,12 @@
-// IDE Skills 대화형 프롬프트 (.sh 라우터 choose_menu 등가) — @clack/prompts 기반.
-import * as clack from "@clack/prompts";
+// IDE Skills 대화형 프롬프트 (.sh 라우터 choose_menu 등가).
+// node:readline 기반 자체 엔진 사용 (@clack/prompts 는 Windows TTY Enter 버그로 제거).
+import * as engine from "./readline-engine.js";
 
-export const CANCEL = Symbol("cancel");
-const wrap = (v) => (clack.isCancel(v) ? CANCEL : v);
+export const CANCEL = engine.CANCEL;
 
 // 동작 선택: 설치/업데이트 · 제거 · 그대로. 취소=skip.
 export async function selectAction() {
-  const v = await clack.select({
+  const v = await engine.select({
     message: "AI 스킬을 어떻게 할까요?",
     options: [
       { value: "apply", label: "설치 / 업데이트 — 최신 상태로 맞추기" },
@@ -14,8 +14,7 @@ export async function selectAction() {
       { value: "skip", label: "그대로 두기" },
     ],
   });
-  const w = wrap(v);
-  return w === CANCEL ? "skip" : w;
+  return v === CANCEL ? "skip" : v;
 }
 
 // IDE 멀티셀렉트. choices=[{id,label,disabled}], preselect=[id...], action.
@@ -24,14 +23,14 @@ export async function selectTargets(choices, preselect = [], action = "apply") {
     value: c.id,
     label: c.label + (c.disabled ? " (미감지)" : ""),
     hint: c.disabled ? "CLI 없음" : undefined,
+    disabled: c.disabled,
   }));
-  const v = await clack.multiselect({
+  return engine.multiselect({
     message: `${action === "apply" ? "설치 / 업데이트" : "제거"}할 IDE를 고르세요 (Space 토글, Enter 확정)`,
     options,
     initialValues: preselect,
     required: false,
   });
-  return wrap(v);
 }
 
-export function note(text, title) { clack.note(text, title); }
+export function note(text, title) { engine.note(text, title); }

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("");
+}