kyp-mem 0.4.3 → 0.4.4

package/kyp_mem/cli.py

@@ -45,6 +45,7 @@ def main():
 
     hook_parser = subparsers.add_parser("hook", help="Handle Claude Code hook events (internal)")
     hook_sub = hook_parser.add_subparsers(dest="hook_command")
+    hook_sub.add_parser("session-start", help="Inject project context at session start")
     hook_sub.add_parser("post-tool-use", help="Capture tool activity to session log")
     hook_sub.add_parser("user-prompt", help="Capture user prompt to session log")
     hook_sub.add_parser("stop", help="Compile session into vault note")
@@ -73,8 +74,10 @@ def main():
     elif args.command == "doctor":
         _run_doctor()
     elif args.command == "hook":
-        from .hooks import handle_post_tool_use, handle_user_prompt, handle_stop
-        if args.hook_command == "post-tool-use":
+        from .hooks import handle_session_start, handle_post_tool_use, handle_user_prompt, handle_stop
+        if args.hook_command == "session-start":
+            handle_session_start()
+        elif args.hook_command == "post-tool-use":
             handle_post_tool_use()
         elif args.hook_command == "user-prompt":
             handle_user_prompt()
@@ -286,7 +289,7 @@ def _run_install_hooks(global_config: bool = False, remove: bool = False):
 
     if remove:
         changed = False
-        for event in ("PostToolUse", "UserPromptSubmit", "Stop"):
+        for event in ("SessionStart", "PostToolUse", "UserPromptSubmit", "Stop"):
             if event in hooks:
                 hooks[event] = [h for h in hooks[event] if not _has_kyp_hook(h)]
                 if not hooks[event]:
@@ -301,14 +304,19 @@ def _run_install_hooks(global_config: bool = False, remove: bool = False):
         print()
         return
 
+    session_start_hooks = hooks.setdefault("SessionStart", [])
     post_tool_hooks = hooks.setdefault("PostToolUse", [])
     prompt_hooks = hooks.setdefault("UserPromptSubmit", [])
     stop_hooks = hooks.setdefault("Stop", [])
 
+    session_start_hooks = [h for h in session_start_hooks if not _has_kyp_hook(h)]
     post_tool_hooks = [h for h in post_tool_hooks if not _has_kyp_hook(h)]
     prompt_hooks = [h for h in prompt_hooks if not _has_kyp_hook(h)]
     stop_hooks = [h for h in stop_hooks if not _has_kyp_hook(h)]
 
+    session_start_hooks.append({
+        "hooks": [{"type": "command", "command": f"{mcp_command} hook session-start"}],
+    })
     post_tool_hooks.append({
         "matcher": "Edit|Write|Read|Bash",
         "hooks": [{"type": "command", "command": f"{mcp_command} hook post-tool-use"}],
@@ -320,6 +328,7 @@ def _run_install_hooks(global_config: bool = False, remove: bool = False):
         "hooks": [{"type": "command", "command": f"{mcp_command} hook stop"}],
     })
 
+    hooks["SessionStart"] = session_start_hooks
     hooks["PostToolUse"] = post_tool_hooks
     hooks["UserPromptSubmit"] = prompt_hooks
     hooks["Stop"] = stop_hooks

package/kyp_mem/hooks.py

@@ -12,6 +12,81 @@ CURRENT_SESSION = SESSION_DIR / "current.jsonl"
 MIN_ACTIONS = 3
 
 
