@rch4com/agent-setup 1.0.0 → 1.3.0

package/lib/items/plugin.ponytail.mjs

@@ -0,0 +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])) {
+      exec('claude', ['plugin', 'marketplace', 'add', MARKETPLACE.repo], { cwd: root })
+      const r = 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 = 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

@@ -1,7 +1,7 @@
-import { definePlugin } from '../catalog.mjs'
-export default definePlugin({
-  id: 'plugin.superpowers', label: 'superpowers',
-  installId: 'superpowers@claude-plugins-official',
-  detectIds: ['superpowers@claude-plugins-official', 'superpowers@superpowers-marketplace'],
-  note: '공식 마켓플레이스 플러그인',
-})
+import { definePlugin } from '../catalog.mjs'
+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',
+})

package/lib/items/plugin.understand-anything.mjs

@@ -0,0 +1,10 @@
+import { definePlugin } from '../catalog.mjs'
+// 다른 CLI용 install.sh도 있지만 그 경로는 ~/.understand-anything에 클론하고
+// 홈에 심볼릭 링크를 건다 — 사용자 스코프라 이 저장소의 항목이 될 수 없다.
+export default definePlugin({
+  id: 'plugin.understand-anything', label: 'Understand Anything', group: '__context',
+  installId: 'understand-anything@understand-anything',
+  detectIds: ['understand-anything@understand-anything'],
+  marketplace: { name: 'understand-anything', repo: 'Egonex-AI/Understand-Anything' },
+  note: 'item.plugin.understand-anything.note',
+})

package/lib/items/skill.caveman.mjs

@@ -0,0 +1,7 @@
+import { defineRegistrySkill } from '../catalog.mjs'
+export default defineRegistrySkill({
+  id: 'skill.caveman', label: 'caveman', group: '__token',
+  source: 'https://github.com/JuliusBrussee/caveman',
+  skill: 'caveman',
+  note: 'item.skill.caveman.note',
+})

package/lib/items/skill.gsd.mjs

