projectops 4.2.1 → 4.2.3

package/README.md

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "4.2.1",
+  "version": "4.2.3",
   "description": "ProjectOps — 완전 자동화 GitHub 프로젝트 관리 템플릿 통합 CLI (구 SUH-DEVOPS-TEMPLATE 마법사)",
   "keywords": [
     "devops",

package/src/core/options-ask.js

@@ -63,6 +63,11 @@ export async function askAllOptionalWorkflows({
   let publish = current.publish ?? null;
   let secretBackup = current.secretBackup ?? null;
 
+  // basic 단독 타입은 서버 배포도 라이브러리 publish도 개념상 성립하지 않는다.
+  // 배포/publish 질문을 건너뛰고 none·[]로 조용히 확정한다 (타입 변경 시 재질문됨).
+  // (basic은 "그 외" 폴백이라 항상 단독으로만 존재 — every로 안전 판정)
+  const isBasicOnly = types.length > 0 && types.every((t) => t === "basic");
+
   // ① --force-ask가 아니면 version.yml 저장값을 먼저 읽어 재질문을 건너뛴다.
   //    CLI 명시값(current)이 이미 있으면 그쪽이 우선 — 저장값은 빈 자리만 채운다.
   if (!forceAsk) {
@@ -84,47 +89,54 @@ export async function askAllOptionalWorkflows({
     }
   }
 
-  // ── ② 배포 방식 (택1) ──
-  if ((forceAsk || deploy === null)) {
-    if (force || !tty || typeof io.select !== "function") {
-      deploy = deploy ?? "docker-ssh";
-    } else {
-      say("");
-      say("🚀 이 프로젝트를 어디에 배포하나요?");
-      const ans = await io.select({
-        message: "배포 방식을 선택하세요",
-        options: [
-          { value: "docker-ssh", label: "Docker + SSH 서버 배포 (기본)" },
-          { value: "vercel", label: "Vercel" },
-          { value: "none", label: "배포하지 않음 (라이브러리/CI 전용)" },
-        ],
-      });
-      deploy = (!isCancel(ans) && DEPLOY_TARGETS.includes(ans)) ? ans : (deploy ?? "docker-ssh");
-      say(`배포 방식: ${deploy}`);
+  // ── ② 배포 방식 (택1) — basic 단독이면 질문 스킵, none으로 확정 ──
+  if (isBasicOnly) {
+    if (deploy === null) deploy = "none";
+    if (publish === null) publish = [];
+  } else {
+    if (forceAsk || deploy === null) {
+      if (force || !tty || typeof io.select !== "function") {
+        deploy = deploy ?? "docker-ssh";
+      } else {
+        say("");
+        say("🚀 이 프로젝트를 어디에 배포하나요?");
+        say("   서버·호스팅에 올릴 계획이 있으면 고르고, 지금 없으면 '배포 안 함'으로 두면 됩니다.");
+        const ans = await io.select({
+          message: "배포 방식을 선택하세요",
+          options: [
+            { value: "docker-ssh", label: "Docker + SSH 서버 배포 (기본)" },
+            { value: "vercel", label: "Vercel" },
+            { value: "none", label: "배포하지 않음 (라이브러리/CI 전용)" },
+          ],
+        });
+        deploy = (!isCancel(ans) && DEPLOY_TARGETS.includes(ans)) ? ans : (deploy ?? "docker-ssh");
+        say(`배포 방식: ${deploy}`);
+      }
     }
-  }
 
-  // ── ③ publish 타겟 (다중 선택) ──
-  if ((forceAsk || publish === null)) {
-    if (force || !tty || typeof io.multiselect !== "function") {
-      publish = publish ?? [];
-    } else {
-      say("");
-      say("📦 라이브러리/패키지 publish 레지스트리가 있나요? (없으면 그냥 Enter)");
-      const ans = await io.multiselect({
-        message: "publish 타겟을 선택하세요 (Space 토글, Enter 확정)",
-        options: [
-          { value: "nexus", label: "사내 Maven(Nexus) 라이브러리 배포" },
-          { value: "npm", label: "공개 npmjs 패키지 배포 (NPM_TOKEN)" },
-          { value: "github-packages", label: "GitHub Packages 라이브러리 배포" },
-        ],
-        initialValues: publish ?? [],
-        required: false,
-      });
-      publish = (!isCancel(ans) && Array.isArray(ans))
-        ? ans.filter((t) => PUBLISH_TARGETS.includes(t))
-        : (publish ?? []);
-      say(`Publish 타겟: ${publish.join(",") || "없음"}`);
+    // ── ③ publish 타겟 (다중 선택) ──
+    if (forceAsk || publish === null) {
+      if (force || !tty || typeof io.multiselect !== "function") {
+        publish = publish ?? [];
+      } else {
+        say("");
+        say("📦 라이브러리로 배포(publish)할 계획이 있나요?");
+        say("   사내 Nexus·npmjs·GitHub Packages 중 해당되는 걸 고르세요. 없으면 그냥 Enter.");
+        const ans = await io.multiselect({
+          message: "publish 타겟을 선택하세요 (Space 토글, Enter 확정)",
+          options: [
+            { value: "nexus", label: "사내 Maven(Nexus) 라이브러리 배포" },
+            { value: "npm", label: "공개 npmjs 패키지 배포 (NPM_TOKEN)" },
+            { value: "github-packages", label: "GitHub Packages 라이브러리 배포" },
+          ],
+          initialValues: publish ?? [],
+          required: false,
+        });
+        publish = (!isCancel(ans) && Array.isArray(ans))
+          ? ans.filter((t) => PUBLISH_TARGETS.includes(t))
+          : (publish ?? []);
+        say(`Publish 타겟: ${publish.join(",") || "없음"}`);
+      }
     }
   }
 

package/src/ui/ansi.js

@@ -24,3 +24,10 @@ export function visualWidth(s) {
   }
   return w;
 }
+
+// 시각 폭(CJK 2칸) 기준으로 오른쪽 스페이스 패딩 — 한글·영문 혼합 라벨 열 정렬용.
+// JS 기본 String.padEnd는 문자 수 기준이라 한글이 섞이면 열이 어긋난다.
+export function padEndVisual(s, targetWidth) {
+  const pad = targetWidth - visualWidth(s);
+  return pad > 0 ? String(s) + " ".repeat(pad) : String(s);
+}

package/src/ui/readline-engine.js

@@ -6,6 +6,7 @@
 // 계약: 취소(ESC/Ctrl+C)는 CANCEL 심볼 반환. 각 함수 async.
 import { emitKeypressEvents } from "node:readline";
 import { stdin, stdout } from "node:process";
+import { visualWidth } from "./ansi.js";
 
 export const CANCEL = Symbol("cancel");
 
@@ -28,18 +29,31 @@ const S_BAR = paint("│", c.gray);
 const S_Q = paint("◆", c.cyan);
 const S_DONE = paint("◇", c.green);
 
+// 한 논리 라인이 터미널 폭에서 차지하는 물리 줄 수 (wrap 고려).
+// WHY: 긴 라벨(한글 2칸 포함)이 터미널 폭을 넘으면 터미널이 자동 줄바꿈해 물리적으로 2줄+가 된다.
+//   커서 되감기(ESC[nA)는 물리 줄 기준이므로, 논리 줄 수만 세면 wrap된 만큼 덜 올라가
+//   이전 출력이 안 지워지고 매 렌더마다 화면이 아래로 밀린다. (실측: Windows PowerShell 폭 80)
+export function physicalRows(line, cols) {
+  const w = visualWidth(line); // ANSI 시퀀스 제외 + CJK 2칸
+  if (cols <= 0) return 1;
+  // 빈 줄도 최소 1행. 폭의 정수배로 딱 떨어지면 wrap 안 되므로 그대로(80칸 라인@80폭 = 1행).
+  if (w === 0) return 1;
+  return Math.max(1, Math.ceil(w / cols));
+}
+
 // 여러 줄 지운 뒤 커서를 블록 시작으로 되돌리는 렌더러.
-// prevLines 만큼 위로 올라가 지우고 새로 그린다.
+// 직전 렌더의 "물리 줄 수"만큼 위로 올라가 지우고 새로 그린다 (wrap 안전).
 function makeRenderer() {
-  let prevLines = 0;
+  let prevRows = 0; // 직전 렌더가 실제로 차지한 물리 줄 수
   return {
     render(lines) {
-      if (prevLines > 0) stdout.write(`${ESC}${prevLines}A`); // 위로
+      if (prevRows > 0) stdout.write(`${ESC}${prevRows}A`); // 물리 줄 기준으로 위로
       stdout.write(`${ESC}0J`); // 커서 아래 전부 지우기
       stdout.write(lines.join("\n") + "\n");
-      prevLines = lines.length;
+      const cols = stdout.columns || 80; // 터미널 폭 (파이프 등으로 없으면 80 가정)
+      prevRows = lines.reduce((sum, l) => sum + physicalRows(l, cols), 0);
     },
-    reset() { prevLines = 0; },
+    reset() { prevRows = 0; },
   };
 }
 

package/src/ui/status-cards.js

@@ -1,6 +1,6 @@
 // 첫 화면 상태 표시 층 (#446 층2~5) — 감지 로그 · 분석 카드 · IDE 상태 · 신규/업데이트 판별
 // (층5의 Breaking Changes 박스는 core/breaking-check.js가 담당)
-import { A, paint } from "./ansi.js";
+import { A, paint, padEndVisual } from "./ansi.js";
 import { ADAPTERS } from "../core/ide/registry.js";
 import { markerForType } from "../core/detect.js";
 
@@ -28,7 +28,9 @@ export function printAnalysisCard({ mode = "", modeLabel = "", types = [], versi
   deployTarget = null, publishTargets = 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`);
+  // 라벨을 시각 폭(CJK 2칸) 기준으로 패딩 — 한글·영문 혼합 라벨(타입·Publish·Secret백업) 열 정렬.
+  // 가장 긴 라벨 "Secret백업"(=8칸) 기준 여유 두고 12.
+  const row = (icon, label, value) => out(`${GUT}  ${icon} ${padEndVisual(label, 12)} ${value}\n`);
   row("📂", types.length > 1 ? "타입(멀티)" : "타입", paint(types.join(", ") || "basic", A.bold));
   row("🌙", "버전", paint(`v${version}`, A.green));
   row("🌿", "브랜치", branch);
@@ -78,11 +80,15 @@ export function printIdeStatus(statuses, out = (s) => process.stdout.write(s)) {
 }
 
 // 층5 — 신규 통합 vs 업데이트 판별 라인 (Breaking 박스는 breaking-check.js)
+// WHY 판정: version.yml의 metadata.template.version(이전 통합 흔적)이 있으면 업데이트, 없으면 신규.
+// 사용자가 "무슨 기준으로 신규/업데이트인지"를 바로 알도록 판정 근거를 화면에 밝힌다.
 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`);
+    out(`${GUT}     ${paint("version.yml에 이전 통합 기록이 있어 업데이트로 진행합니다", A.dim)}\n`);
   } else {
     out(`${GUT}  🆕 ${paint("신규 통합", A.bold)} — 이 프로젝트에 처음 설치합니다 (템플릿 ${paint(`v${templateVersion}`, A.green)})\n`);
+    out(`${GUT}     ${paint("version.yml에 이전 통합 기록이 없어 신규로 봅니다", A.dim)}\n`);
   }
   out(`${GUT}\n`);
 }