kyp-mem 0.3.0 → 0.4.0

package/kyp_mem/hooks.py

@@ -64,29 +64,53 @@ def handle_stop():
             short = cmd[:80] + "..." if len(cmd) > 80 else cmd
             timeline.append(f"  {ts} — `{short}`")
 
+    summary_items = []
+    if files_edited:
+        summary_items.append(f"Modified {len(files_edited)} file{'s' if len(files_edited) != 1 else ''}")
+    if files_created:
+        summary_items.append(f"Created {len(files_created)} file{'s' if len(files_created) != 1 else ''}")
+    if commands:
+        summary_items.append(f"Ran {len(commands)} command{'s' if len(commands) != 1 else ''}")
+
+    investigate_keywords = {'grep', 'find', 'cat', 'head', 'tail', 'less', 'ls', 'tree', 'rg', 'ag', 'fd', 'wc', 'diff'}
+    investigated_cmds = []
+    for cmd in commands:
+        first_word = cmd.strip().split()[0] if cmd.strip() else ''
+        if first_word in investigate_keywords:
+            investigated_cmds.append(cmd)
+
     parts = [f"# Session {session_id}", ""]
     parts.append(f"**Project:** `{project_dir}`")
     parts.append(f"**Actions:** {len(entries)} total, {len(write_actions)} substantive")
     parts.append("")
 
+    parts.append("## Summary")
+    parts.append(", ".join(summary_items) + f" in `{project_name}`." if summary_items else "")
+    parts.append("")
+
+    parts.append("## INVESTIGATED")
+    if investigated_cmds:
+        for cmd in investigated_cmds[:15]:
+            short = cmd[:120] + "..." if len(cmd) > 120 else cmd
+            parts.append(f"- `{short}`")
+    parts.append("")
+
+    parts.append("## LEARNED")
+    parts.append("")
+    parts.append("")
+
+    parts.append("## COMPLETED")
     if files_edited:
-        parts.append("## Files Modified")
         for f in sorted(files_edited):
-            parts.append(f"- `{f}`")
-        parts.append("")
-
+            parts.append(f"- Modified `{Path(f).name}`")
     if files_created:
-        parts.append("## Files Created")
         for f in sorted(files_created):
-            parts.append(f"- `{f}`")
-        parts.append("")
+            parts.append(f"- Created `{Path(f).name}`")
+    parts.append("")
 
-    if commands:
-        parts.append("## Commands Run")
-        for cmd in commands[:25]:
-            short = cmd[:120] + "..." if len(cmd) > 120 else cmd
-            parts.append(f"- `{short}`")
-        parts.append("")
+    parts.append("## NEXT STEPS")
+    parts.append("")
+    parts.append("")
 
     if timeline:
         parts.append("## Timeline")
@@ -102,7 +126,7 @@ def handle_stop():
     from .vault import Vault
 
     vault = Vault(get_vault_path())
-    vault.write_note(f"Sessions/{session_id}.md", content, tags, {})
+    vault.write_note(f"{project_name}/Sessions/{session_id}.md", content, tags, {})
 
     CURRENT_SESSION.unlink(missing_ok=True)
 

package/kyp_mem/server.py

@@ -1,6 +1,7 @@
 """KYP-MEM MCP server — headless knowledge base for AI agents."""
 
 import json
+from datetime import datetime
 from mcp.server.fastmcp import FastMCP
 from .config import get_vault_path
 from .vault import Vault
@@ -191,3 +192,106 @@ def kyp_stats() -> str:
         f"  Links: {s['links']}\n"
         f"  Backlinks: {s['backlinks']}"
     )
