therookie 0.4.3

package/src/commands/save.js

@@ -0,0 +1,91 @@
+// spec docs/superpowers/specs/2026-07-14-workspace-binding-and-unlinked-isolation.md W-D1
+//
+// `rookie save` — 저장 요청의 **워크스페이스 식별자를 기계가 주입한다**.
+// 차차(LLM)가 curl 본문에 repo 정보를 손으로 붙이던 구조가 누수의 근원이었다(실측: evidence 51% 전역).
+// CLI 프로세스는 자기 cwd 를 안다 — 잊을 수가 없다.
+//
+// 사용:
+//   rookie save --file body.json
+//   echo '<json>' | rookie save
+// 플래그: --repo-path/--repo-url (의도적 override 전용), --quiet
+
+import { execFileSync } from 'node:child_process'
+import { readFileSync } from 'node:fs'
+import { loadConfig, getHostname } from '../config.js'
+import { apiPost } from '../api.js'
+
+function readStdin() {
+  // TTY 면 파이프가 없다 — EOF 까지 무한 대기하지 않도록 즉시 빈 값으로 빠진다.
+  if (process.stdin.isTTY) return ''
+  try {
+    return readFileSync(0, 'utf8')
+  } catch {
+    return ''
+  }
+}
+
+export async function runSave(flags) {
+  const cfg = loadConfig()
+  if (!cfg) {
+    console.error('✗ 먼저 `rookie init` 을 실행하세요.')
+    process.exit(1)
+  }
+
+  const raw = flags.file ? readFileSync(flags.file, 'utf8') : readStdin()
+  if (!raw.trim()) {
+    console.error('✗ 저장할 본문이 없습니다 — `--file <body.json>` 또는 stdin 으로 주세요.')
+    process.exit(1)
+  }
+
+  let body
+  try {
+    body = JSON.parse(raw)
+  } catch (err) {
+    console.error(`✗ JSON 파싱 실패: ${err.message}`)
+    process.exit(1)
+  }
+
+  const repoPath = flags['repo-path'] || process.cwd()
+  let repoUrl = flags['repo-url'] || null
+  if (!repoUrl) {
+    try {
+      // execFileSync — shell 을 거치지 않는다. 경로에 $()·백틱이 있어도 실행되지 않는다.
+      repoUrl = execFileSync('git', ['-C', repoPath, 'remote', 'get-url', 'origin'], {
+        stdio: ['ignore', 'pipe', 'ignore'],
+      })
+        .toString()
+        .trim()
+    } catch {
+      repoUrl = null // remote 없는 로컬 전용 repo — repo_path 로 매칭한다.
+    }
+  }
+
+  // 워크스페이스 locator 는 **CLI 가 덮어쓴다**. 본문 값을 존중하면 차차가 복붙한 stale locator 가
+  // 다시 통과해, 이 명령이 없애려는 바로 그 의존이 살아난다(설계 R1-judgment).
+  // project_id(명시 귀속·명시 전역)는 locator 가 아니라 의사 표시이므로 건드리지 않는다.
+  body.repo_path = repoPath
+  if (repoUrl) body.repo_url = repoUrl
+  else delete body.repo_url
+
+  const res = await apiPost(cfg.endpoint, cfg.token, '/api/rookie/batch-mutate', body, {
+    headers: {
+      'x-rookie-hostname': getHostname(),
+      'x-rookie-surface': 'local_cli',
+    },
+  })
+
+  if (flags.quiet) return
+  const s = res.summary ?? {}
+  const parts = []
+  if (s.working_cards?.ids?.length) parts.push(`카드 ${s.working_cards.ids.length}`)
+  if (s.evidence?.applied) parts.push(`증거 ${s.evidence.applied}`)
+  if (s.self_rules?.applied) parts.push(`자기규칙 ${s.self_rules.applied}`)
+  if (s.verifications?.applied) parts.push(`검증 ${s.verifications.applied}`)
+  const label = parts.length > 0 ? parts.join(' · ') : '0건'
+
+  if (res.all_committed === false) {
+    console.error(`⚠ 일부 미저장 — ${label}`)
+    process.exit(1)
+  }
+  console.log(`✓ 저장: ${label}`)
+}

