project-auto-wizard 0.1.9 → 0.1.10

package/README.md

@@ -16,7 +16,7 @@ npx project-auto-wizard
 [![node](https://img.shields.io/badge/node-%3E%3D20.12-brightgreen)](package.json)
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## 최신 버전 : v0.1.9 (2026-08-02)
+## 최신 버전 : v0.1.10 (2026-08-02)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-auto-wizard",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "One command DevOps: npx wizard that installs GitHub-native AI Release Automation into any project",
   "license": "MIT",
   "type": "module",

package/src/commands/full.js

@@ -1,5 +1,6 @@
 // full 모드 오케스트레이터 (.sh execute_integration full case 등가).
-// 복사 순서: workflows(+env 치환) → version.yml → readme → scripts → coderabbit → gitignore
+// 복사 순서: workflows(+env 치환) → version.yml → readme → scripts → coderabbit → gitignore(조건부)
+// gitignore는 충돌 백업 부산물(.bak/.template.yaml)이 이번 실행에서 실제로 생겼을 때만 갱신한다 — issue #7.
 // (원본의 util/issue/discussion/setup-guide/config 설치는 project-auto-wizard 스코프에서 제외 — DESIGN-SPEC §2)
 import { join } from "node:path";
 import { writeText } from "../core/fsutil.js";
@@ -46,9 +47,13 @@ export function runFull(context, payloadRoot, targetRoot = ".", hooks = {}) {
   // 4. scripts (payload/scripts/*.py → .github/scripts/)
   copyScripts(payloadRoot, targetRoot);
 
-  // 5. coderabbit (opt-in true일 때만 — DESIGN-SPEC §4 질문②) / gitignore
-  if (includeCodeRabbit === true) copyCoderabbit(payloadRoot, { force }, targetRoot);
-  ensureGitignore(targetRoot);
+  // 5. coderabbit (opt-in true일 때만 — DESIGN-SPEC §4 질문②)
+  const coderabbitResult = includeCodeRabbit === true ? copyCoderabbit(payloadRoot, { force }, targetRoot) : null;
 
-  return { workflows: wfCounters };
+  // 6. gitignore — 워크플로우/coderabbit 충돌 처리가 .bak나 .template.yaml을 실제로 만든 경우에만 갱신한다.
+  //    충돌 없는 설치(대부분의 최초 설치)는 .gitignore를 전혀 건드리지 않는다 — issue #7.
+  const gitignoreUpdated = wfCounters.backupAdded > 0 || wfCounters.templateAdded > 0 || coderabbitResult === "overwritten-backup";
+  if (gitignoreUpdated) ensureGitignore(targetRoot);
+
+  return { workflows: wfCounters, gitignoreUpdated };
 }

package/src/commands/interactive.js

@@ -249,6 +249,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), payloadRoot
   io.summary?.({
     mode, types, version, branches, includeCodeRabbit,
     counters: { workflows: result?.workflows?.copied ?? 0 },
+    gitignoreUpdated: result?.gitignoreUpdated === true,
   }, cwd);
   io.outro?.(`통합 완료 — ${mode} 모드로 설치했습니다.`);
   return 0;

package/src/commands/purge.js

@@ -80,7 +80,7 @@ export function printPurgeResult(result) {
   if (result.versionYml) lines.push("파일: version.yml");
   if (result.readmeSection) lines.push("README.md: AUTO-VERSION-SECTION 블록");
   for (const f of result.changelog) lines.push(`파일: ${f}`);
-  lines.push("(.gitignore 자동 추가 블록은 보존됩니다 — 별도 이슈에서 다룸)");
+  lines.push("(.gitignore에 추가된 백업 파일 제외 항목(*.bak/*.template.yaml)은 purge 대상에서 제외되어 그대로 보존됩니다)");
   lines.push("");
   console.log(lines.join("\n"));
 }

package/src/commands/version.js

@@ -1,6 +1,7 @@
 // version 모드 (.sh execute_integration version case 등가).
-// 순서: version.yml → readme → scripts → gitignore.
-// (워크플로우 미복사 → deploy 블록 없음. util·issue·coderabbit·setup-guide는 스코프 제외.)
+// 순서: version.yml → readme → scripts.
+// (워크플로우/coderabbit을 복사하지 않으므로 충돌 백업 부산물이 생길 수 없다 — gitignore 갱신 대상 없음, issue #7.
+//  util·issue·coderabbit·setup-guide는 스코프 제외.)
 import { join } from "node:path";
 import { writeText } from "../core/fsutil.js";
 import { PATHS } from "../core/paths.js";
@@ -9,7 +10,6 @@ import { readVersionYmlTemplate } from "../core/assets.js";
 import { markerForType } from "../core/detect.js";
 import { addVersionSectionToReadme } from "../core/copy/readme.js";
 import { copyScripts } from "../core/copy/simple.js";
-import { ensureGitignore } from "../core/copy/gitignore.js";
 
 export function runVersion(context, payloadRoot, targetRoot = ".") {
   const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
@@ -28,5 +28,4 @@ export function runVersion(context, payloadRoot, targetRoot = ".") {
     }));
   addVersionSectionToReadme(version, targetRoot);
   copyScripts(payloadRoot, targetRoot);
