@datarails-ai/dr-cli 1.6.117 → 1.6.119

package/dist/cli.js

@@ -8,7 +8,7 @@ import { fileURLToPath as fileURLToPath3 } from "url";
 // package.json
 var package_default = {
   name: "@datarails-ai/dr-cli",
-  version: "1.6.117",
+  version: "1.6.119",
   description: "Datarails CLI",
   type: "module",
   engines: {
@@ -69,7 +69,7 @@ var package_default = {
 };
 
 // src/buildInfo.ts
-var BUILD_TIME = "2026-10-12T08:59:33.211Z";
+var BUILD_TIME = "2026-10-12T09:44:27.404Z";
 function formatBuildTime(iso) {
   if (iso === "") return "";
   const d = new Date(iso);
@@ -49692,11 +49692,60 @@ var WORKFLOW_TYPES_NON_MEC = [
 ];
 var RECURRENCE_TYPES = [
   "One Time",
-  "Weekly",
-  "Monthly",
-  "Quarterly",
-  "Yearly"
+  "Week",
+  "Month",
+  "Quarter",
+  "Year"
 ];
+var RECURRENCE_ADJECTIVES = {
+  Weekly: "Week",
+  Monthly: "Month",
+  Quarterly: "Quarter",
+  Yearly: "Year"
+};
+function absentStartTimeLabel(recurrence) {
+  return recurrence === "One Time" ? "(none; set when the workflow is activated)" : "(from the recurrence settings)";
+}
+function asRecurrencePeriodType(value, where) {
+  const v = asString(value, where);
+  if (RECURRENCE_TYPES.includes(v)) return v;
+  const hint = RECURRENCE_ADJECTIVES[v];
+  throw new Error(
+    `--file ${where}: expected one of ${RECURRENCE_TYPES.join(" | ")}, got "${v}"` + (hint !== void 0 ? ` (use "${hint}")` : "")
+  );
+}
+function checkTemplatePayload(out, requireAll) {
+  if (out.process_start_time !== void 0 && out.config?.recurrency_period_type !== void 0 && out.config.recurrency_period_type !== "One Time") {
+    throw new Error(
+      `--file template.process_start_time: only allowed with config.recurrency_period_type "One Time" (got "${out.config.recurrency_period_type}"); drop it for a recurring workflow`
+    );
+  }
+  if (!requireAll || out.config === void 0 || out.tags === void 0) return;
+  if (out.tags.length === 0) {
+    throw new Error(
+      "--file template.tags: must not be empty; give the date tag of config.tags_config with its Unix-seconds value"
+    );
+  }
+  const dateTags = out.config.tags_config.filter(
+    (t) => t !== null && typeof t === "object" && t.type === "DATE"
+  );
+  if (dateTags.length !== 1) {
+    throw new Error(
+      `--file template.config.tags_config: needs exactly one entry with type "DATE" (found ${dateTags.length}); copy it from \`dr workflow get <id> --json\` of a working template (\`dr mec workflow get\` for MEC)`
+    );
+  }
+  const dateTag = dateTags[0];
+  if (typeof dateTag.id !== "number" || !Number.isInteger(dateTag.id) || dateTag.id <= 0) {
+    throw new Error(
+      `--file template.config.tags_config: the DATE entry needs a positive integer "id" (got ${JSON.stringify(dateTag.id)})`
+    );
+  }
+  if (!out.tags.some((t) => t.id === dateTag.id)) {
+    throw new Error(
+      `--file template.tags: needs the date tag of config.tags_config (id ${String(dateTag.id)}, ${String(dateTag.name)}) with its Unix-seconds value`
+    );
+  }
+}
 var STEP_TYPES = [
   "Input",
   "Output",
@@ -49805,14 +49854,13 @@ function validateTemplatePayload(raw, requireAll) {
       );
     }
     out.process_start_time = v;
-  } else if (requireAll) {
-    throw new Error("--file template.process_start_time: required");
   }
   if (obj["tags"] !== void 0) {
     out.tags = validateTagsArray(obj["tags"]);
   } else if (requireAll) {
     throw new Error("--file template.tags: required");
   }
+  checkTemplatePayload(out, requireAll);
   return out;
 }
 function validateConfig(raw) {
@@ -49834,15 +49882,10 @@ function validateConfig(raw) {
       `--file template.config.type: expected one of ${WORKFLOW_TYPES_NON_MEC.join(" | ")}, got "${type}"`
     );
   }
-  const recurrency_period_type = asString(
+  const recurrency_period_type = asRecurrencePeriodType(
     obj["recurrency_period_type"],
     "template.config.recurrency_period_type"
   );
-  if (!RECURRENCE_TYPES.includes(recurrency_period_type)) {
-    throw new Error(
-      `--file template.config.recurrency_period_type: expected one of ${RECURRENCE_TYPES.join(" | ")}, got "${recurrency_period_type}"`
-    );
-  }
   const tagsConfig = asArray2(obj["tags_config"], "template.config.tags_config");
   return {
     ...obj,
@@ -50345,14 +50388,13 @@ function validateMecTemplatePayload(raw, requireAll) {
       );
     }
     out.process_start_time = v;
-  } else if (requireAll) {
-    throw new Error("--file template.process_start_time: required");
   }
   if (obj["tags"] !== void 0) {
     out.tags = validateTagsArray2(obj["tags"]);
   } else if (requireAll) {
     throw new Error("--file template.tags: required");
   }
+  checkTemplatePayload(out, requireAll);
   return out;
 }
 function validateMecConfig(raw, requireAll) {
@@ -50392,7 +50434,7 @@ function validateMecConfig(raw, requireAll) {
     name,
     type: MEC_WORKFLOW_TYPE,
     process_timezone: tz,
-    recurrency_period_type: recur,
+    recurrency_period_type: recur === void 0 ? void 0 : asRecurrencePeriodType(recur, "template.config.recurrency_period_type"),
     recurrency_start_day: obj["recurrency_start_day"] === null ? null : obj["recurrency_start_day"] === void 0 && !requireAll ? void 0 : asNonNegativeInt2(obj["recurrency_start_day"], "template.config.recurrency_start_day"),
     recurrency_start_hour: obj["recurrency_start_hour"] === void 0 && !requireAll ? void 0 : asNonNegativeInt2(obj["recurrency_start_hour"], "template.config.recurrency_start_hour"),
     recurrency_start_minute: obj["recurrency_start_minute"] === void 0 && !requireAll ? void 0 : asNonNegativeInt2(
@@ -51017,7 +51059,7 @@ async function runMecWorkflowCreate(cfg) {
       `type: ${cfg.payload.config.type}`,
       `recurrence: ${cfg.payload.config.recurrency_period_type}`,
       `timezone: ${timezoneLabel(cfg.payload.config.process_timezone)}`,
-      `process_start_time: ${cfg.payload.process_start_time}`,
+      `process_start_time: ${cfg.payload.process_start_time ?? absentStartTimeLabel(cfg.payload.config.recurrency_period_type)}`,
       `tags: ${cfg.payload.tags.length}`,
       "NOTE: created MEC template starts INACTIVE \u2014 activate separately."
     ],
@@ -53870,7 +53912,7 @@ async function runWorkflowCreate(cfg) {
       `type: ${cfg.payload.config.type}`,
       `recurrence: ${cfg.payload.config.recurrency_period_type}`,
       `timezone: ${timezoneLabel2(cfg.payload.config.process_timezone)}`,
-      `process_start_time: ${cfg.payload.process_start_time}`,
+      `process_start_time: ${cfg.payload.process_start_time ?? absentStartTimeLabel(cfg.payload.config.recurrency_period_type)}`,
       `tags: ${cfg.payload.tags.length}`,
       "NOTE: created template starts INACTIVE \u2014 activate separately."
     ],

package/dist/scopes-map.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "cliVersion": "1.6.117",
+  "cliVersion": "1.6.119",
   "_contract": "Resolve a command path through `aliases` (canonical prefix + alias segment -> canonical path) before any lookup. A path listed in `pendingCommands`, or whose first segment is a key of `pending`, is UNDECIDED, not unrestricted: fail closed or skip it, and never read a path's absence from `commands` as 'no requirement'. An entry carrying `denied` is UNAVAILABLE to any AGENT-SCOPED credential — one whose `scopes` claim carries at least one `resource:action` entry; a claim that is absent, empty, capability-only or wholly unparseable is UNRESTRICTED, and this mark does not apply to it — whatever else that entry says: it is not a ceiling and it is not always-available, its `denied.reason` says why and `denied.until` names the ticket that lifts it, and the absence of `requires` on it must NEVER be read as 'no requirement'. Only an entry in `commands` with an empty `requires` means always-available.",
   "commands": {
     "login": {

package/dist/skills/dr-cli/reference/workflows.md

@@ -102,6 +102,13 @@ everything else is identical. Confirm tokens are scoped per family
   `recurrence_*` with a hint.
 - `process_start_time` and `tag.value` are 10-digit **Unix-seconds** epochs;
   small ints are rejected with a "did you pass day-of-month?" hint.
+- `recurrency_period_type` is one of `One Time | Week | Month | Quarter | Year`.
+  `process_start_time` is only allowed with `One Time`; leave it out for a
+  recurring workflow.
+- On `create`, `tags` dates the first process. `config.tags_config` needs
+  exactly one `type: "DATE"` entry, and `tags` needs a row with that entry's
+  `id` and a Unix-seconds `value`. Copy both from `workflow get <id> --json` of a
+  working template. The CLI rejects a payload that breaks this.
 
 ## Collection processes
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datarails-ai/dr-cli",
-  "version": "1.6.117",
+  "version": "1.6.119",
   "description": "Datarails CLI",
   "type": "module",
   "engines": {