discord-agent-bridge 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 10000DOO
+
+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

@@ -0,0 +1,195 @@
+# discord-agent-bridge
+
+> Self-hosted Discord bot that runs AI coding agents — Claude Code, Codex, and more — per channel. Role-based access, multi-server, extensible.
+
+**채널마다 Claude Code / Codex 같은 AI 코딩 에이전트를 붙여 쓰는 셀프호스팅 Discord 봇입니다.** 내 PC에서 실행되고, 역할 기반 권한 · 다중 서버 · 확장 가능 구조를 가집니다.
+
+- 현재 지원: **Claude Code**, **Codex**
+- 확장: 모드 플러그인 추가로 다른 에이전트(예: opencode) 연결 가능
+
+> 🚧 **상태: 개발 중 (Phase 1).** 아직 npm에 배포되지 않았습니다 — 지금은 아래 **"소스에서 실행"** 방법으로만 동작합니다. `npx` 배포는 완성 후 제공됩니다. 이 가이드는 완성 시점의 사용 흐름 기준입니다.
+
+---
+
+## 이게 뭐예요?
+
+Discord 채널에서 대화하듯 메시지를 보내면, 내 컴퓨터에서 Claude Code(또는 Codex)가 그 프로젝트 폴더를 대상으로 작업해 주는 봇입니다.
+
+- **채널 = 세션 = 프로젝트 하나.** 채널을 만들 때 작업 폴더와 백엔드(Claude/Codex)를 정합니다.
+- **여러 서버**에 같은 봇을 초대해 쓸 수 있고, **서버/프로젝트마다 설정이 따로** 적용됩니다.
+- **역할(Role)로 누가 쓸 수 있는지** 통제합니다.
+
+---
+
+## 준비물
+
+- **Node.js 20 이상**
+- 사용할 백엔드에 맞는 CLI가 **설치 + 로그인**되어 있어야 합니다:
+  - **Claude 모드** → [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 인증 (`claude` 로그인 또는 `ANTHROPIC_API_KEY`). 사용량/한도 패널을 보려면 **Claude Pro/Max 구독 로그인**이 필요합니다.
+  - **Codex 모드** → `codex` CLI 설치 + 로그인.
+- **Discord 봇 토큰** (아래 1단계에서 발급)
+
+---
+
+## 1단계 — Discord 봇 만들기 (Developer Portal)
+
+봇을 직접 하나 만들어야 합니다. 5분이면 됩니다.
+
+1. **[Discord Developer Portal](https://discord.com/developers/applications)** 접속 → 오른쪽 위 **New Application** → 이름 입력(예: `my-agent-bot`) → **Create**.
+2. 왼쪽 메뉴 **Bot** 탭 → **Reset Token** → 나오는 **토큰을 복사**해 안전한 곳에 보관.
+   - ⚠️ 이 토큰은 비밀번호입니다. 노출되면 즉시 **Reset Token**으로 재발급하세요.
+3. 같은 **Bot** 탭 아래 **Privileged Gateway Intents**:
+   - ✅ **MESSAGE CONTENT INTENT** — **필수** (봇이 메시지 내용을 읽어야 함)
+   - ✅ **SERVER MEMBERS INTENT** — 권장 (역할 기반 권한 확인에 사용)
+   - 켜고 **Save Changes**.
+4. 왼쪽 **OAuth2** 탭 → **Client ID(Application ID)** 복사 (셋업에 필요).
+5. **초대 링크 만들기** — OAuth2 → **URL Generator**:
+   - **Scopes**: `bot`, `applications.commands`
+   - **Bot Permissions**: `Manage Channels`, `Send Messages`, `Embed Links`, `Attach Files`, `Read Message History`, `Create Public Threads`, `Send Messages in Threads`, `Manage Threads`, `Add Reactions`
+   - 생성된 URL을 브라우저에 붙여넣어 **내 서버에 초대**.
+   - (셋업 마법사가 이 초대 링크를 자동 생성해 주기도 합니다 — 2단계 참고.)
+
+---
+
+## 2단계 — 설치 & 실행
+
+### (완성 후) npx로 실행
+```bash
+# 최초 실행 — 그냥 실행하면 셋업 마법사가 자동으로 뜬 뒤 이어서 봇이 시작됩니다.
+# (토큰/Client ID 입력, 인텐트 확인, 초대 링크 생성 — 기본값은 안 물어봄)
+npx discord-agent-bridge@latest
+
+# 이후 실행 — 이미 설정돼 있으면 바로 봇이 시작됩니다.
+npx discord-agent-bridge@latest
+
+# 다시 설정만 하고 싶을 때 (봇은 시작하지 않음)
+npx discord-agent-bridge@latest --setup
+```
+
+### (지금) 소스에서 실행
+```bash
+git clone https://github.com/10000DOO/discord-agent-bridge.git
+cd discord-agent-bridge
+npm install
+npm run build
+
+node dist/cli.js           # 최초 1회: 셋업 마법사 자동 실행 → 이어서 봇 시작 / 이후: 바로 봇 시작
+node dist/cli.js --setup   # 설정만 다시 (봇은 시작 안 함)
+```
+
+**셋업 마법사(`--setup`)** 가 물어보는 것 — **토큰(비밀)만 터미널에서 입력**합니다. 그 외 값은 하나도 안 물어봅니다:
+1. Discord 봇 **토큰** (비밀 → 터미널에서만 붙여넣기)
+2. **Client ID**
+3. Message Content Intent 켰는지 확인
+4. 초대 URL 생성 → 서버에 초대
+
+> **역할도, 기본값도 터미널에서 안 정합니다.** 봇을 서버에 초대한 뒤 Discord에서 **`/config`** 명령으로 설정하세요:
+> - **역할 티어** — 역할 이름을 **클릭**해 지정(역할 ID 복사·개발자 모드 불필요). 지정 전에는 **모두 거부(deny-by-default)**.
+> - **기본값** — **기본 백엔드·모델·권한 모드·언어(locale)** 는 드롭다운에서 고르면 **바로 저장**되고, **Codex 기본 경로(codexHome)** 는 "Codex 경로 설정" 버튼 → 입력창(모달)에서 지정합니다. 언어는 `한국어 (ko)` / `English (en)` 중에서 선택합니다.
+
+설정은 `~/.discord-agent-bridge/` 에 저장됩니다(토큰 파일 권한 600). 역할·기본값은 서버별로 `servers/<guildId>.json` 에 저장됩니다.
+
+---
+
+## 3단계 — Discord에서 사용하기
+
+봇이 서버에 들어오고 실행 중이면 (권장 순서: **초대 → `/init` → `/config` → `/agent start`**):
+
+1. **`/init`** (관리자) → 컨트롤 채널(`#session-generator`)과 세션 카테고리를 만듭니다. 다시 실행해도 기존 채널을 재사용합니다(중복 생성 없음).
+2. **`/config`** (관리자) → 역할 티어·기본값을 지정합니다. (서버 관리자(Administrator)는 역할 설정 없이도 항상 사용할 수 있습니다.)
+3. `#session-generator` 에서 **`/agent start`** → **마법사**가 순서대로 안내합니다:
+   **작업 폴더 선택 → 백엔드(Claude / Codex) → 모델 → 권한 모드/프로필**. 확인하면 프로젝트 폴더 이름으로 **전용 세션 채널(`proj-<폴더>`)이 새로 생성**되고 그 채널에 바인딩됩니다.
+4. 만들어진 세션 채널에서 **그냥 메시지로 대화**하면 됩니다. Claude 모드는 스트리밍 출력·툴 실행 스레드·권한 승인 버튼이 뜹니다.
+5. 필요할 때 명령어 사용.
+
+### 주요 명령어
+| 명령어 | 설명 |
+|---|---|
+| `/init` | (관리자) 컨트롤 채널 + 세션 카테고리 생성 (재실행 시 재사용) |
+| `/agent start` | 새 세션 시작 — 마법사 확인 시 전용 세션 채널을 새로 생성 |
+| `/agent resume` | 이전 세션 이어하기 |
+| `/agent close` | 세션 종료 + 세션 채널 삭제 |
+| `/mode <claude\|codex>` | 백엔드 전환 (⚠️ 새 대화로 시작 — 이전 맥락 미승계) |
+| `/mode perm <모드\|프로필>` | 권한 모드/프로필 전환 (세션 유지) |
+| `/stop` | 현재 세션 즉시 중단 (킬 스위치) |
+| `/stop-all` | (관리자) 모든 세션 중단 |
+| `/config` | (관리자) 역할 티어 + 기본값(백엔드·모델·권한 모드·언어·Codex 경로) 설정 — 역할은 **클릭**, 기본값은 드롭다운/모달에서 지정 |
+
+### 권한 모드 (세션이 얼마나 자율적인지)
+- `default` — 도구 실행 전마다 **Allow/Deny 버튼**으로 확인 (가장 안전)
+- `acceptEdits` — 파일 수정은 자동 수락
+- `plan` — 먼저 계획만 세우고 실행은 보류
+- `bypassPermissions` — 전부 자동 (신뢰하는 프로젝트에서만)
+
+(Codex는 CLI의 승인·샌드박스 모드로 매핑됩니다.)
+
+---
+
+## 권한 & 역할 설정 (중요)
+
+이 봇은 **당신 PC에서, 당신 계정 권한으로** 코드를 실행합니다. 즉 봇에게 명령할 수 있는 사람은 **당신 컴퓨터에서 명령을 실행할 수 있는 사람**입니다. 그래서 역할 통제가 필수입니다.
+
+- **역할 티어 3단계** — Discord에서 **`/config`** 로 역할 이름을 **클릭**해 지정합니다(역할 ID·개발자 모드 불필요). admin ⊇ execute ⊇ read-only:
+  - **admin** — 설정/`stop-all`/`config` 등 관리
+  - **execute** — 세션 시작·명령 실행
+  - **read-only** — 읽기만
+  - > `/config` 는 처음엔 **서버 관리자(Administrator)** 권한이 있는 사람만 열 수 있고(허용 목록이 비어 있어도 부트스트랩 가능), 이후엔 admin 티어도 사용할 수 있습니다.
+- **기본은 거부(deny-by-default)** — 허용 목록에 없는 사람은 아무것도 못 합니다. `/config` 로 지정하기 전에는 아무도 실행할 수 없습니다.
+- **프로젝트별 접근 제어(ACL)** — 특정 프로젝트를 지정한 역할/사람만 쓰게 할 수 있습니다.
+- **감사 로그** — 누가 언제 무엇을 했는지 `~/.discord-agent-bridge/audit/` 에 기록됩니다.
+
+> ⚠️ **보안 주의:** 신뢰하지 않는 서버에 봇을 초대하거나 execute 역할을 너무 넓게 주지 마세요. 작업 폴더 밖(예: `~/.ssh`)은 봇이 접근하지 못하도록 기본 차단되어 있습니다.
+
+---
+
+## Claude 모드 vs Codex 모드
+
+| | Claude 모드 | Codex 모드 |
+|---|---|---|
+| 실시간 스트리밍 | ✅ | ❌ (최종 결과 위주) |
+| 툴 실행 스레드 | ✅ | ❌ |
+| 권한 승인 버튼 | ✅ | ❌ (승인/샌드박스 모드로 대체) |
+| 세션 이어하기 | ✅ | ✅ |
+| **사용량/한도 표시** | ✅ (5시간·주간·컨텍스트) | ❌ (Codex CLI 제약) |
+
+### 터미널에서 쓰던 거랑 똑같나요?
+
+- **Claude 모드** — 터미널의 `claude`와 **같은 엔진**(공식 Claude Agent SDK)을 사용합니다. 프로젝트의 `.claude/` 설정을 그대로 읽어 **서브에이전트·스킬·훅·MCP가 동일하게** 동작하도록 만듭니다. 달라지는 건 입력이 Discord 메시지, 출력이 임베드/스레드라는 **표현 방식**뿐입니다. (터미널에서 타이핑하는 TUI 전용 슬래시 명령은 그대로 치는 방식이 아니라 SDK 방식으로 처리됩니다.)
+- **Codex 모드** — `codex exec`(비대화형)로 구동합니다. 같은 Codex 엔진에 설정/MCP를 로드하지만, **비대화형 모드가 인터랙티브 모드와 일부 다를 수 있어**(승인 방식·특정 기능 등) **서브에이전트·스킬·MCP가 그대로 되는지는 Phase 2에서 실제 `codex` CLI로 검증**한 뒤 확정합니다. 검증 전까지는 완전 동일하다고 보장하지 않습니다.
+
+---
+
+## 설정 파일 위치
+
+```
+~/.discord-agent-bridge/
+├─ config.json            # 봇 토큰·Client ID·기본값·한도 (권한 600)
+├─ servers/<guildId>.json # 서버별 역할 티어·기본값 + /init 채널 구조(control/sessions) ID (권한 600)
+├─ state.json             # 채널↔세션 바인딩 (재시작 후 자동 복구)
+└─ audit/audit.jsonl      # 감사 로그
+```
+설정은 **전역 → 서버 → 프로젝트** 순으로 덮어써집니다.
+
+---
+
+## 문제 해결
+
+- **봇이 메시지에 반응하지 않아요** → Developer Portal에서 **Message Content Intent**가 켜져 있는지 확인.
+- **슬래시 명령이 안 보여요** → 초대 시 `applications.commands` 스코프를 포함했는지 확인(등록에 몇 분 걸릴 수 있음).
+- **권한 오류로 채널 생성 실패** → 봇에게 `Manage Channels` 권한이 있는지 확인.
+- **사용량 패널이 안 떠요** → Claude Pro/Max **구독 로그인**(`~/.claude`) 상태여야 합니다. API 키만 쓰면 이 패널은 숨겨집니다(정상).
+
+---
+
+## 개발
+
+```bash
+npm install
+npm run dev         # tsx watch (개발 모드)
+npm run typecheck   # 타입 검사
+npm run test        # 테스트 (vitest)
+```
+
+## 라이선스
+
+MIT

package/dist/app.js

@@ -0,0 +1,210 @@
+import { PermissionFlagsBits } from 'discord.js';
+import { ConfigStore } from './core/config.js';
+import { StateStore } from './core/state/store.js';
+import { ChannelRegistry } from './core/channelRegistry.js';
+import { EventBus } from './core/eventBus.js';
+import { ConfigResolver } from './core/configResolver.js';
+import { PermissionResolver } from './core/permissionResolver.js';
+import { Authorizer } from './core/auth.js';
+import { AuditLog } from './core/auditLog.js';
+import { UsageService } from './core/usageService.js';
+import { ModeRegistry } from './core/modeRegistry.js';
+import { SessionOrchestrator } from './core/sessionOrchestrator.js';
+import { createLogger } from './core/logger.js';
+import { ClaudeMode } from './modes/claude/index.js';
+import { CodexMode } from './modes/codex/index.js';
+import { getClaudeModels, getClaudeModelsCachedOrFallback, getCodexModels } from './core/providerCatalog.js';
+import { MessageRouter } from './discord/messageRouter.js';
+import { InteractionRouter } from './discord/interactionRouter.js';
+import { SessionWiring } from './discord/wiring.js';
+import { DiscordClient, resolveGuildProvisioner } from './discord/client.js';
+import { autoProvisionGuild } from './discord/guildChannels.js';
+import { setLocale, t } from './discord/i18n.js';
+export function createApp(deps) {
+    const { config, configStore } = deps;
+    // Locale is a global default the i18n catalog reads; set it before any user-facing
+    // string is rendered (§8.1 config.locale, §11 item 14).
+    setLocale(config.locale ?? 'ko');
+    const logger = deps.logger ?? createLogger('app', { level: config.logLevel });
+    // ---- Core graph (§2). Dependencies flow one way: everything below depends on
+    // ConfigStore/StateStore, nothing in core depends on Discord or a mode. ----
+    const stateStore = new StateStore(configStore.dir);
+    const channelRegistry = new ChannelRegistry(stateStore);
+    const eventBus = new EventBus();
+    const configResolver = new ConfigResolver(configStore, channelRegistry);
+    const permissionResolver = new PermissionResolver(configStore, configResolver);
+    const authorizer = new Authorizer(configStore, channelRegistry);
+    const auditLog = new AuditLog({ baseDir: configStore.dir });
+    const usageService = new UsageService({
+        logger,
+        userAgentVersion: config.usage.userAgent,
+        cacheSec: config.usage.cacheSec,
+        ...(deps.fetchFn ? { fetchFn: deps.fetchFn } : {}),
+    });
+    const modeRegistry = new ModeRegistry();
+    // ---- Discord session wiring (renderers + permission buttons + sendFile) ----
+    // Built BEFORE the orchestrator so its requestPermission hook can be injected into
+    // the orchestrator at construction (the orchestrator's requestPermission is a
+    // constructor dep, not a mutable field). resolveChannel is bound to the live
+    // gateway once the client exists (below), via setResolveChannel.
+    const wiring = new SessionWiring({
+        eventBus,
+        modeRegistry,
+        channelRegistry,
+        usageService,
+        logger,
+        auditLog,
+        permissionTimeoutSec: config.limits.permissionTimeoutSec,
+        // Always-allow persistence (§7A): a tool the operator chose "always-allow" for
+        // is written into the GLOBAL autoAllowClaudeTools set, so the next turn (on any
+        // channel) auto-allows it via PermissionResolver → orchestrator → canUseTool.
+        // The wiring layer audits the GLOBAL write (who/where) before this runs.
+        onAlwaysAllow: (toolName) => {
+            configStore.addAutoAllowClaudeTool(toolName);
+        },
+    });
+    const orchestrator = new SessionOrchestrator({
+        channelRegistry,
+        modeRegistry,
+        eventBus,
+        configResolver,
+        permissionResolver,
+        auditLog,
+        logger,
+        // Route orchestrator permission prompts through the wiring's per-channel
+        // PermissionButtonsHandler (§7.5); the config timeout denies on expiry.
+        requestPermission: wiring.requestPermission,
+    });
+    // ---- Register the backends (§4/§10). Registering a mode automatically surfaces
+    // it as a `/mode backend` choice and in the channel wizard (both read
+    // modeRegistry.list()). ----
+    // Claude: sendFileFor is wired to the wiring layer's per-channel sink factory so
+    // the in-process attach_file MCP tool can deliver a confined file to the channel a
+    // session is bound to (kept out of the mode so modes stay transport-agnostic).
+    modeRegistry.register(new ClaudeMode({ sendFileFor: (guildId, channelId) => wiring.sendFileFor(guildId, channelId) }));
+    // Codex: no transport-specific deps (fileAttach:false → no sendFile); the runner
+    // and ~/.codex discovery are wired inside the mode. Its capabilities disable the
+    // Discord renderers Codex doesn't support (§5b/§6).
+    modeRegistry.register(new CodexMode());
+    // ---- Discord client (§2/§4). onReady resumes persisted sessions AND re-attaches a
+    // RendererDispatcher per resumed channel so a restart restores the live UX (§9). ----
+    const messageRouter = new MessageRouter({
+        authorizer,
+        channelRegistry,
+        orchestrator,
+        // The router arms a one-shot listener on this bus per accepted turn to clear the
+        // ⏳ working indicator (→ ✅/❌) when the channel's turn finishes.
+        eventBus,
+        logger,
+        // A server admin can drive a session by messaging even with an empty role config
+        // (never locked out): the router reads this bit off the member's permissions.
+        administratorBit: PermissionFlagsBits.Administrator,
+    });
+    const interactionRouter = new InteractionRouter({
+        authorizer,
+        orchestrator,
+        channelRegistry,
+        configStore,
+        configResolver,
+        permissionResolver,
+        modeRegistry,
+        wiring,
+        logger,
+        // Folder-browser roots + per-backend model list are config-driven (§8.1): the
+        // saved project favorites seed the browse roots; the model step offers the
+        // per-backend model list. Codex's list is a small documented default (the
+        // config `defaults.codexModel` — when set — plus common Codex model ids), so the
+        // wizard's model step isn't empty; a configured value is offered first. Selecting
+        // a Codex model here is cosmetic (like Claude's): the effective Codex model comes
+        // from config.defaults.codexModel — empty means `codex` uses its own config.toml
+        // default (operator-set). Override defaults.codexModel to force a model.
+        browseRoots: config.favorites,
+        // Per-backend model options from the central provider catalog (§ providerCatalog).
+        // Codex: a documented static default list (Codex has no model-list API; -m is
+        // free-form), with config.defaults.codexModel offered first when set. Claude:
+        // the SDK's supportedModels(), fetched once after login and CACHED — this render
+        // returns the cached English list if present, else the alias fallback while the
+        // async fetch warms the cache for the next render (never blocks the ack).
+        modelsFor: (backend) => backend === 'codex'
+            ? getCodexModels(config.defaults.codexModel)
+            : getClaudeModelsCachedOrFallback({ logger }),
+    });
+    const discord = new DiscordClient({
+        clientId: config.discord.clientId,
+        logger,
+        messageRouter,
+        interactionRouter,
+        // Only registered backends are offered as `/mode backend` choices. Evaluated at
+        // command-registration time, so both Claude and Codex now appear.
+        backends: () => modeRegistry.list(),
+        onReady: async (client) => {
+            // Resume every persisted, non-archived channel binding (fixes A2), then
+            // re-attach its renderers so the live UX survives a restart (§9 step 4).
+            await orchestrator.resumeAll();
+            for (const binding of channelRegistry.list().filter((b) => !b.archived)) {
+                await wiring.attach(binding.guildId, binding.channelId, binding.mode);
+            }
+            // Warm the Claude model cache now that auth is available (fire-and-forget): the
+            // SDK's supportedModels() is fetched once and cached so the first /config or
+            // /agent start shows the real, current model list instead of the alias fallback.
+            void getClaudeModels({ logger });
+            logger.info('boot complete', { guilds: client.guilds.cache.size });
+        },
+        // Auto-provision each guild's channel structure on ready / guild-join so /init is
+        // optional. Resolves the guild's provisioner over the live gateway, then runs the
+        // idempotent, Manage-Channels-guarded, non-throwing provisioner.
+        autoProvisionGuild: async (guildId) => {
+            const provisioner = await resolveGuildProvisioner(discord.raw, guildId);
+            if (provisioner)
+                await autoProvisionGuild(provisioner, configStore, logger);
+        },
+        ...(deps.client ? { client: deps.client } : {}),
+    });
+    // Bind the wiring's channel resolver to the live gateway now that the client exists.
+    wiring.setResolveChannel(SessionWiring.resolveOverClient(discord.raw));
+    // Bind the interaction router's guild/channel resolvers for /init + auto-created
+    // session channels (same late-binding pattern: the client depends on the router).
+    interactionRouter.setResolveGuildProvisioner((guildId) => resolveGuildProvisioner(discord.raw, guildId));
+    interactionRouter.setResolveChannel(SessionWiring.resolveOverClient(discord.raw));
+    return {
+        discord,
+        orchestrator,
+        modeRegistry,
+        wiring,
+        usageService,
+        logger,
+        config,
+        login: () => discord.login(config.discord.token),
+        destroy: () => discord.destroy(),
+    };
+}
+// Boot the bot. The two EXPECTED first-run conditions — no config file yet, or a
+// config with no Discord token — are not bugs: they mean the operator hasn't run
+// `--setup`. For those we print a short, actionable message and set a non-zero exit
+// code, then return undefined (no App), instead of letting a raw stack trace out.
+// Any OTHER failure (a corrupt/invalid config, a genuine login error) still throws
+// so real bugs surface. Returns the running App, or undefined when we bailed with a
+// friendly message.
+export async function startBot(opts = {}) {
+    const configStore = new ConfigStore(opts.baseDir);
+    // Not set up yet: no config.json. Point the user at the wizard, exit cleanly.
+    if (!configStore.exists()) {
+        console.error(t('boot.noConfig'));
+        process.exitCode = 1;
+        return undefined;
+    }
+    // A present-but-invalid config is a real error and propagates (not the friendly path).
+    const config = configStore.load();
+    // Config exists but the token is missing/empty: discord.login('') would dump a
+    // stack. Give the same friendly, actionable guidance instead.
+    if (config.discord.token.trim().length === 0) {
+        setLocale(config.locale ?? 'ko');
+        console.error(t('boot.noToken'));
+        process.exitCode = 1;
+        return undefined;
+    }
+    const app = createApp({ config, configStore });
+    await app.login();
+    return app;
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}

package/dist/app.test.js

@@ -0,0 +1,117 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { createApp } from './app.js';
+import { ConfigStore } from './core/config.js';
+import { CONFIG_DEFAULTS, CONFIG_VERSION } from './core/configSchema.js';
+// Build a minimal valid AppConfig from the shipped defaults + a (fake) discord
+// section. No realistic secret-shaped literals — placeholder ids only.
+function makeConfig(overrides = {}) {
+    return {
+        ...CONFIG_DEFAULTS,
+        version: CONFIG_VERSION,
+        discord: { token: 'fake-token-value', clientId: 'client-id-000' },
+        ...overrides,
+    };
+}
+function fakeClient() {
+    const onceHandlers = new Map();
+    const state = { loginCalls: [], destroyed: false };
+    const ready = {
+        user: { tag: 'bot#0001' },
+        guilds: { cache: new Map() },
+    };
+    const client = {
+        once: (event, handler) => {
+            onceHandlers.set(event, handler);
+        },
+        on: () => { },
+        login: async (token) => {
+            state.loginCalls.push(token);
+        },
+        destroy: async () => {
+            state.destroyed = true;
+        },
+        // resolveOverClient uses channels.fetch; onReady uses guilds.cache.size.
+        channels: { fetch: async () => null },
+        guilds: { cache: { size: 0 } },
+        token: 'fake-token-value',
+    };
+    return {
+        client,
+        loginCalls: state.loginCalls,
+        get destroyed() {
+            return state.destroyed;
+        },
+        fireReady: async () => {
+            const handler = onceHandlers.get('ready') ?? onceHandlers.get('clientReady');
+            if (!handler)
+                throw new Error('no ClientReady handler was registered');
+            handler(ready);
+            // handleReady runs onReady asynchronously; let its microtasks flush.
+            await new Promise((r) => setTimeout(r, 0));
+        },
+    };
+}
+describe('createApp — composition root', () => {
+    let dir;
+    let store;
+    beforeEach(() => {
+        dir = fs.mkdtempSync(path.join(os.tmpdir(), 'dab-app-'));
+        store = new ConfigStore(dir);
+        store.save(makeConfig());
+    });
+    afterEach(() => {
+        fs.rmSync(dir, { recursive: true, force: true });
+    });
+    it('constructs the full graph with a fake client without throwing', () => {
+        const fc = fakeClient();
+        const app = createApp({ config: makeConfig(), configStore: store, client: fc.client });
+        expect(app.orchestrator).toBeDefined();
+        expect(app.wiring).toBeDefined();
+        expect(app.usageService).toBeDefined();
+        expect(app.discord).toBeDefined();
+    });
+    it('registers BOTH the Claude and Codex modes in the mode registry', () => {
+        const fc = fakeClient();
+        const app = createApp({ config: makeConfig(), configStore: store, client: fc.client });
+        expect(app.modeRegistry.has('claude')).toBe(true);
+        expect(app.modeRegistry.get('claude').name).toBe('claude');
+        expect(app.modeRegistry.has('codex')).toBe(true);
+        expect(app.modeRegistry.get('codex').name).toBe('codex');
+        // Both registered → both offered as /mode backend choices and in the wizard.
+        expect(app.modeRegistry.list().sort()).toEqual(['claude', 'codex']);
+    });
+    it('exposes Codex capabilities (no permission prompts, no usage panel, transcript UX)', () => {
+        const fc = fakeClient();
+        const app = createApp({ config: makeConfig(), configStore: store, client: fc.client });
+        const caps = app.modeRegistry.get('codex').capabilities;
+        expect(caps.permissionPrompts).toBe(false);
+        expect(caps.usagePanel).toBe(false);
+        expect(caps.transcript).toBe(true);
+        expect(caps.streaming).toBe(false);
+    });
+    it('wires orchestrator.requestPermission to the wiring layer (denies when unwired)', async () => {
+        const fc = fakeClient();
+        const app = createApp({ config: makeConfig(), configStore: store, client: fc.client });
+        // The orchestrator's requestPermission is the wiring hook: with no channel wired,
+        // it fails safe (deny) — proving the hook is the wiring's, not the default stub.
+        const decision = await app.wiring.requestPermission({ guildId: 'g1', channelId: 'c1', ownerId: 'u1' }, { toolName: 'Bash', input: {} });
+        expect(decision.behavior).toBe('deny');
+    });
+    it('login() forwards the config token to the client', async () => {
+        const fc = fakeClient();
+        const app = createApp({ config: makeConfig(), configStore: store, client: fc.client });
+        await app.login();
+        expect(fc.loginCalls).toEqual(['fake-token-value']);
+    });
+    it('onReady triggers orchestrator.resumeAll()', async () => {
+        const fc = fakeClient();
+        const app = createApp({ config: makeConfig(), configStore: store, client: fc.client });
+        const spy = vi.spyOn(app.orchestrator, 'resumeAll');
+        await fc.fireReady();
+        expect(spy).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=app.test.js.map

package/dist/app.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.test.js","sourceRoot":"","sources":["../src/app.test.ts"],"names":[],"mappings":"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"}

package/dist/cli.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { startBot } from './app.js';
+import { runSetup } from './setup/wizard.js';
+import { ConfigStore } from './core/config.js';
+// Thin entrypoint (§4): `--version` prints the package version, `--setup` runs the
+// first-run wizard only (explicit re-configure), and the default/no-flag path is a
+// one-command first-run — it runs the wizard automatically when nothing is
+// configured yet, then boots the bot. All real work lives in app.ts /
+// setup/wizard.ts; this file only parses argv, decides, and dispatches.
+// Read the package version from package.json (two levels up from dist/cli.js, and
+// from src/cli.ts in dev). Kept as a function so a test can call it directly.
+export function readVersion() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    // dist/cli.js → ../package.json ; src/cli.ts → ../package.json
+    const pkgPath = path.join(here, '..', 'package.json');
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    return pkg.version ?? '0.0.0';
+}
+// Is this a first run that needs the wizard? True when there is no config.json yet,
+// OR a config exists but its Discord token is empty/whitespace — the same two
+// EXPECTED first-run conditions startBot() treats as "not set up" (the friendly
+// no-token check added by the friendly-startup fix). A present-but-INVALID config
+// is deliberately NOT treated as needs-setup: load() throws, and we let that
+// propagate to startBot() so a real corruption bug surfaces (it stays the friendly
+// fallback's job to report a still-can't-start config).
+function needsSetup(store) {
+    if (!store.exists())
+        return true;
+    return store.load().discord.token.trim().length === 0;
+}
+export async function run(argv) {
+    if (argv.includes('--version')) {
+        console.log(readVersion());
+        return;
+    }
+    // Explicit re-configure: run the wizard ONLY, never auto-start afterwards.
+    if (argv.includes('--setup')) {
+        await runSetup();
+        return;
+    }
+    // No flags: one-command first-run. When nothing is configured yet, run the wizard
+    // and then start the bot in the same process; when already configured, start
+    // directly. If setup was cancelled (or still wrote nothing usable), startBot's
+    // own guardrails print the friendly "run --setup" fallback and exit non-zero.
+    if (needsSetup(new ConfigStore())) {
+        await runSetup();
+        console.log('설정 완료. 봇을 시작합니다…');
+    }
+    await startBot();
+}
+// Only auto-run when invoked as the CLI, not when imported by a test.
+const isMain = typeof process.argv[1] === 'string' &&
+    import.meta.url === new URL(`file://${process.argv[1]}`).href;
+if (isMain) {
+    run(process.argv.slice(2)).catch((err) => {
+        console.error(err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,mFAAmF;AACnF,mFAAmF;AACnF,2EAA2E;AAC3E,sEAAsE;AACtE,wEAAwE;AAExE,kFAAkF;AAClF,8EAA8E;AAC9E,MAAM,UAAU,WAAW;IACzB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,+DAA+D;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAyB,CAAC;IAClF,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;AAChC,CAAC;AAED,oFAAoF;AACpF,8EAA8E;AAC9E,gFAAgF;AAChF,kFAAkF;AAClF,6EAA6E;AAC7E,mFAAmF;AACnF,wDAAwD;AACxD,SAAS,UAAU,CAAC,KAAkB;IACpC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAc;IACtC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IACD,2EAA2E;IAC3E,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,MAAM,QAAQ,EAAE,CAAC;QACjB,OAAO;IACT,CAAC;IACD,kFAAkF;IAClF,6EAA6E;IAC7E,+EAA+E;IAC/E,8EAA8E;IAC9E,IAAI,UAAU,CAAC,IAAI,WAAW,EAAE,CAAC,EAAE,CAAC;QAClC,MAAM,QAAQ,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,QAAQ,EAAE,CAAC;AACnB,CAAC;AAED,sEAAsE;AACtE,MAAM,MAAM,GACV,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ;IACnC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,GAAG,CAAC,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC;AAEhE,IAAI,MAAM,EAAE,CAAC;IACX,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACvC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}