projectops 4.6.0 → 4.6.1

package/README.md

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

package/package.json

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

package/src/commands/interactive.js

@@ -41,6 +41,11 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
   // finally에서 기록할 때 쓰는 값 — try 안에서 확정되기 전에 취소될 수 있으므로 바깥에 둔다 (#561).
   let traceFrom = "";
   let traceTo = "";
+  // 기록 파일을 남기는 모드인지 — 모드 선택 전에 취소될 수 있어 기본값은 false.
+  let recordArtifacts = false;
+  // 기록을 남기지 않고 끝낼 경우(version/issues 모드의 정상 완주)에만 true.
+  // 취소·예외는 모드와 무관하게 남긴다 — 끊겼을 때가 "어디까지 갔는지"가 가장 궁금한 순간이다.
+  let skipRecord = false;
   if (io === prompts) trace.mirrorStart();
   try {
     // 템플릿 먼저 획득 — 배너에 실제 템플릿 버전을 표시 (.sh는 원격 version.yml fetch L4270~4280 등가)
@@ -378,7 +383,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
 
     // 마이그레이션 기록 (#493/#494) — Layer 2/3 트레이스 파일 + Layer 1 가이드 엔트리 (full/workflows만)
     let migrationGuidePath = null;
-    const recordArtifacts = mode === "full" || mode === "workflows";
+    recordArtifacts = mode === "full" || mode === "workflows";
     // 경로는 먼저 계산하고 실제 쓰기는 완료 화면 뒤로 미룬다 — 요약까지 터미널 미러에 담기 위함 (#561)
     const files = recordArtifacts
       ? trace.paths({ fromVersion: existing?.templateVersion || "", toVersion: templateVersion, now })
@@ -406,16 +411,12 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     }, cwd);
     io.outro?.(`통합 완료 — ${mode} 모드로 설치했습니다.`);
 
-    // 완료 화면까지 캡처한 뒤 종료하고 기록한다 (#561)
+    // 완료 화면까지 출력한 뒤 finally에서 닫는다 (#561) — 여기서 닫으면 이 아래 화면이 안 담긴다.
     trace.event("run", "end", mode || "", {
       workflowsCopied: result?.workflows?.copied ?? 0,
       workflowsSkipped: result?.workflows?.skipped ?? 0,
     });
-    if (recordArtifacts) {
-      trace.finalize({ targetRoot: cwd, fromVersion: existing?.templateVersion || "", toVersion: templateVersion, now });
-    } else {
-      trace.mirrorStop();
-    }
+    skipRecord = !recordArtifacts;
     return 0;
   } catch (err) {
     trace.event("run", "error", "interactive", {
@@ -424,9 +425,10 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     });
     throw err;
   } finally {
-    // 어떤 경로로 빠져나가든 기록을 남긴다 (#561) — 중간 취소·예외 포함.
-    // finalize는 멱등이라 정상 경로에서 이미 호출됐으면 여기서는 아무 일도 하지 않는다.
-    trace.finalize({ targetRoot: cwd, fromVersion: traceFrom, toVersion: traceTo, now: clock?.now || "" });
+    // 어떤 경로로 빠져나가든 기록을 남긴다 (#561) — 중간 취소·예외·Ctrl+C 포함.
+    // 완료 화면 출력이 try 안에 있어야 그 화면까지 미러에 담긴 채로 여기서 닫힌다.
+    if (skipRecord) trace.mirrorStop();
+    else trace.finalize({ targetRoot: cwd, fromVersion: traceFrom, toVersion: traceTo, now: clock?.now || "" });
     disarmSignals();
     remove(tempDir);
   }

package/src/index.js

