@fargowealth/fargo-ai-cli 0.8.0 → 1.1.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 1.1.0
+
+- Added Worker Cron Trigger and Queue Consumer deployment options, including
+  bounded batch, retry, delay, timeout, and concurrency settings.
+- Deployment preparation now persists runtime topology so Cron and Queue
+  changes are applied only when the prepared Worker version is published.
+
 ## 0.8.0
 
 - Replaced regex-based D1 migration checks with token-structured parsing that

package/README.md

@@ -9,7 +9,7 @@ Requires Node.js 20.19 or newer.
 ## Install or upgrade
 
 ```sh
-npm install -g @fargowealth/fargo-ai-cli@0.8.0
+npm install -g @fargowealth/fargo-ai-cli@latest
 fargo version
 ```
 
@@ -43,8 +43,8 @@ reused by both MCP and local CLI operations.
 
 ```sh
 fargo mcp tools
-fargo mcp call lego_get_app --args '{"appId":"app_xxx"}'
-fargo mcp call lego_get_app --args-file ./arguments.json
+fargo mcp call lego_app_read --args '{"action":"get","appId":"app_xxx"}'
+fargo mcp call lego_app_read --args-file ./arguments.json
 ```
 
 ## LEGO source snapshots

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fargowealth/fargo-ai-cli",
-  "version": "0.8.0",
+  "version": "1.1.0",
   "description": "Agent-neutral Fargo AI CLI, MCP client, and LEGO project tooling",
   "type": "module",
   "bin": {

package/src/agent-install.mjs

@@ -7,14 +7,15 @@ import { normalizeAgentType } from "./auth.mjs";
 import { CLI_VERSION } from "./constants.mjs";
 
 const PACKAGE_NAME = "@fargowealth/fargo-ai-cli";
-const SERVER_NAME = "fargo-ai";
+const SERVER_NAME = "fargo-pass";
+const LEGACY_SERVER_NAME = "fargo-ai";
 
 export async function installAgentMcp(rawAgent, options = {}) {
   const agent = normalizeAgentType(rawAgent);
   const platform = options.platform ?? process.platform;
   const env = options.env ?? process.env;
   const homeDirectory = options.home ?? homedir();
-  const packageSpec = `${PACKAGE_NAME}@${options.packageVersion ?? CLI_VERSION}`;
+  const packageSpec = `${PACKAGE_NAME}@${options.packageVersion ?? "latest"}`;
   const npxCommand = options.npxCommand ?? (platform === "darwin"
     ? await resolveNpxCommand({ env, execPath: options.execPath, platform })
     : "npx");
@@ -96,10 +97,14 @@ async function installJsonMcp(agent, server, options) {
     env: server.env
   };
   const previousServer = config.mcpServers?.[SERVER_NAME];
-  const changed = JSON.stringify(previousServer) !== JSON.stringify(nextServer);
+  const hadLegacyServer = Boolean(config.mcpServers?.[LEGACY_SERVER_NAME]);
+  const changed = hadLegacyServer || JSON.stringify(previousServer) !== JSON.stringify(nextServer);
 
   if (changed) {
-    config.mcpServers = { ...(config.mcpServers ?? {}), [SERVER_NAME]: nextServer };
+    const nextServers = { ...(config.mcpServers ?? {}) };
+    delete nextServers[LEGACY_SERVER_NAME];
+    nextServers[SERVER_NAME] = nextServer;
+    config.mcpServers = nextServers;
     await writeConfig(options.configPath, config);
   }
 
@@ -114,9 +119,12 @@ async function installHostCliMcp(agent, server, options) {
   const removeArgs = agent === "codex"
     ? ["mcp", "remove", SERVER_NAME]
     : ["mcp", "remove", "--scope", "user", SERVER_NAME];
-  const removeResult = await runHostCommand(command, removeArgs, options);
-  if (removeResult.exitCode !== 0 && !isMissingServer(removeResult)) {
-    throw new Error(`${agentLabel(agent)} could not replace the existing ${SERVER_NAME} MCP entry: ${commandError(removeResult)}`);
+  for (const candidate of [SERVER_NAME, LEGACY_SERVER_NAME]) {
+    const candidateRemoveArgs = removeArgs.map((value) => value === SERVER_NAME ? candidate : value);
+    const removeResult = await runHostCommand(command, candidateRemoveArgs, options);
+    if (removeResult.exitCode !== 0 && !isMissingServer(removeResult)) {
+      throw new Error(`${agentLabel(agent)} could not replace the existing ${candidate} MCP entry: ${commandError(removeResult)}`);
+    }
   }
 
   const environmentArgs = Object.entries(server.env).flatMap(([key, value]) => agent === "codex"
@@ -181,7 +189,7 @@ function installationResult(agent, packageSpec, changed, extra) {
     package: packageSpec,
     ...extra,
     next_action: agent === "workbuddy"
-      ? "Open WorkBuddy Custom Connectors, trust and enable fargo-ai, then start a new task."
+      ? "Open WorkBuddy Custom Connectors, trust and enable fargo-pass, then start a new task."
       : `Restart ${agentLabel(agent)} or start a new Agent session, then call ping_who_am_i.`
   };
 }

package/src/cli.mjs

@@ -75,6 +75,7 @@ export async function runCli(args, options = {}) {
       const versionName = requiredTextOption(args, "--name", 160);
       const releaseNotes = await requiredNotesOption(args);
       const workerFirstRoutes = optionValues(args, "--assets-run-worker-first-route").filter(Boolean);
+      const queueConsumer = queueConsumerOption(args);
       const result = await deployLocalLegoApp(store, {
         appId,
         assetsBinding: optionValue(args, "--assets-binding"),
@@ -82,10 +83,12 @@ export async function runCli(args, options = {}) {
         assetsHtmlHandling: optionValue(args, "--assets-html-handling"),
         assetsNotFoundHandling: optionValue(args, "--assets-not-found-handling"),
         assetsRunWorkerFirst: workerFirstRoutes.length > 0 ? workerFirstRoutes : args.includes("--assets-run-worker-first"),
+        cronSchedules: optionValues(args, "--cron").filter(Boolean),
         deployDir,
         dryRun: args.includes("--dry-run"),
         entrypoint: optionValue(args, "--entrypoint"),
         releaseNotes,
+        queueConsumer,
         skipSource: args.includes("--skip-source"),
         source: optionValue(args, "--source") ?? ".",
         sourceExcludes: optionValues(args, "--source-exclude"),
@@ -173,6 +176,15 @@ Worker Static Assets:
   --assets-run-worker-first-route <glob>
                                 Repeatable Worker-first route
 
+Worker Runtime Topology:
+  --cron <expression>           Repeatable Cron trigger; requires cron_trigger
+  --queue-consumer <binding>    Configure this App Queue binding as a consumer
+  --queue-max-batch-size <n>    Default: 10; range: 1-100
+  --queue-max-batch-timeout <s> Default: 5; range: 0-60 seconds
+  --queue-max-retries <n>       Default: 3; range: 0-100
+  --queue-max-concurrency <n>   Optional maximum concurrent consumers
+  --queue-retry-delay <s>       Optional retry delay in seconds
+
 Example:
   fargo lego deploy --app app_xxx --source . \\
     --deploy-dir .build/worker --target worker --entrypoint index.js \\
@@ -220,6 +232,39 @@ function assertAssetsDirectoryProvided(args, assetsDirectory) {
   }
 }
 
+function queueConsumerOption(args) {
+  const bindingName = optionValue(args, "--queue-consumer")?.trim();
+  const settingNames = [
+    "--queue-max-batch-size",
+    "--queue-max-batch-timeout",
+    "--queue-max-retries",
+    "--queue-max-concurrency",
+    "--queue-retry-delay"
+  ];
+  if (!bindingName) {
+    if (settingNames.some((name) => hasOption(args, name))) {
+      throw new Error("Queue consumer settings require --queue-consumer <binding>");
+    }
+    return undefined;
+  }
+  return {
+    bindingName,
+    ...integerOption(args, "--queue-max-batch-size", "maxBatchSize"),
+    ...integerOption(args, "--queue-max-batch-timeout", "maxBatchTimeout"),
+    ...integerOption(args, "--queue-max-retries", "maxRetries"),
+    ...integerOption(args, "--queue-max-concurrency", "maxConcurrency"),
+    ...integerOption(args, "--queue-retry-delay", "retryDelay")
+  };
+}
+
+function integerOption(args, optionName, propertyName) {
+  const value = optionValue(args, optionName);
+  if (value === undefined) return {};
+  const parsed = Number(value);
+  if (!Number.isInteger(parsed)) throw new Error(`${optionName} must be an integer`);
+  return { [propertyName]: parsed };
+}
+
 function hasOption(args, name) {
   return args.some((value) => value === name || value.startsWith(`${name}=`));
 }

package/src/constants.mjs

@@ -1,4 +1,4 @@
-export const CLI_VERSION = "0.8.0";
+export const CLI_VERSION = "1.0.0";
 export const DEVICE_CODE_GRANT_TYPE = "urn:ietf:params:oauth:grant-type:device_code";
 export const DEFAULT_AUTH_URL = "https://auth.fargowealth.app";
 export const DEFAULT_API_URL = "https://mcp.fargowealth.app";

package/src/lego-deploy.mjs

@@ -7,6 +7,9 @@ import { createSourceSnapshot } from "./source-snapshot.mjs";
 
 export async function deployLocalLegoApp(store, input, options = {}) {
   const target = requiredTarget(input.target);
+  if (target !== "worker" && (input.cronSchedules?.length || input.queueConsumer)) {
+    throw new Error("Cron and Queue consumer topology is supported only for Worker deployments");
+  }
   const entrypoint = input.entrypoint || (target === "pages" ? "index.html" : "index.js");
   const [snapshot, artifact] = await Promise.all([
     input.skipSource ? Promise.resolve(undefined) : createSourceSnapshot(input.source || ".", {
@@ -60,17 +63,19 @@ export async function deployLocalLegoApp(store, input, options = {}) {
   const deployArtifactId = uploadedArtifact.deployArtifact?.id;
   if (!deployArtifactId) throw new Error("Deployment artifact upload did not return deployArtifact.id");
 
-  const tool = target === "pages" ? "lego_pages_deploy" : "lego_worker_deploy";
   const deploymentInput = {
+    action: target,
     appId: input.appId,
+    ...(input.cronSchedules?.length ? { cronSchedules: input.cronSchedules } : {}),
     deployArtifactId,
     entrypoint: artifact.entrypoint,
     releaseNotes: input.releaseNotes,
+    ...(input.queueConsumer ? { queueConsumer: input.queueConsumer } : {}),
     version: input.version,
     versionName: input.versionName,
     ...(sourceSnapshotId ? { sourceSnapshotId } : {})
   };
-  const deployment = mcpToolPayload(await callMcpTool(store, tool, deploymentInput, options));
+  const deployment = mcpToolPayload(await callMcpTool(store, "lego_deploy_prepare", deploymentInput, options));
 
   return {
     appId: input.appId,

package/src/lego-migrations.mjs

@@ -14,7 +14,7 @@ export async function planLegoMigrations(store, input, options = {}) {
 
 async function buildMigrationPlan(store, input, options) {
   const local = await readMigrationDirectory(input.directory, { tablePrefix: input.tablePrefix });
-  const remote = mcpToolPayload(await callMcpTool(store, "lego_d1_migrations_list", { appId: input.appId }, options));
+  const remote = mcpToolPayload(await callMcpTool(store, "lego_database", { action: "migrations_list", appId: input.appId }, options));
   const applied = new Map((remote.migrations ?? []).map((migration) => [String(migration.version), migration]));
   const migrations = local.map((migration) => {
     const existing = applied.get(migration.version);
@@ -62,7 +62,8 @@ export async function applyLegoMigrations(store, input, options = {}) {
 
   const applied = [];
   for (const migration of plan.migrations.filter((item) => item.status === "pending")) {
-    const result = mcpToolPayload(await callMcpTool(store, "lego_d1_migrations_apply", {
+    const result = mcpToolPayload(await callMcpTool(store, "lego_database", {
+      action: "migration_apply",
       appId: input.appId,
       allowDataMigrations: migration.impact.dataStatementCount > 0 && input.allowDataMigrations === true,
       contentSha256: migration.contentSha256,