@rch4com/agent-setup 1.6.0 → 1.7.0

package/install.mjs

@@ -51,7 +51,7 @@ async function openTui(root, { dryRun, skillMode, designDirs, t, localeForced })
 // --list / --set 전용 비대화형 경로.
 async function runClassic(root, { dryRun, listOnly, setArg, t }) {
   const { loadItems } = await withDeps(() => import('./lib/catalog.mjs'), t)
-  const { scan, planChanges, apply } = await withDeps(() => import('./lib/engine.mjs'), t)
+  const { scan, planChanges, apply, assertExclusive } = await withDeps(() => import('./lib/engine.mjs'), t)
   const { plainLine } = await withDeps(() => import('./lib/tui/progress.mjs'), t)
   const items = await loadItems()
   const states = await scan(root, items)
@@ -68,6 +68,7 @@ async function runClassic(root, { dryRun, listOnly, setArg, t }) {
   const selectedIds = new Set(setArg.split(',').map((s) => s.trim()).filter(Boolean))
   const known = new Set(items.map((i) => i.id))
   for (const id of selectedIds) if (!known.has(id)) throw new LocalizedError('error.unknownItem', { id })
+  assertExclusive(items, selectedIds)
 
   const changes = planChanges(states, selectedIds)
   if (changes.length === 0) { console.log(t('apply.noChanges')); return }

package/lib/engine.mjs

@@ -1,5 +1,5 @@
 import { makeExec } from './catalog.mjs'
-import { createT, msg } from './i18n/index.mjs'
+import { createT, LocalizedError, msg } from './i18n/index.mjs'
 
 export async function scan(root, items) {
   const states = []
@@ -14,6 +14,21 @@ export async function scan(root, items) {
   return states
 }
 
+// item.exclusive는 "이 항목들은 같은 파일 하나를 두고 다툰다"는 표시다.
+// TUI는 고르는 순간에 배타를 지키지만(state.mjs), --set은 목록을 통째로 받는다 —
+// 둘을 함께 주면 나중 항목이 앞선 항목을 덮어써 성공한 것처럼 끝난다.
+// 조용히 하나를 고르는 대신 어느 쪽을 원했는지 되묻는다.
+export function assertExclusive(items, selectedIds) {
+  const groups = new Map()
+  for (const item of items) {
+    if (!item.exclusive || !selectedIds.has(item.id)) continue
+    groups.set(item.exclusive, [...(groups.get(item.exclusive) ?? []), item.id])
+  }
+  for (const ids of groups.values()) {
+    if (ids.length > 1) throw new LocalizedError('error.exclusiveItems', { ids: ids.join(', ') })
+  }
+}
+
 export function planChanges(states, selectedIds) {
   const changes = []
   for (const { item, status } of states) {

package/lib/gitmessage.mjs

@@ -0,0 +1,227 @@
+// 커밋 메시지 템플릿(.gitmessage.txt) 항목의 단일 출처.
+//
+// 한 파일에 언어가 다른 두 판이 있다 — 그래서 항목도 둘이지만 대상 파일은
+// 하나다. 둘을 동시에 고를 수 없게 하는 것은 TUI(state.mjs)와 --set
+// (engine.mjs의 assertExclusive)이 exclusive 키로 맡는다. 여기서는 "내가 쓴
+// 판이 지금 놓여 있는가"만 판정하고, 아니면 아무것도 건드리지 않는다.
+//
+// 항목 파일(lib/items/*.mjs)에 두지 않는 이유: loadItems가 그 디렉터리의
+// 모든 .mjs를 항목으로 읽어 검증하므로, 보조 모듈이 하나라도 섞이면 로드가
+// 통째로 실패한다.
+import { execFileSync } from 'node:child_process'
+import { readFileSync, rmSync, writeFileSync } from 'node:fs'
+import { normalizeBody } from './bootstrap/text.mjs'
+import { repoPath, repoPathStrict } from './context.mjs'
+import { LocalizedError, msg } from './i18n/index.mjs'
+
+export const GITMESSAGE_REL = '.gitmessage.txt'
+// 한 파일을 두고 다투는 항목들의 묶음 이름.
+export const GITMESSAGE_EXCLUSIVE = 'gitmessage'
+
+const CONFIG_KEY = 'commit.template'
+
+// 이 저장소 루트의 .gitmessage.txt와 같은 내용이다 —
+// test/items.gitmessage.test.mjs가 두 값이 갈리지 않게 고정한다.
+export const GITMESSAGE_KO = `# Commit message template ( * 주석 처리(#)된 부분들은 커밋 메시지에 포함되지 않으니 참고해서 작성)
+# <타입(<영역>)>: <주제>
+#  - 타입은 필수 작성. 해당 커밋의 성격을 나타내며 타입의 종류 중 하나만 선택, 영어 소문자로 시작
+#  - 영역은 필요 시 작성. 변경된 부분을 직접적으로 나타냄 ex) refactor(MemberService): loginMember 메소드 명을 login으로 수정
+#  - 주제는 필수 작성. 최대 50글자까지, 끝에 마침표 금지, 한글로 간단 명료하게 작성, 현재형 사용
+# 바로 밑줄에 작성
+
+# 바로 아래 한 줄 공백 유지 (타입 본문의 분리를 위함)
+
+################################
+# <본문> - 필요시 작성. 한 줄당 최대 72자까지, 72자 초과시 줄바꿈, ”왜”, “무엇을 위해” 작업했는지에 초점을 맞춰 작성
+# 바로 밑줄에 작성
+
+# 바로 아래 한 줄 공백 유지 (본문과 바닥글의 분리를 위함)
+
+################################
+# <바닥글> - 필요시 작성
+# 바로 밑줄에 작성 (이슈 해결 시에는 resolve: #99와 같이 작성)
+
+######## [타입 리스트] ############
+# feat: 새로운 기능 추가
+# fix: 버그 수정
+# style: 코드의 의미에 영향을 주지 않는 변경 사항(공백, 형식 지정, 세미콜론 누락 등), 클래스명 수정&가독성을 위해 변수명을 변경한 경우도 포함
+# refactor: 버그 수정, 기능 추가도 아닌 코드 변경
+# chore: 소스코드의 변경이 없으며 나열된 타입 이외 간단 변경
+# add: feat 이외의 부수적인 코드, 라이브러리 등을 추가한 경우, 새로운 파일(Component나 Activity 등)을 생성한 경우도 포함
+# remove: 코드, 파일을 삭제한 경우, 필요 없는 주석 삭제도 포함
+# move: fix, refactor 등과 관계 없이 코드, 파일 등의 위치를 이동하는 작업만 수행한 경우
+# comment: 필요한 주석을 추가, 수정한 경우( * 필요 없는 주석을 삭제한 경우는 remove)
+# perf: 성능을 향상시키는 코드 변경
+# test: 테스트 코드를 추가, 수정, 삭제한 경우
+# docs: 문서를 추가, 수정한 경우
+# design: CSS 등 사용자 UI 디자인을 추가, 수정한 경우
+# revert: 이전 커밋을 되돌린 경우
+# !BREAKING CHANGE: 커다란 API 변경의 경우 (MAJOR 버전과 상관 관계)
+# !HOTFIX: 급하게 치명적인 버그를 고쳐야하는 경우
+######## [커밋 메시지 예시] #########
+# fix: 로그인 기능 구현
+#
+# 로그인 시 JWT 발급
+#
+# resolve: #232
+# ref: #122
+# related to: #30, #50
+# ------------------
+# [* 지켜야 할 보편적 규칙]
+#  1. 언어는 한국어를 사용한다.
+#    - 예외 사항) 최초 커밋 메시지는 “Initial commit”으로 한다.
+#  2. 문장의 구성
+#    1) 문장은 간결하게 구성한다.
+#    2) 현재형을 사용한다.
+#  3. 작성한 당사자가 아닌 제 3자가 이해할 수 있도록 작성한다.
+#  4. 단순한 문장일수록 좋다.
+# ------------------
+# [* 커밋 타이밍]
+#  - 의미 있는 코드의 변화가 있다면 커밋을 진행한다.
+#  - 의미가 있다면 사소한 것을 커밋 하는 것은 전혀 잘못된 것이 아니다.
+#  - 다만 의미 없는 잦은 커밋은 히스토리 추적에 불편함을 주므로 의미 없는 커밋은 자제한다.
+################################
+`
+
+// 한국어판을 줄 단위로 옮긴 것이다. 타입 목록과 구획선은 같은 자리에 둔다 —
+// 두 판을 오가도 커밋 히스토리의 모양이 달라지지 않아야 한다.
+export const GITMESSAGE_EN = `# Commit message template ( * Lines that start with # are comments and never reach the commit message)
+# <type(<scope>)>: <subject>
+#  - Type is required. It names the nature of this commit. Pick exactly one from the list below, lowercase English
+#  - Scope is optional. It points straight at what changed ex) refactor(MemberService): rename loginMember to login
+#  - Subject is required. 50 characters at most, no trailing period, plain and clear, present tense
+# Write it on the line right below
+
+# Keep one blank line right below (it separates the subject from the body)
+
+################################
+# <Body> - optional. 72 characters per line at most, wrap past that, focus on "why" and "what for"
+# Write it on the line right below
+
+# Keep one blank line right below (it separates the body from the footer)
+
+################################
+# <Footer> - optional
+# Write it on the line right below (for a resolved issue, write resolve: #99)
+
+######## [Type list] ############
+# feat: add a new feature
+# fix: fix a bug
+# style: changes that do not affect the meaning of the code (whitespace, formatting, missing semicolons), including class or variable renames made for readability
+# refactor: a code change that is neither a bug fix nor a new feature
+# chore: no source change; small changes outside the types listed here
+# add: supporting code, libraries and the like added outside feat, including brand new files (a Component, an Activity)
+# remove: code or files deleted, including the removal of comments that are no longer needed
+# move: only moving code or files around, unrelated to fix, refactor and the rest
+# comment: a needed comment added or reworded ( * deleting a comment that is not needed is remove)
+# perf: a code change that improves performance
+# test: test code added, changed or deleted
+# docs: documentation added or changed
+# design: user-facing UI design added or changed (CSS and the like)
+# revert: an earlier commit rolled back
+# !BREAKING CHANGE: a large API change (tied to the MAJOR version)
+# !HOTFIX: an urgent fix for a critical bug
+######## [Example commit message] #########
+# fix: implement the login feature
+#
+# Issue a JWT on login
+#
+# resolve: #232
+# ref: #122
+# related to: #30, #50
+# ------------------
+# [* Universal rules]
+#  1. Write in English.
+#    - Exception) the very first commit message of a repository is "Initial commit".
+#  2. Sentence shape
+#    1) Keep sentences short.
+#    2) Use the present tense.
+#  3. Write so that a third party, not only the author, can follow it.
+#  4. The simpler the sentence, the better.
+# ------------------
+# [* When to commit]
+#  - Commit whenever there is a meaningful change in the code.
+#  - Committing something small is not wrong at all as long as it means something.
+#  - Frequent meaningless commits make the history hard to follow, so hold those back.
+################################
+`
+
+export const GITMESSAGE_BODIES = [GITMESSAGE_EN, GITMESSAGE_KO].map(normalizeBody)
+
+function readCurrent(root) {
+  try {
+    return readFileSync(repoPath(root, GITMESSAGE_REL), 'utf8')
+  } catch {
+    return null
+  }
+}
+
+// 저장소 설정만 본다. --local이 없으면 전역·시스템 설정까지 함께 읽혀,
+// 사용자가 ~/.gitconfig에 같은 값을 둔 것만으로 이 저장소가 설치된 것처럼
+// 보인다 — 이 도구는 저장소 안만 건드리므로 판정도 저장소 안만 봐야 한다.
+// 값이 없으면 git이 종료 코드 1로 끝나므로 예외가 곧 "설정 없음"이다.
+// git이 아예 없어도 같은 길로 떨어진다 — 그때는 상태 판정만 보수적으로
+// 흐를 뿐, 화면이 죽지는 않는다.
+function pointsHere(root) {
+  try {
+    const out = execFileSync('git', ['config', '--local', '--get', CONFIG_KEY], {
+      cwd: root, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'],
+    })
+    return out.trim() === GITMESSAGE_REL
+  } catch {
+    return false
+  }
+}
+
+// supports를 두지 않는다. 이 항목은 CLI 배선이 아니라 저장소 규약이라
+// "10개 중 몇 개"라는 물음 자체가 성립하지 않는다 — 힌트의 커버리지 줄,
+// 상세 패널의 배선표, CLI 필터가 모두 supports 없는 항목을 건너뛴다.
+export function defineGitmessage({ id, label, body, note }) {
+  const wanted = normalizeBody(body)
+
+  return {
+    id,
+    category: 'config',
+    label,
+    scope: 'project',
+    group: '__flow',
+    exclusive: GITMESSAGE_EXCLUSIVE,
+    unsupported: {},
+    note,
+
+    async detect({ root }) {
+      const current = readCurrent(root)
+      if (current === null || normalizeBody(current) !== wanted) return { status: 'absent' }
+      // 파일만 놓여 있고 git이 그것을 모르면 템플릿은 한 번도 뜨지 않는다.
+      // 설치됨으로 찍으면 "왜 안 뜨지"를 사용자가 혼자 풀어야 한다.
+      return pointsHere(root) ? { status: 'installed' } : { status: 'partial', detail: msg('item.gitmessage.unregistered') }
+    },
+
+    async install({ root, dryRun, exec, log = () => {}, t }) {
+      const current = readCurrent(root)
+      // 손으로 쓴 템플릿은 덮지 않는다 — 이 저장소의 다른 모든 쓰기가 지키는
+      // 규칙이다. 우리가 아는 두 판 사이를 오가는 것만 덮어쓰기로 본다.
+      if (current !== null && !GITMESSAGE_BODIES.includes(normalizeBody(current))) {
+        throw new LocalizedError('error.gitmessageForeign', { path: GITMESSAGE_REL })
+      }
+      if (dryRun) log(t('log.gitmessage.write', { path: GITMESSAGE_REL }))
+      else writeFileSync(repoPathStrict(root, GITMESSAGE_REL), wanted, { encoding: 'utf8' })
+
+      const r = await exec('git', ['config', '--local', CONFIG_KEY, GITMESSAGE_REL], { cwd: root })
+      if (!r.ok) throw new LocalizedError('error.gitmessageConfig', { output: r.output })
+    },
+
+    async uninstall({ root, dryRun, exec, log = () => {}, t }) {
+      const current = readCurrent(root)
+      // 같은 적용 안에서 다른 언어 판이 먼저 설치돼 파일을 갈아 끼웠을 수
+      // 있다(en 설치 → ko 제거 순서). 그때 지우면 방금 쓴 파일이 날아간다 —
+      // 내용이 내 판일 때만 손댄다.
+      if (current === null || normalizeBody(current) !== wanted) return
+      if (dryRun) log(t('log.gitmessage.remove', { path: GITMESSAGE_REL }))
+      else rmSync(repoPathStrict(root, GITMESSAGE_REL), { force: true })
+
+      // 남의 값이나 빈 값에 --unset을 걸면 git이 실패를 돌려준다.
+      if (pointsHere(root)) await exec('git', ['config', '--local', '--unset', CONFIG_KEY], { cwd: root })
+    },
+  }
+}

package/lib/i18n/catalog/en.mjs

@@ -261,6 +261,16 @@ export default {
   'item.skill.karpathy.note': 'behavioral guidelines that curb overbuilding and vague success criteria',
   'item.skill.gstack.note': 'repo-local clone + setup (needs bash; Git Bash on Windows). Runtime state (~/.gstack) may be created globally.',
   'item.skill.gsd.note': 'npx @opengsd/gsd-core, installed per project. Upstream supports 18 runtimes (Codex, Antigravity, …); this item wires --claude only',
+  // 커밋 템플릿은 CLI 배선이 아니라 저장소 규약이다 — note가 "무엇이 놓이고
+  // 무엇이 설정되는가"를 대신 말한다(상세 패널에 배선표가 없다).
+  'item.config.gitmessage.en.note': 'writes .gitmessage.txt in English and points git commit.template at it. One template for every tool and person in this repository — pick English or Korean, not both',
+  'item.config.gitmessage.ko.note': 'writes .gitmessage.txt in Korean and points git commit.template at it. One template for every tool and person in this repository — pick English or Korean, not both',
+  'item.gitmessage.unregistered': 'file is in place, but commit.template does not point at it yet',
+  'log.gitmessage.write': '  [dry-run] write {path}',
+  'log.gitmessage.remove': '  [dry-run] remove {path}',
+  'error.gitmessageForeign': '{path} already exists and was not written by this tool. A hand-written template is never overwritten — move or delete it first.',
+  'error.gitmessageConfig': 'git config commit.template failed: {output}',
+  'error.exclusiveItems': 'These items write the same file, so only one can be chosen: {ids}',
   'error.gstackClone': 'gstack clone failed: {output}',
   'error.gstackSetup': 'gstack setup failed: {output}',
   'error.gsdInstall': 'GSD install failed: {output}',
@@ -277,6 +287,7 @@ export default {
   'section.plugin': 'PLUGIN',
   'section.mcp': 'MCP',
   'section.skill': 'SKILL',
+  'section.config': 'CONFIG',
   'section.design': 'DESIGN.MD',
 
   // TUI 목록·검토 화면 문구. item.*는 agentHint가, action.*.label/hint는

package/lib/i18n/catalog/ko.mjs

@@ -254,6 +254,15 @@ export default {
   'item.skill.karpathy.note': '과설계와 모호한 완료 기준을 줄이는 행동 지침',
   'item.skill.gstack.note': '저장소 로컬 clone + setup (bash 필요, Windows는 Git Bash). 런타임 상태(~/.gstack)는 전역에 생길 수 있음.',
   'item.skill.gsd.note': 'npx @opengsd/gsd-core 프로젝트 로컬 설치. 상류는 Codex·Antigravity 등 18개 런타임을 지원합니다(이 항목은 --claude)',
+  // 커밋 템플릿은 CLI 배선이 아니라 저장소 규약이다 — en.mjs 쪽 주석 참고.
+  'item.config.gitmessage.en.note': '.gitmessage.txt를 영어판으로 쓰고 git commit.template이 그것을 가리키게 합니다. 저장소의 모든 도구와 사람이 함께 쓰는 한 벌이라 영어·한국어 중 하나만 고릅니다',
+  'item.config.gitmessage.ko.note': '.gitmessage.txt를 한국어판으로 쓰고 git commit.template이 그것을 가리키게 합니다. 저장소의 모든 도구와 사람이 함께 쓰는 한 벌이라 영어·한국어 중 하나만 고릅니다',
+  'item.gitmessage.unregistered': '파일은 놓였지만 commit.template이 아직 가리키지 않습니다',
+  'log.gitmessage.write': '  [dry-run] {path} 생성',
+  'log.gitmessage.remove': '  [dry-run] {path} 제거',
+  'error.gitmessageForeign': '{path}가 이미 있고 이 도구가 쓴 내용이 아닙니다. 손으로 쓴 템플릿은 덮어쓰지 않습니다 — 먼저 옮기거나 지우세요.',
+  'error.gitmessageConfig': 'git config commit.template 실패: {output}',
+  'error.exclusiveItems': '같은 파일을 쓰는 항목이라 하나만 고를 수 있습니다: {ids}',
   'error.gstackClone': 'gstack clone 실패: {output}',
   'error.gstackSetup': 'gstack setup 실패: {output}',
   'error.gsdInstall': 'GSD 설치 실패: {output}',
@@ -270,6 +279,7 @@ export default {
   'section.plugin': 'PLUGIN',
   'section.mcp': 'MCP',
   'section.skill': 'SKILL',
+  'section.config': 'CONFIG',
   'section.design': 'DESIGN.MD',
 
   // TUI 목록·검토 화면 문구. en.mjs 쪽 주석 참고.

package/lib/items/config.gitmessage.en.mjs

@@ -0,0 +1,10 @@
+import { defineGitmessage, GITMESSAGE_EN } from '../gitmessage.mjs'
+
+export default defineGitmessage({
+  id: 'config.gitmessage.en',
+  // 목록의 라벨 자리는 24칸이다 — 'Commit template (English)'는 한 칸이 넘쳐
+  // 잘린다. 이 도구가 이미 쓰는 --lang en|ko 표기를 따르고, 전문은 note가 편다.
+  label: 'Commit template (EN)',
+  body: GITMESSAGE_EN,
+  note: 'item.config.gitmessage.en.note',
+})

package/lib/items/config.gitmessage.ko.mjs

@@ -0,0 +1,11 @@
+import { defineGitmessage, GITMESSAGE_KO } from '../gitmessage.mjs'
+
+export default defineGitmessage({
+  id: 'config.gitmessage.ko',
+  // 라벨은 우리 카탈로그 데이터라 두 로케일에서 같은 값이 나간다 — 영어 화면에
+  // 한글('한국어')이 새면 그 자리는 번역 누락으로 읽힌다(i18n.en.test.mjs).
+  // 어느 언어판인지는 라벨의 (EN)·(KO)가, 무엇이 놓이는지는 note가 말한다.
+  label: 'Commit template (KO)',
+  body: GITMESSAGE_KO,
+  note: 'item.config.gitmessage.ko.note',
+})

package/lib/tui/rows.mjs

@@ -20,7 +20,7 @@ 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']
+export const SECTION_ORDER = [ACTION_SECTION, 'plugin', 'mcp', 'skill', 'config', 'design']
 
 // 탭 안쪽 소분류는 **성격**으로 가른다 — 같은 탭에 "무엇으로 설치되는가"가 같고
 // "무엇을 해 주는가"가 다른 항목이 섞여 있어서, 기구(plugin·mcp·skill)만으로는
@@ -123,6 +123,10 @@ function itemRow({ id, section, label, hint, fullHint = hint, statusDetail = nul
     id,
     section,
     group,
+    // 같은 파일을 두고 다투는 항목들의 묶음 이름(.gitmessage.txt의 두 언어판).
+    // 선택 배타는 state.mjs가 이 값만 보고 처리한다 — 순수 리듀서가 항목의
+    // 속내를 몰라도 되게 행에 미리 올려 둔다.
+    exclusive: item?.exclusive ?? null,
     label,
     hint,
     // 화면에 안 찍히는 긴 힌트. 비대화형 목록(printPlain)과 검색이 쓴다 —
@@ -142,6 +146,7 @@ function actionRow({ id, label, hint, run = null, t = createT('en') }) {
     id,
     section: ACTION_SECTION,
     group: null,
+    exclusive: null,
     label,
     hint,
     fullHint: hint,

package/lib/tui/state.mjs

@@ -135,13 +135,40 @@ export function move(state, delta) {
   return cursor === state.cursor ? state : { ...state, cursor }
 }
 
+// row.exclusive는 "이 항목들은 같은 파일 하나를 두고 다툰다"는 표시다
+// (.gitmessage.txt의 영어판·한국어판). 하나를 켜면 나머지는 꺼진다 — 둘을 함께
+// 고르면 나중에 적용된 쪽이 앞선 쪽을 조용히 덮어써, 화면의 체크 두 개가
+// 디스크의 한 파일을 가리키는 거짓말이 된다.
+//
+// 화면 밖(검색·CLI 필터로 가려진) 형제도 끈다. 보이는 것만 건드린다는 이
+// 모듈의 규칙에서 유일하게 벗어나는 자리인데, 여기서는 그래야 한다 —
+// 가려진 형제를 남겨 두면 사용자가 방금 명시적으로 고른 판이 적용 순서에
+// 따라 뒤집힐 수 있다.
+function dropSiblings(rows, selected, row) {
+  if (!row.exclusive) return
+  for (const other of rows) {
+    if (other.id !== row.id && other.exclusive === row.exclusive) selected.delete(other.id)
+  }
+}
+
+// 형제 중 하나라도 이미 켜져 있는가. 배타 묶음은 "전부 켜짐"이 불가능하므로
+// 전체 토글의 방향 판정도 이 기준으로 봐야 한다 — 아니면 Ctrl+A가 영원히
+// 켜기만 하고 끄지 못한다.
+function groupCovered(items, selected, row) {
+  return items.some((other) => other.exclusive === row.exclusive && selected.has(other.id))
+}
+
 // 커서가 항목 행일 때만 뒤집는다. 액션 행은 제거 개념이 없어 체크 대상이 아니다.
 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)
+  if (selected.has(row.id)) {
+    selected.delete(row.id)
+  } else {
+    selected.add(row.id)
+    dropSiblings(state.rows, selected, row)
+  }
   return { ...state, selected }
 }
 
@@ -151,10 +178,14 @@ 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))
+  const turnOn = on ?? !items.every((r) => selected.has(r.id) || (r.exclusive && groupCovered(items, selected, r)))
   for (const row of items) {
-    if (turnOn) selected.add(row.id)
-    else selected.delete(row.id)
+    if (!turnOn) { selected.delete(row.id); continue }
+    // 배타 묶음에서 이미 켜진 형제가 있으면 그 선택을 이긴다 — 전체 선택이
+    // 사용자가 고른 언어판을 목록 순서로 뒤집으면 안 된다.
+    if (row.exclusive && groupCovered(items, selected, row)) continue
+    selected.add(row.id)
+    dropSiblings(state.rows, selected, row)
   }
   return { ...state, selected }
 }

package/package.json

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