@rch4com/agent-setup 1.28.0 → 2.0.0

package/lib/tui/detail.mjs

@@ -6,7 +6,6 @@
 // 렌더 층의 의존성이 된다. 그래서 사유 그룹핑이 rows가 아니라 여기 있고,
 // rows.mjs가 반대로 여기서 가져다 쓴다.
 import { toText, createT } from '../i18n/index.mjs'
-import { CLIS } from '../clis.mjs'
 import { categoryLabel } from '../design-md/flow.mjs'
 import { cut, labelWidth, pad, width, wrap } from '../width.mjs'
 
@@ -68,36 +67,17 @@ function wrapNames(names, limit) {
 function wiredLines(item, w, lead, t) {
   const supports = item.supports ?? []
   if (supports.length === 0) return []
-  // 경로는 MCP에서만 붙인다. 그때만 clis.mjs 어댑터가 경로의 유일한 진실이다 —
-  // plugin·skill은 설치 자리가 항목마다 달라 어댑터가 알지 못한다.
-  const showFile = item.category === 'mcp'
-  // 경로가 없으면 세로로 늘어놓을 이유가 없다 — CLI 열한 개를 한 줄에 하나씩
-  // 놓으면 80×24에서 `배선 ✔ claude` 뒤가 `…외 9줄`로 잘려 정작 "어디에
-  // 되나"를 펼쳐야만 읽을 수 있었다. 이름을 ·로 이어 접는다(미배선과 같은 꼴).
-  if (!showFile) {
-    return wrapNames(supports, Math.max(1, w - lead - 2)).map((line, i) =>
-      cut(`${i === 0 ? pad(t('detail.wired'), lead) : ' '.repeat(lead)}${i === 0 ? '✔ ' : '  '}${line}`, w))
-  }
-  // MCP는 "CLI 경로" 쌍을 한 줄에 들어가는 만큼 채운다. 한 줄에 하나씩 놓으면
-  // 열 개가 열 줄이라 80×24 패널에서 절반이 `…외 N줄`로 접혔다. 폭이 좁으면
-  // 한 줄에 하나로 자연히 돌아간다.
-  const pairs = supports.map((cli) => (CLIS[cli]?.file ? `${cli} ${CLIS[cli].file}` : cli))
-  const colW = Math.max(...pairs.map((p) => width(p))) + 3
-  const room = Math.max(1, w - lead - 2)
-  const perLine = Math.max(1, Math.floor(room / colW))
-  const rows = []
-  for (let i = 0; i < pairs.length; i += perLine) {
-    const chunk = pairs.slice(i, i + perLine)
-    rows.push(chunk.map((p, j) => (j < chunk.length - 1 ? pad(p, colW) : p)).join(''))
-  }
-  return rows.map((line, i) => cut(`${i === 0 ? pad(t('detail.wired'), lead) : ' '.repeat(lead)}${i === 0 ? '✔ ' : '  '}${line}`, w))
+  // 설치는 각 CLI의 명령이 맡아 이 설치기가 쓰는 설정 파일이 없다 — 이름만
+  // ·로 이어 접는다(미배선과 같은 꼴).
+  return wrapNames(supports, Math.max(1, w - lead - 2)).map((line, i) =>
+    cut(`${i === 0 ? pad(t('detail.wired'), lead) : ' '.repeat(lead)}${i === 0 ? '✔ ' : '  '}${line}`, w))
 }
 
 function unwiredLines(item, w, lead, t) {
   const out = []
   unsupportedGroups(item, t).forEach((group, i) => {
     const head = i === 0 ? pad(t('detail.unwired'), lead) : ' '.repeat(lead)
-    // 미배선 CLI 이름도 같은 규칙으로 접는다 — 11개를 한 줄에 두면 뒤가 잘린다.
+    // 미배선 CLI 이름도 같은 규칙으로 접는다 — 여럿을 한 줄에 두면 좁은 화면에서 뒤가 잘린다.
     wrapNames(group.clis, Math.max(1, w - lead - 2)).forEach((line, j) => {
       out.push(cut(`${j === 0 ? head : ' '.repeat(lead)}${j === 0 ? '✖ ' : '  '}${line}`, w))
     })

package/lib/tui/rows.mjs

@@ -3,7 +3,8 @@
 import { existsSync } from 'node:fs'
 import { join } from 'node:path'
 import { scan } from '../engine.mjs'
-import { loadItems } from '../catalog.mjs'
+import { loadItems, makeExec } from '../catalog.mjs'
+import { createProbe } from '../probe.mjs'
 import { CLI_IDS } from '../clis.mjs'
 import { runBootstrap } from '../bootstrap/flow.mjs'
 import { MANIFEST } from '../bootstrap/manifest.mjs'
@@ -30,7 +31,7 @@ export const SECTION_ORDER = [ACTION_SECTION, 'plugin', 'mcp', 'skill', 'config'
 // __commit은 CONFIG 탭에만 나오지만 규칙은 같다 — 헤더가 "무엇을 고르는
 // 자리인가"를 말한다. 커밋 템플릿은 대상 파일이 하나뿐이라 헤더에 그 파일
 // 이름과 "하나만"이라는 규칙까지 실어, 라디오 표시와 함께 읽히게 한다.
-export const GROUP_ORDER = ['__scope-project', '__scope-user', '__token', '__context', '__style', '__flow', '__commit', '__service']
+export const GROUP_ORDER = ['__token', '__context', '__style', '__flow', '__commit', '__service']
 
 function groupRank(group) {
   const i = GROUP_ORDER.indexOf(group)
@@ -106,7 +107,7 @@ export function designHint(state, multiProvider = false, t) {
   return parts.filter(Boolean).join(' · ')
 }
 
-// 이름을 나열할 수 있는 최대 CLI 수. 넷까지는 이름(codex·gemini·opencode·copilot)이
+// 이름을 나열할 수 있는 최대 CLI 수. 넷까지는 이름(claude·codex·opencode·antigravity)이
 // 80칸 힌트 자리에 들고, 그보다 많으면 "몇 개나 되나"가 더 유용하다.
 const NAME_LIMIT = 4
 
@@ -152,7 +153,7 @@ export function designShortHint(state, multiProvider = false, t = createT('en'))
 
 // group = 탭 **안쪽**의 소분류 헤더. design.md만 76개라 카테고리로 갈라야 읽힌다.
 // 나머지 탭은 항목이 적어 그룹 없이 평평하게 둔다.
-function itemRow({ id, section, label, hint, fullHint = hint, statusDetail = null, status, previewTarget = null, item, extra = '', group = null, t = createT('en') }) {
+function itemRow({ id, section, label, hint, fullHint = hint, statusDetail = null, status, previewTarget = null, item, result = null, extra = '', group = null, t = createT('en') }) {
   return {
     kind: 'item',
     id,
@@ -171,6 +172,7 @@ function itemRow({ id, section, label, hint, fullHint = hint, statusDetail = nul
     status,
     previewTarget,
     item,
+    result,
     searchText: `${label} ${fullHint} ${sectionTerms(t, section)} ${extra}`.toLowerCase(),
   }
 }
@@ -202,7 +204,7 @@ function bootstrapHint(root, t) {
   return t('action.bootstrap.hint', { present, total: MANIFEST.files.length })
 }
 
-export function buildActions(root, { designItems = [], t = createT('en') } = {}) {
+export function buildActions(root, { designItems = [], scope = 'project', t = createT('en') } = {}) {
   return [
     // 맨 위 상주 행. 실행은 run.mjs가 특수 처리한다 — 화면을 벗어나지 않고
     // 그 자리에서 t를 갈아끼워야 하므로 다른 액션과 흐름이 다르다(run은 null).
@@ -212,6 +214,14 @@ export function buildActions(root, { designItems = [], t = createT('en') } = {})
       hint: t('action.language.hint', { current: t(`locale.${t.locale}`) }),
       t,
     }),
+    // 언어 행과 같은 방식 — run.mjs가 그 자리에서 범위를 바꾸고 다시 스캔한다.
+    // 목록 포커스의 글자 키는 검색칸으로 올라가므로 단축키 대신 행으로 둔다.
+    actionRow({
+      id: 'action.scope',
+      label: t('action.scope.label'),
+      hint: t('action.scope.hint', { current: t(`scope.${scope}`) }),
+      t,
+    }),
     actionRow({
       id: 'action.bootstrap',
       label: t('action.bootstrap.label'),
@@ -270,18 +280,16 @@ export function buildRows({ actions = [], agentStates = [], designStates = [], m
       itemRow({
         id: s.item.id,
         section: s.item.category,
-        // plugin 탭은 성격이 아니라 설치 범위로 가른다 — 같은 상류의 두 판
-        // (저장소/전역)이 무엇을 건드리는지가 이 탭에서 고르는 기준이다.
-        // 표시 계층의 오버라이드다: 항목의 group 필드는 성격의 진실로 남는다.
-        group: s.item.category === 'plugin'
-          ? (s.item.scope === 'user' ? '__scope-user' : '__scope-project')
-          : s.item.group ?? null,
+        // 범위는 실행당 하나(작업 탭의 범위 행)라 plugin 탭도 성격으로 가른다.
+        group: s.item.group ?? null,
         label: scopedLabel(s.item, t),
         hint: agentShortHint(s.item, s, t),
         fullHint: agentHint(s.item, s, t),
         statusDetail: toText(t, s.detail) ?? null,
         status: s.status,
         item: s.item,
+        // 감지 결과 — 변경 계획이 어느 CLI에 이미 있는지(present)를 여기서 읽는다.
+        result: s.result ?? null,
         extra: s.item.id,
         t,
       }),
@@ -324,7 +332,10 @@ export function buildRows({ actions = [], agentStates = [], designStates = [], m
 export async function collectRows(root, opts = {}) {
   const { fetchImpl = netFetch, designDirs = [], env = process.env, catalogFile = CATALOG_PATH, log = () => {}, t = createT('en') } = opts
 
-  const agentItems = await loadItems()
+  const scope = opts.scope ?? 'project'
+  const agentItems = await loadItems({ scope })
+  // 스캔마다 새 감지 캐시 — 적용 뒤 재스캔이 적용 전 목록을 읽으면 안 된다.
+  const probe = createProbe({ root, scope, exec: makeExec(false) })
   const catalog = loadCatalog(catalogFile)
   const sources = opts.sources ?? discoverSources({
     ...(opts.bundleDir ? { bundleDir: opts.bundleDir } : {}),
@@ -334,12 +345,12 @@ export async function collectRows(root, opts = {}) {
   })
   const designItems = buildItems(catalog, { fetchImpl, sources })
 
-  const [agentStates, designStates] = await Promise.all([scan(root, agentItems), scan(root, designItems)])
+  const [agentStates, designStates] = await Promise.all([scan(root, agentItems, { probe }), scan(root, designItems)])
   const multiProvider = new Set(designItems.map((i) => i.providerId)).size > 1
 
   return {
     rows: buildRows({
-      actions: buildActions(root, { designItems, t }),
+      actions: buildActions(root, { designItems, scope, t }),
       agentStates,
       designStates,
       multiProvider,

package/lib/tui/run.mjs

@@ -15,6 +15,8 @@ import {
 import { render, renderReview, renderHelp, bodyHeight, footerHeight } from './render.mjs'
 import { createProgress, applyEvent, progressLines } from './progress.mjs'
 import { scopedLabel } from '../labels.mjs'
+import { planCommands, formatCommands } from '../commands.mjs'
+import { activationLines } from '../activation.mjs'
 
 const ESC = String.fromCharCode(27)
 const HIDE_CURSOR = `${ESC}[?25l`
@@ -53,7 +55,7 @@ function keyReader(stdin) {
 }
 
 function itemStates(rows) {
-  return rows.filter((r) => r.kind === 'item').map((r) => ({ item: r.item, status: r.status }))
+  return rows.filter((r) => r.kind === 'item').map((r) => ({ item: r.item, status: r.status, result: r.result }))
 }
 
 // row.section은 이제 소문자 id다(rows.mjs Task 9) — t 없이 그대로 찍으면
@@ -92,8 +94,10 @@ export async function runTui(root, opts = {}) {
   const opener = opts.opener ?? makeOpener(dryRun, log)
   // let으로 둔다 — 언어 전환 행(cycleLanguage)이 실행 중에 갈아끼운다.
   let { t = createT('en'), localeForced = false } = opts
+  // 범위 행(action.scope)이 실행 중에 갈아끼운다.
+  let scope = opts.scope ?? 'project'
 
-  let collected = await collectRows(root, { fetchImpl, designDirs, env, catalogFile, log: () => {}, t })
+  let collected = await collectRows(root, { fetchImpl, designDirs, env, catalogFile, scope, log: () => {}, t })
 
   // raw 모드를 켤 수 없으면(CI·파이프) 목록만 내고 끝낸다.
   if (!stdin.isTTY || typeof stdin.setRawMode !== 'function') {
@@ -106,7 +110,7 @@ export async function runTui(root, opts = {}) {
   // 타이핑하면 검색칸으로 올라간다.
   let state = createState(collected.rows, { selectedIds: installedIds(collected.rows), focus: 'list' })
   let status = ''
-  // 순환 대상: 전체(null) + CLI 10개. state.mjs는 아무것도 import 하지 않으므로
+  // 순환 대상: 전체(null) + CLI 넷. state.mjs는 아무것도 import 하지 않으므로
   // 목록을 여기서 만들어 넘긴다.
   const CLI_OPTIONS = [null, ...CLI_IDS]
   let detailExpanded = false
@@ -165,7 +169,7 @@ export async function runTui(root, opts = {}) {
   // 실제 설치 상태로 되돌려야 한다 — 둘을 한 함수로 묶으면 언어를 바꿀 때
   // 사용자가 고르던 항목이 조용히 날아간다.
   const rebuild = async (keepSelection) => {
-    collected = await collectRows(root, { fetchImpl, designDirs, env, catalogFile, t, log: () => {} })
+    collected = await collectRows(root, { fetchImpl, designDirs, env, catalogFile, scope, t, log: () => {} })
     const ids = keepSelection ? [...state.selected] : installedIds(collected.rows)
     state = replaceRows(state, collected.rows, ids)
   }
@@ -227,6 +231,7 @@ export async function runTui(root, opts = {}) {
         if (key.ctrl && (key.name === 'c' || key.name === 'q')) return 'quit'
         if (key.name === 'escape') return 'cancel'
         if (key.name === 'return' || key.name === 'enter') return 'apply'
+        if (key.str === 'p') return 'print'
       }
     } finally {
       redraw = paint
@@ -256,7 +261,6 @@ export async function runTui(root, opts = {}) {
 
     try {
       const results = await apply(root, changes, {
-        dryRun,
         log: () => {}, // 로그는 진행 화면이 대신한다
         t,
         shouldStop: checkAbort,
@@ -385,6 +389,14 @@ export async function runTui(root, opts = {}) {
         const row = currentRow(state)
         // 언어 행은 화면을 벗어나지 않는다 — 그 자리에서 t를 갈아끼우고 다시 그린다.
         if (row?.id === 'action.language') { status = await cycleLanguage(); continue }
+        if (row?.id === 'action.scope') {
+          scope = scope === 'project' ? 'user' : 'project'
+          // 다른 범위의 설치 상태로 선택을 다시 맞춘다 — 저장소에서 고르던 체크가
+          // 전역 목록에 남으면 엉뚱한 항목이 설치된다.
+          await rebuild(false)
+          status = t('tui.scope.switched', { current: t(`scope.${scope}`) })
+          continue
+        }
         if (row?.kind === 'action') {
           await suspend(async () => {
             // 작업 하나의 예외가 화면 전체를 끌고 내려가면 안 된다 — 깨진
@@ -409,13 +421,24 @@ export async function runTui(root, opts = {}) {
         if (verdict === 'quit') break
         if (verdict === 'cancel') { status = t('tui.submitCancelled'); continue }
 
+        // --print로 띄웠거나 검토 화면에서 p를 눌렀다 — 실행 대신 같은 steps()의
+        // 명령을 화면 밖에 편다. 복사해 직접 돌릴 수 있어야 한다.
+        if (verdict === 'print' || dryRun) {
+          await suspend(async () => {
+            log('')
+            for (const line of formatCommands(planCommands(changes), { t, scope })) log(line)
+            for (const line of activationLines(changes, t)) log(line)
+            await pause()
+          })
+          continue
+        }
+
         const results = await runApply(changes)
 
         // 실패가 있으면 자세한 사연을 화면 밖에서 보여 준다 — 실패 메시지는
         // 길고, 화면 안에서 잘리면 진단이 불가능해진다. 성공해도 message가
-        // 붙은 결과(definePlugin·ponytail이 claude CLI 부재로 config 직접
-        // 기록으로 대체할 때 등)는 똑같이 사연이 있다 — ok만 보고 걸러내면
-        // 그 사연이 조용히 사라진다. 건너뜀은 실패가 아니다 — 진행 화면에
+        // 붙은 결과는 똑같이 사연이 있다 — ok만 보고 걸러내면 그 사연이
+        // 조용히 사라진다. 건너뜀은 실패가 아니다 — 진행 화면에
         // 이미 나타났고, 다시 여기 나열하면 사용자가 스스로 취소한 일을
         // 실패처럼 읽게 된다.
         const notable = results.filter((r) => !r.skipped && (!r.ok || r.message))
@@ -427,6 +450,10 @@ export async function runTui(root, opts = {}) {
               log(`  ${r.ok ? '✔' : '✖'} ${t(`change.${r.action}`)} ${scopedLabel(r.item, t)}${message ? ` — ${message}` : ''}`)
             }
           }
+          // 성공한 설치만 안내한다 — 실패한 항목에 "새 세션을 시작하라"고 하면 거짓이다.
+          const done = new Set(results.filter((r) => r.ok).map((r) => r.item.id))
+          const notes = activationLines(changes.filter((c) => done.has(c.item.id)), t)
+          if (notes.length > 0) log(`\n${notes.join('\n')}`)
           log(`\n${t('apply.seeGitDiff')}`)
           await pause()
         })

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@rch4com/agent-setup",
-  "version": "1.28.0",
+  "version": "2.0.0",
   "description": "Repository-scoped bootstrap and optional-item installer for using multiple coding-agent CLIs in one repository | 여러 코딩 에이전트 CLI를 한 저장소에서 함께 쓰기 위한 저장소 범위 부트스트랩과 선택 항목 설치기",
   "keywords": [
     "agents-md",
     "claude-code",
     "codex",
-    "gemini-cli",
-    "copilot",
+    "opencode",
+    "antigravity",
     "mcp",
     "agent-skills"
   ],

package/lib/claude-plugins.mjs

@@ -1,64 +0,0 @@
-import { repoPath, repoPathStrict } from './context.mjs'
-import { readJson, setKey, removeKey } from './jsonfile.mjs'
-
-const SETTINGS = '.claude/settings.json'
-
-function readSettings(root) {
-  return readJson(repoPath(root, SETTINGS)) ?? {}
-}
-
-// 쓰기 경로만 링크 이탈까지 검사한다 — 저장소 안 `.claude`가 홈을 가리키는
-// Junction이면 어휘적 검사는 통과하고 글로벌 settings.json이 수정된다.
-// clis.mjs의 add·remove, bootstrap의 apply.mjs와 같은 규칙.
-function settingsFile(root) {
-  return repoPathStrict(root, SETTINGS)
-}
-
-function enabledList(settings) {
-  const ep = settings.enabledPlugins
-  if (Array.isArray(ep)) return ep
-  if (ep && typeof ep === 'object') return Object.keys(ep).filter((k) => ep[k])
-  return []
-}
-
-export function isPluginEnabled(root, ids) {
-  const list = enabledList(readSettings(root))
-  return ids.some((id) => list.includes(id))
-}
-
-export function enablePlugin(root, id, marketplace) {
-  const file = settingsFile(root)
-  const settings = readSettings(root)
-  if (Array.isArray(settings.enabledPlugins)) {
-    if (!settings.enabledPlugins.includes(id)) {
-      setKey(file, ['enabledPlugins', settings.enabledPlugins.length], id)
-    }
-  } else {
-    setKey(file, ['enabledPlugins', id], true)
-  }
-  if (marketplace) {
-    setKey(file, ['extraKnownMarketplaces', marketplace.name], {
-      source: { source: 'github', repo: marketplace.repo },
-    })
-  }
-}
-
-export function disablePlugin(root, ids) {
-  const file = settingsFile(root)
-  const settings = readSettings(root)
-  if (Array.isArray(settings.enabledPlugins)) {
-    const kept = settings.enabledPlugins.filter((e) => !ids.includes(e))
-    setKey(file, ['enabledPlugins'], kept)
-  } else if (settings.enabledPlugins) {
-    for (const id of ids) removeKey(file, ['enabledPlugins', id])
-  }
-  // 제거한 플러그인이 쓰던 마켓플레이스만 정리 대상으로 삼는다 (무관한 사용자 항목 보존).
-  const candidates = new Set(ids.map((id) => id.slice(id.indexOf('@') + 1)))
-  const after = readSettings(root)
-  const remaining = enabledList(after).map((e) => e.slice(e.indexOf('@') + 1))
-  for (const mkt of candidates) {
-    if (!remaining.includes(mkt) && after.extraKnownMarketplaces?.[mkt] !== undefined) {
-      removeKey(file, ['extraKnownMarketplaces', mkt])
-    }
-  }
-}

package/lib/global-plugin.mjs

@@ -1,239 +0,0 @@
-// 사용자 전역(scope: 'user') 플러그인 항목의 공통 기구. 상류가 하니스별 전역
-// 설치만 지원하는 도구(superpowers, ponytail)가 공유한다 — 항목 파일
-// (lib/items/global.*.mjs)은 상류별 좌표와 미배선 사유만 든다.
-//
-// 전역 파일을 만지므로 repoPath 계열 가드를 일부러 안 쓴다 — 저장소 이탈이
-// 목적인 기구다. 항목 파일에 두지 않는 이유는 gitmessage.mjs와 같다:
-// loadItems가 items/의 모든 .mjs를 항목으로 읽는다.
-//
-// 하니스별 기록 위치(2026-08-15 실측, 상세는 global.superpowers.mjs):
-//   codex    $CODEX_HOME/config.toml의 [plugins."<이름>@…"] — CODEX_HOME
-//            재지정을 실제로 쓰는 환경(Orca)이 있어 환경변수를 따라간다.
-//   copilot  ~/.copilot/config.json의 installedPlugins[] (주석 있는 JSONC).
-//   gemini   ~/.gemini/extensions/<이름>/ (공식 extensions 문서).
-//   opencode 전역 opencode.json의 plugin 배열 (XDG_CONFIG_HOME 존중).
-//   grok     ~/.grok/installed-plugins/registry.json의 repos[*].plugins 키
-//            (2026-09-05 grok 1.0.5로 설치·제거 왕복 실측). 설치는
-//            `grok plugin install <소스> --trust`가 registry와 디렉터리를 만들고
-//            config.toml [plugins].enabled에도 이름을 넣는다. 제거
-//            (`grok plugin uninstall <이름> --confirm`)는 디렉터리·registry만
-//            지우고 enabled 항목은 남기므로, 감지의 근거는 registry여야 한다 —
-//            enabled를 보면 제거한 뒤에도 영원히 설치됨으로 읽힌다.
-import { existsSync, readFileSync } from 'node:fs'
-import { homedir } from 'node:os'
-import { delimiter, join } from 'node:path'
-import { parse as parseToml } from 'smol-toml'
-import { CLIS } from './clis.mjs'
-import { readJson, setKey, removeKey } from './jsonfile.mjs'
-import { msg, LocalizedError } from './i18n/index.mjs'
-
-// 실행은 cmd 셸을 거치므로(catalog.mjs makeExec) win32에서는 PATHEXT 확장자가
-// 있어야 실제로 부를 수 있다 — copilot.ps1만 있는 PATH는 "없음"이 맞다.
-function defaultHasBinary(name, env = process.env) {
-  const dirs = (env.PATH ?? '').split(delimiter).filter(Boolean)
-  const exts = process.platform === 'win32'
-    ? (env.PATHEXT ?? '.COM;.EXE;.BAT;.CMD').split(';').filter(Boolean)
-    : ['']
-  return dirs.some((dir) => exts.some((ext) => existsSync(join(dir, name + ext))))
-}
-
-// superpowers@openai-curated처럼 다른 마켓플레이스로 설치된 판도 잡아야
-// 하므로(실측: 이런 머신이 실제로 있다) 이름이 아니라 접두사로 고른다.
-// 제거도 여기서 찾은 id를 그대로 쓴다 — 감지가 "있다"고 말한 판을 지워야
-// 상태가 맞아떨어진다.
-function codexPluginIds(file, pluginName) {
-  if (!existsSync(file)) return []
-  try {
-    const data = parseToml(readFileSync(file, 'utf8'))
-    return Object.keys(data.plugins ?? {}).filter((id) => id.startsWith(`${pluginName}@`))
-  } catch {
-    // 깨진 config.toml은 미설치로 둔다 — 설치를 시도하면 codex가 스스로
-    // 진단하고, "설치됨"으로 오판해 제거를 그리로 보내는 것보다 낫다.
-    return []
-  }
-}
-
-function copilotInstalled(file, pluginName) {
-  const list = readJson(file)?.installedPlugins
-  return Array.isArray(list) && list.some((p) => p?.name === pluginName)
-}
-
-// ponytail(items/plugin.ponytail.mjs)과 같은 규칙: plugin 키가 배열이 아니면
-// 손대지 않는다.
-function opencodePlugins(file) {
-  const value = readJson(file)?.plugin
-  if (value === undefined) return []
-  if (!Array.isArray(value)) return null
-  return value
-}
-
-// config:
-//   pluginName      감지·제거가 쓰는 상류 이름 (codex 접두사, copilot name,
-//                   gemini 확장 디렉터리 이름)
-//   marketplaceRepo codex·copilot 마켓플레이스 (owner/repo)
-//   installId       마켓플레이스 설치 id (<이름>@<마켓>)
-//   gemini          gemini extensions install에 줄 git URL, 없으면 null
-//   opencode        전역 opencode.json plugin 배열에 넣을 항목, 없으면 null
-//   grok            grok plugin install에 줄 소스(마켓 id 또는 owner/repo), 없으면 null
-// supports는 어댑터 유무로 정해진다 — codex·copilot은 항상, gemini·opencode·grok은
-// 좌표가 있을 때만.
-export function defineGlobalPlugin(
-  { id, label, group, note, exclusive = null, unsupported = {}, pluginName, marketplaceRepo, installId, gemini = null, opencode = null, grok = null, verified = null },
-  { home = null, env = process.env, hasBinary = defaultHasBinary } = {},
-) {
-  const supports = ['codex', ...(gemini ? ['gemini'] : []), ...(opencode ? ['opencode'] : []), 'copilot', ...(grok ? ['grok'] : [])]
-
-  const files = () => {
-    const base = home ?? homedir()
-    return {
-      codex: join(env.CODEX_HOME || join(base, '.codex'), 'config.toml'),
-      copilot: join(base, '.copilot', 'config.json'),
-      gemini: join(base, '.gemini', 'extensions', pluginName),
-      opencode: join(env.XDG_CONFIG_HOME || join(base, '.config'), 'opencode', 'opencode.json'),
-      grok: join(base, '.grok', 'installed-plugins', 'registry.json'),
-    }
-  }
-
-  // registry.json: { repos: { "<이름>-<해시>": { plugins: { "<이름>": {...} } } } }.
-  // 이름은 repos 키(해시가 붙는다)가 아니라 plugins 키에서 본다.
-  const grokInstalled = (file) => {
-    const repos = readJson(file)?.repos
-    if (!repos || typeof repos !== 'object') return false
-    return Object.values(repos).some((r) => Object.hasOwn(r?.plugins ?? {}, pluginName))
-  }
-
-  const isOurEntry = (p) => String(p).startsWith(`${pluginName}@`)
-  const wired = {
-    codex: (f) => codexPluginIds(f.codex, pluginName).length > 0,
-    copilot: (f) => copilotInstalled(f.copilot, pluginName),
-    gemini: (f) => existsSync(f.gemini),
-    opencode: (f) => (opencodePlugins(f.opencode) ?? []).some(isOurEntry),
-    grok: (f) => grokInstalled(f.grok),
-  }
-
-  return {
-    id, category: 'plugin', label, scope: 'user', group, exclusive, verified,
-    supports: [...supports],
-    unsupported,
-    note,
-
-    // 상태는 "이 머신에 있는 하니스" 기준이다. CLI가 없는 하니스까지 누락으로
-    // 세면 gemini 없는 머신은 영원히 partial이라 apply가 매번 헛돈다.
-    async detect() {
-      const f = files()
-      const present = supports.filter((c) => wired[c](f))
-      const machine = supports.filter((c) => hasBinary(c))
-      const noCli = supports.filter((c) => !machine.includes(c))
-      const missing = machine.filter((c) => !present.includes(c))
-      const detail = noCli.length > 0 ? msg('item.global.noCli', { list: noCli.join(', ') }) : undefined
-      // excluded는 detail과 별도로 구조체로 넘긴다 — 행 힌트가 CLI 이름을
-      // 나열할 때 이 머신에 없는 것을 빼고 따로 적으려면 문장이 아니라 목록이 필요하다.
-      if (present.length === 0) return { status: 'absent', detail, excluded: noCli }
-      if (missing.length === 0) return { status: 'installed', detail, excluded: noCli }
-      return {
-        status: 'partial',
-        detail: msg('item.plugin.partial', { present: present.join(', '), missing: missing.join(', ') }),
-        excluded: noCli,
-      }
-    },
-
-    async install({ dryRun, exec, log = () => {}, t }) {
-      const f = files()
-      // opencode 설정이 손댈 수 없는 꼴이면 아무것도 만지기 전에 멈춘다 —
-      // 절반만 설치된 채 실패하는 것보다 통째로 거절이 낫다.
-      const needsOpencode = opencode && !wired.opencode(f) && hasBinary('opencode')
-      if (needsOpencode && !dryRun && opencodePlugins(f.opencode) === null) {
-        throw new LocalizedError('error.globalOpencodePlugin', { file: f.opencode, entry: opencode })
-      }
-      const skipped = []
-      const failures = []
-      const fail = (cli, output) => failures.push(`${cli}: ${String(output).trim().split('\n')[0]}`)
-      for (const cli of supports) {
-        if (wired[cli](f)) continue
-        if (!hasBinary(cli)) {
-          skipped.push(cli)
-          continue
-        }
-        if (cli === 'codex') {
-          // 마켓 등록은 이미 있어도 해가 없다 — 성패는 add가 판정한다.
-          await exec('codex', ['plugin', 'marketplace', 'add', marketplaceRepo])
-          const r = await exec('codex', ['plugin', 'add', installId])
-          if (!r.ok) fail(cli, r.output)
-        } else if (cli === 'copilot') {
-          await exec('copilot', ['plugin', 'marketplace', 'add', marketplaceRepo])
-          // 실측(2026-08-15): 다른 copilot 세션이 떠 있으면 os error 5로 한 번
-          // 실패하고 재시도에 성공한다. 한 번만 다시 시도한다.
-          let r = await exec('copilot', ['plugin', 'install', installId])
-          if (!r.ok) r = await exec('copilot', ['plugin', 'install', installId])
-          if (!r.ok) fail(cli, r.output)
-        } else if (cli === 'gemini') {
-          const r = await exec('gemini', ['extensions', 'install', gemini])
-          if (!r.ok) fail(cli, r.output)
-        } else if (cli === 'grok') {
-          // --trust는 확인 프롬프트를 건너뛴다 — stdin이 닫힌 채 도는 실행이라
-          // 프롬프트가 뜨면 영원히 멈춘다.
-          const r = await exec('grok', ['plugin', 'install', grok, '--trust'])
-          if (!r.ok) fail(cli, r.output)
-        } else {
-          if (dryRun) {
-            log(t('log.plugin.add', { cli: CLIS.opencode.label, name: opencode }))
-            continue
-          }
-          const list = opencodePlugins(f.opencode) ?? []
-          if (list.length === 0) setKey(f.opencode, ['plugin'], [opencode])
-          else setKey(f.opencode, ['plugin', list.length], opencode)
-        }
-      }
-      if (failures.length > 0) throw new LocalizedError('error.globalExec', { detail: failures.join(' / ') })
-      if (skipped.length > 0) return { message: msg('item.global.skipped', { list: skipped.join(', ') }) }
-    },
-
-    async uninstall({ dryRun, exec, log = () => {}, t }) {
-      const f = files()
-      const skipped = []
-      const failures = []
-      const fail = (cli, output) => failures.push(`${cli}: ${String(output).trim().split('\n')[0]}`)
-      for (const cli of supports) {
-        if (!wired[cli](f)) continue
-        if (cli === 'opencode') {
-          if (dryRun) {
-            log(t('log.plugin.remove', { cli: CLIS.opencode.label, name: opencode }))
-            continue
-          }
-          const kept = (opencodePlugins(f.opencode) ?? []).filter((p) => !isOurEntry(p))
-          // 우리 항목만 빼고 비면 키째 지운다 — 빈 배열은 우리가 남긴 흔적이다.
-          if (kept.length === 0) removeKey(f.opencode, ['plugin'])
-          else setKey(f.opencode, ['plugin'], kept)
-          continue
-        }
-        if (!hasBinary(cli)) {
-          skipped.push(cli)
-          continue
-        }
-        if (cli === 'codex') {
-          for (const pid of codexPluginIds(f.codex, pluginName)) {
-            const r = await exec('codex', ['plugin', 'remove', pid])
-            if (!r.ok) fail(cli, r.output)
-          }
-          // 마켓플레이스 등록은 남긴다 — 우리가 등록했다는 보장이 없고,
-          // 같은 마켓의 다른 플러그인이 쓰고 있을 수 있다.
-        } else if (cli === 'copilot') {
-          let r = await exec('copilot', ['plugin', 'uninstall', pluginName])
-          if (!r.ok) r = await exec('copilot', ['plugin', 'uninstall', pluginName])
-          if (!r.ok) fail(cli, r.output)
-        } else if (cli === 'grok') {
-          // --confirm은 한 저장소에 플러그인이 여럿일 때의 확인을 건너뛴다.
-          // config.toml [plugins].enabled의 이름은 상류가 남긴다 — 우리가
-          // 등록한 줄이라는 보장이 없어 건드리지 않는다(note에 적는다).
-          const r = await exec('grok', ['plugin', 'uninstall', pluginName, '--confirm'])
-          if (!r.ok) fail(cli, r.output)
-        } else {
-          const r = await exec('gemini', ['extensions', 'uninstall', pluginName])
-          if (!r.ok) fail(cli, r.output)
-        }
-      }
-      if (failures.length > 0) throw new LocalizedError('error.globalExec', { detail: failures.join(' / ') })
-      if (skipped.length > 0) return { message: msg('item.global.skipped', { list: skipped.join(', ') }) }
-    },
-  }
-}