opencode-fractal-memory 0.4.1 → 0.4.2

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/package.json

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