agendex-cli 0.8.4 → 0.9.0

package/README.md

@@ -28,6 +28,33 @@ agendex help                   # Show help message
 agendex --version / -v         # Print CLI version
 ```
 
+## Dev vs prod (config directory)
+
+By default the CLI uses **`~/.agendex/`** for all on-disk state:
+
+- `config.json` — local token, cloud token, Convex URL, device id, enabled adapters
+- `daemon.pid` — supervisor PID and metadata
+- `sync-cache.json` — hashes used to skip unchanged plans on sync
+
+To use a **separate dev environment** (so local cloud / dev login does not overwrite prod credentials), use either:
+
+- **`--dev`** on any command (recommended), or
+- **`AGENDEX_DEV=1`** in the environment
+
+That switches the directory to **`~/.agendex-dev/`** with the same filenames inside it.
+
+`--dev` takes precedence when set programmatically; otherwise `AGENDEX_DEV=1` is read. When you start the daemon with `agendex start --dev`, the background supervisor and worker inherit `AGENDEX_DEV=1` so they stay on the dev config.
+
+Examples:
+
+```bash
+agendex --dev login
+agendex --dev status
+AGENDEX_DEV=1 agendex sync
+```
+
+In dev mode the default OAuth site (when you do not pass `--url` and do not set `AGENDEX_SITE_URL`) points at the local EE app URL used for development.
+
 ## Daemon Cleanup
 
 `agendex cleanup` manages registered daemon devices in the cloud.
@@ -76,6 +103,6 @@ For self-hosted deployments, pass your site URL explicitly:
 agendex login --url https://agendex.yourdomain.com
 ```
 
-This opens your deployment's OAuth flow and stores the returned `cloudToken` and `convexUrl` in `~/.agendex/config.json`.
+This opens your deployment's OAuth flow and stores the returned `cloudToken` and `convexUrl` in your active config directory (`~/.agendex/config.json` for prod, `~/.agendex-dev/config.json` when using `--dev` or `AGENDEX_DEV=1`).
 
