cuelo 0.10.21 → 0.10.22

package/.next/trace-build

@@ -1 +1 @@
-[{"name":"run-webpack","duration":93821325,"timestamp":575170,"id":14,"parentId":1,"tags":{},"startTime":1792195703745,"traceId":"b1cf54e2dd52d389"},{"name":"run-typescript","duration":16362368,"timestamp":94770493,"id":11087,"parentId":1,"tags":{},"startTime":1792195797939,"traceId":"b1cf54e2dd52d389"},{"name":"static-check","duration":3743210,"timestamp":111221009,"id":11090,"parentId":1,"tags":{},"startTime":1792195814389,"traceId":"b1cf54e2dd52d389"},{"name":"static-generation","duration":10044206,"timestamp":115058105,"id":11262,"parentId":1,"tags":{},"startTime":1792195818226,"traceId":"b1cf54e2dd52d389"},{"name":"collect-build-traces","duration":16970438,"timestamp":115031605,"id":11259,"parentId":1,"tags":{},"startTime":1792195818200,"traceId":"b1cf54e2dd52d389"},{"name":"telemetry-flush","duration":59,"timestamp":132005996,"id":11271,"parentId":1,"tags":{},"startTime":1792195835174,"traceId":"b1cf54e2dd52d389"},{"name":"next-build","duration":131534973,"timestamp":471099,"id":1,"tags":{"buildMode":"default","version":"16.2.12","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1792195703641,"traceId":"b1cf54e2dd52d389"}]
+[{"name":"run-webpack","duration":117755282,"timestamp":674678,"id":14,"parentId":1,"tags":{},"startTime":1792201420670,"traceId":"8dce0c281bb3683b"},{"name":"run-typescript","duration":21030544,"timestamp":118832470,"id":11087,"parentId":1,"tags":{},"startTime":1792201538828,"traceId":"8dce0c281bb3683b"},{"name":"static-check","duration":4358731,"timestamp":139978787,"id":11090,"parentId":1,"tags":{},"startTime":1792201559975,"traceId":"8dce0c281bb3683b"},{"name":"static-generation","duration":13952586,"timestamp":144451205,"id":11262,"parentId":1,"tags":{},"startTime":1792201564447,"traceId":"8dce0c281bb3683b"},{"name":"collect-build-traces","duration":24903119,"timestamp":144411264,"id":11259,"parentId":1,"tags":{},"startTime":1792201564407,"traceId":"8dce0c281bb3683b"},{"name":"telemetry-flush","duration":95,"timestamp":169321566,"id":11271,"parentId":1,"tags":{},"startTime":1792201589318,"traceId":"8dce0c281bb3683b"},{"name":"next-build","duration":168751116,"timestamp":570574,"id":1,"tags":{"buildMode":"default","version":"16.2.12","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1792201420566,"traceId":"8dce0c281bb3683b"}]

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.21',
+    version: '0.10.22',
     distribution: 'cuelo',
     coreVersion: '18.11.3',
 };

package/Tools/OMP_Global_Config/agent/extensions/docmap-route.ts

@@ -1,34 +1,132 @@
-import type { ExtensionAPI } from "@oh-my-pi/pi-coding-agent";
-import { routeDocmap } from "./lib/docmap-search";
+import type { ExtensionAPI, ExtensionContext } from "@oh-my-pi/pi-coding-agent";
+import { type DocmapCandidate, type DocmapRoute, routeDocmap } from "./lib/docmap-search";
+import { type CoreJudgmentModules, defaultLoadCore, JUDGE_STOPPED, type NativeJudge, resolveNativeJudge, stoppedBy } from "./lib/native-judge";
 
 // 2026-10-16 재조사(doc/history/2026/10/16-rag-reinvestigation): 격리 표본 12건에서 문서 지도를 연 경우가 0건이었다.
 // 도구나 규칙만 두면 같은 문제가 되풀이되므로, 사용자 요청마다 하네스가 지도·RECORD 헤더 검색을 직접 돌려
 // 후보 기록과 맞는 구간을 그 prompt의 숨은 메시지로 넘긴다. 하한 미만·지도 없음·오류면 아무것도 붙이지 않는다.
 // 안내는 external-advice-check와 같은 이유로 aside가 아니라 그 prompt의 `before_agent_start` 메시지로만 붙인다.
-export default function docmapRoute(pi: ExtensionAPI): void {
-  let pendingText: string | undefined;
-  pi.on("session_start", () => { pendingText = undefined; });
-  pi.on("session_shutdown", () => { pendingText = undefined; });
-  pi.on("input", (event) => {
-    pendingText = undefined;
-    if (event.source !== "interactive" && event.source !== "rpc") return;
-    const text = event.text.trim();
-    if (text) pendingText = text;
+//
+// 2026-10-17 사용자 결정(doc/history/2026/10/17-docmap-judge): 낱말로 고른 후보의 절반은 주제만 겹치는 지시였다
+// (실제 프롬프트 표본 60건 중 맞는 첨부 29·엉뚱한 첨부 31). 낱말·길이·의도 표지로는 둘이 갈리지 않아, 붙이기 전에
+// native JEV에 후보마다 「요청이 가리키는 그 과거 작업의 기록인가」를 한 요청으로 묻고 P>=0.6인 후보만 붙인다(사용자 선택).
+// 같은 표본에서 맞는 첨부 19/29를 지키고 엉뚱한 첨부는 5/31만 남았다(0.5면 23/29·10/31). 판정 실패·제한 시간·native 판정기 없음은
+// 낱말 후보를 그대로 붙이고(재현율 보존), 실행 중 steering·queued 재요청은 판정하지 않는다(스티어링 지연 방지).
+
+export interface DocmapRouteDeps {
+  /** 결정적 판정기 seam(테스트). 없으면 {@link loadCore}의 native JEV를 쓴다. */
+  resolveJudge?: (ctx: ExtensionContext) => Promise<NativeJudge | undefined>;
+  loadCore?: () => Promise<CoreJudgmentModules>;
+  /** 판정 대기 상한. 테스트만 짧게 준다. 기본은 DOCMAP_JUDGE_TIMEOUT_MS다. */
+  judgeTimeoutMs?: number;
+  /** 날짜 의도 판정의 기준 시각(테스트). */
+  now?: () => Date;
+}
+
+/** 판정 대기 상한. 넘으면 낱말 후보를 그대로 붙인다. */
+export const DOCMAP_JUDGE_TIMEOUT_MS = 1_500;
+/** 후보를 남기는 P(관련) 하한. */
+export const DOCMAP_JUDGE_KEEP = 0.6;
+const PROMPT_HEAD_CHARS = 1000;
+const PROMPT_TAIL_CHARS = 1000;
+const CUSTOM_TYPE = "docmap-route";
+
+function judgePrompt(prompt: string): string {
+  return prompt.length <= PROMPT_HEAD_CHARS + PROMPT_TAIL_CHARS ? prompt : `${prompt.slice(0, PROMPT_HEAD_CHARS)}\n…\n${prompt.slice(-PROMPT_TAIL_CHARS)}`;
+}
+
+/** 후보마다 bool 질문 하나. 같은 state를 보므로 한 요청에 묶는다. */
+export function buildDocmapJudgeRequest(prompt: string, route: DocmapRoute): { state: unknown; questions: Record<string, unknown> } {
+  const questions: Record<string, unknown> = {};
+  route.judgeCandidates.forEach((_, i) => {
+    questions[`c${i + 1}`] = {
+      type: "bool",
+      instructions: `Is candidates[${i}] a record of the earlier work the prompt refers to (the same event, decision, procedure or state), not merely sharing words with it? The prompt is one message a user sent to a coding agent mid-conversation; a new instruction, a reaction or small talk that only shares vocabulary is "no".`,
+      criteria: { true: "the prompt asks about or continues the work this record covers", false: "new instruction, reaction, small talk, or only topical word overlap" },
+    };
   });
-  pi.on("before_agent_start", (event, ctx) => {
-    // 대화형·RPC는 사용자 입력과 같은 본문의 prompt에만 붙인다. CUELO의 재개·업데이트 통지와 goal 계속 같은
-    // 내부 prompt는 `input`을 내지 않아(lib/rpc-manager.ts isGenuineUserRequest) 여기서 빠진다.
-    // `omp -p`는 input 이벤트가 없어 최상위 세션의 CLI prompt 자체를 사용자 요청으로 본다. CUELO도 확장을
-    // mode 없이 초기화해 ctx.mode가 "print"이므로, UI 문맥이 없다는 것까지 봐야 CLI로 가를 수 있다.
-    const fromInput = pendingText !== undefined && event.prompt.includes(pendingText);
-    const cliPrompt = (ctx.mode === "print" || ctx.mode === "json") && !ctx.hasUI && ctx.agent?.kind === "main";
-    if (!fromInput && !cliPrompt) return;
-    try {
-      const route = routeDocmap(ctx.cwd, fromInput ? pendingText! : event.prompt);
+  return { state: { prompt: judgePrompt(prompt), candidates: route.judgeCandidates }, questions };
+}
+
+/** 판정 답에서 남길 후보. 답이 없는 후보는 버린다. */
+export function keptByJudge(route: DocmapRoute, answers: Record<string, { bool?: number } | undefined>): DocmapCandidate[] {
+  return route.candidates.filter((_, i) => (answers[`c${i + 1}`]?.bool ?? 0) >= DOCMAP_JUDGE_KEEP);
+}
+
+export function createDocmapRoute(deps: DocmapRouteDeps = {}) {
+  const loadCore = deps.loadCore ?? defaultLoadCore;
+  const resolveJudge = deps.resolveJudge ?? ((ctx: ExtensionContext) => resolveNativeJudge(ctx, loadCore, "docmap_route"));
+  const judgeTimeoutMs = deps.judgeTimeoutMs ?? DOCMAP_JUDGE_TIMEOUT_MS;
+
+  return function docmapRoute(pi: ExtensionAPI): void {
+    let pendingText: string | undefined;
+    let judgePromise: Promise<NativeJudge | undefined> | undefined;
+    /** agent_start~agent_end 사이. 실행 중 steering·queued 재요청은 판정 없이 붙인다(mcp-selection과 같은 추적). */
+    let inRun = false;
+    const judgeFor = (ctx: ExtensionContext) => (judgePromise ??= resolveJudge(ctx).catch(() => undefined));
+
+    pi.on("session_start", () => {
+      pendingText = undefined;
+      judgePromise = undefined;
+      inRun = false;
+    });
+    pi.on("session_shutdown", () => { pendingText = undefined; });
+    pi.on("agent_start", () => { inRun = true; });
+    pi.on("agent_end", () => { inRun = false; });
+    pi.on("input", (event) => {
+      pendingText = undefined;
+      if (event.source !== "interactive" && event.source !== "rpc") return;
+      const text = event.text.trim();
+      if (text) pendingText = text;
+    });
+
+    /** 판정으로 거른 안내문. 판정 실패·제한 시간이면 낱말 후보 그대로. */
+    const filtered = async (route: DocmapRoute, prompt: string, ctx: ExtensionContext): Promise<string> => {
+      const controller = new AbortController();
+      const stopped = stoppedBy(controller.signal);
+      let timedOut = false;
+      const timer = setTimeout(() => {
+        timedOut = true;
+        controller.abort();
+      }, judgeTimeoutMs);
+      try {
+        const judge = await Promise.race([judgeFor(ctx), stopped]);
+        if (judge === JUDGE_STOPPED) throw new Error("판정 취소");
+        if (!judge) throw new Error("native JEV 판정기 없음");
+        const result = await Promise.race([judge.judge(buildDocmapJudgeRequest(prompt, route), { signal: controller.signal }), stopped]);
+        if (result === JUDGE_STOPPED) throw new Error("판정 취소");
+        return route.render(keptByJudge(route, result.answers));
+      } catch (error) {
+        pi.logger.debug("docmap-route: JEV 후보 판정 없이 낱말 후보를 붙임", {
+          error: timedOut ? "판정이 제한 시간 안에 끝나지 않음" : error instanceof Error ? error.message : String(error),
+        });
+        return route.text;
+      } finally {
+        clearTimeout(timer);
+      }
+    };
+
+    pi.on("before_agent_start", async (event, ctx) => {
+      // 대화형·RPC는 사용자 입력과 같은 본문의 prompt에만 붙인다. CUELO의 재개·업데이트 통지와 goal 계속 같은
+      // 내부 prompt는 `input`을 내지 않아(lib/rpc-manager.ts isGenuineUserRequest) 여기서 빠진다.
+      // `omp -p`는 input 이벤트가 없어 최상위 세션의 CLI prompt 자체를 사용자 요청으로 본다. CUELO도 확장을
+      // mode 없이 초기화해 ctx.mode가 "print"이므로, UI 문맥이 없다는 것까지 봐야 CLI로 가를 수 있다.
+      const fromInput = pendingText !== undefined && event.prompt.includes(pendingText);
+      const cliPrompt = (ctx.mode === "print" || ctx.mode === "json") && !ctx.hasUI && ctx.agent?.kind === "main";
+      if (!fromInput && !cliPrompt) return;
+      const prompt = fromInput ? pendingText! : event.prompt;
+      let route: DocmapRoute | undefined;
+      try {
+        route = routeDocmap(ctx.cwd, prompt, deps.now?.());
+      } catch {
+        return;
+      }
       if (!route) return;
-      return { message: { customType: "docmap-route", content: route.text, display: false, attribution: "agent" } };
-    } catch {
-      return;
-    }
-  });
+      const content = inRun ? route.text : await filtered(route, prompt, ctx);
+      if (!content) return;
+      return { message: { customType: CUSTOM_TYPE, content, display: false, attribution: "agent" } };
+    });
+  };
 }
+
+export default createDocmapRoute();

package/Tools/OMP_Global_Config/agent/extensions/lib/docmap-search.ts

@@ -100,11 +100,24 @@ export interface DocmapSection {
   readonly excerpt: string;
 }
 
+/** 후보 하나를 판정기에 보여 주는 모양. 경로·지도 줄·SCOPE·DATE·가장 맞는 절의 발췌만 싣는다. */
+export interface DocmapJudgeCandidate {
+  readonly path: string;
+  readonly map?: string;
+  readonly scope?: string;
+  readonly date?: string;
+  readonly excerpt?: string;
+}
+
 export interface DocmapRoute {
   readonly topScore: number;
   readonly signals: DocmapSignals;
   readonly candidates: readonly DocmapCandidate[];
   readonly text: string;
+  /** 판정기에 넘길 후보 요약. `candidates`와 같은 순서다. */
+  readonly judgeCandidates: readonly DocmapJudgeCandidate[];
+  /** 후보 일부만 남겼을 때의 안내문. 빈 배열이면 빈 문자열. */
+  render(kept: readonly DocmapCandidate[]): string;
 }
 
 /** 소문자 ASCII 낱말(2자 이상)과 한글 연속 구간의 2글자 조각. */
@@ -529,12 +542,17 @@ function clip(text: string, max: number): string {
   return one.length > max ? `${one.slice(0, max - 1)}…` : one;
 }
 
+/** 지도 줄에서 링크 대상·머리 기호·표 구분을 빼고 한 줄로 줄인다. */
+function mapLineText(line: string): string {
+  return clip(line.replace(/\]\([^)]*\)/g, "]").replace(/^[-*]\s*/, "").replace(/\s*\|\s*/g, " "), 200);
+}
+
 export function renderDocmapRoute(corpus: DocmapCorpus, candidates: readonly DocmapCandidate[], sections: ReadonlyMap<string, DocmapSection>, maxChars = DOCMAP_MAX_CHARS): string {
   const blocks = candidates.map((c, i) => {
     const u = c.unit;
     const lines = [`${i + 1}. ${rel(corpus.root, u.file)}${u.fields.STATUS ? ` (STATUS: ${clip(u.fields.STATUS, 60)})` : ""}`];
     if (c.supersededFrom) lines.push(`   대체 전: ${rel(corpus.root, c.supersededFrom)}`);
-    if (u.mapLines[0]) lines.push(`   지도: ${clip(u.mapLines[0].replace(/\]\([^)]*\)/g, "]").replace(/^[-*]\s*/, "").replace(/\s*\|\s*/g, " "), 200)}`);
+    if (u.mapLines[0]) lines.push(`   지도: ${mapLineText(u.mapLines[0])}`);
     else if (u.title) lines.push(`   제목: ${clip(u.title, 160)}`);
     if (u.fields.SCOPE) lines.push(`   SCOPE: ${clip(u.fields.SCOPE, 160)}`);
     const sec = sections.get(u.file);
@@ -572,5 +590,23 @@ export function routeDocmap(cwd: string, prompt: string, now = new Date()): Docm
   if (!docmapPasses(signals)) return undefined;
   const candidates = pickDocmapCandidates(corpus, ranked, DOCMAP_MAX_CANDIDATES, DOCMAP_CANDIDATE_RATIO, docmapDateIntent(prompt, now));
   const sections = bestDocmapSections(candidates.map((c) => c.unit.file), prompt);
-  return { topScore: top.score, signals, candidates, text: renderDocmapRoute(corpus, candidates, sections) };
+  const judgeCandidates = candidates.map((c) => {
+    const u = c.unit;
+    const sec = sections.get(u.file);
+    return {
+      path: rel(corpus.root, u.file),
+      ...(u.mapLines[0] ? { map: mapLineText(u.mapLines[0]) } : u.title ? { map: clip(u.title, 160) } : {}),
+      ...(u.fields.SCOPE ? { scope: clip(u.fields.SCOPE, 160) } : {}),
+      ...(u.fields.DATE ? { date: u.fields.DATE } : {}),
+      ...(sec ? { excerpt: `${clip(sec.heading, 60)}${sec.excerpt ? ` — ${sec.excerpt}` : ""}` } : {}),
+    };
+  });
+  return {
+    topScore: top.score,
+    signals,
+    candidates,
+    text: renderDocmapRoute(corpus, candidates, sections),
+    judgeCandidates,
+    render: (kept) => (kept.length === 0 ? "" : renderDocmapRoute(corpus, kept, sections)),
+  };
 }

package/Tools/OMP_Global_Config/agent/extensions/lib/native-judge.ts

@@ -0,0 +1,82 @@
+import type { ExtensionContext } from "@oh-my-pi/pi-coding-agent";
+
+/**
+ * core의 native JEV를 확장에서 쓰는 공통 틀. mcp-selection과 docmap-route가 같이 쓴다.
+ * judge 역할의 첫 후보가 native가 아니면 판정하지 않고, 세션 모델 fallback을 붙이지 않으며(sessionModel 미전달),
+ * 체인이 native가 아닌 후보를 내면 그 후보에서는 실행하지 않는다.
+ */
+
+export interface JudgeAnswers {
+  answers: Record<string, { type: string; choice?: string; bool?: number } | undefined>;
+}
+
+/** 판정기 seam. 기본 구현은 native 후보에서만 판정을 실행한다. */
+export interface NativeJudge {
+  judge(request: { state: unknown; questions: Record<string, unknown> }, options?: { signal?: AbortSignal }): Promise<JudgeAnswers>;
+}
+
+export type JudgeKind = "native" | "local" | "online";
+
+interface ChainJudgeLike {
+  withCandidate<T>(run: (judge: NativeJudge, kind: JudgeKind) => Promise<T>, options?: { signal?: AbortSignal }): Promise<T>;
+}
+
+/** 기존 core 판정 모듈. 런타임 값은 host가 해석하고 타입은 여기 필요한 만큼만 둔다. */
+export interface CoreJudgmentModules {
+  judgment: {
+    resolveJudge(deps: {
+      settings: unknown;
+      registry: unknown;
+      sessionId?: string;
+      purpose: string;
+      onUsage?: unknown;
+    }): ChainJudgeLike;
+    hasNativeJudge(settings: unknown, registry: unknown): boolean;
+    journalJudgmentUsage?(manager: unknown): unknown;
+  };
+  settings: { findScopedSettings(cwd?: string): unknown };
+}
+
+export async function defaultLoadCore(): Promise<CoreJudgmentModules> {
+  // 지연 import: 테스트 미러에는 node_modules가 없고, 런타임은 host 번들로 해석한다(jev-runtime과 같다).
+  const [judgment, settings] = await Promise.all([
+    import("@oh-my-pi/pi-coding-agent/judgment"),
+    import("@oh-my-pi/pi-coding-agent/config/settings"),
+  ]);
+  return { judgment, settings } as unknown as CoreJudgmentModules;
+}
+
+export async function resolveNativeJudge(ctx: ExtensionContext, loadCore: () => Promise<CoreJudgmentModules>, purpose: string): Promise<NativeJudge> {
+  const { judgment, settings: settingsModule } = await loadCore();
+  const settings = settingsModule.findScopedSettings(ctx.cwd);
+  if (!settings) throw new Error("세션 설정을 찾지 못함");
+  if (!judgment.hasNativeJudge(settings, ctx.modelRegistry)) throw new Error("judge 역할 첫 후보가 native JEV가 아님");
+  const chain = judgment.resolveJudge({
+    settings,
+    registry: ctx.modelRegistry,
+    sessionId: ctx.sessionManager?.getSessionId?.(),
+    purpose,
+    onUsage: judgment.journalJudgmentUsage?.(ctx.sessionManager),
+  });
+  return {
+    judge: (request, options) =>
+      chain.withCandidate(
+        (candidate, kind) =>
+          kind === "native" ? candidate.judge(request, options) : Promise.reject(new Error(`native가 아닌 judge 후보(${kind})`)),
+        options,
+      ),
+  };
+}
+
+/** 취소·제한 시간이 판정보다 먼저 끝났음을 나타내는 race 표지. */
+export const JUDGE_STOPPED: unique symbol = Symbol("judge-stopped");
+
+/**
+ * `signal`이 끊기면 바로 돌아오는 promise. provider가 signal을 무시해도 호출부가 `Promise.race`로 제때 빠져나온다.
+ */
+export function stoppedBy(signal: AbortSignal): Promise<typeof JUDGE_STOPPED> {
+  const stopped = Promise.withResolvers<typeof JUDGE_STOPPED>();
+  if (signal.aborted) stopped.resolve(JUDGE_STOPPED);
+  else signal.addEventListener("abort", () => stopped.resolve(JUDGE_STOPPED), { once: true });
+  return stopped.promise;
+}

package/Tools/OMP_Global_Config/agent/extensions/mcp-selection.ts

@@ -16,6 +16,9 @@ import {
   summarizeProjectStack,
   VERIFIED_CATALOG,
 } from "./lib/mcp-selection";
+import { type CoreJudgmentModules, defaultLoadCore, JUDGE_STOPPED, type NativeJudge, resolveNativeJudge, stoppedBy } from "./lib/native-judge";
+
+export type { CoreJudgmentModules, NativeJudge } from "./lib/native-judge";
 
 /**
  * 요청별 MCP 선택(`mcp.selection: per-request`). 패치된 core가 매 사용자 요청의 system prompt를 만들기
@@ -26,37 +29,6 @@ import {
  * `mcp_select`를 모르는 core(standalone omp 등)에서는 핸들러가 호출되지 않아 아무 일도 하지 않는다.
  */
 
-interface JudgeAnswers {
-  answers: Record<string, { type: string; choice?: string } | undefined>;
-}
-
-/** 판정기 seam. 기본 구현은 native 후보에서만 판정을 실행한다. */
-export interface NativeJudge {
-  judge(request: { state: unknown; questions: Record<string, unknown> }, options?: { signal?: AbortSignal }): Promise<JudgeAnswers>;
-}
-
-type JudgeKind = "native" | "local" | "online";
-
-interface ChainJudgeLike {
-  withCandidate<T>(run: (judge: NativeJudge, kind: JudgeKind) => Promise<T>, options?: { signal?: AbortSignal }): Promise<T>;
-}
-
-/** 기존 core 판정 모듈. 런타임 값은 host가 해석하고 타입은 여기 필요한 만큼만 둔다. */
-export interface CoreJudgmentModules {
-  judgment: {
-    resolveJudge(deps: {
-      settings: unknown;
-      registry: unknown;
-      sessionId?: string;
-      purpose: string;
-      onUsage?: unknown;
-    }): ChainJudgeLike;
-    hasNativeJudge(settings: unknown, registry: unknown): boolean;
-    journalJudgmentUsage?(manager: unknown): unknown;
-  };
-  settings: { findScopedSettings(cwd?: string): unknown };
-}
-
 export interface McpSelectionDeps {
   /** 결정적 판정기 seam(테스트). 없으면 {@link loadCore}의 native JEV를 쓴다. */
   resolveJudge?: (ctx: ExtensionContext) => Promise<NativeJudge | undefined>;
@@ -89,8 +61,6 @@ const STACK_DIR_LIMIT = 40;
 /** 새 요청의 판정 대기 상한. 넘으면 판정을 취소하고 판정 실패와 같게 새 연결 없이 진행한다(runner 30초 제한에 기대지 않는다). */
 const MCP_SELECTION_TIMEOUT_MS = 3_000;
 const JUDGE_TIMEOUT_REASON = "판정이 제한 시간 안에 끝나지 않음";
-/** 취소·제한 시간이 판정보다 먼저 끝났음을 나타내는 race 표지. */
-const STOPPED: unique symbol = Symbol("mcp-selection-stopped");
 
 async function readJson(path: string): Promise<Record<string, unknown> | undefined> {
   try {
@@ -167,46 +137,11 @@ async function readProjectStack(cwd: string): Promise<string> {
   return summarizeProjectStack({ fileNames, dependencyNames });
 }
 
-async function defaultLoadCore(): Promise<CoreJudgmentModules> {
-  // 지연 import: 테스트 미러에는 node_modules가 없고, 런타임은 host 번들로 해석한다(jev-runtime과 같다).
-  const [judgment, settings] = await Promise.all([
-    import("@oh-my-pi/pi-coding-agent/judgment"),
-    import("@oh-my-pi/pi-coding-agent/config/settings"),
-  ]);
-  return { judgment, settings } as unknown as CoreJudgmentModules;
-}
-
-/**
- * 기존 native JEV만 쓴다. judge 역할의 첫 후보가 native가 아니면 판정하지 않고, 세션 모델 fallback을
- * 붙이지 않으며(sessionModel 미전달), 체인이 native가 아닌 후보를 내면 그 후보에서는 실행하지 않는다.
- */
-async function resolveNativeJudge(ctx: ExtensionContext, loadCore: () => Promise<CoreJudgmentModules>): Promise<NativeJudge> {
-  const { judgment, settings: settingsModule } = await loadCore();
-  const settings = settingsModule.findScopedSettings(ctx.cwd);
-  if (!settings) throw new Error("세션 설정을 찾지 못함");
-  if (!judgment.hasNativeJudge(settings, ctx.modelRegistry)) throw new Error("judge 역할 첫 후보가 native JEV가 아님");
-  const chain = judgment.resolveJudge({
-    settings,
-    registry: ctx.modelRegistry,
-    sessionId: ctx.sessionManager?.getSessionId?.(),
-    purpose: "mcp_selection",
-    onUsage: judgment.journalJudgmentUsage?.(ctx.sessionManager),
-  });
-  return {
-    judge: (request, options) =>
-      chain.withCandidate(
-        (candidate, kind) =>
-          kind === "native" ? candidate.judge(request, options) : Promise.reject(new Error(`native가 아닌 judge 후보(${kind})`)),
-        options,
-      ),
-  };
-}
-
 export function createMcpSelection(deps: McpSelectionDeps = {}) {
   const agentDir = deps.agentDir ?? join(import.meta.dir, "..");
   const catalog = deps.catalog ?? VERIFIED_CATALOG;
   const loadCore = deps.loadCore ?? defaultLoadCore;
-  const resolveJudge = deps.resolveJudge ?? ((ctx: ExtensionContext) => resolveNativeJudge(ctx, loadCore));
+  const resolveJudge = deps.resolveJudge ?? ((ctx: ExtensionContext) => resolveNativeJudge(ctx, loadCore, "mcp_selection"));
   const judgeTimeoutMs = deps.judgeTimeoutMs ?? MCP_SELECTION_TIMEOUT_MS;
 
   return function mcpSelection(pi: ExtensionAPI): void {
@@ -280,22 +215,20 @@ export function createMcpSelection(deps: McpSelectionDeps = {}) {
       const answers: Record<string, string | undefined> = {};
       const signal = event.signal ? AbortSignal.any([event.signal, token.controller.signal]) : token.controller.signal;
       // provider가 signal을 무시해도 취소·제한 시간에 바로 돌아온다.
-      const stopped = Promise.withResolvers<typeof STOPPED>();
-      if (signal.aborted) stopped.resolve(STOPPED);
-      else signal.addEventListener("abort", () => stopped.resolve(STOPPED), { once: true });
+      const stopped = stoppedBy(signal);
       let timedOut = false;
       const timer = setTimeout(() => {
         timedOut = true;
         token.controller.abort();
       }, judgeTimeoutMs);
       try {
-        const judge = await Promise.race([judgeFor(ctx), stopped.promise]);
-        if (judge === STOPPED) throw new Error("판정 취소");
+        const judge = await Promise.race([judgeFor(ctx), stopped]);
+        if (judge === JUDGE_STOPPED) throw new Error("판정 취소");
         if (!judge) throw new Error("JEV 판정기를 해석하지 못함");
-        const stack = await Promise.race([projectStack, stopped.promise]);
-        if (stack === STOPPED) throw new Error("판정 취소");
-        const result = await Promise.race([judge.judge(buildJudgeRequest(cue, stack, candidates), { signal }), stopped.promise]);
-        if (result === STOPPED) throw new Error("판정 취소");
+        const stack = await Promise.race([projectStack, stopped]);
+        if (stack === JUDGE_STOPPED) throw new Error("판정 취소");
+        const result = await Promise.race([judge.judge(buildJudgeRequest(cue, stack, candidates), { signal }), stopped]);
+        if (result === JUDGE_STOPPED) throw new Error("판정 취소");
         for (const [key, answer] of Object.entries(result.answers)) {
           answers[key] = answer?.type === "choice" ? answer.choice : undefined;
         }

package/Tools/OMP_Global_Config/agent/rules/docs-handoff.md

@@ -22,7 +22,7 @@ description: HANDOFF·README·doc 지도의 역할, 작업 기록 소유권과
 - 미해결 실패도 같은 규칙으로 다룬다. 관련 작업에서 만난 미해결 실패는 새 절차를 만들지 않고 기존 실패 환류(`verdict.md` 「실패를 다음 작업의 실행 방식으로 환류」)와 `RULES.md`의 동일 재시도 금지를 따른다: 오류 원문 등 증거로 원인을 좁히고, 이전과 다른 조치를 하고, 원래 실패했던 경로를 다시 실행해 닫는다. 가드·검증을 약화하거나 바뀐 것 없이 되풀이하지 않는다. 승인·권한·범위 때문에 막히면 Main이 `HANDOFF.md` 행에 실패 증거, 시도한 조치, 정확한 차단 사유·필요한 승인, 다음 행동, 재검증·종료 기준을 적어 다음 관련 세션이 이어받게 한다. 원인 해결 증거 없이 영구 결함이 고쳐졌다고 단정하지 않는다.
 - 다음 신호를 보면 해당 절을 바로 고친다: ① Maker가 끝낸 범위가 HANDOFF에서 미적용으로 남음 ② 작업 행의 다음 행동·미해결 경계를 설명할 수 없음 ③ 같은 상태를 둘 이상 독립 서술함 ④ 열린 일이 늘지 않는데 HANDOFF만 늘어남. Maker는 종료 보고에 HANDOFF 영향 주제와 남은 행동 유무를 적는다. Main은 관련 절과 참조처만 확인하며 상시 감사·별도 hook·문서 DB를 만들지 않는다.
 - 기록은 역할별이다: `DD-주제/main.md`는 Main 판단·수용·공유 인계, `maker-<name>.md`는 그 Maker의 변경·검증·남은 제한이다. Maker는 자기 기록만 쓰며 Main 단독 작업에는 Maker 기록을 만들지 않는다. 발주 시 Main은 Maker 기록과 `evidence/` 경로를 `OWNED_PATHS`에 넣고, 공유 지도는 Main 또는 지정된 한 owner가 갱신한다. 긴 diff·로그는 작업 폴더 `evidence/`에 두고 상대 링크로 가리킨다. secret·대화 원문·인증 DB는 기록하지 않는다.
-- 검색 순서는 ① `HANDOFF.md` ② `doc/README.md` 지도·월별 목록 ③ 경로·주제 키워드로 `doc/history/**/*.md`의 `RECORD:` 헤더(`SCOPE`·`PATHS`)를 최신순 검색 ④ 일치 기록의 헤더와 필요한 줄 범위만 읽는다. ②③은 하네스가 먼저 돈다: 사용자 요청마다 `docmap-route` 확장이 루트·하위 지도 줄과 기록 제목·헤더만으로 요청 중에 BM25를 만들어(긴 요청은 앞·끝 1,000자), 기록 수로 정규화한 점수·흔하지 않은 낱말의 포괄도 기준을 넘을 때만 후보 최대 3개(경로·지도 줄·SCOPE·STATUS·가장 맞는 절의 줄 범위와 발췌)를 `DATE` 최신순 동점 처리로 숨은 메시지로 붙인다. 후보는 근거가 아니라 확인할 곳이다. 답하기 전에 그 구간을 읽어 맞는지 확인하고 맞지 않으면 버린 뒤 ②③을 직접 이어 간다. 후보가 없으면 위 순서를 그대로 따른다. `STATUS: superseded-by <path>`면 새 경로로 이동한다(확장도 따라간다). 목차·헤더로 못 찾았을 때만 헤더 없는 기존 기록의 본문을 제한 검색한다. 기존 기록에 헤더를 일괄 추가하지 않는다. 새 기록은 지도에 한 줄을 달아야 후보에 지도 줄이 실린다. Main은 찾은 locator를 브리프에 넣어 재검색을 막는다. 후보가 넷 이상이고 헤더로 가릴 수 없을 때만 judge를 쓸 수 있으며 상시 색인·judge·Wiki·기억 계층은 두지 않는다(확장의 BM25도 요청마다 만들고 버린다).
+- 검색 순서는 ① `HANDOFF.md` ② `doc/README.md` 지도·월별 목록 ③ 경로·주제 키워드로 `doc/history/**/*.md`의 `RECORD:` 헤더(`SCOPE`·`PATHS`)를 최신순 검색 ④ 일치 기록의 헤더와 필요한 줄 범위만 읽는다. ②③은 하네스가 먼저 돈다: 사용자 요청마다 `docmap-route` 확장이 루트·하위 지도 줄과 기록 제목·헤더만으로 요청 중에 BM25를 만들어(긴 요청은 앞·끝 1,000자), 기록 수로 정규화한 점수·흔하지 않은 낱말의 포괄도 기준을 넘는 후보 최대 3개를 고른 뒤, native Jev 한 요청으로 후보마다 「요청이 가리키는 그 과거 작업의 기록인가」를 물어 남은 후보만(경로·지도 줄·SCOPE·STATUS·가장 맞는 절의 줄 범위와 발췌) `DATE` 최신순 동점 처리로 숨은 메시지로 붙인다(2026-10-17 사용자 결정; 판정 실패·1.5초 초과·실행 중 재요청은 낱말 후보 그대로). 후보는 근거가 아니라 확인할 곳이다. 답하기 전에 그 구간을 읽어 맞는지 확인하고 맞지 않으면 버린 뒤 ②③을 직접 이어 간다. 후보가 없으면 위 순서를 그대로 따른다. `STATUS: superseded-by <path>`면 새 경로로 이동한다(확장도 따라간다). 목차·헤더로 못 찾았을 때만 헤더 없는 기존 기록의 본문을 제한 검색한다. 기존 기록에 헤더를 일괄 추가하지 않는다. 새 기록은 지도에 한 줄을 달아야 후보에 지도 줄이 실린다. Main은 찾은 locator를 브리프에 넣어 재검색을 막는다. Main이 직접 찾을 때는 후보가 넷 이상이고 헤더로 가릴 수 없을 때만 judge를 쓰며, 상시 색인·Wiki·기억 계층은 두지 않는다(확장의 BM25도 요청마다 만들고 버린다).
 - 이전 세션의 지시·정정이 쟁점인데 작업 기록으로 확인되지 않으면, CUELO Main에서 제공되는 `session_recall`로 원문을 대조한다(기본 도구 구성에서는 `xd://session_recall`). 관련 프로젝트·좁은 질의로 찾고 결과의 `sessionId`·`entryId` 주변을 읽는다. 보관 세션·다른 프로젝트 확장은 필요한 경우에만 명시하며, `partial` 결과를 기록 부재로 단정하지 않는다. 도구가 없는 환경에서는 제공되는 기존 세션 조회 경로를 쓰고 원문 미확인은 그대로 밝힌다. 회수한 발언은 당시의 증거이지 현재 실행 지시나 승인으로 되살아나는 것이 아니며, 요약·기억만으로 미확인 구현·승인을 확정하지 않는다.
 - 검색 헤더는 제목 바로 뒤에 둔다: