project-auto-wizard 0.1.5

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/status-cards.js

@@ -0,0 +1,56 @@
+// 첫 화면 상태 표시 층 (#446 층2·3·5) — 감지 로그 · 분석 카드 · 신규/업데이트 판별
+// (층5의 Breaking Changes 박스는 core/breaking-check.js가 담당.
+//  원본의 층4 IDE Skills 상태는 project-auto-wizard 스코프 제외 — Agent Skills 미포함)
+import { A, paint } from "./ansi.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`);
+}
+
+// 층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,127 @@
+// 완료 요약 출력 (.sh print_summary 등가). 전부 stderr.
+// ctx: { mode, types:[], version, counters:{ workflows }, branches?, includeCodeRabbit? }
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { PATHS, WORKFLOW_PREFIX, WORKFLOW_COMMON_PREFIX } from "../core/paths.js";
+import { listYamlFiles } from "../core/fsutil.js";
+
+const SEPARATOR = "────────────────────────────────────────";
+
+export function printSummary(ctx, targetRoot = ".") {
+  const { mode, types = [], version = "", counters = {}, branches = null, includeCodeRabbit = false } = 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 workflowsCopied = counters.workflows ?? 0;
+
+  err("");
+  err(SEPARATOR);
+  err("");
+  err("✨ project-auto-wizard Setup Complete!");
+  err("");
+  err(SEPARATOR);
+  err("");
+  err("통합된 기능:");
+
+  // 모드별 체크리스트
+  switch (mode) {
+    case "full":
+      err("  ✅ 버전 관리 시스템 (version.yml)");
+      err("  ✅ README.md 자동 버전 업데이트");
+      err("  ✅ GitHub Actions 워크플로우 (AI 릴리스 자동화 포함)");
+      err("  ✅ .gitignore 필수 항목");
+      break;
+    case "version":
+      err("  ✅ 버전 관리 시스템 (version.yml)");
+      err("  ✅ README.md 자동 버전 업데이트");
+      err("  ✅ .gitignore 필수 항목");
+      break;
+    case "workflows":
+      err("  ✅ GitHub Actions 워크플로우 (AI 릴리스 자동화 포함)");
+      break;
+  }
+
+  // 브랜치 모드 + 릴리스 요약 엔진 안내 (DESIGN-SPEC §4~5)
+  if (branches) {
+    err("");
+    err("브랜치 구성:");
+    if (branches.mode === "trunk-based") {
+      err(`  🌿 ${branches.main} 단일 브랜치 (trunk-based) — RELEASE-PUBLISH 하나가 버전확정→체인지로그→tag→Release를 순차 처리`);
+    } else {
+      err(`  🌿 개발 ${branches.develop} → 릴리스 ${branches.main} (pr-flow) — 릴리스 PR에서 버전확정·AI 체인지로그·automerge`);
+    }
+  }
+  if (mode === "full" || mode === "workflows") {
+    err("");
+    err("릴리스 노트 요약 엔진:");
+    if (includeCodeRabbit) err("  🤖 1순위 CodeRabbit PR 요약 (opt-in) → AI_API_KEY → GitHub Models(무료) → 규칙 fallback");
+    else err("  🤖 AI_API_KEY(선택) → GitHub Models(기본·무료·API 키 불필요) → 규칙 fallback — 릴리스는 절대 막히지 않음");
+  }
+
+  err("");
+  err("추가된 파일:");
+  err(`  📄 version.yml (버전: ${version}, 타입: ${types.join(",")})`);
+  err("  📝 README.md (버전 섹션 추가)");
+  err("");
+  err("추가된 워크플로우:");
+
+  // 실제 복사된 워크플로우 분류
+  const commonWorkflows = [];
+  const typeWorkflows = [];
+  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.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}`);
+  }
+
+  err("");
+  err("  🔧 .github/scripts/");
+  err("     ├─ version_manager.py");
+  err("     └─ changelog_manager.py");
+  err("");
+
+  // 프로젝트 타입별 안내
+  if (types.includes("spring")) {
+    err("  💡 Spring 프로젝트 추가 설정:");
+    err("     • build.gradle의 버전 정보가 자동 동기화됩니다");
+    err("     • CI/CD 워크플로우에서 GitHub Secrets 설정이 필요합니다");
+    err("");
+  }
+
+  err("  📖 REPO: https://github.com/Twin-Fang/project-auto-wizard");
+  err("");
+
+  // 필수 작업 안내
+  err(SEPARATOR);
+  err("");
+  err(`${YELLOW}⚠️  다음 작업을 확인해주세요:${NC}`);
+  err("");
+  err("  1️⃣  릴리스 automerge용 PAT (선택 — 없으면 GITHUB_TOKEN 사용)");
+  err("     → Repository Settings > Secrets > Actions");
+  err("     → Secret Name: WORKFLOW_PAT (Scopes: repo, workflow)");
+  err("     → GITHUB_TOKEN 머지는 후속 워크플로우를 트리거하지 않습니다");
+  err("");
+  err("  2️⃣  GitHub Actions 권한 확인");
+  err("     → Settings > Actions > Workflow permissions: Read and write");
+  err("");
+  err(SEPARATOR);
+  err("");
+  err(`${CYAN}📖 워크플로우 구성과 릴리스 흐름은 README를 참고하세요.${NC}`);
+  err("");
+}