@rch4com/agent-setup 1.8.0 → 1.10.0

package/lib/update.mjs

@@ -1,85 +1,85 @@
-// update 흐름 — 관리 파일을 최신 템플릿으로 옮기고 드리프트를 보고한다.
-//
-// 갱신 판정은 apply.mjs의 updateFiles·updateBlocks가 하고, 여기는 순서와
-// 보고, 그리고 기록 갱신만 담당한다. flow.mjs가 생성 쪽에서 하는 역할과 같다.
-import { execFileSync } from 'node:child_process'
-import { MANIFEST } from './bootstrap/manifest.mjs'
-import {
-  configureAdapterSafe, ensureIgnore, ensureJsonKeys, updateBlocks, updateFiles,
-} from './bootstrap/apply.mjs'
-import { RECORD_REL, managedKey, readRecord, toolVersion, writeRecord } from './bootstrap/record.mjs'
-import { LocalizedError, createT, toText } from './i18n/index.mjs'
-
-// git이 유일한 되돌리기 수단이다. 커밋되지 않은 변경 위에 덮어쓰면 사용자가
-// 잃은 것을 복구할 방법이 없다.
-function assertCleanWorktree(root) {
-  const out = execFileSync('git', ['-C', root, 'status', '--porcelain'], { encoding: 'utf8' })
-  if (out.trim()) {
-    throw new LocalizedError('error.forceNeedsCleanTree')
-  }
-}
-
-export async function runUpdate(root, opts = {}) {
-  const { dryRun = false, force = false, log = console.log, manifest = MANIFEST, t = createT('en') } = opts
-  const say = (message) => log(`[agent-setup] ${message}`)
-
-  const record = readRecord(root)
-  if (!record) {
-    throw new LocalizedError('error.noRecordForUpdate', { path: RECORD_REL })
-  }
-
-  if (force) assertCleanWorktree(root)
-
-  // 2단계에서는 버전 차이를 보고만 한다. 여기서 중단시키면 기존 사용자의
-  // 실행이 오류로 죽어 파괴적 변경이 된다. 엄격 검사는 apply와 함께 3단계다.
-  const running = toolVersion()
-  if (record.pinnedVersion && record.pinnedVersion !== running) {
-    say(t('update.versionMove', { pinned: record.pinnedVersion, running }))
-  }
-
-  const ctx = { dryRun, force, log: say, managed: record.managed, t }
-  const results = [
-    ...updateFiles(root, manifest.files, ctx),
-    ...updateBlocks(root, manifest.blocks, ctx),
-    // 키 보장과 gitignore 항목 추가는 원래 멱등이라 그대로 재실행한다.
-    ...ensureJsonKeys(root, manifest.settings ?? [], { dryRun, log: say, t }),
-    ...ensureIgnore(root, manifest.ignore, { dryRun, log: say, t }),
-  ]
-
-  // 어댑터는 링크가 끊겼을 수 있어 재검증한다. 항목별로 실패를 격리한다.
-  for (const entry of manifest.adapters) {
-    results.push(configureAdapterSafe(root, entry, {
-      dryRun, log: say, skillMode: record.skillMode, t,
-    }))
-  }
-
-  // 성공한 것만 기록에 옮긴다. 드리프트는 hash를 담지 않으므로 옛 해시가
-  // 남아, 사용자가 원복하면 다음 update가 다시 집어간다.
-  const managed = { ...record.managed }
-  for (const r of results) {
-    if (!r.hash) continue
-    const isBlock = manifest.blocks.some((b) => b.path === r.path)
-    managed[managedKey(r.path, isBlock)] = r.hash
-  }
-
-  const drift = results.filter((r) => r.action === 'drift')
-  const updated = results.filter((r) => r.action === 'update')
-  const created = results.filter((r) => r.action === 'create')
-
-  if (!dryRun) writeRecord(root, { ...record, managed }, { dryRun, log: say, t })
-
-  log('')
-  say(t('update.summary', { updated: updated.length, created: created.length, drift: drift.length }))
-  if (drift.length > 0) {
-    say(t('update.driftHeader'))
-    // 결과 message는 구조화 메시지(msg())다. 문자열 삽입 자리에 그대로
-    // 꽂으면 "[object Object]"가 찍히므로 toText로 활성 로케일에 맞춰 푼다.
-    for (const d of drift) {
-      const drifted = toText(t, d.message)
-      say(`  ${d.path}${drifted ? ` — ${drifted}` : ''}`)
-    }
-    say(t('update.driftHint'))
-  }
-
-  return { results, drift, record: { ...record, managed } }
-}
+// update 흐름 — 관리 파일을 최신 템플릿으로 옮기고 드리프트를 보고한다.
+//
+// 갱신 판정은 apply.mjs의 updateFiles·updateBlocks가 하고, 여기는 순서와
+// 보고, 그리고 기록 갱신만 담당한다. flow.mjs가 생성 쪽에서 하는 역할과 같다.
+import { execFileSync } from 'node:child_process'
+import { MANIFEST } from './bootstrap/manifest.mjs'
+import {
+  configureAdapterSafe, ensureIgnore, ensureJsonKeys, updateBlocks, updateFiles,
+} from './bootstrap/apply.mjs'
+import { RECORD_REL, managedKey, readRecord, toolVersion, writeRecord } from './bootstrap/record.mjs'
+import { LocalizedError, createT, toText } from './i18n/index.mjs'
+
+// git이 유일한 되돌리기 수단이다. 커밋되지 않은 변경 위에 덮어쓰면 사용자가
+// 잃은 것을 복구할 방법이 없다.
+function assertCleanWorktree(root) {
+  const out = execFileSync('git', ['-C', root, 'status', '--porcelain'], { encoding: 'utf8' })
+  if (out.trim()) {
+    throw new LocalizedError('error.forceNeedsCleanTree')
+  }
+}
+
+export async function runUpdate(root, opts = {}) {
+  const { dryRun = false, force = false, log = console.log, manifest = MANIFEST, t = createT('en') } = opts
+  const say = (message) => log(`[agent-setup] ${message}`)
+
+  const record = readRecord(root)
+  if (!record) {
+    throw new LocalizedError('error.noRecordForUpdate', { path: RECORD_REL })
+  }
+
+  if (force) assertCleanWorktree(root)
+
+  // 2단계에서는 버전 차이를 보고만 한다. 여기서 중단시키면 기존 사용자의
+  // 실행이 오류로 죽어 파괴적 변경이 된다. 엄격 검사는 apply와 함께 3단계다.
+  const running = toolVersion()
+  if (record.pinnedVersion && record.pinnedVersion !== running) {
+    say(t('update.versionMove', { pinned: record.pinnedVersion, running }))
+  }
+
+  const ctx = { dryRun, force, log: say, managed: record.managed, t }
+  const results = [
+    ...updateFiles(root, manifest.files, ctx),
+    ...updateBlocks(root, manifest.blocks, ctx),
+    // 키 보장과 gitignore 항목 추가는 원래 멱등이라 그대로 재실행한다.
+    ...ensureJsonKeys(root, manifest.settings ?? [], { dryRun, log: say, t }),
+    ...ensureIgnore(root, manifest.ignore, { dryRun, log: say, t }),
+  ]
+
+  // 어댑터는 링크가 끊겼을 수 있어 재검증한다. 항목별로 실패를 격리한다.
+  for (const entry of manifest.adapters) {
+    results.push(configureAdapterSafe(root, entry, {
+      dryRun, log: say, skillMode: record.skillMode, t,
+    }))
+  }
+
+  // 성공한 것만 기록에 옮긴다. 드리프트는 hash를 담지 않으므로 옛 해시가
+  // 남아, 사용자가 원복하면 다음 update가 다시 집어간다.
+  const managed = { ...record.managed }
+  for (const r of results) {
+    if (!r.hash) continue
+    const isBlock = manifest.blocks.some((b) => b.path === r.path)
+    managed[managedKey(r.path, isBlock)] = r.hash
+  }
+
+  const drift = results.filter((r) => r.action === 'drift')
+  const updated = results.filter((r) => r.action === 'update')
+  const created = results.filter((r) => r.action === 'create')
+
+  if (!dryRun) writeRecord(root, { ...record, managed }, { dryRun, log: say, t })
+
+  log('')
+  say(t('update.summary', { updated: updated.length, created: created.length, drift: drift.length }))
+  if (drift.length > 0) {
+    say(t('update.driftHeader'))
+    // 결과 message는 구조화 메시지(msg())다. 문자열 삽입 자리에 그대로
+    // 꽂으면 "[object Object]"가 찍히므로 toText로 활성 로케일에 맞춰 푼다.
+    for (const d of drift) {
+      const drifted = toText(t, d.message)
+      say(`  ${d.path}${drifted ? ` — ${drifted}` : ''}`)
+    }
+    say(t('update.driftHint'))
+  }
+
+  return { results, drift, record: { ...record, managed } }
+}

