projectops 4.0.2 → 4.0.3

package/README.md

@@ -7,7 +7,7 @@
 > 이슈 등록부터 커밋, 보고서, 배포까지. 개발자는 코드만 작성하세요.
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## 최신 버전 : v4.0.1 (2026-07-08)
+## 최신 버전 : v4.0.2 (2026-07-08)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 
@@ -91,7 +91,7 @@ GitHub에서 **"Use this template"** 클릭 → 1분 내 자동 초기화 완료
 npx projectops
 ```
 
-> Node.js 18+ 만 있으면 별도 설치 없이 대화형 마법사가 실행됩니다. 비대화형: `npx projectops --mode full --type spring,react --force`
+> Node.js 20.12+ 만 있으면 별도 설치 없이 대화형 마법사가 실행됩니다. 비대화형: `npx projectops --mode full --type spring,react --force`
 
 <details>
 <summary>대안 — 스크립트 직접 실행 (Node 없이)</summary>

package/bin/projectops.js

@@ -4,9 +4,9 @@ import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
 import { pathToFileURL } from "node:url";
 
-const nodeMajor = Number(process.versions.node.split(".")[0]);
-if (nodeMajor < 18) {
-  console.error(`Node.js 18 이상이 필요합니다 (현재: ${process.versions.node})`);
+const [nodeMajor, nodeMinor] = process.versions.node.split(".").map(Number);
+if (nodeMajor < 20 || (nodeMajor === 20 && nodeMinor < 12)) {
+  console.error(`Node.js 20.12 이상이 필요합니다 (현재: ${process.versions.node})`);
   process.exit(1);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "4.0.2",
+  "version": "4.0.3",
   "description": "ProjectOps — 완전 자동화 GitHub 프로젝트 관리 템플릿 통합 CLI (구 SUH-DEVOPS-TEMPLATE 마법사)",
   "keywords": [
     "devops",
@@ -41,9 +41,5 @@
     "skills": [
       "./skills"
     ]
-  },
-  "dependencies": {
-    "@clack/prompts": "^1.7.0",
-    "picocolors": "^1.1.1"
   }
 }

package/src/cli/args.js

@@ -5,7 +5,7 @@ import { VALID_TYPES } from "../context.js";
 export function parseArgs(argv) {
   const result = {
     mode: "interactive",
-    version: "",
+    version: "",             // 통합 대상 프로젝트의 초기 버전 (--project-version)
     types: [],
     primaryType: "",
     includeNexus: null,      // null=미설정
@@ -13,6 +13,7 @@ export function parseArgs(argv) {
     pathsCsv: "",            // "flutter=app,react=client" 원문 (정규화는 resolve 단계)
     force: false,
     help: false,
+    showVersion: false,      // -v/--version → projectops 패키지 버전 출력 (npm 관례)
   };
   const args = [...argv];
   while (args.length > 0) {
@@ -21,6 +22,9 @@ export function parseArgs(argv) {
       case "-m": case "--mode":
         result.mode = args.shift() ?? ""; break;
       case "-v": case "--version":
+        // npm 관례: -v/--version 은 패키지 버전 출력. (초기 버전 지정은 --project-version)
+        result.showVersion = true; break;
+      case "--project-version":
         result.version = args.shift() ?? ""; break;
       case "-t": case "--type": {
         const csv = args.shift() ?? "";

package/src/cli/help.js

@@ -10,11 +10,12 @@ export const HELP_TEXT = `projectops — GitHub 프로젝트 자동화 템플릿
   -t, --type CSV           프로젝트 타입 csv (예: spring,react,python)
                            지원: spring flutter next react react-native
                                  react-native-expo node python basic
-  -v, --version VERSION    초기 버전 (예: 1.0.0). 미지정 시 자동 감지
+      --project-version V  통합 대상의 초기 버전 (예: 1.0.0). 미지정 시 자동 감지
       --paths "t=p,..."    타입별 프로젝트 경로 (모노레포). 예: flutter=app,react=client
       --nexus / --no-nexus            Nexus 라이브러리 publish 워크플로우 포함/제외
       --secret-backup / --no-secret-backup   Secret 백업 워크플로우 포함/제외
       --force              모든 확인 생략, 비대화형 기본값 사용
+  -v, --version            projectops 버전 출력
   -h, --help               이 도움말 표시
 
 예시:

package/src/index.js

@@ -1,6 +1,8 @@
 // projectops CLI 진입 파이프라인 (.sh main + execute_integration 등가).
 // 감지 → 다운로드 → 모드 라우팅 → 통합 실행 → 정리. 비대화형(--force) 우선.
-import { join } from "node:path";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { readFileSync } from "node:fs";
 import { parseArgs, parsePathsCsv, CliError } from "./cli/args.js";
 import { HELP_TEXT } from "./cli/help.js";
 import { createContext } from "./context.js";
