@rch4com/agent-setup 1.9.0 → 1.10.0

package/lib/i18n/detect.mjs

@@ -1,39 +1,39 @@
-// OS 언어 감지. 순수 함수다 — env와 Intl 결과를 인자로 받는다.
-// 여기서 지원 여부를 판단하지 않는다: OS가 뭐라고 하는지만 그대로 보고하고,
-// 그중 무엇을 쓸지는 resolveLocale이 정한다. 둘을 섞으면 "감지는 됐는데
-// 지원하지 않아 영어로 갔다"와 "감지 자체가 실패했다"를 구별할 수 없다.
-
-// POSIX 관례상 뒤에 오는 것이 앞을 덮지 않는다 — 먼저 잡히는 것이 이긴다.
-const ENV_KEYS = ['LC_ALL', 'LC_MESSAGES', 'LANG', 'LANGUAGE']
-
-// 로케일을 지정하지 않았다는 뜻의 값. 여기서 멈추면 Intl로 내려가지 못한다.
-const NEUTRAL = new Set(['c', 'posix'])
-
-// `ko_KR.UTF-8` · `en_US:en` · `ko-KR` 을 모두 `ko`/`en`으로 줄인다.
-// `.`은 인코딩, `@`는 변형(modifier), `:`은 LANGUAGE의 목록 구분자다.
-export function baseTag(raw) {
-  if (typeof raw !== 'string') return null
-  const head = raw.trim().split(/[.:@]/)[0]
-  if (!head) return null
-  if (NEUTRAL.has(head.toLowerCase())) return null
-  const tag = head.replace(/_/g, '-').split('-')[0].toLowerCase()
-  return tag || null
-}
-
-// Node 20+는 full-icu가 기본이라 Windows에서도 OS 언어를 반영한다.
-// 축소 빌드에서는 'en-US'로 고정되는데, 그때는 영어로 시작하는 것이 맞다.
-function intlLocale() {
-  try {
-    return Intl.DateTimeFormat().resolvedOptions().locale
-  } catch {
-    return null
-  }
-}
-
-export function detectLocale(env = {}, intl = intlLocale()) {
-  for (const key of ENV_KEYS) {
-    const tag = baseTag(env[key])
-    if (tag) return tag
-  }
-  return baseTag(intl)
-}
+// OS 언어 감지. 순수 함수다 — env와 Intl 결과를 인자로 받는다.
+// 여기서 지원 여부를 판단하지 않는다: OS가 뭐라고 하는지만 그대로 보고하고,
+// 그중 무엇을 쓸지는 resolveLocale이 정한다. 둘을 섞으면 "감지는 됐는데
+// 지원하지 않아 영어로 갔다"와 "감지 자체가 실패했다"를 구별할 수 없다.
+
+// POSIX 관례상 뒤에 오는 것이 앞을 덮지 않는다 — 먼저 잡히는 것이 이긴다.
+const ENV_KEYS = ['LC_ALL', 'LC_MESSAGES', 'LANG', 'LANGUAGE']
+
+// 로케일을 지정하지 않았다는 뜻의 값. 여기서 멈추면 Intl로 내려가지 못한다.
+const NEUTRAL = new Set(['c', 'posix'])
+
+// `ko_KR.UTF-8` · `en_US:en` · `ko-KR` 을 모두 `ko`/`en`으로 줄인다.
+// `.`은 인코딩, `@`는 변형(modifier), `:`은 LANGUAGE의 목록 구분자다.
+export function baseTag(raw) {
+  if (typeof raw !== 'string') return null
+  const head = raw.trim().split(/[.:@]/)[0]
+  if (!head) return null
+  if (NEUTRAL.has(head.toLowerCase())) return null
+  const tag = head.replace(/_/g, '-').split('-')[0].toLowerCase()
+  return tag || null
+}
+
+// Node 20+는 full-icu가 기본이라 Windows에서도 OS 언어를 반영한다.
+// 축소 빌드에서는 'en-US'로 고정되는데, 그때는 영어로 시작하는 것이 맞다.
+function intlLocale() {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().locale
+  } catch {
+    return null
+  }
+}
+
+export function detectLocale(env = {}, intl = intlLocale()) {
+  for (const key of ENV_KEYS) {
+    const tag = baseTag(env[key])
+    if (tag) return tag
+  }
+  return baseTag(intl)
+}

package/lib/i18n/index.mjs

