verbalcoding 0.2.0 → 0.2.1

package/README.md

@@ -107,6 +107,7 @@ flowchart LR
 | [Configuration](docs/CONFIGURATION.md) | `.env`, agent backends, MCP, TTS backends, operational notes |
 | [Multi-Instance](docs/MULTI_INSTANCE.md) | One permanent Discord voice room per project |
 | [Release Notes](docs/RELEASE.md) | Current capabilities and pre-release checklist |
+| [한국어 문서](docs/i18n/README.ko.md) | npm 설치, 사용법, 설정, 멀티 인스턴스 한국어 가이드 |
 
 ## Tiny Command Map
 
@@ -154,4 +155,4 @@ vc doctor
 
 ## Status
 
-VerbalCoding is public-release oriented but still early. Demo video/GIF, broader Linux notes, and a formal license file are still TODOs.
+VerbalCoding is public-release oriented but still early. Demo video/GIF, broader Linux validation, CI, and deeper security review are still TODOs.

package/docs/RELEASE.md

@@ -22,6 +22,7 @@ VerbalCoding is a Discord voice bridge for controlling CLI-based coding agents b
 - Diff/code/log guardrails so large technical output is not read aloud.
 - Normal and conservative sensitivity modes for indoor vs. noisy/outdoor use.
 - Setup wizard, `.env.example`, `vc doctor` prerequisite checker, and `./scripts/install.sh --yes` bootstrap for OS packages, npm dependencies, Edge TTS helper, and the default whisper.cpp model.
+- npm package install path: `npm install -g verbalcoding`, `vc setup --yes`, and `vc start`.
 - Optional verbose progress mode for text-only middle-step updates during long agent work.
 - Always-on JSONL latency metrics plus `!latency` / `!metrics` summary for pipeline optimization.
 - Lower default utterance idle wait (`UTTERANCE_IDLE_MS=2000`) so STT starts about 0.6s sooner after speech ends.
@@ -38,14 +39,15 @@ node --check app-node/main.mjs app-node/agent_adapters.mjs app-node/install_conf
 npm test
 PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 python3 -m pytest tests/ -q || [ $? -eq 5 ]  # ok when no Python tests exist
 bash -n run.sh scripts/install.sh scripts/bootstrap_prereqs.sh scripts/docker_ubuntu_smoke.sh
+npm pack --dry-run
 vc doctor
 git diff --check
 ```
 
 Manual smoke test:
 
-1. Start the bridge with `./run.sh`.
-2. Verify log contains `Logged in as Hermes#6718`.
+1. Start the bridge with `vc start` or `./run.sh`.
+2. Verify log contains `Logged in as <bot-name>`.
 3. Verify log contains `Listening in voice channel ... / 일반` or the configured default channel.
 4. In Discord, run `!ping`.
 5. In Discord voice, say a short Korean request.

package/docs/i18n/CONFIGURATION.ko.md

