@acsetra/runner 0.1.87 → 0.1.89

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.87"); return 0; }
+  if (["version", "--version", "-V"].includes(cmd)) { console.log("runner (@acsetra/runner) 0.1.89"); return 0; }
 
   // help — top-level, `help <topic>`, and per-verb `<cmd> … --help` (lexical, before toOp)
   if (cmd === "help") {

package/lib/grammar.json

@@ -7,13 +7,19 @@
     "config_schema",
     "decls",
     "input",
+    "items",
     "meta",
     "overrides",
     "parts",
+    "patches",
     "props",
+    "replace_meta",
+    "requires",
     "schema",
     "spec",
     "storage",
+    "targets",
+    "tests",
     "tree"
   ],
   "int_args": [
@@ -30,11 +36,14 @@
     "backoff"
   ],
   "bool_args": [
+    "atomic",
     "auth_flow",
     "autoplay",
     "controls",
     "enabled",
     "force",
+    "if_absent",
+    "include_deleted",
     "keep",
     "map",
     "muted",
@@ -53,7 +62,9 @@
     "component.set": "tree",
     "component.set_route": "props",
     "behavior.attach": "config",
-    "head.set": "attrs"
+    "head.set": "attrs",
+    "record.transact": "targets",
+    "record.commit": "patches"
   },
   "pos": {
     "set.create": [
@@ -191,6 +202,21 @@
     ],
     "head.remove": [
       "code"
+    ],
+    "record.get": [
+      "set_code",
+      "code"
+    ],
+    "record.commit": [
+      "set_code",
+      "code"
+    ],
+    "record.transact": [
+      "operation_id"
+    ],
+    "record.replay": [
+      "operation_namespace",
+      "operation_id"
     ]
   },
   "planes": [
@@ -199,6 +225,7 @@
     "component",
     "css",
     "head",
+    "record",
     "set"
   ],
   "short": {
@@ -484,6 +511,24 @@
         "validate",
         "head.validate"
       ]
+    ],
+    "record": [
+      [
+        "get",
+        "record.get"
+      ],
+      [
+        "commit",
+        "record.commit"
+      ],
+      [
+        "transact",
+        "record.transact"
+      ],
+      [
+        "replay",
+        "record.replay"
+      ]
     ]
   },
   "group_aliases": {
@@ -494,7 +539,7 @@
   },
   "ops_doc": {
     "set.create": {
-      "desc": "create a value set (mint your own plane/registry)",
+      "desc": "create a value set (mint your own plane/registry) — born a keyed record set: point reads, field patches, revisions/etags, durable receipts; never the legacy whole-collection path",
       "kw": [
         "label",
         "kind",
@@ -502,12 +547,13 @@
       ]
     },
     "set.put": {
-      "desc": "write/merge a row (--json is the row meta; MERGES unless --replace)",
+      "desc": "write/merge a row (--json is the row meta). Every set you mint is a keyed record set: each sent key lands as ONE atomic field patch (disjoint edits compose, a stale edit of a changed field conflicts); MERGES unless --replace; --etag makes the write conditional",
       "kw": [
         "label",
         "ordinal",
         "enabled",
-        "replace"
+        "replace",
+        "etag"
       ]
     },
     "set.declare_schema": {
@@ -853,6 +899,38 @@
     "head.validate": {
       "desc": "re-check every head entry",
       "kw": []
+    },
+    "record.get": {
+      "desc": "ONE row by code with its record_id / revision / etag (the keyed point read)",
+      "kw": [
+        "include_deleted"
+      ]
+    },
+    "record.commit": {
+      "desc": "atomic commit on one record (--json is the patches list: [{op:set|unset|increment|add_unique|remove_value|test, path:'/field', value}]); action create|patch|replace|delete|restore; expected_etag makes it conditional; items=[…] is a one-row batch with per-item outcomes",
+      "kw": [
+        "action",
+        "tests",
+        "items",
+        "batch_policy",
+        "expected_etag",
+        "expected_revision",
+        "operation_id",
+        "label",
+        "ordinal",
+        "replace_meta",
+        "if_absent"
+      ]
+    },
+    "record.transact": {
+      "desc": "several records, ONE operation: <operation_id> names it (a uuid you mint; retry = replay), --json is the targets list [{set_code, code, action?, patches?|items?, expected_etag?, requires?:[{target, item_id?}]}]; --atomic is all-or-none, else one outcome per target",
+      "kw": [
+        "atomic"
+      ]
+    },
+    "record.replay": {
+      "desc": "the stored terminal result of an operation (namespace + id)",
+      "kw": []
     }
   },
   "verbs_doc": {
@@ -990,7 +1068,10 @@
         "  llm       [--provider openai] [--model M]   one model call (keys injected server-side)",
         "            [--system-from K] [--user-from ask] [-k/--keys a,b]",
         "  pipeline  -P/--calls CODE|SCOPE/CODE        run an EXISTING pipeline of this org as this step",
-        "            (a real child launch; -s '{\"pick\":[\u2026],\"input\":{\u2026}}' shapes its input)"
+        "            (a real child launch; -s '{\"pick\":[…],\"input\":{…}}' shapes its input)",
+        "  batch     -s '{\"over\":\"items\",\"each\":{\"tier\":…,\"spec\":{…}},\"concurrency\":8}'",
+        "            ONE run fans a sub-worker over a list: bounded (default 8, max 32), one item's",
+        "            failure is its own {error,index}, the answer counts ok/failed — never loop ctx.run"
       ]
     },
     "op": {
@@ -1026,7 +1107,8 @@
     },
     "backend": {
       "groups": [
-        "set"
+        "set",
+        "record"
       ],
       "verbs": [
         "signin",

package/lib/verbs.js

@@ -45,7 +45,9 @@ function walk(rest) {
     if (tok === "--json") {
       const blob = rest[++i]; i++;
       const obj = blob.startsWith("@") ? JSON.parse(fs.readFileSync(blob.slice(1), "utf8")) : JSON.parse(blob);
-      flags.__json = Object.assign(flags.__json || {}, obj); continue;
+      if (!Array.isArray(obj) && flags.__json && !Array.isArray(flags.__json)) Object.assign(flags.__json, obj);
+      else flags.__json = obj;   // an object, or a LIST primary (patches / targets)
+      continue;
     }
     if (tok.startsWith("--") || (tok.startsWith("-") && tok.length === 2 && !/\d/.test(tok[1]))) {
       let name = tok.replace(/^-+/, "").replace(/-/g, "_");
@@ -75,7 +77,8 @@ function assemble(op, positionals, flags) {
     const blob = flags.__json; delete flags.__json;
     const prim = PRIMARY_JSON[op];
     if (prim && !(prim in args)) args[prim] = blob;
-    else Object.assign(args, blob);
+    else if (!Array.isArray(blob)) Object.assign(args, blob);
+    else throw new VerbError(`\`${op}\` takes --json as an object of named args (a list is only the primary payload of ops like record.commit / record.transact)`);
   }
   delete flags.__body;
   for (const [k, v] of Object.entries(flags)) args[k] = coerce(k, v);

package/package.json

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