-The target can also be set via `AGENDEX_SITE_URL` env var. For local development, set `AGENDEX_DEV=1` to use the local dev server.
+The target can also be set via `AGENDEX_SITE_URL` env var. For local development against the default dev app URL, use `agendex login --dev` or set `AGENDEX_DEV=1` (see [Dev vs prod](#dev-vs-prod-config-directory) above).

package/dist/cli.js

@@ -2253,17 +2253,29 @@ async function promptForAdapterSelection(options = {}) {
 }
 
 // ../shared/src/config.ts
-var configDir = join7(homedir7(), ".agendex");
-var configPath = join7(configDir, "config.json");
+var devModeOverride;
+function setDevMode(dev) {
+  devModeOverride = dev;
+}
+function isDevMode() {
+  if (devModeOverride !== undefined)
+    return devModeOverride;
+  return process.env.AGENDEX_DEV === "1";
+}
+function getConfigDir() {
+  return join7(homedir7(), isDevMode() ? ".agendex-dev" : ".agendex");
+}
 function ensureConfigDir() {
-  if (!existsSync3(configDir))
-    mkdirSync(configDir, { recursive: true });
+  const dir = getConfigDir();
+  if (!existsSync3(dir))
+    mkdirSync(dir, { recursive: true });
 }
 function readStoredConfig() {
-  if (!existsSync3(configPath))
+  const cfgPath = getConfigPath();
+  if (!existsSync3(cfgPath))
     return null;
   try {
-    const raw = JSON.parse(readFileSync3(configPath, "utf-8"));
+    const raw = JSON.parse(readFileSync3(cfgPath, "utf-8"));
     if (!raw || typeof raw !== "object")
       return null;
     return raw;
@@ -2305,7 +2317,7 @@ function saveConfig(config) {
     deviceId: config.deviceId,
     enabledAdapters: sanitizeEnabledAdapterIds(config.enabledAdapters)
   };
-  writeFileSync(configPath, JSON.stringify(payload, null, 2));
+  writeFileSync(getConfigPath(), JSON.stringify(payload, null, 2));
 }
 function generateToken() {
   return randomBytes(32).toString("hex");
@@ -2324,7 +2336,7 @@ function loadOrCreateToken() {
   });
   console.log(`
 [agendex] generated auth token: ${token}`);
-  console.log(`[agendex] saved to ${configPath}
+  console.log(`[agendex] saved to ${getConfigPath()}
 `);
   return token;
 }
@@ -2341,6 +2353,9 @@ function loadOrCreateDeviceId() {
   });
   return deviceId;
 }
+function getConfigPath() {
+  return join7(getConfigDir(), "config.json");
+}
 async function loadOrInitConfig(options = {}) {
   const configureAdapters = Boolean(options.configureAdapters);
   const existing = loadConfig();
@@ -2389,7 +2404,9 @@ import { existsSync as existsSync4, readdirSync as readdirSync3, statSync } from
 import { lstat, mkdir, readdir as readdir2, readFile as readFile6, stat as stat6, writeFile as writeFile3 } from "node:fs/promises";
 import { homedir as homedir8 } from "node:os";
 import { join as join8, resolve as resolve2, sep as sep2 } from "node:path";
-var USER_PLANS_DIR = join8(homedir8(), ".agendex", "plans");
+function getUserPlansDir() {
+  return join8(getConfigDir(), "plans");
+}
 var store = new Map;
 var MAX_DEPTH = 6;
 var DISCOVERY_MAX_DEPTH = 4;
@@ -2496,9 +2513,10 @@ async function walkDir(dir, depth = 0, seen = new Set) {
   return files;
 }
 async function scanUserPlans() {
-  if (!existsSync4(USER_PLANS_DIR))
+  const userPlansDir = getUserPlansDir();
+  if (!existsSync4(userPlansDir))
     return;
-  const files = await walkDir(USER_PLANS_DIR);
+  const files = await walkDir(userPlansDir);
   for (const file of files) {
     if (!file.endsWith(".md"))
       continue;
@@ -2654,22 +2672,26 @@ import { hostname as osHostname } from "node:os";
 
 // src/pid.ts
 import { existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync4, unlinkSync, writeFileSync as writeFileSync2 } from "node:fs";
-import { homedir as homedir9, hostname } from "node:os";
+import { hostname } from "node:os";
 import { dirname, join as join10 } from "node:path";
-var pidPath = join10(homedir9(), ".agendex", "daemon.pid");
+function getPidPath() {
+  return join10(getConfigDir(), "daemon.pid");
+}
 function writePid() {
-  mkdirSync2(dirname(pidPath), { recursive: true });
+  const path = getPidPath();
+  mkdirSync2(dirname(path), { recursive: true });
   const info = {
     pid: process.pid,
     startedAtMs: Date.now(),
     hostname: hostname()
   };
-  writeFileSync2(pidPath, JSON.stringify(info));
+  writeFileSync2(path, JSON.stringify(info));
 }
 function readPidInfo() {
-  if (!existsSync6(pidPath))
+  const path = getPidPath();
+  if (!existsSync6(path))
     return null;
-  const raw = readFileSync4(pidPath, "utf-8").trim();
+  const raw = readFileSync4(path, "utf-8").trim();
   const asNumber = Number(raw);
   if (Number.isFinite(asNumber) && asNumber > 0 && !raw.startsWith("{")) {
     return { pid: asNumber };
@@ -2686,7 +2708,7 @@ function readPid() {
 }
 function removePid() {
   try {
-    unlinkSync(pidPath);
+    unlinkSync(getPidPath());
   } catch {}
 }
 function isRunning(pid) {
@@ -2706,7 +2728,10 @@ function getCloudConfig() {
     throw new Error("Not logged in. Run `agendex login` first.");
   if (!config.convexUrl)
     throw new Error("No Convex URL configured. Run `agendex login` first.");
-  return { token: config.cloudToken, convexUrl: config.convexUrl };
+  return {
+    token: config.cloudToken,
+    convexUrl: config.convexUrl
+  };
 }
 async function syncPlan(plan) {
   const { token, convexUrl } = getCloudConfig();
@@ -2914,7 +2939,7 @@ var DEV_SITE_URL = "http://app.agendex.local:5174";
 function getDefaultSiteUrl() {
   if (process.env.AGENDEX_SITE_URL)
     return process.env.AGENDEX_SITE_URL;
-  return process.env.AGENDEX_DEV === "1" ? DEV_SITE_URL : PROD_SITE_URL;
+  return isDevMode() ? DEV_SITE_URL : PROD_SITE_URL;
 }
 async function login(siteUrlOverride) {
   const { port, result } = await startCallbackServer();
@@ -3104,6 +3129,56 @@ function spawnBrowser(command, args, options = {}) {
 import { spawn as spawn2 } from "node:child_process";
 import { resolve as resolve4 } from "node:path";
 import { fileURLToPath } from "node:url";
+
+// src/sync-cache.ts
+import { createHash as createHash2 } from "node:crypto";
+import { existsSync as existsSync7, mkdirSync as mkdirSync3, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "node:fs";
+import { join as join11 } from "node:path";
+function getCachePath() {
+  return join11(getConfigDir(), "sync-cache.json");
+}
+function loadSyncCache() {
+  const cachePath = getCachePath();
+  if (!existsSync7(cachePath))
+    return {};
+  try {
+    const raw = JSON.parse(readFileSync5(cachePath, "utf-8"));
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+      return {};
+    return raw;
+  } catch {
+    return {};
+  }
+}
+function saveSyncCache(cache, options) {
+  const dir = getConfigDir();
+  if (!existsSync7(dir))
+    mkdirSync3(dir, { recursive: true });
+  const cachePath = getCachePath();
+  if (options?.replace) {
+    writeFileSync3(cachePath, JSON.stringify(cache));
+    return;
+  }
+  const existing = loadSyncCache();
+  writeFileSync3(cachePath, JSON.stringify({ ...existing, ...cache }));
+}
+function computePayloadHash(payload) {
+  const canonical = JSON.stringify([
+    payload.localPlanId,
+    payload.agent,
+    payload.title,
+    payload.content,
+    payload.format,
+    payload.filePath ?? null,
+    payload.workspace ?? null,
+    payload.metadata ?? null,
+    payload.createdAt ?? null,
+    payload.updatedAt ?? null
+  ]);
+  return createHash2("sha256").update(canonical).digest("hex").slice(0, 20);
+}
+
+// src/daemon.ts
 var MAX_RESTARTS = 5;
 var RESTART_WINDOW_MS = 60000;
 var RESTART_DELAY_MS = 5000;
@@ -3127,6 +3202,7 @@ async function runWorker() {
   setActiveAdapters(adapters);
   console.log(`[agendex] daemon starting with ${config.enabledAdapters.length} adapters`);
   sendHeartbeat();
+  const syncCache = loadSyncCache();
   const syncQueue = [];
   let syncing = false;
   async function tryRefreshToken() {
@@ -3167,6 +3243,7 @@ async function runWorker() {
           console.error(`[agendex] sync failed for "${payload.title}": ${result.error}`);
         } else {
           syncedCount++;
+          syncCache[payload.localPlanId] = computePayloadHash(payload);
         }
       }
     } catch (err) {
@@ -3176,6 +3253,7 @@ async function runWorker() {
       syncing = false;
     }
     if (syncedCount > 0 || failedCount > 0) {
+      saveSyncCache(syncCache);
       console.log(`[agendex] sync complete: ${syncedCount} synced, ${failedCount} failed`);
     }
     if (syncQueue.length > 0)
@@ -3185,10 +3263,23 @@ async function runWorker() {
   console.log(`[agendex] initial scan...`);
   await scan();
   const plans = getAll();
-  console.log(`[agendex] syncing ${plans.length} plans...`);
+  let initialSkipped = 0;
   for (const plan of plans) {
-    syncQueue.push(planToPayload(plan));
+    const payload = planToPayload(plan);
+    const hash = computePayloadHash(payload);
+    if (syncCache[plan.id] === hash) {
+      initialSkipped++;
+      continue;
+    }
+    syncQueue.push(payload);
   }
+  const activePlanIds = new Set(plans.map((plan) => plan.id));
+  for (const id of Object.keys(syncCache)) {
+    if (!activePlanIds.has(id))
+      delete syncCache[id];
+  }
+  saveSyncCache(syncCache, { replace: true });
+  console.log(`[agendex] syncing ${syncQueue.length} plans (${initialSkipped} unchanged)...`);
   await processSyncQueue();
   setInterval(() => void sendHeartbeat(), CLI_DAEMON_HEARTBEAT_INTERVAL_MS);
   startWatching((changedPlans) => {
@@ -3249,7 +3340,7 @@ async function startSupervisor() {
 }
 
 // src/sync.ts
-async function syncAll() {
+async function syncAll(force = false) {
   const config = await loadOrInitConfig();
   const adapters = resolveAdapters(config.enabledAdapters);
   setActiveAdapters(adapters);
@@ -3257,9 +3348,13 @@ async function syncAll() {
   await scan();
   const plans = getAll();
   console.log(`[agendex] Found ${plans.length} plans. Syncing to cloud...`);
+  const cache = force ? {} : loadSyncCache();
+  const activePlanIds = new Set;
   let synced = 0;
+  let skipped = 0;
   let failed = 0;
   for (const plan of plans) {
+    activePlanIds.add(plan.id);
     const payload = {
       localPlanId: plan.id,
       agent: plan.agent,
@@ -3268,27 +3363,40 @@ async function syncAll() {
       format: plan.format,
       filePath: plan.filePath,
       workspace: plan.workspace,
-      metadata: plan.metadata
+      metadata: plan.metadata,
+      createdAt: plan.createdAt.getTime(),
+      updatedAt: plan.updatedAt.getTime()
     };
+    const hash = computePayloadHash(payload);
+    if (!force && cache[plan.id] === hash) {
+      skipped++;
+      continue;
+    }
     const result = await syncPlan(payload);
     if (result.ok) {
       synced++;
+      cache[plan.id] = hash;
     } else {
       failed++;
       console.error(`[agendex] Failed to sync "${plan.title}": ${result.error}`);
     }
   }
-  console.log(`[agendex] Sync complete: ${synced} synced, ${failed} failed`);
+  for (const id of Object.keys(cache)) {
+    if (!activePlanIds.has(id))
+      delete cache[id];
+  }
+  saveSyncCache(cache, { replace: true });
+  console.log(`[agendex] Sync complete: ${synced} synced, ${skipped} unchanged, ${failed} failed`);
 }
 
 // src/version.ts
-import { existsSync as existsSync7, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "node:fs";
+import { existsSync as existsSync8, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "node:fs";
 import { tmpdir } from "node:os";
-import { join as join11 } from "node:path";
+import { join as join12 } from "node:path";
 // package.json
 var package_default = {
   name: "agendex-cli",
-  version: "0.8.4",
+  version: "0.9.0",
   description: "Agendex CLI for login, sync, and daemon workflows",
   homepage: "https://github.com/Tyru5/Agendex#readme",
   repository: {
@@ -3332,14 +3440,14 @@ var package_default = {
 
 // src/version.ts
 var CLI_VERSION = package_default.version;
-var CACHE_FILE = process.env.AGENDEX_UPDATE_CACHE_FILE ?? join11(tmpdir(), ".agendex-update-cache.json");
+var CACHE_FILE = process.env.AGENDEX_UPDATE_CACHE_FILE ?? join12(tmpdir(), ".agendex-update-cache.json");
 var CACHE_TTL_MS = 24 * 60 * 60 * 1000;
 var UPDATE_URL = process.env.AGENDEX_UPDATE_URL ?? "https://registry.npmjs.org/agendex-cli/latest";
 function readCache(current) {
   try {
-    if (!existsSync7(CACHE_FILE))
+    if (!existsSync8(CACHE_FILE))
       return null;
-    const { result, ts } = JSON.parse(readFileSync5(CACHE_FILE, "utf8"));
+    const { result, ts } = JSON.parse(readFileSync6(CACHE_FILE, "utf8"));
     if (Date.now() - ts > CACHE_TTL_MS)
       return null;
     return normalizeResult(result, current);
@@ -3349,7 +3457,7 @@ function readCache(current) {
 }
 function writeCache(result) {
   try {
-    writeFileSync3(CACHE_FILE, JSON.stringify({ result, ts: Date.now() }));
+    writeFileSync4(CACHE_FILE, JSON.stringify({ result, ts: Date.now() }));
   } catch {}
 }
 async function checkForUpdate() {
@@ -3400,7 +3508,18 @@ function isNewer(latest, current) {
 
 // src/cli.ts
 var args = process.argv.slice(2);
-var command = args[0] ?? "start";
+var devFlag = args.includes("--dev");
+if (devFlag)
+  setDevMode(true);
+function firstCommandToken(argv) {
+  for (const a of argv) {
+    if (a === "--dev")
+      continue;
+    return a;
+  }
+  return;
+}
+var command = firstCommandToken(args) ?? "start";
 var cliEntry = resolve5(process.argv[1] ?? fileURLToPath2(import.meta.url));
 async function main() {
   const isInternal = args.includes("--daemon") || args.includes("--worker");
@@ -3443,9 +3562,13 @@ async function main() {
       }
       if (existingPid)
         removePid();
-      const child = spawn3(process.execPath, [cliEntry, "start", "--daemon"], {
+      const daemonArgs = [cliEntry, "start", "--daemon"];
+      if (devFlag)
+        daemonArgs.push("--dev");
+      const child = spawn3(process.execPath, daemonArgs, {
         detached: true,
-        stdio: "ignore"
+        stdio: "ignore",
+        env: { ...process.env, ...devFlag ? { AGENDEX_DEV: "1" } : {} }
       });
       child.unref();
       await new Promise((r) => setTimeout(r, 500));
@@ -3489,7 +3612,8 @@ async function main() {
       return 0;
     }
     case "sync": {
-      await syncAll();
+      const force = args.includes("--force");
+      await syncAll(force);
       return 0;
     }
     case "cleanup": {
@@ -3622,13 +3746,17 @@ Usage:
   agendex login --url <url>  Login to a self-hosted instance
   agendex logout       Clear stored cloud token
   agendex configure    Select which agents/adapters to index
-  agendex sync         One-shot scan + sync to cloud
+  agendex sync         One-shot scan + sync to cloud (skips unchanged plans)
+  agendex sync --force Re-sync all plans, ignoring cache
   agendex cleanup      Interactively remove cloud daemons
   agendex cleanup --stale  Auto-remove all stale daemons
   agendex status       Show current config state + daemon status
   agendex help         Show this help message
   agendex --version    Print CLI version
   agendex -v           Print CLI version
+
+Flags:
+  --dev                Use dev environment (~/.agendex-dev/ config dir)
 `.trim());
       return 0;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agendex-cli",
-  "version": "0.8.4",
+  "version": "0.9.0",
   "description": "Agendex CLI for login, sync, and daemon workflows",
   "homepage": "https://github.com/Tyru5/Agendex#readme",
   "repository": {