cuelo 0.10.13 → 0.10.15

package/.next/trace-build

@@ -1 +1 @@
-[{"name":"run-webpack","duration":118293863,"timestamp":714059,"id":14,"parentId":1,"tags":{},"startTime":1791939358075,"traceId":"4479964e48aa09a4"},{"name":"run-typescript","duration":22163686,"timestamp":119405466,"id":11124,"parentId":1,"tags":{},"startTime":1791939476767,"traceId":"4479964e48aa09a4"},{"name":"static-check","duration":4360797,"timestamp":141660966,"id":11127,"parentId":1,"tags":{},"startTime":1791939499022,"traceId":"4479964e48aa09a4"},{"name":"static-generation","duration":12993696,"timestamp":146124342,"id":11303,"parentId":1,"tags":{},"startTime":1791939503486,"traceId":"4479964e48aa09a4"},{"name":"collect-build-traces","duration":22368011,"timestamp":146093136,"id":11300,"parentId":1,"tags":{},"startTime":1791939503454,"traceId":"4479964e48aa09a4"},{"name":"telemetry-flush","duration":89,"timestamp":168466111,"id":11312,"parentId":1,"tags":{},"startTime":1791939525827,"traceId":"4479964e48aa09a4"},{"name":"next-build","duration":167872935,"timestamp":593287,"id":1,"tags":{"buildMode":"default","version":"16.2.12","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1791939357955,"traceId":"4479964e48aa09a4"}]
+[{"name":"run-webpack","duration":99280607,"timestamp":676909,"id":14,"parentId":1,"tags":{},"startTime":1791992276436,"traceId":"b04c8895f5bd07bb"},{"name":"run-typescript","duration":17699234,"timestamp":100322529,"id":11105,"parentId":1,"tags":{},"startTime":1791992376083,"traceId":"b04c8895f5bd07bb"},{"name":"static-check","duration":3656023,"timestamp":118114181,"id":11108,"parentId":1,"tags":{},"startTime":1791992393876,"traceId":"b04c8895f5bd07bb"},{"name":"static-generation","duration":10196854,"timestamp":121855723,"id":11282,"parentId":1,"tags":{},"startTime":1791992397617,"traceId":"b04c8895f5bd07bb"},{"name":"collect-build-traces","duration":17566089,"timestamp":121835221,"id":11279,"parentId":1,"tags":{},"startTime":1791992397597,"traceId":"b04c8895f5bd07bb"},{"name":"telemetry-flush","duration":74,"timestamp":139405208,"id":11291,"parentId":1,"tags":{},"startTime":1791992415167,"traceId":"b04c8895f5bd07bb"},{"name":"next-build","duration":138830797,"timestamp":574508,"id":1,"tags":{"buildMode":"default","version":"16.2.12","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1791992276333,"traceId":"b04c8895f5bd07bb"}]

package/.next/types/app/api/{lounge/events → live/interpret}/route.ts

@@ -1,10 +1,10 @@
-// File: D:\a\CUELO\CUELO\app\api\lounge\events\route.ts
-import * as entry from '../../../../../../app/api/lounge/events/route.js'
+// File: D:\a\CUELO\CUELO\app\api\live\interpret\route.ts
+import * as entry from '../../../../../../app/api/live/interpret/route.js'
 import type { NextRequest } from 'next/server.js'
 
 import type { InstantConfigForTypeCheckInternal } from 'next/dist/build/segment-config/app/app-segment-config.js'
 
-type TEntry = typeof import('../../../../../../app/api/lounge/events/route.js')
+type TEntry = typeof import('../../../../../../app/api/live/interpret/route.js')
 
 type SegmentParams<T extends Object = any> = T extends Record<string, any>
   ? { [K in keyof T]: T[K] extends string ? string | string[] | undefined : never }

package/.next/types/routes.d.ts

@@ -2,7 +2,7 @@
 // Do not edit this file manually
 
 type AppRoutes = "/" | "/office" | "/office-preview" | "/recover"
-type AppRouteHandlerRoutes = "/api/agent/[id]" | "/api/agent/[id]/account" | "/api/agent/[id]/bash-output" | "/api/agent/[id]/events" | "/api/agent/new" | "/api/agent/running" | "/api/attachment-settings" | "/api/attachments" | "/api/attachments/[id]/transcription" | "/api/attachments/draft" | "/api/auth/all-providers" | "/api/auth/api-key/[provider]" | "/api/auth/login/[provider]" | "/api/auth/logout/[provider]" | "/api/auth/providers" | "/api/cwd/browse" | "/api/cwd/validate" | "/api/default-cwd" | "/api/display-settings" | "/api/document-text" | "/api/experiments" | "/api/file-index" | "/api/files/[...path]" | "/api/git/diff" | "/api/git/status" | "/api/github/projects" | "/api/gpt6/handles" | "/api/gpt6/reply" | "/api/gpt6/token" | "/api/gpt6/web6-session" | "/api/home" | "/api/live/call/[callId]" | "/api/live/character-voice" | "/api/live/events" | "/api/live/offer" | "/api/live/voices" | "/api/lounge" | "/api/lounge/events" | "/api/mcp" | "/api/model-roles" | "/api/models" | "/api/models-config" | "/api/models-config/catalog" | "/api/models-config/discover" | "/api/models-config/test" | "/api/office-avatars" | "/api/office-avatars/[id]" | "/api/plugins" | "/api/project-docs" | "/api/project-trust" | "/api/projects" | "/api/runs" | "/api/runs/[runId]" | "/api/sessions" | "/api/sessions/[id]" | "/api/sessions/[id]/auto-name" | "/api/sessions/[id]/context" | "/api/sessions/[id]/entries/[entryId]/thinking" | "/api/sessions/[id]/export" | "/api/sessions/[id]/state" | "/api/sessions/search" | "/api/settings" | "/api/sidecars/[service]/[...path]" | "/api/skills" | "/api/skills/check" | "/api/skills/install" | "/api/skills/search" | "/api/skills/update" | "/api/subagents/eta" | "/api/theme" | "/api/tool-image" | "/api/update-maintenance" | "/api/updates" | "/api/web-access" | "/api/web-access/recovery" | "/api/web6/consults" | "/api/worktrees"
+type AppRouteHandlerRoutes = "/api/agent/[id]" | "/api/agent/[id]/account" | "/api/agent/[id]/bash-output" | "/api/agent/[id]/events" | "/api/agent/new" | "/api/agent/running" | "/api/attachment-settings" | "/api/attachments" | "/api/attachments/[id]/transcription" | "/api/attachments/draft" | "/api/auth/all-providers" | "/api/auth/api-key/[provider]" | "/api/auth/login/[provider]" | "/api/auth/logout/[provider]" | "/api/auth/providers" | "/api/cwd/browse" | "/api/cwd/validate" | "/api/default-cwd" | "/api/display-settings" | "/api/document-text" | "/api/experiments" | "/api/file-index" | "/api/files/[...path]" | "/api/git/diff" | "/api/git/status" | "/api/github/projects" | "/api/gpt6/handles" | "/api/gpt6/reply" | "/api/gpt6/token" | "/api/gpt6/web6-session" | "/api/home" | "/api/live/call/[callId]" | "/api/live/character-voice" | "/api/live/events" | "/api/live/interpret" | "/api/live/offer" | "/api/live/voices" | "/api/mcp" | "/api/model-roles" | "/api/models" | "/api/models-config" | "/api/models-config/catalog" | "/api/models-config/discover" | "/api/models-config/test" | "/api/office-avatars" | "/api/office-avatars/[id]" | "/api/plugins" | "/api/project-docs" | "/api/project-trust" | "/api/projects" | "/api/runs" | "/api/runs/[runId]" | "/api/sessions" | "/api/sessions/[id]" | "/api/sessions/[id]/auto-name" | "/api/sessions/[id]/context" | "/api/sessions/[id]/entries/[entryId]/thinking" | "/api/sessions/[id]/export" | "/api/sessions/[id]/state" | "/api/sessions/search" | "/api/settings" | "/api/sidecars/[service]/[...path]" | "/api/skills" | "/api/skills/check" | "/api/skills/install" | "/api/skills/search" | "/api/skills/update" | "/api/subagents/eta" | "/api/theme" | "/api/tool-image" | "/api/update-maintenance" | "/api/updates" | "/api/web-access" | "/api/web-access/recovery" | "/api/web6/consults" | "/api/worktrees"
 type PageRoutes = never
 type LayoutRoutes = "/"
 type RedirectRoutes = never
@@ -46,10 +46,9 @@ interface ParamMap {
   "/api/live/call/[callId]": { "callId": string; }
   "/api/live/character-voice": {}
   "/api/live/events": {}
+  "/api/live/interpret": {}
   "/api/live/offer": {}
   "/api/live/voices": {}
-  "/api/lounge": {}
-  "/api/lounge/events": {}
   "/api/mcp": {}
   "/api/model-roles": {}
   "/api/models": {}

package/.next/types/validator.ts

@@ -389,37 +389,28 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
-// Validate ../../app/api/live/offer/route.ts
-{
-  type __IsExpected<Specific extends RouteHandlerConfig<"/api/live/offer">> = Specific
-  const handler = {} as typeof import("../../app/api/live/offer/route.js")
-  type __Check = __IsExpected<typeof handler>
-  // @ts-ignore
-  type __Unused = __Check
-}
-
-// Validate ../../app/api/live/voices/route.ts
+// Validate ../../app/api/live/interpret/route.ts
 {
-  type __IsExpected<Specific extends RouteHandlerConfig<"/api/live/voices">> = Specific
-  const handler = {} as typeof import("../../app/api/live/voices/route.js")
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/live/interpret">> = Specific
+  const handler = {} as typeof import("../../app/api/live/interpret/route.js")
   type __Check = __IsExpected<typeof handler>
   // @ts-ignore
   type __Unused = __Check
 }
 
-// Validate ../../app/api/lounge/events/route.ts
+// Validate ../../app/api/live/offer/route.ts
 {
-  type __IsExpected<Specific extends RouteHandlerConfig<"/api/lounge/events">> = Specific
-  const handler = {} as typeof import("../../app/api/lounge/events/route.js")
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/live/offer">> = Specific
+  const handler = {} as typeof import("../../app/api/live/offer/route.js")
   type __Check = __IsExpected<typeof handler>
   // @ts-ignore
   type __Unused = __Check
 }
 
-// Validate ../../app/api/lounge/route.ts
+// Validate ../../app/api/live/voices/route.ts
 {
-  type __IsExpected<Specific extends RouteHandlerConfig<"/api/lounge">> = Specific
-  const handler = {} as typeof import("../../app/api/lounge/route.js")
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/live/voices">> = Specific
+  const handler = {} as typeof import("../../app/api/live/voices/route.js")
   type __Check = __IsExpected<typeof handler>
   // @ts-ignore
   type __Unused = __Check

package/README.md

@@ -105,15 +105,13 @@ Anthropic 구독 계정이 모두 주간 한도에 닿으면, 미리 둔 예비
 - ChatGPT 상담(SHION): 로컬 shim이 전용 ChatGPT 탭에서 받은 답을 현재 omp 세션에 투영하고, 상담 기록과 실패 기록이 대화창에 표시됩니다.
 - 실시간 음성: 브라우저 마이크로 Codex live 음성 세션을 엽니다. “끊어”, “알았어, 끊어봐”, “아니 통화 종료하라고”처럼 단독 종료 요청을 말하면 최종 전사를 받은 뒤 마이크와 통화를 종료합니다. 선택 기능인 캐릭터 음성은 **설정 → 통화 음성**에서 Cartesia API 키를 입력하고 음성 준비에 동의하면 현재 Main 캐릭터에 맞춰 적용됩니다. 통화 답변은 실제로 말한 캐릭터의 얼굴과 이름으로 표시되고, 캐릭터 음성 대신 기본 음성으로 말했으면 「기본 음성」이라고 함께 보입니다. 입력창에는 통화 시작·종료 버튼만 남으며, 좁은 화면에서는 모델 선택 등 다른 조작부와 겹치지 않게 줄바꿈합니다. 별도 음성 ID 입력은 필요하지 않으며, 키는 서버에만 보관합니다. 지원 플랜·크레딧 사용·전송 범위는 [캐릭터 통화 설정](./docs/live-voice.md)을 확인하세요.
 
-**단톡방**
-
-- 사이드바의 「단톡방」에서 멤버별 참여와 주간 사용량을 보고, 가운데 대화창에서 멘션·답장·반응을 주고받습니다. 방 전체와 멤버별 참여를 따로 켜고 끌 수 있습니다.
-- 작업 화면으로 돌아가도 선택한 세션·작성 중인 초안·진행 중인 작업은 유지됩니다. 단톡방 기록은 작업 대화와 별도로 보관하며, 멤버에게 작업 문맥이나 실행 도구를 전달하지 않습니다.
-- 단톡방의 계정 연결은 작업 세션의 계정을 바꾸지 않습니다. 연결한 계정을 사용할 수 없으면 다른 계정으로 넘어가지 않고 다시 선택하도록 안내합니다.
-- 단톡방에는 낮은 추론 강도(`low`)를 사용하며 작업 세션의 추론 설정은 바꾸지 않습니다. 시간당 호출은 최대 120회, 사용자 메시지 한 건에 대한 응답은 멤버끼리 이어 말하는 발언을 합쳐 최대 6회입니다. 실제 계정 한도 보호도 계속 적용합니다.
-- 사용자 메시지에 답한 뒤에도 멤버끼리 앞 사람 말을 받아 이어 갑니다. 답에서 부른 멤버가 먼저 받고, 부른 멤버가 없으면 가장 오래 말하지 않은 멤버가 받습니다. 답하지 못한 멤버가 있으면 건너뛰고 다음 멤버가 잇습니다.
-- 자동 수다는 직접 켜야 합니다. 켜 두면 조용할 때 멤버끼리 짧게 주고받습니다(속도에 따라 2·4·6회). 작업 중에는 자동 수다를 쉬고, 호출 상한과 사용량 보호를 적용합니다. 「중단」이나 방 끄기로 진행 중 응답을 멈출 수 있습니다.
-- 한국어로 대화하되 짧은 일본어 표현을 쓸 때는 이어지는 말에서 뜻을 보완하도록 안내합니다. 실제 표현은 참여 모델에 따라 달라집니다. SHION은 상담 전용으로 남습니다.
+**통역**
+
+- 사이드바의 「통역」을 고르면 작업 화면 위에 통역 화면이 열립니다. 한국어·영어·베트남어·일본어·태국어 가운데 내 언어와 상대 언어를 고르고 「통역 시작」을 누르면, 휴대폰을 두 사람 사이에 두고 각자 말하기만 하면 됩니다. 누가 말하든 상대 언어로 바로 소리 내어 옮깁니다. 버튼을 번갈아 누를 필요가 없습니다.
+- 통역은 연결된 ChatGPT 계정의 Codex 라이브 음성 통화로 합니다. 통화에는 고른 두 언어로 만든 짧은 통역 지시만 들어가고, 작업 세션·하네스 규칙·대화 기록은 들어가지 않으며 작업을 위임하지도 않습니다. 목소리는 Codex 기본 음성입니다.
+- 화면에는 오간 말이 말풍선 자막으로 쌓입니다. 큰 글씨가 통역, 작은 글씨가 들은 원문입니다. 글자(한글·가나·태국 문자·베트남어 성조 부호 등)로 누가 말했는지 가려 내 말은 오른쪽, 상대 말은 왼쪽에 둡니다. 영어와 베트남어처럼 같은 글자를 쓰는 짝에서 이름·숫자만 말해 가를 수 없으면 왼쪽에 둡니다.
+- 통역 중에 언어를 바꾸면 새 언어 짝으로 다시 연결합니다. 「대화로」를 누르면 통화와 마이크를 끝냅니다. 마이크는 HTTPS 주소에서만 켜지며, 통역 기록은 화면이 열려 있는 동안만 보관하고 서버에 저장하지 않습니다. 직접 입력해 번역하는 칸과 말풍선 다시 듣기는 없습니다.
+- 작업 화면으로 돌아가도 선택한 세션·작성 중인 초안·진행 중인 작업은 그대로입니다.
 
 **알림과 표현**
 

package/Tools/CUELO_Setup/files/native-runtime-patch.js

@@ -9,7 +9,7 @@ const MEMORY_RE = /(const phase1Model = await resolveMemoryModel\(\{[^}]*?fallba
 const MEMORY_DONE = /const phase1Model = await resolveMemoryModel\(\{[^}]*?fallbackRole: "smol"/;
 const EXPECTED = {
     name: 'cuelo',
-    version: '0.10.13',
+    version: '0.10.15',
     distribution: 'cuelo',
     coreVersion: '18.10.4',
 };

package/Tools/OMP_Global_Config/agent/extensions/command-guard/index.ts

@@ -1,5 +1,7 @@
 import { execFile } from "node:child_process";
-import { resolve } from "node:path";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
 
 import { isToolCallEventType, type ExtensionAPI } from "@oh-my-pi/pi-coding-agent";
 import { resolveToCwd } from "@oh-my-pi/pi-coding-agent/tools/path-utils";
@@ -15,6 +17,7 @@ import { resolvePreparedTaskInput } from "../lib/prepared-task";
 import { selectGitExecutor, type GitExecutor } from "../../tools/git-finalizer/wsl-git";
 
 import { matchBlockedCommand } from "./matcher";
+import { interopHint, windowsOutputCommand } from "./interop-hint";
 import { matchPowerShellSyntax } from "./powershell-syntax";
 import {
   bindSpawnAliases,
@@ -45,6 +48,16 @@ import {
   type TreeSnapshot,
 } from "./task-guard";
 
+/** WSL에서 Windows 실행 파일을 부를 수 있는지(binfmt interop 등록). Windows 출력 변환을 이때만 붙인다. */
+const WSL_INTEROP = process.platform === "linux" && existsSync("/proc/sys/fs/binfmt_misc/WSLInterop");
+
+/** eval이 자동으로 고르는 관리 Python 환경(코어 `getPythonEnvDir()` 기본값). WSL(Linux)에만 안내한다. */
+function managedPythonPath(): string | undefined {
+  if (process.platform !== "linux") return undefined;
+  const python = join(homedir(), ".omp", "python-env", "bin", "python");
+  return existsSync(python) ? python : undefined;
+}
+
 function normalizeRepositoryPath(value: string): string {
   return resolve(value).replace(/\\/g, "/").toLowerCase();
 }
@@ -941,22 +954,25 @@ export default function commandGuard(pi: ExtensionAPI): void {
         return false;
       },
     });
-    if (targetDirectories.length === 0 && windowsGitTargets.length === 0) {
-      if (preliminaryReason) return { block: true, reason: preliminaryReason };
-      return;
+    let reason = preliminaryReason;
+    if (targetDirectories.length > 0 || windowsGitTargets.length > 0) {
+      const [isSessionRepository, usesWindowsGit] = await Promise.all([
+        targetDirectories.length > 0
+          ? repositoryMatcher(sessionCwd, targetDirectories)
+          : (_directory: string) => true,
+        windowsGitMatcher(windowsGitTargets),
+      ]);
+      reason = matchBlockedCommand(event.input.command, {
+        cwd,
+        isSessionRepository,
+        usesWindowsGit,
+      });
     }
-    const [isSessionRepository, usesWindowsGit] = await Promise.all([
-      targetDirectories.length > 0
-        ? repositoryMatcher(sessionCwd, targetDirectories)
-        : (_directory: string) => true,
-      windowsGitMatcher(windowsGitTargets),
-    ]);
-    const reason = matchBlockedCommand(event.input.command, {
-      cwd,
-      isSessionRepository,
-      usesWindowsGit,
-    });
     if (reason) return { block: true, reason };
+    // 통과한 명령 중 Windows 실행 파일을 부르는 것은 출력이 UTF-8로 오도록 감싸 실행한다(interop-hint.ts).
+    const pty = (event.input as { pty?: unknown }).pty === true;
+    const command = windowsOutputCommand(event.input.command, { wsl: WSL_INTEROP, pty });
+    return command ? { input: { ...event.input, command } } : undefined;
   });
 
   // 실행된 task 호출(tool_result)과 실행 전에 끝난 호출(tool_execution_end)은 같은 항목 단위 정산을 탄다.
@@ -988,6 +1004,12 @@ export default function commandGuard(pi: ExtensionAPI): void {
       return { content: [...event.content, { type: "text", text: lines.join("\n") }] };
     }
 
+    if (event.toolName === "bash") {
+      const command = typeof event.input.command === "string" ? event.input.command : "";
+      const output = event.content.map((part) => (part.type === "text" ? part.text : "")).join("\n");
+      const hint = interopHint(command, output, { managedPython: managedPythonPath() });
+      return hint ? { content: [...event.content, { type: "text", text: hint }] } : undefined;
+    }
     if (event.isError) return;
     const path = typeof event.input.path === "string" ? event.input.path.trim() : "";
     // 18.3.0 write/read 결과의 proc:// details는 선언 타입에 없으므로 unknown으로 좁힌다.

package/Tools/OMP_Global_Config/agent/extensions/command-guard/interop-hint.ts

@@ -0,0 +1,122 @@
+/**
+ * WSL bash에서 Windows/Linux 차이로 생기는 실패를 다룬다.
+ *
+ * 근거(2026-10-14 세션 기록 집계, WSL 이관 10-07 이후):
+ * - Windows 실행 파일 출력의 CP949 한글이 U+FFFD로 깨진 호출 66건. pi-natives가 bash 출력을 UTF-8로
+ *   손실 해석하므로 결과 쪽에서는 되살릴 수 없다. 그래서 실행 전에 출력이 UTF-8이 되도록 명령을 감싼다
+ *   ({@link windowsOutputCommand}). 감싸지 못한 명령이 깨지면 다시 실행할 방법을 안내한다.
+ * - 시스템 `python3`에 PyMuPDF·openpyxl·Pillow·ezdxf·python-docx가 없어 실패한 호출 28건.
+ *   관리 Python 환경(`~/.omp/python-env`, eval이 자동으로 고르는 환경)에는 설치돼 있다.
+ */
+
+// 실행 파일 이름 끝의 `.exe`만 본다(`x.exe.log` 같은 인자는 아니다). `powershell`·`pwsh`도 낱말 하나일 때만(`powershell.md`는 아니다).
+const WINDOWS_EXECUTABLE = /\.exe(?=["'\s;&|)<>]|$)|(?<=^|[\s;&|(/"'=])(?:powershell|pwsh)(?=["'\s;&|)<>]|$)/im;
+const MOJIBAKE = /\uFFFD{2,}/;
+const MISSING_PYTHON_MODULE = /ModuleNotFoundError: No module named '([\w.]+)'/;
+// `python3`, `python3.12`, `/usr/bin/python3`, `"/usr/bin/python3"`처럼 경로·따옴표를 붙인 호출도 잡는다.
+const PYTHON_COMMAND = /(?:^|[\s;&|(/"'])python3?(?:\.\d+)?(?=["'\s;&|)]|$)/m;
+
+export interface InteropHintContext {
+  /** 관리 Python 환경의 python 실행 파일. 없으면 Python 안내를 내지 않는다. */
+  managedPython?: string;
+}
+
+// 출력 줄이 UTF-8로 읽히면 그대로 두고, 아니면 CP949로 읽어 UTF-8로 낸다. Windows의 UTF-8 출력
+// (`git.exe`, `WSL_UTF8`을 받은 `wsl.exe`, BOM `.ps1`)과 Linux 출력은 바뀌지 않는다.
+const DECODER = [
+  "import sys",
+  "w = sys.stdout.buffer",
+  "for b in iter(sys.stdin.buffer.readline, b''):",
+  "    try:",
+  "        t = b.decode('utf-8')",
+  "    except UnicodeDecodeError:",
+  "        t = b.decode('cp949', 'replace')",
+  "    w.write(t.encode('utf-8'))",
+  "    w.flush()",
+].join("\n");
+// 출력이 변환기 하나를 거치도록 원래 명령을 실제 bash 한 번으로 돌리고, 그 종료 코드를 그대로 돌려준다.
+// 원문과 변환기는 base64로 넘겨 따옴표·heredoc이 어떤 모양이든 그대로 실행된다.
+const RUNNER =
+  'c=$(printf %s "$1" | base64 -d) && p=$(printf %s "$2" | base64 -d) || exit 2; ' +
+  'bash -c "$c" 2>&1 | python3 -u -c "$p"; exit "${PIPESTATUS[0]}"';
+// 명령에 든 Windows 프로그램 이름(경로 마지막 조각)을 모두 찾는다.
+const WINDOWS_PROGRAM = /[\w.-]*\.exe(?=["'\s;&|)<>]|$)|(?<=^|[\s;&|(/"'=])(?:powershell|pwsh)(?=["'\s;&|)<>]|$)/gim;
+
+/**
+ * bash 따옴표·이스케이프를 따라가며 따옴표 밖의 백그라운드 `&`가 있는지 본다(`&&`·`&>`·`>&`·`<&`·`|&` 제외).
+ * 백그라운드 자식이 출력 파이프를 붙잡으면 감싼 호출이 끝나지 않으므로 그런 명령은 감싸지 않는다.
+ * 따옴표 안의 `&`(PowerShell 호출 연산자 등)와 `\&`는 bash 연산자가 아니다.
+ */
+function hasBackgroundAmpersand(command: string): boolean {
+  let quote: string | undefined;
+  for (let index = 0; index < command.length; index++) {
+    const char = command[index];
+    if (quote === "'") {
+      if (char === "'") quote = undefined;
+      continue;
+    }
+    if (char === "\\") {
+      index++;
+      continue;
+    }
+    if (quote === '"') {
+      if (char === '"') quote = undefined;
+      continue;
+    }
+    if (char === "'" || char === '"') {
+      quote = char;
+      continue;
+    }
+    if (char !== "&") continue;
+    const previous = command[index - 1] ?? "";
+    const next = command[index + 1] ?? "";
+    if (next === "&") {
+      index++;
+      continue;
+    }
+    if (next === ">" || previous === ">" || previous === "<" || previous === "|") continue;
+    return true;
+  }
+  return false;
+}
+
+export interface WindowsOutputContext {
+  /** WSL에서 Windows 실행 파일을 부를 수 있을 때만 감싼다. */
+  wsl: boolean;
+  /** 대화형 pty 실행은 감싸지 않는다. */
+  pty?: boolean;
+}
+
+/**
+ * Windows 실행 파일을 부르는 bash 명령을, 출력을 UTF-8로 바꿔 내는 명령으로 감싼다. 감쌀 필요가 없거나
+ * 감싸면 동작이 달라질 수 있는 명령은 `undefined`를 돌려준다.
+ *
+ * 감싼 명령은 지속 셸이 아니라 새 bash에서 돌므로, 그 안의 `cd`·변수 대입은 다음 호출로 이어지지 않는다
+ * (export된 환경과 작업 폴더는 물려받는다).
+ */
+export function windowsOutputCommand(command: string, context: WindowsOutputContext): string | undefined {
+  if (!context.wsl || context.pty) return undefined;
+  if (/\biconv\b/.test(command) || hasBackgroundAmpersand(command)) return undefined;
+  // `git.exe`는 UTF-8로 내고 /mnt 저장소에서 가장 자주 부르므로, Windows 프로그램이 그것뿐이면 감싸지 않는다.
+  const programs = [...command.matchAll(WINDOWS_PROGRAM)].map((match) => match[0].toLowerCase());
+  if (programs.every((program) => program === "git.exe")) return undefined;
+  const encodedCommand = Buffer.from(command, "utf8").toString("base64");
+  const encodedDecoder = Buffer.from(DECODER, "utf8").toString("base64");
+  return `bash -c '${RUNNER}' cuelo-windows-output '${encodedCommand}' '${encodedDecoder}'`;
+}
+
+export function interopHint(command: string, output: string, context: InteropHintContext = {}): string | undefined {
+  const hints: string[] = [];
+  if (WINDOWS_EXECUTABLE.test(command) && !/\biconv\b/.test(command) && MOJIBAKE.test(output)) {
+    hints.push(
+      "[WSL interop] Windows 프로그램 출력의 한글이 CP949라 깨졌다(�). 자동 UTF-8 변환은 `&` 백그라운드·pty·`iconv`가 든 명령을 감싸지 않는다. 이 결과는 복구할 수 없으니 `| iconv -f cp949 -t utf-8`을 붙여 다시 실행한다. `wsl.exe`는 `WSL_UTF8=1 WSLENV=WSL_UTF8`을 쓴다.",
+    );
+  }
+  const missing = MISSING_PYTHON_MODULE.exec(output);
+  if (missing && context.managedPython && PYTHON_COMMAND.test(command) && !command.includes("python-env/bin/python")) {
+    hints.push(
+      `[WSL interop] 시스템 python3에는 '${missing[1]}'이 없다. 관리 Python 환경 \`${context.managedPython}\`(eval도 이 환경을 쓴다)으로 다시 실행하고, 그래도 없으면 그 환경에 \`-m pip install\`로 넣는다.`,
+    );
+  }
+  return hints.length > 0 ? hints.join("\n") : undefined;
+}

package/Tools/OMP_Global_Config/agent/extensions/lib/cross-review.ts

@@ -40,6 +40,8 @@ export const SLOT: Record<Family, string> = { openai: "crossReviewOpenAI", anthr
 export const DELETED_BLOB = "deleted";
 /** 원장에 남기는 reviewer 원문 발췌 길이. 전문은 사본 디렉터리의 raw-<계열>.txt에 둔다. */
 const RAW_EXCERPT_CHARS = 20_000;
+/** 도구 결과로 Main에 돌려주는 발췌 길이. 더 필요하면 rawFile을 읽는다(긴 답을 매번 컨텍스트에 싣지 않는다). */
+const RESULT_EXCERPT_CHARS = 2_000;
 
 // ── 계열 매핑 ────────────────────────────────────────────────────────────────
 
@@ -567,7 +569,7 @@ export interface ReviewDeps {
 export interface ReviewResult {
   reviewId: string;
   round: 1 | 2;
-  reviewers: { family: Family; model: string; status: CrossReviewReviewer["status"]; elapsedSec: number; raw?: string; rawFile?: string; error?: string }[];
+  reviewers: { family: Family; model: string; status: CrossReviewReviewer["status"]; elapsedSec: number; raw?: string; rawChars?: number; rawFile?: string; error?: string }[];
   triggers: string[];
   highRisk: boolean;
   findings: CrossReviewFinding[];
@@ -757,12 +759,12 @@ export async function runReview(input: ReviewInput, deps: ReviewDeps, signal: Ab
 
   const reviewers: CrossReviewReviewer[] = [];
   const findings: CrossReviewFinding[] = [];
-  const fullRaw: Partial<Record<Family, string>> = {};
+  const rawChars: Partial<Record<Family, number>> = {};
   const keepRaw = (item: { family: Family; text: string }): { raw: string; rawFile: string } => {
-    // 답 전문은 사본 디렉터리의 파일로 남기고(원장에는 앞 20 KB 발췌와 그 경로만), 결과로는 전부 돌려준다.
+    // 답 전문은 사본 디렉터리의 파일로 남긴다. 원장에는 앞 20 KB 발췌, 결과에는 앞 2,000자와 전체 길이·경로만 준다.
     const rawFile = join(snapshotDir, `raw-${item.family}.txt`);
     writeFileSync(rawFile, item.text, { mode: 0o600 });
-    fullRaw[item.family] = item.text;
+    rawChars[item.family] = item.text.length;
     return { raw: item.text.slice(0, RAW_EXCERPT_CHARS), rawFile };
   };
   for (const item of settled) {
@@ -782,7 +784,11 @@ export async function runReview(input: ReviewInput, deps: ReviewDeps, signal: Ab
   };
   if (!deps.append(record)) throw new Error(`The review ran but could not be recorded in the routing ledger (${reviewId}); it cannot be resolved. Re-run it.`);
   return {
-    reviewId, round, reviewers: reviewers.map((reviewer) => ({ family: reviewer.family, model: reviewer.model, status: reviewer.status, elapsedSec: Math.round(reviewer.elapsedMs / 1000), ...(fullRaw[reviewer.family] ? { raw: fullRaw[reviewer.family], rawFile: reviewer.rawFile } : {}), ...(reviewer.error ? { error: reviewer.error } : {}) })),
+    reviewId, round, reviewers: reviewers.map((reviewer) => ({
+      family: reviewer.family, model: reviewer.model, status: reviewer.status, elapsedSec: Math.round(reviewer.elapsedMs / 1000),
+      ...(reviewer.raw !== undefined ? { raw: reviewer.raw.slice(0, RESULT_EXCERPT_CHARS), rawChars: rawChars[reviewer.family], rawFile: reviewer.rawFile } : {}),
+      ...(reviewer.error ? { error: reviewer.error } : {}),
+    })),
     triggers: record.triggers, highRisk: record.highRisk, findings, skipped, redacted, passable, snapshotDir, nextStep: describeNext(round, passable, findings.length),
   };
 }