projectops 3.0.193 → 3.0.194

package/README.md

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

package/bin/projectops.js

@@ -1,9 +1,8 @@
 #!/usr/bin/env node
-// projectops 스텁 CLI — 이름 선점 및 배포 파이프라인 검증용 (SP1)
-// 마법사 본체(SP2)가 이식되기 전까지 기존 template_integrator 안내를 제공한다.
-import { readFileSync } from "node:fs";
+// projectops CLI 엔트리 — argv를 src/index.js의 run()에 넘긴다.
 import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
+import { pathToFileURL } from "node:url";
 
 const nodeMajor = Number(process.versions.node.split(".")[0]);
 if (nodeMajor < 18) {
@@ -11,35 +10,9 @@ if (nodeMajor < 18) {
   process.exit(1);
 }
 
-const pkg = JSON.parse(
-  readFileSync(join(dirname(fileURLToPath(import.meta.url)), "..", "package.json"), "utf8"),
-);
+const here = dirname(fileURLToPath(import.meta.url));
+const indexPath = join(here, "..", "src", "index.js");
+const { run } = await import(pathToFileURL(indexPath).href);
 
-const args = process.argv.slice(2);
-if (args.includes("--version") || args.includes("-v")) {
-  console.log(pkg.version);
-  process.exit(0);
-}
-
-const RESET = "\x1b[0m";
-const CYAN = "\x1b[36m";
-const GREEN = "\x1b[32m";
-const YELLOW = "\x1b[33m";
-const DIM = "\x1b[2m";
-
-console.log(`
-${CYAN}=========================================================
-  ProjectOps v${pkg.version}
-  완전 자동화 GitHub 프로젝트 관리 템플릿 통합 CLI
-=========================================================${RESET}
-
-${YELLOW}npx 마법사는 준비 중입니다.${RESET} 지금은 아래 기존 방식으로 통합하세요.
-
-${GREEN}macOS / Linux:${RESET}
-  bash <(curl -fsSL "https://raw.githubusercontent.com/Cassiiopeia/projectops/main/template_integrator.sh")
-
-${GREEN}Windows (PowerShell):${RESET}
-  $wc=New-Object Net.WebClient;$wc.Encoding=[Text.Encoding]::UTF8;iex $wc.DownloadString("https://raw.githubusercontent.com/Cassiiopeia/projectops/main/template_integrator.ps1")
-
-${DIM}문서: https://github.com/Cassiiopeia/projectops${RESET}
-`);
+const code = await run(process.argv.slice(2), { cwd: process.cwd() });
+process.exit(code);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "3.0.193",
+  "version": "3.0.194",
   "description": "ProjectOps — 완전 자동화 GitHub 프로젝트 관리 템플릿 통합 CLI (구 SUH-DEVOPS-TEMPLATE 마법사)",
   "keywords": [
     "devops",
@@ -31,11 +31,16 @@
     "node": ">=18"
   },
   "files": [
-    "bin/"
+    "bin/",
+    "src/"
   ],
   "pi": {
     "skills": [
       "./skills"
     ]
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.7.0",
+    "picocolors": "^1.1.1"
   }
 }

package/src/cli/args.js

