project-auto-wizard 0.3.3 → 0.4.0

package/README.md

@@ -17,7 +17,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.3.1 (2026-08-18)
+## 최신 버전 : v0.3.3 (2026-08-18)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 
@@ -130,7 +130,7 @@ flowchart LR
 
 - **pr-flow** (기본): `VERSION-CONTROL`(main 직접 push 안전망) + `AUTO-CHANGELOG-CONTROL`(릴리스 PR) + `RELEASE-PUBLISH`(tag+Release) 3종 설치
 - **trunk-based** (릴리스 브랜치 = 개발 브랜치): `RELEASE-PUBLISH` 하나가 main push마다 버전확정 → 체인지로그 → tag → Release를 순차 처리
-- 마법사가 브랜치를 묻고(`--main-branch`/`--develop-branch`) 없으면 **생성 + push**까지. 선택은 `version.yml`에 저장되어 업데이트 시 재질문 없음
+- 마법사가 브랜치 전략(pr-flow/trunk-based)을 먼저 묻고, trunk-based를 고르면 개발 브랜치 질문 없이 릴리스 브랜치 하나만 사용합니다. 비대화형은 `--main-branch`/`--develop-branch` 플래그로 지정하며, 없으면 **생성 + push**까지. 선택은 `version.yml`에 저장되어 업데이트 시 재질문 없음
 
 ## 설치 옵션
 

package/package.json

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

package/payload/config/wizard-prompts.yml

@@ -45,6 +45,11 @@ SSH_AUTH_METHOD:
   help: "배포 서버 접속 방식입니다. 둘 중 하나를 그대로 입력하세요."
   example: "password 또는 key"
 
+ISSUE_HELPER_CREATE_BRANCH:
+  label: "이슈 생성 시 브랜치 자동 생성"
+  help: "이슈가 열리면 base 브랜치 기준으로 브랜치를 자동으로 만듭니다. 원치 않으면 기본값(아니오)을 그대로 두세요."
+  example: "true"
+
 # workflow filename (partial match) -> human readable short name
 # wizard uses this to build "[usage]" in env questions.
 _workflow_names:
@@ -60,3 +65,4 @@ _workflow_names:
   FLUTTER-ANDROID-SELFHOSTED: "안드로이드 자체배포"
   FLUTTER-ANDROID-PLAYSTORE: "플레이스토어 배포"
   FLUTTER-ANDROID-FIREBASE: "Firebase 배포"
+  ISSUE-HELPER: "이슈 헬퍼"

package/payload/workflows/common/PROJECT-COMMON-AUTO-CHANGELOG-CONTROL.yaml

@@ -36,6 +36,11 @@
 #   {{MAIN_BRANCH}}-push workflows (e.g. RELEASE-PUBLISH) for that merge.
 # - secrets.AI_API_KEY (+ vars.AI_API_BASE_URL / vars.AI_MODEL): preferred
 #   summary engine. Falls back to GitHub Models, then to rule-based.
+#
+# Issue #90: without WORKFLOW_PAT, a wait-for-merge-and-trigger-release job
+# polls until the automerge actually lands, then wakes RELEASE-PUBLISH via
+# workflow_dispatch — GITHUB_TOKEN can always trigger that event, unlike
+# the push/release events blocked by GitHub's anti-recursion policy.
 # ===================================================================
 
 name: PROJECT-AUTO-CHANGELOG-CONTROL
@@ -268,3 +273,51 @@ jobs:
             fi
             exit 1
           fi
+
+  wait-for-merge-and-trigger-release:
+    name: Wait for merge and trigger RELEASE-PUBLISH (WORKFLOW_PAT 없이도 동작)
+    needs: changelog-and-merge
+    runs-on: ubuntu-latest
+    timeout-minutes: 35
+    permissions:
+      pull-requests: read
+      actions: write
+    steps:
+      - name: Poll for merge completion
+        id: wait
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GH_REPO: ${{ github.repository }}
+        run: |
+          PR_NUMBER=${{ github.event.pull_request.number }}
+          MAX_WAIT=1800
+          INTERVAL=20
+          ELAPSED=0
+          MERGED=false
+
+          while [ $ELAPSED -lt $MAX_WAIT ]; do
+            PR_STATE=$(gh pr view "$PR_NUMBER" --json state -q .state 2>/dev/null || echo "")
+            if [ "$PR_STATE" = "MERGED" ]; then
+              MERGED=true
+              echo "PR #$PR_NUMBER 병합 확인 (경과 ${ELAPSED}s)"
+              break
+            fi
+            sleep $INTERVAL
+            ELAPSED=$((ELAPSED + INTERVAL))
+          done
+
+          if [ "$MERGED" != "true" ]; then
+            echo "::warning::PR #$PR_NUMBER 병합을 ${MAX_WAIT}s 내에 확인하지 못했습니다 — RELEASE-PUBLISH 자동 트리거를 건너뜁니다. WORKFLOW_PAT이 등록되어 있다면 기존 경로로 정상 진행되며, 없다면 필요 시 RELEASE-PUBLISH를 수동으로 workflow_dispatch 하세요."
+          fi
+
+          echo "merged=$MERGED" >> "$GITHUB_OUTPUT"
+
+      - name: Trigger RELEASE-PUBLISH
+        if: steps.wait.outputs.merged == 'true'
+        continue-on-error: true
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GH_REPO: ${{ github.repository }}
+        run: |
+          gh workflow run PROJECT-COMMON-RELEASE-PUBLISH.yaml --ref {{MAIN_BRANCH}}
+          echo "RELEASE-PUBLISH workflow_dispatch 트리거 요청 완료 (WORKFLOW_PAT 없이도 동작)"

