projectops 4.59.1 → 4.60.0

package/README.md

@@ -11,7 +11,7 @@
 **Status: actively maintained.** npm `latest` is exactly what is on the `main` branch; work in progress on `develop` is never published. Versions can still ship several times a day. To stay on a version you have tested, run `npx projectops@<version>` ([releases](https://github.com/Cassiiopeia/projectops/releases)).
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## Latest version : v4.59.0 (2026-10-17)
+## Latest version : v4.59.1 (2026-10-17)
 
 [View full version history](CHANGELOG.md)
 
@@ -183,7 +183,7 @@ What it changed: descriptions were cut to short English triggers, a shared contr
 | `/pro-ssh` | Connect to a remote server over SSH and run commands (AWS EC2, Synology NAS, Linux, and more) |
 | `/pro-skill-creator` | Create, review, and improve a Skill (CREATE / REVIEW / IMPROVE modes) |
 
-**Extras** (optional plugin): `/pro-architecture-consult` (keep AI-written code maintainable: audit, refactor one item at a time, check each diff, freeze violations), `/pro-synology-expose` — `claude plugin install projectops-extras@projectops-marketplace --scope user`
+**Extras** (optional plugin): `/pro-code-consult` (keep AI-written code maintainable: audit, refactor one item at a time, check each diff, freeze violations), `/pro-synology-expose` — `claude plugin install projectops-extras@projectops-marketplace --scope user`
 
 </details>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "4.59.1",
+  "version": "4.60.0",
   "description": "ProjectOps: installer CLI for a fully automated GitHub project management template (versioning, CI/CD, release notes, agent skills)",
   "keywords": [
     "devops",

package/src/cli/args.js

@@ -1,4 +1,4 @@
-// CLI 인자 파싱 (.sh top-level while-case 등가) — template_integrator.sh 842~920.
+// CLI 인자 파싱.
 import { existsSync, statSync, realpathSync } from "node:fs";
 import { join, relative, isAbsolute } from "node:path";
 import { VALID_TYPES } from "../context.js";
@@ -196,7 +196,7 @@ export function parseArgs(argv) {
 
 export class CliError extends Error {}
 
-// 경로 정규화 (.sh resolve_project_paths §3.4): 앞뒤 공백·\→/·끝 /·앞 ./ 제거, 빈값→"."
+// 경로 정규화: 앞뒤 공백·\→/·끝 /·앞 ./ 제거, 빈값→"."
 export function normalizePath(p) {
   let s = String(p).trim();
   s = s.replace(/\\/g, "/");

package/src/commands/doctor.js

@@ -134,7 +134,9 @@ export function localChecks(cwd = ".") {
   const needsActionsWrite = [];
   for (const f of files) {
     const body = readFileSync(join(wfDir, f), "utf8");
-    if (!body.includes("dispatch_downstream.py")) continue;     // 다른 워크플로우를 깨우는 파일만
+    // 다른 워크플로우를 깨우는 파일만 — 주석 줄의 언급(깨워지는 쪽 설명)은 호출이 아니다
+    const code = body.split("\n").filter((line) => !/^\s*#/.test(line)).join("\n");
+    if (!code.includes("dispatch_downstream.py")) continue;
     const perm = body.match(/^permissions:\n((?:\s+.*\n)+)/m);
     const hasActionsWrite = perm ? /^\s+actions:\s*write/m.test(perm[1]) : false;
     if (!hasActionsWrite) needsActionsWrite.push(f);

package/src/commands/full.js

@@ -1,4 +1,4 @@
-// full 모드 오케스트레이터 (.sh execute_integration full case 등가) — template_integrator.sh 4502~4514.
+// full 모드 오케스트레이터.
 // 복사 순서: version.yml → readme → workflows → (deploy블록) → scripts → config →
 //            util(타입별) → issue → discussion → coderabbit → gitignore → setup_guide → (옵션저장)
 import { join } from "node:path";
@@ -21,18 +21,18 @@ import { applyLabelStyle } from "../core/label-style.js";
 import { applyRepoLanguage } from "../core/repo-language.js";
 import { t } from "../i18n/index.js";
 import { verifyInstall } from "../core/verify.js";
+import { toTemplateOptions } from "../core/resolve-options.js";
 
 // context: { version, types, paths:Map, branch, versionCode, deployTarget, publishTargets, includeSecretBackup,
 //            force, repoName, resolvers, now, today }
 // tempDir: 획득된 템플릿. targetRoot: 통합 대상.
 export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
+  // 옵션 값은 resolveOptions 가 정해 context 에 넣는다 — 여기서 기본값을 다시 고르지 않는다
   const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
-    force = true, now, today, templateVersion = "unknown",
-    deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false, aiPrSummary = true,
-    changelogProvider = "commit", changelogBaseUrl = "", codeReviewCoderabbit = true,
-    deployBranch = "", intent = null, semverAuto = true , appRelease = null, labelStyle = "en", closeOnRelease = null, projectsSync = null, language = "en", excludedWorkflows = null, storeLocales = null, storeLocalesIos = null, storeLocalesPlay = null } = context;
+    force = true, now, today, templateVersion, deployBranch = "",
+    deployTarget, publishTargets, codeReviewCoderabbit, labelStyle, language } = context;
 
-  // project_paths 마커 계산 (.sh existing_marker_in_dir 등가 — 대표 마커명)
+  // project_paths 마커 계산 (대표 마커명)
   const pathMarkers = new Map();
   for (const [t] of paths) pathMarkers.set(t, markerForType(t));
 
@@ -46,7 +46,7 @@ export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
   const deployValues = mergeDeployValues(existsSync(vyFile) ? readFileSync(vyFile, "utf8") : "",
     wfCounters.deployValues || new Map()); // Map<type, Map<key,value>
 
-  // 1. version.yml 생성 (전체 재생성 — metadata → deploy → template 순, .sh 최종형과 동일)
+  // 1. version.yml 생성 (전체 재생성 — metadata → deploy → template 순)
   step("write-version-yml", () => writeText(join(targetRoot, PATHS.versionFile),
     buildVersionYml({
       version, types, paths, pathMarkers, branch, deployBranch, versionCode, now, today,
@@ -54,16 +54,14 @@ export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
       // 생성기가 모르는 키(issue_helper 등)를 지킨다 — version.yml 을 매번 다시 쓰므로 안 그러면 업데이트마다 사라진다 (#835)
       ...customYml(vyFile),
       updatedBy: resolveUpdatedBy(existsSync(vyFile) ? readFileSync(vyFile, "utf8") : "", targetRoot), // #811
-      templateOptions: { templateVersion, deployTarget, publishTargets, includeSecretBackup, aiPrSummary, optionsDate: today,
-        changelogProvider, changelogBaseUrl, codeReviewCoderabbit, intent, mode: "full", semverAuto, appRelease, labelStyle, closeOnRelease, projectsSync, language, excludedWorkflows, storeLocales, storeLocalesIos, storeLocalesPlay },
+      templateOptions: toTemplateOptions(context, { mode: "full", optionsDate: today }),
     })), { version, versionCode });
 
   // 2. README 버전 섹션
   step("update-readme", () => addVersionSectionToReadme(version, targetRoot), { version });
 
   // 5. scripts / config
-  //    워크플로우 밖 영역도 기록한다 (#561) — 종전에는 "내 스크립트가 갱신됐나"를
-  //    로그만 보고 알 수 없었다.
+  //    워크플로우 밖 영역도 기록한다 (#561) — "내 스크립트가 갱신됐나"를 로그만 보고 알 수 있게.
   step("copy-scripts", () => copyScripts(tempDir, targetRoot));
   step("copy-config", () => copyConfigFolder(tempDir, targetRoot));
 

package/src/commands/interactive.js

@@ -1,4 +1,4 @@
-// 대화형 마법사 (.sh interactive_mode 등가) — template_integrator.sh 4262~4411 + #446 UI 5층.
+// 대화형 마법사 (#446 UI 5층).
 // io 주입으로 테스트 가능. 실제 실행은 src/ui/prompts.js 함수를 io로 넘긴다.
 // 새 시각 층(banner/detectionLog/analysisCard/ideStatus/installKind/summary)과 저수준 엔진(engineIo)은
 // io의 "옵셔널 멤버" — 스텁이 생략하면 해당 층만 건너뛰고 실행 계약은 동일하다.
@@ -53,7 +53,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
   let skipRecord = false;
   if (io === prompts) trace.mirrorStart();
   try {
-    // 템플릿 먼저 획득 — 배너에 실제 템플릿 버전을 표시 (.sh는 원격 version.yml fetch L4270~4280 등가)
+    // 템플릿 먼저 획득 — 배너에 실제 템플릿 버전을 표시
     trace.step("acquire-template", () => acquireTemplate({ tempDir, source }), { source: source?.type || "git" });
     const templateVersion = readTemplateVersion(tempDir);
     traceTo = templateVersion;
@@ -62,7 +62,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     if (io.banner) io.banner({ version: templateVersion, modeLabel: t("banner.interactive") });
     else io.intro?.(`projectops, ${t("banner.interactive")}`);
 
-    // 기존 version.yml — version/version_code/paths/옵션 보존의 단일 진실 (.sh SSoT L2208~2239)
+    // 기존 version.yml — version/version_code/paths/옵션 보존의 단일 진실
     const vyPath = join(cwd, "version.yml");
     const existing = existsSync(vyPath) ? parseExisting(readFileSync(vyPath, "utf8")) : null;
     traceFrom = existing?.templateVersion || "";
@@ -82,7 +82,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     const updateRun = picked === "update";
     const mode = updateRun ? (existing?.templateMode || "full") : picked;
 
-    // Breaking Changes 게이트 (.sh execute_integration L4415~4420 — 모든 모드 공통, 대화형은 확인 질문)
+    // Breaking Changes 게이트 (모든 모드 공통, 대화형은 확인 질문)
     let breakingReport = null; // #493 — 통과 구간 항목을 가이드에 조치 방법 전문으로 임베드
     const proceed = await trace.stepAsync("breaking-check", () => runBreakingCheck({
       cwd, tempDir, templateVersion,
@@ -194,7 +194,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
       intent = r.intent;
     }
 
-    // 확인/수정 루프 — ESC는 '머무르기' (.sh L1877~1881: 명시적 '아니오'만 종료)
+    // 확인/수정 루프 — ESC는 '머무르기' (명시적 '아니오'만 종료)
     let paths = new Map();
     let confirmed = false;
     // 업데이트 모드 — 카드는 보여주되 확인 루프 생략 (#502: 설정 변경은 기존 모드의 몫)
@@ -227,7 +227,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
           const t = await io.selectTypes(types);
           trace.event("prompt", "types", (Array.isArray(t) ? t : []).join(",") || "", { before: types });
           if (!isCancel(t) && Array.isArray(t) && t.length) {
-            // 타입 집합이 실제로 바뀌면 경로 재해석 대상으로 초기화 (.sh L1984~1992 — 정렬 집합 비교)
+            // 타입 집합이 실제로 바뀌면 경로 재해석 대상으로 초기화 (정렬 집합 비교)
             const oldSorted = [...types].sort().join(",");
             types = t.filter((x) => VALID_TYPES.includes(x));
             if ([...types].sort().join(",") !== oldSorted) paths = new Map();
@@ -235,7 +235,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
         } else if (what === "version") {
           const v = await io.askText(t("flow.askVersion"), version);
           if (!isCancel(v) && v !== version) {
-            // semver 형식 검증 (.sh L2010~2015)
+            // semver 형식 검증
             if (/^\d+\.\d+\.\d+$/.test(v)) version = v;
             else io.note?.(t("flow.badVersion"), t("flow.badVersionTitle"));
           }
@@ -273,7 +273,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
       }
     }
 
-    // 경로 확정 (.sh resolve_project_paths L1362~1589 — full/version만. 저장값·후보 스캔·질문)
+    // 경로 확정 (full/version만. 저장값·후보 스캔·질문)
     if (mode === "full" || mode === "version") {
       paths = await resolveProjectPaths({
         root: cwd, types, paths, existingPaths: existing?.paths ?? new Map(),
@@ -285,7 +285,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
       for (const t of types) if (t !== "basic" && !paths.has(t)) paths.set(t, existing?.paths.get(t) || ".");
     }
 
-    // @wizard env 계획 질문 (.sh wf_prompt_env_plan L3220 — full/workflows만).
+    // @wizard env 계획 질문 (full/workflows만).
     // 업데이트 모드는 생략 — 신규 파일은 기본값, 교체 파일은 아래 carryover가 기존 실값을 이월한다.
     const resolvers = makeResolvers(cwd, repoName, paths);
     let envValues = new Map(), envUseDefaults = true;
@@ -334,7 +334,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     });
     ctx.templateVersion = templateVersion;
 
-    // 기존 워크플로우 충돌 3지선 — 타입당 1회 결정을 파일에 캐시 적용 (.sh L3440~3508 UX 등가)
+    // 기존 워크플로우 충돌 3지선 — 타입당 1회 결정을 파일에 캐시 적용
     // 업데이트 모드는 위에서 일괄 결정(updateDecisions)했으므로 3지선다를 건너뛴다 (#502).
     let hooks = updateDecisions ? { decisions: updateDecisions } : {};
     if (showOptional && io.engineIo?.select && !updateRun) {
@@ -352,7 +352,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
                 { value: "template", label: t("flow.opt.template") },
               ],
             });
-            perType.set(type, isCancel(sel) || sel == null ? "skip" : sel); // ESC = 건너뛰기 (.sh L3463)
+            perType.set(type, isCancel(sel) || sel == null ? "skip" : sel); // ESC = 건너뛰기
           }
           decisions.set(filename, perType.get(type));
         }
@@ -402,7 +402,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     else if (mode === "version") result = trace.step("install-version", () => runVersion(ctx, tempDir, cwd));
     else if (mode === "workflows") result = trace.step("install-workflows", () => runWorkflows(ctx, tempDir, cwd, { ...hooks, trace }));
 
-    // 통합 후 IDE 스킬 제안 (.sh L4557 offer_ide_tools_install — 사전 질문 게이트, 기본 N)
+    // 통합 후 IDE 스킬 제안 (사전 질문 게이트, 기본 N)
     // 업데이트 모드(#502): 이미 설치된 IDE 스킬만 질문 없이 최신화 (미설치 IDE는 건드리지 않음)
     if (updateRun) {
       await skills({ templateVersion, tempDir, interactive: false, installedOnly: true });
@@ -430,7 +430,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
       }).guidePath;
     }
 
-    // 완료 요약 (.sh print_summary L5438)
+    // 완료 요약
     const summaryCtx = {
       mode, types, version, deployBranch, deployBranchReady, migrationGuidePath,
       counters: { workflows: result?.workflows?.copied ?? 0, workflowFiles: result?.workflows?.copiedFiles ?? [], utilModules: 0 },

package/src/commands/issues.js

@@ -1,4 +1,4 @@
-// issues 모드 (.sh execute_integration issues case 등가) — template_integrator.sh 4532~4535.
+// issues 모드 (이슈·PR 템플릿만 설치).
 // 이슈/PR 템플릿 + Discussion 템플릿만 복사.
 import { applyLabelStyle } from "../core/label-style.js";
 import { applyRepoLanguage } from "../core/repo-language.js";

package/src/commands/skills.js

@@ -1,4 +1,4 @@
-// IDE Skills 설치 오케스트레이터 (.sh offer_ide_tools_install 등가).
+// IDE Skills 설치 오케스트레이터.
 // 레지스트리 기반 — 개별 IDE를 이름으로 알지 않고 ADAPTERS 배열만 순회한다.
 // 새 IDE는 adapters/ 에 파일 추가 + registry 등록만으로 여기 수정 없이 동작한다.
 import { ADAPTERS } from "../core/ide/registry.js";

package/src/commands/version.js

@@ -1,4 +1,4 @@
-// version 모드 (.sh execute_integration version case 등가) — template_integrator.sh 4517~4530.
+// version 모드 (version.yml 생성·갱신).
 // 순서: version.yml → readme → scripts → config → gitignore → setup_guide.
 // (워크플로우 미복사 → deploy 블록 없음. util·issue·coderabbit도 없음.)
 import { existsSync, readFileSync } from "node:fs";
@@ -12,12 +12,12 @@ import { addVersionSectionToReadme } from "../core/copy/readme.js";
 import { applyLabelStyle } from "../core/label-style.js";
 import { copyScripts, copyConfigFolder, copySetupGuide } from "../core/copy/simple.js";
 import { ensureGitignore } from "../core/copy/gitignore.js";
+import { toTemplateOptions } from "../core/resolve-options.js";
 
 export function runVersion(context, tempDir, targetRoot = ".") {
+  // 옵션 값은 resolveOptions 가 정해 context 에 넣는다 — 여기서 기본값을 다시 고르지 않는다
   const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
-    now, today, templateVersion = "unknown", deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false,
-    changelogProvider = "commit", changelogBaseUrl = "", codeReviewCoderabbit = true,
-    deployBranch = "", recordMode = "version", semverAuto = true , appRelease = null, labelStyle = "en", closeOnRelease = null, projectsSync = null, language = null, excludedWorkflows = null, storeLocales = null, storeLocalesIos = null, storeLocalesPlay = null } = context;
+    now, today, templateVersion, deployBranch = "", recordMode = "version", labelStyle } = context;
 
   const pathMarkers = new Map();
   for (const [t] of paths) pathMarkers.set(t, markerForType(t));
@@ -35,8 +35,7 @@ export function runVersion(context, tempDir, targetRoot = ".") {
       updatedBy: resolveUpdatedBy(existsSync(vyFile) ? readFileSync(vyFile, "utf8") : "", targetRoot), // #811
       // mode(#502): version 모드가 기존 full 통합 기록을 "version"으로 강등하지 않도록
       // 호출부가 recordMode로 기존 값을 넘긴다 (full이 우세 — 업데이트 재실행 범위 축소 방지).
-      templateOptions: { templateVersion, deployTarget, publishTargets, includeSecretBackup, optionsDate: today,
-        changelogProvider, changelogBaseUrl, codeReviewCoderabbit, mode: recordMode, semverAuto, appRelease, labelStyle, closeOnRelease, projectsSync, language, excludedWorkflows, storeLocales, storeLocalesIos, storeLocalesPlay },
+      templateOptions: toTemplateOptions(context, { mode: recordMode, optionsDate: today }),
     }));
   addVersionSectionToReadme(version, targetRoot);
   copyScripts(tempDir, targetRoot);

