projectops 3.0.193 → 3.0.195

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

@@ -0,0 +1,94 @@
+// Claude Code 어댑터 (.sh _manage_claude_section / _do_claude_plugin_install /
+// _remove_claude_section / _remove_claude_plugin_data 등가).
+// 마켓플레이스 Cassiiopeia/projectops, 플러그인 cassiiopeia@cassiiopeia-marketplace.
+import { join } from "node:path";
+import { existsSync, readdirSync, mkdirSync, cpSync, rmSync } from "node:fs";
+import { compareCacheName } from "../util.js";
+
+const MARKETPLACE = "Cassiiopeia/projectops";
+const PLUGIN = "cassiiopeia@cassiiopeia-marketplace";
+
+function detect(io) {
+  if (!io.which("claude")) return { installed: false, version: null, cliMissing: true, note: "CLI 없음" };
+  const r = io.run("claude", ["plugin", "list", "--json"]);
+  let scope = "", version = null;
+  try {
+    const arr = JSON.parse(r.stdout || "[]");
+    const list = Array.isArray(arr) ? arr : (arr.plugins || []);
+    for (const p of list) {
+      const name = String(p.name || p.id || "");
+      if (name.includes("cassiiopeia@") || name === "cassiiopeia") { scope = p.scope || ""; version = p.version || null; break; }
+    }
+  } catch { /* 파싱 실패 → 미설치 취급 */ }
+  return { installed: !!scope, version, cliMissing: false, scope };
+}
+
+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);
+  return install(io, "user");
+}
+
+function install(io, scope = "user") {
+  io.log("Claude Code 마켓플레이스 등록 중...");
+  const add = io.run("claude", ["plugin", "marketplace", "add", MARKETPLACE]);
+  io.log(add.code === 0 ? "  마켓플레이스 등록 완료" : "  마켓플레이스 이미 등록되어 있거나 등록 생략");
+  io.log(`Claude Code 플러그인 설치 중 (scope: ${scope})...`);
+  const ins = io.run("claude", ["plugin", "install", PLUGIN, "--scope", scope]);
+  if (ins.code === 0) { io.log(`  Claude Code 플러그인 설치 완료 (scope: ${scope})`); return true; }
+  io.log(`  플러그인 설치 실패. 수동: claude plugin install ${PLUGIN} --scope ${scope}`);
+  return false;
+}
+
+function update(io, scope) {
+  const cacheRoot = join(io.home(), ".claude/plugins/cache/cassiiopeia-marketplace/cassiiopeia");
+  const oldCache = latestCacheDir(cacheRoot);
+  io.log("플러그인 업데이트 중...");
+  const up = io.run("claude", ["plugin", "update", PLUGIN, "--scope", scope]);
+  if (up.code !== 0) { io.log(`  업데이트 실패. 수동: claude plugin update ${PLUGIN} --scope ${scope}`); return false; }
+  io.log(`  업데이트 완료 (scope: ${scope})`);
+  migrateConfig(io, oldCache, latestCacheDir(cacheRoot));
+  return true;
+}
+
+function remove(io) {
+  const st = detect(io);
+  if (st.cliMissing || !st.installed) { io.log("  설치된 Claude Code 플러그인이 없어 건너뜁니다"); return true; }
+  io.log(`  제거할 대상: ${PLUGIN} (scope: ${st.scope})`);
+  const un = io.run("claude", ["plugin", "uninstall", PLUGIN, "--scope", st.scope]);
+  if (un.code === 0) { io.log("  플러그인 uninstall 완료"); removePluginData(io); return true; }
+  io.log(`  삭제 실패. 수동: claude plugin uninstall ${PLUGIN} --scope ${st.scope}`);
+  return false;
+}
+
+function manualHint() {
+  return `  💡 Claude Code 사용자: claude plugin marketplace add ${MARKETPLACE}\n     claude plugin install ${PLUGIN} --scope user`;
+}
+
+// ── 내부 헬퍼 ──
+function latestCacheDir(root) {
+  if (!existsSync(root)) return "";
+  const dirs = readdirSync(root, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name).sort(compareCacheName);
+  return dirs.length ? join(root, dirs[dirs.length - 1]) : "";
+}
+function migrateConfig(io, oldCache, newCache) {
+  if (!oldCache || !newCache || oldCache === newCache) return;
+  const oldCfg = join(oldCache, "config"), newCfg = join(newCache, "config");
+  if (!existsSync(oldCfg)) return;
+  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++; }
+    if (copied) io.log("  config.json 마이그레이션 완료 (이전 버전 설정 유지)");
+  } catch { /* 무해 */ }
+}
+function removePluginData(io) {
+  const dataDir = join(io.home(), ".claude/plugins/data", PLUGIN);
+  if (existsSync(dataDir)) { try { rmSync(dataDir, { recursive: true, force: true }); io.log("  플러그인 데이터(config) 삭제 완료"); } catch { /* 무해 */ } }
+}
+
+export const claudeAdapter = {
+  id: "claude", label: "Claude Code", order: 10,
+  detect, apply, remove, manualHint,
+};

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

