@caravo/cli 0.1.1 → 0.2.1

package/README.md

@@ -29,7 +29,7 @@ caravo review EXECUTION_ID --rating 5 --comment "Great quality"
 # Upvote an existing review
 caravo upvote REVIEW_ID --exec EXECUTION_ID
 
-# Manage favorites (requires API key)
+# Manage favorites (works with or without API key)
 caravo fav list
 caravo fav add fal-ai/flux/schnell
 caravo fav rm fal-ai/flux/schnell

package/dist/cli.js

@@ -169,11 +169,16 @@ function parseArgs(argv) {
         else if (!arg.startsWith("-")) {
             args.positional.push(arg);
         }
+        else {
+            // Unknown flag
+            process.stderr.write(`[caravo] unknown option: ${arg}\n`);
+            process.exit(1);
+        }
         i++;
     }
     return args;
 }
-const VERSION = "0.1.1";
+const VERSION = "0.2.1";
 async function main() {
     const args = parseArgs(process.argv.slice(2));
     if (args.version) {
@@ -218,8 +223,14 @@ async function main() {
             break;
         }
         case "exec": {
-            const { run } = await import("./commands/exec.js");
-            await run(args.positional[0], args.data, auth, args.compact);
+            if (args.dryRun) {
+                const { runDryRun } = await import("./commands/exec.js");
+                await runDryRun(args.positional[0], args.data, auth, args.compact);
+            }
+            else {
+                const { run } = await import("./commands/exec.js");
+                await run(args.positional[0], args.data, auth, args.compact);
+            }
             break;
         }
         case "dry-run": {

package/dist/commands/fav.js

@@ -1,10 +1,109 @@
+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);
+}
+async function localAdd(toolId, baseUrl) {
+    // Verify tool exists on server before adding
+    try {
+        const r = await fetch(`${baseUrl}/api/tools/${toolId}`);
+        if (r.status === 404) {
+            log(`Tool not found: ${toolId}`);
+            process.exit(1);
+        }
+    }
+    catch {
+        // Network error — allow offline add
+    }
+    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, auth.baseUrl);
+}
+async function runServer(sub, toolId, auth, compact) {
     switch (sub) {
         case "list": {
             const data = await apiGet("/api/favorites", auth);
@@ -44,3 +143,39 @@ export async function run(sub, toolId, auth, compact) {
             process.exit(1);
     }
 }
+async function runLocal(sub, toolId, compact, baseUrl) {
+    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);
+            }
+            await localAdd(toolId, baseUrl);
+            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.1",
+  "version": "0.2.1",
   "description": "Caravo CLI — search, execute, and review tools with API key or x402 USDC payments",
   "type": "module",
   "bin": {