@storacha/clawracha 0.0.1 → 0.0.3

package/dist/utils/tempcar.js

@@ -0,0 +1,44 @@
+import * as fs from "node:fs/promises";
+import { createReadStream, createWriteStream } from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import * as stream from "node:stream";
+import { CarWriter } from "@ipld/car/writer";
+export const makeTempCar = async () => {
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), "sync-clawracha-"));
+    const cleanup = async () => await fs.rm(dir, { recursive: true });
+    const file = path.join(dir, "blocks.car");
+    // CarWriter.createAppender() creates a headerless/rootless CAR
+    // which is fine for uploadCAR (the client handles it)
+    const { writer, out } = CarWriter.createAppender();
+    // Pipe the output to a file
+    const fsWriteStream = createWriteStream(file);
+    const pipePromise = stream.promises.pipeline(stream.Readable.from(out), fsWriteStream);
+    let didWrite = false;
+    const put = async (block) => {
+        didWrite = true;
+        await writer.put({ cid: block.cid, bytes: block.bytes });
+    };
+    const switchToReadable = async () => {
+        try {
+            await writer.close();
+            await pipePromise;
+            if (!didWrite) {
+                await cleanup();
+                return null;
+            }
+            return {
+                readable: {
+                    stream: () => stream.Readable.toWeb(createReadStream(file)),
+                },
+                cleanup,
+            };
+        }
+        catch (err) {
+            console.error("Error switching to readable:", err);
+            await cleanup();
+            throw err;
+        }
+    };
+    return { put, switchToReadable, cleanup };
+};

package/dist/watcher.d.ts

@@ -4,7 +4,7 @@
  * Uses chokidar to watch for file changes and batches them
  * before triggering sync.
  */
