@rch4com/agent-setup 1.0.0

package/lib/tui/state.mjs

@@ -0,0 +1,188 @@
+// 순수 리듀서 — 아무것도 import 하지 않는다. 터미널도 파일시스템도 모른다.
+// 모든 전이는 새 상태를 돌려준다. 키 시퀀스를 넣고 결과를 검증할 수 있게 하기 위해서다.
+
+function clamp(n, lo, hi) {
+  return n < lo ? lo : n > hi ? hi : n
+}
+
+// 탭 = 섹션. 순서는 행 배열의 등장 순서를 그대로 따른다 —
+// buildRows가 이미 SECTION_ORDER로 정렬해 주므로 여기서 순서를 다시 알 필요가 없다.
+export function tabsOf(rows) {
+  const out = []
+  for (const row of rows) if (!out.includes(row.section)) out.push(row.section)
+  return out
+}
+
+// 포커스는 두 곳 중 하나에 있다: 'search'(검색 입력칸) 또는 'list'(항목 목록).
+// 어느 쪽이 포커스인지가 Space·타이핑의 뜻을 가른다 — 검색칸에서는 글자가
+// 검색어(스페이스 포함)로, 목록에서는 Space가 선택으로 동작한다.
+// 흔한 TUI의 두-존(zone) 모델이다.
+export function createState(rows, { selectedIds = [], query = '', tabIndex = 0, focus = 'list' } = {}) {
+  const tabs = tabsOf(rows)
+  const index = clamp(tabIndex, 0, Math.max(0, tabs.length - 1))
+  return {
+    rows,
+    tabs,
+    tabIndex: index,
+    focus,
+    query,
+    filtered: visibleRows(rows, query, tabs[index]),
+    selected: new Set(selectedIds),
+    cursor: 0,
+    offset: 0,
+  }
+}
+
+// 포커스를 검색칸/목록으로 옮긴다. 커서·선택·검색어는 건드리지 않는다.
+export function setFocus(state, focus) {
+  return focus === state.focus ? state : { ...state, focus }
+}
+
+// 공백으로 나눈 토큰 AND 부분일치.
+// 빈 검색어는 전체 통과다 — 여기서는 빈 검색어가 곧 초기 화면이다.
+// 필터는 selected를 건드리지 않으므로, 빈 검색어가 전체 선택으로 새는 일이 없다.
+export function filterRows(rows, query) {
+  const tokens = String(query ?? '').toLowerCase().split(/\s+/).filter(Boolean)
+  if (tokens.length === 0) return rows
+  return rows.filter((row) => tokens.every((tok) => row.searchText.includes(tok)))
+}
+
+// 화면에 실제로 보이는 행 = 활성 탭 ∩ 검색 결과.
+// 검색은 탭 안으로 스코프하되, 다른 탭의 적중 수는 tabCounts로 함께 보여 준다 —
+// 그래야 "어느 탭에 있는지" 를 잃지 않으면서도 Tab 키가 늘 의미를 갖는다.
+function visibleRows(rows, query, tab) {
+  return filterRows(rows, query).filter((row) => row.section === tab)
+}
+
+export function activeTab(state) {
+  return state.tabs[state.tabIndex] ?? null
+}
+
+// 탭별 적중 수 — 검색 중에도 어느 탭에 결과가 있는지 한눈에 보이게 한다.
+export function tabCounts(state) {
+  const hits = filterRows(state.rows, state.query)
+  return state.tabs.map((tab) => ({
+    tab,
+    shown: hits.filter((r) => r.section === tab).length,
+    total: state.rows.filter((r) => r.section === tab).length,
+  }))
+}
+
+export function currentRow(state) {
+  return state.filtered[state.cursor] ?? null
+}
+
+function refocus(state, patch) {
+  const next = { ...state, ...patch }
+  return { ...next, filtered: visibleRows(next.rows, next.query, activeTab(next)), cursor: 0, offset: 0 }
+}
+
+// 검색어를 바꾸면 커서는 첫 행으로 돌아간다.
+// selected는 절대 건드리지 않는다 — 화면 밖 설치본이 조용히 사라지지 않게 하는 핵심 규칙이다.
+export function setQuery(state, query) {
+  return refocus(state, { query })
+}
+
+// 탭 이동은 순환한다 — 탭은 대여섯 개뿐이라 끝에서 막히면 오히려 불편하다.
+// 검색어는 유지한다: 같은 검색어로 탭을 훑는 것이 탭 UI의 본래 쓸모다.
+export function moveTab(state, delta) {
+  if (state.tabs.length === 0) return state
+  const n = state.tabs.length
+  const tabIndex = (((state.tabIndex + delta) % n) + n) % n
+  return tabIndex === state.tabIndex ? state : refocus(state, { tabIndex })
+}
+
+export function setTab(state, index) {
+  if (state.tabs.length === 0) return state
+  const tabIndex = clamp(index, 0, state.tabs.length - 1)
+  return tabIndex === state.tabIndex ? state : refocus(state, { tabIndex })
+}
+
+// 양 끝에서 멈춘다(순환 없음) — 76개 목록에서 한 칸 지나쳤을 때 반대편으로 튀면 길을 잃는다.
+export function move(state, delta) {
+  if (state.filtered.length === 0) return state
+  const cursor = clamp(state.cursor + delta, 0, state.filtered.length - 1)
+  return cursor === state.cursor ? state : { ...state, cursor }
+}
+
+// 커서가 항목 행일 때만 뒤집는다. 액션 행은 제거 개념이 없어 체크 대상이 아니다.
+export function toggle(state) {
+  const row = currentRow(state)
+  if (row?.kind !== 'item') return state
+  const selected = new Set(state.selected)
+  if (selected.has(row.id)) selected.delete(row.id)
+  else selected.add(row.id)
+  return { ...state, selected }
+}
+
+// 지금 보이는 항목 행 전체를 켜거나 끈다.
+// 보이는 것만 건드린다 — 화면 밖 설치본을 일괄 조작으로 날리지 않기 위해서다.
+export function toggleVisible(state, on) {
+  const items = state.filtered.filter((r) => r.kind === 'item')
+  if (items.length === 0) return state
+  const selected = new Set(state.selected)
+  const turnOn = on ?? !items.every((r) => selected.has(r.id))
+  for (const row of items) {
+    if (turnOn) selected.add(row.id)
+    else selected.delete(row.id)
+  }
+  return { ...state, selected }
+}
+
+// 행을 갈아끼운다(적용·액션 실행 뒤 재스캔). 검색어·활성 탭은 유지하고
+// 선택은 새 설치 상태로 재초기화한다.
+export function replaceRows(state, rows, selectedIds) {
+  const tabs = tabsOf(rows)
+  const tabIndex = clamp(tabs.indexOf(activeTab(state)), 0, Math.max(0, tabs.length - 1))
+  const filtered = visibleRows(rows, state.query, tabs[tabIndex])
+  return {
+    ...state,
+    rows,
+    tabs,
+    tabIndex,
+    filtered,
+    selected: new Set(selectedIds),
+    cursor: clamp(state.cursor, 0, Math.max(0, filtered.length - 1)),
+    offset: 0,
+  }
+}
+
+// 활성 탭의 목록에 그룹 헤더를 끼워 넣는다.
+// 그룹은 행의 group 필드다(design.md는 카테고리, 나머지는 없음) —
+// 탭이 이미 섹션을 갈라 놓았으므로 섹션 헤더는 더 이상 필요 없다.
+export function displayList(state) {
+  const tab = activeTab(state)
+  const totals = new Map()
+  for (const row of state.rows) {
+    if (row.section !== tab || !row.group) continue
+    totals.set(row.group, (totals.get(row.group) ?? 0) + 1)
+  }
+
+  const out = []
+  let header = null
+  state.filtered.forEach((row, index) => {
+    if (row.group && (!header || header.section !== row.group)) {
+      header = { type: 'header', section: row.group, shown: 0, total: totals.get(row.group) ?? 0 }
+      out.push(header)
+    }
+    if (!row.group) header = null
+    if (header) header.shown++
+    out.push({ type: 'row', row, index })
+  })
+  return out
+}
+
+// 커서가 창 밖으로 나가면 최소한으로 민다. 이미 보이면 그대로 둔다 — 목록이 덜 흔들린다.
+export function scroll(state, height) {
+  const lines = displayList(state)
+  const line = lines.findIndex((e) => e.type === 'row' && e.index === state.cursor)
+  if (line < 0) return state.offset === 0 ? state : { ...state, offset: 0 }
+
+  let offset = state.offset
+  // 커서 바로 위 그룹 헤더까지 같이 보이게 한다 — 어느 그룹을 보고 있는지 잃지 않게.
+  const top = lines[line - 1]?.type === 'header' ? line - 1 : line
+  if (top < offset) offset = top
+  else if (line >= offset + height) offset = line - height + 1
+  offset = clamp(offset, 0, Math.max(0, lines.length - height))
+  return offset === state.offset ? state : { ...state, offset }
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@rch4com/agent-setup",
+  "version": "1.0.0",
+  "description": "여러 코딩 에이전트 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 \"test/*.test.mjs\"",
+    "refresh-bundle": "node scripts/refresh-bundle.mjs"
+  },
+  "dependencies": {
+    "jsonc-parser": "^3.3.1",
+    "smol-toml": "^1.3.1"
+  }
+}