@@ -0,0 +1,49 @@
+// Codex CLI 어댑터 (.sh _manage_codex_skills / _do_codex_marketplace_register /
+// _remove_codex_section 등가).
+// marketplace 등록/업그레이드가 주 경로. native ~/.agents/skills/cassiiopeia 심링크는 감지·제거에 사용.
+import { join } from "node:path";
+import { existsSync, lstatSync, rmSync } from "node:fs";
+
+const MARKETPLACE = "Cassiiopeia/projectops";
+const PLUGIN = "cassiiopeia";
+
+function nativeTarget(io) { return join(io.home(), ".agents/skills/cassiiopeia"); }
+
+function detect(io) {
+  const tgt = nativeTarget(io);
+  const nativeInstalled = existsSync(tgt);
+  if (nativeInstalled) return { installed: true, version: null, cliMissing: false, note: "native skills" };
+  if (!io.which("codex")) return { installed: false, version: null, cliMissing: true, note: "CLI 없음" };
+  return { installed: false, version: null, cliMissing: false, note: "설치 가능 (CLI 감지됨)" };
+}
+
+function apply(io) {
+  if (!io.which("codex")) { io.log(manualHint()); return false; }
+  io.log("Codex plugin marketplace 등록 중...");
+  const add = io.run("codex", ["plugin", "marketplace", "add", MARKETPLACE]);
+  io.log(add.code === 0 ? "  Codex marketplace 등록 완료" : "  Codex marketplace 이미 등록되어 있거나 등록 생략");
+  io.log("Codex plugin marketplace 업데이트 중...");
+  if (io.run("codex", ["plugin", "marketplace", "upgrade", PLUGIN]).code === 0) { io.log("  Codex marketplace 등록 완료 (/plugins 확인)"); return true; }
+  io.log(`  Codex marketplace 관리 오류 — 수동: codex plugin marketplace add ${MARKETPLACE}`);
+  return false;
+}
+
+function remove(io) {
+  const tgt = nativeTarget(io);
+  let removed = false;
+  if (existsSync(tgt) || isSymlink(tgt)) {
+    try { rmSync(tgt, { recursive: true, force: true }); io.log(`  Codex native skills 제거 완료 (${tgt})`); removed = true; } catch { /* 무해 */ }
+  }
+  if (!removed) io.log("  제거할 Codex skills가 없어 건너뜁니다");
+  if (io.which("codex")) io.log(`  marketplace 등록 해제는 수동: codex plugin marketplace remove ${PLUGIN}`);
+  return true;
+}
+
+function manualHint() { return `  💡 Codex CLI: codex plugin marketplace add ${MARKETPLACE}`; }
+
+function isSymlink(p) { try { return lstatSync(p).isSymbolicLink(); } catch { return false; } }
+
+export const codexAdapter = {
+  id: "codex", label: "Codex CLI", order: 40,
+  detect, apply, remove, manualHint,
+};

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

