@faapi/faapi 6.28.0 → 6.30.0

package/dist/cli/index.js

@@ -3548,6 +3548,31 @@ var init_generateAgentArtifacts = __esm({
 import fg4 from "fast-glob";
 import path16 from "path";
 import fs12 from "fs";
+function detectIgnoredMetaFields(source, strictHit) {
+  const declared = /* @__PURE__ */ new Set();
+  for (const line of source.split("\n")) {
+    const trimmed = line.trim();
+    if (trimmed.startsWith("//")) continue;
+    for (const field of ALL_META_FIELDS) {
+      if (new RegExp(`\\b${field}\\s*:`).test(trimmed)) declared.add(field);
+    }
+  }
+  return ALL_META_FIELDS.filter((field) => declared.has(field) && !strictHit[field]);
+}
+function warnIgnoredMetaFields(name, fields) {
+  for (const field of fields) {
+    if (STRING_META_FIELDS.includes(field)) {
+      console.warn(
+        `[faapi] Task "${name}" declares "${field}" but its value is not a string literal \u2014 the declaration was ignored and the task will not be cron-scheduled. Meta values are extracted from source code without importing it, so only literal values are recognized: use a quoted literal (cron: '0 3 * * *'), not an expression or a dynamic value.`
+      );
+    } else {
+      const consequence = field === "timeoutMs" ? " and the task will run in-process with no timeout" : "";
+      console.warn(
+        `[faapi] Task "${name}" declares "${field}" but its value is not a numeric literal \u2014 the declaration was ignored${consequence}. Meta values are extracted from source code without importing it, so only literal values are recognized (underscores allowed, e.g. 1_800_000); expressions like 30 * 60_000 or dynamic values are not supported.`
+      );
+    }
+  }
+}
 function parseNumericLiteral(raw) {
   return Number(raw.replace(/_/g, ""));
 }
@@ -3607,11 +3632,19 @@ async function scanTasks(rootDir, patterns) {
       manifest.timeoutMs = value;
     }
     if (graceMs !== void 0) manifest.graceMs = parseNumericLiteral(graceMs);
+    const strictHit = {
+      cron: cron !== void 0,
+      concurrency: concurrency !== void 0,
+      retries: retries !== void 0,
+      timeoutMs: timeoutMs !== void 0,
+      graceMs: graceMs !== void 0
+    };
+    warnIgnoredMetaFields(name, detectIgnoredMetaFields(source, strictHit));
     tasks.push(manifest);
   }
   return tasks.sort((a, b) => a.name.localeCompare(b.name));
 }
-var TASK_PATTERNS, TASK_FILENAME, CRON_RE, NUM_LITERAL, CONCURRENCY_RE, RETRIES_RE, TIMEOUT_MS_RE, GRACE_MS_RE, MIN_ISOLATED_TIMEOUT_MS, MAX_ISOLATED_TIMEOUT_MS;
+var TASK_PATTERNS, TASK_FILENAME, CRON_RE, NUM_LITERAL, CONCURRENCY_RE, RETRIES_RE, TIMEOUT_MS_RE, GRACE_MS_RE, NUMERIC_META_FIELDS, STRING_META_FIELDS, ALL_META_FIELDS, MIN_ISOLATED_TIMEOUT_MS, MAX_ISOLATED_TIMEOUT_MS;
 var init_scanTasks = __esm({
   "src/task/scanTasks.ts"() {
     "use strict";
@@ -3623,6 +3656,9 @@ var init_scanTasks = __esm({
     RETRIES_RE = new RegExp(`(?:^|\\n)\\s*retries:\\s*${NUM_LITERAL}`);
     TIMEOUT_MS_RE = new RegExp(`(?:^|\\n)\\s*timeoutMs:\\s*${NUM_LITERAL}`);
     GRACE_MS_RE = new RegExp(`(?:^|\\n)\\s*graceMs:\\s*${NUM_LITERAL}`);
+    NUMERIC_META_FIELDS = ["concurrency", "retries", "timeoutMs", "graceMs"];
+    STRING_META_FIELDS = ["cron"];
+    ALL_META_FIELDS = [...NUMERIC_META_FIELDS, ...STRING_META_FIELDS];
     MIN_ISOLATED_TIMEOUT_MS = 6e4;
     MAX_ISOLATED_TIMEOUT_MS = 23 * 60 * 6e4;
   }
@@ -10352,7 +10388,6 @@ async function createAppBase(options) {
     wsRoutes,
     rootDir,
     dist,
-    resourcesDir,
     tasks: taskQueue,
     async listen(listenPort) {
       const envPort = process.env.PORT ? Number(process.env.PORT) : void 0;