cdsa-harness 0.14.0 → 0.18.0

package/src/cli.js

@@ -17,7 +17,7 @@ import {
   loadConfig,
   saveConfig,
 } from "./config.js";
-import { execFileSync } from "node:child_process";
+import { execFileSync, execSync } from "node:child_process";
 
 import { AgentLoop, Step } from "./loop.js";
 import { LLMClient } from "./llm.js";
@@ -26,7 +26,7 @@ import { discoverNpmExtensions, loadPlugins } from "./plugins.js";
 import { SessionLog, sessionsDir } from "./session.js";
 import { loadSkills, renderSkill } from "./skills.js";
 import { Toolbox } from "./tools.js";
-import { c, panel, renderDiff, setColor } from "./ui.js";
+import { c, panel, renderDiff, renderMarkdown, setColor } from "./ui.js";
 
 // VERSION 은 src/builtins.js(생성물)에서 가져온다 — npm/exe 양쪽에서 동일.
 
@@ -87,8 +87,8 @@ function printTeach(ev, stream) {
         lines.push(`  ${roleColor(m.role.padEnd(9))} ${c.grey(`${m.chars}자${m.extra || ""}`)}`);
       }
       lines.push(c.grey(`제공 도구(${d.tools?.length || 0}): ${(d.tools || []).join(", ")}`));