@@ -0,0 +1,76 @@
+// Cursor 어댑터 (.sh _manage_cursor_section / _do_cursor_skills_copy /
+// _write_cursor_skills_meta / _remove_cursor_section 등가).
+// 마켓플레이스 없음 → ~/.cursor/skills/ 에 skills/ 폴더를 복사하고 meta.json으로 버전 추적.
+import { join } from "node:path";
+import { existsSync, readFileSync, mkdirSync, cpSync, rmSync, writeFileSync, readdirSync } from "node:fs";
+
+function metaPath(io) { return join(io.home(), ".cursor/skills/cursor-skills-meta.json"); }
+
+function detect(io) {
+  const mp = metaPath(io);
+  if (!existsSync(mp)) return { installed: false, version: null, cliMissing: false };
+  let version = null;
+  try {
+    const m = JSON.parse(readFileSync(mp, "utf8"));
+    version = m.version || null;
+  } catch { /* meta 손상 → 설치는 됐다고 봄 */ }
+  return { installed: true, version, cliMissing: false };
+}
+
+function apply(io, ctx = {}) {
+  const src = resolveSkillsSrc(ctx);
+  if (!src) { io.log("  설치할 스킬 소스를 찾지 못했습니다 (skills/ 폴더 필요)."); return false; }
+  const dest = join(io.home(), ".cursor/skills");
+  io.log("Cursor Skills 복사 중...");
+  try {
+    mkdirSync(dest, { recursive: true });
+    for (const e of readdirSync(src, { withFileTypes: true })) {
+      cpSync(join(src, e.name), join(dest, e.name), { recursive: true });
+    }
+    writeMeta(io, dest, ctx.templateVersion);
+    io.log(`  Cursor Skills 설치 완료 (${dest}/, v${ctx.templateVersion || "unknown"})`);
+    return true;
+  } catch {
+    io.log("  Cursor Skills 복사 실패 — skills/ 폴더를 확인하세요.");
+    return false;
+  }
+}
+
+function remove(io) {
+  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; }
+}
+
+function manualHint() {
+  return "  💡 Cursor: skills/ 폴더를 ~/.cursor/skills/ 로 복사하면 됩니다.";
+}
+
+// ── 헬퍼 ──
+// 스킬 소스: 다운로드된 템플릿(TEMP)/skills 우선, 없으면 로컬 skills/.
+function resolveSkillsSrc(ctx) {
+  const cands = [ctx.sourceSkillsDir, ctx.tempDir && join(ctx.tempDir, "skills"), "skills"].filter(Boolean);
+  for (const c of cands) if (existsSync(c)) return c;
+  return "";
+}
+
+function writeMeta(io, destDir, templateVersion) {
+  const version = templateVersion || "unknown";
+  const now = new Date().toISOString().replace(/\.\d+Z$/, "Z");
+  const file = join(destDir, "cursor-skills-meta.json");
+  let installedAt = now;
+  if (existsSync(file)) { try { installedAt = JSON.parse(readFileSync(file, "utf8")).installedAt || now; } catch { /* 무해 */ } }
+  const meta = {
+    name: "cassiiopeia", version, scope: "user",
+    source: "https://github.com/Cassiiopeia/projectops",
+    installPath: destDir, installedAt, lastUpdated: now,
+  };
+  mkdirSync(destDir, { recursive: true });
+  writeFileSync(file, JSON.stringify(meta, null, 2) + "\n");
+}
+
+export const cursorAdapter = {
+  id: "cursor", label: "Cursor", order: 20,
+  detect, apply, remove, manualHint,
+};

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

