therookie 0.4.3

package/src/commands/update.js

@@ -0,0 +1,220 @@
+// rookie update — templates 동기화 전용 명령
+// spec post-v5-decisions §18 — hook 자동 동기화
+// PAT 재발급 0건. cfg.token / pending/ / last_success 무변경.
+
+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 { loadConfig } from '../config.js'
+import { apiGet } from '../api.js'
+import { loadClientManifest, saveClientManifest, compareManifest, computeBundleManifest } from '../lib/manifest.js'
+import { semverGt, fetchReleaseManifest, selfUpdateAndRerun, isNpmManagedInstall } from '../lib/self-update.js'
+import { installSkill } from '../lib/skill-installer.js'
+import { claudeHookCommand, escapeJsonStringValue } from '../lib/hook-command.js'
+import { mergeHooks } from '../lib/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')
+
+export async function runUpdate(flags) {
+  const cfg = loadConfig()
+  if (!cfg) {
+    console.log('✗ ~/.rookie/config.json 없음 — `rookie init` 먼저 실행하세요.')
+    process.exit(1)
+  }
+
+  // task 77b93db0 — 자가 갱신 게이트. 서버 릴리스가 더 새 cli_version 이면 자기(구) 번들 템플릿을
+  // 설치하면 안 된다 — install.sh 로 재설치 후 새 CLI 의 update 로 위임. manifest 비교(아래
+  // "최신" 판정)보다 먼저 와야 hash 가 이미 선기록된 오염 설치본도 탈출한다.
+  const { cli_version: localCliVersion, skill_version: localSkillVersion } = JSON.parse(
+    readFileSync(VERSION_PATH, 'utf8')
+  )
+  if (!process.env.ROOKIE_UPDATE_REEXEC) {
+    const release = await fetchReleaseManifest(cfg.endpoint)
+    if (release && semverGt(release.cli_version, localCliVersion)) {
+      // npm(공식 채널) 설치본은 install.sh 자가 갱신을 돌리면 ~/.rookie/cli 에 이중 설치된다 —
+      // npm 으로 갱신하도록 안내하고 종료(구 번들 templates 동기화도 하지 않는다).
+      if (isNpmManagedInstall()) {
+        console.log(`CLI ${localCliVersion} → ${release.cli_version} 새 버전 — npm 으로 갱신하세요:`)
+        console.log(`  npm i -g therookie@latest`)
+        return
+      }
+      console.log(`CLI ${localCliVersion} → ${release.cli_version} 자가 갱신 (서버 릴리스가 더 새 버전)`)
+      const code = await selfUpdateAndRerun({
+        endpoint: cfg.endpoint,
+        targetVersion: release.cli_version,
+        force: flags.force,
+      })
+      process.exit(code)
+    }
+  }
+
+  let serverManifest
+  try {
+    const status = await apiGet(cfg.endpoint, cfg.token, '/api/rookie/status')
+    serverManifest = status.templates
+    if (!serverManifest || typeof serverManifest.manifest_hash !== 'string') {
+      console.log('✗ 서버 응답에 templates manifest 부재 — 서버 버전이 §18 미반영입니다.')
+      process.exit(1)
+    }
+  } catch (e) {
+    console.log(`✗ 서버 연결 실패: ${e.message}`)
+    process.exit(1)
+  }
+
+  const local = loadClientManifest()
+  const cmp = compareManifest(serverManifest.manifest_hash, local)
+
+  if (cmp.match && !flags.force) {
+    console.log(`✓ 최신 — manifest ${cmp.server_hash.slice(0, 12)}…`)
+    return
+  }
+
+  if (!cmp.match) {
+    console.log(`hook templates 미스매치 감지`)
+    console.log(`  서버: ${cmp.server_hash.slice(0, 12)}…`)
+    console.log(`  로컬: ${cmp.local_hash ? cmp.local_hash.slice(0, 12) + '…' : '없음 (옛 install)'}`)
+  } else {
+    console.log(`--force — 강제 재설치 (manifest 일치 상태)`)
+  }
+
+  // task 77b93db0 — 번들 정합 검증. 자기 번들 템플릿이 서버 선언과 다르면(같은 cli_version 인데
+  // 내용이 다른 비정상 상태) 구 템플릿을 덮지 않도록 중단. --force 는 로컬 개발 번들 설치용으로
+  // 통과시키되, hash 기록은 아래에서 생략해 "최신" 오판을 만들지 않는다.
+  const bundleMatches =
+    computeBundleManifest(TEMPLATES, localSkillVersion).manifest_hash === serverManifest.manifest_hash
+  if (!bundleMatches && !flags.force) {
+    console.log('✗ 로컬 CLI 번들 템플릿이 서버 manifest 와 다릅니다 — 구 템플릿 설치를 중단합니다.')
+    console.log(`  재설치: curl -fsSL ${cfg.endpoint}/install.sh | bash`)
+    console.log('  (이 번들을 그대로 설치하려면 --force — 단 manifest hash 는 기록되지 않습니다)')
+    process.exit(1)
+  }
+
+  // hook 배포 (init.js 와 동일 경로 — 글로벌 ~/.rookie/bin)
+  const binDir = join(homedir(), '.rookie', 'bin')
+  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)
+
+  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)
+
+  // settings.json 재병합 (글로벌)
+  const settingsPath = join(homedir(), '.claude', 'settings.json')
+  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')),
+  })
+
+  // v6 P0b — 글로벌 SKILL.md 갱신 (backup-and-overwrite). 같은 본문이면 no-op.
+  const skillResult = installSkill({
+    scope: 'global',
+    version: serverManifest.skill_version,
+    installedBy: 'rookie-cli update',
+  })
+  if (skillResult.installed) {
+    console.log(`✓ Skill 갱신 → ${skillResult.path}`)
+    if (skillResult.backup) console.log(`  · 이전 본문 backup → ${skillResult.backup}`)
+  } else {
+    console.log(`✓ Skill 본문 변경 없음 (manifest 동기화만)`)
+  }
+
+  console.log(`✓ Hook 동기화: ${binDir}`)
+  if (settingsResult?.merged === false) {
+    console.log(`⚠ settings.json 이 깨진 JSON 이라 hook 병합을 건너뛰었습니다(원본 보존) — 수동 점검: ${settingsPath}`)
+  } else {
+    console.log(`✓ settings.json 병합: ${settingsPath}`)
+  }
+
+  // hash 기록은 번들 == 서버 선언일 때만 — 다른 본문을 설치하고 신규 hash 를 선기록하면
+  // 이후 update·--force 가 전부 "최신" 오판에 빠진다 (task 77b93db0 원인).
+  if (bundleMatches) {
+    saveClientManifest(serverManifest)
+    console.log(`✓ ~/.rookie/manifest.json 갱신 → ${serverManifest.manifest_hash.slice(0, 12)}…`)
+  } else {
+    console.log('⚠ 번들 ≠ 서버 manifest — hash 기록 생략 (다음 update 가 미스매치를 다시 감지합니다)')
+  }
+}
+
+// deploy-artifacts.js 의 mergeSettings 와 동일 동작 (mergeHooks 는 spec 2026-07-10 에서
+// lib/merge-hooks.js 로 단일화 — mergeSettings 본문의 DRY 위배만 잔존, 범위 분리)
+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 — 덮어쓰면 사용자 설정 소실. 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/config.js

