opencode-fractal-memory 0.6.13 → 0.6.15

package/README.md

@@ -377,12 +377,18 @@ Opens at [http://localhost:8787](http://localhost:8787). The server starts as a
 - **Scroll** to zoom in/out
 - **Left-click** a node to select and inspect it
 - **Right-click drag** to pan
-- Nodes are color-coded by type (note, skill, playbook, rule)
-
-**Search** — find nodes by content, label, or type:
-- Type a query and press Enter
-- Results show relevance scores and preview snippets
-- Click a result to navigate to it in the graph
+- Nodes are color-coded by level and type (skill = gold icosahedron, playbook = orange torus, note = blue sphere)
+- Playbook nodes render as orange torus shapes with steps visible in the detail panel
+
+**Filters** — narrow down visible nodes:
+- **Scope** (global/project)
+- **Level** (L0–L5), **Type** (note, skill, playbook, etc.), **Shape**, **Custom Type**
+- **Project** — when multiple projects exist, filter by project name
+- **Clear All Filters** button resets everything at once
+- **Search** — find nodes by content, label, or type:
+  - Type a query and press Enter
+  - Results show relevance scores and preview snippets
+  - Click a result to navigate to it in the graph
 
 **Inspect** — when you click a node (graph or search results):
 - View full content and summary
@@ -506,3 +512,21 @@ Unified SQLite database with `project_name` discriminator:
 ## License
 
 MIT
+
+## Changelog
+
+### v0.6.15 (2026-06-06)
+- **Project switcher** — filter memory nodes by project name in management UI
+- **Clear all filters** — one-click reset of all active filters
+- **Playbook nodes** — now render as orange torus with step details in management UI
+- **TYPE_COLORS** — playbooks (orange) and skills (gold) have dedicated colors in 3D scene
+- Backend: `project_name` in API responses, `GET /api/projects` endpoint
+
+### v0.6.14 (2026-06-06)
+- Session reference counter fix — management server only stops when all sessions end
+
+### v0.6.13 (2026-06-06)
+- Event hook refactor — management server lifecycle tied to real `session.created`/`session.deleted` events
+
+### v0.6.12 (2026-06-06)
+- Fixed management server lifecycle — SIGKILL instead of SIGTERM, proper event hooks

package/dist/management/helpers.js

@@ -75,6 +75,7 @@ export function rowToNode(r) {
         parentIds: r.parent_ids ? JSON.parse(r.parent_ids) : null,
         contentLength: r.content_length,
         metadata: r.metadata ? JSON.parse(r.metadata) : null,
+        projectName: r.project_name ?? null,
     };
 }
 export function queryNodes(scope) {
@@ -85,7 +86,7 @@ export function queryNodes(scope) {
     SELECT id, label, content, summary, level, type, importance,
            usefulness_score, times_used, times_helpful, access_count,
            sticky, confidence, created_at, updated_at, parent_ids,
-           LENGTH(content) as content_length, metadata
+           LENGTH(content) as content_length, metadata, project_name
     FROM memory_nodes
     WHERE scope = ?
     ORDER BY level, importance DESC
@@ -169,6 +170,7 @@ export function computeStats(nodes) {
     const nodesPerType = {};
     const nodesPerCustomType = {};
     const nodesPerShape = {};
+    const nodesPerProject = {};
     let totalImportance = 0;
     let totalUsefulness = 0;
     let totalAccessCount = 0;
@@ -183,6 +185,8 @@ export function computeStats(nodes) {
         }
         const shape = resolveNodeShape(node);
         nodesPerShape[shape] = (nodesPerShape[shape] ?? 0) + 1;
+        const project = node.projectName || "(default)";
+        nodesPerProject[project] = (nodesPerProject[project] ?? 0) + 1;
         totalImportance += node.importance;
         totalUsefulness += node.usefulnessScore;
         totalAccessCount += node.accessCount;
@@ -196,12 +200,26 @@ export function computeStats(nodes) {
         nodesPerType,
         nodesPerCustomType,
         nodesPerShape,
+        nodesPerProject,
         avgImportance: Math.round((totalImportance / n) * 100) / 100,
         avgUsefulness: Math.round((totalUsefulness / n) * 100) / 100,
         totalAccessCount,
         stickyCount,
     };
 }
+export function getAvailableProjects(scope) {
+    const db = openDb(scope);
+    if (!db)
+        return [];
+    const rows = db.query(`
+    SELECT DISTINCT COALESCE(project_name, '') as project_name
+    FROM memory_nodes
+    WHERE scope = ?
+    ORDER BY project_name
+  `).all(scope);
+    db.close();
+    return rows.map(r => r.project_name || "(default)");
+}
 export function readProjectConfig() {
     const configPath = path.join(os.homedir(), ".config", "opencode", "opencode-mem.json");
     try {

package/dist/management/routes.js

@@ -1,6 +1,6 @@
 import { memLog } from "../logging";
 import { generateEmbedding } from "../embeddings";
-import { queryNodes, getAvailableScopes, extractLinks, computeStats, readProjectConfig, writeProjectConfig, rowToNode, withDb, jsonResponse, cosineSimilarity, } from "./helpers";
+import { queryNodes, getAvailableScopes, extractLinks, computeStats, readProjectConfig, writeProjectConfig, rowToNode, withDb, jsonResponse, cosineSimilarity, getAvailableProjects, } from "./helpers";
 function handleScopes() {
     return jsonResponse(getAvailableScopes());
 }
@@ -181,11 +181,15 @@ async function handleNodeDelete(ctx) {
         return jsonResponse({ success: true });
     });
 }
+function handleProjects(ctx) {
+    return jsonResponse(getAvailableProjects(ctx.scope));
+}
 export function registerRoutes(router) {
     router.get(/^\/api\/scopes$/, () => handleScopes());
     router.get(/^\/api\/nodes$/, (_, ctx) => handleNodes(ctx));
     router.get(/^\/api\/links$/, (_, ctx) => handleLinks(ctx));
     router.get(/^\/api\/stats$/, (_, ctx) => handleStats(ctx));
+    router.get(/^\/api\/projects$/, (_, ctx) => handleProjects(ctx));
     router.get(/^\/api\/config$/, () => handleConfigGet());
     router.put(/^\/api\/config$/, (req) => handleConfigSave(req));
     router.post(/^\/api\/config$/, (req) => handleConfigSave(req));

package/dist/plugin/hooks.js

@@ -2,6 +2,7 @@ import { memLog, memLogSimple, setSessionId } from "../logging";
 import { generateFileSummary, generateFileLabel, SOURCE_FILE_EXTENSIONS } from "../file-summary";
 import { distillRules, predictiveRateToolCall, applyScoreDecay } from "../hooks";
 import * as fs from "node:fs";
+let activeSessionCount = 0;
 export function createHookHandlers(store, client, memConfig, ruleCache, ruleCacheDirty, sessionInjectionLock, latestUserMessage, managementServer) {
     return {
         "experimental.chat.system.transform": async (input, output) => {
@@ -155,6 +156,7 @@ export function createHookHandlers(store, client, memConfig, ruleCache, ruleCach
                 const sessionId = properties.info?.id ?? "unknown";
                 await store.createSessionMetrics(sessionId);
                 setSessionId(sessionId);
+                activeSessionCount++;
                 managementServer.start();
             }
             else if (type === "session.idle") {
@@ -168,7 +170,10 @@ export function createHookHandlers(store, client, memConfig, ruleCache, ruleCach
                 }
             }
             else if (type === "session.deleted") {
-                managementServer.stop();
+                activeSessionCount = Math.max(0, activeSessionCount - 1);
+                if (activeSessionCount === 0) {
+                    managementServer.stop();
+                }
             }
         },
     };

package/management/public/app.js

@@ -17,9 +17,15 @@ const TYPE_SHAPES = {
   improvement: "sphere",
   howto: "sphere",
   skill: "icosahedron",
+  playbook: "torus",
   unknown: "sphere",
 };
 
+const TYPE_COLORS = {
+  skill: 0xfbbf24,
+  playbook: 0xff8c00,
+};
+
 const CUSTOM_TYPE_COLORS = {
   'middle-term': 0xff6b6b,
 };
@@ -36,6 +42,7 @@ class NodeFilterEngine {
     this.types = new Set();
     this.customTypes = new Set();
     this.shapes = new Set();
+    this.projects = new Set();
     this.searchQuery = "";
     this.searchMode = "text";
     this.serverSearchIds = null;
@@ -47,17 +54,31 @@ class NodeFilterEngine {
     this.types.clear();
     this.customTypes.clear();
     this.shapes.clear();
+    this.projects.clear();
 
     Object.keys(stats.nodesPerLevel || {}).map(Number).sort((a, b) => a - b).forEach(l => this.levels.add(l));
     Object.keys(stats.nodesPerType || {}).sort().forEach(t => this.types.add(t));
     Object.keys(stats.nodesPerCustomType || {}).sort().forEach(ct => this.customTypes.add(ct));
     Object.keys(stats.nodesPerShape || {}).sort().forEach(s => this.shapes.add(s));
+    Object.keys(stats.nodesPerProject || {}).sort().forEach(p => this.projects.add(p));
   }
 
   toggleLevel(v) { this._toggle(this.levels, v); this.changed(); }
   toggleType(v) { this._toggle(this.types, v); this.changed(); }
   toggleCustomType(v) { this._toggle(this.customTypes, v); this.changed(); }
   toggleShape(v) { this._toggle(this.shapes, v); this.changed(); }
+  toggleProject(v) { this._toggle(this.projects, v); this.changed(); }
+
+  clearAll() {
+    this.levels.clear();
+    this.types.clear();
+    this.customTypes.clear();
+    this.shapes.clear();
+    this.projects.clear();
+    this.searchQuery = "";
+    this.serverSearchIds = null;
+    this.changed();
+  }
 
   setSearchQuery(q) { this.searchQuery = (q || "").toLowerCase(); }
   setSearchMode(m) { this.searchMode = m; }
@@ -86,6 +107,11 @@ class NodeFilterEngine {
       if (!this.shapes.has(getNodeShape(node))) return false;
     }
 
+    if (this.projects.size > 0) {
+      const p = node.projectName || "(default)";
+      if (!this.projects.has(p)) return false;
+    }
+
     if (this.searchQuery) {
       if (this.searchMode === "text") {
         const q = this.searchQuery;
@@ -305,6 +331,9 @@ class SceneController {
       if (customType && CUSTOM_TYPE_COLORS[customType]) {
         color = CUSTOM_TYPE_COLORS[customType];
         shape = CUSTOM_TYPE_SHAPES[customType] ?? "sphere";
+      } else if (node.type && TYPE_COLORS[node.type]) {
+        color = TYPE_COLORS[node.type];
+        shape = TYPE_SHAPES[node.type] ?? "sphere";
       } else {
         color = LEVEL_COLORS[node.level] ?? 0x888888;
         shape = TYPE_SHAPES[node.type] ?? "sphere";
@@ -670,9 +699,23 @@ function setupEventListeners() {
     } else if (btn.dataset.shape !== undefined) {
       filterEngine.toggleShape(btn.dataset.shape);
       btn.classList.toggle("active");
+    } else if (btn.dataset.project !== undefined) {
+      filterEngine.toggleProject(btn.dataset.project);
+      btn.classList.toggle("active");
     }
   });
 
+  // Clear all filters button
+  document.getElementById("clear-filters").addEventListener("click", () => {
+    filterEngine.initFromStats(statsData);
+    filterEngine.setSearchQuery("");
+    filterEngine.setServerSearchIds(null);
+    document.getElementById("search-input").value = "";
+    document.getElementById("search-info").textContent = "";
+    buildFilters();
+    sceneCtrl.updateVisibility(filterEngine);
+  });
+
   // Search mode toggles
   document.querySelectorAll(".search-mode-btn").forEach(btn => {
     btn.addEventListener("click", () => {
@@ -920,6 +963,16 @@ function buildFilters() {
       `<button class="filter-btn active" data-shape="${s}">${shapeLabels[s] || s} (${statsData.nodesPerShape[s]})</button>`
     ).join("");
   }
+
+  // Project filters
+  const projects = Object.keys(statsData.nodesPerProject || {}).sort();
+  const projectContainer = document.getElementById("project-filters");
+  if (projectContainer && projects.length > 1) {
+    projectContainer.closest(".section").style.display = "block";
+    projectContainer.innerHTML = projects.map(p =>
+      `<button class="filter-btn active" data-project="${p}">${p} (${statsData.nodesPerProject[p]})</button>`
+    ).join("");
+  }
 }
 
 function buildLegend() {
@@ -937,6 +990,7 @@ function buildLegend() {
   html += `<div class="legend-item"><div class="legend-dot" style="background: #4a9eff; border-radius: 2px;"></div><span class="legend-label">Box = Event/Episode</span></div>`;
   html += `<div class="legend-item"><div class="legend-dot" style="background: #4a9eff; clip-path: polygon(50% 0%, 100% 50%, 50% 100%, 0% 50%);"></div><span class="legend-label">Diamond = Concept/Summary</span></div>`;
   html += `<div class="legend-item"><div class="legend-dot" style="background: #4a9eff; clip-path: polygon(50% 0%, 100% 38%, 82% 100%, 18% 100%, 0% 38%);"></div><span class="legend-label">Pentagon = Skill</span></div>`;
+  html += `<div class="legend-item"><div class="legend-dot" style="background: #ff8c00; border-radius: 50%;"></div><span class="legend-label">Torus = Playbook</span></div>`;
   html += `<div class="legend-item"><div class="legend-dot" style="background: #ff6b6b; border-radius: 50%;"></div><span class="legend-label">Torus = Middle-Term</span></div>`;
   html += `</div>`;
   legend.innerHTML = html;
@@ -971,6 +1025,9 @@ function buildNodeList() {
     if (node.type === 'skill') {
       customIndicator += ' <span style="color: #fbbf24; font-size: 10px;">[SKILL]</span>';
     }
+    if (node.type === 'playbook') {
+      customIndicator += ' <span style="color: #ff8c00; font-size: 10px;">[PLAYBOOK]</span>';
+    }
 
     return `
       <div class="node-list-item ${isSelected ? 'selected' : ''}" data-node-id="${node.id}">
@@ -1023,6 +1080,28 @@ function showDetailPanel(node) {
     `;
   }
 
+  let playbookHtml = "";
+  if (node.type === 'playbook') {
+    const steps = node.metadata?.steps;
+    let stepsHtml = "";
+    if (steps && Array.isArray(steps)) {
+      stepsHtml = steps.map((s, i) => `
+        <div style="padding: 6px 8px; margin-bottom: 4px; background: rgba(255,140,0,0.1); border-radius: 4px; border-left: 3px solid #ff8c00;">
+          <div style="font-size: 12px; color: #ff8c00; font-weight: 600;">Step ${i + 1}: ${escapeHtml(s.description || s.toolName || "Unnamed")}</div>
+          <div style="font-size: 11px; color: #aaa; margin-top: 2px;">Tool: ${escapeHtml(s.toolName || "none")}${s.critical ? ' <span style="color: #f44;">[CRITICAL]</span>' : ''}</div>
+        </div>
+      `).join("");
+    } else {
+      stepsHtml = '<div style="font-size: 12px; color: #888;">No steps defined in metadata</div>';
+    }
+    playbookHtml = `
+      <div class="detail-section">
+        <h4>Playbook Steps</h4>
+        ${stepsHtml}
+      </div>
+    `;
+  }
+
   content.innerHTML = `
     <div class="detail-section">
       <h4>ID</h4>
@@ -1043,6 +1122,7 @@ function showDetailPanel(node) {
     </div>
     ${metadataHtml}
     ${skillHtml}
+    ${playbookHtml}
     <div class="detail-section">
       <h4>Timestamps</h4>
       <div class="detail-value">Created: ${created}</div>

package/management/public/index.html

@@ -254,6 +254,15 @@
       <div class="filter-group" id="shape-filters"></div>
     </div>
 
+    <div class="section" style="display:none;">
+      <h3>Filter by Project</h3>
+      <div class="filter-group" id="project-filters"></div>
+    </div>
+
+    <div class="section">
+      <button class="search-btn" id="clear-filters" style="border-color: rgba(255,100,100,0.4); background: rgba(255,100,100,0.15);">Clear All Filters</button>
+    </div>
+
     <div class="section">
       <h3>Legend</h3>
       <div id="legend"></div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-fractal-memory",
-  "version": "0.6.13",
+  "version": "0.6.15",
   "description": "Fractal memory system for OpenCode with semantic search and automatic compression.",
   "main": "dist/plugin.js",
   "exports": {