agendex-cli 0.3.2 → 0.5.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

@@ -2800,19 +2800,35 @@ 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 { 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 });
-  writeFileSync2(pidPath, String(process.pid));
+  const info = {
+    pid: process.pid,
+    startedAtMs: Date.now(),
+    hostname: hostname()
+  };
+  writeFileSync2(pidPath, JSON.stringify(info));
 }
-function readPid() {
+function readPidInfo() {
   if (!existsSync6(pidPath))
     return null;
   const raw = readFileSync3(pidPath, "utf-8").trim();
-  const pid = Number(raw);
-  return Number.isFinite(pid) && pid > 0 ? pid : null;
+  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 {
@@ -3006,11 +3022,132 @@ async function syncAll() {
   console.log(`[agendex] Sync complete: ${synced} synced, ${failed} failed`);
 }
 
+// src/version.ts
+import { existsSync as existsSync7, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
+import { tmpdir } from "node:os";
+import { join as join11 } from "node:path";
+// package.json
+var package_default = {
+  name: "agendex-cli",
+  version: "0.5.0",
+  description: "Agendex CLI for login, sync, and daemon workflows",
+  homepage: "https://github.com/Tyru5/Agendex#readme",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/Tyru5/Agendex.git",
+    directory: "packages/cli"
+  },
+  bugs: {
+    url: "https://github.com/Tyru5/Agendex/issues"
+  },
+  type: "module",
+  license: "AGPL-3.0-only",
+  bin: {
+    agendex: "./dist/cli.js"
+  },
+  files: [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  publishConfig: {
+    access: "public"
+  },
+  engines: {
+    node: ">=20"
+  },
+  scripts: {
+    build: "node ./scripts/build-release.mjs --dist-only",
+    "build:release": "node ./scripts/build-release.mjs",
+    prepack: "node ./scripts/build-release.mjs --dist-only"
+  },
+  dependencies: {
+    "better-sqlite3": "^12.6.2"
+  },
+  devDependencies: {
+    "@agendex/shared": "workspace:*",
+    "@types/bun": "^1.3.9"
+  }
+};
+
+// src/version.ts
+var CLI_VERSION = package_default.version;
+var CACHE_FILE = join11(tmpdir(), ".agendex-update-cache.json");
+var CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+function readCache() {
+  try {
+    if (!existsSync7(CACHE_FILE))
+      return null;
+    const { result, ts } = JSON.parse(readFileSync4(CACHE_FILE, "utf8"));
+    if (Date.now() - ts > CACHE_TTL_MS)
+      return null;
+    return result;
+  } catch {
+    return null;
+  }
+}
+function writeCache(result) {
+  try {
+    writeFileSync3(CACHE_FILE, JSON.stringify({ result, ts: Date.now() }));
+  } catch {}
+}
+async function checkForUpdate() {
+  const current = CLI_VERSION;
+  const cached = readCache();
+  if (cached)
+    return { ...cached, current };
+  try {
+    const controller = new AbortController;
+    const timeout = setTimeout(() => controller.abort(), 3000);
+    const res = await fetch("https://registry.npmjs.org/agendex-cli/latest", {
+      signal: controller.signal
+    });
+    clearTimeout(timeout);
+    if (!res.ok) {
+      return { updateAvailable: false, current, latest: current };
+    }
+    const data = await res.json();
+    const latest = data.version;
+    const result = { updateAvailable: isNewer(latest, current), current, latest };
+    writeCache(result);
+    return result;
+  } catch {
+    return { updateAvailable: false, current, latest: current };
+  }
+}
+function isNewer(latest, current) {
+  const l = latest.split(".").map(Number);
+  const c = current.split(".").map(Number);
+  for (let i = 0;i < Math.max(l.length, c.length); i++) {
+    const lv = l[i] ?? 0;
+    const cv = c[i] ?? 0;
+    if (lv > cv)
+      return true;
+    if (lv < cv)
+      return false;
+  }
+  return false;
+}
+
 // src/cli.ts
 var args = process.argv.slice(2);
 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();
+    if (updateAvailable) {
+      writeStderr(`[agendex] update required: v${current} → v${latest}`);
+      writeStderr(`[agendex] run: npm i -g agendex-cli`);
+      return 1;
+    }
+  }
   switch (command) {
     case "start": {
       if (args.includes("--daemon")) {
@@ -3079,7 +3216,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"}`);
@@ -3087,6 +3225,21 @@ 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;
     }
     case "help":
@@ -3106,6 +3259,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;
     }
@@ -3146,3 +3301,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.3.2",
+  "version": "0.5.0",
   "description": "Agendex CLI for login, sync, and daemon workflows",
   "homepage": "https://github.com/Tyru5/Agendex#readme",
   "repository": {