therookie 0.4.28 → 0.4.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "therookie",
-  "version": "0.4.28",
+  "version": "0.4.30",
   "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/templates/skill/SKILL.md

@@ -24,6 +24,10 @@ installed_by: __INSTALLED_BY__
    - **1순위**: `entry_cards[]` 를 직접 읽는다. 비어있지 않으면 **그 작업을 이어가려는 사용자 의도를 우선 가정**해 먼저 언급한다. 안전 신호 — `grade` `warn`/`old` → 이미 완료됐을 수 있으니 현재 상태부터 점검 / `is_meta_card` → 메타 카드 의심·단일 fact 분리 권고·`body` 절단본(전량 단정 금지) / `is_vague` → 목표 수준 카드 — recall 로 방법 보강 후 착수 / `has_contradiction` → 단정 전 점검 / `reasoning` → 근거로 고려.
    - **activity-stale**: `activity_stale=true`(또는 `newer_activity_count>0`) → 카드 이후 같은 프로젝트에서 세션이 더 진행됐다. `effective_grade`(age·activity 중 높은 등급)를 권위 기준으로, recall + 현재 상태(git log·해당 파일) 점검 후 착수. "이게 마지막 작업" 단정 금지. **단 이 신호는 "카드 이후 활동이 있었다"는 뜻이지 "카드 내용이 틀렸다"는 뜻이 아니다** — 카드를 대체할 내용은 `ephemeral_recovery` 또는 카드 `recorded_at` 보다 최신인 회상 결과로만 확인한다(아래 "진입 카드 = 최신성 기준선").
    - **`ephemeral_recovery`(임시 복구, 저장 아님)**: activity-stale 카드에 붙는 read-time 합성물. `id` 없음 — `supersedes`·`task_id` 연결 금지. stale 카드와 **함께** 표시("직전 카드(오래됨) + 🛟 임시 복구: <headline>"). `synthesis_tier=bare`=세부 기록 없음으로만, `evidence`="바뀐 것으로 보고됨"(확인 아님). 진짜 다음 카드를 저장하면 다음 조회부터 사라진다.
+   - **`is_secondary_track`(다른 트랙)**: 이 카드는 주 카드와 **같은 작업의 신·구가 아니라** 같은
+     프로젝트에서 병행 중인 별개 작업이다. 한 프로젝트에 트랙이 여럿일 때 최신 트랙이 나머지를 덮는
+     것을 막으려고 서버가 골라 붙인다. 두 카드를 신·구로 읽고 한쪽을 폐기하지 않는다 — 어느 쪽을
+     이어갈지 애매하면 두목께 한 줄로 여쭙는다.
    - **폴백**(구버전 서버): `system_prompt` 의 `## 🔖 진행 중 작업 카드` 마커를 grep(유동 위치 — head/tail 훑기 금지). 텍스트 경로엔 `🔀 세션 N건`·`🛟 임시 복구` 라인으로 동기.
    - **무-주제 "이어서/계속하자"** 는 `entry_cards`(최신순) 우선. relevance recall 은 특정 주제를 명시했을 때만.
    - **카드 소비 규칙**: `[고정]`·`[통과]` 자산은 폐기·제외 제안 금지 / `[실패]` 접근은 재제안 금지 / "다음:" 이 목표 수준("~이어가기")뿐이면 목표를 되묻지 말고 방법 1개를 추천안 삼아 착수 보고.

package/templates/skill/references/save.md

@@ -5,8 +5,12 @@
 ## 호출 방법
 
 ```bash
-rookie save --file <body.json>        # 또는:  echo '<body>' | rookie save
+rookie save --file <body.json> --session <session_id>   # 또는:  echo '<body>' | rookie save --session <id>
 ```
+
+`--session` 은 **세션 시작 컨텍스트에서 받은 session_id** 다. 저장이 성공하면 로컬 마커를 남겨,
+Stop hook 이 "이 세션은 아무것도 저장하지 않았다"를 판정할 수 있게 한다(spec 2026-09-08 §2.4).
+빠뜨려도 저장은 정상 동작하지만, **그 세션은 저장 0건으로 오인돼 미추출 큐에 올라간다** — 붙이는 편이 낫다.
 ⚠️ **`curl` 로 직접 batch-mutate 금지** — `rookie save` 가 cwd·git remote·hostname 을 자동 주입해 전역 누수를 막는다. 본문엔 **기억할 내용만**.
 
 ⚠️ **전역 fact 는 `project_id: null` 을 명시한다.** 식별자도 명시 의사도 없으면 서버가 `missing_workspace_context` 로 **거부**. 미등록 폴더 저장은 **그 폴더에 격리**, `rookie link` 시 자동 승격.

package/version.json

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