projectops 4.39.0 → 4.41.0

package/README.md

@@ -9,7 +9,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.38.0 (2026-10-10)
+## Latest version : v4.40.0 (2026-10-10)
 
 [View full version history](CHANGELOG.md)
 
@@ -327,6 +327,7 @@ Browse and search everything on the **[docs site](https://cassiiopeia.github.io/
 - [Issues](https://github.com/Cassiiopeia/projectops/issues): bug reports and feature requests
   - Finished issues are marked with the `status: done` label and closed automatically when a release is merged (`close_on_release`).
 - [CONTRIBUTING.md](CONTRIBUTING.md): contribution guide
+- [ARCHITECTURE.md](ARCHITECTURE.md): how the code fits together and how to add a flag, option, provider, language or skill
 - [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md): how we expect everyone to behave, and where to report problems
 - [SECURITY.md](SECURITY.md): please report security vulnerabilities privately, not in a public issue
 

package/package.json

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

package/src/commands/doctor.js

@@ -68,7 +68,10 @@ export function localChecks(cwd = ".") {
   }
 
   add({ name: t("doctor.integ.name"), purpose: t("doctor.integ.purpose"), status: "OK",
-        value: t("doctor.integ.versions", { tpl: existing.templateVersion || "unknown", proj: existing.version }) });
+        // 템플릿 버전이 기록돼 있지 않으면 "vunknown" 이 아니라 사람이 읽는 문구로 — 옛 설치는 version.yml 에 이 값이 없다
+        value: existing.templateVersion
+          ? t("doctor.integ.versions", { tpl: existing.templateVersion, proj: existing.version })
+          : t("doctor.integ.versionsNoTemplate", { proj: existing.version }) });
 
   const wfDir = join(cwd, PATHS.workflowsDir);
   const files = existsSync(wfDir)

package/src/commands/full.js

@@ -30,7 +30,7 @@ export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
     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 } = context;
+    deployBranch = "", intent = null, semverAuto = true , appRelease = null, labelStyle = "en", closeOnRelease = null, projectsSync = null, language = "en", excludedWorkflows = null, storeLocales = null } = context;
 
   // project_paths 마커 계산 (.sh existing_marker_in_dir 등가 — 대표 마커명)
   const pathMarkers = new Map();
@@ -53,7 +53,7 @@ export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
       deployValues,
       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 },
+        changelogProvider, changelogBaseUrl, codeReviewCoderabbit, intent, mode: "full", semverAuto, appRelease, labelStyle, closeOnRelease, projectsSync, language, excludedWorkflows, storeLocales },
     })), { version, versionCode });
 
   // 2. README 버전 섹션

package/src/commands/interactive.js

@@ -144,6 +144,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     // 상태 라벨 표기(#776): 저장값 > (신규 en / 기존 ko). 기존 한글 레포에는 영문 전환을 한 번 제안한다(아래).
     const closeOnRelease = existing?.options?.closeOnRelease ?? (existing ? null : true); // #771 묻지 않는다
     const excludedWorkflows = existing?.options?.excludedWorkflows ?? null; // #810 저장값 보존
+    const storeLocales = existing?.options?.storeLocales ?? null; // #829 저장값 보존
     // Projects 보드 동기화(#716): 묻지 않는다. 저장값 > 이미 설치돼 있으면 유지 > 신규는 제외 (index.js 와 같은 규칙).
     const projectsSync = existing?.options?.projectsSync
       ?? existsSync(join(cwd, ".github/workflows/PROJECT-COMMON-PROJECTS-SYNC-MANAGER.yaml"));
