opencode-fractal-memory 0.6.3 → 0.6.5

package/README.md

@@ -168,6 +168,8 @@ Create `~/.config/opencode/opencode-mem.json` to customize (optional — all def
 | `criticalContextThreshold` | float | `0.8` | Token usage ratio for critical warning |
 | `defaultTtlDays` | int | `0` | Default TTL for new nodes (0 = no expiry) |
 | `enableMiddleTermCapture` | bool | `true` | Save middle-term snapshots before compression |
+| `management.enabled` | bool | `false` | Auto-start the management web UI on plugin init |
+| `management.port` | int | `8787` | Port for the management server |
 | `autoFileSummarization.enabled` | bool | `false` | Auto-summarize files on read |
 
 ## Advanced Features
@@ -360,11 +362,13 @@ A local web UI for browsing, searching, and editing memory — available when th
 
 ### Starting
 
+The server starts automatically when `management.enabled: true` is set in your config (see [Configuration](#configuration)), or manually:
+
 ```bash
 bun run view
 ```
 
-Opens at [http://localhost:8787](http://localhost:8787). The server also starts automatically with OpenCode.
+Opens at [http://localhost:8787](http://localhost:8787). The server starts as a background process and auto-stops on plugin shutdown.
 
 ### Usage
 

package/dist/management-server.js

@@ -1,4 +1,47 @@
-export function startManagementServer(_store, _directory, _config) {
-    // No-op: management server is now a standalone CLI
-    // Run: bun run ~/.config/opencode/node_modules/opencode-fractal-memory/dist/management-standalone.js
+import * as path from "node:path";
+import { memLog } from "./logging";
+let activeProcess = null;
+export function startManagementServer(_store, directory, config) {
+    if (activeProcess) {
+        memLog("warn", "management", "Management server already running, killing old instance");
+        stopManagementServer();
+    }
+    const standalonePath = path.join(__dirname, "management-standalone.js");
+    try {
+        const proc = Bun.spawn(["bun", standalonePath], {
+            env: {
+                ...process.env,
+                MGMT_PORT: String(config.port),
+                MGMT_PROJECT_DIR: directory,
+            },
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        activeProcess = proc;
+        proc.exited.then((code) => {
+            memLog("info", "management", `Management server exited (code: ${code})`);
+            if (activeProcess === proc)
+                activeProcess = null;
+        });
+        memLog("info", "management", `Management server started on http://localhost:${config.port} (pid: ${proc.pid})`);
+    }
+    catch (err) {
+        memLog("error", "management", "Failed to start management server", {
+            error: err instanceof Error ? err.message : String(err),
+            standalonePath,
+        });
+    }
+}
+export function stopManagementServer() {
+    if (activeProcess) {
+        try {
+            activeProcess.kill("SIGTERM");
+            memLog("info", "management", `Management server process ${activeProcess.pid} killed`);
+        }
+        catch (err) {
+            memLog("warn", "management", "Error killing management server", {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        activeProcess = null;
+    }
 }

package/dist/plugin/index.js

@@ -2,6 +2,7 @@ import { initStorage, loadPluginConfig, seedRuleNodes, backfillData, scheduleBac
 import { createHookHandlers } from "./hooks";
 import { createToolMap } from "./tools";
 import { memLog, perfNow } from "../logging";
+import { stopManagementServer } from "../management-server";
 export const MemoryPlugin = async (ctx) => {
     const { directory, client } = ctx;
     const t0 = perfNow();
@@ -40,6 +41,7 @@ export const MemoryPlugin = async (ctx) => {
         ...(autoRetrieveHook || {}),
         tool: toolMap,
         cleanup: async () => {
+            stopManagementServer();
             await store.close();
         },
     };

package/package.json

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