projectops 4.1.1 → 4.1.3

package/README.md

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "4.1.1",
+  "version": "4.1.3",
   "description": "ProjectOps — 완전 자동화 GitHub 프로젝트 관리 템플릿 통합 CLI (구 SUH-DEVOPS-TEMPLATE 마법사)",
   "keywords": [
     "devops",

package/src/cli/args.js

@@ -10,6 +10,7 @@ export function parseArgs(argv) {
     primaryType: "",
     includeNexus: null,      // null=미설정
     includeSecretBackup: null,
+    includeNpmPublish: null,
     pathsCsv: "",            // "flutter=app,react=client" 원문 (정규화는 resolve 단계)
     force: false,
     help: false,
@@ -50,6 +51,8 @@ export function parseArgs(argv) {
       case "--no-nexus": result.includeNexus = false; break;
       case "--secret-backup": result.includeSecretBackup = true; break;
       case "--no-secret-backup": result.includeSecretBackup = false; break;
+      case "--npm-publish": result.includeNpmPublish = true; break;
+      case "--no-npm-publish": result.includeNpmPublish = false; break;
       case "--paths": result.pathsCsv = args.shift() ?? ""; break;
       case "-h": case "--help": result.help = true; break;
       default:

package/src/cli/help.js

@@ -15,6 +15,7 @@ export const HELP_TEXT = `projectops — GitHub 프로젝트 자동화 템플릿
       --paths "t=p,..."    타입별 프로젝트 경로 (모노레포). 예: flutter=app,react=client
       --nexus / --no-nexus            Nexus 라이브러리 publish 워크플로우 포함/제외
       --secret-backup / --no-secret-backup   Secret 백업 워크플로우 포함/제외
+      --npm-publish / --no-npm-publish        npm 패키지 publish 워크플로우 포함/제외
       --force              모든 확인 생략, 비대화형 기본값 사용
   -v, --version            projectops 버전 출력
   -h, --help               이 도움말 표시

package/src/commands/full.js

@@ -22,7 +22,7 @@ import { ensureGitignore } from "../core/copy/gitignore.js";
 export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
   const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
     force = true, now, today, templateVersion = "unknown",
-    includeNexus = false, includeSecretBackup = false } = context;
+    includeNexus = false, includeSecretBackup = false, includeNpmPublish = false } = context;
 
   // project_paths 마커 계산 (.sh existing_marker_in_dir 등가 — 대표 마커명)
   const pathMarkers = new Map();
@@ -38,7 +38,7 @@ export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
     buildVersionYml({
       version, types, paths, pathMarkers, branch, versionCode, now, today,
       deployValues,
-      templateOptions: { templateVersion, includeNexus, includeSecretBackup, optionsDate: today },
+      templateOptions: { templateVersion, includeNexus, includeSecretBackup, includeNpmPublish, optionsDate: today },
     }));
 
   // 2. README 버전 섹션

package/src/commands/interactive.js

@@ -82,6 +82,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     // 선택 워크플로우 초기값: version.yml 저장 옵션 (.sh read_template_options L2361 등가)
     let includeNexus = existing?.options?.nexus ?? false;
     let includeSecretBackup = existing?.options?.secretBackup ?? false;
+    let includeNpmPublish = existing?.options?.npmPublish ?? false;
     const showOptional = mode === "full" || mode === "workflows";
     const realTty = process.stdout.isTTY === true;
 
@@ -92,12 +93,13 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     if (showOptional) {
       const r = await askAllOptionalWorkflows({
         tempDir, types, targetRoot: cwd,
-        current: { nexus: existing?.options?.nexus ?? null, secretBackup: existing?.options?.secretBackup ?? null },
+        current: { nexus: existing?.options?.nexus ?? null, secretBackup: existing?.options?.secretBackup ?? null, npmPublish: existing?.options?.npmPublish ?? null },
         force: false, tty: realTty,
         io: { confirm: ({ message, initialValue }) => io.askYesNo(message, initialValue) },
       });
       includeNexus = r.nexus;
       includeSecretBackup = r.secretBackup;
+      includeNpmPublish = r.npmPublish;
     }
 
     // 확인/수정 루프 — ESC는 '머무르기' (.sh L1877~1881: 명시적 '아니오'만 종료)
@@ -106,9 +108,9 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     while (!confirmed) {
       // 층3 — 프로젝트 분석 개요 카드 (#446). 스텁엔 없음 → note 폴백.
       if (io.analysisCard) {
-        io.analysisCard({ mode, modeLabel: modeLabel(mode), types, version, branch, includeNexus, includeSecretBackup, showOptional, paths });
+        io.analysisCard({ mode, modeLabel: modeLabel(mode), types, version, branch, includeNexus, includeSecretBackup, includeNpmPublish, showOptional, paths });
       } else {
-        io.note?.(summarize({ mode, types, version, branch, includeNexus, includeSecretBackup, showOptional }), "프로젝트 분석 결과");
+        io.note?.(summarize({ mode, types, version, branch, includeNexus, includeSecretBackup, includeNpmPublish, showOptional }), "프로젝트 분석 결과");
       }
       const choice = await io.confirmProjectMenu();
       if (choice === "cancel") { io.cancelMessage?.("설치를 취소했습니다."); return 0; }
@@ -143,6 +145,9 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
         } else if (what === "secret") {
           const y = await io.askYesNo("Secret 백업 워크플로우를 포함할까요?", includeSecretBackup);
           if (!isCancel(y)) includeSecretBackup = y === true;
+        } else if (what === "npm-publish") {
+          const y = await io.askYesNo("npm publish 워크플로우를 포함할까요?", includeNpmPublish);
+          if (!isCancel(y)) includeNpmPublish = y === true;
         }
       }
     }
@@ -171,7 +176,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, includeNexus, includeSecretBackup,
+      mode, force: true, types, version, versionCode, branch, paths, includeNexus, includeSecretBackup, includeNpmPublish,
       repoName, templateVersion, resolvers, envValues, envUseDefaults, now, today,
     });
     ctx.templateVersion = templateVersion;
@@ -222,7 +227,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
   }
 }
 
-function summarize({ mode, types, version, branch, includeNexus, includeSecretBackup, showOptional }) {
+function summarize({ mode, types, version, branch, includeNexus, includeSecretBackup, includeNpmPublish, showOptional }) {
   const lines = [
     `통합 모드 : ${modeLabel(mode)}`,
     `프로젝트 타입 : ${types.join(", ")}${types.length > 1 ? " (멀티)" : ""}`,
@@ -232,6 +237,7 @@ function summarize({ mode, types, version, branch, includeNexus, includeSecretBa
   if (showOptional) {
     lines.push(`Nexus publish : ${includeNexus ? "포함" : "제외"}`);
     lines.push(`Secret 백업 : ${includeSecretBackup ? "포함" : "제외"}`);
+    lines.push(`npm publish : ${includeNpmPublish ? "포함" : "제외"}`);
   }
   return lines.join("\n");
 }

package/src/commands/version.js

@@ -12,7 +12,7 @@ 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;
+    now, today, templateVersion = "unknown", includeNexus = false, includeSecretBackup = false, includeNpmPublish = false } = context;
 
   const pathMarkers = new Map();
   for (const [t] of paths) pathMarkers.set(t, markerForType(t));
@@ -20,7 +20,7 @@ export function runVersion(context, tempDir, targetRoot = ".") {
   writeText(join(targetRoot, PATHS.versionFile),
     buildVersionYml({
       version, types, paths, pathMarkers, branch, versionCode, now, today,
-      templateOptions: { templateVersion, includeNexus, includeSecretBackup, optionsDate: today },
+      templateOptions: { templateVersion, includeNexus, includeSecretBackup, includeNpmPublish, optionsDate: today },
     }));
   addVersionSectionToReadme(version, targetRoot);
   copyScripts(tempDir, targetRoot);

package/src/context.js

@@ -16,6 +16,7 @@ export function createContext(overrides = {}) {
     branch: "",
     paths: new Map(),        // type -> path
     includeNexus: null,      // null=미설정, true/false=명시
+    includeNpmPublish: null, // null=미설정, true/false=명시 (node/npm-publish/)
     includeSecretBackup: null,
     templateVersion: "",
     tempDir: "",

package/src/core/copy/simple.js

@@ -5,9 +5,14 @@ import { chmodSync } from "node:fs";
 import { PATHS } from "../paths.js";
 import { exists, copyFileSync, copyDirSync } from "../fsutil.js";
 
-// version_manager.sh, changelog_manager.py 2개만 무조건 덮어쓰기 + chmod +x.
+// 버전관리/릴리스노트 스크립트만 무조건 덮어쓰기 + chmod +x.
+// version_manager는 .sh(위임 shim) + .py(실 로직) 한 쌍 — 둘 다 복사해야 동작 (#448).
 export function copyScripts(tempDir, targetRoot = ".") {
-  const scripts = ["version_manager.sh", "changelog_manager.py"];
+  const scripts = [
+    "version_manager.sh", "version_manager.py",
+    "changelog_manager.py",
+    "truncate_release_notes.sh", "truncate_release_notes.py",
+  ];
   let copied = 0;
   for (const s of scripts) {
     const src = join(tempDir, PATHS.scriptsDir, s);

package/src/core/copy/workflows.js

@@ -150,7 +150,7 @@ export async function copyWorkflowsInteractive(context, tempDir, targetRoot = ".
 }
 
 function copyWorkflowsForType(type, projectTypesDir, workflowsDir, ctx, counters) {
-  const { includeNexus, force = false, paths = new Map(), repoName = "", resolvers = {}, envOptsFor, collectAsks = null, decisions = new Map() } = ctx;
+  const { includeNexus, includeNpmPublish = false, force = false, paths = new Map(), repoName = "", resolvers = {}, envOptsFor, collectAsks = null, decisions = new Map() } = ctx;
   const typeDir = join(projectTypesDir, type);
   const envOpts = envOptsFor(type);
   let unchangedNames = [];
@@ -195,8 +195,25 @@ function copyWorkflowsForType(type, projectTypesDir, workflowsDir, ctx, counters
     }
   }
 
+  // npm-publish (opt-in — 현재 node/npm-publish/만 존재)
+  const npmPublishDir = join(typeDir, "npm-publish");
+  if (exists(npmPublishDir) && includeNpmPublish) {
+    for (const filename of listYamlFiles(npmPublishDir)) {
+      const src = join(npmPublishDir, filename);
+      const dst = join(workflowsDir, filename);
+      if (existsSync(dst) && isUnchanged(readFileSync(src, "utf8"), readFileSync(dst, "utf8"), envOpts)) {
+        counters.skipped++;
+        continue;
+      }
+      if (existsSync(dst)) renameSync(dst, dst + ".bak");
+      copyFileSync(src, dst);
+      counters.optionalCopied++;
+      counters.copied++;
+    }
+  }
+
   // env 치환 — 이 타입의 원본 디렉토리들에서 복사돼 존재하고 unchanged 아닌 파일만
-  for (const srcDir of [typeDir, serverDeployDir, nexusDir]) {
+  for (const srcDir of [typeDir, serverDeployDir, nexusDir, npmPublishDir]) {
     if (!exists(srcDir)) continue;
     for (const filename of listYamlFiles(srcDir)) {
       const target = join(workflowsDir, filename);

package/src/core/options-ask.js

@@ -49,8 +49,8 @@ async function askOptionalWorkflow({ dir, icon, short, desc, current, force, tty
 // 모든 opt-in 워크플로우를 순서대로 질문 (.sh ask_all_optional_workflows 등가).
 // tempDir: 템플릿 다운로드 루트 — project-types는 {tempDir}/.github/workflows/project-types
 //          (copyWorkflows와 동일 규약. 테스트 픽스처용으로 {tempDir}/project-types 도 허용.)
-// current: { nexus: bool|null, secretBackup: bool|null } — CLI(--nexus 등) 명시값
-// 반환: { nexus: bool, secretBackup: bool } (미결정 null은 false로 확정)
+// current: { nexus: bool|null, secretBackup: bool|null, npmPublish: bool|null } — CLI(--nexus 등) 명시값
+// 반환: { nexus: bool, secretBackup: bool, npmPublish: bool } (미결정 null은 false로 확정)
 export async function askAllOptionalWorkflows({
   tempDir, types = [], current = {}, targetRoot = ".",
   force = false, tty = true, io = {}, forceAsk = false,
@@ -58,6 +58,7 @@ export async function askAllOptionalWorkflows({
   const say = io.log || ((m) => process.stderr.write(`${m}\n`));
   let nexus = current.nexus ?? null;
   let secretBackup = current.secretBackup ?? null;
+  let npmPublish = current.npmPublish ?? null;
 
   // ① --force-ask가 아니면 version.yml 저장값을 먼저 읽어 재질문을 건너뛴다 (.sh L2715~2717).
   //    CLI 명시값(current)이 이미 있으면 그쪽이 우선 — 저장값은 빈 자리만 채운다.
@@ -73,6 +74,10 @@ export async function askAllOptionalWorkflows({
         secretBackup = saved.secretBackup;
         say(`Secret 백업 옵션: version.yml 저장값(${secretBackup}) 유지 — 재질문 생략`);
       }
+      if (npmPublish === null && saved.npmPublish !== null) {
+        npmPublish = saved.npmPublish;
+        say(`npm publish 옵션: version.yml 저장값(${npmPublish}) 유지 — 재질문 생략`);
+      }
     }
   }
 
@@ -88,6 +93,14 @@ export async function askAllOptionalWorkflows({
       current: nexus, force, tty, io, forceAsk, say,
     });
   }
+  // ②-2 npm publish: 각 타입의 npm-publish/ 폴더 (현재 node만 존재)
+  for (const t of types) {
+    npmPublish = await askOptionalWorkflow({
+      dir: join(ptDir, t, "npm-publish"), icon: "📦", short: "npm 패키지 publish",
+      desc: "패키지를 공개 npmjs 레지스트리에 자동 배포하는 워크플로우입니다. npm 라이브러리/CLI 프로젝트에만 필요합니다 (NPM_TOKEN secret 필요).",
+      current: npmPublish, force, tty, io, forceAsk, say,
+    });
+  }
   // ③ Secret 백업: 공통 폴더 (.sh L2726~2729)
   secretBackup = await askOptionalWorkflow({
     dir: join(ptDir, "common", "secret-backup"), icon: "🔐", short: "Secret 서버 백업",
@@ -96,5 +109,5 @@ export async function askAllOptionalWorkflows({
   });
 
   // ④ 미결정(null)은 false로 확정 — .sh에서 빈 INCLUDE_* 가 이후 false 취급되는 것과 동일
-  return { nexus: nexus === true, secretBackup: secretBackup === true };
+  return { nexus: nexus === true, secretBackup: secretBackup === true, npmPublish: npmPublish === true };
 }

package/src/core/version-yml.js

@@ -41,11 +41,11 @@ const HEADER = `# ==============================================================
 `;
 
 // metadata.template.options 상태머신 파싱 (.sh read_template_options L2361~2416 등가).
-// 반환: { nexus: bool|null, secretBackup: bool|null } — null=미기재.
+// 반환: { nexus: bool|null, secretBackup: bool|null, npmPublish: bool|null } — null=미기재.
 // 구 synology 키 등 다른 키는 어느 분기에도 안 걸려 자연히 무시된다.
 // (options-ask.js가 이 함수를 import한다 — 순환 방지 위해 여기(version-yml)에 정의.)
 export function parseTemplateOptions(content) {
-  const out = { nexus: null, secretBackup: null };
+  const out = { nexus: null, secretBackup: null, npmPublish: null };
   // 값 정규화: 따옴표 제거 + 트림 (.sh tr -d '"' | tr -d "'" | xargs 등가)
   const strip = (s) => String(s).replace(/["']/g, "").trim();
   let inTemplate = false;
@@ -68,6 +68,13 @@ export function parseTemplateOptions(content) {
         if (v === "false") out.secretBackup = false;
         continue;
       }
+      m = line.match(/^\s+npm_publish:\s*(.+)/);
+      if (m) {
+        const v = strip(m[1]);
+        if (v === "true") out.npmPublish = true;
+        if (v === "false") out.npmPublish = false;
+        continue;
+      }
       // 들여쓰기 0~4칸의 다른 키 → options 섹션 종료 (.sh L2404~2408)
       if (/^\s{0,4}[a-z_]+:/.test(line)) { inOptions = false; inTemplate = false; }
     }
@@ -170,7 +177,7 @@ export function buildVersionYml({ version, types = [], paths = new Map(), pathMa
 
   // template 옵션 블록 (.sh save_template_options 신규 추가 케이스). templateOptions 지정 시.
   if (templateOptions) {
-    const { templateVersion = "unknown", includeNexus = false, includeSecretBackup = false, optionsDate = today } = templateOptions;
+    const { templateVersion = "unknown", includeNexus = false, includeSecretBackup = false, includeNpmPublish = false, optionsDate = today } = templateOptions;
     out += `  template:\n`;
     out += `    source: "projectops"\n`;
     out += `    version: "${templateVersion}"\n`;
@@ -179,6 +186,7 @@ export function buildVersionYml({ version, types = [], paths = new Map(), pathMa
     out += `    options:\n`;
     out += `      nexus: ${includeNexus}\n`;
     out += `      secret_backup: ${includeSecretBackup}\n`;
+    out += `      npm_publish: ${includeNpmPublish}\n`;
   }
   return out;
 }

package/src/index.js

@@ -108,6 +108,7 @@ export async function run(argv, { cwd = process.cwd(), source = { type: "git" },
     // 옵션 워크플로우: CLI 플래그 최우선 → version.yml 저장 옵션(.sh read_template_options 등가) → false
     includeNexus: opts.includeNexus ?? existing?.options?.nexus ?? false,
     includeSecretBackup: opts.includeSecretBackup ?? existing?.options?.secretBackup ?? false,
+    includeNpmPublish: opts.includeNpmPublish ?? existing?.options?.npmPublish ?? false,
     repoName,
     // 실 resolver 4종 (.sh resolve_token 등가 — spring-app-yml 스텁 제거)
     resolvers: makeResolvers(cwd, repoName, paths),

package/src/ui/prompts.js

@@ -41,6 +41,7 @@ export async function editMenu({ showOptional = false } = {}) {
   if (showOptional) {
     options.push({ value: "nexus", label: "Nexus publish 포함 여부" });
     options.push({ value: "secret", label: "Secret 백업 포함 여부" });
+    options.push({ value: "npm-publish", label: "npm publish 포함 여부" });
   }
   options.push({ value: "done", label: "모두 맞음, 계속" });
   return engine.select({ message: "어떤 항목을 수정할까요?", options });

package/src/ui/status-cards.js

@@ -25,7 +25,7 @@ export function printDetectionLog({ types = [], version = "", branch = "" }, out
 
 // 층3 — 프로젝트 분석 개요 카드 (.ps1 Print-ProjectAnalysis 등가+)
 export function printAnalysisCard({ mode = "", modeLabel = "", types = [], version = "", branch = "",
-  includeNexus = null, includeSecretBackup = null, paths = new Map(), showOptional = false },
+  includeNexus = null, includeSecretBackup = null, includeNpmPublish = null, paths = new Map(), showOptional = false },
   out = (s) => process.stdout.write(s)) {
   out(`${HEAD}  ${paint("프로젝트 분석 결과", A.bold)}\n`);
   const row = (icon, label, value) => out(`${GUT}  ${icon} ${label.padEnd(10)} ${value}\n`);
@@ -36,6 +36,7 @@ export function printAnalysisCard({ mode = "", modeLabel = "", types = [], versi
   if (showOptional) {
     row("📦", "Nexus", includeNexus === true ? paint("포함", A.green) : paint("제외", A.dim));
     row("🔐", "Secret백업", includeSecretBackup === true ? paint("포함", A.green) : paint("제외", A.dim));
+    row("📦", "npm publish", includeNpmPublish === true ? paint("포함", A.green) : paint("제외", A.dim));
   }
   // 모노레포 경로 — 루트가 아닌 항목이 하나라도 있으면 표시
   const nonRoot = [...paths.entries()].filter(([, p]) => p && p !== ".");