@@ -0,0 +1,84 @@
+// CLI 인자 파싱 (.sh top-level while-case 등가) — template_integrator.sh 842~920.
+import { VALID_TYPES } from "../context.js";
+
+// argv(process.argv.slice(2)) → 파싱 결과. 오류 시 throw(호출부에서 exit 1).
+export function parseArgs(argv) {
+  const result = {
+    mode: "interactive",
+    version: "",
+    types: [],
+    primaryType: "",
+    includeNexus: null,      // null=미설정
+    includeSecretBackup: null,
+    pathsCsv: "",            // "flutter=app,react=client" 원문 (정규화는 resolve 단계)
+    force: false,
+    help: false,
+  };
+  const args = [...argv];
+  while (args.length > 0) {
+    const a = args.shift();
+    switch (a) {
+      case "-m": case "--mode":
+        result.mode = args.shift() ?? ""; break;
+      case "-v": case "--version":
+        result.version = args.shift() ?? ""; break;
+      case "-t": case "--type": {
+        const csv = args.shift() ?? "";
+        const seen = new Set();
+        const types = [];
+        for (let t of csv.split(",")) {
+          t = t.replace(/\s/g, "");
+          if (t === "") continue;
+          if (seen.has(t)) continue;         // dedup
+          if (!VALID_TYPES.includes(t)) {
+            throw new CliError(`지원하지 않는 타입: '${t}'\n지원 타입: ${VALID_TYPES.join(" ")}`);
+          }
+          seen.add(t);
+          types.push(t);
+        }
+        if (types.length === 0) throw new CliError("--type 인자가 비어 있습니다");
+        result.types = types;
+        result.primaryType = types[0];
+        break;
+      }
+      case "--force": result.force = true; break;
+      case "--nexus": result.includeNexus = true; break;
+      case "--no-nexus": result.includeNexus = false; break;
+      case "--secret-backup": result.includeSecretBackup = true; break;
+      case "--no-secret-backup": result.includeSecretBackup = false; break;
+      case "--paths": result.pathsCsv = args.shift() ?? ""; break;
+      case "-h": case "--help": result.help = true; break;
+      default:
+        throw new CliError(`알 수 없는 옵션: ${a}`);
+    }
+  }
+  return result;
+}
+
+export class CliError extends Error {}
+
+// 경로 정규화 (.sh resolve_project_paths §3.4): 앞뒤 공백·\→/·끝 /·앞 ./ 제거, 빈값→"."
+export function normalizePath(p) {
+  let s = String(p).trim();
+  s = s.replace(/\\/g, "/");
+  s = s.replace(/\/+$/, "");   // 끝 /
+  s = s.replace(/^\.\//, "");  // 앞 ./
+  return s === "" ? "." : s;
+}
+
+// "flutter=app,react=client" → Map<type, normalizedPath>. 타입 검증(무효 → throw).
+export function parsePathsCsv(csv) {
+  const map = new Map();
+  if (!csv) return map;
+  for (const pair of csv.split(",")) {
+    if (pair.trim() === "") continue;
+    const eq = pair.indexOf("=");
+    const type = (eq >= 0 ? pair.slice(0, eq) : pair).trim();
+    const rawPath = eq >= 0 ? pair.slice(eq + 1) : "";
+    if (!VALID_TYPES.includes(type)) {
+      throw new CliError(`--paths에 지원하지 않는 타입: '${type}'`);
+    }
+    map.set(type, normalizePath(rawPath));
+  }
+  return map;
+}

package/src/cli/help.js

@@ -0,0 +1,23 @@
+// --help 텍스트 (.sh show_help 요약 이식).
+export const HELP_TEXT = `projectops — GitHub 프로젝트 자동화 템플릿 통합 CLI
+
+사용법:
+  npx projectops [옵션]
+
+옵션:
+  -m, --mode MODE          통합 모드 (full | version | workflows | issues | skills)
+                           기본: interactive (대화형)
+  -t, --type CSV           프로젝트 타입 csv (예: spring,react,python)
+                           지원: spring flutter next react react-native
+                                 react-native-expo node python basic
+  -v, --version VERSION    초기 버전 (예: 1.0.0). 미지정 시 자동 감지
+      --paths "t=p,..."    타입별 프로젝트 경로 (모노레포). 예: flutter=app,react=client
+      --nexus / --no-nexus            Nexus 라이브러리 publish 워크플로우 포함/제외
+      --secret-backup / --no-secret-backup   Secret 백업 워크플로우 포함/제외
+      --force              모든 확인 생략, 비대화형 기본값 사용
+  -h, --help               이 도움말 표시
+
+예시:
+  npx projectops --mode full --force --type spring,react
+  npx projectops --mode workflows --type flutter --paths "flutter=app"
+`;

package/src/commands/full.js

@@ -0,0 +1,64 @@
+// full 모드 오케스트레이터 (.sh execute_integration full case 등가) — template_integrator.sh 4502~4514.
+// 복사 순서: version.yml → readme → workflows → (deploy블록) → scripts → config →
+//            util(타입별) → issue → discussion → coderabbit → gitignore → setup_guide → (옵션저장)
+import { join } from "node:path";
+import { writeText } from "../core/fsutil.js";
+import { PATHS } from "../core/paths.js";
+import { buildVersionYml } from "../core/version-yml.js";
+import { markerForType } from "../core/detect.js";
+import { addVersionSectionToReadme } from "../core/copy/readme.js";
+import { copyWorkflows } from "../core/copy/workflows.js";
+import {
+  copyScripts, copyConfigFolder, copyIssueTemplates,
+  copyDiscussionTemplates, copySetupGuide,
+} from "../core/copy/simple.js";
+import { copyUtilModules } from "../core/copy/util.js";
+import { copyCoderabbit } from "../core/copy/coderabbit.js";
+import { ensureGitignore } from "../core/copy/gitignore.js";
+
+// context: { version, types, paths:Map, branch, versionCode, includeNexus, includeSecretBackup,
+//            force, repoName, resolvers, now, today }
+// tempDir: 획득된 템플릿. targetRoot: 통합 대상.
+export function runFull(context, tempDir, targetRoot = ".") {
+  const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
+    force = true, now, today, templateVersion = "unknown",
+    includeNexus = false, includeSecretBackup = false } = context;
+
+  // project_paths 마커 계산 (.sh existing_marker_in_dir 등가 — 대표 마커명)
+  const pathMarkers = new Map();
+  for (const [t] of paths) pathMarkers.set(t, markerForType(t));
+
+  // 3. 워크플로우 복사 (+ env 치환) — deploy 블록에 쓸 ask 값을 수집한다.
+  //    (.sh는 copy_workflows 후 update_version_yml_deploy로 deploy 블록을 붙인다.)
+  const wfCounters = copyWorkflows(context, tempDir, targetRoot);
+  const deployValues = wfCounters.deployValues || new Map(); // Map<type, Map<key,value>>
+
+  // 1. version.yml 생성 (전체 재생성 — metadata → deploy → template 순, .sh 최종형과 동일)
+  writeText(join(targetRoot, PATHS.versionFile),
+    buildVersionYml({
+      version, types, paths, pathMarkers, branch, versionCode, now, today,
+      deployValues,
+      templateOptions: { templateVersion, includeNexus, includeSecretBackup, optionsDate: today },
+    }));
+
+  // 2. README 버전 섹션
+  addVersionSectionToReadme(version, targetRoot);
+
+  // 5. scripts / config
+  copyScripts(tempDir, targetRoot);
+  copyConfigFolder(tempDir, targetRoot);
+
+  // 6. util (타입별)
+  for (const t of types) copyUtilModules(tempDir, t, { force }, targetRoot);
+
+  // 7. issue / discussion 템플릿
+  copyIssueTemplates(tempDir, targetRoot);
+  copyDiscussionTemplates(tempDir, targetRoot);
+
+  // 8. coderabbit / gitignore / setup guide
+  copyCoderabbit(tempDir, { force }, targetRoot);
+  ensureGitignore(targetRoot);
+  copySetupGuide(tempDir, targetRoot);
+
+  return { workflows: wfCounters };
+}