@@ -0,0 +1,65 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync, chmodSync } from 'node:fs'
+import { homedir, hostname } from 'node:os'
+import { join, dirname, resolve } from 'node:path'
+
+const CONFIG_DIR = join(homedir(), '.rookie')
+const CONFIG_PATH = join(CONFIG_DIR, 'config.json')
+
+function readJson(path) {
+  try { return JSON.parse(readFileSync(path, 'utf8')) }
+  catch { return null }
+}
+
+// B6-1 (spec 2026-07-11-memory-reliability-fix-design §B6): cwd 상향 탐색 —
+// <dir>/.rookie/config.json. 전역 경로(~/.rookie/config.json) 자체는 로컬로 치지 않는다
+// ($HOME 도달 시 전역과 혼동 방지 — 전역은 아래 resolveConfig 폴백 몫).
+export function findLocalConfigPath(startDir = process.cwd()) {
+  let dir = resolve(startDir)
+  for (;;) {
+    const candidate = join(dir, '.rookie', 'config.json')
+    if (candidate !== CONFIG_PATH && existsSync(candidate)) return candidate
+    const parent = dirname(dir)
+    if (parent === dir) return null
+    dir = parent
+  }
+}
+
+// B6-1 해석 순서: env(ROOKIE_ENDPOINT+ROOKIE_TOKEN 둘 다) > 로컬(상향 탐색) > 전역.
+// 반환: { config, path, scope } — path 는 env 스코프에서 null.
+export function resolveConfig({ cwd = process.cwd(), env = process.env } = {}) {
+  if (env.ROOKIE_ENDPOINT && env.ROOKIE_TOKEN) {
+    return {
+      config: { endpoint: env.ROOKIE_ENDPOINT, token: env.ROOKIE_TOKEN },
+      path: null,
+      scope: 'env',
+    }
+  }
+  const localPath = findLocalConfigPath(cwd)
+  if (localPath) {
+    const cfg = readJson(localPath)
+    if (cfg) return { config: cfg, path: localPath, scope: 'local' }
+  }
+  return { config: readJson(CONFIG_PATH), path: CONFIG_PATH, scope: 'global' }
+}
+
+export function loadConfig(opts) {
+  return resolveConfig(opts).config
+}
+
+// 전역 config 만 명시적으로 읽는다 — B6-2 전역 교체 게이트가 로컬 config 에 오염되지 않게.
+export function loadGlobalConfig() {
+  return readJson(CONFIG_PATH)
+}
+
+// path 미지정 = 전역(기존 호출 무변경). B6-1 의 로컬 저장은 login 이 명시 경로로 호출.
+export function saveConfig(cfg, { path = CONFIG_PATH } = {}) {
+  mkdirSync(dirname(path), { recursive: true })
+  writeFileSync(path, JSON.stringify(cfg, null, 2))
+  try { chmodSync(path, 0o600) } catch {}
+}
+
+export function configPath() { return CONFIG_PATH }
+// B6-4: 임의 디렉토리 기준 유효 config 경로(로컬 상향 탐색 > 전역) — sweep partition 판정용.
+export function configPathForCwd(dir) { return findLocalConfigPath(dir) ?? CONFIG_PATH }
+export function localConfigPathFor(dir) { return join(resolve(dir), '.rookie', 'config.json') }
+export function getHostname() { return hostname() }

