agendex-cli 0.4.0 → 0.6.0

package/README.md

@@ -14,15 +14,39 @@ bun install -g agendex-cli
 ## Commands
 
 ```bash
-agendex login
-agendex login --url https://agendex.yourdomain.com
-agendex configure
-agendex start
-agendex stop
-agendex sync
-agendex status
-agendex logout
+agendex login                  # Authenticate via browser OAuth (agendex.dev)
+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 start                  # Start daemon (backgrounds itself)
+agendex stop                   # Stop the running daemon
+agendex sync                   # One-shot scan + sync to cloud
+agendex status                 # Show config state, daemon status, uptime & hostname
+agendex help                   # Show help message
+agendex --version / -v         # Print CLI version
+```
+
+## Status Output
+
+`agendex status` prints a rich overview:
+
+- Config version, local/cloud token state, Convex URL
+- Enabled adapters
+- Daemon running state with PID
+- **Uptime** — how long the daemon has been running
+- **Hostname** — machine the daemon is running on
+- CLI version
+
+## Auto-Update Check
+
+Before running `start`, `configure`, or `sync`, the CLI checks for a newer published version. If an update is required the command is blocked and you are prompted to upgrade:
+
 ```
+[agendex] update required: v0.1.0 → v0.2.0
+[agendex] run: npm i -g agendex-cli
+```
+
+The check is skipped for `stop`, `status`, `login`, `logout`, and `help`.
 
 ## Supported Runtime
 

package/dist/cli.js

@@ -2127,11 +2127,13 @@ function normalizeStoredConfig(raw) {
   const token = typeof raw.token === "string" && raw.token.trim() ? raw.token : undefined;
   const cloudToken = typeof raw.cloudToken === "string" && raw.cloudToken.trim() ? raw.cloudToken : undefined;
   const convexUrl = typeof raw.convexUrl === "string" && raw.convexUrl.trim() ? raw.convexUrl : undefined;
+  const deviceId = typeof raw.deviceId === "string" && raw.deviceId.trim() ? raw.deviceId : undefined;
   return {
     configVersion: 3,
     token,
     cloudToken,
     convexUrl,
+    deviceId,
     enabledAdapters: normalizeAdapterIds(raw.enabledAdapters)
   };
 }
@@ -2145,6 +2147,7 @@ function saveConfig(config) {
     token: config.token,
     cloudToken: config.cloudToken,
     convexUrl: config.convexUrl,
+    deviceId: config.deviceId,
     enabledAdapters: sanitizeEnabledAdapterIds(config.enabledAdapters)
   };
   writeFileSync(configPath, JSON.stringify(payload, null, 2));