package/src/commands/interactive.js

@@ -0,0 +1,132 @@
+// 대화형 마법사 (.sh interactive_mode 등가) — template_integrator.sh 4262~4411.
+// io 주입으로 테스트 가능. 실제 실행은 src/ui/prompts.js 함수를 io로 넘긴다.
+import { join } from "node:path";
+import { PATHS } from "../core/paths.js";
+import { remove } from "../core/fsutil.js";
+import { acquireTemplate, readTemplateVersion } from "../core/assets.js";
+import { detectTypes, detectVersion, detectDefaultBranch, detectRepoName } from "../core/detect-fs.js";
+import { createContext, VALID_TYPES } from "../context.js";
+import { runFull } from "./full.js";
+import { runVersion } from "./version.js";
+import { runWorkflows } from "./workflows.js";
+import { runIssues } from "./issues.js";
+import * as prompts from "../ui/prompts.js";
+
+const CANCEL = prompts.CANCEL;
+
+// io 기본값 = 실제 prompts. 테스트는 스텁 io 주입.
+export async function runInteractive(baseCtx, { cwd = process.cwd(), source = { type: "git" }, clock, io = prompts } = {}) {
+  io.intro?.("projectops — 대화형 통합 마법사");
+
+  // 1) 모드 선택
+  const mode = await io.selectMode();
+  if (mode === CANCEL || mode == null) { io.cancelMessage?.("설치를 취소했습니다."); return 0; }
+
+  // skills는 SP2-D 예정
+  if (mode === "skills") {
+    io.note?.("AI 스킬 설치는 아직 준비 중입니다 (곧 제공). 기존 template_integrator를 사용하세요.", "안내");
+    return 1;
+  }
+
+  const tempDir = join(cwd, PATHS.tempDir);
+  try {
+    acquireTemplate({ tempDir, source });
+    const templateVersion = readTemplateVersion(tempDir);
+
+    // issues 모드는 정보 수집 없이 바로 실행
+    if (mode === "issues") {
+      const ctx = createContext({ ...baseCtx, mode, force: true });
+      runIssues(ctx, tempDir, cwd);
+      io.outro?.("이슈·PR 템플릿을 설치했습니다.");
+      return 0;
+    }
+
+    // full/version/workflows — 감지
+    let types = detectTypes(cwd);
+    let version = detectVersion(cwd);
+    let branch = detectDefaultBranch(cwd);
+    const repoName = detectRepoName(cwd);
+    let includeNexus = false, includeSecretBackup = false;
+    const showOptional = mode === "full" || mode === "workflows";
+
+    // 확인/수정 루프
+    let confirmed = false;
+    while (!confirmed) {
+      io.note?.(summarize({ mode, types, version, branch, includeNexus, includeSecretBackup, showOptional }), "프로젝트 분석 결과");
+      const choice = await io.confirmProjectMenu();
+      if (choice === CANCEL || choice === "cancel") { io.cancelMessage?.("설치를 취소했습니다."); return 0; }
+      if (choice === "continue") { confirmed = true; break; }
+      // edit 루프
+      let editing = true;
+      while (editing) {
+        const what = await io.editMenu({ showOptional });
+        if (what === CANCEL || what === "done") { editing = false; break; }
+        if (what === "type") {
+          const t = await io.selectTypes(types);
+          if (t !== CANCEL && Array.isArray(t) && t.length) types = t;
+        } else if (what === "version") {
+          const v = await io.askText("새 버전 (예: 1.0.0)", version);
+          if (v !== CANCEL) version = v;
+        } else if (what === "branch") {
+          const b = await io.askText("기본 브랜치", branch);
+          if (b !== CANCEL) branch = b;
+        } else if (what === "nexus") {
+          const y = await io.askYesNo("Nexus publish 워크플로우를 포함할까요?", includeNexus);
+          if (y !== CANCEL) includeNexus = y;
+        } else if (what === "secret") {
+          const y = await io.askYesNo("Secret 백업 워크플로우를 포함할까요?", includeSecretBackup);
+          if (y !== CANCEL) includeSecretBackup = y;
+        }
+      }
+    }
+
+    // 경로: 미지정 타입은 루트(basic 제외)
+    const paths = new Map();
+    for (const t of types) if (t !== "basic") paths.set(t, ".");
+
+    const { now, today } = clock || utcNow();
+    const ctx = createContext({
+      mode, force: true, types, version, branch, paths, includeNexus, includeSecretBackup, repoName, templateVersion,
+      resolvers: {
+        repo: () => repoName, "spring-app-yml-dir": () => "", "spring-app-yml-path": () => "",
+        "flutter-root": () => paths.get("flutter") || ".",
+      },
+      now, today,
+    });
+    ctx.templateVersion = templateVersion;
+
+    if (mode === "full") runFull(ctx, tempDir, cwd);
+    else if (mode === "version") runVersion(ctx, tempDir, cwd);
+    else if (mode === "workflows") runWorkflows(ctx, tempDir, cwd);
+
+    io.outro?.(`통합 완료 — ${mode} 모드로 설치했습니다.`);
+    return 0;
+  } finally {
+    remove(tempDir);
+  }
+}
+
+function summarize({ mode, types, version, branch, includeNexus, includeSecretBackup, showOptional }) {
+  const lines = [
+    `통합 모드 : ${modeLabel(mode)}`,
+    `프로젝트 타입 : ${types.join(", ")}${types.length > 1 ? " (멀티)" : ""}`,
+    `버전 : ${version}`,
+    `기본 브랜치 : ${branch}`,
+  ];
+  if (showOptional) {
+    lines.push(`Nexus publish : ${includeNexus ? "포함" : "제외"}`);
+    lines.push(`Secret 백업 : ${includeSecretBackup ? "포함" : "제외"}`);
+  }
+  return lines.join("\n");
+}
+
+function modeLabel(m) {
+  return { full: "전체 설치", version: "버전 관리만", workflows: "워크플로우만", issues: "이슈·PR 템플릿만", skills: "AI 스킬만" }[m] || m;
+}
+
+function utcNow(date = new Date()) {
+  const p = (n) => String(n).padStart(2, "0");
+  const d = `${date.getUTCFullYear()}-${p(date.getUTCMonth() + 1)}-${p(date.getUTCDate())}`;
+  const t = `${p(date.getUTCHours())}:${p(date.getUTCMinutes())}:${p(date.getUTCSeconds())}`;
+  return { now: `${d} ${t}`, today: d };
+}

