@rch4com/agent-setup 1.5.0 → 1.6.0

package/lib/catalog.mjs

@@ -137,9 +137,12 @@ export function defineMcp({ id, label, server, supports = [...CLI_IDS], unsuppor
   }
 }
 
-export function definePlugin({ id, label, installId, detectIds, marketplace, note, group = null }) {
+// 배선은 Claude 한 곳이라도 미배선 "사유"는 CLI마다 다를 수 있다 — 상류가
+// 자체 경로로 지원하는 CLI에 일괄 "Claude 전용" 사유를 붙이면 거짓 정보가 된다.
+// 항목이 사유를 넘기면 그 CLI만 덮고, 나머지는 기본 사유로 채운다.
+export function definePlugin({ id, label, installId, detectIds, marketplace, note, group = null, unsupported: reasons = {} }) {
   const unsupported = Object.fromEntries(
-    CLI_IDS.filter((c) => c !== 'claude').map((c) => [c, msg('item.unsupported.claudePlugin')]),
+    CLI_IDS.filter((c) => c !== 'claude').map((c) => [c, reasons[c] ?? msg('item.unsupported.claudePlugin')]),
   )
   return {
     id, category: 'plugin', label, scope: 'project', supports: ['claude'], unsupported, note, group,
@@ -163,9 +166,9 @@ export function definePlugin({ id, label, installId, detectIds, marketplace, not
   }
 }
 
-export function defineSkill({ id, label, scope, detect, install, uninstall, note, group = null }) {
+export function defineSkill({ id, label, scope, detect, install, uninstall, note, group = null, unsupported: reasons = {} }) {
   const unsupported = Object.fromEntries(
-    CLI_IDS.filter((c) => c !== 'claude').map((c) => [c, msg('item.unsupported.claudeSkill')]),
+    CLI_IDS.filter((c) => c !== 'claude').map((c) => [c, reasons[c] ?? msg('item.unsupported.claudeSkill')]),
   )
   return { id, category: 'skill', label, scope, supports: ['claude'], unsupported, note, group, detect, install, uninstall }
 }

package/lib/i18n/catalog/en.mjs

@@ -228,6 +228,13 @@ export default {
   'item.unsupported.claudeSkill': 'Claude Code skill install',
   'item.unsupported.ponytailUser': 'upstream installs it per user (codex/copilot plugin, gemini extension)',
   'item.unsupported.ponytailRules': 'no plugin mechanism — copy the ruleset into AGENTS.md by hand',
+  'item.unsupported.upstreamNone': 'no official install path upstream',
+  'item.unsupported.superpowersSeparate': 'upstream supports it via a separate per-harness install — this item wires the Claude Code plugin only',
+  'item.unsupported.bkitPort': 'upstream ships separate ports (bkit-codex / bkit-gemini) installed apart from this plugin; the Gemini port presumably succeeds to Antigravity',
+  'item.unsupported.impeccableJunction': 'upstream supports it, but npx impeccable install breaks the shared .agents/skills link, so only the plugin route is wired',
+  'item.unsupported.gstackHost': 'upstream supports it via ./setup --host — this item installs for Claude Code only',
+  'item.unsupported.gsdFlag': 'upstream supports it via a runtime flag — this item installs with --claude only',
+  'item.unsupported.gsdGemini': 'upstream dropped Gemini CLI (sunset 2026-06) — Antigravity succeeds it via --antigravity',
   'item.mcp.partial': 'registered: {present} / missing: {missing}',
   'item.plugin.partial': 'wired: {present} / missing: {missing}',
   'item.plugin.deferred': 'recorded in config — it downloads on the next Claude Code run',
@@ -243,7 +250,7 @@ export default {
   'item.mcp.codebase-memory.note': 'needs the codebase-memory-mcp binary on PATH. Install: https://github.com/DeusData/codebase-memory-mcp (install.sh / install.ps1)',
   'item.mcp.graphify.note': 'needs the graphify-mcp binary on PATH. Install: uv tool install "graphifyy[mcp]". Reads graphify-out/graph.json — build it first with /graphify .',
   'item.mcp.headroom.note': 'needs the headroom binary on PATH. Install: uv tool install --python 3.13 "headroom-ai[proxy,mcp]". The proxy (headroom wrap) is a way of launching, not repo config',
-  'item.plugin.superpowers.note': 'official marketplace plugin',
+  'item.plugin.superpowers.note': 'official marketplace plugin. Upstream supports 11 harnesses (Codex, Antigravity, …) via per-harness installs',
   'item.plugin.mattpocock-skills.note': '22 engineering and productivity skills (tdd, code-review, research, …)',
   'item.plugin.ponytail.note': 'lean-code ruleset. Wires the Claude Code plugin and the OpenCode plugin entry, both repo-scoped',
   'item.plugin.ecc.note': 'skills, instincts, memory and security for agent harnesses. Installed as a plugin — its skills/ holds 281 entries, too many to copy into the shared skills directory',
@@ -253,7 +260,7 @@ export default {
   'item.skill.taste.note': 'anti-slop frontend skill for landing pages, portfolios and redesigns (skill name: design-taste-frontend)',
   'item.skill.karpathy.note': 'behavioral guidelines that curb overbuilding and vague success criteria',
   'item.skill.gstack.note': 'repo-local clone + setup (needs bash; Git Bash on Windows). Runtime state (~/.gstack) may be created globally.',
-  'item.skill.gsd.note': 'npx @opengsd/gsd-core, installed per project',
+  'item.skill.gsd.note': 'npx @opengsd/gsd-core, installed per project. Upstream supports 18 runtimes (Codex, Antigravity, …); this item wires --claude only',
   'error.gstackClone': 'gstack clone failed: {output}',
   'error.gstackSetup': 'gstack setup failed: {output}',
   'error.gsdInstall': 'GSD install failed: {output}',

package/lib/i18n/catalog/ko.mjs

@@ -221,6 +221,13 @@ export default {
   'item.unsupported.claudeSkill': 'Claude Code 스킬 설치본',
   'item.unsupported.ponytailUser': '상류 설치 경로가 사용자 스코프입니다 (codex·copilot 플러그인, gemini 확장)',
   'item.unsupported.ponytailRules': '플러그인 기구가 없습니다 — 규칙을 AGENTS.md에 직접 옮겨 적으세요',
+  'item.unsupported.upstreamNone': '상류에 공식 설치 경로가 없습니다',
+  'item.unsupported.superpowersSeparate': '상류가 하니스별 별도 설치로 지원합니다 — 이 항목은 Claude Code 플러그인만 배선합니다',
+  'item.unsupported.bkitPort': '상류가 별도 배포판(bkit-codex·bkit-gemini)으로 지원합니다 — 이 플러그인과 별개 설치이며, Gemini판은 Antigravity 승계 추정입니다',
+  'item.unsupported.impeccableJunction': '상류는 지원하지만 npx impeccable install이 공유 .agents/skills 연결을 끊어 플러그인 경로만 배선합니다',
+  'item.unsupported.gstackHost': '상류는 ./setup --host로 지원합니다 — 이 항목은 Claude Code에만 설치합니다',
+  'item.unsupported.gsdFlag': '상류는 런타임 플래그로 지원합니다 — 이 항목은 --claude로만 설치합니다',
+  'item.unsupported.gsdGemini': '상류가 Gemini CLI 지원을 제거했습니다(2026-06 종료) — Antigravity가 --antigravity로 승계합니다',
   'item.mcp.partial': '등록됨: {present} / 누락: {missing}',
   'item.plugin.partial': '배선됨: {present} / 누락: {missing}',
   'item.plugin.deferred': '설정 기록됨 — 다음 Claude Code 실행 시 다운로드됩니다',
@@ -236,7 +243,7 @@ export default {
   'item.mcp.codebase-memory.note': 'PATH에 codebase-memory-mcp 바이너리 필요. 설치: https://github.com/DeusData/codebase-memory-mcp (install.sh / install.ps1)',
   'item.mcp.graphify.note': 'PATH에 graphify-mcp 바이너리 필요. 설치: uv tool install "graphifyy[mcp]". graphify-out/graph.json을 읽으므로 /graphify .로 그래프를 먼저 만드세요',
   'item.mcp.headroom.note': 'PATH에 headroom 바이너리 필요. 설치: uv tool install --python 3.13 "headroom-ai[proxy,mcp]". 프록시(headroom wrap)는 실행 방식이라 저장소 설정 대상이 아닙니다',
-  'item.plugin.superpowers.note': '공식 마켓플레이스 플러그인',
+  'item.plugin.superpowers.note': '공식 마켓플레이스 플러그인. 상류는 Codex·Antigravity 등 11개 하니스를 하니스별 설치로 지원합니다',
   'item.plugin.mattpocock-skills.note': '엔지니어링·생산성 스킬 22종 (tdd, code-review, research 등)',
   'item.plugin.ponytail.note': '군더더기 없는 코드 규칙 묶음. Claude Code 플러그인과 OpenCode plugin 항목을 저장소 범위로 배선합니다',
   'item.plugin.ecc.note': '에이전트 하네스용 스킬·본능·메모리·보안 묶음. skills/에 281개가 들어 있어 공유 스킬 디렉터리에 복사하지 않고 플러그인으로 설치합니다',
@@ -246,7 +253,7 @@ export default {
   'item.skill.taste.note': '랜딩 페이지·포트폴리오·리디자인용 안티슬롭 프런트엔드 스킬 (스킬 이름: design-taste-frontend)',
   'item.skill.karpathy.note': '과설계와 모호한 완료 기준을 줄이는 행동 지침',
   'item.skill.gstack.note': '저장소 로컬 clone + setup (bash 필요, Windows는 Git Bash). 런타임 상태(~/.gstack)는 전역에 생길 수 있음.',
-  'item.skill.gsd.note': 'npx @opengsd/gsd-core 프로젝트 로컬 설치',
+  'item.skill.gsd.note': 'npx @opengsd/gsd-core 프로젝트 로컬 설치. 상류는 Codex·Antigravity 등 18개 런타임을 지원합니다(이 항목은 --claude)',
   'error.gstackClone': 'gstack clone 실패: {output}',
   'error.gstackSetup': 'gstack setup 실패: {output}',
   'error.gsdInstall': 'GSD 설치 실패: {output}',

package/lib/items/plugin.bkit.mjs

@@ -1,7 +1,23 @@
 import { definePlugin } from '../catalog.mjs'
+import { CLI_IDS } from '../clis.mjs'
+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 검증).
+const PORTS = ['codex', 'gemini']
+
 export default definePlugin({
   id: 'plugin.bkit', label: 'bkit', group: '__flow',
   installId: 'bkit@bkit-marketplace',
   detectIds: ['bkit@bkit-marketplace'],
   marketplace: { name: 'bkit-marketplace', repo: 'popup-studio-ai/bkit-claude-code' },
+  unsupported: Object.fromEntries(
+    CLI_IDS.filter((c) => c !== 'claude').map((c) => [
+      c,
+      PORTS.includes(c) ? msg('item.unsupported.bkitPort') : msg('item.unsupported.upstreamNone'),
+    ]),
+  ),
 })

package/lib/items/plugin.impeccable.mjs

@@ -1,14 +1,28 @@
 import { definePlugin } from '../catalog.mjs'
+import { CLI_IDS } from '../clis.mjs'
+import { msg } from '../i18n/index.mjs'
 // 상류의 멀티 CLI 경로(`npx impeccable install --providers=... --scope=project`)는
 // 쓰지 않는다. 실측 결과 그 명령이 `.claude/skills`를 **실제 디렉터리로 갈아치워**
 // 부트스트랩이 만든 `.agents/skills` Junction을 끊는다 — 공유 스킬이 전부
-// Claude Code 화면에서 사라진다. 플러그인 경로는 `.claude/skills`를 건드리지 않는다.
+// Claude Code 화면에서 사라진다. 버그가 아니라 설계다: 상류
+// `cli/bin/commands/skills.mjs`의 isInProjectProviderLink가 "프로젝트 안 다른
+// 프로바이더를 가리키는 링크"를 의도적으로 unlink한다(3.5.0 재확인, 2026-08-02).
+// 플러그인 경로는 `.claude/skills`를 건드리지 않는다.
 // 또 그 명령은 `--providers`와 `--scope`를 함께 주지 않으면 대화형으로 물으며,
 // 비TTY에서는 조용히 global을 골라 홈에 설치한다.
+// 상류 공식 프로바이더 14개 중 이 저장소의 CLI와 겹치는 것(아래 UPSTREAM).
+// Antigravity는 README에만 있고 설치 CLI는 거부한다(수동 복사 전용).
+const UPSTREAM = ['codex', 'gemini', 'opencode', 'kiro', 'grok', 'copilot']
 export default definePlugin({
   id: 'plugin.impeccable', label: 'impeccable', group: '__style',
   installId: 'impeccable@impeccable',
   detectIds: ['impeccable@impeccable'],
   marketplace: { name: 'impeccable', repo: 'pbakaus/impeccable' },
   note: 'item.plugin.impeccable.note',
+  unsupported: Object.fromEntries(
+    CLI_IDS.filter((c) => c !== 'claude').map((c) => [
+      c,
+      UPSTREAM.includes(c) ? msg('item.unsupported.impeccableJunction') : msg('item.unsupported.upstreamNone'),
+    ]),
+  ),
 })

package/lib/items/plugin.superpowers.mjs

@@ -1,7 +1,23 @@
 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개
+// 하니스를 지원하지만 설치 명령이 하니스마다 전부 달라 공유 경로가 없다
+// (README: "install Superpowers separately for each one"). 이 항목이 배선하는
+// 것은 Claude Code 플러그인 판뿐이다. Kilo·Kiro·Grok·VS Code는 상류에 공식
+// 설치 경로가 없다(2026-08-02 검증).
+const SEPARATE = ['codex', 'gemini', 'opencode', 'kimi', 'copilot']
+
 export default definePlugin({
   id: 'plugin.superpowers', label: 'superpowers', group: '__flow',
   installId: 'superpowers@claude-plugins-official',
   detectIds: ['superpowers@claude-plugins-official', 'superpowers@superpowers-marketplace'],
   note: 'item.plugin.superpowers.note',
+  unsupported: Object.fromEntries(
+    CLI_IDS.filter((c) => c !== 'claude').map((c) => [
+      c,
+      SEPARATE.includes(c) ? msg('item.unsupported.superpowersSeparate') : msg('item.unsupported.upstreamNone'),
+    ]),
+  ),
 })

package/lib/items/skill.gsd.mjs

@@ -1,15 +1,31 @@
 import { existsSync, readdirSync } from 'node:fs'
 import { join } from 'node:path'
 import { defineSkill } from '../catalog.mjs'
-import { LocalizedError } from '../i18n/index.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' }
@@ -19,6 +35,9 @@ export default defineSkill({
     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 })
   },

package/lib/items/skill.gstack.mjs

@@ -1,15 +1,29 @@
 import { existsSync, rmSync } from 'node:fs'
 import { join } from 'node:path'
 import { defineSkill } from '../catalog.mjs'
+import { CLI_IDS } from '../clis.mjs'
 import { repoPath, repoPathStrict } from '../context.mjs'
 import { ensureGitignoreEntries } from '../gitignore.mjs'
-import { LocalizedError } from '../i18n/index.mjs'
+import { LocalizedError, msg } from '../i18n/index.mjs'
 
 const REL_DIR = '.claude/skills/gstack'
 
+// 상류 setup은 --host codex·kiro·opencode(와 factory)도 지원하지만 이 항목은
+// 인자 없이 실행하며 setup의 기본값이 claude 단독이다. README 표에 있는
+// --host cursor·slate는 setup의 case 문이 거부해 exit 1로 죽는다 —
+// 확장한다면 안전한 값은 claude·codex·kiro·factory·opencode·auto뿐이다
+// (2026-08-02 검증).
+const HOSTS = ['codex', 'kiro', 'opencode']
+
 export default defineSkill({
   id: 'skill.gstack', label: 'gstack', group: '__flow', scope: 'project',
   note: 'item.skill.gstack.note',
+  unsupported: Object.fromEntries(
+    CLI_IDS.filter((c) => c !== 'claude').map((c) => [
+      c,
+      HOSTS.includes(c) ? msg('item.unsupported.gstackHost') : msg('item.unsupported.upstreamNone'),
+    ]),
+  ),
   async detect({ root }) {
     return { status: existsSync(repoPath(root, REL_DIR)) ? 'installed' : 'absent' }
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rch4com/agent-setup",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Repository-scoped bootstrap and optional-item installer for using multiple coding-agent CLIs in one repository | 여러 코딩 에이전트 CLI를 한 저장소에서 함께 쓰기 위한 저장소 범위 부트스트랩과 선택 항목 설치기",
   "keywords": [
     "agents-md",