@@ -1,93 +1,93 @@
-// 로케일 해석과 문구 조회. 잎(leaf) 모듈이라 아무것도 import 하지 않는다 —
-// args.mjs·context.mjs·bootstrap/*가 전부 여기에 닿으므로, 외부 의존성이
-// 하나라도 들어오면 npm install 없이 도는 부트스트랩이 깨진다.
-// bootstrap.isolation.test.mjs가 이 불변식을 지킨다.
-//
-// 전역 싱글턴을 두지 않는다. t는 만들어서 넘기는 값이다 — 그래야 순수
-// 모듈(state.mjs)이 계속 아무것도 import 하지 않고, 테스트가 파일 병렬로
-// 돌아도 로케일이 서로를 오염시키지 않는다.
-import EN from './catalog/en.mjs'
-import KO from './catalog/ko.mjs'
-
-export const LOCALES = ['en', 'ko']
-
-const CATALOGS = { en: EN, ko: KO }
-const PLACEHOLDER = /\{(\w+)\}/g
-
-// 자리에 값이 없으면 던진다. `12 of undefined files`가 화면에 남는 것보다
-// 즉시 실패가 낫다 — 이건 번역 누락이 아니라 호출부의 버그다.
-function fill(template, params, key) {
-  return template.replace(PLACEHOLDER, (_, name) => {
-    if (!Object.hasOwn(params, name)) {
-      throw new Error(`i18n: '${key}'의 자리 {${name}}에 값이 없습니다`)
-    }
-    return String(params[name])
-  })
-}
-
-// 활성 카탈로그 → 영어 폴백 → 예외.
-// 번역 누락은 사용자 화면을 깨뜨리지 않아야 하지만, 영어에도 없는 키는
-// 개발자 오타다. 조용히 넘기면 화면에 'log.file.creat'가 그대로 찍힌다.
-function lookup(locale, key) {
-  const value = CATALOGS[locale]?.[key]
-  if (value !== undefined) return value
-  const base = EN[key]
-  if (base === undefined) throw new Error(`i18n: 알 수 없는 키입니다: ${key}`)
-  return base
-}
-
-export function createT(locale) {
-  const use = LOCALES.includes(locale) ? locale : 'en'
-  const t = (key, params = {}) => {
-    const value = lookup(use, key)
-    return Array.isArray(value)
-      ? value.map((line) => fill(line, params, key)).join('\n')
-      : fill(value, params, key)
-  }
-  t.locale = use
-  return t
-}
-
-// 앞이 이긴다: 플래그 > 환경변수 > 설치 기록 > OS 감지 > 영어.
-// 지원하지 않는 값은 조용히 건너뛴다 — 손으로 편집된 기록이나 환경에 남은
-// 값 때문에 도구가 죽으면 안 된다. 사용자가 --lang으로 명시한 경우만
-// args.mjs가 따로 거부한다.
-export function resolveLocale({ flag = null, env = {}, record = null, detected = null } = {}) {
-  for (const value of [flag, env.AGENT_SETUP_LANG, record?.lang, detected]) {
-    if (typeof value === 'string' && LOCALES.includes(value)) return value
-  }
-  return 'en'
-}
-
-// 플래그나 환경변수가 로케일을 못박았는가. TUI에서 고른 언어는 이번 실행에는
-// 적용되지만 기록에만 남고 다음 실행에서 다시 밀리므로, 화면이 그 사실을
-// 알려야 한다. 판정 규칙이 resolveLocale과 갈리면 안 되므로 같은 모듈에 둔다 —
-// 지원하지 않는 값은 resolveLocale이 이미 건너뛰었고, 셸에 남은
-// AGENT_SETUP_LANG=ja까지 "환경변수가 이긴다"고 말하면 거짓말이 된다.
-export function isLocaleForced({ flag = null, env = {} } = {}) {
-  return [flag, env.AGENT_SETUP_LANG].some((v) => typeof v === 'string' && LOCALES.includes(v))
-}
-
-// 옵션 주머니가 없어 t를 꿸 수 없는 곳(context.mjs의 repoPath,
-// record.mjs의 readRecord)이 쓴다. .message는 영어로 즉시 채워 스택
-// 트레이스가 그대로 읽히게 하고, 진입점이 .key를 보고 다시 렌더한다.
-export class LocalizedError extends Error {
-  constructor(key, params = {}) {
-    super(createT('en')(key, params))
-    this.name = 'LocalizedError'
-    this.key = key
-    this.params = params
-  }
-}
-
-// 데이터 계층이 만들어 나중에 표시되는 문구용. detect()의 detail이나
-// unsupported 사유는 만들어지는 시점에 로케일을 모른다 — 키를 담아 두고
-// 렌더 시점에 toText로 푼다.
-export function msg(key, params = {}) {
-  return { key, params }
-}
-
-export function toText(t, value) {
-  if (value === null || value === undefined) return value
-  return typeof value === 'string' ? value : t(value.key, value.params)
-}
+// 로케일 해석과 문구 조회. 잎(leaf) 모듈이라 아무것도 import 하지 않는다 —
+// args.mjs·context.mjs·bootstrap/*가 전부 여기에 닿으므로, 외부 의존성이
+// 하나라도 들어오면 npm install 없이 도는 부트스트랩이 깨진다.
+// bootstrap.isolation.test.mjs가 이 불변식을 지킨다.
+//
+// 전역 싱글턴을 두지 않는다. t는 만들어서 넘기는 값이다 — 그래야 순수
+// 모듈(state.mjs)이 계속 아무것도 import 하지 않고, 테스트가 파일 병렬로
+// 돌아도 로케일이 서로를 오염시키지 않는다.
+import EN from './catalog/en.mjs'
+import KO from './catalog/ko.mjs'
+
+export const LOCALES = ['en', 'ko']
+
+const CATALOGS = { en: EN, ko: KO }
+const PLACEHOLDER = /\{(\w+)\}/g
+
+// 자리에 값이 없으면 던진다. `12 of undefined files`가 화면에 남는 것보다
+// 즉시 실패가 낫다 — 이건 번역 누락이 아니라 호출부의 버그다.
+function fill(template, params, key) {
+  return template.replace(PLACEHOLDER, (_, name) => {
+    if (!Object.hasOwn(params, name)) {
+      throw new Error(`i18n: '${key}'의 자리 {${name}}에 값이 없습니다`)
+    }
+    return String(params[name])
+  })
+}
+
+// 활성 카탈로그 → 영어 폴백 → 예외.
+// 번역 누락은 사용자 화면을 깨뜨리지 않아야 하지만, 영어에도 없는 키는
+// 개발자 오타다. 조용히 넘기면 화면에 'log.file.creat'가 그대로 찍힌다.
+function lookup(locale, key) {
+  const value = CATALOGS[locale]?.[key]
+  if (value !== undefined) return value
+  const base = EN[key]
+  if (base === undefined) throw new Error(`i18n: 알 수 없는 키입니다: ${key}`)
+  return base
+}
+
+export function createT(locale) {
+  const use = LOCALES.includes(locale) ? locale : 'en'
+  const t = (key, params = {}) => {
+    const value = lookup(use, key)
+    return Array.isArray(value)
+      ? value.map((line) => fill(line, params, key)).join('\n')
+      : fill(value, params, key)
+  }
+  t.locale = use
+  return t
+}
+
+// 앞이 이긴다: 플래그 > 환경변수 > 설치 기록 > OS 감지 > 영어.
+// 지원하지 않는 값은 조용히 건너뛴다 — 손으로 편집된 기록이나 환경에 남은
+// 값 때문에 도구가 죽으면 안 된다. 사용자가 --lang으로 명시한 경우만
+// args.mjs가 따로 거부한다.
+export function resolveLocale({ flag = null, env = {}, record = null, detected = null } = {}) {
+  for (const value of [flag, env.AGENT_SETUP_LANG, record?.lang, detected]) {
+    if (typeof value === 'string' && LOCALES.includes(value)) return value
+  }
+  return 'en'
+}
+
+// 플래그나 환경변수가 로케일을 못박았는가. TUI에서 고른 언어는 이번 실행에는
+// 적용되지만 기록에만 남고 다음 실행에서 다시 밀리므로, 화면이 그 사실을
+// 알려야 한다. 판정 규칙이 resolveLocale과 갈리면 안 되므로 같은 모듈에 둔다 —
+// 지원하지 않는 값은 resolveLocale이 이미 건너뛰었고, 셸에 남은
+// AGENT_SETUP_LANG=ja까지 "환경변수가 이긴다"고 말하면 거짓말이 된다.
+export function isLocaleForced({ flag = null, env = {} } = {}) {
+  return [flag, env.AGENT_SETUP_LANG].some((v) => typeof v === 'string' && LOCALES.includes(v))
+}
+
+// 옵션 주머니가 없어 t를 꿸 수 없는 곳(context.mjs의 repoPath,
+// record.mjs의 readRecord)이 쓴다. .message는 영어로 즉시 채워 스택
+// 트레이스가 그대로 읽히게 하고, 진입점이 .key를 보고 다시 렌더한다.
+export class LocalizedError extends Error {
+  constructor(key, params = {}) {
+    super(createT('en')(key, params))
+    this.name = 'LocalizedError'
+    this.key = key
+    this.params = params
+  }
+}
+
+// 데이터 계층이 만들어 나중에 표시되는 문구용. detect()의 detail이나
+// unsupported 사유는 만들어지는 시점에 로케일을 모른다 — 키를 담아 두고
+// 렌더 시점에 toText로 푼다.
+export function msg(key, params = {}) {
+  return { key, params }
+}
+
+export function toText(t, value) {
+  if (value === null || value === undefined) return value
+  return typeof value === 'string' ? value : t(value.key, value.params)
+}