package/lib/width.mjs

@@ -1,115 +1,115 @@
-// 터미널 표시 폭 계산. TUI 화면과 비대화형 목록이 함께 쓴다.
-//
-// 아무것도 import 하지 않는다 — install.mjs가 정적으로 끌어오므로
-// bootstrap.isolation.test.mjs가 이 파일까지 의존성 0을 요구한다. 그리고
-// design-md/flow.mjs도 여기에 닿는데, 이 함수들이 tui/render.mjs에 남아
-// 있으면 render → flow → render 순환 import가 된다.
-//
-// String.padEnd는 코드 유닛을 센다. 한글 한 글자가 두 칸을 차지하는 터미널에서
-// padEnd로 열을 맞추면 로케일이 바뀔 때마다 열이 어긋난다 — 그래서 폭 계산은
-// 화면이든 목록이든 전부 이 모듈을 거친다.
-
-// 동아시아 글자는 터미널에서 두 칸을 차지한다. 전체 wcwidth 표 대신
-// 실제로 쓰이는 구간(한글·한자·가나·전각)만 넓게 센다.
-function charWidth(cp) {
-  return (cp >= 0x1100 && cp <= 0x115f) // 한글 자모
-    || (cp >= 0x2e80 && cp <= 0xa4cf) // 한자 부수·가나·한자
-    || (cp >= 0xac00 && cp <= 0xd7a3) // 한글 음절
-    || (cp >= 0xf900 && cp <= 0xfaff) // 한자 호환
-    || (cp >= 0xfe30 && cp <= 0xfe6f) // 전각 형태
-    || (cp >= 0xff00 && cp <= 0xff60) // 전각 영숫자
-    || (cp >= 0xffe0 && cp <= 0xffe6)
-    ? 2 : 1
-}
-
-export function width(text) {
-  let w = 0
-  for (const ch of String(text ?? '')) w += charWidth(ch.codePointAt(0))
-  return w
-}
-
-// 색 코드는 폭에 포함되면 안 되므로, 자르기는 항상 색을 입히기 **전에** 한다.
-export function cut(text, limit) {
-  if (limit <= 0) return ''
-  const s = String(text ?? '')
-  if (width(s) <= limit) return s
-  let out = ''
-  let w = 0
-  for (const ch of s) {
-    const cw = charWidth(ch.codePointAt(0))
-    if (w + cw > limit - 1) break
-    out += ch
-    w += cw
-  }
-  return `${out}…`
-}
-
-export function pad(text, limit) {
-  const s = cut(text, limit)
-  return s + ' '.repeat(Math.max(0, limit - width(s)))
-}
-
-// 접기. cut은 넘치는 글을 버리고 pad는 모자란 폭을 채우지만, 상세 패널과
-// 진행 화면은 넘치는 글을 다음 줄로 이어 가야 한다.
-//
-// 공백이 있으면 마지막 공백에서 끊고(영문), 한 낱말이 limit보다 길거나
-// 공백이 없으면(한글) 표시 폭에서 끊는다. limit이 0 이하면 빈 배열을
-// 돌려준다 — 호출부가 폭을 잘못 계산했을 때 무한 루프에 빠지지 않게 한다.
-//
-// 문자 하나의 표시 폭이 limit보다 넓으면 그 문자를 버린다. limit < 2에서는
-// 폭을 지키면서 동시에 모든 문자를 담을 수 없다. 폭을 넘기면 TUI 레이아웃이
-// 무너지지만, 버리면 내용만 손실된다. 따라서 폭 불변식을 택했다.
-export function wrap(text, limit) {
-  const s = String(text ?? '')
-  if (limit <= 0 || s === '') return []
-  const out = []
-  for (const para of s.split('\n')) {
-    let line = ''
-    let w = 0
-    let breakAt = -1 // line 안에서 마지막으로 본 공백의 위치
-    for (const ch of para) {
-      const cw = charWidth(ch.codePointAt(0))
-      // 공백을 먼저 기록한다. 이렇게 해야 가장 최근의 공백을 추적할 수 있다.
-      // 뒤에 아직 추가될 문자들이 있어도, 그 공백이 overflow가 되지 않으면
-      // breakAt으로 유지되고, 되면 그 공백에서 끊을 준비가 된다.
-      if (ch === ' ') breakAt = line.length
-      if (w + cw > limit) {
-        // Overflow: line이 limit을 초과할 것이다.
-        if (breakAt > 0) {
-          // 이전에 공백을 본 적이 있다. 그 공백에서 끊는다.
-          out.push(line.slice(0, breakAt))
-          line = line.slice(breakAt + 1)
-        } else {
-          // 공백이 없다. 현재 line을 그대로 끊는다.
-          // 단, 현재 line이 비어있으면 빈 항목을 만들지 않는다.
-          if (line) out.push(line)
-          line = ''
-        }
-        w = width(line)
-        breakAt = -1
-        // Overflow를 유발한 공백은 버린다. 그 공백은 이미 line을 초과시켰으므로
-        // 다음 줄에 포함하면 불필요한 공백이 앞에 붙는다.
-        if (ch === ' ') continue
-      }
-      // Overflow가 아니라면, 또는 처리 후라면, 문자를 추가한다.
-      // 단, 현재 line이 비어있는데 그 문자 자체가 limit보다 넓으면 건너뛴다.
-      // 호출부가 폭을 잘못 계산해도 이 함수가 limit을 지키기 위함이다.
-      if (w === 0 && cw > limit) {
-        continue
-      }
-      line += ch
-      w += cw
-    }
-    // 이번 문단을 끝낸다. 문단이 비어있거나 line이 비어있지 않으면 추가한다.
-    // 이렇게 해서 "접힘 자리의 공백 때문에 빈 줄이 생기는" 문제를 피한다.
-    if (line || para === '') out.push(line)
-  }
-  return out
-}
-
-// 상태 라벨은 로케일마다 길이가 다르다(영어 'Not installed' 13, 한국어
-// '미설치' 6). 한 번 재어 상수로 박으면 다른 로케일에서 열이 깨지므로,
-// 화면을 그릴 때 그 로케일의 실제 라벨에서 폭을 뽑는다.
-export function labelWidth(t, keys) {
-  return Math.max(...keys.map((key) => width(t(key))))
-}
+// 터미널 표시 폭 계산. TUI 화면과 비대화형 목록이 함께 쓴다.
+//
+// 아무것도 import 하지 않는다 — install.mjs가 정적으로 끌어오므로
+// bootstrap.isolation.test.mjs가 이 파일까지 의존성 0을 요구한다. 그리고
+// design-md/flow.mjs도 여기에 닿는데, 이 함수들이 tui/render.mjs에 남아
+// 있으면 render → flow → render 순환 import가 된다.
+//
+// String.padEnd는 코드 유닛을 센다. 한글 한 글자가 두 칸을 차지하는 터미널에서
+// padEnd로 열을 맞추면 로케일이 바뀔 때마다 열이 어긋난다 — 그래서 폭 계산은
+// 화면이든 목록이든 전부 이 모듈을 거친다.
+
+// 동아시아 글자는 터미널에서 두 칸을 차지한다. 전체 wcwidth 표 대신
+// 실제로 쓰이는 구간(한글·한자·가나·전각)만 넓게 센다.
+function charWidth(cp) {
+  return (cp >= 0x1100 && cp <= 0x115f) // 한글 자모
+    || (cp >= 0x2e80 && cp <= 0xa4cf) // 한자 부수·가나·한자
+    || (cp >= 0xac00 && cp <= 0xd7a3) // 한글 음절
+    || (cp >= 0xf900 && cp <= 0xfaff) // 한자 호환
+    || (cp >= 0xfe30 && cp <= 0xfe6f) // 전각 형태
+    || (cp >= 0xff00 && cp <= 0xff60) // 전각 영숫자
+    || (cp >= 0xffe0 && cp <= 0xffe6)
+    ? 2 : 1
+}
+
+export function width(text) {
+  let w = 0
+  for (const ch of String(text ?? '')) w += charWidth(ch.codePointAt(0))
+  return w
+}
+
+// 색 코드는 폭에 포함되면 안 되므로, 자르기는 항상 색을 입히기 **전에** 한다.
+export function cut(text, limit) {
+  if (limit <= 0) return ''
+  const s = String(text ?? '')
+  if (width(s) <= limit) return s
+  let out = ''
+  let w = 0
+  for (const ch of s) {
+    const cw = charWidth(ch.codePointAt(0))
+    if (w + cw > limit - 1) break
+    out += ch
+    w += cw
+  }
+  return `${out}…`
+}
+
+export function pad(text, limit) {
+  const s = cut(text, limit)
+  return s + ' '.repeat(Math.max(0, limit - width(s)))
+}
+
+// 접기. cut은 넘치는 글을 버리고 pad는 모자란 폭을 채우지만, 상세 패널과
+// 진행 화면은 넘치는 글을 다음 줄로 이어 가야 한다.
+//
+// 공백이 있으면 마지막 공백에서 끊고(영문), 한 낱말이 limit보다 길거나
+// 공백이 없으면(한글) 표시 폭에서 끊는다. limit이 0 이하면 빈 배열을
+// 돌려준다 — 호출부가 폭을 잘못 계산했을 때 무한 루프에 빠지지 않게 한다.
+//
+// 문자 하나의 표시 폭이 limit보다 넓으면 그 문자를 버린다. limit < 2에서는
+// 폭을 지키면서 동시에 모든 문자를 담을 수 없다. 폭을 넘기면 TUI 레이아웃이
+// 무너지지만, 버리면 내용만 손실된다. 따라서 폭 불변식을 택했다.
+export function wrap(text, limit) {
+  const s = String(text ?? '')
+  if (limit <= 0 || s === '') return []
+  const out = []
+  for (const para of s.split('\n')) {
+    let line = ''
+    let w = 0
+    let breakAt = -1 // line 안에서 마지막으로 본 공백의 위치
+    for (const ch of para) {
+      const cw = charWidth(ch.codePointAt(0))
+      // 공백을 먼저 기록한다. 이렇게 해야 가장 최근의 공백을 추적할 수 있다.
+      // 뒤에 아직 추가될 문자들이 있어도, 그 공백이 overflow가 되지 않으면
+      // breakAt으로 유지되고, 되면 그 공백에서 끊을 준비가 된다.
+      if (ch === ' ') breakAt = line.length
+      if (w + cw > limit) {
+        // Overflow: line이 limit을 초과할 것이다.
+        if (breakAt > 0) {
+          // 이전에 공백을 본 적이 있다. 그 공백에서 끊는다.
+          out.push(line.slice(0, breakAt))
+          line = line.slice(breakAt + 1)
+        } else {
+          // 공백이 없다. 현재 line을 그대로 끊는다.
+          // 단, 현재 line이 비어있으면 빈 항목을 만들지 않는다.
+          if (line) out.push(line)
+          line = ''
+        }
+        w = width(line)
+        breakAt = -1
+        // Overflow를 유발한 공백은 버린다. 그 공백은 이미 line을 초과시켰으므로
+        // 다음 줄에 포함하면 불필요한 공백이 앞에 붙는다.
+        if (ch === ' ') continue
+      }
+      // Overflow가 아니라면, 또는 처리 후라면, 문자를 추가한다.
+      // 단, 현재 line이 비어있는데 그 문자 자체가 limit보다 넓으면 건너뛴다.
+      // 호출부가 폭을 잘못 계산해도 이 함수가 limit을 지키기 위함이다.
+      if (w === 0 && cw > limit) {
+        continue
+      }
+      line += ch
+      w += cw
+    }
+    // 이번 문단을 끝낸다. 문단이 비어있거나 line이 비어있지 않으면 추가한다.
+    // 이렇게 해서 "접힘 자리의 공백 때문에 빈 줄이 생기는" 문제를 피한다.
+    if (line || para === '') out.push(line)
+  }
+  return out
+}
+
+// 상태 라벨은 로케일마다 길이가 다르다(영어 'Not installed' 13, 한국어
+// '미설치' 6). 한 번 재어 상수로 박으면 다른 로케일에서 열이 깨지므로,
+// 화면을 그릴 때 그 로케일의 실제 라벨에서 폭을 뽑는다.
+export function labelWidth(t, keys) {
+  return Math.max(...keys.map((key) => width(t(key))))
+}

