therookie 0.4.36 → 0.4.37

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "therookie",
-  "version": "0.4.36",
+  "version": "0.4.37",
   "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/lib/orphan-extract-core.js

@@ -35,6 +35,9 @@ export function listPendingExtractions({ orphanRoot }) {
           // spec 2026-09-08 §2.4 — 'no_writes'(저장 0건) 와 비정상 종료를 구분해 표시한다.
           //  섞이면 진짜 복구 대기가 묻힌다.
           reason: m.reason || 'crash',
+          // 'stale_writes' 는 마지막 저장 시각을 같이 싣는다 — 어디부터가 미저장인지가
+          // 초안을 읽는 쪽의 첫 질문이다.
+          since: m.since || null,
           recoveredAt: m.recovered_at || null,
           // codex marker 는 codex 서브루트에 산다 — marker 명령이 이 루트를 겨냥해야
           // 큐에서 실제로 빠진다(코드검토 P2). orphan-recovery.sh 의 ROOKIE_ORPHAN_DIR 규약.
@@ -105,7 +108,12 @@ export function renderDraft(entry, draft) {
   const lines = []
   const clean = (s) => redactDraftText(s).redacted.replace(/\s+/g, ' ').trim()
   // spec 2026-09-08 §2.4 — 사유를 앞에 붙인다. 저장 0건과 비정상 종료는 봐야 할 것이 다르다.
-  const why = entry.reason === 'no_writes' ? '저장 0건' : '비정상 종료'
+  const why =
+    entry.reason === 'no_writes'
+      ? '저장 0건'
+      : entry.reason === 'stale_writes'
+        ? `마지막 저장 뒤 미저장 구간${entry.since ? ` (저장 ${entry.since} 이후)` : ''}`
+        : '비정상 종료'
   lines.push(
     `◦ [${entry.runtime}] 세션 ${hashId8(entry.sid)} · ${why} (recovered ${entry.recoveredAt ?? 'unknown'})`
   )

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

@@ -35,14 +35,17 @@ export function resolveSessionId(explicit) {
 }
 
 /**
- * 저장이 생겼으니 "저장 0건" 대기는 더 이상 참이 아니다 — 그 표시만 지운다.
+ * 저장이 생겼으니 "저장 0건"·"마지막 저장 뒤 미저장 구간" 대기는 더 이상 참이 아니다 —
+ * 그 표시만 지운다(이어 연 세션이 그 구간을 저장한 경우).
  * 비정상 종료 복구 대기(reason 없음)는 tail 이 아직 안 건져졌으므로 건드리지 않는다.
  */
+const SAVE_CLEARABLE = new Set(['no_writes', 'stale_writes'])
+
 export function clearNoWritesPending(sessionId) {
   if (!sessionId) return false
   try {
     const f = join(orphanRoot(), 'pending-extraction', sessionId + '.json')
-    if (JSON.parse(readFileSync(f, 'utf8'))?.reason !== 'no_writes') return false
+    if (!SAVE_CLEARABLE.has(JSON.parse(readFileSync(f, 'utf8'))?.reason)) return false
     rmSync(f, { force: true })
     return true
   } catch {

package/templates/hook/flush-session.sh

@@ -305,9 +305,16 @@ if [ "$HTTP_CODE" = "200" ]; then
   # 어디에도 남지 않는다. 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
+    && [ "${MESSAGE_COUNT:-0}" -gt 0 ] 2>/dev/null; then
+    if ! orphan_session_had_write "$SESSION_ID"; then
+      orphan_mark_no_writes "$SESSION_ID" "$TRANSCRIPT_PATH" || true
+    elif command -v orphan_session_has_unsaved_tail >/dev/null 2>&1 \
+      && orphan_session_has_unsaved_tail "$SESSION_ID" "$TRANSCRIPT_PATH"; then
+      # 저장은 있었지만 그 뒤로 대화가 임계 이상 더 쌓였다 — 마지막 저장 뒤 구간은
+      # 아무 데도 안 남는다(2026-09-22 실측). 같은 큐에 사유만 갈라 올린다.
+      orphan_mark_no_writes "$SESSION_ID" "$TRANSCRIPT_PATH" "stale_writes" \
+        "$(orphan_session_last_write_at "$SESSION_ID")" || true
+    fi
   fi
 else
   # §17 H-2: 큐 적재 + 1회 chain drain (일시적 깜빡임 회복)

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

@@ -113,17 +113,96 @@ orphan_session_had_write() {
   [ -f "$dir/$key" ]
 }
 
+# 저장 마커 경로 — had_write 와 같은 키를 쓴다(세션 구간 단위).
+_orphan_session_write_marker_path() {
+  local sid="$1"
+  [ -n "$sid" ] || return 1
+  command -v shasum >/dev/null 2>&1 || return 1
+  local key
+  key="$(_orphan_session_write_key "$sid")"
+  [ -n "$key" ] || return 1
+  printf '%s/%s' "${ROOKIE_SESSION_WRITES_DIR:-$HOME/.rookie/session-writes}" "$key"
+}
+
+# 마지막 저장 시각(ISO UTC). 마커가 없거나 못 읽으면 빈 출력.
+# date -r 은 BSD/GNU 해석이 갈려 쓰지 않는다 — node 로 mtime 을 읽는다.
+orphan_session_last_write_at() {
+  local sid="$1" marker
+  marker="$(_orphan_session_write_marker_path "$sid")" || return 1
+  [ -f "$marker" ] || return 1
+  node -e "
+    const fs = require('node:fs');
+    try { console.log(new Date(fs.statSync(process.argv[1]).mtimeMs).toISOString()); }
+    catch { console.log(''); }
+  " "$marker" 2>/dev/null
+}
+
+# 마지막 저장 이후 쌓인 대화 수. 셀 수 없으면 0 — 무동작이 오탐보다 안전하다.
+orphan_session_tail_count() {
+  local sid="$1" transcript="$2" marker
+  [ -n "$transcript" ] && [ -f "$transcript" ] || { printf '0'; return 0; }
+  marker="$(_orphan_session_write_marker_path "$sid")" || { printf '0'; return 0; }
+  [ -f "$marker" ] || { printf '0'; return 0; }
+  node -e "
+    const fs = require('node:fs');
+    const out = (n) => { console.log(String(n)); process.exit(0); };
+    let since;
+    try { since = fs.statSync(process.argv[2]).mtimeMs; } catch { out(0); }
+    let raw;
+    try { raw = fs.readFileSync(process.argv[1], 'utf8'); } catch { out(0); }
+    let n = 0;
+    for (const line of raw.split('\n')) {
+      const t = line.trim(); if (!t) continue;
+      let j; try { j = JSON.parse(t); } catch { continue; }
+      const m = j.message || j;
+      if (m.role !== 'user' && m.role !== 'assistant') continue;
+      const ts = Date.parse(j.timestamp || m.timestamp || '');
+      if (!Number.isFinite(ts) || ts <= since) continue;
+      let c = m.content;
+      if (typeof c !== 'string') {
+        c = Array.isArray(c)
+          ? c.filter(b => b && b.type === 'text' && typeof b.text === 'string').map(b => b.text).join('\n').trim()
+          : '';
+      } else { c = c.trim(); }
+      if (!c) continue;
+      n++;
+    }
+    out(n);
+  " "$transcript" "$marker" 2>/dev/null || printf '0'
+}
+
+# 마지막 저장 뒤로 임계 이상이 쌓였는가 — Stop hook 이 돌았다는 것과 그 구간이 기억에
+# 남았다는 것은 다른 일이다(2026-09-22 실측: 세션 5개가 flushed source=stop 으로 닫히고
+# 마지막 저장 뒤 30분 넘는 구간이 카드 없이 사라졌다).
+#
+# 기본 3 인 이유: 세는 것은 본문 있는 user·assistant 메시지라 도구 호출만 한 턴은 안 세인다.
+# 같은 실측에서 두목 지시 한 건을 받아 처리하고 끝난 세션의 tail 이 3 이었고, 42·10 인 세션과
+# 함께 잡혀야 했다. 저장으로 잘 닫은 세션은 뒤에 인사 한두 줄만 남아 3 에 못 미친다 —
+# 임계를 낮게 잡되 0 으로 두지 않는 이유가 그것이다(큐가 넓어지면 다음 세션이 큐를 안 믿는다).
+orphan_session_has_unsaved_tail() {
+  local sid="$1" transcript="$2" count min
+  min="${ROOKIE_UNSAVED_TAIL_MIN:-3}"
+  case "$min" in (*[!0-9]*|'') min=3 ;; esac
+  count="$(orphan_session_tail_count "$sid" "$transcript")"
+  case "$count" in (*[!0-9]*|'') return 1 ;; esac
+  [ "$count" -ge "$min" ]
+}
+
 # 저장 0건이면 pending-extraction 에 reason=no_writes 로 올린다.
 # 비정상 종료(crash) 사유와 섞이지 않게 reason 을 남긴다 — 섞이면 진짜 복구 대기가 묻힌다.
 orphan_mark_no_writes() {
-  local sid="$1" transcript="${2:-}"
+  local sid="$1" transcript="${2:-}" reason="${3:-no_writes}" since="${4:-}"
   [ -n "$sid" ] || return 1
+  # reason·since 는 marker JSON 에 그대로 박힌다 — 따옴표·백슬래시가 섞이면 읽는 쪽이 깨진다.
+  reason="$(printf '%s' "$reason" | tr -cd 'A-Za-z0-9_.:-')"
+  [ -n "$reason" ] || reason="no_writes"
+  since="$(printf '%s' "$since" | tr -cd 'A-Za-z0-9_.:-')"
   # 이미 추출을 마쳤거나 대기 중이면 덮지 않는다.
   [ -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)")"
+    "$(printf '{"status":"pending_extraction","reason":"%s","since":"%s","transcript_path":"%s","recovered_at":"%s"}' \
+      "$reason" "$since" "$transcript" "$(date -u +%Y-%m-%dT%H:%M:%SZ)")"
 }
 
 # P0.4 — 짧고 내용 없는(low_value) 세션 marker. record_pending 대신 호출 → 재적재 차단.

package/version.json

@@ -1,4 +1,4 @@
 {
-  "cli_version": "0.4.36",
+  "cli_version": "0.4.37",
   "skill_version": "1.40.1"
 }