@rch4com/agent-setup 1.10.0 → 1.10.1

package/lib/tui/detail.mjs

@@ -1,127 +1,127 @@
-// 상세 패널 — 커서가 놓인 항목의 전문을 여러 줄로 편다.
-// 순수 함수 모듈이다. 색도 커서도 터미널도 모른다 — render.mjs가 배치하고 칠한다.
-//
-// rows.mjs를 import 하지 않는 것이 규칙이다. render.mjs가 이 모듈을 쓰므로,
-// 여기서 rows를 끌어오면 render → detail → rows 방향이 생겨 rows.mjs가 순수
-// 렌더 층의 의존성이 된다. 그래서 사유 그룹핑이 rows가 아니라 여기 있고,
-// rows.mjs가 반대로 여기서 가져다 쓴다.
-import { toText, createT } from '../i18n/index.mjs'
-import { CLIS } from '../clis.mjs'
-import { categoryLabel } from '../design-md/flow.mjs'
-import { cut, labelWidth, pad, width, wrap } from '../width.mjs'
-
-// 미배선 사유를 **같은 사유끼리** 묶는다. 사유 하나가 CLI 아홉 개에 그대로
-// 반복되면 줄만 길어지고 "무엇이 왜 빠졌는가"는 오히려 묻힌다.
-// 사유가 둘 이상이면(ponytail처럼) 갈래가 그대로 보인다.
-export function unsupportedGroups(item, t) {
-  const entries = Object.entries(item?.unsupported ?? {})
-  if (entries.length === 0) return []
-  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)
-  }
-  return [...byReason].map(([why, clis]) => ({ clis, why }))
-}
-
-// 왼쪽 라벨 열('배선'·'미배선'·'출처'·'미리보기'·'대상 파일')의 폭. 로케일마다
-// 길이가 달라 상수로 박으면 열이 어긋나므로 그 로케일의 실제 라벨에서 뽑는다.
-//
-// **이 열에 놓이는 라벨을 하나도 빠뜨리면 안 된다.** 예전에는 배선·미배선만
-// 재서, 한국어의 '미리보기'(8칸)가 폭 7의 열에 들어가 '미리…'로 잘렸다 —
-// pad는 넘치는 글을 cut으로 버리기 때문에 조용히 사라진다.
-const LEAD_KEYS = ['detail.wired', 'detail.unwired', 'detail.provider', 'detail.preview', 'detail.target']
-
-function leadWidth(t) {
-  return labelWidth(t, LEAD_KEYS) + 1
-}
-
-function headLine(row, w, t) {
-  const item = row.item
-  // item.scope는 오늘 모든 항목 종류가 채운다 — 그래도 이 값 하나로 화면
-  // 전체가 죽을 수는 없다. t()는 모르는 키에 던지고(i18n/index.mjs) 이
-  // 함수는 render() 안에서 돈다 — 항목 하나의 결손이 패널 하나가 아니라
-  // TUI 전체를 끌고 내려간다.
-  const bits = [item.category, item.scope ? t(`detail.scope.${item.scope}`) : null, t(`status.${row.status}`)]
-  return cut(`${item.label}   ${bits.filter(Boolean).join(' · ')}`, w)
-}
-
-function wiredLines(item, w, lead, t) {
-  const supports = item.supports ?? []
-  if (supports.length === 0) return []
-  // 경로는 MCP에서만 붙인다. 그때만 clis.mjs 어댑터가 경로의 유일한 진실이다 —
-  // plugin·skill은 설치 자리가 항목마다 달라 어댑터가 알지 못한다.
-  const showFile = item.category === 'mcp'
-  const nameWidth = Math.max(...supports.map((c) => width(c)))
-  return supports.map((cli, i) => {
-    const head = i === 0 ? pad(t('detail.wired'), lead) : ' '.repeat(lead)
-    const file = showFile && CLIS[cli]?.file ? `  ${CLIS[cli].file}` : ''
-    // 이름 뒤에 열이 없으면 맞출 대상도 없다 — 경로가 붙는 mcp에서만 이름을 편다.
-    const name = showFile ? pad(cli, nameWidth) : cli
-    return cut(`${head}✔ ${name}${file}`, w)
-  })
-}
-
-function unwiredLines(item, w, lead, t) {
-  const out = []
-  unsupportedGroups(item, t).forEach((group, i) => {
-    const head = i === 0 ? pad(t('detail.unwired'), lead) : ' '.repeat(lead)
-    out.push(cut(`${head}✖ ${group.clis.join('·')}`, w))
-    // 사유는 한 칸 더 들여 이어 붙인다. 첫 줄만 └를 달아 어느 CLI 묶음의
-    // 사유인지 눈으로 잇는다.
-    wrap(group.why, Math.max(1, w - lead - 3)).forEach((line, j) => {
-      out.push(cut(`${' '.repeat(lead + 1)}${j === 0 ? '└ ' : '  '}${line}`, w))
-    })
-  })
-  return out
-}
-
-function agentLines(row, w, t) {
-  const item = row.item
-  const lead = leadWidth(t)
-  const out = [headLine(row, w, t)]
-  // 대상 파일은 note보다 먼저 낸다 — MCP의 배선표가 "어느 파일에 쓰이나"를
-  // 답하는 자리와 같은 몫이고, 산문보다 먼저 눈에 들어와야 한다.
-  if (item.target) out.push(cut(`${pad(t('detail.target'), lead)}${item.target}`, w))
-  if (item.note) out.push(...wrap(t(item.note), w))
-  if (row.statusDetail) out.push(...wrap(row.statusDetail, w))
-  out.push(...wiredLines(item, w, lead, t))
-  out.push(...unwiredLines(item, w, lead, t))
-  return out
-}
-
-function designLines(row, w, t) {
-  const item = row.item
-  const lead = leadWidth(t)
-  const bits = [item.category, categoryLabel(t, item.designCategory), t(`status.${row.status}`)]
-  const out = [cut(`${item.label}   ${bits.filter(Boolean).join(' · ')}`, w)]
-  if (item.providerId) out.push(cut(`${pad(t('detail.provider'), lead)}${item.providerId}`, w))
-  const target = row.previewTarget ?? item.webUrl ?? item.previewPath
-  if (target) out.push(cut(`${pad(t('detail.preview'), lead)}${target}`, w))
-  if (item.description) out.push(...wrap(item.description, w))
-  return out
-}
-
-// 액션 행은 체크 대상이 아니라 실행 대상이다 — 배선표가 없다.
-function actionLines(row, w) {
-  return [cut(row.label, w), ...wrap(row.fullHint ?? row.hint ?? '', w)]
-}
-
-// 행 하나와 지면 크기를 받아 줄 배열을 돌려준다. 색도 커서도 모른다.
-export function detailLines(row, { width: columns = 80, height = 8, t = createT('en') } = {}) {
-  if (!row || height <= 0) return []
-  const w = Math.max(20, columns)
-  const lines = row.kind === 'action'
-    ? actionLines(row, w)
-    : row.item?.category === 'design' ? designLines(row, w, t) : agentLines(row, w, t)
-
-  if (lines.length <= height) return lines
-  // 넘치면 조용히 자르지 않는다 — 남은 줄 수와 펼치는 길을 함께 알린다.
-  // 안내줄이 한 줄을 차지하므로 본문은 height - 1줄만 쓴다. height===1이면
-  // 그 한 줄조차 없어 안내줄 하나가 전부를 대신하고, 그때는 "한 줄 빼고 남은
-  // 수"가 아니라 "전부"를 세어야 거짓말이 되지 않는다.
-  const room = height - 1
-  const marker = cut(t('detail.more', { count: lines.length - Math.max(0, room) }), w)
-  return room <= 0 ? [marker] : [...lines.slice(0, room), marker]
-}
+// 상세 패널 — 커서가 놓인 항목의 전문을 여러 줄로 편다.
+// 순수 함수 모듈이다. 색도 커서도 터미널도 모른다 — render.mjs가 배치하고 칠한다.
+//
+// rows.mjs를 import 하지 않는 것이 규칙이다. render.mjs가 이 모듈을 쓰므로,
+// 여기서 rows를 끌어오면 render → detail → rows 방향이 생겨 rows.mjs가 순수
+// 렌더 층의 의존성이 된다. 그래서 사유 그룹핑이 rows가 아니라 여기 있고,
+// rows.mjs가 반대로 여기서 가져다 쓴다.
+import { toText, createT } from '../i18n/index.mjs'
+import { CLIS } from '../clis.mjs'
+import { categoryLabel } from '../design-md/flow.mjs'
+import { cut, labelWidth, pad, width, wrap } from '../width.mjs'
+
+// 미배선 사유를 **같은 사유끼리** 묶는다. 사유 하나가 CLI 아홉 개에 그대로
+// 반복되면 줄만 길어지고 "무엇이 왜 빠졌는가"는 오히려 묻힌다.
+// 사유가 둘 이상이면(ponytail처럼) 갈래가 그대로 보인다.
+export function unsupportedGroups(item, t) {
+  const entries = Object.entries(item?.unsupported ?? {})
+  if (entries.length === 0) return []
+  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)
+  }
+  return [...byReason].map(([why, clis]) => ({ clis, why }))
+}
+
+// 왼쪽 라벨 열('배선'·'미배선'·'출처'·'미리보기'·'대상 파일')의 폭. 로케일마다
+// 길이가 달라 상수로 박으면 열이 어긋나므로 그 로케일의 실제 라벨에서 뽑는다.
+//
+// **이 열에 놓이는 라벨을 하나도 빠뜨리면 안 된다.** 예전에는 배선·미배선만
+// 재서, 한국어의 '미리보기'(8칸)가 폭 7의 열에 들어가 '미리…'로 잘렸다 —
+// pad는 넘치는 글을 cut으로 버리기 때문에 조용히 사라진다.
+const LEAD_KEYS = ['detail.wired', 'detail.unwired', 'detail.provider', 'detail.preview', 'detail.target']
+
+function leadWidth(t) {
+  return labelWidth(t, LEAD_KEYS) + 1
+}
+
+function headLine(row, w, t) {
+  const item = row.item
+  // item.scope는 오늘 모든 항목 종류가 채운다 — 그래도 이 값 하나로 화면
+  // 전체가 죽을 수는 없다. t()는 모르는 키에 던지고(i18n/index.mjs) 이
+  // 함수는 render() 안에서 돈다 — 항목 하나의 결손이 패널 하나가 아니라
+  // TUI 전체를 끌고 내려간다.
+  const bits = [item.category, item.scope ? t(`detail.scope.${item.scope}`) : null, t(`status.${row.status}`)]
+  return cut(`${item.label}   ${bits.filter(Boolean).join(' · ')}`, w)
+}
+
+function wiredLines(item, w, lead, t) {
+  const supports = item.supports ?? []
+  if (supports.length === 0) return []
+  // 경로는 MCP에서만 붙인다. 그때만 clis.mjs 어댑터가 경로의 유일한 진실이다 —
+  // plugin·skill은 설치 자리가 항목마다 달라 어댑터가 알지 못한다.
+  const showFile = item.category === 'mcp'
+  const nameWidth = Math.max(...supports.map((c) => width(c)))
+  return supports.map((cli, i) => {
+    const head = i === 0 ? pad(t('detail.wired'), lead) : ' '.repeat(lead)
+    const file = showFile && CLIS[cli]?.file ? `  ${CLIS[cli].file}` : ''
+    // 이름 뒤에 열이 없으면 맞출 대상도 없다 — 경로가 붙는 mcp에서만 이름을 편다.
+    const name = showFile ? pad(cli, nameWidth) : cli
+    return cut(`${head}✔ ${name}${file}`, w)
+  })
+}
+
+function unwiredLines(item, w, lead, t) {
+  const out = []
+  unsupportedGroups(item, t).forEach((group, i) => {
+    const head = i === 0 ? pad(t('detail.unwired'), lead) : ' '.repeat(lead)
+    out.push(cut(`${head}✖ ${group.clis.join('·')}`, w))
+    // 사유는 한 칸 더 들여 이어 붙인다. 첫 줄만 └를 달아 어느 CLI 묶음의
+    // 사유인지 눈으로 잇는다.
+    wrap(group.why, Math.max(1, w - lead - 3)).forEach((line, j) => {
+      out.push(cut(`${' '.repeat(lead + 1)}${j === 0 ? '└ ' : '  '}${line}`, w))
+    })
+  })
+  return out
+}
+
+function agentLines(row, w, t) {
+  const item = row.item
+  const lead = leadWidth(t)
+  const out = [headLine(row, w, t)]
+  // 대상 파일은 note보다 먼저 낸다 — MCP의 배선표가 "어느 파일에 쓰이나"를
+  // 답하는 자리와 같은 몫이고, 산문보다 먼저 눈에 들어와야 한다.
+  if (item.target) out.push(cut(`${pad(t('detail.target'), lead)}${item.target}`, w))
+  if (item.note) out.push(...wrap(t(item.note), w))
+  if (row.statusDetail) out.push(...wrap(row.statusDetail, w))
+  out.push(...wiredLines(item, w, lead, t))
+  out.push(...unwiredLines(item, w, lead, t))
+  return out
+}
+
+function designLines(row, w, t) {
+  const item = row.item
+  const lead = leadWidth(t)
+  const bits = [item.category, categoryLabel(t, item.designCategory), t(`status.${row.status}`)]
+  const out = [cut(`${item.label}   ${bits.filter(Boolean).join(' · ')}`, w)]
+  if (item.providerId) out.push(cut(`${pad(t('detail.provider'), lead)}${item.providerId}`, w))
+  const target = row.previewTarget ?? item.webUrl ?? item.previewPath
+  if (target) out.push(cut(`${pad(t('detail.preview'), lead)}${target}`, w))
+  if (item.description) out.push(...wrap(item.description, w))
+  return out
+}
+
+// 액션 행은 체크 대상이 아니라 실행 대상이다 — 배선표가 없다.
+function actionLines(row, w) {
+  return [cut(row.label, w), ...wrap(row.fullHint ?? row.hint ?? '', w)]
+}
+
+// 행 하나와 지면 크기를 받아 줄 배열을 돌려준다. 색도 커서도 모른다.
+export function detailLines(row, { width: columns = 80, height = 8, t = createT('en') } = {}) {
+  if (!row || height <= 0) return []
+  const w = Math.max(20, columns)
+  const lines = row.kind === 'action'
+    ? actionLines(row, w)
+    : row.item?.category === 'design' ? designLines(row, w, t) : agentLines(row, w, t)
+
+  if (lines.length <= height) return lines
+  // 넘치면 조용히 자르지 않는다 — 남은 줄 수와 펼치는 길을 함께 알린다.
+  // 안내줄이 한 줄을 차지하므로 본문은 height - 1줄만 쓴다. height===1이면
+  // 그 한 줄조차 없어 안내줄 하나가 전부를 대신하고, 그때는 "한 줄 빼고 남은
+  // 수"가 아니라 "전부"를 세어야 거짓말이 되지 않는다.
+  const room = height - 1
+  const marker = cut(t('detail.more', { count: lines.length - Math.max(0, room) }), w)
+  return room <= 0 ? [marker] : [...lines.slice(0, room), marker]
+}

