projectops 4.2.4 → 4.2.6

package/README.md

@@ -7,7 +7,7 @@
 > 이슈 등록부터 커밋, 보고서, 배포까지. 개발자는 코드만 작성하세요.
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## 최신 버전 : v4.2.3 (2026-07-09)
+## 최신 버전 : v4.2.5 (2026-07-10)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 
@@ -27,9 +27,9 @@
 | 버전 수동 관리, 태그 직접 생성 | 릴리스(develop→main PR) 시 patch 버전 자동 증가 + 태그 생성 |
 | 체인지로그 직접 작성 (30분+) | CodeRabbit AI가 PR마다 자동 생성 |
 | CI/CD 처음부터 설정 | 프로젝트 타입별 워크플로우 즉시 구성 |
-| 이슈 매번 형식 맞춰 작성 (5분+) | `/projectops:issue` 한 번에 표준 템플릿 생성 |
-| 커밋 메시지 이슈 URL 수동 복사 | `/projectops:commit` 이슈 컨텍스트 기반 자동 완성 |
-| PR 설명/보고서 직접 작성 | `/projectops:report` git diff 분석 후 자동 생성 |
+| 이슈 매번 형식 맞춰 작성 (5분+) | `/pro-issue` 한 번에 표준 템플릿 생성 |
+| 커밋 메시지 이슈 URL 수동 복사 | `/pro-commit` 이슈 컨텍스트 기반 자동 완성 |
+| PR 설명/보고서 직접 작성 | `/pro-report` git diff 분석 후 자동 생성 |
 | 코드 리뷰·분석 매번 프롬프트 입력 | 25종 Skills로 일관된 결과, 매번 재입력 불필요 |
 
 ---
@@ -40,23 +40,23 @@ Agent Skills가 개발 사이클 전체를 커버합니다.
 
 ```mermaid
 flowchart TD
-    A([작업 시작]) --> B["/projectops:issue\n이슈 등록 + GitHub 자동 생성"]
-    B --> C["/projectops:init-worktree\nworktree + 민감파일 자동 복사"]
+    A([작업 시작]) --> B["/pro-issue\n이슈 등록 + GitHub 자동 생성"]
+    B --> C["/pro-init-worktree\nworktree + 민감파일 자동 복사"]
     C --> D{작업 유형}
 
-    D -->|새 기능| E1["/projectops:plan\n전략 수립"]
-    D -->|버그| E2["/projectops:troubleshoot\n원인 분석"]
-    D -->|리팩토링| E3["/projectops:refactor-analyze\nSmell 탐지"]
+    D -->|새 기능| E1["/pro-plan\n전략 수립"]
+    D -->|버그| E2["/pro-troubleshoot\n원인 분석"]
+    D -->|리팩토링| E3["/pro-refactor-analyze\nSmell 탐지"]
 
-    E1 --> F["/projectops:implement\n구현"]
+    E1 --> F["/pro-implement\n구현"]
     E2 --> F
     E3 --> F
-    F --> G["/projectops:test\n테스트"]
-    G --> H["/projectops:review\n셀프 리뷰"]
-    H --> I["/projectops:commit\n이슈 연동 커밋 자동 완성"]
-    I --> J["/projectops:report\n구현 보고서 + GitHub 댓글"]
+    F --> G["/pro-test\n테스트"]
+    G --> H["/pro-review\n셀프 리뷰"]
+    H --> I["/pro-commit\n이슈 연동 커밋 자동 완성"]
+    I --> J["/pro-report\n구현 보고서 + GitHub 댓글"]
     J --> K([PR 등록])
-    K --> L["/projectops:changelog-deploy\ndevelop push → main 릴리스 PR + automerge"]
+    K --> L["/pro-changelog-deploy\ndevelop push → main 릴리스 PR + automerge"]
 ```
 
 > Skills 전체 목록 및 상세 사용법: **[docs/SKILLS.md](docs/SKILLS.md)**
