cdsa-harness 0.18.0 → 0.20.0

package/README.md

@@ -16,6 +16,8 @@
 - **`/resume`** — 지난 대화 자동 저장·이어가기, ↑↓ 명령 히스토리도 세션 간 유지
 - **서브에이전트** — 모델이 큰 작업을 `spawn_agent` 로 하위 에이전트에 위임(화면엔 `┆` 로 구분, 중첩 위임 차단)
 - **`/update`** — 명령 한 번으로 자기 자신을 최신 버전으로 업데이트(npm 설치본)
+- **Tab 자동완성** — `/명령`(내장+스킬) · `/provider` 인자 · `@파일명` 멘션까지 Tab 으로 완성
+- **모델 선택 UI** — `/models [검색어]` 로 제공자별 **실시간 모델 목록**에서 번호로 선택(OpenRouter·OpenAI·Anthropic·Ollama)
 - **교육 모드** — 매 반복마다 모델에 보내는 메시지 구성·추정 토큰·시스템 프롬프트, 실제 토큰 사용량/응답시간까지 그대로 표시
 - **MCP 클라이언트** — Claude Code·Cursor 등과 **공용 표준**. MCP 서버를 그대로 붙여 도구로 사용
 - **플러그인** — npm 으로 설치하거나 `.cdsa/plugins/` 에 JS 파일 → **도구 자동 등록**
@@ -79,9 +81,10 @@ Claude Code·OpenCode 컨벤션을 따릅니다.
 | `/undo` | 마지막 파일 변경 되돌리기 |
 | `/init` · `/memory` | **모델이 폴더를 파악해 AGENT.md 생성** · 규칙 파일 보기 |
 | `/auto` | 자동 수락 토글 (신뢰가 쌓이면 diff 승인 생략) |
-| `/status` (=`/cost`) · `/models` | 상태·세션 누적 토큰 · 모델 목록(ollama 는 설치분 실시간) |
+| `/status` (=`/cost`) | 상태 · 세션 누적 토큰 |
+| `/models [검색어]` | **실시간 모델 목록에서 번호로 선택**(4개 제공자 모두) |
 | `/guide` · `/tutorial` | 빠른 시작 안내 · 단계별 인터랙티브 튜토리얼 |
-| `/workspace <폴더>` | 작업 폴더 보기/변경 (`.` = 현재 폴더) |
+| `/workspace <폴더>` | 작업 폴더 보기/변경 — **기본은 현재 폴더(cwd)**, 터미널답게 |
 | `/color` | 색상 켜기/끄기(흑백) |
 | `/setup` | 제공자·API 키·모델 대화형 연결 |
 | `/provider <이름>` | openai · anthropic · openrouter · mock 전환 |
@@ -228,7 +231,7 @@ cdsa-harness
   "provider": "openai",
   "api_key": "",
   "model": "gpt-4o-mini",
-  "workspace": "./workspace",
+  "workspace": ".",
   "approval_mode": "manual",
   "allow_shell": false,
   "max_steps": 8,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdsa-harness",
-  "version": "0.18.0",
+  "version": "0.20.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.18.0";
+export const VERSION = "0.20.0";
 
 export const BUILTIN_PLUGINS = [p0];
 

package/src/cli.js

@@ -27,6 +27,7 @@ import { SessionLog, sessionsDir } from "./session.js";
 import { loadSkills, renderSkill } from "./skills.js";
 import { Toolbox } from "./tools.js";
 import { c, panel, renderDiff, renderMarkdown, setColor } from "./ui.js";
+import { makeCompleter } from "./completion.js";
 
 // VERSION 은 src/builtins.js(생성물)에서 가져온다 — npm/exe 양쪽에서 동일.
 
@@ -268,6 +269,78 @@ async function buildExtensions(cfg, mcp) {
   return { toolbox, skills };
 }
 
