project-auto-wizard 0.1.20 → 0.1.23

package/README.md

@@ -11,12 +11,13 @@ npx project-auto-wizard
 <!-- TODO: 30초 데모 GIF (docs/assets/demo.gif) -->
 <!-- TODO: 3분 데모 YouTube 링크 -->
 
+[![CI](https://github.com/Twin-Fang/project-auto-wizard/actions/workflows/CI.yaml/badge.svg)](https://github.com/Twin-Fang/project-auto-wizard/actions/workflows/CI.yaml)
 [![npm](https://img.shields.io/npm/v/project-auto-wizard)](https://www.npmjs.com/package/project-auto-wizard)
 [![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![node](https://img.shields.io/badge/node-%3E%3D20.12-brightgreen)](package.json)
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## 최신 버전 : v0.1.18 (2026-08-06)
+## 최신 버전 : v0.1.23 (2026-08-06)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 
@@ -163,13 +164,17 @@ npx project-auto-wizard --mode doctor   # 환경 진단 (읽기 전용, 규칙
   [✓] GitHub 로그인 — 레포 설정 조회 권한          인증됨
   [✓] merge commit 허용 — 릴리스 PR 자동 머지 조건  허용됨
 
-  [!] Workflow permissions — 버전 커밋 자동 push
-      ✗ 현재 read 입니다.
-        워크플로가 버전 올림 커밋을 push하지 못해 릴리스가 중단됩니다.
-      → 레포 Settings → Actions → General → Workflow permissions
-      → "Read and write permissions" 선택 후 Save
+  [!] WORKFLOW_PAT — 자동 태그·Release 발행
+      ✗ secret이 등록되어 있지 않습니다.
+        PR 자동 머지 뒤 태그·Release 워크플로가 이어지지 않습니다.
+        (GitHub 정책상 기본 토큰으로 만든 커밋은 다음 워크플로를 깨우지 못합니다)
+      → 개인 액세스 토큰 발급 (scopes: repo, workflow)
+      → 레포 Settings → Secrets and variables → Actions
+      → New repository secret · 이름은 WORKFLOW_PAT
       → 자세히: https://github.com/Twin-Fang/project-auto-wizard#post-install
 
+  [i] Workflow permissions — 직접 추가한 워크플로우의 기본 권한
+      현재 read 입니다 — 마법사가 설치한 워크플로우는 각자 권한을 선언하므로 그대로 동작합니다.
   [i] GitHub Models — AI 릴리스 노트 생성
       조직 정책으로 차단됐는지는 자동으로 확인할 수 없습니다 (Settings → Models).
       차단돼 있어도 규칙 기반 요약으로 자동 전환되므로 그대로 두셔도 됩니다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-auto-wizard",
-  "version": "0.1.20",
+  "version": "0.1.23",
   "description": "One command DevOps: npx wizard that installs GitHub-native AI Release Automation into any project",
   "license": "MIT",
   "type": "module",
@@ -17,7 +17,7 @@
   ],
   "scripts": {
     "test": "npm run test:node && npm run test:py",
-    "test:node": "node --test \"tests/node/**/*.test.js\"",
+    "test:node": "node --test --test-concurrency=1",
     "test:py": "node scripts/run-py-tests.mjs"
   },
   "repository": {

package/payload/workflows/common/PROJECT-COMMON-RELEASE-PUBLISH.yaml

@@ -322,7 +322,10 @@ jobs:
       - name: Create GitHub Release
         if: steps.gate.outputs.proceed == 'true' && steps.version.outputs.release_exists != 'true'
         env:
-          GH_TOKEN: ${{ github.token }}
+          # WORKFLOW_PAT으로 발행해야 release 이벤트가 후속 워크플로우(npm 배포 등)를 트리거한다.
+          # GITHUB_TOKEN이 만든 이벤트는 GitHub 정책상 다른 워크플로우를 깨우지 못한다.
+          # PAT이 없는 레포에서도 릴리스 자체는 계속 동작해야 하므로 기본 토큰으로 폴백한다.
+          GH_TOKEN: ${{ secrets.WORKFLOW_PAT || github.token }}
         run: |
           VERSION="${{ steps.version.outputs.version }}"
           gh release create "v$VERSION" --title "v$VERSION" --notes-file notes.md

package/src/commands/doctor.js

@@ -83,26 +83,31 @@ export function runDoctor(cwd = process.cwd(), { exec = defaultExec } = {}) {
 
   const perm = exec("gh", ["api", `repos/${owner}/${repo}/actions/permissions/workflow`, "--jq", ".default_workflow_permissions"]);
   const permValue = (perm.stdout || "").trim();
+  // 이 값은 "워크플로우가 permissions를 생략했을 때 적용되는 기본값"이지 상한이 아니다(#34).
+  // 마법사가 설치하는 워크플로우는 전부 자체 permissions를 선언하므로(회귀 가드:
+  // tests/node/payload-workflow-permissions.test.js) read여도 정상 동작한다 — 이 레포 자체가
+  // read인데 VERSION-CONTROL이 버전 커밋 push에 성공하는 것이 그 증거다.
+  const PERM_PURPOSE = "직접 추가한 워크플로우의 기본 권한";
   if (perm.status !== 0) {
+    // 조회 실패는 오진이 아니라 실제로 정보를 얻지 못한 상태다 — 관리자 확인이라는 조치가 있다.
     add({
-      name: "Workflow permissions", purpose: "버전 커밋 자동 push", status: "WARN",
+      name: "Workflow permissions", purpose: PERM_PURPOSE, status: "WARN",
       value: "설정을 조회하지 못했습니다.",
       impact: ["레포 관리자 권한이 없으면 이 설정은 조회되지 않습니다 — 값 자체는 정상일 수 있습니다."],
       actions: ["레포 관리자에게 Settings → Actions → General → Workflow permissions 값을 확인하세요"],
       doc: DOC.postInstall,
     });
   } else if (permValue === "write") {
-    add({ name: "Workflow permissions", purpose: "버전 커밋 자동 push", status: "OK", value: "Read and write" });
+    add({ name: "Workflow permissions", purpose: PERM_PURPOSE, status: "OK", value: "Read and write" });
   } else {
+    // 조치가 필요 없으므로 WARN이 아니라 INFO다. 경고로 띄우면 없는 장애를 알리고
+    // 불필요한 권한 상향을 유도해 최소 권한 원칙에 역행한다.
     add({
-      name: "Workflow permissions", purpose: "버전 커밋 자동 push", status: "WARN",
-      value: `현재 ${permValue || "확인불가"} 입니다.`,
-      impact: ["워크플로가 버전 올림 커밋을 push하지 못해 릴리스가 중단됩니다."],
-      actions: [
-        "레포 Settings → Actions → General → Workflow permissions",
-        '"Read and write permissions" 선택 후 Save',
+      name: "Workflow permissions", purpose: PERM_PURPOSE, status: "INFO",
+      note: [
+        `현재 ${permValue || "확인불가"} 입니다 — 마법사가 설치한 워크플로우는 각자 권한을 선언하므로 그대로 동작합니다.`,
+        "직접 추가한 워크플로우에서 permissions를 생략했다면 이 기본값을 따르므로, 그때만 Read and write로 올리세요.",
       ],
-      doc: DOC.postInstall,
     });
   }
 

package/src/ui/banner.js

@@ -10,7 +10,7 @@ function boxLine(out, content = "") {
 }
 
 // 대화형 첫 화면 배너 — 박스 타이틀 + 메타 4줄 (.ps1 Print-Banner 등가, #446 확정 시안 A)
-export function printBanner({ version, modeLabel }, out = (s) => process.stdout.write(s)) {
+export function printBanner({ version, modeLabel }, out = (s) => process.stderr.write(s)) {
   out("\n");
   out(paint(`╔${"═".repeat(INNER)}╗`, A.cyan) + "\n");
   boxLine(out);
@@ -24,6 +24,6 @@ export function printBanner({ version, modeLabel }, out = (s) => process.stdout.
 }
 
 // 비대화형(--force/CI) 축약 배너 — 1줄 (사용자 확정: 로그 오염 최소 + 버전 추적)
-export function printBannerCompact({ version, mode }, out = (s) => process.stdout.write(s)) {
+export function printBannerCompact({ version, mode }, out = (s) => process.stderr.write(s)) {
   out(`${paint("✦", A.yellow)} ${paint("project-auto-wizard", A.bold)} v${version} — ${mode} 모드 (--force)\n`);
 }

package/src/ui/status-cards.js

@@ -9,7 +9,7 @@ const HEAD = paint("◆", A.cyan);
 const OK = paint("✓", A.green);
 
 // 층2 — 감지 로그 (.ps1 감지 진행 표시 등가)
-export function printDetectionLog({ types = [], version = "", branch = "" }, out = (s) => process.stdout.write(s)) {
+export function printDetectionLog({ types = [], version = "", branch = "" }, out = (s) => process.stderr.write(s)) {
   out(`${paint("┌", A.gray)}  🔍 프로젝트를 살펴보는 중...\n`);
   if (types.length && !(types.length === 1 && types[0] === "basic")) {
     for (const t of types) {
@@ -26,7 +26,7 @@ export function printDetectionLog({ types = [], version = "", branch = "" }, out
 // 층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 = (s) => process.stderr.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));
@@ -46,7 +46,7 @@ export function printAnalysisCard({ mode = "", modeLabel = "", types = [], versi
 }
 
 // 층5 — 신규 통합 vs 업데이트 판별 라인 (Breaking 박스는 breaking-check.js)
-export function printInstallKind({ currentTemplateVersion = "", templateVersion = "" }, out = (s) => process.stdout.write(s)) {
+export function printInstallKind({ currentTemplateVersion = "", templateVersion = "" }, out = (s) => process.stderr.write(s)) {
   if (currentTemplateVersion) {
     out(`${GUT}  ♻️  ${paint("업데이트", A.bold)} — 템플릿 ${paint(`v${currentTemplateVersion}`, A.dim)} → ${paint(`v${templateVersion}`, A.green)}\n`);
   } else {