cdsa-harness 0.20.1 → 0.21.0

package/package.json

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

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();
+  });
+}