agentlas 1.0.29 → 1.0.35

package/engine/ui/repl.cjs

@@ -132,6 +132,36 @@ async function startRepl(ctx, opts = {}) {
   let effortOverride = opts.effort || null;
 
   const recoverPresentation = (operation, error) => {
+    /*
+     * 정직 정지(honestStop)는 복구 대상이 아니다 (2026-08-06 실사용 실측).
+     * 실제 REPL에 자연어 지시를 하면 "이 프로젝트에 팀이 없다"는 정직한 안내가
+     * "One이 복구 중" 한 줄로 삼켜졌다 — 사용자는 무엇이 왜 안 되는지, 무엇을
+     * 하면 되는지 전혀 못 봤다(빈 답보다 나쁜 침묵). 정직 정지는 그 사유를
+     * 그대로 보여주고, 어떻게 실행하는지까지 덧붙인다. One 복구는 예상 못 한
+     * 실패에만 쓴다. (사람용 문장과 기계 판단은 다른 필드 — 스케줄러와 같은 원칙.)
+     */
+    if (error && (error.honestStop || error.code)) {
+      // 공유 controller 모듈은 lang을 모른다 — 기계 code로 여기서 현지화한다.
+      const KO_REASON = {
+        project_team_empty: "이 프로젝트에 에이전트 팀이 없습니다. Agentlas Desktop의 Work에서 에이전트를 넣고 다시 시도하세요.",
+        project_not_connected: "이 폴더는 Agentlas 프로젝트에 연결돼 있지 않습니다. Desktop Work에서 연결하거나, 특정 에이전트를 지정해 바로 실행하세요.",
+        project_ambiguous: "이 폴더에 Agentlas 프로젝트가 둘 이상 연결돼 있습니다. 소스 연결을 하나만 남기고 다시 시도하세요.",
+        project_team_unreadable: "이 프로젝트의 에이전트 팀을 읽을 수 없습니다. Agentlas Desktop에서 프로젝트를 열어 팀을 다시 저장하세요.",
+        project_teams_unsupported: "이 Agentlas 데이터 저장소는 아직 프로젝트 팀을 지원하지 않습니다. 최신 Agentlas Desktop을 한 번 실행한 뒤 다시 시도하세요.",
+      };
+      const reason = (!en && error.code && KO_REASON[error.code]) || String(error.message || error);
+      ui.line(ui.c.amber("✖ ") + reason);
+      // 데스크탑을 강제하지 않는다 — 터미널에서 바로 프로젝트를 연결한다(오너 원칙).
+      const connectHint = (error.code === "project_not_connected" || error.code === "project_team_empty");
+      ui.line(ui.c.dim(en
+        ? (connectHint
+          ? "Connect this folder standalone: agentlas project use <agent>  ·  list agents: /list  ·  or run one directly: agentlas run <agent> \"<task>\"."
+          : "Run a specific agent directly: agentlas run <agent> \"<task>\"  ·  list agents: /list.")
+        : (connectHint
+          ? "이 폴더를 바로 연결: agentlas project use <에이전트>  ·  에이전트 목록: /list  ·  또는 하나만 바로 실행: agentlas run <에이전트> \"<할 일>\"."
+          : "특정 에이전트로 바로 실행: agentlas run <에이전트> \"<할 일>\"  ·  에이전트 목록: /list.")));
+      return;
+    }
     const active = orch.active();
     const evidence = String((error && error.message) || error || "").slice(0, 8000);
     if (active && !active.isBusy()) {
@@ -252,10 +282,37 @@ async function startRepl(ctx, opts = {}) {
       },
     });
     const PROMPT = "› ";
+    /*
+     * 빈 입력 고스트 힌트 (2026-08-06, 레퍼런스 REPL 대조에서 나온 유도 격차).
+     * claude-code류 REPL은 빈 입력줄에 무엇을 칠 수 있는지 흐리게 보여준다 —
+     * 우리는 `› ` 뿐이라 첫 사용자가 / 팔레트·@ 멘션·? 도움의 존재를 알 길이
+     * 없었다. 커서 "뒤"에 dim 힌트를 쓰고 커서를 되돌린다. 어떤 키든 처음
+     * 눌리는 순간 커서-뒤 지우기(CSI K)로 걷어내므로 readline 의 echo·팔레트
+     * 오버레이와 겹치지 않는다. 비TTY·바쁜 세션에서는 그리지 않는다.
+     */
+    const { visWidth } = require("../agentlas-composer.cjs");
+    const GHOST_HINT = en
+      ? "type a task · / commands · @ files · ? shortcuts"
+      : "할 일을 문장으로 · / 명령 · @ 파일 · ? 단축키";
+    let ghostVisible = false;
+    const drawGhost = () => {
+      if (!process.stdout.isTTY || rl.line) return;
+      const width = visWidth(GHOST_HINT);
+      const room = (process.stdout.columns || 80) - visWidth(PROMPT) - 2;
+      if (width > room) return; // 좁은 터미널에서는 유도보다 입력이 우선이다
+      ui.write(ui.c.faint(GHOST_HINT) + `\x1b[${width}D`);
+      ghostVisible = true;
+    };
+    const clearGhost = () => {
+      if (!ghostVisible) return;
+      ghostVisible = false;
+      if (process.stdout.isTTY) ui.write("\x1b[K");
+    };
     const prompt = () => {
       if (!renderer.session || !renderer.session.isBusy()) {
         rl.setPrompt(PROMPT);
         rl.prompt();
+        drawGhost();
       }
     };
 
@@ -289,6 +346,8 @@ async function startRepl(ctx, opts = {}) {
       },
     });
     const onShortcutKey = (str, key) => {
+      // 고스트 힌트는 어떤 키가 와도 readline 이 echo 하기 전에 걷어낸다.
+      clearGhost();
       if (!permissionShortcut.handleKey(str, key)) return;
       swallowCompletion = true;
       setImmediate(() => { swallowCompletion = false; });
@@ -329,10 +388,62 @@ async function startRepl(ctx, opts = {}) {
       }
     };
 
