therookie 0.4.3

package/src/lib/deploy-artifacts.js

@@ -0,0 +1,185 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync, chmodSync, cpSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { apiGet } from '../api.js'
+import { saveClientManifest } from './manifest.js'
+import { upsertCodexHookBlock } from './codex-config.js'
+import { claudeHookCommand, escapeJsonStringValue } from './hook-command.js'
+import { mergeHooks } from './merge-hooks.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const TEMPLATES = join(__dirname, '..', '..', 'templates')
+const VERSION_PATH = join(__dirname, '..', '..', 'version.json')
+
+// scope 별 설치 베이스. global=홈, local=cwd. 테스트는 home/cwd 주입으로 실홈 미터치.
+function resolveBase(scope, { home = homedir(), cwd = process.cwd() } = {}) {
+  return scope === 'global' ? home : cwd
+}
+function resolveBinDir(scope, opts) {
+  return join(resolveBase(scope, opts), '.rookie', 'bin')
+}
+
+// ── 1층: 공유 hook 런타임(~/.rookie/bin/) — 도구 무관 공용(Claude·Codex 둘 다 이 파일을 문다).
+//    어느 도구든 1개+ 설정 시 먼저 보장한다(spec 2026-06-29-unified-connect-flow §4).
+export function installSharedHookRuntime({ scope, home, cwd } = {}) {
+  const binDir = resolveBinDir(scope, { home, cwd })
+  mkdirSync(binDir, { recursive: true })
+  cpSync(join(TEMPLATES, 'hook', 'flush-session.sh'), join(binDir, 'flush-session.sh'))
+  cpSync(join(TEMPLATES, 'hook', 'session-start.sh'), join(binDir, 'session-start.sh'))
+  chmodSync(join(binDir, 'flush-session.sh'), 0o755)
+  chmodSync(join(binDir, 'session-start.sh'), 0o755)
+  // spec 2026-06-18 Phase 3 — cross-runtime sweep 진입점(launchd/수동). 등록은 두목 승인 후 수동.
+  cpSync(join(TEMPLATES, 'hook', 'sweep-recovery.sh'), join(binDir, 'sweep-recovery.sh'))
+  chmodSync(join(binDir, 'sweep-recovery.sh'), 0o755)
+
+  // 2026-06-03 — PreToolUse(Bash) 파괴적 DB·git 명령 가드.
+  cpSync(join(TEMPLATES, 'hook', 'guard-destructive-db.sh'), join(binDir, 'guard-destructive-db.sh'))
+  chmodSync(join(binDir, 'guard-destructive-db.sh'), 0o755)
+
+  // 2026-06-24 — UserPromptSubmit rookie Skill 로드 게이트(미로드 세션 상기).
+  cpSync(join(TEMPLATES, 'hook', 'user-prompt-skill-gate.sh'), join(binDir, 'user-prompt-skill-gate.sh'))
+  chmodSync(join(binDir, 'user-prompt-skill-gate.sh'), 0o755)
+
+  // v6 P1 #5 — Stage 1 측정 hook (PreToolUse).
+  const pretoolBinDir = join(binDir, 'bin')
+  mkdirSync(pretoolBinDir, { recursive: true })
+  cpSync(
+    join(TEMPLATES, 'hook', 'bin', 'pretool-md-read.sh'),
+    join(pretoolBinDir, 'pretool-md-read.sh')
+  )
+  chmodSync(join(pretoolBinDir, 'pretool-md-read.sh'), 0o755)
+
+  // spec 2026-07-10 §3.B2 — PostToolUse recall nudge (교정 전용, 측정 hook 과 분리).
+  cpSync(
+    join(TEMPLATES, 'hook', 'bin', 'posttool-recall-nudge.sh'),
+    join(pretoolBinDir, 'posttool-recall-nudge.sh')
+  )
+  chmodSync(join(pretoolBinDir, 'posttool-recall-nudge.sh'), 0o755)
+
+  // spec post-v5-decisions §17 — hook offline queue 라이브러리 배포
+  const libDir = join(binDir, 'lib')
+  mkdirSync(libDir, { recursive: true })
+  cpSync(join(TEMPLATES, 'hook', 'lib', 'queue.sh'), join(libDir, 'queue.sh'))
+  chmodSync(join(libDir, 'queue.sh'), 0o755)
+  // spec post-v5-decisions §17.2 H-2.1/H-2.2 — hot write retry + partial failure 재큐 dispatcher
+  cpSync(join(TEMPLATES, 'hook', 'lib', 'dispatcher.sh'), join(libDir, 'dispatcher.sh'))
+  chmodSync(join(libDir, 'dispatcher.sh'), 0o755)
+  // spec 2026-06-18 crash-recovery — transcript 변환 공유 helper + orphan flush recovery
+  cpSync(join(TEMPLATES, 'hook', 'lib', 'transcript.sh'), join(libDir, 'transcript.sh'))
+  chmodSync(join(libDir, 'transcript.sh'), 0o755)
+  cpSync(join(TEMPLATES, 'hook', 'lib', 'orphan-recovery.sh'), join(libDir, 'orphan-recovery.sh'))
+  chmodSync(join(libDir, 'orphan-recovery.sh'), 0o755)
+  // spec 2026-06-18 Phase 3 — Codex 어댑터 + cross-runtime sweep
+  cpSync(join(TEMPLATES, 'hook', 'lib', 'cross-runtime-sweep.sh'), join(libDir, 'cross-runtime-sweep.sh'))
+  chmodSync(join(libDir, 'cross-runtime-sweep.sh'), 0o755)
+  // 2026-06-24 — skill 로드 게이트 marker/epoch 공용 헬퍼 (session-start 가 source).
+  cpSync(join(TEMPLATES, 'hook', 'lib', 'skill-gate.sh'), join(libDir, 'skill-gate.sh'))
+  chmodSync(join(libDir, 'skill-gate.sh'), 0o755)
+  // 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)
+
+  return { binDir }
+}
+
+// ── 2층: Claude adapter — ~/.claude/skills + settings.json 병합 + 클라이언트 manifest.
+//    공유 런타임(1층)이 먼저 깔린 것을 전제로 settings 가 binDir 스크립트 경로를 가리킨다.
+export async function applyClaudeSetup({ scope, cfg, home, cwd } = {}) {
+  const { cli_version: CLI_VERSION, skill_version: SKILL_VERSION } = JSON.parse(readFileSync(VERSION_PATH, 'utf8'))
+  const base = join(resolveBase(scope, { home, cwd }), '.claude')
+  const skillDir = join(base, 'skills', 'rookie')
+  const settingsPath = join(base, 'settings.json')
+  const binDir = resolveBinDir(scope, { home, cwd })
+  const pretoolBinDir = join(binDir, 'bin')
+
+  mkdirSync(skillDir, { recursive: true })
+  const skillRaw = readFileSync(join(TEMPLATES, 'skill', 'SKILL.md'), 'utf8')
+  const skillRendered = skillRaw
+    .replaceAll('__VERSION__', SKILL_VERSION)
+    .replaceAll('__SCOPE__', scope)
+    .replaceAll('__INSTALLED_AT__', new Date().toISOString())
+    .replaceAll('__INSTALLED_BY__', `rookie-cli@${CLI_VERSION}`)
+  writeFileSync(join(skillDir, 'SKILL.md'), skillRendered)
+
+  // Windows 는 claudeHookCommand 가 `bash "<posix>"` 로 감싼다(아래 hook-command.js). macOS/Linux 무변경.
+  const settingsResult = await mergeSettings(settingsPath, join(TEMPLATES, 'hook', 'settings.partial.json'), {
+    flushCmd: claudeHookCommand(join(binDir, 'flush-session.sh')),
+    sessionStartCmd: claudeHookCommand(join(binDir, 'session-start.sh')),
+    pretoolMdReadCmd: claudeHookCommand(join(pretoolBinDir, 'pretool-md-read.sh')),
+    posttoolRecallNudgeCmd: claudeHookCommand(join(pretoolBinDir, 'posttool-recall-nudge.sh')),
+    guardCmd: claudeHookCommand(join(binDir, 'guard-destructive-db.sh')),
+    skillGateCmd: claudeHookCommand(join(binDir, 'user-prompt-skill-gate.sh')),
+  })
+
+  // §18 U-3 — 클라이언트 manifest 저장. 다음 hook turn 부터 미스매치 경고 비교 가능.
+  if (cfg?.endpoint && cfg?.token) {
+    try {
+      const status = await apiGet(cfg.endpoint, cfg.token, '/api/rookie/status')
+      if (status?.templates?.manifest_hash) {
+        saveClientManifest(status.templates)
+      }
+    } catch {
+      // 서버 §18 미반영 또는 도달 실패 — manifest.json 생성 안 함.
+      // 다음 `rookie update` 또는 다음 hook turn 의 status 호출 시 자동 채워짐.
+    }
+  }
+
+  // settings.json 파싱 실패로 hook 병합을 건너뛴 경우, 경고를 호출자(login·connect-ui)로 전파한다.
+  return { skillDir, settingsPath, settingsWarning: settingsResult?.merged === false ? settingsResult.reason : null }
+}
+
+// ── 3층: Codex adapter — ~/.codex/config.toml 의 managed 블록(upsertCodexHookBlock).
+//    scope=global 전제(D3): Codex config 는 항상 전역이고 전역 hook 을 문다. 호출 게이트는 오케스트레이터 책임.
+export function applyCodexSetup({ home = homedir() } = {}) {
+  const codexDir = join(home, '.codex')
+  const configPath = join(codexDir, 'config.toml')
+  const hookScript = join(home, '.rookie', 'bin', 'session-start.sh')
+  const existing = existsSync(configPath) ? readFileSync(configPath, 'utf8') : ''
+  let next
+  try {
+    next = upsertCodexHookBlock(existing, hookScript)
+  } catch (e) {
+    // marker 손상(begin 만 있고 end 없음) → 파일을 건드리지 않고 경고 신호만 반환(사용자 config 보호).
+    if (e?.code === 'MALFORMED_CODEX_MARKER') return { configPath, hookScript, error: 'malformed_marker' }
+    throw e
+  }
+  mkdirSync(codexDir, { recursive: true })
+  writeFileSync(configPath, next)
+  return { configPath, hookScript }
+}
+
+// init·login 공유 wrapper: 공유 런타임(1층) + Claude adapter(2층). 반환형은 기존과 동일.
+// PAT 발급은 호출자 책임(여기선 cfg 를 받기만).
+export async function deployClientArtifacts({ scope, cfg, home, cwd }) {
+  const { binDir } = installSharedHookRuntime({ scope, home, cwd })
+  const { skillDir, settingsPath } = await applyClaudeSetup({ scope, cfg, home, cwd })
+  return { skillDir, binDir, settingsPath }
+}
+
+async function mergeSettings(settingsPath, partialPath, subs) {
+  // placeholder 는 JSON 문자열 안 — 값을 JSON escape 해야 win32 의 bash "..." 가 JSON.parse 를 안 깬다.
+  const partialRaw = readFileSync(partialPath, 'utf8')
+    .replaceAll('__FLUSH_SESSION_CMD__', escapeJsonStringValue(subs.flushCmd))
+    .replaceAll('__SESSION_START_CMD__', escapeJsonStringValue(subs.sessionStartCmd))
+    .replaceAll('__PRETOOL_MD_READ_CMD__', escapeJsonStringValue(subs.pretoolMdReadCmd))
+    .replaceAll('__POSTTOOL_RECALL_NUDGE_CMD__', escapeJsonStringValue(subs.posttoolRecallNudgeCmd))
+    .replaceAll('__GUARD_DESTRUCTIVE_DB_CMD__', escapeJsonStringValue(subs.guardCmd))
+    .replaceAll('__USER_PROMPT_SKILL_GATE_CMD__', escapeJsonStringValue(subs.skillGateCmd))
+  const partial = JSON.parse(partialRaw)
+
+  let current = {}
+  if (existsSync(settingsPath)) {
+    try { current = JSON.parse(readFileSync(settingsPath, 'utf8')) }
+    catch {
+      // 기존 settings.json 이 깨진 JSON — 덮어쓰면 사용자 hook·설정이 소실된다. fail-closed:
+      // 병합을 건너뛰고 원본을 그대로 둔다. 호출자가 경고로 수동 점검을 안내한다(P1, codex).
+      return { merged: false, reason: 'settings_unparsable' }
+    }
+  }
+  const merged = mergeHooks(current, partial)
+  mkdirSync(dirname(settingsPath), { recursive: true })
+  writeFileSync(settingsPath, JSON.stringify(merged, null, 2))
+  return { merged: true }
+}

