projectops 4.2.15 → 4.2.16

package/README.md

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "4.2.15",
+  "version": "4.2.16",
   "description": "ProjectOps — 완전 자동화 GitHub 프로젝트 관리 템플릿 통합 CLI",
   "keywords": [
     "devops",

package/src/commands/interactive.js

@@ -89,6 +89,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     let changelogProvider = existing?.options?.changelogProvider ?? "github-ai";
     let changelogBaseUrl = existing?.options?.changelogBaseUrl ?? "";
     let deployBranch = existing?.options?.deployBranch ?? "develop"; // #456
+    let deployBranchReady = null; // #490 — 이번 실행에서 개발 브랜치 존재/생성이 확인됐는지
     let intent = existing?.options?.intent ?? null; // #485 프로젝트 성격
     const showOptional = mode === "full" || mode === "workflows";
     const realTty = process.stdout.isTTY === true;
@@ -123,6 +124,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
       changelogProvider = r.changelogProvider;
       changelogBaseUrl = r.changelogBaseUrl;
       deployBranch = r.deployBranch;
+      deployBranchReady = r.deployBranchReady ?? deployBranchReady; // #490
       intent = r.intent;
     }
 
@@ -186,6 +188,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
           changelogProvider = r.changelogProvider;
           changelogBaseUrl = r.changelogBaseUrl;
           deployBranch = r.deployBranch;
+          deployBranchReady = r.deployBranchReady ?? deployBranchReady; // #490
           intent = r.intent;
         }
       }
@@ -285,7 +288,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
 
     // 완료 요약 (.sh print_summary L5438)
     io.summary?.({
-      mode, types, version, deployBranch,
+      mode, types, version, deployBranch, deployBranchReady,
       counters: { workflows: result?.workflows?.copied ?? 0, workflowFiles: result?.workflows?.copiedFiles ?? [], utilModules: 0 },
     }, cwd);
     io.outro?.(`통합 완료 — ${mode} 모드로 설치했습니다.`);

package/src/core/copy/workflows.js

