@rch4com/agent-setup 1.1.0 → 1.4.0

package/lib/clis.mjs

@@ -1,102 +1,102 @@
-import { repoPath, repoPathStrict } from './context.mjs'
-import { readJson, setKey, removeKey, getIn } from './jsonfile.mjs'
-import { hasSection, appendSection, removeSection } from './tomlfile.mjs'
-
-// 읽기(has)는 어휘적 경로면 충분하고, 실제로 만들거나 고치는 경로(add·remove)만
-// 링크를 통한 저장소 이탈까지 검사한다 — bootstrap의 apply.mjs, design-md의
-// designPaths와 같은 규칙이다. 저장소 안 `.codex`·`.claude`가 홈을 가리키는
-// Junction일 때 MCP 등록 한 번으로 글로벌 설정이 생성·수정되는 것을 막는다.
-function jsonAdapter(relFile, topKey, toEntry) {
-  return {
-    has(root, name) {
-      const data = readJson(repoPath(root, relFile))
-      return getIn(data, [topKey, name]) !== undefined
-    },
-    add(root, name, server) {
-      setKey(repoPathStrict(root, relFile), [topKey, name], toEntry(server))
-    },
-    remove(root, name) {
-      removeKey(repoPathStrict(root, relFile), [topKey, name])
-    },
-  }
-}
-
-function tomlLines(server) {
-  if (server.kind === 'http') return [`url = ${JSON.stringify(server.url)}`]
-  return [
-    `command = ${JSON.stringify(server.command)}`,
-    `args = [${server.args.map((a) => JSON.stringify(a)).join(', ')}]`,
-  ]
-}
-
-export const CLIS = {
-  claude: {
-    label: 'Claude Code',
-    ...jsonAdapter('.mcp.json', 'mcpServers', (s) =>
-      s.kind === 'http'
-        ? { type: 'http', url: s.url }
-        : { type: 'stdio', command: s.command, args: s.args }),
-  },
-  codex: {
-    label: 'Codex',
-    has: (root, name) => hasSection(repoPath(root, '.codex/config.toml'), name),
-    add: (root, name, s) => appendSection(repoPathStrict(root, '.codex/config.toml'), name, tomlLines(s)),
-    remove: (root, name) => removeSection(repoPathStrict(root, '.codex/config.toml'), name),
-  },
-  gemini: {
-    label: 'Gemini CLI',
-    ...jsonAdapter('.gemini/settings.json', 'mcpServers', (s) =>
-      s.kind === 'http' ? { httpUrl: s.url } : { command: s.command, args: s.args }),
-  },
-  opencode: {
-    label: 'OpenCode',
-    ...jsonAdapter('opencode.jsonc', 'mcp', (s) =>
-      s.kind === 'http'
-        ? { type: 'remote', url: s.url, enabled: true }
-        : { type: 'local', command: [s.command, ...s.args], enabled: true }),
-  },
-  kilo: {
-    label: 'Kilo Code',
-    ...jsonAdapter('.kilocode/mcp.json', 'mcpServers', (s) =>
-      s.kind === 'http'
-        ? { type: 'streamable-http', url: s.url, disabled: false }
-        : { command: s.command, args: s.args, disabled: false }),
-  },
-  kiro: {
-    label: 'Kiro',
-    ...jsonAdapter('.kiro/settings/mcp.json', 'mcpServers', (s) =>
-      s.kind === 'http'
-        ? { url: s.url, disabled: false, autoApprove: [] }
-        : { command: s.command, args: s.args, disabled: false, autoApprove: [] }),
-  },
-  kimi: {
-    label: 'Kimi Code',
-    ...jsonAdapter('.kimi-code/mcp.json', 'mcpServers', (s) =>
-      s.kind === 'http' ? { url: s.url } : { command: s.command, args: s.args }),
-  },
-  grok: {
-    label: 'Grok Build',
-    has: (root, name) => hasSection(repoPath(root, '.grok/config.toml'), name),
-    add: (root, name, s) => appendSection(repoPathStrict(root, '.grok/config.toml'), name, tomlLines(s)),
-    remove: (root, name) => removeSection(repoPathStrict(root, '.grok/config.toml'), name),
-  },
-  copilot: {
-    label: 'GitHub Copilot CLI',
-    // Copilot CLI는 루트 .mcp.json도 읽지만(같은 이름이면 그쪽이 우선),
-    // 도구마다 자기 파일을 갖는 이 저장소의 패턴을 따라 .github/mcp.json에 쓴다.
-    ...jsonAdapter('.github/mcp.json', 'mcpServers', (s) =>
-      s.kind === 'http'
-        ? { type: 'http', url: s.url }
-        : { type: 'local', command: s.command, args: s.args }),
-  },
-  vscode: {
-    label: 'VS Code Copilot',
-    // VS Code는 최상위 키가 servers이고 로컬 서버 타입이 stdio다.
-    ...jsonAdapter('.vscode/mcp.json', 'servers', (s) =>
-      s.kind === 'http'
-        ? { type: 'http', url: s.url }
-        : { type: 'stdio', command: s.command, args: s.args }),
-  },
-}
-
-export const CLI_IDS = Object.keys(CLIS)
+import { repoPath, repoPathStrict } from './context.mjs'
+import { readJson, setKey, removeKey, getIn } from './jsonfile.mjs'
+import { hasSection, appendSection, removeSection } from './tomlfile.mjs'
+
+// 읽기(has)는 어휘적 경로면 충분하고, 실제로 만들거나 고치는 경로(add·remove)만
+// 링크를 통한 저장소 이탈까지 검사한다 — bootstrap의 apply.mjs, design-md의
+// designPaths와 같은 규칙이다. 저장소 안 `.codex`·`.claude`가 홈을 가리키는
+// Junction일 때 MCP 등록 한 번으로 글로벌 설정이 생성·수정되는 것을 막는다.
+function jsonAdapter(relFile, topKey, toEntry) {
+  return {
+    has(root, name) {
+      const data = readJson(repoPath(root, relFile))
+      return getIn(data, [topKey, name]) !== undefined
+    },
+    add(root, name, server) {
+      setKey(repoPathStrict(root, relFile), [topKey, name], toEntry(server))
+    },
+    remove(root, name) {
+      removeKey(repoPathStrict(root, relFile), [topKey, name])
+    },
+  }
+}
+
+function tomlLines(server) {
+  if (server.kind === 'http') return [`url = ${JSON.stringify(server.url)}`]
+  return [
+    `command = ${JSON.stringify(server.command)}`,
+    `args = [${server.args.map((a) => JSON.stringify(a)).join(', ')}]`,
+  ]
+}
+
+export const CLIS = {
+  claude: {
+    label: 'Claude Code',
+    ...jsonAdapter('.mcp.json', 'mcpServers', (s) =>
+      s.kind === 'http'
+        ? { type: 'http', url: s.url }
+        : { type: 'stdio', command: s.command, args: s.args }),
+  },
+  codex: {
+    label: 'Codex',
+    has: (root, name) => hasSection(repoPath(root, '.codex/config.toml'), name),
+    add: (root, name, s) => appendSection(repoPathStrict(root, '.codex/config.toml'), name, tomlLines(s)),
+    remove: (root, name) => removeSection(repoPathStrict(root, '.codex/config.toml'), name),
+  },
+  gemini: {
+    label: 'Gemini CLI',
+    ...jsonAdapter('.gemini/settings.json', 'mcpServers', (s) =>
+      s.kind === 'http' ? { httpUrl: s.url } : { command: s.command, args: s.args }),
+  },
+  opencode: {
+    label: 'OpenCode',
+    ...jsonAdapter('opencode.jsonc', 'mcp', (s) =>
+      s.kind === 'http'
+        ? { type: 'remote', url: s.url, enabled: true }
+        : { type: 'local', command: [s.command, ...s.args], enabled: true }),
+  },
+  kilo: {
+    label: 'Kilo Code',
+    ...jsonAdapter('.kilocode/mcp.json', 'mcpServers', (s) =>
+      s.kind === 'http'
+        ? { type: 'streamable-http', url: s.url, disabled: false }
+        : { command: s.command, args: s.args, disabled: false }),
+  },
+  kiro: {
+    label: 'Kiro',
+    ...jsonAdapter('.kiro/settings/mcp.json', 'mcpServers', (s) =>
+      s.kind === 'http'
+        ? { url: s.url, disabled: false, autoApprove: [] }
+        : { command: s.command, args: s.args, disabled: false, autoApprove: [] }),
+  },
+  kimi: {
+    label: 'Kimi Code',
+    ...jsonAdapter('.kimi-code/mcp.json', 'mcpServers', (s) =>
+      s.kind === 'http' ? { url: s.url } : { command: s.command, args: s.args }),
+  },
+  grok: {
+    label: 'Grok Build',
+    has: (root, name) => hasSection(repoPath(root, '.grok/config.toml'), name),
+    add: (root, name, s) => appendSection(repoPathStrict(root, '.grok/config.toml'), name, tomlLines(s)),
+    remove: (root, name) => removeSection(repoPathStrict(root, '.grok/config.toml'), name),
+  },
+  copilot: {
+    label: 'GitHub Copilot CLI',
+    // Copilot CLI는 루트 .mcp.json도 읽지만(같은 이름이면 그쪽이 우선),
+    // 도구마다 자기 파일을 갖는 이 저장소의 패턴을 따라 .github/mcp.json에 쓴다.
+    ...jsonAdapter('.github/mcp.json', 'mcpServers', (s) =>
+      s.kind === 'http'
+        ? { type: 'http', url: s.url }
+        : { type: 'local', command: s.command, args: s.args }),
+  },
+  vscode: {
+    label: 'VS Code Copilot',
+    // VS Code는 최상위 키가 servers이고 로컬 서버 타입이 stdio다.
+    ...jsonAdapter('.vscode/mcp.json', 'servers', (s) =>
+      s.kind === 'http'
+        ? { type: 'http', url: s.url }
+        : { type: 'stdio', command: s.command, args: s.args }),
+  },
+}
+
+export const CLI_IDS = Object.keys(CLIS)

