therookie 0.4.3

package/src/commands/done-scan.js

@@ -0,0 +1,162 @@
+import { execSync } from 'node:child_process'
+import { readFileSync, writeFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { loadConfig } from '../config.js'
+import { apiGet } from '../api.js'
+import { matchDoneCandidates } from '../lib/task-path-match.js'
+
+// spec docs/superpowers/specs/2026-07-01-completion-linkage-remove-vs-improve.md §5.4.
+// hook(session-start.sh)이 매 세션 실행 → doing task 의 spec_ref 를 최근 커밋과 경로 강매칭 →
+// 완료 후보 compact 1줄만 stdout 으로 낸다(hook 이 additionalContext 로 주입). transition 안 함(게이트 불변).
+
+const DAY_MS = 24 * 60 * 60 * 1000
+const MAX_COMMITS = 200
+const MAX_FILES_PER_COMMIT = 50
+// done-scan 은 SessionStart hook 안에서 돈다 — 네트워크 호출이 무한 대기하면 hook timeout(Codex 15s)을
+// 터뜨린다. tasks/context 조회를 짧게 바운드하고, 초과 시 best-effort 로 조용히 skip(완료감지는 부가기능).
+const NET_TIMEOUT_MS = 4000
+
+function markerPath(projectId) {
+  return join(homedir(), '.rookie', `done-scan-${projectId}.last`)
+}
+function readMarkerReal(projectId) {
+  try {
+    return JSON.parse(readFileSync(markerPath(projectId), 'utf8'))
+  } catch {
+    return null
+  }
+}
+function writeMarkerReal(projectId, obj) {
+  try {
+    writeFileSync(markerPath(projectId), JSON.stringify(obj))
+  } catch {
+    /* best-effort */
+  }
+}
+
+function gitHeadReal() {
+  return execSync('git rev-parse HEAD', { stdio: ['ignore', 'pipe', 'ignore'] })
+    .toString()
+    .trim()
+}
+
+// 최근 MAX_COMMITS 커밋을 {sha,subject,files[]} 로 파싱. --name-only, NUL 구분 record.
+function gitLogReal() {
+  // core.quotePath=false → non-ASCII(한글 등) 경로를 이스케이프 없이 그대로 출력(매칭 안정).
+  const raw = execSync(
+    `git -c core.quotePath=false log --max-count=${MAX_COMMITS} --name-only --pretty=format:%x1e%H%x1f%s`,
+    { stdio: ['ignore', 'pipe', 'ignore'], maxBuffer: 32 * 1024 * 1024 }
+  ).toString()
+  const commits = []
+  for (const rec of raw.split('\x1e')) {
+    if (!rec.trim()) continue
+    const nl = rec.indexOf('\n')
+    const header = nl === -1 ? rec : rec.slice(0, nl)
+    const body = nl === -1 ? '' : rec.slice(nl + 1)
+    const [sha, subject] = header.split('\x1f')
+    const files = body
+      .split('\n')
+      .map((s) => s.trim())
+      .filter(Boolean)
+      .slice(0, MAX_FILES_PER_COMMIT)
+    commits.push({ sha: (sha || '').trim(), subject: (subject || '').trim(), files })
+  }
+  return commits
+}
+
+function truncate(s, n) {
+  const v = String(s ?? '')
+  return v.length > n ? v.slice(0, n - 1) + '…' : v
+}
+
+export async function runDoneScan(flags = {}, deps = {}) {
+  const {
+    loadConfig: _loadConfig = loadConfig,
+    apiGet: _apiGet = apiGet,
+    gitHead = gitHeadReal,
+    gitLog = gitLogReal,
+    readMarker = readMarkerReal,
+    writeMarker = writeMarkerReal,
+    now = Date.now,
+    out = (line) => console.log(line),
+  } = deps
+
+  const cfg = _loadConfig()
+  if (!cfg) return
+
+  // project_id: hook 이 이미 fetch 한 context 에서 넘겨주면(--project-id) context 재fetch 생략
+  //   (이중 조회 방지 + throttle 을 네트워크 0 으로 선검사). 단독 실행(수동)이면 스스로 fetch.
+  let projectId = flags['project-id'] || flags.projectId
+  if (!projectId) {
+    const repoPath = process.cwd()
+    let repoUrl = ''
+    try {
+      repoUrl = execSync('git remote get-url origin', { stdio: ['ignore', 'pipe', 'ignore'] })
+        .toString()
+        .trim()
+    } catch {
+      /* git repo 아님/원격 없음 — repo_url 빈 값 */
+    }
+    let ctx
+    try {
+      const q = `repo_url=${encodeURIComponent(repoUrl)}&repo_path=${encodeURIComponent(repoPath)}`
+      ctx = await _apiGet(cfg.endpoint, cfg.token, `/api/rookie/context?${q}`, { timeoutMs: NET_TIMEOUT_MS })
+    } catch {
+      return
+    }
+    projectId = ctx && ctx.current_project && ctx.current_project.id
+  }
+  if (!projectId) return // 미link
+  const project = { id: projectId }
+
+  // git HEAD (repo 아니면 throw → skip)
+  let head
+  try {
+    head = gitHead()
+  } catch {
+    return
+  }
+
+  // throttle: 같은 head + 24h 이내면 skip. head 변경 시 우회, --force 무시.
+  const marker = readMarker(project.id)
+  const nowMs = now()
+  const throttled =
+    !flags.force &&
+    marker &&
+    marker.head === head &&
+    nowMs - (marker.ts || 0) < DAY_MS
+  if (throttled) return
+
+  // doing tasks
+  let tasks = []
+  try {
+    const r = await _apiGet(
+      cfg.endpoint,
+      cfg.token,
+      `/api/rookie/tasks?project_id=${encodeURIComponent(project.id)}&status=doing`,
+      { timeoutMs: NET_TIMEOUT_MS }
+    )
+    tasks = (r && r.tasks) || []
+  } catch {
+    return // 조회 실패 시 마커 미기록(다음 기회 재시도)
+  }
+
+  if (tasks.length > 0) {
+    let commits
+    try {
+      commits = gitLog()
+    } catch {
+      return
+    }
+    const candidates = matchDoneCandidates(tasks, commits)
+    for (const c of candidates) {
+      // task id 는 전체 UUID 로 출력 — 차차가 승인 후 PATCH /tasks {id} 에 그대로 쓴다(prefix 로는 PATCH 불가).
+      //   두목께는 title 만 노출하고 raw uuid 는 마스킹(§10e). sha 12자 = __done_defer:<sha> prefix 충돌 방지.
+      out(`🎯 ${c.taskId} "${truncate(c.taskTitle, 40)}" ← ${c.sha.slice(0, 12)} ${truncate(c.subject, 60)}`)
+    }
+  }
+
+  // 산출 성공 후 마커 기록(선-touch 후 crash 방지).
+  writeMarker(project.id, { ts: nowMs, head })
+}

package/src/commands/init.js

@@ -0,0 +1,175 @@
+import { homedir } from 'node:os'
+import { loadConfig, loadGlobalConfig, saveConfig, configPath, getHostname } from '../config.js'
+import { accountLine, accountWarning } from '../lib/account-ui.js'
+import { confirm, ask, askPassword } from '../prompt.js'
+import {
+  detectGlobalInstall,
+  detectLocalInstall,
+  deepScanForLocalInstalls,
+  detectInstalledTools,
+} from '../detect.js'
+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'
+
+async function pickChoice(prompt, options, autoValue) {
+  console.log(prompt)
+  const keys = Object.keys(options)
+  console.log(keys.map((k) => `[${k}]${options[k]}`).join(' '))
+  if (autoValue) return autoValue
+  const ans = (await ask('선택:')).toUpperCase()
+  if (keys.includes(ans)) return ans
+  console.log('잘못된 입력 — 취소.')
+  return 'C'
+}
+
+export async function runInit(flags) {
+  const scope = flags.local ? 'local' : 'global'
+  const globalExisting = detectGlobalInstall()
+  const localExisting = detectLocalInstall()
+
+  // 통일 연결(spec 2026-06-29 §4 item 4): 깔린 도구 감지 + 미설정 도구(early-return 우회 신호).
+  //  "Claude 있고 Codex 만 추가" 가 기존 early-return 으로 막히던 P2 결함을 pending 으로 해소.
+  const tools = detectInstalledTools()
+  // applyToolSetup 와 동일한 대화형 판정 — pending/실제 적용을 일치시킨다.
+  const interactive = !!process.stdin.isTTY && !flags.yes
+  const pending = pendingToolSetup({ tools, scope, interactive })
+
+  if (scope === 'global') {
+    if (globalExisting && !flags.force) {
+      if (pending.length > 0) {
+        // 미설정 도구가 있으면 skip 하지 않고 마저 설치(도구-추가 모드).
+        console.log(`글로벌 Skill v${globalExisting.version} 유지 — 미설정 도구 추가: ${pending.map((t) => toolName(t.id)).join(', ')}`)
+      } else {
+        // §18 — first-time install + PAT 발급 본업. templates 동기화는 `rookie update` 로 분기.
+        const choice = await pickChoice(
+          `글로벌 Skill v${globalExisting.version} 이미 설치됨. templates 동기화는 \`rookie update\` 권장.`,
+          { U: '강제 재설치 (--force 동급)', S: '스킵', C: '취소' },
+          flags.yes ? 'S' : null
+        )
+        if (choice === 'S') return
+        if (choice === 'C') process.exit(1)
+        // U 선택 = force 효과 (이하 분기 force 처럼 동작)
+      }
+    }
+    if (localExisting && !flags.force && !flags.yes) {
+      const go = await confirm(
+        `현재 폴더에 로컬 Skill(v${localExisting.version})이 있습니다. 로컬이 override합니다. 글로벌 설치 계속할까요?`,
+        { defaultYes: false }
+      )
+      if (!go) return
+    }
+  } else {
+    if (localExisting && !flags.force) {
+      if (pending.length > 0) {
+        console.log(`로컬 Skill v${localExisting.version} 유지 — 미설정 도구 추가: ${pending.map((t) => toolName(t.id)).join(', ')}`)
+      } else {
+        const choice = await pickChoice(
+          `로컬 Skill이 이미 v${localExisting.version} 설치됨.`,
+          { R: '재설치', S: '스킵', C: '취소' },
+          flags.yes ? 'R' : null
+        )
+        if (choice === 'S') return
+        if (choice === 'C') process.exit(1)
+      }
+    }
+    if (globalExisting && !flags.force && !flags.yes) {
+      const go = await confirm(
+        `글로벌 Skill(v${globalExisting.version})이 이미 있습니다. 로컬이 override합니다. 계속?`,
+        { defaultYes: false }
+      )
+      if (!go) return
+    }
+  }
+
+  const cfg = loadConfig()
+  if (cfg && !flags.force) {
+    try {
+      const { paths } = await apiGet(
+        cfg.endpoint,
+        cfg.token,
+        `/api/rookie/projects/local-paths?hostname=${encodeURIComponent(getHostname())}`
+      )
+      const suspicious = paths.filter((p) => p.install_scope === 'local' || p.install_scope === 'both')
+      if (suspicious.length > 0) {
+        console.log('⚠ DB 기반 스캔 — 이 Mac에 등록된 로컬 설치 경로:')
+        for (const p of suspicious) console.log(`   - ${p.local_path} (${p.install_scope})`)
+        if (!flags.yes) {
+          const ok = await confirm('계속 진행할까요?', { defaultYes: true })
+          if (!ok) return
+        }
+      }
+    } catch (e) {
+      console.log(`(DB 스캔 생략: ${e.message})`)
+    }
+  }
+
+  if (flags['deep-scan']) {
+    const found = deepScanForLocalInstalls([homedir()], 3)
+    if (found.length > 0) {
+      console.log('⚠ deep-scan — 홈 디렉토리에서 발견된 로컬 Skill:')
+      for (const f of found) console.log(`   - ${f.projectDir} (v${f.version})`)
+    }
+  }
+
+  // B6-1: bootstrap 은 전역 config 를 쓰고 저장하므로 판정도 전역 기준(로컬 config 가 있어도
+  // 전역 미설정이면 bootstrap 진행 — 로컬 binding 이 전역 판정을 가리지 않게).
+  let cfg2 = loadGlobalConfig()
+  // §18 U-4 — force/PAT 디커플링: --force 는 templates 재설치만 강제하고 PAT 재발급은 안 함.
+  // PAT 갱신은 `rookie token rotate` 단일 진입점.
+  const needsBootstrap = !cfg2 || !cfg2.user_id
+  if (needsBootstrap) {
+    // flag(--endpoint=)/env/config 가 있으면 프롬프트 생략, 없으면 ask(기본값 therookie.kr).
+    const preset =
+      (typeof flags.endpoint === 'string' ? flags.endpoint : undefined)
+      ?? process.env.ROOKIE_ENDPOINT
+      ?? cfg2?.endpoint
+    const endpoint = preset
+      ? resolveEndpoint({ flag: preset })
+      : await ask('Rookie 앱 엔드포인트', { defaultValue: 'https://therookie.kr' })
+    const email = await ask('이메일')
+    const password = await askPassword('비밀번호:')
+    const defaultLabel = `${getHostname()}`
+    const label = await ask('토큰 라벨 (메모)', { defaultValue: defaultLabel })
+    console.log('→ Supabase Auth 로그인 + PAT 발급...')
+    const issued = await apiPostNoAuth(endpoint, '/api/rookie/tokens/bootstrap', {
+      email,
+      password,
+      label,
+    })
+    cfg2 = {
+      endpoint,
+      token: issued.token,
+      user_id: issued.user_id,
+      label: issued.label,
+      hostname: getHostname(),
+    }
+    saveConfig(cfg2)
+    console.log(`✓ PAT 발급·저장: ${configPath()} (user=${issued.user_name}, token_id=${issued.id})`)
+
+    // B1-4 (spec 2026-07-11 §B1): 발급 직후 계정 요약 — 오-binding 을 init 시점에 바로 보이게.
+    try {
+      const st = await apiGet(endpoint, issued.token, '/api/rookie/status')
+      const line = accountLine(st?.account)
+      if (line) {
+        console.log(line)
+        const warn = accountWarning(st?.account)
+        if (warn) console.log(warn)
+        if (process.stdin.isTTY) console.log('이 계정이 맞습니까? 아니라면 rookie login 으로 다시 로그인하세요.')
+      }
+    } catch { /* fail-soft — 요약 없이 진행 */ }
+  }
+
+  // 통일 연결(spec §4 item 4): login 과 같은 오케스트레이터 재사용 — 중복 설치 코드 없음.
+  const detected = renderDetected(tools)
+  if (detected) console.log(detected)
+  const report = await applyToolSetup({
+    tools,
+    scope,
+    cfg: cfg2,
+    interactive,
+    confirmWeak: (t) => confirm(`${toolName(t.id)} 디렉토리만 감지됨(CLI 미확인). 연결할까요?`, { defaultYes: true }),
+  })
+  for (const line of renderConnectOutcome(report, tools)) console.log(line)
+}

package/src/commands/link.js

@@ -0,0 +1,53 @@
+import { execSync } from 'node:child_process'
+import { basename } from 'node:path'
+import { loadConfig, getHostname } from '../config.js'
+import { apiPost } from '../api.js'
+import { runInit } from './init.js'
+
+export async function runLink(flags) {
+  const cfg = loadConfig()
+  if (!cfg) {
+    console.error('✗ 먼저 `rookie init` 을 실행하세요.')
+    process.exit(1)
+  }
+
+  let repoUrl = null
+  try {
+    repoUrl = execSync('git remote get-url origin', { stdio: ['ignore', 'pipe', 'ignore'] })
+      .toString().trim()
+  } catch {}
+
+  const repoPath = process.cwd()
+  const name = basename(repoPath)
+  const hostname = getHostname()
+
+  const installScope = flags.local ? 'local' : 'global'
+
+  const res = await apiPost(
+    cfg.endpoint,
+    cfg.token,
+    '/api/rookie/project',
+    {
+      repo_path: repoPath,
+      hostname,
+      name,
+      repo_url: repoUrl || undefined,
+      install_scope: installScope,
+    },
+    // B5: acted 이벤트가 surface null 버킷으로 빠지지 않게 표면 라벨 명시 (codex P2).
+    { headers: { 'x-rookie-surface': 'local_cli' } }
+  )
+  console.log(`✓ 프로젝트 등록: ${name} (project_id=${res.project_id})`)
+
+  // spec 2026-07-14 W-D3 — 등록 전 이 폴더에 격리돼 있던 기억을 프로젝트로 승격(경로 raw 출력 금지).
+  const p = res.promoted
+  if (p) {
+    const n = (p.work_records ?? 0) + (p.evidence ?? 0)
+    if (n > 0) console.log(`↑ 이 폴더의 기존 기억 ${n}건을 프로젝트로 승격했습니다.`)
+    if (p.failed?.length) console.error(`⚠ 승격 실패: ${p.failed.join(', ')} — 재실행하면 이어서 승격됩니다.`)
+  }
+
+  if (flags.local) {
+    await runInit({ local: true, yes: flags.yes, force: flags.force })
+  }
+}

package/src/commands/login.js

@@ -0,0 +1,160 @@
+import { spawn } from 'node:child_process'
+import { existsSync, readFileSync, appendFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { loadConfig, loadGlobalConfig, saveConfig, configPath, localConfigPathFor, getHostname } from '../config.js'
+import { apiGet, apiPostNoAuth, apiPostNoAuthRaw } from '../api.js'
+import { interpretPoll } from '../lib/poll-state.js'
+import { detectInstalledTools } from '../detect.js'
+import { applyToolSetup } from '../lib/apply-tool-setup.js'
+import { renderDetected, renderConnectOutcome, toolName } from '../lib/connect-ui.js'
+import { confirm } from '../prompt.js'
+import { resolveEndpoint } from '../lib/resolve-endpoint.js'
+import { accountLine, accountWarning } from '../lib/account-ui.js'
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+
+// 브라우저 오픈 명령. Windows 의 start 는 cmd 내장이라 spawn('start') 가 실패하므로
+//  `cmd /c start "" <url>` 로 호출한다(첫 "" 는 start 의 title 인자 — URL 의 & 등 안전).
+export function browserOpenCommand(url, platform = process.platform) {
+  if (platform === 'darwin') return { cmd: 'open', args: [url] }
+  if (platform === 'win32') return { cmd: 'cmd', args: ['/c', 'start', '', url] }
+  return { cmd: 'xdg-open', args: [url] }
+}
+
+function tryOpenBrowser(url) {
+  const { cmd, args } = browserOpenCommand(url)
+  try { spawn(cmd, args, { stdio: 'ignore', detached: true }).unref() } catch { /* 무해 — URL·코드는 출력됨 */ }
+}
+
+// B1-4/B6-2 재료 — 계정 요약 조회 (fail-soft: 실패·구서버 시 null).
+async function fetchAccountSummary(endpoint, token) {
+  if (!endpoint || !token) return null
+  try {
+    const res = await apiGet(endpoint, token, '/api/rookie/status')
+    return res?.account ?? null
+  } catch {
+    return null
+  }
+}
+
+// B6-1: 로컬 .rookie/ (토큰 포함) 커밋 차단 — login --local 이 .gitignore 등록을 보장.
+function ensureGitignoreHasRookie(dir) {
+  const gi = join(dir, '.gitignore')
+  try {
+    const cur = existsSync(gi) ? readFileSync(gi, 'utf8') : ''
+    const lines = cur.split('\n').map((l) => l.trim())
+    if (lines.includes('.rookie/') || lines.includes('.rookie')) return
+    appendFileSync(gi, `${cur && !cur.endsWith('\n') ? '\n' : ''}.rookie/\n`)
+    console.log(`✓ .gitignore 에 .rookie/ 추가 (토큰 커밋 차단): ${gi}`)
+  } catch (e) {
+    console.warn(`⚠ .gitignore 갱신 실패: ${e.message} — .rookie/ 를 직접 등록하세요.`)
+  }
+}
+
+// B6-2 게이트 판정 (순수 — 테스트용 export): 전역 scope 에서 기존과 다른 계정으로 승인될 때만 true.
+// 같은 계정 재로그인(토큰 갱신)·최초 로그인(기존 user 없음)·--local 은 게이트 없음.
+export function needsAccountSwitchGate({ scope, existingUserId, issuedUserId }) {
+  return scope === 'global' && !!existingUserId && !!issuedUserId && existingUserId !== issuedUserId
+}
+
+function accountDisplay(account, fallback) {
+  if (account?.email_masked) {
+    return account.profile_name ? `${account.email_masked} (프로필 ${account.profile_name})` : account.email_masked
+  }
+  return account?.profile_name ?? fallback
+}
+
+export async function runLogin(flags) {
+  const scope = flags.local ? 'local' : 'global'
+  // B6-2: 전역 login 의 기존-계정 비교는 전역 config 기준(로컬 config 에 오염되면 게이트가 무력화).
+  const existing = scope === 'global' ? loadGlobalConfig() : loadConfig()
+  // 우선순위 flag(--endpoint=) > ROOKIE_ENDPOINT > 기존 config > therookie.kr.
+  // 어느 하나라도 해결되면 프롬프트 생략(install.sh 비대화 경로).
+  const endpoint = resolveEndpoint({
+    flag: typeof flags.endpoint === 'string' ? flags.endpoint : undefined,
+    env: process.env.ROOKIE_ENDPOINT,
+    config: existing?.endpoint,
+  })
+  const label = `${getHostname()}`
+
+  let start
+  try {
+    start = await apiPostNoAuth(endpoint, '/api/rookie/device/start', { label })
+  } catch (e) {
+    const msg = /\b429\b/.test(String(e?.message)) ? '요청이 잦습니다. 잠시 후 다시 시도하세요.' : `연결 시작 실패: ${e?.message ?? e}`
+    console.error(`\n✗ ${msg}`)
+    process.exit(1)
+  }
+  // 서버의 verification_uri 는 req origin 추측이라 localhost 로 떨어질 수 있다
+  // (macmini 등 원격 endpoint 에서 바인딩이 localhost). CLI 가 설정한 endpoint 로
+  // 직접 구성해야 두목이 실제로 열 수 있는 주소가 된다.
+  const verifyUri = `${endpoint.replace(/\/$/, '')}/device`
+  const verifyUriComplete = `${verifyUri}?code=${encodeURIComponent(start.user_code)}`
+  console.log(`\n  브라우저에서 다음 주소를 열고 코드를 입력하세요:`)
+  console.log(`    ${verifyUri}`)
+  console.log(`    코드: ${start.user_code}\n`)
+  tryOpenBrowser(verifyUriComplete)
+
+  let interval = start.interval ?? 5
+  const deadline = Date.now() + (start.expires_in ?? 600) * 1000
+  let issued = null
+  while (Date.now() < deadline) {
+    await sleep(interval * 1000)
+    const { body } = await apiPostNoAuthRaw(endpoint, '/api/rookie/device/token', { device_code: start.device_code })
+    const next = interpretPoll(body, interval)
+    interval = next.interval
+    if (next.action === 'done') { issued = next; break }
+    if (next.action === 'stop') { console.error(`\n✗ 코드 만료. 'rookie login' 을 다시 실행하세요.`); process.exit(1) }
+  }
+  if (!issued) { console.error(`\n✗ 시간 초과. 다시 시도하세요.`); process.exit(1) }
+
+  const cfg = { endpoint, token: issued.token, user_id: issued.user_id, label: issued.label ?? label, hostname: getHostname(), agent_name: issued.agent_name ?? null }
+
+  // B1-4: 새 토큰의 계정 요약 — 교체 게이트 표시와 종료 화면에 함께 쓴다.
+  const newAccount = await fetchAccountSummary(endpoint, issued.token)
+
+  // B6-2: 전역 계정 교체 확인 게이트. 같은 계정 재로그인(토큰 갱신)은 무확인 통과.
+  if (needsAccountSwitchGate({ scope, existingUserId: existing?.user_id, issuedUserId: issued.user_id })) {
+    const oldAccount = await fetchAccountSummary(existing.endpoint, existing.token)
+    const from = accountDisplay(oldAccount, existing.label ?? '기존 계정')
+    const to = accountDisplay(newAccount, issued.label ?? '새 계정')
+    console.log(`\n⚠️ 전역 계정을 교체합니다: ${from} → ${to}`)
+    console.log('   테스트 목적이면 rookie login --local (프로젝트 전용 binding) 을 권장합니다.')
+    let go = false
+    if (flags.yes) go = true
+    else if (process.stdin.isTTY) go = await confirm('계속할까요?', { defaultYes: false })
+    if (!go) {
+      console.error('✗ 중단 — 전역 config 는 변경되지 않았습니다. 방금 발급된 PAT 는 /dashboard/tokens 에서 revoke 하세요.')
+      process.exit(1)
+    }
+  }
+
+  // B6-1: --local 은 토큰도 프로젝트-로컬 config 에 저장한다(전역 무변경) + .gitignore 보장.
+  const savePath = scope === 'local' ? localConfigPathFor(process.cwd()) : undefined
+  saveConfig(cfg, savePath ? { path: savePath } : undefined)
+  if (scope === 'local') ensureGitignoreHasRookie(process.cwd())
+  console.log(`✓ PAT 저장: ${savePath ?? configPath()}`)
+
+  // B1-4: init/login 종료 화면 — 계정 요약 + 확인 질문(비대화형은 요약만).
+  const line = accountLine(newAccount)
+  if (line) {
+    console.log(line)
+    const warn = accountWarning(newAccount)
+    if (warn) console.log(warn)
+    if (process.stdin.isTTY) console.log('이 계정이 맞습니까? 아니라면 rookie login 으로 다시 로그인하세요.')
+  }
+
+  // 통일 연결(spec 2026-06-29 §4): 이 컴퓨터에 깔린 도구를 감지해 한 번에 설정.
+  //  TTY 면 대화형(weak 신호 확인 경유), install.sh 비대화 경로면 strong 만 자동.
+  const tools = detectInstalledTools()
+  const detected = renderDetected(tools)
+  if (detected) console.log(detected)
+  const report = await applyToolSetup({
+    tools,
+    scope,
+    cfg,
+    interactive: !!process.stdin.isTTY,
+    confirmWeak: (t) => confirm(`${toolName(t.id)} 디렉토리만 감지됨(CLI 미확인). 연결할까요?`, { defaultYes: true }),
+  })
+  for (const line of renderConnectOutcome(report, tools, cfg.agent_name)) console.log(line)
+}

package/src/commands/orphan-extract.js

@@ -0,0 +1,44 @@
+// B3 (spec 2026-07-11-memory-reliability-fix-design §B3) — orphan tail 추출 준비 명령.
+// pending-extraction 큐를 오래된 순으로 읽어 rule-base 초안을 stdout 으로 뽑는다.
+// 저장 판단·batch-mutate 호출·완료 marker 는 세션 LLM(차차)/사용자 몫 — 이 명령은 marker 를 건드리지 않는다.
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
+import { homedir } from 'node:os'
+import { listPendingExtractions, buildDraft, renderDraft, markerCommand } from '../lib/orphan-extract-core.js'
+import { parseClaudeMessages, parseCodexMessages } from '../lib/sweep-core.mjs'
+import { hashId8 } from '../lib/redact-lite.js'
+
+const DEFAULT_BATCH = 5
+
+export async function runOrphanExtract(flags = {}) {
+  // parseFlags 는 `--batch 5`(공백 구분)를 batch=true + positional 로 떨어뜨린다 — 둘 다 수용.
+  const raw = flags.batch === true ? flags.positional?.[0] : flags.batch
+  const n = Number(raw)
+  const batch = Number.isFinite(n) && n > 0 ? Math.floor(n) : DEFAULT_BATCH
+  const orphanRoot = process.env.ROOKIE_ORPHAN_DIR || join(homedir(), '.rookie', 'orphan-recovery')
+
+  const all = listPendingExtractions({ orphanRoot })
+  if (all.length === 0) {
+    console.log('orphan pending: clean — 추출 대기 세션이 없습니다.')
+    return
+  }
+
+  const picked = all.slice(0, batch)
+  console.log(`== Orphan tail 추출 초안 — ${picked.length}건 (대기 ${all.length}건, 오래된 순) ==`)
+  for (const entry of picked) {
+    if (!entry.transcriptPath || !existsSync(entry.transcriptPath)) {
+      // transcript 소실 — marker 는 그대로 두면 영구 재노출되므로 안내만 (정리는 사용자/차차 판단).
+      console.log(`◦ [${entry.runtime}] 세션 ${hashId8(entry.sid)} — transcript 소실. 저장할 원문이 없습니다.`)
+      console.log(`  → 큐에서 비우려면: ${markerCommand(entry)}`)
+      continue
+    }
+    const messages = entry.runtime === 'codex'
+      ? parseCodexMessages(entry.transcriptPath)
+      : parseClaudeMessages(entry.transcriptPath)
+    for (const line of renderDraft(entry, buildDraft(messages))) console.log(line)
+  }
+  const rest = all.length - picked.length
+  console.log('')
+  console.log(`저장 가치 있는 항목만 batch-mutate 로 저장한 뒤, 세션마다 완료 marker 를 남기세요 (저장할 게 없어도).`)
+  if (rest > 0) console.log(`남은 대기: ${rest}건 — rookie orphan-extract --batch ${batch} 재실행.`)
+}