cuelo 0.7.1 → 0.8.0

package/Tools/OMP_Global_Config/agent/extensions/lib/maker-routing.ts

@@ -85,6 +85,8 @@ export interface RoutingDeps {
   candidates?: (ctx: ExtensionContext, policy: RoutingPolicy) => Promise<Candidate[]>;
   /** 후보 provider별 계정 잔량. 생략하면 CUELO usage 사이드카(`OMP_USAGE_PORT`, 기본 30142)를 읽는다. */
   quota?: (providers: string[], signal?: AbortSignal) => Promise<QuotaSnapshot>;
+  /** 준비 단계 진단용 단조 시계(ms). 생략하면 performance.now. */
+  clock?: () => number;
   /** 발주 이력. 생략하면 기록·history 요약을 하지 않는다. 실패는 발주를 막지 않는다. */
   ledger?: RoutingLedger;
 }
@@ -540,10 +542,11 @@ export function registerMakerRouting(pi: ExtensionAPI, deps: RoutingDeps) {
   // 검사를 통과한 발주의 이력 초안. spawn 성공(noteSpawned) 때만 identity와 함께 ledger에 남긴다.
   // 새 초안은 항상 소유 계약을 싣는다. 원장의 과거 row만 ownership이 없을 수 있다.
   type DispatchDraft = Omit<DispatchRecord, "ts" | "ownership" | keyof AttemptIdentity> & { ownership: DispatchOwnership };
-  const pendingDispatches = new Map<string, DispatchDraft>();
-  // 검사를 통과했지만 spawn 결과를 아직 받지 못한 task 호출의 소유 예약(toolCallId → 초안). 별도 task 호출의 admission이
-  // 이 예약과 충돌을 검사한다. spawn 관측(noteSpawned)은 실제 owner 목록으로 넘기며 지우고, spawn 없이 끝난 호출은 releaseCall이 지운다.
-  const reservations = new Map<string, { key: string; draft: DispatchDraft }[]>();
+  // 검사를 통과했지만 spawn 결과를 아직 받지 못한 task 호출의 실행 초안(toolCallId → 그 호출 tasks[]의 itemIndex별 초안).
+  // 초안은 이 호출 실행에만 속한다. 같은 이름·같은 계약의 다른 호출도 자기 초안을 갖고, 준비 판단(bindings)은 그대로 재사용한다.
+  // 별도 task 호출의 admission이 이 예약과 충돌을 검사한다. spawn 관측(noteSpawned)은 자기 초안만 소비해 실제 owner 목록으로
+  // 넘기며 지우고, spawn 없이 끝난 호출은 releaseCall이 자기 예약만 지운다.
+  const reservations = new Map<string, { itemIndex: number; key: string; draft: DispatchDraft }[]>();
   // 거절 진단 전용 색인. 준비된 계약을 이름별로 시간순으로 모아 어긋난 필드를 지목하며,
   // 통과·차단 판정에는 관여하지 않는다.
   const preparedContracts = new Map<string, DispatchContract[]>();
@@ -555,7 +558,6 @@ export function registerMakerRouting(pi: ExtensionAPI, deps: RoutingDeps) {
   const reset = () => {
     generation++;
     bindings.clear();
-    pendingDispatches.clear();
     reservations.clear();
     preparedContracts.clear();
     decisionCache.clear();
@@ -730,11 +732,19 @@ export function registerMakerRouting(pi: ExtensionAPI, deps: RoutingDeps) {
         throw new Error("같은 task 계약에 더 최신 facts 준비가 있어 이전 라우팅 판단은 폐기되었습니다.");
       }
     };
+    const clock = deps.clock ?? (() => performance.now());
+    const startedAt = clock();
+    const elapsed = (from: number, to: number) => Math.max(0, Math.round(to - from));
+    // 고정 필드 진단. 숫자만 담으며 task 수와 무관하다. jevStarted는 이 호출이 실제로 시작한 judge 요청 수이고,
+    // 분류별 건수와 합산해 해석하지 않는다(한 요청이 decision·placement를 함께 판단할 수 있다).
+    const counts = { jevStarted: 0, decisionNew: 0, decisionReused: 0, placementNew: 0, placementReused: 0 };
     let quotaAbort: AbortController | undefined;
     try {
       const ownersByTask = contracts.map((contract) => relevantOwners(contract, allOwners));
       const refreshAttempts: RefreshAttempts = new Map();
+      const candidatesStartedAt = clock();
       const { available: candidates, unavailable: unavailableCandidates } = await candidateSet(ctx, current, refreshAttempts);
+      const candidatesDoneAt = clock();
       requireLatest();
       // 잔량은 시각마다 바뀌므로 revision·identity·Jev state 밖의 참고 정보로만 붙인다.
       // Jev 판단과 함께 시작하고, 이번 계정 잔량 조회가 끝난 뒤 배정 결과를 반환한다.
@@ -760,6 +770,7 @@ export function registerMakerRouting(pi: ExtensionAPI, deps: RoutingDeps) {
           reason: error instanceof Error ? error.message : String(error),
         });
       }
+      const judgeStartedAt = clock();
       const publications = await Promise.all(tasks.map(async (task, index) => {
         const contract = contracts[index]!;
         const owners = ownersByTask[index]!;
@@ -773,8 +784,14 @@ export function registerMakerRouting(pi: ExtensionAPI, deps: RoutingDeps) {
         let decisionPending = decisionCache.get(decisionKey);
         let placementPending = placementCache.get(placementKey);
 
+        // 소유자가 없으면 placement 판단 자체가 없으므로 어느 쪽으로도 세지 않는다. 새 decision 판단은 placement를 함께 덮어쓴다.
+        if (decisionPending) counts.decisionReused += 1;
+        if (decisionPending && placementPending && owners.length > 0) counts.placementReused += 1;
         if (!decisionPending) {
           const fullQuestions = { ...baseQuestions, ...ownerQuestions };
+          counts.jevStarted += 1;
+          counts.decisionNew += 1;
+          if (owners.length > 0) counts.placementNew += 1;
           const fullPending = judge(ctx, routingState(task.assessment, owners), fullQuestions, signal);
           decisionPending = cacheJudgment(
             decisionCache,
@@ -795,6 +812,8 @@ export function registerMakerRouting(pi: ExtensionAPI, deps: RoutingDeps) {
             );
           }
         } else if (!placementPending && owners.length > 0) {
+          counts.jevStarted += 1;
+          counts.placementNew += 1;
           placementPending = cacheJudgment(
             placementCache,
             placementKey,
@@ -841,7 +860,9 @@ export function registerMakerRouting(pi: ExtensionAPI, deps: RoutingDeps) {
           },
         };
       }));
+      const quotaWaitStartedAt = clock();
       const quota = await quotaPending;
+      const quotaDoneAt = clock();
       requireLatest();
       const allocation = normalAllocation(current, candidates, quota);
       // 이력은 advisory다. revision·identity·Jev state 밖에 두며 읽기 실패는 빈 이력이다.
@@ -870,7 +891,15 @@ export function registerMakerRouting(pi: ExtensionAPI, deps: RoutingDeps) {
         const name = tasks[index]!.name.trim();
         preparedContracts.set(name, [...(preparedContracts.get(name) ?? []), contracts[index]!]);
       });
+      const diagnostics = {
+        totalMs: elapsed(startedAt, quotaDoneAt),
+        candidatesMs: elapsed(candidatesStartedAt, candidatesDoneAt),
+        judgeWaitMs: elapsed(judgeStartedAt, quotaWaitStartedAt),
+        quotaExtraWaitMs: elapsed(quotaWaitStartedAt, quotaDoneAt),
+        ...counts,
+      };
       return {
+        diagnostics,
         candidates,
         unavailableCandidates,
         quota,
@@ -923,7 +952,7 @@ export function registerMakerRouting(pi: ExtensionAPI, deps: RoutingDeps) {
       candidateLock ??= { workClass: contract.workClass, primaryDeliverable: contract.primaryDeliverable };
       return contract;
     });
-    const drafts: [string, DispatchDraft][] = [];
+    const drafts: [number, DispatchDraft][] = [];
     for (const [itemIndex, item] of tasks.entries()) {
       const requested = typeof item.model === "string" ? item.model : "";
       const task = typeof item.task === "string" ? item.task : "";
@@ -994,7 +1023,7 @@ export function registerMakerRouting(pi: ExtensionAPI, deps: RoutingDeps) {
       const recommended = candidates.findIndex((candidate) => candidate.profile === profile);
       const recommendedCandidate = candidates[recommended];
       const workClass = answers?.workClass?.choice ?? null;
-      drafts.push([key, {
+      drafts.push([itemIndex, {
         type: "dispatch",
         name,
         workClass,
@@ -1048,8 +1077,7 @@ export function registerMakerRouting(pi: ExtensionAPI, deps: RoutingDeps) {
         reason: `다른 task 호출이 발주 승인을 받아 spawn 결과를 기다리는 공유 작업공간 OWNED_PATHS와 겹칩니다: ${reserved.slice(0, DIAGNOSTIC_LIST_LIMIT).join("; ")}. 이 호출은 발주하지 않았습니다. 그 호출의 결과가 돌아온 뒤 현재 owner를 확인해 다시 내거나, 경로를 나누거나 isolated로 발주하세요.`,
       };
     }
-    for (const [key, draft] of drafts) pendingDispatches.set(key, draft);
-    if (callId && drafts.length > 0) reservations.set(callId, drafts.map(([key, draft]) => ({ key, draft })));
+    if (callId && drafts.length > 0) reservations.set(callId, drafts.map(([itemIndex, draft]) => ({ itemIndex, key: briefKey(draft.name, contracts[itemIndex]!), draft })));
     return canonicalInput === input ? undefined : { input: canonicalInput };
   }
 
@@ -1058,9 +1086,6 @@ export function registerMakerRouting(pi: ExtensionAPI, deps: RoutingDeps) {
    * tool_execution_end만 내고, task 실행 오류는 isError tool_result를 낸다. 다른 호출의 예약과 이미 이관된 owner는 건드리지 않는다.
    */
   function releaseCall(callId: string): void {
-    for (const { key, draft } of reservations.get(callId) ?? []) {
-      if (pendingDispatches.get(key) === draft) pendingDispatches.delete(key);
-    }
     reservations.delete(callId);
   }
 
@@ -1081,16 +1106,16 @@ export function registerMakerRouting(pi: ExtensionAPI, deps: RoutingDeps) {
     // 원장에서 읽으므로 reload 뒤에도 연결이 유지되고, 관측되지 않은 준비만으로는 연결하지 않는다.
     const known = assignmentsByName(deps.ledger?.read() ?? [], sessionId);
     let candidateLock = contractLock;
+    const reserved = reservations.get(callId) ?? [];
     for (const [index, item] of tasks.entries()) {
       const task = typeof item.task === "string" ? item.task : "";
       const contract = dispatchContract(task, candidateLock);
       if (!contract) continue;
       candidateLock ??= { workClass: contract.workClass, primaryDeliverable: contract.primaryDeliverable };
       const name = String(item.name ?? "").trim();
-      const key = briefKey(name, contract);
-      const draft = pendingDispatches.get(key);
+      // 이 호출이 admission에서 받은 그 항목의 초안만 소비한다. 같은 이름·같은 계약의 다른 호출 초안은 그 호출의 것이다.
+      const draft = reserved.find((entry) => entry.itemIndex === index && entry.key === briefKey(name, contract))?.draft;
       if (!draft) continue;
-      pendingDispatches.delete(key);
       // 다른 guard가 막은 뒤 다른 selector로 다시 낸 발주는 그 호출의 beforeTask 초안만 맞는다.
       if (item.model !== `${draft.chosenModel}:${draft.chosenEffort}`) continue;
       const linked = sessionId && contract.findingId !== null ? known.get(name) : undefined;
@@ -1131,7 +1156,9 @@ export function registerMakerRouting(pi: ExtensionAPI, deps: RoutingDeps) {
         const request = params as { context: string; tasks: RouteTask[] };
         const batch = await prepareBatch(request.context, request.tasks, ctx, signal, String(callId ?? ""));
         // 준비 handle(plan)은 발주 identity가 아니므로(routing_verdict는 spawn identity) 모델 문맥에는 싣지 않고 details에만 둔다.
-        const view = { ...batch, routes: batch.routes.map(({ plan: _plan, ...route }) => route) };
+        // 준비 진단(diagnostics)도 details 전용이다. 모델 문맥에는 싣지 않는다.
+        const { diagnostics: _diagnostics, ...shared } = batch;
+        const view = { ...shared, routes: batch.routes.map(({ plan: _plan, ...route }) => route) };
         return { content: [{ type: "text", text: JSON.stringify(view) }], details: batch };
       },
     });

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

@@ -174,6 +174,9 @@ Main은 근거가 있는 finding을 각각 다음 중 하나로 닫는다.
   어긴 실행 실수면 기존 규칙 적용을 교정하고, 규칙·Skill 누락일 때만 해당 정본을 보완한다.
   미확정 가설이나 실패율 임계값으로 규칙을 자동 생성·변경하지 않는다. `learn`은 Main 전용이다.
   Maker는 종료 보고에 교훈 후보를 싣고, Main이 저장·기존 교훈 연결·기각을 정한다.
+  저장 범위도 Main이 직접 정한다. 여러 프로젝트에 적용되는 사용자 선호·작업 운영 원칙은
+  `global`, 특정 저장소의 구현·경로·환경에 종속된 사실은 `project`로 저장한다. 사용자가
+  범위를 다시 지정하게 하지 않으며, 이미 있는 교훈은 중복 저장보다 연결·수정을 우선한다.
   전역 `autolearn`도 켜져 있다. 도구 호출 8회 이상 턴이 끝나면 core의 별도 capture Agent가
   (`learn`·`manage_skill`만 가진 채) 교훈을 따로 저장하고, 저장한 경우에만 대화에
   `[교훈 자동 저장]`(`autolearn-saved`) 메시지를 남긴다. 이건 보조일 뿐 Main의 직접 저장 책임은 그대로다.

package/Tools/OMP_Global_Config/agent/tools/git-finalizer/index.ts

@@ -1,6 +1,6 @@
 import type { CustomToolFactory } from "@oh-my-pi/pi-coding-agent";
 import { createHash } from "node:crypto";
-import { mkdtemp, readFile, rm, stat, writeFile } from "node:fs/promises";
+import { access, mkdtemp, readFile, rm, stat, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -28,6 +28,41 @@ const manifestInstructions = `From cwd Tools/CUELO_Setup, run:
 node files/source-build-helper.js create-manifest ../.. files/runtime-integrity.json --output files/source-integrity.json
 node files/source-build-helper.js verify-source ../.. files/source-integrity.json files/runtime-integrity.json
 Then include Tools/CUELO_Setup/files/source-integrity.json in the same commit.`;
+const memorySyncScript = "Tools/OMP_Global_Config/memory-sync/sync.ts";
+const memoryTransport = "Tools/OMP_Global_Config/memory-sync/memories.jsonl";
+
+type Exec = (command: string, args: string[], options: { cwd: string }) => Promise<{ code: number; stdout: string; stderr?: string }>;
+
+/**
+ * 기억 PC 간 동기화의 export를 커밋 경로에 붙인다. 원래 hook은 손으로 돌리는 export.ps1 끝뿐이라
+ * 평소 커밋·배포로는 한 번도 내보내지지 않았다(2026-10-02). 같은 저장소 커밋이면 먼저 export하고,
+ * 바뀐 transport 파일을 커밋 목록에 더한다. 실패는 커밋을 막지 않고 결과 문구로 알린다.
+ */
+async function exportMemories(cwd: string, files: string[], exec: Exec): Promise<{ file?: string; note?: string }> {
+  const top = await exec("git", ["-C", cwd, "rev-parse", "--show-toplevel"], { cwd });
+  if (top.code !== 0) return {};
+  const root = resolve(top.stdout.trim());
+  try {
+    await access(join(root, ...memorySyncScript.split("/")));
+  } catch {
+    return {};
+  }
+  const inRoot = (path: string) => {
+    const rel = relative(root, resolve(cwd, path));
+    return rel !== "" && !rel.startsWith("..") && !isAbsolute(rel);
+  };
+  if (!files.every(inRoot)) return {};
+  const transport = relative(cwd, join(root, ...memoryTransport.split("/"))).split(sep).join("/");
+  if (transport.startsWith("../")) return { note: "기억 export 생략: 현재 cwd 밖의 파일이라 이 커밋에 넣을 수 없다." };
+  if (files.some((file) => file.replace(/\\/g, "/").toLowerCase() === transport.toLowerCase())) return {};
+  const exported = await exec("bun", [join(root, ...memorySyncScript.split("/")), "export", root], { cwd: root });
+  if (exported.code !== 0) {
+    const reason = (exported.stderr || exported.stdout).trim().split(/\r?\n/).at(-1) || `exit ${exported.code}`;
+    return { note: `기억 export 실패(커밋은 진행): ${reason}` };
+  }
+  const status = await exec("git", ["-C", root, "status", "--porcelain", "--", memoryTransport], { cwd: root });
+  return status.code === 0 && status.stdout.trim() ? { file: transport } : {};
+}
 
 function isSourcePath(path: string, packagedTools: string[]): boolean {
   if (path.split("/").some((segment) => generatedSourceSegments[segment] || segment.endsWith(".tsbuildinfo"))) return false;
@@ -137,13 +172,16 @@ const factory: CustomToolFactory = (pi) => ({
   }),
 
   async execute(_toolCallId, params, onUpdate, _ctx, signal) {
-    const files = params.files.map((value) => value.trim()).filter(Boolean);
+    const requested = params.files.map((value) => value.trim()).filter(Boolean);
     const message = params.message.trim();
-    if (files.length === 0) throw new Error("git_finalize requires at least one exact file path.");
+    if (requested.length === 0) throw new Error("git_finalize requires at least one exact file path.");
     if (!message) throw new Error("git_finalize requires a non-empty commit message.");
     if (process.platform !== "win32") throw new Error("git_finalize currently requires Windows PowerShell.");
 
-    await checkSourceManifest(pi.cwd, files, (command, args, options) => pi.exec(command, args, { ...options, signal }));
+    const exec: Exec = (command, args, options) => pi.exec(command, args, { ...options, signal });
+    await checkSourceManifest(pi.cwd, requested, exec);
+    const memory = await exportMemories(pi.cwd, requested, exec);
+    const files = memory.file ? [...requested, memory.file] : requested;
 
     onUpdate?.({
       content: [{ type: "text", text: "Repository finalizer lock을 획득하고 변경 경계를 확인하는 중입니다." }],
@@ -168,7 +206,9 @@ const factory: CustomToolFactory = (pi) => ({
         content: [
           {
             type: "text",
-            text: `Committed and pushed ${parsed.commitSha} to ${parsed.remote} ${parsed.upstreamRef}.`,
+            text: `Committed and pushed ${parsed.commitSha} to ${parsed.remote} ${parsed.upstreamRef}.`
+              + (memory.file ? ` 기억 transport(${memory.file})를 함께 커밋했다.` : "")
+              + (memory.note ? ` ${memory.note}` : ""),
           },
         ],
         details: parsed,