@@ -0,0 +1,191 @@
+# VerbalCoding 설정 가이드
+
+## 설정 마법사
+
+npm으로 설치한 경우:
+
+```bash
+vc setup --yes
+```
+
+GitHub 클론에서 직접 실행하는 경우:
+
+```bash
+./scripts/install.sh --yes
+```
+
+설치기는 Discord 토큰, 허용 사용자, 자동 입장 음성 채널 이름, transcript 채널/스레드, CLI 하네스 백엔드, 기본 음성 언어, TTS 설정, wake word 동작을 묻습니다. 결과는 권한 `0600`의 `.env`에 저장되며, `.env`는 git에서 무시됩니다. 클론 설치에서는 짧은 셸 명령 `vc`도 연결합니다.
+
+수동 설치 후 셸 명령만 연결하려면:
+
+```bash
+npm link
+```
+
+## 지원 에이전트 백엔드
+
+`.env`에서 `AGENT_BACKEND`를 설정합니다.
+
+| 백엔드 | 기본 명령 | 메모 |
+|---|---|---|
+| `hermes` | `hermes chat -Q -q` | 기본값. `.verbalcoding-session` resume 동작을 유지합니다. |
+| `claude-code` / `claude` | `claude -p` | `CLAUDE_COMMAND` 또는 `AGENT_COMMAND`로 재정의 가능 |
+| `codex` | `codex exec` | `CODEX_COMMAND` 또는 `AGENT_COMMAND`로 재정의 가능 |
+| `gemini` | `gemini -p` | `GEMINI_COMMAND` 또는 `AGENT_COMMAND`로 재정의 가능 |
+| `opencode` | `opencode run` | `OPENCODE_COMMAND` 또는 `AGENT_COMMAND`로 재정의 가능 |
+| `openclaw` | `openclaw run` | `OPENCLAW_COMMAND` 또는 `AGENT_COMMAND`로 재정의 가능 |
+| `custom` | `AGENT_COMMAND` 필수 | 사용자 prompt가 마지막 argv 인자로 붙습니다. |
+
+공통 override 예시:
+
+```bash
+AGENT_BACKEND=custom
+AGENT_LABEL="My Harness"
+AGENT_COMMAND="my-harness run --non-interactive"
+AGENT_TASK_TIMEOUT_MS=0
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_VERBOSE_PROGRESS=0
+UTTERANCE_IDLE_MS=2000
+LATENCY_LOG_PATH=./.logs/latency.jsonl
+```
+
+## 에이전트 어댑터 계약
+
+음성 브릿지는 모든 백엔드와 하나의 어댑터 계약으로 통신합니다.
+
+- `run({ text }, signal, plan)`은 상태, 최종 답변 텍스트, 백엔드 라벨, elapsed time, 선택적 세션 metadata를 반환합니다.
+- `ask(text, signal, plan)`은 호환용 단축 함수이며 최종 답변 텍스트만 반환합니다.
+- `capabilities`는 해당 백엔드가 session resume, streaming progress, cancellation을 지원하는지 선언합니다.
+- Hermes는 기준 어댑터입니다. resume, verbose progress streaming, cancellation, Hermes 세션 파일에서 최종 답변 복구를 지원합니다.
+
+새 백엔드는 같은 계약을 구현하고, voice/STT/TTS 동작은 어댑터 밖에 유지하는 것이 좋습니다.
+
+## 예시 `.env`
+
+```bash
+DISCORD_BOT_TOKEN="***"
+DISCORD_ALLOWED_USERS="123456789012345678"
+AUTO_JOIN_VOICE_CHANNELS="일반,General,general"
+TRANSCRIPT_CHANNEL_ID="123456789012345678"
+
+AGENT_BACKEND="hermes"
+STT_ENGINE="whisper_cpp"
+WHISPER_CPP_BIN="whisper-cli"
+WHISPER_CPP_MODEL="./models/ggml-small-q5_1.bin"
+
+TTS_BACKEND="edge"
+TTS_VOICE="ko-KR-SunHiNeural"
+TTS_RATE="+10%"
+TTS_MAX_CHARS="495"
+TTS_VOLUME="1.0"
+
+REQUIRE_WAKE_WORD="0"
+MIN_UTTERANCE_SECONDS="1.0"
+UTTERANCE_IDLE_MS="2000"
+HERMES_TASK_TIMEOUT_MS="0"
+HERMES_CHAT_TIMEOUT_MS="45000"
+AGENT_VERBOSE_PROGRESS="0"
+LATENCY_LOG_PATH="./.logs/latency.jsonl"
+```
+
+## MCP 서버
+
+VerbalCoding은 stdio MCP 서버를 포함합니다. Hermes Agent 또는 MCP client는 자유 형식 shell 명령 대신 도구로 브릿지를 제어할 수 있습니다.
+
+Hermes 설정 예시:
+
+```yaml
+mcp_servers:
+  verbalcoding:
+    command: "node"
+    args: ["/path/to/VerbalCoding/scripts/mcp-server.mjs"]
+    timeout: 120
+    connect_timeout: 30
+```
+
+노출되는 MCP 도구:
+
+| 도구 | 용도 |
+|---|---|
+| `status` | 비밀값 없이 브릿지/설정 상태 보고 |
+| `doctor` | 비밀값을 숨긴 doctor 점검 실행 |
+| `set_auto_restart` | 커밋 시 음성 봇 자동 재시작 켜기/끄기 |
+| `set_language` | STT/진행/TTS 언어를 함께 변경 |
+| `start`, `stop`, `restart` | Discord 음성 브릿지 제어 |
+
+## 선택: OpenVoice TTS
+
+Edge TTS가 기본값이자 fallback입니다. OpenVoice V2로 로컬 음성 복제를 시험하려면:
+
+```bash
+./scripts/setup_openvoice.sh
+# OpenVoice 문서에서 checkpoints_v2_0417.zip을 받아 vendor/OpenVoice/checkpoints_v2/ 아래에 풉니다.
+mkdir -p voice-samples
+# 허가된 기준 샘플을 voice-samples/user-reference.wav에 넣거나,
+# Discord에서 !voice-clone capture로 샘플을 캡처합니다.
+python3 scripts/openvoice_smoke.py
+```
+
+그 뒤 설정:
+
+```bash
+TTS_BACKEND="openvoice"
+OPENVOICE_REF_AUDIO="./voice-samples/user-reference.wav"
+OPENVOICE_PROGRESS="0"
+```
+
+본인 소유이거나 사용 허가를 받은 목소리만 복제하세요. OpenVoice가 실패하거나 timeout되면 VerbalCoding은 Edge TTS로 fallback합니다.
+
+## 선택: Supertonic TTS
+
+```bash
+./scripts/setup_supertonic.sh
+supertonic tts '안녕하세요. 수퍼토닉 테스트입니다.' --lang ko --voice M1 --steps 2 --speed 1.0 -o /tmp/verbalcoding-supertonic.wav
+```
+
+그 뒤 설정:
+
+```bash
+TTS_BACKEND="supertonic"
+SUPERTONIC_COMMAND="./.venv-supertonic/bin/supertonic"
+SUPERTONIC_VOICE="M1"
+SUPERTONIC_LANGUAGE="ko"
+SUPERTONIC_STEPS="2"
+SUPERTONIC_SPEED="1.0"
+SUPERTONIC_PROGRESS="0"
+```
+
+Supertonic이 없거나 실패하거나 timeout되면 VerbalCoding은 Edge TTS로 fallback합니다.
+
+## 선택: SpeechSwift / CosyVoice TTS
+
+Apple Silicon에서는 `speech-swift`가 MLX-native CosyVoice/Qwen3-TTS 기반 한국어 음성 복제용 로컬 백엔드로 동작할 수 있습니다.
+
+```bash
+brew tap soniqo/speech https://github.com/soniqo/speech-swift
+brew install speech
+```
+
+권장 env:
+
+```bash
+TTS_BACKEND="speechswift"
+SPEECHSWIFT_MODE="server"
+SPEECHSWIFT_ENGINE="cosyvoice"
+SPEECHSWIFT_LANGUAGE="korean"
+SPEECHSWIFT_REF_AUDIO="./voice-samples/user-reference.wav"
+SPEECHSWIFT_SERVER_HOST="127.0.0.1"
+SPEECHSWIFT_SERVER_PORT="18080"
+SPEECHSWIFT_SERVER_URL="http://127.0.0.1:18080"
+SPEECHSWIFT_PROGRESS="0"
+```
+
+빠른 진행/짧은 backchannel prompt는 Edge를 유지하는 편이 안전합니다.
+
+## 운영 메모
+
+- 텍스트 명령을 쓰려면 Discord bot의 privileged Message Content intent가 켜져 있어야 합니다.
+- 봇에는 음성 채널 connect/speak 권한이 필요합니다.
+- Hermes Agent를 쓴다면 기본 프로필에서 Hermes를 정상 설정/인증하세요. 예: `hermes setup`, `hermes login` 등.
+- Claude Code, Codex, Gemini, OpenCode, OpenClaw를 쓰려면 해당 CLI를 별도로 설치하고 인증하세요.
+- CLI가 timeout 또는 signal 실패 중 diff/code를 출력하면 브릿지는 그 내용을 음성으로 읽지 않고 자세한 텍스트로만 보냅니다.

package/docs/i18n/FRESH_INSTALL.ko.md

