cdsa-harness 0.14.2 → 0.19.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,8 @@ 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";
+import { makeCompleter } from "./completion.js";
 
 // VERSION 은 src/builtins.js(생성물)에서 가져온다 — npm/exe 양쪽에서 동일.
 
@@ -87,8 +88,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 +113,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 +146,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 +168,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 +183,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 +201,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 ? "" : "사용자가 거부했습니다." };
   };
 }
@@ -256,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,
@@ -271,7 +356,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 +473,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 +517,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 +533,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();
@@ -463,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);
@@ -504,7 +614,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 +656,33 @@ 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 { /* 첫 실행 */ }
+  // 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 });
+      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 +690,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 +749,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"
     );
   }
@@ -593,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}개`));
@@ -618,7 +785,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 +793,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 +893,148 @@ 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 [검색어] — 모델 목록에서 번호로 선택(제공자별 실시간 조회)
+    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 {
+        console.log(c.dim("변경하지 않았습니다."));
+      }
+      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();
@@ -821,26 +1160,14 @@ export async function main(argv = []) {
           continue;
         }
         console.log(c.dim(`(스킬 '/${name}' 실행)`));
-        rule();
-        try {
-          await loop.run(renderSkill(skills[name], argStr));
-        } catch (e) {
-          console.log(c.red(`실행 오류: ${e?.message || e}`));
-        }
-        rule();
+        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();