therookie 0.4.21 → 0.4.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "therookie",
-  "version": "0.4.21",
+  "version": "0.4.24",
   "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/doctor.js

@@ -129,6 +129,7 @@ export async function runDoctor(flags) {
   await printViolationTop(cfg)
   await printEmbeddingGuard(cfg)
   await printInjectionSize(cfg)
+  printPendingInject()
   printContextDiet()
 
   if (flags['deep-scan']) {
@@ -193,11 +194,51 @@ async function printInjectionSize(cfg) {
     } else {
       console.log(`✓ SessionStart 주입 크기 ${size}자 (임계 ${CLAUDE_HOOK_OUTPUT_CAP}자 이내)`)
     }
+    // spec 2026-09-02 (2단계 로드 강제) — 예산에서 빠진 것이 무엇이고 얼마인지.
+    // 이 줄이 없으면 "무엇이 안 들어갔는지"를 세션 밖에서 알 길이 없다.
+    const omitted = Array.isArray(ctx?.omitted_sections) ? ctx.omitted_sections : []
+    if (omitted.length > 0) {
+      const chars = omitted.reduce((n, o) => n + (o?.text?.length ?? 0), 0)
+      const labels = omitted.map((o) => o?.label).filter(Boolean).join(' · ')
+      console.log(`   생략 ${omitted.length}개 ${chars}자 (${labels}) → 첫 발화에 이어서 주입`)
+    }
   } catch {
     // silent — endpoint 미응답 시 본 라인만 누락.
   }
 }
 
