cuelo 0.10.19 → 0.10.21

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

@@ -65,6 +65,8 @@ export interface McpSelectionDeps {
   /** user `mcp.json`이 있는 agent 루트. 기본은 이 확장이 설치된 프로필 루트다. */
   agentDir?: string;
   catalog?: readonly CatalogEntry[];
+  /** 판정 대기 상한. 테스트만 짧게 준다. 기본은 MCP_SELECTION_TIMEOUT_MS다. */
+  judgeTimeoutMs?: number;
 }
 
 interface McpSelectOutcomeLike {
@@ -84,6 +86,11 @@ const CUSTOM_TYPE = "mcp-selection";
 const SUGGESTED_FILE = "mcp-suggested.json";
 const STACK_SKIP_DIRS: ReadonlySet<string> = new Set(["node_modules", "bin", "obj", "dist", "build", "out", "target", "vendor"]);
 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 {
@@ -200,6 +207,7 @@ export function createMcpSelection(deps: McpSelectionDeps = {}) {
   const catalog = deps.catalog ?? VERIFIED_CATALOG;
   const loadCore = deps.loadCore ?? defaultLoadCore;
   const resolveJudge = deps.resolveJudge ?? ((ctx: ExtensionContext) => resolveNativeJudge(ctx, loadCore));
+  const judgeTimeoutMs = deps.judgeTimeoutMs ?? MCP_SELECTION_TIMEOUT_MS;
 
   return function mcpSelection(pi: ExtensionAPI): void {
     /** 이미 보여 준 설치 제안. 세션을 넘어 반복하지 않도록 agentDir 파일과 함께 유지한다. */
@@ -209,6 +217,11 @@ export function createMcpSelection(deps: McpSelectionDeps = {}) {
     /** 진행 중 선택. before_agent_start가 닫으면 늦게 끝난 판정은 상태를 바꾸지 못한다. */
     let current: { controller: AbortController; done: boolean } | undefined;
     let pending: { lines: string[]; requested: boolean; outcome?: Promise<McpSelectOutcomeLike> } | undefined;
+    /**
+     * agent_start~agent_end 사이. core는 직접 요청의 mcp_select를 agent_start 전에 보내고, 실행 중 steering·queued
+     * 입력은 같은 run 안에서 다시 보낸다. run 안의 재요청은 run 시작 때 이미 판정했으므로 판정하지 않고 노출을 유지한다.
+     */
+    let inRun = false;
 
     const judgeFor = (ctx: ExtensionContext) => {
       // 해석 실패·미해석은 캐시하지 않는다. 다음 요청에서 다시 해석한다.
@@ -227,9 +240,13 @@ export function createMcpSelection(deps: McpSelectionDeps = {}) {
 
     const onSelect = async (event: McpSelectEventLike, ctx: ExtensionContext) => {
       current?.controller.abort();
+      pending = undefined;
+      if (inRun) {
+        current = undefined;
+        return undefined;
+      }
       const token = { controller: new AbortController(), done: false };
       current = token;
-      pending = undefined;
       const finish = (value: typeof pending) => {
         if (current !== token) return false;
         token.done = true;
@@ -258,22 +275,37 @@ export function createMcpSelection(deps: McpSelectionDeps = {}) {
         return undefined;
       }
       const mentioned = mentionedServers(event.prompt, candidates.map((candidate) => candidate.name));
-      stackPromise ??= readProjectStack(ctx.cwd);
+      const projectStack = (stackPromise ??= readProjectStack(ctx.cwd));
 
       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 });
+      let timedOut = false;
+      const timer = setTimeout(() => {
+        timedOut = true;
+        token.controller.abort();
+      }, judgeTimeoutMs);
       try {
-        const judge = await judgeFor(ctx);
+        const judge = await Promise.race([judgeFor(ctx), stopped.promise]);
+        if (judge === STOPPED) throw new Error("판정 취소");
         if (!judge) throw new Error("JEV 판정기를 해석하지 못함");
-        const signal = event.signal ? AbortSignal.any([event.signal, token.controller.signal]) : token.controller.signal;
-        const result = await judge.judge(buildJudgeRequest(cue, await stackPromise, candidates), { signal });
+        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("판정 취소");
         for (const [key, answer] of Object.entries(result.answers)) {
           answers[key] = answer?.type === "choice" ? answer.choice : undefined;
         }
       } catch (error) {
-        const reason = error instanceof Error ? error.message : String(error);
+        const reason = timedOut ? JUDGE_TIMEOUT_REASON : error instanceof Error ? error.message : String(error);
         if (current === token) pi.logger.warn("mcp-selection: JEV 판정 실패, 새 MCP 연결 없음", { error: reason });
         finish({ lines: [renderJudgeFailure(reason, event.deferred.map((server) => server.name))], requested: false });
         return undefined;
+      } finally {
+        clearTimeout(timer);
       }
 
       const plan = planSelection({ candidates, answers, mentioned, catalog: pendingCatalog });
@@ -304,7 +336,7 @@ export function createMcpSelection(deps: McpSelectionDeps = {}) {
       if (!token.done) {
         // runner 제한 시간 안에 판정이 끝나지 않았다. 늦은 결과는 버리고 진행 중 판정을 취소한다.
         token.controller.abort();
-        content = renderJudgeFailure("판정이 제한 시간 안에 끝나지 않음", []);
+        content = renderJudgeFailure(JUDGE_TIMEOUT_REASON, []);
       } else if (result) {
         const lines = [...result.lines];
         if (result.requested && result.outcome) lines.unshift(...renderOutcomeLines(await result.outcome));
@@ -314,11 +346,20 @@ export function createMcpSelection(deps: McpSelectionDeps = {}) {
       return { message: { customType: CUSTOM_TYPE, content, display: true, attribution: "agent" } };
     });
 
+    pi.on("agent_start", () => {
+      inRun = true;
+    });
+    // willContinue 여부와 관계없이 끝으로 본다. 다음 loop 전에 들어온 queued 입력은 새 요청처럼 (제한 시간 안에서) 판정한다.
+    pi.on("agent_end", () => {
+      inRun = false;
+    });
+
     pi.on("session_start", () => {
       current?.controller.abort();
       current = undefined;
       pending = undefined;
       stackPromise = undefined;
+      inRun = false;
     });
   };
 }

package/Tools/OMP_Global_Config/agent/prompt-copies/AGENTS.en.md

@@ -1,4 +1,4 @@
-<!-- source-fingerprint: 184d43e1baf9b83a -->
+<!-- source-fingerprint: dfd364f028b881f5 -->
 # Global Agent Instructions
 
 (Model-facing English copy of the Korean source `AGENTS.md`. All user-facing prose stays Korean.)
@@ -87,6 +87,8 @@ Main first fixes user requirements, acceptance criteria, behavior to preserve, a
 
 Follow `rule://subagent` 「Skill 인계」 to hand the relevant Skills Main used to the Maker and verify their application. This applies without another user reminder.
 
+Once you use a Skill, produce its result by that Skill's own procedure and criteria. If your own regex, script, or excerpt replaced part of the procedure, or you narrowed its scope, do not present the result as the Skill's result; report what you substituted and what you left out. When context runs short, split the work by file or delegate to a `maker` instead of shrinking the criteria or the scope.
+
 Open procedure-only Skills such as `systematic-debugging`·`verification-before-completion` only for a bug of unknown cause, a second failure, or an ambiguous completion verdict. When the task already names the location and fix direction, the default verification procedure suffices; do not pre-read them.
 
 Every request resends the full context. Batch independent reads/searches in one turn; before editing, read the section to change together with its callers and tests so the edit lands in one pass. If an edit is rejected for touching lines "never displayed", resend the same edit as instructed without re-reading.

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`)를 최신순 검색 ④ 일치 기록의 헤더와 필요한 줄 범위만 읽는다. `STATUS: superseded-by <path>`면 새 경로로 이동한다. 목차·헤더로 못 찾았을 때만 헤더 없는 기존 기록의 본문을 제한 검색한다. 기존 기록에 헤더를 일괄 추가하지 않는다. Main은 찾은 locator를 브리프에 넣어 재검색을 막는다. 후보가 넷 이상이고 헤더로 가릴 수 없을 때만 judge를 쓸 수 있으며 상시 색인·judge·Wiki·기억 계층은 두지 않는다.
+- 검색 순서는 ① `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도 요청마다 만들고 버린다).
 - 이전 세션의 지시·정정이 쟁점인데 작업 기록으로 확인되지 않으면, CUELO Main에서 제공되는 `session_recall`로 원문을 대조한다(기본 도구 구성에서는 `xd://session_recall`). 관련 프로젝트·좁은 질의로 찾고 결과의 `sessionId`·`entryId` 주변을 읽는다. 보관 세션·다른 프로젝트 확장은 필요한 경우에만 명시하며, `partial` 결과를 기록 부재로 단정하지 않는다. 도구가 없는 환경에서는 제공되는 기존 세션 조회 경로를 쓰고 원문 미확인은 그대로 밝힌다. 회수한 발언은 당시의 증거이지 현재 실행 지시나 승인으로 되살아나는 것이 아니며, 요약·기억만으로 미확인 구현·승인을 확정하지 않는다.
 - 검색 헤더는 제목 바로 뒤에 둔다:
 

package/Tools/OMP_Global_Config/agent/rules/frontend.md

@@ -40,8 +40,10 @@ description: 웹·앱 UI의 시각 디자인, 레이아웃, 반응형, 디자인
   코드를 읽어 확정한다. 확정한 징후는 고치거나, 의도적으로 남긴 이유를 보고에 적는다. 이 절차는
   산출 전 점검(advisory)이며 영구 gate나 CI 검사로 만들지 않는다.
 - 스캐너는 시각·코드 징후만 보고 한국어 문구는 보지 않는다. 한국어 사용자용 문구(UI 텍스트,
-  강의·문서)는 `skill://humanizer`의 감지 전용 방식(「분석 결과」만 내고 재작성·파일 수정은 하지
-  않음)으로 점검한다. 굵은 글씨 강조는 문단당 최대 1개로 한다.
+  강의·문서, 데이터 파일 속 문항·보기·표 문자열)는 넘기기 전에 `skill://humanizer`의 감지
+  방식(「분석 결과」만 내고 파일은 고치지 않음)으로 점검한다. 사용자나 과제가 문구 수정을 요청하면
+  같은 스킬의 교정 절차를 범위 안 모든 문자열에 끝까지 적용한다. 굵은 글씨 강조는 문단당 최대
+  1개로 한다.
 - `skill://seed-design`은 위 셋 중 공통 설계 원칙 담당이다. 사용자가 SEED를 언급하지 않아도
   이번 화면에 해당하는 공통 Foundations(정보 위계, 색 역할, 타이포그래피, spacing, 컴포넌트
   상태, 접근성)와 영향받는 컴포넌트의 공통 가이드라인을 공식 인덱스에서 찾아 읽고, 적용 가능한

package/Tools/OMP_Global_Config/agent/rules/verdict.md

@@ -181,6 +181,7 @@ Main은 근거가 있는 finding을 각각 다음 중 하나로 닫는다.
   (`learn`·`manage_skill`만 가진 채) 교훈을 따로 저장하고, 저장한 경우에만 대화에
   `[교훈 자동 저장]`(`autolearn-saved`) 메시지를 남긴다. 이건 보조일 뿐 Main의 직접 저장 책임은 그대로다.
   교훈 저장 여부를 물으면 이 메시지 유무로 답하고, 없으면 자동 저장이 없었다고 말한 뒤 그 자리에서 저장한다.
+- **project 범위의 사실·설계 결정·실패 원인을 `learn`으로 남길 때는 `kind: evidence`와 `citations`**(프로젝트 루트 기준 `path`, 선택 `anchor` = `## ` 절 제목·`SCOPE` 같은 RECORD 헤더 필드·줄 범위)로 그것이 적힌 기록 파일을 단다. 저장 때 경로·앵커가 실제로 있는지만 확인하며, 글이 교훈을 뒷받침하는지는 본 사람이 책임진다. 읽지 않은 파일은 달지 않는다. 적힌 기록이 아직 없으면 먼저 기록하거나 `hypothesis`로 낮춘다. 사용자 선호는 `preference`, 작업 방법은 `procedure`, 미확인 추측은 `hypothesis`로 저장하며 citations가 필요 없다. 회상 줄의 `근거 후보`는 확인할 위치이지 증거가 아니라서, 그 기억에 기대기 전에 열어 맞는지 확인한다. 이미 저장된 기억은 소급하지 않는다.
 - **다음 유사 작업의 같은 도구·경계에 진입하기 전** 적용되는 교훈을 현재 문맥이나 `recall`로 확인해
   실행 방식에 반영한다. 이미 문맥에 있는 내용을 또 조회하지 않는다. Maker 첫 턴에는 그 작업 brief로
   회상한 `<memories>`가 `(id: …)`와 함께 실린다. 위임 attempt가 실제로 적용한 교훈은