therookie 0.4.39 → 0.4.41

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "therookie",
-  "version": "0.4.39",
+  "version": "0.4.41",
   "description": "Persistent memory for Claude Code and Codex CLI — teach your AI once and it remembers across sessions, tools, and machines. The AI new hire that remembers what you teach it.",
   "license": "MIT",
   "keywords": [

package/src/cli.js

@@ -14,12 +14,13 @@ import { runClusterTodos } from './commands/cluster-todos.js'
 import { runDoneScan } from './commands/done-scan.js'
 import { runContextDiet } from './commands/context-diet.js'
 import { runOrphanExtract } from './commands/orphan-extract.js'
+import { runTeam, runHire, runReports, runClaim } from './commands/team.js'
 
 const HELP = `rookie — the Rookie Skill/Hook 설치 관리자
 
 사용:
-  rookie init [--local] [--force] [--yes] [--deep-scan] [--claude-md | --no-claude-md]
-  rookie login [--local] [--claude-md | --no-claude-md]
+  rookie init [--local] [--force] [--yes] [--deep-scan] [--claude-md | --no-claude-md] [--codex-md | --no-codex-md]
+  rookie login [--local] [--claude-md | --no-claude-md] [--codex-md | --no-codex-md]
   rookie update [--force] [--claude-md | --no-claude-md] [--codex-md | --no-codex-md]
   rookie link [--local]
   rookie save [--file <body.json>] [--json]   # 또는 stdin. --json = 서버 raw 응답 출력
@@ -32,6 +33,10 @@ const HELP = `rookie — the Rookie Skill/Hook 설치 관리자
   rookie done-scan [--force]
   rookie context-diet [--json] [--force]
   rookie orphan-extract [--batch=5]
+  rookie team [show <이름표> | edit <이름표> | archive <이름표> | restore <이름표> | move <번호> <이름표|default> [--yes]]
+  rookie hire <이름표> --name <이름> --role <담당> [--note <역할 메모>]
+  rookie reports [--since 2h] [--agent <이름표|default>] [--project <이름>] [--status <상태>] | reports show <번호>
+  rookie claim "<붙잡는 자원>" | rookie claim --release
 
 옵션:
   --local       프로젝트 로컬 스코프 — login 은 토큰도 <dir>/.rookie/config.json 에 저장(전역 무변경)
@@ -59,6 +64,10 @@ const HELP = `rookie — the Rookie Skill/Hook 설치 관리자
   done-scan        doing task 를 최근 커밋과 경로 강매칭해 완료 후보를 세션 시작 시 surface(하루 1회, --force 강제).
   context-diet     세션 주입 컨텍스트 비대 감지(5항목 proxy 측정). hook 이 주1회 권고 블록 주입, --force 는 usage 재스캔.
   orphan-extract   비정상 종료 세션 tail 추출 초안 생성(오래된 순, 기본 5건). 저장·완료 marker 는 세션 LLM/사용자 판단.
+  team             루키 팀 명단·경력(show)·수정·보관·복원·경력 옮기기(move). 세션은 ROOKIE_AGENT=<이름표> 로 띄운다.
+  hire             루키 채용. 관리 권한 토큰이 필요하다 — 없으면 대시보드 /settings/team 에서 채용한다.
+  reports          보고 대장 — 세션들이 받은 지시와 마지막 보고를 루키별로. show <번호> 로 전문.
+  claim            공유 자원(빌드 머신·실기기·배포·대량 디스크)을 쓰기 직전에 알린다. 다른 세션 현황 줄 맨 앞에 뜬다.
 `
 
 export async function run(argv) {
@@ -94,6 +103,10 @@ export async function run(argv) {
     }
     case 'orphan-extract': return runOrphanExtract(flags)
     case 'token': return runToken(flags)
+    case 'team': return runTeam(flags)
+    case 'hire': return runHire(flags)
+    case 'reports': return runReports(flags)
+    case 'claim': return runClaim(flags)
     case 'help':
     case '--help':
     case undefined:
@@ -118,6 +131,15 @@ const VALUE_FLAGS = new Set([
   // spec 2026-09-08 §2.4 — `rookie save --session <id>`. 화이트리스트에 없으면 값이 안 붙어
   //  flags.session === true 가 되고 저장 마커가 조용히 안 남는다(실측으로 잡힌 버그).
   'session',
+  // spec 2026-09-28 다중 루키 — team·hire·reports 의 값 플래그.
+  'name',
+  'role',
+  'note',
+  'since',
+  'agent',
+  'project',
+  'status',
+  'from',
 ])
 
 export function parseFlags(args) {

package/src/commands/codex-setup.js

@@ -5,6 +5,7 @@ import { confirm } from '../prompt.js'
 import { loadConfig } from '../config.js'
 import { applyCodexSetup } from '../lib/deploy-artifacts.js'
 import { runCodexMdStep } from '../lib/claude-md-block.js'
+import { codexHomeDir } from '../lib/codex-home.js'
 
 // Codex config.toml 에 더루키 SessionStart hook 을 동의 기반으로 등록한다(managed 블록만).
 // 명시적 Codex-only 재설정 진입점 — 내부 write 는 applyCodexSetup(3층 adapter) 공유(spec §4 item 6).
@@ -19,7 +20,7 @@ export async function runCodexSetup(flags) {
     console.error(`✗ hook 스크립트가 없습니다(${hookScript}). \`rookie login\` 또는 \`rookie update\` 를 먼저 실행하세요.`)
     process.exit(1)
   }
-  const configPath = join(homedir(), '.codex', 'config.toml')
+  const configPath = join(codexHomeDir(), 'config.toml')
 
   console.log('\nCodex 설정 파일에 더루키 SessionStart hook 을 등록합니다:')
   console.log(`  ${configPath}`)

package/src/commands/doctor.js

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync, readdirSync } from 'node:fs'
 import { claudeMdStatusLine, codexMdStatusLine } from '../lib/claude-md-block.js'
+import { codexMcpAgentEnvLine } from '../lib/codex-mcp-env.js'
 import { homedir } from 'node:os'
 import { join } from 'node:path'
 import { execSync } from 'node:child_process'
@@ -47,6 +48,8 @@ export async function runDoctor(flags) {
   if (claudeMdLine) console.log(claudeMdLine)
   const codexMdLine = codexMdStatusLine()
   if (codexMdLine) console.log(codexMdLine)
+  const codexAgentEnvLine = codexMcpAgentEnvLine()
+  if (codexAgentEnvLine) console.log(codexAgentEnvLine)
 
   if (g && l && g.version !== l.version) {
     console.log(`⚠ 버전 불일치: 글로벌 v${g.version} vs 로컬 v${l.version}`)

package/src/commands/init.js

@@ -12,7 +12,7 @@ import { apiGet, apiPostNoAuth } from '../api.js'
 import { applyToolSetup, pendingToolSetup } from '../lib/apply-tool-setup.js'
 import { renderDetected, renderConnectOutcome, toolName } from '../lib/connect-ui.js'
 import { resolveEndpoint } from '../lib/resolve-endpoint.js'
-import { runClaudeMdStep } from '../lib/claude-md-block.js'
+import { runClaudeMdStep, runCodexMdStep } from '../lib/claude-md-block.js'
 
 async function pickChoice(prompt, options, autoValue) {
   console.log(prompt)
@@ -179,4 +179,9 @@ export async function runInit(flags) {
     const { lines } = await runClaudeMdStep({ mode: 'connect', flags, interactive, confirmFn: confirm })
     for (const line of lines) console.log(line)
   }
+  // 2026-09-29 두목 결정 — Codex 전역 지시 파일도 첫 연결에서 기본 적용(끄기 ROOKIE_NO_CODEX_MD=1).
+  if (scope === 'global' && report.applied.some((a) => a.id === 'codex')) {
+    const { lines } = await runCodexMdStep({ mode: 'connect', flags, interactive, confirmFn: confirm })
+    for (const line of lines) console.log(line)
+  }
 }

package/src/commands/login.js

@@ -10,7 +10,7 @@ import { renderDetected, renderConnectOutcome, toolName } from '../lib/connect-u
 import { confirm } from '../prompt.js'
 import { resolveEndpoint } from '../lib/resolve-endpoint.js'
 import { accountLine, accountWarning } from '../lib/account-ui.js'
-import { runClaudeMdStep } from '../lib/claude-md-block.js'
+import { runClaudeMdStep, runCodexMdStep } from '../lib/claude-md-block.js'
 
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
 
@@ -170,4 +170,14 @@ export async function runLogin(flags) {
     })
     for (const line of lines) console.log(line)
   }
+  // 2026-09-29 두목 결정 — Codex 전역 지시 파일도 첫 연결에서 기본 적용(끄기 ROOKIE_NO_CODEX_MD=1).
+  if (scope === 'global' && report.applied.some((a) => a.id === 'codex')) {
+    const { lines } = await runCodexMdStep({
+      mode: 'connect',
+      flags,
+      interactive: !!process.stdin.isTTY && !flags.yes,
+      confirmFn: confirm,
+    })
+    for (const line of lines) console.log(line)
+  }
 }

package/src/commands/save.js

@@ -13,6 +13,7 @@ import { execFileSync } from 'node:child_process'
 import { readFileSync } from 'node:fs'
 import { loadConfig, getHostname } from '../config.js'
 import { apiPost } from '../api.js'
+import { agentHeader } from '../lib/agent-env.js'
 import {
   recordSessionWrite,
   resolveSessionId,
@@ -110,6 +111,8 @@ export async function runSave(flags) {
       headers: {
         'x-rookie-hostname': getHostname(),
         'x-rookie-surface': 'local_cli',
+        // spec 2026-09-28 다중 루키 §5.1 — 세션을 띄운 루키로 저장한다. 모르는 루키면 서버가 400 unknown_agent.
+        ...agentHeader(),
       },
     })
   } catch (err) {

package/src/commands/team.js

@@ -0,0 +1,261 @@
+// spec 2026-09-28 다중 루키 1단계 — 루키 팀·채용·보고 대장·점유 선언 명령.
+//   rookie team [show <slug> | edit <slug> | archive <slug> | restore <slug> | move <번호> <slug|default>]
+//   rookie hire <slug> --name <이름> --role <담당> [--note <역할 메모>]
+//   rookie reports [--since 2h] [--agent <slug>] [--project <이름>] [--status open|reported|short|no_report]
+//   rookie reports show <번호>
+//   rookie claim "<붙잡는 자원>" | rookie claim --release
+// 채용·수정·경력 옮기기는 admin 토큰이 있어야 된다 — 일하는 세션의 토큰으로는 동료를 늘릴 수 없다(§2.6).
+import { loadConfig, getHostname } from '../config.js'
+import { ask } from '../prompt.js'
+import { agentHeader } from '../lib/agent-env.js'
+import { resolveSessionId } from '../lib/session-write-marker.js'
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+// `team show` 로 본 번호를 `team move` 가 쓰려면 어느 루키의 번호였는지 알아야 한다 — 마지막으로 본 이름표를 남긴다.
+const LAST_SHOWN = () => join(process.env.ROOKIE_STATE_DIR || join(homedir(), '.rookie', 'state'), 'team-last-shown.json')
+function rememberShown(slug) {
+  try {
+    mkdirSync(join(LAST_SHOWN(), '..'), { recursive: true })
+    writeFileSync(LAST_SHOWN(), JSON.stringify({ slug, at: new Date().toISOString() }), { mode: 0o600 })
+  } catch { /* 기억 못 해도 --from 으로 줄 수 있다 */ }
+}
+function lastShown() {
+  try { return JSON.parse(readFileSync(LAST_SHOWN(), 'utf8')).slug || null } catch { return null }
+}
+
+const DASHBOARD_HINT = '루키 채용·수정은 대시보드 루키 팀 화면(/settings/team)에서 할 수 있습니다.'
+const OLD_SERVER = '서버가 아직 루키 팀을 지원하지 않습니다 — 서버가 업데이트되면 다시 시도하세요.'
+
+async function request(cfg, method, path, body, { fetchImpl = fetch } = {}) {
+  const res = await fetchImpl(`${cfg.endpoint}${path}`, {
+    method,
+    headers: {
+      Authorization: `Bearer ${cfg.token}`,
+      'x-rookie-hostname': getHostname(),
+      ...agentHeader(),
+      ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),
+    },
+    body: body !== undefined ? JSON.stringify(body) : undefined,
+  })
+  const text = await res.text()
+  let json = null
+  try { json = JSON.parse(text) } catch { json = null }
+  return { status: res.status, json }
+}
+
+// 라우트가 없는 구 서버는 JSON 이 아닌 404 를 준다. 우리 라우트의 404 는 항상 { error } JSON 이다.
+const isOldServer = (r) => r.status === 404 && !(r.json && typeof r.json.error === 'string')
+
+function fail(message, code = 1) {
+  console.error(message)
+  process.exit(code)
+}
+
+function explain(r, what) {
+  if (isOldServer(r)) return fail(OLD_SERVER)
+  if (r.status === 401) return fail(`${what} 권한이 없습니다(관리 권한 토큰 필요). ${DASHBOARD_HINT}`)
+  const err = r.json?.error
+  const map = {
+    slug_taken: `이미 쓰고 있는 이름표입니다${r.json?.suggestion ? ` — "${r.json.suggestion}" 은 비어 있습니다` : ''}.`,
+    unsafe_text: '지시문처럼 보이는 문장이나 보이지 않는 문자가 들어 있습니다. 평범한 문장으로 적어 주세요.',
+    residual_marker: '가려진 비밀값 표시가 남아 있습니다. 그 부분을 지우고 다시 적어 주세요.',
+    too_long: '글이 너무 깁니다.',
+    no_organization: '루키를 채용하려면 조직이 필요합니다.',
+    quota_exceeded: `지금 요금제에서는 루키를 ${r.json?.limit ?? ''}명까지 둘 수 있습니다.`,
+    unknown_agent: '그런 이름표의 루키가 없습니다. `rookie team` 으로 확인하세요.',
+    not_owned_or_missing: '대상을 찾지 못했습니다.',
+    no_open_report: '이 세션에 열린 지시가 없습니다 — 지시를 받은 세션 안에서 부르세요.',
+    invalid_body: '입력값을 다시 확인하세요(이름표는 영문 소문자로 시작, 소문자·숫자·하이픈 2~32자).',
+  }
+  return fail(map[err] ?? `${what}에 실패했습니다 (HTTP ${r.status}).`)
+}
+
+const kst = (iso) =>
+  iso
+    ? new Intl.DateTimeFormat('ko-KR', { timeZone: 'Asia/Seoul', month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit', hour12: false }).format(new Date(iso))
+    : '-'
+
+const pad = (s, n) => {
+  const w = [...String(s)].reduce((a, c) => a + (c.charCodeAt(0) > 0x2e80 ? 2 : 1), 0)
+  return String(s) + ' '.repeat(Math.max(1, n - w))
+}
+
+export function formatTeam(agents) {
+  const active = agents.filter((a) => a.status === 'active')
+  const archived = agents.filter((a) => a.status === 'archived')
+  const line = (a) =>
+    `  ${pad(a.slug, 14)}${pad(`${a.name} · ${a.role_title}`, 22)}경력 ${a.evidence_count}건 · 최근 활동 ${kst(a.last_activity_at)}`
+  const out = [`루키 팀 — 일하는 루키 ${active.length + 1}명`, `  ${pad('default', 14)}기본 루키 — 이름표 없이 띄운 세션`, ...active.map(line)]
+  if (archived.length) out.push('', `보관한 루키 ${archived.length}명`, ...archived.map(line))
+  out.push('', '세션 띄우기: ROOKIE_AGENT=<이름표> claude')
+  return out.join('\n')
+}
+
+export function formatCareer(c) {
+  const who = c.agent.name ? `${c.agent.name}(${c.agent.slug})` : '기본 루키'
+  const out = [`${who} 경력 ${c.total}건`]
+  if (c.by_project.length) {
+    out.push('프로젝트별: ' + c.by_project.map((p) => `${p.project_name ?? '(프로젝트 없음)'} ${p.count}`).join(' · '))
+  }
+  if (c.recent.length) {
+    out.push('', '최근 경력 (번호로 `rookie team move <번호> <이름표|default>`)')
+    for (const r of c.recent) {
+      out.push(`  ${String(r.n).padStart(2)}. ${kst(r.confirmed_date)} ${r.project_name ? `[${r.project_name}] ` : ''}${r.capability.slice(0, 70)}${r.reassigned ? ' (옮겨 옴)' : ''}`)
+    }
+  }
+  return out.join('\n')
+}
+
+const STATUS_LABEL = { reported: '보고함', short: '짧은 보고', no_report: '보고 없이 끝남', open: '진행 중' }
+
+export function formatReports(reports) {
+  if (reports.length === 0) return '이 기간에 받은 보고가 없습니다.'
+  // 기본 묶음은 루키별(§5.4) — 각 줄에 프로젝트. 번호는 전체 순서라 `reports show <번호>` 와 맞는다.
+  const groups = new Map()
+  reports.forEach((r, i) => {
+    const label = r.agent ? `${r.agent.role_title} · ${r.agent.name} (${r.agent.slug})` : r.agent_unresolved ? '모르는 이름표로 연 세션' : '기본 루키'
+    if (!groups.has(label)) groups.set(label, [])
+    groups.get(label).push({ n: i + 1, r })
+  })
+  const out = []
+  for (const [label, items] of groups) {
+    out.push(`[${label}]`)
+    for (const { n, r } of items) {
+      let state = STATUS_LABEL[r.status] ?? r.status
+      if (r.status === 'open') state = r.stalled ? `30분째 기록 없음 — 끊겼을 수 있음(마지막 ${kst(r.last_activity_at)})` : `진행 중(마지막 ${kst(r.last_activity_at)})`
+      if (r.status === 'no_report') state = `보고 없이 끝남 — 마지막 기록 ${kst(r.last_activity_at)}`
+      const head = (r.directive_head ?? '').replace(/\s+/g, ' ').slice(0, 50)
+      out.push(`  ${String(n).padStart(2)}. ${kst(r.opened_at)} ${r.project_name ?? '-'} · "${head}" · ${state}${r.claim ? ` · 점유: ${r.claim}` : ''}${r.agent_switched ? ' · 루키 바뀜' : ''}`)
+      if (r.report_first_line) out.push(`      ↳ ${r.report_first_line.slice(0, 100)}`)
+    }
+  }
+  out.push('', '전문: rookie reports show <번호>')
+  return out.join('\n')
+}
+
+async function listAgents(cfg) {
+  const r = await request(cfg, 'GET', '/api/rookie/agents')
+  if (r.status !== 200) return explain(r, '루키 명단 조회')
+  return r.json.agents
+}
+
+async function findBySlug(cfg, slug) {
+  const agents = await listAgents(cfg)
+  const a = agents.find((x) => x.slug === slug)
+  if (!a) fail(`"${slug}" 이름표의 루키가 없습니다. \`rookie team\` 으로 확인하세요.`)
+  return a
+}
+
+export async function runTeam(flags) {
+  const cfg = loadConfig()
+  const [sub, a1, a2] = flags.positional
+  if (!sub) return console.log(formatTeam(await listAgents(cfg)))
+
+  if (sub === 'show') {
+    if (!a1) fail('사용: rookie team show <이름표|default>', 2)
+    const r = await request(cfg, 'GET', `/api/rookie/agents/${encodeURIComponent(a1)}/career`)
+    if (r.status !== 200) return explain(r, '경력 조회')
+    rememberShown(a1)
+    return console.log(formatCareer(r.json))
+  }
+
+  if (sub === 'edit') {
+    if (!a1) fail('사용: rookie team edit <이름표> [--name <이름>] [--role <담당>] [--note <역할 메모>]', 2)
+    const patch = {}
+    if (typeof flags.name === 'string') patch.name = flags.name
+    if (typeof flags.role === 'string') patch.role_title = flags.role
+    if (typeof flags.note === 'string') patch.persona_note = flags.note || null
+    if (Object.keys(patch).length === 0) fail('바꿀 칸을 --name·--role·--note 로 주세요.', 2)
+    const a = await findBySlug(cfg, a1)
+    const r = await request(cfg, 'PATCH', `/api/rookie/agents/${a.id}`, patch)
+    if (r.status !== 200) return explain(r, '수정')
+    return console.log(`✓ ${r.json.agent.name}(${a1}) 수정했습니다.`)
+  }
+
+  if (sub === 'archive' || sub === 'restore') {
+    if (!a1) fail(`사용: rookie team ${sub} <이름표>`, 2)
+    const a = await findBySlug(cfg, a1)
+    const r = await request(cfg, 'PATCH', `/api/rookie/agents/${a.id}`, { status: sub === 'archive' ? 'archived' : 'active' })
+    if (r.status !== 200) return explain(r, sub === 'archive' ? '보관' : '복원')
+    return console.log(
+      sub === 'archive'
+        ? `✓ ${a.name}(${a1})을 보관했습니다. 이 이름표로 띄운 세션은 기본 루키로 일하고 저장은 거절됩니다.`
+        : `✓ ${a.name}(${a1})을 복원했습니다. 진입 카드와 경력이 다시 붙습니다.`
+    )
+  }
+
+  if (sub === 'move') {
+    const n = Number(a1)
+    if (!Number.isInteger(n) || n < 1 || !a2) fail('사용: rookie team move <번호> <이름표|default> [--yes] — 번호는 `rookie team show <이름표>` 에서', 2)
+    const from = typeof flags.from === 'string' ? flags.from : lastShown()
+    if (!from) fail('먼저 `rookie team show <이름표>` 로 번호를 보세요 (또는 --from <이름표|default>).', 2)
+    const c = await request(cfg, 'GET', `/api/rookie/agents/${encodeURIComponent(from)}/career`)
+    if (c.status !== 200) return explain(c, '경력 조회')
+    const item = c.json.recent.find((x) => x.n === n)
+    if (!item) fail(`${from} 의 최근 경력에 ${n}번이 없습니다.`)
+    console.log(`옮길 경력: ${item.capability.slice(0, 80)}\n  ${from} → ${a2}`)
+    if (!flags.yes) {
+      const ok = await ask('옮길까요? (y/N)', { defaultValue: 'N' })
+      if (!/^y(es)?$/i.test(ok)) return console.log('취소했습니다.')
+    }
+    const r = await request(cfg, 'PATCH', `/api/rookie/evidence/${item.id}/agent`, { agent: a2 === 'default' ? null : a2 })
+    if (r.status !== 200) return explain(r, '경력 옮기기')
+    return console.log(r.json.changed ? `✓ ${a2} 루키로 옮겼습니다.` : '이미 그 루키의 경력입니다.')
+  }
+
+  fail(`알 수 없는 하위 명령: ${sub} (team · show · edit · archive · restore · move)`, 2)
+}
+
+export async function runHire(flags) {
+  const cfg = loadConfig()
+  const slug = flags.positional[0]
+  if (!slug || typeof flags.name !== 'string' || typeof flags.role !== 'string') {
+    fail('사용: rookie hire <이름표> --name <이름> --role <담당> [--note <역할 메모>]\n' + DASHBOARD_HINT, 2)
+  }
+  const body = { slug, name: flags.name, role_title: flags.role }
+  if (typeof flags.note === 'string' && flags.note) body.persona_note = flags.note
+  const r = await request(cfg, 'POST', '/api/rookie/agents', body)
+  if (r.status !== 201 && r.status !== 200) return explain(r, '채용')
+  console.log(`✓ ${r.json.agent.name}(${slug}) 채용했습니다. 세션 띄우기: ROOKIE_AGENT=${slug} claude`)
+}
+
+function reportsQuery(flags, body) {
+  const q = new URLSearchParams()
+  q.set('since', typeof flags.since === 'string' ? flags.since : '2h')
+  if (typeof flags.agent === 'string') q.set('agent', flags.agent)
+  if (typeof flags.project === 'string') q.set('project', flags.project)
+  if (typeof flags.status === 'string') q.set('status', flags.status)
+  if (body) q.set('body', '1')
+  return q.toString()
+}
+
+export async function runReports(flags) {
+  const cfg = loadConfig()
+  const [sub, a1] = flags.positional
+  const show = sub === 'show'
+  const r = await request(cfg, 'GET', `/api/rookie/reports?${reportsQuery(flags, show)}`)
+  if (r.status !== 200) return explain(r, '보고 대장 조회')
+  if (flags.json) return console.log(JSON.stringify(r.json.reports))
+  if (!show) return console.log(formatReports(r.json.reports))
+  const n = Number(a1)
+  const item = r.json.reports[n - 1]
+  if (!item) fail(`${a1}번 보고가 없습니다 — 같은 --since·--agent 로 \`rookie reports\` 를 먼저 보세요.`)
+  const who = item.agent ? `${item.agent.name}(${item.agent.slug})` : '기본 루키'
+  console.log(`${who} · ${item.project_name ?? '-'} · ${kst(item.opened_at)} 시작 · ${STATUS_LABEL[item.status] ?? item.status}`)
+  console.log(`지시: ${(item.directive_head ?? '').slice(0, 300)}`)
+  console.log('')
+  console.log(item.report_body ?? '(보고 본문 없음)')
+}
+
+export async function runClaim(flags) {
+  const cfg = loadConfig()
+  const sessionId = resolveSessionId(typeof flags.session === 'string' ? flags.session : '')
+  if (!sessionId) fail('세션 번호를 알 수 없습니다 — Claude Code 세션 안에서 부르거나 --session <id> 를 주세요.', 2)
+  const claim = flags.release ? '' : flags.positional.join(' ').trim()
+  if (!flags.release && !claim) fail('사용: rookie claim "<붙잡는 자원>" (예: "맥미니 iOS 빌드, 디스크 ~10Gi") | rookie claim --release', 2)
+  const r = await request(cfg, 'POST', '/api/rookie/report/claim', { session_id: sessionId, claim })
+  if (r.status !== 200) return explain(r, '점유 선언')
+  console.log(claim ? `✓ 점유를 알렸습니다: ${claim}` : '✓ 점유를 풀었습니다.')
+}

package/src/commands/update.js

@@ -14,6 +14,7 @@ import { installSkill } from '../lib/skill-installer.js'
 import { claudeHookCommand, escapeJsonStringValue } from '../lib/hook-command.js'
 import { mergeHooks } from '../lib/merge-hooks.js'
 import { runClaudeMdStep, runCodexMdStep } from '../lib/claude-md-block.js'
+import { refreshCodexSetupIfManaged } from '../lib/deploy-artifacts.js'
 import { confirm } from '../prompt.js'
 
 const __filename = fileURLToPath(import.meta.url)
@@ -63,6 +64,13 @@ export async function runUpdate(flags) {
       const { lines } = await step({ mode: 'update', flags, interactive, confirmFn: confirm })
       for (const line of lines) console.log(line)
     }
+    // CLAUDE.md 원칙 11 — 이미 등록한 Codex hook 블록을 새 템플릿으로(manifest "최신" 조기 종료보다 앞).
+    const codex = refreshCodexSetupIfManaged()
+    if (codex.error === 'malformed_marker') {
+      console.log(`⚠ Codex config 의 더루키 블록이 손상돼 갱신을 건너뛰었습니다 — 수동 점검: ${codex.configPath}`)
+    } else if (codex.changed) {
+      console.log(`✓ Codex hook 블록 갱신 → ${codex.configPath}`)
+    }
   }
 
   let serverManifest
@@ -149,6 +157,13 @@ export async function runUpdate(flags) {
   )
   chmodSync(join(pretoolBinDir, 'work-recall-gate.sh'), 0o755)
 
+  // spec 2026-09-28 다중 루키 §6.5 — 보고 대장 생존 신호(PostToolUse 모든 도구, 5분 표식).
+  cpSync(
+    join(TEMPLATES, 'hook', 'bin', 'report-heartbeat.sh'),
+    join(pretoolBinDir, 'report-heartbeat.sh')
+  )
+  chmodSync(join(pretoolBinDir, 'report-heartbeat.sh'), 0o755)
+
   // spec 2026-07-25 §3 — recall 소비 실패율 계측 Stop 파서(순수 관측, flush-session 과 별개 훅).
   cpSync(
     join(TEMPLATES, 'hook', 'bin', 'recall-episode-metric.sh'),
@@ -197,6 +212,7 @@ export async function runUpdate(flags) {
     sessionStartCmd: claudeHookCommand(join(binDir, 'session-start.sh')),
     pretoolMdReadCmd: claudeHookCommand(join(pretoolBinDir, 'pretool-md-read.sh')),
     posttoolRecallNudgeCmd: claudeHookCommand(join(pretoolBinDir, 'posttool-recall-nudge.sh')),
+    reportHeartbeatCmd: claudeHookCommand(join(pretoolBinDir, 'report-heartbeat.sh')),
     guardCmd: claudeHookCommand(join(binDir, 'guard-destructive-db.sh')),
     skillGateCmd: claudeHookCommand(join(binDir, 'user-prompt-skill-gate.sh')),
     workRecallGateCmd: claudeHookCommand(join(pretoolBinDir, 'work-recall-gate.sh')),
@@ -245,6 +261,7 @@ async function mergeSettings(settingsPath, partialPath, subs) {
     .replaceAll('__SESSION_START_CMD__', escapeJsonStringValue(subs.sessionStartCmd))
     .replaceAll('__PRETOOL_MD_READ_CMD__', escapeJsonStringValue(subs.pretoolMdReadCmd))
     .replaceAll('__POSTTOOL_RECALL_NUDGE_CMD__', escapeJsonStringValue(subs.posttoolRecallNudgeCmd))
+    .replaceAll('__REPORT_HEARTBEAT_CMD__', escapeJsonStringValue(subs.reportHeartbeatCmd))
     .replaceAll('__RECALL_EPISODE_METRIC_CMD__', escapeJsonStringValue(subs.recallEpisodeMetricCmd))
     .replaceAll('__GUARD_DESTRUCTIVE_DB_CMD__', escapeJsonStringValue(subs.guardCmd))
     .replaceAll('__USER_PROMPT_SKILL_GATE_CMD__', escapeJsonStringValue(subs.skillGateCmd))

package/src/detect.js

@@ -1,6 +1,7 @@
 import { readFileSync, existsSync, readdirSync, accessSync, constants } from 'node:fs'
 import { homedir } from 'node:os'
 import { join } from 'node:path'
+import { codexHomeDir } from './lib/codex-home.js'
 
 // 통일 연결 흐름(spec 2026-06-29-unified-connect-flow §3 D1): 이 컴퓨터에 깔린 AI 도구를 감지한다.
 //  registry 형 — Cursor/Gemini 등은 entry 추가만으로 확장. boolean 반환 금지.
@@ -44,7 +45,7 @@ function defaultHasCli(name, env = process.env, platform = process.platform) {
 export function detectInstalledTools({ home = homedir(), env = process.env, hasCli = defaultHasCli } = {}) {
   return TOOL_REGISTRY.map((t) => {
     const cli = t.cliNames.some((n) => hasCli(n, env))
-    const dir = existsSync(join(home, t.homeDir))
+    const dir = existsSync(t.id === 'codex' ? codexHomeDir({ home, env }) : join(home, t.homeDir))
     const present = cli || dir
     const signal = cli ? 'strong' : dir ? 'weak' : 'none'
     const reason = cli ? `${t.id} CLI 발견` : dir ? `~/${t.homeDir} 존재` : '없음'

package/src/lib/agent-env.js

@@ -0,0 +1,11 @@
+// spec 2026-09-28 다중 루키 §5.1 — 세션을 띄울 때 붙인 ROOKIE_AGENT(루키 이름표). 없으면 기본 루키.
+// hook·CLI·MCP 가 모두 이 값 하나로 x-rookie-agent 를 싣는다.
+export function agentSlug(env = process.env) {
+  const v = (env.ROOKIE_AGENT || '').trim()
+  return v || null
+}
+
+export function agentHeader(env = process.env) {
+  const slug = agentSlug(env)
+  return slug ? { 'x-rookie-agent': slug } : {}
+}

package/src/lib/apply-tool-setup.js

@@ -3,13 +3,14 @@ import { homedir } from 'node:os'
 import { join } from 'node:path'
 import { installSharedHookRuntime, applyClaudeSetup, applyCodexSetup } from './deploy-artifacts.js'
 import { ROOKIE_BEGIN } from './codex-config.js'
+import { codexHomeDir } from './codex-home.js'
 
 // 도구가 이미 rookie 로 설정됐는지. init 의 도구-추가 모드(early-return 우회) 판정용.
-export function isToolConfigured(id, { scope, home = homedir(), cwd = process.cwd() } = {}) {
+export function isToolConfigured(id, { scope, home = homedir(), cwd = process.cwd(), env = process.env } = {}) {
   const base = scope === 'global' ? home : cwd
   if (id === 'claude') return existsSync(join(base, '.claude', 'skills', 'rookie', 'SKILL.md'))
   if (id === 'codex') {
-    const cfg = join(home, '.codex', 'config.toml')
+    const cfg = join(codexHomeDir({ home, env }), 'config.toml')
     return existsSync(cfg) && readFileSync(cfg, 'utf8').includes(ROOKIE_BEGIN)
   }
   return false

package/src/lib/claude-md-block.js

@@ -18,6 +18,7 @@ import {
 import { homedir } from 'node:os'
 import { join, dirname, basename } from 'node:path'
 import { fileURLToPath } from 'node:url'
+import { codexHomeDir } from './codex-home.js'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
 export const DEFAULT_TEMPLATE_PATH = join(__dirname, '..', '..', 'templates', 'claude-md', 'rookie-block.md')
@@ -76,7 +77,7 @@ export function claudeTarget({ home = homedir() } = {}) {
 // (2026-09-29 codex 0.153.4 바이너리 strings + codex exec 실측).
 export function codexTarget({ home = homedir(), env = process.env } = {}) {
   return {
-    dir: env.CODEX_HOME ? env.CODEX_HOME : join(home, '.codex'),
+    dir: codexHomeDir({ home, env }),
     candidates: ['AGENTS.override.md', 'AGENTS.md'],
     createName: 'AGENTS.md',
     needles: [SAME_INTENT_NEEDLE, 'rookie_recall'],

package/src/lib/codex-config.js

@@ -37,7 +37,8 @@ function block(paths, platform = process.platform) {
       '',
       '[[hooks.UserPromptSubmit.hooks]]',
       'type = "command"',
-      `command = 'bash "${promptSubmit}"'`,
+      // 다중 루키 §8 — codex_cli 를 넘겨 보고 대장 열기를 건너뛴다(Codex 는 Stop hook 이 없어 닫지 못한다).
+      `command = 'bash "${promptSubmit}" codex_cli'`,
       // 파일만 읽고 끝나는 경로라 짧게 — Claude 쪽도 3초다.
       'timeout = 5'
     )

package/src/lib/codex-home.js

@@ -0,0 +1,8 @@
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+// Codex 설정 폴더. Codex 는 $CODEX_HOME 이 있으면 그 폴더를 쓴다(2026-09-29 바이너리 strings 실측).
+// config.toml·AGENTS.md·감지가 모두 이 한 곳을 보게 한다 — 갈리면 hook 과 지시 블록이 서로 다른 폴더에 들어간다.
+export function codexHomeDir({ home = homedir(), env = process.env } = {}) {
+  return env.CODEX_HOME ? env.CODEX_HOME : join(home, '.codex')
+}

package/src/lib/codex-mcp-env.js

@@ -0,0 +1,47 @@
+// spec 2026-09-28 다중 루키 §8 — Codex 는 MCP 서버에 환경 변수를 넘기지 않는다. [mcp_servers.rookie] 에
+// env_vars = ["ROOKIE_AGENT"] 가 있어야 rookie-mcp 가 세션의 루키로 주입·저장한다(없으면 둘 다 기본 루키).
+import { existsSync, readFileSync, readdirSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { codexHomeDir } from './codex-home.js'
+
+export const CODEX_AGENT_ENV_LINE = 'env_vars = ["ROOKIE_AGENT"]'
+
+// 반환: null = rookie MCP 미등록(검사 대상 아님) / { ok } = 등록됨, ROOKIE_AGENT 전달 여부.
+export function codexMcpAgentEnvStatus(toml) {
+  const lines = String(toml ?? '').split(/\r?\n/)
+  const start = lines.findIndex((l) => /^\s*\[mcp_servers\.rookie\]\s*(#.*)?$/.test(l))
+  if (start === -1) return null
+  let end = lines.length
+  for (let i = start + 1; i < lines.length; i++) {
+    if (/^\s*\[/.test(lines[i])) { end = i; break }
+  }
+  const section = lines.slice(start + 1, end).filter((l) => !/^\s*#/.test(l)).join('\n')
+  const m = section.match(/^\s*env_vars\s*=\s*\[([\s\S]*?)\]/m)
+  return { ok: !!m && /["']ROOKIE_AGENT["']/.test(m[1]) }
+}
+
+// 이 기기에서 루키 여럿을 쓰는가 — ROOKIE_AGENT 를 붙였거나, 채용 계정 세션 표식이 남아 있다.
+export function usesRookies({ home = homedir(), env = process.env } = {}) {
+  if ((env.ROOKIE_AGENT || '').trim()) return true
+  try {
+    return readdirSync(env.ROOKIE_LEDGER_MARK_DIR || join(home, '.rookie', 'state', 'ledger')).length > 0
+  } catch {
+    return false
+  }
+}
+
+export function codexMcpAgentEnvLine({ home, env } = {}) {
+  // CLAUDE.md 원칙 11 — 루키를 쓰지 않는 사용자의 doctor 출력은 이전과 같다(줄을 더하지 않는다).
+  if (!usesRookies({ home, env })) return null
+  const path = join(codexHomeDir({ home, env }), 'config.toml')
+  if (!existsSync(path)) return null
+  let st
+  try { st = codexMcpAgentEnvStatus(readFileSync(path, 'utf8')) } catch { return null }
+  if (!st) return null
+  if (st.ok) return '✓ Codex rookie-mcp 가 ROOKIE_AGENT 를 넘깁니다'
+  return [
+    '⚠ Codex rookie-mcp 가 ROOKIE_AGENT 를 넘기지 않습니다 — 루키를 붙여 띄워도 MCP 주입·저장은 기본 루키로 갑니다.',
+    `   → ${path} 의 [mcp_servers.rookie] 아래에 한 줄: ${CODEX_AGENT_ENV_LINE}`,
+  ].join('\n')
+}

package/src/lib/deploy-artifacts.js

@@ -1,10 +1,11 @@
 import { readFileSync, writeFileSync, existsSync, mkdirSync, chmodSync, cpSync } from 'node:fs'
 import { homedir } from 'node:os'
+import { codexHomeDir } from './codex-home.js'
 import { join, dirname } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { apiGet } from '../api.js'
 import { saveClientManifest } from './manifest.js'
-import { upsertCodexHookBlockDetailed } from './codex-config.js'
+import { upsertCodexHookBlockDetailed, ROOKIE_BEGIN, ROOKIE_END } from './codex-config.js'
 import { claudeHookCommand, escapeJsonStringValue } from './hook-command.js'
 import { mergeHooks } from './merge-hooks.js'
 import { syncSkillAssets } from './skill-installer.js'
@@ -66,6 +67,13 @@ export function installSharedHookRuntime({ scope, home, cwd } = {}) {
   )
   chmodSync(join(pretoolBinDir, 'work-recall-gate.sh'), 0o755)
 
+  // spec 2026-09-28 다중 루키 §6.5 — 보고 대장 생존 신호(PostToolUse 모든 도구, 5분 표식).
+  cpSync(
+    join(TEMPLATES, 'hook', 'bin', 'report-heartbeat.sh'),
+    join(pretoolBinDir, 'report-heartbeat.sh')
+  )
+  chmodSync(join(pretoolBinDir, 'report-heartbeat.sh'), 0o755)
+
   // spec 2026-07-25 §3 — recall 소비 실패율 계측 Stop 파서(순수 관측, flush-session 과 별개 훅).
   cpSync(
     join(TEMPLATES, 'hook', 'bin', 'recall-episode-metric.sh'),
@@ -137,6 +145,7 @@ export async function applyClaudeSetup({ scope, cfg, home, cwd } = {}) {
     sessionStartCmd: claudeHookCommand(join(binDir, 'session-start.sh')),
     pretoolMdReadCmd: claudeHookCommand(join(pretoolBinDir, 'pretool-md-read.sh')),
     posttoolRecallNudgeCmd: claudeHookCommand(join(pretoolBinDir, 'posttool-recall-nudge.sh')),
+    reportHeartbeatCmd: claudeHookCommand(join(pretoolBinDir, 'report-heartbeat.sh')),
     guardCmd: claudeHookCommand(join(binDir, 'guard-destructive-db.sh')),
     skillGateCmd: claudeHookCommand(join(binDir, 'user-prompt-skill-gate.sh')),
     workRecallGateCmd: claudeHookCommand(join(pretoolBinDir, 'work-recall-gate.sh')),
@@ -163,8 +172,8 @@ export async function applyClaudeSetup({ scope, cfg, home, cwd } = {}) {
 
 // ── 3층: Codex adapter — ~/.codex/config.toml 의 managed 블록(upsertCodexHookBlock).
 //    scope=global 전제(D3): Codex config 는 항상 전역이고 전역 hook 을 문다. 호출 게이트는 오케스트레이터 책임.
-export function applyCodexSetup({ home = homedir() } = {}) {
-  const codexDir = join(home, '.codex')
+export function applyCodexSetup({ home = homedir(), env = process.env, promptSubmit = true } = {}) {
+  const codexDir = codexHomeDir({ home, env })
   const configPath = join(codexDir, 'config.toml')
   const hookScript = join(home, '.rookie', 'bin', 'session-start.sh')
   const existing = existsSync(configPath) ? readFileSync(configPath, 'utf8') : ''
@@ -173,7 +182,7 @@ export function applyCodexSetup({ home = homedir() } = {}) {
     const upserted = upsertCodexHookBlockDetailed(existing, {
       sessionStart: hookScript,
       // 인격 대기열 소비자 — 짝이 없으면 파일만 쌓인다(spec 2026-09-02).
-      promptSubmit: join(homedir(), '.rookie', 'bin', 'user-prompt-skill-gate.sh'),
+      promptSubmit: promptSubmit ? join(home, '.rookie', 'bin', 'user-prompt-skill-gate.sh') : null,
     })
     next = upserted.toml
     // 마커 안에 흘러든 사용자 설정을 밖으로 옮겼으면 조용히 넘기지 않는다.
@@ -193,6 +202,24 @@ export function applyCodexSetup({ home = homedir() } = {}) {
   return { configPath, hookScript }
 }
 
+// rookie update 용 — 이미 동의해 managed 블록이 있는 Codex 설정만 새 템플릿으로 다시 쓴다.
+//  블록이 없으면 손대지 않는다(동의 없이 Codex 설정을 만들지 않는다). 구 블록은 skill-gate 를 인자 없이
+//  부르거나 아예 등록하지 않아, 새 스크립트가 Codex 를 Claude Code 로 오판하던 조합을 update 가 닫는다.
+export function refreshCodexSetupIfManaged({ home = homedir(), env = process.env } = {}) {
+  const configPath = join(codexHomeDir({ home, env }), 'config.toml')
+  if (!existsSync(configPath)) return { refreshed: false }
+  const before = readFileSync(configPath, 'utf8')
+  const begin = before.indexOf(ROOKIE_BEGIN)
+  if (begin === -1) return { refreshed: false }
+  // 기존 블록에 있던 hook 만 갱신한다 — 2026-09-03 이전 블록은 SessionStart 뿐이라, update 가 말없이
+  //  UserPromptSubmit hook 을 새로 달지 않는다(새 hook 은 `rookie codex-setup` 으로 동의 받고 단다).
+  const end = before.indexOf(ROOKIE_END, begin)
+  const block = end === -1 ? '' : before.slice(begin, end)
+  const r = applyCodexSetup({ home, env, promptSubmit: block.includes('[[hooks.UserPromptSubmit]]') })
+  if (r.error) return { refreshed: false, configPath, error: r.error }
+  return { refreshed: true, changed: readFileSync(configPath, 'utf8') !== before, configPath }
+}
+
 // init·login 공유 wrapper: 공유 런타임(1층) + Claude adapter(2층). 반환형은 기존과 동일.
 // PAT 발급은 호출자 책임(여기선 cfg 를 받기만).
 export async function deployClientArtifacts({ scope, cfg, home, cwd }) {
@@ -208,6 +235,7 @@ async function mergeSettings(settingsPath, partialPath, subs) {
     .replaceAll('__SESSION_START_CMD__', escapeJsonStringValue(subs.sessionStartCmd))
     .replaceAll('__PRETOOL_MD_READ_CMD__', escapeJsonStringValue(subs.pretoolMdReadCmd))
     .replaceAll('__POSTTOOL_RECALL_NUDGE_CMD__', escapeJsonStringValue(subs.posttoolRecallNudgeCmd))
+    .replaceAll('__REPORT_HEARTBEAT_CMD__', escapeJsonStringValue(subs.reportHeartbeatCmd))
     .replaceAll('__RECALL_EPISODE_METRIC_CMD__', escapeJsonStringValue(subs.recallEpisodeMetricCmd))
     .replaceAll('__GUARD_DESTRUCTIVE_DB_CMD__', escapeJsonStringValue(subs.guardCmd))
     .replaceAll('__USER_PROMPT_SKILL_GATE_CMD__', escapeJsonStringValue(subs.skillGateCmd))

package/src/lib/merge-hooks.js

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

package/templates/hook/bin/report-heartbeat.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+# PostToolUse(모든 도구) — 보고 대장 생존 신호. spec 2026-09-28 다중 루키 §6.5.
+# 긴 턴(첫 턴이 수십 분) 동안 현황 줄이 "30분째 기록 없음" 으로 잘못 보이지 않게, 5분마다 한 번
+# 서버에 "살아 있다" 를 보낸다. 도구 호출마다 네트워크를 타지 않는다 — 표식 파일 시각만 보고 끝난다.
+# 차단 절대 X — 항상 exit 0. set -e 금지.
+set +e
+
+[ "${ROOKIE_INTERNAL_INVOCATION:-}" = "1" ] && exit 0
+
+LEDGER_MARK_DIR="${ROOKIE_LEDGER_MARK_DIR:-$HOME/.rookie/state/ledger}"
+# CLAUDE.md 원칙 11 — 대장을 여는 세션(채용 계정 표식 또는 ROOKIE_AGENT)만 생존 신호를 보낸다.
+#   표식 폴더도 ROOKIE_AGENT 도 없으면 payload 를 볼 것도 없다 — stdin 만 비우고 끝낸다.
+#   stdin 을 남긴 채 끝내면 큰 도구 출력을 쓰던 쪽이 EPIPE 를 맞는다. 어느 경로든 끝까지 비운다.
+if [ -z "${ROOKIE_AGENT:-}" ] && [ ! -d "$LEDGER_MARK_DIR" ]; then
+  cat >/dev/null 2>&1
+  exit 0
+fi
+
+# payload 는 tool_response 전문까지 담아 클 수 있다 — session_id 는 앞머리에 있으므로 앞부분만 보고 나머지는 버린다.
+HEAD=$(head -c 4096 2>/dev/null)
+cat >/dev/null 2>&1
+SID=$(printf '%s' "$HEAD" | grep -o '"session_id"[[:space:]]*:[[:space:]]*"[A-Za-z0-9-]*"' | head -1 | sed 's/.*"\([A-Za-z0-9-]*\)"$/\1/')
+[ -n "$SID" ] || exit 0
+[ -f "$LEDGER_MARK_DIR/$SID" ] || [ -n "${ROOKIE_AGENT:-}" ] || exit 0
+
+STATE_DIR="${ROOKIE_HEARTBEAT_DIR:-$HOME/.rookie/state/heartbeat}"
+MARK="$STATE_DIR/$SID"
+INTERVAL_MIN="${ROOKIE_HEARTBEAT_INTERVAL_MIN:-5}"
+
+# 첫 도구 호출 — 지시가 방금 열렸으니 표식만 만들고 끝낸다.
+if [ ! -f "$MARK" ]; then
+  mkdir -p "$STATE_DIR" 2>/dev/null && touch "$MARK" 2>/dev/null
+  exit 0
+fi
+# 표식이 INTERVAL 분 안이면 끝.
+[ -n "$(find "$MARK" -mmin "-$INTERVAL_MIN" 2>/dev/null)" ] && exit 0
+touch "$MARK" 2>/dev/null
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [ -f "$SCRIPT_DIR/../lib/config-resolve.sh" ]; then
+  # shellcheck source=/dev/null
+  . "$SCRIPT_DIR/../lib/config-resolve.sh"
+elif [ -f "$HOME/.rookie/bin/lib/config-resolve.sh" ]; then
+  # shellcheck source=/dev/null
+  . "$HOME/.rookie/bin/lib/config-resolve.sh"
+fi
+command -v rookie_resolve_credentials >/dev/null 2>&1 || exit 0
+rookie_resolve_credentials "$PWD" || exit 0
+[ -n "$ROOKIE_RESOLVED_ENDPOINT" ] && [ -n "$ROOKIE_RESOLVED_TOKEN" ] || exit 0
+
+# 백그라운드로 던지고 기다리지 않는다. 실패는 버린다(다음 5분에 다시).
+( curl -sS --max-time 3 -o /dev/null -X POST \
+    -H "Authorization: Bearer $ROOKIE_RESOLVED_TOKEN" \
+    -H "Content-Type: application/json" \
+    --data "{\"session_id\":\"$SID\"}" \
+    "$ROOKIE_RESOLVED_ENDPOINT/api/rookie/report/heartbeat" >/dev/null 2>&1 & ) 2>/dev/null
+
+exit 0

package/templates/hook/session-start.sh

@@ -243,12 +243,16 @@ if [ "$STATUS_CODE" = "200" ]; then
   fi
 
   RESP_FILE=$(mktemp)
+  # spec 2026-09-28 다중 루키 §5.1 — ROOKIE_AGENT 로 어느 루키로 출근할지, x-rookie-session 으로 현황 줄에서
+  #   자기 세션을 뺀다. 빈 값 헤더는 curl 이 생략하므로 ROOKIE_AGENT 가 없으면 기본 루키다.
   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: $ROOKIE_SURFACE" \
     -H "x-rookie-manifest-hash: $LOCAL_HASH" \
+    -H "x-rookie-agent: ${ROOKIE_AGENT:-}" \
+    -H "x-rookie-session: $SESSION_ID" \
     -o "$RESP_FILE" \
     -w "%{http_code}" \
     "$ENDPOINT/api/rookie/context?$QS" 2>/dev/null) || CTX_CODE="000"
@@ -266,6 +270,21 @@ if [ "$STATUS_CODE" = "200" ]; then
       pending_inject_write "$SESSION_ID" "$RESP_FILE" "$SOURCE" || true
     fi
 
+    # CLAUDE.md 원칙 11 — 루키를 채용한 계정만 세션 표식을 남긴다. user-prompt-skill-gate·report-heartbeat 는
+    #   표식(또는 ROOKIE_AGENT)이 없으면 서버를 부르지 않는다 — 채용 안 한 사용자는 프롬프트 지연·대장 행이 없다.
+    #   grep 으로 본다: team_active 는 최상위 필드라 system_prompt 문자열(따옴표가 \" 로 escape)과 겹치지 않는다.
+    LEDGER_MARK_DIR="${ROOKIE_LEDGER_MARK_DIR:-$HOME/.rookie/state/ledger}"
+    SAFE_SID=$(printf '%s' "$SESSION_ID" | tr -cd 'A-Za-z0-9-')
+    if [ -n "$SAFE_SID" ]; then
+      if grep -q '"team_active":true' "$RESP_FILE" 2>/dev/null; then
+        mkdir -p "$LEDGER_MARK_DIR" 2>/dev/null && touch "$LEDGER_MARK_DIR/$SAFE_SID" 2>/dev/null
+      else
+        rm -f "$LEDGER_MARK_DIR/$SAFE_SID" 2>/dev/null
+      fi
+      # 하루 넘게 손대지 않은 표식 정리(세션 표식·heartbeat 표식). 쓰는 쪽이 매번 시각을 갱신한다.
+      find "$LEDGER_MARK_DIR" "${ROOKIE_HEARTBEAT_DIR:-$HOME/.rookie/state/heartbeat}" -type f -mmin +1440 -delete 2>/dev/null || true
+    fi
+
     QUEUE_AFTER=0
     if command -v queue_count >/dev/null 2>&1; then
       QUEUE_AFTER=$(queue_count)

package/templates/hook/settings.partial.json

@@ -50,6 +50,13 @@
       }
     ],
     "PostToolUse": [
+      {
+        "matcher": "*",
+        "__rookie_managed": true,
+        "hooks": [
+          { "type": "command", "command": "__REPORT_HEARTBEAT_CMD__" }
+        ]
+      },
       {
         "matcher": "Read|Bash|Grep",
         "__rookie_managed": true,

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

@@ -10,6 +10,10 @@ set -u
 # self-reference 방지: 차차 internal LLM 호출(claude -p)에서 발사된 hook 은 즉시 종료.
 [ "${ROOKIE_INTERNAL_INVOCATION:-}" = "1" ] && exit 0
 
+# spec 2026-09-28 다중 루키 §8 — Codex 는 인자로 codex_cli 를 넘긴다. Codex 는 Stop hook 이 없어 보고 대장을
+# 열면 닫지 못하므로 열기는 건너뛰고 현황만 조회한다.
+ROOKIE_SURFACE="${1:-claude_code}"
+
 # B6-1 (spec 2026-07-11 §B6): config 해석 — env > 프로젝트-로컬(.rookie/, cwd 상향) > 전역.
 # UserPromptSubmit hook 은 프로젝트 cwd 에서 발사되므로 $PWD 기준. lib 미배포(구설치)면 전역 폴백.
 _GATE_SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -23,10 +27,12 @@ fi
 if command -v rookie_resolve_credentials >/dev/null 2>&1; then
   rookie_resolve_credentials "$PWD" || exit 0
   TOKEN="$ROOKIE_RESOLVED_TOKEN"
+  ENDPOINT="$ROOKIE_RESOLVED_ENDPOINT"
 else
   CONFIG="$HOME/.rookie/config.json"
   [ -f "$CONFIG" ] || exit 0
   TOKEN=$(node -e "try{process.stdout.write(String(require('$CONFIG').token||''))}catch{}" 2>/dev/null)
+  ENDPOINT=$(node -e "try{process.stdout.write(String(require('$CONFIG').endpoint||''))}catch{}" 2>/dev/null)
 fi
 [ -n "$TOKEN" ] || exit 0
 
@@ -39,9 +45,10 @@ DROP_LOG="${ROOKIE_DROP_LOG:-$HOME/.rookie/dropped-mutations.log}"
 # 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" ROOKIE_PI_DIR="$PI_DIR" ROOKIE_DROP_LOG="$DROP_LOG" node -e '
+cat | ROOKIE_GATE_DIR="$GATE_DIR" ROOKIE_PI_DIR="$PI_DIR" ROOKIE_DROP_LOG="$DROP_LOG" \
+  ROOKIE_GATE_ENDPOINT="${ENDPOINT:-}" ROOKIE_GATE_TOKEN="$TOKEN" ROOKIE_GATE_SURFACE="$ROOKIE_SURFACE" node -e '
   let d="";
-  process.stdin.on("data",c=>d+=c).on("end",()=>{
+  process.stdin.on("data",c=>d+=c).on("end",async ()=>{
     const SKILL_MSG="⚠️ 이 세션에서 아직 rookie Skill 을 로드하지 않았습니다. 다른 작업·응답 전에 먼저 rookie Skill 을 호출하세요 — 회상(recall)·미link 등록 제안·기억 저장 절차가 그 안에 있습니다. (이미 호출했다면 이 안내는 사라집니다.)";
     const RECALL_MSG="🧠 이 프롬프트에 과거 맥락·방법 회상 신호가 있습니다. grep·파일 열람·자기판단·두목 되묻기 이전에 GET /api/rookie/recall 을 먼저 호출하세요 (brand.ts 회상-순서 룰).";
     const CKPT_MSG="📌 이 세션이 길어지고 있습니다. 직전 checkpoint 이후 마일스톤(커밋·배포·설계 수렴·단계 전환)이 지났다면 checkpoint 진입카드를 저장하세요 — 지나지 않았다면 무시해도 됩니다.";
@@ -109,6 +116,60 @@ cat | ROOKIE_GATE_DIR="$GATE_DIR" ROOKIE_PI_DIR="$PI_DIR" ROOKIE_DROP_LOG="$DROP
         return { text: head+"\n\n"+picked.join("\n\n"), commit };
       }catch{ release(); return null; }
     };
+    // spec 2026-09-28 다중 루키 §5.3·§6.1 — 보고 대장 열기(Claude Code) 또는 현황 조회(Codex).
+    // 1.5초 안에 못 받으면 이 부분만 건너뛴다(hook 전체는 3초 제한). 현황은 바뀐 때만 싣는다.
+    const LEDGER_TIMEOUT_MS=parseInt(process.env.ROOKIE_LEDGER_TIMEOUT_MS||"1500",10);
+    const ledger=async(fs,path,crypto,p,key)=>{
+      const ep=process.env.ROOKIE_GATE_ENDPOINT, tk=process.env.ROOKIE_GATE_TOKEN;
+      const sid=(p.session_id||"").toString();
+      if(!ep||!tk||!sid||typeof fetch!=="function") return [];
+      // 원칙 11 — 표식(session-start 가 채용 계정에만 남김)도 ROOKIE_AGENT 도 없으면 서버를 부르지 않는다.
+      const agent=(process.env.ROOKIE_AGENT||"").trim();
+      const safeSid=sid.replace(/[^A-Za-z0-9-]/g,"");
+      const markDir=process.env.ROOKIE_LEDGER_MARK_DIR||path.join(require("os").homedir(),".rookie","state","ledger");
+      let team=false;
+      if(safeSid){ try{ const now=new Date(); fs.utimesSync(path.join(markDir,safeSid),now,now); team=true; }catch{} }
+      if(!team&&!agent) return [];
+      // Codex 는 인자(codex_cli)로 알린다. 인자가 없는 구 config.toml 이어도 payload 로 알아본다 —
+      //  Codex payload 에만 turn_id 가 있고 transcript 는 ~/.codex/sessions/…/rollout-*.jsonl 이다.
+      const tp=(p.transcript_path||"").toString();
+      const codex=process.env.ROOKIE_GATE_SURFACE==="codex_cli"||p.turn_id!=null||/[\\/]\.codex[\\/]|[\\/]rollout-[^\\/]*\.jsonl$/.test(tp);
+      const headers={Authorization:"Bearer "+tk,"x-rookie-hostname":require("os").hostname()};
+      if(agent) headers["x-rookie-agent"]=agent;
+      const cwd=(p.cwd||"").toString();
+      let body=null;
+      try{
+        const signal=AbortSignal.timeout(LEDGER_TIMEOUT_MS);
+        if(!codex){
+          let prompt=(p.prompt||"").toString();
+          if(!prompt.trim()) return [];
+          const buf=Buffer.from(prompt,"utf8");
+          if(buf.length>65536){ let e=65536; while(e>0&&(buf[e]&0xc0)===0x80) e--; prompt=buf.subarray(0,e).toString("utf8"); }
+          const r=await fetch(ep+"/api/rookie/report/open",{method:"POST",headers:Object.assign({"Content-Type":"application/json"},headers),body:JSON.stringify(Object.assign({session_id:sid,prompt},cwd?{repo_path:cwd}:{})),signal});
+          if(r.ok) body=await r.json();
+        } else {
+          const q=new URLSearchParams({session_id:sid}); if(cwd) q.set("repo_path",cwd);
+          const r=await fetch(ep+"/api/rookie/report/concurrent?"+q.toString(),{headers,signal});
+          if(r.ok) body=await r.json();
+        }
+      }catch{ return []; }
+      if(!body) return [];
+      const out=[];
+      if(typeof body.notice==="string"&&body.notice) out.push(body.notice);
+      const cc=typeof body.concurrent==="string"?body.concurrent:"";
+      if(cc){
+        const gateDir=process.env.ROOKIE_GATE_DIR;
+        const h=crypto.createHash("sha256").update(cc).digest("hex");
+        let prev="";
+        const f=key&&gateDir?path.join(gateDir,key+".concurrent"):null;
+        if(f){ try{ prev=String(fs.readFileSync(f,"utf8")).trim(); }catch{} }
+        if(prev!==h){
+          out.push(cc);
+          if(f){ try{ fs.mkdirSync(gateDir,{recursive:true,mode:0o700}); fs.writeFileSync(f,h,{mode:0o600}); }catch{} }
+        }
+      }
+      return out;
+    };
     try{
       const fs=require("fs"), path=require("path"), crypto=require("crypto");
       const gateDir=process.env.ROOKIE_GATE_DIR;
@@ -210,9 +271,12 @@ cat | ROOKIE_GATE_DIR="$GATE_DIR" ROOKIE_PI_DIR="$PI_DIR" ROOKIE_DROP_LOG="$DROP
       else if(ckptDue) base=CKPT_MSG;                 // 로드됨 + 무신호 + 임계 도달 → checkpoint 리마인더
       let taken=null;
       try{ taken=takePendingPersona(fs,path,key); }catch{ taken=null; }
+      let ledgerParts=[];
+      try{ ledgerParts=await ledger(fs,path,crypto,p,key); }catch{ ledgerParts=[]; }
       const parts=[];
       if(taken) parts.push(taken.text);
       if(base) parts.push(base);
+      for(const x of ledgerParts) parts.push(x);
       if(parts.length===0) return;                    // 둘 다 없음 → 조용
       injectMsg(parts.join("\n\n"));
       if(taken) taken.commit();                       // 내보낸 뒤에 소비 표시

package/templates/skill/SKILL.md

@@ -141,6 +141,8 @@ curl -s -H "Authorization: Bearer $TOKEN" \
 
 **본문 작성 전 `references/save.md` 를 Read 한다(세션 첫 저장 전 1회 필수)** — 스키마·`all_committed` 게이트·귀속 확인·supersede 후보 처리·자기 규칙 검토 게이트·checkpoint/durable 분리 규칙이 거기 있다. 호출은 `rookie save --file <body.json>` (curl 직접 batch-mutate 금지, `rookie:mutate` fence 화면 출력 금지, 토큰 출력 금지).
 
+**점유 선언** (루키 팀을 쓰는 세션만 — `ROOKIE_AGENT` 로 출근했거나 context 응답 `team_active:true`. 아니면 건너뛴다): 공유 자원(맥미니 빌드·실기기·배포·대량 디스크)을 쓰기 **직전** `rookie claim "맥미니 iOS 빌드, 디스크 ~10Gi"` — 자원 이름으로 쓴다(프로젝트 이름 아님). 다른 세션 현황 줄 맨 앞에 뜨고, 보고가 붙으면 풀린다. 주입에 `## 👥 다른 세션 현황` 의 점유가 보이면 그 자원은 피하거나 먼저 확인한다.
+
 ## 세션 마무리 자동 저장 (추출 책임이 루키에게)
 
 서버는 LLM 추출을 하지 않는다 — 세션 핵심 기억은 루키가 직접 저장한다. **마무리 징후 감지 시** (끝내자/수고/오늘 여기까지, 작업 완결, 의미 있는 단락):

package/version.json

@@ -1,4 +1,4 @@
 {
-  "cli_version": "0.4.39",
-  "skill_version": "1.40.1"
+  "cli_version": "0.4.41",
+  "skill_version": "1.41.0"
 }