forget-connect 0.3.0 → 0.4.0

package/README.md

@@ -1,7 +1,7 @@
 # forget-connect
 
 Connect Claude Code, Codex, and Claude Desktop to a local
-[Forget](https://github.com/junghunkim/forget) memory server without
+[Forget](https://github.com/multi-turn-inc/forget) memory server without
 overwriting the MCP servers or global instructions you already have.
 
 ```bash

package/assets/hooks/forget_capture.py

@@ -96,6 +96,7 @@ def _digest(transcript_path: str) -> dict:
         "last_ts": last_ts,
         "user_snippets": user_snippets[-USER_SNIPPETS:],
         "assistant_blob": _normalize(" ".join(assistant_parts)),
+        "last_assistant": _normalize(assistant_parts[-1])[-240:] if assistant_parts else "",
         "tail_only": size > TAIL_BYTES,
     }
 
@@ -126,6 +127,25 @@ def _capture(hook_input: dict, digest: dict, transcript_path: str, session_id: s
     )
 
 
+def _handoff(digest: dict, transcript_path: str, session_id: str) -> None:
+    """Shift-change note: compaction is an accident mid-sentence, not a death.
+
+    PreCompact writes what the cut hand was holding — the last human ask and
+    the last assistant sentence — so the post-compact SessionStart can hand
+    the thread back once, then burn the note. Judgment-free, fail-open.
+    """
+    os.makedirs(STATE_DIR, exist_ok=True)
+    note = {
+        "session_id": session_id,
+        "cut_at": digest.get("last_ts") or "",
+        "last_user": (digest.get("user_snippets") or [""])[-1],
+        "last_assistant": digest.get("last_assistant") or "",
+        "transcript_path": transcript_path,
+    }
+    with open(os.path.join(STATE_DIR, "handoff.json"), "w", encoding="utf-8") as fh:
+        json.dump(note, fh, ensure_ascii=False)
+
+
 def _outcome(digest: dict, session_id: str) -> None:
     state_path = os.path.join(STATE_DIR, f"{session_id}.json")
     if not os.path.exists(state_path):
@@ -176,6 +196,11 @@ def main() -> None:
         _capture(hook_input, digest, transcript_path, session_id)
     except Exception:
         pass
+    if str(hook_input.get("hook_event_name") or "") == "PreCompact":
+        try:
+            _handoff(digest, transcript_path, session_id)
+        except Exception:
+            pass
     # Outcome is a session-final label: a mid-session compact must not consume
     # the offer ledger, or usage after the compact goes unmeasured.
     if str(hook_input.get("hook_event_name") or "") == "SessionEnd":

package/assets/hooks/forget_sessionstart.py

@@ -13,11 +13,45 @@ from __future__ import annotations
 import json
 import os
 import sys
+import time
 import urllib.request
 
 FORGET_URL = os.environ.get("FORGET_MCP_URL", "http://127.0.0.1:8000/mcp")
 STATE_DIR = os.path.expanduser("~/.forget/hooks/state")
 CAPSULE_CHAR_BUDGET = 1_600  # ~400 tokens
+HANDOFF_MAX_AGE_SECONDS = 48 * 3600  # a stale shift-note is worse than none
+
+
+def _consume_handoff() -> str:
+    """Read the PreCompact shift-note once, then burn it.
+
+    Delivered to exactly one next hand: the post-compact continuation
+    (source="compact") or, failing that, the next fresh session within 48h.
+    """
+    path = os.path.join(STATE_DIR, "handoff.json")
+    if not os.path.exists(path):
+        return ""
+    try:
+        fresh = (time.time() - os.path.getmtime(path)) <= HANDOFF_MAX_AGE_SECONDS
+        with open(path, encoding="utf-8") as fh:
+            note = json.load(fh)
+    except Exception:
+        return ""
+    finally:
+        try:
+            os.replace(path, path + ".done")
+        except OSError:
+            pass
+    if not fresh:
+        return ""
+    lines = ["[교대 인수인계 — 직전 세션이 압축으로 문장 중간에서 잘렸음]"]
+    if note.get("last_user"):
+        lines.append(f"마지막 실: {str(note['last_user'])[:200]}")
+    if note.get("last_assistant"):
+        lines.append(f"잘린 손의 마지막 문장: …{str(note['last_assistant'])[:200]}")
+    if note.get("transcript_path"):
+        lines.append(f"원문: {note['transcript_path']} (recall_episode로 열람 가능)")
+    return "\n".join(lines)
 
 
 def main() -> None:
@@ -49,13 +83,19 @@ def main() -> None:
         items = use_now.get("items") if isinstance(use_now, dict) else None
         if isinstance(items, list) and items:
             capsule = "\n".join(f"- {item}" for item in items[:6] if isinstance(item, str))
-    if not capsule:
+    handoff = _consume_handoff()
+    if not capsule and not handoff:
         return  # low confidence → silence
     shown = capsule[:CAPSULE_CHAR_BUDGET]
-    print(
-        "[forget 캡슐 — 제안이며 명령이 아님. 채택/기각은 네 판단. "
-        "라벨 없는 항목은 노랑(행동 전 확인) 취급]\n" + shown
-    )
+    parts = []
+    if handoff:
+        parts.append(handoff)
+    if shown:
+        parts.append(
+            "[forget 캡슐 — 제안이며 명령이 아님. 채택/기각은 네 판단. "
+            "라벨 없는 항목은 노랑(행동 전 확인) 취급]\n" + shown
+        )
+    print("\n".join(parts))
     # Offer ledger: record what was offered so the capture hook can measure,
     # at session end, whether the offer was actually used (outcome flywheel).
     session_id = str(hook_input.get("session_id") or "").strip()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forget-connect",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Safely connect Claude Code, Codex, and Claude Desktop to Forget memory.",
   "type": "module",
   "bin": {
@@ -35,4 +35,4 @@
     "directory": "packages/forget-connect"
   },
   "homepage": "https://multi-turn.ai"
-}
+}