projectops 4.2.21 → 4.2.22

package/README.md

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

package/package.json

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

package/src/commands/full.js

@@ -41,7 +41,7 @@ export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
       version, types, paths, pathMarkers, branch, deployBranch, versionCode, now, today,
       deployValues,
       templateOptions: { templateVersion, deployTarget, publishTargets, includeSecretBackup, optionsDate: today,
-        changelogProvider, changelogBaseUrl, codeReviewCoderabbit, intent },
+        changelogProvider, changelogBaseUrl, codeReviewCoderabbit, intent, mode: "full" },
     }));
 
   // 2. README 버전 섹션

package/src/commands/interactive.js

@@ -18,6 +18,7 @@ import { createRunTrace } from "../core/run-trace.js";
 import { appendGuideEntry } from "../core/migration-guide.js";
 import { promptEnvPlan } from "../ui/env-plan.js";
 import { listWorkflowConflicts } from "../core/copy/workflows.js";
+import { extractEnvValues } from "../core/wizard-env.js";
 import { createContext, VALID_TYPES } from "../context.js";
 import { runFull } from "./full.js";
 import { runVersion } from "./version.js";
@@ -53,9 +54,14 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     io.ideStatus?.();
     io.installKind?.({ currentTemplateVersion: existing?.templateVersion || "", templateVersion });
 
-    // 1) 모드 선택
-    const mode = await io.selectMode();
-    if (mode === CANCEL || mode == null) { io.cancelMessage?.("설치를 취소했습니다."); return 0; }
+    // 1) 모드 선택 — 기존 통합 레포면 업데이트 항목을 맨 위에 노출 (#502)
+    const updateInfo = existing?.templateVersion ? { from: existing.templateVersion, to: templateVersion } : null;
+    const picked = await io.selectMode(updateInfo ? { update: updateInfo } : {});
+    if (picked === CANCEL || picked == null) { io.cancelMessage?.("설치를 취소했습니다."); return 0; }
+    // 업데이트 모드(#502): 저장된 통합 범위(templateMode, 없으면 full)를 재실행하고
+    // 이하 updateRun 분기가 질문을 최소화한다 ("저장된 설정 그대로 반영"이 계약).
+    const updateRun = picked === "update";
+    const mode = updateRun ? (existing?.templateMode || "full") : picked;
 
     // Breaking Changes 게이트 (.sh execute_integration L4415~4420 — 모든 모드 공통, 대화형은 확인 질문)
     let breakingReport = null; // #493 — 통과 구간 항목을 가이드에 조치 방법 전문으로 임베드
@@ -84,6 +90,11 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
 
     // full/version/workflows — 감지 (version은 기존 version.yml 최우선)
     let types = detectTypes(cwd);
+    // 업데이트 모드 — 저장된 타입 우선 (재감지로 타입 집합이 흔들리지 않게, #502)
+    if (updateRun && existing?.types?.length) {
+      const saved = existing.types.filter((t) => VALID_TYPES.includes(t));
+      if (saved.length) types = saved;
+    }
     let version = (existing?.version) || detectVersion(cwd);
     let branch = detectDefaultBranch(cwd);
     const repoName = detectRepoName(cwd);
@@ -140,6 +151,15 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     // 확인/수정 루프 — ESC는 '머무르기' (.sh L1877~1881: 명시적 '아니오'만 종료)
     let paths = new Map();
     let confirmed = false;