package/src/detect.js

@@ -0,0 +1,109 @@
+import { readFileSync, existsSync, readdirSync, accessSync, constants } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+// 통일 연결 흐름(spec 2026-06-29-unified-connect-flow §3 D1): 이 컴퓨터에 깔린 AI 도구를 감지한다.
+//  registry 형 — Cursor/Gemini 등은 entry 추가만으로 확장. boolean 반환 금지.
+//  신호: CLI 바이너리 존재 = 'strong'(붙일 의도 강함), 홈 디렉토리만 = 'weak', 없음 = 'none'.
+//  비대화형 자동 설정은 strong 만(false positive 방지), 대화형은 weak 도 확인 경유.
+const TOOL_REGISTRY = [
+  { id: 'claude', cliNames: ['claude'], homeDir: '.claude' },
+  { id: 'codex', cliNames: ['codex'], homeDir: '.codex' },
+]
+
+// PATH 후보 경로 목록 — platform 별 구분자/확장자를 반영한 순수 함수(테스트 친화).
+//  Windows 는 PATH 구분자가 ';' 이고 실행 파일이 claude.cmd·codex.exe 처럼 PATHEXT 확장자를 가진다.
+//  path.delimiter 는 실행 OS 에 고정돼 크로스플랫폼 단위 테스트가 안 되므로 platform 인자로 분기한다.
+export function cliCandidatePaths(name, env = process.env, platform = process.platform) {
+  const sep = platform === 'win32' ? ';' : ':'
+  const dirs = (env.PATH || '').split(sep).filter(Boolean)
+  const exts = platform === 'win32'
+    ? ['', ...(env.PATHEXT || '.COM;.EXE;.BAT;.CMD').split(';').filter(Boolean)]
+    : ['']
+  const out = []
+  for (const dir of dirs) for (const ext of exts) out.push(join(dir, name + ext))
+  return out
+}
+
+// PATH 에서 실행 가능한 바이너리 존재 확인. 테스트는 hasCli 를 주입해 우회.
+// 주의: 이 'strong' 신호는 표시·우선순위용일 뿐, 자동 연결의 필수 조건이 아니다 — 연결은 CLI 를
+// 실행하지 않고 ~/.codex/config.toml·~/.claude/skills 만 건드린다. 그래서 비대화 PATH 가 빈약해
+// 바이너리를 못 찾아도(아래 env.PATH 만 사용) 홈 설정 디렉토리(weak)로 자동 연결한다(applyToolSetup).
+// → 환경별 바이너리 위치 추측(homebrew/nvm/login-shell)을 폐기, plain PATH 만 본다.
+function defaultHasCli(name, env = process.env, platform = process.platform) {
+  return cliCandidatePaths(name, env, platform).some((p) => {
+    try {
+      accessSync(p, constants.X_OK)
+      return true
+    } catch {
+      return false
+    }
+  })
+}
+
+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 present = cli || dir
+    const signal = cli ? 'strong' : dir ? 'weak' : 'none'
+    const reason = cli ? `${t.id} CLI 발견` : dir ? `~/${t.homeDir} 존재` : '없음'
+    return { id: t.id, present, signal, reason }
+  })
+}
+
+export function parseSkillFrontmatter(path) {
+  if (!existsSync(path)) return null
+  const raw = readFileSync(path, 'utf8')
+  const m = raw.match(/^---\n([\s\S]*?)\n---/)
+  if (!m) return null
+  const out = {}
+  for (const line of m[1].split('\n')) {
+    const idx = line.indexOf(':')
+    if (idx < 0) continue
+    const k = line.slice(0, idx).trim()
+    const v = line.slice(idx + 1).trim()
+    out[k] = v
+  }
+  return out
+}
+
+export function detectGlobalInstall() {
+  const path = join(homedir(), '.claude', 'skills', 'rookie', 'SKILL.md')
+  const fm = parseSkillFrontmatter(path)
+  return fm ? { path, version: fm.version, scope: fm.scope } : null
+}
+
+export function detectLocalInstall(cwd = process.cwd()) {
+  const path = join(cwd, '.claude', 'skills', 'rookie', 'SKILL.md')
+  const fm = parseSkillFrontmatter(path)
+  return fm ? { path, version: fm.version, scope: fm.scope } : null
+}
+
+export function deepScanForLocalInstalls(rootDirs = [homedir()], maxDepth = 3) {
+  const found = []
+  for (const root of rootDirs) walk(root, 0, maxDepth, found)
+  return found
+}
+
+function walk(dir, depth, maxDepth, found) {
+  if (depth > maxDepth) return
+  let entries
+  try { entries = readdirSync(dir, { withFileTypes: true }) }
+  catch { return }
+  for (const e of entries) {
+    if (!e.isDirectory()) continue
+    if (e.name.startsWith('.')) {
+      if (e.name === '.claude') {
+        const candidate = join(dir, '.claude', 'skills', 'rookie', 'SKILL.md')
+        if (existsSync(candidate)) {
+          const fm = parseSkillFrontmatter(candidate)
+          if (fm) found.push({ path: candidate, projectDir: dir, version: fm.version, scope: fm.scope })
+        }
+      }
+      continue
+    }
+    if (e.name === 'node_modules') continue
+    walk(join(dir, e.name), depth + 1, maxDepth, found)
+  }
+}

