therookie 0.4.13 → 0.4.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "therookie",
-  "version": "0.4.13",
+  "version": "0.4.15",
   "description": "the Rookie — the AI new hire that remembers what you teach it. A CLI that connects a personal AI memory to AI tools like Claude and Codex.",
   "license": "MIT",
   "keywords": [

package/templates/hook/bin/recall-episode-metric.sh

@@ -72,6 +72,33 @@ try {
   const ENVQ=/(포트|유저명|계정|경로|도메인|호스트|엔드포인트|서버\s*주소)[^\n]{0,12}(뭐|몇|어디|알아|기억|였)/;
   const isSignal=(t)=>PAST_TIME.test(t)||PAST_HOW.test(t)||REPRO.test(t)||CONTINUE.test(t)||DECIDED.test(t)||ENVQ.test(t)||AMNESIA.test(t);
 
+  // ── v2 §D2: 교정 발화 (계측 라벨 전용) ────────────────────────────────────
+  // 두목이 "이미 아는 걸 왜 모르냐"고 짚는 발화. **강제 경로(user-prompt-skill-gate.sh)에는 넣지
+  //  않는다** — 넣는 순간 spec 2026-07-25 §7 이 금지한 "9번째 새 트리거 추가"가 된다.
+  //  집합은 오늘 사고 발화 + 오탐 후보로 실측해 확정(교정 9/10 hit, 일반 8/8 미탐지).
+  const CORRECTION=new RegExp([
+    "(저장|기록)(해두지|해놓지|한\\s*거|해\\s*둔\\s*거)?\\s*(않았|안\\s*했|안했)",
+    "기억(하고|해두고|해\\s*두고)\\s*있(잖|었잖)",
+    "(툴|도구)(에|로|에다)\\s*(저장|기록)",
+    "회상(해|해봐|해도|부터|은?\\s*했)",
+    "찾아(봤|보지|봐야)\\s*(않았|았어야|어야)",
+    "더루키(에서|에|를)[^\\n]{0,20}(찾|봐|확인|안\\s*찾|찾지)",
+    "(전에|이미|지난번에?)\\s*[^\\n]{0,10}?(했|됐|만들었|성공했)(잖|었잖)"
+  ].join("|"));
+
+  // ── v2 §D1: human 프롬프트 판정 ──────────────────────────────────────────
+  // 1단 = transcript 의 isMeta 필드(Skill 로드 결과·이미지 첨부·local-command-caveat 를 정확히 거른다).
+  // 2단 = isMeta 가 안 붙는 나머지를 문자열로 배제. 판정 실패는 **포함 방향**(fail-open) —
+  //       human 을 놓치는 것이 분모 결함의 재발이라 그쪽이 더 비싸다.
+  const SYS_PREFIX=/^\s*<(command-name|task-notification|system-reminder|local-command|command-message)/;
+  const isHumanPrompt=(j,txt)=>{
+    if(j && j.isMeta===true) return false;
+    if(SYS_PREFIX.test(txt)) return false;
+    if(/^\s*\[Request interrupted by user/.test(txt)) return false;
+    if(/^\s*\/\S+$/.test(txt)) return false;            // 붙여넣은 파일경로 1줄
+    return true;
+  };
+
   // ── compact/clear boundary offsets (이 transcript 것만, 정렬) ──────────────
   let boundaries=[];
   try {
@@ -138,22 +165,41 @@ try {
     if(role==="user"){
       const txt=userText(m);
       if(!txt) continue;                     // tool_result-only user 라인 등은 프롬프트 아님
-      const sig=isSignal(txt), amn=AMNESIA.test(txt);
-      // 직전 회상 episode 의 "다음 프롬프트"가 기억무시 지적이면 표시(관련 기억 있었는데 되물음).
-      if(cur && amn && cur.recall_called) cur.amnesia_next_prompt=true;
-      if(sig){
-        cur={
-          episode_seq: seq++,
-          episode_start_byte_offset: lineOff,
-          recall_signal: true, recall_called: false, verified_solution_served: false,
-          external_search: false, amnesia_next_prompt: false,
-          first_action_after_recall: null, failure_classes: [],
-          _boundary: firstBoundaryAfter(lineOff),
-          _recallSeen: false,
-        };
-        episodes.push(cur);
+      // v2 §D1 — human 프롬프트만 episode 를 연다. 시스템 주입(Skill 로드·이미지·훅 알림)은 제외.
+      if(!isHumanPrompt(j,txt)) continue;
+      const sig=isSignal(txt), amn=AMNESIA.test(txt), corr=CORRECTION.test(txt);
+
+      // v2 §D3 — 교정 발화 귀속. recall_called 전제를 제거하고(회상 안 한 쪽이 더 나쁜 신호),
+      //  filler episode(도구 0건)는 건너뛰어 실제 작업 episode 에 붙인다. compact 경계는 안 넘는다.
+      if(amn||corr){
+        for(let k=episodes.length-1;k>=0;k--){
+          const e=episodes[k];
+          if(lineOff>=e._boundary) break;    // 이 교정은 e 의 compact 구간 밖 — 더 거슬러 갈 수 없다
+          if(!e._sawTool) continue;          // filler — 책임을 붙이지 않는다
+          if(amn) e.amnesia_next_prompt=true;
+          if(corr) e.correction_next_prompt=true;
+          break;
+        }
       }
-      // 회상 신호 아닌 user 프롬프트는 현재 episode 를 이어간다(별 처리 없음, spec §3.2).
+
+      cur={
+        episode_seq: seq++,
+        episode_start_byte_offset: lineOff,
+        parser_version: 3,
+        is_human_prompt: true,
+        recall_signal: sig, recall_called: false, verified_solution_served: false,
+        external_search: false, amnesia_next_prompt: false, correction_next_prompt: false,
+        // spec 2026-08-06 A.5b — external_search 는 이제 **웹 도구만** 센다.
+        //  external_search_after_recall: 회상 이후의 외부검색만(순서 있는 신호).
+        //  bash_http_seen: 느슨한 Bash HTTP 관측 — 진단 전용, headline 금지.
+        external_search_after_recall: false, bash_http_seen: false,
+        first_action_after_recall: null, failure_classes: [],
+        _boundary: firstBoundaryAfter(lineOff),
+        _recallSeen: false,
+        _sawTool: false,
+        _ts: typeof j.timestamp==="string" ? j.timestamp : null,
+      };
+      episodes.push(cur);
       continue;
     }
 
@@ -166,17 +212,27 @@ try {
         if(b.type==="text" && typeof b.text==="string" && b.text.trim()) hadText=true;
         if(b.type==="tool_use"){
           sawToolThisMsg=true;
+          cur._sawTool=true;              // filler episode 판별용(§D3 귀속에서 건너뛸 대상)
           const name=String(b.name||"");
           const cmd=b.input&&typeof b.input.command==="string"?b.input.command:"";
           let action="other";
           if(/recall/i.test(name) || /api\/rookie\/recall/.test(cmd)) action="recall";
           else if(/^(WebSearch|WebFetch)$/.test(name)) action="external_search";
-          // 외부 Bash HTTP(curl/wget 로 밖에서 답 찾기)도 외부검색 — recall/내부 API·로컬 dev 는 제외(codex P1·P2).
-          else if(name==="Bash" && /\b(curl|wget)\b/.test(cmd) && /https?:\/\//.test(cmd) && !/api\/rookie/.test(cmd) && !/(localhost|127\.0\.0\.1|0\.0\.0\.0)/.test(cmd)) action="external_search";
           else if(/^(Edit|Write|NotebookEdit)$/.test(name)) action="edit";
           else if(name==="AskUserQuestion") action="ask";
+          // spec 2026-08-06 A.5b B-1 — Bash 는 외부검색으로 세지 않는다. 명령문 전체에서 curl|wget 을
+          //  찾던 옛 판정이 heredoc 본문·경로에 그 단어가 든 **로컬 스크립트**까지 외부검색으로 셌다
+          //  (§7 원문 대조: 강 3건 중 2건이 이 오탐). 정확히 세려면 셸 문법을 다시 구현해야 해서 철회했다.
+          //  느슨한 관측은 버리지 않고 **진단 전용 신호로 격리**한다.
+          const bashHttp = name==="Bash" && /\b(curl|wget)\b/.test(cmd) && /https?:\/\//.test(cmd)
+            && !/api\/rookie/.test(cmd) && !/(localhost|127\.0\.0\.1|0\.0\.0\.0)/.test(cmd)
+          if(bashHttp) cur.bash_http_seen=true;
           if(action==="recall"){ cur.recall_called=true; cur._recallSeen=true; }
-          if(action==="external_search"){ cur.external_search=true; }
+          if(action==="external_search"){
+            cur.external_search=true;
+            // B-2 — 첫 행동 기록 여부와 **무관하게** 누적한다(회상 이후의 모든 외부검색).
+            if(cur._recallSeen) cur.external_search_after_recall=true;
+          }
           // recall 이후의 첫 실질 행동을 1회만 기록.
           if(cur._recallSeen && action!=="recall" && cur.first_action_after_recall===null){
             cur.first_action_after_recall=action;
@@ -203,19 +259,58 @@ try {
     if(e.verified_solution_served && e.first_action_after_recall==="external_search")
       fc.push("ignored_verified_solution");
     if(e.recall_called && e.amnesia_next_prompt) fc.push("user_correction_after_memory_available");
+    // v2 §D3 — 교정 발화를 recall 여부로 가른다. 회상조차 안 하고 지적당한 쪽이 더 나쁜 신호다.
+    if(e.correction_next_prompt) fc.push(e.recall_called?"correction_after_recall":"correction_after_no_recall");
     e.failure_classes=fc;
-    delete e._boundary; delete e._recallSeen;
   }
 
-  // route schema 는 max 500 — 긴 세션이 400 으로 전량 드롭되지 않게 최근 500 episode 만 보낸다(codex P2).
-  process.stdout.write(JSON.stringify(episodes.slice(-500)));
-} catch { process.stdout.write("[]"); }
+  // ── v2 §D6: 활성 시각 컷오프 ─────────────────────────────────────────────
+  // 파서는 매 Stop 마다 transcript 를 처음부터 재파싱한다. 컷오프가 없으면 배포 후 살아 있는
+  //  옛 세션이 **배포 이전 발화까지** v2 행으로 적재해 "v2 = 배포 후" 전제가 깨진다.
+  //  활성 시각은 첫 v2 실행 때 한 번만 기록(wx = 원자적, 이미 있으면 유지).
+  // ⚠️ **기록에 성공한 시각만 채택한다.** 메모리상의 "지금"을 쓰면 매 Stop 마다 컷오프가
+  //    앞으로 밀려(불안정) 무엇이 왜 빠졌는지 사후 확인이 불가능해진다.
+  let activatedAt=null;
+  try{
+    const ap=path.join(bndDir,".v3-activated");
+    const readAct=()=>{ try{ const v=JSON.parse(fs.readFileSync(ap,"utf8")).activated_at; return typeof v==="string"?v:null; }catch{ return null; } };
+    activatedAt=readAct();
+    if(!activatedAt){
+      const now=new Date().toISOString();
+      try{
+        fs.mkdirSync(bndDir,{recursive:true,mode:0o700});
+        fs.writeFileSync(ap,JSON.stringify({activated_at:now}),{flag:"wx",mode:0o600});
+        activatedAt=now;
+      }catch{ activatedAt=readAct(); }   // 경쟁(형제가 먼저 만듦)이면 그 값. 손상·쓰기불가면 null.
+    }
+  }catch{}
+  // timestamp 없는/파싱 불가 개시 라인은 **제외**(fail-closed). D1 의 human 판정과 방향이 반대인데
+  //  의도적이다 — 저기서는 분모 누락이, 여기서는 baseline 오염이 위험이다.
+  //  비교는 문자열이 아니라 epoch ms 로 한다(codex 코드검토 R1 P2): transcript timestamp 는
+  //  ms 유무·offset 표기가 섞일 수 있어 문자열 대소 비교가 경계에서 틀린다.
+  const actMs = activatedAt ? Date.parse(activatedAt) : NaN;
+  // 활성 시각을 세우지 못하면(파일 IO·JSON 오류) 전량 emit 하지 않는다 — 컷오프 없는 emit 은
+  //  배포 이전 발화를 v2 baseline 에 섞는 것이라 계측 목적 자체를 깬다(fail-closed).
+  const emitted = Number.isFinite(actMs)
+    ? episodes.filter(e=>{ const t=typeof e._ts==="string"?Date.parse(e._ts):NaN; return Number.isFinite(t) && t>=actMs; })
+    : [];
+  for(const e of emitted){ delete e._boundary; delete e._recallSeen; delete e._sawTool; delete e._ts; }
+
+  // route schema 는 max 500 — 긴 세션이 400 으로 전량 드롭되지 않게 최근 500 만 보낸다(codex P2).
+  //  버린 개수를 함께 실어 조용한 절단을 관측 가능하게 만든다(§D1).
+  const truncated = Math.max(0, emitted.length-500);
+  process.stdout.write(JSON.stringify({episodes:emitted.slice(-500), truncated_count:truncated}));
+} catch { process.stdout.write("{\"episodes\":[],\"truncated_count\":0}"); }
 ' 2>/dev/null)
 
 [ -z "$EPISODES" ] && exit 0
-[ "$EPISODES" = "[]" ] && exit 0
 
-BODY=$(ROOKIE_SID="$SESSION_ID" ROOKIE_EP="$EPISODES" node -e 'try{process.stdout.write(JSON.stringify({session_id:process.env.ROOKIE_SID,episodes:JSON.parse(process.env.ROOKIE_EP)}))}catch{}' 2>/dev/null)
+# 파서는 {episodes, truncated_count} 를 낸다(v2). episode 0건이면 보낼 것이 없다.
+BODY=$(ROOKIE_SID="$SESSION_ID" ROOKIE_EP="$EPISODES" node -e 'try{
+  const p=JSON.parse(process.env.ROOKIE_EP);
+  if(!p||!Array.isArray(p.episodes)||p.episodes.length===0) process.exit(0);
+  process.stdout.write(JSON.stringify({session_id:process.env.ROOKIE_SID,episodes:p.episodes,truncated_count:p.truncated_count||0}));
+}catch{}' 2>/dev/null)
 [ -z "$BODY" ] && exit 0
 
 # 계측 POST — 세션 종료를 지연시키지 않게 background + fail-soft.

package/version.json

@@ -1,4 +1,4 @@
 {
-  "cli_version": "0.4.13",
-  "skill_version": "1.34.0"
+  "cli_version": "0.4.15",
+  "skill_version": "1.35.0"
 }