package/src/commands/issues.js

@@ -0,0 +1,8 @@
+// issues 모드 (.sh execute_integration issues case 등가) — template_integrator.sh 4532~4535.
+// 이슈/PR 템플릿 + Discussion 템플릿만 복사.
+import { copyIssueTemplates, copyDiscussionTemplates } from "../core/copy/simple.js";
+
+export function runIssues(context, tempDir, targetRoot = ".") {
+  copyIssueTemplates(tempDir, targetRoot);
+  copyDiscussionTemplates(tempDir, targetRoot);
+}

package/src/commands/version.js

@@ -0,0 +1,30 @@
+// version 모드 (.sh execute_integration version case 등가) — template_integrator.sh 4517~4530.
+// 순서: version.yml → readme → scripts → config → gitignore → setup_guide.
+// (워크플로우 미복사 → deploy 블록 없음. util·issue·coderabbit도 없음.)
+import { join } from "node:path";
+import { writeText } from "../core/fsutil.js";
+import { PATHS } from "../core/paths.js";
+import { buildVersionYml } from "../core/version-yml.js";
+import { markerForType } from "../core/detect.js";
+import { addVersionSectionToReadme } from "../core/copy/readme.js";
+import { copyScripts, copyConfigFolder, copySetupGuide } from "../core/copy/simple.js";
+import { ensureGitignore } from "../core/copy/gitignore.js";
+
+export function runVersion(context, tempDir, targetRoot = ".") {
+  const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
+    now, today, templateVersion = "unknown", includeNexus = false, includeSecretBackup = false } = context;
+
+  const pathMarkers = new Map();
+  for (const [t] of paths) pathMarkers.set(t, markerForType(t));
+
+  writeText(join(targetRoot, PATHS.versionFile),
+    buildVersionYml({
+      version, types, paths, pathMarkers, branch, versionCode, now, today,
+      templateOptions: { templateVersion, includeNexus, includeSecretBackup, optionsDate: today },
+    }));
+  addVersionSectionToReadme(version, targetRoot);
+  copyScripts(tempDir, targetRoot);
+  copyConfigFolder(tempDir, targetRoot);
+  ensureGitignore(targetRoot);
+  copySetupGuide(tempDir, targetRoot);
+}

