@rch4com/agent-setup 1.28.0 → 2.2.0

package/lib/skills-registry.mjs

@@ -0,0 +1,93 @@
+// 공유 스킬 디렉터리(.agents/skills)와 레지스트리 잠금 파일을 읽고 정리하는
+// 보조 함수. 감지(probe)와 레지스트리 스킬 레시피가 함께 쓴다.
+import { existsSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { repoPath, repoPathStrict } from './context.mjs'
+import { escapeRegExp, isSafeSegment } from './untrusted.mjs'
+
+// 이 저장소가 공유 스킬 자리로 쓰는 디렉터리. vercel-labs/skills 레지스트리의
+// `--agent universal` 프로젝트 경로와 같은 값이다 — 그래서 레지스트리 설치가
+// 우리 배선 위에 그대로 얹힌다.
+export const SHARED_SKILLS = '.agents/skills'
+
+function skillDirs(root) {
+  const dir = repoPath(root, SHARED_SKILLS)
+  if (!existsSync(dir)) return []
+  return readdirSync(dir).filter((name) => {
+    try {
+      return statSync(join(dir, name)).isDirectory()
+    } catch {
+      return false
+    }
+  })
+}
+
+// 설치된 디렉터리 이름이 스킬 이름과 다를 수 있다(레지스트리는 SKILL.md의
+// frontmatter name으로 고르는데, 저장소의 폴더 이름은 다른 경우가 있다 —
+// taste-skill/이 design-taste-frontend를 담는 식이다). 이름이 같은 디렉터리를
+// 먼저 보고, 없으면 frontmatter를 읽어 찾는다. 디렉터리 이름만 보면 설치해
+// 놓고도 계속 '미설치'로 읽힌다.
+export function findSkillDir(root, skill) {
+  const base = repoPath(root, SHARED_SKILLS)
+  if (existsSync(join(base, skill, 'SKILL.md'))) return skill
+  for (const name of skillDirs(root)) {
+    const file = join(base, name, 'SKILL.md')
+    if (!existsSync(file)) continue
+    const head = readFileSync(file, 'utf8').slice(0, 2000)
+    if (new RegExp(`^name:\\s*['"]?${escapeRegExp(skill)}['"]?\\s*$`, 'm').test(head)) return name
+  }
+  return null
+}
+
+// 잠금 파일의 이름은 상류 SKILL.md frontmatter에서 온다 — 신뢰 경계 밖이다.
+// `npx skills remove <이름>`의 인자이자 `.agents/skills/<이름>` 경로가 되므로,
+// 플래그로 읽히는 선행 대시와 경로 구분자·상위 이동은 어느 쪽으로도 쓸 수 없다.
+export function isSafeSkillName(name) {
+  return isSafeSegment(name) && !name.startsWith('-')
+}
+
+// 레지스트리가 저장소 루트에 남기는 잠금 파일. 스킬 이름마다 어느 출처에서
+// 왔는지를 적어 두므로, 한 상류가 여러 스킬을 깔았을 때 "우리가 넣은 것"만
+// 골라 지울 수 있는 유일한 근거다.
+export const SKILLS_LOCK = 'skills-lock.json'
+
+// 잠금 파일의 source는 `owner/repo`로 정규화돼 있고 항목은 URL을 넘긴다.
+export function sourceKey(source) {
+  return String(source).replace(/^https?:\/\/github\.com\//, '').replace(/\.git$/, '').replace(/\/+$/, '')
+}
+
+function readLock(root) {
+  const file = repoPath(root, SKILLS_LOCK)
+  if (!existsSync(file)) return null
+  try {
+    return JSON.parse(readFileSync(file, 'utf8'))
+  } catch {
+    // 잠금 파일이 깨졌다고 제거를 막지는 않는다 — 디렉터리 스캔 폴백이 있다.
+    return null
+  }
+}
+
+export function lockedSkills(root, source) {
+  const want = sourceKey(source)
+  return Object.entries(readLock(root)?.skills ?? {})
+    .filter(([, v]) => sourceKey(v?.source ?? '') === want)
+    .map(([name]) => name)
+}
+
+// 레지스트리의 remove는 디렉터리도, 잠금 파일의 항목도 남긴다(실측). 디렉터리는
+// 아래에서 우리가 지우는데 잠금 항목을 그대로 두면 파일이 "설치돼 있다"고
+// 거짓말한다 — 커밋해서 팀과 나누는 파일이라, 동료가 experimental_install로
+// 복원하면 지운 스킬이 되살아난다.
+export function pruneLock(root, names) {
+  const parsed = readLock(root)
+  const skills = parsed?.skills
+  if (!skills) return
+  const gone = names.filter((n) => Object.hasOwn(skills, n))
+  if (gone.length === 0) return
+  for (const n of gone) delete skills[n]
+  const file = repoPathStrict(root, SKILLS_LOCK)
+  // 남은 스킬이 없으면 파일째 지운다. 이 파일은 레지스트리가 만든 산출물이라
+  // 빈 껍데기를 남기면 우리가 만든 흔적이 저장소에 계속 남는다.
+  if (Object.keys(skills).length === 0) rmSync(file, { force: true })
+  else writeFileSync(file, `${JSON.stringify(parsed, null, 2)}\n`)
+}

package/lib/status.mjs

@@ -7,6 +7,8 @@ import { MANIFEST } from './bootstrap/manifest.mjs'
 import { updateBlocks, updateFiles } from './bootstrap/apply.mjs'
 import { readRecord, toolVersion } from './bootstrap/record.mjs'
 import { createT } from './i18n/index.mjs'
+import { makeExec } from './catalog.mjs'
+import { createProbe } from './probe.mjs'
 
 // 미배선 사유는 상류를 실측한 날의 사실이다. 그 날짜(item.verified)가 이보다
 // 오래되면 status가 알린다 — 사유 문장이 화면에 낡은 채 남는 것을 막는 유일한
@@ -18,7 +20,7 @@ function daysSince(iso, now) {
   return Number.isFinite(ms) ? Math.floor(ms / 86_400_000) : 0
 }
 
-export async function collectStatus(root, { manifest = MANIFEST, items = [], latest, now = Date.now() } = {}) {
+export async function collectStatus(root, { manifest = MANIFEST, items = [], latest, now = Date.now(), probe = null } = {}) {
   const record = readRecord(root)
 
   // dry-run으로 갱신 판정만 얻는다 — 판정 로직을 두 벌 두면 status와 update가
@@ -33,10 +35,12 @@ export async function collectStatus(root, { manifest = MANIFEST, items = [], lat
 
   const count = (action) => verdicts.filter((v) => v.action === action).length
 
+  // 화면·--list와 같은 감지 경로 — 레시피 항목은 CLI 목록 캐시(probe)를 읽는다.
+  const shared = probe ?? createProbe({ root, scope: 'project', exec: makeExec(false) })
   const states = []
   for (const item of items) {
     try {
-      const r = await item.detect({ root })
+      const r = await item.detect({ root, probe: shared })
       states.push({ id: item.id, status: r.status })
     } catch {
       // 감지 실패로 status 전체가 죽으면 진단 도구가 아니다.
@@ -123,7 +127,7 @@ export async function fetchLatestVersion(fetchImpl = fetch) {
 
 export async function runStatus(root, { json = false, log = console.log, fetchImpl = fetch, t = createT('en') } = {}) {
   const { loadItems } = await import('./catalog.mjs')
-  const report = await collectStatus(root, { items: await loadItems(), latest: await fetchLatestVersion(fetchImpl) })
+  const report = await collectStatus(root, { items: await loadItems({ scope: 'project' }), latest: await fetchLatestVersion(fetchImpl) })
   log(json ? JSON.stringify(report, null, 2) : formatStatus(report, t))
   return report
 }

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,14 @@
 {
   "name": "@rch4com/agent-setup",
-  "version": "1.28.0",
+  "version": "2.2.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",
+    "github-copilot",
     "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])
-    }
-  }
-}