therookie 0.4.28 → 0.4.29

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "therookie",
-  "version": "0.4.28",
+  "version": "0.4.29",
   "description": "the Rookie — the AI new hire that remembers what you teach it. A CLI that connects a personal AI memory to AI tools like Claude and Codex.",
   "license": "MIT",
   "keywords": [

package/src/commands/doctor.js

@@ -424,8 +424,12 @@ function printOrphanPending() {
   }
   const expiredCount =
     countDirEntries(join(root, 'expired')) + countDirEntries(join(root, 'codex', 'expired'))
+  // spec 2026-09-08 §2.4 — 사유별로 나눠 센다. 저장 0건이 쌓이는 것과 비정상 종료가 쌓이는 것은
+  //  원인도 조치도 다르다. 한 숫자로 뭉치면 진짜 복구 대기가 묻힌다.
+  const allMarkers = [...claude.markers, ...codex.markers]
+  const noWrites = allMarkers.filter((m) => m?.reason === 'no_writes').length
   const s = summarizeOrphanBacklog({
-    pendingMarkers: [...claude.markers, ...codex.markers],
+    pendingMarkers: allMarkers,
     expiredCount,
     nowMs: Date.now(),
   })
@@ -444,6 +448,9 @@ function printOrphanPending() {
       )
     }
   }
+  if (noWrites > 0) {
+    console.log(`— 저장 0건 세션: ${noWrites}건 대기 — 그 세션의 결정·사실이 아직 어디에도 없습니다. rookie orphan-extract 로 확인하세요.`)
+  }
   if (s.expiredCount > 0) {
     console.log(`— orphan expired(손실): 누적 ${s.expiredCount}건 — TTL 초과로 tail 미추출 상태로 만료된 세션`)
   }

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 { recordSessionWrite } from '../lib/session-write-marker.js'
 
 // 저장된 층을 **빠짐없이** 화면에 센다. 여기 없는 층은 서버가 저장해도 0건처럼 보인다 —
 // 2026-09-02 저장에서 durable fact 3건이 그렇게 안 보였고, metric·recall 로 따로 확인해야
@@ -116,6 +117,12 @@ export async function runSave(flags) {
     throw err
   }
 
