@rch4com/agent-setup 1.0.0 → 1.3.0

package/lib/design-md/flow.mjs

@@ -1,166 +1,181 @@
-import { scan, planChanges, apply } from '../engine.mjs'
-import { loadCatalog, saveCatalog, buildItems, allEntries, sha256, resolveTokens, netFetch, CATALOG_PATH } from './catalog.mjs'
-import { PROVIDERS } from './providers/index.mjs'
-import { discoverSources, extraDirsFromEnv } from './scan.mjs'
-import { makeOpener, openPreview } from './open.mjs'
-
-const STATUS_LABEL = { installed: '설치됨', partial: '일부', absent: '미설치' }
-
-function report(results, log) {
-  const ACTION = { install: '설치', complete: '보완', uninstall: '제거' }
-  for (const r of results) {
-    log(`  ${r.ok ? '✔' : '✖'} ${ACTION[r.action]} ${r.item.label}${r.message ? ` — ${r.message}` : ''}`)
-  }
-}
-
-// ── 비대화형/공용 코어 ─────────────────────────────────────────────
-
-function printList(states, log) {
-  const byProvider = new Map()
-  for (const s of states) {
-    if (!byProvider.has(s.item.providerId)) byProvider.set(s.item.providerId, [])
-    byProvider.get(s.item.providerId).push(s)
-  }
-  for (const [pid, group] of byProvider) {
-    log(`[${pid}${group[0].item.local ? ' · 로컬' : ''}]`)
-    for (const s of group) {
-      log(`  ${STATUS_LABEL[s.status].padEnd(4)} ${s.item.name} — ${s.item.label} [${s.item.designCategory}]`)
-    }
-  }
-}
-
-// 미리보기는 관대하게 해석한다: 알 수 없거나 중복된 토큰은 예외 없이 안내하고 건너뛴다.
-function openPreviews(items, tokensStr, opener, log) {
-  for (const tok of tokensStr.split(',').map((s) => s.trim()).filter(Boolean)) {
-    const slash = tok.indexOf('/')
-    const matches = slash >= 0
-      ? items.filter((i) => i.providerId === tok.slice(0, slash) && i.name === tok.slice(slash + 1))
-      : items.filter((i) => i.name === tok)
-    if (matches.length === 0) { log(`  알 수 없는 항목: ${tok}`); continue }
-    if (matches.length > 1) {
-      log(`  중복된 이름 '${tok}' — 제공자를 지정하세요: ${matches.map((m) => `${m.providerId}/${m.name}`).join(', ')}`)
-      continue
-    }
-    openPreview(opener, matches[0], log)
-  }
-}
-
-// 보이는 집합(visibleStates) 안에서만 diff/적용한다.
-async function applyVisible(root, visibleStates, selectedIds, { dryRun, log }) {
-  const changes = planChanges(visibleStates, selectedIds)
-  if (changes.length === 0) { log('변경할 항목이 없습니다.'); return [] }
-  const results = await apply(root, changes, { dryRun, log })
-  report(results, log)
-  return results
-}
-
-async function installedItems(root, items) {
-  const out = []
-  for (const item of items) {
-    if ((await item.detect({ root })).status === 'installed') out.push(item)
-  }
-  return out
-}
-
-export async function refreshCatalog({ dryRun, fetchImpl, log, catalogFile = CATALOG_PATH }) {
-  const next = { updatedAt: new Date().toISOString(), providers: {} }
-  for (const provider of PROVIDERS) {
-    try {
-      const entries = await provider.fetchCatalog(fetchImpl)
-      next.providers[provider.id] = { label: provider.label, entries }
-      log(`  ${provider.label}: ${entries.length}개`)
-    } catch (err) {
-      log(`  ${provider.label}: 실패 — ${err.message}`)
-    }
-  }
-  const total = allEntries(next).length
-  if (total === 0) { log('가져온 항목이 없어 카탈로그를 갱신하지 않습니다.'); return { total: 0 } }
-  if (!dryRun) saveCatalog(next, catalogFile)
-  log(dryRun ? `  [dry-run] ${total}개로 갱신 예정` : `카탈로그 갱신됨: ${total}개`)
-  return { total }
-}
-
-export async function updateInstalled(root, items, { dryRun, log }) {
-  const installed = await installedItems(root, items)
-  if (installed.length === 0) { log('설치된 design.md가 없습니다.'); return }
-  for (const item of installed) {
-    try {
-      await item.install({ root, dryRun, fresh: true })
-      log(`  ✔ 업데이트 ${item.label}`)
-    } catch (err) {
-      log(`  ✖ 업데이트 ${item.label} — ${err.message}`)
-    }
-  }
-}
-
-export async function findStale(root, items, { log }) {
-  const installed = await installedItems(root, items)
-  const stale = []
-  for (const item of installed) {
-    const local = item.localText({ root })
-    if (local == null) continue
-    let remote
-    try { remote = await item.remoteText() } catch { remote = null }
-    if (remote == null) { log(`  ? ${item.label}: 원본 확인 실패`); continue }
-    if (sha256(local) !== sha256(remote)) stale.push(item)
-  }
-  return stale
-}
-
-// ── 진입점 ────────────────────────────────────────────────────────
-
-export async function runDesign(root, opts = {}) {
-  const {
-    dryRun = false,
-    list = false,
-    set = null,
-    sync = null,
-    preview = null,
-    fetchImpl = netFetch,
-    log = console.log,
-    designDirs = [],
-    env = process.env,
-    catalogFile = CATALOG_PATH,
-  } = opts
-  const opener = opts.opener ?? makeOpener(dryRun, log)
-
-  const catalog = loadCatalog(catalogFile)
-  // 디렉터리 스캔이 먼저다 — 프로바이더 등록 없이도 사내 정의가 목록에 오른다.
-  const sources = opts.sources ?? discoverSources({
-    ...(opts.bundleDir ? { bundleDir: opts.bundleDir } : {}),
-    extraDirs: [...extraDirsFromEnv(env), ...designDirs],
-    log,
-  })
-  const items = buildItems(catalog, { fetchImpl, sources })
-
-  if (list) {
-    printList(await scan(root, items), log)
-    return
-  }
-  if (preview != null) {
-    openPreviews(items, preview, opener, log)
-    return
-  }
-  if (sync != null) {
-    await runSync(root, items, { op: sync, dryRun, fetchImpl, log, catalogFile })
-    return
-  }
-  if (set != null) {
-    const selected = new Set(resolveTokens(items, set).map((i) => i.id))
-    await applyVisible(root, await scan(root, items), selected, { dryRun, log })
-    return
-  }
-  printList(await scan(root, items), log)
-}
-
-async function runSync(root, items, { op: chosen, dryRun, fetchImpl, log, catalogFile }) {
-  if (chosen === 'catalog') { await refreshCatalog({ dryRun, fetchImpl, log, catalogFile }); return }
-  if (chosen === 'installed') { await updateInstalled(root, items, { dryRun, log }); return }
-  if (chosen === 'stale') {
-    const stale = await findStale(root, items, { log })
-    if (stale.length === 0) { log('모든 설치본이 최신입니다.'); return }
-    log(`오래된 항목 ${stale.length}개: ${stale.map((i) => i.name).join(', ')}`)
-    return
-  }
-  log(`알 수 없는 동기화 작업: ${chosen}`)
-}
+import { scan, planChanges, apply } from '../engine.mjs'
+import { loadCatalog, saveCatalog, buildItems, allEntries, sha256, resolveTokens, netFetch, CATALOG_PATH } from './catalog.mjs'
+import { PROVIDERS } from './providers/index.mjs'
+import { discoverSources, extraDirsFromEnv } from './scan.mjs'
+import { makeOpener, openPreview } from './open.mjs'
+import { createT, toText } from '../i18n/index.mjs'
+import { labelWidth, pad } from '../width.mjs'
+
+// design 항목의 detect는 installed/absent만 돌려준다(catalog.mjs) — partial은
+// 열을 넓히기만 하고 실제로 나오지 않는다.
+const DESIGN_STATUS_KEYS = ['status.installed', 'status.absent']
+
+// 카탈로그의 카테고리는 공급자가 준 영어 데이터라 번역하지 않는다.
+// 우리가 만든 catch-all(__other·__local)만 번역 대상이다.
+export function categoryLabel(t, id) {
+  return id.startsWith('__') ? t(`category.${id.slice(2)}`) : id
+}
+
+function report(results, log, t) {
+  for (const r of results) {
+    const message = toText(t, r.message)
+    log(`  ${r.ok ? '✔' : '✖'} ${t(`change.${r.action}`)} ${r.item.label}${message ? ` — ${message}` : ''}`)
+  }
+}
+
+// ── 비대화형/공용 코어 ─────────────────────────────────────────────
+
+function printList(states, log, t) {
+  const byProvider = new Map()
+  for (const s of states) {
+    if (!byProvider.has(s.item.providerId)) byProvider.set(s.item.providerId, [])
+    byProvider.get(s.item.providerId).push(s)
+  }
+  // 폭은 그 로케일의 실제 라벨에서 뽑는다. padEnd는 코드 유닛을 세어 한글이
+  // 밀리고, 상수로 박으면 영어('Not installed' 13칸)가 넘쳐 이름 열이 어긋난다.
+  const statusWidth = labelWidth(t, DESIGN_STATUS_KEYS)
+  for (const [pid, group] of byProvider) {
+    log(`[${pid}${group[0].item.local ? ` · ${t('design.localTag')}` : ''}]`)
+    for (const s of group) {
+      log(`  ${pad(t(`status.${s.status}`), statusWidth)} ${s.item.name} — ${s.item.label} [${categoryLabel(t, s.item.designCategory)}]`)
+    }
+  }
+}
+
+// 미리보기는 관대하게 해석한다: 알 수 없거나 중복된 토큰은 예외 없이 안내하고 건너뛴다.
+function openPreviews(items, tokensStr, opener, log, t) {
+  for (const tok of tokensStr.split(',').map((s) => s.trim()).filter(Boolean)) {
+    const slash = tok.indexOf('/')
+    const matches = slash >= 0
+      ? items.filter((i) => i.providerId === tok.slice(0, slash) && i.name === tok.slice(slash + 1))
+      : items.filter((i) => i.name === tok)
+    if (matches.length === 0) { log(t('design.unknownItem', { token: tok })); continue }
+    if (matches.length > 1) {
+      log(t('design.ambiguous', { token: tok, options: matches.map((m) => `${m.providerId}/${m.name}`).join(', ') }))
+      continue
+    }
+    openPreview(opener, matches[0], log, t)
+  }
+}
+
+// 보이는 집합(visibleStates) 안에서만 diff/적용한다.
+async function applyVisible(root, visibleStates, selectedIds, { dryRun, log, t }) {
+  const changes = planChanges(visibleStates, selectedIds)
+  if (changes.length === 0) { log(t('apply.noChanges')); return [] }
+  const results = await apply(root, changes, { dryRun, log, t })
+  report(results, log, t)
+  return results
+}
+
+async function installedItems(root, items) {
+  const out = []
+  for (const item of items) {
+    if ((await item.detect({ root })).status === 'installed') out.push(item)
+  }
+  return out
+}
+
+export async function refreshCatalog({ dryRun, fetchImpl, log, catalogFile = CATALOG_PATH, t = createT('en') }) {
+  const next = { updatedAt: new Date().toISOString(), providers: {} }
+  for (const provider of PROVIDERS) {
+    try {
+      const entries = await provider.fetchCatalog(fetchImpl)
+      next.providers[provider.id] = { label: provider.label, entries }
+      log(t('design.provider.count', { label: provider.label, count: entries.length }))
+    } catch (err) {
+      log(t('design.provider.failed', { label: provider.label, message: err.message }))
+    }
+  }
+  const total = allEntries(next).length
+  if (total === 0) { log(t('design.catalog.empty')); return { total: 0 } }
+  if (!dryRun) saveCatalog(next, catalogFile)
+  log(dryRun ? t('design.catalog.planned', { total }) : t('design.catalog.updated', { total }))
+  return { total }
+}
+
+export async function updateInstalled(root, items, { dryRun, log, t = createT('en') }) {
+  const installed = await installedItems(root, items)
+  if (installed.length === 0) { log(t('design.none')); return }
+  for (const item of installed) {
+    try {
+      await item.install({ root, dryRun, fresh: true })
+      log(t('design.updated', { label: item.label }))
+    } catch (err) {
+      log(t('design.updateFailed', { label: item.label, message: err.message }))
+    }
+  }
+}
+
+export async function findStale(root, items, { log, t = createT('en') }) {
+  const installed = await installedItems(root, items)
+  const stale = []
+  for (const item of installed) {
+    const local = item.localText({ root })
+    if (local == null) continue
+    let remote
+    try { remote = await item.remoteText() } catch { remote = null }
+    if (remote == null) { log(t('design.sourceCheckFailed', { label: item.label })); continue }
+    if (sha256(local) !== sha256(remote)) stale.push(item)
+  }
+  return stale
+}
+
+// ── 진입점 ────────────────────────────────────────────────────────
+
+export async function runDesign(root, opts = {}) {
+  const {
+    dryRun = false,
+    list = false,
+    set = null,
+    sync = null,
+    preview = null,
+    fetchImpl = netFetch,
+    log = console.log,
+    designDirs = [],
+    env = process.env,
+    catalogFile = CATALOG_PATH,
+    t = createT('en'),
+  } = opts
+  const opener = opts.opener ?? makeOpener(dryRun, log)
+
+  const catalog = loadCatalog(catalogFile)
+  // 디렉터리 스캔이 먼저다 — 프로바이더 등록 없이도 사내 정의가 목록에 오른다.
+  const sources = opts.sources ?? discoverSources({
+    ...(opts.bundleDir ? { bundleDir: opts.bundleDir } : {}),
+    extraDirs: [...extraDirsFromEnv(env), ...designDirs],
+    log,
+    t,
+  })
+  const items = buildItems(catalog, { fetchImpl, sources })
+
+  if (list) {
+    printList(await scan(root, items), log, t)
+    return
+  }
+  if (preview != null) {
+    openPreviews(items, preview, opener, log, t)
+    return
+  }
+  if (sync != null) {
+    await runSync(root, items, { op: sync, dryRun, fetchImpl, log, catalogFile, t })
+    return
+  }
+  if (set != null) {
+    const selected = new Set(resolveTokens(items, set).map((i) => i.id))
+    await applyVisible(root, await scan(root, items), selected, { dryRun, log, t })
+    return
+  }
+  printList(await scan(root, items), log, t)
+}
+
+async function runSync(root, items, { op: chosen, dryRun, fetchImpl, log, catalogFile, t }) {
+  if (chosen === 'catalog') { await refreshCatalog({ dryRun, fetchImpl, log, catalogFile, t }); return }
+  if (chosen === 'installed') { await updateInstalled(root, items, { dryRun, log, t }); return }
+  if (chosen === 'stale') {
+    const stale = await findStale(root, items, { log, t })
+    if (stale.length === 0) { log(t('design.allCurrent')); return }
+    log(t('design.staleList', { count: stale.length, names: stale.map((i) => i.name).join(', ') }))
+    return
+  }
+  log(t('design.unknownSync', { action: chosen }))
+}