package/src/commands/scan-specs.js

@@ -0,0 +1,153 @@
+import { execSync } from 'node:child_process'
+import { readFileSync, statSync, readdirSync, writeFileSync, realpathSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join, isAbsolute, relative, sep } from 'node:path'
+import { loadConfig } from '../config.js'
+import { apiGet, apiPost } from '../api.js'
+import { parseFollowups } from '../lib/spec-scanner.js'
+
+const THROTTLE_MS = 24 * 60 * 60 * 1000
+
+function markerPath(projectId) {
+  return join(homedir(), '.rookie', `spec-scan-${projectId}.last`)
+}
+function throttled(projectId) {
+  try {
+    return Date.now() - statSync(markerPath(projectId)).mtimeMs < THROTTLE_MS
+  } catch {
+    return false
+  }
+}
+function touchMarker(projectId) {
+  try {
+    writeFileSync(markerPath(projectId), String(Date.now()))
+  } catch {
+    /* best-effort */
+  }
+}
+// repo 경계 가드 (codex P1): realpath 가 repoReal 내부인 경로만 허용.
+// 절대경로·`../`·symlink 로 repo 밖 .md 를 서버로 유출하는 것을 차단(§10 민감정보 원칙).
+function insideRepo(p, repoReal) {
+  try {
+    const real = realpathSync(p)
+    return real === repoReal || real.startsWith(repoReal + sep)
+  } catch {
+    return false
+  }
+}
+function walk(p, out, repoReal) {
+  let st
+  try {
+    st = statSync(p)
+  } catch {
+    return
+  }
+  if (st.isDirectory()) {
+    for (const e of readdirSync(p)) walk(join(p, e), out, repoReal)
+  } else if (/\.md$/.test(p) && insideRepo(p, repoReal)) {
+    out.add(p)
+  }
+}
+// spec_doc_paths(glob/디렉토리) → 실제 .md 파일 목록. 의존성 0 재귀 walk. repo 내부만.
+function expandSpecFiles(repoPath, patterns) {
+  const out = new Set()
+  let repoReal
+  try {
+    repoReal = realpathSync(repoPath)
+  } catch {
+    return []
+  }
+  for (const pat of patterns || []) {
+    const abs = isAbsolute(pat) ? pat : join(repoPath, pat)
+    const base = abs.replace(/\/\*\*.*$/, '').replace(/\/\*.*$/, '')
+    // base 자체가 repo 밖이면 walk 안 함(realpath 기준). 안쪽이면 walk 중 파일별로 한 번 더 검증.
+    if (!insideRepo(base, repoReal)) continue
+    walk(base, out, repoReal)
+  }
+  return [...out]
+}
+
+export async function runScanSpecs(flags) {
+  const cfg = loadConfig()
+  if (!cfg) {
+    console.error('✗ 먼저 `rookie init` 을 실행하세요.')
+    process.exit(1)
+  }
+  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 빈 값 */
+  }
+
+  // 1) current_project.id
+  const q = `repo_url=${encodeURIComponent(repoUrl)}&repo_path=${encodeURIComponent(repoPath)}`
+  let ctx
+  try {
+    ctx = await apiGet(cfg.endpoint, cfg.token, `/api/rookie/context?${q}`)
+  } catch (e) {
+    console.error(`✗ context 조회 실패: ${e.message}`)
+    return
+  }
+  const project = ctx && ctx.current_project
+  if (!project || !project.id) {
+    console.log('이 프로젝트는 미link — scan 생략')
+    return
+  }
+
+  // 2) throttle (세션 자동: 하루 1회). --force 무시.
+  if (!flags.force && throttled(project.id)) return
+
+  // 3) spec_doc_paths
+  let paths = []
+  try {
+    const sr = await apiGet(
+      cfg.endpoint,
+      cfg.token,
+      `/api/rookie/projects/spec-source?project_id=${encodeURIComponent(project.id)}`
+    )
+    paths = (sr && sr.spec_doc_paths) || []
+  } catch {
+    /* 미설정이면 빈 배열 */
+  }
+  if (!paths.length) {
+    console.log('spec_doc_paths 없음 — scan 생략')
+    touchMarker(project.id)
+    return
+  }
+
+  // 4) 로컬 파싱 → active candidates (deferred 는 기본 제외)
+  const files = expandSpecFiles(repoPath, paths)
+  const candidates = []
+  for (const f of files) {
+    const rel = relative(repoPath, f)
+    let md
+    try {
+      md = readFileSync(f, 'utf8')
+    } catch {
+      continue
+    }
+    for (const c of parseFollowups(rel, md)) {
+      if (c.klass === 'active') candidates.push(c)
+    }
+  }
+
+  // 5) 전송
+  try {
+    const r = await apiPost(cfg.endpoint, cfg.token, '/api/rookie/spec-followups/scan', {
+      project_id: project.id,
+      candidates,
+    })
+    touchMarker(project.id)
+    if (r && r.ok) {
+      console.log(
+        `[scan-specs] 후속 후보 ${candidates.length} 전송 — created ${r.created}, bumped ${r.bumped}, updated ${r.updated}, dup ${r.existing_task_dup ?? 0}, stale ${r.stale_swept}`
+      )
+    }
+  } catch (e) {
+    console.error(`✗ scan 전송 실패: ${e.message}`)
+  }
+}

