opencode-fractal-memory 0.4.1 → 0.4.3

package/README.md

@@ -60,11 +60,11 @@ Add the plugin name to `~/.config/opencode/opencode.json`:
 
 ```json
 {
-  "plugins": ["opencode-fractal-memory"]
+  "plugin": ["opencode-fractal-memory"]
 }
 ```
 
-OpenCode installs it automatically at startup. Model files (~24 MB) download on first plugin load via `ensureModels()` — no manual steps needed.
+OpenCode installs it automatically at startup from npm. Model files (~24 MB) download on first plugin load via `ensureModels()` — no manual steps needed.
 
 ### For development / manual install
 
@@ -317,6 +317,9 @@ Skills are specialized instruction sets stored as memory nodes. When a task matc
 | `svelte-core-bestpractices` | svelte, component, runes |
 | `svelte-code-writer` | svelte 5, sveltekit, component |
 | `customize-opencode` | opencode config, agent, plugin |
+| `context-engineering` | context, prompt, system message |
+| `git-workflow-and-versioning` | git, commit, branch, version, publish |
+| `incremental-implementation` | step by step, increment, gradual |
 
 ### Loading a skill
 
@@ -410,13 +413,20 @@ When OpenCode loads the plugin, `initStorage()` runs automatically:
 6. **Background embeddings** — after 1s, generates embeddings for nodes that lack them
 7. **Auto-retrieve hook** — if enabled in config, injects relevant context into prompts
 
+Every initialization step is logged with timing in `logs/memory-plugin.log`, making it easy to diagnose startup issues.
+
 All of this happens automatically — no manual intervention required.
 
 ## Logs
 
+All plugin logs are consolidated under `~/.config/opencode/logs/`:
+
 | Log | Path | Contents |
 |-----|------|----------|
-| Memory | `~/.config/opencode/memory.log` | Plugin operations, errors, injection events |
+| Plugin | `logs/memory-plugin.log` | Plugin operations, init steps with timing, auto-retrieve, session events |
+| MCP server | `logs/mcp-server.log` | MCP tool calls, resources, errors |
+| Injection debug | `logs/memory-injection.log` | Full auto-retrieve injection payloads (rotated at 1 MB) |
+| Context dump | `logs/context-dump.log` | Full context snapshots for debugging |
 | OpenCode | `~/.local/share/opencode/log/` | Application lifecycle, tool calls |
 
 ## Development

package/dist/hooks/auto-retrieve/index.js

@@ -7,7 +7,13 @@ import { scoreCandidates } from "./scoring";
 import { detectRelevantSkills, detectRelevantPlaybooks } from "./detection";
 import { formatPlaybooksAsAvailable, formatSkillsAsAvailable } from "./formatting";
 import { formatNodeForInjection } from "./content";
