therookie 0.4.14 → 0.4.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "therookie",
-  "version": "0.4.14",
+  "version": "0.4.16",
   "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/src/commands/update.js

@@ -143,6 +143,13 @@ export async function runUpdate(flags) {
   )
   chmodSync(join(pretoolBinDir, 'recall-episode-metric.sh'), 0o755)
 
+  // spec 2026-08-08 무조건 회상 푸시 — UserPromptSubmit 매 발화 무조건 질의 + 임계 push 주입.
+  cpSync(
+    join(TEMPLATES, 'hook', 'bin', 'recall-push.sh'),
+    join(pretoolBinDir, 'recall-push.sh')
+  )
+  chmodSync(join(pretoolBinDir, 'recall-push.sh'), 0o755)
+
   const libDir = join(binDir, 'lib')
   mkdirSync(libDir, { recursive: true })
   cpSync(join(TEMPLATES, 'hook', 'lib', 'queue.sh'), join(libDir, 'queue.sh'))
@@ -176,6 +183,7 @@ export async function runUpdate(flags) {
     skillGateCmd: claudeHookCommand(join(binDir, 'user-prompt-skill-gate.sh')),
     workRecallGateCmd: claudeHookCommand(join(pretoolBinDir, 'work-recall-gate.sh')),
     recallEpisodeMetricCmd: claudeHookCommand(join(pretoolBinDir, 'recall-episode-metric.sh')),
+    recallPushCmd: claudeHookCommand(join(pretoolBinDir, 'recall-push.sh')),
   })
 
   // v6 P0b — 글로벌 SKILL.md 갱신 (backup-and-overwrite). 같은 본문이면 no-op.
@@ -223,6 +231,7 @@ async function mergeSettings(settingsPath, partialPath, subs) {
     .replaceAll('__GUARD_DESTRUCTIVE_DB_CMD__', escapeJsonStringValue(subs.guardCmd))
     .replaceAll('__USER_PROMPT_SKILL_GATE_CMD__', escapeJsonStringValue(subs.skillGateCmd))
     .replaceAll('__WORK_RECALL_GATE_CMD__', escapeJsonStringValue(subs.workRecallGateCmd))
+    .replaceAll('__RECALL_PUSH_CMD__', escapeJsonStringValue(subs.recallPushCmd))
   const partial = JSON.parse(partialRaw)
 
   let current = {}

package/src/lib/deploy-artifacts.js

@@ -73,6 +73,13 @@ export function installSharedHookRuntime({ scope, home, cwd } = {}) {
   )
   chmodSync(join(pretoolBinDir, 'recall-episode-metric.sh'), 0o755)
 
+  // spec 2026-08-08 무조건 회상 푸시 — UserPromptSubmit 매 발화 무조건 질의 + 임계 push 주입.
+  cpSync(
+    join(TEMPLATES, 'hook', 'bin', 'recall-push.sh'),
+    join(pretoolBinDir, 'recall-push.sh')
+  )
+  chmodSync(join(pretoolBinDir, 'recall-push.sh'), 0o755)
+
   // spec post-v5-decisions §17 — hook offline queue 라이브러리 배포
   const libDir = join(binDir, 'lib')
   mkdirSync(libDir, { recursive: true })
@@ -129,6 +136,7 @@ export async function applyClaudeSetup({ scope, cfg, home, cwd } = {}) {
     skillGateCmd: claudeHookCommand(join(binDir, 'user-prompt-skill-gate.sh')),
     workRecallGateCmd: claudeHookCommand(join(pretoolBinDir, 'work-recall-gate.sh')),
     recallEpisodeMetricCmd: claudeHookCommand(join(pretoolBinDir, 'recall-episode-metric.sh')),
+    recallPushCmd: claudeHookCommand(join(pretoolBinDir, 'recall-push.sh')),
   })
 
   // §18 U-3 — 클라이언트 manifest 저장. 다음 hook turn 부터 미스매치 경고 비교 가능.