package/payload/workflows/common/PROJECT-COMMON-ISSUE-HELPER.yaml

@@ -36,7 +36,7 @@ jobs:
       ISSUE_HELPER_BRANCH_PREFIX: ""
       ISSUE_HELPER_MAX_BRANCH_LENGTH: "100"
       ISSUE_HELPER_COMMIT_TEMPLATE: "${issueTitle} : feat : {변경 사항에 대한 설명} ${issueUrl}"
-      ISSUE_HELPER_CREATE_BRANCH: "false"
+      ISSUE_HELPER_CREATE_BRANCH: "false" # @wizard ask:false
       ISSUE_HELPER_BASE_BRANCH: "{{MAIN_BRANCH}}"
     steps:
       - name: Checkout repository

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

@@ -37,6 +37,13 @@
 # workflow_dispatch republishes the current version (recovery path when a
 # previous run failed after the version was confirmed but before the
 # release was created). The idempotency guard keeps it safe to re-run.
+#
+# Issue #90: this file and its self-copy (.github/workflows/) intentionally
+# differ by one step — the self-copy also triggers NPM-PUBLISH via
+# workflow_dispatch right after the release is created. NPM-PUBLISH.yaml is
+# a repo-only workflow (not shipped in payload), so wiring that dispatch
+# here would make every wizard-installed repo call a workflow that doesn't
+# exist for them on every release.
 # ===================================================================
 
 name: PROJECT-RELEASE-PUBLISH

package/payload/workflows/common/PROJECT-COMMON-VERSION-CONTROL.yaml

@@ -19,6 +19,11 @@
 #
 # Release-confirm pattern: "chore(release):" — keep in sync with
 # PROJECT-COMMON-AUTO-CHANGELOG-CONTROL and PROJECT-COMMON-RELEASE-PUBLISH.
+#
+# Issue #90 / #61: after pushing the safety-net bump, this workflow also
+# triggers RELEASE-PUBLISH via workflow_dispatch so the drift it used to
+# only detect (issue #61) is now auto-recovered instead of requiring a
+# manual re-run.
 # ===================================================================
 
 name: PROJECT-VERSION-CONTROL
@@ -39,6 +44,7 @@ on:
 
 permissions:
   contents: write
+  actions: write
 
 jobs:
   version-bump:
@@ -129,6 +135,7 @@ jobs:
           fi
 
       - name: Commit and push changes
+        id: commit_push
         if: steps.release_guard.outputs.skip != 'true'
         run: |
           git config --local user.email "action@github.com"
@@ -138,6 +145,7 @@ jobs:
 
           if git diff --staged --quiet; then
             echo "no changes to commit (already in sync)"
+            echo "pushed=false" >> "$GITHUB_OUTPUT"
           else
             NEW_VERSION="${{ steps.version.outputs.new_version }}"
             COMMIT_MSG="chore(version): bump to v${NEW_VERSION} [skip ci]"
@@ -172,12 +180,22 @@ jobs:
                 echo "push failed after $MAX_RETRIES attempts"
                 exit 1
               fi
+              echo "pushed=true" >> "$GITHUB_OUTPUT"
             else
               echo "commit failed"
               exit 1
             fi
           fi
 
+      - name: Trigger RELEASE-PUBLISH (safety-net bump 발행)
+        if: steps.release_guard.outputs.skip != 'true' && steps.commit_push.outputs.pushed == 'true'
+        continue-on-error: true
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh workflow run PROJECT-COMMON-RELEASE-PUBLISH.yaml --ref {{MAIN_BRANCH}}
+          echo "RELEASE-PUBLISH workflow_dispatch 트리거 요청 완료 (WORKFLOW_PAT 없이도 동작, 이슈 #61 드리프트 자동 복구)"
+
       - name: Summary
         if: always()
         run: |

