@rch4com/agent-setup 1.1.0 → 1.4.0

package/lib/tui/rows.mjs

@@ -1,206 +1,278 @@
-// 부트스트랩·에이전트·design.md를 하나의 행 배열로 합친다.
-// 화면을 모른다 — 폭도 색도 커서도 여기서는 다루지 않는다.
-import { existsSync } from 'node:fs'
-import { join } from 'node:path'
-import { scan } from '../engine.mjs'
-import { loadItems } from '../catalog.mjs'
-import { runBootstrap } from '../bootstrap/flow.mjs'
-import { MANIFEST } from '../bootstrap/manifest.mjs'
-import { loadCatalog, buildItems, netFetch, CATALOG_PATH } from '../design-md/catalog.mjs'
-import { discoverSources, extraDirsFromEnv } from '../design-md/scan.mjs'
-import { refreshCatalog, updateInstalled, findStale } from '../design-md/flow.mjs'
-
-const AGENT_SECTION = { plugin: 'PLUGIN', mcp: 'MCP', skill: 'SKILL' }
-const STATUS_LABEL = { installed: '설치됨', partial: '일부 설치됨', absent: '미설치' }
-const DESIGN_STATUS = { installed: '설치됨', partial: '일부', absent: '미설치' }
-
-export const ACTION_SECTION = '작업'
-// scan.mjs의 BUNDLE_CATEGORY와 같은 값이다 — 카테고리를 못 얻은 항목이 모이는 자리.
-export const CATCH_ALL_CATEGORY = '기타'
-export const SECTION_ORDER = [ACTION_SECTION, 'PLUGIN', 'MCP', 'SKILL', 'DESIGN.MD']
-
-function short(text, n = 60) {
-  const t = (text ?? '').replace(/\s+/g, ' ').trim()
-  return t.length > n ? `${t.slice(0, n - 1)}…` : t
-}
-
-// 에이전트 항목 힌트 — 상태·설치 위치·미지원 CLI 사유까지 한 줄에 담는다.
-export function agentHint(item, state) {
-  const parts = []
-  if (state.status !== 'absent') parts.push(STATUS_LABEL[state.status])
-  if (state.detail) parts.push(state.detail)
-  if (item.scope === 'user') parts.push('설치 위치: 사용자 글로벌')
-  const un = Object.entries(item.unsupported ?? {})
-  if (item.category === 'mcp' && un.length > 0) {
-    parts.push(`미지원: ${un.map(([cli, why]) => `${cli}(${why})`).join(', ')}`)
-  }
-  if (item.supports?.length === 1 && item.supports[0] === 'claude') parts.push('Claude Code 전용')
-  if (item.note) parts.push(item.note)
-  return parts.join(' · ')
-}
-
-export function designHint(state, multiProvider = false) {
-  const parts = []
-  if (multiProvider) parts.push(state.item.providerId)
-  parts.push(state.item.designCategory)
-  if (state.status !== 'absent') parts.push(DESIGN_STATUS[state.status])
-  if (state.item.description) parts.push(short(state.item.description))
-  return parts.filter(Boolean).join(' · ')
-}
-
-// group = 탭 **안쪽**의 소분류 헤더. design.md만 76개라 카테고리로 갈라야 읽힌다.
-// 나머지 탭은 항목이 적어 그룹 없이 평평하게 둔다.
-function itemRow({ id, section, label, hint, status, previewTarget = null, item, extra = '', group = null }) {
-  return {
-    kind: 'item',
-    id,
-    section,
-    group,
-    label,
-    hint,
-    status,
-    previewTarget,
-    item,
-    searchText: `${label} ${hint} ${section} ${extra}`.toLowerCase(),
-  }
-}
-
-function actionRow({ id, label, hint, run }) {
-  return {
-    kind: 'action',
-    id,
-    section: ACTION_SECTION,
-    group: null,
-    label,
-    hint,
-    status: 'absent',
-    previewTarget: null,
-    run,
-    searchText: `${label} ${hint} ${ACTION_SECTION}`.toLowerCase(),
-  }
-}
-
-// 부트스트랩이 만들 파일 중 이미 있는 수 — 실행 전에 무엇이 남았는지 알려 준다.
-function bootstrapHint(root) {
-  const present = MANIFEST.files.filter((f) => existsSync(join(root, f.path))).length
-  return `지침 · 스킬 · 도구별 설정 · 파일 ${MANIFEST.files.length}개 중 ${present}개 존재`
-}
-
-export function buildActions(root, { designItems = [] } = {}) {
-  return [
-    actionRow({
-      id: 'action.bootstrap',
-      label: '부트스트랩 실행',
-      hint: bootstrapHint(root),
-      run: ({ dryRun, skillMode, log }) => runBootstrap(root, { dryRun, skillMode, log }),
-    }),
-    actionRow({
-      id: 'action.sync.installed',
-      label: '설치본 업데이트',
-      hint: 'design.md 설치본을 원본 최신으로 다시 받는다',
-      run: ({ dryRun, log }) => updateInstalled(root, designItems, { dryRun, log }),
-    }),
-    actionRow({
-      id: 'action.sync.catalog',
-      label: '카탈로그 새로고침',
-      hint: 'design.md 목록·카테고리를 소스에서 다시 만든다',
-      run: ({ dryRun, fetchImpl, log, catalogFile }) => refreshCatalog({ dryRun, fetchImpl, log, catalogFile }),
-    }),
-    actionRow({
-      id: 'action.sync.stale',
-      label: '오래된 항목 확인',
-      hint: '설치본을 원본과 해시 비교한다',
-      run: async ({ dryRun, log, confirm }) => {
-        const stale = await findStale(root, designItems, { log })
-        if (stale.length === 0) { log('모든 설치본이 최신입니다.'); return }
-        log(`오래된 항목 ${stale.length}개: ${stale.map((i) => i.name).join(', ')}`)
-        if (dryRun) return
-        if (!(await confirm(`${stale.length}개를 지금 업데이트할까요?`))) return
-        for (const item of stale) {
-          try {
-            await item.install({ root, dryRun, fresh: true })
-            log(`  ✔ 업데이트 ${item.label}`)
-          } catch (err) {
-            log(`  ✖ 업데이트 ${item.label} — ${err.message}`)
-          }
-        }
-      },
-    }),
-  ]
-}
-
-// 순수 조립 — 이미 스캔된 상태를 받아 행 배열을 만든다. 테스트는 여기를 겨눈다.
-export function buildRows({ actions = [], agentStates = [], designStates = [], multiProvider = false }) {
-  const agents = agentStates.map((s) =>
-    itemRow({
-      id: s.item.id,
-      section: AGENT_SECTION[s.item.category] ?? s.item.category.toUpperCase(),
-      label: s.item.label,
-      hint: agentHint(s.item, s),
-      status: s.status,
-      item: s.item,
-      extra: s.item.id,
-    }),
-  )
-
-  // 카테고리 → 라벨 순으로 정렬한다. 그룹 헤더는 인접한 같은 group을 하나로 묶으므로
-  // 정렬이 흐트러지면 같은 카테고리가 여러 번 쪼개져 나온다.
-  const designs = designStates
-    .map((s) =>
-      itemRow({
-        id: s.item.id,
-        section: 'DESIGN.MD',
-        group: s.item.designCategory || CATCH_ALL_CATEGORY,
-        label: s.item.label,
-        hint: designHint(s, multiProvider),
-        status: s.status,
-        previewTarget: s.item.webUrl ?? s.item.previewPath ?? null,
-        item: s.item,
-        extra: `${s.item.name} ${s.item.providerId}`,
-      }),
-    )
-    // 분류 못 한 항목을 모아 둔 '기타'는 맨 뒤로 보낸다 — catch-all이 목록 머리를 차지하면
-    // 실제 카테고리를 훑기 전에 잡동사니부터 읽게 된다.
-    .sort((a, b) =>
-      (a.group === CATCH_ALL_CATEGORY ? 1 : 0) - (b.group === CATCH_ALL_CATEGORY ? 1 : 0)
-      || a.group.localeCompare(b.group)
-      || a.label.localeCompare(b.label))
-
-  const rows = [...actions, ...agents, ...designs]
-  // 섹션 순서를 고정한다 — displayList가 인접한 같은 섹션을 하나로 묶기 때문이다.
-  return rows.sort((a, b) => SECTION_ORDER.indexOf(a.section) - SECTION_ORDER.indexOf(b.section))
-}
-
-// 스캔까지 포함한 수집. 적용·액션 실행 뒤 다시 부른다.
-export async function collectRows(root, opts = {}) {
-  const { fetchImpl = netFetch, designDirs = [], env = process.env, catalogFile = CATALOG_PATH, log = () => {} } = opts
-
-  const agentItems = await loadItems()
-  const catalog = loadCatalog(catalogFile)
-  const sources = opts.sources ?? discoverSources({
-    ...(opts.bundleDir ? { bundleDir: opts.bundleDir } : {}),
-    extraDirs: [...extraDirsFromEnv(env), ...designDirs],
-    log,
-  })
-  const designItems = buildItems(catalog, { fetchImpl, sources })
-
-  const [agentStates, designStates] = await Promise.all([scan(root, agentItems), scan(root, designItems)])
-  const multiProvider = new Set(designItems.map((i) => i.providerId)).size > 1
-
-  return {
-    rows: buildRows({
-      actions: buildActions(root, { designItems }),
-      agentStates,
-      designStates,
-      multiProvider,
-    }),
-    agentStates,
-    designStates,
-    designItems,
-  }
-}
-
-// 설치된 항목 = 시작 시 체크된 항목.
-export function installedIds(rows) {
-  return rows.filter((r) => r.kind === 'item' && r.status !== 'absent').map((r) => r.id)
-}
+// 부트스트랩·에이전트·design.md를 하나의 행 배열로 합친다.
+// 화면을 모른다 — 폭도 색도 커서도 여기서는 다루지 않는다.
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
+import { scan } from '../engine.mjs'
+import { loadItems } from '../catalog.mjs'
+import { CLI_IDS } from '../clis.mjs'
+import { runBootstrap } from '../bootstrap/flow.mjs'
+import { MANIFEST } from '../bootstrap/manifest.mjs'
+import { createT, toText } from '../i18n/index.mjs'
+import { loadCatalog, buildItems, netFetch, CATALOG_PATH } from '../design-md/catalog.mjs'
+import { discoverSources, extraDirsFromEnv } from '../design-md/scan.mjs'
+import { refreshCatalog, updateInstalled, findStale, categoryLabel } from '../design-md/flow.mjs'
+
+// 섹션은 탭 이름이자 정렬 키이자 state.tabs의 원소다. 표시 문자열을 그대로
+// 쓰면 번역하는 순간 정렬이 깨진다 — id를 두고 render.mjs가 표시할 때만
+// t로 바꾼다. 덕분에 state.mjs는 계속 아무것도 import 하지 않는다.
+export const ACTION_SECTION = 'action'
+// design-md/scan.mjs의 BUNDLE_CATEGORY와 같은 값이다 — 카테고리를 못 얻은
+// 항목이 모이는 자리. 두 값이 갈리면 같은 그룹이 두 개로 쪼개진다.
+export const CATCH_ALL_CATEGORY = '__other'
+export const SECTION_ORDER = [ACTION_SECTION, 'plugin', 'mcp', 'skill', 'design']
+
+// 탭 안쪽 소분류는 **성격**으로 가른다 — 같은 탭에 "무엇으로 설치되는가"가 같고
+// "무엇을 해 주는가"가 다른 항목이 섞여 있어서, 기구(plugin·mcp·skill)만으로는
+// 고를 때 비교가 되지 않는다. 표시 순서는 이 배열이 정한다.
+// `__`로 시작하는 id만 categoryLabel이 번역한다(design.md 카테고리와 같은 규칙).
+export const GROUP_ORDER = ['__token', '__context', '__style', '__flow', '__service']
+
+function groupRank(group) {
+  const i = GROUP_ORDER.indexOf(group)
+  // 그룹이 없거나 목록에 없는 항목은 맨 뒤로 — 헤더 없이 평평하게 붙는다.
+  return i === -1 ? GROUP_ORDER.length : i
+}
+
+function short(text, n = 60) {
+  const t = (text ?? '').replace(/\s+/g, ' ').trim()
+  return t.length > n ? `${t.slice(0, n - 1)}…` : t
+}
+
+// 검색어에 섹션의 두 로케일 라벨을 모두 넣는다 — 한국어 화면에서도 영어 탭
+// 이름(plugin 등)으로 찾을 수 있어야 한다. 두 라벨이 같으면(PLUGIN·MCP처럼
+// 번역하지 않는 값) 중복으로 넣지 않는다.
+const EN_T = createT('en')
+
+function sectionTerms(t, section) {
+  const here = t(`section.${section}`)
+  const base = EN_T(`section.${section}`)
+  return here === base ? `${section} ${base}` : `${section} ${base} ${here}`
+}
+
+// 에이전트 항목 힌트 — 상태·설치 위치·미지원 CLI 사유까지 한 줄에 담는다.
+// 미지원 CLI를 **같은 사유끼리 묶어** 한 줄로 만든다. 사유 하나가 CLI 아홉 개에
+// 그대로 반복되면 줄만 길어지고 "무엇이 왜 빠졌는가"는 오히려 묻힌다.
+// 사유가 둘 이상이면(ponytail처럼) 갈래가 그대로 보인다.
+export function unsupportedText(item, t) {
+  const entries = Object.entries(item.unsupported ?? {})
+  if (entries.length === 0) return null
+  const byReason = new Map()
+  for (const [cli, why] of entries) {
+    const text = toText(t, why)
+    if (!byReason.has(text)) byReason.set(text, [])
+    byReason.get(text).push(cli)
+  }
+  const groups = [...byReason].map(([why, clis]) => t('item.unsupportedGroup', { clis: clis.join('·'), why }))
+  return t('item.unsupportedList', { count: entries.length, groups: groups.join(' / ') })
+}
+
+// 에이전트 항목 힌트 — 상태·CLI 커버리지·설치 위치·미지원 사유까지 한 줄에 담는다.
+export function agentHint(item, state, t = createT('en')) {
+  const parts = []
+  if (state.status !== 'absent') parts.push(t(`status.${state.status}`))
+  // 커버리지는 상태 바로 뒤에 둔다. 힌트 끝은 좁은 터미널에서 잘려 나가는데,
+  // 하필 그때가 "이 항목이 내가 쓰는 CLI에서 되나"를 가장 알고 싶은 순간이다.
+  // 전부 지원할 때도 찍는다 — 표시가 없는 것과 "10/10"은 뜻이 다르다.
+  if (item.supports) parts.push(t('item.cliCoverage', { covered: item.supports.length, total: CLI_IDS.length }))
+  const detail = toText(t, state.detail)
+  if (detail) parts.push(detail)
+  if (item.scope === 'user') parts.push(t('item.location.user'))
+  // note는 이제 카탈로그 키다.
+  if (item.note) parts.push(t(item.note))
+  // 사유는 길어질 수 있어 맨 뒤에 둔다 — 앞의 커버리지가 이미 "빠진 게 있다"를
+  // 알려 주므로, 잘려도 존재 자체를 놓치지는 않는다.
+  const un = unsupportedText(item, t)
+  if (un) parts.push(un)
+  return parts.join(' · ')
+}
+
+export function designHint(state, multiProvider = false, t) {
+  const parts = []
+  if (multiProvider) parts.push(state.item.providerId)
+  // 카탈로그가 준 카테고리는 그대로, 우리가 만든 catch-all(__other·__local)만
+  // categoryLabel이 번역한다.
+  parts.push(categoryLabel(t, state.item.designCategory))
+  if (state.status !== 'absent') parts.push(t(`status.${state.status}`))
+  if (state.item.description) parts.push(short(state.item.description))
+  return parts.filter(Boolean).join(' · ')
+}
+
+// group = 탭 **안쪽**의 소분류 헤더. design.md만 76개라 카테고리로 갈라야 읽힌다.
+// 나머지 탭은 항목이 적어 그룹 없이 평평하게 둔다.
+function itemRow({ id, section, label, hint, status, previewTarget = null, item, extra = '', group = null, t = createT('en') }) {
+  return {
+    kind: 'item',
+    id,
+    section,
+    group,
+    label,
+    hint,
+    status,
+    previewTarget,
+    item,
+    searchText: `${label} ${hint} ${sectionTerms(t, section)} ${extra}`.toLowerCase(),
+  }
+}
+
+function actionRow({ id, label, hint, run = null, t = createT('en') }) {
+  return {
+    kind: 'action',
+    id,
+    section: ACTION_SECTION,
+    group: null,
+    label,
+    hint,
+    status: 'absent',
+    previewTarget: null,
+    run,
+    searchText: `${label} ${hint} ${sectionTerms(t, ACTION_SECTION)}`.toLowerCase(),
+  }
+}
+
+// 부트스트랩이 만들 파일 중 이미 있는 수 — 실행 전에 무엇이 남았는지 알려 준다.
+function bootstrapHint(root, t) {
+  const present = MANIFEST.files.filter((f) => existsSync(join(root, f.path))).length
+  return t('action.bootstrap.hint', { present, total: MANIFEST.files.length })
+}
+
+export function buildActions(root, { designItems = [], t = createT('en') } = {}) {
+  return [
+    // 맨 위 상주 행. 실행은 run.mjs가 특수 처리한다 — 화면을 벗어나지 않고
+    // 그 자리에서 t를 갈아끼워야 하므로 다른 액션과 흐름이 다르다(run은 null).
+    actionRow({
+      id: 'action.language',
+      label: t('action.language.label'),
+      hint: t('action.language.hint', { current: t(`locale.${t.locale}`) }),
+      t,
+    }),
+    actionRow({
+      id: 'action.bootstrap',
+      label: t('action.bootstrap.label'),
+      hint: bootstrapHint(root, t),
+      run: ({ dryRun, skillMode, log, t: rt }) => runBootstrap(root, { dryRun, skillMode, log, t: rt }),
+      t,
+    }),
+    actionRow({
+      id: 'action.sync.installed',
+      label: t('action.sync.installed.label'),
+      hint: t('action.sync.installed.hint'),
+      run: ({ dryRun, log, t: rt }) => updateInstalled(root, designItems, { dryRun, log, t: rt }),
+      t,
+    }),
+    actionRow({
+      id: 'action.sync.catalog',
+      label: t('action.sync.catalog.label'),
+      hint: t('action.sync.catalog.hint'),
+      run: ({ dryRun, fetchImpl, log, catalogFile, t: rt }) => refreshCatalog({ dryRun, fetchImpl, log, catalogFile, t: rt }),
+      t,
+    }),
+    actionRow({
+      id: 'action.sync.stale',
+      label: t('action.sync.stale.label'),
+      hint: t('action.sync.stale.hint'),
+      run: async ({ dryRun, log, confirm, t: rt }) => {
+        const stale = await findStale(root, designItems, { log, t: rt })
+        // 이 네 줄은 flow.mjs의 runSync(design --sync=stale)가 쓰는 문구와 같다 —
+        // 새 키를 만들지 않고 그 키(design.allCurrent 등)를 그대로 재사용한다.
+        if (stale.length === 0) { log(rt('design.allCurrent')); return }
+        log(rt('design.staleList', { count: stale.length, names: stale.map((i) => i.name).join(', ') }))
+        if (dryRun) return
+        if (!(await confirm(rt('design.staleConfirm', { count: stale.length })))) return
+        for (const item of stale) {
+          try {
+            await item.install({ root, dryRun, fresh: true })
+            log(rt('design.updated', { label: item.label }))
+          } catch (err) {
+            log(rt('design.updateFailed', { label: item.label, message: err.message }))
+          }
+        }
+      },
+      t,
+    }),
+  ]
+}
+
+// 순수 조립 — 이미 스캔된 상태를 받아 행 배열을 만든다. 테스트는 여기를 겨눈다.
+export function buildRows({ actions = [], agentStates = [], designStates = [], multiProvider = false, t = createT('en') }) {
+  const agents = agentStates
+    .map((s) =>
+      itemRow({
+        id: s.item.id,
+        section: s.item.category,
+        group: s.item.group ?? null,
+        label: s.item.label,
+        hint: agentHint(s.item, s, t),
+        status: s.status,
+        item: s.item,
+        extra: s.item.id,
+        t,
+      }),
+    )
+    // 성격 → 라벨 순. 헤더는 인접한 같은 group을 하나로 묶으므로, 정렬이
+    // 흐트러지면 같은 성격이 한 탭에서 여러 번 쪼개져 나온다(design과 같은 규칙).
+    .sort((a, b) => groupRank(a.group) - groupRank(b.group) || a.label.localeCompare(b.label))
+
+  // 카테고리 → 라벨 순으로 정렬한다. 그룹 헤더는 인접한 같은 group을 하나로 묶으므로
+  // 정렬이 흐트러지면 같은 카테고리가 여러 번 쪼개져 나온다.
+  const designs = designStates
+    .map((s) =>
+      itemRow({
+        id: s.item.id,
+        section: 'design',
+        group: s.item.designCategory || CATCH_ALL_CATEGORY,
+        label: s.item.label,
+        hint: designHint(s, multiProvider, t),
+        status: s.status,
+        previewTarget: s.item.webUrl ?? s.item.previewPath ?? null,
+        item: s.item,
+        extra: `${s.item.name} ${s.item.providerId}`,
+        t,
+      }),
+    )
+    // 분류 못 한 항목을 모아 둔 '기타'는 맨 뒤로 보낸다 — catch-all이 목록 머리를 차지하면
+    // 실제 카테고리를 훑기 전에 잡동사니부터 읽게 된다.
+    .sort((a, b) =>
+      (a.group === CATCH_ALL_CATEGORY ? 1 : 0) - (b.group === CATCH_ALL_CATEGORY ? 1 : 0)
+      || a.group.localeCompare(b.group)
+      || a.label.localeCompare(b.label))
+
+  const rows = [...actions, ...agents, ...designs]
+  // 섹션 순서를 고정한다 — displayList가 인접한 같은 섹션을 하나로 묶기 때문이다.
+  return rows.sort((a, b) => SECTION_ORDER.indexOf(a.section) - SECTION_ORDER.indexOf(b.section))
+}
+
+// 스캔까지 포함한 수집. 적용·액션 실행 뒤 다시 부른다.
+export async function collectRows(root, opts = {}) {
+  const { fetchImpl = netFetch, designDirs = [], env = process.env, catalogFile = CATALOG_PATH, log = () => {}, t = createT('en') } = opts
+
+  const agentItems = await loadItems()
+  const catalog = loadCatalog(catalogFile)
+  const sources = opts.sources ?? discoverSources({
+    ...(opts.bundleDir ? { bundleDir: opts.bundleDir } : {}),
+    extraDirs: [...extraDirsFromEnv(env), ...designDirs],
+    log,
+    t,
+  })
+  const designItems = buildItems(catalog, { fetchImpl, sources })
+
+  const [agentStates, designStates] = await Promise.all([scan(root, agentItems), scan(root, designItems)])
+  const multiProvider = new Set(designItems.map((i) => i.providerId)).size > 1
+
+  return {
+    rows: buildRows({
+      actions: buildActions(root, { designItems, t }),
+      agentStates,
+      designStates,
+      multiProvider,
+      t,
+    }),
+    agentStates,
+    designStates,
+    designItems,
+  }
+}
+
+// 설치된 항목 = 시작 시 체크된 항목.
+export function installedIds(rows) {
+  return rows.filter((r) => r.kind === 'item' && r.status !== 'absent').map((r) => r.id)
+}