@rch4com/agent-setup 1.28.0 → 2.2.0

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(', ') }) }
-    },
-  }
-}

package/lib/items/global.ponytail.mjs

@@ -1,56 +0,0 @@
-import { defineGlobalPlugin } from '../global-plugin.mjs'
-import { CLI_IDS } from '../clis.mjs'
-import { msg } from '../i18n/index.mjs'
-
-// Ponytail의 하니스별 전역 설치 판. 공통 기구는 global-plugin.mjs에 있다.
-//
-// 하니스별 근거(2026-08-15 상류 README 재검증):
-//   codex   — `codex plugin marketplace add DietrichGebert/ponytail` +
-//             `codex plugin add ponytail@ponytail`. 상류는 설치 후 codex에서
-//             /hooks로 라이프사이클 훅 등록을 확인하고 새 스레드를 시작하라는
-//             대화형 후속 단계를 안내한다 — 명령으로 대신할 수 없어 note에
-//             적는다. 제거는 `codex plugin remove <id>`.
-//   copilot — `copilot plugin marketplace add` + `copilot plugin install
-//             ponytail@ponytail`. 상류 README에 제거 명령은 없지만
-//             `copilot plugin uninstall <이름>`은 copilot CLI 자체의 범용
-//             명령이다(--help 실측).
-//   gemini  — `gemini extensions install https://github.com/DietrichGebert/ponytail`.
-//
-// opencode는 프로젝트 항목(plugin.ponytail)이 opencode.jsonc의 plugin 배열로
-// 이미 배선한다 — 전역 판에서 겹치면 같은 플러그인이 두 번 등록된다. claude도
-// 같은 이유로 프로젝트 항목의 자리다.
-//   grok    — `grok plugin install DietrichGebert/ponytail --trust`. 2026-09-05
-//             이 머신(grok 1.0.5)에서 설치·감지·제거 왕복을 실측했다. 상류
-//             README는 "기본 꺼짐이라 /plugins에서 켜라"고 적지만 1.0.5는
-//             --trust 설치 직후 config.toml [plugins].enabled에 이름을 넣었다.
-// kiro·vscode는 상류가 룰 파일 수동 배치만 안내하고, kilo·kimi는 경로가 없다.
-//
-// 상류는 플러그인 제거 전에 node scripts/uninstall.js로 ~/.config/ponytail
-// 설정과 statusLine 항목을 정리하라고 안내한다 — 하니스마다 스크립트 위치가
-// 달라 자동화하지 않고 note로 알린다. 이 항목은 플러그인만 제거한다.
-const SUPPORTS = ['codex', 'gemini', 'copilot', 'grok']
-
-const CONFIG = {
-  id: 'global.ponytail', label: 'Ponytail', group: '__token',
-  note: 'item.global.ponytail.note',
-  verified: '2026-09-05',
-  pluginName: 'ponytail',
-  marketplaceRepo: 'DietrichGebert/ponytail',
-  installId: 'ponytail@ponytail',
-  gemini: 'https://github.com/DietrichGebert/ponytail',
-  grok: 'DietrichGebert/ponytail',
-  unsupported: Object.fromEntries(
-    CLI_IDS.filter((c) => !SUPPORTS.includes(c)).map((c) => [
-      c,
-      ['claude', 'opencode'].includes(c) ? msg('item.unsupported.globalProjectItem', { item: 'Ponytail' })
-      : ['kiro', 'vscode'].includes(c) ? msg('item.unsupported.ponytailRules')
-      : msg('item.unsupported.upstreamNone'),
-    ]),
-  ),
-}
-
-export function createItem(deps = {}) {
-  return defineGlobalPlugin(CONFIG, deps)
-}
-
-export default createItem()

package/lib/items/global.superpowers.mjs