@@ -0,0 +1,193 @@
+# VerbalCoding 새 설치 가이드
+
+이 문서는 공개 npm 패키지 또는 깨끗한 GitHub 클론에서 처음 설치하는 흐름을 설명합니다. 로컬 전용 가정을 피하고, 설치 스크립트가 가능한 한 많은 준비 작업을 자동화하도록 구성돼 있습니다.
+
+## 1. CLI 설치
+
+권장 npm 설치:
+
+```bash
+npm install -g verbalcoding
+```
+
+전역 설치 없이 바로 실행하려면:
+
+```bash
+npx verbalcoding setup --yes
+```
+
+전역 설치를 했다면 이어서:
+
+```bash
+vc setup --yes
+```
+
+기여자용 GitHub 클론 경로:
+
+```bash
+git clone https://github.com/ca1773130n/VerbalCoding.git
+cd VerbalCoding
+./scripts/install.sh --yes
+```
+
+## 2. 의존성 부트스트랩과 설정 마법사
+
+npm 명령은 클론 설치와 같은 부트스트래퍼를 실행합니다. 클론에서는 다음을 실행합니다.
+
+```bash
+./scripts/install.sh --yes
+```
+
+이 명령이 하는 일:
+
+- `node_modules/`가 없으면 npm 의존성을 설치합니다.
+- 클론 설치에서는 짧은 `vc` 셸 명령을 `npm link`로 연결합니다.
+- OS 패키지 매니저가 지원되면 `ffmpeg`, Node/npm, `whisper-cli`를 설치합니다.
+- 기본 모델 `models/ggml-small-q5_1.bin`을 다운로드합니다.
+- `edge-tts`가 PATH에 없으면 `.venv-tts`를 만들고 Edge TTS helper를 설치합니다.
+- 대화형 `.env` 설정 마법사를 실행합니다.
+
+지원되는 시스템 부트스트랩 경로:
+
+| OS | 시스템 의존성 경로 |
+|---|---|
+| macOS | Homebrew: 필요 시 `brew install node ffmpeg whisper-cpp` |
+| Debian/Ubuntu | `apt-get`으로 Node/npm, ffmpeg, Python, build tools 설치; 필요 시 로컬 whisper.cpp 빌드 |
+| Fedora/RHEL | `dnf`로 Node/npm, ffmpeg, Python, build tools 설치; 필요 시 로컬 whisper.cpp 빌드 |
+| Arch | `pacman`으로 Node/npm, ffmpeg, Python, build tools 설치; 필요 시 로컬 whisper.cpp 빌드 |
+
+유용한 설치 변형:
+
+```bash
+vc setup --yes --no-wizard                   # npm 설치에서 의존성만 준비
+./scripts/install.sh --yes --no-wizard       # 클론에서 의존성만 준비
+./scripts/install.sh --skip-system           # OS 패키지는 직접 설치
+./scripts/install.sh --skip-model            # 기본 STT 모델 다운로드 생략
+./scripts/install.sh --skip-edge-tts         # .venv-tts 생성 생략
+VERBALCODING_SKIP_CLI_LINK=1 ./scripts/install.sh --yes
+```
+
+OS가 지원되지 않으면 아래를 직접 설치한 뒤 다시 실행하세요.
+
+- Node.js 20+ 및 npm
+- ffmpeg
+- venv/pip가 포함된 Python 3
+- whisper.cpp `whisper-cli`
+- 인증된 CLI 에이전트 백엔드 하나 이상; 기본은 Hermes Agent
+
+## 3. Discord 애플리케이션 설정
+
+1. Discord Developer Portal에서 애플리케이션과 봇을 만듭니다.
+2. Message Content privileged intent를 켭니다.
+3. 봇 토큰을 설치 프롬프트 또는 `.env`의 `DISCORD_BOT_TOKEN`에 넣습니다.
+4. 초대 URL을 생성합니다.
+
+```bash
+vc bot invite <discord-client-id>
+# 특정 서버로 고정하려면:
+vc bot invite <discord-client-id> --guild <guild-id>
+```
+
+초대 URL에는 VerbalCoding이 쓰는 bot/application command scope와 텍스트/음성 권한이 포함됩니다.
+
+## 4. 검증
+
+```bash
+vc doctor
+```
+
+`vc doctor`는 토큰을 숨깁니다. 필요한 토큰, 명령, 모델이 있는지만 보여주고 비밀값은 출력하지 않습니다. 모든 `✗` 항목을 고친 뒤 다시 실행하세요.
+
+성공 예시는 다음과 같습니다.
+
+```text
+✓ Node.js
+✓ npm
+✓ ffmpeg
+✓ whisper-cli
+✓ whisper.cpp model
+✓ Discord bot token configured — [REDACTED]
+✓ edge-tts
+✓ hermes CLI
+Doctor passed. Run vc start to start VerbalCoding.
+```
+
+설치기가 로컬 Edge TTS helper를 만들었다면 `.env`에는 `.venv-tts/bin/edge-tts`를 가리키는 `EDGE_TTS_COMMAND` 경로가 들어갑니다.
+
+## 5. 기본 단일 봇 실행
+
+```bash
+vc start
+# 또는 GitHub 클론에서:
+./run.sh
+```
+
+성공한 시작 로그에는 다음 줄이 보입니다.
+
+```text
+Logged in as <bot-name>
+Listening in voice channel <server> / <channel>
+```
+
+Discord에서:
+
+```text
+!ping
+!join
+!ask say hello briefly
+!verbose on
+```
+
+그 다음 설정된 음성 채널에서 말해 보세요. STT 텍스트, verbose 모드의 진행 텍스트, 최종 텍스트 답변, TTS 재생을 확인할 수 있어야 합니다.
+
+## 6. 프로젝트별 음성방 설정
+
+프로젝트 음성방마다 영구 봇 하나를 두려면 프로젝트마다 Discord 애플리케이션을 만든 뒤:
+
+```bash
+vc instance setup my-project
+vc bot invite <that-project-client-id>
+vc instance start my-project
+vc instance status my-project
+```
+
+각 인스턴스는 무시되는 `instances/<name>.env`를 작성합니다. 이 파일에는 해당 봇의 토큰, 음성 채널, transcript 대상, 로그 경로, Hermes 세션 파일, 선택적 Hermes 프로필 정보가 들어갑니다.
+
+## 7. 선택: OpenVoice 설정
+
+OpenVoice 음성 복제는 선택 기능입니다. 공개 설치 직후에는 `TTS_BACKEND=edge`를 유지하세요. 나중에 OpenVoice를 켜려면:
+
+```bash
+./scripts/setup_openvoice.sh
+# OpenVoice V2 체크포인트를 vendor/OpenVoice/checkpoints_v2/ 아래에 넣습니다.
+# 허가된 로컬 샘플을 voice-samples/user-reference.wav에 두거나,
+# 봇 실행 후 “목소리 샘플 녹음 시작해”라고 말하고 10~30초 발화합니다.
+python3 scripts/openvoice_smoke.py
+```
+
+그 뒤 `TTS_BACKEND=openvoice`로 설정하고 `vc doctor`, Discord의 `!voice-test <text>`로 테스트합니다.
+
+## 8. 유지보수자용 클린 설치 스모크 테스트
+
+빠른 호스트 스모크 테스트:
+
+```bash
+TMPDIR=$(mktemp -d)
+git clone https://github.com/ca1773130n/VerbalCoding.git "$TMPDIR/VerbalCoding"
+cd "$TMPDIR/VerbalCoding"
+./scripts/install.sh --yes --no-wizard
+npm pack --dry-run
+cp .env.example .env
+chmod 600 .env
+vc doctor || true
+```
+
+이 시점에서 예상되는 실패는 로컬 비밀값 누락 또는 인증되지 않은 에이전트 CLI입니다. 토큰 노출이나 설치 스크립트 누락이 나오면 안 됩니다.
+
+Docker 기반 Ubuntu 클린 설치 스모크 테스트:
+
+```bash
+./scripts/docker_ubuntu_smoke.sh
+```
+
+이 스크립트는 `ubuntu:24.04`에서 추적된 저장소 트리를 깨끗한 컨테이너로 복사하고, `./scripts/install.sh --yes --no-wizard`를 실행하고, 비밀값 없는 smoke `.env`를 만든 뒤 `vc`, Node 테스트, `vc doctor`를 확인합니다. Discord 음성 연결까지는 하지 않습니다. 실제 end-to-end 음성 테스트는 Ubuntu VM 또는 WSL2에서 별도로 진행하세요.

