agendex-cli 1.1.0 → 1.2.0

package/README.md

@@ -23,6 +23,9 @@ 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 upload <path>          # Upload a single Markdown plan file to the cloud
+agendex upload <path> --agent <name>  # Override the uploaded plan's agent label
+agendex upload <path> --open   # Open the uploaded plan in the browser after upload
 agendex cleanup                # Interactively remove cloud daemons
 agendex cleanup --stale        # Auto-remove all stale daemons
 agendex status                 # Show config state, daemon status, uptime & hostname

package/dist/cli.js

@@ -1059,8 +1059,8 @@ var init_cleanup = __esm(() => {
 
 // src/cli.ts
 import { spawn as spawn4 } from "node:child_process";
-import { existsSync as existsSync12, statSync as statSync2, writeSync } from "node:fs";
-import { resolve as resolve9 } from "node:path";
+import { existsSync as existsSync13, statSync as statSync2, writeSync } from "node:fs";
+import { resolve as resolve10 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 
 // ../shared/src/adapters/catalog.ts
@@ -2822,6 +2822,7 @@ 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 siteUrl = typeof raw.siteUrl === "string" && raw.siteUrl.trim() ? raw.siteUrl : undefined;
   const deviceId = typeof raw.deviceId === "string" && raw.deviceId.trim() ? raw.deviceId : undefined;
   const collectLocalIpAddress = typeof raw.collectLocalIpAddress === "boolean" ? raw.collectLocalIpAddress : undefined;
   return {
@@ -2829,6 +2830,7 @@ function normalizeStoredConfig(raw) {
     token,
     cloudToken,
     convexUrl,
+    siteUrl,
     deviceId,
     collectLocalIpAddress,
     enabledAdapters: normalizeAdapterIds(raw.enabledAdapters),
@@ -2845,6 +2847,7 @@ function saveConfig(config) {
     token: config.token,
     cloudToken: config.cloudToken,
     convexUrl: config.convexUrl,
+    siteUrl: config.siteUrl,
     deviceId: config.deviceId,
     collectLocalIpAddress: config.collectLocalIpAddress,
     enabledAdapters: sanitizeEnabledAdapterIds(config.enabledAdapters),
@@ -2923,6 +2926,7 @@ async function loadOrInitConfig(options = {}) {
     token: tokenFromEnv ? existing?.token : currentToken,
     cloudToken: existing?.cloudToken,
     convexUrl: existing?.convexUrl,
+    siteUrl: existing?.siteUrl,
     deviceId,
     enabledAdapters,
     customPlanDirs: existing?.customPlanDirs ?? []
@@ -3870,7 +3874,8 @@ function parseSyncSuccess(body) {
     return {
       ok: true,
       skippedLowValue: result.skippedLowValue === true,
-      deleted: result.deleted === true
+      deleted: result.deleted === true,
+      ...typeof result.planId === "string" && { planId: result.planId }
     };
   } catch {
     return { ok: true };
@@ -3905,7 +3910,7 @@ async function syncPlan(plan) {
     }
   }
   if (res.status < 200 || res.status >= 300) {
-    return { ok: false, error: `${res.status}: ${res.body}` };
+    return { ok: false, status: res.status, error: `${res.status}: ${res.body}` };
   }
   return parseSyncSuccess(res.body);
 }
@@ -4191,6 +4196,12 @@ function getDefaultSiteUrl() {
     return process.env.AGENDEX_SITE_URL;
   return isDevMode() ? DEV_SITE_URL : PROD_SITE_URL;
 }
+function getSiteUrl() {
+  const config = loadConfig();
+  if (config?.siteUrl)
+    return config.siteUrl;
+  return getDefaultSiteUrl();
+}
 function launchBrowser(url, label) {
   console.log(`[agendex] Opening ${label}...`);
   console.log(`[agendex] If it doesn't open, visit: ${url}`);
@@ -4203,15 +4214,16 @@ function launchBrowser(url, label) {
 async function login(siteUrlOverride) {
   const { port, result } = await startCallbackServer();
   const callbackUrl = `http://127.0.0.1:${port}/callback`;
-  const siteUrl = siteUrlOverride ?? getDefaultSiteUrl();
+  const existing = loadConfig();
+  const siteUrl = siteUrlOverride ?? existing?.siteUrl ?? getDefaultSiteUrl();
   const authUrl = `${siteUrl}/auth/cli?callback=${encodeURIComponent(callbackUrl)}`;
   launchBrowser(authUrl, "browser for authentication");
   const callback = await result;
-  const existing = loadConfig();
   const config = {
     configVersion: 3,
     cloudToken: callback.token,
     convexUrl: callback.convexUrl,
+    siteUrl,
     enabledAdapters: existing?.enabledAdapters ?? [],
     customPlanDirs: existing?.customPlanDirs ?? [],
     ...existing?.token ? { token: existing.token } : {},
@@ -4232,7 +4244,8 @@ function logout() {
     enabledAdapters: existing.enabledAdapters,
     customPlanDirs: existing.customPlanDirs,
     ...existing.token ? { token: existing.token } : {},
-    ...existing.deviceId ? { deviceId: existing.deviceId } : {}
+    ...existing.deviceId ? { deviceId: existing.deviceId } : {},
+    ...existing.siteUrl ? { siteUrl: existing.siteUrl } : {}
   };
   saveConfig(config);
   console.log("[agendex] Logged out. Cloud token removed.");
@@ -4376,7 +4389,7 @@ function spawnBrowser(command, args, options = {}) {
 // src/daemon.ts
 import { spawn as spawn2 } from "node:child_process";
 import { hostname as osHostname2 } from "node:os";
-import { resolve as resolve6 } from "node:path";
+import { resolve as resolve7 } from "node:path";
 import { fileURLToPath } from "node:url";
 
 // src/adapters.ts
@@ -4521,6 +4534,7 @@ function isIpv4Address(address) {
 }
 
 // src/payload.ts
+import { basename as basename6, resolve as resolve6 } from "node:path";
 var SYNC_METADATA_KEY = "agendexSync";
 function isRecord4(value) {
   return typeof value === "object" && value !== null;
@@ -4539,6 +4553,36 @@ function withSyncDeviceMetadata(metadata, deviceId, hostname2, ipAddress) {
     }
   };
 }
+function parseUploadFile(filePath, content, agentOverride) {
+  const fmMatch = content.match(/^---\s*\n([\s\S]*?)\n---\s*\n/);
+  const override = agentOverride?.trim();
+  let agent = override || "uploaded";
+  if (!override && fmMatch) {
+    const agentLine = fmMatch[1]?.match(/^agent:\s*(.+)$/m);
+    if (agentLine?.[1])
+      agent = agentLine[1].trim();
+  }
+  const body = fmMatch ? content.slice(fmMatch[0].length) : content;
+  const titleMatch = body.match(/^#\s+(.+)/m);
+  const title = titleMatch?.[1]?.trim() || basename6(filePath).replace(/\.md$/i, "") || "Untitled";
+  return { title, agent, body };
+}
+function fileToSyncPayload(filePath, content, options = {}) {
+  const absolutePath = resolve6(filePath);
+  const { title, agent, body } = parseUploadFile(absolutePath, content, options.agentOverride);
+  const now = Date.now();
+  return {
+    localPlanId: hashPath(absolutePath),
+    agent,
+    title,
+    content: body,
+    format: "md",
+    filePath: absolutePath,
+    metadata: withSyncDeviceMetadata({ uploaded: true, userCreated: true }, options.deviceId, options.hostname, options.ipAddress),
+    createdAt: options.createdAt ?? now,
+    updatedAt: options.updatedAt ?? now
+  };
+}
 function planToSyncPayload(plan, deviceId, hostname2, ipAddress) {
   return {
     localPlanId: plan.id,
@@ -4981,7 +5025,7 @@ async function startSupervisor() {
   };
   process.on("SIGTERM", shutdown);
   process.on("SIGINT", shutdown);
-  const scriptPath = resolve6(process.argv[1] ?? fileURLToPath(new URL("./cli.ts", import.meta.url)));
+  const scriptPath = resolve7(process.argv[1] ?? fileURLToPath(new URL("./cli.ts", import.meta.url)));
   const restartTimes = [];
   while (!stopping) {
     const workerArgs = [scriptPath, "start", "--worker"];
@@ -4991,11 +5035,11 @@ async function startSupervisor() {
       stdio: ["ignore", "inherit", "inherit"],
       env: { ...process.env, ...isDevMode() ? { AGENDEX_DEV: "1" } : {} }
     });
-    const exitCode = await new Promise((resolve7) => {
-      workerProc?.once("exit", (code) => resolve7(code));
+    const exitCode = await new Promise((resolve8) => {
+      workerProc?.once("exit", (code) => resolve8(code));
       workerProc?.once("error", (error) => {
         console.error("[agendex] failed to spawn worker:", error);
-        resolve7(1);
+        resolve8(1);
       });
     });
     workerProc = null;
@@ -5021,7 +5065,7 @@ async function startSupervisor() {
 import { existsSync as existsSync10, readFileSync as readFileSync7 } from "node:fs";
 import { mkdir as mkdir2, rm, writeFile as writeFile4 } from "node:fs/promises";
 import { homedir as homedir10 } from "node:os";
-import { dirname as dirname4, join as join14, resolve as resolve7 } from "node:path";
+import { dirname as dirname4, join as join14, resolve as resolve8 } from "node:path";
 var SUPPORTED_AGENTS = ["claude-code", "codex", "pi"];
 var MANAGED_MARKER = "agendex-plan-review";
 var HOOK_TIMEOUT_SECONDS = 345600;
@@ -5033,7 +5077,7 @@ function commandFor(cliEntry, agent) {
   return `${shellQuote(process.execPath)} ${shellQuote(cliEntry)} review-plan --hook --agent ${agent}`;
 }
 function scopeRoot(scope) {
-  return scope === "repo" ? resolve7(process.env.PWD || process.cwd()) : homedir10();
+  return scope === "repo" ? resolve8(process.env.PWD || process.cwd()) : homedir10();
 }
 function hooksJsonPath(agent, scope) {
   const root = scopeRoot(scope);
@@ -5358,7 +5402,7 @@ async function runHooksCommand(args, cliEntry) {
     for (const agent of agents) {
       if (agent === "claude-code")
         printClaudePreviewWarning(dryRun);
-      const path = await installAgent(agent, scope, resolve7(cliEntry), dryRun);
+      const path = await installAgent(agent, scope, resolve8(cliEntry), dryRun);
       console.log(`[agendex] ${dryRun ? "would install" : "installed"} ${agent} hook: ${path}`);
     }
     return 0;
@@ -5448,7 +5492,7 @@ async function syncAll(force = false) {
 // src/upgrade.ts
 import { spawn as spawn3, spawnSync } from "node:child_process";
 import { realpathSync as realpathSync2 } from "node:fs";
-import { dirname as dirname5, resolve as resolve8, sep as sep4 } from "node:path";
+import { dirname as dirname5, resolve as resolve9, sep as sep4 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // src/version.ts
@@ -5458,7 +5502,7 @@ import { join as join15 } from "node:path";
 // package.json
 var package_default = {
   name: "agendex-cli",
-  version: "1.1.0",
+  version: "1.2.0",
   description: "Agendex CLI for login, sync, and daemon workflows",
   homepage: "https://github.com/Tyru5/Agendex#readme",
   bugs: {
@@ -5581,9 +5625,9 @@ var PACKAGE_NAME = "agendex-cli";
 var moduleDir = dirname5(fileURLToPath2(import.meta.url));
 function getPackageRoot() {
   try {
-    return realpathSync2(resolve8(moduleDir, ".."));
+    return realpathSync2(resolve9(moduleDir, ".."));
   } catch {
-    return resolve8(moduleDir, "..");
+    return resolve9(moduleDir, "..");
   }
 }
 function detectPackageManager(packageRoot) {
@@ -5765,9 +5809,120 @@ async function runUpgrade(opts) {
   });
 }
 
+// src/upload.ts
+import { readFile as readFile8, stat as stat8 } from "node:fs/promises";
+import { existsSync as existsSync12 } from "node:fs";
+import { hostname as osHostname4 } from "node:os";
+function resolveAgentOverride(args) {
+  const idx = args.indexOf("--agent");
+  if (idx === -1)
+    return;
+  const value = args[idx + 1];
+  if (value === undefined || value.startsWith("--"))
+    return "missing";
+  return value;
+}
+function resolvePathArg(args) {
+  for (let i = 0;i < args.length; i++) {
+    const a = args[i];
+    if (a === undefined)
+      continue;
+    if (a === "upload" || a === "--dev" || a === "--open")
+      continue;
+    if (a === "--agent") {
+      i++;
+      continue;
+    }
+    if (a.startsWith("--"))
+      continue;
+    return a;
+  }
+  return;
+}
+async function runUpload(args, deps) {
+  const syncPlanFn = deps?.syncPlan ?? syncPlan;
+  const log = deps?.log ?? ((m) => console.log(m));
+  const error = deps?.error ?? ((m) => console.error(m));
+  const openBrowser2 = deps?.openBrowser ?? launchBrowser;
+  const pathArg = resolvePathArg(args);
+  if (!pathArg || !pathArg.trim()) {
+    error("[agendex] usage: agendex upload <path> [--agent <name>] [--open]");
+    return 1;
+  }
+  const absolutePath = resolveCustomPlanDirPath(pathArg);
+  if (!existsSync12(absolutePath)) {
+    error(`[agendex] path does not exist: ${absolutePath}`);
+    return 1;
+  }
+  let stats;
+  try {
+    stats = await stat8(absolutePath);
+  } catch (err) {
+    error(`[agendex] could not read path: ${err instanceof Error ? err.message : String(err)}`);
+    return 1;
+  }
+  if (stats.isDirectory()) {
+    error(`[agendex] path is a directory, expected a single file: ${absolutePath}`);
+    return 1;
+  }
+  if (!/\.md$/i.test(absolutePath)) {
+    error(`[agendex] only Markdown (.md) files are supported: ${absolutePath}`);
+    return 1;
+  }
+  const config = loadConfig();
+  if (!config?.cloudToken || !config?.convexUrl) {
+    error("[agendex] not logged in. Run `agendex login` first.");
+    return 1;
+  }
+  let content;
+  try {
+    content = await readFile8(absolutePath, "utf-8");
+  } catch (err) {
+    error(`[agendex] could not read file: ${err instanceof Error ? err.message : String(err)}`);
+    return 1;
+  }
+  const agentOverride = resolveAgentOverride(args);
+  if (agentOverride === "missing") {
+    error("[agendex] usage: agendex upload <path> [--agent <name>] [--open]");
+    error("[agendex] --agent requires a name");
+    return 1;
+  }
+  const ipAddress = await shouldIncludeLocalIpAddressInSync() ? getLocalIpAddress() : undefined;
+  const payload = fileToSyncPayload(absolutePath, content, {
+    agentOverride,
+    deviceId: config.deviceId ?? loadOrCreateDeviceId(),
+    hostname: osHostname4(),
+    ipAddress,
+    createdAt: stats.birthtime.getTime(),
+    updatedAt: stats.mtime.getTime()
+  });
+  const result = await syncPlanFn(payload);
+  if (!result.ok) {
+    if (result.status === 403) {
+      error(`[agendex] ${result.error ?? "Cloud Pro subscription required"}`);
+      error(`[agendex] View plans and pricing: ${getSiteUrl().replace(/\/$/, "")}/#pricing`);
+      return 1;
+    }
+    error(`[agendex] upload failed: ${result.error ?? "unknown error"}`);
+    return 1;
+  }
+  if (result.skippedLowValue) {
+    log(`[agendex] "${payload.title}" was skipped as a low-value plan and was not stored in the cloud.`);
+    return 0;
+  }
+  const site = getSiteUrl().replace(/\/$/, "");
+  const planUrl = result.planId ? `${site}/dashboard?plan=${encodeURIComponent(result.planId)}` : `${site}/dashboard`;
+  log(`[agendex] uploaded "${payload.title}"`);
+  log(`[agendex] ${planUrl}`);
+  if (args.includes("--open")) {
+    openBrowser2(planUrl, "uploaded plan in your browser");
+  }
+  return 0;
+}
+
 // src/web.ts
 async function openAgendexWeb(siteUrlOverride) {
-  const base = siteUrlOverride ?? getDefaultSiteUrl();
+  const base = siteUrlOverride ?? getSiteUrl();
   const url = base.replace(/\/$/, "");
   launchBrowser(url, "Agendex in your browser");
 }
@@ -5802,7 +5957,7 @@ function firstCommandToken(argv) {
   return;
 }
 var command = firstCommandToken(args) ?? "start";
-var cliEntry = resolve9(process.argv[1] ?? fileURLToPath3(import.meta.url));
+var cliEntry = resolve10(process.argv[1] ?? fileURLToPath3(import.meta.url));
 async function main() {
   const isInternal = args.includes("--daemon") || args.includes("--worker");
   if (command === "--version" || command === "-v") {
@@ -5822,6 +5977,7 @@ async function main() {
     "add-dir",
     "remove-dir",
     "list-dirs",
+    "upload",
     "upgrade",
     "help",
     "--help",
@@ -5922,6 +6078,9 @@ async function main() {
       await syncAll(force);
       return 0;
     }
+    case "upload": {
+      return await runUpload(args);
+    }
     case "hooks": {
       return await runHooksCommand(args, cliEntry);
     }
@@ -6010,7 +6169,7 @@ async function main() {
         return 1;
       }
       const resolved = resolveCustomPlanDirPath(dirPath);
-      if (!existsSync12(resolved)) {
+      if (!existsSync13(resolved)) {
         writeStderr(`[agendex] path does not exist: ${resolved}`);
         return 1;
       }
@@ -6029,7 +6188,7 @@ async function main() {
         const { request } = await import("node:http");
         const body = JSON.stringify({ path: resolved });
         try {
-          const res = await new Promise((resolve10, reject) => {
+          const res = await new Promise((resolve11, reject) => {
             const req = request(`http://localhost:${port}/api/v1/plan-sources`, {
               method: "POST",
               headers: {
@@ -6043,7 +6202,7 @@ async function main() {
               res2.on("data", (chunk) => {
                 data += chunk;
               });
-              res2.on("end", () => resolve10({ status: res2.statusCode ?? 0, body: data }));
+              res2.on("end", () => resolve11({ status: res2.statusCode ?? 0, body: data }));
               res2.on("error", reject);
             });
             req.on("error", reject);
@@ -6203,6 +6362,9 @@ Usage:
   agendex list-dirs    List custom plan directories
   agendex sync         One-shot scan + sync to cloud (skips unchanged plans)
   agendex sync --force Re-sync all plans, ignoring cache
+  agendex upload <path>  Upload a single Markdown plan file to the cloud
+  agendex upload <path> --agent <name>  Override the uploaded plan's agent label
+  agendex upload <path> --open  Open the uploaded plan in the browser after upload
   agendex cleanup      Interactively remove cloud daemons
   agendex cleanup --stale  Auto-remove all stale daemons
   agendex status       Show current config state + daemon status
@@ -6236,13 +6398,13 @@ function flushStream(stream) {
   if (stream.destroyed || !stream.writable) {
     return Promise.resolve();
   }
-  return new Promise((resolve10, reject) => {
+  return new Promise((resolve11, reject) => {
     stream.write("", (error) => {
       if (error) {
         reject(error);
         return;
       }
-      resolve10();
+      resolve11();
     });
   });
 }

package/package.json

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