@fargowealth/fargo-ai-cli 1.0.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/package.json

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

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/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 || ".", {
@@ -63,9 +66,11 @@ export async function deployLocalLegoApp(store, input, options = {}) {
   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 } : {})