package/docs/i18n/MULTI_INSTANCE.ko.md

@@ -0,0 +1,179 @@
+# VerbalCoding 멀티 인스턴스
+
+VerbalCoding은 여러 개의 독립적인 Discord 음성 브릿지 프로세스를 실행할 수 있습니다. 각 프로세스는 같은 단일 인스턴스 Node 브릿지를 사용하지만, 서로 다른 `instances/<name>.env` 파일과 서로 다른 Discord bot token을 로드합니다.
+
+프로젝트마다 자기 Discord 음성 채널에 항상 붙어 있고, 자기 transcript 채널/스레드에 기록해야 할 때 사용하세요.
+
+## 왜 여러 봇 토큰이 필요한가
+
+Discord 음성 상주 방식은 사실상 길드마다 봇 계정 하나가 동시에 하나의 음성 연결만 유지하는 구조입니다. 같은 봇 토큰이 같은 길드의 다른 음성 채널에 들어가면 이전 채널에도 계속 남아 있을 수 없습니다. 동시에 여러 프로젝트 방을 유지하려면 프로젝트마다 Discord 애플리케이션/봇을 하나씩 만들어야 합니다.
+
+## 파일 구조
+
+```text
+instances/
+  README.md
+  example.env
+  llm-wiki.env        # 로컬 전용, git에서 무시
+  verbalcoding.env    # 로컬 전용, git에서 무시
+.run/instances/
+  llm-wiki.pid        # 런타임 전용, git에서 무시
+```
+
+실제 `instances/*.env` 파일에는 Discord 토큰이 들어갈 수 있으므로 git에서 무시됩니다. `instances/example.env`만 템플릿으로 커밋됩니다.
+
+## 인스턴스 설정 마법사
+
+일반 사용자는 env 파일을 복사해서 직접 편집하지 않는 편이 좋습니다. 마법사를 실행하세요.
+
+```bash
+vc instance setup llm-wiki
+# 또는 프로젝트 설정 스크립트에서:
+./scripts/install.sh --instance llm-wiki
+```
+
+마법사는 봇 토큰, Discord Application/Client ID, 음성 채널, transcript 대상, 작업 디렉터리, 프로젝트 컨텍스트, 격리된 런타임 경로를 묻습니다. `instances/<name>.env`를 권한 `0600`으로 작성하고, 기존 파일이 있으면 덮어쓰기 전에 백업하며, 다음 start/status 명령을 출력합니다.
+
+설정 중 Discord Application/Client ID를 입력하면 요약에 해당 봇 초대 URL도 출력됩니다. 같은 URL은 언제든지 다시 만들 수 있습니다.
+
+```bash
+vc bot invite <client-id>
+vc bot invite <client-id> --guild <guild-id>
+```
+
+Discord는 동시에 여러 음성방에 상주하려면 여전히 방마다 Developer Portal 애플리케이션/봇 하나가 필요합니다. 대신 VerbalCoding이 OAuth URL이나 permission integer를 직접 조립할 필요를 없애 줍니다.
+
+### Hermes 프로필 격리
+
+각 인스턴스는 `~/.hermes/profiles/<name>` 아래에 자기 Hermes home을 갖습니다. 이렇게 하면 memory, MEMORY.md, SOUL.md, 학습된 skills가 프로젝트 사이에 섞이지 않습니다.
+
+`vc instance setup <name>`은 자동으로 다음을 수행합니다.
+
+- `hermes profile create <name> --clone-from default` 실행: 현재 `~/.hermes`의 API key와 모델 설정은 가져오지만, 세션과 메모리는 새로 시작합니다.
+- 새 프로필의 `terminal.cwd`를 인스턴스 작업 디렉터리로 설정합니다.
+- 마법사에서 입력한 project context로 `<profile>/SOUL.md`를 초기화합니다.
+- `instances/<name>.env`에 `HERMES_HOME=...`을 씁니다.
+
+`vc instance start <name>`은 self-heal을 수행합니다. env가 가리키는 Hermes profile directory가 사라졌다면 시작 전에 다시 만듭니다.
+
+인스턴스 이름은 Hermes가 디렉터리와 config key로 쓰기 때문에 `^[a-z0-9][a-z0-9_-]{0,63}$` 형식이어야 합니다.
+
+## 생성되는 최소 인스턴스 env 예시
+
+```env
+INSTANCE_NAME=my-project
+DISCORD_TOKEN=replac...oken
+DISCORD_CLIENT_ID=123456789012345678
+AUTO_JOIN_VOICE_CHANNELS=Project Room
+TRANSCRIPT_CHANNEL_ID=123456789012345678
+PROJECT_SESSIONS_FILE=config/project-sessions.my-project.json
+BRIDGE_LOG_PATH=/tmp/verbalcoding-my-project.log
+NODE_AUDIO_DEBUG_DIR=/tmp/verbalcoding-my-project-debug
+HERMES_SESSION_FILE=.agent-sessions/hermes/my-project.session
+HERMES_HOME=/home/you/.hermes/profiles/my-project
+AGENT_LABEL=VerbalCoding · My Project
+AGENT_CWD=/path/to/my-project
+AGENT_PROJECT_CONTEXT=Project session: My Project
+```
+
+모든 인스턴스는 log/debug/session 파일 경로가 고유해야 합니다. `HERMES_HOME`과 대응하는 `~/.hermes/profiles/<name>` 디렉터리는 `vc instance setup`이 자동 생성합니다. `vc doctor`는 비밀값을 출력하지 않고 중복 토큰, 충돌하는 런타임 경로, 누락된 profile directory, profile과 instance의 `terminal.cwd` 불일치를 검사합니다.
+
+## 명령
+
+```bash
+vc instance list
+vc instance status
+vc instance status my-project
+vc instance start my-project
+vc instance stop my-project
+vc instance restart my-project
+```
+
+`start`는 `./run.sh instances/<name>.env`를 detached로 실행하고 `.run/instances/<name>.pid`를 씁니다.
+
+`stop`은 `SIGTERM`을 보내고 최대 10초 기다린 뒤, 필요하면 `SIGKILL`로 fallback하고 pid 파일을 제거합니다.
+
+## 예시: 영구 음성방 두 개
+
+1. Discord 애플리케이션/봇 두 개를 만듭니다.
+   - VerbalCoding bot
+   - LLM-Wiki bot
+
+2. 둘 다 서버에 초대하고 텍스트/음성 권한을 줍니다.
+   - View Channel
+   - Send Messages
+   - Send Messages in Threads
+   - Read Message History
+   - Use Application Commands
+   - Connect
+   - Speak
+
+   각 Discord 애플리케이션을 만든 뒤 `vc bot invite <client-id>`를 실행하면 필요한 권한이 포함된 정확한 초대 URL을 출력합니다.
+
+3. 각 로컬 인스턴스 설정 마법사를 실행합니다.
+
+```bash
+vc instance setup verbalcoding
+vc instance setup llm-wiki
+```
+
+마법사는 git에서 무시되는 `instances/verbalcoding.env`, `instances/llm-wiki.env`를 권한 `0600`으로 작성하고, 기존 env가 있으면 백업합니다. 각 실행은 기본 Hermes home에서 clone한 `~/.hermes/profiles/<name>`도 생성하므로 두 인스턴스는 같은 인증/모델 설정으로 시작하지만, 프로젝트를 학습하면서 서로 독립적인 memory와 skills를 쌓습니다.
+
+4. 설정을 확인합니다.
+
+```bash
+vc doctor
+```
+
+5. 둘 다 시작합니다.
+
+```bash
+vc instance start verbalcoding
+vc instance start llm-wiki
+vc instance status
+```
+
+6. 로그를 확인합니다.
+
+```bash
+tail -n 50 /tmp/verbalcoding-verbalcoding.log
+tail -n 50 /tmp/verbalcoding-llm-wiki.log
+```
+
+예상 로그:
+
+```text
+Listening in voice channel ... / VerbalCoding
+Listening in voice channel ... / LLM-Wiki
+```
+
+7. 둘 다 중지합니다.
+
+```bash
+vc instance stop verbalcoding
+vc instance stop llm-wiki
+```
+
+## 단기: 단일 봇 텍스트/음성 바인딩
+
+봇 토큰이 하나뿐이라면 동시 다중 채널 상주 대신 project-session voice binding을 쓰세요.
+
+대상 텍스트 채널/스레드에서:
+
+```text
+!session attach-voice --voice "LLM-Wiki"
+```
+
+동작:
+
+- 선택된 음성 채널을 현재 텍스트 채널/스레드에 연결합니다.
+- 현재 텍스트 채널에 project session이 없으면 ad-hoc 격리 세션을 만듭니다.
+- 음성 STT/result/progress/final-answer 텍스트가 해당 project transcript 대상으로 라우팅됩니다.
+
+기존 named project session을 연결하려면:
+
+```text
+!session voice llm-wiki --voice "LLM-Wiki"
+```
+
+이 방식은 라우팅에는 편하지만, 봇 하나를 동시에 두 음성 채널에 머물게 하지는 않습니다. 동시에 여러 프로젝트 방에 영구 상주하려면 여러 봇 토큰/프로세스를 사용하세요.

