projectops 4.2.5 → 4.2.7

package/README.md

@@ -7,7 +7,7 @@
 > 이슈 등록부터 커밋, 보고서, 배포까지. 개발자는 코드만 작성하세요.
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## 최신 버전 : v4.2.4 (2026-07-09)
+## 최신 버전 : v4.2.6 (2026-07-10)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 
@@ -20,17 +20,17 @@
 이 프로젝트는 두 축으로 개발 워크플로우를 자동화합니다.
 
 **① GitHub Actions** — main 푸시 한 번으로 버전 관리, 체인지로그, CI/CD 배포까지 자동 처리  
-**② Agent Skills** — `/issue`, `/commit`, `/report` 등 AI가 이슈 작성부터 커밋 메시지, 구현 보고서까지 대신 생성
+**② Agent Skills** — `/github`, `/commit`, `/report` 등 AI가 이슈 작성부터 커밋 메시지, 구현 보고서까지 대신 생성
 
 | 기존 방식 | Projectops |
 |----------|---------------------|
 | 버전 수동 관리, 태그 직접 생성 | 릴리스(develop→main PR) 시 patch 버전 자동 증가 + 태그 생성 |
 | 체인지로그 직접 작성 (30분+) | CodeRabbit AI가 PR마다 자동 생성 |
 | CI/CD 처음부터 설정 | 프로젝트 타입별 워크플로우 즉시 구성 |
-| 이슈 매번 형식 맞춰 작성 (5분+) | `/pro-issue` 한 번에 표준 템플릿 생성 |
+| 이슈 매번 형식 맞춰 작성 (5분+) | `/pro-github` 한 번에 표준 템플릿 생성 + 등록 |
 | 커밋 메시지 이슈 URL 수동 복사 | `/pro-commit` 이슈 컨텍스트 기반 자동 완성 |
 | PR 설명/보고서 직접 작성 | `/pro-report` git diff 분석 후 자동 생성 |
-| 코드 리뷰·분석 매번 프롬프트 입력 | 25종 Skills로 일관된 결과, 매번 재입력 불필요 |
+| 코드 리뷰·분석 매번 프롬프트 입력 | 24종 Skills로 일관된 결과, 매번 재입력 불필요 |
 
 ---
 
@@ -40,7 +40,7 @@ Agent Skills가 개발 사이클 전체를 커버합니다.
 
 ```mermaid
 flowchart TD
-    A([작업 시작]) --> B["/pro-issue\n이슈 등록 + GitHub 자동 생성"]
+    A([작업 시작]) --> B["/pro-github\n이슈 등록 + GitHub 자동 생성"]
     B --> C["/pro-init-worktree\nworktree + 민감파일 자동 복사"]
     C --> D{작업 유형}
 
@@ -154,7 +154,7 @@ bash <(curl -fsSL "https://raw.githubusercontent.com/Cassiiopeia/projectops/main
 
 | 기능 | 설명 | 문서 |
 |------|------|------|
-| **Agent Skills** | Claude Code, Cursor, Gemini CLI, Codex CLI에서 쓰는 25종 AI DevOps Skills | [상세](docs/SKILLS.md) |
+| **Agent Skills** | Claude Code, Cursor, Gemini CLI, Codex CLI에서 쓰는 24종 AI DevOps Skills | [상세](docs/SKILLS.md) |
 | **버전 자동화** | 릴리스(develop→main PR) 시 patch 버전 자동 증가 + Git 태그 | [상세](docs/VERSION-CONTROL.md) |
 | **AI 체인지로그** | CodeRabbit 리뷰 기반 CHANGELOG 자동 생성 | [상세](docs/CHANGELOG-AUTOMATION.md) |
 | **PR Preview** | 댓글 한 줄로 임시 서버 배포, 닫으면 자동 삭제 | [상세](docs/PR-PREVIEW.md) |
@@ -165,18 +165,17 @@ bash <(curl -fsSL "https://raw.githubusercontent.com/Cassiiopeia/projectops/main
 
 ---
 
-## Agent Skills (25종)
+## Agent Skills (24종)
 
 ### 🔄 개발 사이클 자동화
 
 | 스킬 | 용도 |
 |------|------|
-| `/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/댓글 독립 조회 및 관리 |
+| `/pro-github` | GitHub 전반: 이슈 생성(설명 한 줄 → 템플릿 작성+등록)/조회/수정/댓글/라벨/담당자, PR 생성/머지/조회, 레포 탐색, Actions/Secret 관리 |
 
 ### 📊 분석형 (코드 수정 없음)
 
@@ -271,7 +270,7 @@ Settings → Actions → General
 
 | 문서 | 설명 |
 |------|------|
-| [Agent Skills 가이드](docs/SKILLS.md) | 25종 Skills 용도, 사용법, 전체 개발 사이클 흐름 |
+| [Agent Skills 가이드](docs/SKILLS.md) | 24종 Skills 용도, 사용법, 전체 개발 사이클 흐름 |
 | [통합 스크립트 가이드](docs/TEMPLATE-INTEGRATOR.md) | 기존 프로젝트에 템플릿 통합 |
 | [버전 관리](docs/VERSION-CONTROL.md) | version.yml, 자동 버전 증가 |
 | [체인지로그 자동화](docs/CHANGELOG-AUTOMATION.md) | CodeRabbit 연동, AI 문서화 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "4.2.5",
+  "version": "4.2.7",
   "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" };
+  }
+}