package/lib/tui/progress.mjs

@@ -1,160 +1,160 @@
-// 진행 화면 — 순수 함수 모듈이다. 터미널도 시계도 모른다.
-//
-// 시각을 인자로 받는 것이 핵심이다. 모듈 안에서 Date.now()를 부르면 테스트가
-// 실제 시간에 묶여 "14초 경과"를 검증할 방법이 없다.
-import { createT } from '../i18n/index.mjs'
-import { cut, labelWidth, pad, width } from '../width.mjs'
-
-const ESC = String.fromCharCode(27)
-const DIM = `${ESC}[2m`
-const BOLD = `${ESC}[1m`
-const RESET = `${ESC}[0m`
-
-const MARK = { done: '✔', failed: '✖', running: '▸', pending: ' ', skipped: '–' }
-
-export function createProgress(changes) {
-  return {
-    total: changes.length,
-    startedAt: null,
-    aborted: false,
-    entries: changes.map(({ item, action }) => ({
-      item, action, state: 'pending', ok: null, ms: 0, command: null, startedAt: null,
-    })),
-  }
-}
-
-// 이벤트 하나를 접어 넣는다. 새 상태를 돌려준다 — 화면은 이 값만 보고 그린다.
-export function applyEvent(progress, event, now) {
-  const entries = progress.entries.slice()
-  const at = entries[event.index]
-  if (!at) return progress
-  if (event.phase === 'start') entries[event.index] = { ...at, state: 'running', startedAt: now }
-  else if (event.phase === 'command') entries[event.index] = { ...at, command: event.command }
-  else if (event.phase === 'done') {
-    entries[event.index] = { ...at, state: event.ok ? 'done' : 'failed', ok: event.ok, ms: event.ms ?? 0 }
-  }
-  return { ...progress, entries, startedAt: progress.startedAt ?? now }
-}
-
-function seconds(ms) {
-  return (Math.max(0, ms) / 1000).toFixed(1).replace(/\.0$/, '')
-}
-
-function elapsedText(ms, t) {
-  const total = Math.floor(Math.max(0, ms) / 1000)
-  return total >= 60
-    ? t('progress.elapsedMin', { minutes: Math.floor(total / 60), seconds: total % 60 })
-    : t('progress.elapsed', { seconds: total })
-}
-
-function bar(done, total, room) {
-  if (room <= 2) return ''
-  const inner = room - 2
-  const filled = total === 0 ? 0 : Math.round((done / total) * inner)
-  return `[${'█'.repeat(filled)}${'░'.repeat(Math.max(0, inner - filled))}]`
-}
-
-// 항목 한 개가 차지하는 줄. 실행 중이면 경과와 명령을 함께 낸다.
-function entryLines(entry, w, actionWidth, now, t) {
-  let tail = ''
-  if (entry.state === 'running') {
-    const ran = Math.floor(Math.max(0, now - (entry.startedAt ?? now)) / 1000)
-    tail = `  ${t('progress.running', { seconds: ran })}`
-  } else if (entry.state === 'done' || entry.state === 'failed') {
-    tail = `  ${t('progress.elapsed', { seconds: seconds(entry.ms) })}`
-  } else if (entry.state === 'skipped') {
-    tail = `  ${t('progress.skipped')}`
-  }
-  const mark = MARK[entry.state] ?? ' '
-  const out = [cut(`${mark} ${pad(t(`change.${entry.action}`), actionWidth)} ${entry.item.label}${tail}`, w)]
-  // 명령은 실행 중일 때만. 끝난 뒤에도 남기면 화면이 명령 목록이 된다.
-  if (entry.state === 'running' && entry.command) out.push(cut(`      ${entry.command}`, w))
-  return out
-}
-
-// 중단되면 아직 시작하지 않은(pending) 항목이 곧 건너뛴 항목이다. applyEvent는
-// Task 9의 이벤트(start·command·done)만 받아 항목 상태가 'skipped'가 되는
-// 경로가 없다 — 그래서 화면을 그릴 때만 pending을 skipped로 겹쳐 본다.
-// 집계와 표시가 같은 규칙을 쓰게 해, "건너뜀 0건"처럼 숫자와 말이 어긋나지 않게 한다.
-function viewEntry(entry, aborted) {
-  return aborted && entry.state === 'pending' ? { ...entry, state: 'skipped' } : entry
-}
-
-export function progressLines(progress, opts = {}) {
-  const { width: columns = 80, height = 24, color = false, dryRun = false, now = 0, t = createT('en') } = opts
-  const w = Math.max(24, columns - 1)
-  const paint = (code, text) => (color ? `${code}${text}${RESET}` : text)
-
-  const done = progress.entries.filter((e) => e.state === 'done' || e.state === 'failed').length
-  const skipped = progress.aborted ? progress.entries.filter((e) => e.state === 'pending').length : 0
-  const percent = progress.total === 0 ? 100 : Math.round((done / progress.total) * 100)
-  const counter = t('progress.counter', { done, total: progress.total, percent })
-  const elapsed = progress.startedAt === null ? '' : `   ${elapsedText(now - progress.startedAt, t)}`
-
-  const title = t('progress.title', { count: progress.total, suffix: dryRun ? ' (dry-run)' : '' })
-  const lines = [paint(BOLD, cut(title, w)), '']
-
-  const meta = `  ${counter}${elapsed}`
-  lines.push(cut(`${bar(done, progress.total, Math.max(0, w - width(meta)))}${meta}`, w))
-  lines.push('')
-
-  const actionWidth = labelWidth(t, ['change.install', 'change.complete', 'change.uninstall'])
-  const body = Math.max(1, height - lines.length - 2)
-
-  // 지면이 모자라면 **완료된 것부터** 접는다. 지금 무엇이 도는지가 가장 알고
-  // 싶은 정보라, 실행 중 항목은 언제나 화면에 남는다.
-  //
-  // 실행 중 항목(없으면 마지막으로 끝난 항목)을 기준점으로 잡고 지면이
-  // 허락하는 만큼만 위로 거슬러 올라간다. 기준점에서 시작하므로 그 줄이
-  // 잘려 나갈 수 없다 — "완료분부터 접는다"를 규칙이 아니라 구조로 보장한다.
-  const blocks = progress.entries.map((e) => entryLines(viewEntry(e, progress.aborted), w, actionWidth, now, t))
-  const running = progress.entries.findIndex((e) => e.state === 'running')
-  const anchor = running === -1 ? Math.max(0, done - 1) : running
-
-  let from = anchor
-  let used = blocks.slice(anchor).reduce((n, b) => n + b.length, 0)
-  while (from > 0 && used + blocks[from - 1].length <= body - 1) {
-    from--
-    used += blocks[from].length
-  }
-  // '더보기' 줄은 부가 정보일 뿐이다. 지면이 1줄밖에 없으면 실행 중 항목이
-  // 이긴다 — 더보기 줄에 밀려 정작 지금 도는 항목이 사라지면 안 된다.
-  const showMore = from > 0 && body > 1
-  const shown = blocks.slice(from).flat().slice(0, Math.max(1, body - (showMore ? 1 : 0)))
-  if (showMore) lines.push(paint(DIM, cut(t('progress.more', { count: from }), w)))
-  for (const line of shown) lines.push(line)
-  for (let i = lines.length; i < height - 2; i++) lines.push('')
-
-  lines.push('')
-  // done 분기(아래)는 aborted가 아닐 때만 오고, 그때 skipped는 위에서 늘
-  // 0이다 — 그래서 skippedSuffix는 항상 빈 문자열이다. progress.doneSkipped
-  // 키는 이 분기가 실제로 채울 일이 없어 지웠다(더는 어디서도 쓰지 않는다).
-  const foot = progress.aborted
-    ? t('progress.aborted', { count: skipped })
-    : done < progress.total
-      ? t('progress.abortHint')
-      : t('progress.done', {
-        ok: progress.entries.filter((e) => e.state === 'done').length,
-        failed: progress.entries.filter((e) => e.state === 'failed').length,
-        skippedSuffix: '',
-      })
-  lines.push(paint(DIM, cut(foot, w)))
-  return lines.slice(0, height)
-}
-
-// 비TTY(CI·파이프)용. 바를 그리지 않고 항목마다 한 줄씩 흘린다 —
-// ANSI 제어문자로 CI 로그를 더럽히지 않는다.
-export function plainLine(event, t = createT('en')) {
-  if (event.phase === 'start') {
-    return t('progress.plain', {
-      index: event.index + 1,
-      total: event.total,
-      action: t(`change.${event.action}`),
-      label: event.item.label,
-    })
-  }
-  if (event.phase === 'done') {
-    return t('progress.plainDone', { mark: event.ok ? '✔' : '✖', seconds: seconds(event.ms ?? 0) })
-  }
-  return null
-}
+// 진행 화면 — 순수 함수 모듈이다. 터미널도 시계도 모른다.
+//
+// 시각을 인자로 받는 것이 핵심이다. 모듈 안에서 Date.now()를 부르면 테스트가
+// 실제 시간에 묶여 "14초 경과"를 검증할 방법이 없다.
+import { createT } from '../i18n/index.mjs'
+import { cut, labelWidth, pad, width } from '../width.mjs'
+
+const ESC = String.fromCharCode(27)
+const DIM = `${ESC}[2m`
+const BOLD = `${ESC}[1m`
+const RESET = `${ESC}[0m`
+
+const MARK = { done: '✔', failed: '✖', running: '▸', pending: ' ', skipped: '–' }
+
+export function createProgress(changes) {
+  return {
+    total: changes.length,
+    startedAt: null,
+    aborted: false,
+    entries: changes.map(({ item, action }) => ({
+      item, action, state: 'pending', ok: null, ms: 0, command: null, startedAt: null,
+    })),
+  }
+}
+
+// 이벤트 하나를 접어 넣는다. 새 상태를 돌려준다 — 화면은 이 값만 보고 그린다.
+export function applyEvent(progress, event, now) {
+  const entries = progress.entries.slice()
+  const at = entries[event.index]
+  if (!at) return progress
+  if (event.phase === 'start') entries[event.index] = { ...at, state: 'running', startedAt: now }
+  else if (event.phase === 'command') entries[event.index] = { ...at, command: event.command }
+  else if (event.phase === 'done') {
+    entries[event.index] = { ...at, state: event.ok ? 'done' : 'failed', ok: event.ok, ms: event.ms ?? 0 }
+  }
+  return { ...progress, entries, startedAt: progress.startedAt ?? now }
+}
+
+function seconds(ms) {
+  return (Math.max(0, ms) / 1000).toFixed(1).replace(/\.0$/, '')
+}
+
+function elapsedText(ms, t) {
+  const total = Math.floor(Math.max(0, ms) / 1000)
+  return total >= 60
+    ? t('progress.elapsedMin', { minutes: Math.floor(total / 60), seconds: total % 60 })
+    : t('progress.elapsed', { seconds: total })
+}
+
+function bar(done, total, room) {
+  if (room <= 2) return ''
+  const inner = room - 2
+  const filled = total === 0 ? 0 : Math.round((done / total) * inner)
+  return `[${'█'.repeat(filled)}${'░'.repeat(Math.max(0, inner - filled))}]`
+}
+
+// 항목 한 개가 차지하는 줄. 실행 중이면 경과와 명령을 함께 낸다.
+function entryLines(entry, w, actionWidth, now, t) {
+  let tail = ''
+  if (entry.state === 'running') {
+    const ran = Math.floor(Math.max(0, now - (entry.startedAt ?? now)) / 1000)
+    tail = `  ${t('progress.running', { seconds: ran })}`
+  } else if (entry.state === 'done' || entry.state === 'failed') {
+    tail = `  ${t('progress.elapsed', { seconds: seconds(entry.ms) })}`
+  } else if (entry.state === 'skipped') {
+    tail = `  ${t('progress.skipped')}`
+  }
+  const mark = MARK[entry.state] ?? ' '
+  const out = [cut(`${mark} ${pad(t(`change.${entry.action}`), actionWidth)} ${entry.item.label}${tail}`, w)]
+  // 명령은 실행 중일 때만. 끝난 뒤에도 남기면 화면이 명령 목록이 된다.
+  if (entry.state === 'running' && entry.command) out.push(cut(`      ${entry.command}`, w))
+  return out
+}
+
+// 중단되면 아직 시작하지 않은(pending) 항목이 곧 건너뛴 항목이다. applyEvent는
+// Task 9의 이벤트(start·command·done)만 받아 항목 상태가 'skipped'가 되는
+// 경로가 없다 — 그래서 화면을 그릴 때만 pending을 skipped로 겹쳐 본다.
+// 집계와 표시가 같은 규칙을 쓰게 해, "건너뜀 0건"처럼 숫자와 말이 어긋나지 않게 한다.
+function viewEntry(entry, aborted) {
+  return aborted && entry.state === 'pending' ? { ...entry, state: 'skipped' } : entry
+}
+
+export function progressLines(progress, opts = {}) {
+  const { width: columns = 80, height = 24, color = false, dryRun = false, now = 0, t = createT('en') } = opts
+  const w = Math.max(24, columns - 1)
+  const paint = (code, text) => (color ? `${code}${text}${RESET}` : text)
+
+  const done = progress.entries.filter((e) => e.state === 'done' || e.state === 'failed').length
+  const skipped = progress.aborted ? progress.entries.filter((e) => e.state === 'pending').length : 0
+  const percent = progress.total === 0 ? 100 : Math.round((done / progress.total) * 100)
+  const counter = t('progress.counter', { done, total: progress.total, percent })
+  const elapsed = progress.startedAt === null ? '' : `   ${elapsedText(now - progress.startedAt, t)}`
+
+  const title = t('progress.title', { count: progress.total, suffix: dryRun ? ' (dry-run)' : '' })
+  const lines = [paint(BOLD, cut(title, w)), '']
+
+  const meta = `  ${counter}${elapsed}`
+  lines.push(cut(`${bar(done, progress.total, Math.max(0, w - width(meta)))}${meta}`, w))
+  lines.push('')
+
+  const actionWidth = labelWidth(t, ['change.install', 'change.complete', 'change.uninstall'])
+  const body = Math.max(1, height - lines.length - 2)
+
+  // 지면이 모자라면 **완료된 것부터** 접는다. 지금 무엇이 도는지가 가장 알고
+  // 싶은 정보라, 실행 중 항목은 언제나 화면에 남는다.
+  //
+  // 실행 중 항목(없으면 마지막으로 끝난 항목)을 기준점으로 잡고 지면이
+  // 허락하는 만큼만 위로 거슬러 올라간다. 기준점에서 시작하므로 그 줄이
+  // 잘려 나갈 수 없다 — "완료분부터 접는다"를 규칙이 아니라 구조로 보장한다.
+  const blocks = progress.entries.map((e) => entryLines(viewEntry(e, progress.aborted), w, actionWidth, now, t))
+  const running = progress.entries.findIndex((e) => e.state === 'running')
+  const anchor = running === -1 ? Math.max(0, done - 1) : running
+
+  let from = anchor
+  let used = blocks.slice(anchor).reduce((n, b) => n + b.length, 0)
+  while (from > 0 && used + blocks[from - 1].length <= body - 1) {
+    from--
+    used += blocks[from].length
+  }
+  // '더보기' 줄은 부가 정보일 뿐이다. 지면이 1줄밖에 없으면 실행 중 항목이
+  // 이긴다 — 더보기 줄에 밀려 정작 지금 도는 항목이 사라지면 안 된다.
+  const showMore = from > 0 && body > 1
+  const shown = blocks.slice(from).flat().slice(0, Math.max(1, body - (showMore ? 1 : 0)))
+  if (showMore) lines.push(paint(DIM, cut(t('progress.more', { count: from }), w)))
+  for (const line of shown) lines.push(line)
+  for (let i = lines.length; i < height - 2; i++) lines.push('')
+
+  lines.push('')
+  // done 분기(아래)는 aborted가 아닐 때만 오고, 그때 skipped는 위에서 늘
+  // 0이다 — 그래서 skippedSuffix는 항상 빈 문자열이다. progress.doneSkipped
+  // 키는 이 분기가 실제로 채울 일이 없어 지웠다(더는 어디서도 쓰지 않는다).
+  const foot = progress.aborted
+    ? t('progress.aborted', { count: skipped })
+    : done < progress.total
+      ? t('progress.abortHint')
+      : t('progress.done', {
+        ok: progress.entries.filter((e) => e.state === 'done').length,
+        failed: progress.entries.filter((e) => e.state === 'failed').length,
+        skippedSuffix: '',
+      })
+  lines.push(paint(DIM, cut(foot, w)))
+  return lines.slice(0, height)
+}
+
+// 비TTY(CI·파이프)용. 바를 그리지 않고 항목마다 한 줄씩 흘린다 —
+// ANSI 제어문자로 CI 로그를 더럽히지 않는다.
+export function plainLine(event, t = createT('en')) {
+  if (event.phase === 'start') {
+    return t('progress.plain', {
+      index: event.index + 1,
+      total: event.total,
+      action: t(`change.${event.action}`),
+      label: event.item.label,
+    })
+  }
+  if (event.phase === 'done') {
+    return t('progress.plainDone', { mark: event.ok ? '✔' : '✖', seconds: seconds(event.ms ?? 0) })
+  }
+  return null
+}