deel-local-cli 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 yunseok
+
+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.en.md

@@ -0,0 +1,246 @@
+# deel-local-cli
+
+A coding agent CLI that runs entirely on **local models or your own private gateway**.
+**Zero dependencies** — nothing but Node's own standard library.
+
+> The interface and source comments are in Korean. This file is the English guide.
+
+---
+
+## Why zero dependencies
+
+This was built for an offline corporate network where installing third-party
+software requires review. `dependencies` is empty and stays empty — that fact is
+the argument you hand to a security team.
+
+```
+npm ls           →  no dependencies
+cat package.json →  "dependencies": {}
+```
+
+All you need is **Node 20+**. There is no `npm install` step.
+
+---
+
+## Install
+
+```bash
+npm install -g deel-local-cli
+# or run without installing
+npx deel-local-cli setup
+```
+
+For an air-gapped machine, copy the folder across and run `node bin/deel.js`
+directly. Nothing is installed on the target machine.
+
+---
+
+## Connect
+
+```bash
+deel setup
+```
+
+It asks for a name, base URL and API key, probes the endpoint, lists the models
+it found, and saves the profile to `~/.deel/config.json`.
+
+Point it at anything OpenAI-compatible:
+
+| | Example URL |
+|---|---|
+| Private AI gateway | `https://ai-gw.example.corp/v1` |
+| Ollama | `http://localhost:11434` |
+| LM Studio | `http://localhost:1234/v1` |
+| vLLM / LiteLLM | `http://host:port/v1` |
+
+The auth style is detected automatically — `Authorization: Bearer`, `x-api-key`,
+`api-key` (Azure-style), or none.
+
+### Keeping the key out of the config file
+
+```bash
+export DEEL_API_KEY=sk-xxxx      # takes precedence over the file
+deel diagnose --url https://ai-gw.example.corp/v1 --model sec-llm-01
+```
+
+Other environment variables: `NODE_EXTRA_CA_CERTS` (corporate CA),
+`HTTPS_PROXY`, `DEEL_DEBUG=1` (full stack traces).
+
+---
+
+## Diagnose a gateway
+
+Before trusting an endpoint, find out what it actually supports:
+
+```bash
+deel diagnose --url <base-url> --key <key> --model <model> --out report.txt
+```
+
+| Check | Why it matters |
+|---|---|
+| Basic chat | URL, key and model name are right |
+| System message | Whether rules and skills take effect |
+| Streaming | Whether output can arrive token by token |
+| **Tool calling** | **Whether files can be read and edited — the critical one** |
+| **Tool result round-trip** | **Whether multi-turn works — the agent loop depends on it** |
+| Structured output | Whether edit formats can be schema-enforced |
+| Reasoning effort | Whether `/think` reaches the model |
+| Context length | How many files fit at once |
+
+It ends with a verdict: **ready / limited / blocked / unreachable**, plus a
+plain-text report you can hand to whoever runs the gateway.
+
+Reasoning models are handled correctly: if all output lands in `thinking` and
+the body gets truncated, it retries with thinking disabled instead of reporting
+a false failure.
+
+---
+
+## Chat
+
+Run it inside the folder you want to work in. That folder becomes the **scope** —
+nothing outside it can be read or written, even if the model asks.
+
+```
+  deel  sec-llm-01  ·  /home/you/project
+  skills: 337 · commands: 127 (42 plugins)
+
+› unify the log format
+
+  ⏺ Grep(console.log)
+    └ 1 file · 1 match
+
+  ⏺ Read(src/runner.js)
+    └ 5 lines
+
+  ⏺ Edit(src/runner.js)
+    └ 1 occurrence
+
+  Unified the log calls to the logger format. One change in runner.js.
+
+  ─ 4.2s · 3 tools · 180 tokens
+```
+
+### Slash commands
+
+Names follow the Claude Code / Codex convention.
+
+| Command | |
+|---|---|
+| `/help` | list commands |
+| `/context` | context usage — what is taking up room |
+| `/compact` · `/clear` | shrink · wipe the conversation |
+| `/model` | switch connection or model (conversation continues) |
+| `/think off\|low\|medium\|high\|max` | reasoning effort |
+| `/mode auto\|confirm\|strict` | execution mode |
+| `/undo [n]` | roll back the last n turns |
+| `/tools` · `/skills` | what is available |
+| `/cost` · `/status` | usage · connection |
+| `/init` | create a `DEEL.md` rules file |
+
+### Tools
+
+Names and arguments match Claude Code, so skills and commands written for that
+convention work unchanged.
+
+`Read` · `Write` · `Edit` · `Glob` · `Grep` · `Bash` · `Skill`
+
+---
+
+## Edits survive sloppy models
+
+Models routinely get whitespace, indentation and line endings slightly wrong.
+`Edit` relaxes matching in stages — but **refuses outright when ambiguous**,
+because silently editing the wrong place is far worse than not finding it.
+
+```
+exact  →  trailing space & CRLF  →  indentation  →  all whitespace
+```
+
+Measured by `npm run bench`:
+
+```
+should-fix cases   exact-only 2/10 (20%)  →  staged 10/10 (100%)
+should-refuse      5/5 (100%)  ·  wrong-place edits: 0
+```
+
+When it fails, it points at the closest real line so the model can correct itself:
+
+```
+Not found.
+  Line 2 of the file is closest:
+    console.log("start: " + id);
+  Copy that line verbatim and try again.
+```
+
+---
+
+## Skills and commands come from the host machine
+
+Nothing is bundled. On startup it scans:
+
+```
+project  ./.deel/skills   ./.claude/skills   ./.deel/commands   ./.claude/commands
+user     ~/.deel/skills   ~/.claude/skills   ~/.claude/commands
+plugins  ~/.claude/plugins/**   (any folder with .claude-plugin/plugin.json)
+```
+
+It reads the Claude Code format: `SKILL.md` with YAML frontmatter,
+`commands/*.md` with `$ARGUMENTS` substitution.
+
+### Loaded in three stages
+
+Listing everything would blow the context window. So:
+
+| Stage | What | Cost |
+|---|---|---|
+| 1 | name + one-line description in the system prompt | ~1,800 tokens for 40 |
+| 2 | the model calls `Skill` for the one body it wants | one at a time |
+| 3 | files that body references, via `Read` | only if needed |
+
+On a machine with 337 skills, listing 40 costs about 1,800 tokens instead of
+well over 100,000.
+
+Not supported on purpose: **hooks** (executable scripts — a review problem and an
+extra failure path for autonomous execution), **subagents** (doubles model calls
+against a gateway quota), and **MCP** (a separate protocol, a project of its own).
+
+---
+
+## Safety without approval prompts
+
+The default mode is `auto`: it edits files and runs commands without asking.
+The safety net is that everything is **reversible**, not that everything is gated.
+
+| | |
+|---|---|
+| **Undo** | every file is snapshotted before it changes; `/undo` restores by turn |
+| **Scope** | the starting folder is a hard boundary |
+| **Blocked commands** | only irreversible ones — disk format, recursive delete, force-push, piping downloads into a shell. Ordinary commands pass |
+| **No re-run** | a mutating command is never retried after failure — running it twice is the accident |
+| **Audit log** | everything lands in `.deel/audit.jsonl` |
+
+`/mode confirm` asks before irreversible commands; `/mode strict` asks before
+every file change and command.
+
+---
+
+## Development
+
+```bash
+npm run check   # syntax across every module
+npm test        # 20 tool checks + 16 engine checks + the edit benchmark
+npm run demo    # see the chat screen, driven by a fake gateway
+npm run bench   # edit reliability numbers
+```
+
+The engine tests spin up a **fake OpenAI-compatible gateway** over HTTP. No real
+model is involved, so the loop, streaming parser, tool execution and undo are all
+verified deterministically — including the case where a gateway splits tool-call
+arguments across streaming chunks.
+
+---
+
+## License
+
+MIT