@@ -171,46 +171,46 @@ bash <(curl -fsSL "https://raw.githubusercontent.com/Cassiiopeia/projectops/main
 
 | 스킬 | 용도 |
 |------|------|
-| `/projectops:issue` | 설명 한 줄 → GitHub 이슈 템플릿 자동 작성 + 등록 |
-| `/projectops:init-worktree` | Git worktree 생성 + 민감 파일 자동 복사 |
-| `/projectops:commit` | 이슈 컨텍스트 기반 커밋 메시지 자동 완성 (superpowers 준수) |
-| `/projectops:report` | git diff 분석 → 구현 보고서 생성 + GitHub 댓글 자동 포스팅 |
-| `/projectops:changelog-deploy` | develop push → main 릴리스 PR 생성 + 릴리스 노트 작성 + automerge |
-| `/projectops:github` | GitHub 이슈/PR/댓글 독립 조회 및 관리 |
+| `/pro-issue` | 설명 한 줄 → GitHub 이슈 템플릿 자동 작성 + 등록 |
+| `/pro-init-worktree` | Git worktree 생성 + 민감 파일 자동 복사 |
+| `/pro-commit` | 이슈 컨텍스트 기반 커밋 메시지 자동 완성 (superpowers 준수) |
+| `/pro-report` | git diff 분석 → 구현 보고서 생성 + GitHub 댓글 자동 포스팅 |
+| `/pro-changelog-deploy` | develop push → main 릴리스 PR 생성 + 릴리스 노트 작성 + automerge |
+| `/pro-github` | GitHub 이슈/PR/댓글 독립 조회 및 관리 |
 
 ### 📊 분석형 (코드 수정 없음)
 
 | 스킬 | 용도 |
 |------|------|
-| `/projectops:analyze` | 구현 전 현재 코드 상태 분석 및 영향 범위 평가 |
-| `/projectops:plan` | 요구사항 명확화 + 2가지 이상 접근 방식 비교로 전략 수립 |
-| `/projectops:design-analyze` | 아키텍처/API/DB/UI 설계 분석 (구현 X) |
-| `/projectops:refactor-analyze` | Code Smell 탐지 + Before/After 기반 리팩토링 계획 |
-| `/projectops:review` | 보안/성능/버그/품질 6관점 리뷰, Critical/Major/Minor 분류 |
-| `/projectops:troubleshoot` | 가설-검증 방식 근본 원인 분석, Quick Fix/Root Fix 제시 |
+| `/pro-analyze` | 구현 전 현재 코드 상태 분석 및 영향 범위 평가 |
+| `/pro-plan` | 요구사항 명확화 + 2가지 이상 접근 방식 비교로 전략 수립 |
+| `/pro-design-analyze` | 아키텍처/API/DB/UI 설계 분석 (구현 X) |
+| `/pro-refactor-analyze` | Code Smell 탐지 + Before/After 기반 리팩토링 계획 |
+| `/pro-review` | 보안/성능/버그/품질 6관점 리뷰, Critical/Major/Minor 분류 |
+| `/pro-troubleshoot` | 가설-검증 방식 근본 원인 분석, Quick Fix/Root Fix 제시 |
 
 ### 🔧 구현형 (실제 코드 작성)
 
 | 스킬 | 용도 |
 |------|------|
-| `/projectops:implement` | 계획/분석 결과 기반 코드 구현 (기존 스타일 100% 준수) |
-| `/projectops:design` | 아키텍처/API/DB/UI 설계 + 구현까지 |
-| `/projectops:refactor` | Extract Method, DRY 등 리팩토링 기법 단계별 적용 |
-| `/projectops:test` | AAA 패턴 단위/통합/E2E 테스트 코드 작성 |
-| `/projectops:figma` | Figma CSS → React/RN/Flutter 반응형 코드 변환 |
-| `/projectops:build` | 프로젝트 빌드 실행, 에러 분석, 최적화 제안 |
+| `/pro-implement` | 계획/분석 결과 기반 코드 구현 (기존 스타일 100% 준수) |
+| `/pro-design` | 아키텍처/API/DB/UI 설계 + 구현까지 |
+| `/pro-refactor` | Extract Method, DRY 등 리팩토링 기법 단계별 적용 |
+| `/pro-test` | AAA 패턴 단위/통합/E2E 테스트 코드 작성 |
+| `/pro-figma` | Figma CSS → React/RN/Flutter 반응형 코드 변환 |
+| `/pro-build` | 프로젝트 빌드 실행, 에러 분석, 최적화 제안 |
 
 ### 📝 문서/산출물 생성형
 
 | 스킬 | 용도 |
 |------|------|
-| `/projectops:document` | 코드 주석/README/API 문서 작성 |
-| `/projectops:testcase` | 이슈 분석 → QA 체크리스트 생성 |
-| `/projectops:ppt` | 트러블슈팅/구현 사례 → 5섹션 발표자료 |
-| `/projectops:spring-test` | Spring Boot 테스트 샘플 코드 생성 |
-| `/projectops:synology-expose` | Synology NAS 외부 도메인 노출 설정 가이드 |
-| `/projectops:ssh` | 원격 서버 SSH 접속·명령 실행 (AWS EC2, 시놀로지 NAS, Linux 등 범용) |
-| `/projectops:skill-creator` | Skill 생성/리뷰/개선 (CREATE·REVIEW·IMPROVE 3모드) |
+| `/pro-document` | 코드 주석/README/API 문서 작성 |
+| `/pro-testcase` | 이슈 분석 → QA 체크리스트 생성 |
+| `/pro-ppt` | 트러블슈팅/구현 사례 → 5섹션 발표자료 |
+| `/pro-spring-test` | Spring Boot 테스트 샘플 코드 생성 |
+| `/pro-synology-expose` | Synology NAS 외부 도메인 노출 설정 가이드 |
+| `/pro-ssh` | 원격 서버 SSH 접속·명령 실행 (AWS EC2, 시놀로지 NAS, Linux 등 범용) |
+| `/pro-skill-creator` | Skill 생성/리뷰/개선 (CREATE·REVIEW·IMPROVE 3모드) |
 
 ---
 

package/package.json

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

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

@@ -4,9 +4,12 @@
 import { join } from "node:path";
 import { existsSync, readdirSync, mkdirSync, cpSync, rmSync } from "node:fs";
 import { compareCacheName } from "../util.js";
+import { migrateConfigRoot } from "../legacy.js";
 
 const MARKETPLACE = "Cassiiopeia/projectops";
 const PLUGIN = "projectops@projectops-marketplace";
+const LEGACY_PLUGINS = ["cassiiopeia@cassiiopeia-marketplace", "cassiiopeia"];
+const LEGACY_MARKETPLACES = ["cassiiopeia-marketplace"];
 
 function detect(io) {
   if (!io.which("claude")) return { installed: false, version: null, cliMissing: true, note: "CLI 없음" };
@@ -26,10 +29,34 @@ function detect(io) {
 function apply(io, ctx = {}) {
   const st = detect(io);
   if (st.cliMissing) { io.log(manualHint(io)); return false; }
-  if (st.installed) return update(io, st.scope);
+  migrateLegacy(io);          // 옛 cassiiopeia 플러그인/마켓 정리
+  migrateConfigRoot(io);      // 공용 config 루트 이관
+  const st2 = detect(io);     // 정리 후 재감지
+  if (st2.installed) return update(io, st2.scope);
   return install(io, "user");
 }
 
+// 옛 이름(cassiiopeia) 플러그인·마켓 정리. 조용히, 로그만. 실패 무해(없으면 no-op).
+function migrateLegacy(io) {
+  const r = io.run("claude", ["plugin", "list", "--json"]);
+  let list = [];
+  try { const arr = JSON.parse(r.stdout || "[]"); list = Array.isArray(arr) ? arr : (arr.plugins || []); } catch { /* 무시 */ }
+  for (const legacy of LEGACY_PLUGINS) {
+    const hit = list.find((p) => {
+      const name = String(p.name || p.id || "");
+      return name === legacy || name.startsWith(legacy + "@");
+    });
+    if (hit) {
+      const scope = hit.scope || "user";
+      io.log(`  레거시 플러그인 정리: ${legacy} (scope: ${scope})`);
+      io.run("claude", ["plugin", "uninstall", legacy, "--scope", scope]);
+    }
+  }
+  for (const mp of LEGACY_MARKETPLACES) {
+    io.run("claude", ["plugin", "marketplace", "remove", mp]); // 없으면 no-op
+  }
+}
+
 function install(io, scope = "user") {
   io.log("Claude Code 마켓플레이스 등록 중...");
   const add = io.run("claude", ["plugin", "marketplace", "add", MARKETPLACE]);

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

@@ -3,9 +3,12 @@
 // marketplace 등록/업그레이드가 주 경로. native ~/.agents/skills/projectops 심링크는 감지·제거에 사용.
 import { join } from "node:path";
 import { existsSync, lstatSync, rmSync } from "node:fs";
+import { migrateConfigRoot } from "../legacy.js";
 
 const MARKETPLACE = "Cassiiopeia/projectops";
 const PLUGIN = "projectops";
+const LEGACY_NATIVES = ["SUH-DEVOPS-TEMPLATE"];
+const LEGACY_MARKETPLACES = ["SUH-DEVOPS-TEMPLATE"];
 
 function nativeTarget(io) { return join(io.home(), ".agents/skills/projectops"); }
 
@@ -19,6 +22,8 @@ function detect(io) {
 
 function apply(io) {
   if (!io.which("codex")) { io.log(manualHint()); return false; }
+  migrateLegacy(io);
+  migrateConfigRoot(io);
   io.log("Codex plugin marketplace 등록 중...");
   const add = io.run("codex", ["plugin", "marketplace", "add", MARKETPLACE]);
   io.log(add.code === 0 ? "  Codex marketplace 등록 완료" : "  Codex marketplace 이미 등록되어 있거나 등록 생략");
@@ -41,6 +46,17 @@ function remove(io) {
 
 function manualHint() { return `  💡 Codex CLI: codex plugin marketplace add ${MARKETPLACE}`; }
 
+// 옛 native skills 폴더/심링크 + 옛 marketplace 정리. 실패 무해.
+function migrateLegacy(io) {
+  for (const name of LEGACY_NATIVES) {
+    const old = join(io.home(), ".agents/skills", name);
+    if (existsSync(old) || isSymlink(old)) {
+      try { rmSync(old, { recursive: true, force: true }); io.log(`  레거시 Codex skills 정리: ${name}`); } catch { /* 무시 */ }
+    }
+  }
+  if (io.which("codex")) for (const mp of LEGACY_MARKETPLACES) io.run("codex", ["plugin", "marketplace", "remove", mp]);
+}
+
 function isSymlink(p) { try { return lstatSync(p).isSymbolicLink(); } catch { return false; } }
 
 export const codexAdapter = {

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

@@ -3,6 +3,10 @@
 // 마켓플레이스 없음 → ~/.cursor/skills/ 에 skills/ 폴더를 복사하고 meta.json으로 버전 추적.
 import { join } from "node:path";
 import { existsSync, readFileSync, mkdirSync, cpSync, rmSync, writeFileSync, readdirSync } from "node:fs";
+import { migrateConfigRoot, isLegacyVersion } from "../legacy.js";
+
+const LEGACY_NAMES = ["cassiiopeia", "suh-devops-template"];
+const LEGACY_MAX_VERSION = "4.2.4";
 
 function metaPath(io) { return join(io.home(), ".cursor/skills/cursor-skills-meta.json"); }
 
@@ -18,6 +22,8 @@ function detect(io) {
 }
 
 function apply(io, ctx = {}) {
+  migrateLegacy(io, ctx);   // 옛 이름/버전 감지 시 projectops 소유 항목 선별 삭제
+  migrateConfigRoot(io);    // 공용 config 루트 이관
   const src = resolveSkillsSrc(ctx);
   if (!src) { io.log("  설치할 스킬 소스를 찾지 못했습니다 (skills/ 폴더 필요)."); return false; }
   const dest = join(io.home(), ".cursor/skills");
@@ -36,11 +42,44 @@ function apply(io, ctx = {}) {
   }
 }
 
-function remove(io) {
+function remove(io, ctx = {}) {
   const dir = join(io.home(), ".cursor/skills");
   if (!existsSync(join(dir, "cursor-skills-meta.json"))) { io.log("  설치된 Cursor Skills가 없어 건너뜁니다"); return true; }
-  try { rmSync(dir, { recursive: true, force: true }); io.log(`  Cursor Skills 제거 완료 (${dir}/)`); return true; }
-  catch { io.log(`  Cursor Skills 제거 실패 — 수동 삭제: rm -rf ${dir}`); return false; }
+  try {
+    for (const name of ownedEntries(io, ctx)) rmSync(join(dir, name), { recursive: true, force: true });
+    // 폴더가 비면 폴더 자체 제거, 타 스킬(somansa-tools 등) 남으면 유지
+    if (existsSync(dir) && readdirSync(dir).length === 0) rmSync(dir, { recursive: true, force: true });
+    io.log(`  Cursor Skills 제거 완료 (projectops 소유만, ${dir}/)`);
+    return true;
+  } catch { io.log(`  Cursor Skills 제거 실패 — 수동 확인: ${dir}`); return false; }
+}
+
+// projectops가 이 폴더에 설치했다고 볼 항목만 골라낸다.
+// 소스 skills/ 폴더명(pro-*, references, config.json.example) ∪ /^suh-/ ∪ meta 파일.
+// 접두어 없는 폴더(analyze·gitlab 등 somansa-tools)는 제외 → 보존.
+function ownedEntries(io, ctx) {
+  const dir = join(io.home(), ".cursor/skills");
+  if (!existsSync(dir)) return [];
+  let srcNames = new Set();
+  const src = resolveSkillsSrc(ctx);
+  if (src && existsSync(src)) srcNames = new Set(readdirSync(src));
+  const EXTRA = new Set(["cursor-skills-meta.json"]);
+  return readdirSync(dir).filter((name) => srcNames.has(name) || /^suh-/.test(name) || EXTRA.has(name));
+}
+
+// 옛 이름/버전 meta면 projectops 소유 항목만 선별 삭제 → apply가 신규 재설치.
+function migrateLegacy(io, ctx) {
+  const mp = metaPath(io);
+  if (!existsSync(mp)) return;
+  let meta = {};
+  try { meta = JSON.parse(readFileSync(mp, "utf8")); } catch { return; }
+  const oldName = meta.name && LEGACY_NAMES.includes(String(meta.name).toLowerCase());
+  const oldVer = isLegacyVersion(meta.version, LEGACY_MAX_VERSION);
+  if (!(oldName || oldVer)) return;
+  for (const name of ownedEntries(io, ctx)) {
+    try { rmSync(join(io.home(), ".cursor/skills", name), { recursive: true, force: true }); } catch { /* 무시 */ }
+  }
+  io.log(`  레거시 Cursor Skills 정리(선별): name=${meta.name}, v=${meta.version} → 재설치`);
 }
 
 function manualHint() {

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

@@ -1,7 +1,10 @@
 // Gemini CLI 어댑터 (.sh _manage_gemini_extension / _remove_gemini_section 등가).
 // extension install/update/uninstall. 마켓플레이스 대신 git URL 확장.
+import { migrateConfigRoot } from "../legacy.js";
+
 const EXT = "projectops";
 const URL = "https://github.com/Cassiiopeia/projectops";
+const LEGACY_EXTS = ["SUH-DEVOPS-TEMPLATE"];
 
 function detect(io) {
   if (!io.which("gemini")) return { installed: false, version: null, cliMissing: true, note: "CLI 없음" };
@@ -11,6 +14,8 @@ function detect(io) {
 
 function apply(io) {
   if (!io.which("gemini")) { io.log(manualHint()); return false; }
+  migrateLegacy(io);
+  migrateConfigRoot(io);
   io.log("Gemini CLI extension 업데이트 중...");
   if (io.run("gemini", ["extensions", "update", EXT]).code === 0) { io.log("  Gemini CLI extension 업데이트 완료"); return true; }
   io.log("Gemini CLI extension 설치 중...");
@@ -28,6 +33,11 @@ function remove(io) {
 
 function manualHint() { return `  💡 Gemini CLI: gemini extensions install ${URL}`; }
 
+// 옛 이름 extension 정리. 없으면 실패 무시.
+function migrateLegacy(io) {
+  for (const e of LEGACY_EXTS) io.run("gemini", ["extensions", "uninstall", e]);
+}
+
 export const geminiAdapter = {
   id: "gemini", label: "Gemini CLI", order: 30,
   detect, apply, remove, manualHint,

package/src/core/ide/adapters/pi-common.js

@@ -2,7 +2,7 @@
 // .sh: PI_PACKAGE_URL / _pi_is_installed / _pi_clone_dir / _pi_harness_loader_path /
 //      _pi_settings_path / _pi_harness_enabled 등가.
 import { join } from "node:path";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, readFileSync, writeFileSync, rmSync } from "node:fs";
 
 export const PI_PACKAGE_URL = "https://github.com/Cassiiopeia/projectops";
 
@@ -61,3 +61,24 @@ export function harnessRemove(io) {
   }
   return { ok: true };
 }
+
+// 신·구 clone 공존 시 옛 SUH-DEVOPS-TEMPLATE clone 제거 + settings.json에서 그 loader 경로 제거.
+// 공존일 때만 정리(옛것만 있으면 pi install이 신규를 만들 때까지 그대로 둔다). 실패 무해.
+export function migratePiLegacy(io) {
+  const base = join(io.home(), ".pi/agent/git/github.com/Cassiiopeia");
+  const oldDir = join(base, "SUH-DEVOPS-TEMPLATE");
+  const newDir = join(base, "projectops");
+  if (!(existsSync(oldDir) && existsSync(newDir))) return;
+  const oldLoader = join(oldDir, "harness/harness-loader.ts");
+  const settings = piSettingsPath(io);
+  if (existsSync(settings)) {
+    try {
+      const s = JSON.parse(readFileSync(settings, "utf8"));
+      if (Array.isArray(s.extensions)) {
+        s.extensions = s.extensions.filter((e) => e && e !== oldLoader);
+        writeFileSync(settings, JSON.stringify(s, null, 2));
+      }
+    } catch { /* 무시 */ }
+  }
+  try { rmSync(oldDir, { recursive: true, force: true }); io.log("  레거시 PI clone 정리: SUH-DEVOPS-TEMPLATE"); } catch { /* 무시 */ }
+}

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

@@ -1,6 +1,7 @@
 // PI 패키지 어댑터 (.sh _manage_pi_section / _remove_pi_section 등가).
 // pi install/update/remove. skill은 복사되지 않고 pi가 startup마다 스캔 → 설치 검증은 'pi list'.
-import { PI_PACKAGE_URL, piInstalled, harnessEnabled, harnessRemove } from "./pi-common.js";
+import { PI_PACKAGE_URL, piInstalled, harnessEnabled, harnessRemove, migratePiLegacy } from "./pi-common.js";
+import { migrateConfigRoot } from "../legacy.js";
 
 function detect(io) {
   if (!io.which("pi")) return { installed: false, version: null, cliMissing: true, note: "CLI 없음" };
@@ -9,6 +10,8 @@ function detect(io) {
 
 function apply(io) {
   if (!io.which("pi")) { io.log(manualHint()); return false; }
+  migratePiLegacy(io);
+  migrateConfigRoot(io);
   if (piInstalled(io)) {
     io.log("PI 패키지 업데이트 중...");
     if (io.run("pi", ["update", PI_PACKAGE_URL]).code !== 0) io.run("pi", ["install", PI_PACKAGE_URL]);

package/src/core/ide/legacy.js

@@ -0,0 +1,42 @@
+// IDE 어댑터 공용 레거시 유틸 — 버전 판정 + config 루트 이관.
+// 리브랜딩(#459) 전 설치본(cassiiopeia/SUH-DEVOPS-TEMPLATE)을 신규(projectops)로 넘길 때 공용.
+import { join, dirname } from "node:path";
+import { existsSync, readFileSync, mkdirSync, cpSync } from "node:fs";
+import { compareCacheName } from "./util.js";
+
+// version <= maxLegacy 이면 레거시. null/빈문자열은 판정 불가 → false(안전).
+export function isLegacyVersion(version, maxLegacy) {
+  if (!version || !maxLegacy) return false;
+  return compareCacheName(String(version), String(maxLegacy)) <= 0;
+}
+
+// 파일이 존재하고 JSON 파싱되며 최소 1개 키가 있으면 true.
+export function hasNonEmptyJson(path) {
+  if (!path || !existsSync(path)) return false;
+  try {
+    const o = JSON.parse(readFileSync(path, "utf8"));
+    return o && typeof o === "object" && Object.keys(o).length > 0;
+  } catch { return false; }
+}
+
+// config 루트 이관: 타겟(~/.projectops/config/config.json)이 비었을 때만 옛 경로에서 복사.
+// 옛 파일은 삭제하지 않음(민감값 보존). idempotent.
+export function migrateConfigRoot(io) {
+  const target = join(io.home(), ".projectops", "config", "config.json");
+  if (hasNonEmptyJson(target)) return { migrated: false, reason: "target-exists" };
+  const sources = [
+    join(io.home(), ".suh-template", "config", "config.json"), // 2세대 우선
+    join(io.home(), ".cassiiopeia", "config.json"),            // 1세대 폴백
+  ];
+  const src = sources.find(hasNonEmptyJson);
+  if (!src) return { migrated: false, reason: "no-source" };
+  try {
+    mkdirSync(dirname(target), { recursive: true });
+    cpSync(src, target);
+    io.log(`  config 마이그레이션 완료: ${src} → ~/.projectops/config/config.json`);
+    return { migrated: true, from: src };
+  } catch (e) {
+    io.log(`  config 마이그레이션 실패(무시): ${e.message}`);
+    return { migrated: false, reason: "error" };
+  }
+}