@digitalforgestudios/openclaw-sulcus 3.2.1 → 3.3.0

package/bin/configure.mjs

@@ -0,0 +1,399 @@
+#!/usr/bin/env node
+/**
+ * Sulcus Configuration Wizard
+ * Interactive CLI to configure the openclaw-sulcus plugin in openclaw.json
+ *
+ * Usage:
+ *   npx @digitalforgestudios/openclaw-sulcus configure
+ *   node bin/configure.mjs [--no-color] [--help]
+ */
+
+import readline from 'readline';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+// ─── Colour support ───────────────────────────────────────────────────────────
+
+const noColor =
+  process.argv.includes('--no-color') ||
+  process.env.NO_COLOR !== undefined ||
+  !process.stdout.isTTY;
+
+const c = {
+  reset:   noColor ? '' : '\x1b[0m',
+  bold:    noColor ? '' : '\x1b[1m',
+  dim:     noColor ? '' : '\x1b[2m',
+  red:     noColor ? '' : '\x1b[31m',
+  green:   noColor ? '' : '\x1b[32m',
+  yellow:  noColor ? '' : '\x1b[33m',
+  blue:    noColor ? '' : '\x1b[34m',
+  magenta: noColor ? '' : '\x1b[35m',
+  cyan:    noColor ? '' : '\x1b[36m',
+  white:   noColor ? '' : '\x1b[37m',
+};
+
+const bold    = (s) => `${c.bold}${s}${c.reset}`;
+const dim     = (s) => `${c.dim}${s}${c.reset}`;
+const green   = (s) => `${c.green}${s}${c.reset}`;
+const yellow  = (s) => `${c.yellow}${s}${c.reset}`;
+const red     = (s) => `${c.red}${s}${c.reset}`;
+const cyan    = (s) => `${c.cyan}${s}${c.reset}`;
+const magenta = (s) => `${c.magenta}${s}${c.reset}`;
+
+// ─── Help ─────────────────────────────────────────────────────────────────────
+
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  console.log(`
+${bold('Sulcus Configuration Wizard')}
+
+Interactively configure the openclaw-sulcus plugin inside your openclaw.json.
+
+${bold('Usage:')}
+  npx @digitalforgestudios/openclaw-sulcus configure [options]
+  node bin/configure.mjs [options]
+
+${bold('Options:')}
+  --help, -h      Show this help message
+  --no-color      Disable coloured output
+
+${bold('What it does:')}
+  1. Locates your openclaw.json (checks \$OPENCLAW_CONFIG_PATH, ~/.openclaw/, ./)
+  2. Walks you through backend mode, dylib path, namespace, hooks, and tools
+  3. Deep-merges settings under plugins.entries.openclaw-sulcus.config
+  4. Validates that your native dylibs exist and warns if they are missing
+  5. Reminds you to restart the OpenClaw gateway
+
+${bold('Example:')}
+  npx @digitalforgestudios/openclaw-sulcus configure
+`);
+  process.exit(0);
+}
+
+// ─── Readline helpers ─────────────────────────────────────────────────────────
+
+const rl = readline.createInterface({
+  input:  process.stdin,
+  output: process.stdout,
+});
+
+// Graceful Ctrl+C
+rl.on('SIGINT', () => {
+  console.log(`\n\n${yellow('⚡ Wizard cancelled — no changes were written.')}\n`);
+  process.exit(0);
+});
+
+/**
+ * Prompt the user with an optional default value.
+ * Returns the trimmed answer, or the default if empty.
+ */
+function ask(question, defaultValue = '') {
+  return new Promise((resolve) => {
+    const hint = defaultValue !== '' ? dim(` [${defaultValue}]`) : '';
+    rl.question(`${question}${hint} `, (answer) => {
+      const trimmed = answer.trim();
+      resolve(trimmed === '' ? defaultValue : trimmed);
+    });
+  });
+}
+
+/**
+ * Ask a yes/no question. Returns boolean.
+ * @param {string} question
+ * @param {boolean} defaultVal
+ */
+function askYN(question, defaultVal = false) {
+  return new Promise((resolve) => {
+    const hint = dim(` [${defaultVal ? 'Y/n' : 'y/N'}]`);
+    rl.question(`  ${question}${hint} `, (answer) => {
+      const a = answer.trim().toLowerCase();
+      if (a === '') resolve(defaultVal);
+      else resolve(a === 'y' || a === 'yes');
+    });
+  });
+}
+
+// ─── openclaw.json discovery ──────────────────────────────────────────────────
+
+function expandHome(p) {
+  if (p.startsWith('~')) return path.join(os.homedir(), p.slice(1));
+  return p;
+}
+
+function findOpenclawJson() {
+  const candidates = [
+    process.env.OPENCLAW_CONFIG_PATH,
+    path.join(os.homedir(), '.openclaw', 'openclaw.json'),
+    path.join(process.cwd(), 'openclaw.json'),
+  ].filter(Boolean);
+
+  for (const candidate of candidates) {
+    const resolved = expandHome(candidate);
+    if (fs.existsSync(resolved)) return resolved;
+  }
+  return null;
+}
+
+// Deep-merge two plain objects (target mutated).
+function deepMerge(target, source) {
+  for (const key of Object.keys(source)) {
+    if (
+      source[key] !== null &&
+      typeof source[key] === 'object' &&
+      !Array.isArray(source[key]) &&
+      typeof target[key] === 'object' &&
+      target[key] !== null &&
+      !Array.isArray(target[key])
+    ) {
+      deepMerge(target[key], source[key]);
+    } else {
+      target[key] = source[key];
+    }
+  }
+  return target;
+}
+
+// ─── Main wizard ──────────────────────────────────────────────────────────────
+
+async function run() {
+  console.log(`
+${bold(magenta('🧠  Sulcus Configuration Wizard'))}
+${dim('────────────────────────────────────────────')}
+Configures the ${cyan('openclaw-sulcus')} plugin inside your ${cyan('openclaw.json')}.
+Press ${bold('Enter')} to accept defaults. ${bold('Ctrl+C')} to cancel at any time.
+`);
+
+  // ── Step 1: Locate openclaw.json ──────────────────────────────────────────
+
+  console.log(`${bold('Step 1 · Locate openclaw.json')}`);
+
+  let configPath = findOpenclawJson();
+
+  if (configPath) {
+    console.log(`  ${green('✓')} Found: ${cyan(configPath)}\n`);
+  } else {
+    console.log(`  ${yellow('⚠')}  Could not find openclaw.json in the usual locations.`);
+    console.log(`     Checked:`);
+    if (process.env.OPENCLAW_CONFIG_PATH)
+      console.log(`       • \$OPENCLAW_CONFIG_PATH → ${process.env.OPENCLAW_CONFIG_PATH}`);
+    console.log(`       • ~/.openclaw/openclaw.json`);
+    console.log(`       • ./openclaw.json\n`);
+
+    const choice = await ask(
+      `  Enter full path to openclaw.json, or press Enter to create ~/.openclaw/openclaw.json:`,
+      path.join(os.homedir(), '.openclaw', 'openclaw.json'),
+    );
+    configPath = expandHome(choice);
+
+    if (!fs.existsSync(configPath)) {
+      const dir = path.dirname(configPath);
+      fs.mkdirSync(dir, { recursive: true });
+      fs.writeFileSync(configPath, JSON.stringify({}, null, 2), 'utf8');
+      console.log(`  ${green('✓')} Created: ${cyan(configPath)}\n`);
+    } else {
+      console.log(`  ${green('✓')} Using: ${cyan(configPath)}\n`);
+    }
+  }
+
+  // Read existing config
+  let existingConfig = {};
+  try {
+    existingConfig = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+  } catch (err) {
+    console.log(`  ${red('✗')} Failed to parse openclaw.json: ${err.message}`);
+    console.log(`  Fix the JSON syntax and re-run the wizard.\n`);
+    rl.close();
+    process.exit(1);
+  }
+
+  // ── Step 2: Wizard questions ──────────────────────────────────────────────
+
+  console.log(`${bold('Step 2 · Configure Sulcus')}`);
+  console.log();
+
+  // Backend mode
+  console.log(`  ${bold('Backend mode:')}`);
+  console.log(`    ${cyan('[1]')} Local only ${dim('(WASM + native dylibs, no network)')}`);
+  console.log(`    ${cyan('[2]')} Cloud sync  ${dim('(local + server replication)')}`);
+  const modeRaw = await ask(`  >`, '1');
+  const cloudSync = modeRaw === '2';
+  console.log();
+
+  // Native dylib path
+  const libDirDefault = '~/.sulcus/lib';
+  const libDirRaw = await ask(
+    `  ${bold('Where are your native dylibs?')}`,
+    libDirDefault,
+  );
+  const libDir = libDirRaw;
+  console.log();
+
+  // Agent namespace
+  const namespace = await ask(`  ${bold('Agent namespace:')}`, 'default');
+  console.log();
+
+  // Hooks
+  console.log(`  ${bold('Enable hooks:')}`);
+  const injectAwareness = await askYN(
+    'Inject memory awareness into prompts? (before_prompt_build)',
+    false,
+  );
+  const autoRecall = await askYN(
+    'Auto-recall memories on each turn? (before_agent_start)',
+    false,
+  );
+  console.log();
+
+  // Tools
+  console.log(`  ${bold('Enable tools:')}`);
+  const toolMemoryRecall    = await askYN('memory_recall    — search memories',               true);
+  const toolMemoryStore     = await askYN('memory_store     — save memories',                 true);
+  const toolMemoryStatus    = await askYN('memory_status    — check memory stats',            true);
+  const toolConsolidate     = await askYN('consolidate      — cluster similar memories',      false);
+  const toolExportMarkdown  = await askYN('export_markdown  — export memories as markdown',   false);
+  const toolImportMarkdown  = await askYN('import_markdown  — import from markdown',          false);
+  const toolEvalTriggers    = await askYN('evaluate_triggers — reactive trigger engine',      false);
+  console.log();
+
+  // Cloud sync extras
+  let serverUrl = '';
+  let apiKey    = '';
+  if (cloudSync) {
+    console.log(`  ${bold('Cloud sync settings:')}`);
+    serverUrl = await ask(`  Server URL:`, 'https://api.sulcus.ca');
+    apiKey    = await ask(`  API Key:`,    '');
+    console.log();
+  }
+
+  // ── Step 3: Build and write config ───────────────────────────────────────
+
+  console.log(`${bold('Step 3 · Write openclaw.json')}`);
+
+  const sulcusConfig = {
+    libDir,
+    namespace: namespace === 'default' ? undefined : namespace,
+    ...(cloudSync && serverUrl ? { serverUrl } : {}),
+    ...(cloudSync && apiKey    ? { apiKey }    : {}),
+    hooks: {
+      before_prompt_build: { action: 'inject_awareness', enabled: injectAwareness },
+      before_agent_start:  { action: 'auto_recall',      enabled: autoRecall, limit: 5, minScore: 0.3 },
+    },
+    tools: {
+      memory_recall:     { enabled: toolMemoryRecall },
+      memory_store:      { enabled: toolMemoryStore },
+      memory_status:     { enabled: toolMemoryStatus },
+      consolidate:       { enabled: toolConsolidate },
+      export_markdown:   { enabled: toolExportMarkdown },
+      import_markdown:   { enabled: toolImportMarkdown },
+      evaluate_triggers: { enabled: toolEvalTriggers },
+    },
+  };
+
+  // Remove undefined keys
+  Object.keys(sulcusConfig).forEach(
+    (k) => sulcusConfig[k] === undefined && delete sulcusConfig[k],
+  );
+
+  // Deep-merge into existing config
+  const merged = deepMerge(existingConfig, {
+    plugins: {
+      entries: {
+        'openclaw-sulcus': {
+          enabled: true,
+          config: sulcusConfig,
+        },
+      },
+    },
+  });
+
+  let written = false;
+  try {
+    fs.writeFileSync(configPath, JSON.stringify(merged, null, 2) + '\n', 'utf8');
+    written = true;
+  } catch (err) {
+    console.log(`  ${red('✗')} Failed to write ${configPath}: ${err.message}\n`);
+    rl.close();
+    process.exit(1);
+  }
+
+  if (written) {
+    console.log(`  ${green('✓')} Written to ${cyan(configPath)}`);
+    console.log();
+
+    // Summary
+    console.log(`  ${dim('──── Summary ────────────────────────────────────')}`);
+    console.log(`  Plugin:    ${cyan('openclaw-sulcus')}  ${green('enabled')}`);
+    console.log(`  Backend:   ${cyan(cloudSync ? 'cloud sync' : 'local only')}`);
+    console.log(`  Dylib dir: ${cyan(libDir)}`);
+    console.log(`  Namespace: ${cyan(namespace)}`);
+    if (cloudSync && serverUrl) console.log(`  Server:    ${cyan(serverUrl)}`);
+
+    const enabledHooks = [];
+    if (injectAwareness) enabledHooks.push('before_prompt_build');
+    if (autoRecall)      enabledHooks.push('before_agent_start');
+    console.log(`  Hooks:     ${enabledHooks.length ? cyan(enabledHooks.join(', ')) : dim('(none enabled)')}`);
+
+    const enabledTools = [
+      toolMemoryRecall    && 'memory_recall',
+      toolMemoryStore     && 'memory_store',
+      toolMemoryStatus    && 'memory_status',
+      toolConsolidate     && 'consolidate',
+      toolExportMarkdown  && 'export_markdown',
+      toolImportMarkdown  && 'import_markdown',
+      toolEvalTriggers    && 'evaluate_triggers',
+    ].filter(Boolean);
+    console.log(`  Tools:     ${enabledTools.length ? cyan(enabledTools.join(', ')) : dim('(none enabled)')}`);
+    console.log(`  ${dim('─────────────────────────────────────────────────')}`);
+    console.log();
+  }
+
+  // ── Step 4: Validate dylib path ───────────────────────────────────────────
+
+  console.log(`${bold('Step 4 · Validate')}`);
+
+  const resolvedLibDir = expandHome(libDir);
+  const dylibNames = ['libsulcus_store', 'libsulcus_vectors'];
+  const ext = process.platform === 'darwin' ? '.dylib'
+            : process.platform === 'win32'  ? '.dll'
+            :                                 '.so';
+
+  let dylibsOk = true;
+
+  if (!fs.existsSync(resolvedLibDir)) {
+    dylibsOk = false;
+    console.log(`  ${yellow('⚠')}  Dylib directory not found: ${cyan(resolvedLibDir)}`);
+  } else {
+    for (const lib of dylibNames) {
+      const full = path.join(resolvedLibDir, lib + ext);
+      if (fs.existsSync(full)) {
+        console.log(`  ${green('✓')} Found: ${dim(full)}`);
+      } else {
+        dylibsOk = false;
+        console.log(`  ${yellow('⚠')}  Missing: ${dim(full)}`);
+      }
+    }
+  }
+
+  if (!dylibsOk) {
+    console.log();
+    console.log(`  ${yellow(bold('Native dylibs missing — Sulcus will not load.'))}`);;
+    console.log(`  Run the setup script to download and install them:`);
+    console.log(`    ${cyan('bash ~/.sulcus/setup-local.sh')}`);
+    console.log(`  Or visit: ${cyan('https://sulcus.ca/docs/install')}`);
+  } else {
+    console.log(`  ${green('✓')} All dylibs present — Sulcus is ready to go.`);
+  }
+
+  console.log();
+  console.log(`  ${bold(green('✅  Configuration complete!'))} Restart the OpenClaw gateway to pick up changes:`);
+  console.log(`     ${cyan('openclaw gateway restart')}`);
+  console.log();
+
+  rl.close();
+}
+
+run().catch((err) => {
+  console.error(`\n${red('Fatal error:')} ${err.message}\n`);
+  rl.close();
+  process.exit(1);
+});

