therookie 0.4.3

package/templates/hook/lib/queue.sh

@@ -0,0 +1,314 @@
+#!/bin/bash
+# Rookie hook offline queue 라이브러리
+# spec: docs/superpowers/specs/2026-04-23-post-v5-decisions.md §17
+# plan: docs/superpowers/plans/2026-04-30-hook-offline-queue.md
+#
+# 함수:
+#   queue_dir_init                            큐 디렉토리 자동 생성 + 권한 강제
+#   queue_enqueue <session_id> <body> [code]  큐에 1줄 append
+#   queue_count                               큐 라인 합계
+#   queue_oldest_age_seconds                  가장 오래된 항목 경과 초
+#   queue_drain <endpoint> <token> <user_id>  큐 batch POST → 200 시 파일 삭제
+#   queue_record_success                      마지막 성공 시각 기록
+#   last_success_minutes_ago                  마지막 성공 후 경과 분 (없으면 -1)
+#   queue_warning_prefix <minutes> <count>    두목 경고 메시지 출력
+
+ROOKIE_QUEUE_DIR="${ROOKIE_QUEUE_DIR:-$HOME/.rookie/pending}"
+ROOKIE_DEAD_LETTER_DIR="${ROOKIE_DEAD_LETTER_DIR:-$HOME/.rookie/dead-letter}"
+ROOKIE_LAST_SUCCESS_FILE="${ROOKIE_LAST_SUCCESS_FILE:-$HOME/.rookie/last_success}"
+# spec post-v5-decisions §24 Q-1: 영구 실패 항목 dead-letter 격리.
+# hook 발사 분당 1 미만 → 50회 재시도면 ~50분~수 시간. 그 이상은 재시도 가치 없음.
+ROOKIE_QUEUE_RETRY_CAP="${ROOKIE_QUEUE_RETRY_CAP:-50}"
+
+queue_dir_init() {
+  if [ ! -d "$ROOKIE_QUEUE_DIR" ]; then
+    mkdir -m 700 -p "$ROOKIE_QUEUE_DIR" 2>/dev/null
+  else
+    chmod 700 "$ROOKIE_QUEUE_DIR" 2>/dev/null
+  fi
+}
+
+dead_letter_dir_init() {
+  if [ ! -d "$ROOKIE_DEAD_LETTER_DIR" ]; then
+    mkdir -m 700 -p "$ROOKIE_DEAD_LETTER_DIR" 2>/dev/null
+  else
+    chmod 700 "$ROOKIE_DEAD_LETTER_DIR" 2>/dev/null
+  fi
+}
+
+dead_letter_count() {
+  if ! compgen -G "$ROOKIE_DEAD_LETTER_DIR/*.jsonl" > /dev/null 2>&1; then
+    echo 0
+    return
+  fi
+  local n
+  n=$(cat "$ROOKIE_DEAD_LETTER_DIR"/*.jsonl 2>/dev/null | grep -c '.' 2>/dev/null) || n=0
+  echo "${n:-0}" | tr -d ' '
+}
+
+queue_enqueue() {
+  local session_id="$1"
+  local body="$2"
+  local code="${3:-}"
+  [ -z "$session_id" ] && return 1
+  [ -z "$body" ] && return 1
+  queue_dir_init
+  local file="$ROOKIE_QUEUE_DIR/$session_id.jsonl"
+  local line
+  line=$(node -e "
+    try {
+      const body = JSON.parse(process.argv[1]);
+      body.queued_at = new Date().toISOString();
+      body.retry_count = 0;
+      body.last_error_status = process.argv[2] || null;
+      process.stdout.write(JSON.stringify(body));
+    } catch (e) {
+      process.exit(1);
+    }
+  " "$body" "$code" 2>/dev/null) || return 1
+  (umask 077; printf '%s\n' "$line" >> "$file") || return 1
+  chmod 600 "$file" 2>/dev/null
+  return 0
+}
+
+queue_count() {
+  if ! compgen -G "$ROOKIE_QUEUE_DIR/*.jsonl" > /dev/null 2>&1; then
+    echo 0
+    return
+  fi
+  local n
+  n=$(cat "$ROOKIE_QUEUE_DIR"/*.jsonl 2>/dev/null | grep -c '.' 2>/dev/null) || n=0
+  echo "${n:-0}" | tr -d ' '
+}
+
+queue_oldest_age_seconds() {
+  if ! compgen -G "$ROOKIE_QUEUE_DIR/*.jsonl" > /dev/null 2>&1; then
+    echo 0
+    return
+  fi
+  node -e "
+    const fs=require('fs'), path=require('path');
+    const dir = process.argv[1];
+    let oldest = null;
+    try {
+      for (const f of fs.readdirSync(dir).filter(x => x.endsWith('.jsonl'))) {
+        const data = fs.readFileSync(path.join(dir, f), 'utf8');
+        for (const line of data.split('\n').filter(Boolean)) {
+          try {
+            const obj = JSON.parse(line);
+            const t = Date.parse(obj.queued_at);
+            if (!isNaN(t) && (oldest === null || t < oldest)) oldest = t;
+          } catch {}
+        }
+      }
+    } catch {}
+    process.stdout.write(oldest === null ? '0' : String(Math.max(0, Math.floor((Date.now() - oldest) / 1000))));
+  " "$ROOKIE_QUEUE_DIR" 2>/dev/null || echo 0
+}
+
+# 내부: 파일 내 모든 라인의 retry_count++ + last_error_status 갱신.
+# spec §24 Q-1: retry_count >= cap 라인은 dead-letter 디렉토리로 이동 (영구 실패 격리).
+# 라인 단위 분리: 일부 라인만 cap 초과면 그 라인만 옮기고 나머지는 pending 잔류.
+_queue_increment_retry() {
+  local file="$1"
+  local code="$2"
+  local cap="${ROOKIE_QUEUE_RETRY_CAP:-50}"
+  dead_letter_dir_init
+  local dead_file="$ROOKIE_DEAD_LETTER_DIR/$(basename "$file")"
+  node -e "
+    const fs=require('fs');
+    const file=process.argv[1];
+    const code=process.argv[2] || null;
+    const cap=parseInt(process.argv[3] || '50', 10);
+    const deadFile=process.argv[4];
+    try {
+      const data=fs.readFileSync(file,'utf8');
+      const keep = [];
+      const dead = [];
+      for (const line of data.split('\n').filter(Boolean)) {
+        try {
+          const obj=JSON.parse(line);
+          obj.retry_count = (obj.retry_count || 0) + 1;
+          obj.last_error_status = code;
+          if (obj.retry_count >= cap) {
+            obj.dead_letter_at = new Date().toISOString();
+            dead.push(JSON.stringify(obj));
+          } else {
+            keep.push(JSON.stringify(obj));
+          }
+        } catch { keep.push(line); }
+      }
+      if (keep.length === 0) {
+        try { fs.unlinkSync(file); } catch {}
+      } else {
+        fs.writeFileSync(file, keep.join('\n') + '\n', { mode: 0o600 });
+      }
+      if (dead.length > 0) {
+        let prev = '';
+        try { prev = fs.readFileSync(deadFile, 'utf8'); } catch {}
+        const next = (prev ? prev.replace(/\n*$/, '\n') : '') + dead.join('\n') + '\n';
+        fs.writeFileSync(deadFile, next, { mode: 0o600 });
+      }
+    } catch {}
+  " "$file" "$code" "$cap" "$dead_file" 2>/dev/null || true
+}
+
+# spec 2026-06-18 §3.2 marker 경로 2 — flush 큐 파일 전체 성공 후 flushed marker(source=queue).
+# orphan-recovery.sh 가 source 됐을 때만(hook 컨텍스트) 동작. standalone queue 사용엔 no-op.
+# - mutate 류(*-mutate / *-mutate-retry) 는 flush marker 미생성.
+# - basename ≠ body session_id → 미생성 + telemetry (3차 P2-1).
+# - P2 (2026-06-24 audit): marker 조건 = body message_count>0 (chunks_inserted 무관). orphan 경로와 통일 —
+#   멱등 replay(chunks 0)도 marker 박아 큐는 비웠는데 orphan/sweep scanner 가 같은 transcript 를 재후보화하는 비대칭 차단.
+_queue_maybe_mark_flushed() {
+  local file="$1" body_mc="$2" sid_mismatch="$3"
+  command -v orphan_mark_flushed >/dev/null 2>&1 || return 0
+  local base="${file##*/}"
+  base="${base%.jsonl}"
+  case "$base" in
+    *-mutate|*-mutate-retry) return 0 ;;
+  esac
+  # P2: 파일 내 한 line 이라도 basename 과 session_id 불일치면 marker 미생성 + telemetry.
+  if [ "$sid_mismatch" = "1" ]; then
+    if command -v _orphan_log_telemetry >/dev/null 2>&1; then
+      _orphan_log_telemetry "$base" "queue_marker_skip_sid_mismatch"
+    fi
+    return 0
+  fi
+  if [ "${body_mc:-0}" -gt 0 ] 2>/dev/null; then
+    orphan_mark_flushed "$base" "queue" "${body_mc:-0}" || true
+  fi
+  return 0
+}
+
+queue_drain() {
+  local endpoint="$1"
+  local token="$2"
+  local user_id="$3"
+  [ -z "$endpoint" ] && return 1
+  [ -z "$token" ] && return 1
+  if ! compgen -G "$ROOKIE_QUEUE_DIR/*.jsonl" > /dev/null 2>&1; then
+    return 0
+  fi
+  local total_success=0
+  local total_failure=0
+  for file in "$ROOKIE_QUEUE_DIR"/*.jsonl; do
+    [ -f "$file" ] || continue
+    local file_failed=0
+    local last_code="000"
+    local last_body_mc file_sid_mismatch base
+    last_body_mc=0
+    file_sid_mismatch=0
+    base="${file##*/}"; base="${base%.jsonl}"
+    local target_endpoint
+    # spec post-v5-decisions §17.2 H-2.2 — *-mutate-retry.jsonl 도 batch-mutate 로 라우팅.
+    case "$(basename "$file")" in
+      *-mutate.jsonl|*-mutate-retry.jsonl) target_endpoint="$endpoint/api/rookie/batch-mutate" ;;
+      *)                                   target_endpoint="$endpoint/api/rookie/flush-session" ;;
+    esac
+    while IFS= read -r line; do
+      [ -z "$line" ] && continue
+      local body
+      body=$(node -e "
+        try {
+          const obj = JSON.parse(process.argv[1]);
+          delete obj.queued_at;
+          delete obj.retry_count;
+          delete obj.last_error_status;
+          process.stdout.write(JSON.stringify(obj));
+        } catch (e) { process.exit(1); }
+      " "$line" 2>/dev/null) || { file_failed=1; break; }
+      local code
+      # spec 2026-07-06 §F-1 — x-rookie-hostname 전송(세션 project repo_path 매칭). drain 은
+      #   origin 호스트에서 실행되므로 $(hostname) == enqueue 시점 호스트.
+      code=$(curl -sS --max-time 10 -o /dev/null -w "%{http_code}" \
+        -X POST \
+        -H "Authorization: Bearer $token" \
+        -H "Content-Type: application/json" \
+        -H "x-rookie-user-id: $user_id" \
+        -H "x-rookie-hostname: $(hostname)" \
+        -d "$body" \
+        "$target_endpoint" 2>/dev/null) || code="000"
+      last_code="$code"
+      if [ "$code" = "200" ]; then
+        total_success=$((total_success + 1))
+        # spec 2026-06-18 §3.2 (P2): 파일의 **모든** line body session_id 를 basename 과 대조.
+        # 한 line 이라도 불일치하면 marker 미생성 — 마지막 line 만 보던 누락 차단.
+        local body_sid
+        body_sid=$(printf '%s' "$body" | node -e "
+          let d='';process.stdin.on('data',c=>d+=c).on('end',()=>{
+            try{const j=JSON.parse(d);process.stdout.write(String(j.session_id||''));}catch{process.stdout.write('');}});
+        " 2>/dev/null || echo "")
+        if [ -n "$body_sid" ] && [ "$body_sid" != "$base" ]; then file_sid_mismatch=1; fi
+        last_body_mc=$(printf '%s' "$body" | node -e "
+          let d='';process.stdin.on('data',c=>d+=c).on('end',()=>{
+            try{const j=JSON.parse(d);process.stdout.write(String(Array.isArray(j.messages)?j.messages.length:0));}catch{process.stdout.write('0');}});
+        " 2>/dev/null || echo 0)
+      else
+        file_failed=1
+        total_failure=$((total_failure + 1))
+        break
+      fi
+    done < "$file"
+    if [ "$file_failed" = "0" ]; then
+      # spec 2026-06-18 §3.2 marker 경로 2 — flush 큐 파일 전체 성공 시 flushed marker(source=queue).
+      _queue_maybe_mark_flushed "$file" "$last_body_mc" "$file_sid_mismatch"
+      rm -f "$file"
+    else
+      _queue_increment_retry "$file" "$last_code"
+    fi
+  done
+  printf '%d %d\n' "$total_success" "$total_failure"
+}
+
+queue_record_success() {
+  (umask 077; date -u +"%Y-%m-%dT%H:%M:%SZ" > "$ROOKIE_LAST_SUCCESS_FILE" 2>/dev/null) || true
+  chmod 600 "$ROOKIE_LAST_SUCCESS_FILE" 2>/dev/null
+}
+
+last_success_minutes_ago() {
+  if [ ! -f "$ROOKIE_LAST_SUCCESS_FILE" ]; then
+    echo "-1"
+    return
+  fi
+  local last
+  last=$(cat "$ROOKIE_LAST_SUCCESS_FILE" 2>/dev/null)
+  if [ -z "$last" ]; then
+    echo "-1"
+    return
+  fi
+  node -e "
+    const last = process.argv[1];
+    const t = Date.parse(last);
+    if (isNaN(t)) { process.stdout.write('-1'); }
+    else process.stdout.write(String(Math.max(0, Math.floor((Date.now() - t) / 60000))));
+  " "$last" 2>/dev/null || echo "-1"
+}
+
+queue_warning_prefix() {
+  local mins="$1"
+  local count="$2"
+  local mins_str
+  if [ "$mins" = "-1" ]; then
+    mins_str="이력 없음"
+  else
+    mins_str="${mins}분 전"
+  fi
+  # spec post-v5-decisions §17.2 H-3 (2026-05-05 v6 P1 #3 보강) — 큐 카운트를 endpoint 별로 분리.
+  # mutate=*-mutate.jsonl / retry=*-mutate-retry.jsonl / flush=그 외
+  local mutate_n=0 retry_n=0 flush_n=0
+  if compgen -G "$ROOKIE_QUEUE_DIR/*.jsonl" > /dev/null 2>&1; then
+    local f base
+    for f in "$ROOKIE_QUEUE_DIR"/*.jsonl; do
+      [ -f "$f" ] || continue
+      base=$(basename "$f")
+      case "$base" in
+        *-mutate-retry.jsonl) retry_n=$((retry_n + 1)) ;;
+        *-mutate.jsonl)       mutate_n=$((mutate_n + 1)) ;;
+        *)                    flush_n=$((flush_n + 1)) ;;
+      esac
+    done
+  fi
+  printf '⚠️ Rookie 서버 도달 실패 (마지막 성공 %s / 큐 %s건: mutate=%d retry=%d flush=%d).\n' \
+    "$mins_str" "$count" "$mutate_n" "$retry_n" "$flush_n"
+  printf '   네트워크·tailscale·:3000 상태 확인 필요. 작업은 로컬 큐에 적재 중.\n'
+}

package/templates/hook/lib/skill-gate.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+# lib/skill-gate.sh — skill-gate marker/epoch 공용 헬퍼.
+# 설계: docs/superpowers/plans/2026-06-24-sessionstart-skill-load-enforcement.md §3.3·§3.4
+# session-start.sh 가 source 해서 /clear·compact 시 epoch 기록에 쓴다.
+# marker 키 = sha256(session_id) — path traversal 방어 + 모든 session_id 형식에서 작동.
+
+skill_gate_dir() { printf '%s' "${ROOKIE_SKILL_GATE_DIR:-$HOME/.rookie/skill-gate}"; }
+
+# sha256(session_id) hex. 빈 입력이면 빈 문자열.
+skill_gate_key() {
+  [ -n "${1:-}" ] || { printf ''; return 0; }
+  printf '%s' "$1" | node -e 'let d="";process.stdin.on("data",c=>d+=c).on("end",()=>{try{process.stdout.write(require("crypto").createHash("sha256").update(d).digest("hex"))}catch{}})' 2>/dev/null
+}
+
+# /clear·compact 경계: 현재 transcript byte size 를 <key>.epoch 로 기록 + <key>.loaded marker 삭제.
+# 이후 UserPromptSubmit gate 는 그 offset 이후만 scan → 과거 Skill 호출을 현재 로드로 오인하지 않는다.
+skill_gate_record_epoch() {
+  local sid="${1:-}" tpath="${2:-}" dir key size
+  [ -n "$sid" ] && [ -n "$tpath" ] || return 0
+  dir="$(skill_gate_dir)"
+  key="$(skill_gate_key "$sid")"
+  [ -n "$key" ] || return 0
+  size=$(node -e 'try{process.stdout.write(String(require("fs").statSync(process.argv[1]).size))}catch{process.stdout.write("0")}' "$tpath" 2>/dev/null)
+  mkdir -p "$dir" 2>/dev/null
+  printf '%s' "${size:-0}" > "$dir/$key.epoch" 2>/dev/null
+  rm -f "$dir/$key.loaded" 2>/dev/null
+  return 0
+}

package/templates/hook/lib/transcript.sh

@@ -0,0 +1,166 @@
+#!/bin/bash
+# lib/transcript.sh — Claude Code transcript(.jsonl) 변환 공유 helper.
+# spec docs/superpowers/specs/2026-06-18-crash-recovery-orphan-flush.md §3.8 (재리뷰 P2-3):
+#   flush-session.sh 와 session-start.sh(orphan recovery) 가 동일 추출 구현을 쓰도록 단일화.
+#   추출 로직은 flush-session.sh §27 D-Multimac-1 / turn limit 200 (D-Multimac-3) 에서 이관.
+#
+# 함수:
+#   transcript_messages_json <path>        messages[] JSON (user/assistant text, turn≤200)
+#   transcript_has_self_reference <path>   exit 0 if fact-추출 마커 있음, 1 if 없음
+#   transcript_session_id_from_path <path> basename 에서 .jsonl 제거한 session_id
+
+# jsonl → messages[] JSON. 없는 파일/빈 파일 → '[]'. 항상 stdout 으로 1줄 출력.
+transcript_messages_json() {
+  local path="$1"
+  node -e "
+    const fs = require('node:fs');
+    const path = process.argv[1];
+    if (!path || !fs.existsSync(path)) { console.log('[]'); process.exit(0); }
+    let raw;
+    try { raw = fs.readFileSync(path, 'utf8'); } catch { console.log('[]'); process.exit(0); }
+    const out = [];
+    for (const line of raw.split('\n')) {
+      const t = line.trim(); if (!t) continue;
+      try {
+        const j = JSON.parse(t);
+        const m = j.message || j;
+        if (m.role !== 'user' && m.role !== 'assistant') continue;
+        let c = m.content;
+        if (typeof c !== 'string') {
+          if (Array.isArray(c)) {
+            c = c.filter(b => b && b.type === 'text' && typeof b.text === 'string')
+                 .map(b => b.text).join('\n').trim();
+          } else { c = ''; }
+        } else { c = c.trim(); }
+        if (!c) continue;
+        out.push({ role: m.role, content: c });
+      } catch {}
+    }
+    const TURN_LIMIT = 200;
+    let pairs = 0;
+    for (let i = 1; i < out.length; i++) {
+      if (out[i-1].role === 'user' && out[i].role === 'assistant') pairs++;
+    }
+    if (pairs > TURN_LIMIT) {
+      let dropPairs = pairs - TURN_LIMIT;
+      let dropIdx = 0;
+      while (dropPairs > 0 && dropIdx < out.length - 1) {
+        if (out[dropIdx].role === 'user' && out[dropIdx+1].role === 'assistant') {
+          dropIdx += 2; dropPairs--;
+        } else { dropIdx++; }
+      }
+      out.splice(0, dropIdx);
+    }
+    console.log(JSON.stringify(out));
+  " "$path" 2>/dev/null || echo "[]"
+}
+
+# self-reference 방지(spec O-4) 2차 방어선: transcript 첫 user 메시지 content 가
+#  ① 센티넬 [[ROOKIE_INTERNAL_INVOCATION::v1]] 로 시작(구조적, 신규 — 모든 internal claude -p 공유) 또는
+#  ② legacy fact-extraction 마커 포함(하위호환)
+# 이면 exit 0. SSOT: src/lib/ai/internal-marker.ts. 전역 4KB substring 폐기 — 본문 인용
+# false positive 차단(P1-4): 인시던트를 논의하며 센티넬을 본문에 인용한 일반 대화는 self-ref 가 아니다.
+transcript_has_self_reference() {
+  local path="$1"
+  [ -n "$path" ] && [ -f "$path" ] || return 1
+  node -e '
+    const fs=require("fs"); const SENT="[[ROOKIE_INTERNAL_INVOCATION::v1]]", LEG="the Rookie의 기억 정리 모듈";
+    let raw=""; try{ raw=fs.readFileSync(process.argv[1],"utf8"); }catch{ process.exit(1); }
+    for(const l of raw.split("\n")){ if(!l.trim())continue;
+      let j; try{ j=JSON.parse(l); }catch{ continue; }
+      const m=j.message||j; if(m.role!=="user")continue;
+      const c=m.content;
+      const t=typeof c==="string"?c:Array.isArray(c)?((c.find(x=>x&&x.type==="text"&&typeof x.text==="string")||{}).text||""):"";
+      process.exit(t.replace(/^\s+/,"").startsWith(SENT)||t.includes(LEG)?0:1);
+    }
+    process.exit(1);
+  ' "$path" 2>/dev/null
+}
+
+# Claude transcript jsonl 의 첫 cwd 필드 (없으면 빈 문자열). Codex 의 transcript_codex_cwd 와 대칭.
+# orphan 회수 시 repo 를 실행 셸 $PWD 가 아니라 후보 transcript 의 실제 cwd 로 역산 — 이슈② 재발 차단.
+transcript_claude_cwd() {
+  local path="$1"
+  [ -n "$path" ] && [ -f "$path" ] || { printf ''; return 0; }
+  node -e '
+    const fs=require("fs");
+    let raw=""; try{ raw=fs.readFileSync(process.argv[1],"utf8"); }catch{ process.exit(0); }
+    for(const l of raw.split("\n")){ if(!l.trim())continue;
+      try{ const j=JSON.parse(l); if(j.cwd){ process.stdout.write(String(j.cwd)); break; } }catch{}
+    }
+  ' "$path" 2>/dev/null
+}
+
+# transcript 파일 경로 → session_id (Claude Code 는 <session_id>.jsonl 로 저장).
+# 외부 basename 의존 제거 — 순수 파라미터 확장(PATH 미오염 hook 환경 견고성).
+transcript_session_id_from_path() {
+  local path="$1"
+  local base="${path##*/}"
+  printf '%s' "${base%.jsonl}"
+}
+
+# ── Codex(rollout) 어댑터 (spec 2026-06-18 §4 Phase 3) ──────────────
+# Codex 세션 포맷은 Claude 와 다르다: 줄마다 {timestamp,type,payload}.
+#   message = payload.type==='message', payload.role, payload.content[]{type:input_text|output_text|text, text}
+#   session_meta(첫 줄) payload.cwd = 프로젝트 매칭 / payload.id = session_id
+# Claude 파서(transcript_messages_json)는 무변경 — 런타임별 어댑터로 분리.
+
+# Codex rollout(.jsonl) → messages[] JSON (user/assistant text, turn≤200). 없/빈 → '[]'.
+transcript_messages_json_codex() {
+  local path="$1"
+  node -e "
+    const fs=require('node:fs');
+    const path=process.argv[1];
+    if(!path||!fs.existsSync(path)){console.log('[]');process.exit(0);}
+    let raw; try{raw=fs.readFileSync(path,'utf8');}catch{console.log('[]');process.exit(0);}
+    const out=[];
+    for(const line of raw.split('\n')){
+      const t=line.trim(); if(!t) continue;
+      let j; try{ j=JSON.parse(t); }catch{ continue; }
+      const p=j.payload||{};
+      if(p.type!=='message') continue;
+      if(p.role!=='user'&&p.role!=='assistant') continue;
+      let c=p.content;
+      if(Array.isArray(c)){
+        c=c.filter(b=>b&&typeof b.text==='string'&&(b.type==='input_text'||b.type==='output_text'||b.type==='text'))
+           .map(b=>b.text).join('\n').trim();
+      } else if(typeof c==='string'){ c=c.trim(); } else { c=''; }
+      if(!c) continue;
+      out.push({role:p.role, content:c});
+    }
+    const TURN_LIMIT=200; let pairs=0;
+    for(let i=1;i<out.length;i++){ if(out[i-1].role==='user'&&out[i].role==='assistant')pairs++; }
+    if(pairs>TURN_LIMIT){
+      let dropPairs=pairs-TURN_LIMIT, dropIdx=0;
+      while(dropPairs>0&&dropIdx<out.length-1){
+        if(out[dropIdx].role==='user'&&out[dropIdx+1].role==='assistant'){dropIdx+=2;dropPairs--;}
+        else dropIdx++;
+      }
+      out.splice(0,dropIdx);
+    }
+    console.log(JSON.stringify(out));
+  " "$path" 2>/dev/null || echo '[]'
+}
+
+# Codex rollout 첫 줄 session_meta 의 cwd (프로젝트 매칭용). 첫 64KB 만 읽음.
+transcript_codex_cwd() {
+  local path="$1"
+  [ -f "$path" ] || return 1
+  node -e "
+    const fs=require('node:fs');
+    try{
+      const fd=fs.openSync(process.argv[1],'r'); const buf=Buffer.alloc(65536);
+      const n=fs.readSync(fd,buf,0,65536,0); fs.closeSync(fd);
+      const first=buf.toString('utf8',0,n).split('\n').find(l=>l.trim());
+      const j=JSON.parse(first);
+      if(j.type==='session_meta'&&j.payload&&j.payload.cwd) process.stdout.write(j.payload.cwd);
+    }catch{}
+  " "$path" 2>/dev/null
+}
+
+# Codex rollout 파일경로 → session_id. 파일명 rollout-<ts>-<uuid>.jsonl 의 끝 UUID.
+transcript_session_id_from_path_codex() {
+  local base="${1##*/}"
+  base="${base%.jsonl}"
+  printf '%s' "$base" | grep -oiE '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$' || true
+}

package/templates/hook/refresh-context.sh

@@ -0,0 +1,163 @@
+#!/bin/bash
+# UserPromptSubmit hook — 현재 cwd 기반 컨텍스트를 stdout으로 내보내
+# Claude Code가 system 지시로 취합합니다.
+# Phase A++: stdin에 담긴 사용자 prompt를 user_prompt 쿼리로 전달해 chunk reinforcement + 예전 대화 떠올림 기능을 활성화.
+# spec §17 (2026-04-30): status 헬스체크 + 큐 drain + 두목 경고 prefix.
+
+# self-reference 방지(spec O-4): 차차 internal LLM 호출(`claude -p` from cli-provider)에서
+# 발사된 hook은 즉시 종료. 두목과의 진짜 대화에서만 동작.
+if [ "$ROOKIE_INTERNAL_INVOCATION" = "1" ]; then
+  exit 0
+fi
+
+CONFIG="$HOME/.rookie/config.json"
+if [ ! -f "$CONFIG" ]; then
+  exit 0
+fi
+
+ENDPOINT=$(node -e "console.log(require('$CONFIG').endpoint)" 2>/dev/null || echo "http://localhost:3000")
+TOKEN=$(node -e "console.log(require('$CONFIG').token)" 2>/dev/null || echo "")
+USER_ID=$(node -e "console.log(require('$CONFIG').user_id || '')" 2>/dev/null || echo "")
+if [ -z "$TOKEN" ]; then
+  exit 0
+fi
+
+# §17 큐 라이브러리 로드
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [ -f "$SCRIPT_DIR/lib/queue.sh" ]; then
+  # shellcheck source=/dev/null
+  . "$SCRIPT_DIR/lib/queue.sh"
+elif [ -f "$HOME/.rookie/bin/lib/queue.sh" ]; then
+  # shellcheck source=/dev/null
+  . "$HOME/.rookie/bin/lib/queue.sh"
+fi
+
+STDIN_BODY=$(cat)
+
+PROMPT=$(echo "$STDIN_BODY" | node -e "
+  let d=''; process.stdin.on('data',c=>d+=c).on('end',()=>{
+    try {
+      const j = JSON.parse(d);
+      const p = (j.prompt || j.user_prompt || '').toString();
+      // URL 길이 제한 대비 2000자로 절삭
+      process.stdout.write(p.slice(0, 2000));
+    } catch {}
+  })
+" 2>/dev/null || echo "")
+
+REPO_URL=""
+if command -v git >/dev/null; then
+  REPO_URL=$(git remote get-url origin 2>/dev/null || echo "")
+fi
+REPO_PATH="$PWD"
+HOST=$(hostname)
+
+ENCODE() {
+  node -e "console.log(encodeURIComponent(process.argv[1] || ''))" "$1"
+}
+
+# §17 H-1 / H-3: status 5s 헬스체크 → UP/DOWN 분기
+# §18 U-3: status body 도 함께 받아 templates manifest 미스매치 비교
+STATUS_FILE=$(mktemp)
+STATUS_CODE=$(curl -sS --max-time 5 -o "$STATUS_FILE" -w "%{http_code}" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "x-rookie-user-id: $USER_ID" \
+  "$ENDPOINT/api/rookie/status" 2>/dev/null) || STATUS_CODE="000"
+
+QUEUE_BEFORE=0
+if command -v queue_count >/dev/null 2>&1; then
+  QUEUE_BEFORE=$(queue_count)
+fi
+
+if [ "$STATUS_CODE" = "200" ]; then
+  # §18 U-3: templates manifest 비교 → 미스매치 prefix 경고 (정상 system_prompt 노출은 그대로 진행)
+  SERVER_HASH=$(node -e "
+    let d=''; process.stdin.on('data',c=>d+=c).on('end',()=>{
+      try {
+        const j = JSON.parse(d);
+        process.stdout.write((j.templates && j.templates.manifest_hash) || '');
+      } catch {}
+    });
+  " < "$STATUS_FILE" 2>/dev/null || echo "")
+  LOCAL_HASH=""
+  if [ -f "$HOME/.rookie/manifest.json" ]; then
+    LOCAL_HASH=$(node -e "
+      try {
+        const j = require('$HOME/.rookie/manifest.json');
+        process.stdout.write(j.manifest_hash || '');
+      } catch {}
+    " 2>/dev/null || echo "")
+  fi
+  if [ -n "$SERVER_HASH" ] && [ "$LOCAL_HASH" != "$SERVER_HASH" ]; then
+    SERVER_SHORT=$(printf '%s' "$SERVER_HASH" | cut -c1-12)
+    if [ -n "$LOCAL_HASH" ]; then
+      LOCAL_SHORT=$(printf '%s' "$LOCAL_HASH" | cut -c1-12)
+      printf '⚠️ Rookie hook 버전 미스매치 — 서버 %s… / 로컬 %s…\n' "$SERVER_SHORT" "$LOCAL_SHORT"
+    else
+      printf '⚠️ Rookie hook 버전 미스매치 — 서버 %s… / 로컬 manifest 없음 (옛 install)\n' "$SERVER_SHORT"
+    fi
+    printf '   `node packages/rookie-cli/bin/rookie.js update` 실행 권장. (정상 컨텍스트는 그대로 노출)\n\n'
+  fi
+
+  # §17 H-4: 큐 drain (오래된 작업이 새 컨텍스트보다 우선)
+  if command -v queue_drain >/dev/null 2>&1; then
+    queue_drain "$ENDPOINT" "$TOKEN" "$USER_ID" >/dev/null 2>&1 || true
+  fi
+
+  QS="repo_path=$(ENCODE "$REPO_PATH")"
+  if [ -n "$REPO_URL" ]; then
+    QS="$QS&repo_url=$(ENCODE "$REPO_URL")"
+  fi
+  if [ -n "$PROMPT" ]; then
+    QS="$QS&user_prompt=$(ENCODE "$PROMPT")"
+  fi
+
+  RESP_FILE=$(mktemp)
+  CTX_CODE=$(curl -sS --max-time 10 \
+    -H "Authorization: Bearer $TOKEN" \
+    -H "x-rookie-hostname: $HOST" \
+    -H "x-rookie-user-id: $USER_ID" \
+    -H "x-rookie-surface: ${1:-claude_code}" \
+    -o "$RESP_FILE" \
+    -w "%{http_code}" \
+    "$ENDPOINT/api/rookie/context?$QS" 2>/dev/null) || CTX_CODE="000"
+
+  if [ "$CTX_CODE" = "200" ]; then
+    if command -v queue_record_success >/dev/null 2>&1; then
+      queue_record_success
+    fi
+
+    # drain 후 잔여 큐가 있으면 prefix 경고도 함께 출력 (drain 실패 항목 가시화)
+    QUEUE_AFTER=0
+    if command -v queue_count >/dev/null 2>&1; then
+      QUEUE_AFTER=$(queue_count)
+    fi
+    if [ "$QUEUE_AFTER" -gt 0 ] && command -v queue_warning_prefix >/dev/null 2>&1; then
+      queue_warning_prefix "$(last_success_minutes_ago)" "$QUEUE_AFTER"
+      printf '\n'
+    fi
+
+    cat "$RESP_FILE" | node -e "
+      let d=''; process.stdin.on('data',c=>d+=c).on('end',()=>{
+        try {
+          const j = JSON.parse(d);
+          if (j.system_prompt) process.stdout.write(j.system_prompt);
+        } catch {}
+      });
+    " 2>/dev/null || true
+  else
+    # status 200 인데 context 실패 — 부분 장애 가능성, 경고만 노출
+    if command -v queue_warning_prefix >/dev/null 2>&1; then
+      queue_warning_prefix "$(last_success_minutes_ago)" "$QUEUE_BEFORE"
+    fi
+  fi
+  rm -f "$RESP_FILE"
+else
+  # §17 H-3: DOWN — 두목께 경고 노출 (silent 금지)
+  if command -v queue_warning_prefix >/dev/null 2>&1; then
+    queue_warning_prefix "$(last_success_minutes_ago)" "$QUEUE_BEFORE"
+  fi
+fi
+
+rm -f "$STATUS_FILE"
+exit 0