+  // spec 2026-09-08 §2.4 — 이 세션에 저장이 있었다는 로컬 마커. Stop hook 이 없으면 미추출 큐에 넣는다.
+  //  --session 미전달이면 아무것도 안 한다(기존 호출자 호환).
+  if (res.all_committed !== false) {
+    recordSessionWrite(typeof flags.session === 'string' ? flags.session : '')
+  }
+
   if (flags.json) {
     // 서버 raw 응답 그대로 — 재가공 없음. SKILL 은 summary.working_cards.ids[0]·superseded_count 를 읽는다.
     console.log(JSON.stringify(res))

package/src/lib/orphan-extract-core.js

@@ -32,6 +32,9 @@ export function listPendingExtractions({ orphanRoot }) {
           sid,
           runtime,
           transcriptPath: m.transcript_path || '',
+          // spec 2026-09-08 §2.4 — 'no_writes'(저장 0건) 와 비정상 종료를 구분해 표시한다.
+          //  섞이면 진짜 복구 대기가 묻힌다.
+          reason: m.reason || 'crash',
           recoveredAt: m.recovered_at || null,
           // codex marker 는 codex 서브루트에 산다 — marker 명령이 이 루트를 겨냥해야
           // 큐에서 실제로 빠진다(코드검토 P2). orphan-recovery.sh 의 ROOKIE_ORPHAN_DIR 규약.
@@ -101,7 +104,11 @@ export function buildDraft(messages, { userMax = 300, assistantMax = 400, pathCa
 export function renderDraft(entry, draft) {
   const lines = []
   const clean = (s) => redactDraftText(s).redacted.replace(/\s+/g, ' ').trim()
-  lines.push(`◦ [${entry.runtime}] 세션 ${hashId8(entry.sid)} (recovered ${entry.recoveredAt ?? 'unknown'})`)
+  // spec 2026-09-08 §2.4 — 사유를 앞에 붙인다. 저장 0건과 비정상 종료는 봐야 할 것이 다르다.
+  const why = entry.reason === 'no_writes' ? '저장 0건' : '비정상 종료'
+  lines.push(
+    `◦ [${entry.runtime}] 세션 ${hashId8(entry.sid)} · ${why} (recovered ${entry.recoveredAt ?? 'unknown'})`
+  )
   if (draft.lastUser) lines.push(`  마지막 user: ${clean(draft.lastUser)}`)
   if (draft.lastAssistant) lines.push(`  마지막 assistant: ${clean(draft.lastAssistant)}`)
   if (draft.filePaths.length) lines.push(`  파일 경로: ${draft.filePaths.map((p) => clean(p)).join(' · ')}`)

package/src/lib/session-write-marker.js

@@ -0,0 +1,57 @@
+// spec 2026-09-08-session-continuity-two-gaps.md §2.4 — 저장 0건 세션 감지용 로컬 마커.
+//
+// 서버는 그 세션에 저장이 있었는지 모른다 — `rookie save` 가 세션 식별자를 보내지 않아
+// batch-mutate 를 세션에 귀속시킬 수 없다. 로컬에서 아는 편이 싸고 정확하다.
+//
+// 키에 epoch 를 넣는 이유: session_id 는 /clear·compact 후에도 같은 값이다(그래서 recall-push 가
+// 구간 경계를 skill-gate 의 .epoch 로 따로 감지한다). 세션 단위 키만 쓰면 clear 이전 구간에
+// 저장이 있었다는 이유로 이후 구간이 통째로 면제된다.
+import { createHash } from 'node:crypto'
+import { mkdirSync, writeFileSync, existsSync, readFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { homedir } from 'node:os'
+
+export function markerDir() {
+  return process.env.ROOKIE_SESSION_WRITES_DIR || join(homedir(), '.rookie', 'session-writes')
+}
+
+function gateDir() {
+  return process.env.ROOKIE_SKILL_GATE_DIR || join(homedir(), '.rookie', 'skill-gate')
+}
+
+/** 세션의 현재 구간 epoch. 파일이 없으면 빈 문자열(현행 recall-push 관행과 동일). */
+export function readEpoch(sessionId) {
+  if (!sessionId) return ''
+  try {
+    const key = createHash('sha256').update(sessionId).digest('hex')
+    return String(readFileSync(join(gateDir(), key + '.epoch'), 'utf8')).trim()
+  } catch {
+    return ''
+  }
+}
+
+export function markerKey(sessionId, epoch) {
+  return createHash('sha256').update(`${sessionId}:${epoch}`).digest('hex')
+}
+
+/** 저장 성공 기록. sessionId 미전달이면 조용히 넘어간다(기존 호출자 호환). */
+export function recordSessionWrite(sessionId) {
+  if (!sessionId) return false
+  try {
+    const dir = markerDir()
+    mkdirSync(dir, { recursive: true, mode: 0o700 })
+    writeFileSync(join(dir, markerKey(sessionId, readEpoch(sessionId))), '', { mode: 0o600 })
+    return true
+  } catch {
+    return false // 마커 실패가 저장을 되돌리지는 않는다
+  }
+}
+
+export function hasSessionWrite(sessionId, epoch) {
+  if (!sessionId) return true // 판정 불가 — 큐에 넣지 않는다(오탐보다 무동작이 안전)
+  try {
+    return existsSync(join(markerDir(), markerKey(sessionId, epoch ?? readEpoch(sessionId))))
+  } catch {
+    return true
+  }
+}

package/templates/hook/flush-session.sh

@@ -301,6 +301,14 @@ if [ "$HTTP_CODE" = "200" ]; then
   if command -v orphan_mark_flushed >/dev/null 2>&1 && [ "${MESSAGE_COUNT:-0}" -gt 0 ] 2>/dev/null; then
     orphan_mark_flushed "$SESSION_ID" "stop" "$MESSAGE_COUNT" || true
   fi
+  # spec 2026-09-08 §2.4 — 이 세션 구간에 `rookie save` 성공이 한 번도 없었으면 결정·사실이
+  # 어디에도 남지 않는다. transcript 는 있으므로 다음 세션이 건지도록 미추출 큐에 올린다.
+  # 내용 없는 세션(MESSAGE_COUNT=0)은 제외 — 건질 게 없다.
+  if command -v orphan_session_had_write >/dev/null 2>&1 \
+    && [ "${MESSAGE_COUNT:-0}" -gt 0 ] 2>/dev/null \
+    && ! orphan_session_had_write "$SESSION_ID"; then
+    orphan_mark_no_writes "$SESSION_ID" "$TRANSCRIPT_PATH" || true
+  fi
 else
   # §17 H-2: 큐 적재 + 1회 chain drain (일시적 깜빡임 회복)
   if command -v queue_enqueue >/dev/null 2>&1; then

package/templates/hook/lib/orphan-recovery.sh

@@ -84,6 +84,48 @@ orphan_mark_baseline() {
     "$(printf '{"status":"baseline_skipped","reason":"%s"}' "$reason")"
 }
 
+# spec 2026-09-08-session-continuity-two-gaps.md §2.4 — 저장 0건 세션을 미추출 큐에 넣는다.
+#
+# 세션 안에서 `rookie save` 가 한 번도 성공하지 않았으면 그 세션의 결정·사실은 어디에도 없다.
+# transcript 는 남아 있으므로 다음 세션이 orphan-extract 로 건질 수 있게 큐에 올린다.
+#
+# 마커 키에 epoch 를 넣는 이유: session_id 는 /clear·compact 후에도 같은 값이라(그래서 recall-push 가
+# 구간 경계를 .epoch 로 따로 본다), 세션 단위 키만 쓰면 clear 이전 구간의 저장이 이후 구간을 면제한다.
+_orphan_session_write_key() {
+  local sid="$1" gate_dir epoch
+  gate_dir="${ROOKIE_SKILL_GATE_DIR:-$HOME/.rookie/skill-gate}"
+  local sid_hash
+  sid_hash="$(printf '%s' "$sid" | shasum -a 256 2>/dev/null | cut -d" " -f1)"
+  epoch="$(cat "$gate_dir/$sid_hash.epoch" 2>/dev/null | tr -d "[:space:]")"
+  printf '%s:%s' "$sid" "$epoch" | shasum -a 256 2>/dev/null | cut -d" " -f1
+}
+
+# 이 세션 구간에 저장이 있었는가. 판정 불가(빈 sid·shasum 없음)면 "있었다"로 본다 —
+# 무동작이 오탐보다 안전하다.
+orphan_session_had_write() {
+  local sid="$1"
+  [ -n "$sid" ] || return 0
+  command -v shasum >/dev/null 2>&1 || return 0
+  local dir="${ROOKIE_SESSION_WRITES_DIR:-$HOME/.rookie/session-writes}"
+  local key
+  key="$(_orphan_session_write_key "$sid")"
+  [ -n "$key" ] || return 0
+  [ -f "$dir/$key" ]
+}
+
+# 저장 0건이면 pending-extraction 에 reason=no_writes 로 올린다.
+# 비정상 종료(crash) 사유와 섞이지 않게 reason 을 남긴다 — 섞이면 진짜 복구 대기가 묻힌다.
+orphan_mark_no_writes() {
+  local sid="$1" transcript="${2:-}"
+  [ -n "$sid" ] || return 1
+  # 이미 추출을 마쳤거나 대기 중이면 덮지 않는다.
+  [ -f "$(_orphan_client_extracted_dir)/$sid.json" ] && return 0
+  [ -f "$(_orphan_pending_dir)/$sid.json" ] && return 0
+  _orphan_write_marker "$(_orphan_pending_dir)" "$sid" \
+    "$(printf '{"status":"pending_extraction","reason":"no_writes","transcript_path":"%s","recovered_at":"%s"}' \
+      "$transcript" "$(date -u +%Y-%m-%dT%H:%M:%SZ)")"
+}
+
 # P0.4 — 짧고 내용 없는(low_value) 세션 marker. record_pending 대신 호출 → 재적재 차단.
 orphan_mark_low_value() {
   local sid="$1" reason="${2:-low_value}" mc="${3:-0}"

package/version.json

@@ -1,4 +1,4 @@
 {
-  "cli_version": "0.4.28",
+  "cli_version": "0.4.29",
   "skill_version": "1.39.0"
 }