package/docs/i18n/README.ko.md

@@ -19,15 +19,16 @@
   <img alt="Discord" src="https://img.shields.io/badge/Discord-voice%20bridge-5865F2?logo=discord&logoColor=white">
   <img alt="STT" src="https://img.shields.io/badge/STT-whisper.cpp-7C3AED">
   <img alt="TTS" src="https://img.shields.io/badge/TTS-Edge%20%7C%20OpenVoice%20%7C%20Supertonic%20%7C%20SpeechSwift-0EA5E9">
+  <img alt="Agents" src="https://img.shields.io/badge/Agents-Hermes%20%7C%20Claude%20%7C%20Codex%20%7C%20Gemini%20%7C%20OpenCode-111827">
 </p>
 
 <p align="center">
   <img src="../assets/figures/verbalcoding-flow.svg" alt="VerbalCoding voice-to-agent flow" width="860">
 </p>
 
-## Why
+## 왜 필요한가
 
-VerbalCoding은 Discord 음성 채널을 코딩 에이전트용 핸즈프리 조작면으로 바꿉니다. 말로 요청하고, CLI 에이전트가 작업하게 두고, 핵심 답변을 음성으로 다시 들을 수 있습니다 — 텍스트 기록, 진행 이벤트, 코드/로그 낭독 방지 장치까지 함께 제공합니다.
+VerbalCoding은 Discord 음성 채널을 코딩 에이전트용 핸즈프리 조작면으로 바꿉니다. 말로 요청하고, CLI 에이전트가 작업하게 두고, 핵심 답변을 음성으로 다시 들을 수 있습니다. 텍스트 기록, 진행 이벤트, 코드/로그 낭독 방지 장치도 함께 제공합니다.
 
 ## 핵심 기능
 
@@ -36,20 +37,41 @@ VerbalCoding은 Discord 음성 채널을 코딩 에이전트용 핸즈프리 조
 | 음성 우선 에이전트 제어 | Hermes Agent, Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw 또는 커스텀 CLI를 말로 제어합니다. |
 | 로컬 우선 음성 루프 | Discord 음성 캡처 → `whisper.cpp` STT → 에이전트 → 분할 TTS 재생. |
 | 음성 + 텍스트 컨텍스트 공유 | 지원되는 에이전트에서는 음성 턴과 `!ask` 텍스트 명령이 같은 세션을 재사용합니다. |
