cuelo 0.9.4 → 0.9.6

package/.next/trace-build

@@ -1 +1 @@
-[{"name":"run-webpack","duration":115136424,"timestamp":678029,"id":14,"parentId":1,"tags":{},"startTime":1791135180839,"traceId":"febc2744d0c65baa"},{"name":"run-typescript","duration":21720895,"timestamp":116238110,"id":11025,"parentId":1,"tags":{},"startTime":1791135296400,"traceId":"febc2744d0c65baa"},{"name":"static-check","duration":4345717,"timestamp":138063881,"id":11028,"parentId":1,"tags":{},"startTime":1791135318226,"traceId":"febc2744d0c65baa"},{"name":"static-generation","duration":12288780,"timestamp":142523785,"id":11198,"parentId":1,"tags":{},"startTime":1791135322686,"traceId":"febc2744d0c65baa"},{"name":"collect-build-traces","duration":22080325,"timestamp":142483913,"id":11195,"parentId":1,"tags":{},"startTime":1791135322646,"traceId":"febc2744d0c65baa"},{"name":"telemetry-flush","duration":87,"timestamp":164569114,"id":11207,"parentId":1,"tags":{},"startTime":1791135344731,"traceId":"febc2744d0c65baa"},{"name":"next-build","duration":164014653,"timestamp":554771,"id":1,"tags":{"buildMode":"default","version":"16.2.12","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1791135180716,"traceId":"febc2744d0c65baa"}]
+[{"name":"run-webpack","duration":117204564,"timestamp":3666764,"id":14,"parentId":1,"tags":{},"startTime":1791206991136,"traceId":"a3ba25d1527e8fbc"},{"name":"run-typescript","duration":22577490,"timestamp":121308907,"id":11060,"parentId":1,"tags":{},"startTime":1791207108780,"traceId":"a3ba25d1527e8fbc"},{"name":"static-check","duration":4608235,"timestamp":143997002,"id":11063,"parentId":1,"tags":{},"startTime":1791207131469,"traceId":"a3ba25d1527e8fbc"},{"name":"static-generation","duration":13069934,"timestamp":148722789,"id":11233,"parentId":1,"tags":{},"startTime":1791207136195,"traceId":"a3ba25d1527e8fbc"},{"name":"collect-build-traces","duration":22219970,"timestamp":148687543,"id":11230,"parentId":1,"tags":{},"startTime":1791207136159,"traceId":"a3ba25d1527e8fbc"},{"name":"telemetry-flush","duration":77,"timestamp":170911847,"id":11242,"parentId":1,"tags":{},"startTime":1791207158384,"traceId":"a3ba25d1527e8fbc"},{"name":"next-build","duration":169697942,"timestamp":1214006,"id":1,"tags":{"buildMode":"default","version":"16.2.12","bundler":"webpack","has-custom-webpack-config":"true","use-build-worker":"false"},"startTime":1791206988683,"traceId":"a3ba25d1527e8fbc"}]

package/README.md

@@ -20,6 +20,10 @@ Use the same `~/.omp/agent` sessions, credentials and model configuration from t
 
 CUELO의 목적은 작업 중 확인한 실패와 막힘을 기억·작업 규칙·실행 절차에 반영해, 사람이 같은 문제를 다시 지적하지 않아도 다음 작업에서 실수를 줄이는 것입니다. 원인을 확인하고 필요한 부분만 바꾸며, 다음 작업에서 적용과 효과를 확인하는 것까지를 지향합니다. 기록을 저장했다는 이유만으로 자동 개선이 끝났다고 보지는 않습니다.
 
+주제별로 저장한 교훈을 정정하면 최초 기록과 최신 정정의 출처를 구분해 조회할 수 있습니다. 회상 목록에도 확인 가능한 전역·프로젝트 범위와 정정 정보를 표시합니다. 기억은 현재 요청과 저장소의 적용 조건을 대조하는 참고 자료이며 실행 승인을 대신하지 않습니다. 이전 교훈 본문을 별도 이력으로 쌓지는 않습니다. 자세한 보존 범위는 [하네스 안내](./docs/harness.md)를 참고하세요.
+
+작업을 시작할 때 회상된 교훈과 현재 요청의 적용 조건·예외·충돌을 점검해 에이전트에게 참고 안내를 제공합니다. 같은 입력은 반복 점검하지 않으며, 판단이 불명확하거나 점검에 실패해도 작업을 막지 않습니다. 현재 지시와 승인 범위가 우선입니다.
+
 **Keywords:** AI coding agent · agent harness · multi-agent orchestration · omp · oh-my-pi · model routing · developer tools
 
 ## 이 저장소로 되는 것과 따로 필요한 것
@@ -45,7 +49,7 @@ CUELO의 목적은 작업 중 확인한 실패와 막힘을 기억·작업 규
 - 입력창에 이미지·문서 외에 음성(받아쓰기), 코드·설정 파일(본문 첨부), 그 밖의 파일(저장 후 경로 첨부)을 붙여넣기·드롭·선택으로 넣습니다. 저장형 첨부는 기본 파일당 100MB이며 설정에서 한도를 바꿀 수 있습니다. 큰 음성은 처리 계획과 계정 사용량 안내를 확인한 뒤 압축·분할 전사를 시작합니다. 음성 받아쓰기는 Google Antigravity 계정이 필요합니다. 대화·분기·초안에서 사용 중인 파일은 보존하고, 미사용이 확인된 첨부만 7일 유예 후 자동 정리합니다. [첨부와 자동 정리 안내](./docs/attachments.md)를 확인하세요.
 - 에이전트가 생성하거나 확인한 이미지가 그 턴의 대화 흐름에 썸네일로 보이고, 누르면 크게 열립니다.
 - Ctrl+K 팔레트로 대화 내용을 검색해 해당 메시지로 이동합니다. 압축으로 사라진 과거 메시지는 제외하고, 현재 볼 수 있는 메시지를 세션당 최대 3건 보여 줍니다. 긴 대화 안에서는 Ctrl+F로 찾고, 오른쪽 질문 레일로 내가 한 질문 사이를 오갑니다.
-- 서버나 PC가 꺼져 실행이 끊긴 대화를 열면 중단 알림을 보여 줍니다. 컨텍스트 압축 중에는 경과 시간을 표시합니다.
+- 서버나 PC가 갑자기 꺼지면, 복구 대상인 진행 중 대화를 서버 재시작 뒤 자동으로 이어갑니다. 사용자 답변·승인을 기다리던 대화와 이전 버전의 기록은 자동으로 재개하지 않으며, 이어지지 않은 대화에는 중단 알림을 표시합니다. 컨텍스트 압축 중에는 경과 시간을 표시합니다.
 - 모델 선택기 맨 위에 자주 고른 모델이 나오고, 팔레트에서 넓은 대화 폭을 켤 수 있습니다.
 - 입력창 아래 줄은 Main 프리셋 → 그 제공자의 모델 → 추론 강도 순서입니다. "자동, 최대 high"처럼 상한을 고를 수 있고, Auto가 실제로 적용한 값은 「현재 추론 강도」로 따로 표시합니다. 실행 중에 지시를 덧붙이면 Auto가 다시 판단해 강도를 올릴 수 있고, 같은 답변 안에서는 내리지 않습니다. 새 대화는 선택한 상한 적용을 마친 뒤 첫 메시지를 보내며, 적용에 실패하면 재전송 때 다시 시도합니다.
 - 도구 옆 시간에는 모델 응답 생성 시간을 포함하지 않습니다. 실행 전에 취소된 도구나 완료 시각을 확인할 수 없는 옛 기록에는 시간을 추정해 붙이지 않습니다.
@@ -69,12 +73,14 @@ CUELO의 목적은 작업 중 확인한 실패와 막힘을 기억·작업 규
   - 개인 캐릭터 모델(선택): agent 데이터 디렉터리(기본 `~/.omp/agent`) 아래 `office-avatars/`에 `rin.vrm`·`mio.vrm`·`nova.vrm`·`yuki.vrm`·`isana.vrm`·`shion.vrm`·`hikari.vrm`을 두면 그 캐릭터를 VRM 모델로 그립니다. 파일 이름은 이 일곱 개만 쓰며, 서버는 이 고정 이름의 파일만 기존 접속 보호(호스트 확인·비밀번호 잠금)를 거친 `/api/office-avatars/<이름>`으로 내주고 다른 경로는 받지 않습니다. 모델은 저장소·npm 패키지·`public/`에 들어 있지 않습니다. 파일이 없는 캐릭터와 캐릭터를 특정하지 못한 참여자는 코드로 그린 캐릭터 그대로이고, 파일이 있는데 받거나 읽지 못하면 오류를 숨기지 않고 자리 카드와 「다시 시도」로 넘어갑니다. 파일을 넣거나 바꾼 뒤에는 오피스를 다시 열면 됩니다.
   - 한 캐릭터는 작업이 몇 개든 사무실에 한 명만 섭니다. Main과 같은 캐릭터의 Maker, 같은 계정의 Maker 여럿은 한 몸에 모이고, 머리 위 말풍선에 작업마다 한 줄(이름·상태)이 보여 실패·대기 작업도 가려지지 않습니다. 그 캐릭터를 누르면 작업이 하나일 때는 바로 열리고, 여럿일 때는 말풍선의 첫 줄로 초점이 가서 줄마다 골라 엽니다. 몸의 자리와 동작은 일하는 작업 → 기다리는 작업 → 사람을 부르거나 실패한 작업 → 쉬거나 끝난 작업 순으로 고른 대표 작업을 따릅니다. 하단 참여자 줄과 자리 카드는 계속 작업마다 따로 보입니다. Maker의 캐릭터는 오피스를 열면 각 Maker 기록의 마지막 답에 남은 계정으로 바로 정해지고, 계정 근거가 없는 참여자는 다른 캐릭터에 합치지 않고 회색 「이름 없는 참여자」로 따로 섭니다.
 - 자식 에이전트의 발화가 해당 턴 아래 대화 흐름에 끼어들어 누가 무슨 말을 했는지 이어서 읽힙니다.
-- 공개 하네스는 시작을 기다리거나 재작업 중인 에이전트에게 같은 파일을 중복 배정하지 않도록 확인합니다. 완료 결과와 Main이 검수한 결과의 출처를 구분하고, 재작업 이력과 최종 수용을 따로 남깁니다. 적용 경계는 [하네스 안내](./docs/harness.md#발주와-검수-계약)를 따릅니다.
+- 공개 하네스는 시작을 기다리거나 재작업 중인 에이전트에게 같은 파일을 중복 배정하지 않도록 확인합니다. 잘못된 작업 유형은 발주 준비 단계에서 알려주며, 에이전트 역할을 생략하면 메이커를 사용합니다. 완료 결과와 Main이 검수한 결과의 출처를 구분하고, 재작업 이력과 최종 수용을 따로 남깁니다. 적용 경계는 [하네스 안내](./docs/harness.md#발주와-검수-계약)를 따릅니다.
+- 여러 작업을 한꺼번에 맡길 때 공통 준비 확인의 반복을 줄였습니다. 작업별 담당 경로와 충돌 확인은 유지하며, 다음 발주에서는 바뀐 조건을 다시 확인합니다.
+- 완료된 위임 작업은 검수 판정과 기록을 함께 마감하고, 최종 답변 전에 판정 기록 누락을 확인합니다. 근거가 부족한 결과를 자동 합격으로 처리하지 않습니다.
 - 메이커의 기본 추론 강도와 허용 범위는 별개입니다. 작업별 허용 범위 안에서도 선택한 모델이 실제로 지원하는 강도만 사용하며, 상한을 높여도 기본 강도를 자동으로 최대로 바꾸지 않습니다.
 - 필요한 MCP 서버만 요청별로 연결하는 선택 모드를 지원합니다. 설치·인증·권한 변경은 먼저 승인을 받고 에이전트가 지원합니다. 설정과 적용 범위는 [요청별 MCP 선택 연결](./docs/harness.md#요청별-mcp-선택-연결)을 확인하세요.
 - 사이드 챗(`/btw`): 본 대화를 끊지 않고 옆 패널에서 따로 묻습니다. 답변은 본 대화와 같은 캐릭터 얼굴·스티커·마크다운으로 보이고, 세션마다 초안이 따로 보관됩니다. 사이드 챗 문답은 본 대화에 남지 않으며, 답변의 「메인에 보내기」를 누를 때만 문답과 추가 지시가 본 대화로 전달됩니다(본 대화가 실행 중이면 steer, 아니면 새 요청).
 - ChatGPT 상담(SHION): 로컬 shim이 전용 ChatGPT 탭에서 받은 답을 현재 omp 세션에 투영하고, 상담 기록과 실패 기록이 대화창에 표시됩니다.
-- 실시간 음성: 브라우저 마이크로 Codex live 음성 세션을 엽니다. “끊어”, “아… 일단 끊어”, “통화 종료해 줘”처럼 단독 종료 요청을 말하면 최종 전사를 받은 뒤 마이크와 통화를 종료합니다. 선택 기능인 캐릭터 음성은 **설정 → 통화 음성**에서 Cartesia API 키를 입력하고 음성 준비에 동의하면 현재 Main 캐릭터에 맞춰 적용됩니다. 통화 답변은 실제로 말한 캐릭터의 얼굴과 이름으로 표시되고, 캐릭터 음성 대신 기본 음성으로 말했으면 「기본 음성」이라고 함께 보입니다. 입력창에는 통화 시작·종료 버튼만 남으며, 좁은 화면에서는 모델 선택 등 다른 조작부와 겹치지 않게 줄바꿈합니다. 별도 음성 ID 입력은 필요하지 않으며, 키는 서버에만 보관합니다. 지원 플랜·크레딧 사용·전송 범위는 [캐릭터 통화 설정](./docs/live-voice.md)을 확인하세요.
+- 실시간 음성: 브라우저 마이크로 Codex live 음성 세션을 엽니다. “끊어”, “알았어, 끊어봐”, “아니 통화 종료하라고”처럼 단독 종료 요청을 말하면 최종 전사를 받은 뒤 마이크와 통화를 종료합니다. 선택 기능인 캐릭터 음성은 **설정 → 통화 음성**에서 Cartesia API 키를 입력하고 음성 준비에 동의하면 현재 Main 캐릭터에 맞춰 적용됩니다. 통화 답변은 실제로 말한 캐릭터의 얼굴과 이름으로 표시되고, 캐릭터 음성 대신 기본 음성으로 말했으면 「기본 음성」이라고 함께 보입니다. 입력창에는 통화 시작·종료 버튼만 남으며, 좁은 화면에서는 모델 선택 등 다른 조작부와 겹치지 않게 줄바꿈합니다. 별도 음성 ID 입력은 필요하지 않으며, 키는 서버에만 보관합니다. 지원 플랜·크레딧 사용·전송 범위는 [캐릭터 통화 설정](./docs/live-voice.md)을 확인하세요.
 
 **단톡방**
 
@@ -160,6 +166,8 @@ bun bin/cuelo.js --reset-password      # 비밀번호 재설정
 
 새 CUELO 릴리스가 나오면 사이드바 아래에 알림이 뜹니다. CUELO는 스스로 설치하지 않습니다. 소스에서 실행 중이면 서비스를 종료한 뒤 소스를 갱신하고 다시 설치·시작하세요. 실행 중인 개발 서버의 `.next/`에 빌드를 겹쳐 쓰지 마세요.
 
+업데이트 대기 화면에서 실패가 확인되더라도 서버가 다시 요청을 받을 수 있고 원래 대화가 확인되면 그 대화로 자동 복귀합니다. 복귀한 화면은 진행 중인 답변이나 이미 끝난 실패 안내를 따라잡으며, 복귀 자체가 명령을 다시 보내지는 않습니다.
+
 기존 프로필의 하네스·역할 설정은 앱 업데이트만으로 자동 덮어쓰지 않습니다. `0.6.1`의 설정 전환은 [기존 하네스 갱신](./docs/installation.md#061로-기존-하네스-갱신)을 확인하고, 반영 후 CUELO와 `omp`를 다시 시작하세요.
 
 ```bash

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.9.4',
+    version: '0.9.6',
     distribution: 'cuelo',
     coreVersion: '18.6.1',
 };

package/Tools/OMP_Global_Config/agent/AGENTS.md

@@ -67,6 +67,12 @@ Main은 확정 delta와 그 증거를 누적 검수하며, 최종 수용은 수
 
 실제 dependency/synthesis barrier에서만 Main 전용 `wait`를 쓰고(SubAgent에는 없다), 다른 일이 남으면 먼저 한다. 장기 job은 `read proc://<id>`와 산출물로 관측하며 침묵·`running`만으로 진행을 단정하지 않는다. peer 메시지는 `write agent://<id>`, 취소는 `write proc://<id>/kill`, 살아 있어야 하는 프로세스는 세션마다 고유한 이름의 `bash` `name` 서비스다. 결과 전달·취소·개입·yield 전 job 회수는 `rule://subagent` 「병렬과 대기」와 `harness-policy.json` `mainLane.waitContract`가 정본이다.
 
+**TODO는 실시간 작업 현황판이다.** Main은 착수·검증 완료·외부 대기·재개·실패/재작업의 상태 전환을 관측한 자리에서 해당 항목을 즉시 갱신한다. 다음 단계나 최종 보고까지 미루거나 채팅 설명으로 대신하지 않는다. 사용자 interjection에는 먼저 즉답한 뒤 같은 턴에서 필요한 갱신을 잇고, 진행 보고 때는 TODO와 실제 상태가 일치하는지 확인한다.
+
+- 완료 증거를 수용하면 바로 `done`한다. child의 종료만으로 완료 처리하지 않으며, 국소 구현·검증과 통합·배포 완료를 구분한다.
+- agent·job·사용자 결과를 기다리면 `block`에 누가 무엇을 진행 중이고 무엇이 남았는지 적는다. 이미 시작한 작업을 이유 없는 `pending`으로 남기지 않는다. 결과가 도착해 실행 가능해지면 `unblock`하고 이어 간다.
+- 도구의 자동 활성 포인터는 가장 이른 미완 항목으로 이동한다. 갱신 결과의 실제 상태를 확인하고, 앞선 통합·배포가 아직 대기 중이면 그 사유를 명시해 실제 작업을 가리지 않게 한다. 포인터를 맞추려고 미완을 완료로 표시하거나 완료 항목을 다시 열지 않는다.
+
 ## 착수 계약과 Skill
 
 Main은 사용자 요구·수용 조건·보존 동작·승인·관측 경로를 먼저 확정한다. 위임 브리프와 첫 조사에서 요구를 대조하는 절차는 `rule://verdict`·`rule://subagent` 및 `harness-policy.json` `briefContextRelay`·`routing.dispatchAssumptionCheck`를 따른다. `task` 발주 시 `TASK_GUARD` 뒤의 공유 메타 `TASK_TITLE`·`TODO_TASKS`도 `rule://task-guard`에 따라 전달한다. Skill은 설치만으로 열지 않고 이번 작업에 필요하거나 사용자가 요청했을 때만 연다. UI 작업은 `rule://frontend`를 따른다. 사용자가 명시 요청하지 않으면 `goal` 도구에 `token_budget`을 임의 설정하지 않는다.

package/Tools/OMP_Global_Config/agent/agents/maker.md

@@ -6,7 +6,7 @@ thinking-level: medium
 tools: [read, bash, edit, write, grep, glob, skim, lsp, eval, generate_image, ast_grep, ast_edit, debug, todo, web_search, checkpoint]
 ---
 
-<!-- omp-global-config:generated source-hash=816f54313240
+<!-- omp-global-config:generated source-hash=126d76a842c3
   이 파일은 patches/build-agents.mjs 가 만든 빌드 산출물이다. 직접 수정하지 마라.
   고칠 곳: agent/sop/maker.md · agent/sop/_writer.md · agent/sop/_common.md
   재생성: node patches/build-agents.mjs   검사: node patches/build-agents.mjs --check
@@ -121,10 +121,12 @@ is yours end to end.
   an injected message; you have no `wait`, so the checkpoint never blocks the session. Never send a
   diff body, raw output, file contents, or a second message per edit step. Only trigger code is held
   for that reply: keep doing read-only investigation and the non-trigger work in the same slice.
-  When independent work runs out before the reply arrives, say in prose that you are holding for the
-  checkpoint reply and end the turn; Main's message wakes you in a new turn. No reply is never
-  approval - there is no implicit or time-based approval, and trigger edits proceed only on Main's
-  explicit reply. Main retains the
+  When independent work runs out before the reply arrives, use `yield` to report the pending
+  checkpoint, completed evidence, and unstarted work as blocked/partial, never as accepted or done.
+  Prose alone ends a model turn but leaves the task executor asking for `yield`. A shared-workspace
+  Maker resumes on Main's first reply; an isolated worktree is not resumable after terminal yield,
+  so preserve the handoff for Main instead of promising a wake. No reply is never approval: trigger
+  edits require Main's explicit reply. Main retains the
   approved location and invariants for the final drift check, so a revision that edited trigger
   code without an approved checkpoint cannot be closed. This checkpoint is the first contact point
   of review, not a separate gate: the final judgement covers only deltas not yet reviewed and the
@@ -163,6 +165,10 @@ is yours end to end.
   build error. Never put a broken intermediate state on the user's screen. Use the user's browser
   only when their live session is genuinely required, or when Main tells you to hand a FINISHED
   surface over for judgement — do not open it on your own initiative.
+  Do not launch Chrome/Edge executables directly from bash or eval (including `Bun.spawn`) for
+  verification. Use the managed browser helpers or the project's supported verification commands.
+  Such commands must use an absolute, isolated profile path: even headless startup can show a
+  native desktop error dialog when its profile path is invalid.
 - Run surface checks in the environment Main provides; create a common isolation environment or
   run a full build yourself only when the brief explicitly delegates that run. When you do launch a
   server (delegated, or no environment exists

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

@@ -84,6 +84,8 @@ type SpawnItem = {
   agent: string;
   task: string;
   name?: string;
+  /** 호출이 agent를 생략했다. 위임 정의가 maker 하나뿐이라 maker로 해석하고 반환 input에도 기록한다. */
+  agentOmitted?: true;
 };
 
 export type TaskCallInput = Record<string, unknown>;
@@ -155,7 +157,7 @@ function readField(block: string, name: string): string | undefined {
   return value || undefined;
 }
 
-const WORK_CLASSES = ["feature", "maintenance", "diagnostic"] as const;
+export const WORK_CLASSES = ["feature", "maintenance", "diagnostic"] as const;
 const PURPOSES = ["primary", "rework"] as const;
 
 /**
@@ -280,12 +282,13 @@ function normalizeSpawnItems(input: TaskCallInput): SpawnItem[] | string {
         return "[SpawnGuard] tasks[] 항목 형식이 올바르지 않습니다.";
       }
       const item = rawItem as Record<string, unknown>;
-      if (typeof item.agent !== "string" || typeof item.task !== "string") {
-        return "[SpawnGuard] 모든 task 항목은 agent와 task를 명시해야 합니다.";
+      if (typeof item.task !== "string" || (item.agent !== undefined && typeof item.agent !== "string")) {
+        return "[SpawnGuard] 모든 task 항목은 task 문자열을 가져야 하고 agent는 생략하거나 문자열이어야 합니다.";
       }
       items.push({
-        agent: item.agent.trim().toLowerCase(),
+        agent: item.agent === undefined ? "maker" : item.agent.trim().toLowerCase(),
         task: item.task,
+        ...(item.agent === undefined ? { agentOmitted: true as const } : {}),
         ...(typeof item.name === "string" && item.name.trim()
           ? { name: item.name.trim() }
           : {}),
@@ -294,13 +297,14 @@ function normalizeSpawnItems(input: TaskCallInput): SpawnItem[] | string {
     return items;
   }
 
-  if (typeof input.agent !== "string" || typeof input.task !== "string") {
-    return "[SpawnGuard] task 호출은 agent와 task를 명시해야 합니다.";
+  if (typeof input.task !== "string" || (input.agent !== undefined && typeof input.agent !== "string")) {
+    return "[SpawnGuard] task 호출은 task 문자열을 가져야 하고 agent는 생략하거나 문자열이어야 합니다.";
   }
   return [
     {
-      agent: input.agent.trim().toLowerCase(),
+      agent: input.agent === undefined ? "maker" : input.agent.trim().toLowerCase(),
       task: input.task,
+      ...(input.agent === undefined ? { agentOmitted: true as const } : {}),
       ...(typeof input.name === "string" && input.name.trim()
         ? { name: input.name.trim() }
         : {}),
@@ -412,6 +416,7 @@ export function reserveTaskCall(
   const makers: MakerSpawn[] = [];
   // 파생이 일어난 항목만 정규 블록으로 교체한다. 나머지 항목은 원본 문자열을 그대로 쓴다.
   const rewritten = new Map<number, string>();
+  const agentFilled = new Set<number>();
 
   for (const [index, item] of normalized.entries()) {
     const raw = parseGuardMetadata(item.task);
@@ -446,6 +451,7 @@ export function reserveTaskCall(
       raw.blocksPrimary === undefined ||
       raw.primaryDeliverable === undefined;
     if (derived) rewritten.set(index, canonicalizeTask(item.task, raw, metadata, item.agent));
+    if (item.agentOmitted) agentFilled.add(index);
   }
 
   const overBudget = budgetReason(state.usage, delta);
@@ -459,21 +465,36 @@ export function reserveTaskCall(
     makers,
   });
   for (const entry of refundable) state.refundable.set(entry.name, entry.delta);
-  if (rewritten.size === 0) return { ok: true };
-  return { ok: true, input: replaceTaskBodies(input, rewritten) };
+  if (rewritten.size === 0 && agentFilled.size === 0) return { ok: true };
+  return { ok: true, input: replaceTaskBodies(input, rewritten, agentFilled) };
 }
 
 /**
- * 원본 입력을 제자리에서 바꾸지 않고 교체 본문만 담은 얕은 복사본을 만든다. tasks[]의 다른 항목과
- * context·model·isolated 같은 나머지 키는 그대로 보존한다.
+ * 원본 입력을 제자리에서 바꾸지 않고 교체 본문과 생략된 agent의 maker 기록만 담은 얕은 복사본을 만든다.
+ * tasks[]의 다른 항목과 context·model·isolated 같은 나머지 키는 그대로 보존한다.
  */
-function replaceTaskBodies(input: TaskCallInput, rewritten: Map<number, string>): TaskCallInput {
-  if (!Array.isArray(input.tasks)) return { ...input, task: rewritten.get(0) };
+function replaceTaskBodies(
+  input: TaskCallInput,
+  rewritten: Map<number, string>,
+  agentFilled: Set<number>,
+): TaskCallInput {
+  if (!Array.isArray(input.tasks)) {
+    return {
+      ...input,
+      ...(rewritten.has(0) ? { task: rewritten.get(0) } : {}),
+      ...(agentFilled.has(0) ? { agent: "maker" } : {}),
+    };
+  }
   return {
     ...input,
     tasks: input.tasks.map((item, index) => {
       const task = rewritten.get(index);
-      return task === undefined ? item : { ...(item as Record<string, unknown>), task };
+      if (task === undefined && !agentFilled.has(index)) return item;
+      return {
+        ...(item as Record<string, unknown>),
+        ...(task === undefined ? {} : { task }),
+        ...(agentFilled.has(index) ? { agent: "maker" } : {}),
+      };
     }),
   };
 }

package/Tools/OMP_Global_Config/agent/extensions/gitnexus-autosync.ts

@@ -20,10 +20,17 @@ import type { ExtensionAPI } from "@oh-my-pi/pi-coding-agent";
  *   쓰기 도중 충돌할 수 있으므로, 워커가 DB 파일을 공유 없이 열어 보고 다른 프로세스가 쥐고 있으면
  *   이번에는 건너뛴다(다음 세션이 다시 시도한다).
  * - 실패는 세션으로 올리지 않고 gitignore된 `.gitnexus/autosync.log`에만 남긴다.
+ * - analyze가 끝나면(그리고 색인이 HEAD와 같아도 이 커밋의 검사 기록이 없으면 analyze 없이도) 색인 무결성을 읽는다.
+ *   GitNexus 1.6.12 색인에서 Function 행의 id(심하면 이름까지)가 비는 손상을 실제로 봤다. 그러면 `impact`가 알려진
+ *   심볼을 못 찾거나 부풀리고 `detect-changes`가 모든 프로세스를 영향으로 보고한다(증거: doc/history/2026/10/05-five-improvements/
+ *   maker-gitnexus.md). 손상이 있으면 `analyze --index-only --force`로 한 번 다시 만들고, 결과를
+ *   `.gitnexus/autosync-health.json`에 남겨 같은 커밋을 다시 검사하지 않는다. 손상의 유발 조건은 최소 재현하지 못했다.
  */
 
 const LOCK_NAME = "autosync.lock";
 const LOG_NAME = "autosync.log";
+const ANALYZE_ARGS = ["analyze", "--index-only"];
+const HEALTH_NAME = "autosync-health.json";
 /** 살아 있는 pid라도 이보다 오래된 잠금은 pid 재사용·고착으로 보고 회수한다. */
 const LOCK_MAX_AGE_MS = 6 * 60 * 60 * 1000;
 const GIT_TIMEOUT_MS = 10_000;
@@ -43,8 +50,12 @@ export interface WorkerJob {
   head: string;
   lockPath: string;
   logPath: string;
+  /** 색인 무결성 검사 결과를 남기는 파일. */
+  healthPath: string;
+  /** 색인이 이미 HEAD와 같아 analyze 없이 무결성 검사만 한다. */
+  verifyOnly: boolean;
   token: string;
-  /** analyze를 실행할 프로그램과 인자. */
+  /** analyze를 실행할 프로그램과 인자. 마지막 두 항목 앞이 실행기 접두이며 cypher 검사에도 쓴다. */
   command: string[];
   /** Windows `.cmd` 실행기처럼 셸이 필요한 경우. */
   shell: boolean;
@@ -121,7 +132,38 @@ const dbInUse = () => {
 const readLastCommit = () => {
   try { return JSON.parse(fs.readFileSync(job.root + "/.gitnexus/meta.json", "utf8")).lastCommit; } catch { return undefined; }
 };
+// 실행기 접두(analyze 앞부분)에 인자를 붙여 실행한다. capture면 stdout을 모아 돌려주고, 아니면 로그 fd로 보낸다.
+const base = job.command.slice(0, job.command.indexOf("analyze"));
+const quote = (text) => (job.shell ? '"' + text + '"' : text);
+const execute = (env, args, out) => {
+  const { promise, resolve } = Promise.withResolvers();
+  let stdout = "";
+  const child = spawn(base[0], base.slice(1).concat(args), {
+    cwd: job.root, env, stdio: ["ignore", out === undefined ? "pipe" : out, out === undefined ? "ignore" : out], windowsHide: true, shell: job.shell,
+  });
+  if (out === undefined) child.stdout.on("data", (chunk) => { stdout += chunk; });
+  child.on("error", (error) => { log("spawn error: " + error.message); resolve({ code: -1, stdout }); });
+  child.on("close", (exitCode, signal) => resolve({ code: exitCode === null ? "signal " + signal : exitCode, stdout }));
+  return promise;
+};
+const readCount = async (env, query) => {
+  const { code, stdout } = await execute(env, ["cypher", quote(query)]);
+  if (code !== 0) return undefined;
+  try {
+    const json = JSON.parse(stdout.slice(stdout.indexOf("{"), stdout.lastIndexOf("}") + 1));
+    const cell = String(json.markdown).split("\n").pop().split("|").map((s) => s.trim()).filter(Boolean)[0];
+    const count = Number(cell);
+    return Number.isInteger(count) ? count : undefined;
+  } catch { return undefined; }
+};
+// Function 행 수와 id가 온전한(Function: 접두) 행 수. id가 빈 행이 있으면 impact와 detect-changes가 틀린다.
+const functionRows = async (env) => {
+  const total = await readCount(env, "MATCH (n:Function) RETURN count(n) AS c");
+  const intact = await readCount(env, "MATCH (n:Function) WHERE n.id STARTS WITH 'Function:' RETURN count(n) AS c");
+  return total === undefined || intact === undefined ? undefined : { total, intact };
+};
 (async () => {
+  let out;
   try {
     if (dbInUse()) {
       log("skip: index DB is open by another process (e.g. a GitNexus MCP reader); next session retries");
@@ -132,23 +174,42 @@ const readLastCommit = () => {
       const key = Object.keys(env).find((k) => k.toUpperCase() === "PATH") || "PATH";
       env[key] = job.pathPrefix + (process.platform === "win32" ? ";" : ":") + (env[key] || "");
     }
-    const out = fs.openSync(job.logPath, "a");
-    const started = Date.now();
-    log("start: " + job.command.join(" ") + " (head " + job.head.slice(0, 12) + ")");
-    const code = await new Promise((resolve) => {
-      const child = spawn(job.command[0], job.command.slice(1), {
-        cwd: job.root, env, stdio: ["ignore", out, out], windowsHide: true, shell: job.shell,
-      });
-      child.on("error", (error) => { log("spawn error: " + error.message); resolve(-1); });
-      child.on("exit", (exitCode, signal) => resolve(exitCode === null ? "signal " + signal : exitCode));
-    });
-    fs.closeSync(out);
-    const indexed = readLastCommit();
-    log("end: exit=" + code + " seconds=" + ((Date.now() - started) / 1000).toFixed(1) +
-      " lastCommit=" + String(indexed).slice(0, 12) + (indexed === job.head ? " (matches head)" : " (differs from head)"));
+    out = fs.openSync(job.logPath, "a");
+    const analyzeArgs = job.command.slice(base.length);
+    if (!job.verifyOnly) {
+      const started = Date.now();
+      log("start: " + job.command.join(" ") + " (head " + job.head.slice(0, 12) + ")");
+      const { code } = await execute(env, analyzeArgs, out);
+      const indexed = readLastCommit();
+      log("end: exit=" + code + " seconds=" + ((Date.now() - started) / 1000).toFixed(1) +
+        " lastCommit=" + String(indexed).slice(0, 12) + (indexed === job.head ? " (matches head)" : " (differs from head)"));
+      if (code !== 0) return;
+    } else {
+      log("verify: index is at head " + job.head.slice(0, 12) + "; checking index integrity only");
+    }
+    let rows = await functionRows(env);
+    // 손상이 보이면 증분 갱신 뒤든 검사만 하는 경우든 --force 전체 재빌드를 한 번 한다.
+    if (rows && rows.intact < rows.total) {
+      log("integrity: " + (rows.total - rows.intact) + " of " + rows.total + " Function rows lost their id; rebuilding with --force");
+      if (dbInUse()) {
+        log("skip: index DB is open by another process; rebuild deferred");
+        return;
+      } else {
+        const started = Date.now();
+        const { code } = await execute(env, analyzeArgs.concat("--force"), out);
+        log("forced rebuild end: exit=" + code + " seconds=" + ((Date.now() - started) / 1000).toFixed(1));
+        rows = await functionRows(env);
+      }
+    }
+    log("integrity: " + (rows ? rows.intact + "/" + rows.total + " Function rows have their id" : "unreadable"));
+    // 같은 커밋을 세션마다 다시 검사하지 않도록 결과를 남긴다.
+    try {
+      fs.writeFileSync(job.healthPath, JSON.stringify({ lastCommit: readLastCommit(), checkedAt: Date.now(), rows: rows ?? null }));
+    } catch {}
   } catch (error) {
     log("worker error: " + (error && error.message ? error.message : String(error)));
   } finally {
+    if (out !== undefined) try { fs.closeSync(out); } catch {}
     release();
   }
 })();
@@ -248,11 +309,11 @@ function resolveRunner(deps: AutoSyncDeps): { command: string[]; shell: boolean;
   const installed = deps.which("gitnexus");
   if (installed) {
     const shell = deps.platform === "win32" && /\.(cmd|bat)$/i.test(installed);
-    return { command: [shell ? `"${installed}"` : installed, "analyze", "--index-only"], shell, nodePath };
+    return { command: [shell ? `"${installed}"` : installed, ...ANALYZE_ARGS], shell, nodePath };
   }
   // --no-install: 캐시에 없으면 내려받지 않고 바로 실패한다.
   const bun = deps.which("bun");
-  if (bun) return { command: [bun, "x", "--no-install", "gitnexus", "analyze", "--index-only"], shell: false, nodePath };
+  if (bun) return { command: [bun, "x", "--no-install", "gitnexus", ...ANALYZE_ARGS], shell: false, nodePath };
   return undefined;
 }
 
@@ -282,7 +343,10 @@ export async function syncGitNexusIndex(cwd: string, deps: AutoSyncDeps = defaul
   try {
     const lastCommit = readJsonObject(metaPath)?.lastCommit;
     const head = await deps.git(["rev-parse", "HEAD"], root);
-    if (lastCommit === head) return "fresh";
+    // 색인이 HEAD와 같아도 무결성을 한 번도 확인하지 않은 커밋이면 analyze 없이 검사만 하는 워커를 띄운다.
+    const healthPath = path.join(storage, HEALTH_NAME);
+    const verifyOnly = lastCommit === head;
+    if (verifyOnly && readJsonObject(healthPath)?.lastCommit === head) return "fresh";
     const runner = resolveRunner(deps);
     if (!runner) {
       appendLog(logPath, deps.now(), "skip: no node or GitNexus runner available");
@@ -296,6 +360,8 @@ export async function syncGitNexusIndex(cwd: string, deps: AutoSyncDeps = defaul
       head,
       lockPath,
       logPath,
+      healthPath,
+      verifyOnly,
       token,
       command: runner.command,
       shell: runner.shell,
@@ -312,7 +378,11 @@ export async function syncGitNexusIndex(cwd: string, deps: AutoSyncDeps = defaul
     // 잠금 소유자를 실제 워커로 넘겨 이 세션이 끝나도 워커가 사는 동안 잠금이 유지되게 한다.
     // 워커가 이미 끝나 잠금을 지웠다면 되살리지 않는다.
     if (readLock(lockPath)?.token === token) writeLockAtomically(lockPath, { pid, token, startedAt: deps.now() });
-    appendLog(logPath, deps.now(), `spawned worker pid ${pid} (index ${String(lastCommit).slice(0, 12)} -> head ${head.slice(0, 12)})`);
+    appendLog(
+      logPath,
+      deps.now(),
+      `spawned ${verifyOnly ? "verify-only " : ""}worker pid ${pid} (index ${String(lastCommit).slice(0, 12)} -> head ${head.slice(0, 12)})`,
+    );
     return "started";
   } catch (error) {
     appendLog(logPath, deps.now(), `error: ${error instanceof Error ? error.message : String(error)}`);