@@ -18,6 +18,17 @@ function configureEnv(targetPath, { type, projectPath = ".", repoName = "", reso
   writeFileSync(targetPath, out);
 }
 
+// util 버전 동기화 워크플로우 (#491) — .github/util/ 모듈(version.json)이 있는 레포에서만 의미가 있다.
+// util이 없는 레포(예: spring 단독)에 복사하면 트리거가 영원히 안 걸리는 no-op 오염이 된다.
+const UTIL_VERSION_SYNC = "PROJECT-COMMON-TEMPLATE-UTIL-VERSION-SYNC.yml";
+
+// 이 통합에서 util 모듈이 존재하게 되는가 — 대상에 이미 있거나(업데이트),
+// 선택 타입의 util이 템플릿에 있어 곧 복사될 예정(runFull 6단계)이면 true.
+function utilSyncApplies(tempDir, targetRoot, types) {
+  if (exists(join(targetRoot, ".github", "util"))) return true;
+  return types.some((t) => exists(join(tempDir, ".github", "util", t)));
+}
+
 // 3분류 (신규/unchanged/changed) — 대상 워크플로우 디렉토리 기준.
 function classify(srcDir, workflowsDir, envOpts) {
   const result = { newFiles: [], unchanged: [], changed: [] };
@@ -62,6 +73,8 @@ export function copyWorkflows(context, tempDir, targetRoot = ".", hooks = {}) {
   const commonDir = join(projectTypesDir, "common");
   if (exists(commonDir)) {
     for (const filename of listYamlFiles(commonDir)) {
+      // #491 — util 동기화 워크플로우는 util 모듈이 있(게 되)는 레포에만 복사
+      if (filename === UTIL_VERSION_SYNC && !utilSyncApplies(tempDir, targetRoot, types)) continue;
       const src = join(commonDir, filename);
       const dst = join(workflowsDir, filename);
       if (existsSync(dst) && isUnchanged(readFileSync(src, "utf8"), readFileSync(dst, "utf8"), envOptsFor("common"))) {

package/src/core/options-ask.js

@@ -16,34 +16,39 @@ import { branchStatus, createBranch, pushBranch } from "./git-branch.js";
 // 개발(배포) 브랜치 존재 확인 + 생성 제안 (#477) — 대화형 전용.
 // 로컬에 없고 원격에도 없(거나 불명이)면 기본 브랜치에서 생성을 제안하고, 생성 후 push 여부도 묻는다.
 // git 미설치·비레포·질문 불가(io.confirm 없음)면 조용히 통과 — 마법사 진행을 막지 않는다.
+// 반환 ready (#490 — 완료 요약이 "브랜치 만들어라" 재지시를 접을지 판단):
+//   true  = 브랜치가 이미 있거나 이번 실행에서 생성함 → 요약에서 생성 안내 불필요
+//   false = 없는데 사용자가 거절/생성 실패 → 안내 유지
+//   null  = 확인 자체를 못 함(비레포·질문 불가) → 안내 유지(보수적)
 export async function ensureDeployBranch({ targetRoot = ".", deployBranch = "", defaultBranch = "", io = {}, say = () => {} }) {
-  if (!deployBranch || typeof io.confirm !== "function") return { created: false, pushed: false };
+  if (!deployBranch || typeof io.confirm !== "function") return { created: false, pushed: false, ready: null };
   const st = branchStatus(targetRoot, deployBranch);
-  if (!st.isRepo || st.local) return { created: false, pushed: false };
+  if (!st.isRepo) return { created: false, pushed: false, ready: null };
+  if (st.local) return { created: false, pushed: false, ready: true };
   if (st.remote === true) {
     say(`ℹ️ '${deployBranch}' 브랜치가 원격에는 있고 로컬에 없습니다 — 필요 시 'git switch ${deployBranch}'로 가져오세요.`);
-    return { created: false, pushed: false };
+    return { created: false, pushed: false, ready: true };
   }
   say(`⚠️ 개발(릴리스 소스) 브랜치 '${deployBranch}'가 없습니다 — 릴리스(${deployBranch}→${defaultBranch || "기본 브랜치"} PR)가 동작하려면 필요합니다.`);
   const mk = await io.confirm({ message: `${defaultBranch || "현재"} 브랜치에서 '${deployBranch}' 브랜치를 만들까요?`, initialValue: true });
   if (mk !== true) {
     say(`→ 건너뜁니다. 나중에 직접: git checkout -b ${deployBranch} && git push -u origin ${deployBranch}`);
-    return { created: false, pushed: false };
+    return { created: false, pushed: false, ready: false };
   }
   if (!createBranch(targetRoot, deployBranch, defaultBranch)) {
     say(`⚠️ 브랜치 생성 실패 — 직접 실행해주세요: git branch ${deployBranch}${defaultBranch ? ` ${defaultBranch}` : ""}`);
-    return { created: false, pushed: false };
+    return { created: false, pushed: false, ready: false };
   }
   say(`✅ 로컬 브랜치 '${deployBranch}' 생성 완료 (checkout은 하지 않았습니다)`);
   // #481 — push 질문에 브랜치명 명시 ("어느 브랜치를 push하는지" 불명확 방지)
   const up = await io.confirm({ message: `원격(origin)에 '${deployBranch}' 브랜치도 push할까요?`, initialValue: true });
-  if (up !== true) return { created: true, pushed: false };
+  if (up !== true) return { created: true, pushed: false, ready: true };
   if (pushBranch(targetRoot, deployBranch)) {
     say(`✅ origin/${deployBranch} push 완료`);
-    return { created: true, pushed: true };
+    return { created: true, pushed: true, ready: true };
   }
   say(`⚠️ push 실패(자격/네트워크) — 직접 실행해주세요: git push -u origin ${deployBranch}`);
-  return { created: true, pushed: false };
+  return { created: true, pushed: false, ready: true };
 }
 
 // 재노출 — 파서 본체는 version-yml.js에 있다 (순환 import 방지: options-ask → version-yml 방향만 허용)
@@ -115,6 +120,7 @@ export async function askAllOptionalWorkflows({
   let changelogProvider = current.changelogProvider ?? null;
   let changelogBaseUrl = current.changelogBaseUrl ?? null;
   let deployBranch = current.deployBranch ?? null; // #456 릴리스 PR head 브랜치
+  let deployBranchReady = null; // #490 — 이번 실행에서 브랜치 존재/생성이 확인됐는지 (null=확인 안 함)
   let intent = current.intent ?? null; // #485 프로젝트 성격 (app/library/both/none/manual)
 
   // basic 단독 타입은 서버 배포도 라이브러리 publish도 개념상 성립하지 않는다.
@@ -328,7 +334,9 @@ export async function askAllOptionalWorkflows({
       deployBranch = (typeof ans === "string" && !isCancel(ans) && ans.trim()) ? ans.trim() : (deployBranch ?? "develop");
       say(`개발(릴리스 소스) 브랜치: ${deployBranch}`);
       // 브랜치 존재 확인 + 생성 제안 (#477) — 없으면 릴리스 파이프라인이 조용히 놀게 된다
-      await ensureDeployBranch({ targetRoot, deployBranch, defaultBranch, io, say });
+      // #490 — 결과(ready)를 완료 요약에 전달해 이미 생성/확인한 브랜치를 재지시하지 않는다
+      const br = await ensureDeployBranch({ targetRoot, deployBranch, defaultBranch, io, say });
+      deployBranchReady = br.ready;
     }
   }
 
@@ -349,6 +357,8 @@ export async function askAllOptionalWorkflows({
     changelogProvider: changelogProvider ?? "github-ai",
     changelogBaseUrl: changelogBaseUrl ?? "",
     deployBranch: deployBranch ?? "develop",
+    deployBranchReady, // #490 — true=존재/생성 확인됨, false=거절/실패, null=확인 안 함
+
     // #485 intent — 확정값 우선, 없으면 최종 deploy/publish에서 역추론(basic·비대화형 경로 보정)
     intent: intent ?? inferIntent(finalDeploy, finalPublish) ?? "manual",
   };

package/src/core/wizard-env.js

@@ -41,6 +41,13 @@ export function resolveToken(name, type, resolvers = {}) {
   return typeof fn === "function" ? (fn(type) ?? "") : "";
 }
 
+// 잔여 전역 토큰 치환 (.sh 3347~3351) — 파일 본문·수집값(#489)·카드 표시가 전부 같은 규칙을 쓴다.
+// 파일에 실제 써지는 값과 version.yml deploy 블록 기억값이 어긋나지 않게 하는 단일 지점.
+export function resolveGlobalTokens(s, repoName = "") {
+  if (typeof s !== "string" || (!s.includes("__PROJECT_NAME__") && !s.includes("__APP_ARTIFACT_NAME__"))) return s;
+  return s.replaceAll("__PROJECT_NAME__", repoName).replaceAll("__APP_ARTIFACT_NAME__", repoName);
+}
+
 // 파일 전체 치환 (configure_workflow_env 등가).
 // content: 원본 워크플로우 텍스트. 반환: 치환된 텍스트.
 // opts:
@@ -70,16 +77,16 @@ export function substituteEnv(content, opts = {}) {
       if (chosen != null && chosen !== "" && !useDefaults) val = chosen;
       else val = def;
       // ask 키만 수집 (.sh wf_deploy_set — auto는 저장 안 함). deploy 블록용.
-      if (collectAsks) collectAsks.set(p.key, val);
+      // #489 — 파일 본문은 아래 전역 토큰 치환을 거치므로 수집값도 동일 치환해
+      //        version.yml deploy 블록이 설치본과 항상 바이트 일치하게 한다.
+      if (collectAsks) collectAsks.set(p.key, resolveGlobalTokens(val, repoName));
     }
     lines[i] = setEnvLine(lines[i], p.key, val);
   }
   let out = lines.join(usesCRLF ? "\r\n" : "\n");
 
   // 잔여 전역 토큰 (.sh 3347~3351)
-  if (out.includes("__PROJECT_NAME__") || out.includes("__APP_ARTIFACT_NAME__")) {
-    out = out.replaceAll("__PROJECT_NAME__", repoName).replaceAll("__APP_ARTIFACT_NAME__", repoName);
-  }
+  out = resolveGlobalTokens(out, repoName);
 
   // paths-anchor (.sh 3353~3360): 경로가 '.'이 아니면 주석 라인 전체를 paths 라인으로 교체
   if (PATHS_ANCHOR_RE.test(out) && projectPath && projectPath !== ".") {

package/src/ui/env-plan.js

@@ -8,7 +8,7 @@ import { readFileSync } from "node:fs";
 import { stdin, stderr } from "node:process";
 import { PATHS } from "../core/paths.js";
 import { exists, listYamlFiles } from "../core/fsutil.js";
-import { parseWizardLine, resolveToken } from "../core/wizard-env.js";
+import { parseWizardLine, resolveToken, resolveGlobalTokens } from "../core/wizard-env.js";
 import { loadWizardPrompts, wfField, workflowDisplayName } from "../core/wizard-labels.js";
 import * as engine from "./readline-engine.js";
 
@@ -39,7 +39,7 @@ export function scopeString(usages = []) {
 // 반환: { keys:[], defaults:Map<key,default>, typeDefaults:Map<"type|key",default>,
 //        usages:Map<key,[{type,workflowName}]> }
 export function collectAsks(tempDir, types = [], opts = {}) {
-  const { resolvers = {}, deployTarget = "docker-ssh", publishTargets = [], prompts = null } = opts;
+  const { resolvers = {}, deployTarget = "docker-ssh", publishTargets = [], prompts = null, repoName = "" } = opts;
   const baseDir = join(tempDir, PATHS.workflowsDir, PATHS.projectTypesDir);
   const keys = [];
   const defaults = new Map();
@@ -64,9 +64,13 @@ export function collectAsks(tempDir, types = [], opts = {}) {
           const p = parseWizardLine(line); // KEY 정규식 [A-Z_]+ (.sh와 동일)
           if (!p || p.action !== "ask") continue;
           // 타입별 기본값: @접두면 resolver 해석, 아니면 리터럴 (.sh _type_default 등가)
-          const typeDefault = p.arg.startsWith("@")
-            ? resolveToken(p.arg.slice(1), type, resolvers)
-            : p.arg;
+          // #489 — __PROJECT_NAME__ 등 전역 토큰은 카드 표시 전에 미리 해석한다.
+          //        설치본(파일 복사 시 전역 치환)과 동일한 값을 보여주지 않으면
+          //        사용자가 "리터럴이 그대로 박히나?" 오해하게 된다.
+          const typeDefault = resolveGlobalTokens(
+            p.arg.startsWith("@") ? resolveToken(p.arg.slice(1), type, resolvers) : p.arg,
+            repoName,
+          );
           typeDefaults.set(`${type}|${p.key}`, typeDefault);
           if (!defaults.has(p.key)) { keys.push(p.key); defaults.set(p.key, typeDefault); }
           const list = usages.get(p.key) || [];
@@ -140,7 +144,7 @@ export async function promptEnvPlan({
   deployTarget = "docker-ssh", publishTargets = [], targetRoot = ".", repoName = "", log = defaultLog,
 } = {}) {
   const prompts = loadWizardPrompts(targetRoot, tempDir);
-  const asks = collectAsks(tempDir, types, { resolvers, deployTarget, publishTargets, prompts });
+  const asks = collectAsks(tempDir, types, { resolvers, deployTarget, publishTargets, prompts, repoName });
   const defaults = asks.defaults;
 
   // 수집 키 0개 → 질문 자체가 없음 (.sh `[ ${#WF_ASK_KEYS[@]} -eq 0 ]` 등가)

package/src/ui/summary.js

@@ -9,6 +9,7 @@ const SEPARATOR = "────────────────────
 export function printSummary(ctx, targetRoot = ".") {
   const { mode, types = [], version = "", counters = {} } = ctx || {};
   const deployBranchName = ctx?.deployBranch || "develop"; // #477 — 설정된 배포 브랜치명으로 안내
+  const deployBranchReady = ctx?.deployBranchReady === true; // #490 — 마법사가 이번 실행에서 존재/생성 확인함
   const err = (s = "") => process.stderr.write(`${s}\n`);
   // 색상은 TTY일 때만 (.sh YELLOW/CYAN/NC 등가)
   const isTty = !!process.stderr.isTTY;
@@ -139,8 +140,13 @@ export function printSummary(ctx, targetRoot = ".") {
   err("     → Secret Name: _GITHUB_PAT_TOKEN");
   err("     → Scopes: repo, workflow");
   err("");
-  err(`  2️⃣  ${deployBranchName} 브랜치 생성 (아직 없다면)`);
-  err(`     → git checkout -b ${deployBranchName} && git push -u origin ${deployBranchName}`);
+  // #490 — 마법사가 브랜치를 직접 생성(또는 존재 확인)했으면 같은 작업을 재지시하지 않는다
+  if (deployBranchReady) {
+    err(`  2️⃣  ✅ ${deployBranchName} 브랜치 준비 완료 — 마법사가 확인·생성했습니다 (추가 작업 불필요)`);
+  } else {
+    err(`  2️⃣  ${deployBranchName} 브랜치 생성 (아직 없다면)`);
+    err(`     → git checkout -b ${deployBranchName} && git push -u origin ${deployBranchName}`);
+  }
   err("");
   err("  3️⃣  CodeRabbit 활성화 (코드 리뷰를 켰다면)");
   err("     → https://coderabbit.ai 로그인 → GitHub 앱 설치 → 이 저장소에 접근 권한(grant access) 부여");