+    let emptyEnters = 0;
     rl.on("line", (line) => {
       sigints = 0;
       const input = line.trim();
-      if (!input) { prompt(); return; }
+      if (!input) {
+        /*
+         * 빈 Enter 유도 (2026-08-06 레퍼런스 대조): 1회는 조용히 — 실수로 친
+         * Enter 마다 잔소리하면 소음이다. 연달아 두 번이면 길을 잃은 것이므로
+         * 다음 행선지를 한 줄로 보여준다.
+         */
+        emptyEnters += 1;
+        if (emptyEnters >= 2) {
+          emptyEnters = 0;
+          ui.line(ui.c.dim(en
+            ? "Type a task in plain words, / for commands, ? for shortcuts."
+            : "할 일을 그냥 문장으로 치세요. / 는 명령, ? 는 단축키입니다."));
+        }
+        prompt();
+        return;
+      }
+      emptyEnters = 0;
+
+      /*
+       * `?` 단축키 도움 (2026-08-06): 첫 화면 어디에도 키 조작법이 없었다 —
+       * Shift-Tab 권한 순환·조종 큐·@멘션은 아는 사람만 썼다. 한 글자로 요약을
+       * 준다(claude-code 의 ? 관례).
+       */
+      if (input === "?") {
+        const rowsHelp = en ? [
+          ["/", "command palette (type to filter, ↑↓ pick, Tab complete, Esc close)"],
+          ["Tab", "complete commands, agent names, @file paths, session keys"],
+          ["@path", "mention a file anywhere in your sentence"],
+          ["↑ / ↓", "input history (kept across sessions)"],
+          ["Shift-Tab", "cycle permission read → write (twice for full)"],
+          ["Ctrl-C", "interrupt the running turn · press twice to quit"],
+          ["typing while running", "queues steering for the current turn"],
+          ["/sessions · /s <n>", "list · switch parallel sessions"],
+        ] : [
+          ["/", "명령 팔레트 (입력=검색, ↑↓ 선택, Tab 완성, Esc 닫기)"],
+          ["Tab", "명령·에이전트 이름·@파일 경로·세션 키 완성"],
+          ["@경로", "문장 어디서든 파일 멘션"],
+          ["↑ / ↓", "입력 히스토리 (세션 넘어 유지)"],
+          ["Shift-Tab", "권한 순환 read → write (두 번이면 full)"],
+          ["Ctrl-C", "실행 중 턴 중단 · 두 번이면 종료"],
+          ["실행 중 타이핑", "현재 턴에 조종 지시로 쌓임"],
+          ["/sessions · /s <n>", "병렬 세션 목록 · 전환"],
+        ];
+        // 한글 키 라벨은 전각 폭 — padEnd(코드포인트 수)로 맞추면 열이 어긋난다.
+        const keyWidth = Math.max(...rowsHelp.map(([k]) => visWidth(k)));
+        ui.line(ui.c.bold(en ? "Shortcuts" : "단축키"));
+        for (const [k, desc] of rowsHelp) {
+          ui.line("  " + ui.c.blue(k) + " ".repeat(keyWidth - visWidth(k)) + "  " + ui.c.dim(desc));
+        }
+        prompt();
+        return;
+      }
 
       if (input.startsWith("/")) {
         try {

package/engine/vendor/desktop-core.manifest.json

@@ -0,0 +1,7 @@
+{
+  "version": "2",
+  "url": "https://github.com/agentlas-ai/agentlas-terminal/releases/download/desktop-core-v2/desktop-core.tar.gz",
+  "sha256": "782760c34af1d06b9efd212d48ba032fe46907bdc8bc836025c44fc658968d6f",
+  "sizeBytes": 12295321,
+  "writtenAt": "2026-08-09T21:43:34.707Z"
+}

package/engine/workforce/capture.cjs

@@ -18,6 +18,7 @@
  *    프로젝트 .env가 보호 키(타임아웃/캡처 상한 포함)를 덮지 못한다
  */
 const fs = require("node:fs");
+const { detectRuntimeRefusal } = require("../runtime-refusal.cjs");
 const os = require("node:os");
 const path = require("node:path");
 const { spawn } = require("node:child_process");
@@ -309,6 +310,48 @@ function capturedRuntimeUsage(kind, raw) {
   return null;
 }
 
+
+/**
+ * ★캡처된 스트림에서 **실패 표식**을 걷는다 — 종료코드만 보면 exit 0 거절이 산출물이 된다.
+ *
+ * 실측(2026-08-06): claude 한도는 rate_limit_event(status:rejected)·result(is_error:true)를
+ * 보내고, codex 한도는 표식 없이 거절문을 agent_message로 싣고 turn.completed로 끝난다.
+ * 이 파일은 이벤트 종류 목록에 rate_limit_event를 적어 두고도 한 번도 읽지 않았다 —
+ * 거절문이 그대로 워커 핸드오프가 되어 종합(synthesis)에 섞였다.
+ */
+function capturedRuntimeFailure(kind, raw, text) {
+  const events = raw.split(/\r?\n/).map((line) => {
+    try { return JSON.parse(line); } catch { return null; }
+  }).filter(Boolean);
+  for (const event of events) {
+    if (!event || typeof event !== "object") continue;
+    if (kind === "claude-code") {
+      if (event.type === "result" && event.is_error) {
+        return { message: typeof event.result === "string" ? event.result : "claude error", source: "marker" };
+      }
+      if (event.type === "rate_limit_event" && event.rate_limit_info && event.rate_limit_info.status === "rejected") {
+        return { message: "claude rate limit rejected", source: "marker" };
+      }
+    }
+    if (kind === "codex" && (event.type === "turn.failed" || event.type === "error")) {
+      const msg = (event.error && (event.error.message || event.error)) || "codex error";
+      return { message: String(msg), source: "marker" };
+    }
+    if (kind === "gemini") {
+      if (event.type === "error") {
+        const msg = (event.error && (event.error.message || event.error)) || "gemini error";
+        return { message: String(msg), source: "marker" };
+      }
+      if (event.type === "result" && event.status && event.status !== "success") {
+        return { message: `gemini ${event.status}`, source: "marker" };
+      }
+    }
+  }
+  // 표식이 전혀 없는 케이스(codex 한도) — 휴리스틱 최후 그물, 출처 표기.
+  const refusal = detectRuntimeRefusal(text);
+  return refusal ? { message: refusal.message, source: "heuristic" } : null;
+}
+
 function capturedRuntimeAgentText(kind, raw) {
   const text = String(raw || "");
   const events = [];
@@ -377,7 +420,8 @@ function captureRuntime(kind, systemPrompt, prompt, opts) {
     ? captureOutputLimit(opts.env || process.env)
     : directCaptureOutputLimit(opts.outputLimitBytes);
   return new Promise((resolve, reject) => {
-    const bin = which(RUNTIME_BIN[kind]) || RUNTIME_BIN[kind];
+    // 계약 테스트용 실행 파일 주입(가짜 CLI가 픽스처를 cat) — 프로덕션 경로에선 없음.
+    const bin = opts.binOverride || which(RUNTIME_BIN[kind]) || RUNTIME_BIN[kind];
     let child;
     try {
       const spawnImpl = opts.spawn || spawn;
@@ -523,6 +567,12 @@ function captureRuntime(kind, systemPrompt, prompt, opts) {
       } else {
         text = raw;
       }
+      // ★거절 고지문은 산출물이 아니다 — 성공으로 돌려주면 워커 핸드오프가 오염된다.
+      const failure = capturedRuntimeFailure(kind, raw, text);
+      if (failure) {
+        finishReject(new Error(`${kind} runtime refused (${failure.source}): ${failure.message}`));
+        return;
+      }
       finishResolve(opts.envelope
         ? { text, usage: capturedRuntimeUsage(kind, raw) }
         : text);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agentlas",
-  "version": "1.0.29",
-  "description": "Agentlas project terminal \u2014 run project controllers and task-scoped agent teams from the terminal. Standalone: no desktop app process required.",
+  "version": "1.0.35",
+  "description": "Agentlas project terminal — run project controllers and task-scoped agent teams from the terminal. Standalone: no desktop app process required.",
   "bin": {
     "agentlas": "bin/agentlas.cjs"
   },
@@ -9,6 +9,7 @@
     "smoke": "sh test/smoke.sh",
     "test:release-contracts": "npm run smoke",
     "sync:architecture": "node scripts/sync-architecture-from-desktop.cjs",
+    "vendor:core": "node scripts/vendor-desktop-core.cjs",
     "test:tool-access-notice-parity": "node test/tool-access-notice-parity.cjs"
   },
   "engines": {