-      console.log(panel(lines, { title: `🧠 ② LLM 호출 — 반복 ${d.iteration}`, color: "magenta" }));
-      if (d.systemPrompt) {
+      console.log(panel(lines, { title: `${d.sub ? "┆ " : ""}🧠 ② LLM 호출 — 반복 ${d.iteration}`, color: "magenta" }));
+      if (d.systemPrompt && !d.sub) {
         console.log(panel(clip(d.systemPrompt, 600).split("\n"), {
           title: "📜 시스템 프롬프트 (규칙+폴더가 여기 주입됨)",
           color: "grey",
@@ -112,14 +112,14 @@ function printTeach(ev, stream) {
         return;
       }
       const lines = [];
-      if (ev.detail && ev.detail !== "(텍스트 없음)") lines.push(...clip(ev.detail, 1200).split("\n"));
+      if (ev.detail && ev.detail !== "(텍스트 없음)") lines.push(...renderMarkdown(clip(ev.detail, 1200)));
       for (const tc of d.toolCalls || []) {
         lines.push(c.yellow(`↳ 도구 호출 요청: ${c.bold(tc.name)}(${clip(JSON.stringify(tc.args), 200)})`));
       }
       const meta = replyMetaLine(d);
       if (meta) lines.push(c.grey("─ " + meta));
       else lines.push(c.dim("(mock: 토큰/지연 측정 없음)"));
-      console.log(panel(lines.length ? lines : ["(빈 응답)"], { title: "🤖 ③ 모델 응답 (원본 판단)", color: "green" }));
+      console.log(panel(lines.length ? lines : ["(빈 응답)"], { title: `${d.sub ? "┆ " : ""}🤖 ③ 모델 응답 (원본 판단)`, color: "green" }));
       return;
     }
 
@@ -145,7 +145,8 @@ function printTeach(ev, stream) {
       return;
 
     case Step.DONE:
-      console.log(panel((ev.detail || "완료").split("\n"), { title: "✅ 완료", color: "green" }));
+      if (d.sub) { console.log(c.grey("┆ ") + c.green("✅ 서브에이전트 완료")); return; }
+      console.log(panel(renderMarkdown(ev.detail || "완료"), { title: "✅ 완료", color: "green" }));
       return;
 
     case Step.ERROR:
@@ -166,10 +167,13 @@ function printCompact(ev, stream) {
       for (const tc of d.toolCalls || []) console.log(c.yellow(`  ↳ ${tc.name}(${clip(JSON.stringify(tc.args), 120)})`));
       return;
     }
-    if (ev.detail && ev.detail !== "(텍스트 없음)") console.log(panel(ev.detail.split("\n"), { title: "🤖 모델", color: "green" }));
+    if (ev.detail && ev.detail !== "(텍스트 없음)") console.log(panel(renderMarkdown(ev.detail), { title: `${d.sub ? "┆ " : ""}🤖 모델`, color: "green" }));
     return;
   }
-  if (ev.step === Step.DONE) return console.log(panel((ev.detail || "완료").split("\n"), { title: "✅ 완료", color: "green" }));
+  if (ev.step === Step.DONE) {
+    if (ev.data && ev.data.sub) return console.log(c.grey("┆ ") + c.green("✅ 서브에이전트 완료"));
+    return console.log(panel(renderMarkdown(ev.detail || "완료"), { title: "✅ 완료", color: "green" }));
+  }
   if (ev.step === Step.ERROR) return console.log(panel((ev.detail || "").split("\n"), { title: `❌ ${ev.title}`, color: "red" }));
   if (ev.step === Step.FEEDBACK) return;
   let detail = clip((ev.detail || "").trim().replace(/\s+/g, " "), 110);
@@ -178,11 +182,14 @@ function printCompact(ev, stream) {
   console.log(line);
 }
 
-function makeApproval(ask) {
+function makeApproval(ask, cfg) {
+  let streak = 0; // 연속 승인 횟수 — 신뢰가 쌓이면 자동 수락을 제안한다
+  let hinted = false;
   return async (req) => {
-    if (req.toolName === "write_file") {
+    if (req.toolName === "write_file" || req.toolName === "edit_file") {
+      const label = req.toolName === "edit_file" ? "부분 수정 제안" : "파일 쓰기 제안";
       console.log(panel(renderDiff(req.diff || "(변경 미리보기 없음)"), {
-        title: `🔐 파일 수정 제안 — ${req.path}`,
+        title: `🔐 ${label} — ${req.path}`,
         color: "yellow",
       }));
     } else if (req.toolName === "run_shell") {
@@ -193,6 +200,11 @@ function makeApproval(ask) {
     const raw = await ask(c.yellow("이 작업을 승인하시겠습니까? [y/N] "));
     const ans = (raw || "").trim().toLowerCase();
     const approved = ans === "y" || ans === "yes";
+    streak = approved ? streak + 1 : 0;
+    if (approved && streak >= 3 && !hinted && cfg.approval_mode === "manual") {
+      hinted = true;
+      console.log(c.dim("💡 계속 승인 중이시네요 — 신뢰가 쌓였다면 ") + c.cyan("/auto") + c.dim(" 로 자동 수락을 켤 수 있어요."));
+    }
     return { approved, reason: approved ? "" : "사용자가 거부했습니다." };
   };
 }
@@ -247,7 +259,7 @@ async function buildExtensions(cfg, mcp) {
     ...mcp.errors.map((e) => ({ error: `MCP ${e}` })),
   ];
   const skills = {};
-  for (const s of npm.skills) skills[s.name] = { name: s.name, description: s.description || "", body: s.body, source: "(npm)" };
+  for (const s of npm.skills) skills[s.name] = { name: s.name, description: s.description || "", hint: s.hint || "", body: s.body, source: "(npm)" };
   Object.assign(
     skills,
     loadSkills(cfg.workspacePath(), { importForeign: cfg.import_foreign_skills, extraDirs: cfg.skill_dirs || [] })
@@ -271,7 +283,11 @@ function printIntro(cfg) {
   console.log(renderBanner());
   console.log(c.dim("AI 에이전트의 내부 동작을 단계별로 드러내는 교육용 하네스") + "  " + c.cyan("· made by CDSA"));
   console.log();
-  const keySource = cfg.provider === "mock" ? "-" : cfg.api_key ? "config.json" : ENV_KEYS[cfg.provider] && process.env[ENV_KEYS[cfg.provider]] ? `환경변수 ${ENV_KEYS[cfg.provider]}` : c.red("없음");
+  const keySource =
+    cfg.provider === "mock" ? "-"
+    : cfg.provider === "ollama" ? "불필요(로컬)"
+    : cfg.api_key ? "config.json"
+    : ENV_KEYS[cfg.provider] && process.env[ENV_KEYS[cfg.provider]] ? `환경변수 ${ENV_KEYS[cfg.provider]}` : c.red("없음");
   const rows = [
     ["버전", `v${VERSION}`],
     ["provider", cfg.provider],
@@ -384,25 +400,26 @@ function printHelp() {
       [
         c.bold("사용법"),
         `시키고 싶은 일을 한국어로 입력하세요. 예) ${c.cyan("notes.txt 맨 아래에 할 일 3개 추가해줘")}`,
+        `${c.cyan("@파일명")} 을 쓰면 그 파일 내용이 자동 첨부됩니다. 예) ${c.cyan("@memo.txt 이거 요약해줘")}`,
+        "",
+        c.bold("대화"),
+        `  ${c.cyan("/new")}(=/clear)  새 대화 · ${c.cyan("/compact")} 대화를 모델이 요약해 압축 · ${c.cyan("/resume")} 지난 대화 이어가기`,
+        `  ${c.cyan("/undo")}  마지막 파일 변경 되돌리기 · ${c.cyan("/context")} 모델에 보내는 컨텍스트 보기`,
         "",
-        c.bold("슬래시 명령"),
-        `  ${c.cyan("/guide")}    처음 사용자용 빠른 시작 안내`,
-        `  ${c.cyan("/tutorial")} 단계별 인터랙티브 튜토리얼`,
-        `  ${c.cyan("/color")}    색상 켜기/끄기(흑백)`,
-        `  ${c.cyan("/about")}    이 도구 정보(made by CDSA)`,
-        `  ${c.cyan("/setup")}    제공자·API 키·모델 연결(대화형)`,
-        `  ${c.cyan("/provider")} <openai|anthropic|openrouter|mock> 제공자 변경`,
-        `  ${c.cyan("/model")} <이름>   모델 변경`,
-        `  ${c.cyan("/teach")}    교육 모드 켜기/끄기(내부 과정 펼쳐보기)`,
-        `  ${c.cyan("/stream")}   실시간 스트리밍 출력 켜기/끄기`,
-        `  ${c.cyan("/context")}  지금 모델에 보내는 컨텍스트 들여다보기`,
+        c.bold("프로젝트"),
+        `  ${c.cyan("/init")}  모델이 폴더를 파악해 AGENT.md(프로젝트 규칙) 생성 · ${c.cyan("/memory")} 규칙 파일 보기`,
         `  ${c.cyan("/workspace")} <폴더>  작업 폴더 보기/변경 ('.' = 현재 폴더)`,
-        `  ${c.cyan("/skills")}   스킬 목록(.cdsa/skills 의 /명령들)`,
-        `  ${c.cyan("/plugins")}  플러그인 목록(파일·npm 추가 도구)`,
-        `  ${c.cyan("/mcp")}      연결된 MCP 서버/도구(다른 에이전트와 공용)`,
-        `  ${c.cyan("/reset")}    대화/컨텍스트 초기화`,
-        `  ${c.cyan("/config")}   현재 설정값`,
-        `  ${c.cyan("/quit")}     종료 (Ctrl+D)`,
+        "",
+        c.bold("모델·설정"),
+        `  ${c.cyan("/setup")} 연결 마법사 · ${c.cyan("/model")} <이름> 변경 · ${c.cyan("/models")} 목록(ollama 는 설치분) · ${c.cyan("/provider")} 전환`,
+        `  ${c.cyan("/auto")} 자동 수락 토글 · ${c.cyan("/status")}(=/cost) 상태·누적 토큰 · ${c.cyan("/update")} 자기 업데이트`,
+        `  ${c.cyan("/teach")} 내부과정 펼치기 · ${c.cyan("/stream")} 실시간 출력 · ${c.cyan("/color")} 색상`,
+        "",
+        c.bold("확장"),
+        `  ${c.cyan("/skills")} 스킬 목록 · ${c.cyan("/plugins")} 플러그인 · ${c.cyan("/mcp")} MCP 서버`,
+        "",
+        c.bold("기타"),
+        `  ${c.cyan("/guide")} 빠른 시작 · ${c.cyan("/tutorial")} 튜토리얼 · ${c.cyan("/about")} 정보 · ${c.cyan("/quit")} 종료(Ctrl+D)`,
         "",
         c.bold("교육 모드에서 보이는 단계"),
         "  ① 입력 → ② LLM 호출(컨텍스트·도구) → ③ 모델 응답(토큰·지연) →",
@@ -427,13 +444,14 @@ async function runSetup(ask, cfg) {
       `  ${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")}) mock        (키 없이 연습)`,
+      `  ${c.bold("4")}) ollama      (로컬·폐쇄망 LLM, 키 불필요) 🏢`,
+      `  ${c.bold("5")}) mock        (키 없이 연습)`,
     ],
     { title: "🔌 연결 설정 (/setup)", color: "cyan" }
   ));
-  const pickRaw = await ask(c.cyan("제공자 번호 [1-4] (취소: Enter): "));
+  const pickRaw = await ask(c.cyan("제공자 번호 [1-5] (취소: Enter): "));
   if (pickRaw === null) return false;
-  const provider = { "1": "openai", "2": "anthropic", "3": "openrouter", "4": "mock" }[pickRaw.trim()];
+  const provider = { "1": "openai", "2": "anthropic", "3": "openrouter", "4": "ollama", "5": "mock" }[pickRaw.trim()];
   if (!provider) {
     console.log(c.yellow("취소했습니다."));
     return false;
@@ -442,6 +460,29 @@ async function runSetup(ask, cfg) {
 
   if (provider === "mock") {
     cfg.model = "mock-agent";
+  } else if (provider === "ollama") {
+    const hostAns = await ask(c.cyan("Ollama 주소 [http://localhost:11434]: "));
+    if (hostAns === null) return false;
+    const host = (hostAns.trim() || "http://localhost:11434").replace(/\/+$/, "");
+    cfg.base_url = `${host}/v1/chat/completions`;
+    cfg.api_key = "ollama"; // 로컬 LLM 은 키가 필요 없다(호환용 자리표시)
+    // 설치된 모델 자동 감지(/api/tags) — 실패해도 조용히 추천 목록 사용
+    let installed = [];
+    try {
+      const ctrl = new AbortController();
+      const t = setTimeout(() => ctrl.abort(), 2000);
+      const res = await fetch(`${host}/api/tags`, { signal: ctrl.signal });
+      clearTimeout(t);
+      if (res.ok) installed = ((await res.json()).models || []).map((m) => m.name);
+    } catch {
+      console.log(c.yellow("  (Ollama 에 연결하지 못했어요 — `ollama serve` 실행 여부를 확인하세요. 계속 진행합니다.)"));
+    }
+    if (installed.length) console.log(c.green(`  설치된 모델: ${installed.slice(0, 8).join(", ")}`));
+    const sugg = installed.length ? installed : SUGGESTED_MODELS.ollama;
+    const def = sugg[0];
+    const m = await ask(c.cyan(`모델 [${def}]: `));
+    if (m === null) return false;
+    cfg.model = m.trim() || def;
   } else {
     const envName = ENV_KEYS[provider];
     const envVal = (process.env[envName] || "").trim();
@@ -504,7 +545,7 @@ export async function main(argv = []) {
       "CDSA Harness — AI 에이전트 내부를 드러내는 교육용 하네스 (터미널)\n\n" +
         "사용법: cdsa-harness [옵션]\n" +
         "       cdsa-harness add <npm-패키지>   플러그인 설치(이후 자동 로드)\n" +
-        "  --provider <openai|anthropic|openrouter|mock>\n" +
+        "  --provider <openai|anthropic|openrouter|ollama|mock>\n" +
         "  --model <모델명>\n" +
         "  --workspace <폴더경로>\n" +
         "  --setup                대화형 연결 설정 실행\n" +
@@ -546,12 +587,25 @@ export async function main(argv = []) {
   if (args.noColor) cfg.no_color = true;
   if (cfg.no_color) setColor(false); // 색상 끄기(흑백)
 
-  const rl = readline.createInterface({ input: stdin, output: stdout });
+  // 명령 히스토리(↑↓)를 세션 간에도 기억한다.
+  const histPath = path.join(configDir(), "history");
+  let savedHistory = [];
+  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 });
+  const saveHistory = () => {
+    try {
+      fs.mkdirSync(configDir(), { recursive: true });
+      fs.writeFileSync(histPath, (rl.history || []).slice(0, 200).join("\n"), "utf8");
+    } catch { /* ignore */ }
+  };
   let session = null;
   let mcp = { tools: [], servers: [], errors: [], closeAll: () => {} };
 
   // Ctrl+C → 깔끔하게 종료(스택트레이스 없이). 어디서 누르든 안전.
   const gracefulExit = () => {
+    saveHistory();
     try { rl.close(); } catch { /* */ }
     try { session && session.close(); } catch { /* */ }
     try { mcp && mcp.closeAll && mcp.closeAll(); } catch { /* */ }
@@ -559,14 +613,50 @@ export async function main(argv = []) {
     process.exit(0);
   };
   rl.on("SIGINT", gracefulExit);
-  // 프롬프트 헬퍼: Ctrl+C(AbortError) 등은 null 로 돌려 호출부가 취소로 처리.
-  const ask = async (q) => {
-    try {
-      return await rl.question(q);
-    } catch {
-      return null;
-    }
-  };
+  // 프롬프트 헬퍼. TTY 면 rl.question 그대로(히스토리·편집 지원).
+  // 파이프/스크립트 입력(non-TTY)은 줄을 큐로 받아 어떤 타이밍에 물어도 유실되지 않게 한다
+  // (모델 호출 중 도착한 승인 답변 줄이 사라지던 문제 해결 — CI/데모 자동화 가능).
+  let ask;
+  if (stdin.isTTY) {
+    ask = async (q) => {
+      try {
+        return await rl.question(q);
+      } catch {
+        return null;
+      }
+    };
+  } else {
+    const lineQueue = [];
+    let pendingResolve = null;
+    let closed = false;
+    rl.on("line", (l) => {
+      if (pendingResolve) {
+        const r = pendingResolve;
+        pendingResolve = null;
+        r(l);
+      } else lineQueue.push(l);
+    });
+    rl.on("close", () => {
+      closed = true;
+      if (pendingResolve) {
+        const r = pendingResolve;
+        pendingResolve = null;
+        r(null);
+      }
+    });
+    ask = (q) => {
+      process.stdout.write(q);
+      if (lineQueue.length) {
+        const l = lineQueue.shift();
+        process.stdout.write(l + "\n");
+        return Promise.resolve(l);
+      }
+      if (closed) return Promise.resolve(null);
+      return new Promise((res) => {
+        pendingResolve = res;
+      });
+    };
+  }
 
   if (args.setup) {
     await runSetup(ask, cfg);
@@ -582,7 +672,7 @@ export async function main(argv = []) {
   if (newer) {
     console.log(
       c.yellow(`⬆️  새 버전 v${newer} 가 나왔어요!`) +
-        c.dim(`  업데이트: npm i -g cdsa-harness@latest  ·  exe 는 Releases 에서 새로 받기`) +
+        c.dim(`  지금 바로: `) + c.cyan("/update") + c.dim(` · exe 는 Releases 에서 새로 받기`) +
         "\n"
     );
   }
@@ -618,7 +708,7 @@ export async function main(argv = []) {
     client: makeClient(cfg),
     toolbox,
     onEvent: makePrinter(cfg, stream),
-    approvalCallback: makeApproval(ask),
+    approvalCallback: makeApproval(ask, cfg),
     session,
     onToken,
   });
@@ -626,6 +716,37 @@ export async function main(argv = []) {
 
   const rule = () => console.log(c.grey("─".repeat(Math.min(80, stdout.columns || 80))));
 
+  // @파일 멘션: 입력 속 @경로 가 작업 폴더의 실제 파일이면 내용을 프롬프트에 첨부한다.
+  const expandMentions = (text) => {
+    const tokens = [...text.matchAll(/@([\w가-힣./\\-]+)/g)].map((m) => m[1]);
+    let out = text;
+    for (const t of [...new Set(tokens)]) {
+      try {
+        const r = toolbox.readFile(t);
+        const clipped = (r.output || "").slice(0, 4000);
+        out += `\n\n[첨부 @${t}]\n${clipped}`;
+        console.log(c.dim(`📎 @${t} 첨부됨 (${clipped.length}자)`));
+      } catch { /* 파일이 아니면 무시(이메일 등) */ }
+    }
+    return out;
+  };
+
+  // 대화 자동저장(/resume 용) + 멘션 확장을 겸하는 실행 헬퍼.
+  const convPath = path.join(configDir(), "last_session.json");
+  const runTurn = async (promptText) => {
+    rule();
+    try {
+      await loop.run(expandMentions(promptText));
+    } catch (e) {
+      console.log(c.red(`실행 오류: ${e?.message || e}`));
+    }
+    rule();
+    try {
+      fs.mkdirSync(configDir(), { recursive: true });
+      fs.writeFileSync(convPath, JSON.stringify({ time: Date.now(), provider: cfg.provider, model: cfg.model, messages: loop.messages }), "utf8");
+    } catch { /* 저장 실패 무시 */ }
+  };
+
   // 첫 실행 온보딩(한 번만 — ~/.cdsa_harness/.welcomed 표시): 작업 폴더 설정 + 튜토리얼
   const markerPath = path.join(configDir(), ".welcomed");
   if (stdin.isTTY && !fs.existsSync(markerPath)) {
@@ -695,7 +816,154 @@ export async function main(argv = []) {
       ], { title: "ℹ️  about", color: "cyan" }));
       continue;
     }
-    if (low === "/reset") { loop.reset(); console.log(c.green("컨텍스트를 초기화했습니다.")); continue; }
+    // /clear·/new — Claude Code·OpenCode 컨벤션(= 기존 /reset)
+    if (low === "/reset" || low === "/clear" || low === "/new") {
+      loop.reset();
+      console.log(c.green("새 대화를 시작합니다(컨텍스트 초기화)."));
+      continue;
+    }
+    // /compact — 대화를 '모델이 직접' 요약해 컨텍스트를 압축 (Claude Code 방식, 모델-퍼스트)
+    if (low === "/compact") {
+      if (loop.messages.length < 4) {
+        console.log(c.dim("아직 압축할 대화가 충분하지 않습니다."));
+        continue;
+      }
+      const before = loop.messages.length;
+      console.log(c.dim("모델에게 대화 요약을 맡겨 컨텍스트를 압축합니다…"));
+      try {
+        const req = [
+          ...loop.messages,
+          {
+            role: "user",
+            content:
+              "지금까지의 대화를 다음 작업에 꼭 필요한 것만 남긴 한국어 요약으로 만들어줘: 확인된 사실, 내린 결정, 파일 변경 내역, 미완료 작업. 요약문만 출력해.",
+          },
+        ];
+        const r = await loop.client.chat(req, []);
+        const summary = (r.content || "").trim();
+        if (!summary) throw new Error("빈 요약");
+        loop.reset();
+        loop.messages.push(
+          { role: "user", content: `[이전 대화 요약]\n${summary}` },
+          { role: "assistant", content: "요약을 확인했습니다. 이어서 진행하겠습니다." }
+        );
+        console.log(c.green(`압축 완료 — 메시지 ${before}개 → ${loop.messages.length}개`));
+      } catch (e) {
+        console.log(c.yellow(`압축 실패: ${e.message}`));
+      }
+      continue;
+    }
+    // /undo — 마지막 파일 변경 1건 되돌리기 (OpenCode 컨벤션)
+    if (low === "/undo") {
+      try {
+        console.log(c.green(toolbox.undoLast().output));
+      } catch (e) {
+        console.log(c.yellow(e.message));
+      }
+      continue;
+    }
+    // /update — 자기 자신을 최신 버전으로 업데이트(npm 설치본). exe 는 다운로드 안내.
+    if (low === "/update") {
+      let isSea = false;
+      try {
+        isSea = (await import("node:sea")).isSea();
+      } catch { /* 구버전 Node — SEA 아님 */ }
+      if (isSea) {
+        console.log(c.yellow("단일 실행파일(exe) 버전은 파일 교체 방식이라 자동 업데이트가 없어요."));
+        console.log(c.dim("최신 exe 다운로드: ") + c.cyan("https://github.com/cdsassj00/miniharness/releases/latest"));
+        continue;
+      }
+      console.log(c.cyan("최신 버전으로 업데이트합니다… (npm i -g cdsa-harness@latest)"));
+      try {
+        execSync("npm i -g cdsa-harness@latest", { stdio: "inherit" });
+        console.log(c.green("✅ 업데이트 완료! /quit 후 다시 실행하면 새 버전이 적용됩니다."));
+      } catch (e) {
+        console.log(c.red(`업데이트 실패: ${e.message}`));
+        console.log(c.dim("직접 실행: npm i -g cdsa-harness@latest"));
+      }
+      continue;
+    }
+    // /auto — 자동 수락 토글(신뢰 전환). Claude Code 의 auto-accept 에 해당.
+    if (low === "/auto") {
+      cfg.approval_mode = cfg.approval_mode === "auto" ? "manual" : "auto";
+      console.log(
+        cfg.approval_mode === "auto"
+          ? c.green("자동 수락 ON — 파일 수정·셸을 묻지 않고 실행합니다. (해제: /auto)")
+          : c.green("자동 수락 OFF — 변경 전 diff 를 보여주고 승인을 받습니다.")
+      );
+      continue;
+    }
+    // /init — '모델에게' 폴더를 파악시켜 AGENT.md 프로젝트 규칙을 만들게 한다 (Claude Code /init)
+    if (low === "/init") {
+      await runTurn(
+        "이 작업 폴더를 list_dir/read_file/search_files 로 파악한 뒤, 앞으로의 에이전트 작업 지침이 될 " +
+          "AGENT.md 파일을 write_file 로 생성해줘. 포함: ①프로젝트/폴더 개요 ②작업 시 지켜야 할 규칙(말투·제약·주의) " +
+          "③자주 할 작업 예시. 이미 AGENT.md 가 있으면 읽고 부족한 부분만 개선해."
+      );
+      continue;
+    }
+    // /status·/cost — 현재 상태 + 세션 누적 토큰 (Claude Code 컨벤션)
+    if (low === "/status" || low === "/cost") {
+      const u = loop.usage;
+      console.log(
+        panel(
+          [
+            `${c.grey("모델".padEnd(6))} ${c.bold(`${cfg.provider} · ${cfg.model}`)}`,
+            `${c.grey("폴더".padEnd(6))} ${cfg.workspacePath()}`,
+            `${c.grey("승인".padEnd(6))} ${cfg.approval_mode === "auto" ? c.yellow("자동 수락") : "수동(diff 확인)"} · 셸 ${cfg.allow_shell ? "허용" : "차단"}`,
+            `${c.grey("대화".padEnd(6))} 메시지 ${loop.messages.length}개 (/compact 로 압축 가능)`,
+            `${c.grey("토큰".padEnd(6))} 입력 ${u.input.toLocaleString()} · 출력 ${u.output.toLocaleString()} · 합계 ${c.bold(u.total.toLocaleString())} (호출 ${u.calls}회)`,
+          ],
+          { title: "📊 상태 (/status)", color: "cyan" }
+        )
+      );
+      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 확인.`));
+        }
+      } 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" }));
+      }
+      continue;
+    }
+    // /memory — 프로젝트 규칙 파일(AGENT.md) 보기 (Claude Code /memory)
+    if (low === "/memory") {
+      const candidates = ["AGENT.md", "AGENTS.md", "CLAUDE.md", "rules.md"].map((n) => path.join(cfg.workspacePath(), n));
+      const found = candidates.find((p) => fs.existsSync(p));
+      if (found) {
+        console.log(panel(fs.readFileSync(found, "utf8").split("\n").slice(0, 40), { title: `🧠 프로젝트 규칙 — ${path.basename(found)}`, color: "cyan" }));
+        console.log(c.dim(`전체 경로: ${found} (매 턴 시스템 프롬프트에 주입됩니다)`));
+      } else {
+        console.log(c.yellow("프로젝트 규칙 파일이 없습니다. ") + c.cyan("/init") + c.dim(" 을 실행하면 모델이 폴더를 파악해 AGENT.md 를 만들어줍니다."));
+      }
+      continue;
+    }
+    if (low === "/resume") {
+      try {
+        const saved = JSON.parse(fs.readFileSync(convPath, "utf8"));
+        if (!Array.isArray(saved.messages) || !saved.messages.length) throw new Error("빈 세션");
+        loop.messages = saved.messages;
+        const when = new Date(saved.time).toLocaleString("ko-KR");
+        console.log(c.green(`지난 대화를 이어갑니다 — ${when} · ${saved.model} · 메시지 ${saved.messages.length}개 복원`));
+        console.log(c.dim("(새로 시작하려면 /reset)"));
+      } catch {
+        console.log(c.yellow("이어갈 지난 대화가 없습니다."));
+      }
+      continue;
+    }
     if (low === "/config") { printIntro(cfg); console.log(c.dim(`config.json: ${configPath()}`)); continue; }
     if (low.startsWith("/workspace") || low.startsWith("/cd")) {
       const arg = user.split(/\s+/).slice(1).join(" ").trim();
@@ -796,8 +1064,12 @@ export async function main(argv = []) {
         return c.dim("📄 파일");
       };
       const lines = names.length
-        ? names.map((n) => `${c.cyan("/" + n)}  ${c.grey(skills[n].description || "")}  ${srcTag(skills[n])}`)
+        ? names.map((n) => {
+            const h = skills[n].hint ? " " + c.dim(skills[n].hint) : "";
+            return `${c.cyan("/" + n)}${h}  ${c.grey(skills[n].description || "")}  ${srcTag(skills[n])}`;
+          })
         : [c.dim("등록된 스킬이 없습니다.")];
+      lines.unshift(c.dim("사용법: /명령 뒤에  <필수> 또는 [선택] 표기대로 입력하세요."));
       lines.push(c.dim("추가: <작업폴더>/.cdsa/skills/*.md · ~/.cdsa_harness/skills/ · config.json 의 skill_dirs"));
       lines.push(c.dim("외부(.claude/commands 등)는 import_foreign_skills 로 끌 수 있음"));
       console.log(panel(lines, { title: "🎯 스킬 (프롬프트 템플릿, /이름 으로 실행)", color: "cyan" }));
@@ -808,28 +1080,23 @@ export async function main(argv = []) {
     if (user.startsWith("/")) {
       const name = low.slice(1).split(/\s+/)[0];
       if (skills[name]) {
-        const argStr = user.split(/\s+/).slice(1).join(" ");
-        console.log(c.dim(`(스킬 '/${name}' 실행)`));
-        rule();
-        try {
-          await loop.run(renderSkill(skills[name], argStr));
-        } catch (e) {
-          console.log(c.red(`실행 오류: ${e?.message || e}`));
+        const argStr = user.split(/\s+/).slice(1).join(" ").trim();
+        const hint = skills[name].hint || "";
+        // 입력이 필요한 스킬(<...>)인데 비어 있으면, 실행 대신 사용법을 알려준다.
+        if (!argStr && hint.includes("<")) {
+          console.log(c.yellow(`사용법: ${c.bold("/" + name)} ${hint}`) + c.dim("  ← 명령 뒤에 내용을 입력하세요"));
+          if (skills[name].description) console.log(c.dim("  " + skills[name].description));
+          continue;
         }
-        rule();
+        console.log(c.dim(`(스킬 '/${name}' 실행)`));
+        await runTurn(renderSkill(skills[name], argStr));
       } else {
         console.log(c.yellow(`알 수 없는 명령/스킬: /${name} — ${c.cyan("/help")}, ${c.cyan("/skills")} 참고`));
       }
       continue;
     }
 
-    rule();
-    try {
-      await loop.run(user);
-    } catch (e) {
-      console.log(c.red(`실행 오류: ${e?.message || e}`));
-    }
-    rule();
+    await runTurn(user);
   }
 
   rl.close();

package/src/config.js

@@ -4,7 +4,7 @@ import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 
-export const PROVIDERS = ["openai", "anthropic", "openrouter", "mock"];
+export const PROVIDERS = ["openai", "anthropic", "openrouter", "ollama", "mock"];
 
 export const SUGGESTED_MODELS = {
   openai: ["gpt-4o-mini", "gpt-4.1-mini", "gpt-4.1"],
@@ -15,6 +15,8 @@ export const SUGGESTED_MODELS = {
     "anthropic/claude-3.7-sonnet",
     "google/gemini-2.0-flash-001",
   ],
+  // 로컬/폐쇄망(Ollama). 도구 호출(tools) 지원 모델 권장. exaone 은 한국어 특화(LG).
+  ollama: ["qwen2.5:7b", "llama3.1:8b", "exaone3.5:7.8b"],
   mock: ["mock-agent"],
 };
 
@@ -83,6 +85,7 @@ export class Config {
 
   isReady() {
     if (this.provider === "mock") return true;
+    if (this.provider === "ollama") return true; // 로컬 LLM — API 키 불필요
     return Boolean(this.resolvedKey());
   }
 

package/src/llm.js

@@ -11,6 +11,8 @@ const ENDPOINTS = {
   openai: "https://api.openai.com/v1/chat/completions",
   openrouter: "https://openrouter.ai/api/v1/chat/completions",
   anthropic: "https://api.anthropic.com/v1/messages",
+  // Ollama(로컬/폐쇄망)는 OpenAI 호환 API 를 제공한다. OLLAMA_HOST 로 호스트 변경 가능.
+  ollama: `${(process.env.OLLAMA_HOST || "http://localhost:11434").replace(/\/$/, "")}/v1/chat/completions`,
 };
 
 export class LLMClient {
@@ -55,7 +57,7 @@ export class LLMClient {
       res = await fetch(url, { method: "POST", headers, body: json, signal: ctrl.signal });
     } catch (e) {
       clearTimeout(timer);
-      throw new LLMError(`네트워크 오류: ${e.message}`);
+      throw new LLMError(this._netErrorMessage(e));
     }
     if (!res.ok) {
       clearTimeout(timer);
@@ -65,6 +67,14 @@ export class LLMClient {
     return { res, started, timer, bodyBytes: Buffer.byteLength(json, "utf8") };
   }
 
+  _netErrorMessage(e) {
+    let msg = `네트워크 오류: ${e.message}`;
+    if (this.provider === "ollama") {
+      msg += "\n  ↳ Ollama 가 실행 중인지 확인하세요: `ollama serve` (모델 설치: `ollama pull qwen2.5:7b`)";
+    }
+    return msg;
+  }
+
   async _post(url, headers, body) {
     const json = JSON.stringify(body);
     const ctrl = new AbortController();
@@ -74,7 +84,7 @@ export class LLMClient {
     try {
       res = await fetch(url, { method: "POST", headers, body: json, signal: ctrl.signal });
     } catch (e) {
-      throw new LLMError(`네트워크 오류: ${e.message}`);
+      throw new LLMError(this._netErrorMessage(e));
     } finally {
       clearTimeout(timer);
     }