@rch4com/agent-setup 1.17.0 → 1.19.0

package/lib/tui/rows.mjs

@@ -104,16 +104,38 @@ export function designHint(state, multiProvider = false, t) {
   return parts.filter(Boolean).join(' · ')
 }
 
+// 이름을 나열할 수 있는 최대 CLI 수. 넷까지는 이름(codex·gemini·opencode·copilot)이
+// 80칸 힌트 자리에 들고, 그보다 많으면 "몇 개나 되나"가 더 유용하다.
+const NAME_LIMIT = 4
+
 // 목록 행에 실제로 찍히는 힌트. 80칸 터미널이면 힌트 자리는 49칸(한글 24자)뿐이라,
 // 예전처럼 사유까지 이어 붙이면 뒤쪽이 통째로 잘렸다. 사유·note·detail은
 // 상세 패널이 여러 줄로 편다 — 여기 남는 것은 잘릴 일이 없는 두 가지뿐이다.
+//
+// 커버리지 표기는 탭과 무관하게 한 규칙이다 — 예전에는 plugin 탭만 이름을,
+// 나머지는 수를 찍어 한 화면 안에서 규칙이 바뀌었다. 이제 지원 CLI가 넷
+// 이하면 이름을, 그보다 많으면 `CLI n/N`을 찍는다. 이름을 나열할 때는 이
+// 머신에 없는 CLI(state.excluded — 전역 항목이 detect에서 알린다)를 빼고
+// 따로 적는다: 상세에는 "CLI 없음"이라 하면서 행에는 그 이름이 그대로
+// 찍히면 어느 쪽이 참인지 알 수 없다.
+export function coverageText(item, state, t = createT('en')) {
+  if (!item.supports) return ''
+  if (item.supports.length > NAME_LIMIT || item.supports.length === 0) {
+    return t('item.cliCoverage', { covered: item.supports.length, total: CLI_IDS.length })
+  }
+  const excluded = state?.excluded ?? []
+  const here = item.supports.filter((c) => !excluded.includes(c))
+  const parts = []
+  if (here.length > 0) parts.push(here.join('·'))
+  if (excluded.length > 0) parts.push(t('item.cliMissing', { list: excluded.join('·') }))
+  return parts.join(' · ')
+}
+
 export function agentShortHint(item, state, t = createT('en')) {
   const parts = []
   if (state.status !== 'absent') parts.push(t(`status.${state.status}`))
-  // plugin은 수 대신 이름을 나열한다 — 어느 CLI에 설치되는가가 이 탭에서
-  // 고르는 기준이고, 가장 긴 나열(codex·gemini·opencode·copilot)도 자리에 든다.
-  if (item.category === 'plugin' && item.supports?.length) parts.push(item.supports.join('·'))
-  else if (item.supports) parts.push(t('item.cliCoverage', { covered: item.supports.length, total: CLI_IDS.length }))
+  const cov = coverageText(item, state, t)
+  if (cov) parts.push(cov)
   return parts.join(' · ')
 }
 
@@ -151,11 +173,14 @@ function itemRow({ id, section, label, hint, fullHint = hint, statusDetail = nul
   }
 }
 
-function actionRow({ id, label, hint, run = null, t = createT('en') }) {
+// section 기본값은 작업 탭이다. design.md 동기화처럼 한 탭에만 관계있는
+// 작업은 그 탭을 넘겨 그 자리 맨 위에 놓는다 — 첫 화면의 작업 탭에 design.md
+// 전용 작업이 섞여 있으면 무엇을 위한 화면인지부터 흐려진다.
+function actionRow({ id, label, hint, run = null, section = ACTION_SECTION, t = createT('en') }) {
   return {
     kind: 'action',
     id,
-    section: ACTION_SECTION,
+    section,
     group: null,
     exclusive: null,
     label,
@@ -165,7 +190,7 @@ function actionRow({ id, label, hint, run = null, t = createT('en') }) {
     status: 'absent',
     previewTarget: null,
     run,
-    searchText: `${label} ${hint} ${sectionTerms(t, ACTION_SECTION)}`.toLowerCase(),
+    searchText: `${label} ${hint} ${sectionTerms(t, section)}`.toLowerCase(),
   }
 }
 
@@ -192,8 +217,10 @@ export function buildActions(root, { designItems = [], t = createT('en') } = {})
       run: ({ dryRun, skillMode, log, t: rt }) => runBootstrap(root, { dryRun, skillMode, log, t: rt }),
       t,
     }),
