deel-local-cli 2.1.1 → 2.1.2

package/src/backend/mcp.js

@@ -952,6 +952,21 @@ export function 이름풀기(전체) {
   return m ? { 서버: m[1], 도구: m[2] } : null;
 }
 
+/**
+ * 서버가 이 도구를 **읽기만 한다** 고 적었나 (MCP `annotations.readOnlyHint`).
+ *
+ * confirm 이 MCP 도구를 안 물을지 정하는 데만 쓴다 (loop.js 의 관문). 적힌 말은 남의 서버가 한
+ * 말이라 좁게 믿는다 — 참(`true`)일 때만, 그리고 「지운다」(destructiveHint) 를 같이 적었으면
+ * 앞뒤가 안 맞으니 안 믿는다. strict 는 이 말을 아예 안 본다.
+ */
+export function 읽기만하나(서버들, 전체) {
+  const 갈린것 = 이름풀기(전체);
+  if (!갈린것) return false;
+  const 서버 = (서버들 ?? []).find((s) => s?.이름 === 갈린것.서버);
+  const 적힌것 = (서버?.도구 ?? []).find((t) => t?.name === 갈린것.도구)?.annotations;
+  return 적힌것?.readOnlyHint === true && 적힌것?.destructiveHint !== true;
+}
+
 /**
  * 설정에 적힌 서버를 전부 띄운다.
  *

package/src/completion.js

@@ -91,6 +91,8 @@ export const 깃발들 = [
   { 이름: '--hard', 뜻: 'reset all 에서 되돌리기·감사기록까지', en: 'with reset all: undo snapshots and the audit log too', 값: false },
   { 이름: '--json', 뜻: '결과를 JSON 으로', en: 'output JSON', 값: false },
   { 이름: '--check', 뜻: 'run: 끝내기 전에 돌릴 검사 명령', en: 'run: check command to pass before finishing', 값: null },
+  { 이름: '--check-rounds', 뜻: 'run: 검사를 몇 번까지 돌리나 (1~10)', en: 'run: how many times the check runs (1-10)', 값: null },
+  { 이름: '--check-timeout', 뜻: 'run: 검사 한 번의 제한 시간(초)', en: 'run: time limit per check run (seconds)', 값: null },
   { 이름: '--repeat', 뜻: 'eval: 과제마다 몇 번 돌릴까', en: 'eval: runs per task', 값: null },
   { 이름: '--init', 뜻: 'eval: 예제 과제를 만든다', en: 'eval: write the example tasks', 값: false },
   { 이름: '--only', 뜻: 'eval: 고른 과제만 (쉼표) · sbom: 한 가지만', en: 'eval: only these tasks (comma); sbom: only one part', 값: null },

package/src/eval/run.js

@@ -97,20 +97,48 @@ export function 과제읽기(폴더) {
   return 과제들;
 }
 
+// 수 칸은 수나 수를 적은 글만 읽는다. Number(true) = 1 · Number(null) = 0 이라 참/거짓이 수로 통과했다 (2.1.2 2차 눈).
+const 수로 = (v) => (typeof v === 'number' || (typeof v === 'string' && v.trim() !== '') ? Number(v) : NaN);
+
 /** task.json 이 쓸 수 있는 모양인가. 쓸 수 있으면 null, 아니면 까닭. */
 export function 설정탈(v) {
   if (!v || typeof v !== 'object' || Array.isArray(v)) return 'task.json 이 객체가 아닙니다';
   if (typeof v.prompt !== 'string' || !v.prompt.trim()) return 'prompt(시킬 말)가 없습니다';
   if (typeof v.check !== 'string' || !v.check.trim()) return 'check(정답 검사 명령)가 없습니다';
   for (const 칸 of ['timeout', 'checkTimeout']) {
-    if (v[칸] !== undefined && !(Number.isFinite(Number(v[칸])) && Number(v[칸]) > 0)) return `${칸} 은 0 보다 큰 초여야 합니다`;
+    if (v[칸] !== undefined && !(Number.isFinite(수로(v[칸])) && 수로(v[칸]) > 0)) return `${칸} 은 0 보다 큰 초여야 합니다`;
   }
   for (const 칸 of ['doneCheck', 'work']) {
     if (v[칸] !== undefined && typeof v[칸] !== 'string') return `${칸} 은 글이어야 합니다`;
   }
+  // 과제마다 완료 검사를 몇 번·얼마나 돌리나 (2.1.2) — deel run 의 --check-rounds · --check-timeout 으로 넘긴다.
+  if (v.doneCheckRounds !== undefined && !(Number.isInteger(수로(v.doneCheckRounds)) && 수로(v.doneCheckRounds) >= 1)) {
+    return 'doneCheckRounds 는 1 이상의 정수여야 합니다';
+  }
+  if (v.doneCheckTimeout !== undefined && !(Number.isFinite(수로(v.doneCheckTimeout)) && 수로(v.doneCheckTimeout) > 0)) {
+    return 'doneCheckTimeout 은 0 보다 큰 초여야 합니다';
+  }
+  if ((v.doneCheckRounds !== undefined || v.doneCheckTimeout !== undefined) && !v.doneCheck) {
+    return 'doneCheckRounds · doneCheckTimeout 은 doneCheck(완료 검사 명령)와 같이 적어야 합니다';
+  }
   return null;
 }
 
+/**
+ * 과제 하나에 띄울 `deel run` 의 인자. 시킬 말은 `--` 뒤 맨 끝이다 — 대시로 시작해도 깃발로 안 읽힌다.
+ */
+export function 실행인자(설정, 작업, 깃발들 = []) {
+  return [
+    진입점, 'run', '--json', '--yes', '--root', 작업,
+    ...(설정.work ? ['--work', 설정.work] : []),
+    ...(설정.doneCheck ? ['--check', 설정.doneCheck] : []),
+    ...(설정.doneCheck && 설정.doneCheckRounds !== undefined ? ['--check-rounds', String(설정.doneCheckRounds)] : []),
+    ...(설정.doneCheck && 설정.doneCheckTimeout !== undefined ? ['--check-timeout', String(설정.doneCheckTimeout)] : []),
+    ...깃발들,
+    '--', 설정.prompt,
+  ];
+}
+
 /**
  * 폴더를 통째로 복사한다. 원본이 없으면 아무것도 안 한다(start/ 가 없는 과제는 빈 폴더에서 시작).
  *
@@ -189,15 +217,8 @@ export async function 한번돌리기(과제, { 판 = 1, 깃발들 = [], 남김
   const 작업 = mkdtempSync(join(tmpdir(), 'deel-eval-'));
   try {
     폴더복사(join(과제.자리, 'start'), 작업);
-    const 제한초 = Number(설정.timeout ?? 시간초 ?? 기본시간초);
-    const 인자 = [
-      진입점, 'run', '--json', '--yes', '--root', 작업,
-      ...(설정.work ? ['--work', 설정.work] : []),
-      ...(설정.doneCheck ? ['--check', 설정.doneCheck] : []),
-      ...깃발들,
-      // `--` 뒤는 낱말이다 — 시킬 말이 대시로 시작해도 깃발로 안 읽힌다.
-      '--', 설정.prompt,
-    ];
+    const 제한초 = 제한초고르기(설정, 시간초);
+    const 인자 = 실행인자(설정, 작업, 깃발들);
     const 돌림 = await 돌려보기(process.execPath, 인자, {
       timeout: 제한초 * 1000, maxBuffer: 64 * 1024 * 1024,
       덤: { cwd: 작업, env: { ...process.env, NO_COLOR: '1' } },
@@ -251,8 +272,12 @@ export function 과제별(결과들) {
 /**
  * 지난 결과와 견준다. 다 통과하던 과제가 하나라도 떨어졌으면 나빠짐, 못 하던 과제를 다 해내면 나아짐.
  * 되풀이 수가 다르면 비율로 본다.
+ *
+ * 지난번에 있던 과제가 이번에 없으면 **사라짐**, 처음 재는 과제는 **새것** 으로 적는다 (2.1.2). 여태
+ * 사라진 과제는 말없이 빠져, 떨어지던 과제 폴더를 지우고 돌려도 남은 과제끼리 「지난번과 같습니다」 가
+ * 나왔다. `일부만`(--only)이면 안 고른 과제가 다 사라짐이 되므로 사라짐은 안 센다.
  */