@@ -15,6 +17,17 @@ import { runIssues } from "./commands/issues.js";
 import { runInteractive } from "./commands/interactive.js";
 import { runSkills } from "./commands/skills.js";
 
+// projectops 패키지 버전 읽기 (-v/--version 출력용). src/../package.json.
+function readPkgVersion() {
+  try {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const pkg = JSON.parse(readFileSync(join(here, "..", "package.json"), "utf8"));
+    return pkg.version || "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
 // 결정적 UTC 타임스탬프 (주입 가능 — 테스트/골든용)
 function utcNow(date = new Date()) {
   const p = (n) => String(n).padStart(2, "0");
@@ -34,6 +47,7 @@ export async function run(argv, { cwd = process.cwd(), source = { type: "git" },
     if (e instanceof CliError) { console.error(e.message); return 1; }
     throw e;
   }
+  if (opts.showVersion) { console.log(readPkgVersion()); return 0; }
   if (opts.help) { console.log(HELP_TEXT); return 0; }
 
   // skills 모드 — IDE 스킬 설치/업데이트/제거 (템플릿 통합 없음).

package/src/ui/prompts.js

@@ -1,13 +1,13 @@
-// 대화형 프롬프트 래핑 (.sh interactive_menu/choose_menu/ask_* 등가) — @clack/prompts 기반.
+// 대화형 프롬프트 래핑 (.sh interactive_menu/choose_menu/ask_* 등가).
+// node:readline 기반 자체 엔진 사용 (@clack/prompts 는 Windows TTY에서 Enter가 멈추는 버그로 제거).
 // 취소(ESC/Ctrl+C)는 각 함수가 CANCEL 심볼을 반환 → 호출부가 정상 종료(exit 0) 처리.
-import * as clack from "@clack/prompts";
+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;
 
 // 모드 선택 — 한국어 라벨, 내부 키 반환. 취소 시 CANCEL.
 export async function selectMode() {
-  const v = await clack.select({
+  return engine.select({
     message: "무엇을 설치할까요?",
     options: [
       { value: "full", label: "전체 설치 — 버전관리 + 자동화 워크플로우 + 이슈·PR 템플릿 (처음이라면 추천)" },
@@ -17,12 +17,11 @@ export async function selectMode() {
       { value: "skills", label: "AI 스킬만 — Claude·Cursor·Gemini·Codex·PI용 스킬만 설치" },
     ],
   });
-  return wrap(v);
 }
 
 // 프로젝트 확인 화면 메뉴 (계속/수정/취소).
 export async function confirmProjectMenu() {
-  const v = await clack.select({
+  return engine.select({
     message: "이 정보로 진행할까요?",
     options: [
       { value: "continue", label: "예, 계속 진행" },
@@ -30,7 +29,6 @@ export async function confirmProjectMenu() {
       { value: "cancel", label: "아니오, 취소" },
     ],
   });
-  return wrap(v);
 }
 
 // 수정 메뉴 — 어떤 항목을 고칠지. showOptional=full/workflows에서만 nexus/secret 노출.
@@ -45,38 +43,34 @@ export async function editMenu({ showOptional = false } = {}) {
     options.push({ value: "secret", label: "Secret 백업 포함 여부" });
   }
   options.push({ value: "done", label: "모두 맞음, 계속" });
-  const v = await clack.select({ message: "어떤 항목을 수정할까요?", options });
-  return wrap(v);
+  return engine.select({ message: "어떤 항목을 수정할까요?", options });
 }
 
 // 타입 멀티선택.
 export async function selectTypes(current = []) {
   const all = ["spring", "flutter", "next", "react", "react-native", "react-native-expo", "node", "python", "basic"];
-  const v = await clack.multiselect({
+  return engine.multiselect({
     message: "프로젝트 타입을 선택하세요 (Space 토글, Enter 확정)",
     options: all.map((t) => ({ value: t, label: t })),
     initialValues: current.length ? current : ["basic"],
     required: true,
   });
-  return wrap(v);
 }
 
 // 텍스트 입력 (빈 입력=기본값 유지).
 export async function askText(message, defaultValue = "") {
-  const v = await clack.text({ message, placeholder: defaultValue, defaultValue });
-  const w = wrap(v);
-  if (w === CANCEL) return CANCEL;
-  return w === "" || w == null ? defaultValue : w;
+  const v = await engine.text({ message, defaultValue });
+  if (v === CANCEL) return CANCEL;
+  return v === "" || v == null ? defaultValue : v;
 }
 
 // 예/아니오.
 export async function askYesNo(message, initial = true) {
-  const v = await clack.confirm({ message, initialValue: initial });
-  return wrap(v);
+  return engine.confirm({ message, initialValue: initial });
 }
 
 // 배너·안내 출력.
-export function intro(text) { clack.intro(text); }
-export function outro(text) { clack.outro(text); }
-export function note(text, title) { clack.note(text, title); }
-export function cancelMessage(text = "취소했습니다.") { clack.cancel(text); }
+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); }

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); }