package/package.json

@@ -1,36 +1,36 @@
-{
-  "name": "@rch4com/agent-setup",
-  "version": "1.8.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",
-    "mcp",
-    "agent-skills"
-  ],
-  "homepage": "https://github.com/rch4com/Agent-Setup#readme",
-  "bugs": "https://github.com/rch4com/Agent-Setup/issues",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/rch4com/Agent-Setup.git",
-    "directory": "agent-installer"
-  },
-  "license": "MIT",
-  "type": "module",
-  "engines": { "node": ">=20" },
-  "bin": { "agent-setup": "install.mjs" },
-  "files": ["install.mjs", "lib/", "README.md", "LICENSE"],
-  "publishConfig": { "access": "public" },
-  "scripts": {
-    "start": "node install.mjs",
-    "test": "node --test",
-    "refresh-bundle": "node scripts/refresh-bundle.mjs"
-  },
-  "dependencies": {
-    "jsonc-parser": "^3.3.1",
-    "smol-toml": "^1.3.1"
-  }
-}
+{
+  "name": "@rch4com/agent-setup",
+  "version": "1.10.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",
+    "mcp",
+    "agent-skills"
+  ],
+  "homepage": "https://github.com/rch4com/Agent-Setup#readme",
+  "bugs": "https://github.com/rch4com/Agent-Setup/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rch4com/Agent-Setup.git",
+    "directory": "agent-installer"
+  },
+  "license": "MIT",
+  "type": "module",
+  "engines": { "node": ">=20" },
+  "bin": { "agent-setup": "install.mjs" },
+  "files": ["install.mjs", "lib/", "README.md", "LICENSE"],
+  "publishConfig": { "access": "public" },
+  "scripts": {
+    "start": "node install.mjs",
+    "test": "node --test",
+    "refresh-bundle": "node scripts/refresh-bundle.mjs"
+  },
+  "dependencies": {
+    "jsonc-parser": "^3.3.1",
+    "smol-toml": "^1.3.1"
+  }
+}