package/src/lib/account-ui.js

@@ -0,0 +1,28 @@
+// B1 Identity Guard (spec 2026-07-11-memory-reliability-fix-design §B1) — 계정 요약 표시 공용.
+// status/doctor/login/init 이 같은 1줄 포맷과 빈-계정 경고 판정을 쓴다.
+
+// 규모 감각용 반올림 (§5 리스크: fact 건수는 반올림 표시 — 예: 4653 → 4.7k).
+export function formatFactsCount(n) {
+  if (typeof n !== 'number') return '?'
+  if (n >= 1000) return `${Math.round(n / 100) / 10}k`
+  return String(n)
+}
+
+// '계정: de***@… (프로필 두목) · 프로젝트 12 · 기억 4.7k건' — account 없으면 null.
+export function accountLine(account) {
+  if (!account) return null
+  const who = account.email_masked ?? account.profile_name ?? null
+  if (!who) return null
+  const profile = account.email_masked && account.profile_name ? ` (프로필 ${account.profile_name})` : ''
+  const projects = typeof account.projects_count === 'number' ? account.projects_count : '?'
+  return `계정: ${who}${profile} · 프로젝트 ${projects} · 기억 ${formatFactsCount(account.facts_count)}건`
+}
+
+// B1-2 빈-계정 경고: projects 0 && facts < 50. count 미상(null)은 오탐 방지 위해 경고하지 않는다.
+export function accountWarning(account) {
+  if (!account) return null
+  if (account.projects_count === 0 && typeof account.facts_count === 'number' && account.facts_count < 50) {
+    return '⚠️ 이 계정은 비어 있습니다 — 본체 계정이 맞는지 확인하세요 (rookie login)'
+  }
+  return null
+}

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

