@rch4com/agent-setup 1.10.0 → 1.11.1

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.bkit.mjs

@@ -4,9 +4,11 @@ import { msg } from '../i18n/index.mjs'
 
 // 상류의 Codex·Gemini 지원은 이 플러그인이 아니라 별도 리포의 독립 포팅본이다
 // (bkit-codex: install 스크립트+MCP, 기능 241개 중 80개, hooks 없음 /
-// bkit-gemini: Gemini CLI extension). 플러그인 항목을 재사용할 수 없어 사유만
-// 남긴다. Gemini CLI는 2026-06-18 종료라 Gemini판은 Antigravity 승계 추정
-// (2026-08-02 검증).
+// bkit-gemini: Gemini CLI extension). 플러그인 항목을 재사용할 수 없어 사유만 남긴다.
+// 예전에 "Gemini판은 Antigravity 승계 추정"이라 적었는데 근거가 없었다 —
+// bkit-gemini는 v2.0.7까지 Gemini CLI 확장 그대로이고 README에 Antigravity가
+// 한 번도 나오지 않는다. 다만 최종 푸시가 2026-05-20이라 Gemini CLI 종료
+// (2026-06-18) 이후로는 갱신이 없다. 추정 대신 그 사실만 적는다(2026-08-15 실측).
 const PORTS = ['codex', 'gemini']
 
 export default definePlugin({

package/lib/items/plugin.ecc.mjs

@@ -1,11 +1,26 @@
 import { definePlugin } from '../catalog.mjs'
+import { CLI_IDS } from '../clis.mjs'
+import { msg } from '../i18n/index.mjs'
 // 레지스트리 경로(`npx skills add`)도 열려 있지만 쓰지 않는다 — ECC의 skills/에는
-// 281개가 들어 있어 `--skill` 없이 넣으면 공유 스킬 디렉터리를 통째로 덮는다.
-// 플러그인은 프로필을 상류가 관리하므로 저장소에 남는 파일이 없다.
+// 284개가 들어 있어 `--skill` 없이 넣으면 공유 스킬 디렉터리를 통째로 덮는다
+// (2026-08-15 저장소 트리로 실측). 플러그인은 프로필을 상류가 관리하므로
+// 저장소에 남는 파일이 없다.
+//
+// 미배선 사유는 CLI마다 갈린다. Codex만 상류가 네이티브 플러그인을 주는데,
+// README가 못을 박는다 — "Codex stores one enabled plugin state in the active
+// CODEX_HOME; it does not offer Claude's user, project, and local scopes."
+// 나머지는 ./install.sh --target으로 열려 있고 Gemini(.gemini/)·Kimi(.kimi-code/)는
+// 프로젝트 로컬이기까지 하다. 그쪽을 막는 것은 스코프가 아니라 284개라는 규모다.
 export default definePlugin({
   id: 'plugin.ecc', label: 'ECC', group: '__flow',
   installId: 'ecc@ecc',
   detectIds: ['ecc@ecc'],
   marketplace: { name: 'ecc', repo: 'affaan-m/ECC' },
   note: 'item.plugin.ecc.note',
+  unsupported: Object.fromEntries(
+    CLI_IDS.filter((c) => c !== 'claude').map((c) => [
+      c,
+      c === 'codex' ? msg('item.unsupported.eccCodexHome') : msg('item.unsupported.eccScale'),
+    ]),
+  ),
 })

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

@@ -1,8 +1,18 @@
-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'
+import { CLI_IDS } from '../clis.mjs'
+import { msg } from '../i18n/index.mjs'
+// 상류가 "Codex, and other agents" 절에서 `npx skills add mattpocock/skills`를
+// 안내한다 — 이 저장소의 레지스트리 스킬 항목이 쓰는 바로 그 경로다(레지스트리로
+// 35개가 보이는 것을 실측, 2026-08-15). 그러니 미배선 사유는 "상류에 없다"가
+// 아니라 "우리가 플러그인 쪽을 골랐다"이고, 사유가 그렇게 말해야 레지스트리
+// 항목으로 옮길 수 있다는 것도 화면에서 읽힌다.
+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',
+  unsupported: Object.fromEntries(
+    CLI_IDS.filter((c) => c !== 'claude').map((c) => [c, msg('item.unsupported.mattpocockRegistry')]),
+  ),
+})

package/lib/items/plugin.ponytail.mjs

@@ -1,104 +1,106 @@
-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·grok·gemini는 상류에 설치 경로가 있지만 전부 사용자
+      // 스코프다. grok은 `grok plugin install DietrichGebert/ponytail --trust`로
+      // 플러그인 기구가 엄연히 있다 — "기구가 없다" 쪽에 두면 거짓이다
+      // (2026-08-15 재측정). 나머지는 상류의 규칙 파일을 손으로 옮겨야 한다.
+      ['codex', 'copilot', 'gemini', 'grok'].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/plugin.superpowers.mjs

@@ -2,12 +2,15 @@ import { definePlugin } from '../catalog.mjs'
 import { CLI_IDS } from '../clis.mjs'
 import { msg } from '../i18n/index.mjs'
 
-// 상류(obra/superpowers v6.2.0)는 Codex·Antigravity·Copilot CLI 등 11개
+// 상류(obra/superpowers v6.3.0)는 Codex·Antigravity·Copilot CLI 등 14개
 // 하니스를 지원하지만 설치 명령이 하니스마다 전부 달라 공유 경로가 없다
 // (README: "install Superpowers separately for each one"). 이 항목이 배선하는
-// 것은 Claude Code 플러그인 판뿐이다. Kilo·Kiro·Grok·VS Code는 상류에 공식
-// 설치 경로가 없다(2026-08-02 검증).
-const SEPARATE = ['codex', 'gemini', 'opencode', 'kimi', 'copilot']
+// 것은 Claude Code 플러그인 판뿐이다. Kilo·Kiro·VS Code는 상류에 공식 설치
+// 경로가 없다(2026-08-15 재측정).
+// Grok은 6.2.0에는 없다가 6.3.0에서 들어왔다 — `### Grok Build CLI`의
+// `grok plugin install superpowers@xai-official --trust`다. Devin·Hermes도 같이
+// 늘었지만 둘 다 이 저장소가 다루는 CLI가 아니다.
+const SEPARATE = ['codex', 'gemini', 'opencode', 'kimi', 'copilot', 'grok']
 
 export default definePlugin({
   id: 'plugin.superpowers', label: 'superpowers', group: '__flow',