package/src/commands/workflows.js

@@ -1,4 +1,4 @@
-// workflows 모드 (.sh execute_integration workflows case 등가) — template_integrator.sh 4523~4531.
+// workflows 모드 (워크플로우만 설치).
 // 순서: copy_workflows → update_version_yml_deploy(version.yml 있을 때만) → scripts → config → util(타입별) → setup_guide.
 // (version.yml 생성 안 함 — 기존 version.yml이 있을 때만 deploy 블록 추가.)
 import { join } from "node:path";
@@ -13,7 +13,7 @@ import { installAgentGuide } from "../core/agent-guide.js";
 import { verifyInstall } from "../core/verify.js";
 
 export function runWorkflows(context, tempDir, targetRoot = ".", hooks = {}) {
-  const { types = [], force = true, labelStyle = "en" } = context;
+  const { types = [], force = true, labelStyle } = context;   // labelStyle 은 resolveOptions 가 정한다
   const wf = copyWorkflows(context, tempDir, targetRoot, hooks);
 
   const vy = join(targetRoot, PATHS.versionFile);
@@ -58,7 +58,7 @@ export function runWorkflows(context, tempDir, targetRoot = ".", hooks = {}) {
   return { workflows: wf, verification };
 }
 
-// 기존 version.yml에서 deploy: 블록을 제거하고 새로 append (.sh update_version_yml_deploy 멱등).
+// 기존 version.yml에서 deploy: 블록을 제거하고 새로 append (멱등).
 export function upsertDeployBlock(content, deployValues) {
   // 기존 deploy: 블록 제거 (deploy: 라인 ~ 다음 최상위 키 전까지)
   const lines = content.split(/\r?\n/);

package/src/context.js

@@ -5,7 +5,7 @@ export const VALID_TYPES = [
   "react-native", "react-native-expo", "node", "python", "basic",
 ];
 
-export const DEFAULT_VERSION = "1.3.14"; // .sh DEFAULT_VERSION (배너 폴백용 — breaking 비교엔 안 씀)
+export const DEFAULT_VERSION = "1.3.14"; // 템플릿 버전 미상 시 (배너 폴백용 — breaking 비교엔 안 씀)
 
 export function createContext(overrides = {}) {
   return {
@@ -25,7 +25,7 @@ export function createContext(overrides = {}) {
     changelogProvider: null, // 'commit'(기본) | 'coderabbit' | 'openai' | 'gemini' | 'claude' | 'ollama' | 'commit'
     changelogBaseUrl: null,  // ollama일 때만 값
     codeReviewCoderabbit: null,
-    deployBranch: "",        // 릴리스 PR head 브랜치 (#456). 빈 값=metadata.deploy_branch 미출력
+    deployBranch: "",        // 릴리스 PR head 브랜치 (#456). 빈 값=metadata.development_branch 미출력
     intent: null,            // 프로젝트 성격 (#485 — app/library/both/none/manual). null=미설정(역추론)
     semverAuto: null,        // semver 자동 승격 (#546). null=미설정 → 신규·기존 모두 true (#814). 명시적 false 만 끈다
     closeOnRelease: null,    // 릴리스 시 완료 이슈 닫기 (#771). null=미설정(신규 true / 기존 레포 키 없음)

package/src/core/agent-guide.js

@@ -7,13 +7,14 @@
 // 내용에 옵션 표를 박지 않는다 — 박으면 곧 낡는다. 표는 항상 `npx projectops --mode options --json` 이 정본이다.
 import { join } from "node:path";
 import { writeText } from "./fsutil.js";
+import { TEMPLATE_REPO_WEB_URL } from "./paths.js";
 
 export const AGENT_GUIDE_PATH = ".github/.projectops/AGENT-GUIDE.md";
 
 export function agentGuideText(templateVersion = "") {
   return `# projectops — guide for AI agents
 
-This repository is managed with [projectops](https://github.com/Cassiiopeia/projectops)${templateVersion ? ` (installed template ${templateVersion})` : ""}.
+This repository is managed with [projectops](${TEMPLATE_REPO_WEB_URL})${templateVersion ? ` (installed template ${templateVersion})` : ""}.
 GitHub Actions workflows in \`.github/workflows/PROJECT-*\` handle versioning, release notes, CI/CD and issue automation.
 This file is generated by the installer and overwritten on update. Do not edit it.
 

package/src/core/assets.js

@@ -1,4 +1,4 @@
-// 템플릿 자산 획득 + 제외 적용 (.sh download_template 등가) — template_integrator.sh 2064~2141.
+// 템플릿 자산 획득 + 제외 적용.
 import { execFileSync } from "node:child_process";
 import { mkdirSync } from "node:fs";
 import { join } from "node:path";
@@ -11,7 +11,7 @@ import { TEMPLATE_REPO } from "./paths.js";
 // source:
 //   {type:'git', repo?}   → git clone --depth 1 (기본 repo=TEMPLATE_REPO)
 //   {type:'local', path}  → 로컬 트리 복사 (네트워크 없는 등가 검증용)
-// 이미 tempDir/.github 있으면 스킵(.sh 중복 호출 방지). 획득 후 applyExclusions 자동 호출.
+// 이미 tempDir/.github 있으면 스킵(중복 호출 방지). 획득 후 applyExclusions 자동 호출.
 export function acquireTemplate({ tempDir, source = { type: "git" } }) {
   if (exists(join(tempDir, ".github"))) {
     applyExclusions(tempDir);
@@ -30,7 +30,7 @@ export function acquireTemplate({ tempDir, source = { type: "git" } }) {
   applyExclusions(tempDir);
 }
 
-// DOCS_TO_REMOVE + PLUGIN_ITEMS_TO_REMOVE 삭제. skills/ 는 보존(.sh 주석).
+// DOCS_TO_REMOVE + PLUGIN_ITEMS_TO_REMOVE 삭제. skills/ 는 보존.
 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));

package/src/core/breaking-check.js

@@ -1,4 +1,4 @@
-// breaking-changes 확인 흐름 배선 (.sh check_breaking_changes L2506~2616 등가).
+// breaking-changes 확인 흐름 배선.
 // collectBreaking(순수 비교)은 breaking.js — 이 모듈은 로드(원격→clone본 폴백)·표시·확인 게이트.
 import { readFileSync, existsSync } from "node:fs";
 import { join } from "node:path";
@@ -8,7 +8,7 @@ import { t } from "../i18n/index.js";
 
 const BC_URL = "https://raw.githubusercontent.com/Cassiiopeia/projectops/main/.github/config/breaking-changes.json";
 
-// 원격 우선(3초 타임아웃) → clone된 템플릿의 번들본 폴백 → 둘 다 실패 시 null(조용히 스킵 — .sh 등가)
+// 원격 우선(3초 타임아웃) → clone된 템플릿의 번들본 폴백 → 둘 다 실패 시 null(조용히 스킵)
 export async function loadBreakingJson(tempDir) {
   try {
     const res = await fetch(BC_URL, { signal: AbortSignal.timeout(3000) });
@@ -25,7 +25,7 @@ export async function loadBreakingJson(tempDir) {
 // opts:
 //   cwd             - 통합 대상 루트 (기존 version.yml에서 현재 템플릿 버전 읽음)
 //   tempDir         - clone된 템플릿 (번들 폴백용)
-//   templateVersion - 설치하려는 템플릿 버전 (.sh의 DEFAULT_VERSION 고정 버그를 실버전으로 교정 — 설계 D2)
+//   templateVersion - 설치하려는 템플릿 버전 (고정 DEFAULT_VERSION 아님 — 설계 D2)
 //   askYesNo        - async(message, defaultYes)→bool. null이면 비대화형: 경고만 출력 후 진행
 //   loader          - 테스트 주입용 (기본 loadBreakingJson)
 //   onItems         - (#493) 통과 구간 항목 콜백 ({current, target, critical, warnings}) —
@@ -34,7 +34,7 @@ export async function runBreakingCheck({ cwd, tempDir, templateVersion, askYesNo
   const vy = join(cwd, "version.yml");
   if (!existsSync(vy)) return true; // 신규 통합 — 비교 기준 없음
   const { templateVersion: current } = parseExisting(readFileSync(vy, "utf8"));
-  if (!current) return true; // 템플릿 메타 없음(unknown) — .sh 동일하게 스킵
+  if (!current) return true; // 템플릿 메타 없음(unknown) — 스킵
 
   const json = await loader(tempDir);
   if (!json) return true;
@@ -72,11 +72,11 @@ export async function runBreakingCheck({ cwd, tempDir, templateVersion, askYesNo
 
   if (critical.length > 0) {
     if (askYesNo) {
-      // 대화형: 명시 확인 없으면 중단 (기본 N — .sh 등가)
+      // 대화형: 명시 확인 없으면 중단 (기본 N)
       const ok = await askYesNo(t("breaking.askContinue"), false);
       if (ok !== true) return false;
     } else {
-      // 비대화형(--force): 게이트로 CI를 죽이지 않고 경고 후 진행 (.sh와 의도적 차이 — CI 친화)
+      // 비대화형(--force): 게이트로 CI를 죽이지 않고 경고 후 진행 (CI 친화)
       e(t("breaking.nonInteractive"));
     }
   }

package/src/core/breaking.js

@@ -1,4 +1,4 @@
-// .sh compare_versions 등가: v 접두 제거, 3자리 숫자 비교, 누락 자리=0
+// 버전 비교: 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);
@@ -11,7 +11,7 @@ export function compareVersions(a, b) {
 }
 
 // breaking-changes.json에서 current < ver <= target 범위 항목 수집.
-// ⚠️ .sh 버그 수정: target은 하드코딩 1.3.14가 아니라 실제 templateVersion을 넘긴다 (D2).
+// ⚠️ target은 하드코딩 1.3.14가 아니라 실제 templateVersion을 넘긴다 (D2).
 // _ 로 시작하는 키(메타) 제외. severity critical / 그 외(warning).
 export function collectBreaking(json, current, target) {
   const critical = [], warnings = [];

package/src/core/copy/coderabbit.js

@@ -1,4 +1,4 @@
-// .coderabbit.yaml 복사 (.sh copy_coderabbit_config 등가, force 경로) — template_integrator.sh 3938~3990.
+// .coderabbit.yaml 복사 (force 경로).
 // SP2-B는 force/비대화형 경로만 구현. 대화형 덮어쓰기/건너뛰기 메뉴는 SP2-C.
 import { join } from "node:path";
 import { exists, copyFileSync } from "../fsutil.js";

package/src/core/copy/gitignore.js

@@ -1,10 +1,10 @@
-// .gitignore 보장 (.sh ensure_gitignore + normalize/check 등가) — template_integrator.sh 3996~4111.
+// .gitignore 보장 (항목 정규화 > 누락 확인 > 추가).
 import { join } from "node:path";
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
 
 const REQUIRED_ENTRIES = ["/.idea", "/.claude/settings.local.json"];
 
-// .sh normalize_gitignore_entry: 주석 제거·트림·앞 / 제거·앞 ./ 제거·뒤 / 제거. 빈값이면 원본.
+// 항목 정규화: 주석 제거·트림·앞 / 제거·앞 ./ 제거·뒤 / 제거. 빈값이면 원본.
 export function normalizeGitignoreEntry(entry) {
   let e = String(entry);
   e = e.replace(/#.*$/, "");        // 주석 제거
@@ -43,7 +43,7 @@ export function ensureGitignore(targetRoot = ".") {
   const toAdd = REQUIRED_ENTRIES.filter((e) => !entryExists(e, content));
   if (toAdd.length === 0) return { created: false, added: [] };
 
-  // 파일 끝에 개행 없으면 추가 (.sh: tail -c 1 이 non-empty면 echo "")
+  // 파일 끝에 개행 없으면 추가
   if (content.length > 0 && !content.endsWith("\n")) content += "\n";
   content += "\n";
   content += "# ====================================================================\n";

package/src/core/copy/readme.js

@@ -1,4 +1,4 @@
-// README 버전 섹션 추가 (.sh add_version_section_to_readme 등가) — template_integrator.sh 2145~2181.
+// README 버전 섹션 추가.
 import { join } from "node:path";
 import { existsSync, readFileSync, appendFileSync } from "node:fs";
 
@@ -15,8 +15,7 @@ export function addVersionSectionToReadme(version, targetRoot = ".") {
   if (content.includes(MARKER)) return "skip-marker";
   if (VERSION_LINE_RE.test(content)) return "skip-version-line";
 
-  // .sh: cat >> README.md << EOF — EOF 다음 첫 줄이 빈 줄이므로 append 본문은 "\n---\n..."로 시작.
-  // (원본 파일이 개행으로 끝난다는 전제는 .sh와 동일 — heredoc은 원본 끝에 그대로 붙는다.)
+  // append 본문은 빈 줄 + "---"로 시작 (원본 파일이 개행으로 끝난다는 전제).
   const section =
     "\n" +
     "---\n" +

package/src/core/copy/simple.js

@@ -1,5 +1,4 @@
-// 단순 복사 함수 (무조건 덮어쓰기류) — .sh copy_scripts/config/issue/discussion/setup_guide 등가.
-// 실측: template_integrator.sh 3818, 3845, 3872, 3895, 4114.
+// 단순 복사 함수 (무조건 덮어쓰기류): scripts, config, issue, discussion, setup guide.
 import { join, basename } from "node:path";
 import { chmodSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import { PATHS } from "../paths.js";
@@ -16,6 +15,9 @@ export function copyScripts(tempDir, targetRoot = ".") {
     "changelog_manager.py",
     "truncate_release_notes.sh", "truncate_release_notes.py",
     "issue_helper.py",
+    // GitHub REST 호출 공통 (#914). issue_helper·changelog_notice·pr_summary_comment·dispatch_downstream·
+    // close_issues_on_release·store_deploy_config 가 import 하므로 빠지면 그 워크플로가 모두 죽는다.
+    "github_api.py",
     // 릴리스 워크플로우가 PAT 없이 머지한 뒤 후속 워크플로우를 깨울 때 호출 (#551).
     "dispatch_downstream.py",
     // AI PR SUMMARY 워크플로우가 요약 댓글을 작성·갱신할 때 호출 (#553).

package/src/core/copy/util.js

@@ -1,4 +1,4 @@
-// util 모듈 복사 (.sh copy_util_modules 등가, force 경로) — template_integrator.sh 4203~.
+// util 모듈 복사 (force 경로).
 // tempDir/.github/util/<type>/ 있으면 (force) .github/util/<type>/로 전체 복사, 모듈 수 카운트.
 import { join } from "node:path";
 import { readdirSync } from "node:fs";
@@ -15,7 +15,7 @@ export function copyUtilModules(tempDir, type, { force = false } = {}, targetRoo
   const dst = join(targetRoot, ".github", "util", type);
   copyDirSync(src, dst);
 
-  // 하위 디렉토리 개수 = 모듈 수 (.sh: for dir in "$util_dst"/*/)
+  // 하위 디렉토리 개수 = 모듈 수
   // `_` 로 시작하는 폴더는 모듈이 아니라 모듈들이 공유하는 자산이다
   // (예: flutter/_shared — 마법사 3종 공통 CSS/JS). 개수에서 제외한다.
   let moduleCount = 0;

package/src/core/copy/workflows.js

@@ -1,5 +1,4 @@
-// 워크플로우 복사 엔진. 구 template_integrator.sh(#458 로 삭제됨)의 copy_workflows 를 포팅한 것이다.
-// 파일 안의 ".sh ... 등가" 표기는 그 삭제된 스크립트를 가리킨다 — 줄 번호는 더 이상 찾을 수 없다.
+// 워크플로우 복사 엔진.
 //
 // 충돌(기존 파일과 다름)의 처리 결정은 hooks.decisions(Map<파일명, 'skip'|'backup'|'template'>)로 받는다.
 //   - 실제 마법사(commands/interactive.js)는 listWorkflowConflicts 로 충돌 목록을 얻어 직접 Map 을 만든다.
@@ -35,7 +34,7 @@ export function onlyTriggersOnDevelop(content) {
   return branches.length > 0 && filtered >= needFilter && branches.every((b) => b === "develop");
 }
 
-// 한 파일에 env 치환을 적용해 대상 파일을 갱신 (.sh configure_workflow_env 등가).
+// 한 파일에 env 치환을 적용해 대상 파일을 갱신.
 // values/useDefaults: env 계획(promptEnvPlan) 결과 — 미지정이면 기본값 경로(현행 force 동작).
 // trace(#494): 치환 1건당 env.substituted 이벤트 (before/after 포함 — 치환 불일치류 버그의 즉시 발견 근거).
 function configureEnv(targetPath, filename, { type, projectPath = ".", repoName = "", resolvers = {}, collectAsks = null, values = new Map(), useDefaults = true, trace = null }) {
@@ -173,11 +172,8 @@ export function copyWorkflows(context, tempDir, targetRoot = ".", hooks = {}) {
   Object.defineProperty(counters, "onSkip", { value: onSkip, enumerable: false });
 
   // (1) common — 타입별과 동일한 판정·보호를 받는다 (#560).
-  //
-  // 종전에는 "unchanged면 스킵, 아니면 무조건 덮어쓰기"였다. 그런데 릴리스 파이프라인처럼
-  // 프로젝트마다 뒤에 붙일 일이 다른 워크플로우는 common에 있어도 사용자가 고쳐 쓸 수밖에
-  // 없다. 고치지 않고는 쓸 수 없는 파일을, 고치면 백업도 없이 날아가는 규칙으로 관리하고
-  // 있었다. common/deploy조차 .bak을 남기는데 본체만 아무것도 남기지 않았다.
+  // 릴리스 파이프라인처럼 프로젝트마다 뒤에 붙일 일이 다른 워크플로우는 common 이어도 사용자가 고쳐 쓴다.
+  // 그래서 수정본을 무조건 덮어쓰지 않고 타입별과 같은 충돌 판정·백업을 거친다.
   const commonDir = join(projectTypesDir, "common");
   if (exists(commonDir)) {
     const commonEnv = envOptsFor("common");
@@ -319,13 +315,13 @@ function recordBaseline(workflowsDir, targetRoot, counters, previous, templateVe
   }
 }
 
-// changed(기존에 있고 내용이 바뀐) 파일 1개를 결정에 따라 처리 (.sh 3440~3508 3지선 case 등가).
+// changed(기존에 있고 내용이 바뀐) 파일 1개를 결정에 따라 처리 (3지선: 백업 교체·템플릿 사본·유지).
 // 'skip'(기본): 기존 유지. 'backup': 기존→.bak 후 교체. 'template': 기존 유지 + 새 버전을 .template.yaml로.
 function applyDecision(decision, srcDir, workflowsDir, filename, counters, trace = null, type = "") {
   const src = join(srcDir, filename);
   const dst = join(workflowsDir, filename);
   if (decision === "backup") {
-    // .sh O) mv → cp: 기존을 .bak으로 백업 후 새 버전으로 교체
+    // 백업 교체: 기존을 .bak으로 백업 후 새 버전으로 교체
     renameSync(dst, dst + ".bak");
     copyFileSync(src, dst);
     counters.copied++;
@@ -334,14 +330,14 @@ function applyDecision(decision, srcDir, workflowsDir, filename, counters, trace
     return;
   }
   if (decision === "template") {
-    // .sh T) `${filename%.yaml}.template.yaml` — .yaml만 strip (.yml은 그대로 뒤에 붙음, .sh 동일)
+    // 템플릿 사본: `<이름>.template.yaml` — .yaml만 strip (.yml은 그대로 뒤에 붙음)
     const templateName = (filename.endsWith(".yaml") ? filename.slice(0, -".yaml".length) : filename) + ".template.yaml";
-    copyFileSync(src, join(workflowsDir, templateName)); // cp가 기존 .template.yaml 덮어씀(.sh rm -f + cp 등가)
+    copyFileSync(src, join(workflowsDir, templateName)); // 기존 .template.yaml 덮어씀
     counters.templateAdded++;
     trace?.event("copy", "template-added", templateName, { original: filename });
     return;
   }
-  counters.skipped++; // 'skip'/미지정/ESC → 기존 유지 (.sh S)·force 기본)
+  counters.skipped++; // 'skip'/미지정/ESC → 기존 유지 (force 기본)
   // #654 — 새 템플릿을 incoming에 남기고 diff 줄 수를 detail로 함께 기록
   const inc = counters.onSkip?.(srcDir, filename, type) ?? {};
   trace?.event("copy", "skipped-conflict", filename, {

package/src/core/detect-fs.js

@@ -1,4 +1,4 @@
-// 실 파일시스템 프로젝트 감지 (.sh detect_* 실행부 등가).
+// 실 파일시스템 프로젝트 감지.
 // SP2-A detect.js 순수 함수를 fs/git으로 구동한다.
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { join, basename } from "node:path";
@@ -18,7 +18,7 @@ function gitOut(root, args) {
   } catch { return ""; }
 }
 
-// 확장자 스캔용 파일 목록 (.sh suggest_types_by_scan find 등가 — depth≤3, vendor 폴더 프루닝).
+// 확장자 스캔용 파일 목록 (depth≤3, vendor 폴더 프루닝).
 const SCAN_PRUNE = new Set([
   "node_modules", ".git", "build", "dist", ".dart_tool",
   "android", "ios", ".gradle", "venv", ".venv", "__pycache__",
@@ -45,7 +45,7 @@ export function listScanFiles(root, maxDepth = 3) {
 }
 
 // 타입 감지 — version.yml의 project_types 최우선(source of truth), 없으면 마커 스캔.
-// 마커도 전혀 없으면(basic 폴백) 확장자 빈도 스캔으로 2차 추천 (.sh suggest_types_by_scan 등가, #458).
+// 마커도 전혀 없으면(basic 폴백) 확장자 빈도 스캔으로 2차 추천 (#458).
 export function detectTypes(root) {
   const vy = join(root, "version.yml");
   if (existsSync(vy)) {
@@ -64,7 +64,7 @@ export function detectTypes(root) {
   return byMarkers;
 }
 
-// 버전 감지 — .sh detect_version 순서. jq 유무는 command 존재로 판정.
+// 버전 감지. jq 유무는 command 존재로 판정.
 export function detectVersion(root, { hasJq } = {}) {
   const read = readFile(root);
   const readJson = (rel) => { const c = read(rel); try { return c ? JSON.parse(c) : null; } catch { return null; } };
@@ -103,7 +103,7 @@ function hasCommand(cmd) {
   } catch { return false; }
 }
 
-// Spring application*.yml 탐색 (.sh resolve_spring_app_yml_dir/path L2767~2780 등가)
+// Spring application*.yml 탐색
 // find {base} -path "*/src/main/resources/application*.yml" | head -1 의 fs 재귀 구현.
 // 반환: root 기준 상대경로 (예: "server/src/main/resources/application.yml") 또는 "".
 export function findSpringAppYml(root, base = ".") {
@@ -130,7 +130,7 @@ export function findSpringAppYml(root, base = ".") {
   return hit;
 }
 
-// 실 resolver 세트 생성 (.sh resolve_token 4종 등가) — index/interactive 공용.
+// 실 resolver 4종 세트 생성 — index/interactive 공용.
 // paths: Map<type, path> (모노레포 경로).
 export function makeResolvers(root, repoName, paths) {
   const springBase = (t) => paths.get(t || "spring") || paths.get("spring") || ".";