-import type { FileChange, SyncPluginConfig } from "./types.js";
+import type { FileChange, SyncPluginConfig } from "./types/index.js";
 export interface WatcherOptions {
     workspace: string;
     config: SyncPluginConfig;
@@ -21,7 +21,7 @@ export declare class FileWatcher {
     /**
      * Start watching the workspace
      */
-    start(): void;
+    start(): Promise<void>;
     /**
      * Stop watching
      */

package/dist/watcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,EAAE,cAAc;IAKnC;;OAEG;IACH,KAAK,IAAI,IAAI;IA+Bb;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAmBpB;;OAEG;YACW,KAAK;IAanB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAOlC"}
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAErE,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAoBD,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,EAAE,cAAc;IAKnC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAmBpB;;OAEG;YACW,KAAK;IAanB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAOlC"}

package/dist/watcher.js

@@ -5,7 +5,27 @@
  * before triggering sync.
  */
 import chokidar from "chokidar";
+import * as fs from "node:fs/promises";
 import * as path from "node:path";
+/**
+ * Read .clawrachaignore from workspace root (gitignore-style).
+ * Returns parsed patterns, or empty array if file doesn't exist.
+ */
+async function readIgnoreFile(workspace) {
+    const ignorePath = path.join(workspace, ".clawrachaignore");
+    try {
+        const content = await fs.readFile(ignorePath, "utf-8");
+        return content
+            .split("\n")
+            .map((line) => line.trim())
+            .filter((line) => line && !line.startsWith("#"));
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return [];
+        throw err;
+    }
+}
 export class FileWatcher {
     watcher = null;
     pendingChanges = new Map();
@@ -19,15 +39,18 @@ export class FileWatcher {
     /**
      * Start watching the workspace
      */
-    start() {
+    async start() {
         if (this.watcher)
             return;
         const { workspace, config } = this.options;
+        // Read workspace-level ignore file
+        const userIgnored = await readIgnoreFile(workspace);
         // Build watch patterns
         const watchPaths = config.watchPatterns.map((p) => path.join(workspace, p));
         // Build ignore patterns
         const ignored = [
             ...config.ignorePatterns,
+            ...userIgnored,
             ".storacha/**", // Always ignore our own data
         ];
         this.watcher = chokidar.watch(watchPaths, {

package/openclaw.plugin.json

@@ -5,7 +5,7 @@
   "description": "Sync OpenClaw workspaces to Storacha via UCN Pail",
   "entry": "./src/plugin.ts",
   "skills": [],
-  "config": {
+  "configSchema": {
     "type": "object",
     "properties": {
       "enabled": {
@@ -16,7 +16,7 @@
       "watchPatterns": {
         "type": "array",
         "items": { "type": "string" },
-        "default": ["**/*.md"],
+        "default": ["**/*"],
         "description": "Glob patterns to watch for sync"
       },
       "ignorePatterns": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storacha/clawracha",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "OpenClaw plugin for Storacha workspace sync via UCN Pail",
   "type": "module",
   "main": "dist/plugin.js",

package/src/plugin.ts

@@ -15,7 +15,7 @@ import type {
   OpenClawPluginServiceContext,
   AnyAgentTool,
 } from "openclaw/plugin-sdk";
-import type { DeviceConfig } from "./types/index.js";
+import type { DeviceConfig, SyncPluginConfig } from "./types/index.js";
 import { SyncEngine } from "./sync.js";
 import { FileWatcher } from "./watcher.js";
 import { createStorachaClient } from "./utils/client.js";
@@ -58,10 +58,18 @@ async function saveDeviceConfig(
  * Plugin entry — called by OpenClaw when the plugin is loaded.
  */
 export default function plugin(api: OpenClawPluginApi) {
+  // Capture plugin-specific config at registration time
+  const pluginConfig = (api.pluginConfig ?? {}) as Partial<SyncPluginConfig>;
+
   // Register background service
   api.registerService({
     id: "storacha-sync",
     async start(ctx: OpenClawPluginServiceContext) {
+      if (pluginConfig.enabled === false) {
+        ctx.logger.info("Storacha sync disabled via config.");
+        return;
+      }
+
       workspaceDir = ctx.workspaceDir;
       const workspace = workspaceDir;
       if (!workspace) {
@@ -85,8 +93,8 @@ export default function plugin(api: OpenClawPluginApi) {
         workspace,
         config: {
           enabled: true,
-          watchPatterns: ["**/*"],
-          ignorePatterns: [
+          watchPatterns: pluginConfig.watchPatterns ?? ["**/*"],
+          ignorePatterns: pluginConfig.ignorePatterns ?? [
             ".storacha/**",
             "node_modules/**",
             ".git/**",
@@ -104,7 +112,7 @@ export default function plugin(api: OpenClawPluginApi) {
         },
       });
 
-      fileWatcher.start();
+      await fileWatcher.start();
       ctx.logger.info("Started watching workspace");
     },
 

package/src/watcher.ts

@@ -6,6 +6,7 @@
  */
 
 import chokidar from "chokidar";
+import * as fs from "node:fs/promises";
 import * as path from "node:path";
 import type { FileChange, SyncPluginConfig } from "./types/index.js";
 
@@ -16,6 +17,24 @@ export interface WatcherOptions {
   debounceMs?: number;
 }
 
+/**
+ * Read .clawrachaignore from workspace root (gitignore-style).
+ * Returns parsed patterns, or empty array if file doesn't exist.
+ */
+async function readIgnoreFile(workspace: string): Promise<string[]> {
+  const ignorePath = path.join(workspace, ".clawrachaignore");
+  try {
+    const content = await fs.readFile(ignorePath, "utf-8");
+    return content
+      .split("\n")
+      .map((line) => line.trim())
+      .filter((line) => line && !line.startsWith("#"));
+  } catch (err: any) {
+    if (err.code === "ENOENT") return [];
+    throw err;
+  }
+}
+
 export class FileWatcher {
   private watcher: chokidar.FSWatcher | null = null;
   private pendingChanges: Map<string, FileChange> = new Map();
@@ -31,17 +50,21 @@ export class FileWatcher {
   /**
    * Start watching the workspace
    */
-  start(): void {
+  async start(): Promise<void> {
     if (this.watcher) return;
 
     const { workspace, config } = this.options;
 
+    // Read workspace-level ignore file
+    const userIgnored = await readIgnoreFile(workspace);
+
     // Build watch patterns
     const watchPaths = config.watchPatterns.map((p) => path.join(workspace, p));
 
     // Build ignore patterns
     const ignored = [
       ...config.ignorePatterns,
+      ...userIgnored,
       ".storacha/**", // Always ignore our own data
     ];