package/lib/items/mcp.codebase-memory.mjs

@@ -1,6 +1,6 @@
-import { defineMcp } from '../catalog.mjs'
-export default defineMcp({
-  id: 'mcp.codebase-memory', label: 'Codebase Memory MCP', group: '__context',
-  server: { kind: 'stdio', command: 'codebase-memory-mcp', args: [] },
-  note: 'item.mcp.codebase-memory.note',
-})
+import { defineMcp } from '../catalog.mjs'
+export default defineMcp({
+  id: 'mcp.codebase-memory', label: 'Codebase Memory MCP', group: '__context',
+  server: { kind: 'stdio', command: 'codebase-memory-mcp', args: [] },
+  note: 'item.mcp.codebase-memory.note',
+})

package/lib/items/mcp.notion.mjs

@@ -1,6 +1,6 @@
-import { defineMcp } from '../catalog.mjs'
-export default defineMcp({
-  id: 'mcp.notion', label: 'Notion MCP', group: '__service',
-  server: { kind: 'http', url: 'https://mcp.notion.com/mcp' },
-  note: 'item.mcp.notion.note',
-})
+import { defineMcp } from '../catalog.mjs'
+export default defineMcp({
+  id: 'mcp.notion', label: 'Notion MCP', group: '__service',
+  server: { kind: 'http', url: 'https://mcp.notion.com/mcp' },
+  note: 'item.mcp.notion.note',
+})