@@ -2170,6 +2173,19 @@ function loadOrCreateToken() {
 `);
   return token;
 }
+function loadOrCreateDeviceId() {
+  const existing = loadConfig();
+  if (existing?.deviceId)
+    return existing.deviceId;
+  const deviceId = randomBytes(16).toString("hex");
+  saveConfig({
+    ...existing ?? {},
+    configVersion: 3,
+    deviceId,
+    enabledAdapters: existing?.enabledAdapters ?? []
+  });
+  return deviceId;
+}
 async function loadOrInitConfig(options = {}) {
   const configureAdapters = Boolean(options.configureAdapters);
   const existing = loadConfig();
@@ -2195,11 +2211,13 @@ async function loadOrInitConfig(options = {}) {
     if (enabledAdapters.length === 0)
       enabledAdapters = getDefaultAdapterIds();
   }
+  const deviceId = existing?.deviceId || randomBytes(16).toString("hex");
   const nextConfig = {
     configVersion: 3,
     token: tokenFromEnv ? existing?.token : currentToken,
     cloudToken: existing?.cloudToken,
     convexUrl: existing?.convexUrl,
+    deviceId,
     enabledAdapters
   };
   saveConfig(nextConfig);
@@ -2477,11 +2495,17 @@ function startWatching(onChange) {
 // src/auth.ts
 import { spawn } from "node:child_process";
 import { createServer } from "node:http";
-var DEFAULT_SITE_URL = "https://app.agendex.dev";
+var PROD_SITE_URL = "https://app.agendex.dev";
+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;
+}
 async function login(siteUrlOverride) {
   const { port, result } = await startCallbackServer();
   const callbackUrl = `http://127.0.0.1:${port}/callback`;
-  const siteUrl = siteUrlOverride ?? DEFAULT_SITE_URL;
+  const siteUrl = siteUrlOverride ?? getDefaultSiteUrl();
   const authUrl = `${siteUrl}/auth/cli?callback=${encodeURIComponent(callbackUrl)}`;
   console.log(`[agendex] Opening browser for authentication...`);
   console.log(`[agendex] If it doesn't open, visit: ${authUrl}`);
@@ -2670,6 +2694,56 @@ import { fileURLToPath } from "node:url";
 // src/api.ts
 import { request as httpRequest } from "node:http";
 import { request as httpsRequest } from "node:https";
+import { hostname as osHostname } from "node:os";
+
+// src/pid.ts
+import { existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync3, unlinkSync, writeFileSync as writeFileSync2 } from "node:fs";
+import { homedir as homedir9, hostname } from "node:os";
+import { dirname, join as join10 } from "node:path";
+var pidPath = join10(homedir9(), ".agendex", "daemon.pid");
+function writePid() {
+  mkdirSync2(dirname(pidPath), { recursive: true });
+  const info = {
+    pid: process.pid,
+    startedAtMs: Date.now(),
+    hostname: hostname()
+  };
+  writeFileSync2(pidPath, JSON.stringify(info));
+}
+function readPidInfo() {
+  if (!existsSync6(pidPath))
+    return null;
+  const raw = readFileSync3(pidPath, "utf-8").trim();
+  const asNumber = Number(raw);
+  if (Number.isFinite(asNumber) && asNumber > 0 && !raw.startsWith("{")) {
+    return { pid: asNumber };
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (Number.isFinite(parsed.pid) && parsed.pid > 0)
+      return parsed;
+  } catch {}
+  return null;
+}
+function readPid() {
+  return readPidInfo()?.pid ?? null;
+}
+function removePid() {
+  try {
+    unlinkSync(pidPath);
+  } catch {}
+}
+function isRunning(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/api.ts
+var cachedDeviceId;
 function getCloudConfig() {
   const config = loadConfig();
   if (!config?.cloudToken)
@@ -2724,6 +2798,12 @@ async function refreshStoredToken(currentToken, convexUrl) {
 async function sendHeartbeat() {
   try {
     const { token, convexUrl } = getCloudConfig();
+    const pidInfo = readPidInfo();
+    const heartbeatBody = JSON.stringify({
+      deviceId: cachedDeviceId ??= loadOrCreateDeviceId(),
+      hostname: pidInfo?.hostname ?? osHostname(),
+      startedAtMs: pidInfo?.startedAtMs
+    });
     let activeToken = token;
     let res = await requestText(`${convexUrl}/api/cli/heartbeat`, {
       method: "POST",
@@ -2731,7 +2811,8 @@ async function sendHeartbeat() {
         Authorization: `Bearer ${activeToken}`,
         Connection: "close",
         "Content-Type": "application/json"
-      }
+      },
+      body: heartbeatBody
     });
     if (res.status === 401) {
       const refreshedToken = await refreshStoredToken(activeToken, convexUrl);
@@ -2744,7 +2825,8 @@ async function sendHeartbeat() {
           Authorization: `Bearer ${activeToken}`,
           Connection: "close",
           "Content-Type": "application/json"
-        }
+        },
+        body: heartbeatBody
       });
     }
     if (res.status === 401) {
@@ -2798,36 +2880,6 @@ function requestText(urlString, options) {
   });
 }
 
-// src/pid.ts
-import { existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync3, unlinkSync, writeFileSync as writeFileSync2 } from "node:fs";
-import { homedir as homedir9 } from "node:os";
-import { dirname, join as join10 } from "node:path";
-var pidPath = join10(homedir9(), ".agendex", "daemon.pid");
-function writePid() {
-  mkdirSync2(dirname(pidPath), { recursive: true });
-  writeFileSync2(pidPath, String(process.pid));
-}
-function readPid() {
-  if (!existsSync6(pidPath))
-    return null;
-  const raw = readFileSync3(pidPath, "utf-8").trim();
-  const pid = Number(raw);
-  return Number.isFinite(pid) && pid > 0 ? pid : null;
-}
-function removePid() {
-  try {
-    unlinkSync(pidPath);
-  } catch {}
-}
-function isRunning(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
 // src/daemon.ts
 var MAX_RESTARTS = 5;
 var RESTART_WINDOW_MS = 60000;
@@ -3013,7 +3065,7 @@ import { join as join11 } from "node:path";
 // package.json
 var package_default = {
   name: "agendex-cli",
-  version: "0.4.0",
+  version: "0.6.0",
   description: "Agendex CLI for login, sync, and daemon workflows",
   homepage: "https://github.com/Tyru5/Agendex#readme",
   repository: {
@@ -3119,6 +3171,10 @@ var command = args[0] ?? "start";
 var cliEntry = resolve5(process.argv[1] ?? fileURLToPath2(import.meta.url));
 async function main() {
   const isInternal = args.includes("--daemon") || args.includes("--worker");
+  if (command === "--version" || command === "-v") {
+    writeStdout(CLI_VERSION);
+    return 0;
+  }
   const isPassthrough = ["stop", "status", "login", "logout", "help", "--help", "-h"].includes(command);
   if (!isInternal && !isPassthrough) {
     const { updateAvailable, current, latest } = await checkForUpdate();
@@ -3196,7 +3252,8 @@ async function main() {
     }
     case "status": {
       const config = loadConfig();
-      const pid = readPid();
+      const pidInfo = readPidInfo();
+      const pid = pidInfo?.pid ?? null;
       const running = pid ? isRunning(pid) : false;
       writeStdout(`[agendex] Config version: ${config?.configVersion ?? "none"}`);
       writeStdout(`[agendex] Local token: ${config?.token ? "set" : "not set"}`);
@@ -3204,6 +3261,20 @@ async function main() {
       writeStdout(`[agendex] Convex URL: ${config?.convexUrl ?? "not set"}`);
       writeStdout(`[agendex] Enabled adapters: ${config?.enabledAdapters.join(", ") || "none"}`);
       writeStdout(`[agendex] Daemon: ${running ? `running (PID ${pid})` : "not running"}`);
+      if (running && pidInfo?.startedAtMs) {
+        writeStdout(`[agendex] Uptime: ${formatDuration(Date.now() - pidInfo.startedAtMs)}`);
+      } else if (running) {
+        writeStdout(`[agendex] Uptime: unknown (restart daemon to populate)`);
+      } else {
+        writeStdout(`[agendex] Uptime: n/a`);
+      }
+      if (running && pidInfo?.hostname) {
+        writeStdout(`[agendex] Hostname: ${pidInfo.hostname}`);
+      } else if (running) {
+        writeStdout(`[agendex] Hostname: unknown (restart daemon to populate)`);
+      } else {
+        writeStdout(`[agendex] Hostname: n/a`);
+      }
       writeStdout(`[agendex] CLI version: ${CLI_VERSION}`);
       return 0;
     }
@@ -3224,6 +3295,8 @@ Usage:
   agendex sync         One-shot scan + sync to cloud
   agendex status       Show current config state + daemon status
   agendex help         Show this help message
+  agendex --version    Print CLI version
+  agendex -v           Print CLI version
 `.trim());
       return 0;
     }
@@ -3264,3 +3337,17 @@ function writeStderr(message) {
   writeSync(process.stderr.fd, `${message}
 `);
 }
+function formatDuration(ms) {
+  const totalSeconds = Math.max(0, Math.floor(ms / 1000));
+  const days = Math.floor(totalSeconds / 86400);
+  const hours = Math.floor(totalSeconds % 86400 / 3600);
+  const minutes = Math.floor(totalSeconds % 3600 / 60);
+  const seconds = totalSeconds % 60;
+  if (days > 0)
+    return `${days}d ${hours}h ${minutes}m ${seconds}s`;
+  if (hours > 0)
+    return `${hours}h ${minutes}m ${seconds}s`;
+  if (minutes > 0)
+    return `${minutes}m ${seconds}s`;
+  return `${seconds}s`;
+}

package/package.json

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