cdsa-harness 0.14.2 → 0.19.0

package/README.md

@@ -9,8 +9,15 @@
 ```
 
 - **의존성 0개** — Node 18+ 내장 기능만(`fetch`/`readline`/`node:test`)
-- **실시간 스트리밍** — 모델 응답이 토큰 단위로 흐름(`/stream` 토글, OpenAI·Claude·mock)
-- **실제 LLM 연결** — OpenAI · Anthropic(Claude) · OpenRouter, 또는 키 없이 `mock`
+- **실시간 스트리밍** — 모델 응답이 토큰 단위로 흐름(`/stream` 토글)
+- **실제 LLM 연결** — OpenAI · Anthropic(Claude) · OpenRouter · **Ollama(로컬·폐쇄망, 키 불필요)** · `mock`
+- **에이전트 도구** — 폴더/파일 읽기 · `edit_file` 부분 수정 · `search_files` 재귀 검색 · 셸(옵션) · HWPX
+- **`@파일명` 멘션** — 입력에 `@memo.txt` 처럼 쓰면 파일 내용 자동 첨부
+- **`/resume`** — 지난 대화 자동 저장·이어가기, ↑↓ 명령 히스토리도 세션 간 유지
+- **서브에이전트** — 모델이 큰 작업을 `spawn_agent` 로 하위 에이전트에 위임(화면엔 `┆` 로 구분, 중첩 위임 차단)
+- **`/update`** — 명령 한 번으로 자기 자신을 최신 버전으로 업데이트(npm 설치본)
+- **Tab 자동완성** — `/명령`(내장+스킬) · `/provider` 인자 · `@파일명` 멘션까지 Tab 으로 완성
+- **모델 선택 UI** — `/models [검색어]` 로 제공자별 **실시간 모델 목록**에서 번호로 선택(OpenRouter·OpenAI·Anthropic·Ollama)
 - **교육 모드** — 매 반복마다 모델에 보내는 메시지 구성·추정 토큰·시스템 프롬프트, 실제 토큰 사용량/응답시간까지 그대로 표시
 - **MCP 클라이언트** — Claude Code·Cursor 등과 **공용 표준**. MCP 서버를 그대로 붙여 도구로 사용
 - **플러그인** — npm 으로 설치하거나 `.cdsa/plugins/` 에 JS 파일 → **도구 자동 등록**
@@ -66,8 +73,16 @@ export OPENROUTER_API_KEY=sk-or-...
 
 ## 슬래시 명령
 
+Claude Code·OpenCode 컨벤션을 따릅니다.
+
 | 명령 | 설명 |
 |------|------|
+| `/new` (=`/clear`) · `/compact` · `/resume` | 새 대화 · **모델이 대화를 요약해 압축** · 지난 대화 이어가기 |
+| `/undo` | 마지막 파일 변경 되돌리기 |
+| `/init` · `/memory` | **모델이 폴더를 파악해 AGENT.md 생성** · 규칙 파일 보기 |
+| `/auto` | 자동 수락 토글 (신뢰가 쌓이면 diff 승인 생략) |
+| `/status` (=`/cost`) | 상태 · 세션 누적 토큰 |
+| `/models [검색어]` | **실시간 모델 목록에서 번호로 선택**(4개 제공자 모두) |
 | `/guide` · `/tutorial` | 빠른 시작 안내 · 단계별 인터랙티브 튜토리얼 |
 | `/workspace <폴더>` | 작업 폴더 보기/변경 (`.` = 현재 폴더) |
 | `/color` | 색상 켜기/끄기(흑백) |
@@ -186,6 +201,14 @@ npm pack cdsa-harness          # → cdsa-harness-x.y.z.tgz 생성
 npm install -g ./cdsa-harness-x.y.z.tgz   # 인터넷 불필요
 ```
 
+**Ollama — 인터넷 없이 로컬 LLM 으로 (가장 쉬움):**
+```bash
+# 폐쇄망 PC 에 Ollama 와 모델(예: qwen2.5:7b, exaone3.5)을 반입·설치한 뒤
+cdsa-harness
+› /setup   → 4) ollama 선택 (키 불필요, 설치된 모델 자동 감지)
+```
+> 원격 Ollama 서버는 주소만 입력(예: `http://10.0.0.5:11434`). `OLLAMA_HOST` 환경변수도 인식.
+
 **사내/폐쇄망 LLM (OpenAI 호환 서버 — vLLM, 내부 게이트웨이 등):**
 `config.json` 의 `base_url` 에 **전체 엔드포인트**를 적으면 그쪽으로 호출합니다.
 ```json
@@ -226,8 +249,12 @@ npm install -g ./cdsa-harness-x.y.z.tgz   # 인터넷 불필요
 |------|------|:----:|
 | `list_dir` | 폴더 나열 | 자동 |
 | `read_file` | 파일 읽기 | 자동 |
-| `write_file` | 파일 생성/수정 | **diff 승인** |
+| `search_files` | 파일명·내용 재귀 검색 | 자동 |
+| `write_file` | 새 파일/전체 덮어쓰기 | **diff 승인** |
+| `edit_file` | **부분 수정**(old→new 치환) | **diff 승인** |
 | `run_shell` | 셸 실행 | **승인**(기본 차단) |
+| `spawn_agent` | 하위 에이전트에 작업 위임(중첩 불가) | 자동 |
+| `hwpx_read` | 한컴 .hwpx 본문 추출 | 자동 |
 
 모든 도구는 작업 폴더 밖으로 나갈 수 없습니다(경로 sandbox).
 
@@ -252,6 +279,13 @@ node-cli/
 └── test/core.test.js     # node --test
 ```
 
+## 설계 철학
+
+1. **모델이 먼저다** — 하드코딩 대신 모델에게 시킨다. `/init`(규칙 파일 생성)·`/compact`(대화 압축)는 로직이 아니라 **모델이 직접 수행**한다. 지금 70% 작동하는 것이 다음 모델에선 90%가 된다.
+2. **단순함이 속도다** — 웹앱이 아닌 CLI. `read + edit + search + shell` 최소 프리미티브 위에 스킬·플러그인·MCP 로 나머지 전부를 쌓는다. 의존성 0개.
+3. **신뢰의 전환** — 처음엔 모든 변경을 diff 로 승인받고, 신뢰가 쌓이면 `/auto` 로 자동 수락. 승인이 반복되면 도구가 먼저 전환을 제안한다.
+4. **접근성의 민주화** — 예산 없는 조직도 쓸 수 있게: 폐쇄망 Ollama·단일 실행파일·공공 업무 스킬 기본 내장.
+
 ## 테스트
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdsa-harness",
-  "version": "0.14.2",
+  "version": "0.19.0",
   "description": "AI 에이전트의 내부 동작을 단계별로 드러내는 교육용 터미널 하네스. 실시간 스트리밍 + OpenAI/Claude/OpenRouter + MCP + npm 플러그인·크로스포맷 스킬.",
   "type": "module",
   "bin": {

package/src/builtins.js

@@ -2,7 +2,7 @@
 // 스킬/플러그인/버전을 바꾼 뒤 `node scripts/gen-builtins.mjs` 로 재생성하세요.
 import p0 from "../plugins/hwpx_read.mjs";
 
-export const VERSION = "0.14.2";
+export const VERSION = "0.19.0";
 
 export const BUILTIN_PLUGINS = [p0];