cdsa-harness 0.20.1 → 0.21.1

package/README.md

@@ -231,7 +231,6 @@ cdsa-harness
   "provider": "openai",
   "api_key": "",
   "model": "gpt-4o-mini",
-  "workspace": ".",
   "approval_mode": "manual",
   "allow_shell": false,
   "max_steps": 8,

package/package.json

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

package/src/cli.js

@@ -28,6 +28,7 @@ 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";
+import { selectMenu } from "./select.js";
 
 // VERSION 은 src/builtins.js(생성물)에서 가져온다 — npm/exe 양쪽에서 동일.
 
@@ -333,6 +334,12 @@ async function pickModel(ask, cfg, query = "") {
     console.log(c.yellow(`'${query}' 에 맞는 모델이 없습니다.`) + c.dim("  예: /models claude · /models gpt"));
     return null;
   }
+  // ↑↓ 방향키 메뉴(TTY) — 파이프/CI 에선 아래 번호 입력으로 폴백
+  const menuSel = await selectMenu(list.slice(0, 50), {
+    title: `🤖 모델 선택 — ${cfg.provider}${live ? " (실시간)" : " (추천)"}${list.length > 50 ? ` · 상위 50/${list.length} — 검색어로 좁히세요` : ""}`,
+    current: cfg.model,
+  });
+  if (menuSel !== undefined) return menuSel; // 선택(문자열) 또는 취소(null)
   const shown = list.slice(0, 15);
   const lines = shown.map((m, i) => {
     const cur = m === cfg.model ? c.green(" ← 현재") : "";
@@ -519,20 +526,24 @@ function cleanKey(s) {
 // 대화형 연결 설정. 키는 환경변수가 있으면 그걸 우선 안내(파일 저장 안 함).
 // ask 가 null 을 주면(Ctrl+C) 조용히 취소.
 async function runSetup(ask, cfg) {
-  console.log(panel(
-    [
-      "어떤 AI 에 연결할까요? 번호를 입력하세요.",
-      `  ${c.bold("1")}) openai      (GPT, 키: ${ENV_KEYS.openai})`,
-      `  ${c.bold("2")}) anthropic   (Claude, 키: ${ENV_KEYS.anthropic})`,
-      `  ${c.bold("3")}) openrouter  (여러 모델 중계, 키: ${ENV_KEYS.openrouter})`,
-      `  ${c.bold("4")}) ollama      (로컬·폐쇄망 LLM, 키 불필요) 🏢`,
-      `  ${c.bold("5")}) mock        (키 없이 연습)`,
-    ],
-    { title: "🔌 연결 설정 (/setup)", color: "cyan" }
-  ));
-  const pickRaw = await ask(c.cyan("제공자 번호 [1-5] (취소: Enter): "));
-  if (pickRaw === null) return false;
-  const provider = { "1": "openai", "2": "anthropic", "3": "openrouter", "4": "ollama", "5": "mock" }[pickRaw.trim()];
+  const PROVIDER_ITEMS = [
+    ["openai", "openai — GPT (키: OPENAI_API_KEY)"],
+    ["anthropic", "anthropic — Claude (키: ANTHROPIC_API_KEY)"],
+    ["openrouter", "openrouter — 여러 모델 중계 (키: OPENROUTER_API_KEY)"],
+    ["ollama", "ollama — 로컬·폐쇄망 LLM, 키 불필요 🏢"],
+    ["mock", "mock — 키 없이 연습"],
+  ];
+  let provider = null;
+  const provSel = await selectMenu(PROVIDER_ITEMS.map(([, l]) => l), { title: "🔌 어떤 AI 에 연결할까요? (/setup)", current: (PROVIDER_ITEMS.find(([k]) => k === cfg.provider) || [])[1] });
+  if (provSel === null) { console.log(c.yellow("취소했습니다.")); return false; }
+  if (provSel !== undefined) {
+    provider = PROVIDER_ITEMS[PROVIDER_ITEMS.findIndex(([, l]) => l === provSel)][0];
+  } else {
+    console.log(panel(PROVIDER_ITEMS.map(([, l], i) => `  ${c.bold(String(i + 1))}) ${l}`), { title: "🔌 연결 설정 (/setup)", color: "cyan" }));
+    const pickRaw = await ask(c.cyan("제공자 번호 [1-5] (취소: Enter): "));
+    if (pickRaw === null) return false;
+    provider = (PROVIDER_ITEMS[parseInt(pickRaw.trim(), 10) - 1] || [])[0];
+  }
   if (!provider) {
     console.log(c.yellow("취소했습니다."));
     return false;
@@ -835,31 +846,7 @@ export async function main(argv = []) {
   // 첫 실행 온보딩(한 번만 — ~/.cdsa_harness/.welcomed 표시): 작업 폴더 설정 + 튜토리얼
   const markerPath = path.join(configDir(), ".welcomed");
   if (stdin.isTTY && !fs.existsSync(markerPath)) {
-    console.log(panel(
-      [
-        "AI 가 파일을 다룰 ‘작업 폴더’를 정하세요.",
-        c.dim("이 폴더 밖은 절대 건드리지 않아요(안전장치)."),
-        "",
-        `  ${c.bold("엔터")}  ${c.cyan("지금 이 폴더")} 를 그대로 사용 (터미널답게, 기본)`,
-        `  ${c.bold("경로")}  따로 격리하고 싶으면 입력 — 예) ${c.cyan("./sandbox")} 또는 ${c.cyan("C:\\작업\\프로젝트")}`,
-      ],
-      { title: "📁 작업 폴더 설정 (처음 한 번)", color: "cyan" }
-    ));
-    const wsAns = await ask(c.cyan("작업 폴더 [엔터=기본]: "));
-    if (wsAns !== null && wsAns.trim()) {
-      cfg.workspace = wsAns.trim();
-      const rebuilt = await buildExtensions(cfg, mcp);
-      toolbox = rebuilt.toolbox;
-      skills = rebuilt.skills;
-      loop.toolbox = toolbox;
-      loop.reset();
-    }
-    try {
-      saveConfig(cfg);
-    } catch {
-      /* 저장 실패 무시 */
-    }
-    console.log(c.green(`작업 폴더: ${cfg.workspacePath()}`) + c.dim("  (나중에 /workspace 로 변경 가능)\n"));
+    console.log(c.dim(`작업 폴더 = 지금 이 폴더 (${cfg.workspacePath()}) — 바꾸려면 /workspace <경로>\n`));
 
     const a = await ask(c.cyan("짧은 튜토리얼을 볼까요? [Y/n] "));
     if (a !== null && ["", "y", "yes"].includes(a.trim().toLowerCase())) await runTutorial(ask);
@@ -871,8 +858,16 @@ export async function main(argv = []) {
     }
   }
 
+  let pendingInput = null; // 메뉴에서 고른 명령을 다음 루프에서 입력처럼 실행
   while (true) {
-    const raw = await ask(c.bold(c.cyan("› ")));
+    let raw;
+    if (pendingInput !== null) {
+      raw = pendingInput;
+      pendingInput = null;
+      console.log(c.bold(c.cyan("› ")) + raw);
+    } else {
+      raw = await ask(c.bold(c.cyan("› ")));
+    }
     if (raw === null) break; // Ctrl+D / Ctrl+C / 스트림 종료
     const user = raw.trim();
     if (!user) continue;
@@ -880,7 +875,27 @@ export async function main(argv = []) {
 
     if (["/quit", "/exit", "quit", "exit", ":q"].includes(low)) break;
     if (user === "/") {
+      // ↑↓ 메뉴로 명령 선택 → 바로 실행 (Tab 몰라도 됨)
+      const CMD_DESC = {
+        "/new": "새 대화", "/compact": "대화를 모델이 요약·압축", "/resume": "지난 대화 이어가기",
+        "/undo": "마지막 파일 변경 되돌리기", "/context": "모델에 보내는 컨텍스트 보기",
+        "/init": "모델이 AGENT.md 규칙 생성", "/memory": "규칙 파일 보기", "/workspace": "작업 폴더 보기/변경",
+        "/setup": "AI 연결 마법사", "/models": "모델 목록에서 선택", "/auto": "자동 수락 토글",
+        "/status": "상태·누적 토큰", "/update": "최신 버전으로 업데이트", "/teach": "교육 모드 토글",
+        "/stream": "스트리밍 토글", "/skills": "스킬 목록", "/plugins": "플러그인 목록", "/mcp": "MCP 서버",
+        "/guide": "빠른 시작 안내", "/tutorial": "튜토리얼", "/help": "전체 도움말", "/about": "정보", "/quit": "종료",
+      };
       const skillNames = Object.keys(skills).sort();
+      const menuItems = [
+        ...Object.entries(CMD_DESC).map(([k, v]) => `${k}  ${v}`),
+        ...skillNames.map((s) => `/${s}  ${(skills[s].description || "").slice(0, 34)}`),
+      ];
+      const sel = await selectMenu(menuItems, { title: "⌨️  명령 선택 — ↑↓ 이동 · Enter 실행" , window: 14 });
+      if (sel !== undefined) {
+        if (sel) pendingInput = sel.split(/\s{2,}/)[0];
+        continue;
+      }
+      // (비TTY 폴백) 텍스트 팔레트
       console.log(panel([
         c.bold("대화")+"      "+c.cyan("/new /compact /resume /undo /context"),
         c.bold("프로젝트")+"  "+c.cyan("/init /memory /workspace"),
@@ -1185,12 +1200,17 @@ export async function main(argv = []) {
         await runTurn(renderSkill(skills[name], argStr));
       } else {
         const { BUILTIN_COMMANDS } = await import("./completion.js");
-        const all = [...BUILTIN_COMMANDS, ...Object.keys(skills).map((s) => "/" + s)];
-        const near = all.filter((n) => n.includes(name.slice(0, 3)) || n.slice(1).startsWith(name[0] || "")).slice(0, 4);
+        const all = [...new Set([...BUILTIN_COMMANDS, ...Object.keys(skills).map((s) => "/" + s)])].sort();
+        const near = all.filter((n) => n.slice(1).startsWith(name) || n.includes(name.slice(0, 3)));
+        if (near.length) {
+          const sel = await selectMenu(near.slice(0, 20), { title: `'/${name}' — 이 중에 찾으시나요? (↑↓·Enter)` });
+          if (sel) { pendingInput = sel; continue; }
+          if (sel === null) continue; // 취소
+        }
         console.log(
           c.yellow(`알 수 없는 명령: /${name}`) +
-            (near.length ? c.dim("  혹시? ") + c.cyan(near.join(" ")) : "") +
-            c.dim("  · '/' 입력=팔레트 · Tab=자동완성")
+            (near.length ? c.dim("  혹시? ") + c.cyan(near.slice(0, 4).join(" ")) : "") +
+            c.dim("  · '/' 입력=명령 메뉴")
         );
       }
       continue;

package/src/config.js

@@ -91,7 +91,10 @@ export class Config {
 
   toJSON() {
     const out = {};
-    for (const key of Object.keys(DEFAULTS)) out[key] = this[key];
+    for (const key of Object.keys(DEFAULTS)) {
+      if (key === "workspace") continue; // 실행 폴더가 곧 워크스페이스 — 저장하지 않는다
+      out[key] = this[key];
+    }
     return out;
   }
 }
@@ -100,7 +103,10 @@ export function loadConfig() {
   const p = configPath();
   try {
     if (fs.existsSync(p)) {
-      return new Config(JSON.parse(fs.readFileSync(p, "utf8")));
+      const data = JSON.parse(fs.readFileSync(p, "utf8"));
+      // workspace 는 '실행한 폴더'가 진리 — 파일에 저장된 값(옛 버전 잔재)은 무시한다.
+      delete data.workspace;
+      return new Config(data);
     }
   } catch {
     // 손상된 설정은 무시하고 기본값

package/src/loop.js

@@ -154,6 +154,12 @@ export class AgentLoop {
         : "- 당신은 상위 에이전트가 위임한 하위 작업을 수행하는 서브에이전트다. 주어진 작업만 완수하고, 결과를 명확한 텍스트로 보고하라.",
       pluginNames ? `- 추가 도구: ${pluginNames}` : null,
       "",
+      "# CDSA Harness 자체 사용법 — 사용자가 이 도구의 설정·사용법을 물으면 아래로 정확히 답하라",
+      "- 설정 파일: 홈폴더/.cdsa_harness/config.json (실행 폴더에 config.json 이 있으면 그쪽 우선).",
+      '- MCP 연결: 설정 파일에 \"mcpServers\": { \"이름\": { \"command\": \"npx\", \"args\": [\"-y\",\"서버패키지\"] } } — Claude Code/Cursor 와 동일 형식. 저장 후 재시작하면 /mcp 에 표시.',
+      "- 주요 명령: /setup 연결마법사 · /models 모델선택 · /workspace 작업폴더 변경 · /auto 자동승인 · /update 업데이트 · /mcp /plugins /skills 목록 · /help 전체 · /guide 시작안내.",
+      "- 확장: 스킬 = 작업폴더/.cdsa/skills/*.md (또는 홈/.cdsa_harness/skills), 플러그인 = .cdsa/plugins/*.mjs 또는 npm 'cdsa-harness-plugin-*' 설치.",
+      "",
       "# 응답 스타일",
       "- 한국어로, 간결하게. 불필요한 서론·사과 없이 핵심부터.",
       "- 작업이 끝나면 도구를 더 호출하지 말고 무엇을 했는지 요약한다.",

package/src/select.js

@@ -0,0 +1,113 @@
+// ↑↓ 방향키 인터랙티브 선택 메뉴 (의존성 0, raw keypress).
+// TTY 가 아니면 null 을 즉시 반환 → 호출측이 번호 입력 폴백을 쓴다(파이프/CI 호환).
+import readline from "node:readline";
+import { c } from "./ui.js";
+
+const HIDE = "\x1b[?25l";
+const SHOW = "\x1b[?25h";
+
+export function selectMenu(items, { title = "", current = null, window = 12 } = {}) {
+  const stdin = process.stdin;
+  const out = process.stdout;
+  if (!stdin.isTTY || !out.isTTY || !items.length) return Promise.resolve(undefined); // 미지원 → 호출측 폴백
+
+  return new Promise((resolve) => {
+    let idx = items.indexOf(current);
+    if (idx < 0) idx = 0;
+    let rendered = 0;
+    let digits = "";
+    let done = false;
+
+    const clampTop = () => {
+      let top = idx - Math.floor(window / 2);
+      top = Math.max(0, Math.min(top, items.length - window));
+      return Math.max(0, top);
+    };
+
+    const render = () => {
+      if (rendered) out.write(`\x1b[${rendered}A`);
+      let n = 0;
+      const line = (s) => {
+        out.write("\x1b[2K" + s + "\n");
+        n++;
+      };
+      if (title) line(c.bold(c.cyan(title)));
+      const top = clampTop();
+      const end = Math.min(items.length, top + window);
+      if (top > 0) line(c.dim(`   ↑ ${top}개 더`));
+      for (let i = top; i < end; i++) {
+        const isCur = i === idx;
+        const tag = items[i] === current ? c.green("  ← 현재") : "";
+        const num = c.dim(String(i + 1).padStart(2) + " ");
+        if (isCur) line(c.cyan(c.bold("▸ ")) + num + c.bold(c.cyan(items[i])) + tag);
+        else line("  " + num + items[i] + tag);
+      }
+      if (end < items.length) line(c.dim(`   ↓ ${items.length - end}개 더`));
+      line(c.dim("↑↓ 이동 · Enter 선택 · 숫자 바로이동 · Esc/q 취소"));
+      rendered = n;
+    };
+
+    // 기존 readline(rl)의 keypress 리스너를 잠시 떼어내 이중 처리를 막는다.
+    readline.emitKeypressEvents(stdin);
+    const saved = stdin.rawListeners("keypress");
+    for (const l of saved) stdin.removeListener("keypress", l);
+    const wasRaw = stdin.isRaw;
+    try {
+      stdin.setRawMode(true);
+    } catch { /* 일부 환경 */ }
+    stdin.resume();
+    out.write(HIDE);
+
+    const finish = (value) => {
+      if (done) return;
+      done = true;
+      stdin.removeListener("keypress", onKey);
+      try {
+        stdin.setRawMode(Boolean(wasRaw));
+      } catch { /* */ }
+      for (const l of saved) stdin.on("keypress", l);
+      // 메뉴 지우고 선택 결과 한 줄만 남긴다
+      if (rendered) out.write(`\x1b[${rendered}A`);
+      for (let i = 0; i < rendered; i++) out.write("\x1b[2K\n");
+      out.write(`\x1b[${rendered}A`);
+      out.write(SHOW);
+      if (value !== null) out.write(c.dim("선택: ") + c.green(value) + "\n");
+      else out.write(c.dim("(선택 취소)") + "\n");
+      resolve(value);
+    };
+
+    const onKey = (str, key) => {
+      if (done) return;
+      const name = key && key.name;
+      if ((key && key.ctrl && name === "c") || name === "escape" || str === "q") return finish(null);
+      if (name === "return" || name === "enter") {
+        if (digits) {
+          const n = parseInt(digits, 10);
+          if (n >= 1 && n <= items.length) idx = n - 1;
+          digits = "";
+        }
+        return finish(items[idx]);
+      }
+      if (name === "up" || str === "k") {
+        idx = (idx - 1 + items.length) % items.length;
+        digits = "";
+      } else if (name === "down" || str === "j") {
+        idx = (idx + 1) % items.length;
+        digits = "";
+      } else if (str >= "0" && str <= "9") {
+        digits += str;
+        const n = parseInt(digits, 10);
+        if (n >= 1 && n <= items.length) idx = n - 1;
+        else digits = str; // 범위 밖이면 새로 시작
+        const n2 = parseInt(digits, 10);
+        if (n2 >= 1 && n2 <= items.length) idx = n2 - 1;
+      } else {
+        return;
+      }
+      render();
+    };
+
+    stdin.on("keypress", onKey);
+    render();
+  });
+}