+def handle_session_start():
+    """Inject project context into the conversation at session start."""
+    sys.stdin.read()
+
+    cwd = os.environ.get("CLAUDE_PROJECT_DIR", os.getcwd())
+    project_name = Path(cwd).name
+
+    try:
+        from .config import get_vault_path
+        from .vault import Vault
+
+        vault = Vault(get_vault_path())
+
+        project_notes = [p for p in vault.index.notes if p.startswith(f"{project_name}/")]
+        if not project_notes:
+            return
+
+        parts = [f"# [kyp-mem] {project_name} — Project Context"]
+        parts.append(f"Vault: {get_vault_path()}")
+        parts.append("")
+
+        knowledge_path = f"{project_name}/Knowledge.md"
+        knowledge = vault.read(knowledge_path)
+        if knowledge:
+            parts.append("## Knowledge")
+            content = knowledge.content
+            timeline_idx = content.find("## Timeline")
+            if timeline_idx > 0:
+                content = content[:timeline_idx].strip()
+            if len(content) > 2000:
+                parts.append(content[:2000] + "\n...")
+            else:
+                parts.append(content)
+            parts.append("")
+
+        other_notes = sorted(
+            p for p in project_notes
+            if "/Sessions/" not in p and p != knowledge_path
+        )
+        if other_notes:
+            parts.append("## Project Notes")
+            for p in other_notes:
+                note = vault.index.notes.get(p)
+                title = note.title if note else p
+                tags = f" [{', '.join(note.tags)}]" if note and note.tags else ""
+                parts.append(f"- {title} ({p}){tags}")
+            parts.append("")
+
+        sessions = sorted(
+            (p for p in project_notes if "/Sessions/" in p),
+            reverse=True,
+        )[:3]
+        if sessions:
+            parts.append(f"## Recent Sessions (last {len(sessions)})")
+            for sp in sessions:
+                note = vault.read(sp)
+                if not note:
+                    continue
+                parts.append(f"### {note.title}")
+                content = note.content
+                timeline_idx = content.find("## Timeline")
+                if timeline_idx > 0:
+                    content = content[:timeline_idx].strip()
+                if len(content) > 300:
+                    content = content[:300] + "..."
+                parts.append(content)
+                parts.append("")
+
+        parts.append("Use `kyp_project_context` for full details. Use `kyp_session_search` to search past sessions.")
+
+        print("\n".join(parts))
+    except Exception:
+        pass
+
+
 def handle_user_prompt():
     raw = sys.stdin.read().strip()
     if not raw:

package/kyp_mem/static/index.html

@@ -1294,8 +1294,8 @@ body.resizing .resize-handle { pointer-events: auto !important; }
 
 .session-item {
   display: flex;
-  align-items: center;
-  padding: 3px 10px;
+  align-items: flex-start;
+  padding: 5px 10px;
   border-radius: var(--radius-sm);
   cursor: pointer;
   font-size: 11px;
@@ -1328,6 +1328,14 @@ body.resizing .resize-handle { pointer-events: auto !important; }
   color: var(--neon-green);
   opacity: 0.5;
   flex-shrink: 0;
+  margin-top: 3px;
+}
+
+.session-item .si-content {
+  display: flex;
+  flex-direction: column;
+  min-width: 0;
+  flex: 1;
 }
 
 .session-item .si-time {
@@ -1336,7 +1344,17 @@ body.resizing .resize-handle { pointer-events: auto !important; }
   color: var(--text-secondary);
 }
 
+.session-item .si-summary {
+  font-size: 10px;
+  color: var(--text-muted);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  line-height: 1.3;
+}
+
 .session-item.active .si-time { color: var(--neon-green); }
+.session-item.active .si-summary { color: var(--text-secondary); }
 
 .session-badge {
   display: inline-flex;

package/kyp_mem/ui.py

@@ -177,12 +177,22 @@ def create_app(vault_path: str = None) -> FastAPI:
                 continue
             if proj not in sessions:
                 sessions[proj] = []
+            summary = ""
+            lines = (note.content or "").split("\n")
+            for i, line in enumerate(lines):
+                if line.strip() == "## Summary":
+                    for j in range(i + 1, len(lines)):
+                        if lines[j].strip() and not lines[j].startswith("#"):
+                            summary = lines[j].strip()
+                            break
+                    break
             sessions[proj].append({
                 "path": path,
                 "title": note.title,
                 "tags": note.tags,
                 "created": note.created,
                 "updated": note.updated,
+                "summary": summary,
             })
         for proj in sessions:
             sessions[proj].sort(key=lambda s: s["path"], reverse=True)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kyp-mem",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "Know Your Project — Persistent & Session level knowledge base for AI agents. MCP-powered with wikilinks, backlinks, auto-learning, and neon web UI.",
   "bin": {
     "kyp-mem": "bin/cli.mjs"