@@ -1,24 +1,25 @@
-import { existsSync, readdirSync } from 'node:fs'
-import { join } from 'node:path'
-import { defineSkill } from '../catalog.mjs'
-
-function hasGsdFiles(dir) {
-  return existsSync(dir) && readdirSync(dir).some((f) => f.startsWith('gsd-'))
-}
-
-export default defineSkill({
-  id: 'skill.gsd', label: 'GSD (Get Shit Done)', scope: 'project',
-  note: 'npx @opengsd/gsd-core 프로젝트 로컬 설치',
-  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 = exec('npx', ['-y', '@opengsd/gsd-core@latest', '--claude', '--local'], { cwd: root })
-    if (!r.ok) throw new Error(`GSD 설치 실패: ${r.output}`)
-  },
-  async uninstall({ root, exec }) {
-    const r = exec('npx', ['-y', '@opengsd/gsd-core@latest', '--uninstall'], { cwd: root })
-    if (!r.ok) throw new Error(`GSD 제거 실패: ${r.output}`)
-  },
-})
+import { existsSync, readdirSync } from 'node:fs'
+import { join } from 'node:path'
+import { defineSkill } from '../catalog.mjs'
+import { LocalizedError } from '../i18n/index.mjs'
+
+function hasGsdFiles(dir) {
+  return existsSync(dir) && readdirSync(dir).some((f) => f.startsWith('gsd-'))
+}
+
+export default defineSkill({
+  id: 'skill.gsd', label: 'GSD (Get Shit Done)', group: '__flow', scope: 'project',
+  note: 'item.skill.gsd.note',
+  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 = 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 }) {
+    const r = 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,39 +1,40 @@
-import { existsSync, rmSync } from 'node:fs'
-import { join } from 'node:path'
-import { defineSkill } from '../catalog.mjs'
-import { repoPath, repoPathStrict } from '../context.mjs'
-import { ensureGitignoreEntries } from '../gitignore.mjs'
-
-const REL_DIR = '.claude/skills/gstack'
-
-export default defineSkill({
-  id: 'skill.gstack', label: 'gstack', scope: 'project',
-  note: '저장소 로컬 clone + setup (bash 필요, Windows는 Git Bash). 런타임 상태(~/.gstack)는 전역에 생길 수 있음.',
-  async detect({ root }) {
-    return { status: existsSync(repoPath(root, REL_DIR)) ? 'installed' : 'absent' }
-  },
-  async install({ root, dryRun, exec }) {
-    // clone·삭제가 일어나는 경로다. 어휘적 검사만으로는 .claude/skills가
-    // 저장소 밖을 가리키는 링크일 때를 막지 못한다(부트스트랩이 만드는
-    // .agents/skills Junction은 저장소 안이라 그대로 통과한다).
-    const dir = repoPathStrict(root, REL_DIR)
-    if (!existsSync(dir)) {
-      const clone = exec('git', ['clone', '--single-branch', '--depth', '1', 'https://github.com/garrytan/gstack.git', dir])
-      if (!clone.ok) throw new Error(`gstack clone 실패: ${clone.output}`)
-      const setup = exec('bash', ['./setup'], { cwd: dir })
-      if (!setup.ok) {
-        // setup 실패 잔존물이 detect를 installed로 오판시키지 않도록 정리한다.
-        rmSync(dir, { recursive: true, force: true })
-        throw new Error(`gstack setup 실패: ${setup.output}`)
-      }
-    }
-    // 부트스트랩 저장소에서는 .claude/skills가 .agents/skills Junction이므로 두 경로 모두 무시 처리
-    if (!dryRun) ensureGitignoreEntries(root, ['.claude/skills/gstack', '.agents/skills/gstack'])
-  },
-  async uninstall({ root, dryRun, exec }) {
-    const dir = repoPathStrict(root, REL_DIR)
-    if (!existsSync(dir)) return
-    exec('bash', [join(dir, 'bin', 'gstack-uninstall'), '--force'], { cwd: dir }) // 실패해도 디렉터리 삭제로 폴백
-    if (!dryRun && existsSync(dir)) rmSync(dir, { recursive: true, force: true })
-  },
-})
+import { existsSync, rmSync } from 'node:fs'
+import { join } from 'node:path'
+import { defineSkill } from '../catalog.mjs'
+import { repoPath, repoPathStrict } from '../context.mjs'
+import { ensureGitignoreEntries } from '../gitignore.mjs'
+import { LocalizedError } from '../i18n/index.mjs'
+
+const REL_DIR = '.claude/skills/gstack'
+
+export default defineSkill({
+  id: 'skill.gstack', label: 'gstack', group: '__flow', scope: 'project',
+  note: 'item.skill.gstack.note',
+  async detect({ root }) {
+    return { status: existsSync(repoPath(root, REL_DIR)) ? 'installed' : 'absent' }
+  },
+  async install({ root, dryRun, exec }) {
+    // clone·삭제가 일어나는 경로다. 어휘적 검사만으로는 .claude/skills가
+    // 저장소 밖을 가리키는 링크일 때를 막지 못한다(부트스트랩이 만드는
+    // .agents/skills Junction은 저장소 안이라 그대로 통과한다).
+    const dir = repoPathStrict(root, REL_DIR)
+    if (!existsSync(dir)) {
+      const clone = exec('git', ['clone', '--single-branch', '--depth', '1', 'https://github.com/garrytan/gstack.git', dir])
+      if (!clone.ok) throw new LocalizedError('error.gstackClone', { output: clone.output })
+      const setup = exec('bash', ['./setup'], { cwd: dir })
+      if (!setup.ok) {
+        // setup 실패 잔존물이 detect를 installed로 오판시키지 않도록 정리한다.
+        rmSync(dir, { recursive: true, force: true })
+        throw new LocalizedError('error.gstackSetup', { output: setup.output })
+      }
+    }
+    // 부트스트랩 저장소에서는 .claude/skills가 .agents/skills Junction이므로 두 경로 모두 무시 처리
+    if (!dryRun) ensureGitignoreEntries(root, ['.claude/skills/gstack', '.agents/skills/gstack'])
+  },
+  async uninstall({ root, dryRun, exec }) {
+    const dir = repoPathStrict(root, REL_DIR)
+    if (!existsSync(dir)) return
+    exec('bash', [join(dir, 'bin', 'gstack-uninstall'), '--force'], { cwd: dir }) // 실패해도 디렉터리 삭제로 폴백
+    if (!dryRun && existsSync(dir)) rmSync(dir, { recursive: true, force: true })
+  },
+})

package/lib/items/skill.karpathy.mjs

@@ -0,0 +1,7 @@
+import { defineRegistrySkill } from '../catalog.mjs'
+export default defineRegistrySkill({
+  id: 'skill.karpathy', label: 'Karpathy guidelines', group: '__flow',
+  source: 'https://github.com/multica-ai/andrej-karpathy-skills',
+  skill: 'karpathy-guidelines',
+  note: 'item.skill.karpathy.note',
+})

package/lib/items/skill.taste.mjs

@@ -0,0 +1,9 @@
+import { defineRegistrySkill } from '../catalog.mjs'
+// 저장소의 폴더 이름은 taste-skill이지만 SKILL.md의 name은 design-taste-frontend다.
+// 레지스트리는 name으로 고르므로 여기에도 name을 적는다.
+export default defineRegistrySkill({
+  id: 'skill.taste', label: 'Taste Skill', group: '__style',
+  source: 'https://github.com/Leonxlnx/taste-skill',
+  skill: 'design-taste-frontend',
+  note: 'item.skill.taste.note',
+})

package/lib/jsonfile.mjs

@@ -1,40 +1,40 @@
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs'
-import { dirname } from 'node:path'
-import { parse, modify, applyEdits } from 'jsonc-parser'
-
-const FORMAT = { formattingOptions: { insertSpaces: true, tabSize: 2 } }
-
-function readText(file) {
-  return existsSync(file) ? readFileSync(file, 'utf8') : ''
-}
-
-export function readJson(file) {
-  const text = readText(file)
-  if (!text.trim()) return undefined
-  return parse(text)
-}
-
-export function setKey(file, path, value) {
-  let text = readText(file)
-  if (!text.trim()) text = '{}\n'
-  const edits = modify(text, path, value, FORMAT)
-  mkdirSync(dirname(file), { recursive: true })
-  writeFileSync(file, applyEdits(text, edits))
-}
-
-export function removeKey(file, path) {
-  const text = readText(file)
-  if (!text.trim()) return
-  if (getIn(parse(text), path) === undefined) return
-  const edits = modify(text, path, undefined, FORMAT)
-  writeFileSync(file, applyEdits(text, edits))
-}
-
-export function getIn(data, path) {
-  let cur = data
-  for (const key of path) {
-    if (cur == null || typeof cur !== 'object') return undefined
-    cur = cur[key]
-  }
-  return cur
-}
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs'
+import { dirname } from 'node:path'
+import { parse, modify, applyEdits } from 'jsonc-parser'
+
+const FORMAT = { formattingOptions: { insertSpaces: true, tabSize: 2 } }
+
+function readText(file) {
+  return existsSync(file) ? readFileSync(file, 'utf8') : ''
+}
+
+export function readJson(file) {
+  const text = readText(file)
+  if (!text.trim()) return undefined
+  return parse(text)
+}
+
+export function setKey(file, path, value) {
+  let text = readText(file)
+  if (!text.trim()) text = '{}\n'
+  const edits = modify(text, path, value, FORMAT)
+  mkdirSync(dirname(file), { recursive: true })
+  writeFileSync(file, applyEdits(text, edits))
+}
+
+export function removeKey(file, path) {
+  const text = readText(file)
+  if (!text.trim()) return
+  if (getIn(parse(text), path) === undefined) return
+  const edits = modify(text, path, undefined, FORMAT)
+  writeFileSync(file, applyEdits(text, edits))
+}
+
+export function getIn(data, path) {
+  let cur = data
+  for (const key of path) {
+    if (cur == null || typeof cur !== 'object') return undefined
+    cur = cur[key]
+  }
+  return cur
+}

package/lib/status.mjs

@@ -0,0 +1,93 @@
+// status — 의도(설치 기록) / 실제(스캔) / 가용(최신 패키지)을 나란히 보여준다.
+//
+// 실제 상태의 근거는 여전히 스캔이다. 기록은 의도일 뿐이므로 둘이 어긋나면
+// 어느 쪽에만 있는지 갈라 보여준다 — 수동 설치·제거를 그대로 잡는다는
+// 기존 강점을 기록이 가리지 않게 한다.
+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'
+
+export async function collectStatus(root, { manifest = MANIFEST, items = [], latest } = {}) {
+  const record = readRecord(root)
+
+  // dry-run으로 갱신 판정만 얻는다 — 판정 로직을 두 벌 두면 status와 update가
+  // 다른 답을 내는 순간이 온다.
+  const silent = () => {}
+  const verdicts = record
+    ? [
+        ...updateFiles(root, manifest.files, { managed: record.managed, dryRun: true, log: silent }),
+        ...updateBlocks(root, manifest.blocks, { managed: record.managed, dryRun: true, log: silent }),
+      ]
+    : []
+
+  const count = (action) => verdicts.filter((v) => v.action === action).length
+
+  const states = []
+  for (const item of items) {
+    try {
+      const r = await item.detect({ root })
+      states.push({ id: item.id, status: r.status })
+    } catch {
+      // 감지 실패로 status 전체가 죽으면 진단 도구가 아니다.
+      states.push({ id: item.id, status: 'absent' })
+    }
+  }
+  const installed = states.filter((s) => s.status !== 'absent').map((s) => s.id)
+  const intended = new Set(record?.items ?? [])
+
+  return {
+    hasRecord: Boolean(record),
+    tool: {
+      pinned: record?.pinnedVersion ?? null,
+      running: toolVersion(),
+      latest: latest ?? null,
+    },
+    files: {
+      total: verdicts.length,
+      current: count('skip'),
+      pending: count('update') + count('create'),
+      drift: count('drift'),
+    },
+    items: {
+      installed,
+      recordOnly: [...intended].filter((id) => !installed.includes(id)),
+      repoOnly: installed.filter((id) => !intended.has(id)),
+    },
+  }
+}
+
+export function formatStatus(report, t = createT('en')) {
+  const lines = []
+  const { tool, files, items } = report
+
+  if (!report.hasRecord) {
+    lines.push(t('status.noRecord'))
+    lines.push(t('status.noRecord.hint1'))
+    lines.push(t('status.noRecord.hint2'))
+    return lines.join('\n')
+  }
+
+  const version = tool.latest && tool.latest !== tool.running
+    ? t('status.version.latest', { pinned: tool.pinned, running: tool.running, latest: tool.latest })
+    : t('status.version.pinned', { pinned: tool.pinned, running: tool.running })
+  lines.push(t('status.row.tool', { version }))
+  if (tool.pinned !== tool.running) lines.push(t('status.hint.update'))
+
+  lines.push(t('status.row.files', files))
+  if (files.pending > 0) lines.push(t('status.hint.pending'))
+  if (files.drift > 0) lines.push(t('status.hint.drift'))
+
+  lines.push(t('status.row.items', { list: items.installed.join(', ') || t('status.none') }))
+  if (items.recordOnly.length) lines.push(t('status.row.recordOnly', { list: items.recordOnly.join(', ') }))
+  if (items.repoOnly.length) lines.push(t('status.row.repoOnly', { list: items.repoOnly.join(', ') }))
+
+  return lines.join('\n')
+}
+
+export async function runStatus(root, { json = false, log = console.log, t = createT('en') } = {}) {
+  const { loadItems } = await import('./catalog.mjs')
+  const report = await collectStatus(root, { items: await loadItems() })
+  log(json ? JSON.stringify(report, null, 2) : formatStatus(report, t))
+  return report
+}

package/lib/tomlfile.mjs

@@ -1,60 +1,60 @@
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs'
-import { dirname } from 'node:path'
-import { parse } from 'smol-toml'
-
-function readText(file) {
-  return existsSync(file) ? readFileSync(file, 'utf8') : ''
-}
-
-function escapeRegExp(text) {
-  return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
-}
-
-export function hasSection(file, name) {
-  const text = readText(file)
-  if (!text.trim()) return false
-  try {
-    const data = parse(text)
-    return data.mcp_servers != null && Object.hasOwn(data.mcp_servers, name)
-  } catch {
-    return false
-  }
-}
-
-export function appendSection(file, name, lines) {
-  let text = readText(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
-  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'))
-}
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs'
+import { dirname } from 'node:path'
+import { parse } from 'smol-toml'
+
+function readText(file) {
+  return existsSync(file) ? readFileSync(file, 'utf8') : ''
+}
+
+function escapeRegExp(text) {
+  return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+}
+
+export function hasSection(file, name) {
+  const text = readText(file)
+  if (!text.trim()) return false
+  try {
+    const data = parse(text)
+    return data.mcp_servers != null && Object.hasOwn(data.mcp_servers, name)
+  } catch {
+    return false
+  }
+}
+
+export function appendSection(file, name, lines) {
+  let text = readText(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
+  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'))
+}