clawon 0.1.1 → 0.1.3

package/dist/index.js

@@ -5,9 +5,11 @@ import { Command } from "commander";
 import fs from "fs";
 import path from "path";
 import os from "os";
+import zlib from "zlib";
 var CONFIG_DIR = path.join(os.homedir(), ".clawon");
 var CONFIG_PATH = path.join(CONFIG_DIR, "config.json");
 var OPENCLAW_DIR = path.join(os.homedir(), ".openclaw");
+var BACKUPS_DIR = path.join(CONFIG_DIR, "backups");
 function ensureDir(dir) {
   fs.mkdirSync(dir, { recursive: true });
 }
@@ -91,6 +93,39 @@ function discoverFiles(baseDir) {
   walk(baseDir);
   return files;
 }
+function createLocalArchive(files, openclawDir) {
+  const archiveFiles = files.map((f) => {
+    const fullPath = path.join(openclawDir, f.path);
+    const content = fs.readFileSync(fullPath).toString("base64");
+    return { path: f.path, size: f.size, content };
+  });
+  const archive = {
+    version: 1,
+    created: (/* @__PURE__ */ new Date()).toISOString(),
+    files: archiveFiles
+  };
+  return zlib.gzipSync(JSON.stringify(archive));
+}
+function extractLocalArchive(archivePath) {
+  const compressed = fs.readFileSync(archivePath);
+  const json = zlib.gunzipSync(compressed).toString("utf8");
+  const archive = JSON.parse(json);
+  return { created: archive.created, files: archive.files };
+}
+var POSTHOG_KEY = "phc_LGJC4ZrED6EiK0sC1fusErOhR6gHlFCS5Qs7ou93SmV";
+function trackCliEvent(distinctId, event, properties = {}) {
+  fetch("https://us.i.posthog.com/capture/", {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({
+      api_key: POSTHOG_KEY,
+      distinct_id: distinctId,
+      event,
+      properties: { ...properties, source: "cli" }
+    })
+  }).catch(() => {
+  });
+}
 var program = new Command();
 program.name("clawon").description("Backup and restore your OpenClaw workspace").version("0.1.1");
 program.command("login").description("Connect to Clawon with your API key").requiredOption("--api-key <key>", "Your Clawon API key").option("--api-url <url>", "API base URL", "https://clawon.io").action(async (opts) => {
@@ -182,9 +217,21 @@ program.command("backup").description("Backup your OpenClaw workspace to the clo
     console.log(`  Snapshot ID: ${snapshotId}`);
     console.log(`  Files: ${files.length}`);
     console.log(`  Size: ${(totalSize / 1024).toFixed(1)} KB`);
+    trackCliEvent(cfg.profileId, "cloud_backup_created", {
+      file_count: files.length,
+      total_bytes: totalSize
+    });
   } catch (e) {
-    console.error(`
-\u2717 Backup failed: ${e.message}`);
+    const msg = e.message;
+    if (msg.includes("Snapshot limit")) {
+      console.error("\n\u2717 Snapshot limit reached (2).");
+      console.error("  Delete one first:  clawon delete <id>");
+      console.error("  Delete oldest:     clawon delete --oldest");
+      console.error("  List snapshots:    clawon list");
+    } else {
+      console.error(`
+\u2717 Backup failed: ${msg}`);
+    }
     process.exit(1);
   }
 });
@@ -230,9 +277,16 @@ program.command("restore").description("Restore your OpenClaw workspace from the
       process.stdout.write(`\r  Downloaded: ${downloaded}/${files.length}`);
     }
     console.log("");
+    await api(cfg.apiBaseUrl, "/api/v1/snapshots/restore", "POST", cfg.apiKey, {
+      profileId: cfg.profileId,
+      snapshotId: snapshot.id
+    });
     console.log("\n\u2713 Restore complete!");
     console.log(`  Restored to: ${OPENCLAW_DIR}`);
     console.log(`  Files: ${files.length}`);