package/lib/context.mjs

@@ -1,65 +1,66 @@
-import { execFileSync } from 'node:child_process'
-import { lstatSync, realpathSync } from 'node:fs'
-import { dirname, resolve, sep } from 'node:path'
-
-export function findRepoRoot(cwd = process.cwd()) {
-  let out
-  try {
-    out = execFileSync('git', ['rev-parse', '--show-toplevel'], { cwd, encoding: 'utf8' })
-  } catch {
-    throw new Error('git 저장소 안에서 실행해야 합니다.')
-  }
-  return resolve(out.trim())
-}
-
-export function repoPath(root, rel) {
-  const abs = resolve(root, rel)
-  const normRoot = resolve(root)
-  if (abs !== normRoot && !abs.startsWith(normRoot + sep)) {
-    throw new Error(`저장소 밖의 경로에는 쓸 수 없습니다: ${abs}`)
-  }
-  return abs
-}
-
-function pathExists(target) {
-  try {
-    lstatSync(target)
-    return true
-  } catch {
-    return false
-  }
-}
-
-// repoPath의 어휘적 검사에 더해, 가장 가까운 존재하는 조상의 realpath가
-// 저장소 안인지 확인한다. 어휘적 검사만으로는 심볼릭 링크/Junction을 통한
-// 이탈을 막지 못한다. 부트스트랩의 모든 쓰기 경로가 이 함수를 쓴다.
-export function repoPathStrict(root, rel) {
-  const abs = repoPath(root, rel)
-
-  let probe = abs
-  while (!pathExists(probe)) {
-    const parent = dirname(probe)
-    if (parent === probe) break
-    probe = parent
-  }
-
-  let realProbe
-  try {
-    realProbe = realpathSync(probe)
-  } catch (err) {
-    // 경합으로 사라졌거나(ENOENT) 링크가 순환하는(ELOOP) 경우다.
-    // 원인을 알 수 없는 raw 예외 대신 진단 가능한 메시지로 바꾼다.
-    throw new Error(`경로를 확인할 수 없습니다: ${probe} (${err.code ?? err.message})`)
-  }
-
-  let realRoot
-  try {
-    realRoot = realpathSync(root)
-  } catch (err) {
-    throw new Error(`경로를 확인할 수 없습니다: ${root} (${err.code ?? err.message})`)
-  }
-  if (realProbe !== realRoot && !realProbe.startsWith(realRoot + sep)) {
-    throw new Error(`저장소 내부 경로가 외부 링크를 통해 이탈합니다: ${probe} -> ${realProbe}`)
-  }
-  return abs
-}
+import { execFileSync } from 'node:child_process'
+import { lstatSync, realpathSync } from 'node:fs'
+import { dirname, resolve, sep } from 'node:path'
+import { LocalizedError } from './i18n/index.mjs'
+
+export function findRepoRoot(cwd = process.cwd()) {
+  let out
+  try {
+    out = execFileSync('git', ['rev-parse', '--show-toplevel'], { cwd, encoding: 'utf8' })
+  } catch {
+    throw new LocalizedError('error.notGitRepo')
+  }
+  return resolve(out.trim())
+}
+
+export function repoPath(root, rel) {
+  const abs = resolve(root, rel)
+  const normRoot = resolve(root)
+  if (abs !== normRoot && !abs.startsWith(normRoot + sep)) {
+    throw new LocalizedError('error.pathOutsideRepo', { path: abs })
+  }
+  return abs
+}
+
+function pathExists(target) {
+  try {
+    lstatSync(target)
+    return true
+  } catch {
+    return false
+  }
+}
+
+// repoPath의 어휘적 검사에 더해, 가장 가까운 존재하는 조상의 realpath가
+// 저장소 안인지 확인한다. 어휘적 검사만으로는 심볼릭 링크/Junction을 통한
+// 이탈을 막지 못한다. 부트스트랩의 모든 쓰기 경로가 이 함수를 쓴다.
+export function repoPathStrict(root, rel) {
+  const abs = repoPath(root, rel)
+
+  let probe = abs
+  while (!pathExists(probe)) {
+    const parent = dirname(probe)
+    if (parent === probe) break
+    probe = parent
+  }
+
+  let realProbe
+  try {
+    realProbe = realpathSync(probe)
+  } catch (err) {
+    // 경합으로 사라졌거나(ENOENT) 링크가 순환하는(ELOOP) 경우다.
+    // 원인을 알 수 없는 raw 예외 대신 진단 가능한 메시지로 바꾼다.
+    throw new LocalizedError('error.pathUnresolvable', { path: probe, code: err.code ?? err.message })
+  }
+
+  let realRoot
+  try {
+    realRoot = realpathSync(root)
+  } catch (err) {
+    throw new LocalizedError('error.pathUnresolvable', { path: root, code: err.code ?? err.message })
+  }
+  if (realProbe !== realRoot && !realProbe.startsWith(realRoot + sep)) {
+    throw new LocalizedError('error.pathEscapesViaLink', { path: probe, real: realProbe })
+  }
+  return abs
+}

