projectops 4.72.0 → 4.74.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.71.3 (2026-10-22)
+## Latest version : v4.73.0 (2026-10-22)
 
 [View full version history](CHANGELOG.md)
 
@@ -51,7 +51,7 @@ This project automates your development workflow on two axes.
 | Format every issue by hand | `/pro-github` writes and files an issue from the standard template in one step |
 | Copy the issue URL into commit messages | `/pro-commit` completes the message from the issue context, in your own style |
 | Write PR descriptions and reports by hand | `/pro-report` analyzes the git diff and generates one |
-| Re-type prompts for every code review or analysis | 14 skills give consistent results without re-typing |
+| Re-type prompts for every code review or analysis | 15 skills give consistent results without re-typing |
 
 ---
 
@@ -140,11 +140,11 @@ What it changed: descriptions were cut to short English triggers, a shared contr
 | Part | What it does | Docs |
 |---|---|---|
 | **GitHub Actions** | One push to main handles versioning, changelogs, and CI/CD deployment | [Versioning](https://cassiiopeia.github.io/projectops/version-control) |
-| **Agent Skills** (14) | `/pro-github`, `/pro-commit`, `/pro-report` and more let an AI agent drive each step: issues, commits in your style, reports, release PRs | [Skills guide](https://cassiiopeia.github.io/projectops/skills) |
+| **Agent Skills** (15) | `/pro-github`, `/pro-commit`, `/pro-report` and more let an AI agent drive each step: issues, commits in your style, reports, release PRs | [Skills guide](https://cassiiopeia.github.io/projectops/skills) |
 | **npx CLI** | Installs and updates workflows in an existing project, and diagnoses its state | [CLI reference](https://cassiiopeia.github.io/projectops/cli) |
 
 <details>
-<summary>See all 14 Agent Skills</summary>
+<summary>See all 15 Agent Skills</summary>
 
 ### 🔄 Development cycle automation
 
@@ -168,6 +168,7 @@ What it changed: descriptions were cut to short English triggers, a shared contr
 |------|------|
 | `/pro-figma` | Move a Figma design into code, then compare the result with the design pixel by pixel |
 | `/pro-launch` | Launch, drive, and capture apps, web, and servers: fixed status bar, width changes, response mocking (empty list, failures), render from code |
+| `/pro-desktop-control` | Drive programs on this computer's screen that are not web pages or emulators (installer wizards, OS dialogs, desktop apps): reads elements, presses without moving the mouse, asks before installs, hands security prompts to the user. Windows and macOS (macOS also answers notifications and system dialogs, such as the Apple Account sign-in code) |
 | `/pro-design-brief` | A design request for a screen you built before the mockup exists: state captures, alternatives, copy candidates, and must-keep rules as a board for the designer |
 | `/pro-oss-consult` | Diagnose a GitHub repo as an open-source project: type detection, 6-axis scoring, maturity stage, and edits to About, topics, labels, and files only after approval. One repo or a whole account |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "4.72.0",
+  "version": "4.74.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/full.js

@@ -71,6 +71,8 @@ export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
   // 7. issue / discussion 템플릿
   step("copy-templates", () => {
     copyIssueTemplates(tempDir, targetRoot);
+    // Discussion 템플릿도 오버레이 대상 (#988) — 오버레이보다 먼저 복사해야 한국어판이 덮인다
+    copyDiscussionTemplates(tempDir, targetRoot);
     // 템플릿 언어(#769) — 원본은 영문이라 한국어 레포는 복사 직후 오버레이로 덮는다.
     // 라벨 표기 변환(apply-label-style)보다 반드시 먼저여야 한다.
     const { changed: overlaid, failed: overlayFailed } = applyRepoLanguage(tempDir, targetRoot, language);
@@ -79,7 +81,6 @@ export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
     // 담당자 고정값 제거(#782) — 오버레이가 다시 넣으므로 그 뒤에 한다.
     hooks.trace?.event("copy", "strip-assignees", "", { files: stripIssueTemplateAssignees(targetRoot).length });
     if (overlayFailed.length) console.error(t("language.overlayFailed", { n: overlayFailed.length, files: overlayFailed.map((f) => f.file).join(", ") }));
-    copyDiscussionTemplates(tempDir, targetRoot);
   });
 
   // 8. coderabbit / gitignore / setup guide

package/src/commands/issues.js

@@ -7,9 +7,9 @@ import { copyIssueTemplates, copyDiscussionTemplates, stripIssueTemplateAssignee
 
 export function runIssues(context, tempDir, targetRoot = ".") {
   copyIssueTemplates(tempDir, targetRoot);
+  copyDiscussionTemplates(tempDir, targetRoot); // #988 — 오버레이·라벨 변환 대상이라 그보다 먼저
   const { failed } = applyRepoLanguage(tempDir, targetRoot, context.language ?? "en"); // #769 — 라벨 변환보다 먼저
   if (failed.length) console.error(t("language.overlayFailed", { n: failed.length, files: failed.map((f) => f.file).join(", ") }));
   stripIssueTemplateAssignees(targetRoot); // #782 — 오버레이가 다시 넣으므로 그 뒤에
   applyLabelStyle(targetRoot, context.labelStyle ?? "en"); // #776
-  copyDiscussionTemplates(tempDir, targetRoot);
 }

package/src/core/breaking-check.js

@@ -2,9 +2,9 @@
 // collectBreaking(순수 비교)은 breaking.js — 이 모듈은 로드(원격→clone본 폴백)·표시·확인 게이트.
 import { readFileSync, existsSync } from "node:fs";
 import { join } from "node:path";
-import { collectBreaking } from "./breaking.js";
+import { collectBreaking, localizeBreakingEntry } from "./breaking.js";
 import { parseExisting } from "./version-yml.js";
-import { t } from "../i18n/index.js";
+import { t, getLang } from "../i18n/index.js";
 
 const BC_URL = "https://raw.githubusercontent.com/Cassiiopeia/projectops/main/.github/config/breaking-changes.json";
 
@@ -46,11 +46,13 @@ export async function runBreakingCheck({ cwd, tempDir, templateVersion, askYesNo
   // 요약 리스트 표시 (#473 — 전문 통덤프는 벽글이 되어 정작 CRITICAL이 안 읽혔고,
   // 긴 본문 래핑이 ║ 박스 경계를 붕괴시켰다. 버전·제목만 한 줄씩, 전문은 선택 열람.)
   const e = (s = "") => process.stderr.write(s + "\n");
+  // 화면은 화면 언어 문구 (onItems 로 넘긴 가이드용 항목은 영어 원문 그대로 — 실행 기록은 영어)
+  const localized = (item) => localizeBreakingEntry(item, getLang());
   e("");
   e(t("breaking.title", { current, target: templateVersion, critical: critical.length, warnings: warnings.length }));
   e("");
-  for (const c of critical) e(`  ❗ [CRITICAL] ${c.version} - ${c.title || ""}`);
-  for (const w of warnings) e(`  ⚠️ [WARNING]  ${w.version} - ${w.title || ""}`);
+  for (const c of critical) e(`  ❗ [CRITICAL] ${c.version} - ${localized(c).title}`);
+  for (const w of warnings) e(`  ⚠️ [WARNING]  ${w.version} - ${localized(w).title}`);
   e("");
 
   if (askYesNo) {
@@ -59,8 +61,9 @@ export async function runBreakingCheck({ cwd, tempDir, templateVersion, askYesNo
     if (detail === true) {
       for (const it of [...critical, ...warnings]) {
         e("");
-        e(`■ ${it.version} - ${it.title || ""}`);
-        e(`  ${it.message || ""}`);
+        const { title, message } = localized(it);
+        e(`■ ${it.version} - ${title}`);
+        e(`  ${message}`);
       }
       e("");
     }

package/src/core/breaking.js

@@ -24,3 +24,13 @@ export function collectBreaking(json, current, target) {
   }
   return { critical, warnings };
 }
+
+// 항목 문구 > 화면 언어: ko면 title_ko/message_ko, 없거나 그 외 언어면 영어 원문(title/message)
+// 영어 키가 정본 — 구버전 CLI는 main의 이 파일에서 title/message만 읽음 (#988)
+export function localizeBreakingEntry(entry, lang) {
+  const pickField = (field) => {
+    const koreanText = lang === "ko" ? entry?.[`${field}_ko`] : null;
+    return koreanText || entry?.[field] || "";
+  };
+  return { title: pickField("title"), message: pickField("message") };
+}

package/src/core/development-branch.js

@@ -27,7 +27,8 @@ function manualCommandFor(state, branch, base) {
  */
 export async function createDevelopmentBranchUnattended({ targetRoot = ".", branch = "develop", defaultBranch = "", say = () => {} }) {
   const answerYes = { confirm: async () => true };
-  const outcome = await ensureDeployBranch({ targetRoot, deployBranch: branch, defaultBranch, io: answerYes, say });
+  // 무인 실행: 자격 증명을 묻지 않고 실패시켜 failed 경로(수동 명령)로 보낸다 (#988)
+  const outcome = await ensureDeployBranch({ targetRoot, deployBranch: branch, defaultBranch, io: answerYes, say, isNonInteractive: true });
   const status = STATUS_BY_STATE[outcome.state] ?? "failed";
   return {
     status,

package/src/core/git-branch.js

@@ -2,18 +2,36 @@
 // 모든 함수는 실패 시 조용히 false/null을 반환한다 (git 미설치·비레포·원격 없음에서 마법사가 죽지 않게).
 import { execFileSync } from "node:child_process";
 
-function git(root, args) {
+function git(root, args, env = undefined) {
   try {
-    return execFileSync("git", args, { cwd: root, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+    return execFileSync("git", args, { cwd: root, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], env }).trim();
   } catch { return null; }
 }
 
+/**
+ * 비대화형 원격 접근용 환경 (#988): 자격 증명 질문 차단 > 즉시 실패 > 수동 명령 안내
+ * 차단 4개: 터미널 프롬프트, askpass(GIT_/SSH_), Git Credential Manager 창, ssh 비밀번호 질문
+ * ssh 는 사용자 지정 명령(GIT_SSH_COMMAND·GIT_SSH·core.sshCommand)이 없을 때만 BatchMode 로 덮는다
+ */
+export function nonInteractiveGitEnv(baseEnv = process.env, { hasCustomSshCommand = false } = {}) {
+  const env = { ...baseEnv, GIT_TERMINAL_PROMPT: "0", GIT_ASKPASS: "", SSH_ASKPASS: "", GCM_INTERACTIVE: "never" };
+  if (!hasCustomSshCommand && !baseEnv.GIT_SSH_COMMAND && !baseEnv.GIT_SSH) env.GIT_SSH_COMMAND = "ssh -o BatchMode=yes";
+  return env;
+}
+
+// 원격 명령 환경: 대화형은 상속(undefined), 비대화형은 질문 차단 환경
+function remoteEnv(root, isNonInteractive) {
+  if (!isNonInteractive) return undefined;
+  const hasCustomSshCommand = Boolean(git(root, ["config", "--get", "core.sshCommand"]));
+  return nonInteractiveGitEnv(process.env, { hasCustomSshCommand });
+}
+
 // 브랜치 존재 상태. remote는 origin 조회 실패(원격 없음·네트워크) 시 null(불명).
-export function branchStatus(root, name) {
+export function branchStatus(root, name, { isNonInteractive = false } = {}) {
   const isRepo = git(root, ["rev-parse", "--git-dir"]) !== null;
   if (!isRepo || !name) return { isRepo, local: false, remote: null };
   const local = git(root, ["show-ref", "--verify", `refs/heads/${name}`]) !== null;
-  const ls = git(root, ["ls-remote", "--heads", "origin", name]);
+  const ls = git(root, ["ls-remote", "--heads", "origin", name], remoteEnv(root, isNonInteractive));
   const remote = ls === null ? null : ls.length > 0;
   return { isRepo, local, remote };
 }
@@ -29,6 +47,7 @@ export function createBranch(root, name, fromBranch = "") {
 }
 
 // 원격(origin)에 브랜치 push (-u). 자격/네트워크 실패 시 false.
-export function pushBranch(root, name) {
-  return git(root, ["push", "-u", "origin", name]) !== null;
+// 비대화형은 자격 증명을 묻지 않고 바로 실패 (#988 — 묻는 순간 무인 실행이 멈춘다)
+export function pushBranch(root, name, { isNonInteractive = false } = {}) {
+  return git(root, ["push", "-u", "origin", name], remoteEnv(root, isNonInteractive)) !== null;
 }

package/src/core/ide/skills-copy.js

@@ -16,6 +16,10 @@ const OWNED_SKILL_NAME = /^(pro|suh)-/;
 const SHARED_SCRIPTS_MARKER = join("common", "__init__.py");
 const SHARED_SCRIPTS_DIR_NAME = "scripts";
 const PYTHON_CACHE_DIR_NAME = "__pycache__";
+// 공용 파이썬 중 저장소 관리자만 쓰는 최상위 항목 3개: 안내 문서, 트러블슈팅 색인 생성기, extras 사본 동기화 (#988)
+// 허용 목록이 아니라 제외 목록인 이유: 새 런타임 모듈을 빠뜨리면 스킬이 import 에서 죽지만,
+// 새 개발 파일을 빠뜨리면 파일 하나가 더 갈 뿐이다. 런타임이 쓰는 항목이 여기 들어오면 test/ide-home-install-e2e.test.js 가 잡는다
+export const SHARED_SCRIPTS_DEV_ONLY = new Set(["README.md", "build_troubleshooting.py", "sync_extras.py"]);
 
 // 스킬 소스: 다운로드된 템플릿(TEMP)/skills 우선, 없으면 로컬 skills/
 export function resolveSkillsSrc(ctx = {}) {
@@ -43,11 +47,12 @@ export function readSkillsMeta(metaFile) {
 
 // 소스 최상위 항목 복사 (테스트·conftest 제외). 필터는 소스 기준 상대경로로 본다 —
 // 절대경로로 보면 소스가 ~/test/... 아래에 있을 때 전부 걸러진다.
-function copyEntriesWithoutTests(src, dest) {
+// skipNames: 추가로 빼는 최상위 이름 (공용 파이썬의 개발 전용 항목)
+function copyEntriesWithoutTests(src, dest, skipNames = new Set()) {
   mkdirSync(dest, { recursive: true });
   const copiedNames = [];
   for (const e of readdirSync(src, { withFileTypes: true })) {
-    if (SKIP_IN_COPY.has(e.name) || TEST_PATH.test(e.name)) continue;
+    if (SKIP_IN_COPY.has(e.name) || TEST_PATH.test(e.name) || skipNames.has(e.name)) continue;
     cpSync(join(src, e.name), join(dest, e.name), {
       recursive: true,
       // 이 저장소 자기 코드를 검사하는 테스트는 남의 컴퓨터로 나갈 이유가 없다 (#591).
@@ -79,10 +84,10 @@ export function copySkillsTree(src, dest, metaFileName) {
   return obsoleteNames;
 }
 
-// 공용 파이썬 교체 복사: 지난 설치 항목 제거 > 소스 전체 복사 (폐기 모듈이 남지 않게). 복사한 항목 이름 반환
+// 공용 파이썬 교체 복사: 지난 설치 항목 제거 > 런타임 항목만 복사 (폐기 모듈·예전에 깔린 개발 파일이 남지 않게). 복사한 항목 이름 반환
 function replaceSharedScripts(scriptsSrc, scriptsDest, previousNames) {
   removeNamedEntries(scriptsDest, previousNames);
-  return copyEntriesWithoutTests(scriptsSrc, scriptsDest);
+  return copyEntriesWithoutTests(scriptsSrc, scriptsDest, SHARED_SCRIPTS_DEV_ONLY);
 }
 
 // 이름 목록 + 파이썬 실행이 만든 __pycache__ 삭제 > 폴더가 비면 폴더도 삭제

package/src/core/label-style.js

@@ -69,6 +69,21 @@ export function applyLabelStyle(targetRoot, style) {
     }
   }
 
+  // Discussion 템플릿 기본 라벨 (#988): 맨 위 labels: 목록의 "- 이름" 줄만 대상
+  const discussionDir = join(gh, "DISCUSSION_TEMPLATE");
+  if (existsSync(discussionDir)) {
+    for (const name of readdirSync(discussionDir).filter((f) => /\.ya?ml$/.test(f))) {
+      const f = join(discussionDir, name);
+      if (rewrite(f, (txt) => txt.replace(/^labels:\s*\n((?:[ \t]+-[^\n]*\n)+)/m, (m, list) => {
+        let out = list;
+        for (const [en, ko] of LABEL_PAIRS) {
+          out = out.replace(new RegExp(`^([ \\t]+-[ \\t]*)["']?${quoted(en)}["']?[ \\t]*$`, "gm"), `$1"${ko}"`);
+        }
+        return `labels:\n${out}`;
+      }))) changed.push(`.github/DISCUSSION_TEMPLATE/${name}`);
+    }
+  }
+
   // QA 이슈 생성 봇이 붙이는 기본 라벨
   const bot = join(gh, "workflows", "PROJECT-COMMON-QA-ISSUE-CREATION-BOT.yaml");
   if (rewrite(bot, (txt) => txt.replace(/labels:\s*\['status: todo'\]/g, `labels: ['${EN_TO_KO.get("status: todo")}']`))) {

package/src/core/options-ask.js

@@ -23,9 +23,10 @@ import { DEPLOY_TARGETS, PUBLISH_TARGETS, CHANGELOG_PROVIDERS, DEFAULT_CODE_REVI
 //   null  = 확인 자체를 못 함(비레포·질문 불가) → 안내 유지(보수적)
 // 반환 state (#715 — 비대화형 결과 기록용): not-checked · not-a-repo · exists-local · exists-remote ·
 //   declined · create-failed · push-declined · pushed · push-failed
-export async function ensureDeployBranch({ targetRoot = ".", deployBranch = "", defaultBranch = "", io = {}, say = () => {} }) {
+// isNonInteractive: 원격 조회·push 에서 자격 증명 질문 차단 (#988 — 대화형은 기존 그대로)
+export async function ensureDeployBranch({ targetRoot = ".", deployBranch = "", defaultBranch = "", io = {}, say = () => {}, isNonInteractive = false }) {
   if (!deployBranch || typeof io.confirm !== "function") return { created: false, pushed: false, ready: null, state: "not-checked" };
-  const st = branchStatus(targetRoot, deployBranch);
+  const st = branchStatus(targetRoot, deployBranch, { isNonInteractive });
   if (!st.isRepo) return { created: false, pushed: false, ready: null, state: "not-a-repo" };
   if (st.local) return { created: false, pushed: false, ready: true, state: "exists-local" };
   if (st.remote === true) {
@@ -46,7 +47,7 @@ export async function ensureDeployBranch({ targetRoot = ".", deployBranch = "",
   // #481 — push 질문에 브랜치명 명시 ("어느 브랜치를 push하는지" 불명확 방지)
   const up = await io.confirm({ message: msg("options.branch.pushPrompt", { branch: deployBranch }), initialValue: true });
   if (up !== true) return { created: true, pushed: false, ready: true, state: "push-declined" };
-  if (pushBranch(targetRoot, deployBranch)) {
+  if (pushBranch(targetRoot, deployBranch, { isNonInteractive })) {
     say(msg("options.branch.pushed", { branch: deployBranch }));
     return { created: true, pushed: true, ready: true, state: "pushed" };
   }

package/src/core/options-schema.js

@@ -195,7 +195,7 @@ export const FLAG_DETAILS = {
     effect: "After the install, checks the development branch (--deploy-branch, default develop). Exists locally or on origin: nothing is done. Missing: creates it from the repository default branch (no checkout) and pushes it with git push -u origin <branch>. The result (created, skipped or failed) is printed in the completion summary and recorded in .github/.projectops/logs/ and the migration guide checklist.",
     omitted: "The branch is never created or pushed; the completion summary lists it as a manual step with the command to run.",
     example: "npx projectops --mode full --force --create-development-branch",
-    caution: "It pushes to the remote. A failed push (credentials, network, no origin) does not fail the run: the exit code stays 0 and the summary prints the command to run yourself.",
+    caution: "It pushes to the remote and never asks for credentials (terminal, askpass and ssh password prompts are turned off for that push), so a remote that needs a login fails at once instead of waiting. A failed push (credentials, network, no origin) does not fail the run: the exit code stays 0 and the summary prints the command to run yourself.",
   },
   "--language": {
     when: "Set it only to change the language of an existing repo or to start a new repo in Korean.",