projectops 4.28.1 → 4.28.3

package/README.md

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

package/package.json

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

package/src/cli/args.js

@@ -7,7 +7,8 @@ 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"];
 const SEMVER_RE = /^\d+\.\d+\.\d+$/;
-const BRANCH_RE = /^[A-Za-z0-9][A-Za-z0-9._/-]*$/;
+// 유니코드 글자·숫자 허용 (#719) — 공백·셸 메타문자는 문자 클래스에 없어 그대로 거부된다.
+const BRANCH_RE = /^[\p{L}\p{N}][\p{L}\p{N}._/-]*$/u;
 // 허용 실행 모드 (#665) — 오타가 조용히 "복사 0건 성공"으로 끝나지 않게 한다.
 export const MODE_VALUES = ["full", "version", "workflows", "issues", "skills", "doctor", "interactive"];
 
@@ -103,7 +104,7 @@ export function parseArgs(argv) {
         const v = (args.shift() ?? "").trim();
         // 워크플로우 yaml·셸에 그대로 삽입되므로 안전한 브랜치명만 허용 (#676)
         if (v && (!BRANCH_RE.test(v) || v.includes("..") || v.endsWith("/") || v.endsWith(".lock"))) {
-          throw new CliError(`--deploy-branch 값은 영문·숫자·. _ - / 로 이루어진 브랜치명이어야 합니다: '${v}'`);
+          throw new CliError(`--deploy-branch 값은 글자·숫자·. _ - / 로 이루어진 브랜치명이어야 합니다: '${v}'`);
         }
         if (v) result.deployBranch = v;
         break;

package/src/commands/doctor.js

@@ -162,7 +162,16 @@ export function localChecks(cwd = ".") {
 }
 
 // ── 원격 점검 ─────────────────────────────────────────────────────────
-export async function remoteChecks(slug, token, requiredSecrets = []) {
+// permissions 블록을 한 번도 선언하지 않은 워크플로우 — 이때만 저장소 기본 권한(Settings)이 그대로 적용된다.
+// 선언이 있으면 저장소 기본값이 read 여도 선언한 범위로 동작한다 (조직 read 기본값에서 릴리스 automerge 실측, #723).
+export function workflowsWithoutPermissions(cwd = ".") {
+  const wfDir = join(cwd, PATHS.workflowsDir);
+  if (!existsSync(wfDir)) return [];
+  return readdirSync(wfDir).filter((f) => /\.ya?ml$/.test(f))
+    .filter((f) => !/^\s*permissions:/m.test(readFileSync(join(wfDir, f), "utf8")));
+}
+
+export async function remoteChecks(slug, token, requiredSecrets = [], undeclared = []) {
   const rows = [];
   const add = (r) => rows.push(r);
 
@@ -175,15 +184,20 @@ export async function remoteChecks(slug, token, requiredSecrets = []) {
   } else if (perm.data?.default_workflow_permissions === "write") {
     add({ name: "Workflow permissions", purpose: PERM_PURPOSE, status: "OK",
           value: "Read and write permissions" });
+  } else if (undeclared.length === 0) {
+    // 모든 워크플로우가 permissions 를 스스로 선언 → 저장소 기본값(read)은 실제 동작에 영향이 없다
+    add({ name: "Workflow permissions", purpose: PERM_PURPOSE, status: "INFO",
+          value: "읽기 전용 (워크플로우가 권한을 직접 선언해 영향 없음)",
+          detail: ["설치된 워크플로우가 permissions 를 모두 선언하고 있어 기본값이 읽기 전용이어도 정상 동작합니다."] });
   } else {
     add({
       name: "Workflow permissions", purpose: PERM_PURPOSE, status: "WARN",
       value: "Read repository contents permission (읽기 전용)",
       detail: [
-        "워크플로우가 저장소에 쓰거나 다른 워크플로우를 실행할 수 없습니다.",
-        "버전 확정 커밋·릴리스 태그·후속 워크플로우 실행이 전부 실패합니다.",
-        "조치: Settings > Actions > General > Workflow permissions",
-        "      → 'Read and write permissions' 선택",
+        "permissions 선언이 없는 워크플로우는 저장소에 쓰거나 다른 워크플로우를 실행할 수 없습니다.",
+        ...undeclared.map((f) => `  ${f}`),
+        "조치: 해당 파일에 permissions 블록을 추가하거나",
+        "      Settings > Actions > General > Workflow permissions → 'Read and write permissions' 선택",
       ],
     });
   }
@@ -225,7 +239,8 @@ export async function remoteChecks(slug, token, requiredSecrets = []) {
           "AI를 쓰려면 GEMINI_API_KEY(무료)를 등록하세요 — https://aistudio.google.com/apikey",
         ],
       });
-      const missing = requiredSecrets.filter((n) => !have.has(n));
+      // AI 키는 위에서 따로 안내하는 선택 항목이다 — '배포에 필요한 값' 미등록 목록에 섞으면 필수처럼 읽힌다 (#723)
+      const missing = requiredSecrets.filter((n) => !have.has(n) && !(n in AI_KEYS));
       add({
         name: "Secret 등록 여부", purpose: "배포에 필요한 값",
         status: missing.length ? "WARN" : "OK",
@@ -280,7 +295,7 @@ export async function runDoctor({ cwd = ".", token = process.env.GITHUB_TOKEN ||
 
   if (slug && token) {
     const v = verifyInstall(cwd);
-    rows.push(...await remoteChecks(slug, token, [...v.secrets.keys()]));
+    rows.push(...await remoteChecks(slug, token, [...v.secrets.keys()], workflowsWithoutPermissions(cwd)));
   } else if (slug) {
     rows.push({ name: "저장소 설정 점검", purpose: "권한·머지 방식·Secret", status: "INFO",
                 value: "건너뜀 (토큰 없음)",

package/src/core/assets.js

@@ -1,5 +1,6 @@
 // 템플릿 자산 획득 + 제외 적용 (.sh download_template 등가) — template_integrator.sh 2064~2141.
 import { execFileSync } from "node:child_process";
+import { mkdirSync } from "node:fs";
 import { join } from "node:path";
 import { exists, readText, copyDirSync, remove } from "./fsutil.js";
 import { DOCS_TO_REMOVE, PLUGIN_ITEMS_TO_REMOVE } from "./exclusions.js";
@@ -21,6 +22,9 @@ export function acquireTemplate({ tempDir, source = { type: "git" } }) {
     copyDirSync(source.path, tempDir);
   } else {
     const repo = source.repo || TEMPLATE_REPO;
+    // clone 은 stdio 를 버려 실패 원인이 사라진다 — 폴더가 읽기 전용이어도 "내려받지 못했다"로 오도되므로
+    // 먼저 만들어 권한 오류(EACCES/EPERM/EROFS)를 그대로 올린다 (#720). 빈 폴더에는 clone 이 가능하다.
+    mkdirSync(tempDir, { recursive: true });
     execFileSync("git", ["clone", "--depth", "1", "--quiet", repo, tempDir], { stdio: "ignore" });
   }
   applyExclusions(tempDir);

package/src/core/detect-fs.js

@@ -4,7 +4,8 @@ import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { join, basename } from "node:path";
 import { execFileSync } from "node:child_process";
 import { detectTypesFromMarkers, detectVersionFromFiles, suggestTypesByExtScan } from "./detect.js";
-import { parseExisting } from "./version-yml.js";
+import { parseExisting, convertLegacySingularType } from "./version-yml.js";
+import { VALID_TYPES } from "../context.js";
 
 const hasFile = (root) => (rel) => existsSync(join(root, rel));
 const readFile = (root) => (rel) => {
@@ -50,6 +51,10 @@ export function detectTypes(root) {
   if (existsSync(vy)) {
     const { types } = parseExisting(readFileSync(vy, "utf8"));
     if (types.length) return types; // basic 포함, 명시돼 있으면 그대로
+    // v4.1.0 이전 단수 project_type 키 (#718) — 마커가 없어도 명시된 값을 복원한다.
+    // 안 그러면 마커 없는 저장소가 basic 으로 떨어져 기존 타입의 워크플로우가 고아가 된다.
+    const legacy = (convertLegacySingularType(readFileSync(vy, "utf8")) || "").match(/^project_types: \["([a-z-]+)"\]/m);
+    if (legacy && VALID_TYPES.includes(legacy[1])) return [legacy[1]];
   }
   const byMarkers = detectTypesFromMarkers({ has: hasFile(root), read: readFile(root) });
   if (byMarkers.length === 1 && byMarkers[0] === "basic") {