@digitalforgestudios/openclaw-sulcus 5.3.0 → 5.4.0

package/index.ts

@@ -1,5 +1,5 @@
 import { resolve } from "node:path";
-import { existsSync } from "node:fs";
+import { existsSync, mkdirSync } from "node:fs";
 import * as https from "node:https";
 import * as http from "node:http";
 import { URL } from "node:url";
@@ -1271,6 +1271,17 @@ const sulcusPlugin = {
       ? resolve(pluginConfig.libDir as string)
       : resolve(process.env.HOME || "~", ".sulcus/lib");
 
+    // Auto-create directories on first run (self-healing)
+    const dataDir = resolve(process.env.HOME || "~", ".sulcus/data");
+    for (const dir of [libDir, dataDir]) {
+      if (!existsSync(dir)) {
+        try {
+          mkdirSync(dir, { recursive: true });
+          logger.info(`sulcus: created directory ${dir}`);
+        } catch { /* best effort — may be read-only in containers */ }
+      }
+    }
+
     const storeLibPath = pluginConfig?.storeLibPath
       ? resolve(pluginConfig.storeLibPath as string)
       : resolve(libDir, process.platform === "darwin" ? "libsulcus_store.dylib" : "libsulcus_store.so");
@@ -1303,7 +1314,6 @@ const sulcusPlugin = {
     // ── Backend init ──
     let sulcusMem: SulcusCloudClient | null = null;
     let backendMode = "unavailable";
-    const nativeLoader = new NativeLibLoader(storeLibPath, vectorsLibPath);
 
     if (serverUrl && apiKey) {
       try {
@@ -1315,7 +1325,11 @@ const sulcusPlugin = {
       }
     }
 
-    if (sulcusMem === null) {
+    // Only attempt native/WASM fallback if cloud mode was NOT configured or failed.
+    // When serverUrl+apiKey are set, the user intends cloud mode — don't warn about
+    // missing native libs that they never intended to use.
+    const nativeLoader = new NativeLibLoader(storeLibPath, vectorsLibPath);
+    if (sulcusMem === null && !(serverUrl && apiKey)) {
       nativeLoader.init(logger);
       if (nativeLoader.loaded) {
         const wasmJsPath = resolve(wasmDir, "sulcus_wasm.js");
@@ -1346,14 +1360,24 @@ const sulcusPlugin = {
 
     // ── Startup summary ──
     if (isAvailable) {
-      logger.info(`sulcus: registered (backend: ${backendMode}, namespace: ${namespace}, autoRecall: ${autoRecall}, autoCapture: ${autoCapture})`);
+      logger.info(`sulcus: ready ✅ (backend: ${backendMode}, namespace: ${namespace}, autoRecall: ${autoRecall}, autoCapture: ${autoCapture})`);
     } else {
+      // Give clear, actionable guidance instead of cryptic error chains
       const hints: string[] = [];
-      if (!serverUrl && !apiKey) hints.push("no serverUrl/apiKey for cloud mode");
-      else if (serverUrl && !apiKey) hints.push("serverUrl set but apiKey missing");
-      else if (!serverUrl && apiKey) hints.push("apiKey set but serverUrl missing");
-      if (nativeLoader.error) hints.push(`local: ${nativeLoader.error}`);
-      logger.warn(`sulcus: unavailable — ${hints.join("; ") || "unknown reason"}`);
+      if (!serverUrl && !apiKey) {
+        hints.push("To use Sulcus cloud: set serverUrl and apiKey in plugin config");
+        hints.push("Get an API key at https://sulcus.ca/dashboard/settings");
+      } else if (serverUrl && !apiKey) {
+        hints.push("serverUrl is set but apiKey is missing — add your API key to plugin config");
+      } else if (!serverUrl && apiKey) {
+        hints.push("apiKey is set but serverUrl is missing — add serverUrl (e.g. https://api.sulcus.ca)");
+      } else {
+        hints.push("Cloud connection failed — check serverUrl and apiKey are correct");
+      }
+      if (!serverUrl && !apiKey && nativeLoader.error) {
+        hints.push(`Local mode: ${nativeLoader.error}`);
+      }
+      logger.warn(`sulcus: not ready — ${hints.join(". ")}`);
     }
 
     // ── SIU v2 request helper ──

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitalforgestudios/openclaw-sulcus",
-  "version": "5.3.0",
+  "version": "5.4.0",
   "description": "Sulcus — thermodynamic memory + Apache AGE knowledge graph for OpenClaw agents. v5: before_prompt_build hook migration (replaces before_agent_start), registerMemoryEmbeddingProvider (BGE-small-en-v1.5 via cloud API), registerMemoryRuntime, prependContext recall, registerMemoryPromptSection, registerService lifecycle, uiHints, provider-filtered auto-capture. SIU v2 pipeline auto-classifies and scores memories. Interaction-based decay (3 modes). Curator sleep-cycle. Relevance-weighted recall. Cross-agent sync.",
   "keywords": [
     "openclaw",