-| 바지인과 감도 모드 | 재생 중 자연스럽게 끼어들고, 일반/보수 감도 모드를 전환합니다. |
+| 끼어들기와 감도 모드 | 재생 중 자연스럽게 끼어들고, 일반/보수 감도 모드를 전환합니다. |
 | 다국어 음성 프리셋 | `vc language ko/en/auto`로 STT, 진행 언어, TTS 음성을 함께 바꿉니다. |
 | 프로젝트별 멀티룸 격리 | 프로젝트 방마다 별도 봇과 Hermes 프로필, 세션, 메모리, 로그를 둡니다. |
 
 ## 빠른 시작
 
+가장 쉬운 npm 설치:
+
 ```bash
-git clone git@github.com:ca1773130n/VerbalCoding.git
+npm install -g verbalcoding
+vc setup --yes
+vc doctor
+vc start
+```
+
+전역 설치 없이 바로 실행:
+
+```bash
+npx verbalcoding setup --yes
+vc doctor
+vc start
+```
+
+기여자용 GitHub 클론:
+
+```bash
+git clone https://github.com/ca1773130n/VerbalCoding.git
 cd VerbalCoding
-./scripts/install.sh
+./scripts/install.sh --yes
 vc doctor
 ./run.sh
 ```
 
+`vc setup --yes`와 `./scripts/install.sh --yes`는 가능한 경우 Node/npm 의존성, `ffmpeg`, `whisper-cli`, 기본 whisper.cpp 모델, 로컬 `.venv-tts` Edge TTS helper를 준비합니다. macOS/Homebrew와 일반적인 Linux 패키지 매니저(`apt`, `dnf`, `pacman`)를 지원합니다.
+
 ## 동작 방식
 
 ```mermaid
@@ -65,57 +87,71 @@ flowchart LR
 
 ## 지원 에이전트 백엔드
 
-| Backend | Default command | Session support |
+| 백엔드 | 기본 명령 | 세션 지원 |
 |---|---:|---|
-| Hermes Agent | `hermes chat -Q -q` | Resume, verbose progress, cancellation, final-answer recovery |
-| Claude Code | `claude -p` | CLI session file support through adapter defaults |
-| Codex CLI | `codex exec` | CLI session file support through adapter defaults |
-| Gemini CLI | `gemini -p` | CLI session file support through adapter defaults |
-| OpenCode | `opencode run` | CLI session file support through adapter defaults |
-| OpenClaw | `openclaw run` | CLI session file support through adapter defaults |
-| Custom | `AGENT_COMMAND` | Bring your own non-interactive command |
+| Hermes Agent | `hermes chat -Q -q` | resume, 자세한 진행, cancellation, 최종 답변 복구 |
+| Claude Code | `claude -p` | 어댑터 기본값을 통한 CLI 세션 파일 지원 |
+| Codex CLI | `codex exec` | 어댑터 기본값을 통한 CLI 세션 파일 지원 |
+| Gemini CLI | `gemini -p` | 어댑터 기본값을 통한 CLI 세션 파일 지원 |
+| OpenCode | `opencode run` | 어댑터 기본값을 통한 CLI 세션 파일 지원 |
+| OpenClaw | `openclaw run` | 어댑터 기본값을 통한 CLI 세션 파일 지원 |
+| Custom | `AGENT_COMMAND` | 비대화형 명령을 직접 연결 |
 
 ## 더 알아보기
 
-| Guide | What you get |
+| 문서 | 내용 |
 |---|---|
-| [Fresh Install](../FRESH_INSTALL.md) | 클린 클론 설치, 모델 다운로드, 첫 실행 |
-| [Usage Guide](../USAGE.md) | CLI 명령, Discord 명령, 진행 모드, 지연 시간 지표 |
-| [Configuration](../CONFIGURATION.md) | .env, 에이전트 백엔드, MCP, TTS 백엔드, 운영 노트 |
-| [Multi-Instance](../MULTI_INSTANCE.md) | 프로젝트마다 영구 Discord 음성방 하나씩 |
-| [Release Notes](../RELEASE.md) | 현재 기능과 릴리스 전 체크리스트 |
+| [새 설치](FRESH_INSTALL.ko.md) | npm 설치, 클린 클론, 모델 다운로드, 첫 실행 |
+| [사용 가이드](USAGE.ko.md) | CLI 명령, Discord 명령, 진행 모드, 지연 시간 지표 |
+| [설정](CONFIGURATION.ko.md) | `.env`, 에이전트 백엔드, MCP, TTS 백엔드, 운영 메모 |
+| [멀티 인스턴스](MULTI_INSTANCE.ko.md) | 프로젝트마다 영구 Discord 음성방 하나씩 운영 |
+| [릴리스 노트](RELEASE.ko.md) | 현재 기능과 릴리스 전 체크리스트 |
+| [English docs](../../README.md) | 영어 canonical README와 문서 |
 
 ## 작은 명령 지도
 
 ```bash
-vc status
-vc language ko|en|auto
-vc bot invite CLIENT_ID
-vc instance setup NAME
-vc instance start NAME
-vc doctor
+vc status                 # 현재 언어, TTS, 브릿지 설정 보기
+vc language ko|en|auto    # STT/진행/TTS 언어 프리셋 전환
+vc bot invite CLIENT_ID   # Discord 봇 초대 URL 생성
+vc instance setup NAME    # 격리된 프로젝트 음성 봇 생성
+vc instance start NAME    # 해당 봇을 백그라운드로 실행
+vc doctor                 # 비밀값을 숨긴 상태 점검
+vc start                  # 기본 브릿지 시작
+```
+
+Discord에서:
+
+```text
+!join        !ask <prompt>       !verbose on/off
+!latency     !sensitivity normal !sensitivity conservative
+!session new <name> <workdir> [context] --voice <voice-channel>
 ```
 
 ## 요구 사항
 
-| Layer | Default |
+| 계층 | 기본값 |
 |---|---|
-| Runtime | Node.js 20+, npm |
-| Audio | `ffmpeg` |
-| STT | `whisper.cpp` / `whisper-cli` |
+| Runtime | Node.js 20+, npm; 설치 스크립트가 Homebrew/apt/dnf/pacman으로 설치 시도 |
+| Audio | `ffmpeg`; 설치 스크립트가 설치 시도 |
+| STT | `whisper.cpp` / `whisper-cli`; macOS는 Homebrew, Linux는 로컬 빌드 fallback |
+| TTS | Edge TTS CLI; 필요하면 `.venv-tts` 생성 |
 | Discord | Bot token, Message Content intent, voice permissions |
-| Agent | At least one authenticated CLI harness, Hermes Agent by default |
-| Platform focus | macOS / Apple Silicon currently gets the most testing |
+| Agent | 인증된 CLI 하네스 하나 이상; 기본은 Hermes Agent |
+| Platform focus | macOS / Apple Silicon을 가장 많이 테스트; Linux bootstrap은 best-effort |
 
 ## 기여
 
+변경 전 가벼운 검증:
+
 ```bash
 node --check app-node/main.mjs
 npm test
 bash -n run.sh scripts/install.sh
