projectops 4.2.13 → 4.2.14

package/README.md

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "4.2.13",
+  "version": "4.2.14",
   "description": "ProjectOps — 완전 자동화 GitHub 프로젝트 관리 템플릿 통합 CLI",
   "keywords": [
     "devops",

package/src/cli/args.js

@@ -3,6 +3,7 @@ import { VALID_TYPES } from "../context.js";
 
 export const DEPLOY_TARGETS = ["docker-ssh", "vercel", "none"];
 export const PUBLISH_TARGETS = ["nexus", "npm", "github-packages"];
+export const INTENT_VALUES = ["app", "library", "both", "none", "manual"];
 
 // argv(process.argv.slice(2)) → 파싱 결과. 오류 시 throw(호출부에서 exit 1).
 export function parseArgs(argv) {
@@ -14,6 +15,7 @@ export function parseArgs(argv) {
     deployTarget: null,      // 배포 축 (#439): docker-ssh|vercel|none, null=미설정
     publishTargets: null,    // publish 축 (#439): 타겟 배열, null=미설정
     deployBranch: "",        // 릴리스 PR head 브랜치 (#456): --deploy-branch, 빈 값=미지정
+    intent: null,            // 프로젝트 성격 (#485): --intent app|library|both|none|manual, null=미설정(역추론)
     includeSecretBackup: null,
     pathsCsv: "",            // "flutter=app,react=client" 원문 (정규화는 resolve 단계)
     force: false,
@@ -79,6 +81,15 @@ export function parseArgs(argv) {
         if (v) result.deployBranch = v;
         break;
       }
+      case "--intent": {
+        // 프로젝트 성격 (#485). 미지정이면 --deploy/--publish에서 역추론.
+        const v = (args.shift() ?? "").trim();
+        if (!INTENT_VALUES.includes(v)) {
+          throw new CliError(`--intent 값은 ${INTENT_VALUES.join(" | ")} 중 하나여야 합니다: '${v}'`);
+        }
+        result.intent = v;
+        break;
+      }
       // ── deprecated alias (1 minor 유지 — #439) ──
       case "--nexus":
         process.stderr.write("⚠️  --nexus는 deprecated입니다. --publish nexus --deploy none 을 사용하세요.\n");

package/src/cli/help.js

@@ -13,6 +13,8 @@ export const HELP_TEXT = `projectops — GitHub 프로젝트 자동화 템플릿
                            (next는 react로 흡수됨 — Next.js 프로젝트는 react 사용)
       --project-version V  통합 대상의 초기 버전 (예: 1.0.0). 미지정 시 자동 감지
       --paths "t=p,..."    타입별 프로젝트 경로 (모노레포). 예: flutter=app,react=client
+      --intent KIND        프로젝트 성격(#485): app | library | both | none | manual
+                           (미지정 시 --deploy/--publish에서 역추론. library/none→deploy 제외, app/none→publish 제외)
       --deploy TARGET      배포 방식 택1: docker-ssh(기본) | vercel | none
       --publish CSV        publish 타겟 csv: nexus,npm,github-packages (기본: 없음)
       --deploy-branch NAME 릴리스 PR head 브랜치 (#456, 기본: develop). default_branch와 별개

package/src/commands/full.js

@@ -24,7 +24,7 @@ export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
     force = true, now, today, templateVersion = "unknown",
     deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false,
     changelogProvider = "github-ai", changelogBaseUrl = "", codeReviewCoderabbit = true,
-    deployBranch = "" } = context;
+    deployBranch = "", intent = null } = context;
 
   // project_paths 마커 계산 (.sh existing_marker_in_dir 등가 — 대표 마커명)
   const pathMarkers = new Map();
@@ -41,7 +41,7 @@ export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
       version, types, paths, pathMarkers, branch, deployBranch, versionCode, now, today,
       deployValues,
       templateOptions: { templateVersion, deployTarget, publishTargets, includeSecretBackup, optionsDate: today,
-        changelogProvider, changelogBaseUrl, codeReviewCoderabbit },
+        changelogProvider, changelogBaseUrl, codeReviewCoderabbit, intent },
     }));
 
   // 2. README 버전 섹션

package/src/commands/interactive.js

@@ -88,6 +88,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     let changelogProvider = existing?.options?.changelogProvider ?? "github-ai";
     let changelogBaseUrl = existing?.options?.changelogBaseUrl ?? "";
     let deployBranch = existing?.options?.deployBranch ?? "develop"; // #456
+    let intent = existing?.options?.intent ?? null; // #485 프로젝트 성격
     const showOptional = mode === "full" || mode === "workflows";
     const realTty = process.stdout.isTTY === true;
 
@@ -104,6 +105,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
           changelogProvider: existing?.options?.changelogProvider ?? null,
           changelogBaseUrl: existing?.options?.changelogBaseUrl ?? null,
           deployBranch: existing?.options?.deployBranch ?? null,
+          intent: existing?.options?.intent ?? null,
         },
         force: false, tty: realTty,
         io: {
@@ -120,6 +122,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
       changelogProvider = r.changelogProvider;
       changelogBaseUrl = r.changelogBaseUrl;
       deployBranch = r.deployBranch;
+      intent = r.intent;
     }
 
     // 확인/수정 루프 — ESC는 '머무르기' (.sh L1877~1881: 명시적 '아니오'만 종료)
@@ -165,7 +168,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
             tempDir, types, targetRoot: cwd, defaultBranch: branch,
             current: {
               deploy: deployTarget, publish: publishTargets, secretBackup: includeSecretBackup,
-              codeReviewCoderabbit, changelogProvider, changelogBaseUrl, deployBranch,
+              codeReviewCoderabbit, changelogProvider, changelogBaseUrl, deployBranch, intent,
             },
             force: false, tty: realTty, forceAsk: true, scope: [what],
             io: {
@@ -182,6 +185,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
           changelogProvider = r.changelogProvider;
           changelogBaseUrl = r.changelogBaseUrl;
           deployBranch = r.deployBranch;
+          intent = r.intent;
         }
       }
     }
@@ -211,7 +215,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,
+      codeReviewCoderabbit, changelogProvider, changelogBaseUrl, deployBranch, intent,
       repoName, templateVersion, resolvers, envValues, envUseDefaults, now, today,
     });
     ctx.templateVersion = templateVersion;

package/src/context.js

@@ -24,6 +24,7 @@ export function createContext(overrides = {}) {
     changelogBaseUrl: null,  // ollama일 때만 값
     codeReviewCoderabbit: null,
     deployBranch: "",        // 릴리스 PR head 브랜치 (#456). 빈 값=metadata.deploy_branch 미출력
+    intent: null,            // 프로젝트 성격 (#485 — app/library/both/none/manual). null=미설정(역추론)
     templateVersion: "",
     tempDir: "",
     deployValues: new Map(), // "type.KEY" -> value

package/src/core/options-ask.js

@@ -10,7 +10,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { listYamlFiles } from "./fsutil.js";
 import { PATHS } from "./paths.js";
-import { parseTemplateOptions } from "./version-yml.js";
+import { parseTemplateOptions, inferIntent } from "./version-yml.js";
 import { branchStatus, createBranch, pushBranch } from "./git-branch.js";
 
 // 개발(배포) 브랜치 존재 확인 + 생성 제안 (#477) — 대화형 전용.
@@ -87,7 +87,12 @@ async function askOptionalWorkflow({ dir, icon, short, desc, current, force, tty
 }
 
 // 옵션 질문의 축 키 (#483 수정 스코프 단위) — 수정 메뉴가 이 단위로 한 축만 재질문한다.
-export const OPTION_AXES = ["deploy", "publish", "code-review", "changelog", "release-branch", "secret"];
+// intent(#485)는 프로젝트 성격 — 재질문 시 deploy/publish 축을 재유도한다.
+export const OPTION_AXES = ["intent", "deploy", "publish", "code-review", "changelog", "release-branch", "secret"];
+
+// intent → 어떤 배포 축을 물을지 (#485). manual은 둘 다(기존 순차 질문), 나머지는 유도.
+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 등가).
 // tempDir: 템플릿 다운로드 루트 — project-types는 {tempDir}/.github/workflows/project-types
@@ -110,6 +115,7 @@ export async function askAllOptionalWorkflows({
   let changelogProvider = current.changelogProvider ?? null;
   let changelogBaseUrl = current.changelogBaseUrl ?? null;
   let deployBranch = current.deployBranch ?? null; // #456 릴리스 PR head 브랜치
+  let intent = current.intent ?? null; // #485 프로젝트 성격 (app/library/both/none/manual)
 
   // basic 단독 타입은 서버 배포도 라이브러리 publish도 개념상 성립하지 않는다.
   // 배포/publish 질문을 건너뛰고 none·[]로 조용히 확정한다 (타입 변경 시 재질문됨).
@@ -140,24 +146,68 @@ export async function askAllOptionalWorkflows({
       if (changelogBaseUrl === null && saved.changelogBaseUrl !== null) changelogBaseUrl = saved.changelogBaseUrl;
       // #456 deploy_branch 저장값 재사용
       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);
     }
   }
 
-  // ── ② 배포 방식 (택1) — basic 단독이면 질문 스킵, none으로 확정 ──
+  // ── ② intent(프로젝트 성격) 우선 분기 → 배포 축 유도 (#485) ──
+  // basic 단독이면 intent 개념 자체가 없어 질문 스킵, none/[]로 확정.
   if (isBasicOnly) {
     if (deploy === null) deploy = "none";
     if (publish === null) publish = [];
+    intent = "none";
   } else {
-    const willAskDeploy = ask("deploy") || deploy === null;
-    const willAskPublish = ask("publish") || publish === null;
-    // #480 — deploy·publish는 서로 다른 두 축이다. 둘 다 물을 참이면 먼저 큰 그림을 한 번 안내한다.
-    // (수정 메뉴로 한 축만 고칠 때는 맥락이 이미 명확하므로 생략)
-    if (willAskDeploy && willAskPublish && tty && typeof io.select === "function") {
+    // 수정 메뉴에서 deploy/publish 축만 콕 집어 고칠 때(scope에 그 축이 있고 intent는 없음)는
+    // intent 질문·게이팅을 건너뛰고 그 축만 바로 편집한다 (#483 격리 존중). intent는 값 유지·역추론.
+    const scopedAxisOnly = scopeSet !== null && !scopeSet.has("intent");
+    if (scopedAxisOnly) {
+      if (intent === null) intent = inferIntent(deploy, publish) ?? "manual";
+    } else {
+      // intent 질문: 미확정이거나(초기 통합) intent 축을 강제 재질문(수정 메뉴 "프로젝트 성격")일 때.
+      const askIntent = ask("intent") || intent === null;
+      if (askIntent) {
+        if (force || !tty || typeof io.select !== "function") {
+          // 비대화형: CLI intent 미지정이면 deploy/publish에서 역추론, 그래도 없으면 manual(기존 동작)
+          intent = intent ?? inferIntent(deploy, publish) ?? "manual";
+        } else {
+          say("");
+          say("🧭 이 프로젝트는 어떤 성격인가요? (배포 관련 질문을 여기에 맞춰 좁혀드립니다)");
+          const ans = await io.select({
+            message: "프로젝트 성격을 선택하세요",
+            options: [
+              { value: "app", label: "서버/호스팅에 올려 돌리는 앱·서비스 (배포만)" },
+              { value: "library", label: "남이 가져다 쓰는 라이브러리/패키지 (publish만)" },
+              { value: "both", label: "둘 다 (서버로도 돌리고 라이브러리로도 냄)" },
+              { value: "none", label: "배포 안 함 (CI·빌드 검증만)" },
+              { value: "manual", label: "직접 하나씩 고를게요 (모든 옵션 개별 질문)" },
+            ],
+          });
+          intent = (!isCancel(ans) && INTENT_ASKS_DEPLOY[ans] !== undefined) ? ans : (intent ?? "manual");
+          say(`프로젝트 성격: ${intent}`);
+        }
+        // intent 확정 후 유도: 안 묻는 축은 값 확정, 묻는 축은 재질문 대상으로 되돌린다.
+        if (!INTENT_ASKS_DEPLOY[intent]) deploy = "none";
+        if (!INTENT_ASKS_PUBLISH[intent]) publish = [];
+        if (INTENT_ASKS_DEPLOY[intent] && ask("intent")) deploy = null;
+        if (INTENT_ASKS_PUBLISH[intent] && ask("intent")) publish = null;
+      }
+    }
+    // intent가 정해진 뒤, 유도 규칙에 따라 각 축을 물을지 결정 (#485).
+    // scopedAxisOnly(수정 메뉴 단일 축)면 intent 게이트를 무시하고 그 축을 편집하게 한다.
+    const deployGate = scopedAxisOnly ? true : INTENT_ASKS_DEPLOY[intent];
+    const publishGate = scopedAxisOnly ? true : INTENT_ASKS_PUBLISH[intent];
+    const willAskDeploy = deployGate && (ask("deploy") || deploy === null);
+    const willAskPublish = publishGate && (ask("publish") || publish === null);
+    // 유도로 안 묻는 축은 기본값 확정.
+    if (!deployGate && deploy === null) deploy = "none";
+    if (!publishGate && publish === null) publish = [];
+    // manual(직접 고르기)에서 둘 다 물을 땐 두 축이 별개임을 한 번 안내 (#480 계승).
+    if (intent === "manual" && willAskDeploy && willAskPublish && tty && typeof io.select === "function") {
       say("");
       say("🧭 배포는 두 가지가 따로 있습니다 — 서로 독립이라 각각 답하시면 됩니다:");
       say("   1) 실행물 배포 — 서버/호스팅에 올려 돌리는 것 (Docker, Vercel …)");
       say("   2) 라이브러리 배포(publish) — 남이 가져다 쓰게 레지스트리에 내는 것 (Nexus, npm …)");
-      say("   먼저 (1) 실행물 배포부터 물어보고, 이어서 (2) 라이브러리 배포를 물어봅니다.");
     }
     if (willAskDeploy) {
       if (force || !tty || typeof io.select !== "function") {
@@ -291,11 +341,15 @@ export async function askAllOptionalWorkflows({
     current: secretBackup, force, tty, io, forceAsk: ask("secret"), say,
   });
 
+  const finalDeploy = deploy ?? "docker-ssh";
+  const finalPublish = publish ?? [];
   return {
-    deploy: deploy ?? "docker-ssh", publish: publish ?? [], secretBackup: secretBackup === true,
+    deploy: finalDeploy, publish: finalPublish, secretBackup: secretBackup === true,
     codeReviewCoderabbit: codeReviewCoderabbit === true,
     changelogProvider: changelogProvider ?? "github-ai",
     changelogBaseUrl: changelogBaseUrl ?? "",
     deployBranch: deployBranch ?? "develop",
+    // #485 intent — 확정값 우선, 없으면 최종 deploy/publish에서 역추론(basic·비대화형 경로 보정)
+    intent: intent ?? inferIntent(finalDeploy, finalPublish) ?? "manual",
   };
 }

package/src/core/version-yml.js

@@ -52,7 +52,7 @@ const HEADER = `# ==============================================================
 export function parseTemplateOptions(content) {
   const out = { deploy: null, publish: null, secretBackup: null,
                 changelogProvider: null, changelogBaseUrl: null, codeReviewCoderabbit: null,
-                deployBranch: null };
+                deployBranch: null, intent: null };
   // deploy_branch는 metadata 직속(#456) — template.options 밖이라 별도로 스캔한다.
   for (const line of String(content || "").split("\n")) {
     if (line.startsWith("#")) continue;
@@ -85,6 +85,14 @@ export function parseTemplateOptions(content) {
         const bm = line.match(/^\s+base_url:\s*(.*)/);
         if (bm) { out.changelogBaseUrl = strip(bm[1]); continue; }
       }
+      // intent(프로젝트 성격, #485) — deploy 라인보다 먼저 매칭 (deploy: 와 intent: 구분).
+      // 값 뒤 인라인 주석(# ...)이 붙으므로 따옴표 안 or 첫 토큰만 취한다.
+      let im = line.match(/^\s+intent:\s*["']?([a-z]+)["']?/);
+      if (im) {
+        const v = im[1];
+        if (["app", "library", "both", "none", "manual"].includes(v)) out.intent = v;
+        continue;
+      }
       let m = line.match(/^\s+deploy:\s*(.+)/);
       if (m) {
         const v = strip(m[1]);
@@ -144,6 +152,22 @@ export function parseTemplateOptions(content) {
   return out;
 }
 
+// deploy/publish 저장값에서 intent(프로젝트 성격) 역추론 (#485 — intent 키 없는 구 version.yml 하위호환).
+//   deploy≠none & publish=[]  → app     (서버/앱만)
+//   deploy=none & publish≠[]  → library (라이브러리만)
+//   deploy≠none & publish≠[]  → both
+//   deploy=none & publish=[]  → none
+// deploy/publish가 아직 null(미설정)이면 intent도 추론 불가 → null 반환(진입 질문을 하도록).
+export function inferIntent(deploy, publish) {
+  if (deploy == null && (publish == null)) return null;
+  const hasServer = deploy != null && deploy !== "none";
+  const hasLib = Array.isArray(publish) && publish.length > 0;
+  if (hasServer && hasLib) return "both";
+  if (hasServer) return "app";
+  if (hasLib) return "library";
+  return "none";
+}
+
 // v4.1.0 이전 단수 project_type 키 → project_types 배열 최소 변환 (#471).
 // version.yml을 재생성하지 않는 경로(workflows 모드)에서 신형 version_manager(단수 키 명시 거부)와의
 // 정합을 맞춘다 — 해당 라인만 교체하고 나머지 내용은 손대지 않는다.
@@ -267,14 +291,17 @@ export function buildVersionYml({ version, types = [], paths = new Map(), pathMa
   // template 옵션 블록 (.sh save_template_options 신규 추가 케이스). templateOptions 지정 시.
   if (templateOptions) {
     const { templateVersion = "unknown", deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false, optionsDate = today,
-            changelogProvider = "github-ai", changelogBaseUrl = "", codeReviewCoderabbit = true } = templateOptions;
+            changelogProvider = "github-ai", changelogBaseUrl = "", codeReviewCoderabbit = true, intent = null } = templateOptions;
     const publishJson = `[${publishTargets.map((t) => `"${t}"`).join(",")}]`;
+    // intent(프로젝트 성격, #485) — 미지정이면 deploy/publish에서 역추론해 기록 (재통합 시 진입 질문 생략용)
+    const intentVal = intent || inferIntent(deployTarget, publishTargets) || "manual";
     out += `  template:\n`;
     out += `    source: "projectops"\n`;
     out += `    version: "${templateVersion}"\n`;
     out += `    integrated_date: "${optionsDate}"\n`;
     out += `    last_update_date: "${optionsDate}"\n`;
     out += `    options:\n`;
+    out += `      intent: "${intentVal}"   # 프로젝트 성격(app/library/both/none/manual) — 배포 질문 유도 기준\n`;
     out += `      deploy: "${deployTarget}"\n`;
     out += `      publish: ${publishJson}\n`;
     out += `      secret_backup: ${includeSecretBackup}\n`;

package/src/index.js

@@ -103,15 +103,26 @@ export async function run(argv, { cwd = process.cwd(), source = { type: "git" },
   const { now, today } = clock || utcNow();
   const tempDir = join(cwd, PATHS.tempDir);
 
+  // 프로젝트 성격(#485): CLI --intent → version.yml 저장값. deploy/publish 유도의 기준.
+  const intent = opts.intent ?? existing?.options?.intent ?? null;
+  // 배포/publish 축(#439): CLI 플래그 최우선 → 저장값 → 기본값. 단 --intent가 명시됐고 해당 축 플래그가
+  //   없으면 intent가 유도한다 (#485 비대화형): library/none이면 deploy=none, app/none이면 publish=[].
+  let deployTarget = opts.deployTarget ?? existing?.options?.deploy ?? "docker-ssh";
+  let publishTargets = opts.publishTargets ?? existing?.options?.publish ?? [];
+  if (opts.intent != null) {
+    if ((intent === "library" || intent === "none") && opts.deployTarget == null) deployTarget = "none";
+    if ((intent === "app" || intent === "none") && opts.publishTargets == null) publishTargets = [];
+  }
+
   const context = createContext({
     mode: opts.mode, force: true, types, version, versionCode, branch,
     paths,
-    // 배포/publish 축(#439): CLI 플래그 최우선 → version.yml 저장 옵션(구 키 자동 마이그레이션) → 기본값
-    deployTarget: opts.deployTarget ?? existing?.options?.deploy ?? "docker-ssh",
-    publishTargets: opts.publishTargets ?? existing?.options?.publish ?? [],
+    deployTarget,
+    publishTargets,
     includeSecretBackup: opts.includeSecretBackup ?? existing?.options?.secretBackup ?? false,
     // 릴리스 배포 브랜치(#456): CLI 플래그 → version.yml 저장값 → 빈 값(미출력, 스킬이 develop 폴백)
     deployBranch: opts.deployBranch || existing?.options?.deployBranch || "",
+    intent,
     // changelog/code_review 축(#455): 비대화형은 저장값 → 기본값. null이 흘러 provider:"null"로 기록되던 버그 수정.
     changelogProvider: existing?.options?.changelogProvider ?? "github-ai",
     changelogBaseUrl: existing?.options?.changelogBaseUrl ?? "",

package/src/ui/prompts.js

@@ -39,6 +39,8 @@ export async function editMenu({ showOptional = false } = {}) {
     { value: "branch", label: "기본 브랜치" },
   ];
   if (showOptional) {
+    // #485 — 프로젝트 성격(intent): 재선택 시 배포/publish 축을 재유도한다.
+    options.push({ value: "intent", label: "프로젝트 성격 (배포 유형)" });
     // #483 — 항목별 격리: 한 축만 골라 그 축만 재질문한다 (통짜 "배포/Publish 방식" 분해)
     options.push({ value: "deploy", label: "배포 방식 (서버 실행물)" });
     options.push({ value: "publish", label: "라이브러리 배포(publish) 타겟" });