@rch4com/agent-setup 1.10.0 → 1.10.1

package/lib/items/skill.gstack.mjs

@@ -1,54 +1,54 @@
-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, 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' }
-  },
-  async install({ root, dryRun, exec }) {
-    // clone·삭제가 일어나는 경로다. 어휘적 검사만으로는 .claude/skills가
-    // 저장소 밖을 가리키는 링크일 때를 막지 못한다(부트스트랩이 만드는
-    // .agents/skills Junction은 저장소 안이라 그대로 통과한다).
-    const dir = repoPathStrict(root, REL_DIR)
-    if (!existsSync(dir)) {
-      const clone = await 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 = await 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
-    await 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 { CLI_IDS } from '../clis.mjs'
+import { repoPath, repoPathStrict } from '../context.mjs'
+import { ensureGitignoreEntries } from '../gitignore.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' }
+  },
+  async install({ root, dryRun, exec }) {
+    // clone·삭제가 일어나는 경로다. 어휘적 검사만으로는 .claude/skills가
+    // 저장소 밖을 가리키는 링크일 때를 막지 못한다(부트스트랩이 만드는
+    // .agents/skills Junction은 저장소 안이라 그대로 통과한다).
+    const dir = repoPathStrict(root, REL_DIR)
+    if (!existsSync(dir)) {
+      const clone = await 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 = await 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
+    await exec('bash', [join(dir, 'bin', 'gstack-uninstall'), '--force'], { cwd: dir }) // 실패해도 디렉터리 삭제로 폴백
+    if (!dryRun && existsSync(dir)) rmSync(dir, { recursive: true, force: true })
+  },
+})

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

@@ -1,93 +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
-}
+// 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'))
+}