+    // 업데이트 모드 — 카드는 보여주되 확인 루프 생략 (#502: 설정 변경은 기존 모드의 몫)
+    if (updateRun) {
+      if (io.analysisCard) {
+        io.analysisCard({ mode, modeLabel: `업데이트 (${modeLabel(mode)} 범위)`, types, version, branch, deployTarget, publishTargets, includeSecretBackup, showOptional, paths });
+      } else {
+        io.note?.(summarize({ mode, types, version, branch, deployTarget, publishTargets, includeSecretBackup, showOptional, changelogProvider, codeReviewCoderabbit }), "업데이트 — 저장된 설정으로 진행");
+      }
+      confirmed = true;
+    }
     while (!confirmed) {
       // 층3 — 프로젝트 분석 개요 카드 (#446). 스텁엔 없음 → note 폴백.
       if (io.analysisCard) {
@@ -217,10 +237,11 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
       for (const t of types) if (t !== "basic" && !paths.has(t)) paths.set(t, existing?.paths.get(t) || ".");
     }
 
-    // @wizard env 계획 질문 (.sh wf_prompt_env_plan L3220 — full/workflows만)
+    // @wizard env 계획 질문 (.sh wf_prompt_env_plan L3220 — full/workflows만).
+    // 업데이트 모드는 생략 — 신규 파일은 기본값, 교체 파일은 아래 carryover가 기존 실값을 이월한다.
     const resolvers = makeResolvers(cwd, repoName, paths);
     let envValues = new Map(), envUseDefaults = true;
-    if (showOptional) {
+    if (showOptional && !updateRun) {
       const plan = await promptEnvPlan({
         tempDir, types, io: io.engineIo ?? null, force: false,
         resolvers, deployTarget, publishTargets, targetRoot: cwd, repoName,
@@ -229,17 +250,45 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
       envUseDefaults = plan.useDefaults;
     }
 
+    // 업데이트 모드 충돌 처리 (#502) — 타입별 3지선다 대신 일괄 확인 1회(기본 Y: .bak 백업 후 교체).
+    // 교체를 선택하면 기존 설치본의 env 실값을 추출해 새 파일에 이월(carryover)한다 —
+    // 기본값 재치환으로 사용자가 채운 값(FIREBASE_APP_ID 등)이 초기화되는 것을 막는 핵심.
+    let updateDecisions = null;
+    if (showOptional && updateRun) {
+      const liteCtx = { types, paths, deployTarget, publishTargets, repoName, resolvers, branch, deployBranch };
+      const conflicts = listWorkflowConflicts(liteCtx, tempDir, cwd);
+      if (conflicts.length) {
+        io.note?.(conflicts.map((c) => `• ${c.filename}`).join("\n"), `♻️ 템플릿이 갱신된 워크플로우 ${conflicts.length}개`);
+        const yes = await io.askYesNo(`위 ${conflicts.length}개를 .bak 백업 후 새 버전으로 교체할까요? (기존 설정값은 유지됩니다)`, true);
+        const decision = yes === true ? "backup" : "skip";
+        updateDecisions = new Map();
+        for (const { filename } of conflicts) updateDecisions.set(filename, decision);
+        if (decision === "backup") {
+          const carried = new Map();
+          for (const { filename } of conflicts) {
+            const p = join(cwd, PATHS.workflowsDir, filename);
+            if (!existsSync(p)) continue;
+            for (const [k, v] of extractEnvValues(readFileSync(p, "utf8"))) carried.set(k, v);
+          }
+          if (carried.size) { envValues = carried; envUseDefaults = false; }
+        }
+      }
+    }
+
     const { now, today } = clock || utcNow();
     const ctx = createContext({
       mode, force: true, types, version, versionCode, branch, paths, deployTarget, publishTargets, includeSecretBackup,
       codeReviewCoderabbit, changelogProvider, changelogBaseUrl, deployBranch, intent,
       repoName, templateVersion, resolvers, envValues, envUseDefaults, now, today,
+      // #502 — version 모드가 기존 full 기록을 강등하지 않도록 (full이 우세)
+      recordMode: existing?.templateMode === "full" ? "full" : "version",
     });
     ctx.templateVersion = templateVersion;
 
     // 기존 워크플로우 충돌 3지선 — 타입당 1회 결정을 파일에 캐시 적용 (.sh L3440~3508 UX 등가)
-    let hooks = {};
-    if (showOptional && io.engineIo?.select) {
+    // 업데이트 모드는 위에서 일괄 결정(updateDecisions)했으므로 3지선다를 건너뛴다 (#502).
+    let hooks = updateDecisions ? { decisions: updateDecisions } : {};
+    if (showOptional && io.engineIo?.select && !updateRun) {
       const conflicts = listWorkflowConflicts(ctx, tempDir, cwd);
       if (conflicts.length) {
         const perType = new Map();
@@ -302,8 +351,13 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     else if (mode === "workflows") result = runWorkflows(ctx, tempDir, cwd, { ...hooks, trace });
 
     // 통합 후 IDE 스킬 제안 (.sh L4557 offer_ide_tools_install — 사전 질문 게이트, 기본 N)
-    const wantSkills = await io.askYesNo("AI 에이전트 스킬(Claude·Cursor·Gemini·Codex·PI)도 설치/업데이트할까요?", false);
-    if (wantSkills === true) await skills({ templateVersion, tempDir, interactive: true });
+    // 업데이트 모드(#502): 이미 설치된 IDE 스킬만 질문 없이 최신화 (미설치 IDE는 건드리지 않음)
+    if (updateRun) {
+      await skills({ templateVersion, tempDir, interactive: false, installedOnly: true });
+    } else {
+      const wantSkills = await io.askYesNo("AI 에이전트 스킬(Claude·Cursor·Gemini·Codex·PI)도 설치/업데이트할까요?", false);
+      if (wantSkills === true) await skills({ templateVersion, tempDir, interactive: true });
+    }
 
     // 마이그레이션 기록 (#493/#494) — Layer 2/3 트레이스 파일 + Layer 1 가이드 엔트리 (full/workflows만)
     let migrationGuidePath = null;
@@ -351,7 +405,7 @@ function summarize({ mode, types, version, branch, deployTarget, publishTargets,
 }
 
 function modeLabel(m) {
-  return { full: "전체 설치", version: "버전 관리만", workflows: "워크플로우만", issues: "이슈·PR 템플릿만", skills: "AI 스킬만" }[m] || m;
+  return { full: "전체 설치", version: "버전 관리만", workflows: "워크플로우만", issues: "이슈·PR 템플릿만", skills: "AI 스킬만", update: "업데이트" }[m] || m;
 }
 
 function utcNow(date = new Date()) {

package/src/commands/skills.js

@@ -30,7 +30,9 @@ export function formatStatuses(rows, templateVersion) {
   });
 }
 
-// 대화형/비대화형 공통 진입. opts: {io, templateVersion, sourceSkillsDir, tempDir, interactive, ui}
+// 대화형/비대화형 공통 진입. opts: {io, templateVersion, sourceSkillsDir, tempDir, interactive, ui, installedOnly}
+// installedOnly(#502 — 업데이트 모드): 비대화형 apply를 이미 설치된 어댑터로 한정한다.
+// 미설치 IDE에 새로 설치하지 않는다 — 업데이트는 "있는 것을 최신으로"가 계약.
 export async function runSkills(opts = {}) {
   const io = opts.io || defaultIo();
   const ui = opts.ui || skillsPrompts;
@@ -43,8 +45,12 @@ export async function runSkills(opts = {}) {
   io.log("");
 
   // 비대화형: 감지된(=관리 가능) 모든 어댑터에 apply(설치/업데이트) 순차 실행.
+  // installedOnly면 설치된 어댑터만 (업데이트 모드 — 미설치 IDE는 건드리지 않음).
   if (!opts.interactive) {
-    for (const { adapter } of rows) safe(() => adapter.apply(io, ctx), false);
+    for (const { adapter, status } of rows) {
+      if (opts.installedOnly && !status.installed) continue;
+      safe(() => adapter.apply(io, ctx), false);
+    }
     return 0;
   }
 

package/src/commands/version.js

@@ -14,7 +14,7 @@ export function runVersion(context, tempDir, targetRoot = ".") {
   const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
     now, today, templateVersion = "unknown", deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false,
     changelogProvider = "github-ai", changelogBaseUrl = "", codeReviewCoderabbit = true,
-    deployBranch = "" } = context;
+    deployBranch = "", recordMode = "version" } = context;
 
   const pathMarkers = new Map();
   for (const [t] of paths) pathMarkers.set(t, markerForType(t));
@@ -22,8 +22,10 @@ export function runVersion(context, tempDir, targetRoot = ".") {
   writeText(join(targetRoot, PATHS.versionFile),
     buildVersionYml({
       version, types, paths, pathMarkers, branch, deployBranch, versionCode, now, today,
+      // mode(#502): version 모드가 기존 full 통합 기록을 "version"으로 강등하지 않도록
+      // 호출부가 recordMode로 기존 값을 넘긴다 (full이 우세 — 업데이트 재실행 범위 축소 방지).
       templateOptions: { templateVersion, deployTarget, publishTargets, includeSecretBackup, optionsDate: today,
-        changelogProvider, changelogBaseUrl, codeReviewCoderabbit },
+        changelogProvider, changelogBaseUrl, codeReviewCoderabbit, mode: recordMode },
     }));
   addVersionSectionToReadme(version, targetRoot);
   copyScripts(tempDir, targetRoot);

package/src/core/version-yml.js

@@ -222,14 +222,17 @@ export function parseExisting(content) {
       else if (/^\S/.test(l)) inPaths = false; // 들여쓰기 끝 → 블록 종료
     }
   }
-  // template: 블록 내 version
+  // template: 블록 내 version + mode (#502 — 업데이트 모드가 재실행할 통합 범위)
   let templateVersion = "";
+  let templateMode = null;
   let inTemplate = false;
   for (const l of text.split("\n")) {
     if (/^\s*template:/.test(l)) { inTemplate = true; continue; }
     if (inTemplate) {
-      const m = l.match(/^\s*version:\s*"([0-9][0-9.]*)"/);
-      if (m) { templateVersion = m[1]; break; }
+      const vm = l.match(/^\s*version:\s*"([0-9][0-9.]*)"/);
+      if (vm && !templateVersion) templateVersion = vm[1];
+      const mm = l.match(/^\s*mode:\s*"([a-z]+)"/);
+      if (mm && ["full", "version", "workflows"].includes(mm[1])) templateMode = mm[1];
       if (/^\S/.test(l)) break;
     }
   }
@@ -238,7 +241,7 @@ export function parseExisting(content) {
   const deployBranch = line(/^\s*deploy_branch:\s*"([^"]*)"/);
   // 선택 워크플로우 옵션 (metadata.template.options — nexus/secret_backup)
   const options = parseTemplateOptions(text);
-  return { version, versionCode, types, paths, templateVersion, options, defaultBranch, deployBranch };
+  return { version, versionCode, types, paths, templateVersion, templateMode, options, defaultBranch, deployBranch };
 }
 
 // version.yml 전체 생성 (.sh create_version_yml + save_template_options 신규 케이스 등가).
@@ -291,13 +294,15 @@ export function buildVersionYml({ version, types = [], paths = new Map(), pathMa
   // template 옵션 블록 (.sh save_template_options 신규 추가 케이스). templateOptions 지정 시.
   if (templateOptions) {
     const { templateVersion = "unknown", deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false, optionsDate = today,
-            changelogProvider = "github-ai", changelogBaseUrl = "", codeReviewCoderabbit = true, intent = null } = templateOptions;
+            changelogProvider = "github-ai", changelogBaseUrl = "", codeReviewCoderabbit = true, intent = null, mode = null } = templateOptions;
     const publishJson = `[${publishTargets.map((t) => `"${t}"`).join(",")}]`;
     // intent(프로젝트 성격, #485) — 미지정이면 deploy/publish에서 역추론해 기록 (재통합 시 진입 질문 생략용)
     const intentVal = intent || inferIntent(deployTarget, publishTargets) || "manual";
     out += `  template:\n`;
     out += `    source: "projectops"\n`;
     out += `    version: "${templateVersion}"\n`;
+    // mode(#502) — 이 레포에 통합된 범위. 업데이트 모드가 같은 범위를 재실행하는 기준.
+    if (mode) out += `    mode: "${mode}"   # 통합 범위(full/version/workflows) — 업데이트 모드 재실행 기준\n`;
     out += `    integrated_date: "${optionsDate}"\n`;
     out += `    last_update_date: "${optionsDate}"\n`;
     out += `    options:\n`;

package/src/core/wizard-env.js

@@ -34,6 +34,19 @@ export function setEnvLine(line, key, value) {
   return out + cr;
 }
 
+// 설치본에서 env 실값 추출 (#502 — 업데이트 모드 carryover).
+// 치환 시 @wizard 주석은 제거되지만 `KEY: "값"` 라인은 남는다(setEnvLine) — 그 값을 걷어온다.
+// 템플릿 지식 불필요: substituteEnv가 values를 ask 키에만 참조하므로 무관 키가 섞여도 무해하다.
+// 빈 값("")은 제외 — substituteEnv도 빈 chosen을 무시하고 기본값을 쓴다 (동일 규칙).
+export function extractEnvValues(installedContent) {
+  const values = new Map();
+  for (const raw of String(installedContent || "").split(/\r?\n/)) {
+    const m = raw.match(/^\s*([A-Z_]+):\s*"([^"]*)"/);
+    if (m && m[2] !== "") values.set(m[1], m[2]);
+  }
+  return values;
+}
+
 // resolver — .sh resolve_token 등가. 값 계산은 주입된 resolvers로 위임(순수성 유지).
 // resolvers: { repo, "spring-app-yml-dir"(type), "spring-app-yml-path"(type), "flutter-root" }
 export function resolveToken(name, type, resolvers = {}) {

package/src/index.js

@@ -132,6 +132,8 @@ export async function run(argv, { cwd = process.cwd(), source = { type: "git" },
     deployTarget,
     publishTargets,
     includeSecretBackup: opts.includeSecretBackup ?? existing?.options?.secretBackup ?? false,
+    // #502 — version 모드가 기존 full 통합 기록(mode)을 강등하지 않도록 (full이 우세)
+    recordMode: existing?.templateMode === "full" ? "full" : "version",
     // 릴리스 배포 브랜치(#456): CLI 플래그 → version.yml 저장값 → 빈 값(미출력, 스킬이 develop 폴백)
     deployBranch: opts.deployBranch || existing?.options?.deployBranch || "",
     intent,

package/src/ui/prompts.js

@@ -6,17 +6,22 @@ import * as engine from "./readline-engine.js";
 export const CANCEL = engine.CANCEL;
 
 // 모드 선택 — 한국어 라벨, 내부 키 반환. 취소 시 CANCEL.
-export async function selectMode() {
-  return engine.select({
-    message: "무엇을 설치할까요?",
-    options: [
-      { value: "full", label: "전체 설치 — 버전관리 + 자동화 워크플로우 + 이슈·PR 템플릿 (처음이라면 추천)" },
-      { value: "version", label: "버전 관리만 — 버전 자동 증가·동기화 시스템만 설치" },
-      { value: "workflows", label: "워크플로우만 — 빌드·배포 GitHub Actions만 설치" },
-      { value: "issues", label: "이슈·PR 템플릿만 — GitHub 이슈/PR 양식만 설치" },
-      { value: "skills", label: "AI 스킬만 — Claude·Cursor·Gemini·Codex·PI용 스킬만 설치" },
-    ],
-  });
+// update(#502): { from, to } — 기존 통합 레포로 판별된 경우. 맨 위에 업데이트 항목을 추가하고
+// 기본 선택으로 둔다 (첫 항목 = 기본). 신규 레포(update 미전달)는 현행 5개 그대로.
+export async function selectMode({ update = null } = {}) {
+  const options = [];
+  if (update) {
+    const range = update.from ? `v${update.from} → v${update.to}` : `v${update.to}`;
+    options.push({ value: "update", label: `업데이트 — 저장된 설정 그대로 ${range} 반영 (추천)` });
+  }
+  options.push(
+    { value: "full", label: `전체 설치 — 버전관리 + 자동화 워크플로우 + 이슈·PR 템플릿${update ? "" : " (처음이라면 추천)"}` },
+    { value: "version", label: "버전 관리만 — 버전 자동 증가·동기화 시스템만 설치" },
+    { value: "workflows", label: "워크플로우만 — 빌드·배포 GitHub Actions만 설치" },
+    { value: "issues", label: "이슈·PR 템플릿만 — GitHub 이슈/PR 양식만 설치" },
+    { value: "skills", label: "AI 스킬만 — Claude·Cursor·Gemini·Codex·PI용 스킬만 설치" },
+  );
+  return engine.select({ message: "무엇을 설치할까요?", options });
 }
 
 // 프로젝트 확인 화면 메뉴 (계속/수정/취소).

package/src/ui/status-cards.js

@@ -85,7 +85,7 @@ export function printIdeStatus(statuses, out = (s) => process.stdout.write(s)) {
 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`);
+    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`);