@acsetra/runner 0.1.89 → 0.1.90

package/bin/runner.js

@@ -190,7 +190,7 @@ async function main() {
   const argv = process.argv.slice(2);
   if (!argv.length || ["-h", "--help"].includes(argv[0])) { console.log(renderTop()); return 0; }
   const [cmd, ...rest] = argv;
-  if (["version", "--version", "-V"].includes(cmd)) { console.log("runner (@acsetra/runner) 0.1.89"); return 0; }
+  if (["version", "--version", "-V"].includes(cmd)) { console.log("runner (@acsetra/runner) 0.1.90"); return 0; }
 
   // help — top-level, `help <topic>`, and per-verb `<cmd> … --help` (lexical, before toOp)
   if (cmd === "help") {

package/lib/grammar.json

@@ -25,6 +25,7 @@
   "int_args": [
     "at",
     "days",
+    "limit",
     "max_bytes",
     "ordinal",
     "rate",
@@ -36,10 +37,12 @@
     "backoff"
   ],
   "bool_args": [
+    "all_routes",
     "atomic",
     "auth_flow",
     "autoplay",
     "controls",
+    "disabled",
     "enabled",
     "force",
     "if_absent",
@@ -217,6 +220,29 @@
     "record.replay": [
       "operation_namespace",
       "operation_id"
+    ],
+    "schedule.set": [
+      "code",
+      "pipeline",
+      "cron"
+    ],
+    "schedule.show": [
+      "code"
+    ],
+    "schedule.occurrences": [
+      "code"
+    ],
+    "schedule.pause": [
+      "code"
+    ],
+    "schedule.resume": [
+      "code"
+    ],
+    "schedule.run_now": [
+      "code"
+    ],
+    "schedule.remove": [
+      "code"
     ]
   },
   "planes": [
@@ -226,6 +252,7 @@
     "css",
     "head",
     "record",
+    "schedule",
     "set"
   ],
   "short": {
@@ -529,6 +556,40 @@
         "replay",
         "record.replay"
       ]
+    ],
+    "schedule": [
+      [
+        "set",
+        "schedule.set"
+      ],
+      [
+        "list",
+        "schedule.list"
+      ],
+      [
+        "show",
+        "schedule.show"
+      ],
+      [
+        "occurrences",
+        "schedule.occurrences"
+      ],
+      [
+        "pause",
+        "schedule.pause"
+      ],
+      [
+        "resume",
+        "schedule.resume"
+      ],
+      [
+        "run_now",
+        "schedule.run_now"
+      ],
+      [
+        "remove",
+        "schedule.remove"
+      ]
     ]
   },
   "group_aliases": {
@@ -931,6 +992,59 @@
     "record.replay": {
       "desc": "the stored terminal result of an operation (namespace + id)",
       "kw": []
+    },
+    "schedule.set": {
+      "desc": "create/update an org-catalog five-field cron schedule for the explicit target scope",
+      "scope": "required",
+      "kw": [
+        "label",
+        "timezone",
+        "input",
+        "overlap",
+        "misfire",
+        "disabled"
+      ]
+    },
+    "schedule.list": {
+      "desc": "list schedules for this target; --all-routes lists the org catalog",
+      "scope": "required",
+      "kw": [
+        "all_routes"
+      ]
+    },
+    "schedule.show": {
+      "desc": "show one target-addressed schedule",
+      "scope": "required",
+      "kw": []
+    },
+    "schedule.occurrences": {
+      "desc": "list durable occurrence and launch receipts, newest first",
+      "scope": "required",
+      "kw": [
+        "limit"
+      ]
+    },
+    "schedule.pause": {
+      "desc": "pause one schedule and clear its next firing",
+      "scope": "required",
+      "kw": []
+    },
+    "schedule.resume": {
+      "desc": "revalidate and resume one schedule, rebinding its routed pipeline when detached",
+      "scope": "required",
+      "kw": []
+    },
+    "schedule.run_now": {
+      "desc": "enqueue once without moving the cron clock; --operation-id makes retries idempotent",
+      "scope": "required",
+      "kw": [
+        "operation_id"
+      ]
+    },
+    "schedule.remove": {
+      "desc": "delete one schedule and its occurrence history",
+      "scope": "required",
+      "kw": []
     }
   },
   "verbs_doc": {
@@ -1027,8 +1141,8 @@
       "desc": "reconstruct a pipeline from its rows"
     },
     "run": {
-      "usage": "run <pipeline> -i '{json}'",
-      "desc": "test-run a pipeline with input"
+      "usage": "run <pipeline> [-i '{json}'] [--at scope | -S scope]",
+      "desc": "test-run a pipeline; --at/-S deterministically selects the deepest ancestor route, while an unscoped run selects the globally deepest route and errors on a deepest tie"
     },
     "runs": {
       "usage": "runs <launch_id>",
@@ -1108,7 +1222,8 @@
     "backend": {
       "groups": [
         "set",
-        "record"
+        "record",
+        "schedule"
       ],
       "verbs": [
         "signin",

package/lib/grammar_info.js

@@ -2,7 +2,7 @@
 // Node mirror of acsetra_cli/grammar_info.py: reads the INSTALLED manifest
 // (lib/grammar.json), renders one JSON payload with every operation's positional
 // order, the named argument a bare `--json` fills, `-b` bodies, flag coercion
-// types, and short aliases. grammar_version is the sha256 of the manifest bytes
+// types, scope requirement, and short aliases. grammar_version is the sha256 of the manifest bytes
 // — the same hash the server's context pack reports.
 import crypto from "node:crypto";
 import fs from "node:fs";
@@ -33,6 +33,7 @@ function opEntry(op) {
     pos: [...(GRAMMAR.pos[op] || [])],
     json: op in GRAMMAR.primary_json ? GRAMMAR.primary_json[op] : null,
     body: Boolean(doc.body),
+    scope: doc.scope || "optional",
     flags: Object.fromEntries(kw.map(k => [k, vtype(k)])),
     short: Object.fromEntries(kw.filter(k => k in rev)
       .map(k => ["-" + rev[k], "--" + k.replace(/_/g, "-")])),

package/lib/help.js

@@ -54,7 +54,7 @@ export function renderOp(op) {
   if (prim) parts.push(`--json '{${prim}}'`);
   if (body) parts.push("-b <code|->");
   for (const k of kw) parts.push(usageFlag(k));
-  parts.push("[-S scope]");
+  parts.push(doc.scope === "required" ? "-S <scope>" : "[-S scope]");
 
   const out = ["Usage:", "  " + parts.join(" "), ""];
   if (doc.desc) out.push(doc.desc, "");
@@ -115,7 +115,7 @@ export function renderTop() {
   out.push("Authoring (planes — run `r <group> --help` for subcommands)",
            "  r app create <name> ; r apps",
            "  r auth <app>           require home.acsetra.com sign-in to use an app",
-           "  r set | css | asset | behavior | component | head  <subverb> …",
+           "  r set | css | asset | behavior | component | head | schedule  <subverb> …",
            "  r pipe <code> -S <scope> -w c:l ; r w <code> <tier> …",
            "  r ls | inspect <set> | read <code> | show <pipe>",
            "  r run <pipe> -i '{…}' ; r runs <id> ; r doctor <app> ; r compile <app>",

package/lib/verbs.js

@@ -126,6 +126,12 @@ export function toOp(verb, rest) {
     const { positionals, flags } = walk(rest);
     const args = { pipeline: positionals[0] || flags.pipeline };
     if ("input" in flags) args.input = coerce("input", flags.input);
+    if (flags.scope !== undefined && flags.at !== undefined && flags.scope !== flags.at) {
+      throw new VerbError("run received different --at and -S/--scope values");
+    }
+    if (flags.scope !== undefined || flags.at !== undefined) {
+      args.scope = flags.scope !== undefined ? flags.scope : flags.at;
+    }
     return ["run", args];
   }
   if (verb === "runs") { const { positionals } = walk(rest); return ["runs", { launch: positionals[0] }]; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acsetra/runner",
-  "version": "0.1.89",
+  "version": "0.1.90",
   "description": "Runner CLI — author and run hosted Runner apps from your terminal (the `runner` command).",
   "keywords": ["runner", "acsetra", "cli", "agent", "low-code"],
   "license": "MIT",