@@ -330,7 +331,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     const { now, today } = clock || utcNow();
     const ctx = createContext({
       mode, force: true, types, version, versionCode, branch, paths, deployTarget, publishTargets, includeSecretBackup,
-      codeReviewCoderabbit, changelogProvider, changelogBaseUrl, deployBranch, intent, semverAuto, appRelease, labelStyle, closeOnRelease, projectsSync, language, excludedWorkflows,
+      codeReviewCoderabbit, changelogProvider, changelogBaseUrl, deployBranch, intent, semverAuto, appRelease, labelStyle, closeOnRelease, projectsSync, language, excludedWorkflows, storeLocales,
       repoName, templateVersion, resolvers, envValues, envUseDefaults, now, today,
       // #502 — version 모드가 기존 full 기록을 강등하지 않도록 (full이 우세)
       recordMode: existing?.templateMode === "full" ? "full" : "version",
@@ -425,7 +426,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
       migrationGuidePath = appendGuideEntry(cwd, {
         now, mode, types, repoName,
         templateFrom: existing?.templateVersion || "", templateTo: templateVersion,
-        options: { deploy: deployTarget, publish: publishTargets, secretBackup: includeSecretBackup, coderabbit: codeReviewCoderabbit, changelogProvider, intent, semverAuto , appRelease, labelStyle, closeOnRelease, projectsSync, language, excludedWorkflows },
+        options: { deploy: deployTarget, publish: publishTargets, secretBackup: includeSecretBackup, coderabbit: codeReviewCoderabbit, changelogProvider, intent, semverAuto , appRelease, labelStyle, closeOnRelease, projectsSync, language, excludedWorkflows, storeLocales },
         branches: { defaultBranch: branch, deployBranch, ready: deployBranchReady, created: deployBranchCreated },
         breaking: breakingReport, migrations: migrationsResult, orphans: orphanReport,
         events: trace.events, counters: { skipped: result?.workflows?.skipped ?? 0 },

package/src/commands/version.js

@@ -17,7 +17,7 @@ export function runVersion(context, tempDir, targetRoot = ".") {
   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 } = context;
+    deployBranch = "", recordMode = "version", semverAuto = true , appRelease = null, labelStyle = "en", closeOnRelease = null, projectsSync = null, language = null, excludedWorkflows = null, storeLocales = null } = context;
 
   const pathMarkers = new Map();
   for (const [t] of paths) pathMarkers.set(t, markerForType(t));
@@ -34,7 +34,7 @@ export function runVersion(context, tempDir, targetRoot = ".") {
       // 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 },
+        changelogProvider, changelogBaseUrl, codeReviewCoderabbit, mode: recordMode, semverAuto, appRelease, labelStyle, closeOnRelease, projectsSync, language, excludedWorkflows, storeLocales },
     }));
   addVersionSectionToReadme(version, targetRoot);
   copyScripts(tempDir, targetRoot);

package/src/context.js

@@ -32,6 +32,7 @@ export function createContext(overrides = {}) {
     language: null,          // 레포 문구 언어 (#769). null=미설정(신규 en / 기존 레포 ko)
     labelStyle: null,        // 상태 라벨 표기 (#776). null=미설정(신규 en / 기존 레포 ko)
     excludedWorkflows: null, // 설치하지 않을 워크플로우 파일명 (#810). null=없음
+    storeLocales: null,      // 스토어 릴리스 노트 언어 (#829). null=미설정 → 현행 동작 유지
     appRelease: null,        // 앱 심사 배포 레포인가 (#553). null=미설정(키 기록 안 함)
     templateVersion: "",
     tempDir: "",

package/src/core/copy/simple.js

@@ -37,6 +37,8 @@ export function copyScripts(tempDir, targetRoot = ".") {
     "close_issues_on_release.py",
     // Play Store/TestFlight 배포 모드를 코드 설정(.github/config/store-deploy.json)에서 읽는다 (#767).
     "store_deploy_config.py",
+    // 스토어 릴리스 노트를 언어별로 준비 (#829). version.yml 의 store_locales 가 없으면 아무것도 하지 않는다.
+    "store_notes.py",
     "changelog_providers/_common.py", "changelog_providers/ladder.py",
     "changelog_providers/commit.py", "changelog_providers/copilot.py",
     "changelog_providers/openai_compatible.py",

package/src/core/copy/workflows.js

@@ -1,7 +1,10 @@
-// 워크플로우 복사 엔진 (.sh copy_workflows + _copy_workflows_for_type 등가).
-// 실측: template_integrator.sh 3398~3815.
-// 대화형 3지선(기존 파일 충돌)은 copyWorkflowsInteractive(async)가 결정 Map을 만들어
-// 동기 엔진(copyWorkflows)에 hooks.decisions로 전달한다 — 기존 시그니처·force 동작 무변경.
+// 워크플로우 복사 엔진. 구 template_integrator.sh(#458 로 삭제됨)의 copy_workflows 를 포팅한 것이다.
+// 파일 안의 ".sh ... 등가" 표기는 그 삭제된 스크립트를 가리킨다 — 줄 번호는 더 이상 찾을 수 없다.
+//
+// 충돌(기존 파일과 다름)의 처리 결정은 hooks.decisions(Map<파일명, 'skip'|'backup'|'template'>)로 받는다.
+//   - 실제 마법사(commands/interactive.js)는 listWorkflowConflicts 로 충돌 목록을 얻어 직접 Map 을 만든다.
+//   - copyWorkflowsInteractive 는 onConflict 콜백으로 같은 Map 을 만들어 주는 보조 API 다. 프로덕션 경로는 쓰지 않고
+//     테스트(copy-workflows-conflict.test.js)만 쓴다.
 import { join, basename } from "node:path";
 import { existsSync, readFileSync, writeFileSync, renameSync } from "node:fs";
 import { PATHS } from "../paths.js";
@@ -378,7 +381,7 @@ function applyDecision(decision, srcDir, workflowsDir, filename, counters, trace
   });
 }
 