package/lib/design-md/open.mjs

@@ -1,50 +1,51 @@
-import { execFileSync } from 'node:child_process'
-import { existsSync } from 'node:fs'
-
-// 미리보기 대상은 신뢰 경계 밖이다 — 이름이 원격 README 파싱이나 디렉터리
-// 스캔에서 온다. http(s) URL이거나 실제로 존재하는 로컬 경로일 때만 OS에
-// 넘긴다. `javascript:`처럼 스킴만 바꾼 대상이 기본 앱으로 열리지 않게 한다.
-export function isOpenableTarget(target) {
-  const text = String(target ?? '')
-  // eslint-disable-next-line no-control-regex
-  if (!text || /[\x00-\x1f\x7f]/.test(text)) return false
-  if (/^https?:\/\//i.test(text)) return true
-  return existsSync(text)
-}
-
-// OS 기본 브라우저/앱으로 target(URL 또는 파일)을 연다. 주입 가능(테스트 대체).
-export function makeOpener(dryRun, log = console.log) {
-  return (target) => {
-    if (dryRun) {
-      log(`  [dry-run] open ${target}`)
-      return { ok: true }
-    }
-    if (!isOpenableTarget(target)) return { ok: false, output: '열 수 있는 대상이 아닙니다' }
-    // Windows에서 `cmd /c start`를 쓰지 않는다 — Node는 셸 없이 cmd를 부를 때
-    // 공백 없는 인자를 quote하지 않고, cmd는 `&`·`|`를 명령 구분자로 읽는다.
-    // 그러면 이름에 섞인 `&`가 곧바로 명령 실행이 된다. rundll32는 셸을 거치지
-    // 않아 인자가 그대로 전달되고, URL과 로컬 파일을 모두 기본 앱으로 연다.
-    const [cmd, args] =
-      process.platform === 'win32' ? ['rundll32', ['url.dll,FileProtocolHandler', target]] :
-      process.platform === 'darwin' ? ['open', [target]] :
-      ['xdg-open', [target]]
-    try {
-      execFileSync(cmd, args, { stdio: 'ignore' })
-      return { ok: true }
-    } catch (err) {
-      return { ok: false, output: String(err.message) }
-    }
-  }
-}
-
-// 항목의 미리보기를 연다: 웹 URL이 있으면 그 페이지, 로컬 항목은 원본 파일을 기본 앱으로.
-export function openPreview(opener, item, log = console.log) {
-  const target = item.webUrl ?? item.previewPath ?? null
-  if (!target) {
-    log(`  ${item.label}: 미리보기 URL이 없습니다.`)
-    return { ok: false }
-  }
-  const r = opener(target)
-  if (!r.ok) log(`  ${item.label}: 열기 실패 — 직접 여세요: ${target}`)
-  return r
-}
+import { execFileSync } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { createT, msg } from '../i18n/index.mjs'
+
+// 미리보기 대상은 신뢰 경계 밖이다 — 이름이 원격 README 파싱이나 디렉터리
+// 스캔에서 온다. http(s) URL이거나 실제로 존재하는 로컬 경로일 때만 OS에
+// 넘긴다. `javascript:`처럼 스킴만 바꾼 대상이 기본 앱으로 열리지 않게 한다.
+export function isOpenableTarget(target) {
+  const text = String(target ?? '')
+  // eslint-disable-next-line no-control-regex
+  if (!text || /[\x00-\x1f\x7f]/.test(text)) return false
+  if (/^https?:\/\//i.test(text)) return true
+  return existsSync(text)
+}
+
+// OS 기본 브라우저/앱으로 target(URL 또는 파일)을 연다. 주입 가능(테스트 대체).
+export function makeOpener(dryRun, log = console.log) {
+  return (target) => {
+    if (dryRun) {
+      log(`  [dry-run] open ${target}`)
+      return { ok: true }
+    }
+    if (!isOpenableTarget(target)) return { ok: false, output: msg('design.notOpenable') }
+    // Windows에서 `cmd /c start`를 쓰지 않는다 — Node는 셸 없이 cmd를 부를 때
+    // 공백 없는 인자를 quote하지 않고, cmd는 `&`·`|`를 명령 구분자로 읽는다.
+    // 그러면 이름에 섞인 `&`가 곧바로 명령 실행이 된다. rundll32는 셸을 거치지
+    // 않아 인자가 그대로 전달되고, URL과 로컬 파일을 모두 기본 앱으로 연다.
+    const [cmd, args] =
+      process.platform === 'win32' ? ['rundll32', ['url.dll,FileProtocolHandler', target]] :
+      process.platform === 'darwin' ? ['open', [target]] :
+      ['xdg-open', [target]]
+    try {
+      execFileSync(cmd, args, { stdio: 'ignore' })
+      return { ok: true }
+    } catch (err) {
+      return { ok: false, output: String(err.message) }
+    }
+  }
+}
+
+// 항목의 미리보기를 연다: 웹 URL이 있으면 그 페이지, 로컬 항목은 원본 파일을 기본 앱으로.
+export function openPreview(opener, item, log = console.log, t = createT('en')) {
+  const target = item.webUrl ?? item.previewPath ?? null
+  if (!target) {
+    log(t('design.noPreviewUrl', { label: item.label }))
+    return { ok: false }
+  }
+  const r = opener(target)
+  if (!r.ok) log(t('design.openFailed', { label: item.label, target }))
+  return r
+}