@@ -187,6 +195,7 @@ async function mergeSettings(settingsPath, partialPath, subs) {
     .replaceAll('__GUARD_DESTRUCTIVE_DB_CMD__', escapeJsonStringValue(subs.guardCmd))
     .replaceAll('__USER_PROMPT_SKILL_GATE_CMD__', escapeJsonStringValue(subs.skillGateCmd))
     .replaceAll('__WORK_RECALL_GATE_CMD__', escapeJsonStringValue(subs.workRecallGateCmd))
+    .replaceAll('__RECALL_PUSH_CMD__', escapeJsonStringValue(subs.recallPushCmd))
   const partial = JSON.parse(partialRaw)
 
   let current = {}

package/src/lib/merge-hooks.js

@@ -8,7 +8,7 @@
 // refresh-context.sh 포함 — 과거 UserPromptSubmit 로 실배포됐던 legacy hook.
 // 마커 소실 구버전 설정에서 이를 보존하면 매 turn 대용량 주입 회귀가 남는다(codex R3-P1).
 export const ROOKIE_HOOK_SCRIPTS =
-  /[\\/]\.rookie[\\/]bin[\\/](?:bin[\\/])?(?:flush-session|session-start|user-prompt-skill-gate|guard-destructive-db|pretool-md-read|posttool-recall-nudge|work-recall-gate|recall-episode-metric|sweep-recovery|refresh-context)\.sh\b/
+  /[\\/]\.rookie[\\/]bin[\\/](?:bin[\\/])?(?:flush-session|session-start|user-prompt-skill-gate|guard-destructive-db|pretool-md-read|posttool-recall-nudge|work-recall-gate|recall-episode-metric|recall-push|sweep-recovery|refresh-context)\.sh\b/
 
 export function isRookieEntry(entry) {
   if (!entry || typeof entry !== 'object') return false

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

@@ -185,10 +185,14 @@ try {
       cur={
         episode_seq: seq++,
         episode_start_byte_offset: lineOff,
-        parser_version: 2,
+        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,
@@ -214,12 +218,21 @@ try {
           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;
@@ -259,7 +272,7 @@ try {
   //    앞으로 밀려(불안정) 무엇이 왜 빠졌는지 사후 확인이 불가능해진다.
   let activatedAt=null;
   try{
-    const ap=path.join(bndDir,".v2-activated");
+    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){

package/templates/hook/bin/recall-push.sh

@@ -0,0 +1,114 @@
+#!/bin/bash
+# UserPromptSubmit hook — 무조건 회상 푸시 (unconditional recall push).
+# 설계: docs/superpowers/specs/2026-08-08-unconditional-recall-push-design.md
+#
+# - 발동 조건 없음(E1 결정 제거): 매 사용자 발화를 그대로 recall 질의로 던진다. 빈 발화만 skip —
+#   길이 하한·낱말 필터는 결정의 재도입이라 두지 않는다(§1.1).
+# - hit(THRESH 이상 상위 K)만 additionalContext 로 그 턴의 생성 컨텍스트에 주입(E2). 무-hit → 0바이트.
+# - THRESH 기본 0.0165 = rrf k=60 단일 신호 최대치 1/61 바로 위 — "FTS·벡터 두 신호가 합의한
+#   결과만 주입"이라는 기계적 의미(worklog §96 분포 실측). 모델 판단·어휘 패턴 매칭이 아니다.
+# - 세션 dedup: 같은 기억 id 는 세션당 1회. /clear·compact 는 skill-gate <key>.epoch 값 변화로
+#   감지해 리셋한다(컨텍스트가 비워졌으니 재주입이 옳다).
+# - fail-soft: 타임아웃(늦으면 그 턴 무주입)·네트워크·파싱 실패 전부 조용히 무주입 종료.
+#   아무것도 막지 않는다 — deny 0, 기존 user-prompt-skill-gate.sh 불변.
+set -u
+
+# self-reference 방지: internal LLM 호출(claude -p)에서 발사된 hook 은 즉시 종료.
+[ "${ROOKIE_INTERNAL_INVOCATION:-}" = "1" ] && exit 0
+command -v node >/dev/null 2>&1 || exit 0
+
+INPUT=$(cat 2>/dev/null) || exit 0
+[ -z "$INPUT" ] && exit 0
+
+# config 해석 (env > 프로젝트-로컬 > 전역) — B6. 배포 위치는 ~/.rookie/bin/bin/ 이라 ../lib.
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [ -f "$SCRIPT_DIR/../lib/config-resolve.sh" ]; then
+  # shellcheck source=/dev/null
+  . "$SCRIPT_DIR/../lib/config-resolve.sh"
+elif [ -f "$HOME/.rookie/bin/lib/config-resolve.sh" ]; then
+  # shellcheck source=/dev/null
+  . "$HOME/.rookie/bin/lib/config-resolve.sh"
+fi
+command -v rookie_resolve_credentials >/dev/null 2>&1 || exit 0
+rookie_resolve_credentials "$PWD" || exit 0
+[ -n "$ROOKIE_RESOLVED_TOKEN" ] || exit 0
+
+PUSH_DIR="${ROOKIE_RECALL_PUSH_DIR:-$HOME/.rookie/recall-push}"
+GATE_DIR="${ROOKIE_SKILL_GATE_DIR:-$HOME/.rookie/skill-gate}"
+HOST_VAL="$(hostname 2>/dev/null || echo "")"
+
+# payload 는 stdin 으로(ARG_MAX 회피). 질의·필터·dedup·주입 결정 전부 node 한 덩어리 —
+# code 안에 작은따옴표 미사용(bash single-quote 보호).
+printf '%s' "$INPUT" | \
+  ROOKIE_PUSH_DIR="$PUSH_DIR" ROOKIE_GATE_DIR="$GATE_DIR" \
+  ROOKIE_EP="$ROOKIE_RESOLVED_ENDPOINT" ROOKIE_TK="$ROOKIE_RESOLVED_TOKEN" \
+  ROOKIE_HOST="$HOST_VAL" ROOKIE_CWD="$PWD" node -e '
+let d="";
+process.stdin.on("data",c=>d+=c).on("end",async()=>{
+  try{
+    const fs=require("fs"),path=require("path"),crypto=require("crypto");
+    const p=JSON.parse(d);
+    const sid=String(p.session_id||p.sessionId||"");
+    let prompt=String(p.prompt||"").trim();
+    if(!prompt) return;                       // 빈 발화 = 질의 불성립(유일한 기계 조건)
+    prompt=prompt.slice(0,500);               // RecallQuerySchema q max(500) — 초과는 400 무주입(R1 P1)
+    const THRESH=Number(process.env.ROOKIE_RECALL_PUSH_THRESH||"0.0165");
+    const K=parseInt(process.env.ROOKIE_RECALL_PUSH_TOPK||"3",10);
+    const CAP=parseInt(process.env.ROOKIE_RECALL_PUSH_CAP||"1200",10);
+    const TIMEOUT=parseInt(process.env.ROOKIE_RECALL_PUSH_TIMEOUT_MS||"3500",10);
+
+    // 세션 dedup 상태 — epoch(skill-gate 기록) 가 바뀌었으면 /clear·compact 경계로 보고 리셋.
+    const key=sid?crypto.createHash("sha256").update(sid).digest("hex"):"";
+    let epoch="";
+    if(key){ try{ epoch=String(fs.readFileSync(path.join(process.env.ROOKIE_GATE_DIR,key+".epoch"),"utf8")).trim(); }catch{} }
+    const stFile=key?path.join(process.env.ROOKIE_PUSH_DIR,key+".injected"):null;
+    let st={epoch,ids:[]};
+    if(stFile){ try{ const j=JSON.parse(fs.readFileSync(stFile,"utf8")); if(j&&j.epoch===epoch&&Array.isArray(j.ids)) st=j; }catch{} }
+    const seen=new Set(st.ids);
+
+    // 무조건 질의 — scope=all(현 구현상 project boost 없음, R1 P2).
+    // x-rookie-hostname + repo_path 동시 전달 = workspace 격리 기억 가시성 계약(R2 P2, fail-closed).
+    const u=new URL("/api/rookie/recall",process.env.ROOKIE_EP);
+    u.searchParams.set("q",prompt);
+    u.searchParams.set("scope","all");
+    u.searchParams.set("limit","5");
+    if(process.env.ROOKIE_CWD) u.searchParams.set("repo_path",process.env.ROOKIE_CWD);
+    const res=await fetch(u,{
+      headers:{Authorization:"Bearer "+process.env.ROOKIE_TK,"x-rookie-hostname":process.env.ROOKIE_HOST||""},
+      signal:AbortSignal.timeout(TIMEOUT)
+    });
+    if(!res.ok) return;
+    const body=await res.json();
+    const results=Array.isArray(body&&body.results)?body.results:[];
+    const cands=results
+      .filter(r=>r&&typeof r.relevance==="number"&&r.relevance>=THRESH&&r.id&&typeof r.summary==="string"&&r.summary.trim()&&!seen.has(r.id))
+      .sort((a,b)=>b.relevance-a.relevance)
+      .slice(0,K);
+    if(!cands.length) return;                 // 무-hit(또는 전부 기주입) → 0바이트
+
+    // 주입 문구는 지시가 아니라 자료다(§3.2) — 요약 + 시각 + 출처 프로젝트(전역이면 명시).
+    const MARK=["①","②","③","④","⑤"];
+    let msg="🧠 관련 기억:";
+    const used=[];
+    for(let i=0;i<cands.length;i++){
+      const r=cands[i];
+      const when=r.memory_at?String(r.memory_at).slice(0,10):"시각 미상";
+      const src=r.project_name?String(r.project_name):"전역";
+      const summary=String(r.summary).replace(/\s+/g," ").trim().slice(0,400);
+      const item="\n"+(MARK[i]||"-")+" "+summary+" ("+when+", "+src+")";
+      if(msg.length+item.length>CAP) break;   // 총량 상한 — relevance 순 절삭
+      msg+=item; used.push(r.id);
+    }
+    if(!used.length) return;
+    if(stFile){
+      try{
+        fs.mkdirSync(process.env.ROOKIE_PUSH_DIR,{recursive:true,mode:0o700});
+        fs.writeFileSync(stFile,JSON.stringify({epoch,ids:st.ids.concat(used)}),{mode:0o600});
+      }catch{}                                // dedup 기록 실패 → 다음 턴 중복 주입 위험만, 주입은 진행
+    }
+    process.stdout.write(JSON.stringify({hookSpecificOutput:{hookEventName:"UserPromptSubmit",additionalContext:msg}}));
+  }catch{ /* fail-soft — 조용히 무주입 */ }
+});
+' 2>/dev/null
+
+exit 0

package/templates/hook/settings.partial.json

@@ -69,7 +69,8 @@
       {
         "__rookie_managed": true,
         "hooks": [
-          { "type": "command", "command": "__USER_PROMPT_SKILL_GATE_CMD__", "timeout": 3 }
+          { "type": "command", "command": "__USER_PROMPT_SKILL_GATE_CMD__", "timeout": 3 },
+          { "type": "command", "command": "__RECALL_PUSH_CMD__", "timeout": 5 }
         ]
       }
     ]

package/version.json

@@ -1,4 +1,4 @@
 {
-  "cli_version": "0.4.14",
+  "cli_version": "0.4.16",
   "skill_version": "1.35.0"
 }