+    // design.md 전용 세 작업은 DESIGN.MD 탭 맨 위에 놓는다.
     actionRow({
       id: 'action.sync.installed',
+      section: 'design',
       label: t('action.sync.installed.label'),
       hint: t('action.sync.installed.hint'),
       run: ({ dryRun, log, t: rt }) => updateInstalled(root, designItems, { dryRun, log, t: rt }),
@@ -201,6 +228,7 @@ export function buildActions(root, { designItems = [], t = createT('en') } = {})
     }),
     actionRow({
       id: 'action.sync.catalog',
+      section: 'design',
       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 }),
@@ -208,6 +236,7 @@ export function buildActions(root, { designItems = [], t = createT('en') } = {})
     }),
     actionRow({
       id: 'action.sync.stale',
+      section: 'design',
       label: t('action.sync.stale.label'),
       hint: t('action.sync.stale.hint'),
       run: async ({ dryRun, log, confirm, t: rt }) => {

package/lib/tui/run.mjs

@@ -12,7 +12,7 @@ import {
   createState, setQuery, setFocus, move, moveTab, toggle, toggleVisible, scroll, currentRow, replaceRows, activeTab,
   cycleCliFilter,
 } from './state.mjs'
-import { render, renderReview, bodyHeight } from './render.mjs'
+import { render, renderReview, renderHelp, bodyHeight, footerHeight } from './render.mjs'
 import { createProgress, applyEvent, progressLines } from './progress.mjs'
 import { scopedLabel } from '../labels.mjs'
 
@@ -119,19 +119,36 @@ export async function runTui(root, opts = {}) {
 
   const color = !env.NO_COLOR && stdout.isTTY
   const draw = (lines) => stdout.write(HOME + lines.map((l) => l + CLEAR_LINE).join('\n') + '\n' + CLEAR_DOWN)
+  // 목록 지면은 바닥글 줄 수에 따라 달라진다 — render와 같은 산식을 써야
+  // 스크롤·페이지 이동이 화면과 어긋나지 않는다. t는 언어 행이 갈아끼우므로
+  // 그때그때 다시 잰다.
+  const listHeight = () => bodyHeight(stdout.rows ?? 24, detailExpanded, footerHeight(stdout.columns ?? 80, t))
   const paint = () => {
     const height = stdout.rows ?? 24
-    state = scroll(state, bodyHeight(height, detailExpanded))
+    state = scroll(state, listHeight())
     draw(render(state, {
       width: stdout.columns ?? 80, height, repo: root, dryRun, color, status, t,
       detailExpanded, cliOptions: CLI_OPTIONS,
     }))
   }
+  const paintHelp = () => draw(renderHelp({ width: stdout.columns ?? 80, height: stdout.rows ?? 24, color, t }))
+
+  // 터미널 크기가 바뀌면 지금 떠 있는 화면을 새 크기로 다시 그린다 — 예전에는
+  // 다음 키를 누를 때까지 옛 크기로 남았다. 화면마다 자기 그리기 함수를
+  // redraw에 걸고, 화면 밖(suspend)에서는 null로 둬 아무것도 안 한다.
+  // 테스트의 가짜 stdout에는 on이 없을 수 있어 선택 호출이다.
+  let redraw = paint
+  const onResize = () => {
+    try { redraw?.() } catch { /* 그리기 실패로 루프를 죽이지 않는다 */ }
+  }
+  stdout.on?.('resize', onResize)
 
   // 로그는 화면 안에 우겨넣지 않는다 — 실패 메시지가 길고, 잘리면 진단이 불가능해진다.
   const suspend = async (fn) => {
+    const was = redraw
+    redraw = null
     stdout.write(ALT_OFF + SHOW_CURSOR)
-    try { return await fn() } finally { stdout.write(ALT_ON + HIDE_CURSOR) }
+    try { return await fn() } finally { stdout.write(ALT_ON + HIDE_CURSOR); redraw = was }
   }
   const confirm = async (message) => {
     stdout.write(`\n${message}${t('tui.confirmSuffix')}`)
@@ -201,12 +218,18 @@ export async function runTui(root, opts = {}) {
 
   // 제출 검토 — 적용 직전에 변경 목록을 보여 주고 Enter/Esc만 받는다.
   const review = async (changes) => {
-    for (;;) {
-      draw(renderReview(changes, { width: stdout.columns ?? 80, height: stdout.rows ?? 24, dryRun, color, t }))
-      const key = await keys.next()
-      if (key.ctrl && (key.name === 'c' || key.name === 'q')) return 'quit'
-      if (key.name === 'escape') return 'cancel'
-      if (key.name === 'return' || key.name === 'enter') return 'apply'
+    const paintReview = () => draw(renderReview(changes, { width: stdout.columns ?? 80, height: stdout.rows ?? 24, dryRun, color, t }))
+    redraw = paintReview
+    try {
+      for (;;) {
+        paintReview()
+        const key = await keys.next()
+        if (key.ctrl && (key.name === 'c' || key.name === 'q')) return 'quit'
+        if (key.name === 'escape') return 'cancel'
+        if (key.name === 'return' || key.name === 'enter') return 'apply'
+      }
+    } finally {
+      redraw = paint
     }
   }
 
@@ -225,6 +248,7 @@ export async function runTui(root, opts = {}) {
       width: stdout.columns ?? 80, height: stdout.rows ?? 24, color, dryRun, now: Date.now(), t,
     }))
 
+    redraw = drawProgress
     drawProgress()
     const timer = setInterval(() => { checkAbort(); drawProgress() }, 100)
     // 타이머가 프로세스를 붙잡지 않게 한다 — 화면 갱신은 종료를 미룰 이유가 없다.
@@ -255,6 +279,7 @@ export async function runTui(root, opts = {}) {
       return results
     } finally {
       clearInterval(timer)
+      redraw = paint
     }
   }
 
@@ -284,6 +309,17 @@ export async function runTui(root, opts = {}) {
       }
       if (key.ctrl && key.name === 'd') { detailExpanded = !detailExpanded; continue }
 
+      // F1: 도움말. 바닥글 두 줄로는 키의 뜻까지 담을 수 없다. 아무 키나 닫는다 —
+      // 그 키는 소비만 하고 명령으로 해석하지 않는다(도움말을 닫으려 누른
+      // Space가 항목을 고르면 안 된다).
+      if (key.name === 'f1') {
+        redraw = paintHelp
+        paintHelp()
+        await keys.next()
+        redraw = paint
+        continue
+      }
+
       // ── 검색칸에 포커스: 타이핑이 곧 검색어다(스페이스 포함, 두 단어 검색 가능).
       if (state.focus === 'search') {
         // Esc: 검색어가 있으면 지우고 검색칸에 남는다. 이미 비었으면 목록으로 내려간다.
@@ -319,8 +355,11 @@ export async function runTui(root, opts = {}) {
         continue
       }
       if (key.name === 'down' || (key.ctrl && key.name === 'n')) { state = move(state, 1); continue }
-      if (key.name === 'pageup') { state = move(state, -bodyHeight(stdout.rows ?? 24, detailExpanded)); continue }
-      if (key.name === 'pagedown') { state = move(state, bodyHeight(stdout.rows ?? 24, detailExpanded)); continue }
+      if (key.name === 'pageup') { state = move(state, -listHeight()); continue }
+      if (key.name === 'pagedown') { state = move(state, listHeight()); continue }
+      // 76개짜리 DESIGN.MD 탭에서 끝으로 가려면 PgDn을 여러 번 눌러야 했다.
+      if (key.name === 'home') { state = move(state, -state.filtered.length); continue }
+      if (key.name === 'end') { state = move(state, state.filtered.length); continue }
 
       // 탭 이동 — Tab/Shift+Tab, 좌우 화살표.
       if (key.name === 'tab') { state = moveTab(state, key.shift ? -1 : 1); continue }
@@ -389,6 +428,7 @@ export async function runTui(root, opts = {}) {
     }
   } finally {
     keys.stop()
+    stdout.off?.('resize', onResize)
     stdout.write(ALT_OFF + SHOW_CURSOR)
     stdin.setRawMode(false)
     stdin.pause()

package/lib/tui/state.mjs

@@ -73,13 +73,17 @@ export function activeTab(state) {
 // 탭별 적중 수 — 검색·필터 중에도 어느 탭에 결과가 있는지 한눈에 보이게 한다.
 // total은 필터를 타지 않는다: 분모가 함께 줄면 "이 탭에서 몇 개가 걸러졌나"를
 // 알 수 없다.
+//
+// 항목이 있는 탭은 항목만 센다 — DESIGN.MD 탭 맨 위의 작업 행 셋까지 세면
+// 항목 76개인 탭이 79로 찍혀 머리글의 "전체"와 어긋난다. 작업만 있는 탭은
+// 작업을 센다(0으로 두면 탭이 비어 보인다).
 export function tabCounts(state) {
   const hits = filterRows(state.rows, state.query).filter((r) => matchesCli(r, state.cliFilter))
-  return state.tabs.map((tab) => ({
-    tab,
-    shown: hits.filter((r) => r.section === tab).length,
-    total: state.rows.filter((r) => r.section === tab).length,
-  }))
+  return state.tabs.map((tab) => {
+    const hasItems = state.rows.some((r) => r.section === tab && r.kind === 'item')
+    const pick = (rows) => rows.filter((r) => r.section === tab && (!hasItems || r.kind === 'item'))
+    return { tab, shown: pick(hits).length, total: pick(state.rows).length }
+  })
 }
 
 export function currentRow(state) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rch4com/agent-setup",
-  "version": "1.17.0",
+  "version": "1.19.0",
   "description": "Repository-scoped bootstrap and optional-item installer for using multiple coding-agent CLIs in one repository | 여러 코딩 에이전트 CLI를 한 저장소에서 함께 쓰기 위한 저장소 범위 부트스트랩과 선택 항목 설치기",
   "keywords": [
     "agents-md",

package/lib/items/plugin.bkit.mjs

@@ -1,25 +0,0 @@
-import { definePlugin } from '../catalog.mjs'
-import { CLI_IDS } from '../clis.mjs'
-import { msg } from '../i18n/index.mjs'
-
-// 상류의 Codex·Gemini 지원은 이 플러그인이 아니라 별도 리포의 독립 포팅본이다
-// (bkit-codex: install 스크립트+MCP, 기능 241개 중 80개, hooks 없음 /
-// bkit-gemini: Gemini CLI extension). 플러그인 항목을 재사용할 수 없어 사유만 남긴다.
-// 예전에 "Gemini판은 Antigravity 승계 추정"이라 적었는데 근거가 없었다 —
-// bkit-gemini는 v2.0.7까지 Gemini CLI 확장 그대로이고 README에 Antigravity가
-// 한 번도 나오지 않는다. 다만 최종 푸시가 2026-05-20이라 Gemini CLI 종료
-// (2026-06-18) 이후로는 갱신이 없다. 추정 대신 그 사실만 적는다(2026-08-15 실측).
-const PORTS = ['codex', 'gemini']
-
-export default definePlugin({
-  id: 'plugin.bkit', label: 'bkit', group: '__flow',
-  installId: 'bkit@bkit-marketplace',
-  detectIds: ['bkit@bkit-marketplace'],
-  marketplace: { name: 'bkit-marketplace', repo: 'popup-studio-ai/bkit-claude-code' },
-  unsupported: Object.fromEntries(
-    CLI_IDS.filter((c) => c !== 'claude').map((c) => [
-      c,
-      PORTS.includes(c) ? msg('item.unsupported.bkitPort') : msg('item.unsupported.upstreamNone'),
-    ]),
-  ),
-})