project-auto-wizard 0.11.0 → 0.12.1

package/src/core/copy/workflows.js

@@ -59,7 +59,7 @@ function renderVirtual(templateContent, envOpts) {
 
 // 분류 — 대상 워크플로우 디렉토리 기준. srcText: 브랜치 치환이 적용된 원본 로더 (makeSrcText).
 //
-// baseline이 있으면 3-way로 가른다 (issue #69). base가 없던 시절에는 업스트림이 한 글자만 고쳐도
+// baseline이 있으면 3-way로 가른다. base가 없던 시절에는 업스트림이 한 글자만 고쳐도
 // 사용자가 손대지 않은 파일이 changed로 떨어져, "전부 skip" 아니면 "전부 backup" 둘 중 하나만
 // 고를 수 있었다.
 //
@@ -101,7 +101,7 @@ function classify(srcDir, workflowsDir, envOpts, srcText, baseline = null, filte
 // 한 원본 디렉토리를 분류 결과대로 처리한다. common·타입별·server-deploy가 같은 규칙을 쓴다.
 // filter: trunk-based 제외 같은 파일 단위 필터.
 //
-// 자동 처리되는 두 버킷이 이 함수의 핵심이다 (issue #69):
+// 자동 처리되는 두 버킷이 이 함수의 핵심이다:
 //   upstreamOnly — 사용자가 손대지 않았으니 그냥 최신으로 교체한다. 물어볼 이유가 없다.
 //   localOnly    — 업스트림이 그대로니 사용자 수정본을 그대로 둔다. 역시 물어볼 이유가 없다.
 function processDir(srcDir, workflowsDir, envOpts, ctx, counters, filter = () => true) {
@@ -153,25 +153,25 @@ function processDir(srcDir, workflowsDir, envOpts, ctx, counters, filter = () =>
 }
 
 // copy_workflows 본체 (동기 — 기존 호출부 무변경).
-// context: { types:[], paths:Map, includeNexus, includeSecretBackup, force, repoName, resolvers,
+// context: { types:[], paths:Map, force, repoName, resolvers,
 //            envValues?:Map<key,value>, envUseDefaults?:boolean }  ← env 계획(promptEnvPlan) 결과 주입점
 //            flutterStore?:string[]|null }  ← Flutter 스토어 대상 (null=필터 없음, 배열=선택된 플랫폼만)
 // hooks: { decisions?: Map<filename, 'skip'|'backup'|'template'>,   — 진짜 충돌(changed) 결정
 //          restoreRemoved?: Set<filename> }                          — 사용자가 지운 파일 중 복원할 것
 //        미지정 파일은 'skip'(현행 force 동작 100% 유지). 대화형 수집은 copyWorkflowsInteractive 참조.
-// 반환: {copied, skipped, templateAdded, optionalCopied, backupAdded, autoUpdated, keptLocal, removedKept, restoredFiles}
+// 반환: {copied, skipped, templateAdded, backupAdded, autoUpdated, keptLocal, removedKept, restoredFiles}
 export function copyWorkflows(context, payloadRoot, targetRoot = ".", hooks = {}) {
-  const { types = [], paths = new Map(), includeNexus = false, includeSecretBackup = false, repoName = "", resolvers = {}, envValues = new Map(), envUseDefaults = true } = context;
+  const { types = [], paths = new Map(), repoName = "", resolvers = {}, envValues = new Map(), envUseDefaults = true } = context;
   const decisions = hooks.decisions instanceof Map ? hooks.decisions : new Map();
   const restoreRemoved = hooks.restoreRemoved instanceof Set ? hooks.restoreRemoved : new Set();
   const workflowsDir = join(targetRoot, PATHS.workflowsDir);
   const projectTypesDir = join(payloadRoot, PAYLOAD.workflowsDir);
   if (!exists(projectTypesDir)) throw new Error("패키지 구조 오류 — payload/workflows 폴더를 찾지 못했습니다.");
 
-  const counters = { copied: 0, skipped: 0, templateAdded: 0, optionalCopied: 0, backupAdded: 0 };
+  const counters = { copied: 0, skipped: 0, templateAdded: 0, backupAdded: 0 };
   const deployValues = new Map(); // Map<type, Map<key,value>> — deploy 블록용 ask 값
   counters.deployValues = deployValues;
-  counters.copiedFiles = []; // 이번 실행에서 실제로 새로 쓰여진 파일명 (issue #19 — printSummary 정확성용)
+  counters.copiedFiles = []; // 이번 실행에서 실제로 새로 쓰여진 파일명 (printSummary 정확성용)
   counters.unchangedFiles = []; // skip(unchanged) 대상 — 로그에서 "왜 안 바뀌었나"의 근거
   counters.autoUpdated = [];    // 질문 없이 최신으로 교체된 파일 (사용자 미수정)
   counters.keptLocal = [];      // 질문 없이 사용자 수정본을 유지한 파일 (업스트림 무변경)
@@ -185,7 +185,7 @@ export function copyWorkflows(context, payloadRoot, targetRoot = ".", hooks = {}
   const envOptsFor = (type) => ({ type, projectPath: paths.get(type) || ".", repoName, resolvers, values: envValues, useDefaults: envUseDefaults });
   const dirCtx = { srcText, baseline, decisions, restoreRemoved, baselineTargets };
 
-  // (1) common — 타입별과 동일 규칙 (README 계약, issue #20 H3).
+  // (1) common — 타입별과 동일 규칙 (README 계약).
   //     trunk-based 모드는 VERSION-CONTROL·AUTO-CHANGELOG 미설치 (RELEASE-PUBLISH 단독).
   const branchMode = context.branches?.mode || "pr-flow";
   const commonDir = join(projectTypesDir, "common");
@@ -194,7 +194,7 @@ export function copyWorkflows(context, payloadRoot, targetRoot = ".", hooks = {}
     const c = processDir(commonDir, workflowsDir, envOptsFor("common"), dirCtx, counters, notExcluded);
     // env 치환 — 타입별 폴더(copyWorkflowsForType)와 동일하게, 손대지 않기로 한 파일(unchanged/localOnly)은
     // 건너뛴다. common 최상위는 지금까지 @wizard 마커가 없어 이 루프가 없어도 드러나지 않았지만,
-    // ISSUE_HELPER_CREATE_BRANCH(issue #94)부터는 실제로 값이 반영돼야 한다.
+    // ISSUE_HELPER_CREATE_BRANCH부터는 실제로 값이 반영돼야 한다.
     const untouched = [...c.unchanged, ...c.localOnly];
     for (const filename of listYamlFiles(commonDir)) {
       if (!notExcluded(filename)) continue;
@@ -208,27 +208,10 @@ export function copyWorkflows(context, payloadRoot, targetRoot = ".", hooks = {}
   // (2~4) 타입별
   for (const type of types) {
     const asks = new Map();
-    copyWorkflowsForType(type, projectTypesDir, workflowsDir, { includeNexus, ...context, deployStyle, envOptsFor, collectAsks: asks, dirCtx }, counters);
+    copyWorkflowsForType(type, projectTypesDir, workflowsDir, { ...context, deployStyle, envOptsFor, collectAsks: asks, dirCtx }, counters);
     if (asks.size) deployValues.set(type, asks);
   }
 
-  // (5) common/secret-backup — 있으면 무조건 스킵/신규만 복사
-  const secretDir = join(commonDir, "secret-backup");
-  if (exists(secretDir) && includeSecretBackup) {
-    for (const filename of listYamlFiles(secretDir)) {
-      const dst = join(workflowsDir, filename);
-      if (existsSync(dst)) continue; // 이미 존재하면 스킵
-      writeText(dst, srcText(join(secretDir, filename)));
-      // 이 경로는 타입별 복사 루프 밖이라 env 치환 루프가 닿지 않는다. 여기서 직접 걸어주지
-      // 않으면 이 파일의 @wizard 마커가 통째로 무시돼 __PROJECT_NAME__ 같은 값이 그대로 설치된다.
-      configureEnv(dst, envOptsFor("common"));
-      counters.optionalCopied++;
-      counters.copied++;
-      counters.copiedFiles.push(filename);
-      baselineTargets.set(filename, { srcPath: join(secretDir, filename), envOpts: envOptsFor("common"), wrote: true });
-    }
-  }
-
   counters.baselineTargets = baselineTargets; // 호출부(runFull)가 env 치환 완료 후 baseline을 기록한다
   return counters;
 }
@@ -276,14 +259,14 @@ function applyDecision(decision, srcDir, workflowsDir, filename, counters, srcTe
   log.info("copy", "skip", `${filename} (사용자 결정: 기존 유지)`);
 }
 
-// 대화형 사전 조사 — 사람이 답해야 하는 것만 뽑는다 (issue #69).
+// 대화형 사전 조사 — 사람이 답해야 하는 것만 뽑는다.
 // copyWorkflows 본체와 동일한 classify 기준을 써야 결정 Map이 실제 처리 대상과 1:1로 맞는다.
-// common도 타입별과 동일하게 스캔한다 (issue #20 H3 — 이전에는 common 충돌이 질문조차 되지 않았다).
+// common도 타입별과 동일하게 스캔한다 (이전에는 common 충돌이 질문조차 되지 않았다).
 // 반환: { conflicts: [{filename,type}], removed: [{filename,type}] }
 //   conflicts — 양쪽이 다 바뀐 진짜 충돌. upstreamOnly/localOnly는 자동 처리되므로 여기 없다.
 //   removed   — 우리가 깔았는데 사용자가 지운 파일. 되살리기 전에 물어봐야 한다.
 export function surveyWorkflows(context, payloadRoot, targetRoot = ".") {
-  const { types = [], paths = new Map(), includeNexus = false, repoName = "", resolvers = {}, flutterStore = null } = context;
+  const { types = [], paths = new Map(), repoName = "", resolvers = {}, flutterStore = null } = context;
   const workflowsDir = join(targetRoot, PATHS.workflowsDir);
   const projectTypesDir = join(payloadRoot, PAYLOAD.workflowsDir);
   const deployStyle = context.deployStyle || DEFAULT_DEPLOY_STYLE;
@@ -313,7 +296,7 @@ export function surveyWorkflows(context, payloadRoot, targetRoot = ".") {
       collect(typeDir, envOpts, type, () => false, buildTypeRootFilter(type, deployStyle, flutterStore));
     }
     const serverDeployDir = join(typeDir, "server-deploy");
-    if (exists(serverDeployDir) && !includeNexus && deployStyle !== NO_DEPLOY_STYLE) {
+    if (exists(serverDeployDir) && deployStyle !== NO_DEPLOY_STYLE) {
       collect(serverDeployDir, envOpts, type, () => false, keepDeploy);
     }
   }
@@ -341,7 +324,7 @@ export async function copyWorkflowsInteractive(context, payloadRoot, targetRoot
 }
 
 function copyWorkflowsForType(type, projectTypesDir, workflowsDir, ctx, counters) {
-  const { includeNexus, deployStyle = "", flutterStore = null, envOptsFor, collectAsks = null, dirCtx } = ctx;
+  const { deployStyle = "", flutterStore = null, envOptsFor, collectAsks = null, dirCtx } = ctx;
   const keepDeploy = deployFilter(deployStyle);
   const keepTypeRoot = buildTypeRootFilter(type, deployStyle, flutterStore);
   const { srcText, baselineTargets } = dirCtx;
@@ -361,29 +344,16 @@ function copyWorkflowsForType(type, projectTypesDir, workflowsDir, ctx, counters
 
   // server-deploy
   const serverDeployDir = join(typeDir, "server-deploy");
-  if (exists(serverDeployDir)) {
-    if (includeNexus || deployStyle === NO_DEPLOY_STYLE) {
-      // Nexus 프로젝트 또는 "배포 안 함" → 폴더째 제외 (복사 안 함)
-    } else {
-      const c = processDir(serverDeployDir, workflowsDir, envOpts, dirCtx, counters, keepDeploy);
-      untouched.push(...c.unchanged, ...c.localOnly);
-    }
-  }
-
-  // nexus (opt-in) — 라이브러리 publish 계열(Nexus + GitHub Packages).
-  // 다른 폴더와 같은 processDir을 쓴다. 종전에는 이 경로만 별도 로직으로 "존재하면 무조건
-  // .bak 후 교체"였는데, 그러면 사용자가 손댄 publish 워크플로우가 재실행마다 묻지도 않고
-  // 밀린다. baseline 3-way·충돌 3지선을 다른 워크플로우와 동일하게 적용한다.
-  const nexusDir = join(typeDir, "nexus");
-  if (exists(nexusDir) && includeNexus) {
-    const c = processDir(nexusDir, workflowsDir, envOpts, dirCtx, counters);
+  // "배포 안 함"이면 폴더째 제외 (복사 안 함)
+  if (exists(serverDeployDir) && deployStyle !== NO_DEPLOY_STYLE) {
+    const c = processDir(serverDeployDir, workflowsDir, envOpts, dirCtx, counters, keepDeploy);
     untouched.push(...c.unchanged, ...c.localOnly);
   }
 
   // env 치환 — 이 타입의 원본 디렉토리들에서 복사돼 존재하고, 손대지 않기로 한 것이 아닌 파일만
-  for (const srcDir of [typeDir, serverDeployDir, nexusDir]) {
+  for (const srcDir of [typeDir, serverDeployDir]) {
     if (!exists(srcDir)) continue;
-    if (srcDir === serverDeployDir && (includeNexus || deployStyle === NO_DEPLOY_STYLE)) continue; // 폴더째 제외
+    if (srcDir === serverDeployDir && deployStyle === NO_DEPLOY_STYLE) continue; // 폴더째 제외
     for (const filename of listYamlFiles(srcDir)) {
       const target = join(workflowsDir, filename);
       if (srcDir === serverDeployDir && !keepDeploy(filename)) continue; // 안 고른 배포 방식
@@ -395,18 +365,18 @@ function copyWorkflowsForType(type, projectTypesDir, workflowsDir, ctx, counters
   }
 }
 
-// 전체 워크플로우 분류(common + 타입별 + server-deploy + nexus opt-in) — status/dry-run 공용.
+// 전체 워크플로우 분류(common + 타입별 + server-deploy) — status/dry-run 공용.
 // changed뿐 아니라 newFiles/unchanged까지 전부 반환한다는 점이 listWorkflowConflicts(changed만
 // 반환)와 다르다(읽기 전용 — 실제로 아무 파일도 쓰지 않는다).
 export function planWorkflows(context, payloadRoot, targetRoot = ".") {
-  const { types = [], paths = new Map(), includeNexus = false, includeSecretBackup = false, repoName = "", resolvers = {}, flutterStore = null } = context;
+  const { types = [], paths = new Map(), repoName = "", resolvers = {}, flutterStore = null } = context;
   const workflowsDir = join(targetRoot, PATHS.workflowsDir);
   const projectTypesDir = join(payloadRoot, PAYLOAD.workflowsDir);
   const deployStyle = context.deployStyle || DEFAULT_DEPLOY_STYLE;
   const srcText = makeSrcText(context.branches || null, deployStyle);
   const baseline = readBaseline(targetRoot);
   const branchMode = context.branches?.mode || "pr-flow";
-  // upstreamOnly/localOnly/removed는 baseline이 있을 때만 채워진다 (issue #69).
+  // upstreamOnly/localOnly/removed는 baseline이 있을 때만 채워진다.
   const plan = { newFiles: [], unchanged: [], changed: [], upstreamOnly: [], localOnly: [], removed: [] };
   const BUCKETS = ["newFiles", "unchanged", "changed", "upstreamOnly", "localOnly", "removed"];
 
@@ -426,16 +396,6 @@ export function planWorkflows(context, payloadRoot, targetRoot = ".") {
       branchMode === "trunk-based" ? TRUNK_BASED_EXCLUDED : null);
   }
 
-  // secret-backup은 copyWorkflows처럼 신규 파일만 대상(기존 파일은 절대 덮어쓰지 않는 규약) —
-  // classify()의 changed 판정과 무관하게, 여기서도 존재 여부만으로 new/unchanged를 가른다.
-  const secretDir = join(commonDir, "secret-backup");
-  if (exists(secretDir) && includeSecretBackup) {
-    for (const filename of listYamlFiles(secretDir)) {
-      const dst = join(workflowsDir, filename);
-      plan[existsSync(dst) ? "unchanged" : "newFiles"].push({ filename, type: "common" });
-    }
-  }
-
   for (const type of types) {
     const envOpts = { type, projectPath: paths.get(type) || ".", repoName, resolvers };
     const typeDir = join(projectTypesDir, type);
@@ -444,14 +404,9 @@ export function planWorkflows(context, payloadRoot, targetRoot = ".") {
     }
 
     const serverDeployDir = join(typeDir, "server-deploy");
-    if (exists(serverDeployDir) && !includeNexus && deployStyle !== NO_DEPLOY_STYLE) {
+    if (exists(serverDeployDir) && deployStyle !== NO_DEPLOY_STYLE) {
       merge(classify(serverDeployDir, workflowsDir, envOpts, srcText, baseline, deployFilter(deployStyle)), type);
     }
-
-    const nexusDir = join(typeDir, "nexus");
-    if (exists(nexusDir) && includeNexus) {
-      merge(classify(nexusDir, workflowsDir, envOpts, srcText, baseline), type);
-    }
   }
 
   return plan;

package/src/core/deploy-style.js

@@ -1,4 +1,4 @@
-// 배포 방식 (이슈 #80) — 서버 배포 CD 워크플로우는 서로 대체재다.
+// 배포 방식 — 서버 배포 CD 워크플로우는 서로 대체재다.
 // Nginx 무중단과 Traefik 무중단을 동시에 쓰는 경우는 없으므로 하나만 설치한다.
 // 고른 것은 push 트리거까지 켜서 설치한다 — 설치했는데 안 도는 상태를 만들지 않는다.
 import { join } from "node:path";
@@ -17,7 +17,7 @@ export const DEFAULT_DEPLOY_STYLE = "simple";
 // 서버 배포 자체를 하지 않는 프로젝트(프론트엔드 전용, 라이브러리 등)를 위한 값.
 // DEPLOY_STYLES에는 넣지 않는다 — isDeployWorkflow/suffixOf가 이 배열을 순회하는데, 빈 접미사를
 // 돌려주면 endsWith("")가 항상 참이라 모든 파일이 CD로 오판되어 cleanupOtherDeployWorkflows가
-// 설치된 워크플로우 전체를 지우는 회귀가 생긴다 (이슈 #126).
+// 설치된 워크플로우 전체를 지우는 회귀가 생긴다.
 export const NO_DEPLOY_STYLE = "none";
 
 export const isDeployStyle = (v) => v === NO_DEPLOY_STYLE || DEPLOY_STYLES.some((s) => s.value === v);

package/src/core/detect-fs.js

@@ -1,5 +1,5 @@
 // 실 파일시스템 프로젝트 감지 (.sh detect_* 실행부 등가).
-// SP2-A detect.js 순수 함수를 fs/git으로 구동한다.
+// detect.js 순수 함수를 fs/git으로 구동한다.
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { join, basename } from "node:path";
 import { execFileSync } from "node:child_process";
@@ -27,8 +27,8 @@ export function detectTypes(root) {
   return detectTypesFromMarkers({ has: hasFile(root), read: readFile(root) });
 }
 
-// 버전 감지 — .sh detect_version 순서. jq는 package.json 파싱에 쓰인 적이 없어 게이트를 제거했다(이슈 #22 L4).
-// hint: 폴백 경고에 붙일 해결 방법 안내 (대화형/CLI가 다르다 — 이슈 #80).
+// 버전 감지 — .sh detect_version 순서. jq는 package.json 파싱에 쓰인 적이 없어 게이트를 제거했다.
+// hint: 폴백 경고에 붙일 해결 방법 안내 (대화형/CLI가 다르다).
 export function detectVersion(root, { warn = (m) => console.error(m), hint } = {}) {
   const read = readFile(root);
   const readJson = (rel) => { const c = read(rel); try { return c ? JSON.parse(c) : null; } catch { return null; } };
@@ -36,12 +36,12 @@ export function detectVersion(root, { warn = (m) => console.error(m), hint } = {
   return detectVersionFromFiles({ read, readJson, gitTag, warn, hint });
 }
 
-// 타입별 실제 마커 파일 (이슈 #77) — 감지 로그·설치 로그가 같은 근거 파일을 인용하도록.
+// 타입별 실제 마커 파일 — 감지 로그·설치 로그가 같은 근거 파일을 인용하도록.
 export function detectMarkers(root, types = []) {
   return resolveMarkers(types, hasFile(root));
 }
 
-// 빌드 JDK 감지 (이슈 #82) — 배포 워크플로우 JAVA_VERSION 기본값에 실측값을 쓰기 위해.
+// 빌드 JDK 감지 — 배포 워크플로우 JAVA_VERSION 기본값에 실측값을 쓰기 위해.
 // base: 모노레포에서 spring 프로젝트 루트 (레포 루트 기준 상대경로).
 export function detectJdk(root, base = ".") {
   const rel = base && base !== "." ? (r) => `${base}/${r}` : (r) => r;
@@ -49,7 +49,7 @@ export function detectJdk(root, base = ".") {
   return detectJdkFromFiles({ read: (r) => read(rel(r)) });
 }
 
-// 빌드 번호 감지 — 신규 통합 시 pubspec.yaml/build.gradle/app.json에서 실제 빌드 번호를 읽는다 (이슈 #41).
+// 빌드 번호 감지 — 신규 통합 시 pubspec.yaml/build.gradle/app.json에서 실제 빌드 번호를 읽는다.
 export function detectBuildNumber(root, { types = [], warn = (m) => console.error(m) } = {}) {
   const read = readFile(root);
   const readJson = (rel) => { const c = read(rel); try { return c ? JSON.parse(c) : null; } catch { return null; } };
@@ -80,7 +80,7 @@ export function detectRepoName(root) {
 // find {base} -path "*/src/main/resources/application*.yml" | head -1 의 fs 재귀 구현.
 // 반환: root 기준 상대경로 (예: "server/src/main/resources/application.yml") 또는 "".
 //
-// .yaml도 인정한다 (이슈 #81). Spring은 .yml/.yaml을 모두 공식 지원하는데 종전 정규식이
+// .yaml도 인정한다. Spring은 .yml/.yaml을 모두 공식 지원하는데 종전 정규식이
 // .yml만 봐서, application.yaml을 쓰는 프로젝트는 이 값이 빈 문자열이 되고 그 결과
 // __APPLICATION_YML_DIR__ 가 치환되지 않은 채 설치됐다.
 //
@@ -116,15 +116,15 @@ export function findSpringAppYml(root, base = ".") {
 
 // 실 resolver 세트 생성 (.sh resolve_token 4종 등가) — index/interactive 공용.
 // paths: Map<type, path> (모노레포 경로).
-// flutterOptions: resolveFlutterOptions 결과 또는 같은 필드를 가진 context (이슈 #131). null이면 Flutter 토큰이
+// flutterOptions: resolveFlutterOptions 결과 또는 같은 필드를 가진 context. null이면 Flutter 토큰이
 //   빈 값이라 템플릿 기본값(dart-define, store_only)이 그대로 남는다.
 export function makeResolvers(root, repoName, paths, flutterOptions = null) {
   const springBase = (t) => paths.get(t || "spring") || paths.get("spring") || ".";
   return {
     repo: () => repoName,
-    // 빌드 JDK (이슈 #82) — 배포 워크플로우 JAVA_VERSION의 기본값. 프로젝트 툴체인을 실측한다.
+    // 빌드 JDK — 배포 워크플로우 JAVA_VERSION의 기본값. 프로젝트 툴체인을 실측한다.
     // ⚠️ 빈 문자열을 돌려주면 setEnvLine이 그 줄을 건너뛰어 __JAVA_VERSION__이 그대로 남는다
-    //    (이슈 #81과 같은 실패 형태). 감지 실패 시 반드시 종전 기본값 21로 폴백한다.
+    //    (같은 실패 형태). 감지 실패 시 반드시 종전 기본값 21로 폴백한다.
     jdk: (t) => detectJdk(root, springBase(t)) || "21",
     "spring-app-yml-dir": (t) => {
       const f = findSpringAppYml(root, springBase(t));
@@ -132,7 +132,7 @@ export function makeResolvers(root, repoName, paths, flutterOptions = null) {
     },
     "spring-app-yml-path": (t) => findSpringAppYml(root, springBase(t)) || "",
     "flutter-root": () => paths.get("flutter") || ".",
-    // CI changes job의 경로 필터(이슈 #131) — 타입별 프로젝트 루트. 단일 레포·common은 "."(항상 변경됨으로 판정).
+    // CI changes job의 경로 필터 — 타입별 프로젝트 루트. 단일 레포·common은 "."(항상 변경됨으로 판정).
     "project-path": (t) => paths.get(t) || ".",
     // 빈 문자열이면 setEnvLine/setFallbackLine이 줄을 건너뛰어 템플릿 기본값이 남는다.
     "flutter-env-mode": () => flutterOptions?.envMode || "",

package/src/core/detect.js

@@ -36,9 +36,9 @@ export function detectTypesFromMarkers({ has, read }) {
 const VERSION_RE = /^\d+\.\d+\.\d+$/;
 
 // 버전 감지 (동작명세 §3.3) — 순서대로 첫 성공. read(relpath)=>string|null 주입.
-// package.json은 이미 Node JSON.parse로 파싱을 마친 값이므로 jq 설치 여부와 무관하게 항상 사용한다(이슈 #22 L4).
+// package.json은 이미 Node JSON.parse로 파싱을 마친 값이므로 jq 설치 여부와 무관하게 항상 사용한다.
 // hint: 폴백 경고 뒤에 붙일 "그럼 어떻게 고치나" 한 줄. 대화형과 CLI가 서로 다른 방법을
-// 안내해야 하므로(이슈 #80) 호출부가 정한다. 미지정 시 CLI 문구를 쓴다.
+// 안내해야 하므로 호출부가 정한다. 미지정 시 CLI 문구를 쓴다.
 export function detectVersionFromFiles({ read, readJson, gitTag, warn, hint }) {
   const pkg = readJson?.("package.json");
   if (pkg?.version && VERSION_RE.test(pkg.version)) return pkg.version;
@@ -52,7 +52,7 @@ export function detectVersionFromFiles({ read, readJson, gitTag, warn, hint }) {
   let v;
   const gradleRe = /version\s*=\s*["']?(\d+\.\d+\.\d+)/;
   // Groovy DSL과 Kotlin DSL은 같은 문법(`version = "x.y.z"`)이라 정규식을 공유한다.
-  // .kts를 빼먹으면 Kotlin DSL Spring 프로젝트가 전부 0.0.1로 초기화된다 (이슈 #77).
+  // .kts를 빼먹으면 Kotlin DSL Spring 프로젝트가 전부 0.0.1로 초기화된다.
   if ((v = grab(read("build.gradle"), gradleRe))) return v;
   if ((v = grab(read("build.gradle.kts"), gradleRe))) return v;
   if ((v = versionFromPom(read("pom.xml")))) return v;
@@ -64,7 +64,7 @@ export function detectVersionFromFiles({ read, readJson, gitTag, warn, hint }) {
   return "0.0.1";
 }
 
-// Maven pom.xml의 프로젝트 버전 (이슈 #77). <parent> 블록 안의 버전은 스프링 부트 BOM 버전이라
+// Maven pom.xml의 프로젝트 버전. <parent> 블록 안의 버전은 스프링 부트 BOM 버전이라
 // 프로젝트 버전이 아니다 — 그 구간을 지운 뒤 첫 <version>을 읽는다.
 export function versionFromPom(content) {
   if (!content) return null;
@@ -81,7 +81,7 @@ export function extraMarkers(type) {
   return { python: ["setup.py", "requirements.txt"], spring: ["build.gradle.kts", "pom.xml"] }[type] || [];
 }
 
-// 그 타입을 감지하는 데 실제로 쓰인 파일 (이슈 #77). markerForType은 타입당 대표 파일 하나를
+// 그 타입을 감지하는 데 실제로 쓰인 파일. markerForType은 타입당 대표 파일 하나를
 // 고정 반환하므로, build.gradle.kts만 있는 레포에서도 "build.gradle 발견"이라고 출력돼
 // 같은 설치 로그 안에서 경로 확정 화면과 파일명이 어긋났다. has()로 실재하는 것을 고른다.
 // 실재하는 후보가 없으면(감지 전 화면 등) 대표 파일을 쓴다.
@@ -90,7 +90,7 @@ export function resolveMarker(type, has) {
   return candidates.find(has) ?? candidates[0];
 }
 
-// 빌드 JDK 감지 (이슈 #82) — 배포 워크플로우의 JAVA_VERSION 기본값이 21로 고정돼 있어
+// 빌드 JDK 감지 — 배포 워크플로우의 JAVA_VERSION 기본값이 21로 고정돼 있어
 // toolchain이 다른 프로젝트(예: 25)는 그대로 Enter를 누르면 러너 JDK와 어긋나 빌드가 깨진다.
 // 빌드 번호를 프로젝트 파일에서 읽는 detectBuildNumberFromFiles와 같은 방식으로 실측한다.
 // 반환: "21" 같은 메이저 버전 문자열, 못 찾으면 null.
@@ -129,7 +129,7 @@ export function resolveMarkers(types = [], has) {
   return out;
 }
 
-// 빌드 번호 감지 (이슈 #41) — 신규 통합 시 pubspec.yaml/build.gradle/app.json에 이미 기록된
+// 빌드 번호 감지 — 신규 통합 시 pubspec.yaml/build.gradle/app.json에 이미 기록된
 // 빌드 번호를 읽어 version_code가 항상 1로 초기화되는 걸 막는다. types 배열에서 먼저 매칭되는
 // 첫 타입만 사용한다(다른 감지 로직의 types[0]=primary 관례와 동일). read(rel)=>string|null,
 // readJson(rel)=>object|null 로 주입.

package/src/core/flutter-options.js

@@ -1,4 +1,4 @@
-// Flutter 옵션 (이슈 #131) — 환경변수 방식·스토어 배포 대상·배포 모드의 단일 진실.
+// Flutter 옵션 — 환경변수 방식·스토어 배포 대상·배포 모드의 단일 진실.
 // 스토어 배포 대상은 deploy-style.js(배포 방식)와 같은 구조 — 값 목록, 파일 필터, 선택 해제 정리 — 를 따른다.
 import { join } from "node:path";
 import { existsSync, readFileSync, renameSync, rmSync } from "node:fs";

package/src/core/installed-stores.js

@@ -1,4 +1,4 @@
-// 이미 설치된 스토어 배포 워크플로우 파일명으로 플랫폼을 추론한다 (이슈 #131).
+// 이미 설치된 스토어 배포 워크플로우 파일명으로 플랫폼을 추론한다.
 // version.yml에 flutter_store 저장값이 없는 기존 설치가 대상이다 — 저장값이 없다고 "선택 없음"으로 보면
 // 잘 쓰던 스토어 워크플로우가 선택 해제 정리 규칙에 의해 삭제된다.
 import { existsSync, readdirSync } from "node:fs";

package/src/core/logger.js

@@ -4,7 +4,7 @@
 // 쓰는 구조는 예외가 나면 아무것도 남기지 못한다(구 install-log.js가 그랬다).
 //
 // 왜 로컬 전용인가: 상세도를 제약하지 않기 위해서다. 로그 디렉토리에 .gitignore를 직접
-// 두어 그 폴더만 추적에서 뺀다 — 루트 .gitignore는 건드리지 않는다(이슈 #7 원칙).
+// 두어 그 폴더만 추적에서 뺀다 — 루트 .gitignore는 건드리지 않는다.
 import { appendFileSync, existsSync, mkdirSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 

package/src/core/paths-resolve.js

@@ -166,7 +166,7 @@ export async function resolveProjectPaths({
     const candidates = findTypePathCandidates(root, t);
     let chosen = "";
 
-    // ── ⑤-a 비대화형 (--force 또는 TTY 없음, .sh L1476~1489 — M4: root 폴백 의도적 불포함) ──
+    // ── ⑤-a 비대화형 (--force 또는 TTY 없음, .sh L1476~1489 — root 폴백 의도적 불포함) ──
     if (force || !tty) {
       if (existing) {
         chosen = existing;

package/src/core/removal-plan.js

@@ -4,7 +4,7 @@
 // 원칙: (a) 현재 payload에 존재하는 파일명과 정확히 일치하는 것, (b) 설치된 워크플로우 파일 중
 // 마법사 관리 마커(MANAGED_WORKFLOW_MARKER)로 시작하는 것 — 이 둘의 합집합을 제거 대상으로 삼는다.
 // (a)만으로는 과거 버전에서 설치된 뒤 이후 릴리스에서 payload 파일명이 바뀌거나 삭제된 파일을
-// 인식하지 못했다 (issue #20 L12 원래 버그). 반대로 (b)만으로는 이 수정 이전에 설치되어 마커가
+// 인식하지 못했다 (원래 버그). 반대로 (b)만으로는 이 수정 이전에 설치되어 마커가
 // 없는(그러나 파일명은 여전히 현재 payload와 일치하는) 기존 설치 전체를 인식하지 못하는 회귀가
 // 생긴다 — 그래서 두 방식을 합집합으로 병행한다. 마커는 이 수정 이후 배포되는 payload 템플릿부터
 // 포함되므로, (b) 경로가 실제로 새로 잡아내는 것은 "이름이 바뀌거나 삭제된, 마커가 있는" 파일뿐이다.
@@ -12,7 +12,7 @@
 // (version.yml은 사용자 버전 데이터 — 제거 대상이 아니라 산출물이다).
 //
 // 이 파일은 원래 src/commands/revert.js였다. revert 모드는 uninstall의 부분집합이라 제거됐고
-// (issue #70), 판별 로직만 남아 commands가 아닌 core로 옮겨졌다.
+//, 판별 로직만 남아 commands가 아닌 core로 옮겨졌다.
 import { join } from "node:path";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { PATHS, PAYLOAD } from "./paths.js";
@@ -34,7 +34,7 @@ function payloadWorkflowNames(payloadRoot) {
 
 // 설치된 워크플로우 디렉토리(평면 구조)에서 관리 마커로 시작하는 파일명 집합.
 // .bak/.template.yaml 백업본도 원본 텍스트를 그대로 복사한 것이라 마커를 그대로 갖고 있어
-// 확장자나 파일명 유추 없이 동일한 방식으로 인식된다 (issue #20 L12).
+// 확장자나 파일명 유추 없이 동일한 방식으로 인식된다.
 function markedWorkflowNames(wfDir) {
   const names = new Set();
   if (!existsSync(wfDir)) return names;
@@ -60,7 +60,7 @@ export function planRemoval(payloadRoot, targetRoot = ".") {
       if (existsSync(join(wfDir, templateName))) removedWf.add(templateName);
       if (existsSync(p + ".bak")) removedWf.add(name + ".bak");
     }
-    // (b) 관리 마커로 시작하는 것 — payload에서 이름이 바뀌거나 삭제된 파일도 인식 (issue #20 L12).
+    // (b) 관리 마커로 시작하는 것 — payload에서 이름이 바뀌거나 삭제된 파일도 인식.
     for (const name of markedWorkflowNames(wfDir)) removedWf.add(name);
   }
   for (const s of ["version_manager.py", "changelog_manager.py", "truncate_release_notes.py", "issue_helper.py"]) {

package/src/core/verify.js

@@ -1,4 +1,4 @@
-// 설치 후 검증 (이슈 #81, #80) — 설치된 워크플로우를 다시 읽어 "이대로 돌아가는가"를 본다.
+// 설치 후 검증 — 설치된 워크플로우를 다시 읽어 "이대로 돌아가는가"를 본다.
 //
 // 왜 설치 전이 아니라 후인가: 치환은 파일 단위로 흩어져 일어나고 auto 토큰은 resolver 결과에
 // 의존한다. 최종 디스크 내용을 보는 것이 실제로 배포될 것과 같은 것을 보는 유일한 방법이다.
@@ -15,7 +15,7 @@ const PLACEHOLDER_RE = /__[A-Z][A-Z0-9_]*__/g;
 // 쓰지도 않는 Secret을 "등록하세요"라고 안내하게 된다.
 const isCommented = (line) => /^\s*#/.test(line);
 
-// 미치환 플레이스홀더 스캔 (이슈 #81).
+// 미치환 플레이스홀더 스캔.
 // 종전에는 auto 토큰 계산이 실패해도(예: application.yaml을 못 찾아 경로가 빈 문자열) 그 줄을
 // 건드리지 않고 넘어가, __APPLICATION_YML_DIR__ 이 그대로 남은 워크플로우가 "설치 성공"으로
 // 끝났다. 배포 시점에야 그 이름의 디렉토리가 만들어지며 문제가 드러난다.
@@ -43,12 +43,12 @@ export function scanUnsubstituted(workflowsDir, filenames = []) {
 const AUTO_SECRETS = new Set(["GITHUB_TOKEN"]);
 // 없어도 워크플로우가 도는 secret — 폴백이 문서화돼 있다. 필수와 섞어 "등록해야 동작합니다"라고
 // 하면 안내 자체를 못 믿게 되므로 분리한다.
-//   AI_API_KEY   → 없으면 GitHub Models(무료) → 규칙 fallback
+//   AI_API_KEY   → 없으면 Copilot(opt-in, copilot_ai) → 규칙 fallback
 //   WORKFLOW_PAT → 없으면 GITHUB_TOKEN
 export const OPTIONAL_SECRETS = new Set(["AI_API_KEY", "WORKFLOW_PAT"]);
 const SECRET_RE = /secrets\.([A-Z][A-Z0-9_]*)/g;
 
-// 설치된 워크플로우가 요구하는 GitHub Secret 목록 (이슈 #80).
+// 설치된 워크플로우가 요구하는 GitHub Secret 목록.
 // 완료 화면이 WORKFLOW_PAT와 권한만 안내하는 바람에, 배포 워크플로우가 실제로 필요로 하는
 // SERVER_HOST·SSH_KEY 같은 값이 하나도 안내되지 않았다. 설치 직후 상태로는 배포가 돌지 않는데
 // 그 사실이 어디에도 드러나지 않는다.