package/src/lib/hook-command.js

@@ -0,0 +1,31 @@
+// Windows 에서 Claude Code·Codex 는 hook command 를 Git Bash(bash)로 실행한다(공식 문서).
+// Node path.join 이 만든 backslash 절대경로(C:\Users\..\x.sh)를 bash command 에 그대로 넣으면
+// backslash 가 escape 로 해석돼 경로가 깨진다. → Windows 는 forward-slash 로 변환하고,
+// Claude 는 .sh 절대경로를 그대로 등록하던 것을 `bash "<path>"` 로 감싼다.
+// macOS/Linux 는 무변경 — 회귀 0 (platform !== 'win32' 면 입력을 그대로 반환).
+
+export function toPosixPath(absPath, platform = process.platform) {
+  if (platform !== 'win32') return absPath
+  return absPath.replace(/\\/g, '/')
+}
+
+// POSIX 셸 작은따옴표 quoting — 내부 ' 는 '\'' 로 escape. 경로의 $·백틱·공백·' 를 모두 리터럴화한다.
+//  (큰따옴표 "..." 는 $·백틱 확장 위험, 작은따옴표 단순 래핑은 O'Brien 같은 ' 경로에서 깨짐 → 표준 quoting.)
+export function shSingleQuote(s) {
+  return `'` + s.replace(/'/g, `'\\''`) + `'`
+}
+
+// Claude settings.json 의 hook command 한 줄.
+//  posix: .sh 절대경로 자체(Claude 가 sh -c 로 실행) — 기존 동작 유지.
+//  win32: `bash '<posix-path>'` — Git Bash 가 forward-slash 드라이브 경로를 이해. 경로는 표준 quoting.
+export function claudeHookCommand(absPath, platform = process.platform) {
+  if (platform !== 'win32') return absPath
+  return `bash ${shSingleQuote(toPosixPath(absPath, platform))}`
+}
+
+// settings.partial.json 은 placeholder 를 JSON 문자열("") 안에 두고 raw 치환한다.
+//  win32 command 값 `bash "C:/..."` 의 큰따옴표를 그대로 박으면 JSON.parse 가 깨지므로,
+//  치환 직전 \ 와 " 를 JSON 문자열 escape 한다. posix 값(따옴표·역슬래시 없음)엔 no-op.
+export function escapeJsonStringValue(s) {
+  return s.replace(/\\/g, '\\\\').replace(/"/g, '\\"')
+}

package/src/lib/manifest.js

@@ -0,0 +1,87 @@
+// 클라이언트측 manifest 헬퍼
+// spec post-v5-decisions §18 — hook 자동 동기화
+// ~/.rookie/manifest.json 읽기·쓰기 + 서버 hash 와 비교.
+
+import { readFileSync, writeFileSync, mkdirSync, chmodSync, existsSync, readdirSync, statSync } from 'node:fs'
+import { createHash } from 'node:crypto'
+import { homedir } from 'node:os'
+import { join, relative, sep } from 'node:path'
+
+const MANIFEST_PATH = join(homedir(), '.rookie', 'manifest.json')
+
+export function clientManifestPath() {
+  return MANIFEST_PATH
+}
+
+export function loadClientManifest() {
+  if (!existsSync(MANIFEST_PATH)) return null
+  try {
+    return JSON.parse(readFileSync(MANIFEST_PATH, 'utf8'))
+  } catch {
+    return null
+  }
+}
+
+export function saveClientManifest(manifest) {
+  if (!manifest || typeof manifest.manifest_hash !== 'string') {
+    throw new Error('saveClientManifest: invalid manifest')
+  }
+  mkdirSync(join(homedir(), '.rookie'), { recursive: true })
+  writeFileSync(MANIFEST_PATH, JSON.stringify(manifest, null, 2))
+  try { chmodSync(MANIFEST_PATH, 0o600) } catch {}
+}
+
+// task 77b93db0 — 자기 번들 템플릿의 manifest 를 서버 산식 그대로 계산.
+// 서버(src/lib/templates/manifest.ts · scripts/generate-template-manifest.mjs)와 **동일해야 한다** —
+// update 가 "내 번들 == 서버 선언" 을 검증해, 구 템플릿을 설치하며 신규 hash 를 선기록하는 사고를 막는다.
+const SKIP_NAME = /(^\.env)|(^\.env\.)|(\.key$)|(\.pem$)|(credentials)|(^\.DS_Store$)|(\.test\.(ts|js|sh)$)|(\.spec\.(ts|js|sh)$)/i
+
+function walkSorted(dir, base = dir) {
+  const out = []
+  let entries
+  try {
+    entries = readdirSync(dir)
+  } catch {
+    return out
+  }
+  for (const entry of entries) {
+    if (SKIP_NAME.test(entry)) continue
+    const full = join(dir, entry)
+    let st
+    try {
+      st = statSync(full)
+    } catch {
+      continue
+    }
+    if (st.isDirectory()) out.push(...walkSorted(full, base))
+    // 서버 manifest 는 POSIX 에서 생성되므로 Windows(sep='\\') 도 '/' 키로 정규화해야 hash 가 맞는다.
+    else if (st.isFile()) out.push(relative(base, full).split(sep).join('/'))
+  }
+  return out.sort()
+}
+
+function sha256Hex(input) {
+  return createHash('sha256').update(input).digest('hex')
+}
+
+export function computeBundleManifest(templatesDir, skillVersion) {
+  const files = {}
+  for (const rel of walkSorted(templatesDir)) {
+    files[rel] = sha256Hex(readFileSync(join(templatesDir, ...rel.split('/'))))
+  }
+  const manifest_hash = sha256Hex(
+    JSON.stringify({ skill_version: skillVersion, files: Object.fromEntries(Object.entries(files).sort()) })
+  )
+  return { manifest_hash, skill_version: skillVersion, files }
+}
+
+// returns { match: boolean, server_hash: string, local_hash: string|null }
+export function compareManifest(serverHash, local = null) {
+  const localManifest = local ?? loadClientManifest()
+  const localHash = localManifest?.manifest_hash ?? null
+  return {
+    match: typeof localHash === 'string' && localHash === serverHash,
+    server_hash: serverHash,
+    local_hash: localHash,
+  }
+}

package/src/lib/merge-hooks.js

@@ -0,0 +1,31 @@
+// spec 2026-07-10 recall-first 회귀 수정 §3.C — settings.json hook 병합 공유 모듈.
+// 배경: Claude Code 가 settings.json 을 재작성할 때 스키마 밖 키(__rookie_managed)를
+// 제거한다. 마커만 믿는 병합은 기존 rookie 항목을 사용자 항목으로 오인해 append 만
+// 반복 → 항목 증식(실측 3중). 판정 주축을 hook command 의 경로 서명으로 옮긴다.
+// deploy-artifacts.js(init/login)와 update.js(rookie update)가 함께 import 한다 —
+// 한쪽만 고치면 실배포 경로에서 자가 치유가 빠진다(codex R2-P1).
+
+// 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|sweep-recovery|refresh-context)\.sh\b/
+
+export function isRookieEntry(entry) {
+  if (!entry || typeof entry !== 'object') return false
+  if (entry.__rookie_managed) return true
+  const hooks = Array.isArray(entry.hooks) ? entry.hooks : []
+  return hooks.some(
+    (h) => typeof h?.command === 'string' && ROOKIE_HOOK_SCRIPTS.test(h.command)
+  )
+}
+
+export function mergeHooks(existing, partial) {
+  const out = { ...existing }
+  out.hooks = { ...(existing.hooks ?? {}) }
+  for (const [event, entries] of Object.entries(partial.hooks ?? {})) {
+    const existingEntries = out.hooks[event] ?? []
+    const nonRookie = existingEntries.filter((e) => !isRookieEntry(e))
+    out.hooks[event] = [...nonRookie, ...entries]
+  }
+  return out
+}

package/src/lib/orphan-extract-core.js

@@ -0,0 +1,113 @@
+// B3 (spec 2026-07-11-memory-reliability-fix-design §B3) — orphan-extract 초안 생성 코어.
+// LLM 없이 rule-base 후보만 뽑는다: 마지막 user/assistant 요약 라인 · 파일 경로 · git sha.
+// 저장 판단은 세션 LLM/사용자 몫(서버 LLM 추출 금지 원칙 유지). stdout 위생은 redact-lite 경유.
+import { existsSync, readdirSync, readFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { redactDraftText, hashId8 } from './redact-lite.js'
+
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i
+
+// codex 세션은 marker 가 codex 서브루트에 있어 ROOKIE_ORPHAN_DIR 를 실어야 큐에서 빠진다.
+export function markerCommand(entry) {
+  const prefix = entry.markerRoot ? `ROOKIE_ORPHAN_DIR="${entry.markerRoot}" ` : ''
+  return `${prefix}orphan_mark_client_extracted ${entry.sid}`
+}
+
+// pending-extraction marker 수집 (Claude 루트 + codex 서브루트) — 오래된 것부터.
+export function listPendingExtractions({ orphanRoot }) {
+  const out = []
+  for (const runtime of ['claude', 'codex']) {
+    const dir = runtime === 'claude'
+      ? join(orphanRoot, 'pending-extraction')
+      : join(orphanRoot, 'codex', 'pending-extraction')
+    if (!existsSync(dir)) continue
+    let names
+    try { names = readdirSync(dir).filter((f) => f.endsWith('.json')) } catch { continue }
+    for (const name of names) {
+      const sid = name.slice(0, -5)
+      if (!UUID_RE.test(sid)) continue
+      try {
+        const m = JSON.parse(readFileSync(join(dir, name), 'utf8'))
+        out.push({
+          sid,
+          runtime,
+          transcriptPath: m.transcript_path || '',
+          recoveredAt: m.recovered_at || null,
+          // codex marker 는 codex 서브루트에 산다 — marker 명령이 이 루트를 겨냥해야
+          // 큐에서 실제로 빠진다(코드검토 P2). orphan-recovery.sh 의 ROOKIE_ORPHAN_DIR 규약.
+          markerRoot: runtime === 'codex' ? join(orphanRoot, 'codex') : null,
+        })
+      } catch { /* 깨진 marker — skip (다음 기회) */ }
+    }
+  }
+  out.sort((a, b) => {
+    const ta = a.recoveredAt ? Date.parse(a.recoveredAt) : Infinity
+    const tb = b.recoveredAt ? Date.parse(b.recoveredAt) : Infinity
+    return ta - tb
+  })
+  return out
+}
+
+// 스캐폴딩(주입 지시문) 메시지 제외 — 초안 노이즈 차단.
+function isScaffold(content) {
+  const head = content.slice(0, 60)
+  return (
+    head.startsWith('# AGENTS.md') ||
+    head.startsWith('<environment_context>') ||
+    head.startsWith('<permissions instructions>') ||
+    head.startsWith('[Rookie]')
+  )
+}
+
+const PATH_RE = /(?:^|[\s"'`(])((?:\/[A-Za-z0-9._@-]+){2,})/g
+const SHA_RE = /\b[0-9a-f]{7,40}\b/g
+
+// messages = [{role, content}] (sweep-core parse 결과) → rule-base 초안.
+export function buildDraft(messages, { userMax = 300, assistantMax = 400, pathCap = 10, shaCap = 5 } = {}) {
+  const real = messages.filter((m) => m.content && !isScaffold(m.content))
+  const lastOf = (role) => {
+    for (let i = real.length - 1; i >= 0; i--) if (real[i].role === role) return real[i].content
+    return null
+  }
+  const lastUser = lastOf('user')
+  const lastAssistant = lastOf('assistant')
+
+  const paths = new Set()
+  const shas = new Set()
+  for (const m of real) {
+    for (const match of m.content.matchAll(PATH_RE)) {
+      if (paths.size >= pathCap) break
+      paths.add(match[1])
+    }
+    for (const match of m.content.matchAll(SHA_RE)) {
+      if (shas.size >= shaCap) break
+      const s = match[0]
+      // uuid 조각·순수 숫자 배제 — git sha 는 대개 7~12자 + 영문자 혼재.
+      if (s.length > 12 || !/[a-f]/.test(s) || !/\d/.test(s)) continue
+      shas.add(s)
+    }
+  }
+  return {
+    lastUser: lastUser ? lastUser.slice(0, userMax) : null,
+    lastAssistant: lastAssistant ? lastAssistant.slice(0, assistantMax) : null,
+    filePaths: [...paths],
+    gitShas: [...shas],
+  }
+}
+
+// 초안 렌더 (전 라인 redact 통과). sid 는 후속 처리(orphan_mark_client_extracted)에 필요해
+// 처리 명령 라인에만 원문 표기 — 본인 로컬 세션 id 로, SessionStart 🛟 블록과 동일 노출 수준.
+// 본문·요약 안의 UUID·민감정보는 redact-lite 가 마스킹한다(§10d/e).
+export function renderDraft(entry, draft) {
+  const lines = []
+  const clean = (s) => redactDraftText(s).redacted.replace(/\s+/g, ' ').trim()
+  lines.push(`◦ [${entry.runtime}] 세션 ${hashId8(entry.sid)} (recovered ${entry.recoveredAt ?? 'unknown'})`)
+  if (draft.lastUser) lines.push(`  마지막 user: ${clean(draft.lastUser)}`)
+  if (draft.lastAssistant) lines.push(`  마지막 assistant: ${clean(draft.lastAssistant)}`)
+  if (draft.filePaths.length) lines.push(`  파일 경로: ${draft.filePaths.map((p) => clean(p)).join(' · ')}`)
+  if (draft.gitShas.length) lines.push(`  git sha: ${draft.gitShas.join(' · ')}`)
+  if (!draft.lastUser && !draft.lastAssistant) lines.push('  (요약할 본문 없음 — transcript 직접 확인 필요)')
+  lines.push(`  → 판단 후 저장(batch-mutate) → 완료 marker: ${markerCommand(entry)}`)
+  lines.push(`     transcript: ${entry.transcriptPath || '(경로 없음)'}`)
+  return lines
+}

package/src/lib/orphan-pending.js

@@ -0,0 +1,49 @@
+// P4.3 2차-b (plan 2026-06-22-memory-reliability-recurrence-prevention §P4) —
+// orphan_pending_age 관측. 비정상 종료 세션의 tail 추출 대기 큐
+// (~/.rookie/orphan-recovery/pending-extraction/*.json) 가 얼마나 오래/많이 밀렸는지
+// doctor 가 한 줄로 보여준다. 데이터 소스가 서버 DB 가 아닌 로컬 hook 파일이라 doctor 영역.
+// pending marker 는 {status,transcript_path,recovered_at,message_count} (orphan-recovery.sh:119).
+
+const DAY_MS = 24 * 60 * 60 * 1000
+
+// markers = 파싱된 pending marker 객체 배열({recovered_at} 사용). nowMs 기준 최고령 산출.
+// 반환: count(전체 대기) / oldestRecoveredAt(ISO|null) / oldestAgeDays(floor, 없으면 0)
+export function summarizeOrphanPending(markers, nowMs) {
+  let oldestTs = null
+  for (const m of markers) {
+    const ts = m && m.recovered_at ? Date.parse(m.recovered_at) : NaN
+    if (Number.isNaN(ts)) continue // 시점 불명 → 최고령에서 보수적 제외(count 엔 포함)
+    if (oldestTs === null || ts < oldestTs) oldestTs = ts
+  }
+  return {
+    count: markers.length,
+    oldestRecoveredAt: oldestTs === null ? null : new Date(oldestTs).toISOString(),
+    oldestAgeDays: oldestTs === null ? 0 : Math.floor((nowMs - oldestTs) / DAY_MS),
+  }
+}
+
+// ── B3 (spec 2026-07-11-memory-reliability-fix-design §B3) — 적체 임계 + expired 손실 ──
+
+const HOUR_MS = 60 * 60 * 1000
+
+// B3 임계: 미추출 > 5건 또는 최고령 > 24h (tail TTL 3일보다 짧게 — codex 1R P1-3).
+export const BACKLOG_MAX_COUNT = 5
+export const BACKLOG_MAX_AGE_HOURS = 24
+
+// pending marker 배열(멀티 루트 합산) + expired 누적 → backlog 요약.
+// oldestAgeHours 는 floor — 24h 임계 비교용 정밀도.
+export function summarizeOrphanBacklog({ pendingMarkers, expiredCount, nowMs }) {
+  const base = summarizeOrphanPending(pendingMarkers, nowMs)
+  let oldestTs = base.oldestRecoveredAt === null ? null : Date.parse(base.oldestRecoveredAt)
+  return {
+    count: base.count,
+    oldestRecoveredAt: base.oldestRecoveredAt,
+    oldestAgeDays: base.oldestAgeDays,
+    oldestAgeHours: oldestTs === null ? 0 : Math.floor((nowMs - oldestTs) / HOUR_MS),
+    expiredCount: Number.isFinite(expiredCount) ? expiredCount : 0,
+  }
+}
+
+export function orphanBacklogWarn(s) {
+  return s.count > BACKLOG_MAX_COUNT || s.oldestAgeHours > BACKLOG_MAX_AGE_HOURS
+}

package/src/lib/parse-hook-cwd.js

@@ -0,0 +1,11 @@
+// SessionStart hook stdin 의 cwd 를 안전 추출. Claude·Codex 공통 페이로드 필드.
+// Codex hook 은 실행 디렉토리가 프로젝트와 다를 수 있어 stdin cwd 가 정확하다.
+export function parseHookCwd(stdinBody, fallback) {
+  try {
+    const j = JSON.parse(stdinBody)
+    const cwd = (j.cwd || '').toString().trim()
+    return cwd || fallback
+  } catch {
+    return fallback
+  }
+}

package/src/lib/poll-state.js

@@ -0,0 +1,14 @@
+// device/token 폴링 응답 → CLI 다음 동작. 네트워크와 분리해 테스트 가능하게.
+export function interpretPoll(resp, interval) {
+  switch (resp?.status) {
+    case 'approved':
+      return { action: 'done', token: resp.token, user_id: resp.user_id, label: resp.label ?? null, agent_name: resp.agent_name ?? null, interval }
+    case 'authorization_pending':
+      return { action: 'wait', interval }
+    case 'slow_down':
+      return { action: 'wait', interval: interval + 5 }
+    case 'expired':
+    default:
+      return { action: 'stop', reason: 'expired', interval }
+  }
+}

package/src/lib/redact-lite.js

@@ -0,0 +1,55 @@
+// B3 (spec 2026-07-11-memory-reliability-fix-design §B3) — orphan-extract stdout 위생.
+// 서버 redactor(src/lib/privacy/redactor.ts REDACTION_PATTERNS)의 CLI 포팅.
+// CLI 는 Node 내장만 쓰므로 서버 모듈을 import 하지 못한다 — 패턴을 동일하게 복제하고,
+// 서버 쪽이 바뀌면 여기도 함께 갱신한다(패턴 원본 = redactor.ts, 순서 동일).
+import { createHash } from 'node:crypto'
+
+// 순서 중요: 구체 패턴 먼저 (서버 REDACTION_PATTERNS 와 동일).
+export const REDACTION_PATTERNS = [
+  { kind: 'pem_block', pattern: /-----BEGIN [A-Z ]+-----[\s\S]+?-----END [A-Z ]+-----/g },
+  { kind: 'anthropic_key', pattern: /sk-ant-[A-Za-z0-9_-]{20,}/g },
+  { kind: 'openai_key', pattern: /\bsk-(?!ant-)[A-Za-z0-9_-]{20,}\b/g },
+  { kind: 'slack_token', pattern: /\bxox[abprs]-[A-Za-z0-9-]{10,}\b/g },
+  { kind: 'github_token', pattern: /\b(?:gh[pousr]_[A-Za-z0-9]{36,}|github_pat_[A-Za-z0-9_]{60,})\b/g },
+  { kind: 'rookie_pat', pattern: /\brk_[a-fA-F0-9]{64}\b/g },
+  { kind: 'aws_access_key', pattern: /\bAKIA[0-9A-Z]{16}\b/g },
+  {
+    kind: 'aws_secret',
+    pattern: /\b(?:aws_secret_access_key|AWS_SECRET_ACCESS_KEY)\s*[:=]\s*['"]?[A-Za-z0-9/+=]{40}['"]?/g,
+  },
+  { kind: 'jwt', pattern: /\beyJ[A-Za-z0-9_-]+\.eyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\b/g },
+  { kind: 'ssn_kr', pattern: /\b\d{6}-[1-4]\d{6}\b/g },
+  { kind: 'credit_card', pattern: /\b(?:\d{4}[ -]){3}\d{4}\b/g },
+  {
+    kind: 'hex_secret_labeled',
+    pattern: /(?:token|key|secret|password|pw|api[_-]?key|auth|session)\s*[:=]\s*['"]?[a-fA-F0-9]{24,}['"]?/gi,
+  },
+  { kind: 'env_assignment', pattern: /^[A-Z][A-Z0-9_]{3,}=\S{8,}$/gm },
+  {
+    kind: 'password_label',
+    pattern: /(?:password|passwd|비밀번호|pw)\s*[:=]\s*(?:['"][^'"\n]{6,}['"]|[^\s'"\n][^\n]{5,})/gi,
+  },
+]
+
+// 서버 log-redact.ts hashId8 과 동일 산식 (sha256 hex 앞 8자).
+export function hashId8(id) {
+  if (!id) return '∅'
+  return createHash('sha256').update(String(id)).digest('hex').slice(0, 8)
+}
+
+const UUID_IN_TEXT_RE = /\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/gi
+
+// stdout 초안 위생: 민감정보 → [REDACTED:<kind>], 본문 내 UUID → hashId8 마스킹 (§10d/e).
+export function redactDraftText(text) {
+  if (!text) return { redacted: text ?? '', totalHits: 0 }
+  let out = text
+  let totalHits = 0
+  for (const p of REDACTION_PATTERNS) {
+    out = out.replace(p.pattern, () => {
+      totalHits++
+      return `[REDACTED:${p.kind}]`
+    })
+  }
+  out = out.replace(UUID_IN_TEXT_RE, (m) => `uuid:${hashId8(m.toLowerCase())}`)
+  return { redacted: out, totalHits }
+}

package/src/lib/resolve-endpoint.js

@@ -0,0 +1,8 @@
+// endpoint 결정 우선순위: 플래그 > env(ROOKIE_ENDPOINT) > 기존 config > 기본값(therookie.kr).
+// 공개 사용자가 endpoint 를 손입력하지 않게, install.sh 는 ROOKIE_ENDPOINT 로 비대화 주입.
+const DEFAULT_ENDPOINT = 'https://therookie.kr'
+
+export function resolveEndpoint({ flag, env, config } = {}) {
+  const pick = flag || env || config || DEFAULT_ENDPOINT
+  return pick.replace(/\/$/, '')
+}