ocsmarttools 0.1.3 → 0.1.4

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to `ocsmarttools` are documented here.
 
+## [0.1.4] - 2026-02-22
+
+### Changed
+- Broadened peer compatibility range to `openclaw >=2026.2.19` for easier installs across existing instances.
+
+### Fixed
+- Routing policy sync is now fail-safe on restricted/read-only environments (never breaks plugin startup).
+- Setup/config flows now return clear messages when routing sync is skipped due to filesystem permissions/path issues.
+
 ## [0.1.3] - 2026-02-22
 
 ### Added

package/README.md

@@ -23,6 +23,10 @@ flowchart LR
 
 ## Install
 
+Compatibility:
+- OpenClaw: `>=2026.2.19`
+- Works with existing installed instances (no core patch required)
+
 ### npm
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ocsmarttools",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Provider-agnostic advanced tool orchestration plugin for OpenClaw with search, dispatch, and batching",
   "type": "module",
   "scripts": {
@@ -24,7 +24,7 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "openclaw": ">=2026.2.21"
+    "openclaw": ">=2026.2.19"
   },
   "devDependencies": {
     "typescript": "^5.8.0",

package/src/commands/operations.ts

@@ -280,7 +280,10 @@ export async function setConfigKey(
   await writeConfig(api, next);
 
   if (key === "autoInjectRoutingGuide" && parsed.value === true) {
-    await syncRoutingGuide(api, next);
+    const sync = await syncRoutingGuide(api, next);
+    if (sync.error) {
+      return `Config updated: ${key}=${JSON.stringify(parsed.value)} (routing sync skipped: ${sync.error}).`;
+    }
   }
 
   return `Config updated: ${key}=${JSON.stringify(parsed.value)}.`;
@@ -299,7 +302,10 @@ export async function resetConfig(api: OpenClawPluginApi, key?: string): Promise
     }
     await writeConfig(api, next);
     if (DEFAULT_SETTINGS.autoInjectRoutingGuide) {
-      await syncRoutingGuide(api, next);
+      const sync = await syncRoutingGuide(api, next);
+      if (sync.error) {
+        return `Config reset to plugin defaults (routing sync skipped: ${sync.error}).`;
+      }
     }
     return "Config reset to plugin defaults.";
   }
@@ -311,7 +317,10 @@ export async function resetConfig(api: OpenClawPluginApi, key?: string): Promise
   setValueAtPath(pluginCfg, key, DEFAULT_BY_KEY[key]);
   await writeConfig(api, next);
   if (key === "autoInjectRoutingGuide" && DEFAULT_BY_KEY[key] === true) {
-    await syncRoutingGuide(api, next);
+    const sync = await syncRoutingGuide(api, next);
+    if (sync.error) {
+      return `Config key reset: ${key}=${JSON.stringify(DEFAULT_BY_KEY[key])} (routing sync skipped: ${sync.error}).`;
+    }
   }
   return `Config key reset: ${key}=${JSON.stringify(DEFAULT_BY_KEY[key])}.`;
 }
@@ -361,12 +370,16 @@ export async function applySetup(api: OpenClawPluginApi, mode: AdvToolsMode): Pr
   );
 
   await writeConfig(api, next);
-  await syncRoutingGuide(api, next);
+  const sync = await syncRoutingGuide(api, next);
+  const syncLine = sync.error
+    ? `- routing guide sync skipped: ${sync.error}`
+    : `- routing guide ${sync.changed ? "synced" : "already up to date"} (${sync.filePath ?? "AGENTS.md"})`;
 
   return [
     "OCSmartTools setup applied.",
     `- mode: ${mode}`,
     "- autoInjectRoutingGuide: true",
+    syncLine,
     `- ensured tools.allow includes: ${ADVTOOLS_TOOL_NAMES.join(", ")}`,
     "- config written via runtime config writer",
     "If your gateway does not hot-apply this change, run: openclaw gateway restart",
@@ -395,6 +408,9 @@ export async function syncManagedRouting(api: OpenClawPluginApi): Promise<string
     return "Routing guide sync skipped: autoInjectRoutingGuide=false.";
   }
   const result = await syncRoutingGuide(api, loaded);
+  if (result.error) {
+    return `Routing guide sync skipped: ${result.error}`;
+  }
   if (!result.changed) {
     return `Routing guide already up to date (${result.filePath ?? "AGENTS.md"}).`;
   }

package/src/lib/bootstrap.ts

@@ -119,7 +119,9 @@ export async function autoBootstrap(api: OpenClawPluginApi): Promise<{ changed:
       : DEFAULT_SETTINGS.autoInjectRoutingGuide;
   if (routingGuideEnabled) {
     const sync = await syncRoutingGuide(api, next);
-    if (sync.changed) {
+    if (sync.error) {
+      notes.push(`routing guide skipped: ${sync.error}`);
+    } else if (sync.changed) {
       notes.push(`synced routing guide (${sync.filePath ?? "AGENTS.md"})`);
     }
   }

package/src/lib/routing-guide.ts

@@ -60,6 +60,7 @@ function upsertRoutingBlock(raw: string): string {
 export async function syncRoutingGuide(api: OpenClawPluginApi, cfg: OpenClawConfig): Promise<{
   changed: boolean;
   filePath?: string;
+  error?: string;
 }> {
   const workspaceDir = resolveWorkspaceDir(cfg);
   const filePath = path.join(workspaceDir, "AGENTS.md");
@@ -68,7 +69,11 @@ export async function syncRoutingGuide(api: OpenClawPluginApi, cfg: OpenClawConf
     current = await fs.readFile(filePath, "utf8");
   } catch (error) {
     if ((error as NodeJS.ErrnoException).code !== "ENOENT") {
-      throw error;
+      return {
+        changed: false,
+        filePath,
+        error: `read failed: ${error instanceof Error ? error.message : String(error)}`,
+      };
     }
   }
 
@@ -77,8 +82,16 @@ export async function syncRoutingGuide(api: OpenClawPluginApi, cfg: OpenClawConf
     return { changed: false, filePath };
   }
 
-  await fs.mkdir(workspaceDir, { recursive: true });
-  await fs.writeFile(filePath, next, "utf8");
+  try {
+    await fs.mkdir(workspaceDir, { recursive: true });
+    await fs.writeFile(filePath, next, "utf8");
+  } catch (error) {
+    return {
+      changed: false,
+      filePath,
+      error: `write failed: ${error instanceof Error ? error.message : String(error)}`,
+    };
+  }
   api.logger.info(`[ocsmarttools] routing policy synced: ${filePath}`);
   return { changed: true, filePath };
 }