+npm pack --dry-run
 vc doctor
 ```
 
 ## 상태
 
-VerbalCoding is public-release oriented but still early. Demo video/GIF, broader Linux notes, and a formal license file are still TODOs.
+VerbalCoding은 공개 릴리스를 지향하지만 아직 초기 단계입니다. 데모 영상/GIF, 더 넓은 Linux 검증, CI와 보안 리뷰를 계속 보강하면 좋습니다.

package/docs/i18n/RELEASE.ko.md

@@ -0,0 +1,72 @@
+# VerbalCoding 릴리스 노트
+
+## 현재 릴리스 후보
+
+VerbalCoding은 음성으로 CLI 기반 코딩 에이전트를 제어하기 위한 Discord 음성 브릿지입니다. 공개 릴리스를 지향하며, macOS / Apple Silicon 경로가 가장 많이 테스트되어 있고, 일반적인 Linux 패키지 매니저에 대해서는 best-effort 부트스트랩을 제공합니다.
+
+### 포함된 기능
+
+- Node `@discordjs/voice` 기반 Discord 음성 수신.
+- `whisper.cpp` + Metal 기반 로컬 한국어 STT.
+- 한국어 기본 음성을 사용하는 Edge TTS 재생.
+- 범용 CLI 하네스 어댑터 레이어:
+  - Hermes Agent
+  - Claude Code
+  - Codex CLI
+  - Gemini CLI
+  - OpenCode
+  - OpenClaw
+  - custom command
+- Hermes 백엔드의 음성/텍스트 공유 세션 지원.
+- 긴 답변 TTS chunking과 반응형 barge-in.
+- 큰 diff/code/log 출력이 음성으로 읽히지 않도록 하는 guardrail.
+- 실내와 noisy/outdoor 환경을 위한 normal/conservative 감도 모드.
+- 설정 마법사, `.env.example`, `vc doctor` prerequisite checker, OS 패키지/npm 의존성/Edge TTS helper/기본 whisper.cpp 모델을 준비하는 `./scripts/install.sh --yes` 부트스트랩.
+- 긴 에이전트 작업 중 텍스트 전용 중간 단계 업데이트를 위한 선택적 verbose progress mode.
+- 파이프라인 최적화를 위한 JSONL latency metrics와 `!latency` / `!metrics` 요약.
+- 낮아진 기본 utterance idle wait (`UTTERANCE_IDLE_MS=2000`)로 사용자가 말한 뒤 STT가 약 0.6초 더 빨리 시작.
+- 멀티 인스턴스 Hermes 프로필 격리: `vc instance setup <name>`이 자동으로 Hermes 프로필을 `~/.hermes/profiles/<name>`에 clone하고, instance workdir을 설정하고, SOUL.md를 초기화하고, instance env에 `HERMES_HOME`을 기록합니다. `vc instance start`는 누락된 profile을 self-heal하고, `vc doctor`는 profile-dir 존재와 `terminal.cwd` 일관성을 검사합니다.
+- npm 공개 패키지: `npm install -g verbalcoding`, `vc setup --yes`, `vc start` 경로 지원.
+
+### 릴리스 전 체크리스트
+
+저장소 루트에서 실행:
+
+```bash
+./scripts/install.sh --yes --no-wizard
+./scripts/docker_ubuntu_smoke.sh   # Docker 필요; ubuntu:24.04 clean install 검증
+node --check app-node/main.mjs app-node/agent_adapters.mjs app-node/install_config.mjs scripts/install.mjs
+npm test
+PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 python3 -m pytest tests/ -q || [ $? -eq 5 ]  # Python 테스트가 없으면 exit 5 허용
+bash -n run.sh scripts/install.sh scripts/bootstrap_prereqs.sh scripts/docker_ubuntu_smoke.sh
+npm pack --dry-run
+vc doctor
+git diff --check
+```
+
+수동 스모크 테스트:
+
+1. `vc start` 또는 `./run.sh`로 브릿지를 시작합니다.
+2. 로그에 `Logged in as <bot-name>`이 있는지 확인합니다.
+3. 로그에 `Listening in voice channel ... / 일반` 또는 설정된 기본 채널이 있는지 확인합니다.
+4. Discord에서 `!ping`을 실행합니다.
+5. Discord 음성에서 짧은 한국어 요청을 말합니다.
+6. STT transcript, agent response, TTS playback, barge-in 동작을 확인합니다.
+
+### 알려진 요구 사항
+
+- macOS + Homebrew 또는 Linux + `apt`, `dnf`, `pacman` best-effort bootstrap.
+- `ffmpeg`; 설치기가 설치를 시도합니다.
+- `whisper-cli`; macOS에서는 Homebrew를 사용하고, Linux에서는 로컬 `vendor/whisper.cpp` 빌드 fallback을 사용합니다.
+- 기본 모델 `models/ggml-small-q5_1.bin`; `--skip-model`을 쓰지 않으면 설치기가 다운로드합니다.
+- PATH의 Edge TTS CLI 또는 로컬 `.venv-tts/bin/edge-tts`; 필요하면 설치기가 로컬 helper를 만듭니다.
+- `.env`, `instances/<name>.env`, `~/.zshrc`, runtime env 중 하나에 Discord bot token.
+- 선택한 CLI 하네스가 설치되고 인증되어 있어야 합니다.
+
+### 아직 public release 전에 보강하면 좋은 것
+
+- GitHub Actions CI.
+- Demo video / GIF.
+- Discord bot setup screenshots.
+- 스크립트 수준 검증을 넘어 실제 여러 Linux 배포판에서 더 넓은 검증.
+- 모든 logging path 보안 리뷰.

package/docs/i18n/USAGE.ko.md

@@ -0,0 +1,119 @@
+# VerbalCoding 사용 가이드
+
+이 문서는 README에 다 넣기에는 긴 실제 운영 방법을 모아 둔 사용 설명서입니다.
+
+## CLI 명령
+
+```bash
+vc setup --yes                # npm 설치 후 의존성 부트스트랩과 설정 마법사 실행
+vc start                      # 기본 Discord 음성 브릿지 시작
+vc status                     # STT 언어, 진행 언어, TTS 음성 상태 보기
+vc language en                # 영어 STT + 영어 진행/TTS 음성
+vc language ko                # 한국어 STT + 한국어 진행/TTS 음성
+vc language auto              # Whisper 자동 언어 감지 + 진행/TTS 음성 프리셋
+vc restart auto status        # 커밋 시 음성 봇 자동 재시작 설정 보기
+vc restart auto on            # 커밋 시 음성 봇 자동 재시작 켜기
+vc restart auto off           # 자동 재시작 끄기; 기본값
+vc bot invite CLIENT_ID       # 필요한 권한이 포함된 Discord 초대 URL 출력
+vc instance status            # 인스턴스별 설정과 프로세스 상태 목록 보기
+vc instance setup NAME        # instances/NAME.env 작성 및 Hermes 프로필 생성
+vc instance start NAME        # ./run.sh instances/NAME.env를 백그라운드로 시작
+vc instance stop NAME         # 백그라운드 인스턴스 중지 및 pid 파일 제거
+vc doctor                     # 비밀값을 숨긴 상태 점검 실행
+npm run mcp                   # stdio MCP 서버 실행
+```
+
+언어 변경은 `.env`를 수정합니다. 적용하려면 `vc start`, `./run.sh`, 또는 사용 중인 프로세스 매니저로 브릿지를 재시작하세요.
+
+## 실행 모드
+
+npm으로 설치한 기본 브릿지:
+
+```bash
+vc start
+```
+
+GitHub 클론에서 직접 실행:
+
+```bash
+./run.sh
+```
+
+프로젝트별 인스턴스 env로 실행:
+
+```bash
+./run.sh instances/my-project.env
+# 또는
+VERBALCODING_INSTANCE_ENV=instances/my-project.env ./run.sh
+```
+
+봇은 설정된 음성 채널 이름 중 첫 번째로 자동 입장합니다. 기본값은 `일반,General,general`입니다.
+
+## Discord 명령
+
+| 명령 | 용도 |
+|---|---|
+| `!ping` | 봇 연결 기본 확인 |
+| `!join` / `!leave` | 음성 채널 입장/퇴장 |
+| `!say <text>` | 텍스트를 바로 TTS로 읽기 |
+| `!voice-test <text>` | 현재 TTS 백엔드 테스트 |
+| `!voice-clone capture` | 다음 유효 발화를 OpenVoice 기준 샘플로 저장 |
+| `!voice-clone status` / `!voice-clone cancel` | 샘플 캡처 상태 확인/취소 |
+| `!ask <prompt>` | 음성과 같은 선택된 CLI 어댑터로 텍스트 요청 보내기 |
+| `!session status` | 현재 프로젝트/default 에이전트 세션 보기 |
+| `!session new <name> <workdir> [context] --voice <voice-channel>` | 프로젝트 단위 Hermes 세션 생성 |
+| `!session attach-voice [sessionName] --voice <voice-channel>` | 현재 텍스트 채널/스레드를 음성 채널에 연결 |
+| `!session list` | 설정된 프로젝트 세션 목록 보기 |
+| `!session reset` / `!reset-session` | 현재 프로젝트/default 세션 파일 초기화 |
+| `!verbose on/off` | 자세한 진행 업데이트 켜기/끄기 |
+| `!latency` / `!metrics` | 최근 지연 시간 요약 보기 |
+| `!sensitivity normal/conservative` | 끼어들기 감도 전환 |
+
+음성으로도 “외부 모드”, “보수 모드”, “실내”, “기본 감도” 같은 감도 전환과 “잠깐”, “멈춰”, “그만” 같은 명확한 중단 표현을 처리합니다. “상세 진행 켜” / “상세 진행 꺼”처럼 말해서 verbose progress도 바꿀 수 있습니다.
+
+## 자세한 진행 모드
+
+자세한 진행은 기본적으로 꺼져 있습니다. `.env`에 `AGENT_VERBOSE_PROGRESS=1`을 설정하거나 Discord에서 `!verbose on`, 또는 음성으로 “상세 진행 켜”라고 말해 켤 수 있습니다.
+
+켜져 있으면 긴 작업 중 이런 짧은 진행 줄을 텍스트로 보냅니다.
+
+```text
+🤖 에이전트 호출 시작
+📖 파일 읽기 app-node/main.mjs
+🔎 웹 검색 실행
+⌨️ 터미널 명령 실행
+🤖 에이전트 응답 수신
+```
+
+이 모드는 선택된 CLI 하네스에 `VERBALCODING_PROGRESS: ...` 줄을 내보내도록 요청하고, 가능하면 stdout/stderr의 일반적인 도구 사용 흔적도 요약합니다. 비밀값처럼 보이는 필드는 숨기고, 진행 줄은 최종 음성 답변에서 제거합니다.
+
+## 지연 시간 지표
+
+VerbalCoding은 각 턴의 지연 시간 기록을 JSONL로 저장합니다. 기본 경로:
+
+```text
+./.logs/latency.jsonl
+```
+
+각 기록에는 상태, 전체 시간, 음성 캡처 시간, 발화 idle 대기, STT 시간, 에이전트 시간, TTS 합성/재생 시간, 청크 수, 발화 길이, 답변 길이, 가능한 경우 오디오 레벨이 포함됩니다.
+
+Discord에서:
+
+```text
+!latency
+!metrics
+```
+
+요약은 최근 200개 기록 기준으로 count, average, p95, max, non-OK 상태를 보여줍니다.
+
+## 테스트
+
+```bash
+node --check app-node/main.mjs
+npm test
+bash -n run.sh scripts/install.sh
+npm pack --dry-run
+vc doctor
+```
+
+`vc doctor`는 비밀값을 출력하지 않고 필수 값이 설정됐는지만 확인합니다. 또한 `instances/*.env`에서 중복 토큰 지문과 충돌하는 런타임 경로를 검사합니다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "verbalcoding",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Discord voice bridge for CLI coding agents.",
   "license": "MIT",
   "repository": {