-const INJECTION_LOG_FILE = path.join(os.homedir(), ".config", "opencode", "memory-injection.log");
+const INJECTION_LOG_DIR = path.join(os.homedir(), ".config", "opencode", "logs");
+const INJECTION_LOG_FILE = path.join(INJECTION_LOG_DIR, "memory-injection.log");
+const INJECTION_LOG_MAX_SIZE = 1024 * 1024;
+try {
+    fs.mkdirSync(INJECTION_LOG_DIR, { recursive: true });
+}
+catch { }
 export function createAutoRetrieveHook(deps) {
     const { store, config, log } = deps;
     const autoConfig = config.autoRetrieve;
@@ -136,6 +142,13 @@ ${JSON.stringify(memoriesJson, null, 2)}
                     return;
                 const debugLine = `[${new Date().toISOString()}] Query: ${userText.slice(0, 100)}...\n${fullBlock}\n\n`;
                 try {
+                    try {
+                        const stat = fs.statSync(INJECTION_LOG_FILE);
+                        if (stat.size > INJECTION_LOG_MAX_SIZE) {
+                            fs.renameSync(INJECTION_LOG_FILE, INJECTION_LOG_FILE + ".old");
+                        }
+                    }
+                    catch { }
                     fs.appendFileSync(INJECTION_LOG_FILE, debugLine);
                 }
                 catch { /* silent fail */ }

package/dist/logging.js

@@ -1,9 +1,14 @@
 import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
-const LOG_FILE = path.join(os.homedir(), ".config", "opencode", "memory-plugin.log");
-const CONTEXT_DUMP_FILE = path.join(os.homedir(), ".config", "opencode", "context_dump.log");
+const LOG_DIR = path.join(os.homedir(), ".config", "opencode", "logs");
+const LOG_FILE = path.join(LOG_DIR, "memory-plugin.log");
+const CONTEXT_DUMP_FILE = path.join(LOG_DIR, "context-dump.log");
 const MAX_LOG_SIZE = 5 * 1024 * 1024;
+try {
+    fs.mkdirSync(LOG_DIR, { recursive: true });
+}
+catch { }
 let currentSessionId = null;
 let logLevel = "info";
 // Categories to always skip (OpenCode core noise)

package/dist/mcp/logging.js

@@ -1,8 +1,13 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import * as os from "node:os";
-const MCP_LOG_FILE = path.join(os.homedir(), ".config", "opencode", "fractal-memory-server.log");
+const MCP_LOG_DIR = path.join(os.homedir(), ".config", "opencode", "logs");
+const MCP_LOG_FILE = path.join(MCP_LOG_DIR, "mcp-server.log");
 const MAX_LOG_SIZE = 1024 * 1024;
+try {
+    fs.mkdirSync(MCP_LOG_DIR, { recursive: true });
+}
+catch { }
 export function mcpLog(level, msg, data) {
     try {
         const ts = new Date().toISOString().slice(0, 19).replace("T", " ");

package/dist/mcp/server.js

@@ -3,18 +3,13 @@ import { z } from "zod";
 import { createSqliteMemoryStore } from "../storage/sqlite";
 import { withMcpLogging, mcpLog } from "./logging";
 import { nodeToPlain, ensureScope, resourceStats } from "./transform";
-import { fileURLToPath } from "node:url";
-import * as path from "node:path";
-import * as fs from "node:fs";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const pkg = JSON.parse(fs.readFileSync(path.resolve(__dirname, "../../package.json"), "utf-8"));
+import { VERSION } from "../version";
 let store;
 export async function createMemoryMcpServer(projectDir, globalDbPath) {
     mcpLog("info", "Creating memory store", { projectDir });
     store = createSqliteMemoryStore(projectDir, globalDbPath);
     mcpLog("info", "Memory store created");
-    const server = new McpServer({ name: "opencode-fractal-memory", version: pkg.version }, { capabilities: { tools: {}, resources: {} } });
+    const server = new McpServer({ name: "opencode-fractal-memory", version: VERSION }, { capabilities: { tools: {}, resources: {} } });
     server.registerTool("memory_search", {
         description: "Search memory nodes by text, embedding similarity, or BM25 score",
         inputSchema: {

package/dist/mcp-server.js

@@ -1,18 +1,14 @@
 #!/usr/bin/env bun
 import * as path from "node:path";
 import * as os from "node:os";
-import * as fs from "node:fs";
-import { fileURLToPath } from "node:url";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { createMemoryMcpServer } from "./mcp/server";
 import { mcpLog } from "./mcp/logging";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const pkg = JSON.parse(fs.readFileSync(path.resolve(__dirname, "../package.json"), "utf-8"));
+import { VERSION } from "./version";
 const projectDir = process.env.MGMT_PROJECT_DIR || process.cwd();
 const globalDbPath = path.join(os.homedir(), ".config", "opencode", "memory.db");
 async function main() {
-    mcpLog("info", "MCP server starting", { name: "opencode-fractal-memory", version: pkg.version });
+    mcpLog("info", "MCP server starting", { name: "opencode-fractal-memory", version: VERSION });
     const server = await createMemoryMcpServer(projectDir, globalDbPath);
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/plugin/index.js

@@ -2,6 +2,21 @@ import { initStorage, loadPluginConfig, seedRuleNodes, backfillData, scheduleBac
 import { createHookHandlers } from "./hooks";
 import { createToolMap } from "./tools";
 import { memLog, perfNow } from "../logging";
+import { VERSION } from "../version";
+function showToast(serverUrl, version) {
+    const url = `${serverUrl.origin}/tui/show-toast`;
+    fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            title: "Fractal Memory",
+            message: `v${version} loaded`,
+            variant: "info",
+        }),
+    }).catch(() => {
+        // silently ignore — TUI may not be available in headless mode
+    });
+}
 export const MemoryPlugin = async (ctx) => {
     const { directory, client } = ctx;
     const t0 = perfNow();
@@ -35,6 +50,7 @@ export const MemoryPlugin = async (ctx) => {
     const handlers = createHookHandlers(store, client, memConfig, ruleCache, ruleCacheDirty, sessionInjectionLock, latestUserMessage);
     const toolMap = createToolMap(store, journalTools, client);
     memLog("info", "init", "Plugin initialization completed", { totalDurationMs: perfNow() - t0 });
+    showToast(ctx.serverUrl, VERSION);
     return {
         ...handlers,
         ...(autoRetrieveHook || {}),

package/dist/tools/version.js

@@ -1,12 +1,6 @@
 import { tool } from "@opencode-ai/plugin";
 import { wrapWithTracking } from "./shared";
-import { fileURLToPath } from "node:url";
-import * as path from "node:path";
-import * as fs from "node:fs";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const pkg = JSON.parse(fs.readFileSync(path.resolve(__dirname, "../../package.json"), "utf-8"));
-const VERSION = pkg.version;
+import { VERSION } from "../version";
 export function MemoryVersion(store) {
     const t = tool({
         description: "Show the installed version of the Fractal Memory plugin.",

package/dist/version.js

@@ -0,0 +1,7 @@
+import { fileURLToPath } from "node:url";
+import * as path from "node:path";
+import * as fs from "node:fs";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const pkg = JSON.parse(fs.readFileSync(path.resolve(__dirname, "../package.json"), "utf-8"));
+export const VERSION = pkg.version;

package/package.json

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