package/hooks.defaults.json

@@ -4,7 +4,7 @@
   "hooks": {
     "before_prompt_build": {
       "action": "inject_awareness",
-      "enabled": true
+      "enabled": false
     },
     "before_agent_start": {
       "action": "auto_recall",
@@ -14,13 +14,13 @@
     },
     "agent_end": {
       "action": "none",
-      "enabled": true
+      "enabled": false
     }
   },
   "tools": {
-    "memory_recall": { "enabled": true },
-    "memory_store": { "enabled": true },
-    "memory_status": { "enabled": true },
+    "memory_recall": { "enabled": false },
+    "memory_store": { "enabled": false },
+    "memory_status": { "enabled": false },
     "consolidate": { "enabled": false },
     "export_markdown": { "enabled": false },
     "import_markdown": { "enabled": false },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitalforgestudios/openclaw-sulcus",
-  "version": "3.2.1",
+  "version": "3.3.0",
   "description": "Sulcus — reactive, thermodynamic memory plugin for OpenClaw. Opt-in persistent memory with heat-based decay, semantic search, and cross-agent sync. Auto-recall and auto-capture disabled by default.",
   "keywords": [
     "openclaw",
@@ -37,7 +37,11 @@
       "openclawVersion": "2026.3.28"
     }
   },
+  "bin": {
+    "openclaw-sulcus": "./bin/configure.mjs"
+  },
   "files": [
+    "bin/",
     "index.ts",
     "wasm/",
     "openclaw.plugin.json",

package/wasm/sulcus_wasm.js

@@ -277,8 +277,13 @@ function __wbg_get_imports() {
             return ret;
         },
         __wbg_new_no_args_1c7c842f08d00ebb: function(arg0, arg1) {
-            const ret = new Function(getStringFromWasm0(arg0, arg1));
-            return ret;
+            // Avoid dynamic code execution (new Function) — use safe globalThis fallback
+            const body = getStringFromWasm0(arg0, arg1);
+            if (body.includes('return this')) {
+                const ret = { call: () => globalThis };
+                return ret;
+            }
+            throw new Error(`sulcus-wasm: refusing dynamic code execution: ${body.substring(0, 60)}`);
         },
         __wbg_parse_708461a1feddfb38: function() { return handleError(function (arg0, arg1) {
             const ret = JSON.parse(getStringFromWasm0(arg0, arg1));