therookie 0.4.3

package/src/commands/doctor.js

@@ -0,0 +1,710 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { execSync } from 'node:child_process'
+import { detectGlobalInstall, detectLocalInstall, deepScanForLocalInstalls } from '../detect.js'
+import { resolveConfig, getHostname } from '../config.js'
+import { apiGet } from '../api.js'
+import { accountLine, accountWarning } from '../lib/account-ui.js'
+import { loadClientManifest } from '../lib/manifest.js'
+import {
+  summarizeOrphanBacklog,
+  orphanBacklogWarn,
+  BACKLOG_MAX_COUNT,
+  BACKLOG_MAX_AGE_HOURS,
+} from '../lib/orphan-pending.js'
+import { classifyDeadLetters, readDeadLetterEntries } from '../lib/dead-letter.js'
+import { isRookieEntry } from '../lib/merge-hooks.js'
+import { computeReport } from '../lib/context-diet.js'
+import { printHuman as printDietReport } from './context-diet.js'
+
+// spec 2026-07-13 NFC — 서버 local_path 는 NFC 통일, macOS cwd 는 NFD 라 raw === 는
+// 한글 경로에서 false warning("현재 cwd 미매핑")을 낸다. 양쪽 NFC 로 맞춰 비교.
+export function samePathNFC(a, b) {
+  return a.normalize('NFC') === b.normalize('NFC')
+}
+
+export async function runDoctor(flags) {
+  // B3 (spec 2026-07-11 §B3) — 사유별 집계 상세 모드. 전체 진단 없이 dead letter 만 본다.
+  if (flags['dead-letters']) {
+    printDeadLetterReport()
+    return
+  }
+  const g = detectGlobalInstall()
+  const l = detectLocalInstall()
+  console.log('== Rookie Doctor ==')
+  console.log(`hostname: ${getHostname()}`)
+
+  console.log(g ? `✓ 글로벌 Skill (v${g.version})` : '✗ 글로벌 Skill 없음')
+  console.log(l ? `✓ 로컬 Skill (v${l.version})` : `  로컬 Skill 없음 (${process.cwd()})`)
+
+  const gSettings = join(homedir(), '.claude', 'settings.json')
+  const lSettings = join(process.cwd(), '.claude', 'settings.json')
+  console.log(hasRookieHook(gSettings) ? '✓ 글로벌 hook 등록됨' : '✗ 글로벌 hook 없음')
+  console.log(hasRookieHook(lSettings) ? '✓ 로컬 hook 등록됨' : '  로컬 hook 없음')
+
+  if (g && l && g.version !== l.version) {
+    console.log(`⚠ 버전 불일치: 글로벌 v${g.version} vs 로컬 v${l.version}`)
+    console.log('   → 해결: rookie unlink --local 또는 rookie init --local')
+  }
+
+  // B6-1: env > 로컬(상향 탐색) > 전역 해석 — 어느 config 로 진단 중인지 표시.
+  const resolvedCfg = resolveConfig()
+  const cfg = resolvedCfg.config
+  if (cfg && resolvedCfg.scope !== 'global') {
+    console.log(`— config: [${resolvedCfg.scope}] ${resolvedCfg.path ?? '(env 주입)'}`)
+  }
+  let serverStatus = null
+  if (cfg) {
+    try {
+      serverStatus = await apiGet(cfg.endpoint, cfg.token, '/api/rookie/status')
+      console.log(`✓ 앱 연결 (version=${serverStatus.version})`)
+      // B1-2 (spec 2026-07-11 §B1): 계정 요약 + 빈-계정 경고(⚠️ 레벨, 중립 — 금지).
+      const acctLine = accountLine(serverStatus?.account)
+      if (acctLine) console.log(acctLine)
+      const acctWarn = accountWarning(serverStatus?.account)
+      if (acctWarn) console.log(acctWarn)
+    } catch (e) {
+      console.log(`✗ 앱 연결 실패: ${e.message}`)
+    }
+    try {
+      const { paths } = await apiGet(
+        cfg.endpoint,
+        cfg.token,
+        `/api/rookie/projects/local-paths?hostname=${encodeURIComponent(getHostname())}`
+      )
+      if (paths.length > 0) {
+        console.log(`— DB 등록된 로컬 경로 ${paths.length}개`)
+        const cwd = process.cwd()
+        let staleCount = 0
+        let cwdMatched = false
+        for (const p of paths) {
+          const exists = existsSync(p.local_path)
+          const isCwd = samePathNFC(p.local_path, cwd)
+          if (isCwd) cwdMatched = true
+          if (!exists) staleCount++
+          const marker = !exists ? '⚠ stale' : isCwd ? '◎ 현재 cwd' : ' '
+          console.log(`   ${marker} ${p.local_path} (${p.install_scope})`)
+        }
+        if (staleCount > 0) {
+          console.log(
+            `   → stale 매핑 ${staleCount}건: 디렉토리가 사라졌거나 이전됨. 정정은 별도 운영 작업 필요.`
+          )
+        }
+        if (!cwdMatched) {
+          console.log(
+            `   → 현재 cwd 미매핑: ${cwd}. repo_url 1차 매칭이 살아 있으면 운영 영향 없음. 백업 매칭 필요시 'rookie link'.`
+          )
+        }
+      } else {
+        // B2 (spec 2026-07-11 §B2): 무귀속 열화 모드 — cwd 가 git repo(remote 존재)인데
+        // 이 hostname 등록 경로가 0 이면 중립이 아니라 ⚠️ + 처방(rookie link).
+        let hasRemote = false
+        try {
+          hasRemote = !!execSync('git remote get-url origin', { stdio: ['ignore', 'pipe', 'ignore'] }).toString().trim()
+        } catch {}
+        if (hasRemote) {
+          console.log(`⚠️ DB 등록된 로컬 경로 0개 (이 hostname 기준) — 기억이 프로젝트 무귀속(열화 모드)으로 저장됩니다. 처방: rookie link`)
+        } else {
+          console.log(`— DB 등록된 로컬 경로 0개 (이 hostname 기준)`)
+        }
+      }
+    } catch {}
+  } else {
+    console.log('✗ ~/.rookie/config.json 없음 — rookie init 먼저')
+  }
+
+  printTemplateManifestStatus(serverStatus)
+  printQueueStatus()
+  printOrphanPending()
+  printIdentityMismatch()
+  await printStage1Metric(cfg)
+  await printDedupMetric(cfg)
+  await printRecallMetric(cfg)
+  await printDirectiveMetric(cfg)
+  await printHotWriteMetric(cfg)
+  await printAttributionMetric(cfg)
+  await printPromotionMetric(cfg)
+  await printViolationTop(cfg)
+  await printEmbeddingGuard(cfg)
+  await printInjectionSize(cfg)
+  printContextDiet()
+
+  if (flags['deep-scan']) {
+    const found = deepScanForLocalInstalls([homedir()], 3)
+    if (found.length > 0) {
+      console.log(`— deep-scan 발견 로컬 Skill ${found.length}개`)
+      for (const f of found) console.log(`   - ${f.projectDir} v${f.version}`)
+    }
+  }
+}
+
+// spec 2026-07-10-context-diet-design.md §2.4 — 상시 출력. 파일 크기 측정은 fresh,
+// transcript 사용 이력만 7일 캐시 재사용(cache-only — doctor 가 전체 transcript 를 다시 훑지 않는다).
+function printContextDiet() {
+  console.log('— 컨텍스트 다이어트 (설치 자산 proxy)')
+  try {
+    const report = computeReport({ usageMode: 'cache-only' })
+    printDietReport(report, (line) => console.log(`   ${line}`))
+    const snoozeKeys = Object.keys(report.snooze || {})
+    if (snoozeKeys.length) console.log(`   snooze 중: ${snoozeKeys.join(', ')}`)
+  } catch (e) {
+    console.log(`   ✗ 측정 실패: ${e.message}`)
+  }
+}
+
+function hasRookieHook(settingsPath) {
+  if (!existsSync(settingsPath)) return false
+  try {
+    const s = JSON.parse(readFileSync(settingsPath, 'utf8'))
+    const events = s.hooks ?? {}
+    for (const entries of Object.values(events)) {
+      for (const entry of entries ?? []) {
+        // spec 2026-07-10 — Claude Code 가 마커를 제거해도 경로 서명으로 감지.
+        if (isRookieEntry(entry)) return true
+      }
+    }
+    return false
+  } catch {
+    return false
+  }
+}
+
+// spec 2026-07-10 §3.D — SessionStart 주입 크기 점검. Claude Code 는 hook 출력이
+// 10,000자를 넘으면 인라인 대신 파일 persist + preview 만 주입한다(v2.1.191+).
+// hook 과 동일한 inject_budget 으로 context 를 받아 임계 초과(=예산제 회귀·구서버)를 잡는다.
+const CLAUDE_HOOK_OUTPUT_CAP = 10000
+const HOOK_INJECT_BUDGET = 8500
+async function printInjectionSize(cfg) {
+  if (!cfg?.endpoint || !cfg?.token) return
+  try {
+    const ctx = await apiGet(
+      cfg.endpoint,
+      cfg.token,
+      `/api/rookie/context?inject_budget=${HOOK_INJECT_BUDGET}`
+    )
+    const size = typeof ctx?.system_prompt === 'string' ? ctx.system_prompt.length : null
+    if (size === null) return
+    if (size > CLAUDE_HOOK_OUTPUT_CAP) {
+      console.log(
+        `⚠ SessionStart 주입 ${size}자 — Claude Code ${CLAUDE_HOOK_OUTPUT_CAP}자 임계 초과, 인라인 미주입(회귀). 서버 inject_budget 미반영 여부 확인 필요`
+      )
+    } else {
+      console.log(`✓ SessionStart 주입 크기 ${size}자 (임계 ${CLAUDE_HOOK_OUTPUT_CAP}자 이내)`)
+    }
+  } catch {
+    // silent — endpoint 미응답 시 본 라인만 누락.
+  }
+}
+
+// spec post-v5-decisions §18 — templates manifest 비교 가시화
+function printTemplateManifestStatus(serverStatus) {
+  const local = loadClientManifest()
+  const localHash = local?.manifest_hash ?? null
+  const serverHash = serverStatus?.templates?.manifest_hash ?? null
+
+  if (!serverHash) {
+    if (localHash) {
+      console.log(`— templates: 로컬 manifest ${localHash.slice(0, 12)}… / 서버 미응답`)
+    }
+    return
+  }
+
+  if (!localHash) {
+    console.log(`⚠ templates: 로컬 manifest 없음 (옛 install) / 서버 ${serverHash.slice(0, 12)}…`)
+    console.log(`   → \`rookie update\` 실행 권장`)
+    return
+  }
+
+  if (localHash === serverHash) {
+    console.log(`✓ templates manifest 동기화 (${localHash.slice(0, 12)}…)`)
+  } else {
+    console.log(`⚠ templates manifest 미스매치`)
+    console.log(`   서버: ${serverHash.slice(0, 12)}…`)
+    console.log(`   로컬: ${localHash.slice(0, 12)}…`)
+    console.log(`   → \`rookie update\` 실행 권장`)
+  }
+}
+
+// spec post-v5-decisions §17 (2026-05-05 v6 P1 #3 §17.3 보강) — hook offline queue 가시화
+// 형식: endpoint 별 카운트 + oldest_queued_at ISO + age + dead_letters + last_success
+function printQueueStatus() {
+  const queueDir = join(homedir(), '.rookie', 'pending')
+  const deadDir = join(homedir(), '.rookie', 'dead-letter')
+  const lastSuccessFile = join(homedir(), '.rookie', 'last_success')
+
+  let lastSuccessLine = ''
+  if (existsSync(lastSuccessFile)) {
+    try {
+      const ts = readFileSync(lastSuccessFile, 'utf8').trim()
+      const t = Date.parse(ts)
+      if (!isNaN(t)) {
+        const minsAgo = Math.max(0, Math.floor((Date.now() - t) / 60000))
+        lastSuccessLine = `last hook success: ${minsAgo}분 전 (${ts})`
+      }
+    } catch {}
+  }
+  if (!lastSuccessLine) lastSuccessLine = 'last hook success: 이력 없음'
+  console.log(`— ${lastSuccessLine}`)
+
+  // B3 — 카운트만이 아니라 최근 실패 사유까지 라벨로. 상세 집계는 doctor --dead-letters.
+  const dead = classifyDeadLetters(readDeadLetterEntries(deadDir))
+  const deadLabel =
+    dead.total === 0
+      ? '0'
+      : `${dead.total} (최근 ${dead.recent ? `${dead.recent.kind}/${dead.recent.bucket}` : 'unknown'} — 상세: rookie doctor --dead-letters)`
+
+  if (!existsSync(queueDir)) {
+    console.log(`— queue: clean (디렉토리 없음) / dead_letters: ${deadLabel}`)
+    return
+  }
+  let files
+  try {
+    files = readdirSync(queueDir).filter((f) => f.endsWith('.jsonl'))
+  } catch {
+    console.log('— queue: 읽기 실패')
+    return
+  }
+  if (files.length === 0) {
+    console.log(`— queue: clean / dead_letters: ${deadLabel}`)
+    return
+  }
+  // §17.2 H-2.2 — endpoint 분류 (mutate/retry/flush)
+  const endpoints = { 'batch-mutate': 0, 'mutate-retry': 0, 'flush-session': 0 }
+  let totalLines = 0
+  let oldestTs = null
+  let maxRetry = 0
+  for (const f of files) {
+    if (f.endsWith('-mutate-retry.jsonl')) endpoints['mutate-retry']++
+    else if (f.endsWith('-mutate.jsonl')) endpoints['batch-mutate']++
+    else endpoints['flush-session']++
+    try {
+      const data = readFileSync(join(queueDir, f), 'utf8')
+      for (const line of data.split('\n').filter(Boolean)) {
+        totalLines++
+        try {
+          const obj = JSON.parse(line)
+          const t = Date.parse(obj.queued_at)
+          if (!isNaN(t) && (oldestTs === null || t < oldestTs)) oldestTs = t
+          if ((obj.retry_count || 0) > maxRetry) maxRetry = obj.retry_count
+        } catch {}
+      }
+    } catch {}
+  }
+  const oldestIso = oldestTs === null ? 'unknown' : new Date(oldestTs).toISOString()
+  const ageStr =
+    oldestTs === null
+      ? 'unknown'
+      : (() => {
+          const secs = Math.max(0, Math.floor((Date.now() - oldestTs) / 1000))
+          if (secs < 60) return `${secs}초`
+          const mins = Math.floor(secs / 60)
+          if (mins < 60) return `${mins}분 ${secs % 60}초`
+          const hours = Math.floor(mins / 60)
+          return `${hours}시간 ${mins % 60}분`
+        })()
+  console.log(
+    `⚠ queue: ${totalLines}건 / ${files.length}세션 / endpoints { batch-mutate: ${endpoints['batch-mutate']}, mutate-retry: ${endpoints['mutate-retry']}, flush-session: ${endpoints['flush-session']} }`
+  )
+  console.log(`   oldest_queued_at: ${oldestIso} (age ${ageStr})`)
+  console.log(`   max retry: ${maxRetry} / dead_letters: ${deadLabel}`)
+  console.log(`   → 큐 위치: ${queueDir}`)
+}
+
+// B3 (spec 2026-07-11 §B3) — dead letter 사유별 집계 상세 모드 (rookie doctor --dead-letters).
+// mutate_invalid(4xx 정책 거부)는 재전송해도 같은 이유로 거부되므로 본문 수정이 처방,
+// 5xx/network 는 서버·네트워크 복구 후 수동 재전송 검토 대상 — 처방이 달라 사유를 나눠 보여준다.
+function printDeadLetterReport() {
+  const deadDir = join(homedir(), '.rookie', 'dead-letter')
+  const entries = readDeadLetterEntries(deadDir)
+  if (entries.length === 0) {
+    console.log('dead letters: clean (0건)')
+    return
+  }
+  const s = classifyDeadLetters(entries)
+  const fmt = (obj) =>
+    Object.entries(obj)
+      .sort((a, b) => b[1] - a[1])
+      .map(([k, v]) => `${k} ${v}`)
+      .join(' / ')
+  console.log(`== Dead letters — ${s.total}건 (${deadDir}) ==`)
+  console.log(`— 종류: ${fmt(s.byKind)}`)
+  console.log(`— 사유: ${fmt(s.byStatus)}`)
+  if (s.recent) console.log(`— 최근: ${s.recent.kind}/${s.recent.bucket} (${s.recent.at})`)
+  if (s.byStatus.http_4xx) {
+    console.log('   → http_4xx(정책 거부)는 재전송 무의미 — 본문에서 거부 원인(메타 카드·민감정보 마커 등) 제거 후 수동 재저장.')
+  }
+  if (s.byStatus.http_5xx || s.byStatus.network) {
+    console.log('   → http_5xx/network 는 일시 장애 산물 — 서버 복구 확인 후 수동 재전송 검토.')
+  }
+}
+
+// P4.3 2차-b → B3 (spec 2026-07-11 §B3) — orphan tail 적체 가시화.
+// 데이터 소스 = 로컬 hook 파일(~/.rookie/orphan-recovery/, codex 서브루트 포함), 서버 DB 아님.
+// 임계(>5건 또는 최고령>24h — tail TTL 3일보다 짧게) 초과 시 ⚠️ + 예상 손실 설명.
+// expired(TTL 초과로 이미 손실된 tail) 는 별도 손실 카운터 — 손실이 보이지 않으면 RC1 재발.
+function readOrphanDir(dir) {
+  if (!existsSync(dir)) return { markers: [], readFailed: false }
+  let files
+  try {
+    files = readdirSync(dir).filter((f) => f.endsWith('.json'))
+  } catch {
+    return { markers: [], readFailed: true }
+  }
+  const markers = []
+  for (const f of files) {
+    try {
+      markers.push(JSON.parse(readFileSync(join(dir, f), 'utf8')))
+    } catch {
+      markers.push({}) // 깨진 marker 도 count 엔 포함(fail-soft), 최고령엔 제외
+    }
+  }
+  return { markers, readFailed: false }
+}
+
+function countDirEntries(dir, suffix = '.json') {
+  if (!existsSync(dir)) return 0
+  try {
+    return readdirSync(dir).filter((f) => f.endsWith(suffix)).length
+  } catch {
+    return 0
+  }
+}
+
+function printOrphanPending() {
+  const root = join(homedir(), '.rookie', 'orphan-recovery')
+  const claude = readOrphanDir(join(root, 'pending-extraction'))
+  const codex = readOrphanDir(join(root, 'codex', 'pending-extraction'))
+  if (claude.readFailed && codex.readFailed) {
+    console.log('— orphan pending: 읽기 실패')
+    return
+  }
+  const expiredCount =
+    countDirEntries(join(root, 'expired')) + countDirEntries(join(root, 'codex', 'expired'))
+  const s = summarizeOrphanBacklog({
+    pendingMarkers: [...claude.markers, ...codex.markers],
+    expiredCount,
+    nowMs: Date.now(),
+  })
+  if (s.count === 0) {
+    console.log('— orphan pending: clean (대기 없음)')
+  } else {
+    const warn = orphanBacklogWarn(s)
+    const prefix = warn ? '⚠️ ' : '— '
+    const age = s.oldestAgeHours >= 48 ? `${s.oldestAgeDays}일` : `${s.oldestAgeHours}시간`
+    console.log(
+      `${prefix}orphan pending: ${s.count}건 대기 (Claude ${claude.markers.length} / Codex ${codex.markers.length}), 최고령 ${age} (${s.oldestRecoveredAt ?? 'unknown'})`
+    )
+    if (warn) {
+      console.log(
+        `   → 임계 초과(>${BACKLOG_MAX_COUNT}건 또는 >${BACKLOG_MAX_AGE_HOURS}h). tail TTL(3일) 초과분은 expired 로 넘어가 손실됩니다 — rookie orphan-extract --batch 5 로 지금 처리하세요.`
+      )
+    }
+  }
+  if (s.expiredCount > 0) {
+    console.log(`— orphan expired(손실): 누적 ${s.expiredCount}건 — TTL 초과로 tail 미추출 상태로 만료된 세션`)
+  }
+}
+
+// B6-3 (spec 2026-07-11 §B6): 세션 identity pinning 위반 가시화 — 세션 도중 계정 전환으로
+// flush 가 중단된 이력. Stop hook(flush-session.sh)이 남긴 로그를 집계한다. 0건이면 침묵.
+function printIdentityMismatch() {
+  const logPath = join(homedir(), '.rookie', 'identity-mismatch.log')
+  if (!existsSync(logPath)) return
+  try {
+    const lines = readFileSync(logPath, 'utf8').split('\n').filter(Boolean)
+    if (lines.length === 0) return
+    const last = lines[lines.length - 1]
+    console.log(`⚠️ 세션 identity 불일치 ${lines.length}건 — 세션 도중 계정 전환으로 flush 중단(기억 오귀속 차단). 최근: ${last}`)
+    console.log(`   → 로그: ${logPath}. 반복되면 rookie login --local 로 프로젝트 전용 binding 을 쓰세요.`)
+  } catch { /* fail-soft */ }
+}
+
+// v6 P1 #6 — Stage 1 위반 카운트 한 줄 가시화.
+// spec §11.1 / plan Task 4
+// fail-tolerant: summary endpoint 도달 실패 시 silent skip (다른 doctor 출력 영향 0).
+async function printStage1Metric(cfg) {
+  if (!cfg?.endpoint || !cfg?.token) return
+  try {
+    const summary = await apiGet(cfg.endpoint, cfg.token, '/api/rookie/metric/md-read/summary')
+    const total = summary?.totalCount ?? 0
+    const reached = !!summary?.reachedThreshold
+    const window = summary?.windowDays ?? 7
+    const byTool = (summary?.byHostnameTool ?? []).reduce((acc, r) => {
+      acc[r.tool_name] = (acc[r.tool_name] ?? 0) + r.count
+      return acc
+    }, {})
+    const prefix = reached ? '⚠️ ' : '— '
+    console.log(
+      `${prefix}stage1: ${total}건/${window}일 (Read ${byTool.Read ?? 0} / Bash ${byTool.Bash ?? 0})`
+    )
+  } catch {
+    // silent — endpoint 미응답 또는 미land 시 본 라인만 누락. 다른 doctor 출력 영향 0.
+  }
+}
+
+// v6 P1 #9 — Hot Write 호출 메트릭 한 줄 가시화.
+// spec §11.2 / plan Task 7
+// fail-tolerant: summary endpoint 도달 실패 시 silent skip.
+// callFailedRatio < 0.05 → 💪 안정적, 0.2+ → ⚠️ 실패 잦음, 그 외 — 정상.
+async function printHotWriteMetric(cfg) {
+  if (!cfg?.endpoint || !cfg?.token) return
+  try {
+    const summary = await apiGet(cfg.endpoint, cfg.token, '/api/rookie/metric/hot-write/summary')
+    const c = summary?.callCount ?? 0
+    const f = summary?.failedCallCount ?? 0
+    const window = summary?.windowDays ?? 7
+    const ratio = summary?.callFailedRatio ?? 0
+    let prefix = '— '
+    if (c > 0) {
+      if (ratio >= 0.2) prefix = '⚠️ '
+      else if (ratio < 0.05) prefix = '💪 '
+    }
+    const routeStr = (summary?.byRoute ?? [])
+      .map((r) => `${r.route} ${r.count}`)
+      .join(' / ')
+    const routePart = routeStr ? ` [${routeStr}]` : ''
+    console.log(
+      `${prefix}hot-write: ${c}건/${window}일, 실패 ${f}건 (${(ratio * 100).toFixed(0)}%)${routePart}`
+    )
+  } catch {
+    // silent — endpoint 미응답 또는 미land 시 본 라인만 누락.
+  }
+}
+
+// 귀속 불변식 감시 (spec 2026-07-13-attribution-invariant-metric M2) — 최근 7일 신규 진입카드 중
+// 미귀속(NULL) 비율 한 줄. 임계 판정은 서버 exceeded 만 신뢰(임계 이원화 금지).
+// endpoint 미도달(구 서버·네트워크)만 silent skip — 응답이 온 경우엔 조회 실패도 출력한다(침묵 실패 금지).
+async function printAttributionMetric(cfg) {
+  if (!cfg?.endpoint || !cfg?.token) return
+  try {
+    const s = await apiGet(cfg.endpoint, cfg.token, '/api/rookie/metric/attribution/summary')
+    if (s?.fetchFailed) {
+      console.log('⚠️ 귀속: 조회 실패 — 서버 로그 확인')
+      return
+    }
+    const total = s?.total ?? 0
+    const nul = s?.unattributed ?? 0
+    const window = s?.windowDays ?? 7
+    const ratio = s?.ratio ?? 0
+    let prefix = '— '
+    let suffix = ''
+    if (s?.exceeded) {
+      prefix = '⚠️ '
+      suffix = ' — 누수 의심: rookie link 상태·최근 세션 귀속 점검'
+    } else if (total > 0 && ratio < 0.05) {
+      prefix = '💪 '
+    }
+    console.log(
+      `${prefix}귀속: 신규 ${total}건/${window}일, 미귀속 ${nul}건 (${(ratio * 100).toFixed(0)}%)${suffix}`
+    )
+  } catch {
+    // silent — endpoint 미응답 또는 미land 시 본 라인만 누락.
+  }
+}
+
+// v6 P1 #8 — Recall 호출 메트릭 한 줄 가시화.
+// spec §11.2 / plan Task 6
+// fail-tolerant: summary endpoint 도달 실패 시 silent skip.
+// missRatio < 0.2 → 💪 강함, 0.5+ → ⚠️ 0건 반환 잦음, 그 외 — 정상.
+// B4 (spec 2026-07-11 §B4): "miss" 라벨은 관련성 실패처럼 읽혀 의미 왜곡 — "0건 반환"(hit_count=0)으로 개명. 계산 동일.
+async function printRecallMetric(cfg) {
+  if (!cfg?.endpoint || !cfg?.token) return
+  try {
+    const summary = await apiGet(cfg.endpoint, cfg.token, '/api/rookie/metric/recall/summary')
+    const c = summary?.callCount ?? 0
+    const m = summary?.missCount ?? 0
+    const window = summary?.windowDays ?? 7
+    const ratio = summary?.missRatio ?? 0
+    let prefix = '— '
+    if (c > 0) {
+      if (ratio >= 0.5) prefix = '⚠️ '
+      else if (ratio < 0.2) prefix = '💪 '
+    }
+    const scopeStr = (summary?.byScope ?? [])
+      .map((s) => `${s.scope} ${s.count}`)
+      .join(' / ')
+    const scopePart = scopeStr ? ` [${scopeStr}]` : ''
+    console.log(
+      `${prefix}recall: ${c}건/${window}일, 0건 반환 ${m}건 (0건 반환율 ${(ratio * 100).toFixed(0)}%)${scopePart}`
+    )
+    // P4.3 2차-b-2 recall_stale_hit — downrank 후에도 은퇴 카드가 회상에 섞여 나온 누적 건수(>0 일 때만).
+    const stale = summary?.staleHitCount ?? 0
+    if (stale > 0) {
+      console.log(`   retired hit: ${stale}건 (은퇴 카드 회상 노출 — downrank 관찰)`)
+    }
+    // 재발 방지 (2026-05-22) — 임베딩 가동률이 낮으면 회상이 silent 하게 FTS-only 로 폴백한다.
+    // Cohere quota 소진·키 무효 시 한국어 회상이 깨지므로 능동 경고 (과거 17일 방치 사례).
+    const embRatio = summary?.embeddingUsedRatio
+    if (c >= 5 && typeof embRatio === 'number' && embRatio < 0.5) {
+      console.log(
+        `🚨 임베딩 가동률 ${(embRatio * 100).toFixed(0)}% — Cohere 키/quota 점검 필요 (회상이 FTS-only 로 폴백 중)`
+      )
+    }
+  } catch {
+    // silent — endpoint 미응답 또는 미land 시 본 라인만 누락.
+  }
+}
+
+// B5 (spec 2026-07-11 §B5) — directive 준수율 한 줄 가시화.
+// served(지시 노출)/acted(이행) 쌍 — link 제안·orphan tail 추출 지시가 실제로 이행되는지의 proxy.
+// 계측 전용(acted 오탐 가능) — 의사결정 단독 근거 금지. 이벤트 0건이면 조용히 생략.
+// fail-tolerant: summary endpoint 도달 실패 시 silent skip.
+async function printDirectiveMetric(cfg) {
+  if (!cfg?.endpoint || !cfg?.token) return
+  try {
+    const s = await apiGet(cfg.endpoint, cfg.token, '/api/rookie/metric/directive/summary')
+    const rows = s?.byDirective ?? []
+    if (!rows.length) return
+    // link_prompt 는 서버가 aggregation-time 24h 짝짓기한 linkPairing 사용(fulfilled ≤ served 보장).
+    // orphan_extract 의 acted 는 세션당 여러 건(마킹 건수)이라 비율이 아닌 병기 — "노출 N회 · 추출 M건".
+    const parts = rows.map((r) => {
+      if (r.directive === 'link_prompt') {
+        const lp = s?.linkPairing ?? { served: r.served, fulfilled: 0 }
+        return `link 제안 ${lp.served}회 중 ${lp.fulfilled}회 이행`
+      }
+      return `${r.directive === 'orphan_extract' ? 'orphan 추출 지시' : r.directive} 노출 ${r.served}회 · 이행 ${r.acted}건`
+    })
+    const surfaceStr = (s?.bySurface ?? [])
+      .map((x) => `${x.surface ?? '?'} ${x.served}/${x.acted}`)
+      .join(' · ')
+    const surfacePart = surfaceStr ? ` [표면 served/acted: ${surfaceStr}]` : ''
+    console.log(`— 준수율: ${parts.join(' / ')} (${s?.windowDays ?? 7}일, 계측 전용)${surfacePart}`)
+  } catch {
+    // silent — endpoint 미응답 또는 미land 시 본 라인만 누락.
+  }
+}
+
+// v6 P6 L1 PR-C — Promotion 호출 메트릭 한 줄 가시화.
+// spec §11.x P6 / plan Step 3.8
+// fail-tolerant: summary endpoint 도달 실패 시 silent skip.
+// totalCalls 0 → ⚙️ 미가동, totalSkipped/totalExamined ≥ 0.8 → ⚠️ skip 잦음, 그 외 ✓.
+// Cohere 임베딩 비용 자동차단(회로) 상태 한 줄 가시화.
+// plan: docs/superpowers/plans/2026-06-20-cohere-cost-runaway-prevention.md Task B4b
+// tripped → 🚨 빨강(수동 reset 안내). 정상 → ✓ + 사용량/중복률. 외부 알람 미설정이면 ⚠️.
+// fail-tolerant: endpoint 미응답 시 silent skip(미land 환경).
+async function printEmbeddingGuard(cfg) {
+  if (!cfg?.endpoint || !cfg?.token) return
+  try {
+    const s = await apiGet(
+      cfg.endpoint,
+      cfg.token,
+      '/api/rookie/metric/embedding-usage'
+    )
+    if (!s) return
+    if (s.tripped) {
+      const reason = s.trip_reason ?? '?'
+      console.log(
+        `🚨 embedding guard: 차단됨 (${reason}) — Cohere 호출 중단됨. 원인 확인 후 대시보드에서 수동 reset 필요`
+      )
+      return
+    }
+    const cur = s.current_bucket_texts ?? 0
+    const today = s.today_texts ?? 0
+    const dup = s.dup_ratio ?? 0
+    let line = `✓ embedding guard: 정상 (시간당 ${cur} / 오늘 ${today} 텍스트`
+    if (dup > 0) line += `, 중복률 ${Math.round(dup * 100)}%`
+    line += ')'
+    if (s.alert_email_configured === false) line += ' ⚠️ 외부 알람(이메일) 미설정'
+    console.log(line)
+  } catch {
+    // silent — endpoint 미응답 또는 미land 시 본 라인만 누락.
+  }
+}
+
+async function printPromotionMetric(cfg) {
+  if (!cfg?.endpoint || !cfg?.token) return
+  try {
+    const summary = await apiGet(
+      cfg.endpoint,
+      cfg.token,
+      '/api/rookie/metric/promotion/summary'
+    )
+    const calls = summary?.totalCalls ?? 0
+    const examined = summary?.totalExamined ?? 0
+    const promoted = summary?.totalPromoted ?? 0
+    const skipped = summary?.totalSkipped ?? 0
+    const window = summary?.windowDays ?? 7
+    if (calls === 0) {
+      console.log(`⚙️ promotion: 0건/${window}일 (미가동)`)
+      return
+    }
+    const skippedRatio = examined > 0 ? skipped / examined : 0
+    const promotionPct =
+      examined > 0 ? Math.round((promoted / examined) * 100) : 0
+    let prefix = '✓ '
+    if (skippedRatio >= 0.8) prefix = '⚠️ '
+    console.log(
+      `${prefix}promotion: ${calls}건/${window}일, examined ${examined} / promoted ${promoted} / skipped ${skipped} (승격률 ${promotionPct}%)`
+    )
+  } catch {
+    // silent — endpoint 미응답 또는 미land 시 본 라인만 누락.
+  }
+}
+
+// v6 P6 L2 — Self-rule 위반 누적 top 1 한 줄 가시화.
+// spec §11.x P6 L2 / plan Task 4.14
+// fail-tolerant: summary endpoint 도달 실패 시 silent skip.
+// 위반 누적 ≥ 5 → 🚨, ≥ 1 → ⚠️, 0 → 출력 생략 (clean 시 line 자체 없음).
+async function printViolationTop(cfg) {
+  if (!cfg?.endpoint || !cfg?.token) return
+  try {
+    const summary = await apiGet(
+      cfg.endpoint,
+      cfg.token,
+      '/api/rookie/metric/self-rule-violations/summary?top_n=1'
+    )
+    const top = summary?.topRules?.[0]
+    const total = summary?.totalRulesWithViolation ?? 0
+    if (!top || total === 0) return
+    const cnt = top.violation_count ?? 0
+    const cat = top.category ?? '?'
+    const ruleText = (top.rule ?? '').slice(0, 40).replace(/\s+/g, ' ')
+    const last = top.last_violated_at
+    let when = ''
+    if (last) {
+      const t = Date.parse(last)
+      if (!isNaN(t)) {
+        const diffSec = Math.max(0, Math.floor((Date.now() - t) / 1000))
+        if (diffSec < 60) when = `${diffSec}s 전`
+        else if (diffSec < 3600) when = `${Math.floor(diffSec / 60)}m 전`
+        else if (diffSec < 86400) when = `${Math.floor(diffSec / 3600)}h 전`
+        else when = `${Math.floor(diffSec / 86400)}d 전`
+      }
+    }
+    const prefix = cnt >= 5 ? '🚨 ' : '⚠️ '
+    const totalSuffix = total > 1 ? ` (총 ${total}건 누적)` : ''
+    console.log(
+      `${prefix}위반: ${cat} ${cnt}회 (rule "${ruleText}"${when ? `, ${when}` : ''})${totalSuffix}`
+    )
+  } catch {
+    // silent — endpoint 미응답 또는 미land 시 본 라인만 누락.
+  }
+}
+
+// v6 P1 #7 — Dedup 메트릭 누적 한 줄 가시화.
+// spec §11.2 / plan Task 6
+// fail-tolerant: summary endpoint 도달 실패 시 silent skip.
+// ratio 0.7+ → ⚠️ recall 신뢰 의심, 0.3 미만 → 💧 dedup 약함, 그 외 — 정상.
+async function printDedupMetric(cfg) {
+  if (!cfg?.endpoint || !cfg?.token) return
+  try {
+    const summary = await apiGet(cfg.endpoint, cfg.token, '/api/rookie/metric/dedup/summary')
+    const r = summary?.totalColdRecovered ?? 0
+    const s = summary?.totalColdSkipped ?? 0
+    const f = summary?.totalMutateFailed ?? 0
+    const window = summary?.windowDays ?? 7
+    const sessions = summary?.sessionCount ?? 0
+    const ratio = summary?.dedupEfficiencyRatio ?? 0
+    let prefix = '— '
+    if (sessions > 0) {
+      if (ratio >= 0.7) prefix = '⚠️ '
+      else if (ratio < 0.3) prefix = '💧 '
+    }
+    console.log(
+      `${prefix}dedup: ${r} recovered / ${s} skipped / ${f} mutate-failed (${sessions}세션·${window}일, 비율 ${(ratio * 100).toFixed(0)}%)`
+    )
+  } catch {
+    // silent — endpoint 미응답 또는 미land 시 본 라인만 누락.
+  }
+}