package/src/commands/interactive.js

@@ -192,11 +192,19 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
     : resolveBranchConfig({ defaultBranch: branch });
   if (showOptional && !existing?.branches) {
     const remoteBranches = await detectRemoteBranches(cwd);
+    // 이슈 #93 — 두 질문에 같은 이름을 입력해야만 trunk-based가 되는 암묵적 규칙 대신,
+    // 전략을 먼저 명시적으로 고르게 한다. 취소/그 외 값은 기존 기본 동작과 같은 pr-flow로 폴백
+    // (selectDeployStyle의 "ESC = 기본값" 패턴과 동일).
+    const strategyPick = await io.selectBranchStrategy();
+    const strategy = strategyPick === "trunk-based" ? "trunk-based" : "pr-flow";
     const mainB = await pickBranch(io, `릴리스 브랜치를 선택하세요 (기본: ${branch})`, branch, remoteBranches, isCancel);
-    const devB = await pickBranch(io, "개발 브랜치를 선택하세요 (기본: develop)", "develop", remoteBranches, isCancel);
+    // trunk-based면 개발 브랜치 질문 자체를 생략 — 유일한 브랜치(main)를 그대로 develop으로 쓴다.
+    const devB = strategy === "trunk-based"
+      ? mainB
+      : await pickBranch(io, "개발 브랜치를 선택하세요 (기본: develop)", "develop", remoteBranches, isCancel);
     branches = resolveBranchConfig({ mainBranch: mainB, developBranch: devB, defaultBranch: branch });
     if (branches.mode === "trunk-based") {
-      io.note?.("릴리스 브랜치 = 개발 브랜치 → trunk-based 모드로 설치합니다 (RELEASE-PUBLISH 단독).", "브랜치 모드");
+      io.note?.(`릴리스 브랜치(${branches.main}) 하나만 사용하는 trunk-based 모드로 설치합니다 (RELEASE-PUBLISH 단독).`, "브랜치 모드");
     } else if (remoteBranches.length && !remoteBranches.includes(branches.develop)) {
       await ensureDevelopBranch({
         develop: branches.develop, remoteBranches, cwd,

package/src/core/copy/workflows.js

@@ -159,7 +159,18 @@ export function copyWorkflows(context, payloadRoot, targetRoot = ".", hooks = {}
   const commonDir = join(projectTypesDir, "common");
   if (exists(commonDir)) {
     const notExcluded = (filename) => !(branchMode === "trunk-based" && TRUNK_BASED_EXCLUDED.has(filename));
-    processDir(commonDir, workflowsDir, envOptsFor("common"), dirCtx, counters, notExcluded);
+    const c = processDir(commonDir, workflowsDir, envOptsFor("common"), dirCtx, counters, notExcluded);
+    // env 치환 — 타입별 폴더(copyWorkflowsForType)와 동일하게, 손대지 않기로 한 파일(unchanged/localOnly)은
+    // 건너뛴다. common 최상위는 지금까지 @wizard 마커가 없어 이 루프가 없어도 드러나지 않았지만,
+    // ISSUE_HELPER_CREATE_BRANCH(issue #94)부터는 실제로 값이 반영돼야 한다.
+    const untouched = [...c.unchanged, ...c.localOnly];
+    for (const filename of listYamlFiles(commonDir)) {
+      if (!notExcluded(filename)) continue;
+      const target = join(workflowsDir, filename);
+      if (!existsSync(target)) continue;
+      if (untouched.includes(filename)) continue;
+      configureEnv(target, envOptsFor("common"));
+    }
   }
 
   // (2~4) 타입별

package/src/ui/env-plan.js

@@ -48,10 +48,13 @@ export function collectAsks(payloadRoot, types = [], opts = {}) {
   const typeDefaults = new Map();
   const usages = new Map();
 
-  // 스캔 단위: [타입, 폴더]. secret-backup은 타입이 아니라 공통이지만 @wizard 마커를 가지므로
-  // 포함하기로 한 경우에만 질문 수집 대상이 된다 (이슈 #82) — 종전에는 스캔 대상이 아니어서
-  // my-project 같은 예시값이 질문 없이 그대로 설치됐다.
+  // 스캔 단위: [타입, 폴더]. common/ 최상위는 타입 선택과 무관하게 항상 설치되므로(복사 엔진과
+  // 동일 규칙 — issue #94) 무조건 스캔한다. secret-backup은 common 최상위가 아니라 그 하위
+  // 폴더고, 파일 전체가 조건부로 설치되므로 포함하기로 한 경우에만 별도로 스캔한다 (이슈 #82) —
+  // 종전에는 스캔 대상이 아니어서 my-project 같은 예시값이 질문 없이 그대로 설치됐다.
   const units = [];
+  const commonDir = join(baseDir, "common");
+  if (exists(commonDir)) units.push(["common", commonDir, null]);
   for (const type of types) {
     const typeDir = join(baseDir, type);
     if (!exists(typeDir)) continue;
@@ -126,6 +129,12 @@ export function printFieldCard(prompts, key, info, idx = null, tot = null, log =
   log("");
 }
 
+// ask 필드의 기본값이 정확히 "true"/"false"면 boolean 필드로 간주한다 (이슈 #94).
+// 마커 문법(@wizard ask:...)을 바꾸지 않고 리터럴 값 형태만으로 판단 — 별도 타입 표기가 필요 없다.
+function isBooleanDefault(value) {
+  return value === "true" || value === "false";
+}
+
 // 지정 KEY들을 하나씩 입력받아 values에 기록 (.sh _wf_prefill_interactive 등가).
 // 빈 입력(Enter)/ESC → KEY 공통 기본값 유지 (.sh safe_read || _in="" 등가).
 async function promptEach(io, prompts, asks, todoKeys, values, log) {
@@ -139,10 +148,16 @@ async function promptEach(io, prompts, asks, todoKeys, values, log) {
     i++;
     const def = asks.defaults.get(key) ?? "";
     printFieldCard(prompts, key, { default: def, usages: asks.usages.get(key) || [] }, i, tot, log);
-    let input = await io.text({ message: `↳ 값 입력 (Enter=기본값 «${def}» 유지):`, defaultValue: def });
-    if (input === CANCEL || input == null || input === "") input = def;
-    values.set(key, input);
     const label = wfField(prompts, firstTypeFor(asks.usages, key), key, "label");
+    let input;
+    if (isBooleanDefault(def)) {
+      const answer = await io.confirm({ message: `↳ ${label} — 활성화할까요?`, initialValue: def === "true" });
+      input = answer === CANCEL ? def : (answer ? "true" : "false");
+    } else {
+      input = await io.text({ message: `↳ 값 입력 (Enter=기본값 «${def}» 유지):`, defaultValue: def });
+      if (input === CANCEL || input == null || input === "") input = def;
+    }
+    values.set(key, input);
     log(`         → ${label} = ${input}`);
     log("");
   }
@@ -182,9 +197,9 @@ export async function promptEnvPlan({
 
   // 기본값 미리보기 카드 전체 출력 (.sh 3237~3251)
   log("");
-  log("▶ 배포 워크플로우 환경설정을 채웁니다");
+  log("▶ 워크플로우 환경설정을 채웁니다");
   log("");
-  log("   설치되는 배포 워크플로우가 사용할 값입니다. 항목마다 '무엇에 쓰이는지·설명·예시'와");
+  log("   설치되는 워크플로우가 사용할 값입니다. 항목마다 '무엇에 쓰이는지·설명·예시'와");
   log("   기본값을 함께 보여드립니다. 그대로 둬도 되고, 원하는 것만 바꿀 수 있습니다.");
   log("");
   const tot = asks.keys.length;

package/src/ui/prompts.js

@@ -97,6 +97,25 @@ export async function selectDeployStyle() {
   });
 }
 
+// 브랜치 전략 선택 (이슈 #93). 종전에는 "릴리스 브랜치"/"개발 브랜치" 두 질문에
+// 같은 이름을 입력해야만 trunk-based가 됐는데, 그 규칙이 사전에 안내되지 않아
+// 의도치 않게 pr-flow로 흘러갔다. 전략을 먼저 명시적으로 고르게 해 이를 없앤다.
+// 옵션 순서(pr-flow 먼저)는 비-TTY 환경의 기본값과 직결되므로 바꾸지 않는다.
+export async function selectBranchStrategy() {
+  engine.note(
+    "pr-flow는 develop에서 작업해 main으로 PR을 올리는 팀 협업 흐름입니다.\n" +
+    "trunk-based는 브랜치를 하나만 두고 그 브랜치에서 바로 작업하는 단순한 흐름입니다.",
+    "브랜치 전략",
+  );
+  return engine.select({
+    message: "브랜치 전략을 선택하세요",
+    options: [
+      { value: "pr-flow", label: "develop → main PR 흐름 (pr-flow) — 팀 협업/리뷰 프로세스가 필요할 때" },
+      { value: "trunk-based", label: "main 단일 브랜치 (trunk-based) — 개인/소규모 프로젝트로 브랜치 없이 단순하게 쓸 때" },
+    ],
+  });
+}
+
 // 텍스트 입력 (빈 입력=기본값 유지).
 export async function askText(message, defaultValue = "") {
   const v = await engine.text({ message, defaultValue });