-  ensureGitignore(targetRoot);
 }

package/src/core/copy/gitignore.js

@@ -1,8 +1,17 @@
-// .gitignore 보장 (.sh ensure_gitignore + normalize/check 등가) — template_integrator.sh 3996~4111.
+// .gitignore 보장 — 마법사 자신이 만드는 충돌 백업 부산물(*.bak, *.template.yaml)만 대상으로 한다.
+// 마법사가 설치하는 것과 무관한 개인 개발환경 설정(IDE 등)은 마법사 책임 범위 밖 — issue #7.
+// 주의(의도된 트레이드오프): 이 변경 이전 버전으로 설치해 /.idea·/.claude/settings.local.json이 이미
+// 배너 블록에 남아있는 레포에서 removeAutoAddedEntriesFromGitignore()를 실행하면, 배너는 제거되지만
+// REQUIRED_ENTRIES가 더 이상 옛 항목과 일치하지 않아 그 두 줄은 지워지지 않고 배너 표시 없이 남는다.
+// 이슈 #7이 "이미 설치된 레포의 .gitignore는 소급 처리하지 않고 사용자 판단에 맡긴다"고 명시하므로
+// 별도 마이그레이션 로직을 추가하지 않는다 — 남은 항목은 무해하며 필요하면 사용자가 직접 지운다.
 import { join } from "node:path";
 import { existsSync, readFileSync, writeFileSync, rmSync } from "node:fs";
 
