projectops 3.0.193 → 3.0.195

package/README.md

@@ -7,7 +7,7 @@
 > 이슈 등록부터 커밋, 보고서, 배포까지. 개발자는 코드만 작성하세요.
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## 최신 버전 : v3.0.192 (2026-07-08)
+## 최신 버전 : v3.0.194 (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.195",
   "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,135 @@
+// 대화형 마법사 (.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 { runSkills } from "./skills.js";
+import * as prompts from "../ui/prompts.js";
+
+const CANCEL = prompts.CANCEL;
+
+// io 기본값 = 실제 prompts. 테스트는 스텁 io 주입.
+// skills = runSkills 주입 지점(테스트가 실제 IDE CLI를 안 건드리게). 기본은 실제 runSkills.
+export async function runInteractive(baseCtx, { cwd = process.cwd(), source = { type: "git" }, clock, io = prompts, skills = runSkills } = {}) {
+  io.intro?.("projectops — 대화형 통합 마법사");
+
+  // 1) 모드 선택
+  const mode = await io.selectMode();
+  if (mode === CANCEL || mode == null) { io.cancelMessage?.("설치를 취소했습니다."); return 0; }
+
+  const tempDir = join(cwd, PATHS.tempDir);
+  try {
+    acquireTemplate({ tempDir, source });
+    const templateVersion = readTemplateVersion(tempDir);
+
+    // skills 모드 — IDE 스킬 설치 (템플릿 통합 없음). 대화형으로 실행.
+    if (mode === "skills") {
+      await skills({ templateVersion, tempDir, interactive: true });
+      io.outro?.("AI 스킬 설치를 마쳤습니다.");
+      return 0;
+    }
+
+    // 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/skills.js

@@ -0,0 +1,82 @@
+// IDE Skills 설치 오케스트레이터 (.sh offer_ide_tools_install 등가).
+// 레지스트리 기반 — 개별 IDE를 이름으로 알지 않고 ADAPTERS 배열만 순회한다.
+// 새 IDE는 adapters/ 에 파일 추가 + registry 등록만으로 여기 수정 없이 동작한다.
+import { ADAPTERS } from "../core/ide/registry.js";
+import { versionTag } from "../core/ide/util.js";
+import { defaultIo } from "../core/ide/runner.js";
+import * as skillsPrompts from "../ui/skills-prompts.js";
+
+// 상태 수집 → [{adapter, status}]. optional 어댑터는 감지 불가(cliMissing)면 목록에서 제외.
+export function collectStatuses(io) {
+  const rows = [];
+  for (const a of ADAPTERS) {
+    const status = safe(() => a.detect(io), { installed: false, version: null, cliMissing: true });
+    if (a.optional && status.cliMissing) continue; // harness 등 조건부 항목은 불가 시 숨김
+    rows.push({ adapter: a, status });
+  }
+  return rows;
+}
+
+// 상태 표시 문자열 목록 (표시용, 순수).
+export function formatStatuses(rows, templateVersion) {
+  return rows.map(({ adapter, status }) => {
+    const label = adapter.label.padEnd(12);
+    if (status.cliMissing) return `${label}: ${status.note || "skill 미설치 (CLI 없음)"}`;
+    if (status.installed) {
+      const v = status.version ? ` (v${status.version})` : "";
+      return `${label}: skill 설치됨${v}${versionTag(status.version, templateVersion)}`;
+    }
+    return `${label}: ${status.note || "skill 미설치"}`;
+  });
+}
+
+// 대화형/비대화형 공통 진입. opts: {io, templateVersion, sourceSkillsDir, tempDir, interactive, ui}
+export async function runSkills(opts = {}) {
+  const io = opts.io || defaultIo();
+  const ui = opts.ui || skillsPrompts;
+  const ctx = { templateVersion: opts.templateVersion || "", sourceSkillsDir: opts.sourceSkillsDir, tempDir: opts.tempDir };
+
+  const rows = collectStatuses(io);
+  io.log("");
+  io.log("── IDE Skills 현재 상태 ──");
+  for (const line of formatStatuses(rows, ctx.templateVersion)) io.log(line);
+  io.log("");
+
+  // 비대화형: 감지된(=관리 가능) 모든 어댑터에 apply(설치/업데이트) 순차 실행.
+  if (!opts.interactive) {
+    for (const { adapter } of rows) safe(() => adapter.apply(io, ctx), false);
+    return 0;
+  }
+
+  // 대화형: 동작 선택 → IDE 멀티셀렉트 → 실행.
+  const action = await ui.selectAction();
+  if (action == null || action === skillsPrompts.CANCEL || action === "skip") {
+    io.log("IDE Skills는 변경하지 않고 넘어갑니다.");
+    return 0;
+  }
+
+  const choices = rows.map(({ adapter, status }) => ({
+    id: adapter.id, label: adapter.label,
+    disabled: action === "apply" && status.cliMissing, // 설치는 CLI 있어야, 제거는 무조건 후보
+  }));
+  const preselect = rows
+    .filter(({ status }) => action === "apply" ? !status.cliMissing : true)
+    .map(({ adapter }) => adapter.id);
+
+  const targets = await ui.selectTargets(choices, preselect, action);
+  if (targets == null || targets === skillsPrompts.CANCEL || !targets.length) {
+    io.log("선택한 IDE가 없어 건너뜁니다 (원할 때 다시 실행하세요).");
+    return 0;
+  }
+
+  const selected = new Set(targets);
+  for (const { adapter } of rows) {
+    if (!selected.has(adapter.id)) continue;
+    io.log("");
+    io.log(`[ ${adapter.label} ${action === "apply" ? "설치/업데이트" : "제거"} ]`);
+    safe(() => (action === "apply" ? adapter.apply(io, ctx) : adapter.remove(io, ctx)), false);
+  }
+  return 0;
+}
+
+function safe(fn, fallback) { try { return fn(); } catch { return fallback; } }

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;
+}