+// spec 2026-09-02 (2단계 로드 강제) — 대기 중인 인격 주입 상태.
+// 조용한 실패가 이 기능이 고치려는 병이라, 이 기능 자신의 상태를 볼 수 있어야 한다.
+function printPendingInject() {
+  const dir = process.env.ROOKIE_PENDING_INJECT_DIR || join(homedir(), '.rookie', 'pending-inject')
+  if (!existsSync(dir)) return
+  let files = []
+  try {
+    files = readdirSync(dir).filter((f) => f.endsWith('.json'))
+  } catch {
+    return
+  }
+  if (files.length === 0) return
+  let waiting = 0
+  let stale = 0
+  for (const f of files) {
+    try {
+      const b = JSON.parse(readFileSync(join(dir, f), 'utf8'))
+      const total = Array.isArray(b?.sections) ? b.sections.length : 0
+      const done = Number.isInteger(b?.next_index) ? b.next_index : 0
+      waiting += Math.max(0, total - done)
+      const age = Date.now() - new Date(b?.created_at ?? 0).getTime()
+      if (age > 24 * 3600 * 1000) stale += 1
+    } catch {
+      stale += 1
+    }
+  }
+  console.log(`— 인격 2단계 주입 대기: 세션 ${files.length}개 · 섹션 ${waiting}개`)
+  if (stale > 0) {
+    console.log(`   ⚠ 하루 넘게 남았거나 읽을 수 없는 것 ${stale}건 — 첫 발화가 없었던 세션일 수 있습니다`)
+  }
+}
+
 // spec post-v5-decisions §18 — templates manifest 비교 가시화
 function printTemplateManifestStatus(serverStatus) {
   const local = loadClientManifest()

package/src/commands/save.js

@@ -14,6 +14,34 @@ import { readFileSync } from 'node:fs'
 import { loadConfig, getHostname } from '../config.js'
 import { apiPost } from '../api.js'
 
+// 저장된 층을 **빠짐없이** 화면에 센다. 여기 없는 층은 서버가 저장해도 0건처럼 보인다 —
+// 2026-09-02 저장에서 durable fact 3건이 그렇게 안 보였고, metric·recall 로 따로 확인해야
+// 들어간 걸 알 수 있었다. 어제 닫은 사고("문은 열었는데 아무도 안 본다")와 같은 모양이다.
+//
+// 중복 스킵도 함께 센다. applied 만 보면 "보냈는데 전부 중복이라 0건" 과 "안 보냈다" 가
+// 화면에서 구분되지 않는다(그게 이 결함이 오래 안 보인 이유다).
+export function formatSaveSummary(s) {
+  const parts = []
+  if (s.working_cards?.ids?.length) parts.push(`카드 ${s.working_cards.ids.length}`)
+  const factsApplied = s.facts?.applied ?? 0
+  const factsDup = s.facts?.skipped_duplicate ?? 0
+  if (factsApplied || factsDup) {
+    parts.push(factsDup > 0 ? `사실 ${factsApplied}(중복 ${factsDup})` : `사실 ${factsApplied}`)
+  }
+  if (s.evidence?.applied) parts.push(`증거 ${s.evidence.applied}`)
+  if (s.personal_facts?.applied) parts.push(`취향 ${s.personal_facts.applied}`)
+  if (s.self_rules?.applied) {
+    const reinforced = s.self_rules.reinforced ?? 0
+    parts.push(
+      reinforced > 0
+        ? `자기규칙 ${s.self_rules.applied}(강화 ${reinforced})`
+        : `자기규칙 ${s.self_rules.applied}`
+    )
+  }
+  if (s.verifications?.applied) parts.push(`검증 ${s.verifications.applied}`)
+  return parts.length > 0 ? parts.join(' · ') : '0건'
+}
+
 function readStdin() {
   // TTY 면 파이프가 없다 — EOF 까지 무한 대기하지 않도록 즉시 빈 값으로 빠진다.
   if (process.stdin.isTTY) return ''
@@ -119,19 +147,7 @@ export async function runSave(flags) {
       '→ 같은 취지가 있으면 reinforces:"<id>"(강화) 또는 supersedes:"<id>"(정정), 없으면 peers_reviewed:true 로 재전송하세요.'
     )
   }
-  const parts = []
-  if (s.working_cards?.ids?.length) parts.push(`카드 ${s.working_cards.ids.length}`)
-  if (s.evidence?.applied) parts.push(`증거 ${s.evidence.applied}`)
-  if (s.self_rules?.applied) {
-    const reinforced = s.self_rules.reinforced ?? 0
-    parts.push(
-      reinforced > 0
-        ? `자기규칙 ${s.self_rules.applied}(강화 ${reinforced})`
-        : `자기규칙 ${s.self_rules.applied}`
-    )
-  }
-  if (s.verifications?.applied) parts.push(`검증 ${s.verifications.applied}`)
-  const label = parts.length > 0 ? parts.join(' · ') : '0건'
+  const label = formatSaveSummary(s)
 
   if (res.all_committed === false) {
     // 검토 게이트만 걸린 저장은 "미저장 0건" 이 아니라 다음 행동이 남은 상태다.

package/src/commands/update.js

@@ -171,6 +171,11 @@ export async function runUpdate(flags) {
   // B6 (spec 2026-07-11) — config 상향 탐색 + 세션 identity pinning 공용 헬퍼.
   cpSync(join(TEMPLATES, 'hook', 'lib', 'config-resolve.sh'), join(libDir, 'config-resolve.sh'))
   chmodSync(join(libDir, 'config-resolve.sh'), 0o755)
+  // spec 2026-09-02 — 예산에서 생략된 인격 층을 첫 발화에 주입하는 대기열 헬퍼.
+  // 이 목록이 하드코딩이라 새 lib 을 빠뜨리면 manifest 는 맞는데 파일이 없는
+  // 조용한 실패가 난다(2026-09-02 실제로 겪었다). 새 lib 추가 시 여기도 같이.
+  cpSync(join(TEMPLATES, 'hook', 'lib', 'pending-inject.sh'), join(libDir, 'pending-inject.sh'))
+  chmodSync(join(libDir, 'pending-inject.sh'), 0o755)
 
   // settings.json 재병합 (글로벌)
   const settingsPath = join(homedir(), '.claude', 'settings.json')

package/src/lib/deploy-artifacts.js

@@ -102,6 +102,11 @@ export function installSharedHookRuntime({ scope, home, cwd } = {}) {
   // B6 (spec 2026-07-11) — config 상향 탐색 + 세션 identity pinning 공용 헬퍼.
   cpSync(join(TEMPLATES, 'hook', 'lib', 'config-resolve.sh'), join(libDir, 'config-resolve.sh'))
   chmodSync(join(libDir, 'config-resolve.sh'), 0o755)
+  // spec 2026-09-02 — 예산에서 생략된 인격 층을 첫 발화에 주입하는 대기열 헬퍼.
+  // 이 목록이 하드코딩이라 새 lib 을 빠뜨리면 manifest 는 맞는데 파일이 없는
+  // 조용한 실패가 난다(2026-09-02 실제로 겪었다). 새 lib 추가 시 여기도 같이.
+  cpSync(join(TEMPLATES, 'hook', 'lib', 'pending-inject.sh'), join(libDir, 'pending-inject.sh'))
+  chmodSync(join(libDir, 'pending-inject.sh'), 0o755)
 
   return { binDir }
 }

package/templates/hook/lib/pending-inject.sh

@@ -0,0 +1,63 @@
+#!/bin/bash
+# lib/pending-inject.sh — 예산에서 생략된 페르소나 섹션을 첫 발화에 주입하기 위한 대기열.
+# 설계: docs/superpowers/specs/2026-09-02-two-stage-load-enforcement.md
+#
+# 왜 필요한가: SessionStart 훅은 additionalContext 10,000자 벽 때문에 예산 8,500 으로
+# 조립하고, 전문(약 17,300자)에서 가장 큰 섹션(voice 등)을 통째로 건너뛴다. 지금까지는
+# SKILL.md 문구가 세션에게 되받아 오라고 시켰을 뿐이라, 안 따르면 인격이 통째로 빠졌다.
+# 여기서는 서버가 같은 응답에 실어 준 생략분 본문을 파일로 두었다가 UserPromptSubmit 이
+# 직접 주입한다 — 조회와 섭취 사이에 세션의 판단이 끼지 않게 하는 것이 요점.
+#
+# 키 = sha256(session_id). skill-gate 와 같은 규약이며, 빈 session_id 는 쓰지 않는다
+# (빈 값을 해시하면 모든 세션이 한 파일을 공유해 남의 인격을 받는다).
+
+pending_inject_dir() {
+  printf '%s' "${ROOKIE_PENDING_INJECT_DIR:-$HOME/.rookie/pending-inject}"
+}
+
+# pending_inject_write <session_id> <context_response_file> <source>
+#   source 가 resume 이면 쓰지 않는다 — 컨텍스트가 살아 있어 중복 주입이 된다.
+#   startup·clear·compact(및 빈 값)만 새 주입 회차로 본다.
+#   응답에 omitted_sections 가 없거나 비어 있으면 조용히 아무것도 하지 않는다.
+pending_inject_write() {
+  local sid="${1:-}" resp="${2:-}" src="${3:-}" dir key
+  [ -n "$sid" ] || return 0
+  [ -f "$resp" ] || return 0
+  [ "$src" != "resume" ] || return 0
+  dir="$(pending_inject_dir)"
+  if command -v skill_gate_key >/dev/null 2>&1; then
+    key="$(skill_gate_key "$sid")"
+  else
+    key=$(printf '%s' "$sid" | 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)
+  fi
+  [ -n "$key" ] || return 0
+  mkdir -p "$dir" 2>/dev/null
+  chmod 700 "$dir" 2>/dev/null
+
+  ROOKIE_PI_DIR="$dir" ROOKIE_PI_KEY="$key" ROOKIE_PI_RESP="$resp" node -e '
+    try {
+      const fs=require("fs"), path=require("path");
+      const dir=process.env.ROOKIE_PI_DIR, key=process.env.ROOKIE_PI_KEY;
+      const j=JSON.parse(fs.readFileSync(process.env.ROOKIE_PI_RESP,"utf8"));
+      const raw=Array.isArray(j.omitted_sections)?j.omitted_sections:[];
+      const sections=raw
+        .filter(s=>s&&typeof s.label==="string"&&typeof s.text==="string"&&s.text.trim())
+        .map(s=>({label:s.label,text:s.text}));
+      const target=path.join(dir,key+".json");
+      if(sections.length===0){ try{ fs.unlinkSync(target); }catch{} process.exit(0); }
+      // symlink 로 바꿔치기된 자리에는 쓰지 않는다 — 지우고 새로 만든다.
+      try{ const st=fs.lstatSync(target); if(!st.isFile()) fs.unlinkSync(target); }catch{}
+      const body={
+        version:1,
+        created_at:new Date().toISOString(),
+        next_index:0,
+        injected_at:[],
+        sections,
+      };
+      const tmp=path.join(dir,key+".json.tmp");
+      fs.writeFileSync(tmp,JSON.stringify(body),{mode:0o600});
+      fs.renameSync(tmp,target);   // atomic — 부분 기록 상태가 남지 않는다
+    } catch {}
+  ' 2>/dev/null || true
+  return 0
+}

package/templates/hook/session-start.sh

@@ -30,7 +30,7 @@ fi
 # spec 2026-06-18 crash-recovery: orphan flush recovery helper (transcript.sh → orphan-recovery.sh).
 # 비정상 종료(Stop hook 미발사) 세션의 transcript 를 다음 SessionStart 에서 사후 회수.
 # B6-1 (spec 2026-07-11): config-resolve.sh — env > 로컬(.rookie/, cwd 상향) > 전역 해석 + identity pin.
-for _lib in transcript.sh orphan-recovery.sh skill-gate.sh config-resolve.sh; do
+for _lib in transcript.sh orphan-recovery.sh skill-gate.sh config-resolve.sh pending-inject.sh; do
   if [ -f "$SCRIPT_DIR/lib/$_lib" ]; then
     # shellcheck source=/dev/null
     . "$SCRIPT_DIR/lib/$_lib"
@@ -258,6 +258,12 @@ if [ "$STATUS_CODE" = "200" ]; then
       queue_record_success
     fi
 
+    # spec 2026-09-02 (2단계 로드 강제) — 예산에서 생략된 섹션 본문을 대기열에 둔다.
+    # UserPromptSubmit 이 첫 발화에 직접 주입한다. resume 은 컨텍스트가 살아 있어 제외.
+    if command -v pending_inject_write >/dev/null 2>&1; then
+      pending_inject_write "$SESSION_ID" "$RESP_FILE" "$SOURCE" || true
+    fi
+
     QUEUE_AFTER=0
     if command -v queue_count >/dev/null 2>&1; then
       QUEUE_AFTER=$(queue_count)

package/templates/hook/user-prompt-skill-gate.sh

@@ -31,12 +31,15 @@ fi
 [ -n "$TOKEN" ] || exit 0
 
 GATE_DIR="${ROOKIE_SKILL_GATE_DIR:-$HOME/.rookie/skill-gate}"
+PI_DIR="${ROOKIE_PENDING_INJECT_DIR:-$HOME/.rookie/pending-inject}"
+# 조용한 실패가 이 기능이 고치려는 병이라, 이 기능 자신의 실패는 남긴다(dispatcher 와 같은 로그).
+DROP_LOG="${ROOKIE_DROP_LOG:-$HOME/.rookie/dropped-mutations.log}"
 
 # stdin(UserPromptSubmit payload) → node 가 전부 처리(파싱·sha256·marker·epoch·scan·신호·출력 결정).
 # node 단일 덩어리라 fail-soft·stderr 억제가 쉽다. code 안에 작은따옴표 미사용(bash single-quote 보호).
 # 두 갈래(한 turn 한 메시지): skill 미로드 → SKILL_MSG / 로드됨 + 과거-방법 회상 신호 → RECALL_MSG.
 # marker(.loaded)는 "로드됨 캐시"일 뿐 early-return 아님 — 로드 뒤에도 프롬프트 신호를 매 turn 검사(spec 2026-07-07-recall-first §3.1).
-cat | ROOKIE_GATE_DIR="$GATE_DIR" node -e '
+cat | ROOKIE_GATE_DIR="$GATE_DIR" ROOKIE_PI_DIR="$PI_DIR" ROOKIE_DROP_LOG="$DROP_LOG" node -e '
   let d="";
   process.stdin.on("data",c=>d+=c).on("end",()=>{
     const SKILL_MSG="⚠️ 이 세션에서 아직 rookie Skill 을 로드하지 않았습니다. 다른 작업·응답 전에 먼저 rookie Skill 을 호출하세요 — 회상(recall)·미link 등록 제안·기억 저장 절차가 그 안에 있습니다. (이미 호출했다면 이 안내는 사라집니다.)";
@@ -46,6 +49,63 @@ cat | ROOKIE_GATE_DIR="$GATE_DIR" node -e '
     // 충돌하고, recall 절차 자체가 SKILL.md 안에 있어 미로드 세션은 그 절차를 아직 못 읽었다 — 순서를 못박는다.
     const COMBO_MSG="🧠 이 프롬프트에 과거 맥락·방법 회상 신호가 있는데, 이 세션은 아직 rookie Skill 을 로드하지 않았습니다. 순서대로 하세요 — ① rookie Skill 을 먼저 호출하고 ② 그 안의 회상 절차로 이번 프롬프트에 대해 GET /api/rookie/recall 을 최소 1회 호출한 뒤 ③ 답하세요. grep·파일 열람·git log 추론·두목 되묻기는 그 다음입니다.";
     const injectMsg=(msg)=>{ try{ process.stdout.write(JSON.stringify({hookSpecificOutput:{hookEventName:"UserPromptSubmit",additionalContext:msg}})); }catch{} };
+    // spec 2026-09-02 (2단계 로드 강제) — SessionStart 가 남긴 생략 섹션을 꺼내 온다.
+    // 조회와 섭취 사이에 세션의 판단이 끼지 않게, 훅이 본문을 직접 실어 보낸다.
+    // 한 번에 CHUNK_MAX 까지만 — 10,000자 벽 아래로 유지하고 나머지는 다음 발화에서.
+    const CHUNK_MAX=8000, LOCK_STALE_MS=60000;
+    const dropLog=(fs,reason)=>{
+      try{ const p=process.env.ROOKIE_DROP_LOG; if(p) fs.appendFileSync(p,new Date().toISOString()+" pending_inject "+reason+"\n"); }catch{}
+    };
+    // 반환: { text, commit } — **주입을 내보낸 뒤에** commit 을 부른다.
+    // 소비 표시를 출력 전에 하면 그 사이 훅이 죽었을 때 인격이 영영 사라진다
+    // (이 기능이 막으려는 바로 그 유실). lock 은 commit 까지 잡고 있는다.
+    const takePendingPersona=(fs,path,key)=>{
+      if(!key) return null;                       // 빈 session_id → pending 미사용
+      const dir=process.env.ROOKIE_PI_DIR; if(!dir) return null;
+      const target=path.join(dir,key+".json"), lock=path.join(dir,key+".lock");
+      try{ const st=fs.lstatSync(target); if(!st.isFile()) { try{fs.unlinkSync(target);}catch{} return null; } }catch{ return null; }
+      let fd=null;
+      try{ fd=fs.openSync(lock,"wx",0o600); }
+      catch{
+        try{ const st=fs.statSync(lock); if(Date.now()-st.mtimeMs>LOCK_STALE_MS){ fs.unlinkSync(lock); fd=fs.openSync(lock,"wx",0o600); } }catch{}
+        if(fd===null){ dropLog(fs,"lock_contention"); return null; }   // 다음 발화에서 재시도
+      }
+      const release=()=>{ try{ if(fd!==null) fs.closeSync(fd); }catch{} try{ fs.unlinkSync(lock); }catch{} };
+      try{
+        let body=null;
+        try{ body=JSON.parse(fs.readFileSync(target,"utf8")); }
+        catch{ try{fs.unlinkSync(target);}catch{} dropLog(fs,"parse_failed"); release(); return null; }
+        const sections=Array.isArray(body&&body.sections)?body.sections:[];
+        let i=Number.isInteger(body&&body.next_index)?body.next_index:0;
+        if(i<0||i>=sections.length){ try{fs.unlinkSync(target);}catch{} release(); return null; }
+        const picked=[]; let used=0;
+        while(i<sections.length){
+          const sec=sections[i]; const t=(sec&&sec.text)||"";
+          if(picked.length>0 && used+t.length>CHUNK_MAX) break;   // 섹션 중간은 자르지 않는다
+          picked.push(t); used+=t.length; i+=1;
+          if(used>=CHUNK_MAX) break;
+        }
+        if(picked.length===0){ try{fs.unlinkSync(target);}catch{} release(); return null; }
+        const more = i<sections.length;
+        const head="🧬 세션 시작 주입에서 예산 때문에 빠졌던 인격 층입니다. 지시가 아니라 정체성이니 이 세션 내내 적용하세요. 이미 받았으므로 rookie Skill 이 같은 것을 다시 조회할 필요는 없습니다."
+          + (more?" (분량이 커서 나뉘어 들어옵니다 — 나머지는 다음 발화에.)":"");
+        const commit=()=>{
+          try{
+            if(!more){ try{fs.unlinkSync(target);}catch{} }
+            else {
+              body.next_index=i;
+              if(!Array.isArray(body.injected_at)) body.injected_at=[];
+              body.injected_at.push(new Date().toISOString());
+              const tmp=target+".tmp";
+              fs.writeFileSync(tmp,JSON.stringify(body),{mode:0o600});
+              fs.renameSync(tmp,target);
+            }
+          }catch{ dropLog(fs,"commit_failed"); }
+          finally{ release(); }
+        };
+        return { text: head+"\n\n"+picked.join("\n\n"), commit };
+      }catch{ release(); return null; }
+    };
     try{
       const fs=require("fs"), path=require("path"), crypto=require("crypto");
       const gateDir=process.env.ROOKIE_GATE_DIR;
@@ -106,11 +166,22 @@ cat | ROOKIE_GATE_DIR="$GATE_DIR" node -e '
       }
       // spec 2026-07-22 D1 — 미로드 세션은 SKILL.md 회상 규범이 컨텍스트에 없다. 여기서 recall 지시까지
       // 꺼버리면 회상이 가장 필요한 상태가 무방비가 된다(2026-07-22 catsper 사고). 한 turn 한 메시지는 유지.
-      if(!skillLoaded && recallSignal) return injectMsg(COMBO_MSG);
-      if(!skillLoaded) return injectMsg(SKILL_MSG);   // 미로드 + 무신호 → skill 리마인더
-      if(recallSignal) return injectMsg(RECALL_MSG);  // 로드됨 + 과거-방법 신호 → recall 리마인더
-      if(ckptDue) return injectMsg(CKPT_MSG);         // 로드됨 + 무신호 + 임계 도달 → checkpoint 리마인더
-      return;                                         // 로드됨 + 신호 없음 → 조용
+      // spec 2026-09-02 — 인격 블록은 기존 분기를 **가로채지 않고 앞에 붙는다**.
+      // 단독 분기로 끼우면 미로드+회상신호 세션이 COMBO 의 순서 지시를 못 받는 turn 이 생긴다.
+      let base=null;
+      if(!skillLoaded && recallSignal) base=COMBO_MSG;
+      else if(!skillLoaded) base=SKILL_MSG;           // 미로드 + 무신호 → skill 리마인더
+      else if(recallSignal) base=RECALL_MSG;          // 로드됨 + 과거-방법 신호 → recall 리마인더
+      else if(ckptDue) base=CKPT_MSG;                 // 로드됨 + 무신호 + 임계 도달 → checkpoint 리마인더
+      let taken=null;
+      try{ taken=takePendingPersona(fs,path,key); }catch{ taken=null; }
+      const parts=[];
+      if(taken) parts.push(taken.text);
+      if(base) parts.push(base);
+      if(parts.length===0) return;                    // 둘 다 없음 → 조용
+      injectMsg(parts.join("\n\n"));
+      if(taken) taken.commit();                       // 내보낸 뒤에 소비 표시
+      return;
     }catch{ return injectMsg(SKILL_MSG); }   // fail-soft
   });
 ' 2>/dev/null

package/version.json

@@ -1,4 +1,4 @@
 {
-  "cli_version": "0.4.21",
+  "cli_version": "0.4.24",
   "skill_version": "1.39.0"
 }