package/README.md

@@ -0,0 +1,322 @@
+# deel-local-cli
+
+로컬 모델·사내 게이트웨이 전용 코딩 에이전트. **외부 패키지를 하나도 쓰지 않습니다.**
+
+> English guide: [README.en.md](README.en.md)
+
+**3단계(편집 신뢰성)·5단계(스킬)까지 되어 있습니다.** 실제로 파일을 읽고 고치며, 그 PC 에 있는 스킬·명령을 찾아 씁니다.
+
+---
+
+## 왜 의존성이 0개인가
+
+사내 반입 심사에서 "미승인 소프트웨어"로 걸리지 않기 위해서입니다.
+`package.json`의 `dependencies`가 비어 있고, Node에 원래 들어 있는 기능만 씁니다.
+
+```
+확인 방법:  npm ls          →  의존성 없음
+            cat package.json →  "dependencies": {}
+```
+
+필요한 것은 **Node 20 이상**뿐입니다. `npm install`을 하지 않습니다.
+
+---
+
+## 대화 시작하기
+
+작업할 폴더에서:
+
+```
+deel        # 또는 설치 없이:  node <이폴더>/bin/deel.js
+```
+
+그 폴더가 **작업 범위**가 됩니다. 밖의 파일은 읽지도 쓰지도 못합니다.
+
+```
+  deel  sec-llm-01  ·  C:\work\myproject
+  /help 로 명령 목록.  Ctrl+C 로 끝냅니다.
+
+› 로그 형식 통일해줘
+
+  ⏺ Grep(console.log)
+    └ 1개 파일 · 1건
+
+  ⏺ Read(src/runner.js)
+    └ 5줄
+
+  ⏺ Edit(src/runner.js)
+    └ 1군데
+
+  로그 호출을 logger 형식으로 통일했습니다.
+
+  ─ 4.2초 · 도구 3회 · 180토큰
+```
+
+### 슬래시 명령
+
+Claude Code / Codex 와 같은 이름을 씁니다.
+
+| 명령 | 하는 일 |
+|---|---|
+| `/help` | 명령 목록 |
+| `/context` | 컨텍스트 사용량 — 무엇이 자리를 먹는지 |
+| `/compact` | 오래된 대화 줄이기 |
+| `/clear` | 대화 비우기 |
+| `/model` | 연결·모델 바꾸기 (대화는 이어짐) |
+| `/think off\|low\|medium\|high\|max` | 추론 강도 |
+| `/mode auto\|confirm\|strict` | 실행 모드 |
+| `/undo [턴수]` | 되돌리기 |
+| `/tools` | 도구 목록 |
+| `/cost` | 이번 세션 사용량 |
+| `/status` | 연결 상태 |
+| `/init` | `DEEL.md` 규칙 파일 만들기 |
+| `/exit` | 끝내기 |
+
+### 도구 6종
+
+이름과 인자를 Claude Code 와 같게 맞췄습니다. 그 관례로 쓰인 스킬·명령이 그대로 먹습니다.
+
+| 도구 | 하는 일 |
+|---|---|
+| `Read` | 파일 읽기 (줄 번호 붙음) |
+| `Write` | 파일 쓰기·덮어쓰기 |
+| `Edit` | 정확한 문자열 하나 바꾸기 |
+| `Glob` | 이름 패턴으로 파일 찾기 |
+| `Grep` | 내용 정규식 검색 |
+| `Bash` | 명령 실행 |
+| `Skill` | 스킬 본문 펼쳐 읽기 (스킬이 있을 때만 모델에게 보임) |
+
+#### 편집이 조금 틀려도 찾아냅니다
+
+모델은 공백·들여쓰기·줄바꿈을 자주 틀립니다. 단계적으로 완화해 찾되, **모호하면 무조건 거부**합니다 —
+엉뚱한 곳을 조용히 고치는 것이 못 찾는 것보다 훨씬 나쁘기 때문입니다.
+
+```
+정확히 일치  →  줄 끝 공백·CRLF 무시  →  들여쓰기 무시  →  모든 공백 무시
+```
+
+`npm run bench` 로 잰 결과: **정확히 일치만 쓰면 20%, 지금은 100%. 엉뚱한 곳을 고친 경우 0건.**
+
+못 찾으면 파일에서 가장 비슷한 줄을 짚어 줍니다:
+
+```
+찾지 못했습니다.
+  파일의 2번 줄이 가장 비슷합니다:
+    console.log("실행 시작: " + id);
+  이 줄을 그대로 옮겨 담아 다시 시도하세요.
+```
+
+---
+
+## 스킬·명령 — 그 PC 에 있는 것을 씁니다
+
+deel 는 스킬을 품고 다니지 않습니다. 켜질 때 아래를 훑어 **있는 것을 그대로** 씁니다.
+
+```
+프로젝트  ./.deel/skills   ./.claude/skills   ./.deel/commands   ./.claude/commands
+사용자    ~/.deel/skills   ~/.claude/skills   ~/.claude/commands
+플러그인  ~/.claude/plugins/**   (.claude-plugin/plugin.json 이 있는 폴더)
+```
+
+Claude Code 와 같은 형식(`SKILL.md` + YAML 앞머리, `commands/*.md`, `$ARGUMENTS`)을 읽습니다.
+
+### 3단계로 나눠 올립니다
+
+전부 올리면 컨텍스트가 죽습니다. 그래서:
+
+| 단계 | 무엇을 | 비용 |
+|---|---|---|
+| 1 | 이름 + 설명 한 줄만 프롬프트에 | 40개 기준 약 1,800토큰 |
+| 2 | 모델이 `Skill` 도구로 고른 것의 본문만 | 필요할 때 1개씩 |
+| 3 | 본문이 가리키는 파일은 `Read` 로 | 그때 또 |
+
+`/context` 에서 스킬 목록이 얼마나 먹는지 바로 보입니다.
+
+```
+/skills               지금 올라간 것 보기
+/skills <검색어>       찾아보기
+/skills on <검색어>    걸리는 것만 올리기
+/skills all | off     전부 올리기 | 내리기
+```
+
+### 슬래시 명령도 그대로
+
+찾은 명령은 `/<플러그인>:<이름>` 으로 부릅니다. `$ARGUMENTS` 가 치환됩니다.
+
+```
+› /ecc:code-review src/app.js
+  ⌘ ecc:code-review plugin
+```
+
+### 안 넣은 것
+
+| | 이유 |
+|---|---|
+| hooks | 실행 스크립트라 사내 반입 심사에 걸리고, 자율 실행에 사고 경로를 늘립니다 |
+| 서브에이전트 | 모델 호출이 배로 늘어 게이트웨이 할당량을 먹습니다 |
+| MCP | 별도 프로토콜이라 그 자체로 하나의 프로젝트입니다 |
+
+### 안전망
+
+승인 프롬프트 대신 **되돌릴 수 있게** 만들었습니다. 기본 모드는 `auto` — 묻지 않고 알아서 합니다.
+
+| 장치 | 내용 |
+|---|---|
+| **되돌리기** | 파일을 고치기 전 항상 스냅샷. `/undo` 로 턴 단위 복구 |
+| **작업 범위** | 시작한 폴더 밖은 모델이 시켜도 거부 |
+| **위험 명령 차단** | 되돌릴 수 없는 것만 (디스크 포맷, 재귀 삭제, `--force` 푸시 등). 평범한 명령은 통과 |
+| **재실행 금지** | 변경성 명령은 실패해도 다시 실행하지 않음 — 두 번 돌면 사고 |
+| **감사 로그** | `.deel/audit.jsonl` 에 전부 기록 |
+
+`/mode confirm` 은 되돌릴 수 없는 명령만, `/mode strict` 는 파일 변경·명령을 전부 물어봅니다.
+
+---
+
+## 사내망에서 진단 돌리기
+
+압축을 풀고 그 폴더에서:
+
+```
+node bin/deel.js diagnose --url <게이트웨이주소> --key <키> --model <모델> --out report.txt
+```
+
+예시:
+
+```
+node bin/deel.js diagnose --url https://ai-gw.example.corp/v1 --key sk-xxxx --model sec-llm-01 --out report.txt
+```
+
+`report.txt` 파일 하나만 가져오시면 됩니다. 색 없는 평문이라 그대로 붙여넣을 수 있습니다.
+
+### 키를 파일에 안 남기고 싶으면
+
+```
+set DEEL_API_KEY=sk-xxxx
+node bin/deel.js diagnose --url https://ai-gw.example.corp/v1 --model sec-llm-01 --out report.txt
+```
+
+환경변수가 설정 파일보다 우선합니다.
+
+---
+
+## 대화형으로 설정하기
+
+```
+node bin/deel.js setup
+```
+
+이름 → 주소 → 키를 물어보고, 붙어보고, 모델 목록을 띄워 고르게 한 뒤,
+진단까지 돌리고 저장합니다. 저장 위치는 `~/.deel/config.json`입니다.
+
+이후에는:
+
+```
+node bin/deel.js              연결 상태 보기
+node bin/deel.js diagnose     저장된 연결로 진단 다시 돌리기
+```
+
+---
+
+## 무엇을 검사하는가
+
+| 검사 | 왜 보는가 |
+|---|---|
+| 기본 대화 | 주소·키·모델 이름이 맞는지 |
+| 시스템 메시지 | 규칙(DEEL.md)과 스킬이 먹는지 |
+| 스트리밍 | 화면이 한 글자씩 흐를 수 있는지 |
+| **도구 호출** | **파일을 읽고 고칠 수 있는지 — 가장 중요** |
+| **도구 결과 되돌리기** | **여러 턴이 이어지는지 — 에이전트 루프의 전제** |
+| 구조적 출력 | 편집 형식을 스키마로 강제할 수 있는지 |
+| 추론 강도 조절 | `/think` 가 모델 층에서 먹는지 |
+| 컨텍스트 길이 | 파일을 몇 개까지 한 번에 읽힐 수 있는지 |
+
+마지막에 **판정**이 나옵니다.
+
+| 판정 | 뜻 |
+|---|---|
+| 준비됨 | 에이전트 루프를 그대로 올릴 수 있음 |
+| 제한적 | 돌아가지만 편집 신뢰성 보강이 필요 |
+| 막힘 | 도구 호출이 안 됨 — 게이트웨이 설정을 확인해야 함 |
+| 연결실패 | 주소·키·인증서·프록시 문제 |
+
+---
+
+## 붙는 서버
+
+주소만 넣으면 규격을 알아서 찾습니다.
+
+| | 주소 예 |
+|---|---|
+| 사내 AI 게이트웨이 (OpenAI 호환) | `https://ai-gw.example.corp/v1` |
+| Ollama | `http://localhost:11434` |
+| LM Studio | `http://localhost:1234/v1` |
+| vLLM · LiteLLM | `http://호스트:포트/v1` |
+
+인증 방식도 자동으로 맞춥니다 — `Authorization: Bearer`, `x-api-key`, `api-key`(Azure 계열), 인증 없음 순으로 시도합니다.
+
+---
+
+## 연결이 안 될 때
+
+| 증상 | 확인할 것 |
+|---|---|
+| `주소를 찾을 수 없습니다` | 주소 오타, DNS, 사내망 접속 여부 |
+| `연결이 거부되었습니다` | 서버가 꺼져 있거나 포트가 다름 |
+| `인증서 문제` | `set NODE_EXTRA_CA_CERTS=C:\경로\사내CA.pem` |
+| 프록시를 거쳐야 함 | `set HTTPS_PROXY=http://프록시:포트` |
+| 401 / 403 | 키가 틀렸거나 인증 헤더 형식이 다름 (진단이 4가지를 자동 시도합니다) |
+
+자세한 오류를 보려면 `set DEEL_DEBUG=1`.
+
+---
+
+## 폴더 구조
+
+```
+bin/deel.js            진입점
+src/
+  ui/                  색·한글 폭·입력·스피너
+  config.js            연결 프로필 저장/읽기
+  backend/http.js      HTTP 한 겹 + 인증 방식 4종
+  backend/detect.js    규격·인증 자동 판별
+  backend/adapter.js   OpenAI/Ollama 차이 흡수 + 스트리밍 파서
+  backend/probe.js     진단 검사 8종
+  tools/index.js       도구 6종
+  tools/fsutil.js      glob·파일 훑기 (직접 구현)
+  safety/guard.js      작업 범위 + 위험 명령 차단
+  safety/undo.js       스냅샷·되돌리기
+  safety/audit.js      감사 로그
+  agent/session.js     대화 상태 + 컨텍스트 셈
+  agent/loop.js        에이전트 루프
+  commands.js          슬래시 명령
+  repl.js              대화 화면
+  report.js            진단 표 + 판정
+  setup.js             마법사
+test/                  검증 (배포 zip 에서 뺀다)
+```
+
+## 검증
+
+```
+npm test      도구 20건 + 엔진 16건
+npm run demo  화면이 어떻게 보이는지 실제로 돌려 보기
+```
+
+엔진 검증은 **가짜 게이트웨이**를 띄워서 합니다. 실제 모델 없이 OpenAI 호환 규격 그대로
+루프·스트리밍·도구 실행·되돌리기를 결정적으로 확인합니다.
+
+---
+
+## 다음 단계
+
+| 단계 | 내용 | 상태 |
+|---|---|---|
+| 1 | 연결 설정 + 진단 | 됨 |
+| 2 | 엔진 — 루프 · 도구 6종 · 되돌리기 · 감사로그 | 됨 |
+| 4 | 화면 — 스트리밍 · 도구 배지 · 슬래시 명령 · `/context` | 됨 (2단계에서 같이) |
+| 7 | 추론 조절 — `/think`, `/mode`, 도구 호출 상한 | 반쯤 (모델 층·루프 층까지) |
+| 3 | 편집 신뢰성 — 단계별 완화 매칭 · 실패 안내 · 성공률 측정 | 됨 (20%→100%) |
+| 5 | 스킬·명령 발견 + 3단계 적재 | 됨 |
+| **6** | **플러그인 — `/plugin install` · `/plugin pack`** | **다음** |
+| 7 | 추론 조절 — 작업 층 (단계별 다른 모델) | 남음 |
+| 8 | 반입 패키징 + 외부통신 0건 검증 | 남음 |