@@ -0,0 +1,34 @@
+// Gemini CLI 어댑터 (.sh _manage_gemini_extension / _remove_gemini_section 등가).
+// extension install/update/uninstall. 마켓플레이스 대신 git URL 확장.
+const EXT = "cassiiopeia";
+const URL = "https://github.com/Cassiiopeia/projectops";
+
+function detect(io) {
+  if (!io.which("gemini")) return { installed: false, version: null, cliMissing: true, note: "CLI 없음" };
+  // .sh는 gemini 설치 상태를 정밀 조회하지 않고 "설치 가능"으로만 표기 → installed 미상.
+  return { installed: false, version: null, cliMissing: false, note: "설치 가능 (CLI 감지됨)" };
+}
+
+function apply(io) {
+  if (!io.which("gemini")) { io.log(manualHint()); return false; }
+  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 설치 중...");
+  if (io.run("gemini", ["extensions", "install", URL]).code === 0) { io.log("  Gemini CLI extension 설치 완료"); return true; }
+  io.log(`  Gemini extension 관리 오류 — 수동: gemini extensions install ${URL}`);
+  return false;
+}
+
+function remove(io) {
+  if (!io.which("gemini")) { io.log("  gemini CLI 미감지 — 건너뜁니다"); return true; }
+  if (io.run("gemini", ["extensions", "uninstall", EXT]).code === 0) { io.log("  Gemini CLI extension 제거 완료"); return true; }
+  io.log(`  제거할 Gemini extension이 없거나 실패 — 수동: gemini extensions uninstall ${EXT}`);
+  return true; // 미설치 제거는 실패로 보지 않음
+}
+
+function manualHint() { return `  💡 Gemini CLI: gemini extensions install ${URL}`; }
+
+export const geminiAdapter = {
+  id: "gemini", label: "Gemini CLI", order: 30,
+  detect, apply, remove, manualHint,
+};

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

@@ -0,0 +1,63 @@
+// PI 공용 경로·상태 로직 (pi 어댑터와 pi-harness 어댑터가 공유).
+// .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";
+
+export const PI_PACKAGE_URL = "https://github.com/Cassiiopeia/projectops";
+
+// 'pi list' 출력에 우리 레포가 잡히면 설치됨. (구 레포명·프로젝트명 모두 허용)
+export function piInstalled(io) {
+  if (!io.which("pi")) return false;
+  const r = io.run("pi", ["list"]); // pi는 일부 출력을 stderr로 보냄 → 둘 다 검사
+  const out = (r.stdout || "") + (r.stderr || "");
+  return /SUH-DEVOPS-TEMPLATE|projectops|cassiiopeia/i.test(out);
+}
+
+// pi 클론 경로(harness loader가 사는 곳). 레포명 변경 전 구 경로 하위호환.
+export function piCloneDir(io) {
+  const base = join(io.home(), ".pi/agent/git/github.com/Cassiiopeia");
+  const newDir = join(base, "projectops");
+  const oldDir = join(base, "SUH-DEVOPS-TEMPLATE");
+  return (!existsSync(newDir) && existsSync(oldDir)) ? oldDir : newDir;
+}
+
+export function harnessLoaderPath(io) { return join(piCloneDir(io), "harness/harness-loader.ts"); }
+export function piSettingsPath(io) { return join(io.home(), ".pi/agent/settings.json"); }
+
+// settings.json의 extensions 배열에 loader가 등록돼 있는가.
+export function harnessEnabled(io) {
+  const settings = piSettingsPath(io), loader = harnessLoaderPath(io);
+  if (!existsSync(settings)) return false;
+  try {
+    const s = JSON.parse(readFileSync(settings, "utf8"));
+    return Array.isArray(s.extensions) && s.extensions.includes(loader);
+  } catch { return false; }
+}
+
+// extensions에 loader 추가(중복 방지). {ok, reason}.
+export function harnessAdd(io) {
+  const settings = piSettingsPath(io), loader = harnessLoaderPath(io);
+  if (!existsSync(settings)) return { ok: false, reason: "no-settings" };
+  if (!existsSync(loader)) return { ok: false, reason: "no-loader" };
+  let s = {};
+  try { s = JSON.parse(readFileSync(settings, "utf8")); } catch { s = {}; }
+  const exts = (Array.isArray(s.extensions) ? s.extensions : []).filter(Boolean);
+  if (!exts.includes(loader)) exts.push(loader);
+  s.extensions = exts;
+  writeFileSync(settings, JSON.stringify(s, null, 2));
+  return { ok: true };
+}
+
+// extensions에서 loader 제거. {ok}.
+export function harnessRemove(io) {
+  const settings = piSettingsPath(io), loader = harnessLoaderPath(io);
+  if (!existsSync(settings)) return { ok: true };
+  let s;
+  try { s = JSON.parse(readFileSync(settings, "utf8")); } catch { return { ok: true }; }
+  if (Array.isArray(s.extensions)) {
+    s.extensions = s.extensions.filter((e) => e && e !== loader);
+    writeFileSync(settings, JSON.stringify(s, null, 2));
+  }
+  return { ok: true };
+}

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