-const REQUIRED_ENTRIES = ["/.idea", "/.claude/settings.local.json"];
+// issue #7: 마법사가 설치하는 것과 무관한 개인 개발환경 항목(/.idea 등)은 마법사 책임 밖이므로 제거.
+// 대신 마법사 자신의 충돌 처리(workflows.js backup/template 결정, coderabbit.js 덮어쓰기 백업)가
+// 실제로 만들어내는 부산물만 gitignore 대상으로 삼는다.
+const REQUIRED_ENTRIES = ["*.bak", "*.template.yaml"];
 
 // .sh normalize_gitignore_entry: 주석 제거·트림·앞 / 제거·앞 ./ 제거·뒤 / 제거. 빈값이면 원본.
 export function normalizeGitignoreEntry(entry) {
@@ -26,11 +35,9 @@ function entryExists(target, content) {
 }
 
 const NEW_FILE_CONTENT =
-  "# IDE Settings\n" +
-  "/.idea\n" +
-  "\n" +
-  "# Claude AI Settings\n" +
-  "/.claude/settings.local.json\n";
+  "# project-auto-wizard: 충돌 처리 시 생성되는 백업 파일 (안전하게 무시해도 됩니다)\n" +
+  "*.bak\n" +
+  "*.template.yaml\n";
 
 // 반환: {created, added:[...]}
 export function ensureGitignore(targetRoot = ".") {

package/src/core/copy/workflows.js

@@ -58,7 +58,7 @@ function classify(srcDir, workflowsDir, envOpts, srcText) {
 //            envValues?:Map<key,value>, envUseDefaults?:boolean }  ← env 계획(promptEnvPlan) 결과 주입점
 // hooks: { decisions?: Map<filename, 'skip'|'backup'|'template'> } — 기존 파일(changed) 충돌 결정.
 //        미지정 파일은 'skip'(현행 force 동작 100% 유지). 대화형 수집은 copyWorkflowsInteractive 참조.
-// 반환: {copied, skipped, templateAdded, optionalCopied}
+// 반환: {copied, skipped, templateAdded, optionalCopied, backupAdded}
 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 decisions = hooks.decisions instanceof Map ? hooks.decisions : new Map();
@@ -66,7 +66,7 @@ export function copyWorkflows(context, payloadRoot, targetRoot = ".", hooks = {}
   const projectTypesDir = join(payloadRoot, PAYLOAD.workflowsDir);
   if (!exists(projectTypesDir)) throw new Error("패키지 구조 오류 — payload/workflows 폴더를 찾지 못했습니다.");
 
-  const counters = { copied: 0, skipped: 0, templateAdded: 0, optionalCopied: 0 };
+  const counters = { copied: 0, skipped: 0, templateAdded: 0, optionalCopied: 0, backupAdded: 0 };
   const deployValues = new Map(); // Map<type, Map<key,value>> — deploy 블록용 ask 값
   counters.deployValues = deployValues;
   const srcText = makeSrcText(context.branches || null);
@@ -124,6 +124,7 @@ function applyDecision(decision, srcDir, workflowsDir, filename, counters, srcTe
     renameSync(dst, dst + ".bak");
     writeText(dst, srcText(src));
     counters.copied++;
+    counters.backupAdded++;
     return;
   }
   if (decision === "template") {
@@ -213,7 +214,7 @@ function copyWorkflowsForType(type, projectTypesDir, workflowsDir, ctx, counters
         counters.skipped++;
         continue;
       }
-      if (existsSync(dst)) renameSync(dst, dst + ".bak");
+      if (existsSync(dst)) { renameSync(dst, dst + ".bak"); counters.backupAdded++; }
       writeText(dst, body);
       counters.optionalCopied++;
       counters.copied++;

package/src/index.js

@@ -311,6 +311,7 @@ export async function run(argv, {
     mode: opts.mode, types, version, branches,
     includeCodeRabbit: context.includeCodeRabbit === true,
     counters: { workflows: result?.workflows?.copied ?? 0 },
+    gitignoreUpdated: result?.gitignoreUpdated === true,
   }, cwd);
   return 0;
 }

package/src/ui/summary.js

@@ -8,7 +8,7 @@ import { listYamlFiles } from "../core/fsutil.js";
 const SEPARATOR = "────────────────────────────────────────";
 
 export function printSummary(ctx, targetRoot = ".") {
-  const { mode, types = [], version = "", counters = {}, branches = null, includeCodeRabbit = false } = ctx || {};
+  const { mode, types = [], version = "", counters = {}, branches = null, includeCodeRabbit = false, gitignoreUpdated = false } = ctx || {};
   const err = (s = "") => process.stderr.write(`${s}\n`);
   // 색상은 TTY일 때만 (.sh YELLOW/CYAN/NC 등가)
   const isTty = !!process.stderr.isTTY;
@@ -32,12 +32,11 @@ export function printSummary(ctx, targetRoot = ".") {
       err("  ✅ 버전 관리 시스템 (version.yml)");
       err("  ✅ README.md 자동 버전 업데이트");
       err("  ✅ GitHub Actions 워크플로우 (AI 릴리스 자동화 포함)");
-      err("  ✅ .gitignore 필수 항목");
+      if (gitignoreUpdated) err("  ✅ .gitignore 백업 파일 제외 항목 (*.bak/*.template.yaml)");
       break;
     case "version":
       err("  ✅ 버전 관리 시스템 (version.yml)");
       err("  ✅ README.md 자동 버전 업데이트");
-      err("  ✅ .gitignore 필수 항목");
       break;
     case "workflows":
       err("  ✅ GitHub Actions 워크플로우 (AI 릴리스 자동화 포함)");