package/lib/deps.mjs

@@ -1,19 +1,17 @@
 // 선택적 의존성 로딩. 부트스트랩은 npm install 없이 돌아야 하므로
 // jsonc-parser·smol-toml에 닿는 모듈은 전부 동적 import로 가져오고,
 // 없을 때는 Node의 원시 메시지 대신 설치 방법을 안내한다.
+import { LocalizedError } from './i18n/index.mjs'
 
-export const DEPS_HINT =
-  '이 기능에는 의존성이 필요합니다. 다음 중 하나를 실행하세요:\n' +
-  '  ./setup-agents.sh --tui\n' +
-  '  npm install --prefix agent-installer'
-
-export async function withDeps(load) {
+// t는 현재 안내 문구가 쓰지 않지만 시그니처에 남겨 둔다 — 호출부가 이미
+// 넘기고 있고, 나중에 지역화된 안내가 늘어날 자리다.
+export async function withDeps(load, t) {
   try {
     return await load()
   } catch (err) {
     // 모듈이 정말 없을 때만 안내로 바꾼다. 로드된 모듈 안에서 난 오류는
     // 그대로 올려보내야 한다 — 삼키면 진짜 버그가 "의존성 없음"으로 둔갑한다.
     if (err.code !== 'ERR_MODULE_NOT_FOUND') throw err
-    throw new Error(DEPS_HINT)
+    throw new LocalizedError('error.depsMissing')
   }
 }

package/lib/design-md/cache/awesome-design-md/LICENSE.md

@@ -0,0 +1,38 @@
+# Third-party notice — awesome-design-md
+
+이 디렉터리의 `DESIGN.md` 파일들은 아래 저장소에서 그대로 가져온 사본입니다.
+오프라인 설치를 위해 동봉하며, 원문을 고치지 않습니다.
+
+- Source: https://github.com/VoltAgent/awesome-design-md
+- License: MIT
+
+MIT는 재배포를 허용하되 저작권 고지와 허가 문구를 사본에 함께 담을 것을
+요구합니다. 아래가 상류 `LICENSE`의 원문입니다.
+
+파일 이름이 `LICENSE`가 아니라 `LICENSE.md`인 이유는 발행물 검사가 최상위
+`LICENSE` 하나만 확장자 없는 파일로 허용하기 때문입니다 — 이름이 아니라
+담긴 내용이 고지의 요건을 채웁니다.
+
+---
+
+MIT License
+
+Copyright (c) 2026 VoltAgent
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.