projectops 4.7.0 → 4.8.0

package/README.md

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

package/package.json

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

package/src/commands/doctor.js

@@ -100,6 +100,27 @@ export function localChecks(cwd = ".") {
     ] : null,
   });
 
+  // AI 요약 키 (#569) — "등록했는데 되는 건가?"를 확인할 수단이 없었다.
+  // 로컬에서는 저장소 Secret을 읽을 수 없으므로, 어떤 이름을 쓰면 되는지와
+  // 등록하지 않아도 무방하다는 사실을 알려준다. 실제 등록 여부는 원격 점검이 본다.
+  const AI_KEY_NAMES = ["GEMINI_API_KEY", "OPENAI_API_KEY", "ANTHROPIC_API_KEY", "GROQ_API_KEY", "MISTRAL_API_KEY"];
+  const hasSummaryWf = files.some((f) => /AI-PR-SUMMARY|RELEASE-CHANGELOG/.test(f));
+  if (hasSummaryWf) {
+    add({
+      name: "AI 요약 키", purpose: "릴리스 노트를 AI로 다듬을지 (선택)",
+      status: "INFO", value: "선택 사항",
+      detail: [
+        "등록하지 않아도 릴리스 노트는 나옵니다 — 커밋 내용을 분석해 만듭니다.",
+        "AI가 다듬은 문장을 원하면 아래 중 하나를 저장소 Secret에 등록하세요.",
+        "  GEMINI_API_KEY     무료 · https://aistudio.google.com/apikey",
+        "  GROQ_API_KEY       무료",
+        "  MISTRAL_API_KEY    무료",
+        "  OPENAI_API_KEY / ANTHROPIC_API_KEY   유료",
+        "등록한 것이 자동으로 쓰입니다. 별도 설정은 필요 없습니다.",
+      ],
+    });
+  }
+
   // 워크플로우 파일의 permissions 선언 점검 (#558).
   // 저장소 설정(Settings > Actions)은 "요청할 수 있는 최대 범위"이고, 워크플로우의
   // permissions 블록은 "실제로 요청한 범위"다. 둘은 다른 층이라 저장소 설정이 정상이어도