-// 대상 워크플로우 디렉토리에서 changed(충돌) 파일 목록만 뽑는다 — copyWorkflowsInteractive의 사전 조사용.
+// 대상 워크플로우 디렉토리에서 changed(충돌) 파일 목록만 뽑는다 — 마법사(commands/interactive.js)와 copyWorkflowsInteractive 가 쓴다.
 // copyWorkflows 본체와 동일한 classify 기준을 써야 결정 Map이 실제 처리 대상과 1:1로 맞는다.
 export function listWorkflowConflicts(context, tempDir, targetRoot = ".") {
   const { types = [], paths = new Map(), deployTarget = "docker-ssh", repoName = "", resolvers = {}, branch = "", deployBranch = "" } = context;

package/src/core/exclusions.js

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

package/src/core/migrations/registry.js

@@ -11,7 +11,8 @@
 //   tier       - "safe"    : 신형이 같은 기능을 대체(순수 리네임). 공존 시 이중 트리거 실해
 //                            → 확인 1회 후 자동 무해화(.bak) / 삭제
 //                "confirm" : 배포 파이프라인일 수 있음(그 레포의 유일한 현역 배포 가능성)
-//                            → 자동으로 건드리지 않고 안내만. --force에서도 불변
+//                            → 기본은 건드리지 않고 완료 요약·doctor 에 목록만 안내한다.
+//                              --remove-legacy(비대화형) 또는 대화형 확인(기본 아니오)이 있을 때만 .bak 으로 무해화 (#809)
 //                "ask"     : 사용자 콘텐츠가 담긴 폴더 등 — 손실 없는 이동이지만 사용자 소유물 (#476)
 //                            → 대화형: 확인 후 이동 / 비대화형: 자동 조치 없이 안내만
 //   file       - 정확한 파일명 (글롭 금지 — 사용자 커스텀 보호의 핵심)

package/src/core/options-schema.js

@@ -105,6 +105,9 @@ export const VERSION_YML = [
   { path: "metadata.template.options.excluded_workflows", parserKey: "excludedWorkflows", type: "string[]",
     description: "Workflow file names the update must never install. Deleted files are also not restored; a copy is kept in .github/.projectops/incoming/.",
     edit: "by hand" },
+  { path: "metadata.template.options.store_locales", parserKey: "storeLocales", type: "string[]",
+    description: "Store release-note languages, first is the default (for example [\"ko-KR\", \"en-US\", \"ja-JP\", \"zh-CN\"]). Missing = one text for every store language, as before. Per-language text comes from store_notes in CHANGELOG.json; a language without text gets the default-language text (the stores reject an empty What's New).",
+    edit: "by hand" },
   { path: "metadata.template.options.code_review.coderabbit", parserKey: "codeReviewCoderabbit", type: "boolean", description: "CodeRabbit config installed.", edit: "wizard" },
   { path: "metadata.template.options.code_review.ai_summary", parserKey: "aiPrSummary", type: "boolean", default: true, description: "AI PR summary workflow installed.", edit: "wizard (--ai-summary)" },
   { path: "metadata.template.options.changelog.provider", parserKey: "changelogProvider", type: "enum",

package/src/core/version-yml.js

@@ -115,6 +115,7 @@ const COMMENTS = {
     appRelease: "whether releases go through App Store / Play Store review",
     deploy: "deploy settings remembered by the wizard (non-sensitive, safe to edit by hand)",
     excluded: "workflow files the update must never install (safe to edit by hand)",
+    storeLocales: "store release-note languages, first is the default (missing = one text for every store language)",
   },
   ko: {
     versionCode: "app build number",
@@ -130,6 +131,7 @@ const COMMENTS = {
     appRelease: "앱스토어·플레이스토어 심사로 이어지는 배포인가",
     deploy: "마법사가 기억하는 배포 설정 (비민감 / 직접 수정 가능)",
     excluded: "업데이트가 절대 설치하지 않을 워크플로우 파일 (직접 수정 가능)",
+    storeLocales: "스토어 릴리스 노트 언어 목록, 첫 항목이 기본 언어 (미기재면 모든 스토어 언어에 같은 문구)",
   },
 };
 const commentsFor = (lang) => COMMENTS[lang === "ko" ? "ko" : "en"];
@@ -158,7 +160,7 @@ export function resolveUpdatedBy(existingContent = "", cwd = ".") {
 export function parseTemplateOptions(content) {
   const out = { deploy: null, publish: null, secretBackup: null,
                 changelogProvider: null, changelogBaseUrl: null, codeReviewCoderabbit: null, aiPrSummary: null, projectsSync: null,
-                deployBranch: null, intent: null, semverAuto: null, appRelease: null, labelStyle: null, closeOnRelease: null, language: null, excludedWorkflows: null };
+                deployBranch: null, intent: null, semverAuto: null, appRelease: null, labelStyle: null, closeOnRelease: null, language: null, excludedWorkflows: null, storeLocales: null };
   // deploy_branch는 metadata 직속(#456) — template.options 밖이라 별도로 스캔한다.
   for (const line of String(content || "").split("\n")) {
     if (line.startsWith("#")) continue;
@@ -266,6 +268,12 @@ export function parseTemplateOptions(content) {
         out.excludedWorkflows = m[1].split(",").map((s) => s.trim().replace(/^["']|["']$/g, "")).filter(Boolean);
         continue;
       }
+      // 스토어 릴리스 노트 언어 (#829) — 인라인 배열, 첫 항목이 기본 언어. 미기재면 현행 동작(한 문구를 모든 언어에).
+      m = line.match(/^\s+store_locales:\s*\[([^\]]*)\]/);
+      if (m) {
+        out.storeLocales = m[1].split(",").map((s) => s.trim().replace(/^["']|["']$/g, "")).filter(Boolean);
+        continue;
+      }
       // 프로젝트 성격(#553) — 앱 심사로 이어지는 레포인가. 워크플로우와 스킬이 같은 값을 본다.
       m = line.match(/^\s+app_release:\s*["']?(true|false)["']?/);
       if (m) {
@@ -470,7 +478,7 @@ export function buildVersionYml({ version, types = [], paths = new Map(), pathMa
   if (templateOptions) {
     const { templateVersion = "unknown", deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false, optionsDate = today,
             changelogProvider = "commit", changelogBaseUrl = "", codeReviewCoderabbit = true, aiPrSummary = true, intent = null, mode = null,
-            semverAuto = true, appRelease = null, labelStyle = null, closeOnRelease = null, projectsSync = null, language = null, excludedWorkflows = null } = templateOptions;
+            semverAuto = true, appRelease = null, labelStyle = null, closeOnRelease = null, projectsSync = null, language = null, excludedWorkflows = null, storeLocales = null } = templateOptions;
     const publishJson = `[${publishTargets.map((t) => `"${t}"`).join(",")}]`;
     // intent(프로젝트 성격, #485) — 미지정이면 deploy/publish에서 역추론해 기록 (재통합 시 진입 질문 생략용)
     const intentVal = intent || inferIntent(deployTarget, publishTargets) || "manual";
@@ -496,6 +504,8 @@ export function buildVersionYml({ version, types = [], paths = new Map(), pathMa
     // 레포 문구 언어(#769) — 미지정이면 키를 쓰지 않는다(기존 레포 무변화).
     // 설치 제외 목록(#810) — 전체 재생성이라 다시 쓰지 않으면 사용자가 적은 목록이 사라진다.
     if (excludedWorkflows && excludedWorkflows.length) out += `      excluded_workflows: [${excludedWorkflows.map((f) => `"${f}"`).join(", ")}]   # ${C.excluded}\n`;
+    // 스토어 릴리스 노트 언어(#829) — 미지정이면 키를 쓰지 않는다. 전체 재생성이라 다시 쓰지 않으면 사용자가 적은 값이 사라진다.
+    if (storeLocales && storeLocales.length) out += `      store_locales: [${storeLocales.map((l) => `"${l}"`).join(", ")}]   # ${C.storeLocales}\n`;
     if (language) out += `      language: ${language}   # ${C.language}\n`;
     if (labelStyle) out += `      label_style: ${labelStyle}   # ${C.labelStyle}\n`;
     // 앱 심사 배포 레포 여부(#553) — 미지정이면 키를 쓰지 않는다(기존 레포 무변화).

package/src/i18n/doctor.en.js

@@ -7,6 +7,7 @@ export default {
   "doctor.integ.notIntegrated": "The template is not integrated in this folder.",
   "doctor.integ.howTo": "To integrate: npx projectops",
   "doctor.integ.versions": "Template v{tpl} / Project v{proj}",
+  "doctor.integ.versionsNoTemplate": "Template version not recorded / Project v{proj}",
   "doctor.wf.name": "Installed workflows",
   "doctor.wf.purpose": "Automation running in this repository",
   "doctor.count": "{n}",

package/src/i18n/doctor.ko.js

@@ -7,6 +7,7 @@ export default {
   "doctor.integ.notIntegrated": "이 폴더에는 템플릿이 통합되어 있지 않습니다.",
   "doctor.integ.howTo": "통합하려면: npx projectops",
   "doctor.integ.versions": "템플릿 v{tpl} / 프로젝트 v{proj}",
+  "doctor.integ.versionsNoTemplate": "템플릿 버전 기록 없음 / 프로젝트 v{proj}",
   "doctor.wf.name": "설치된 워크플로우",
   "doctor.wf.purpose": "이 저장소에서 도는 자동화",
   "doctor.count": "{n}개",

package/src/index.js

@@ -260,6 +260,7 @@ async function runCore(argv, { cwd = process.cwd(), source = { type: "git" }, cl
     // (사용자가 version.yml에 직접 쓰거나 스킬이 기록한 값을 그대로 유지).
     appRelease: existing?.options?.appRelease ?? null,
     excludedWorkflows: existing?.options?.excludedWorkflows ?? null, // #810 저장값 보존
+    storeLocales: existing?.options?.storeLocales ?? null, // #829 저장값 보존 (전체 재생성이라 안 넘기면 사라진다)
     // 상태 라벨 표기(#776): 플래그 > 저장값 > (신규 en / 기존 ko). 기존 레포의 라벨 이름은 업데이트만으로 바뀌지 않는다.
     // 릴리스 시 완료 이슈 닫기(#771): 저장값 보존, 없으면 신규만 true. 기존 레포는 키를 만들지 않아 현행 유지.
     closeOnRelease: existing?.options?.closeOnRelease ?? (existing ? null : true),
@@ -361,7 +362,7 @@ async function runCore(argv, { cwd = process.cwd(), source = { type: "git" }, cl
       migrationGuidePath = appendGuideEntry(cwd, {
         now, mode: opts.mode, types, repoName,
         templateFrom: existing?.templateVersion || "", templateTo: context.templateVersion,
-        options: { deploy: deployTarget, publish: publishTargets, secretBackup: context.includeSecretBackup, coderabbit: context.codeReviewCoderabbit, changelogProvider: context.changelogProvider, intent, semverAuto: context.semverAuto , appRelease: context.appRelease, language: context.language, labelStyle: context.labelStyle, closeOnRelease: context.closeOnRelease, projectsSync: context.projectsSync, excludedWorkflows: context.excludedWorkflows },
+        options: { deploy: deployTarget, publish: publishTargets, secretBackup: context.includeSecretBackup, coderabbit: context.codeReviewCoderabbit, changelogProvider: context.changelogProvider, intent, semverAuto: context.semverAuto , appRelease: context.appRelease, language: context.language, labelStyle: context.labelStyle, closeOnRelease: context.closeOnRelease, projectsSync: context.projectsSync, excludedWorkflows: context.excludedWorkflows, storeLocales: context.storeLocales },
         branches: { defaultBranch: branch, deployBranch: context.deployBranch || "develop", ready: null, created: null },
         breaking: breakingReport, migrations: migrationsResult, orphans: { cleaned: [], pending: orphanPending },
         events: trace.events, counters: { skipped: result?.workflows?.skipped ?? 0 },