projectops 4.84.0 → 4.85.0

package/README.md

@@ -8,10 +8,10 @@
 
 [![npm](https://img.shields.io/npm/v/projectops?label=npm)](https://www.npmjs.com/package/projectops) [![Release](https://img.shields.io/github/v/release/Cassiiopeia/projectops?label=release)](https://github.com/Cassiiopeia/projectops/releases) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![Docs](https://img.shields.io/badge/docs-site-4f46e5)](https://cassiiopeia.github.io/projectops/)
 
-**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)).
+**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. Note that `npx projectops@<version>` pins the installer only (workflow templates always come from the current `main`) ([releases](https://github.com/Cassiiopeia/projectops/releases)).
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## Latest version : v4.83.0 (2026-11-04)
+## Latest version : v4.84.0 (2026-11-04)
 
 [View full version history](CHANGELOG.md)
 
@@ -28,7 +28,7 @@
 | Install Agent Skills only | `npx projectops --mode skills` |
 | Check the install state (read-only) | `npx projectops --mode doctor` |
 
-> You only need Node.js 20.12+. An interactive wizard runs with no separate install.
+> You need Node.js 20.12+ and Git (Agent Skills also need Python 3). An interactive wizard runs with no separate install.
 
 ![npx projectops interactive wizard](https://raw.githubusercontent.com/Cassiiopeia/projectops/main/docs/images/cli-wizard.gif)
 
@@ -40,7 +40,7 @@
 
 This project automates your development workflow on two axes.
 
-**① GitHub Actions**: one push to main handles versioning, changelogs, and CI/CD deployment.
+**① GitHub Actions**: a develop-to-main release PR handles versioning and changelogs; merging it runs CI/CD deployment.
 **② Agent Skills**: commands such as `/pro-github`, `/pro-commit`, and `/pro-report` let an AI agent drive each step of that automation for you: issues, commits in your own style, reports, and release PRs.
 
 | The usual way | With Projectops |
@@ -64,15 +64,15 @@ If you only need one piece of this, a smaller tool may suit you better.
 | Version decided from | Commit titles (`feat` → minor, `feat!` → major) | Conventional Commits | Conventional Commits (configurable) | Changeset files written in each PR |
 | Review step before a release | A release PR (develop → main), merged automatically | A release PR you merge | None by default, releases on push | A "Version Packages" PR |
 | Changelog | Written in the release PR (commit analysis, or an AI summary) | Generated | Generated (plugin) | Assembled from changeset files |
-| CI/CD workflows for your project type | Yes (Spring, Flutter, React, Node, Python ...) | No | No | No |
+| CI/CD workflows for your project type | Yes (Spring, Flutter, React, Python; npm publish for Node) | No | No | No |
 | Agent skills that run the cycle (issues, worktrees, commits in your style, reports, release PRs, real-device QA) | Yes | No | No | No |
-| What it adds to your repo | About 50 files (below) | A workflow and a config file | A config file and a CI step | A `.changeset/` folder and a CI step |
+| What it adds to your repo | About 60 files (below) | A workflow and a config file | A config file and a CI step | A `.changeset/` folder and a CI step |
 
 - Want only versioning and a changelog? release-please or semantic-release is smaller.
 - Publishing npm packages from a monorepo where each PR should say what changed? changesets fits better.
 - Want the whole cycle (issue → branch → release PR → deploy) in one install, with agent skills on top? That is what projectops is for.
 
-**Footprint, measured.** With v4.36.2 on 2026-10-08, `npx projectops --mode full --type basic --force` in an empty repository added 52 files: 8 workflows, 26 helper scripts under `.github/scripts/`, issue, PR and discussion templates, `version.yml` and a setup guide. `--type spring` added 56 files (12 workflows).
+**Footprint, measured.** With v4.84.0 on 2026-11-05, `npx projectops --mode full --type basic --force` in an empty repository added 56 files: 8 workflows, 30 helper scripts under `.github/scripts/`, issue, PR and discussion templates, `version.yml` and a setup guide. `--type spring` added 60 files (12 workflows).
 
 ---
 
@@ -128,10 +128,9 @@ We ran `/pro-oss-consult` on this repo, then fixed what it found (measured 2026-
 |---|---|---|
 | Skill count stated in README and manifests | inconsistent (15 vs 20 stated, actual 15) | consistent: 14 core + 1 in the optional extras plugin |
 | Longest skill description | 1,183 chars; 6 over 1,000 | 237 chars; 0 over 300 |
-| Skills with no tests (all 15 skills) | 6 | 0 (56 contract test cases cover all 15 skills, 14 core + 1 extras) |
 | Commit format | hardcoded in `pro-commit` | configurable via preferences and `version.yml` |
 
-What it changed: descriptions were cut to short English triggers, a shared contract test now checks every skill, and `pro-commit` follows your team's `version.yml` commit template.
+What it changed: descriptions were cut to short English triggers, a guard test now checks every core skill's docs, and `pro-commit` follows your team's `version.yml` commit template.
 
 ---
 
@@ -139,7 +138,7 @@ 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) |
+| **GitHub Actions** | A develop-to-main release PR handles versioning and changelogs; merging it runs CI/CD deployment | [Versioning](https://cassiiopeia.github.io/projectops/version-control) |
 | **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) |
 
@@ -270,7 +269,7 @@ npx projectops --mode skills
 | `spring` | build.gradle | SSH + Docker deploy, Nexus |
 | `flutter` | pubspec.yaml | TestFlight, Play Store |
 | `react` (including Next.js) | package.json | Docker |
-| `node` | package.json | Docker |
+| `node` | package.json | npm publish (`--publish npm`) |
 | `python` | pyproject.toml | SSH + Docker deploy |
 | `react-native` | Info.plist + build.gradle | — |
 | `react-native-expo` | app.json | — |
@@ -334,8 +333,8 @@ We would rather tell you up front when this is not a fit.
 - **GitHub only.** It assumes GitHub Actions and GitHub issues/PRs, so GitLab and others are not supported.
 - **Releases assume a develop branch → default branch PR flow.** Branch names can be changed in `version.yml`, but it does not suit a repo that does not use two branches.
 - **A personal access token is optional.** You need one only to merge past branch protection or to sync a Projects board. See [Setup](#setup).
-- **It adds about 50 files to your repository** (workflows, helper scripts, templates). See [the measurement](#compared-with-other-tools).
-- **New versions ship often.** `latest` follows every push to `main` with no delay. Pin a version you have tested with `npx projectops@<version>`.
+- **It adds about 60 files to your repository** (workflows, helper scripts, templates). See [the measurement](#compared-with-other-tools).
+- **New versions ship often.** `latest` follows every push to `main` with no delay. `npx projectops@<version>` pins the installer only; workflow templates always come from the current `main`.
 - **Server deploy workflows assume a Docker server reachable over SSH.**
 
 ---

package/package.json

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

package/src/cli/errors.js

@@ -14,6 +14,10 @@ export function describeError(err) {
   }
   // 템플릿 내려받기 실패 — execFileSync 가 "Command failed: git clone ..." 를 던진다
   if (/Command failed: git clone/.test(msg)) {
+    // Windows 경로 길이 한계 — 네트워크 탓으로 안내하면 엉뚱한 곳을 보게 된다
+    if (/Filename too long|cannot stat/i.test(msg)) {
+      return { message: t("errors.clone.pathTooLong.message"), hint: t("errors.clone.pathTooLong.hint") };
+    }
     return {
       message: t("errors.clone.message"),
       hint: t("errors.clone.hint"),

package/src/commands/doctor.js

@@ -154,7 +154,7 @@ export function localChecks(cwd = ".") {
     // 다른 워크플로우를 깨우는 파일만 — 주석 줄의 언급(깨워지는 쪽 설명)은 호출이 아니다
     const code = body.split("\n").filter((line) => !/^\s*#/.test(line)).join("\n");
     if (!code.includes("dispatch_downstream.py")) continue;
-    const perm = body.match(/^permissions:\n((?:\s+.*\n)+)/m);
+    const perm = body.match(/^permissions:\r?\n((?:\s+.*\r?\n)+)/m);
     const hasActionsWrite = perm ? /^\s+actions:\s*write/m.test(perm[1]) : false;
     if (!hasActionsWrite) needsActionsWrite.push(f);
   }

package/src/core/assets.js

@@ -26,7 +26,7 @@ export function acquireTemplate({ tempDir, source = { type: "git" }, keep = [] }
     // clone 은 stdio 를 버려 실패 원인이 사라진다 — 폴더가 읽기 전용이어도 "내려받지 못했다"로 오도되므로
     // 먼저 만들어 권한 오류(EACCES/EPERM/EROFS)를 그대로 올린다 (#720). 빈 폴더에는 clone 이 가능하다.
     mkdirSync(tempDir, { recursive: true });
-    execFileSync("git", ["clone", "--depth", "1", "--quiet", repo, tempDir], { stdio: "ignore" });
+    execFileSync("git", ["clone", "-c", "core.longpaths=true", "--depth", "1", "--quiet", repo, tempDir], { stdio: ["ignore", "ignore", "pipe"] });
   }
   applyExclusions(tempDir, { keep });
 }

package/src/core/breaking-check.js

@@ -5,8 +5,9 @@ import { join } from "node:path";
 import { collectBreaking, localizeBreakingEntry } from "./breaking.js";
 import { parseExisting } from "./version-yml.js";
 import { t, getLang } from "../i18n/index.js";
+import { TEMPLATE_RAW_URL } from "./paths.js";
 
-const BC_URL = "https://raw.githubusercontent.com/Cassiiopeia/projectops/main/.github/config/breaking-changes.json";
+const BC_URL = `${TEMPLATE_RAW_URL}/.github/config/breaking-changes.json`;
 
 // 원격 우선(3초 타임아웃) → clone된 템플릿의 번들본 폴백 → 둘 다 실패 시 null(조용히 스킵)
 export async function loadBreakingJson(tempDir) {

package/src/core/copy/workflows.js

@@ -308,8 +308,9 @@ function recordBaseline(workflowsDir, targetRoot, counters, previous, templateVe
       entries,
       previous,
     });
-  } catch {
+  } catch (e) {
     // 기준점 기록 실패는 통합 실패가 아니다
+    trace?.event("baseline", "baseline-failed", "", { message: e?.message || String(e) });
   }
 }
 

package/src/core/fsutil.js

@@ -1,9 +1,9 @@
 // 파일시스템 공용 유틸 (LF 보존 바이트 복사). 텍스트는 그대로 복사해 원본 줄바꿈 유지.
 import {
-  cpSync, existsSync, readFileSync, writeFileSync, mkdirSync,
-  readdirSync, rmSync,
+  copyFileSync as copyFileBytes, existsSync, lstatSync, readFileSync, readlinkSync, symlinkSync,
+  writeFileSync, mkdirSync, readdirSync, rmSync,
 } from "node:fs";
-import { dirname } from "node:path";
+import { dirname, join } from "node:path";
 
 export const exists = (p) => existsSync(p);
 export const readText = (p) => readFileSync(p, "utf8");
@@ -16,13 +16,29 @@ export function writeText(p, s) {
 // 단일 파일 복사 (부모 디렉토리 자동 생성, 바이트 그대로)
 export function copyFileSync(src, dst) {
   mkdirSync(dirname(dst), { recursive: true });
-  cpSync(src, dst);
+  copyFileBytes(src, dst);
+}
+
+// 파일·폴더·심볼릭 링크 재귀 복사. fs.cpSync 는 쓰지 않는다:
+// Windows + Node 22 이상에서 경로에 한글이 있으면 메시지 없이 프로세스가 죽는다.
+export function copyPathSync(src, dst, filter) {
+  if (filter && !filter(src)) return;
+  const stat = lstatSync(src);
+  if (stat.isSymbolicLink()) {
+    rmSync(dst, { force: true });
+    symlinkSync(readlinkSync(src), dst);
+  } else if (stat.isDirectory()) {
+    mkdirSync(dst, { recursive: true });
+    for (const name of readdirSync(src)) copyPathSync(join(src, name), join(dst, name), filter);
+  } else {
+    copyFileSync(src, dst);
+  }
 }
 
 // 디렉토리 재귀 복사 (내용을 dst 하위로)
 export function copyDirSync(src, dst, { filter } = {}) {
   mkdirSync(dst, { recursive: true });
-  cpSync(src, dst, { recursive: true, ...(filter ? { filter } : {}) });
+  copyPathSync(src, dst, filter);
 }
 
 // 파일/폴더 삭제 (없어도 무해)

package/src/core/ide/adapters/claude.js

@@ -1,7 +1,7 @@
 // Claude Code 어댑터 (플러그인 설치·제거, 플러그인 데이터 정리).
 // 마켓플레이스 Cassiiopeia/projectops, 플러그인 projectops@projectops-marketplace.
 import { join } from "node:path";
-import { existsSync, readdirSync, mkdirSync, cpSync, rmSync } from "node:fs";
+import { existsSync, readdirSync, mkdirSync, copyFileSync, rmSync } from "node:fs";
 import { compareCacheName } from "../util.js";
 import { migrateConfigRoot } from "../legacy.js";
 import { t } from "../../../i18n/index.js";
@@ -107,7 +107,7 @@ function migrateConfig(io, oldCache, newCache) {
   try {
     mkdirSync(newCfg, { recursive: true });
     let copied = 0;
-    for (const f of readdirSync(oldCfg)) if (f.endsWith(".json")) { cpSync(join(oldCfg, f), join(newCfg, f)); copied++; }
+    for (const f of readdirSync(oldCfg)) if (f.endsWith(".json")) { copyFileSync(join(oldCfg, f), join(newCfg, f)); copied++; }
     if (copied) io.log(t("ide.claude.configMigrated"));
   } catch { /* 무해 */ }
 }

package/src/core/ide/adapters/codex.js

@@ -38,7 +38,7 @@ function remove(io) {
   const tgt = nativeTarget(io);
   let removed = false;
   if (existsSync(tgt) || isSymlink(tgt)) {
-    try { rmSync(tgt, { recursive: true, force: true }); io.log(t("ide.codex.skillsRemoved", { path: tgt })); removed = true; } catch { /* 무해 */ }
+    try { rmSync(tgt, { recursive: true, force: true }); io.log(t("ide.codex.skillsRemoved", { path: tgt })); removed = true; } catch (e) { removed = true; io.log(t("ide.codex.removeFailed", { path: tgt, error: e.message })); }
   }
   if (!removed) io.log(t("ide.codex.removeNone"));
   if (io.which("codex")) io.log(t("ide.codex.unregisterManual", { plugin: PLUGIN }));

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

@@ -23,8 +23,9 @@ export function applyHomeSkills(io, ctx, { skillsDest, metaFileName, messagePref
     // 공용 파이썬이 없으면 스킬 CLI 가 import 에 실패 → 알림만 (문서형 스킬은 동작)
     if (!hasSharedScripts) io.log(t("ide.skillsCopy.noScripts"));
     io.log(t(`${messagePrefix}.installed`, { dest: skillsDest, version: ctx.templateVersion || "unknown" }));
-  } catch {
+  } catch (e) {
     io.log(t(`${messagePrefix}.copyFailed`));
+    io.log(`  ${e?.message || e}`);
     return false;
   }
   installStableEntrypoints(io, skillsSrc, scriptsSrc);

package/src/core/ide/legacy.js

@@ -1,7 +1,8 @@
 // IDE 어댑터 공용 레거시 유틸 — 버전 판정 + config 루트 이관.
 // 리브랜딩(#459) 전 설치본(cassiiopeia/SUH-DEVOPS-TEMPLATE)을 신규(projectops)로 넘길 때 공용.
-import { join, dirname } from "node:path";
-import { existsSync, readFileSync, mkdirSync, cpSync } from "node:fs";
+import { join } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+import { copyFileSync } from "../fsutil.js";
 import { compareCacheName } from "./util.js";
 
 // version <= maxLegacy 이면 레거시. null/빈문자열은 판정 불가 → false(안전).
@@ -31,8 +32,7 @@ export function migrateConfigRoot(io) {
   const src = sources.find(hasNonEmptyJson);
   if (!src) return { migrated: false, reason: "no-source" };
   try {
-    mkdirSync(dirname(target), { recursive: true });
-    cpSync(src, target);
+    copyFileSync(src, target);
     io.log(`  config 마이그레이션 완료: ${src} → ~/.projectops/config/config.json`);
     return { migrated: true, from: src };
   } catch (e) {

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

@@ -3,7 +3,8 @@
 // 설치 모양은 플러그인 캐시와 같다: <설치 루트>/skills/pro-*/scripts/x_cli.py + <설치 루트>/scripts/common
 //   (스킬 CLI bootstrap 이 x_cli.py 기준 3단계 위의 scripts/ 를 import 경로로 쓴다)
 import { dirname, join, relative } from "node:path";
-import { existsSync, readFileSync, mkdirSync, cpSync, rmSync, writeFileSync, readdirSync } from "node:fs";
+import { existsSync, readFileSync, mkdirSync, rmSync, writeFileSync, readdirSync } from "node:fs";
+import { copyPathSync } from "../fsutil.js";
 import { TEMPLATE_REPO_WEB_URL } from "../paths.js";
 
 // 스킬을 쓰는 사람에게 필요 없는 것. projectops 자신을 검사하는 테스트다.
@@ -53,11 +54,8 @@ function copyEntriesWithoutTests(src, dest, skipNames = new Set()) {
   const copiedNames = [];
   for (const e of readdirSync(src, { withFileTypes: true })) {
     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).
-      filter: (p) => !TEST_PATH.test(relative(src, p)),
-    });
+    // 이 저장소 자기 코드를 검사하는 테스트는 남의 컴퓨터로 나갈 이유가 없다 (#591).
+    copyPathSync(join(src, e.name), join(dest, e.name), (p) => !TEST_PATH.test(relative(src, p)));
     copiedNames.push(e.name);
   }
   return copiedNames;

package/src/core/run-trace.js

@@ -51,7 +51,7 @@ function elapsed(t0, clockIso) {
 const ERROR_ACTIONS = new Set(["error", "failed"]);
 const WARN_ACTIONS = new Set([
   "unresolved", "cancelled", "skipped-conflict", "leftover-old-gen",
-  "neutralized", "detected", "replaced-bak", "incoming-failed",
+  "neutralized", "detected", "replaced-bak", "incoming-failed", "baseline-failed",
 ]);
 const DEBUG_ACTIONS = new Set([
   "copied", "skipped-unchanged", "excluded", "substituted", "branch-substituted",

package/src/i18n/core.en.js

@@ -21,6 +21,8 @@ export default {
   "errors.git.hint": "Check that git is installed and on your PATH.",
   "errors.clone.message": "Could not download the template.",
   "errors.clone.hint": "Check your network, proxy settings and GitHub access, then run again.",
+  "errors.clone.pathTooLong.message": "This folder path is too long for Windows to hold the template.",
+  "errors.clone.pathTooLong.hint": "Move the project to a shorter path (for example C:/dev/my-app) and run again.",
   "errors.write.message": "Cannot write the file{where}.",
   "errors.write.hint": "Check write permission (and read-only status) of the project folder and the .github folder.",
   "errors.disk.message": "Not enough disk space.",

package/src/i18n/core.ko.js

@@ -21,6 +21,8 @@ export default {
   "errors.git.hint": "git 이 설치되어 있고 PATH 에 있는지 확인하세요.",
   "errors.clone.message": "템플릿을 내려받지 못했습니다.",
   "errors.clone.hint": "네트워크·프록시 설정과 GitHub 접근 가능 여부를 확인한 뒤 다시 실행하세요.",
+  "errors.clone.pathTooLong.message": "폴더 경로가 너무 길어 Windows에서 템플릿을 받을 수 없습니다.",
+  "errors.clone.pathTooLong.hint": "프로젝트를 더 짧은 경로(예: C:/dev/my-app)로 옮긴 뒤 다시 실행하세요.",
   "errors.write.message": "파일을 쓸 수 없습니다{where}.",
   "errors.write.hint": "프로젝트 폴더와 .github 폴더의 쓰기 권한(읽기 전용 여부)을 확인하세요.",
   "errors.disk.message": "디스크 공간이 부족합니다.",

package/src/i18n/ide.en.js

@@ -26,6 +26,7 @@ export default {
   "ide.codex.marketError": "  Codex marketplace error. Manual: codex plugin marketplace add {market}",
   "ide.codex.skillsRemoved": "  Codex native skills removed ({path})",
   "ide.codex.removeNone": "  No Codex skills to remove, skipping",
+  "ide.codex.removeFailed": "  Could not remove {path}: {error}",
   "ide.codex.unregisterManual": "  To unregister the marketplace, run manually: codex plugin marketplace remove {plugin}",
   "ide.codex.legacy": "  Removed legacy Codex skills: {name}",
   "ide.cursor.noSource": "  Could not find the skills source (a skills/ folder is required).",

package/src/i18n/ide.ko.js

@@ -26,6 +26,7 @@ export default {
   "ide.codex.marketError": "  Codex marketplace 관리 오류 — 수동: codex plugin marketplace add {market}",
   "ide.codex.skillsRemoved": "  Codex native skills 제거 완료 ({path})",
   "ide.codex.removeNone": "  제거할 Codex skills가 없어 건너뜁니다",
+  "ide.codex.removeFailed": "  {path} 삭제 실패: {error}",
   "ide.codex.unregisterManual": "  marketplace 등록 해제는 수동: codex plugin marketplace remove {plugin}",
   "ide.codex.legacy": "  레거시 Codex skills 정리: {name}",
   "ide.cursor.noSource": "  설치할 스킬 소스를 찾지 못했습니다 (skills/ 폴더 필요).",