@@ -1,58 +0,0 @@
-import { defineGlobalPlugin } from '../global-plugin.mjs'
-import { CLI_IDS } from '../clis.mjs'
-import { msg } from '../i18n/index.mjs'
-
-// superpowers를 프로젝트 스코프로 배선할 길이 없는 하니스에 상류의 하니스별
-// 전역 설치("install separately for each one")를 대신 해 주는 항목. 공통
-// 기구는 global-plugin.mjs에 있고, 여기는 상류 좌표와 사유만 든다.
-//
-// 하니스별 근거(2026-08-15, v6.3.0):
-//   codex   — 이 머신에서 marketplace add + plugin add를 실측. 기록은
-//             $CODEX_HOME/config.toml의 [plugins."superpowers@…"].
-//   copilot — 이 머신에서 설치·목록·제거를 실측(~/.copilot/config.json).
-//   gemini  — 공식 extensions 기구. 로컬 CLI가 없어 문서 근거다.
-//   opencode— 상류 .opencode/INSTALL.md가 전역 opencode.json의 plugin 배열에
-//             아래 항목 한 줄을 더하라고 안내한다.
-//
-//   grok    — 2026-09-05 이 머신(grok 1.0.5)에서 `grok plugin install
-//             superpowers@xai-official --trust`로 설치·감지·제거 왕복을 실측.
-//             기록은 ~/.grok/installed-plugins/registry.json(global-plugin.mjs).
-//
-// kimi는 설치가 대화형 /plugins뿐이라 헤드리스 경로가 없다. claude는 프로젝트
-// 스코프 항목(plugin.superpowers)의 자리다.
-//
-// skill.superpowers(공유 .agents/skills)와 배타로 묶지 않는다 — 저쪽은 이
-// 저장소에만, 이쪽은 머신 전체에 작용해 평면이 다르고, "claude는 프로젝트
-// 플러그인 + 나머지는 전역" 같은 조합이 정당하다. 겹치는 하니스가 같은 스킬을
-// 두 곳에서 본다는 것은 note에 적어 둔다.
-const SUPPORTS = ['codex', 'gemini', 'opencode', 'copilot', 'grok']
-
-const CONFIG = {
-  id: 'global.superpowers', label: 'superpowers', group: '__flow',
-  note: 'item.global.superpowers.note',
-  verified: '2026-09-05',
-  pluginName: 'superpowers',
-  marketplaceRepo: 'obra/superpowers-marketplace',
-  installId: 'superpowers@superpowers-marketplace',
-  gemini: 'https://github.com/obra/superpowers',
-  opencode: 'superpowers@git+https://github.com/obra/superpowers.git',
-  grok: 'superpowers@xai-official',
-  unsupported: Object.fromEntries(
-    CLI_IDS.filter((c) => !SUPPORTS.includes(c)).map((c) => [
-      c,
-      c === 'claude' ? msg('item.unsupported.superpowersGlobalClaude')
-      : c === 'kimi' ? msg('item.unsupported.superpowersGlobalKimi')
-      // 상류 README가 Antigravity 설치를 안내하지만 감지·제거 경로를 실측할
-      // CLI가 없다 — grok과 같은 기준으로 아직 배선하지 않는다.
-      : c === 'antigravity' ? msg('item.unsupported.unmeasuredUpstream')
-      : msg('item.unsupported.upstreamNone'),
-    ]),
-  ),
-}
-
-// 테스트가 홈·환경·PATH 탐지를 갈아끼울 수 있게 공장으로 노출한다.
-export function createItem(deps = {}) {
-  return defineGlobalPlugin(CONFIG, deps)
-}
-
-export default createItem()

package/lib/tomlfile.mjs

@@ -1,67 +0,0 @@
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs'
-import { dirname } from 'node:path'
-import { parse } from 'smol-toml'
-import { LocalizedError } from './i18n/index.mjs'
-import { escapeRegExp } from './untrusted.mjs'
-
-function readText(file) {
-  return existsSync(file) ? readFileSync(file, 'utf8') : ''
-}
-
-// 깨진 TOML은 읽기·쓰기 모두 거부한다. 예전에는 파싱 실패를 "섹션 없음"으로
-// 돌려줘, 닫는 대괄호가 빠진 파일 끝에 같은 섹션이 하나 더 붙고 사용자는
-// 파일이 깨진 것을 끝까지 몰랐다 — jsonfile.mjs의 JSON 규칙과 같다.
-function parseStrict(text, file) {
-  try {
-    return parse(text)
-  } catch (err) {
-    throw new LocalizedError('error.tomlInvalid', { path: file, message: err.message.split('\n')[0] })
-  }
-}
-
-export function hasSection(file, name) {
-  const text = readText(file)
-  if (!text.trim()) return false
-  const data = parseStrict(text, file)
-  return data.mcp_servers != null && Object.hasOwn(data.mcp_servers, name)
-}
-
-export function appendSection(file, name, lines) {
-  let text = readText(file)
-  if (text.trim()) parseStrict(text, file)
-  if (text.length > 0 && !text.endsWith('\n')) text += '\n'
-  const separator = text.length > 0 ? '\n' : ''
-  text += `${separator}[mcp_servers.${name}]\n${lines.join('\n')}\n`
-  mkdirSync(dirname(file), { recursive: true })
-  writeFileSync(file, text)
-}
-
-export function removeSection(file, name) {
-  const text = readText(file)
-  if (!text) return
-  parseStrict(text, file)
-  const lines = text.split('\n')
-  const headerRe = new RegExp(`^\\s*\\[mcp_servers\\.${escapeRegExp(name)}(\\.|\\])`)
-  const anyHeaderRe = /^\s*\[/
-  const out = []
-  let skipping = false
-  let removedAt = -1
-  for (const line of lines) {
-    if (skipping && anyHeaderRe.test(line) && !headerRe.test(line)) skipping = false
-    if (headerRe.test(line)) {
-      skipping = true
-      if (removedAt === -1) removedAt = out.length
-    }
-    if (!skipping) out.push(line)
-  }
-  // 제거 지점의 경계에서만 빈 줄 하나를 정리해, 다른 위치의 빈 줄들은 그대로 보존한다.
-  if (
-    removedAt > 0 &&
-    removedAt < out.length &&
-    out[removedAt - 1].trim() === '' &&
-    (out[removedAt] ?? '').trim() === ''
-  ) {
-    out.splice(removedAt - 1, 1)
-  }
-  writeFileSync(file, out.join('\n'))
-}