@@ -0,0 +1,89 @@
+import { existsSync, readFileSync } from 'node:fs'
+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'
+
+// 도구가 이미 rookie 로 설정됐는지. init 의 도구-추가 모드(early-return 우회) 판정용.
+export function isToolConfigured(id, { scope, home = homedir(), cwd = process.cwd() } = {}) {
+  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')
+    return existsSync(cfg) && readFileSync(cfg, 'utf8').includes(ROOKIE_BEGIN)
+  }
+  return false
+}
+
+// 적용 대상이지만(게이트 통과 가능) 아직 rookie 미설정인 도구 목록.
+//  init 이 "Claude 있고 Codex 만 추가" 를 early-return 으로 막지 않게 하는 신호(spec §4 item 4, P2).
+//  interactive=false(비대화형)면 weak 신호는 applyToolSetup 이 어차피 skip 하므로 pending 에서도 제외 —
+//  "추가하겠다" 안내와 실제 동작을 일치시킨다(정직).
+export function pendingToolSetup({ tools, scope, home, cwd } = {}) {
+  return (tools ?? []).filter((t) => {
+    if (!t.present || t.signal === 'none') return false
+    if (t.id === 'codex' && scope !== 'global') return false // D3
+    // weak(설정 디렉토리)도 비대화에서 자동 연결되므로 더는 pending 에서 제외하지 않는다(applyToolSetup 정합).
+    return !isToolConfigured(t.id, { scope, home, cwd })
+  })
+}
+
+// 통일 연결 흐름 오케스트레이터(spec 2026-06-29-unified-connect-flow §4 item 2).
+//  detectInstalledTools() 결과를 받아 적용 대상을 정하고, 1개+면 공유 런타임(1층)을
+//  먼저 깐 뒤 도구별 adapter(Claude/Codex)를 적용한다. login·init 가 공유한다.
+//
+//  선택 규칙:
+//   - present(strong CLI 발견 또는 weak 설정 디렉토리만) → 비대화형에서도 자동 적용.
+//     연결은 CLI 실행이 아니라 ~/.codex·~/.claude 설정 편집이라 weak 도 안전(두목 2026-06-30).
+//   - Codex adapter 는 scope=global 에서만(D3 — 전역 Codex↔로컬 hook 충돌 차단).
+//
+//  레이어 함수는 deps 로 주입 가능(테스트용). 기본은 실 구현.
+export async function applyToolSetup({
+  tools,
+  scope,
+  cfg,
+  home,
+  cwd,
+  deps = {},
+} = {}) {
+  const installShared = deps.installShared ?? installSharedHookRuntime
+  const applyClaude = deps.applyClaude ?? applyClaudeSetup
+  const applyCodex = deps.applyCodex ?? applyCodexSetup
+
+  const applied = []
+  const skipped = []
+  const toApply = []
+
+  for (const t of tools ?? []) {
+    if (!t.present || t.signal === 'none') { skipped.push({ id: t.id, reason: 'not_present' }); continue }
+    // D3: Codex 자동 등록은 scope=global 전제. 로컬에서는 전역 Codex 가 로컬 hook 을 무는 사고가 난다.
+    if (t.id === 'codex' && scope !== 'global') { skipped.push({ id: t.id, reason: 'codex_requires_global' }); continue }
+    // strong(CLI 발견)·weak(설정 디렉토리만) 모두 자동 연결한다. 연결은 CLI 를 실행하지 않고
+    // ~/.codex·~/.claude 설정만 건드리므로, 비대화 PATH 가 빈약해 바이너리를 못 찾아도(weak)
+    // 그 도구 사용자다 → 환경 무관 자동 연결(두목 2026-06-30, confirmWeak/interactive 게이트 폐기).
+    if (t.signal === 'strong' || t.signal === 'weak') { toApply.push(t); continue }
+    skipped.push({ id: t.id, reason: 'unknown_signal' })
+  }
+
+  let sharedInstalled = false
+  let sharedBinDir = null
+  if (toApply.length >= 1) {
+    sharedBinDir = installShared({ scope, home, cwd })?.binDir ?? null
+    sharedInstalled = true
+  }
+
+  for (const t of toApply) {
+    if (t.id === 'claude') {
+      applied.push({ id: 'claude', ...(await applyClaude({ scope, cfg, home, cwd })) })
+    } else if (t.id === 'codex') {
+      const r = applyCodex({ home })
+      if (r?.error) skipped.push({ id: 'codex', reason: r.error })
+      else applied.push({ id: 'codex', ...r })
+    } else {
+      // 미래 도구(Cursor/Gemini 등) — detector 엔 있지만 adapter 미구현. 안전 skip.
+      skipped.push({ id: t.id, reason: 'no_adapter' })
+    }
+  }
+
+  return { scope, sharedInstalled, sharedBinDir, applied, skipped }
+}