@@ -0,0 +1,48 @@
+// PI Persona Harness 어댑터 (.sh _pi_harness_toggle / _pi_harness_remove_only /
+// _pi_harness_add / _pi_harness_remove / _pi_harness_enabled 등가).
+// PI skill과 독립 — skill은 그대로 두고 harness 등록(settings.json extensions)만 켜고/끈다.
+import { existsSync } from "node:fs";
+import { harnessEnabled, harnessAdd, harnessRemove, harnessLoaderPath } from "./pi-common.js";
+
+// 이 어댑터는 "설치 가능" 여부가 pi 존재 + loader 파일 존재에 달림.
+function available(io) { return !!io.which("pi") && existsSync(harnessLoaderPath(io)); }
+
+function detect(io) {
+  if (!io.which("pi")) return { installed: false, version: null, cliMissing: true, note: "PI 없음" };
+  if (!existsSync(harnessLoaderPath(io))) return { installed: false, version: null, cliMissing: true, note: "loader 없음 (PI 설치 필요)" };
+  return { installed: harnessEnabled(io), version: null, cliMissing: false, note: harnessEnabled(io) ? "활성화됨" : "비활성화" };
+}
+
+// apply = harness 활성화 (skill은 안 건드림).
+function apply(io) {
+  if (!available(io)) { io.log("  harness loader가 없습니다 — 먼저 PI를 설치하세요."); return false; }
+  if (harnessEnabled(io)) { io.log("  Persona Harness: 이미 활성화됨 (유지)"); return true; }
+  const r = harnessAdd(io);
+  if (r.ok) { io.log("  Persona Harness 활성화 완료 — PI 재시작 후 적용됩니다."); return true; }
+  io.log(r.reason === "no-settings" ? "  PI settings.json이 없습니다 — PI를 한 번 실행한 뒤 다시 시도하세요."
+    : "  harness loader가 없습니다 — 먼저 PI 패키지를 설치/업데이트하세요.");
+  return false;
+}
+
+// remove = harness만 해제 (PI skill 보존).
+function remove(io) {
+  if (!harnessEnabled(io)) { io.log("  Persona Harness가 활성화돼 있지 않아 건너뜁니다"); return true; }
+  io.log("  PI skill은 그대로 두고 harness 등록만 해제합니다.");
+  harnessRemove(io);
+  io.log("  Persona Harness 해제 완료 — PI 재시작 후 적용됩니다.");
+  return true;
+}
+
+function manualHint() { return "  💡 PI Persona Harness: PI 설치 후 settings.json extensions 에 harness-loader.ts 등록"; }
+
+// harness 설명 (프롬프트에서 재사용).
+export const HARNESS_DESC = [
+  "Persona Harness는 PI가 대화를 시작할 때마다 '전문가 페르소나'와 'SDLC 워크플로우'를",
+  "시스템 프롬프트에 자동 주입하는 기능입니다 (skill과 독립적으로 켜고/끌 수 있음).",
+].join("\n");
+
+export const piHarnessAdapter = {
+  id: "pi-harness", label: "PI Persona Harness", order: 60,
+  optional: true, // 감지된 경우에만 메뉴 노출 (registry 순회 시 참고)
+  detect, apply, remove, manualHint,
+};

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