+    trackCliEvent(cfg.profileId, "cloud_backup_restored", {
+      file_count: files.length
+    });
   } catch (e) {
     console.error(`
 \u2717 Restore failed: ${e.message}`);
@@ -272,6 +326,102 @@ Total: ${snapshots.length} backup(s)`);
     process.exit(1);
   }
 });
+var ACTIVITY_LABELS = {
+  BACKUP_CREATED: "Backup created",
+  SNAPSHOT_CREATED: "Snapshot created",
+  SNAPSHOT_DELETED: "Snapshot deleted",
+  SNAPSHOT_RESTORED: "Snapshot restored",
+  BACKUP_DOWNLOADED: "Backup downloaded",
+  CONNECTED: "Connected",
+  DISCONNECTED: "Disconnected"
+};
+function formatEventLabel(type) {
+  return ACTIVITY_LABELS[type] || type.replace(/_/g, " ").toLowerCase().replace(/^\w/, (c) => c.toUpperCase());
+}
+function formatEventDetails(payload) {
+  if (!payload || typeof payload !== "object") return "";
+  const parts = [];
+  if (payload.fileCount != null || payload.changedFilesCount != null) {
+    parts.push(`${payload.fileCount ?? payload.changedFilesCount} files`);
+  }
+  if (payload.snapshotId) {
+    parts.push(payload.snapshotId);
+  }
+  if (payload.instanceName) {
+    parts.push(payload.instanceName);
+  }
+  return parts.join(" \xB7 ");
+}
+program.command("activity").description("Show recent activity").option("--limit <n>", "Number of events to show", "10").action(async (opts) => {
+  const cfg = readConfig();
+  if (!cfg) {
+    console.error("\u2717 Not logged in. Run: clawon login --api-key <key>");
+    process.exit(1);
+  }
+  try {
+    const { events } = await api(
+      cfg.apiBaseUrl,
+      `/api/v1/events/list?profileId=${cfg.profileId}&limit=${opts.limit}`,
+      "GET",
+      cfg.apiKey
+    );
+    if (!events?.length) {
+      console.log("No activity yet. Run: clawon backup");
+      return;
+    }
+    console.log("Recent activity:\n");
+    console.log("Date                 | Event              | Details");
+    console.log("\u2500".repeat(80));
+    for (const ev of events) {
+      const date = new Date(ev.created_at).toLocaleString();
+      const label = formatEventLabel(ev.type);
+      const details = formatEventDetails(ev.payload);
+      console.log(`${date.padEnd(20)} | ${label.padEnd(18)} | ${details}`);
+    }
+  } catch (e) {
+    console.error(`\u2717 Failed to load activity: ${e.message}`);
+    process.exit(1);
+  }
+});
+program.command("delete [id]").description("Delete a snapshot").option("--oldest", "Delete the oldest ready snapshot").action(async (id, opts) => {
+  const cfg = readConfig();
+  if (!cfg) {
+    console.error("\u2717 Not logged in. Run: clawon login --api-key <key>");
+    process.exit(1);
+  }
+  if (!id && !opts.oldest) {
+    console.error("\u2717 Provide a snapshot ID or use --oldest");
+    console.error("  Usage:  clawon delete <id>");
+    console.error("          clawon delete --oldest");
+    process.exit(1);
+  }
+  try {
+    let snapshotId = id;
+    if (opts.oldest) {
+      const { snapshots } = await api(
+        cfg.apiBaseUrl,
+        `/api/v1/snapshots/list?profileId=${cfg.profileId}&limit=50`,
+        "GET",
+        cfg.apiKey
+      );
+      const readySnapshots = (snapshots || []).filter((s) => s.status === "ready");
+      if (readySnapshots.length === 0) {
+        console.error("\u2717 No ready snapshots to delete");
+        process.exit(1);
+      }
+      snapshotId = readySnapshots[readySnapshots.length - 1].id;
+      console.log(`Oldest ready snapshot: ${snapshotId}`);
+    }
+    await api(cfg.apiBaseUrl, "/api/v1/snapshots/delete", "POST", cfg.apiKey, {
+      profileId: cfg.profileId,
+      snapshotId
+    });
+    console.log(`\u2713 Deleted snapshot ${snapshotId}`);
+  } catch (e) {
+    console.error(`\u2717 Delete failed: ${e.message}`);
+    process.exit(1);
+  }
+});
 program.command("files").description("List files in a backup").option("--snapshot <id>", "Snapshot ID (default: latest)").action(async (opts) => {
   const cfg = readConfig();
   if (!cfg) {
@@ -312,6 +462,118 @@ Total: ${files.length} files`);
     process.exit(1);
   }
 });
