@rch4com/agent-setup 1.0.0 → 1.1.0

package/README.md

@@ -1,49 +1,55 @@
-# agent-setup
-
-Claude Code, Codex, Gemini CLI, OpenCode, Kilo Code, Kiro, Kimi Code,
-Grok Build, Antigravity, GitHub Copilot CLI, VS Code Copilot을 **한 저장소에서
-함께** 쓰기 위한 저장소 범위 부트스트랩과 선택 항목 설치기입니다.
-
-공통 지침은 루트 `AGENTS.md` 하나, 공통 스킬은 `.agents/skills` 하나로 두고,
-도구별 설정 파일만 각 도구가 읽는 위치에 만듭니다.
-
-## 사용법
-
-Git 저장소 안에서 실행합니다.
-
-```bash
-# 배선 — 공통 지침·스킬·도구별 설정 파일을 만든다
-npx @rch4com/agent-setup bootstrap
-
-# 무엇이 만들어질지만 확인한다
-npx @rch4com/agent-setup bootstrap --dry-run
-
-# 플러그인·MCP·스킬·DESIGN.md를 골라 설치하는 대화형 화면
-npx @rch4com/agent-setup
-```
-
-설치하면 실행 명령은 `agent-setup`으로 짧아집니다. 이름에 스코프가 붙은 것은
-스코프 없는 `agent-setup`이 npm의 유사 이름 제한에 걸리기 때문입니다.
-
-## 안전 원칙
-
-- 반드시 Git 저장소 안에서만 실행되며, 저장소 루트 밖에는 쓰지 않습니다.
-- 홈 디렉터리의 글로벌 설정을 읽거나 수정하지 않습니다.
-- 기존 설정 파일을 덮어쓰지 않습니다.
-- 반복 실행할 수 있습니다.
-
-## 요구 사항
-
-Node.js 20 이상.
-
-## 문서
-
-생성되는 구조, 도구별 연결 방식, 설치 가능한 항목, DESIGN.md 라이브러리 등
-상세 문서는 GitHub에 있습니다.
-
-- [사용법과 생성 구조](https://github.com/rch4com/Agent-Setup/blob/main/AgentSetup-README.md)
-- [저장소](https://github.com/rch4com/Agent-Setup)
-
-## 라이선스
-
-MIT
+# agent-setup
+
+Claude Code, Codex, Gemini CLI, OpenCode, Kilo Code, Kiro, Kimi Code,
+Grok Build, Antigravity, GitHub Copilot CLI, VS Code Copilot을 **한 저장소에서
+함께** 쓰기 위한 저장소 범위 부트스트랩과 선택 항목 설치기입니다.
+
+공통 지침은 루트 `AGENTS.md` 하나, 공통 스킬은 `.agents/skills` 하나로 두고,
+도구별 설정 파일만 각 도구가 읽는 위치에 만듭니다.
+
+## 사용법
+
+Git 저장소 안에서 실행합니다.
+
+```bash
+# 배선 — 공통 지침·스킬·도구별 설정 파일을 만든다
+npx @rch4com/agent-setup bootstrap
+
+# 무엇이 만들어질지만 확인한다
+npx @rch4com/agent-setup bootstrap --dry-run
+
+# 플러그인·MCP·스킬·DESIGN.md를 골라 설치하는 대화형 화면
+npx @rch4com/agent-setup
+
+# 관리 파일을 최신 템플릿으로 갱신한다 (사용자가 고친 파일은 건드리지 않는다)
+npx @rch4com/agent-setup@latest update
+
+# 의도 / 실제 / 버전을 비교한다
+npx @rch4com/agent-setup status
+```
+
+설치하면 실행 명령은 `agent-setup`으로 짧아집니다. 이름에 스코프가 붙은 것은
+스코프 없는 `agent-setup`이 npm의 유사 이름 제한에 걸리기 때문입니다.
+
+## 안전 원칙
+
+- 반드시 Git 저장소 안에서만 실행되며, 저장소 루트 밖에는 쓰지 않습니다.
+- 홈 디렉터리의 글로벌 설정을 읽거나 수정하지 않습니다.
+- 기존 설정 파일을 덮어쓰지 않습니다.
+- 반복 실행할 수 있습니다.
+
+## 요구 사항
+
+Node.js 20 이상.
+
+## 문서
+
+생성되는 구조, 도구별 연결 방식, 설치 가능한 항목, DESIGN.md 라이브러리 등
+상세 문서는 GitHub에 있습니다.
+
+- [사용법과 생성 구조](https://github.com/rch4com/Agent-Setup/blob/main/AgentSetup-README.md)
+- [저장소](https://github.com/rch4com/Agent-Setup)
+
+## 라이선스
+
+MIT

package/install.mjs

@@ -1,83 +1,101 @@
-#!/usr/bin/env node
-import { findRepoRoot } from './lib/context.mjs'
-import { runBootstrap } from './lib/bootstrap/flow.mjs'
-import { withDeps } from './lib/deps.mjs'
-import {
-  BOOTSTRAP_USAGE, DESIGN_USAGE, ROOT_USAGE,
-  parseBootstrapArgs, parseDesignArgs, parseRootArgs,
-} from './lib/args.mjs'
-
-// 위 정적 import는 전부 의존성 없는 모듈이다 — 부트스트랩은 npm install 없이 돌아야 하고,
-// bootstrap.isolation.test.mjs가 이 불변식을 지킨다. lib/ 나머지는 동적 import로만 닿는다.
-
-const STATUS_LABEL = { installed: '설치됨', partial: '일부 설치됨', absent: '미설치' }
-const ACTION_LABEL = { install: '설치', complete: '보완 설치', uninstall: '제거' }
-
-// 대화형 화면은 TUI가 맡는다.
-async function openTui(root, { dryRun, skillMode, designDirs }) {
-  const { runTui } = await withDeps(() => import('./lib/tui/run.mjs'))
-  // skillMode는 화면 안의 '부트스트랩 실행' 작업이 쓴다. design 경로에서는
-  // 없으므로 undefined가 넘어가고 runTui의 기본값(auto)이 적용된다.
-  await runTui(root, { dryRun, skillMode, designDirs })
-}
-
-// --list / --set 전용 비대화형 경로.
-async function runClassic(root, { dryRun, listOnly, setArg }) {
-  const { loadItems } = await withDeps(() => import('./lib/catalog.mjs'))
-  const { scan, planChanges, apply } = await withDeps(() => import('./lib/engine.mjs'))
-  const items = await loadItems()
-  const states = await scan(root, items)
-
-  if (listOnly) {
-    for (const s of states) console.log(`${STATUS_LABEL[s.status].padEnd(7)} ${s.item.id} — ${s.item.label}${s.detail ? ` (${s.detail})` : ''}`)
-    return
-  }
-
-  const selectedIds = new Set(setArg.split(',').map((s) => s.trim()).filter(Boolean))
-  const known = new Set(items.map((i) => i.id))
-  for (const id of selectedIds) if (!known.has(id)) throw new Error(`알 수 없는 항목: ${id}`)
-
-  const changes = planChanges(states, selectedIds)
-  if (changes.length === 0) { console.log('변경할 항목이 없습니다.'); return }
-
-  const results = await apply(root, changes, { dryRun })
-  for (const r of results) {
-    console.log(`${r.ok ? '✔' : '✖'} ${ACTION_LABEL[r.action]} ${r.item.label}${r.message ? ` — ${r.message}` : ''}`)
-  }
-
-  const after = await scan(root, items)
-  console.log('\n최종 상태:')
-  for (const s of after) console.log(`  ${STATUS_LABEL[s.status].padEnd(7)} ${s.item.label}`)
-  console.log('\n설정 파일 변경 내용은 git diff로 확인할 수 있습니다.')
-  if (results.some((r) => !r.ok)) process.exitCode = 1
-}
-
-async function main() {
-  const argv = process.argv.slice(2)
-  const root = findRepoRoot()
-
-  if (argv[0] === 'bootstrap') {
-    const opts = parseBootstrapArgs(argv.slice(1))
-    if (opts.help) { console.log(BOOTSTRAP_USAGE); return }
-    const { failed } = runBootstrap(root, opts)
-    if (failed.length > 0) process.exitCode = 1
-    return
-  }
-
-  if (argv[0] === 'design') {
-    const opts = parseDesignArgs(argv.slice(1))
-    if (opts.help) { console.log(DESIGN_USAGE); return }
-    // 플래그 없는 `design`은 통합 화면을 연다 — DESIGN.MD 섹션이 그 안에 있다.
-    if (opts.interactive) return openTui(root, opts)
-    const { runDesign } = await withDeps(() => import('./lib/design-md/flow.mjs'))
-    await runDesign(root, opts)
-    return
-  }
-
-  const opts = parseRootArgs(argv)
-  if (opts.help) { console.log(ROOT_USAGE); return }
-  if (opts.interactive) return openTui(root, opts)
-  await runClassic(root, opts)
-}
-
-main().catch((err) => { console.error(err.message); process.exit(1) })
+#!/usr/bin/env node
+import { findRepoRoot } from './lib/context.mjs'
+import { runBootstrap } from './lib/bootstrap/flow.mjs'
+import { withDeps } from './lib/deps.mjs'
+import {
+  BOOTSTRAP_USAGE, DESIGN_USAGE, ROOT_USAGE, STATUS_USAGE, UPDATE_USAGE,
+  parseBootstrapArgs, parseDesignArgs, parseRootArgs, parseStatusArgs, parseUpdateArgs,
+} from './lib/args.mjs'
+
+// 위 정적 import는 전부 의존성 없는 모듈이다 — 부트스트랩은 npm install 없이 돌아야 하고,
+// bootstrap.isolation.test.mjs가 이 불변식을 지킨다. lib/ 나머지는 동적 import로만 닿는다.
+
+const STATUS_LABEL = { installed: '설치됨', partial: '일부 설치됨', absent: '미설치' }
+const ACTION_LABEL = { install: '설치', complete: '보완 설치', uninstall: '제거' }
+
+// 대화형 화면은 TUI가 맡는다.
+async function openTui(root, { dryRun, skillMode, designDirs }) {
+  const { runTui } = await withDeps(() => import('./lib/tui/run.mjs'))
+  // skillMode는 화면 안의 '부트스트랩 실행' 작업이 쓴다. design 경로에서는
+  // 없으므로 undefined가 넘어가고 runTui의 기본값(auto)이 적용된다.
+  await runTui(root, { dryRun, skillMode, designDirs })
+}
+
+// --list / --set 전용 비대화형 경로.
+async function runClassic(root, { dryRun, listOnly, setArg }) {
+  const { loadItems } = await withDeps(() => import('./lib/catalog.mjs'))
+  const { scan, planChanges, apply } = await withDeps(() => import('./lib/engine.mjs'))
+  const items = await loadItems()
+  const states = await scan(root, items)
+
+  if (listOnly) {
+    for (const s of states) console.log(`${STATUS_LABEL[s.status].padEnd(7)} ${s.item.id} — ${s.item.label}${s.detail ? ` (${s.detail})` : ''}`)
+    return
+  }
+
+  const selectedIds = new Set(setArg.split(',').map((s) => s.trim()).filter(Boolean))
+  const known = new Set(items.map((i) => i.id))
+  for (const id of selectedIds) if (!known.has(id)) throw new Error(`알 수 없는 항목: ${id}`)
+
+  const changes = planChanges(states, selectedIds)
+  if (changes.length === 0) { console.log('변경할 항목이 없습니다.'); return }
+
+  const results = await apply(root, changes, { dryRun })
+  for (const r of results) {
+    console.log(`${r.ok ? '✔' : '✖'} ${ACTION_LABEL[r.action]} ${r.item.label}${r.message ? ` — ${r.message}` : ''}`)
+  }
+
+  const after = await scan(root, items)
+  console.log('\n최종 상태:')
+  for (const s of after) console.log(`  ${STATUS_LABEL[s.status].padEnd(7)} ${s.item.label}`)
+  console.log('\n설정 파일 변경 내용은 git diff로 확인할 수 있습니다.')
+  if (results.some((r) => !r.ok)) process.exitCode = 1
+}
+
+async function main() {
+  const argv = process.argv.slice(2)
+  const root = findRepoRoot()
+
+  if (argv[0] === 'bootstrap') {
+    const opts = parseBootstrapArgs(argv.slice(1))
+    if (opts.help) { console.log(BOOTSTRAP_USAGE); return }
+    const { failed } = runBootstrap(root, opts)
+    if (failed.length > 0) process.exitCode = 1
+    return
+  }
+
+  if (argv[0] === 'update') {
+    const opts = parseUpdateArgs(argv.slice(1))
+    if (opts.help) { console.log(UPDATE_USAGE); return }
+    // 항목 수렴을 위해 스캔이 필요해 의존성 있는 모듈에 닿는다.
+    const { runUpdate } = await withDeps(() => import('./lib/update.mjs'))
+    await runUpdate(root, opts)
+    return
+  }
+
+  if (argv[0] === 'status') {
+    const opts = parseStatusArgs(argv.slice(1))
+    if (opts.help) { console.log(STATUS_USAGE); return }
+    // 항목 스캔이 필요해 의존성 있는 모듈에 닿는다.
+    const { runStatus } = await withDeps(() => import('./lib/status.mjs'))
+    await runStatus(root, opts)
+    return
+  }
+
+  if (argv[0] === 'design') {
+    const opts = parseDesignArgs(argv.slice(1))
+    if (opts.help) { console.log(DESIGN_USAGE); return }
+    // 플래그 없는 `design`은 통합 화면을 연다 — DESIGN.MD 섹션이 그 안에 있다.
+    if (opts.interactive) return openTui(root, opts)
+    const { runDesign } = await withDeps(() => import('./lib/design-md/flow.mjs'))
+    await runDesign(root, opts)
+    return
+  }
+
+  const opts = parseRootArgs(argv)
+  if (opts.help) { console.log(ROOT_USAGE); return }
+  if (opts.interactive) return openTui(root, opts)
+  await runClassic(root, opts)
+}
+
+main().catch((err) => { console.error(err.message); process.exit(1) })