therookie 0.4.32 → 0.4.34

package/README.md

@@ -1,11 +1,17 @@
 # therookie
 
-**the Rookie** — the AI new hire that remembers what you teach it. A CLI that connects a personal AI memory ("the Rookie") to AI tools like Claude and Codex. It remembers your company, projects, context, and preferences across sessions.
+You correct the same thing three times, your AI finally gets it, and then you open a new session and it's gone.
+
+**the Rookie** keeps what you taught outside the conversation. When the next session starts, your AI reads it first. The name, tone, and working habits you gave it stay too — close Claude Code, open Codex, and the same coworker shows up.
+
+It's the AI new hire that remembers what you teach it. A CLI that connects a personal memory to AI tools like Claude and Codex.
 
 - Homepage: https://therookie.kr
 - Guide: https://therookie.kr/guide
 - Maintained by: Rolling Mango Corp.
 
+> Early access. You need an invite code to sign up — request one at https://therookie.kr. Free during early access.
+
 ## Install
 
 ```sh

package/package.json

@@ -1,15 +1,26 @@
 {
   "name": "therookie",
-  "version": "0.4.32",
-  "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.",
+  "version": "0.4.34",
+  "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": [
     "ai",
     "memory",
+    "ai-memory",
+    "agent-memory",
+    "persistent-memory",
+    "long-term-memory",
+    "llm",
     "claude",
     "claude-code",
+    "claude-code-hooks",
     "codex",
+    "codex-cli",
     "mcp",
+    "cli",
+    "ai-agent",
+    "coding-agent",
+    "context",
     "rookie",
     "the-rookie"
   ],

package/src/commands/save.js

@@ -13,7 +13,11 @@ 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'
+import {
+  recordSessionWrite,
+  resolveSessionId,
+  clearNoWritesPending,
+} from '../lib/session-write-marker.js'
 
 // 저장된 층을 **빠짐없이** 화면에 센다. 여기 없는 층은 서버가 저장해도 0건처럼 보인다 —
 // 2026-09-02 저장에서 durable fact 3건이 그렇게 안 보였고, metric·recall 로 따로 확인해야
@@ -118,9 +122,12 @@ export async function runSave(flags) {
   }
 
   // spec 2026-09-08 §2.4 — 이 세션에 저장이 있었다는 로컬 마커. Stop hook 이 없으면 미추출 큐에 넣는다.
-  //  --session 미전달이면 아무것도 안 한다(기존 호출자 호환).
+  //  --session 이 없으면 실행 환경의 세션 id 로 채운다. 이미 올라간 '저장 0건' 대기도 닫는다 —
+  //  나중에 저장한 세션이 큐에 남아 만료로 버려지던 경로(2026-09-16).
   if (res.all_committed !== false) {
-    recordSessionWrite(typeof flags.session === 'string' ? flags.session : '')
+    const sessionId = resolveSessionId(typeof flags.session === 'string' ? flags.session : '')
+    recordSessionWrite(sessionId)
+    clearNoWritesPending(sessionId)
   }
 
   if (flags.json) {

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

@@ -7,14 +7,49 @@
 // 구간 경계를 skill-gate 의 .epoch 로 따로 감지한다). 세션 단위 키만 쓰면 clear 이전 구간에
 // 저장이 있었다는 이유로 이후 구간이 통째로 면제된다.
 import { createHash } from 'node:crypto'
-import { mkdirSync, writeFileSync, existsSync, readFileSync } from 'node:fs'
+import { mkdirSync, writeFileSync, existsSync, readFileSync, rmSync } from 'node:fs'
 import { join } from 'node:path'
 import { homedir } from 'node:os'
 
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i
+
 export function markerDir() {
   return process.env.ROOKIE_SESSION_WRITES_DIR || join(homedir(), '.rookie', 'session-writes')
 }
 
+function orphanRoot() {
+  return process.env.ROOKIE_ORPHAN_DIR || join(homedir(), '.rookie', 'orphan-recovery')
+}
+
+/**
+ * 저장에 쓸 세션 id. 명시값이 없으면 Claude Code 가 실행 환경에 주는 값으로 채운다.
+ *
+ * 스킬은 `--session` 을 "세션 시작 컨텍스트에서 받은 값" 으로 안내했는데 그 응답에는 세션
+ * 식별자가 없다 — 그래서 마커가 사실상 안 남았다(2026-09-16 실측: 마커 2개 vs 7일 저장 191건).
+ * 마커가 없으면 Stop hook 이 모든 세션을 "저장 0건" 으로 보고 큐에 올린다.
+ */
+export function resolveSessionId(explicit) {
+  if (typeof explicit === 'string' && explicit) return explicit
+  const env = process.env.CLAUDE_CODE_SESSION_ID
+  return typeof env === 'string' && UUID_RE.test(env) ? env : ''
+}
+
+/**
+ * 저장이 생겼으니 "저장 0건" 대기는 더 이상 참이 아니다 — 그 표시만 지운다.
+ * 비정상 종료 복구 대기(reason 없음)는 tail 이 아직 안 건져졌으므로 건드리지 않는다.
+ */
+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
+    rmSync(f, { force: true })
+    return true
+  } catch {
+    return false
+  }
+}
+
 function gateDir() {
   return process.env.ROOKIE_SKILL_GATE_DIR || join(homedir(), '.rookie', 'skill-gate')
 }

package/templates/skill/references/save.md

@@ -5,12 +5,14 @@
 ## 호출 방법
 
 ```bash
-rookie save --file <body.json> --session <session_id>   # 또는:  echo '<body>' | rookie save --session <id>
+rookie save --file <body.json>       # 또는:  echo '<body>' | rookie save
+rookie save --file <body.json> --session <session_id>   # 세션 id 를 명시해야 하는 경로에서만
 ```
 
-`--session` 은 **세션 시작 컨텍스트에서 받은 session_id** 다. 저장이 성공하면 로컬 마커를 남겨,
-Stop hook 이 "이 세션은 아무것도 저장하지 않았다"를 판정할 수 있게 한다(spec 2026-09-08 §2.4).
-빠뜨려도 저장은 정상 동작하지만, **그 세션은 저장 0건으로 오인돼 미추출 큐에 올라간다** — 붙이는 편이 낫다.
+`--session` 은 **대개 붙일 필요가 없다** — Claude Code 세션에서는 CLI 가 실행 환경의 세션 id
+(`CLAUDE_CODE_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.32",
-  "skill_version": "1.40.0"
+  "cli_version": "0.4.34",
+  "skill_version": "1.40.1"
 }