package/src/commands/workflows.js

@@ -0,0 +1,53 @@
+// workflows 모드 (.sh execute_integration workflows case 등가) — template_integrator.sh 4523~4531.
+// 순서: copy_workflows → update_version_yml_deploy(version.yml 있을 때만) → scripts → config → util(타입별) → setup_guide.
+// (version.yml 생성 안 함 — 기존 version.yml이 있을 때만 deploy 블록 추가.)
+import { join } from "node:path";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { PATHS } from "../core/paths.js";
+import { copyWorkflows } from "../core/copy/workflows.js";
+import { copyScripts, copyConfigFolder, copySetupGuide } from "../core/copy/simple.js";
+import { copyUtilModules } from "../core/copy/util.js";
+
+export function runWorkflows(context, tempDir, targetRoot = ".") {
+  const { types = [], force = true } = context;
+  const wf = copyWorkflows(context, tempDir, targetRoot);
+
+  // update_version_yml_deploy: 기존 version.yml이 있고 ask 값이 있을 때만 deploy 블록 갱신
+  const vy = join(targetRoot, PATHS.versionFile);
+  if (existsSync(vy) && wf.deployValues && wf.deployValues.size) {
+    writeFileSync(vy, upsertDeployBlock(readFileSync(vy, "utf8"), wf.deployValues));
+  }
+
+  copyScripts(tempDir, targetRoot);
+  copyConfigFolder(tempDir, targetRoot);
+  for (const t of types) copyUtilModules(tempDir, t, { force }, targetRoot);
+  copySetupGuide(tempDir, targetRoot);
+  return { workflows: wf };
+}
+
+// 기존 version.yml에서 deploy: 블록을 제거하고 새로 append (.sh update_version_yml_deploy 멱등).
+export function upsertDeployBlock(content, deployValues) {
+  // 기존 deploy: 블록 제거 (deploy: 라인 ~ 다음 최상위 키 전까지)
+  const lines = content.split(/\r?\n/);
+  const out = [];
+  let inDeploy = false;
+  for (const line of lines) {
+    if (/^deploy:/.test(line)) { inDeploy = true; continue; }
+    if (inDeploy) {
+      if (/^\s/.test(line) || line === "") continue; // 들여쓰기/빈줄 = deploy 내부
+      inDeploy = false;
+    }
+    out.push(line);
+  }
+  let text = out.join("\n").replace(/\n+$/, "\n");
+  // 새 deploy 블록 append
+  const deployTypes = [...deployValues.keys()].filter((t) => deployValues.get(t)?.size);
+  if (deployTypes.length) {
+    text += `\ndeploy:                          # 마법사가 기억하는 배포 설정 (비민감 / 직접 수정 가능)\n`;
+    for (const t of deployTypes) {
+      text += `  ${t}:\n`;
+      for (const [k, v] of deployValues.get(t)) text += `    ${k}: "${v}"\n`;
+    }
+  }
+  return text;
+}

