projectops 4.25.1 → 4.26.0

package/README.md

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

package/package.json

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

package/src/commands/interactive.js

@@ -407,6 +407,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     io.summary?.({
       mode, types, version, deployBranch, deployBranchReady, migrationGuidePath,
       counters: { workflows: result?.workflows?.copied ?? 0, workflowFiles: result?.workflows?.copiedFiles ?? [], utilModules: 0 },
+      skippedConflicts: result?.workflows?.skippedConflicts ?? [],   // #654 병합 안내
       verification: result?.verification,      // #549 설치 검증 결과
       aiPrSummary, codeReviewCoderabbit,       // #569 — 고른 것만 안내
       logDir: files ? MIGRATION_DIR : null,    // #561 기록 위치 안내

package/src/core/copy/workflows.js

@@ -9,6 +9,7 @@ import { exists, copyFileSync, listYamlFiles } from "../fsutil.js";
 import { isUnchanged, substituteEnv } from "../wizard-env.js";
 import { isUserModified, readBaseline, writeBaseline, sha256 } from "../baseline.js";
 import { substituteBranches } from "../branch-sub.js";
+import { saveIncoming, lineDiffCounts } from "../incoming.js";
 
 // 한 파일에 env 치환을 적용해 대상 파일을 갱신 (.sh configure_workflow_env 등가).
 // values/useDefaults: env 계획(promptEnvPlan) 결과 — 미지정이면 기본값 경로(현행 force 동작).
@@ -79,7 +80,8 @@ export function copyWorkflows(context, tempDir, targetRoot = ".", hooks = {}) {
   const projectTypesDir = join(tempDir, PATHS.workflowsDir, PATHS.projectTypesDir);
   if (!exists(projectTypesDir)) throw new Error("템플릿 저장소 구조 오류 — project-types 폴더를 찾지 못했습니다.");
 
-  const counters = { copied: 0, skipped: 0, templateAdded: 0, optionalCopied: 0, copiedFiles: [] };
+  const counters = { copied: 0, skipped: 0, templateAdded: 0, optionalCopied: 0, copiedFiles: [],
+    skippedConflicts: [] }; // #654 — 유지한 사용자 수정본별 { filename, incoming, added, removed }
   const deployValues = new Map(); // Map<type, Map<key,value>> — deploy 블록용 ask 값
   counters.deployValues = deployValues;
   // 브랜치 전략 (#477) — 표준(main/develop)이면 치환·가상비교 모두 no-op
@@ -87,6 +89,27 @@ export function copyWorkflows(context, tempDir, targetRoot = ".", hooks = {}) {
   // values/useDefaults는 치환 경로에서만 의미 (isUnchanged는 내부에서 useDefaults:true 강제 — 가상 비교 무손상)
   const envOptsFor = (type) => ({ type, projectPath: paths.get(type) || ".", repoName, resolvers, values: envValues, useDefaults: envUseDefaults, branches });
 
+  // 사용자 수정본을 유지할 때 새 템플릿 사본을 incoming에 남긴다 (#654).
+  // 실패는 경고 한 줄로 흡수한다 — 병합 안내 때문에 복사 전체가 죽으면 안 된다.
+  const onSkip = (srcDir, filename, type) => {
+    const info = { filename, incoming: "", added: null, removed: null };
+    try {
+      // 설치 때와 같은 렌더(기본값 치환 + 브랜치 치환)를 거쳐야 diff가 "진짜 차이"만 보여준다
+      const rendered = substituteBranches(
+        substituteEnv(readFileSync(join(srcDir, filename), "utf8"), { ...envOptsFor(type), useDefaults: true }), branches);
+      info.incoming = saveIncoming(targetRoot, filename, rendered);
+      const d = lineDiffCounts(readFileSync(join(workflowsDir, filename), "utf8"), rendered);
+      info.added = d.added; info.removed = d.removed;
+    } catch (e) {
+      trace?.event("copy", "incoming-failed", filename, { message: e?.message || String(e) });
+      console.error(`⚠️ incoming 저장 실패(${filename}): ${e?.message || e} — 병합 안내 없이 계속합니다.`);
+    }
+    counters.skippedConflicts.push(info);
+    return info;
+  };
+  // 반환 객체의 열거 가능한 필드를 늘리지 않는다 (기존 호출부·테스트가 counters 모양에 기대고 있다)
+  Object.defineProperty(counters, "onSkip", { value: onSkip, enumerable: false });
+
   // (1) common — 타입별과 동일한 판정·보호를 받는다 (#560).
   //
   // 종전에는 "unchanged면 스킵, 아니면 무조건 덮어쓰기"였다. 그런데 릴리스 파이프라인처럼
@@ -132,7 +155,7 @@ export function copyWorkflows(context, tempDir, targetRoot = ".", hooks = {}) {
         continue;
       }
       // 사용자가 손댄 것이 확인된 파일 — 결정에 따라 처리(미지정이면 유지).
-      applyDecision(decisions.get(filename), commonDir, workflowsDir, filename, counters, trace);
+      applyDecision(decisions.get(filename), commonDir, workflowsDir, filename, counters, trace, "common");
     }
   }
 
@@ -251,7 +274,7 @@ function recordBaseline(workflowsDir, targetRoot, counters, previous, templateVe
 
 // changed(기존에 있고 내용이 바뀐) 파일 1개를 결정에 따라 처리 (.sh 3440~3508 3지선 case 등가).
 // 'skip'(기본): 기존 유지. 'backup': 기존→.bak 후 교체. 'template': 기존 유지 + 새 버전을 .template.yaml로.
-function applyDecision(decision, srcDir, workflowsDir, filename, counters, trace = null) {
+function applyDecision(decision, srcDir, workflowsDir, filename, counters, trace = null, type = "") {
   const src = join(srcDir, filename);
   const dst = join(workflowsDir, filename);
   if (decision === "backup") {
@@ -272,7 +295,12 @@ function applyDecision(decision, srcDir, workflowsDir, filename, counters, trace
     return;
   }
   counters.skipped++; // 'skip'/미지정/ESC → 기존 유지 (.sh S)·force 기본)
-  trace?.event("copy", "skipped-conflict", filename, { decision: decision ?? "skip", note: "사용자 수정본 유지 — 병합 검토 후보" });
+  // #654 — 새 템플릿을 incoming에 남기고 diff 줄 수를 detail로 함께 기록
+  const inc = counters.onSkip?.(srcDir, filename, type) ?? {};
+  trace?.event("copy", "skipped-conflict", filename, {
+    decision: decision ?? "skip", note: "사용자 수정본 유지 — 병합 검토 후보",
+    incoming: inc.incoming || null, added: inc.added ?? null, removed: inc.removed ?? null,
+  });
 }
 
 // 대상 워크플로우 디렉토리에서 changed(충돌) 파일 목록만 뽑는다 — copyWorkflowsInteractive의 사전 조사용.
@@ -345,7 +373,7 @@ function copyWorkflowsForType(type, projectTypesDir, workflowsDir, ctx, counters
     // upstream(#557): 사용자가 손대지 않았고 템플릿만 바뀐 파일 — 물어볼 것 없이 최신으로 올린다.
     for (const f of upstream) { copyFileSync(join(typeDir, f), join(workflowsDir, f)); counters.copied++; counters.copiedFiles.push(f); trace?.event("copy", "upstream-updated", f, { group: type, reason: "baseline-match" }); }
     // changed: 결정 Map에 따라 처리 (미지정=skip → 현행 force 동작과 동일)
-    for (const f of changed) applyDecision(decisions.get(f), typeDir, workflowsDir, f, counters, trace);
+    for (const f of changed) applyDecision(decisions.get(f), typeDir, workflowsDir, f, counters, trace, type);
   }
 
   // server-deploy — deploy=docker-ssh일 때만 포함 (#439)
@@ -355,7 +383,7 @@ function copyWorkflowsForType(type, projectTypesDir, workflowsDir, ctx, counters
     for (const f of unchanged) { counters.skipped++; trace?.event("copy", "skipped-unchanged", f, { group: `${type}/server-deploy` }); }
     for (const f of newFiles) { copyFileSync(join(serverDeployDir, f), join(workflowsDir, f)); counters.copied++; counters.copiedFiles.push(f); trace?.event("copy", "copied", f, { group: `${type}/server-deploy` }); }
     for (const f of upstream) { copyFileSync(join(serverDeployDir, f), join(workflowsDir, f)); counters.copied++; counters.copiedFiles.push(f); trace?.event("copy", "upstream-updated", f, { group: `${type}/server-deploy`, reason: "baseline-match" }); }
-    for (const f of changed) applyDecision(decisions.get(f), serverDeployDir, workflowsDir, f, counters, trace);
+    for (const f of changed) applyDecision(decisions.get(f), serverDeployDir, workflowsDir, f, counters, trace, type);
   }
 
   // publish/<target> (opt-in — #439 publish 축. 타입은 파일 위치일 뿐 게이트가 아니다)

package/src/core/incoming.js

@@ -0,0 +1,56 @@
+// 건너뛴 워크플로의 새 템플릿 보관소 (#654).
+// 사용자가 수정한 워크플로는 덮어쓰지 않고 유지한다. 대신 "새 템플릿이 어떻게 다른지"를
+// 비교할 수 있도록 추적되지 않는 자리에 사본을 남긴다.
+// 절대 .github/workflows 에 쓰지 않는다 — 거기 생긴 파일은 GitHub 이 실제 워크플로로 실행한다.
+import { join } from "node:path";
+import { writeText } from "./fsutil.js";
+
+export const INCOMING_DIR = ".github/.projectops/incoming";
+// 폴더가 스스로 추적 제외 규칙을 들고 다닌다 (logs/.gitignore 와 같은 방식, 루트 .gitignore 무수정)
+export const INCOMING_GITIGNORE = [
+  "# projectops 가 건너뛴 워크플로의 새 템플릿 사본 — 저장소에 추적하지 않습니다.",
+  "# 병합 검토용 임시 자료이며 실행할 때마다 최신으로 덮어씁니다.",
+  "*",
+  "!.gitignore",
+  "",
+].join("\n");
+
+const toLines = (s) => {
+  const lines = String(s).split(/\r?\n/);
+  if (lines.length && lines[lines.length - 1] === "") lines.pop(); // 끝 개행이 만드는 빈 줄 제외
+  return lines;
+};
+
+// 줄 단위 추가/삭제 개수. LCS 기반이라 줄이 이동만 한 경우도 과대 계상하지 않는다.
+// removed: 사용자본에만 있는 줄, added: 새 템플릿에만 있는 줄.
+export function lineDiffCounts(userText, incomingText) {
+  const a = toLines(userText);
+  const b = toLines(incomingText);
+  // 공통 접두/접미는 LCS에서 뺀다 (워크플로 대부분이 같아 표가 작아진다)
+  let s = 0;
+  while (s < a.length && s < b.length && a[s] === b[s]) s++;
+  let ea = a.length; let eb = b.length;
+  while (ea > s && eb > s && a[ea - 1] === b[eb - 1]) { ea--; eb--; }
+  const x = a.slice(s, ea); const y = b.slice(s, eb);
+  if (x.length * y.length > 25_000_000) {
+    // 비정상적으로 큰 파일 — 정확도 대신 크기 차이로 근사한다 (실패시키지 않는다)
+    return { added: y.length, removed: x.length };
+  }
+  let prev = new Array(y.length + 1).fill(0);
+  for (let i = 1; i <= x.length; i++) {
+    const cur = new Array(y.length + 1).fill(0);
+    for (let j = 1; j <= y.length; j++) {
+      cur[j] = x[i - 1] === y[j - 1] ? prev[j - 1] + 1 : Math.max(prev[j], cur[j - 1]);
+    }
+    prev = cur;
+  }
+  const common = prev[y.length];
+  return { added: y.length - common, removed: x.length - common };
+}
+
+// incoming 폴더에 새 템플릿을 저장한다. 반환: 대상 기준 상대 경로(항상 '/').
+export function saveIncoming(targetRoot, filename, content) {
+  writeText(join(targetRoot, INCOMING_DIR, ".gitignore"), INCOMING_GITIGNORE);
+  writeText(join(targetRoot, INCOMING_DIR, filename), content);
+  return `${INCOMING_DIR}/${filename}`;
+}

package/src/core/migration-guide.js

@@ -52,6 +52,9 @@ export function deriveWorkflowLists(events = []) {
     added: pick("copied"),
     replacedBak: pick("replaced-bak"),
     skippedConflict: pick("skipped-conflict"),
+    // #654 — 건너뛴 파일별 새 템플릿 사본 경로와 diff 줄 수 (이벤트 detail에서 파생)
+    skippedConflictDetails: events.filter((e) => e.phase === "copy" && e.action === "skipped-conflict")
+      .map((e) => ({ file: e.target, incoming: e.detail?.incoming ?? "", added: e.detail?.added ?? null, removed: e.detail?.removed ?? null })),
     templateAdded: pick("template-added"),
     excluded: pick("excluded"),
   };
@@ -112,6 +115,11 @@ export function renderGuideEntry(report) {
   }
   if (wf.skippedConflict.length) {
     checklist.push(`- [ ] **기존 수정본 유지 ${wf.skippedConflict.length}개, 신형과 병합 검토**: ${wf.skippedConflict.map((f) => `\`${f}\``).join(", ")}`);
+    // #654 — 새 템플릿 사본이 있으면 비교 방법까지 적는다
+    for (const d of wf.skippedConflictDetails.filter((x) => x.incoming)) {
+      const cnt = d.added != null && d.removed != null ? ` (추가 ${d.added}줄, 삭제 ${d.removed}줄)` : "";
+      checklist.push(`  - \`${d.file}\`${cnt}: \`diff -u .github/workflows/${d.file} ${d.incoming}\``);
+    }
   }
   if (wf.added.length || wf.replacedBak.length) {
     checklist.push(`- [ ] **새/갱신 CICD가 요구하는 GitHub Secrets 등록 확인** (Settings → Secrets → Actions, \`_GITHUB_PAT_TOKEN\` 포함)`);
@@ -162,6 +170,11 @@ export function renderGuideEntry(report) {
   L.push(`  added: ${ylist(wf.added)}`);
   L.push(`  replaced_bak: ${ylist(wf.replacedBak)}`);
   L.push(`  skipped_conflict: ${ylist(wf.skippedConflict)}`);
+  const inc = wf.skippedConflictDetails.filter((d) => d.incoming);
+  if (inc.length) {
+    L.push("  skipped_conflict_incoming:");
+    for (const d of inc) L.push(`    - { file: ${yq(d.file)}, incoming: ${yq(d.incoming)}, added: ${d.added ?? "null"}, removed: ${d.removed ?? "null"} }`);
+  }
   L.push(`  template_added: ${ylist(wf.templateAdded)}`);
   if (legacyNeutralized.length) {
     L.push("  legacy_neutralized:");

package/src/core/run-trace.js

@@ -50,7 +50,7 @@ function elapsed(t0, clockIso) {
 const ERROR_ACTIONS = new Set(["error", "failed"]);
 const WARN_ACTIONS = new Set([
   "unresolved", "cancelled", "skipped-conflict", "leftover-old-gen",
-  "neutralized", "detected", "replaced-bak",
+  "neutralized", "detected", "replaced-bak", "incoming-failed",
 ]);
 const DEBUG_ACTIONS = new Set([
   "copied", "skipped-unchanged", "excluded", "substituted", "branch-substituted",

package/src/index.js

@@ -321,6 +321,7 @@ export async function run(argv, { cwd = process.cwd(), source = { type: "git" },
     printSummary({
       mode: opts.mode, types, version, deployBranch: context.deployBranch, migrationGuidePath,
       counters: { workflows: result?.workflows?.copied ?? 0, workflowFiles: result?.workflows?.copiedFiles ?? [], utilModules: 0 },
+      skippedConflicts: result?.workflows?.skippedConflicts ?? [],   // #654 병합 안내
       verification: result?.verification,   // #549 설치 후 검증 결과 (full/workflows 모드에서만 존재)
       // #569 — 고른 것만 안내하려면 선택값이 필요하다
       aiPrSummary: context.aiPrSummary, codeReviewCoderabbit: context.codeReviewCoderabbit,

package/src/ui/summary.js

@@ -90,6 +90,26 @@ export function printSummary(ctx, targetRoot = ".") {
     err("  📦 새로 설치·갱신된 워크플로우 없음 — 모두 최신 상태");
   }
 
+  // #654 — 사용자 수정본을 유지한 워크플로: 무엇이 얼마나 다른지, 어떻게 병합하는지 안내한다.
+  // 건너뛴 것이 없으면 아무것도 출력하지 않는다 (기존 출력 유지).
+  const kept = ctx?.skippedConflicts ?? [];
+  if (kept.length > 0) {
+    err("");
+    err(`  ${YELLOW}✋ 수정한 워크플로 ${kept.length}개는 덮어쓰지 않고 그대로 두었습니다${NC}`);
+    for (const k of kept) {
+      const cnt = k.added != null && k.removed != null ? ` (새 템플릿 기준 추가 ${k.added}줄, 삭제 ${k.removed}줄)` : "";
+      err(`     📝 ${k.filename}${cnt}`);
+      if (k.incoming) {
+        err(`        diff -u .github/workflows/${k.filename} ${k.incoming}`);
+        err(`        git diff --no-index .github/workflows/${k.filename} ${k.incoming}`);
+      }
+    }
+    if (kept.some((k) => k.incoming)) {
+      err("     💡 새 템플릿 사본은 저장소에 추적되지 않는 .github/.projectops/incoming/ 에 있습니다.");
+      err("        필요한 변경만 워크플로에 직접 옮겨 반영하세요.");
+    }
+  }
+
   err("");
   err("  🔧 .github/scripts/");
   err("     ├─ version_manager.sh");