@storacha/clawracha 0.1.0 → 0.1.2

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,qBAAqB,CAAC;AAiG7B,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,GAAG,EAAE,iBAAiB,QAoepD"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,qBAAqB,CAAC;AAiH7B,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,GAAG,EAAE,iBAAiB,QAgjBpD"}

package/dist/plugin.js

@@ -12,7 +12,8 @@ import { SyncEngine } from "./sync.js";
 import { FileWatcher } from "./watcher.js";
 import { createStorachaClient } from "./utils/client.js";
 import { decodeDelegation, encodeDelegation, readDelegationArg, } from "./utils/delegation.js";
-import { resolveAgentWorkspace, getAgentIds, } from "./utils/workspace.js";
+import { resolveAgentWorkspace, getAgentIds } from "./utils/workspace.js";
+import { readIgnoreFile } from "./utils/ignore.js";
 const activeSyncers = new Map();
 // --- Config helpers ---
 async function loadDeviceConfig(workspace) {
@@ -66,6 +67,18 @@ async function startWorkspaceSync(workspace, agentId, pluginConfig, logger) {
     logger.info(`[${agentId}] Started syncing workspace: ${workspace}`);
     return { engine, watcher, workspace, agentId };
 }
+/**
+ * Scan workspace for files, excluding patterns.
+ * Returns paths relative to workspace.
+ */
+async function scanWorkspaceFiles(workspace, ignorePatterns) {
+    const { glob } = await import("glob");
+    return glob("**/*", {
+        cwd: workspace,
+        nodir: true,
+        ignore: ignorePatterns.map((p) => p.includes("/") || p.includes("*") ? p : `${p}/**`),
+    });
+}
 // --- Plugin entry ---
 export default function plugin(api) {
     const pluginConfig = (api.pluginConfig ?? {});
@@ -99,6 +112,7 @@ export default function plugin(api) {
         },
         async stop(ctx) {
             for (const [workspace, sync] of activeSyncers) {
+                sync.engine.stop();
                 await sync.watcher.stop();
                 ctx.logger.info(`[${sync.agentId}] Stopped syncing: ${workspace}`);
             }
@@ -248,6 +262,32 @@ export default function plugin(api) {
                 deviceConfig.spaceDID = spaceDID ?? undefined;
                 deviceConfig.setupComplete = true;
                 await saveDeviceConfig(workspace, deviceConfig);
+                // Initial upload: scan all existing workspace files and sync to Storacha
+                const storachaClient = await createStorachaClient(deviceConfig);
+                const engine = new SyncEngine(storachaClient, workspace);
+                await engine.init(deviceConfig);
+                const userIgnored = await readIgnoreFile(workspace);
+                const ignorePatterns = [
+                    ".storacha",
+                    "node_modules",
+                    ".git",
+                    "dist",
+                    ...userIgnored,
+                ];
+                const allFiles = await scanWorkspaceFiles(workspace, ignorePatterns);
+                if (allFiles.length > 0) {
+                    const changes = allFiles.map((f) => ({
+                        type: "add",
+                        path: f,
+                    }));
+                    await engine.processChanges(changes);
+                    await engine.sync();
+                    console.log(`Uploaded ${allFiles.length} existing files to Storacha.`);
+                }
+                // Save name archive after initial sync
+                const exportedArchive = await engine.exportNameArchive();
+                deviceConfig.nameArchive = exportedArchive;
+                await saveDeviceConfig(workspace, deviceConfig);
                 const { Agent } = await import("@storacha/ucn/pail");
                 const agent = Agent.parse(deviceConfig.agentKey);
                 console.log(`🔥 Storacha workspace ready for ${agentId}!`);
@@ -433,5 +473,45 @@ export default function plugin(api) {
                 process.exit(1);
             }
         });
+        // --- inspect ---
+        clawracha
+            .command("inspect")
+            .description("Inspect internal sync state for debugging")
+            .requiredOption("--agent <id>", "Agent ID")
+            .action(async (opts) => {
+            try {
+                const { agentId, workspace } = requireAgent(opts.agent);
+                const deviceConfig = await loadDeviceConfig(workspace);
+                if (!deviceConfig?.agentKey || !deviceConfig.setupComplete) {
+                    console.log(`Not set up. Run \`openclaw clawracha init --agent ${agentId}\` first.`);
+                    return;
+                }
+                // Spin up a temporary engine to inspect state
+                const storachaClient = await createStorachaClient(deviceConfig);
+                const engine = new SyncEngine(storachaClient, workspace);
+                await engine.init(deviceConfig);
+                const state = await engine.inspect();
+                console.log(`🔥 Storacha Inspect [${agentId}]`);
+                console.log(`Workspace: ${workspace}`);
+                console.log(`Running: ${state.running}`);
+                console.log(`Root CID: ${state.root ?? "(none)"}`);
+                console.log(`Revisions: ${state.revisions.length}`);
+                for (const r of state.revisions) {
+                    console.log(`  event: ${r.event}`);
+                }
+                console.log(`\nPail entries (${state.pailKeys.length}):`);
+                for (const key of state.pailKeys) {
+                    console.log(`  ${key}`);
+                }
+                console.log(`\nPending ops (${state.pendingOps.length}):`);
+                for (const op of state.pendingOps) {
+                    console.log(`  ${op.type} ${op.key}${op.value ? ` → ${op.value}` : ""}`);
+                }
+            }
+            catch (err) {
+                console.error(`Error: ${err.message}`);
+                process.exit(1);
+            }
+        });
     }, { commands: ["clawracha"] });
 }