package/src/commands/status.js

@@ -0,0 +1,44 @@
+import { existsSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { execSync } from 'node:child_process'
+import { resolveConfig, getHostname } from '../config.js'
+import { apiGet } from '../api.js'
+import { accountLine, accountWarning } from '../lib/account-ui.js'
+
+export async function runStatus() {
+  console.log('== Rookie Status ==')
+  console.log(`hostname: ${getHostname()}`)
+  // B6-1: env > 로컬(상향 탐색) > 전역 해석 결과를 스코프와 함께 표시.
+  const resolved = resolveConfig()
+  const cfgLabel = resolved.scope === 'env' ? '(env 주입)' : resolved.path
+  console.log(`config: ${cfgLabel} ${resolved.config ? `✓ [${resolved.scope}]` : '(없음)'}`)
+
+  const cfg = resolved.config
+  // B1-2 (spec 2026-07-11 §B1): 계정 요약 1줄을 최상단 근처에 — "누구의 기억인가" 상시 노출.
+  if (cfg) {
+    try {
+      const res = await apiGet(cfg.endpoint, cfg.token, '/api/rookie/status')
+      const line = accountLine(res?.account)
+      if (line) console.log(line)
+      const warn = accountWarning(res?.account)
+      if (warn) console.log(warn)
+      console.log(`앱: ${res.version} / owner=${res.owner?.name ?? 'none'}`)
+    } catch (e) {
+      console.log(`앱: ✗ ${e.message}`)
+    }
+  }
+
+  const globalSkill = join(homedir(), '.claude', 'skills', 'rookie', 'SKILL.md')
+  const localSkill = join(process.cwd(), '.claude', 'skills', 'rookie', 'SKILL.md')
+  console.log(`글로벌 Skill: ${existsSync(globalSkill) ? '✓' : '✗'} ${globalSkill}`)
+  console.log(`로컬 Skill:   ${existsSync(localSkill) ? '✓' : '✗'} ${localSkill}`)
+
+  let repoUrl = null
+  try {
+    repoUrl = execSync('git remote get-url origin', { stdio: ['ignore', 'pipe', 'ignore'] })
+      .toString().trim()
+  } catch {}
+  console.log(`현재 폴더: ${process.cwd()}`)
+  console.log(`repo_url: ${repoUrl ?? '(none)'}`)
+}

package/src/commands/sweep-recovery.js

@@ -0,0 +1,33 @@
+import { sweepAll as _sweepAll, sweepDueToday as _sweepDueToday, markSweptToday as _markSweptToday } from '../lib/sweep-core.mjs'
+import { resolveConfig as _resolveConfig } from '../config.js'
+
+const defaultDeps = {
+  sweepAll: _sweepAll,
+  sweepDueToday: _sweepDueToday,
+  markSweptToday: _markSweptToday,
+  resolveConfig: _resolveConfig,
+}
+
+export async function runSweepRecovery(flags = {}, deps = defaultDeps) {
+  const resolved = deps.resolveConfig()
+  const cfg = resolved.config
+  if (!cfg || !cfg.endpoint || !cfg.token) return
+
+  if (!flags.force && !deps.sweepDueToday({})) return
+
+  try {
+    // B6-4 (spec 2026-07-11 §B6): 실행 config 경로를 partition 기준으로 전달 — 후보 transcript
+    // 의 cwd 가 다른 config(로컬 .rookie/) 소속이면 sweep-core 가 skip. env 주입은 'env'
+    // (파일 config 와 절대 일치하지 않아 전 후보 skip — 판별 불가 시 보수적 보류).
+    const res = await deps.sweepAll({
+      endpoint: cfg.endpoint,
+      token: cfg.token,
+      userId: cfg.user_id || '',
+      opts: { activeConfigPath: resolved.path ?? 'env' },
+    })
+    deps.markSweptToday({})
+    console.log(`[sweep] 복구 ${res.total}건 (Claude ${res.claude} / Codex ${res.codex})`)
+  } catch {
+    // opportunistic sweep: 실패는 조용히 무시(다음 기회에 marker 기반 재시도)
+  }
+}

package/src/commands/token.js

@@ -0,0 +1,105 @@
+import { resolveConfig, saveConfig, configPath, getHostname } from '../config.js'
+import { apiGet, apiPost, apiPostNoAuth } from '../api.js'
+import { ask, askPassword } from '../prompt.js'
+
+function requireResolvedConfig() {
+  const resolved = resolveConfig()
+  if (!resolved.config || !resolved.config.endpoint || !resolved.config.token) {
+    console.error(`config 없음 — 먼저 'rookie init'을 실행하세요. (${configPath()})`)
+    process.exit(2)
+  }
+  return resolved
+}
+
+function requireConfig() {
+  return requireResolvedConfig().config
+}
+
+function fmtDate(s) {
+  if (!s) return '-'
+  try { return new Date(s).toISOString().replace('T', ' ').slice(0, 19) } catch { return s }
+}
+
+export async function runTokenList() {
+  const cfg = requireConfig()
+  const { tokens } = await apiGet(cfg.endpoint, cfg.token, '/api/rookie/tokens')
+  if (!tokens.length) {
+    console.log('(발급된 토큰 없음)')
+    return
+  }
+  const header = ['id', 'label', 'created', 'last_used', 'revoked']
+  console.log(header.join('\t'))
+  for (const t of tokens) {
+    console.log([
+      t.id,
+      t.label ?? '-',
+      fmtDate(t.created_at),
+      fmtDate(t.last_used_at),
+      t.revoked_at ? fmtDate(t.revoked_at) : '-',
+    ].join('\t'))
+  }
+}
+
+export async function runTokenRevoke(flags) {
+  const cfg = requireConfig()
+  const id = flags.positional[0]
+  if (!id) {
+    console.error('사용법: rookie token revoke <id>')
+    process.exit(2)
+  }
+  await apiPost(cfg.endpoint, cfg.token, '/api/rookie/tokens/revoke', { id })
+  console.log(`✓ revoked: ${id}`)
+}
+
+// rotate: 새 PAT 발급(비밀번호 필요) → 기존 config 토큰은 별도 revoke.
+export async function runTokenRotate() {
+  const resolved = requireResolvedConfig()
+  const cfg = resolved.config
+  const email = await ask('이메일')
+  const password = await askPassword('비밀번호:')
+  const label = await ask('새 토큰 라벨', { defaultValue: `${getHostname()}-rotated` })
+  const issued = await apiPostNoAuth(cfg.endpoint, '/api/rookie/tokens/bootstrap', {
+    email,
+    password,
+    label,
+  })
+  const oldToken = cfg.token
+  const next = { ...cfg, token: issued.token, user_id: issued.user_id, label: issued.label }
+  // B6-1: rotate 는 로드된 그 config 파일에 되쓴다 — 로컬 config 를 쓰던 디렉토리에서 rotate 가
+  // 전역을 덮어쓰지 않게. env 주입 세션(파일 없음)은 저장 불가 — 안내만.
+  if (resolved.path) {
+    saveConfig(next, { path: resolved.path })
+    console.log(`✓ 새 PAT 저장 (token_id=${issued.id}, ${resolved.scope === 'local' ? `로컬 ${resolved.path}` : '전역'})`)
+  } else {
+    console.log(`⚠ env(ROOKIE_TOKEN) 주입 세션 — 새 PAT 를 파일에 저장하지 않았습니다 (token_id=${issued.id}). 필요 시 rookie login 으로 저장하세요.`)
+  }
+  // 기존 PAT도 revoke — 새 PAT로 self-list 해서 자기 id 찾아야 하지만 bootstrap 응답엔 이전 토큰 id가 없다.
+  // self-list로 old token_id 찾아 revoke.
+  try {
+    const { tokens } = await apiGet(next.endpoint, next.token, '/api/rookie/tokens')
+    const oldHashPrefix = null // 평문 비교 불가 (서버는 해시만 저장).
+    // label/last_used 기준으로도 명확 식별 어렵다 → 방금 발급된 신규 토큰 외 모든 active 토큰을 revoke 할지 사용자 결정.
+    const activeOthers = tokens.filter((t) => !t.revoked_at && t.id !== issued.id)
+    if (activeOthers.length > 0) {
+      console.log(`남아 있는 활성 토큰 ${activeOthers.length}개:`)
+      for (const t of activeOthers) console.log(`  - ${t.id} (${t.label ?? '-'}, created=${fmtDate(t.created_at)})`)
+      console.log('→ 기존 토큰 정리는 `rookie token revoke <id>`로 수동 실행.')
+    }
+    void oldToken; void oldHashPrefix
+  } catch (err) {
+    console.warn(`(self-list 실패: ${err.message})`)
+  }
+}
+
+export async function runToken(flags) {
+  const sub = flags.positional[0]
+  const rest = { ...flags, positional: flags.positional.slice(1) }
+  switch (sub) {
+    case 'list': return runTokenList()
+    case 'revoke': return runTokenRevoke(rest)
+    case 'rotate': return runTokenRotate()
+    default:
+      console.error('사용법: rookie token <list|revoke|rotate>')
+      process.exit(2)
+  }
+}

package/src/commands/unlink.js

@@ -0,0 +1,40 @@
+import { rmSync, existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { isRookieEntry } from '../lib/merge-hooks.js'
+
+export async function runUnlink(flags) {
+  const scope = flags.local ? 'local' : flags.global ? 'global' : null
+  if (!scope) {
+    console.error('--local 또는 --global 중 하나를 지정하세요.')
+    process.exit(2)
+  }
+
+  const base = scope === 'global' ? join(homedir(), '.claude') : join(process.cwd(), '.claude')
+  const skillDir = join(base, 'skills', 'rookie')
+  if (existsSync(skillDir)) {
+    rmSync(skillDir, { recursive: true, force: true })
+    console.log(`✓ 삭제: ${skillDir}`)
+  } else {
+    console.log(`(없음) ${skillDir}`)
+  }
+
+  const settingsPath = join(base, 'settings.json')
+  if (existsSync(settingsPath)) {
+    try {
+      const current = JSON.parse(readFileSync(settingsPath, 'utf8'))
+      if (current.hooks) {
+        for (const ev of Object.keys(current.hooks)) {
+          // spec 2026-07-10 — Claude Code 가 __rookie_managed 마커를 제거할 수 있어
+          // 경로 서명 판정(isRookieEntry)으로 제거. 마커 소실 항목도 정리된다.
+          current.hooks[ev] = current.hooks[ev].filter((entry) => !isRookieEntry(entry))
+          if (current.hooks[ev].length === 0) delete current.hooks[ev]
+        }
+      }
+      writeFileSync(settingsPath, JSON.stringify(current, null, 2))
+      console.log(`✓ settings.json에서 rookie hook 제거: ${settingsPath}`)
+    } catch (e) {
+      console.warn(`settings.json 처리 실패: ${e.message}`)
+    }
+  }
+}