+async function fetchJson(url, headers = {}, timeoutMs = 4000) {
+  const ctrl = new AbortController();
+  const t = setTimeout(() => ctrl.abort(), timeoutMs);
+  try {
+    const res = await fetch(url, { headers, signal: ctrl.signal });
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+    return await res.json();
+  } finally {
+    clearTimeout(t);
+  }
+}
+
+// 제공자별 '쓸 수 있는 모델' 목록. 가능하면 실시간(live), 실패 시 추천 목록으로 폴백.
+async function fetchProviderModels(cfg, query = "") {
+  const q = query.trim().toLowerCase();
+  const key = cfg.resolvedKey();
+  try {
+    if (cfg.provider === "openrouter") {
+      const r = await fetchJson("https://openrouter.ai/api/v1/models");
+      let ids = (r.data || []).map((m) => m.id).sort();
+      if (q) ids = ids.filter((id) => id.toLowerCase().includes(q));
+      return { list: ids, live: true };
+    }
+    if (cfg.provider === "ollama") {
+      const host = (cfg.base_url || "http://localhost:11434/v1/chat/completions").replace(/\/v1\/.*$/, "");
+      const r = await fetchJson(`${host}/api/tags`, {}, 2500);
+      let ids = (r.models || []).map((m) => m.name);
+      if (q) ids = ids.filter((id) => id.toLowerCase().includes(q));
+      return { list: ids, live: true };
+    }
+    if (cfg.provider === "openai" && key) {
+      const r = await fetchJson("https://api.openai.com/v1/models", { Authorization: `Bearer ${key}` });
+      let ids = (r.data || []).map((m) => m.id).filter((id) => /^(gpt|o\d)/.test(id)).sort();
+      if (q) ids = ids.filter((id) => id.toLowerCase().includes(q));
+      return { list: ids, live: true };
+    }
+    if (cfg.provider === "anthropic" && key) {
+      const r = await fetchJson("https://api.anthropic.com/v1/models", { "x-api-key": key, "anthropic-version": "2023-06-01" });
+      let ids = (r.data || []).map((m) => m.id);
+      if (q) ids = ids.filter((id) => id.toLowerCase().includes(q));
+      return { list: ids, live: true };
+    }
+  } catch { /* 폴백으로 */ }
+  let list = SUGGESTED_MODELS[cfg.provider] || [];
+  if (q) list = list.filter((m) => m.toLowerCase().includes(q));
+  return { list, live: false };
+}
+
+// 번호로 고르는 모델 선택 UI. 선택하면 모델명, 취소하면 null 반환.
+async function pickModel(ask, cfg, query = "") {
+  process.stdout.write(c.dim("모델 목록을 불러오는 중…\r"));
+  const { list, live } = await fetchProviderModels(cfg, query);
+  if (!list.length) {
+    console.log(c.yellow(`'${query}' 에 맞는 모델이 없습니다.`) + c.dim("  예: /models claude · /models gpt"));
+    return null;
+  }
+  const shown = list.slice(0, 15);
+  const lines = shown.map((m, i) => {
+    const cur = m === cfg.model ? c.green(" ← 현재") : "";
+    return `  ${c.bold(String(i + 1).padStart(2))}) ${m}${cur}`;
+  });
+  if (list.length > shown.length) lines.push(c.dim(`  … 외 ${list.length - shown.length}개 — '/models <검색어>' 로 좁히세요`));
+  lines.push(c.dim(live ? "  (실시간 목록)" : "  (추천 목록 — 키 연결 시 실시간 조회)"));
+  console.log(panel(lines, { title: `🤖 모델 선택 — ${cfg.provider}`, color: "cyan" }));
+  const a = await ask(c.cyan("번호 또는 모델명 입력 (엔터=취소): "));
+  if (a === null || !a.trim()) return null;
+  const s = a.trim();
+  const n = parseInt(s, 10);
+  if (Number.isInteger(n) && n >= 1 && n <= shown.length) return shown[n - 1];
+  return s; // 직접 입력한 이름 허용
+}
+
 function makeClient(cfg) {
   return new LLMClient({
     provider: cfg.provider,
@@ -504,13 +577,9 @@ async function runSetup(ask, cfg) {
     }
     const sugg = SUGGESTED_MODELS[provider] || [];
     const def = sugg[0] || "";
-    const note = provider === "openrouter" ? c.dim("  (OpenRouter 는 'provider/model' 형식)") : "";
-    const m = await ask(c.cyan(`모델 [${def}]${note}\n  추천: ${sugg.join(", ")}\n  > `));
-    if (m === null) {
-      console.log(c.yellow("취소했습니다."));
-      return false;
-    }
-    cfg.model = m.trim() || def;
+    const picked = await pickModel(ask, cfg); // 실시간 목록에서 번호로 선택
+    cfg.model = picked || def;
+    if (!picked) console.log(c.dim(`기본 모델 사용: ${def}`));
   }
 
   const saved = saveConfig(cfg);
@@ -593,7 +662,15 @@ export async function main(argv = []) {
   try {
     savedHistory = fs.readFileSync(histPath, "utf8").split("\n").filter(Boolean).slice(0, 200);
   } catch { /* 첫 실행 */ }
-  const rl = readline.createInterface({ input: stdin, output: stdout, history: savedHistory, historySize: 200 });
+  // Tab 자동완성: 슬래시 명령(내장+스킬) · /provider 인자 · @파일 멘션
+  let toolbox = null;
+  let skills = {};
+  const completer = makeCompleter({
+    skills: () => skills,
+    workspace: () => (toolbox ? toolbox.workspace : null),
+    providers: PROVIDERS,
+  });
+  const rl = readline.createInterface({ input: stdin, output: stdout, history: savedHistory, historySize: 200, completer });
   const saveHistory = () => {
     try {
       fs.mkdirSync(configDir(), { recursive: true });
@@ -683,7 +760,7 @@ export async function main(argv = []) {
     mcp = await connectMcpServers(cfg.mcpServers);
   }
   // 플러그인·스킬·도구상자를 작업 폴더 기준으로 구성(작업 폴더 변경 시 재사용)
-  let { toolbox, skills } = await buildExtensions(cfg, mcp);
+  ({ toolbox, skills } = await buildExtensions(cfg, mcp));
   if (toolbox.plugins.length || Object.keys(skills).length || toolbox.pluginErrors.length || mcp.servers.length) {
     const bits = [];
     if (toolbox.plugins.length) bits.push(c.green(`도구 +${toolbox.plugins.length}개`));
@@ -755,9 +832,8 @@ export async function main(argv = []) {
         "AI 가 파일을 다룰 ‘작업 폴더’를 정하세요.",
         c.dim("이 폴더 밖은 절대 건드리지 않아요(안전장치)."),
         "",
-        `  ${c.bold("엔터")}  기본값 ${c.cyan("./workspace")} (하위 폴더 자동 생성)`,
-        `  ${c.bold(".")}     지금 이 폴더를 그대로 사용`,
-        `  ${c.bold("경로")}  예) ${c.cyan("./문서")} 또는 ${c.cyan("C:\\작업\\프로젝트")}`,
+        `  ${c.bold("엔터")}  ${c.cyan("지금 이 폴더")} 를 그대로 사용 (터미널답게, 기본)`,
+        `  ${c.bold("경로")}  따로 격리하고 싶으면 입력 — 예) ${c.cyan("./sandbox")} 또는 ${c.cyan("C:\\작업\\프로젝트")}`,
       ],
       { title: "📁 작업 폴더 설정 (처음 한 번)", color: "cyan" }
     ));
@@ -919,23 +995,17 @@ export async function main(argv = []) {
       );
       continue;
     }
-    // /models — 쓸 수 있는 모델 나열 (ollama 는 설치된 모델 실시간 조회)
-    if (low === "/models") {
-      if (cfg.provider === "ollama") {
-        const host = (cfg.base_url || "http://localhost:11434/v1/chat/completions").replace(/\/v1\/.*$/, "");
-        try {
-          const ctrl = new AbortController();
-          const t = setTimeout(() => ctrl.abort(), 2000);
-          const res = await fetch(`${host}/api/tags`, { signal: ctrl.signal });
-          clearTimeout(t);
-          const models = ((await res.json()).models || []).map((m) => m.name);
-          console.log(panel(models.length ? models.map((m) => (m === cfg.model ? c.green("● " + m) : "  " + m)) : [c.dim("설치된 모델 없음 — ollama pull <모델>")], { title: `🤖 Ollama 모델 (${host})`, color: "cyan" }));
-        } catch {
-          console.log(c.yellow(`Ollama(${host})에 연결하지 못했습니다 — ollama serve 확인.`));
-        }
+    // /models [검색어] — 모델 목록에서 번호로 선택(제공자별 실시간 조회)
+    if (low === "/models" || low.startsWith("/models ")) {
+      const query = user.split(/\s+/).slice(1).join(" ");
+      const picked = await pickModel(ask, cfg, query);
+      if (picked) {
+        cfg.model = picked;
+        loop.client = makeClient(cfg);
+        saveConfig(cfg);
+        console.log(c.green(`모델 변경 → ${picked}`) + c.dim("  (저장됨)"));
       } else {
-        const sugg = SUGGESTED_MODELS[cfg.provider] || [];
-        console.log(panel(sugg.map((m) => (m === cfg.model ? c.green("● " + m) : "  " + m)), { title: `🤖 추천 모델 (${cfg.provider}) — 변경: /model <이름>`, color: "cyan" }));
+        console.log(c.dim("변경하지 않았습니다."));
       }
       continue;
     }

package/src/completion.js

@@ -0,0 +1,56 @@
+// Tab 자동완성 — readline completer (의존성 0).
+// 지원: /슬래시명령(내장+스킬) · /provider 인자 · @파일명 멘션(작업 폴더 최상위)
+import fs from "node:fs";
+
+export const BUILTIN_COMMANDS = [
+  "/help", "/guide", "/tutorial", "/about",
+  "/setup", "/provider", "/model", "/models", "/update",
+  "/teach", "/stream", "/color", "/auto",
+  "/context", "/status", "/cost", "/config", "/sessions",
+  "/workspace", "/cd", "/init", "/memory",
+  "/skills", "/plugins", "/mcp",
+  "/new", "/clear", "/reset", "/compact", "/resume", "/undo",
+  "/quit", "/exit",
+];
+
+// ctx: { skills(): {name:...}, workspace(): string|null, providers: string[] }
+export function makeCompleter(ctx) {
+  return (line) => {
+    // 1) /provider <인자> 자동완성
+    if (line.startsWith("/provider ")) {
+      const frag = line.slice("/provider ".length);
+      const hits = (ctx.providers || [])
+        .filter((p) => p.startsWith(frag))
+        .map((p) => "/provider " + p);
+      return [hits, line];
+    }
+    // 2) 슬래시 명령(내장 + 스킬) — 첫 단어 입력 중일 때
+    if (line.startsWith("/") && !line.includes(" ")) {
+      let skills = {};
+      try {
+        skills = ctx.skills() || {};
+      } catch { /* 초기화 전 */ }
+      const names = [...new Set([...BUILTIN_COMMANDS, ...Object.keys(skills).map((s) => "/" + s)])].sort();
+      const hits = names.filter((n) => n.startsWith(line));
+      return [hits.length ? hits : names, line];
+    }
+    // 3) @파일명 멘션 — 작업 폴더 최상위 파일
+    const m = /@([\w가-힣./\\-]*)$/.exec(line);
+    if (m) {
+      let ws = null;
+      try {
+        ws = ctx.workspace();
+      } catch { /* 초기화 전 */ }
+      if (ws) {
+        let files = [];
+        try {
+          files = fs.readdirSync(ws).filter((f) => !f.startsWith("."));
+        } catch { /* ignore */ }
+        const head = line.slice(0, m.index);
+        const hits = files.filter((f) => f.startsWith(m[1])).map((f) => head + "@" + f);
+        return [hits, line];
+      }
+    }
+    return [[], line];
+  };
+}

package/src/config.js

@@ -34,7 +34,7 @@ const DEFAULTS = {
   api_key: "",
   base_url: "", // OpenAI 호환 사내/폐쇄망 LLM 의 전체 엔드포인트 직접 지정(있으면 우선)
   model: "mock-agent",
-  workspace: "./workspace",
+  workspace: ".", // 기본 = 현재 폴더(cwd). Claude Code/OpenCode 와 동일 — 별도 폴더를 만들지 않는다.
   approval_mode: "manual",
   allow_shell: false,
   max_steps: 8,
@@ -70,7 +70,7 @@ export class Config {
 
   // CLI 도구이므로 작업 폴더 상대경로는 '현재 폴더' 기준으로 해석한다(직관적).
   workspacePath() {
-    let p = this.workspace || "./workspace";
+    let p = this.workspace || ".";
     if (!path.isAbsolute(p)) p = path.resolve(process.cwd(), p);
     return p;
   }

package/src/loop.js

@@ -135,7 +135,8 @@ export class AgentLoop {
     const parts = [
       "# 정체성",
       "당신은 CDSA Harness(made by CDSA) 안에서 동작하는 코딩·업무 에이전트입니다.",
-      "파일시스템에 직접 접근할 수 없으며, 제공된 도구 호출로만 작업 폴더를 다룹니다.",
+      "작업 폴더의 파일을 도구(list_dir/read_file/search_files/edit_file/write_file)로 직접 읽고·검색하고·수정할 수 있습니다.",
+      "'파일에 접근할 수 없다'고 답하지 마세요 — 필요한 도구를 호출하면 됩니다. 도구가 곧 당신의 손입니다.",
       "",
       "# 환경",
       `- 작업 폴더(루트): ${ws}`,

package/src/tools.js

@@ -86,7 +86,7 @@ export class Toolbox {
     const root = this.workspace + path.sep;
     if (candidate !== this.workspace && !candidate.startsWith(root)) {
       throw new ToolError(
-        `작업 폴더 밖 경로에는 접근할 수 없습니다: ${rel} (허용 루트: ${this.workspace})`
+        `작업 폴더 밖 경로입니다: ${rel} — 현재 작업 폴더는 ${this.workspace} 입니다. 다른 폴더에서 작업하려면 사용자가 /workspace <경로> 로 변경할 수 있다고 안내하세요.`
       );
     }
     return candidate;