@@ -0,0 +1,45 @@
+// 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";
+
+function detect(io) {
+  if (!io.which("pi")) return { installed: false, version: null, cliMissing: true, note: "CLI 없음" };
+  return { installed: piInstalled(io), version: null, cliMissing: false };
+}
+
+function apply(io) {
+  if (!io.which("pi")) { io.log(manualHint()); return false; }
+  if (piInstalled(io)) {
+    io.log("PI 패키지 업데이트 중...");
+    if (io.run("pi", ["update", PI_PACKAGE_URL]).code !== 0) io.run("pi", ["install", PI_PACKAGE_URL]);
+  } else {
+    io.log("PI 패키지 설치 중...");
+    io.run("pi", ["install", PI_PACKAGE_URL]);
+  }
+  if (piInstalled(io)) {
+    io.log("  PI 패키지 설치 / 업데이트 완료");
+    io.log("  → 'pi' 재실행 후 'pi list' 로 확인, 채팅창에서 /suh-analyze 등 호출");
+    return true;
+  }
+  io.log(`  PI 설치/업데이트 실패 — 수동: pi install ${PI_PACKAGE_URL}`);
+  return false;
+}
+
+function remove(io) {
+  if (!io.which("pi")) { io.log("  pi CLI 미감지 — 건너뜁니다"); return true; }
+  if (!piInstalled(io)) { io.log("  설치된 PI 패키지가 없어 건너뜁니다"); return true; }
+  io.log(`  pi remove ${PI_PACKAGE_URL}`);
+  io.run("pi", ["remove", PI_PACKAGE_URL]);
+  if (piInstalled(io)) io.log("  제거 후에도 패키지가 남아있습니다 — 'pi list'로 확인하세요.");
+  else io.log("  PI 패키지 제거 완료");
+  // package 클론이 사라지면 harness loader 경로가 허공을 가리킴 → 함께 해제
+  if (harnessEnabled(io)) { io.log("  Persona Harness 등록도 함께 해제됩니다."); harnessRemove(io); }
+  return true;
+}
+
+function manualHint() { return `  💡 PI: pi install ${PI_PACKAGE_URL}`; }
+
+export const piAdapter = {
+  id: "pi", label: "PI", order: 50,
+  detect, apply, remove, manualHint,
+};

package/src/core/ide/registry.js

@@ -0,0 +1,27 @@
+// IDE 어댑터 레지스트리 — 유일한 확장 지점.
+//
+// 새 IDE를 지원하려면:
+//   1) src/core/ide/adapters/<name>.js 에 어댑터 객체(adapter.js 계약) 작성
+//   2) 아래에 import 추가하고 ADAPTERS 배열에 넣기
+// 오케스트레이터·프롬프트·index 라우팅은 이 배열만 순회하므로 다른 파일은 손대지 않는다.
+import { assertAdapter } from "./adapter.js";
+import { claudeAdapter } from "./adapters/claude.js";
+import { cursorAdapter } from "./adapters/cursor.js";
+import { geminiAdapter } from "./adapters/gemini.js";
+import { codexAdapter } from "./adapters/codex.js";
+import { piAdapter } from "./adapters/pi.js";
+import { piHarnessAdapter } from "./adapters/pi-harness.js";
+
+// order 오름차순 정렬 + 계약 검증.
+export const ADAPTERS = [
+  claudeAdapter,
+  cursorAdapter,
+  geminiAdapter,
+  codexAdapter,
+  piAdapter,
+  piHarnessAdapter,
+].map(assertAdapter).sort((a, b) => (a.order ?? 100) - (b.order ?? 100));
+
+export function adapterById(id) {
+  return ADAPTERS.find((a) => a.id === id) || null;
+}

package/src/core/ide/runner.js