-export function 견주기(지난것, 지금것) {
+export function 견주기(지난것, 지금것, { 일부만 = false } = {}) {
   const 비율 = (x) => (x.판 ? x.통과 / x.판 : 0);
   const 지난표 = new Map((지난것 ?? []).map((x) => [x.과제, x]));
   const 나빠짐 = [];
@@ -266,9 +291,28 @@ export function 견주기(지난것, 지금것) {
     if (비율(x) < 비율(전)) 나빠짐.push(x.과제);
     else if (비율(x) > 비율(전)) 나아짐.push(x.과제);
   }
-  return { 나빠짐, 나아짐, 견준 };
+  const 지금이름 = new Set(지금것.map((x) => x.과제));
+  const 사라짐 = 일부만 ? [] : [...지난표.keys()].filter((이름) => !지금이름.has(이름));
+  const 새것 = 지금것.filter((x) => !지난표.has(x.과제)).map((x) => x.과제);
+  return { 나빠짐, 나아짐, 견준, 사라짐, 새것 };
 }
 
+/**
+ * 「지난번과 같습니다」 를 어디까지 말할 수 있나. 달라진 과제가 있거나 견준 것이 없으면 null.
+ * 견주지 않은 과제(사라짐 · 새것 · --only 로 안 고른 것)가 있으면 '견준만큼' — 처음 재는 과제가 떨어져도
+ * 견준 과제끼리 같으면 「같습니다」 가 나와 그 실패가 묻혔다 (2.1.2 2차 눈).
+ */
+export function 같음범위(견줌, { 일부만 = false } = {}) {
+  if (!견줌?.견준 || 견줌.나빠짐.length || 견줌.나아짐.length) return null;
+  return 일부만 || 견줌.사라짐.length || 견줌.새것.length ? '견준만큼' : '전부';
+}
+
+/**
+ * 과제 하나의 제한 시간(초). task.json 에 적힌 것이 `--timeout` 을 이긴다 — pytest-timeout 의 표시나
+ * jest 의 과제별 시간과 같은 차례다. `--timeout` 은 제 시간을 안 적은 과제의 기본값이다.
+ */
+export const 제한초고르기 = (설정, 시간초) => Number(설정?.timeout ?? 시간초 ?? 기본시간초);
+
 /**
  * 제일 새 결과 파일. 깨졌거나 과제별이 없는 것(손으로 적은 `{}` 따위)은 건너뛴다 — 견줄 것이 없다.
  *
@@ -377,6 +421,10 @@ export async function runEval({ 폴더 = null, init = false, repeat = 1, keep =
   if (!Number.isInteger(되풀이) || 되풀이 < 1 || 되풀이 > 최대되풀이) {
     return 못돌림(64, 글(`--repeat 는 1 ~ ${최대되풀이} 사이의 정수여야 합니다: ${repeat}`, `--repeat must be a whole number from 1 to ${최대되풀이}: ${repeat}`));
   }
+  // 0 · 글 · 음수가 그대로 넘어가면 setTimeout(0) · NaN 이 되어 과제마다 deel 을 곧바로 죽인다 — 전부 「시간 초과」 실패.
+  if (시간초 !== null && !(Number.isFinite(Number(시간초)) && Number(시간초) > 0)) {
+    return 못돌림(64, 글(`--timeout 은 0 보다 큰 초여야 합니다: ${시간초}`, `--timeout must be a number of seconds above 0: ${시간초}`));
+  }
   if (!existsSync(고른폴더)) {
     return 못돌림(1, 글(`과제 모음이 없습니다 — ${보일}`, `No task folder — ${보일}`),
       `${c.gray(글('예제부터 만들려면:', 'To start from examples:'))} ${c.cyan('deel eval --init')}`);
@@ -390,6 +438,9 @@ export async function runEval({ 폴더 = null, init = false, repeat = 1, keep =
 
   말하기('');
   말하기(`  ${c.bold(글('골든셋', 'Golden set'))} ${c.gray(`— ${보일} · ${글(`과제 ${과제들.length}개 · 과제마다 ${되풀이}번`, `${과제들.length} tasks · ${되풀이} run(s) each`)}`)}`);
+  // --timeout 을 줬는데 제 시간을 적은 과제가 있으면 그 과제는 적힌 값을 쓴다고 미리 말한다 (제한초고르기).
+  const 제시간 = 시간초 !== null ? 과제들.filter((x) => x.설정?.timeout !== undefined).length : 0;
+  if (제시간) 말하기(`  ${c.gray(글(`task.json 에 timeout 을 적은 과제 ${제시간}개는 --timeout 대신 그 값을 씁니다`, `${제시간} task(s) set their own timeout in task.json and use it instead of --timeout`))}`);
   말하기('');
 
   /*
@@ -436,7 +487,7 @@ export async function runEval({ 폴더 = null, init = false, repeat = 1, keep =
   const 통과수 = 결과들.filter((r) => r.통과).length;
   const 모델 = 결과들.find((r) => r.deel?.model)?.deel.model ?? null;
   const 지난 = 지난결과(고른폴더, { 전체만: !only, 이름들: only ? 과제들.map((x) => x.이름) : null });
-  const 견줌 = 견주기(지난?.값?.과제별, 묶음);
+  const 견줌 = 견주기(지난?.값?.과제별, 묶음, { 일부만: !!only });
   const 초 = Math.round((Date.now() - t0) / 1000);
   const 토큰 = 결과들.reduce((a, r) => ({ in: a.in + (r.deel?.usage?.in ?? 0), out: a.out + (r.deel?.usage?.out ?? 0) }), { in: 0, out: 0 });
 
@@ -475,7 +526,15 @@ export async function runEval({ 폴더 = null, init = false, repeat = 1, keep =
   if (지난) {
     if (견줌.나빠짐.length) 말하기(`  ${c.red('▼')} ${글('지난번보다 나빠짐:', 'Worse than last time:')} ${견줌.나빠짐.join(' · ')}`);
     if (견줌.나아짐.length) 말하기(`  ${c.green('▲')} ${글('지난번보다 나아짐:', 'Better than last time:')} ${견줌.나아짐.join(' · ')}`);
-    if (견줌.견준 && !견줌.나빠짐.length && !견줌.나아짐.length) 말하기(`  ${c.gray(글(`지난번(${지난.파일})과 같습니다`, `Same as last time (${지난.파일})`))}`);
+    if (견줌.사라짐.length) 말하기(`  ${c.yellow('⚠')} ${글('지난번에 있던 과제가 이번엔 없습니다:', 'Tasks from last time are missing now:')} ${견줌.사라짐.join(' · ')}`);
+    if (견줌.새것.length) 말하기(`  ${c.gray(글(`처음 재는 과제: ${견줌.새것.join(' · ')}`, `Measured for the first time: ${견줌.새것.join(' · ')}`))}`);
+    // 견주지 않은 과제가 있으면 「같다」 는 견준 과제끼리의 말이다 — 그렇게 적는다.
+    const 같음 = 같음범위(견줌, { 일부만: !!only });
+    if (같음) {
+      말하기(`  ${c.gray(같음 === '견준만큼'
+        ? 글(`견준 과제 ${견줌.견준}개는 지난번(${지난.파일})과 같습니다`, `The ${견줌.견준} task(s) compared are the same as last time (${지난.파일})`)
+        : 글(`지난번(${지난.파일})과 같습니다`, `Same as last time (${지난.파일})`))}`);
+    }
   }
   if (남긴곳) 말하기(`  ${c.gray(글(`결과: ${relative(뿌리, 남긴곳)}`, `Results: ${relative(뿌리, 남긴곳)}`))}`);
   else if (못남긴까닭) {

package/src/exit.js

@@ -0,0 +1,116 @@
+// 종료코드와 시작도 못 한 실패 한 덩이 — `deel run` 과 진입점(bin/deel.js)이 같이 쓴다.
+//
+// oneshot.js 에서 떼어 냈다 (2.1.2). 진입점이 이 표 하나 때문에 oneshot.js 를 불러오면 대화 화면·도구·
+// 게이트웨이까지 딸려 와서, `deel --version` 한 줄이 파일 164개를 읽었다. oneshot.js 는 그대로 내보낸다.
+
+/**
+ * 종료코드.
+ *
+ * 스크립트는 화면 글이 아니라 이 숫자만 본다. 그래서 '끝났다' 와 '끝난 척했다'
+ * 를 반드시 갈라 놔야 한다 — 걸음 수 상한에 걸려 멈춘 것을 0 으로 돌려주면
+ * 야간 배치가 아무 일도 안 하고 초록불을 켠다. 그게 제일 나쁜 결말이다.
+ */
+export const EXIT = {
+  done: 0,      // 끝까지 답했다
+  error: 1,     // 오류로 끝났다 (연결 없음 · 시킬 말 없음 · 모델 오류)
+  limit: 2,     // 도구 호출 걸음 수 상한에 닿았다
+  stuck: 3,     // 같은 자리에서 헛돌아 스스로 멈췄다
+  aborted: 4,   // 도중에 끊겼다 (Ctrl+C)
+  /*
+   * 서버가 끝났다는 말을 한 번도 안 주고 답을 멈췄다.
+   *
+   * 여기에 자기 코드가 있어야 한다. 전에는 이걸 아예 안 보고 `done`(0) 으로
+   * 끝냈다. `deel -p` 는 잡·CI 에서 돌고 그 뒤에 스크립트가 붙는데, 반쪽짜리
+   * 답이 0 으로 넘어가면 그 스크립트는 온전한 답으로 알고 그대로 쓴다.
+   * 사람이 나중에 결과를 보고 왜 반쪽인지 되짚을 방법이 없다.
+   */
+  cutoff: 5,
+  /*
+   * 모델이 안 하겠다고 했다 (안전 판정).
+   *
+   * 이것도 자기 코드가 있어야 한다. 거절한 답은 **아무 일도 안 한 답**인데,
+   * 도구 호출이 없다는 것 말고는 짧은 답과 겉모습이 같다. 0 으로 끝내면
+   * 뒤에 붙은 스크립트는 일이 된 줄 알고 그 다음 단계로 넘어간다.
+   *
+   * 오류(1)와도 갈라 둔다. 고칠 자리가 다르기 때문이다 — 오류는 연결이나
+   * 열쇠를 보는 일이고, 거절은 **시킨 말을 바꾸는 일**이다.
+   */
+  refusal: 6,
+  /*
+   * 답이 --output-schema 에 안 맞았다.
+   *
+   * 여기에도 자기 코드가 있어야 한다. 「모양을 못 박아 달라」 고 한 사람에게
+   * 모양이 안 맞는 것을 0 으로 넘기면, 파이프 뒤 스크립트가 그걸 온전한
+   * 것으로 받아 쓴다 — 그게 이 기능이 없애려던 바로 그 상황이다.
+   *
+   * 오류(1)와도 가른다. 고칠 자리가 다르다 — 오류는 연결을 보는 일이고,
+   * 이건 스키마나 시킨 말을 바꾸는 일이다.
+   */
+  schema: 7,
+  /*
+   * 완료 검사가 통과하지 않은 채 끝났다 (agent/donecheck.js · 2.1.0).
+   *
+   * 모델은 「다 됐습니다」 라고 했는데 사람이 정해 둔 검사(`--check` · 설정의 `check`)가
+   * 정해 둔 판수를 다 돌고도 빨갛거나, 관문에 막혀 아예 못 돌았다. 0 으로 끝내면 야간
+   * 배치가 빨간 검사 위에 초록불을 켠다 — 이 기능이 없애려던 바로 그 결말이다.
+   *
+   * 오류(1)와 가른다. 고칠 자리가 다르다 — 연결이 아니라 코드나 검사 쪽이다.
+   */
+  check: 8,
+  /*
+   * 인자를 잘못 줬다 — 모르는 깃발 · 값 없는 깃발 · 모르는 모드 이름 · 못 읽는 --ctx.
+   *
+   * 여기에 **따로** 둔다. 처음에는 `--work` 오타를 2 로 끝냈는데, 2 는 이 표에서 이미
+   * 「걸음 수 상한」 이다. `deel run --jsn …` 을 CI 에 건 사람은 오타 하나로 「일이 커서
+   * 멈췄다」 를 받고 작업을 쪼개러 간다. 고칠 자리가 스크립트 한 줄인데.
+   *
+   * 64 는 sysexits.h 의 EX_USAGE 다. 1~8 과 안 겹치고, 셸·CI 도구들이 「부른 모양이
+   * 틀렸다」 로 이미 알아듣는 수라 새로 지어내지 않았다. 이 경우는 모델을 한 번도 안 부른다.
+   */
+  usage: 64,
+};
+
+/**
+ * 모델을 부르기 전에 선 실패 한 덩이 (사냥5 B5-10).
+ *
+ * 성공한 `--json` 에는 model 과 usage.prompt·cacheRead·cacheWrite·못잰것 이 있는데, 모델을
+ * 부르기 전에 선 실패(64 · 7 · 시킬 말 없음 · 없는 뿌리 · 연결 없음 · 대화 화면 전용)에는
+ * 그 칸들이 없었다. `jq .usage.prompt` 는 null 을, 모양을 못 박은 파서는 오류를 낸다 —
+ * 실패를 제일 잘 다뤄야 할 자리에서 파서가 먼저 죽는다. 칸은 늘 같게 두고 값만 비운다.
+ *
+ * bin/deel.js 의 인자탈·마지막 catch 도 이걸로 짓는다. 세 벌이면 언젠가 한 벌만 고친다.
+ */
+export function 실패덩이({ reason, code, why = '', model = null }) {
+  return {
+    ok: false, reason, code, text: '',
+    tools: 0, steps: 0,
+    usage: { in: 0, out: 0, prompt: 0, cacheRead: 0, cacheWrite: 0, calls: 0, ms: 0, 못잰것: 0, retries: 0 },
+    model,
+    ms: 0,
+    ...(why ? { why } : {}),
+  };
+}
+
+/**
+ * 열어 둔 연결을 닫는다. 프로그램을 끝내기 직전에 부른다.
+ *
+ * fetch 는 연결을 재사용하려고 소켓을 살려 둔다(keep-alive). 그래서 할 일이
+ * 끝나도 프로세스가 저절로 안 끝난다. 예전에는 그걸 process.exit() 으로
+ * 잘라 냈는데, 윈도우에서 닫는 중인 핸들을 두고 끊으면 libuv 가 abort 한다.
+ *
+ *   Assertion failed: !(handle->flags & UV_HANDLE_CLOSING), src\win\async.c
+ *
+ * 실제로 `deel scan` 이 결과를 다 찍고 나서 이렇게 죽었다. 화면에는 정상으로
+ * 보이는데 종료코드는 3221226505(0xC0000409) 였다.
+ *
+ * 그래서 잘라 내는 대신 닫는다. 이 자리는 Node 내부 이름이라 없을 수도 있으므로,
+ * 없으면 조용히 넘어간다 — 그때는 부르는 쪽의 시간제한이 받아 준다.
+ * 프록시 길은 요청마다 소켓을 새로 열고 끝나면 닫으므로(Connection: close) 여기 안 온다.
+ */
+export function closeConnections() {
+  try {
+    const d = globalThis[Symbol.for('undici.globalDispatcher.1')];
+    if (d && typeof d.close === 'function') return d.close().catch(() => {});
+  } catch { /* 없으면 그만 */ }
+  return Promise.resolve();
+}

package/src/i18n/en.js

@@ -319,7 +319,7 @@ export const en = {
   'approve.auto.line': 'edits without asking. /undo is the safety net',
   'approve.confirm.name': 'risky only',
   'approve.confirm.short': 'risky',
-  'approve.confirm.line': 'asks before commands it cannot take back. Files are edited without asking',
+  'approve.confirm.line': 'asks before commands it cannot take back and MCP tools. Files are edited without asking',
   'approve.strict.name': 'ask always',
   'approve.strict.short': 'always',
   'approve.strict.line': 'asks before every file edit and every command',
@@ -520,12 +520,14 @@ export const en = {
   'ev.nudgeRead': 'It was about to finish having only read things — pushed back once',
   'check.start': 'Completion check ({판}/{최대}) — {명령}',
   'check.clamped': '{칸} {준값} is over the limit — using {쓴값}',
+  'check.invalid': '{칸} {준값} is not a usable value — using the default {쓴값}',
   'check.pass': 'Completion check passed — {명령}',
   'check.fail': 'Completion check failed ({판}/{최대}) — {요약}',
   'check.retry': 'Sending the failure back to fix',
   'check.gaveUp': 'Still failing after {판} runs — ending as failed',
   'check.skipped': 'Could not run the completion check — {까닭}',
   'cli.checkFlag': 'run this check before finishing; failures go back to be fixed, and still failing ends with 8',
+  'cli.checkRoundsFlag': 'for this run only: how many times the check runs (1-10; fixes = runs - 1) and the time limit per run (s)',
   'cli.evalTitle': 'Golden set',
   'cli.evalWhy': '— run a set of tasks on the real model and measure how many it gets done',
   'cli.evalInit': 'create five example tasks in golden/',

package/src/i18n/ja.js

@@ -286,7 +286,7 @@ export const ja = {
   'approve.auto.line': '訊かずに直します。/undo が受け皿です',
   'approve.confirm.name': '危ないものだけ',
   'approve.confirm.short': '危険時',
-  'approve.confirm.line': '取り消せないコマンドの前に訊きます。ファイルは訊かずに直します',
+  'approve.confirm.line': '取り消せないコマンドと MCP ツールの前に訊きます。ファイルは訊かずに直します',
   'approve.strict.name': '毎回訊く',
   'approve.strict.short': '毎回',
   'approve.strict.line': 'ファイルを直すたび、コマンドを打つたびに訊きます',
@@ -478,12 +478,14 @@ export const ja = {
   'ev.nudgeRead': '読むだけで終えようとしたので、一度押し戻しました',
   'check.start': '完了チェック ({판}/{최대}) — {명령}',
   'check.clamped': '{칸} {준값} は上限を超えるため {쓴값} にしました',
+  'check.invalid': '{칸} {준값} は使えない値のため既定の {쓴값} を使います',
   'check.pass': '完了チェック合格 — {명령}',
   'check.fail': '完了チェック失敗 ({판}/{최대}) — {요약}',
   'check.retry': '失敗内容を返して直させます',
   'check.gaveUp': '{판}回回しても失敗しました — 失敗として終えます',
   'check.skipped': '完了チェックを回せませんでした — {까닭}',
   'cli.checkFlag': '終える前にこのチェックを回し、通れば終了（失敗なら直させ、最後まで失敗なら 8）',
+  'cli.checkRoundsFlag': 'この実行だけ：チェックを回す回数（1〜10、直す機会は回数−1）と1回の制限時間（秒）',
   'cli.evalTitle': 'ゴールデンセット',
   'cli.evalWhy': '— 課題集を実際のモデルで回し、いくつこなせるかを測ります',
   'cli.evalInit': 'golden/ に例題を五つ作ります',

package/src/i18n/ko.js

@@ -308,7 +308,7 @@ export const ko = {
   'approve.auto.line': '안 묻고 고칩니다. 되돌리기(/undo)가 안전망입니다',
   'approve.confirm.name': '위험만 확인',
   'approve.confirm.short': '위험만',
-  'approve.confirm.line': '되돌릴 수 없는 명령만 물어봅니다. 파일은 안 묻고 고칩니다',
+  'approve.confirm.line': '되돌릴 수 없는 명령·MCP 도구만 물어봅니다. 파일은 안 묻고 고칩니다',
   'approve.strict.name': '모두 확인',
   'approve.strict.short': '모두',
   'approve.strict.line': '파일을 고치거나 명령을 돌리기 전에 매번 물어봅니다',
@@ -552,12 +552,14 @@ export const ko = {
   'ev.nudgeRead': '읽기만 하고 끝내려고 해서 한 번 되밀었습니다',
   'check.start': '완료 검사 ({판}/{최대}) — {명령}',
   'check.clamped': '{칸} {준값} 은 상한을 넘어 {쓴값} 으로 줄였습니다',
+  'check.invalid': '{칸} {준값} 은 쓸 수 없는 값이라 기본값 {쓴값} 을 씁니다',
   'check.pass': '완료 검사 통과 — {명령}',
   'check.fail': '완료 검사 실패 ({판}/{최대}) — {요약}',
   'check.retry': '실패 내용을 돌려주고 다시 고치게 합니다',
   'check.gaveUp': '{판}번 돌렸는데도 실패했습니다 — 실패로 끝냅니다',
   'check.skipped': '완료 검사를 못 돌렸습니다 — {까닭}',
   'cli.checkFlag': '끝내려 할 때 이 검사를 돌려 통과해야 끝남 (실패하면 고치게 하고, 끝내 실패면 8)',
+  'cli.checkRoundsFlag': '이번 실행에서만 검사 판수(1~10, 고칠 기회는 판수−1)·한 번의 제한 시간(초)을 덮음',
   'cli.evalTitle': '골든셋',
   'cli.evalWhy': '— 과제 모음을 실제 모델로 돌려 몇 개를 해내나 잽니다',
   'cli.evalInit': '예제 과제 다섯을 golden/ 에 만듭니다',

package/src/i18n/zh.js

@@ -286,7 +286,7 @@ export const zh = {
   'approve.auto.line': '不问就改。/undo 是兜底',
   'approve.confirm.name': '只问危险的',
   'approve.confirm.short': '危险时',
-  'approve.confirm.line': '收不回的命令之前会问。改文件不问',
+  'approve.confirm.line': '收不回的命令和 MCP 工具之前会问。改文件不问',
   'approve.strict.name': '每次都问',
   'approve.strict.short': '每次',
   'approve.strict.line': '每改一个文件、每跑一条命令都问',
@@ -478,12 +478,14 @@ export const zh = {
   'ev.nudgeRead': '只看不动就要收尾，已经推回去一次',
   'check.start': '完成检查 ({판}/{최대}) — {명령}',
   'check.clamped': '{칸} {준값} 超过上限，改用 {쓴값}',
+  'check.invalid': '{칸} {준값} 不是可用的值，改用默认值 {쓴값}',
   'check.pass': '完成检查通过 — {명령}',
   'check.fail': '完成检查失败 ({판}/{최대}) — {요약}',
   'check.retry': '把失败内容交回去重新修',
   'check.gaveUp': '跑了 {판} 次仍然失败 — 按失败结束',
   'check.skipped': '没能跑完成检查 — {까닭}',
   'cli.checkFlag': '结束前跑这个检查，通过才结束（失败就让它修，最后仍失败则返回 8）',
+  'cli.checkRoundsFlag': '仅本次运行：检查跑几次（1~10，修复机会 = 次数 − 1）和每次的时限（秒）',
   'cli.evalTitle': '黄金集',
   'cli.evalWhy': '— 用真实模型跑一组任务，测它能完成多少',
   'cli.evalInit': '在 golden/ 里建五个示例任务',

package/src/oneshot.js

@@ -49,93 +49,10 @@ import { 모두끝내기 as 일감모두끝내기, 일감인자 } from './tools/
 import { 첫이름 } from './tools/label.js';
 import { 검사설정 } from './agent/donecheck.js';
 
-/**
- * 종료코드.
- *
- * 스크립트는 화면 글이 아니라 이 숫자만 본다. 그래서 '끝났다' 와 '끝난 척했다'
- * 를 반드시 갈라 놔야 한다 — 걸음 수 상한에 걸려 멈춘 것을 0 으로 돌려주면
- * 야간 배치가 아무 일도 안 하고 초록불을 켠다. 그게 제일 나쁜 결말이다.
- */
-export const EXIT = {
-  done: 0,      // 끝까지 답했다
-  error: 1,     // 오류로 끝났다 (연결 없음 · 시킬 말 없음 · 모델 오류)
-  limit: 2,     // 도구 호출 걸음 수 상한에 닿았다
-  stuck: 3,     // 같은 자리에서 헛돌아 스스로 멈췄다
-  aborted: 4,   // 도중에 끊겼다 (Ctrl+C)
-  /*
-   * 서버가 끝났다는 말을 한 번도 안 주고 답을 멈췄다.
-   *
-   * 여기에 자기 코드가 있어야 한다. 전에는 이걸 아예 안 보고 `done`(0) 으로
-   * 끝냈다. `deel -p` 는 잡·CI 에서 돌고 그 뒤에 스크립트가 붙는데, 반쪽짜리
-   * 답이 0 으로 넘어가면 그 스크립트는 온전한 답으로 알고 그대로 쓴다.
-   * 사람이 나중에 결과를 보고 왜 반쪽인지 되짚을 방법이 없다.
-   */
-  cutoff: 5,
-  /*
-   * 모델이 안 하겠다고 했다 (안전 판정).
-   *
-   * 이것도 자기 코드가 있어야 한다. 거절한 답은 **아무 일도 안 한 답**인데,
-   * 도구 호출이 없다는 것 말고는 짧은 답과 겉모습이 같다. 0 으로 끝내면
-   * 뒤에 붙은 스크립트는 일이 된 줄 알고 그 다음 단계로 넘어간다.
-   *
-   * 오류(1)와도 갈라 둔다. 고칠 자리가 다르기 때문이다 — 오류는 연결이나
-   * 열쇠를 보는 일이고, 거절은 **시킨 말을 바꾸는 일**이다.
-   */
-  refusal: 6,
-  /*
-   * 답이 --output-schema 에 안 맞았다.
-   *
-   * 여기에도 자기 코드가 있어야 한다. 「모양을 못 박아 달라」 고 한 사람에게
-   * 모양이 안 맞는 것을 0 으로 넘기면, 파이프 뒤 스크립트가 그걸 온전한
-   * 것으로 받아 쓴다 — 그게 이 기능이 없애려던 바로 그 상황이다.
-   *
-   * 오류(1)와도 가른다. 고칠 자리가 다르다 — 오류는 연결을 보는 일이고,
-   * 이건 스키마나 시킨 말을 바꾸는 일이다.
-   */
-  schema: 7,
-  /*
-   * 완료 검사가 통과하지 않은 채 끝났다 (agent/donecheck.js · 2.1.0).
-   *
-   * 모델은 「다 됐습니다」 라고 했는데 사람이 정해 둔 검사(`--check` · 설정의 `check`)가
-   * 정해 둔 판수를 다 돌고도 빨갛거나, 관문에 막혀 아예 못 돌았다. 0 으로 끝내면 야간
-   * 배치가 빨간 검사 위에 초록불을 켠다 — 이 기능이 없애려던 바로 그 결말이다.
-   *
-   * 오류(1)와 가른다. 고칠 자리가 다르다 — 연결이 아니라 코드나 검사 쪽이다.
-   */
-  check: 8,
-  /*
-   * 인자를 잘못 줬다 — 모르는 깃발 · 값 없는 깃발 · 모르는 모드 이름 · 못 읽는 --ctx.
-   *
-   * 여기에 **따로** 둔다. 처음에는 `--work` 오타를 2 로 끝냈는데, 2 는 이 표에서 이미
-   * 「걸음 수 상한」 이다. `deel run --jsn …` 을 CI 에 건 사람은 오타 하나로 「일이 커서
-   * 멈췄다」 를 받고 작업을 쪼개러 간다. 고칠 자리가 스크립트 한 줄인데.
-   *
-   * 64 는 sysexits.h 의 EX_USAGE 다. 1~8 과 안 겹치고, 셸·CI 도구들이 「부른 모양이
-   * 틀렸다」 로 이미 알아듣는 수라 새로 지어내지 않았다. 이 경우는 모델을 한 번도 안 부른다.
-   */
-  usage: 64,
-};
+// 종료코드 표와 실패덩이는 src/exit.js 에 있다 — 진입점이 이 파일 없이 쓰게 (2.1.2).
+export { EXIT, 실패덩이 } from './exit.js';
+import { EXIT, 실패덩이 } from './exit.js';
 
-/**
- * 모델을 부르기 전에 선 실패 한 덩이 (사냥5 B5-10).
- *
- * 성공한 `--json` 에는 model 과 usage.prompt·cacheRead·cacheWrite·못잰것 이 있는데, 모델을
- * 부르기 전에 선 실패(64 · 7 · 시킬 말 없음 · 없는 뿌리 · 연결 없음 · 대화 화면 전용)에는
- * 그 칸들이 없었다. `jq .usage.prompt` 는 null 을, 모양을 못 박은 파서는 오류를 낸다 —
- * 실패를 제일 잘 다뤄야 할 자리에서 파서가 먼저 죽는다. 칸은 늘 같게 두고 값만 비운다.
- *
- * bin/deel.js 의 인자탈·마지막 catch 도 이걸로 짓는다. 세 벌이면 언젠가 한 벌만 고친다.
- */
-export function 실패덩이({ reason, code, why = '', model = null }) {
-  return {
-    ok: false, reason, code, text: '',
-    tools: 0, steps: 0,
-    usage: { in: 0, out: 0, prompt: 0, cacheRead: 0, cacheWrite: 0, calls: 0, ms: 0, 못잰것: 0, retries: 0 },
-    model,
-    ms: 0,
-    ...(why ? { why } : {}),
-  };
-}
 
 /**
  * 표준입력에 실려 온 말을 통째로 읽는다.
@@ -307,6 +224,17 @@ export async function runOnce(opts = {}) {
     }
   }
 
+  /*
+   * --check-rounds · --check-timeout (2.1.2). 치는 자리에서 바로 고칠 수 있으니 틀린 값은 사용법 틀림(64)이다 —
+   * 설정 파일에 적힌 틀린 값은 기본값을 쓰고 화면에 말하는 것(donecheck.js 의 줄임)과 다르다.
+   */
+  if (opts.checkRounds !== undefined && !(Number.isInteger(Number(opts.checkRounds)) && Number(opts.checkRounds) >= 1)) {
+    return 못함('usage', `--check-rounds 는 1 이상의 정수여야 합니다: ${opts.checkRounds}`);
+  }
+  if (opts.checkTimeout !== undefined && !(Number.isFinite(Number(opts.checkTimeout)) && Number(opts.checkTimeout) > 0)) {
+    return 못함('usage', `--check-timeout 은 0 보다 큰 초여야 합니다: ${opts.checkTimeout}`);
+  }
+
   // ── 시킬 말 ───────────────────────────────────────────────────────────
   // 인자로 준 것이 먼저다. 없을 때만 표준입력을 읽는다 —
   // 둘 다 있을 때 무엇이 이기는지가 헷갈리면 스크립트가 조용히 엉뚱한 일을 한다.
@@ -629,7 +557,11 @@ export async function runOnce(opts = {}) {
     // 안 거두면 배치가 끝나고도 언어 서버가 폴더를 물고 남는다.
     lsp: { 켬: true },
     // 끝내려는 자리에서 돌릴 검사 (agent/donecheck.js). `--check` 가 설정의 check 를 이긴다.
-    완료검사: 검사설정(cfg, opts.check),
+    완료검사: 검사설정({
+      ...cfg,
+      ...(opts.checkRounds !== undefined ? { checkRounds: Number(opts.checkRounds) } : {}),
+      ...(opts.checkTimeout !== undefined ? { checkTimeout: Number(opts.checkTimeout) } : {}),
+    }, opts.check),
     // 되물을 사람이 없으니 기본값을 그대로 돌려준다.
     ask: async (_label, o = {}) => o?.def ?? '',
     // 엑셀 암호를 여기서 기다리면 그대로 선다. 없다고 바로 답한다 —
@@ -929,7 +861,7 @@ export async function runOnce(opts = {}) {
 
         case 'check_start':
           곁(`  ${c.cyan('⧗')} ${c.gray(옮긴말('check.start', { 판: ev.판, 최대: ev.최대, 명령: ev.명령 }))}`);
-          for (const 줄 of ev.줄임 ?? []) 곁(`     ${c.yellow('⚠')} ${c.gray(옮긴말('check.clamped', 줄))}`);
+          for (const 줄 of ev.줄임 ?? []) 곁(`     ${c.yellow('⚠')} ${c.gray(옮긴말(줄.틀림 ? 'check.invalid' : 'check.clamped', 줄))}`);
           break;
 
         case 'check':

package/src/repl.js

@@ -3057,7 +3057,7 @@ export async function chatLoop(opts = {}) {
             if (streamed) { 답비우기(); say(''); streamed = false; }
             say('');
             say(`  ${c.cyan('⧗')} ${c.gray(옮긴말('check.start', { 판: ev.판, 최대: ev.최대, 명령: ev.명령 }))}`);
-            for (const 줄 of ev.줄임 ?? []) say(`     ${c.yellow('⚠')} ${c.gray(옮긴말('check.clamped', 줄))}`);
+            for (const 줄 of ev.줄임 ?? []) say(`     ${c.yellow('⚠')} ${c.gray(옮긴말(줄.틀림 ? 'check.invalid' : 'check.clamped', 줄))}`);
             break;
 
           case 'check':