package/src/context.js

@@ -0,0 +1,25 @@
+// 마법사 전역 상태를 하나의 객체로 명시화 (bash 전역 변수군 대체)
+export const VALID_TYPES = [
+  "spring", "flutter", "next", "react",
+  "react-native", "react-native-expo", "node", "python", "basic",
+];
+
+export const DEFAULT_VERSION = "1.3.14"; // .sh DEFAULT_VERSION (배너 폴백용 — breaking 비교엔 안 씀)
+
+export function createContext(overrides = {}) {
+  return {
+    mode: "interactive",
+    force: false,
+    types: [],
+    version: "",
+    branch: "",
+    paths: new Map(),        // type -> path
+    includeNexus: null,      // null=미설정, true/false=명시
+    includeSecretBackup: null,
+    templateVersion: "",
+    tempDir: "",
+    deployValues: new Map(), // "type.KEY" -> value
+    counters: {},
+    ...overrides,
+  };
+}

package/src/core/assets.js

@@ -0,0 +1,44 @@
+// 템플릿 자산 획득 + 제외 적용 (.sh download_template 등가) — template_integrator.sh 2064~2141.
+import { execFileSync } from "node:child_process";
+import { join } from "node:path";
+import { exists, readText, copyDirSync, remove } from "./fsutil.js";
+import { DOCS_TO_REMOVE, PLUGIN_ITEMS_TO_REMOVE } from "./exclusions.js";
+import { DEFAULT_VERSION } from "../context.js";
+import { TEMPLATE_REPO } from "./paths.js";
+
+// 템플릿을 tempDir로 획득한다.
+// source:
+//   {type:'git', repo?}   → git clone --depth 1 (기본 repo=TEMPLATE_REPO)
+//   {type:'local', path}  → 로컬 트리 복사 (네트워크 없는 등가 검증용)
+// 이미 tempDir/.github 있으면 스킵(.sh 중복 호출 방지). 획득 후 applyExclusions 자동 호출.
+export function acquireTemplate({ tempDir, source = { type: "git" } }) {
+  if (exists(join(tempDir, ".github"))) {
+    applyExclusions(tempDir);
+    return;
+  }
+  remove(tempDir);
+  if (source.type === "local") {
+    copyDirSync(source.path, tempDir);
+  } else {
+    const repo = source.repo || TEMPLATE_REPO;
+    execFileSync("git", ["clone", "--depth", "1", "--quiet", repo, tempDir], { stdio: "ignore" });
+  }
+  applyExclusions(tempDir);
+}
+
+// DOCS_TO_REMOVE + PLUGIN_ITEMS_TO_REMOVE 삭제. skills/ 는 보존(.sh 주석).
+export function applyExclusions(tempDir) {
+  for (const doc of DOCS_TO_REMOVE) remove(join(tempDir, doc));
+  for (const item of PLUGIN_ITEMS_TO_REMOVE) remove(join(tempDir, item));
+}
+
+// tempDir/version.yml 의 ^version: 값. 없으면 DEFAULT_VERSION.
+export function readTemplateVersion(tempDir) {
+  const p = join(tempDir, "version.yml");
+  if (!exists(p)) return DEFAULT_VERSION;
+  for (const line of readText(p).split("\n")) {
+    const m = line.match(/^version:\s*["']?([^"'\s]+)["']?/);
+    if (m) return m[1];
+  }
+  return DEFAULT_VERSION;
+}