@@ -0,0 +1,59 @@
+// 외부 CLI 실행·감지 래퍼 (.sh command -v / CLI 호출 등가).
+// 전부 주입 가능 — 테스트는 stub runner/which/home 를 넘겨 실제 CLI 없이 검증한다.
+import { spawnSync } from "node:child_process";
+import { delimiter, join } from "node:path";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+
+// which(cmd) → 실행 파일 절대경로 or null. PATH를 직접 스캔 (execa 없이 내장만).
+// Windows는 PATHEXT 확장자(.cmd/.exe/.bat 등)까지 시도.
+export function which(cmd) {
+  const paths = (process.env.PATH || "").split(delimiter).filter(Boolean);
+  const exts = process.platform === "win32"
+    ? (process.env.PATHEXT || ".COM;.EXE;.BAT;.CMD").split(";").filter(Boolean)
+    : [""];
+  for (const dir of paths) {
+    for (const ext of exts) {
+      const full = join(dir, cmd + ext);
+      if (existsSync(full)) return full;
+    }
+  }
+  return null;
+}
+
+// run(cmd, args, opts) → {code, stdout, stderr}. 동기 실행.
+// opts.cwd, opts.env 지원. 실행 자체 실패(파일 없음 등)면 code=127.
+//
+// Windows: claude/gemini/codex/pi 는 .cmd/.ps1 셸 런처라 spawnSync가 직접 못 띄운다.
+// shell:true + args 배열은 DEP0190(인자 미이스케이프) 경고 → cmd.exe에 안전 인용한 단일
+// 명령 문자열을 넘긴다. args는 우리가 만든 하드코딩 값 + URL/scope뿐이라 신뢰 가능하지만,
+// 그래도 큰따옴표로 감싸 공백·특수문자를 방어한다.
+export function run(cmd, args = [], opts = {}) {
+  const common = { cwd: opts.cwd, env: opts.env || process.env, encoding: "utf8", windowsHide: true };
+  let r;
+  if (process.platform === "win32") {
+    const line = [cmd, ...args].map(winQuote).join(" ");
+    r = spawnSync(line, { ...common, shell: true });
+  } else {
+    r = spawnSync(cmd, args, common); // POSIX는 shell 불필요(안전)
+  }
+  if (r.error) return { code: 127, stdout: "", stderr: String(r.error.message || r.error) };
+  return { code: r.status ?? 0, stdout: r.stdout || "", stderr: r.stderr || "" };
+}
+
+// cmd.exe용 인용: 이미 안전한 토큰(영숫자·경로·URL 문자)이면 그대로, 아니면 "..." 로 감싸고 내부 " 이스케이프.
+function winQuote(s) {
+  if (/^[A-Za-z0-9_./:@=-]+$/.test(s)) return s;
+  return '"' + String(s).replace(/"/g, '\\"') + '"';
+}
+
+// IDE 실행 컨텍스트 기본값. 테스트는 이 shape을 스텁으로 대체.
+//   which(cmd)→path|null, run(cmd,args)→{code,stdout,stderr}, home()→string, log(msg)
+export function defaultIo() {
+  return {
+    which,
+    run,
+    home: () => homedir(),
+    log: (msg) => console.error(msg), // .sh는 안내를 stderr로 출력
+  };
+}

package/src/core/ide/util.js

@@ -0,0 +1,18 @@
+// IDE 어댑터 공용 유틸.
+
+// sort -V 근사: 버전형 디렉토리/문자열 비교기. "3.0.9" < "3.0.10" 을 올바로 정렬.
+export function compareCacheName(a, b) {
+  const pa = a.split(".").map((n) => parseInt(n, 10) || 0);
+  const pb = b.split(".").map((n) => parseInt(n, 10) || 0);
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const d = (pa[i] || 0) - (pb[i] || 0);
+    if (d) return d;
+  }
+  return a.localeCompare(b);
+}
+
+// 상태 → 표시 태그 (" ✓ 최신" / " → 업데이트 가능: vX"). templateVersion 없으면 빈 문자열.
+export function versionTag(installedVersion, templateVersion) {
+  if (!templateVersion || !installedVersion) return "";
+  return installedVersion === templateVersion ? " ✓ 최신" : ` → 업데이트 가능: v${templateVersion}`;
+}

package/src/core/paths.js

@@ -0,0 +1,14 @@
+// 경로 상수 (.sh readonly 상수군 등가) — template_integrator.sh 113~137
+export const PATHS = {
+  tempDir: ".template_download_temp",
+  versionFile: "version.yml",
+  workflowsDir: ".github/workflows",
+  scriptsDir: ".github/scripts",
+  projectTypesDir: "project-types",
+};
+
+export const TEMPLATE_RAW_URL = "https://raw.githubusercontent.com/Cassiiopeia/projectops/main";
+export const TEMPLATE_REPO = "https://github.com/Cassiiopeia/projectops.git";
+export const WORKFLOW_PREFIX = "PROJECT";
+export const WORKFLOW_COMMON_PREFIX = "PROJECT-COMMON";
+export const WORKFLOW_TEMPLATE_INIT = "PROJECT-TEMPLATE-INITIALIZER.yaml";