@@ -294,6 +294,39 @@ export async function run(argv, { cwd = process.cwd(), source = { type: "git" },
         // 알 수 없는 모드 → .sh와 동일하게 복사 0건, 에러 아님
         break;
     }
+    // 마이그레이션 기록 (#493/#494) — Layer 2/3 트레이스 파일 + Layer 1 가이드 엔트리
+    let migrationGuidePath = null;
+    // 기록 파일 경로는 먼저 계산하고(가이드가 참조), 실제 쓰기는 완료 화면 출력 뒤로 미룬다 —
+    // 그래야 터미널 미러에 완료 화면까지 담긴다 (#561).
+    const files = recordArtifacts
+      ? trace.paths({ fromVersion: existing?.templateVersion || "", toVersion: context.templateVersion, now })
+      : null;
+    if (recordArtifacts) {
+      migrationGuidePath = appendGuideEntry(cwd, {
+        now, mode: opts.mode, types, repoName,
+        templateFrom: existing?.templateVersion || "", templateTo: context.templateVersion,
+        options: { deploy: deployTarget, publish: publishTargets, secretBackup: context.includeSecretBackup, coderabbit: context.codeReviewCoderabbit, changelogProvider: context.changelogProvider, intent, semverAuto: context.semverAuto , appRelease: context.appRelease },
+        branches: { defaultBranch: branch, deployBranch: context.deployBranch || "develop", ready: null, created: null },
+        breaking: breakingReport, migrations: migrationsResult, orphans: { cleaned: [], pending: orphanPending },
+        events: trace.events, counters: { skipped: result?.workflows?.skipped ?? 0 },
+        traceFile: files?.traceFile ?? "", logFile: files?.logFile ?? "",
+      }).guidePath;
+    }
+
+    // 완료 요약 (.sh print_summary — CLI 모드에서도 출력)
+    printSummary({
+      mode: opts.mode, types, version, deployBranch: context.deployBranch, migrationGuidePath,
+      counters: { workflows: result?.workflows?.copied ?? 0, workflowFiles: result?.workflows?.copiedFiles ?? [], utilModules: 0 },
+      verification: result?.verification,   // #549 설치 후 검증 결과 (full/workflows 모드에서만 존재)
+      logDir: files ? MIGRATION_DIR : null,   // #561 기록 위치 안내
+      logFile: files?.logFile ?? null,
+      traceFile: files?.traceFile ?? null,
+    }, cwd);
+
+    trace.event("run", "end", opts.mode || "", {
+      workflowsCopied: result?.workflows?.copied ?? 0,
+      workflowsSkipped: result?.workflows?.skipped ?? 0,
+    });
   } catch (err) {
     // 실패 원인을 로그에 남긴다 (#561) — 서버 로그처럼 사후에 바로 짚을 수 있어야 한다.
     trace.event("run", "error", opts.mode || "", {
@@ -302,53 +335,16 @@ export async function run(argv, { cwd = process.cwd(), source = { type: "git" },
     });
     throw err;
   } finally {
-    // 예외로 빠져나가도 기록을 남긴다 (#561). finalize는 멱등 — 정상 경로에서 이미
-    // 호출됐으면 여기서는 아무 일도 하지 않는다.
+    // 어떤 경로로 빠져나가든 기록을 남긴다 (#561) — 조기 return·중간 취소·예외 포함.
+    // 완료 화면 출력이 try 안에 있어야 그 화면까지 미러에 담긴 채로 여기서 닫힌다.
     if (recordArtifacts) {
       trace.finalize({ targetRoot: cwd, fromVersion: existing?.templateVersion || "", toVersion: context.templateVersion, now });
+    } else {
+      trace.mirrorStop();
     }
     disarmSignals();
     remove(tempDir);
   }
 
-  // 마이그레이션 기록 (#493/#494) — Layer 2/3 트레이스 파일 + Layer 1 가이드 엔트리
-  let migrationGuidePath = null;
-  // 기록 파일 경로는 먼저 계산하고(가이드가 참조), 실제 쓰기는 완료 화면 출력 뒤로 미룬다 —
-  // 그래야 터미널 미러에 완료 화면까지 담긴다 (#561).
-  const files = recordArtifacts
-    ? trace.paths({ fromVersion: existing?.templateVersion || "", toVersion: context.templateVersion, now })
-    : null;
-  if (recordArtifacts) {
-    migrationGuidePath = appendGuideEntry(cwd, {
-      now, mode: opts.mode, types, repoName,
-      templateFrom: existing?.templateVersion || "", templateTo: context.templateVersion,
-      options: { deploy: deployTarget, publish: publishTargets, secretBackup: context.includeSecretBackup, coderabbit: context.codeReviewCoderabbit, changelogProvider: context.changelogProvider, intent, semverAuto: context.semverAuto , appRelease: context.appRelease },
-      branches: { defaultBranch: branch, deployBranch: context.deployBranch || "develop", ready: null, created: null },
-      breaking: breakingReport, migrations: migrationsResult, orphans: { cleaned: [], pending: orphanPending },
-      events: trace.events, counters: { skipped: result?.workflows?.skipped ?? 0 },
-      traceFile: files?.traceFile ?? "", logFile: files?.logFile ?? "",
-    }).guidePath;
-  }
-
-  // 완료 요약 (.sh print_summary — CLI 모드에서도 출력)
-  printSummary({
-    mode: opts.mode, types, version, deployBranch: context.deployBranch, migrationGuidePath,
-    counters: { workflows: result?.workflows?.copied ?? 0, workflowFiles: result?.workflows?.copiedFiles ?? [], utilModules: 0 },
-    verification: result?.verification,   // #549 설치 후 검증 결과 (full/workflows 모드에서만 존재)
-    logDir: files ? MIGRATION_DIR : null,   // #561 기록 위치 안내
-    logFile: files?.logFile ?? null,
-    traceFile: files?.traceFile ?? null,
-  }, cwd);
-
-  // 완료 화면까지 캡처한 뒤 종료하고 기록한다 (#561)
-  trace.event("run", "end", opts.mode || "", {
-    workflowsCopied: result?.workflows?.copied ?? 0,
-    workflowsSkipped: result?.workflows?.skipped ?? 0,
-  });
-  if (recordArtifacts) {
-    trace.finalize({ targetRoot: cwd, fromVersion: existing?.templateVersion || "", toVersion: context.templateVersion, now });
-  } else {
-    trace.mirrorStop();
-  }
   return 0;
 }

package/src/ui/summary.js

@@ -131,23 +131,6 @@ export function printSummary(ctx, targetRoot = ".") {
   err("  📚 워크플로우 가이드: .github/workflows/project-types/README.md");
   // #493 — 이번 실행의 마이그레이션 기록. "뭐가 남았고 AI에게 어떻게 시키는지"가 바로 보이게 행동 유도형으로 안내.
   // 실행 기록 위치 (#561) — 무슨 일이 있었는지 나중에 확인할 자리를 알린다.
-  // 폴더가 아니라 이번 실행의 파일을 정확히 짚어준다 — 실행이 쌓이면 어느 것이 이번 건인지
-  // 모른다. 붙여넣어 바로 열 수 있는 경로가 목적이다.
-  if (ctx?.logFile || ctx?.logDir) {
-    err(`  📁 실행 로그: ${ctx.logFile || `${ctx.logDir}/`}`);
-    if (ctx.traceFile) err(`     이벤트(JSONL): ${ctx.traceFile}`);
-    err("     이번 실행에서 무엇을 어떤 근거로 정했는지 전부 기록돼 있습니다.");
-    err("     문제가 생기면 이 파일을 확인하세요 (저장소에 추적되지 않습니다).");
-    err("     💡 AI Agent에게 \"실행 로그 확인해줘\"라고 요청하면 원인을 짚어줍니다.");
-    err("");
-  }
-  if (ctx?.migrationGuidePath) {
-    err(`  🧭 마이그레이션 가이드: ${ctx.migrationGuidePath}`);
-    err("     이번 설치에서 바뀐 내용과 직접 확인해야 할 작업이 이 파일에 정리되어 있습니다.");
-    err("     💡 AI Agent(Claude, Cursor 등)에게 \"마이그레이션 가이드 확인하고");
-    err("        남은 작업 처리해줘\"라고 요청하면 이 문서를 읽고 대신 진행합니다.");
-  }
-  err("");
 
   // 설치 후 검증 결과 (#549) — 문제가 있을 때만 펼치고, 정상이면 한 줄로 압축한다.
   const verification = ctx?.verification;
@@ -215,4 +198,17 @@ export function printSummary(ctx, targetRoot = ".") {
   err(`${CYAN}📖 자세한 설정 방법은 다음 파일을 참고하세요:${NC}`);
   err("   → PROJECTOPS-SETUP-GUIDE.md");
   err("");
+  // 기록 안내는 완료 화면의 맨 끝에 둔다 (#561) — Secret 목록이 길면 위쪽은 스크롤에 묻혀
+  // 사용자가 "로그 얘기가 없다"고 느낀다. 문제가 생겼을 때 가장 먼저 찾는 것이므로 마지막 자리다.
+  if (ctx?.logFile || ctx?.logDir || ctx?.migrationGuidePath) {
+    err(`${CYAN}📁 이번 실행 기록${NC}`);
+    if (ctx?.logFile || ctx?.logDir) {
+      err(`   로그:   ${ctx.logFile || `${ctx.logDir}/`}`);
+      if (ctx.traceFile) err(`   이벤트: ${ctx.traceFile}`);
+    }
+    if (ctx?.migrationGuidePath) err(`   가이드: ${ctx.migrationGuidePath}`);
+    err("   무엇을 어떤 근거로 정했는지 전부 남아 있습니다 (저장소에 추적되지 않음).");
+    err("   💡 문제가 생기면 AI Agent에게 \"실행 로그 확인해줘\"라고 요청하세요.");
+    err("");
+  }
 }