package/lib/items/mcp.supabase.mjs

@@ -1,6 +1,6 @@
-import { defineMcp } from '../catalog.mjs'
-export default defineMcp({
-  id: 'mcp.supabase', label: 'Supabase MCP', group: '__service',
-  server: { kind: 'http', url: 'https://mcp.supabase.com/mcp' },
-  note: 'item.mcp.supabase.note',
-})
+import { defineMcp } from '../catalog.mjs'
+export default defineMcp({
+  id: 'mcp.supabase', label: 'Supabase MCP', group: '__service',
+  server: { kind: 'http', url: 'https://mcp.supabase.com/mcp' },
+  note: 'item.mcp.supabase.note',
+})

package/lib/items/mcp.vercel.mjs

@@ -1,6 +1,6 @@
-import { defineMcp } from '../catalog.mjs'
-export default defineMcp({
-  id: 'mcp.vercel', label: 'Vercel MCP', group: '__service',
-  server: { kind: 'http', url: 'https://mcp.vercel.com' },
-  note: 'item.mcp.vercel.note',
-})
+import { defineMcp } from '../catalog.mjs'
+export default defineMcp({
+  id: 'mcp.vercel', label: 'Vercel MCP', group: '__service',
+  server: { kind: 'http', url: 'https://mcp.vercel.com' },
+  note: 'item.mcp.vercel.note',
+})

package/lib/items/plugin.mattpocock-skills.mjs

