projectops 4.59.1 → 4.60.0

package/src/core/detect.js

@@ -1,5 +1,5 @@
-// package.json 내용 분류 (.sh classify_package_json 등가) — 원본 파일 텍스트에 대한
-// grep 부분문자열 매칭. dependencies 파싱이 아니라 raw 텍스트 검사여야 등가.
+// package.json 내용 분류 — 원본 파일 텍스트에 대한 부분문자열 매칭.
+// dependencies 파싱이 아니라 raw 텍스트 검사 (깨진 JSON에도 동작).
 // 입력은 package.json의 원문 문자열(raw). 순서 중요.
 export function classifyPackageText(raw) {
   const s = String(raw || "");
@@ -61,7 +61,7 @@ export function extraMarkers(type) {
   return { python: ["setup.py", "requirements.txt"], spring: ["build.gradle.kts", "pom.xml"] }[type] || [];
 }
 
-// 확장자 빈도 스캔 추천 (.sh suggest_types_by_scan 2단계 등가, #458 npx 이식).
+// 확장자 빈도 스캔 추천 (마커 없을 때 2단계, #458).
 // 마커가 전혀 없을 때(=basic 폴백)만 쓰는 2차 추천. files = 프루닝된 상대경로 목록.
 // 임계: dart≥1→flutter, java+kt+gradle≥3→spring, tsx+jsx≥3→react, py≥3→python,
 //       아무것도 없고 ts+js≥3→node. 반환은 메뉴 정의 순서로 정렬.

package/src/core/exclusions.js

@@ -1,7 +1,7 @@
 // 템플릿 다운로드 후 제거하는 항목 (복사 제외 목록).
 // ⚠️ CLAUDE.md "템플릿 전용 파일 추가" 규칙의 동기화 지점:
 //    template_initializer.py(삭제) / 이 파일(복사 제외)
-//    (구 template_integrator.sh/.ps1의 배열은 #458 EOF로 소멸 — 여기가 유일한 복사 제외 지점)
+//    (여기가 유일한 복사 제외 지점)
 export const DOCS_TO_REMOVE = [
   "CONTRIBUTING.md",
   "SECURITY.md",

package/src/core/fsutil.js

@@ -31,10 +31,8 @@ export function remove(p) {
 }
 
 // 디렉토리 직하위 .yaml/.yml 파일명 목록. 하위 폴더 제외.
-// 정렬 순서는 .sh의 glob `"$_dir"/*.yaml "$_dir"/*.yml` 와 일치시킨다:
-// 확장자로 1차 그룹(.yaml 먼저 → .yml 나중), 각 그룹 안에서 알파벳순.
-// (단순 .sort()는 확장자를 섞어 정렬해 .sh와 파일 순회 순서가 갈리고,
-//  그 결과 version.yml deploy 블록의 키 순서까지 달라진다. 확장자 그룹핑으로 바이트 등가 확보.)
+// 정렬: 확장자로 1차 그룹(.yaml 먼저 → .yml 나중), 각 그룹 안에서 알파벳순.
+// (순회 순서가 version.yml deploy 블록의 키 순서를 정함 — 기존 설치본과 바이트 동일 유지)
 export function listYamlFiles(dir) {
   if (!existsSync(dir)) return [];
   const names = readdirSync(dir, { withFileTypes: true })

package/src/core/ide/adapters/claude.js

@@ -1,13 +1,13 @@
-// Claude Code 어댑터 (.sh _manage_claude_section / _do_claude_plugin_install /
-// _remove_claude_section / _remove_claude_plugin_data 등가).
+// Claude Code 어댑터 (플러그인 설치·제거, 플러그인 데이터 정리).
 // 마켓플레이스 Cassiiopeia/projectops, 플러그인 projectops@projectops-marketplace.
 import { join } from "node:path";
 import { existsSync, readdirSync, mkdirSync, cpSync, rmSync } from "node:fs";
 import { compareCacheName } from "../util.js";
 import { migrateConfigRoot } from "../legacy.js";
 import { t } from "../../../i18n/index.js";
+import { TEMPLATE_REPO_SLUG } from "../../paths.js";
 
-const MARKETPLACE = "Cassiiopeia/projectops";
+const MARKETPLACE = TEMPLATE_REPO_SLUG;
 const PLUGIN = "projectops@projectops-marketplace";
 const LEGACY_PLUGINS = ["cassiiopeia@cassiiopeia-marketplace", "cassiiopeia"];
 const LEGACY_MARKETPLACES = ["cassiiopeia-marketplace"];

package/src/core/ide/adapters/codex.js

@@ -1,12 +1,12 @@
-// Codex CLI 어댑터 (.sh _manage_codex_skills / _do_codex_marketplace_register /
-// _remove_codex_section 등가).
+// Codex CLI 어댑터 (skills 관리·마켓플레이스 등록·제거).
 // marketplace 등록/업그레이드가 주 경로. native ~/.agents/skills/projectops 심링크는 감지·제거에 사용.
 import { join } from "node:path";
 import { existsSync, lstatSync, rmSync } from "node:fs";
 import { migrateConfigRoot } from "../legacy.js";
 import { t } from "../../../i18n/index.js";
+import { TEMPLATE_REPO_SLUG } from "../../paths.js";
 
-const MARKETPLACE = "Cassiiopeia/projectops";
+const MARKETPLACE = TEMPLATE_REPO_SLUG;
 const PLUGIN = "projectops";
 const LEGACY_NATIVES = ["SUH-DEVOPS-TEMPLATE"];
 const LEGACY_MARKETPLACES = ["SUH-DEVOPS-TEMPLATE"];

package/src/core/ide/adapters/cursor.js

@@ -1,10 +1,10 @@
-// Cursor 어댑터 (.sh _manage_cursor_section / _do_cursor_skills_copy /
-// _write_cursor_skills_meta / _remove_cursor_section 등가).
+// Cursor 어댑터 (skills 복사·메타 기록·제거).
 // 마켓플레이스 없음 → ~/.cursor/skills/ 에 skills/ 폴더를 복사하고 meta.json으로 버전 추적.
 import { join } from "node:path";
 import { existsSync, readFileSync, mkdirSync, cpSync, rmSync, writeFileSync, readdirSync } from "node:fs";
 import { migrateConfigRoot, isLegacyVersion } from "../legacy.js";
 import { t } from "../../../i18n/index.js";
+import { TEMPLATE_REPO_WEB_URL } from "../../paths.js";
 
 const LEGACY_NAMES = ["cassiiopeia", "suh-devops-template"];
 const LEGACY_MAX_VERSION = "4.2.4";
@@ -127,7 +127,7 @@ function writeMeta(io, destDir, templateVersion) {
   if (existsSync(file)) { try { installedAt = JSON.parse(readFileSync(file, "utf8")).installedAt || now; } catch { /* 무해 */ } }
   const meta = {
     name: "projectops", version, scope: "user",
-    source: "https://github.com/Cassiiopeia/projectops",
+    source: TEMPLATE_REPO_WEB_URL,
     installPath: destDir, installedAt, lastUpdated: now,
   };
   mkdirSync(destDir, { recursive: true });

package/src/core/ide/adapters/gemini.js

@@ -1,15 +1,16 @@
-// Gemini CLI 어댑터 (.sh _manage_gemini_extension / _remove_gemini_section 등가).
+// Gemini CLI 어댑터 (확장 설치·제거).
 // extension install/update/uninstall. 마켓플레이스 대신 git URL 확장.
 import { migrateConfigRoot } from "../legacy.js";
 import { t } from "../../../i18n/index.js";
+import { TEMPLATE_REPO_WEB_URL } from "../../paths.js";
 
 const EXT = "projectops";
-const URL = "https://github.com/Cassiiopeia/projectops";
+const URL = TEMPLATE_REPO_WEB_URL;
 const LEGACY_EXTS = ["SUH-DEVOPS-TEMPLATE"];
 
 function detect(io) {
   if (!io.which("gemini")) return { installed: false, version: null, cliMissing: true, note: t("ide.cliMissing") };
-  // .sh는 gemini 설치 상태를 정밀 조회하지 않고 "설치 가능"으로만 표기 → installed 미상.
+  // gemini 설치 상태는 정밀 조회하지 않고 "설치 가능"으로만 표기 → installed 미상.
   return { installed: false, version: null, cliMissing: false, note: t("ide.installable") };
 }
 

package/src/core/ide/adapters/pi-common.js

@@ -1,11 +1,10 @@
 // PI 공용 경로·상태 로직 (pi 어댑터와 pi-harness 어댑터가 공유).
-// .sh: PI_PACKAGE_URL / _pi_is_installed / _pi_clone_dir / _pi_harness_loader_path /
-//      _pi_settings_path / _pi_harness_enabled 등가.
 import { join } from "node:path";
 import { existsSync, readFileSync, writeFileSync, rmSync } from "node:fs";
 import { t } from "../../../i18n/index.js";
+import { TEMPLATE_REPO_OWNER, TEMPLATE_REPO_WEB_URL } from "../../paths.js";
 
-export const PI_PACKAGE_URL = "https://github.com/Cassiiopeia/projectops";
+export const PI_PACKAGE_URL = TEMPLATE_REPO_WEB_URL;
 
 // 'pi list' 출력에 우리 레포가 잡히면 설치됨. (구 레포명·프로젝트명 모두 허용)
 export function piInstalled(io) {
@@ -17,7 +16,7 @@ export function piInstalled(io) {
 
 // pi 클론 경로(harness loader가 사는 곳). 레포명 변경 전 구 경로 하위호환.
 export function piCloneDir(io) {
-  const base = join(io.home(), ".pi/agent/git/github.com/Cassiiopeia");
+  const base = join(io.home(), ".pi/agent/git/github.com", TEMPLATE_REPO_OWNER);
   const newDir = join(base, "projectops");
   const oldDir = join(base, "SUH-DEVOPS-TEMPLATE");
   return (!existsSync(newDir) && existsSync(oldDir)) ? oldDir : newDir;
@@ -41,8 +40,10 @@ export function harnessAdd(io) {
   const settings = piSettingsPath(io), loader = harnessLoaderPath(io);
   if (!existsSync(settings)) return { ok: false, reason: "no-settings" };
   if (!existsSync(loader)) return { ok: false, reason: "no-loader" };
-  let s = {};
-  try { s = JSON.parse(readFileSync(settings, "utf8")); } catch { s = {}; }
+  let s;
+  // 해석 실패 시 덮어쓰지 않음 ({} 로 쓰면 사용자 설정 키가 전부 지워진다)
+  try { s = JSON.parse(readFileSync(settings, "utf8")); } catch { return { ok: false, reason: "invalid-settings" }; }
+  if (s === null || typeof s !== "object" || Array.isArray(s)) return { ok: false, reason: "invalid-settings" };
   const exts = (Array.isArray(s.extensions) ? s.extensions : []).filter(Boolean);
   if (!exts.includes(loader)) exts.push(loader);
   s.extensions = exts;
@@ -66,7 +67,7 @@ export function harnessRemove(io) {
 // 신·구 clone 공존 시 옛 SUH-DEVOPS-TEMPLATE clone 제거 + settings.json에서 그 loader 경로 제거.
 // 공존일 때만 정리(옛것만 있으면 pi install이 신규를 만들 때까지 그대로 둔다). 실패 무해.
 export function migratePiLegacy(io) {
-  const base = join(io.home(), ".pi/agent/git/github.com/Cassiiopeia");
+  const base = join(io.home(), ".pi/agent/git/github.com", TEMPLATE_REPO_OWNER);
   const oldDir = join(base, "SUH-DEVOPS-TEMPLATE");
   const newDir = join(base, "projectops");
   if (!(existsSync(oldDir) && existsSync(newDir))) return;

package/src/core/ide/adapters/pi-harness.js

@@ -1,8 +1,7 @@
-// PI Persona Harness 어댑터 (.sh _pi_harness_toggle / _pi_harness_remove_only /
-// _pi_harness_add / _pi_harness_remove / _pi_harness_enabled 등가).
+// PI Persona Harness 어댑터 (켜기·끄기·상태 조회).
 // PI skill과 독립 — skill은 그대로 두고 harness 등록(settings.json extensions)만 켜고/끈다.
 import { existsSync } from "node:fs";
-import { harnessEnabled, harnessAdd, harnessRemove, harnessLoaderPath } from "./pi-common.js";
+import { harnessEnabled, harnessAdd, harnessRemove, harnessLoaderPath, piSettingsPath } from "./pi-common.js";
 import { t } from "../../../i18n/index.js";
 
 // 이 어댑터는 "설치 가능" 여부가 pi 존재 + loader 파일 존재에 달림.
@@ -20,7 +19,8 @@ function apply(io) {
   if (harnessEnabled(io)) { io.log(t("ide.harness.already")); return true; }
   const r = harnessAdd(io);
   if (r.ok) { io.log(t("ide.harness.enabledDone")); return true; }
-  io.log(t(r.reason === "no-settings" ? "ide.harness.noSettings" : "ide.harness.needPackage"));
+  const messageKeyByReason = { "no-settings": "ide.harness.noSettings", "invalid-settings": "ide.harness.invalidSettings" };
+  io.log(t(messageKeyByReason[r.reason] ?? "ide.harness.needPackage", { file: piSettingsPath(io) }));
   return false;
 }
 

package/src/core/ide/adapters/pi.js

@@ -1,4 +1,4 @@
-// PI 패키지 어댑터 (.sh _manage_pi_section / _remove_pi_section 등가).
+// PI 패키지 어댑터 (설치·제거).
 // pi install/update/remove. skill은 복사되지 않고 pi가 startup마다 스캔 → 설치 검증은 'pi list'.
 import { PI_PACKAGE_URL, piInstalled, harnessEnabled, harnessRemove, migratePiLegacy } from "./pi-common.js";
 import { migrateConfigRoot } from "../legacy.js";

package/src/core/ide/runner.js

@@ -1,4 +1,4 @@
-// 외부 CLI 실행·감지 래퍼 (.sh command -v / CLI 호출 등가).
+// 외부 CLI 실행·감지 래퍼.
 // 전부 주입 가능 — 테스트는 stub runner/which/home 를 넘겨 실제 CLI 없이 검증한다.
 import { spawnSync } from "node:child_process";
 import { delimiter, join } from "node:path";
@@ -54,6 +54,6 @@ export function defaultIo() {
     which,
     run,
     home: () => homedir(),
-    log: (msg) => console.error(msg), // .sh는 안내를 stderr로 출력
+    log: (msg) => console.error(msg), // 안내는 stderr로 (stdout 파이프 오염 방지)
   };
 }

package/src/core/options-ask.js

@@ -1,5 +1,4 @@
-// 배포/publish 축(#439) + Secret 백업 opt-in 질문 (.sh ask_deploy_publish /
-// ask_optional_workflow / ask_all_optional_workflows 등가).
+// 배포/publish 축(#439) + Secret 백업 opt-in 질문.
 //
 // io 주입 계약(readline-engine 시그니처):
 //   io.confirm({message, initialValue})            → bool | CANCEL(symbol)
@@ -110,7 +109,7 @@ export function migrateProvider(saved) {
 
 const isCancel = (v) => typeof v === "symbol";
 
-// Secret 백업 등 폴더 기반 opt-in 1종 질문 (.sh ask_optional_workflow 등가).
+// Secret 백업 등 폴더 기반 opt-in 1종 질문.
 // 반환: true/false/null(폴더 없음·파일 0개로 질문 자체 생략 → 현재값 유지).
 async function askOptionalWorkflow({ dir, icon, short, desc, current, force, tty, io, forceAsk, say }) {
   // 폴더가 없거나 yaml이 0개면 조용히 건너뜀 — 질문 자체가 성립 안 함
@@ -148,7 +147,7 @@ export const OPTION_AXES = ["intent", "deploy", "publish", "code-review", "chang
 const INTENT_ASKS_DEPLOY = { app: true, both: true, manual: true, library: false, none: false };
 const INTENT_ASKS_PUBLISH = { library: true, both: true, manual: true, app: false, none: false };
 
-// 배포/publish 축 + Secret 백업을 순서대로 질문 (.sh ask_all_optional_workflows 등가).
+// 배포/publish 축 + Secret 백업을 순서대로 질문.
 // tempDir: 템플릿 다운로드 루트 — project-types는 {tempDir}/.github/workflows/project-types
 // current: { deploy: string|null, publish: string[]|null, secretBackup: bool|null } — CLI 명시값
 // scope: null이면 전 축(초기 통합·전체 재질문). Set/배열이면 그 축만 forceAsk 대상 (#483 수정 메뉴 격리).
@@ -204,7 +203,7 @@ export async function askAllOptionalWorkflows({
       if (aiPrSummary === null && saved.aiPrSummary != null) aiPrSummary = saved.aiPrSummary;
       if (changelogProvider === null && saved.changelogProvider !== null) changelogProvider = saved.changelogProvider;
       if (changelogBaseUrl === null && saved.changelogBaseUrl !== null) changelogBaseUrl = saved.changelogBaseUrl;
-      // #456 deploy_branch 저장값 재사용
+      // #456 개발 브랜치 저장값 재사용
       if (deployBranch === null && saved.deployBranch != null) deployBranch = saved.deployBranch;
       // #485 intent 저장값 재사용 — 없으면 저장된 deploy/publish에서 역추론(구 version.yml 하위호환)
       if (intent === null) intent = saved.intent ?? inferIntent(saved.deploy, saved.publish);
@@ -332,9 +331,8 @@ export async function askAllOptionalWorkflows({
   }
 
   // ── pr_comment: PR에 달 리뷰·요약 (#566에서 통합) ──
-  // 종전에는 CodeRabbit 여부만 예/아니오로 물었고, AI 변경 요약은 물어보지도 않은 채
-  // 항상 복사된 뒤 런타임에 스스로 빠졌다. 그 결과 "CodeRabbit도 안 달고 요약도 안 다는"
-  // 저장소가 생겼다. 둘은 같은 자리(PR 댓글)를 놓고 경쟁하므로 한 번에 고르게 한다.
+  // CodeRabbit 과 AI 변경 요약은 같은 자리(PR 댓글)를 놓고 경쟁하므로 한 번에 고르게 한다
+  // (따로 물으면 둘 다 안 다는 저장소가 생긴다).
   if (ask("code-review") || codeReviewCoderabbit === null || aiPrSummary === null) {
     if (force || !tty || typeof io.select !== "function") {
       // 비대화형 기본값: CodeRabbit은 별도 앱 설치가 있어야 실제로 동작하므로
@@ -392,7 +390,7 @@ export async function askAllOptionalWorkflows({
     changelogBaseUrl = "";
   }
 
-  // ── 릴리스 소스(개발) 브랜치 (#456 필드 deploy_branch — 이름과 달리 "개발 브랜치"다, #482) ──
+  // ── 릴리스 소스(개발) 브랜치 (#456, version.yml development_branch — #915) ──
   //    이 값은 릴리스 PR(개발→기본)의 head, 즉 개발한 걸 모아 기본 브랜치로 올리는 브랜치다.
   //    "배포 브랜치"가 아니다 — 배포가 도는 곳은 기본 브랜치(default) 쪽 개념. #482 참조.
   if (ask("release-branch") || deployBranch === null) {

package/src/core/options-schema.js

@@ -47,7 +47,7 @@ export const FLAGS = [
   { flag: "--publish", value: "CSV", values: [...PUBLISH_TARGETS], default: "none",
     description: "Registries a library is published to. Several allowed.", versionYml: "metadata.template.options.publish" },
   { flag: "--deploy-branch", value: "NAME", default: "develop",
-    description: "Development branch: the head of the release PR. Not the repository default branch.", versionYml: "metadata.deploy_branch" },
+    description: "Development branch: the head of the release PR. Not the repository default branch.", versionYml: "metadata.development_branch" },
   { flag: "--language", value: "LANG", values: [...REPO_LANGUAGES], default: "en for new installs, ko for existing installs",
     description: "Language of issue/PR templates and bot messages written into the repo.", versionYml: "metadata.template.options.language" },
   { flag: "--label-style", value: "STYLE", values: [...LABEL_STYLES], default: "en for new installs, ko for existing installs",
@@ -84,8 +84,8 @@ export const VERSION_YML = [
   { path: "project_types", type: "string[]", description: "Project types; the first is primary. Do not change after setup.", edit: "wizard" },
   { path: "project_paths", type: "map", description: "Per-type project folder relative to the repo root (monorepo).", edit: "wizard (--paths)" },
   { path: "metadata.default_branch", type: "string", default: "main", description: "Repository default (production) branch. Pushes here deploy.", edit: "wizard" },
-  { path: "metadata.deploy_branch", parserKey: "deployBranch", type: "string", default: "develop",
-    description: "Development branch: head of the release PR. Despite the name it is NOT where deploys run.", edit: "wizard (--deploy-branch)" },
+  { path: "metadata.development_branch", parserKey: "deployBranch", type: "string", default: "develop",
+    description: "Development branch: head of the release PR. Old name deploy_branch is still read and written with the same value.", edit: "wizard (--deploy-branch)" },
   { path: "metadata.template.options.intent", parserKey: "intent", type: "enum", values: [...INTENT_VALUES],
     description: "Project kind; derives the deploy and publish questions.", edit: "wizard (--intent)" },
   { path: "metadata.template.options.deploy", parserKey: "deploy", type: "enum", values: [...DEPLOY_TARGETS], default: "docker-ssh",
@@ -183,7 +183,7 @@ export const FLAG_DETAILS = {
   },
   "--deploy-branch": {
     when: "Only if your development branch is not named develop.",
-    effect: "Writes metadata.deploy_branch and rewrites the branch name inside the installed workflows (release PR head, CI triggers, PR summary base). The branch is NOT created by this flag.",
+    effect: "Writes metadata.development_branch (and the old deploy_branch with the same value) and rewrites the branch name inside the installed workflows (release PR head, CI triggers, PR summary base). The branch is NOT created by this flag.",
     omitted: "develop.",
     example: "npx projectops --mode full --force --deploy-branch dev",
     caution: "Despite the name this is the development branch (head of the release PR), not the branch that deploys. The deploying branch is the repository default branch.",
@@ -262,7 +262,7 @@ export const KEY_DETAILS = {
   "project_types": { when: "Set by the wizard. Do not change after setup.", effect: "Decides which type workflows run and which build files are synced. The first entry is primary.", omitted: "Detected at install." },
   "project_paths": { when: "Monorepos only.", effect: "Maps a type to its subfolder so version sync and workflow path filters look there.", omitted: "Every type at the repo root." },
   "metadata.default_branch": { when: "Do not edit unless the repository default branch was renamed.", effect: "The branch whose pushes deploy and publish. Workflows trigger on it.", omitted: "main" },
-  "metadata.deploy_branch": { when: "Only if the development branch is not develop.", effect: "Head of the release PR; workflows rewrite their develop references to this name.", omitted: "develop", caution: "Not the deploying branch, despite the name." },
+  "metadata.development_branch": { when: "Only if the development branch is not develop.", effect: "Head of the release PR; workflows rewrite their develop references to this name.", omitted: "develop", caution: "Old name deploy_branch is read when this key is missing. The wizard writes both with the same value; keep them equal if you edit by hand." },
   "metadata.template.options.intent": { when: "Leave as is.", effect: "Remembers the project kind so a re-run does not ask the deploy questions again.", omitted: "Inferred from deploy and publish." },
   "metadata.template.options.deploy": { when: "Edit via --deploy, not by hand.", effect: "Which deploy workflow family is installed on the next update (docker-ssh, vercel, none).", omitted: "docker-ssh for server stacks." },
   "metadata.template.options.publish": { when: "Edit via --publish.", effect: "Which registry publish workflows are installed on the next update.", omitted: "[]" },

package/src/core/paths-resolve.js

@@ -1,5 +1,4 @@
-// 타입별 프로젝트 경로 감지·확정 (.sh find_type_path_candidates L1249~1311 /
-// resolve_project_paths L1362~1589 등가). 모노레포에서 각 타입의 버전 파일이
+// 타입별 프로젝트 경로 감지·확정. 모노레포에서 각 타입의 버전 파일이
 // 어느 폴더에 있는지 5단계 우선순위로 확정한다.
 //
 // io 주입 계약(readline-engine 시그니처 그대로):
@@ -16,8 +15,8 @@ import { normalizePath } from "../cli/args.js";
 // 취소(ESC/Ctrl+C)는 CANCEL 심볼 — ui를 import하지 않고 심볼 여부로만 판정 (core→ui 역참조 방지)
 const isCancel = (v) => typeof v === "symbol";
 
-// 타입의 대표 마커 파일명 (.sh marker_for_type L1220~1229 등가).
-// detect.js는 미지 타입에 package.json을 기본 반환하지만 .sh는 빈 문자열 — 등가를 위해 래핑.
+// 타입의 대표 마커 파일명.
+// detect.js는 미지 타입에 package.json을 기본 반환 — 여기서는 빈 문자열이 되도록 래핑.
 const KNOWN_MARKER_TYPES = new Set([
   "flutter", "react", "node", "react-native", "react-native-expo", "python", "spring",
 ]);
@@ -26,7 +25,7 @@ export function markerForType(type) {
 }
 
 // 디렉토리에 실재하는 마커 파일명 반환 — 보조 마커 포함, 없으면 대표 마커 (표시용).
-// (.sh existing_marker_in_dir L1232~1245: spring build.gradle/.kts/pom.xml, python pyproject/setup.py/requirements.txt)
+// (spring build.gradle/.kts/pom.xml, python pyproject/setup.py/requirements.txt)
 export function existingMarkerInDir(type, dir) {
   const primary = markerForType(type);
   const names = primary ? [primary, ...extraMarkers(type)] : [];
@@ -47,7 +46,7 @@ function walkFindDirs(root, { prune, match, maxDepth = 3 }) {
       const childDepth = depth + 1;
       const childRel = rel ? `${rel}/${e.name}` : e.name;
       if (e.isDirectory()) {
-        // prune 폴더는 하위 전체 제외 (.sh find -prune 등가)
+        // prune 폴더는 하위 전체 제외
         if (prune.has(e.name)) continue;
         // 자식 파일이 depth ≤ maxDepth 안에 들어올 때만 하강
         if (childDepth < maxDepth) walk(childRel, childDepth);
@@ -59,13 +58,13 @@ function walkFindDirs(root, { prune, match, maxDepth = 3 }) {
     }
   };
   walk("", 0);
-  return [...new Set(hits)].sort(); // sort -u 등가
+  return [...new Set(hits)].sort(); // 중복 제거 + 정렬
 }
 
-// 타입별 마커 파일 후보 검색 (.sh find_type_path_candidates L1249~1311 등가).
+// 타입별 마커 파일 후보 검색.
 // 반환: 후보 디렉토리 상대경로 배열 (루트는 ".").
 export function findTypePathCandidates(root, type) {
-  // ── Spring 멀티모듈: settings.gradle(.kts) 폴더 = 모듈 루트로 축약 (.sh L1255~1268) ──
+  // ── Spring 멀티모듈: settings.gradle(.kts) 폴더 = 모듈 루트로 축약 ──
   // version_manager가 그 폴더 아래 build.gradle 전부를 갱신하므로 하위 모듈을 펼치지 않는다.
   // android/ 의 settings.gradle(Flutter/RN)은 spring이 아니므로 prune.
   if (type === "spring") {
@@ -92,7 +91,7 @@ export function findTypePathCandidates(root, type) {
     "node_modules", ".git", "build", "dist", ".dart_tool", "android", "ios",
     ".gradle", "venv", ".venv", "__pycache__",
   ]);
-  // 우선순위 높은 마커에서 발견되면 그것만 사용 (.sh L1281~1288)
+  // 우선순위 높은 마커에서 발견되면 그것만 사용
   let found = [];
   for (const n of names) {
     found = walkFindDirs(root, { prune, match: (name) => name === n });
@@ -101,13 +100,13 @@ export function findTypePathCandidates(root, type) {
 
   return found.filter((d) => {
     if (type === "flutter") {
-      // example/ 제외 + lib/ 동반 확인 — 오탐 방지 (.sh L1298~1303)
+      // example/ 제외 + lib/ 동반 확인 — 오탐 방지
       if (d.includes("example")) return false;
       const libDir = d === "." ? join(root, "lib") : join(root, d, "lib");
       if (!existsSync(libDir)) return false;
     }
     if (type === "spring") {
-      // Flutter/RN의 android/build.gradle 오탐 제외 (.sh L1304~1307)
+      // Flutter/RN의 android/build.gradle 오탐 제외
       if (d.includes("android")) return false;
     }
     return true;
@@ -115,7 +114,7 @@ export function findTypePathCandidates(root, type) {
 }
 
 // 선택된 모든 타입의 경로를 감지·확인하여 Map<type,path> 확정
-// (.sh resolve_project_paths L1362~1589 등가 — 5단계 우선순위).
+// (5단계 우선순위).
 //   ① paths에 이미 있음(--paths) → 유지
 //   ② 루트에 마커 존재 → "." 자동
 //   ③ existingPaths(version.yml 저장값)
@@ -127,11 +126,11 @@ export async function resolveProjectPaths({
 }) {
   const say = io.log || ((m) => process.stderr.write(`${m}\n`));
   const result = new Map(paths); // --paths 사전값 유지 (호출부 Map은 불변)
-  const targets = types.filter((t) => t !== "basic"); // basic은 경로 불필요 (.sh L1400)
+  const targets = types.filter((t) => t !== "basic"); // basic은 경로 불필요
   if (targets.length === 0) return result;
 
   const total = targets.length;
-  // ── 도입부 안내 (.sh L1407~1434 — 감지 결과 + 무엇을 할지 설명) ──
+  // ── 도입부 안내 (감지 결과 + 무엇을 할지 설명) ──
   say("");
   if (total > 1) say(msg("paths.multi", { total }));
   else say(msg("paths.single", { type: targets[0] }));
@@ -145,13 +144,13 @@ export async function resolveProjectPaths({
     idx += 1;
     const prog = `[${idx}/${total}]`;
 
-    // ① --paths 등으로 이미 지정됨 → 최우선 (.sh L1441~1446)
+    // ① --paths 등으로 이미 지정됨 → 최우선
     if (result.get(t)) {
       say(msg("paths.byFlag", { type: t, path: result.get(t) }));
       continue;
     }
 
-    // ② 루트에 마커 존재 → "." 자동 확정 (.sh L1449~1455, 보조 마커 포함)
+    // ② 루트에 마커 존재 → "." 자동 확정 (보조 마커 포함)
     const rootMarker = existingMarkerInDir(t, root);
     if (rootMarker && existsSync(join(root, rootMarker))) {
       result.set(t, ".");
@@ -159,14 +158,14 @@ export async function resolveProjectPaths({
       continue;
     }
 
-    // ③ 기존 version.yml 저장값 → 기본 제안값 (.sh L1458~1466)
+    // ③ 기존 version.yml 저장값 → 기본 제안값
     const existing = existingPaths.get(t) || "";
 
-    // ④ 후보 검색 (.sh L1469~1471)
+    // ④ 후보 검색
     const candidates = findTypePathCandidates(root, t);
     let chosen = "";
 
-    // ── ⑤-a 비대화형 (--force 또는 TTY 없음, .sh L1476~1489) ──
+    // ── ⑤-a 비대화형 (--force 또는 TTY 없음) ──
     if (force || !tty) {
       if (existing) {
         chosen = existing;
@@ -182,7 +181,7 @@ export async function resolveProjectPaths({
       continue;
     }
 
-    // ── ⑤-b 대화형: 후보 개수별 분기 (.sh L1492~1525) + 타입 탈출구 (#487) ──
+    // ── ⑤-b 대화형: 후보 개수별 분기 + 타입 탈출구 (#487) ──
     const EXCLUDE = "이 타입 제외"; // 센티넬 — 한국어 value로 노출 (기존 "직접 입력" 패턴)
     let excluded = false;
     if (candidates.length === 1) {
@@ -206,7 +205,7 @@ export async function resolveProjectPaths({
     } else if (candidates.length > 1) {
       say("");
       say(msg("paths.multiFound", { prog, type: t, count: candidates.length }));
-      // 후보들 + '직접 입력'/'이 타입 제외' 메뉴 — value 자체를 한국어로 (센티넬 노출 방지, .sh L1508~1521)
+      // 후보들 + '직접 입력'/'이 타입 제외' 메뉴 — value 자체를 한국어로 (센티넬 노출 방지)
       const options = candidates.map((c) => ({
         value: c,
         label: `${c} (${existingMarkerInDir(t, c === "." ? root : join(root, c))})`,
@@ -214,7 +213,7 @@ export async function resolveProjectPaths({
       options.push({ value: "직접 입력", label: msg("paths.manual") });
       options.push({ value: EXCLUDE, label: msg("paths.exclude", { type: t }) });
       const sel = await io.select({ message: msg("paths.selectPrompt", { type: t }), options });
-      // ESC(취소)도 직접 입력으로 폴백 (.sh `|| _sel="직접 입력"`)
+      // ESC(취소)도 직접 입력으로 폴백
       if (sel === EXCLUDE) excluded = true;
       else if (!isCancel(sel) && sel != null && sel !== "직접 입력") chosen = sel;
     } else {
@@ -222,7 +221,7 @@ export async function resolveProjectPaths({
       say(msg("paths.notFound", { prog, type: t }));
     }
 
-    // ── 직접 입력 루프 (위에서 미확정 시, .sh L1528~1553) — 제외 탈출구 포함 (#487) ──
+    // ── 직접 입력 루프 (위에서 미확정 시) — 제외 탈출구 포함 (#487) ──
     while (!chosen && !excluded) {
       const hintMarker = existingMarkerInDir(t, root);
       let prompt = msg("paths.inputPrompt", { type: t, marker: hintMarker });
@@ -231,9 +230,9 @@ export async function resolveProjectPaths({
       let input = await io.text({ message: prompt, defaultValue: "" });
       if (isCancel(input) || input == null) input = ""; // ESC → 빈값 (아래 폴백)
       input = String(input).trim();
-      // 빈값 → 기존값 또는 루트 (.sh L1541~1543) — normalizePath 전에 판정
+      // 빈값 → 기존값 또는 루트 — normalizePath 전에 판정
       input = input === "" ? (existing || ".") : normalizePath(input);
-      // 검증: 입력 경로에 마커 존재 확인 (보조 마커 포함, .sh L1544~1552)
+      // 검증: 입력 경로에 마커 존재 확인 (보조 마커 포함)
       const m = existingMarkerInDir(t, input === "." ? root : join(root, input));
       if (m && existsSync(join(root, input === "." ? "" : input, m))) {
         chosen = input;
@@ -262,7 +261,7 @@ export async function resolveProjectPaths({
     say(`  ✅ ${t} → ${chosen}`);
   }
 
-  // ── 요약 + 같은 마커 파일 중복 경고 (.sh L1559~1587) ──
+  // ── 요약 + 같은 마커 파일 중복 경고 ──
   say("");
   say(msg("paths.summary"));
   const fileToTypes = new Map(); // 마커 파일 상대경로 → 그 파일을 쓰는 타입들
@@ -275,7 +274,7 @@ export async function resolveProjectPaths({
   }
   for (const [file, ts] of fileToTypes) {
     if (ts.length > 1) {
-      // 멱등 동작이라 막지는 않고 경고만 (.sh L1577~1586)
+      // 멱등 동작이라 막지는 않고 경고만
       say(msg("paths.duplicate", { types: ts.join(" "), file }));
       say(msg("paths.duplicateNote"));
     }

package/src/core/paths.js

@@ -1,4 +1,4 @@
-// 경로 상수 (.sh readonly 상수군 등가) — template_integrator.sh 113~137
+// 경로 상수
 export const PATHS = {
   tempDir: ".template_download_temp",
   versionFile: "version.yml",
@@ -7,8 +7,12 @@ export const PATHS = {
   projectTypesDir: "project-types",
 };
 
-export const TEMPLATE_RAW_URL = "https://raw.githubusercontent.com/Cassiiopeia/projectops/main";
-export const TEMPLATE_REPO = "https://github.com/Cassiiopeia/projectops.git";
+// 템플릿 레포 주소 정본: 소유자/이름 > 웹·git·raw 주소 (src/ 직접 기재는 no-repo-url-literal 규칙이 막는다)
+export const TEMPLATE_REPO_OWNER = "Cassiiopeia";
+export const TEMPLATE_REPO_SLUG = `${TEMPLATE_REPO_OWNER}/projectops`;
+export const TEMPLATE_REPO_WEB_URL = `https://github.com/${TEMPLATE_REPO_SLUG}`;
+export const TEMPLATE_RAW_URL = `https://raw.githubusercontent.com/${TEMPLATE_REPO_SLUG}/main`;
+export const TEMPLATE_REPO = `${TEMPLATE_REPO_WEB_URL}.git`;
 export const WORKFLOW_PREFIX = "PROJECT";
 export const WORKFLOW_COMMON_PREFIX = "PROJECT-COMMON";
 export const WORKFLOW_TEMPLATE_INIT = "PROJECT-TEMPLATE-INITIALIZER.yaml";

package/src/core/resolve-options.js

@@ -89,3 +89,17 @@ export function resolveOptions({ flags = {}, existing = null, types = [], cwd =
   };
   return { values, sources };
 }
+
+// version.yml options 로 기록되는 값 (resolveOptions 결과 이름 그대로)
+// 진입점(full·version)이 각자 고르면 빠진 옵션이 생성기 기본값으로 되돌아간다 (#909: version 모드 ai_summary false > true)
+const TEMPLATE_OPTION_FIELDS = [
+  "intent", "deployTarget", "publishTargets", "includeSecretBackup", "aiPrSummary", "projectsSync",
+  "changelogProvider", "changelogBaseUrl", "codeReviewCoderabbit", "semverAuto", "appRelease",
+  "excludedWorkflows", "storeLocales", "storeLocalesIos", "storeLocalesPlay", "closeOnRelease", "language", "labelStyle",
+];
+
+/** 실행 context(resolveOptions 값이 펼쳐진 것) > buildVersionYml templateOptions */
+export function toTemplateOptions(context, { mode, optionsDate }) {
+  const options = Object.fromEntries(TEMPLATE_OPTION_FIELDS.map((field) => [field, context[field]]));
+  return { ...options, templateVersion: context.templateVersion, mode, optionsDate };
+}

package/src/core/run-trace.js

@@ -6,7 +6,7 @@ import { join } from "node:path";
 import { writeText } from "./fsutil.js";
 import { getLang } from "../i18n/index.js";
 
-// 진단 로그 위치 (#561). docs/ 아래(추적 대상)에서 옮겼다 — 이 기록은 사람이 읽는 문서가
+// 진단 로그 위치 (#561). 추적되는 docs/ 가 아닌 곳에 둔다 — 이 기록은 사람이 읽는 문서가
 // 아니라 Agent가 "지난 실행에서 무슨 일이 있었나"를 확인하는 자료다.
 // 폴더 안에 .gitignore를 함께 써서 폴더가 자기 규칙을 들고 다닌다(루트 .gitignore 무수정).
 // 형제인 .github/.projectops/baseline.json은 팀원 공유 자산이라 계속 추적된다.