project-auto-wizard 0.1.16 → 0.1.18

package/README.md

@@ -16,7 +16,7 @@ npx project-auto-wizard
 [![node](https://img.shields.io/badge/node-%3E%3D20.12-brightgreen)](package.json)
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## 최신 버전 : v0.1.14 (2026-08-04)
+## 최신 버전 : v0.1.18 (2026-08-05)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 
@@ -154,6 +154,8 @@ npx project-auto-wizard --mode doctor   # 환경 진단 (읽기 전용, 규칙
 | `--mode status` | 설치된 버전·타입·브랜치 모드·옵션값과, 설치 시점 대비 사용자가 직접 수정한 워크플로우 파일 목록을 보여줍니다. 네트워크 접근 없음(로컬 파일 비교만) |
 | `--mode doctor` | `version.yml` 설치 여부, `gh` CLI 설치/인증 상태, GitHub Actions workflow permissions, `WORKFLOW_PAT` secret 등록 여부, merge commit 허용 설정을 점검합니다. `gh api` 호출을 사용하므로 네트워크 접근이 발생합니다(규칙 기반 점검 — AI 진단 아님) |
 
+> **드리프트 판정 기준**: `--mode status`는 설치된 워크플로우 파일이 "설치 시점 기본값 템플릿"과 바이트 단위로 일치하는지만 비교합니다 — 파일을 직접 편집했는지는 추적하지 않습니다. 대화형 설치에서 `@wizard ask` 질문(예: 배포 포트)에 기본값이 아닌 값으로 응답했다면, 파일을 전혀 수정하지 않았더라도 설치 직후부터 항상 "사용자가 수정한 워크플로우 파일"로 표시됩니다. 정상 동작이며, 파일을 직접 편집했는지 구분하려면 해당 값이 예상한 응답과 일치하는지 직접 확인하세요.
+
 `--dry-run`을 어떤 모드와도 함께 쓰면 실제로 파일을 바꾸지 않고 무엇이 바뀔지만 미리 보여줍니다(`full`/`version`/`workflows`/`revert` 전체 지원):
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-auto-wizard",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "One command DevOps: npx wizard that installs GitHub-native AI Release Automation into any project",
   "license": "MIT",
   "type": "module",

package/src/commands/interactive.js

@@ -20,6 +20,8 @@ import { runWorkflows } from "./workflows.js";
 import { runRevert } from "./revert.js";
 import { runUninstallFlow } from "./uninstall.js";
 import * as prompts from "../ui/prompts.js";
+import { runStatus, printStatus } from "./status.js";
+import { runDoctor, printDoctorReport } from "./doctor.js";
 
 const CANCEL = prompts.CANCEL;
 const isCancel = (v) => v === CANCEL || typeof v === "symbol";
@@ -44,6 +46,10 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   const mode = await io.selectMode();
   if (mode === CANCEL || mode == null) { io.cancelMessage?.("설치를 취소했습니다."); return 0; }
 
+  // status/doctor — 읽기 전용, 감지·breaking 게이트 불필요. CLI --mode status/doctor(index.js)와 동일하게 즉시 종료.
+  if (mode === "status") { printStatus(runStatus(payload, cwd)); return 0; }
+  if (mode === "doctor") { printDoctorReport(runDoctor(cwd)); return 0; }
+
   // revert 모드 — 확인 질문(기본 아니오) 후 payload 유래 파일 제거. 감지·breaking 게이트 불필요.
   if (mode === "revert") {
     const ok = await io.askYesNo("마법사가 설치한 워크플로우·스크립트를 제거할까요? (version.yml·README는 보존)", false);

package/src/core/detect-fs.js

@@ -27,13 +27,12 @@ export function detectTypes(root) {
   return detectTypesFromMarkers({ has: hasFile(root), read: readFile(root) });
 }
 
-// 버전 감지 — .sh detect_version 순서. jq 유무는 command 존재로 판정.
-export function detectVersion(root, { hasJq } = {}) {
+// 버전 감지 — .sh detect_version 순서. jq는 package.json 파싱에 쓰인 적이 없어 게이트를 제거했다(이슈 #22 L4).
+export function detectVersion(root, { warn = (m) => console.error(m) } = {}) {
   const read = readFile(root);
   const readJson = (rel) => { const c = read(rel); try { return c ? JSON.parse(c) : null; } catch { return null; } };
-  const jq = hasJq ?? hasCommand("jq");
   const gitTag = gitOut(root, ["describe", "--tags", "--abbrev=0"]);
-  return detectVersionFromFiles({ read, readJson, hasJq: jq, gitTag });
+  return detectVersionFromFiles({ read, readJson, gitTag, warn });
 }
 
 // 기본 브랜치 감지 — symbolic-ref → remote show → main.
@@ -56,13 +55,6 @@ export function detectRepoName(root) {
   return basename(root);
 }
 
-function hasCommand(cmd) {
-  try {
-    execFileSync(process.platform === "win32" ? "where" : "which", [cmd], { stdio: "ignore" });
-    return true;
-  } catch { return false; }
-}
-
 // Spring application*.yml 탐색 (.sh resolve_spring_app_yml_dir/path L2767~2780 등가)
 // find {base} -path "*/src/main/resources/application*.yml" | head -1 의 fs 재귀 구현.
 // 반환: root 기준 상대경로 (예: "server/src/main/resources/application.yml") 또는 "".

package/src/core/detect.js

@@ -35,9 +35,10 @@ export function detectTypesFromMarkers({ has, read }) {
 const VERSION_RE = /^\d+\.\d+\.\d+$/;
 
 // 버전 감지 (동작명세 §3.3) — 순서대로 첫 성공. read(relpath)=>string|null 주입.
-export function detectVersionFromFiles({ read, readJson, hasJq, gitTag }) {
+// package.json은 이미 Node JSON.parse로 파싱을 마친 값이므로 jq 설치 여부와 무관하게 항상 사용한다(이슈 #22 L4).
+export function detectVersionFromFiles({ read, readJson, gitTag, warn }) {
   const pkg = readJson?.("package.json");
-  if (hasJq && pkg?.version && VERSION_RE.test(pkg.version)) return pkg.version;
+  if (pkg?.version && VERSION_RE.test(pkg.version)) return pkg.version;
   const grab = (content, re) => {
     for (const line of (content || "").split("\n")) {
       const m = line.match(re);
@@ -50,6 +51,7 @@ export function detectVersionFromFiles({ read, readJson, hasJq, gitTag }) {
   if ((v = grab(read("pubspec.yaml"), /^version:\s*(\d+\.\d+\.\d+)/))) return v;
   if ((v = grab(read("pyproject.toml"), /version\s*=\s*["']?(\d+\.\d+\.\d+)/))) return v;
   if (gitTag) { const t = String(gitTag).replace(/^v/, ""); if (VERSION_RE.test(t)) return t; }
+  warn?.("⚠️  버전을 자동 감지하지 못해 기본값 0.0.1을 사용합니다 — --project-version으로 직접 지정하거나 version.yml을 확인하세요.");
   return "0.0.1";
 }
 

package/src/ui/ansi.js

@@ -1,4 +1,4 @@
-// 공용 ANSI 헬퍼 — banner/status-cards가 공유 (readline-engine 내부 헬퍼와 독립, 의존성 0)
+// 공용 ANSI 헬퍼 — banner/status-cards/summary가 공유 (readline-engine 내부 헬퍼와 독립, 의존성 0)
 const E = "\x1b[";
 export const A = {
   reset: `${E}0m`,
@@ -10,7 +10,15 @@ export const A = {
   magenta: `${E}35m`,
   gray: `${E}90m`,
 };
-export const paint = (s, color) => `${color}${s}${A.reset}`;
+
+// NO_COLOR(https://no-color.org) 환경변수 또는 대상 스트림이 TTY가 아니면 색상을 끈다.
+// no-color.org 규격상 NO_COLOR는 "값과 무관하게 존재 여부"만 본다 — NO_COLOR=""(빈 문자열)도
+// "설정됨"으로 취급해야 하므로 truthy 체크(`!process.env.NO_COLOR`)가 아니라 존재 체크를 쓴다.
+export function colorEnabled(stream = process.stdout) {
+  return process.env.NO_COLOR === undefined && !!stream.isTTY;
+}
+
+export const paint = (s, color, enabled = colorEnabled()) => (enabled ? `${color}${s}${A.reset}` : String(s));
 
 // 대략적 표시 폭 (CJK 2칸 · ANSI 시퀀스 0칸) — 박스 우변 정렬용
 export function visualWidth(s) {

package/src/ui/prompts.js

@@ -15,6 +15,8 @@ export async function selectMode() {
       { value: "workflows", label: "워크플로우만 — 빌드·배포 GitHub Actions만 설치" },
       { value: "revert", label: "되돌리기 — 마법사가 설치한 워크플로우·스크립트 제거" },
       { value: "uninstall", label: "완전 삭제 — 마법사가 설치·수정한 모든 항목 제거(확인 후, README·gitignore·version.yml 포함)" },
+      { value: "status", label: "설치 상태 확인 — 읽기 전용, 버전·타입·드리프트 확인" },
+      { value: "doctor", label: "환경 진단 — 읽기 전용, gh CLI·권한·secret 설정 점검" },
     ],
   });
 }

package/src/ui/readline-engine.js

@@ -15,7 +15,10 @@ 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}`;
+// NO_COLOR(https://no-color.org)/비TTY 가드 — ansi.js와 동일한 규칙(존재 여부만 체크, 값 무관)이지만
+// 의존성 0 유지를 위해 자체 구현.
+const colorEnabled = () => process.env.NO_COLOR === undefined && !!stdout.isTTY;
+const paint = (s, color, enabled = colorEnabled()) => (enabled ? `${color}${s}${c.reset}` : String(s));
 const hideCursor = () => stdout.write(`${ESC}?25l`);
 const showCursor = () => stdout.write(`${ESC}?25h`);
 
@@ -55,15 +58,22 @@ function keySession(renderFn, onKey) {
 
     const cleanup = () => {
       stdin.removeListener("keypress", handler);
+      stdin.removeListener("end", onEnd);
       if (stdin.isTTY) stdin.setRawMode(wasRaw);
       stdin.pause();
       showCursor();
     };
 
+    // stdin 종료(EOF/Ctrl+D, SSH 연결 끊김 등) — 취소(ESC/Ctrl+C)와 동일하게 처리해 무한 대기를 방지한다.
+    const onEnd = () => {
+      cleanup();
+      resolve(CANCEL);
+    };
+
     const handler = (str, key) => {
       key = key || {};
-      // 취소: Ctrl+C / ESC
-      if ((key.ctrl && key.name === "c") || key.name === "escape") {
+      // 취소: Ctrl+C / Ctrl+D / ESC (raw mode에서는 Ctrl+D가 stdin "end"가 아니라 일반 keypress로 들어온다)
+      if ((key.ctrl && (key.name === "c" || key.name === "d")) || key.name === "escape") {
         cleanup();
         resolve(CANCEL);
         return;
@@ -77,6 +87,7 @@ function keySession(renderFn, onKey) {
       }
     };
     stdin.on("keypress", handler);
+    stdin.on("end", onEnd);
     renderFn(); // 최초 렌더
   });
 }
@@ -194,14 +205,22 @@ export async function text({ message, defaultValue = "" }) {
 
     const cleanup = () => {
       stdin.removeListener("keypress", handler);
+      stdin.removeListener("end", onEnd);
       if (stdin.isTTY) stdin.setRawMode(wasRaw);
       stdin.pause();
       stdout.write("\n");
     };
 
+    // stdin 종료(EOF/Ctrl+D) — 취소와 동일하게 처리해 무한 대기를 방지한다.
+    const onEnd = () => {
+      cleanup();
+      resolve(CANCEL);
+    };
+
     const handler = (str, key) => {
       key = key || {};
-      if ((key.ctrl && key.name === "c") || key.name === "escape") { cleanup(); resolve(CANCEL); return; }
+      // 취소: Ctrl+C / Ctrl+D / ESC (raw mode에서는 Ctrl+D가 stdin "end"가 아니라 일반 keypress로 들어온다)
+      if ((key.ctrl && (key.name === "c" || key.name === "d")) || key.name === "escape") { cleanup(); resolve(CANCEL); return; }
       if (key.name === "return" || key.name === "enter") {
         cleanup();
         resolve(buf.length ? buf : defaultValue);
@@ -212,6 +231,7 @@ export async function text({ message, defaultValue = "" }) {
       if (str && !key.ctrl && !key.meta && str.length === 1 && str >= " ") { buf += str; prompt(); return; }
     };
     stdin.on("keypress", handler);
+    stdin.on("end", onEnd);
     prompt();
   });
 }

package/src/ui/summary.js

@@ -1,17 +1,15 @@
 // 완료 요약 출력 (.sh print_summary 등가). 전부 stderr.
 // ctx: { mode, types:[], version, copiedFiles:[], branches?, gitignoreUpdated? }
 import { WORKFLOW_PREFIX, WORKFLOW_COMMON_PREFIX } from "../core/paths.js";
+import { paint, A, colorEnabled } from "./ansi.js";
 
 const SEPARATOR = "────────────────────────────────────────";
 
 export function printSummary(ctx) {
   const { mode, types = [], version = "", copiedFiles = [], branches = null, gitignoreUpdated = 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" : "";
+  // 색상은 ansi.js의 공용 가드로 통일 (NO_COLOR + stderr TTY 여부)
+  const enabled = colorEnabled(process.stderr);
 
   err("");
   err(SEPARATOR);
@@ -102,7 +100,7 @@ export function printSummary(ctx) {
   // 필수 작업 안내
   err(SEPARATOR);
   err("");
-  err(`${YELLOW}⚠️  다음 작업을 확인해주세요:${NC}`);
+  err(paint(paint("⚠️  다음 작업을 확인해주세요:", A.yellow, enabled), A.bold, enabled));
   err("");
   err("  1️⃣  릴리스 automerge용 PAT (선택 — 없으면 GITHUB_TOKEN 사용)");
   err("     → Repository Settings > Secrets > Actions");
@@ -114,6 +112,6 @@ export function printSummary(ctx) {
   err("");
   err(SEPARATOR);
   err("");
-  err(`${CYAN}📖 워크플로우 구성과 릴리스 흐름은 README를 참고하세요.${NC}`);
+  err(paint("📖 워크플로우 구성과 릴리스 흐름은 README를 참고하세요.", A.cyan, enabled));
   err("");
 }