@@ -190,6 +211,20 @@ export async function remoteChecks(slug, token, requiredSecrets = []) {
             detail: ["토큰에 Secret 조회 권한이 없어 확인하지 못했습니다."] });
     } else {
       const have = new Set((sec.data?.secrets || []).map((s) => s.name));
+
+      // AI 요약 키가 실제로 등록돼 있는지 (#569) — 있으면 어느 서비스인지까지 보여준다.
+      const AI_KEYS = { GEMINI_API_KEY: "Gemini", OPENAI_API_KEY: "OpenAI", ANTHROPIC_API_KEY: "Anthropic",
+                        GROQ_API_KEY: "Groq", MISTRAL_API_KEY: "Mistral", MODEL_API_KEY: "구 이름(서비스 자동 추정)" };
+      const foundAi = Object.entries(AI_KEYS).filter(([n]) => have.has(n));
+      rows.push({
+        name: "AI 요약 키 등록", purpose: "릴리스 노트를 AI로 다듬을지 (선택)",
+        status: "INFO",
+        value: foundAi.length ? foundAi.map(([n, label]) => `${n} (${label})`).join(", ") : "없음 — 커밋 분석으로 동작",
+        detail: foundAi.length ? null : [
+          "등록하지 않아도 릴리스 노트는 정상적으로 나옵니다.",
+          "AI를 쓰려면 GEMINI_API_KEY(무료)를 등록하세요 — https://aistudio.google.com/apikey",
+        ],
+      });
       const missing = requiredSecrets.filter((n) => !have.has(n));
       add({
         name: "Secret 등록 여부", purpose: "배포에 필요한 값",

package/src/commands/interactive.js

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

package/src/core/options-ask.js

@@ -332,18 +332,22 @@ export async function askAllOptionalWorkflows({
   // 저장소가 생겼다. 둘은 같은 자리(PR 댓글)를 놓고 경쟁하므로 한 번에 고르게 한다.
   if (ask("code-review") || codeReviewCoderabbit === null || aiPrSummary === null) {
     if (force || !tty || typeof io.select !== "function") {
-      // 비대화형 기본값: CodeRabbit은 외부 앱 설치가 필요하므로 끄고, 자체 요약만 켠다.
+      // 비대화형 기본값: CodeRabbit은 별도 앱 설치가 있어야 실제로 동작하므로
+      // 자동화 환경에서 켜봐야 의미가 없다. 설정 없이 바로 도는 요약만 켠다.
       codeReviewCoderabbit = codeReviewCoderabbit ?? false;
       aiPrSummary = aiPrSummary ?? true;
     } else {
       say("");
-      say("💬 PR에 리뷰·요약 댓글을 어떻게 받으시겠어요?");
+      say("💬 PR에 어떤 댓글을 받으시겠어요?");
+      say("   두 가지는 하는 일이 다르고 한도도 따로라, 같이 켜도 서로 방해하지 않습니다.");
+      say("   · 변경 요약 — 무엇이 바뀌었는지 (추가 설정 없이 바로 동작)");
+      say("   · 코드 리뷰 — 버그·개선점 지적 (CodeRabbit 앱 설치 필요, 공개 저장소 무료)");
       const ans = await io.select({
         message: "PR 댓글 방식을 선택하세요",
         options: [
-          { value: "summary", label: "AI 변경 요약 (추천 · 추가 설정 불필요)" },
-          { value: "coderabbit", label: "CodeRabbit 코드 리뷰 (외부 앱 설치 필요)" },
-          { value: "both", label: "둘 다" },
+          { value: "both", label: "둘 다 (추천 · 무료로 쓸 수 있습니다)" },
+          { value: "summary", label: "변경 요약만 (추가 설정 불필요)" },
+          { value: "coderabbit", label: "코드 리뷰만 (CodeRabbit)" },
           { value: "none", label: "사용 안 함" },
         ],
       });

package/src/core/verify.js

@@ -68,7 +68,7 @@ const AUTO_SECRETS = new Set(["GITHUB_TOKEN"]);
 
 // 없어도 워크플로우가 도는 secret — 폴백이 문서화돼 있다. 필수와 섞어 "등록해야 동작합니다"라고
 // 하면 안내 자체를 못 믿게 되므로 분리한다.
-//   MODEL_API_KEY      → 없으면 GitHub Models(무료) → commit 규칙 fallback (#455 provider 사다리)
+//   MODEL_API_KEY      → 등록하면 외부 AI 요약, 없으면 Copilot → 커밋 분석 (#455·#566 사다리)
 //   _GITHUB_PAT_TOKEN  → 없으면 GITHUB_TOKEN으로 머지하고 후속 워크플로우를 직접 깨운다 (#551)
 export const OPTIONAL_SECRETS = new Set(["MODEL_API_KEY", "_GITHUB_PAT_TOKEN"]);
 

package/src/index.js

@@ -322,6 +322,8 @@ export async function run(argv, { cwd = process.cwd(), source = { type: "git" },
       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 모드에서만 존재)
+      // #569 — 고른 것만 안내하려면 선택값이 필요하다
+      aiPrSummary: context.aiPrSummary, codeReviewCoderabbit: context.codeReviewCoderabbit,
       logDir: files ? MIGRATION_DIR : null,   // #561 기록 위치 안내
       logFile: files?.logFile ?? null,
       traceFile: files?.traceFile ?? null,

package/src/ui/summary.js

@@ -13,6 +13,7 @@ export function printSummary(ctx, targetRoot = ".") {
   const err = (s = "") => process.stderr.write(`${s}\n`);
   // 색상은 TTY일 때만 (.sh YELLOW/CYAN/NC 등가)
   const isTty = !!process.stderr.isTTY;
+  const BOLD = isTty ? "\u001b[1m" : "";
   const YELLOW = isTty ? "\x1b[1;33m" : "";
   const CYAN = isTty ? "\x1b[0;36m" : "";
   const NC = isTty ? "\x1b[0m" : "";
@@ -190,9 +191,32 @@ export function printSummary(ctx, targetRoot = ".") {
     err(`     → git checkout -b ${deployBranchName} && git push -u origin ${deployBranchName}`);
   }
   err("");
-  err("  3️⃣  CodeRabbit 활성화 (코드 리뷰를 켰다면)");
-  err("     → https://coderabbit.ai 로그인 → GitHub 앱 설치 → 이 저장소에 접근 권한(grant access) 부여");
-  err("");
+  // #569 — 선택한 것만 안내한다. 끈 기능의 설정법을 보여주면 무엇을 해야 하는지 흐려진다.
+  let step = 3;
+  if (ctx?.aiPrSummary !== false) {
+    err(`  ${step}️⃣  (선택) AI가 다듬은 릴리스 노트 받기`);
+    err("     → 지금 상태로도 릴리스 노트는 나옵니다. 커밋 내용을 분석해 만들기 때문에");
+    err("        아무 설정을 하지 않아도 됩니다. 아래는 문장을 더 매끄럽게 하고 싶을 때만 하세요.");
+    err("");
+    err("     ① Google AI Studio에서 키 발급 (무료 · 신용카드 불필요 · 2분)");
+    err("        https://aistudio.google.com/apikey");
+    err("     ② 이 저장소에 등록");
+    err("        Settings > Secrets and variables > Actions > New repository secret");
+    err(`        ${BOLD}Name: GEMINI_API_KEY${NC}   Secret: 발급받은 키(AIza... 로 시작)`);
+    err("");
+    err("     💡 다른 서비스를 쓴다면 이름만 바꿔 등록하면 됩니다 — 등록한 것이 자동으로 쓰입니다.");
+    err("        OPENAI_API_KEY · ANTHROPIC_API_KEY · GROQ_API_KEY · MISTRAL_API_KEY");
+    err("");
+    step++;
+  }
+  if (ctx?.codeReviewCoderabbit === true) {
+    err(`  ${step}️⃣  CodeRabbit 활성화`);
+    err("     → https://coderabbit.ai 로그인 → GitHub 앱 설치 → 이 저장소에 접근 권한(grant access) 부여");
+    err("     → 이 단계를 안 하면 워크플로우는 켜져도 PR에 리뷰 댓글이 달리지 않습니다");
+    err("     → 공개 저장소는 무료입니다 (시간당 3회 리뷰 제한)");
+    err("");
+    step++;
+  }
   err(SEPARATOR);
   err("");
   err(`${CYAN}📖 자세한 설정 방법은 다음 파일을 참고하세요:${NC}`);