package/src/lib/codex-config.js

@@ -0,0 +1,46 @@
+// Codex config.toml 의 더루키 SessionStart hook 블록을 동의 기반 append/교체한다.
+// TOML 파서 없이(의존성 0) 마커 블록 텍스트 조작 — 마커 밖 사용자 설정은 보존.
+import { toPosixPath } from './hook-command.js'
+
+export const ROOKIE_BEGIN = '# >>> rookie codex hook (managed) — 수동 편집 금지 >>>'
+export const ROOKIE_END = '# <<< rookie codex hook (managed) <<<'
+
+function block(hookScriptPath, platform = process.platform) {
+  // Codex SessionStart command handler. additionalContext 출력 형식은 Claude 와 동일.
+  // Windows 는 backslash 경로를 forward-slash 로 변환(Git Bash 가 실행) — macOS/Linux 무변경.
+  const path = toPosixPath(hookScriptPath, platform)
+  return [
+    ROOKIE_BEGIN,
+    '[[hooks.SessionStart]]',
+    'matcher = "startup|resume"',
+    '',
+    '[[hooks.SessionStart.hooks]]',
+    'type = "command"',
+    // B-3: codex_cli 표면을 인자로 전달 → session-start.sh 가 x-rookie-surface 로 비콘.
+    // (Codex Desktop 도 같은 config.toml 을 읽어 codex_cli 로 집계 — desktop 세분화는 후속.)
+    `command = 'bash "${path}" codex_cli'`,
+    'timeout = 15',
+    ROOKIE_END,
+  ].join('\n')
+}
+
+// 기존 managed 블록이 있으면 교체, 없으면 끝에 append. 마커 밖은 보존.
+export function upsertCodexHookBlock(existingToml, hookScriptPath, platform = process.platform) {
+  const fresh = block(hookScriptPath, platform)
+  const begin = existingToml.indexOf(ROOKIE_BEGIN)
+  if (begin === -1) {
+    const base = existingToml.replace(/\s*$/, '')
+    return (base ? base + '\n\n' : '') + fresh + '\n'
+  }
+  const endIdx = existingToml.indexOf(ROOKIE_END, begin)
+  if (endIdx === -1) {
+    // D4/§4 item 5: begin 만 있고 end 손상 → begin 이후를 무조건 버리면 사용자 config 가 유실된다.
+    //  managed 영역 끝을 안전하게 못 정하므로 호출자가 경고·중단하도록 신호(파일 미변경).
+    const err = new Error('Codex config 의 rookie managed 블록이 손상됨(end marker 없음)')
+    err.code = 'MALFORMED_CODEX_MARKER'
+    throw err
+  }
+  const before = existingToml.slice(0, begin)
+  const after = existingToml.slice(endIdx + ROOKIE_END.length)
+  return before + fresh + after
+}