@@ -1,8 +1,8 @@
-import { definePlugin } from '../catalog.mjs'
-export default definePlugin({
-  id: 'plugin.mattpocock-skills', label: 'Matt Pocock skills', group: '__flow',
-  installId: 'mattpocock-skills@mattpocock',
-  detectIds: ['mattpocock-skills@mattpocock'],
-  marketplace: { name: 'mattpocock', repo: 'mattpocock/skills' },
-  note: 'item.plugin.mattpocock-skills.note',
-})
+import { definePlugin } from '../catalog.mjs'
+export default definePlugin({
+  id: 'plugin.mattpocock-skills', label: 'Matt Pocock skills', group: '__flow',
+  installId: 'mattpocock-skills@mattpocock',
+  detectIds: ['mattpocock-skills@mattpocock'],
+  marketplace: { name: 'mattpocock', repo: 'mattpocock/skills' },
+  note: 'item.plugin.mattpocock-skills.note',
+})

package/lib/items/plugin.ponytail.mjs

@@ -1,104 +1,104 @@
-import { CLI_IDS } from '../clis.mjs'
-import { isPluginEnabled, enablePlugin, disablePlugin } from '../claude-plugins.mjs'
-import { repoPath, repoPathStrict } from '../context.mjs'
-import { readJson, setKey, removeKey } from '../jsonfile.mjs'
-import { msg, LocalizedError } from '../i18n/index.mjs'
-
-// 상류 안내는 `--scope user`지만 이 저장소의 항목은 전부 프로젝트 스코프다.
-// 같은 규칙 묶음이 두 경로로 들어간다 — Claude Code는 플러그인 CLI(실패하면
-// .claude/settings.json 기록), OpenCode는 프로젝트 설정의 plugin 배열.
-// 두 경로 모두 저장소 안에만 쓴다.
-const INSTALL_ID = 'ponytail@ponytail'
-const MARKETPLACE = { name: 'ponytail', repo: 'DietrichGebert/ponytail' }
-const OPENCODE_FILE = 'opencode.jsonc'
-const OPENCODE_ENTRY = '@dietrichgebert/ponytail'
-const SUPPORTS = ['claude', 'opencode']
-
-// plugin 키가 배열이 아니면 손대지 않는다 — 통째로 덮어쓰면 사용자가 적어 둔
-// 설정이 조용히 사라진다. 없는 것(undefined)과 다른 타입을 구분해서 돌려준다.
-function opencodePlugins(root) {
-  const value = readJson(repoPath(root, OPENCODE_FILE))?.plugin
-  if (value === undefined) return []
-  if (!Array.isArray(value)) return null
-  return value
-}
-
-function opencodeListOrThrow(root) {
-  const list = opencodePlugins(root)
-  if (list === null) throw new LocalizedError('error.ponytailOpencodePlugin', { file: OPENCODE_FILE })
-  return list
-}
-
-function hasOpencode(root) {
-  return (opencodePlugins(root) ?? []).includes(OPENCODE_ENTRY)
-}
-
-export default {
-  id: 'plugin.ponytail', category: 'plugin', label: 'Ponytail', scope: 'project',
-  group: '__token',
-  supports: SUPPORTS,
-  unsupported: Object.fromEntries(
-    CLI_IDS.filter((c) => !SUPPORTS.includes(c)).map((c) => [
-      c,
-      // codex·copilot·gemini는 상류에 설치 경로가 있지만 전부 사용자 스코프다.
-      // 나머지는 플러그인 기구 자체가 없어 AGENTS.md에 규칙을 옮겨 적어야 한다.
-      ['codex', 'copilot', 'gemini'].includes(c)
-        ? msg('item.unsupported.ponytailUser')
-        : msg('item.unsupported.ponytailRules'),
-    ]),
-  ),
-  note: 'item.plugin.ponytail.note',
-
-  async detect({ root }) {
-    const present = []
-    if (isPluginEnabled(root, [INSTALL_ID])) present.push('claude')
-    if (hasOpencode(root)) present.push('opencode')
-    if (present.length === 0) return { status: 'absent' }
-    if (present.length === SUPPORTS.length) return { status: 'installed' }
-    return {
-      status: 'partial',
-      detail: msg('item.plugin.partial', {
-        present: present.join(', '),
-        missing: SUPPORTS.filter((c) => !present.includes(c)).join(', '),
-      }),
-    }
-  },
-
-  async install({ root, dryRun, exec, log = () => {}, t }) {
-    let deferred = false
-    if (!isPluginEnabled(root, [INSTALL_ID])) {
-      await exec('claude', ['plugin', 'marketplace', 'add', MARKETPLACE.repo], { cwd: root })
-      const r = await exec('claude', ['plugin', 'install', INSTALL_ID, '--scope', 'project'], { cwd: root })
-      if (!r.ok) {
-        if (!dryRun) enablePlugin(root, INSTALL_ID, MARKETPLACE)
-        deferred = true
-      }
-    }
-    if (!hasOpencode(root)) {
-      const list = opencodeListOrThrow(root)
-      if (dryRun) log(t('log.plugin.add', { cli: 'OpenCode', name: OPENCODE_ENTRY }))
-      // 파일이 없거나 plugin 키가 없으면 배열째 만들고, 있으면 끝에 덧붙인다.
-      else if (list.length === 0) setKey(repoPathStrict(root, OPENCODE_FILE), ['plugin'], [OPENCODE_ENTRY])
-      else setKey(repoPathStrict(root, OPENCODE_FILE), ['plugin', list.length], OPENCODE_ENTRY)
-    }
-    if (deferred) return { fallback: true, message: msg('item.plugin.deferred') }
-  },
-
-  async uninstall({ root, dryRun, exec, log = () => {}, t }) {
-    if (isPluginEnabled(root, [INSTALL_ID])) {
-      const r = await exec('claude', ['plugin', 'uninstall', INSTALL_ID], { cwd: root })
-      if (!r.ok && !dryRun) disablePlugin(root, [INSTALL_ID])
-    }
-    if (!hasOpencode(root)) return
-    if (dryRun) {
-      log(t('log.plugin.remove', { cli: 'OpenCode', name: OPENCODE_ENTRY }))
-      return
-    }
-    const kept = opencodeListOrThrow(root).filter((p) => p !== OPENCODE_ENTRY)
-    const file = repoPathStrict(root, OPENCODE_FILE)
-    // 우리가 넣은 항목만 빼고 비면 키째 지운다 — 빈 배열을 남기면 우리가
-    // 만든 흔적이 설정에 계속 남는다.
-    if (kept.length === 0) removeKey(file, ['plugin'])
-    else setKey(file, ['plugin'], kept)
-  },
-}
+import { CLI_IDS } from '../clis.mjs'
+import { isPluginEnabled, enablePlugin, disablePlugin } from '../claude-plugins.mjs'
+import { repoPath, repoPathStrict } from '../context.mjs'
+import { readJson, setKey, removeKey } from '../jsonfile.mjs'
+import { msg, LocalizedError } from '../i18n/index.mjs'
+
+// 상류 안내는 `--scope user`지만 이 저장소의 항목은 전부 프로젝트 스코프다.
+// 같은 규칙 묶음이 두 경로로 들어간다 — Claude Code는 플러그인 CLI(실패하면
+// .claude/settings.json 기록), OpenCode는 프로젝트 설정의 plugin 배열.
+// 두 경로 모두 저장소 안에만 쓴다.
+const INSTALL_ID = 'ponytail@ponytail'
+const MARKETPLACE = { name: 'ponytail', repo: 'DietrichGebert/ponytail' }
+const OPENCODE_FILE = 'opencode.jsonc'
+const OPENCODE_ENTRY = '@dietrichgebert/ponytail'
+const SUPPORTS = ['claude', 'opencode']
+
+// plugin 키가 배열이 아니면 손대지 않는다 — 통째로 덮어쓰면 사용자가 적어 둔
+// 설정이 조용히 사라진다. 없는 것(undefined)과 다른 타입을 구분해서 돌려준다.
+function opencodePlugins(root) {
+  const value = readJson(repoPath(root, OPENCODE_FILE))?.plugin
+  if (value === undefined) return []
+  if (!Array.isArray(value)) return null
+  return value
+}
+
+function opencodeListOrThrow(root) {
+  const list = opencodePlugins(root)
+  if (list === null) throw new LocalizedError('error.ponytailOpencodePlugin', { file: OPENCODE_FILE })
+  return list
+}
+
+function hasOpencode(root) {
+  return (opencodePlugins(root) ?? []).includes(OPENCODE_ENTRY)
+}
+
+export default {
+  id: 'plugin.ponytail', category: 'plugin', label: 'Ponytail', scope: 'project',
+  group: '__token',
+  supports: SUPPORTS,
+  unsupported: Object.fromEntries(
+    CLI_IDS.filter((c) => !SUPPORTS.includes(c)).map((c) => [
+      c,
+      // codex·copilot·gemini는 상류에 설치 경로가 있지만 전부 사용자 스코프다.
+      // 나머지는 플러그인 기구 자체가 없어 AGENTS.md에 규칙을 옮겨 적어야 한다.
+      ['codex', 'copilot', 'gemini'].includes(c)
+        ? msg('item.unsupported.ponytailUser')
+        : msg('item.unsupported.ponytailRules'),
+    ]),
+  ),
+  note: 'item.plugin.ponytail.note',
+
+  async detect({ root }) {
+    const present = []
+    if (isPluginEnabled(root, [INSTALL_ID])) present.push('claude')
+    if (hasOpencode(root)) present.push('opencode')
+    if (present.length === 0) return { status: 'absent' }
+    if (present.length === SUPPORTS.length) return { status: 'installed' }
+    return {
+      status: 'partial',
+      detail: msg('item.plugin.partial', {
+        present: present.join(', '),
+        missing: SUPPORTS.filter((c) => !present.includes(c)).join(', '),
+      }),
+    }
+  },
+
+  async install({ root, dryRun, exec, log = () => {}, t }) {
+    let deferred = false
+    if (!isPluginEnabled(root, [INSTALL_ID])) {
+      await exec('claude', ['plugin', 'marketplace', 'add', MARKETPLACE.repo], { cwd: root })
+      const r = await exec('claude', ['plugin', 'install', INSTALL_ID, '--scope', 'project'], { cwd: root })
+      if (!r.ok) {
+        if (!dryRun) enablePlugin(root, INSTALL_ID, MARKETPLACE)
+        deferred = true
+      }
+    }
+    if (!hasOpencode(root)) {
+      const list = opencodeListOrThrow(root)
+      if (dryRun) log(t('log.plugin.add', { cli: 'OpenCode', name: OPENCODE_ENTRY }))
+      // 파일이 없거나 plugin 키가 없으면 배열째 만들고, 있으면 끝에 덧붙인다.
+      else if (list.length === 0) setKey(repoPathStrict(root, OPENCODE_FILE), ['plugin'], [OPENCODE_ENTRY])
+      else setKey(repoPathStrict(root, OPENCODE_FILE), ['plugin', list.length], OPENCODE_ENTRY)
+    }
+    if (deferred) return { fallback: true, message: msg('item.plugin.deferred') }
+  },
+
+  async uninstall({ root, dryRun, exec, log = () => {}, t }) {
+    if (isPluginEnabled(root, [INSTALL_ID])) {
+      const r = await exec('claude', ['plugin', 'uninstall', INSTALL_ID], { cwd: root })
+      if (!r.ok && !dryRun) disablePlugin(root, [INSTALL_ID])
+    }
+    if (!hasOpencode(root)) return
+    if (dryRun) {
+      log(t('log.plugin.remove', { cli: 'OpenCode', name: OPENCODE_ENTRY }))
+      return
+    }
+    const kept = opencodeListOrThrow(root).filter((p) => p !== OPENCODE_ENTRY)
+    const file = repoPathStrict(root, OPENCODE_FILE)
+    // 우리가 넣은 항목만 빼고 비면 키째 지운다 — 빈 배열을 남기면 우리가
+    // 만든 흔적이 설정에 계속 남는다.
+    if (kept.length === 0) removeKey(file, ['plugin'])
+    else setKey(file, ['plugin'], kept)
+  },
+}