+var local = program.command("local").description("Local backup and restore (no cloud required)");
+local.command("backup").description("Save a local backup of your OpenClaw workspace").action(async () => {
+  if (!fs.existsSync(OPENCLAW_DIR)) {
+    console.error(`\u2717 OpenClaw directory not found: ${OPENCLAW_DIR}`);
+    process.exit(1);
+  }
+  console.log("Discovering files...");
+  const files = discoverFiles(OPENCLAW_DIR);
+  if (files.length === 0) {
+    console.error("\u2717 No files found to backup");
+    process.exit(1);
+  }
+  const totalSize = files.reduce((sum, f) => sum + f.size, 0);
+  console.log(`Found ${files.length} files (${(totalSize / 1024).toFixed(1)} KB)`);
+  console.log("Creating archive...");
+  const archive = createLocalArchive(files, OPENCLAW_DIR);
+  ensureDir(BACKUPS_DIR);
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "").replace("T", "T").slice(0, 15);
+  const filename = `backup-${timestamp}.tar.gz`;
+  const filePath = path.join(BACKUPS_DIR, filename);
+  fs.writeFileSync(filePath, archive);
+  console.log(`
+\u2713 Local backup saved!`);
+  console.log(`  File: ${filePath}`);
+  console.log(`  Files: ${files.length}`);
+  console.log(`  Size: ${(archive.length / 1024).toFixed(1)} KB (compressed)`);
+  const cfg = readConfig();
+  trackCliEvent(cfg?.profileId || "anonymous", "local_backup_created", {
+    file_count: files.length,
+    total_bytes: totalSize
+  });
+});
+local.command("list").description("List local backups").action(async () => {
+  if (!fs.existsSync(BACKUPS_DIR)) {
+    console.log("No local backups yet. Run: clawon local backup");
+    return;
+  }
+  const entries = fs.readdirSync(BACKUPS_DIR).filter((f) => f.endsWith(".tar.gz")).sort().reverse();
+  if (entries.length === 0) {
+    console.log("No local backups yet. Run: clawon local backup");
+    return;
+  }
+  console.log("Local backups:\n");
+  console.log("#  | Date                      | Files | Size");
+  console.log("\u2500".repeat(60));
+  for (let i = 0; i < entries.length; i++) {
+    const filePath = path.join(BACKUPS_DIR, entries[i]);
+    try {
+      const { created, files } = extractLocalArchive(filePath);
+      const totalSize = files.reduce((sum, f) => sum + f.size, 0);
+      const date = new Date(created).toLocaleString();
+      console.log(
+        `${String(i + 1).padStart(2)} | ${date.padEnd(25)} | ${String(files.length).padEnd(5)} | ${(totalSize / 1024).toFixed(1)} KB`
+      );
+    } catch {
+      console.log(`${String(i + 1).padStart(2)} | ${entries[i].padEnd(25)} | ???   | ???`);
+    }
+  }
+  console.log(`
+Total: ${entries.length} backup(s)`);
+  console.log(`Location: ${BACKUPS_DIR}`);
+});
+local.command("restore").description("Restore from a local backup").option("--file <path>", "Path to an external backup file").action(async (opts) => {
+  let archivePath;
+  if (opts.file) {
+    archivePath = path.resolve(opts.file);
+    if (!fs.existsSync(archivePath)) {
+      console.error(`\u2717 File not found: ${archivePath}`);
+      process.exit(1);
+    }
+  } else {
+    if (!fs.existsSync(BACKUPS_DIR)) {
+      console.error("\u2717 No local backups found. Run: clawon local backup");
+      process.exit(1);
+    }
+    const entries = fs.readdirSync(BACKUPS_DIR).filter((f) => f.endsWith(".tar.gz")).sort().reverse();
+    if (entries.length === 0) {
+      console.error("\u2717 No local backups found. Run: clawon local backup");
+      process.exit(1);
+    }
+    archivePath = path.join(BACKUPS_DIR, entries[0]);
+  }
+  console.log(`Restoring from: ${archivePath}`);
+  try {
+    const { created, files } = extractLocalArchive(archivePath);
+    const totalSize = files.reduce((sum, f) => sum + f.size, 0);
+    console.log(`Backup date: ${new Date(created).toLocaleString()}`);
+    console.log(`Files: ${files.length} (${(totalSize / 1024).toFixed(1)} KB)`);
+    let restored = 0;
+    for (const file of files) {
+      const targetPath = path.join(OPENCLAW_DIR, file.path);
+      ensureDir(path.dirname(targetPath));
+      fs.writeFileSync(targetPath, Buffer.from(file.content, "base64"));
+      restored++;
+      process.stdout.write(`\r  Restored: ${restored}/${files.length}`);
+    }
+    console.log("");
+    console.log(`
+\u2713 Restore complete!`);
+    console.log(`  Restored to: ${OPENCLAW_DIR}`);
+    console.log(`  Files: ${files.length}`);
+    const cfg = readConfig();
+    trackCliEvent(cfg?.profileId || "anonymous", "local_backup_restored", {
+      file_count: files.length,
+      source: opts.file ? "file" : "local"
+    });
+  } catch (e) {
+    console.error(`
+\u2717 Restore failed: ${e.message}`);
+    process.exit(1);
+  }
+});
 program.command("status").description("Show current status").action(async () => {
   const cfg = readConfig();
   console.log("Clawon Status\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawon",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Backup and restore your OpenClaw workspace",
   "type": "module",
   "bin": {
@@ -15,7 +15,13 @@
     "prepublishOnly": "npm run build",
     "start": "tsx src/index.ts"
   },
-  "keywords": ["openclaw", "clawon", "backup", "restore", "cli"],
+  "keywords": [
+    "openclaw",
+    "clawon",
+    "backup",
+    "restore",
+    "cli"
+  ],
   "license": "MIT",
   "dependencies": {
     "commander": "^12.1.0"