package/src/lib/connect-ui.js

@@ -0,0 +1,59 @@
+// 통일 연결 흐름 — login·init 공유 출력 렌더링(순수 함수, 테스트 가능).
+//  applyToolSetup 리포트를 사람이 읽는 줄 배열로 변환. brand 톤(겸손한 신입, spec §4 item 7).
+export const TOOL_NAMES = { claude: 'Claude Code', codex: 'Codex CLI' }
+
+export function toolName(id) {
+  return TOOL_NAMES[id] ?? id
+}
+
+// 적용 전 감지 결과 한 줄. 감지 0개면 null.
+export function renderDetected(tools) {
+  const present = (tools ?? []).filter((t) => t.present)
+  if (present.length === 0) return null
+  return `  감지된 도구: ${present.map((t) => `${toolName(t.id)}(${t.reason})`).join(', ')}`
+}
+
+// applyToolSetup 리포트 + 감지 결과 → 출력 줄 배열(적용 결과 + 환영/안내).
+//  - 1개+ 적용: 환영 + "다른 도구는 rookie init" 안내(수용기준 6)
+//  - 감지됐지만 전부 skip: rookie init 안내(PAT 는 저장됨)
+//  - 감지 0개: 안내만(수용기준 1)
+export function renderConnectOutcome(report, tools, agentName) {
+  // 사용자가 온보딩에서 정한 루키 이름(login 이 device 응답에서 받아 전달). 없으면 기본 'Rookie'.
+  const name = (agentName && String(agentName).trim()) || 'Rookie'
+  const lines = []
+  const applied = report?.applied ?? []
+  const skipped = report?.skipped ?? []
+  const anyPresent = (tools ?? []).some((t) => t.present)
+
+  if (report?.sharedBinDir) lines.push(`✓ 공유 hook 런타임: ${report.sharedBinDir}`)
+  for (const a of applied) {
+    if (a.id === 'claude') {
+      lines.push(`✓ ${toolName('claude')} 연결: ${a.skillDir}`)
+      if (a.settingsWarning === 'settings_unparsable') {
+        lines.push(`  ⚠ settings.json 이 깨진 JSON 이라 hook 병합을 건너뛰었어요(원본 보존) — 수동 점검이 필요해요.`)
+      }
+    } else if (a.id === 'codex') lines.push(`✓ ${toolName('codex')} 연결: ${a.configPath}`)
+    else lines.push(`✓ ${toolName(a.id)} 연결`)
+  }
+  for (const s of skipped) {
+    if (s.reason === 'codex_requires_global') {
+      lines.push(`ⓘ ${toolName('codex')} 는 전역 연결에서만 자동 등록됩니다 — \`rookie login\`(--local 없이).`)
+    } else if (s.reason === 'malformed_marker') {
+      lines.push(`⚠ ${toolName('codex')} config 의 managed 블록이 손상돼 자동 등록을 중단했습니다 — config.toml 을 수동 점검하세요(기존 설정은 보존됨).`)
+    }
+  }
+
+  if (applied.length > 0) {
+    // 연결 성공이면 끝 — 'rookie init' 안내는 띄우지 않는다. init 은 login 과 같은 일이라
+    // 노이즈였다(두목 2026-06-30). 나중에 새 도구를 깔면 `rookie login` 을 다시 돌리면 자동 연결된다.
+    lines.push('')
+    lines.push(`✓ 이제 ${name}가 합류했습니다. 어느 세션에서든 같은 맥락으로 기억을 가져옵니다.`)
+  } else if (anyPresent) {
+    lines.push('')
+    lines.push('ⓘ 자동 연결된 도구가 없습니다 — `rookie login` 을 다시 실행해 보세요. PAT 는 저장됐습니다.')
+  } else {
+    lines.push('')
+    lines.push('감지된 AI 도구가 없습니다(Claude Code·Codex). 도구 설치 후 `rookie login` 을 다시 실행하세요. PAT 는 저장됐습니다.')
+  }
+  return lines
+}