package/lib/items/skill.gsd.mjs

@@ -1,44 +1,44 @@
-import { existsSync, readdirSync } from 'node:fs'
-import { join } from 'node:path'
-import { defineSkill } from '../catalog.mjs'
-import { CLI_IDS } from '../clis.mjs'
-import { LocalizedError, msg } from '../i18n/index.mjs'
-
-function hasGsdFiles(dir) {
-  return existsSync(dir) && readdirSync(dir).some((f) => f.startsWith('gsd-'))
-}
-
-// 상류(v1.9.1)는 런타임 플래그 18개(--codex·--antigravity 등)를 지원하지만
-// 이 항목은 --claude만 배선한다. Gemini CLI는 상류가 명시 제거했다(2026-06-18
-// Google 종료, --gemini는 --antigravity 안내 후 종료). 상류의 --kilo는
-// OpenCode 파생 "Kilo"(~/.config/kilo)라 이 저장소의 Kilo Code(.kilocode)와
-// 같은 제품인지 미확인이라 지원으로 표기하지 않는다(2026-08-02 검증).
-const FLAGS = ['codex', 'opencode', 'copilot', 'kimi']
-
-export default defineSkill({
-  id: 'skill.gsd', label: 'GSD (Get Shit Done)', group: '__flow', scope: 'project',
-  note: 'item.skill.gsd.note',
-  unsupported: Object.fromEntries(
-    CLI_IDS.filter((c) => c !== 'claude').map((c) => [
-      c,
-      FLAGS.includes(c) ? msg('item.unsupported.gsdFlag')
-        : c === 'gemini' ? msg('item.unsupported.gsdGemini')
-          : msg('item.unsupported.upstreamNone'),
-    ]),
-  ),
-  async detect({ root }) {
-    const found = hasGsdFiles(join(root, '.claude', 'commands')) || hasGsdFiles(join(root, '.claude', 'skills'))
-    return { status: found ? 'installed' : 'absent' }
-  },
-  async install({ root, exec }) {
-    const r = await exec('npx', ['-y', '@opengsd/gsd-core@latest', '--claude', '--local'], { cwd: root })
-    if (!r.ok) throw new LocalizedError('error.gsdInstall', { output: r.output })
-  },
-  async uninstall({ root, exec }) {
-    // 런타임 플래그가 없으면 상류가 기본값 claude를 지운다 — 지금은 --claude만
-    // 설치하므로 맞지만, 다른 런타임을 설치하게 되면 여기에도 같은 플래그를
-    // 넘겨야 엉뚱한 설치본이 지워지지 않는다.
-    const r = await exec('npx', ['-y', '@opengsd/gsd-core@latest', '--uninstall'], { cwd: root })
-    if (!r.ok) throw new LocalizedError('error.gsdUninstall', { output: r.output })
-  },
-})
+import { existsSync, readdirSync } from 'node:fs'
+import { join } from 'node:path'
+import { defineSkill } from '../catalog.mjs'
+import { CLI_IDS } from '../clis.mjs'
+import { LocalizedError, msg } from '../i18n/index.mjs'
+
+function hasGsdFiles(dir) {
+  return existsSync(dir) && readdirSync(dir).some((f) => f.startsWith('gsd-'))
+}
+
+// 상류(v1.9.1)는 런타임 플래그 18개(--codex·--antigravity 등)를 지원하지만
+// 이 항목은 --claude만 배선한다. Gemini CLI는 상류가 명시 제거했다(2026-06-18
+// Google 종료, --gemini는 --antigravity 안내 후 종료). 상류의 --kilo는
+// OpenCode 파생 "Kilo"(~/.config/kilo)라 이 저장소의 Kilo Code(.kilocode)와
+// 같은 제품인지 미확인이라 지원으로 표기하지 않는다(2026-08-02 검증).
+const FLAGS = ['codex', 'opencode', 'copilot', 'kimi']
+
+export default defineSkill({
+  id: 'skill.gsd', label: 'GSD (Get Shit Done)', group: '__flow', scope: 'project',
+  note: 'item.skill.gsd.note',
+  unsupported: Object.fromEntries(
+    CLI_IDS.filter((c) => c !== 'claude').map((c) => [
+      c,
+      FLAGS.includes(c) ? msg('item.unsupported.gsdFlag')
+        : c === 'gemini' ? msg('item.unsupported.gsdGemini')
+          : msg('item.unsupported.upstreamNone'),
+    ]),
+  ),
+  async detect({ root }) {
+    const found = hasGsdFiles(join(root, '.claude', 'commands')) || hasGsdFiles(join(root, '.claude', 'skills'))
+    return { status: found ? 'installed' : 'absent' }
+  },
+  async install({ root, exec }) {
+    const r = await exec('npx', ['-y', '@opengsd/gsd-core@latest', '--claude', '--local'], { cwd: root })
+    if (!r.ok) throw new LocalizedError('error.gsdInstall', { output: r.output })
+  },
+  async uninstall({ root, exec }) {
+    // 런타임 플래그가 없으면 상류가 기본값 claude를 지운다 — 지금은 --claude만
+    // 설치하므로 맞지만, 다른 런타임을 설치하게 되면 여기에도 같은 플래그를
+    // 넘겨야 엉뚱한 설치본이 지워지지 않는다.
+    const r = await exec('npx', ['-y', '@opengsd/gsd-core@latest', '--uninstall'], { cwd: root })
+    if (!r.ok) throw new LocalizedError('error.gsdUninstall', { output: r.output })
+  },
+})