package/bin/deel.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+// deel 진입점. 외부 의존성 없음 — Node 표준 기능만 씁니다.
+import { c, say } from '../src/ui/ansi.js';
+import { runSetup, runDiagnose, showStatus, banner } from '../src/setup.js';
+import { chatLoop } from '../src/repl.js';
+
+const MIN_NODE = 20;
+
+function parse(argv) {
+  const flags = {};
+  const args = [];
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '-h') { flags.help = true; continue; }
+    if (a.startsWith('--')) {
+      const [k, inline] = a.slice(2).split('=');
+      if (inline !== undefined) flags[k] = inline;
+      else if (argv[i + 1] && !argv[i + 1].startsWith('-')) flags[k] = argv[++i];
+      else flags[k] = true;
+    } else args.push(a);
+  }
+  // 명령은 플래그가 아닌 첫 낱말. 없으면 상태 보기.
+  return { cmd: args[0] ?? '', args: args.slice(1), flags };
+}
+
+function help() {
+  banner();
+  say(`  ${c.bold('사용법')}`);
+  say('');
+  say(`    ${c.cyan('deel')}                        대화 시작 (이 폴더에서)`);
+  say(`    ${c.cyan('deel setup')}                  연결 설정 (주소·키·모델)`);
+  say(`    ${c.cyan('deel status')}                 연결 상태 보기`);
+  say(`    ${c.cyan('deel diagnose')}               저장된 연결로 진단 다시 돌리기`);
+  say('');
+  say(`  ${c.bold('대화 시작 옵션')}`);
+  say('');
+  say(`    ${c.gray('--root <폴더>')}      작업 범위. 기본은 지금 폴더`);
+  say(`    ${c.gray('--mode <모드>')}      auto(기본) / confirm / strict`);
+  say(`    ${c.gray('--think <수준>')}     off / low / medium(기본) / high / max`);
+  say('');
+  say(`  ${c.bold('진단 직접 지정')} ${c.gray('— 설정을 남기지 않고 확인만 할 때')}`);
+  say('');
+  say(`    deel diagnose --url <주소> --key <키> --model <모델> --out report.txt`);
+  say('');
+  say(`  ${c.bold('환경변수')}`);
+  say('');
+  say(`    ${c.gray('DEEL_API_KEY')}          키를 파일에 안 남기고 싶을 때 (파일보다 우선)`);
+  say(`    ${c.gray('NODE_EXTRA_CA_CERTS')}   사내 인증서를 쓰는 게이트웨이일 때`);
+  say(`    ${c.gray('HTTPS_PROXY')}           프록시를 거쳐야 할 때`);
+  say('');
+}
+
+async function main() {
+  const major = parseInt(process.versions.node.split('.')[0], 10);
+  if (major < MIN_NODE) {
+    say(`  Node ${MIN_NODE} 이상이 필요합니다. 지금은 ${process.versions.node} 입니다.`);
+    process.exit(1);
+  }
+
+  const { cmd, flags } = parse(process.argv.slice(2));
+  if (flags.help || cmd === 'help') { help(); return 0; }
+
+  switch (cmd) {
+    case '':
+    case 'chat':
+      return chatLoop({
+        root: flags.root ? String(flags.root) : undefined,
+        mode: flags.mode ? String(flags.mode) : undefined,
+        think: flags.think ? String(flags.think) : undefined,
+      });
+    case 'status':
+      return showStatus();
+    case 'setup':
+      return runSetup();
+    case 'diagnose':
+    case 'doctor':
+      return runDiagnose(flags);
+    default:
+      say('');
+      say(`  ${c.red('모르는 명령')} ${c.bold(cmd)}`);
+      help();
+      return 1;
+  }
+}
+
+main()
+  .then((code) => process.exit(code ?? 0))
+  .catch((err) => {
+    say('');
+    say(`  ${c.red('오류')} ${err?.message ?? err}`);
+    if (process.env.DEEL_DEBUG) say(c.gray(err?.stack ?? ''));
+    say('');
+    process.exit(1);
+  });