@plurnk/plurnk-execs-common 2.0.0 → 2.0.2

package/docs/awk.md

@@ -4,7 +4,7 @@ The body is the AWK program, passed as the one positional argument with an
 empty stdin: with no input file it only runs `BEGIN` blocks. Input files are
 named in `[{"args": [...]}]`; a script target runs that file and receives the
 body as stdin. Working directory, environment, channels and exit status are
-every subprocess executor's (`sh.md`); `exit 1` in the program closes with status 500.
+every subprocess executor's (`sh.md`); `exit 1` in the program is a nonzero `exitCode`.
 
 ```awk [{"args": ["data.csv"]}] <!-- the body is the program -->
 BEGIN { FS = "," }

package/docs/bun.md

@@ -14,5 +14,5 @@ console.log((await file.json()).name);
 ```
 
 `console.log` streams to `#stdout`, `console.error` to `#stderr`; an uncaught
-error or `process.exit(1)` closes with status 500. Live input
+error or `process.exit(1)` is a nonzero `exitCode`. Live input
 (`[{"stdin": "open"}]`, SEND, `[{"eof": true}]`) is as `node.md` shows.

package/docs/deno.md

@@ -15,5 +15,5 @@ console.log(JSON.stringify(versions));
 ```
 
 `console.log` streams to `#stdout`, `console.error` to `#stderr`; an uncaught
-error or `Deno.exit(1)` closes with status 500. Live input
+error or `Deno.exit(1)` is a nonzero `exitCode`. Live input
 (`[{"stdin": "open"}]`, SEND, `[{"eof": true}]`) is as `node.md` shows.

package/docs/lua.md

@@ -14,7 +14,7 @@ print(table.concat(t, ","))
 ```
 
 `print` streams to `#stdout`, `io.stderr:write` to `#stderr`; `error(...)` or
-`os.exit(1)` closes with status 500. The standalone interpreter is the host's
+`os.exit(1)` is a nonzero `exitCode`. The standalone interpreter is the host's
 `lua` on PATH; project modules resolve through its ordinary `package.path` from
 the working directory. Live input (`[{"stdin": "open"}]`, SEND,
 `[{"eof": true}]`) is as `node.md` shows.

package/docs/node.md

@@ -15,7 +15,7 @@ ordinary relative filesystem paths resolve from the working directory.
 Environment, working directory, channels, output on completion, exit status and lifetime
 are every subprocess executor's, as `sh.md` states. Stdout is text, so structured
 output is serialized (`console.log(JSON.stringify(value))`); a thrown error
-exits nonzero (status 500) with its stack on stderr.
+exits nonzero with its stack on stderr.
 
 ## Live input
 

package/docs/perl.md

@@ -4,7 +4,7 @@ The body is Perl code, run with `perl -e`; `-n`/`-p` have no equivalent here,
 so a line loop is written in the body. A script target runs that file and
 receives the body as stdin; `[{"args": [...]}]` passes literal arguments.
 Environment, channels and exit status are every subprocess executor's (`sh.md`):
-`die` or a nonzero `exit` closes with status 500.
+`die` or a nonzero `exit` is a nonzero `exitCode`.
 
 ```perl <!-- the body is the program -->
 use strict; use warnings;

package/docs/ruby.md

@@ -13,7 +13,7 @@ puts JSON.generate(words.tally)
 ```
 
 `puts` and `print` stream to `#stdout`, `warn` to `#stderr`; an unrescued
-exception or `exit 1` closes with status 500 with the backtrace on stderr. Gems
+exception or `exit 1` is a nonzero `exitCode` with the backtrace on stderr. Gems
 resolve from the project's ordinary Ruby environment; `[{"cwd": "<directory>"}]`
 selects the working directory when the project's `Gemfile` lives elsewhere.
 Environment metadata is every subprocess executor's (`sh.md`). Live input

package/docs/sh.md

@@ -35,7 +35,7 @@ directory the command ran in.
 
 ## Channels
 
-An execution is a host effect, admitted under the loop's policy. Output streams
+An execution is a host effect, subject to approval. Output streams
 under the receipt's `stream` address, such as `sh:///ab3d5678`: `#stdout` is
 the default channel and `#stderr` the second; both are `text/stream`. While it
 runs, the packet's `## Delegation` streams list reports each channel's size and
@@ -47,7 +47,8 @@ terminal exit status. READ a range of the observation's `path` for any part:
 ```READ (sh:///ab3d5678#stdout) <17,40>
 ```
 
-A nonzero exit closes with status 500; stdout and stderr are separate channels,
+The observation carries the `exitCode`; a nonzero one is the command's answer,
+not a failure. Stdout and stderr are separate channels,
 and a diagnostic may be on either. The `log:///…/sh` receipt's own body is the
 program exactly as sent, never output. A receipt with a non-200 status and no
 `stream` address ran nothing; its body is still the program, and its Problem
@@ -62,7 +63,7 @@ time. This command is stopped after 30 seconds if it has not finished:
 npm test
 ```
 
-Expiry closes the stream with status 504. By contrast, `WAIT <30>` limits one
+Expiry closes the stream with status 504. By contrast, `WAIT [30]` limits one
 wait to 30 seconds without stopping the command. Without `lifetime`,
 the command is loop-bound; see `env.md` for other lifetime values.
 

package/docs/tcl.md

@@ -14,7 +14,7 @@ puts [dict get $count alpha]
 ```
 
 `puts` streams to `#stdout`, `puts stderr ...` to `#stderr`; an uncaught error
-or `exit 1` closes with status 500 with the Tcl error info on stderr. tclsh
+or `exit 1` is a nonzero `exitCode` with the Tcl error info on stderr. tclsh
 evaluates the script line by line, so an incomplete command at the end is an
 error, not a silent no-op. Live input (`[{"stdin": "open"}]`, SEND,
 `[{"eof": true}]`) is as `node.md` shows.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plurnk/plurnk-execs-common",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Universal subprocess executor for plurnk-service's exec scheme — one package exposing the shell, Node.js, Python 3, and supported host interpreters.",
   "keywords": [
     "plurnk",
@@ -270,7 +270,7 @@
     "prepublishOnly": "npm audit --audit-level=moderate && npm test"
   },
   "peerDependencies": {
-    "@plurnk/plurnk-execs": "^2.0.0"
+    "@plurnk/plurnk-execs": "^3.0.0"
   },
-  "gitHead": "3b2cae63115333d1b2e820abcf44b0fe4959d9ea"
+  "gitHead": "70dd06512f02f66f94a1dae7702085f4980f1686"
 }