@caravo/cli 0.1.0 → 0.2.0

package/dist/cli.js

@@ -173,11 +173,11 @@ function parseArgs(argv) {
     }
     return args;
 }
-const VERSION = "2.0.0";
+const VERSION = "0.2.0";
 async function main() {
     const args = parseArgs(process.argv.slice(2));
     if (args.version) {
-        process.stdout.write(`falm ${VERSION}\n`);
+        process.stdout.write(`caravo ${VERSION}\n`);
         process.exit(0);
     }
     if (args.help || !args.subcommand) {
@@ -192,7 +192,7 @@ async function main() {
     switch (args.subcommand) {
         case "search": {
             const { runSearch } = await import("./commands/search.js");
-            // Join all positional args so "falm search image generation" works like "image generation"
+            // Join all positional args so "caravo search image generation" works like "image generation"
             const query = args.positional.length > 0 ? args.positional.join(" ") : undefined;
             await runSearch(query, {
                 tag: args.tag,

package/dist/commands/fav.js

@@ -1,10 +1,98 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
 import { apiGet, apiPost, apiDelete, validateToolId } from "../lib/api.js";
 import { outputJson, log } from "../lib/output.js";
+// ─── Local favorites ────────────────────────────────────────────────────────
+const FAV_DIR = join(homedir(), ".caravo");
+const FAV_FILE = join(FAV_DIR, "favorites.json");
+function readLocal() {
+    if (!existsSync(FAV_FILE))
+        return { version: "1.0.0", favorites: [] };
+    try {
+        const raw = JSON.parse(readFileSync(FAV_FILE, "utf-8"));
+        if (Array.isArray(raw.favorites))
+            return raw;
+    }
+    catch { }
+    return { version: "1.0.0", favorites: [] };
+}
+function writeLocal(favs) {
+    mkdirSync(FAV_DIR, { recursive: true });
+    writeFileSync(FAV_FILE, JSON.stringify(favs, null, 2) + "\n");
+}
+function localList(compact) {
+    const { favorites } = readLocal();
+    const data = { data: favorites.map((id) => ({ id })), total: favorites.length };
+    outputJson(data, compact);
+}
+function localAdd(toolId) {
+    const favs = readLocal();
+    if (favs.favorites.includes(toolId)) {
+        log(`${toolId} is already in favorites`);
+        return;
+    }
+    favs.favorites.push(toolId);
+    writeLocal(favs);
+    log(`✓ Added ${toolId} to local favorites`);
+}
+function localRm(toolId) {
+    const favs = readLocal();
+    const idx = favs.favorites.indexOf(toolId);
+    if (idx === -1) {
+        log(`${toolId} is not in favorites`);
+        return;
+    }
+    favs.favorites.splice(idx, 1);
+    writeLocal(favs);
+    log(`✓ Removed ${toolId} from local favorites`);
+}
+// ─── Auto-sync: merge local → server on first authenticated run ─────────────
+async function autoSyncLocalToServer(auth) {
+    if (!existsSync(FAV_FILE))
+        return;
+    const local = readLocal();
+    if (local.favorites.length === 0)
+        return;
+    log(`Found ${local.favorites.length} local favorite(s), syncing to server...`);
+    // Get current server favorites to check connectivity and avoid duplicates
+    const serverData = (await apiGet("/api/favorites", auth));
+    if (serverData?.error || !serverData?.data) {
+        log("Server sync skipped (auth failed) — keeping local favorites");
+        return;
+    }
+    const serverIds = new Set(serverData.data.map((f) => f.id));
+    let added = 0;
+    for (const toolId of local.favorites) {
+        if (serverIds.has(toolId))
+            continue;
+        try {
+            await apiPost("/api/favorites", { tool_id: toolId }, auth);
+            added++;
+        }
+        catch {
+            // Tool may no longer exist — skip silently
+        }
+    }
+    // Only remove local file after successful sync
+    try {
+        unlinkSync(FAV_FILE);
+    }
+    catch { }
+    log(`✓ Synced ${added} new favorite(s) to server (local file removed)`);
+}
+// ─── Main entry ─────────────────────────────────────────────────────────────
 export async function run(sub, toolId, auth, compact) {
-    if (auth.mode !== "apikey") {
-        log("Favorites require an API key. Set $CARAVO_API_KEY or use --api-key.");
-        process.exit(1);
+    // Authenticated → server mode (with auto-sync from local on first run)
+    if (auth.mode === "apikey") {
+        await autoSyncLocalToServer(auth);
+        return runServer(sub, toolId, auth, compact);
     }
+    // No API key → local mode
+    log("[local mode — set CARAVO_API_KEY to sync with server]");
+    return runLocal(sub, toolId, compact);
+}
+async function runServer(sub, toolId, auth, compact) {
     switch (sub) {
         case "list": {
             const data = await apiGet("/api/favorites", auth);
@@ -44,3 +132,39 @@ export async function run(sub, toolId, auth, compact) {
             process.exit(1);
     }
 }
+function runLocal(sub, toolId, compact) {
+    switch (sub) {
+        case "list":
+            localList(compact);
+            break;
+        case "add": {
+            if (!toolId) {
+                log("Usage: caravo fav add <tool-id>");
+                process.exit(1);
+            }
+            const err = validateToolId(toolId);
+            if (err) {
+                log(err);
+                process.exit(1);
+            }
+            localAdd(toolId);
+            break;
+        }
+        case "rm": {
+            if (!toolId) {
+                log("Usage: caravo fav rm <tool-id>");
+                process.exit(1);
+            }
+            const err = validateToolId(toolId);
+            if (err) {
+                log(err);
+                process.exit(1);
+            }
+            localRm(toolId);
+            break;
+        }
+        default:
+            log("Usage: caravo fav <list|add|rm> [tool-id]");
+            process.exit(1);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caravo/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Caravo CLI — search, execute, and review tools with API key or x402 USDC payments",
   "type": "module",
   "bin": {