package/dist/sync.d.ts

@@ -46,11 +46,31 @@ export declare class SyncEngine {
      * Apply remote changes to local filesystem
      */
     private applyRemoteChanges;
+    /**
+     * Mark the engine as stopped.
+     */
+    stop(): void;
     /**
      * Pull all remote state and write to local filesystem.
      * Used by /storacha-join to overwrite local with remote before watcher starts.
      */
     pullRemote(): Promise<number>;
+    /**
+     * Inspect internal state for debugging.
+     */
+    inspect(): Promise<{
+        root: string | null;
+        revisions: {
+            event: string;
+        }[];
+        pailKeys: string[];
+        pendingOps: {
+            type: string;
+            key: string;
+            value?: string;
+        }[];
+        running: boolean;
+    }>;
     status(): Promise<SyncState>;
     exportNameArchive(): Promise<string>;
     private storeBlocks;

package/dist/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EAEV,YAAY,EACb,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1C,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,cAAc,CAAS;gBAEnB,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAMrD;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC/C;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAe1D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkD3B;;OAEG;YACW,iBAAiB;IAc/B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAc5C;;OAEG;YACW,kBAAkB;IAWhC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IA0B7B,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;IAW5B,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;YAM5B,WAAW;CAK1B"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EAEV,YAAY,EACb,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1C,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,cAAc,CAAS;gBAEnB,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAMrD;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC/C;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAe1D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkD3B;;OAEG;YACW,iBAAiB;IAc/B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAc5C;;OAEG;YACW,kBAAkB;IAWhC;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IA0BnC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC;QACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,SAAS,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC5D,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IAiBI,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;IAW5B,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;YAM5B,WAAW;CAK1B"}

package/dist/sync.js

@@ -68,6 +68,7 @@ export class SyncEngine {
                 throw err;
             }
         }
+        this.running = true;
     }
     /**
      * Process a batch of file changes
@@ -163,6 +164,12 @@ export class SyncEngine {
             current: this.current ?? undefined,
         });
     }
+    /**
+     * Mark the engine as stopped.
+     */
+    stop() {
+        this.running = false;
+    }
     /**
      * Pull all remote state and write to local filesystem.
      * Used by /storacha-join to overwrite local with remote before watcher starts.
@@ -192,6 +199,25 @@ export class SyncEngine {
         this.lastSync = Date.now();
         return entries.size;
     }
+    /**
+     * Inspect internal state for debugging.
+     */
+    async inspect() {
+        const entries = await this.getPailEntries();
+        return {
+            root: this.current?.root?.toString() ?? null,
+            revisions: this.current?.revision?.map((r) => ({
+                event: r.event.cid.toString(),
+            })) ?? [],
+            pailKeys: [...entries.keys()],
+            pendingOps: this.pendingOps.map((op) => ({
+                type: op.type,
+                key: op.key,
+                value: op.value?.toString(),
+            })),
+            running: this.running,
+        };
+    }
     async status() {
         const entries = await this.getPailEntries();
         return {

package/dist/utils/ignore.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Read .clawrachaignore from workspace root (gitignore-style).
+ * Returns parsed patterns, or empty array if file doesn't exist.
+ */
+export declare function readIgnoreFile(workspace: string): Promise<string[]>;
+//# sourceMappingURL=ignore.d.ts.map

package/dist/utils/ignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore.d.ts","sourceRoot":"","sources":["../../src/utils/ignore.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAYzE"}

package/dist/utils/ignore.js

@@ -0,0 +1,21 @@
+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.
+ */
+export 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;
+    }
+}

package/dist/watcher.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"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;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;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,27 +5,8 @@
  * before triggering sync.
  */
 import chokidar from "chokidar";
-import * as fs from "node:fs/promises";
+import { readIgnoreFile } from "./utils/ignore.js";
 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();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storacha/clawracha",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "OpenClaw plugin for Storacha workspace sync via UCN Pail",
   "type": "module",
   "files": [
@@ -36,6 +36,7 @@
     "@web3-storage/pail": "0.6.3-rc.3",
     "carstream": "^2.3.0",
     "chokidar": "^3.6.0",
+    "glob": "^13.0.5",
     "multiformats": "^13.0.0"
   },
   "devDependencies": {