package/src/core/breaking.js

@@ -0,0 +1,26 @@
+// .sh compare_versions 등가: v 접두 제거, 3자리 숫자 비교, 누락 자리=0
+export function compareVersions(a, b) {
+  const parse = (v) => String(v).replace(/^v/, "").split(".").map((n) => parseInt(n, 10) || 0);
+  const pa = parse(a), pb = parse(b);
+  for (let i = 0; i < 3; i++) {
+    const x = pa[i] ?? 0, y = pb[i] ?? 0;
+    if (x > y) return 1;
+    if (x < y) return -1;
+  }
+  return 0;
+}
+
+// breaking-changes.json에서 current < ver <= target 범위 항목 수집.
+// ⚠️ .sh 버그 수정: target은 하드코딩 1.3.14가 아니라 실제 templateVersion을 넘긴다 (D2).
+// _ 로 시작하는 키(메타) 제외. severity critical / 그 외(warning).
+export function collectBreaking(json, current, target) {
+  const critical = [], warnings = [];
+  for (const [ver, entry] of Object.entries(json || {})) {
+    if (ver.startsWith("_")) continue;
+    if (compareVersions(current, ver) < 0 && compareVersions(ver, target) <= 0) {
+      const rec = { version: ver, ...entry };
+      (entry?.severity === "critical" ? critical : warnings).push(rec);
+    }
+  }
+  return { critical, warnings };
+}

package/src/core/copy/coderabbit.js

@@ -0,0 +1,25 @@
+// .coderabbit.yaml 복사 (.sh copy_coderabbit_config 등가, force 경로) — template_integrator.sh 3938~3990.
+// SP2-B는 force/비대화형 경로만 구현. 대화형 덮어쓰기/건너뛰기 메뉴는 SP2-C.
+import { join } from "node:path";
+import { exists, copyFileSync } from "../fsutil.js";
+
+// 반환: 'skip-no-src' | 'copied-new' | 'overwritten-backup' | 'skip-non-tty'
+// opts: { force, tty }  — SP2-B 검증은 force:true 경로.
+export function copyCoderabbit(tempDir, { force = false, tty = false } = {}, targetRoot = ".") {
+  const src = join(tempDir, ".coderabbit.yaml");
+  if (!exists(src)) return "skip-no-src";
+  const dst = join(targetRoot, ".coderabbit.yaml");
+
+  if (exists(dst)) {
+    if (force) {
+      copyFileSync(dst, dst + ".bak"); // 백업 후 덮어쓰기
+      copyFileSync(src, dst);
+      return "overwritten-backup";
+    }
+    if (!tty) return "skip-non-tty"; // 비TTY & !force → 유지
+    // 대화형 메뉴는 SP2-C — 여기서는 force가 아니면 유지
+    return "skip-non-tty";
+  }
+  copyFileSync(src, dst); // 신규
+  return "copied-new";
+}