+
+
+@mcp.tool()
+def kyp_session_create(project: str, summary: str = "", investigated: str = "", learned: str = "", completed: str = "", next_steps: str = "") -> str:
+    """Create a structured session note. Project is required. Sections accept markdown text."""
+    session_id = datetime.now().strftime("%Y-%m-%d_%H%M%S")
+    parts = [f"# Session {session_id}", ""]
+    parts.append(f"**Project:** {project}")
+    parts.append("")
+    parts.append("## Summary")
+    parts.append(summary or "")
+    parts.append("")
+    parts.append("## INVESTIGATED")
+    parts.append(investigated or "")
+    parts.append("")
+    parts.append("## LEARNED")
+    parts.append(learned or "")
+    parts.append("")
+    parts.append("## COMPLETED")
+    parts.append(completed or "")
+    parts.append("")
+    parts.append("## NEXT STEPS")
+    parts.append(next_steps or "")
+
+    content = "\n".join(parts)
+    tags = ["session", "manual", project.lower().replace(" ", "-")]
+    path = f"{project}/Sessions/{session_id}.md"
+    vault.write_note(path, content, tags, {})
+    return f"Created session: {path}"
+
+
+@mcp.tool()
+def kyp_sessions(project: str = "", limit: int = 10) -> str:
+    """List sessions, optionally filtered by project. Shows most recent first."""
+    sessions = []
+    for path, note in vault.index.notes.items():
+        if "/Sessions/" not in path and not path.startswith("Sessions/"):
+            continue
+        if project and not path.lower().startswith(project.lower() + "/"):
+            continue
+        sessions.append((path, note))
+    sessions.sort(key=lambda s: s[0], reverse=True)
+    sessions = sessions[:limit]
+    if not sessions:
+        return "No sessions found." + (f" (project filter: {project})" if project else "")
+    lines = ["Sessions:", ""]
+    for path, note in sessions:
+        tags = f" [{', '.join(note.tags)}]" if note.tags else ""
+        date = note.created or note.updated or ""
+        lines.append(f"  {date} — {note.title} ({path}){tags}")
+    return "\n".join(lines)
+
+
+@mcp.tool()
+def kyp_project_context(project: str) -> str:
+    """Get full project context: knowledge base + recent session summaries. Call this at session start to understand project history, avoid repeating past work, and prevent hallucination."""
+    parts = []
+
+    knowledge_path = f"{project}/Knowledge.md"
+    knowledge = vault.read(knowledge_path)
+    if knowledge:
+        parts.append("=== PROJECT KNOWLEDGE ===")
+        parts.append(knowledge.content)
+        parts.append("")
+
+    project_notes = []
+    for path, note in vault.index.notes.items():
+        if path.startswith(f"{project}/") and "/Sessions/" not in path and path != knowledge_path:
+            project_notes.append((path, note))
+
+    if project_notes:
+        parts.append("=== PROJECT NOTES ===")
+        for path, note in sorted(project_notes):
+            parts.append(f"\n--- {note.title} ({path}) ---")
+            preview = note.content.strip().split("\n")
+            parts.append("\n".join(preview[:10]))
+            if len(preview) > 10:
+                parts.append("...")
+        parts.append("")
+
+    sessions = []
+    for path, note in vault.index.notes.items():
+        if path.startswith(f"{project}/Sessions/"):
+            sessions.append((path, note))
+    sessions.sort(key=lambda s: s[0], reverse=True)
+    recent = sessions[:5]
+
+    if recent:
+        parts.append(f"=== RECENT SESSIONS ({len(recent)} of {len(sessions)}) ===")
+        for path, note in recent:
+            parts.append(f"\n--- {note.title} ---")
+            content = note.content
+            timeline_idx = content.find("## Timeline")
+            if timeline_idx > 0:
+                parts.append(content[:timeline_idx].strip())
+            else:
+                parts.append(content[:500])
+        parts.append("")
+
+    if not parts:
+        return f"No context found for project '{project}'. Create a Knowledge.md to get started."
+
+    return "\n".join(parts)

package/kyp_mem/static/index.html

