@rch4com/agent-setup 1.1.0 → 1.3.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 rch4com
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 rch4com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,55 +1,197 @@
-# agent-setup
-
-Claude Code, Codex, Gemini CLI, OpenCode, Kilo Code, Kiro, Kimi Code,
-Grok Build, Antigravity, GitHub Copilot CLI, VS Code Copilot을 **한 저장소에서
-함께** 쓰기 위한 저장소 범위 부트스트랩과 선택 항목 설치기입니다.
-
-공통 지침은 루트 `AGENTS.md` 하나, 공통 스킬은 `.agents/skills` 하나로 두고,
-도구별 설정 파일만 각 도구가 읽는 위치에 만듭니다.
-
-## 사용법
-
-Git 저장소 안에서 실행합니다.
-
-```bash
-# 배선 — 공통 지침·스킬·도구별 설정 파일을 만든다
-npx @rch4com/agent-setup bootstrap
-
-# 무엇이 만들어질지만 확인한다
-npx @rch4com/agent-setup bootstrap --dry-run
-
-# 플러그인·MCP·스킬·DESIGN.md를 골라 설치하는 대화형 화면
-npx @rch4com/agent-setup
-
-# 관리 파일을 최신 템플릿으로 갱신한다 (사용자가 고친 파일은 건드리지 않는다)
-npx @rch4com/agent-setup@latest update
-
-# 의도 / 실제 / 버전을 비교한다
-npx @rch4com/agent-setup status
-```
-
-설치하면 실행 명령은 `agent-setup`으로 짧아집니다. 이름에 스코프가 붙은 것은
-스코프 없는 `agent-setup`이 npm의 유사 이름 제한에 걸리기 때문입니다.
-
-## 안전 원칙
-
-- 반드시 Git 저장소 안에서만 실행되며, 저장소 루트 밖에는 쓰지 않습니다.
-- 홈 디렉터리의 글로벌 설정을 읽거나 수정하지 않습니다.
-- 기존 설정 파일을 덮어쓰지 않습니다.
-- 반복 실행할 수 있습니다.
-
-## 요구 사항
-
-Node.js 20 이상.
-
-## 문서
-
-생성되는 구조, 도구별 연결 방식, 설치 가능한 항목, DESIGN.md 라이브러리 등
-상세 문서는 GitHub에 있습니다.
-
-- [사용법과 생성 구조](https://github.com/rch4com/Agent-Setup/blob/main/AgentSetup-README.md)
-- [저장소](https://github.com/rch4com/Agent-Setup)
-
-## 라이선스
-
-MIT
+# agent-setup
+
+Repository-scoped bootstrap for using many coding agents in one repo — plus an
+optional picker for plugins, MCP servers, skills, and DESIGN.md documents.
+
+Supports **Claude Code, Codex, Gemini CLI, OpenCode, Kilo Code, Kiro, Kimi Code,
+Grok Build, Antigravity, GitHub Copilot CLI, and VS Code Copilot.**
+
+One shared instruction file (`AGENTS.md`) and one shared skills directory
+(`.agents/skills`) serve every tool. Only the per-tool config files are written,
+each in the location that tool actually reads.
+
+[한국어 문서는 아래에 있습니다 ↓](#한국어)
+
+## Usage
+
+Run inside a Git repository. Nothing needs to be copied into your repo.
+
+```bash
+# Wire up shared instructions, skills, and per-tool config files
+npx @rch4com/agent-setup bootstrap
+
+# Show what would be created, without writing anything
+npx @rch4com/agent-setup bootstrap --dry-run
+
+# Interactive picker for plugins, MCP servers, skills, and DESIGN.md
+npx @rch4com/agent-setup
+```
+
+The package name is scoped, but the installed command is just `agent-setup` —
+the long form only appears when invoking it through `npx`.
+
+The screen speaks your OS language by default, falling back to English. Pass
+`--lang en|ko` (or set `AGENT_SETUP_LANG`) to pick one for this run. The
+interactive screen's first row also switches it, and the choice is remembered
+in `.agent-kit/agent-setup.json`.
+
+## Keeping in sync
+
+```bash
+npx @rch4com/agent-setup@latest update             # pull in improved templates
+npx @rch4com/agent-setup@latest update --dry-run   # preview the changes
+npx @rch4com/agent-setup status                    # intent / reality / version
+```
+
+`update` only rewrites files that are **still exactly as this tool wrote them**.
+The decision is made per file, using hashes stored in the install record
+(`.agent-kit/agent-setup.json`, which is committed).
+
+| Situation | What happens |
+|---|---|
+| Hash matches the record | Replaced with the new template |
+| Hash differs | You edited it → **left alone**, reported as drift |
+| File missing | Created (this is how support for new tools arrives) |
+| No hash in the record | Origin unknown → left alone |
+
+The managed blocks in `CLAUDE.md` and `GEMINI.md` are replaced **between the
+markers only**, so anything you wrote around them survives.
+
+Hashes are computed after normalizing line endings to LF, so a CRLF checkout on
+Windows is not mistaken for drift.
+
+Use `update --force` to overwrite drifted files too. It refuses to run unless the
+working tree is clean, because git is the only way to undo it.
+
+### Adopting a repository that already uses this
+
+Repositories that vendored the installer have no record yet.
+
+```bash
+npx @rch4com/agent-setup bootstrap --adopt
+```
+
+This writes no files — it only creates the record. Files are adopted **only if
+they match this version's template**, because stamping a hash onto a file you had
+already customized would let the next `update` erase your changes. Unadopted files
+show up in `status` and can be pulled in later with `update --force`.
+
+## Safety
+
+- Runs only inside a Git repository, and never writes outside the repository root.
+- Never reads or modifies global configuration in your home directory.
+- Never overwrites existing configuration files.
+- Safe to run repeatedly.
+
+## Requirements
+
+Node.js 20 or later.
+
+## Documentation
+
+The generated layout, how each tool is wired, the installable items, and the
+DESIGN.md library are documented on GitHub.
+
+- [Usage and generated structure](https://github.com/rch4com/Agent-Setup/blob/main/AgentSetup-README.md)
+- [Repository](https://github.com/rch4com/Agent-Setup)
+
+## License
+
+MIT
+
+---
+
+# 한국어
+
+Claude Code, Codex, Gemini CLI, OpenCode, Kilo Code, Kiro, Kimi Code,
+Grok Build, Antigravity, GitHub Copilot CLI, VS Code Copilot을 **한 저장소에서
+함께** 쓰기 위한 저장소 범위 부트스트랩과 선택 항목 설치기입니다.
+
+공통 지침은 루트 `AGENTS.md` 하나, 공통 스킬은 `.agents/skills` 하나로 두고,
+도구별 설정 파일만 각 도구가 읽는 위치에 만듭니다.
+
+## 사용법
+
+Git 저장소 안에서 실행합니다. 저장소에 복사해 둘 파일이 없습니다.
+
+```bash
+# 배선 — 공통 지침·스킬·도구별 설정 파일을 만든다
+npx @rch4com/agent-setup bootstrap
+
+# 무엇이 만들어질지만 확인한다
+npx @rch4com/agent-setup bootstrap --dry-run
+
+# 플러그인·MCP·스킬·DESIGN.md를 골라 설치하는 대화형 화면
+npx @rch4com/agent-setup
+```
+
+패키지 이름에는 스코프가 붙지만 설치 후 실행 명령은 `agent-setup`입니다 —
+길어지는 것은 `npx`로 직접 부를 때뿐입니다.
+
+화면 언어는 기본으로 OS 언어를 따르고, 지원하지 않으면 영어로 갑니다.
+이번 실행만 다른 언어로 보려면 `--lang en|ko`를 주거나 `AGENT_SETUP_LANG`을
+설정하세요. 대화형 화면의 첫 행에서도 바꿀 수 있고, 고른 언어는
+`.agent-kit/agent-setup.json`에 저장되어 다음 실행에도 이어집니다.
+
+## 최신으로 갱신하기
+
+```bash
+npx @rch4com/agent-setup@latest update             # 개선된 템플릿을 받아온다
+npx @rch4com/agent-setup@latest update --dry-run   # 무엇이 바뀔지만 확인
+npx @rch4com/agent-setup status                    # 의도 / 실제 / 버전 비교
+```
+
+`update`는 **우리가 쓴 그대로인 파일만** 다시 씁니다. 판정은 파일마다 따로 하며,
+근거는 커밋되는 설치 기록(`.agent-kit/agent-setup.json`)에 남은 해시입니다.
+
+| 상황 | 처리 |
+|---|---|
+| 기록된 해시와 일치 | 새 템플릿으로 교체 |
+| 해시가 다름 | 사용자가 고쳤음 → **건드리지 않고** 드리프트로 보고 |
+| 파일이 없음 | 새로 생성 (새 도구 지원이 이 경로로 들어옵니다) |
+| 기록에 해시가 없음 | 출처 불명 → 건드리지 않음 |
+
+`CLAUDE.md`·`GEMINI.md`의 관리 블록은 **마커 사이만** 교체하므로 주변에 쓴
+내용은 그대로 남습니다.
+
+해시는 줄바꿈을 LF로 정규화한 뒤 계산하므로, Windows에서 CRLF로 체크아웃해도
+드리프트로 오판하지 않습니다.
+
+드리프트 파일까지 반영하려면 `update --force`를 씁니다. git이 유일한 되돌리기
+수단이므로 워킹트리가 깨끗할 때만 동작합니다.
+
+### 이미 쓰던 저장소 끌어오기
+
+설치기를 복사해 쓰던 저장소에는 기록이 없습니다.
+
+```bash
+npx @rch4com/agent-setup bootstrap --adopt
+```
+
+파일을 만들지 않고 기록만 만듭니다. **이 버전의 템플릿과 같은 파일만** 채택하는데,
+이미 고쳐 둔 파일에 해시를 박으면 다음 `update`가 그 수정을 지워버리기
+때문입니다. 채택되지 않은 파일은 `status`에 나오고, 원할 때 `update --force`로
+들여올 수 있습니다.
+
+## 안전 원칙
+
+- 반드시 Git 저장소 안에서만 실행되며, 저장소 루트 밖에는 쓰지 않습니다.
+- 홈 디렉터리의 글로벌 설정을 읽거나 수정하지 않습니다.
+- 기존 설정 파일을 덮어쓰지 않습니다.
+- 반복 실행할 수 있습니다.
+
+## 요구 사항
+
+Node.js 20 이상.
+
+## 문서
+
+생성되는 구조, 도구별 연결 방식, 설치 가능한 항목, DESIGN.md 라이브러리 등
+상세 문서는 GitHub에 있습니다.
+
+- [사용법과 생성 구조](https://github.com/rch4com/Agent-Setup/blob/main/AgentSetup-README.md)
+- [저장소](https://github.com/rch4com/Agent-Setup)
+
+## 라이선스
+
+MIT

package/install.mjs

@@ -1,101 +1,152 @@
-#!/usr/bin/env node
-import { findRepoRoot } from './lib/context.mjs'
-import { runBootstrap } from './lib/bootstrap/flow.mjs'
-import { withDeps } from './lib/deps.mjs'
-import {
-  BOOTSTRAP_USAGE, DESIGN_USAGE, ROOT_USAGE, STATUS_USAGE, UPDATE_USAGE,
-  parseBootstrapArgs, parseDesignArgs, parseRootArgs, parseStatusArgs, parseUpdateArgs,
-} from './lib/args.mjs'
-
-// 위 정적 import는 전부 의존성 없는 모듈이다 — 부트스트랩은 npm install 없이 돌아야 하고,
-// bootstrap.isolation.test.mjs가 이 불변식을 지킨다. lib/ 나머지는 동적 import로만 닿는다.
-
-const STATUS_LABEL = { installed: '설치됨', partial: '일부 설치됨', absent: '미설치' }
-const ACTION_LABEL = { install: '설치', complete: '보완 설치', uninstall: '제거' }
-
-// 대화형 화면은 TUI가 맡는다.
-async function openTui(root, { dryRun, skillMode, designDirs }) {
-  const { runTui } = await withDeps(() => import('./lib/tui/run.mjs'))
-  // skillMode는 화면 안의 '부트스트랩 실행' 작업이 쓴다. design 경로에서는
-  // 없으므로 undefined가 넘어가고 runTui의 기본값(auto)이 적용된다.
-  await runTui(root, { dryRun, skillMode, designDirs })
-}
-
-// --list / --set 전용 비대화형 경로.
-async function runClassic(root, { dryRun, listOnly, setArg }) {
-  const { loadItems } = await withDeps(() => import('./lib/catalog.mjs'))
-  const { scan, planChanges, apply } = await withDeps(() => import('./lib/engine.mjs'))
-  const items = await loadItems()
-  const states = await scan(root, items)
-
-  if (listOnly) {
-    for (const s of states) console.log(`${STATUS_LABEL[s.status].padEnd(7)} ${s.item.id} — ${s.item.label}${s.detail ? ` (${s.detail})` : ''}`)
-    return
-  }
-
-  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 Error(`알 수 없는 항목: ${id}`)
-
-  const changes = planChanges(states, selectedIds)
-  if (changes.length === 0) { console.log('변경할 항목이 없습니다.'); return }
-
-  const results = await apply(root, changes, { dryRun })
-  for (const r of results) {
-    console.log(`${r.ok ? '✔' : '✖'} ${ACTION_LABEL[r.action]} ${r.item.label}${r.message ? ` — ${r.message}` : ''}`)
-  }
-
-  const after = await scan(root, items)
-  console.log('\n최종 상태:')
-  for (const s of after) console.log(`  ${STATUS_LABEL[s.status].padEnd(7)} ${s.item.label}`)
-  console.log('\n설정 파일 변경 내용은 git diff로 확인할 수 있습니다.')
-  if (results.some((r) => !r.ok)) process.exitCode = 1
-}
-
-async function main() {
-  const argv = process.argv.slice(2)
-  const root = findRepoRoot()
-
-  if (argv[0] === 'bootstrap') {
-    const opts = parseBootstrapArgs(argv.slice(1))
-    if (opts.help) { console.log(BOOTSTRAP_USAGE); return }
-    const { failed } = runBootstrap(root, opts)
-    if (failed.length > 0) process.exitCode = 1
-    return
-  }
-
-  if (argv[0] === 'update') {
-    const opts = parseUpdateArgs(argv.slice(1))
-    if (opts.help) { console.log(UPDATE_USAGE); return }
-    // 항목 수렴을 위해 스캔이 필요해 의존성 있는 모듈에 닿는다.
-    const { runUpdate } = await withDeps(() => import('./lib/update.mjs'))
-    await runUpdate(root, opts)
-    return
-  }
-
-  if (argv[0] === 'status') {
-    const opts = parseStatusArgs(argv.slice(1))
-    if (opts.help) { console.log(STATUS_USAGE); return }
-    // 항목 스캔이 필요해 의존성 있는 모듈에 닿는다.
-    const { runStatus } = await withDeps(() => import('./lib/status.mjs'))
-    await runStatus(root, opts)
-    return
-  }
-
-  if (argv[0] === 'design') {
-    const opts = parseDesignArgs(argv.slice(1))
-    if (opts.help) { console.log(DESIGN_USAGE); return }
-    // 플래그 없는 `design`은 통합 화면을 연다 — DESIGN.MD 섹션이 그 안에 있다.
-    if (opts.interactive) return openTui(root, opts)
-    const { runDesign } = await withDeps(() => import('./lib/design-md/flow.mjs'))
-    await runDesign(root, opts)
-    return
-  }
-
-  const opts = parseRootArgs(argv)
-  if (opts.help) { console.log(ROOT_USAGE); return }
-  if (opts.interactive) return openTui(root, opts)
-  await runClassic(root, opts)
-}
-
-main().catch((err) => { console.error(err.message); process.exit(1) })
+#!/usr/bin/env node
+import { findRepoRoot } from './lib/context.mjs'
+import { runBootstrap } from './lib/bootstrap/flow.mjs'
+import { readRecord } from './lib/bootstrap/record.mjs'
+import { withDeps } from './lib/deps.mjs'
+import { LocalizedError, createT, isLocaleForced, resolveLocale, toText } from './lib/i18n/index.mjs'
+import { detectLocale } from './lib/i18n/detect.mjs'
+import { labelWidth, pad } from './lib/width.mjs'
+import {
+  bootstrapUsage, designUsage, rootUsage, statusUsage, updateUsage,
+  parseBootstrapArgs, parseDesignArgs, parseRootArgs, parseStatusArgs, parseUpdateArgs, preScanLang,
+} from './lib/args.mjs'
+
+// 위 정적 import는 전부 의존성 없는 모듈이다 — 부트스트랩은 npm install 없이 돌아야 하고,
+// bootstrap.isolation.test.mjs가 이 불변식을 지킨다. lib/ 나머지는 동적 import로만 닿는다.
+
+// 저장소 탐지와 기록 읽기는 "있으면 쓴다"로만 한다. 여기서 던지면 언어를
+// 정하기도 전에 죽어, 한국어를 모르는 사람이 한국어 오류를 보게 된다.
+// 삼킨 오류는 사라지지 않는다 — 기록을 실제로 쓰는 명령이 readRecord를
+// 정식으로 다시 불러 그때 지역화된 오류로 던진다.
+function tryFindRepoRoot() {
+  try { return findRepoRoot() } catch { return null }
+}
+
+function tryReadRecord(root) {
+  try { return readRecord(root) } catch { return null }
+}
+
+// main() 안의 지역변수로 두면 아래 catch에서 안 보인다. main()이 던지는
+// 모든 오류가 이 catch를 거치므로, --lang만 주고 AGENT_SETUP_LANG은 안 준
+// 사용자의 오류 메시지가 flag를 반영하지 못해 요청한 언어와 어긋난다.
+const argv = process.argv.slice(2)
+const flag = preScanLang(argv)
+
+// main()이 로케일을 확정하는 즉시 여기에 담고, 아래 catch가 이 값을 쓴다.
+// main() 안의 지역변수로만 두면 catch에서 보이지 않아, 오류 메시지가 성공
+// 경로와 다른 언어로 나온다.
+let sessionT = null
+
+// 상태 라벨은 로케일마다 길이가 다르다 — 폭을 상수로 박으면 한쪽이 어긋난다.
+const STATUS_KEYS = ['status.installed', 'status.partial', 'status.absent']
+
+// 대화형 화면은 TUI가 맡는다.
+async function openTui(root, { dryRun, skillMode, designDirs, t, localeForced }) {
+  const { runTui } = await withDeps(() => import('./lib/tui/run.mjs'), t)
+  // skillMode는 화면 안의 '부트스트랩 실행' 작업이 쓴다. design 경로에서는
+  // 없으므로 undefined가 넘어가고 runTui의 기본값(auto)이 적용된다.
+  await runTui(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 items = await loadItems()
+  const states = await scan(root, items)
+  const statusWidth = labelWidth(t, STATUS_KEYS)
+
+  if (listOnly) {
+    for (const s of states) {
+      const detail = toText(t, s.detail)
+      console.log(`${pad(t(`status.${s.status}`), statusWidth)} ${s.item.id} — ${s.item.label}${detail ? ` (${detail})` : ''}`)
+    }
+    return
+  }
+
+  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 })
+
+  const changes = planChanges(states, selectedIds)
+  if (changes.length === 0) { console.log(t('apply.noChanges')); return }
+
+  const results = await apply(root, changes, { dryRun, t })
+  for (const r of results) {
+    console.log(`${r.ok ? '✔' : '✖'} ${t(`change.${r.action}`)} ${r.item.label}${r.message ? ` — ${toText(t, r.message)}` : ''}`)
+  }
+
+  const after = await scan(root, items)
+  console.log(`\n${t('apply.finalState')}`)
+  for (const s of after) console.log(`  ${pad(t(`status.${s.status}`), statusWidth)} ${s.item.label}`)
+  console.log(`\n${t('apply.seeGitDiff')}`)
+  if (results.some((r) => !r.ok)) process.exitCode = 1
+}
+
+async function main() {
+  const root = tryFindRepoRoot()
+  const record = root === null ? null : tryReadRecord(root)
+  const locale = resolveLocale({ flag, env: process.env, record, detected: detectLocale(process.env) })
+  const t = createT(locale)
+  sessionT = t
+  // 플래그·환경변수가 로케일을 못박으면 TUI에서 고른 언어는 이번 실행에만
+  // 살아남는다. 조용히 되돌아가는 대신 화면이 그 사실을 알리게 한다.
+  const localeForced = isLocaleForced({ flag, env: process.env })
+
+  if (root === null) throw new LocalizedError('error.notGitRepo')
+
+  if (argv[0] === 'bootstrap') {
+    const opts = parseBootstrapArgs(argv.slice(1), t)
+    if (opts.help) { console.log(bootstrapUsage(t)); return }
+    const { failed } = runBootstrap(root, { ...opts, t })
+    if (failed.length > 0) process.exitCode = 1
+    return
+  }
+
+  if (argv[0] === 'update') {
+    const opts = parseUpdateArgs(argv.slice(1), t)
+    if (opts.help) { console.log(updateUsage(t)); return }
+    // 항목 수렴을 위해 스캔이 필요해 의존성 있는 모듈에 닿는다.
+    const { runUpdate } = await withDeps(() => import('./lib/update.mjs'), t)
+    await runUpdate(root, { ...opts, t })
+    return
+  }
+
+  if (argv[0] === 'status') {
+    const opts = parseStatusArgs(argv.slice(1), t)
+    if (opts.help) { console.log(statusUsage(t)); return }
+    // 항목 스캔이 필요해 의존성 있는 모듈에 닿는다.
+    const { runStatus } = await withDeps(() => import('./lib/status.mjs'), t)
+    await runStatus(root, { ...opts, t })
+    return
+  }
+
+  if (argv[0] === 'design') {
+    const opts = parseDesignArgs(argv.slice(1), t)
+    if (opts.help) { console.log(designUsage(t)); return }
+    // 플래그 없는 `design`은 통합 화면을 연다 — DESIGN.MD 섹션이 그 안에 있다.
+    if (opts.interactive) return openTui(root, { ...opts, t, localeForced })
+    const { runDesign } = await withDeps(() => import('./lib/design-md/flow.mjs'), t)
+    await runDesign(root, { ...opts, t })
+    return
+  }
+
+  const opts = parseRootArgs(argv, t)
+  if (opts.help) { console.log(rootUsage(t)); return }
+  if (opts.interactive) return openTui(root, { ...opts, t, localeForced })
+  await runClassic(root, { ...opts, t })
+}
+
+// 오류는 한 곳에서 지역화한다. LocalizedError의 .message는 영어라
+// 스택 트레이스가 읽히고, 여기서 활성 로케일로 다시 렌더한다.
+//
+// 기록 파일은 다시 읽지 않는다 — 오류 경로에서 그 기록을 실제로 쓴 명령이
+// 실패했을 수도 있는 파일을 재차 읽을 이유가 없다. 대신 main()이 이미 정한
+// t를 그대로 쓴다. 재차 해석하면 record가 빠져, TUI에서 한국어를 고른 팀이
+// 성공은 한국어로 오류는 영어로 받는다. sessionT가 비어 있는 경우는 로케일
+// 확정 전에 던진 때뿐이라 플래그·환경변수·OS만으로 정한다.
+main().catch((err) => {
+  const t = sessionT ?? createT(resolveLocale({ flag, env: process.env, detected: detectLocale(process.env) }))
+  console.error(err.key ? t(err.key, err.params) : err.message)
+  process.exit(1)
+})