@@ -10,33 +10,33 @@
 <script src="https://cdn.jsdelivr.net/npm/d3@7/dist/d3.min.js"></script>
 <style>
 :root {
-  --bg-void: #08080f;
-  --bg-primary: #0c0c16;
-  --bg-secondary: #0e0e1a;
-  --bg-tertiary: #070710;
-  --bg-hover: #121224;
-  --bg-active: #181836;
-  --bg-card: #101020;
-  --bg-surface: #0a0a15;
-
-  --neon-cyan: #00e8df;
-  --neon-green: #34d399;
-  --neon-magenta: #e879f9;
+  --bg-void: #09090b;
+  --bg-primary: #0d0d10;
+  --bg-secondary: #0f0f12;
+  --bg-tertiary: #08080a;
+  --bg-hover: #15151c;
+  --bg-active: #1c1c26;
+  --bg-card: #111116;
+  --bg-surface: #0b0b0e;
+
+  --neon-cyan: #D97757;
+  --neon-green: #5bb98c;
+  --neon-magenta: #c47ad7;
   --neon-purple: #a78bfa;
-  --neon-orange: #fb923c;
-  --neon-yellow: #fbbf24;
-  --neon-blue: #60a5fa;
-  --neon-red: #f87171;
+  --neon-orange: #e8935a;
+  --neon-yellow: #d4a853;
+  --neon-blue: #7da8d4;
+  --neon-red: #d47171;
 
-  --glow-cyan: 0 0 8px #00e8df30;
-  --glow-green: 0 0 8px #34d39930;
-  --glow-magenta: 0 0 8px #e879f930;
+  --glow-cyan: 0 0 8px #D9775730;
+  --glow-green: 0 0 8px #5bb98c30;
+  --glow-magenta: 0 0 8px #c47ad730;
 
-  --text-primary: #d4d4e8;
-  --text-secondary: #7a7a9a;
-  --text-muted: #3e3e5c;
-  --border: #16162a;
-  --border-subtle: #121225;
+  --text-primary: #d8d5cf;
+  --text-secondary: #807b73;
+  --text-muted: #44413a;
+  --border: #1c1a17;
+  --border-subtle: #16150f;
 
   --font: 'Inter', -apple-system, sans-serif;
   --font-mono: 'JetBrains Mono', monospace;
@@ -62,8 +62,8 @@ body::before {
   position: fixed;
   inset: 0;
   background-image:
-    linear-gradient(rgba(0,232,223,0.015) 1px, transparent 1px),
-    linear-gradient(90deg, rgba(0,232,223,0.015) 1px, transparent 1px);
+    linear-gradient(rgba(217,119,87,0.015) 1px, transparent 1px),
+    linear-gradient(90deg, rgba(217,119,87,0.015) 1px, transparent 1px);
   background-size: 48px 48px;
   pointer-events: none;
   z-index: 0;
@@ -103,7 +103,7 @@ body::before {
 .resize-handle:hover,
 .resize-handle.dragging {
   background: var(--neon-cyan);
-  box-shadow: 0 0 12px rgba(0,232,223,0.2);
+  box-shadow: 0 0 12px rgba(217,119,87,0.2);
 }
 
 body.resizing { cursor: col-resize !important; user-select: none !important; }
@@ -191,9 +191,9 @@ body.resizing .resize-handle { pointer-events: auto !important; }
 }
 
 .header-btn.active {
-  border-color: rgba(0,232,223,0.3);
+  border-color: rgba(217,119,87,0.3);
   color: var(--neon-cyan);
-  background: rgba(0,232,223,0.05);
+  background: rgba(217,119,87,0.05);
 }
 
 .header-btn .dot {
@@ -229,8 +229,8 @@ body.resizing .resize-handle { pointer-events: auto !important; }
 .search-box input::placeholder { color: var(--text-muted); }
 
 .search-box input:focus {
-  border-color: rgba(0,232,223,0.3);
-  box-shadow: 0 0 16px rgba(0,232,223,0.08);
+  border-color: rgba(217,119,87,0.3);
+  box-shadow: 0 0 16px rgba(217,119,87,0.08);
   width: 260px;
 }
 
@@ -434,7 +434,7 @@ body.resizing .resize-handle { pointer-events: auto !important; }
 .tree-item:hover { background: var(--bg-hover); }
 
 .tree-item.active {
-  background: rgba(0,232,223,0.05);
+  background: rgba(217,119,87,0.05);
 }
 
 .tree-item.active::before {
@@ -523,9 +523,9 @@ body.resizing .resize-handle { pointer-events: auto !important; }
   font-size: 9px;
   padding: 2px 7px;
   border-radius: var(--radius-sm);
-  background: rgba(0,232,223,0.08);
+  background: rgba(217,119,87,0.08);
   color: var(--neon-cyan);
-  border: 1px solid rgba(0,232,223,0.2);
+  border: 1px solid rgba(217,119,87,0.2);
   cursor: pointer;
   display: flex;
   align-items: center;
@@ -533,7 +533,7 @@ body.resizing .resize-handle { pointer-events: auto !important; }
   transition: all 0.15s;
 }
 
-.active-tag:hover { background: rgba(0,232,223,0.15); }
+.active-tag:hover { background: rgba(217,119,87,0.15); }
 .active-tag .remove { font-size: 11px; opacity: 0.5; }
 .active-tag .remove:hover { opacity: 1; }
 
@@ -566,9 +566,9 @@ body.resizing .resize-handle { pointer-events: auto !important; }
 }
 
 .tag-chip.selected {
-  background: rgba(0,232,223,0.08);
+  background: rgba(217,119,87,0.08);
   color: var(--neon-cyan);
-  border-color: rgba(0,232,223,0.2);
+  border-color: rgba(217,119,87,0.2);
 }
 
 .tag-chip .tag-count {
@@ -637,9 +637,9 @@ body.resizing .resize-handle { pointer-events: auto !important; }
 }
 
 .tag.clickable-tag:hover {
-  background: rgba(0,232,223,0.08);
+  background: rgba(217,119,87,0.08);
   color: var(--neon-cyan);
-  border-color: rgba(0,232,223,0.2);
+  border-color: rgba(217,119,87,0.2);
   cursor: pointer;
 }
 
@@ -783,7 +783,7 @@ body.resizing .resize-handle { pointer-events: auto !important; }
 
 .wikilink:hover {
   color: var(--neon-cyan);
-  border-bottom-color: rgba(0,232,223,0.4);
+  border-bottom-color: rgba(217,119,87,0.4);
 }
 
 /* ============ EMPTY STATE ============ */
@@ -939,13 +939,13 @@ body.resizing .resize-handle { pointer-events: auto !important; }
 
 .graph-node:hover circle {
   fill: var(--neon-cyan);
-  filter: drop-shadow(0 0 4px rgba(0,232,223,0.5));
+  filter: drop-shadow(0 0 4px rgba(217,119,87,0.5));
 }
 
 .graph-node.active circle {
   fill: var(--neon-cyan);
   r: 6;
-  filter: drop-shadow(0 0 6px rgba(0,232,223,0.5));
+  filter: drop-shadow(0 0 6px rgba(217,119,87,0.5));
 }
 
 .graph-node text {
@@ -959,6 +959,196 @@ body.resizing .resize-handle { pointer-events: auto !important; }
   stroke-width: 1;
 }
 
+.graph-size-controls {
+  margin-left: auto;
+  display: flex;
+  gap: 2px;
+}
+
+.graph-size-btn {
+  background: var(--bg-hover);
+  border: 1px solid var(--border);
+  color: var(--text-muted);
+  font-family: var(--font-mono);
+  font-size: 11px;
+  width: 18px;
+  height: 18px;
+  border-radius: 3px;
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  transition: all 0.15s;
+  padding: 0;
+  line-height: 1;
+}
+
+.graph-size-btn:hover {
+  border-color: var(--neon-cyan);
+  color: var(--neon-cyan);
+}
+
+.graph-resize-handle {
+  height: 8px;
+  cursor: ns-resize;
+  position: relative;
+}
+
+.graph-resize-handle::after {
+  content: '';
+  position: absolute;
+  bottom: 2px;
+  left: 50%;
+  transform: translateX(-50%);
+  width: 24px;
+  height: 2px;
+  background: var(--border);
+  border-radius: 1px;
+  transition: background 0.2s;
+}
+
+.graph-resize-handle:hover::after {
+  background: var(--neon-cyan);
+}
+
+/* ============ SESSIONS ============ */
+.session-folder-icon { color: var(--neon-green) !important; }
+
+.session-add-btn {
+  background: transparent;
+  border: 1px solid var(--border);
+  color: var(--text-muted);
+  font-family: var(--font-mono);
+  font-size: 11px;
+  width: 16px;
+  height: 16px;
+  border-radius: 3px;
+  cursor: pointer;
+  margin-left: auto;
+  display: none;
+  align-items: center;
+  justify-content: center;
+  transition: all 0.15s;
+  padding: 0;
+  line-height: 1;
+}
+
+.tree-item:hover .session-add-btn { display: flex; }
+
+.session-add-btn:hover {
+  border-color: var(--neon-green);
+  color: var(--neon-green);
+}
+
+.session-badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  font-family: var(--font-mono);
+  font-size: 10px;
+  color: var(--neon-green);
+  background: rgba(91,185,140,0.08);
+  border: 1px solid rgba(91,185,140,0.15);
+  padding: 4px 12px;
+  border-radius: var(--radius);
+  margin-bottom: 16px;
+  letter-spacing: 0.5px;
+}
+
+.session-create-overlay {
+  position: fixed;
+  inset: 0;
+  background: rgba(6,6,12,0.75);
+  z-index: 200;
+  display: none;
+  align-items: center;
+  justify-content: center;
+  backdrop-filter: blur(4px);
+}
+
+.session-create-overlay.active { display: flex; }
+
+.session-create-modal {
+  width: 420px;
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-lg);
+  box-shadow: 0 20px 60px rgba(0,0,0,0.6);
+  overflow: hidden;
+}
+
+.session-create-header {
+  padding: 16px 20px 12px;
+  border-bottom: 1px solid var(--border-subtle);
+  font-family: var(--font-mono);
+  font-size: 11px;
+  font-weight: 600;
+  color: var(--text-secondary);
+  letter-spacing: 0.5px;
+}
+
+.session-create-body {
+  padding: 16px 20px;
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+
+.session-field label {
+  display: block;
+  font-family: var(--font-mono);
+  font-size: 9px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 1px;
+  color: var(--text-muted);
+  margin-bottom: 4px;
+}
+
+.session-field select,
+.session-field input,
+.session-field textarea {
+  width: 100%;
+  background: var(--bg-surface);
+  border: 1px solid var(--border);
+  color: var(--text-primary);
+  font-family: var(--font-mono);
+  font-size: 12px;
+  padding: 8px 12px;
+  border-radius: var(--radius);
+  outline: none;
+  transition: border-color 0.2s;
+}
+
+.session-field select:focus,
+.session-field input:focus,
+.session-field textarea:focus {
+  border-color: rgba(217,119,87,0.3);
+}
+
+.session-field textarea {
+  min-height: 60px;
+  resize: vertical;
+}
+
+.session-create-footer {
+  padding: 12px 20px;
+  border-top: 1px solid var(--border-subtle);
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+}
+
+.session-create-footer .edit-btn.create {
+  background: rgba(91,185,140,0.1);
+  color: var(--neon-green);
+  border-color: rgba(91,185,140,0.3);
+}
+
+.session-create-footer .edit-btn.create:hover {
+  background: rgba(91,185,140,0.2);
+}
+
 /* ============ SCROLLBAR ============ */
 ::-webkit-scrollbar { width: 4px; }
 ::-webkit-scrollbar-track { background: transparent; }
@@ -1025,12 +1215,12 @@ body.resizing .resize-handle { pointer-events: auto !important; }
 .edit-btn.cancel:hover { color: var(--text-secondary); border-color: var(--text-muted); }
 
 .edit-btn.save {
-  background: rgba(0,232,223,0.1);
+  background: rgba(217,119,87,0.1);
   color: var(--neon-cyan);
-  border-color: rgba(0,232,223,0.3);
+  border-color: rgba(217,119,87,0.3);
 }
 
-.edit-btn.save:hover { background: rgba(0,232,223,0.2); }
+.edit-btn.save:hover { background: rgba(217,119,87,0.2); }
 
 .edit-textarea {
   flex: 1;
@@ -1112,6 +1302,9 @@ body.resizing .resize-handle { pointer-events: auto !important; }
         <span class="dot"></span>
         <span>GRAPH</span>
       </button>
+      <button class="header-btn" id="new-project-btn" title="New project">
+        <span>+ PROJECT</span>
+      </button>
       <div class="search-box">
         <span class="search-icon">&#9906;</span>
         <input type="text" id="search-input" placeholder="Search...">
@@ -1164,8 +1357,9 @@ body.resizing .resize-handle { pointer-events: auto !important; }
   <!-- Right panel -->
   <div class="right-panel" id="right-panel">
     <div id="graph-section">
-      <div class="rp-section-title">Local Graph</div>
+      <div class="rp-section-title">Local Graph <span class="graph-size-controls"><button class="graph-size-btn" id="graph-shrink" title="Shrink graph">&minus;</button><button class="graph-size-btn" id="graph-grow" title="Grow graph">+</button></span></div>
       <div id="graph-container"></div>
+      <div id="graph-resize-handle" class="graph-resize-handle"></div>
     </div>
     <div id="rp-outline" class="rp-section" style="display:none;">
       <div class="rp-section-title">Outline <span class="rp-count" id="outline-count"></span></div>
@@ -1212,11 +1406,55 @@ body.resizing .resize-handle { pointer-events: auto !important; }
   </div>
 </div>
 
+<!-- Session Create Modal -->
+<div class="session-create-overlay" id="session-create-overlay">
+  <div class="session-create-modal">
+    <div class="session-create-header">NEW SESSION</div>
+    <div class="session-create-body">
+      <div class="session-field">
+        <label>Project</label>
+        <input type="text" id="session-project" list="project-list" placeholder="Project name...">
+        <datalist id="project-list"></datalist>
+      </div>
+      <div class="session-field">
+        <label>Summary</label>
+        <textarea id="session-summary" placeholder="What are you working on?"></textarea>
+      </div>
+    </div>
+    <div class="session-create-footer">
+      <button class="edit-btn cancel" id="session-cancel">CANCEL</button>
+      <button class="edit-btn create" id="session-create-btn">CREATE</button>
+    </div>
+  </div>
+</div>
+
+<!-- Project Create Modal -->
+<div class="session-create-overlay" id="project-create-overlay">
+  <div class="session-create-modal">
+    <div class="session-create-header">NEW PROJECT</div>
+    <div class="session-create-body">
+      <div class="session-field">
+        <label>Project Name</label>
+        <input type="text" id="project-name-input" placeholder="My Project...">
+      </div>
+      <div class="session-field">
+        <label>Overview (optional)</label>
+        <textarea id="project-overview-input" placeholder="Brief project description, goals, tech stack..."></textarea>
+      </div>
+    </div>
+    <div class="session-create-footer">
+      <button class="edit-btn cancel" id="project-cancel">CANCEL</button>
+      <button class="edit-btn create" id="project-create-btn">CREATE</button>
+    </div>
+  </div>
+</div>
+
 <script>
 let currentPath = null;
 let treeData = null;
 let allNotes = {};
 let graphVisible = true;
+let currentNote = null;
 let activeTagFilters = new Set();
 let qsSelectedIndex = 0;
 
@@ -1255,6 +1493,8 @@ document.addEventListener('keydown', (e) => {
   }
   if (e.key === 'Escape') {
     closeQuickSwitcher();
+    closeSessionCreate();
+    closeProjectCreate();
   }
 });
 
@@ -1351,16 +1591,27 @@ function updateQsSelection() {
 }
 
 // --- File Tree ---
-function renderTree(node, container) {
+function renderTree(node, container, parentFolder) {
   if (node.type === 'folder' && node.name !== 'vault') {
+    const isSessionsFolder = node.name === 'Sessions';
     const item = document.createElement('div');
     item.className = 'tree-item';
-    item.innerHTML = `<span class="arrow open">&#9654;</span><span class="icon folder-icon">&#9776;</span><span class="name">${node.name}</span>`;
+
+    if (isSessionsFolder) {
+      item.innerHTML = `<span class="arrow open">&#9654;</span><span class="icon session-folder-icon">&#9716;</span><span class="name">Sessions</span><button class="session-add-btn" data-project="${parentFolder || ''}" title="New session">+</button>`;
+    } else {
+      item.innerHTML = `<span class="arrow open">&#9654;</span><span class="icon folder-icon">&#9776;</span><span class="name">${node.name}</span>`;
+    }
 
     const children = document.createElement('div');
     children.className = 'tree-children';
 
     item.addEventListener('click', (e) => {
+      if (e.target.classList.contains('session-add-btn')) {
+        e.stopPropagation();
+        openSessionCreate(e.target.dataset.project);
+        return;
+      }
       e.stopPropagation();
       item.querySelector('.arrow').classList.toggle('open');
       children.classList.toggle('collapsed');
@@ -1368,13 +1619,30 @@ function renderTree(node, container) {
 
     container.appendChild(item);
     container.appendChild(children);
-    (node.children || []).forEach(c => renderTree(c, children));
+    (node.children || []).forEach(c => renderTree(c, children, node.name));
 
   } else if (node.type === 'note') {
     const item = document.createElement('div');
     item.className = 'tree-item';
     item.dataset.path = node.path;
-    item.innerHTML = `<span class="arrow" style="visibility:hidden">&#9654;</span><span class="icon note-icon">&#9671;</span><span class="name">${node.name.replace('.md', '')}</span>`;
+
+    const isSessionNote = node.path.includes('/Sessions/') || node.path.startsWith('Sessions/');
+    let displayName = node.name.replace('.md', '');
+
+    if (isSessionNote) {
+      const match = displayName.match(/^(\d{4})-(\d{2})-(\d{2})_(\d{2})(\d{2})(\d{2})$/);
+      if (match) {
+        const [, y, mo, d, h, mi] = match;
+        const hr = parseInt(h);
+        const ampm = hr >= 12 ? 'PM' : 'AM';
+        const hr12 = hr % 12 || 12;
+        const months = ['Jan','Feb','Mar','Apr','May','Jun','Jul','Aug','Sep','Oct','Nov','Dec'];
+        displayName = `${months[parseInt(mo)-1]} ${parseInt(d)}, ${hr12}:${mi} ${ampm}`;
+        item.title = node.name.replace('.md', '');
+      }
+    }
+
+    item.innerHTML = `<span class="arrow" style="visibility:hidden">&#9654;</span><span class="icon note-icon">&#9671;</span><span class="name">${displayName}</span>`;
     item.addEventListener('click', () => loadNote(node.path));
     container.appendChild(item);
 
@@ -1388,6 +1656,7 @@ async function loadNote(path) {
   currentPath = path;
   const note = await fetchJSON(`/api/note/${path}`);
   if (note.error) return;
+  currentNote = note;
 
   document.querySelectorAll('.tree-item').forEach(el => {
     el.classList.toggle('active', el.dataset.path === path);
@@ -1404,6 +1673,13 @@ async function loadNote(path) {
   let html = '<div class="fade-in">';
 
   html += `<button class="note-edit-btn" onclick="openEditor('${path}')">EDIT</button>`;
+
+  const isSession = path.includes('/Sessions/') || path.startsWith('Sessions/');
+  if (isSession) {
+    const sessionProject = path.includes('/Sessions/') ? path.split('/Sessions/')[0] : 'General';
+    html += `<div class="session-badge">&#9716; SESSION &middot; ${sessionProject}</div>`;
+  }
+
   html += '<div class="note-properties">';
   (note.tags || []).forEach(t => { html += `<span class="tag clickable-tag" data-tag="${t}">#${t}</span>`; });
   Object.entries(note.properties || {}).forEach(([k, v]) => {
@@ -1619,6 +1895,134 @@ document.addEventListener('keydown', (e) => {
   }
 });
 
+// --- Session Management ---
+function openSessionCreate(defaultProject) {
+  const overlay = document.getElementById('session-create-overlay');
+  const projectInput = document.getElementById('session-project');
+  const datalist = document.getElementById('project-list');
+  const summaryInput = document.getElementById('session-summary');
+
+  const projects = new Set();
+  for (const path of Object.keys(allNotes)) {
+    const parts = path.split('/');
+    if (parts.length > 1) projects.add(parts[0]);
+  }
+
+  datalist.innerHTML = '';
+  for (const p of [...projects].sort()) {
+    const opt = document.createElement('option');
+    opt.value = p;
+    datalist.appendChild(opt);
+  }
+
+  projectInput.value = defaultProject || '';
+  summaryInput.value = '';
+  overlay.classList.add('active');
+
+  if (defaultProject) summaryInput.focus();
+  else projectInput.focus();
+}
+
+function closeSessionCreate() {
+  document.getElementById('session-create-overlay').classList.remove('active');
+}
+
+document.getElementById('session-cancel').addEventListener('click', closeSessionCreate);
+document.getElementById('session-create-overlay').addEventListener('click', (e) => {
+  if (e.target === e.currentTarget) closeSessionCreate();
+});
+
+document.getElementById('session-create-btn').addEventListener('click', async () => {
+  const project = document.getElementById('session-project').value.trim();
+  const summary = document.getElementById('session-summary').value.trim();
+
+  if (!project) {
+    document.getElementById('session-project').focus();
+    return;
+  }
+
+  const resp = await fetch('/api/sessions/create', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ project, summary }),
+  });
+
+  const result = await resp.json();
+  if (result.ok) {
+    closeSessionCreate();
+    await refreshTree();
+    loadNote(result.path);
+  }
+});
+
+// --- Project Management ---
+function closeProjectCreate() {
+  document.getElementById('project-create-overlay').classList.remove('active');
+}
+
+document.getElementById('new-project-btn').addEventListener('click', () => {
+  document.getElementById('project-create-overlay').classList.add('active');
+  document.getElementById('project-name-input').value = '';
+  document.getElementById('project-overview-input').value = '';
+  document.getElementById('project-name-input').focus();
+});
+
+document.getElementById('project-cancel').addEventListener('click', closeProjectCreate);
+document.getElementById('project-create-overlay').addEventListener('click', (e) => {
+  if (e.target === e.currentTarget) closeProjectCreate();
+});
+
+document.getElementById('project-create-btn').addEventListener('click', async () => {
+  const name = document.getElementById('project-name-input').value.trim();
+  const overview = document.getElementById('project-overview-input').value.trim();
+  if (!name) {
+    document.getElementById('project-name-input').focus();
+    return;
+  }
+  const resp = await fetch('/api/projects/create', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ name, overview }),
+  });
+  const result = await resp.json();
+  if (result.ok) {
+    closeProjectCreate();
+    await refreshTree();
+    loadNote(result.path);
+  }
+});
+
+async function refreshTree() {
+  treeData = await fetchJSON('/api/tree');
+  allNotes = {};
+  function walk(node) {
+    if (node.type === 'note') {
+      allNotes[node.path] = { title: node.name.replace('.md', ''), tags: node.tags || [] };
+    }
+    (node.children || []).forEach(walk);
+  }
+  walk(treeData);
+
+  const treeEl = document.getElementById('file-tree');
+  treeEl.innerHTML = '';
+  renderTree(treeData, treeEl);
+  renderTagCloud(collectAllTags());
+
+  const stats = await fetchJSON('/api/stats');
+  document.getElementById('stats-bar').innerHTML = `
+    <span><span class="stat-val">${stats.notes}</span> notes</span>
+    <span><span class="stat-val">${stats.folders}</span> folders</span>
+    <span><span class="stat-val">${stats.tags}</span> tags</span>
+    <span><span class="stat-val">${stats.links}</span> links</span>
+  `;
+
+  if (currentPath) {
+    document.querySelectorAll('.tree-item').forEach(el => {
+      el.classList.toggle('active', el.dataset.path === currentPath);
+    });
+  }
+}
+
 // --- Graph ---
 function renderGraph(note) {
   const container = document.getElementById('graph-container');
@@ -1638,60 +2042,126 @@ function renderGraph(note) {
     if (path) links.push({ source: note.path, target: path });
   });
 
-  (note.backlinks || []).forEach(path => {
-    if (!nodes.has(path)) {
-      const n = allNotes[path];
-      nodes.set(path, { id: path, title: n ? n.title : path, active: false });
+  (note.backlinks || []).forEach(bl => {
+    const blPath = typeof bl === 'string' ? bl : (bl && bl.path);
+    if (!blPath) return;
+    if (!nodes.has(blPath)) {
+      const n = allNotes[blPath];
+      const title = (bl && typeof bl === 'object' && bl.title) ? bl.title : (n ? n.title : blPath);
+      nodes.set(blPath, { id: blPath, title, active: false });
     }
-    links.push({ source: path, target: note.path });
+    links.push({ source: blPath, target: note.path });
   });
 
   (note.related || []).forEach(r => {
     if (!nodes.has(r.path)) {
       nodes.set(r.path, { id: r.path, title: r.title, active: false });
     }
+    links.push({ source: note.path, target: r.path, dashed: true });
   });
 
   const nodeArray = Array.from(nodes.values());
   if (nodeArray.length < 2) {
-    container.innerHTML = '<svg></svg>';
+    container.innerHTML = '<div style="display:flex;align-items:center;justify-content:center;height:100%;color:var(--text-muted);font-size:10px;font-family:var(--font-mono)">No connections</div>';
     return;
   }
 
-  const width = container.clientWidth;
-  const height = container.clientHeight;
+  const width = container.clientWidth || 248;
+  const height = container.clientHeight || 200;
+  const margin = 24;
 
   const svg = d3.select(container).append('svg')
     .attr('viewBox', `0 0 ${width} ${height}`);
 
+  const g = svg.append('g');
+
+  svg.call(d3.zoom()
+    .scaleExtent([0.3, 3])
+    .on('zoom', (event) => g.attr('transform', event.transform))
+  );
+
   const simulation = d3.forceSimulation(nodeArray)
-    .force('link', d3.forceLink(links).id(d => d.id).distance(50))
-    .force('charge', d3.forceManyBody().strength(-100))
+    .force('link', d3.forceLink(links).id(d => d.id).distance(60))
+    .force('charge', d3.forceManyBody().strength(-120))
     .force('center', d3.forceCenter(width / 2, height / 2))
-    .force('collision', d3.forceCollide().radius(22));
+    .force('collision', d3.forceCollide().radius(25));
 
-  const link = svg.selectAll('.graph-link')
+  const linkEl = g.selectAll('.graph-link')
     .data(links).enter().append('line')
-    .attr('class', 'graph-link');
+    .attr('class', 'graph-link')
+    .attr('stroke-dasharray', d => d.dashed ? '3,3' : null)
+    .style('opacity', d => d.dashed ? 0.5 : 1);
 
-  const node = svg.selectAll('.graph-node')
+  const node = g.selectAll('.graph-node')
     .data(nodeArray).enter().append('g')
     .attr('class', d => 'graph-node' + (d.active ? ' active' : ''))
-    .on('click', (e, d) => loadNote(d.id))
+    .on('click', (e, d) => { e.stopPropagation(); loadNote(d.id); })
     .call(d3.drag()
       .on('start', (e, d) => { if (!e.active) simulation.alphaTarget(0.3).restart(); d.fx = d.x; d.fy = d.y; })
       .on('drag', (e, d) => { d.fx = e.x; d.fy = e.y; })
       .on('end', (e, d) => { if (!e.active) simulation.alphaTarget(0); d.fx = null; d.fy = null; })
     );
 
-  node.append('circle').attr('r', d => d.active ? 5 : 3.5);
+  node.append('circle').attr('r', d => d.active ? 6 : 4);
   node.append('text').text(d => d.title).attr('dx', 10).attr('dy', 3);
 
   simulation.on('tick', () => {
-    link
+    linkEl
       .attr('x1', d => d.source.x).attr('y1', d => d.source.y)
       .attr('x2', d => d.target.x).attr('y2', d => d.target.y);
-    node.attr('transform', d => `translate(${d.x},${d.y})`);
+    node.attr('transform', d => {
+      d.x = Math.max(margin, Math.min(width - margin, d.x));
+      d.y = Math.max(margin, Math.min(height - margin, d.y));
+      return `translate(${d.x},${d.y})`;
+    });
+  });
+}
+
+// --- Graph Resize ---
+let graphHeight = parseInt(localStorage.getItem('kyp-graph-h')) || 200;
+
+function initGraphResize() {
+  const container = document.getElementById('graph-container');
+  container.style.height = graphHeight + 'px';
+
+  document.getElementById('graph-shrink').addEventListener('click', () => {
+    graphHeight = Math.max(100, graphHeight - 50);
+    container.style.height = graphHeight + 'px';
+    localStorage.setItem('kyp-graph-h', graphHeight);
+    if (graphVisible && currentNote) renderGraph(currentNote);
+  });
+
+  document.getElementById('graph-grow').addEventListener('click', () => {
+    graphHeight = Math.min(600, graphHeight + 50);
+    container.style.height = graphHeight + 'px';
+    localStorage.setItem('kyp-graph-h', graphHeight);
+    if (graphVisible && currentNote) renderGraph(currentNote);
+  });
+
+  const handle = document.getElementById('graph-resize-handle');
+  handle.addEventListener('mousedown', (e) => {
+    e.preventDefault();
+    const startY = e.clientY;
+    const startH = graphHeight;
+    document.body.style.cursor = 'ns-resize';
+    document.body.style.userSelect = 'none';
+
+    function onMove(ev) {
+      graphHeight = Math.max(100, Math.min(600, startH + (ev.clientY - startY)));
+      container.style.height = graphHeight + 'px';
+    }
+
+    function onUp() {
+      document.body.style.cursor = '';
+      document.body.style.userSelect = '';
+      localStorage.setItem('kyp-graph-h', graphHeight);
+      if (graphVisible && currentNote) renderGraph(currentNote);
+      document.removeEventListener('mousemove', onMove);
+      document.removeEventListener('mouseup', onUp);
+    }
+
+    document.addEventListener('mousemove', onMove);
+    document.addEventListener('mouseup', onUp);
   });
 }
 
@@ -1930,6 +2400,7 @@ async function init() {
 }
 
 initResize();
+initGraphResize();
 init();
 </script>
 </body>

package/kyp_mem/ui.py

@@ -1,6 +1,7 @@
 """KYP-MEM web UI — interactive interface for browsing the vault."""
 
 import webbrowser
+from datetime import datetime
 from pathlib import Path
 from fastapi import FastAPI, Request
 from fastapi.responses import HTMLResponse, JSONResponse
@@ -119,6 +120,94 @@ def create_app(vault_path: str = None) -> FastAPI:
         vault.write_note(path, content, tags, props)
         return JSONResponse({"ok": True, "path": path})
 
+    @app.post("/api/sessions/create")
+    async def create_session(request: Request):
+        body = await request.json()
+        project = body.get("project", "").strip()
+        summary = body.get("summary", "").strip()
+        if not project:
+            return JSONResponse({"error": "Project name required"}, 400)
+        session_id = datetime.now().strftime("%Y-%m-%d_%H%M%S")
+        content = (
+            f"# Session {session_id}\n\n"
+            f"**Project:** {project}\n\n"
+            f"## Summary\n{summary}\n\n"
+            f"## INVESTIGATED\n\n\n"
+            f"## LEARNED\n\n\n"
+            f"## COMPLETED\n\n\n"
+            f"## NEXT STEPS\n\n"
+        )
+        tags = ["session", "manual", project.lower().replace(" ", "-")]
+        path = f"{project}/Sessions/{session_id}.md"
+        vault.write_note(path, content, tags, {})
+        return JSONResponse({"ok": True, "path": path})
+
+    @app.get("/api/sessions")
+    def list_sessions(project: str = ""):
+        sessions = {}
+        for path, note in vault.index.notes.items():
+            if "/Sessions/" not in path and not path.startswith("Sessions/"):
+                continue
+            parts = path.split("/")
+            idx = parts.index("Sessions") if "Sessions" in parts else -1
+            proj = "/".join(parts[:idx]) if idx > 0 else "(root)"
+            if project and proj.lower() != project.lower():
+                continue
+            if proj not in sessions:
+                sessions[proj] = []
+            sessions[proj].append({
+                "path": path,
+                "title": note.title,
+                "tags": note.tags,
+                "created": note.created,
+                "updated": note.updated,
+            })
+        for proj in sessions:
+            sessions[proj].sort(key=lambda s: s["path"], reverse=True)
+        return JSONResponse(sessions)
+
+    @app.get("/api/projects")
+    def list_projects():
+        projects = set()
+        for path in vault.index.notes:
+            parts = path.split("/")
+            if len(parts) > 1:
+                projects.add(parts[0])
+        result = []
+        for proj in sorted(projects):
+            session_count = sum(1 for p in vault.index.notes if p.startswith(f"{proj}/Sessions/"))
+            result.append({"name": proj, "session_count": session_count})
+        return JSONResponse(result)
+
+    @app.delete("/api/note/{path:path}")
+    def delete_note(path: str):
+        if vault.delete(path):
+            return JSONResponse({"ok": True})
+        return JSONResponse({"error": "Not found"}, 404)
+
+    @app.post("/api/projects/create")
+    async def create_project(request: Request):
+        body = await request.json()
+        name = body.get("name", "").strip()
+        overview = body.get("overview", "").strip()
+        if not name:
+            return JSONResponse({"error": "Project name required"}, 400)
+        path = f"{name}/Knowledge.md"
+        if vault.read(path):
+            return JSONResponse({"error": "Project already exists"}, 409)
+        content = (
+            f"# {name}\n\n"
+            f"## Overview\n{overview or '(Project description, goals, tech stack)'}\n\n"
+            f"## Architecture\n(System design, key components, data flow)\n\n"
+            f"## Bugs\n### Known\n\n### Fixed\n\n\n"
+            f"## Improvements\n### Planned\n\n### Completed\n\n\n"
+            f"## Key Decisions\n(Important architectural or design decisions)\n\n"
+            f"## Notes\n(Miscellaneous project knowledge)\n"
+        )
+        tags = ["project", "knowledge", name.lower().replace(" ", "-")]
+        vault.write_note(path, content, tags, {})
+        return JSONResponse({"ok": True, "path": path})
+
     @app.post("/api/reload")
     def reload():
         vault._load_all()

package/package.json

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

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "kyp-mem"
-version = "0.3.0"
+version = "0.4.0"
 description = "Know Your Project — Persistent knowledge base for AI agents. MCP-powered with wikilinks, backlinks, auto-learning, and neon web UI."
 readme = "README.md"
 license = {text = "MIT"}